@shrkcrft/mcp-server 0.1.0-alpha.1

package/dist/tools/get-agent-instructions.tool.js

@@ -0,0 +1,9 @@
+import { AGENT_INSTRUCTIONS } from '@shrkcrft/inspector';
+export const getAgentInstructionsTool = {
+    name: 'get_agent_instructions',
+    description: 'Returns compact instructions for AI agents on how to use this repository through SharkCraft.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler() {
+        return { text: AGENT_INSTRUCTIONS, data: { instructions: AGENT_INSTRUCTIONS } };
+    },
+};

package/dist/tools/get-ai-readiness-report.tool.d.ts

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

package/dist/tools/get-ai-readiness-report.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ai-readiness-report.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-ai-readiness-report.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,wBAAwB,EAAE,eAStC,CAAC"}

package/dist/tools/get-ai-readiness-report.tool.js

@@ -0,0 +1,10 @@
+import { buildAiReadinessReport } from '@shrkcrft/inspector';
+export const getAiReadinessReportTool = {
+    name: 'get_ai_readiness_report',
+    description: 'Deterministic 0..100 score reporting how AI-ready the SharkCraft setup is. Dimensions cover config/knowledge/rules/paths/templates/pipelines/action hints/safety/doctor/packs. Returns score, grade, per-dimension breakdown, top recommendations.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        const report = buildAiReadinessReport(ctx.inspection);
+        return { data: report };
+    },
+};

package/dist/tools/get-architecture-constraints.tool.d.ts

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

package/dist/tools/get-architecture-constraints.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-architecture-constraints.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-architecture-constraints.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,8BAA8B,EAAE,eAqB5C,CAAC"}

package/dist/tools/get-architecture-constraints.tool.js

@@ -0,0 +1,20 @@
+import { KnowledgeType } from '@shrkcrft/knowledge';
+export const getArchitectureConstraintsTool = {
+    name: 'get_architecture_constraints',
+    description: 'Return architecture-related knowledge entries (type "architecture" or "decision").',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        const entries = ctx.inspection.knowledgeEntries.filter((e) => String(e.type) === KnowledgeType.Architecture || String(e.type) === KnowledgeType.Decision);
+        return {
+            data: entries.map((e) => ({
+                id: e.id,
+                title: e.title,
+                type: e.type,
+                priority: e.priority,
+                summary: e.summary,
+                content: e.content,
+                tags: e.tags,
+            })),
+        };
+    },
+};

package/dist/tools/get-boundary-rule.tool.d.ts

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

package/dist/tools/get-boundary-rule.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-boundary-rule.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-boundary-rule.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,mBAAmB,EAAE,eAoBjC,CAAC"}

package/dist/tools/get-boundary-rule.tool.js

@@ -0,0 +1,22 @@
+export const getBoundaryRuleTool = {
+    name: 'get_boundary_rule',
+    description: 'Get one boundary rule by id with full details.',
+    inputSchema: {
+        type: 'object',
+        properties: { id: { type: 'string' } },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const rule = ctx.inspection.boundaryRegistry.get(id);
+        if (!rule)
+            return { isError: true, text: `No boundary rule with id "${id}".` };
+        return {
+            data: {
+                ...rule,
+                source: ctx.inspection.boundarySources.get(id) ?? null,
+            },
+        };
+    },
+};

package/dist/tools/get-coverage-report.tool.d.ts

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

package/dist/tools/get-coverage-report.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-coverage-report.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-coverage-report.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,qBAAqB,EAAE,eAQnC,CAAC"}

package/dist/tools/get-coverage-report.tool.js

@@ -0,0 +1,9 @@
+import { buildCoverageReport } from '@shrkcrft/inspector';
+export const getCoverageReportTool = {
+    name: 'get_coverage_report',
+    description: 'Return a relationship/coverage report: templates with descriptions/related, hint coverage on critical entries, pipeline → template links, preset references, boundary suggestedFix, pack docs. Read-only.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        return { data: buildCoverageReport(ctx.inspection) };
+    },
+};

