@posthog/wizard 2.9.1 → 2.10.1

package/dist/src/ui/tui/store.js

@@ -1,474 +0,0 @@
-/**
- * WizardStore — Nanostore-backed reactive store for the TUI.
- * React components subscribe via useSyncExternalStore.
- *
- * The active screen is derived from session state — WizardRouter walks
- * the flow and shows the first step whose `isComplete` is still false.
- *
- * Define a step `gate` if your screen needs to await user interactions.
- * bin.ts calls `await store.getGate(stepId)` to pause until the gate
- * predicate becomes true.
- *
- * All session mutations that affect screen resolution go through
- * explicit setters so emitChange() is always called.
- */
-import { atom, map } from 'nanostores';
-import { TaskStatus } from '../wizard-ui.js';
-import { AdditionalFeature, McpOutcome, RunPhase, buildSession, } from '../../lib/wizard-session.js';
-import { WizardRouter, Screen, Overlay, Flow, } from './router.js';
-import { analytics, sessionProperties } from '../../utils/analytics.js';
-import { WORKFLOW_STEPS } from './flows.js';
-export { TaskStatus, Screen, Overlay, Flow, RunPhase, McpOutcome };
-export class WizardStore {
-    // ── Internal nanostore atoms ─────────────────────────────────────
-    $session = map(buildSession({}));
-    $statusMessages = atom([]);
-    $statusExpanded = atom(false);
-    $tasks = atom([]);
-    $eventPlan = atom([]);
-    $learnCardBlockIdx = atom(0);
-    $learnCardComplete = atom(false);
-    $version = atom(0);
-    /** Last screen seen — used to detect screen transitions for analytics. */
-    _lastScreen = null;
-    /** Hooks run when transitioning onto a screen. */
-    _enterScreenHooks = new Map();
-    /** Gate promises derived from workflow step definitions. */
-    _gates = new Map();
-    version = '';
-    /** Navigation router — resolves active screen from session state. */
-    router;
-    /** Blocks agent execution until the settings-override overlay is dismissed. */
-    _resolveSettingsOverride = null;
-    _backupAndFixSettings = null;
-    /** Blocks OAuth flow until the port-conflict overlay is dismissed. */
-    _resolvePortConflict = null;
-    constructor(flow = Flow.PostHogIntegration) {
-        this.router = new WizardRouter(flow);
-        this._initFromWorkflow(flow);
-    }
-    /**
-     * Scan workflow steps for gate predicates and onInit callbacks.
-     * Creates gate promises and fires init work.
-     */
-    _initFromWorkflow(flow) {
-        const steps = WORKFLOW_STEPS[flow];
-        if (!steps)
-            return;
-        // Create gate promises from steps that define them
-        for (const step of steps) {
-            if (step.gate) {
-                let resolve;
-                const promise = new Promise((r) => {
-                    resolve = r;
-                });
-                this._gates.set(step.id, {
-                    predicate: step.gate,
-                    promise,
-                    resolve,
-                    resolved: false,
-                });
-            }
-        }
-        // Run onInit callbacks with a minimal context interface.
-        // Arrow functions capture `this` from _initFromWorkflow so we don't
-        // need to alias it.
-        const getSession = () => this.session;
-        const ctx = {
-            get session() {
-                return getSession();
-            },
-            setReadinessResult: (r) => this.setReadinessResult(r),
-            setFrameworkContext: (k, v) => this.setFrameworkContext(k, v),
-            emitChange: () => this.emitChange(),
-        };
-        for (const step of steps) {
-            step.onInit?.(ctx);
-        }
-    }
-    /**
-     * Run all `onReady` hooks declared by the current flow's steps, in
-     * order. Must be called after `store.session = session` so hooks see
-     * the real installDir. bin.ts calls this generically — it doesn't
-     * need to know which workflow has which pre-flow work.
-     */
-    async runReadyHooks() {
-        const steps = WORKFLOW_STEPS[this.router.activeFlow];
-        if (!steps)
-            return;
-        const ctx = {
-            session: this.session,
-            setFrameworkContext: (k, v) => this.setFrameworkContext(k, v),
-            setFrameworkConfig: (i, c) => this.setFrameworkConfig(i, c),
-            setDetectedFramework: (l) => this.setDetectedFramework(l),
-            setUnsupportedVersion: (info) => this.setUnsupportedVersion(info),
-            addDiscoveredFeature: (f) => this.addDiscoveredFeature(f),
-            setDetectionComplete: () => this.setDetectionComplete(),
-        };
-        for (const step of steps) {
-            if (step.onReady) {
-                await step.onReady(ctx);
-            }
-        }
-    }
-    // ── Gate API ────────────────────────────────────────────────────
-    /**
-     * Get a gate promise by step ID — the primary blocking checkpoint API
-     * for bin.ts. `await store.getGate('...')` parks the caller until the
-     * corresponding workflow step's gate predicate flips to true (if the
-     * predicate stays false, the caller stays parked indefinitely — the
-     * TUI keeps rendering so the user can resolve whatever is blocking).
-     *
-     * If the workflow doesn't define a step with this ID, or the step
-     * has no `gate` predicate, this returns an already-resolved promise
-     * so bin.ts flows straight through. This lets workflows opt in to
-     * gates on a per-step basis without bin.ts needing to know which
-     * gates exist in which flow.
-     */
-    getGate(stepId) {
-        return this._gates.get(stepId)?.promise ?? Promise.resolve();
-    }
-    /**
-     * Re-evaluate every gate predicate against the current session and
-     * resolve any whose predicate now returns true. Called after every
-     * emitChange(), so gates unblock as soon as the session mutation
-     * that satisfies them lands. Gates only resolve once — a predicate
-     * that goes true → false → true will NOT re-block a caller that
-     * already awaited through.
-     */
-    _checkGates() {
-        for (const [, gate] of this._gates) {
-            if (!gate.resolved && gate.predicate(this.session)) {
-                gate.resolved = true;
-                gate.resolve();
-            }
-        }
-    }
-    // ── State accessors (read from atoms) ────────────────────────────
-    get session() {
-        return this.$session.get();
-    }
-    set session(value) {
-        this.$session.set(value);
-        this.emitChange();
-    }
-    get statusMessages() {
-        return this.$statusMessages.get();
-    }
-    get tasks() {
-        return this.$tasks.get();
-    }
-    get eventPlan() {
-        return this.$eventPlan.get();
-    }
-    get statusExpanded() {
-        return this.$statusExpanded.get();
-    }
-    toggleStatusExpanded() {
-        this.$statusExpanded.set(!this.$statusExpanded.get());
-        this.emitChange();
-    }
-    setStatusExpanded(expanded) {
-        if (this.$statusExpanded.get() !== expanded) {
-            this.$statusExpanded.set(expanded);
-            this.emitChange();
-        }
-    }
-    // ── Session setters ─────────────────────────────────────────────
-    // Every setter that affects screen resolution calls emitChange().
-    // Business logic calls these instead of mutating session directly.
-    /** Sets setupConfirmed. Gate resolves via _checkGates(). */
-    completeSetup() {
-        this.$session.setKey('setupConfirmed', true);
-        analytics.wizardCapture('setup confirmed', sessionProperties(this.session));
-        this.emitChange();
-    }
-    setRunPhase(phase) {
-        this.$session.setKey('runPhase', phase);
-        this.emitChange();
-    }
-    setCredentials(credentials) {
-        this.$session.setKey('credentials', credentials);
-        analytics.wizardCapture('auth complete', {
-            project_id: credentials?.projectId,
-        });
-        this.emitChange();
-    }
-    setFrameworkConfig(integration, config) {
-        this.$session.setKey('integration', integration);
-        this.$session.setKey('frameworkConfig', config);
-        this.$session.setKey('unsupportedVersion', null);
-        this.emitChange();
-    }
-    setDetectionComplete() {
-        this.$session.setKey('detectionComplete', true);
-        this.emitChange();
-    }
-    setDetectedFramework(label) {
-        this.$session.setKey('detectedFrameworkLabel', label);
-        this.emitChange();
-    }
-    setUnsupportedVersion(info) {
-        this.$session.setKey('unsupportedVersion', info);
-        this.emitChange();
-    }
-    setLoginUrl(url) {
-        this.$session.setKey('loginUrl', url);
-        this.emitChange();
-    }
-    setReadinessResult(result) {
-        this.$session.setKey('readinessResult', result);
-        this.emitChange();
-    }
-    /** User dismissed the blocking outage screen. Gate resolves via _checkGates(). */
-    dismissOutage() {
-        this.$session.setKey('outageDismissed', true);
-        this.emitChange();
-    }
-    /**
-     * Push the settings-override overlay and return a promise that blocks
-     * until the user dismisses it via backupAndFixSettingsOverride().
-     */
-    showSettingsOverride(conflicts, backupAndFix) {
-        const allKeys = conflicts.flatMap((c) => c.keys);
-        this.$session.setKey('settingsOverrideKeys', allKeys);
-        this.$session.setKey('settingsConflicts', conflicts);
-        this._backupAndFixSettings = backupAndFix;
-        const hasReadOnly = conflicts.some((c) => !c.writable);
-        if (hasReadOnly) {
-            this.pushOverlay(Overlay.ManagedSettings);
-        }
-        else {
-            this.pushOverlay(Overlay.SettingsOverride);
-        }
-        return new Promise((resolve) => {
-            this._resolveSettingsOverride = resolve;
-        });
-    }
-    /**
-     * Push the port-conflict overlay and return a promise that blocks
-     * until the user kills the blocking process or exits.
-     */
-    showPortConflict(processInfo) {
-        this.$session.setKey('portConflictProcess', processInfo);
-        this.pushOverlay(Overlay.PortConflict);
-        return new Promise((resolve) => {
-            this._resolvePortConflict = resolve;
-        });
-    }
-    /** Dismiss the port-conflict overlay after the user kills the process. */
-    resolvePortConflict() {
-        this.$session.setKey('portConflictProcess', null);
-        this.popOverlay();
-        this._resolvePortConflict?.();
-        this._resolvePortConflict = null;
-    }
-    /**
-     * Back up .claude/settings.json. Dismisses the overlay on success.
-     */
-    backupAndFixSettingsOverride() {
-        const ok = this._backupAndFixSettings?.() ?? false;
-        if (ok) {
-            this.$session.setKey('settingsOverrideKeys', null);
-            this.$session.setKey('settingsConflicts', null);
-            this.popOverlay();
-            this._resolveSettingsOverride?.();
-            this._resolveSettingsOverride = null;
-            this._backupAndFixSettings = null;
-        }
-        return ok;
-    }
-    /** Push the auth-error overlay (no dismiss — user must exit). */
-    showAuthError() {
-        this.pushOverlay(Overlay.AuthError);
-    }
-    addDiscoveredFeature(feature) {
-        if (!this.session.discoveredFeatures.includes(feature)) {
-            this.session.discoveredFeatures.push(feature);
-            this.emitChange();
-        }
-    }
-    /**
-     * Enable an additional feature: enqueue it for the stop hook
-     * and set any feature-specific session flags.
-     */
-    enableFeature(feature) {
-        if (!this.session.additionalFeatureQueue.includes(feature)) {
-            this.session.additionalFeatureQueue.push(feature);
-        }
-        // Feature-specific flags
-        if (feature === AdditionalFeature.LLM) {
-            this.session.llmOptIn = true;
-        }
-        analytics.wizardCapture('feature enabled', { feature });
-        this.emitChange();
-    }
-    setMcpComplete(outcome = McpOutcome.Skipped, installedClients = []) {
-        this.$session.setKey('mcpComplete', true);
-        this.$session.setKey('mcpOutcome', outcome);
-        this.$session.setKey('mcpInstalledClients', installedClients);
-        analytics.wizardCapture('mcp complete', {
-            mcp_outcome: outcome,
-            mcp_installed_clients: installedClients,
-            ...sessionProperties(this.session),
-        });
-        this.emitChange();
-    }
-    setSkillsComplete(kept) {
-        this.$session.setKey('skillsComplete', true);
-        analytics.wizardCapture('skills complete', {
-            skills_kept: kept,
-            ...sessionProperties(this.session),
-        });
-        this.emitChange();
-    }
-    setOutroDismissed() {
-        this.$session.setKey('outroDismissed', true);
-        this.emitChange();
-    }
-    setOutroData(data) {
-        this.$session.setKey('outroData', data);
-        this.emitChange();
-    }
-    setFrameworkContext(key, value) {
-        const ctx = { ...this.$session.get().frameworkContext, [key]: value };
-        this.$session.setKey('frameworkContext', ctx);
-        this.emitChange();
-    }
-    // ── Derived state ───────────────────────────────────────────────
-    /**
-     * The screen that should be rendered right now.
-     * Derived from session state via the router.
-     */
-    get currentScreen() {
-        return this.router.resolve(this.session);
-    }
-    /** Direction hint for screen transitions. */
-    get lastNavDirection() {
-        return this.router.lastNavDirection;
-    }
-    // ── Change notification ─────────────────────────────────────────
-    getVersion() {
-        return this.$version.get();
-    }
-    /**
-     * Notify React that state has changed.
-     * The router re-resolves the active screen on next render.
-     * Gate predicates are checked and resolved if ready.
-     */
-    emitChange() {
-        this.router._setDirection('push');
-        this.$version.set(this.$version.get() + 1);
-        this._checkGates();
-        this._detectTransition();
-    }
-    // ── Overlay navigation ──────────────────────────────────────────
-    pushOverlay(overlay) {
-        this.router._setDirection('push');
-        this.router.pushOverlay(overlay);
-        this.$version.set(this.$version.get() + 1);
-        this._detectTransition();
-    }
-    popOverlay() {
-        this.router._setDirection('pop');
-        this.router.popOverlay();
-        this.$version.set(this.$version.get() + 1);
-        this._detectTransition();
-    }
-    // ── Screen transition analytics ─────────────────────────────────
-    /**
-     * Register a callback to run when transitioning onto the given screen.
-     * Fires after every transition that lands on this screen.
-     */
-    onEnterScreen(screen, fn) {
-        const list = this._enterScreenHooks.get(screen) ?? [];
-        list.push(fn);
-        this._enterScreenHooks.set(screen, list);
-    }
-    /**
-     * Detect screen transitions, run enter-screen hooks, and fire analytics.
-     * Called at the end of emitChange/pushOverlay/popOverlay.
-     */
-    _detectTransition() {
-        const next = this.router.resolve(this.session);
-        const prev = this._lastScreen;
-        if (prev !== null && next !== prev) {
-            const hooks = this._enterScreenHooks.get(next);
-            if (hooks) {
-                for (const fn of hooks)
-                    fn();
-            }
-            analytics.wizardCapture(`screen ${next}`, {
-                from_screen: prev,
-                workflow: this.router.activeFlow,
-                ...sessionProperties(this.session),
-            });
-        }
-        this._lastScreen = next;
-    }
-    // ── Agent observation state ─────────────────────────────────────
-    pushStatus(message) {
-        const msgs = this.$statusMessages.get();
-        // Skip consecutive duplicate messages
-        if (msgs.length > 0 && msgs[msgs.length - 1] === message)
-            return;
-        this.$statusMessages.set([...msgs, message]);
-        this.emitChange();
-    }
-    setTasks(tasks) {
-        this.$tasks.set(tasks);
-        this.emitChange();
-    }
-    updateTask(index, done) {
-        const tasks = this.$tasks.get();
-        if (tasks[index]) {
-            const updated = [...tasks];
-            updated[index] = {
-                ...updated[index],
-                done,
-                status: done ? TaskStatus.Completed : TaskStatus.Pending,
-            };
-            this.$tasks.set(updated);
-            this.emitChange();
-        }
-    }
-    setEventPlan(events) {
-        this.$eventPlan.set(events);
-        this.emitChange();
-    }
-    get learnCardBlockIdx() {
-        return this.$learnCardBlockIdx.get();
-    }
-    setLearnCardBlockIdx(idx) {
-        this.$learnCardBlockIdx.set(idx);
-    }
-    get learnCardComplete() {
-        return this.$learnCardComplete.get();
-    }
-    setLearnCardComplete() {
-        this.$learnCardComplete.set(true);
-        this.emitChange();
-    }
-    syncTodos(todos) {
-        const incoming = todos.map((t) => ({
-            label: t.content,
-            activeForm: t.activeForm,
-            status: t.status || TaskStatus.Pending,
-            done: t.status === TaskStatus.Completed,
-        }));
-        const incomingLabels = new Set(incoming.map((t) => t.label));
-        const retained = this.$tasks
-            .get()
-            .filter((t) => t.done && !incomingLabels.has(t.label));
-        this.$tasks.set([...retained, ...incoming]);
-        this.emitChange();
-    }
-    // ── React integration ───────────────────────────────────────────
-    subscribe(callback) {
-        return this.$version.listen(() => callback());
-    }
-    getSnapshot() {
-        return this.$version.get();
-    }
-}
-//# sourceMappingURL=store.js.map

