zames_pro 2.75.5 → 2.75.6

package/dist/system-prompt.js

@@ -21,11 +21,56 @@ Rules for that note:
 - this is the ONE exception to "do not touch unrelated files". If nothing
   worth noting, add nothing.
 `;
+// The skills DISCIPLINE, appended to the `## Skills` section (and mirrored in
+// the section above it): the model must CHECK the list before a non-trivial
+// task and READ a matching skill's body, instead of only seeing a static list.
+// This is the zames equivalent of superpowers' `using-superpowers` bootstrap —
+// no SessionStart hook needed, the text simply lives in the system prompt. Kept
+// narrow ("when relevant", not "always") so the model does not burn iterations
+// Reading SKILL.md files for a trivial edit.
+const SKILLS_DISCIPLINE = `
+Before starting a NON-TRIVIAL task (a new feature, a bug hunt, a multi-file
+change), scan the list above for a matching skill and, if one applies, Read
+its \`file:\` path FIRST — the body is the workflow you must follow. Skip this
+for a trivial edit or a single read: the scan must never cost more than the
+task itself. If a skill looks relevant but you are unsure, reading it is
+cheap; guessing is not.
+`;
 // Guidance for the `Task` tool (subagents), injected only when that tool is in
 // the model's set. Without it the model under-uses subagents (it does every
 // broad search itself and floods the main context) or misuses them (delegates
 // work that needs THIS conversation's history, which the isolated subagent
 // cannot see). Kept short: it competes with the tool list for space.
+// Guidance for the `AskUser` tool, injected only when that tool is offered.
+// Without it the model either never asks (and silently guesses) or asks about
+// things it could verify itself. Kept short and biased toward NOT asking.
+const ASKUSER_SECTION = `
+## AskUser tool (asking the operator)
+
+AskUser shows the operator a MODAL multi-choice question: a short list of
+options, one of them marked recommended, plus an "other" escape where they can
+type free text. It BLOCKS the run until answered and costs the operator a
+context switch, so use it SPARINGLY — only when the decision is genuinely
+ambiguous AND you cannot proceed safely by choosing a sensible default.
+
+Ask when:
+- the request has two or more materially different interpretations and the
+  wrong one wastes real work (e.g. "delete the feature" — code only, or code
+  plus its tests and docs?);
+- a destructive/irreversible action needs a decision you cannot derive from
+  the repo (which remote, which branch to force-push);
+- the operator explicitly asked you to check before deciding.
+
+Do NOT ask when:
+- you can read the answer from the code, the config or the git history;
+- one option is clearly right — pick it and state the assumption in your
+  final answer instead;
+- the task is trivial or already precise.
+
+Keep 2–4 options, put the RECOMMENDED one FIRST and mark it, and give each a
+one-line consequence ("X — because …"). The question text says WHY you are
+asking and what you will do with the answer.
+`;
 const SUBAGENT_SECTION = `
 ## Task tool (subagents)
 
@@ -126,7 +171,8 @@ export function renderContextSection(context) {
             '\n## Skills\n\n' +
                 'Specialized workflows. A skill with a `file:` is a SKILL.md on disk (read it when it applies); a `(built-in)` skill has no file — the operator can invoke it with /<name> and its instructions arrive as the task. Skills are progressive disclosure: only read the body when the skill applies.\n\n' +
                 lines.join('\n') +
-                '\n';
+                '\n' +
+                SKILLS_DISCIPLINE;
     }
     if (context.commands.length) {
         const lines = context.commands.map((c) => '- /' + c.name + ': ' + (c.description || '(no description)'));
@@ -158,6 +204,10 @@ export function buildSystemPrompt({ workdir, tools, gitContext = null, locale =
     const subagentSection = tools.some((x) => x.name === 'Task')
         ? SUBAGENT_SECTION
         : '';
+    // Same idea for AskUser: guidance only when the tool is in the set.
+    const askUserSection = tools.some((x) => x.name === 'AskUser')
+        ? ASKUSER_SECTION
+        : '';
     const gitSection = gitContext
         ? `\n## Git context\n\n${gitContext}\n`
         : '\n## Git context\n\nNot a git repository (or git is not installed).\n';
