living-ai-documentation 1.0.0

package/dist/src/lib/status.js

@@ -0,0 +1,72 @@
+"use strict";
+// ── Frontmatter status helpers ───────────────────────────────────────────────
+// The project's frontmatter is not standard YAML: each line is `**key:** value`
+// inside a `---`-fenced block. This module reads only the `status` line — used
+// to gate mutations based on the doc lifecycle (e.g. block metadata writes on
+// a SuperSeeded ADR). The `assertNotSuperSeeded` guard is consumed both by the
+// HTTP routes and by the MCP tools — they share the same source of truth.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentSuperSeededError = exports.SUPERSEEDED_STATUS = void 0;
+exports.parseDocStatus = parseDocStatus;
+exports.readDocStatus = readDocStatus;
+exports.assertNotSuperSeeded = assertNotSuperSeeded;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("./config");
+const STATUS_LINE_RE = /^\*\*status:\*\*\s*(.+?)\s*$/m;
+const FRONTMATTER_FENCE_RE = /^---\s*\n([\s\S]*?)\n---/;
+function parseDocStatus(content) {
+    if (typeof content !== "string")
+        return null;
+    const fence = content.match(FRONTMATTER_FENCE_RE);
+    if (!fence)
+        return null;
+    const m = fence[1].match(STATUS_LINE_RE);
+    return m ? m[1].trim() : null;
+}
+// Resolve a doc id (already decoded) to its .md file path, honouring the same
+// rules the documents route uses: extraFiles for absolute ids, safe-path for
+// regular ids. Returns null if the file is not readable or escapes docsPath.
+function resolveDocFilePath(docsPath, decodedDocId, extraFiles) {
+    if (path_1.default.isAbsolute(decodedDocId)) {
+        const candidate = decodedDocId + ".md";
+        return extraFiles.includes(candidate) ? candidate : null;
+    }
+    const resolved = path_1.default.resolve(docsPath, decodedDocId + ".md");
+    if (!resolved.startsWith(path_1.default.resolve(docsPath) + path_1.default.sep))
+        return null;
+    return resolved;
+}
+function readDocStatus(docsPath, decodedDocId, extraFiles) {
+    const filePath = resolveDocFilePath(docsPath, decodedDocId, extraFiles);
+    if (!filePath || !fs_1.default.existsSync(filePath))
+        return null;
+    try {
+        return parseDocStatus(fs_1.default.readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+exports.SUPERSEEDED_STATUS = "SuperSeeded";
+// Typed error so callers (HTTP routes, MCP tool wrapper) can distinguish a
+// lifecycle rejection from a generic failure and map it to the right response
+// envelope (403 for HTTP, MCP `isError: true` content wrapper).
+class DocumentSuperSeededError extends Error {
+    constructor(message = "Document is SuperSeeded; metadata is read-only.") {
+        super(message);
+        this.code = "DOCUMENT_SUPERSEEDED";
+        this.name = "DocumentSuperSeededError";
+    }
+}
+exports.DocumentSuperSeededError = DocumentSuperSeededError;
+function assertNotSuperSeeded(docsPath, decodedDocId) {
+    const { extraFiles = [] } = (0, config_1.readConfig)(docsPath);
+    if (readDocStatus(docsPath, decodedDocId, extraFiles) === exports.SUPERSEEDED_STATUS) {
+        throw new DocumentSuperSeededError();
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/src/lib/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/lib/status.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,0EAA0E;;;;;;AAS1E,wCAMC;AAmBD,sCAYC;AAiBD,oDAQC;AArED,4CAAoB;AACpB,gDAAwB;AACxB,qCAAsC;AAEtC,MAAM,cAAc,GAAG,+BAA+B,CAAC;AACvD,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAExD,SAAgB,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,SAAS,kBAAkB,CACzB,QAAgB,EAChB,YAAoB,EACpB,UAAoB;IAEpB,IAAI,cAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,YAAY,GAAG,KAAK,CAAC;QACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,CAAC;IACD,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,aAAa,CAC3B,QAAgB,EAChB,YAAoB,EACpB,UAAoB;IAEpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACxE,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAEY,QAAA,kBAAkB,GAAG,aAAa,CAAC;AAEhD,2EAA2E;AAC3E,8EAA8E;AAC9E,gEAAgE;AAChE,MAAa,wBAAyB,SAAQ,KAAK;IAEjD,YACE,OAAO,GAAG,iDAAiD;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAG,sBAAsB,CAAC;QAKrC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AARD,4DAQC;AAED,SAAgB,oBAAoB,CAClC,QAAgB,EAChB,YAAoB;IAEpB,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,KAAK,0BAAkB,EAAE,CAAC;QAC7E,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AA2pEpD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BlD"}