@lawaty/lacode 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -6,9 +6,102 @@ All notable changes to LaCode are recorded here. The format follows
 
 Versions come from git release commits; the npm version is bumped in the same
 commit as the changelog entry it describes.
-
 ## [Unreleased]
 
+## [0.9.0] — the cartographer keeps an active backlog, and the model stops naming slot variants
+
+### Added
+
+- **The cartographer keeps an active backlog, and the plugin enforces its
+  window.** `.opencode/context/active.md` is a sixth file in the map directory:
+  the work in flight, grouped by the ISO week each task was opened in. A task
+  that is not marked `[x]` is open, and an open task is never removed however
+  old it is; a task that is finished and dated is kept for a week after it was
+  finished and is then dropped. The file is therefore a rolling window rather
+  than a history — the question it answers is "what is open, and what just
+  closed", not "what has ever been done". A backlog that only grows is a
+  backlog nobody reads.
+
+  The window is applied by `src/lib/active-backlog.ts` and by the plugin, not
+  by the cartographer's prompt. Deciding when a task has aged out is
+  arithmetic, and arithmetic belongs where a test can pin the boundary: a rule
+  a model applies is a rule the model applies when it feels like it — one run
+  prunes and the next does not, and nothing anywhere reports the difference,
+  so the failure is silent and 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 boundary is strict: a task finished exactly seven
+  days ago is still that week's news, and is kept.
+
+### Fixed
+
+- **A slot variant is no longer in the agent list the model is shown, so the model
+  stops naming slots by hand.** opencode builds the system prompt's "Available
+  agent types" block by filtering the agent registry on `mode !== "primary"` and on
+  the caller's task permission. It never reads `hidden`: that flag is honoured only
+  by the TUI, the @-mention pickers, the "agent not found" message and default-agent
+  resolution. Every pooled variant was therefore listed to the model under its own
+  name — "explore-1: Hidden pool variant explore-1" — and a model that can see
+  twelve concrete slot names reaches for them, so the root agent kept spawning
+  `explore-1` and `implement-4` instead of the bare base, and the pool refused
+  every one. The refusal was right and the leak that provoked it was not: naming a
+  variant is how a caller would pick the provider and skip the rotation and the
+  slot's ceiling, so it cannot be allowed to succeed. The variants now carry
+  `mode: "primary"`, the one field that filter respects, which takes them out of
+  the agent list while leaving them spawnable by name — the task tool resolves an
+  agent by name and never reads its mode — and out of the TUI, where `hidden`
+  already kept them. The bare bases are untouched and stay in the list, so the
+  model has nothing but the bases to choose from.
+
+- **A refusal no longer names the variant it refused, and the instructions no
+  longer list the names they forbid.** The refusal was the strongest remaining
+  channel. It is the tool result the model reads at the exact moment it is
+  choosing what to spawn next, and it used to repeat the name that had just been
+  denied — so the denial was the thing that taught the name, and the model copied
+  it back. It now names the base instead, which is what the model should type.
+  The same reasoning applies to the rules themselves: "never name a `-N` variant
+  (`explore-1`..`explore-4`, `implement-1`..)" put eight concrete agent names in
+  front of the model in the sentence that told it what to spawn. A rule that
+  lists the names it forbids teaches the names; the rule now states the rule
+  without an example, in the shipped agent prompts, the project prompts and the
+  global delegation rules.
+
+- **The cartographer no longer leaves empty sessions in the session list.** The
+  session was created before the run started, and only the turn's own success
+  and failure paths retired it. Anything that threw in between — a slot that
+  could not be picked, a claim that could not be written, a prompt that failed
+  before it returned — stranded a session with no messages in it: an entry in
+  the user's list that opens as nothing at all. Retirement now covers the whole
+  gap between the create and the prompt, and the delete is *verified* rather
+  than assumed — it is read back afterwards, retried once, and a failure is
+  logged instead of swallowed. (Archiving is not a way out: opencode's list is
+  served from the session rows themselves, so a session with `time_archived` set
+  is still listed. Only a delete removes an entry.)
+- **A finished cartographer run retires its session and keeps the transcript**
+  was already true, and stays true: the transcript is written first and the
+  session deleted second, because the transcript is the only record of what the
+  run did. The plugin's own last 20 runs are kept in full.
+
+### Changed
+
+- **The bundled default pool no longer ships a model its provider has withdrawn.**
+  `presets/free-tier.json` named `opencode/space-bunny-free` as its first slot at
+  weight 3 — the slot that took the most turns. The opencode provider withdrew that
+  model, and because it was the default, every new session then died at step 0 with
+  `ProviderModelNotFoundError: Model not found: opencode/space-bunny-free`. Nothing
+  in the package could tell: the pool warns about a slot that is missing from the
+  config, not about a slot whose model the provider no longer serves, and the root
+  agent's own model lives in the user's config rather than here.
+
+- **`scripts/retire-cartographer-sessions.mjs` clears the sessions the feature
+  did not reach.** Retirement landed after 250 runs had already piled up across
+  the machine's projects, and those were never cleaned. The tool talks to the
+  opencode server over its HTTP API — the same interface the plugin uses — and
+  writes a compact record of each retired session to
+  `~/.local/share/opencode/lacode/cartographer-archive/` before deleting it, so
+  nothing is lost. `--dry-run` shows what it would do.
+
 ## [0.8.0] — cooldowns are probed instead of trusted, and the instructions agent can read the map
 
 ### Added
