@shrkcrft/mcp-server 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/tools/get-task-packet.tool.js

@@ -1,13 +1,15 @@
 import { buildTaskPacket } from '@shrkcrft/inspector';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 export const getTaskPacketTool = {
     name: 'get_task_packet',
-    description: 'Full machine task packet (project overview, detected profiles, recommended pipelines, relevant rules/paths/templates, action hints, recommended CLI/MCP, forbidden actions, verification commands, human-review checkpoints, token-budgeted context body). **Prefer `prepare_agent_task` for first task grounding** — it returns the curated agent bundle plus next-safe-action. Read-only.',
+    description: 'Full machine task packet (project overview, detected profiles, recommended pipelines, relevant rules/paths/templates, action hints, recommended CLI/MCP, forbidden actions, verification commands, human-review checkpoints, token-budgeted context body). Pass `format:"table"` for a token-efficient columnar encoding of the structured lists. **Prefer `prepare_agent_task` for first task grounding** — it returns the curated agent bundle plus next-safe-action. Read-only.',
     inputSchema: {
         type: 'object',
         properties: {
             task: { type: 'string' },
             maxTokens: { type: 'number', minimum: 100, maximum: 20000 },
             scope: { type: 'array', items: { type: 'string' } },
+            ...FORMAT_INPUT_PROPERTY,
         },
         required: ['task'],
         additionalProperties: false,
@@ -22,27 +24,29 @@ export const getTaskPacketTool = {
             maxTokens,
             ...(scope ? { scope } : {}),
         });
-        return {
-            data: {
-                task: packet.task,
-                detectedProfiles: packet.detectedProfiles,
-                recommendedPipelines: packet.recommendedPipelines,
-                presetRecommendations: packet.presetRecommendations.map((r) => ({
-                    presetId: r.preset.id,
-                    confidence: r.confidence,
-                    score: r.score,
-                })),
-                relevantRules: packet.relevantRules.map((r) => ({ id: r.id, title: r.title })),
-                relevantPaths: packet.relevantPaths.map((p) => ({ id: p.id, title: p.title })),
-                relevantTemplates: packet.relevantTemplates.map((t) => ({ id: t.id, name: t.name })),
-                recommendedMcpTools: packet.recommendedMcpTools,
-                recommendedCliCommands: packet.recommendedCliCommands,
-                forbiddenActions: packet.forbiddenActions,
-                verificationCommands: packet.verificationCommands,
-                humanReviewPoints: packet.humanReviewPoints,
-                tokenEstimate: packet.tokenEstimate,
-                context: packet.context,
-            },
+        const data = {
+            task: packet.task,
+            detectedProfiles: packet.detectedProfiles,
+            recommendedPipelines: packet.recommendedPipelines,
+            presetRecommendations: packet.presetRecommendations.map((r) => ({
+                presetId: r.preset.id,
+                confidence: r.confidence,
+                score: r.score,
+            })),
+            relevantRules: packet.relevantRules.map((r) => ({ id: r.id, title: r.title })),
+            relevantPaths: packet.relevantPaths.map((p) => ({ id: p.id, title: p.title })),
+            relevantTemplates: packet.relevantTemplates.map((t) => ({ id: t.id, name: t.name })),
+            recommendedMcpTools: packet.recommendedMcpTools,
+            recommendedCliCommands: packet.recommendedCliCommands,
+            forbiddenActions: packet.forbiddenActions,
+            verificationCommands: packet.verificationCommands,
+            humanReviewPoints: packet.humanReviewPoints,
+            tokenEstimate: packet.tokenEstimate,
+            context: packet.context,
         };
+        // `format:"table"` columnar-encodes the structured object-array fields
+        // (relevantRules/Paths/Templates, presetRecommendations, …); scalars,
+        // string arrays, and the markdown context body are left untouched.
+        return { data: formatObjectArrays(data, input) };
     },
 };

package/dist/tools/graph-staleness.d.ts

