archprint 0.5.0 → 0.7.0

package/dist/mcp/remote/http.js

@@ -0,0 +1,92 @@
+import { createServer } from 'node:http';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createRemoteServer } from './server.js';
+const MCP_PATH = '/mcp';
+const DEFAULT_MAX_CONCURRENT = 4;
+const DEFAULT_MAX_BODY_BYTES = 1024 * 1024;
+export function createRemoteHttpServer(version, options = {}) {
+    const maxConcurrent = options.maxConcurrent ?? DEFAULT_MAX_CONCURRENT;
+    const maxBodyBytes = options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES;
+    const serverFactory = options.serverFactory ?? (() => createRemoteServer(version));
+    let inFlight = 0;
+    async function serve(req, res) {
+        try {
+            const url = new URL(req.url ?? '/', 'http://localhost');
+            if (req.method === 'GET' && url.pathname === '/healthz')
+                return drainAnd(req, res, 200, { status: 'ok' });
+            if (req.method === 'GET' && url.pathname === MCP_PATH) {
+                return drainAnd(req, res, 405, { error: 'This server is stateless; use POST to /mcp.' });
+            }
+            if (req.method !== 'POST' || url.pathname !== MCP_PATH)
+                return drainAnd(req, res, 404, { error: 'Not found.' });
+            if (inFlight >= maxConcurrent) {
+                return drainAnd(req, res, 429, { error: 'Too many concurrent requests, retry shortly.' });
+            }
+            inFlight++;
+            try {
+                const body = await readJsonBody(req, maxBodyBytes);
+                const server = serverFactory();
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: undefined,
+                    enableJsonResponse: true,
+                });
+                try {
+                    await server.connect(transport);
+                    await transport.handleRequest(req, res, body);
+                }
+                finally {
+                    void transport.close();
+                    void server.close();
+                }
+            }
+            finally {
+                inFlight--;
+            }
+        }
+        catch (error) {
+            if (!res.headersSent)
+                sendJson(res, 400, { error: error.message });
+        }
+    }
+    return createServer((req, res) => void serve(req, res));
+}
+function sendJson(res, status, body) {
+    res.writeHead(status, { 'content-type': 'application/json' });
+    res.end(JSON.stringify(body));
+}
+function drainAnd(req, res, status, body) {
+    req.resume();
+    sendJson(res, status, body);
+}
+function readJsonBody(req, maxBytes) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let done = false;
+        req.on('data', (chunk) => {
+            if (done)
+                return;
+            size += chunk.length;
+            if (size > maxBytes) {
+                done = true;
+                reject(new Error('Request body too large.'));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            if (done)
+                return;
+            if (chunks.length === 0)
+                return resolve(undefined);
+            try {
+                resolve(JSON.parse(Buffer.concat(chunks).toString('utf8')));
+            }
+            catch {
+                reject(new Error('Invalid JSON body.'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/mcp/remote/http.js.map

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

package/dist/mcp/remote/repo-url.d.ts

@@ -0,0 +1,8 @@
+export interface RepoSpec {
+    cloneUrl: string;
+    host: string;
+    slug: string;
+}
+export declare function parseRepoUrl(input: string): RepoSpec;
+export declare function normalizeRef(ref: string | undefined): string | undefined;
+//# sourceMappingURL=repo-url.d.ts.map

package/dist/mcp/remote/repo-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-url.d.ts","sourceRoot":"","sources":["../../../src/mcp/remote/repo-url.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CA4BpD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAexE"}

package/dist/mcp/remote/repo-url.js

@@ -0,0 +1,45 @@
+const ALLOWED_HOSTS = new Set(['github.com', 'gitlab.com', 'bitbucket.org']);
+export function parseRepoUrl(input) {
+    let url;
+    try {
+        url = new URL(input.trim());
+    }
+    catch {
+        throw new Error(`Not a valid URL: ${input}`);
+    }
+    if (url.protocol !== 'https:')
+        throw new Error('Only https:// repository URLs are supported.');
+    if (url.username || url.password)
+        throw new Error('Repository URLs must not contain credentials.');
+    if (url.port)
+        throw new Error('Repository URLs must not specify a port.');
+    const host = url.hostname.toLowerCase();
+    if (!ALLOWED_HOSTS.has(host)) {
+        throw new Error(`Unsupported host "${host}". Allowed: ${[...ALLOWED_HOSTS].join(', ')}.`);
+    }
+    const slug = url.pathname
+        .replace(/\/+$/, '')
+        .replace(/\.git$/i, '')
+        .split('/')
+        .filter(Boolean)
+        .join('/');
+    if (slug.split('/').length < 2) {
+        throw new Error('Expected a repository URL of the form https://host/owner/repo.');
+    }
+    return { cloneUrl: `https://${host}/${slug}.git`, host, slug };
+}
+export function normalizeRef(ref) {
+    if (ref === undefined)
+        return undefined;
+    const trimmed = ref.trim();
+    if (trimmed === '')
+        return undefined;
+    if (trimmed.length > 256 ||
+        trimmed.startsWith('-') ||
+        trimmed.includes('..') ||
+        !/^[\w./-]+$/.test(trimmed)) {
+        throw new Error(`Invalid ref "${ref}". Use a branch or tag name (letters, digits, ., _, /, -).`);
+    }
+    return trimmed;
+}
+//# sourceMappingURL=repo-url.js.map

package/dist/mcp/remote/repo-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-url.js","sourceRoot":"","sources":["../../../src/mcp/remote/repo-url.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;AAQ7E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC/F,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;QAC9B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,IAAI,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAE1E,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,eAAe,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ;SACtB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,WAAW,IAAI,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACrC,IACE,OAAO,CAAC,MAAM,GAAG,GAAG;QACpB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gBAAgB,GAAG,4DAA4D,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/mcp/remote/server.d.ts

@@ -0,0 +1,67 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { type ToolResponse } from '../tool-response.js';
+import { type RemoteTools } from './tools.js';
+export declare const REMOTE_TOOLS: readonly [{
+    readonly name: "archprint_scan";
+    readonly description: "Clone a public repository by URL (read-only, ephemeral) and list the architecture rules it already follows, with the evidence: which families are AUTO (clears the confidence gate) or SUGGEST (worth review), how many files conform vs. break each, and the confidence.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly deep: {
+                readonly type: "boolean";
+                readonly description: "resolve imports through barrels and aliases (slower, more accurate)";
+            };
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "https URL of a public repository on github.com, gitlab.com, or bitbucket.org";
+            };
+            readonly ref: {
+                readonly type: "string";
+                readonly description: "branch or tag to scan (optional; defaults to the repo default branch)";
+            };
+        };
+        readonly required: readonly ["repo"];
+    };
+}, {
+    readonly name: "archprint_recommend";
+    readonly description: "Clone a public repository by URL (read-only, ephemeral) and recommend an architecture rule set from its evidence and stack: what to enforce now, what to review before enforcing, and what comparable repos commonly adopt that this one does not yet.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "https URL of a public repository on github.com, gitlab.com, or bitbucket.org";
+            };
+            readonly ref: {
+                readonly type: "string";
+                readonly description: "branch or tag to scan (optional; defaults to the repo default branch)";
+            };
+        };
+        readonly required: readonly ["repo"];
+    };
+}, {
+    readonly name: "archprint_explain";
+    readonly description: "Clone a public repository by URL (read-only, ephemeral) and explain the confidence-gate evidence behind one inferred rule id (e.g. AP-002): its gate status, conformance stats, and the files that violate it.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "https URL of a public repository on github.com, gitlab.com, or bitbucket.org";
+            };
+            readonly ref: {
+                readonly type: "string";
+                readonly description: "branch or tag to scan (optional; defaults to the repo default branch)";
+            };
+            readonly id: {
+                readonly type: "string";
+                readonly description: "rule id, e.g. AP-002";
+            };
+        };
+        readonly required: readonly ["id", "repo"];
+    };
+}];
+export declare function runRemoteTool(tools: RemoteTools, name: string, args: Record<string, unknown>): Promise<unknown>;
+export declare function callRemoteTool(tools: RemoteTools, name: string, args: Record<string, unknown>): Promise<ToolResponse>;
+export declare function createRemoteServer(version: string, tools?: RemoteTools): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/remote/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/remote/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAa/D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCf,CAAC;AAEX,wBAAsB,aAAa,CACjC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,WAA+B,GACrC,MAAM,CAYR"}

