@warpgogol/forge 4.1.6 → 4.2.1

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"}

package/dist/src/knowledge/promote.js

@@ -0,0 +1,120 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Cross-skill duplicate detection and promotion planning for shared knowledge layer (RFC-0663).</purpose>
+<non-goals>
+  <item>Do not read or write files — that is handled by parse.ts/serialize.ts and the distill skill.</item>
+  <item>Do not execute promotions — that is the operator's decision inside fo-knowledge-distill.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0663: initial cross-skill duplicate detection and promotion planning.</item>
+</CHANGE_SUMMARY>
+*/
+const STOP_WORDS = new Set(["the", "a", "an"]);
+const MIN_CONTAINMENT_LENGTH = 20;
+const MIN_CONTAINMENT_RATIO = 0.6;
+export function normalizeTitle(title) {
+    let result = title.toLowerCase();
+    result = result.replace(/[^\p{L}\p{N}\s]/gu, " ");
+    result = result.replace(/\s+/g, " ").trim();
+    const words = result.split(" ").filter((w) => w.length > 0 && !STOP_WORDS.has(w));
+    return words.join(" ");
+}
+function isExcludedEntry(meta) {
+    if (meta.status === "stale" || meta.status === "archived")
+        return true;
+    if (meta.promotedTo !== undefined && meta.promotedTo !== null)
+        return true;
+    return false;
+}
+function isLinkedPair(metaA, metaB) {
+    if (metaA.supersedes && metaB.id && metaA.supersedes.includes(metaB.id))
+        return true;
+    if (metaB.supersedes && metaA.id && metaB.supersedes.includes(metaA.id))
+        return true;
+    if (metaA.promotedTo && metaB.id && metaA.promotedTo === `shared/${metaB.id}`)
+        return true;
+    if (metaB.promotedTo && metaA.id && metaB.promotedTo === `shared/${metaA.id}`)
+        return true;
+    return false;
+}
+function collectActiveEntries(files) {
+    const active = [];
+    for (const file of files) {
+        if (file.parsed.isKnowledgeAdjacent)
+            continue;
+        if (file.parsed.parseIssues.length > 0)
+            continue;
+        for (const entry of file.parsed.entries) {
+            if (isExcludedEntry(entry.meta))
+                continue;
+            const normalized = normalizeTitle(entry.title);
+            if (normalized.length === 0)
+                continue;
+            active.push({ skill: file.skill, entry, normalizedTitle: normalized });
+        }
+    }
+    return active;
+}
+export function detectDuplicatePrinciples(files) {
+    const active = collectActiveEntries(files);
+    const pairs = [];
+    for (let i = 0; i < active.length; i++) {
+        for (let j = i + 1; j < active.length; j++) {
+            const a = active[i];
+            const b = active[j];
+            if (isLinkedPair(a.entry.meta, b.entry.meta))
+                continue;
+            if (a.normalizedTitle === b.normalizedTitle) {
+                pairs.push({
+                    a: { skill: a.skill, entryId: a.entry.meta.id, title: a.entry.title },
+                    b: { skill: b.skill, entryId: b.entry.meta.id, title: b.entry.title },
+                    normalizedTitle: a.normalizedTitle,
+                    kind: "exact",
+                });
+                continue;
+            }
+            const shorter = a.normalizedTitle.length <= b.normalizedTitle.length ? a : b;
+            const longer = a.normalizedTitle.length <= b.normalizedTitle.length ? b : a;
+            if (shorter.normalizedTitle.length < MIN_CONTAINMENT_LENGTH)
+                continue;
+            if (shorter.normalizedTitle.length < longer.normalizedTitle.length * MIN_CONTAINMENT_RATIO)
+                continue;
+            if (longer.normalizedTitle.includes(shorter.normalizedTitle)) {
+                pairs.push({
+                    a: { skill: a.skill, entryId: a.entry.meta.id, title: a.entry.title },
+                    b: { skill: b.skill, entryId: b.entry.meta.id, title: b.entry.title },
+                    normalizedTitle: shorter.normalizedTitle,
+                    kind: "containment",
+                });
+            }
+        }
+    }
+    return pairs;
+}
+export function planPromotion(sources, merged, nextSharedId, today) {
+    const totalConfirmations = sources.reduce((sum, s) => sum + (s.entry.meta.confirmations ?? 0), 0);
+    const promotedFrom = sources.map((s) => `${s.skill}/${s.entry.meta.id}`);
+    const sharedMeta = {
+        id: nextSharedId,
+        layer: "L2",
+        created: today,
+        lastConfirmedAt: today,
+        confirmations: totalConfirmations,
+        status: "active",
+        promotedFrom,
+    };
+    const sharedEntry = {
+        meta: sharedMeta,
+        title: merged.title,
+        body: merged.body,
+        lineStart: 0,
+    };
+    const localPointers = sources.map((s) => ({
+        skill: s.skill,
+        file: s.file,
+        entryId: s.entry.meta.id,
+    }));
+    return { sharedEntry, localPointers };
+}
+//# sourceMappingURL=promote.js.map

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

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

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

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export type KnowledgeLayer = "L0" | "L1" | "L2";
+export type KnowledgeEntryStatus = "active" | "stale" | "superseded" | "archived";
+export declare const knowledgeEntryMetaSchema: z.ZodObject<{
+    id: z.ZodString;
+    layer: z.ZodEnum<{
+        L0: "L0";
+        L1: "L1";
+        L2: "L2";
+    }>;
+    created: z.ZodString;
+    lastConfirmedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    confirmations: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    supersedes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    promotedTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    promotedFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodEnum<{
+        active: "active";
+        stale: "stale";
+        superseded: "superseded";
+        archived: "archived";
+    }>;
+}, z.core.$strip>;
+export interface KnowledgeEntryMeta {
+    id: string;
+    layer: KnowledgeLayer;
+    created: string;
+    lastConfirmedAt?: string | null;
+    confirmations?: number;
+    expiresAt?: string | null;
+    supersedes?: string[];
+    promotedTo?: string | null;
+    promotedFrom?: string[];
+    status: KnowledgeEntryStatus;
+}
+export interface KnowledgeEntry {
+    meta: KnowledgeEntryMeta;
+    title: string;
+    body: string;
+    lineStart: number;
+}
+export interface LegacySection {
+    text: string;
+    lineStart: number;
+}
+export interface ParseIssue {
+    line: number;
+    message: string;
+    entryId?: string;
+}
+export interface ParsedKnowledgeFile {
+    path: string;
+    layer: KnowledgeLayer | null;
+    preamble: string;
+    entries: KnowledgeEntry[];
+    legacySections: LegacySection[];
+    parseIssues: ParseIssue[];
+    isKnowledgeAdjacent: boolean;
+}
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/knowledge/schema.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAmBlF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;iBAkCnC,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;CAC9B"}

