@aitne/daemon 0.1.0

package/dist/core/skeleton.js

@@ -0,0 +1,255 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync, writeFileSync, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { CONTEXT_DIR_NAMES, CONTEXT_RELATIVE_PATHS } from "./context-paths.js";
+import { backfillContextFrontmatter } from "./context-frontmatter-backfill.js";
+import { preTickProfileQuestions } from "./profile-questions/seed.js";
+import { createLogger } from "../logging.js";
+/**
+ * Relative path of the profile-interview queue file, mirrored from the
+ * shipped template. Hardcoded here (rather than imported from
+ * `context-paths.ts`) because the seed runs before any caller would
+ * read it from runtime config.
+ */
+const PROFILE_QUESTIONS_REL = "agent/profile-questions.md";
+const logger = createLogger("skeleton");
+/**
+ * Fallback placeholders for `today.md` and `roadmap.md` used when the
+ * shipped templates tree is unreachable. Exported so the skeleton test
+ * can assert byte-equality with `agent-assets/templates/today.md` and
+ * `agent-assets/templates/roadmap.md` — a drift canary against the two
+ * paths diverging. See `skeleton.test.ts:"fallback matches template"`.
+ */
+export const FALLBACK_PLACEHOLDERS = Object.freeze({
+    [CONTEXT_RELATIVE_PATHS.today]: [
+        "# Today",
+        "",
+        "## User Schedule",
+        "",
+        "## User Tasks",
+        "",
+        "## Agent Plan",
+        "",
+        "## Agent Notes",
+        "",
+        "## Agent Log",
+        "",
+        "## Handoff",
+        "",
+    ].join("\n"),
+    // Roadmap skeleton: `Last synced: 1970-01-01` is an intentional Unix-epoch
+    // sentinel — a valid YMD so `roadmap-validate.ts:LAST_SYNCED_RE` accepts
+    // mid-seed PATCHes, but obviously-stale so it is never mistaken for a real
+    // sync timestamp. `(Not yet configured)` bullets under Annual Goals and
+    // Quarterly Focus cause `config.ts:isRoadmapStale` to flag the file and
+    // trigger the `roadmap_refresh` catch-up (see `index.ts:1857` comment).
+    [CONTEXT_RELATIVE_PATHS.roadmap]: [
+        "# Roadmap",
+        "> Last synced: 1970-01-01",
+        "",
+        "## Annual Goals",
+        "- (Not yet configured)",
+        "",
+        "## Quarterly Focus",
+        "- (Not yet configured)",
+        "",
+        "## Long-term Plans",
+        "",
+        "## Agent Action Plan",
+        "",
+        "## Recurring",
+        "- Every Friday: weekly review",
+        "",
+    ].join("\n"),
+});
+/**
+ * Locate `agent-assets/templates/` with multiple fallbacks so skeleton
+ * seeding works regardless of how the daemon is launched.
+ *
+ * The daemon can be launched from the repo root (dev / `pa start`),
+ * from an arbitrary cwd (systemd, launchd, Docker), or from a prebuilt
+ * tarball. Each layout positions `agent-assets/` differently relative
+ * to `process.cwd()`, so relying on `cwd + "./agent-assets/templates"`
+ * alone silently fails in prod deployments.
+ *
+ * Search order (first hit on disk wins):
+ *  1. `PA_TEMPLATES_DIR` environment variable — explicit override for
+ *     unusual deployments and tests that want to steer the function
+ *     at a tree they own.
+ *  2. `<workspaceDir>/agent-assets/templates` — dev mode (`pa start`
+ *     launched from the repo root) AND the test harness (which sets
+ *     a per-test `workspaceDir` with a fake templates tree). Placing
+ *     this ahead of the module-derived fallback lets tests influence
+ *     resolution without having to shell out to an env var.
+ *  3. A path derived from this module's own URL via `import.meta.url`
+ *     — walks up from `packages/daemon/{src,dist}/core/skeleton.{ts,js}`
+ *     to the repo root. Acts as the production-safety fallback when
+ *     `workspaceDir` is "." but cwd is not the repo root (systemd,
+ *     launchd, Docker, … — exactly the cases where the old "cwd + ./"
+ *     resolution silently fell through to the "skip seed" branch).
+ *
+ * Returns `null` if none of the candidates exist on disk; callers
+ * degrade gracefully (skeleton subdirectories and placeholders still
+ * land, only template-sourced files are skipped).
+ */
+export function resolveTemplatesRoot(workspaceDir) {
+    const candidates = [];
+    const envOverride = process.env.PA_TEMPLATES_DIR;
+    if (envOverride && envOverride.length > 0) {
+        candidates.push(resolve(envOverride));
+    }
+    candidates.push(join(workspaceDir, "agent-assets", "templates"));
+    // `import.meta.url` — anchored to this source file, not cwd. The
+    // path is `packages/daemon/{src,dist}/core/skeleton.{ts,js}`; we walk
+    // up four levels to reach the repo root.
+    try {
+        const self = fileURLToPath(import.meta.url);
+        const repoRoot = resolve(dirname(self), "..", "..", "..", "..");
+        candidates.push(join(repoRoot, "agent-assets", "templates"));
+    }
+    catch {
+        // `import.meta.url` resolution can fail under some bundlers — fall
+        // back to candidates already collected.
+    }
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Materialize the agent's skeleton vault layout at `contextDir`.
+ *
+ * B-007 §8 — seed the fresh-install vault layout from `agent-assets/templates/`.
+ * Idempotent by design: existing files are preserved, missing ones are
+ * added. Safe to invoke both at setup completion AND at every successful
+ * vault migration.
+ *
+ * Called from:
+ *  - `api/routes/setup-migrate.ts` — right after `commitVaultSettings`
+ *    so the target directory is immediately usable when the user
+ *    selects an obsidian vault path (or changes it later via Settings
+ *    → Management Mode). Without this the target would only contain
+ *    the empty subdirectories that `initDirectories` created under the
+ *    plain-mode fallback, leaving the agent with no policy files /
+ *    routine rulebooks / user profile for prompt injection.
+ *  - `api/routes/setup.ts` `/setup/save-rules` — kept as a safety net
+ *    for any code path that commits `rules/management.md` without going
+ *    through migrate-context (e.g. the plain-mode first-run flow).
+ *
+ * When `agent-assets/templates/` is missing (running from a prebuilt
+ * tarball without assets, or an unexpected `workspaceDir`), the
+ * function still materializes the canonical subdirectory skeleton and
+ * the `today.md` / `roadmap.md` placeholders so the agent has a valid
+ * working surface; template-sourced files are just skipped with a
+ * warning in that case.
+ */
+export function ensureSkeletonFiles(contextDir, workspaceDir, options = {}) {
+    // Always materialize canonical subdirectories. This is a no-op when
+    // they already exist and gives the agent a consistent layout even
+    // when the templates tree is unavailable.
+    for (const sub of CONTEXT_DIR_NAMES) {
+        mkdirSync(join(contextDir, sub), { recursive: true });
+    }
+    // Profile-interview queue Layer 1 (deterministic skeleton-time
+    // pre-tick) only fires when the queue file did not already exist —
+    // re-runs over an existing vault must not overwrite hand-edits or
+    // accumulated `last_attempted` history. See
+    // docs/design/backlog/profile-interview-queue.md §3.5.1.
+    const profileQueuePath = join(contextDir, PROFILE_QUESTIONS_REL);
+    const profileQueueExistedBefore = existsSync(profileQueuePath);
+    const templatesRoot = resolveTemplatesRoot(workspaceDir);
+    if (templatesRoot !== null) {
+        copyTreePreservingExisting(templatesRoot, contextDir, options);
+        logger.info({ templatesRoot, contextDir }, "skeleton seeded from templates tree");
+    }
+    else {
+        logger.warn({ contextDir, workspaceDir, env: process.env.PA_TEMPLATES_DIR ?? null }, "agent-assets/templates/ not locatable — skipping template seed (placeholders will still be written)");
+    }
+    // Fallback placeholders used ONLY when `agent-assets/templates/` is not
+    // locatable (rare: tarball deployments without assets, misconfigured
+    // `workspaceDir`). Byte-equal to the shipped `today.md` / `roadmap.md`
+    // templates so both paths produce identical install state. Do NOT add
+    // dynamic substitutions here — the first `roadmap_refresh` routine
+    // populates `Last synced:` with a real date.
+    //
+    // Invariant checked by `skeleton.test.ts`: these strings match
+    // `agent-assets/templates/today.md` and `agent-assets/templates/roadmap.md`
+    // byte-for-byte.
+    for (const [rel, content] of Object.entries(FALLBACK_PLACEHOLDERS)) {
+        const full = join(contextDir, rel);
+        if (!existsSync(full)) {
+            mkdirSync(dirname(full), { recursive: true });
+            writeFileSync(full, content, "utf-8");
+        }
+    }
+    // Profile-interview queue Layer 1 — only when the file was just
+    // created in this call. Errors are contained: a seed failure must
+    // not break skeleton materialization (the queue can still be ticked
+    // by Layer 4 on the next sweep). The function itself is a no-op when
+    // the queue file is absent, but the existed-before gate also blocks
+    // a no-op write that would still touch the file's mtime.
+    if (!profileQueueExistedBefore && existsSync(profileQueuePath)) {
+        try {
+            const seedResult = preTickProfileQuestions(contextDir);
+            if (seedResult.examined > 0) {
+                logger.info({ contextDir, ...seedResult }, "profile-interview queue seeded (Layer 1 pre-tick)");
+            }
+        }
+        catch (err) {
+            logger.error({ err, contextDir }, "profile-interview queue Layer 1 pre-tick failed; queue left in unticked state");
+        }
+    }
+    // Heal any validated-path file that lacks frontmatter so subsequent
+    // PATCH writes do not 422. Must run AFTER template seeding so newly
+    // materialized files (already valid) are skipped as no-ops. Errors
+    // are contained — a backfill failure must not fail skeleton seeding.
+    try {
+        const backfill = backfillContextFrontmatter(contextDir);
+        if (backfill.backfilled.length > 0 ||
+            backfill.invalidUnchanged.length > 0 ||
+            backfill.errored.length > 0) {
+            logger.info({
+                contextDir,
+                backfilled: backfill.backfilled,
+                invalidUnchanged: backfill.invalidUnchanged,
+                errored: backfill.errored,
+            }, "context frontmatter backfill completed");
+        }
+    }
+    catch (err) {
+        logger.error({ err, contextDir }, "context frontmatter backfill aborted; skeleton seed still committed");
+    }
+}
+/**
+ * Recursively copy `srcDir` into `destDir`, preserving any destination
+ * files that already exist. Directories are `mkdir -p`ed so the walk
+ * survives a partial target. `README.md` at the top level is skipped —
+ * it documents the templates tree in the repo, not runtime content.
+ */
+export function copyTreePreservingExisting(srcDir, destDir, options = {}, relativeDir = "") {
+    for (const entry of readdirSync(srcDir, { withFileTypes: true })) {
+        const src = join(srcDir, entry.name);
+        const dest = join(destDir, entry.name);
+        const relativePath = relativeDir.length > 0
+            ? `${relativeDir}/${entry.name}`
+            : entry.name;
+        if (entry.name === "README.md")
+            continue;
+        if (options.skipManagementRules
+            && relativePath === CONTEXT_RELATIVE_PATHS.rules.management) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            mkdirSync(dest, { recursive: true });
+            copyTreePreservingExisting(src, dest, options, relativePath);
+        }
+        else if (entry.isFile()) {
+            if (!existsSync(dest)) {
+                mkdirSync(dirname(dest), { recursive: true });
+                copyFileSync(src, dest);
+            }
+        }
+    }
+}
+//# sourceMappingURL=skeleton.js.map

