Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

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.ts
index 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.ts
index 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.ts
index 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 5
diff --git a/ix-cli/src/cli/commands/explain.ts b/ix-cli/src/cli/commands/explain.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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 |