@cleocode/core 2026.3.74 → 2026.4.0

package/src/hooks/handlers/handler-helpers.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared helpers for hook handler modules.
+ *
+ * Centralises the two patterns repeated across all brain-capture handlers:
+ *
+ * 1. `isMissingBrainSchemaError` — detects the "no such table: brain_*" error
+ *    thrown when brain.db has not been migrated yet, so handlers can swallow
+ *    it silently instead of crashing agent workflows.
+ *
+ * 2. `isAutoCaptureEnabled` — reads `brain.autoCapture` from the cascaded
+ *    project config and returns false when the config is unreadable.
+ *
+ * Import these instead of redefining them in each handler file.
+ *
+ * @task T166
+ * @epic T134
+ */
+
+// ---------------------------------------------------------------------------
+// Brain schema error guard
+// ---------------------------------------------------------------------------
+
+/**
+ * Return true when the error is the "no such table: brain_*" SQLite error
+ * thrown before brain.db has been migrated.
+ *
+ * Hook handlers use this to swallow migration-lag errors without hiding
+ * genuine failures: if the error is NOT a missing-schema error it is
+ * re-thrown so it propagates normally.
+ *
+ * @param err - The caught error value (may be any type).
+ */
+export function isMissingBrainSchemaError(err: unknown): boolean {
+  if (!(err instanceof Error)) return false;
+  const message = String(err.message || '').toLowerCase();
+  return message.includes('no such table') && message.includes('brain_');
+}
+
+// ---------------------------------------------------------------------------
+// Auto-capture config gate
+// ---------------------------------------------------------------------------
+
+/**
+ * Return true when `brain.autoCapture` is enabled for the given project.
+ *
+ * Resolution order (first truthy wins):
+ *   1. `brain.autoCapture` project config value (via `loadConfig` cascade)
+ *
+ * Defaults to `false` when the config is unreadable or the key is absent,
+ * so handlers are safely disabled in environments where brain.db is not set up.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ */
+export async function isAutoCaptureEnabled(projectRoot: string): Promise<boolean> {
+  try {
+    const { loadConfig } = await import('../../config.js');
+    const config = await loadConfig(projectRoot);
+    return config.brain?.autoCapture ?? false;
+  } catch {
+    return false;
+  }
+}

package/src/hooks/handlers/mcp-hooks.ts

@@ -21,12 +21,7 @@ import type {
   PromptSubmitPayload,
   ResponseCompletePayload,
 } from '../types.js';
-
-function isMissingBrainSchemaError(err: unknown): boolean {
-  if (!(err instanceof Error)) return false;
-  const message = String(err.message || '').toLowerCase();
-  return message.includes('no such table') && message.includes('brain_');
-}
+import { isAutoCaptureEnabled, isMissingBrainSchemaError } from './handler-helpers.js';
 
 /**
  * Check whether MCP-level brain capture is enabled.
@@ -126,14 +121,7 @@ export async function handleSystemNotification(
   if (payload.filePath || payload.changeType) return;
   // Only handle message-bearing system notifications
   if (!payload.message) return;
-
-  try {
-    const { loadConfig } = await import('../../config.js');
-    const config = await loadConfig(projectRoot);
-    if (!config.brain?.autoCapture) return;
-  } catch {
-    return;
-  }
+  if (!(await isAutoCaptureEnabled(projectRoot))) return;
 
   const { observeBrain } = await import('../../memory/brain-retrieval.js');
 

package/src/hooks/handlers/session-hooks.ts

@@ -11,14 +11,9 @@
 
 import { hooks } from '../registry.js';
 import type { SessionEndPayload, SessionStartPayload } from '../types.js';
+import { isMissingBrainSchemaError } from './handler-helpers.js';
 import { maybeRefreshMemoryBridge } from './memory-bridge-refresh.js';
 
-function isMissingBrainSchemaError(err: unknown): boolean {
-  if (!(err instanceof Error)) return false;
-  const message = String(err.message || '').toLowerCase();
-  return message.includes('no such table') && message.includes('brain_');
-}
-
 /**
  * Handle SessionStart - capture initial session context
  *

package/src/hooks/handlers/task-hooks.ts

@@ -9,14 +9,9 @@
 
 import { hooks } from '../registry.js';
 import type { PostToolUsePayload, PreToolUsePayload } from '../types.js';
+import { isMissingBrainSchemaError } from './handler-helpers.js';
 import { maybeRefreshMemoryBridge } from './memory-bridge-refresh.js';
 
-function isMissingBrainSchemaError(err: unknown): boolean {
-  if (!(err instanceof Error)) return false;
-  const message = String(err.message || '').toLowerCase();
-  return message.includes('no such table') && message.includes('brain_');
-}
-
 /**
  * Handle PreToolUse (maps to task.start in CLEO, canonical: was onToolStart)
  */

