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

package/dist/tools/search.tool.d.ts.map

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

package/dist/tools/search.tool.js

@@ -1,7 +1,8 @@
 import { buildSearchIndex, loadConstructs, loadPlaybooks, searchIndex, SearchKind, SearchSource, } from '@shrkcrft/inspector';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 export const searchAllTool = {
     name: 'search_all',
-    description: 'Unified, deterministic search across knowledge, rules, paths, templates, pipelines, presets, packs, boundaries, docs, sessions, bundles, constructs, and playbooks. No AI / embeddings — pure ranking. Read-only.',
+    description: 'Unified, deterministic search across knowledge, rules, paths, templates, pipelines, presets, packs, boundaries, docs, sessions, bundles, constructs, and playbooks. No AI / embeddings — pure ranking. Pass `format:"table"` for a token-efficient columnar encoding of the `hits` array. Read-only.',
     inputSchema: {
         type: 'object',
         required: ['query'],
@@ -11,6 +12,7 @@ export const searchAllTool = {
             sources: { type: 'array', items: { type: 'string' } },
             limit: { type: 'number' },
             explain: { type: 'boolean' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -33,13 +35,14 @@ export const searchAllTool = {
         if (sources.length > 0)
             opts.sources = sources;
         const result = searchIndex(index, opts);
-        return {
-            data: {
-                query: result.query,
-                total: result.total,
-                truncated: result.truncated,
-                hits: result.hits,
-            },
+        const data = {
+            query: result.query,
+            total: result.total,
+            truncated: result.truncated,
+            hits: result.hits,
         };
+        // `format:"table"` columnar-encodes the homogeneous `hits` array; the
+        // scalar fields (query/total/truncated) pass through untouched.
+        return { data: formatObjectArrays(data, input) };
     },
 };

package/dist/tools/smart-context-bundle.tool.d.ts

@@ -0,0 +1,17 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * `smart_context_bundle` — read-only MCP surface for the focused
+ * context bundle that `shrk smart-context --focused` builds.
+ *
+ * The agent calls this with a task string. The tool runs BGE-based
+ * semantic search, declaration extraction, and re-ranking against
+ * the existing on-disk embedding index, then returns the bundle as
+ * JSON plus a hint pointing at the CLI commands the agent should
+ * run next.
+ *
+ * No writes. No LLM calls. If the index has not been built yet the
+ * tool returns a structured error pointing to
+ * `shrk smart-context embeddings-build`.
+ */
+export declare const smartContextBundleTool: IToolDefinition;
+//# sourceMappingURL=smart-context-bundle.tool.d.ts.map

package/dist/tools/smart-context-bundle.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-context-bundle.tool.d.ts","sourceRoot":"","sources":["../../src/tools/smart-context-bundle.tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAiFpC,CAAC"}

package/dist/tools/smart-context-bundle.tool.js

@@ -0,0 +1,110 @@
+import { buildTaskPacket } from '@shrkcrft/inspector';
+import { SemanticIndex, TaskType, buildFocusedContext, classifyTask, parseTaskTypeOverride, } from '@shrkcrft/embeddings';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
+/**
+ * `smart_context_bundle` — read-only MCP surface for the focused
+ * context bundle that `shrk smart-context --focused` builds.
+ *
+ * The agent calls this with a task string. The tool runs BGE-based
+ * semantic search, declaration extraction, and re-ranking against
+ * the existing on-disk embedding index, then returns the bundle as
+ * JSON plus a hint pointing at the CLI commands the agent should
+ * run next.
+ *
+ * No writes. No LLM calls. If the index has not been built yet the
+ * tool returns a structured error pointing to
+ * `shrk smart-context embeddings-build`.
+ */
+export const smartContextBundleTool = {
+    name: 'smart_context_bundle',
+    description: 'Build a task-focused context bundle (semantic-ranked code blocks + rules + doc hits + validation commands). Read-only.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            task: { type: 'string' },
+            taskType: { type: 'string' },
+            maxBlocks: { type: 'number' },
+            ...FORMAT_INPUT_PROPERTY,
+        },
+        required: ['task'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const task = typeof input['task'] === 'string' ? input['task'].trim() : '';
+        if (task.length === 0) {
+            return {
+                data: {
+                    error: 'task is required',
+                },
+            };
+        }
+        const overrideRaw = typeof input['taskType'] === 'string' ? input['taskType'] : undefined;
+        const taskTypeOverride = parseTaskTypeOverride(overrideRaw);
+        const maxBlocks = typeof input['maxBlocks'] === 'number' ? input['maxBlocks'] : 10;
+        const index = await SemanticIndex.tryLoad(ctx.cwd);
+        if (!index) {
+            return {
+                data: {
+                    error: 'no-semantic-index',
+                    message: 'The semantic index has not been built for this workspace yet. The agent should ask the human to run the CLI command below.',
+                    nextCommand: 'shrk smart-context embeddings-build',
+                },
+            };
+        }
+        const classification = taskTypeOverride
+            ? { type: taskTypeOverride, confidence: 1, signals: ['override'], scores: {} }
+            : classifyTask(task);
+        const packet = buildTaskPacket(ctx.inspection, task, { maxTokens: 3500 });
+        const focused = await buildFocusedContext({
+            cwd: ctx.cwd,
+            task,
+            index,
+            rules: packet.relevantRules,
+            verificationCommands: packet.verificationCommands,
+            maxBlocks: Math.max(2, Math.min(20, maxBlocks)),
+        });
+        return {
+            data: {
+                task,
+                taskType: classification.type,
+                classification: {
+                    type: classification.type,
+                    confidence: classification.confidence,
+                    signals: classification.signals.slice(0, 6),
+                },
+                focused: formatObjectArrays({
+                    model: focused.model,
+                    approxTokens: focused.approxTokens,
+                    files: focused.files,
+                    rules: focused.rules,
+                    docHits: focused.docHits,
+                    verificationCommands: focused.verificationCommands,
+                }, input),
+                nextCommands: nextCommandHints(task, classification.type),
+                notes: [
+                    'This bundle is read-only. To turn the recommended MVP into starter files, the human should run `shrk smart-context "<task>" --focused --plan --save` followed by `shrk spike <slug>`.',
+                ],
+            },
+        };
+    },
+};
+function nextCommandHints(task, taskType) {
+    const quotedTask = JSON.stringify(task);
+    if (taskType === TaskType.Architecture) {
+        return [
+            `shrk smart-context ${quotedTask} --focused --plan --save`,
+            `shrk smart-context list   # find the saved slug`,
+            `shrk spike <slug>          # scaffold the recommended MVP`,
+        ];
+    }
+    if (taskType === TaskType.Investigation) {
+        return [
+            `shrk smart-context ${quotedTask} --focused --save`,
+            `shrk graph why <a> <b>     # trace structural relationships`,
+        ];
+    }
+    return [
+        `shrk smart-context ${quotedTask} --focused --plan --save`,
+        `shrk spike <slug>          # if the plan has a firstSpike`,
+    ];
+}

package/dist/tools/smart-context-feed.tool.d.ts

@@ -0,0 +1,17 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * `smart_context_feed` — read-only MCP surface for an active
+ * `shrk watch` JSONL feed.
+ *
+ * Two modes:
+ *   - `list`  → returns active watch manifests under .sharkcraft/feed/.
+ *   - `tail`  → returns the JSONL tail of one slug, optionally
+ *               filtered by `since` (emittedAt ISO timestamp) or `tailLines`.
+ *
+ * The agent uses `list` first to discover which watcher is running for
+ * which task, then `tail` to pull new packets since the last call.
+ * Nothing is written; the daemon CLI (`shrk watch`) is the only
+ * producer.
+ */
+export declare const smartContextFeedTool: IToolDefinition;
+//# sourceMappingURL=smart-context-feed.tool.d.ts.map

package/dist/tools/smart-context-feed.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-context-feed.tool.d.ts","sourceRoot":"","sources":["../../src/tools/smart-context-feed.tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAKpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,EAAE,eA+BlC,CAAC"}

package/dist/tools/smart-context-feed.tool.js

@@ -0,0 +1,138 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import * as nodePath from 'node:path';
+const FEED_DIR = nodePath.join('.sharkcraft', 'feed');
+const MANIFEST_SCHEMA = 'sharkcraft.shrk-watch-manifest/v1';
+/**
+ * `smart_context_feed` — read-only MCP surface for an active
+ * `shrk watch` JSONL feed.
+ *
+ * Two modes:
+ *   - `list`  → returns active watch manifests under .sharkcraft/feed/.
+ *   - `tail`  → returns the JSONL tail of one slug, optionally
+ *               filtered by `since` (emittedAt ISO timestamp) or `tailLines`.
+ *
+ * The agent uses `list` first to discover which watcher is running for
+ * which task, then `tail` to pull new packets since the last call.
+ * Nothing is written; the daemon CLI (`shrk watch`) is the only
+ * producer.
+ */
+export const smartContextFeedTool = {
+    name: 'smart_context_feed',
+    description: 'Poll the JSONL feed of an active `shrk watch` daemon. Read-only. Use mode="list" to discover slugs and mode="tail" to pull packets.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mode: { type: 'string' },
+            slug: { type: 'string' },
+            since: { type: 'string' },
+            tailLines: { type: 'number' },
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const mode = typeof input['mode'] === 'string' ? input['mode'] : 'list';
+        if (mode !== 'list' && mode !== 'tail') {
+            return { data: { error: 'invalid-mode', valid: ['list', 'tail'] } };
+        }
+        const dir = nodePath.join(ctx.cwd, FEED_DIR);
+        if (mode === 'list') {
+            return { data: listFeeds(dir) };
+        }
+        const slug = typeof input['slug'] === 'string' ? input['slug'].trim() : '';
+        if (slug.length === 0) {
+            return { data: { error: 'slug is required for mode=tail' } };
+        }
+        const since = typeof input['since'] === 'string' ? input['since'] : undefined;
+        const tailLines = typeof input['tailLines'] === 'number' ? input['tailLines'] : 50;
+        return { data: tailFeed(dir, slug, { since, tailLines }) };
+    },
+};
+function listFeeds(dir) {
+    if (!existsSync(dir))
+        return { active: [], stale: [] };
+    const active = [];
+    const stale = [];
+    let entries = [];
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return { active: [], stale: [] };
+    }
+    for (const name of entries) {
+        if (!name.endsWith('.pid.json'))
+            continue;
+        const path = nodePath.join(dir, name);
+        let m;
+        try {
+            m = JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (m.schema !== MANIFEST_SCHEMA || typeof m.pid !== 'number')
+            continue;
+        const summary = {
+            slug: m.slug ?? '',
+            pid: m.pid,
+            task: m.task ?? '',
+            startedAt: m.startedAt ?? '',
+            feedPath: m.feedPath ?? '',
+            alive: isProcessAlive(m.pid),
+            feedExists: m.feedPath ? existsSync(m.feedPath) : false,
+        };
+        (summary.alive ? active : stale).push(summary);
+    }
+    return { active, stale };
+}
+function tailFeed(dir, slug, options) {
+    const feedPath = nodePath.join(dir, `${slug}.jsonl`);
+    if (!existsSync(feedPath)) {
+        return { slug, feedPath, packets: [], totalLines: 0, filteredOut: 0, feedExists: false };
+    }
+    let body;
+    try {
+        body = readFileSync(feedPath, 'utf8');
+    }
+    catch {
+        return { slug, feedPath, packets: [], totalLines: 0, filteredOut: 0, feedExists: true };
+    }
+    const rawLines = body.split('\n').filter((l) => l.trim().length > 0);
+    const packets = [];
+    let filteredOut = 0;
+    for (const line of rawLines) {
+        try {
+            const p = JSON.parse(line);
+            if (options.since) {
+                const emittedAt = typeof p['emittedAt'] === 'string' ? p['emittedAt'] : '';
+                if (emittedAt && emittedAt <= options.since) {
+                    filteredOut += 1;
+                    continue;
+                }
+            }
+            packets.push(p);
+        }
+        catch {
+            filteredOut += 1;
+        }
+    }
+    // Keep only the trailing N once filtered.
+    const tailed = options.tailLines > 0 ? packets.slice(-options.tailLines) : packets;
+    return {
+        slug,
+        feedPath,
+        packets: tailed,
+        totalLines: rawLines.length,
+        filteredOut,
+        feedExists: true,
+    };
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/tools/start-here.tool.js

@@ -1,13 +1,13 @@
 import { buildStartHereReport, buildPrimaryCommandsReport, } from '@shrkcrft/inspector';
 export const getStartHereTool = {
     name: 'get_start_here',
-    description: 'Return the SharkCraft start-here flow list (30-second explanation + 5 primary flows + safety pledge). Read-only.',
+    description: 'Return the SharkCraft start-here flow list (30-second explanation + primary flows incl. "investigate existing code" + safety pledge). Read-only.',
     inputSchema: {
         type: 'object',
         properties: {
             flow: {
                 type: 'string',
-                enum: ['onboard', 'brief', 'dev', 'review', 'governance', 'packs', 'release'],
+                enum: ['onboard', 'investigate', 'brief', 'dev', 'review', 'governance', 'packs', 'release'],
             },
         },
         additionalProperties: false,

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shrkcrft/mcp-server",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.21",
   "description": "SharkCraft MCP server: 25 tools over @modelcontextprotocol/sdk's stdio transport.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -44,20 +44,32 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.2",
-    "@shrkcrft/config": "^0.1.0-alpha.2",
-    "@shrkcrft/workspace": "^0.1.0-alpha.2",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.2",
-    "@shrkcrft/context": "^0.1.0-alpha.2",
-    "@shrkcrft/rules": "^0.1.0-alpha.2",
-    "@shrkcrft/paths": "^0.1.0-alpha.2",
-    "@shrkcrft/templates": "^0.1.0-alpha.2",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.2",
-    "@shrkcrft/presets": "^0.1.0-alpha.2",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.2",
-    "@shrkcrft/packs": "^0.1.0-alpha.2",
-    "@shrkcrft/generator": "^0.1.0-alpha.2",
-    "@shrkcrft/inspector": "^0.1.0-alpha.2",
+    "@shrkcrft/core": "^0.1.0-alpha.21",
+    "@shrkcrft/compress": "^0.1.0-alpha.21",
+    "@shrkcrft/config": "^0.1.0-alpha.21",
+    "@shrkcrft/workspace": "^0.1.0-alpha.21",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.21",
+    "@shrkcrft/context": "^0.1.0-alpha.21",
+    "@shrkcrft/rules": "^0.1.0-alpha.21",
+    "@shrkcrft/paths": "^0.1.0-alpha.21",
+    "@shrkcrft/templates": "^0.1.0-alpha.21",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.21",
+    "@shrkcrft/presets": "^0.1.0-alpha.21",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.21",
+    "@shrkcrft/graph": "^0.1.0-alpha.21",
+    "@shrkcrft/rule-graph": "^0.1.0-alpha.21",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.21",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.21",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.21",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.21",
+    "@shrkcrft/framework-scanners": "^0.1.0-alpha.21",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.21",
+    "@shrkcrft/quality-gates": "^0.1.0-alpha.21",
+    "@shrkcrft/migrate": "^0.1.0-alpha.21",
+    "@shrkcrft/packs": "^0.1.0-alpha.21",
+    "@shrkcrft/generator": "^0.1.0-alpha.21",
+    "@shrkcrft/inspector": "^0.1.0-alpha.21",
+    "@shrkcrft/embeddings": "^0.1.0-alpha.21",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.25.0 || ^4.0.0"
   },

package/dist/tools/r22-extras.tool.d.ts

@@ -1,4 +0,0 @@
-import type { IToolDefinition } from '../server/tool-definition.js';
-export declare const getMigrationReadinessTool: IToolDefinition;
-export declare const listMigrationProfilesTool: IToolDefinition;
-//# sourceMappingURL=r22-extras.tool.d.ts.map

package/dist/tools/r22-extras.tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"r22-extras.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r22-extras.tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,yBAAyB,EAAE,eAuBvC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,eAevC,CAAC"}

package/dist/tools/r22-extras.tool.js

@@ -1,42 +0,0 @@
-/**
- * Migration / readiness MCP tools. All read-only.
- */
-import { buildMigrationReadiness, listMigrationProfiles, listMigrationProfilesFromPacks, } from '@shrkcrft/inspector';
-export const getMigrationReadinessTool = {
-    name: 'get_migration_readiness',
-    description: 'Migration readiness verdict for a profile id. Read-only — probes local files and env vars; never runs source.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            profileId: { type: 'string' },
-        },
-        required: ['profileId'],
-        additionalProperties: false,
-    },
-    async handler(input, ctx) {
-        const profileId = typeof input['profileId'] === 'string' ? input['profileId'] : '';
-        const packProfiles = await listMigrationProfilesFromPacks(ctx.inspection);
-        const report = buildMigrationReadiness({
-            profileId,
-            projectRoot: ctx.inspection.projectRoot,
-            customProfiles: packProfiles,
-        });
-        return { data: report };
-    },
-};
-export const listMigrationProfilesTool = {
-    name: 'list_migration_profiles',
-    description: 'List registered migration profiles (built-in + pack-contributed). Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        const packProfiles = await listMigrationProfilesFromPacks(ctx.inspection);
-        const profiles = listMigrationProfiles(packProfiles).map((p) => ({
-            id: p.id,
-            title: p.title,
-            description: p.description,
-            successVerdict: p.successVerdict,
-            checks: p.checks.length,
-        }));
-        return { data: profiles };
-    },
-};

