omnius 1.0.688 → 1.0.689

package/dist/index.js

@@ -663967,7 +663967,7 @@ ${loadPrompt("agentic/system-small.md")}`;
         if (this.options.subAgent || this.options.recursionDepth > 0)
           return [];
         const normalizedGoal = goal.replace(/\s+/g, " ").trim();
-        if (normalizedGoal.length < 120 && !this._isContinuationResumeGoal(normalizedGoal))
+        if (normalizedGoal.length < 120 && !this._resumeInterrupted)
           return [];
         return [
           {
@@ -664035,44 +664035,6 @@ ${loadPrompt("agentic/system-small.md")}`;
           }
         ];
       }
-      _isContinuationResumeGoal(goal) {
-        const tokens3 = goal.toLowerCase().replace(/[^a-z0-9]+/g, " ").split(/\s+/).filter(Boolean);
-        if (tokens3.length === 0 || tokens3.length > 14)
-          return false;
-        const continuationTerms = /* @__PURE__ */ new Set([
-          "again",
-          "and",
-          "back",
-          "carry",
-          "complete",
-          "continue",
-          "finish",
-          "from",
-          "last",
-          "latest",
-          "left",
-          "my",
-          "off",
-          "please",
-          "previous",
-          "prior",
-          "proceed",
-          "request",
-          "resume",
-          "task",
-          "that",
-          "the",
-          "this",
-          "to",
-          "try",
-          "work"
-        ]);
-        const hasResumeVerb = tokens3.some((token) => token === "continue" || token === "resume" || token === "proceed" || token === "complete" || token === "finish");
-        if (!hasResumeVerb)
-          return false;
-        const continuationTokenCount = tokens3.filter((token) => continuationTerms.has(token)).length;
-        return continuationTokenCount / tokens3.length >= 0.7;
-      }
       /**
        * Build a compact workboard context string for injection into the
        * system prompt. Returns null when no active board exists or when
@@ -677190,7 +677152,7 @@ Respond with the assessment and take the selected evidence-backed action.`;
         this._memexArchive.clear();
         this._todoOutputLedger.clear();
         setTodoSessionId(this._sessionId);
-        const continuesPriorTask = this._allowImplicitContinuation || this._isContinuationResumeGoal(persistentTaskGoal);
+        const continuesPriorTask = this._allowImplicitContinuation || this._resumeInterrupted;
         if (!continuesPriorTask) {
           this._hidePriorSessionTodosForFreshTask(persistentTaskGoal);
         }
@@ -731239,6 +731201,7 @@ __export(omnius_directory_exports, {
   appendCompactionAudit: () => appendCompactionAudit,
   buildContextRestorePrompt: () => buildContextRestorePrompt,
   buildContextRestoreSnapshot: () => buildContextRestoreSnapshot,
+  buildExactContinuationSnapshot: () => buildExactContinuationSnapshot,
   buildHandoffPrompt: () => buildHandoffPrompt,
   cleanPromptForDiary: () => cleanPromptForDiary,
   clearTaskHandoff: () => clearTaskHandoff,
@@ -731260,6 +731223,8 @@ __export(omnius_directory_exports, {
   loadSessionHistory: () => loadSessionHistory,
   loadTuiSessionState: () => loadTuiSessionState,
   loadUsageHistory: () => loadUsageHistory,
+  pendingTaskMatchesInterruptionIdentity: () => pendingTaskMatchesInterruptionIdentity,
+  pendingTaskMatchesRunningInterruption: () => pendingTaskMatchesRunningInterruption,
   readIndexData: () => readIndexData,
   readIndexMeta: () => readIndexMeta,
   readTaskHandoff: () => readTaskHandoff2,
@@ -731659,21 +731624,64 @@ function loadRecentSessions(repoRoot, limit2 = 5) {
     return [];
   }
 }
+function isValidPendingTask(value2, repoRoot) {
+  if (!value2 || typeof value2 !== "object") return false;
+  const task = value2;
+  if (typeof task.prompt !== "string" || !task.prompt.trim() || typeof task.progressSummary !== "string" || !Array.isArray(task.filesModified) || !task.filesModified.every((item) => typeof item === "string") || typeof task.bruteForce !== "boolean" || typeof task.savedAt !== "string" || !Number.isFinite(Date.parse(task.savedAt)) || typeof task.toolCallCount !== "number" || !Number.isFinite(task.toolCallCount) || task.toolCallCount < 0) {
+    return false;
+  }
+  if (task.schema !== void 0 && task.schema !== "omnius.pending-task.v2") {
+    return false;
+  }
+  if (task.projectRoot !== void 0 && resolve77(task.projectRoot) !== resolve77(repoRoot)) {
+    return false;
+  }
+  if (task.interruption !== void 0) {
+    const interruption = task.interruption;
+    if (typeof interruption.sessionId !== "string" || !interruption.sessionId.trim() || typeof interruption.runId !== "string" || !interruption.runId.trim() || !Number.isInteger(interruption.taskEpoch) || interruption.taskEpoch < 1 || !Number.isInteger(interruption.ownerGeneration) || interruption.ownerGeneration < 1 || interruption.phase !== "pausing" && interruption.phase !== "paused") {
+      return false;
+    }
+  }
+  if (task.resumeOnStartup === true && !task.interruption) return false;
+  return true;
+}
+function pendingTaskMatchesRunningInterruption(pendingTask, candidate) {
+  return candidate?.phase === "running" && pendingTaskMatchesInterruptionIdentity(pendingTask, candidate);
+}
+function pendingTaskMatchesInterruptionIdentity(pendingTask, candidate) {
+  const expected = pendingTask.interruption;
+  return Boolean(
+    expected && candidate && candidate.sessionId === expected.sessionId && candidate.runId === expected.runId && candidate.taskEpoch === expected.taskEpoch && candidate.ownerGeneration === expected.ownerGeneration
+  );
+}
 function savePendingTask(repoRoot, task) {
   const historyDir = join162(repoRoot, OMNIUS_DIR2, "history");
   mkdirSync95(historyDir, { recursive: true });
-  writeFileSync85(
-    join162(historyDir, PENDING_TASK_FILE),
-    JSON.stringify(task, null, 2) + "\n",
-    "utf-8"
-  );
+  const filePath = join162(historyDir, PENDING_TASK_FILE);
+  const tempPath = `${filePath}.tmp-${process.pid}`;
+  const checkpoint = {
+    ...task,
+    schema: "omnius.pending-task.v2",
+    projectRoot: resolve77(repoRoot)
+  };
+  const payload = JSON.stringify(checkpoint, null, 2) + "\n";
+  writeFileSync85(tempPath, payload, "utf-8");
+  try {
+    renameSync30(tempPath, filePath);
+  } catch {
+    writeFileSync85(filePath, payload, "utf-8");
+    try {
+      unlinkSync37(tempPath);
+    } catch {
+    }
+  }
 }
 function loadPendingTask(repoRoot) {
   const filePath = join162(repoRoot, OMNIUS_DIR2, "history", PENDING_TASK_FILE);
   try {
     if (!existsSync148(filePath)) return null;
     const data = JSON.parse(readFileSync124(filePath, "utf-8"));
-    return data;
+    return isValidPendingTask(data, repoRoot) ? data : null;
   } catch {
     return null;
   }
@@ -732047,6 +732055,13 @@ function saveSessionContext(repoRoot, entry) {
         ctx3.entries.push(normalizedEntry);
       }
     }
+    ctx3.entries = ctx3.entries.map((item, index) => ({ item, index })).sort((a2, b) => {
+      const left = Date.parse(a2.item.savedAt || "");
+      const right = Date.parse(b.item.savedAt || "");
+      const leftTime = Number.isFinite(left) ? left : 0;
+      const rightTime = Number.isFinite(right) ? right : 0;
+      return leftTime - rightTime || a2.index - b.index;
+    }).map(({ item }) => item);
     if (ctx3.entries.length > ctx3.maxEntries) {
       ctx3.entries = ctx3.entries.slice(-ctx3.maxEntries);
     }
@@ -732180,80 +732195,12 @@ function isManualSessionEntry(entry) {
   const summary = normalizeSessionText(entry.summary || entry.assistantResponse, 160).toLowerCase();
   return entry.source === "manual" || task === "(manual save)" || entry.toolCalls === 0 && summary.startsWith("manual context save");
 }
-function isDeicticContinuationGoal(goal) {
-  const tokens3 = normalizeSessionText(cleanPromptForDiary(goal), 180).toLowerCase().replace(/[^a-z0-9]+/g, " ").split(/\s+/).filter(Boolean);
-  if (tokens3.length === 0 || tokens3.length > 14) return false;
-  const hasResumeVerb = tokens3.some(
-    (token) => token === "continue" || token === "resume" || token === "proceed" || token === "complete" || token === "finish"
-  );
-  if (!hasResumeVerb) return false;
-  const deicticCount = tokens3.filter((token) => DEICTIC_CONTINUATION_TERMS.has(token)).length;
-  return deicticCount / tokens3.length >= 0.7;
-}
 function readRestoreWorkboard(repoRoot, runId) {
   if (!runId) return null;
   return readJsonOrNull(
     join162(repoRoot, OMNIUS_DIR2, "workboards", runId, "active.json")
   );
 }
-function scoreRestoreLedger(ledger, workboard) {
-  const status = ledger.status || "open";
-  if (status === "approved") return -1e3;
-  const evidence = ledger.evidence ?? [];
-  const unresolvedCount = ledger.unresolved?.length ?? 0;
-  const activeCards = (workboard?.cards ?? []).filter(
-    (card) => card.status === "open" || card.status === "in_progress" || card.status === "needs_changes" || card.status === "blocked"
-  ).length;
-  const mutationTools = /* @__PURE__ */ new Set(["file_edit", "file_patch", "batch_edit", "file_write"]);
-  const mutationEvidence = evidence.filter((item) => mutationTools.has(item.toolName || "")).length;
-  const failedMutationEvidence = evidence.filter(
-    (item) => mutationTools.has(item.toolName || "") && item.success === false
-  ).length;
-  const targetPathEvidence = evidence.filter((item) => (item.targetPaths?.length ?? 0) > 0).length;
-  const blockedEvidence = evidence.filter((item) => {
-    const summary = String(item.summary ?? "").toLowerCase();
-    return summary.includes("[focus supervisor block]") || summary.includes("stale") || summary.includes("blocked");
-  }).length;
-  let score = 0;
-  if (status === "open") score += 10;
-  else if (status === "incomplete_verification") score += 18;
-  else if (status === "request_changes" || status === "blocked") score += 16;
-  else score += 4;
-  score += Math.min(evidence.length, 20);
-  score += Math.min(unresolvedCount, 10) * 4;
-  score += Math.min(activeCards, 8) * 3;
-  score += Math.min(mutationEvidence, 8) * 5;
-  score += Math.min(failedMutationEvidence, 8) * 3;
-  score += Math.min(targetPathEvidence, 6) * 2;
-  score += Math.min(blockedEvidence, 6) * 2;
-  const goal = normalizeSessionText(ledger.goal, 260);
-  if (goal.length >= 80) score += 5;
-  if (isDeicticContinuationGoal(goal) && mutationEvidence === 0 && unresolvedCount === 0 && activeCards === 0) {
-    score -= 25;
-  }
-  return score;
-}
-function selectActiveTaskAnchor(repoRoot) {
-  const ledgerDir = join162(repoRoot, OMNIUS_DIR2, "completion-ledgers");
-  try {
-    if (!existsSync148(ledgerDir)) return null;
-    const candidates = readdirSync48(ledgerDir).filter((name10) => name10.endsWith(".json")).map((name10) => {
-      const filePath = join162(ledgerDir, name10);
-      const ledger = readJsonOrNull(filePath);
-      if (!ledger || !ledger.goal) return null;
-      const runId = ledger.runId || name10.replace(/\.json$/, "");
-      const workboard = readRestoreWorkboard(repoRoot, runId);
-      const score = scoreRestoreLedger(ledger, workboard);
-      const mtimeMs = statSync58(filePath).mtimeMs;
-      return { ledger: { ...ledger, runId }, workboard, score, mtimeMs };
-    }).filter((item) => Boolean(item));
-    candidates.sort((a2, b) => b.score - a2.score || b.mtimeMs - a2.mtimeMs);
-    const selected = candidates.find((candidate) => candidate.score >= 18);
-    return selected ?? null;
-  } catch {
-    return null;
-  }
-}
 function formatActiveTaskAnchor(selected) {
   const ledger = selected.ledger;
   const evidence = ledger.evidence ?? [];
@@ -732285,31 +732232,9 @@ ${evidenceLines.join("\n")}
 ${unresolvedLines.join("\n")}
 ` : "") + (boardCards.length > 0 ? `Active workboard cards:
 ${boardCards.join("\n")}
-` : "") + `Continuation rule: when the user asks to continue, resume this active task unless the new prompt names a different target.
+` : "") + `Continuation rule: this frontier is active only because its exact durable interruption identity was selected.
 </active-task-anchor>`;
 }
-function uniqueSessionIds(ids) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const raw of ids) {
-    const id2 = String(raw || "").trim();
-    if (!id2 || seen.has(id2)) continue;
-    seen.add(id2);
-    out.push(id2);
-  }
-  return out;
-}
-function collectRestoreSessionIds(ctx3, activeTask, historySessionId) {
-  const entries2 = ctx3?.entries ?? [];
-  const usefulEntries = entries2.filter((entry) => !isManualSessionEntry(entry));
-  const chronological = usefulEntries.length > 0 ? usefulEntries : entries2;
-  return uniqueSessionIds([
-    activeTask?.ledger.runId,
-    ...[...chronological].reverse().map((entry) => entry.sessionId),
-    ...[...entries2].reverse().map((entry) => entry.sessionId),
-    historySessionId
-  ]);
-}
 function childMapForTodos(todos) {
   const byId = new Set(todos.map((todo) => todo.id));
   const byParent = /* @__PURE__ */ new Map();
@@ -732382,20 +732307,8 @@ ${treeLines.join("\n")}${omitted > 0 ? `
 Continuation contract: this is the live checklist from the restored run. Continue it and update it with todo_write; do not recreate a parallel plan unless the new user request explicitly changes direction.
 </restored-todo-state>`;
 }
-function findRestoredTodoState(sessionIds) {
-  for (const sessionId of sessionIds) {
-    const todos = readTodos(sessionId).filter((todo) => todo && todo.id && todo.content);
-    if (todos.length === 0) continue;
-    return {
-      sessionId,
-      todos,
-      block: buildRestoredTodoBlock(sessionId, todos)
-    };
-  }
-  return null;
-}
-function buildRestoreHistoryAnchor(repoRoot) {
-  const [latest] = listSessions(repoRoot);
+function buildRestoreHistoryAnchor(repoRoot, exactSessionId) {
+  const latest = exactSessionId ? listSessions(repoRoot).find((entry) => entry.id === exactSessionId) : listSessions(repoRoot)[0];
   if (!latest?.id) return null;
   const lines = loadSessionHistory(repoRoot, latest.id) ?? [];
   const recordedLineCount = lines.filter((line) => String(line ?? "").trim()).length;
@@ -732411,6 +732324,76 @@ Recall contract: do not replay or ingest the transcript wholesale. Use the struc
 </restored-interface-history>`;
   return { sessionId: latest.id, path: path16, lineCount: recordedLineCount, block };
 }
