@yalehwang/archguard 0.1.23 → 0.1.32

package/dist/cli/mcp/tools/atlas-analytics-tools.js

@@ -0,0 +1,190 @@
+import { z } from 'zod';
+import path from 'path';
+import { loadEngine } from '../../query/engine-loader.js';
+import { resolveRoot } from '../mcp-server.js';
+import { computePackageFanMetrics, enrichPackageNodes, } from '../../../analysis/atlas-metrics-analysis.js';
+export { computePackageFanMetrics, enrichPackageNodes };
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerAtlasAnalyticsTools(server, defaultRoot) {
+    server.tool('archguard_get_package_fanin', 'List Go Atlas packages ranked by fan-in (number of packages that depend on them). ' +
+        'High fan-in packages are critical hub packages. Requires an Atlas-mode Go project.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        scope: z
+            .string()
+            .optional()
+            .describe('Query scope key. Omit to use manifest.globalScopeKey.'),
+        minFanIn: z.coerce
+            .number()
+            .min(0)
+            .default(0)
+            .optional()
+            .describe('Exclude packages with fan-in below this threshold.'),
+        limit: z.coerce
+            .number()
+            .min(1)
+            .max(200)
+            .default(20)
+            .optional()
+            .describe('Maximum number of packages to return (default: 20).'),
+    }, async ({ projectRoot, scope, minFanIn, limit }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const archDir = path.join(root, '.archguard');
+            const { extensionAccessor } = await loadEngine(archDir, scope);
+            if (!extensionAccessor.hasAtlasExtension()) {
+                return textResponse('No Atlas data found. This tool requires a Go project analyzed with Atlas mode.\n' +
+                    `Run: archguard_analyze({ projectRoot: "${root}", lang: "go" })`);
+            }
+            const graph = extensionAccessor.getAtlasLayer('package');
+            if (!graph || graph.nodes.length === 0) {
+                return textResponse('No package data available in the Atlas package layer.');
+            }
+            const { fanIn, fanOut } = computePackageFanMetrics(graph);
+            let enriched = enrichPackageNodes(graph.nodes, fanIn, fanOut);
+            const threshold = minFanIn ?? 0;
+            if (threshold > 0) {
+                enriched = enriched.filter((n) => n.fanIn >= threshold);
+            }
+            enriched.sort((a, b) => b.fanIn - a.fanIn);
+            enriched = enriched.slice(0, limit ?? 20);
+            return textResponse(JSON.stringify({ packages: enriched }, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResponse(`Error: ${msg}`);
+        }
+    });
+    server.tool('archguard_get_package_fanout', 'List Go Atlas packages ranked by fan-out (number of packages they depend on). ' +
+        'High fan-out packages have many dependencies and may be fragile. Requires an Atlas-mode Go project.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        scope: z
+            .string()
+            .optional()
+            .describe('Query scope key. Omit to use manifest.globalScopeKey.'),
+        minFanOut: z.coerce
+            .number()
+            .min(0)
+            .default(0)
+            .optional()
+            .describe('Exclude packages with fan-out below this threshold.'),
+        limit: z.coerce
+            .number()
+            .min(1)
+            .max(200)
+            .default(20)
+            .optional()
+            .describe('Maximum number of packages to return (default: 20).'),
+    }, async ({ projectRoot, scope, minFanOut, limit }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const archDir = path.join(root, '.archguard');
+            const { extensionAccessor } = await loadEngine(archDir, scope);
+            if (!extensionAccessor.hasAtlasExtension()) {
+                return textResponse('No Atlas data found. This tool requires a Go project analyzed with Atlas mode.\n' +
+                    `Run: archguard_analyze({ projectRoot: "${root}", lang: "go" })`);
+            }
+            const graph = extensionAccessor.getAtlasLayer('package');
+            if (!graph || graph.nodes.length === 0) {
+                return textResponse('No package data available in the Atlas package layer.');
+            }
+            const { fanIn, fanOut } = computePackageFanMetrics(graph);
+            let enriched = enrichPackageNodes(graph.nodes, fanIn, fanOut);
+            const threshold = minFanOut ?? 0;
+            if (threshold > 0) {
+                enriched = enriched.filter((n) => n.fanOut >= threshold);
+            }
+            enriched.sort((a, b) => b.fanOut - a.fanOut);
+            enriched = enriched.slice(0, limit ?? 20);
+            return textResponse(JSON.stringify({ packages: enriched }, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResponse(`Error: ${msg}`);
+        }
+    });
+    server.tool('archguard_detect_god_packages', 'Detect "god packages" — packages that violate single-responsibility by exceeding size or coupling thresholds. ' +
+        'Each flagged package includes a list of violated thresholds (reasons). Requires an Atlas-mode Go project.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        scope: z
+            .string()
+            .optional()
+            .describe('Query scope key. Omit to use manifest.globalScopeKey.'),
+        minFanIn: z.coerce
+            .number()
+            .min(0)
+            .default(5)
+            .optional()
+            .describe('Fan-in threshold — packages at or above this value are flagged (default: 5).'),
+        minStructs: z.coerce
+            .number()
+            .min(0)
+            .default(20)
+            .optional()
+            .describe('Struct count threshold (default: 20). Ignored when node has no stats.'),
+        minFunctions: z.coerce
+            .number()
+            .min(0)
+            .default(50)
+            .optional()
+            .describe('Function count threshold (default: 50). Ignored when node has no stats.'),
+        minFiles: z.coerce
+            .number()
+            .min(0)
+            .default(20)
+            .optional()
+            .describe('File count threshold (default: 20).'),
+    }, async ({ projectRoot, scope, minFanIn, minStructs, minFunctions, minFiles }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const archDir = path.join(root, '.archguard');
+            const { extensionAccessor } = await loadEngine(archDir, scope);
+            if (!extensionAccessor.hasAtlasExtension()) {
+                return textResponse('No Atlas data found. This tool requires a Go project analyzed with Atlas mode.\n' +
+                    `Run: archguard_analyze({ projectRoot: "${root}", lang: "go" })`);
+            }
+            const graph = extensionAccessor.getAtlasLayer('package');
+            if (!graph || graph.nodes.length === 0) {
+                return textResponse('No package data available in the Atlas package layer.');
+            }
+            const { fanIn, fanOut } = computePackageFanMetrics(graph);
+            const enriched = enrichPackageNodes(graph.nodes, fanIn, fanOut);
+            const fanInThreshold = minFanIn ?? 5;
+            const structsThreshold = minStructs ?? 20;
+            const functionsThreshold = minFunctions ?? 50;
+            const filesThreshold = minFiles ?? 20;
+            const godPackages = enriched
+                .map((node) => {
+                const reasons = [];
+                if (node.fanIn >= fanInThreshold && fanInThreshold > 0)
+                    reasons.push('highFanIn');
+                if (node.stats !== undefined) {
+                    if (node.stats.structs >= structsThreshold && structsThreshold > 0)
+                        reasons.push('tooManyStructs');
+                    if (node.stats.functions >= functionsThreshold && functionsThreshold > 0)
+                        reasons.push('tooManyFunctions');
+                }
+                if (node.fileCount >= filesThreshold && filesThreshold > 0)
+                    reasons.push('tooManyFiles');
+                return { ...node, reasons };
+            })
+                .filter((node) => node.reasons.length > 0);
+            return textResponse(JSON.stringify({ godPackages }, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResponse(`Error: ${msg}`);
+        }
+    });
+}
+//# sourceMappingURL=atlas-analytics-tools.js.map

