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

package/dist/tools/get-arch-violations.tool.js

@@ -0,0 +1,30 @@
+import { runArchCheck } from '@shrkcrft/architecture-guard';
+export const getArchViolationsTool = {
+    name: 'get_arch_violations',
+    description: 'Run the architecture-guard checks (public-API misuse, barrel risks, cycle severity) against the code graph. Reads `sharkcraft/arch.ts` if present for project-specific contracts. Read-only.',
+    cliCommand: 'arch check',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            enable: {
+                type: 'object',
+                properties: {
+                    publicApi: { type: 'boolean' },
+                    barrels: { type: 'boolean' },
+                    cycles: { type: 'boolean' },
+                    contract: { type: 'boolean' },
+                },
+                additionalProperties: false,
+            },
+        },
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const report = runArchCheck({
+            projectRoot: ctx.inspection.projectRoot,
+            ...(args.enable ? { enable: args.enable } : {}),
+        });
+        return { data: report };
+    },
+};

package/dist/tools/get-code-intelligence-state.tool.d.ts

@@ -0,0 +1,11 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * Read-only MCP mirror of `shrk code-intel`. Returns the same 14
+ * code-intelligence doctor findings in one shot — agents can pull
+ * the entire state without iterating `shrk doctor`'s full check list.
+ *
+ * Stable output schema (`sharkcraft.code-intelligence-state/v1`) so
+ * downstream renderers (dashboard, CI bots) can rely on the shape.
+ */
+export declare const getCodeIntelligenceStateTool: IToolDefinition;
+//# sourceMappingURL=get-code-intelligence-state.tool.d.ts.map

package/dist/tools/get-code-intelligence-state.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-code-intelligence-state.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-code-intelligence-state.tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AASpE;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,eAiC1C,CAAC"}

package/dist/tools/get-code-intelligence-state.tool.js

@@ -0,0 +1,59 @@
+import { buildCodeIntelligenceChecks, DoctorSeverity, } from '@shrkcrft/inspector';
+/**
+ * Read-only MCP mirror of `shrk code-intel`. Returns the same 14
+ * code-intelligence doctor findings in one shot — agents can pull
+ * the entire state without iterating `shrk doctor`'s full check list.
+ *
+ * Stable output schema (`sharkcraft.code-intelligence-state/v1`) so
+ * downstream renderers (dashboard, CI bots) can rely on the shape.
+ */
+export const getCodeIntelligenceStateTool = {
+    name: 'get_code_intelligence_state',
+    description: 'Return all code-intelligence doctor findings (graph, rule-graph, api-surface, quality-gate, migrations, architecture, impact, framework, structural-search, context-planner) in one payload. Read-only.',
+    cliCommand: 'code-intel',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            only: { type: 'array', items: { type: 'string' } },
+            checkId: { type: 'string' },
+        },
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        let checks = buildCodeIntelligenceChecks(ctx.inspection.projectRoot);
+        if (args.checkId) {
+            checks = checks.filter((c) => c.id === args.checkId);
+        }
+        if (args.only && args.only.length > 0) {
+            const allowed = new Set(args.only.map((s) => s.toLowerCase()));
+            checks = checks.filter((c) => allowed.has(c.severity));
+        }
+        const summary = summarize(checks);
+        return {
+            data: {
+                schema: 'sharkcraft.code-intelligence-state/v1',
+                totalChecks: checks.length,
+                summary,
+                checks,
+            },
+        };
+    },
+};
+function summarize(checks) {
+    let ok = 0;
+    let info = 0;
+    let warnings = 0;
+    let errors = 0;
+    for (const c of checks) {
+        if (c.severity === DoctorSeverity.Ok)
+            ok += 1;
+        else if (c.severity === DoctorSeverity.Info)
+            info += 1;
+        else if (c.severity === DoctorSeverity.Warning)
+            warnings += 1;
+        else if (c.severity === DoctorSeverity.Error)
+            errors += 1;
+    }
+    return { ok, info, warnings, errors };
+}

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

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

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

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

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

