@lawaty/lacode 1.3.1 → 2.0.0-beta.0

package/CHANGELOG.md

@@ -9,6 +9,23 @@ commit as the changelog entry it describes.
 
 ## [Unreleased]
 
+## [2.0.0-beta.0] — The timeline remembers, and the map has one job
+
+### Added
+
+- Durable timeline state: each session's cursor, pending flag, failure count, and next retry time are written beside the timeline JSONL. Pending work resumes after a restart, a successful summary with no bullet text still advances the durable cursor, and deleting a session removes both files.
+- Exponential backoff for failed timeline summarizations. A failure marks the slice pending and schedules a retry; repeated failures grow the wait up to a cap; an idle event during the wait re-arms the timer instead of bypassing it.
+- `timeline.retryMs` and `timeline.maxBackoffMs` options.
+- User stories US-35 (a timeline survives a restart and resumes unfinished work) and US-36 (a failed timeline summary retries with backoff), with story tests in `tests/stories/j-timeline-reliability.test.mjs`.
+
+### Changed
+
+- The `.opencode/context/` map is now five navigation files only. The cartographer no longer creates or maintains `active.md`, the context plugin no longer normalizes a backlog, and `/context-init` and `/context-review` no longer mention one.
+
+### Removed
+
+- `src/lib/active-backlog.ts`, the `.opencode/context/active.md` map file, and its finished-task retention window. The timeline is the single record of work in flight.
+
 ## [1.3.1] — reprocess-timeline rebuilds the caller's timeline, and the pool refreshes daily
 
 ### Added
@@ -1115,7 +1132,8 @@ experimental; `latest` remains 0.4.2.
 
 - First published release: pooled subagents over a shared set of models.
 
-[Unreleased]: https://github.com/lawaty/lacode/compare/v1.3.1...HEAD
+[Unreleased]: https://github.com/lawaty/lacode/compare/v2.0.0-beta.0...HEAD
+[2.0.0-beta.0]: https://github.com/lawaty/lacode/compare/v1.3.1...v2.0.0-beta.0
 [1.3.1]: https://github.com/lawaty/lacode/releases/tag/v1.3.1
 [1.3.0-beta.9]: https://github.com/lawaty/lacode/releases/tag/v1.3.0-beta.9
 [1.3.0-beta.8]: https://github.com/lawaty/lacode/releases/tag/v1.3.0-beta.8

package/README.md

@@ -31,7 +31,6 @@ is also on disk at `node_modules/@lawaty/lacode/CHANGELOG.md`.
 | Distinct notification sounds | A popup says something happened, but not at a glance whether it is a finish, a question or a block. |
 | SSH notification tunnel | Work on a remote host raises its notification on that host, which has no desktop. |
 | Repository context map | Every task starts by exploring your codebase cold, re-deriving the same layout, entry points and boundaries. |
-| Active backlog | What is half-done, and what can be dropped, lives in chat history the next session cannot see. |
 | Standing instructions | The same direction gets repeated every session, or buried in config that is not per-clone. |
 | Image attachments anywhere | A TUI with no image support locks vision models out entirely. |
 
@@ -271,11 +270,9 @@ Agents are stateless between tasks, and exploring your repository is the most
 expensive part of any task — so every agent pays for it again, re-deriving the
 same layout, entry points and boundaries from scratch. LaCode keeps a short,
 maintained map of the repository in `.opencode/context/` — five navigation files
-(`architecture`, `contexts`, `conventions`, `workflows`, `decisions`) plus
-`active.md`, the active backlog, where a finished task stays a week and an open
-one stays until done — and injects a standing rule that every agent reads the
-relevant file before exploring and starts from the canonical entry points it
-lists. The map holds conclusions, not
+(`architecture`, `contexts`, `conventions`, `workflows`, `decisions`) — and injects
+a standing rule that every agent reads the relevant file before exploring and
+starts from the canonical entry points it lists. The map holds conclusions, not
 inventories: it answers "what should I look at first?" and nothing else, which
 is what makes reading it cheaper than the exploration it replaces.
 

package/dist/agents.js