@@ -0,0 +1,34 @@
+import { type GraphQueryApi, type INode } from '@shrkcrft/graph';
+/**
+ * A note when a symbol's file language has no call-graph extraction (Go/Python/
+ * Java/…) — only TS/JS build call/reference edges — so an empty caller/usage
+ * result isn't read as "nothing calls it". Returns undefined for TS/JS.
+ */
+export declare function callGraphLanguageNote(api: GraphQueryApi, sym: INode): string | undefined;
+export declare const GRAPH_STALE_HINT = "Result files changed since indexing \u2014 run `shrk graph index --changed` for fresh results.";
+export interface IGraphStaleSurface {
+    /** Result file paths deleted on disk — drop entries whose `path` is in this set. */
+    deletedSet: ReadonlySet<string>;
+    /** Spread into the tool `data` object; null when every result file is fresh. */
+    field: {
+        stale: {
+            modified: readonly string[];
+            deleted: readonly string[];
+        };
+        staleHint: string;
+    } | null;
+}
+/**
+ * Targeted, read-only staleness over a query's result file paths. The graph
+ * MCP tools use it to DROP deleted result files and FLAG modified ones, so a
+ * stale index never silently serves a wrong/dead answer for a file the agent
+ * just edited. Cheap: stats only the handful of result files (mtime+size gate,
+ * sha1 only on mismatch) — never a whole-tree walk.
+ */
+export declare function graphResultStaleness(api: GraphQueryApi, cwd: string, paths: ReadonlyArray<string | undefined>): IGraphStaleSurface;
+/** Filter out result entries whose file path was deleted on disk. */
+export declare function dropDeleted<T extends {
+    id: string;
+    path?: string;
+}>(rows: readonly T[], deletedSet: ReadonlySet<string>): T[];
+//# sourceMappingURL=graph-staleness.d.ts.map

package/dist/tools/graph-staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-staleness.d.ts","sourceRoot":"","sources":["../../src/tools/graph-staleness.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAEzF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAKxF;AAED,eAAO,MAAM,gBAAgB,mGACgE,CAAC;AAE9F,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,gFAAgF;IAChF,KAAK,EACD;QAAE,KAAK,EAAE;YAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;YAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;SAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACzF,IAAI,CAAC;CACV;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,GACvC,kBAAkB,CAUpB;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACjE,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,CAAC,EAAE,CAEL"}

package/dist/tools/graph-staleness.js

@@ -0,0 +1,36 @@
+import { hasCallGraphReferences } from '@shrkcrft/graph';
+/**
+ * A note when a symbol's file language has no call-graph extraction (Go/Python/
+ * Java/…) — only TS/JS build call/reference edges — so an empty caller/usage
+ * result isn't read as "nothing calls it". Returns undefined for TS/JS.
+ */
+export function callGraphLanguageNote(api, sym) {
+    const file = sym.path ? api.findFile(sym.path) : undefined;
+    const lang = file?.data?.['language'];
+    if (hasCallGraphReferences(lang))
+        return undefined;
+    return `Call/reference edges are extracted for TS/JS only — \`${sym.label}\` is in a ${lang} file, so callers/usages are not tracked here (an empty result does NOT mean none).`;
+}
+export const GRAPH_STALE_HINT = 'Result files changed since indexing — run `shrk graph index --changed` for fresh results.';
+/**
+ * Targeted, read-only staleness over a query's result file paths. The graph
+ * MCP tools use it to DROP deleted result files and FLAG modified ones, so a
+ * stale index never silently serves a wrong/dead answer for a file the agent
+ * just edited. Cheap: stats only the handful of result files (mtime+size gate,
+ * sha1 only on mismatch) — never a whole-tree walk.
+ */
+export function graphResultStaleness(api, cwd, paths) {
+    const rel = paths.filter((p) => !!p);
+    const stale = api.staleFilesAmong(cwd, rel);
+    const has = stale.modified.length > 0 || stale.deleted.length > 0;
+    return {
+        deletedSet: new Set(stale.deleted),
+        field: has
+            ? { stale: { modified: stale.modified, deleted: stale.deleted }, staleHint: GRAPH_STALE_HINT }
+            : null,
+    };
+}
+/** Filter out result entries whose file path was deleted on disk. */
+export function dropDeleted(rows, deletedSet) {
+    return rows.filter((r) => !r.path || !deletedSet.has(r.path));
+}