@@ -0,0 +1,40 @@
+import { planContext } from '@shrkcrft/context-planner';
+export const getContextPackTool = {
+    name: 'get_context_pack',
+    description: 'Produce a deterministic, token-budgeted context pack (`sharkcraft.context-pack/v1`) for an AI coding agent: ranked relevant files, applicable rules, paths, templates, likely tests, surfaced risks, do-not-touch zones. Read-only.',
+    cliCommand: 'plan-context',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            task: { type: 'string' },
+            budgetTokens: { type: 'number' },
+            hintedFiles: { type: 'array', items: { type: 'string' } },
+            hintedPackages: { type: 'array', items: { type: 'string' } },
+            maxFiles: { type: 'number' },
+        },
+        required: ['task'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const task = (args.task ?? '').trim();
+        if (!task) {
+            return {
+                isError: true,
+                error: { code: 'invalid-input', message: 'task is required' },
+            };
+        }
+        const pack = planContext({
+            projectRoot: ctx.inspection.projectRoot,
+            task,
+            budgetTokens: clamp(args.budgetTokens ?? 8000, 500, 64000),
+            maxFiles: clamp(args.maxFiles ?? 30, 1, 200),
+            ...(args.hintedFiles ? { hintedFiles: args.hintedFiles } : {}),
+            ...(args.hintedPackages ? { hintedPackages: args.hintedPackages } : {}),
+        });
+        return { data: pack };
+    },
+};
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}

package/dist/tools/get-framework-entities.tool.d.ts

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

package/dist/tools/get-framework-entities.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-framework-entities.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-framework-entities.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAYpE,eAAO,MAAM,wBAAwB,EAAE,eA+DtC,CAAC"}

package/dist/tools/get-framework-entities.tool.js

@@ -0,0 +1,68 @@
+import { FrameworkQueryApi } from '@shrkcrft/framework-scanners';
+const NEXT = 'shrk framework index';
+export const getFrameworkEntitiesTool = {
+    name: 'get_framework_entities',
+    description: 'Read-only: list framework entities discovered by the extractors (NestJS controllers/modules/providers/routes, React components/hook usages). Filters: framework, subtype, file. Pass `routes: true` for the NestJS route table.',
+    cliCommand: 'framework list',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            framework: { type: 'string' },
+            subtype: { type: 'string' },
+            file: { type: 'string' },
+            limit: { type: 'number' },
+            routes: { type: 'boolean' },
+        },
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const missing = FrameworkQueryApi.missingDescription(ctx.inspection.projectRoot);
+        if (missing) {
+            return {
+                isError: true,
+                error: { code: 'framework-missing', message: missing, details: { nextCommand: NEXT } },
+            };
+        }
+        const api = FrameworkQueryApi.fromStore(ctx.inspection.projectRoot);
+        if (args.routes) {
+            const routes = api.routes();
+            return {
+                data: {
+                    schema: 'sharkcraft.framework-routes/v1',
+                    total: routes.length,
+                    routes,
+                },
+            };
+        }
+        const limit = clamp(args.limit ?? 100, 1, 2000);
+        const entities = api.list({
+            ...(args.framework ? { framework: args.framework } : {}),
+            ...(args.subtype ? { subtype: args.subtype } : {}),
+            ...(args.file ? { file: args.file } : {}),
+            limit,
+        });
+        return {
+            data: {
+                schema: 'sharkcraft.framework-list/v1',
+                filters: {
+                    framework: args.framework ?? null,
+                    subtype: args.subtype ?? null,
+                    file: args.file ?? null,
+                },
+                total: entities.length,
+                entities: entities.map((n) => ({
+                    id: n.id,
+                    label: n.label,
+                    path: n.path,
+                    framework: n.data?.['framework'] ?? null,
+                    subtype: n.data?.['subtype'] ?? null,
+                    data: n.data,
+                })),
+            },
+        };
+    },
+};
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}

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

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

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

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

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