package/dist/tools/get-current-tasks.tool.d.ts

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

package/dist/tools/get-current-tasks.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current-tasks.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-current-tasks.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,mBAAmB,EAAE,eAoBjC,CAAC"}

package/dist/tools/get-current-tasks.tool.js

@@ -0,0 +1,19 @@
+import { KnowledgeType } from '@shrkcrft/knowledge';
+export const getCurrentTasksTool = {
+    name: 'get_current_tasks',
+    description: 'Return current tasks/roadmap entries (knowledge entries of type "task" or sourced from tasks/*.md).',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        const tasks = ctx.inspection.knowledgeEntries.filter((e) => String(e.type) === KnowledgeType.Task ||
+            (e.source?.origin && e.source.origin.includes('/tasks/')));
+        return {
+            data: tasks.map((t) => ({
+                id: t.id,
+                title: t.title,
+                priority: t.priority,
+                source: t.source?.origin,
+                content: t.content,
+            })),
+        };
+    },
+};

package/dist/tools/get-drift-report.tool.d.ts

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

package/dist/tools/get-drift-report.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-drift-report.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-drift-report.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,kBAAkB,EAAE,eAehC,CAAC"}

package/dist/tools/get-drift-report.tool.js

@@ -0,0 +1,16 @@
+import { buildDriftReport } from '@shrkcrft/inspector';
+export const getDriftReportTool = {
+    name: 'get_drift_report',
+    description: 'Detect architecture drift: boundary violations, broken preset references, pipeline/template links, missing pack assets. Read-only.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            skipBoundaries: { type: 'boolean', description: 'Skip the import scan (faster, no boundary findings).' },
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const skip = input.skipBoundaries === true;
+        return { data: buildDriftReport(ctx.inspection, { runBoundaries: !skip }) };
+    },
+};

package/dist/tools/get-graph-node.tool.d.ts

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

package/dist/tools/get-graph-node.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-graph-node.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-node.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,gBAAgB,EAAE,eAqB9B,CAAC"}

package/dist/tools/get-graph-node.tool.js

@@ -0,0 +1,23 @@
+import { buildKnowledgeGraph, getGraphNode } from '@shrkcrft/inspector';
+export const getGraphNodeTool = {
+    name: 'get_graph_node',
+    description: 'Return one knowledge-graph node with its incoming/outgoing edges. Useful for explaining why a rule/template/pipeline relates to others.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string' },
+            kind: { type: 'string' },
+        },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const kind = input.kind;
+        const graph = buildKnowledgeGraph(ctx.inspection);
+        const node = getGraphNode(graph, typeof kind === 'string' ? { kind: kind, id } : { id });
+        if (!node)
+            return { isError: true, text: `No node for "${id}".` };
+        return { data: node };
+    },
+};

package/dist/tools/get-import-graph-summary.tool.d.ts

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

package/dist/tools/get-import-graph-summary.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-import-graph-summary.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-import-graph-summary.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,yBAAyB,EAAE,eASvC,CAAC"}

package/dist/tools/get-import-graph-summary.tool.js

@@ -0,0 +1,10 @@
+import { scanImports, summarizeImports } from '@shrkcrft/boundaries';
+export const getImportGraphSummaryTool = {
+    name: 'get_import_graph_summary',
+    description: 'Scan the project and return import-graph summary stats (files scanned, internal/external counts, top external specifiers, warnings). Read-only.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        const scan = scanImports({ projectRoot: ctx.inspection.projectRoot });
+        return { data: summarizeImports(scan) };
+    },
+};

package/dist/tools/get-knowledge-graph.tool.d.ts

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

package/dist/tools/get-knowledge-graph.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-knowledge-graph.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-knowledge-graph.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,qBAAqB,EAAE,eASnC,CAAC"}

package/dist/tools/get-knowledge-graph.tool.js

