@shrkcrft/mcp-server 0.1.0-alpha.2

package/dist/tools/r30-fuzzy-impact.tool.js

@@ -0,0 +1,44 @@
+/**
+ * Read-only MCP tool for fuzzy impact resolution.
+ *
+ * Returns the same `IFuzzyImpactResolution` shape the CLI computes. Never
+ * runs the impact engine itself — the human/agent runs `shrk impact
+ * <query>` on the CLI.
+ */
+import { resolveFuzzyImpact, warmConstructCache } from '@shrkcrft/inspector';
+function nextHint(cmd) {
+    return `Next: \`${cmd}\` (CLI is the only write path).`;
+}
+export const getFuzzyImpactReportTool = {
+    name: 'get_fuzzy_impact_report',
+    description: 'Resolve a free-form impact query against files / constructs / plugin keys / symbols / templates / helpers / playbooks / knowledge / commands. Returns the resolution + alternatives + suggested follow-up commands. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['query'],
+        properties: {
+            query: { type: 'string' },
+            limit: { type: 'number' },
+            resolveOnly: { type: 'boolean' },
+        },
+    },
+    async handler(input, ctx) {
+        const query = String(input.query ?? '');
+        try {
+            await warmConstructCache(ctx.inspection);
+        }
+        catch {
+            // best-effort
+        }
+        const limit = typeof input.limit === 'number' ? input.limit : undefined;
+        const resolveOnly = Boolean(input.resolveOnly);
+        const resolution = resolveFuzzyImpact(ctx.inspection, query, {
+            ...(limit ? { limit } : {}),
+            resolveOnly,
+        });
+        return {
+            text: nextHint(`shrk impact ${query}${resolveOnly ? ' --resolve-only' : ''}`),
+            data: resolution,
+        };
+    },
+};

package/dist/tools/r31-changes-pr-ci.tool.d.ts

@@ -0,0 +1,5 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getChangesSummaryTool: IToolDefinition;
+export declare const getPrSummaryPreviewTool: IToolDefinition;
+export declare const getCiIntegrityReportTool: IToolDefinition;
+//# sourceMappingURL=r31-changes-pr-ci.tool.d.ts.map

package/dist/tools/r31-changes-pr-ci.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r31-changes-pr-ci.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r31-changes-pr-ci.tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAYpE,eAAO,MAAM,qBAAqB,EAAE,eAgBnC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAkCrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAoBtC,CAAC"}

package/dist/tools/r31-changes-pr-ci.tool.js

@@ -0,0 +1,82 @@
+/**
+ * Read-only MCP tools for changes summary, PR summary, CI integrity.
+ */
+import { buildChangesSummary, buildCiIntegrityReport, buildPrSummary, } from '@shrkcrft/inspector';
+const DIFF_INPUT_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        since: { type: 'string' },
+        staged: { type: 'boolean' },
+        files: { type: 'array', items: { type: 'string' } },
+    },
+};
+export const getChangesSummaryTool = {
+    name: 'get_changes_summary',
+    description: 'Grouped changes summary over --since / --staged / --files. Returns area breakdown + risk verdict + suggested validation commands. Read-only.',
+    inputSchema: DIFF_INPUT_SCHEMA,
+    async handler(input, ctx) {
+        const opts = {};
+        if (typeof input.since === 'string')
+            opts.since = input.since;
+        if (input.staged === true)
+            opts.staged = true;
+        if (Array.isArray(input.files))
+            opts.files = input.files;
+        const report = await buildChangesSummary(ctx.inspection, opts);
+        return {
+            text: 'Next: `shrk changes summary --since <ref>` (CLI is the only write path).',
+            data: report,
+        };
+    },
+};
+export const getPrSummaryPreviewTool = {
+    name: 'get_pr_summary_preview',
+    description: 'Render a PR description preview from the working-tree changes + reports under .sharkcraft/reports. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            since: { type: 'string' },
+            staged: { type: 'boolean' },
+            files: { type: 'array', items: { type: 'string' } },
+            maxItems: { type: 'number' },
+            reportsDir: { type: 'string' },
+        },
+    },
+    async handler(input, ctx) {
+        const opts = {};
+        if (typeof input.since === 'string')
+            opts.since = input.since;
+        if (input.staged === true)
+            opts.staged = true;
+        if (Array.isArray(input.files))
+            opts.files = input.files;
+        if (typeof input.maxItems === 'number')
+            opts.maxItems = input.maxItems;
+        if (typeof input.reportsDir === 'string')
+            opts.reportsDir = input.reportsDir;
+        const report = await buildPrSummary(ctx.inspection, opts);
+        return {
+            text: 'Next: `shrk pr summary --since <ref>` (CLI writes only when --output is passed).',
+            data: report,
+        };
+    },
+};
+export const getCiIntegrityReportTool = {
+    name: 'get_ci_integrity_report',
+    description: 'Aggregate the JSON reports under .sharkcraft/reports into a single CI integrity verdict. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: { reportsDir: { type: 'string' } },
+    },
+    async handler(input, ctx) {
+        const reportsDir = typeof input.reportsDir === 'string' ? input.reportsDir : undefined;
+        const report = buildCiIntegrityReport(ctx.inspection.projectRoot, reportsDir ? { reportsDir } : {});
+        return {
+            text: 'Next: `shrk ci report --format markdown` (CLI is the only write path).',
+            data: report,
+        };
+    },
+};