@@ -0,0 +1,80 @@
+import { GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+const NEXT = 'shrk graph index';
+export const getGraphCallersTool = {
+    name: 'get_graph_callers',
+    description: 'Return files that call or reference the given symbol. Mode "call" → calls-symbol edges; mode "reference" → both references-symbol and calls-symbol. Read-only.',
+    cliCommand: 'graph callers',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            symbol: { type: 'string' },
+            mode: { type: 'string', enum: ['call', 'reference'] },
+        },
+        required: ['symbol'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const target = (args.symbol ?? '').trim();
+        if (!target) {
+            return {
+                isError: true,
+                error: { code: 'invalid-input', message: 'symbol is required' },
+            };
+        }
+        const mode = args.mode ?? 'call';
+        const store = new GraphStore(ctx.inspection.projectRoot);
+        if (!store.exists()) {
+            return {
+                isError: true,
+                error: {
+                    code: 'graph-missing',
+                    message: `Code-intelligence index is missing. Run '${NEXT}'.`,
+                    details: { nextCommand: NEXT },
+                },
+            };
+        }
+        const api = GraphQueryApi.fromStore(ctx.inspection.projectRoot);
+        const sym = resolveSymbol(api, target);
+        if (!sym) {
+            return {
+                isError: true,
+                error: {
+                    code: 'not-found',
+                    message: `No symbol matched "${target}".`,
+                    details: { target },
+                },
+            };
+        }
+        const hits = mode === 'reference' ? api.referencesOf(sym.id) : api.callersOf(sym.id);
+        return {
+            data: {
+                schema: 'sharkcraft.graph-callers/v1',
+                symbol: summarise(sym),
+                mode,
+                total: hits.length,
+                callers: hits.slice(0, 200).map(summarise),
+            },
+        };
+    },
+};
+function resolveSymbol(api, target) {
+    if (target.startsWith('symbol:'))
+        return api.neighbours(target)?.node;
+    const syms = api.findSymbol(target, { exact: true, limit: 5 });
+    if (syms.length === 0)
+        return undefined;
+    if (syms.length === 1)
+        return syms[0];
+    const exported = syms.find((s) => (s.data?.['isExported'] ?? false) === true);
+    return exported ?? syms[0];
+}
+function summarise(n) {
+    return {
+        id: n.id,
+        kind: n.kind,
+        label: n.label,
+        ...(n.path ? { path: n.path } : {}),
+        ...(n.line ? { line: n.line } : {}),
+    };
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-graph-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-context.tool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE,eAAO,MAAM,mBAAmB,EAAE,eAiEjC,CAAC"}

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

@@ -0,0 +1,91 @@
+import { GraphQueryApi, GraphStore, NodeKind, } from '@shrkcrft/graph';
+const NEXT = 'shrk graph index';
+export const getGraphContextTool = {
+    name: 'get_graph_context',
+    description: 'Return graph context for a file or symbol: declared symbols, files this imports, files that import it. Read-only.',
+    cliCommand: 'graph context',
+    inputSchema: {
+        type: 'object',
+        properties: { target: { type: 'string' } },
+        required: ['target'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const target = (args.target ?? '').trim();
+        if (!target) {
+            return {
+                isError: true,
+                error: { code: 'invalid-input', message: 'target is required' },
+            };
+        }
+        const store = new GraphStore(ctx.inspection.projectRoot);
+        if (!store.exists()) {
+            return {
+                isError: true,
+                error: {
+                    code: 'graph-missing',
+                    message: `Code-intelligence index is missing. Run '${NEXT}'.`,
+                    details: { nextCommand: NEXT },
+                },
+            };
+        }
+        const api = GraphQueryApi.fromStore(ctx.inspection.projectRoot);
+        const anchor = resolveAnchor(api, target);
+        if (!anchor) {
+            return {
+                isError: true,
+                error: {
+                    code: 'not-found',
+                    message: `No graph node matched "${target}".`,
+                    details: { target },
+                },
+            };
+        }
+        const neighbours = api.neighbours(anchor.id);
+        const symbols = anchor.kind === NodeKind.File ? api.symbolsIn(anchor.id) : [];
+        return {
+            data: {
+                schema: 'sharkcraft.graph-context/v1',
+                anchor: summarise(anchor),
+                importsFrom: neighbours.out
+                    .filter((o) => o.edge.kind === 'imports-file')
+                    .slice(0, 50)
+                    .map((o) => ('resolved' in o.target
+                    ? { id: o.target.id, resolved: false }
+                    : { ...summarise(o.target), resolved: true })),
+                importedBy: neighbours.in
+                    .filter((i) => i.edge.kind === 'imports-file')
+                    .slice(0, 50)
+                    .map((i) => ('resolved' in i.source
+                    ? { id: i.source.id, resolved: false }
+                    : { ...summarise(i.source), resolved: true })),
+                symbols: symbols.slice(0, 50).map(summarise),
+            },
+        };
+    },
+};
+function resolveAnchor(api, target) {
+    const direct = api.neighbours(target);
+    if (direct)
+        return direct.node;
+    if (target.startsWith('file:') || target.startsWith('symbol:') || target.startsWith('package:')) {
+        return undefined;
+    }
+    const f = api.findFile(target);
+    if (f)
+        return f;
+    const syms = api.findSymbol(target, { exact: true, limit: 1 });
+    if (syms.length > 0)
+        return syms[0];
+    return undefined;
+}
+function summarise(n) {
+    return {
+        id: n.id,
+        kind: n.kind,
+        label: n.label,
+        ...(n.path ? { path: n.path } : {}),
+        ...(n.line ? { line: n.line } : {}),
+    };
+}

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

@@ -0,0 +1,10 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * Read-only MCP mirror of `shrk graph cycles`. Returns the full SCC
+ * list (sorted by size desc) so agents can answer "show me every
+ * import cycle in this repo" in a single tool call. Mirrors the safety
+ * contract: read-only, structured error with nextCommand when state
+ * is missing.
+ */
+export declare const getGraphCyclesTool: IToolDefinition;
+//# sourceMappingURL=get-graph-cycles.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-graph-cycles.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-cycles.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAWpE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAmDhC,CAAC"}

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

@@ -0,0 +1,57 @@
+import { GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+const NEXT = 'shrk graph index';
+/**
+ * Read-only MCP mirror of `shrk graph cycles`. Returns the full SCC
+ * list (sorted by size desc) so agents can answer "show me every
+ * import cycle in this repo" in a single tool call. Mirrors the safety
+ * contract: read-only, structured error with nextCommand when state
+ * is missing.
+ */
+export const getGraphCyclesTool = {
+    name: 'get_graph_cycles',
+    description: 'Return every import cycle in the code graph (strongly-connected components of size ≥ 2 over `imports-file` edges). Sorted by size desc. Read-only.',
+    cliCommand: 'graph cycles',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: { type: 'number' },
+            minSize: { type: 'number' },
+        },
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const rawLimit = typeof args.limit === 'number' && Number.isFinite(args.limit) && args.limit > 0
+            ? args.limit
+            : 50;
+        const minSize = typeof args.minSize === 'number' && Number.isFinite(args.minSize) && args.minSize >= 2
+            ? args.minSize
+            : 2;
+        const store = new GraphStore(ctx.inspection.projectRoot);
+        if (!store.exists()) {
+            return {
+                isError: true,
+                error: {
+                    code: 'graph-missing',
+                    message: `Code-intelligence index is missing. Run '${NEXT}'.`,
+                    details: { nextCommand: NEXT },
+                },
+            };
+        }
+        const api = GraphQueryApi.fromStore(ctx.inspection.projectRoot);
+        const all = api.cycles();
+        const filtered = all.filter((c) => c.size >= minSize);
+        const limited = filtered.slice(0, rawLimit);
+        return {
+            data: {
+                schema: 'sharkcraft.graph-cycles/v1',
+                total: filtered.length,
+                truncated: filtered.length > rawLimit,
+                cycles: limited.map((c) => ({
+                    size: c.size,
+                    paths: c.paths ?? c.nodeIds.map((id) => id.replace(/^file:/, '')),
+                })),
+            },
+        };
+    },
+};

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

@@ -0,0 +1,12 @@
+import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * Read-only MCP mirror of `shrk graph deps`. Returns the workspace
+ * package's outbound (`depends on`) and inbound (`depended on by`)
+ * `package-depends-on` edges from the persisted code graph.
+ *
+ * Mirrors the safety contract: structured `graph-missing` error when
+ * the index isn't built; `not-found` when no `package:<name>` node
+ * exists.
+ */
+export declare const getGraphDepsTool: IToolDefinition;
+//# sourceMappingURL=get-graph-deps.tool.d.ts.map

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

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

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

@@ -0,0 +1,80 @@
+import { EdgeKind, GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+const NEXT = 'shrk graph index';
+/**
+ * Read-only MCP mirror of `shrk graph deps`. Returns the workspace
+ * package's outbound (`depends on`) and inbound (`depended on by`)
+ * `package-depends-on` edges from the persisted code graph.
+ *
+ * Mirrors the safety contract: structured `graph-missing` error when
+ * the index isn't built; `not-found` when no `package:<name>` node
+ * exists.
+ */
+export const getGraphDepsTool = {
+    name: 'get_graph_deps',
+    description: 'Return inbound + outbound `package-depends-on` edges for a workspace package. Read-only.',
+    cliCommand: 'graph deps',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            package: { type: 'string' },
+        },
+        required: ['package'],
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        const target = (args.package ?? '').trim();
+        if (!target) {
+            return {
+                isError: true,
+                error: { code: 'invalid-input', message: 'package is required' },
+            };
+        }
+        const store = new GraphStore(ctx.inspection.projectRoot);
+        if (!store.exists()) {
+            return {
+                isError: true,
+                error: {
+                    code: 'graph-missing',
+                    message: `Code-intelligence index is missing. Run '${NEXT}'.`,
+                    details: { nextCommand: NEXT },
+                },
+            };
+        }
+        const api = GraphQueryApi.fromStore(ctx.inspection.projectRoot);
+        const pkgId = `package:${target}`;
+        const pkgNode = api.neighbours(pkgId)?.node;
+        if (!pkgNode) {
+            return {
+                isError: true,
+                error: {
+                    code: 'not-found',
+                    message: `No workspace package node "${target}" in the graph.`,
+                    details: { target },
+                },
+            };
+        }
+        const dependsOn = api
+            .packageDeps(target)
+            .map((n) => n.id.replace(/^package:/, ''))
+            .sort();
+        const dependedOnBy = [];
+        for (const p of api.allPackages()) {
+            const name = p.id.replace(/^package:/, '');
+            if (name === target)
+                continue;
+            if (api.packageDeps(name).some((n) => n.id === pkgId))
+                dependedOnBy.push(name);
+        }
+        dependedOnBy.sort();
+        void EdgeKind;
+        return {
+            data: {
+                schema: 'sharkcraft.graph-deps/v1',
+                package: target,
+                dependsOn,
+                dependedOnBy,
+            },
+        };
+    },
+};

