@posthog/wizard 1.36.1 → 2.0.0

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

@@ -0,0 +1,320 @@
+/**
+ * WizardStore — Nanostore-backed reactive store for the TUI.
+ * React components subscribe via useSyncExternalStore.
+ *
+ * Navigation is delegated to WizardRouter.
+ * The active screen is derived from session state — not imperatively set.
+ * Overlays (outage, etc.) are the only imperative navigation.
+ *
+ * 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';
+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();
+    version = '';
+    /** Navigation router — resolves active screen from session state. */
+    router;
+    /**
+     * Setup promise — IntroScreen resolves this when the user confirms.
+     * bin.ts awaits it before calling runWizard.
+     */
+    _resolveSetup;
+    setupComplete = new Promise((resolve) => {
+        this._resolveSetup = resolve;
+    });
+    /** Blocks agent execution until the settings-override overlay is dismissed. */
+    _resolveSettingsOverride = null;
+    _backupAndFixSettings = null;
+    constructor(flow = Flow.Wizard) {
+        this.router = new WizardRouter(flow);
+    }
+    // ── State accessors (read from atoms) ────────────────────────────
+    get session() {
+        return this.$session.get();
+    }
+    set session(value) {
+        this.$session.set(value);
+    }
+    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.
+    /** Unblocks bin.ts via the setupComplete promise. */
+    completeSetup() {
+        this.$session.setKey('setupConfirmed', true);
+        analytics.wizardCapture('setup confirmed', sessionProperties(this.session));
+        this._resolveSetup();
+        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.emitChange();
+    }
+    setDetectionComplete() {
+        this.$session.setKey('detectionComplete', true);
+        this.emitChange();
+    }
+    setDetectedFramework(label) {
+        this.$session.setKey('detectedFrameworkLabel', label);
+        this.emitChange();
+    }
+    setLoginUrl(url) {
+        this.$session.setKey('loginUrl', url);
+        this.emitChange();
+    }
+    setServiceStatus(status) {
+        this.$session.setKey('serviceStatus', status);
+        this.emitChange();
+    }
+    /**
+     * Push the settings-override overlay and return a promise that blocks
+     * until the user dismisses it via backupAndFixSettingsOverride().
+     */
+    showSettingsOverride(keys, backupAndFix) {
+        this.$session.setKey('settingsOverrideKeys', keys);
+        this._backupAndFixSettings = backupAndFix;
+        this.pushOverlay(Overlay.SettingsOverride);
+        return new Promise((resolve) => {
+            this._resolveSettingsOverride = resolve;
+        });
+    }
+    /**
+     * Back up .claude/settings.json. Dismisses the overlay on success.
+     */
+    backupAndFixSettingsOverride() {
+        const ok = this._backupAndFixSettings?.() ?? false;
+        if (ok) {
+            this.$session.setKey('settingsOverrideKeys', null);
+            this.popOverlay();
+            this._resolveSettingsOverride?.();
+            this._resolveSettingsOverride = null;
+            this._backupAndFixSettings = null;
+        }
+        return ok;
+    }
+    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();
+    }
+    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.
+     */
+    emitChange() {
+        this.router._setDirection('push');
+        this.$version.set(this.$version.get() + 1);
+        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,
+                ...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

@@ -0,0 +1 @@
+{"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 * Navigation is delegated to WizardRouter.\n * The active screen is derived from session state — not imperatively set.\n * Overlays (outage, etc.) are the only imperative navigation.\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 {\n  WizardRouter,\n  type ScreenName,\n  Screen,\n  Overlay,\n  Flow,\n} from './router.js';\nimport { analytics, sessionProperties } from '../../utils/analytics.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\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  version = '';\n\n  /** Navigation router — resolves active screen from session state. */\n  readonly router: WizardRouter;\n\n  /**\n   * Setup promise — IntroScreen resolves this when the user confirms.\n   * bin.ts awaits it before calling runWizard.\n   */\n  private _resolveSetup!: () => void;\n  readonly setupComplete: Promise<void> = new Promise((resolve) => {\n    this._resolveSetup = resolve;\n  });\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  constructor(flow: Flow = Flow.Wizard) {\n    this.router = new WizardRouter(flow);\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  }\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  /** Unblocks bin.ts via the setupComplete promise. */\n  completeSetup(): void {\n    this.$session.setKey('setupConfirmed', true);\n    analytics.wizardCapture('setup confirmed', sessionProperties(this.session));\n    this._resolveSetup();\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.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  setLoginUrl(url: string | null): void {\n    this.$session.setKey('loginUrl', url);\n    this.emitChange();\n  }\n\n  setServiceStatus(\n    status: { description: string; statusPageUrl: string } | null,\n  ): void {\n    this.$session.setKey('serviceStatus', status);\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    keys: string[],\n    backupAndFix: () => boolean,\n  ): Promise<void> {\n    this.$session.setKey('settingsOverrideKeys', keys);\n    this._backupAndFixSettings = backupAndFix;\n    this.pushOverlay(Overlay.SettingsOverride);\n    return new Promise((resolve) => {\n      this._resolveSettingsOverride = resolve;\n    });\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.popOverlay();\n      this._resolveSettingsOverride?.();\n      this._resolveSettingsOverride = null;\n      this._backupAndFixSettings = null;\n    }\n    return ok;\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  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   */\n  emitChange(): void {\n    this.router._setDirection('push');\n    this.$version.set(this.$version.get() + 1);\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        ...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

@@ -0,0 +1,31 @@
+/**
+ * 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: "#F54E00";
+    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

@@ -0,0 +1,34 @@
+/**
+ * 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: '#F54E00',
+    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

@@ -0,0 +1 @@
+{"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,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: '#F54E00',\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"]}

package/dist/src/ui/wizard-ui.d.ts

@@ -0,0 +1,64 @@
+/**
+ * WizardUI — abstraction layer for all user-facing operations.
+ *
+ * Business logic calls `getUI()` instead of importing the store directly.
+ * Implementations: InkUI (TUI), LoggingUI (CI).
+ *
+ * No prompt methods — the TUI screens own all user input.
+ * Session-mutating methods trigger reactive screen resolution in the TUI.
+ */
+export declare enum TaskStatus {
+    Pending = "pending",
+    InProgress = "in_progress",
+    Completed = "completed"
+}
+export interface SpinnerHandle {
+    start(message?: string): void;
+    stop(message?: string): void;
+    message(msg?: string): void;
+}
+export interface WizardUI {
+    intro(message: string): void;
+    outro(message: string): void;
+    cancel(message: string): void;
+    log: {
+        info(message: string): void;
+        warn(message: string): void;
+        error(message: string): void;
+        success(message: string): void;
+        step(message: string): void;
+    };
+    note(message: string): void;
+    pushStatus(message: string): void;
+    spinner(): SpinnerHandle;
+    /** Signal that the main work (agent run) has started. */
+    startRun(): void;
+    /** Store OAuth/API credentials. Resolves past AuthScreen in TUI. */
+    setCredentials(credentials: {
+        accessToken: string;
+        projectApiKey: string;
+        host: string;
+        projectId: number;
+    }): void;
+    /** Show service degradation (pushes outage overlay in TUI). */
+    showServiceStatus(data: {
+        description: string;
+        statusPageUrl: string;
+    }): void;
+    /** Warn that .claude/settings.json overrides blocking env vars (pushes blocking overlay in TUI). */
+    showSettingsOverride(keys: string[], backupAndFix: () => boolean): Promise<void>;
+    /** Set the detected framework label (e.g., "Django with Wagtail CMS") */
+    setDetectedFramework(label: string): void;
+    /** Register a callback to run when the TUI transitions onto the given screen. */
+    onEnterScreen(screen: string, fn: () => void): void;
+    setLoginUrl(url: string | null): void;
+    syncTodos(todos: Array<{
+        content: string;
+        status: string;
+        activeForm?: string;
+    }>): void;
+    setEventPlan(events: Array<{
+        name: string;
+        description: string;
+    }>): void;
+}

package/dist/src/ui/wizard-ui.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * WizardUI — abstraction layer for all user-facing operations.
+ *
+ * Business logic calls `getUI()` instead of importing the store directly.
+ * Implementations: InkUI (TUI), LoggingUI (CI).
+ *
+ * No prompt methods — the TUI screens own all user input.
+ * Session-mutating methods trigger reactive screen resolution in the TUI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskStatus = void 0;
+var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["Pending"] = "pending";
+    TaskStatus["InProgress"] = "in_progress";
+    TaskStatus["Completed"] = "completed";
+})(TaskStatus || (exports.TaskStatus = TaskStatus = {}));
+//# sourceMappingURL=wizard-ui.js.map

