@shrkcrft/mcp-server 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/tools/get-quality-gate.tool.js

@@ -0,0 +1,27 @@
+import { runQualityGates } from '@shrkcrft/quality-gates';
+export const getQualityGateTool = {
+    name: 'get_quality_gate',
+    description: 'Read-only: run the code-intelligence quality-gate aggregator (graph freshness, architecture, impact since `main`) and return the unified pass/fail report. The CI / pre-merge hook for AI-agent-authored changes.',
+    cliCommand: 'gate',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            sinceRef: { type: 'string' },
+            failOn: { type: 'array', items: { type: 'string', enum: ['high', 'critical'] } },
+            disable: { type: 'array', items: { type: 'string' } },
+        },
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const report = runQualityGates({
+            projectRoot: ctx.inspection.projectRoot,
+            impact: {
+                ...(args.sinceRef ? { sinceRef: args.sinceRef } : {}),
+                ...(args.failOn ? { failOn: args.failOn } : {}),
+            },
+            ...(args.disable ? { disable: args.disable } : {}),
+        });
+        return { data: report };
+    },
+};

package/dist/tools/get-rules-for-file.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getRulesForFileTool: IToolDefinition;
+//# sourceMappingURL=get-rules-for-file.tool.d.ts.map

package/dist/tools/get-rules-for-file.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-rules-for-file.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-rules-for-file.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,mBAAmB,EAAE,eAqDjC,CAAC"}

package/dist/tools/get-rules-for-file.tool.js

@@ -0,0 +1,54 @@
+import { RuleGraphQueryApi } from '@shrkcrft/rule-graph';
+export const getRulesForFileTool = {
+    name: 'get_rules_for_file',
+    description: 'Read-only bridge query: return rules (boundary), path conventions, and templates that apply to the given file. Requires `shrk graph index` + `shrk rule-graph index`.',
+    cliCommand: 'rule-graph for',
+    inputSchema: {
+        type: 'object',
+        properties: { file: { type: 'string' } },
+        required: ['file'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const file = (input.file ?? '').trim();
+        if (!file) {
+            return {
+                isError: true,
+                error: { code: 'invalid-input', message: 'file is required' },
+            };
+        }
+        const missing = RuleGraphQueryApi.missingDescription(ctx.inspection.projectRoot);
+        if (missing) {
+            const next = missing.includes('rule-graph') ? 'shrk rule-graph index' : 'shrk graph index';
+            return {
+                isError: true,
+                error: {
+                    code: 'bridge-missing',
+                    message: missing,
+                    details: { nextCommand: next },
+                },
+            };
+        }
+        const api = RuleGraphQueryApi.fromStores(ctx.inspection.projectRoot);
+        const r = api.forFile(file);
+        if (!r) {
+            return {
+                isError: true,
+                error: { code: 'not-found', message: `No file node for "${file}".`, details: { file } },
+            };
+        }
+        return {
+            data: {
+                schema: 'sharkcraft.rule-graph-for-file/v1',
+                file: r.path,
+                rules: r.rules.map((h) => ({
+                    id: h.target.id,
+                    label: h.target.label,
+                    severity: h.edge.data?.['severity'] ?? undefined,
+                })),
+                paths: r.paths.map((h) => ({ id: h.target.id, label: h.target.label })),
+                templates: r.templates.map((h) => ({ id: h.target.id, label: h.target.label })),
+            },
+        };
+    },
+};

package/dist/tools/get-structural-rewrite-plan.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getStructuralRewritePlanTool: IToolDefinition;
+//# sourceMappingURL=get-structural-rewrite-plan.tool.d.ts.map

package/dist/tools/get-structural-rewrite-plan.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-structural-rewrite-plan.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-structural-rewrite-plan.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE,eAAO,MAAM,4BAA4B,EAAE,eA0C1C,CAAC"}

package/dist/tools/get-structural-rewrite-plan.tool.js

@@ -0,0 +1,46 @@
+import { planRewrite } from '@shrkcrft/structural-search';
+export const getStructuralRewritePlanTool = {
+    // Tool name intentionally uses "codemod" rather than "rewrite" — the
+    // CLI ceremony tests forbid any MCP tool name containing the
+    // substring "write" so a future read of the catalog can't mistake a
+    // preview tool for a write surface. The plan is still read-only
+    // here; apply ceremony happens via `shrk search-structural ... --apply`.
+    name: 'get_structural_codemod_plan',
+    description: 'Preview a structural codemod as a per-file edit plan (`sharkcraft.structural-rewrite-plan/v1`). Read-only — apply ceremony stays on the CLI (`shrk search-structural ... --apply`). Useful for "what would this codemod do?" without touching disk.',
+    cliCommand: 'search-structural',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pattern: { type: 'object' },
+            recipe: { type: 'object' },
+            files: { type: 'array', items: { type: 'string' } },
+            perFileLimit: { type: 'number' },
+            fileLimit: { type: 'number' },
+        },
+        required: ['pattern', 'recipe'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const pattern = args.pattern;
+        const recipe = args.recipe;
+        if (!pattern || typeof pattern !== 'object' || !pattern.kind) {
+            return { isError: true, error: { code: 'invalid-input', message: 'pattern.kind is required' } };
+        }
+        if (!recipe || typeof recipe !== 'object' || !recipe.kind) {
+            return { isError: true, error: { code: 'invalid-input', message: 'recipe.kind is required' } };
+        }
+        const plan = planRewrite({
+            projectRoot: ctx.inspection.projectRoot,
+            pattern,
+            recipe,
+            ...(args.files ? { files: args.files } : {}),
+            ...(typeof args.perFileLimit === 'number' ? { perFileLimit: clamp(args.perFileLimit, 1, 1000) } : {}),
+            ...(typeof args.fileLimit === 'number' ? { fileLimit: clamp(args.fileLimit, 1, 50000) } : {}),
+        });
+        return { data: plan };
+    },
+};
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}