@@ -371,12 +464,14 @@ experimental; `latest` remains 0.4.2.
 
 - First published release: pooled subagents over a shared set of models.
 
-[Unreleased]: https://github.com/lawaty/lacode/compare/v0.8.0...HEAD
+[Unreleased]: https://github.com/lawaty/lacode/compare/v0.9.0...HEAD
+[0.9.0]: https://github.com/lawaty/lacode/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/lawaty/lacode/compare/v0.7.1...v0.8.0
 [0.7.1]: https://github.com/lawaty/lacode/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/lawaty/lacode/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/lawaty/lacode/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/lawaty/lacode/compare/v0.4.2...v0.5.0
+[0.4.2]: https://github.com/lawaty/lacode/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/lawaty/lacode/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/lawaty/lacode/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/lawaty/lacode/compare/v0.2.2...v0.3.0

package/README.md

@@ -213,8 +213,9 @@ deliberately *not* injected, are in
 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 files:
-`architecture`, `contexts`, `conventions`, `workflows`, `decisions`) and injects
+maintained map of the repository in `.opencode/context/` (five navigation files:
+`architecture`, `contexts`, `conventions`, `workflows`, `decisions`, plus
+`active.md` — the active backlog) 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
@@ -251,7 +252,7 @@ in [docs/CONTEXT.md](docs/CONTEXT.md).
 The project's root `AGENTS.md` is your own statement of intent: it records
 what you want worked on and how you want it approached. It says nothing about
 where code lives, so it can never contradict the code, and within that domain
-it outranks the five generated context files and any agent's inference about what
+it outranks the generated context files and any agent's inference about what
 matters right now.
 
 The file is per-clone and not committed, so it is yours rather than shared
@@ -369,7 +370,7 @@ want it.
 | [Install and troubleshooting](docs/INSTALL.md) | Where opencode puts the package, what to do when the agents are missing, the version matrix, macOS differences, and the `lacode` CLI. |
 | [Configuration reference](docs/CONFIGURATION.md) | Every plugin option, how the pool resolves its slots, per-agent tool grants, and exactly what gets written into your config. |
 | [OmniRoute gateway](docs/OMNIROUTE.md) | The optional local gateway integration: setup, full option set, a latency-measured free combo, and its troubleshooting table. |
-| [Context map](docs/CONTEXT.md) | The mechanism behind `.opencode/context/` — the one-writer permission rule, the five files, and what the log lines mean. |
+| [Context map](docs/CONTEXT.md) | The mechanism behind `.opencode/context/` — the one-writer permission rule, the files, and what the log lines mean. |
 | [Remote hosts and notifications](docs/TUNNEL.md) | The SSH notification hop, payload format, receiver contract, and holding the forward open. |
 | [Benchmarks](docs/BENCHMARKS.md) | How the cost harness works, and why it deliberately publishes no savings number. |
 | [User stories](docs/USER-STORIES.md) | The behavioural contracts behind all of the above, written so a test can assert them. |

package/dist/agents.js

@@ -90,8 +90,8 @@ failing, or a runtime message saying no slot is available \u2014 that is not a r
 to do the work yourself, and not a reason to stop and ask.
 
 **Retry.** A refused or cooling slot is transient and costs you nothing but a
-turn. Spawn the bare base again. Do not escalate a \`-N\` variant when a refusal
-names one \u2014 the refusal means the pool has a routing problem, not that you
+turn. Spawn the bare base again. Do not escalate to a numbered variant after a
+refusal \u2014 the refusal means the pool has a routing problem, not that you
 picked the wrong number.
 
 Retry is always available and never wrong, which is why it is the default. But
@@ -450,7 +450,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. 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, 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.",
     "mode": "subagent",
     "temperature": 0.1,
     prompt: `# Role
@@ -466,7 +466,7 @@ map is a derived index of it.
 
 # Owned files
 