@@ -0,0 +1,10 @@
+import { buildKnowledgeGraph } from '@shrkcrft/inspector';
+export const getKnowledgeGraphTool = {
+    name: 'get_knowledge_graph',
+    description: 'Return the full SharkCraft knowledge graph: nodes (knowledge/rules/paths/templates/pipelines/presets/packs/boundaries) and edges (related-template, preset-references, pipeline-step-references, …). Read-only.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        const graph = buildKnowledgeGraph(ctx.inspection);
+        return { data: { nodes: graph.nodes, edges: graph.edges } };
+    },
+};

package/dist/tools/get-knowledge.tool.d.ts

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

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

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

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

@@ -0,0 +1,18 @@
+import { formatEntryFull } from '@shrkcrft/knowledge';
+export const getKnowledgeTool = {
+    name: 'get_knowledge',
+    description: 'Get one knowledge entry by id with full content.',
+    inputSchema: {
+        type: 'object',
+        properties: { id: { type: 'string' } },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const entry = ctx.inspection.index.get(id);
+        if (!entry)
+            return { isError: true, text: `No knowledge entry with id "${id}"` };
+        return { data: entry, text: formatEntryFull(entry) };
+    },
+};

package/dist/tools/get-pack.tool.d.ts

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

package/dist/tools/get-pack.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pack.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-pack.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,WAAW,EAAE,eAgCzB,CAAC"}

package/dist/tools/get-pack.tool.js

@@ -0,0 +1,33 @@
+export const getPackTool = {
+    name: 'get_pack',
+    description: 'Get one discovered pack by package name. Returns manifest info, contribution counts, validation issues, post-install notes. Does not embed full contribution file contents.',
+    inputSchema: {
+        type: 'object',
+        properties: { packageName: { type: 'string' } },
+        required: ['packageName'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const id = String(input.packageName ?? '');
+        const pack = ctx.inspection.packs.discoveredPacks.find((p) => p.packageName === id);
+        if (!pack)
+            return { isError: true, text: `No pack with packageName "${id}" was discovered.` };
+        return {
+            data: {
+                packageName: pack.packageName,
+                packageVersion: pack.packageVersion,
+                valid: pack.valid,
+                manifestPath: pack.manifestPath,
+                packageRoot: pack.packageRoot,
+                info: pack.manifest?.info,
+                contributionCounts: pack.contributionCounts,
+                resolvedCounts: pack.resolvedCounts,
+                signatureStatus: pack.signatureStatus,
+                signatureMessage: pack.signatureMessage,
+                validationIssues: pack.validationIssues,
+                loadError: pack.loadError,
+                postInstallNotes: pack.manifest?.postInstallNotes ?? [],
+            },
+        };
+    },
+};

package/dist/tools/get-path-convention.tool.d.ts

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

package/dist/tools/get-path-convention.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-path-convention.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-path-convention.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,qBAAqB,EAAE,eAenC,CAAC"}

package/dist/tools/get-path-convention.tool.js

@@ -0,0 +1,17 @@
+export const getPathConventionTool = {
+    name: 'get_path_convention',
+    description: 'Get one path convention by id.',
+    inputSchema: {
+        type: 'object',
+        properties: { id: { type: 'string' } },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const p = ctx.inspection.pathService.get(id);
+        if (!p)
+            return { isError: true, text: `No path convention with id "${id}"` };
+        return { data: p };
+    },
+};

package/dist/tools/get-pipeline-context.tool.d.ts

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

package/dist/tools/get-pipeline-context.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pipeline-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-pipeline-context.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAKpE,eAAO,MAAM,sBAAsB,EAAE,eA8CpC,CAAC"}

package/dist/tools/get-pipeline-context.tool.js

@@ -0,0 +1,48 @@
+import { buildContext } from '@shrkcrft/context';
+import { buildProjectOverview, renderOverviewText } from '@shrkcrft/inspector';
+import { formatPipelineFull } from '@shrkcrft/pipelines';
+export const getPipelineContextTool = {
+    name: 'get_pipeline_context',
+    description: 'Combine a pipeline with task-specific retrieved context. Returns the pipeline definition + a token-budgeted context block for the task. Use this when the agent has chosen a pipeline and needs both the workflow steps and the relevant rules/paths/templates to follow it.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string' },
+            task: { type: 'string' },
+            maxTokens: { type: 'integer', minimum: 100 },
+            scope: { type: 'array', items: { type: 'string' } },
+        },
+        required: ['id', 'task'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const pipeline = ctx.inspection.pipelineRegistry.get(id);
+        if (!pipeline)
+            return { isError: true, text: `No pipeline with id "${id}".` };
+        const overview = buildProjectOverview(ctx.inspection.workspace, ctx.inspection.config?.projectName);
+        const result = buildContext(ctx.inspection.knowledgeEntries, {
+            task: String(input.task),
+            scope: input.scope,
+            maxTokens: typeof input.maxTokens === 'number' ? input.maxTokens : 3000,
+            projectOverview: renderOverviewText(overview),
+        });
+        return {
+            data: {
+                pipeline,
+                context: {
+                    totalTokens: result.totalTokens,
+                    maxTokens: result.maxTokens,
+                    omittedSections: result.omittedSections,
+                    sections: result.sections.map((s) => ({
+                        title: s.title,
+                        tokens: s.tokens,
+                        truncated: s.truncated ?? false,
+                        entryIds: s.entryIds,
+                    })),
+                },
+            },
+            text: `${formatPipelineFull(pipeline)}\n\n---\n\n${result.body}`,
+        };
+    },
+};