package/dist/mcp/remote/server.js

@@ -0,0 +1,83 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { errorResponse, okResponse } from '../tool-response.js';
+import { makeRemoteTools } from './tools.js';
+const repoProperty = {
+    repo: {
+        type: 'string',
+        description: 'https URL of a public repository on github.com, gitlab.com, or bitbucket.org',
+    },
+    ref: {
+        type: 'string',
+        description: 'branch or tag to scan (optional; defaults to the repo default branch)',
+    },
+};
+export const REMOTE_TOOLS = [
+    {
+        name: 'archprint_scan',
+        description: 'Clone a public repository by URL (read-only, ephemeral) and list the architecture rules it already follows, with the evidence: which families are AUTO (clears the confidence gate) or SUGGEST (worth review), how many files conform vs. break each, and the confidence.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...repoProperty,
+                deep: {
+                    type: 'boolean',
+                    description: 'resolve imports through barrels and aliases (slower, more accurate)',
+                },
+            },
+            required: ['repo'],
+        },
+    },
+    {
+        name: 'archprint_recommend',
+        description: 'Clone a public repository by URL (read-only, ephemeral) and recommend an architecture rule set from its evidence and stack: what to enforce now, what to review before enforcing, and what comparable repos commonly adopt that this one does not yet.',
+        inputSchema: { type: 'object', properties: { ...repoProperty }, required: ['repo'] },
+    },
+    {
+        name: 'archprint_explain',
+        description: 'Clone a public repository by URL (read-only, ephemeral) and explain the confidence-gate evidence behind one inferred rule id (e.g. AP-002): its gate status, conformance stats, and the files that violate it.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'rule id, e.g. AP-002' }, ...repoProperty },
+            required: ['id', 'repo'],
+        },
+    },
+];
+export async function runRemoteTool(tools, name, args) {
+    const repo = typeof args.repo === 'string' ? args.repo.trim() : '';
+    if (repo === '') {
+        throw new Error(`${name} requires a "repo" URL (for example https://github.com/owner/repo).`);
+    }
+    const ref = typeof args.ref === 'string' ? args.ref : undefined;
+    switch (name) {
+        case 'archprint_scan':
+            return { apps: await tools.remoteScan(repo, ref, args.deep === true) };
+        case 'archprint_recommend':
+            return { apps: await tools.remoteRecommend(repo, ref) };
+        case 'archprint_explain':
+            if (typeof args.id !== 'string' || args.id === '') {
+                throw new Error('archprint_explain requires an "id" (for example AP-002).');
+            }
+            return tools.remoteExplain(args.id, repo, ref);
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+export async function callRemoteTool(tools, name, args) {
+    try {
+        return okResponse(await runRemoteTool(tools, name, args));
+    }
+    catch (error) {
+        return errorResponse(error);
+    }
+}
+export function createRemoteServer(version, tools = makeRemoteTools()) {
+    const server = new Server({ name: 'archprint-remote', version }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: REMOTE_TOOLS }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { content, isError } = await callRemoteTool(tools, request.params.name, request.params.arguments ?? {});
+        return { content, isError };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/remote/server.js.map

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

package/dist/mcp/remote/tools.d.ts

@@ -0,0 +1,11 @@
+import { type AppRecommendations, type AppScan, type ExplainResult } from '../tools.js';
+import { type CloneOptions } from './clone.js';
+import { type RepoSpec } from './repo-url.js';
+export type RepoRunner = <T>(spec: RepoSpec, ref: string | undefined, options: CloneOptions, use: (dir: string) => T) => Promise<T>;
+export interface RemoteTools {
+    remoteScan(repo: string, ref?: string, deep?: boolean): Promise<AppScan[]>;
+    remoteRecommend(repo: string, ref?: string): Promise<AppRecommendations[]>;
+    remoteExplain(id: string, repo: string, ref?: string): Promise<ExplainResult>;
+}
+export declare function makeRemoteTools(run?: RepoRunner, options?: CloneOptions): RemoteTools;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/remote/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/remote/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,OAAO,EACZ,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EACzB,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,KACpB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC3E,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC/E;AAED,wBAAgB,eAAe,CAC7B,GAAG,GAAE,UAA2B,EAChC,OAAO,GAAE,YAAiB,GACzB,WAAW,CAWb"}

package/dist/mcp/remote/tools.js

@@ -0,0 +1,12 @@
+import { explainTool, recommendTool, scanTool, } from '../tools.js';
+import { withClonedRepo } from './clone.js';
+import { normalizeRef, parseRepoUrl } from './repo-url.js';
+export function makeRemoteTools(run = withClonedRepo, options = {}) {
+    const inRepo = async (repo, ref, use) => run(parseRepoUrl(repo), normalizeRef(ref), options, use);
+    return {
+        remoteScan: (repo, ref, deep = false) => inRepo(repo, ref, (dir) => scanTool(dir, deep)),
+        remoteRecommend: (repo, ref) => inRepo(repo, ref, (dir) => recommendTool(dir)),
+        remoteExplain: (id, repo, ref) => inRepo(repo, ref, (dir) => explainTool(id, dir)),
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/remote/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/mcp/remote/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,QAAQ,GAIT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAe1E,MAAM,UAAU,eAAe,CAC7B,MAAkB,cAAc,EAChC,UAAwB,EAAE;IAE1B,MAAM,MAAM,GAAG,KAAK,EAClB,IAAY,EACZ,GAAuB,EACvB,GAAuB,EACX,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1E,OAAO;QACL,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxF,eAAe,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC9E,aAAa,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,54 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { type ToolResponse } from './tool-response.js';
+export declare const TOOLS: readonly [{
+    readonly name: "archprint_scan";
+    readonly description: "List the architecture rules this TypeScript repo already follows, with the evidence: which families are AUTO (clears the confidence gate) or SUGGEST (short of it, worth review), how many files conform vs. break each, and the confidence. Read-only. `path` defaults to \".\" and a monorepo root scans every app.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly description: "app or monorepo-root directory (default \".\")";
+            };
+            readonly deep: {
+                readonly type: "boolean";
+                readonly description: "resolve imports through barrels and aliases (slower, more accurate)";
+            };
+        };
+    };
+}, {
+    readonly name: "archprint_recommend";
+    readonly description: "Recommend an architecture rule set for this repo from its evidence and detected stack: what to enforce now, what to review before enforcing, and what comparable repos commonly adopt that this repo does not yet. Read-only.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly description: "app or monorepo-root directory (default \".\")";
+            };
+        };
+    };
+}, {
+    readonly name: "archprint_explain";
+    readonly description: "Explain the confidence-gate evidence behind one inferred rule id (e.g. AP-002): its gate status, conformance stats, and the files that violate it. Read-only.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "rule id, e.g. AP-002";
+            };
+            readonly path: {
+                readonly type: "string";
+                readonly description: "app or monorepo-root directory (default \".\")";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}];
+export declare function runTool(name: string, args: Record<string, unknown>): unknown;
+export type { ToolResponse };
+export declare function callTool(name: string, args: Record<string, unknown>): ToolResponse;
+export declare function createServer(version: string): Server;
+export declare function startMcpServer(version: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAInE,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwCR,CAAC;AAEX,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAe5E;AAED,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAMlF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQpD;AAGD,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE"}

package/dist/mcp/server.js

@@ -0,0 +1,82 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { explainTool, recommendTool, scanTool } from './tools.js';
+import { errorResponse, okResponse } from './tool-response.js';
+export const TOOLS = [
+    {
+        name: 'archprint_scan',
+        description: 'List the architecture rules this TypeScript repo already follows, with the evidence: which families are AUTO (clears the confidence gate) or SUGGEST (short of it, worth review), how many files conform vs. break each, and the confidence. Read-only. `path` defaults to "." and a monorepo root scans every app.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'app or monorepo-root directory (default ".")' },
+                deep: {
+                    type: 'boolean',
+                    description: 'resolve imports through barrels and aliases (slower, more accurate)',
+                },
+            },
+        },
+    },
+    {
+        name: 'archprint_recommend',
+        description: 'Recommend an architecture rule set for this repo from its evidence and detected stack: what to enforce now, what to review before enforcing, and what comparable repos commonly adopt that this repo does not yet. Read-only.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'app or monorepo-root directory (default ".")' },
+            },
+        },
+    },
+    {
+        name: 'archprint_explain',
+        description: 'Explain the confidence-gate evidence behind one inferred rule id (e.g. AP-002): its gate status, conformance stats, and the files that violate it. Read-only.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'rule id, e.g. AP-002' },
+                path: { type: 'string', description: 'app or monorepo-root directory (default ".")' },
+            },
+            required: ['id'],
+        },
+    },
+];
+export function runTool(name, args) {
+    const input = typeof args.path === 'string' ? args.path : '.';
+    switch (name) {
+        case 'archprint_scan':
+            return { apps: scanTool(input, args.deep === true) };
+        case 'archprint_recommend':
+            return { apps: recommendTool(input) };
+        case 'archprint_explain':
+            if (typeof args.id !== 'string' || args.id === '') {
+                throw new Error('archprint_explain requires an "id" (for example AP-002).');
+            }
+            return explainTool(args.id, input);
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+export function callTool(name, args) {
+    try {
+        return okResponse(runTool(name, args));
+    }
+    catch (error) {
+        return errorResponse(error);
+    }
+}
+export function createServer(version) {
+    const server = new Server({ name: 'archprint', version }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: TOOLS }));
+    server.setRequestHandler(CallToolRequestSchema, (request) => {
+        const { content, isError } = callTool(request.params.name, request.params.arguments ?? {});
+        return { content, isError };
+    });
+    return server;
+}
+/* v8 ignore start -- stdio transport glue: connects the tested server to the process stdio */
+export async function startMcpServer(version) {
+    await createServer(version).connect(new StdioServerTransport());
+}
+/* v8 ignore stop */
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tool-response.d.ts

