@aragon-agent/cli 0.6.35 → 0.6.37

package/dist/proc/limits.js

@@ -79,6 +79,22 @@ export const PROC_LIMITS = {
     outputCoalesceMs: 100,
     /** `SIGTERM` -> `SIGKILL` escalation window for a graceful stop. */
     stopGraceMs: 3000,
+    /**
+     * How long to KEEP ASKING whether the `SIGKILL` actually landed before
+     * declaring the job `stopped`.
+     *
+     * THIS NUMBER IS NOT A GUESS ABOUT THE PLATFORM. `killTree` spawns `taskkill`,
+     * which is a process of its own: a Windows tree kill of a shell plus its node
+     * child measures ~0.8 s on the reference machine (while starting `cmd` costs
+     * 50 ms), so the fixed 250 ms this used to allow expired first and `stop()`
+     * reported `stopped` with the child still running - AC-18 caught exactly that.
+     * The wait stays BOUNDED against the opposite failure (a promise that never
+     * resolves); at this deadline the record keeps the honest `killIncomplete`
+     * flag instead.
+     */
+    killVerifyMs: 2000,
+    /** Liveness poll interval while waiting for a `SIGKILL` to land. */
+    killVerifyPollMs: 50,
     /** Below this many terminal columns the status chip degrades to `[N]`. */
     statusCompactCols: 92,
     // --- long-task-jobs: bounded waiting, progress, notices, log mirror --------

package/dist/proc/supervisor.d.ts

@@ -82,12 +82,31 @@ export declare class ProcSupervisor implements ProcSupervisorPort {
      *
      * `SIGTERM` FIRST, `SIGKILL` AFTER `stopGraceMs` — the graceful ladder, which
      * belongs here rather than in `reapSync` because this path has a live event
-     * loop to run it on. It then CHECKS `process.kill(pid, 0)` and records
+     * loop to run it on. It then POLLS `process.kill(pid, 0)` for the kill to land,
+     * waiting at most `killVerifyMs` so the promise always settles, and records
      * `killIncomplete` when the pid is still there (P2-6): an honest warning beats
      * a silent leak, and `killTree` cannot know on its own whether it worked.
      */
     stop(id: string): Promise<ServiceSnapshot[]>;
     private stopOne;
+    /**
+     * Wait for the `SIGKILL` to LAND before calling the job `stopped` (AC-18).
+     *
+     * THE WINDOW IS NOT THE PLATFORM'S TO PROMISE. This used to wait a fixed
+     * 250 ms and then settle whether or not the pid was still there - but the kill
+     * it waits for is a `taskkill` PROCESS, and a Windows tree kill measures
+     * ~0.8 s here (while starting `cmd` costs 50 ms). So `stop()` resolved while
+     * the child was still running: the card, the model and the snapshot all said
+     * `stopped` about a live server, which is the one claim this class exists to
+     * make honestly.
+     *
+     * The poll ASKS THE OS instead of assuming, and stops the moment the pid is
+     * gone or the child's own `exit` handler settles first (`finish` clears this
+     * timer). It stays BOUNDED anyway, because a promise that never resolves is
+     * the failure this feature was written to remove: at `killVerifyMs` we settle
+     * regardless and keep `killIncomplete`, the warning `bash_output` renders.
+     */
+    private settleAfterKill;
     /**
      * SYNCHRONOUS, TOTAL, IDEMPOTENT. The only entry point a signal hook,
      * `process.on('exit')` or `handleFatal` may call.

package/dist/proc/supervisor.js

@@ -301,7 +301,8 @@ export class ProcSupervisor {
      *
      * `SIGTERM` FIRST, `SIGKILL` AFTER `stopGraceMs` — the graceful ladder, which
      * belongs here rather than in `reapSync` because this path has a live event
-     * loop to run it on. It then CHECKS `process.kill(pid, 0)` and records
+     * loop to run it on. It then POLLS `process.kill(pid, 0)` for the kill to land,
+     * waiting at most `killVerifyMs` so the promise always settles, and records
      * `killIncomplete` when the pid is still there (P2-6): an honest warning beats
      * a silent leak, and `killTree` cannot know on its own whether it worked.
      */
@@ -335,19 +336,7 @@ export class ProcSupervisor {
                 if (isTerminalStatus(record.status))
                     return;
                 killTree(record.pid, 'SIGKILL');
-                // Give the SIGKILL one tick to land before declaring the outcome, then
-                // settle whether or not `exit` fired: a promise that never resolves is
-                // the failure this whole feature exists to remove.
-                const settle = setTimeout(() => {
-                    if (isTerminalStatus(record.status))
-                        return;
-                    record.status = 'stopped';
-                    record.endedAt = Date.now();
-                    if (isAlive(record.pid))
-                        record.killIncomplete = true;
-                    this.finish(entry, 'stopped');
-                }, 250);
-                settle.unref?.();
+                this.settleAfterKill(entry);
             }, PROC_LIMITS.stopGraceMs);
             entry.escalation.unref?.();
             // NO SECOND `'exit'` LISTENER HERE. The one `start()` registered already
@@ -356,6 +345,45 @@ export class ProcSupervisor {
             // reads as the thing deciding the status.
         });
     }
