living-ai-documentation 1.0.0

package/dist/src/routes/metadata.js

@@ -0,0 +1,131 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metadataRouter = metadataRouter;
+const express_1 = require("express");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const metadata_1 = require("../lib/metadata");
+const hash_1 = require("../lib/hash");
+const status_1 = require("../lib/status");
+// SuperSeeded documents are read-only as far as metadata is concerned: an ADR
+// that has been replaced should keep the source bindings that prove what the
+// original decision described, frozen at the moment of supersession. The guard
+// itself lives in `lib/status.ts` so MCP tools share the same check.
+function rejectIfSuperSeeded(docsPath, docId, res) {
+    try {
+        (0, status_1.assertNotSuperSeeded)(docsPath, docId);
+        return false;
+    }
+    catch (err) {
+        if (err instanceof status_1.DocumentSuperSeededError) {
+            res.status(403).json({ error: err.message });
+            return true;
+        }
+        throw err;
+    }
+}
+function metadataRouter(docsPath) {
+    const router = (0, express_1.Router)();
+    // GET /api/metadata/:docId → { items, total, unchanged, modified, missing, accuracy }
+    router.get("/:docId", (req, res) => {
+        const docId = decodeURIComponent(req.params.docId);
+        try {
+            const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+            const entries = (0, metadata_1.getDocEntries)(docsPath, docId);
+            const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+            res.json(report);
+        }
+        catch (err) {
+            res
+                .status(500)
+                .json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /api/metadata/:docId  body: { path }
+    router.post("/:docId", (req, res) => {
+        const docId = decodeURIComponent(req.params.docId);
+        if (rejectIfSuperSeeded(docsPath, docId, res))
+            return;
+        const { path: rawPath } = req.body;
+        if (!rawPath || typeof rawPath !== "string") {
+            return res.status(400).json({ error: "path is required" });
+        }
+        try {
+            const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+            const rel = (0, metadata_1.assertUnderSourceRoot)(rawPath, sourceRoot);
+            const abs = path_1.default.resolve(sourceRoot, rel);
+            if (!fs_1.default.existsSync(abs) || !fs_1.default.statSync(abs).isFile()) {
+                return res.status(400).json({ error: "Not a readable file" });
+            }
+            const hash = (0, hash_1.sha256File)(abs);
+            if (!hash)
+                return res.status(500).json({ error: "Failed to hash file" });
+            const entries = (0, metadata_1.getDocEntries)(docsPath, docId);
+            // replace if path already exists, else append
+            const idx = entries.findIndex((e) => e.path === rel);
+            const entry = { path: rel, hash };
+            if (idx >= 0)
+                entries[idx] = entry;
+            else
+                entries.push(entry);
+            (0, metadata_1.setDocEntries)(docsPath, docId, entries);
+            const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+            res.json(report);
+        }
+        catch (err) {
+            res
+                .status(400)
+                .json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // DELETE /api/metadata/:docId  body: { path }
+    router.delete("/:docId", (req, res) => {
+        const docId = decodeURIComponent(req.params.docId);
+        if (rejectIfSuperSeeded(docsPath, docId, res))
+            return;
+        const { path: rel } = req.body;
+        if (!rel)
+            return res.status(400).json({ error: "path is required" });
+        try {
+            const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+            const entries = (0, metadata_1.getDocEntries)(docsPath, docId).filter((e) => e.path !== rel);
+            (0, metadata_1.setDocEntries)(docsPath, docId, entries);
+            const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+            res.json(report);
+        }
+        catch (err) {
+            res
+                .status(500)
+                .json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /api/metadata/:docId/refresh → recompute stored hashes from current file state
+    router.post("/:docId/refresh", (req, res) => {
+        const docId = decodeURIComponent(req.params.docId);
+        if (rejectIfSuperSeeded(docsPath, docId, res))
+            return;
+        try {
+            const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+            const entries = (0, metadata_1.getDocEntries)(docsPath, docId).map((e) => {
+                const abs = path_1.default.resolve(sourceRoot, e.path);
+                if (!fs_1.default.existsSync(abs))
+                    return e; // keep stored hash, still "missing"
+                const fresh = (0, hash_1.sha256File)(abs);
+                return fresh ? { path: e.path, hash: fresh } : e;
+            });
+            (0, metadata_1.setDocEntries)(docsPath, docId, entries);
+            const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+            res.json(report);
+        }
+        catch (err) {
+            res
+                .status(500)
+                .json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/src/routes/metadata.js.map

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

package/dist/src/routes/shape-libraries.d.ts

@@ -0,0 +1,3 @@
+import { Router } from "express";
+export declare function shapeLibrariesRouter(docsPath: string): Router;
+//# sourceMappingURL=shape-libraries.d.ts.map

package/dist/src/routes/shape-libraries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-libraries.d.ts","sourceRoot":"","sources":["../../../src/routes/shape-libraries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAoJjC,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc7D"}

package/dist/src/routes/shape-libraries.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shapeLibrariesRouter = shapeLibrariesRouter;
+const express_1 = require("express");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const FILE_NAME = ".shape-libraries.json";
+const CUSTOM_SHAPE_DEFAULT_SIZE = 65;
+const CUSTOM_SHAPE_MIN_SIZE = 16;
+const CUSTOM_SHAPE_MAX_SIZE = 1200;
+function filePath(docsPath) {
+    return path_1.default.join(docsPath, FILE_NAME);
+}
+function loadStore(docsPath) {
+    const fp = filePath(docsPath);
+    if (!fs_1.default.existsSync(fp))
+        return { libraries: [] };
+    try {
+        const raw = JSON.parse(fs_1.default.readFileSync(fp, "utf-8"));
+        return sanitizeStore(raw);
+    }
+    catch {
+        return { libraries: [] };
+    }
+}
+function saveStore(docsPath, store) {
+    fs_1.default.writeFileSync(filePath(docsPath), JSON.stringify(sanitizeStore(store), null, 2), "utf-8");
+}
+function clamp01(n) {
+    return Math.max(0, Math.min(1, typeof n === "number" && Number.isFinite(n) ? n : 0));
+}
+function safeId(value, fallback) {
+    if (typeof value !== "string")
+        return fallback;
+    const clean = value
+        .trim()
+        .replace(/[^a-zA-Z0-9_-]/g, "-")
+        .slice(0, 80);
+    return clean || fallback;
+}
+function safeName(value, fallback) {
+    if (typeof value !== "string")
+        return fallback;
+    const clean = value.trim().slice(0, 120);
+    return clean || fallback;
+}
+function safeLabelPlacement(value) {
+    return ["center", "below", "above", "right", "left"].includes(String(value))
+        ? value
+        : "below";
+}
+function safeDimension(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? Math.max(CUSTOM_SHAPE_MIN_SIZE, Math.min(CUSTOM_SHAPE_MAX_SIZE, Math.round(value)))
+        : CUSTOM_SHAPE_DEFAULT_SIZE;
+}
+function sanitizeStore(raw) {
+    const obj = raw && typeof raw === "object" ? raw : {};
+    const rawLibraries = Array.isArray(obj.libraries) ? obj.libraries : [];
+    const libraries = rawLibraries.map((lib, libIndex) => {
+        const libObj = lib && typeof lib === "object" ? lib : {};
+        const shapesRaw = Array.isArray(libObj.shapes) ? libObj.shapes : [];
+        return {
+            id: safeId(libObj.id, `lib-${libIndex + 1}`),
+            name: safeName(libObj.name, `Library ${libIndex + 1}`),
+            shapes: shapesRaw
+                .map((shape, shapeIndex) => {
+                const shapeObj = shape && typeof shape === "object"
+                    ? shape
+                    : {};
+                const anchorsRaw = Array.isArray(shapeObj.anchors)
+                    ? shapeObj.anchors
+                    : [];
+                const width = safeDimension(shapeObj.width);
+                const height = safeDimension(shapeObj.height);
+                return {
+                    id: safeId(shapeObj.id, `shape-${shapeIndex + 1}`),
+                    name: safeName(shapeObj.name, `Shape ${shapeIndex + 1}`),
+                    imageSrc: typeof shapeObj.imageSrc === "string" ? shapeObj.imageSrc : "",
+                    width,
+                    height,
+                    labelPlacement: safeLabelPlacement(shapeObj.labelPlacement),
+                    showInDiagram: shapeObj.showInDiagram !== false,
+                    anchors: anchorsRaw
+                        .map((anchor, anchorIndex) => {
+                        const anchorObj = anchor && typeof anchor === "object"
+                            ? anchor
+                            : {};
+                        return {
+                            id: safeId(anchorObj.id, `p${anchorIndex + 1}`),
+                            x: clamp01(anchorObj.x),
+                            y: clamp01(anchorObj.y),
+                        };
+                    })
+                        .filter((anchor) => anchor.id),
+                };
+            })
+                .filter((shape) => shape.imageSrc),
+        };
+    });
+    return { libraries };
+}
+function shapeLibrariesRouter(docsPath) {
+    const router = (0, express_1.Router)();
+    router.get("/", (_req, res) => {
+        res.json(loadStore(docsPath));
+    });
+    router.put("/", (req, res) => {
+        const store = sanitizeStore(req.body);
+        saveStore(docsPath, store);
+        res.json(store);
+    });
+    return router;
+}
+//# sourceMappingURL=shape-libraries.js.map

package/dist/src/routes/shape-libraries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-libraries.js","sourceRoot":"","sources":["../../../src/routes/shape-libraries.ts"],"names":[],"mappings":";;;;;AAoJA,oDAcC;AAlKD,qCAAiC;AACjC,4CAAoB;AACpB,gDAAwB;AA6BxB,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAC1C,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QACrD,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,KAAwB;IAC3D,YAAE,CAAC,aAAa,CACd,QAAQ,CAAC,QAAQ,CAAC,EAClB,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAC7C,OAAO,CACR,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,CAAU;IACzB,OAAO,IAAI,CAAC,GAAG,CACb,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,QAAgB;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK;SAChB,IAAI,EAAE;SACN,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,KAAK,IAAI,QAAQ,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,OAAO,KAAK,IAAI,QAAQ,CAAC;AAC3B,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1E,CAAC,CAAE,KAAuC;QAC1C,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACxD,CAAC,CAAC,IAAI,CAAC,GAAG,CACN,qBAAqB,EACrB,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CACnD;QACH,CAAC,CAAC,yBAAyB,CAAC;AAChC,CAAC;AAED,SAAS,aAAa,CAAC,GAAY;IACjC,MAAM,GAAG,GACP,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAgB,EAAE;QACjE,MAAM,MAAM,GACV,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,QAAQ,GAAG,CAAC,EAAE,CAAC;YAC5C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,QAAQ,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,EAAE,SAAS;iBACd,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,EAAe,EAAE;gBACtC,MAAM,QAAQ,GACZ,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAChC,CAAC,CAAE,KAAiC;oBACpC,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAChD,CAAC,CAAC,QAAQ,CAAC,OAAO;oBAClB,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC9C,OAAO;oBACL,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,UAAU,GAAG,CAAC,EAAE,CAAC;oBAClD,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,GAAG,CAAC,EAAE,CAAC;oBACxD,QAAQ,EACN,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;oBAChE,KAAK;oBACL,MAAM;oBACN,cAAc,EAAE,kBAAkB,CAAC,QAAQ,CAAC,cAAc,CAAC;oBAC3D,aAAa,EAAE,QAAQ,CAAC,aAAa,KAAK,KAAK;oBAC/C,OAAO,EAAE,UAAU;yBAChB,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAe,EAAE;wBACxC,MAAM,SAAS,GACb,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;4BAClC,CAAC,CAAE,MAAkC;4BACrC,CAAC,CAAC,EAAE,CAAC;wBACT,OAAO;4BACL,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;4BAC/C,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;4BACvB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;yBACxB,CAAC;oBACJ,CAAC,CAAC;yBACD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;iBACjC,CAAC;YACJ,CAAC,CAAC;iBACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,MAAM,MAAM,GAAG,IAAA,gBAAM,GAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC5B,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/routes/wordcloud.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+export declare function wordcloudRouter(): Router;
+//# sourceMappingURL=wordcloud.d.ts.map

package/dist/src/routes/wordcloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wordcloud.d.ts","sourceRoot":"","sources":["../../../src/routes/wordcloud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAoCpD,wBAAgB,eAAe,IAAI,MAAM,CAiDxC"}

package/dist/src/routes/wordcloud.js

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wordcloudRouter = wordcloudRouter;
+const express_1 = require("express");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', '.idea', '.vscode', '__pycache__',
+    'target', 'build', 'dist', '.next', 'vendor', '.gradle',
+    'out', 'coverage', '.cache', 'tmp', '.tmp', '.turbo',
+    '.svelte-kit', '.nuxt', '.output', 'storybook-static',
+    'public', 'static', '.vercel', '.netlify',
+]);
+function collectFiles(dir, exts, excludeDirs, rootDir, out = []) {
+    let entries;
+    try {
+        entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const e of entries) {
+        if (e.isDirectory()) {
+            if (e.name.startsWith('.') || SKIP_DIRS.has(e.name))
+                continue;
+            const relPath = path_1.default.relative(rootDir, path_1.default.join(dir, e.name));
+            if (excludeDirs.has(e.name) || excludeDirs.has(relPath))
+                continue;
+            collectFiles(path_1.default.join(dir, e.name), exts, excludeDirs, rootDir, out);
+        }
+        else if (e.isFile()) {
+            const ext = path_1.default.extname(e.name).slice(1).toLowerCase();
+            if (!exts.includes(ext))
+                continue;
+            const relPath = path_1.default.relative(rootDir, path_1.default.join(dir, e.name));
+            if (excludeDirs.has(e.name) || excludeDirs.has(relPath))
+                continue;
+            out.push(path_1.default.join(dir, e.name));
+        }
+    }
+    return out;
+}
+function wordcloudRouter() {
+    const router = (0, express_1.Router)();
+    // GET /api/wordcloud?path=<absolute_path>&ext=md&ext=ts&ext=java
+    // Returns { files: number, fileTexts: [{path, text}] }
+    router.get('/', (req, res) => {
+        const rawPath = req.query.path || '/';
+        const target = path_1.default.resolve(rawPath);
+        // Parse params directly from the raw query string to avoid qs object coercion.
+        const rawQuery = req.url.split('?')[1] || '';
+        const qp = new URLSearchParams(rawQuery);
+        const exts = qp.getAll('ext')
+            .map((e) => e.toLowerCase().replace(/^\./, ''))
+            .filter(Boolean);
+        if (!exts.length)
+            exts.push('md');
+        const excludeDirs = new Set(qp.getAll('exclude').map((d) => d.replace(/\/$/, '')).filter(Boolean));
+        let stat;
+        try {
+            stat = fs_1.default.statSync(target);
+        }
+        catch {
+            res.status(400).json({ error: 'Path not found' });
+            return;
+        }
+        let files;
+        if (stat.isFile()) {
+            const ext = path_1.default.extname(target).slice(1).toLowerCase();
+            files = exts.includes(ext) ? [target] : [];
+        }
+        else if (stat.isDirectory()) {
+            files = collectFiles(target, exts, excludeDirs, target);
+        }
+        else {
+            res.status(400).json({ error: 'Path must be a directory or a file' });
+            return;
+        }
+        const fileTexts = files.map((f) => ({
+            path: path_1.default.relative(target, f),
+            text: (() => { try {
+                return fs_1.default.readFileSync(f, 'utf-8');
+            }
+            catch {
+                return '';
+            } })(),
+        }));
+        res.json({ files: files.length, fileTexts });
+    });
+    return router;
+}
+//# sourceMappingURL=wordcloud.js.map

package/dist/src/routes/wordcloud.js.map

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

package/dist/src/server.d.ts

@@ -0,0 +1,7 @@
+export interface ServerOptions {
+    docsPath: string;
+    port: number;
+    openBrowser?: boolean;
+}
+export declare function startServer({ docsPath, port, openBrowser, }: ServerOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,WAAW,CAAC,EAChC,QAAQ,EACR,IAAI,EACJ,WAAmB,GACpB,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4E/B"}

package/dist/src/server.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = startServer;
+const express_1 = __importDefault(require("express"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const documents_1 = require("./routes/documents");
+const config_1 = require("./routes/config");
+const browse_1 = require("./routes/browse");
+const images_1 = require("./routes/images");
+const files_1 = require("./routes/files");
+const diagrams_1 = require("./routes/diagrams");
+const shape_libraries_1 = require("./routes/shape-libraries");
+const wordcloud_1 = require("./routes/wordcloud");
+const annotations_1 = require("./routes/annotations");
+const metadata_1 = require("./routes/metadata");
+const browse_source_1 = require("./routes/browse-source");
+const export_1 = require("./routes/export");
+const context_1 = require("./routes/context");
+const server_1 = require("./mcp/server");
+const config_2 = require("./lib/config");
+const activeServers = new Set();
+async function startServer({ docsPath, port, openBrowser = false, }) {
+    const app = (0, express_1.default)();
+    app.use(express_1.default.json({ limit: '20mb' }));
+    // Persist port to .living-doc.json; readAndMigrate runs here and strips any legacy absolute paths.
+    (0, config_2.writeConfig)(docsPath, { port });
+    // API
+    app.use('/api/documents', (0, documents_1.documentsRouter)(docsPath));
+    app.use('/api/config', (0, config_1.configRouter)(docsPath));
+    app.use('/api/browse', (0, browse_1.browseRouter)(docsPath));
+    app.use('/api/images', (0, images_1.imagesRouter)(docsPath));
+    app.use('/api/files', (0, files_1.filesRouter)(docsPath));
+    app.use('/api/diagrams', (0, diagrams_1.diagramsRouter)(docsPath));
+    app.use('/api/shape-libraries', (0, shape_libraries_1.shapeLibrariesRouter)(docsPath));
+    app.use('/api/wordcloud', (0, wordcloud_1.wordcloudRouter)());
+    app.use('/api/annotations', (0, annotations_1.annotationsRouter)(docsPath));
+    app.use('/api/metadata', (0, metadata_1.metadataRouter)(docsPath));
+    app.use('/api/browse-source', (0, browse_source_1.browseSourceRouter)(docsPath));
+    app.use('/api/export', (0, export_1.exportRouter)(docsPath));
+    app.use('/api/context', (0, context_1.contextRouter)(docsPath));
+    app.use('/mcp', (0, server_1.mcpRouter)(docsPath));
+    // Static frontend assets
+    // dotfiles: 'allow' so the npx cache (~/.npm/_npx/...) doesn't trip send's
+    // dotfile guard on the .npm path segment and 404 every asset.
+    const frontendPath = path_1.default.join(__dirname, 'frontend');
+    app.use(express_1.default.static(frontendPath, { dotfiles: 'allow' }));
+    // Static assets from docs folder (images, etc.)
+    app.use('/images', express_1.default.static(path_1.default.join(docsPath, 'images'), { dotfiles: 'allow' }));
+    app.use('/files', express_1.default.static(path_1.default.join(docsPath, 'files'), { dotfiles: 'allow' }));
+    app.get('/', (_req, res) => res.sendFile(path_1.default.join(frontendPath, 'index.html'), { dotfiles: 'allow' }));
+    app.get('/admin', (_req, res) => res.sendFile(path_1.default.join(frontendPath, 'admin.html'), { dotfiles: 'allow' }));
+    app.get('/diagram', (_req, res) => res.sendFile(path_1.default.join(frontendPath, 'diagram.html'), { dotfiles: 'allow' }));
+    app.get('/shape-editor', (_req, res) => res.sendFile(path_1.default.join(frontendPath, 'shape-editor.html'), { dotfiles: 'allow' }));
+    app.get('/context', (_req, res) => res.sendFile(path_1.default.join(frontendPath, 'context.html'), { dotfiles: 'allow' }));
+    return new Promise((resolve, reject) => {
+        const server = app.listen(port);
+        server.once('error', (error) => {
+            reject(error);
+        });
+        server.once('listening', () => {
+            activeServers.add(server);
+            server.once('close', () => activeServers.delete(server));
+            const url = `http://localhost:${port}`;
+            console.log('');
+            console.log('  Living Documentation');
+            console.log('  ─────────────────────────────────');
+            console.log(`  Local:   ${url}`);
+            console.log(`  Admin:   ${url}/admin`);
+            console.log(`  Docs:    ${docsPath}`);
+            console.log('');
+            console.log('  Press Ctrl+C to stop.');
+            console.log('');
+            if (openBrowser) {
+                openUrl(url);
+            }
+            resolve();
+        });
+    });
+}
+function openUrl(url) {
+    const platform = process.platform;
+    if (platform === 'darwin')
+        (0, child_process_1.exec)(`open "${url}"`);
+    else if (platform === 'win32')
+        (0, child_process_1.exec)(`start "" "${url}"`);
+    else
+        (0, child_process_1.exec)(`xdg-open "${url}"`);
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/starter-doc/.living-doc.json

@@ -0,0 +1,52 @@
+{
+  "filenamePattern": "YYYY_MM_DD_HH_mm_[Category]_title",
+  "title": "Living Documentation",
+  "theme": "system",
+  "language": "en",
+  "port": 4321,
+  "extraFiles": [],
+  "showDiagramDebug": false,
+  "diagramNodePalette": [
+    "#ffffff",
+    "#f5f5f4",
+    "#f1f5f9",
+    "#dbeafe",
+    "#e0f2fe",
+    "#cffafe",
+    "#ccfbf1",
+    "#dcfce7",
+    "#ecfccb",
+    "#fef9c3",
+    "#ffedd5",
+    "#fee2e2",
+    "#ffe4e6",
+    "#fce7f3",
+    "#ede9fe"
+  ],
+  "diagramEdgePalette": [
+    "#ffffff",
+    "#a8a29e",
+    "#374151",
+    "#3b82f6",
+    "#14b8a6",
+    "#22c55e",
+    "#f97316",
+    "#ef4444",
+    "#a855f7"
+  ],
+  "sourceRoot": "..",
+  "blockedFileExtensions": [
+    "exe",
+    "sh",
+    "bat",
+    "cmd",
+    "com",
+    "scr",
+    "ps1",
+    "msi"
+  ],
+  "exclusiveFolderExpansion": true,
+  "exclusiveCategoryExpansion": true,
+  "codeBlockMaxHeight": 400,
+  "markdownSoftBreaks": true
+}

package/dist/starter-doc/ADRS/2026_01_01_[ADR]_example_architecture_decision.md

@@ -0,0 +1,59 @@
+---
+**date:** 2026-01-01
+**status:** Example
+**description:** Example ADR template showing how to record a project decision with enough context, consequences, and tags for an AI assistant to discover and reuse it later.
+**tags:** adr, template, architecture-decision, ai-context, documentation
+---
+
+# Example Architecture Decision
+
+## Context
+
+Replace this section with the situation that led to the decision.
+
+Explain the problem in concrete terms:
+
+- what was hard to understand, maintain, scale, test, or operate;
+- which existing constraints mattered;
+- which alternatives were considered;
+- which user or developer workflow was affected.
+
+An ADR should capture the reason behind the change, not only the final code shape. This is what makes it useful later for humans and for AI assistants that need to understand why the project works this way.
+
+## Decision
+
+Replace this section with the decision that was made.
+
+Be specific enough that another developer or AI assistant can apply the same rule later. Mention the files, modules, data contracts, commands, or conventions that carry the decision when they are relevant.
+
+Example:
+
+- store project-level AI instructions in `AI/PROJECT-INSTRUCTIONS.md`;
+- document the stack and commands in `AI/PROJECT-STACK.md` and `AI/PROJECT-USEFUL-COMMANDS.md`;
+- expose tool-specific entry points through `AGENTS.md` and `CLAUDE.md`;
+- keep reusable AI rules in `AI/rules/*.md`;
+- use symbolic links when a document must appear in Living Documentation without duplicating the source of truth.
+
+## Consequences
+
+### PROS
+
+- The decision is discoverable from the documentation, not only from code.
+- AI assistants can read the ADR frontmatter first, then load the full ADR only when it matches the current task.
+- Future changes can preserve the original intent instead of re-discovering it from implementation details.
+
+### CONS
+
+- The ADR must be maintained when the decision changes.
+- A vague ADR is worse than no ADR because it gives future readers false confidence.
+- If the same rule is repeated in too many places, the project can drift. Prefer one source of truth and link to it.
+
+## Follow-up
+
+When turning this example into a real ADR:
+
+- rename the file with the actual date, category, and decision title;
+- set `status` to `To be validated`, `Accepted`, `SuperSeeded`, `Partially SuperSeeded`, or the status convention used by the project;
+- replace `description` with a one-sentence summary that is useful during ADR discovery;
+- replace `tags` with searchable themes;
+- remove this follow-up section if it is no longer useful.