zames_pro 2.72.3 → 2.72.5

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.72.5] - 2026-10-09
+
+### Changed
+
+- **input:** extract the pure slash-command suggestion logic into input/suggest.ts (C3)
+
+### Changed
+
+- **input:** extract the pure slash-command suggestion logic into input/suggest.ts (C3)
+
+## [2.72.4] - 2026-10-09
+
+### Changed
+
+- **index:** extract the pure /config rendering into config-commands.ts (C3)
+
+### Changed
+
+- **index:** extract the pure /config rendering into config-commands.ts (C3)
+
 ## [2.72.3] - 2026-10-09
 
 ### Changed

package/dist/config-commands.js

@@ -0,0 +1,75 @@
+// PURE rendering for the /config command's TEXT output (BACKLOG C3). These
+// helpers format the schema into lines; they touch no browser/terminal state,
+// so they are unit-tested without a live agent (the /config dispatch in
+// index.ts only prints what these return). The interactive menu lives in
+// config-menu.ts; the value read/write policy lives in config.ts.
+import { theme } from './theme.js';
+/**
+ * The value shown for a field in the LIST: the default marker, on/off for a
+ * boolean, a fixed mask for a password, otherwise the JSON form. Mirrors the
+ * long-used inline logic so the output is byte-for-byte identical.
+ */
+export function configListValue(field, value, t) {
+    if (value === undefined)
+        return t('cfg.menu.default');
+    if (typeof value === 'boolean')
+        return value ? t('common.on') : t('common.off');
+    if (/password/i.test(field.path) && String(value).length > 0)
+        return '********';
+    return JSON.stringify(value);
+}
+/**
+ * The value shown for `/config get <path>`: the default marker, a fixed mask
+ * for a password, otherwise the JSON form. Note this deliberately does NOT
+ * special-case booleans (the get subcommand has always printed true/false).
+ */
+export function configGetValue(path, value, t) {
+    if (value === undefined)
+        return t('cfg.menu.default');
+    if (/password/i.test(path) && String(value).length > 0)
+        return '********';
+    return JSON.stringify(value);
+}
+/**
+ * Human-readable hint of the accepted values for a field, used in the error
+ * message when /config set gets a bad value. Enum -> the allowed list,
+ * number -> a range, boolean -> "true|false".
+ */
+export function configValueHint(field, t) {
+    if (field.values && field.values.length)
+        return field.values.join('|');
+    if (field.type === 'boolean')
+        return 'true|false';
+    if (field.type === 'number') {
+        const lo = field.min !== undefined ? String(field.min) : '-';
+        const hi = field.max !== undefined ? String(field.max) : '-';
+        return t('cfg.range_hint', { min: lo, max: hi });
+    }
+    return field.type;
+}
+/**
+ * Render the full settings LIST as an array of lines (grouped by section).
+ * `get` reads the current value of a path (undefined = default). Returned as
+ * lines so index.ts only has to print them and the formatting is testable.
+ */
+export function formatConfigList(fields, get, t) {
+    const out = [theme.system(t('cfg.title'))];
+    let lastGroup = '';
+    for (const f of fields) {
+        const g = t(f.groupKey);
+        if (g !== lastGroup) {
+            out.push(theme.system('\n  ' + g));
+            lastGroup = g;
+        }
+        const shown = configListValue(f, get(f.path), t);
+        const extra = f.values ? '  [' + f.values.join('|') + ']' : '';
+        out.push('    ' +
+            theme.user(f.path) +
+            theme.dim(' = ') +
+            theme.assistant(shown) +
+            theme.dim(extra) +
+            theme.dim('   # ' + t(f.labelKey)));
+    }
+    out.push(theme.dim('\n' + t('cfg.usage')));
+    return out;
+}

package/dist/index.js

@@ -16,6 +16,7 @@ import { promptOnce } from './prompt.js';
 import { parseImagePaste, extForMime, saveToTemp, guessMime, formatSize, readClipboardImageDetailed, sniffMime, readWindowsClipboardFiles, hasClipboardTool, writeClipboardText, contentHash, } from './attachments.js';
 import { loadConfig, DEFAULTS, CONFIG_PATHS, ZAMES_HOME, CONFIG_SCHEMA, getByPath, validateConfigValue, writeConfigValue, resetConfigValue, } from './config.js';
 import { runConfigMenu } from './config-menu.js';
