@aitne/daemon 0.1.0

package/dist/core/recurrence.js

@@ -0,0 +1,162 @@
+/**
+ * Recurrence calculation — pure functions for computing next occurrence
+ * from a recurrence rule and a reference date.
+ *
+ * All internal computation uses the configured timezone so that "09:00 daily"
+ * always fires at 09:00 local, even across DST transitions.
+ */
+import { nowInTimezone } from "@aitne/shared";
+// ── Helpers ──────────────────────────────────────────────────────────
+/**
+ * Resolve a RecurrenceRule's timezone, falling back to OS timezone.
+ * The API layer fills timezone before storing, but this is a safety net
+ * for any code path that calls computeNextOccurrence directly.
+ */
+function resolveRuleTimezone(rule) {
+    return rule.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+/**
+ * Get timezone offset in ms (positive = east of UTC) for a given instant.
+ * Uses toLocaleString comparison which handles DST correctly.
+ */
+function getTimezoneOffsetMs(timezone, date) {
+    const utcStr = date.toLocaleString("en-US", { timeZone: "UTC" });
+    const localStr = date.toLocaleString("en-US", { timeZone: timezone });
+    return new Date(localStr).getTime() - new Date(utcStr).getTime();
+}
+/** Build a UTC Date from local date components + timezone. */
+function localToUtc(timezone, year, month, day, hours, minutes) {
+    // Build a "fake UTC" date with the local components, then subtract the
+    // timezone offset at that instant to get the real UTC timestamp.
+    const fakeUtc = new Date(Date.UTC(year, month - 1, day, hours, minutes, 0, 0));
+    const offset = getTimezoneOffsetMs(timezone, fakeUtc);
+    const result = new Date(fakeUtc.getTime() - offset);
+    // DST edge: the offset might differ at the real UTC time — recompute once
+    const offset2 = getTimezoneOffsetMs(timezone, result);
+    /* v8 ignore next 3 — DST spring-forward/fall-back edge; extremely rare and timezone-specific */
+    if (offset !== offset2) {
+        return new Date(fakeUtc.getTime() - offset2);
+    }
+    return result;
+}
+/** Last day of a given month (1-indexed). */
+function lastDayOfMonth(year, month) {
+    return new Date(year, month, 0).getDate();
+}
+function parseTime(time) {
+    const [h, m] = time.split(":").map(Number);
+    return { hours: h, minutes: m };
+}
+/** Advance a local date by N days, returning { year, month, day }. */
+function addDays(year, month, day, n) {
+    const d = new Date(Date.UTC(year, month - 1, day + n));
+    return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate() };
+}
+// ── Core calculation ─────────────────────────────────────────────────
+/**
+ * Compute the next occurrence of a recurring schedule after `referenceUtc`.
+ *
+ * Returns a UTC Date, or null if no valid occurrence can be computed
+ * (e.g. malformed rule).
+ *
+ * @param rule       The recurrence rule (timezone resolved internally if missing)
+ * @param referenceUtc  The reference point. Next occurrence is strictly after this instant.
+ */
+export function computeNextOccurrence(rule, referenceUtc) {
+    const timezone = resolveRuleTimezone(rule);
+    const { hours, minutes } = parseTime(rule.time);
+    const local = nowInTimezone(timezone, referenceUtc);
+    switch (rule.frequency) {
+        case "daily":
+            return computeNextDaily(timezone, local, hours, minutes, referenceUtc);
+        case "weekly":
+            return computeNextWeekly(timezone, local, hours, minutes, referenceUtc, rule.daysOfWeek ?? []);
+        case "monthly":
+            return computeNextMonthly(timezone, local, hours, minutes, referenceUtc, rule.daysOfMonth ?? []);
+        /* v8 ignore next 2 — TypeScript closed union: all RecurrenceRule frequencies are handled above */
+        default:
+            return null;
+    }
+}
+function computeNextDaily(timezone, local, hours, minutes, referenceUtc) {
+    // Try today
+    const candidate = localToUtc(timezone, local.year, local.month, local.day, hours, minutes);
+    if (candidate.getTime() > referenceUtc.getTime()) {
+        return candidate;
+    }
+    // Tomorrow
+    const tmr = addDays(local.year, local.month, local.day, 1);
+    return localToUtc(timezone, tmr.year, tmr.month, tmr.day, hours, minutes);
+}
+function computeNextWeekly(timezone, local, hours, minutes, referenceUtc, daysOfWeek) {
+    if (daysOfWeek.length === 0)
+        return null;
+    const sorted = [...new Set(daysOfWeek)].sort((a, b) => a - b);
+    for (let offset = 0; offset <= 7; offset++) {
+        const d = addDays(local.year, local.month, local.day, offset);
+        const candidate = localToUtc(timezone, d.year, d.month, d.day, hours, minutes);
+        // Determine day-of-week in the target timezone at the candidate time
+        const candidateLocal = nowInTimezone(timezone, candidate);
+        if (!sorted.includes(candidateLocal.dayOfWeek))
+            continue;
+        if (candidate.getTime() > referenceUtc.getTime()) {
+            return candidate;
+        }
+        /* c8 ignore start — 8-day window guarantees a match before loop exhaustion */
+    }
+    // 8-day window always contains every weekday, so a non-empty `sorted`
+    // guarantees a match before the loop completes.
+    return null;
+}
+/* c8 ignore stop */
+function computeNextMonthly(timezone, local, hours, minutes, referenceUtc, daysOfMonth) {
+    if (daysOfMonth.length === 0)
+        return null;
+    const sorted = [...new Set(daysOfMonth)].sort((a, b) => a - b);
+    let year = local.year;
+    let month = local.month;
+    for (let i = 0; i < 13; i++) {
+        const lastDay = lastDayOfMonth(year, month);
+        for (const targetDay of sorted) {
+            const clampedDay = Math.min(targetDay, lastDay);
+            const candidate = localToUtc(timezone, year, month, clampedDay, hours, minutes);
+            if (candidate.getTime() > referenceUtc.getTime()) {
+                return candidate;
+            }
+        }
+        month++;
+        if (month > 12) {
+            month = 1;
+            year++;
+        }
+        /* c8 ignore start — 13-month window guarantees a match before loop exhaustion */
+    }
+    // 13-month window always finds a `targetDay > now` for any non-empty
+    // `sorted`, so the loop never falls through.
+    return null;
+}
+/* c8 ignore stop */
+/**
+ * Format a recurrence rule as a human-readable summary.
+ */
+export function formatRecurrenceLabel(rule) {
+    const dayNames = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+    switch (rule.frequency) {
+        case "daily":
+            return `Daily at ${rule.time}`;
+        case "weekly": {
+            const days = (rule.daysOfWeek ?? [])
+                .sort((a, b) => a - b)
+                .map((d) => dayNames[d])
+                .join(", ");
+            return `Weekly on ${days} at ${rule.time}`;
+        }
+        case "monthly": {
+            const days = (rule.daysOfMonth ?? []).sort((a, b) => a - b).join(", ");
+            return `Monthly on day ${days} at ${rule.time}`;
+        }
+        default:
+            return `${rule.frequency} at ${rule.time}`;
+    }
+}
+//# sourceMappingURL=recurrence.js.map