package/src/hooks/handlers/work-capture-hooks.ts

@@ -18,16 +18,7 @@
 
 import { hooks } from '../registry.js';
 import type { PromptSubmitPayload, ResponseCompletePayload } from '../types.js';
-
-// ---------------------------------------------------------------------------
-// Shared helpers
-// ---------------------------------------------------------------------------
-
-function isMissingBrainSchemaError(err: unknown): boolean {
-  if (!(err instanceof Error)) return false;
-  const message = String(err.message || '').toLowerCase();
-  return message.includes('no such table') && message.includes('brain_');
-}
+import { isMissingBrainSchemaError } from './handler-helpers.js';
 
 /**
  * Check whether active-work capture is enabled.

package/src/index.ts

@@ -33,8 +33,10 @@ export * as admin from './admin/index.js';
 export * as adrs from './adrs/index.js';
 export * as agents from './agents/index.js';
 export * as caamp from './caamp/index.js';
+export * as code from './code/index.js';
 export * as codebaseMap from './codebase-map/index.js';
 export * as compliance from './compliance/index.js';
+export * as conduit from './conduit/index.js';
 export * as context from './context/index.js';
 export * as coreHooks from './hooks/index.js';
 export * as inject from './inject/index.js';
@@ -61,7 +63,7 @@ export * as routing from './routing/index.js';
 export * as security from './security/index.js';
 export * as sequence from './sequence/index.js';
 export * as sessions from './sessions/index.js';
-export * as signaldock from './signaldock/index.js';
+// signaldock/ removed — use conduit/ instead (T170 unification)
 export * as skills from './skills/index.js';
 export * as snapshot from './snapshot/index.js';
 export * as spawn from './spawn/index.js';
@@ -289,6 +291,15 @@ export {
   runAllMigrations,
   runMigration,
 } from './migration/index.js';
+// MVI progressive disclosure helpers
+export type { NextDirectives } from './mvi-helpers.js';
+export {
+  memoryFindHitNext,
+  sessionListItemNext,
+  sessionStartNext,
+  taskListItemNext,
+  taskShowNext,
+} from './mvi-helpers.js';
 // Reconciliation
 export { reconcile } from './reconciliation/index.js';
 // Sessions

package/src/init.ts

@@ -532,6 +532,18 @@ export async function initProject(opts: InitOptions = {}): Promise<InitResult> {
     created.push(`brain.db (deferred: ${err instanceof Error ? err.message : String(err)})`);
   }
 
+  // Initialize signaldock.db for local agent messaging infrastructure (T223)
+  try {
+    const { ensureSignaldockDb } = await import('./store/signaldock-sqlite.js');
+    const sdResult = await ensureSignaldockDb(projRoot);
+    if (sdResult.action === 'created') {
+      created.push('signaldock.db');
+    }
+  } catch (err) {
+    // Non-fatal — signaldock.db will be created on first agent operation
+    created.push(`signaldock.db (deferred: ${err instanceof Error ? err.message : String(err)})`);
+  }
+
   // T4681: Create .cleo/.gitignore (respect force flag)
   if (force) {
     // When force is set, always overwrite — ensureGitignore does content-comparison only

package/src/intelligence/__tests__/adaptive-validation.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for the Adaptive Validation module.
+ *
+ * Tests gate focus suggestions, confidence scoring, and prediction storage.
+ * All external dependencies are mocked.
+ *
+ * @task T035
+ * @epic T029
+ */
+export {};
+//# sourceMappingURL=adaptive-validation.test.d.ts.map

package/src/intelligence/__tests__/adaptive-validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-validation.test.d.ts","sourceRoot":"","sources":["adaptive-validation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}