@buildaharness/aielia 0.3.1 → 0.3.2

package/dist/cli.d.ts

@@ -2,6 +2,18 @@ import { FsBackend } from '@buildaharness/runtime';
 import { PersonalAssistant } from './assistant.js';
 import { AssistantConfig, ConfigStore } from './config.js';
 import { NonInteractiveApprovalMode } from './non-interactive-mode.js';
+/**
+ * One choice in a structured multi-option prompt (Phase 7 of the internal plan
+ * — the numbered/arrow-key approval selector). `key` is both the single-character shortcut shown
+ * inline next to the option and the value `askSelect` resolves with; callers order options with
+ * the safe/fail-closed choice last, matching `askYesNo`'s own "no real answer → treat as declined"
+ * convention (see `askSelect`'s default implementation below, and `ink-select-prompt.tsx`'s
+ * `SelectPrompt`, which renders this same list with arrow-key highlight + per-key shortcuts).
+ */
+export interface SelectOption {
+    key: string;
+    label: string;
+}
 export interface RunCliOptions {
     dataDir?: string;
     configStore?: ConfigStore;
@@ -22,6 +34,8 @@ export interface RunCliOptions {
     askYesNo?: (question: string) => Promise<boolean>;
     /** Overrides the rl.question-based free-text prompt the clarification sub-loop uses for option numbers, edit notes, and "Other" free text — lets tests script a multi-step answer without faking stdin/a real TTY. */
     askLine?: (question: string) => Promise<string>;
+    /** Overrides the rl.question-based structured multi-option prompt (Phase 7's approval selector) — lets tests script a selection by key without faking stdin/a real TTY. Resolves with the chosen `SelectOption.key`. */
+    askSelect?: (question: string, options: SelectOption[]) => Promise<string>;
     /** Test seam: skip the interactive first-run setup regardless of TTY state (also implied when `assistant` is passed). */
     skipFirstRunSetup?: boolean;
     /** Test seam: stub `claude` binary detection for the first-run setup. */
@@ -35,7 +49,7 @@ export interface CliInstance {
     close(): void;
     /**
      * Additive, read-only accessor for the pinned-input TUI shell's status line
-     * (plans/personal_assistant_cli_pinned_input_plan.html Phase 3) — the same two signals
+     * (the internal plan Phase 3) — the same two signals
      * printStatus() already renders as part of `/status` (lastPlanStatus !== undefined,
      * spendCapStatusLine()), just exposed here instead of only printed. Returns short indicator
      * strings in priority order; empty when there's nothing to report. Not used by the ordinary
@@ -50,6 +64,22 @@ export interface CliInstance {
  * getting exactly today's behavior; every option here has a real-filesystem/real-stdio default.
  */
 export declare function runCli(options?: RunCliOptions): Promise<CliInstance>;
+/**
+ * Phase 4 of the internal plan: `tuiMode` is resolved from the
+ * same persisted-config + env-override chain every other config key uses (not just the env var
+ * alone), so `/config set tuiMode enabled` works exactly like `/config set oneLoopMode enabled`
+ * already does. This is a second, separate `configStore.load()` from the one `runCli()` performs
+ * internally — an accepted duplication (one extra small JSON read at startup) rather than
+ * threading a pre-resolved config through `runCli()`'s options, since `runCli()` must remain
+ * callable on its own (tests, `non-interactive-mode.ts`) with no knowledge of this gate.
+ *
+ * `shouldLaunchTuiApp` (tui-mode-flag.ts) additionally requires both stdio streams to be a real
+ * TTY — this repo's documented piped/scripted workflow (`printf 'msg\nexit\n' | node dist/cli.js`)
+ * and every non-interactive shell always take the `runCli()` branch below regardless of the flag.
+ * `runTuiApp` is imported dynamically so a disabled (the default) or non-TTY run never loads Ink
+ * at all — `main()` behaves byte-for-byte as it does today in both those cases.
+ */
+export declare function main(argv?: readonly string[]): Promise<void>;
 /**
  * True when `entryArg` (a `process.argv[1]` value) refers to the same file as
  * `moduleHref` (an `import.meta.url`).