@cleocode/core 2026.4.99 → 2026.4.100

package/dist/sentient/propose-tick.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/sentient/ingesters/brain-ingester.ts", "../../src/sentient/ingesters/nexus-ingester.ts", "../../src/sentient/ingesters/test-ingester.ts", "../../src/sentient/proposal-rate-limiter.ts", "../../src/sentient/state.ts", "../../src/sentient/propose-tick.ts"],
+  "sourcesContent": ["/**\n * BRAIN Ingester \u2014 Tier-2 proposal candidate source.\n *\n * Queries brain.db for recurring-pain observations (citation_count >= 3,\n * last 7 days, quality_score >= 0.5) and returns ranked ProposalCandidate[].\n *\n * Design principles:\n * - NO LLM calls. All data comes from structured SQL queries.\n * - Title is template-generated: `[T2-BRAIN] Recurring issue: {title}`.\n *   This is the prompt-injection defence from T1008 \u00A73.6.\n * - Failures are swallowed: returns empty array + logs warning.\n *   Brain.db absence must never crash the propose tick.\n *\n * @task T1008\n * @see ADR-054 \u2014 Sentient Loop Tier-2\n */\n\nimport type { DatabaseSync } from 'node:sqlite';\nimport type { ProposalCandidate } from '@cleocode/contracts';\n\n// ---------------------------------------------------------------------------\n// Brain observation row (raw SQL result)\n// ---------------------------------------------------------------------------\n\ninterface BrainObservationRow {\n  id: string;\n  title: string | null;\n  text: string;\n  citation_count: number;\n  quality_score: number;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Maximum candidates returned from a single brain ingester pass. */\nexport const BRAIN_INGESTER_LIMIT = 10;\n\n/** Minimum citation count for a brain entry to be considered. */\nexport const BRAIN_MIN_CITATION_COUNT = 3;\n\n/** Minimum quality score for a brain entry to be considered. */\nexport const BRAIN_MIN_QUALITY_SCORE = 0.5;\n\n/** Lookback window in days for brain observations. */\nexport const BRAIN_LOOKBACK_DAYS = 7;\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Compute candidate weight from citation_count and quality_score.\n * Formula: `(citation_count / 10) * quality_score` capped at 1.0.\n */\nexport function computeBrainWeight(citationCount: number, qualityScore: number): number {\n  return Math.min((citationCount / 10) * qualityScore, 1.0);\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Run the BRAIN ingester against the provided DatabaseSync handle.\n *\n * Returns at most {@link BRAIN_INGESTER_LIMIT} candidates, sorted by weight\n * descending. Returns an empty array if the database has no matching entries\n * or if any error occurs (errors are swallowed to never crash the tick).\n *\n * @param nativeDb - Open DatabaseSync handle to brain.db. May be null if\n *   brain.db has not been initialised; this is treated as zero candidates.\n * @returns Ranked ProposalCandidate array (may be empty).\n */\nexport function runBrainIngester(nativeDb: DatabaseSync | null): ProposalCandidate[] {\n  if (!nativeDb) {\n    return [];\n  }\n\n  try {\n    const stmt = nativeDb.prepare(`\n      SELECT id, title, text, citation_count, quality_score\n      FROM brain_observations\n      WHERE type IN ('bugfix', 'decision')\n        AND citation_count >= :minCitations\n        AND created_at >= datetime('now', :lookback)\n        AND quality_score >= :minQuality\n      ORDER BY citation_count DESC, quality_score DESC\n      LIMIT :limit\n    `);\n\n    const rows = stmt.all({\n      minCitations: BRAIN_MIN_CITATION_COUNT,\n      lookback: `-${BRAIN_LOOKBACK_DAYS} days`,\n      minQuality: BRAIN_MIN_QUALITY_SCORE,\n      limit: BRAIN_INGESTER_LIMIT,\n    }) as unknown as BrainObservationRow[];\n\n    const candidates: ProposalCandidate[] = rows.map((row) => {\n      const label = row.title ?? row.text.slice(0, 80);\n      return {\n        source: 'brain' as const,\n        sourceId: row.id,\n        title: `[T2-BRAIN] Recurring issue: ${label}`,\n        rationale: `Brain entry ${row.id} cited ${row.citation_count} times (quality ${row.quality_score.toFixed(2)}) in the last ${BRAIN_LOOKBACK_DAYS} days`,\n        weight: computeBrainWeight(row.citation_count, row.quality_score),\n      };\n    });\n\n    // Sort descending by weight (DB ORDER BY handles primary sort, but\n    // weight formula may produce different ordering than raw column order).\n    candidates.sort((a, b) => b.weight - a.weight);\n\n    return candidates;\n  } catch (err) {\n    // Best-effort: log warning but never throw from an ingester.\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[sentient/brain-ingester] WARNING: ${message}\\n`);\n    return [];\n  }\n}\n", "/**\n * Nexus Ingester \u2014 Tier-2 proposal candidate source.\n *\n * Queries nexus.db for structural anomalies and returns ranked\n * ProposalCandidate[]. Two query patterns:\n *\n *   A. Orphaned callees: functions that have many callers but make no calls\n *      themselves (zero-import, high-in-degree). Suggests dead-end sinks\n *      that may be candidates for abstraction or documentation.\n *\n *   B. Over-coupled nodes: symbols with total degree (in + out edges) > 20,\n *      suggesting high coupling that should be refactored.\n *\n * Design principles:\n * - NO LLM calls. All data comes from structured SQL queries.\n * - Title is template-generated: `[T2-NEXUS] ...`. Prompt-injection defence.\n * - Failures are swallowed: returns empty array + logs warning.\n *   Nexus.db absence must never crash the propose tick.\n *\n * @task T1008\n * @see ADR-054 \u2014 Sentient Loop Tier-2\n */\n\nimport type { DatabaseSync } from 'node:sqlite';\nimport type { ProposalCandidate } from '@cleocode/contracts';\n\n// ---------------------------------------------------------------------------\n// Raw row types\n// ---------------------------------------------------------------------------\n\ninterface OrphanCalleeRow {\n  id: string;\n  name: string;\n  file_path: string;\n  caller_count: number;\n}\n\ninterface HighDegreeRow {\n  id: string;\n  name: string;\n  file_path: string;\n  degree: number;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Base weight for all nexus candidates (structural signals, lower priority than brain). */\nexport const NEXUS_BASE_WEIGHT = 0.3;\n\n/** Minimum caller count for orphaned-callee detection. */\nexport const NEXUS_MIN_CALLER_COUNT = 5;\n\n/** Minimum total degree for over-coupling detection. */\nexport const NEXUS_MIN_DEGREE = 20;\n\n/** Maximum results per query. */\nexport const NEXUS_QUERY_LIMIT = 5;\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Compute a deduplication key that is stable across query A and query B.\n * Both queries reference the same nexus node table, so using the node id\n * directly as sourceId is sufficient.\n */\nfunction toFingerprint(nodeId: string): string {\n  return nodeId;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Run the Nexus ingester against the provided DatabaseSync handle.\n *\n * Returns candidates from both orphaned-callee (Query A) and high-degree\n * (Query B) detection, merged without duplication. Returns an empty array\n * if the database has no matching entries or if any error occurs.\n *\n * @param nativeDb - Open DatabaseSync handle to nexus.db. May be null if\n *   nexus.db has not been initialised; this is treated as zero candidates.\n * @returns Ranked ProposalCandidate array (may be empty).\n */\nexport function runNexusIngester(nativeDb: DatabaseSync | null): ProposalCandidate[] {\n  if (!nativeDb) {\n    return [];\n  }\n\n  const seenIds = new Set<string>();\n  const candidates: ProposalCandidate[] = [];\n\n  try {\n    // Query A: orphaned callees (many callers, zero outbound calls).\n    const stmtA = nativeDb.prepare(`\n      SELECT n.id, n.name, n.file_path, COUNT(r.id) as caller_count\n      FROM nexus_nodes n\n      JOIN nexus_relations r ON r.target_id = n.id AND r.kind = 'calls'\n      WHERE NOT EXISTS (\n        SELECT 1 FROM nexus_relations r2\n        WHERE r2.source_id = n.id AND r2.kind = 'calls'\n      )\n      AND n.kind = 'function'\n      GROUP BY n.id\n      HAVING caller_count > :minCallers\n      ORDER BY caller_count DESC\n      LIMIT :limit\n    `);\n\n    const rowsA = stmtA.all({\n      minCallers: NEXUS_MIN_CALLER_COUNT,\n      limit: NEXUS_QUERY_LIMIT,\n    }) as unknown as OrphanCalleeRow[];\n\n    for (const row of rowsA) {\n      const fp = toFingerprint(row.id);\n      if (seenIds.has(fp)) continue;\n      seenIds.add(fp);\n      candidates.push({\n        source: 'nexus' as const,\n        sourceId: row.id,\n        title: `[T2-NEXUS] Over-coupled symbol: ${row.name} (${row.caller_count} callers)`,\n        rationale: `Function ${row.name} in ${row.file_path} has ${row.caller_count} callers but makes no outbound calls \u2014 review for abstraction opportunity`,\n        weight: NEXUS_BASE_WEIGHT,\n      });\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[sentient/nexus-ingester] WARNING query A: ${message}\\n`);\n  }\n\n  try {\n    // Query B: high-degree nodes (over-coupling).\n    const stmtB = nativeDb.prepare(`\n      SELECT n.id, n.name, n.file_path, COUNT(r.id) as degree\n      FROM nexus_nodes n\n      JOIN nexus_relations r ON r.source_id = n.id OR r.target_id = n.id\n      GROUP BY n.id\n      HAVING degree > :minDegree\n      ORDER BY degree DESC\n      LIMIT :limit\n    `);\n\n    const rowsB = stmtB.all({\n      minDegree: NEXUS_MIN_DEGREE,\n      limit: NEXUS_QUERY_LIMIT,\n    }) as unknown as HighDegreeRow[];\n\n    for (const row of rowsB) {\n      const fp = toFingerprint(row.id);\n      if (seenIds.has(fp)) continue;\n      seenIds.add(fp);\n      candidates.push({\n        source: 'nexus' as const,\n        sourceId: row.id,\n        title: `[T2-NEXUS] Over-coupled symbol: ${row.name} (${row.degree} edges)`,\n        rationale: `Symbol ${row.name} in ${row.file_path} has ${row.degree} total edges \u2014 review for over-coupling`,\n        weight: NEXUS_BASE_WEIGHT,\n      });\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[sentient/nexus-ingester] WARNING query B: ${message}\\n`);\n  }\n\n  return candidates;\n}\n", "/**\n * Test Ingester \u2014 Tier-2 proposal candidate source.\n *\n * Reads two data sources:\n *\n *   Source A \u2014 `.cleo/audit/gates.jsonl`: CLEO evidence gate failure records.\n *     Each line is a JSONL record. Lines where `failCount > 0` produce a\n *     proposal suggesting a flaky-test guard be added for the failing task.\n *\n *   Source B \u2014 `.cleo/coverage-summary.json`: vitest coverage JSON summary.\n *     Written by `vitest --coverage --reporter json-summary`. Lines where\n *     `lines.pct < 80` produce a proposal suggesting coverage improvement.\n *     If the file is absent, Source B returns zero candidates (no error).\n *\n * Design principles:\n * - NO LLM calls. All data comes from structured file reads.\n * - Title is template-generated. Prompt-injection defence (T1008 \u00A73.6).\n * - Failures are swallowed: returns empty array + logs warning.\n *\n * @task T1008\n * @see ADR-054 \u2014 Sentient Loop Tier-2\n */\n\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { ProposalCandidate } from '@cleocode/contracts';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** A single line from gates.jsonl. */\ninterface GateRecord {\n  taskId?: string;\n  gate?: string;\n  failCount?: number;\n  [key: string]: unknown;\n}\n\n/** Coverage summary entry for a single file. */\ninterface CoverageEntry {\n  lines?: { pct?: number };\n  statements?: { pct?: number };\n  functions?: { pct?: number };\n  branches?: { pct?: number };\n}\n\n/** Shape of the JSON coverage summary file. */\ntype CoverageSummary = Record<string, CoverageEntry>;\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Relative path from project root to gates.jsonl. */\nexport const GATES_JSONL_PATH = '.cleo/audit/gates.jsonl' as const;\n\n/** Relative path from project root to the coverage summary. */\nexport const COVERAGE_SUMMARY_PATH = '.cleo/coverage-summary.json' as const;\n\n/** Coverage line percentage below which a proposal is emitted. */\nexport const MIN_LINE_COVERAGE_PCT = 80;\n\n/** Base weight for all test ingester candidates. */\nexport const TEST_BASE_WEIGHT = 0.5;\n\n// ---------------------------------------------------------------------------\n// Source A: gates.jsonl\n// ---------------------------------------------------------------------------\n\n/**\n * Parse gates.jsonl and return one candidate per task that has any gate\n * with `failCount > 0`.\n *\n * @param projectRoot - Absolute path to the project root.\n * @returns Proposal candidates (may be empty).\n */\nfunction runGatesIngester(projectRoot: string): ProposalCandidate[] {\n  const gatesPath = join(projectRoot, GATES_JSONL_PATH);\n\n  let raw: string;\n  try {\n    raw = readFileSync(gatesPath, 'utf-8');\n  } catch {\n    // File absent or unreadable \u2014 not an error.\n    return [];\n  }\n\n  const candidates: ProposalCandidate[] = [];\n  const seenKeys = new Set<string>();\n\n  for (const line of raw.split('\\n')) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n\n    let record: GateRecord;\n    try {\n      record = JSON.parse(trimmed) as GateRecord;\n    } catch {\n      // Skip malformed lines.\n      continue;\n    }\n\n    const taskId = record.taskId;\n    const gate = record.gate ?? 'unknown';\n    const failCount = record.failCount ?? 0;\n\n    if (typeof taskId !== 'string' || failCount <= 0) continue;\n\n    const key = `${taskId}.${gate}`;\n    if (seenKeys.has(key)) continue;\n    seenKeys.add(key);\n\n    candidates.push({\n      source: 'test' as const,\n      sourceId: key,\n      title: `[T2-TEST] Fix flaky gate: ${taskId}.${gate}`,\n      rationale: `Gate '${gate}' on task ${taskId} has failed ${failCount} time(s)`,\n      weight: TEST_BASE_WEIGHT,\n    });\n  }\n\n  return candidates;\n}\n\n// ---------------------------------------------------------------------------\n// Source B: coverage-summary.json\n// ---------------------------------------------------------------------------\n\n/**\n * Read the vitest coverage summary and return one candidate per file with\n * line coverage below {@link MIN_LINE_COVERAGE_PCT}.\n *\n * @param projectRoot - Absolute path to the project root.\n * @returns Proposal candidates (may be empty; empty if file absent).\n */\nfunction runCoverageIngester(projectRoot: string): ProposalCandidate[] {\n  const coveragePath = join(projectRoot, COVERAGE_SUMMARY_PATH);\n\n  let summary: CoverageSummary;\n  try {\n    const raw = readFileSync(coveragePath, 'utf-8');\n    summary = JSON.parse(raw) as CoverageSummary;\n  } catch {\n    // File absent or malformed \u2014 not an error, return zero candidates.\n    return [];\n  }\n\n  const candidates: ProposalCandidate[] = [];\n\n  for (const [filePath, entry] of Object.entries(summary)) {\n    // Skip the 'total' synthetic key if present.\n    if (filePath === 'total') continue;\n\n    const pct = entry?.lines?.pct;\n    if (typeof pct !== 'number' || pct >= MIN_LINE_COVERAGE_PCT) continue;\n\n    candidates.push({\n      source: 'test' as const,\n      sourceId: filePath,\n      title: `[T2-TEST] Increase coverage: ${filePath} (${pct}% lines)`,\n      rationale: `File ${filePath} has ${pct}% line coverage (target: ${MIN_LINE_COVERAGE_PCT}%)`,\n      weight: TEST_BASE_WEIGHT,\n    });\n  }\n\n  return candidates;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Run the test ingester against both data sources.\n *\n * Merges Source A (gates.jsonl) and Source B (coverage-summary.json) without\n * duplication. Returns an empty array if both sources yield nothing or if\n * errors occur (errors are swallowed).\n *\n * @param projectRoot - Absolute path to the project root.\n * @returns Combined ProposalCandidate array (may be empty).\n */\nexport function runTestIngester(projectRoot: string): ProposalCandidate[] {\n  try {\n    const gatesCandidates = runGatesIngester(projectRoot);\n    const coverageCandidates = runCoverageIngester(projectRoot);\n\n    // Merge, deduplicate by sourceId.\n    const seenSourceIds = new Set<string>();\n    const merged: ProposalCandidate[] = [];\n\n    for (const candidate of [...gatesCandidates, ...coverageCandidates]) {\n      if (seenSourceIds.has(candidate.sourceId)) continue;\n      seenSourceIds.add(candidate.sourceId);\n      merged.push(candidate);\n    }\n\n    return merged;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[sentient/test-ingester] WARNING: ${message}\\n`);\n    return [];\n  }\n}\n", "/**\n * Proposal Rate Limiter \u2014 Transactional DB-enforced daily cap.\n *\n * Enforces a maximum of N proposals per day per source tag, using a\n * BEGIN IMMEDIATE transaction with COUNT + conditional INSERT pattern.\n *\n * Design rationale (T1008 \u00A73.2):\n * - In-process counters do not survive daemon restart, and two daemon\n *   instances could both allow N/day if enforcement is not in the DB.\n * - The `sentient.lock` advisory lock (daemon.ts) prevents two daemons\n *   from running concurrently, but the transactional count check provides\n *   belt-and-suspenders protection against TOCTOU races.\n * - SQLite partial unique indexes cannot enforce count > 1, so the\n *   BEGIN IMMEDIATE + COUNT + INSERT pattern is used instead.\n *\n * The \"day\" boundary is determined by SQLite's `date('now')` (UTC).\n * Proposals counted include ALL non-terminal statuses (proposed, pending,\n * active, done) \u2014 an accepted proposal still consumes a daily slot.\n *\n * @task T1008\n * @see ADR-054 \u2014 Sentient Loop Tier-2\n */\n\nimport type { DatabaseSync, SQLInputValue } from 'node:sqlite';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/**\n * The meta proposedBy tag written to `tasks.metadata_json` by the Tier-2\n * proposer. This tag is the query key for rate-limit counting.\n */\nexport const SENTIENT_TIER2_TAG = 'sentient-tier2' as const;\n\n/**\n * Default maximum number of Tier-2 proposals per UTC day.\n * Can be overridden by callers.\n */\nexport const DEFAULT_DAILY_PROPOSAL_LIMIT = 3;\n\n/**\n * SQL error code string returned when BEGIN IMMEDIATE fails because another\n * write transaction is in progress.\n */\nconst SQLITE_BUSY_CODE = 'SQLITE_BUSY';\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Count the number of Tier-2 proposals created today (UTC).\n *\n * Counts tasks where:\n *   - `labels_json` contains `'sentient-tier2'` (the Tier-2 marker label)\n *   - `date(created_at) = date('now')`\n *   - `status IN ('proposed', 'pending', 'active', 'done')` \u2014 terminal\n *     states that were proposed today still count toward the daily cap so\n *     that accepted proposals don't free a slot for another proposal.\n *\n * The `LIKE` pattern is intentional: labels_json is a JSON array stored as\n * text, and `'sentient-tier2'` is always a complete JSON string value within\n * that array, making substring matching safe here.\n *\n * @param nativeDb - Open DatabaseSync handle to tasks.db.\n * @returns Number of proposals created today. Returns 0 if DB is null.\n */\nexport function countTodayProposals(nativeDb: DatabaseSync | null): number {\n  if (!nativeDb) return 0;\n\n  const stmt = nativeDb.prepare(`\n    SELECT COUNT(*) as cnt\n    FROM tasks\n    WHERE labels_json LIKE :labelPattern\n      AND date(created_at) = date('now')\n      AND status IN ('proposed', 'pending', 'active', 'done')\n  `);\n\n  const row = stmt.get({ labelPattern: `%${SENTIENT_TIER2_TAG}%` }) as { cnt: number } | undefined;\n  return row?.cnt ?? 0;\n}\n\n/**\n * Check whether the daily rate limit has been reached.\n *\n * @param nativeDb - Open DatabaseSync handle to tasks.db.\n * @param limit - Daily cap (defaults to {@link DEFAULT_DAILY_PROPOSAL_LIMIT}).\n * @returns `true` if the limit is reached or exceeded; `false` if capacity remains.\n */\nexport function isRateLimitExceeded(\n  nativeDb: DatabaseSync | null,\n  limit = DEFAULT_DAILY_PROPOSAL_LIMIT,\n): boolean {\n  return countTodayProposals(nativeDb) >= limit;\n}\n\n// ---------------------------------------------------------------------------\n// Transactional INSERT guard\n// ---------------------------------------------------------------------------\n\n/** Result of a transactional insert attempt. */\nexport interface TransactionalInsertResult {\n  /** Whether the INSERT was committed. */\n  inserted: boolean;\n  /**\n   * The count read at the start of the transaction. Used for diagnostics\n   * and tests \u2014 lets callers verify the guard saw the expected count.\n   */\n  countBeforeInsert: number;\n  /**\n   * If `inserted = false` and this is set, the limit was the reason.\n   */\n  reason?: 'rate-limit' | 'busy';\n}\n\n/**\n * Attempt to insert a pre-built task row inside a BEGIN IMMEDIATE transaction\n * with a count check.\n *\n * Steps:\n *   1. BEGIN IMMEDIATE (exclusive write lock on tasks.db)\n *   2. COUNT proposals created today\n *   3. If count >= limit: ROLLBACK, return `{ inserted: false, reason: 'rate-limit' }`\n *   4. Otherwise: INSERT the row, COMMIT, return `{ inserted: true }`\n *\n * On SQLITE_BUSY: ROLLBACK + return `{ inserted: false, reason: 'busy' }`.\n *\n * @param nativeDb - Open DatabaseSync handle to tasks.db.\n * @param insertSql - Parameterized INSERT SQL string.\n * @param insertParams - Named parameters for the INSERT statement.\n * @param limit - Daily cap.\n * @returns Insert result.\n */\nexport function transactionalInsertProposal(\n  nativeDb: DatabaseSync,\n  insertSql: string,\n  insertParams: Record<string, SQLInputValue>,\n  limit = DEFAULT_DAILY_PROPOSAL_LIMIT,\n): TransactionalInsertResult {\n  try {\n    nativeDb.exec('BEGIN IMMEDIATE');\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    if (msg.includes(SQLITE_BUSY_CODE)) {\n      return { inserted: false, countBeforeInsert: 0, reason: 'busy' };\n    }\n    throw err;\n  }\n\n  try {\n    const countBeforeInsert = countTodayProposals(nativeDb);\n\n    if (countBeforeInsert >= limit) {\n      nativeDb.exec('ROLLBACK');\n      return { inserted: false, countBeforeInsert, reason: 'rate-limit' };\n    }\n\n    const stmt = nativeDb.prepare(insertSql);\n    stmt.run(insertParams);\n\n    nativeDb.exec('COMMIT');\n    return { inserted: true, countBeforeInsert };\n  } catch (err) {\n    try {\n      nativeDb.exec('ROLLBACK');\n    } catch {\n      // ignore rollback failure\n    }\n    throw err;\n  }\n}\n", "/**\n * Sentient Loop State \u2014 Persistent state for the Tier-1 autonomous daemon.\n *\n * Stored in `.cleo/sentient-state.json` (plain JSON, not SQLite) to avoid\n * SQLite WAL conflicts between the long-running daemon process and the\n * main CLEO CLI process. Human-readable for debugging.\n *\n * The file is gitignored (see .gitignore \u00A7.cleo/ section) and survives\n * restarts. Only `killSwitch`, `pid`, and `stats` fields are load-bearing\n * across process boundaries.\n *\n * @see ADR-054 \u2014 Sentient Loop Tier-1 (autonomous task execution)\n * @task T946\n */\n\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport type { Tier2Stats } from '@cleocode/contracts';\n\n/** Schema version for sentient-state.json. Bump on breaking field changes. */\nexport const SENTIENT_STATE_SCHEMA_VERSION = '1.0' as const;\n\n/**\n * Per-task failure/backoff tracking for stuck detection.\n * Keyed by task id in {@link SentientState.stuckTasks}.\n */\nexport interface StuckTaskRecord {\n  /** Number of consecutive failed spawn attempts for this task. */\n  attempts: number;\n  /** ISO-8601 timestamp of the most recent failure. */\n  lastFailureAt: string;\n  /** Unix epoch ms when the next retry becomes eligible. */\n  nextRetryAt: number;\n  /** Last captured failure reason (truncated to 500 chars). */\n  lastReason: string;\n}\n\n/**\n * Rolling counters persisted across daemon restarts.\n */\nexport interface SentientStats {\n  /** Total tasks picked by the loop since creation. */\n  tasksPicked: number;\n  /** Total tasks that completed successfully. */\n  tasksCompleted: number;\n  /** Total tasks whose spawn exited non-zero. */\n  tasksFailed: number;\n  /** Total ticks executed (including no-op ticks). */\n  ticksExecuted: number;\n  /** Total ticks aborted early because kill switch was active. */\n  ticksKilled: number;\n}\n\n/**\n * Persistent sentient daemon state.\n *\n * Design principles:\n * - `killSwitch` is the single load-bearing kill signal \u2014 the daemon re-checks\n *   it between every step of a tick, not just at tick start (Round 2 audit).\n * - `stuckTasks` keys are task ids; values encode backoff + failure counts.\n * - `stuckTimestamps` is a rolling 1-hour window used for the self-pause rule\n *   (5 stucks in 1 hour \u2192 killSwitch=true).\n * - `stats` fields are monotonic counters that only ever increase.\n */\nexport interface SentientState {\n  /** JSON schema version for forward-compatibility checks. */\n  schemaVersion: typeof SENTIENT_STATE_SCHEMA_VERSION;\n  /** PID of the currently running daemon process. null = daemon not running. */\n  pid: number | null;\n  /** ISO-8601 timestamp when the daemon was last started. */\n  startedAt: string | null;\n  /** ISO-8601 timestamp of the last completed tick (any outcome). */\n  lastTickAt: string | null;\n  /**\n   * Kill-switch flag. When true, the daemon re-checks at every step of a tick\n   * and exits cleanly without picking or spawning a task.\n   */\n  killSwitch: boolean;\n  /** Reason supplied when killSwitch was last set (diagnostic only). */\n  killSwitchReason: string | null;\n  /** Rolling counters; see {@link SentientStats}. */\n  stats: SentientStats;\n  /** Per-task backoff + failure metadata for retry/stuck detection. */\n  stuckTasks: Record<string, StuckTaskRecord>;\n  /**\n   * Unix-epoch-ms timestamps of `stuck` events within the last hour.\n   * When length \u2265 5 the daemon self-pauses (killSwitch=true).\n   */\n  stuckTimestamps: number[];\n  /**\n   * Currently-active task id (set while a spawn is in-flight, cleared afterward).\n   * Enables `status` to show the in-progress task during a long-running tick.\n   */\n  activeTaskId: string | null;\n  /**\n   * Tier-2 proposal queue enabled flag.\n   *\n   * Default: `false` \u2014 Tier 2 is OFF by default to prevent surprise proposal\n   * floods on first daemon start. Owner enables via `cleo sentient propose enable`\n   * (patches this flag). See ADR-054 \u00A7Tier-2.\n   *\n   * @task T1008\n   */\n  tier2Enabled: boolean;\n  /**\n   * Rolling counters for Tier-2 proposal activity.\n   *\n   * @task T1008\n   */\n  tier2Stats: Tier2Stats;\n}\n\n/** Default (empty) sentient state for fresh initialisation. */\nexport const DEFAULT_SENTIENT_STATE: SentientState = {\n  schemaVersion: SENTIENT_STATE_SCHEMA_VERSION,\n  pid: null,\n  startedAt: null,\n  lastTickAt: null,\n  killSwitch: false,\n  killSwitchReason: null,\n  stats: {\n    tasksPicked: 0,\n    tasksCompleted: 0,\n    tasksFailed: 0,\n    ticksExecuted: 0,\n    ticksKilled: 0,\n  },\n  stuckTasks: {},\n  stuckTimestamps: [],\n  activeTaskId: null,\n  tier2Enabled: false,\n  tier2Stats: {\n    proposalsGenerated: 0,\n    proposalsAccepted: 0,\n    proposalsRejected: 0,\n  },\n};\n\n/**\n * Read the sentient state from disk.\n *\n * Returns the default state if the file does not exist or is malformed.\n * Never throws \u2014 absence is not an error.\n *\n * @param statePath - Absolute path to sentient-state.json\n */\nexport async function readSentientState(statePath: string): Promise<SentientState> {\n  try {\n    const raw = await readFile(statePath, 'utf-8');\n    const parsed = JSON.parse(raw) as Partial<SentientState>;\n    return {\n      ...DEFAULT_SENTIENT_STATE,\n      ...parsed,\n      stats: { ...DEFAULT_SENTIENT_STATE.stats, ...(parsed.stats ?? {}) },\n      stuckTasks: parsed.stuckTasks ?? {},\n      stuckTimestamps: parsed.stuckTimestamps ?? [],\n      tier2Enabled: parsed.tier2Enabled ?? false,\n      tier2Stats: { ...DEFAULT_SENTIENT_STATE.tier2Stats, ...(parsed.tier2Stats ?? {}) },\n    };\n  } catch {\n    return { ...DEFAULT_SENTIENT_STATE };\n  }\n}\n\n/**\n * Write the sentient state to disk atomically via tmp-then-rename.\n *\n * Atomic write prevents partial reads if the daemon crashes mid-write.\n *\n * @param statePath - Absolute path to sentient-state.json\n * @param state - State to persist\n */\nexport async function writeSentientState(statePath: string, state: SentientState): Promise<void> {\n  const dir = dirname(statePath);\n  await mkdir(dir, { recursive: true });\n\n  const tmpPath = join(dir, `.sentient-state-${process.pid}.tmp`);\n  const json = JSON.stringify(state, null, 2);\n\n  await writeFile(tmpPath, json, 'utf-8');\n  await rename(tmpPath, statePath);\n}\n\n/**\n * Patch a subset of fields in the sentient state file.\n *\n * Reads current state, merges patch, writes back. Nested `stats` merges\n * with existing stats (never clobbered wholesale).\n *\n * @param statePath - Absolute path to sentient-state.json\n * @param patch - Partial state to merge over the existing state\n * @returns The merged state that was written to disk.\n */\nexport async function patchSentientState(\n  statePath: string,\n  patch: Partial<SentientState>,\n): Promise<SentientState> {\n  const current = await readSentientState(statePath);\n  const updated: SentientState = {\n    ...current,\n    ...patch,\n    stats: { ...current.stats, ...(patch.stats ?? {}) },\n  };\n  await writeSentientState(statePath, updated);\n  return updated;\n}\n\n/**\n * Increment stats counters atomically.\n *\n * @param statePath - Absolute path to sentient-state.json\n * @param delta - Partial stats to add to current counters\n */\nexport async function incrementStats(\n  statePath: string,\n  delta: Partial<SentientStats>,\n): Promise<SentientState> {\n  const current = await readSentientState(statePath);\n  const nextStats: SentientStats = {\n    tasksPicked: current.stats.tasksPicked + (delta.tasksPicked ?? 0),\n    tasksCompleted: current.stats.tasksCompleted + (delta.tasksCompleted ?? 0),\n    tasksFailed: current.stats.tasksFailed + (delta.tasksFailed ?? 0),\n    ticksExecuted: current.stats.ticksExecuted + (delta.ticksExecuted ?? 0),\n    ticksKilled: current.stats.ticksKilled + (delta.ticksKilled ?? 0),\n  };\n  const updated: SentientState = { ...current, stats: nextStats };\n  await writeSentientState(statePath, updated);\n  return updated;\n}\n", "/**\n * Sentient Loop Propose Tick \u2014 Single-pass Tier-2 proposal generator.\n *\n * Runs inside the daemon cron (every 2 hours) or standalone via\n * `cleo sentient propose run`. Orchestrates the three ingesters,\n * deduplicates candidates by fingerprint, applies the DB-enforced\n * rate limit, and writes accepted candidates as tasks with\n * `status='proposed'` and labels including `'sentient-tier2'`.\n *\n * Scoped IN:\n *   - Ingest from brain.db, nexus.db, and .cleo/audit/gates.jsonl\n *   - Transactional rate-limit check (BEGIN IMMEDIATE + COUNT + INSERT)\n *   - Kill-switch re-check at each checkpoint (Round 2 audit \u00A79)\n *   - tier2Enabled guard (default false \u2014 owner opt-in)\n *\n * Scoped OUT:\n *   - LLM calls (NONE \u2014 all proposal titles are structured templates)\n *   - Tier-3 sandbox/merge (blocked on T992+T993+T995)\n *\n * Title format enforcement:\n *   All proposal titles MUST match `/^\\[T2-(BRAIN|NEXUS|TEST)\\]/`.\n *   This is the prompt-injection defence from T1008 \u00A73.6 \u2014 no freeform\n *   LLM text can enter the task title column from the Tier-2 proposer.\n *\n * @task T1008\n * @see ADR-054 \u2014 Sentient Loop Tier-2\n */\n\nimport type { ProposalCandidate } from '@cleocode/contracts';\nimport { runBrainIngester } from './ingesters/brain-ingester.js';\nimport { runNexusIngester } from './ingesters/nexus-ingester.js';\nimport { runTestIngester } from './ingesters/test-ingester.js';\nimport {\n  countTodayProposals,\n  DEFAULT_DAILY_PROPOSAL_LIMIT,\n  transactionalInsertProposal,\n} from './proposal-rate-limiter.js';\nimport { patchSentientState, readSentientState } from './state.js';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/**\n * Regex that ALL proposal titles MUST match.\n * Enforces structured-template-only output (no freeform LLM text).\n */\nexport const PROPOSAL_TITLE_PATTERN = /^\\[T2-(BRAIN|NEXUS|TEST)\\]/;\n\n/**\n * Label applied to every Tier-2 proposal task.\n * Used by the rate limiter to identify proposals.\n */\nexport const TIER2_LABEL = 'sentient-tier2';\n\n// ---------------------------------------------------------------------------\n// Outcome types\n// ---------------------------------------------------------------------------\n\n/** Discriminant for the propose-tick outcome. */\nexport type ProposalTickOutcomeKind =\n  | 'killed' // killSwitch active\n  | 'disabled' // tier2Enabled = false\n  | 'rate-limited' // daily cap already reached\n  | 'no-candidates' // all ingesters returned empty\n  | 'wrote' // at least one proposal was written\n  | 'error'; // unexpected error\n\n/** Structured outcome of a single propose-tick pass. */\nexport interface ProposeTickOutcome {\n  /** Discriminant describing how the tick ended. */\n  kind: ProposalTickOutcomeKind;\n  /** Number of proposals written in this pass. */\n  written: number;\n  /** Current daily proposal count at the end of the pass. */\n  count: number;\n  /** Human-readable detail (one line). */\n  detail: string;\n}\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/** Options for {@link runProposeTick}. */\nexport interface ProposeTickOptions {\n  /** Absolute path to the project root (contains `.cleo/`). */\n  projectRoot: string;\n  /** Absolute path to sentient-state.json. */\n  statePath: string;\n  /**\n   * Override for the brain DB handle. Injected by tests to avoid\n   * opening a real brain.db. When omitted the real getBrainNativeDb() is used.\n   */\n  brainDb?: import('node:sqlite').DatabaseSync | null;\n  /**\n   * Override for the nexus DB handle. Injected by tests.\n   * When omitted the real getNexusNativeDb() is used.\n   */\n  nexusDb?: import('node:sqlite').DatabaseSync | null;\n  /**\n   * Override for the tasks DB handle (used by rate limiter + INSERT).\n   * Injected by tests. When omitted the real getNativeTasksDb() is used.\n   */\n  tasksDb?: import('node:sqlite').DatabaseSync | null;\n  /**\n   * Override the task ID allocator. Injected by tests.\n   * When omitted the real allocateNextTaskId() is used.\n   */\n  allocateTaskId?: () => Promise<string>;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Compute a deduplication fingerprint for a candidate.\n * Two candidates with the same source + sourceId are considered identical.\n */\nfunction fingerprint(candidate: ProposalCandidate): string {\n  return `${candidate.source}:${candidate.sourceId}`;\n}\n\n/**\n * Check whether the kill switch is currently active.\n */\nasync function killSwitchActive(statePath: string): Promise<boolean> {\n  const state = await readSentientState(statePath);\n  return state.killSwitch === true;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Run a single Tier-2 propose pass.\n *\n * Steps:\n *   1. Check killSwitch \u2192 abort if true\n *   2. Check tier2Enabled \u2192 abort if false\n *   3. Run all three ingesters in parallel\n *   4. Check killSwitch again (post-ingest checkpoint)\n *   5. Merge + deduplicate candidates by fingerprint\n *   6. Validate title format (must match PROPOSAL_TITLE_PATTERN)\n *   7. Score + take top-N candidates (N = limit - countTodayProposals)\n *   8. Check killSwitch again (pre-write checkpoint)\n *   9. For each candidate: transactional INSERT into tasks.db\n *  10. Update tier2Stats in state\n *\n * @param options - Propose tick options (see {@link ProposeTickOptions})\n * @returns Structured outcome describing how the pass ended.\n */\nexport async function runProposeTick(options: ProposeTickOptions): Promise<ProposeTickOutcome> {\n  const { projectRoot, statePath } = options;\n\n  // Checkpoint 1: killSwitch before any work\n  if (await killSwitchActive(statePath)) {\n    return { kind: 'killed', written: 0, count: 0, detail: 'killSwitch active before ingest' };\n  }\n\n  // Check tier2Enabled guard\n  const state = await readSentientState(statePath);\n  if (!state.tier2Enabled) {\n    return {\n      kind: 'disabled',\n      written: 0,\n      count: 0,\n      detail: 'tier2Enabled=false; enable via cleo sentient propose enable',\n    };\n  }\n\n  // Resolve DB handles\n  let brainDb: import('node:sqlite').DatabaseSync | null;\n  let nexusDb: import('node:sqlite').DatabaseSync | null;\n  let tasksNativeDb: import('node:sqlite').DatabaseSync | null;\n\n  if (options.brainDb !== undefined) {\n    brainDb = options.brainDb;\n  } else {\n    // Ensure brain.db is initialized before calling getBrainNativeDb\n    try {\n      const { getBrainDb, getBrainNativeDb } = await import('@cleocode/core/internal');\n      await getBrainDb(projectRoot);\n      brainDb = getBrainNativeDb();\n    } catch {\n      brainDb = null;\n    }\n  }\n\n  if (options.nexusDb !== undefined) {\n    nexusDb = options.nexusDb;\n  } else {\n    try {\n      const { getNexusNativeDb } = await import('@cleocode/core/internal');\n      nexusDb = getNexusNativeDb();\n    } catch {\n      nexusDb = null;\n    }\n  }\n\n  if (options.tasksDb !== undefined) {\n    tasksNativeDb = options.tasksDb;\n  } else {\n    const { getNativeDb, getDb } = await import('@cleocode/core/internal');\n    // Ensure tasks.db is initialized\n    await getDb(projectRoot);\n    tasksNativeDb = getNativeDb();\n  }\n\n  // Run all three ingesters in parallel\n  const [brainCandidates, nexusCandidates, testCandidates] = await Promise.all([\n    Promise.resolve(runBrainIngester(brainDb)),\n    Promise.resolve(runNexusIngester(nexusDb)),\n    Promise.resolve(runTestIngester(projectRoot)),\n  ]);\n\n  // Checkpoint 2: killSwitch after ingest\n  if (await killSwitchActive(statePath)) {\n    return {\n      kind: 'killed',\n      written: 0,\n      count: 0,\n      detail: 'killSwitch active after ingest phase',\n    };\n  }\n\n  // Merge + deduplicate by fingerprint\n  const seenFingerprints = new Set<string>();\n  const merged: ProposalCandidate[] = [];\n\n  for (const candidate of [...brainCandidates, ...nexusCandidates, ...testCandidates]) {\n    // Validate title format \u2014 reject candidates with non-template titles\n    if (!PROPOSAL_TITLE_PATTERN.test(candidate.title)) {\n      process.stderr.write(\n        `[sentient/propose-tick] Rejected candidate with invalid title format: \"${candidate.title}\"\\n`,\n      );\n      continue;\n    }\n\n    const fp = fingerprint(candidate);\n    if (seenFingerprints.has(fp)) continue;\n    seenFingerprints.add(fp);\n    merged.push(candidate);\n  }\n\n  if (merged.length === 0) {\n    return { kind: 'no-candidates', written: 0, count: 0, detail: 'no candidates from ingesters' };\n  }\n\n  // Sort by weight descending\n  merged.sort((a, b) => b.weight - a.weight);\n\n  // Determine how many slots remain today\n  const currentCount = tasksNativeDb ? countTodayProposals(tasksNativeDb) : 0;\n  const slotsRemaining = Math.max(0, DEFAULT_DAILY_PROPOSAL_LIMIT - currentCount);\n\n  if (slotsRemaining === 0) {\n    return {\n      kind: 'rate-limited',\n      written: 0,\n      count: currentCount,\n      detail: `daily limit reached (${currentCount}/${DEFAULT_DAILY_PROPOSAL_LIMIT})`,\n    };\n  }\n\n  // Take top-N candidates\n  const toWrite = merged.slice(0, slotsRemaining);\n\n  // Checkpoint 3: killSwitch before DB writes\n  if (await killSwitchActive(statePath)) {\n    return {\n      kind: 'killed',\n      written: 0,\n      count: currentCount,\n      detail: 'killSwitch active before write phase',\n    };\n  }\n\n  // Write proposals\n  let written = 0;\n\n  for (const candidate of toWrite) {\n    // Allocate task ID\n    let taskId: string;\n    if (options.allocateTaskId) {\n      taskId = await options.allocateTaskId();\n    } else {\n      const { allocateNextTaskId } = await import('@cleocode/core/internal');\n      taskId = await allocateNextTaskId(projectRoot);\n    }\n\n    const now = new Date().toISOString();\n    const labels = JSON.stringify([TIER2_LABEL, `source:${candidate.source}`]);\n\n    if (!tasksNativeDb) {\n      process.stderr.write('[sentient/propose-tick] tasks DB not available; skipping write\\n');\n      break;\n    }\n\n    // Use the SQL INSERT path (with metadata_json-equivalent stored in notes_json\n    // as a structured first element) and labels to mark the proposal.\n    // The rate limiter identifies proposals by: labels_json LIKE '%sentient-tier2%'\n    // This avoids needing a new column on the tasks table.\n    const notesJson = JSON.stringify([\n      JSON.stringify({\n        kind: 'proposal-meta',\n        proposedBy: 'sentient-tier2',\n        source: candidate.source,\n        sourceId: candidate.sourceId,\n        weight: candidate.weight,\n        proposedAt: now,\n      }),\n    ]);\n\n    const insertSql = `\n      INSERT INTO tasks (\n        id, title, description, status, priority,\n        labels_json, notes_json,\n        created_at, updated_at,\n        role, scope\n      ) VALUES (\n        :id, :title, :description, :status, :priority,\n        :labelsJson, :notesJson,\n        :createdAt, :updatedAt,\n        :role, :scope\n      )\n    `;\n\n    const insertParams = {\n      id: taskId,\n      title: candidate.title,\n      description: candidate.rationale,\n      status: 'proposed',\n      priority: 'medium',\n      labelsJson: labels,\n      notesJson,\n      createdAt: now,\n      updatedAt: now,\n      role: 'work',\n      scope: 'feature',\n    };\n\n    try {\n      const result = transactionalInsertProposal(\n        tasksNativeDb,\n        insertSql,\n        insertParams,\n        DEFAULT_DAILY_PROPOSAL_LIMIT,\n      );\n\n      if (result.inserted) {\n        written++;\n      } else if (result.reason === 'rate-limit') {\n        // Rate limit hit mid-loop \u2014 stop writing.\n        break;\n      }\n      // If 'busy', skip this one and continue.\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      process.stderr.write(`[sentient/propose-tick] INSERT failed for ${taskId}: ${message}\\n`);\n    }\n  }\n\n  // Update tier2Stats\n  if (written > 0) {\n    const latestState = await readSentientState(statePath);\n    await patchSentientState(statePath, {\n      tier2Stats: {\n        ...latestState.tier2Stats,\n        proposalsGenerated: latestState.tier2Stats.proposalsGenerated + written,\n      },\n    });\n  }\n\n  const finalCount = tasksNativeDb ? countTodayProposals(tasksNativeDb) : currentCount + written;\n\n  if (written === 0) {\n    return {\n      kind: 'no-candidates',\n      written: 0,\n      count: finalCount,\n      detail: 'candidates available but none written (rate limit or DB unavailable)',\n    };\n  }\n\n  return {\n    kind: 'wrote',\n    written,\n    count: finalCount,\n    detail: `wrote ${written} proposal(s) (${finalCount}/${DEFAULT_DAILY_PROPOSAL_LIMIT} today)`,\n  };\n}\n\n/**\n * Safe wrapper for {@link runProposeTick} \u2014 swallows unexpected exceptions.\n * Used by the daemon cron handler.\n *\n * @param options - Propose tick options\n * @returns The propose tick outcome, or an error outcome if the tick threw.\n */\nexport async function safeRunProposeTick(options: ProposeTickOptions): Promise<ProposeTickOutcome> {\n  try {\n    return await runProposeTick(options);\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return {\n      kind: 'error',\n      written: 0,\n      count: 0,\n      detail: `propose tick threw: ${message}`,\n    };\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["join"]
+}

