@aragon-agent/cli 0.6.46 → 0.6.48

package/dist/proc/types.d.ts

@@ -1,263 +0,0 @@
-/**
- * Runtime shapes for the process supervisor (background-service-supervision §6).
- *
- * ASCII ONLY: `src/proc/**` is inside the glyph scanner's scope.
- *
- * `ProcEvent` is CLI-LOCAL and is deliberately NOT a member of core's
- * `AgentEvent` union, exactly as `TeamEvent` and `TodoEvent` are not: core
- * freezes its runtime export list (`public-api.test.ts`) and forbids host
- * coupling (`no-host-coupling.test.ts`), so a new event member would break the
- * first and teach core about a host shape it has no business defining.
- */
-import type { JobProgress, ProgressKind } from './progress.js';
-/**
- * WHICH KIND OF JOB A RECORD DESCRIBES (long-task-jobs §4.2, D-1).
- *
- *  - `service` never exits on its own and owes the caller a readiness signal;
- *  - `task` always exits and is `running` from the spawn.
- *
- * The distinction is not cosmetic. Before it existed, an explicitly backgrounded
- * `python train.py` sat in `starting` for `readyTimeoutMs` (60s) and `bash` told
- * the model "not ready yet - still coming up" about a job that was already
- * working - which is what pushed it into starting a second copy or giving up.
- */
-export type JobKind = 'service' | 'task';
-/**
- * The progress subset a SNAPSHOT carries: the rendered line and its shape.
- *
- * `source` and `rowIndex` stay on the record. They exist for tests and debugging
- * (which row won, and did it come from a `\r` carry), and a card or a tool result
- * that started depending on them would be depending on an implementation detail
- * of the extraction table.
- */
-export interface ServiceSnapshotProgress {
-    text: string;
-    kind: ProgressKind;
-}
-export type ServiceStatus = 
-/** Spawned, not yet ready, still alive. */
-'starting'
-/** A loopback URL was printed, or the hinted port answered. */
- | 'ready'
-/**
- * Alive past `readyTimeoutMs` with nothing to detect.
- *
- * A REAL STATUS, NOT A FALLBACK (D-4). `tsc --watch` and `nodemon` listen on
- * nothing; calling them `ready` would be a lie and leaving them `starting`
- * forever would be worse — and worse in a way that costs, because `starting`
- * is the one status that blocks the transcript's settled boundary.
- */
- | 'running'
-/** The process ended on its own. */
- | 'exited'
-/** Spawn itself failed. */
- | 'failed'
-/** We killed it (Ctrl+C, `bash_kill`, `/bg stop`, exit). */
- | 'stopped';
-/** A status from which nothing further will happen. */
-export declare function isTerminalStatus(status: ServiceStatus): boolean;
-export interface ServiceRecord {
-    /** `s1` (a service), `t3` (a task). Short because the model has to quote it back. */
-    id: string;
-    /**
-     * WHICH KIND OF JOB THIS IS (long-task-jobs §4.2, D-1).
-     *
-     * A `service` never exits on its own and owes the caller a readiness signal; a
-     * `task` always exits and is `running` from the spawn. The distinction is not
-     * cosmetic: before it existed, an explicitly backgrounded `python train.py` sat
-     * in `starting` for `readyTimeoutMs` (60s) and `bash` told the model "not ready
-     * yet - still coming up" about a job that was already working.
-     */
-    kind: JobKind;
-    /** The `bash` call that started it. */
-    toolCallId: string;
-    command: string;
-    cwd: string;
-    pid: number | undefined;
-    status: ServiceStatus;
-    startedAt: number;
-    readyAt?: number;
-    endedAt?: number;
-    exitCode: number | null;
-    signal: NodeJS.Signals | null;
-    url?: string;
-    port?: number;
-    detectedBy?: 'url' | 'probe';
-    /** The pre-flight probe already answered, so the port detector is disabled. */
-    portPreoccupied?: boolean;
-    /** Bounded, sanitised ring. */
-    rows: readonly string[];
-    /**
-     * MONOTONIC row cursor, for `bash_output({ since })` AND for the transcript's
-     * `entryRevision` term.
-     *
-     * NEVER `rows.length`: the ring evicts its oldest row while appending a new
-     * one, so the joined length can be identical across two different tails. That
-     * is verbatim the non-append mutation `virtual-window.ts::entryRevision`'s
-     * I-L3-1 comment forbids leaving out — a length term would go on matching
-     * while the card changed underneath it.
-     */
-    rowsSeen: number;
-    /** The ring has dropped at least one row. */
-    truncated: boolean;
-    /** A stop reported the pid still alive afterwards (R-2 / P2-6). */
-    killIncomplete?: boolean;
-    /**
-     * When output last arrived, updated on EVERY CHUNK rather than per completed
-     * row (long-task-jobs §4.5).
-     *
-     * THE DISTINCTION IS LOAD-BEARING: a `\r`-rewritten progress bar (every
-     * download tool there is) moves continuously while completing no row at all,
-     * so a "last completed row" clock would declare a healthy download stalled
-     * after `jobs.stallSeconds`.
-     */
-    lastOutputAt: number;
-    /** Latest extracted progress line, recomputed on the coalesced output tick. */
-    progress?: JobProgress;
-    /** Where the optional on-disk mirror is writing this job's full log. */
-    logPath?: string;
-}
-/**
- * The frozen, JSON-serialisable projection listeners receive.
- *
- * LISTENERS GET SNAPSHOTS, NEVER THE RECORD, so a render-side bug cannot mutate
- * supervisor state. `rows` carries only the last `PROC_LIMITS.cardTailRows`.
- *
- * `kind` AND `lastOutputAt` ARE REQUIRED ON PURPOSE (long-task-jobs RV-P1-8).
- * `snapshot()` is a hand-copied object literal, so a new optional field that is
- * forgotten there fails silently in five consumers at once. Required fields turn
- * that omission into a compile error instead.
- */
-export interface ServiceSnapshot {
-    id: string;
-    kind: JobKind;
-    toolCallId: string;
-    command: string;
-    cwd: string;
-    pid: number | undefined;
-    status: ServiceStatus;
-    startedAt: number;
-    readyAt?: number;
-    endedAt?: number;
-    exitCode: number | null;
-    signal: NodeJS.Signals | null;
-    url?: string;
-    port?: number;
-    detectedBy?: 'url' | 'probe';
-    portPreoccupied?: boolean;
-    rows: readonly string[];
-    rowsSeen: number;
-    truncated: boolean;
-    killIncomplete?: boolean;
-    lastOutputAt: number;
-    progress?: ServiceSnapshotProgress;
-    /**
-     * DERIVED, NOT STORED: `now - lastOutputAt > jobs.stallSeconds * 1000` on a
-     * job that has not ended.
-     *
-     * A stored flag would need a timer to flip it, and the whole point is that any
-     * render refreshes the judgement for free.
-     */
-    stalled?: boolean;
-    logPath?: string;
-}
-export type ProcEvent = {
-    type: 'started';
-    service: ServiceSnapshot;
-}
-/** Coalesced at `PROC_LIMITS.outputCoalesceMs` inside the supervisor. */
- | {
-    type: 'output';
-    service: ServiceSnapshot;
-} | {
-    type: 'ready';
-    service: ServiceSnapshot;
-} | {
-    type: 'exited';
-    service: ServiceSnapshot;
-} | {
-    type: 'stopped';
-    service: ServiceSnapshot;
-};
-export type ProcEventListener = (event: ProcEvent) => void;
-export interface ServiceStartRequest {
-    command: string;
-    cwd: string;
-    toolCallId: string;
-    /**
-     * Absent means `'service'`, which is what every pre-existing caller means and
-     * what keeps `start()` backward compatible without a second method.
-     */
-    kind?: JobKind;
-}
-export interface ServiceStartResult {
-    ok: boolean;
-    /** Present when `ok`. */
-    service?: ServiceSnapshot;
-    /** Present when not `ok` — already model-facing prose. */
-    error?: string;
-}
-/** What `bash_output({ service, since })` reads back. */
-export interface ServiceLogPage {
-    rows: readonly string[];
-    /** Cursor to pass as the next `since`. */
-    cursor: number;
-    /** Rows were evicted between `since` and what is returned. */
-    truncated: boolean;
-    /**
-     * The not-yet-terminated line among `rows` (empty when the last chunk ended
-     * with a newline).
-     *
-     * THE ONLY WAY TO TELL A REDRAWING PROGRESS BAR FROM A FINISHED ROW: `rows`
-     * always ends with the carry line when one exists, so `job_wait` uses this to
-     * keep an unchanged carriage-return-rewritten bar out of its incremental row
-     * budget (RV-P1-5). Optional so a test double - and `bash_output`, which does
-     * not care - can leave it out.
-     */
-    carryRow?: string;
-}
-/** What `job_wait` and the supervisor need from a log mirror; no filesystem here. */
-export interface JobLogMirrorPort {
-    open(jobId: string): void;
-    write(jobId: string, chunk: string): void;
-    pathOf(jobId: string): string | undefined;
-}
-/**
- * The port `bash`, the tools, the controller and `/bg` see.
- *
- * A PORT RATHER THAN THE CLASS so `tools/` keeps no import edge into `proc/`'s
- * implementation, which is the same discipline `ToolDeps` already follows for
- * the diff and live-output side channels.
- */
-export interface ProcSupervisorPort {
-    start(req: ServiceStartRequest): Promise<ServiceStartResult>;
-    get(id: string): ServiceSnapshot | undefined;
-    list(): ServiceSnapshot[];
-    /** `id`, or `'all'`. Resolves once every target is terminal or the grace ran out. */
-    stop(id: string): Promise<ServiceSnapshot[]>;
-    read(id: string, since?: number): ServiceLogPage | undefined;
-    subscribe(listener: ProcEventListener): () => void;
-    /**
-     * Track a FOREGROUND `bash` child so `forceStop()` can reach it.
-     *
-     * Returns a release function the tool calls from its own `settle`. One
-     * registry, two lifetimes: splitting foreground children and services into two
-     * registries is how a force-stop ends up killing the user's dev server, or how
-     * a quit leaves it running (I-4).
-     */
-    trackForeground(pid: number | undefined): () => void;
-    /** Hard-kill every tracked FOREGROUND child. Never touches services (I-4). */
-    killForeground(reason: 'force'): number;
-    /** Live services: `starting | ready | running`. */
-    liveCount(): number;
-    /**
-     * SYNCHRONOUS, TOTAL reaper — the only thing a signal hook,
-     * `process.on('exit')` or `handleFatal` may call (I-9).
-     *
-     * It neither awaits, spawns asynchronously, nor throws, and it is idempotent:
-     * a normal quit calls it twice.
-     */
-    reapSync(): void;
-    /** Release every timer/socket. Idempotent. */
-    dispose(): void;
-}

