feat: rebrand Oracul to VectorCourt

Rename internal/oracul/ package to internal/vectorcourt/,
update auth header to X-VC-Key, default endpoint to
vectorcourt.com, config keys to vectorcourt.*, CLI flags
to --to vectorcourt / --format vectorcourt, TUI target to
VectorCourt. Backward-compat migration reads legacy oracul
config keys on load.

Author: ppiankov

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.21.0] - 2026-03-19
+
+### Changed
+- Rebrand Oracul to VectorCourt: package `internal/oracul` renamed to `internal/vectorcourt`
+- Auth header: `X-Oracul-Key` replaced by `X-VC-Key`
+- Default endpoint: `https://oracul.app` replaced by `https://vectorcourt.com`
+- Config keys: `oracul.api_key` / `oracul.endpoint` replaced by `vectorcourt.api_key` / `vectorcourt.endpoint`
+- CLI flags: `--to oracul` / `--format oracul` replaced by `--to vectorcourt` / `--format vectorcourt`
+- TUI: launch target "Oracul Council" renamed to "VectorCourt"
+- Backward-compatible config migration: existing `oracul` config keys auto-migrate on load
+
 ## [0.20.0] - 2026-03-10
 
 ### Added

README.md

@@ -140,7 +140,7 @@ Drag a file into the terminal - VectorPad intercepts the path, classifies the fi
 | `stash` | Idea persistence with Jaccard similarity clustering and uniqueness scoring |
 | `negativespace` | Negative space detection: flag missing constraint classes in directives |
 | `flight` | Flight recorder: append-only launch log with metrics and outcome annotation |
-| `oracul` | Oracul API client, sentence-to-CaseFiling mapper, preflight gate |
+| `vectorcourt` | VectorCourt API client, sentence-to-CaseFiling mapper, preflight gate |
 | `config` | Persistent settings (API keys, endpoints) at `~/.vectorpad/config.json` |
 | `detect` | Capability detection for pastewatch and contextspectre binaries |
 | `attach` | File attachment pipeline: detect path, classify, preview, serialize |