package/dist/sentient/state.js

@@ -0,0 +1,85 @@
+// packages/core/src/sentient/state.ts
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+var SENTIENT_STATE_SCHEMA_VERSION = "1.0";
+var DEFAULT_SENTIENT_STATE = {
+  schemaVersion: SENTIENT_STATE_SCHEMA_VERSION,
+  pid: null,
+  startedAt: null,
+  lastTickAt: null,
+  killSwitch: false,
+  killSwitchReason: null,
+  stats: {
+    tasksPicked: 0,
+    tasksCompleted: 0,
+    tasksFailed: 0,
+    ticksExecuted: 0,
+    ticksKilled: 0
+  },
+  stuckTasks: {},
+  stuckTimestamps: [],
+  activeTaskId: null,
+  tier2Enabled: false,
+  tier2Stats: {
+    proposalsGenerated: 0,
+    proposalsAccepted: 0,
+    proposalsRejected: 0
+  }
+};
+async function readSentientState(statePath) {
+  try {
+    const raw = await readFile(statePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return {
+      ...DEFAULT_SENTIENT_STATE,
+      ...parsed,
+      stats: { ...DEFAULT_SENTIENT_STATE.stats, ...parsed.stats ?? {} },
+      stuckTasks: parsed.stuckTasks ?? {},
+      stuckTimestamps: parsed.stuckTimestamps ?? [],
+      tier2Enabled: parsed.tier2Enabled ?? false,
+      tier2Stats: { ...DEFAULT_SENTIENT_STATE.tier2Stats, ...parsed.tier2Stats ?? {} }
+    };
+  } catch {
+    return { ...DEFAULT_SENTIENT_STATE };
+  }
+}
+async function writeSentientState(statePath, state) {
+  const dir = dirname(statePath);
+  await mkdir(dir, { recursive: true });
+  const tmpPath = join(dir, `.sentient-state-${process.pid}.tmp`);
+  const json = JSON.stringify(state, null, 2);
+  await writeFile(tmpPath, json, "utf-8");
+  await rename(tmpPath, statePath);
+}
+async function patchSentientState(statePath, patch) {
+  const current = await readSentientState(statePath);
+  const updated = {
+    ...current,
+    ...patch,
+    stats: { ...current.stats, ...patch.stats ?? {} }
+  };
+  await writeSentientState(statePath, updated);
+  return updated;
+}
+async function incrementStats(statePath, delta) {
+  const current = await readSentientState(statePath);
+  const nextStats = {
+    tasksPicked: current.stats.tasksPicked + (delta.tasksPicked ?? 0),
+    tasksCompleted: current.stats.tasksCompleted + (delta.tasksCompleted ?? 0),
+    tasksFailed: current.stats.tasksFailed + (delta.tasksFailed ?? 0),
+    ticksExecuted: current.stats.ticksExecuted + (delta.ticksExecuted ?? 0),
+    ticksKilled: current.stats.ticksKilled + (delta.ticksKilled ?? 0)
+  };
+  const updated = { ...current, stats: nextStats };
+  await writeSentientState(statePath, updated);
+  return updated;
+}
+export {
+  DEFAULT_SENTIENT_STATE,
+  SENTIENT_STATE_SCHEMA_VERSION,
+  incrementStats,
+  patchSentientState,
+  readSentientState,
+  writeSentientState
+};
+//# sourceMappingURL=state.js.map

package/dist/sentient/state.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/sentient/state.ts"],
+  "sourcesContent": ["/**\n * Sentient Loop State \u2014 Persistent state for the Tier-1 autonomous daemon.\n *\n * Stored in `.cleo/sentient-state.json` (plain JSON, not SQLite) to avoid\n * SQLite WAL conflicts between the long-running daemon process and the\n * main CLEO CLI process. Human-readable for debugging.\n *\n * The file is gitignored (see .gitignore \u00A7.cleo/ section) and survives\n * restarts. Only `killSwitch`, `pid`, and `stats` fields are load-bearing\n * across process boundaries.\n *\n * @see ADR-054 \u2014 Sentient Loop Tier-1 (autonomous task execution)\n * @task T946\n */\n\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport type { Tier2Stats } from '@cleocode/contracts';\n\n/** Schema version for sentient-state.json. Bump on breaking field changes. */\nexport const SENTIENT_STATE_SCHEMA_VERSION = '1.0' as const;\n\n/**\n * Per-task failure/backoff tracking for stuck detection.\n * Keyed by task id in {@link SentientState.stuckTasks}.\n */\nexport interface StuckTaskRecord {\n  /** Number of consecutive failed spawn attempts for this task. */\n  attempts: number;\n  /** ISO-8601 timestamp of the most recent failure. */\n  lastFailureAt: string;\n  /** Unix epoch ms when the next retry becomes eligible. */\n  nextRetryAt: number;\n  /** Last captured failure reason (truncated to 500 chars). */\n  lastReason: string;\n}\n\n/**\n * Rolling counters persisted across daemon restarts.\n */\nexport interface SentientStats {\n  /** Total tasks picked by the loop since creation. */\n  tasksPicked: number;\n  /** Total tasks that completed successfully. */\n  tasksCompleted: number;\n  /** Total tasks whose spawn exited non-zero. */\n  tasksFailed: number;\n  /** Total ticks executed (including no-op ticks). */\n  ticksExecuted: number;\n  /** Total ticks aborted early because kill switch was active. */\n  ticksKilled: number;\n}\n\n/**\n * Persistent sentient daemon state.\n *\n * Design principles:\n * - `killSwitch` is the single load-bearing kill signal \u2014 the daemon re-checks\n *   it between every step of a tick, not just at tick start (Round 2 audit).\n * - `stuckTasks` keys are task ids; values encode backoff + failure counts.\n * - `stuckTimestamps` is a rolling 1-hour window used for the self-pause rule\n *   (5 stucks in 1 hour \u2192 killSwitch=true).\n * - `stats` fields are monotonic counters that only ever increase.\n */\nexport interface SentientState {\n  /** JSON schema version for forward-compatibility checks. */\n  schemaVersion: typeof SENTIENT_STATE_SCHEMA_VERSION;\n  /** PID of the currently running daemon process. null = daemon not running. */\n  pid: number | null;\n  /** ISO-8601 timestamp when the daemon was last started. */\n  startedAt: string | null;\n  /** ISO-8601 timestamp of the last completed tick (any outcome). */\n  lastTickAt: string | null;\n  /**\n   * Kill-switch flag. When true, the daemon re-checks at every step of a tick\n   * and exits cleanly without picking or spawning a task.\n   */\n  killSwitch: boolean;\n  /** Reason supplied when killSwitch was last set (diagnostic only). */\n  killSwitchReason: string | null;\n  /** Rolling counters; see {@link SentientStats}. */\n  stats: SentientStats;\n  /** Per-task backoff + failure metadata for retry/stuck detection. */\n  stuckTasks: Record<string, StuckTaskRecord>;\n  /**\n   * Unix-epoch-ms timestamps of `stuck` events within the last hour.\n   * When length \u2265 5 the daemon self-pauses (killSwitch=true).\n   */\n  stuckTimestamps: number[];\n  /**\n   * Currently-active task id (set while a spawn is in-flight, cleared afterward).\n   * Enables `status` to show the in-progress task during a long-running tick.\n   */\n  activeTaskId: string | null;\n  /**\n   * Tier-2 proposal queue enabled flag.\n   *\n   * Default: `false` \u2014 Tier 2 is OFF by default to prevent surprise proposal\n   * floods on first daemon start. Owner enables via `cleo sentient propose enable`\n   * (patches this flag). See ADR-054 \u00A7Tier-2.\n   *\n   * @task T1008\n   */\n  tier2Enabled: boolean;\n  /**\n   * Rolling counters for Tier-2 proposal activity.\n   *\n   * @task T1008\n   */\n  tier2Stats: Tier2Stats;\n}\n\n/** Default (empty) sentient state for fresh initialisation. */\nexport const DEFAULT_SENTIENT_STATE: SentientState = {\n  schemaVersion: SENTIENT_STATE_SCHEMA_VERSION,\n  pid: null,\n  startedAt: null,\n  lastTickAt: null,\n  killSwitch: false,\n  killSwitchReason: null,\n  stats: {\n    tasksPicked: 0,\n    tasksCompleted: 0,\n    tasksFailed: 0,\n    ticksExecuted: 0,\n    ticksKilled: 0,\n  },\n  stuckTasks: {},\n  stuckTimestamps: [],\n  activeTaskId: null,\n  tier2Enabled: false,\n  tier2Stats: {\n    proposalsGenerated: 0,\n    proposalsAccepted: 0,\n    proposalsRejected: 0,\n  },\n};\n\n/**\n * Read the sentient state from disk.\n *\n * Returns the default state if the file does not exist or is malformed.\n * Never throws \u2014 absence is not an error.\n *\n * @param statePath - Absolute path to sentient-state.json\n */\nexport async function readSentientState(statePath: string): Promise<SentientState> {\n  try {\n    const raw = await readFile(statePath, 'utf-8');\n    const parsed = JSON.parse(raw) as Partial<SentientState>;\n    return {\n      ...DEFAULT_SENTIENT_STATE,\n      ...parsed,\n      stats: { ...DEFAULT_SENTIENT_STATE.stats, ...(parsed.stats ?? {}) },\n      stuckTasks: parsed.stuckTasks ?? {},\n      stuckTimestamps: parsed.stuckTimestamps ?? [],\n      tier2Enabled: parsed.tier2Enabled ?? false,\n      tier2Stats: { ...DEFAULT_SENTIENT_STATE.tier2Stats, ...(parsed.tier2Stats ?? {}) },\n    };\n  } catch {\n    return { ...DEFAULT_SENTIENT_STATE };\n  }\n}\n\n/**\n * Write the sentient state to disk atomically via tmp-then-rename.\n *\n * Atomic write prevents partial reads if the daemon crashes mid-write.\n *\n * @param statePath - Absolute path to sentient-state.json\n * @param state - State to persist\n */\nexport async function writeSentientState(statePath: string, state: SentientState): Promise<void> {\n  const dir = dirname(statePath);\n  await mkdir(dir, { recursive: true });\n\n  const tmpPath = join(dir, `.sentient-state-${process.pid}.tmp`);\n  const json = JSON.stringify(state, null, 2);\n\n  await writeFile(tmpPath, json, 'utf-8');\n  await rename(tmpPath, statePath);\n}\n\n/**\n * Patch a subset of fields in the sentient state file.\n *\n * Reads current state, merges patch, writes back. Nested `stats` merges\n * with existing stats (never clobbered wholesale).\n *\n * @param statePath - Absolute path to sentient-state.json\n * @param patch - Partial state to merge over the existing state\n * @returns The merged state that was written to disk.\n */\nexport async function patchSentientState(\n  statePath: string,\n  patch: Partial<SentientState>,\n): Promise<SentientState> {\n  const current = await readSentientState(statePath);\n  const updated: SentientState = {\n    ...current,\n    ...patch,\n    stats: { ...current.stats, ...(patch.stats ?? {}) },\n  };\n  await writeSentientState(statePath, updated);\n  return updated;\n}\n\n/**\n * Increment stats counters atomically.\n *\n * @param statePath - Absolute path to sentient-state.json\n * @param delta - Partial stats to add to current counters\n */\nexport async function incrementStats(\n  statePath: string,\n  delta: Partial<SentientStats>,\n): Promise<SentientState> {\n  const current = await readSentientState(statePath);\n  const nextStats: SentientStats = {\n    tasksPicked: current.stats.tasksPicked + (delta.tasksPicked ?? 0),\n    tasksCompleted: current.stats.tasksCompleted + (delta.tasksCompleted ?? 0),\n    tasksFailed: current.stats.tasksFailed + (delta.tasksFailed ?? 0),\n    ticksExecuted: current.stats.ticksExecuted + (delta.ticksExecuted ?? 0),\n    ticksKilled: current.stats.ticksKilled + (delta.ticksKilled ?? 0),\n  };\n  const updated: SentientState = { ...current, stats: nextStats };\n  await writeSentientState(statePath, updated);\n  return updated;\n}\n"],
+  "mappings": ";AAeA,SAAS,OAAO,UAAU,QAAQ,iBAAiB;AACnD,SAAS,SAAS,YAAY;AAIvB,IAAM,gCAAgC;AA6FtC,IAAM,yBAAwC;AAAA,EACnD,eAAe;AAAA,EACf,KAAK;AAAA,EACL,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB,OAAO;AAAA,IACL,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,aAAa;AAAA,IACb,eAAe;AAAA,IACf,aAAa;AAAA,EACf;AAAA,EACA,YAAY,CAAC;AAAA,EACb,iBAAiB,CAAC;AAAA,EAClB,cAAc;AAAA,EACd,cAAc;AAAA,EACd,YAAY;AAAA,IACV,oBAAoB;AAAA,IACpB,mBAAmB;AAAA,IACnB,mBAAmB;AAAA,EACrB;AACF;AAUA,eAAsB,kBAAkB,WAA2C;AACjF,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,WAAW,OAAO;AAC7C,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,WAAO;AAAA,MACL,GAAG;AAAA,MACH,GAAG;AAAA,MACH,OAAO,EAAE,GAAG,uBAAuB,OAAO,GAAI,OAAO,SAAS,CAAC,EAAG;AAAA,MAClE,YAAY,OAAO,cAAc,CAAC;AAAA,MAClC,iBAAiB,OAAO,mBAAmB,CAAC;AAAA,MAC5C,cAAc,OAAO,gBAAgB;AAAA,MACrC,YAAY,EAAE,GAAG,uBAAuB,YAAY,GAAI,OAAO,cAAc,CAAC,EAAG;AAAA,IACnF;AAAA,EACF,QAAQ;AACN,WAAO,EAAE,GAAG,uBAAuB;AAAA,EACrC;AACF;AAUA,eAAsB,mBAAmB,WAAmB,OAAqC;AAC/F,QAAM,MAAM,QAAQ,SAAS;AAC7B,QAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AAEpC,QAAM,UAAU,KAAK,KAAK,mBAAmB,QAAQ,GAAG,MAAM;AAC9D,QAAM,OAAO,KAAK,UAAU,OAAO,MAAM,CAAC;AAE1C,QAAM,UAAU,SAAS,MAAM,OAAO;AACtC,QAAM,OAAO,SAAS,SAAS;AACjC;AAYA,eAAsB,mBACpB,WACA,OACwB;AACxB,QAAM,UAAU,MAAM,kBAAkB,SAAS;AACjD,QAAM,UAAyB;AAAA,IAC7B,GAAG;AAAA,IACH,GAAG;AAAA,IACH,OAAO,EAAE,GAAG,QAAQ,OAAO,GAAI,MAAM,SAAS,CAAC,EAAG;AAAA,EACpD;AACA,QAAM,mBAAmB,WAAW,OAAO;AAC3C,SAAO;AACT;AAQA,eAAsB,eACpB,WACA,OACwB;AACxB,QAAM,UAAU,MAAM,kBAAkB,SAAS;AACjD,QAAM,YAA2B;AAAA,IAC/B,aAAa,QAAQ,MAAM,eAAe,MAAM,eAAe;AAAA,IAC/D,gBAAgB,QAAQ,MAAM,kBAAkB,MAAM,kBAAkB;AAAA,IACxE,aAAa,QAAQ,MAAM,eAAe,MAAM,eAAe;AAAA,IAC/D,eAAe,QAAQ,MAAM,iBAAiB,MAAM,iBAAiB;AAAA,IACrE,aAAa,QAAQ,MAAM,eAAe,MAAM,eAAe;AAAA,EACjE;AACA,QAAM,UAAyB,EAAE,GAAG,SAAS,OAAO,UAAU;AAC9D,QAAM,mBAAmB,WAAW,OAAO;AAC3C,SAAO;AACT;",
+  "names": []
+}