package/dist/tools/r31-command-discovery.tool.d.ts

@@ -0,0 +1,5 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const suggestCommandsTool: IToolDefinition;
+export declare const searchCommandsTool: IToolDefinition;
+export declare const explainCommandTool: IToolDefinition;
+//# sourceMappingURL=r31-command-discovery.tool.d.ts.map

package/dist/tools/r31-command-discovery.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r31-command-discovery.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r31-command-discovery.tool.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAgCpE,eAAO,MAAM,mBAAmB,EAAE,eAsBjC,CAAC;AA8BF,eAAO,MAAM,kBAAkB,EAAE,eA+BhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAShC,CAAC"}

package/dist/tools/r31-command-discovery.tool.js

@@ -0,0 +1,126 @@
+/**
+ * Read-only MCP tools for command discovery.
+ *
+ * `suggest_commands` — fuzzy-tolerant suggestions for a partial command.
+ * `search_commands` — substring + keyword search across the catalog.
+ *
+ * Both are read-only. MCP does not execute the suggested commands.
+ */
+import { explainCommand, suggestCommands, } from '@shrkcrft/inspector';
+import { COMMAND_CATALOG_EXPORT } from "./command-catalog.tool.js";
+const COMMAND_CATALOG = COMMAND_CATALOG_EXPORT.map((e) => ({
+    command: e.command,
+    description: e.description,
+    category: e.category,
+    safetyLevel: e.safetyLevel,
+    writesFiles: e.writesFiles,
+    writesSource: e.writesSource,
+    runsShell: e.runsShell,
+    requiresReview: e.requiresReview,
+    mcpAvailable: e.mcpAvailable,
+    aliases: e.aliases,
+}));
+const INPUT_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['query'],
+    properties: {
+        query: { type: 'string', description: 'Partial command, typo, or keyword.' },
+        limit: { type: 'number', description: 'Cap results. Default 10.' },
+        safeOnly: { type: 'boolean', description: 'Exclude commands that write source.' },
+        mcpSafeOnly: { type: 'boolean', description: 'Only include commands callable via MCP.' },
+        category: { type: 'string', description: 'Filter to a single category.' },
+    },
+};
+function next(hint) {
+    return `Next: \`${hint}\` (CLI is the only write path).`;
+}
+export const suggestCommandsTool = {
+    name: 'suggest_commands',
+    description: 'Typo-tolerant suggestions for a partial command (e.g. "knowlege" → "knowledge"). Read-only. Results are annotated with `tier` and `gatedDefault`; experimental commands need `shrk surface enable <cmd>` before they can be called.',
+    inputSchema: INPUT_SCHEMA,
+    async handler(input) {
+        const query = String(input.query ?? '');
+        const limit = typeof input.limit === 'number' ? input.limit : 10;
+        const safeOnly = !!input.safeOnly;
+        const mcpSafeOnly = !!input.mcpSafeOnly;
+        const category = typeof input.category === 'string' ? input.category : undefined;
+        const result = suggestCommands(COMMAND_CATALOG, query, {
+            limit,
+            safeOnly,
+            mcpSafeOnly,
+            ...(category ? { category } : {}),
+        });
+        return {
+            text: next(`shrk commands suggest "${query}"`),
+            data: annotateSuggestResult(result),
+        };
+    },
+};
+/**
+ * Annotate suggestCommands output with tier info from
+ * the catalog snapshot. The snapshot doesn't know the project's
+ * surface config, so `gatedDefault: true` means "tier=experimental
+ * in the static catalog; the host CLI may have enabled it via
+ * surface.enabled[]." Agents should check `get_command_catalog` (or
+ * the host's `shrk surface list`) to confirm before invocation.
+ */
+function annotateSuggestResult(result) {
+    const r = result;
+    const suggestions = (r.suggestions ?? []).map((s) => {
+        const entry = COMMAND_CATALOG.find((c) => c.command === s.command);
+        const tier = entry?.tier ?? 'extended';
+        return {
+            ...s,
+            tier,
+            gatedDefault: tier === 'experimental',
+            ...(tier === 'experimental' ? { enableHint: `shrk surface enable ${s.command} --write` } : {}),
+        };
+    });
+    return {
+        ...result,
+        suggestions,
+        gatingHint: 'Tier values are best-effort from the static catalog. Confirm with `get_command_catalog` or `shrk surface list` in the host project before invoking experimental commands.',
+    };
+}
+export const searchCommandsTool = {
+    name: 'search_commands',
+    description: 'Search the command catalog by substring or keyword. Returns matching commands with safety + MCP availability metadata. Read-only.',
+    inputSchema: INPUT_SCHEMA,
+    async handler(input) {
+        const query = String(input.query ?? '').toLowerCase();
+        const limit = typeof input.limit === 'number' ? input.limit : 25;
+        const safeOnly = !!input.safeOnly;
+        const mcpSafeOnly = !!input.mcpSafeOnly;
+        const category = typeof input.category === 'string' ? input.category : undefined;
+        let filtered = COMMAND_CATALOG.filter((c) => !query ||
+            c.command.toLowerCase().includes(query) ||
+            c.description.toLowerCase().includes(query) ||
+            c.aliases.some((a) => a.toLowerCase().includes(query)));
+        if (safeOnly)
+            filtered = filtered.filter((c) => !c.writesSource);
+        if (mcpSafeOnly)
+            filtered = filtered.filter((c) => c.mcpAvailable);
+        if (category)
+            filtered = filtered.filter((c) => c.category === category);
+        return {
+            text: next(`shrk commands search "${query}"`),
+            data: {
+                schema: 'sharkcraft.command-search/v1',
+                query,
+                count: filtered.length,
+                results: filtered.slice(0, limit),
+            },
+        };
+    },
+};
+export const explainCommandTool = {
+    name: 'explain_command',
+    description: 'Explain a command — exact catalog entry + near matches. Read-only.',
+    inputSchema: INPUT_SCHEMA,
+    async handler(input) {
+        const query = String(input.query ?? '');
+        const report = explainCommand(COMMAND_CATALOG, query);
+        return { text: next(`shrk commands explain "${query}"`), data: report };
+    },
+};

