living-ai-documentation 1.0.0

package/dist/src/routes/browse-source.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browseSourceRouter = browseSourceRouter;
+const express_1 = require("express");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const metadata_1 = require("../lib/metadata");
+// Directories that are never useful to browse for source selection
+const IGNORED_DIRS = new Set([
+    "node_modules",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    ".git",
+    ".next",
+    ".nuxt",
+    ".cache",
+    ".turbo",
+    ".svelte-kit",
+    "target",
+    "bin",
+    "obj",
+    "__pycache__",
+    ".venv",
+    "venv",
+]);
+function isIgnoredDir(name) {
+    if (IGNORED_DIRS.has(name))
+        return true;
+    if (name.startsWith(".") && name !== ".github")
+        return true;
+    return false;
+}
+function browseSourceRouter(docsPath) {
+    const router = (0, express_1.Router)();
+    // GET /api/browse-source?path=<relative path under sourceRoot>
+    router.get("/", (req, res) => {
+        try {
+            const root = (0, metadata_1.resolveSourceRoot)(docsPath);
+            const rel = req.query.path || "";
+            const current = path_1.default.resolve(root, rel);
+            if (!(current === root || current.startsWith(path_1.default.resolve(root) + path_1.default.sep))) {
+                return res.status(400).json({ error: "Path escapes sourceRoot" });
+            }
+            if (!fs_1.default.existsSync(current) || !fs_1.default.statSync(current).isDirectory()) {
+                return res.status(400).json({ error: "Not a directory" });
+            }
+            const entries = fs_1.default.readdirSync(current, { withFileTypes: true });
+            const dirs = entries
+                .filter((e) => e.isDirectory() && !isIgnoredDir(e.name))
+                .map((e) => ({
+                name: e.name,
+                path: path_1.default.relative(root, path_1.default.join(current, e.name)),
+            }))
+                .sort((a, b) => a.name.localeCompare(b.name));
+            const files = entries
+                .filter((e) => e.isFile() && !e.name.startsWith("."))
+                .map((e) => ({
+                name: e.name,
+                path: path_1.default.relative(root, path_1.default.join(current, e.name)),
+            }))
+                .sort((a, b) => a.name.localeCompare(b.name));
+            const currentRel = path_1.default.relative(root, current);
+            const parent = current === root ? null : path_1.default.relative(root, path_1.default.dirname(current));
+            res.json({ sourceRoot: root, current: currentRel, parent, dirs, files });
+        }
+        catch (err) {
+            res
+                .status(400)
+                .json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=browse-source.js.map

package/dist/src/routes/browse-source.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../../src/routes/browse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAiBpD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsFrD"}

package/dist/src/routes/browse.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browseRouter = browseRouter;
+const express_1 = require("express");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const RESERVED_SUBFOLDERS = new Set(['files', 'images']);
+function isReservedAtDocsRoot(parentDir, name, docsPath) {
+    return (path_1.default.resolve(parentDir) === path_1.default.resolve(docsPath) &&
+        RESERVED_SUBFOLDERS.has(name));
+}
+function browseRouter(docsPath) {
+    const router = (0, express_1.Router)();
+    // GET /api/browse?path=... — list dirs and .md files at a given path
+    router.get('/', (req, res) => {
+        const rawPath = req.query.path || '/';
+        const current = path_1.default.resolve(rawPath);
+        try {
+            const entries = fs_1.default.readdirSync(current, { withFileTypes: true });
+            const dirs = entries
+                .filter((e) => e.isDirectory() &&
+                !e.name.startsWith('.') &&
+                !isReservedAtDocsRoot(current, e.name, docsPath))
+                .map((e) => ({ name: e.name, path: path_1.default.join(current, e.name) }))
+                .sort((a, b) => a.name.localeCompare(b.name));
+            const allFiles = req.query.all === '1';
+            const files = entries
+                .filter((e) => e.isFile() && (allFiles || e.name.toLowerCase().endsWith('.md')))
+                .map((e) => ({ name: e.name, path: path_1.default.join(current, e.name) }))
+                .sort((a, b) => a.name.localeCompare(b.name));
+            const parsed = path_1.default.parse(current);
+            const parent = current === parsed.root ? null : path_1.default.dirname(current);
+            res.json({ current, parent, dirs, files });
+        }
+        catch {
+            res.status(400).json({ error: 'Cannot read directory' });
+        }
+    });
+    // GET /api/browse/alldirs?path=... — recursively list all subdirectories (relative paths)
+    router.get('/alldirs', (req, res) => {
+        const rawPath = req.query.path || '';
+        if (!rawPath)
+            return res.status(400).json({ error: 'path is required' });
+        const base = path_1.default.resolve(rawPath);
+        const results = [];
+        function collect(dir) {
+            try {
+                const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+                for (const e of entries) {
+                    if (e.isDirectory() &&
+                        !e.name.startsWith('.') &&
+                        !isReservedAtDocsRoot(dir, e.name, docsPath)) {
+                        const full = path_1.default.join(dir, e.name);
+                        results.push(path_1.default.relative(base, full));
+                        collect(full);
+                    }
+                }
+            }
+            catch { /* skip unreadable dirs */ }
+        }
+        collect(base);
+        res.json(results);
+    });
+    // POST /api/browse/mkdir — create a directory
+    router.post('/mkdir', (req, res) => {
+        const { path: dirPath } = req.body;
+        if (!dirPath || typeof dirPath !== 'string') {
+            return res.status(400).json({ error: 'path is required' });
+        }
+        const resolved = path_1.default.resolve(dirPath);
+        const parent = path_1.default.dirname(resolved);
+        const name = path_1.default.basename(resolved);
+        if (isReservedAtDocsRoot(parent, name, docsPath)) {
+            return res.status(400).json({
+                error: `"${name}" is a reserved folder name at the docs root`,
+            });
+        }
+        try {
+            fs_1.default.mkdirSync(resolved, { recursive: true });
+            res.json({ created: resolved });
+        }
+        catch {
+            res.status(500).json({ error: 'Failed to create directory' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=browse.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/routes/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAIpD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+HrD"}

package/dist/src/routes/config.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configRouter = configRouter;
+const express_1 = require("express");
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../lib/config");
+function configRouter(docsPath) {
+    const router = (0, express_1.Router)();
+    // GET /api/config
+    router.get('/', (_req, res) => {
+        try {
+            res.json((0, config_1.readConfig)(docsPath));
+        }
+        catch {
+            res.status(500).json({ error: 'Failed to read config' });
+        }
+    });
+    // PUT /api/config
+    router.put('/', (req, res) => {
+        try {
+            const patch = req.body;
+            // Only allow safe fields — prevent path traversal via config
+            const allowed = [
+                'title',
+                'filenamePattern',
+                'theme',
+                'language',
+                'showDiagramDebug',
+                'diagramNodePalette',
+                'diagramEdgePalette',
+                'sourceRoot',
+                'extraFiles',
+                'blockedFileExtensions',
+                'exclusiveFolderExpansion',
+                'exclusiveCategoryExpansion',
+                'codeBlockMaxHeight',
+                'markdownSoftBreaks',
+            ];
+            const safe = {};
+            for (const key of allowed) {
+                if (key in patch) {
+                    safe[key] = patch[key];
+                }
+            }
+            // filenamePattern: must contain exactly one [Category]
+            if ('filenamePattern' in safe && typeof safe.filenamePattern === 'string') {
+                const matches = safe.filenamePattern.match(/\[Category\]/gi);
+                if (!matches || matches.length === 0) {
+                    return res.status(400).json({ error: 'filenamePattern must contain [Category]' });
+                }
+                if (matches.length > 1) {
+                    return res.status(400).json({ error: 'filenamePattern must contain [Category] exactly once' });
+                }
+            }
+            // language: only 'en' or 'fr'
+            if ('language' in safe && !['en', 'fr'].includes(safe.language)) {
+                delete safe.language;
+            }
+            // diagramNodePalette / diagramEdgePalette: null or array of strings.
+            // Must drop invalid values explicitly — the initial allowed-key loop copied the raw
+            // value into `safe`, and silence without a delete would persist garbage (e.g. a string).
+            if ('diagramNodePalette' in patch) {
+                const v = patch.diagramNodePalette;
+                if (v === null || (Array.isArray(v) && v.every((s) => typeof s === 'string'))) {
+                    safe.diagramNodePalette = v;
+                }
+                else {
+                    delete safe.diagramNodePalette;
+                }
+            }
+            if ('diagramEdgePalette' in patch) {
+                const v = patch.diagramEdgePalette;
+                if (v === null || (Array.isArray(v) && v.every((s) => typeof s === 'string'))) {
+                    safe.diagramEdgePalette = v;
+                }
+                else {
+                    delete safe.diagramEdgePalette;
+                }
+            }
+            // sourceRoot: null or a RELATIVE path (relative to docsFolder). Absolute paths are rejected
+            // so .living-doc.json stays portable across machines.
+            if ('sourceRoot' in patch) {
+                const v = patch.sourceRoot;
+                if (v === null || v === '') {
+                    safe.sourceRoot = null;
+                }
+                else if (typeof v === 'string' && !path_1.default.isAbsolute(v) && !v.startsWith('~')) {
+                    safe.sourceRoot = v;
+                }
+                else {
+                    return res.status(400).json({ error: 'sourceRoot must be a relative path or null' });
+                }
+            }
+            // blockedFileExtensions: array of extension strings (without leading dot), lowercase
+            if ('blockedFileExtensions' in patch) {
+                const v = patch.blockedFileExtensions;
+                if (Array.isArray(v)) {
+                    safe.blockedFileExtensions = v
+                        .filter((e) => typeof e === 'string')
+                        .map((e) => e.trim().replace(/^\.+/, '').toLowerCase())
+                        .filter((e) => /^[a-z0-9]+$/.test(e));
+                }
+                else {
+                    return res.status(400).json({ error: 'blockedFileExtensions must be an array of strings' });
+                }
+            }
+            // codeBlockMaxHeight: non-negative integer pixels (0 disables); clamped to [0, 5000]
+            if ('codeBlockMaxHeight' in patch) {
+                const v = patch.codeBlockMaxHeight;
+                if (typeof v === 'number' && Number.isFinite(v) && v >= 0) {
+                    safe.codeBlockMaxHeight = Math.min(5000, Math.round(v));
+                }
+                else {
+                    return res.status(400).json({ error: 'codeBlockMaxHeight must be a non-negative number' });
+                }
+            }
+            // extraFiles: only RELATIVE .md paths (relative to docsFolder). Absolute entries are rejected.
+            if ('extraFiles' in patch && Array.isArray(patch.extraFiles)) {
+                const entries = patch.extraFiles;
+                const valid = [];
+                for (const f of entries) {
+                    if (typeof f !== 'string')
+                        continue;
+                    if (path_1.default.isAbsolute(f) || f.startsWith('~')) {
+                        return res.status(400).json({ error: 'extraFiles entries must be relative paths' });
+                    }
+                    if (!f.toLowerCase().endsWith('.md'))
+                        continue;
+                    valid.push(f);
+                }
+                safe.extraFiles = valid;
+            }
+            const updated = (0, config_1.writeConfig)(docsPath, safe);
+            res.json(updated);
+        }
+        catch {
+            res.status(500).json({ error: 'Failed to update config' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=config.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/routes/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AA8NjC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoGtD"}

package/dist/src/routes/context.js

@@ -0,0 +1,287 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextRouter = contextRouter;
+const express_1 = require("express");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../lib/config");
+const AI_ROOT_DIR = "AI";
+const AI_RULES_DIR = path_1.default.join(AI_ROOT_DIR, "rules");
+const AI_MCP_DIR = path_1.default.join(AI_ROOT_DIR, "MCP");
+const MCP_NAME_PATTERN = /^[A-Za-z0-9._-]+$/;
+function toPosixPath(value) {
+    return value.split(path_1.default.sep).join("/");
+}
+function slugify(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80) || "ai-rule";
+}
+function safeString(value, fallback = "") {
+    return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+function safeStringArray(value) {
+    if (typeof value === "string") {
+        return value
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    return Array.isArray(value)
+        ? value
+            .filter((item) => typeof item === "string" && item.trim().length > 0)
+            .map((item) => item.trim())
+        : [];
+}
+function frontmatterArray(values) {
+    return `[${values.map((item) => JSON.stringify(item)).join(", ")}]`;
+}
+function describePath(entry, root, rootPath) {
+    const abs = path_1.default.resolve(rootPath, entry);
+    const rel = path_1.default.relative(rootPath, abs);
+    if (path_1.default.isAbsolute(rel) || rel.startsWith("..")) {
+        return { path: entry, root, exists: false, type: "missing", size: null, modifiedAt: null };
+    }
+    if (!fs_1.default.existsSync(abs)) {
+        return { path: entry, root, exists: false, type: "missing", size: null, modifiedAt: null };
+    }
+    const stat = fs_1.default.statSync(abs);
+    return {
+        path: toPosixPath(entry),
+        root,
+        exists: true,
+        type: stat.isDirectory() ? "directory" : "file",
+        size: stat.isFile() ? stat.size : null,
+        modifiedAt: stat.mtime.toISOString(),
+    };
+}
+function parseFrontmatter(md) {
+    const match = md.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (!match)
+        return { fields: {}, body: md.trim() };
+    const fields = {};
+    match[1].split(/\r?\n/).forEach((line) => {
+        const idx = line.indexOf(":");
+        if (idx <= 0 || /^\s+-\s+/.test(line))
+            return;
+        fields[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+    });
+    return { fields, body: md.slice(match[0].length).trim() };
+}
+function parseInlineArray(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .replace(/^\[/, "")
+        .replace(/\]$/, "")
+        .split(",")
+        .map((item) => item.trim().replace(/^["']|["']$/g, ""))
+        .filter(Boolean);
+}
+function firstParagraph(body) {
+    return body
+        .split(/\n\s*\n/)
+        .map((part) => part.trim())
+        .find(Boolean) || "";
+}
+function listInstructionFiles(docsPath) {
+    const instructionDir = path_1.default.join(docsPath, AI_ROOT_DIR);
+    if (!fs_1.default.existsSync(instructionDir))
+        return [];
+    return fs_1.default.readdirSync(instructionDir, { withFileTypes: true })
+        .filter((entry) => {
+        if (!entry.name.toLowerCase().endsWith(".md"))
+            return false;
+        const fullPath = path_1.default.join(instructionDir, entry.name);
+        return entry.isFile() || (entry.isSymbolicLink() && fs_1.default.statSync(fullPath).isFile());
+    })
+        .map((entry) => describePath(path_1.default.join(AI_ROOT_DIR, entry.name), "docsFolder", docsPath))
+        .sort((a, b) => a.path.localeCompare(b.path));
+}
+function readAiRules(docsPath) {
+    const rulesDir = path_1.default.join(docsPath, AI_RULES_DIR);
+    if (!fs_1.default.existsSync(rulesDir))
+        return [];
+    return fs_1.default.readdirSync(rulesDir, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".md"))
+        .map((entry) => {
+        const abs = path_1.default.join(rulesDir, entry.name);
+        const stat = fs_1.default.statSync(abs);
+        const raw = fs_1.default.readFileSync(abs, "utf-8");
+        const { fields, body } = parseFrontmatter(raw);
+        const id = safeString(fields.id, path_1.default.basename(entry.name, ".md"));
+        const title = safeString(fields.title, id);
+        return {
+            id,
+            title,
+            severity: safeString(fields.severity, "guideline"),
+            description: safeString(fields.description, firstParagraph(body)),
+            tags: parseInlineArray(fields.tags),
+            appliesTo: parseInlineArray(fields.appliesTo),
+            path: toPosixPath(path_1.default.join(AI_RULES_DIR, entry.name)),
+            body,
+            modifiedAt: stat.mtime.toISOString(),
+        };
+    })
+        .sort((a, b) => a.title.localeCompare(b.title));
+}
+function createRuleMarkdown(rule) {
+    return [
+        "---",
+        `id: ${rule.id}`,
+        `title: ${rule.title}`,
+        `severity: ${rule.severity}`,
+        `description: ${rule.description}`,
+        `tags: ${frontmatterArray(rule.tags)}`,
+        `appliesTo: ${frontmatterArray(rule.appliesTo)}`,
+        "---",
+        "",
+        rule.body,
+        "",
+    ].join("\n");
+}
+function linkInstructionFile(sourcePath, docsPath) {
+    if (!sourcePath || typeof sourcePath !== "string") {
+        return { error: "path is required", status: 400 };
+    }
+    const source = path_1.default.resolve(sourcePath);
+    if (!fs_1.default.existsSync(source) || !fs_1.default.statSync(source).isFile()) {
+        return { error: "Instruction file not found", status: 404 };
+    }
+    const filename = path_1.default.basename(source);
+    if (filename.startsWith(".") || !filename.toLowerCase().endsWith(".md")) {
+        return { error: "Instruction file must be a visible Markdown file", status: 400 };
+    }
+    const instructionDir = path_1.default.join(docsPath, AI_ROOT_DIR);
+    const target = path_1.default.join(instructionDir, filename);
+    if (!target.startsWith(path_1.default.resolve(docsPath) + path_1.default.sep)) {
+        return { error: "Invalid instruction file path", status: 400 };
+    }
+    if (fs_1.default.existsSync(target)) {
+        return { error: "Instruction file already exists", status: 409 };
+    }
+    fs_1.default.mkdirSync(instructionDir, { recursive: true });
+    const symlinkTarget = path_1.default.relative(instructionDir, source);
+    fs_1.default.symlinkSync(symlinkTarget, target, "file");
+    return describePath(path_1.default.join(AI_ROOT_DIR, filename), "docsFolder", docsPath);
+}
+function deleteInstructionFile(filename, docsPath) {
+    if (!filename || typeof filename !== "string") {
+        return { error: "filename is required", status: 400 };
+    }
+    if (filename !== path_1.default.basename(filename) || filename.startsWith(".") || !filename.toLowerCase().endsWith(".md")) {
+        return { error: "Invalid instruction file name", status: 400 };
+    }
+    const target = path_1.default.join(docsPath, AI_ROOT_DIR, filename);
+    const aiRoot = path_1.default.resolve(docsPath, AI_ROOT_DIR);
+    if (!target.startsWith(aiRoot + path_1.default.sep)) {
+        return { error: "Invalid instruction file path", status: 400 };
+    }
+    if (!fs_1.default.existsSync(target) || !fs_1.default.statSync(target).isFile()) {
+        return { error: "Instruction file not found", status: 404 };
+    }
+    fs_1.default.unlinkSync(target);
+    return { deleted: toPosixPath(path_1.default.join(AI_ROOT_DIR, filename)) };
+}
+function contextRouter(docsPath) {
+    const router = (0, express_1.Router)();
+    router.get("/orientation", (_req, res) => {
+        const config = (0, config_1.readConfig)(docsPath);
+        res.json({
+            instructions: listInstructionFiles(docsPath),
+            rules: readAiRules(docsPath),
+            sourceRoot: config.sourceRoot,
+            rulesFolder: toPosixPath(path_1.default.join(AI_RULES_DIR)),
+        });
+    });
+    router.post("/instructions", (req, res) => {
+        const result = linkInstructionFile(req.body?.path, docsPath);
+        if ("error" in result)
+            return res.status(result.status).json({ error: result.error });
+        res.status(201).json(result);
+    });
+    router.delete("/instructions/:filename", (req, res) => {
+        const result = deleteInstructionFile(req.params.filename, docsPath);
+        if ("error" in result)
+            return res.status(result.status).json({ error: result.error });
+        res.json(result);
+    });
+    router.post("/rules", (req, res) => {
+        const title = safeString(req.body?.title);
+        if (!title)
+            return res.status(400).json({ error: "Rule title is required" });
+        const id = slugify(safeString(req.body?.id, title));
+        const rulesDir = path_1.default.join(docsPath, AI_RULES_DIR);
+        const target = path_1.default.join(rulesDir, `${id}.md`);
+        if (!target.startsWith(path_1.default.resolve(docsPath) + path_1.default.sep)) {
+            return res.status(400).json({ error: "Invalid rule path" });
+        }
+        if (fs_1.default.existsSync(target)) {
+            return res.status(409).json({ error: "Rule already exists" });
+        }
+        const body = safeString(req.body?.body, safeString(req.body?.description));
+        const rule = {
+            id,
+            title,
+            severity: safeString(req.body?.severity, "guideline"),
+            description: safeString(req.body?.description, firstParagraph(body)),
+            tags: safeStringArray(req.body?.tags),
+            appliesTo: safeStringArray(req.body?.appliesTo),
+            path: toPosixPath(path_1.default.join(AI_RULES_DIR, `${id}.md`)),
+            body,
+            modifiedAt: null,
+        };
+        fs_1.default.mkdirSync(rulesDir, { recursive: true });
+        fs_1.default.writeFileSync(target, createRuleMarkdown(rule), "utf-8");
+        const stat = fs_1.default.statSync(target);
+        res.status(201).json({ ...rule, modifiedAt: stat.mtime.toISOString() });
+    });
+    router.post("/mcp-result", (req, res) => {
+        const rawName = safeString(req.body?.name);
+        const rawKind = safeString(req.body?.kind);
+        const content = typeof req.body?.content === "string" ? req.body.content : "";
+        if (!rawName)
+            return res.status(400).json({ error: "name is required" });
+        if (rawKind !== "tool" && rawKind !== "prompt") {
+            return res.status(400).json({ error: "kind must be 'tool' or 'prompt'" });
+        }
+        if (!content)
+            return res.status(400).json({ error: "content is required" });
+        const baseName = rawName.endsWith(".md") ? rawName.slice(0, -3) : rawName;
+        if (!MCP_NAME_PATTERN.test(baseName)) {
+            return res.status(400).json({ error: "Invalid MCP item name" });
+        }
+        const slugName = baseName.replace(/_/g, "-");
+        const mcpDir = path_1.default.join(docsPath, AI_MCP_DIR);
+        fs_1.default.mkdirSync(mcpDir, { recursive: true });
+        const indexedPattern = /^(\d{3})-(tool|prompt)-(.+)\.md$/;
+        let maxIndex = 0;
+        let existingFilename = null;
+        for (const entry of fs_1.default.readdirSync(mcpDir)) {
+            const match = entry.match(indexedPattern);
+            if (!match)
+                continue;
+            const idx = parseInt(match[1], 10);
+            if (idx > maxIndex)
+                maxIndex = idx;
+            if (match[2] === rawKind && match[3] === slugName)
+                existingFilename = entry;
+        }
+        const filename = existingFilename ?? `${String(maxIndex + 1).padStart(3, "0")}-${rawKind}-${slugName}.md`;
+        const target = path_1.default.join(mcpDir, filename);
+        if (!target.startsWith(path_1.default.resolve(docsPath) + path_1.default.sep)) {
+            return res.status(400).json({ error: "Invalid MCP result path" });
+        }
+        fs_1.default.mkdirSync(mcpDir, { recursive: true });
+        fs_1.default.writeFileSync(target, content, "utf-8");
+        res.status(201).json({ path: toPosixPath(path_1.default.join(AI_MCP_DIR, filename)) });
+    });
+    return router;
+}
+//# sourceMappingURL=context.js.map