living-ai-documentation 1.0.0

package/dist/src/mcp/tools/metadata.js

@@ -0,0 +1,222 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolListMetadata = toolListMetadata;
+exports.toolGetAccuracy = toolGetAccuracy;
+exports.toolReviewAdrRelevance = toolReviewAdrRelevance;
+exports.toolRefreshMetadata = toolRefreshMetadata;
+exports.toolAddMetadata = toolAddMetadata;
+exports.toolRemoveMetadata = toolRemoveMetadata;
+exports.toolListAdrsBelowAccuracy = toolListAdrsBelowAccuracy;
+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");
+const documents_1 = require("./documents");
+const ACCURACY_THRESHOLD = 0.8;
+const FULL_ACCURACY = 1;
+const MAX_ITEMS = 10;
+function jsonResult(obj) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(obj, null, 2) },
+        ],
+    };
+}
+function decodeDocId(id) {
+    if (typeof id !== "string" || !id) {
+        throw new Error("Missing required parameter 'id'");
+    }
+    return decodeURIComponent(id);
+}
+function isAdrDocument(doc, docId, content) {
+    const folderParts = (doc.folder ?? "").toLowerCase().split(/[\\/]+/);
+    if (folderParts.includes("adrs"))
+        return true;
+    if (doc.category.toLowerCase() === "adr")
+        return true;
+    if (/\[adr\]/i.test(docId))
+        return true;
+    return /architecture decision record/i.test(content.slice(0, 4096));
+}
+function toolListMetadata(docsPath, args) {
+    const docId = decodeDocId(args?.id);
+    const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+    const entries = (0, metadata_1.getDocEntries)(docsPath, docId);
+    return jsonResult({ id: docId, sourceRoot, items: entries });
+}
+function toolGetAccuracy(docsPath, args) {
+    const docId = decodeDocId(args?.id);
+    const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+    const entries = (0, metadata_1.getDocEntries)(docsPath, docId);
+    const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+    return jsonResult({ id: docId, ...report });
+}
+function toolReviewAdrRelevance(docsPath, args) {
+    const docId = decodeDocId(args?.id);
+    const docs = (0, documents_1.listAllDocuments)(docsPath);
+    const doc = docs.find((candidate) => decodeURIComponent(candidate.id) === docId);
+    if (!doc)
+        throw new Error(`Document not found: ${docId}`);
+    const filePath = (0, documents_1.resolveDocFilePath)(docsPath, doc);
+    if (!filePath)
+        throw new Error(`Document not found: ${docId}`);
+    const content = fs_1.default.readFileSync(filePath, "utf-8");
+    if (!isAdrDocument(doc, docId, content)) {
+        throw new Error(`Document is not an ADR: ${docId}`);
+    }
+    const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+    const entries = (0, metadata_1.getDocEntries)(docsPath, docId);
+    const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+    const sourceFilesToReread = report.items.filter((item) => item.status !== "unchanged");
+    const hasMetadata = entries.length > 0;
+    const needsReview = hasMetadata && report.accuracy < FULL_ACCURACY;
+    let state;
+    const status = (0, metadata_1.getFrontmatterField)(content, "status");
+    if (status?.trim().toLowerCase() === "superseeded")
+        state = "already_superseeded";
+    else if (!hasMetadata)
+        state = "no_metadata";
+    else if (needsReview)
+        state = "needs_llm_review";
+    else
+        state = "metadata_current";
+    return jsonResult({
+        id: docId,
+        isAdr: true,
+        state,
+        document: {
+            id: doc.id,
+            decodedId: docId,
+            title: doc.title,
+            category: doc.category,
+            folder: doc.folder,
+            status,
+            description: (0, metadata_1.getFrontmatterField)(content, "description"),
+            tags: (0, metadata_1.getFrontmatterField)(content, "tags"),
+            content,
+        },
+        metadata: {
+            sourceRoot,
+            hasMetadata,
+            ...report,
+            sourceFilesToReread,
+        },
+    });
+}
+function toolRefreshMetadata(docsPath, args) {
+    const docId = decodeDocId(args?.id);
+    (0, status_1.assertNotSuperSeeded)(docsPath, docId);
+    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;
+        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);
+    return jsonResult({ id: docId, refreshed: true, ...report });
+}
+function toolAddMetadata(docsPath, args) {
+    const docId = decodeDocId(args?.id);
+    (0, status_1.assertNotSuperSeeded)(docsPath, docId);
+    if (!args.path)
+        throw new Error("path is required");
+    const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+    const rel = (0, metadata_1.assertUnderSourceRoot)(args.path, sourceRoot);
+    const abs = path_1.default.resolve(sourceRoot, rel);
+    if (!fs_1.default.existsSync(abs) || !fs_1.default.statSync(abs).isFile()) {
+        throw new Error(`Not a readable file: ${args.path}`);
+    }
+    const hash = (0, hash_1.sha256File)(abs);
+    if (!hash)
+        throw new Error("Failed to hash file");
+    const entries = (0, metadata_1.getDocEntries)(docsPath, docId);
+    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);
+    return jsonResult({
+        id: docId,
+        added: entry,
+        total: report.total,
+        accuracy: report.accuracy,
+    });
+}
+function toolRemoveMetadata(docsPath, args) {
+    const docId = decodeDocId(args?.id);
+    (0, status_1.assertNotSuperSeeded)(docsPath, docId);
+    if (!args.path)
+        throw new Error("path is required");
+    const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+    const rel = (0, metadata_1.assertUnderSourceRoot)(args.path, sourceRoot);
+    const entries = (0, metadata_1.getDocEntries)(docsPath, docId);
+    const idx = entries.findIndex((e) => e.path === rel);
+    let removed = null;
+    if (idx >= 0) {
+        removed = entries[idx];
+        entries.splice(idx, 1);
+        (0, metadata_1.setDocEntries)(docsPath, docId, entries);
+    }
+    const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+    return jsonResult({
+        id: docId,
+        removed,
+        total: report.total,
+        accuracy: report.accuracy,
+    });
+}
+function toolListAdrsBelowAccuracy(docsPath) {
+    const sourceRoot = (0, metadata_1.resolveSourceRoot)(docsPath);
+    const docs = (0, documents_1.listAllDocuments)(docsPath);
+    const candidates = [];
+    for (const doc of docs) {
+        const decodedId = decodeURIComponent(doc.id);
+        const entries = (0, metadata_1.getDocEntries)(docsPath, decodedId);
+        if (entries.length === 0)
+            continue;
+        const filePath = (0, documents_1.resolveDocFilePath)(docsPath, doc);
+        if (!filePath)
+            continue;
+        try {
+            const content = fs_1.default.readFileSync(filePath, "utf-8");
+            if (!isAdrDocument(doc, decodedId, content))
+                continue;
+            const status = (0, metadata_1.getFrontmatterField)(content, "status");
+            if (status && status.trim().toLowerCase() === "superseeded")
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const report = (0, metadata_1.buildReport)(entries, sourceRoot);
+        if (report.accuracy >= ACCURACY_THRESHOLD)
+            continue;
+        candidates.push({
+            id: doc.id,
+            title: doc.title,
+            category: doc.category,
+            folder: doc.folder,
+            accuracy: report.accuracy,
+            total: report.total,
+            unchanged: report.unchanged,
+            modified: report.modified,
+            missing: report.missing,
+        });
+    }
+    candidates.sort((a, b) => a.accuracy - b.accuracy);
+    return jsonResult({
+        items: candidates.slice(0, MAX_ITEMS),
+        totalBelowThreshold: candidates.length,
+    });
+}
+//# sourceMappingURL=metadata.js.map

package/dist/src/mcp/tools/metadata.js.map

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

package/dist/src/mcp/tools/source.d.ts

@@ -0,0 +1,29 @@
+export declare function toolListSourceFiles(docsPath: string, args: {
+    pattern?: string;
+    maxResults?: number;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolReadSourceFile(docsPath: string, args: {
+    path: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolSearchSource(docsPath: string, args: {
+    query: string;
+    pattern?: string;
+    maxResults?: number;
+    caseSensitive?: boolean;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/source.ts"],"names":[],"mappings":"AA2GA,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;;;;;EAkBA;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;EAyB1E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;;;;;EAqCA"}

package/dist/src/mcp/tools/source.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolListSourceFiles = toolListSourceFiles;
+exports.toolReadSourceFile = toolReadSourceFile;
+exports.toolSearchSource = toolSearchSource;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../../lib/config");
+// Hardcoded ignore list for directories we never want to crawl.
+// Keeps implementation dependency-free; users who need .gitignore parsing
+// can scope sourceRoot more tightly.
+const IGNORED_DIRS = new Set([
+    'node_modules', 'dist', 'build', 'out', 'coverage',
+    '.git', '.next', '.nuxt', '.cache', '.turbo', '.svelte-kit',
+    'target', 'bin', 'obj', '__pycache__', '.venv', 'venv',
+    '.DS_Store',
+]);
+const IGNORED_FILE_EXT = new Set([
+    '.lock', '.log', '.map', '.min.js', '.min.css',
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.ico',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf',
+    '.zip', '.tar', '.gz', '.7z', '.pdf',
+    '.mp3', '.mp4', '.webm', '.mov',
+    '.class', '.jar', '.o', '.so', '.dll', '.exe',
+]);
+const DEFAULT_MAX_LIST_RESULTS = 500;
+const DEFAULT_MAX_SEARCH_RESULTS = 200;
+const MAX_FILE_BYTES = 512 * 1024; // 512 KB
+function resolveSourceRoot(docsPath) {
+    // readConfig always returns sourceRoot as an absolute path (resolved from storage).
+    const resolved = (0, config_1.readConfig)(docsPath).sourceRoot;
+    if (!fs_1.default.existsSync(resolved)) {
+        throw new Error(`sourceRoot "${resolved}" does not exist. ` +
+            `Update it in .living-doc.json or via PUT /api/config.`);
+    }
+    return resolved;
+}
+function safeResolve(root, rel) {
+    const resolved = path_1.default.resolve(root, rel);
+    const base = path_1.default.resolve(root) + path_1.default.sep;
+    if (!resolved.startsWith(base) && resolved !== path_1.default.resolve(root)) {
+        throw new Error('Access denied: path escapes sourceRoot');
+    }
+    return resolved;
+}
+function shouldIgnoreDir(name) {
+    if (IGNORED_DIRS.has(name))
+        return true;
+    // Ignore dotfolders by default (except .github which is often useful)
+    if (name.startsWith('.') && name !== '.github')
+        return true;
+    return false;
+}
+function shouldIgnoreFile(name) {
+    if (name.startsWith('.'))
+        return true;
+    const lower = name.toLowerCase();
+    for (const ext of IGNORED_FILE_EXT) {
+        if (lower.endsWith(ext))
+            return true;
+    }
+    return false;
+}
+function matchesPattern(filePath, pattern) {
+    if (!pattern)
+        return true;
+    // Very simple glob: support * and **
+    const regex = new RegExp('^' +
+        pattern
+            .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+            .replace(/\*\*/g, '__DOUBLESTAR__')
+            .replace(/\*/g, '[^/]*')
+            .replace(/__DOUBLESTAR__/g, '.*')
+            .replace(/\?/g, '.') +
+        '$');
+    return regex.test(filePath);
+}
+function walk(root, onFile) {
+    // onFile returns false to stop walking.
+    const stack = [root];
+    while (stack.length) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const abs = path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (shouldIgnoreDir(entry.name))
+                    continue;
+                stack.push(abs);
+            }
+            else if (entry.isFile()) {
+                if (shouldIgnoreFile(entry.name))
+                    continue;
+                const rel = path_1.default.relative(root, abs);
+                if (!onFile(rel, abs))
+                    return;
+            }
+        }
+    }
+}
+// ── Tool handlers ─────────────────────────────────────────────────────────────
+function toolListSourceFiles(docsPath, args) {
+    const root = resolveSourceRoot(docsPath);
+    const max = Math.min(Math.max(args.maxResults ?? DEFAULT_MAX_LIST_RESULTS, 1), 2000);
+    const results = [];
+    walk(root, (rel) => {
+        if (matchesPattern(rel, args.pattern)) {
+            results.push(rel);
+            if (results.length >= max)
+                return false;
+        }
+        return true;
+    });
+    results.sort();
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ sourceRoot: root, count: results.length, files: results }, null, 2),
+            }],
+    };
+}
+function toolReadSourceFile(docsPath, args) {
+    const root = resolveSourceRoot(docsPath);
+    if (!args.path || typeof args.path !== 'string') {
+        throw new Error('path is required');
+    }
+    if (path_1.default.isAbsolute(args.path)) {
+        throw new Error('path must be relative to sourceRoot');
+    }
+    const abs = safeResolve(root, args.path);
+    if (!fs_1.default.existsSync(abs))
+        throw new Error(`File not found: ${args.path}`);
+    const stat = fs_1.default.statSync(abs);
+    if (!stat.isFile())
+        throw new Error(`Not a file: ${args.path}`);
+    if (stat.size > MAX_FILE_BYTES) {
+        throw new Error(`File too large (${stat.size} bytes). Max is ${MAX_FILE_BYTES}. ` +
+            `Use search_source to find the relevant section.`);
+    }
+    const content = fs_1.default.readFileSync(abs, 'utf-8');
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ path: args.path, size: stat.size, content }, null, 2),
+            }],
+    };
+}
+function toolSearchSource(docsPath, args) {
+    if (!args.query || typeof args.query !== 'string') {
+        throw new Error('query is required');
+    }
+    const root = resolveSourceRoot(docsPath);
+    const max = Math.min(Math.max(args.maxResults ?? DEFAULT_MAX_SEARCH_RESULTS, 1), 1000);
+    const needle = args.caseSensitive ? args.query : args.query.toLowerCase();
+    const matches = [];
+    walk(root, (rel, abs) => {
+        if (!matchesPattern(rel, args.pattern))
+            return true;
+        let content;
+        try {
+            const stat = fs_1.default.statSync(abs);
+            if (stat.size > MAX_FILE_BYTES)
+                return true;
+            content = fs_1.default.readFileSync(abs, 'utf-8');
+        }
+        catch {
+            return true;
+        }
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const haystack = args.caseSensitive ? lines[i] : lines[i].toLowerCase();
+            if (haystack.includes(needle)) {
+                matches.push({ file: rel, line: i + 1, text: lines[i].slice(0, 400) });
+                if (matches.length >= max)
+                    return false;
+            }
+        }
+        return true;
+    });
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ sourceRoot: root, query: args.query, count: matches.length, matches }, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/src/mcp/tools/source.js.map

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

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

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

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

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

