@warpgogol/forge 2.17.0 → 2.20.0

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

package/dist/src/knowledge/promote.js

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../../src/migration-adapters/git-utils.ts"],"names":[],"mappings":"AAkBA,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"}