@yalehwang/archguard 0.1.23 → 0.1.32

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

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

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import path from 'path';
+import { resolveRoot } from '../mcp-server.js';
+import { loadHistoryData, GitHistoryNotFoundError } from '../../git-history/history-loader.js';
+import { HistoryQuery } from '../../git-history/history-query.js';
+const NOT_ANALYZED_MSG = 'No git history data found. Run `archguard_analyze_git` first to collect history artifacts.';
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function formatEvidencePack(pack) {
+    const lines = [];
+    lines.push('## Evidence Pack');
+    lines.push('');
+    if (pack.results.length === 0 && pack.notFound.length > 0) {
+        lines.push('No targets were found in git history data.');
+        lines.push('');
+    }
+    else {
+        lines.push('| target | type | riskScore | riskLevel | topFactor |');
+        lines.push('|--------|------|-----------|-----------|-----------|');
+        for (const entry of pack.results) {
+            lines.push(`| ${entry.target} | ${entry.targetType} | ${entry.riskScore.toFixed(3)} | ${entry.riskLevel} | ${entry.topFactor} |`);
+        }
+        lines.push('');
+    }
+    lines.push('## Hotspots');
+    lines.push('');
+    if (pack.hotspots.length === 0) {
+        lines.push('_No hotspots (no targets resolved)._');
+    }
+    else {
+        for (let i = 0; i < pack.hotspots.length; i++) {
+            const h = pack.hotspots[i];
+            lines.push(`${i + 1}. **${h.target}** (${h.targetType}) — riskScore: ${h.riskScore.toFixed(3)}, riskLevel: ${h.riskLevel}, topFactor: ${h.topFactor}`);
+        }
+    }
+    lines.push('');
+    if (pack.notFound.length > 0) {
+        lines.push('## Not Found');
+        lines.push('');
+        for (const nf of pack.notFound) {
+            lines.push(`- ${nf.target} (${nf.targetType}): ${nf.reason}`);
+        }
+        lines.push('');
+    }
+    lines.push('```json');
+    lines.push(JSON.stringify(pack, null, 2));
+    lines.push('```');
+    return lines.join('\n');
+}
+export function registerEvidencePackTool(server, defaultRoot) {
+    server.tool('archguard_get_evidence_pack', 'Return a gate-ready aggregated risk evidence pack for multiple files or packages. Each target returns riskScore, riskLevel, and topFactor. Response includes per-target details, top-3 hotspots sorted by risk, and any not-found targets. Use before dispatching tasks to inject structural risk context. Requires archguard_analyze_git.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        targets: z
+            .array(z.object({
+            targetType: z
+                .enum(['file', 'package'])
+                .describe('Whether the target is a file path or a package path.'),
+            target: z
+                .string()
+                .describe('File path or package path to query (e.g. "src/cli/mcp-server.ts" or "src/cli").'),
+        }))
+            .min(1)
+            .max(20)
+            .describe('List of targets to query (1–20 entries).'),
+    }, async (params) => {
+        const root = resolveRoot(params.projectRoot, defaultRoot);
+        const archguardDir = path.join(root, '.archguard');
+        try {
+            const data = await loadHistoryData(archguardDir);
+            const query = new HistoryQuery(data);
+            const pack = query.getEvidencePack(params.targets);
+            return textResponse(formatEvidencePack(pack));
+        }
+        catch (err) {
+            if (err instanceof GitHistoryNotFoundError) {
+                return textResponse(NOT_ANALYZED_MSG);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return textResponse(`Evidence pack query failed: ${message}`);
+        }
+    });
+}
+//# sourceMappingURL=git-history-evidence-pack-tool.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-history-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/git-history-tools.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA4JpF"}

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

