@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/core/storage/sqlite.js

@@ -14,7 +14,6 @@
  *   injections.ts    — injections
  *   routing.ts       — routing_events + experiment_assignments
  *   skills.ts        — skill_invocations + workflow 聚合
- *   token-usage.ts   — token_usage
  *   maintenance.ts   — 清理 / VACUUM
  */
 import { EventEmitter } from 'node:events';
@@ -25,9 +24,14 @@ import { TaskOperations } from './tasks.js';
 import { InjectionOperations } from './injections.js';
 import { RoutingOperations } from './routing.js';
 import { SkillOperations } from './skills.js';
-import { TokenUsageOperations } from './token-usage.js';
 import { MaintenanceOperations } from './maintenance.js';
+import { KnowledgeOperations } from './knowledge.js';
+import { ForgeConfigOperations } from './forge-config.js';
+import { ToolInterceptsOperations } from './tool-intercepts.js';
+import { DecisionsOperations } from './decisions.js';
+import { FeedbackOperations } from './feedback.js';
 import { logger } from '../utils/logger.js';
+export { toSpecLikeRow, DECISION_OUTCOMES } from './decisions.js';
 export class SQLiteStorage extends EventEmitter {
     base;
     events;
@@ -36,8 +40,12 @@ export class SQLiteStorage extends EventEmitter {
     injections;
     routing;
     skills;
-    tokenUsage;
     maintenance;
+    knowledge;
+    forgeConfig;
+    toolIntercepts;
+    decisions;
+    feedback;
     constructor(dbPath) {
         super();
         this.base = new SQLiteBase(dbPath);
@@ -48,8 +56,12 @@ export class SQLiteStorage extends EventEmitter {
         this.injections = new InjectionOperations(db);
         this.routing = new RoutingOperations(db);
         this.skills = new SkillOperations(db);
-        this.tokenUsage = new TokenUsageOperations(db);
         this.maintenance = new MaintenanceOperations(db, dbPath);
+        this.knowledge = new KnowledgeOperations(db);
+        this.forgeConfig = new ForgeConfigOperations(db);
+        this.toolIntercepts = new ToolInterceptsOperations(db);
+        this.decisions = new DecisionsOperations(db);
+        this.feedback = new FeedbackOperations(db);
     }
     // ── Database accessors ─────────────────────────────────────────────────
     /** @internal 见 SQLiteBase.getDatabase 注释。Routes/Handlers/Analytics 禁止调用。 */
@@ -60,10 +72,26 @@ export class SQLiteStorage extends EventEmitter {
     queryEvents(filter) {
         return this.events.queryEvents(filter);
     }
+    /** Point lookup of a single event by event_id (used by pipeline ?event_id). */
+    getEventById(eventId) { return this.events.getEventById(eventId); }
+    /** Backfill ai_response (plain text, NOT gzip) for a violation window — spec 1446. */
+    updateEventAiResponse(eventId, text) { this.events.updateEventAiResponse(eventId, text); }
+    /** Inline-edit (PostToolUse Edit/Write/NotebookEdit) rows for a session in an ISO window — spec 1446. */
+    queryInlineEditEvents(opts) {
+        return this.events.queryInlineEditEvents(opts);
+    }
     countEvents(filter) { return this.events.countEvents(filter); }
     searchEvents(filter) {
         return this.events.searchEvents(filter);
     }
+    /**
+     * audit F5 — slim event reader for /api/insights/timeline. Drops
+     * `tool_output` + `ai_response` from the SELECT to keep MB-scale PostToolUse
+     * rows out of the response payload. See EventOperations.queryEventsTimeline.
+     */
+    queryEventsTimeline(filter) {
+        return this.events.queryEventsTimeline(filter);
+    }
     // ── H2: Event aggregates (前 routes/handlers/analytics 越权 SQL) ──
     countAllEvents() { return this.events.countAllEvents(); }
     aggregateToolUsage(opts) {
@@ -81,6 +109,26 @@ export class SQLiteStorage extends EventEmitter {
     aggregateToolUsageBySession(session_id) {
         return this.events.aggregateToolUsageBySession(session_id);
     }
+    aggregateAgentSpawns(opts) {
+        return this.events.aggregateAgentSpawns(opts);
+    }
+    /** decision c425f26f: cross-task workflow spawns grouped by decision_id. */
+    queryWorkflowSpawnsByDecisionId(decisionId) {
+        return this.events.queryWorkflowSpawnsByDecisionId(decisionId);
+    }
+    /** decision c425f26f: resolve a task's home decision_id (plaintext column, no gzip). */
+    queryTaskDecisionId(taskId) {
+        return this.events.queryTaskDecisionId(taskId);
+    }
+    /**
+     * decision c425f26f (user ruling #3): re-runnable backfill of the plaintext
+     * events.decision_id / subagent_type columns. Boot-time runs the gated variant
+     * automatically; this exposes the engine for `cf maintenance backfill-spawn-fields`.
+     * Returns the number of rows updated.
+     */
+    backfillEventsDecisionId() {
+        return this.base.backfillEventsDecisionId();
+    }
     countActiveDays(opts) {
         return this.events.countActiveDays(opts);
     }
@@ -99,6 +147,21 @@ export class SQLiteStorage extends EventEmitter {
     queryEventsByTimeRange(opts) {
         return this.events.queryEventsByTimeRange(opts);
     }
+    // ── Event TTL sweep ops (db-size optimization 2026-05-26) ──────────────
+    /**
+     * NULL out `tool_input` for events older than `cutoffIso`, capped to `maxRows`
+     * per call. See EventOperations.expireToolInputBatch.
+     */
+    expireToolInputBatch(cutoffIso, maxRows) {
+        return this.events.expireToolInputBatch(cutoffIso, maxRows);
+    }
+    /**
+     * DELETE events older than `cutoffIso` (plus orphan task_events), capped to
+     * `maxRows`. See EventOperations.deleteEventsByCutoff.
+     */
+    deleteEventsByCutoff(cutoffIso, maxRows) {
+        return this.events.deleteEventsByCutoff(cutoffIso, maxRows);
+    }
     // ── Session operations ─────────────────────────────────────────────────
     upsertSession(event) { this.sessions.upsertSession(event); }
     querySessions(filter = {}) {
@@ -106,6 +169,10 @@ export class SQLiteStorage extends EventEmitter {
     }
     getSession(id) { return this.sessions.getSession(id); }
     getSessionByPrefix(idPrefix) { return this.sessions.getSessionByPrefix(idPrefix); }
+    /** Phase 3 timeline endpoint: session row + rollup metric columns + outcome. */
+    getSessionWithMetrics(idOrPrefix) {
+        return this.sessions.getSessionWithMetrics(idOrPrefix);
+    }
     // ── H2: Session aggregates ──
     countAllSessions() { return this.sessions.countAllSessions(); }
     aggregateDailySessionCounts(opts) {
@@ -117,24 +184,118 @@ export class SQLiteStorage extends EventEmitter {
     countSessionsByRange(opts) {
         return this.sessions.countSessionsByRange(opts);
     }
+    updateSessionOutcome(sessionId, updates) {
+        this.sessions.updateSessionOutcome(sessionId, updates);
+    }
+    /** Phase 9.5 idle-session sweeper input. */
+    queryIdleUnclassifiedSessions(cutoffIso, limit) {
+        return this.sessions.queryIdleUnclassifiedSessions(cutoffIso, limit);
+    }
+    updateSessionMetrics(sessionId, updates) {
+        this.sessions.updateSessionMetrics(sessionId, updates);
+    }
+    /**
+     * Session-centric agent board projection (v2). See SessionOperations.queryAgentBoardSessions.
+     */
+    queryAgentBoardSessions(opts) {
+        return this.sessions.queryAgentBoardSessions(opts);
+    }
     // ── Injection operations ───────────────────────────────────────────────
     writeInjection(injection) { this.injections.writeInjection(injection); }
     queryInjections(filter = {}) {
         return this.injections.queryInjections(filter);
     }
+    /**
+     * Phase 2 metrics rollup helper. Count injections for one session, optionally
+     * filtered by source_handler (e.g. 'UserPromptSubmitHandler:kb' → KB injects).
+     */
+    countInjectionsBySessionByHandler(session_id, source_handler) {
+        return this.injections.countBySession(session_id, source_handler);
+    }
+    /** Phase 2d pipeline-view batch helper. See InjectionOperations.queryBySessions. */
+    queryInjectionsBySessions(sessionIds) {
+        return this.injections.queryBySessions(sessionIds);
+    }
+    /**
+     * KB 采纳 telemetry（decision 148f7a0a）。
+     * See InjectionOperations.writeKbInjectionAdoption.
+     */
+    writeKbInjectionAdoption(session_id, adopted_at) {
+        return this.injections.writeKbInjectionAdoption(session_id, adopted_at);
+    }
+    /** KB 采纳率读路径（decision 148f7a0a）。See InjectionOperations.countKbAdoption. */
+    countKbAdoption(sinceIso) {
+        return this.injections.countKbAdoption(sinceIso);
+    }
+    /**
+     * LOOP HINT 采纳 telemetry（decision e7d13697, Option C）。
+     * See InjectionOperations.writeLoopHintAdoption.
+     */
+    writeLoopHintAdoption(session_id, adopted_at) {
+        return this.injections.writeLoopHintAdoption(session_id, adopted_at);
+    }
+    /** LOOP HINT 采纳率读路径（decision e7d13697）。See InjectionOperations.countLoopHintAdoption. */
+    countLoopHintAdoption(sinceIso) {
+        return this.injections.countLoopHintAdoption(sinceIso);
+    }
     // ── Task operations ─────────────────────────────────────────────────
     writeTask(task) {
         this.tasks.writeTask(task);
     }
+    /** decision f47c2c90 (二期B): idempotent parent link. See TaskOperations.setTaskParent. */
+    setTaskParent(taskId, parentTaskId) {
+        this.tasks.setTaskParent(taskId, parentTaskId);
+    }
+    /** decision f47c2c90 (二期B): triple-gate parent candidate lookup. See TaskOperations.getMostRecentUserTaskBefore. */
+    getMostRecentUserTaskBefore(opts) {
+        return this.tasks.getMostRecentUserTaskBefore(opts);
+    }
+    /** decision f47c2c90 (二期B): parent-chain spawn aggregation. See TaskOperations.queryParentTaskChainSpawns. */
+    queryParentTaskChainSpawns(anchorTaskId) {
+        return this.tasks.queryParentTaskChainSpawns(anchorTaskId);
+    }
+    /**
+     * decision ed5c3e93 (per-turn human input): read plaintext UserPromptSubmit
+     * user_prompt rows for a set of tasks. See TaskOperations.queryUserPromptsByTaskIds.
+     */
+    queryUserPromptsByTaskIds(taskIds) {
+        return this.tasks.queryUserPromptsByTaskIds(taskIds);
+    }
     updateTask(taskId, updates) {
         this.tasks.updateTask(taskId, updates);
     }
     linkEventToTask(taskId, eventId) {
         this.tasks.linkEventToTask(taskId, eventId);
     }
+    /**
+     * Task-tracking overhaul (2026-05-27 spec §3.3 Q3): pure-attachment
+     * variant — see TaskOperations.attachEventToTask.
+     */
+    attachEventToTask(taskId, eventId) {
+        this.tasks.attachEventToTask(taskId, eventId);
+    }
     queryTasks(filter = {}) {
         return this.tasks.queryTasks(filter);
     }
+    /**
+     * Orphan-event robustness fix (2026-06-01): direct active-user-task lookup.
+     * See TaskOperations.getActiveUserTask.
+     */
+    getActiveUserTask(sessionId) {
+        return this.tasks.getActiveUserTask(sessionId);
+    }
+    /** decision c6613590 P0 缺陷 B: PK active-status check. See TaskOperations.isTaskActive. */
+    isTaskActive(taskId) {
+        return this.tasks.isTaskActive(taskId);
+    }
+    /**
+     * Orphan-event robustness fix (2026-06-01): all sessions with an active user
+     * task — drives TaskSegmenter.hydrateActiveTasks. See
+     * TaskOperations.queryActiveUserTaskSessions.
+     */
+    queryActiveUserTaskSessions() {
+        return this.tasks.queryActiveUserTaskSessions();
+    }
     queryTasksFiltered(filter = {}) {
         return this.tasks.queryTasksFiltered(filter);
     }
@@ -146,21 +307,145 @@ export class SQLiteStorage extends EventEmitter {
         return this.tasks.countTasksByRange(opts);
     }
     getTaskEventIds(taskId) { return this.tasks.getTaskEventIds(taskId); }
+    queryTaskIdsByEventIds(eventIds) {
+        return this.tasks.queryTaskIdsByEventIds(eventIds);
+    }
+    // ── decision 265f59d5: LLM task-boundary re-attribution ──
+    getTaskUserPrompts(taskId, limit) {
+        return this.tasks.getTaskUserPrompts(taskId, limit);
+    }
+    isLlmClassified(taskId) {
+        return this.tasks.isLlmClassified(taskId);
+    }
+    markLlmClassified(taskId, atIso) {
+        this.tasks.markLlmClassified(taskId, atIso);
+    }
+    reattributePromptToNewTask(opts) {
+        return this.tasks.reattributePromptToNewTask(opts);
+    }
     completeStaleActiveTasks(idleMinutes) {
         return this.tasks.completeStaleActiveTasks(idleMinutes);
     }
+    /** E2E link fix (P1, 2026-05-25): tasks left unclassified by TaskSegmenter. */
+    queryIdleUnclassifiedTasks(sessionId) {
+        return this.tasks.queryIdleUnclassifiedTasks(sessionId);
+    }
+    /**
+     * Outcome classifier (spec 1100 v2): count a task's Edit/Write intent
+     * events — drives the `edit_intent_count` signal (success vs answered split).
+     */
+    countEditIntentEventsByTask(taskId) {
+        return this.tasks.countEditIntentEventsByTask(taskId);
+    }
+    /**
+     * Outcome classifier (spec 1100 v2): count a SESSION's Edit/Write intent
+     * events — session-level `edit_intent_count` signal.
+     */
+    countEditIntentEventsBySession(sessionId) {
+        return this.events.countEditIntentEventsBySession(sessionId);
+    }
+    /**
+     * Task-tracking overhaul (2026-05-27 spec §3.3) — Bug 3 orphan recovery.
+     * See TaskOperations.findRecentCompletedTaskForOrphan.
+     */
+    findRecentCompletedTaskForOrphan(opts) {
+        return this.tasks.findRecentCompletedTaskForOrphan(opts);
+    }
     getTask(taskId) {
         return this.tasks.getTask(taskId);
     }
+    /** Task-tracking deep fix (2026-05-27 spec §3.A): smart orphan-recovery without a fixed window. */
+    findCompletedTaskForOrphanSmart(opts) {
+        return this.tasks.findCompletedTaskForOrphanSmart(opts);
+    }
     queryEventsByTaskId(taskId, opts) {
         return this.tasks.queryEventsByTaskId(taskId, opts);
     }
+    /** Task-tracking deep fix (2026-05-27 spec §5.C): UNION fallback query with linked field. */
+    queryEventsByTaskIdWithFallback(taskId, opts) {
+        return this.tasks.queryEventsByTaskIdWithFallback(taskId, opts);
+    }
+    /** spec 1551 §6.D: Orphan stats for dry-run display. */
+    queryOrphanStats() {
+        return this.tasks.queryOrphanStats();
+    }
+    /** spec 1551 §6.D: Sample attachable pairs for dry-run display. */
+    sampleAttachablePairs(limit) {
+        return this.tasks.sampleAttachablePairs(limit);
+    }
+    /** spec 1551 §6.D.3: Apply backfill atomically. Returns rows inserted. */
+    backfillOrphans() {
+        return this.tasks.backfillOrphans();
+    }
+    /**
+     * B+ spec: 30min smart window 续命 — reactivate a completed task.
+     * Sets status='active', end_time=NULL. start_time is not touched.
+     * See TaskOperations.resumeTask.
+     */
+    resumeTask(taskId) {
+        this.tasks.resumeTask(taskId);
+    }
     queryInjectionsByTaskId(taskId) {
         return this.tasks.queryInjectionsByTaskId(taskId);
     }
     querySkillInvocationsByTaskWindow(taskId, opts) {
         return this.tasks.querySkillInvocationsByTaskWindow(taskId, opts);
     }
+    /** Agent 主动 pull 的 KB（任务窗内，按 project+时间窗+reason scope）。See TaskOperations.queryTaskKbPulls. */
+    queryTaskKbPulls(taskId, opts) {
+        return this.tasks.queryTaskKbPulls(taskId, opts);
+    }
+    /**
+     * Task-centric agent board projection (v3). See TaskOperations.queryAgentBoardTasks.
+     */
+    queryAgentBoardTasks(opts) {
+        return this.tasks.queryAgentBoardTasks(opts);
+    }
+    /**
+     * Agent Board v3 — unbounded count companion (2026-05-26).
+     * Drives the "总任务数 (7d)" KPI without the lane LIMIT clipping the value.
+     */
+    countAgentBoardTasks(opts) {
+        return this.tasks.countAgentBoardTasks(opts);
+    }
+    /**
+     * Agent Board prompt-rows projection (decision b509fd91, 2026-06-08).
+     * One row = one user-prompt event; group_id = its task. See
+     * TaskOperations.queryAgentBoardPromptRows.
+     */
+    queryAgentBoardPromptRows(opts) {
+        return this.tasks.queryAgentBoardPromptRows(opts);
+    }
+    /**
+     * Unbounded prompt-row count companion (decision b509fd91). Drives the list
+     * paginator's total when ?rows=prompt. See countAgentBoardPromptRows.
+     */
+    countAgentBoardPromptRows(opts) {
+        return this.tasks.countAgentBoardPromptRows(opts);
+    }
+    /**
+     * Window-level distinct-task aggregates for the prompt-rows list view
+     * (2026-06-10 KPI 分页假象 fix). Same WHERE 口径 as countAgentBoardPromptRows;
+     * drives "总任务数 / 失败 / 平均时长" KPIs + outcome tab counts unbounded by
+     * the page LIMIT. See TaskOperations.queryAgentBoardPromptWindowAggregates.
+     */
+    queryAgentBoardPromptWindowAggregates(opts) {
+        return this.tasks.queryAgentBoardPromptWindowAggregates(opts);
+    }
+    /**
+     * v6 Batch 1 (spec 1750 § B1-3): trivial task counter for DaemonObserverBadge.
+     * Counts `tasks WHERE is_noise=1 AND start_time >= sinceIso`.
+     */
+    countTrivialTasksSince(sinceIso) {
+        return this.tasks.countTrivialTasksSince(sinceIso);
+    }
+    /**
+     * Daily commit + task activity over a window. Drives /api/insights/commit-activity
+     * and HealthHomePage 30d Commit calendar without the agent-board LIMIT undercount.
+     */
+    queryCommitActivityDaily(opts) {
+        return this.tasks.queryCommitActivityDaily(opts);
+    }
     // ── Routing events ─────────────────────────────────────────────────────
     writeRoutingEvent(record) {
         return this.routing.writeRoutingEvent(record);
@@ -180,12 +465,20 @@ export class SQLiteStorage extends EventEmitter {
     queryPendingRoutingEvents(ageMs) {
         return this.routing.queryPendingRoutingEvents(ageMs);
     }
+    /** Phase 2d pipeline-view batch helper. See RoutingOperations.queryBySessions. */
+    queryRoutingEventsBySessions(sessionIds) {
+        return this.routing.queryBySessions(sessionIds);
+    }
     getRecentRoutingEvent(sessionId) {
         return this.routing.getRecentRoutingEvent(sessionId);
     }
     getRecentPendingRoutingEvent(sessionId) {
         return this.routing.getRecentPendingRoutingEvent(sessionId);
     }
+    /** P3 (audit e888352d): re-label this session's still-pending routing rows as 'none' at Stop. */
+    markPendingRoutingEventsResolved(sessionId) {
+        return this.routing.markPendingRoutingEventsResolved(sessionId);
+    }
     // ── Experiment assignments ─────────────────────────────────────────────
     getExperimentAssignment(sessionId, experimentId) {
         return this.routing.getExperimentAssignment(sessionId, experimentId);
@@ -196,26 +489,31 @@ export class SQLiteStorage extends EventEmitter {
     queryExperimentStats(experimentId) {
         return this.routing.queryExperimentStats(experimentId);
     }
-    // ── Token usage ────────────────────────────────────────────────────────
-    writeTokenUsage(params) {
-        this.tokenUsage.writeTokenUsage(params);
-    }
-    getTokenUsageBySession(session_id) {
-        return this.tokenUsage.getTokenUsageBySession(session_id);
-    }
-    listTokenUsage(filter = {}) {
-        return this.tokenUsage.listTokenUsage(filter);
-    }
     // ── Skill invocations ──────────────────────────────────────────────────
     writeSkillInvocation(row) {
         this.skills.writeSkillInvocation(row);
     }
+    // decision 39839e30 Part 2: one-shot project_path back-fill seam (also run at
+    // boot by base.backfillSkillInvocationsProjectPathIfNeeded).
+    backfillSkillInvocationProjectPath() {
+        return this.skills.backfillSkillInvocationProjectPath();
+    }
     querySkillInvocations(filter = {}) {
         return this.skills.querySkillInvocations(filter);
     }
     aggregateSkillInvocationsBySkill(filter) {
         return this.skills.aggregateSkillInvocationsBySkill(filter);
     }
+    // ── audit #2 (decision f61b8a0c): injected vs really-invoked split ──
+    aggregateSkillInjectVsInvoke(filter) {
+        return this.skills.aggregateSkillInjectVsInvoke(filter);
+    }
+    countRealSkillCalls(filter) {
+        return this.skills.countRealSkillCalls(filter);
+    }
+    countGenuineSkillInvocations(filter) {
+        return this.skills.countGenuineSkillInvocations(filter);
+    }
     queryWorkflowProgress(filter = {}) {
         return this.skills.queryWorkflowProgress(filter);
     }
@@ -230,14 +528,223 @@ export class SQLiteStorage extends EventEmitter {
     queryDistinctSkillIdsBySession(session_id) {
         return this.skills.queryDistinctSkillIdsBySession(session_id);
     }
+    // ── Skill usefulness feedback (decision d24cd3a2 P0) ──
+    writeSkillUsefulness(args) {
+        return this.skills.writeSkillUsefulness(args);
+    }
+    aggregateSkillUsefulness(filter = {}) {
+        return this.skills.aggregateSkillUsefulness(filter);
+    }
+    // decision 234f1ad4 Phase 1: (agent,skill) pairing usefulness (reason-prefix proxy key).
+    aggregateSkillUsefulnessByAgent(filter = {}) {
+        return this.skills.aggregateSkillUsefulnessByAgent(filter);
+    }
     // ── Maintenance ────────────────────────────────────────────────────────
-    /** @deprecated 仅清 events 表。新代码请用 `cleanOldData(days)`。 */
-    cleanOldEvents(daysToKeep = 30) { return this.maintenance.cleanOldEvents(daysToKeep); }
     cleanOldData(daysToKeep = 30) {
         return this.maintenance.cleanOldData(daysToKeep);
     }
     runMaintenance(maxSizeMb) { this.maintenance.runMaintenance(maxSizeMb); }
     vacuum() { this.maintenance.vacuum(); }
+    /**
+     * Reclaim up to `maxPages` free pages from the auto_vacuum=INCREMENTAL
+     * freelist. See MaintenanceOperations.incrementalVacuum.
+     */
+    incrementalVacuum(maxPages = 1000) {
+        return this.maintenance.incrementalVacuum(maxPages);
+    }
+    // ── KB Telemetry (v9.5) ────────────────────────────────────────────────
+    writeKbQueryLog(entry) {
+        this.knowledge.writeKbQueryLog(entry);
+    }
+    queryKbQueryLog(filter) {
+        return this.knowledge.queryKbQueryLog(filter);
+    }
+    // ── KB usefulness feedback (decision 096309e4 batch 1 item ①) ──
+    writeKbUsefulness(args) {
+        return this.knowledge.writeKbUsefulness(args);
+    }
+    aggregateKbUsefulness(filter = {}) {
+        return this.knowledge.aggregateKbUsefulness(filter);
+    }
+    // decision 234f1ad4 Phase 1: per-agent KB usefulness (reason-prefix proxy key).
+    aggregateKbUsefulnessByAgent(filter = {}) {
+        return this.knowledge.aggregateKbUsefulnessByAgent(filter);
+    }
+    queryKbStats(projectPath) {
+        return this.knowledge.queryKbStats(projectPath);
+    }
+    queryAgentKbPulls(filter) {
+        return this.knowledge.queryAgentKbPulls(filter);
+    }
+    /** Genuine agent KB pull count for the「KB 调用」KPI (decision 64d37b1d). */
+    countAgentKbPulls(filter) {
+        return this.knowledge.countAgentKbPulls(filter);
+    }
+    queryKbCitedPages(filter) {
+        return this.knowledge.queryKbCitedPages(filter);
+    }
+    writeKbBuildLog(entry) {
+        this.knowledge.writeKbBuildLog(entry);
+    }
+    updateKbBuildLog(buildId, updates) {
+        this.knowledge.updateKbBuildLog(buildId, updates);
+    }
+    queryLastKbBuild(projectPath) {
+        return this.knowledge.queryLastKbBuild(projectPath);
+    }
+    listKnownProjectPaths() {
+        return this.knowledge.listKnownProjectPaths();
+    }
+    queryLastEventAtPerProject() {
+        return this.knowledge.queryLastEventAtPerProject();
+    }
+    queryKbUsageStats(projectPath, days) {
+        return this.knowledge.queryKbUsageStats(projectPath, days);
+    }
+    // ── Forge Config (v9.x Phase 0 feature flags) ──────────────────────────
+    readConfig(key) { return this.forgeConfig.readConfig(key); }
+    writeConfig(key, value) { this.forgeConfig.writeConfig(key, value); }
+    writeConfigIfMissing(key, value) {
+        return this.forgeConfig.writeConfigIfMissing(key, value);
+    }
+    listConfig() { return this.forgeConfig.listConfig(); }
+    deleteConfig(key) { return this.forgeConfig.deleteConfig(key); }
+    // ── Tool Intercepts (v9.x Phase 1 PreToolUse rules) ────────────────────
+    writeToolIntercept(record) {
+        return this.toolIntercepts.writeToolIntercept(record);
+    }
+    queryToolIntercepts(filter = {}) {
+        return this.toolIntercepts.queryToolIntercepts(filter);
+    }
+    countToolIntercepts(session_id) {
+        return this.toolIntercepts.countToolIntercepts(session_id);
+    }
+    /**
+     * Phase 2 metrics rollup alias. Same as countToolIntercepts but matches the
+     * "countXBySession" naming convention used by other Phase 2 helpers.
+     */
+    countToolInterceptsBySession(session_id) {
+        return this.toolIntercepts.countToolIntercepts(session_id);
+    }
+    /** audit F4: PostToolUse back-fills obeyed/override on a prior deny row. */
+    updateToolInterceptOutcome(id, outcome) {
+        this.toolIntercepts.updateOutcome(id, outcome);
+    }
+    /** Phase 2d pipeline-view batch helper. See ToolInterceptsOperations.queryBySessions. */
+    queryToolInterceptsBySessions(sessionIds) {
+        return this.toolIntercepts.queryBySessions(sessionIds);
+    }
+    // ── Workflow Recommendations — retired 2026-06-10 (decision fe6f98cd).
+    // The `workflow_recommendations` table is preserved in existing DBs for
+    // audit; all facade read/write methods were deleted with their consumers.
+    // ── Decisions (decision-flow-overhaul 2026-05-28) ──────────────────────
+    writeDecision(record) {
+        return this.decisions.writeDecision(record);
+    }
+    getDecision(id) {
+        return this.decisions.getDecision(id);
+    }
+    updateDecision(id, update) {
+        this.decisions.updateDecision(id, update);
+    }
+    /**
+     * Back-fill a decision's implementation outcome (decision-maker optimization
+     * Batch 1.1, decision a5d5a85b). Independent of approval status; throws on an
+     * invalid outcome value.
+     */
+    writeDecisionOutcome(id, outcome) {
+        this.decisions.writeDecisionOutcome(id, outcome);
+    }
+    approveDecision(id, approved_by, approved_at_iso, options) {
+        this.decisions.approveDecision(id, approved_by, approved_at_iso, options);
+    }
+    bypassDecision(id, approved_by) {
+        this.decisions.bypassDecision(id, approved_by);
+    }
+    expireOldDecisions(now_iso) {
+        return this.decisions.expireOldRows(now_iso);
+    }
+    getMostRecentPendingDecision(session_id, within_seconds, project_path) {
+        return this.decisions.getMostRecentPending(session_id, within_seconds, project_path);
+    }
+    listDecisions(filter) {
+        return this.decisions.listDecisions(filter);
+    }
+    /**
+     * v6 Batch 1 (spec 1750 § B1-3): hint counter for DaemonObserverBadge.
+     * Counts `decisions WHERE created_at >= sinceIso`.
+     */
+    countDecisionsSince(sinceIso) {
+        return this.decisions.countDecisionsSince(sinceIso);
+    }
+    /**
+     * Option B (decision b95e0956, 2026-05-29) — continuation detection helper.
+     * Returns the N most-recent resolved decisions for a session, newest-first.
+     */
+    listRecentResolvedDecisions(session_id, limit) {
+        return this.decisions.listRecentResolved(session_id, limit);
+    }
+    /**
+     * outcome-backfill soft-gate (decision 1ac6fc31, 2026-06-04) — resolved
+     * decisions for a session/project whose outcome has not been back-filled.
+     * Backs the OutcomeNudge soft-gate (Option A threshold + degraded Option B).
+     */
+    listResolvedUnfilledDecisions(session_id, project_path) {
+        return this.decisions.listResolvedUnfilled(session_id, project_path);
+    }
+    // ── Spec-kind facade (C1, 2026-06-02 — absorbs pending_specs) ──────────
+    registerSpec(record) {
+        return this.decisions.registerSpec(record);
+    }
+    findSpecByTokenAndSession(token, session_id) {
+        return this.decisions.findSpecByTokenAndSession(token, session_id);
+    }
+    findSpecByPath(spec_path) {
+        return this.decisions.findSpecByPath(spec_path);
+    }
+    markSpecApproved(id, approved_at_iso) {
+        this.decisions.markSpecApproved(id, approved_at_iso);
+    }
+    listSpecsBySessionPending(session_id, limit) {
+        return this.decisions.listSpecsBySessionPending(session_id, limit);
+    }
+    querySpecsBySessions(sessionIds) {
+        return this.decisions.querySpecsBySessions(sessionIds);
+    }
+    expireOldSpecs(now_iso) {
+        return this.decisions.expireOldSpecs(now_iso);
+    }
+    // ── Feedback / Weekly-Report Aggregates (F-medium #1, 2026-05-26) ─────
+    // Down-sunk from FeedbackAggregator. Aggregator now consumes these facade
+    // methods instead of calling getDatabase() directly. Keeps base.ts:402-413
+    // contract intact (no db.prepare outside Operations).
+    queryInterceptObeyedSummary(sinceIso, projectPath) {
+        return this.feedback.queryInterceptObeyedSummary(sinceIso, projectPath);
+    }
+    queryInterceptDecisionCounts(sinceIso) {
+        return this.feedback.queryInterceptDecisionCounts(sinceIso);
+    }
+    queryTopInterceptRuleViolations(sinceIso, limit) {
+        return this.feedback.queryTopInterceptRuleViolations(sinceIso, limit);
+    }
+    queryInterceptRuleAggregates(sinceIso) {
+        return this.feedback.queryInterceptRuleAggregates(sinceIso);
+    }
+    countKbInjections(sinceIso, projectPath) {
+        return this.feedback.countKbInjections(sinceIso, projectPath);
+    }
+    queryKbInjectionMetadata(sinceIso) {
+        return this.feedback.queryKbInjectionMetadata(sinceIso);
+    }
+    queryTopSkillInvocations(sinceMillis, limit) {
+        return this.feedback.queryTopSkillInvocations(sinceMillis, limit);
+    }
+    querySkillAggregates(sinceMillis) {
+        return this.feedback.querySkillAggregates(sinceMillis);
+    }
+    querySessionOutcomeDistribution(sinceIso, projectPath) {
+        return this.feedback.querySessionOutcomeDistribution(sinceIso, projectPath);
+    }
     close() {
         try {
             this.base.getDatabase().close();