package/dist/tools/list-boundary-rules.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-boundary-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-boundary-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,qBAAqB,EAAE,eAoBnC,CAAC"}
+{"version":3,"file":"list-boundary-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-boundary-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,qBAAqB,EAAE,eAuBnC,CAAC"}

package/dist/tools/list-boundary-rules.tool.js

@@ -1,20 +1,24 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listBoundaryRulesTool = {
     name: 'list_boundary_rules',
-    description: 'List every configured boundary rule (local + pack-contributed). Returns id, title, severity, from/forbidden patterns, source.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        return {
-            data: ctx.inspection.boundaryRegistry.list().map((r) => ({
-                id: r.id,
-                title: r.title,
-                description: r.description,
-                severity: r.severity ?? 'error',
-                from: r.from,
-                forbiddenImports: r.forbiddenImports ?? [],
-                allowedImports: r.allowedImports ?? [],
-                tags: r.tags ?? [],
-                source: ctx.inspection.boundarySources.get(r.id) ?? null,
-            })),
-        };
+    description: 'List every configured boundary rule (local + pack-contributed). Returns id, title, severity, from/forbidden patterns, source. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const rows = ctx.inspection.boundaryRegistry.list().map((r) => ({
+            id: r.id,
+            title: r.title,
+            description: r.description,
+            severity: r.severity ?? 'error',
+            from: r.from,
+            forbiddenImports: r.forbiddenImports ?? [],
+            allowedImports: r.allowedImports ?? [],
+            tags: r.tags ?? [],
+            source: ctx.inspection.boundarySources.get(r.id) ?? null,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-knowledge.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-knowledge.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-knowledge.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,eA8C/B,CAAC"}
+{"version":3,"file":"list-knowledge.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-knowledge.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,iBAAiB,EAAE,eA8C/B,CAAC"}

package/dist/tools/list-knowledge.tool.js