-You own exactly these five files and nothing else:
+You own exactly these files and nothing else:
 
 - \`.opencode/context/architecture.md\` \u2014 high-level architecture, major layers,
   boundaries, important entry points, dependency rules. Target 50\u2013150 lines.
@@ -481,6 +481,9 @@ You own exactly these five files and nothing else:
 - \`.opencode/context/decisions.md\` \u2014 architectural decisions discovered
   during work that are not already recorded in the project's own decision
   log. Concise; variable length.
+- \`.opencode/context/active.md\` \u2014 the active backlog: work in flight, grouped
+  by the week it was opened. Not part of the navigation map; it is described
+  under "Task backlog" below.
 
 # Current-state only
 
@@ -520,7 +523,8 @@ Explore progressively and stop as soon as you have a usable map:
 You are mapping a city, not auditing every house. Do not attempt to
 understand every file.
 
-Then write the five files. For each significant subsystem, give a short
+Then write the five files. 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 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.
@@ -544,7 +548,7 @@ Trigger: \`.opencode/context/\` exists and work has just been done here.
    - an architectural decision
    - a new dependency between subsystems
    - a renamed or relocated subsystem
-   - a previously undocumented invariant
+    - a previously undocumented invariant
 
 Do not update documentation merely because source files changed. Do not
 rewrite files wholesale. Do not make timestamp-only edits. Do not add a fact
@@ -552,6 +556,38 @@ that is already stated in another context file \u2014 one fact has one home, and
 the other files link to it. 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.
+
+# 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:
@@ -638,7 +674,7 @@ the lowest-value ones, and link out to authoritative project docs.
 
 Trigger: an explicit review (see the \`context-review\` command).
 
-Audit the five files for:
+Audit the map files and the backlog for:
 
 - stale information \u2014 verify claims against the code
 - contradictions between files, or between the map and the code
@@ -646,10 +682,12 @@ Audit the five files for:
 - duplicated information \u2014 one canonical place per fact
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything unmarked that you cannot verify
+- 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 five files you own. Never modify source code
-during a review. Report what you found, what you fixed, and what you
-could not verify.
+Fix problems only in the files you own. Never modify source code during a
+review. Report what you found, what you fixed, and what you could not
+verify.
 
 # Reporting
 
@@ -817,7 +855,28 @@ function buildAgentSet() {
       const variant = {
         ...def,
         description: `Hidden pool variant ${base}-${slot}: slot ${slot}. Its model is NOT set here -- LaCode injects it from the resolved pool preset at config time, so the preset is the only place a pool model is written down. Spawn '${base}' and let the pool route.`,
-        hidden: true
+        hidden: true,
+        // `mode: "primary"` is what keeps a variant OUT of the model's system
+        // prompt. `hidden` cannot do it.
+        //
+        // opencode builds the "Available agent types" block by filtering the
+        // agent registry on `mode !== "primary"` and on the caller's task
+        // permission. It never looks at `hidden`: that flag is honoured only by
+        // the TUI and the @-mention pickers, by the "agent not found" message,
+        // and by default-agent resolution. A variant left as `mode: "subagent"`
+        // is therefore listed to the model under its own name -- "explore-1:
+        // Hidden pool variant explore-1" -- and the model copies that name
+        // straight into its next spawn. The pool then refuses it, because
+        // naming a variant is how a caller would pick the provider and skip the
+        // rotation. The refusal is right; the leak that provokes it is not.
+        //
+        // `mode` is the only field that filter respects, and setting it here is
+        // safe: the task tool never reads an agent's mode -- it resolves the
+        // agent by name and runs it -- and every other place that filters on
+        // `mode !== "primary"` also filters on `!hidden`, which these already
+        // are. opencode uses this same pair for its own compaction, title and
+        // summary agents.
+        mode: "primary"
       };
       delete variant.model;
       set[`${base}-${slot}`] = variant;

package/dist/commands.js

@@ -67,7 +67,8 @@ your system prompt.
 Otherwise follow the bootstrap procedure in your system prompt: progressive
 exploration (README \u2192 existing docs \u2192 manifests \u2192 top-level structure \u2192 build
 and framework config \u2192 entry points \u2192 selective source), then write the five
-context files inside their size targets.
+context files inside their size targets. Also create
+\`.opencode/context/active.md\` with its heading and no tasks.
 
 Remember: write conclusions, not inventories. Link to the project's existing
 documentation instead of duplicating it.
@@ -104,10 +105,10 @@ timestamp-only edits. If nothing material changed, make no edits and report
     subtask: true,
     template: `Context review.
 
