living-ai-documentation 1.0.0

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

@@ -0,0 +1,44 @@
+export interface DocSummary {
+    id: string;
+    title: string;
+    category: string;
+    folder: string | null;
+}
+export declare function listAllDocuments(docsPath: string): DocSummary[];
+export declare function resolveDocFilePath(docsPath: string, doc: DocSummary): string | null;
+export declare function toolListDocuments(docsPath: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolReadDocument(docsPath: string, args: {
+    id: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolUpdateDocument(docsPath: string, args: {
+    id: string;
+    content: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolCreateDocument(docsPath: string, args: {
+    title: string;
+    category: string;
+    folder?: string;
+    content?: string;
+    date?: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/documents.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CA+B/D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CASnF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM;;;;;EAMjD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;EAsBtE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;EAmCzF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;;;;;EAkCA"}

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

@@ -0,0 +1,186 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listAllDocuments = listAllDocuments;
+exports.resolveDocFilePath = resolveDocFilePath;
+exports.toolListDocuments = toolListDocuments;
+exports.toolReadDocument = toolReadDocument;
+exports.toolUpdateDocument = toolUpdateDocument;
+exports.toolCreateDocument = toolCreateDocument;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../../lib/config");
+const parser_1 = require("../../lib/parser");
+function buildFilename(filenamePattern, title, category, dateOverride) {
+    const parsed = dateOverride ? new Date(dateOverride) : null;
+    const now = parsed && !Number.isNaN(parsed.getTime()) ? parsed : new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    const today = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+    const [year, month, day] = today.split('-');
+    const hours = pad(now.getHours());
+    const minutes = pad(now.getMinutes());
+    const titleSlug = title.trim()
+        .toLowerCase()
+        .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+        .replace(/\s+/g, '_')
+        .replace(/[^a-z0-9_]/g, '')
+        .replace(/_+/g, '_')
+        .replace(/^_|_$/g, '') || 'document';
+    return (filenamePattern || 'YYYY_MM_DD_HH_mm_[Category]_title')
+        .replace('YYYY', year)
+        .replace('MM', month)
+        .replace('DD', day)
+        .replace('HH', hours)
+        .replace('mm', minutes)
+        .replace(/\[Category\]/i, `[${category}]`)
+        .replace(/(?<![a-z0-9])(?:title_words|title)(?![a-z0-9])/i, titleSlug) + '.md';
+}
+function safeResolve(docsPath, rel) {
+    const resolved = path_1.default.resolve(docsPath, rel);
+    const base = path_1.default.resolve(docsPath) + path_1.default.sep;
+    return resolved.startsWith(base) ? resolved : null;
+}
+function listAllDocuments(docsPath) {
+    const { filenamePattern, extraFiles = [] } = (0, config_1.readConfig)(docsPath);
+    const docs = [];
+    for (const fp of extraFiles) {
+        if (!fp.endsWith('.md') || !fs_1.default.existsSync(fp))
+            continue;
+        const meta = (0, parser_1.parseFilename)(path_1.default.basename(fp), filenamePattern);
+        docs.push({ id: encodeURIComponent(fp.slice(0, -3)), title: meta.title, category: 'General', folder: null });
+    }
+    function scan(dir) {
+        for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name.startsWith('.'))
+                continue;
+            const full = path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                scan(full);
+            }
+            else if (entry.name.toLowerCase().endsWith('.md')) {
+                const relPath = path_1.default.relative(docsPath, full);
+                const meta = (0, parser_1.parseFilename)(entry.name, filenamePattern);
+                const subdir = path_1.default.dirname(relPath);
+                docs.push({
+                    id: encodeURIComponent(relPath.slice(0, -3)),
+                    title: meta.title,
+                    category: meta.category,
+                    folder: subdir !== '.' ? subdir : null,
+                });
+            }
+        }
+    }
+    scan(docsPath);
+    return docs;
+}
+function resolveDocFilePath(docsPath, doc) {
+    const { extraFiles = [] } = (0, config_1.readConfig)(docsPath);
+    const decoded = decodeURIComponent(doc.id);
+    if (path_1.default.isAbsolute(decoded)) {
+        const fp = decoded + '.md';
+        return extraFiles.includes(fp) && fs_1.default.existsSync(fp) ? fp : null;
+    }
+    const resolved = safeResolve(docsPath, decoded + '.md');
+    return resolved && fs_1.default.existsSync(resolved) ? resolved : null;
+}
+function toolListDocuments(docsPath) {
+    const docs = listAllDocuments(docsPath).map(d => ({
+        ...d,
+        linkHref: `?doc=${encodeURIComponent(d.id)}`,
+    }));
+    return { content: [{ type: 'text', text: JSON.stringify(docs, null, 2) }] };
+}
+function toolReadDocument(docsPath, args) {
+    if (!args || typeof args.id !== 'string' || !args.id) {
+        throw new Error("Missing required parameter 'id'");
+    }
+    const { extraFiles = [] } = (0, config_1.readConfig)(docsPath);
+    const decoded = decodeURIComponent(args.id);
+    let filePath;
+    if (path_1.default.isAbsolute(decoded)) {
+        const fp = decoded + '.md';
+        if (!extraFiles.includes(fp))
+            throw new Error('Access denied: not an allowed extra file');
+        filePath = fp;
+    }
+    else {
+        const resolved = safeResolve(docsPath, decoded + '.md');
+        if (!resolved)
+            throw new Error('Access denied: path traversal attempt');
+        filePath = resolved;
+    }
+    if (!fs_1.default.existsSync(filePath))
+        throw new Error(`Document not found: ${args.id}`);
+    const content = fs_1.default.readFileSync(filePath, 'utf-8');
+    return { content: [{ type: 'text', text: content }] };
+}
+function toolUpdateDocument(docsPath, args) {
+    if (!args || typeof args.id !== 'string' || !args.id) {
+        throw new Error("Missing required parameter 'id'");
+    }
+    if (typeof args.content !== 'string' || !args.content) {
+        throw new Error("Missing required parameter 'content' (must be non-empty)");
+    }
+    const { extraFiles = [] } = (0, config_1.readConfig)(docsPath);
+    const decoded = decodeURIComponent(args.id);
+    let filePath;
+    if (path_1.default.isAbsolute(decoded)) {
+        const fp = decoded + '.md';
+        if (!extraFiles.includes(fp))
+            throw new Error('Access denied: not an allowed extra file');
+        filePath = fp;
+    }
+    else {
+        const resolved = safeResolve(docsPath, decoded + '.md');
+        if (!resolved)
+            throw new Error('Access denied: path traversal attempt');
+        filePath = resolved;
+    }
+    if (!fs_1.default.existsSync(filePath))
+        throw new Error(`Document not found: ${args.id}`);
+    fs_1.default.writeFileSync(filePath, args.content, 'utf-8');
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    id: args.id,
+                    bytes: Buffer.byteLength(args.content, 'utf-8'),
+                }, null, 2),
+            }],
+    };
+}
+function toolCreateDocument(docsPath, args) {
+    const { filenamePattern, port } = (0, config_1.readConfig)(docsPath);
+    const filename = buildFilename(filenamePattern, args.title, args.category || 'General', args.date);
+    let targetDir = path_1.default.resolve(docsPath);
+    if (args.folder && args.folder.trim()) {
+        const resolved = path_1.default.resolve(docsPath, args.folder.trim());
+        if (!resolved.startsWith(path_1.default.resolve(docsPath)))
+            throw new Error('Access denied: path traversal attempt');
+        targetDir = resolved;
+    }
+    fs_1.default.mkdirSync(targetDir, { recursive: true });
+    const filePath = path_1.default.join(targetDir, filename);
+    if (fs_1.default.existsSync(filePath))
+        throw new Error('A document with this name already exists');
+    const body = args.content ?? `# ${args.title.trim()}\n`;
+    fs_1.default.writeFileSync(filePath, body, 'utf-8');
+    const relPath = path_1.default.relative(docsPath, filePath);
+    const docId = encodeURIComponent(relPath.slice(0, -3));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    filename,
+                    id: docId,
+                    url: `http://localhost:${port}/?doc=${encodeURIComponent(docId)}`,
+                    linkHref: `?doc=${encodeURIComponent(docId)}`,
+                }, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=documents.js.map

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

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

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