+import { configGetValue, configValueHint, formatConfigList, } from './config-commands.js';
 import { translate, normalizeLocale, localeDisplayName, isLocale, } from './i18n.js';
 import { Transcript } from './transcript.js';
 import { UndoStore } from './undo.js';
@@ -1528,55 +1529,16 @@ async function main() {
     // Human-readable hint of the accepted values for a field, used in the error
     // message when /config set gets a bad value. Enum -> the allowed list,
     // number -> a range, boolean -> "true|false".
-    function configValueHint(field) {
-        if (field.values && field.values.length)
-            return field.values.join('|');
-        if (field.type === 'boolean')
-            return 'true|false';
-        if (field.type === 'number') {
-            const lo = field.min !== undefined ? String(field.min) : '-';
-            const hi = field.max !== undefined ? String(field.max) : '-';
-            return t('cfg.range_hint', { min: lo, max: hi });
-        }
-        return field.type;
-    }
     function configResetField(field) {
         resetConfigValue('home', field.path);
         // Reset the runtime value to the default.
         const def = getByPath(DEFAULTS, field.path);
         setConfigRuntime(field.path, def);
     }
-    function configLabel(field) {
-        return t(field.labelKey);
-    }
     function configShowList() {
-        console.log(theme.system(t('cfg.title')));
-        let lastGroup = '';
-        for (const f of CONFIG_SCHEMA) {
-            const g = t(f.groupKey);
-            if (g !== lastGroup) {
-                console.log(theme.system('\n  ' + g));
-                lastGroup = g;
-            }
-            const cur = getByPath(config, f.path);
-            const shown = cur === undefined
-                ? t('cfg.menu.default')
-                : typeof cur === 'boolean'
-                    ? cur
-                        ? t('common.on')
-                        : t('common.off')
-                    : /password/i.test(f.path) && String(cur).length > 0
-                        ? '********'
-                        : JSON.stringify(cur);
-            const extra = f.values ? '  [' + f.values.join('|') + ']' : '';
-            console.log('    ' +
-                theme.user(f.path) +
-                theme.dim(' = ') +
-                theme.assistant(shown) +
-                theme.dim(extra) +
-                theme.dim('   # ' + configLabel(f)));
-        }
-        console.log(theme.dim('\n' + t('cfg.usage')));
+        for (const line of formatConfigList(CONFIG_SCHEMA, (p) => getByPath(config, p), t)) {
+            console.log(line);
+        }
     }
     async function configOpenMenu() {
         if (!(process.stdin.isTTY && process.stdout.isTTY)) {
@@ -1657,14 +1619,7 @@ async function main() {
                 return;
             }
             const cur = getByPath(config, key);
-            console.log(theme.system(t('cfg.value', {
-                v: key,
-                value: cur === undefined
-                    ? t('cfg.menu.default')
-                    : /password/i.test(key) && String(cur).length > 0
-                        ? '********'
-                        : JSON.stringify(cur),
-            })));
+            console.log(theme.system(t('cfg.value', { v: key, value: configGetValue(key, cur, t) })));
             return;
         }
         if (sub === 'set') {
@@ -1685,7 +1640,7 @@ async function main() {
             catch {
                 console.error(theme.error(t('cfg.bad_value', {
                     v: key,
-                    type: configValueHint(field),
+                    type: configValueHint(field, t),
                 })));
                 return;
             }

package/dist/input/suggest.js

@@ -0,0 +1,81 @@
+// PURE slash-command suggestion logic — the match / paging / completion half
+// of the LineEditor's «/» hint list (src/input.ts). No terminal access and no
+// editor state: given the buffer text and the command list these decide which
+// commands to show, the visible window, and the Tab completion. Split out
+// (C3) so the fuzzy match can be unit-tested without driving the editor.
+import { SUGGEST_PAGE, isSubsequence } from './layout.js';
+/**
+ * The commands matching the current buffer. Shown only when the line starts
+ * with «/» and is a single short word. The match is fuzzy: an exact prefix
+ * first, then a substring, then a subsequence (e.g. "hst" -> "/history"), so
+ * a half-remembered command name still surfaces. Order is preserved.
+ */
+export function matchSlashCommands(buf, commands) {
+    const b = buf;
+    if (!b.startsWith('/'))
+        return [];
+    if (b.includes(String.fromCharCode(10)) || b.includes(' '))
+        return [];
+    if (b.length > 40)
+        return [];
+    const q = b.toLowerCase();
+    if (q === '/')
+        return commands;
+    // Match on the part AFTER the leading slash: comparing the raw query (which
+    // itself starts with '/') against the full name made the fuzzy subsequence
+    // match fire on the slash alone (e.g. "/x" matched "/self-fix").
+    const body = q.slice(1);
+    const prefix = [];
+    const substring = [];
+    const fuzzy = [];
+    // A single character only matches by PREFIX: a one-letter substring /
+    // subsequence match is far too loose ("x" would pull in "/self-fix").
+    const loose = body.length >= 2;
+    for (const c of commands) {
+        const name = c.name.toLowerCase().slice(1);
+        if (name.startsWith(body))
+            prefix.push(c);
+        else if (loose && name.includes(body))
+            substring.push(c);
+        else if (loose && isSubsequence(body, name))
+            fuzzy.push(c);
+    }
+    return prefix.concat(substring, fuzzy);
+}
+/**
+ * The visible slice of the suggestion list for a given scroll offset. Returns
+ * the shown commands, the CLAMPED offset and how many rows the block takes
+ * (the page plus an optional "more" line). Pure — the caller renders the rows.
+ */
+export function suggestWindow(sugg, offset) {
+    if (!sugg.length)
+        return { shown: [], off: 0, moreCount: 0 };
+    const pageSize = SUGGEST_PAGE;
+    const maxOffset = Math.max(0, sugg.length - pageSize);
+    const off = Math.max(0, Math.min(offset, maxOffset));
+    const shown = sugg.slice(off, off + pageSize);
+    const moreCount = sugg.length > pageSize ? sugg.length - shown.length : 0;
+    return { shown, off, moreCount };
+}
+/**
+ * Tab completion. With an explicit selection, insert that command. With a
+ * single match, insert it whole. Otherwise complete up to the longest common
+ * prefix of the matches. Returns the new buffer, or null when nothing should
+ * change.
+ */
+export function completeSlashCommand(buf, sugg, selected) {
+    if (!sugg.length)
+        return null;
+    if (selected >= 0 && selected < sugg.length) {
+        return sugg[selected].name + ' ';
+    }
+    if (sugg.length === 1)
+        return sugg[0].name + ' ';
+    let prefix = sugg[0].name;
+    for (const c of sugg) {
+        while (!c.name.toLowerCase().startsWith(prefix.toLowerCase())) {
+            prefix = prefix.slice(0, -1);
+        }
+    }
+    return prefix.length > buf.length ? prefix : null;
+}

package/dist/input.js

@@ -4,12 +4,15 @@ import { contentWidth } from './width.js';
 import { randomThinkingPhrase, stripEllipsis, DOTS, renderDots, } from './spinner.js';
 import { translate } from './i18n.js';
 import { AttachmentStore, parseImagePaste, looksLikeFilePath, } from './attachments.js';
-import { NL, CR, ESC, PASTE_START, PASTE_END, SUGGEST_PAGE, isSubsequence, pasteReplacement, expandPastes, safeJson, visRows, visLen, charWidth, layoutInput, formatTokenStatus, tokenStatusLevel, truncateToWidth, wrapToWidth, CONTEXT_LIMIT, } from './input/layout.js';
+import { NL, CR, ESC, PASTE_START, PASTE_END, SUGGEST_PAGE, pasteReplacement, expandPastes, safeJson, visRows, visLen, charWidth, layoutInput, formatTokenStatus, tokenStatusLevel, truncateToWidth, wrapToWidth, CONTEXT_LIMIT, } from './input/layout.js';
 // The pure layout/formatting helpers (visual rows, cursor position, visible
 // width, paste markers, token formatting) live in ./input/layout.js. They are
 // re-exported here so every existing import from './input.js' keeps working,
 // and so tests can import them from either module (C3 step 3).
 export { PASTE_MIN_LINES, SUGGEST_PAGE, isSubsequence, countPasteLines, formatPasteMarker, pasteReplacement, expandPastes, visRows, visLen, charWidth, layoutInput, tokenStatusLevel, formatTokenStatus, formatCompactTokens, truncateToWidth, wrapToWidth, CONTEXT_LIMIT, CONTEXT_YELLOW_PCT, CONTEXT_RED_PCT, } from './input/layout.js';
+// PURE slash-command suggestion logic (match / paging / completion), split out
+// of the class so the fuzzy match is unit-tested without driving the editor.
+import { matchSlashCommands, suggestWindow, completeSlashCommand, } from './input/suggest.js';
 // How long a lone ESC is held before it is treated as the Escape key (and not
 // as the head of a control sequence split across two reads). 40ms is below a
 // human "two Escapes" interval but above typical chunk-split latency.
@@ -388,37 +391,7 @@ export class LineEditor {
     // first, then a substring, then a subsequence (e.g. "hst" -> "/history"),
     // so a half-remembered command name still surfaces. Order is preserved.
     _suggestions() {
-        const b = this.buf;
-        if (!b.startsWith('/'))
-            return [];
-        if (b.includes(NL) || b.includes(' '))
-            return [];
-        if (b.length > 40)
-            return [];
-        const q = b.toLowerCase();
-        if (q === '/')
-            return this.slashCommands;
-        // Match on the part AFTER the leading slash: comparing the raw query
-        // (which itself starts with '/') against the full name made the fuzzy
-        // subsequence match fire on the slash alone (e.g. "/x" matched
-        // "/self-fix"), so a stray letter pulled in unrelated commands.
-        const body = q.slice(1);
-        const prefix = [];
-        const substring = [];
-        const fuzzy = [];
-        // A single character only matches by PREFIX: a one-letter substring /
-        // subsequence match is far too loose ("x" would pull in "/self-fix").
-        const loose = body.length >= 2;
-        for (const c of this.slashCommands) {
-            const name = c.name.toLowerCase().slice(1);
-            if (name.startsWith(body))
-                prefix.push(c);
-            else if (loose && name.includes(body))
-                substring.push(c);
-            else if (loose && isSubsequence(body, name))
-                fuzzy.push(c);
-        }
-        return prefix.concat(substring, fuzzy);
+        return matchSlashCommands(this.buf, this.slashCommands);
     }
     // Render the suggestion block for the current query. `offset` scrolls the
     // window so Ctrl+N/P can page through more than the visible size (the list
@@ -436,10 +409,7 @@ export class LineEditor {
         }
         if (!sugg.length)
             return { lines: [], rows: 0 };
-        const pageSize = SUGGEST_PAGE;
-        const maxOffset = Math.max(0, sugg.length - pageSize);
-        const off = Math.max(0, Math.min(offset, maxOffset));
-        const shown = sugg.slice(off, off + pageSize);
+        const { shown, off, moreCount } = suggestWindow(sugg, offset);
         this._suggestOffset = off;
         this._suggestCount = sugg.length;
         const label = (c) => c.hint ? c.name + ' ' + c.hint : c.name;
@@ -450,12 +420,10 @@ export class LineEditor {
             const desc = theme.dim('  ' + c.description);
             return (selected ? theme.prompt(' ▸ ') : '   ') + name + desc;
         });
-        if (sugg.length > pageSize) {
+        if (moreCount > 0) {
             const t = translate(this.locale);
             lines.push(theme.dim('   ' +
-                t('editor.more', {
-                    n: String(sugg.length - shown.length),
-                }) +
+                t('editor.more', { n: String(moreCount) }) +
                 '  ' +
                 t('editor.page_hint')));
         }
@@ -497,27 +465,9 @@ export class LineEditor {
     // Tab: complete the command up to the common prefix; if there is a single
     // match — insert it whole and add a space.
     _completeCommand() {
-        const sugg = this._suggestions();
-        if (!sugg.length)
-            return;
-        if (this._suggestSelected >= 0 && this._suggestSelected < sugg.length) {
-            this.buf = sugg[this._suggestSelected].name + ' ';
-            this.cursor = Array.from(this.buf).length;
-            return;
-        }
-        if (sugg.length === 1) {
-            this.buf = sugg[0].name + ' ';
-            this.cursor = Array.from(this.buf).length;
-            return;
-        }
-        let prefix = sugg[0].name;
-        for (const c of sugg) {
-            while (!c.name.toLowerCase().startsWith(prefix.toLowerCase())) {
-                prefix = prefix.slice(0, -1);
-            }
-        }
-        if (prefix.length > this.buf.length) {
-            this.buf = prefix;
+        const next = completeSlashCommand(this.buf, this._suggestions(), this._suggestSelected);
+        if (next !== null) {
+            this.buf = next;
             this.cursor = Array.from(this.buf).length;
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.72.3",
+  "version": "2.72.5",
   "description": "Terminal coding agent that drives chat.deepseek.com through Playwright — no API key required. Reads and edits files, runs commands, commits to git, like Claude Code / Codex CLI.",
   "type": "module",
   "bin": {