package/dist/proc/types.js

@@ -1,15 +0,0 @@
-/**
- * Runtime shapes for the process supervisor (background-service-supervision §6).
- *
- * ASCII ONLY: `src/proc/**` is inside the glyph scanner's scope.
- *
- * `ProcEvent` is CLI-LOCAL and is deliberately NOT a member of core's
- * `AgentEvent` union, exactly as `TeamEvent` and `TodoEvent` are not: core
- * freezes its runtime export list (`public-api.test.ts`) and forbids host
- * coupling (`no-host-coupling.test.ts`), so a new event member would break the
- * first and teach core about a host shape it has no business defining.
- */
-/** A status from which nothing further will happen. */
-export function isTerminalStatus(status) {
-    return status === 'exited' || status === 'failed' || status === 'stopped';
-}

package/dist/prompts/copy.d.ts

@@ -1,89 +0,0 @@
-/**
- * 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

@@ -1,131 +0,0 @@
-/**
- * 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;
-    }
-}

package/dist/prompts/fill.d.ts

@@ -1,51 +0,0 @@
-/**
- * How a prompt lands in the composer (quick-prompt-library D-6 / §4.6).
- *
- * ASCII ONLY - `src/prompts/**` is inside `glyphs.test.ts::inScope`.
- *
- * PURE, AND IT KNOWS NOTHING ABOUT THE DRAFT'S REAL SHAPE. It is handed the current
- * buffer and caret, and it answers "what should be inserted, or what should the new
- * buffer be". It deliberately does NOT return the resulting buffer: a draft may
- * hold paste-collapse TOKENS (`[Pasted text #1 +8 lines]` plus a payload map), so
- * "the buffer after applying this plan" is a fact only `editorReducer` can compute.
- * Recomputing it here would be a second authority, and the two would drift exactly
- * on the drafts this feature exists to append to.
- *
- * WHY `insert` IS THE DEFAULT (and why the decision lives here rather than in
- * `App`): the only place that knows what the draft currently holds is the editor
- * (the host has no copy of the text), and silently discarding what someone has
- * already typed is the one thing a "fill" gesture must never do.
- */
-export interface PromptFillInput {
-    /** The current draft buffer. */
-    draft: string;
-    /** Caret offset into `draft`, in UTF-16 units. */
-    cursor: number;
-    /** The prompt body. */
-    content: string;
-    /** `insert` unless the user configured `prompts.insertMode = 'replace'` (D-19). */
-    mode?: 'insert' | 'replace';
-}
-export interface PromptFillPlan {
-    mode: 'replace' | 'insert';
-    /**
-     * `replace`: the new buffer in full.
-     * `insert`: only the fragment to insert, separators included.
-     */
-    text: string;
-    /**
-     * `replace`: where the caret goes afterwards (past the body).
-     * `insert`: ignored - the reducer owns the caret and the token snapping.
-     */
-    cursor: number;
-}
-/**
- * Decide between replacing and inserting, and build the fragment.
- *
- * A blank draft is replaced even in `insert` mode: "insert at the caret" into an
- * empty buffer and "replace the empty buffer" are the same edit, and saying so
- * keeps the caller from having to special-case it.
- */
-export declare function planPromptFill(input: PromptFillInput): PromptFillPlan;
-/** Lines a body occupies, for the "8 lines, editable" acknowledgement. */
-export declare function promptLineCount(content: string): number;