package/dist/sentient/tick.js

@@ -0,0 +1,396 @@
+// packages/core/src/sentient/tick.ts
+import { spawn } from "node:child_process";
+
+// packages/core/src/sentient/state.ts
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+var SENTIENT_STATE_SCHEMA_VERSION = "1.0";
+var DEFAULT_SENTIENT_STATE = {
+  schemaVersion: SENTIENT_STATE_SCHEMA_VERSION,
+  pid: null,
+  startedAt: null,
+  lastTickAt: null,
+  killSwitch: false,
+  killSwitchReason: null,
+  stats: {
+    tasksPicked: 0,
+    tasksCompleted: 0,
+    tasksFailed: 0,
+    ticksExecuted: 0,
+    ticksKilled: 0
+  },
+  stuckTasks: {},
+  stuckTimestamps: [],
+  activeTaskId: null,
+  tier2Enabled: false,
+  tier2Stats: {
+    proposalsGenerated: 0,
+    proposalsAccepted: 0,
+    proposalsRejected: 0
+  }
+};
+async function readSentientState(statePath) {
+  try {
+    const raw = await readFile(statePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return {
+      ...DEFAULT_SENTIENT_STATE,
+      ...parsed,
+      stats: { ...DEFAULT_SENTIENT_STATE.stats, ...parsed.stats ?? {} },
+      stuckTasks: parsed.stuckTasks ?? {},
+      stuckTimestamps: parsed.stuckTimestamps ?? [],
+      tier2Enabled: parsed.tier2Enabled ?? false,
+      tier2Stats: { ...DEFAULT_SENTIENT_STATE.tier2Stats, ...parsed.tier2Stats ?? {} }
+    };
+  } catch {
+    return { ...DEFAULT_SENTIENT_STATE };
+  }
+}
+async function writeSentientState(statePath, state) {
+  const dir = dirname(statePath);
+  await mkdir(dir, { recursive: true });
+  const tmpPath = join(dir, `.sentient-state-${process.pid}.tmp`);
+  const json = JSON.stringify(state, null, 2);
+  await writeFile(tmpPath, json, "utf-8");
+  await rename(tmpPath, statePath);
+}
+async function patchSentientState(statePath, patch) {
+  const current = await readSentientState(statePath);
+  const updated = {
+    ...current,
+    ...patch,
+    stats: { ...current.stats, ...patch.stats ?? {} }
+  };
+  await writeSentientState(statePath, updated);
+  return updated;
+}
+async function incrementStats(statePath, delta) {
+  const current = await readSentientState(statePath);
+  const nextStats = {
+    tasksPicked: current.stats.tasksPicked + (delta.tasksPicked ?? 0),
+    tasksCompleted: current.stats.tasksCompleted + (delta.tasksCompleted ?? 0),
+    tasksFailed: current.stats.tasksFailed + (delta.tasksFailed ?? 0),
+    ticksExecuted: current.stats.ticksExecuted + (delta.ticksExecuted ?? 0),
+    ticksKilled: current.stats.ticksKilled + (delta.ticksKilled ?? 0)
+  };
+  const updated = { ...current, stats: nextStats };
+  await writeSentientState(statePath, updated);
+  return updated;
+}
+
+// packages/core/src/sentient/tick.ts
+var DREAM_VOLUME_THRESHOLD_DEFAULT = 50;
+var DREAM_IDLE_TICKS_DEFAULT = 5;
+var DEFAULT_ADAPTER = "claude-code";
+var RETRY_BACKOFF_MS = [3e4, 3e5, 18e5];
+var MAX_TASK_ATTEMPTS = RETRY_BACKOFF_MS.length;
+var SELF_PAUSE_STUCK_THRESHOLD = 5;
+var SELF_PAUSE_WINDOW_MS = 60 * 60 * 1e3;
+var SELF_PAUSE_REASON = "self-pause: 5 stuck tasks in 1 hour";
+var SPAWN_TIMEOUT_MS = 30 * 60 * 1e3;
+async function killSwitchActive(statePath) {
+  const state = await readSentientState(statePath);
+  return state.killSwitch === true;
+}
+function pruneStuckWindow(timestamps, now) {
+  const cutoff = now - SELF_PAUSE_WINDOW_MS;
+  return timestamps.filter((t) => t >= cutoff);
+}
+async function defaultPickTask(projectRoot) {
+  const { Cleo } = await import("@cleocode/core/sdk");
+  const { getReadyTasks } = await import("@cleocode/core/tasks");
+  const cleo = await Cleo.init(projectRoot);
+  const pending = await cleo.tasks.find({ status: "pending", limit: 500 });
+  const candidates = Array.isArray(pending?.data?.tasks) ? pending.data.tasks : [];
+  if (candidates.length === 0) return null;
+  const ready = getReadyTasks(candidates);
+  if (ready.length === 0) return null;
+  ready.sort((a, b) => a.id.localeCompare(b.id));
+  return ready[0];
+}
+function defaultSpawn(taskId, adapter, projectRoot) {
+  return new Promise((resolve) => {
+    const args = ["orchestrate", "spawn", taskId, "--adapter", adapter];
+    const child = spawn("cleo", args, {
+      cwd: projectRoot,
+      env: { ...process.env, CLEO_SENTIENT_SPAWN: "1" },
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString("utf-8");
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString("utf-8");
+    });
+    const timer = setTimeout(() => {
+      child.kill("SIGTERM");
+    }, SPAWN_TIMEOUT_MS);
+    child.on("error", (err) => {
+      clearTimeout(timer);
+      resolve({
+        exitCode: 1,
+        stdout,
+        stderr: stderr + `
+[sentient] spawn error: ${err.message}`
+      });
+    });
+    child.on("exit", (code) => {
+      clearTimeout(timer);
+      resolve({
+        exitCode: code ?? 1,
+        stdout: stdout.slice(-4e3),
+        stderr: stderr.slice(-4e3)
+      });
+    });
+  });
+}
+async function writeSuccessReceipt(projectRoot, taskId, exitCode) {
+  try {
+    const { Cleo } = await import("@cleocode/core/sdk");
+    const cleo = await Cleo.init(projectRoot);
+    await cleo.memory.observe({
+      text: `sentient-tier1: task ${taskId} completed successfully (exit=${exitCode})`,
+      title: `sentient-receipt: ${taskId}`
+    });
+  } catch {
+  }
+}
+var consecutiveIdleTicks = 0;
+async function maybeTriggerDream(projectRoot, opts, pickedTask) {
+  const volumeThreshold = opts.dreamVolumeThreshold ?? DREAM_VOLUME_THRESHOLD_DEFAULT;
+  const idleTicksThreshold = opts.dreamIdleTicks ?? DREAM_IDLE_TICKS_DEFAULT;
+  if (volumeThreshold <= 0 && idleTicksThreshold <= 0) return;
+  if (pickedTask) {
+    consecutiveIdleTicks = 0;
+  } else {
+    consecutiveIdleTicks += 1;
+  }
+  const dreamer = opts.checkAndDream ?? (async (root, dreamerOpts) => {
+    const { checkAndDream } = await import("@cleocode/core/internal");
+    return checkAndDream(root, dreamerOpts);
+  });
+  try {
+    await dreamer(projectRoot, {
+      volumeThreshold: volumeThreshold > 0 ? volumeThreshold : void 0,
+      inline: false
+    }).catch((err) => {
+      console.warn("[sentient/tick] dream trigger error:", err);
+    });
+  } catch (err) {
+    console.warn("[sentient/tick] dream trigger threw:", err);
+  }
+}
+async function writeFailureReceipt(projectRoot, taskId, attempt, exitCode, reason) {
+  try {
+    const { Cleo } = await import("@cleocode/core/sdk");
+    const cleo = await Cleo.init(projectRoot);
+    await cleo.memory.observe({
+      text: `sentient-tier1: task ${taskId} failed (attempt=${attempt}/${MAX_TASK_ATTEMPTS}, exit=${exitCode}). reason=${reason.slice(0, 500)}`,
+      title: `sentient-failure: ${taskId}`
+    });
+  } catch {
+  }
+}
+async function runTick(options) {
+  const { projectRoot, statePath } = options;
+  const adapter = options.adapter ?? DEFAULT_ADAPTER;
+  const now = Date.now();
+  if (await killSwitchActive(statePath)) {
+    await incrementStats(statePath, { ticksKilled: 1 });
+    await patchSentientState(statePath, { lastTickAt: new Date(now).toISOString() });
+    return { kind: "killed", taskId: null, detail: "killSwitch active before pick" };
+  }
+  const picker = options.pickTask ?? defaultPickTask;
+  let task;
+  try {
+    task = await picker(projectRoot);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    await incrementStats(statePath, { ticksExecuted: 1 });
+    await patchSentientState(statePath, { lastTickAt: new Date(now).toISOString() });
+    return { kind: "error", taskId: null, detail: `picker threw: ${message}` };
+  }
+  if (task === null) {
+    await incrementStats(statePath, { ticksExecuted: 1 });
+    await patchSentientState(statePath, { lastTickAt: new Date(now).toISOString() });
+    return { kind: "no-task", taskId: null, detail: "no unblocked tasks available" };
+  }
+  const preSpawnState = await readSentientState(statePath);
+  const existingStuck = preSpawnState.stuckTasks[task.id];
+  if (existingStuck && existingStuck.nextRetryAt > now) {
+    await incrementStats(statePath, { ticksExecuted: 1 });
+    await patchSentientState(statePath, { lastTickAt: new Date(now).toISOString() });
+    return {
+      kind: "backoff",
+      taskId: task.id,
+      detail: `task ${task.id} in backoff until ${new Date(existingStuck.nextRetryAt).toISOString()}`
+    };
+  }
+  if (await killSwitchActive(statePath)) {
+    await incrementStats(statePath, { ticksKilled: 1 });
+    await patchSentientState(statePath, { lastTickAt: new Date(now).toISOString() });
+    return { kind: "killed", taskId: task.id, detail: "killSwitch active before spawn" };
+  }
+  await incrementStats(statePath, { tasksPicked: 1 });
+  await patchSentientState(statePath, { activeTaskId: task.id });
+  let spawnResult;
+  if (options.dryRun === true) {
+    spawnResult = {
+      exitCode: 0,
+      stdout: "[dry-run] spawn skipped",
+      stderr: ""
+    };
+  } else {
+    try {
+      const spawner = options.spawn ?? ((tid, adp) => defaultSpawn(tid, adp, projectRoot));
+      spawnResult = await spawner(task.id, adapter);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      spawnResult = { exitCode: 1, stdout: "", stderr: `spawn threw: ${message}` };
+    }
+  }
+  if (await killSwitchActive(statePath)) {
+    await incrementStats(statePath, { ticksKilled: 1 });
+    await patchSentientState(statePath, {
+      lastTickAt: new Date(Date.now()).toISOString(),
+      activeTaskId: null
+    });
+    return {
+      kind: "killed",
+      taskId: task.id,
+      detail: "killSwitch active after spawn; result not recorded"
+    };
+  }
+  if (spawnResult.exitCode === 0) {
+    await writeSuccessReceipt(projectRoot, task.id, spawnResult.exitCode);
+    const post2 = await readSentientState(statePath);
+    const { [task.id]: _removed, ...rest } = post2.stuckTasks;
+    void _removed;
+    await patchSentientState(statePath, {
+      stuckTasks: rest,
+      activeTaskId: null,
+      lastTickAt: new Date(Date.now()).toISOString()
+    });
+    await incrementStats(statePath, { tasksCompleted: 1, ticksExecuted: 1 });
+    return {
+      kind: "success",
+      taskId: task.id,
+      detail: `task ${task.id} completed (exit=0)`
+    };
+  }
+  const currentAttempts = existingStuck?.attempts ?? 0;
+  const nextAttempts = currentAttempts + 1;
+  const failureReason = spawnResult.stderr.slice(-500) || `exit=${spawnResult.exitCode}`;
+  await writeFailureReceipt(
+    projectRoot,
+    task.id,
+    nextAttempts,
+    spawnResult.exitCode,
+    failureReason
+  );
+  await incrementStats(statePath, { tasksFailed: 1, ticksExecuted: 1 });
+  if (nextAttempts >= MAX_TASK_ATTEMPTS) {
+    const windowed = pruneStuckWindow(preSpawnState.stuckTimestamps, now);
+    windowed.push(now);
+    const stuckRecord2 = {
+      attempts: nextAttempts,
+      lastFailureAt: new Date(now).toISOString(),
+      nextRetryAt: Number.MAX_SAFE_INTEGER,
+      // owner-only release
+      lastReason: failureReason
+    };
+    const post2 = await readSentientState(statePath);
+    const updatedStuckTasks = {
+      ...post2.stuckTasks,
+      [task.id]: stuckRecord2
+    };
+    const shouldSelfPause = windowed.length >= SELF_PAUSE_STUCK_THRESHOLD;
+    await patchSentientState(statePath, {
+      stuckTasks: updatedStuckTasks,
+      stuckTimestamps: windowed,
+      activeTaskId: null,
+      lastTickAt: new Date(now).toISOString(),
+      ...shouldSelfPause ? { killSwitch: true, killSwitchReason: SELF_PAUSE_REASON } : {}
+    });
+    if (shouldSelfPause) {
+      return {
+        kind: "self-paused",
+        taskId: task.id,
+        detail: `task ${task.id} is stuck; self-pause fired (${windowed.length}/${SELF_PAUSE_STUCK_THRESHOLD} stucks in window)`
+      };
+    }
+    return {
+      kind: "stuck",
+      taskId: task.id,
+      detail: `task ${task.id} stuck after ${nextAttempts} attempts; owner must re-enable via \`cleo sentient resume\``
+    };
+  }
+  const backoff = RETRY_BACKOFF_MS[nextAttempts - 1] ?? RETRY_BACKOFF_MS[RETRY_BACKOFF_MS.length - 1];
+  const stuckRecord = {
+    attempts: nextAttempts,
+    lastFailureAt: new Date(now).toISOString(),
+    nextRetryAt: now + backoff,
+    lastReason: failureReason
+  };
+  const post = await readSentientState(statePath);
+  await patchSentientState(statePath, {
+    stuckTasks: { ...post.stuckTasks, [task.id]: stuckRecord },
+    activeTaskId: null,
+    lastTickAt: new Date(now).toISOString()
+  });
+  return {
+    kind: "failure",
+    taskId: task.id,
+    detail: `task ${task.id} failed (attempt=${nextAttempts}/${MAX_TASK_ATTEMPTS}); retry scheduled at ${new Date(now + backoff).toISOString()}`
+  };
+}
+async function safeRunTick(options) {
+  let outcome;
+  try {
+    outcome = await runTick(options);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    try {
+      await incrementStats(options.statePath, { ticksExecuted: 1 });
+    } catch {
+    }
+    outcome = { kind: "error", taskId: null, detail: `tick threw: ${message}` };
+  }
+  const pickedTask = outcome.kind !== "no-task" && outcome.kind !== "killed" && outcome.kind !== "error" && outcome.taskId !== null;
+  await maybeTriggerDream(options.projectRoot, options, pickedTask).catch(() => {
+  });
+  return outcome;
+}
+function isFailureOutcome(outcome) {
+  return outcome.kind === "failure" || outcome.kind === "stuck" || outcome.kind === "self-paused";
+}
+async function getKillStatus(statePath) {
+  const state = await readSentientState(statePath);
+  return { killSwitch: state.killSwitch, killSwitchReason: state.killSwitchReason };
+}
+function _resetDreamTickState() {
+  consecutiveIdleTicks = 0;
+}
+function _getConsecutiveIdleTicks() {
+  return consecutiveIdleTicks;
+}
+export {
+  DEFAULT_ADAPTER,
+  DREAM_IDLE_TICKS_DEFAULT,
+  DREAM_VOLUME_THRESHOLD_DEFAULT,
+  MAX_TASK_ATTEMPTS,
+  RETRY_BACKOFF_MS,
+  SELF_PAUSE_REASON,
+  SELF_PAUSE_STUCK_THRESHOLD,
+  SELF_PAUSE_WINDOW_MS,
+  SPAWN_TIMEOUT_MS,
+  _getConsecutiveIdleTicks,
+  _resetDreamTickState,
+  getKillStatus,
+  isFailureOutcome,
+  runTick,
+  safeRunTick
+};
+//# sourceMappingURL=tick.js.map