package/dist/src/ui/tui/store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../src/ui/tui/store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WizardStore — Nanostore-backed reactive store for the TUI.\n * React components subscribe via useSyncExternalStore.\n *\n * The active screen is derived from session state — WizardRouter walks\n * the flow and shows the first step whose `isComplete` is still false.\n *\n * Define a step `gate` if your screen needs to await user interactions.\n * bin.ts calls `await store.getGate(stepId)` to pause until the gate\n * predicate becomes true.\n *\n * All session mutations that affect screen resolution go through\n * explicit setters so emitChange() is always called.\n */\n\nimport { atom, map } from 'nanostores';\nimport { TaskStatus } from '../wizard-ui.js';\nimport {\n  type WizardSession,\n  type OutroData,\n  type DiscoveredFeature,\n  AdditionalFeature,\n  McpOutcome,\n  RunPhase,\n  buildSession,\n} from '../../lib/wizard-session.js';\nimport type { SettingsConflict } from '../../lib/agent/agent-interface.js';\nimport type { WizardReadinessResult } from '../../lib/health-checks/readiness.js';\nimport {\n  WizardRouter,\n  type ScreenName,\n  Screen,\n  Overlay,\n  Flow,\n} from './router.js';\nimport { analytics, sessionProperties } from '../../utils/analytics.js';\nimport type {\n  StoreInitContext,\n  WorkflowReadyContext,\n} from '../../lib/workflows/workflow-step.js';\nimport { WORKFLOW_STEPS } from './flows.js';\n\nexport { TaskStatus, Screen, Overlay, Flow, RunPhase, McpOutcome };\nexport type { ScreenName, OutroData, WizardSession };\n\nexport interface TaskItem {\n  label: string;\n  activeForm?: string;\n  status: TaskStatus;\n  /** Legacy compat */\n  done: boolean;\n}\n\nexport interface PlannedEvent {\n  name: string;\n  description: string;\n}\n\ninterface GateEntry {\n  predicate: (session: WizardSession) => boolean;\n  promise: Promise<void>;\n  resolve: () => void;\n  resolved: boolean;\n}\n\nexport class WizardStore {\n  // ── Internal nanostore atoms ─────────────────────────────────────\n  private $session = map<WizardSession>(buildSession({}));\n  private $statusMessages = atom<string[]>([]);\n  private $statusExpanded = atom(false);\n  private $tasks = atom<TaskItem[]>([]);\n  private $eventPlan = atom<PlannedEvent[]>([]);\n  private $learnCardBlockIdx = atom(0);\n  private $learnCardComplete = atom(false);\n  private $version = atom(0);\n\n  /** Last screen seen — used to detect screen transitions for analytics. */\n  private _lastScreen: ScreenName | null = null;\n\n  /** Hooks run when transitioning onto a screen. */\n  private _enterScreenHooks = new Map<ScreenName, (() => void)[]>();\n\n  /** Gate promises derived from workflow step definitions. */\n  private _gates = new Map<string, GateEntry>();\n\n  version = '';\n\n  /** Navigation router — resolves active screen from session state. */\n  readonly router: WizardRouter;\n\n  /** Blocks agent execution until the settings-override overlay is dismissed. */\n  private _resolveSettingsOverride: (() => void) | null = null;\n  private _backupAndFixSettings: (() => boolean) | null = null;\n\n  /** Blocks OAuth flow until the port-conflict overlay is dismissed. */\n  private _resolvePortConflict: (() => void) | null = null;\n\n  constructor(flow: Flow = Flow.PostHogIntegration) {\n    this.router = new WizardRouter(flow);\n    this._initFromWorkflow(flow);\n  }\n\n  /**\n   * Scan workflow steps for gate predicates and onInit callbacks.\n   * Creates gate promises and fires init work.\n   */\n  private _initFromWorkflow(flow: Flow): void {\n    const steps = WORKFLOW_STEPS[flow];\n    if (!steps) return;\n\n    // Create gate promises from steps that define them\n    for (const step of steps) {\n      if (step.gate) {\n        let resolve!: () => void;\n        const promise = new Promise<void>((r) => {\n          resolve = r;\n        });\n        this._gates.set(step.id, {\n          predicate: step.gate,\n          promise,\n          resolve,\n          resolved: false,\n        });\n      }\n    }\n\n    // Run onInit callbacks with a minimal context interface.\n    // Arrow functions capture `this` from _initFromWorkflow so we don't\n    // need to alias it.\n    const getSession = (): WizardSession => this.session;\n    const ctx: StoreInitContext = {\n      get session() {\n        return getSession();\n      },\n      setReadinessResult: (r) => this.setReadinessResult(r),\n      setFrameworkContext: (k, v) => this.setFrameworkContext(k, v),\n      emitChange: () => this.emitChange(),\n    };\n    for (const step of steps) {\n      step.onInit?.(ctx);\n    }\n  }\n\n  /**\n   * Run all `onReady` hooks declared by the current flow's steps, in\n   * order. Must be called after `store.session = session` so hooks see\n   * the real installDir. bin.ts calls this generically — it doesn't\n   * need to know which workflow has which pre-flow work.\n   */\n  async runReadyHooks(): Promise<void> {\n    const steps = WORKFLOW_STEPS[this.router.activeFlow];\n    if (!steps) return;\n    const ctx: WorkflowReadyContext = {\n      session: this.session,\n      setFrameworkContext: (k, v) => this.setFrameworkContext(k, v),\n      setFrameworkConfig: (i, c) => this.setFrameworkConfig(i, c),\n      setDetectedFramework: (l) => this.setDetectedFramework(l),\n      setUnsupportedVersion: (info) => this.setUnsupportedVersion(info),\n      addDiscoveredFeature: (f) => this.addDiscoveredFeature(f),\n      setDetectionComplete: () => this.setDetectionComplete(),\n    };\n    for (const step of steps) {\n      if (step.onReady) {\n        await step.onReady(ctx);\n      }\n    }\n  }\n\n  // ── Gate API ────────────────────────────────────────────────────\n\n  /**\n   * Get a gate promise by step ID — the primary blocking checkpoint API\n   * for bin.ts. `await store.getGate('...')` parks the caller until the\n   * corresponding workflow step's gate predicate flips to true (if the\n   * predicate stays false, the caller stays parked indefinitely — the\n   * TUI keeps rendering so the user can resolve whatever is blocking).\n   *\n   * If the workflow doesn't define a step with this ID, or the step\n   * has no `gate` predicate, this returns an already-resolved promise\n   * so bin.ts flows straight through. This lets workflows opt in to\n   * gates on a per-step basis without bin.ts needing to know which\n   * gates exist in which flow.\n   */\n  getGate(stepId: string): Promise<void> {\n    return this._gates.get(stepId)?.promise ?? Promise.resolve();\n  }\n\n  /**\n   * Re-evaluate every gate predicate against the current session and\n   * resolve any whose predicate now returns true. Called after every\n   * emitChange(), so gates unblock as soon as the session mutation\n   * that satisfies them lands. Gates only resolve once — a predicate\n   * that goes true → false → true will NOT re-block a caller that\n   * already awaited through.\n   */\n  private _checkGates(): void {\n    for (const [, gate] of this._gates) {\n      if (!gate.resolved && gate.predicate(this.session)) {\n        gate.resolved = true;\n        gate.resolve();\n      }\n    }\n  }\n\n  // ── State accessors (read from atoms) ────────────────────────────\n\n  get session(): WizardSession {\n    return this.$session.get();\n  }\n\n  set session(value: WizardSession) {\n    this.$session.set(value);\n    this.emitChange();\n  }\n\n  get statusMessages(): string[] {\n    return this.$statusMessages.get();\n  }\n\n  get tasks(): TaskItem[] {\n    return this.$tasks.get();\n  }\n\n  get eventPlan(): PlannedEvent[] {\n    return this.$eventPlan.get();\n  }\n\n  get statusExpanded(): boolean {\n    return this.$statusExpanded.get();\n  }\n\n  toggleStatusExpanded(): void {\n    this.$statusExpanded.set(!this.$statusExpanded.get());\n    this.emitChange();\n  }\n\n  setStatusExpanded(expanded: boolean): void {\n    if (this.$statusExpanded.get() !== expanded) {\n      this.$statusExpanded.set(expanded);\n      this.emitChange();\n    }\n  }\n\n  // ── Session setters ─────────────────────────────────────────────\n  // Every setter that affects screen resolution calls emitChange().\n  // Business logic calls these instead of mutating session directly.\n\n  /** Sets setupConfirmed. Gate resolves via _checkGates(). */\n  completeSetup(): void {\n    this.$session.setKey('setupConfirmed', true);\n    analytics.wizardCapture('setup confirmed', sessionProperties(this.session));\n    this.emitChange();\n  }\n\n  setRunPhase(phase: RunPhase): void {\n    this.$session.setKey('runPhase', phase);\n    this.emitChange();\n  }\n\n  setCredentials(credentials: WizardSession['credentials']): void {\n    this.$session.setKey('credentials', credentials);\n    analytics.wizardCapture('auth complete', {\n      project_id: credentials?.projectId,\n    });\n    this.emitChange();\n  }\n\n  setFrameworkConfig(\n    integration: WizardSession['integration'],\n    config: WizardSession['frameworkConfig'],\n  ): void {\n    this.$session.setKey('integration', integration);\n    this.$session.setKey('frameworkConfig', config);\n    this.$session.setKey('unsupportedVersion', null);\n    this.emitChange();\n  }\n\n  setDetectionComplete(): void {\n    this.$session.setKey('detectionComplete', true);\n    this.emitChange();\n  }\n\n  setDetectedFramework(label: string): void {\n    this.$session.setKey('detectedFrameworkLabel', label);\n    this.emitChange();\n  }\n\n  setUnsupportedVersion(info: {\n    current: string;\n    minimum: string;\n    docsUrl: string;\n  }): void {\n    this.$session.setKey('unsupportedVersion', info);\n    this.emitChange();\n  }\n\n  setLoginUrl(url: string | null): void {\n    this.$session.setKey('loginUrl', url);\n    this.emitChange();\n  }\n\n  setReadinessResult(result: WizardReadinessResult | null): void {\n    this.$session.setKey('readinessResult', result);\n    this.emitChange();\n  }\n\n  /** User dismissed the blocking outage screen. Gate resolves via _checkGates(). */\n  dismissOutage(): void {\n    this.$session.setKey('outageDismissed', true);\n    this.emitChange();\n  }\n\n  /**\n   * Push the settings-override overlay and return a promise that blocks\n   * until the user dismisses it via backupAndFixSettingsOverride().\n   */\n  showSettingsOverride(\n    conflicts: SettingsConflict[],\n    backupAndFix: () => boolean,\n  ): Promise<void> {\n    const allKeys = conflicts.flatMap((c) => c.keys);\n    this.$session.setKey('settingsOverrideKeys', allKeys);\n    this.$session.setKey('settingsConflicts', conflicts);\n    this._backupAndFixSettings = backupAndFix;\n\n    const hasReadOnly = conflicts.some((c) => !c.writable);\n    if (hasReadOnly) {\n      this.pushOverlay(Overlay.ManagedSettings);\n    } else {\n      this.pushOverlay(Overlay.SettingsOverride);\n    }\n\n    return new Promise((resolve) => {\n      this._resolveSettingsOverride = resolve;\n    });\n  }\n\n  /**\n   * Push the port-conflict overlay and return a promise that blocks\n   * until the user kills the blocking process or exits.\n   */\n  showPortConflict(processInfo: {\n    command: string;\n    pid: string;\n    user: string;\n  }): Promise<void> {\n    this.$session.setKey('portConflictProcess', processInfo);\n    this.pushOverlay(Overlay.PortConflict);\n    return new Promise((resolve) => {\n      this._resolvePortConflict = resolve;\n    });\n  }\n\n  /** Dismiss the port-conflict overlay after the user kills the process. */\n  resolvePortConflict(): void {\n    this.$session.setKey('portConflictProcess', null);\n    this.popOverlay();\n    this._resolvePortConflict?.();\n    this._resolvePortConflict = null;\n  }\n\n  /**\n   * Back up .claude/settings.json. Dismisses the overlay on success.\n   */\n  backupAndFixSettingsOverride(): boolean {\n    const ok = this._backupAndFixSettings?.() ?? false;\n    if (ok) {\n      this.$session.setKey('settingsOverrideKeys', null);\n      this.$session.setKey('settingsConflicts', null);\n      this.popOverlay();\n      this._resolveSettingsOverride?.();\n      this._resolveSettingsOverride = null;\n      this._backupAndFixSettings = null;\n    }\n    return ok;\n  }\n\n  /** Push the auth-error overlay (no dismiss — user must exit). */\n  showAuthError(): void {\n    this.pushOverlay(Overlay.AuthError);\n  }\n\n  addDiscoveredFeature(feature: DiscoveredFeature): void {\n    if (!this.session.discoveredFeatures.includes(feature)) {\n      this.session.discoveredFeatures.push(feature);\n      this.emitChange();\n    }\n  }\n\n  /**\n   * Enable an additional feature: enqueue it for the stop hook\n   * and set any feature-specific session flags.\n   */\n  enableFeature(feature: AdditionalFeature): void {\n    if (!this.session.additionalFeatureQueue.includes(feature)) {\n      this.session.additionalFeatureQueue.push(feature);\n    }\n    // Feature-specific flags\n    if (feature === AdditionalFeature.LLM) {\n      this.session.llmOptIn = true;\n    }\n    analytics.wizardCapture('feature enabled', { feature });\n    this.emitChange();\n  }\n\n  setMcpComplete(\n    outcome: McpOutcome = McpOutcome.Skipped,\n    installedClients: string[] = [],\n  ): void {\n    this.$session.setKey('mcpComplete', true);\n    this.$session.setKey('mcpOutcome', outcome);\n    this.$session.setKey('mcpInstalledClients', installedClients);\n    analytics.wizardCapture('mcp complete', {\n      mcp_outcome: outcome,\n      mcp_installed_clients: installedClients,\n      ...sessionProperties(this.session),\n    });\n    this.emitChange();\n  }\n\n  setSkillsComplete(kept: boolean): void {\n    this.$session.setKey('skillsComplete', true);\n    analytics.wizardCapture('skills complete', {\n      skills_kept: kept,\n      ...sessionProperties(this.session),\n    });\n    this.emitChange();\n  }\n\n  setOutroDismissed(): void {\n    this.$session.setKey('outroDismissed', true);\n    this.emitChange();\n  }\n\n  setOutroData(data: OutroData): void {\n    this.$session.setKey('outroData', data);\n    this.emitChange();\n  }\n\n  setFrameworkContext(key: string, value: unknown): void {\n    const ctx = { ...this.$session.get().frameworkContext, [key]: value };\n    this.$session.setKey('frameworkContext', ctx);\n    this.emitChange();\n  }\n\n  // ── Derived state ───────────────────────────────────────────────\n\n  /**\n   * The screen that should be rendered right now.\n   * Derived from session state via the router.\n   */\n  get currentScreen(): ScreenName {\n    return this.router.resolve(this.session);\n  }\n\n  /** Direction hint for screen transitions. */\n  get lastNavDirection(): 'push' | 'pop' | null {\n    return this.router.lastNavDirection;\n  }\n\n  // ── Change notification ─────────────────────────────────────────\n\n  getVersion(): number {\n    return this.$version.get();\n  }\n\n  /**\n   * Notify React that state has changed.\n   * The router re-resolves the active screen on next render.\n   * Gate predicates are checked and resolved if ready.\n   */\n  emitChange(): void {\n    this.router._setDirection('push');\n    this.$version.set(this.$version.get() + 1);\n    this._checkGates();\n    this._detectTransition();\n  }\n\n  // ── Overlay navigation ──────────────────────────────────────────\n\n  pushOverlay(overlay: Overlay): void {\n    this.router._setDirection('push');\n    this.router.pushOverlay(overlay);\n    this.$version.set(this.$version.get() + 1);\n    this._detectTransition();\n  }\n\n  popOverlay(): void {\n    this.router._setDirection('pop');\n    this.router.popOverlay();\n    this.$version.set(this.$version.get() + 1);\n    this._detectTransition();\n  }\n\n  // ── Screen transition analytics ─────────────────────────────────\n\n  /**\n   * Register a callback to run when transitioning onto the given screen.\n   * Fires after every transition that lands on this screen.\n   */\n  onEnterScreen(screen: ScreenName, fn: () => void): void {\n    const list = this._enterScreenHooks.get(screen) ?? [];\n    list.push(fn);\n    this._enterScreenHooks.set(screen, list);\n  }\n\n  /**\n   * Detect screen transitions, run enter-screen hooks, and fire analytics.\n   * Called at the end of emitChange/pushOverlay/popOverlay.\n   */\n  private _detectTransition(): void {\n    const next = this.router.resolve(this.session);\n    const prev = this._lastScreen;\n    if (prev !== null && next !== prev) {\n      const hooks = this._enterScreenHooks.get(next);\n      if (hooks) {\n        for (const fn of hooks) fn();\n      }\n      analytics.wizardCapture(`screen ${next}`, {\n        from_screen: prev,\n        workflow: this.router.activeFlow,\n        ...sessionProperties(this.session),\n      });\n    }\n    this._lastScreen = next;\n  }\n\n  // ── Agent observation state ─────────────────────────────────────\n\n  pushStatus(message: string): void {\n    const msgs = this.$statusMessages.get();\n    // Skip consecutive duplicate messages\n    if (msgs.length > 0 && msgs[msgs.length - 1] === message) return;\n    this.$statusMessages.set([...msgs, message]);\n    this.emitChange();\n  }\n\n  setTasks(tasks: TaskItem[]): void {\n    this.$tasks.set(tasks);\n    this.emitChange();\n  }\n\n  updateTask(index: number, done: boolean): void {\n    const tasks = this.$tasks.get();\n    if (tasks[index]) {\n      const updated = [...tasks];\n      updated[index] = {\n        ...updated[index],\n        done,\n        status: done ? TaskStatus.Completed : TaskStatus.Pending,\n      };\n      this.$tasks.set(updated);\n      this.emitChange();\n    }\n  }\n\n  setEventPlan(events: PlannedEvent[]): void {\n    this.$eventPlan.set(events);\n    this.emitChange();\n  }\n\n  get learnCardBlockIdx(): number {\n    return this.$learnCardBlockIdx.get();\n  }\n\n  setLearnCardBlockIdx(idx: number): void {\n    this.$learnCardBlockIdx.set(idx);\n  }\n\n  get learnCardComplete(): boolean {\n    return this.$learnCardComplete.get();\n  }\n\n  setLearnCardComplete(): void {\n    this.$learnCardComplete.set(true);\n    this.emitChange();\n  }\n\n  syncTodos(\n    todos: Array<{ content: string; status: string; activeForm?: string }>,\n  ): void {\n    const incoming = todos.map((t) => ({\n      label: t.content,\n      activeForm: t.activeForm,\n      status: (t.status as TaskStatus) || TaskStatus.Pending,\n      done: t.status === TaskStatus.Completed,\n    }));\n\n    const incomingLabels = new Set(incoming.map((t) => t.label));\n\n    const retained = this.$tasks\n      .get()\n      .filter((t) => t.done && !incomingLabels.has(t.label));\n\n    this.$tasks.set([...retained, ...incoming]);\n    this.emitChange();\n  }\n\n  // ── React integration ───────────────────────────────────────────\n\n  subscribe(callback: () => void): () => void {\n    return this.$version.listen(() => callback());\n  }\n\n  getSnapshot(): number {\n    return this.$version.get();\n  }\n}\n"]}

package/dist/src/ui/tui/styles.d.ts

@@ -1,32 +0,0 @@
-/**
- * Shared style constants for TUI layout primitives.
- */
-export declare enum HAlign {
-    Left = "flex-start",
-    Center = "center",
-    Right = "flex-end"
-}
-export declare enum VAlign {
-    Top = "flex-start",
-    Center = "center",
-    Bottom = "flex-end"
-}
-export declare const Colors: {
-    readonly primary: "cyan";
-    readonly accent: "#DC9300";
-    readonly titleColor: "#3D2800";
-    readonly success: "green";
-    readonly error: "red";
-    readonly muted: "gray";
-};
-export declare const Icons: {
-    readonly diamond: "◆";
-    readonly diamondOpen: "◇";
-    readonly check: "✔";
-    readonly warning: "⚠";
-    readonly squareFilled: "◼";
-    readonly squareOpen: "◻";
-    readonly triangleRight: "▶";
-    readonly triangleSmallRight: "▸";
-    readonly bullet: "•";
-};

package/dist/src/ui/tui/styles.js

@@ -1,35 +0,0 @@
-/**
- * Shared style constants for TUI layout primitives.
- */
-export var HAlign;
-(function (HAlign) {
-    HAlign["Left"] = "flex-start";
-    HAlign["Center"] = "center";
-    HAlign["Right"] = "flex-end";
-})(HAlign || (HAlign = {}));
-export var VAlign;
-(function (VAlign) {
-    VAlign["Top"] = "flex-start";
-    VAlign["Center"] = "center";
-    VAlign["Bottom"] = "flex-end";
-})(VAlign || (VAlign = {}));
-export const Colors = {
-    primary: 'cyan',
-    accent: '#DC9300',
-    titleColor: '#3D2800',
-    success: 'green',
-    error: 'red',
-    muted: 'gray',
-};
-export const Icons = {
-    diamond: '\u25C6',
-    diamondOpen: '\u25C7',
-    check: '\u2714',
-    warning: '\u26A0',
-    squareFilled: '\u25FC',
-    squareOpen: '\u25FB',
-    triangleRight: '\u25B6',
-    triangleSmallRight: '\u25B8',
-    bullet: '\u2022',
-};
-//# sourceMappingURL=styles.js.map

package/dist/src/ui/tui/styles.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../../src/ui/tui/styles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,MAIX;AAJD,WAAY,MAAM;IAChB,6BAAmB,CAAA;IACnB,2BAAiB,CAAA;IACjB,4BAAkB,CAAA;AACpB,CAAC,EAJW,MAAM,KAAN,MAAM,QAIjB;AAED,MAAM,CAAN,IAAY,MAIX;AAJD,WAAY,MAAM;IAChB,4BAAkB,CAAA;IAClB,2BAAiB,CAAA;IACjB,6BAAmB,CAAA;AACrB,CAAC,EAJW,MAAM,KAAN,MAAM,QAIjB;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,MAAM;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,QAAQ;IACrB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,QAAQ;IACjB,YAAY,EAAE,QAAQ;IACtB,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,QAAQ;IACvB,kBAAkB,EAAE,QAAQ;IAC5B,MAAM,EAAE,QAAQ;CACR,CAAC","sourcesContent":["/**\n * Shared style constants for TUI layout primitives.\n */\n\nexport enum HAlign {\n  Left = 'flex-start',\n  Center = 'center',\n  Right = 'flex-end',\n}\n\nexport enum VAlign {\n  Top = 'flex-start',\n  Center = 'center',\n  Bottom = 'flex-end',\n}\n\nexport const Colors = {\n  primary: 'cyan',\n  accent: '#DC9300',\n  titleColor: '#3D2800',\n  success: 'green',\n  error: 'red',\n  muted: 'gray',\n} as const;\n\nexport const Icons = {\n  diamond: '\\u25C6',\n  diamondOpen: '\\u25C7',\n  check: '\\u2714',\n  warning: '\\u26A0',\n  squareFilled: '\\u25FC',\n  squareOpen: '\\u25FB',\n  triangleRight: '\\u25B6',\n  triangleSmallRight: '\\u25B8',\n  bullet: '\\u2022',\n} as const;\n"]}