@scotthamilton77/sidekick 0.0.2-alpha → 0.0.4-alpha

package/dist/bin.js

@@ -16699,6 +16699,72 @@ var require_hook_input = __commonJS({
   }
 });
 
+// ../types/dist/setup-status.js
+var require_setup_status = __commonJS({
+  "../types/dist/setup-status.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ProjectSetupStatusSchema = exports2.GitignoreStatusSchema = exports2.UserSetupStatusSchema = exports2.ProjectApiKeyHealthSchema = exports2.ApiKeyHealthSchema = void 0;
+    var zod_1 = require_zod();
+    exports2.ApiKeyHealthSchema = zod_1.z.enum([
+      "missing",
+      // Key needed but not found
+      "not-required",
+      // No LLM profiles configured for provider
+      "pending-validation",
+      // Key exists but not validated
+      "invalid",
+      // Validation failed
+      "healthy"
+      // Validation succeeded
+    ]);
+    exports2.ProjectApiKeyHealthSchema = zod_1.z.enum([
+      "missing",
+      "not-required",
+      "pending-validation",
+      "invalid",
+      "healthy",
+      "user"
+      // Deferring to user-level
+    ]);
+    exports2.UserSetupStatusSchema = zod_1.z.object({
+      version: zod_1.z.literal(1),
+      lastUpdatedAt: zod_1.z.string(),
+      // ISO timestamp
+      preferences: zod_1.z.object({
+        autoConfigureProjects: zod_1.z.boolean(),
+        defaultStatuslineScope: zod_1.z.enum(["user", "project"]),
+        defaultApiKeyScope: zod_1.z.enum(["user", "project", "skip"])
+      }),
+      statusline: zod_1.z.enum(["configured", "skipped"]),
+      apiKeys: zod_1.z.object({
+        OPENROUTER_API_KEY: exports2.ApiKeyHealthSchema,
+        OPENAI_API_KEY: exports2.ApiKeyHealthSchema
+      })
+    });
+    exports2.GitignoreStatusSchema = zod_1.z.enum([
+      "unknown",
+      // Setup hasn't checked yet (legacy projects)
+      "missing",
+      // User declined or entries not present
+      "installed"
+      // Sidekick section present in .gitignore
+    ]);
+    exports2.ProjectSetupStatusSchema = zod_1.z.object({
+      version: zod_1.z.literal(1),
+      lastUpdatedAt: zod_1.z.string(),
+      // ISO timestamp
+      autoConfigured: zod_1.z.boolean(),
+      statusline: zod_1.z.enum(["configured", "skipped", "user"]),
+      apiKeys: zod_1.z.object({
+        OPENROUTER_API_KEY: exports2.ProjectApiKeyHealthSchema,
+        OPENAI_API_KEY: exports2.ProjectApiKeyHealthSchema
+      }),
+      gitignore: exports2.GitignoreStatusSchema.optional().default("unknown")
+    });
+  }
+});
+
 // ../types/dist/index.js
 var require_dist = __commonJS({
   "../types/dist/index.js"(exports2) {
@@ -16729,6 +16795,7 @@ var require_dist = __commonJS({
     __exportStar(require_context(), exports2);
     __exportStar(require_tasks(), exports2);
     __exportStar(require_hook_input(), exports2);
+    __exportStar(require_setup_status(), exports2);
   }
 });
 
@@ -32722,7 +32789,10 @@ var require_package3 = __commonJS({
         lint: "eslint packages",
         "lint:fix": "eslint packages --fix",
         format: 'prettier --write "packages/**/*.ts"',
-        sidekick: "node packages/sidekick-cli/dist/bin.js"
+        sidekick: "node packages/sidekick-cli/dist/bin.js",
+        "test:dist:setup": "./scripts/test-dist.sh setup",
+        "test:dist:teardown": "./scripts/test-dist.sh teardown",
+        "test:dist:rebuild": "./scripts/test-dist.sh rebuild"
       },
       devDependencies: {
         "@eslint/js": "^9.39.1",
@@ -32785,15 +32855,7 @@ var require_daemon_client2 = __commonJS({
             await this.waitForShutdown();
           }
           this.logger.info("Starting daemon...");
-          let daemonPath;
-          try {
-            const pkgPath = require.resolve("@sidekick/daemon/package.json");
-            const pkg = require(pkgPath);
-            const binPath = pkg.bin ? typeof pkg.bin === "string" ? pkg.bin : pkg.bin["sidekickd"] : pkg.main;
-            daemonPath = path_1.default.resolve(path_1.default.dirname(pkgPath), binPath ?? "dist/index.js");
-          } catch {
-            daemonPath = path_1.default.resolve(__dirname, "../../sidekick-daemon/dist/index.js");
-          }
+          const daemonPath = await this.resolveDaemonPath();
           const child = (0, child_process_1.spawn)("node", [daemonPath, this.projectDir], {
             detached: true,
             stdio: "ignore",
@@ -32872,6 +32934,33 @@ var require_daemon_client2 = __commonJS({
         } catch {
         }
       }
+      /**
+       * Resolve the daemon entry point path.
+       * Checks in order:
+       * 1. Bundled context: daemon.js as sibling file (npm distribution)
+       * 2. Dev mode: workspace package resolution
+       */
+      async resolveDaemonPath() {
+        const bundledPath = path_1.default.resolve(__dirname, "daemon.js");
+        try {
+          await promises_12.default.access(bundledPath);
+          this.logger.debug("Using bundled daemon", { path: bundledPath });
+          return bundledPath;
+        } catch {
+        }
+        try {
+          const pkgPath = require.resolve("@sidekick/daemon/package.json");
+          const pkg = require(pkgPath);
+          const binPath = pkg.bin ? typeof pkg.bin === "string" ? pkg.bin : pkg.bin["sidekickd"] : pkg.main;
+          const daemonPath = path_1.default.resolve(path_1.default.dirname(pkgPath), binPath ?? "dist/index.js");
+          this.logger.debug("Using workspace daemon", { path: daemonPath });
+          return daemonPath;
+        } catch {
+          const fallbackPath = path_1.default.resolve(__dirname, "../../sidekick-daemon/dist/index.js");
+          this.logger.debug("Using fallback daemon path", { path: fallbackPath });
+          return fallbackPath;
+        }
+      }
       /**
        * Request daemon shutdown (fire-and-forget).
        * Sends shutdown request, receives ack, closes connection immediately.
@@ -33113,6 +33202,346 @@ var require_daemon_client2 = __commonJS({
   }
 });
 
+// ../sidekick-core/dist/setup-status-service.js
+var require_setup_status_service = __commonJS({
+  "../sidekick-core/dist/setup-status-service.js"(exports2) {
+    "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports2 && exports2.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports2 && exports2.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.SetupStatusService = void 0;
+    exports2.createSetupStatusService = createSetupStatusService;
+    var fs = __importStar(require("node:fs/promises"));
+    var path = __importStar(require("node:path"));
+    var os = __importStar(require("node:os"));
+    var types_1 = require_dist();
+    var SetupStatusService = class {
+      constructor(projectDir, options) {
+        this.projectDir = projectDir;
+        this.homeDir = options?.homeDir ?? os.homedir();
+        this.logger = options?.logger;
+      }
+      // === Paths ===
+      get userStatusPath() {
+        return path.join(this.homeDir, ".sidekick", "setup-status.json");
+      }
+      get projectStatusPath() {
+        return path.join(this.projectDir, ".sidekick", "setup-status.json");
+      }
+      // === Low-level read/write ===
+      async getUserStatus() {
+        try {
+          const content = await fs.readFile(this.userStatusPath, "utf-8");
+          const parsed = types_1.UserSetupStatusSchema.safeParse(JSON.parse(content));
+          if (!parsed.success) {
+            this.logger?.warn("Invalid user setup status", { error: parsed.error });
+            return null;
+          }
+          return parsed.data;
+        } catch (err) {
+          if (err.code === "ENOENT") {
+            return null;
+          }
+          throw err;
+        }
+      }
+      async getProjectStatus() {
+        try {
+          const content = await fs.readFile(this.projectStatusPath, "utf-8");
+          const parsed = types_1.ProjectSetupStatusSchema.safeParse(JSON.parse(content));
+          if (!parsed.success) {
+            this.logger?.warn("Invalid project setup status", { error: parsed.error });
+            return null;
+          }
+          return parsed.data;
+        } catch (err) {
+          if (err.code === "ENOENT") {
+            return null;
+          }
+          throw err;
+        }
+      }
+      async writeUserStatus(status) {
+        const validated = types_1.UserSetupStatusSchema.parse(status);
+        const dir = path.dirname(this.userStatusPath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(this.userStatusPath, JSON.stringify(validated, null, 2) + "\n");
+        this.logger?.debug("User setup status written", { path: this.userStatusPath });
+      }
+      async writeProjectStatus(status) {
+        const validated = types_1.ProjectSetupStatusSchema.parse(status);
+        const dir = path.dirname(this.projectStatusPath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(this.projectStatusPath, JSON.stringify(validated, null, 2) + "\n");
+        this.logger?.debug("Project setup status written", { path: this.projectStatusPath });
+      }
+      async updateUserStatus(updates) {
+        const current = await this.getUserStatus();
+        if (!current) {
+          throw new Error("Cannot update user status: no existing status found");
+        }
+        const updated = {
+          ...current,
+          ...updates,
+          lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        await this.writeUserStatus(updated);
+      }
+      async updateProjectStatus(updates) {
+        const current = await this.getProjectStatus();
+        if (!current) {
+          throw new Error("Cannot update project status: no existing status found");
+        }
+        const updated = {
+          ...current,
+          ...updates,
+          lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        await this.writeProjectStatus(updated);
+      }
+      // === Merged getters ===
+      async getStatuslineHealth() {
+        const project = await this.getProjectStatus();
+        if (project?.statusline === "configured")
+          return "configured";
+        if (project?.statusline === "skipped")
+          return "skipped";
+        if (project?.statusline === "user") {
+          const user2 = await this.getUserStatus();
+          return user2?.statusline ?? "not-setup";
+        }
+        const user = await this.getUserStatus();
+        return user?.statusline ?? "not-setup";
+      }
+      async getApiKeyHealth(key) {
+        const project = await this.getProjectStatus();
+        const projectHealth = project?.apiKeys[key];
+        if (projectHealth && projectHealth !== "user") {
+          return projectHealth;
+        }
+        const user = await this.getUserStatus();
+        return user?.apiKeys[key] ?? "missing";
+      }
+      async getEffectiveApiKeyHealth(key) {
+        const health = await this.getApiKeyHealth(key);
+        return health === "user" ? "missing" : health;
+      }
+      async isHealthy() {
+        const statusline = await this.getStatuslineHealth();
+        const openrouterKey = await this.getEffectiveApiKeyHealth("OPENROUTER_API_KEY");
+        return statusline === "configured" && (openrouterKey === "healthy" || openrouterKey === "not-required");
+      }
+      // === Auto-config helpers ===
+      async isUserSetupComplete() {
+        const user = await this.getUserStatus();
+        return user !== null;
+      }
+      async isProjectConfigured() {
+        const project = await this.getProjectStatus();
+        return project !== null;
+      }
+      async shouldAutoConfigureProject() {
+        const user = await this.getUserStatus();
+        if (!user?.preferences.autoConfigureProjects) {
+          return false;
+        }
+        return !await this.isProjectConfigured();
+      }
+      async setApiKeyHealth(key, health, scope) {
+        if (scope === "user") {
+          const current = await this.getUserStatus();
+          if (!current) {
+            throw new Error("Cannot update API key health: no user status found");
+          }
+          await this.updateUserStatus({
+            apiKeys: { ...current.apiKeys, [key]: health }
+          });
+        } else {
+          const current = await this.getProjectStatus();
+          if (!current) {
+            throw new Error("Cannot update API key health: no project status found");
+          }
+          await this.updateProjectStatus({
+            apiKeys: { ...current.apiKeys, [key]: health }
+          });
+        }
+      }
+      // === Backward compatibility (for statusline service) ===
+      /**
+       * Get the overall setup state for statusline display.
+       *
+       * - `not-run` - Setup has never been run
+       * - `partial` - User setup done, project not configured
+       * - `healthy` - All configured and working
+       * - `unhealthy` - Setup exists but has issues (invalid keys, etc)
+       */
+      async getSetupState() {
+        const userStatus = await this.getUserStatus();
+        const projectStatus = await this.getProjectStatus();
+        if (!userStatus) {
+          return "not-run";
+        }
+        if (!projectStatus) {
+          return "partial";
+        }
+        const isHealthy = await this.isHealthy();
+        return isHealthy ? "healthy" : "unhealthy";
+      }
+    };
+    exports2.SetupStatusService = SetupStatusService;
+    function createSetupStatusService(projectDir, homeDir) {
+      return new SetupStatusService(projectDir, { homeDir });
+    }
+  }
+});
+
+// ../sidekick-core/dist/gitignore.js
+var require_gitignore = __commonJS({
+  "../sidekick-core/dist/gitignore.js"(exports2) {
+    "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports2 && exports2.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports2 && exports2.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.GITIGNORE_ENTRIES = exports2.SIDEKICK_SECTION_END = exports2.SIDEKICK_SECTION_START = void 0;
+    exports2.installGitignoreSection = installGitignoreSection;
+    exports2.removeGitignoreSection = removeGitignoreSection;
+    exports2.detectGitignoreStatus = detectGitignoreStatus;
+    var fs = __importStar(require("node:fs/promises"));
+    var path = __importStar(require("node:path"));
+    exports2.SIDEKICK_SECTION_START = "# >>> sidekick";
+    exports2.SIDEKICK_SECTION_END = "# <<< sidekick";
+    exports2.GITIGNORE_ENTRIES = [
+      ".sidekick/logs/",
+      ".sidekick/sessions/",
+      ".sidekick/state/",
+      ".sidekick/.env",
+      ".sidekick/.env.local"
+    ];
+    async function installGitignoreSection(projectDir) {
+      const gitignorePath = path.join(projectDir, ".gitignore");
+      let content = "";
+      try {
+        content = await fs.readFile(gitignorePath, "utf-8");
+      } catch (err) {
+        if (err.code !== "ENOENT") {
+          return { status: "error", error: `Failed to read .gitignore: ${err.message}` };
+        }
+      }
+      if (content.includes(exports2.SIDEKICK_SECTION_START)) {
+        return { status: "already-installed" };
+      }
+      const section = ["", exports2.SIDEKICK_SECTION_START, ...exports2.GITIGNORE_ENTRIES, exports2.SIDEKICK_SECTION_END].join("\n");
+      const newContent = content.trimEnd() + section + "\n";
+      try {
+        await fs.writeFile(gitignorePath, newContent);
+        return { status: "installed", entriesAdded: exports2.GITIGNORE_ENTRIES };
+      } catch (err) {
+        return { status: "error", error: `Failed to write .gitignore: ${err.message}` };
+      }
+    }
+    async function removeGitignoreSection(projectDir) {
+      const gitignorePath = path.join(projectDir, ".gitignore");
+      try {
+        const content = await fs.readFile(gitignorePath, "utf-8");
+        const startIdx = content.indexOf(exports2.SIDEKICK_SECTION_START);
+        const endIdx = content.indexOf(exports2.SIDEKICK_SECTION_END);
+        if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+          return false;
+        }
+        const lineStartIdx = content.lastIndexOf("\n", startIdx - 1) + 1;
+        const lineEndIdx = content.indexOf("\n", endIdx);
+        const actualEndIdx = lineEndIdx === -1 ? content.length : lineEndIdx + 1;
+        const before = content.slice(0, lineStartIdx).trimEnd();
+        const after = content.slice(actualEndIdx).trimStart();
+        const newContent = before + (after ? "\n" + after : "") + "\n";
+        await fs.writeFile(gitignorePath, newContent);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    async function detectGitignoreStatus(projectDir) {
+      const gitignorePath = path.join(projectDir, ".gitignore");
+      try {
+        const content = await fs.readFile(gitignorePath, "utf-8");
+        return content.includes(exports2.SIDEKICK_SECTION_START) ? "installed" : "missing";
+      } catch {
+        return "missing";
+      }
+    }
+  }
+});
+
 // ../sidekick-core/dist/state/errors.js
 var require_errors4 = __commonJS({
   "../sidekick-core/dist/state/errors.js"(exports2) {
@@ -38303,8 +38732,8 @@ var require_dist3 = __commonJS({
       for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports3, p)) __createBinding(exports3, m, p);
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.HandlerRegistryImpl = exports2.extractConsumedTimestamp = exports2.createConsumedFilePattern = exports2.CONSUMED_FILE_PATTERN = exports2.filterActiveReminderFiles = exports2.validatePathSegment = exports2.isValidPathSegment = exports2.getReminderPath = exports2.getHookDir = exports2.getStagingRoot = exports2.SessionScopedStagingService = exports2.StagingServiceCore = exports2.DaemonClient = exports2.killAllDaemons = exports2.logEvent = exports2.LogEvents = exports2.getComponentLogLevel = exports2.setupGlobalErrorHandlers = exports2.createLoggerFacade = exports2.createLogManager = exports2.createConsoleLogger = exports2.getUserDaemonsDir = exports2.getUserPidPath = exports2.getTokenPath = exports2.getSocketPath = exports2.getProjectHash = exports2.getPidPath = exports2.getLockPath = exports2.IpcService = exports2.IpcServer = exports2.loadPersonaFile = exports2.getDefaultPersonasDir = exports2.discoverPersonas = exports2.createPersonaLoader = exports2.reconstructTranscriptPath = exports2.encodeProjectPath = exports2.isPreCompactEvent = exports2.isStopEvent = exports2.isPostToolUseEvent = exports2.isPreToolUseEvent = exports2.isUserPromptSubmitEvent = exports2.isSessionEndEvent = exports2.isSessionStartEvent = exports2.isTranscriptEvent = exports2.isHookEvent = exports2.MetricsPersistPayloadSchema = exports2.CleanupPayloadSchema = exports2.ResumeGenerationPayloadSchema = exports2.SessionSummaryPayloadSchema = exports2.TaskTypes = void 0;
-    exports2.DaemonGlobalLogMetricsDescriptor = exports2.CliLogMetricsDescriptor = exports2.DaemonLogMetricsDescriptor = exports2.CompactionHistoryDescriptor = exports2.TranscriptMetricsDescriptor = exports2.GlobalStateAccessor = exports2.SessionStateAccessor = exports2.globalState = exports2.sessionState = exports2.StateCorruptError = exports2.StateNotFoundError = exports2.StateService = exports2.createHookableLogger = exports2.InstrumentedProfileProviderFactory = exports2.InstrumentedLLMProvider = exports2.ServiceFactoryImpl = exports2.TranscriptServiceImpl = exports2.createDefaultTokenUsage = exports2.createDefaultMetrics = exports2.copyWithTimestampSync = exports2.renameWithTimestampSync = exports2.renameWithTimestamp = exports2.copyWithTimestamp = exports2.getTimestampedPath = exports2.extractToolResultPreview = exports2.extractToolCallPreview = exports2.extractTextFromContent = exports2.extractContentPreview = void 0;
+    exports2.getHookDir = exports2.getStagingRoot = exports2.SessionScopedStagingService = exports2.StagingServiceCore = exports2.GITIGNORE_ENTRIES = exports2.SIDEKICK_SECTION_END = exports2.SIDEKICK_SECTION_START = exports2.detectGitignoreStatus = exports2.removeGitignoreSection = exports2.installGitignoreSection = exports2.createSetupStatusService = exports2.SetupStatusService = exports2.DaemonClient = exports2.killAllDaemons = exports2.logEvent = exports2.LogEvents = exports2.getComponentLogLevel = exports2.setupGlobalErrorHandlers = exports2.createLoggerFacade = exports2.createLogManager = exports2.createConsoleLogger = exports2.getUserDaemonsDir = exports2.getUserPidPath = exports2.getTokenPath = exports2.getSocketPath = exports2.getProjectHash = exports2.getPidPath = exports2.getLockPath = exports2.IpcService = exports2.IpcServer = exports2.loadPersonaFile = exports2.getDefaultPersonasDir = exports2.discoverPersonas = exports2.createPersonaLoader = exports2.reconstructTranscriptPath = exports2.encodeProjectPath = exports2.isPreCompactEvent = exports2.isStopEvent = exports2.isPostToolUseEvent = exports2.isPreToolUseEvent = exports2.isUserPromptSubmitEvent = exports2.isSessionEndEvent = exports2.isSessionStartEvent = exports2.isTranscriptEvent = exports2.isHookEvent = exports2.MetricsPersistPayloadSchema = exports2.CleanupPayloadSchema = exports2.ResumeGenerationPayloadSchema = exports2.SessionSummaryPayloadSchema = exports2.TaskTypes = void 0;
+    exports2.DaemonGlobalLogMetricsDescriptor = exports2.CliLogMetricsDescriptor = exports2.DaemonLogMetricsDescriptor = exports2.CompactionHistoryDescriptor = exports2.TranscriptMetricsDescriptor = exports2.GlobalStateAccessor = exports2.SessionStateAccessor = exports2.globalState = exports2.sessionState = exports2.StateCorruptError = exports2.StateNotFoundError = exports2.StateService = exports2.createHookableLogger = exports2.InstrumentedProfileProviderFactory = exports2.InstrumentedLLMProvider = exports2.ServiceFactoryImpl = exports2.TranscriptServiceImpl = exports2.createDefaultTokenUsage = exports2.createDefaultMetrics = exports2.copyWithTimestampSync = exports2.renameWithTimestampSync = exports2.renameWithTimestamp = exports2.copyWithTimestamp = exports2.getTimestampedPath = exports2.extractToolResultPreview = exports2.extractToolCallPreview = exports2.extractTextFromContent = exports2.extractContentPreview = exports2.HandlerRegistryImpl = exports2.extractConsumedTimestamp = exports2.createConsumedFilePattern = exports2.CONSUMED_FILE_PATTERN = exports2.filterActiveReminderFiles = exports2.validatePathSegment = exports2.isValidPathSegment = exports2.getReminderPath = void 0;
     var types_1 = require_dist();
     Object.defineProperty(exports2, "TaskTypes", { enumerable: true, get: function() {
       return types_1.TaskTypes;
@@ -38437,6 +38866,32 @@ var require_dist3 = __commonJS({
     Object.defineProperty(exports2, "DaemonClient", { enumerable: true, get: function() {
       return daemon_client_1.DaemonClient;
     } });
+    var setup_status_service_1 = require_setup_status_service();
+    Object.defineProperty(exports2, "SetupStatusService", { enumerable: true, get: function() {
+      return setup_status_service_1.SetupStatusService;
+    } });
+    Object.defineProperty(exports2, "createSetupStatusService", { enumerable: true, get: function() {
+      return setup_status_service_1.createSetupStatusService;
+    } });
+    var gitignore_1 = require_gitignore();
+    Object.defineProperty(exports2, "installGitignoreSection", { enumerable: true, get: function() {
+      return gitignore_1.installGitignoreSection;
+    } });
+    Object.defineProperty(exports2, "removeGitignoreSection", { enumerable: true, get: function() {
+      return gitignore_1.removeGitignoreSection;
+    } });
+    Object.defineProperty(exports2, "detectGitignoreStatus", { enumerable: true, get: function() {
+      return gitignore_1.detectGitignoreStatus;
+    } });
+    Object.defineProperty(exports2, "SIDEKICK_SECTION_START", { enumerable: true, get: function() {
+      return gitignore_1.SIDEKICK_SECTION_START;
+    } });
+    Object.defineProperty(exports2, "SIDEKICK_SECTION_END", { enumerable: true, get: function() {
+      return gitignore_1.SIDEKICK_SECTION_END;
+    } });
+    Object.defineProperty(exports2, "GITIGNORE_ENTRIES", { enumerable: true, get: function() {
+      return gitignore_1.GITIGNORE_ENTRIES;
+    } });
     var staging_service_1 = require_staging_service();
     Object.defineProperty(exports2, "StagingServiceCore", { enumerable: true, get: function() {
       return staging_service_1.StagingServiceCore;
@@ -51116,6 +51571,10 @@ var require_statusline_service = __commonJS({
           theme: this.config.theme,
           useColors: this.useColors
         });
+        this.setupService = serviceConfig.setupService ?? new core_1.SetupStatusService(serviceConfig.projectDir ?? serviceConfig.cwd, {
+          homeDir: serviceConfig.homeDir,
+          logger: serviceConfig.logger
+        });
       }
       /**
        * Load persona definition for the session.
@@ -51205,6 +51664,74 @@ var require_statusline_service = __commonJS({
         }
         return { ...types_js_2.DEFAULT_STATUSLINE_CONFIG, ...serviceConfig.config };
       }
+      /**
+       * Check setup status and return warning message if unhealthy.
+       * Returns empty warning for healthy state.
+       */
+      async checkSetupStatus() {
+        const state = await this.setupService.getSetupState();
+        switch (state) {
+          case "not-run":
+            return {
+              warning: "Sidekick not configured. Run 'sidekick setup' to get started.",
+              state
+            };
+          case "partial":
+            return {
+              warning: "Project not configured. Run 'sidekick setup' for this project.",
+              state
+            };
+          case "unhealthy": {
+            const keyHealth = await this.setupService.getEffectiveApiKeyHealth("OPENROUTER_API_KEY");
+            if (keyHealth === "missing") {
+              return {
+                warning: "OPENROUTER_API_KEY not found. Run 'sidekick doctor' or /sidekick-config",
+                state
+              };
+            }
+            if (keyHealth === "invalid") {
+              return {
+                warning: "API key invalid. Run 'sidekick doctor' to fix.",
+                state
+              };
+            }
+            return {
+              warning: "Setup issue detected. Run 'sidekick doctor'.",
+              state
+            };
+          }
+          default:
+            return { warning: "", state: "healthy" };
+        }
+      }
+      /**
+       * Build minimal view model for setup_warning display mode.
+       * Only includes fields needed for warning display.
+       */
+      buildMinimalViewModel(setupCheck) {
+        return {
+          model: "",
+          contextWindow: "",
+          tokenUsageActual: "",
+          tokenUsageEffective: "",
+          tokenPercentageActual: "",
+          tokenPercentageEffective: "",
+          tokensStatus: "normal",
+          cost: "",
+          costStatus: "normal",
+          duration: "",
+          cwd: "",
+          branch: "",
+          branchColor: "",
+          displayMode: "setup_warning",
+          summary: setupCheck.warning,
+          title: "",
+          warningCount: 0,
+          errorCount: 0,
+          logStatus: "normal",
+          personaName: ""
+        };
+      }
       /**
        * Render the statusline by fetching all data in parallel and formatting.
        *
@@ -51214,6 +51741,19 @@ var require_statusline_service = __commonJS({
        * for model/tokens/cost/duration instead of reading from state files.
        */
       async render() {
+        const setupCheck = await this.checkSetupStatus();
+        if (setupCheck.state !== "healthy") {
+          const viewModel2 = this.buildMinimalViewModel(setupCheck);
+          const ANSI_YELLOW = "\x1B[33m";
+          const ANSI_RESET = "\x1B[0m";
+          const text2 = this.useColors ? `${ANSI_YELLOW}${setupCheck.warning}${ANSI_RESET}` : setupCheck.warning;
+          return {
+            text: text2,
+            displayMode: "setup_warning",
+            staleData: false,
+            viewModel: viewModel2
+          };
+        }
         const hasHookInput = !!this.hookInput;
         const [transcriptResult, summaryResult, resumeResult, snarkyResult, branchResult, baseline, logMetricsResult, personaResult] = await Promise.all([
           this.stateReader.getTranscriptMetrics(),
@@ -53005,6 +53545,582 @@ ${USAGE_TEXT}`);
   }
 });
 
+// ../sidekick-cli/dist/commands/setup/prompts.js
+var require_prompts = __commonJS({
+  "../sidekick-cli/dist/commands/setup/prompts.js"(exports2) {
+    "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports2 && exports2.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports2 && exports2.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.printHeader = printHeader;
+    exports2.printStatus = printStatus;
+    exports2.promptSelect = promptSelect;
+    exports2.promptConfirm = promptConfirm;
+    exports2.promptInput = promptInput;
+    var readline = __importStar(require("node:readline"));
+    var colors = {
+      reset: "\x1B[0m",
+      bold: "\x1B[1m",
+      dim: "\x1B[2m",
+      green: "\x1B[32m",
+      yellow: "\x1B[33m",
+      blue: "\x1B[34m",
+      cyan: "\x1B[36m"
+    };
+    function printHeader(ctx, title, description) {
+      ctx.stdout.write("\n");
+      ctx.stdout.write(`${colors.bold}${title}${colors.reset}
+`);
+      ctx.stdout.write("\u2500".repeat(Math.min(title.length + 10, 60)) + "\n");
+      if (description) {
+        ctx.stdout.write(`${colors.dim}${description}${colors.reset}
+`);
+      }
+      ctx.stdout.write("\n");
+    }
+    function printStatus(ctx, type, message) {
+      const icons = { success: "\u2713", warning: "\u26A0", info: "\u2022", error: "\u2717" };
+      const colorMap = { success: colors.green, warning: colors.yellow, info: colors.blue, error: "\x1B[31m" };
+      ctx.stdout.write(`${colorMap[type]}${icons[type]}${colors.reset} ${message}
+`);
+    }
+    async function promptSelect(ctx, question, options) {
+      ctx.stdout.write(`${question}
+
+`);
+      options.forEach((opt, i) => {
+        ctx.stdout.write(`  ${colors.cyan}${i + 1})${colors.reset} ${opt.label}
+`);
+        if (opt.description) {
+          ctx.stdout.write(`     ${colors.dim}${opt.description}${colors.reset}
+`);
+        }
+      });
+      ctx.stdout.write("\n");
+      const rl = readline.createInterface({
+        input: ctx.stdin,
+        output: ctx.stdout,
+        terminal: false
+      });
+      return new Promise((resolve3) => {
+        ctx.stdout.write(`Enter choice (1-${options.length}): `);
+        rl.once("line", (answer) => {
+          rl.close();
+          const num = parseInt(answer.trim(), 10);
+          if (num >= 1 && num <= options.length) {
+            resolve3(options[num - 1].value);
+          } else {
+            resolve3(options[0].value);
+          }
+        });
+      });
+    }
+    async function promptConfirm(ctx, question, defaultYes = true) {
+      const hint = defaultYes ? "[Y/n]" : "[y/N]";
+      const rl = readline.createInterface({
+        input: ctx.stdin,
+        output: ctx.stdout,
+        terminal: false
+      });
+      return new Promise((resolve3) => {
+        ctx.stdout.write(`${question} ${hint} `);
+        rl.once("line", (answer) => {
+          rl.close();
+          const normalized = answer.trim().toLowerCase();
+          if (normalized === "") {
+            resolve3(defaultYes);
+          } else {
+            resolve3(normalized === "y" || normalized === "yes");
+          }
+        });
+      });
+    }
+    async function promptInput(ctx, question) {
+      const rl = readline.createInterface({
+        input: ctx.stdin,
+        output: ctx.stdout,
+        terminal: false
+      });
+      return new Promise((resolve3) => {
+        ctx.stdout.write(`${question}: `);
+        rl.once("line", (answer) => {
+          rl.close();
+          resolve3(answer.trim());
+        });
+      });
+    }
+  }
+});
+
+// ../sidekick-cli/dist/commands/setup/validate-api-key.js
+var require_validate_api_key = __commonJS({
+  "../sidekick-cli/dist/commands/setup/validate-api-key.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.validateOpenRouterKey = validateOpenRouterKey;
+    exports2.validateOpenAIKey = validateOpenAIKey;
+    var API_ENDPOINTS = {
+      openrouter: "https://openrouter.ai/api/v1/models",
+      openai: "https://api.openai.com/v1/models"
+    };
+    async function validateApiKey(provider, apiKey, logger) {
+      try {
+        const response = await fetch(API_ENDPOINTS[provider], {
+          headers: { Authorization: `Bearer ${apiKey}` }
+        });
+        if (response.ok) {
+          return { valid: true };
+        }
+        if (response.status === 401) {
+          return { valid: false, error: "Invalid API key" };
+        }
+        return { valid: false, error: `API returned status ${response.status}` };
+      } catch (err) {
+        logger?.warn("API key validation failed", { error: err });
+        return { valid: false, error: err instanceof Error ? err.message : "Network error" };
+      }
+    }
+    function validateOpenRouterKey(apiKey, logger) {
+      return validateApiKey("openrouter", apiKey, logger);
+    }
+    function validateOpenAIKey(apiKey, logger) {
+      return validateApiKey("openai", apiKey, logger);
+    }
+  }
+});
+
+// ../sidekick-cli/dist/commands/setup/index.js
+var require_setup = __commonJS({
+  "../sidekick-cli/dist/commands/setup/index.js"(exports2) {
+    "use strict";
+    var __createBinding = exports2 && exports2.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports2 && exports2.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports2 && exports2.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.handleSetupCommand = handleSetupCommand;
+    var fs = __importStar(require("node:fs/promises"));
+    var path = __importStar(require("node:path"));
+    var os = __importStar(require("node:os"));
+    var core_1 = require_dist3();
+    var prompts_js_1 = require_prompts();
+    var validate_api_key_js_1 = require_validate_api_key();
+    var STATUSLINE_COMMAND = "npx @scotthamilton77/sidekick statusline --project-dir=$CLAUDE_PROJECT_DIR";
+    function getApiKeyStatusType(health) {
+      switch (health) {
+        case "healthy":
+          return "success";
+        case "not-required":
+          return "info";
+        default:
+          return "warning";
+      }
+    }
+    async function configureStatusline(settingsPath, logger) {
+      let settings = {};
+      try {
+        const content = await fs.readFile(settingsPath, "utf-8");
+        settings = JSON.parse(content);
+      } catch (err) {
+        if (err.code !== "ENOENT") {
+          throw err;
+        }
+      }
+      settings.statusLine = {
+        type: "command",
+        command: STATUSLINE_COMMAND
+      };
+      const dir = path.dirname(settingsPath);
+      await fs.mkdir(dir, { recursive: true });
+      await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+      logger?.info("Statusline configured", { path: settingsPath });
+    }
+    async function writeApiKeyToEnv(envPath, key, value) {
+      const dir = path.dirname(envPath);
+      await fs.mkdir(dir, { recursive: true });
+      let content = "";
+      try {
+        content = await fs.readFile(envPath, "utf-8");
+      } catch {
+      }
+      const keyRegex = new RegExp(`^${key}=.*$`, "m");
+      if (keyRegex.test(content)) {
+        content = content.replace(keyRegex, `${key}=${value}`);
+      } else {
+        if (content && !content.endsWith("\n")) {
+          content += "\n";
+        }
+        content += `${key}=${value}
+`;
+      }
+      await fs.writeFile(envPath, content);
+    }
+    async function findExistingApiKey(keyName, homeDir, projectDir) {
+      if (process.env[keyName]) {
+        return process.env[keyName];
+      }
+      const envPaths = [
+        path.join(homeDir, ".sidekick", ".env"),
+        path.join(projectDir, ".sidekick", ".env"),
+        path.join(projectDir, ".sidekick", ".env.local")
+      ];
+      for (const envPath of envPaths) {
+        try {
+          const content = await fs.readFile(envPath, "utf-8");
+          const match = content.match(new RegExp(`^${keyName}=(.+)$`, "m"));
+          if (match) {
+            return match[1];
+          }
+        } catch {
+        }
+      }
+      return null;
+    }
+    async function writePersonaConfig(_projectDir, homeDir, enabled) {
+      const configDir = path.join(homeDir, ".sidekick");
+      const configPath = path.join(configDir, "config.yaml");
+      await fs.mkdir(configDir, { recursive: true });
+      let content = "";
+      try {
+        content = await fs.readFile(configPath, "utf-8");
+      } catch {
+      }
+      const personasRegex = /^features:\s*\n\s*personas:\s*\n\s*enabled:\s*(true|false)/m;
+      const newPersonasBlock = `features:
+  personas:
+    enabled: ${enabled}`;
+      if (personasRegex.test(content)) {
+        content = content.replace(personasRegex, newPersonasBlock);
+      } else {
+        if (content && !content.endsWith("\n")) {
+          content += "\n";
+        }
+        content += newPersonasBlock + "\n";
+      }
+      await fs.writeFile(configPath, content);
+    }
+    function printWizardHeader(stdout) {
+      stdout.write("\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n");
+      stdout.write("\u2502  Sidekick Setup Wizard                                  \u2502\n");
+      stdout.write("\u2502                                                         \u2502\n");
+      stdout.write("\u2502  This wizard configures sidekick for Claude Code.       \u2502\n");
+      stdout.write("\u2502  Run 'sidekick setup' again anytime to reconfigure.     \u2502\n");
+      stdout.write("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n");
+    }
+    async function runStep1Statusline(wctx) {
+      const { ctx, homeDir, projectDir, logger } = wctx;
+      (0, prompts_js_1.printHeader)(ctx, "Step 1: Statusline Configuration", "Claude Code plugins cannot provide statusline config directly.");
+      const statuslineScope = await (0, prompts_js_1.promptSelect)(ctx, "Where should sidekick configure your statusline?", [
+        { value: "user", label: "User-level (~/.claude/settings.json)", description: "Works in all projects" },
+        { value: "project", label: "Project-level (.claude/settings.local.json)", description: "This project only" }
+      ]);
+      const statuslinePath = statuslineScope === "user" ? path.join(homeDir, ".claude", "settings.json") : path.join(projectDir, ".claude", "settings.local.json");
+      await configureStatusline(statuslinePath, logger);
+      (0, prompts_js_1.printStatus)(ctx, "success", `Statusline configured in ${statuslinePath}`);
+      return statuslineScope;
+    }
+    async function runStep2Gitignore(wctx, force) {
+      const { ctx, projectDir } = wctx;
+      const currentStatus = await (0, core_1.detectGitignoreStatus)(projectDir);
+      if (currentStatus === "installed") {
+        if (!force) {
+          (0, prompts_js_1.printStatus)(ctx, "success", "Sidekick entries already present in .gitignore");
+        }
+        return "installed";
+      }
+      if (force) {
+        const result2 = await (0, core_1.installGitignoreSection)(projectDir);
+        return result2.status === "error" ? "missing" : "installed";
+      }
+      (0, prompts_js_1.printHeader)(ctx, "Step 2: Git Configuration", "Sidekick creates logs and session data that should not be committed.");
+      const shouldInstall = await (0, prompts_js_1.promptConfirm)(ctx, "Update .gitignore to exclude sidekick transient files?", true);
+      if (!shouldInstall) {
+        (0, prompts_js_1.printStatus)(ctx, "info", "Skipping .gitignore configuration (you can manage it manually)");
+        return "missing";
+      }
+      const result = await (0, core_1.installGitignoreSection)(projectDir);
+      if (result.status === "error") {
+        (0, prompts_js_1.printStatus)(ctx, "warning", `Failed to update .gitignore: ${result.error}`);
+        return "missing";
+      }
+      const message = result.status === "already-installed" ? "Sidekick entries already present in .gitignore" : "Added sidekick section to .gitignore";
+      (0, prompts_js_1.printStatus)(ctx, "success", message);
+      return "installed";
+    }
+    async function runStep3Personas(wctx) {
+      const { ctx, homeDir, projectDir } = wctx;
+      const stdout = ctx.stdout;
+      (0, prompts_js_1.printHeader)(ctx, "Step 3: Persona Features", "Sidekick includes AI personas (Marvin, GLaDOS, Skippy, etc.) that add\npersonality to your coding sessions with snarky messages and contextual nudges.");
+      stdout.write("These require an OpenRouter API key (small cost per message).\n\n");
+      const wantPersonas = await (0, prompts_js_1.promptConfirm)(ctx, "Enable persona features?", true);
+      let apiKeyHealth = "not-required";
+      if (!wantPersonas) {
+        await writePersonaConfig(projectDir, homeDir, false);
+        (0, prompts_js_1.printStatus)(ctx, "info", "Personas disabled");
+      } else {
+        await writePersonaConfig(projectDir, homeDir, true);
+        apiKeyHealth = await configureApiKey(wctx);
+      }
+      return { wantPersonas, apiKeyHealth };
+    }
+    async function configureApiKey(wctx) {
+      const { ctx, homeDir, projectDir, logger } = wctx;
+      const stdout = ctx.stdout;
+      const existingKey = await findExistingApiKey("OPENROUTER_API_KEY", homeDir, projectDir);
+      if (existingKey) {
+        (0, prompts_js_1.printStatus)(ctx, "success", "OPENROUTER_API_KEY found");
+        stdout.write("Validating... ");
+        const result2 = await (0, validate_api_key_js_1.validateOpenRouterKey)(existingKey, logger);
+        if (result2.valid) {
+          stdout.write("valid!\n");
+          return "healthy";
+        } else {
+          stdout.write(`invalid (${result2.error})
+`);
+          return "invalid";
+        }
+      }
+      (0, prompts_js_1.printStatus)(ctx, "warning", "OPENROUTER_API_KEY not found");
+      const configureNow = await (0, prompts_js_1.promptConfirm)(ctx, "Configure API key now?", true);
+      if (!configureNow) {
+        stdout.write("\n");
+        (0, prompts_js_1.printStatus)(ctx, "warning", "Persona features will show warnings in the statusline until an API key is configured.");
+        stdout.write("Run 'sidekick setup' again or ask Claude to help configure API keys using /sidekick-config.\n");
+        return "missing";
+      }
+      const keyScope = await (0, prompts_js_1.promptSelect)(ctx, "Where should the API key be stored?", [
+        { value: "user", label: "User-level (~/.sidekick/.env)", description: "Works in all projects" },
+        { value: "project", label: "Project-level (.sidekick/.env)", description: "This project only" }
+      ]);
+      const apiKey = await (0, prompts_js_1.promptInput)(ctx, "Paste your OpenRouter API key");
+      stdout.write("Validating... ");
+      const result = await (0, validate_api_key_js_1.validateOpenRouterKey)(apiKey, logger);
+      const envPath = keyScope === "user" ? path.join(homeDir, ".sidekick", ".env") : path.join(projectDir, ".sidekick", ".env");
+      if (result.valid) {
+        stdout.write("valid!\n");
+        await writeApiKeyToEnv(envPath, "OPENROUTER_API_KEY", apiKey);
+        (0, prompts_js_1.printStatus)(ctx, "success", `API key saved to ${envPath}`);
+        return "healthy";
+      } else {
+        stdout.write(`invalid (${result.error})
+`);
+        (0, prompts_js_1.printStatus)(ctx, "warning", "API key validation failed, saving anyway");
+        await writeApiKeyToEnv(envPath, "OPENROUTER_API_KEY", apiKey);
+        return "invalid";
+      }
+    }
+    async function runStep4AutoConfig(wctx) {
+      const { ctx } = wctx;
+      (0, prompts_js_1.printHeader)(ctx, "Step 4: Project Auto-Configuration");
+      const autoConfig = await (0, prompts_js_1.promptSelect)(ctx, "When sidekick runs in a new project for the first time:", [
+        { value: "auto", label: "Auto-configure using my defaults", description: "Recommended" },
+        { value: "ask", label: "Ask me each time" },
+        { value: "manual", label: "Do nothing", description: "Manual setup only" }
+      ]);
+      return autoConfig;
+    }
+    async function writeStatusFiles(wctx, state) {
+      const { setupService } = wctx;
+      const { statuslineScope, gitignoreStatus, wantPersonas, apiKeyHealth, autoConfig } = state;
+      const userStatus = {
+        version: 1,
+        lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        preferences: {
+          autoConfigureProjects: autoConfig === "auto",
+          defaultStatuslineScope: statuslineScope,
+          defaultApiKeyScope: wantPersonas ? "user" : "skip"
+        },
+        statusline: "configured",
+        apiKeys: {
+          OPENROUTER_API_KEY: apiKeyHealth,
+          OPENAI_API_KEY: "not-required"
+        }
+      };
+      await setupService.writeUserStatus(userStatus);
+      const projectStatus = {
+        version: 1,
+        lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        autoConfigured: false,
+        statusline: statuslineScope === "project" ? "configured" : "user",
+        apiKeys: {
+          OPENROUTER_API_KEY: apiKeyHealth === "healthy" ? "user" : apiKeyHealth,
+          OPENAI_API_KEY: "not-required"
+        },
+        gitignore: gitignoreStatus
+      };
+      await setupService.writeProjectStatus(projectStatus);
+    }
+    function printSummary(wctx, state) {
+      const { ctx } = wctx;
+      const { statuslineScope, gitignoreStatus, wantPersonas, apiKeyHealth, autoConfig } = state;
+      const stdout = ctx.stdout;
+      (0, prompts_js_1.printHeader)(ctx, "Summary");
+      (0, prompts_js_1.printStatus)(ctx, "success", `Statusline: ${statuslineScope === "user" ? "User-level" : "Project-level"}`);
+      (0, prompts_js_1.printStatus)(ctx, gitignoreStatus === "installed" ? "success" : "info", `Gitignore: ${gitignoreStatus === "installed" ? "Configured" : "Skipped"}`);
+      (0, prompts_js_1.printStatus)(ctx, wantPersonas ? "success" : "info", `Personas: ${wantPersonas ? "Enabled" : "Disabled"}`);
+      const apiKeyStatusType = getApiKeyStatusType(apiKeyHealth);
+      (0, prompts_js_1.printStatus)(ctx, apiKeyStatusType, `API Key: ${apiKeyHealth}`);
+      (0, prompts_js_1.printStatus)(ctx, "success", `Auto-configure: ${autoConfig === "auto" ? "Enabled" : "Disabled"}`);
+      stdout.write("\n");
+      stdout.write("Restart Claude Code to see your statusline: claude --continue\n");
+    }
+    async function runWizard(projectDir, logger, stdout, options) {
+      const homeDir = os.homedir();
+      const wctx = {
+        ctx: {
+          stdin: options.stdin ?? process.stdin,
+          stdout
+        },
+        homeDir,
+        projectDir,
+        logger,
+        setupService: new core_1.SetupStatusService(projectDir, { homeDir, logger })
+      };
+      const force = options.force ?? false;
+      if (!force) {
+        printWizardHeader(stdout);
+      }
+      const statuslineScope = force ? "user" : await runStep1Statusline(wctx);
+      const gitignoreStatus = await runStep2Gitignore(wctx, force);
+      const { wantPersonas, apiKeyHealth } = force ? { wantPersonas: true, apiKeyHealth: "not-required" } : await runStep3Personas(wctx);
+      const autoConfig = force ? "auto" : await runStep4AutoConfig(wctx);
+      if (force) {
+        const statuslinePath = path.join(homeDir, ".claude", "settings.json");
+        await configureStatusline(statuslinePath, logger);
+      }
+      const state = { statuslineScope, gitignoreStatus, wantPersonas, apiKeyHealth, autoConfig };
+      await writeStatusFiles(wctx, state);
+      if (!force) {
+        printSummary(wctx, state);
+      } else {
+        stdout.write("Setup complete (force mode):\n");
+        stdout.write(`  Statusline: user-level (~/.claude/settings.json)
+`);
+        stdout.write(`  Gitignore: ${gitignoreStatus === "installed" ? "configured" : "skipped"}
+`);
+        stdout.write(`  Personas: enabled (API key not configured)
+`);
+        stdout.write(`  Auto-configure: enabled
+`);
+      }
+      return { exitCode: 0 };
+    }
+    async function runDoctor(projectDir, logger, stdout) {
+      const homeDir = os.homedir();
+      const setupService = new core_1.SetupStatusService(projectDir, { homeDir, logger });
+      stdout.write("\nSidekick Doctor\n");
+      stdout.write("===============\n\n");
+      const statusline = await setupService.getStatuslineHealth();
+      const gitignore = await (0, core_1.detectGitignoreStatus)(projectDir);
+      const apiKey = await setupService.getEffectiveApiKeyHealth("OPENROUTER_API_KEY");
+      const isHealthy = await setupService.isHealthy();
+      const statuslineIcon = statusline === "configured" ? "\u2713" : "\u26A0";
+      const gitignoreIcon = gitignore === "installed" ? "\u2713" : "\u26A0";
+      const apiKeyIcon = apiKey === "healthy" || apiKey === "not-required" ? "\u2713" : "\u26A0";
+      const overallIcon = isHealthy && gitignore === "installed" ? "\u2713" : "\u26A0";
+      stdout.write(`${statuslineIcon} Statusline: ${statusline}
+`);
+      stdout.write(`${gitignoreIcon} Gitignore: ${gitignore}
+`);
+      stdout.write(`${apiKeyIcon} OpenRouter API Key: ${apiKey}
+`);
+      stdout.write(`${overallIcon} Overall: ${isHealthy && gitignore === "installed" ? "healthy" : "needs attention"}
+`);
+      if (!isHealthy || gitignore !== "installed") {
+        stdout.write("\nRun 'sidekick setup' to configure.\n");
+      }
+      return { exitCode: isHealthy && gitignore === "installed" ? 0 : 1 };
+    }
+    async function handleSetupCommand(projectDir, logger, stdout, options = {}) {
+      if (options.checkOnly) {
+        return runDoctor(projectDir, logger, stdout);
+      }
+      return runWizard(projectDir, logger, stdout, options);
+    }
+  }
+});
+
+// ../sidekick-cli/dist/commands/setup.js
+var require_setup2 = __commonJS({
+  "../sidekick-cli/dist/commands/setup.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.handleSetupCommand = void 0;
+    var index_js_1 = require_setup();
+    Object.defineProperty(exports2, "handleSetupCommand", { enumerable: true, get: function() {
+      return index_js_1.handleSetupCommand;
+    } });
+  }
+});
+
 // ../sidekick-cli/dist/cli.js
 var require_cli = __commonJS({
   "../sidekick-cli/dist/cli.js"(exports2) {
@@ -53059,6 +54175,7 @@ var require_cli = __commonJS({
     var promises_12 = require("node:fs/promises");
     var node_stream_1 = require("node:stream");
     var yargs_parser_1 = __importDefault2(require_build());
+    var VERSION = true ? "0.0.4-alpha" : "dev";
     function isInSandbox() {
       return process.env.SANDBOX_RUNTIME === "1";
     }
@@ -53073,11 +54190,12 @@ Example: { "command": "pnpm sidekick daemon status", "dangerouslyDisableSandbox"
     var runtime_1 = require_runtime();
     function parseArgs(argv) {
       const parsed = (0, yargs_parser_1.default)(argv, {
-        boolean: ["wait", "open", "prefer-project", "help", "kill", "force"],
+        boolean: ["wait", "open", "prefer-project", "help", "version", "kill", "force"],
         string: ["project-dir", "log-level", "format", "host", "session-id", "type"],
         number: ["port", "width"],
         alias: {
-          h: "help"
+          h: "help",
+          v: "version"
         },
         configuration: {
           "camel-case-expansion": false
@@ -53098,6 +54216,7 @@ Example: { "command": "pnpm sidekick daemon status", "dangerouslyDisableSandbox"
         sessionIdArg: parsed["session-id"],
         messageType: parsed.type,
         help: Boolean(parsed.help),
+        version: Boolean(parsed.version),
         kill: Boolean(parsed.kill),
         force: Boolean(parsed.force),
         _: parsed._
@@ -53198,9 +54317,12 @@ Commands:
   statusline               Render the status line (used by hooks)
   dev-mode <subcommand>    Manage development hooks (enable, disable, status, clean)
   ui                       Launch the web UI
+  setup                    Run the setup wizard (configure statusline, API keys)
+  doctor                   Check sidekick health (alias: setup --check)
 
 Global Options:
   --help, -h               Show this help message
+  --version, -v            Show version number
   --format=<format>        Output format: json or table (command-specific)
   --width=<n>              Table width in characters (default: 100)
   --project-dir=<path>     Override project directory
@@ -53284,7 +54406,9 @@ Run 'sidekick hook --help' for available hooks.
           return { exitCode: 1, stdout: SANDBOX_ERROR_MESSAGE, stderr: "" };
         }
         const { handleDaemonCommand } = await Promise.resolve().then(() => __importStar(require_daemon()));
-        const result = await handleDaemonCommand(subcommand, runtime.projectRoot || process.cwd(), runtime.logger, stdout, { wait: parsed.wait });
+        const result = await handleDaemonCommand(subcommand, runtime.projectRoot || process.cwd(), runtime.logger, stdout, {
+          wait: parsed.wait
+        });
         return { exitCode: result.exitCode, stdout: "", stderr: "" };
       }
       if (parsed.command === "statusline") {
@@ -53339,6 +54463,21 @@ Run 'sidekick hook --help' for available hooks.
         const result = await handleDevModeCommand(subcommand, runtime.projectRoot || process.cwd(), runtime.logger, stdout, { force: Boolean(parsed.force) });
         return { exitCode: result.exitCode, stdout: "", stderr: "" };
       }
+      if (parsed.command === "setup") {
+        const { handleSetupCommand } = await Promise.resolve().then(() => __importStar(require_setup2()));
+        const result = await handleSetupCommand(runtime.projectRoot || process.cwd(), runtime.logger, stdout, {
+          checkOnly: parsed.help ? false : parsed._?.[1] === "--check",
+          stdin: process.stdin
+        });
+        return { exitCode: result.exitCode, stdout: "", stderr: "" };
+      }
+      if (parsed.command === "doctor") {
+        const { handleSetupCommand } = await Promise.resolve().then(() => __importStar(require_setup2()));
+        const result = await handleSetupCommand(runtime.projectRoot || process.cwd(), runtime.logger, stdout, {
+          checkOnly: true
+        });
+        return { exitCode: result.exitCode, stdout: "", stderr: "" };
+      }
       const errorMsg = `Unknown command: ${parsed.command}
 Run 'sidekick help' for available commands.
 `;
@@ -53365,6 +54504,16 @@ Run 'sidekick help' for available commands.
     }
     async function runCli(options) {
       const stdout = options.stdout ?? new node_stream_1.PassThrough();
+      const quickParsed = (0, yargs_parser_1.default)(options.argv, {
+        boolean: ["version"],
+        alias: { v: "version" }
+      });
+      if (quickParsed.version) {
+        const versionOutput = `${VERSION}
+`;
+        stdout.write(versionOutput);
+        return { exitCode: 0, stdout: versionOutput, stderr: "" };
+      }
       const initResult = initializeRuntime(options);
       if (initResult.shouldExit) {
         return { exitCode: 0, stdout: "", stderr: "" };