package/dist/cli/mcp/tools/atlas-analytics-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-analytics-tools.js","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/atlas-analytics-tools.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp/tools/call-graph-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCallGraphTools(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=call-graph-tools.d.ts.map

package/dist/cli/mcp/tools/call-graph-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/call-graph-tools.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA8CnF"}

package/dist/cli/mcp/tools/call-graph-tools.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import path from 'path';
+import { loadEngine } from '../../query/engine-loader.js';
+import { resolveRoot } from '../mcp-server.js';
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerCallGraphTools(server, defaultRoot) {
+    server.tool('archguard_find_callers', 'Return direct and transitive callers of an entity or method using ' +
+        'statically-extracted call edges; call archguard_analyze first. ' +
+        'Precision: TypeScript ~85% (TypeChecker-resolved; parseProject path only — ' +
+        'parseCode and ParallelParser paths do not generate call edges), ' +
+        'Go ~90% (gopls-assisted; entry-point-reachable paths only), ' +
+        'Java ~60% (tree-sitter heuristic; field-type resolution only), ' +
+        'Python ~40% (duck-typed; self.field calls only). ' +
+        'Dynamic dispatch, callbacks, and reflection are not resolved.', {
+        entityName: z
+            .string()
+            .describe('Entity name to find callers for. Use "ClassName" or "ClassName.methodName" for method-level filtering.'),
+        depth: z
+            .number()
+            .int()
+            .min(1)
+            .max(5)
+            .default(1)
+            .optional()
+            .describe('BFS depth (1–5, default: 1). Values outside range are clamped.'),
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+    }, async ({ entityName, depth, projectRoot }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const archDir = path.join(root, '.archguard');
+            const { relationQueryService } = await loadEngine(archDir);
+            const callers = relationQueryService.findCallers(entityName, depth ?? 1);
+            return textResponse(JSON.stringify({ entityName, depth: depth ?? 1, callers }, null, 2));
+        }
+        catch {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            return textResponse(`No analysis data found for project at "${root}".\n` +
+                `Run archguard_analyze({ projectRoot: "${root}" }) first.`);
+        }
+    });
+}
+//# sourceMappingURL=call-graph-tools.js.map