package/dist/core/skeleton.js.map

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

package/dist/core/skill-curation/apply-proposal.d.ts

@@ -0,0 +1,71 @@
+import type Database from "better-sqlite3";
+import { type CurationPayloadValue, type SectionKind } from "@aitne/shared";
+import { OverlayStore } from "./overlay-store.js";
+export interface DiffSummary {
+    additions: number;
+    modifications: number;
+    removals: number;
+    kind: string;
+}
+export type ProposalStatus = "applied" | "auto_reverted" | "conflict" | "smoke_failed" | "diff_caps" | "render_budget";
+/** Common shape — every proposal row starts as one of these regardless
+ *  of which status branch persists it. The chokepoint's gates fan out
+ *  into apply/conflict/failure paths but the row schema is identical. */
+interface ProposalCore {
+    runId: string;
+    skill_slug: string;
+    section_id: string;
+    section_kind: SectionKind;
+    prev_payload: CurationPayloadValue;
+    new_payload: CurationPayloadValue;
+    rendered_md: string;
+    rendererVersion: string;
+    rationale: string;
+    signal_ids: number[];
+    diff: DiffSummary;
+}
+export interface ApplyProposalInput extends ProposalCore {
+    db: Database.Database;
+    overlay: OverlayStore;
+    /** SkillsCompiler cache invalidation hook — fired only on success. */
+    onApplied?: (slug: string, sectionId: string) => void;
+    now?: number;
+}
+export type ApplyOutcome = {
+    ok: true;
+    proposalId: number;
+    status: "applied";
+    overlayPath: string;
+} | {
+    ok: false;
+    proposalId: number;
+    status: "conflict";
+    message: string;
+};
+export declare function applyProposal(input: ApplyProposalInput): ApplyOutcome;
+export interface RecordFailedProposalInput extends ProposalCore {
+    db: Database.Database;
+    status: "smoke_failed" | "diff_caps" | "render_budget";
+    failure_detail: unknown;
+    now?: number;
+}
+export declare function recordFailedProposal(input: RecordFailedProposalInput): number;
+export interface AutoRevertInput {
+    db: Database.Database;
+    overlay: OverlayStore;
+    proposalId: number;
+    /** Same SkillsCompiler cache hook as applyProposal — fires on success. */
+    onApplied?: (slug: string, sectionId: string) => void;
+    now?: number;
+}
+export type AutoRevertOutcome = {
+    ok: true;
+    proposalId: number;
+} | {
+    ok: false;
+    status: "missing" | "wrong_state";
+    message: string;
+};
+export declare function autoRevertProposal(input: AutoRevertInput): AutoRevertOutcome;
+export {};
+//# sourceMappingURL=apply-proposal.d.ts.map

