living-ai-documentation 1.0.0

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

@@ -0,0 +1,26 @@
+export interface StoredConfig {
+    filenamePattern: string;
+    title: string;
+    theme: "light" | "dark" | "system";
+    language: "en" | "fr";
+    port: number;
+    extraFiles: string[];
+    showDiagramDebug: boolean;
+    diagramNodePalette: string[] | null;
+    diagramEdgePalette: string[] | null;
+    sourceRoot: string | null;
+    blockedFileExtensions: string[];
+    exclusiveFolderExpansion: boolean;
+    exclusiveCategoryExpansion: boolean;
+    codeBlockMaxHeight: number;
+    markdownSoftBreaks: boolean;
+}
+export interface LivingDocConfig extends Omit<StoredConfig, "sourceRoot" | "extraFiles"> {
+    docsFolder: string;
+    sourceRoot: string;
+    extraFiles: string[];
+}
+export declare function getConfigPath(docsPath: string): string;
+export declare function readConfig(docsPath: string): LivingDocConfig;
+export declare function writeConfig(docsPath: string, patch: Partial<StoredConfig>): LivingDocConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,kBAAkB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,wBAAwB,EAAE,OAAO,CAAC;IAClC,0BAA0B,EAAE,OAAO,CAAC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAID,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAiED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAuGD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAmB5D;AAID,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAC3B,eAAe,CAejB"}

package/dist/src/lib/config.js