package/dist/cli/mcp/tools/call-graph-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph-tools.js","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/call-graph-tools.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,WAAmB;IAC3E,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,oEAAoE;QAClE,iEAAiE;QACjE,6EAA6E;QAC7E,kEAAkE;QAClE,8DAA8D;QAC9D,iEAAiE;QACjE,mDAAmD;QACnD,+DAA+D,EACjE;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CACP,wGAAwG,CACzG;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,gEAAgE,CAAC;QAC7E,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,+EAA+E,CAAC;KAC7F,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC9C,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;YACzE,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACnD,OAAO,YAAY,CACjB,0CAA0C,IAAI,MAAM;gBAClD,yCAAyC,IAAI,aAAa,CAC7D,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/cli/mcp/tools/ccb-tool.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCcbTool(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=ccb-tool.d.ts.map

package/dist/cli/mcp/tools/ccb-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-tool.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/ccb-tool.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAgE5E"}

package/dist/cli/mcp/tools/ccb-tool.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import path from 'path';
+import { resolveRoot } from '../mcp-server.js';
+import { assembleCcb, filePathToId } from '../../cognitive/ccb-assembler.js';
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerCcbTool(server, defaultRoot) {
+    server.tool('archguard_get_ccb', 'Return a Cognitive Context Bundle (CCB) for a source file. ' +
+        'The CCB combines structural digest (method/field counts, in/out degree), ' +
+        'git history signals (risk level, hotspot score), behavioral signals ' +
+        '(read/edit counts from agent history), and documentation freshness signals. ' +
+        'Bundles are SHA-256-keyed and cached in .archguard/cognitive/; ' +
+        'they are invalidated automatically when the source file changes. ' +
+        'Call with forceRefresh:true to bypass the cache. ' +
+        'DOCUMENTATION SIGNALS: The returned bundle includes a `documentation` field with ' +
+        '`docFreshnessGap` (fraction of co-changed files that are docs; null if no data), ' +
+        '`docVoid` (true when session history shows edits without doc reads), and ' +
+        '`specPrecisionGap` (true when spec docs were not consulted before editing). ' +
+        'NOTE: `documentation.deFactoSpec` and `documentation.freshnessWarning` are ' +
+        'ALWAYS null in stored CCBs — these are LLM-layer responsibilities. ' +
+        'When you receive a CCB with docVoid=true or docFreshnessGap < 0.3, you should ' +
+        'generate deFactoSpec by reading the co-changed doc files listed in git.cochangeNeighbors, ' +
+        'and generate a freshnessWarning to alert the user that documentation may be stale.', {
+        filePath: z
+            .string()
+            .describe('Path to the source file (relative to projectRoot or absolute).'),
+        archDir: z
+            .string()
+            .optional()
+            .describe('Path to .archguard directory (default: <projectRoot>/.archguard).'),
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        forceRefresh: z
+            .boolean()
+            .optional()
+            .describe('When true, bypass the CCB cache and reassemble from scratch.'),
+    }, async ({ filePath, archDir, projectRoot, forceRefresh }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const resolvedArchDir = archDir
+                ? path.isAbsolute(archDir)
+                    ? archDir
+                    : path.resolve(root, archDir)
+                : path.join(root, '.archguard');
+            const resolvedFilePath = path.isAbsolute(filePath)
+                ? filePath
+                : path.resolve(root, filePath);
+            const fileId = filePathToId(filePath);
+            const bundle = await assembleCcb(fileId, resolvedFilePath, resolvedArchDir, {
+                forceRefresh,
+            });
+            return textResponse(JSON.stringify(bundle, null, 2));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return textResponse(`Error: ${message}`);
+        }
+    });
+}
+//# sourceMappingURL=ccb-tool.js.map