package/dist/src/routes/annotations.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.annotationsRouter = annotationsRouter;
+const express_1 = require("express");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = __importDefault(require("crypto"));
+function annotationsPath(docsPath) {
+    return path_1.default.join(docsPath, ".annotations.json");
+}
+function readAnnotations(docsPath) {
+    const p = annotationsPath(docsPath);
+    if (!fs_1.default.existsSync(p))
+        return {};
+    try {
+        return JSON.parse(fs_1.default.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeAnnotations(docsPath, store) {
+    fs_1.default.writeFileSync(annotationsPath(docsPath), JSON.stringify(store, null, 2), "utf-8");
+}
+function annotationsRouter(docsPath) {
+    const router = (0, express_1.Router)();
+    // GET /api/annotations  → { [docId]: count }
+    router.get("/", (_req, res) => {
+        const store = readAnnotations(docsPath);
+        const counts = {};
+        for (const [docId, arr] of Object.entries(store)) {
+            if (Array.isArray(arr) && arr.length > 0)
+                counts[docId] = arr.length;
+        }
+        res.json(counts);
+    });
+    // GET /api/annotations/:docId
+    router.get("/:docId", (req, res) => {
+        const docId = decodeURIComponent(req.params.docId);
+        const store = readAnnotations(docsPath);
+        res.json(store[docId] || []);
+    });
+    // POST /api/annotations/:docId
+    router.post("/:docId", (req, res) => {
+        const docId = decodeURIComponent(req.params.docId);
+        const { selectedText, contextBefore, contextAfter, note } = req.body;
+        if (!selectedText || !note) {
+            return res.status(400).json({ error: "selectedText and note are required" });
+        }
+        const annotation = {
+            id: crypto_1.default.randomUUID(),
+            selectedText,
+            contextBefore: contextBefore || "",
+            contextAfter: contextAfter || "",
+            note,
+            createdAt: new Date().toISOString(),
+        };
+        const store = readAnnotations(docsPath);
+        if (!store[docId])
+            store[docId] = [];
+        store[docId].push(annotation);
+        writeAnnotations(docsPath, store);
+        res.json(annotation);
+    });
+    // DELETE /api/annotations/:docId/:id
+    router.delete("/:docId/:id", (req, res) => {
+        const docId = decodeURIComponent(req.params.docId);
+        const id = req.params.id;
+        const store = readAnnotations(docsPath);
+        if (!store[docId])
+            return res.status(404).json({ error: "Not found" });
+        store[docId] = store[docId].filter((a) => a.id !== id);
+        if (store[docId].length === 0)
+            delete store[docId];
+        writeAnnotations(docsPath, store);
+        res.json({ ok: true });
+    });
+    return router;
+}
+//# sourceMappingURL=annotations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../../src/routes/annotations.ts"],"names":[],"mappings":";;;;;AAkCA,8CAmEC;AArGD,qCAAoD;AACpD,4CAAoB;AACpB,gDAAwB;AACxB,oDAA4B;AAa5B,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,KAAuB;IACjE,YAAE,CAAC,aAAa,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC;AAED,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,MAAM,MAAM,GAAG,IAAA,gBAAM,GAAE,CAAC;IAExB,6CAA6C;IAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;QACvE,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACrD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;QAC7D,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAK/D,CAAC;QAEF,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,UAAU,GAAe;YAC7B,EAAE,EAAE,gBAAM,CAAC,UAAU,EAAE;YACvB,YAAY;YACZ,aAAa,EAAE,aAAa,IAAI,EAAE;YAClC,YAAY,EAAE,YAAY,IAAI,EAAE;YAChC,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACrC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAElC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;QAC7D,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAY,CAAC;QAEnC,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QAEvE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAElC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

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

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

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