@warpgogol/forge 2.1.0 → 2.3.0

package/dist/src/knowledge/compact.js

@@ -0,0 +1,320 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Knowledge compaction planning and execution — archive aged/superseded entries, mark stale L2 principles (RFC-0662).</purpose>
+<non-goals>
+  <item>Do not distill or group entries semantically — that is the fo-knowledge-distill skill's job.</item>
+  <item>Do not parse knowledge files — use parse.ts (RFC-0660).</item>
+  <item>Do not serialize — use serialize.ts (RFC-0660).</item>
+  <item>Do not wire into build pipelines or CI — invocation is operator-explicit.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0662: initial compaction module with planCompaction, executeCompaction, resolveRetentionDays, resolveStaleDays.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { parseKnowledgeFile } from "./parse.js";
+import { serializeKnowledgeFile } from "./serialize.js";
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+export const DEFAULT_RETENTION_DAYS = 90;
+export const DEFAULT_STALE_DAYS = 90;
+// ---------------------------------------------------------------------------
+// Date helpers
+// ---------------------------------------------------------------------------
+function parseDate(dateStr) {
+    const [y, m, d] = dateStr.split("-").map(Number);
+    return new Date(y, m - 1, d).getTime();
+}
+function daysBetween(from, to) {
+    const ms = parseDate(to) - parseDate(from);
+    return Math.floor(ms / (1000 * 60 * 60 * 24));
+}
+// ---------------------------------------------------------------------------
+// Archive companion path
+// ---------------------------------------------------------------------------
+function archiveCompanionPath(filePath) {
+    const dir = path.dirname(filePath);
+    const ext = path.extname(filePath);
+    const base = path.basename(filePath, ext);
+    return path.join(dir, `${base}.archive${ext}`);
+}
+// ---------------------------------------------------------------------------
+// planCompaction — pure function
+// ---------------------------------------------------------------------------
+export function planCompaction(files, options) {
+    const plans = [];
+    for (const file of files) {
+        // Skip knowledge-adjacent files (no structured entries)
+        if (file.isKnowledgeAdjacent)
+            continue;
+        const actions = [];
+        for (const entry of file.entries) {
+            const meta = entry.meta;
+            // 1. Expiry archive (all layers)
+            if (meta.expiresAt !== undefined && meta.expiresAt !== null) {
+                const diff = daysBetween(meta.expiresAt, options.today);
+                if (diff > 0) {
+                    actions.push({
+                        kind: "archive-expired",
+                        file: file.path,
+                        entryId: meta.id,
+                        reason: `expiresAt ${meta.expiresAt} is past today ${options.today}`,
+                    });
+                    continue;
+                }
+            }
+            // 2. Supersession archive (L1, L2)
+            if (meta.status === "superseded") {
+                actions.push({
+                    kind: "archive-superseded",
+                    file: file.path,
+                    entryId: meta.id,
+                    reason: `status is superseded`,
+                });
+                continue;
+            }
+            // 3. L0 retention archive
+            if (file.layer === "L0" && meta.status === "active") {
+                const age = daysBetween(meta.created, options.today);
+                if (age > options.retentionDays) {
+                    actions.push({
+                        kind: "archive-l0-retention",
+                        file: file.path,
+                        entryId: meta.id,
+                        reason: `created ${meta.created} older than ${options.retentionDays} days`,
+                    });
+                    continue;
+                }
+            }
+            // 4. L2 staleness marking
+            if (file.layer === "L2" &&
+                meta.status === "active" &&
+                meta.lastConfirmedAt !== undefined &&
+                meta.lastConfirmedAt !== null) {
+                const age = daysBetween(meta.lastConfirmedAt, options.today);
+                if (age > options.staleDays) {
+                    actions.push({
+                        kind: "mark-stale",
+                        file: file.path,
+                        entryId: meta.id,
+                        reason: `lastConfirmedAt ${meta.lastConfirmedAt} older than ${options.staleDays} days`,
+                    });
+                }
+            }
+        }
+        plans.push({
+            file: file.path,
+            archiveFile: archiveCompanionPath(file.path),
+            actions,
+            legacySectionCount: file.legacySections.length,
+        });
+    }
+    return plans;
+}
+// ---------------------------------------------------------------------------
+// executeCompaction — I/O execution
+// ---------------------------------------------------------------------------
+export function executeCompaction(plans, dryRun) {
+    const fileResults = [];
+    const errors = [];
+    let totalArchived = 0;
+    let totalMarkedStale = 0;
+    let totalLegacyFiles = 0;
+    for (const plan of plans) {
+        // Parse the live file
+        const parsed = parseKnowledgeFile(plan.file);
+        // Refuse if parse issues
+        if (parsed.parseIssues.length > 0) {
+            errors.push(`${plan.file}: ${parsed.parseIssues.length} parse issue(s) — refusing to compact`);
+            fileResults.push({
+                file: plan.file,
+                archiveFile: plan.archiveFile,
+                actions: plan.actions,
+                legacySectionCount: plan.legacySectionCount,
+                archived: 0,
+                markedStale: 0,
+                written: false,
+            });
+            continue;
+        }
+        // Build action lookup
+        const actionByEntryId = new Map();
+        for (const action of plan.actions) {
+            actionByEntryId.set(action.entryId, action);
+        }
+        // Partition entries
+        const keepEntries = [];
+        const archiveEntries = [];
+        for (const entry of parsed.entries) {
+            const action = actionByEntryId.get(entry.meta.id);
+            if (action && action.kind.startsWith("archive-")) {
+                archiveEntries.push(entry);
+            }
+            else if (action && action.kind === "mark-stale") {
+                // Keep in place, update status
+                keepEntries.push({
+                    ...entry,
+                    meta: { ...entry.meta, status: "stale" },
+                });
+            }
+            else {
+                keepEntries.push(entry);
+            }
+        }
+        // Check archive companion for parse issues if it exists
+        if (archiveEntries.length > 0 && fs.existsSync(plan.archiveFile)) {
+            const archiveParsed = parseKnowledgeFile(plan.archiveFile);
+            if (archiveParsed.parseIssues.length > 0) {
+                errors.push(`${plan.archiveFile}: ${archiveParsed.parseIssues.length} parse issue(s) — refusing to compact`);
+                fileResults.push({
+                    file: plan.file,
+                    archiveFile: plan.archiveFile,
+                    actions: plan.actions,
+                    legacySectionCount: plan.legacySectionCount,
+                    archived: 0,
+                    markedStale: 0,
+                    written: false,
+                });
+                continue;
+            }
+        }
+        const archived = archiveEntries.length;
+        const markedStale = plan.actions.filter((a) => a.kind === "mark-stale").length;
+        totalArchived += archived;
+        totalMarkedStale += markedStale;
+        if (plan.legacySectionCount > 0)
+            totalLegacyFiles++;
+        if (dryRun) {
+            fileResults.push({
+                file: plan.file,
+                archiveFile: plan.archiveFile,
+                actions: plan.actions,
+                legacySectionCount: plan.legacySectionCount,
+                archived,
+                markedStale,
+                written: false,
+            });
+            continue;
+        }
+        // Write live file (only if there are changes)
+        if (plan.actions.length > 0) {
+            const liveContent = serializeKnowledgeFile({
+                ...parsed,
+                entries: keepEntries,
+            });
+            try {
+                fs.writeFileSync(plan.file, liveContent, "utf8");
+            }
+            catch (err) {
+                errors.push(`${plan.file}: write failed — ${err.message}`);
+            }
+        }
+        // Write archive companion (only if there are entries to archive)
+        if (archiveEntries.length > 0) {
+            let archiveParsed;
+            if (fs.existsSync(plan.archiveFile)) {
+                archiveParsed = parseKnowledgeFile(plan.archiveFile);
+            }
+            else {
+                // Create new archive file with a preamble
+                const fileName = path.basename(plan.file);
+                archiveParsed = {
+                    path: plan.archiveFile,
+                    layer: parsed.layer,
+                    preamble: `<!-- knowledge-layer: ${parsed.layer ?? "L0"} -->\n# ${fileName} (archive)\n\nArchived entries from ${fileName}. Generated by forge.skill.knowledge.compact (RFC-0662).`,
+                    entries: [],
+                    legacySections: [],
+                    parseIssues: [],
+                    isKnowledgeAdjacent: false,
+                };
+            }
+            // Rewrite status for archived entries
+            const archivedEntries = archiveEntries.map((entry) => {
+                const action = actionByEntryId.get(entry.meta.id);
+                const newMeta = { ...entry.meta };
+                if (action.kind === "archive-expired" || action.kind === "archive-l0-retention") {
+                    newMeta.status = "archived";
+                }
+                // For archive-superseded: keep status as "superseded" (preserves supersedes chain)
+                return { ...entry, meta: newMeta };
+            });
+            const mergedContent = serializeKnowledgeFile({
+                ...archiveParsed,
+                entries: [...archiveParsed.entries, ...archivedEntries],
+            });
+            try {
+                // Use atomic write for archive companion
+                // writeFileAtomic is async, but we're in a sync context — use writeFileSync for simplicity
+                // The staging + rename pattern is handled by writeFileAtomic for production use
+                // For now, use direct write (the live file is already written non-atomically above)
+                fs.writeFileSync(plan.archiveFile, mergedContent, "utf8");
+            }
+            catch (err) {
+                errors.push(`${plan.archiveFile}: write failed — ${err.message}`);
+            }
+        }
+        fileResults.push({
+            file: plan.file,
+            archiveFile: plan.archiveFile,
+            actions: plan.actions,
+            legacySectionCount: plan.legacySectionCount,
+            archived,
+            markedStale,
+            written: true,
+        });
+    }
+    return {
+        command: "forge.skill.knowledge.compact",
+        status: errors.length > 0 ? "fail" : "pass",
+        dryRun,
+        files: fileResults,
+        totals: {
+            archived: totalArchived,
+            markedStale: totalMarkedStale,
+            legacyFiles: totalLegacyFiles,
+        },
+        ...(errors.length > 0 ? { errors } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// resolveRetentionDays / resolveStaleDays — reads forge.yaml
+// ---------------------------------------------------------------------------
+export function resolveRetentionDays(workspaceRoot) {
+    try {
+        const forgeYamlPath = path.join(workspaceRoot, "forge.yaml");
+        const content = fs.readFileSync(forgeYamlPath, "utf8");
+        const config = parseYaml(content);
+        const bindings = config?.bindings;
+        const knowledge = bindings?.knowledge;
+        const retentionDays = knowledge?.retentionDays;
+        if (typeof retentionDays === "number" && retentionDays > 0 && Number.isInteger(retentionDays)) {
+            return retentionDays;
+        }
+        return DEFAULT_RETENTION_DAYS;
+    }
+    catch {
+        return DEFAULT_RETENTION_DAYS;
+    }
+}
+export function resolveStaleDays(workspaceRoot) {
+    try {
+        const forgeYamlPath = path.join(workspaceRoot, "forge.yaml");
+        const content = fs.readFileSync(forgeYamlPath, "utf8");
+        const config = parseYaml(content);
+        const bindings = config?.bindings;
+        const knowledge = bindings?.knowledge;
+        const staleDays = knowledge?.staleDays;
+        if (typeof staleDays === "number" && staleDays > 0 && Number.isInteger(staleDays)) {
+            return staleDays;
+        }
+        return DEFAULT_STALE_DAYS;
+    }
+    catch {
+        return DEFAULT_STALE_DAYS;
+    }
+}
+//# sourceMappingURL=compact.js.map

package/dist/src/knowledge/compact.js.map

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

package/dist/src/knowledge/index.d.ts

@@ -0,0 +1,7 @@
+export { parseKnowledgeFile } from "./parse.ts";
+export { serializeKnowledgeFile } from "./serialize.ts";
+export { knowledgeEntryMetaSchema, type KnowledgeLayer, type KnowledgeEntryStatus, type KnowledgeEntryMeta, type KnowledgeEntry, type LegacySection, type ParseIssue, type ParsedKnowledgeFile, } from "./schema.ts";
+export { planCompaction, executeCompaction, resolveRetentionDays, resolveStaleDays, DEFAULT_RETENTION_DAYS, DEFAULT_STALE_DAYS, type CompactOptions, type CompactAction, type CompactActionKind, type CompactFilePlan, type CompactFileResult, type CompactReport, } from "./compact.ts";
+export { computeLayerBudgets, resolveKnowledgeBudgets, DEFAULT_KNOWLEDGE_BUDGETS, type KnowledgeBudgets, type LayerBudgetReport, } from "./budgets.ts";
+export { normalizeTitle, detectDuplicatePrinciples, planPromotion, type DuplicatePair, type PromotionPlan, } from "./promote.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/knowledge/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC"}

package/dist/src/knowledge/index.js

@@ -0,0 +1,19 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the knowledge module — parser, serializer, schema, and types (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not re-export from @warpgogol/* — forge src/ is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial knowledge module barrel export.</item>
+  <item>RFC-0663: added promote.ts exports for cross-skill duplicate detection and promotion planning.</item>
+</CHANGE_SUMMARY>
+*/
+export { parseKnowledgeFile } from "./parse.js";
+export { serializeKnowledgeFile } from "./serialize.js";
+export { knowledgeEntryMetaSchema, } from "./schema.js";
+export { planCompaction, executeCompaction, resolveRetentionDays, resolveStaleDays, DEFAULT_RETENTION_DAYS, DEFAULT_STALE_DAYS, } from "./compact.js";
+export { computeLayerBudgets, resolveKnowledgeBudgets, DEFAULT_KNOWLEDGE_BUDGETS, } from "./budgets.js";
+export { normalizeTitle, detectDuplicatePrinciples, planPromotion, } from "./promote.js";
+//# sourceMappingURL=index.js.map

package/dist/src/knowledge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/knowledge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,wBAAwB,GAQzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,GAOnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,GAG1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,aAAa,GAGd,MAAM,cAAc,CAAC"}

package/dist/src/knowledge/parse.d.ts

@@ -0,0 +1,3 @@
+import { type ParsedKnowledgeFile } from "./schema.ts";
+export declare function parseKnowledgeFile(filePath: string): ParsedKnowledgeFile;
+//# sourceMappingURL=parse.d.ts.map

package/dist/src/knowledge/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/knowledge/parse.ts"],"names":[],"mappings":"AAgBA,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAoBrB,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAsLxE"}

package/dist/src/knowledge/parse.js

@@ -0,0 +1,205 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Tolerant markdown parser for knowledge files — produces ParsedKnowledgeFile with entries, legacy sections, and parse issues (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not validate entry uniqueness or cross-references — that is handled by SKILL-20 in skill-validate.ts.</item>
+  <item>Do not serialize — that is handled by serialize.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial tolerant parser for structured knowledge entries.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { knowledgeEntryMetaSchema, } from "./schema.js";
+const ENTRY_HEADING_PATTERN = /^###\s+(K-\d{4})\s*:\s*(.+)$/;
+const KNOWLEDGE_ENTRY_FENCE = "knowledge-entry";
+const LAYER_COMMENT_PATTERN = /<!--\s*knowledge-layer:\s*(L[012])\s*-->/;
+const FILENAME_LAYER_MAP = {
+    "qa-log.md": "L0",
+    "fix-patterns.md": "L1",
+    "learned-principles.md": "L2",
+};
+function detectLayer(content, fileName) {
+    const commentMatch = content.match(LAYER_COMMENT_PATTERN);
+    if (commentMatch) {
+        return commentMatch[1];
+    }
+    return FILENAME_LAYER_MAP[fileName] ?? null;
+}
+export function parseKnowledgeFile(filePath) {
+    let content;
+    try {
+        content = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        // File read errors (EISDIR, ENOENT, etc.) — return empty result
+        return {
+            path: filePath,
+            layer: null,
+            preamble: "",
+            entries: [],
+            legacySections: [],
+            parseIssues: [],
+            isKnowledgeAdjacent: true,
+        };
+    }
+    const fileName = path.basename(filePath);
+    const lines = content.split(/\r?\n/);
+    const layer = detectLayer(content, fileName);
+    const entries = [];
+    const legacySections = [];
+    const parseIssues = [];
+    let i = 0;
+    let preambleEnd = 0;
+    // Find the first entry heading or the first non-preamble content
+    let firstEntryLine = -1;
+    for (let j = 0; j < lines.length; j++) {
+        if (ENTRY_HEADING_PATTERN.test(lines[j])) {
+            firstEntryLine = j;
+            break;
+        }
+    }
+    // If no entry headings and no layer declaration, it's a knowledge-adjacent file
+    const isKnowledgeAdjacent = firstEntryLine === -1 && layer === null;
+    if (isKnowledgeAdjacent) {
+        return {
+            path: filePath,
+            layer: null,
+            preamble: content,
+            entries: [],
+            legacySections: [],
+            parseIssues: [],
+            isKnowledgeAdjacent: true,
+        };
+    }
+    // Preamble is everything before the first entry heading
+    if (firstEntryLine === -1) {
+        // Has layer but no entries — all content is preamble (structured-empty file)
+        return {
+            path: filePath,
+            layer,
+            preamble: content,
+            entries: [],
+            legacySections: [],
+            parseIssues: [],
+            isKnowledgeAdjacent: false,
+        };
+    }
+    preambleEnd = firstEntryLine;
+    const preamble = lines.slice(0, preambleEnd).join("\n");
+    // Parse entries and legacy sections
+    i = preambleEnd;
+    while (i < lines.length) {
+        const headingMatch = lines[i].match(ENTRY_HEADING_PATTERN);
+        if (headingMatch) {
+            const entryId = headingMatch[1];
+            const title = headingMatch[2].trim();
+            const entryLineStart = i + 1; // 1-based
+            i++;
+            // Look for fenced knowledge-entry block immediately after heading
+            let meta = null;
+            let metaBlockStart = -1;
+            let _metaBlockEnd = -1;
+            // Skip blank lines between heading and fence
+            while (i < lines.length && lines[i].trim() === "") {
+                i++;
+            }
+            if (i < lines.length && lines[i].trim().startsWith("```")) {
+                const fenceTag = lines[i].trim().replace(/^```/, "").trim();
+                if (fenceTag === KNOWLEDGE_ENTRY_FENCE) {
+                    metaBlockStart = i + 1; // 1-based line after fence start
+                    i++;
+                    const yamlLines = [];
+                    while (i < lines.length && !lines[i].trim().startsWith("```")) {
+                        yamlLines.push(lines[i]);
+                        i++;
+                    }
+                    if (i < lines.length && lines[i].trim().startsWith("```")) {
+                        _metaBlockEnd = i + 1; // 1-based fence closing line
+                        i++;
+                        const yamlText = yamlLines.join("\n");
+                        try {
+                            const raw = parseYaml(yamlText);
+                            const result = knowledgeEntryMetaSchema.safeParse(raw);
+                            if (result.success) {
+                                meta = result.data;
+                            }
+                            else {
+                                for (const issue of result.error.issues) {
+                                    parseIssues.push({
+                                        line: metaBlockStart,
+                                        message: `Entry ${entryId}: ${issue.message}`,
+                                        entryId,
+                                    });
+                                }
+                            }
+                        }
+                        catch (err) {
+                            parseIssues.push({
+                                line: metaBlockStart,
+                                message: `Entry ${entryId}: YAML parse error: ${err.message}`,
+                                entryId,
+                            });
+                        }
+                    }
+                    else {
+                        parseIssues.push({
+                            line: metaBlockStart,
+                            message: `Entry ${entryId}: unterminated knowledge-entry fence`,
+                            entryId,
+                        });
+                    }
+                }
+            }
+            // Collect body until next entry heading or EOF
+            const bodyLines = [];
+            while (i < lines.length && !ENTRY_HEADING_PATTERN.test(lines[i])) {
+                bodyLines.push(lines[i]);
+                i++;
+            }
+            const body = bodyLines.join("\n").replace(/\n+$/, "");
+            if (meta) {
+                entries.push({
+                    meta,
+                    title,
+                    body,
+                    lineStart: entryLineStart,
+                });
+            }
+            else if (metaBlockStart === -1) {
+                // Heading exists but no metadata block followed — it's a legacy section
+                legacySections.push({
+                    text: lines.slice(entryLineStart - 1, i).join("\n"),
+                    lineStart: entryLineStart,
+                });
+            }
+            // If meta parsing failed, the parse issue is already recorded
+        }
+        else {
+            // Non-entry content — collect as legacy section
+            const legacyStart = i + 1; // 1-based
+            const legacyLines = [];
+            while (i < lines.length && !ENTRY_HEADING_PATTERN.test(lines[i])) {
+                legacyLines.push(lines[i]);
+                i++;
+            }
+            legacySections.push({
+                text: legacyLines.join("\n"),
+                lineStart: legacyStart,
+            });
+        }
+    }
+    return {
+        path: filePath,
+        layer,
+        preamble,
+        entries,
+        legacySections,
+        parseIssues,
+        isKnowledgeAdjacent: false,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/src/knowledge/parse.js.map

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

package/dist/src/knowledge/promote.d.ts

@@ -0,0 +1,37 @@
+import type { ParsedKnowledgeFile, KnowledgeEntry } from "./schema.ts";
+export interface DuplicatePair {
+    a: {
+        skill: string;
+        entryId: string;
+        title: string;
+    };
+    b: {
+        skill: string;
+        entryId: string;
+        title: string;
+    };
+    normalizedTitle: string;
+    kind: "exact" | "containment";
+}
+export interface PromotionPlan {
+    sharedEntry: KnowledgeEntry;
+    localPointers: Array<{
+        skill: string;
+        file: string;
+        entryId: string;
+    }>;
+}
+export declare function normalizeTitle(title: string): string;
+export declare function detectDuplicatePrinciples(files: Array<{
+    skill: string;
+    parsed: ParsedKnowledgeFile;
+}>): DuplicatePair[];
+export declare function planPromotion(sources: Array<{
+    skill: string;
+    file: string;
+    entry: KnowledgeEntry;
+}>, merged: {
+    title: string;
+    body: string;
+}, nextSharedId: string, today: string): PromotionPlan;
+//# sourceMappingURL=promote.d.ts.map

package/dist/src/knowledge/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../../src/knowledge/promote.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AAO3F,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,cAAc,CAAC;IAC5B,aAAa,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAuCD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,GAC3D,aAAa,EAAE,CAwCjB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC,EACtE,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,aAAa,CA6Bf"}