@shrkcrft/mcp-server 0.1.0-alpha.1

package/dist/tools/r28-pack-author.tool.js

@@ -0,0 +1,67 @@
+/**
+ * Read-only pack-author tools.
+ *
+ *  get_pack_dev_status — pack dev status (source/symlink/node_modules, signature staleness).
+ *
+ *  No watch-over-MCP (would imply long-running tool state) — use the CLI for that.
+ */
+import { buildPackDevStatus, runPackTests } from '@shrkcrft/inspector';
+import { isAbsolute, resolve } from 'node:path';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const getPackDevStatusTool = {
+    name: 'get_pack_dev_status',
+    description: 'Inspect a pack under development: how the consumer sees it, signed-manifest staleness, contribution counts. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['packPath'],
+        properties: {
+            packPath: { type: 'string' },
+            consumerPath: { type: 'string' },
+        },
+    },
+    handler(input, ctx) {
+        const packPath = String(input.packPath ?? '');
+        const consumerPath = typeof input.consumerPath === 'string' ? input.consumerPath : undefined;
+        const abs = isAbsolute(packPath) ? packPath : resolve(ctx.cwd, packPath);
+        const consumerAbs = consumerPath
+            ? (isAbsolute(consumerPath) ? consumerPath : resolve(ctx.cwd, consumerPath))
+            : undefined;
+        const status = buildPackDevStatus({
+            packPath: abs,
+            ...(consumerAbs ? { consumerPath: consumerAbs } : {}),
+        });
+        return {
+            text: nextHint(`shrk packs dev-status ${packPath}`),
+            data: status,
+        };
+    },
+};
+export const previewPackTestsTool = {
+    name: 'preview_pack_tests',
+    description: 'Run definePackTest cases against a pack and return the report. Read-only — never writes snapshots; use the CLI for that.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['packPath'],
+        properties: {
+            packPath: { type: 'string' },
+            caseId: { type: 'string' },
+        },
+    },
+    async handler(input, ctx) {
+        const packPath = String(input.packPath ?? '');
+        const caseId = typeof input.caseId === 'string' ? input.caseId : undefined;
+        const abs = isAbsolute(packPath) ? packPath : resolve(ctx.cwd, packPath);
+        const report = await runPackTests({
+            packPath: abs,
+            ...(caseId ? { caseId } : {}),
+        });
+        return {
+            text: nextHint(`shrk packs test ${packPath} --cases`),
+            data: report,
+        };
+    },
+};

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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,94 @@
+/**
+ * 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,
+        };
+    },
+};

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

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

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Read-only registry lifecycle report.
+ */
+import { buildRegistryLifecycleReport } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const getRegistryLifecycleReportTool = {
+    name: 'get_registry_lifecycle_report',
+    description: 'Scan the workspace for register*/remove* symmetry. Returns matched pairs, missing removers, and ignored sites. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            limit: { type: 'number' },
+        },
+    },
+    handler(input, ctx) {
+        const limit = typeof input.limit === 'number' ? input.limit : undefined;
+        const report = buildRegistryLifecycleReport({
+            projectRoot: ctx.cwd,
+            ...(limit ? { limit } : {}),
+        });
+        return {
+            text: nextHint('shrk check registry-lifecycle'),
+            data: report,
+        };
+    },
+};

package/dist/tools/r28-runner-policy.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getLanguageRunnerPolicyTool: IToolDefinition;
+//# sourceMappingURL=r28-runner-policy.tool.d.ts.map

package/dist/tools/r28-runner-policy.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r28-runner-policy.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r28-runner-policy.tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,2BAA2B,EAAE,eAYzC,CAAC"}

package/dist/tools/r28-runner-policy.tool.js

@@ -0,0 +1,16 @@
+/**
+ * Read-only language runner policy preview.
+ */
+import { getLanguageRunnerPolicy } from '@shrkcrft/inspector';
+export const getLanguageRunnerPolicyTool = {
+    name: 'get_language_runner_policy',
+    description: 'Show the language runner policy (allowlist + denylist + built-in deny patterns). Read-only.',
+    inputSchema: { type: 'object', additionalProperties: false, properties: {} },
+    handler(_input, ctx) {
+        const policy = getLanguageRunnerPolicy(ctx.cwd);
+        return {
+            text: `Next: \`shrk languages runner config\` (CLI is the only write path).`,
+            data: policy,
+        };
+    },
+};

package/dist/tools/r29-doctor-suppressions.tool.d.ts

@@ -0,0 +1,4 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getDoctorSuppressionsTool: IToolDefinition;
+export declare const getDoctorFilteredReportTool: IToolDefinition;
+//# sourceMappingURL=r29-doctor-suppressions.tool.d.ts.map