@@ -261,7 +311,7 @@ Rules for a batch:
 - Typical wins: read all the files a task mentions at once; grep for all the
   symbols you need at once; after planning a multi-file change, write all the
   files you can write independently at once.
-${subagentSection}
+${subagentSection}${askUserSection}
 ## MCP tools
 
 Some tools are provided by external MCP servers and their names look

package/dist/tools.js

@@ -303,6 +303,33 @@ export function createTools(workdir, { undo, todos, readOnly = false, subagents
         },
         fn: async () => 'Subagents are not available in this run. Do the work yourself.',
     };
+    // The AskUser seam: a MODAL question to the operator (multi-choice with a
+    // recommended option and a free-text escape). Like `Task`, it is handled by
+    // the CALLER (onAskUser), not by `fn` — the live path intercepts the name in
+    // agent-loop. `fn` only answers a direct unit-test call. It is not offered in
+    // plan/read-only mode (a plan must not interrupt).
+    const askUserTool = {
+        name: 'AskUser',
+        description: 'Ask the operator a question with a short list of OPTIONS when a decision ' +
+            'is genuinely ambiguous and you cannot proceed safely without it. One ' +
+            'option may be marked recommended (the model puts it FIRST and sets ' +
+            '`recommended` to its index/label). The operator can also pick "other" ' +
+            'and type free text. Use it SPARINGLY: prefer a reasonable default and ' +
+            'state it in your final answer — a question costs the operator a ' +
+            'context switch and blocks the run until answered. Do NOT ask for ' +
+            'confirmation of something you can verify yourself (read the file, run ' +
+            'the test). Returns the chosen option label, or the typed text, or an ' +
+            'empty answer when the operator dismissed the dialog.',
+        parameters: {
+            question: 'string',
+            options: 'array',
+            recommended: 'number?',
+            allow_text: 'boolean?',
+        },
+        fn: async ({ question }) => 'AskUser is not available in this run (no interactive UI). Proceed with ' +
+            'your best judgement and state the assumption. Question was: ' +
+            String(question ?? ''),
+    };
     // In plan (read-only) mode `Task` is dropped too: a `general` subagent could
     // otherwise write through it and defeat the read-only promise.
     const all = [
@@ -311,6 +338,7 @@ export function createTools(workdir, { undo, todos, readOnly = false, subagents
         ...gitTools,
         ...webTools,
         ...(subagents && !readOnly ? [taskTool] : []),
+        ...(readOnly ? [] : [askUserTool]),
         respondTool,
     ];
     return readOnly ? filterToolsForReadOnly(all) : all;
@@ -330,6 +358,11 @@ export const MUTATING_TOOLS = new Set([
     'GitAdd',
     'GitCommit',
     'GitPush',
+    // AskUser is NOT mutating (it touches no file), but plan mode exists to
+    // PRODUCE a plan with no side effects and no interruptions; a modal question
+    // mid-plan is exactly what plan mode must not do. Dropped in read-only mode
+    // so the model records the open question as a plan note instead.
+    'AskUser',
 ]);
 /** Drop mutating tools for read-only / plan mode. Pure; unit-tested. */
 export function filterToolsForReadOnly(tools) {

package/dist/tui/AskQuestion.js

@@ -0,0 +1,108 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// A modal QUESTION with CHOICES for the model's `AskUser` tool.
+//
+// The operator sees the model's question and a short list of options; one may
+// be marked as the model's recommendation and is highlighted. The operator can
+// ALWAYS answer in their own words via a last "other" row, so imperfect
+// options never block the run. Esc dismisses the question (the model is then
+// told to pick a default and continue).
+//
+// Visual language matches SelectList / ConfirmDialog (rounded border, title,
+// hint bar); it is a separate component because the free-text escape needs an
+// inline one-line editor, which SelectList does not have.
+import { useState } from 'react';
+import { Box, Text, useInput, useApp, useWindowSize } from 'ink';
+import { UI, HintBar } from './widgets.js';
+import { translate } from '../i18n.js';
+export function AskQuestion({ question, options, recommended, allowText, locale = 'ru', onResult, }) {
+    const { exit } = useApp();
+    const { columns } = useWindowSize();
+    const t = translate(locale);
+    const innerCols = Math.max(10, (columns || 80) - 6);
+    const otherLabel = t('askuser.other');
+    const rows = allowText ? [...options, otherLabel] : options;
+    const [cursor, setCursor] = useState(recommended !== null && recommended >= 0 && recommended < options.length
+        ? recommended
+        : 0);
+    const [typing, setTyping] = useState(false);
+    const [text, setText] = useState('');
+    const finish = (v) => {
+        onResult(v);
+        exit();
+    };
+    useInput((input, key) => {
+        if (key.escape || (key.ctrl && input === 'c')) {
+            finish(null);
+            return;
+        }
+        if (typing) {
+            if (key.return) {
+                const v = text.trim();
+                finish(v || null);
+                return;
+            }
+            if (key.backspace || key.delete) {
+                setText((s) => Array.from(s).slice(0, -1).join(''));
+                return;
+            }
+            if (input && input >= ' ')
+                setText((s) => s + input);
+            return;
+        }
+        if (key.upArrow || input === 'k') {
+            setCursor((c) => (rows.length ? (c - 1 + rows.length) % rows.length : 0));
+            return;
+        }
+        if (key.downArrow || input === 'j') {
+            setCursor((c) => (rows.length ? (c + 1) % rows.length : 0));
+            return;
+        }
+        if (key.return) {
+            if (allowText && cursor === options.length) {
+                setTyping(true);
+                return;
+            }
+            finish(rows[cursor] ?? null);
+            return;
+        }
+        // A printable char on the "other" row opens the editor immediately.
+        if (allowText && cursor === options.length && input && input >= ' ') {
+            setTyping(true);
+            setText(input);
+        }
+    });
+    // Word-wrap the question to the inner width (Ink wraps Text too, but a
+    // wrapped box row is not counted by the layout, so wrap it here).
+    const wrap = (s) => {
+        const words = String(s).split(/\s+/);
+        const out = [];
+        let line = '';
+        for (const w of words) {
+            const cand = line ? line + ' ' + w : w;
+            if (cand.length > innerCols && line) {
+                out.push(line);
+                line = w;
+            }
+            else {
+                line = cand;
+            }
+        }
+        if (line)
+            out.push(line);
+        return out.length ? out : [''];
+    };
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: UI.accent, paddingX: 2, children: [_jsx(Text, { color: UI.title, bold: true, children: '◆ ' + t('askuser.title') }), wrap(question).map((line, i) => (_jsx(Text, { color: UI.text, children: line }, i))), _jsx(Text, { color: "#3a3f4b", children: '─'.repeat(innerCols) }), typing ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: UI.dim, children: t('askuser.your_answer') }), _jsxs(Text, { color: UI.accent, children: ['❯ ', text, '▏'] })] })) : (rows.map((label, i) => {
+                const sel = i === cursor;
+                const isRec = i === recommended;
+                return (_jsxs(Text, { children: [_jsx(Text, { color: UI.accent, children: sel ? '❯ ' : '  ' }), _jsx(Text, { color: sel ? UI.accent : undefined, bold: sel, children: label }), isRec ? (_jsx(Text, { color: "#6fd0b0", children: '  (' + t('askuser.recommended') + ')' })) : null] }, i));
+            })), _jsx(HintBar, { hints: typing
+                    ? [
+                        ['Enter', t('askuser.hint_send')],
+                        ['Esc', t('askuser.hint_cancel')],
+                    ]
+                    : [
+                        ['↑/↓', t('askuser.hint_select')],
+                        ['Enter', t('askuser.hint_ok')],
+                        ['Esc', t('askuser.hint_dismiss')],
+                    ] })] }));
+}

