@yalehwang/archguard 0.1.6 → 0.1.8

package/dist/cli/commands/query.js

@@ -0,0 +1,227 @@
+import { Command } from 'commander';
+import { resolveArchDir, loadEngine, readManifest } from '../query/engine-loader.js';
+export function createQueryCommand() {
+    return new Command('query')
+        .description('Query architecture entities and relationships')
+        .option('--arch-dir <dir>', 'ArchGuard work directory')
+        .option('--scope <key>', 'Query scope key')
+        .option('--format <type>', 'Output format: json|text', 'text')
+        .option('--verbose', 'Return full entities in JSON output instead of summary')
+        .option('--entity <name>', 'Find entity by name')
+        .option('--deps-of <name>', 'Find dependencies of entity')
+        .option('--used-by <name>', 'Find dependents of entity')
+        .option('--implementers-of <name>', 'Find implementers of interface')
+        .option('--subclasses-of <name>', 'Find subclasses of class')
+        .option('--file <path>', 'Find entities in file')
+        .option('--depth <n>', 'BFS depth for --deps-of/--used-by (1-5)', '1')
+        .option('--cycles', 'Show dependency cycles')
+        .option('--summary', 'Show scope summary')
+        .option('--list-scopes', 'List available query scopes')
+        .option('--type <entityType>', 'Filter entities by type')
+        .option('--high-coupling', 'Find high-coupling entities')
+        .option('--threshold <n>', 'Coupling threshold for --high-coupling', '8')
+        .option('--orphans', 'Find orphan entities (no relations)')
+        .option('--in-cycles', 'Find entities participating in cycles')
+        .action(queryHandler);
+}
+async function queryHandler(opts) {
+    try {
+        validateQueryOptions(opts);
+        if (opts.listScopes) {
+            await handleListScopes(opts);
+            return;
+        }
+        const archDir = resolveArchDir(opts.archDir);
+        const engine = await loadEngine(archDir, opts.scope);
+        const isJson = opts.format === 'json';
+        const scopeEntry = engine.getScopeEntry();
+        let result;
+        if (opts.entity) {
+            const entities = engine.findEntity(opts.entity);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `Entities matching "${opts.entity}"`);
+        }
+        else if (opts.depsOf) {
+            const depth = parseBoundedInt(opts.depth, '--depth', 1, 5);
+            const entities = engine.getDependencies(opts.depsOf, depth);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `Dependencies of "${opts.depsOf}" (depth: ${depth})`);
+        }
+        else if (opts.usedBy) {
+            const depth = parseBoundedInt(opts.depth, '--depth', 1, 5);
+            const entities = engine.getDependents(opts.usedBy, depth);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `Dependents of "${opts.usedBy}" (depth: ${depth})`);
+        }
+        else if (opts.implementersOf) {
+            const entities = engine.findImplementers(opts.implementersOf);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `Implementers of "${opts.implementersOf}"`);
+        }
+        else if (opts.subclassesOf) {
+            const entities = engine.findSubclasses(opts.subclassesOf);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `Subclasses of "${opts.subclassesOf}"`);
+        }
+        else if (opts.file) {
+            const entities = engine.getFileEntities(opts.file);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `Entities in ${opts.file}`);
+        }
+        else if (opts.cycles) {
+            const cycles = engine.getCycles();
+            result = cycles;
+            if (!isJson)
+                formatCycles(cycles);
+        }
+        else if (opts.summary) {
+            const summary = engine.getSummary();
+            result = summary;
+            if (!isJson)
+                formatSummary(summary);
+        }
+        else if (opts.type) {
+            const entities = engine.findByType(opts.type);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `Entities of type "${opts.type}"`);
+        }
+        else if (opts.highCoupling) {
+            const threshold = parseBoundedInt(opts.threshold, '--threshold', 1);
+            const entities = engine.findHighCoupling(threshold);
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, `High-coupling entities (threshold: ${threshold})`);
+        }
+        else if (opts.orphans) {
+            const entities = engine.findOrphans();
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, 'Orphan entities (no relations)');
+        }
+        else if (opts.inCycles) {
+            const entities = engine.findInCycles();
+            result = projectEntitiesForOutput(engine, entities, opts.verbose);
+            if (!isJson)
+                formatEntityList(entities, 'Entities in dependency cycles');
+        }
+        else {
+            console.error('No query option specified. Use --help to see available options.');
+            process.exit(1);
+        }
+        if (isJson) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        if (scopeEntry.kind === 'derived' && !isJson) {
+            console.log('\n[Note: This scope is a derived (partial) view, not a complete project analysis.]');
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error: ${message}`);
+        process.exit(1);
+    }
+}
+function validateQueryOptions(opts) {
+    const primaryOptions = [
+        opts.entity,
+        opts.depsOf,
+        opts.usedBy,
+        opts.implementersOf,
+        opts.subclassesOf,
+        opts.file,
+        opts.cycles,
+        opts.summary,
+        opts.listScopes,
+        opts.type,
+        opts.highCoupling,
+        opts.orphans,
+        opts.inCycles,
+    ].filter(Boolean);
+    if (primaryOptions.length > 1) {
+        throw new Error('Specify exactly one primary query option.');
+    }
+    if (opts.depsOf || opts.usedBy) {
+        parseBoundedInt(opts.depth, '--depth', 1, 5);
+    }
+    if (opts.highCoupling) {
+        parseBoundedInt(opts.threshold, '--threshold', 1);
+    }
+}
+function parseBoundedInt(value, flagName, min, max) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < min || (max !== undefined && parsed > max)) {
+        const range = max !== undefined ? ` (${min}-${max})` : ` (>= ${min})`;
+        throw new Error(`Invalid ${flagName}: "${value}". Expected an integer${range}.`);
+    }
+    return parsed;
+}
+function projectEntitiesForOutput(engine, entities, verbose) {
+    return verbose ? entities : entities.map((entity) => engine.toSummary(entity));
+}
+async function handleListScopes(opts) {
+    const archDir = resolveArchDir(opts.archDir);
+    const manifest = await readManifest(archDir);
+    if (opts.format === 'json') {
+        console.log(JSON.stringify(manifest.scopes, null, 2));
+        return;
+    }
+    if (manifest.scopes.length === 0) {
+        console.log('No query scopes available. Run `archguard analyze` first.');
+        return;
+    }
+    console.log('Available query scopes:\n');
+    for (const scope of manifest.scopes) {
+        console.log(`  ${scope.key} (${scope.kind})`);
+        console.log(`    Label:    ${scope.label}`);
+        console.log(`    Language: ${scope.language}`);
+        console.log(`    Sources:  ${scope.sources.join(', ')}`);
+        console.log(`    Entities: ${scope.entityCount}, Relations: ${scope.relationCount}`);
+        console.log('');
+    }
+    console.log(`Total: ${manifest.scopes.length} scope(s)`);
+}
+function formatEntityList(entities, title) {
+    console.log(`${title}:\n`);
+    if (entities.length === 0) {
+        console.log('  (none)');
+        return;
+    }
+    for (const e of entities) {
+        const loc = e.sourceLocation;
+        console.log(`  ${e.name} (${e.type}) @ ${loc.file}:${loc.startLine}`);
+    }
+    console.log(`\n  Total: ${entities.length}`);
+}
+function formatCycles(cycles) {
+    if (cycles.length === 0) {
+        console.log('No dependency cycles detected.');
+        return;
+    }
+    console.log(`Found ${cycles.length} dependency cycle(s):\n`);
+    for (let i = 0; i < cycles.length; i++) {
+        const c = cycles[i];
+        console.log(`  Cycle ${i + 1} (size ${c.size}): ${c.memberNames.join(' -> ')}`);
+        console.log(`    Files: ${c.files.join(', ')}`);
+    }
+}
+function formatSummary(summary) {
+    console.log('Scope Summary:\n');
+    console.log(`  Language:  ${summary.language}`);
+    console.log(`  Kind:      ${summary.kind}`);
+    console.log(`  Entities:  ${summary.entityCount}`);
+    console.log(`  Relations: ${summary.relationCount}`);
+    if (summary.topDependedOn.length > 0) {
+        console.log('\n  Top depended-on:');
+        for (const item of summary.topDependedOn) {
+            console.log(`    ${item.name}: ${item.dependentCount} dependents`);
+        }
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/cli/commands/query.js.map

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

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,SAAS,IAAI,OAAO,CAcnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,SAAS,IAAI,OAAO,CAgBnC"}

package/dist/cli/index.js

@@ -3,6 +3,8 @@ import { Command } from 'commander';
 import { createAnalyzeCommand } from './commands/analyze.js';
 import { createCacheCommand } from './commands/cache.js';
 import { createInitCommand } from './commands/init.js';
+import { createQueryCommand } from './commands/query.js';
+import { createMcpCommand } from './commands/mcp.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const packageJson = require('../../package.json');
@@ -15,6 +17,8 @@ export function createCLI() {
     program.addCommand(createAnalyzeCommand());
     program.addCommand(createCacheCommand());
     program.addCommand(createInitCommand());
+    program.addCommand(createQueryCommand());
+    program.addCommand(createMcpCommand());
     return program;
 }
 import * as fs from 'fs';

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAKlD,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;SAC5B,WAAW,CAAC,0EAA0E,CAAC,CAAC;IAG3F,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAK3B,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClG,IAAI,MAAM,EAAE,CAAC;IACX,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAKlD,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;SAC5B,WAAW,CAAC,0EAA0E,CAAC,CAAC;IAG3F,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAK3B,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClG,IAAI,MAAM,EAAE,CAAC;IACX,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/cli/mcp/analyze-tool.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-tool.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/analyze-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAkCD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,kBAAkB,GAAG,IAAI,CA4CpF"}

package/dist/cli/mcp/analyze-tool.js

@@ -0,0 +1,112 @@
+import path from 'path';
+import { z } from 'zod';
+import { runAnalysis } from '../analyze/run-analysis.js';
+import { StderrReporter } from '../progress.js';
+const supportedAnalyzeLanguages = ['typescript', 'go', 'java', 'python', 'cpp'];
+const analyzeLocks = new Set();
+const analyzeSchema = {
+    projectRoot: z
+        .string()
+        .optional()
+        .describe('Root directory of the target project. Defaults to the MCP server startup cwd.'),
+    sources: z
+        .array(z.string())
+        .optional()
+        .describe('Source paths relative to the target project root. Omit to analyze the project root.'),
+    lang: z
+        .enum(supportedAnalyzeLanguages)
+        .optional()
+        .describe('Source code language plugin to use. Supported values: typescript, go, java, python, cpp. This is not a natural-language locale.'),
+    diagrams: z
+        .array(z.enum(['package', 'class', 'method']))
+        .optional()
+        .describe('Diagram levels to generate. Omit to use the detected/default set for the target sources.'),
+    format: z
+        .enum(['mermaid', 'json'])
+        .optional()
+        .describe('Output artifact format. Use json for query/index refresh without Mermaid rendering.'),
+    noCache: z
+        .boolean()
+        .default(false)
+        .describe('Disable analysis caches for this run.'),
+};
+export function registerAnalyzeTool(server, ctx) {
+    server.tool('archguard_analyze', 'Analyze project sources with an optional code-language plugin override and refresh query artifacts for the target project.', analyzeSchema, async ({ projectRoot, sources, lang, diagrams, format, noCache }) => {
+        const root = resolveRoot(projectRoot, ctx.defaultRoot);
+        const startedAt = Date.now();
+        try {
+            return await withPerProjectLock(root, async () => {
+                const normalizedSources = sources?.map((source) => path.resolve(root, source));
+                const result = await runAnalysis({
+                    sessionRoot: root,
+                    workDir: path.join(root, '.archguard'),
+                    cliOptions: {
+                        sources: normalizedSources,
+                        lang,
+                        diagrams,
+                        format,
+                        cache: noCache ? false : undefined,
+                    },
+                    reporter: new StderrReporter(),
+                });
+                if (result.queryScopesPersisted === 0) {
+                    return textResponse('Analysis failed: No query scopes were persisted.\nPrevious query state is unchanged.');
+                }
+                return textResponse(formatAnalyzeResponse(result, {
+                    elapsedMs: Date.now() - startedAt,
+                    projectRoot: root,
+                }));
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return textResponse(`Analysis failed: ${message}\nPrevious query state is unchanged.`);
+        }
+    });
+}
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function resolveRoot(projectRoot, defaultRoot) {
+    if (!projectRoot)
+        return defaultRoot;
+    return path.isAbsolute(projectRoot) ? projectRoot : path.resolve(defaultRoot, projectRoot);
+}
+async function withPerProjectLock(root, fn) {
+    const key = path.resolve(root);
+    if (analyzeLocks.has(key)) {
+        throw new Error(`An analysis is already running for ${key}. Wait for it to complete or analyze a different project.`);
+    }
+    analyzeLocks.add(key);
+    try {
+        return await fn();
+    }
+    finally {
+        analyzeLocks.delete(key);
+    }
+}
+function formatAnalyzeResponse(result, meta) {
+    const lines = [`Analysis completed in ${(meta.elapsedMs / 1000).toFixed(1)}s`, ''];
+    lines.push(`Project root: ${meta.projectRoot}`);
+    lines.push(`Work dir:     ${result.config.workDir}`);
+    lines.push(`Output:       ${result.config.outputDir}`);
+    lines.push(`Query:        ${result.queryScopesPersisted} scopes written`);
+    if (result.results.length > 0) {
+        lines.push('', 'Diagrams:');
+        for (const diagram of result.results) {
+            if (diagram.success) {
+                lines.push(`  - ${diagram.name}  ok  ${diagram.stats?.entities ?? 0} entities  ${diagram.stats?.relations ?? 0} relations  ${((diagram.stats?.parseTime ?? 0) / 1000).toFixed(1)}s`);
+            }
+            else {
+                lines.push(`  - ${diagram.name}  failed  ${diagram.error ?? 'unknown error'}`);
+            }
+        }
+    }
+    if (result.hasDiagramFailures) {
+        lines.push('', 'Warnings:');
+        lines.push('  - One or more diagrams failed, but query data was refreshed.');
+    }
+    lines.push('', 'Next step: call archguard_summary or another query tool.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=analyze-tool.js.map

package/dist/cli/mcp/analyze-tool.js.map

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

package/dist/cli/mcp/mcp-server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function resolveRoot(projectRoot: string | undefined, defaultRoot: string): string;
+export declare function createMcpServer(defaultRoot?: string): McpServer;
+export declare function startMcpServer(defaultRoot?: string): Promise<void>;
+export declare function registerTools(server: McpServer, defaultRoot: string): void;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/cli/mcp/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/mcp-server.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBpE,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGxF;AAqBD,wBAAgB,eAAe,CAAC,WAAW,GAAE,MAAsB,GAAG,SAAS,CAW9E;AASD,wBAAsB,cAAc,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvF;AA4BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAoJ1E"}

package/dist/cli/mcp/mcp-server.js

@@ -0,0 +1,165 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import path from 'path';
+import { z } from 'zod';
+import { loadEngine } from '../query/engine-loader.js';
+import { registerAnalyzeTool } from './analyze-tool.js';
+const projectRootParam = z
+    .string()
+    .optional()
+    .describe('Root directory of the target project. Defaults to the MCP server startup cwd.');
+const scopeParam = z
+    .string()
+    .optional()
+    .describe('Query scope key, label fragment, or the synthetic alias "global". Omit to use manifest.globalScopeKey resolution.');
+function textResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function resolveRoot(projectRoot, defaultRoot) {
+    if (!projectRoot)
+        return defaultRoot;
+    return path.isAbsolute(projectRoot) ? projectRoot : path.resolve(defaultRoot, projectRoot);
+}
+async function withEngineErrorContext(root, fn) {
+    const archDir = path.join(root, '.archguard');
+    try {
+        return await fn();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('No query data found')) {
+            return textResponse(`No query data found at ${archDir}/query.\nRun archguard_analyze({ projectRoot: "${root}" }) first.`);
+        }
+        return textResponse(`Query failed for ${root}: ${message}`);
+    }
+}
+export function createMcpServer(defaultRoot = process.cwd()) {
+    const server = new McpServer({
+        name: 'archguard',
+        version: '1.0.0',
+    });
+    registerTools(server, defaultRoot);
+    registerAnalyzeTool(server, {
+        defaultRoot,
+    });
+    return server;
+}
+export async function startMcpServer(defaultRoot = process.cwd()) {
+    const server = createMcpServer(defaultRoot);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('ArchGuard MCP server running on stdio');
+}
+function serializeEntities(entities) {
+    return JSON.stringify(entities, null, 2);
+}
+const verboseParam = z
+    .preprocess(v => (v === 'true' ? true : v === 'false' ? false : v), z.boolean().default(false))
+    .describe('Return full entities with members. Default false returns summary only.');
+function applyView(engine, entities, verbose) {
+    const isVerbose = verbose === 'true' ? true : (verbose ?? false);
+    return isVerbose ? entities : entities.map(e => engine.toSummary(e));
+}
+export function registerTools(server, defaultRoot) {
+    server.tool('archguard_find_entity', 'Find architecture entities by exact name match', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+        name: z.string().describe('Entity name to search for'),
+        verbose: verboseParam,
+    }, async ({ projectRoot, scope, name, verbose }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            const payload = applyView(engine, engine.findEntity(name), verbose);
+            return textResponse(serializeEntities(payload));
+        });
+    });
+    server.tool('archguard_get_dependencies', 'Get dependencies of a named entity (what it depends on)', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+        name: z.string().describe('Entity name'),
+        depth: z.coerce.number().min(1).max(5).default(1).describe('BFS traversal depth (1-5)'),
+        verbose: verboseParam,
+    }, async ({ projectRoot, scope, name, depth, verbose }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            const payload = applyView(engine, engine.getDependencies(name, depth), verbose);
+            return textResponse(serializeEntities(payload));
+        });
+    });
+    server.tool('archguard_get_dependents', 'Get dependents of a named entity (what depends on it)', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+        name: z.string().describe('Entity name'),
+        depth: z.coerce.number().min(1).max(5).default(1).describe('BFS traversal depth (1-5)'),
+        verbose: verboseParam,
+    }, async ({ projectRoot, scope, name, depth, verbose }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            const payload = applyView(engine, engine.getDependents(name, depth), verbose);
+            return textResponse(serializeEntities(payload));
+        });
+    });
+    server.tool('archguard_find_implementers', 'Find classes that implement a given interface', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+        name: z.string().describe('Interface name'),
+        verbose: verboseParam,
+    }, async ({ projectRoot, scope, name, verbose }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            const payload = applyView(engine, engine.findImplementers(name), verbose);
+            return textResponse(serializeEntities(payload));
+        });
+    });
+    server.tool('archguard_find_subclasses', 'Find subclasses of a given class', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+        name: z.string().describe('Class name'),
+        verbose: verboseParam,
+    }, async ({ projectRoot, scope, name, verbose }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            const payload = applyView(engine, engine.findSubclasses(name), verbose);
+            return textResponse(serializeEntities(payload));
+        });
+    });
+    server.tool('archguard_get_file_entities', 'Get all entities defined in a specific file', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+        filePath: z.string().describe('Source file path (e.g. "cli/query/query-engine.ts")'),
+        verbose: verboseParam,
+    }, async ({ projectRoot, scope, filePath, verbose }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            const payload = applyView(engine, engine.getFileEntities(filePath), verbose);
+            return textResponse(serializeEntities(payload));
+        });
+    });
+    server.tool('archguard_detect_cycles', 'Detect dependency cycles in the architecture', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+    }, async ({ projectRoot, scope }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            return textResponse(JSON.stringify(engine.getCycles(), null, 2));
+        });
+    });
+    server.tool('archguard_summary', 'Get a summary of the architecture scope', {
+        projectRoot: projectRootParam,
+        scope: scopeParam,
+    }, async ({ projectRoot, scope }) => {
+        const root = resolveRoot(projectRoot, defaultRoot);
+        return withEngineErrorContext(root, async () => {
+            const engine = await loadEngine(path.join(root, '.archguard'), scope);
+            return textResponse(JSON.stringify(engine.getSummary(), null, 2));
+        });
+    });
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/cli/mcp/mcp-server.js.map

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

package/dist/cli/processors/arch-json-provider.d.ts

@@ -0,0 +1,38 @@
+import type { ParseCache } from '../../parser/parse-cache.js';
+import type { DiagramConfig, GlobalConfig } from '../../types/config.js';
+import type { ArchJSON } from '../../types/index.js';
+import type { PluginRegistry } from '../../core/plugin-registry.js';
+export interface ArchJsonProviderOptions {
+    globalConfig: GlobalConfig;
+    parseCache?: ParseCache;
+    registry?: PluginRegistry;
+}
+export interface ArchJsonGetOptions {
+    needsModuleGraph: boolean;
+}
+export declare function hashSources(sources: string[]): string;
+export declare function deriveSubModuleArchJSON(parent: ArchJSON, subPath: string, workspaceRoot?: string): ArchJSON;
+export declare class ArchJsonProvider {
+    private readonly globalConfig;
+    private readonly parseCache?;
+    private readonly registry?;
+    private readonly fileDiscovery;
+    private readonly archJsonDiskCache;
+    private archJsonCache;
+    private archJsonPathIndex;
+    private archJsonDeferred;
+    constructor(options: ArchJsonProviderOptions);
+    cacheSize(): number;
+    get(diagram: DiagramConfig, opts: ArchJsonGetOptions): Promise<{
+        archJson: ArchJSON;
+        kind: 'parsed' | 'derived';
+    }>;
+    private cacheArchJson;
+    private registerDeferred;
+    private findParentCoverage;
+    private parseGoProject;
+    private parseCppProject;
+    private parseTsPlugin;
+    private parseWithParallelParser;
+}
+//# sourceMappingURL=arch-json-provider.d.ts.map