package/dist/tools/r26-ingest.tool.d.ts

@@ -1,10 +0,0 @@
-import type { IToolDefinition } from '../server/tool-definition.js';
-export declare const createRepositoryIngestionPlanTool: IToolDefinition;
-export declare const getRepositoryKnowledgeModelTool: IToolDefinition;
-export declare const getRepositoryIngestionStatusTool: IToolDefinition;
-export declare const getRepositoryIngestionReportTool: IToolDefinition;
-export declare const getContradictionReportTool: IToolDefinition;
-export declare const getGeneratedCodeReportTool: IToolDefinition;
-export declare const getStabilityMapTool: IToolDefinition;
-export declare const getIngestAdoptionPreviewTool: IToolDefinition;
-//# sourceMappingURL=r26-ingest.tool.d.ts.map

package/dist/tools/r26-ingest.tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"r26-ingest.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r26-ingest.tool.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAyBpE,eAAO,MAAM,iCAAiC,EAAE,eA4B/C,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,eAyB7C,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,eAiB9C,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,eAiB9C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eAWxC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eAWxC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAejC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,eAY1C,CAAC"}

package/dist/tools/r26-ingest.tool.js

@@ -1,174 +0,0 @@
-import * as nodePath from 'node:path';
-import { existsSync, readFileSync } from 'node:fs';
-import { buildContradictionReport, buildGeneratedCodeReport, buildIngestAdoptionPlan, buildRepositoryKnowledgeModel, buildStabilityMap, IngestDepth, IngestSection, } from '@shrkcrft/inspector';
-function nextHint(cmd) {
-    return `Next: \`${cmd}\` (CLI is the only write path).`;
-}
-function parseDepth(raw) {
-    if (typeof raw !== 'string')
-        return IngestDepth.Standard;
-    const lower = raw.toLowerCase();
-    for (const d of Object.values(IngestDepth))
-        if (d === lower)
-            return d;
-    return IngestDepth.Standard;
-}
-function parseSections(raw) {
-    if (!Array.isArray(raw))
-        return undefined;
-    const out = [];
-    for (const s of raw) {
-        if (typeof s !== 'string')
-            continue;
-        for (const v of Object.values(IngestSection)) {
-            if (v === s)
-                out.push(v);
-        }
-    }
-    return out.length > 0 ? out : undefined;
-}
-export const createRepositoryIngestionPlanTool = {
-    name: 'create_repository_ingestion_plan',
-    description: 'Build a SharkCraft repository knowledge model (read-only). Returns the model + a next-command hint. MCP never writes; pass --write-drafts to the CLI to materialise drafts under sharkcraft/ingestion/.',
-    inputSchema: {
-        type: 'object',
-        additionalProperties: false,
-        properties: {
-            depth: { type: 'string' },
-            include: { type: 'array', items: { type: 'string' } },
-            exclude: { type: 'array', items: { type: 'string' } },
-            presets: { type: 'array', items: { type: 'string' } },
-            task: { type: 'string' },
-        },
-    },
-    async handler(input, ctx) {
-        const model = await buildRepositoryKnowledgeModel({
-            inspection: ctx.inspection,
-            depth: parseDepth(input.depth),
-            selectedSections: parseSections(input.include),
-            excludedSections: parseSections(input.exclude),
-            forcedPresetIds: Array.isArray(input.presets) ? input.presets.filter((p) => typeof p === 'string') : undefined,
-            ...(typeof input.task === 'string' ? { task: input.task } : {}),
-        });
-        return {
-            text: nextHint('shrk ingest repository --write-drafts'),
-            data: model,
-        };
-    },
-};
-export const getRepositoryKnowledgeModelTool = {
-    name: 'get_repository_knowledge_model',
-    description: 'Return the previously-saved repository knowledge model (`sharkcraft/ingestion/repository-knowledge-model.json`). Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    handler(_input, ctx) {
-        const file = nodePath.join(ctx.cwd, 'sharkcraft', 'ingestion', 'repository-knowledge-model.json');
-        if (!existsSync(file)) {
-            return {
-                isError: true,
-                error: { code: 'not-found', message: 'No saved knowledge model. Run `shrk ingest repository --write-drafts` first.' },
-            };
-        }
-        try {
-            const body = JSON.parse(readFileSync(file, 'utf8'));
-            return {
-                text: nextHint('shrk ingest report --format markdown'),
-                data: body,
-            };
-        }
-        catch (err) {
-            return {
-                isError: true,
-                error: { code: 'parse-failed', message: err.message },
-            };
-        }
-    },
-};
-export const getRepositoryIngestionStatusTool = {
-    name: 'get_repository_ingestion_status',
-    description: 'Report whether ingest drafts/adoption files exist on disk. Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    handler(_input, ctx) {
-        const base = nodePath.join(ctx.cwd, 'sharkcraft', 'ingestion');
-        const modelExists = existsSync(nodePath.join(base, 'repository-knowledge-model.json'));
-        const adoptionExists = existsSync(nodePath.join(base, 'adoption', 'ingest-adoption-state.json'));
-        return {
-            text: nextHint('shrk ingest status'),
-            data: {
-                ingestDirExists: existsSync(base),
-                modelExists,
-                adoptionExists,
-            },
-        };
-    },
-};
-export const getRepositoryIngestionReportTool = {
-    name: 'get_repository_ingestion_report',
-    description: 'Return a markdown summary of the saved repository knowledge model. Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        const file = nodePath.join(ctx.cwd, 'sharkcraft', 'ingestion', 'REPOSITORY_KNOWLEDGE_MODEL.md');
-        if (!existsSync(file)) {
-            return {
-                isError: true,
-                error: { code: 'not-found', message: 'No saved report — run `shrk ingest repository --write-drafts` first.' },
-            };
-        }
-        return {
-            text: nextHint('shrk ingest report --format markdown'),
-            data: { markdown: readFileSync(file, 'utf8') },
-        };
-    },
-};
-export const getContradictionReportTool = {
-    name: 'get_contradiction_report',
-    description: 'Detect documentation/code contradictions (missing paths, deprecated CLI usage, missing commands). Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        const report = buildContradictionReport({ inspection: ctx.inspection });
-        return {
-            text: nextHint('shrk contradictions --format markdown'),
-            data: report,
-        };
-    },
-};
-export const getGeneratedCodeReportTool = {
-    name: 'get_generated_code_report',
-    description: 'Classify generated vs hand-written files; surface protect/policy recommendations. Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        const report = buildGeneratedCodeReport({ inspection: ctx.inspection });
-        return {
-            text: nextHint('shrk generated report --format markdown'),
-            data: report,
-        };
-    },
-};
-export const getStabilityMapTool = {
-    name: 'get_stability_map',
-    description: 'Classify repo areas as stable/experimental/deprecated/legacy/generated/internal/public-api/high-risk. Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        const generated = buildGeneratedCodeReport({ inspection: ctx.inspection });
-        const map = buildStabilityMap({
-            inspection: ctx.inspection,
-            generatedRoots: generated.generatedRoots.map((r) => r.path),
-        });
-        return {
-            text: nextHint('shrk stability map --format markdown'),
-            data: map,
-        };
-    },
-};
-export const getIngestAdoptionPreviewTool = {
-    name: 'get_ingest_adoption_preview',
-    description: 'Preview the ingest-adoption plan (safe-append / manual-review / low-confidence / already-covered / generated-protected). Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        const model = await buildRepositoryKnowledgeModel({ inspection: ctx.inspection });
-        const plan = buildIngestAdoptionPlan({ model });
-        return {
-            text: nextHint('shrk ingest adopt --write-patch'),
-            data: plan,
-        };
-    },
-};

package/dist/tools/r28-plugin-lifecycle.tool.d.ts

@@ -1,4 +0,0 @@
-import type { IToolDefinition } from '../server/tool-definition.js';
-export declare const previewPluginRenameTool: IToolDefinition;
-export declare const previewPluginRemoveTool: IToolDefinition;
-//# sourceMappingURL=r28-plugin-lifecycle.tool.d.ts.map