@compilr-dev/cli 0.5.5 → 0.5.6

package/dist/ui/tool-formatters.js

@@ -73,6 +73,9 @@ export function formatToolResult(toolName, result) {
         else if (toolLower === 'find_project_root') {
             ({ content, summary } = formatFindProjectRoot(innerResult));
         }
+        else if (toolLower === 'workitem_status_counts') {
+            ({ content, summary } = formatWorkitemStatusCounts(innerResult));
+        }
         else if (toolLower === 'backlog_write' || toolLower.startsWith('workitem_')) {
             ({ content, summary } = formatBacklogWrite(innerResult));
         }
@@ -193,6 +196,54 @@ export function formatToolResult(toolName, result) {
         else if (toolLower === 'read_function' || toolLower === 'read_class' || toolLower === 'read_type') {
             ({ content, summary } = formatReadSymbol(innerResult));
         }
+        else if (toolLower === 'web_fetch') {
+            ({ content, summary } = formatWebFetch(innerResult));
+        }
+        else if (toolLower === 'ask_user' || toolLower === 'ask_user_simple') {
+            ({ content, summary } = formatAskUser(innerResult));
+        }
+        else if (toolLower === 'compilr_guide') {
+            ({ content, summary } = formatCompilrGuide(innerResult));
+        }
+        else if (toolLower === 'delegation_status') {
+            ({ content, summary } = formatDelegationStatus(innerResult));
+        }
+        else if (toolLower === 'find_symbol') {
+            ({ content, summary } = formatFindSymbol(innerResult));
+        }
+        else if (toolLower === 'get_imports') {
+            ({ content, summary } = formatGetImports(innerResult));
+        }
+        else if (toolLower === 'get_exports') {
+            ({ content, summary } = formatGetExports(innerResult));
+        }
+        else if (toolLower === 'get_call_graph') {
+            ({ content, summary } = formatGetCallGraph(innerResult));
+        }
+        else if (toolLower === 'get_dependency_graph') {
+            ({ content, summary } = formatGetDependencyGraph(innerResult));
+        }
+        else if (toolLower === 'find_implementations') {
+            ({ content, summary } = formatFindImplementations(innerResult));
+        }
+        else if (toolLower === 'get_type_hierarchy' || toolLower === 'get_class_hierarchy') {
+            ({ content, summary } = formatGetTypeHierarchy(innerResult));
+        }
+        else if (toolLower === 'find_dead_code') {
+            ({ content, summary } = formatFindDeadCode(innerResult));
+        }
+        else if (toolLower === 'find_duplicates') {
+            ({ content, summary } = formatFindDuplicates(innerResult));
+        }
+        else if (toolLower === 'find_patterns') {
+            ({ content, summary } = formatFindPatterns(innerResult));
+        }
+        else if (toolLower === 'get_signature') {
+            ({ content, summary } = formatGetSignature(innerResult));
+        }
+        else if (toolLower === 'get_documentation' || toolLower === 'extract_docstrings') {
+            ({ content, summary } = formatGetDocumentation(innerResult));
+        }
         else {
             // Generic handling
             ({ content, summary } = formatGeneric(innerResult));
@@ -1186,6 +1237,323 @@ function formatFactoryListToolkits(result) {
     });
     return { content: lines.join('\n'), summary };
 }
+// =============================================================================
+// Missing Formatters — SDK, Agents, CLI
+// =============================================================================
+function formatWorkitemStatusCounts(result) {
+    const summary_str = result.summary;
+    const counts = result.counts;
+    const total = result.total;
+    const progress = result.progress;
+    if (summary_str) {
+        return { content: '', summary: summary_str };
+    }
+    if (counts) {
+        const parts = Object.entries(counts)
+            .filter(([, v]) => v > 0)
+            .map(([k, v]) => `${String(v)} ${k}`);
+        const pct = progress !== undefined ? ` (${String(Math.round(progress))}%)` : '';
+        return { content: parts.join('\n'), summary: `${String(total ?? 0)} items${pct}` };
+    }
+    return { content: '', summary: 'No items' };
+}
+function formatWebFetch(result) {
+    const url = result.url;
+    const status = result.status;
+    const truncated = result.truncated;
+    const content = typeof result.content === 'string' ? result.content : '';
+    const urlShort = url ? url.replace(/^https?:\/\//, '').slice(0, 40) : '?';
+    const statusInfo = status ? ` (${String(status)})` : '';
+    const truncInfo = truncated ? ' [truncated]' : '';
+    return { content, summary: `${urlShort}${statusInfo}${truncInfo}` };
+}
+function formatAskUser(result) {
+    // ask_user returns { answers: Record<string, string|string[]> }
+    const answers = result.answers;
+    const answer = result.answer;
+    if (answer) {
+        return { content: '', summary: `Answer: ${answer.slice(0, 60)}` };
+    }
+    if (answers) {
+        const entries = Object.entries(answers);
+        if (entries.length === 1) {
+            const val = Array.isArray(entries[0][1]) ? entries[0][1].join(', ') : entries[0][1];
+            return { content: '', summary: `Answer: ${val.slice(0, 60)}` };
+        }
+        return { content: '', summary: `${String(entries.length)} answer(s)` };
+    }
+    return { content: '', summary: 'User responded' };
+}
+function formatCompilrGuide(result) {
+    const output = result.output;
+    const content = output || '';
+    const firstLine = content.split('\n').find((l) => l.trim().length > 0) || 'Guide';
+    return { content, summary: firstLine.slice(0, 60) };
+}
+function formatDelegationStatus(result) {
+    const delegations = result.delegations;
+    if (!delegations?.length) {
+        return { content: '', summary: 'No active delegations' };
+    }
+    const summary = `${String(delegations.length)} delegation(s)`;
+    const lines = delegations.slice(0, 5).map((d) => {
+        const agent = d.targetAgent || '?';
+        const status = d.status || '?';
+        const dur = d.duration ? ` (${d.duration})` : '';
+        const task = (d.task || '').slice(0, 40);
+        return `[${status}] ${agent}: ${task}${dur}`;
+    });
+    if (delegations.length > 5)
+        lines.push(`... and ${String(delegations.length - 5)} more`);
+    return { content: lines.join('\n'), summary };
+}
+// =============================================================================
+// Code Analysis Formatters (TS/Python/Go)
+// =============================================================================
+function formatFindSymbol(result) {
+    const definitions = result.definitions;
+    if (!definitions?.length) {
+        return { content: '', summary: 'No symbols found' };
+    }
+    const summary = `Found ${String(definitions.length)} symbol(s)`;
+    const lines = definitions.slice(0, 8).map((d) => {
+        const exp = d.exported ? ' [exported]' : '';
+        const container = d.container ? ` in ${d.container}` : '';
+        return `${d.path || '?'}:${String(d.line ?? 0)} [${d.kind || '?'}] ${d.name || '?'}${container}${exp}`;
+    });
+    if (definitions.length > 8)
+        lines.push(`... and ${String(definitions.length - 8)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatGetImports(result) {
+    const imports = result.imports;
+    const stats = result.stats;
+    if (!imports?.length) {
+        return { content: '', summary: 'No imports' };
+    }
+    const ext = stats?.externalPackages ?? 0;
+    const int = stats?.internalModules ?? 0;
+    const summary = `${String(stats?.totalImports ?? imports.length)} import(s) (${String(ext)} external, ${String(int)} internal)`;
+    const lines = imports.slice(0, 10).map((imp) => {
+        const prefix = imp.isExternal ? '[ext]' : '[int]';
+        const typeOnly = imp.typeOnly ? ' (type)' : '';
+        const symbolCount = imp.symbols?.length ? ` (${String(imp.symbols.length)} symbols)` : '';
+        return `${prefix} ${imp.source || '?'}${typeOnly}${symbolCount}`;
+    });
+    if (imports.length > 10)
+        lines.push(`... and ${String(imports.length - 10)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatGetExports(result) {
+    const namedExports = result.namedExports;
+    const defaultExport = result.defaultExport;
+    const stats = result.stats;
+    const total = stats?.totalExports ?? (namedExports?.length ?? 0) + (defaultExport ? 1 : 0);
+    if (total === 0) {
+        return { content: '', summary: 'No exports' };
+    }
+    const parts = [];
+    if (stats?.functions)
+        parts.push(`${String(stats.functions)} fn`);
+    if (stats?.classes)
+        parts.push(`${String(stats.classes)} class`);
+    if (stats?.types)
+        parts.push(`${String(stats.types)} type`);
+    if (stats?.variables)
+        parts.push(`${String(stats.variables)} var`);
+    const summary = `${String(total)} export(s)${parts.length ? ` (${parts.join(', ')})` : ''}`;
+    const lines = [];
+    if (defaultExport) {
+        lines.push(`default: ${defaultExport.name || '?'} [${defaultExport.kind || '?'}]`);
+    }
+    if (namedExports?.length) {
+        for (const exp of namedExports.slice(0, 10)) {
+            const typeOnly = exp.typeOnly ? ' (type)' : '';
+            lines.push(`${exp.name || '?'} [${exp.kind || '?'}]${typeOnly}`);
+        }
+        if (namedExports.length > 10)
+            lines.push(`... and ${String(namedExports.length - 10)} more`);
+    }
+    return { content: lines.join('\n'), summary };
+}
+function formatGetCallGraph(result) {
+    const graph = result.graph;
+    const stats = result.stats;
+    if (!graph?.length) {
+        return { content: '', summary: 'Empty call graph' };
+    }
+    const fns = stats?.totalFunctions ?? graph.length;
+    const calls = stats?.totalCalls ?? 0;
+    const summary = `${String(fns)} function(s), ${String(calls)} call(s)`;
+    const lines = graph.slice(0, 8).map((node) => {
+        const fn = node.function;
+        const name = fn?.className ? `${fn.className}.${fn.name || '?'}` : fn?.name || '?';
+        const callCount = node.calls?.length ?? 0;
+        const callNames = node.calls?.slice(0, 3).map((c) => c.function?.name || '?').join(', ') || '';
+        const more = callCount > 3 ? `, +${String(callCount - 3)}` : '';
+        return `${name} → ${callNames}${more}` + (callCount === 0 ? ' (leaf)' : '');
+    });
+    if (graph.length > 8)
+        lines.push(`... and ${String(graph.length - 8)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatGetDependencyGraph(result) {
+    const circularDependencies = result.circularDependencies;
+    const stats = result.stats;
+    if (!stats) {
+        return { content: '', summary: 'Dependency graph' };
+    }
+    const circ = stats.circularDependencies ?? circularDependencies?.length ?? 0;
+    const circLabel = circ > 0 ? `, ${String(circ)} circular` : '';
+    const summary = `${String(stats.totalModules ?? 0)} modules, ${String(stats.totalEdges ?? 0)} edges${circLabel}`;
+    const lines = [];
+    lines.push(`Internal: ${String(stats.internalModules ?? 0)}, External: ${String(stats.externalPackages ?? 0)}`);
+    if (stats.mostDependencies?.module) {
+        lines.push(`Most deps: ${stats.mostDependencies.module} (${String(stats.mostDependencies.count ?? 0)})`);
+    }
+    if (circularDependencies?.length) {
+        lines.push('Circular:');
+        for (const c of circularDependencies.slice(0, 3)) {
+            lines.push(`  ${c.cycle?.join(' → ') || '?'}`);
+        }
+        if (circularDependencies.length > 3)
+            lines.push(`  ... and ${String(circularDependencies.length - 3)} more`);
+    }
+    return { content: lines.join('\n'), summary };
+}
+function formatFindImplementations(result) {
+    const target = result.target;
+    const implementations = result.implementations;
+    if (!implementations?.length) {
+        return { content: '', summary: `No implementations of ${target || '?'}` };
+    }
+    const summary = `Found ${String(implementations.length)} implementation(s) of ${target || '?'}`;
+    const lines = implementations.slice(0, 8).map((impl) => {
+        const exp = impl.exported ? ' [exported]' : '';
+        const missing = impl.missingMethods?.length ? ` (${String(impl.missingMethods.length)} missing)` : '';
+        return `${impl.path || '?'}:${String(impl.line ?? 0)} ${impl.name || '?'} [${impl.kind || '?'}]${exp}${missing}`;
+    });
+    if (implementations.length > 8)
+        lines.push(`... and ${String(implementations.length - 8)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatGetTypeHierarchy(result) {
+    // TS format: root + allTypes
+    const root = result.root;
+    const allTypes = result.allTypes;
+    // Python format: className + parents + children + mro
+    const className = result.className;
+    const parents = result.parents;
+    const children = result.children;
+    const mro = result.mro;
+    if (className) {
+        const parentNames = parents?.map((p) => p.name || '?').join(', ') || 'none';
+        const childNames = children?.map((c) => c.name || '?').join(', ') || 'none';
+        const summary = `${className}: ${String(parents?.length ?? 0)} parent(s), ${String(children?.length ?? 0)} child(ren)`;
+        const lines = [];
+        lines.push(`Parents: ${parentNames}`);
+        lines.push(`Children: ${childNames}`);
+        if (mro?.length)
+            lines.push(`MRO: ${mro.join(' → ')}`);
+        return { content: lines.join('\n'), summary };
+    }
+    if (root) {
+        const total = allTypes?.length ?? 0;
+        const summary = `${root.name || '?'} [${root.kind || '?'}]: ${String(total)} type(s) in hierarchy`;
+        const lines = [];
+        if (root.parents && Array.isArray(root.parents) && root.parents.length > 0) {
+            lines.push(`Parents: ${String(root.parents.length)}`);
+        }
+        if (root.children && Array.isArray(root.children) && root.children.length > 0) {
+            lines.push(`Children: ${String(root.children.length)}`);
+        }
+        return { content: lines.join('\n'), summary };
+    }
+    return { content: '', summary: 'Type hierarchy' };
+}
+function formatFindDeadCode(result) {
+    const deadCode = result.deadCode;
+    if (!deadCode?.length) {
+        return { content: '', summary: 'No dead code found' };
+    }
+    const summary = `Found ${String(deadCode.length)} unused item(s)`;
+    const lines = deadCode.slice(0, 8).map((d) => {
+        const conf = d.confidence ? ` (${d.confidence})` : '';
+        return `${d.path || '?'}:${String(d.line ?? 0)} [${d.kind || '?'}] ${d.name || '?'}${conf}`;
+    });
+    if (deadCode.length > 8)
+        lines.push(`... and ${String(deadCode.length - 8)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatFindDuplicates(result) {
+    const duplicates = result.duplicates;
+    const stats = result.stats;
+    if (!duplicates?.length) {
+        return { content: '', summary: 'No duplicates found' };
+    }
+    const pct = stats?.percentageDuplicate !== undefined ? ` (${stats.percentageDuplicate.toFixed(1)}%)` : '';
+    const summary = `${String(stats?.duplicateGroups ?? duplicates.length)} duplicate group(s), ${String(stats?.totalDuplicateLines ?? 0)} lines${pct}`;
+    const lines = duplicates.slice(0, 5).map((d, i) => {
+        const locs = d.locations?.map((l) => `${l.path || '?'}:${String(l.startLine ?? 0)}-${String(l.endLine ?? 0)}`).join(', ') || '?';
+        return `Group ${String(i + 1)} (${String(d.lines ?? 0)} lines): ${locs}`;
+    });
+    if (duplicates.length > 5)
+        lines.push(`... and ${String(duplicates.length - 5)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatFindPatterns(result) {
+    const matches = result.matches;
+    const stats = result.stats;
+    if (!matches?.length) {
+        return { content: '', summary: 'No patterns matched' };
+    }
+    const sev = stats?.bySeverity;
+    const sevParts = [];
+    if (sev?.error)
+        sevParts.push(`${String(sev.error)} error`);
+    if (sev?.warning)
+        sevParts.push(`${String(sev.warning)} warning`);
+    if (sev?.info)
+        sevParts.push(`${String(sev.info)} info`);
+    const summary = `${String(stats?.totalMatches ?? matches.length)} match(es)${sevParts.length ? ` (${sevParts.join(', ')})` : ''}`;
+    const lines = matches.slice(0, 8).map((m) => {
+        const loc = `${m.path || '?'}:${String(m.line ?? 0)}`;
+        return `[${m.severity || '?'}] ${loc} ${(m.snippet || '').slice(0, 40)}`;
+    });
+    if (matches.length > 8)
+        lines.push(`... and ${String(matches.length - 8)} more`);
+    return { content: lines.join('\n'), summary };
+}
+function formatGetSignature(result) {
+    const name = result.name;
+    const kind = result.kind;
+    const formattedSignature = result.formattedSignature;
+    const signature = result.signature;
+    const exported = result.exported;
+    const exp = exported ? ' [exported]' : '';
+    const summary = `[${kind || 'symbol'}] ${name || '?'}${exp}`;
+    const content = formattedSignature || signature || '';
+    return { content, summary };
+}
+function formatGetDocumentation(result) {
+    const summary_data = result.summary;
+    const undocumentedExports = result.undocumentedExports;
+    if (summary_data) {
+        const pct = summary_data.coveragePercent !== undefined ? summary_data.coveragePercent.toFixed(0) : '?';
+        const summary = `${String(summary_data.documentedSymbols ?? 0)}/${String(summary_data.totalSymbols ?? 0)} documented (${pct}%)`;
+        const lines = [];
+        if (undocumentedExports?.length) {
+            lines.push('Undocumented:');
+            for (const u of undocumentedExports.slice(0, 8)) {
+                lines.push(`  ${u.path || '?'}:${String(u.line ?? 0)} [${u.kind || '?'}] ${u.name || '?'}`);
+            }
+            if (undocumentedExports.length > 8)
+                lines.push(`  ... and ${String(undocumentedExports.length - 8)} more`);
+        }
+        return { content: lines.join('\n'), summary };
+    }
+    return { content: '', summary: 'Documentation analysis complete' };
+}
 function formatGeneric(result) {
     const content = typeof result.content === 'string'
         ? result.content

package/dist/utils/readonly-tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Read-only tool classification.
+ *
+ * Uses CAPABILITY_PACKS from SDK to determine which tools are read-only,
+ * plus a suffix-based heuristic for tools not in any pack.
+ * Read-only tools are hidden in focused mode (spinner only, no scroll output).
+ */
+export declare function isReadOnlyTool(toolName: string): boolean;

package/dist/utils/readonly-tools.js

@@ -0,0 +1,29 @@
+/**
+ * Read-only tool classification.
+ *
+ * Uses CAPABILITY_PACKS from SDK to determine which tools are read-only,
+ * plus a suffix-based heuristic for tools not in any pack.
+ * Read-only tools are hidden in focused mode (spinner only, no scroll output).
+ */
+import { CAPABILITY_PACKS } from '@compilr-dev/sdk';
+const READ_ONLY_TOOLS = new Set();
+// 1. Add all tools from read-only capability packs
+for (const pack of Object.values(CAPABILITY_PACKS)) {
+    if (pack.readOnly) {
+        for (const tool of pack.tools) {
+            READ_ONLY_TOOLS.add(tool);
+        }
+    }
+}
+// 2. Suffixes that indicate a read-only tool (query/inspect, no mutations)
+const READ_ONLY_SUFFIXES = [
+    '_read', '_get', '_list', '_query', '_status', '_counts',
+    '_search', '_find', '_check', '_info', '_view',
+];
+export function isReadOnlyTool(toolName) {
+    if (READ_ONLY_TOOLS.has(toolName))
+        return true;
+    // Suffix heuristic for platform/meta tools not explicitly in a read-only pack
+    const lower = toolName.toLowerCase();
+    return READ_ONLY_SUFFIXES.some(suffix => lower.endsWith(suffix));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/cli",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "AI-powered coding assistant CLI using @compilr-dev/agents",
   "type": "module",
   "main": "dist/index.js",