@@ -124,8 +124,6 @@ You own exactly these files and nothing else:
   150 lines.**
 - \`.opencode/context/decisions.md\` \u2014 architectural constraints that bind future
   work. **At most 120 lines.**
-- \`.opencode/context/active.md\` \u2014 work in flight, grouped by the ISO week it was
-  opened. **At most 60 lines.**
 
 The unit is non-blank lines. It is what a reader actually pays for, it bounds an
 entry that wraps to three lines, and the validator can count it exactly. An
@@ -141,8 +139,6 @@ failed run, not a small one.
 
 The plugin applies this on every run. Write entries in the shape that lets it.
 
-- \`active.md\`: a finished task (\`[x]\` plus \`finished YYYY-MM-DD\`) is dropped
-  after 7 days. An open task never expires, however old it is.
 - \`architecture.md\`, \`contexts.md\`, \`conventions.md\`, \`workflows.md\`,
   \`decisions.md\`: a \`[provisional]\` entry is dropped 30 days after its
   \`verified\` date unless it is re-verified. \`[binding]\` and \`[disputed]\` are
@@ -236,8 +232,7 @@ You are mapping a city, not auditing every house. Do not attempt to understand
 every file.
 
 Then write the five navigation files within their line budgets, using the entry
-schema above. Also create \`.opencode/context/active.md\` with its heading and no
-tasks. For each significant subsystem, give a short "Start here" list \u2014 at most
+schema above. For each significant subsystem, give a short "Start here" list \u2014 at most
 about five canonical files, each with a one-phrase reason. This is the single
 most valuable thing you produce: where an agent should open its editor next.
 
@@ -271,37 +266,6 @@ update needed".
 Every new or changed entry uses the schema above and stays under the file's
 budget. If a file is already over budget, consolidate before adding anything.
 
-Also keep \`.opencode/context/active.md\` current: record work that is in flight,
-and mark a task finished \u2014 with the date it finished \u2014 when it is.
-
-# Task backlog
-
-\`.opencode/context/active.md\` holds the work in flight. It is a rolling window,
-not a history: it answers "what is open, and what just finished".
-
-Format \u2014 one line per task, under the ISO week the task was opened in:
-
-    ## 2026-W43
-
-    - [ ] Ship the release notes \u2014 opened 2026-W43
-    - [x] Fix the flaky test \u2014 opened 2026-W43, finished 2026-10-19
-
-The rules:
-
-- A task that is not marked \`[x]\` is OPEN. An open task is never removed,
-  however old it is.
-- A task is FINISHED when it is marked \`[x]\` AND carries a \`finished\` date.
-  Record the date it actually finished, as \`YYYY-MM-DD\`.
-- The week is \`YYYY-Www\`, Monday to Sunday. \`date +%G-W%V\` prints it.
-- A finished task is dropped once it is more than a week old. The plugin
-  enforces that: record the finished task with its date and let the window close
-  on its own. Do not delete old finished tasks by hand, and do not keep a
-  finished task back to preserve it \u2014 the file is meant to stay small.
-- Never invent a task. Record work that actually happened, and mark a task
-  finished only once it is finished.
-- Keep the file inside the window. If the backlog has grown past a handful of
-  weeks, that is a signal to close finished tasks, not to add sections.
-
 # Minimal exploration
 
 Default shape:
@@ -389,7 +353,7 @@ Never drop a binding constraint to make room.
 
 Trigger: an explicit review (see the \`context-review\` command).
 
-Audit the map files and the backlog for:
+Audit the map files for:
 
 - schema \u2014 every entry has one marker, at most three lines, a pointer, and a
   \`verified\` date
@@ -404,8 +368,6 @@ Audit the map files and the backlog for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything that is not \`[binding]\` or \`[disputed]\`
   should be \`[provisional]\`
-- backlog tasks that are finished but carry no date \u2014 the retention window
-  cannot age those out, so they stay forever
 
 Fix problems only in the files you own. Never modify source code or a project
 page during a review. Report what you found, what you fixed, what you left as
@@ -877,7 +839,7 @@ if the blocker is understanding rather than execution, report that instead.`,
     }
   },
   "context": {
-    "description": "Repository cartographer and memory maintainer. Bootstraps and incrementally maintains .opencode/context/ (architecture, contexts, conventions, workflows, decisions) as a small navigation map for future agents, and keeps .opencode/context/active.md \u2014 the active backlog of work in flight, grouped by week. Runs automatically after sessions that changed files; can also be invoked with /context-init, /context-update, /context-review. Never use it for general coding tasks.",
+    "description": "Repository cartographer and memory maintainer. Bootstraps and incrementally maintains .opencode/context/ (architecture, contexts, conventions, workflows, decisions) as a small navigation map for future agents. Runs automatically after sessions that changed files; can also be invoked with /context-init, /context-update, /context-review. Never use it for general coding tasks.",
     "mode": "subagent",
     "temperature": 0.1,
     prompt: CARTOGRAPHER_PROMPT,

package/dist/commands.js

@@ -70,8 +70,7 @@ exploration (README \u2192 existing docs \u2192 manifests \u2192 top-level struc
 and framework config \u2192 entry points \u2192 selective source), then write the five
 context files inside their line budgets, using the entry schema (provenance
 marker, rule of at most three lines, \`\u2014 See <path>[ \xA7Section] (verified
-YYYY-MM-DD)\`). Also create \`.opencode/context/active.md\` with its heading and no
-tasks.
+YYYY-MM-DD)\`).
 
 Remember: write conclusions, not inventories. Point at the project's existing
 documentation instead of restating it. Run the drift pass and report a
@@ -117,7 +116,7 @@ Follow the review procedure and entry schema in your system prompt. Everything
 outside \`.opencode/context/\` is read-only for this run. Do not modify source
 code under any circumstances.
 
-Audit the context files and the backlog for:
+Audit the context files for:
 
 - schema \u2014 every entry has one provenance marker, at most three lines, a
   pointer, and a \`(verified YYYY-MM-DD)\` date
@@ -136,8 +135,6 @@ Audit the context files and the backlog for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything that is not \`[binding]\` or \`[disputed]\`
   should be \`[provisional]\`
-- backlog tasks that are finished but carry no date \u2014 the retention window
-  cannot age those out, so they stay forever
 
 Fix what you find in \`.opencode/context/\` only, then report: findings, fixes,
 and anything you could not verify.`

package/dist/index.js

@@ -951,8 +951,6 @@ You own exactly these files and nothing else:
   150 lines.**
 - \`.opencode/context/decisions.md\` \u2014 architectural constraints that bind future
   work. **At most 120 lines.**
-- \`.opencode/context/active.md\` \u2014 work in flight, grouped by the ISO week it was
-  opened. **At most 60 lines.**
 
 The unit is non-blank lines. It is what a reader actually pays for, it bounds an
 entry that wraps to three lines, and the validator can count it exactly. An
@@ -968,8 +966,6 @@ failed run, not a small one.
 
 The plugin applies this on every run. Write entries in the shape that lets it.
 
-- \`active.md\`: a finished task (\`[x]\` plus \`finished YYYY-MM-DD\`) is dropped
-  after 7 days. An open task never expires, however old it is.
 - \`architecture.md\`, \`contexts.md\`, \`conventions.md\`, \`workflows.md\`,
   \`decisions.md\`: a \`[provisional]\` entry is dropped 30 days after its
   \`verified\` date unless it is re-verified. \`[binding]\` and \`[disputed]\` are
@@ -1063,8 +1059,7 @@ You are mapping a city, not auditing every house. Do not attempt to understand
 every file.
 
 Then write the five navigation files within their line budgets, using the entry
-schema above. Also create \`.opencode/context/active.md\` with its heading and no
-tasks. For each significant subsystem, give a short "Start here" list \u2014 at most
+schema above. For each significant subsystem, give a short "Start here" list \u2014 at most
 about five canonical files, each with a one-phrase reason. This is the single
 most valuable thing you produce: where an agent should open its editor next.
 
@@ -1098,37 +1093,6 @@ update needed".
 Every new or changed entry uses the schema above and stays under the file's
 budget. If a file is already over budget, consolidate before adding anything.
 
-Also keep \`.opencode/context/active.md\` current: record work that is in flight,
-and mark a task finished \u2014 with the date it finished \u2014 when it is.
-
-# Task backlog
-
-\`.opencode/context/active.md\` holds the work in flight. It is a rolling window,
-not a history: it answers "what is open, and what just finished".
-
-Format \u2014 one line per task, under the ISO week the task was opened in:
-
-    ## 2026-W43
-
-    - [ ] Ship the release notes \u2014 opened 2026-W43
-    - [x] Fix the flaky test \u2014 opened 2026-W43, finished 2026-10-19
-
-The rules:
-
-- A task that is not marked \`[x]\` is OPEN. An open task is never removed,
-  however old it is.
-- A task is FINISHED when it is marked \`[x]\` AND carries a \`finished\` date.
-  Record the date it actually finished, as \`YYYY-MM-DD\`.
-- The week is \`YYYY-Www\`, Monday to Sunday. \`date +%G-W%V\` prints it.
-- A finished task is dropped once it is more than a week old. The plugin
-  enforces that: record the finished task with its date and let the window close
-  on its own. Do not delete old finished tasks by hand, and do not keep a
-  finished task back to preserve it \u2014 the file is meant to stay small.
-- Never invent a task. Record work that actually happened, and mark a task
-  finished only once it is finished.
-- Keep the file inside the window. If the backlog has grown past a handful of
-  weeks, that is a signal to close finished tasks, not to add sections.
-
 # Minimal exploration
 
 Default shape:
@@ -1216,7 +1180,7 @@ Never drop a binding constraint to make room.
 
 Trigger: an explicit review (see the \`context-review\` command).
 
-Audit the map files and the backlog for:
+Audit the map files for:
 
 - schema \u2014 every entry has one marker, at most three lines, a pointer, and a
   \`verified\` date
@@ -1231,8 +1195,6 @@ Audit the map files and the backlog for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything that is not \`[binding]\` or \`[disputed]\`
   should be \`[provisional]\`
-- backlog tasks that are finished but carry no date \u2014 the retention window
-  cannot age those out, so they stay forever
 
 Fix problems only in the files you own. Never modify source code or a project
 page during a review. Report what you found, what you fixed, what you left as
@@ -1704,7 +1666,7 @@ if the blocker is understanding rather than execution, report that instead.`,
     }
   },
   "context": {
-    "description": "Repository cartographer and memory maintainer. Bootstraps and incrementally maintains .opencode/context/ (architecture, contexts, conventions, workflows, decisions) as a small navigation map for future agents, and keeps .opencode/context/active.md \u2014 the active backlog of work in flight, grouped by week. Runs automatically after sessions that changed files; can also be invoked with /context-init, /context-update, /context-review. Never use it for general coding tasks.",
+    "description": "Repository cartographer and memory maintainer. Bootstraps and incrementally maintains .opencode/context/ (architecture, contexts, conventions, workflows, decisions) as a small navigation map for future agents. Runs automatically after sessions that changed files; can also be invoked with /context-init, /context-update, /context-review. Never use it for general coding tasks.",
     "mode": "subagent",
     "temperature": 0.1,
     prompt: CARTOGRAPHER_PROMPT,
@@ -1930,8 +1892,7 @@ exploration (README \u2192 existing docs \u2192 manifests \u2192 top-level struc
 and framework config \u2192 entry points \u2192 selective source), then write the five
 context files inside their line budgets, using the entry schema (provenance
 marker, rule of at most three lines, \`\u2014 See <path>[ \xA7Section] (verified
-YYYY-MM-DD)\`). Also create \`.opencode/context/active.md\` with its heading and no
-tasks.
+YYYY-MM-DD)\`).
 
 Remember: write conclusions, not inventories. Point at the project's existing
 documentation instead of restating it. Run the drift pass and report a
@@ -1977,7 +1938,7 @@ Follow the review procedure and entry schema in your system prompt. Everything
 outside \`.opencode/context/\` is read-only for this run. Do not modify source
 code under any circumstances.
 
-Audit the context files and the backlog for:
+Audit the context files for:
 
 - schema \u2014 every entry has one provenance marker, at most three lines, a
   pointer, and a \`(verified YYYY-MM-DD)\` date
@@ -1996,8 +1957,6 @@ Audit the context files and the backlog for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything that is not \`[binding]\` or \`[disputed]\`
   should be \`[provisional]\`
-- backlog tasks that are finished but carry no date \u2014 the retention window
-  cannot age those out, so they stay forever
 
 Fix what you find in \`.opencode/context/\` only, then report: findings, fixes,
 and anything you could not verify.`
@@ -4125,110 +4084,10 @@ one ordered pass in slot order: each slot fills to its weight, then overflow goe
 });
 
 // src/plugins/context-autoupdate.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync5, readdirSync as readdirSync2, readFileSync as readFileSync7, statSync as statSync6, unlinkSync as unlinkSync5, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync5, readdirSync as readdirSync2, statSync as statSync6, unlinkSync as unlinkSync5, writeFileSync as writeFileSync6 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import * as path3 from "node:path";
 