+    /**
+     * Wait for the `SIGKILL` to LAND before calling the job `stopped` (AC-18).
+     *
+     * THE WINDOW IS NOT THE PLATFORM'S TO PROMISE. This used to wait a fixed
+     * 250 ms and then settle whether or not the pid was still there - but the kill
+     * it waits for is a `taskkill` PROCESS, and a Windows tree kill measures
+     * ~0.8 s here (while starting `cmd` costs 50 ms). So `stop()` resolved while
+     * the child was still running: the card, the model and the snapshot all said
+     * `stopped` about a live server, which is the one claim this class exists to
+     * make honestly.
+     *
+     * The poll ASKS THE OS instead of assuming, and stops the moment the pid is
+     * gone or the child's own `exit` handler settles first (`finish` clears this
+     * timer). It stays BOUNDED anyway, because a promise that never resolves is
+     * the failure this feature was written to remove: at `killVerifyMs` we settle
+     * regardless and keep `killIncomplete`, the warning `bash_output` renders.
+     */
+    settleAfterKill(entry) {
+        const deadline = Date.now() + PROC_LIMITS.killVerifyMs;
+        const check = () => {
+            const { record } = entry;
+            // The child's own `exit` handler won the race and already settled this.
+            if (isTerminalStatus(record.status))
+                return;
+            const isGone = !isAlive(record.pid);
+            if (!isGone && Date.now() < deadline) {
+                entry.escalation = setTimeout(check, PROC_LIMITS.killVerifyPollMs);
+                entry.escalation.unref?.();
+                return;
+            }
+            record.status = 'stopped';
+            record.endedAt = Date.now();
+            if (!isGone)
+                record.killIncomplete = true;
+            this.finish(entry, 'stopped');
+        };
+        entry.escalation = setTimeout(check, PROC_LIMITS.killVerifyPollMs);
+        entry.escalation.unref?.();
+    }
     // -----------------------------------------------------------------------
     // Exit reaping (G5 / I-9)
     // -----------------------------------------------------------------------

package/dist/prompts/command.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `/prompts` and its subcommands (quick-prompt-library §4.3).
+ *
+ * ASCII ONLY - `src/prompts/**` is inside `glyphs.test.ts::inScope`. Every user-facing
+ * sentence comes from `copy.ts`.
+ *
+ * THE COMMAND DOES NOT REACH THE UI THROUGH A CLOSURE. `registerBuiltinCommands(registry)`
+ * receives only the registry, so there is no context in which to build a port (F-33).
+ * The capability therefore arrives on `CommandContext.prompts`, an OPTIONAL field -
+ * `CommandContext` is constructed by literal in dozens of fixtures, and a required
+ * field would break every one of them for a feature none of them is about (F-14).
+ *
+ * THREE THINGS COME FROM THE PORT, and nothing else does: opening the picker, opening
+ * the manager on a page, and resolving a reference against the LIVE snapshot. Every
+ * MUTATION goes through `store.ts` directly, because that module is the only write
+ * authority (I-6) and routing a write through a UI port would make the overlay a
+ * second one.
+ *
+ * `<n|title>` IS RESOLVED BY `resolvePromptRef`, never by "the first match". Titles may
+ * repeat, and `rm` has no recycle bin, so an ambiguous reference is a NAMED failure
+ * with candidates rather than a guess (D-22).
+ */
+import type { CommandContext, CommandRegistry } from '../commands/registry.js';
+import type { QuickPrompt } from './types.js';
+export declare function registerPromptCommands(registry: CommandRegistry): void;
+/** `1. title  [fav]  #tag  12 uses` - no body, ever (D-17). */
+export declare function promptListLine(prompt: QuickPrompt, at: number): string;
+/**
+ * The dispatcher.
+ *
+ * `enabled=false` is answered BEFORE any subcommand, and ANSWERED rather than ignored:
+ * the command stays registered precisely so this sentence can exist (D-19 / AC-30).
+ */
+export declare function runPromptCommand(ctx: CommandContext): Promise<void>;

package/dist/prompts/command.js

