@cleocode/core 2026.5.131 → 2026.5.133

package/dist/db/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `@cleocode/core/db` subpath export — typed dual-scope SQLite client.
+ *
+ * This barrel re-exports the public API of the dual-scope DB chokepoint
+ * implemented in `packages/core/src/store/dual-scope-db.ts` as the
+ * `@cleocode/core/db` subpath module.
+ *
+ * ## What is exported
+ *
+ * - {@link openDualScopeDb} — open (or re-use) the consolidated `cleo.db`
+ *   for either scope.
+ * - {@link DualScopeDbHandle} — handle type returned by `openDualScopeDb`.
+ * - {@link DualScope} — the `'project' | 'global'` scope union.
+ * - {@link CleoProjectDb} — typed Drizzle handle for the project scope.
+ * - {@link CleoGlobalDb} — typed Drizzle handle for the global scope.
+ * - {@link resolveDualScopeDbPath} — resolve the absolute DB file path.
+ * - {@link insertIdempotent} — retry-safe insert (ON CONFLICT DO NOTHING).
+ * - {@link upsertIdempotent} — retry-safe upsert (ON CONFLICT DO UPDATE).
+ * - {@link _resetDualScopeDbCache} — test helper: clear singleton cache.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { openDualScopeDb, insertIdempotent } from '@cleocode/core/db';
+ *
+ * const proj = await openDualScopeDb('project', process.cwd());
+ * const global = await openDualScopeDb('global');
+ * ```
+ *
+ * @packageDocumentation
+ * @task T11514 (E4-T3)
+ * @epic T11247 (E4)
+ * @saga T11242 (SG-DB-SUBSTRATE-V2)
+ */
+export { _resetDualScopeDbCache, type CleoGlobalDb, type CleoProjectDb, type DualScope, type DualScopeDbHandle, insertIdempotent, openDualScopeDb, resolveDualScopeDbPath, upsertIdempotent, } from '../store/dual-scope-db.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/db/index.js

@@ -0,0 +1,36 @@
+/**
+ * `@cleocode/core/db` subpath export — typed dual-scope SQLite client.
+ *
+ * This barrel re-exports the public API of the dual-scope DB chokepoint
+ * implemented in `packages/core/src/store/dual-scope-db.ts` as the
+ * `@cleocode/core/db` subpath module.
+ *
+ * ## What is exported
+ *
+ * - {@link openDualScopeDb} — open (or re-use) the consolidated `cleo.db`
+ *   for either scope.
+ * - {@link DualScopeDbHandle} — handle type returned by `openDualScopeDb`.
+ * - {@link DualScope} — the `'project' | 'global'` scope union.
+ * - {@link CleoProjectDb} — typed Drizzle handle for the project scope.
+ * - {@link CleoGlobalDb} — typed Drizzle handle for the global scope.
+ * - {@link resolveDualScopeDbPath} — resolve the absolute DB file path.
+ * - {@link insertIdempotent} — retry-safe insert (ON CONFLICT DO NOTHING).
+ * - {@link upsertIdempotent} — retry-safe upsert (ON CONFLICT DO UPDATE).
+ * - {@link _resetDualScopeDbCache} — test helper: clear singleton cache.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { openDualScopeDb, insertIdempotent } from '@cleocode/core/db';
+ *
+ * const proj = await openDualScopeDb('project', process.cwd());
+ * const global = await openDualScopeDb('global');
+ * ```
+ *
+ * @packageDocumentation
+ * @task T11514 (E4-T3)
+ * @epic T11247 (E4)
+ * @saga T11242 (SG-DB-SUBSTRATE-V2)
+ */
+export { _resetDualScopeDbCache, insertIdempotent, openDualScopeDb, resolveDualScopeDbPath, upsertIdempotent, } from '../store/dual-scope-db.js';
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,sBAAsB,EAKtB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/gc/daemon.d.ts