package/dist/src/knowledge/schema.js

@@ -0,0 +1,64 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Define the Zod metadata schema for knowledge entries with layer-specific refinements (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not parse markdown — that is handled by parse.ts.</item>
+  <item>Do not serialize — that is handled by serialize.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial knowledge entry metadata schema with L0/L1/L2 layer-specific refinements.</item>
+  <item>RFC-0663: added promotedFrom field for shared-layer provenance tracking.</item>
+</CHANGE_SUMMARY>
+*/
+import { z } from "zod";
+const ENTRY_ID_PATTERN = /^K-\d{4}$/;
+const PROMOTED_TO_PATTERN = /^shared\/K-\d{4}$/;
+const PROMOTED_FROM_PATTERN = /^[a-z0-9-]+\/K-\d{4}$/;
+const baseMetaSchema = z.object({
+    id: z.string().regex(ENTRY_ID_PATTERN, "id must match ^K-\\d{4}$"),
+    layer: z.enum(["L0", "L1", "L2"]),
+    created: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "created must be YYYY-MM-DD"),
+    lastConfirmedAt: z.union([z.string().regex(/^\d{4}-\d{2}-\d{2}$/), z.null()]).optional(),
+    confirmations: z.number().int().min(0).optional(),
+    expiresAt: z.union([z.string().regex(/^\d{4}-\d{2}-\d{2}$/), z.null()]).optional(),
+    supersedes: z.array(z.string().regex(ENTRY_ID_PATTERN)).optional(),
+    promotedTo: z.union([z.string().regex(PROMOTED_TO_PATTERN), z.null()]).optional(),
+    promotedFrom: z.array(z.string().regex(PROMOTED_FROM_PATTERN)).optional(),
+    status: z.enum(["active", "stale", "superseded", "archived"]),
+});
+export const knowledgeEntryMetaSchema = baseMetaSchema.superRefine((data, ctx) => {
+    if (data.layer === "L0" || data.layer === "L1") {
+        if (data.confirmations !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `confirmations is forbidden on ${data.layer} entries`,
+                path: ["confirmations"],
+            });
+        }
+        if (data.lastConfirmedAt !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `lastConfirmedAt is forbidden on ${data.layer} entries`,
+                path: ["lastConfirmedAt"],
+            });
+        }
+    }
+    if (data.layer === "L2") {
+        if (data.confirmations === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "confirmations is required on L2 entries",
+                path: ["confirmations"],
+            });
+        }
+        if (data.lastConfirmedAt === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "lastConfirmedAt is required on L2 entries",
+                path: ["lastConfirmedAt"],
+            });
+        }
+    }
+});
+//# sourceMappingURL=schema.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/knowledge/serialize.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAoC3E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAsB1E"}

