zames_pro 2.82.136 → 2.82.137

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.82.137] - 2026-10-24
+
+### Changed
+
+- docs: drop backlog-id references from source comments
+
 ## [2.82.136] - 2026-10-24
 
 ### Fixed

package/dist/agent-loop.js

@@ -14,7 +14,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
     // `undefined` means "read .zames/hooks.json"; an explicit null disables
     // hooks entirely.
     const hookConfig = hooks === undefined ? loadHooks(workdir) : (hooks ?? {});
-    // Same for the approval policy (C1): read `.zames/permissions.json` once.
+    // Same for the approval policy: read `.zames/permissions.json` once.
     const permissionPolicy = permissions === undefined ? loadPermissions(workdir) : permissions;
     // UI callbacks must NEVER break the agent loop. A rendering error (a huge
     // tool result, a broken markdown frame, a closed terminal) used to throw
@@ -81,7 +81,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
     if (freshChat) {
         await browser.newChat();
         transcript?.log('new_chat');
-        // SessionStart hook (N32): a fresh chat is the start of a session, so a
+        // SessionStart hook: a fresh chat is the start of a session, so a
         // hook can inject context or set up state. Best-effort, output is logged.
         try {
             const out = await runLifecycleHooks(hookConfig, 'SessionStart', workdir);
@@ -118,7 +118,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
         let context;
         try {
             // Pass the task text so nested AGENTS.md/MEMORY.md for the directories
-            // this task actually touches are pulled in (B6, path-scoped rules).
+            // this task actually touches are pulled in (path-scoped rules).
             context = await loadProjectContext(workdir, [task]);
         }
         catch {
@@ -280,7 +280,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
     let lastAutoCompactTokens = -1;
     // Set when an auto-compact returned the SAME chat id it started in — i.e.
     // the "fresh chat" never opened and the compaction did nothing. Without this
-    // guard a broken newChat() (see B2) made the loop compact on EVERY tool call
+    // guard a broken newChat() made the loop compact on EVERY tool call
     // while the context kept growing. Defense in depth: the root cause is fixed,
     // but a future regression must not turn into an endless "compacting" loop.
     let autoCompactDisabled = false;
@@ -314,7 +314,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
         // 300s rate-limit wait or the finish loop) while the next iteration
         // started a SECOND ask() against the same page — two sends / two Continue
         // clicks.
-        // UserPromptSubmit hook (N32): runs right before the prompt is sent. Its
+        // UserPromptSubmit hook: runs right before the prompt is sent. Its
         // stdout is appended to the outgoing message as extra context, mirroring
         // Claude Code. Best-effort — a hook failure never blocks the send.
         try {
@@ -787,7 +787,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
                     'repeat the identical call.';
             continue;
         }
-        // N34: several READ-ONLY calls in one batch are independent, so run them
+        // Several READ-ONLY calls in one batch are independent, so run them
         // concurrently instead of one-by-one (the model often emits 4-6 Reads in a
         // single answer and each awaited round-trip added latency). The fast path
         // is deliberately NARROW: it is taken only when EVERY call is a known
@@ -1016,7 +1016,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
                     results.push({ tool: call.tool, result: blocked });
                     continue;
                 }
-                // Approval policy (C1): a `deny` rule blocks the call (like a PreToolUse
+                // Approval policy: a `deny` rule blocks the call (like a PreToolUse
                 // denial); an `ask` rule prompts the operator. Hooks stay authoritative
                 // for programmatic guards — this is the human-in-the-loop layer.
                 const decision = decidePermission(permissionPolicy, call.tool, call.args);
@@ -1065,7 +1065,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
                 const poll = setInterval(syncToolAbort, 100);
                 if (typeof poll.unref === 'function')
                     poll.unref();
-                // Time the tool (T-D3): the transcript carries durationMs so /cost can
+                // Time the tool: the transcript carries durationMs so /cost can
                 // show where the time goes (frequent Read→Edit cycles vs slow Bash).
                 const toolStart = Date.now();
                 try {
@@ -1089,7 +1089,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
 [PostToolUse hook]
 ${post}`;
                 }
-                // N38: after a file-mutating tool, run the project's own check and
+                // After a file-mutating tool, run the project's own check and
                 // append its summary, so a type error reaches the model immediately
                 // instead of costing a whole round-trip. Best-effort and capped.
                 if (shouldRunDiagnostics(diagnostics, call.tool)) {

package/dist/changelog.js

@@ -80,7 +80,7 @@ export function renderChangelogDraft(groups) {
 }
 /**
  * Replace the body between `## [Unreleased]` and the next `## [` heading with
- * a freshly drafted body (D2). PURE so a test can pin the exact behavior.
+ * a freshly drafted body. PURE so a test can pin the exact behavior.
  *
  * When `body` is empty the existing Unreleased section is CLEARED to just the
  * heading (no stray blank content). A changelog without an Unreleased heading

package/dist/commands.js

@@ -238,7 +238,7 @@ export function renderCost(stats, transcriptFile, tokenUsage = null, t = transla
         for (const [name, n] of top)
             lines.push(' ' + nameLine(name) + ': ' + n);
     }
-    // T-D3: where the time went. Sort by total ms, show the top tools with the
+    // Where the time went. Sort by total ms, show the top tools with the
     // count and a human duration, so Read→Edit cycles and slow Bash calls are
     // visible at a glance.
     const byTime = Object.entries(stats.toolTime || {})

package/dist/compact.js

@@ -43,7 +43,7 @@ export async function performCompact(opts) {
     try {
         if (!quiet)
             log(t('compact.start'));
-        // PreCompact hook (N32): runs BEFORE the chat is summarized/rewritten, so
+        // PreCompact hook: runs BEFORE the chat is summarized/rewritten, so
         // a hook can persist state or notify. Best-effort.
         try {
             const out = await runLifecycleHooks(loadHooks(workdir), 'PreCompact', workdir, { chatId: currentChatId });

package/dist/config.js

@@ -135,7 +135,7 @@ export const DEFAULTS = {
         contextLimit: 1_000_000,
         // 0 = auto: terminal width, capped at 100 columns (the historical width).
         answerWidth: 0,
-        // N37 statusLine hook. Off by default; edit config.json to set a command.
+        // statusLine hook. Off by default; edit config.json to set a command.
         statusLineCommand: '',
         statusLineIntervalMs: 10_000,
         // Use the Ink/React TUI for the input area (the rich editor). Set to false

package/dist/index.js

@@ -257,7 +257,7 @@ const RELOADABLE = [
     'config',
     'fsutil',
     'backlog',
-    // C3 modules index.ts now calls through the mod bag (G2): without this a
+    // Modules index.ts now calls through the mod bag: without this a
     // /reload silently kept the OLD commands/run-task/attach-refs until a restart.
     // 'input/layout' is NOT listed: its only live consumers are input.ts (the
     // long-lived LineEditor, itself not reloadable) and spinner.ts, which already
@@ -594,7 +594,7 @@ async function refreshDynamicCommands(workdir) {
         }
         const cmds = await loadCommands(workdir);
         for (const c of cmds) {
-            // B7: carry the declared argument hint as a separate field so the hint is
+            // Carry the declared argument hint as a separate field so the hint is
             // SHOWN in the suggest list but never inserted into the input line.
             out.push({
                 name: '/' + c.name,
@@ -619,7 +619,7 @@ async function expandSlashTarget(workdir, name, rest) {
         const commands = await loadCommands(workdir);
         const cmd = commands.find((c) => c.name.toLowerCase() === name.toLowerCase());
         if (cmd) {
-            // B7: refuse to run when declared positional arguments are missing.
+            // Refuse to run when declared positional arguments are missing.
             const missing = mod.commands.missingCommandArgs(cmd.arguments, rest);
             if (missing.length)
                 return { missing };
@@ -1410,7 +1410,7 @@ async function main() {
     let reviewMode = null;
     process.on('SIGINT', async () => {
         running = false;
-        // Kill any background processes (N33) so no dev-server outlives the agent.
+        // Kill any background processes so no dev-server outlives the agent.
         killAllBackground();
         await browser.close().catch(() => { });
         // Close the lazy headless browser from web.js, otherwise it would stay
@@ -1468,7 +1468,7 @@ async function main() {
     // swap. Assigned where the editor is built (see the login wiring below);
     // a no-op until then so /provider before setup is harmless.
     let wireLoginCallbacks = () => { };
-    // N37 statusLine hook timer (cleared on exit).
+    // statusLine hook timer (cleared on exit).
     let statusLineTimer = null;
     let waiter = null;
     const takeInput = () => {
@@ -1619,7 +1619,7 @@ async function main() {
             };
         };
         wireLoginCallbacks(browser);
-        // N37 statusLine hook: run the configured command on its own timer (never
+        // statusLine hook: run the configured command on its own timer (never
         // per-render — a spawn would block typing) and show its first stdout line
         // in the status line. Off when ui.statusLineCommand is empty.
         if (config.ui.statusLineCommand) {
@@ -4065,7 +4065,7 @@ async function main() {
                 }
             }
         }
-        // B7: a custom command with mandatory `arguments:` refuses to run until the
+        // A custom command with mandatory `arguments:` refuses to run until the
         // operator supplies them (by position).
         if (missingArgs) {
             console.error(theme.error(t('msg.missing_args', { v: missingArgs.join(', ') })));
@@ -4081,7 +4081,7 @@ async function main() {
             : expandedTask !== null
                 ? expandedTask
                 : trimmed;
-        // B5: inline any `@path` references into the task so the agent does not
+        // Inline any `@path` references into the task so the agent does not
         // spend a round-trip reading a file the operator already pointed at. Only
         // existing files are inlined; a bare `@name` in prose is left untouched.
         let finalTaskText = taskText;

package/dist/input.js

@@ -173,7 +173,7 @@ export class LineEditor {
     // A callback the editor calls before every render to read the agent's
     // current task-list summary ("tasks: 2/5"), empty when there is no list.
     onTasksQuery;
-    // Extra status text produced by an external command (N37 statusLine hook).
+    // Extra status text produced by an external command (the statusLine hook).
     // Set via setStatusLine(); shown before the queue/tasks badges. Kept as a
     // plain field because the CALLER runs the command on its own timer (a
     // per-render spawn would block typing).
@@ -361,7 +361,7 @@ export class LineEditor {
             return '';
         }
     }
-    // The statusLine hook text (N37), shown before the queue/tasks badges.
+    // The statusLine hook text, shown before the queue/tasks badges.
     // A trailing space separates it from whatever follows; empty hides it.
     _statusLineBadge() {
         return this.statusLine ? theme.system(this.statusLine) + ' ' : '';
@@ -605,7 +605,7 @@ export class LineEditor {
     }
     // Update the context window size (from config.ui.contextLimit). The next
     // render recomputes the percentage and its color with the new limit.
-    // Set the statusLine hook text (N37). The caller runs the command on its
+    // Set the statusLine hook text. The caller runs the command on its
     // own timer; this only stores + repaints. An empty string hides the badge.
     setStatusLine(text) {
         const t = String(text || '').trim();

package/dist/run-task.js

@@ -5,7 +5,7 @@ import { formatCompactTokens, pasteReplacement, expandPastes } from './input.js'
 import { DEFAULT_LOCALE } from './i18n.js';
 import { providerAskDeadlineMs } from './config.js';
 // Ask the operator to approve a tool call flagged by an `ask` permission rule
-// (C1). While the LineEditor owns the terminal it must be paused first, or the
+// While the LineEditor owns the terminal it must be paused first, or the
 // confirmation prompt and the input line fight for the same keys. A non-TTY run
 // has no way to answer, so it DENIES (never silently allows a guarded call).
 export async function askOperatorConfirm(editor, question, t, 
@@ -332,7 +332,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
         // Set when the loop ends without a real answer (iteration limit / watchdog)
         // so the one-shot mode can exit non-zero. See N5.
         let failure = null;
-        // N31: the machine-readable reason for the last task's outcome.
+        // The machine-readable reason for the last task's outcome.
         let outcomeKind = 'ok';
         // How many auto-continue turns a completion goal has already spent.
         let goalTurns = 0;
@@ -389,7 +389,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
                 },
                 onWarning: (msg) => ui.warning(msg),
                 onAskPermission: async (info) => {
-                    // C1: a rule with action "ask". Show the reason and wait for the
+                    // A rule with action "ask". Show the reason and wait for the
                     // operator. In non-TTY this denies.
                     ui.warning(t('perm.ask', { tool: info.tool, reason: info.reason }));
                     const ok = await askOperatorConfirm(editor || null, t('perm.confirm'), t, locale);
@@ -440,7 +440,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
                         }
                     }
                     : onAskUser,
-                // N38: the check command appended to a tool result after an edit
+                // The check command appended to a tool result after an edit
                 // (off by default; config.diagnostics).
                 diagnostics: deps.config.diagnostics,
             });
@@ -452,7 +452,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
                 ui.warning(outcome);
                 transcript?.log('agent_no_answer', { outcome });
                 failure = outcome;
-                // N31: a machine-readable reason so `--output-format jsonl` consumers
+                // A machine-readable reason so `--output-format jsonl` consumers
                 // (CI) can tell a real error from an exhausted limit / watchdog.
                 outcomeKind = outcome.startsWith('Iteration limit reached')
                     ? 'iteration_limit'
@@ -570,7 +570,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
                 sendSystemPrompt: false,
             };
         }
-        // Stop hook (N32): the whole task (including drained queue messages) is
+        // Stop hook: the whole task (including drained queue messages) is
         // done. A cleanup/notification hook runs here. Best-effort.
         try {
             // LOAD the config: `undefined` here made every Stop hook a no-op — the
@@ -584,7 +584,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
                 ui.warning(out);
         }
         catch { }
-        // N31: a single terminal event carrying the reason, so a jsonl consumer
+        // A single terminal event carrying the reason, so a jsonl consumer
         // does not have to guess from the exit code alone.
         transcript?.log('task_result', {
             ok: !failure,

package/dist/statusline.js

@@ -1,5 +1,5 @@
 import { spawn } from 'node:child_process';
-// N37 statusLine hook. When `ui.statusLineCommand` is set, zames runs it on a
+// statusLine hook. When `ui.statusLineCommand` is set, zames runs it on a
 // timer with a JSON status object on stdin and shows the FIRST line of its
 // stdout in the status line (like Claude Code). The command is deliberately
 // run OUT of the render path: a per-render spawn would block typing, so the

package/dist/subagent.js

@@ -178,7 +178,7 @@ export function createSubagentRunner(opts) {
             browser.onSendState = savedHooks.onSendState;
             browser.onNotice = savedHooks.onNotice;
         }
-        // SubagentStop hook (N32): fires after the nested loop finishes, so a hook
+        // SubagentStop hook: fires after the nested loop finishes, so a hook
         // can clean up or notify. Best-effort; its stdout is appended to the report.
         let hookOut = '';
         try {

package/dist/tools.js

@@ -104,7 +104,7 @@ export function createTools(workdir, { undo, todos, readOnly = false, subagents
             },
             fn: async ({ path: p, offset, limit, numbered }) => {
                 const file = safe(req(p, 'path'));
-                // Binary guard (N35): reading an image/archive as utf-8 produced
+                // Binary guard: reading an image/archive as utf-8 produced
                 // mojibake the model tried to reason about. Detect a binary buffer
                 // BEFORE decoding and answer with useful metadata instead.
                 // A read FAILURE (a missing file, a directory, EACCES) is answered in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.82.136",
+  "version": "2.82.137",
   "description": "Terminal coding agent that drives a real browser to chat with DeepSeek, Qwen and other web LLMs — no API key required. Reads and edits files, runs commands, commits to git, like Claude Code / Codex CLI.",
   "type": "module",
   "bin": {