package/dist/prompts/fill.js

@@ -1,46 +0,0 @@
-/**
- * How a prompt lands in the composer (quick-prompt-library D-6 / §4.6).
- *
- * ASCII ONLY - `src/prompts/**` is inside `glyphs.test.ts::inScope`.
- *
- * PURE, AND IT KNOWS NOTHING ABOUT THE DRAFT'S REAL SHAPE. It is handed the current
- * buffer and caret, and it answers "what should be inserted, or what should the new
- * buffer be". It deliberately does NOT return the resulting buffer: a draft may
- * hold paste-collapse TOKENS (`[Pasted text #1 +8 lines]` plus a payload map), so
- * "the buffer after applying this plan" is a fact only `editorReducer` can compute.
- * Recomputing it here would be a second authority, and the two would drift exactly
- * on the drafts this feature exists to append to.
- *
- * WHY `insert` IS THE DEFAULT (and why the decision lives here rather than in
- * `App`): the only place that knows what the draft currently holds is the editor
- * (the host has no copy of the text), and silently discarding what someone has
- * already typed is the one thing a "fill" gesture must never do.
- */
-/** Two newlines, so the typed text and the prompt read as two paragraphs. */
-const SEPARATOR = '\n\n';
-/**
- * Decide between replacing and inserting, and build the fragment.
- *
- * A blank draft is replaced even in `insert` mode: "insert at the caret" into an
- * empty buffer and "replace the empty buffer" are the same edit, and saying so
- * keeps the caller from having to special-case it.
- */
-export function planPromptFill(input) {
-    const cursor = Math.max(0, Math.min(input.draft.length, Math.floor(input.cursor)));
-    const blank = input.draft.trim().length === 0;
-    if (input.mode === 'replace' || blank) {
-        return { mode: 'replace', text: input.content, cursor: input.content.length };
-    }
-    const before = input.draft.slice(0, cursor);
-    const after = input.draft.slice(cursor);
-    // A SEPARATOR IS ADDED ONLY WHERE ONE IS MISSING, which is what keeps the plan
-    // from producing three newlines when the caret already sits on a blank line.
-    const lead = before.length > 0 && !before.endsWith(SEPARATOR) ? SEPARATOR : '';
-    const trail = after.length > 0 && !after.startsWith(SEPARATOR) ? SEPARATOR : '';
-    const text = `${lead}${input.content}${trail}`;
-    return { mode: 'insert', text, cursor: cursor + lead.length };
-}
-/** Lines a body occupies, for the "8 lines, editable" acknowledgement. */
-export function promptLineCount(content) {
-    return content.split('\n').length;
-}