@@ -0,0 +1,10 @@
+export interface ToolResponse {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+}
+export declare function okResponse(value: unknown): ToolResponse;
+export declare function errorResponse(error: unknown): ToolResponse;
+//# sourceMappingURL=tool-response.d.ts.map

package/dist/mcp/tool-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-response.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAEvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAE1D"}

package/dist/mcp/tool-response.js

@@ -0,0 +1,7 @@
+export function okResponse(value) {
+    return { content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] };
+}
+export function errorResponse(error) {
+    return { content: [{ type: 'text', text: error.message }], isError: true };
+}
+//# sourceMappingURL=tool-response.js.map

package/dist/mcp/tool-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../src/mcp/tool-response.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACxF,CAAC"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,17 @@
+import { type ScanSummary } from '../cli/summary.js';
+import { type Recommendations } from '../cli/recommend.js';
+import type { DetectedPattern } from '../detector/pattern-detector.js';
+export interface AppScan extends ScanSummary {
+    app: string;
+}
+export declare function scanTool(input: string, deep?: boolean): AppScan[];
+export interface AppRecommendations extends Recommendations {
+    app: string;
+}
+export declare function recommendTool(input: string): AppRecommendations[];
+export interface ExplainResult {
+    app: string;
+    pattern: DetectedPattern;
+}
+export declare function explainTool(id: string, input: string): ExplainResult;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAevE,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,OAAO,EAAE,CAM/D;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAMjE;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CASpE"}