package/dist/cli/mcp/tools/ccb-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccb-tool.js","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/ccb-tool.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAE7E,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,WAAmB;IAEpE,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,6DAA6D;QAC3D,2EAA2E;QAC3E,sEAAsE;QACtE,8EAA8E;QAC9E,iEAAiE;QACjE,mEAAmE;QACnE,mDAAmD;QACnD,mFAAmF;QACnF,mFAAmF;QACnF,2EAA2E;QAC3E,8EAA8E;QAC9E,6EAA6E;QAC7E,qEAAqE;QACrE,gFAAgF;QAChF,4FAA4F;QAC5F,oFAAoF,EACtF;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,CAAC,gEAAgE,CAAC;QAC7E,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,mEAAmE,CAAC;QAChF,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,+EAA+E,CAAC;QAC5F,YAAY,EAAE,CAAC;aACZ,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;KAC5E,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE;QACzD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACnD,MAAM,eAAe,GAAG,OAAO;gBAC7B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;oBACxB,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAGlC,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAChD,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAEjC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YAEtC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE;gBAC1E,YAAY;aACb,CAAC,CAAC;YAEH,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACrE,OAAO,YAAY,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/cli/mcp/tools/cognitive-summary-tool.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCognitiveSummaryTool(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=cognitive-summary-tool.d.ts.map

package/dist/cli/mcp/tools/cognitive-summary-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-summary-tool.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/cognitive-summary-tool.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA8IzF"}

package/dist/cli/mcp/tools/cognitive-summary-tool.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import path from 'path';
+import { loadEngine } from '../../query/engine-loader.js';
+import { resolveRoot } from '../mcp-server.js';
+import { loadHistoryData } from '../../git-history/history-loader.js';
+import { HistoryQuery } from '../../git-history/history-query.js';
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerCognitiveSummaryTool(server, defaultRoot) {
+    server.tool('archguard_get_cognitive_summary', 'Return a compact structural digest for each requested entity name from .archguard/ artifacts. ' +
+        'For each entity: method/field counts, in/out degree, top-5 dependents and dependencies, ' +
+        'static test coverage ratio (null when test artifacts absent), and git risk level ' +
+        '(null when git artifacts absent). Missing entities return { name, found: false }. ' +
+        'Payload is < 2 KB per entity. No LLM calls are made — pure mechanical aggregation.', {
+        entities: z
+            .array(z.string())
+            .min(1)
+            .max(20)
+            .describe('Entity names to summarize (1–20 names, exact match).'),
+        archDir: z
+            .string()
+            .optional()
+            .describe('Path to .archguard directory (default: <projectRoot>/.archguard).'),
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+    }, async ({ entities, archDir, projectRoot }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const resolvedArchDir = archDir
+                ? path.isAbsolute(archDir)
+                    ? archDir
+                    : path.resolve(root, archDir)
+                : path.join(root, '.archguard');
+            const { engine, extensionAccessor } = await loadEngine(resolvedArchDir);
+            let historyQuery = null;
+            try {
+                const historyData = await loadHistoryData(resolvedArchDir);
+                historyQuery = new HistoryQuery(historyData);
+            }
+            catch {
+            }
+            const results = [];
+            for (const entityName of entities) {
+                const found = engine.findEntity(entityName);
+                if (!found || found.length === 0) {
+                    results.push({ name: entityName, found: false });
+                    continue;
+                }
+                const entity = found[0];
+                const members = entity.members ?? [];
+                const methodCount = members.filter((m) => m.type === 'method' || m.type === 'constructor').length;
+                const fieldCount = members.filter((m) => m.type === 'property' || m.type === 'field').length;
+                const dependentEntities = engine.applyOutputOptions(engine.relationQueryService.getDependents(entityName, 1), { outputScope: 'class', queryFormat: 'structured' });
+                const dependencyEntities = engine.applyOutputOptions(engine.relationQueryService.getDependencies(entityName, 1), { outputScope: 'class', queryFormat: 'structured' });
+                const inDegree = dependentEntities.length;
+                const outDegree = dependencyEntities.length;
+                const topDependents = dependentEntities.slice(0, 5).map((e) => ({
+                    name: e.name,
+                    type: e.type,
+                }));
+                const topDependencies = dependencyEntities.slice(0, 5).map((e) => ({
+                    name: e.name,
+                    type: e.type,
+                }));
+                let testCoverageRatio = null;
+                try {
+                    if (extensionAccessor.hasTestAnalysis()) {
+                        const coverage = engine.getEntityCoverage(entity.id);
+                        if (coverage.found) {
+                            testCoverageRatio = coverage.coverageScore;
+                        }
+                        else {
+                            testCoverageRatio = null;
+                        }
+                    }
+                }
+                catch {
+                    testCoverageRatio = null;
+                }
+                let gitRiskLevel = null;
+                if (historyQuery !== null) {
+                    try {
+                        const filePath = entity.sourceLocation?.file ?? '';
+                        if (filePath) {
+                            const risk = historyQuery.getChangeRisk('file', filePath);
+                            gitRiskLevel = risk.riskLevel ?? null;
+                        }
+                    }
+                    catch {
+                        gitRiskLevel = null;
+                    }
+                }
+                results.push({
+                    name: entityName,
+                    found: true,
+                    entityId: entity.id,
+                    methodCount,
+                    fieldCount,
+                    inDegree,
+                    outDegree,
+                    topDependents,
+                    topDependencies,
+                    testCoverageRatio,
+                    gitRiskLevel,
+                });
+            }
+            return textResponse(JSON.stringify(results, null, 2));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return textResponse(`Error: ${message}`);
+        }
+    });
+}
+//# sourceMappingURL=cognitive-summary-tool.js.map