package/dist/tools/get-pipeline.tool.d.ts

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

package/dist/tools/get-pipeline.tool.d.ts.map

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

package/dist/tools/get-pipeline.tool.js

@@ -0,0 +1,17 @@
+import { formatPipelineFull } from '@shrkcrft/pipelines';
+export const getPipelineTool = {
+    name: 'get_pipeline',
+    description: 'Get one pipeline by id with all steps + inputs + notes.',
+    inputSchema: {
+        type: 'object',
+        properties: { id: { type: 'string' } },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const p = ctx.inspection.pipelineRegistry.get(String(input.id ?? ''));
+        if (!p)
+            return { isError: true, text: `No pipeline with id "${input.id}".` };
+        return { data: p, text: formatPipelineFull(p) };
+    },
+};

package/dist/tools/get-preset.tool.d.ts

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

package/dist/tools/get-preset.tool.d.ts.map

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

package/dist/tools/get-preset.tool.js

@@ -0,0 +1,22 @@
+export const getPresetTool = {
+    name: 'get_preset',
+    description: 'Get one preset by id. Returns the full definition including includes, recommendedNextCommands, postInstallNotes, and safety notes.',
+    inputSchema: {
+        type: 'object',
+        properties: { id: { type: 'string' } },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const id = String(input.id ?? '');
+        const preset = ctx.inspection.presetRegistry.get(id);
+        if (!preset)
+            return { isError: true, text: `No preset with id "${id}".` };
+        return {
+            data: {
+                ...preset,
+                source: ctx.inspection.presetSources.get(id) ?? null,
+            },
+        };
+    },
+};

package/dist/tools/get-project-overview.tool.d.ts

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

package/dist/tools/get-project-overview.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-project-overview.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-project-overview.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,sBAAsB,EAAE,eAQpC,CAAC"}

package/dist/tools/get-project-overview.tool.js

@@ -0,0 +1,10 @@
+import { buildProjectOverview, renderOverviewText } from '@shrkcrft/inspector';
+export const getProjectOverviewTool = {
+    name: 'get_project_overview',
+    description: 'Returns a compact project overview (name, package manager, frameworks, top-level dirs).',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+    async handler(_input, ctx) {
+        const overview = buildProjectOverview(ctx.inspection.workspace, ctx.inspection.config?.projectName);
+        return { text: renderOverviewText(overview), data: overview };
+    },
+};

package/dist/tools/get-relevant-context.tool.d.ts

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

package/dist/tools/get-relevant-context.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-relevant-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-relevant-context.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,eAAO,MAAM,sBAAsB,EAAE,eAqDpC,CAAC"}