package/dist/tools/r29-doctor-suppressions.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r29-doctor-suppressions.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r29-doctor-suppressions.tool.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,yBAAyB,EAAE,eAgBvC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,eAsCzC,CAAC"}

package/dist/tools/r29-doctor-suppressions.tool.js

@@ -0,0 +1,66 @@
+/**
+ * Read-only MCP tools for doctor suppressions.
+ *
+ *   get_doctor_suppressions     — list the configured suppression entries.
+ *   get_doctor_filtered_report  — run the doctor + filter through the
+ *                                 suppression set; show what stays visible
+ *                                 vs. what's hidden.
+ */
+import { filterDoctorResult, loadDoctorSuppressions, runDoctor, } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const getDoctorSuppressionsTool = {
+    name: 'get_doctor_suppressions',
+    description: 'Return the contents of sharkcraft/doctor.suppressions.json. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {},
+    },
+    async handler(_input, ctx) {
+        const cfg = loadDoctorSuppressions(ctx.cwd);
+        return {
+            text: nextHint('shrk doctor suppressions list'),
+            data: cfg,
+        };
+    },
+};
+export const getDoctorFilteredReportTool = {
+    name: 'get_doctor_filtered_report',
+    description: 'Run shrk doctor and apply the configured suppressions (+ optional focus / hide). Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            focus: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Subset of: errors, warnings, warnings-new, info, ok, all.',
+            },
+            hide: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Category names to hide (e.g. action-hint-quality).',
+            },
+            quietKnown: { type: 'boolean' },
+        },
+    },
+    async handler(input, ctx) {
+        const result = runDoctor(ctx.inspection);
+        const cfg = loadDoctorSuppressions(ctx.cwd);
+        const focus = Array.isArray(input.focus) ? input.focus : undefined;
+        const hide = Array.isArray(input.hide) ? input.hide : undefined;
+        const quietKnown = input.quietKnown === true;
+        const filtered = filterDoctorResult(result, {
+            suppressions: cfg.doctorSuppressions,
+            ...(focus ? { focus: focus } : {}),
+            ...(hide ? { hide } : {}),
+            ...(quietKnown ? { quietKnown } : {}),
+        });
+        return {
+            text: nextHint('shrk doctor --quiet-known'),
+            data: filtered,
+        };
+    },
+};

package/dist/tools/r29-feedback.tool.d.ts

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

package/dist/tools/r29-feedback.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r29-feedback.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r29-feedback.tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,0BAA0B,EAAE,eAmBxC,CAAC"}

package/dist/tools/r29-feedback.tool.js

@@ -0,0 +1,26 @@
+/**
+ * Read-only MCP tool: preview_feedback_actions.
+ */
+import { ingestFeedbackText } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const previewFeedbackActionsTool = {
+    name: 'preview_feedback_actions',
+    description: 'Ingest feedback text (markdown) and return structured findings + follow-up commands. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['text'],
+        properties: {
+            text: { type: 'string' },
+            sourceFile: { type: 'string' },
+        },
+    },
+    async handler(input) {
+        const text = String(input.text ?? '');
+        const sourceFile = typeof input.sourceFile === 'string' ? input.sourceFile : undefined;
+        const report = ingestFeedbackText(text, sourceFile);
+        return { text: nextHint('shrk feedback ingest <file>'), data: report };
+    },
+};

package/dist/tools/r29-knowledge-rename.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const previewKnowledgeRenameTool: IToolDefinition;
+//# sourceMappingURL=r29-knowledge-rename.tool.d.ts.map

package/dist/tools/r29-knowledge-rename.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r29-knowledge-rename.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r29-knowledge-rename.tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,0BAA0B,EAAE,eA4CxC,CAAC"}

package/dist/tools/r29-knowledge-rename.tool.js