@@ -0,0 +1,237 @@
+/**
+ * `/prompts` and its subcommands (quick-prompt-library §4.3).
+ *
+ * ASCII ONLY - `src/prompts/**` is inside `glyphs.test.ts::inScope`. Every user-facing
+ * sentence comes from `copy.ts`.
+ *
+ * THE COMMAND DOES NOT REACH THE UI THROUGH A CLOSURE. `registerBuiltinCommands(registry)`
+ * receives only the registry, so there is no context in which to build a port (F-33).
+ * The capability therefore arrives on `CommandContext.prompts`, an OPTIONAL field -
+ * `CommandContext` is constructed by literal in dozens of fixtures, and a required
+ * field would break every one of them for a feature none of them is about (F-14).
+ *
+ * THREE THINGS COME FROM THE PORT, and nothing else does: opening the picker, opening
+ * the manager on a page, and resolving a reference against the LIVE snapshot. Every
+ * MUTATION goes through `store.ts` directly, because that module is the only write
+ * authority (I-6) and routing a write through a UI port would make the overlay a
+ * second one.
+ *
+ * `<n|title>` IS RESOLVED BY `resolvePromptRef`, never by "the first match". Titles may
+ * repeat, and `rm` has no recycle bin, so an ambiguous reference is a NAMED failure
+ * with candidates rather than a guess (D-22).
+ */
+import { PROMPT_DISABLED_COPY, PROMPT_HISTORY_REMINDER_COPY, PROMPT_LIST_EMPTY_COPY, PROMPT_SHOW_WARNING_COPY, PROMPT_UNKNOWN_SUBCOMMAND_COPY, PROMPT_UNAVAILABLE_COPY, promptAmbiguousCopy, promptDeletedCopy, promptErrorCopy, promptFavoriteCopy, promptInvalidSortCopy, promptListFooterCopy, promptMovedCopy, promptMoveRangeCopy, promptNotFoundCopy, promptRmConfirmCopy, promptSavedCopy, promptSortedCopy, } from './copy.js';
+import { promptIndexOf } from './resolve.js';
+import { createPrompt, deletePrompt, loadPromptLibrary, reorderPrompt, reorderPrompts, setPromptFavorite, sortPromptIds, } from './store.js';
+/**
+ * `/prompts sort <key>`.
+ *
+ * `name` is TITLE order - the word the user typed has to be the order they get - and the
+ * other two promote a picker view into the persistent manual order.
+ */
+const SORT_KEYS = {
+    name: 'name',
+    recent: 'recent',
+    favorite: 'favorite',
+};
+export function registerPromptCommands(registry) {
+    registry.register({
+        name: 'prompts',
+        description: 'Quick prompt library: pick, list, add, edit, remove, reorder',
+        run: (ctx) => runPromptCommand(ctx),
+    });
+}
+function report(ctx, result, success) {
+    if (result.ok) {
+        ctx.notify('info', success);
+        return;
+    }
+    ctx.notify('warn', promptErrorCopy(result.code));
+}
+/**
+ * `<n|title>` -> entry, or `null` after reporting why not.
+ *
+ * THE CANDIDATES ARE PRINTED on an ambiguous reference, indexed, and the command does
+ * not proceed: `/prompts rm` cannot be undone, so a refusal that costs one more
+ * command is strictly better than a deletion the user cannot identify afterwards.
+ */
+function resolveOrReport(ctx, ref) {
+    const resolution = ctx.prompts?.resolve(ref);
+    if (!resolution) {
+        ctx.notify('warn', PROMPT_UNAVAILABLE_COPY);
+        return null;
+    }
+    if (resolution.ok)
+        return resolution.prompt;
+    if (resolution.code === 'ambiguous') {
+        const candidates = resolution.candidates.map((prompt, at) => `${at + 1}) ${prompt.title}`);
+        ctx.notify('warn', promptAmbiguousCopy(ref, candidates));
+        return null;
+    }
+    ctx.notify('warn', promptNotFoundCopy(ref));
+    return null;
+}
+/** `1. title  [fav]  #tag  12 uses` - no body, ever (D-17). */
+export function promptListLine(prompt, at) {
+    const marks = [
+        prompt.favorite === true ? '[fav]' : '',
+        (prompt.tags ?? []).map((tag) => `#${tag}`).join(' '),
+        `${prompt.useCount} uses`,
+    ].filter((part) => part.length > 0).join('  ');
+    return `${at + 1}. ${prompt.title}  ${marks}`;
+}
+function runList(ctx, library) {
+    if (library.prompts.length === 0) {
+        ctx.notify('info', PROMPT_LIST_EMPTY_COPY);
+        return;
+    }
+    const lines = library.prompts.map((prompt, at) => promptListLine(prompt, at));
+    ctx.notify('info', `${lines.join('\n')}\n${promptListFooterCopy(library.prompts.length)}`);
+}
+function runShow(ctx, ref) {
+    const prompt = resolveOrReport(ctx, ref);
+    if (!prompt)
+        return;
+    // THE ONLY PATH THAT PUTS A BODY INTO THE TRANSCRIPT (D-17), and it says so first.
+    ctx.notify('info', PROMPT_SHOW_WARNING_COPY);
+    const tags = (prompt.tags ?? []).map((tag) => `#${tag}`).join(' ');
+    const header = [prompt.title, tags].filter((part) => part.length > 0).join('  ');
+    ctx.notify('info', `${header}\n${prompt.content}`);
+}
+/** `add <title> :: <body>`. Reached only when the user typed content on the line. */
+function runAddWithArgs(ctx, rest) {
+    const split = rest.split('::');
+    if (split.length < 2) {
+        // A `::`-less `add <something>` is ambiguous between a title and a body, and
+        // guessing wrong would store the wrong field. Point at the editor instead.
+        ctx.notify('warn', PROMPT_HISTORY_REMINDER_COPY);
+        return;
+    }
+    const title = (split[0] ?? '').trim();
+    const content = split.slice(1).join('::').trim();
+    report(ctx, createPrompt({ title, content }), promptSavedCopy(title));
+}
+function runRemove(ctx, rest, library) {
+    const confirmed = /(^|\s)--yes\s*$/.test(rest);
+    const ref = rest.replace(/(^|\s)--yes\s*$/, '').trim();
+    const prompt = resolveOrReport(ctx, ref);
+    if (!prompt)
+        return;
+    if (!confirmed) {
+        ctx.notify('warn', promptRmConfirmCopy(prompt.title, ref));
+        return;
+    }
+    if (promptIndexOf(library, prompt.id) < 0) {
+        ctx.notify('warn', promptNotFoundCopy(ref));
+        return;
+    }
+    report(ctx, deletePrompt(prompt.id), promptDeletedCopy(prompt.title));
+}
+/** `move <ref> <to>`: `to` is 1-based and must exist; an out-of-range move is refused. */
+function runMove(ctx, rest, library) {
+    const parts = rest.split(/\s+/).filter((part) => part.length > 0);
+    const prompt = resolveOrReport(ctx, parts[0] ?? '');
+    if (!prompt)
+        return;
+    const to = Number.parseInt(parts[1] ?? '', 10);
+    if (!Number.isFinite(to) || to < 1 || to > library.prompts.length) {
+        ctx.notify('warn', promptMoveRangeCopy(to, library.prompts.length));
+        return;
+    }
+    const from = promptIndexOf(library, prompt.id);
+    report(ctx, reorderPrompt(from, to - 1), promptMovedCopy(prompt.title, to));
+}
+function runSort(ctx, raw, library) {
+    const key = SORT_KEYS[raw.trim().toLowerCase()];
+    if (!key) {
+        ctx.notify('warn', promptInvalidSortCopy(raw.trim()));
+        return;
+    }
+    const ids = sortPromptIds(library, key);
+    const unchanged = ids.length === library.prompts.length
+        && ids.every((id, at) => id === library.prompts[at]?.id);
+    // A NO-OP IS NOT A WRITE. Reporting "sorted" after an unnecessary rewrite would
+    // also teach the user that asking twice costs a disk write.
+    if (unchanged) {
+        ctx.notify('info', promptSortedCopy(key));
+        return;
+    }
+    report(ctx, reorderPrompts(ids), promptSortedCopy(key));
+}
+/**
+ * The dispatcher.
+ *
+ * `enabled=false` is answered BEFORE any subcommand, and ANSWERED rather than ignored:
+ * the command stays registered precisely so this sentence can exist (D-19 / AC-30).
+ */
+export async function runPromptCommand(ctx) {
+    // `=== false`, not `!enabled`: a `CliConfig` built without the section (a fixture, an
+    // embedded host) must read as ENABLED, which is the documented default.
+    if (ctx.controller.getConfig().prompts?.enabled === false) {
+        ctx.notify('info', PROMPT_DISABLED_COPY);
+        return;
+    }
+    const port = ctx.prompts;
+    if (!port) {
+        ctx.notify('warn', PROMPT_UNAVAILABLE_COPY);
+        return;
+    }
+    const args = ctx.args.trim();
+    const space = args.search(/\s/);
+    const verb = (space === -1 ? args : args.slice(0, space)).toLowerCase();
+    const rest = space === -1 ? '' : args.slice(space + 1).trim();
+    const library = loadPromptLibrary();
+    if (verb.length === 0) {
+        port.openPicker();
+        return;
+    }
+    if (verb === 'manage') {
+        port.openManager({ kind: 'list' });
+        return;
+    }
+    if (verb === 'list') {
+        runList(ctx, library);
+        return;
+    }
+    if (verb === 'show') {
+        runShow(ctx, rest);
+        return;
+    }
+    if (verb === 'add') {
+        if (rest.length === 0) {
+            port.openManager({ kind: 'create' });
+            return;
+        }
+        runAddWithArgs(ctx, rest);
+        return;
+    }
+    if (verb === 'edit') {
+        const prompt = resolveOrReport(ctx, rest);
+        if (!prompt)
+            return;
+        const entry = { kind: 'edit', id: prompt.id };
+        port.openManager(entry);
+        return;
+    }
+    if (verb === 'rm' || verb === 'remove' || verb === 'delete') {
+        runRemove(ctx, rest, library);
+        return;
+    }
+    if (verb === 'favorite' || verb === 'fav') {
+        const prompt = resolveOrReport(ctx, rest);
+        if (!prompt)
+            return;
+        const next = prompt.favorite !== true;
+        report(ctx, setPromptFavorite(prompt.id, next), promptFavoriteCopy(prompt.title, next));
+        return;
+    }
+    if (verb === 'move') {
+        runMove(ctx, rest, library);
+        return;
+    }
+    if (verb === 'sort') {
+        runSort(ctx, rest, library);
+        return;
+    }
+    ctx.notify('warn', PROMPT_UNKNOWN_SUBCOMMAND_COPY);
+}

