@yalehwang/archguard 0.1.23 → 0.1.31

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

package/dist/cli/mcp/tools/test-analysis-tools.js

@@ -1,69 +1,31 @@
 import { z } from 'zod';
 import path from 'path';
-import { loadEngine } from '../../query/engine-loader.js';
+import { loadEngine, readManifest } from '../../query/engine-loader.js';
 import { resolveRoot } from '../mcp-server.js';
-function buildSuggestedPatternConfig(frameworks) {
-    const assertionPatterns = [];
-    for (const fw of frameworks) {
-        switch (fw) {
-            case 'vitest':
-            case 'jest':
-            case 'mocha':
-            case 'jasmine':
-                if (!assertionPatterns.includes('\\bexpect\\s*\\('))
-                    assertionPatterns.push('\\bexpect\\s*\\(');
-                break;
-            case 'junit4':
-            case 'junit5':
-                assertionPatterns.push('\\bAssert\\.assert\\w+\\s*\\(', '\\bAssertions\\.assert\\w+\\s*\\(', '\\bassertEquals\\s*\\(', '\\bassertTrue\\s*\\(', '\\bassertFalse\\s*\\(', '\\bassertNotNull\\s*\\(', '\\bassertThat\\s*\\(');
-                break;
-            case 'testng':
-                if (!assertionPatterns.includes('\\bassertEquals\\s*\\('))
-                    assertionPatterns.push('\\bassertEquals\\s*\\(', '\\bassertTrue\\s*\\(', '\\bassertNotNull\\s*\\(');
-                break;
-            case 'jmh':
-                break;
-            case 'assertj':
-                if (!assertionPatterns.includes('\\bassertThat\\s*\\('))
-                    assertionPatterns.push('\\bassertThat\\s*\\(');
-                break;
-            case 'testify':
-                assertionPatterns.push('\\b(?:assert|require)\\.\\w+\\s*\\(');
-                break;
-            case 'testing':
-                assertionPatterns.push('\\bt\\.(?:Error|Errorf|Fatal|Fatalf|Fail|FailNow)\\s*\\(');
-                break;
-            case 'gtest':
-                assertionPatterns.push('\\bEXPECT_\\w+\\s*\\(', '\\bASSERT_\\w+\\s*\\(');
-                break;
-            case 'catch2':
-            case 'doctest':
-                assertionPatterns.push('\\bREQUIRE\\s*\\(', '\\bCHECK\\s*\\(');
-                break;
-            case 'assert':
-                assertionPatterns.push('\\bassert\\s*\\(', '\\bassert_\\w+\\s*\\(', '\\bt\\.assert_\\w+\\s*\\(', '\\bGGML_ASSERT\\s*\\(');
-                break;
-            case 'pytest':
-                assertionPatterns.push('\\bassert\\b', '.assert');
-                break;
-            case 'unittest':
-                assertionPatterns.push('\\bself\\.assert\\w+\\s*\\(');
-                break;
-            case 'playwright':
-            case 'cypress':
-                if (!assertionPatterns.includes('\\bexpect\\s*\\('))
-                    assertionPatterns.push('\\bexpect\\s*\\(');
-                break;
-        }
-    }
-    if (assertionPatterns.length === 0)
-        return {};
-    return { assertionPatterns: [...new Set(assertionPatterns)] };
-}
+import { buildSuggestedPatternConfig } from '../../../analysis/test-pattern-advisor.js';
 const NOT_ANALYZED_MSG = 'No test analysis data found. Run `archguard_analyze` with `includeTests: true` first.';
 function textResponse(text) {
     return { content: [{ type: 'text', text }] };
 }