package/dist/core/skill-curation/apply-proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-proposal.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/apply-proposal.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,KAAK,oBAAoB,EAGzB,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAe,MAAM,oBAAoB,CAAC;AAI/D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,eAAe,GACf,UAAU,GACV,cAAc,GACd,WAAW,GACX,eAAe,CAAC;AAEpB;;yEAEyE;AACzE,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,oBAAoB,CAAC;IACnC,WAAW,EAAE,oBAAoB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;CACnB;AAaD,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,sEAAsE;IACtE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAiErE;AAID,MAAM,WAAW,yBAA0B,SAAQ,YAAY;IAC7D,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,cAAc,GAAG,WAAW,GAAG,eAAe,CAAC;IACvD,cAAc,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAU7E;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAYtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CAiD5E"}

package/dist/core/skill-curation/apply-proposal.js

@@ -0,0 +1,175 @@
+// P22 §2.2 + §5.3 — proposal apply hot path + system-driven auto-revert.
+//
+// applyProposal — called inside the `POST /api/skill-curation/proposals`
+// chokepoint after every validation gate (auth, declaration, schema, diff
+// caps, render budget, smoke test) has passed. Inserts the row, writes
+// the overlay JSON, snapshots the prior overlay to history, and emits an
+// audit log entry. The proposal lands in `status='applied'` directly;
+// there is no owner-approval gate. When the current overlay's hash
+// differs from the proposal's `prev_payload` (the optimizer raced
+// against another writer), the row is persisted with `status='conflict'`
+// and no overlay is written.
+//
+// recordFailedProposal — called by the chokepoint when a validation gate
+// (diff caps, byte budget, smoke test) rejects the payload. The row is
+// kept for audit ("why did the optimizer give up on X?") but no overlay
+// is written and signals stay unconsumed so a fresh attempt can retry.
+//
+// autoRevertProposal — called by the §5.3 sweep when a previously-applied
+// proposal accumulates new signals after apply, indicating the change
+// did not "settle" the drift. Restores the prior overlay from the
+// history snapshot, flips the row to `status='auto_reverted'`, and
+// audits as `decided_by='system'`. This is the only roll-back path —
+// the on/off toggle is the operator's only manual handle (§5.2 / §6.2).
+import { existsSync } from "node:fs";
+import { SKILL_CURATION_SCHEMA_VERSION, } from "@aitne/shared";
+import { payloadHash } from "./overlay-store.js";
+export function applyProposal(input) {
+    const now = input.now ?? Date.now();
+    const overlayPath = input.overlay.paths.overlayPath(input.skill_slug, input.section_id);
+    // First-ever overlay: there's no envelope to compare against, so the
+    // optimizer's `prev_payload` (sourced from the seed at proposal time)
+    // is itself the baseline.
+    const current = input.overlay.readPayload(input.skill_slug, input.section_id, input.section_kind);
+    const compareTo = current ?? input.prev_payload;
+    if (payloadHash(compareTo) !== payloadHash(input.prev_payload)) {
+        // Conflict — persist for audit, do not write overlay. Signals stay
+        // unconsumed (caller's responsibility) so the next run can re-attempt
+        // with a fresh `prev_payload`.
+        const proposalId = insertProposalRow(input.db, {
+            ...input,
+            status: "conflict",
+            smoke_passed: true,
+            smoke_failures_json: null,
+            applied_overlay_path: null,
+            decided_by: "auto",
+            now,
+        });
+        insertAuditRow(input.db, "skill_curation_conflict", proposalId, input, now);
+        return {
+            ok: false,
+            proposalId,
+            status: "conflict",
+            message: "current overlay differs from proposal's prev_payload",
+        };
+    }
+    const proposalId = insertProposalRow(input.db, {
+        ...input,
+        status: "applied",
+        smoke_passed: true,
+        smoke_failures_json: null,
+        applied_overlay_path: overlayPath,
+        decided_by: "auto",
+        now,
+    });
+    const envelope = {
+        schema_version: SKILL_CURATION_SCHEMA_VERSION,
+        skill_slug: input.skill_slug,
+        section_id: input.section_id,
+        kind: input.section_kind,
+        payload: input.new_payload,
+        applied_proposal_id: proposalId,
+        applied_at: now,
+    };
+    // OverlayStore.write also snapshots the prior envelope into history/<id>.json
+    // — that snapshot is what auto-revert restores from.
+    input.overlay.write(envelope, proposalId);
+    insertAuditRow(input.db, "skill_curation_applied", proposalId, input, now);
+    if (input.onApplied)
+        input.onApplied(input.skill_slug, input.section_id);
+    return { ok: true, proposalId, status: "applied", overlayPath };
+}
+export function recordFailedProposal(input) {
+    const now = input.now ?? Date.now();
+    return insertProposalRow(input.db, {
+        ...input,
+        smoke_passed: false,
+        smoke_failures_json: JSON.stringify(input.failure_detail),
+        applied_overlay_path: null,
+        decided_by: "auto",
+        now,
+    });
+}
+export function autoRevertProposal(input) {
+    const now = input.now ?? Date.now();
+    const row = input.db
+        .prepare(`SELECT id, run_id, skill_slug, section_id, section_kind, status, diff_kind
+       FROM skill_curation_proposals WHERE id = ?`)
+        .get(input.proposalId);
+    if (!row) {
+        return { ok: false, status: "missing", message: `proposal ${input.proposalId} not found` };
+    }
+    // Only `applied` proposals own an overlay write that can be undone.
+    // auto_reverted rows are already rolled back; conflict / smoke_failed /
+    // diff_caps / render_budget never wrote an overlay.
+    if (row.status !== "applied") {
+        return {
+            ok: false,
+            status: "wrong_state",
+            message: `proposal status=${row.status} cannot be auto-reverted`,
+        };
+    }
+    const histPath = input.overlay.paths.historyPath(row.skill_slug, input.proposalId);
+    if (existsSync(histPath)) {
+        input.overlay.restoreFromHistory(row.skill_slug, row.section_id, input.proposalId);
+    }
+    else {
+        // First-ever overlay for this section — no prior snapshot. Revert
+        // means deleting the overlay so the seed renders again.
+        input.overlay.delete(row.skill_slug, row.section_id);
+    }
+    input.db
+        .prepare(`UPDATE skill_curation_proposals
+       SET status = 'auto_reverted', decided_at = ?, decided_by = 'system'
+       WHERE id = ?`)
+        .run(now, input.proposalId);
+    insertAuditRow(input.db, "skill_curation_auto_reverted", input.proposalId, {
+        runId: row.run_id,
+        skill_slug: row.skill_slug,
+        section_id: row.section_id,
+        section_kind: row.section_kind,
+        diff_kind: row.diff_kind,
+    }, now);
+    if (input.onApplied)
+        input.onApplied(row.skill_slug, row.section_id);
+    return { ok: true, proposalId: input.proposalId };
+}
+// ── private helpers ─────────────────────────────────────────────────────
+function insertProposalRow(db, fields) {
+    const r = db
+        .prepare(`INSERT INTO skill_curation_proposals
+        (run_id, skill_slug, section_id, section_kind, schema_version,
+         renderer_version_at_proposal, prev_payload_json, new_payload_json,
+         rendered_md, diff_additions, diff_modifications, diff_removals,
+         diff_kind, rationale, signals_json, smoke_passed_at,
+         smoke_failures_json, status, proposed_at, decided_at, decided_by,
+         applied_overlay_path)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+        .run(fields.runId, fields.skill_slug, fields.section_id, fields.section_kind, SKILL_CURATION_SCHEMA_VERSION, fields.rendererVersion, JSON.stringify(fields.prev_payload), JSON.stringify(fields.new_payload), fields.rendered_md, fields.diff.additions, fields.diff.modifications, fields.diff.removals, fields.diff.kind, fields.rationale, JSON.stringify(fields.signal_ids), fields.smoke_passed ? fields.now : null, fields.smoke_failures_json, fields.status, fields.now, fields.now, fields.decided_by, fields.applied_overlay_path);
+    return Number(r.lastInsertRowid);
+}
+/** Audit detail accepts either an `ApplyProposalInput` (where diff is a
+ *  full `DiffSummary`) or an explicit `AuditDetail` (autoRevert has only
+ *  the row's diff_kind, no live diff). The body is the same JSON shape. */
+function insertAuditRow(db, action_type, proposalId, source, now) {
+    const detail = "diff" in source
+        ? {
+            runId: source.runId,
+            skill_slug: source.skill_slug,
+            section_id: source.section_id,
+            section_kind: source.section_kind,
+            diff_kind: source.diff.kind,
+        }
+        : source;
+    const ts = Math.floor(now / 1000);
+    db.prepare(`INSERT INTO agent_actions (action_type, result, started_at, completed_at, detail)
+     VALUES (?, 'success', datetime(?, 'unixepoch'), datetime(?, 'unixepoch'), ?)`).run(action_type, ts, ts, JSON.stringify({
+        proposal_id: proposalId,
+        skill_slug: detail.skill_slug,
+        section_id: detail.section_id,
+        kind: detail.section_kind,
+        diff_kind: detail.diff_kind,
+        run_id: detail.runId,
+    }));
+}
+//# sourceMappingURL=apply-proposal.js.map

package/dist/core/skill-curation/apply-proposal.js.map

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

package/dist/core/skill-curation/auto-revert.d.ts

@@ -0,0 +1,43 @@
+import type Database from "better-sqlite3";
+import { autoRevertProposal } from "./apply-proposal.js";
+import type { OverlayStore } from "./overlay-store.js";
+export interface AutoRevertSweepOptions {
+    now?: number;
+    regressionWindowMs?: number;
+    regressionThresholdWeight?: number;
+    freezeCycles?: number;
+    /** Test seam — defaults to live autoRevertProposal. */
+    revertProposalImpl?: typeof autoRevertProposal;
+}
+export interface AutoRevertOutcome {
+    reverted: number;
+    proposals_inspected: number;
+    newly_frozen: {
+        slug: string;
+        section_id: string;
+    }[];
+}
+/** Read the current frozen entries set as a flat `<slug>:<section_id>` set,
+ *  the form expected by the smoke-test `frozen_sections_unchanged` check. */
+export declare function readFrozenSet(db: Database.Database): Set<string>;
+/** Decrement every entry's `cycles_remaining`, drop entries reaching 0.
+ *  Call once per cadence cycle BEFORE spawning the optimizer (so a section
+ *  that was frozen 2 cycles ago becomes eligible again on the third). */
+export declare function tickFrozenCycles(db: Database.Database): {
+    unfrozen: {
+        slug: string;
+        section_id: string;
+    }[];
+};
+/** Add (or refresh) a freeze entry. Idempotent; if the same key already
+ *  exists, its countdown is reset to `freezeCycles`. */
+export declare function freezeSection(db: Database.Database, slug: string, section_id: string, reason: string, options?: {
+    freezeCycles?: number;
+    now?: number;
+    proposal_id?: number;
+}): void;
+/** Detect regressed proposals + auto-revert + freeze. Idempotent — every
+ *  proposal that has already been reverted is skipped on subsequent calls
+ *  because its status flips to `reverted`. */
+export declare function autoRevertSweep(db: Database.Database, overlay: OverlayStore, options?: AutoRevertSweepOptions): AutoRevertOutcome;
+//# sourceMappingURL=auto-revert.d.ts.map

package/dist/core/skill-curation/auto-revert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-revert.d.ts","sourceRoot":"","sources":["../../../src/core/skill-curation/auto-revert.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAwBvD,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD;AAWD;6EAC6E;AAC7E,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAIhE;AAED;;yEAEyE;AACzE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IACvD,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClD,CAgBA;AAED;wDACwD;AACxD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,IAAI,CAcN;AAED;;8CAE8C;AAC9C,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,sBAA2B,GACnC,iBAAiB,CAyDnB"}