package/dist/tools/get-structural-search.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getStructuralSearchTool: IToolDefinition;
+//# sourceMappingURL=get-structural-search.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-structural-search.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-structural-search.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAOpE,eAAO,MAAM,uBAAuB,EAAE,eA+BrC,CAAC"}

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

@@ -0,0 +1,35 @@
+import { runSearch } from '@shrkcrft/structural-search';
+export const getStructuralSearchTool = {
+    name: 'get_structural_search',
+    description: 'Run a declarative AST pattern over the project and return matches. Patterns are JSON of shape `{ kind: "CallExpression" | "ImportDeclaration" | "ClassDeclaration" | ..., ... }`. No executable predicates, no rewrites. Read-only.',
+    cliCommand: 'search-structural',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pattern: { type: 'object' },
+            limit: { type: 'number' },
+        },
+        required: ['pattern'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const pat = args.pattern;
+        if (!pat || typeof pat !== 'object' || !pat.kind) {
+            return {
+                isError: true,
+                error: { code: 'invalid-input', message: 'pattern.kind is required' },
+            };
+        }
+        const limit = clamp(args.limit ?? 200, 1, 2000);
+        const result = runSearch({
+            projectRoot: ctx.inspection.projectRoot,
+            pattern: pat,
+            limit,
+        });
+        return { data: result };
+    },
+};
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}