@@ -8,13 +8,21 @@
  * - Crash recovery via `.cleo/gc-state.json` startup-check
  * - node-cron v4 for scheduling (zero runtime deps, cross-platform)
  *
- * Startup algorithm (systemd `Persistent=true` semantics in pure Node.js):
- * 1. Read gc-state.json
- * 2. If pendingPrune non-empty → resume deletion (crash recovery)
- * 3. If lastRunAt null OR elapsed > 24h → run GC immediately (missed-run recovery)
- * 4. Schedule future runs via node-cron (daily at 03:00 UTC)
- * 5. Write daemonPid to state
+ * R5 migration (T11256)
+ * ----------------------
+ * The standalone cron loop that previously lived inside `bootstrapDaemon` has
+ * been migrated to the `@cleocode/runtime` subsystem framework
+ * (`gc-subsystem.ts`). `bootstrapDaemon` now delegates to
+ * `createGcSubsystem(cleoDir).start()` so the same startup algorithm (crash
+ * recovery → missed-run recovery → cron schedule) is expressed once, in the
+ * `Subsystem<GcSubsystemContext>` shape, and the standalone entry-point
+ * (`daemon-entry.ts`) drives it through the uniform lifecycle.
  *
+ * The spawn helpers (`spawnGCDaemon`, `stopGCDaemon`, `getGCDaemonStatus`) are
+ * preserved unchanged — they are the parent-process-side interface and are
+ * unaffected by the internal lifecycle migration.
+ *
+ * @see packages/core/src/gc/gc-subsystem.ts — subsystem adapter (R5-T1)
  * @see ADR-047 — Autonomous GC and Disk Safety
  * @see T751 §2.2 for sidecar daemon pattern rationale
  * @task T731
@@ -23,8 +31,9 @@
 /**
  * Bootstrap the GC daemon process.
  *
- * Performs crash recovery, missed-run recovery, and schedules future GC runs.
- * This function runs in the long-lived daemon process.
+ * Delegates to `createGcSubsystem(cleoDir).start()` which performs crash
+ * recovery, missed-run recovery, and schedules future GC runs — the
+ * standalone cron loop no longer lives here (R5 migration, T11256).
  *
  * @param cleoDir - Absolute path to the `.cleo/` directory
  */

package/dist/gc/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/gc/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA0BH;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DpE;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCpE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCnE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC,CAsBD"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/gc/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAeH;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCpE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCnE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC,CAsBD"}

package/dist/gc/daemon.js

@@ -8,13 +8,21 @@
  * - Crash recovery via `.cleo/gc-state.json` startup-check
  * - node-cron v4 for scheduling (zero runtime deps, cross-platform)
  *
- * Startup algorithm (systemd `Persistent=true` semantics in pure Node.js):
- * 1. Read gc-state.json
- * 2. If pendingPrune non-empty → resume deletion (crash recovery)
- * 3. If lastRunAt null OR elapsed > 24h → run GC immediately (missed-run recovery)
- * 4. Schedule future runs via node-cron (daily at 03:00 UTC)
- * 5. Write daemonPid to state
+ * R5 migration (T11256)
+ * ----------------------
+ * The standalone cron loop that previously lived inside `bootstrapDaemon` has
+ * been migrated to the `@cleocode/runtime` subsystem framework
+ * (`gc-subsystem.ts`). `bootstrapDaemon` now delegates to
+ * `createGcSubsystem(cleoDir).start()` so the same startup algorithm (crash
+ * recovery → missed-run recovery → cron schedule) is expressed once, in the
+ * `Subsystem<GcSubsystemContext>` shape, and the standalone entry-point
+ * (`daemon-entry.ts`) drives it through the uniform lifecycle.
  *