package/dist/tools/get-graph-impact-analysis.tool.d.ts

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

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

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

package/dist/tools/get-graph-impact-analysis.tool.js

@@ -0,0 +1,42 @@
+import { analyzeGraphImpact } from '@shrkcrft/impact-engine';
+export const getGraphImpactAnalysisTool = {
+    name: 'get_graph_impact_analysis',
+    description: 'Rich graph-backed change analysis (schema sharkcraft.graph-impact-analysis/v3). Inputs: file list OR symbol OR git ref. Returns affected symbols/files/packages/rules/templates/tests/risk + recommended validation commands. Read-only.',
+    cliCommand: 'graph impact',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            files: { type: 'array', items: { type: 'string' } },
+            symbol: { type: 'string' },
+            gitref: { type: 'string' },
+            maxDepth: { type: 'number' },
+            limit: { type: 'number' },
+        },
+        additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const args = input;
+        let resolved;
+        if (args.files && args.files.length > 0)
+            resolved = { kind: 'files', files: args.files };
+        else if (args.symbol)
+            resolved = { kind: 'symbol', symbolId: args.symbol };
+        else if (args.gitref)
+            resolved = { kind: 'gitref', ref: args.gitref };
+        if (!resolved) {
+            return {
+                isError: true,
+                error: { code: 'invalid-input', message: 'One of `files`, `symbol`, or `gitref` is required.' },
+            };
+        }
+        const analysis = analyzeGraphImpact(resolved, {
+            projectRoot: ctx.inspection.projectRoot,
+            limit: clamp(args.limit ?? 200, 1, 2000),
+            maxDepth: clamp(args.maxDepth ?? 5, 1, 10),
+        });
+        return { data: analysis };
+    },
+};
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}

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

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

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

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