package/dist/prompts/limits.d.ts

@@ -1,53 +0,0 @@
-/**
- * Structural bounds for the quick-prompt library (quick-prompt-library §5.1).
- *
- * ASCII ONLY - `src/prompts/**` is inside `glyphs.test.ts::inScope`.
- *
- * STRUCTURE, NOT POLICY (index.md:52-56). Nothing here is user-tunable: these are
- * what an entry, the library and the picker's query can physically carry. The
- * three keys a user may actually change (`prompts.enabled`, `insertMode`, `hint`)
- * live in `config/schema.ts`, are clamped there, and are persisted there. Mixing
- * the two is how a "temporary" ceiling becomes a setting nobody clamps.
- *
- * EVERY NUMBER IS A CODE-POINT COUNT, not a byte count and not a UTF-16 length.
- * Titles and bodies are typed in Chinese by the users this feature exists for, so
- * a byte-based ceiling would silently allow a third of the characters a
- * Latin-alphabet user gets. `[...text].length` is the measurement everywhere in
- * this tree.
- */
-export declare const PROMPT_LIMITS: {
-    /** Entries one library may hold. The 201st create is REFUSED, never truncated. */
-    readonly maxPrompts: 200;
-    /** Title, without surrounding whitespace. */
-    readonly titleMaxChars: 80;
-    /** Body. Large enough for a 40-line procedure, small enough to rewrite cheaply. */
-    readonly contentMaxChars: 8000;
-    /** Optional one-line note under the title. */
-    readonly descriptionMaxChars: 200;
-    /** Tags per entry. */
-    readonly maxTags: 6;
-    /** Characters per tag. */
-    readonly tagMaxChars: 24;
-    /** Body preview lines the list page's detail block may spend (read-only). */
-    readonly detailPreviewLines: 3;
-    /** Rows the list page's detail block may occupy, preview lines included. */
-    readonly detailMaxLines: 6;
-    /** Characters of a body shown on ONE preview line. */
-    readonly previewLineChars: 72;
-};
-/**
- * The picker's own structural bounds.
- *
- * A SEPARATE OBJECT because the picker is a separate surface with a separate
- * budget: its rows carry an index and a title and nothing else, and its query is
- * a filter rather than content. Sharing one object would tie a future change to
- * the library's row height.
- */
-export declare const PROMPT_PICKER_LIMITS: {
-    /** Longest query the filter accepts; further typing is ignored. */
-    readonly queryMaxChars: 64;
-    /** `1`-`9` pick directly, so nine. */
-    readonly quickDigits: 9;
-    /** Rows the picker's detail block may occupy. */
-    readonly detailMaxLines: 4;
-};