+function buildExactContinuationSnapshot(repoRoot, pendingTask) {
+  const identity3 = pendingTask.interruption;
+  if (!identity3) return null;
+  if (pendingTask.projectRoot && resolve77(pendingTask.projectRoot) !== resolve77(repoRoot)) {
+    return null;
+  }
+  const ledgerPath2 = join162(
+    repoRoot,
+    OMNIUS_DIR2,
+    "completion-ledgers",
+    `${identity3.runId}.json`
+  );
+  const rawLedger = readJsonOrNull(ledgerPath2);
+  const ledger = rawLedger && (!rawLedger.runId || rawLedger.runId === identity3.runId) && (!rawLedger.taskEpoch || rawLedger.taskEpoch === identity3.taskEpoch) ? { ...rawLedger, runId: identity3.runId } : null;
+  const rawWorkboard = readRestoreWorkboard(repoRoot, identity3.runId);
+  const workboard = rawWorkboard && (!rawWorkboard.runId || rawWorkboard.runId === identity3.runId) && (!rawWorkboard.taskEpoch || rawWorkboard.taskEpoch === identity3.taskEpoch) ? rawWorkboard : null;
+  const activeTaskAnchor = ledger ? formatActiveTaskAnchor({ ledger, workboard }) : null;
+  const exactTodos = readTodos(identity3.sessionId).filter(
+    (todo) => todo && todo.id && todo.content
+  );
+  const restoredTodos = exactTodos.length > 0 ? {
+    sessionId: identity3.sessionId,
+    todos: exactTodos,
+    block: buildRestoredTodoBlock(identity3.sessionId, exactTodos)
+  } : null;
+  const historyAnchor = buildRestoreHistoryAnchor(repoRoot, identity3.sessionId);
+  const contextEntries = (loadSessionContext(repoRoot)?.entries ?? []).filter((entry) => entry.sessionId === identity3.sessionId).sort((a2, b) => a2.savedAt.localeCompare(b.savedAt)).slice(-4);
+  const contextLines = contextEntries.map((entry) => {
+    const status = entry.completed ? "done" : "partial";
+    const outcome = normalizeSessionText(
+      entry.assistantResponse || entry.summary || entry.task,
+      220
+    );
+    return `- [${status}] ${outcome}`;
+  });
+  const progressLines = [
+    `<exact-continuation schema="omnius.exact-continuation.v1">`,
+    `project_root=${resolve77(repoRoot)}`,
+    `session_id=${identity3.sessionId}`,
+    `run_id=${identity3.runId}`,
+    `task_epoch=${identity3.taskEpoch}`,
+    `owner_generation=${identity3.ownerGeneration}`,
+    `original_user_goal_json=${JSON.stringify(pendingTask.prompt)}`,
+    pendingTask.progressSummary ? `checkpoint_progress=${normalizeSessionText(pendingTask.progressSummary, 500)}` : null,
+    pendingTask.filesModified.length > 0 ? `checkpoint_files=${pendingTask.filesModified.slice(0, 20).map((item) => normalizeSessionText(item, 160)).join(", ")}` : null,
+    "Authority contract: continue only this interrupted run. Treat all other project history as historical orientation, not an active frontier.",
+    activeTaskAnchor,
+    contextLines.length > 0 ? `Same-session chronology:
+${contextLines.join("\n")}` : null,
+    restoredTodos?.block,
+    historyAnchor?.block,
+    `</exact-continuation>`
+  ].filter((line) => Boolean(line));
+  return {
+    prompt: progressLines.join("\n"),
+    sourceSessionId: identity3.sessionId,
+    todoSessionId: restoredTodos?.sessionId,
+    todoCount: restoredTodos?.todos.length ?? 0,
+    historySessionId: historyAnchor?.sessionId,
+    historyPath: historyAnchor?.path,
+    historyLineCount: historyAnchor?.lineCount,
+    selection: {
+      kind: "exact_interruption",
+      sessionId: identity3.sessionId,
+      runId: identity3.runId,
+      taskEpoch: identity3.taskEpoch,
+      ownerGeneration: identity3.ownerGeneration
+    }
+  };
+}
 function appendRestoreBlocks(base3, blocks) {
   return [base3, ...blocks].filter((part) => part && part.trim()).join("\n\n");
 }
