@shrkcrft/mcp-server 0.1.0-alpha.14 → 0.1.0-alpha.16

package/dist/tools/code-find-usages.tool.js

@@ -1,6 +1,7 @@
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { EdgeKind, GraphQueryApi, GraphStore, NodeKind } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 /**
  * `code_find_usages` — structured usage finder backed by the
  * SharkCraft graph (file + symbol nodes + import/declare edges).
@@ -16,13 +17,14 @@ import { EdgeKind, GraphQueryApi, GraphStore, NodeKind } from '@shrkcrft/graph';
  */
 export const codeFindUsagesTool = {
     name: 'code_find_usages',
-    description: 'Find structured usages of a symbol via the SharkCraft graph (file + symbol nodes). Read-only. Distinguishes definition, import-of-declaring-file, and neighbouring symbols.',
+    description: 'Find structured usages of a symbol via the SharkCraft graph (file + symbol nodes). Read-only. Distinguishes definition, import-of-declaring-file, and neighbouring symbols. Pass `format:"table"` for a token-efficient columnar encoding of the definitions/importers/neighbours arrays.',
     inputSchema: {
         type: 'object',
         properties: {
             symbolName: { type: 'string' },
             kindHint: { type: 'string' },
             maxResults: { type: 'number' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         required: ['symbolName'],
         additionalProperties: false,
@@ -96,16 +98,19 @@ export const codeFindUsagesTool = {
                 }
             }
         }
-        return {
-            data: {
-                symbol: { name: symbolName, kind: matches[0]?.kind ?? 'unknown' },
-                definitions,
-                importersOfDeclaringFile: [...importerSet.values()],
-                neighbouringSymbols: neighbours.slice(0, 12),
-                totalSymbolMatches: matches.length,
-                note: 'importersOfDeclaringFile = files that import the declaring file. This is a structural signal — it may include type-only imports and unused references. Pair with `shrk impact` for a tighter blast radius.',
-            },
+        const data = {
+            symbol: { name: symbolName, kind: matches[0]?.kind ?? 'unknown' },
+            definitions,
+            importersOfDeclaringFile: [...importerSet.values()],
+            neighbouringSymbols: neighbours.slice(0, 12),
+            totalSymbolMatches: matches.length,
+            note: 'importersOfDeclaringFile = files that import the declaring file. This is a structural signal — it may include type-only imports and unused references. Pair with `shrk impact` for a tighter blast radius.',
         };
+        // `format:"table"` columnar-encodes the homogeneous object-array fields
+        // (definitions, importersOfDeclaringFile, neighbouringSymbols); the scalar
+        // `symbol` object, totalSymbolMatches, and the note string pass through
+        // untouched. Default/`format:"json"` returns the bare object unchanged.
+        return { data: formatObjectArrays(data, input) };
     },
 };
 function declaringFileOf(api, symbolId) {

package/dist/tools/command-catalog.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-catalog.tool.d.ts","sourceRoot":"","sources":["../../src/tools/command-catalog.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAiBpE,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,cAAc,CAAC;CAC7C;AAwBD,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAgFzD,CAAC;AA+BH,eAAO,MAAM,qBAAqB,EAAE,eA4BnC,CAAC"}
+{"version":3,"file":"command-catalog.tool.d.ts","sourceRoot":"","sources":["../../src/tools/command-catalog.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAkBpE,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,cAAc,CAAC;CAC7C;AAwBD,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAgFzD,CAAC;AA+BH,eAAO,MAAM,qBAAqB,EAAE,eA+BnC,CAAC"}

package/dist/tools/command-catalog.tool.js

@@ -1,3 +1,4 @@
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const MCP_BOOTSTRAP_CORE = new Set([
     'doctor',
     'init',
@@ -123,6 +124,7 @@ export const getCommandCatalogTool = {
         properties: {
             safetyLevel: { type: 'string', description: 'Filter by safety level (read-only, writes-session, writes-drafts, writes-source, runs-shell, requires-review).' },
             category: { type: 'string', description: 'Filter by category.' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -134,14 +136,16 @@ export const getCommandCatalogTool = {
             entries = entries.filter((e) => e.safetyLevel === safety);
         if (typeof category === 'string')
             entries = entries.filter((e) => e.category === category);
-        return {
-            data: {
-                entries,
-                totals: {
-                    total: COMMAND_CATALOG_EXPORT.length,
-                    returned: entries.length,
-                },
+        const data = {
+            entries,
+            totals: {
+                total: COMMAND_CATALOG_EXPORT.length,
+                returned: entries.length,
             },
         };
+        // `format:"table"` columnar-encodes the homogeneous `entries` array
+        // (the ~11-field catalog rows); the `totals` scalar object is left
+        // untouched. Default/`format:"json"` returns the object unchanged.
+        return { data: formatObjectArrays(data, input) };
     },
 };

package/dist/tools/compress-context.tool.d.ts

@@ -0,0 +1,8 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * Deterministic context compressor exposed to agents — shrink a blob before it
+ * re-enters the prompt, with no model in the loop: it's a pure function of the
+ * input. Reversible via the CCR store wired into the server context.
+ */
+export declare const compressContextTool: IToolDefinition;
+//# sourceMappingURL=compress-context.tool.d.ts.map

package/dist/tools/compress-context.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/compress-context.tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eA4EjC,CAAC"}

package/dist/tools/compress-context.tool.js

@@ -0,0 +1,80 @@
+import { compressContent, EContentType, } from '@shrkcrft/compress';
+const CONTENT_TYPES = new Set(Object.values(EContentType));
+/**
+ * Deterministic context compressor exposed to agents — shrink a blob before it
+ * re-enters the prompt, with no model in the loop: it's a pure function of the
+ * input. Reversible via the CCR store wired into the server context.
+ */
+export const compressContextTool = {
+    name: 'compress_context',
+    description: 'Deterministically compress a blob (tool output, build/test log, grep/search results, unified diff, or JSON) BEFORE you feed it back to the model — same information, far fewer tokens. Routes by content type, hoists JSON object-array schemas into dense tables, and reduces logs/search/diffs to their highest-signal lines. Reversible: when a lossy pass drops detail it caches the original and emits a `<<ccr:KEY>>` marker — call `retrieve_original` to get the full text back. No AI involved; same bytes in, same bytes out. Read-only.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            content: { type: 'string', description: 'The text to compress.' },
+            contentType: {
+                type: 'string',
+                description: 'Force a content class instead of auto-detecting: json | json-array | git-diff | search-results | build-log | source-code | markdown | plain-text.',
+            },
+            query: {
+                type: 'string',
+                description: 'Optional task/query text that biases which lines or matches are kept.',
+            },
+            maxItems: {
+                type: 'number',
+                description: 'Soft cap on retained lines / matches / hunks (compressor-specific).',
+            },
+            maxTokens: {
+                type: 'number',
+                minimum: 1,
+                description: 'Token budget for a JSON array. When set and the lossless columnar form still exceeds it, falls back to the lossy SmartCrusher row-sampler (kept rows + CCR original).',
+            },
+        },
+        required: ['content'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const content = typeof input.content === 'string' ? input.content : '';
+        if (content.length === 0) {
+            return {
+                isError: true,
+                text: 'compress_context requires a non-empty "content" string.',
+                error: { code: 'invalid-input', message: 'content is required' },
+            };
+        }
+        const opts = {};
+        if (ctx.ccrStore)
+            opts.store = ctx.ccrStore;
+        if (typeof input.query === 'string')
+            opts.query = input.query;
+        if (typeof input.maxItems === 'number' && input.maxItems > 0) {
+            opts.maxItems = Math.floor(input.maxItems);
+        }
+        if (typeof input.maxTokens === 'number' && input.maxTokens > 0) {
+            opts.maxTokens = Math.floor(input.maxTokens);
+        }
+        if (typeof input.contentType === 'string' && CONTENT_TYPES.has(input.contentType)) {
+            opts.contentType = input.contentType;
+        }
+        const result = compressContent(content, opts);
+        const pct = Math.round(result.savings.ratio * 100);
+        return {
+            data: {
+                contentType: result.contentType,
+                strategy: result.strategy,
+                lossy: result.lossy,
+                tokensBefore: result.savings.before,
+                tokensAfter: result.savings.after,
+                tokensSaved: result.savings.saved,
+                savedRatio: result.savings.ratio,
+                ccrKey: result.ccrKey ?? null,
+                note: result.note,
+                compressed: result.compressed,
+                ...(result.ccrKey
+                    ? { retrieveWith: `retrieve_original { "key": "${result.ccrKey}" }` }
+                    : {}),
+            },
+            text: `${result.strategy}: ${result.savings.before} → ${result.savings.after} tokens (−${pct}%)${result.ccrKey ? ` · original cached as ${result.ccrKey}` : ''}`,
+        };
+    },
+};

package/dist/tools/dashboard-summary.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-summary.tool.d.ts","sourceRoot":"","sources":["../../src/tools/dashboard-summary.tool.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE,eAAO,MAAM,uBAAuB,EAAE,eA0LrC,CAAC"}
+{"version":3,"file":"dashboard-summary.tool.d.ts","sourceRoot":"","sources":["../../src/tools/dashboard-summary.tool.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE,eAAO,MAAM,uBAAuB,EAAE,eA0LrC,CAAC"}

package/dist/tools/dashboard-summary.tool.js

@@ -1,8 +1,6 @@
 import { buildAreaMap, buildAiReadinessReport, buildCoverageReport, buildDriftReport, buildQualityReport, buildReleaseReadiness, buildSafetyAudit, evaluatePolicy, listConstructs, listDevSessionsDetailed, listFeatureBundles, listPlaybooks, } from '@shrkcrft/inspector';
 import { existsSync, readFileSync, statSync } from 'node:fs';
 import * as nodePath from 'node:path';
-// DX#4 — derive audit view from ALL_TOOLS at runtime.
-import { ALL_TOOLS } from "./all-tools.js";
 export const getDashboardSummaryTool = {
     name: 'get_dashboard_summary',
     description: 'Compact dashboard summary aggregating quality, safety, readiness, coverage, drift, packs, sessions, bundles, command-safety totals, and recommended next commands. Read-only.',
@@ -75,7 +73,7 @@ export const getDashboardSummaryTool = {
         const safety = buildSafetyAudit({
             inspection,
             catalog: [],
-            mcpTools: ALL_TOOLS.map((t) => ({ name: t.name, description: t.description })),
+            mcpTools: (ctx.allTools ?? []).map((t) => ({ name: t.name, description: t.description })),
             planSecretEnv: 'SHARKCRAFT_PLAN_SECRET',
             planSecretConfigured: typeof process.env['SHARKCRAFT_PLAN_SECRET'] === 'string' &&
                 process.env['SHARKCRAFT_PLAN_SECRET'].length > 0,
@@ -155,7 +153,7 @@ export const getDashboardSummaryTool = {
                 invalid: inspection.packs.invalidPacks?.length ?? 0,
             },
             policy: policySummary,
-            mcpTools: { total: ALL_TOOLS.length, anyWritable: safety.mcp.anyWritable },
+            mcpTools: { total: ctx.allTools?.length ?? 0, anyWritable: safety.mcp.anyWritable },
             reportSite: { available: siteAvailable, dir: reportSiteDir },
             releaseReadiness: releaseReadinessSummary,
             releaseSmoke: smokeSummary,

package/dist/tools/deps-audit.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps-audit.tool.d.ts","sourceRoot":"","sources":["../../src/tools/deps-audit.tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,eAoC3B,CAAC"}
+{"version":3,"file":"deps-audit.tool.d.ts","sourceRoot":"","sources":["../../src/tools/deps-audit.tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,eAkE3B,CAAC"}

package/dist/tools/deps-audit.tool.js

@@ -1,6 +1,8 @@
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { GraphQueryApi, GraphStore, NodeKind } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays, COLUMNAR_LEGEND } from "../server/columnar-format.js";
+import { fitArrayToBudget } from "../server/fit-array-to-budget.js";
 /**
  * `deps_audit` — MCP wrapper around `shrk deps-audit`. Pure read-only.
  * Returns the same shape the CLI's `--json` mode emits.
@@ -10,11 +12,17 @@ import { GraphQueryApi, GraphStore, NodeKind } from '@shrkcrft/graph';
  */
 export const depsAuditTool = {
     name: 'deps_audit',
-    description: 'Per-package audit of declared dependencies (package.json) vs actually-imported specifiers (graph). Reports missing + unused deps. Read-only.',
+    description: 'Per-package audit of declared dependencies (package.json) vs actually-imported specifiers (graph). Reports missing + unused deps. Pass `format:"table"` for a token-efficient columnar encoding of the per-package report list. Read-only.',
     inputSchema: {
         type: 'object',
         properties: {
             package: { type: 'string' },
+            ...FORMAT_INPUT_PROPERTY,
+            maxTokens: {
+                type: 'number',
+                minimum: 1,
+                description: 'Token budget for the per-package report list. When set and the columnar form still exceeds it, falls back to the lossy SmartCrusher row-sampler (full original cached — retrieve via the returned ccrKey).',
+            },
         },
         additionalProperties: false,
     },
@@ -38,7 +46,29 @@ export const depsAuditTool = {
             acc.unused += r.unusedDeps.length;
             return acc;
         }, { missing: 0, unused: 0 });
-        return { data: { totals, packages: reports } };
+        // P5.2: an explicit token budget routes the per-package report list through
+        // the SmartCrusher row-sampler (lossy, CCR-recoverable) when even the
+        // columnar form is over budget.
+        const maxTokens = typeof input.maxTokens === 'number' && input.maxTokens > 0 ? Math.floor(input.maxTokens) : undefined;
+        if (maxTokens) {
+            const fitted = fitArrayToBudget(reports, maxTokens, ctx.ccrStore);
+            return {
+                data: {
+                    _format: 'table',
+                    _legend: COLUMNAR_LEGEND,
+                    totals,
+                    packages: fitted.value,
+                    ...(fitted.ccrKey
+                        ? { ccrKey: fitted.ccrKey, retrieveWith: `retrieve_original { "key": "${fitted.ccrKey}" }` }
+                        : {}),
+                },
+            };
+        }
+        // `format:"table"` columnar-encodes the homogeneous `packages` report
+        // list; the `totals` scalar object is left untouched. The per-package
+        // string arrays (importedSpecifiers/missingDeps/unusedDeps) ride along
+        // inside each compacted row and reconstruct losslessly.
+        return { data: formatObjectArrays({ totals, packages: reports }, input) };
     },
 };
 function listWorkspacePackages(cwd, onlyName) {

package/dist/tools/get-code-intelligence-state.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-code-intelligence-state.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-code-intelligence-state.tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AASpE;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,eAiC1C,CAAC"}
+{"version":3,"file":"get-code-intelligence-state.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-code-intelligence-state.tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,eAiC1C,CAAC"}

package/dist/tools/get-code-intelligence-state.tool.js

@@ -1,4 +1,5 @@
 import { buildCodeIntelligenceChecks, DoctorSeverity, } from '@shrkcrft/inspector';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 /**
  * Read-only MCP mirror of `shrk code-intel`. Returns the same 14
  * code-intelligence doctor findings in one shot — agents can pull
@@ -16,6 +17,7 @@ export const getCodeIntelligenceStateTool = {
         properties: {
             only: { type: 'array', items: { type: 'string' } },
             checkId: { type: 'string' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -30,14 +32,13 @@ export const getCodeIntelligenceStateTool = {
             checks = checks.filter((c) => allowed.has(c.severity));
         }
         const summary = summarize(checks);
-        return {
-            data: {
-                schema: 'sharkcraft.code-intelligence-state/v1',
-                totalChecks: checks.length,
-                summary,
-                checks,
-            },
+        const data = {
+            schema: 'sharkcraft.code-intelligence-state/v1',
+            totalChecks: checks.length,
+            summary,
+            checks,
         };
+        return { data: formatObjectArrays(data, input) };
     },
 };
 function summarize(checks) {

package/dist/tools/get-graph-callers.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-callers.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-callers.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AASpE,eAAO,MAAM,mBAAmB,EAAE,eA0DjC,CAAC"}
+{"version":3,"file":"get-graph-callers.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-callers.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE,eAAO,MAAM,mBAAmB,EAAE,eA0DjC,CAAC"}

package/dist/tools/get-graph-callers.tool.js

@@ -1,4 +1,5 @@
 import { GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const NEXT = 'shrk graph index';
 export const getGraphCallersTool = {
     name: 'get_graph_callers',
@@ -9,6 +10,7 @@ export const getGraphCallersTool = {
         properties: {
             symbol: { type: 'string' },
             mode: { type: 'string', enum: ['call', 'reference'] },
+            ...FORMAT_INPUT_PROPERTY,
         },
         required: ['symbol'],
         additionalProperties: false,
@@ -47,15 +49,14 @@ export const getGraphCallersTool = {
             };
         }
         const hits = mode === 'reference' ? api.referencesOf(sym.id) : api.callersOf(sym.id);
-        return {
-            data: {
-                schema: 'sharkcraft.graph-callers/v1',
-                symbol: summarise(sym),
-                mode,
-                total: hits.length,
-                callers: hits.slice(0, 200).map(summarise),
-            },
+        const data = {
+            schema: 'sharkcraft.graph-callers/v1',
+            symbol: summarise(sym),
+            mode,
+            total: hits.length,
+            callers: hits.slice(0, 200).map(summarise),
         };
+        return { data: formatObjectArrays(data, input) };
     },
 };
 function resolveSymbol(api, target) {

package/dist/tools/get-graph-context.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-context.tool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE,eAAO,MAAM,mBAAmB,EAAE,eAiEjC,CAAC"}
+{"version":3,"file":"get-graph-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-context.tool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AASpE,eAAO,MAAM,mBAAmB,EAAE,eAgEjC,CAAC"}

package/dist/tools/get-graph-context.tool.js

@@ -1,4 +1,5 @@
 import { GraphQueryApi, GraphStore, NodeKind, } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const NEXT = 'shrk graph index';
 export const getGraphContextTool = {
     name: 'get_graph_context',
@@ -6,7 +7,7 @@ export const getGraphContextTool = {
     cliCommand: 'graph context',
     inputSchema: {
         type: 'object',
-        properties: { target: { type: 'string' } },
+        properties: { target: { type: 'string' }, ...FORMAT_INPUT_PROPERTY },
         required: ['target'],
         additionalProperties: false,
     },
@@ -44,25 +45,24 @@ export const getGraphContextTool = {
         }
         const neighbours = api.neighbours(anchor.id);
         const symbols = anchor.kind === NodeKind.File ? api.symbolsIn(anchor.id) : [];
-        return {
-            data: {
-                schema: 'sharkcraft.graph-context/v1',
-                anchor: summarise(anchor),
-                importsFrom: neighbours.out
-                    .filter((o) => o.edge.kind === 'imports-file')
-                    .slice(0, 50)
-                    .map((o) => ('resolved' in o.target
-                    ? { id: o.target.id, resolved: false }
-                    : { ...summarise(o.target), resolved: true })),
-                importedBy: neighbours.in
-                    .filter((i) => i.edge.kind === 'imports-file')
-                    .slice(0, 50)
-                    .map((i) => ('resolved' in i.source
-                    ? { id: i.source.id, resolved: false }
-                    : { ...summarise(i.source), resolved: true })),
-                symbols: symbols.slice(0, 50).map(summarise),
-            },
+        const data = {
+            schema: 'sharkcraft.graph-context/v1',
+            anchor: summarise(anchor),
+            importsFrom: neighbours.out
+                .filter((o) => o.edge.kind === 'imports-file')
+                .slice(0, 50)
+                .map((o) => ('resolved' in o.target
+                ? { id: o.target.id, resolved: false }
+                : { ...summarise(o.target), resolved: true })),
+            importedBy: neighbours.in
+                .filter((i) => i.edge.kind === 'imports-file')
+                .slice(0, 50)
+                .map((i) => ('resolved' in i.source
+                ? { id: i.source.id, resolved: false }
+                : { ...summarise(i.source), resolved: true })),
+            symbols: symbols.slice(0, 50).map(summarise),
         };
+        return { data: formatObjectArrays(data, input) };
     },
 };
 function resolveAnchor(api, target) {

package/dist/tools/get-graph-cycles.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-cycles.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-cycles.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAWpE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAmDhC,CAAC"}
+{"version":3,"file":"get-graph-cycles.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-cycles.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAYpE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAmDhC,CAAC"}

package/dist/tools/get-graph-cycles.tool.js

@@ -1,4 +1,5 @@
 import { GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const NEXT = 'shrk graph index';
 /**
  * Read-only MCP mirror of `shrk graph cycles`. Returns the full SCC
@@ -16,6 +17,7 @@ export const getGraphCyclesTool = {
         properties: {
             limit: { type: 'number' },
             minSize: { type: 'number' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -42,16 +44,15 @@ export const getGraphCyclesTool = {
         const all = api.cycles();
         const filtered = all.filter((c) => c.size >= minSize);
         const limited = filtered.slice(0, rawLimit);
-        return {
-            data: {
-                schema: 'sharkcraft.graph-cycles/v1',
-                total: filtered.length,
-                truncated: filtered.length > rawLimit,
-                cycles: limited.map((c) => ({
-                    size: c.size,
-                    paths: c.paths ?? c.nodeIds.map((id) => id.replace(/^file:/, '')),
-                })),
-            },
+        const data = {
+            schema: 'sharkcraft.graph-cycles/v1',
+            total: filtered.length,
+            truncated: filtered.length > rawLimit,
+            cycles: limited.map((c) => ({
+                size: c.size,
+                paths: c.paths ?? c.nodeIds.map((id) => id.replace(/^file:/, '')),
+            })),
         };
+        return { data: formatObjectArrays(data, input) };
     },
 };

package/dist/tools/get-graph-impact-analysis.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-impact-analysis.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-impact-analysis.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE,eAAO,MAAM,0BAA0B,EAAE,eAmCxC,CAAC"}
+{"version":3,"file":"get-graph-impact-analysis.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-impact-analysis.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAWpE,eAAO,MAAM,0BAA0B,EAAE,eAoCxC,CAAC"}

package/dist/tools/get-graph-impact-analysis.tool.js

@@ -1,4 +1,5 @@
 import { analyzeGraphImpact } from '@shrkcrft/impact-engine';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 export const getGraphImpactAnalysisTool = {
     name: 'get_graph_impact_analysis',
     description: 'Rich graph-backed change analysis (schema sharkcraft.graph-impact-analysis/v3). Inputs: file list OR symbol OR git ref. Returns affected symbols/files/packages/rules/templates/tests/risk + recommended validation commands. Read-only.',
@@ -11,6 +12,7 @@ export const getGraphImpactAnalysisTool = {
             gitref: { type: 'string' },
             maxDepth: { type: 'number' },
             limit: { type: 'number' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -34,7 +36,7 @@ export const getGraphImpactAnalysisTool = {
             limit: clamp(args.limit ?? 200, 1, 2000),
             maxDepth: clamp(args.maxDepth ?? 5, 1, 10),
         });
-        return { data: analysis };
+        return { data: formatObjectArrays(analysis, input) };
     },
 };
 function clamp(n, lo, hi) {

package/dist/tools/get-graph-impact.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-impact.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-impact.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE,eAAO,MAAM,kBAAkB,EAAE,eAmEhC,CAAC"}
+{"version":3,"file":"get-graph-impact.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-impact.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAWpE,eAAO,MAAM,kBAAkB,EAAE,eAmEhC,CAAC"}

package/dist/tools/get-graph-impact.tool.js

@@ -1,4 +1,5 @@
 import { GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const NEXT = 'shrk graph index';
 export const getGraphImpactTool = {
     name: 'get_graph_impact',
@@ -10,6 +11,7 @@ export const getGraphImpactTool = {
             target: { type: 'string' },
             maxDepth: { type: 'number' },
             limit: { type: 'number' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         required: ['target'],
         additionalProperties: false,
@@ -51,20 +53,19 @@ export const getGraphImpactTool = {
         const closure = reverseClosure(api, anchor.id, maxDepth, limit);
         const direct = closure.layer[1] ?? [];
         const transitive = closure.all.filter((id) => id !== anchor.id && !direct.includes(id));
-        return {
-            data: {
-                schema: 'sharkcraft.graph-impact/v1',
-                anchor: summarise(anchor),
-                maxDepth,
-                limit,
-                truncated: closure.truncated,
-                directDependents: direct.map((id) => summarise(api.neighbours(id).node)),
-                transitiveDependents: transitive
-                    .slice(0, limit)
-                    .map((id) => summarise(api.neighbours(id).node)),
-                totalReached: closure.all.length - 1,
-            },
+        const data = {
+            schema: 'sharkcraft.graph-impact/v1',
+            anchor: summarise(anchor),
+            maxDepth,
+            limit,
+            truncated: closure.truncated,
+            directDependents: direct.map((id) => summarise(api.neighbours(id).node)),
+            transitiveDependents: transitive
+                .slice(0, limit)
+                .map((id) => summarise(api.neighbours(id).node)),
+            totalReached: closure.all.length - 1,
         };
+        return { data: formatObjectArrays(data, input) };
     },
 };
 function resolveAnchor(api, target) {

package/dist/tools/get-graph-search.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-search.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-search.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAWpE,eAAO,MAAM,kBAAkB,EAAE,eA6DhC,CAAC"}
+{"version":3,"file":"get-graph-search.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-search.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAYpE,eAAO,MAAM,kBAAkB,EAAE,eA6DhC,CAAC"}

package/dist/tools/get-graph-search.tool.js

@@ -1,4 +1,5 @@
 import { GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const NEXT = 'shrk graph index';
 export const getGraphSearchTool = {
     name: 'get_graph_search',
@@ -11,6 +12,7 @@ export const getGraphSearchTool = {
             kind: { type: 'string', enum: ['file', 'symbol', 'package'] },
             limit: { type: 'number' },
             exact: { type: 'boolean' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         required: ['query'],
         additionalProperties: false,
@@ -53,15 +55,14 @@ export const getGraphSearchTool = {
             if (p)
                 matches.push(p.node);
         }
-        return {
-            data: {
-                schema: 'sharkcraft.graph-search/v1',
-                query,
-                kind: args.kind ?? 'any',
-                total: Math.min(matches.length, limit),
-                matches: matches.slice(0, limit).map(summarise),
-            },
+        const data = {
+            schema: 'sharkcraft.graph-search/v1',
+            query,
+            kind: args.kind ?? 'any',
+            total: Math.min(matches.length, limit),
+            matches: matches.slice(0, limit).map(summarise),
         };
+        return { data: formatObjectArrays(data, input) };
     },
 };
 function summarise(n) {

package/dist/tools/get-graph-unresolved.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-unresolved.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-unresolved.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AASpE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAsEpC,CAAC"}
+{"version":3,"file":"get-graph-unresolved.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-unresolved.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAyEpC,CAAC"}