@cleocode/core 2026.4.98 → 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.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Sentient Loop State — Persistent state for the Tier-1 autonomous daemon.
+ *
+ * Stored in `.cleo/sentient-state.json` (plain JSON, not SQLite) to avoid
+ * SQLite WAL conflicts between the long-running daemon process and the
+ * main CLEO CLI process. Human-readable for debugging.
+ *
+ * The file is gitignored (see .gitignore §.cleo/ section) and survives
+ * restarts. Only `killSwitch`, `pid`, and `stats` fields are load-bearing
+ * across process boundaries.
+ *
+ * @see ADR-054 — Sentient Loop Tier-1 (autonomous task execution)
+ * @task T946
+ */
+import type { Tier2Stats } from '@cleocode/contracts';
+/** Schema version for sentient-state.json. Bump on breaking field changes. */
+export declare const SENTIENT_STATE_SCHEMA_VERSION: "1.0";
+/**
+ * Per-task failure/backoff tracking for stuck detection.
+ * Keyed by task id in {@link SentientState.stuckTasks}.
+ */
+export interface StuckTaskRecord {
+    /** Number of consecutive failed spawn attempts for this task. */
+    attempts: number;
+    /** ISO-8601 timestamp of the most recent failure. */
+    lastFailureAt: string;
+    /** Unix epoch ms when the next retry becomes eligible. */
+    nextRetryAt: number;
+    /** Last captured failure reason (truncated to 500 chars). */
+    lastReason: string;
+}
+/**
+ * Rolling counters persisted across daemon restarts.
+ */
+export interface SentientStats {
+    /** Total tasks picked by the loop since creation. */
+    tasksPicked: number;
+    /** Total tasks that completed successfully. */
+    tasksCompleted: number;
+    /** Total tasks whose spawn exited non-zero. */
+    tasksFailed: number;
+    /** Total ticks executed (including no-op ticks). */
+    ticksExecuted: number;
+    /** Total ticks aborted early because kill switch was active. */
+    ticksKilled: number;
+}
+/**
+ * Persistent sentient daemon state.
+ *
+ * Design principles:
+ * - `killSwitch` is the single load-bearing kill signal — the daemon re-checks
+ *   it between every step of a tick, not just at tick start (Round 2 audit).
+ * - `stuckTasks` keys are task ids; values encode backoff + failure counts.
+ * - `stuckTimestamps` is a rolling 1-hour window used for the self-pause rule
+ *   (5 stucks in 1 hour → killSwitch=true).
+ * - `stats` fields are monotonic counters that only ever increase.
+ */
+export interface SentientState {
+    /** JSON schema version for forward-compatibility checks. */
+    schemaVersion: typeof SENTIENT_STATE_SCHEMA_VERSION;
+    /** PID of the currently running daemon process. null = daemon not running. */
+    pid: number | null;
+    /** ISO-8601 timestamp when the daemon was last started. */
+    startedAt: string | null;
+    /** ISO-8601 timestamp of the last completed tick (any outcome). */
+    lastTickAt: string | null;
+    /**
+     * Kill-switch flag. When true, the daemon re-checks at every step of a tick
+     * and exits cleanly without picking or spawning a task.
+     */
+    killSwitch: boolean;
+    /** Reason supplied when killSwitch was last set (diagnostic only). */
+    killSwitchReason: string | null;
+    /** Rolling counters; see {@link SentientStats}. */
+    stats: SentientStats;
+    /** Per-task backoff + failure metadata for retry/stuck detection. */
+    stuckTasks: Record<string, StuckTaskRecord>;
+    /**
+     * Unix-epoch-ms timestamps of `stuck` events within the last hour.
+     * When length ≥ 5 the daemon self-pauses (killSwitch=true).
+     */
+    stuckTimestamps: number[];
+    /**
+     * Currently-active task id (set while a spawn is in-flight, cleared afterward).
+     * Enables `status` to show the in-progress task during a long-running tick.
+     */
+    activeTaskId: string | null;
+    /**
+     * Tier-2 proposal queue enabled flag.
+     *
+     * Default: `false` — Tier 2 is OFF by default to prevent surprise proposal
+     * floods on first daemon start. Owner enables via `cleo sentient propose enable`
+     * (patches this flag). See ADR-054 §Tier-2.
+     *
+     * @task T1008
+     */
+    tier2Enabled: boolean;
+    /**
+     * Rolling counters for Tier-2 proposal activity.
+     *
+     * @task T1008
+     */
+    tier2Stats: Tier2Stats;
+}
+/** Default (empty) sentient state for fresh initialisation. */
+export declare const DEFAULT_SENTIENT_STATE: SentientState;
+/**
+ * Read the sentient state from disk.
+ *
+ * Returns the default state if the file does not exist or is malformed.
+ * Never throws — absence is not an error.
+ *
+ * @param statePath - Absolute path to sentient-state.json
+ */
+export declare function readSentientState(statePath: string): Promise<SentientState>;
+/**
+ * Write the sentient state to disk atomically via tmp-then-rename.
+ *
+ * Atomic write prevents partial reads if the daemon crashes mid-write.
+ *
+ * @param statePath - Absolute path to sentient-state.json
+ * @param state - State to persist
+ */
+export declare function writeSentientState(statePath: string, state: SentientState): Promise<void>;
+/**
+ * Patch a subset of fields in the sentient state file.
+ *
+ * Reads current state, merges patch, writes back. Nested `stats` merges
+ * with existing stats (never clobbered wholesale).
+ *
+ * @param statePath - Absolute path to sentient-state.json
+ * @param patch - Partial state to merge over the existing state
+ * @returns The merged state that was written to disk.
+ */
+export declare function patchSentientState(statePath: string, patch: Partial<SentientState>): Promise<SentientState>;
+/**
+ * Increment stats counters atomically.
+ *
+ * @param statePath - Absolute path to sentient-state.json
+ * @param delta - Partial stats to add to current counters
+ */
+export declare function incrementStats(statePath: string, delta: Partial<SentientStats>): Promise<SentientState>;
+//# sourceMappingURL=state.d.ts.map