package/dist/src/knowledge/serialize.js

@@ -0,0 +1,67 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Round-trip serializer for knowledge files — reconstructs markdown from ParsedKnowledgeFile (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not parse — that is handled by parse.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial round-trip serializer for structured knowledge entries.</item>
+  <item>RFC-0663: added promotedFrom to FIELD_ORDER for shared-layer provenance.</item>
+</CHANGE_SUMMARY>
+*/
+const FIELD_ORDER = [
+    "id",
+    "layer",
+    "created",
+    "lastConfirmedAt",
+    "confirmations",
+    "expiresAt",
+    "supersedes",
+    "promotedTo",
+    "promotedFrom",
+    "status",
+];
+function formatYamlValue(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        return `[${value.join(", ")}]`;
+    }
+    if (typeof value === "string")
+        return value;
+    return String(value);
+}
+function serializeMeta(meta) {
+    const lines = ["```knowledge-entry"];
+    for (const field of FIELD_ORDER) {
+        const value = meta[field];
+        if (value === undefined)
+            continue;
+        lines.push(`${field}: ${formatYamlValue(value)}`);
+    }
+    lines.push("```");
+    return lines.join("\n");
+}
+export function serializeKnowledgeFile(parsed) {
+    const parts = [];
+    if (parsed.preamble) {
+        parts.push(parsed.preamble);
+    }
+    for (const entry of parsed.entries) {
+        parts.push(`### ${entry.meta.id}: ${entry.title}`);
+        parts.push("");
+        parts.push(serializeMeta(entry.meta));
+        if (entry.body) {
+            parts.push("");
+            parts.push(entry.body);
+        }
+    }
+    for (const legacy of parsed.legacySections) {
+        parts.push(legacy.text);
+    }
+    return parts.join("\n").replace(/\n{3,}/g, "\n\n") + "\n";
+}
+//# sourceMappingURL=serialize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/knowledge/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAIF,MAAM,WAAW,GAAiC;IAChD,IAAI;IACJ,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,QAAQ;CACT,CAAC;AAEF,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB;IAC7C,MAAM,KAAK,GAAa,CAAC,oBAAoB,CAAC,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA2B;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;AAC5D,CAAC"}

package/dist/src/migration-adapters/git-utils.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterAnalysis } from "./types.ts";
+export declare function runPostSetup(sourceDir: string, targetDir: string, analysis: AdapterAnalysis): void;
+//# sourceMappingURL=git-utils.d.ts.map

package/dist/src/migration-adapters/git-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../../src/migration-adapters/git-utils.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,GACxB,IAAI,CA8CN"}