Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
fix(cli): --path is a hard filter, so stop calling it a preference (#635)
KageBinary37f98b165c54
diff --git a/ix-cli/src/cli/commands/context.ts b/ix-cli/src/cli/commands/context.tsindex 0677de2a..0a08eff3 100644--- a/ix-cli/src/cli/commands/context.ts+++ b/ix-cli/src/cli/commands/context.ts@@ -225,7 +225,7 @@ export function registerContextCommand(program: Command): void {"Build a bounded, deterministic context bundle for a symbol, file, or entity (or resume/diff a saved investigation without a target)",).option("--kind <kind>", "Filter target entity by kind")- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).option("--depth <depth>",diff --git a/ix-cli/src/cli/commands/depends.ts b/ix-cli/src/cli/commands/depends.tsindex 5721438e..6e1901a0 100644--- a/ix-cli/src/cli/commands/depends.ts+++ b/ix-cli/src/cli/commands/depends.ts@@ -191,7 +191,7 @@ export function registerDependsCommand(program: Command): void {.command("depends <symbol>").description("Show upstream dependents of the given entity (full tree by default)").option("--kind <kind>", "Filter target entity by kind")- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).option("--depth <n>", "Cap traversal depth").option("--cap <n>", "Cap number of nodes visited")diff --git a/ix-cli/src/cli/commands/diff.ts b/ix-cli/src/cli/commands/diff.tsindex 571a688c..a6ffa163 100644--- a/ix-cli/src/cli/commands/diff.ts+++ b/ix-cli/src/cli/commands/diff.ts@@ -469,7 +469,7 @@ export function registerDiffCommand(program: Command): void {.option("--full", "Return all changes (no limit)").option("--format <fmt>", "Output format (text|json|llm)", "text").option("--kind <kind>", "Filter target entity by kind")- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).addHelpText("after", `\nExamples:ix diff 3 5diff --git a/ix-cli/src/cli/commands/explain.ts b/ix-cli/src/cli/commands/explain.tsindex c84b83c1..125e177f 100644--- a/ix-cli/src/cli/commands/explain.ts+++ b/ix-cli/src/cli/commands/explain.ts@@ -18,7 +18,7 @@ export function registerExplainCommand(program: Command): void {.command("explain <symbol>").description("Explain an entity — infers role, importance, and structural context").option("--kind <kind>", "Filter target entity by kind")- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).option("--format <fmt>", "Output format (text|json|llm)", "text").option("--raw", "Show raw metadata dump (legacy format)")diff --git a/ix-cli/src/cli/commands/history.ts b/ix-cli/src/cli/commands/history.tsindex 3e78c638..1f80eba6 100644--- a/ix-cli/src/cli/commands/history.ts+++ b/ix-cli/src/cli/commands/history.ts@@ -28,7 +28,7 @@ export function registerHistoryCommand(program: Command): void {.command("history <target>").description("Show provenance chain for a file or entity").option("--kind <kind>", "Filter target entity by kind")- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).option("--format <fmt>", "Output format (text|json|llm)", "text").addHelpText("after", `\nExamples:diff --git a/ix-cli/src/cli/commands/locate.ts b/ix-cli/src/cli/commands/locate.tsindex e4f9289a..9d7dfb62 100644--- a/ix-cli/src/cli/commands/locate.ts+++ b/ix-cli/src/cli/commands/locate.ts@@ -36,7 +36,7 @@ export function registerLocateCommand(program: Command): void {.command("locate <symbol>").description("Resolve a symbol to its position in the codebase and system hierarchy").option("--kind <kind>", "Filter target entity by kind")- .option("--path <path>", "Prefer results from files matching this path substring")+ .option("--path <path>", "Restrict to results from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).option("--format <fmt>", "Output format (text|json|llm)", "text").addHelpText("after", `\nExamples:diff --git a/ix-cli/src/cli/commands/overview.ts b/ix-cli/src/cli/commands/overview.tsindex 468591d6..c832eba4 100644--- a/ix-cli/src/cli/commands/overview.ts+++ b/ix-cli/src/cli/commands/overview.ts@@ -37,7 +37,7 @@ export function registerOverviewCommand(program: Command): void {.command("overview <target>").description("Structural summary — what a target contains or what surrounds it").option("--kind <kind>", "Filter target entity by kind")- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).option("--format <fmt>", "Output format (text|json|llm)", "text").addHelpText(diff --git a/ix-cli/src/cli/commands/read.ts b/ix-cli/src/cli/commands/read.tsindex 527d9e9e..a0f36c04 100644--- a/ix-cli/src/cli/commands/read.ts+++ b/ix-cli/src/cli/commands/read.ts@@ -196,7 +196,7 @@ export function registerReadCommand(program: Command): void {.description("Read raw file content, line ranges, or symbol source code").option("--format <fmt>", "Output format (text|json|llm)", "text").option("--kind <kind>", "Filter symbol by kind")- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption).option("--root <dir>", "Workspace root directory").addHelpText("after", `\nResolution order:diff --git a/ix-cli/src/cli/commands/trace.ts b/ix-cli/src/cli/commands/trace.tsindex 69c75309..1ea18bb0 100644--- a/ix-cli/src/cli/commands/trace.ts+++ b/ix-cli/src/cli/commands/trace.ts@@ -416,7 +416,7 @@ export function registerTraceCommand(program: Command): void {.option("--depth <n>", "Cap traversal depth").option("--cap <n>", "Cap number of nodes visited, per direction").option("--pick <n>", "Pick Nth candidate from ambiguous results (1-based)", parsePickOption)- .option("--path <path>", "Prefer symbols from files matching this path substring")+ .option("--path <path>", "Restrict to symbols from files matching this path substring").option("--format <fmt>", "Output format (text|json|llm)", "text").option("--include-tests", "Include test and fixture entities").option("--tests-only", "Show only test and fixture entities")diff --git a/skills/ix/references/flags.md b/skills/ix/references/flags.mdindex 147e0416..82abda15 100644--- a/skills/ix/references/flags.md+++ b/skills/ix/references/flags.md@@ -138,7 +138,7 @@ Build a bounded, deterministic context bundle for a symbol, file, or entity (or| Flag | Value | Default | Effect ||---|---|---|---|| `--kind` | `<kind>` | — | Filter target entity by kind |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) || `--depth` | `compact\|standard\|full\|shallow\|deep` | — | Context-graph expansion depth (compact\|standard\|full\|shallow\|deep) || `--as-of-rev` | `<n>` | — | Historical context as of a graph revision |@@ -160,7 +160,7 @@ Show upstream dependents of the given entity (full tree by default).| Flag | Value | Default | Effect ||---|---|---|---|| `--kind` | `<kind>` | — | Filter target entity by kind |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) || `--depth` | `<n>` | — | Cap traversal depth || `--cap` | `<n>` | — | Cap number of nodes visited |@@ -181,7 +181,7 @@ Show diff between two revisions, optionally scoped to a file or entity.| `--full` | — | off | Return all changes (no limit) || `--format` | `text\|json\|llm` | `text` | Output format — see [output-formats.md](output-formats.md) || `--kind` | `<kind>` | — | Filter target entity by kind |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) |### `ix docker`@@ -251,7 +251,7 @@ Explain an entity — infers role, importance, and structural context.| Flag | Value | Default | Effect ||---|---|---|---|| `--kind` | `<kind>` | — | Filter target entity by kind |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) || `--format` | `text\|json\|llm` | `text` | Output format — see [output-formats.md](output-formats.md) || `--raw` | — | off | Show raw metadata dump (legacy format) |@@ -276,7 +276,7 @@ Show provenance chain for a file or entity.| Flag | Value | Default | Effect ||---|---|---|---|| `--kind` | `<kind>` | — | Filter target entity by kind |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) || `--format` | `text\|json\|llm` | `text` | Output format — see [output-formats.md](output-formats.md) |@@ -356,7 +356,7 @@ Resolve a symbol to its position in the codebase and system hierarchy.| Flag | Value | Default | Effect ||---|---|---|---|| `--kind` | `<kind>` | — | Filter target entity by kind |-| `--path` | `<path>` | — | Prefer results from files matching this path substring |+| `--path` | `<path>` | — | Restrict to results from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) || `--format` | `text\|json\|llm` | `text` | Output format — see [output-formats.md](output-formats.md) |@@ -413,7 +413,7 @@ Structural summary — what a target contains or what surrounds it.| Flag | Value | Default | Effect ||---|---|---|---|| `--kind` | `<kind>` | — | Filter target entity by kind |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) || `--format` | `text\|json\|llm` | `text` | Output format — see [output-formats.md](output-formats.md) |@@ -459,7 +459,7 @@ Read raw file content, line ranges, or symbol source code.|---|---|---|---|| `--format` | `text\|json\|llm` | `text` | Output format — see [output-formats.md](output-formats.md) || `--kind` | `<kind>` | — | Filter symbol by kind |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) || `--root` | `<dir>` | — | Workspace root directory |@@ -587,7 +587,7 @@ Follow how it connects.| `--depth` | `<n>` | — | Cap traversal depth || `--cap` | `<n>` | — | Cap number of nodes visited, per direction || `--pick` | `<n>` | — | Pick Nth candidate from ambiguous results (1-based) |-| `--path` | `<path>` | — | Prefer symbols from files matching this path substring |+| `--path` | `<path>` | — | Restrict to symbols from files matching this path substring || `--format` | `text\|json\|llm` | `text` | Output format — see [output-formats.md](output-formats.md) || `--include-tests` | — | off | Include test and fixture entities || `--tests-only` | — | off | Show only test and fixture entities |