package/dist/core/recurrence.js.map

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

package/dist/core/reinstall.d.ts

@@ -0,0 +1,107 @@
+import type Database from "better-sqlite3";
+/**
+ * B-007 §7 — clean reinstall (no migration).
+ *
+ * Two-phase operation:
+ *   1. `planReinstall` — pure enumeration of what WILL be touched. Safe to
+ *      surface in a dashboard confirmation screen. No side effects.
+ *   2. `executeReinstall` — performs the destructive operation. Always
+ *      called AFTER explicit user confirmation (see §7.2 Phase A) and a
+ *      CLI / dashboard guard that requires the literal string "CLEAN".
+ *
+ * Keep: OS keychain secrets, cache/, .env, google-credentials.json,
+ * google-token.json. Wipe: context/ and md_file_snapshots rows. Other
+ * SQLite tables (conversation_sessions, messages, agent_actions, etc.)
+ * are preserved — see §7.1.
+ */
+export interface ReinstallPlan {
+    contextDir: string;
+    /** Absolute paths of all files that will be deleted from context/. */
+    filesToDelete: string[];
+    /** Total size in bytes of files that will be deleted. */
+    totalBytes: number;
+    /** Number of rows in md_file_snapshots that will be deleted. */
+    snapshotRowCount: number;
+    /** Target path for the tarball safety backup. */
+    backupPath: string;
+    /**
+     * Ancillary runtime caches that the spec §7.1 says to wipe alongside
+     * context/ — `prompts/` (rendered system-prompt cache, regenerable) and
+     * `agent-sessions/` (per-session workdirs pinned to the old layout).
+     * Absent entries are skipped at execute time.
+     */
+    ancillaryDirs: string[];
+}
+export interface ReinstallResult {
+    backupPath: string | null;
+    filesDeleted: number;
+    bytesDeleted: number;
+    snapshotRowsDeleted: number;
+    ancillaryDirsRemoved: string[];
+}
+export interface SpawnTarArgs {
+    source: string;
+    target: string;
+    parent: string;
+    leaf: string;
+}
+export interface SpawnTarResult {
+    status: number | null;
+}
+export interface ReinstallDeps {
+    contextDir: string;
+    db: Database.Database;
+    /** Directory where the tarball backup is written. Defaults to a sibling of contextDir. */
+    backupDir?: string;
+    /**
+     * Ancillary caches under the data dir to wipe alongside context/. Spec
+     * §7.1 lists `prompts/` and `agent-sessions/`. Defaults to those two
+     * resolved relative to contextDir's parent.
+     */
+    ancillaryDirs?: string[];
+    /** Provides the current timestamp (override for determinism in tests). */
+    now?: () => Date;
+    /**
+     * Override for the tar invocation. Production uses `spawnSync("tar", ...)`;
+     * tests swap in a stub that writes the target file and returns status 0,
+     * or returns non-zero to exercise the failure branch.
+     */
+    spawnTar?: (args: SpawnTarArgs) => SpawnTarResult;
+}
+/**
+ * Enumerate, without side effects, everything a clean reinstall would remove.
+ */
+export declare function planReinstall(deps: ReinstallDeps): ReinstallPlan;
+/**
+ * Execute a clean reinstall. Must be called after explicit user
+ * confirmation (§7.2 Phase A). Writes a tarball backup first, then wipes
+ * context/ and md_file_snapshots rows. Safe to call even when context/
+ * does not exist; the tarball step is skipped.
+ */
+export declare function executeReinstall(deps: ReinstallDeps): Promise<ReinstallResult>;
+/**
+ * Recursively enumerate files under contextDir with accumulated byte size.
+ * Pure helper exported for unit testing the planner without touching a DB.
+ */
+export declare function enumerateContextFiles(contextDir: string): {
+    filesToDelete: string[];
+    totalBytes: number;
+};
+export declare function countSnapshotRows(db: Database.Database): number;
+/**
+ * Default backup directory: sibling of contextDir named `backup/`.
+ * Example: contextDir = `~/.personal-agent/context` → `~/.personal-agent/backup`.
+ */
+export declare function defaultBackupDir(contextDir: string): string;
+/**
+ * Default ancillary caches to wipe alongside context/. Spec §7.1 lists
+ * `prompts/` (regenerable rendered prompts) and `agent-sessions/` (session
+ * workdirs bound to the old vault layout). Resolved as siblings of contextDir.
+ */
+export declare function defaultAncillaryDirs(contextDir: string): string[];
+/**
+ * Construct the tarball backup target path.
+ * Format: `<backupDir>/context-pre-reinstall-<ISO-no-colons>.tar.gz`.
+ */
+export declare function backupTargetPath(backupDir: string, now: Date): string;
+//# sourceMappingURL=reinstall.d.ts.map

