@scotthamilton77/sidekick 0.0.2-alpha → 0.0.5-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;
@@ -48831,6 +49286,7 @@ var require_hook_command = __commonJS({
     exports2.translateToClaudeCodeFormat = translateToClaudeCodeFormat;
     exports2.parseHookArg = parseHookArg;
     exports2.handleUnifiedHookCommand = handleUnifiedHookCommand;
+    var core_1 = require_dist3();
     var hook_js_1 = require_hook();
     function combineReasonAndContext(reason, additionalContext, separator = "\n\n") {
       if (reason && additionalContext) {
@@ -48848,7 +49304,7 @@ var require_hook_command = __commonJS({
         response.systemMessage = internal.userMessage;
       }
       if (internal.additionalContext) {
-        response.hookSpecificOutput = { additionalContext: internal.additionalContext };
+        response.hookSpecificOutput = { hookEventName: "SessionStart", additionalContext: internal.additionalContext };
       }
       return response;
     }
@@ -48953,6 +49409,52 @@ var require_hook_command = __commonJS({
         return void 0;
       return HOOK_ARG_TO_NAME[arg];
     }
+    var DEGRADED_MODE_MESSAGES = {
+      "not-run": {
+        additionalContext: `Sidekick plugin detected but not configured. Features like reminders, personas, and statusline are unavailable until setup is complete. If you haven't already, ask the user if you should execute the sidekick-config skill.`,
+        userMessage: `Sidekick is installed but not configured. Run 'sidekick setup' to configure.`
+      },
+      partial: {
+        additionalContext: `Sidekick user setup is complete but this project is not configured. Features like reminders, personas, and statusline are unavailable until project setup is complete. If you haven't already, ask the user if you should execute the sidekick-config skill.`,
+        userMessage: `Sidekick project setup incomplete. Run 'sidekick setup' in this project to configure.`
+      },
+      unhealthy: {
+        additionalContext: `Sidekick is configured but unhealthy (possibly invalid API keys or missing configuration). Features are unavailable until issues are resolved. If you haven't already, ask the user if you should execute sidekick doctor.`,
+        userMessage: `Sidekick configuration is unhealthy. Run 'sidekick doctor' to diagnose issues.`
+      }
+    };
+    var VERBOSE_DEGRADED_HOOKS = /* @__PURE__ */ new Set(["SessionStart", "UserPromptSubmit"]);
+    async function checkSetupState(projectRoot, hookName, logger) {
+      let state;
+      try {
+        const setupService = new core_1.SetupStatusService(projectRoot);
+        state = await setupService.getSetupState();
+      } catch (err) {
+        logger.warn("Failed to check setup state, assuming healthy", {
+          error: err instanceof Error ? err.message : String(err),
+          hookName,
+          projectRoot
+        });
+        return null;
+      }
+      if (state === "healthy") {
+        return null;
+      }
+      const logData = { setupState: state, hookName, projectRoot };
+      if (state === "not-run") {
+        logger.info("Hook operating in degraded mode - setup not run", logData);
+      } else {
+        logger.warn("Hook operating in degraded mode", logData);
+      }
+      if (!VERBOSE_DEGRADED_HOOKS.has(hookName)) {
+        return {};
+      }
+      const messages = DEGRADED_MODE_MESSAGES[state];
+      return {
+        additionalContext: messages.additionalContext,
+        userMessage: messages.userMessage
+      };
+    }
     function parseInternalResponse(output, hookName, logger) {
       if (!output)
         return {};
@@ -48970,6 +49472,15 @@ var require_hook_command = __commonJS({
     async function handleUnifiedHookCommand(hookName, options, logger, stdout) {
       const { projectRoot, hookInput, correlationId, runtime } = options;
       logger.debug("Unified hook command invoked", { hookName, sessionId: hookInput.sessionId });
+      const degradedResponse = await checkSetupState(projectRoot, hookName, logger);
+      if (degradedResponse !== null) {
+        const claudeResponse2 = translateToClaudeCodeFormat(hookName, degradedResponse);
+        const outputStr2 = JSON.stringify(claudeResponse2);
+        stdout.write(`${outputStr2}
+`);
+        logger.debug("Hook completed in degraded mode", { hookName });
+        return { exitCode: 0, output: outputStr2 };
+      }
       let internalOutput = "";
       const captureStream = {
         write(chunk) {
@@ -51116,6 +51627,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 +51720,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 +51797,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 +53601,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 +54231,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.5-alpha" : "dev";
     function isInSandbox() {
       return process.env.SANDBOX_RUNTIME === "1";
     }
@@ -53073,11 +54246,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 +54272,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._
@@ -53174,6 +54349,19 @@ Example: { "command": "pnpm sidekick daemon status", "dangerouslyDisableSandbox"
       if (!hookMode || !projectRoot) {
         return { started: false };
       }
+      try {
+        const { SetupStatusService } = await Promise.resolve().then(() => __importStar(require_dist3()));
+        const setupService = new SetupStatusService(projectRoot);
+        const setupState = await setupService.getSetupState();
+        if (setupState !== "healthy") {
+          logger.debug("Skipping daemon start - setup not healthy", { setupState });
+          return { started: false };
+        }
+      } catch (err) {
+        logger.warn("Failed to check setup status, proceeding with daemon start", {
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
       try {
         const { DaemonClient } = await Promise.resolve().then(() => __importStar(require_dist3()));
         const daemonClient = new DaemonClient(projectRoot, logger);
@@ -53198,9 +54386,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 +54475,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 +54532,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 +54573,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: "" };