@@ -0,0 +1,195 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigPath = getConfigPath;
+exports.readConfig = readConfig;
+exports.writeConfig = writeConfig;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const CONFIG_FILENAME = ".living-doc.json";
+// Default palettes mirror DEFAULT_NODE_PALETTE bg values and DEFAULT_EDGE_PALETTE in constants.js.
+// Stored explicitly so users see (and can edit) them in .living-doc.json from the start.
+const DEFAULT_DIAGRAM_NODE_PALETTE = [
+    "#ffffff", // c-white,
+    "#f5f5f4", // c-gray
+    "#f1f5f9", // c-slate
+    "#dbeafe", // c-blue
+    "#e0f2fe", // c-sky
+    "#cffafe", // c-cyan
+    "#ccfbf1", // c-teal
+    "#dcfce7", // c-green
+    "#ecfccb", // c-lime
+    "#fef9c3", // c-amber
+    "#ffedd5", // c-orange
+    "#fee2e2", // c-red
+    "#ffe4e6", // c-rose
+    "#fce7f3", // c-pink
+    "#ede9fe", // c-purple
+];
+const DEFAULT_DIAGRAM_EDGE_PALETTE = [
+    "#ffffff",
+    "#a8a29e",
+    "#374151",
+    "#3b82f6",
+    "#14b8a6",
+    "#22c55e",
+    "#f97316",
+    "#ef4444",
+    "#a855f7",
+];
+const DEFAULT_BLOCKED_FILE_EXTENSIONS = [
+    "exe",
+    "sh",
+    "bat",
+    "cmd",
+    "com",
+    "scr",
+    "ps1",
+    "msi",
+];
+const STORAGE_DEFAULTS = {
+    filenamePattern: "YYYY_MM_DD_HH_mm_[Category]_title",
+    title: "Living Documentation",
+    theme: "system",
+    language: "en",
+    port: 4321,
+    extraFiles: [],
+    showDiagramDebug: false,
+    diagramNodePalette: DEFAULT_DIAGRAM_NODE_PALETTE,
+    diagramEdgePalette: DEFAULT_DIAGRAM_EDGE_PALETTE,
+    sourceRoot: "..",
+    blockedFileExtensions: DEFAULT_BLOCKED_FILE_EXTENSIONS,
+    exclusiveFolderExpansion: false,
+    exclusiveCategoryExpansion: false,
+    codeBlockMaxHeight: 400,
+    markdownSoftBreaks: true,
+};
+function getConfigPath(docsPath) {
+    return path_1.default.join(docsPath, CONFIG_FILENAME);
+}
+function toPosix(p) {
+    return p.split(path_1.default.sep).join("/");
+}
+function toRelativeStorage(docsPath, abs) {
+    try {
+        const rel = path_1.default.relative(path_1.default.resolve(docsPath), path_1.default.resolve(abs));
+        if (path_1.default.isAbsolute(rel))
+            return null;
+        return toPosix(rel) || ".";
+    }
+    catch {
+        return null;
+    }
+}
+function resolveRelative(docsPath, rel) {
+    return path_1.default.resolve(docsPath, rel);
+}
+// Reads raw JSON, migrates any legacy absolute paths and the removed docsFolder field
+// in-memory, and writes back if anything changed. Returns the storage-shape config.
+function readAndMigrate(docsPath) {
+    const configPath = getConfigPath(docsPath);
+    if (!fs_1.default.existsSync(configPath)) {
+        return { ...STORAGE_DEFAULTS };
+    }
+    let raw;
+    try {
+        raw = JSON.parse(fs_1.default.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return { ...STORAGE_DEFAULTS };
+    }
+    let dirty = false;
+    // docsFolder was stored historically — now purely runtime. Drop it silently.
+    if ("docsFolder" in raw) {
+        delete raw.docsFolder;
+        dirty = true;
+    }
+    // Migrate sourceRoot: absolute → relative (or null if conversion impossible).
+    if (typeof raw.sourceRoot === "string" && path_1.default.isAbsolute(raw.sourceRoot)) {
+        const rel = toRelativeStorage(docsPath, raw.sourceRoot);
+        if (rel !== null) {
+            console.warn(`[living-doc] Migrating sourceRoot to relative path: "${rel}"`);
+            raw.sourceRoot = rel;
+        }
+        else {
+            console.warn(`[living-doc] Could not convert sourceRoot to a relative path; resetting to default.`);
+            raw.sourceRoot = null;
+        }
+        dirty = true;
+    }
+    // Migrate extraFiles: absolute entries → relative. Drop entries that can't be converted.
+    if (Array.isArray(raw.extraFiles)) {
+        const migrated = [];
+        let changed = false;
+        for (const entry of raw.extraFiles) {
+            if (typeof entry !== "string") {
+                changed = true;
+                continue;
+            }
+            if (path_1.default.isAbsolute(entry)) {
+                const rel = toRelativeStorage(docsPath, entry);
+                if (rel !== null) {
+                    console.warn(`[living-doc] Migrating extraFile to relative: "${rel}"`);
+                    migrated.push(rel);
+                }
+                else {
+                    console.warn(`[living-doc] Could not convert extraFile "${entry}" — dropping it.`);
+                }
+                changed = true;
+            }
+            else {
+                const normalized = toPosix(entry);
+                migrated.push(normalized);
+                if (normalized !== entry)
+                    changed = true;
+            }
+        }
+        if (changed) {
+            raw.extraFiles = migrated;
+            dirty = true;
+        }
+    }
+    if (dirty) {
+        try {
+            fs_1.default.writeFileSync(configPath, JSON.stringify(raw, null, 2), "utf-8");
+        }
+        catch {
+            // Non-fatal: config is read-only or disk is full. Runtime view still works.
+        }
+    }
+    return { ...STORAGE_DEFAULTS, ...raw };
+}
+function readConfig(docsPath) {
+    const stored = readAndMigrate(docsPath);
+    const absDocsPath = path_1.default.resolve(docsPath);
+    const sourceRoot = stored.sourceRoot === null
+        ? path_1.default.dirname(absDocsPath)
+        : resolveRelative(absDocsPath, stored.sourceRoot);
+    const extraFiles = stored.extraFiles.map((rel) => resolveRelative(absDocsPath, rel));
+    const { sourceRoot: _omitSrc, extraFiles: _omitExtra, ...rest } = stored;
+    void _omitSrc;
+    void _omitExtra;
+    return {
+        ...rest,
+        docsFolder: absDocsPath,
+        sourceRoot,
+        extraFiles,
+    };
+}
+// Callers pass the storage-shape (paths relative to docsFolder, POSIX slashes).
+// Values are normalised to POSIX before write so the file stays portable across OSes.
+function writeConfig(docsPath, patch) {
+    const stored = readAndMigrate(docsPath);
+    const updated = { ...stored, ...patch };
+    if ("sourceRoot" in patch && typeof updated.sourceRoot === "string") {
+        updated.sourceRoot = toPosix(updated.sourceRoot);
+    }
+    if ("extraFiles" in patch && Array.isArray(updated.extraFiles)) {
+        updated.extraFiles = updated.extraFiles.map((p) => toPosix(p));
+    }
+    fs_1.default.writeFileSync(getConfigPath(docsPath), JSON.stringify(updated, null, 2), "utf-8");
+    return readConfig(docsPath);
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist/src/lib/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function sha256File(absPath: string): string | null;
+//# sourceMappingURL=hash.d.ts.map

package/dist/src/lib/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/lib/hash.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD"}

package/dist/src/lib/hash.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256File = sha256File;
+const fs_1 = __importDefault(require("fs"));
+const crypto_1 = __importDefault(require("crypto"));
+function sha256File(absPath) {
+    try {
+        const buf = fs_1.default.readFileSync(absPath);
+        return crypto_1.default.createHash("sha256").update(buf).digest("hex");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=hash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/lib/hash.ts"],"names":[],"mappings":";;;;;AAGA,gCAOC;AAVD,4CAAoB;AACpB,oDAA4B;AAE5B,SAAgB,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,gBAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/lib/metadata.d.ts

@@ -0,0 +1,31 @@
+export interface MetadataEntry {
+    path: string;
+    hash: string;
+}
+export type MetadataStore = Record<string, MetadataEntry[]>;
+export type MetadataStatus = "unchanged" | "modified" | "missing";
+export interface MetadataItem {
+    path: string;
+    storedHash: string;
+    currentHash: string | null;
+    status: MetadataStatus;
+}
+export interface AccuracyReport {
+    items: MetadataItem[];
+    total: number;
+    unchanged: number;
+    modified: number;
+    missing: number;
+    accuracy: number;
+}
+export declare function metadataPath(docsPath: string): string;
+export declare function readMetadataStore(docsPath: string): MetadataStore;
+export declare function writeMetadataStore(docsPath: string, store: MetadataStore): void;
+export declare function resolveSourceRoot(docsPath: string): string;
+export declare function assertUnderSourceRoot(relOrAbs: string, sourceRoot: string): string;
+export declare function classifyEntry(entry: MetadataEntry, sourceRoot: string): MetadataItem;
+export declare function buildReport(entries: MetadataEntry[], sourceRoot: string): AccuracyReport;
+export declare function getDocEntries(docsPath: string, docId: string): MetadataEntry[];
+export declare function setDocEntries(docsPath: string, docId: string, entries: MetadataEntry[]): void;
+export declare function getFrontmatterField(content: string, key: string): string | null;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/src/lib/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/lib/metadata.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAQjE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,IAAI,CAMN;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,GACjB,YAAY,CAmBd;AAID,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EAAE,EACxB,UAAU,EAAE,MAAM,GACjB,cAAc,CAahB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,aAAa,EAAE,CAGjB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EAAE,GACvB,IAAI,CAKN;AAMD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAqBf"}

package/dist/src/lib/metadata.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metadataPath = metadataPath;
+exports.readMetadataStore = readMetadataStore;
+exports.writeMetadataStore = writeMetadataStore;
+exports.resolveSourceRoot = resolveSourceRoot;
+exports.assertUnderSourceRoot = assertUnderSourceRoot;
+exports.classifyEntry = classifyEntry;
+exports.buildReport = buildReport;
+exports.getDocEntries = getDocEntries;
+exports.setDocEntries = setDocEntries;
+exports.getFrontmatterField = getFrontmatterField;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("./config");
+const hash_1 = require("./hash");
+const METADATA_FILENAME = ".metadata.json";
+function metadataPath(docsPath) {
+    return path_1.default.join(docsPath, METADATA_FILENAME);
+}
+function readMetadataStore(docsPath) {
+    const p = metadataPath(docsPath);
+    if (!fs_1.default.existsSync(p))
+        return {};
+    try {
+        return JSON.parse(fs_1.default.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeMetadataStore(docsPath, store) {
+    fs_1.default.writeFileSync(metadataPath(docsPath), JSON.stringify(store, null, 2), "utf-8");
+}
+function resolveSourceRoot(docsPath) {
+    // readConfig always returns sourceRoot as an absolute path (resolved from storage).
+    return (0, config_1.readConfig)(docsPath).sourceRoot;
+}
+function assertUnderSourceRoot(relOrAbs, sourceRoot) {
+    // Returns the normalized relative path under sourceRoot.
+    const abs = path_1.default.isAbsolute(relOrAbs)
+        ? path_1.default.resolve(relOrAbs)
+        : path_1.default.resolve(sourceRoot, relOrAbs);
+    const base = path_1.default.resolve(sourceRoot) + path_1.default.sep;
+    if (!abs.startsWith(base) && abs !== path_1.default.resolve(sourceRoot)) {
+        throw new Error("Path escapes sourceRoot");
+    }
+    return path_1.default.relative(sourceRoot, abs);
+}
+function classifyEntry(entry, sourceRoot) {
+    const abs = path_1.default.resolve(sourceRoot, entry.path);
+    if (!fs_1.default.existsSync(abs)) {
+        return {
+            path: entry.path,
+            storedHash: entry.hash,
+            currentHash: null,
+            status: "missing",
+        };
+    }
+    const current = (0, hash_1.sha256File)(abs);
+    const status = current === entry.hash ? "unchanged" : "modified";
+    return {
+        path: entry.path,
+        storedHash: entry.hash,
+        currentHash: current,
+        status,
+    };
+}
+// accuracy = unchanged / total. Each entry is an assertion that the doc is in
+// sync with a source file; modified or missing both break that assertion.
+function buildReport(entries, sourceRoot) {
+    const items = entries.map((e) => classifyEntry(e, sourceRoot));
+    const total = items.length;
+    let unchanged = 0;
+    let modified = 0;
+    let missing = 0;
+    for (const it of items) {
+        if (it.status === "unchanged")
+            unchanged++;
+        else if (it.status === "modified")
+            modified++;
+        else
+            missing++;
+    }
+    const accuracy = total === 0 ? 1 : unchanged / total;
+    return { items, total, unchanged, modified, missing, accuracy };
+}
+function getDocEntries(docsPath, docId) {
+    const store = readMetadataStore(docsPath);
+    return store[docId] || [];
+}
+function setDocEntries(docsPath, docId, entries) {
+    const store = readMetadataStore(docsPath);
+    if (entries.length === 0)
+        delete store[docId];
+    else
+        store[docId] = entries;
+    writeMetadataStore(docsPath, store);
+}
+// Reads a frontmatter field from a Markdown document. Supports the two
+// conventions used in this project: YAML block (`---\nkey: value\n---`) and
+// ADR-style inline (`**key:** value` in the opening lines). Returns null when
+// not found. Case-insensitive on the key.
+function getFrontmatterField(content, key) {
+    const k = key.toLowerCase();
+    const head = content.slice(0, 4096);
+    if (head.startsWith("---")) {
+        const end = head.indexOf("\n---", 3);
+        if (end !== -1) {
+            const block = head.slice(3, end);
+            for (const line of block.split("\n")) {
+                const m = /^\s*([A-Za-z0-9_-]+)\s*:\s*(.+?)\s*$/.exec(line);
+                if (m && m[1].toLowerCase() === k)
+                    return m[2];
+            }
+        }
+    }
+    for (const line of head.split("\n", 30)) {
+        const m = /^\s*\*\*([A-Za-z0-9_-]+)\s*:\s*\*\*\s*(.+?)\s*$/.exec(line);
+        if (m && m[1].toLowerCase() === k)
+            return m[2];
+    }
+    return null;
+}
+//# sourceMappingURL=metadata.js.map

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

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

package/dist/src/lib/parser.d.ts

@@ -0,0 +1,11 @@
+export interface DocMetadata {
+    id: string;
+    filename: string;
+    title: string;
+    category: string;
+    folder: string[] | null;
+    date: string | null;
+    formattedDate: string | null;
+}
+export declare function parseFilename(filename: string, filenamePattern?: string): DocMetadata;
+//# sourceMappingURL=parser.d.ts.map

package/dist/src/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/lib/parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAgFD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW,CAyCrF"}

package/dist/src/lib/parser.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFilename = parseFilename;
+function dateStrToISO(s) {
+    const p = s.split('_');
+    return p.length === 5
+        ? `${p[0]}-${p[1]}-${p[2]}T${p[3]}:${p[4]}`
+        : `${p[0]}-${p[1]}-${p[2]}`;
+}
+function buildPatternsFromFormat(patternStr) {
+    const hasDate = /YYYY.*MM.*DD/.test(patternStr);
+    const hasTime = hasDate && /HH.*mm/.test(patternStr);
+    const hasCategory = /\[Category\]/i.test(patternStr);
+    // When pattern includes HH/mm, allow optional time portion so old files still parse
+    const dateGroup = hasTime
+        ? '(\\d{4}_\\d{2}_\\d{2}(?:_\\d{2}_\\d{2})?)'
+        : '(\\d{4}_\\d{2}_\\d{2})';
+    const catGroup = '\\[([^\\]]+)\\]';
+    const catBeforeDate = hasDate && hasCategory &&
+        patternStr.search(/\[Category\]/i) < patternStr.search(/YYYY/i);
+    if (hasDate && hasCategory) {
+        const ordered = catBeforeDate
+            ? `${catGroup}_${dateGroup}`
+            : `${dateGroup}_${catGroup}`;
+        return {
+            full: new RegExp(`^${ordered}_(.+)\\.md$`, 'i'),
+            dateOnly: new RegExp(`^${dateGroup}_(.+)\\.md$`, 'i'),
+            hasDate,
+            hasCategory,
+            catBeforeDate,
+        };
+    }
+    else if (hasDate) {
+        return {
+            full: null,
+            dateOnly: new RegExp(`^${dateGroup}_(.+)\\.md$`, 'i'),
+            hasDate,
+            hasCategory,
+            catBeforeDate: false,
+        };
+    }
+    else if (hasCategory) {
+        return {
+            full: new RegExp(`^${catGroup}_(.+)\\.md$`, 'i'),
+            dateOnly: null,
+            hasDate,
+            hasCategory,
+            catBeforeDate: false,
+        };
+    }
+    return { full: null, dateOnly: null, hasDate, hasCategory, catBeforeDate: false };
+}
+function formatDate(iso) {
+    const hasTime = iso.includes('T');
+    const datePart = hasTime ? iso.split('T')[0] : iso;
+    const [year, month, day] = datePart.split('-').map(Number);
+    const d = new Date(Date.UTC(year, month - 1, day));
+    const dateStr = d.toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+        timeZone: 'UTC',
+    });
+    return hasTime ? `${dateStr} ${iso.split('T')[1]}` : dateStr;
+}
+function titleCase(raw) {
+    return raw
+        .split('_')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+function parseFilename(filename, filenamePattern) {
+    const id = encodeURIComponent(filename.slice(0, -3));
+    const { full: FULL_PAT, dateOnly: DATE_ONLY_PAT, hasDate, hasCategory, catBeforeDate } = buildPatternsFromFormat(filenamePattern ?? 'YYYY_MM_DD_HH_mm_[Category]_title');
+    if (FULL_PAT) {
+        const full = filename.match(FULL_PAT);
+        if (full) {
+            if (hasDate && hasCategory) {
+                const dateStr = catBeforeDate ? full[2] : full[1];
+                const category = catBeforeDate ? full[1] : full[2];
+                const titlePart = full[3];
+                const date = dateStrToISO(dateStr);
+                return { id, filename, title: titleCase(titlePart), category, folder: null, date, formattedDate: formatDate(date) };
+            }
+            else if (hasCategory) {
+                const [, category, titlePart] = full;
+                return { id, filename, title: titleCase(titlePart), category, folder: null, date: null, formattedDate: null };
+            }
+        }
+    }
+    if (DATE_ONLY_PAT) {
+        const dateOnly = filename.match(DATE_ONLY_PAT);
+        if (dateOnly) {
+            const [, dateStr, titlePart] = dateOnly;
+            const date = dateStrToISO(dateStr);
+            return { id, filename, title: titleCase(titlePart), category: 'General', folder: null, date, formattedDate: formatDate(date) };
+        }
+    }
+    // Fallback — no date, no category
+    const rawTitle = filename.slice(0, -3).replace(/[_-]+/g, ' ');
+    return {
+        id,
+        filename,
+        title: rawTitle.charAt(0).toUpperCase() + rawTitle.slice(1),
+        category: 'General',
+        folder: null,
+        date: null,
+        formattedDate: null,
+    };
+}
+//# sourceMappingURL=parser.js.map

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

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

package/dist/src/lib/status.d.ts

@@ -0,0 +1,9 @@
+export declare function parseDocStatus(content: string): string | null;
+export declare function readDocStatus(docsPath: string, decodedDocId: string, extraFiles: string[]): string | null;
+export declare const SUPERSEEDED_STATUS = "SuperSeeded";
+export declare class DocumentSuperSeededError extends Error {
+    readonly code = "DOCUMENT_SUPERSEEDED";
+    constructor(message?: string);
+}
+export declare function assertNotSuperSeeded(docsPath: string, decodedDocId: string): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/src/lib/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/lib/status.ts"],"names":[],"mappings":"AAcA,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D;AAmBD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,GAAG,IAAI,CAQf;AAED,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAKhD,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,0BAA0B;gBAErC,OAAO,SAAoD;CAK9D;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,IAAI,CAKN"}