@@ -1,6 +1,7 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listKnowledgeTool = {
     name: 'list_knowledge',
-    description: 'Lists available knowledge entries (id, title, type, tags, scope, priority, appliesWhen). Filterable.',
+    description: 'Lists available knowledge entries (id, title, type, tags, scope, priority, appliesWhen). Filterable. Pass `format:"table"` for a token-efficient columnar payload.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -10,6 +11,7 @@ export const listKnowledgeTool = {
             tags: { type: 'array', items: { type: 'string' } },
             appliesWhen: { type: 'array', items: { type: 'string' } },
             limit: { type: 'integer', minimum: 1 },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -30,17 +32,16 @@ export const listKnowledgeTool = {
             entries = entries.filter((e) => appliesWhen.some((a) => e.appliesWhen.includes(a)));
         }
         entries = entries.slice(0, limit);
-        return {
-            data: entries.map((e) => ({
-                id: e.id,
-                title: e.title,
-                type: e.type,
-                priority: e.priority,
-                scope: e.scope,
-                tags: e.tags,
-                appliesWhen: e.appliesWhen,
-                summary: e.summary,
-            })),
-        };
+        const rows = entries.map((e) => ({
+            id: e.id,
+            title: e.title,
+            type: e.type,
+            priority: e.priority,
+            scope: e.scope,
+            tags: e.tags,
+            appliesWhen: e.appliesWhen,
+            summary: e.summary,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-packs.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-packs.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-packs.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,eAmB3B,CAAC"}
+{"version":3,"file":"list-packs.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-packs.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,aAAa,EAAE,eAsB3B,CAAC"}

package/dist/tools/list-packs.tool.js

@@ -1,19 +1,23 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPacksTool = {
     name: 'list_packs',
-    description: 'List discovered SharkCraft packs (third-party npm packages that ship knowledge / templates / pipelines). Each entry includes both declared file counts and resolved object counts after dedup.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        return {
-            data: ctx.inspection.packs.discoveredPacks.map((p) => ({
-                packageName: p.packageName,
-                packageVersion: p.packageVersion,
-                valid: p.valid,
-                contributionCounts: p.contributionCounts,
-                resolvedCounts: p.resolvedCounts,
-                signatureStatus: p.signatureStatus,
-                signatureMessage: p.signatureMessage,
-                loadError: p.loadError,
-            })),
-        };
+    description: 'List discovered SharkCraft packs (third-party npm packages that ship knowledge / templates / pipelines). Each entry includes both declared file counts and resolved object counts after dedup. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const rows = ctx.inspection.packs.discoveredPacks.map((p) => ({
+            packageName: p.packageName,
+            packageVersion: p.packageVersion,
+            valid: p.valid,
+            contributionCounts: p.contributionCounts,
+            resolvedCounts: p.resolvedCounts,
+            signatureStatus: p.signatureStatus,
+            signatureMessage: p.signatureMessage,
+            loadError: p.loadError,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-path-conventions.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-path-conventions.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-path-conventions.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,uBAAuB,EAAE,eAmBrC,CAAC"}
+{"version":3,"file":"list-path-conventions.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-path-conventions.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,uBAAuB,EAAE,eAsBrC,CAAC"}

package/dist/tools/list-path-conventions.tool.js

@@ -1,20 +1,24 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPathConventionsTool = {
     name: 'list_path_conventions',
-    description: 'List known path conventions.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List known path conventions. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const paths = ctx.inspection.pathService.list();
-        return {
-            data: paths.map((p) => ({
-                id: p.id,
-                title: p.title,
-                path: p.metadata?.path ?? '',
-                priority: p.priority,
-                tags: p.tags,
-                scope: p.scope,
-                appliesWhen: p.appliesWhen,
-                description: p.metadata?.description ?? p.summary,
-            })),
-        };
+        const rows = paths.map((p) => ({
+            id: p.id,
+            title: p.title,
+            path: p.metadata?.path ?? '',
+            priority: p.priority,
+            tags: p.tags,
+            scope: p.scope,
+            appliesWhen: p.appliesWhen,
+            description: p.metadata?.description ?? p.summary,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-pipelines.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-pipelines.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-pipelines.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,eAkB/B,CAAC"}
+{"version":3,"file":"list-pipelines.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-pipelines.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,iBAAiB,EAAE,eAqB/B,CAAC"}

package/dist/tools/list-pipelines.tool.js

@@ -1,19 +1,23 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPipelinesTool = {
     name: 'list_pipelines',
-    description: 'List available SharkCraft AI development pipelines (declarative agent workflows).',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List available SharkCraft AI development pipelines (declarative agent workflows). Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const list = ctx.inspection.pipelineRegistry.list();
-        return {
-            data: list.map((p) => ({
-                id: p.id,
-                title: p.title,
-                description: p.description,
-                tags: p.tags ?? [],
-                scope: p.scope ?? [],
-                appliesWhen: p.appliesWhen ?? [],
-                stepCount: p.steps.length,
-            })),
-        };
+        const rows = list.map((p) => ({
+            id: p.id,
+            title: p.title,
+            description: p.description,
+            tags: p.tags ?? [],
+            scope: p.scope ?? [],
+            appliesWhen: p.appliesWhen ?? [],
+            stepCount: p.steps.length,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-presets.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-presets.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-presets.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,eAAe,EAAE,eA0B7B,CAAC"}
+{"version":3,"file":"list-presets.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-presets.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,eAAe,EAAE,eA6B7B,CAAC"}

package/dist/tools/list-presets.tool.js

@@ -1,26 +1,30 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPresetsTool = {
     name: 'list_presets',
-    description: 'List all SharkCraft presets (built-in + pack-contributed). A preset is a reusable project setup (knowledge / rules / paths / templates / pipelines / docs) that can be applied via the CLI.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List all SharkCraft presets (built-in + pack-contributed). A preset is a reusable project setup (knowledge / rules / paths / templates / pipelines / docs) that can be applied via the CLI. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const presets = ctx.inspection.presetRegistry.list();
-        return {
-            data: presets.map((p) => ({
-                id: p.id,
-                title: p.title,
-                description: p.description,
-                tags: p.tags ?? [],
-                appliesTo: p.appliesTo ?? [],
-                weight: p.weight ?? 5,
-                source: ctx.inspection.presetSources.get(p.id) ?? null,
-                counts: {
-                    knowledge: p.includes.knowledge?.length ?? 0,
-                    rules: p.includes.rules?.length ?? 0,
-                    paths: p.includes.paths?.length ?? 0,
-                    templates: p.includes.templates?.length ?? 0,
-                    pipelines: p.includes.pipelines?.length ?? 0,
-                },
-            })),
-        };
+        const rows = presets.map((p) => ({
+            id: p.id,
+            title: p.title,
+            description: p.description,
+            tags: p.tags ?? [],
+            appliesTo: p.appliesTo ?? [],
+            weight: p.weight ?? 5,
+            source: ctx.inspection.presetSources.get(p.id) ?? null,
+            counts: {
+                knowledge: p.includes.knowledge?.length ?? 0,
+                rules: p.includes.rules?.length ?? 0,
+                paths: p.includes.paths?.length ?? 0,
+                templates: p.includes.templates?.length ?? 0,
+                pipelines: p.includes.pipelines?.length ?? 0,
+            },
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-rules.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,eAkB3B,CAAC"}
+{"version":3,"file":"list-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,aAAa,EAAE,eAqB3B,CAAC"}

package/dist/tools/list-rules.tool.js

@@ -1,19 +1,23 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listRulesTool = {
     name: 'list_rules',
-    description: 'List all rules with compact metadata.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List all rules with compact metadata. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const rules = ctx.inspection.ruleService.list();
-        return {
-            data: rules.map((r) => ({
-                id: r.id,
-                title: r.title,
-                priority: r.priority,
-                tags: r.tags,
-                scope: r.scope,
-                appliesWhen: r.appliesWhen,
-                summary: r.summary,
-            })),
-        };
+        const rows = rules.map((r) => ({
+            id: r.id,
+            title: r.title,
+            priority: r.priority,
+            tags: r.tags,
+            scope: r.scope,
+            appliesWhen: r.appliesWhen,
+            summary: r.summary,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-templates.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-templates.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-templates.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,eAkB/B,CAAC"}
+{"version":3,"file":"list-templates.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-templates.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,iBAAiB,EAAE,eAqB/B,CAAC"}

package/dist/tools/list-templates.tool.js

@@ -1,19 +1,23 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listTemplatesTool = {
     name: 'list_templates',
-    description: 'List available generator templates.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List available generator templates. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const templates = ctx.inspection.templateRegistry.list();
-        return {
-            data: templates.map((t) => ({
-                id: t.id,
-                name: t.name,
-                description: t.description,
-                tags: t.tags,
-                scope: t.scope,
-                appliesWhen: t.appliesWhen,
-                variableCount: t.variables.length,
-            })),
-        };
+        const rows = templates.map((t) => ({
+            id: t.id,
+            name: t.name,
+            description: t.description,
+            tags: t.tags,
+            scope: t.scope,
+            appliesWhen: t.appliesWhen,
+            variableCount: t.variables.length,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/plan-quality-review.tool.d.ts

@@ -0,0 +1,21 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * `plan_quality_review` — score a plan blob for hallucination,
+ * generic boilerplate, contradictions, and ungrounded commands.
+ *
+ * Inputs:
+ *   - `plan`: either a stringified JSON / Markdown plan body, OR a
+ *     `{ from: { slug } }` reference that resolves to a saved
+ *     `.sharkcraft/smart-context/<slug>.plan.json`.
+ *   - `recommendedCommands` (optional): the set of commands that are
+ *     considered "real" (typically `verificationCommands` from the
+ *     same focused bundle). Anything outside this set in
+ *     `firstCommands`/`validationCommands` gets flagged.
+ *
+ * Output: structured findings + an overall verdict so the calling
+ * agent can decide whether to use, retry, or reject the plan.
+ *
+ * Read-only — does not modify or rewrite the plan.
+ */
+export declare const planQualityReviewTool: IToolDefinition;
+//# sourceMappingURL=plan-quality-review.tool.d.ts.map

package/dist/tools/plan-quality-review.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-quality-review.tool.d.ts","sourceRoot":"","sources":["../../src/tools/plan-quality-review.tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAiFnC,CAAC"}