-Everything outside the five context files is read-only for this run. Do not
+Everything outside \`.opencode/context/\` is read-only for this run. Do not
 modify source code under any circumstances.
 
-Audit the five context files for:
+Audit the context files and the backlog for:
 
 - stale information \u2014 verify claims against the actual code
 - contradictions between context files, or between the map and the code
@@ -118,6 +119,8 @@ Audit the five context files for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything stated as fact that you cannot verify,
   or that lacks a confidence marker
+- 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

@@ -51,10 +51,10 @@ var USER_CONFIG_DIR = join2(homedir(), ".config", "lacode");
 var USER_MODELS_PATH = join2(USER_CONFIG_DIR, "pool.json");
 var USER_MODELS_TXT = join2(USER_CONFIG_DIR, "pool.txt");
 var FALLBACK_SLOTS = [
-  { index: 1, model: "opencode/space-bunny-free", weight: 3 },
-  { index: 2, model: "opencode-go/longcat-2.5-preview-free", weight: 2 },
-  { index: 3, model: "opencode/big-pickle", weight: 1 },
-  { index: 4, model: "opencode/longcat-2.5-preview-free", weight: 1 }
+  { index: 1, model: "opencode/big-pickle", weight: 3 },
+  { index: 2, model: "opencode-go/minimax-m3.1-flash-free", weight: 2 },
+  { index: 3, model: "opencode/deepseek-v4.1-flash-free", weight: 1 },
+  { index: 4, model: "opencode/glm-5.3-flash-free", weight: 1 }
 ];
 function parseSlots(parsed, origin) {
   const problems = [];
@@ -786,8 +786,8 @@ failing, or a runtime message saying no slot is available \u2014 that is not a r
 to do the work yourself, and not a reason to stop and ask.
 
 **Retry.** A refused or cooling slot is transient and costs you nothing but a
-turn. Spawn the bare base again. Do not escalate a \`-N\` variant when a refusal
-names one \u2014 the refusal means the pool has a routing problem, not that you
+turn. Spawn the bare base again. Do not escalate to a numbered variant after a
+refusal \u2014 the refusal means the pool has a routing problem, not that you
 picked the wrong number.
 
 Retry is always available and never wrong, which is why it is the default. But
@@ -1146,7 +1146,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. 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, 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.",
     "mode": "subagent",
     "temperature": 0.1,
     prompt: `# Role
@@ -1162,7 +1162,7 @@ map is a derived index of it.
 
 # Owned files
 
-You own exactly these five files and nothing else:
+You own exactly these files and nothing else:
 
 - \`.opencode/context/architecture.md\` \u2014 high-level architecture, major layers,
   boundaries, important entry points, dependency rules. Target 50\u2013150 lines.
@@ -1177,6 +1177,9 @@ You own exactly these five files and nothing else:
 - \`.opencode/context/decisions.md\` \u2014 architectural decisions discovered
   during work that are not already recorded in the project's own decision
   log. Concise; variable length.
+- \`.opencode/context/active.md\` \u2014 the active backlog: work in flight, grouped
+  by the week it was opened. Not part of the navigation map; it is described
+  under "Task backlog" below.
 
 # Current-state only
 
@@ -1216,7 +1219,8 @@ Explore progressively and stop as soon as you have a usable map:
 You are mapping a city, not auditing every house. Do not attempt to
 understand every file.
 
-Then write the five files. For each significant subsystem, give a short
+Then write the five files. 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 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.
@@ -1240,7 +1244,7 @@ Trigger: \`.opencode/context/\` exists and work has just been done here.
    - an architectural decision
    - a new dependency between subsystems
    - a renamed or relocated subsystem
-   - a previously undocumented invariant
+    - a previously undocumented invariant
 
 Do not update documentation merely because source files changed. Do not
 rewrite files wholesale. Do not make timestamp-only edits. Do not add a fact
@@ -1248,6 +1252,38 @@ that is already stated in another context file \u2014 one fact has one home, and
 the other files link to it. 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.
+
+# 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:
@@ -1334,7 +1370,7 @@ the lowest-value ones, and link out to authoritative project docs.
 
 Trigger: an explicit review (see the \`context-review\` command).
 
-Audit the five files for:
+Audit the map files and the backlog for:
 
 - stale information \u2014 verify claims against the code
 - contradictions between files, or between the map and the code
@@ -1342,10 +1378,12 @@ Audit the five files for:
 - duplicated information \u2014 one canonical place per fact
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything unmarked that you cannot verify
+- 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 five files you own. Never modify source code
-during a review. Report what you found, what you fixed, and what you
-could not verify.
+Fix problems only in the files you own. Never modify source code during a
+review. Report what you found, what you fixed, and what you could not
+verify.
 
 # Reporting
 
@@ -1513,7 +1551,28 @@ function buildAgentSet() {
       const variant = {
         ...def,
         description: `Hidden pool variant ${base}-${slot}: slot ${slot}. Its model is NOT set here -- LaCode injects it from the resolved pool preset at config time, so the preset is the only place a pool model is written down. Spawn '${base}' and let the pool route.`,
-        hidden: true
+        hidden: true,
+        // `mode: "primary"` is what keeps a variant OUT of the model's system
+        // prompt. `hidden` cannot do it.
+        //
+        // opencode builds the "Available agent types" block by filtering the
+        // agent registry on `mode !== "primary"` and on the caller's task
+        // permission. It never looks at `hidden`: that flag is honoured only by
+        // the TUI and the @-mention pickers, by the "agent not found" message,
+        // and by default-agent resolution. A variant left as `mode: "subagent"`
+        // is therefore listed to the model under its own name -- "explore-1:
+        // Hidden pool variant explore-1" -- and the model copies that name
+        // straight into its next spawn. The pool then refuses it, because
+        // naming a variant is how a caller would pick the provider and skip the
+        // rotation. The refusal is right; the leak that provokes it is not.
+        //
+        // `mode` is the only field that filter respects, and setting it here is
+        // safe: the task tool never reads an agent's mode -- it resolves the
+        // agent by name and runs it -- and every other place that filters on
+        // `mode !== "primary"` also filters on `!hidden`, which these already
+        // are. opencode uses this same pair for its own compaction, title and
+        // summary agents.
+        mode: "primary"
       };
       delete variant.model;
       set[`${base}-${slot}`] = variant;
@@ -1553,7 +1612,8 @@ your system prompt.
 Otherwise follow the bootstrap procedure in your system prompt: progressive
 exploration (README \u2192 existing docs \u2192 manifests \u2192 top-level structure \u2192 build
 and framework config \u2192 entry points \u2192 selective source), then write the five
-context files inside their size targets.
+context files inside their size targets. Also create
+\`.opencode/context/active.md\` with its heading and no tasks.
 
 Remember: write conclusions, not inventories. Link to the project's existing
 documentation instead of duplicating it.
@@ -1590,10 +1650,10 @@ timestamp-only edits. If nothing material changed, make no edits and report
     subtask: true,
     template: `Context review.
 