+ * The spawn helpers (`spawnGCDaemon`, `stopGCDaemon`, `getGCDaemonStatus`) are
+ * preserved unchanged — they are the parent-process-side interface and are
+ * unaffected by the internal lifecycle migration.
+ *
+ * @see packages/core/src/gc/gc-subsystem.ts — subsystem adapter (R5-T1)
  * @see ADR-047 — Autonomous GC and Disk Safety
  * @see T751 §2.2 for sidecar daemon pattern rationale
  * @task T731
@@ -26,78 +34,27 @@ import { createWriteStream } from 'node:fs';
 import { mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import cron from 'node-cron';
-import { runGC } from './runner.js';
+import { createGcSubsystem } from './gc-subsystem.js';
 import { patchGCState, readGCState } from './state.js';
 // ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** Cron expression: daily at 03:00 UTC. */
-const GC_CRON_EXPR = '0 3 * * *';
-/** Interval for missed-run recovery check (24 hours in ms). */
-const GC_INTERVAL_MS = 24 * 60 * 60 * 1000;
-// ---------------------------------------------------------------------------
 // Daemon Bootstrap (runs when this module is executed as a standalone script)
 // ---------------------------------------------------------------------------
 /**
  * Bootstrap the GC daemon process.
  *
- * Performs crash recovery, missed-run recovery, and schedules future GC runs.
- * This function runs in the long-lived daemon process.
+ * Delegates to `createGcSubsystem(cleoDir).start()` which performs crash
+ * recovery, missed-run recovery, and schedules future GC runs — the
+ * standalone cron loop no longer lives here (R5 migration, T11256).
  *
  * @param cleoDir - Absolute path to the `.cleo/` directory
  */
 export async function bootstrapDaemon(cleoDir) {
-    const statePath = join(cleoDir, 'gc-state.json');
-    // Register daemon PID in state file
-    await patchGCState(statePath, {
-        daemonPid: process.pid,
-        daemonStartedAt: new Date().toISOString(),
-    });
-    const state = await readGCState(statePath);
-    // Step 1: Crash recovery — resume pending prune from prior run
-    if (state.pendingPrune && state.pendingPrune.length > 0) {
-        try {
-            await runGC({ cleoDir, resumeFrom: state.pendingPrune });
-        }
-        catch {
-            // Crash recovery failure is non-fatal; continue with scheduled runs
-        }
-    }
-    // Step 2: Missed-run recovery — if last run was > 24h ago, run immediately
-    const lastRunTs = state.lastRunAt ? new Date(state.lastRunAt).getTime() : 0;
-    const elapsed = Date.now() - lastRunTs;
-    if (elapsed > GC_INTERVAL_MS) {
-        try {
-            await runGC({ cleoDir });
-        }
-        catch {
-            // Immediate GC failure is non-fatal; cron will retry next cycle
-        }
-    }
-    // Step 3: Schedule future runs via node-cron
-    // noOverlap: true prevents double-runs if a previous run exceeds 24h
-    cron.schedule(GC_CRON_EXPR, async () => {
-        try {
-            await runGC({ cleoDir });
-        }
-        catch {
-            // Log failures via stderr (already redirected to gc.log by spawn)
-            const state2 = await readGCState(statePath);
-            await patchGCState(statePath, {
-                consecutiveFailures: state2.consecutiveFailures + 1,
-                lastRunResult: 'failed',
-                escalationNeeded: state2.consecutiveFailures + 1 >= 3,
-                escalationReason: state2.consecutiveFailures + 1 >= 3
-                    ? `GC daemon: ${state2.consecutiveFailures + 1} consecutive failures. Check logs.`
-                    : state2.escalationReason,
-            });
-        }
-    }, {
-        timezone: 'UTC',
-        noOverlap: true,
-        name: 'cleo-gc',
-    });
+    const subsystem = createGcSubsystem(cleoDir);
+    // start() handles crash recovery, missed-run recovery, and cron scheduling.
+    // The returned context (cron task handle) keeps the cron alive for the
+    // lifetime of this process — we intentionally do not call shutdown() so the
+    // daemon continues running until the process receives SIGTERM.
+    await subsystem.start();
 }
 // ---------------------------------------------------------------------------
 // Spawn Helpers (called by `cleo daemon start` in the parent CLI process)

package/dist/gc/daemon.js.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/gc/daemon.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/gc/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,+DAA+D;IAC/D,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAExC,yEAAyE;IACzE,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAE7D,8EAA8E;IAC9E,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtE,iEAAiE;IACjE,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAElF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;QAC5D,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;QACvC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE;KAC7C,CAAC,CAAC;IAEH,2EAA2E;IAC3E,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAE3B,oEAAoE;IACpE,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE;QACjD,SAAS,EAAE,GAAG;QACd,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC1C,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;IAE5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,uCAAuC,EAAE,CAAC;IACxF,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;QACtD,MAAM,YAAY,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,GAAG;YACH,MAAM,EAAE,cAAc,GAAG,uCAAuC;SACjE,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC7B,+CAA+C;QAC/C,MAAM,YAAY,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,uBAAuB,GAAG,EAAE,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,iCAAiC,GAAG,KAAK,GAAG,EAAE,EAAE,CAAC;IACzF,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IAQrD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;IAE5B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QACzB,SAAS,EAAE,KAAK,CAAC,eAAe;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;KACzC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,0EAA0E;AAC1E,0EAA0E;AAC1E,mDAAmD"}

package/dist/gc/gc-subsystem.d.ts

@@ -0,0 +1,96 @@
+/**
+ * GC daemon expressed as a supervised daemon subsystem.
+ *
+ * Wraps the GC bootstrap logic (`bootstrapDaemon`, crash recovery, missed-run
+ * recovery, and the node-cron schedule) in the uniform
+ * `start → healthProbe → shutdown` lifecycle from `@cleocode/contracts/daemon`
+ * so the `@cleocode/runtime` `SubsystemRegistry` can drive it identically to
+ * every other long-running concern (Studio supervision, the web server, …).
+ *
+ * Design constraints
+ * ------------------
+ * `@cleocode/core` CANNOT depend on `@cleocode/runtime` (runtime already
+ * depends on core). To remain dependency-cycle free this module imports only
+ * the pure type contracts from `@cleocode/contracts` and returns a plain
+ * frozen object that satisfies the `Subsystem<GcSubsystemContext>` interface
+ * without calling `defineSubsystem()` (a runtime-layer factory). A caller that
+ * holds a `SubsystemRegistry` (from `@cleocode/runtime/daemon`) simply calls
+ * `registry.register(createGcSubsystem(cleoDir))` — the frozen shape is
+ * identical to what `defineSubsystem` returns and the registry types accept it.
+ *
+ * Thread-through context
+ * ----------------------
+ * `start()` returns a {@link GcSubsystemContext} that is threaded into
+ * `shutdown()` by the registry (same pattern as `GatewaySubsystemContext`
+ * in `@cleocode/runtime/gateway`). This lets `shutdown()` cancel the exact
+ * cron task that `start()` scheduled without requiring module-level mutable
+ * state.
+ *
+ * @see packages/core/src/gc/daemon.ts — standalone bootstrap / spawn helpers
+ * @see packages/runtime/src/daemon/define-subsystem.ts — `defineSubsystem` factory
+ * @see packages/runtime/src/gateway/daemon-subsystem.ts — reference implementation
+ *
+ * @packageDocumentation
+ * @module @cleocode/core/gc
+ *
+ * @task T11503 (R5-T1)
+ * @task T11504 (R5-T2)
+ * @epic T11256
+ * @saga T11243 SG-RUNTIME-UNIFICATION
+ */
+import type { Subsystem } from '@cleocode/contracts';
+/**
+ * The live context `start()` returns and the registry threads into
+ * `shutdown()`. Carries the scheduled cron task so `shutdown()` can destroy
+ * exactly the task that `start()` created.
+ */
+export interface GcSubsystemContext {
+    /** The OS pid of this daemon process (set at subsystem start). */
+    readonly pid: number;
+    /** The ISO-8601 timestamp when this subsystem started. */
+    readonly startedAt: string;
+    /**
+     * The scheduled cron task. `ScheduledTask` is the node-cron return value.
+     * Typed as the minimal destroy surface so callers do not need to import
+     * node-cron types.
+     */
+    readonly cronTask: {
+        destroy: () => void;
+    };
+    /** Count of GC runs performed since subsystem start. */
+    runs: number;
+}
+/**
+ * Create a GC cron-daemon expressed as a uniform daemon subsystem.
+ *
+ * The returned object is a frozen `Subsystem<GcSubsystemContext>` that any
+ * `SubsystemRegistry` (from `@cleocode/runtime/daemon`) can `register()`.
+ *
+ * Lifecycle
+ * ---------
+ * - `start(cleoDir)` — reads gc-state.json, performs crash recovery
+ *   (resumes `pendingPrune` if non-empty), performs missed-run recovery (runs
+ *   GC immediately if elapsed > 24 h), then schedules the daily cron job.
+ *   Returns a {@link GcSubsystemContext} for health-probe and shutdown.
+ * - `healthProbe()` — reports a single {@link SubsystemHealth} row keyed on
+ *   `child_id: 'gc'`; `running` while the cron task is active, with a `detail`
+ *   summarising run count and last-run timestamp.
+ * - `shutdown(context)` — destroys the cron task so the daemon process can
+ *   exit cleanly.
+ *
+ * @param cleoDir - Absolute path to the `.cleo/` directory for this project.
+ * @returns A frozen `Subsystem<GcSubsystemContext>`.
+ *
+ * @example
+ * ```ts
+ * // In the daemon process:
+ * import { SubsystemRegistry } from '@cleocode/runtime/daemon';
+ * import { createGcSubsystem } from '@cleocode/core/gc/gc-subsystem.js';
+ *
+ * const registry = new SubsystemRegistry();
+ * registry.register(createGcSubsystem('/home/user/.local/share/cleo/project/abc/.cleo'));
+ * await registry.startAll();
+ * ```
+ */
+export declare function createGcSubsystem(cleoDir: string): Subsystem<GcSubsystemContext>;
+//# sourceMappingURL=gc-subsystem.d.ts.map

package/dist/gc/gc-subsystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc-subsystem.d.ts","sourceRoot":"","sources":["../../src/gc/gc-subsystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAmC,MAAM,qBAAqB,CAAC;AAmBtF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAC3C,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,kBAAkB,CAAC,CA+GhF"}

package/dist/gc/gc-subsystem.js

@@ -0,0 +1,186 @@
+/**
+ * GC daemon expressed as a supervised daemon subsystem.
+ *
+ * Wraps the GC bootstrap logic (`bootstrapDaemon`, crash recovery, missed-run
+ * recovery, and the node-cron schedule) in the uniform
+ * `start → healthProbe → shutdown` lifecycle from `@cleocode/contracts/daemon`
+ * so the `@cleocode/runtime` `SubsystemRegistry` can drive it identically to
+ * every other long-running concern (Studio supervision, the web server, …).
+ *
+ * Design constraints
+ * ------------------
+ * `@cleocode/core` CANNOT depend on `@cleocode/runtime` (runtime already
+ * depends on core). To remain dependency-cycle free this module imports only
+ * the pure type contracts from `@cleocode/contracts` and returns a plain
+ * frozen object that satisfies the `Subsystem<GcSubsystemContext>` interface
+ * without calling `defineSubsystem()` (a runtime-layer factory). A caller that
+ * holds a `SubsystemRegistry` (from `@cleocode/runtime/daemon`) simply calls
+ * `registry.register(createGcSubsystem(cleoDir))` — the frozen shape is
+ * identical to what `defineSubsystem` returns and the registry types accept it.
+ *
+ * Thread-through context
+ * ----------------------
+ * `start()` returns a {@link GcSubsystemContext} that is threaded into
+ * `shutdown()` by the registry (same pattern as `GatewaySubsystemContext`
+ * in `@cleocode/runtime/gateway`). This lets `shutdown()` cancel the exact
+ * cron task that `start()` scheduled without requiring module-level mutable
+ * state.
+ *
+ * @see packages/core/src/gc/daemon.ts — standalone bootstrap / spawn helpers
+ * @see packages/runtime/src/daemon/define-subsystem.ts — `defineSubsystem` factory
+ * @see packages/runtime/src/gateway/daemon-subsystem.ts — reference implementation
+ *
+ * @packageDocumentation
+ * @module @cleocode/core/gc
+ *
+ * @task T11503 (R5-T1)
+ * @task T11504 (R5-T2)
+ * @epic T11256
+ * @saga T11243 SG-RUNTIME-UNIFICATION
+ */
+import { join } from 'node:path';
+import cron from 'node-cron';
+import { runGC } from './runner.js';
+import { patchGCState, readGCState } from './state.js';
+// ---------------------------------------------------------------------------
+// Constants (mirrors daemon.ts — single authority is retained in daemon.ts)
+// ---------------------------------------------------------------------------
+/** Cron expression: daily at 03:00 UTC. Kept in sync with daemon.ts. */
+const GC_CRON_EXPR = '0 3 * * *';
+/** Interval for missed-run recovery check (24 hours in ms). */
+const GC_INTERVAL_MS = 24 * 60 * 60 * 1000;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a GC cron-daemon expressed as a uniform daemon subsystem.
+ *
+ * The returned object is a frozen `Subsystem<GcSubsystemContext>` that any
+ * `SubsystemRegistry` (from `@cleocode/runtime/daemon`) can `register()`.
+ *
+ * Lifecycle
+ * ---------
+ * - `start(cleoDir)` — reads gc-state.json, performs crash recovery
+ *   (resumes `pendingPrune` if non-empty), performs missed-run recovery (runs
+ *   GC immediately if elapsed > 24 h), then schedules the daily cron job.
+ *   Returns a {@link GcSubsystemContext} for health-probe and shutdown.
+ * - `healthProbe()` — reports a single {@link SubsystemHealth} row keyed on
+ *   `child_id: 'gc'`; `running` while the cron task is active, with a `detail`
+ *   summarising run count and last-run timestamp.
+ * - `shutdown(context)` — destroys the cron task so the daemon process can
+ *   exit cleanly.
+ *
+ * @param cleoDir - Absolute path to the `.cleo/` directory for this project.
+ * @returns A frozen `Subsystem<GcSubsystemContext>`.
+ *
+ * @example
+ * ```ts
+ * // In the daemon process:
+ * import { SubsystemRegistry } from '@cleocode/runtime/daemon';
+ * import { createGcSubsystem } from '@cleocode/core/gc/gc-subsystem.js';
+ *
+ * const registry = new SubsystemRegistry();
+ * registry.register(createGcSubsystem('/home/user/.local/share/cleo/project/abc/.cleo'));
+ * await registry.startAll();
+ * ```
+ */
+export function createGcSubsystem(cleoDir) {
+    const statePath = join(cleoDir, 'gc-state.json');
+    // Closure-held live context so `healthProbe()` (which receives no arguments
+    // per the Subsystem contract) can read the current state.
+    let live;
+    const subsystem = {
+        name: 'gc',
+        async start() {
+            // Register daemon PID in state file
+            await patchGCState(statePath, {
+                daemonPid: process.pid,
+                daemonStartedAt: new Date().toISOString(),
+            });
+            const state = await readGCState(statePath);
+            let runs = 0;
+            // Step 1: Crash recovery — resume pending prune from prior run
+            if (state.pendingPrune && state.pendingPrune.length > 0) {
+                try {
+                    await runGC({ cleoDir, resumeFrom: state.pendingPrune });
+                    runs += 1;
+                }
+                catch {
+                    // Crash-recovery failure is non-fatal; continue with scheduled runs
+                }
+            }
+            // Step 2: Missed-run recovery — if last run was > 24 h ago, run immediately
+            const lastRunTs = state.lastRunAt ? new Date(state.lastRunAt).getTime() : 0;
+            const elapsed = Date.now() - lastRunTs;
+            if (elapsed > GC_INTERVAL_MS) {
+                try {
+                    await runGC({ cleoDir });
+                    runs += 1;
+                }
+                catch {
+                    // Immediate GC failure is non-fatal; cron will retry next cycle
+                }
+            }
+            // Step 3: Schedule future runs via node-cron
+            // noOverlap: true prevents double-runs if a previous run exceeds 24 h
+            const cronTask = cron.schedule(GC_CRON_EXPR, async () => {
+                try {
+                    await runGC({ cleoDir });
+                    if (live !== undefined) {
+                        live.runs += 1;
+                    }
+                }
+                catch {
+                    // Log failures via stderr (redirected to gc.log by spawn)
+                    const currentState = await readGCState(statePath);
+                    await patchGCState(statePath, {
+                        consecutiveFailures: currentState.consecutiveFailures + 1,
+                        lastRunResult: 'failed',
+                        escalationNeeded: currentState.consecutiveFailures + 1 >= 3,
+                        escalationReason: currentState.consecutiveFailures + 1 >= 3
+                            ? `GC daemon: ${currentState.consecutiveFailures + 1} consecutive failures. Check logs.`
+                            : currentState.escalationReason,
+                    });
+                }
+            }, {
+                timezone: 'UTC',
+                noOverlap: true,
+                name: 'cleo-gc',
+            });
+            const context = {
+                pid: process.pid,
+                startedAt: new Date().toISOString(),
+                cronTask,
+                runs,
+            };
+            live = context;
+            return context;
+        },
+        healthProbe() {
+            if (live === undefined) {
+                const stopped = 'stopped';
+                return {
+                    child_id: 'gc',
+                    pid: 0,
+                    state: stopped,
+                    restart_count: 0,
+                    detail: 'gc subsystem not started',
+                };
+            }
+            const running = 'running';
+            return {
+                child_id: 'gc',
+                pid: live.pid,
+                state: running,
+                restart_count: live.runs,
+                detail: `runs=${live.runs} startedAt=${live.startedAt}`,
+            };
+        },
+        shutdown(context) {
+            context.cronTask.destroy();
+            live = undefined;
+        },
+    };
+    return Object.freeze(subsystem);
+}
+//# sourceMappingURL=gc-subsystem.js.map

package/dist/gc/gc-subsystem.js.map

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

package/dist/gc/index.d.ts

@@ -9,6 +9,7 @@
  */
 export { auditOrphanTempDirs, auditOrphanWorktrees, } from '../validation/doctor/checks.js';
 export * from './daemon.js';
+export * from './gc-subsystem.js';
 export * from './runner.js';
 export * from './state.js';
 export * from './transcript.js';

package/dist/gc/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/gc/index.js

@@ -11,6 +11,7 @@
 // Read-only audit counterparts to pruneOrphanWorktrees / pruneOrphanTempDirs.
 export { auditOrphanTempDirs, auditOrphanWorktrees, } from '../validation/doctor/checks.js';
 export * from './daemon.js';
+export * from './gc-subsystem.js';
 export * from './runner.js';
 export * from './state.js';
 export * from './transcript.js';

package/dist/gc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yFAAyF;AACzF,8EAA8E;AAC9E,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yFAAyF;AACzF,8EAA8E;AAC9E,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}