package/dist/core/reinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reinstall.d.ts","sourceRoot":"","sources":["../../src/core/reinstall.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,cAAc,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAkBhE;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAoDpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;IACzD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAuBA;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAS/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAGjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAGrE"}

package/dist/core/reinstall.js

@@ -0,0 +1,163 @@
+import { existsSync, mkdirSync, readdirSync, rmSync, statSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { createLogger } from "../logging.js";
+const logger = createLogger("reinstall");
+/**
+ * Enumerate, without side effects, everything a clean reinstall would remove.
+ */
+export function planReinstall(deps) {
+    const { contextDir, db } = deps;
+    const now = deps.now?.() ?? new Date();
+    const { filesToDelete, totalBytes } = enumerateContextFiles(contextDir);
+    const snapshotRowCount = countSnapshotRows(db);
+    const backupPath = backupTargetPath(deps.backupDir ?? defaultBackupDir(contextDir), now);
+    const ancillaryDirs = deps.ancillaryDirs ?? defaultAncillaryDirs(contextDir);
+    return {
+        contextDir,
+        filesToDelete,
+        totalBytes,
+        snapshotRowCount,
+        backupPath,
+        ancillaryDirs,
+    };
+}
+/**
+ * Execute a clean reinstall. Must be called after explicit user
+ * confirmation (§7.2 Phase A). Writes a tarball backup first, then wipes
+ * context/ and md_file_snapshots rows. Safe to call even when context/
+ * does not exist; the tarball step is skipped.
+ */
+export async function executeReinstall(deps) {
+    const plan = planReinstall(deps);
+    let backupPath = null;
+    if (existsSync(plan.contextDir) && plan.filesToDelete.length > 0) {
+        try {
+            await createTarballBackup(plan.contextDir, plan.backupPath, deps.spawnTar);
+            backupPath = plan.backupPath;
+            logger.info({ backupPath }, "Context tarball backup created");
+        }
+        catch (err) {
+            logger.error({ err }, "Backup failed — aborting reinstall");
+            throw err;
+        }
+    }
+    const bytesDeleted = plan.totalBytes;
+    const filesDeleted = plan.filesToDelete.length;
+    if (existsSync(plan.contextDir)) {
+        rmSync(plan.contextDir, { recursive: true, force: true });
+        logger.info({ contextDir: plan.contextDir }, "context/ wiped");
+    }
+    const snapshotResult = deps.db
+        .prepare("DELETE FROM md_file_snapshots")
+        .run();
+    const snapshotRowsDeleted = snapshotResult.changes;
+    logger.info({ snapshotRowsDeleted }, "md_file_snapshots rows deleted");
+    // Spec §7.1 — wipe ancillary caches so the next daemon boot cannot load a
+    // stale `prompts/` rendering or session workdir that still references the
+    // old vault layout. Missing directories are skipped silently.
+    const ancillaryDirsRemoved = [];
+    for (const dir of plan.ancillaryDirs) {
+        if (existsSync(dir)) {
+            rmSync(dir, { recursive: true, force: true });
+            ancillaryDirsRemoved.push(dir);
+            logger.info({ dir }, "Ancillary cache wiped");
+        }
+    }
+    return {
+        backupPath,
+        filesDeleted,
+        bytesDeleted,
+        snapshotRowsDeleted,
+        ancillaryDirsRemoved,
+    };
+}
+/**
+ * Recursively enumerate files under contextDir with accumulated byte size.
+ * Pure helper exported for unit testing the planner without touching a DB.
+ */
+export function enumerateContextFiles(contextDir) {
+    if (!existsSync(contextDir)) {
+        return { filesToDelete: [], totalBytes: 0 };
+    }
+    const files = [];
+    let totalBytes = 0;
+    const walk = (dir) => {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+            }
+            else if (entry.isFile()) {
+                files.push(full);
+                totalBytes += statSync(full).size;
+            }
+        }
+    };
+    walk(contextDir);
+    return { filesToDelete: files, totalBytes };
+}
+export function countSnapshotRows(db) {
+    try {
+        const row = db
+            .prepare("SELECT COUNT(*) as n FROM md_file_snapshots")
+            .get();
+        return row.n;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Default backup directory: sibling of contextDir named `backup/`.
+ * Example: contextDir = `~/.personal-agent/context` → `~/.personal-agent/backup`.
+ */
+export function defaultBackupDir(contextDir) {
+    return join(dirname(contextDir), "backup");
+}
+/**
+ * Default ancillary caches to wipe alongside context/. Spec §7.1 lists
+ * `prompts/` (regenerable rendered prompts) and `agent-sessions/` (session
+ * workdirs bound to the old vault layout). Resolved as siblings of contextDir.
+ */
+export function defaultAncillaryDirs(contextDir) {
+    const parent = dirname(contextDir);
+    return [join(parent, "prompts"), join(parent, "agent-sessions")];
+}
+/**
+ * Construct the tarball backup target path.
+ * Format: `<backupDir>/context-pre-reinstall-<ISO-no-colons>.tar.gz`.
+ */
+export function backupTargetPath(backupDir, now) {
+    const iso = now.toISOString().replace(/[:.]/g, "-");
+    return join(backupDir, `context-pre-reinstall-${iso}.tar.gz`);
+}
+/**
+ * Create a gzip-compressed tarball of contextDir at backupPath. Uses the
+ * system `tar` CLI (POSIX + macOS + Linux) to avoid a js-only tar dep.
+ * Throws when tar exits non-zero. Overridable via `spawnTar` for tests.
+ */
+async function createTarballBackup(contextDir, backupPath, spawnTar) {
+    mkdirSync(dirname(backupPath), { recursive: true });
+    // `tar -czf` reads files and writes a compressed archive.
+    // -C parent so the archive contains just the leaf directory name rather
+    // than the full absolute path.
+    const parent = dirname(contextDir);
+    const leaf = contextDir.slice(parent.length + 1);
+    const runner = spawnTar ?? defaultSpawnTar;
+    const result = runner({
+        source: contextDir,
+        target: backupPath,
+        parent,
+        leaf,
+    });
+    if (result.status !== 0) {
+        throw new Error(`tar exited with status ${result.status} while writing ${backupPath}`);
+    }
+}
+function defaultSpawnTar(args) {
+    const result = spawnSync("tar", ["-czf", args.target, "-C", args.parent, args.leaf], { stdio: "ignore" });
+    return { status: result.status };
+}
+//# sourceMappingURL=reinstall.js.map

package/dist/core/reinstall.js.map

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

package/dist/core/release-assets.d.ts

@@ -0,0 +1,106 @@
+import type Database from "better-sqlite3";
+import { type PendingTemplateUpgrade } from "./template-versions.js";
+export declare const RELEASE_ASSETS_STATUS_KEY = "release_assets.status";
+export declare const RELEASE_ASSETS_DOCS_SNAPSHOT_KEY = "release_assets.docs_snapshot";
+export declare const RELEASE_ASSETS_TEMPLATES_SNAPSHOT_KEY = "release_assets.templates_snapshot";
+export declare const INSTRUCTION_ASSETS_STAMP = ".aitne-instruction-assets.json";
+export interface AssetFileSnapshot {
+    sourceSha256: string;
+    targetSha256: string;
+    version?: number;
+}
+export interface AssetSnapshotRecord {
+    checkedAt: string;
+    sourceRoot: string;
+    targetRoot: string;
+    files: Record<string, AssetFileSnapshot>;
+}
+export interface AssetConflict {
+    path: string;
+    reason: "user_modified" | "unknown_base" | "write_failed";
+    detail?: string;
+    from?: number;
+    to?: number;
+}
+export interface DocsAssetStatus {
+    checkedAt: string;
+    sourceRoot: string;
+    targetRoot: string;
+    added: number;
+    autoUpdated: number;
+    unchanged: number;
+    conflicts: AssetConflict[];
+    removedFromSource: string[];
+    errors: AssetConflict[];
+    backupRoot: string | null;
+}
+export interface TemplateAssetStatus {
+    checkedAt: string;
+    sourceRoot: string | null;
+    targetRoot: string;
+    added: number;
+    autoUpdated: number;
+    unchanged: number;
+    pending: PendingTemplateUpgrade[];
+    conflicts: AssetConflict[];
+    errors: AssetConflict[];
+    backupRoot: string | null;
+}
+export interface InstructionAssetStatus {
+    checkedAt: string;
+    fingerprint: string;
+    files: number;
+    bytes: number;
+}
+export interface SkillAssetStatus {
+    checkedAt: string;
+    builtinShadowedUserSkills: string[];
+}
+export interface ReleaseAssetStatusRecord {
+    checkedAt: string;
+    docs?: DocsAssetStatus;
+    templates?: TemplateAssetStatus;
+    instructionAssets?: InstructionAssetStatus;
+    skills?: SkillAssetStatus;
+}
+export interface ReconcileDocsOptions {
+    db: Database.Database;
+    sourceDir: string;
+    targetDir: string;
+    backupRoot?: string | null;
+    now?: () => Date;
+}
+export interface ReconcileTemplateOptions {
+    db: Database.Database;
+    templatesRoot: string | null;
+    contextDir: string;
+    backupRoot?: string | null;
+    now?: () => Date;
+}
+export declare function sha256File(absPath: string): string;
+export declare function readReleaseAssetStatus(db: Database.Database): ReleaseAssetStatusRecord | null;
+/**
+ * Reconcile the operator-facing docs corpus (`docs/user`) against the
+ * bundled seed corpus. Files that still match the previous shipped hash
+ * are refreshed automatically; files with user edits are preserved and
+ * reported as conflicts for manual review.
+ */
+export declare function reconcileDocsCorpus(options: ReconcileDocsOptions): DocsAssetStatus;
+/**
+ * Reconcile versioned context templates. Existing user-edited files are never
+ * overwritten. A file is auto-updated only when it still matches the hash we
+ * recorded for the previous shipped template version.
+ */
+export declare function reconcileTemplateAssets(options: ReconcileTemplateOptions): TemplateAssetStatus;
+export declare function computeInstructionAssetStatus(workspaceDir: string, now?: () => Date): InstructionAssetStatus;
+export declare function recordInstructionAssetStatus(db: Database.Database, workspaceDir: string, now?: () => Date): InstructionAssetStatus;
+export declare function readInstructionAssetStamp(sessionDir: string): string | null;
+export declare function writeInstructionAssetStamp(sessionDir: string, status: InstructionAssetStatus): void;
+export declare function sessionInstructionAssetsStale(sessionDir: string, workspaceDir: string): boolean;
+export declare function findBuiltinShadowedUserSkills(dataDir: string, workspaceDir: string): string[];
+export declare function recordSkillAssetStatus(db: Database.Database, dataDir: string, workspaceDir: string, now?: () => Date): SkillAssetStatus;
+export declare function sourceFileStats(root: string): {
+    files: number;
+    bytes: number;
+};
+//# sourceMappingURL=release-assets.d.ts.map

package/dist/core/release-assets.d.ts.map

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