@yalehwang/archguard 0.1.23 → 0.1.31

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"}

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

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+import path from 'path';
+import fs from 'fs-extra';
+import { resolveRoot } from '../mcp-server.js';
+import { readGitLog, getHeadRef, getCurrentBranch, isGitRepo, } from '../../git-history/git-log-reader.js';
+import { aggregateFileMetrics, aggregatePackageMetrics, } from '../../git-history/history-aggregator.js';
+import { writeHistoryArtifacts } from '../../git-history/history-writer.js';
+export function registerGitHistoryAnalyzeTool(server, defaultRoot) {
+    server.tool('archguard_analyze_git', 'Analyze git commit history for a project and generate file/package churn metrics, co-change coupling, and risk scores. Results are written to .archguard/query/git-history/ and can be queried with archguard_get_git_history.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the git repository to analyze. Defaults to the MCP server startup cwd.'),
+        sinceDays: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(90)
+            .describe('How many days of git history to include (default: 90).'),
+        maxCommits: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(500)
+            .describe('Maximum number of commits to process (default: 500).'),
+        includeMerges: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Whether to include merge commits (default: false).'),
+        granularities: z
+            .array(z.enum(['package', 'file']))
+            .optional()
+            .default(['package', 'file'])
+            .describe("Which granularities to include in the output (default: ['package', 'file'])."),
+        packageDepth: z.coerce
+            .number()
+            .int()
+            .min(1)
+            .max(5)
+            .optional()
+            .default(1)
+            .describe('Number of path segments to use for package grouping (default: 1). Use 2 for sub-package depth (e.g. src/mermaid instead of src).'),
+    }, async (params) => {
+        const projectRoot = resolveRoot(params.projectRoot, defaultRoot);
+        const sinceDays = params.sinceDays ?? 90;
+        const maxCommits = params.maxCommits ?? 500;
+        const includeMerges = params.includeMerges ?? false;
+        const granularities = params.granularities ?? ['package', 'file'];
+        const packageDepth = params.packageDepth ?? 1;
+        if (!isGitRepo(projectRoot)) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${projectRoot} is not a git repository.\nPlease provide a valid git repository path via the projectRoot parameter.`,
+                    },
+                ],
+            };
+        }
+        let commits;
+        try {
+            commits = readGitLog(projectRoot, { sinceDays, maxCommits, includeMerges });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error reading git log: ${message}\nMake sure git is installed and accessible in your PATH.`,
+                    },
+                ],
+            };
+        }
+        if (commits.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No commits found in the last ${sinceDays} days at ${projectRoot}.\nTry increasing sinceDays or check the repository has commits.`,
+                    },
+                ],
+            };
+        }
+        const fileMetrics = aggregateFileMetrics(commits, packageDepth);
+        await Promise.all(fileMetrics.map(async (fm) => {
+            fm.currentlyExists = await fs.pathExists(path.join(projectRoot, fm.path));
+        }));
+        const packageMetrics = aggregatePackageMetrics(fileMetrics, packageDepth);
+        const headRef = getHeadRef(projectRoot);
+        const analyzedBranch = getCurrentBranch(projectRoot);
+        const manifest = {
+            version: '2',
+            generatedAt: new Date().toISOString(),
+            headRef,
+            analyzedBranch,
+            sinceDays,
+            maxCommits,
+            totalCommits: commits.length,
+            includeMerges,
+            granularities,
+            packageDepth,
+        };
+        const artifacts = {
+            manifest,
+            packageMetrics: granularities.includes('package') ? packageMetrics : [],
+            fileMetrics: granularities.includes('file') ? fileMetrics : [],
+        };
+        const archguardDir = path.join(projectRoot, '.archguard');
+        try {
+            await writeHistoryArtifacts(archguardDir, artifacts);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error writing artifacts: ${message}`,
+                    },
+                ],
+            };
+        }
+        const existingFiles = fileMetrics.filter((f) => f.currentlyExists !== false);
+        const deletedFiles = fileMetrics.filter((f) => f.currentlyExists === false);
+        const topChurnFiles = [...existingFiles]
+            .sort((a, b) => b.commitCount - a.commitCount)
+            .slice(0, 5)
+            .map((f) => `  ${f.path} (${f.commitCount} commits, ${f.authorCount} authors)`)
+            .join('\n');
+        const topChurnPackages = [...packageMetrics]
+            .sort((a, b) => b.commitCount - a.commitCount)
+            .slice(0, 5)
+            .map((p) => `  ${p.path}/ (${p.commitCount} commits)`)
+            .join('\n');
+        const deletedSection = deletedFiles.length > 0
+            ? [
+                '',
+                `Deleted files (${deletedFiles.length} total, top 3 by churn — excluded from active list):`,
+                [...deletedFiles]
+                    .sort((a, b) => b.commitCount - a.commitCount)
+                    .slice(0, 3)
+                    .map((f) => `  ${f.path} (${f.commitCount} commits, deleted)`)
+                    .join('\n'),
+            ].join('\n')
+            : '';
+        const summary = [
+            `Git history analysis complete for ${projectRoot}`,
+            `  Branch:    ${analyzedBranch} @ ${headRef}`,
+            `  Period:    last ${sinceDays} days`,
+            `  Commits:   ${commits.length} processed`,
+            `  Files:     ${fileMetrics.length} changed (${deletedFiles.length} deleted)`,
+            `  Packages:  ${packageMetrics.length} packages`,
+            '',
+            'Top churned files:',
+            topChurnFiles || '  (none)',
+            deletedSection,
+            '',
+            'Top churned packages:',
+            topChurnPackages || '  (none)',
+            '',
+            `Artifacts written to: ${archguardDir}/query/git-history/`,
+        ].join('\n');
+        return {
+            content: [{ type: 'text', text: summary }],
+        };
+    });
+}
+//# sourceMappingURL=git-history-analyze-tool.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-history-evidence-pack-tool.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/git-history-evidence-pack-tool.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4EzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA6CrF"}