@warpgogol/forge 1.2.2 → 2.1.0

package/dist/src/knowledge/compact.js

@@ -1,320 +0,0 @@
-/*
-<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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,19 +0,0 @@
-/*
-<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

@@ -1 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,205 +0,0 @@
-/*
-<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

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

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

@@ -1,37 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}