@buildaharness/aielia 0.3.0

package/dist/cli-session.d.ts

@@ -0,0 +1,63 @@
+import { ChatMessage, TokenUsage } from '@buildaharness/runtime';
+import { AssistantConfig } from './config.js';
+import { MemorySummary, MemoryExport, TranscriptSearchHit, MemoryPendingOutcome } from './assistant.js';
+import { UndoLogEntry } from './action-snapshot.js';
+/**
+ * Pure formatting/logic backing cli.ts's session-level commands (/help, /status, /export,
+ * /memory, /cost, /doctor) — split out so it's unit-testable without a real readline loop,
+ * the same way cli-config.ts already is for the /config family. cli.ts stays thin glue
+ * (reading live state, calling these, doing actual file I/O) on top of these functions.
+ */
+export interface CliCommandHelp {
+    command: string;
+    description: string;
+}
+/** Kept as a hand-maintained list rather than derived from cli.ts's dispatch table — see /help's task note on why this can drift and needs manual upkeep when a command is added. */
+export declare const CLI_COMMANDS_HELP: CliCommandHelp[];
+export declare function formatHelp(): string;
+export interface StatusInfo {
+    config: AssistantConfig;
+    overriddenKeys: ReadonlySet<keyof AssistantConfig>;
+    transcriptLength: number;
+    planActive: boolean;
+    /** Real filesystem effects still on record as revertible (see action-snapshot.ts) — omitted entirely when no workspace is configured (fileTools/shellTools both absent), same "don't imply a capability that isn't there" rule the banner's capability list already follows. */
+    undoLogEntries?: UndoLogEntry[];
+    /** Pre-formatted by spend-cap.ts's formatSpendCapStatus — undefined when no ceiling is configured, in which case the line is omitted entirely. */
+    spendCapLine?: string;
+}
+/** Reuses formatConfigListing for the config half rather than re-formatting the same fields a second way. */
+export declare function formatStatus(info: StatusInfo): string;
+/** Renders the result of `/memory confirm`/`/memory reject` — cli.ts's handleMemoryConfirm/handleMemoryReject print this directly. */
+export declare function formatMemoryPendingOutcome(action: 'confirmed' | 'rejected' | 'forgotten', outcome: MemoryPendingOutcome): string;
+export declare function formatMemorySummary(summary: MemorySummary): string;
+/** Renders `/memory export`'s full, unbounded contents as pretty-printed JSON — a plain formatting function so it's unit-testable the same way as every other cli-session.ts formatter; cli.ts does the actual file write. */
+export declare function formatMemoryExport(data: MemoryExport): string;
+/** Renders `/search <query>`'s results — each hit is one message (session id short form, timestamp, role, snippet), ranked by relevance, never the whole session it came from. An empty list is an explicit "no results" line, never a silent blank output. */
+export declare function formatSearchResults(hits: TranscriptSearchHit[], query: string): string;
+/** Renders /undo-action's no-argument listing — newest first (see action-snapshot.ts's listUndoLogEntries), with each entry's undoable status so the user doesn't have to stage a revert just to find out it's unavailable. */
+export declare function formatUndoLogListing(entries: UndoLogEntry[]): string;
+/** Renders a transcript as markdown for /export — "You:"/"Assistant:" turns, oldest first. */
+export declare function formatTranscriptMarkdown(transcript: ChatMessage[]): string;
+/** Default /export filename when none is given — mirrors Claude Code's own /export default-name convention. Colons/dots are filesystem-unsafe on some platforms, so the ISO timestamp is sanitized. */
+export declare function defaultExportFilename(now?: Date): string;
+/** Default /memory export filename when none is given — same sanitized-ISO-timestamp convention as defaultExportFilename, JSON instead of markdown. */
+export declare function defaultMemoryExportFilename(now?: Date): string;
+export interface CostSummaryInfo {
+    /** Usage for the turn just completed — absent when the last turn reported no usage at all, or no turn has completed yet. */
+    lastTurn?: TokenUsage;
+    /** Running total across the session — {inputTokens: 0, outputTokens: 0} before any usage has ever been reported. */
+    session: TokenUsage;
+    backend: 'proxy' | 'claude-cli' | 'anthropic' | 'openai' | 'openrouter';
+    /** Pre-formatted by spend-cap.ts's formatSpendCapStatus — undefined when no ceiling is configured, in which case the line is omitted entirely (same convention as StatusInfo.spendCapLine). */
+    spendCapLine?: string;
+}
+/** Renders /cost's output. The backend-specific footnote matters: claude-cli's cost is real (but may read $0 on a Pro/Max subscription, not API billing); every other backend's cost, when shown, is a static-table estimate (see cli.ts's withCostEstimate), never real billing data — see model-pricing.ts. */
+export declare function formatCostSummary(info: CostSummaryInfo): string;
+export interface DoctorCheck {
+    label: string;
+    ok: boolean;
+    /** Failure reason ("timed out", "not found", an HTTP status, etc.) — omitted entirely on a passing check. */
+    detail?: string;
+}
+/** Renders /doctor's ✓/✗ list — the actual checks (network fetch, subprocess spawn, filesystem stat) run in cli.ts, which has the I/O; this just formats the results. */
+export declare function formatDoctorReport(checks: DoctorCheck[]): string;

