scoutline 0.10.2 → 0.12.0

package/dist/commands/doctor.d.ts

@@ -18,8 +18,10 @@
  * evaluation and constructs no Adapter and no transport (FR-034).
  */
 import type { CommandResult } from "../command-invocation.js";
-import type { DiagnosticsReport } from "../capabilities/diagnostics.js";
+import type { DiagnosticsReport, ProviderVerificationSummary } from "../capabilities/diagnostics.js";
 import type { ProviderDescriptor, ProviderId } from "../providers/types.js";
+import type { VerificationPromotionStore } from "../lib/config-store.js";
+import { type QuotaState } from "../lib/quota-store.js";
 export interface DoctorDiagnosticsDependencies {
     readonly noTools: boolean;
     readonly effectiveProvider: ProviderId;
@@ -36,6 +38,65 @@ export interface DoctorDiagnosticsDependencies {
      * simply leaves out the `cache` field.
      */
     readonly cacheSummary?: string;
+    /**
+     * Optional verification promoter (T3b — review item 10). When
+     * supplied, Doctor flips `verification.status: unverified → verified`
+     * for each Provider whose probe SUCCEEDS. The promotion is
+     * best-effort: a write failure is reported through
+     * {@link DoctorDiagnosticsDependencies.onPromotionError} (when
+     * supplied) and never turns a successful probe into a Doctor failure.
+     * Skipped, failed, no-tools, and network-deferred records are NOT
+     * promoted (the probe result is authoritative). When omitted, Doctor
+     * runs without promotion (backward-compatible with existing tests).
+     */
+    readonly verificationPromoter?: VerificationPromotionStore;
+    /**
+     * Optional clock used for the promoted `checkedAt` timestamp.
+     * Defaults to `Date.now`; tests inject a fixed clock for
+     * deterministic timestamps.
+     */
+    readonly now?: () => number;
+    /**
+     * Optional sink for promotion-write failures. Doctor isolates write
+     * failures (a successful probe never becomes a Doctor failure on the
+     * back of a write error); when this sink is supplied, the failure is
+     * reported there so the dispatcher can surface it as a stderr notice
+     * without affecting the exit code. When omitted, write failures are
+     * silently swallowed.
+     */
+    readonly onPromotionError?: (providerId: ProviderId, error: unknown) => void;
+    /**
+     * Optional quota snapshot for the per-Provider `quota` summary
+     * (PB-T5 — Plan B). When supplied, each Provider entry embeds a
+     * `{ source, observedAt?, authoritative }` summary derived from its
+     * snapshot entry. When omitted, the `quota` field is omitted on
+     * every entry (backward-compatible with pre-PB-T5 callers). Doctor
+     * NEVER live-probes quota — it only reads the snapshot; the live
+     * probe belongs to the `quota` command. Under `--no-tools` the
+     * field still appears when a snapshot is available (a snapshot
+     * read is a local state read, not transport).
+     */
+    readonly quotaSnapshot?: QuotaState;
+    /**
+     * Optional verification records (Plan A — surfaced in Doctor by
+     * PB-T5). When supplied, each Provider entry embeds a
+     * `verification` summary mirroring the Provider's
+     * `config.providers[id].verification` record. The dispatcher maps
+     * the config-store `ProviderVerification` shape to the capability
+     * contract's `ProviderVerificationSummary` (structural twin — kept
+     * separate so the capability contract does not import
+     * `lib/config-store.ts`). When omitted, the field is omitted
+     * (backward-compatible).
+     */
+    readonly verificationRecords?: Partial<Record<ProviderId, ProviderVerificationSummary>>;
+    /**
+     * Optional staleness threshold for the per-Provider `quota`
+     * summary's `authoritative` flag. Defaults to
+     * {@link DEFAULT_QUOTA_STALE_THRESHOLD_MS} (10 min — Tavily's
+     * 10/10min key limit is the floor). Only consulted when
+     * `quotaSnapshot` is supplied.
+     */
+    readonly thresholdMs?: number;
 }
 /**
  * Build a schema-version-2 {@link DiagnosticsReport}. Inventory
@@ -45,6 +106,15 @@ export interface DoctorDiagnosticsDependencies {
  * configured-state evaluation. Otherwise each configured Provider is
  * probed through shared execution with settled collection, preserving
  * registry order and normalized redacted failures.
+ *
+ * PB-T5: when `deps.quotaSnapshot` is supplied, each entry carries a
+ * `quota` summary derived from the snapshot (source/freshness). When
+ * `deps.verificationRecords` is supplied, each entry carries a
+ * `verification` summary mirroring Plan A's config record. Both fields
+ * are omitted when their dependency is absent (backward-compatible).
+ * Doctor never live-probes quota — it only reads the snapshot. The
+ * `quota` field appears even under `--no-tools` (snapshot reads are
+ * local state, not transport).
  */
 export declare function buildDiagnosticsReport(deps: DoctorDiagnosticsDependencies): Promise<DiagnosticsReport>;
 /**

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAsB,MAAM,uBAAuB,CAAC;AAMhG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AA6CD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAiC5B;AA4CD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAKhE;AAMD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAO3C;AAED,eAAO,MAAM,WAAW,QA+DhB,CAAC"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAEV,iBAAiB,EAGjB,2BAA2B,EAC5B,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAsB,MAAM,uBAAuB,CAAC;AAChG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAC3D;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7E;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC;IACpC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,2BAA2B,CAAC,CAAC,CAAC;IACxF;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AA6CD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAiF5B;AAgED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAKhE;AAMD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAO3C;AAED,eAAO,MAAM,WAAW,QAoEhB,CAAC"}

package/dist/commands/doctor.js

@@ -21,6 +21,7 @@ import { deriveCapabilityMatrix, diagnosticErrorFromError } from "../capabilitie
 import { executeProviderOperation } from "../lib/execution.js";
 import { UnsupportedCapabilityError } from "../lib/errors.js";
 import { redactSecrets, configuredSecrets } from "../lib/redact.js";
+import { DEFAULT_QUOTA_STALE_THRESHOLD_MS, isQuotaSnapshotStale, } from "../lib/quota-store.js";
 function nodeMajor() {
     const [major] = process.versions.node.split(".");
     return parseInt(major, 10);
@@ -50,21 +51,78 @@ async function probeProvider(descriptor, env, sleep, random) {
  * configured-state evaluation. Otherwise each configured Provider is
  * probed through shared execution with settled collection, preserving
  * registry order and normalized redacted failures.
+ *
+ * PB-T5: when `deps.quotaSnapshot` is supplied, each entry carries a
+ * `quota` summary derived from the snapshot (source/freshness). When
+ * `deps.verificationRecords` is supplied, each entry carries a
+ * `verification` summary mirroring Plan A's config record. Both fields
+ * are omitted when their dependency is absent (backward-compatible).
+ * Doctor never live-probes quota — it only reads the snapshot. The
+ * `quota` field appears even under `--no-tools` (snapshot reads are
+ * local state, not transport).
  */
 export async function buildDiagnosticsReport(deps) {
     const secrets = configuredSecrets(deps.env);
+    const now = (deps.now ?? Date.now)();
+    const thresholdMs = deps.thresholdMs ?? DEFAULT_QUOTA_STALE_THRESHOLD_MS;
     const baseEntries = deps.descriptors.map((descriptor) => ({
         provider: descriptor.id,
         configured: descriptor.isConfigured(deps.env),
         capabilities: [...descriptor.capabilities()],
     }));
+    // PB-T5 — compute the additive `quota` and `verification` fields
+    // once per Provider. Both are pure lookups against injected state
+    // (snapshot/config records), never transport. Returned as a side
+    // table so the probe branches can attach them without re-reading.
+    const quotaFor = (provider) => {
+        if (!deps.quotaSnapshot)
+            return undefined;
+        const snapshot = deps.quotaSnapshot.quota[provider];
+        if (!snapshot) {
+            return { source: "none", authoritative: false };
+        }
+        return {
+            source: "snapshot",
+            observedAt: snapshot.observedAt,
+            authoritative: !isQuotaSnapshotStale(snapshot, now, thresholdMs),
+        };
+    };
+    const verificationFor = (provider) => deps.verificationRecords?.[provider];
     const providers = deps.noTools
         ? baseEntries.map((entry) => ({
             ...entry,
             status: "skipped",
             reason: entry.configured ? "tools-disabled" : "not-configured",
+            ...(quotaFor(entry.provider) !== undefined ? { quota: quotaFor(entry.provider) } : {}),
+            ...(verificationFor(entry.provider) !== undefined
+                ? { verification: verificationFor(entry.provider) }
+                : {}),
         }))
-        : await probeEntries(baseEntries, deps, secrets);
+        : await probeEntries(baseEntries, deps, secrets, quotaFor, verificationFor);
+    // T3b — verification promotion (review item 10). After a successful
+    // probe, flip the matching Provider's `verification.status` from
+    // `unverified` to `verified`. Best-effort: a write failure is
+    // isolated through `onPromotionError` and never turns a successful
+    // probe into a Doctor failure. Only `status: "ok"` records are
+    // promotable; skipped, failed, no-tools, and network-deferred
+    // records are not (the probe result is authoritative). Awaited so a
+    // subsequent read after Doctor completion is deterministic.
+    if (deps.verificationPromoter) {
+        const checkedAt = now;
+        for (const entry of providers) {
+            if (entry.status !== "ok")
+                continue;
+            try {
+                await deps.verificationPromoter.promote(entry.provider, checkedAt);
+            }
+            catch (error) {
+                // Isolated: a write failure does not propagate. The sink (when
+                // supplied) lets the dispatcher surface it as a stderr notice
+                // without affecting the exit code.
+                deps.onPromotionError?.(entry.provider, error);
+            }
+        }
+    }
     // L1 fix: the cache summary is formatted by the CLI handler and
     // threaded through deps.cacheSummary. The report builder only embeds
     // it; it never reads `cacheStats()` itself.
@@ -87,23 +145,41 @@ export async function buildDiagnosticsReport(deps) {
  * NOT fail the report. A configured probe failure is normalized and
  * recursively redacted before joining the report; successful entries
  * are preserved alongside it.
+ *
+ * PB-T5: the additive `quota` and `verification` fields are attached
+ * to EVERY entry (success/skipped/error) via the injected lookup
+ * closures — they are pure state reads, not transport, so they appear
+ * regardless of the probe outcome. A failed probe with a fresh
+ * snapshot still surfaces the snapshot summary so a user can see both
+ * the probe failure and the quota state.
  */
-async function probeEntries(baseEntries, deps, secrets) {
+async function probeEntries(baseEntries, deps, secrets, quotaFor, verificationFor) {
     const configuredIndexes = baseEntries
         .map((entry, index) => (entry.configured ? index : -1))
         .filter((index) => index >= 0);
     const settled = await Promise.allSettled(configuredIndexes.map((index) => probeProvider(deps.descriptors[index], deps.env, deps.sleep, deps.random)));
     let settledCursor = 0;
     return baseEntries.map((entry) => {
+        const quota = quotaFor(entry.provider);
+        const verification = verificationFor(entry.provider);
+        const additive = {
+            ...(quota !== undefined ? { quota } : {}),
+            ...(verification !== undefined ? { verification } : {}),
+        };
         if (!entry.configured) {
-            return { ...entry, status: "skipped", reason: "not-configured" };
+            return {
+                ...entry,
+                status: "skipped",
+                reason: "not-configured",
+                ...additive,
+            };
         }
         const result = settled[settledCursor++];
         if (result.status === "fulfilled") {
-            return { ...entry, status: "ok" };
+            return { ...entry, status: "ok", ...additive };
         }
         const redacted = redactSecrets(diagnosticErrorFromError(result.reason), secrets);
-        return { ...entry, status: "error", error: redacted };
+        return { ...entry, status: "error", error: redacted, ...additive };
     });
 }
 // ---------------------------------------------------------------------------
@@ -168,21 +244,26 @@ metadata all advertise reader; MiniMax advertises and supplies
 neither. The capabilityMatrix field lists Z.AI, Tavily, and Exa for
 reader.
 
-Crawl and Map are Provider Capabilities owned by Tavily.
-Z.AI, MiniMax, and Exa do not advertise either; the capabilityMatrix
-lists Tavily alone for each. Research is supplied by Tavily and Exa.
-Selecting Z.AI or MiniMax for crawl, map, or research returns
-UNSUPPORTED_CAPABILITY with no fallback.
+Crawl and Map are Provider Capabilities owned by Tavily and Firecrawl.
+Z.AI, MiniMax, Exa, and Brave do not advertise either; the
+capabilityMatrix lists Tavily and Firecrawl for each. Research is
+supplied by Tavily and Exa. By default (0.11.0+) Provider fallback
+emits a stderr notice and silently reroutes to the next eligible
+configured supplier when a non-supplier is selected; under
+--no-fallback (or SCOUTLINE_NO_FALLBACK=1) the preflight surfaces
+UNSUPPORTED_CAPABILITY for the selected non-supplier.
 
 Public 'repo' and 'read' commands participate in Provider selection.
 They honour --provider / SCOUTLINE_PROVIDER / the default zai, route
 through the matching Adapter's Repository / Reader Capability, and
 return UNSUPPORTED_CAPABILITY when the selected Provider does not
-advertise the requested capability (e.g. 'repo --provider minimax' or
-'read --provider minimax' fail without falling back to Z.AI). A
-supported-but-unconfigured Provider returns ConfigurationError; a
-supported-and-configured Provider dispatches through the corresponding
-Adapter.
+advertise the requested capability (e.g. 'repo --provider minimax'
+or 'read --provider minimax' trigger Provider fallback by default in
+0.11.0+; under --no-fallback (or SCOUTLINE_NO_FALLBACK=1) the
+preflight surfaces UNSUPPORTED_CAPABILITY before any Adapter work).
+A supported-but-unconfigured Provider returns ConfigurationError; a
+supported-and-configured Provider dispatches through the
+corresponding Adapter.
 
 Options:
   --no-tools   Skip every connectivity probe (metadata-only). Under

package/dist/commands/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Init command — interactive onboarding wizard (T3a + T3b — Plan A).
+ *
+ * This module owns the interactive `scoutline init` flow:
+ *   - State detection (absent / corrupt / already-onboarded / fresh).
+ *   - Provider checklist (registry-derived; none pre-checked — equal weight).
+ *   - Per-provider ask-key-first → hidden input → inline single-attempt
+ *     validation through `DiagnosticsCapability.invoke({probe:true})` against
+ *     an EPHEMERAL resolved env (never persists, never mutates `process.env`).
+ *   - Honest broad classification of probe failures: key-problems
+ *     (`AuthError`/`ApiError`) reject + re-prompt; `NetworkError` offers
+ *     save-unverified. No false-precise "wrong/disabled/mismatch" subtypes
+ *     are inferred from message text — the taxonomy only distinguishes
+ *     `AuthError`/`ApiError`/`NetworkError`.
+ *   - Credit-cost disclosure before any paid-provider probe.
+ *   - Fallback preference question.
+ *   - Atomic config write (T1 `writeConfig` primitive) + redacted summary.
+ *
+ * T3b additions:
+ *   - **Re-config menu** when an already-valid config exists: edit a
+ *     Provider key, add a Provider, remove a Provider, change the
+ *     fallback preference, re-run the full wizard, or cancel. Editing
+ *     a Provider key resets `verification.status` to `unverified`
+ *     (Doctor re-promotes after a successful probe).
+ *   - **Corrupt-config repair**: tolerant `inspectConfig` distinguishes
+ *     `absent` / `valid` / `corrupt`. On `corrupt` the wizard offers to
+ *     back up the live file and rewrite a fresh config — `init` is the
+ *     recovery path, not a victim of corruption.
+ *   - **Formal non-TTY refuse**: without an interactive terminal the
+ *     wizard refuses before any prompt, prints env instructions and
+ *     the `init` hint, and exits.
+ *   - **Stale-env-after-import warning**: when the user imports a key
+ *     from env, the wizard notes that the env value will continue to
+ *     take precedence (env > file in the runtime precedence rule) —
+ *     the wizard cannot turn off the env value for the user.
+ *   - **`hintShown` reset on re-init**: a re-config or fresh write
+ *     resets the env-only hint marker so a user who later switches to
+ *     env-only usage sees the hint once again.
+ *
+ * Boundary rules:
+ *   - No Provider transport is constructed outside the per-provider probe;
+ *     the candidate credential lives only in the ephemeral env until the
+ *     final atomic write.
+ *   - All prompt IO flows through the {@link InitPrompts} seam; no direct
+ *     `process.stdin` / `process.stdout` reads in this module. Production
+ *     wires `@inquirer/prompts`; tests inject scripted doubles.
+ *   - Registration links render BOTH a terminal hyperlink AND the literal
+ *     URL text so captured / non-hyperlink output stays usable.
+ *   - No selection work (Plan B); the wizard writes at most one
+ *     `fallbackEnabled` flag and per-Provider records.
+ */
+import type { ConfigInspection, ScoutlineConfig, WriteConfigOptions } from "../lib/config-store.js";
+import type { ProviderDescriptor } from "../providers/types.js";
+/**
+ * Help text for `scoutline init --help`. T3b completes the wizard's
+ * lifecycle (re-config menu, corrupt-config repair, formal non-TTY
+ * refuse), so the T3a PREVIEW caveat is dropped — the public claim of
+ * a complete `init` is now accurate.
+ */
+export declare const INIT_HELP: string;
+/**
+ * Multi-select prompt choice for the provider checklist. `value` is the
+ * provider id; `description` carries env-detected and credit-cost hints
+ * surfaced in the choice description column.
+ */
+export interface InitChoice<T> {
+    readonly value: T;
+    readonly name: string;
+    readonly description?: string;
+    /**
+     * Pre-checked state. The provider checklist NEVER pre-checks (equal
+     * weight); this field exists for forward compatibility with T3b.
+     */
+    readonly checked?: boolean;
+}
+/**
+ * Injectable prompt IO seam. Production wires `@inquirer/prompts` via
+ * {@link createInquirerPrompts}; tests inject scripted doubles that
+ * never touch a real TTY.
+ *
+ * The shape mirrors the four prompt types the wizard uses: multi-select
+ * checkbox, yes/no confirm, hidden password, and free-text input.
+ */
+export interface InitPrompts {
+    /**
+     * Multi-select. Returns the chosen values in selection order. Throws
+     * on user cancel (Ctrl+C / EOF) — the caller catches and treats as
+     * no-write.
+     */
+    checkbox<T>(message: string, choices: readonly InitChoice<T>[]): Promise<T[]>;
+    /**
+     * Single-select menu. Returns the chosen value. Throws on user
+     * cancel. Used by the T3b re-config menu (edit/add/remove/fallback/
+     * rerun/cancel) and the corrupt-config-repair prompt.
+     */
+    select<T>(message: string, choices: readonly InitChoice<T>[]): Promise<T>;
+    /** Yes/no. `defaultYes` carries the documented default ([Y/n] vs [y/N]). */
+    confirm(message: string, defaultYes: boolean): Promise<boolean>;
+    /** Hidden password input. Returns the trimmed value (possibly empty). */
+    password(message: string): Promise<string>;
+    /** Free-text input. Used for follow-up re-prompt loops. */
+    input(message: string): Promise<string>;
+}
+/**
+ * Injectable config-store seam. Production wires the real
+ * {@link inspectConfig} / {@link writeConfig}; tests inject in-memory or
+ * temp-dir-backed doubles so the wizard is hermetic — no real
+ * `~/.scoutline/config.json` I/O during tests.
+ */
+export interface InitConfigStore {
+    inspect(): Promise<ConfigInspection>;
+    write(config: ScoutlineConfig, options?: WriteConfigOptions): Promise<void>;
+}
+/**
+ * Wrap the real `inspectConfig` / `writeConfig` pair as an
+ * {@link InitConfigStore}. The default options object is captured per-call
+ * so the wizard can pass a temp `filePath` / atomic options through
+ * unchanged in tests.
+ */
+export declare function createDefaultConfigStore(options?: WriteConfigOptions): InitConfigStore;
+/**
+ * Injectable dependencies for the init wizard. Production supplies the
+ * real defaults via the composition root in `src/index.ts`; tests pass
+ * in-memory / temp-dir doubles for hermeticity.
+ */
+export interface InitDependencies {
+    /** The provider registry — canonical checklist source/order. */
+    readonly descriptors: readonly ProviderDescriptor[];
+    /** Injectable prompt IO seam. */
+    readonly prompts: InitPrompts;
+    /** Injectable config-store seam. */
+    readonly configStore: InitConfigStore;
+    /** Injectable environment view (for env-key-import detection). */
+    readonly env: NodeJS.ProcessEnv;
+    /**
+     * Injectable clock, used for verification `checkedAt` timestamps.
+     * Production wires `Date.now`; tests inject a fixed clock.
+     */
+    readonly now: () => number;
+    /** Whether stdin is an interactive TTY. Non-TTY gets a graceful guard. */
+    readonly stdinIsTTY: boolean;
+    /** Progress / disclosure sink. */
+    readonly writeStderr: (value: string) => void;
+    /** Final-summary sink (the only stdout write in the wizard). */
+    readonly writeStdout: (value: string) => void;
+}
+/**
+ * Run the interactive init wizard. Performs the T3b state dispatch:
+ *   - non-TTY → refuse before any prompt + exit 1.
+ *   - corrupt config → offer backup + rewrite (init is the recovery path).
+ *   - valid + already-onboarded → re-config menu.
+ *   - valid + empty / absent → fresh-onboarding flow.
+ *
+ * Returns the exit code:
+ *   - 0 on success, re-config applied, or already-onboarded + Cancel.
+ *   - 1 on user cancel, non-TTY refuse, write failure, or declined repair.
+ */
+export declare function runFreshOnboarding(deps: InitDependencies): Promise<number>;
+/**
+ * Build the production {@link InitPrompts} from `@inquirer/prompts`. The
+ * adapter:
+ *   - Rewires the inquirer output stream to `process.stderr` so the
+ *     wizard keeps the codebase's data-only-stdout contract (the final
+ *     summary line is the only stdout write).
+ *   - Maps the four wizard prompt shapes onto the inquirer calls.
+ *
+ * Tests never call this — they inject a scripted {@link InitPrompts}
+ * double instead, so test runs are fully hermetic and do not need a TTY.
+ */
+export declare function createInquirerPrompts(): InitPrompts;
+/**
+ * Top-level init handler. Wired into the dispatch switch in `index.ts`.
+ *
+ * - `--help` / `-h` prints {@link INIT_HELP} to stdout and returns 0.
+ * - Otherwise dispatches to {@link runFreshOnboarding}.
+ *
+ * The CLI arg list is the same shape every other handler receives; the
+ * handler only inspects it for the help flag.
+ */
+export declare function handleInitWithHelp(args: readonly string[], deps: InitDependencies): Promise<number>;
+/**
+ * Backwards-compatible alias used by the dispatch switch. Tests that drive
+ * the wizard directly pass an empty arg list.
+ */
+export declare function handleInit(deps: InitDependencies): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}