package/dist/prompts/copy.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Chinese copy for the quick-prompt library (quick-prompt-library section 9.10).
+ *
+ * ASCII ONLY ON DISK. Every string below is written as `\uXXXX` escapes, the way
+ * `ui/interaction-copy.ts` does it, because `src/prompts/**` and `src/ui/**` are
+ * both inside `glyphs.test.ts::inScope` and that scanner rejects any raw non-ASCII
+ * byte. The escapes are the point: the product speaks English in its chrome
+ * (labels, footers, the overlays' own vocabulary) and the sentences that explain a
+ * failure to THIS user are here, in one table, where a translator can find them
+ * and where the API surfaces that build them cannot drift from each other.
+ *
+ * WHY ONE TABLE AND NOT STRINGS AT THE CALL SITES: the same failure is reported by
+ * a toast, by a `/prompts` subcommand and by the editor's error row. Three copies
+ * of one sentence is three wordings waiting to happen.
+ */
+import type { PromptSortKey, PromptWriteError } from './types.js';
+/** `\u5df2\u586b\u5165\u300cx\u300d\uff088 \u884c\uff0c\u53ef\u7ee7\u7eed\u7f16\u8f91\uff09`. */
+export declare function promptFilledCopy(title: string, lines: number): string;
+/** `\u5df2\u63d2\u5165\u5230\u5149\u6807\u5904\uff0c\u539f\u5185\u5bb9\u4fdd\u7559\u3002` */
+export declare const PROMPT_INSERTED_COPY = "\u5DF2\u63D2\u5165\u5230\u5149\u6807\u5904\uFF0C\u539F\u5185\u5BB9\u4FDD\u7559\u3002";
+/** `\u5df2\u4fdd\u5b58\u300cx\u300d` */
+export declare function promptSavedCopy(title: string): string;
+/** `\u5df2\u5220\u9664\u300cx\u300d` */
+export declare function promptDeletedCopy(title: string): string;
+/** `\u5df2\u6536\u85cf\u300cx\u300d` / `\u5df2\u53d6\u6d88\u6536\u85cf\u300cx\u300d` */
+export declare function promptFavoriteCopy(title: string, favorite: boolean): string;
+/** `\u5df2\u628a\u300cx\u300d\u79fb\u52a8\u5230\u7b2c n \u4f4d\u3002` */
+export declare function promptMovedCopy(title: string, to: number): string;
+/** `\u5df2\u6309 name \u91cd\u6392\u5e76\u4fdd\u5b58\u3002` */
+export declare function promptSortedCopy(key: PromptSortKey): string;
+/** The kill switch's honest answer (D-19 / AC-30). */
+export declare const PROMPT_DISABLED_COPY = "\u63D0\u793A\u8BCD\u5E93\u5DF2\u5173\u95ED\uFF08prompts.enabled=false\uFF09\u3002";
+/** The port is absent - a test fixture or a build without the overlay. */
+export declare const PROMPT_UNAVAILABLE_COPY = "Prompt library is not available in this build.";
+/** `\u5e93\u6587\u4ef6\u635f\u574f\u2026\u4ee5\u7a7a\u5e93\u7ee7\u7eed` - the one-shot notice after a `.bak` repair (D-4). */
+export declare const PROMPT_CORRUPT_COPY = "\u5E93\u6587\u4EF6\u635F\u574F\u6216\u683C\u5F0F\u4E0D\u7B26\uFF0C\u5DF2\u5907\u4EFD\u4E3A quick-prompts.json.bak\uFF0C\u672C\u6B21\u4EE5\u7A7A\u5E93\u7EE7\u7EED\u3002";
+/** `\u5df2\u8df3\u8fc7 n \u6761\u65e0\u6cd5\u8bc6\u522b\u7684\u8bb0\u5f55\u3002` */
+export declare function promptSkippedCopy(count: number): string;
+/**
+ * `\u5df2\u5e94\u7528\uff0c\u4f46\u5199\u5165\u78c1\u76d8\u5931\u8d25\uff1b\u9000\u51fa\u540e\u53ef\u80fd\u4e22\u5931\u3002` (D-4: never roll back memory).
+ *
+ * ONE SENTENCE for `write_failed`, and it says BOTH halves: that the change is in effect
+ * and that it may not survive the process. A shorter "write failed" would read as
+ * "nothing happened", which is the one thing this path does not do.
+ */
+export declare const PROMPT_WRITE_FAILED_COPY = "\u5DF2\u5E94\u7528\uFF0C\u4F46\u5199\u5165\u78C1\u76D8\u5931\u8D25\uFF1B\u9000\u51FA\u540E\u53EF\u80FD\u4E22\u5931\u3002";
+/** `\u627e\u4e0d\u5230\u300cx\u300d\u5bf9\u5e94\u7684\u63d0\u793a\u8bcd\u3002` */
+export declare function promptNotFoundCopy(ref: string): string;
+/**
+ * `\u300cx\u300d\u5339\u914d n \u6761\uff0c\u8bf7\u7528\u5e8f\u53f7\uff1a\u2026` (D-22).
+ *
+ * THE CANDIDATES ARE THE WHOLE POINT of this message: without them the user knows
+ * only that their command failed, and the next thing they try is the same command.
+ */
+export declare function promptAmbiguousCopy(ref: string, candidates: readonly string[]): string;
+/** Printed above a body that is about to enter the transcript (D-17). */
+export declare const PROMPT_SHOW_WARNING_COPY = "\u4EE5\u4E0B\u6B63\u6587\u5C06\u8FDB\u5165\u4F1A\u8BDD\u8BB0\u5F55\uFF08/save \u4F1A\u5BFC\u51FA\u5B83\uFF09\u3002";
+/** `\u5c06\u5220\u9664\u300cx\u300d\u2026\u786e\u8ba4\u8bf7\u518d\u6267\u884c\u4e00\u6b21\uff1a/prompts rm x --yes` (D-13). */
+export declare function promptRmConfirmCopy(title: string, ref: string): string;
+/** `\u76ee\u6807\u4f4d\u7f6e n \u8d85\u51fa\u8303\u56f4\uff081-m\uff09\u3002` */
+export declare function promptMoveRangeCopy(to: number, max: number): string;
+/** `\u65e0\u6548\u7684\u6392\u5e8f\u65b9\u5f0f\u300cx\u300d\uff0c\u53ef\u7528 name / recent / favorite\u3002` */
+export declare function promptInvalidSortCopy(raw: string): string;
+/** `\u63d0\u793a\u8bcd\u5e93\u4e3a\u7a7a\uff0c\u7528 /prompts add \u65b0\u5efa\u4e00\u6761\u3002` */
+export declare const PROMPT_LIST_EMPTY_COPY = "\u63D0\u793A\u8BCD\u5E93\u4E3A\u7A7A\uFF0C\u7528 /prompts add \u65B0\u5EFA\u4E00\u6761\u3002";
+/** The reminder that a body typed on a command line lands in `prompt-history`. */
+export declare const PROMPT_HISTORY_REMINDER_COPY = "\u63D0\u793A\uFF1A\u5199\u5728\u547D\u4EE4\u884C\u91CC\u7684\u6B63\u6587\u4F1A\u8FDB\u5165 prompt-history\uFF1B\u63A8\u8350\u7528 /prompts add \u540E\u5728\u7F16\u8F91\u5668\u91CC\u8F93\u5165\u3002";
+/** `\u5df2\u5220\u9664\u300cx\u300d` is reused for the `--yes` path; this is the "nothing happened" half. */
+export declare const PROMPT_UNKNOWN_SUBCOMMAND_COPY = "\u672A\u77E5\u5B50\u547D\u4EE4\u3002\u53EF\u7528\uFF1Alist / show / add / edit / rm / move / favorite / sort / manage\u3002";
+/**
+ * The one-shot key-migration notice (D-20 / AC-32).
+ *
+ * `Ctrl+N` IS SPELLED OUT IN FULL, never `^N` (P1-7): `^N` is already this
+ * product's word for "transcript line offset" (the header's scroll chip and the
+ * help overlay's `^N` row), so the abbreviation would be a second meaning for the
+ * same glyph in the same product.
+ */
+export declare const PROMPT_KEY_NOTICE_COPY = "Ctrl+P \u73B0\u5728\u6253\u5F00\u63D0\u793A\u8BCD\u5E93\uFF1B\u5207\u6362 BUILD/PLAN \u8BF7\u7528 Shift+Tab \u6216 Ctrl+N\uFF08\u6216 /plan\uFF09\u3002";
+/** The library page's empty state (the list page draws this instead of nothing). */
+export declare const PROMPT_EMPTY_TITLE_COPY = "No prompts yet.";
+export declare const PROMPT_EMPTY_BODY_COPY = "Press a to create your first prompt.";
+/** `\uff08\u5171 n \u6761\uff09` suffix for `/prompts list`. */
+export declare function promptListFooterCopy(count: number): string;
+/**
+ * One sentence per stable error code (D-12). THE CODE IS THE CONTRACT; this table is
+ * the only place it becomes words, so the editor's title row, the list's toast and a
+ * command's refusal cannot describe the same failure three different ways.
+ */
+export declare function promptErrorCopy(code: PromptWriteError): string;

package/dist/prompts/copy.js

@@ -0,0 +1,131 @@
+/**
+ * Chinese copy for the quick-prompt library (quick-prompt-library section 9.10).
+ *
+ * ASCII ONLY ON DISK. Every string below is written as `\uXXXX` escapes, the way
+ * `ui/interaction-copy.ts` does it, because `src/prompts/**` and `src/ui/**` are
+ * both inside `glyphs.test.ts::inScope` and that scanner rejects any raw non-ASCII
+ * byte. The escapes are the point: the product speaks English in its chrome
+ * (labels, footers, the overlays' own vocabulary) and the sentences that explain a
+ * failure to THIS user are here, in one table, where a translator can find them
+ * and where the API surfaces that build them cannot drift from each other.
+ *
+ * WHY ONE TABLE AND NOT STRINGS AT THE CALL SITES: the same failure is reported by
+ * a toast, by a `/prompts` subcommand and by the editor's error row. Three copies
+ * of one sentence is three wordings waiting to happen.
+ */
+/** `\u5df2\u586b\u5165\u300cx\u300d\uff088 \u884c\uff0c\u53ef\u7ee7\u7eed\u7f16\u8f91\uff09`. */
+export function promptFilledCopy(title, lines) {
+    return `\u5df2\u586b\u5165\u300c${title}\u300d\uff08${lines} \u884c\uff0c\u53ef\u7ee7\u7eed\u7f16\u8f91\uff09`;
+}
+/** `\u5df2\u63d2\u5165\u5230\u5149\u6807\u5904\uff0c\u539f\u5185\u5bb9\u4fdd\u7559\u3002` */
+export const PROMPT_INSERTED_COPY = '\u5df2\u63d2\u5165\u5230\u5149\u6807\u5904\uff0c\u539f\u5185\u5bb9\u4fdd\u7559\u3002';
+/** `\u5df2\u4fdd\u5b58\u300cx\u300d` */
+export function promptSavedCopy(title) {
+    return `\u5df2\u4fdd\u5b58\u300c${title}\u300d`;
+}
+/** `\u5df2\u5220\u9664\u300cx\u300d` */
+export function promptDeletedCopy(title) {
+    return `\u5df2\u5220\u9664\u300c${title}\u300d`;
+}
+/** `\u5df2\u6536\u85cf\u300cx\u300d` / `\u5df2\u53d6\u6d88\u6536\u85cf\u300cx\u300d` */
+export function promptFavoriteCopy(title, favorite) {
+    return favorite
+        ? `\u5df2\u6536\u85cf\u300c${title}\u300d`
+        : `\u5df2\u53d6\u6d88\u6536\u85cf\u300c${title}\u300d`;
+}
+/** `\u5df2\u628a\u300cx\u300d\u79fb\u52a8\u5230\u7b2c n \u4f4d\u3002` */
+export function promptMovedCopy(title, to) {
+    return `\u5df2\u628a\u300c${title}\u300d\u79fb\u52a8\u5230\u7b2c ${to} \u4f4d\u3002`;
+}
+/** `\u5df2\u6309 name \u91cd\u6392\u5e76\u4fdd\u5b58\u3002` */
+export function promptSortedCopy(key) {
+    return `\u5df2\u6309 ${key} \u91cd\u6392\u5e76\u4fdd\u5b58\u3002`;
+}
+/** The kill switch's honest answer (D-19 / AC-30). */
+export const PROMPT_DISABLED_COPY = '\u63d0\u793a\u8bcd\u5e93\u5df2\u5173\u95ed\uff08prompts.enabled=false\uff09\u3002';
+/** The port is absent - a test fixture or a build without the overlay. */
+export const PROMPT_UNAVAILABLE_COPY = 'Prompt library is not available in this build.';
+/** `\u5e93\u6587\u4ef6\u635f\u574f\u2026\u4ee5\u7a7a\u5e93\u7ee7\u7eed` - the one-shot notice after a `.bak` repair (D-4). */
+export const PROMPT_CORRUPT_COPY = '\u5e93\u6587\u4ef6\u635f\u574f\u6216\u683c\u5f0f\u4e0d\u7b26\uff0c\u5df2\u5907\u4efd\u4e3a quick-prompts.json.bak\uff0c\u672c\u6b21\u4ee5\u7a7a\u5e93\u7ee7\u7eed\u3002';
+/** `\u5df2\u8df3\u8fc7 n \u6761\u65e0\u6cd5\u8bc6\u522b\u7684\u8bb0\u5f55\u3002` */
+export function promptSkippedCopy(count) {
+    return `\u5df2\u8df3\u8fc7 ${count} \u6761\u65e0\u6cd5\u8bc6\u522b\u7684\u8bb0\u5f55\u3002`;
+}
+/**
+ * `\u5df2\u5e94\u7528\uff0c\u4f46\u5199\u5165\u78c1\u76d8\u5931\u8d25\uff1b\u9000\u51fa\u540e\u53ef\u80fd\u4e22\u5931\u3002` (D-4: never roll back memory).
+ *
+ * ONE SENTENCE for `write_failed`, and it says BOTH halves: that the change is in effect
+ * and that it may not survive the process. A shorter "write failed" would read as
+ * "nothing happened", which is the one thing this path does not do.
+ */
+export const PROMPT_WRITE_FAILED_COPY = '\u5df2\u5e94\u7528\uff0c\u4f46\u5199\u5165\u78c1\u76d8\u5931\u8d25\uff1b\u9000\u51fa\u540e\u53ef\u80fd\u4e22\u5931\u3002';
+/** `\u627e\u4e0d\u5230\u300cx\u300d\u5bf9\u5e94\u7684\u63d0\u793a\u8bcd\u3002` */
+export function promptNotFoundCopy(ref) {
+    return `\u627e\u4e0d\u5230\u300c${ref}\u300d\u5bf9\u5e94\u7684\u63d0\u793a\u8bcd\u3002`;
+}
+/**
+ * `\u300cx\u300d\u5339\u914d n \u6761\uff0c\u8bf7\u7528\u5e8f\u53f7\uff1a\u2026` (D-22).
+ *
+ * THE CANDIDATES ARE THE WHOLE POINT of this message: without them the user knows
+ * only that their command failed, and the next thing they try is the same command.
+ */
+export function promptAmbiguousCopy(ref, candidates) {
+    const list = candidates.join('\u3001');
+    return `\u300c${ref}\u300d\u5339\u914d ${candidates.length} \u6761\uff0c\u8bf7\u7528\u5e8f\u53f7\uff1a${list}`;
+}
+/** Printed above a body that is about to enter the transcript (D-17). */
+export const PROMPT_SHOW_WARNING_COPY = '\u4ee5\u4e0b\u6b63\u6587\u5c06\u8fdb\u5165\u4f1a\u8bdd\u8bb0\u5f55\uff08/save \u4f1a\u5bfc\u51fa\u5b83\uff09\u3002';
+/** `\u5c06\u5220\u9664\u300cx\u300d\u2026\u786e\u8ba4\u8bf7\u518d\u6267\u884c\u4e00\u6b21\uff1a/prompts rm x --yes` (D-13). */
+export function promptRmConfirmCopy(title, ref) {
+    return `\u5c06\u5220\u9664\u300c${title}\u300d\u3002\u6b64\u64cd\u4f5c\u4e0d\u53ef\u64a4\u9500\uff1b\u786e\u8ba4\u8bf7\u518d\u6267\u884c\u4e00\u6b21\uff1a/prompts rm ${ref} --yes`;
+}
+/** `\u76ee\u6807\u4f4d\u7f6e n \u8d85\u51fa\u8303\u56f4\uff081-m\uff09\u3002` */
+export function promptMoveRangeCopy(to, max) {
+    return `\u76ee\u6807\u4f4d\u7f6e ${to} \u8d85\u51fa\u8303\u56f4\uff081-${max}\uff09\u3002`;
+}
+/** `\u65e0\u6548\u7684\u6392\u5e8f\u65b9\u5f0f\u300cx\u300d\uff0c\u53ef\u7528 name / recent / favorite\u3002` */
+export function promptInvalidSortCopy(raw) {
+    return `\u65e0\u6548\u7684\u6392\u5e8f\u65b9\u5f0f\u300c${raw}\u300d\uff0c\u53ef\u7528 name / recent / favorite\u3002`;
+}
+/** `\u63d0\u793a\u8bcd\u5e93\u4e3a\u7a7a\uff0c\u7528 /prompts add \u65b0\u5efa\u4e00\u6761\u3002` */
+export const PROMPT_LIST_EMPTY_COPY = '\u63d0\u793a\u8bcd\u5e93\u4e3a\u7a7a\uff0c\u7528 /prompts add \u65b0\u5efa\u4e00\u6761\u3002';
+/** The reminder that a body typed on a command line lands in `prompt-history`. */
+export const PROMPT_HISTORY_REMINDER_COPY = '\u63d0\u793a\uff1a\u5199\u5728\u547d\u4ee4\u884c\u91cc\u7684\u6b63\u6587\u4f1a\u8fdb\u5165 prompt-history\uff1b\u63a8\u8350\u7528 /prompts add \u540e\u5728\u7f16\u8f91\u5668\u91cc\u8f93\u5165\u3002';
+/** `\u5df2\u5220\u9664\u300cx\u300d` is reused for the `--yes` path; this is the "nothing happened" half. */
+export const PROMPT_UNKNOWN_SUBCOMMAND_COPY = '\u672a\u77e5\u5b50\u547d\u4ee4\u3002\u53ef\u7528\uff1alist / show / add / edit / rm / move / favorite / sort / manage\u3002';
+/**
+ * The one-shot key-migration notice (D-20 / AC-32).
+ *
+ * `Ctrl+N` IS SPELLED OUT IN FULL, never `^N` (P1-7): `^N` is already this
+ * product's word for "transcript line offset" (the header's scroll chip and the
+ * help overlay's `^N` row), so the abbreviation would be a second meaning for the
+ * same glyph in the same product.
+ */
+export const PROMPT_KEY_NOTICE_COPY = 'Ctrl+P \u73b0\u5728\u6253\u5f00\u63d0\u793a\u8bcd\u5e93\uff1b\u5207\u6362 BUILD/PLAN \u8bf7\u7528 Shift+Tab \u6216 Ctrl+N\uff08\u6216 /plan\uff09\u3002';
+/** The library page's empty state (the list page draws this instead of nothing). */
+export const PROMPT_EMPTY_TITLE_COPY = 'No prompts yet.';
+export const PROMPT_EMPTY_BODY_COPY = 'Press a to create your first prompt.';
+/** `\uff08\u5171 n \u6761\uff09` suffix for `/prompts list`. */
+export function promptListFooterCopy(count) {
+    return `\uff08\u5171 ${count} \u6761\uff09`;
+}
+/**
+ * One sentence per stable error code (D-12). THE CODE IS THE CONTRACT; this table is
+ * the only place it becomes words, so the editor's title row, the list's toast and a
+ * command's refusal cannot describe the same failure three different ways.
+ */
+export function promptErrorCopy(code) {
+    switch (code) {
+        case 'title_required': return '\u6807\u9898\u4e0d\u80fd\u4e3a\u7a7a';
+        case 'content_required': return '\u6b63\u6587\u4e0d\u80fd\u4e3a\u7a7a';
+        case 'title_too_long': return '\u6807\u9898\u8d85\u8fc7 80 \u5b57';
+        case 'content_too_long': return '\u6b63\u6587\u8d85\u8fc7 8000 \u5b57';
+        case 'description_too_long': return '\u63cf\u8ff0\u8d85\u8fc7 200 \u5b57';
+        case 'tag_too_long': return '\u6807\u7b7e\u8d85\u8fc7 24 \u5b57';
+        case 'too_many_tags': return '\u6807\u7b7e\u6700\u591a 6 \u4e2a';
+        case 'too_many_prompts': return '\u6700\u591a 200 \u6761\uff0c\u8bf7\u5148\u5220\u9664';
+        case 'not_found': return '\u627e\u4e0d\u5230\u8be5\u63d0\u793a\u8bcd';
+        case 'ambiguous': return '\u5339\u914d\u5230\u591a\u6761\uff0c\u8bf7\u7528\u5e8f\u53f7';
+        case 'write_failed': return PROMPT_WRITE_FAILED_COPY;
+    }
+}