@@ -0,0 +1,51 @@
+/**
+ * Read-only MCP tool: preview_knowledge_rename.
+ */
+import { buildAnchorUpdatePlan, buildRenameFilePlan, buildRenameSymbolPlan, } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const previewKnowledgeRenameTool = {
+    name: 'preview_knowledge_rename',
+    description: 'Preview a knowledge rename. Subcommands: `rename-symbol`, `rename-file`, `update-anchor`. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['kind'],
+        properties: {
+            kind: { type: 'string', enum: ['rename-symbol', 'rename-file', 'update-anchor'] },
+            from: { type: 'string' },
+            to: { type: 'string' },
+            anchorId: { type: 'string' },
+            toSymbol: { type: 'string' },
+            toPath: { type: 'string' },
+            toTargetId: { type: 'string' },
+        },
+    },
+    async handler(input, ctx) {
+        const kind = String(input.kind ?? '');
+        if (kind === 'rename-symbol') {
+            const from = String(input.from ?? '');
+            const to = String(input.to ?? '');
+            const plan = buildRenameSymbolPlan(ctx.inspection, { from, to });
+            return { text: nextHint(`shrk knowledge rename-symbol ${from} ${to}`), data: plan };
+        }
+        if (kind === 'rename-file') {
+            const from = String(input.from ?? '');
+            const to = String(input.to ?? '');
+            const plan = buildRenameFilePlan(ctx.inspection, { from, to });
+            return { text: nextHint(`shrk knowledge rename-file ${from} ${to}`), data: plan };
+        }
+        if (kind === 'update-anchor') {
+            const anchorId = String(input.anchorId ?? '');
+            const plan = buildAnchorUpdatePlan(ctx.inspection, {
+                anchorId,
+                ...(typeof input.toSymbol === 'string' ? { toSymbol: input.toSymbol } : {}),
+                ...(typeof input.toPath === 'string' ? { toPath: input.toPath } : {}),
+                ...(typeof input.toTargetId === 'string' ? { toTargetId: input.toTargetId } : {}),
+            });
+            return { text: nextHint(`shrk knowledge update-anchor ${anchorId}`), data: plan };
+        }
+        return { text: `Unknown kind: ${kind}`, data: null };
+    },
+};

package/dist/tools/r29-knowledge-stale.tool.d.ts

@@ -0,0 +1,4 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getKnowledgeStaleReportTool: IToolDefinition;
+export declare const getKnowledgeReferencesTool: IToolDefinition;
+//# sourceMappingURL=r29-knowledge-stale.tool.d.ts.map

package/dist/tools/r29-knowledge-stale.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r29-knowledge-stale.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r29-knowledge-stale.tool.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,2BAA2B,EAAE,eA2BzC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,eA+BxC,CAAC"}

package/dist/tools/r29-knowledge-stale.tool.js

@@ -0,0 +1,68 @@
+/**
+ * Read-only MCP tools for knowledge stale-check / references.
+ *
+ *   get_knowledge_stale_report  — run the stale-check across all entries.
+ *   get_knowledge_references    — list references + anchors for one entry.
+ */
+import { buildKnowledgeStaleReport } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const getKnowledgeStaleReportTool = {
+    name: 'get_knowledge_stale_report',
+    description: 'Validate `references[]` + `anchors[]` on each knowledge entry. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            changedFiles: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'When supplied, restricts checks to entries that touch one of these files.',
+            },
+        },
+    },
+    async handler(input, ctx) {
+        const changed = Array.isArray(input.changedFiles)
+            ? input.changedFiles
+            : undefined;
+        const report = buildKnowledgeStaleReport(ctx.inspection, {
+            ...(changed ? { changedFiles: changed } : {}),
+        });
+        return {
+            text: nextHint('shrk knowledge stale-check'),
+            data: report,
+        };
+    },
+};
+export const getKnowledgeReferencesTool = {
+    name: 'get_knowledge_references',
+    description: 'Return references + anchors for one knowledge entry. 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 : '';
+        const entry = ctx.inspection.index.get(id);
+        if (!entry) {
+            return {
+                text: `Knowledge entry not found: ${id}`,
+                data: null,
+            };
+        }
+        return {
+            text: nextHint(`shrk knowledge references ${id}`),
+            data: {
+                id: entry.id,
+                title: entry.title,
+                references: entry.references ?? [],
+                anchors: entry.anchors ?? [],
+            },
+        };
+    },
+};

package/dist/tools/r29-query-resolver.tool.d.ts

@@ -0,0 +1,4 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const resolveQueryTool: IToolDefinition;
+export declare const traceQueryTool: IToolDefinition;
+//# sourceMappingURL=r29-query-resolver.tool.d.ts.map

package/dist/tools/r29-query-resolver.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r29-query-resolver.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r29-query-resolver.tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE,eAAO,MAAM,gBAAgB,EAAE,eAwB9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAM5B,CAAC"}

package/dist/tools/r29-query-resolver.tool.js