@@ -0,0 +1,125 @@
+import { z } from 'zod';
+import path from 'path';
+import { resolveRoot } from '../mcp-server.js';
+import { loadHistoryData, GitHistoryNotFoundError } from '../../git-history/history-loader.js';
+import { HistoryQuery } from '../../git-history/history-query.js';
+const NOT_ANALYZED_MSG = 'No git history data found. Run `archguard_analyze_git` first to collect history artifacts.';
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerGitHistoryTools(server, defaultRoot) {
+    server.tool('archguard_get_change_context', 'Get change-context summary for a file or package before editing. Returns churn, ownership, top co-change neighbors, and risk hints. Requires archguard_analyze_git to have been run first. Results reflect the analyzed time window only; rename and entity-level tracking are not supported in v1.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        targetType: z
+            .enum(['package', 'file'])
+            .describe('Whether the target is a package path or a file path.'),
+        target: z
+            .string()
+            .describe('Package path or file path to query (e.g. "src/cli" or "src/cli/mcp/mcp-server.ts").'),
+    }, async (params) => {
+        const root = resolveRoot(params.projectRoot, defaultRoot);
+        const archguardDir = path.join(root, '.archguard');
+        try {
+            const data = await loadHistoryData(archguardDir);
+            const query = new HistoryQuery(data);
+            const result = query.getChangeContext(params.targetType, params.target);
+            return textResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            if (err instanceof GitHistoryNotFoundError) {
+                return textResponse(NOT_ANALYZED_MSG);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return textResponse(`Target "${params.target}" not found in git history data. ${message}`);
+        }
+    });
+    server.tool('archguard_get_cochange', 'Return strongest co-change neighbors for a file or package. Co-change is an evolutionary signal only — it does not imply direct runtime or static dependency. Requires archguard_analyze_git.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        targetType: z
+            .enum(['package', 'file'])
+            .describe('Whether the target is a package path or a file path.'),
+        target: z.string().describe('Package path or file path to query.'),
+        topN: z.coerce
+            .number()
+            .min(1)
+            .max(20)
+            .default(10)
+            .describe('Maximum number of co-change neighbors to return (default: 10, max: 20).'),
+    }, async (params) => {
+        const root = resolveRoot(params.projectRoot, defaultRoot);
+        const archguardDir = path.join(root, '.archguard');
+        const topN = params.topN ?? 10;
+        try {
+            const data = await loadHistoryData(archguardDir);
+            const query = new HistoryQuery(data);
+            const result = query.getCochange(params.targetType, params.target, topN);
+            return textResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            if (err instanceof GitHistoryNotFoundError) {
+                return textResponse(NOT_ANALYZED_MSG);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return textResponse(`Target "${params.target}" not found in git history data. ${message}`);
+        }
+    });
+    server.tool('archguard_get_change_risk', 'Return an explainable risk score for changing a file or package. Score is a heuristic based on churn, author count, ownership concentration, co-change breadth, and recent activity — not a predictive defect model. Requires archguard_analyze_git.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        targetType: z
+            .enum(['package', 'file'])
+            .describe('Whether the target is a package path or a file path.'),
+        target: z.string().describe('Package path or file path to query.'),
+    }, async (params) => {
+        const root = resolveRoot(params.projectRoot, defaultRoot);
+        const archguardDir = path.join(root, '.archguard');
+        try {
+            const data = await loadHistoryData(archguardDir);
+            const query = new HistoryQuery(data);
+            const result = query.getChangeRisk(params.targetType, params.target);
+            return textResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            if (err instanceof GitHistoryNotFoundError) {
+                return textResponse(NOT_ANALYZED_MSG);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return textResponse(`Target "${params.target}" not found in git history data. ${message}`);
+        }
+    });
+    server.tool('archguard_get_ownership', 'Return maintainer concentration data for a file or package: contributors ranked by commit share, primary owner, active maintainers count, and bus-factor proxy. Requires archguard_analyze_git.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        targetType: z
+            .enum(['package', 'file'])
+            .describe('Whether the target is a package path or a file path.'),
+        target: z.string().describe('Package path or file path to query.'),
+    }, async (params) => {
+        const root = resolveRoot(params.projectRoot, defaultRoot);
+        const archguardDir = path.join(root, '.archguard');
+        try {
+            const data = await loadHistoryData(archguardDir);
+            const query = new HistoryQuery(data);
+            const result = query.getOwnership(params.targetType, params.target);
+            return textResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            if (err instanceof GitHistoryNotFoundError) {
+                return textResponse(NOT_ANALYZED_MSG);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return textResponse(`Target "${params.target}" not found in git history data. ${message}`);
+        }
+    });
+}
+//# sourceMappingURL=git-history-tools.js.map

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

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