package/dist/src/ui/wizard-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-ui.js","sourceRoot":"","sources":["../../../src/ui/wizard-ui.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,wCAA0B,CAAA;IAC1B,qCAAuB,CAAA;AACzB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB","sourcesContent":["/**\n * WizardUI — abstraction layer for all user-facing operations.\n *\n * Business logic calls `getUI()` instead of importing the store directly.\n * Implementations: InkUI (TUI), LoggingUI (CI).\n *\n * No prompt methods — the TUI screens own all user input.\n * Session-mutating methods trigger reactive screen resolution in the TUI.\n */\n\nexport enum TaskStatus {\n  Pending = 'pending',\n  InProgress = 'in_progress',\n  Completed = 'completed',\n}\n\nexport interface SpinnerHandle {\n  start(message?: string): void;\n  stop(message?: string): void;\n  message(msg?: string): void;\n}\n\nexport interface WizardUI {\n  // ── Lifecycle messages ────────────────────────────────────────────\n  intro(message: string): void;\n  outro(message: string): void;\n  cancel(message: string): void;\n\n  // ── Logging ───────────────────────────────────────────────────────\n  log: {\n    info(message: string): void;\n    warn(message: string): void;\n    error(message: string): void;\n    success(message: string): void;\n    step(message: string): void;\n  };\n\n  note(message: string): void;\n  pushStatus(message: string): void;\n\n  // ── Spinner ───────────────────────────────────────────────────────\n  spinner(): SpinnerHandle;\n\n  // ── Session state (triggers reactive screen resolution in TUI) ────\n  /** Signal that the main work (agent run) has started. */\n  startRun(): void;\n\n  /** Store OAuth/API credentials. Resolves past AuthScreen in TUI. */\n  setCredentials(credentials: {\n    accessToken: string;\n    projectApiKey: string;\n    host: string;\n    projectId: number;\n  }): void;\n\n  /** Show service degradation (pushes outage overlay in TUI). */\n  showServiceStatus(data: { description: string; statusPageUrl: string }): void;\n\n  /** Warn that .claude/settings.json overrides blocking env vars (pushes blocking overlay in TUI). */\n  showSettingsOverride(\n    keys: string[],\n    backupAndFix: () => boolean,\n  ): Promise<void>;\n\n  // ── Display state ──────────────────────────────────────────────────\n  /** Set the detected framework label (e.g., \"Django with Wagtail CMS\") */\n  setDetectedFramework(label: string): void;\n\n  /** Register a callback to run when the TUI transitions onto the given screen. */\n  onEnterScreen(screen: string, fn: () => void): void;\n\n  setLoginUrl(url: string | null): void;\n\n  // ── Todo tracking from SDK TodoWrite events ───────────────────────\n  syncTodos(\n    todos: Array<{ content: string; status: string; activeForm?: string }>,\n  ): void;\n\n  // ── Event plan from .posthog-events.json ────────────────────\n  setEventPlan(events: Array<{ name: string; description: string }>): void;\n}\n"]}

package/dist/src/utils/__tests__/setup-utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/__tests__/{clack-utils.test.js → setup-utils.test.js}

@@ -33,28 +33,39 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-const clack_utils_1 = require("../clack-utils");
+const setup_utils_1 = require("../setup-utils");
 const ChildProcess = __importStar(require("node:child_process"));
 jest.mock('node:child_process', () => ({
     __esModule: true,
     ...jest.requireActual('node:child_process'),
 }));
-jest.mock('@clack/prompts', () => ({
-    log: {
-        info: jest.fn(),
-        success: jest.fn(),
-        warn: jest.fn(),
-        error: jest.fn(),
-    },
-    text: jest.fn(),
-    confirm: jest.fn(),
-    cancel: jest.fn(),
-    outro: jest.fn(),
-    // passthrough for abortIfCancelled
-    isCancel: jest.fn().mockReturnValue(false),
-    spinner: jest
-        .fn()
-        .mockImplementation(() => ({ start: jest.fn(), stop: jest.fn() })),
+jest.mock('../../ui', () => ({
+    getUI: jest.fn().mockReturnValue({
+        log: {
+            info: jest.fn(),
+            success: jest.fn(),
+            warn: jest.fn(),
+            error: jest.fn(),
+            step: jest.fn(),
+        },
+        cancel: jest.fn(),
+        outro: jest.fn(),
+        intro: jest.fn(),
+        spinner: jest.fn().mockImplementation(() => ({
+            start: jest.fn(),
+            stop: jest.fn(),
+            message: jest.fn(),
+        })),
+        setDetectedFramework: jest.fn(),
+        setCredentials: jest.fn(),
+        pushStatus: jest.fn(),
+        syncTodos: jest.fn(),
+        setLoginUrl: jest.fn(),
+        showServiceStatus: jest.fn(),
+        showSettingsOverride: jest.fn(),
+        startRun: jest.fn(),
+        note: jest.fn(),
+    }),
 }));
 describe.skip('installPackage', () => {
     afterEach(() => {
@@ -81,12 +92,11 @@ describe.skip('installPackage', () => {
                 cb(null, '', '');
             }
         });
-        await (0, clack_utils_1.installPackage)({
+        await (0, setup_utils_1.installPackage)({
             alreadyInstalled: false,
             packageName: 'posthog-js',
             packageNameDisplayLabel: 'posthog-js',
             forceInstall: true,
-            askBeforeUpdating: false,
             packageManager: packageManagerMock,
             installDir: process.cwd(),
         });
@@ -113,16 +123,15 @@ describe.skip('installPackage', () => {
                 cb(null, '', '');
             }
         });
-        await (0, clack_utils_1.installPackage)({
+        await (0, setup_utils_1.installPackage)({
             alreadyInstalled: false,
             packageName: 'posthog-js',
             packageNameDisplayLabel: 'posthog-js',
             forceInstall: flag,
-            askBeforeUpdating: false,
             packageManager: packageManagerMock,
             installDir: process.cwd(),
         });
         expect(execSpy).toHaveBeenCalledWith('npm install posthog-js  ', expect.any(Function));
     });
 });
-//# sourceMappingURL=clack-utils.test.js.map
+//# sourceMappingURL=setup-utils.test.js.map

package/dist/src/utils/__tests__/setup-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-utils.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/setup-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { installPackage } from '../setup-utils';\n\nimport * as ChildProcess from 'node:child_process';\nimport type { PackageManager } from '../package-manager';\n\njest.mock('node:child_process', () => ({\n  __esModule: true,\n  ...jest.requireActual('node:child_process'),\n}));\n\njest.mock('../../ui', () => ({\n  getUI: jest.fn().mockReturnValue({\n    log: {\n      info: jest.fn(),\n      success: jest.fn(),\n      warn: jest.fn(),\n      error: jest.fn(),\n      step: jest.fn(),\n    },\n    cancel: jest.fn(),\n    outro: jest.fn(),\n    intro: jest.fn(),\n    spinner: jest.fn().mockImplementation(() => ({\n      start: jest.fn(),\n      stop: jest.fn(),\n      message: jest.fn(),\n    })),\n    setDetectedFramework: jest.fn(),\n    setCredentials: jest.fn(),\n    pushStatus: jest.fn(),\n    syncTodos: jest.fn(),\n    setLoginUrl: jest.fn(),\n    showServiceStatus: jest.fn(),\n    showSettingsOverride: jest.fn(),\n    startRun: jest.fn(),\n    note: jest.fn(),\n  }),\n}));\n\ndescribe.skip('installPackage', () => {\n  afterEach(() => {\n    jest.clearAllMocks();\n  });\n\n  it('force-installs a package if the forceInstall flag is set', async () => {\n    const packageManagerMock: PackageManager = {\n      name: 'npm',\n      label: 'NPM',\n      installCommand: 'npm install',\n      buildCommand: 'npm run build',\n      runScriptCommand: 'npm run',\n      flags: '',\n      forceInstallFlag: '--force',\n      detect: jest.fn(),\n      addOverride: jest.fn(),\n    };\n\n    const execSpy = jest\n      .spyOn(ChildProcess, 'exec')\n      // @ts-expect-error - don't care about the return value\n      .mockImplementationOnce((cmd, cb) => {\n        if (cb) {\n          // @ts-expect-error - don't care about the options value\n          cb(null, '', '');\n        }\n      });\n\n    await installPackage({\n      alreadyInstalled: false,\n      packageName: 'posthog-js',\n      packageNameDisplayLabel: 'posthog-js',\n      forceInstall: true,\n      packageManager: packageManagerMock,\n      installDir: process.cwd(),\n    });\n\n    expect(execSpy).toHaveBeenCalledWith(\n      'npm install posthog-js  --force',\n      expect.any(Function),\n    );\n  });\n\n  it.each([false, undefined])(\n    \"doesn't force-install a package if the forceInstall flag is %s\",\n    async (flag) => {\n      const packageManagerMock: PackageManager = {\n        name: 'npm',\n        label: 'NPM',\n        installCommand: 'npm install',\n        buildCommand: 'npm run build',\n        runScriptCommand: 'npm run',\n        flags: '',\n        forceInstallFlag: '--force',\n        detect: jest.fn(),\n        addOverride: jest.fn(),\n      };\n\n      const execSpy = jest\n        .spyOn(ChildProcess, 'exec')\n        // @ts-expect-error - don't care about the return value\n        .mockImplementationOnce((cmd, cb) => {\n          if (cb) {\n            // @ts-expect-error - don't care about the options value\n            cb(null, '', '');\n          }\n        });\n\n      await installPackage({\n        alreadyInstalled: false,\n        packageName: 'posthog-js',\n        packageNameDisplayLabel: 'posthog-js',\n        forceInstall: flag,\n        packageManager: packageManagerMock,\n        installDir: process.cwd(),\n      });\n\n      expect(execSpy).toHaveBeenCalledWith(\n        'npm install posthog-js  ',\n        expect.any(Function),\n      );\n    },\n  );\n});\n"]}