-// src/lib/active-backlog.ts
-var ACTIVE_BACKLOG_FILE = "active.md";
-var RETENTION_DAYS = 7;
-var DAY_MS = 24 * 60 * 60 * 1e3;
-var HEADER = `# Active backlog
-
-Tasks in flight, grouped by the week they were opened. A finished task stays
-here for a week after it was finished and is then dropped; an open task stays
-however long it takes. Add a line under the right week, and give a finished
-task its date: \`- [x] Title \u2014 opened 2026-W43, finished 2026-10-19\`.`;
-var TASK_LINE = /^\s*(?:[-*+]|\d+[.)])\s*\[([ xX])\]\s*(.*)$/;
-var META = /(?:—|–|-)\s*opened\s+(\d{4}-W(?:0[1-9]|[1-4]\d|5[0-3]))|[,—–-]\s*finished\s+(\d{4}-\d{2}-\d{2})/gi;
-var isCalendarDate = (s) => {
-  const at = Date.parse(`${s}T00:00:00Z`);
-  return Number.isFinite(at) && new Date(at).toISOString().slice(0, 10) === s;
-};
-var parseBacklog = (text) => {
-  const entries = [];
-  for (const raw of text.split(/\r?\n/)) {
-    const line = TASK_LINE.exec(raw);
-    if (!line) continue;
-    const finished = line[1] !== " ";
-    let week;
-    let finishedAt;
-    const stripped = line[2].replace(META, (fragment, openedWeek, finishedDate) => {
-      if (openedWeek !== void 0) {
-        week ??= openedWeek.toUpperCase();
-        return "";
-      }
-      if (finishedDate !== void 0 && isCalendarDate(finishedDate)) {
-        finishedAt ??= finishedDate;
-        return "";
-      }
-      return fragment;
-    });
-    const title = stripped.replace(/^[\s—–-]+|[\s—–-]+$/g, "");
-    if (!title) continue;
-    entries.push({ title, ...week ? { week } : {}, finished, ...finishedAt ? { finishedAt } : {} });
-  }
-  return entries;
-};
-var ISO_WEEK = /^(\d{4})-W(\d{2})$/i;
-var newestFirst = (a, b) => {
-  const ma = ISO_WEEK.exec(a);
-  const mb = ISO_WEEK.exec(b);
-  if (ma && mb) return Number(mb[1]) - Number(ma[1]) || Number(mb[2]) - Number(ma[2]);
-  if (ma) return -1;
-  if (mb) return 1;
-  return a < b ? 1 : a > b ? -1 : 0;
-};
-var renderLine = (entry) => {
-  const box = entry.finished ? "[x]" : "[ ]";
-  const meta = [];
-  if (entry.week) meta.push(`opened ${entry.week}`);
-  if (entry.finished && entry.finishedAt) meta.push(`finished ${entry.finishedAt}`);
-  const head = `- ${box} ${entry.title}`;
-  if (meta.length === 0) return head;
-  return entry.week ? `${head} \u2014 ${meta.join(", ")}` : `${head}, ${meta.join(", ")}`;
-};
-var renderBacklog = (entries) => {
-  const buckets = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    const key = entry.week ? entry.week : null;
-    const bucket = buckets.get(key);
-    if (bucket) bucket.push(entry);
-    else buckets.set(key, [entry]);
-  }
-  const weeks = [...buckets.keys()].filter((week) => week !== null).sort(newestFirst);
-  let out = HEADER;
-  for (const week of weeks) out += `
-
-## ${week}
-
-${buckets.get(week).map(renderLine).join("\n")}`;
-  const unscheduled = buckets.get(null);
-  if (unscheduled) out += `
-
-## Unscheduled
-
-${unscheduled.map(renderLine).join("\n")}`;
-  return `${out}
-`;
-};
-var normalizeBacklog = (text, now = Date.now()) => {
-  const entries = parseBacklog(text);
-  const kept = [];
-  const removed = [];
-  for (const entry of entries) {
-    if (entry.finished && entry.finishedAt) {
-      const at = Date.parse(`${entry.finishedAt}T00:00:00Z`);
-      if (Number.isFinite(at) && now - at > RETENTION_DAYS * DAY_MS) {
-        removed.push(entry.title);
-        continue;
-      }
-    }
-    kept.push(entry);
-  }
-  return { text: renderBacklog(kept), removed };
-};
-
 // src/lib/map-schema.ts
 import { existsSync as existsSync3, readFileSync as readFileSync5, statSync as statSync5, writeFileSync as writeFileSync5 } from "node:fs";
 import * as path from "node:path";