@@ -0,0 +1,38 @@
+/**
+ * Read-only MCP tools: resolve_query / trace_query.
+ */
+import { QueryMatchKind, resolveQuery } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+const KIND_VALUES = Object.values(QueryMatchKind);
+export const resolveQueryTool = {
+    name: 'resolve_query',
+    description: 'Resolve a free-form query against files / constructs / knowledge / templates / helpers / playbooks / policies / commands. **For agent first-task grounding prefer `prepare_agent_task`**; use `resolve_query` for ad-hoc lookups. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['query'],
+        properties: {
+            query: { type: 'string' },
+            limit: { type: 'number' },
+            kinds: { type: 'array', items: { type: 'string', enum: KIND_VALUES } },
+        },
+    },
+    async handler(input, ctx) {
+        const query = String(input.query ?? '');
+        const limit = typeof input.limit === 'number' ? input.limit : undefined;
+        const kinds = Array.isArray(input.kinds) ? input.kinds : undefined;
+        const resolution = resolveQuery(ctx.inspection, query, {
+            ...(limit ? { limit } : {}),
+            ...(kinds ? { kinds } : {}),
+        });
+        return { text: nextHint(`shrk trace ${query}`), data: resolution };
+    },
+};
+export const traceQueryTool = {
+    name: 'trace_query',
+    description: 'Alias for resolve_query. Returns the same resolution structure for parity with the CLI `shrk trace <query>`. Read-only.',
+    inputSchema: resolveQueryTool.inputSchema,
+    handler: resolveQueryTool.handler,
+};

package/dist/tools/r29-template-drift.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getTemplateDriftReportTool: IToolDefinition;
+//# sourceMappingURL=r29-template-drift.tool.d.ts.map

package/dist/tools/r29-template-drift.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r29-template-drift.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r29-template-drift.tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,0BAA0B,EAAE,eAsBxC,CAAC"}

package/dist/tools/r29-template-drift.tool.js

@@ -0,0 +1,29 @@
+/**
+ * Read-only MCP tool: get_template_drift_report.
+ */
+import { buildTemplateDriftReport } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const getTemplateDriftReportTool = {
+    name: 'get_template_drift_report',
+    description: 'Verify every registered template against the workspace (forbidden legacy paths, missing barrels, anchors, unresolved related ids). Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            templateId: { type: 'string' },
+            packId: { type: 'string' },
+        },
+    },
+    async handler(input, ctx) {
+        const report = buildTemplateDriftReport(ctx.inspection, {
+            ...(typeof input.templateId === 'string' ? { templateId: input.templateId } : {}),
+            ...(typeof input.packId === 'string' ? { packId: input.packId } : {}),
+        });
+        return {
+            text: nextHint('shrk templates drift'),
+            data: report,
+        };
+    },
+};

package/dist/tools/r30-feedback-rules.tool.d.ts

@@ -0,0 +1,4 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const listFeedbackRulesTool: IToolDefinition;
+export declare const getFeedbackRuleTool: IToolDefinition;
+//# sourceMappingURL=r30-feedback-rules.tool.d.ts.map

package/dist/tools/r30-feedback-rules.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r30-feedback-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r30-feedback-rules.tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,qBAAqB,EAAE,eAgBnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAwBjC,CAAC"}

package/dist/tools/r30-feedback-rules.tool.js

@@ -0,0 +1,47 @@
+/**
+ * Read-only MCP tools for pack-extensible feedback rules.
+ */
+import { loadFeedbackRules } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const listFeedbackRulesTool = {
+    name: 'list_feedback_rules',
+    description: 'List local + pack-contributed feedback rules (schema sharkcraft.feedback-rule/v1). Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {},
+    },
+    async handler(_input, ctx) {
+        const rules = await loadFeedbackRules(ctx.inspection);
+        return {
+            text: nextHint('shrk feedback rules list'),
+            data: { schema: 'sharkcraft.feedback-rule-list/v1', count: rules.length, rules },
+        };
+    },
+};
+export const getFeedbackRuleTool = {
+    name: 'get_feedback_rule',
+    description: 'Return a single feedback rule by id (local or pack-contributed). Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['id'],
+        properties: { id: { type: 'string' } },
+    },
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const rules = await loadFeedbackRules(ctx.inspection);
+        const rule = rules.find((r) => r.id === id);
+        return {
+            text: nextHint(`shrk feedback rules list`),
+            data: {
+                schema: 'sharkcraft.feedback-rule-get/v1',
+                id,
+                found: !!rule,
+                rule: rule ?? null,
+            },
+        };
+    },
+};

package/dist/tools/r30-fuzzy-impact.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getFuzzyImpactReportTool: IToolDefinition;
+//# sourceMappingURL=r30-fuzzy-impact.tool.d.ts.map

package/dist/tools/r30-fuzzy-impact.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r30-fuzzy-impact.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r30-fuzzy-impact.tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE,eAAO,MAAM,wBAAwB,EAAE,eAgCtC,CAAC"}