xray-code 0.1.5 → 0.2.0

package/dist/cli.js

@@ -312,4 +312,183 @@ queryOpts(program
         process.exit(1);
     }
 });
+// ─── Call graph commands ────────────────────────────────────────
+queryOpts(program
+    .command("callers <symbol>")
+    .description("Who calls this symbol?")
+    .option("-n, --limit <n>", "Max results", "20")
+    .option("--json", "Output as JSON"))
+    .action(async (symbol, opts) => {
+    try {
+        const client = getClient(opts);
+        const res = await client.callers(symbol, parseInt(opts.limit));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        if (res.length === 0) {
+            console.log(`No callers found for '${symbol}'`);
+            return;
+        }
+        console.log(`\n  ${res.length} callers of '${symbol}':\n`);
+        res.forEach((c) => {
+            console.log(`    ${c.caller_file}:${c.call_site_line}  ${c.caller_name} [${c.confidence}]`);
+        });
+        console.log("");
+    }
+    catch (e) {
+        console.error(`Query failed: ${e}`);
+        process.exit(1);
+    }
+});
+queryOpts(program
+    .command("callees <symbol>")
+    .description("What does this symbol call?")
+    .option("-n, --limit <n>", "Max results", "20")
+    .option("--json", "Output as JSON"))
+    .action(async (symbol, opts) => {
+    try {
+        const client = getClient(opts);
+        const res = await client.callees(symbol, parseInt(opts.limit));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        if (res.length === 0) {
+            console.log(`'${symbol}' doesn't call anything`);
+            return;
+        }
+        console.log(`\n  ${res.length} callees of '${symbol}':\n`);
+        res.forEach((c) => {
+            console.log(`    ${c.callee_file}  ${c.callee_name} (line ${c.call_site_line})`);
+        });
+        console.log("");
+    }
+    catch (e) {
+        console.error(`Query failed: ${e}`);
+        process.exit(1);
+    }
+});
+// ─── Analysis commands ─────────────────────────────────────────
+queryOpts(program
+    .command("blast-radius <symbol>")
+    .description("Transitive impact — what breaks if I change this?")
+    .option("-d, --depth <n>", "Traversal depth", "2")
+    .option("--json", "Output as JSON"))
+    .action(async (symbol, opts) => {
+    try {
+        const client = getClient(opts);
+        const res = await client.transitiveImpact(symbol, parseInt(opts.depth));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (e) {
+        console.error(`Blast radius failed: ${e}`);
+        process.exit(1);
+    }
+});
+queryOpts(program
+    .command("plan-change <symbol>")
+    .description("Safe phased refactoring plan with risk assessment")
+    .option("-d, --depth <n>", "Traversal depth", "2")
+    .option("--json", "Output as JSON"))
+    .action(async (symbol, opts) => {
+    try {
+        const client = getClient(opts);
+        const res = await client.planChange(symbol, parseInt(opts.depth));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        console.log(`\n  Change Plan for '${symbol}'`);
+        console.log(`  Risk: ${res.risk_level}\n`);
+        res.phases.forEach((p) => {
+            console.log(`  Phase ${p.phase}: ${p.description}`);
+            p.files.forEach((f) => console.log(`    - ${f}`));
+        });
+        console.log("");
+    }
+    catch (e) {
+        console.error(`Plan failed: ${e}`);
+        process.exit(1);
+    }
+});
+queryOpts(program
+    .command("audit")
+    .description("Project health — dead code, hotspots, coupling")
+    .option("--json", "Output as JSON"))
+    .action(async (opts) => {
+    try {
+        const client = getClient(opts);
+        const res = await client.audit();
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        console.log(`\n  Project Health Audit`);
+        console.log(`  ──────────────────────`);
+        if (res.overall_score != null)
+            console.log(`  Score:     ${res.overall_score}`);
+        console.log(`  Dead code: ${res.dead_symbols.length} unused symbols`);
+        console.log(`  Hotspots:  ${res.hotspots.length}`);
+        console.log(`  Coupling:  ${res.coupling_warnings.length} warnings`);
+        console.log(`\n  Use --json for full details.\n`);
+    }
+    catch (e) {
+        console.error(`Audit failed: ${e}`);
+        process.exit(1);
+    }
+});
+queryOpts(program
+    .command("manifest")
+    .description("What capabilities does this project offer?")
+    .option("--json", "Output as JSON"))
+    .action(async (opts) => {
+    try {
+        const client = getClient(opts);
+        const res = await client.manifest();
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (e) {
+        console.error(`Manifest failed: ${e}`);
+        process.exit(1);
+    }
+});
+queryOpts(program
+    .command("context <target>")
+    .description("Get AI-ready markdown context for a symbol or file")
+    .option("--file", "Treat target as a file path instead of symbol name"))
+    .action(async (target, opts) => {
+    try {
+        const client = getClient(opts);
+        const res = opts.file
+            ? await client.context({ file: target })
+            : await client.context({ symbol: target });
+        console.log(res.markdown);
+    }
+    catch (e) {
+        console.error(`Context failed: ${e}`);
+        process.exit(1);
+    }
+});
+queryOpts(program
+    .command("prospect")
+    .description("Diamond prospecting — rank files by mining fertility")
+    .option("-n, --top <n>", "Top N results", "20")
+    .option("--prefix <prefix>", "Filter by path prefix")
+    .option("--json", "Output as JSON"))
+    .action(async (opts) => {
+    try {
+        const client = getClient(opts);
+        const res = await client.prospect(parseInt(opts.top), opts.prefix);
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (e) {
+        console.error(`Prospect failed: ${e}`);
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/client.d.ts

@@ -33,4 +33,17 @@ export declare class XRayClient {
         count: number;
         symbols: unknown[];
     }>;
+    callers(symbol: string, limit?: number): Promise<unknown[]>;
+    callees(symbol: string, limit?: number): Promise<unknown[]>;
+    transitiveImpact(symbol: string, depth?: number): Promise<unknown[]>;
+    planChange(symbol: string, depth?: number): Promise<unknown>;
+    audit(): Promise<unknown>;
+    manifest(): Promise<unknown>;
+    context(opts: {
+        symbol?: string;
+        file?: string;
+    }): Promise<{
+        markdown: string;
+    }>;
+    prospect(top?: number, prefix?: string): Promise<unknown>;
 }

package/dist/client.js

@@ -66,5 +66,37 @@ class XRayClient {
     async symbolsIn(file) {
         return this.request("/symbols-in", { file });
     }
+    async callers(symbol, limit = 20) {
+        return this.request("/callers", { symbol, limit: String(limit) });
+    }
+    async callees(symbol, limit = 20) {
+        return this.request("/callees", { symbol, limit: String(limit) });
+    }
+    async transitiveImpact(symbol, depth = 2) {
+        return this.request("/transitive-impact", { symbol, depth: String(depth) });
+    }
+    async planChange(symbol, depth = 2) {
+        return this.request("/plan-change", { symbol, depth: String(depth) });
+    }
+    async audit() {
+        return this.request("/audit");
+    }
+    async manifest() {
+        return this.request("/manifest");
+    }
+    async context(opts) {
+        const params = {};
+        if (opts.symbol)
+            params.symbol = opts.symbol;
+        if (opts.file)
+            params.file = opts.file;
+        return this.request("/context", params);
+    }
+    async prospect(top = 20, prefix) {
+        const params = { top: String(top) };
+        if (prefix)
+            params.prefix = prefix;
+        return this.request("/prospect", params);
+    }
 }
 exports.XRayClient = XRayClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xray-code",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "XRay — code intelligence CLI. X-ray your codebase with instant cross-references.",
   "bin": {
     "xray": "dist/cli.js"