@leji-org/leji 1.0.0

package/dist/index.js

@@ -0,0 +1,324 @@
+import { sortFindings, summarize } from './lib/findings.js';
+import { loadManifest } from './lib/manifest.js';
+import { SDK_VERSION, SUPPORTED_LINES, loadCliSpec } from './lib/schemas.js';
+import { checkIndex, writeIndex } from './commands/indexgen.js';
+import { checkChangelogAppendOnly, validateLayer } from './commands/validate.js';
+import { conformanceReport } from './commands/conformance.js';
+import { generateDocs, resolveDocsPort, serveDocs } from './commands/docs.js';
+import { freshnessReport } from './commands/freshness.js';
+import { enteringTheLayer, initLayer } from './commands/init.js';
+export { validateLayer } from './commands/validate.js';
+export { checkIndex, generateIndex, writeIndex } from './commands/indexgen.js';
+export { checkChangelogAppendOnly } from './commands/validate.js';
+export { conformanceReport } from './commands/conformance.js';
+export { buildSidebar, generateDocs, resolveDocsPort, serveDocs } from './commands/docs.js';
+export { freshnessReport } from './commands/freshness.js';
+export { initLayer } from './commands/init.js';
+export { loadManifest } from './lib/manifest.js';
+export { SDK_VERSION, SUPPORTED_LINES } from './lib/schemas.js';
+/** Terminal help, generated from cli.json so it cannot drift from the docs site. */
+function buildUsage() {
+    const spec = loadCliSpec();
+    const out = [
+        `leji ${SDK_VERSION}: reference CLI for the Leji specification (spec line ${SUPPORTED_LINES.join(', ')})`,
+        '',
+        `Usage: ${spec.usage}`,
+        '',
+        'Commands:',
+    ];
+    const cmdWidth = Math.max(...spec.commands.map((c) => c.name.length)) + 3;
+    for (const c of spec.commands)
+        out.push(`   ${c.name.padEnd(cmdWidth)}${c.summary}`);
+    const cmdOptions = spec.commands.flatMap((c) => c.options.map((o) => ({ ...o, scope: c.name })));
+    const optWidth = Math.max(...spec.globalOptions.map((o) => o.flags.length), ...cmdOptions.map((o) => o.flags.length)) + 3;
+    out.push('', 'Options:');
+    for (const o of spec.globalOptions)
+        out.push(`   ${o.flags.padEnd(optWidth)}${o.summary}`);
+    for (const o of cmdOptions)
+        out.push(`   ${o.flags.padEnd(optWidth)}${o.scope}: ${o.summary}`);
+    out.push('', 'Full reference: https://leji.org/cli/');
+    return out.join('\n');
+}
+const USAGE = buildUsage();
+function parseFlags(argv) {
+    const flags = {
+        root: '.',
+        json: false,
+        check: false,
+        strict: false,
+        yes: false,
+        serve: false,
+        dir: '.',
+    };
+    const rest = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--root':
+                flags.root = argv[++i] ?? '';
+                if (!flags.root)
+                    return { flags, rest, error: '--root requires a value' };
+                break;
+            case '--dir':
+                flags.dir = argv[++i] ?? '';
+                if (!flags.dir)
+                    return { flags, rest, error: '--dir requires a value' };
+                break;
+            case '--level': {
+                const v = argv[++i];
+                if (v !== 'core' && v !== 'indexed')
+                    return { flags, rest, error: '--level must be core or indexed' };
+                flags.level = v;
+                break;
+            }
+            case '--name':
+                flags.name = argv[++i];
+                if (!flags.name)
+                    return { flags, rest, error: '--name requires a value' };
+                break;
+            case '--serve':
+                flags.serve = true;
+                break;
+            case '--port': {
+                const v = Number(argv[++i]);
+                if (!Number.isInteger(v) || v < 0 || v > 65535)
+                    return { flags, rest, error: '--port must be 0-65535' };
+                flags.port = v;
+                break;
+            }
+            case '--json':
+                flags.json = true;
+                break;
+            case '--check':
+                flags.check = true;
+                break;
+            case '--strict':
+                flags.strict = true;
+                break;
+            case '--yes':
+            case '-y':
+                flags.yes = true;
+                break;
+            default:
+                if (arg.startsWith('-') && arg !== '-h' && arg !== '--help' && arg !== '-V' && arg !== '--version') {
+                    return { flags, rest, error: `unknown option ${arg}` };
+                }
+                rest.push(arg);
+        }
+    }
+    return { flags, rest };
+}
+// Per-command flag validation, driven by cli.json (the documented surface): each
+// command accepts the global options plus its own declared options, and any other
+// command flag is a usage error rather than being silently ignored. (Meta-flag
+// `-h`/`-V` handling, short-circuited above, is a separate concern.)
+const VALUE_FLAGS = new Set(['--root', '--dir', '--level', '--name', '--port']);
+function flagTokens(flagsStr) {
+    // "--yes, -y" -> ["--yes","-y"]; "--port <n>" -> ["--port"].
+    return flagsStr
+        .split(',')
+        .map((s) => s.trim().split(/\s+/)[0])
+        .filter(Boolean);
+}
+function seenFlags(argv) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a.startsWith('-')) {
+            out.push(a);
+            if (VALUE_FLAGS.has(a))
+                i++; // skip the flag's value, not a flag itself
+        }
+    }
+    return out;
+}
+function allowedFlagsFor(command, sub) {
+    const spec = loadCliSpec();
+    const name = command === 'changelog' ? `changelog ${sub ?? ''}`.trim() : command;
+    const cmd = spec.commands.find((c) => c.name === name);
+    if (!cmd)
+        return null; // unknown command: leave it to the dispatcher's default
+    const allowed = new Set();
+    for (const o of [...spec.globalOptions, ...cmd.options]) {
+        for (const t of flagTokens(o.flags))
+            allowed.add(t);
+    }
+    return allowed;
+}
+function printFindings(findings) {
+    for (const f of sortFindings(findings)) {
+        const where = f.path ? ` ${f.path}` : '';
+        console.log(`${f.severity === 'error' ? 'error  ' : 'warning'} ${f.rule}${where}: ${f.message}`);
+    }
+}
+function emit(command, findings, json, extra = {}) {
+    const sorted = sortFindings(findings);
+    const summary = summarize(sorted);
+    const ok = summary.errors === 0;
+    if (json) {
+        console.log(JSON.stringify({ command, ok, findings: sorted, summary, ...extra }, null, 2));
+    }
+    else {
+        printFindings(sorted);
+        const extras = Object.entries(extra)
+            .filter(([, v]) => typeof v === 'string' || typeof v === 'number')
+            .map(([k, v]) => `${k}: ${v}`)
+            .join(', ');
+        console.log(`${ok ? 'ok' : 'failed'} (${summary.errors} error${summary.errors === 1 ? '' : 's'}, ${summary.warnings} warning${summary.warnings === 1 ? '' : 's'}${extras ? `; ${extras}` : ''})`);
+    }
+    return ok ? 0 : 1;
+}
+/** Run the CLI; returns the process exit code. */
+export async function run(argv) {
+    const { flags, rest, error } = parseFlags(argv);
+    if (error) {
+        console.error(`leji: ${error}\n`);
+        console.error(USAGE);
+        return 2;
+    }
+    const [command, sub] = rest;
+    if (!command || command === '-h' || command === '--help' || command === 'help') {
+        console.log(USAGE);
+        return command ? 0 : 2;
+    }
+    if (command === '-V' || command === '--version' || command === 'version') {
+        console.log(SDK_VERSION);
+        return 0;
+    }
+    // Reject any flag not declared for this command in cli.json (globals are allowed
+    // everywhere). Runs after the version/help short-circuit, so meta-commands still
+    // ignore flags; unknown commands fall through to the dispatcher's default.
+    const allowed = allowedFlagsFor(command, sub);
+    if (allowed) {
+        const bad = seenFlags(argv).find((t) => !allowed.has(t));
+        if (bad) {
+            const where = command === 'changelog' && sub ? `${command} ${sub}` : command;
+            console.error(`leji: ${bad} is not valid for "${where}"\n`);
+            console.error(USAGE);
+            return 2;
+        }
+    }
+    try {
+        switch (command) {
+            case 'validate': {
+                const result = validateLayer(flags.root);
+                return emit('validate', result.findings, flags.json);
+            }
+            case 'index': {
+                const { manifest, findings } = loadManifest(flags.root);
+                if (!manifest)
+                    return emit('index', findings, flags.json);
+                if (flags.check) {
+                    const result = checkIndex(flags.root, manifest);
+                    return emit('index --check', [...findings, ...result.findings], flags.json, {
+                        stale: result.stale ?? true,
+                    });
+                }
+                const result = writeIndex(flags.root, manifest);
+                return emit('index', [...findings, ...result.findings], flags.json, {
+                    written: manifest.machine?.indexPath ?? '',
+                    entries: result.index?.entries.length ?? 0,
+                });
+            }
+            case 'changelog': {
+                if (sub !== 'check') {
+                    console.error('leji: usage: leji changelog check\n');
+                    return 2;
+                }
+                const { manifest, findings } = loadManifest(flags.root);
+                if (!manifest)
+                    return emit('changelog check', findings, flags.json);
+                const rel = manifest.machine?.changelogPath;
+                if (!rel) {
+                    findings.push({
+                        rule: 'changelog-required',
+                        severity: 'error',
+                        path: 'leji.json',
+                        message: 'no machine.changelogPath declared in leji.json',
+                    });
+                    return emit('changelog check', findings, flags.json);
+                }
+                const result = checkChangelogAppendOnly(flags.root, rel, flags.strict);
+                return emit('changelog check', [...findings, ...result.findings], flags.json, {
+                    verified: result.verified,
+                });
+            }
+            case 'freshness': {
+                const { manifest, findings } = loadManifest(flags.root);
+                if (!manifest)
+                    return emit('freshness', findings, flags.json);
+                const report = freshnessReport(flags.root, manifest, flags.strict);
+                if (!flags.json) {
+                    for (const item of report.upcoming) {
+                        console.log(`upcoming ${item.path}: review after ${item.reviewAfter}`);
+                    }
+                }
+                return emit('freshness', [...findings, ...report.findings], flags.json, {
+                    declared: report.declared,
+                    expired: flags.json ? report.expired : report.expired.length,
+                    upcoming: flags.json ? report.upcoming : report.upcoming.length,
+                });
+            }
+            case 'conformance': {
+                const result = conformanceReport(flags.root);
+                if (!flags.json) {
+                    for (const item of result.items) {
+                        const mark = item.status === 'pass' ? 'pass  ' : item.status === 'fail' ? 'FAIL  ' : 'manual';
+                        console.log(`${mark} [${item.level}] ${item.description}${item.detail ? ` — ${item.detail}` : ''}`);
+                    }
+                    console.log('');
+                }
+                return emit('conformance', result.findings, flags.json, {
+                    claimedLevel: result.claimedLevel ?? 'none',
+                    verifiedLevel: result.verifiedLevel ?? 'none',
+                    ...(flags.json ? { items: result.items } : {}),
+                });
+            }
+            case 'docs': {
+                const { manifest, findings } = loadManifest(flags.root);
+                if (!manifest)
+                    return emit('docs', findings, flags.json);
+                const result = generateDocs(flags.root, manifest);
+                const code = emit('docs', [...findings, ...result.findings], flags.json, {
+                    written: result.written.join(', '),
+                    entries: result.entries,
+                });
+                if (!flags.serve || code !== 0) {
+                    if (!flags.json && code === 0) {
+                        console.log(`serve locally: leji docs --serve   (or any static server at the repository root)`);
+                    }
+                    return code;
+                }
+                const server = await serveDocs(flags.root, resolveDocsPort(manifest, flags.port));
+                const address = server.address();
+                const port = typeof address === 'object' && address ? address.port : resolveDocsPort(manifest, flags.port);
+                console.log(`serving http://127.0.0.1:${port}/${manifest.rootPath}; Ctrl+C to stop`);
+                // Keep the process alive until the server closes (Ctrl+C).
+                await new Promise((resolve) => server.on('close', resolve));
+                return 0;
+            }
+            case 'init': {
+                const result = await initLayer({
+                    dir: flags.dir === '.' && flags.root !== '.' ? flags.root : flags.dir,
+                    yes: flags.yes,
+                    name: flags.name,
+                    level: flags.level,
+                });
+                console.log(`\nWrote ${result.written.length} files:`);
+                for (const rel of result.written)
+                    console.log(`   ${rel}`);
+                console.log(enteringTheLayer(result.manifest));
+                return 0;
+            }
+            default:
+                console.error(`leji: unknown command "${command}"\n`);
+                console.error(USAGE);
+                return 2;
+        }
+    }
+    catch (e) {
+        console.error(`leji: ${e.message}`);
+        return 2;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/findings.d.ts

@@ -0,0 +1,17 @@
+export type Severity = 'error' | 'warning';
+export interface Finding {
+    /** Stable rule identifier, shared verbatim with the Python SDK. */
+    rule: string;
+    severity: Severity;
+    /** Repository-root-relative POSIX path the finding points at, when it has one. */
+    path?: string;
+    message: string;
+}
+export interface FindingSummary {
+    errors: number;
+    warnings: number;
+}
+export declare function finding(rule: string, severity: Severity, message: string, path?: string): Finding;
+export declare function sortFindings(findings: Finding[]): Finding[];
+export declare function summarize(findings: Finding[]): FindingSummary;
+export declare function hasErrors(findings: Finding[]): boolean;

package/dist/lib/findings.js

@@ -0,0 +1,29 @@
+export function finding(rule, severity, message, path) {
+    return path === undefined ? { rule, severity, message } : { rule, severity, path, message };
+}
+export function sortFindings(findings) {
+    return [...findings].sort((a, b) => {
+        const pa = a.path ?? '';
+        const pb = b.path ?? '';
+        if (pa !== pb)
+            return pa < pb ? -1 : 1;
+        if (a.rule !== b.rule)
+            return a.rule < b.rule ? -1 : 1;
+        return a.message < b.message ? -1 : a.message > b.message ? 1 : 0;
+    });
+}
+export function summarize(findings) {
+    let errors = 0;
+    let warnings = 0;
+    for (const f of findings) {
+        if (f.severity === 'error')
+            errors++;
+        else
+            warnings++;
+    }
+    return { errors, warnings };
+}
+export function hasErrors(findings) {
+    return findings.some((f) => f.severity === 'error');
+}
+//# sourceMappingURL=findings.js.map

package/dist/lib/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../../src/lib/findings.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,QAAkB,EAAE,OAAe,EAAE,IAAa;IACrF,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAmB;IAC7C,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAmB;IAC1C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;YAAE,MAAM,EAAE,CAAC;;YAChC,QAAQ,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAmB;IAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,14 @@
+export interface Frontmatter {
+    /** Parsed YAML frontmatter object, or null when the document has none. */
+    data: Record<string, unknown> | null;
+    /** Document body after the frontmatter block (the whole file when none). */
+    body: string;
+    /** Parse error message when the frontmatter block exists but is invalid YAML. */
+    error?: string;
+}
+/**
+ * Extract the leading YAML frontmatter block (`---` fences) from a markdown
+ * document. Dates and booleans follow YAML 1.2 core semantics (the `yaml`
+ * package default): unquoted dates stay strings, only true/false are booleans.
+ */
+export declare function parseFrontmatter(text: string): Frontmatter;

package/dist/lib/frontmatter.js

@@ -0,0 +1,28 @@
+import { parse } from 'yaml';
+/**
+ * Extract the leading YAML frontmatter block (`---` fences) from a markdown
+ * document. Dates and booleans follow YAML 1.2 core semantics (the `yaml`
+ * package default): unquoted dates stay strings, only true/false are booleans.
+ */
+export function parseFrontmatter(text) {
+    if (!text.startsWith('---\n') && !text.startsWith('---\r\n')) {
+        return { data: null, body: text };
+    }
+    const fence = /\r?\n---[ \t]*\r?\n/.exec(text.slice(3));
+    if (!fence) {
+        return { data: null, body: text, error: 'unterminated frontmatter block' };
+    }
+    const raw = text.slice(3, 3 + fence.index + 1);
+    const body = text.slice(3 + fence.index + fence[0].length);
+    try {
+        const data = parse(raw);
+        if (data === null || typeof data !== 'object' || Array.isArray(data)) {
+            return { data: null, body, error: 'frontmatter is not a YAML mapping' };
+        }
+        return { data: data, body };
+    }
+    catch (e) {
+        return { data: null, body, error: `invalid YAML: ${e.message.split('\n')[0]}` };
+    }
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/lib/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAW7B;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAA+B,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAkB,CAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC9F,CAAC;AACJ,CAAC"}

package/dist/lib/fsx.d.ts

@@ -0,0 +1,21 @@
+export declare function toPosix(p: string): string;
+export declare function exists(abs: string): boolean;
+export declare function isDir(abs: string): boolean;
+export declare function isFile(abs: string): boolean;
+export declare function readText(abs: string): string;
+/**
+ * True when `abs` resolves (following symlinks) to a path that remains within
+ * `rootAbs` (itself resolved). Symlinks that escape the served/scanned root are
+ * rejected. A path that does not yet exist cannot escape, so it is allowed.
+ */
+export declare function realpathWithin(rootAbs: string, abs: string): boolean;
+/**
+ * Recursively collect markdown files under a declared path (file or directory),
+ * returned as repository-root-relative POSIX paths, sorted. Entries whose real
+ * path (after resolving symlinks) escapes `root` are excluded.
+ */
+export declare function walkMd(root: string, relPath: string): string[];
+/** Normalize a declared directory path for prefix comparison: no trailing slash. */
+export declare function stripSlash(p: string): string;
+/** True when relPath is the declared path itself or falls under it (POSIX). */
+export declare function underPath(relPath: string, declared: string): boolean;

package/dist/lib/fsx.js

@@ -0,0 +1,100 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+export function exists(abs) {
+    return fs.existsSync(abs);
+}
+export function isDir(abs) {
+    try {
+        return fs.statSync(abs).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function isFile(abs) {
+    try {
+        return fs.statSync(abs).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function readText(abs) {
+    return fs.readFileSync(abs, 'utf8');
+}
+/**
+ * True when `abs` resolves (following symlinks) to a path that remains within
+ * `rootAbs` (itself resolved). Symlinks that escape the served/scanned root are
+ * rejected. A path that does not yet exist cannot escape, so it is allowed.
+ */
+export function realpathWithin(rootAbs, abs) {
+    let resolvedRoot;
+    try {
+        resolvedRoot = fs.realpathSync(rootAbs);
+    }
+    catch {
+        return false;
+    }
+    let real;
+    try {
+        real = fs.realpathSync(abs);
+    }
+    catch {
+        // Non-existent target: it cannot point outside via a symlink.
+        return true;
+    }
+    return real === resolvedRoot || real.startsWith(resolvedRoot + path.sep);
+}
+/**
+ * Recursively collect markdown files under a declared path (file or directory),
+ * returned as repository-root-relative POSIX paths, sorted. Entries whose real
+ * path (after resolving symlinks) escapes `root` are excluded.
+ */
+export function walkMd(root, relPath) {
+    const rootAbs = path.resolve(root);
+    const abs = path.join(root, relPath);
+    if (isFile(abs)) {
+        return relPath.endsWith('.md') && realpathWithin(rootAbs, abs) ? [toPosix(relPath)] : [];
+    }
+    if (!isDir(abs))
+        return [];
+    const out = [];
+    const stack = [abs];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name.startsWith('.'))
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === 'node_modules')
+                    continue;
+                if (!realpathWithin(rootAbs, full))
+                    continue;
+                stack.push(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                if (!realpathWithin(rootAbs, full))
+                    continue;
+                out.push(toPosix(path.relative(root, full)));
+            }
+        }
+    }
+    return out.sort();
+}
+/** Normalize a declared directory path for prefix comparison: no trailing slash. */
+export function stripSlash(p) {
+    return p.endsWith('/') ? p.slice(0, -1) : p;
+}
+/** True when relPath is the declared path itself or falls under it (POSIX). */
+export function underPath(relPath, declared) {
+    const base = stripSlash(declared);
+    // An empty or "." root means the repository root: everything is under it.
+    if (base === '' || base === '.')
+        return true;
+    return relPath === base || relPath.startsWith(base + '/');
+}
+//# sourceMappingURL=fsx.js.map

package/dist/lib/fsx.js.map

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

package/dist/lib/git.d.ts

@@ -0,0 +1,10 @@
+/** Absolute path of the git worktree containing root, or null when not in git. */
+export declare function gitToplevel(root: string): string | null;
+/**
+ * Last commit date (YYYY-MM-DD) of a file, or null when untracked, modified
+ * in the working tree, or outside a git repository. Callers fall back to a
+ * current date so that regeneration and the eventual commit stay consistent.
+ */
+export declare function gitLastModified(root: string, relPath: string): string | null;
+/** Content of the file at HEAD, or null (new file, no git, or no HEAD yet). */
+export declare function gitShowHead(root: string, relPath: string): string | null;

package/dist/lib/git.js

@@ -0,0 +1,55 @@
+import { execFileSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { toPosix } from './fsx.js';
+function git(root, args) {
+    try {
+        return execFileSync('git', ['-C', root, ...args], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 10_000,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/** Absolute path of the git worktree containing root, or null when not in git. */
+export function gitToplevel(root) {
+    const out = git(root, ['rev-parse', '--show-toplevel']);
+    return out ? out.trim() : null;
+}
+/**
+ * Last commit date (YYYY-MM-DD) of a file, or null when untracked, modified
+ * in the working tree, or outside a git repository. Callers fall back to a
+ * current date so that regeneration and the eventual commit stay consistent.
+ */
+export function gitLastModified(root, relPath) {
+    const status = git(root, ['status', '--porcelain', '--', relPath]);
+    if (status === null || status.trim() !== '')
+        return null;
+    const out = git(root, ['log', '-1', '--format=%cs', '--', relPath]);
+    const date = out?.trim();
+    return date ? date : null;
+}
+/** Content of the file at HEAD, or null (new file, no git, or no HEAD yet). */
+export function gitShowHead(root, relPath) {
+    const top = gitToplevel(root);
+    if (!top)
+        return null;
+    // realpath both sides: on macOS /tmp is a symlink and git reports the
+    // resolved toplevel, which would break the relative-path computation.
+    let resolvedTop;
+    let resolvedFile;
+    try {
+        resolvedTop = fs.realpathSync(top);
+        resolvedFile = fs.realpathSync(path.join(root, relPath));
+    }
+    catch {
+        // The declared file was deleted (or top vanished): no HEAD baseline.
+        return null;
+    }
+    const fromTop = toPosix(path.relative(resolvedTop, resolvedFile));
+    return git(root, ['show', `HEAD:${fromTop}`]);
+}
+//# sourceMappingURL=git.js.map