package/dist/cli.d.ts

@@ -0,0 +1,65 @@
+import { FsBackend } from '@buildaharness/runtime';
+import { PersonalAssistant } from './assistant.js';
+import { AssistantConfig, ConfigStore } from './config.js';
+import { NonInteractiveApprovalMode } from './non-interactive-mode.js';
+export interface RunCliOptions {
+    dataDir?: string;
+    configStore?: ConfigStore;
+    backend?: FsBackend;
+    remindersFile?: string;
+    envOverrides?: Partial<AssistantConfig>;
+    nonInteractiveApprovalMode?: NonInteractiveApprovalMode;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    /**
+     * Bypasses buildAssistant()'s config-driven backend selection entirely — the seam tests use
+     * to hand runCli a PersonalAssistant wired to a scripted ILLMClient (same pattern as
+     * assistant.test.ts) for deterministic command-dispatch/approval-flow coverage. When set, a
+     * /config change that would otherwise rebuild the assistant leaves this instance in place.
+     */
+    assistant?: PersonalAssistant;
+    /** Overrides the rl.question-based approval prompt — lets tests script approve/decline answers without faking stdin/a real TTY. */
+    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>;
+    /** 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. */
+    detectClaudeCli?: () => Promise<boolean>;
+    /** Test seam: script the first-run setup's line reads. */
+    firstRunAsk?: (question: string) => Promise<string>;
+}
+export interface CliInstance {
+    /** Parses and dispatches one line of input exactly as the REPL's 'line' handler does (same dispatchQueue serialization) — the seam cli.test.ts drives command dispatch through without a live TTY. */
+    dispatchLine(line: string): Promise<void>;
+    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
+     * 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
+     * readline REPL or by non-interactive/piped mode — only the TUI shell polls this.
+     */
+    getStatusIndicators(): Promise<string[]>;
+}
+/**
+ * The CLI's REPL, parameterized so cli.test.ts can import and drive it directly instead of only
+ * through a live process (see non-interactive-mode.ts's doc comment for why that mattered before
+ * this export existed — this is T1's answer to it). `main()` below calls this with no options,
+ * getting exactly today's behavior; every option here has a real-filesystem/real-stdio default.
+ */
+export declare function runCli(options?: RunCliOptions): Promise<CliInstance>;
+/**
+ * True when `entryArg` (a `process.argv[1]` value) refers to the same file as
+ * `moduleHref` (an `import.meta.url`).
+ *
+ * The naive check — `moduleHref === pathToFileURL(entryArg).href` — breaks
+ * whenever the script is launched through the npm bin: `npx
+ * @buildaharness/aielia`, a global install, or any
+ * `node_modules/.bin` shim all pass a **symlink** to this file as
+ * `process.argv[1]`, while Node reports `import.meta.url` as the resolved real
+ * path. So resolve `entryArg` to its real path before comparing. `resolveReal`
+ * is injected for tests; it defaults to `fs.realpathSync`.
+ */
+export declare function entryArgMatchesModule(entryArg: string | undefined, moduleHref: string, resolveReal?: (p: string) => string): boolean;