@@ -169,39 +169,39 @@ See the full [glossary](https://github.com/ppiankov/contextspectre/blob/main/doc
 
 Optional integration with [Pastewatch](https://github.com/ppiankov/pastewatch) scans outbound payloads for secrets before they enter a context window.
 
-## Decision ops: VectorPad + Oracul
+## Decision ops: VectorPad + VectorCourt
 
-VectorPad can submit classified cases to [Oracul](https://oracul.app) for multi-model deliberation. Oracul runs a council of models that challenge, strengthen, and split reasoning branches before issuing a verdict artifact.
+VectorPad can submit classified cases to [VectorCourt](https://vectorcourt.com) for multi-model deliberation. VectorCourt runs a council of models that challenge, strengthen, and split reasoning branches before issuing a verdict artifact.
 
-**Requires an Oracul API key.** Oracul is a paid service. Get a key at [oracul.app](https://oracul.app).
+**Requires a VectorCourt API key.** VectorCourt is a paid service. Get a key at [vectorcourt.com](https://vectorcourt.com).
 
 ```bash
 # Configure
-vectorpad config set oracul.api_key <your-key>
+vectorpad config set vectorcourt.api_key <your-key>
 
 # Classify and submit
-echo "Should we use Kafka or RabbitMQ?" | vectorpad submit --to oracul
+echo "Should we use Kafka or RabbitMQ?" | vectorpad submit --to vectorcourt
 
 # Save verdict as a git-trackable artifact
 echo "Should we use Kafka or RabbitMQ? Must handle 10k msgs/sec." \
-  | vectorpad submit --to oracul --output decisions/message-broker.oracul.json
+  | vectorpad submit --to vectorcourt --output decisions/message-broker.vectorcourt.json
 
 # Export CaseFiling JSON without submitting (offline, no API key needed)
-echo "Should we use Kafka?" | vectorpad export --format oracul
+echo "Should we use Kafka?" | vectorpad export --format vectorcourt
 ```
 
-The submit command classifies your text, maps sentence tags to a structured case filing (CONSTRAINT becomes constraints, DECISION becomes the decision, SPECULATION becomes known risks), runs a preflight check, then sends it to Oracul's `/v1/consult` endpoint.
+The submit command classifies your text, maps sentence tags to a structured case filing (CONSTRAINT becomes constraints, DECISION becomes the decision, SPECULATION becomes known risks), runs a preflight check, then sends it to VectorCourt's `/v1/consult` endpoint.
 
 Verdict artifacts are plain JSON. Put them in a `decisions/` directory and commit them alongside the code they affect:
 
 ```bash
-git add decisions/message-broker.oracul.json
+git add decisions/message-broker.vectorcourt.json
 git commit -m "decision: message broker selection"
 ```
 
 `git log decisions/` is your decision history. `git blame` tells you when and why. PRs can include a decision artifact alongside the implementation.
 
-VectorPad is the authoring tool. Oracul is the deliberation engine. Git is the ledger.
+VectorPad is the authoring tool. VectorCourt is the deliberation engine. Git is the ledger.
 
 ## Known limitations
 
@@ -219,8 +219,8 @@ VectorPad is the authoring tool. Oracul is the deliberation engine. Git is the l
 - [x] Phase 5 - negative space detection, drift timeline in TUI, flight recorder, constraint pinning
 - [x] Phase 6 - scope declaration, pressure heat map, vector decomposition, contextspectre feedback loop
 - [x] Phase 7 - claim registry (SQLite stash, Ollama embeddings, cosine similarity)
-- [x] Phase 8 - Oracul integration (submit, export, config, preflight gate)
-- [x] Phase 9 - Oracul TUI experience (account status, launch target, live preflight, verdict stash)
+- [x] Phase 8 - VectorCourt integration (submit, export, config, preflight gate)
+- [x] Phase 9 - VectorCourt TUI experience (account status, launch target, live preflight, verdict stash)
 - [ ] Phase 10 - decision memory (precedent search, async submit, outcome tracking, verdict diff)
 
 ## License

cmd/vectorpad/main.go

@@ -18,7 +18,7 @@ import (
 	"github.com/ppiankov/vectorpad/internal/detect"
 	"github.com/ppiankov/vectorpad/internal/flight"
 	"github.com/ppiankov/vectorpad/internal/negativespace"
-	"github.com/ppiankov/vectorpad/internal/oracul"
+	"github.com/ppiankov/vectorpad/internal/vectorcourt"
 	"github.com/ppiankov/vectorpad/internal/preflight"
 	"github.com/ppiankov/vectorpad/internal/pressure"
 	"github.com/ppiankov/vectorpad/internal/stash"
@@ -216,14 +216,14 @@ func runLog(args []string, stdout io.Writer, stderr io.Writer) int {
 				_, _ = fmt.Fprintf(stdout, "  %s: %d\n", g.Class, g.Count)
 			}
 		}
-		if stats.Oracul != nil {
+		if stats.VectorCourt != nil {
 			_, _ = fmt.Fprintln(stdout, "Oracul:")
-			_, _ = fmt.Fprintf(stdout, "  submits: %d\n", stats.Oracul.TotalSubmits)
-			_, _ = fmt.Fprintf(stdout, "  avg filing quality: %.0f%%\n", stats.Oracul.AvgFilingQuality*100)
-			_, _ = fmt.Fprintf(stdout, "  rejection rate: %.0f%%\n", stats.Oracul.RejectionRate*100)
-			if len(stats.Oracul.TopWarnings) > 0 {
+			_, _ = fmt.Fprintf(stdout, "  submits: %d\n", stats.VectorCourt.TotalSubmits)
+			_, _ = fmt.Fprintf(stdout, "  avg filing quality: %.0f%%\n", stats.VectorCourt.AvgFilingQuality*100)
+			_, _ = fmt.Fprintf(stdout, "  rejection rate: %.0f%%\n", stats.VectorCourt.RejectionRate*100)
+			if len(stats.VectorCourt.TopWarnings) > 0 {
 				_, _ = fmt.Fprintln(stdout, "  top warnings:")
-				for _, w := range stats.Oracul.TopWarnings {
+				for _, w := range stats.VectorCourt.TopWarnings {
 					_, _ = fmt.Fprintf(stdout, "    %s: %d\n", w.Class, w.Count)
 				}
 			}
@@ -743,8 +743,8 @@ func runSubmit(args []string, stdin io.Reader, stdout io.Writer, stderr io.Write
 		}
 	}
 
-	if target != "oracul" {
-		_, _ = fmt.Fprintln(stderr, "usage: vectorpad submit --to oracul [--output file.json] [--dry-run] [--no-preflight]")
+	if target != "vectorcourt" {
+		_, _ = fmt.Fprintln(stderr, "usage: vectorpad submit --to vectorcourt [--output file.json] [--dry-run] [--no-preflight]")
 		return 1
 	}
 
@@ -754,8 +754,8 @@ func runSubmit(args []string, stdin io.Reader, stdout io.Writer, stderr io.Write
 		_, _ = fmt.Fprintf(stderr, "error: %v\n", err)
 		return 1
 	}
-	if cfg.Oracul.APIKey == "" {
-		_, _ = fmt.Fprintln(stderr, "error: no API key configured (run: vectorpad config set oracul.api_key <key>)")
+	if cfg.VectorCourt.APIKey == "" {
+		_, _ = fmt.Fprintln(stderr, "error: no API key configured (run: vectorpad config set vectorcourt.api_key <key>)")
 		return 1
 	}
 
@@ -773,10 +773,10 @@ func runSubmit(args []string, stdin io.Reader, stdout io.Writer, stderr io.Write
 
 	// Classify and map.
 	sentences := classifier.Classify(text)
-	filing := oracul.MapSentences(sentences)
-	question := oracul.ExtractQuestion(sentences, text)
+	filing := vectorcourt.MapSentences(sentences)
+	question := vectorcourt.ExtractQuestion(sentences, text)
 
-	req := &oracul.ConsultRequest{
+	req := &vectorcourt.ConsultRequest{
 		Question: question,
 		Filing:   filing,
 	}
@@ -792,7 +792,7 @@ func runSubmit(args []string, stdin io.Reader, stdout io.Writer, stderr io.Write
 		return 0
 	}
 
-	client := oracul.NewClient(cfg.Endpoint(), cfg.Oracul.APIKey)
+	client := vectorcourt.NewClient(cfg.Endpoint(), cfg.VectorCourt.APIKey)
 
 	// Preflight gate.
 	if !noPreflight {
@@ -861,8 +861,8 @@ func runExport(args []string, stdin io.Reader, stdout io.Writer, stderr io.Write
 		}
 	}
 
-	if format != "oracul" {
-		_, _ = fmt.Fprintln(stderr, "usage: vectorpad export --format oracul")
+	if format != "vectorcourt" {
+		_, _ = fmt.Fprintln(stderr, "usage: vectorpad export --format vectorcourt")
 		return 1
 	}
 
@@ -878,10 +878,10 @@ func runExport(args []string, stdin io.Reader, stdout io.Writer, stderr io.Write
 	}
 
 	sentences := classifier.Classify(text)
-	filing := oracul.MapSentences(sentences)
-	question := oracul.ExtractQuestion(sentences, text)
+	filing := vectorcourt.MapSentences(sentences)
+	question := vectorcourt.ExtractQuestion(sentences, text)
 
-	req := &oracul.ConsultRequest{
+	req := &vectorcourt.ConsultRequest{
 		Question: question,
 		Filing:   filing,
 	}
@@ -936,16 +936,16 @@ func runPrecedent(args []string, stdin io.Reader, stdout io.Writer, stderr io.Wr
 		_, _ = fmt.Fprintf(stderr, "error: %v\n", err)
 		return 1
 	}
-	if cfg.Oracul.APIKey == "" {
-		_, _ = fmt.Fprintln(stderr, "error: no API key configured (run: vectorpad config set oracul.api_key <key>)")
+	if cfg.VectorCourt.APIKey == "" {
+		_, _ = fmt.Fprintln(stderr, "error: no API key configured (run: vectorpad config set vectorcourt.api_key <key>)")
 		return 1
 	}
 
 	// Extract question from classified text.
 	sentences := classifier.Classify(query)
-	question := oracul.ExtractQuestion(sentences, query)
+	question := vectorcourt.ExtractQuestion(sentences, query)
 
-	client := oracul.NewClient(cfg.Endpoint(), cfg.Oracul.APIKey)
+	client := vectorcourt.NewClient(cfg.Endpoint(), cfg.VectorCourt.APIKey)
 	result, err := client.SearchPrecedents(context.Background(), question, limit)
 	if err != nil {
 		_, _ = fmt.Fprintf(stderr, "error: %v\n", err)
@@ -1062,13 +1062,13 @@ func runOutcome(args []string, stdout io.Writer, stderr io.Writer) int {
 		_, _ = fmt.Fprintf(stderr, "error: %v\n", err)
 		return 1
 	}
-	if cfg.Oracul.APIKey == "" {
-		_, _ = fmt.Fprintln(stderr, "error: no API key configured (run: vectorpad config set oracul.api_key <key>)")
+	if cfg.VectorCourt.APIKey == "" {
+		_, _ = fmt.Fprintln(stderr, "error: no API key configured (run: vectorpad config set vectorcourt.api_key <key>)")
 		return 1
 	}
 
-	client := oracul.NewClient(cfg.Endpoint(), cfg.Oracul.APIKey)
-	resp, err := client.ReportOutcome(context.Background(), envelope.CaseID, &oracul.OutcomeRequest{
+	client := vectorcourt.NewClient(cfg.Endpoint(), cfg.VectorCourt.APIKey)
+	resp, err := client.ReportOutcome(context.Background(), envelope.CaseID, &vectorcourt.OutcomeRequest{
 		Result: result,
 		Note:   note,
 	})

internal/config/config.go

@@ -16,22 +16,29 @@ const (
 
 // Config holds persistent VectorPad settings.
 type Config struct {
-	Oracul OraculConfig `json:"oracul"`
+	VectorCourt VectorCourtConfig `json:"vectorcourt"`
 }
 
-// OraculConfig holds Oracul API integration settings.
-type OraculConfig struct {
+// VectorCourtConfig holds VectorCourt API integration settings.
+type VectorCourtConfig struct {
 	APIKey   string `json:"api_key"`
 	Endpoint string `json:"endpoint"`
 }
 
-// DefaultEndpoint returns the default Oracul API endpoint.
+// legacyOraculConfig is used only for reading old config files.
+type legacyOraculConfig struct {
+	APIKey   string `json:"api_key"`
+	Endpoint string `json:"endpoint"`
+}
+
+// DefaultEndpoint returns the default VectorCourt API endpoint.
 func DefaultEndpoint() string {
-	return "https://oracul.app"
+	return "https://vectorcourt.com"
 }
 
 // Load reads config from ~/.vectorpad/config.json.
 // Returns a zero Config if the file does not exist.
+// Migrates legacy "oracul" config keys to "vectorcourt" on read.
 func Load() (*Config, error) {
 	path, err := configPath()
 	if err != nil {
@@ -50,6 +57,23 @@ func Load() (*Config, error) {
 	if err := json.Unmarshal(data, &cfg); err != nil {
 		return nil, fmt.Errorf("parse config: %w", err)
 	}
+
+	// Migrate legacy "oracul" key if "vectorcourt" is empty.
+	var raw map[string]json.RawMessage
+	if json.Unmarshal(data, &raw) == nil {
+		if oraculRaw, ok := raw["oracul"]; ok {
+			var legacy legacyOraculConfig
+			if json.Unmarshal(oraculRaw, &legacy) == nil {
+				if cfg.VectorCourt.APIKey == "" && legacy.APIKey != "" {
+					cfg.VectorCourt.APIKey = legacy.APIKey
+				}
+				if cfg.VectorCourt.Endpoint == "" && legacy.Endpoint != "" {
+					cfg.VectorCourt.Endpoint = legacy.Endpoint
+				}
+			}
+		}
+	}
+
 	return &cfg, nil
 }
 
@@ -72,18 +96,18 @@ func Save(cfg *Config) error {
 	return os.WriteFile(path, data, 0600)
 }
 
-// Set updates a config value by dot-path key (e.g., "oracul.api_key").
+// Set updates a config value by dot-path key (e.g., "vectorcourt.api_key").
 func Set(key, value string) error {
 	cfg, err := Load()
 	if err != nil {
 		return err
 	}
 
 	switch key {
-	case "oracul.api_key":
-		cfg.Oracul.APIKey = value
-	case "oracul.endpoint":
-		cfg.Oracul.Endpoint = value
+	case "vectorcourt.api_key":
+		cfg.VectorCourt.APIKey = value
+	case "vectorcourt.endpoint":
+		cfg.VectorCourt.Endpoint = value
 	default:
 		return fmt.Errorf("unknown config key: %s", key)
 	}
@@ -99,10 +123,10 @@ func Get(key string) (string, error) {
 	}
 
 	switch key {
-	case "oracul.api_key":
-		return cfg.Oracul.APIKey, nil
-	case "oracul.endpoint":
-		ep := cfg.Oracul.Endpoint
+	case "vectorcourt.api_key":
+		return cfg.VectorCourt.APIKey, nil
+	case "vectorcourt.endpoint":
+		ep := cfg.VectorCourt.Endpoint
 		if ep == "" {
 			ep = DefaultEndpoint()
 		}
@@ -112,10 +136,10 @@ func Get(key string) (string, error) {
 	}
 }
 
-// Endpoint returns the configured Oracul endpoint or the default.
+// Endpoint returns the configured VectorCourt endpoint or the default.
 func (c *Config) Endpoint() string {
-	if c.Oracul.Endpoint != "" {
-		return c.Oracul.Endpoint
+	if c.VectorCourt.Endpoint != "" {
+		return c.VectorCourt.Endpoint
 	}
 	return DefaultEndpoint()
 }