-Everything outside the five context files is read-only for this run. Do not
+Everything outside \`.opencode/context/\` is read-only for this run. Do not
 modify source code under any circumstances.
 
-Audit the five context files for:
+Audit the context files and the backlog for:
 
 - stale information \u2014 verify claims against the actual code
 - contradictions between context files, or between the map and the code
@@ -1604,6 +1664,8 @@ Audit the five context files for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything stated as fact that you cannot verify,
   or that lacks a confidence marker
+- 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.`
@@ -2096,12 +2158,11 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
       if (typeof requested !== "string") return;
       const manual = manualVariant(requested);
       if (manual) {
-        await log("warn", `refused manual spawn of slot variant ${requested}; spawn "${manual}" instead`, {
-          variant: requested,
+        await log("warn", `refused manual spawn of a pool slot variant; spawn "${manual}" instead`, {
           base: manual
         });
         throw new Error(
-          `${requested} is a pool slot variant and cannot be spawned by name. Naming it lets the caller pick the provider: it skips the round-robin rotation and the slot's ceiling, so one provider takes every concurrent claim. Spawn "${manual}" and let the pool choose the slot.`
+          `That agent is a pool slot variant and cannot be spawned by name. Naming it lets the caller pick the provider: it skips the round-robin rotation and the slot's ceiling, so one provider takes every concurrent claim. Spawn "${manual}" and let the pool choose the slot.`
         );
       }
       try {
@@ -2226,10 +2287,110 @@ round robin in slot order, each slot taking as many turns as its weight says, so
 });
 
 // src/plugins/context-autoupdate.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync as readdirSync2, statSync as statSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import * as path2 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/jsonc.ts
 var stripJsonc = (raw) => {
   let out = "";
@@ -2437,7 +2598,7 @@ var changedSince = (before, dir) => {
 };
 var RETAIN_TRANSCRIPTS = 20;
 var transcriptDir = () => process.env.LACODE_TRANSCRIPT_DIR ?? path2.join(homedir2(), ".local", "share", "opencode", "lacode", "cartographer");
-var retireSession = async (client, directory, sessionID, mode) => {
+var retireSession = async (client, directory, sessionID, mode, log) => {
   try {
     const transcript = await client.session.messages({ path: { id: sessionID }, query: { directory } }).then((r) => r.data).catch(() => void 0);
     const dir = transcriptDir();
@@ -2446,8 +2607,18 @@ var retireSession = async (client, directory, sessionID, mode) => {
     const file = path2.join(dir, `${stamp}-${mode}.json`);
     writeFileSync2(file, JSON.stringify({ sessionID, mode, messages: transcript ?? null }, null, 2));
     pruneTranscripts(dir);
+    const gone = async () => await client.session.get({ path: { id: sessionID }, query: { directory } }).then((r) => r.data).catch(() => void 0) === void 0;
     await client.session.delete({ path: { id: sessionID }, query: { directory } }).catch(() => void 0);
-  } catch {
+    if (await gone()) return;
+    await new Promise((resolve3) => setTimeout(resolve3, 500));
+    await client.session.delete({ path: { id: sessionID }, query: { directory } }).catch(() => void 0);
+    if (await gone()) return;
+    await log?.("warn", "the cartographer's session could not be removed from the session list; it stays as an empty entry", {
+      sessionID,
+      mode
+    });
+  } catch (error) {
+    await log?.("warn", `could not retire the cartographer's session: ${String(error)}`, { sessionID, mode });
   }
 };
 var pruneTranscripts = (dir) => {
@@ -2471,6 +2642,7 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
   });
   const root = path2.resolve(directory);
   const contextAbs = path2.join(root, CONTEXT_DIR2);
+  const activeBacklogPath = path2.join(contextAbs, ACTIVE_BACKLOG_FILE);
   const config = findProjectConfig();
   const writerProblem = config ? verifyWriterRule(config, contextAbs, root) : void 0;
   if (writerProblem) void log("error", writerProblem);
@@ -2480,6 +2652,23 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
     if (absolute === contextAbs || absolute.startsWith(contextAbs + path2.sep)) return false;
     return !toPosix2(absolute).split("/").some((segment) => IGNORED_SEGMENTS.has(segment));
   };
+  const normalizeActiveBacklog = async () => {
+    try {
+      if (!existsSync2(activeBacklogPath)) return { removed: 0 };
+      const before = readFileSync4(activeBacklogPath, "utf8");
+      const { text, removed } = normalizeBacklog(before);
+      if (text !== before) writeFileSync2(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 };
+    }
+  };
+  void normalizeActiveBacklog();
   const listed = (files) => {
     const shown = files.slice(0, MAX_FILES_LISTED);
     const rest = files.length - shown.length;
@@ -2497,7 +2686,7 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
     "",
     NO_BULK_READS,
     "",
-    "Follow the bootstrap procedure in your system prompt: progressive exploration, then write the five context files within their size targets. 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 size targets. 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."
   ].join("\n") : [
     "Incremental context update. Project root: " + directory,
     "",
@@ -2506,13 +2695,18 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
     "",
     NO_BULK_READS,
     "",
-    '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 a previously undocumented invariant. Do not edit documentation merely because source files changed. If nothing material changed, make no edits and report "no update needed".'
+    '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 a previously undocumented invariant. 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.'
   ].join("\n");
   return {
     event: async ({ event }) => {
       try {
         if (event.type === "file.edited") {
-          if (isTracked(event.properties.file)) pending.add(event.properties.file);
+          const file = event.properties.file;
+          if (path2.resolve(root, file) === activeBacklogPath) {
+            await normalizeActiveBacklog();
+            return;
+          }
+          if (isTracked(file)) pending.add(file);
           return;
         }
         if (event.type !== "session.idle") return;
@@ -2551,22 +2745,36 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
           return;
         }
         const claimKey2 = claimKey(target, "context-autoupdate");
-        acquire(state2, "context", slot, target, claimKey2, target);
-        await log("info", `borrowed pool slot ${slot.index} (${slot.model}, w${slot.weight}) for auto ${mode}`, {
-          slot: slot.index,
-          weight: slot.weight,
-          model: slot.model
-        });
-        lastRun = Date.now();
-        owned.set(target, Date.now());
-        const before = snapshotMap(contextAbs);
-        client.session.prompt({
-          path: { id: target },
-          query: { directory },
-          body: { agent, parts: [{ type: "text", text: compose(mode, files) }] }
-        }).then(async (result) => {
+        let claimed = false;
+        let before;
+        let started;
+        try {
+          acquire(state2, "context", slot, target, claimKey2, target);
+          claimed = true;
+          await log("info", `borrowed pool slot ${slot.index} (${slot.model}, w${slot.weight}) for auto ${mode}`, {
+            slot: slot.index,
+            weight: slot.weight,
+            model: slot.model
+          });
+          lastRun = Date.now();
+          owned.set(target, Date.now());
+          before = snapshotMap(contextAbs);
+          started = client.session.prompt({
+            path: { id: target },
+            query: { directory },
+            body: { agent, parts: [{ type: "text", text: compose(mode, files) }] }
+          });
+        } catch (error) {
+          if (claimed) release(state2, claimKey2);
+          owned.delete(target);
+          await retireSession(client, directory, target, mode, log);
+          requeue();
+          await log("error", `auto ${mode} could not start: ${String(error)}`);
+          return;
+        }
+        started.then(async (result) => {
           release(state2, claimKey2);
-          await retireSession(client, directory, target, mode);
+          await retireSession(client, directory, target, mode, log);
           const failure = result.error ?? result.data?.info?.error;
           if (failure) {
             requeue();
@@ -2590,7 +2798,7 @@ var contextAutoUpdateHooks = (async ({ client, directory }, options) => {
           }
         }).catch(async (error) => {
           release(state2, claimKey2);
-          await retireSession(client, directory, target, mode);
+          await retireSession(client, directory, target, mode, log);
           requeue();
           await log("error", `auto ${mode} failed: ${String(error)}`);
         });
@@ -3487,7 +3695,7 @@ var omniRouteHooks = async (input, options, deps = {}) => {
 
 // src/lib/selfupdate.ts
 import { spawn as spawn2 } from "node:child_process";
-import { closeSync, mkdirSync as mkdirSync3, openSync, readFileSync as readFileSync4, renameSync as renameSync2, rmSync, statSync as statSync3, unlinkSync as unlinkSync3, writeFileSync as writeFileSync3, writeSync } from "node:fs";
+import { closeSync, mkdirSync as mkdirSync3, openSync, readFileSync as readFileSync5, renameSync as renameSync2, rmSync, statSync as statSync3, unlinkSync as unlinkSync3, writeFileSync as writeFileSync3, writeSync } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { dirname as dirname3, join as join6, resolve as resolve2 } from "node:path";
 var REGISTRY_LATEST = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
@@ -3514,7 +3722,7 @@ function compareSemver(a, b) {
 }
 function readInstalledVersion(packageRoot, read = (path4) => {
   try {
-    return readFileSync4(path4, "utf8");
+    return readFileSync5(path4, "utf8");
   } catch {
     return void 0;
   }
@@ -3574,7 +3782,7 @@ async function fetchLatest(fetchImpl = fetch, timeoutMs = FETCH_TIMEOUT_MS) {
 }
 function readState(path4 = STATE_PATH) {
   try {
-    return JSON.parse(readFileSync4(path4, "utf8"));
+    return JSON.parse(readFileSync5(path4, "utf8"));
   } catch {
     return {};
   }
@@ -3613,7 +3821,7 @@ function acquireLock(path4 = LOCK_PATH, now = Date.now()) {
   } catch {
     let orphaned = false;
     try {
-      const pid = Number.parseInt(readFileSync4(path4, "utf8").trim(), 10);
+      const pid = Number.parseInt(readFileSync5(path4, "utf8").trim(), 10);
       orphaned = !Number.isFinite(pid) || pid <= 0 || !isProcessAlive(pid);
     } catch {
       orphaned = true;

package/dist/pool.js

@@ -51,10 +51,10 @@ var USER_CONFIG_DIR = join2(homedir(), ".config", "lacode");
 var USER_MODELS_PATH = join2(USER_CONFIG_DIR, "pool.json");
 var USER_MODELS_TXT = join2(USER_CONFIG_DIR, "pool.txt");
 var FALLBACK_SLOTS = [
-  { index: 1, model: "opencode/space-bunny-free", weight: 3 },
-  { index: 2, model: "opencode-go/longcat-2.5-preview-free", weight: 2 },
-  { index: 3, model: "opencode/big-pickle", weight: 1 },
-  { index: 4, model: "opencode/longcat-2.5-preview-free", weight: 1 }
+  { index: 1, model: "opencode/big-pickle", weight: 3 },
+  { index: 2, model: "opencode-go/minimax-m3.1-flash-free", weight: 2 },
+  { index: 3, model: "opencode/deepseek-v4.1-flash-free", weight: 1 },
+  { index: 4, model: "opencode/glm-5.3-flash-free", weight: 1 }
 ];
 function parseSlots(parsed, origin) {
   const problems = [];

package/docs/CONTEXT.md

@@ -29,10 +29,11 @@ the exploration it replaces is worse than no map:
   for order mutations", not "there is a file called OrderService in
   `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 files, each with a defined scope, so an agent
-  reads one of them rather than all of them.
+- **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.
 - **Canonical entry points.** The highest-value thing in the map is a short
-  "Start here" list per subsystem: the five files an agent should open, each
+  "Start here" list per subsystem: the canonical files an agent should open, each
   with a one-phrase reason.
 - **It links out.** Your project's own README, ADRs and docs are authoritative
   and are not duplicated here.
@@ -47,7 +48,8 @@ harness that produces a number for your own workload.
 
 ## The files in the map
 
-`.opencode/context/` holds the five generated files below:
+`.opencode/context/` holds the five navigation files below, plus one file that is
+a work list rather than a map:
 
 | File | What belongs in it |
 | --- | --- |
@@ -56,6 +58,7 @@ harness that produces a number for your own workload.
 | `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 decisions that the repository's own decision log does not already record. Concise, variable length. |
+| `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
@@ -135,6 +138,18 @@ 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 one file in the directory the plugin maintains rather than
+the cartographer. 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.
+
 ## One writer
 
 Only `context` writes the map. Every other agent is told never to edit
@@ -152,7 +167,7 @@ naming the one writer, and the permission rule — a permission denial tells an
 agent nothing about what it should have done instead.
 
 This exists because two writers produce a map that is neither current nor
-trustworthy. Concurrent sessions rewriting the same five files produce
+trustworthy. Concurrent sessions rewriting the same files produce
 contradictions that no later reader can resolve, and the reader has no way to
 tell which version is newer.
 
@@ -193,7 +208,7 @@ startup check has no way to see a worktree it was not told about.
 
 How to detect it: open opencode from the repository root, not from a
 subdirectory of it. If `ls .opencode/context` from your shell's current
-directory does not list the five files, your shell is not at the root and
+directory does not list the map files, your shell is not at the root and
 neither is opencode's worktree. The cost of getting it wrong is not a crash —
 it is a map maintained only by prompt, with no mechanism enforcing who writes it.
 

package/docs/OMNIROUTE.md

@@ -103,8 +103,8 @@ work (exploration, implementation, cartography) through the gateway, add an
 ```
 # ~/.config/lacode/pool.txt
 omniroute/free-mix
-opencode/space-bunny-free
-opencode-go/longcat-2.5-preview-free
+opencode/big-pickle
+opencode-go/minimax-m3.1-flash-free
 ```
 
 OmniRoute is a provider like any other: the pool decides its place and weight,

package/package.json

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

package/presets/README.md

@@ -36,10 +36,10 @@ in place, no JSON and no objects:
 
 ```text
 # provider/model-id                       weight
-opencode-go/longcat-2.5-preview-free      3
-opencode/space-bunny-free                 2
-opencode/big-pickle                       1
-opencode/longcat-2.5-preview-free         1
+opencode/big-pickle                       3
+opencode-go/minimax-m3.1-flash-free       2
+opencode/deepseek-v4.1-flash-free         1
+opencode/glm-5.3-flash-free               1
 ```
 
 `#` starts a comment (whole-line or trailing), blank lines are ignored, and the

package/presets/free-tier.json

@@ -26,11 +26,27 @@
     "  3. once EVERY slot is at its ceiling, the overflow goes to the least loaded slot,",
     "     so a burst past the summed ceilings degrades to even spreading and never blocks",
     "",
-    "With this file: space-bunny takes 3 consecutive turns, then longcat-2.5-preview",
-    "(opencode-go) takes 2, then big-pickle and longcat-2.5-preview (Zen) take 1 each -- sequence 1,1,1,2,2,3,4,...",
+    "With this file: big-pickle takes 3 consecutive turns, then minimax-m3.1-flash-free",
+    "(opencode-go) takes 2, then deepseek-v4.1-flash-free and glm-5.3-flash-free take 1",
+    "each -- sequence 1,1,1,2,2,3,4,...",
     "Equal weights give a plain round robin in list order. 2,2,1,1 reproduces the old",
     "primary/overflow cycle exactly, which is why the old tier values still work.",
     "",
+    "WEIGHTS DESCEND, AND THAT IS NOT COSMETIC. The rotation is order-first: the run is",
+    "expanded in declaration order, so the heaviest slot must come first for a skip to",
+    "land on the heaviest slot that is LEFT. A heavier slot declared after a lighter one",
+    "is unreachable in the way the pool means.",
+    "",
+    "EVERY SLOT IS A MODEL THAT IS PROBABLY STILL THERE NEXT WEEK, AND NO TWO SLOTS",
+    "SHARE A FAMILY. A free model can be withdrawn by its provider without warning --",
+    "space-bunny-free was pulled from the opencode provider while it was still this",
+    "file's first slot, and every new session then died on 'Model not found'. So the",
+    "slots here are the long-lived free ones (big-pickle has been on the opencode",
+    "provider for years), spread over two providers and four model families, because a",
+    "pool where every slot is one family is one withdrawal away from being empty. If a",
+    "slot does go away, the plugin warns at startup and the rest keep working; the fix",
+    "is a one-line edit here, not a redesign.",
+    "",
     "Round-robin rather than heaviest-first because re-prioritising the heaviest slot on",
     "EVERY spawn drained the fastest provider's free-tier window early: one provider",
     "absorbed all work up to its ceiling and kept being refilled the moment a claim",
@@ -67,9 +83,9 @@
     "Changing this file requires restarting every opencode process: plugins are not hot-reloaded."
   ],
   "slots": [
-    { "model": "opencode/space-bunny-free", "weight": 3 },
-    { "model": "opencode-go/longcat-2.5-preview-free", "weight": 2 },
-    { "model": "opencode/big-pickle", "weight": 1 },
-    { "model": "opencode/longcat-2.5-preview-free", "weight": 1 }
+    { "model": "opencode/big-pickle", "weight": 3 },
+    { "model": "opencode-go/minimax-m3.1-flash-free", "weight": 2 },
+    { "model": "opencode/deepseek-v4.1-flash-free", "weight": 1 },
+    { "model": "opencode/glm-5.3-flash-free", "weight": 1 }
   ]
-}
+}