package/dist/tools/primary-tools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Primary MCP tools — the ~30 tools advertised to a connected agent
+ * by default. Every tool in {@link ALL_TOOLS} stays callable (so an
+ * agent that already knows the name can use it), but `tools/list`
+ * only advertises the primary set. Smaller surface = better
+ * tool-selection accuracy for the agent.
+ *
+ * Picked to match the CLI's allowlist semantics: anything an agent
+ * could realistically reach for during a normal task — discovery,
+ * context, planning, validation — is in. Internal introspection
+ * (catalog dumps, fix-preview internals, drift baselines) is out;
+ * still callable, just not in the default tool list.
+ *
+ * Escape hatch: set `SHRK_MCP_FULL_TOOLS=1` to advertise the full
+ * catalog (useful when debugging an agent's tool selection).
+ */
+export declare const PRIMARY_MCP_TOOLS: ReadonlySet<string>;
+/**
+ * Should `tools/list` advertise the full catalog instead of the
+ * primary set? Driven by the env var so an agent operator can flip it
+ * without rebuilding.
+ */
+export declare function shouldAdvertiseFullToolset(): boolean;
+//# sourceMappingURL=primary-tools.d.ts.map

package/dist/tools/primary-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primary-tools.d.ts","sourceRoot":"","sources":["../../src/tools/primary-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CA4ChD,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAGpD"}

package/dist/tools/primary-tools.js

@@ -0,0 +1,70 @@
+/**
+ * Primary MCP tools — the ~30 tools advertised to a connected agent
+ * by default. Every tool in {@link ALL_TOOLS} stays callable (so an
+ * agent that already knows the name can use it), but `tools/list`
+ * only advertises the primary set. Smaller surface = better
+ * tool-selection accuracy for the agent.
+ *
+ * Picked to match the CLI's allowlist semantics: anything an agent
+ * could realistically reach for during a normal task — discovery,
+ * context, planning, validation — is in. Internal introspection
+ * (catalog dumps, fix-preview internals, drift baselines) is out;
+ * still callable, just not in the default tool list.
+ *
+ * Escape hatch: set `SHRK_MCP_FULL_TOOLS=1` to advertise the full
+ * catalog (useful when debugging an agent's tool selection).
+ */
+export const PRIMARY_MCP_TOOLS = new Set([
+    // Project orientation
+    'inspect_workspace',
+    'get_project_overview',
+    'get_agent_instructions',
+    'get_start_here',
+    // Context / task routing
+    'get_relevant_context',
+    'get_task_packet',
+    'get_action_hints',
+    'create_agent_brief',
+    'get_relevant_rules',
+    'explain_command',
+    // Browse the registries
+    'list_knowledge',
+    'get_knowledge',
+    'list_rules',
+    'get_rule',
+    'list_path_conventions',
+    'list_templates',
+    'get_template',
+    'list_pipelines',
+    'get_pipeline',
+    'list_presets',
+    'get_preset',
+    'list_packs',
+    'get_pack',
+    // Safe code generation (plan-first)
+    'create_generation_plan',
+    'render_template_preview',
+    'explain_generation_target',
+    // Validation gates (read-only)
+    'check_boundaries',
+    'get_diff_check_report',
+    'get_file_advice',
+    'get_architecture_constraints',
+    'get_architecture_violations',
+    // Doctor / readiness
+    'get_ai_readiness_report',
+    'doctor_packs',
+    // Search
+    'search_all',
+    'search_knowledge',
+    'search_commands',
+]);
+/**
+ * Should `tools/list` advertise the full catalog instead of the
+ * primary set? Driven by the env var so an agent operator can flip it
+ * without rebuilding.
+ */
+export function shouldAdvertiseFullToolset() {
+    const v = process.env.SHRK_MCP_FULL_TOOLS;
+    return v === '1' || v === 'true' || v === 'yes';
+}

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

@@ -93,7 +93,7 @@ export const getCommandTaxonomyTool = {
     inputSchema: { type: 'object', properties: {}, additionalProperties: false },
     async handler() {
         // The CLI carries the canonical catalog; here we describe the surface
-        // without importing it (no inspector → CLI dependency). Adopters can
+        // without importing it (no inspector → CLI dependency). Consumers can
         // run `shrk commands taxonomy` for the full grouped output.
         return {
             data: {

package/dist/tools/r32-profiles.tool.d.ts

@@ -2,7 +2,4 @@ import type { IToolDefinition } from '../server/tool-definition.js';
 export declare const listProfilesTool: IToolDefinition;
 export declare const getProfileTool: IToolDefinition;
 export declare const getProfilesDoctorTool: IToolDefinition;
-export declare const listPluginLifecycleProfilesTool: IToolDefinition;
-export declare const getPluginLifecycleProfileTool: IToolDefinition;
-export declare const getPluginLifecycleProfileDoctorTool: IToolDefinition;
 //# sourceMappingURL=r32-profiles.tool.d.ts.map

package/dist/tools/r32-profiles.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"r32-profiles.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r32-profiles.tool.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,gBAAgB,EAAE,eAe9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAsB5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eAOnC,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,eAO7C,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,eAmB3C,CAAC;AAEF,eAAO,MAAM,mCAAmC,EAAE,eAqBjD,CAAC"}
+{"version":3,"file":"r32-profiles.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r32-profiles.tool.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,gBAAgB,EAAE,eAe9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAsB5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eAOnC,CAAC"}

package/dist/tools/r32-profiles.tool.js

@@ -1,11 +1,11 @@
 /**
- * Read-only MCP tools for profiles + lifecycle profiles.
+ * Read-only MCP tools for profiles.
  *
  * Engine never writes from MCP. These tools surface pack-contributed and
  * locally configured profiles so an agent can decide which one to pass to
- * `shrk plugin rename|remove --profile <id>` (the human runs the CLI).
+ * a profile-aware command (the human runs the CLI).
  */
-import { checkPluginLifecycleProfileHealth, findProfile, listProfileIssues, listProfiles, listPluginLifecycleProfiles, ProfileKind, } from '@shrkcrft/inspector';
+import { findProfile, listProfileIssues, listProfiles, ProfileKind, } from '@shrkcrft/inspector';
 export const listProfilesTool = {
     name: 'list_profiles',
     description: 'List all pack-contributed and locally configured profiles. Read-only.',
@@ -54,54 +54,3 @@ export const getProfilesDoctorTool = {
         return { data: { issues: await listProfileIssues(ctx.inspection) } };
     },
 };
-export const listPluginLifecycleProfilesTool = {
-    name: 'list_plugin_lifecycle_profiles',
-    description: 'List registered plugin lifecycle profiles. Read-only.',
-    inputSchema: { type: 'object', additionalProperties: false, properties: {} },
-    async handler(_input, ctx) {
-        return { data: await listPluginLifecycleProfiles(ctx.inspection) };
-    },
-};
-export const getPluginLifecycleProfileTool = {
-    name: 'get_plugin_lifecycle_profile',
-    description: 'Get one plugin lifecycle profile by id. Read-only.',
-    inputSchema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['id'],
-        properties: { id: { type: 'string' } },
-    },
-    async handler(input, ctx) {
-        const id = typeof input.id === 'string' ? input.id : '';
-        if (!id)
-            return { isError: true, error: { code: 'invalid-input', message: 'id is required.' } };
-        const entries = await listPluginLifecycleProfiles(ctx.inspection);
-        const entry = entries.find((e) => e.profile.id === id);
-        if (!entry) {
-            return { isError: true, error: { code: 'not-found', message: `Unknown lifecycle profile "${id}".` } };
-        }
-        return { data: entry };
-    },
-};
-export const getPluginLifecycleProfileDoctorTool = {
-    name: 'get_plugin_lifecycle_profile_doctor',
-    description: 'Health check for plugin lifecycle profiles. Read-only.',
-    inputSchema: {
-        type: 'object',
-        additionalProperties: false,
-        properties: { id: { type: 'string' } },
-    },
-    async handler(input, ctx) {
-        const id = typeof input.id === 'string' ? input.id : undefined;
-        const entries = await listPluginLifecycleProfiles(ctx.inspection);
-        const targets = id ? entries.filter((e) => e.profile.id === id) : entries;
-        if (id && targets.length === 0) {
-            return { isError: true, error: { code: 'not-found', message: `Unknown lifecycle profile "${id}".` } };
-        }
-        const health = {};
-        for (const e of targets) {
-            health[e.profile.id] = checkPluginLifecycleProfileHealth(ctx.cwd, e.profile);
-        }
-        return { data: { health } };
-    },
-};

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@shrkcrft/mcp-server",
-  "version": "0.1.0-alpha.1",
-  "description": "SharkCraft MCP server: read-only @modelcontextprotocol/sdk tools (stdio + streamable-HTTP) for AI coding agents.",
+  "version": "0.1.0-alpha.10",
+  "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.ts",
+  "types": "./dist/index.d.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
@@ -21,12 +22,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sharkcraft/sharkcraft.git",
+    "url": "git+https://github.com/shrkcrft/sharkcraft.git",
     "directory": "packages/mcp-server"
   },
-  "homepage": "https://github.com/sharkcraft/sharkcraft",
+  "homepage": "https://github.com/shrkcrft/sharkcraft",
   "bugs": {
-    "url": "https://github.com/sharkcraft/sharkcraft/issues"
+    "url": "https://github.com/shrkcrft/sharkcraft/issues"
   },
   "keywords": [
     "sharkcraft",
@@ -43,20 +44,30 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.1",
-    "@shrkcrft/config": "^0.1.0-alpha.1",
-    "@shrkcrft/workspace": "^0.1.0-alpha.1",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.1",
-    "@shrkcrft/context": "^0.1.0-alpha.1",
-    "@shrkcrft/rules": "^0.1.0-alpha.1",
-    "@shrkcrft/paths": "^0.1.0-alpha.1",
-    "@shrkcrft/templates": "^0.1.0-alpha.1",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.1",
-    "@shrkcrft/presets": "^0.1.0-alpha.1",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.1",
-    "@shrkcrft/packs": "^0.1.0-alpha.1",
-    "@shrkcrft/generator": "^0.1.0-alpha.1",
-    "@shrkcrft/inspector": "^0.1.0-alpha.1",
+    "@shrkcrft/core": "^0.1.0-alpha.10",
+    "@shrkcrft/config": "^0.1.0-alpha.10",
+    "@shrkcrft/workspace": "^0.1.0-alpha.10",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.10",
+    "@shrkcrft/context": "^0.1.0-alpha.10",
+    "@shrkcrft/rules": "^0.1.0-alpha.10",
+    "@shrkcrft/paths": "^0.1.0-alpha.10",
+    "@shrkcrft/templates": "^0.1.0-alpha.10",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.10",
+    "@shrkcrft/presets": "^0.1.0-alpha.10",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.10",
+    "@shrkcrft/graph": "^0.1.0-alpha.10",
+    "@shrkcrft/rule-graph": "^0.1.0-alpha.10",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.10",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.10",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.10",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.10",
+    "@shrkcrft/framework-scanners": "^0.1.0-alpha.10",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.10",
+    "@shrkcrft/quality-gates": "^0.1.0-alpha.10",
+    "@shrkcrft/migrate": "^0.1.0-alpha.10",
+    "@shrkcrft/packs": "^0.1.0-alpha.10",
+    "@shrkcrft/generator": "^0.1.0-alpha.10",
+    "@shrkcrft/inspector": "^0.1.0-alpha.10",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.25.0 || ^4.0.0"
   },

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"r28-plugin-lifecycle.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r28-plugin-lifecycle.tool.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,uBAAuB,EAAE,eA0CrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAuCrC,CAAC"}

package/dist/tools/r28-plugin-lifecycle.tool.js

@@ -1,94 +0,0 @@
-/**
- * Plan-only plugin lifecycle previews (profile-driven).
- *
- *  preview_plugin_rename — returns the rename plan (replace ops + manual steps).
- *  preview_plugin_remove — returns the destructive remove plan.
- *
- *  Both tools never write source — the human runs `shrk plugin rename|remove`
- *  to produce the saved plan and applies it via `shrk apply --verify-signature`.
- *
- *  A `profile` input is required. If exactly one lifecycle profile is
- *  registered, the tool implicitly uses it; otherwise the caller must supply
- *  `profile`.
- */
-import { buildPluginRemovePlan, buildPluginRenamePlan, resolvePluginLifecycleProfile, } from '@shrkcrft/inspector';
-function nextHint(cmd) {
-    return `Next: \`${cmd}\` (CLI is the only write path).`;
-}
-export const previewPluginRenameTool = {
-    name: 'preview_plugin_rename',
-    description: 'Preview a plugin rename plan. Read-only — returns the structured plan only. Requires a registered plugin lifecycle profile (pass `profile` if more than one is registered).',
-    inputSchema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['oldName', 'newName'],
-        properties: {
-            oldName: { type: 'string' },
-            newName: { type: 'string' },
-            profile: { type: 'string' },
-        },
-    },
-    async handler(input, ctx) {
-        const oldName = String(input.oldName ?? '');
-        const newName = String(input.newName ?? '');
-        const profileId = typeof input.profile === 'string' ? input.profile : undefined;
-        const resolved = await resolvePluginLifecycleProfile(ctx.inspection, {
-            profileId,
-            allowSingleDefault: true,
-        });
-        if (!resolved.entry) {
-            return {
-                isError: true,
-                error: { code: 'profile-required', message: resolved.error ?? 'Profile resolution failed' },
-                data: { availableProfiles: resolved.availableIds },
-            };
-        }
-        const plan = buildPluginRenamePlan({
-            projectRoot: ctx.cwd,
-            profile: resolved.entry.profile,
-            oldName,
-            newName,
-        });
-        return {
-            text: nextHint(`shrk plugin rename ${oldName} ${newName} --profile ${resolved.entry.profile.id} --output /tmp/plan.json`),
-            data: plan,
-        };
-    },
-};
-export const previewPluginRemoveTool = {
-    name: 'preview_plugin_remove',
-    description: 'Preview a destructive plugin remove plan. Read-only — returns the structured plan only. Requires a registered plugin lifecycle profile (pass `profile` if more than one is registered).',
-    inputSchema: {
-        type: 'object',
-        additionalProperties: false,
-        required: ['name'],
-        properties: {
-            name: { type: 'string' },
-            profile: { type: 'string' },
-        },
-    },
-    async handler(input, ctx) {
-        const name = String(input.name ?? '');
-        const profileId = typeof input.profile === 'string' ? input.profile : undefined;
-        const resolved = await resolvePluginLifecycleProfile(ctx.inspection, {
-            profileId,
-            allowSingleDefault: true,
-        });
-        if (!resolved.entry) {
-            return {
-                isError: true,
-                error: { code: 'profile-required', message: resolved.error ?? 'Profile resolution failed' },
-                data: { availableProfiles: resolved.availableIds },
-            };
-        }
-        const plan = buildPluginRemovePlan({
-            projectRoot: ctx.cwd,
-            profile: resolved.entry.profile,
-            oldName: name,
-        });
-        return {
-            text: nextHint(`shrk plugin remove ${name} --profile ${resolved.entry.profile.id} --output /tmp/plan.json`),
-            data: plan,
-        };
-    },
-};