package/dist/sentient/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/sentient/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,EAAG,KAAc,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,aAAa,EAAE,OAAO,6BAA6B,CAAC;IACpD,8EAA8E;IAC9E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mDAAmD;IACnD,KAAK,EAAE,aAAa,CAAC;IACrB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C;;;OAGG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;;;;OAQG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,aAuBpC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAgBjF;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/F;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC,CASxB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC,CAYxB"}

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.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Sentient Loop Tick — Single-iteration tick runner for the Tier-1 daemon.
+ *
+ * A tick is one complete pass of:
+ *   1. Check killSwitch (abort if true)
+ *   2. Pick an unblocked task via @cleocode/core/sdk
+ *   3. Check killSwitch again (abort if true)
+ *   4. Spawn worker via `cleo orchestrate spawn <taskId> --adapter <adapter>`
+ *   5. Check killSwitch again before recording result
+ *   6. Record success (receipt + stats) or failure (retry/backoff)
+ *
+ * Each step re-reads the state file so that a killSwitch flipped mid-tick is
+ * honoured on the very next instruction (Round 2 audit §1: "mid-experiment
+ * kill limbo").
+ *
+ * Rate limit: driven by the cron schedule (`*\/5 * * * *` → ≤12 ticks/hour ≤
+ * 12 spawns/hour). No in-tick sleep is required — cron provides the cadence.
+ *
+ * Scoped OUT: Tier 2 (propose) and Tier 3 (sandbox auto-merge) per ADR-054.
+ *
+ * @task T946
+ * @see ADR-054 — Sentient Loop Tier-1
+ */
+import type { Task } from '@cleocode/contracts';
+import { type SentientState } from './state.js';
+/**
+ * Number of new brain observations since the last consolidation that causes
+ * the tick loop to trigger a dream cycle (volume tier).
+ * Configurable via the injected `dreamVolumeThreshold` option.
+ */
+export declare const DREAM_VOLUME_THRESHOLD_DEFAULT = 50;
+/**
+ * Number of consecutive no-task ticks before the idle dream trigger fires.
+ * Represents "N idle ticks" — when no task has been picked for this many
+ * consecutive ticks, the system is considered sufficiently idle.
+ */
+export declare const DREAM_IDLE_TICKS_DEFAULT = 5;
+/** Default adapter used when spawning workers. */
+export declare const DEFAULT_ADAPTER: "claude-code";
+/**
+ * Backoff delays between successive retries for the same task (milliseconds).
+ * Index n = delay before attempt n+1. After exhaustion the task is `stuck`.
+ * 30 s → 5 min → 30 min, then the task is marked stuck.
+ */
+export declare const RETRY_BACKOFF_MS: readonly number[];
+/**
+ * Maximum spawn attempts per task before it is classified as `stuck`.
+ * Matches RETRY_BACKOFF_MS.length but surfaced as a named constant for
+ * readability in tests and status output.
+ */
+export declare const MAX_TASK_ATTEMPTS: number;
+/**
+ * Threshold for self-pause: if this many tasks become `stuck` within a
+ * rolling 1-hour window, the daemon flips killSwitch=true and exits.
+ */
+export declare const SELF_PAUSE_STUCK_THRESHOLD = 5;
+/** Rolling window (ms) used for stuck-rate calculation. */
+export declare const SELF_PAUSE_WINDOW_MS: number;
+/** Reason stored on the state file when self-pause fires. */
+export declare const SELF_PAUSE_REASON = "self-pause: 5 stuck tasks in 1 hour";
+/** Max wall-clock time for a single spawn before forceful kill (30 min). */
+export declare const SPAWN_TIMEOUT_MS: number;
+/** Discriminant for the tick outcome. */
+export type TickOutcomeKind = 'killed' | 'no-task' | 'backoff' | 'success' | 'failure' | 'stuck' | 'self-paused' | 'error';
+/** Structured outcome of a single tick. */
+export interface TickOutcome {
+    /** Discriminant describing how the tick ended. */
+    kind: TickOutcomeKind;
+    /** Task id that was the subject of this tick (if any). */
+    taskId: string | null;
+    /** Human-readable detail (one line). */
+    detail: string;
+}
+/** Options for {@link runTick}. */
+export interface TickOptions {
+    /** Absolute path to the project root (contains `.cleo/`). */
+    projectRoot: string;
+    /** Absolute path to sentient-state.json. */
+    statePath: string;
+    /**
+     * Adapter to pass to `cleo orchestrate spawn --adapter`. Defaults to
+     * {@link DEFAULT_ADAPTER}. Overridden in tests via options.spawn.
+     */
+    adapter?: string;
+    /**
+     * Dry-run mode: skip the actual `cleo orchestrate spawn` subprocess and
+     * treat the pick as a no-op (still records picked stat). Used by
+     * `cleo sentient tick --dry-run`.
+     */
+    dryRun?: boolean;
+    /**
+     * Override for the spawn function — lets tests inject a deterministic fake
+     * without forking real subprocesses. Must resolve to an exit code.
+     *
+     * When omitted, the default implementation spawns
+     * `cleo orchestrate spawn <taskId> --adapter <adapter>` and resolves with
+     * the child's exit code.
+     */
+    spawn?: (taskId: string, adapter: string) => Promise<SpawnResult>;
+    /**
+     * Override for the "pick next unblocked task" source. Lets tests return
+     * a deterministic task without constructing a SQLite fixture.
+     */
+    pickTask?: (projectRoot: string) => Promise<Task | null>;
+    /**
+     * New observation count since last consolidation that triggers the volume
+     * dream cycle. Defaults to {@link DREAM_VOLUME_THRESHOLD_DEFAULT}.
+     * Pass 0 to disable volume trigger. Injected by tests.
+     */
+    dreamVolumeThreshold?: number;
+    /**
+     * Number of consecutive no-task ticks before the idle dream trigger fires.
+     * Defaults to {@link DREAM_IDLE_TICKS_DEFAULT}.
+     * Pass 0 to disable idle trigger. Injected by tests.
+     */
+    dreamIdleTicks?: number;
+    /**
+     * Override for the dream trigger function — lets tests assert dream calls
+     * without touching the real brain.db stack.
+     * Signature mirrors `checkAndDream` from `@cleocode/core`.
+     */
+    checkAndDream?: (projectRoot: string, opts?: {
+        volumeThreshold?: number;
+        inline?: boolean;
+    }) => Promise<{
+        triggered: boolean;
+        tier: string | null;
+        skippedReason?: string;
+    }>;
+}
+/** Result of a spawn invocation. */
+export interface SpawnResult {
+    /** Process exit code (0 = success). */
+    exitCode: number;
+    /** Captured stdout, truncated by the caller if needed. */
+    stdout: string;
+    /** Captured stderr, truncated by the caller if needed. */
+    stderr: string;
+}
+/**
+ * Run a single tick of the sentient loop.
+ *
+ * Every checkpoint re-reads state so that a killSwitch flipped mid-tick is
+ * honoured on the next instruction.
+ *
+ * @param options - Tick options (see {@link TickOptions})
+ * @returns Structured outcome describing how the tick ended.
+ */
+export declare function runTick(options: TickOptions): Promise<TickOutcome>;
+/**
+ * Convenience wrapper used by the daemon cron handler and the `cleo sentient
+ * tick` CLI command. Reads state, runs a tick, swallows any unexpected
+ * exception so the cron scheduler never sees a rejection.
+ *
+ * After the tick completes, evaluates volume + idle dream triggers via
+ * {@link maybeTriggerDream}. Dream errors are swallowed independently so
+ * they never affect the tick outcome.
+ *
+ * @param options - Tick options
+ * @returns The tick outcome (or an `error` outcome if the tick itself threw).
+ */
+export declare function safeRunTick(options: TickOptions): Promise<TickOutcome>;
+/**
+ * Type-narrowing helper used by tests and status rendering to identify tick
+ * outcomes that consumed a retry attempt.
+ */
+export declare function isFailureOutcome(outcome: TickOutcome): outcome is TickOutcome & {
+    kind: 'failure' | 'stuck' | 'self-paused';
+};
+/**
+ * Returns a shallow view of the current state's kill status.
+ * Exposed for diagnostic/test consumers.
+ */
+export declare function getKillStatus(statePath: string): Promise<Pick<SentientState, 'killSwitch' | 'killSwitchReason'>>;
+/**
+ * Reset dream-cycle in-process state.
+ *
+ * Intended for test teardown only — clears `consecutiveIdleTicks` so that
+ * successive test cases start from a clean slate.
+ *
+ * @internal
+ */
+export declare function _resetDreamTickState(): void;
+/**
+ * Return the current consecutive-idle-tick counter value.
+ *
+ * Read-only accessor for test assertions. The counter is reset to 0 whenever
+ * a task is picked, and incremented on each no-task tick.
+ *
+ * @internal
+ */
+export declare function _getConsecutiveIdleTicks(): number;
+//# sourceMappingURL=tick.d.ts.map

package/dist/sentient/tick.d.ts.map

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