package/dist/tools/r31-fix-preview.tool.d.ts

@@ -0,0 +1,4 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const previewFixTool: IToolDefinition;
+export declare const listFixKindsTool: IToolDefinition;
+//# sourceMappingURL=r31-fix-preview.tool.d.ts.map

package/dist/tools/r31-fix-preview.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r31-fix-preview.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r31-fix-preview.tool.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,cAAc,EAAE,eAkC5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAU9B,CAAC"}

package/dist/tools/r31-fix-preview.tool.js

@@ -0,0 +1,58 @@
+/**
+ * Read-only MCP tools for the fix-preview system.
+ *
+ * `preview_fix` — return structured fix suggestions for a kind subset.
+ * `list_fix_kinds` — return the supported fix kinds.
+ *
+ * Read-only. No source mutations. The CLI is the only path that writes
+ * previews (and only under `.sharkcraft/fixes/`).
+ */
+import { buildFixPreview, FixKind, listFixKinds } from '@shrkcrft/inspector';
+export const previewFixTool = {
+    name: 'preview_fix',
+    description: 'Return fix-preview suggestions for action hints / stale knowledge / template drift. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            kinds: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Subset of fix kinds (action-hints, knowledge-stale, template-drift).',
+            },
+            target: { type: 'string', description: 'Optional target id filter.' },
+        },
+    },
+    async handler(input, ctx) {
+        const kindsRaw = Array.isArray(input.kinds) ? input.kinds : [];
+        const kinds = [];
+        for (const k of kindsRaw) {
+            if (k === 'action-hints')
+                kinds.push(FixKind.ActionHints);
+            if (k === 'knowledge-stale')
+                kinds.push(FixKind.KnowledgeStale);
+            if (k === 'template-drift')
+                kinds.push(FixKind.TemplateDrift);
+        }
+        const report = buildFixPreview(ctx.inspection, kinds.length > 0 ? { kinds } : {});
+        const target = typeof input.target === 'string' ? input.target : undefined;
+        const suggestions = target
+            ? report.suggestions.filter((s) => s.targetId === target)
+            : report.suggestions;
+        return {
+            text: 'Next: `shrk fix preview` (preview-only). To write, add `--write-preview` (writes only under .sharkcraft/fixes).',
+            data: { ...report, suggestions },
+        };
+    },
+};
+export const listFixKindsTool = {
+    name: 'list_fix_kinds',
+    description: 'List supported fix kinds for `shrk fix preview` (read-only).',
+    inputSchema: { type: 'object', additionalProperties: false, properties: {} },
+    async handler() {
+        return {
+            text: 'Next: `shrk fix list`',
+            data: { schema: 'sharkcraft.fix-kinds/v1', kinds: listFixKinds() },
+        };
+    },
+};