package/dist/tui/FullScreenApp.js

@@ -113,6 +113,7 @@ export function FullScreenApp({ store, inputProps, }) {
     }, state.mouseScroll);
     return (_jsxs(Box, { flexDirection: "column", height: termRows, children: [_jsx(Header, { store: store }), _jsx(Box, { flexDirection: "column", height: logHeight, overflow: "hidden", justifyContent: "flex-end", children: all.length === 0 ? (_jsx(Text, { color: "#5b616e", children: translate(state.locale)('editor.empty_hint') })) : (_jsx(LogList, { entries: visible })) }), _jsx(StatusBar, { state: state, divider: false }), _jsx(InputLine, { ...inputProps, store: store, 
                 // Cursor rows above the input box: header + log viewport + status.
-                cursorTop: HEADER_ROWS + logHeight + suggestRows + STATUS_ROWS + 1, prompt: state.prompt, locale: state.locale, commands: state.commands, locked: state.locked }), _jsx(Text, { color: "#5b616e", wrap: "truncate", children: ' ' + translate(state.locale)('editor.keys_hint') })] }));
+                cursorTop: HEADER_ROWS + logHeight + suggestRows + STATUS_ROWS + 1, prompt: state.prompt, locale: state.locale, commands: state.commands, locked: state.locked }), _jsx(Text, { color: "#5b616e", wrap: "truncate", children: ' ' +
+                    translate(state.locale)(state.mouseScroll ? 'editor.keys_hint' : 'editor.keys_hint_select') })] }));
 }
 void contentWidth;

