@shanyucoder/flowgrid 0.1.0

package/dist/docs/cli/engines.js

@@ -0,0 +1,53 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { enginesRoot } from '../config/docs-root.js';
+const ENGINE_FILES = {
+    split: path.join('spec', 'split-bundle.mjs'),
+    merge: path.join('spec', 'merge-bundle.mjs'),
+    check: path.join('spec', 'split-bundle.mjs'),
+    split_all: path.join('spec', 'split-all.mjs'),
+    normalize: path.join('spec', 'normalize-bundle-gen.mjs'),
+    render: path.join('docs', 'render-docs.mjs'),
+    publish: path.join('docs', 'publish.mjs'),
+    legacy_validate: path.join('spec', 'legacy-dynamics-validate.mjs'),
+    extract_i18n: path.join('spec', 'extract-i18n.mjs'),
+    openapi_render: path.join('openapi', 'render-openapi.mjs'),
+    openapi_build_ui: path.join('openapi', 'build-openapi-ui.mjs'),
+    openapi_gen: path.join('openapi', 'gen-openapi.mjs'),
+};
+export function runEngine(name, args, opts = {}) {
+    const script = path.join(enginesRoot(), ENGINE_FILES[name]);
+    const cwd = path.resolve(opts.cwd ?? process.cwd());
+    const argv = [script];
+    if (name === 'check')
+        argv.push('--check');
+    if (opts.extraArgs?.length)
+        argv.push(...opts.extraArgs);
+    argv.push(...args);
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, argv, {
+            cwd,
+            env: process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on('close', (code) => {
+            resolve({
+                ok: code === 0,
+                code,
+                stdout,
+                stderr,
+                command: [process.execPath, ...argv],
+                cwd,
+            });
+        });
+    });
+}
+//# sourceMappingURL=engines.js.map

package/dist/docs/cli/engines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engines.js","sourceRoot":"","sources":["../../../src/docs/cli/engines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAgBpD,MAAM,YAAY,GAA+B;IAC/C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAC5C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAC5C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAC5C,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC;IAC7C,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,0BAA0B,CAAC;IACxD,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAC5C,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;IACzC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAClE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACnD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAC1D,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC9D,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACrD,CAAA;AAWD,MAAM,UAAU,SAAS,CACvB,IAAgB,EAChB,IAAc,EACd,OAA+C,EAAE;IAEjD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACnD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;IACrB,IAAI,IAAI,KAAK,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,IAAI,IAAI,CAAC,SAAS,EAAE,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;IACxD,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IAElB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC1C,GAAG;YACH,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAA;QACF,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC;gBACN,EAAE,EAAE,IAAI,KAAK,CAAC;gBACd,IAAI;gBACJ,MAAM;gBACN,MAAM;gBACN,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC;gBACpC,GAAG;aACJ,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/docs/config/docs-root.d.ts

@@ -0,0 +1,8 @@
+export declare function packageRoot(): string;
+export declare function looksLikeHub(abs: string): boolean;
+/**
+ * Best-effort root for local wiring. Empty when no project root is available.
+ */
+export declare function defaultDocsRoot(): string;
+export declare function resolveDocsRoot(explicit?: string): string;
+export declare function enginesRoot(): string;

package/dist/docs/config/docs-root.js

@@ -0,0 +1,66 @@
+/**
+ * Resolve docs hub root (any arc42 × C4 MD tree with architecture/).
+ *
+ * Order: explicit tool argument → FLOWGRID_DOCS_ROOT → cwd (if hub) → error.
+ * The package never remembers or searches for a target repository.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
+export function packageRoot() {
+    return pkgRoot;
+}
+export function looksLikeHub(abs) {
+    try {
+        if (fs.statSync(path.join(abs, 'architecture')).isDirectory())
+            return true;
+    }
+    catch { }
+    try {
+        if (fs.statSync(path.join(abs, 'architecture')).isDirectory())
+            return true;
+    }
+    catch { }
+    return false;
+}
+/**
+ * Best-effort root for local wiring. Empty when no project root is available.
+ */
+export function defaultDocsRoot() {
+    const fromEnv = process.env.FLOWGRID_DOCS_ROOT;
+    if (fromEnv)
+        return path.resolve(fromEnv);
+    if (looksLikeHub(process.cwd()))
+        return process.cwd();
+    return '';
+}
+export function resolveDocsRoot(explicit) {
+    if (explicit) {
+        const abs = path.resolve(explicit);
+        if (!fs.existsSync(abs))
+            throw new Error(`docsRoot not found: ${abs}`);
+        if (!looksLikeHub(abs)) {
+            throw new Error(`docsRoot missing architecture/: ${abs}`);
+        }
+        return abs;
+    }
+    const envRoot = process.env.FLOWGRID_DOCS_ROOT;
+    if (envRoot) {
+        const abs = path.resolve(envRoot);
+        if (!fs.existsSync(abs))
+            throw new Error(`FLOWGRID_DOCS_ROOT not found: ${abs}`);
+        if (!looksLikeHub(abs)) {
+            throw new Error(`FLOWGRID_DOCS_ROOT missing architecture/: ${abs}`);
+        }
+        return abs;
+    }
+    if (looksLikeHub(process.cwd()))
+        return process.cwd();
+    throw new Error('Cannot resolve docs root. Pass docsRoot to the tool, set FLOWGRID_DOCS_ROOT in MCP env, ' +
+        'or cd into a docs hub (must contain architecture/). Setup: flowgrid init');
+}
+export function enginesRoot() {
+    return path.join(packageRoot(), 'engines');
+}
+//# sourceMappingURL=docs-root.js.map