package/dist/cli/mcp/tools/metric-trend-tools.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { PackageMetricsSnapshot } from '../../metrics-history-writer.js';
+export interface TrendSnapshot {
+    timestamp: string;
+    packages: PackageMetricsSnapshot[];
+}
+export declare function registerMetricTrendTools(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=metric-trend-tools.d.ts.map

package/dist/cli/mcp/tools/metric-trend-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-trend-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/metric-trend-tools.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAQ9E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAmDrF"}

package/dist/cli/mcp/tools/metric-trend-tools.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import path from 'path';
+import { resolveRoot } from '../mcp-server.js';
+import { readHistoryEntries } from '../../../analysis/metrics-history-reader.js';
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerMetricTrendTools(server, defaultRoot) {
+    server.tool('archguard_get_metric_trend', 'Return the historical time series of package-level structural metrics ' +
+        '(fan-in, fan-out, cycle count, entity count) recorded by each analyze run. ' +
+        'Each snapshot corresponds to one analyze invocation. ' +
+        'Use packageName to focus on a single package trend. ' +
+        'Data is pure numeric — no semantic annotations or LLM-generated content.', {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+        packageName: z
+            .string()
+            .optional()
+            .describe('Filter to a single package name. Omit to return all packages for each snapshot.'),
+    }, async ({ projectRoot, packageName }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const outputDir = path.join(root, '.archguard');
+            const allEntries = await readHistoryEntries(outputDir);
+            let snapshots;
+            if (packageName !== undefined) {
+                snapshots = allEntries
+                    .map((entry) => ({
+                    timestamp: entry.timestamp,
+                    packages: entry.packages.filter((p) => p.name === packageName),
+                }))
+                    .filter((s) => s.packages.length > 0);
+            }
+            else {
+                snapshots = allEntries.map((entry) => ({
+                    timestamp: entry.timestamp,
+                    packages: entry.packages,
+                }));
+            }
+            return textResponse(JSON.stringify({ snapshots }, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResponse(`Error: ${msg}`);
+        }
+    });
+}
+//# sourceMappingURL=metric-trend-tools.js.map

package/dist/cli/mcp/tools/metric-trend-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-trend-tools.js","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/metric-trend-tools.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAOD,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,WAAmB;IAC7E,MAAM,CAAC,IAAI,CAET,4BAA4B,EAC5B,wEAAwE;QACtE,6EAA6E;QAC7E,uDAAuD;QACvD,sDAAsD;QACtD,0EAA0E,EAC5E;QACE,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,+EAA+E,CAAC;QAC5F,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,iFAAiF,CAClF;KACJ,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAEvD,IAAI,SAA0B,CAAC;YAE/B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAE9B,SAAS,GAAG,UAAU;qBACnB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACf,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;iBAC/D,CAAC,CAAC;qBACF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACrC,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC,CAAC,CAAC;YACN,CAAC;YAED,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,YAAY,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { extractPackageName, computePackageFanMetricsFromRelations, computeCycleMetrics } from '../../../analysis/package-metrics-analysis.js';
+import type { PackageMetricsEntry } from '../../../analysis/package-metrics-analysis.js';
+export type { PackageMetricsEntry };
+export { extractPackageName, computePackageFanMetricsFromRelations, computeCycleMetrics };
+export declare function registerPackageMetricsTools(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=package-metrics-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-metrics-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/package-metrics-tools.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,EACL,kBAAkB,EAClB,qCAAqC,EACrC,mBAAmB,EACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAGlF,YAAY,EAAE,mBAAmB,EAAE,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,qCAAqC,EAAE,mBAAmB,EAAE,CAAC;AAU1F,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAuExF"}

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

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import path from 'path';
+import { loadEngine } from '../../query/engine-loader.js';
+import { resolveRoot } from '../mcp-server.js';
+import { extractPackageName, computePackageFanMetricsFromRelations, computeCycleMetrics, } from '../../../analysis/package-metrics-analysis.js';
+export { extractPackageName, computePackageFanMetricsFromRelations, computeCycleMetrics };
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function registerPackageMetricsTools(server, defaultRoot) {
+    server.tool('archguard_get_package_metrics', 'Aggregate fan-in, fan-out, and cycle count per package. ' +
+        'fan-in = number of incoming cross-package relations; ' +
+        'fan-out = number of outgoing cross-package relations; ' +
+        'cycleCount = number of SCCs the package participates in; ' +
+        'cyclesWith = entity names from co-cycling SCCs. ' +
+        'Works for all languages (TypeScript, Go, Java, Python, C++, Kotlin).', {
+        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.'),
+        packageName: z
+            .string()
+            .optional()
+            .describe('Filter results to a single package name. Omit to return metrics for all packages.'),
+    }, async ({ projectRoot, scope, packageName }) => {
+        try {
+            const root = resolveRoot(projectRoot, defaultRoot);
+            const archDir = path.join(root, '.archguard');
+            const { engine, extensionAccessor } = await loadEngine(archDir, scope);
+            const entityIds = extensionAccessor.getEntityIds();
+            const allPackageNames = new Set(entityIds.map(extractPackageName));
+            const relations = extensionAccessor.getRelations();
+            const { fanIn, fanOut } = computePackageFanMetricsFromRelations(relations, allPackageNames);
+            const cycles = engine.getCycles();
+            const cycleMetrics = computeCycleMetrics(cycles, allPackageNames);
+            let packages = Array.from(allPackageNames).map((pkg) => {
+                const cm = cycleMetrics.get(pkg) ?? { cycleCount: 0, cyclesWith: [] };
+                return {
+                    packageName: pkg,
+                    fanIn: fanIn.get(pkg) ?? 0,
+                    fanOut: fanOut.get(pkg) ?? 0,
+                    cycleCount: cm.cycleCount,
+                    cyclesWith: cm.cyclesWith,
+                };
+            });
+            if (packageName !== undefined) {
+                packages = packages.filter((p) => p.packageName === packageName);
+            }
+            packages.sort((a, b) => a.packageName.localeCompare(b.packageName));
+            return textResponse(JSON.stringify({ packages }, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResponse(`Error: ${msg}`);
+        }
+    });
+}
+//# sourceMappingURL=package-metrics-tools.js.map

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

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

package/dist/cli/mcp/tools/test-analysis-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-analysis-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/test-analysis-tools.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsGzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAqKtF"}
+{"version":3,"file":"test-analysis-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/test-analysis-tools.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgEzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAgNtF"}