@@ -4278,21 +4137,11 @@ var MAP_SPECS = [
     kind: "entries",
     provisionalDays: PROVISIONAL_DAYS,
     sectionRequired: true
-  },
-  {
-    file: ACTIVE_BACKLOG_FILE,
-    charter: "work in flight, grouped by the ISO week it was opened",
-    budget: 60,
-    minEntries: 0,
-    kind: "backlog",
-    provisionalDays: PROVISIONAL_DAYS,
-    sectionRequired: false
   }
 ];
+var NAVIGATION_FILES = MAP_SPECS.map((spec) => spec.file);
 var MAP_SPEC_BY_FILE = new Map(MAP_SPECS.map((spec) => [spec.file, spec]));
-var MAP_FILES = MAP_SPECS.map((spec) => spec.file);
-var NAVIGATION_FILES = MAP_SPECS.filter((spec) => spec.kind === "entries").map((spec) => spec.file);
-var DAY_MS2 = 24 * 60 * 60 * 1e3;
+var DAY_MS = 24 * 60 * 60 * 1e3;
 var ENTRY_START = /^([-*+])\s+\[(binding|provisional|disputed)\]\s+(.*)$/i;
 var CONTINUATION = /^\s{2,}\S/;
 var LIST_ITEM = /^\s*(?:[-*+]|\d+[.)])\s+/;
