@aitne/daemon 0.1.0

package/dist/core/skill-curation/orphan-overlay.d.ts

@@ -0,0 +1,35 @@
+import type Database from "better-sqlite3";
+import { type SectionKind } from "@aitne/shared";
+export interface OrphanOverlay {
+    slug: string;
+    section_id: string;
+    kind: SectionKind | null;
+    applied_proposal_id: number | null;
+    applied_at: number | null;
+    reason: "section_not_declared" | "skill_has_no_curation" | "kind_mismatch";
+    overlay_path: string;
+}
+export interface OrphanOverlaysReport {
+    orphans: OrphanOverlay[];
+    scanned_overlays: number;
+}
+/** Walks `PA_DATA_DIR/skills/overlays/<slug>/*.json` and cross-references each
+ *  envelope against the current `curation.json` declaration for that slug.
+ *  Returns one record per orphan. Does not mutate disk. */
+export declare function detectOrphanOverlays(dataDir: string, skillsRoot: string): OrphanOverlaysReport;
+/** Boot-time scan: emits one log line per orphan + persists a summary in
+ *  `runtime_state.skill_curation.orphan_overlays` so the dashboard banner
+ *  can read it without re-walking the FS. */
+export declare function scanAndRecordOrphanOverlays(db: Database.Database, dataDir: string, skillsRoot: string): OrphanOverlaysReport;
+/** Owner-confirmed discard. Removes the on-disk overlay JSON. The renderer
+ *  falls back to seed (or empty) on the next session materialization. The
+ *  history snapshot is preserved so the user can recover the value via a
+ *  manual file copy if needed. */
+export declare function discardOrphanOverlay(dataDir: string, skillsRoot: string, slug: string, sectionId: string): {
+    ok: true;
+    discarded_path: string;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=orphan-overlay.d.ts.map

package/dist/core/skill-curation/orphan-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-overlay.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/orphan-overlay.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAQvB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,sBAAsB,GAAG,uBAAuB,GAAG,eAAe,CAAC;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;2DAE2D;AAC3D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAkFtB;AAED;;6CAE6C;AAC7C,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAsBtB;AAED;;;kCAGkC;AAClC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA2BtE"}

package/dist/core/skill-curation/orphan-overlay.js

@@ -0,0 +1,167 @@
+// P22 §5.4 — orphan overlay detector.
+//
+// An overlay is "orphaned" when its on-disk overlay JSON
+// (`PA_DATA_DIR/skills/overlays/<slug>/<section_id>.json`) has no matching
+// declaration in the skill's `curation.json`. This happens when a framework
+// PR removes a section from `curation.json` while a previously-applied
+// overlay still exists on disk for that section.
+//
+// Per design §5.4: overlays are NEVER auto-deleted — the user always
+// confirms. This module only detects + logs; the discard path is gated by
+// an explicit owner action via `POST /api/skill-curation/orphans/discard`.
+//
+// Logging cadence: at startup the daemon walks the overlay directory once
+// and emits one `skill_curation.declaration.orphan_overlay` log per orphan
+// found. Subsequent detections (e.g. after a `git pull` that removes a
+// section while the daemon is running) surface via the API endpoint that
+// re-walks on demand — there's no chokidar watch on `agent-assets/skills/`
+// because curation.json declarations are part of the framework, not user
+// data, and changes only occur on operator-initiated upgrades.
+//
+// The renderer falls back to the "anchor missing → strip line" path when
+// an orphan overlay is detected, so the rendered SKILL.md gracefully
+// degrades to the seed (or empty) until the overlay is discarded.
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { OverlayEnvelope, } from "@aitne/shared";
+import { readFileSync } from "node:fs";
+import { loadAllCurationDeclarations } from "./declarations.js";
+import { OverlayStore } from "./overlay-store.js";
+import { createLogger } from "../../logging.js";
+const logger = createLogger("skill-curation-orphan");
+/** Walks `PA_DATA_DIR/skills/overlays/<slug>/*.json` and cross-references each
+ *  envelope against the current `curation.json` declaration for that slug.
+ *  Returns one record per orphan. Does not mutate disk. */
+export function detectOrphanOverlays(dataDir, skillsRoot) {
+    const overlaysRoot = join(dataDir, "skills", "overlays");
+    if (!existsSync(overlaysRoot))
+        return { orphans: [], scanned_overlays: 0 };
+    const declarations = new Map();
+    for (const loaded of loadAllCurationDeclarations(skillsRoot)) {
+        declarations.set(loaded.slug, loaded.declaration);
+    }
+    const orphans = [];
+    let scanned = 0;
+    for (const slugEntry of readdirSync(overlaysRoot, { withFileTypes: true })) {
+        if (!slugEntry.isDirectory())
+            continue;
+        const slug = slugEntry.name;
+        const slugDir = join(overlaysRoot, slug);
+        for (const file of readdirSync(slugDir, { withFileTypes: true })) {
+            // Skip the history/ subdirectory and any non-JSON entries.
+            if (!file.isFile())
+                continue;
+            if (!file.name.endsWith(".json"))
+                continue;
+            scanned++;
+            const overlayPath = join(slugDir, file.name);
+            const sectionId = file.name.slice(0, -".json".length);
+            // Best-effort envelope parse — corrupt overlays are flagged as orphans
+            // with `kind=null` so the user sees them in the UI rather than having
+            // them silently fail at materialization time.
+            let envelopeKind = null;
+            let appliedProposalId = null;
+            let appliedAt = null;
+            try {
+                const raw = readFileSync(overlayPath, "utf-8");
+                const env = OverlayEnvelope.parse(JSON.parse(raw));
+                envelopeKind = env.kind;
+                appliedProposalId = env.applied_proposal_id;
+                appliedAt = env.applied_at;
+            }
+            catch {
+                // Corrupt overlay → still flagged as orphan, with null kind.
+            }
+            const decl = declarations.get(slug);
+            if (decl === undefined || decl === null) {
+                // Skill has no curation.json → every overlay is orphaned.
+                orphans.push({
+                    slug,
+                    section_id: sectionId,
+                    kind: envelopeKind,
+                    applied_proposal_id: appliedProposalId,
+                    applied_at: appliedAt,
+                    reason: "skill_has_no_curation",
+                    overlay_path: overlayPath,
+                });
+                continue;
+            }
+            const declared = decl.sections.find((s) => s.id === sectionId);
+            if (!declared) {
+                orphans.push({
+                    slug,
+                    section_id: sectionId,
+                    kind: envelopeKind,
+                    applied_proposal_id: appliedProposalId,
+                    applied_at: appliedAt,
+                    reason: "section_not_declared",
+                    overlay_path: overlayPath,
+                });
+                continue;
+            }
+            if (envelopeKind !== null && envelopeKind !== declared.kind) {
+                orphans.push({
+                    slug,
+                    section_id: sectionId,
+                    kind: envelopeKind,
+                    applied_proposal_id: appliedProposalId,
+                    applied_at: appliedAt,
+                    reason: "kind_mismatch",
+                    overlay_path: overlayPath,
+                });
+            }
+        }
+    }
+    return { orphans, scanned_overlays: scanned };
+}
+/** Boot-time scan: emits one log line per orphan + persists a summary in
+ *  `runtime_state.skill_curation.orphan_overlays` so the dashboard banner
+ *  can read it without re-walking the FS. */
+export function scanAndRecordOrphanOverlays(db, dataDir, skillsRoot) {
+    const report = detectOrphanOverlays(dataDir, skillsRoot);
+    for (const o of report.orphans) {
+        logger.warn({
+            slug: o.slug,
+            section_id: o.section_id,
+            kind: o.kind,
+            reason: o.reason,
+            applied_proposal_id: o.applied_proposal_id,
+        }, "skill_curation.declaration.orphan_overlay");
+    }
+    db.prepare(`INSERT INTO runtime_state (key, value_json, updated_at)
+     VALUES ('skill_curation.orphan_overlays', ?, CURRENT_TIMESTAMP)
+     ON CONFLICT(key) DO UPDATE SET
+       value_json = excluded.value_json,
+       updated_at = CURRENT_TIMESTAMP`).run(JSON.stringify({ orphans: report.orphans, scanned_at: Date.now() }));
+    return report;
+}
+/** Owner-confirmed discard. Removes the on-disk overlay JSON. The renderer
+ *  falls back to seed (or empty) on the next session materialization. The
+ *  history snapshot is preserved so the user can recover the value via a
+ *  manual file copy if needed. */
+export function discardOrphanOverlay(dataDir, skillsRoot, slug, sectionId) {
+    // Re-detect to make sure the orphan still exists (race-safe).
+    const report = detectOrphanOverlays(dataDir, skillsRoot);
+    const orphan = report.orphans.find((o) => o.slug === slug && o.section_id === sectionId);
+    if (!orphan) {
+        return { ok: false, reason: "not_orphan" };
+    }
+    const store = new OverlayStore(dataDir, skillsRoot);
+    if (!existsSync(orphan.overlay_path)) {
+        return { ok: false, reason: "overlay_missing" };
+    }
+    // Sanity check that the file we're about to delete is the overlay we
+    // detected (defense against TOCTOU between detect + discard).
+    try {
+        const st = statSync(orphan.overlay_path);
+        if (!st.isFile())
+            return { ok: false, reason: "not_file" };
+    }
+    catch {
+        return { ok: false, reason: "stat_failed" };
+    }
+    store.delete(slug, sectionId);
+    logger.info({ slug, section_id: sectionId, reason: orphan.reason }, "skill_curation.declaration.orphan_overlay_discarded");
+    return { ok: true, discarded_path: orphan.overlay_path };
+}
+//# sourceMappingURL=orphan-overlay.js.map

package/dist/core/skill-curation/orphan-overlay.js.map

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

package/dist/core/skill-curation/overlay-store.d.ts

@@ -0,0 +1,41 @@
+import { type CurationPayloadValue, type OverlayEnvelopeValue, type SectionKind } from "@aitne/shared";
+export interface OverlayStorePaths {
+    /** PA_DATA_DIR / skills / overlays / <slug> */
+    overlaysDir(slug: string): string;
+    /** PA_DATA_DIR / skills / overlays / <slug> / <section_id>.json */
+    overlayPath(slug: string, sectionId: string): string;
+    /** PA_DATA_DIR / skills / overlays / <slug> / history / <proposal_id>.json */
+    historyPath(slug: string, proposalId: number): string;
+    /** agent-assets / skills / <slug> / curation.seed.json */
+    seedPath(slug: string, sectionId: string): string;
+}
+export declare class OverlayStore {
+    private readonly dataDir;
+    private readonly skillsRoot;
+    /**
+     * @param dataDir Resolved PA_DATA_DIR (e.g. ~/.personal-agent expanded).
+     * @param skillsRoot Repo `agent-assets/skills/` (for seed JSON fallback).
+     */
+    constructor(dataDir: string, skillsRoot: string);
+    paths: OverlayStorePaths;
+    hasOverlay(slug: string, sectionId: string): boolean;
+    /** Returns the current overlay (or null when neither overlay nor seed exist). */
+    read(slug: string, sectionId: string, kind: SectionKind): OverlayEnvelopeValue | null;
+    /** Returns the payload only (overlay > seed > null). */
+    readPayload(slug: string, sectionId: string, kind: SectionKind): CurationPayloadValue | null;
+    readSeed(slug: string, sectionId: string, kind: SectionKind): OverlayEnvelopeValue | null;
+    /** P22 §5.1 — write a new overlay envelope (snapshotting prior to history). */
+    write(envelope: OverlayEnvelopeValue, snapshotProposalId: number | null): void;
+    /** Restore the overlay from a history snapshot (revert path). */
+    restoreFromHistory(slug: string, sectionId: string, proposalId: number): void;
+    /** Discard an overlay (orphan-overlay one-click discard, §5.4). */
+    delete(slug: string, sectionId: string): void;
+}
+/** Hash used by §5.1 step 3 conflict check. Stable JSON serialization. */
+export declare function payloadHash(payload: CurationPayloadValue): string;
+/** Guard rail for §5.4 schema migrations. v1 is the current schema; any
+ *  overlay claiming a higher version → load failure. Lower versions go
+ *  through the (currently empty) migrator chain. */
+export declare function migrateOverlay(env: OverlayEnvelopeValue): OverlayEnvelopeValue;
+export declare function isKnownSectionKind(value: string): value is SectionKind;
+//# sourceMappingURL=overlay-store.d.ts.map

package/dist/core/skill-curation/overlay-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-store.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/overlay-store.ts"],"names":[],"mappings":"AA4BA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAEzB,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,mEAAmE;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACrD,8EAA8E;IAC9E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACtD,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACnD;AAED,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B;;;OAGG;gBAEgB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM;IAGrC,KAAK,EAAE,iBAAiB,CAQtB;IAEF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAIpD,iFAAiF;IACjF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,oBAAoB,GAAG,IAAI;IAerF,wDAAwD;IACxD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,oBAAoB,GAAG,IAAI;IAK5F,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,oBAAoB,GAAG,IAAI;IAuBzF,+EAA+E;IAC/E,KAAK,CAAC,QAAQ,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAgB9E,iEAAiE;IACjE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAU7E,mEAAmE;IACnE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAI9C;AAOD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAEjE;AAUD;;oDAEoD;AACpD,wBAAgB,cAAc,CAAC,GAAG,EAAE,oBAAoB,GAAG,oBAAoB,CAW9E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEtE"}

package/dist/core/skill-curation/overlay-store.js

@@ -0,0 +1,143 @@
+// P22 §1.5, §5.4 — overlay store.
+//
+// Layout (under PA_DATA_DIR):
+//
+//   ~/.personal-agent/skills/overlays/<slug>/<section_id>.json   ← active overlay
+//   ~/.personal-agent/skills/overlays/<slug>/history/<proposal_id>.json
+//
+// Read precedence at session-materialization time:
+//
+//   1. Active overlay JSON       (operator-applied or auto-applied)
+//   2. Repo seed JSON             (agent-assets/skills/<slug>/curation.seed.json)
+//   3. Empty (anchor renders to nothing — strip the line)
+//
+// Schema-version migration is a stub for v1 — only one schema version exists.
+// When a future migrator chain lands under `migrate/v<n>-to-v<n+1>.ts` the
+// `migrateOverlay()` helper folds them in. Migrated overlays are NOT written
+// back to disk on cold boot — only after the user explicitly accepts the next
+// proposal that touches that section (§5.4).
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { CurationPayload, OverlayEnvelope, SECTION_KINDS, SKILL_CURATION_SCHEMA_VERSION, } from "@aitne/shared";
+export class OverlayStore {
+    dataDir;
+    skillsRoot;
+    /**
+     * @param dataDir Resolved PA_DATA_DIR (e.g. ~/.personal-agent expanded).
+     * @param skillsRoot Repo `agent-assets/skills/` (for seed JSON fallback).
+     */
+    constructor(dataDir, skillsRoot) {
+        this.dataDir = dataDir;
+        this.skillsRoot = skillsRoot;
+    }
+    paths = {
+        overlaysDir: (slug) => join(this.dataDir, "skills", "overlays", slug),
+        overlayPath: (slug, sectionId) => join(this.dataDir, "skills", "overlays", slug, `${sectionId}.json`),
+        historyPath: (slug, proposalId) => join(this.dataDir, "skills", "overlays", slug, "history", `${proposalId}.json`),
+        seedPath: (slug, sectionId) => join(this.skillsRoot, slug, "seeds", `${sectionId}.seed.json`),
+    };
+    hasOverlay(slug, sectionId) {
+        return existsSync(this.paths.overlayPath(slug, sectionId));
+    }
+    /** Returns the current overlay (or null when neither overlay nor seed exist). */
+    read(slug, sectionId, kind) {
+        const overlayPath = this.paths.overlayPath(slug, sectionId);
+        if (existsSync(overlayPath)) {
+            const env = parseEnvelope(readFileSync(overlayPath, "utf-8"));
+            if (env.kind !== kind) {
+                throw new Error(`overlay kind mismatch for ${slug}/${sectionId} (file=${env.kind}, expected=${kind})`);
+            }
+            return migrateOverlay(env);
+        }
+        const seed = this.readSeed(slug, sectionId, kind);
+        return seed;
+    }
+    /** Returns the payload only (overlay > seed > null). */
+    readPayload(slug, sectionId, kind) {
+        const env = this.read(slug, sectionId, kind);
+        return env ? env.payload : null;
+    }
+    readSeed(slug, sectionId, kind) {
+        const seedPath = this.paths.seedPath(slug, sectionId);
+        if (!existsSync(seedPath))
+            return null;
+        const raw = readFileSync(seedPath, "utf-8");
+        const json = JSON.parse(raw);
+        // A seed JSON is a bare payload (no envelope) by convention — wrap it.
+        const payload = CurationPayload.parse(json);
+        if (payload.kind !== kind) {
+            throw new Error(`seed kind mismatch for ${slug}/${sectionId} (seed=${payload.kind}, expected=${kind})`);
+        }
+        return {
+            schema_version: SKILL_CURATION_SCHEMA_VERSION,
+            skill_slug: slug,
+            section_id: sectionId,
+            kind,
+            payload,
+            applied_proposal_id: null,
+            applied_at: null,
+        };
+    }
+    /** P22 §5.1 — write a new overlay envelope (snapshotting prior to history). */
+    write(envelope, snapshotProposalId) {
+        const dir = this.paths.overlaysDir(envelope.skill_slug);
+        mkdirSync(dir, { recursive: true });
+        const target = this.paths.overlayPath(envelope.skill_slug, envelope.section_id);
+        if (snapshotProposalId !== null && existsSync(target)) {
+            const histDir = dirname(this.paths.historyPath(envelope.skill_slug, snapshotProposalId));
+            mkdirSync(histDir, { recursive: true });
+            writeFileSync(this.paths.historyPath(envelope.skill_slug, snapshotProposalId), readFileSync(target, "utf-8"), "utf-8");
+        }
+        writeFileSync(target, JSON.stringify(envelope, null, 2), "utf-8");
+    }
+    /** Restore the overlay from a history snapshot (revert path). */
+    restoreFromHistory(slug, sectionId, proposalId) {
+        const histPath = this.paths.historyPath(slug, proposalId);
+        if (!existsSync(histPath)) {
+            throw new Error(`no history snapshot for proposal ${proposalId}`);
+        }
+        const dir = this.paths.overlaysDir(slug);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(this.paths.overlayPath(slug, sectionId), readFileSync(histPath, "utf-8"), "utf-8");
+    }
+    /** Discard an overlay (orphan-overlay one-click discard, §5.4). */
+    delete(slug, sectionId) {
+        const target = this.paths.overlayPath(slug, sectionId);
+        if (existsSync(target))
+            rmSync(target, { force: true });
+    }
+}
+function parseEnvelope(raw) {
+    const json = JSON.parse(raw);
+    return OverlayEnvelope.parse(json);
+}
+/** Hash used by §5.1 step 3 conflict check. Stable JSON serialization. */
+export function payloadHash(payload) {
+    return createHash("sha256").update(canonicalJson(payload)).digest("hex");
+}
+function canonicalJson(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return "[" + value.map(canonicalJson).join(",") + "]";
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canonicalJson(obj[k])).join(",") + "}";
+}
+/** Guard rail for §5.4 schema migrations. v1 is the current schema; any
+ *  overlay claiming a higher version → load failure. Lower versions go
+ *  through the (currently empty) migrator chain. */
+export function migrateOverlay(env) {
+    if (env.schema_version === SKILL_CURATION_SCHEMA_VERSION)
+        return env;
+    if (env.schema_version > SKILL_CURATION_SCHEMA_VERSION) {
+        throw new Error(`overlay schema_version=${env.schema_version} > current=${SKILL_CURATION_SCHEMA_VERSION} (downgrade)`);
+    }
+    // No migrators yet — guard for future use.
+    throw new Error(`overlay schema_version=${env.schema_version} is too old; no migrator registered`);
+}
+export function isKnownSectionKind(value) {
+    return SECTION_KINDS.includes(value);
+}
+//# sourceMappingURL=overlay-store.js.map