package/dist/tools/r31-ranker-explain.tool.d.ts

@@ -0,0 +1,4 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const getRankerExplanationTool: IToolDefinition;
+export declare const getRankerWhyNotTool: IToolDefinition;
+//# sourceMappingURL=r31-ranker-explain.tool.d.ts.map

package/dist/tools/r31-ranker-explain.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r31-ranker-explain.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r31-ranker-explain.tool.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAyBpE,eAAO,MAAM,wBAAwB,EAAE,eAoBtC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAoBjC,CAAC"}

package/dist/tools/r31-ranker-explain.tool.js

@@ -0,0 +1,69 @@
+/**
+ * Read-only MCP tools for ranker explainability.
+ *
+ * `get_ranker_explanation` answers "why was id X included for task Y?".
+ * `get_ranker_why_not` answers "why wasn't id X included for task Y?".
+ *
+ * Both are read-only. No writes; the CLI is the only write path.
+ */
+import { explainRankerDecision } from '@shrkcrft/inspector';
+function nextHint(id, task, whyNot) {
+    const cmd = whyNot ? 'why-not' : 'why';
+    const t = task ? ` --for-task "${task}"` : '';
+    return `Next: \`shrk ${cmd} ${id}${t}\` (CLI is the only write path).`;
+}
+const REQUEST_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['id'],
+    properties: {
+        id: { type: 'string', description: 'Target id to explain.' },
+        task: { type: 'string', description: 'Free-form task description.' },
+        query: { type: 'string', description: 'Free-form search query.' },
+        kind: {
+            type: 'string',
+            description: 'Optional kind hint (knowledge|template|rule|helper|playbook|construct|policy|command|path|preset|pipeline).',
+        },
+        topN: { type: 'number', description: 'Top-N considered for inclusion. Default 10.' },
+    },
+};
+export const getRankerExplanationTool = {
+    name: 'get_ranker_explanation',
+    description: 'Explain how the deterministic ranker scored an id for a given task or query. Returns matched/missing signals, score, rank, outranked-by, suggested metadata fixes. Read-only.',
+    inputSchema: REQUEST_SCHEMA,
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const task = typeof input.task === 'string' ? input.task : undefined;
+        const query = typeof input.query === 'string' ? input.query : undefined;
+        const kindRaw = typeof input.kind === 'string' ? input.kind : undefined;
+        const topN = typeof input.topN === 'number' ? input.topN : 10;
+        const request = {
+            id,
+            ...(task ? { task } : {}),
+            ...(query ? { query } : {}),
+            ...(kindRaw ? { kind: kindRaw } : {}),
+        };
+        const report = explainRankerDecision(ctx.inspection, request, { whyNot: false, topN });
+        return { text: nextHint(id, task, false), data: report };
+    },
+};
+export const getRankerWhyNotTool = {
+    name: 'get_ranker_why_not',
+    description: 'Explain why the deterministic ranker did NOT include an id for a given task or query. Returns nearest ids when the target is missing entirely. Read-only.',
+    inputSchema: REQUEST_SCHEMA,
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const task = typeof input.task === 'string' ? input.task : undefined;
+        const query = typeof input.query === 'string' ? input.query : undefined;
+        const kindRaw = typeof input.kind === 'string' ? input.kind : undefined;
+        const topN = typeof input.topN === 'number' ? input.topN : 10;
+        const request = {
+            id,
+            ...(task ? { task } : {}),
+            ...(query ? { query } : {}),
+            ...(kindRaw ? { kind: kindRaw } : {}),
+        };
+        const report = explainRankerDecision(ctx.inspection, request, { whyNot: true, topN });
+        return { text: nextHint(id, task, true), data: report };
+    },
+};