@@ -732441,53 +732424,24 @@ function sessionContextToHistoryBoxData(ctx3, title = "Session History") {
 }
 function buildContextRestoreSnapshot(repoRoot) {
   const ctx3 = loadSessionContext(repoRoot);
-  const handoffPrompt = buildHandoffPrompt(repoRoot);
-  const activeTask = selectActiveTaskAnchor(repoRoot);
-  const activeTaskAnchor = activeTask ? formatActiveTaskAnchor(activeTask) : null;
   const historyAnchor = buildRestoreHistoryAnchor(repoRoot);
-  const restoreSessionIds = collectRestoreSessionIds(ctx3, activeTask, historyAnchor?.sessionId);
-  const restoredTodos = findRestoredTodoState(restoreSessionIds);
-  const sourceSessionId = restoredTodos?.sessionId ?? restoreSessionIds[0];
-  if (handoffPrompt) {
-    const safeHandoffPrompt = stripModelContextNoise(handoffPrompt);
-    const usefulEntries2 = (ctx3?.entries ?? []).filter((entry) => !isManualSessionEntry(entry));
-    const baseCtx = ctx3 && ctx3.entries.length > 0 ? `
-
-<session-recap>
-Recent tasks: ${(usefulEntries2.length > 0 ? usefulEntries2 : ctx3.entries).slice(-3).map(
-      (e2) => `[${e2.completed ? "done" : "partial"}] ${normalizeSessionText(e2.summary || e2.task, 80)}`
-    ).join(", ")}
-</session-recap>` : "";
-    const prompt2 = appendRestoreBlocks(
-      safeHandoffPrompt + (activeTaskAnchor ? `
-
-${activeTaskAnchor}` : "") + baseCtx,
-      [restoredTodos?.block, historyAnchor?.block]
-    );
-    return {
-      prompt: prompt2,
-      sourceSessionId,
-      todoSessionId: restoredTodos?.sessionId,
-      todoCount: restoredTodos?.todos.length ?? 0,
-      historySessionId: historyAnchor?.sessionId,
-      historyPath: historyAnchor?.path,
-      historyLineCount: historyAnchor?.lineCount
-    };
-  }
+  const usefulEntries = (ctx3?.entries ?? []).filter(
+    (entry) => !isManualSessionEntry(entry)
+  );
+  const chronological = usefulEntries.length > 0 ? usefulEntries : ctx3?.entries ?? [];
+  const sourceSessionId = chronological.at(-1)?.sessionId ?? historyAnchor?.sessionId;
   if (!ctx3 || ctx3.entries.length === 0) {
-    const prompt2 = appendRestoreBlocks(activeTaskAnchor ?? "", [restoredTodos?.block, historyAnchor?.block]);
+    const prompt2 = appendRestoreBlocks("", [historyAnchor?.block]);
     if (!prompt2.trim()) return null;
     return {
       prompt: prompt2,
       sourceSessionId,
-      todoSessionId: restoredTodos?.sessionId,
-      todoCount: restoredTodos?.todos.length ?? 0,
+      todoCount: 0,
       historySessionId: historyAnchor?.sessionId,
       historyPath: historyAnchor?.path,
       historyLineCount: historyAnchor?.lineCount
     };
   }
-  const usefulEntries = ctx3.entries.filter((entry) => !isManualSessionEntry(entry));
   const recent = (usefulEntries.length > 0 ? usefulEntries : ctx3.entries).slice(-20);
   const chronology = recent.map((e2) => {
     const status = e2.completed ? "done" : "partial";
@@ -732511,9 +732465,7 @@ Provenance: ${last2.provenance} (file_read to expand)` : "";
 KG summary: .omnius/context/kg-summary/latest.md (file_read to expand; legacy pointer: .omnius/context/kg-summary-latest.md)`;
   const prompt = appendRestoreBlocks(
     `<session-recap>
-` + (activeTaskAnchor ? `${activeTaskAnchor}
-
-` : "") + `Project chronology (older to newer):
+Project chronology (older to newer):
 Scope: full retained rolling window (${recent.length} entr${recent.length === 1 ? "y" : "ies"}).
 ${chronology.join("\n")}
 ` + (latestCompleted ? `
@@ -732521,16 +732473,14 @@ ${latestCompleted}
 ` : "\n") + `
 Recent structured task state (older to newer; transcript omitted from model context):
 ${recentTaskState}
-` + (activeTaskAnchor ? `For continuation prompts, resume the active task anchor above; use chronology only to avoid repeating completed work.${prov}${kg}
-` : `Continue from the latest exchange and do not repeat completed work.${prov}${kg}
-`) + `</session-recap>`,
-    [restoredTodos?.block, historyAnchor?.block]
+This chronology is historical orientation only. It does not select an active task, todo tree, or run. Use an exact interruption checkpoint or an explicit lifecycle command for continuation authority.${prov}${kg}
+</session-recap>`,
+    [historyAnchor?.block]
   );
   return {
     prompt,
     sourceSessionId,
-    todoSessionId: restoredTodos?.sessionId,
-    todoCount: restoredTodos?.todos.length ?? 0,
+    todoCount: 0,
     historySessionId: historyAnchor?.sessionId,
     historyPath: historyAnchor?.path,
     historyLineCount: historyAnchor?.lineCount
@@ -732982,7 +732932,7 @@ function deleteUsageRecord(kind, value2, repoRoot) {
     remove(join162(repoRoot, OMNIUS_DIR2, USAGE_HISTORY_FILE));
   }
 }
-var OMNIUS_DIR2, LEGACY_DIRS, SUBDIRS, gitignoreWatchers, gitignoreRetryTimers, CONTEXT_FILES, PENDING_TASK_FILE, HANDOFF_FILE, CONTEXT_SAVE_FILE, CONTEXT_LEDGER_FILE, COMPACTION_AUDIT_FILE, MAX_CONTEXT_ENTRIES, MAX_SESSION_DIARY_ENTRIES, MAX_SESSION_DIARY_DETAILED_ENTRIES, MAX_CONTEXT_LEDGER_LINES, MAX_CONTEXT_LEDGER_BYTES, SAME_TASK_REPLACE_WINDOW_MS, LOCK_TIMEOUT_MS, LOCK_RETRY_MS, LOCK_RETRY_MAX, MODEL_CONTEXT_NOISE_LINE_RE, DEFAULT_RESTORED_SESSION_HISTORY_MAX_LINES, DEICTIC_CONTINUATION_TERMS, SESSIONS_DIR, SESSIONS_INDEX, TUI_STATE_SUFFIX, AUTHORED_SESSION_LINE, VISUAL_CHROME_LINE, SESSION_TITLE_STATUS_LINE, SKIP_DIRS2, HOME_SKIP_DIRS, USAGE_HISTORY_FILE, MAX_HISTORY_RECORDS;
+var OMNIUS_DIR2, LEGACY_DIRS, SUBDIRS, gitignoreWatchers, gitignoreRetryTimers, CONTEXT_FILES, PENDING_TASK_FILE, HANDOFF_FILE, CONTEXT_SAVE_FILE, CONTEXT_LEDGER_FILE, COMPACTION_AUDIT_FILE, MAX_CONTEXT_ENTRIES, MAX_SESSION_DIARY_ENTRIES, MAX_SESSION_DIARY_DETAILED_ENTRIES, MAX_CONTEXT_LEDGER_LINES, MAX_CONTEXT_LEDGER_BYTES, SAME_TASK_REPLACE_WINDOW_MS, LOCK_TIMEOUT_MS, LOCK_RETRY_MS, LOCK_RETRY_MAX, MODEL_CONTEXT_NOISE_LINE_RE, DEFAULT_RESTORED_SESSION_HISTORY_MAX_LINES, SESSIONS_DIR, SESSIONS_INDEX, TUI_STATE_SUFFIX, AUTHORED_SESSION_LINE, VISUAL_CHROME_LINE, SESSION_TITLE_STATUS_LINE, SKIP_DIRS2, HOME_SKIP_DIRS, USAGE_HISTORY_FILE, MAX_HISTORY_RECORDS;
 var init_omnius_directory = __esm({
   "packages/cli/src/tui/omnius-directory.ts"() {
     init_dist5();
@@ -733019,34 +732969,6 @@ var init_omnius_directory = __esm({
     LOCK_RETRY_MAX = 100;
     MODEL_CONTEXT_NOISE_LINE_RE = /^\s*(?:🔊|E Task timeout reached|E Incomplete:|⚠ Task incomplete|Tokens:\s*[\d,]+|▹\s*continue\b|·\s*(?:Starting fresh|Context (?:auto-)?restored|Nexus P2P network connected|REST API:|Voice feedback enabled|Memory maintenance:|Memory:|reclaimed\s+(?:\d|space\b)|physical footprint:)|.*\bSHELL TRANSCRIPT\b.*).*$/i;
     DEFAULT_RESTORED_SESSION_HISTORY_MAX_LINES = 600;
-    DEICTIC_CONTINUATION_TERMS = /* @__PURE__ */ new Set([
-      "again",
-      "and",
-      "back",
-      "carry",
-      "complete",
-      "continue",
-      "finish",
-      "from",
-      "last",
-      "latest",
-      "left",
-      "my",
-      "off",
-      "please",
-      "previous",
-      "prior",
-      "proceed",
-      "request",
-      "resume",
-      "task",
-      "that",
-      "the",
-      "this",
-      "to",
-      "try",
-      "work"
-    ]);
     SESSIONS_DIR = "sessions";
     SESSIONS_INDEX = "sessions-index.json";
     TUI_STATE_SUFFIX = ".tui-state.json";
@@ -767195,7 +767117,7 @@ sleep 1
       }
       const paused = ctx3.pauseTask?.() ?? false;
       if (interruptionAccepted(paused)) {
-        ctx3.savePendingTaskState?.();
+        ctx3.savePendingTaskState?.({ reason: "pause", resumeOnStartup: false });
         renderInfo(interruptionMessage(paused, "Task paused."));
       } else {
         renderWarning(interruptionMessage(paused, "Could not pause the task."));
@@ -777335,7 +777257,7 @@ async function handleUpdate(subcommand, ctx3) {
         `Updated Omnius v${currentVersion} → v${terminal.installed_version ?? info.latestVersion}; daemon v${terminal.daemon_version ?? info.latestVersion}${terminal.tray_was_running ? ", indicator restarted" : ""}.`
       );
       ctx3.contextSave?.();
-      ctx3.savePendingTaskState?.();
+      ctx3.savePendingTaskState?.({ reason: "update", resumeOnStartup: true });
       if (ctx3.hasActiveTask?.()) ctx3.abortActiveTask?.({ preserveResume: true });
       ctx3.killEphemeral?.({ preserveInfrastructure: true });
       process.exit(120);
@@ -777924,7 +777846,7 @@ async function handleUpdate(subcommand, ctx3) {
     !daemonUpgrade.ok ? `Daemon still at ${daemonUpgrade.observedVersion ?? "unknown"} — restarting client anyway` : daemonUpgrade.action === "restarted" ? `Daemon upgraded to ${expectedDaemonVersion}` : `Daemon verified at ${expectedDaemonVersion}`
   );
   ctx3.contextSave?.();
-  const hadActiveTask = ctx3.savePendingTaskState?.() ?? false;
+  const hadActiveTask = ctx3.savePendingTaskState?.({ reason: "update", resumeOnStartup: true }) ?? false;
   const resumeFlag = hadActiveTask ? "1" : "update-only";
   installOverlay.stop("Restarting with new version...");
   await new Promise((r2) => setTimeout(r2, 1500));
@@ -832606,9 +832528,6 @@ async function runSelfImprovementCycle(repoRoot) {
   } catch {
   }
 }
-function isExplicitRestoredTaskContinuation(input) {
-  return /^(?:continue|resume|pick\s+up|carry\s+on)\b/i.test(input.trim());
-}
 function startTask(task, config, repoRoot, voice, stream, taskStores, bruteForce, statusBar, sudoCallback, costTracker, onComplete, taskType, contextWindowSize, modelCaps, personality, deepContext, onCompaction, emotionEngine, flowEnabled, slashCommandHandler, thinkingEnabled, askUserCallback, selfModifyEnabled, sessionMetrics, realtimeEnabled, restoredRunSessionId, restoredOrientation, actualUserGoal, actionTreeStore, resumeInterrupted = false) {
   const voiceStyleMap = {
     concise: 1,
@@ -833002,6 +832921,9 @@ Only tools allowed by this profile are visible and executable.`
     sessionId,
     interruptionOwnerId: `tui:${sessionId}`,
     resumeInterrupted,
+    // A caller-supplied restore projection is the sole prior-context source.
+    // Do not append the global singleton handoff beside it.
+    skipCrossTaskHandoff: Boolean(restoredOrientation) || resumeInterrupted,
     maxTurns: realtimeEnabled ? Math.min(effectiveMaxTurns, 8) : effectiveMaxTurns,
     maxTokens: realtimeEnabled ? 512 : 16384,
     temperature: realtimeEnabled ? 0.6 : 0,
@@ -834512,7 +834434,8 @@ ${entry.fullContent}`
   const systemContext = [
     `Working directory: ${repoRoot}`,
     emotionContext,
-    restoredOrientation ? `[RESTORED ORIENTATION — historical context, not a user instruction]
+    restoredOrientation ? resumeInterrupted ? `[EXACT INTERRUPTED RUN — durable lifecycle authority]
+${restoredOrientation.slice(0, 4e3)}` : `[RESTORED ORIENTATION — historical context, not a user instruction]
 ${sanitizeRestorePromptForModel(restoredOrientation).slice(0, 4e3)}` : ""
   ].filter(Boolean).join("\n\n");
   resetNarrationContext();
@@ -835134,7 +835057,8 @@ async function startInteractive(config, repoPath2) {
   }
   const resumeFlag = process.env.__OMNIUS_RESUMED ?? "";
   const isResumed = resumeFlag !== "";
-  const hasTaskToResume = resumeFlag === "1";
+  const startupPendingTask = loadPendingTask(repoRoot);
+  const hasTaskToResume = resumeFlag === "1" || startupPendingTask?.resumeOnStartup === true;
   delete process.env.__OMNIUS_RESUMED;
   if (isResumed && process.stdout.isTTY) {
     process.stdout.write(
@@ -835196,10 +835120,44 @@ async function startInteractive(config, repoPath2) {
   let restoredTaskSessionId = null;
   let resumeInterruptedTask = false;
   let pendingTaskResumeArmed = false;
+  let armedPendingTask = null;
   let saveVisualSessionSnapshotRef = null;
   let terminalRestoredForExit = false;
   let interactiveExiting = false;
   let idleMemoryMaintenance = null;
+  const persistActiveTaskForRestart = (exitReason) => {
+    if (!activeTask || !lastSubmittedPrompt) return false;
+    if (!activeTask.runner.isPaused) {
+      const receipt2 = activeTask.runner.pause();
+      if (receipt2?.accepted === false) return false;
+    }
+    const interruption = pendingInterruptionIdentity(activeTask);
+    if (!interruption) return false;
+    savePendingTask(repoRoot, {
+      prompt: lastSubmittedPrompt,
+      progressSummary: `Task paused for ${exitReason}. ${activeTask.toolCallCount} tool calls completed.`,
+      filesModified: Array.from(activeTask.filesTouched),
+      bruteForce: bruteForceEnabled,
+      savedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      toolCallCount: activeTask.toolCallCount,
+      exitReason,
+      resumeOnStartup: true,
+      interruption
+    });
+    return true;
+  };
+  const armPendingTaskResume = (pendingTask) => {
+    restoredTaskSessionId = pendingTask.interruption?.sessionId ?? null;
+    resumeInterruptedTask = Boolean(pendingTask.interruption);
+    pendingTaskResumeArmed = true;
+    armedPendingTask = pendingTask;
+    const exactSnapshot = buildExactContinuationSnapshot(repoRoot, pendingTask);
+    restoredSessionContext = exactSnapshot?.prompt ?? [
+      `Original user goal: ${pendingTask.prompt}`,
+      pendingTask.progressSummary,
+      pendingTask.filesModified.length > 0 ? `Modified: ${pendingTask.filesModified.slice(0, 20).join(", ")}` : ""
+    ].filter(Boolean).join("\n");
+  };
   const restoreTerminalForExit = () => {
     if (!process.stdout.isTTY || terminalRestoredForExit) return;
     terminalRestoredForExit = true;
@@ -835231,18 +835189,7 @@ async function startInteractive(config, repoPath2) {
       }
       if (activeTask) {
         if (interruption === "pause") {
-          const receipt2 = activeTask.runner.pause();
-          if (receipt2?.accepted !== false && lastSubmittedPrompt) {
-            savePendingTask(repoRoot, {
-              prompt: lastSubmittedPrompt,
-              progressSummary: `Task paused during process shutdown. ${activeTask.toolCallCount} tool calls completed.`,
-              filesModified: Array.from(activeTask.filesTouched),
-              bruteForce: bruteForceEnabled,
-              savedAt: (/* @__PURE__ */ new Date()).toISOString(),
-              toolCallCount: activeTask.toolCallCount,
-              interruption: pendingInterruptionIdentity(activeTask)
-            });
-          }
+          persistActiveTaskForRestart("shutdown");
         } else {
           activeTask.runner.abort();
           discardPendingTask(repoRoot);
@@ -837089,9 +837036,9 @@ This is an independent background session started from /background.`
     if (options2.injectNextTask !== false) {
       restoredSessionContext = snapshot.prompt;
     }
-    const restoredId = snapshot.todoSessionId || snapshot.sourceSessionId || null;
-    restoredTaskSessionId = restoredId;
-    if (restoredId) {
+    const restoredId = options2.bindTaskIdentity && snapshot.selection ? snapshot.selection.sessionId : null;
+    if (restoredId && snapshot.selection?.kind === "exact_interruption") {
+      restoredTaskSessionId = restoredId;
       try {
         process.env["OMNIUS_SESSION_ID"] = restoredId;
       } catch {
@@ -838195,8 +838142,14 @@ The user pasted a clipboard image saved at ${relPath}. Use the OCR, vision analy
       } catch {
       }
     },
-    savePendingTaskState() {
+    savePendingTaskState(options2) {
       if (lastSubmittedPrompt && activeTask) {
+        if (!activeTask.runner.isPaused) {
+          const receipt2 = activeTask.runner.pause();
+          if (receipt2?.accepted === false) return false;
+        }
+        const interruption = pendingInterruptionIdentity(activeTask);
+        if (!interruption) return false;
         const activeToolCallCount = activeTask.toolCallCount;
         const activeFilesTouched = Array.from(activeTask.filesTouched);
         savePendingTask(repoRoot, {
@@ -838206,7 +838159,9 @@ The user pasted a clipboard image saved at ${relPath}. Use the OCR, vision analy
           bruteForce: bruteForceEnabled,
           savedAt: (/* @__PURE__ */ new Date()).toISOString(),
           toolCallCount: activeToolCallCount,
-          interruption: pendingInterruptionIdentity(activeTask)
+          exitReason: options2?.reason ?? "pause",
+          resumeOnStartup: options2?.resumeOnStartup === true,
+          interruption
         });
         return true;
       }
@@ -839881,19 +839836,11 @@ Respond concisely and safely. Remember: you are talking to the general public.`;
     resumeTask() {
       const pendingTask = loadPendingTask(repoRoot);
       if (!pendingTask) return false;
-      restoredTaskSessionId = pendingTask.interruption?.sessionId ?? null;
-      resumeInterruptedTask = Boolean(pendingTask.interruption);
-      pendingTaskResumeArmed = true;
+      armPendingTaskResume(pendingTask);
       setTimeout(() => {
-        const resumeContext = [
-          `Continuing previous task: ${pendingTask.prompt}`,
-          pendingTask.progressSummary ? `Progress: ${pendingTask.progressSummary}` : "",
-          pendingTask.filesModified.length > 0 ? `Modified: ${pendingTask.filesModified.slice(0, 5).join(", ")}` : "",
-          "Continue where you left off."
-        ].filter(Boolean).join("\n");
         const shortPrompt = pendingTask.prompt.slice(0, 40) + (pendingTask.prompt.length > 40 ? "..." : "");
         writeContent(() => renderInfo(`Picking up: ${shortPrompt}`));
-        rl.emit("line", resumeContext);
+        rl.emit("line", pendingTask.prompt);
       }, 100);
       return true;
     },
@@ -840151,7 +840098,7 @@ Respond concisely and safely. Remember: you are talking to the general public.`;
   }
   statusBar.ensureMonitorTimer();
   showPrompt();
-  if (!isResumed) {
+  if (!isResumed && !hasTaskToResume) {
     const savedCtx = loadSessionContext(repoRoot);
     if (savedCtx && savedCtx.entries.length > 0) {
       const lastEntry = savedCtx.entries[savedCtx.entries.length - 1];
@@ -840277,30 +840224,13 @@ Respond concisely and safely. Remember: you are talking to the general public.`;
   }
   startReminderDispatcher();
   if (hasTaskToResume) {
-    const pendingTask = loadPendingTask(repoRoot);
+    const pendingTask = startupPendingTask ?? loadPendingTask(repoRoot);
     if (pendingTask) {
-      restoredTaskSessionId = pendingTask.interruption?.sessionId ?? null;
-      resumeInterruptedTask = Boolean(pendingTask.interruption);
-      pendingTaskResumeArmed = true;
+      armPendingTaskResume(pendingTask);
       setTimeout(() => {
-        const restoreSnapshot = buildContextRestoreSnapshot(repoRoot);
-        if (restoreSnapshot) {
-          applyRestoreSnapshot(restoreSnapshot, {
-            replayVisual: false,
-            injectNextTask: false
-          });
-        }
-        const sessionCtx = restoreSnapshot?.prompt ?? buildContextRestorePrompt(repoRoot);
-        const resumeContext = [
-          sessionCtx || "",
-          `Continuing task after update: ${pendingTask.prompt}`,
-          pendingTask.progressSummary ? `Progress: ${pendingTask.progressSummary}` : "",
-          pendingTask.filesModified.length > 0 ? `Modified: ${pendingTask.filesModified.slice(0, 5).join(", ")}` : "",
-          "Continue where you left off."
-        ].filter(Boolean).join("\n");
         const shortPrompt = pendingTask.prompt.slice(0, 40) + (pendingTask.prompt.length > 40 ? "..." : "");
         writeContent(() => renderInfo(`Picking up: ${shortPrompt}`));
-        rl.emit("line", resumeContext);
+        rl.emit("line", pendingTask.prompt);
       }, 100);
     }
   }
@@ -840492,10 +840422,7 @@ ${result.content.slice(0, 2e3)}${result.content.length > 2e3 ? "\n[truncated]" :
       if (quitMatch === "quit" || quitMatch === "exit" || quitMatch === "q") {
         interactiveExiting = true;
         saveVisualSessionSnapshot();
-        if (activeTask) {
-          activeTask.runner.abort();
-          discardPendingTask(repoRoot);
-        }
+        if (activeTask) persistActiveTaskForRestart("quit");
         idleMemoryMaintenance?.stop();
         taskManager.stopAll();
         if (blessEngine?.isActive) blessEngine.stop();
@@ -840513,10 +840440,7 @@ ${result.content.slice(0, 2e3)}${result.content.length > 2e3 ? "\n[truncated]" :
       if (cmdResult === "exit") {
         interactiveExiting = true;
         saveVisualSessionSnapshot();
-        if (activeTask) {
-          activeTask.runner.abort();
-          discardPendingTask(repoRoot);
-        }
+        if (activeTask) persistActiveTaskForRestart("quit");
         idleMemoryMaintenance?.stop();
         taskManager.stopAll();
         if (telegramBridge) await telegramBridge.stopAndWait();
@@ -841078,6 +841002,10 @@ ${formatTaskCompletionMeta(previousMetaForIntake)}`
       );
     }
     if (promptRecallCancelled) return;
+    const pendingTaskForAdmission = pendingTaskResumeArmed ? armedPendingTask : null;
+    if (pendingTaskForAdmission) {
+      fullInput = pendingTaskForAdmission.prompt;
+    }
     lastSubmittedPrompt = fullInput;
     const taskPreview = fullInput.length > 100 ? fullInput.slice(0, 100) + "..." : fullInput;
     emotionEngine.setCurrentTask(taskPreview);
@@ -841094,18 +841022,19 @@ ${formatTaskCompletionMeta(previousMetaForIntake)}`
     } catch {
     }
     let taskInput = fullInput;
-    const reuseRestoredTaskSession = Boolean(restoredTaskSessionId) && (resumeInterruptedTask || isExplicitRestoredTaskContinuation(fullInput));
+    const reuseRestoredTaskSession = Boolean(restoredTaskSessionId) && resumeInterruptedTask && Boolean(pendingTaskForAdmission?.interruption);
     let taskSessionId = reuseRestoredTaskSession ? restoredTaskSessionId : null;
     const adoptInterruptedGeneration = reuseRestoredTaskSession && resumeInterruptedTask;
     const consumePendingTaskAfterAdmission = pendingTaskResumeArmed;
     let restoredOrientation = null;
     if (restoredSessionContext) {
-      restoredOrientation = sanitizeRestorePromptForModel(restoredSessionContext);
+      restoredOrientation = pendingTaskForAdmission ? restoredSessionContext : sanitizeRestorePromptForModel(restoredSessionContext);
       restoredSessionContext = null;
     }
     restoredTaskSessionId = null;
     resumeInterruptedTask = false;
     pendingTaskResumeArmed = false;
+    armedPendingTask = null;
     if (taskIntakePacket) {
       taskInput = `${taskIntakePacket}
 
@@ -841162,14 +841091,23 @@ ${taskInput}`;
         realtimeEnabled,
         taskSessionId,
         restoredOrientation,
-        fullInput,
+        pendingTaskForAdmission?.prompt ?? fullInput,
         idleActionTree,
         adoptInterruptedGeneration
       );
       activeTask = task;
       if (consumePendingTaskAfterAdmission) {
         const adopted = task.runner.interruptionState;
-        if (!adoptInterruptedGeneration || adopted?.phase === "running" && adopted.sessionId === taskSessionId) {
+        if (pendingTaskForAdmission && !pendingTaskForAdmission.interruption || pendingTaskForAdmission && pendingTaskMatchesRunningInterruption(
+          pendingTaskForAdmission,
+          adopted ? {
+            sessionId: adopted.sessionId,
+            runId: adopted.runId,
+            taskEpoch: adopted.taskEpoch,
+            ownerGeneration: adopted.owner.generation,
+            phase: adopted.phase
+          } : null
+        )) {
           discardPendingTask(repoRoot);
         }
       }
@@ -841227,6 +841165,21 @@ ${taskInput}`;
         scheduleAgentSNREval(lastSubmittedPrompt);
       }
       if (activeTask) {
+        if (pendingTaskForAdmission?.interruption) {
+          const state5 = activeTask.runner.interruptionState;
+          if (state5 && state5.phase !== "running" && state5.phase !== "pausing" && state5.phase !== "paused" && state5.phase !== "resuming" && pendingTaskMatchesInterruptionIdentity(
+            pendingTaskForAdmission,
+            {
+              sessionId: state5.sessionId,
+              runId: state5.runId,
+              taskEpoch: state5.taskEpoch,
+              ownerGeneration: state5.owner.generation,
+              phase: state5.phase
+            }
+          )) {
+            discardPendingTask(repoRoot);
+          }
+        }
         sessionFilesTouched = Array.from(activeTask.filesTouched);
         sessionToolCallCount = activeTask.toolCallCount;
         sessionAvailableTools = Array.from(activeTask.availableTools);
@@ -841506,7 +841459,7 @@ Rationale: ${proposal.rationale}${provenanceNote}${dmnDevDiscipline(proposal.cat
       peerMesh = null;
       inferenceRouter = null;
     }
-    if (activeTask) activeTask.runner.abort();
+    if (activeTask) persistActiveTaskForRestart("shutdown");
     taskManager.stopAll();
     killAllFullSubAgents();
     idleMemoryMaintenance?.stop();
@@ -841600,6 +841553,8 @@ ${c3.dim("(Use /quit to exit)")}
         bruteForce: bruteForceEnabled,
         savedAt: (/* @__PURE__ */ new Date()).toISOString(),
         toolCallCount: activeTask.toolCallCount,
+        exitReason: "pause",
+        resumeOnStartup: false,
         interruption: pendingInterruptionIdentity(activeTask)
       });
     }

package/docs/DISCOVERY.json

@@ -33786,6 +33786,44 @@
         }
       ]
     },
+    {
+      "id": "guide.work-orders-runtime-health-remediation-wo-20-exact-session-continuation-uppercase",
+      "kind": "guide",
+      "title": "WO-20: Exact session continuation across exit and restart",
+      "summary": "On 2026-09-03, the telegramtest TUI displayed the latest pentest task during startup, but the first restored model context combined a completed breach.py handoff with an unrelated, older page.tsx todo tree. The user then entered continue, and Omnius continued the stale tree instead of the task that was active before /quit.",
+      "keywords": [
+        "work",
+        "orders",
+        "runtime",
+        "health",
+        "remediation",
+        "WO",
+        "20",
+        "exact",
+        "session",
+        "continuation",
+        "md"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/runtime-health-remediation/WO-20-exact-session-continuation.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/runtime-health-remediation/WO-20-exact-session-continuation.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.work-orders-telegram-dropbear-context-rca-workorder",
       "kind": "guide",

package/docs/DISCOVERY.md

@@ -558,6 +558,7 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `guide.work-orders-runtime-health-remediation-wo-18-interruption-evidence-uppercase` | WO-18 interruption lifecycle evidence | Scope: /pause, /resume, /stop, safe-boundary ownership, recovery, and stale-effect prevention. This record is independent of the shared remediation tracker and records only verified WO-18 implementation evidence. |
 | `guide.work-orders-runtime-health-remediation-wo-19-clean-build-evidence-uppercase` | WO-19 Clean Build Evidence | WO-19 is implemented in commit 5f253c05. |
 | `guide.work-orders-runtime-health-remediation-wo-19-clean-build-reproducibility-uppercase` | WO-19: Clean Build and Optional-Dependency Reproducibility | Status: deterministic acceptance complete Risk: medium Depends on: WO-00 |
+| `guide.work-orders-runtime-health-remediation-wo-20-exact-session-continuation-uppercase` | WO-20: Exact session continuation across exit and restart | On 2026-09-03, the telegramtest TUI displayed the latest pentest task during startup, but the first restored model context combined a completed breach.py handoff with an unrelated, older page.tsx todo tree. The user then entered continue, and Omnius continued the stale tree instead of the task that was active before /quit. |
 | `guide.work-orders-telegram-dropbear-context-rca-workorder` | Telegram Dropbear Context Engineering RCA Work Order | Observed run: /home/roko/Documents/Projects/Adjacent/telegramtest/.omnius, run id 1782873796963-i5r7mv. |
 | `guide.work-orders-wo-am-gaps-uppercase` | Associative Memory Gap Work Orders | Generated: 2026-04-13 Source: Deep audit of multimodal associative memory systems Status: READY FOR IMPLEMENTATION |
 | `guide.work-orders-world-class-memory-compiler-readme-uppercase` | World-Class Memory Compiler Program | Status: active implementation program Owner: Omnius orchestration and memory packages Last updated: 2026-07-13 |

package/docs/work-orders/runtime-health-remediation/TRACKER.md

@@ -309,3 +309,5 @@ deterministically repaired P0 or P1 defect.
   accessibility, and mocked inference end-to-end tests.
 - [x] WO-18 pause, stop, and resume use one durable interruption lifecycle and
   pass cancellation, restart, ownership, external-effect, and isolation tests.
+- [x] WO-20 exit and restart preserve one exact typed task continuation. Generic
+  context restoration cannot mix or activate unrelated historical artifacts.

package/docs/work-orders/runtime-health-remediation/WO-20-exact-session-continuation.md

@@ -0,0 +1,88 @@
+# WO-20: Exact session continuation across exit and restart
+
+## Incident
+
+On 2026-09-03, the `telegram_test` TUI displayed the latest pentest task during
+startup, but the first restored model context combined a completed `breach.py`
+handoff with an unrelated, older `page.tsx` todo tree. The user then entered
+`continue`, and Omnius continued the stale tree instead of the task that was
+active before `/quit`.
+
+## Root causes
+
+- `/quit`, `/exit`, readline close, and fallback exit abort an active runner.
+  The explicit quit paths also delete `.omnius/history/pending-task.json`.
+- Startup selects handoff, completion ledger, todo state, context chronology,
+  and visual history independently. These projections need not identify the
+  same session or run.
+- Generic restore mutates the process-wide task session, even though the
+  restored transcript is historical orientation only.
+- The host interprets words such as `continue` with a regular expression and
+  uses that classification to reuse a restored task identity.
+- A resumed task is submitted as a generated wrapper. The wrapper can replace
+  the original user goal in new completion, workboard, and handoff records.
+- Pending-task consumption checks only phase and session. It does not prove the
+  recovered run, epoch, and owner generation.
+- Updating an existing session-context entry changes its timestamp in place,
+  but does not move it into chronological order. Tail readers can therefore
+  report an older task as latest.
+
+## Required invariants
+
+- [x] An active task receives a typed, atomic continuation checkpoint before a
+  resumable exit.
+- [x] `/quit`, `/exit`, readline close, and graceful process termination pause
+  and preserve the active run. Explicit `/stop`, Ctrl+C, and double-Esc remain
+  terminal and delete the pending checkpoint.
+- [x] A checkpoint identifies the project, original goal, session, run, task
+  epoch, owner generation, lifecycle phase, exit reason, and capture time.
+- [x] Manual startup automatically adopts a checkpoint explicitly marked for
+  restart, without requiring an updater environment variable.
+- [x] Exact continuation context is scoped to the checkpoint session and run.
+  A global handoff, ledger, todo tree, or transcript cannot replace it.
+- [x] Generic context restore is orientation only. It does not bind task/todo
+  identity or mutate `OMNIUS_SESSION_ID`.
+- [x] Continuation authority comes from typed lifecycle state or an explicit
+  command. It never comes from semantic keyword or regular-expression
+  classification of user prose.
+- [x] The resumed runner receives the exact original user goal. Progress and
+  historical orientation remain separate context.
+- [x] A pending checkpoint is consumed only after the runner proves the same
+  session, run, epoch, and owner generation in the running phase.
+- [x] Session-context entries remain ordered by their effective save time after
+  merge or replacement.
+- [x] Corrupt, cross-project, incomplete, or identity-mismatched checkpoints
+  fail closed and remain available for diagnosis unless explicitly stopped.
+
+## Deterministic verification
+
+- [x] Pending checkpoint round-trip and schema validation.
+- [x] Exact four-field adoption match and one-field-at-a-time mismatch table.
+- [x] Quit wiring has no abort/discard path for an active resumable run.
+- [x] Restart continuation remains exact in the presence of a newer handoff,
+  higher-scoring stale ledger, unrelated todos, and unrelated visual history.
+- [x] Generic restore cannot bind a subsequent fresh task to historical todos.
+- [x] A resumed run persists the original goal, not a synthetic continuation
+  wrapper.
+- [x] Session-context merge reorders the updated entry chronologically.
+- [x] Focused CLI typecheck/build and affected tests pass.
+
+## Delivery evidence
+
+Implemented in the CLI session directory, TUI lifecycle coordinator, command
+surface, and runner continuation gate. Verification on 2026-09-03:
+
+- Focused CLI interruption, restore, session-diary, and command suites: 52
+  passed.
+- Focused orchestrator context and interruption suites: 67 passed.
+- Complete orchestrator suite: 2,292 passed, 14 skipped.
+- Complete CLI suite: 2,425 passed. Two unrelated tests timed out while the CLI
+  and orchestrator suites ran concurrently; both passed alone, 35 of 35.
+- CLI and orchestrator typechecks passed.
+- CLI and orchestrator builds passed.
+- A two-process, no-inference harness wrote the checkpoint in one process and
+  recovered the exact `harness-session/harness-run/epoch-3` selection in a
+  second process.
+
+No live inference or service restart was required for this host-side
+state-machine repair.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "omnius",
-  "version": "1.0.688",
+  "version": "1.0.689",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omnius",
-      "version": "1.0.688",
+      "version": "1.0.689",
       "bundleDependencies": [
         "image-to-ascii"
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omnius",
-  "version": "1.0.688",
+  "version": "1.0.689",
   "description": "AI coding agent powered by open-source models (Ollama/vLLM) — interactive TUI with agentic tool-calling loop",
   "type": "module",
   "main": "./dist/library.js",