@@ -4303,7 +4152,7 @@ var VERIFIED = /\(verified\s+(\d{4}-\d{2}-\d{2})\)\s*$/i;
 var POINTER = /(?:—|–|→|->)\s*See\s+`([^`\n]+)`(?:\s*§\s*([^()\n]+?))?(?:\s*\(verified\s+(\d{4}-\d{2}-\d{2})\))?\s*$/i;
 var DECISION_RECORD = /^\s*(?:#{1,6}\s*)?(?:\*\*)?(Context|Decision|Consequences|Alternatives|Status|Trade-?offs|Rationale)(?:\*\*)?\s*(?::|$)/im;
 var ARCHIVE_LANGUAGE = /\b(?:archive\s+of\s+record|this\s+(?:is|file\s+is|map\s+is)\s+the\s+only\s+(?:copy|record)|the\s+only\s+place\s+[^.\n]{0,80}?\b(?:remains|survives)\b|the\s+only\s+(?:copy|record)\s+[^.\n]{0,80}?\b(?:remains|survives|is\s+kept)\b|(?:survives|remains|is\s+kept)\s+only\s+here|no\s+longer\s+exists\s+(?:in|anywhere)|exists\s+only\s+(?:in|here))\b/i;
-var isCalendarDate2 = (value) => {
+var isCalendarDate = (value) => {
   const at = Date.parse(`${value}T00:00:00Z`);
   return Number.isFinite(at) && new Date(at).toISOString().slice(0, 10) === value;
 };
@@ -4521,10 +4370,6 @@ var validateMapText = (spec, text, options) => {
   if (nonBlank > spec.budget) {
     push("budget", `${nonBlank} non-blank lines exceeds the ${spec.budget}-line budget; consolidate, do not pad`);
   }
-  if (spec.kind === "backlog") {
-    if (!text.startsWith("# ")) push("charter", "active backlog must start with a top-level heading");
-    return { spec, lines: nonBlank, entries: [], violations };
-  }
   const entries = parseMapEntries(text);
   let inFence = false;
   let tableReported = false;
@@ -4566,9 +4411,9 @@ var validateMapText = (spec, text, options) => {
     }
     if (!entry.verified) {
       push("schema", "entry has no (verified YYYY-MM-DD); the lifecycle and drift checks need it", line);
-    } else if (!isCalendarDate2(entry.verified)) {
+    } else if (!isCalendarDate(entry.verified)) {
       push("schema", `verified date ${entry.verified} is not a real calendar date`, line);
-    } else if (Date.parse(`${entry.verified}T00:00:00Z`) > (options.now ?? Date.now()) + DAY_MS2) {
+    } else if (Date.parse(`${entry.verified}T00:00:00Z`) > (options.now ?? Date.now()) + DAY_MS) {
       push("schema", `verified date ${entry.verified} is more than a day in the future`, line);
     }
     if (!entry.pointer) {
@@ -4618,14 +4463,6 @@ var validateMapText = (spec, text, options) => {
 };
 var normalizeMapText = (spec, text, options = {}) => {
   const now = options.now ?? Date.now();
-  if (spec.kind === "backlog") {
-    const result = normalizeBacklog(text, now);
-    return {
-      text: result.text,
-      removed: result.removed.map((title) => ({ line: 0, text: title })),
-      kept: 0
-    };
-  }
   const entries = parseMapEntries(text);
   const drop = /* @__PURE__ */ new Set();
   const removed = [];
@@ -4635,7 +4472,7 @@ var normalizeMapText = (spec, text, options = {}) => {
     if (options.canResolve && !options.canResolve(entry.pointer, entry.section)) continue;
     const at = Date.parse(`${entry.verified}T00:00:00Z`);
     if (!Number.isFinite(at)) continue;
-    if (now - at <= spec.provisionalDays * DAY_MS2) continue;
+    if (now - at <= spec.provisionalDays * DAY_MS) continue;
     for (let i = entry.startLine; i < entry.endLine; i++) drop.add(i);
     removed.push({ line: entry.startLine + 1, text: truncate(entry.rule) });
   }
@@ -4665,8 +4502,6 @@ var maintainMap = (root, mapDir, now = Date.now()) => {
     if (result.removed.length > 0) {
       removedTotal += result.removed.length;
       files.push({ file: spec.file, changed, removed: result.removed });
-    } else if (changed) {
-      files.push({ file: spec.file, changed, removed: [] });
     }
   }
   return { files, removedTotal };
@@ -4692,21 +4527,19 @@ var auditMap = (root, mapDir, now = Date.now()) => {
     const result = validateMapText(spec, text, { root, now });
     files.push(result);
     violations.push(...result.violations);
-    if (spec.kind === "entries") {
-      for (const entry of result.entries) {
-        const key = normalizeRule(entry.rule);
-        if (key.length < 12) continue;
-        const home = rulesSeen.get(key);
-        if (home !== void 0 && home !== spec.file) {
-          violations.push({
-            file: spec.file,
-            line: entry.startLine + 1,
-            kind: "duplicate",
-            detail: `same rule is already stated in ${home}; one fact has one home`
-          });
-        } else if (home === void 0) {
-          rulesSeen.set(key, spec.file);
-        }
+    for (const entry of result.entries) {
+      const key = normalizeRule(entry.rule);
+      if (key.length < 12) continue;
+      const home = rulesSeen.get(key);
+      if (home !== void 0 && home !== spec.file) {
+        violations.push({
+          file: spec.file,
+          line: entry.startLine + 1,
+          kind: "duplicate",
+          detail: `same rule is already stated in ${home}; one fact has one home`
+        });
+      } else if (home === void 0) {
+        rulesSeen.set(key, spec.file);
       }
     }
   }
@@ -4974,7 +4807,6 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
   });
   const root = path3.resolve(directory);
   const contextAbs = path3.join(root, CONTEXT_DIR2);
-  const activeBacklogPath = path3.join(contextAbs, ACTIVE_BACKLOG_FILE);
   const config = findProjectConfig();
   const writerProblem = config ? verifyWriterRule(config, contextAbs, root) : void 0;
   if (writerProblem) void log("error", writerProblem);
@@ -4984,22 +4816,6 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
     if (absolute === contextAbs || absolute.startsWith(contextAbs + path3.sep)) return false;
     return !toPosix2(absolute).split("/").some((segment) => IGNORED_SEGMENTS.has(segment));
   };
-  const normalizeActiveBacklog = async () => {
-    try {
-      if (!existsSync4(activeBacklogPath)) return { removed: 0 };
-      const before = readFileSync7(activeBacklogPath, "utf8");
-      const { text, removed } = normalizeBacklog(before);
-      if (text !== before) writeFileSync6(activeBacklogPath, text);
-      if (removed.length > 0) {
-        await log("info", `active backlog: dropped ${removed.length} task(s) finished more than a week ago`, {
-          removed: removed.length
-        });
-      }
-      return { removed: removed.length };
-    } catch {
-      return { removed: 0 };
-    }
-  };
   const applyLifecycle = async () => {
     try {
       const result = maintainMap(root, contextAbs);
@@ -5059,7 +4875,7 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
     "",
     ENTRY_CONTRACT,
     "",
-    "Follow the bootstrap procedure in your system prompt: progressive exploration, then write the five context files within their line budgets. Also create `.opencode/context/active.md` with its heading and no tasks. When the project already has architecture or decision documentation, link to it instead of duplicating it. Write conclusions, not inventories."
+    "Follow the bootstrap procedure in your system prompt: progressive exploration, then write the five context files within their line budgets. When the project already has architecture or decision documentation, link to it instead of duplicating it. Write conclusions, not inventories."
   ].join("\n") : [
     "Incremental context update. Project root: " + directory,
     "",
@@ -5070,17 +4886,13 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
     "",
     ENTRY_CONTRACT,
     "",
-    'Follow the incremental-update procedure in your system prompt. Update a context file only if this work introduced or revealed information that will materially help future agents: a new boundary or module, a new or moved canonical entry point, a changed workflow, a new convention, an architectural decision, a new dependency between subsystems, a renamed or moved subsystem, or an invariant not yet recorded. Do not edit documentation merely because source files changed. If nothing material changed, make no edits and report "no update needed". Also keep `.opencode/context/active.md` current: record work that is in flight, and mark a task finished \u2014 with the date it finished \u2014 when it is.'
+    'Follow the incremental-update procedure in your system prompt. Update a context file only if this work introduced or revealed information that will materially help future agents: a new boundary or module, a new or moved canonical entry point, a changed workflow, a new convention, an architectural decision, a new dependency between subsystems, a renamed or moved subsystem, or an invariant not yet recorded. Do not update documentation merely because source files changed. If nothing material changed, make no edits and report "no update needed".'
   ].join("\n");
   return {
     event: async ({ event }) => {
       try {
         if (event.type === "file.edited") {
           const file = event.properties.file;
-          if (path3.resolve(root, file) === activeBacklogPath) {
-            await normalizeActiveBacklog();
-            return;
-          }
           if (isTracked(file)) pending.add(file);
           return;
         }
@@ -5192,7 +5004,7 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
 });
 
 // src/lib/feedback.ts
-import { mkdirSync as mkdirSync6, readFileSync as readFileSync8, renameSync as renameSync4, unlinkSync as unlinkSync6, writeFileSync as writeFileSync7 } from "node:fs";
+import { mkdirSync as mkdirSync6, readFileSync as readFileSync7, renameSync as renameSync4, unlinkSync as unlinkSync6, writeFileSync as writeFileSync7 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { dirname as dirname4, join as join9 } from "node:path";
 var FEEDBACK_HINT_ENV = "LACODE_NO_FEEDBACK_HINT";
@@ -5200,7 +5012,7 @@ var FEEDBACK_HINT = "Enjoying lacode? Bugs, ideas, or a quick note on how you us
 var feedbackStatePath = () => join9(homedir5(), ".local", "share", "opencode", "lacode", "feedback.json");
 function readFeedbackState(path4 = feedbackStatePath()) {
   try {
-    const parsed = JSON.parse(readFileSync8(path4, "utf8"));
+    const parsed = JSON.parse(readFileSync7(path4, "utf8"));
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return void 0;
     return parsed;
   } catch (error) {
@@ -5274,7 +5086,7 @@ async function feedbackHooks(input, options, deps = {}) {
 
 // src/plugins/image-paste.ts
 import { createHash, randomUUID } from "node:crypto";
-import { globSync, mkdirSync as mkdirSync7, readFileSync as readFileSync9, renameSync as renameSync5, statSync as statSync7, writeFileSync as writeFileSync8 } from "node:fs";
+import { globSync, mkdirSync as mkdirSync7, readFileSync as readFileSync8, renameSync as renameSync5, statSync as statSync7, writeFileSync as writeFileSync8 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
 import { basename as basename3, join as join10 } from "node:path";
 
@@ -5531,7 +5343,7 @@ async function imagePasteHooks(input, options, deps) {
               }
               let bytes;
               try {
-                bytes = readFileSync9(filePath);
+                bytes = readFileSync8(filePath);
               } catch {
                 skipped.push(name);
                 continue;
@@ -6677,27 +6489,35 @@ async function selfUpdateHooks(input, options) {
 }
 
 // src/plugins/timeline.ts
-import { writeFileSync as writeFileSync9, renameSync as renameSync6, rmSync as rmSync3 } from "node:fs";
+import { writeFileSync as writeFileSync10, renameSync as renameSync7, rmSync as rmSync3 } from "node:fs";
 import { tool as tool2 } from "@opencode-ai/plugin";
 
 // src/lib/timeline.ts
-import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync8, readFileSync as readFileSync10, rmSync as rmSync2 } from "node:fs";
+import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync8, readdirSync as readdirSync3, readFileSync as readFileSync9, renameSync as renameSync6, rmSync as rmSync2, writeFileSync as writeFileSync9 } from "node:fs";
 import { homedir as homedir7 } from "node:os";
 import { dirname as dirname5, join as join11, resolve as resolve4 } from "node:path";
+var TIMELINE_STATE_VERSION = 1;
 function timelineDir() {
   const env = process.env.LACODE_TIMELINE_DIR;
   if (env) return resolve4(env);
   return join11(homedir7(), ".local/share/opencode/lacode/timeline");
 }
-function timelineFile(sessionID) {
+function assertValidSessionID(sessionID) {
   if (!/^[A-Za-z0-9_.-]+$/.test(sessionID)) throw new Error("invalid sessionID");
+}
+function timelineFile(sessionID) {
+  assertValidSessionID(sessionID);
   return join11(timelineDir(), sessionID + ".jsonl");
 }
+function timelineStateFile(sessionID) {
+  assertValidSessionID(sessionID);
+  return join11(timelineDir(), sessionID + ".state.json");
+}
 function normalizeThrough(through) {
   if (!through || typeof through !== "object") return void 0;
   const out = {};
-  if (typeof through.messageID === "string") out.messageID = through.messageID;
-  if (typeof through.time === "number") out.time = through.time;
+  if (typeof through.messageID === "string" && through.messageID.length > 0) out.messageID = through.messageID;
+  if (typeof through.time === "number" && Number.isFinite(through.time)) out.time = through.time;
   if (out.messageID === void 0 && out.time === void 0) return void 0;
   return out;
 }
@@ -6738,7 +6558,7 @@ function appendEntriesAt(file, texts, now, through) {
 function readEntriesAt(file, limit) {
   let raw = "";
   try {
-    raw = readFileSync10(file, "utf8");
+    raw = readFileSync9(file, "utf8");
   } catch {
     return [];
   }
@@ -6772,6 +6592,70 @@ function removeEntries(sessionID) {
   } catch {
   }
 }
+function normalizePersistedState(raw) {
+  const obj = raw && typeof raw === "object" ? raw : {};
+  const cursor = normalizeThrough(obj.cursor);
+  const failures = typeof obj.failures === "number" && Number.isFinite(obj.failures) ? Math.max(0, Math.trunc(obj.failures)) : 0;
+  const pending = obj.pending === true;
+  const nextAttemptAt = typeof obj.nextAttemptAt === "number" && Number.isFinite(obj.nextAttemptAt) && obj.nextAttemptAt > 0 ? obj.nextAttemptAt : void 0;
+  const updatedAt = typeof obj.updatedAt === "number" && Number.isFinite(obj.updatedAt) ? obj.updatedAt : Date.now();
+  const state2 = {
+    version: TIMELINE_STATE_VERSION,
+    failures,
+    pending,
+    updatedAt
+  };
+  if (cursor) state2.cursor = cursor;
+  if (nextAttemptAt !== void 0) state2.nextAttemptAt = nextAttemptAt;
+  return state2;
+}
+function readTimelineState(sessionID) {
+  try {
+    const raw = readFileSync9(timelineStateFile(sessionID), "utf8");
+    return normalizePersistedState(JSON.parse(raw));
+  } catch {
+    return void 0;
+  }
+}
+function writeTimelineState(sessionID, state2) {
+  const file = timelineStateFile(sessionID);
+  mkdirSync8(dirname5(file), { recursive: true });
+  const tmp = file + ".tmp." + process.pid + "." + Math.random().toString(36).slice(2);
+  try {
+    writeFileSync9(tmp, JSON.stringify(state2) + "\n");
+    renameSync6(tmp, file);
+  } catch (err) {
+    try {
+      rmSync2(tmp, { force: true });
+    } catch {
+    }
+    throw err;
+  }
+}
+function removeTimelineState(sessionID) {
+  try {
+    rmSync2(timelineStateFile(sessionID), { force: true });
+  } catch {
+  }
+}
+function listTimelineStates() {
+  let names;
+  try {
+    names = readdirSync3(timelineDir());
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const name of names) {
+    if (!name.endsWith(".state.json")) continue;
+    const sessionID = name.slice(0, -".state.json".length);
+    if (!/^[A-Za-z0-9_.-]+$/.test(sessionID)) continue;
+    const state2 = readTimelineState(sessionID);
+    if (!state2) continue;
+    out.push({ sessionID, state: state2 });
+  }
+  return out;
+}
 function collapse(s) {
   return s.replace(/\s+/g, " ").trim();
 }
@@ -7104,6 +6988,11 @@ function timelineHooks(input, options) {
   const intervalMs = Number.isFinite(rawInterval) ? Math.max(MIN_INTERVAL_MS, rawInterval) : DEFAULT_INTERVAL_MS;
   const rawMaxEntries = Number(config?.maxEntries ?? DEFAULT_MAX_ENTRIES);
   const maxEntries = Number.isFinite(rawMaxEntries) ? Math.min(MAX_ENTRIES, Math.max(1, Math.trunc(rawMaxEntries))) : DEFAULT_MAX_ENTRIES;
+  const rawRetryMs = Number(config?.retryMs ?? 3e4);
+  const retryMs = Number.isFinite(rawRetryMs) ? Math.max(1, rawRetryMs) : 3e4;
+  const rawMaxBackoffMs = Number(config?.maxBackoffMs ?? 30 * 6e4);
+  const maxBackoffMs = Math.max(retryMs, Number.isFinite(rawMaxBackoffMs) ? Math.max(1, rawMaxBackoffMs) : 30 * 6e4);
+  const retryDelay = (failures) => Math.min(retryMs * 2 ** Math.min(Math.max(failures - 1, 0), 20), maxBackoffMs);
   const shared = globalThis[/* @__PURE__ */ Symbol.for("lacode:timeline:state")] ??= {
     sessions: /* @__PURE__ */ new Map(),
     owned: /* @__PURE__ */ new Set(),
@@ -7120,21 +7009,37 @@ function timelineHooks(input, options) {
     if (!id) return void 0;
     return { providerID: provider, modelID: id };
   };
+  const persist = (id, state2) => {
+    try {
+      writeTimelineState(id, {
+        version: TIMELINE_STATE_VERSION,
+        cursor: state2.cursor,
+        failures: state2.failures,
+        pending: state2.pending,
+        nextAttemptAt: state2.nextAttemptAt,
+        updatedAt: Date.now()
+      });
+    } catch (error) {
+      debug("persist failed", { sessionID: id, error });
+    }
+  };
   const stateFor = (id) => {
     let state2 = sessions.get(id);
     if (!state2) {
+      const persisted = readTimelineState(id);
       state2 = {
         running: false,
-        pending: false,
-        failures: 0,
-        cursor: readEntries(id, 1)[0]?.through
+        pending: persisted?.pending ?? false,
+        failures: persisted?.failures ?? 0,
+        cursor: persisted?.cursor ?? readEntries(id, 1)[0]?.through,
+        nextAttemptAt: persisted?.nextAttemptAt
       };
       sessions.set(id, state2);
       while (sessions.size > 500) {
         let evicted = false;
         for (const [key, st] of sessions) {
           if (key === id) continue;
-          if (!st.timer && !st.running) {
+          if (!st.timer && !st.running && !st.pending && st.nextAttemptAt === void 0) {
             sessions.delete(key);
             evicted = true;
             break;
@@ -7149,16 +7054,29 @@ function timelineHooks(input, options) {
     if (disabled || disposed) return;
     const state2 = stateFor(id);
     if (state2.root === false) return;
+    const wasPending = state2.pending;
     state2.pending = true;
+    if (!wasPending) persist(id, state2);
     if (state2.timer || state2.running) return;
     schedule(id, state2);
   };
   function flush(id) {
     if (disabled || disposed) return;
-    const state2 = sessions.get(id);
-    if (!state2) return;
+    let state2 = sessions.get(id);
+    if (!state2) {
+      if (readTimelineState(id)?.pending === true) state2 = stateFor(id);
+      else return;
+    }
     if (state2.root === false) return;
     if (!state2.pending || state2.running) return;
+    if (state2.nextAttemptAt && state2.nextAttemptAt > Date.now()) {
+      if (state2.timer) {
+        clearTimeout(state2.timer);
+        state2.timer = void 0;
+      }
+      schedule(id, state2);
+      return;
+    }
     if (state2.timer) {
       clearTimeout(state2.timer);
       state2.timer = void 0;
@@ -7167,10 +7085,11 @@ function timelineHooks(input, options) {
   }
   function schedule(id, state2) {
     if (state2.timer) clearTimeout(state2.timer);
+    const delay = typeof state2.nextAttemptAt === "number" ? Math.max(0, state2.nextAttemptAt - Date.now()) : state2.failures > 0 ? retryDelay(state2.failures) : intervalMs;
     state2.timer = setTimeout(() => {
       state2.timer = void 0;
       void tick(id, state2);
-    }, intervalMs);
+    }, delay);
     state2.timer.unref?.();
   }
   async function summarize(id, title, excerptText, prior, abort) {
@@ -7289,13 +7208,13 @@ function timelineHooks(input, options) {
     if (reprocessing.has(id)) return;
     try {
       state2.running = true;
-      state2.pending = false;
       let title;
       let info = {};
       if (state2.root === void 0) {
         info = await client.session.get({ path: { id }, query: { directory } }).then((result2) => result2?.data).catch(() => void 0);
         if (!info) {
           sessions.delete(id);
+          removeTimelineState(id);
           return;
         }
         title = info.title;
@@ -7303,6 +7222,7 @@ function timelineHooks(input, options) {
         state2.root = !info.parentID && !isInternalTitle(info.title);
         if (!state2.root) {
           sessions.delete(id);
+          removeTimelineState(id);
           return;
         }
       }
@@ -7310,6 +7230,10 @@ function timelineHooks(input, options) {
       const messages = response?.data ?? [];
       const excerpt = buildExcerpt(messages, state2.cursor);
       if (!excerpt.text) {
+        state2.pending = false;
+        state2.failures = 0;
+        state2.nextAttemptAt = void 0;
+        persist(id, state2);
         return;
       }
       const result = await summarize(id, state2.title ?? info?.title ?? "untitled", excerpt.text, readEntries(id, 4));
@@ -7317,8 +7241,14 @@ function timelineHooks(input, options) {
         if (result.bullets.length) appendEntries(id, result.bullets, Date.now(), excerpt.next);
         state2.cursor = excerpt.next;
         state2.failures = 0;
+        state2.pending = false;
+        state2.nextAttemptAt = void 0;
+        persist(id, state2);
       } else {
         state2.failures++;
+        state2.pending = true;
+        state2.nextAttemptAt = Date.now() + retryDelay(state2.failures);
+        persist(id, state2);
         log("warn", "timeline: summarize failed", { sessionID: id, error: result.error });
       }
     } catch (error) {
@@ -7357,7 +7287,7 @@ function timelineHooks(input, options) {
       if (!info) return "Session not found.";
       const msgRes = await client.session.messages({ path: { id: rootId }, query: { directory } });
       const messages = msgRes?.data ?? [];
-      writeFileSync9(temp, "");
+      writeFileSync10(temp, "");
       for (let i = 0; i < MAX_REPROCESS_SLICES; i++) {
         if (abort?.aborted) {
           try {
@@ -7397,13 +7327,21 @@ function timelineHooks(input, options) {
         }
         return "No entries generated; previous timeline kept.";
       }
-      renameSync6(temp, targetFile);
+      renameSync7(temp, targetFile);
       const state2 = sessions.get(rootId);
       if (state2) {
         state2.cursor = cursor;
         state2.failures = 0;
         state2.pending = false;
+        state2.nextAttemptAt = void 0;
       }
+      persist(rootId, {
+        running: state2?.running ?? false,
+        pending: false,
+        failures: 0,
+        cursor,
+        nextAttemptAt: void 0
+      });
       return `Rebuilt ${messages.length} messages into ${entries} entries with ${calls} summarizer calls.`;
     } catch (error) {
       try {
@@ -7415,6 +7353,28 @@ function timelineHooks(input, options) {
       reprocessing.delete(rootId);
     }
   }
+  function resume() {
+    if (disabled || disposed) return;
+    let listed;
+    try {
+      listed = listTimelineStates();
+    } catch (error) {
+      debug("resume failed", error);
+      return;
+    }
+    listed.sort((a, b) => b.state.updatedAt - a.state.updatedAt);
+    let scheduled = 0;
+    for (const { sessionID, state: state2 } of listed) {
+      if (state2.pending !== true) continue;
+      if (sessions.has(sessionID)) continue;
+      if (scheduled >= 50) continue;
+      const loaded = stateFor(sessionID);
+      if (loaded.root === false) continue;
+      schedule(sessionID, loaded);
+      scheduled++;
+    }
+  }
+  resume();
   const timelineReprocess = tool2({
     description: "Rebuild the root session's entire timeline from its transcript, replacing the existing entries. Used by /reprocess-timeline.",
     args: {},
@@ -7464,6 +7424,7 @@ function timelineHooks(input, options) {
             }
             sessions.delete(id);
             removeEntries(id);
+            removeTimelineState(id);
             owned.delete(id);
             return;
           }

package/docs/CONTEXT.md

@@ -30,8 +30,7 @@ the exploration it replaces is worse than no map:
   `src/orders/`". The cartographer is forbidden by name from writing directory
   listings, copying source, or restating what the README already says.
 - **One file per question.** Five navigation files, each with a defined scope, so
-  an agent reads one of them rather than all of them. A sixth file,
-  `active.md`, holds the work in flight rather than a map of the repository.
+  an agent reads one of them rather than all of them.
 - **Canonical entry points.** The highest-value thing in the map is a short
   "Start here" list per subsystem: the canonical files an agent should open, each
   with a one-phrase reason.
@@ -48,8 +47,7 @@ harness that produces a number for your own workload.
 
 ## The files in the map
 
-`.opencode/context/` holds the five navigation files below, plus one file that is
-a work list rather than a map:
+`.opencode/context/` holds the five navigation files below:
 
 | File | What belongs in it |
 | --- | --- |
@@ -58,7 +56,6 @@ a work list rather than a map:
 | `conventions.md` | Repository-specific rules: naming, module layout, error handling, testing, persistence. Read this before writing code, not after. |
 | `workflows.md` | The few runtime flows worth tracing end to end — how a request becomes a mutation, how a plugin hook reaches the thing it hooks. Read this when you need to know what actually happens at runtime. |
 | `decisions.md` | Architectural constraints that bind future work and that the repository's own decision log does not already record. Each entry states the constraint and points at the page or path that owns it. Capped at 120 non-blank lines; decision records and deliberation are not copied here. |
-| `active.md` | The active backlog: work in flight, grouped by the ISO week each task was opened in. A task that is not marked `[x]` is open and is never removed; a task that is finished and dated is kept for a week after it was finished, then dropped. The plugin enforces that window — see [How it stays current](#how-it-stays-current). Not a navigation file: there is no question it is the answer to. |
 
 The project's root `AGENTS.md` is the standing-instructions home: the client's
 own statement of intent, what they want worked on and how they want it
@@ -98,20 +95,19 @@ Every navigation entry has one shape, in every file:
   the drift check.
 
 Every file has a hard cap, counted in **non-blank lines**: architecture 150,
-contexts 200, conventions 150, workflows 150, decisions 120, active 60. Lines
-are the unit because they are what a reader pays for, they bound an entry that
-wraps to three lines, and the validator can count them exactly; an entry count
-does not bound cost, and a token count needs a tokenizer and is model-specific.
-The cap is enforced by a post-generation validator, not only by the prompt.
-
-The lifecycle generalises the window `active.md` already had. A finished backlog
-task is dropped after 7 days. A `[provisional]` entry in any navigation file is
-dropped 30 days after its `verified` date unless it is re-verified. `[binding]`
-and `[disputed]` never expire by age. An entry whose cited source no longer
-exists is **never** auto-dropped: it may be the only copy, so it is reported as
-unarchived and kept. Only provisional entries whose source still resolves are
-eligible for the sweep. The arithmetic lives in `src/lib/map-schema.ts`; the
-cartographer writes the shape, code decides what has aged out.
+contexts 200, conventions 150, workflows 150, decisions 120. Lines are the unit
+because they are what a reader pays for, they bound an entry that wraps to three
+lines, and the validator can count them exactly; an entry count does not bound
+cost, and a token count needs a tokenizer and is model-specific. The cap is
+enforced by a post-generation validator, not only by the prompt.
+
+A `[provisional]` entry in any navigation file is dropped 30 days after its
+`verified` date unless it is re-verified. `[binding]` and `[disputed]` never
+expire by age. An entry whose cited source no longer exists is **never**
+auto-dropped: it may be the only copy, so it is reported as unarchived and kept.
+Only provisional entries whose source still resolves are eligible for the sweep.
+The arithmetic lives in `src/lib/map-schema.ts`; the cartographer writes the
+shape, code decides what has aged out.
 
 The map is **local and untracked**. It describes *your* checkout on *this*
 machine, so committing it would churn on every session that edits a file, and
@@ -193,25 +189,13 @@ your source.
 If you have defined a command of the same name, yours wins and is left exactly
 as you wrote it — the same merge-without-clobber rule the agents follow.
 
-`active.md` is the file the plugin maintains as a backlog rather than as a
-navigation map. The cartographer records what happened — work in flight, and a
-task marked finished with the date it finished — and the plugin decides what is
-still worth keeping: the file is regrouped by week and a task that was finished
-more than a week ago is dropped. The arithmetic lives in
-`src/lib/active-backlog.ts`, not in the cartographer's prompt, because a rule a
-model applies is a rule the model applies when it feels like it, and the failure
-is silent — the backlog just grows. The plugin normalizes the file on every edit
-of it and once when the session starts, so a hand edit is grouped and pruned
-whether the cartographer ran or not, and the file is rewritten only when its
-canonical form differs from what is on disk, so the write cannot loop.
-
 The same code owns the navigation files' lifecycle, but it may only **drop** an
 entry that is `[provisional]`, past its 30-day window, and whose cited source
 still exists. It never drops a binding constraint or disputed entry, and it
 never drops an entry with no source — that is the one case where the map may be
 the only copy. The plugin is not a second writer of the map in the permission
 sense: `context` is still the only **agent** that writes it. The lifecycle is
-housekeeping by code, the same category as the backlog window.
+housekeeping by code, applied after a run and then audited.
 
 ## One writer
 
@@ -301,7 +285,7 @@ to check is that permission rule, not the map's content.
 - The prompt the model actually runs, in one place: `src/lib/cartographer-prompt.ts`; the tracked copy is `.opencode/prompts/context.txt`, and a test pins equality.
 - The idle/edit trigger and the post-run audit wiring: `src/plugins/context-autoupdate.ts`.
 - The schema, budget, lifecycle and deterministic drift check: `src/lib/map-schema.ts`.
-- The active backlog's window: `src/lib/active-backlog.ts`.
+
 - The one-writer rule check: `src/lib/writer-rule.ts`.
 - Fixtures and their report: `tests/fixtures/context-map/`, `scripts/context-map-fixture.mjs`.
 - The behavioural contracts, with acceptance criteria a test asserts:

package/docs/USER-STORIES.md

@@ -471,6 +471,29 @@ Enforcement is split deliberately, and the split matters: **what the permission
 - [ ] Given the user's config already defines one of the three commands, When the config hook runs, Then that command is left byte-identical while the other two are still added.
 - [ ] Given the commands are injected, When each one's target agent is resolved against the same config object, Then all three resolve to an agent that actually exists there — a command must never point at a missing agent.
 
+### US-35: A timeline survives a restart and resumes unfinished work
+**As a** user whose opencode process restarts in the middle of a session, **I want** the timeline to remember what it has already summarized and to finish the slice it had not written yet, **so that** a crash or restart never silently loses part of the session's work record.
+
+The cursor and retry state used to live only in memory; a process that stopped between messages and the next idle flush forgot that a slice was pending, and a successful summary that produced no bullet text advanced the cursor only in memory, so a restart could summarize the same slice again. The plugin now writes a small per-session state file next to the JSONL timeline (cursor, pending flag, failure count, next retry time); startup resumes pending work, and a deleted session removes both files.
+
+**Story ID(s) for tests:** US-35
+**Acceptance criteria:**
+- [ ] Given a session has a pending timeline slice recorded on disk, When the process restarts, Then the timeline resumes and completes that slice without waiting for a new message event.
+- [ ] Given a summarization succeeds but produces no bullet text, When the process restarts, Then the advanced cursor is still known and the same transcript slice is not summarized again.
+- [ ] Given a session is deleted, When its timeline is removed, Then its durable state file is removed with it.
+
+### US-36: A failed timeline summary retries with backoff
+**As a** user whose summarizer call fails transiently, **I want** the timeline to retry on its own with an increasing delay, **so that** a temporary model or network failure does not leave the timeline permanently behind the session.
+
+A failed summarization used to clear the pending flag and never reschedule, so only new session activity could try again. A failure now marks the slice pending, records the next attempt time, and schedules a retry; repeated failures back off exponentially up to a cap, and an idle event during the wait re-arms the timer instead of bypassing it. A successful retry clears the failure count.
+
+**Story ID(s) for tests:** US-36
+**Acceptance criteria:**
+- [ ] Given a summarization fails transiently, When the retry interval elapses, Then the timeline retries without waiting for new session activity.
+- [ ] Given repeated failures, When retries are scheduled, Then the wait grows with each failure up to a configured cap.
+- [ ] Given a retry is waiting, When the session goes idle before the backoff window elapses, Then the idle event does not bypass the wait.
+- [ ] Given a retry succeeds, When entries are appended, Then the failure count resets to zero and the timeline is no longer pending.
+
 ---
 
 ## Epic H — Retention (sweeps)
@@ -554,6 +577,8 @@ table was filled in.
 | US-20 | G | `tests/stories/g-context-management.test.mjs` |
 | US-21 | G | `tests/stories/g-context-management.test.mjs`, `tests/permission-test.mjs` |
 | US-22 | G | `tests/stories/g-context-management.test.mjs` |
+| US-35 | G | `tests/stories/j-timeline-reliability.test.mjs` |
+| US-36 | G | `tests/stories/j-timeline-reliability.test.mjs` |
 | US-32 | H | `tests/retire-old-sessions-test.mjs` |
 | US-33 | H | `tests/prune-old-events-test.mjs` |
 
@@ -561,8 +586,8 @@ The nine suites under `tests/` are unit-style; the `tests/stories/` suites are
 the behavioural layer, written one epic per file with every test name carrying
 its story id. Run everything with `npm test`.
 
-**No story is uncovered.** The guard reports 33 stories, 325 test cases, and
-33/33 stories with at least one behavioural test; US-1, US-2, US-3, US-6, and
+**No story is uncovered.** The guard reports 36 stories, 348 test cases, and
+36/36 stories with at least one behavioural test; US-1, US-2, US-3, US-6, and
 all of epic F have tests, and the coverage guard fails the build if any of them
 loses one. The scan covers the `tests/stories/` suites and the root-level
 `tests/*-test.mjs` suites.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawaty/lacode",
-  "version": "1.3.1",
+  "version": "2.0.0-beta.0",
   "description": "Ultimate opencode setup for Go users — cost-controlled pooled subagents, hang recovery, and notifications for opencode.",
   "license": "MIT",
   "type": "module",