@@ -0,0 +1,10 @@
+export declare function toolRetrodocumentAdrsFromGit(docsPath: string, args: {
+    limit?: number;
+    since?: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/git.ts"],"names":[],"mappings":"AAsMA,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;;;;EA4DA"}

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

@@ -0,0 +1,217 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolRetrodocumentAdrsFromGit = toolRetrodocumentAdrsFromGit;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const config_1 = require("../../lib/config");
+const DEFAULT_LIMIT = 100;
+const MAX_LIMIT = 200;
+const MAX_BODY_CHARS = 4096;
+// Manifest / lock / config files that should NOT be attached as ADR metadata
+// — they change for almost every feature. Same spirit as the `add_metadata`
+// guidance. Detection is best-effort: the LLM still has final say.
+const GOD_FILE_BASENAMES = new Set([
+    'package.json',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+    'tsconfig.json',
+    'tsconfig.base.json',
+    'requirements.txt',
+    'cargo.lock',
+    'cargo.toml',
+    'go.sum',
+    'go.mod',
+    'pyproject.toml',
+    'composer.lock',
+    'composer.json',
+    'gemfile.lock',
+    'gemfile',
+]);
+function resolveSourceRoot(docsPath) {
+    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 ensureGitRepo(cwd) {
+    try {
+        const root = (0, child_process_1.execFileSync)('git', ['rev-parse', '--show-toplevel'], {
+            cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+        if (!root)
+            throw new Error('empty toplevel');
+        return root;
+    }
+    catch {
+        throw new Error(`Not a git repository (or git not on PATH): ${cwd}. ` +
+            `retrodocument_adrs_from_git requires \`sourceRoot\` to be inside a git working tree.`);
+    }
+}
+const REC = '~~~LDOC-REC~~~';
+const FIELD = '~~~LDOC-FIELD~~~';
+const FILES = '~~~LDOC-FILES~~~';
+function buildPrettyFormat() {
+    return [
+        REC,
+        '%H', FIELD,
+        '%cI', FIELD,
+        '%aI', FIELD,
+        '%an', FIELD,
+        '%P', FIELD,
+        '%s', FIELD,
+        '%b',
+        FILES,
+    ].join('%n');
+}
+function parseFileLine(line, gitRoot, sourceRoot) {
+    const parts = line.split('\t').map((s) => s.trim()).filter(Boolean);
+    if (parts.length < 2)
+        return null;
+    const rawType = parts[0];
+    const changeType = rawType.charAt(0).toUpperCase();
+    // For renames/copies (R100, C075), git emits: type\tfrom\tto — keep destination only.
+    const relToGit = parts[parts.length - 1];
+    if (!relToGit)
+        return null;
+    const abs = path_1.default.resolve(gitRoot, relToGit);
+    const sourceRootResolved = path_1.default.resolve(sourceRoot);
+    const underSourceRoot = abs === sourceRootResolved || abs.startsWith(sourceRootResolved + path_1.default.sep);
+    const relToSource = underSourceRoot ? path_1.default.relative(sourceRootResolved, abs) : null;
+    const existsNow = fs_1.default.existsSync(abs);
+    const basename = path_1.default.basename(relToGit).toLowerCase();
+    const godFileSuspect = GOD_FILE_BASENAMES.has(basename);
+    return {
+        path: underSourceRoot && relToSource ? relToSource : relToGit,
+        changeType,
+        underSourceRoot,
+        existsNow,
+        godFileSuspect,
+    };
+}
+function parseGitLog(raw, sourceRoot, gitRoot) {
+    const lines = raw.split('\n');
+    const commits = [];
+    let i = 0;
+    while (i < lines.length) {
+        if (lines[i].trim() !== REC) {
+            i++;
+            continue;
+        }
+        i++;
+        const fields = [];
+        let current = [];
+        const fileLines = [];
+        while (i < lines.length) {
+            const line = lines[i];
+            if (line.trim() === REC)
+                break;
+            if (line.trim() === FIELD) {
+                fields.push(current.join('\n').trim());
+                current = [];
+                i++;
+                continue;
+            }
+            if (line.trim() === FILES) {
+                fields.push(current.join('\n').trim());
+                current = [];
+                i++;
+                while (i < lines.length && lines[i].trim() !== REC) {
+                    if (lines[i].trim())
+                        fileLines.push(lines[i]);
+                    i++;
+                }
+                break;
+            }
+            current.push(line);
+            i++;
+        }
+        if (current.length > 0 && fields.length < 7) {
+            fields.push(current.join('\n').trim());
+        }
+        if (fields.length < 7)
+            continue;
+        const [sha, cDate, aDate, author, parents, subject, body] = fields;
+        const filesChanged = fileLines
+            .map((l) => parseFileLine(l, gitRoot, sourceRoot))
+            .filter((f) => f !== null);
+        const parentCount = parents ? parents.split(/\s+/).filter(Boolean).length : 0;
+        const isMerge = parentCount > 1;
+        const candidateFiles = filesChanged.filter((f) => f.underSourceRoot && !f.godFileSuspect && f.changeType !== 'D');
+        const state = isMerge
+            ? 'merge'
+            : candidateFiles.length === 0
+                ? 'trivial'
+                : 'candidate';
+        commits.push({
+            sha,
+            shortSha: sha.slice(0, 8),
+            committerDate: cDate,
+            authorDate: aDate,
+            author,
+            subject,
+            body: body.length > MAX_BODY_CHARS ? body.slice(0, MAX_BODY_CHARS) + '\n…[truncated]' : body,
+            parents: parentCount,
+            state,
+            filesChanged,
+        });
+    }
+    return commits;
+}
+function toolRetrodocumentAdrsFromGit(docsPath, args) {
+    const sourceRoot = resolveSourceRoot(docsPath);
+    const gitRoot = ensureGitRepo(sourceRoot);
+    const limit = Math.min(Math.max(Math.floor(args?.limit ?? DEFAULT_LIMIT), 1), MAX_LIMIT);
+    const gitArgs = [
+        'log',
+        '-n', String(limit),
+        '--reverse',
+        '--name-status',
+        `--pretty=format:${buildPrettyFormat()}`,
+    ];
+    if (args?.since && typeof args.since === 'string' && args.since.trim()) {
+        gitArgs.push(`--since=${args.since.trim()}`);
+    }
+    let raw;
+    try {
+        raw = (0, child_process_1.execFileSync)('git', gitArgs, {
+            cwd: gitRoot,
+            encoding: 'utf-8',
+            maxBuffer: 32 * 1024 * 1024,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+    }
+    catch (err) {
+        throw new Error(`git log failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const commits = parseGitLog(raw, sourceRoot, gitRoot);
+    const counts = commits.reduce((acc, c) => {
+        acc[c.state] = (acc[c.state] ?? 0) + 1;
+        return acc;
+    }, {});
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    sourceRoot,
+                    gitRoot,
+                    limit,
+                    since: args?.since ?? null,
+                    totalCommits: commits.length,
+                    stateCounts: {
+                        candidate: counts.candidate ?? 0,
+                        trivial: counts.trivial ?? 0,
+                        merge: counts.merge ?? 0,
+                    },
+                    commits,
+                }, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=git.js.map

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

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

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

@@ -0,0 +1,57 @@
+export declare function toolListMetadata(docsPath: string, args: {
+    id: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolGetAccuracy(docsPath: string, args: {
+    id: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolReviewAdrRelevance(docsPath: string, args: {
+    id: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolRefreshMetadata(docsPath: string, args: {
+    id: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolAddMetadata(docsPath: string, args: {
+    id: string;
+    path: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolRemoveMetadata(docsPath: string, args: {
+    id: string;
+    path: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolListAdrsBelowAccuracy(docsPath: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/metadata.ts"],"names":[],"mappings":"AA8CA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;EAKtE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;EAMrE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;EAkD5E;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;;;EAcrB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;EA4BnC;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;EAwBnC;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM;;;;;EAsDzD"}