package/dist/tools/r31-scaffold-coverage.tool.d.ts

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

package/dist/tools/r31-scaffold-coverage.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r31-scaffold-coverage.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r31-scaffold-coverage.tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,6BAA6B,EAAE,eA2B3C,CAAC"}

package/dist/tools/r31-scaffold-coverage.tool.js

@@ -0,0 +1,31 @@
+/**
+ * Read-only MCP tool for scaffold coverage gaps.
+ */
+import { buildScaffoldCoverageReport } from '@shrkcrft/inspector';
+export const getScaffoldCoverageReportTool = {
+    name: 'get_scaffold_coverage_report',
+    description: 'Coverage-gap analysis for a task/domain across knowledge/rules/paths/templates/scaffold-patterns/playbooks/helpers/validation-commands. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            task: { type: 'string' },
+            domain: { type: 'string' },
+            topN: { type: 'number' },
+        },
+    },
+    async handler(input, ctx) {
+        const task = typeof input.task === 'string' ? input.task : undefined;
+        const domain = typeof input.domain === 'string' ? input.domain : undefined;
+        const topN = typeof input.topN === 'number' ? input.topN : 8;
+        const report = await buildScaffoldCoverageReport(ctx.inspection, {
+            ...(task ? { task } : {}),
+            ...(domain ? { domain } : {}),
+            topN,
+        });
+        return {
+            text: `Next: \`shrk coverage scaffolds --task "${task ?? domain ?? '<task>'}"\``,
+            data: report,
+        };
+    },
+};

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

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

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

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