+async function buildZeroTestsDiagnosticResponse(archDir) {
+    let availableScopes = '';
+    try {
+        const manifest = await readManifest(archDir);
+        availableScopes = manifest.scopes?.map((s) => `${s.key} (${s.label})`).join(', ') ?? '';
+    }
+    catch {
+    }
+    return textResponse(JSON.stringify({
+        error: 'No test files found in the analyzed scope.',
+        diagnosis: [
+            'The current ArchJSON scope covers only source files (e.g. src/) and excludes tests/.',
+            'Fix: Re-run archguard_analyze with --include-tests flag.',
+            availableScopes
+                ? `Available scopes: ${availableScopes}`
+                : 'Run archguard_analyze first to generate analysis data.',
+        ],
+    }, null, 2));
+}
 const patternConfigSchema = z
     .object({
     assertionPatterns: z.array(z.string()).optional(),
@@ -80,21 +42,23 @@ const patternConfigSchema = z
     .optional();
 export function registerTestAnalysisTools(server, defaultRoot) {
     server.tool('archguard_detect_test_patterns', 'Pattern-First tool: call this FIRST before any other test analysis tool. Detects test frameworks and conventions in the project. Returns suggestedPatternConfig and notes. Review the notes and correct the config if needed before passing to other tools.', {
-        projectRoot: z
+        projectRoot: z.string().optional().describe('Project root (default: server startup cwd)'),
+        scope: z
             .string()
             .optional()
-            .describe('Project root (default: server startup cwd)'),
-    }, async ({ projectRoot }) => {
+            .describe('Analysis scope key. Omit to use the widest available scope containing test data.'),
+    }, async ({ projectRoot, scope }) => {
         try {
             const root = resolveRoot(projectRoot, defaultRoot);
             const archDir = path.join(root, '.archguard');
-            let engine = null;
+            let _engine = null;
+            let extensionAccessor = null;
             try {
-                engine = await loadEngine(archDir);
+                ({ engine: _engine, extensionAccessor } = await loadEngine(archDir, scope));
             }
             catch {
             }
-            if (!engine || !engine.hasTestAnalysis()) {
+            if (!extensionAccessor || !extensionAccessor.hasTestAnalysis()) {
                 const frameworks = [];
                 try {
                     const fs = await import('fs-extra');
@@ -126,7 +90,10 @@ export function registerTestAnalysisTools(server, defaultRoot) {
                     ],
                 }, null, 2));
             }
-            const analysis = engine.getTestAnalysis();
+            const analysis = extensionAccessor.getTestAnalysis();
+            if (analysis.metrics.totalTestFiles === 0) {
+                return buildZeroTestsDiagnosticResponse(archDir);
+            }
             const frameworks = [...new Set(analysis.testFiles.flatMap((f) => f.frameworks))];
             const suggestedPatternConfig = buildSuggestedPatternConfig(frameworks);
             return textResponse(JSON.stringify({
@@ -145,20 +112,29 @@ export function registerTestAnalysisTools(server, defaultRoot) {
             return textResponse(`Error: ${e.message}`);
         }
     });
-    server.tool('archguard_get_test_issues', 'Get test quality issues for the analyzed project. IMPORTANT: Call archguard_detect_test_patterns first to get the correct patternConfig for this project.', {
+    server.tool('archguard_get_test_issues', 'Return static-analysis test quality issues (orphan_test, zero_assertion, skip_accumulation); ' +
+        'orphan_test and zero_assertion results may include false positives when tests use import ' +
+        'aliases, custom assertion helpers, or long setup blocks. Call archguard_detect_test_patterns first.', {
         projectRoot: z.string().optional().describe('Project root (default: server startup cwd)'),
-        patternConfig: patternConfigSchema,
-        severity: z
-            .enum(['warning', 'info'])
+        scope: z
+            .string()
             .optional()
-            .describe('Filter by severity'),
-    }, async ({ projectRoot, severity }) => {
+            .describe('Analysis scope key. Omit to use the widest available scope containing test data.'),
+        patternConfig: patternConfigSchema.describe('Pattern config for detection (informational only — analysis data was produced at ' +
+            'archguard_analyze time; changing this field at query time does not re-analyze or ' +
+            'alter the stored results).'),
+        severity: z.enum(['warning', 'info']).optional().describe('Filter by severity'),
+    }, async ({ projectRoot, scope, severity }) => {
         try {
             const root = resolveRoot(projectRoot, defaultRoot);
-            const engine = await loadEngine(path.join(root, '.archguard'));
-            if (!engine.hasTestAnalysis())
+            const archDir = path.join(root, '.archguard');
+            const { engine: _engine, extensionAccessor } = await loadEngine(archDir, scope);
+            if (!extensionAccessor.hasTestAnalysis())
                 return textResponse(NOT_ANALYZED_MSG);
-            const analysis = engine.getTestAnalysis();
+            const analysis = extensionAccessor.getTestAnalysis();
+            if (analysis.metrics.totalTestFiles === 0) {
+                return buildZeroTestsDiagnosticResponse(archDir);
+            }
             const issues = severity
                 ? analysis.issues.filter((i) => i.severity === severity)
                 : analysis.issues;
@@ -168,17 +144,32 @@ export function registerTestAnalysisTools(server, defaultRoot) {
             return textResponse(`Error: ${e.message}`);
         }
     });
-    server.tool('archguard_get_test_metrics', 'Get test metrics summary for the analyzed project. IMPORTANT: Call archguard_detect_test_patterns first to get the correct patternConfig for this project.', {
+    server.tool('archguard_get_test_metrics', 'Return test metrics summary (coverage ratios, assertion density, test file counts); ' +
+        'coverage is inferred from static import-path and filename matching, not runtime tracing — ' +
+        'scores are an approximation. Call archguard_detect_test_patterns first.', {
         projectRoot: z.string().optional().describe('Project root (default: server startup cwd)'),
-        patternConfig: patternConfigSchema,
-        includePackageBreakdown: z.boolean().optional().describe('When true, includes per-package coverage breakdown sorted ascending by coverageRatio.'),
-    }, async ({ projectRoot, includePackageBreakdown }) => {
+        scope: z
+            .string()
+            .optional()
+            .describe('Analysis scope key. Omit to use the widest available scope containing test data.'),
+        patternConfig: patternConfigSchema.describe('Pattern config for detection (informational only — analysis data was produced at ' +
+            'archguard_analyze time; changing this field at query time does not re-analyze or ' +
+            'alter the stored results).'),
+        includePackageBreakdown: z
+            .boolean()
+            .optional()
+            .describe('When true, includes per-package coverage breakdown sorted ascending by coverageRatio.'),
+    }, async ({ projectRoot, scope, includePackageBreakdown }) => {
         try {
             const root = resolveRoot(projectRoot, defaultRoot);
-            const engine = await loadEngine(path.join(root, '.archguard'));
-            if (!engine.hasTestAnalysis())
+            const archDir = path.join(root, '.archguard');
+            const { engine, extensionAccessor } = await loadEngine(archDir, scope);
+            if (!extensionAccessor.hasTestAnalysis())
                 return textResponse(NOT_ANALYZED_MSG);
-            const analysis = engine.getTestAnalysis();
+            const analysis = extensionAccessor.getTestAnalysis();
+            if (analysis.metrics.totalTestFiles === 0) {
+                return buildZeroTestsDiagnosticResponse(archDir);
+            }
             const result = { ...analysis.metrics };
             if (includePackageBreakdown) {
                 result.packageCoverage = engine.getPackageCoverage();
@@ -203,8 +194,8 @@ export function registerTestAnalysisTools(server, defaultRoot) {
     }, async ({ projectRoot, entityId }) => {
         try {
             const root = resolveRoot(projectRoot, defaultRoot);
-            const engine = await loadEngine(path.join(root, '.archguard'));
-            if (!engine.hasTestAnalysis())
+            const { engine, extensionAccessor } = await loadEngine(path.join(root, '.archguard'));
+            if (!extensionAccessor.hasTestAnalysis())
                 return textResponse(NOT_ANALYZED_MSG);
             const result = engine.getEntityCoverage(entityId);
             return textResponse(JSON.stringify(result, null, 2));