package/dist/core/skill-curation/overlay-store.js.map

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

package/dist/core/skill-curation/render/convention-notes.d.ts

@@ -0,0 +1,4 @@
+import type { ConventionNotesValue } from "@aitne/shared";
+export declare const RENDERER_VERSION = "convention_notes/1";
+export declare function renderConventionNotes(payload: ConventionNotesValue): string;
+//# sourceMappingURL=convention-notes.d.ts.map

package/dist/core/skill-curation/render/convention-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-notes.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/convention-notes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAO3E"}

package/dist/core/skill-curation/render/convention-notes.js

@@ -0,0 +1,13 @@
+// P22 §1.4.5 — convention_notes renderer.
+//
+// Bullet list, **topic** bolded, rule body, optional example after "Example:".
+export const RENDERER_VERSION = "convention_notes/1";
+export function renderConventionNotes(payload) {
+    return payload.notes
+        .map((note) => {
+        const example = note.example ? ` Example: \`${note.example}\`.` : "";
+        return `- **${note.topic}.** ${note.rule}${example}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=convention-notes.js.map

package/dist/core/skill-curation/render/convention-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-notes.js","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/convention-notes.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,+EAA+E;AAI/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD,MAAM,UAAU,qBAAqB,CAAC,OAA6B;IACjE,OAAO,OAAO,CAAC,KAAK;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,OAAO,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/core/skill-curation/render/cross-references.d.ts

@@ -0,0 +1,4 @@
+import type { CrossReferencesValue } from "@aitne/shared";
+export declare const RENDERER_VERSION = "cross_references/1";
+export declare function renderCrossReferences(payload: CrossReferencesValue): string;
+//# sourceMappingURL=cross-references.d.ts.map

package/dist/core/skill-curation/render/cross-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-references.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/cross-references.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAI3E"}

package/dist/core/skill-curation/render/cross-references.js

@@ -0,0 +1,10 @@
+// P22 §1.4.5 — cross_references renderer.
+//
+// Single-line bullets. No prose, no code fences.
+export const RENDERER_VERSION = "cross_references/1";
+export function renderCrossReferences(payload) {
+    return payload.refs
+        .map((ref) => `- \`${ref.from_path}\` ↔ \`${ref.to_path}\` — ${ref.relation}`)
+        .join("\n");
+}
+//# sourceMappingURL=cross-references.js.map

package/dist/core/skill-curation/render/cross-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-references.js","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/cross-references.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AAIjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD,MAAM,UAAU,qBAAqB,CAAC,OAA6B;IACjE,OAAO,OAAO,CAAC,IAAI;SAChB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,SAAS,UAAU,GAAG,CAAC,OAAO,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;SAC7E,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/core/skill-curation/render/frontmatter-schema.d.ts

@@ -0,0 +1,4 @@
+import type { FrontmatterSchemaValue } from "@aitne/shared";
+export declare const RENDERER_VERSION = "frontmatter_schema/1";
+export declare function renderFrontmatterSchema(payload: FrontmatterSchemaValue): string;
+//# sourceMappingURL=frontmatter-schema.d.ts.map

package/dist/core/skill-curation/render/frontmatter-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/frontmatter-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAUvD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAa/E"}

package/dist/core/skill-curation/render/frontmatter-schema.js

@@ -0,0 +1,25 @@
+// P22 §1.4.5 — frontmatter_schema renderer.
+//
+// Per-glob block. Type info renders as inline backtick fragments.
+export const RENDERER_VERSION = "frontmatter_schema/1";
+function renderRequired(field) {
+    return `\`${field.key}: ${field.example}\``;
+}
+function renderConventional(field) {
+    return `\`${field.key}\``;
+}
+export function renderFrontmatterSchema(payload) {
+    const blocks = [];
+    for (const ft of payload.file_types) {
+        const lines = [`**\`${ft.glob}\`**`];
+        if (ft.required.length > 0) {
+            lines.push(`- Required: ${ft.required.map(renderRequired).join(" · ")}`);
+        }
+        if (ft.conventional.length > 0) {
+            lines.push(`- Conventional: ${ft.conventional.map(renderConventional).join(" · ")}`);
+        }
+        blocks.push(lines.join("\n"));
+    }
+    return blocks.join("\n\n");
+}
+//# sourceMappingURL=frontmatter-schema.js.map

package/dist/core/skill-curation/render/frontmatter-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.js","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/frontmatter-schema.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,kEAAkE;AAIlE,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,SAAS,cAAc,CAAC,KAAuE;IAC7F,OAAO,KAAK,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA2E;IACrG,OAAO,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAA+B;IACrE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,KAAK,GAAa,CAAC,OAAO,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC;QAC/C,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/core/skill-curation/render/index.d.ts

@@ -0,0 +1,5 @@
+import type { CurationPayloadValue, SectionKind } from "@aitne/shared";
+export declare const RENDERER_VERSIONS: Record<SectionKind, string>;
+export declare function rendererVersionFor(kind: SectionKind): string;
+export declare function renderCurationSection(kind: SectionKind, payload: CurationPayloadValue): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/skill-curation/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA0BvE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAOzD,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAoBR"}

package/dist/core/skill-curation/render/index.js

@@ -0,0 +1,42 @@
+// P22 §2.2 step 6 — kind-dispatched renderer entry point.
+//
+// `renderCurationSection(kind, payload)` is the only function the API hot
+// path calls. Each per-kind module exports `RENDERER_VERSION` so we can
+// pin proposals to the renderer revision they were generated with (§5.4).
+import { renderConventionNotes, RENDERER_VERSION as CONVENTION_NOTES_VERSION, } from "./convention-notes.js";
+import { renderCrossReferences, RENDERER_VERSION as CROSS_REFERENCES_VERSION, } from "./cross-references.js";
+import { renderFrontmatterSchema, RENDERER_VERSION as FRONTMATTER_SCHEMA_VERSION, } from "./frontmatter-schema.js";
+import { renderKnowledgeLayout, RENDERER_VERSION as KNOWLEDGE_LAYOUT_VERSION, } from "./knowledge-layout.js";
+import { renderRoutingTable, RENDERER_VERSION as ROUTING_TABLE_VERSION, } from "./routing-table.js";
+import { renderSearchRecipes, RENDERER_VERSION as SEARCH_RECIPES_VERSION, } from "./search-recipes.js";
+export const RENDERER_VERSIONS = {
+    knowledge_layout: KNOWLEDGE_LAYOUT_VERSION,
+    routing_table: ROUTING_TABLE_VERSION,
+    frontmatter_schema: FRONTMATTER_SCHEMA_VERSION,
+    search_recipes: SEARCH_RECIPES_VERSION,
+    convention_notes: CONVENTION_NOTES_VERSION,
+    cross_references: CROSS_REFERENCES_VERSION,
+};
+export function rendererVersionFor(kind) {
+    return RENDERER_VERSIONS[kind];
+}
+export function renderCurationSection(kind, payload) {
+    if (payload.kind !== kind) {
+        throw new Error(`renderCurationSection: kind mismatch (expected ${kind}, got ${payload.kind})`);
+    }
+    switch (payload.kind) {
+        case "knowledge_layout":
+            return renderKnowledgeLayout(payload);
+        case "routing_table":
+            return renderRoutingTable(payload);
+        case "frontmatter_schema":
+            return renderFrontmatterSchema(payload);
+        case "search_recipes":
+            return renderSearchRecipes(payload);
+        case "convention_notes":
+            return renderConventionNotes(payload);
+        case "cross_references":
+            return renderCrossReferences(payload);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/skill-curation/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,0EAA0E;AAG1E,OAAO,EACL,qBAAqB,EACrB,gBAAgB,IAAI,wBAAwB,GAC7C,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,IAAI,wBAAwB,GAC7C,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,IAAI,0BAA0B,GAC/C,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,IAAI,wBAAwB,GAC7C,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,IAAI,qBAAqB,GAC1C,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,IAAI,sBAAsB,GAC3C,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,gBAAgB,EAAE,wBAAwB;IAC1C,aAAa,EAAE,qBAAqB;IACpC,kBAAkB,EAAE,0BAA0B;IAC9C,cAAc,EAAE,sBAAsB;IACtC,gBAAgB,EAAE,wBAAwB;IAC1C,gBAAgB,EAAE,wBAAwB;CAC3C,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,IAAiB;IAClD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAiB,EACjB,OAA6B;IAE7B,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,kDAAkD,IAAI,SAAS,OAAO,CAAC,IAAI,GAAG,CAC/E,CAAC;IACJ,CAAC;IACD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,kBAAkB;YACrB,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,eAAe;YAClB,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACrC,KAAK,oBAAoB;YACvB,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,gBAAgB;YACnB,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,kBAAkB;YACrB,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,kBAAkB;YACrB,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/core/skill-curation/render/knowledge-layout.d.ts

@@ -0,0 +1,4 @@
+import type { KnowledgeLayoutValue } from "@aitne/shared";
+export declare const RENDERER_VERSION = "knowledge_layout/1";
+export declare function renderKnowledgeLayout(payload: KnowledgeLayoutValue): string;
+//# sourceMappingURL=knowledge-layout.d.ts.map

package/dist/core/skill-curation/render/knowledge-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-layout.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/knowledge-layout.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAyBrD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAW3E"}

package/dist/core/skill-curation/render/knowledge-layout.js

@@ -0,0 +1,36 @@
+// P22 §1.4.5 — knowledge_layout renderer.
+//
+// Compact tabular form when ≥3 files; bullet form below that. The
+// template emits no headings — the surrounding SKILL.md owns the title.
+export const RENDERER_VERSION = "knowledge_layout/1";
+const TABLE_THRESHOLD = 3;
+function joinSections(file) {
+    return file.sections
+        .map((section) => {
+        const writers = section.writers && section.writers.length > 1
+            ? ` _(${section.writers.join(", ")})_`
+            : "";
+        return `${section.heading.replace(/^#+\s*/, "")}${writers}`;
+    })
+        .join(" · ");
+}
+function renderRow(file) {
+    const sections = joinSections(file);
+    return `| \`${file.path}\` | ${file.purpose} | ${sections} |`;
+}
+function renderBullet(file) {
+    const sections = joinSections(file);
+    return `- \`${file.path}\` — ${file.purpose} (${sections})`;
+}
+export function renderKnowledgeLayout(payload) {
+    const files = payload.files;
+    if (files.length === 0)
+        return "";
+    if (files.length >= TABLE_THRESHOLD) {
+        const header = "| File | Purpose | Sections |";
+        const sep = "|---|---|---|";
+        return [header, sep, ...files.map(renderRow)].join("\n");
+    }
+    return files.map(renderBullet).join("\n");
+}
+//# sourceMappingURL=knowledge-layout.js.map

package/dist/core/skill-curation/render/knowledge-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-layout.js","sourceRoot":"","sources":["../../../../src/core/skill-curation/render/knowledge-layout.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,kEAAkE;AAClE,wEAAwE;AAIxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,SAAS,YAAY,CAAC,IAA2C;IAC/D,OAAO,IAAI,CAAC,QAAQ;SACjB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC3D,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACtC,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC;IAC9D,CAAC,CAAC;SACD,IAAI,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,IAA2C;IAC5D,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,OAAO,MAAM,QAAQ,IAAI,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CAAC,IAA2C;IAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,OAAO,KAAK,QAAQ,GAAG,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA6B;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,IAAI,KAAK,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,+BAA+B,CAAC;QAC/C,MAAM,GAAG,GAAG,eAAe,CAAC;QAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}