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
feat: route diagnostic output to stderr — stdout reserved for data
riley022724610033ac85
diff --git a/ix-cli/src/cli/resolve.ts b/ix-cli/src/cli/resolve.tsindex 52e3157f..bae4e69d 100644--- a/ix-cli/src/cli/resolve.ts+++ b/ix-cli/src/cli/resolve.ts@@ -1,5 +1,6 @@import chalk from "chalk";import type { IxClient } from "../client/api.js";+import { stderr } from "./stderr.js";export type ResolutionMode = "exact" | "preferred-kind" | "ambiguous" | "heuristic";@@ -24,7 +25,7 @@ export async function resolveEntity(const nodes = await client.search(symbol, { limit: 20, kind: kindFilter });if (nodes.length === 0) {- console.log(`No entity found matching "${symbol}".`);+ stderr(`No entity found matching "${symbol}".`);return null;}@@ -57,7 +58,7 @@ export async function resolveEntity(}// Multiple candidates, no preferred kind match — show ambiguity- console.log(`Multiple matches for "${symbol}":`);+ stderr(`Multiple matches for "${symbol}":`);const seen = new Set<string>();for (const n of candidates.slice(0, 5)) {const node = n as any;@@ -66,9 +67,9 @@ export async function resolveEntity(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}`);+ stderr(` ${chalk.cyan((node.kind ?? "").padEnd(10))} ${chalk.dim(shortId)} ${name}`);}- console.log(chalk.dim(`\nUse --kind <kind> to disambiguate.`));+ stderr(chalk.dim(`\nUse --kind <kind> to disambiguate.`));return null;}@@ -81,7 +82,7 @@ export function printResolved(target: ResolvedEntity): void {const modeStr = target.resolutionMode !== "exact"? chalk.dim(` (${target.resolutionMode})`): "";- console.log(`${chalk.dim("Resolved:")} ${chalk.cyan(target.kind)} ${chalk.dim(shortId)} ${chalk.bold(target.name)}${modeStr}\n`);+ stderr(`${chalk.dim("Resolved:")} ${chalk.cyan(target.kind)} ${chalk.dim(shortId)} ${chalk.bold(target.name)}${modeStr}\n`);}/** Check if a string looks like a raw UUID (not a human-readable name). */diff --git a/ix-cli/src/cli/stderr.ts b/ix-cli/src/cli/stderr.tsnew file mode 100644index 00000000..41899b3b--- /dev/null+++ b/ix-cli/src/cli/stderr.ts@@ -0,0 +1,11 @@+import chalk from "chalk";++/** Write a diagnostic/status message to stderr (never pollutes stdout/JSON). */+export function stderr(message: string): void {+ process.stderr.write(message + "\n");+}++/** Write a styled diagnostic to stderr. */+export function stderrDim(message: string): void {+ process.stderr.write(chalk.dim(message) + "\n");+}