package/dist/tui/InputLine.js

@@ -213,9 +213,6 @@ export function InputLine(props) {
             case 'clipboard':
                 void tryClipboard();
                 return;
-            case 'copyCode':
-                props.onCopyCode();
-                return;
             default:
                 return;
         }

package/dist/tui/StatusBar.js

@@ -37,10 +37,6 @@ export function badgeTextWidth(state) {
         w += visLen('[' + state.provider + '] ');
     if (state.queueLength > 0)
         w += visLen('⧗' + state.queueLength + ' ');
-    if (state.codeBlocks.length > 0) {
-        const idx = state.codeFocus >= 0 ? state.codeFocus + 1 : state.codeBlocks.length;
-        w += visLen('⌘ ' + idx + '/' + state.codeBlocks.length + ' ');
-    }
     if (state.tasks)
         w += visLen(state.tasks) + 1;
     const toggles = [];
@@ -80,11 +76,6 @@ function Badges({ state, budget = Infinity, }) {
     if (state.queueLength > 0) {
         add('q', visLen('⧗' + state.queueLength + ' '), _jsxs(Text, { color: "#c9a86a", children: ['⧗' + state.queueLength, ' '] }, "q"));
     }
-    if (state.codeBlocks.length > 0) {
-        const idx = state.codeFocus >= 0 ? state.codeFocus + 1 : state.codeBlocks.length;
-        const label = '⌘ ' + idx + '/' + state.codeBlocks.length + ' ';
-        add('code', visLen(label), _jsx(Text, { color: "#7fc4f0", children: label }, "code"));
-    }
     if (state.tasks) {
         add('t', visLen(state.tasks) + 1, _jsxs(Text, { color: "#808896", children: [state.tasks, ' '] }, "t"));
     }

package/dist/tui/TuiEditor.js

@@ -26,7 +26,6 @@ import { contentWidth } from '../width.js';
 import { theme } from '../theme.js';
 import { renderMarkdown } from '../markdown.js';
 import { summarizeToolCall, looksLikeToolError } from '../tool-summary.js';
-import { extractCodeBlocks } from '../code-blocks.js';
 import { randomThinkingPhrase, stripEllipsis } from '../spinner.js';
 export class TuiEditor {
     store = new TuiStore();
@@ -42,9 +41,6 @@ export class TuiEditor {
     onTasksQuery = null;
     onContextQuery = null;
     onToggleQuery = null;
-    /** Copy text to the OS clipboard. Wired to writeClipboardText in index.ts;
-     *  returns { ok, via } so the editor can report the outcome. */
-    onCopyText = null;
     busy = false;
     locked = false;
     history = [];
@@ -98,7 +94,6 @@ export class TuiEditor {
             onSubmit: (text, atts) => this.handleSubmit(text, atts),
             onEscape: () => this.onEscape?.(),
             onCtrlC: () => this.onCtrlC?.(),
-            onCopyCode: () => this.copyCode(),
             onAttach: (raw) => this.onAttach?.(raw) ?? null,
             onClipboard: () => this.onClipboard?.() ?? Promise.resolve(null),
             onHistoryChange: (h) => {
@@ -472,44 +467,6 @@ export class TuiEditor {
         this.printAbove('\n' + theme.assistant(translate(this.locale)('editor.answer')));
         this.printAbove(rendered);
         this.printAbove('\n');
-        // Remember the answer's code blocks so the operator can copy one by hotkey
-        // (a terminal has no copy buttons). Extraction is on the RAW markdown —
-        // the rendered text is full of ANSI and must never be copied.
-        const blocks = extractCodeBlocks(msg);
-        this.store.set({ codeBlocks: blocks, codeFocus: -1 });
-        if (blocks.length)
-            this.refreshBadges();
-    }
-    /** Copy the focused code block (or the LAST when none is focused). */
-    copyCode(index) {
-        const snap = this.store.getSnapshot();
-        const blocks = snap.codeBlocks;
-        if (!blocks.length) {
-            this.printAbove(theme.dim(translate(this.locale)('copy.no_code')));
-            return false;
-        }
-        const pick = typeof index === 'number'
-            ? (blocks.find((b) => b.index === index) ?? null)
-            : snap.codeFocus >= 0
-                ? (blocks[snap.codeFocus] ?? null)
-                : blocks[blocks.length - 1];
-        if (!pick) {
-            this.printAbove(theme.warn(translate(this.locale)('copy.bad_index', { n: String(index) })));
-            return false;
-        }
-        const res = this.onCopyText?.(pick.text) ?? { ok: false, via: 'none' };
-        const label = 'code #' + pick.index + (pick.lang ? ' (' + pick.lang + ')' : '');
-        if (res.ok) {
-            this.printAbove(theme.assistant(translate(this.locale)('copy.done', { tool: res.via }) +
-                ' — ' +
-                label));
-        }
-        else {
-            this.printAbove(theme.warn(translate(this.locale)('copy.failed', { tool: res.via }) +
-                ' — ' +
-                label));
-        }
-        return res.ok;
     }
     warning(msg) {
         const wrapped = wrapToWidth('⚠ ' + msg, contentWidth());

package/dist/tui/keys.js

@@ -127,8 +127,6 @@ export function dispatchKey(input, key, ctx, isVisualEdge) {
                 return { type: 'suggestPrev' };
             case 'v':
                 return { type: 'clipboard' };
-            case 'y':
-                return { type: 'copyCode' };
             case 'j':
                 return { type: 'newline' };
             default:

package/dist/tui/run-ask.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import { AskQuestion } from './AskQuestion.js';
+/**
+ * Show the modal question and resolve with the chosen option, the typed text,
+ * or null when dismissed / stdin is not a TTY.
+ */
+export async function askQuestionInk(opts) {
+    if (!(process.stdin.isTTY && process.stdout.isTTY))
+        return null;
+    return await new Promise((resolve) => {
+        let answered = false;
+        const app = render(_jsx(AskQuestion, { ...opts, onResult: (v) => {
+                answered = true;
+                resolve(v);
+            } }), { exitOnCtrlC: false });
+        app.waitUntilExit().then(() => {
+            if (!answered)
+                resolve(null);
+        });
+    });
+}

package/dist/tui/store.js

@@ -44,8 +44,6 @@ function initialState() {
         thinkingEnabled: false,
         searchEnabled: false,
         statusLine: '',
-        codeBlocks: [],
-        codeFocus: -1,
         columns: process.stdout.columns || 80,
     };
 }

package/dist/tui/widgets.js

@@ -42,19 +42,13 @@ export function HintBar({ hints, }) {
     return (_jsx(Text, { children: hints.map(([k, l], i) => (_jsxs(Text, { children: [i > 0 ? _jsx(Text, { color: UI.dim, children: '  ·  ' }) : null, _jsx(Text, { color: UI.accent, children: k }), _jsx(Text, { color: UI.dim, children: ' ' + l })] }, i))) }));
 }
 /**
- * A CODE BLOCK with a syntax-highlighted body and a copy affordance.
+ * A CODE BLOCK with a syntax-highlighted body and an optional title label.
  *
  * The agent's answers are printed as pre-rendered ANSI (markdown.ts already
  * highlights with cli-highlight), so the live log does NOT use this component —
  * it exists for menus/panels that show a snippet inline (and for a future
- * structured log). Copying is a KEY, not a button: a terminal has no pointer.
- * Pass `onCopy` and show `hint` so the operator learns the binding.
+ * structured log).
  */
-export function CodeBlock({ code, lang, highlighted, width, hint, focused, onCopy, }) {
-    // React cannot call `onCopy` from a keydown here (Ink has no per-element
-    // focus ring by default); the caller wires the key and passes `focused` to
-    // show which block it will copy. `onCopy` is kept so a future focus manager
-    // can invoke it without changing the call sites.
-    void onCopy;
+export function CodeBlock({ code, lang, highlighted, width, hint, focused, }) {
     return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: focused ? UI.accent : UI.border, paddingX: 1, width: width, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Text, { color: UI.dim, children: lang || 'code' }), hint ? _jsx(Text, { color: UI.accent, children: hint }) : null] }), (highlighted || code).split(String.fromCharCode(10)).map((line, i) => (_jsx(Text, { children: line || ' ' }, i)))] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.75.5",
+  "version": "2.75.6",
   "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": {
@@ -8,7 +8,7 @@
   },
   "files": [
     "dist",
-    "scripts",
+    "scripts/postinstall.mjs",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",

package/scripts/build-readme.mts

@@ -1,101 +0,0 @@
-// Assemble README.md from the two language sources.
-//
-// Why: npm renders exactly ONE readme per package (README.md in the root) and
-// has no language tabs. npm renders the readme with GitHub Flavored Markdown
-// (via GitHub's API), so a <details> block DOES work there -- and on GitHub
-// too. We keep the English text on top and fold the Russian translation into
-// a collapsible block at the bottom. The language switcher is an in-page
-// `#readme-ru` anchor, so one README.md serves both languages -- there is
-// no separate README.ru.md anymore (it was invisible on npm and just
-// duplicated the folded block).
-//
-// The two sources (docs/readme.en.md, docs/readme.ru.md) are the single point
-// of edit for each language; this script wires the switcher and the collapsible
-// cross-language block so neither language has to be maintained by hand. The
-// generated file is committed; test/readme-built.test.ts re-runs buildReadmes()
-// and fails if it drifts from the sources.
-//
-// Usage:  npom run build:readme
-
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const NL = String.fromCharCode(10)
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-export const SWITCHER = '<!-- SWITCHER -->'
-
-// In-page anchor the switcher links to. GitHub strips `id` on some elements but
-// keeps `name` on an <a>, so both are set.
-export const RU_ANCHOR = '<a id="readme-ru" name="readme-ru"></a>'
-
-const EN_SWITCH = [
-  '<p align="center">',
-  '  <strong>English</strong> | <a href="#readme-ru">Русский</a>',
-  '</p>',
-].join(NL)
-
-export function readSource(
-  rootDir: string,
-  name: string,
-): { head: string; body: string } {
-  const file = path.join(rootDir, 'docs', name)
-  const text = fs.readFileSync(file, 'utf-8')
-  const i = text.indexOf(SWITCHER)
-  if (i < 0) {
-    throw new Error(
-      file + ' has no ' + SWITCHER + ' marker (was it edited by hand?)',
-    )
-  }
-  return {
-    // Everything above the marker: logo, title, badges.
-    head: text.slice(0, i).replace(/\n+$/, ''),
-    // Everything below: the actual documentation.
-    body: text
-      .slice(i + SWITCHER.length)
-      .replace(/^\n+/, '')
-      .replace(/\n+$/, ''),
-  }
-}
-
-function details(summary: string, body: string): string {
-  return [
-    '<details>',
-    '<summary>' + summary + '</summary>',
-    '',
-    body,
-    '',
-    '</details>',
-  ].join(NL)
-}
-
-// Returns the generated README.md WITHOUT touching the disk, so a test can
-// compare it against the committed file. Only README.md is generated: the
-// Russian translation lives inside it as a <details> block, and the switcher
-// is an in-page `#readme-ru` anchor.
-export function buildReadmes(rootDir: string): { readmeEn: string } {
-  const en = readSource(rootDir, 'readme.en.md')
-  const ru = readSource(rootDir, 'readme.ru.md')
-  const readmeEn = [
-    en.head,
-    '',
-    EN_SWITCH,
-    '',
-    en.body,
-    '',
-    RU_ANCHOR,
-    details('🇷🇺 Читать по-русски (Russian)', ru.body),
-    '',
-  ].join(NL)
-  return { readmeEn }
-}
-
-// Run only when invoked directly (not when imported by a test).
-const invoked =
-  process.argv[1] &&
-  path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)
-if (invoked) {
-  const { readmeEn } = buildReadmes(root)
-  fs.writeFileSync(path.join(root, 'README.md'), readmeEn)
-  console.log('build-readme: wrote README.md')
-}

package/scripts/changelog-draft.mts

@@ -1,93 +0,0 @@
-import { spawnSync } from 'node:child_process'
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import {
-  parseConventionalCommit,
-  groupCommits,
-  renderChangelogDraft,
-  syncUnreleased,
-} from '../src/changelog.js'
-
-// Draft a CHANGELOG section from conventional commits since a ref (BACKLOG
-// D2). PRINTS to stdout and never touches CHANGELOG.md -- the operator (or
-// the agent) pastes the result in by hand, so a bad commit subject can never
-// corrupt the changelog.
-//
-// Usage:
-//   npm run changelog:draft            # since the latest tag, or an explicit ref
-//   npm run changelog:draft -- v2.63.0
-//   npm run changelog:draft -- --write  # update the Unreleased section in place
-//   npm run changelog:draft -- --check  # exit 1 if Unreleased is out of date
-
-function git(args: string[]): string {
-  const r = spawnSync('git', args, { encoding: 'utf-8' })
-  if (r.status !== 0) return ''
-  return (r.stdout || '').toString()
-}
-
-const argv = process.argv.slice(2)
-const write = argv.includes('--write')
-const check = argv.includes('--check')
-const argRef = argv.find((a) => !a.startsWith('-'))
-
-// Resolve the start ref: an explicit arg, otherwise the latest tag,
-// otherwise the root commit.
-const latestTag = git(['describe', '--tags', '--abbrev=0']).trim()
-const ref =
-  argRef ||
-  latestTag ||
-  git(['revlist', 'HEAD']).trim().split('\n').pop() ||
-  'HEAD'
-
-const subjects = git([
-  'log',
-  '--no-merges',
-  '--pretty=format:%s',
-  `${ref}..HEAD`,
-])
-  .split('\n')
-  .map((s) => s.trim())
-  .filter(Boolean)
-
-const parsed = subjects
-  .map(parseConventionalCommit)
-  .filter((c): c is NonNullable<typeof c> => c !== null)
-const body = renderChangelogDraft(groupCommits(parsed))
-
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-const changelogPath = path.join(root, 'CHANGELOG.md')
-
-// D2: sync the `## [Unreleased]` section in CHANGELOG.md from the conventional
-// commits since the last tag. `--write` edits the file; `--check` fails when
-// the committed section is out of date (for CI); neither just prints the body.
-if (write || check) {
-  const onDisk = fs.readFileSync(changelogPath, 'utf-8')
-  const nextText = syncUnreleased(onDisk, body)
-  if (write) {
-    if (nextText !== onDisk) {
-      fs.writeFileSync(changelogPath, nextText)
-      console.log('changelog: updated the Unreleased section')
-    } else {
-      console.log('changelog: Unreleased already up to date')
-    }
-    process.exit(0)
-  }
-  if (nextText !== onDisk) {
-    console.error(
-      'changelog: the Unreleased section is out of date — run `npm run changelog:sync`',
-    )
-    process.exit(1)
-  }
-  console.log('changelog: Unreleased is up to date')
-  process.exit(0)
-}
-
-if (!body) {
-  console.error('no conventional commits since ' + ref)
-  process.exit(0)
-}
-
-console.log('## [Unreleased]')
-console.log('')
-console.log(body)

package/scripts/clean-dist.mts

@@ -1,17 +0,0 @@
-import { rmSync, existsSync } from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-// tsc emits into dist/ without clearing it, so a source file DELETED from
-// src/ leaves an orphan .js in the published tree (this really happened:
-// dist/confirm.js survived after src/confirm.ts was removed). Wipe dist/ first
-// so the build output mirrors src/ exactly.
-//
-// Cross-platform: use node's fs.rm instead of a shell `rm -rf` (Windows has no
-// rm) and never touch anything outside this repo.
-const here = path.dirname(fileURLToPath(import.meta.url))
-const dist = path.resolve(here, '..', 'dist')
-if (existsSync(dist)) {
-  rmSync(dist, { recursive: true, force: true })
-  console.log('clean-dist: removed', dist)
-}