package/dist/docs/config/docs-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-root.js","sourceRoot":"","sources":["../../../src/docs/config/docs-root.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;AAEtF,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAA;IAC5E,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAA;IAC5E,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAC9C,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAA;IACrD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAA;QACtE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAA;QAC3D,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAC9C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;QAChF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,EAAE,CAAC,CAAA;QACrE,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,IAAI,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAA;IACrD,MAAM,IAAI,KAAK,CACb,0FAA0F;QACxF,0EAA0E,CAC7E,CAAA;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAA;AAC5C,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTools(server: McpServer): void;

package/dist/docs/mcp/tools.js

@@ -0,0 +1,351 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { resolveDocsRoot } from '../config/docs-root.js';
+import { CANONICAL_DIR, expectedCanonicalPath, indexIds, isRedirectStub, kindOf, relToRoot, walkMdFiles, SCAN_MD_DIRS, listFlowProcessFiles, } from '../scan/ids.js';
+import { depsFromFiles, dependentsOf, validateMdLinks } from '../scan/links.js';
+import { routeTopic } from '../scan/route.js';
+import { runEngine } from '../cli/engines.js';
+function text(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+async function toolEngine(name, paths, projectRoot, extraArgs = []) {
+    try {
+        const cwd = resolveDocsRoot(projectRoot);
+        const result = await runEngine(name, paths ?? [], { cwd, extraArgs });
+        return text({
+            ok: result.ok,
+            engine: name,
+            cwd,
+            code: result.code,
+            stdout: result.stdout.trim(),
+            stderr: result.stderr.trim(),
+        });
+    }
+    catch (err) {
+        return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+    }
+}
+function toRelIndex(docsRoot) {
+    const map = indexIds(docsRoot);
+    const out = new Map();
+    for (const [id, meta] of map) {
+        const files = meta.files.map((f) => (path.isAbsolute(f) ? relToRoot(docsRoot, f) : f));
+        out.set(id, {
+            id,
+            kind: meta.kind,
+            files,
+            primary: files[0],
+        });
+    }
+    return out;
+}
+function chapterHasId(docsRoot, id) {
+    const exp = expectedCanonicalPath(docsRoot, id);
+    if (!exp || !fs.existsSync(exp))
+        return false;
+    const body = fs.readFileSync(exp, 'utf8');
+    return body.includes(id);
+}
+export function registerTools(server) {
+    server.tool('flowgrid_docs_list_ids', 'List architecture/product IDs (CMP/FLOW/DEP/ADR/W/API/UI) from docs hub MD (skips redirect stubs)', {
+        docsRoot: z
+            .string()
+            .optional()
+            .describe('Hub root; defaults to project MCP FLOWGRID_DOCS_ROOT or a valid cwd'),
+        kind: z
+            .enum(['CMP', 'FLOW', 'DEP', 'ADR', 'W', 'API', 'UI', 'OTHER', 'ALL'])
+            .optional(),
+        prefix: z.string().optional(),
+    }, async ({ docsRoot, kind, prefix }) => {
+        try {
+            const root = resolveDocsRoot(docsRoot);
+            const index = toRelIndex(root);
+            let items = [...index.values()];
+            if (kind && kind !== 'ALL')
+                items = items.filter((i) => i.kind === kind);
+            if (prefix)
+                items = items.filter((i) => i.id.startsWith(prefix));
+            items.sort((a, b) => a.id.localeCompare(b.id));
+            return text({ docsRoot: root, count: items.length, ids: items });
+        }
+        catch (err) {
+            return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    server.tool('flowgrid_docs_get_element', 'Get primary + related files and short excerpts for one ID (canonical path first)', {
+        id: z.string(),
+        docsRoot: z.string().optional(),
+        maxChars: z.number().optional().default(1200),
+    }, async ({ id, docsRoot, maxChars }) => {
+        try {
+            const root = resolveDocsRoot(docsRoot);
+            const index = toRelIndex(root);
+            const meta = index.get(id);
+            if (!meta)
+                return text({ ok: false, error: 'not_found', id });
+            const cap = Math.min(maxChars ?? 1200, 8000);
+            const excerpts = meta.files.slice(0, 5).map((rel) => {
+                const abs = path.join(root, rel);
+                const body = fs.existsSync(abs) ? fs.readFileSync(abs, 'utf8') : '';
+                return { file: rel, excerpt: body.slice(0, cap) };
+            });
+            const expected = expectedCanonicalPath(root, id);
+            return text({
+                ok: true,
+                ...meta,
+                canonicalHome: CANONICAL_DIR[meta.kind] ?? null,
+                expectedPath: expected ? relToRoot(root, expected) : null,
+                excerpts,
+            });
+        }
+        catch (err) {
+            return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    server.tool('flowgrid_docs_deps_of', 'IDs referenced from files that define/mention this ID', {
+        id: z.string(),
+        docsRoot: z.string().optional(),
+    }, async ({ id, docsRoot }) => {
+        try {
+            const root = resolveDocsRoot(docsRoot);
+            const index = toRelIndex(root);
+            const meta = index.get(id);
+            if (!meta)
+                return text({ ok: false, error: 'not_found', id });
+            const absFiles = meta.files.map((f) => path.join(root, f));
+            const deps = depsFromFiles(absFiles, id);
+            return text({ ok: true, id, deps });
+        }
+        catch (err) {
+            return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    server.tool('flowgrid_docs_dependents_of', 'Other IDs whose files mention this ID', {
+        id: z.string(),
+        docsRoot: z.string().optional(),
+    }, async ({ id, docsRoot }) => {
+        try {
+            const root = resolveDocsRoot(docsRoot);
+            const index = indexIds(root);
+            if (!index.has(id))
+                return text({ ok: false, error: 'not_found', id });
+            const deps = dependentsOf(id, index, root);
+            return text({ ok: true, id, dependents: deps });
+        }
+        catch (err) {
+            return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    server.tool('flowgrid_docs_orphans', 'Heuristic orphans vs arc42 layout: missing FLOW/ADR/CMP/W/API files; heading IDs missing from chapter', {
+        docsRoot: z.string().optional(),
+    }, async ({ docsRoot }) => {
+        try {
+            const root = resolveDocsRoot(docsRoot);
+            const index = toRelIndex(root);
+            const missingCanonical = [];
+            const missingInChapter = [];
+            for (const id of index.keys()) {
+                const kind = kindOf(id);
+                if (kind === 'FLOW' || kind === 'ADR' || kind === 'CMP' || kind === 'W' || kind === 'API' || kind === 'UI') {
+                    const exp = expectedCanonicalPath(root, id);
+                    if (!exp)
+                        continue;
+                    const ok = fs.existsSync(exp) ||
+                        fs.existsSync(exp.replace(/\.md$/, '/index.md')) ||
+                        fs.existsSync(path.dirname(exp));
+                    // W/API/UI: folder existence counts
+                    const folderOk = (kind === 'W' || kind === 'API' || kind === 'UI') &&
+                        exp &&
+                        fs.existsSync(path.dirname(exp));
+                    if (!ok && !folderOk) {
+                        const meta = index.get(id);
+                        const hasOwn = kind === 'FLOW'
+                            ? meta.files.some((f) => f.includes(`journeys/${id}`))
+                            : meta.primary?.includes(id);
+                        if (!hasOwn) {
+                            missingCanonical.push({ id, kind, expected: relToRoot(root, exp) });
+                        }
+                    }
+                    continue;
+                }
+                if (kind === 'DEP') {
+                    if (!chapterHasId(root, id)) {
+                        const home = CANONICAL_DIR[kind] ?? '?';
+                        missingInChapter.push({ id, kind, chapter: `${home}/index.md` });
+                    }
+                }
+            }
+            const catalogPath = path.join(root, 'architecture/06-runtime/index.md');
+            const catalogTbd = [];
+            if (fs.existsSync(catalogPath)) {
+                for (const line of fs.readFileSync(catalogPath, 'utf8').split('\n')) {
+                    if (/FLOW-[a-z0-9-]+/i.test(line) && /\bTBD\b|\bdraft\b/i.test(line)) {
+                        const m = line.match(/FLOW-[A-Za-z0-9-]+/);
+                        if (m)
+                            catalogTbd.push(m[0]);
+                    }
+                }
+            }
+            return text({
+                ok: true,
+                missingCanonical,
+                missingInChapter,
+                catalogDraftOrTbd: catalogTbd,
+                note: 'Redirect stubs (landscape|context|containers|dynamics|deployments|shared/adr) are ignored. DYN-* not indexed.',
+            });
+        }
+        catch (err) {
+            return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    server.tool('flowgrid_docs_validate_links', 'Find broken MD links under architecture/ + product (skips redirect-stub sources)', {
+        docsRoot: z.string().optional(),
+        includeProduct: z.boolean().optional().default(true),
+    }, async ({ docsRoot, includeProduct }) => {
+        try {
+            const root = resolveDocsRoot(docsRoot);
+            const dirs = includeProduct
+                ? ['architecture', 'Overview', 'Surfaces', 'Architecture']
+                : ['architecture'];
+            const files = walkMdFiles(root, dirs).filter((f) => !isRedirectStub(f, root));
+            const broken = validateMdLinks(root, files).map((h) => ({
+                ...h,
+                file: relToRoot(root, h.file),
+            }));
+            return text({
+                ok: broken.length === 0,
+                brokenCount: broken.length,
+                broken: broken.slice(0, 100),
+            });
+        }
+        catch (err) {
+            return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    server.tool('flowgrid_docs_route', 'Map a natural-language topic to arc42 chapter path + skill (/architecture router helper)', {
+        topic: z.string().describe('e.g. "login sequence", "ADR auth"'),
+    }, async ({ topic }) => {
+        return text({ ok: true, topic, routes: routeTopic(topic) });
+    });
+    server.tool('flowgrid_docs_business_processes', 'List FLOW-* under architecture/03-business-process and surfaces/**/common/processes', {
+        docsRoot: z.string().optional(),
+    }, async ({ docsRoot }) => {
+        try {
+            const root = resolveDocsRoot(docsRoot);
+            const processes = listFlowProcessFiles(root);
+            return text({
+                ok: true,
+                count: processes.length,
+                catalog: 'architecture/03-business-process/index.md',
+                processes,
+            });
+        }
+        catch (err) {
+            return text({ ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    server.tool('flowgrid_docs_layout', 'Describe expected arc42 × C4 docs hub layout (canonical paths per ID kind)', {}, async () => {
+        return text({
+            ok: true,
+            chapters: 'architecture/01 … architecture/12',
+            redirectStubsIgnored: [
+                'architecture/landscape',
+                'architecture/context',
+                'architecture/containers',
+                'architecture/dynamics',
+                'architecture/deployments',
+                'shared/adr',
+            ],
+            idHomes: CANONICAL_DIR,
+            scanDirs: SCAN_MD_DIRS,
+            notes: [
+                'DEP is a heading inside chapter index.md — not separate files',
+                'FLOW-* under architecture/03-business-process/ and surfaces/**/common/processes/',
+                'ADR-* under architecture/09-decisions/',
+                'CMP/W/API/UI under Surfaces/ — never under architecture/05 code/',
+                'DYN-* deprecated — use FLOW-* + /business-process',
+            ],
+        });
+    });
+    const rootField = {
+        projectRoot: z
+            .string()
+            .optional()
+            .describe('Docs hub root; defaults to FLOWGRID_DOCS_ROOT or cwd'),
+    };
+    server.tool('flowgrid_docs_bundle_split', 'Split one or more *.bundle.yaml files into ir/* and colocated spec Markdown (docs-hub)', {
+        ...rootField,
+        paths: z.array(z.string()).describe('Bundle YAML paths relative to project root or absolute'),
+    }, async ({ projectRoot, paths }) => toolEngine('split', paths, projectRoot));
+    server.tool('flowgrid_docs_bundle_merge', 'Merge ir/* back into *.bundle.yaml', {
+        ...rootField,
+        paths: z.array(z.string()),
+    }, async ({ projectRoot, paths }) => toolEngine('merge', paths, projectRoot));
+    server.tool('flowgrid_docs_bundle_check', 'Check that ir/* matches split output for bundles', {
+        ...rootField,
+        paths: z.array(z.string()),
+    }, async ({ projectRoot, paths }) => toolEngine('check', paths, projectRoot));
+    server.tool('flowgrid_docs_bundle_split_all', 'Split all bundles under a yaml root (default product or --root)', {
+        ...rootField,
+        root: z.string().optional().describe('Optional yaml root relative to project'),
+        check: z.boolean().optional(),
+    }, async ({ projectRoot, root, check }) => {
+        const extra = [];
+        if (root)
+            extra.push('--root', root);
+        if (check)
+            extra.push('--check');
+        return toolEngine('split_all', [], projectRoot, extra);
+    });
+    server.tool('flowgrid_docs_bundle_normalize', 'Normalize bundle.gen sections', {
+        ...rootField,
+        paths: z.array(z.string()),
+    }, async ({ projectRoot, paths }) => toolEngine('normalize', paths, projectRoot));
+    server.tool('flowgrid_docs_docs_render', 'Render design Markdown from product YAML/bundles (no testcase MD)', {
+        ...rootField,
+        yamlRoot: z.string().optional(),
+        mdRoot: z.string().optional(),
+        legacyRoot: z.string().optional(),
+        noIndex: z.boolean().optional().default(true),
+    }, async ({ projectRoot, yamlRoot, mdRoot, legacyRoot, noIndex }) => {
+        const extra = [];
+        if (yamlRoot)
+            extra.push('--yaml-root', yamlRoot);
+        if (mdRoot)
+            extra.push('--md-root', mdRoot);
+        if (legacyRoot)
+            extra.push('--legacy-root', legacyRoot);
+        if (noIndex !== false)
+            extra.push('--no-index');
+        return toolEngine('render', [], projectRoot, extra);
+    });
+    server.tool('flowgrid_docs_docs_publish', 'Write CATALOG.md + README link from existing ir/generated + qa/index.md (does not re-render specs)', {
+        ...rootField,
+    }, async ({ projectRoot }) => toolEngine('publish', [], projectRoot));
+    server.tool('flowgrid_docs_docs_render_common', 'Render common UI design MD under Surfaces/Common', {
+        ...rootField,
+    }, async ({ projectRoot }) => {
+        const rootPath = projectRoot || process.cwd();
+        const isLowercase = fs.existsSync(path.join(rootPath, 'surfaces', 'common'));
+        const yamlRoot = isLowercase ? 'surfaces/common/yaml' : 'Surfaces/Common/yaml';
+        const mdRoot = isLowercase ? 'surfaces/common/md' : 'Surfaces/Common/md';
+        const legacyRoot = isLowercase ? 'surfaces/common' : 'Surfaces/Common';
+        return toolEngine('render', [], projectRoot, [
+            '--yaml-root',
+            yamlRoot,
+            '--md-root',
+            mdRoot,
+            '--legacy-root',
+            legacyRoot,
+            '--no-index',
+        ]);
+    });
+    server.tool('flowgrid_docs_legacy_dynamics_validate', 'Validate portal-legacy-dynamics YAML module files', {
+        ...rootField,
+        paths: z.array(z.string()),
+    }, async ({ projectRoot, paths }) => toolEngine('legacy_validate', paths, projectRoot));
+}
+//# sourceMappingURL=tools.js.map

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

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

package/dist/docs/scan/ids.d.ts

@@ -0,0 +1,29 @@
+export type IdKind = 'CMP' | 'FLOW' | 'DEP' | 'ADR' | 'W' | 'API' | 'UI' | 'OTHER';
+export type HubId = {
+    id: string;
+    kind: IdKind;
+    files: string[];
+    /** First file under the canonical chapter/product path when known */
+    primary?: string;
+};
+/** Scan roots for MD (arc42 × product). */
+export declare const SCAN_MD_DIRS: readonly ["architecture", "overview", "surfaces"];
+/** Canonical home for each ID kind (architecture-core). */
+export declare const CANONICAL_DIR: Partial<Record<IdKind, string>>;
+export declare function kindOf(id: string): IdKind;
+export declare function isRedirectStub(relOrAbs: string, docsRoot?: string): boolean;
+export declare function walkMdFiles(root: string, relDirs: string[]): string[];
+export declare function extractIdsFromText(text: string): Set<string>;
+export declare function indexIds(docsRoot: string): Map<string, HubId>;
+export declare function relToRoot(docsRoot: string, abs: string): string;
+declare function flowMetaFromFile(docsRoot: string, abs: string): {
+    id: string;
+    file: string;
+    domain: string | undefined;
+    status: string | undefined;
+};
+/** Catalog FLOW-*.md plus LCA common/processes (dedupe by id, catalog wins). */
+export declare function listFlowProcessFiles(docsRoot: string): ReturnType<typeof flowMetaFromFile>[];
+/** Expected on-disk path for kinds that have a file/folder SSOT. */
+export declare function expectedCanonicalPath(docsRoot: string, id: string): string | null;
+export {};