@@ -0,0 +1,107 @@
+/**
+ * Read-only MCP tools for profiles + lifecycle 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).
+ */
+import { checkPluginLifecycleProfileHealth, findProfile, listProfileIssues, listProfiles, listPluginLifecycleProfiles, ProfileKind, } from '@shrkcrft/inspector';
+export const listProfilesTool = {
+    name: 'list_profiles',
+    description: 'List all pack-contributed and locally configured profiles. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: { kind: { type: 'string' } },
+    },
+    async handler(input, ctx) {
+        const kindArg = typeof input.kind === 'string' ? input.kind : undefined;
+        const kind = kindArg && Object.values(ProfileKind).includes(kindArg)
+            ? kindArg
+            : undefined;
+        return { data: await listProfiles(ctx.inspection, kind ? { kind } : {}) };
+    },
+};
+export const getProfileTool = {
+    name: 'get_profile',
+    description: 'Get one profile by id (and optional kind). Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['id'],
+        properties: { id: { type: 'string' }, kind: { 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 kindArg = typeof input.kind === 'string' ? input.kind : undefined;
+        const kind = kindArg && Object.values(ProfileKind).includes(kindArg)
+            ? kindArg
+            : undefined;
+        const entry = await findProfile(ctx.inspection, id, kind);
+        if (!entry) {
+            return { isError: true, error: { code: 'not-found', message: `Unknown profile id "${id}"${kind ? ` (kind=${kind})` : ''}.` } };
+        }
+        return { data: entry };
+    },
+};
+export const getProfilesDoctorTool = {
+    name: 'get_profiles_doctor',
+    description: 'Profile registry doctor — surface load issues across all profile kinds. Read-only.',
+    inputSchema: { type: 'object', additionalProperties: false, properties: {} },
+    async handler(_input, ctx) {
+        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/dist/tools/r32-project-coupling.tool.d.ts

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

package/dist/tools/r32-project-coupling.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r32-project-coupling.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r32-project-coupling.tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,4BAA4B,EAAE,eAkC1C,CAAC"}

package/dist/tools/r32-project-coupling.tool.js

@@ -0,0 +1,38 @@
+/**
+ * Read-only project-specific coupling audit.
+ */
+import { auditProjectCoupling } from '@shrkcrft/inspector';
+export const getProjectCouplingReportTool = {
+    name: 'get_project_coupling_report',
+    description: 'Scan the workspace for project-specific tokens (caller-supplied identifiers like legacy library paths or key-table names) and report each occurrence with a recommended externalization target. Read-only.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['tokens'],
+        properties: {
+            tokens: { type: 'array' },
+            scanRoots: { type: 'array' },
+            excludeRoots: { type: 'array' },
+        },
+    },
+    async handler(input, ctx) {
+        const raw = input.tokens;
+        const tokens = Array.isArray(raw) ? raw.filter((t) => typeof t === 'string') : [];
+        if (tokens.length === 0) {
+            return { isError: true, error: { code: 'invalid-input', message: 'tokens must be a non-empty array of strings.' } };
+        }
+        const scanRoots = Array.isArray(input.scanRoots)
+            ? input.scanRoots.filter((r) => typeof r === 'string')
+            : undefined;
+        const excludeRoots = Array.isArray(input.excludeRoots)
+            ? input.excludeRoots.filter((r) => typeof r === 'string')
+            : undefined;
+        const report = auditProjectCoupling({
+            projectRoot: ctx.cwd,
+            tokens,
+            ...(scanRoots ? { scanRoots } : {}),
+            ...(excludeRoots ? { excludeRoots } : {}),
+        });
+        return { data: report };
+    },
+};

package/dist/tools/r33-agent-task-prep.tool.d.ts

@@ -0,0 +1,3 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+export declare const prepareAgentTaskTool: IToolDefinition;
+//# sourceMappingURL=r33-agent-task-prep.tool.d.ts.map

package/dist/tools/r33-agent-task-prep.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r33-agent-task-prep.tool.d.ts","sourceRoot":"","sources":["../../src/tools/r33-agent-task-prep.tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,oBAAoB,EAAE,eA0BlC,CAAC"}