Skip to content

armgit / Ix

Public Imported from GitHub
0

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

feat: add kind-aware entity resolver with ambiguity handling

riley0227f39579e173fe
diff --git a/ix-cli/src/cli/resolve.ts b/ix-cli/src/cli/resolve.ts
new file mode 100644
index 00000000..bc0c5ad5
--- /dev/null
+++ b/ix-cli/src/cli/resolve.ts
@@ -0,0 +1,78 @@
+import chalk from "chalk";
+import type { IxClient } from "../client/api.js";
+
+export interface ResolvedEntity {
+ id: string;
+ kind: string;
+ name: string;
+}
+
+/**
+ * Resolve a symbol to a single entity, preferring specific kinds.
+ * Returns null and prints guidance if no match or ambiguous.
+ */
+export async function resolveEntity(
+ client: IxClient,
+ symbol: string,
+ preferredKinds: string[],
+ opts?: { kind?: string }
+): Promise<ResolvedEntity | null> {
+ const kindFilter = opts?.kind;
+ const nodes = await client.search(symbol, { limit: 20, kind: kindFilter });
+
+ if (nodes.length === 0) {
+ console.log(`No entity found matching "${symbol}".`);
+ return null;
+ }
+
+ // Exact name matches only
+ const exact = nodes.filter((n: any) => {
+ const name = n.name || n.attrs?.name || "";
+ return name.toLowerCase() === symbol.toLowerCase();
+ });
+
+ const candidates = exact.length > 0 ? exact : nodes;
+
+ // If user specified --kind, take the first match
+ if (kindFilter) {
+ const node = candidates[0] as any;
+ return { id: node.id, kind: node.kind, name: node.name || node.attrs?.name || symbol };
+ }
+
+ // Try preferred kinds in order
+ for (const pk of preferredKinds) {
+ const match = candidates.find((n: any) => n.kind === pk);
+ if (match) {
+ return { id: (match as any).id, kind: (match as any).kind, name: (match as any).name || (match as any).attrs?.name || symbol };
+ }
+ }
+
+ // If only one candidate, use it
+ if (candidates.length === 1) {
+ const node = candidates[0] as any;
+ return { id: node.id, kind: node.kind, name: node.name || node.attrs?.name || symbol };
+ }
+
+ // Multiple candidates, no preferred kind match — show ambiguity
+ console.log(`Multiple matches for "${symbol}":`);
+ const seen = new Set<string>();
+ for (const n of candidates.slice(0, 5)) {
+ const node = n as any;
+ const key = `${node.kind}:${node.id}`;
+ if (seen.has(key)) continue;
+ seen.add(key);
+ const shortId = node.id.slice(0, 8);
+ const name = node.name || node.attrs?.name || "(unnamed)";
+ console.log(` ${chalk.cyan((node.kind ?? "").padEnd(10))} ${chalk.dim(shortId)} ${name}`);
+ }
+ console.log(chalk.dim(`\nUse --kind <kind> to disambiguate.`));
+ return null;
+}
+
+/**
+ * Print the resolved target before showing results.
+ */
+export function printResolved(target: ResolvedEntity): void {
+ const shortId = target.id.slice(0, 8);
+ console.log(`${chalk.dim("Resolved:")} ${chalk.cyan(target.kind)} ${chalk.dim(shortId)} ${chalk.bold(target.name)}\n`);
+}