package/dist/mcp/tools.js

@@ -0,0 +1,39 @@
+import * as path from 'node:path';
+import { discoverAppDirs } from '../scanner/app-dirs.js';
+import { detectEnforcers } from '../scanner/enforcers.js';
+import { scanRepo } from '../cli/scan.js';
+import { toScanSummary } from '../cli/summary.js';
+import { buildRecommendations, detectStack } from '../cli/recommend.js';
+function resolveAppDirs(input) {
+    const root = path.resolve(input);
+    const dirs = discoverAppDirs(root);
+    if (dirs.length === 0) {
+        throw new Error(`No tsconfig.json found under ${root}. Point archprint at an app directory (a directory with a tsconfig.json); a monorepo root is fine.`);
+    }
+    return { root, dirs };
+}
+const displayApp = (dir, root) => path.relative(root, dir) || '.';
+export function scanTool(input, deep = false) {
+    const { root, dirs } = resolveAppDirs(input);
+    return dirs.map((dir) => ({
+        app: displayApp(dir, root),
+        ...toScanSummary(scanRepo(dir, { deep })),
+    }));
+}
+export function recommendTool(input) {
+    const { root, dirs } = resolveAppDirs(input);
+    return dirs.map((dir) => ({
+        app: displayApp(dir, root),
+        ...buildRecommendations(scanRepo(dir, { deep: false }), detectStack(dir), detectEnforcers(dir)),
+    }));
+}
+export function explainTool(id, input) {
+    const { root, dirs } = resolveAppDirs(input);
+    for (const dir of dirs) {
+        const pattern = scanRepo(dir, { deep: false }).patterns.find((candidate) => candidate.config.id.toLowerCase() === id.toLowerCase());
+        if (pattern)
+            return { app: displayApp(dir, root), pattern: pattern.result };
+    }
+    throw new Error(`No pattern "${id}" found under ${path.resolve(input)}.`);
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAoB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAG9F,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,oGAAoG,CACzI,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC;AAM1F,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,IAAI,GAAG,KAAK;IAClD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxB,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC;QAC1B,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;KAC1C,CAAC,CAAC,CAAC;AACN,CAAC;AAMD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxB,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC;QAC1B,GAAG,oBAAoB,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;KAChG,CAAC,CAAC,CAAC;AACN,CAAC;AAOD,MAAM,UAAU,WAAW,CAAC,EAAU,EAAE,KAAa;IACnD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAC1D,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,CACtE,CAAC;QACF,IAAI,OAAO;YAAE,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,iBAAiB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC5E,CAAC"}

package/dist/scanner/file-walker.d.ts

@@ -14,6 +14,7 @@ export interface ResolvedImport {
 }
 export declare function listSourceFiles(rootDir: string): string[];
 export declare function walkRepo(rootDir: string): WalkedFile[];
+export declare function isWorkspacePackagePath(filePath: string, workspacePackages: readonly string[]): boolean;
 export declare function createImportAnalyzer(appDir: string, options?: {
     resolve?: boolean;
 }): (absoluteFilePath: string) => ResolvedImport[];

package/dist/scanner/file-walker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-walker.d.ts","sourceRoot":"","sources":["../../src/scanner/file-walker.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AA2B9B,MAAM,WAAW,UAAW,SAAQ,kBAAkB;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBzD;AAaD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAkBtD;AAsFD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,CAAC,gBAAgB,EAAE,MAAM,KAAK,cAAc,EAAE,CAqIhD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,EAAE,CAEzF"}
+{"version":3,"file":"file-walker.d.ts","sourceRoot":"","sources":["../../src/scanner/file-walker.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AA2B9B,MAAM,WAAW,UAAW,SAAQ,kBAAkB;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBzD;AAaD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAkBtD;AAsFD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,OAAO,CAQT;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,CAAC,gBAAgB,EAAE,MAAM,KAAK,cAAc,EAAE,CAqKhD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,EAAE,CAEzF"}