package/dist/cli/mcp/tools/cognitive-summary-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-summary-tool.js","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/cognitive-summary-tool.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp/tools/gim-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGIMTools(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=gim-tools.d.ts.map

package/dist/cli/mcp/tools/gim-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gim-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/gim-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAgF7E"}

package/dist/cli/mcp/tools/gim-tools.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import path from 'path';
+import { resolveRoot } from '../mcp-server.js';
+import { loadSnapshots } from '../../../analysis/snapshot-store.js';
+import { computeDirectionHint } from '../../../analysis/gim/direction-hint.js';
+import { computeAllLosses } from '../../../analysis/gim/gim-loss-evaluator.js';
+import { loadEngine } from '../../query/engine-loader.js';
+import { extractPackageName, computePackageFanMetricsFromRelations, } from '../../../analysis/package-metrics-analysis.js';
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+const METHODOLOGY = 'GIM (Geometric Information Methodology) context. All loss values are proxy approximations ' +
+    'derived from MetricVector fields, not full MDL computations. ' +
+    'Direction is based on 2-point snapshot comparison (low confidence). ' +
+    'Use as qualitative signal, not quantitative measurement.';
+export function registerGIMTools(server, defaultRoot) {
+    server.tool('archguard_get_gim_context', 'Return a GIM (Geometric Information Methodology) context bundle for LLM architectural reasoning. ' +
+        'Includes: evolution direction hint (expansion/contraction/stable) from snapshot comparison, ' +
+        'four GIM loss function proxies (feasibility, consistency, description-length, generation-alignment), ' +
+        'and top high-influence packages sorted by fan-in. ' +
+        'All values are proxy approximations from MetricVector fields. ' +
+        'Requires at least one prior archguard analyze run to have generated snapshots.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to MCP server startup cwd.'),
+    }, async ({ projectRoot }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const archDir = path.join(root, '.archguard');
+            const snapshots = await loadSnapshots(archDir);
+            const direction = computeDirectionHint(snapshots);
+            const latestVector = snapshots.length > 0
+                ? snapshots[0].metricVector
+                : {
+                    schemaVersion: 1,
+                    totalEntities: 0,
+                    totalRelations: 0,
+                    inferredRelationRatio: 0,
+                    sccCount: 0,
+                    relationTypeBreakdown: {},
+                    maxInDegree: 0,
+                    maxOutDegree: 0,
+                    maxPackageSize: 0,
+                    giniInDegree: 0,
+                    giniPackageSize: 0,
+                    packageCount: 0,
+                };
+            const losses = computeAllLosses(latestVector);
+            let highInfluencePackages = [];
+            try {
+                const { extensionAccessor } = await loadEngine(archDir);
+                const entityIds = extensionAccessor.getEntityIds();
+                const allPackageNames = new Set(entityIds.map(extractPackageName));
+                const relations = extensionAccessor.getRelations();
+                const { fanIn, fanOut } = computePackageFanMetricsFromRelations(relations, allPackageNames);
+                highInfluencePackages = Array.from(allPackageNames)
+                    .map((pkg) => ({ packageName: pkg, fanIn: fanIn.get(pkg) ?? 0, fanOut: fanOut.get(pkg) ?? 0 }))
+                    .sort((a, b) => b.fanIn - a.fanIn)
+                    .slice(0, 5);
+            }
+            catch {
+            }
+            return textResponse(JSON.stringify({
+                direction,
+                losses,
+                highInfluencePackages,
+                snapshotCount: snapshots.length,
+                methodology: METHODOLOGY,
+            }, null, 2));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return textResponse(`Error: ${message}`);
+        }
+    });
+}
+//# sourceMappingURL=gim-tools.js.map

package/dist/cli/mcp/tools/gim-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gim-tools.js","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/gim-tools.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp/tools/git-history-analyze-tool.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGitHistoryAnalyzeTool(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=git-history-analyze-tool.d.ts.map

package/dist/cli/mcp/tools/git-history-analyze-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-history-analyze-tool.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/git-history-analyze-tool.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAmM1F"}