package/dist/tools/get-relevant-context.tool.js

@@ -0,0 +1,55 @@
+import { buildContext } from '@shrkcrft/context';
+import { buildProjectOverview, renderOverviewText } from '@shrkcrft/inspector';
+export const getRelevantContextTool = {
+    name: 'get_relevant_context',
+    description: 'Build a token-budgeted, AI-ready context for a task — relevant rules/paths/templates/etc. **Prefer `prepare_agent_task` for first task grounding** (it returns this plus action hints + safety + next-command). Use this when you only need the context body. Read-only.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            task: { type: 'string' },
+            framework: { type: 'string' },
+            area: { type: 'string' },
+            tags: { type: 'array', items: { type: 'string' } },
+            scope: { type: 'array', items: { type: 'string' } },
+            maxTokens: { type: 'integer', minimum: 100 },
+            includeExamples: { type: 'boolean' },
+            includeTemplates: { type: 'boolean' },
+            includeRules: { type: 'boolean' },
+            includePaths: { type: 'boolean' },
+            includeDocs: { type: 'boolean' },
+        },
+        required: ['task'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const overview = buildProjectOverview(ctx.inspection.workspace, ctx.inspection.config?.projectName);
+        const result = buildContext(ctx.inspection.knowledgeEntries, {
+            task: String(input.task),
+            framework: typeof input.framework === 'string' ? input.framework : undefined,
+            area: typeof input.area === 'string' ? input.area : undefined,
+            tags: input.tags,
+            scope: input.scope,
+            maxTokens: typeof input.maxTokens === 'number' ? input.maxTokens : undefined,
+            includeExamples: input.includeExamples,
+            includeTemplates: input.includeTemplates,
+            includeRules: input.includeRules,
+            includePaths: input.includePaths,
+            includeDocs: input.includeDocs,
+            projectOverview: renderOverviewText(overview),
+        });
+        return {
+            text: result.body,
+            data: {
+                totalTokens: result.totalTokens,
+                maxTokens: result.maxTokens,
+                omittedSections: result.omittedSections,
+                sections: result.sections.map((s) => ({
+                    title: s.title,
+                    tokens: s.tokens,
+                    truncated: s.truncated ?? false,
+                    entryIds: s.entryIds,
+                })),
+            },
+        };
+    },
+};

package/dist/tools/get-relevant-rules.tool.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-relevant-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-relevant-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,oBAAoB,EAAE,eAmClC,CAAC"}

package/dist/tools/get-relevant-rules.tool.js

@@ -0,0 +1,37 @@
+import { formatRulesForAi } from '@shrkcrft/rules';
+export const getRelevantRulesTool = {
+    name: 'get_relevant_rules',
+    description: 'Return rules relevant to the current task. Optionally include scope/tags/appliesWhen.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            task: { type: 'string' },
+            scope: { type: 'array', items: { type: 'string' } },
+            tags: { type: 'array', items: { type: 'string' } },
+            appliesWhen: { type: 'array', items: { type: 'string' } },
+            limit: { type: 'integer', minimum: 1 },
+        },
+        required: ['task'],
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const rules = ctx.inspection.ruleService.getRelevant(String(input.task), {
+            scope: input.scope,
+            tags: input.tags,
+            appliesWhen: input.appliesWhen,
+            limit: typeof input.limit === 'number' ? input.limit : 10,
+        });
+        return {
+            data: rules.map((r) => ({
+                id: r.id,
+                title: r.title,
+                priority: r.priority,
+                tags: r.tags,
+                appliesWhen: r.appliesWhen,
+                content: r.content,
+                actionHints: r.actionHints,
+            })),
+            text: formatRulesForAi(rules),
+        };
+    },
+};

package/dist/tools/get-repository-commands.tool.d.ts

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

package/dist/tools/get-repository-commands.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-repository-commands.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-repository-commands.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,yBAAyB,EAAE,eAsBvC,CAAC"}