@cleocode/core 2026.3.70 → 2026.3.72

package/dist/index.js

@@ -198,6 +198,39 @@ var init_exit_codes = __esm({
   }
 });
 
+// packages/contracts/src/facade.ts
+var BRAIN_OBSERVATION_TYPES, AGENT_INSTANCE_STATUSES, AGENT_TYPES;
+var init_facade = __esm({
+  "packages/contracts/src/facade.ts"() {
+    "use strict";
+    BRAIN_OBSERVATION_TYPES = [
+      "discovery",
+      "change",
+      "feature",
+      "bugfix",
+      "decision",
+      "refactor"
+    ];
+    AGENT_INSTANCE_STATUSES = [
+      "starting",
+      "active",
+      "idle",
+      "error",
+      "crashed",
+      "stopped"
+    ];
+    AGENT_TYPES = [
+      "orchestrator",
+      "executor",
+      "researcher",
+      "architect",
+      "validator",
+      "documentor",
+      "custom"
+    ];
+  }
+});
+
 // packages/contracts/src/lafs.ts
 function isLafsSuccess(envelope) {
   return envelope.success === true;
@@ -488,6 +521,7 @@ var init_src = __esm({
   "packages/contracts/src/index.ts"() {
     init_errors();
     init_exit_codes();
+    init_facade();
     init_lafs();
     init_operations();
     init_session2();
@@ -8914,12 +8948,12 @@ var init_status_registry2 = __esm({
 
 // packages/core/src/agents/agent-schema.ts
 import { sql as sql2 } from "drizzle-orm";
-var AGENT_INSTANCE_STATUSES, AGENT_TYPES, agentInstances, agentErrorLog;
+var AGENT_INSTANCE_STATUSES2, AGENT_TYPES2, agentInstances, agentErrorLog;
 var init_agent_schema = __esm({
   "packages/core/src/agents/agent-schema.ts"() {
     "use strict";
     init_sqlite_core();
-    AGENT_INSTANCE_STATUSES = [
+    AGENT_INSTANCE_STATUSES2 = [
       "starting",
       "active",
       "idle",
@@ -8927,7 +8961,7 @@ var init_agent_schema = __esm({
       "crashed",
       "stopped"
     ];
-    AGENT_TYPES = [
+    AGENT_TYPES2 = [
       "orchestrator",
       "executor",
       "researcher",
@@ -8940,8 +8974,8 @@ var init_agent_schema = __esm({
       "agent_instances",
       {
         id: text("id").primaryKey(),
-        agentType: text("agent_type", { enum: AGENT_TYPES }).notNull(),
-        status: text("status", { enum: AGENT_INSTANCE_STATUSES }).notNull().default("starting"),
+        agentType: text("agent_type", { enum: AGENT_TYPES2 }).notNull(),
+        status: text("status", { enum: AGENT_INSTANCE_STATUSES2 }).notNull().default("starting"),
         // T033: FK constraints enforced at DB level by migration; kept soft here
         // to avoid circular dependency with tasks-schema.ts (which imports agent-schema.ts).
         // The migration SQL adds: session_id -> sessions ON DELETE SET NULL,
@@ -9041,8 +9075,8 @@ var init_chain_schema = __esm({
 var tasks_schema_exports = {};
 __export(tasks_schema_exports, {
   ADR_STATUSES: () => ADR_STATUSES,
-  AGENT_INSTANCE_STATUSES: () => AGENT_INSTANCE_STATUSES,
-  AGENT_TYPES: () => AGENT_TYPES,
+  AGENT_INSTANCE_STATUSES: () => AGENT_INSTANCE_STATUSES2,
+  AGENT_TYPES: () => AGENT_TYPES2,
   EXTERNAL_LINK_TYPES: () => EXTERNAL_LINK_TYPES,
   GATE_STATUSES: () => GATE_STATUSES,
   LIFECYCLE_EVIDENCE_TYPES: () => LIFECYCLE_EVIDENCE_TYPES,
@@ -10469,7 +10503,7 @@ __export(brain_schema_exports, {
   BRAIN_MEMORY_TYPES: () => BRAIN_MEMORY_TYPES,
   BRAIN_NODE_TYPES: () => BRAIN_NODE_TYPES,
   BRAIN_OBSERVATION_SOURCE_TYPES: () => BRAIN_OBSERVATION_SOURCE_TYPES,
-  BRAIN_OBSERVATION_TYPES: () => BRAIN_OBSERVATION_TYPES,
+  BRAIN_OBSERVATION_TYPES: () => BRAIN_OBSERVATION_TYPES2,
   BRAIN_OUTCOME_TYPES: () => BRAIN_OUTCOME_TYPES,
   BRAIN_PATTERN_TYPES: () => BRAIN_PATTERN_TYPES,
   BRAIN_STICKY_COLORS: () => BRAIN_STICKY_COLORS,
@@ -10486,7 +10520,7 @@ __export(brain_schema_exports, {
   brainStickyNotes: () => brainStickyNotes
 });
 import { sql as sql5 } from "drizzle-orm";
-var BRAIN_DECISION_TYPES, BRAIN_CONFIDENCE_LEVELS, BRAIN_OUTCOME_TYPES, BRAIN_PATTERN_TYPES, BRAIN_IMPACT_LEVELS, BRAIN_LINK_TYPES, BRAIN_OBSERVATION_TYPES, BRAIN_OBSERVATION_SOURCE_TYPES, BRAIN_MEMORY_TYPES, BRAIN_STICKY_STATUSES, BRAIN_STICKY_COLORS, BRAIN_STICKY_PRIORITIES, brainDecisions, brainPatterns, brainLearnings, brainObservations, brainStickyNotes, brainMemoryLinks, brainSchemaMeta, BRAIN_NODE_TYPES, BRAIN_EDGE_TYPES, brainPageNodes, brainPageEdges;
+var BRAIN_DECISION_TYPES, BRAIN_CONFIDENCE_LEVELS, BRAIN_OUTCOME_TYPES, BRAIN_PATTERN_TYPES, BRAIN_IMPACT_LEVELS, BRAIN_LINK_TYPES, BRAIN_OBSERVATION_TYPES2, BRAIN_OBSERVATION_SOURCE_TYPES, BRAIN_MEMORY_TYPES, BRAIN_STICKY_STATUSES, BRAIN_STICKY_COLORS, BRAIN_STICKY_PRIORITIES, brainDecisions, brainPatterns, brainLearnings, brainObservations, brainStickyNotes, brainMemoryLinks, brainSchemaMeta, BRAIN_NODE_TYPES, BRAIN_EDGE_TYPES, brainPageNodes, brainPageEdges;
 var init_brain_schema = __esm({
   "packages/core/src/store/brain-schema.ts"() {
     "use strict";
@@ -10514,7 +10548,7 @@ var init_brain_schema = __esm({
       "informed_by",
       "contradicts"
     ];
-    BRAIN_OBSERVATION_TYPES = [
+    BRAIN_OBSERVATION_TYPES2 = [
       "discovery",
       "change",
       "feature",
@@ -10603,7 +10637,7 @@ var init_brain_schema = __esm({
       "brain_observations",
       {
         id: text("id").primaryKey(),
-        type: text("type", { enum: BRAIN_OBSERVATION_TYPES }).notNull(),
+        type: text("type", { enum: BRAIN_OBSERVATION_TYPES2 }).notNull(),
         title: text("title").notNull(),
         subtitle: text("subtitle"),
         narrative: text("narrative"),
@@ -26997,8 +27031,8 @@ async function validateAllAdrs(projectRoot) {
 // packages/core/src/agents/index.ts
 var agents_exports = {};
 __export(agents_exports, {
-  AGENT_INSTANCE_STATUSES: () => AGENT_INSTANCE_STATUSES,
-  AGENT_TYPES: () => AGENT_TYPES,
+  AGENT_INSTANCE_STATUSES: () => AGENT_INSTANCE_STATUSES2,
+  AGENT_TYPES: () => AGENT_TYPES2,
   DEFAULT_RETRY_POLICY: () => DEFAULT_RETRY_POLICY,
   HEARTBEAT_INTERVAL_MS: () => HEARTBEAT_INTERVAL_MS,
   MAX_TASKS_PER_AGENT: () => MAX_TASKS_PER_AGENT,
@@ -62324,7 +62358,7 @@ var taskRelationTypeSchema = external_exports.enum(TASK_RELATION_TYPES);
 var externalLinkTypeSchema = external_exports.enum(EXTERNAL_LINK_TYPES);
 var syncDirectionSchema = external_exports.enum(SYNC_DIRECTIONS);
 var lifecycleTransitionTypeSchema = external_exports.enum(LIFECYCLE_TRANSITION_TYPES);
-var brainObservationTypeSchema = external_exports.enum(BRAIN_OBSERVATION_TYPES);
+var brainObservationTypeSchema = external_exports.enum(BRAIN_OBSERVATION_TYPES2);
 var brainObservationSourceTypeSchema = external_exports.enum(BRAIN_OBSERVATION_SOURCE_TYPES);
 var brainDecisionTypeSchema = external_exports.enum(BRAIN_DECISION_TYPES);
 var brainConfidenceLevelSchema = external_exports.enum(BRAIN_CONFIDENCE_LEVELS);
@@ -62494,8 +62528,8 @@ var selectAgentInstanceSchema = createSelectSchema2(
 );
 var insertAgentErrorLogSchema = createInsertSchema2(agentErrorLog);
 var selectAgentErrorLogSchema = createSelectSchema2(agentErrorLog);
-var agentInstanceStatusSchema = external_exports.enum(AGENT_INSTANCE_STATUSES);
-var agentTypeSchema = external_exports.enum(AGENT_TYPES);
+var agentInstanceStatusSchema = external_exports.enum(AGENT_INSTANCE_STATUSES2);
+var agentTypeSchema = external_exports.enum(AGENT_TYPES2);
 
 // packages/core/src/validation/compliance.ts
 function checkManifestEntry(entry) {
@@ -65193,6 +65227,158 @@ init_brain_retrieval();
 init_brain_search();
 init_registry3();
 init_sessions();
+
+// packages/core/src/sessions/snapshot.ts
+init_src();
+init_errors3();
+init_data_accessor();
+init_decisions();
+init_handoff();
+var SNAPSHOT_VERSION = 1;
+async function serializeSession(projectRoot, options = {}, accessor) {
+  const acc = accessor ?? await getAccessor(projectRoot);
+  const maxObs = options.maxObservations ?? 10;
+  const maxDescLen = options.maxDescriptionLength ?? 500;
+  const sessions2 = await acc.loadSessions();
+  let session;
+  if (options.sessionId) {
+    session = sessions2.find((s) => s.id === options.sessionId);
+  } else {
+    session = sessions2.filter((s) => s.status === "active").sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime())[0];
+  }
+  if (!session) {
+    throw new CleoError(
+      31 /* SESSION_NOT_FOUND */,
+      options.sessionId ? `Session '${options.sessionId}' not found` : "No active session to serialize",
+      { fix: "Use 'cleo session list' to see available sessions" }
+    );
+  }
+  const handoff = await computeHandoff(projectRoot, { sessionId: session.id });
+  const decisionLog = await getDecisionLog(projectRoot, { sessionId: session.id });
+  const decisions = decisionLog.map((d) => ({
+    decision: d.decision,
+    rationale: d.rationale,
+    taskId: d.taskId,
+    recordedAt: d.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+  }));
+  let observations = [];
+  try {
+    const { searchBrainCompact: searchBrainCompact2 } = await Promise.resolve().then(() => (init_brain_retrieval(), brain_retrieval_exports));
+    const results = await searchBrainCompact2(projectRoot, {
+      query: session.id,
+      limit: maxObs,
+      tables: ["observations"]
+    });
+    if (Array.isArray(results)) {
+      observations = results.map(
+        (r) => ({
+          id: r.id,
+          text: r.text ?? "",
+          type: r.type ?? "discovery",
+          createdAt: r.createdAt ?? ""
+        })
+      );
+    }
+  } catch {
+  }
+  let activeTask = null;
+  if (session.taskWork?.taskId) {
+    try {
+      const { tasks: tasks2 } = await acc.queryTasks({});
+      const task = tasks2.find((t) => t.id === session.taskWork?.taskId);
+      if (task) {
+        const desc5 = task.description ?? "";
+        activeTask = {
+          taskId: task.id,
+          title: task.title,
+          status: task.status,
+          priority: task.priority ?? "medium",
+          description: desc5.length > maxDescLen ? desc5.slice(0, maxDescLen) + "..." : desc5,
+          acceptance: Array.isArray(task.acceptance) ? task.acceptance.join("\n") : task.acceptance ?? void 0
+        };
+      }
+    } catch {
+    }
+  }
+  const startTime = new Date(session.startedAt).getTime();
+  const now = Date.now();
+  const durationMinutes = Math.round((now - startTime) / 6e4);
+  return {
+    version: SNAPSHOT_VERSION,
+    capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    session,
+    handoff,
+    decisions,
+    observations,
+    activeTask,
+    durationMinutes
+  };
+}
+async function restoreSession(projectRoot, snapshot, options = {}, accessor) {
+  if (snapshot.version > SNAPSHOT_VERSION) {
+    throw new CleoError(
+      6 /* VALIDATION_ERROR */,
+      `Snapshot version ${snapshot.version} is newer than supported version ${SNAPSHOT_VERSION}`,
+      { fix: "Upgrade @cleocode/core to a newer version that supports this snapshot format" }
+    );
+  }
+  const acc = accessor ?? await getAccessor(projectRoot);
+  const activate = options.activate ?? true;
+  if (activate) {
+    const sessions2 = await acc.loadSessions();
+    const scope = snapshot.session.scope;
+    const activeConflict = sessions2.find(
+      (s) => s.status === "active" && s.scope.type === scope.type && s.scope.epicId === scope.epicId && s.id !== snapshot.session.id
+    );
+    if (activeConflict) {
+      throw new CleoError(
+        32 /* SCOPE_CONFLICT */,
+        `Active session '${activeConflict.id}' already exists for scope ${scope.type}${scope.epicId ? ":" + scope.epicId : ""}`,
+        {
+          fix: `End the active session first with 'cleo session end' or restore without activating`,
+          alternatives: [
+            { action: "End conflicting session", command: "cleo session end" },
+            { action: "Restore without activating", command: "Restore with activate: false" }
+          ]
+        }
+      );
+    }
+  }
+  const restoredSession = {
+    ...snapshot.session,
+    status: activate ? "active" : snapshot.session.status,
+    notes: [
+      ...snapshot.session.notes ?? [],
+      `Restored from snapshot at ${(/* @__PURE__ */ new Date()).toISOString()} (captured ${snapshot.capturedAt}, duration ${snapshot.durationMinutes}m)`
+    ],
+    resumeCount: (snapshot.session.resumeCount ?? 0) + 1
+  };
+  if (options.agent) {
+    restoredSession.agent = options.agent;
+    restoredSession.notes = [
+      ...restoredSession.notes ?? [],
+      `Agent handoff: ${snapshot.session.agent ?? "unknown"} \u2192 ${options.agent}`
+    ];
+  }
+  restoredSession.handoffJson = JSON.stringify(snapshot.handoff);
+  await acc.upsertSingleSession(restoredSession);
+  try {
+    const { hooks: hooks2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
+    await hooks2.dispatch("onSessionStart", projectRoot, {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: restoredSession.id,
+      name: restoredSession.name,
+      scope: restoredSession.scope,
+      agent: restoredSession.agent,
+      restored: true,
+      snapshotCapturedAt: snapshot.capturedAt
+    });
+  } catch {
+  }
+  return restoredSession;
+}
+
+// packages/core/src/cleo.ts
 init_data_accessor();
 init_add();
 init_complete();
@@ -65295,7 +65481,15 @@ var Cleo = class _Cleo {
       recordAssumption: (p) => recordAssumption(root, p),
       contextDrift: (p) => getContextDrift(root, p),
       decisionLog: (p) => getDecisionLog(root, { sessionId: p?.sessionId, taskId: p?.taskId }),
-      lastHandoff: (scope) => getLastHandoff(root, scope)
+      lastHandoff: (scope) => getLastHandoff(root, scope),
+      serialize: (p) => serializeSession(root, {
+        sessionId: p?.sessionId,
+        maxObservations: p?.maxObservations
+      }),
+      restore: (snapshot, p) => restoreSession(root, snapshot, {
+        agent: p?.agent,
+        activate: p?.activate
+      })
     };
   }
   // === Memory ===
@@ -65476,7 +65670,10 @@ init_complete();
 init_update2();
 export {
   ADR_STATUSES,
+  AGENT_INSTANCE_STATUSES,
+  AGENT_TYPES,
   AdapterManager,
+  BRAIN_OBSERVATION_TYPES,
   CORE_PROTECTED_FILES,
   Cleo,
   CleoError,
@@ -65652,6 +65849,7 @@ export {
   remote_exports as remote,
   research_exports as research,
   resolveProjectPath,
+  restoreSession,
   resumeSession,
   roadmap_exports as roadmap,
   routing_exports as routing,
@@ -65668,6 +65866,7 @@ export {
   selectSessionSchema,
   selectTaskSchema,
   sequence_exports as sequence,
+  serializeSession,
   sessionStatus,
   sessionStatusSchema,
   sessions_exports as sessions,