@scotthamilton77/sidekick 0.0.4-alpha → 0.0.6-alpha

package/dist/bin.js

@@ -33485,7 +33485,9 @@ var require_gitignore = __commonJS({
       ".sidekick/sessions/",
       ".sidekick/state/",
       ".sidekick/.env",
-      ".sidekick/.env.local"
+      ".sidekick/.env.local",
+      ".sidekick/sidekick*.pid",
+      ".sidekick/sidekick*.token"
     ];
     async function installGitignoreSection(projectDir) {
       const gitignorePath = path.join(projectDir, ".gitignore");
@@ -49286,6 +49288,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) {
@@ -49303,7 +49306,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;
     }
@@ -49408,6 +49411,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 {};
@@ -49425,6 +49474,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) {
@@ -53773,6 +53831,32 @@ var require_setup = __commonJS({
     var core_1 = require_dist3();
     var prompts_js_1 = require_prompts();
     var validate_api_key_js_1 = require_validate_api_key();
+    var USAGE_TEXT = `Usage: sidekick setup [options]
+
+Run the interactive setup wizard to configure sidekick for Claude Code.
+When scripting flags are provided, runs non-interactively for those settings only.
+
+Options:
+  --check                       Check configuration status (alias: sidekick doctor)
+  --force                       Apply all defaults non-interactively
+  --help                        Show this help message
+
+Scripting Flags (for non-interactive/partial setup):
+  --statusline-scope=<scope>    Configure statusline: user | project
+  --gitignore                   Update .gitignore to exclude sidekick files
+  --no-gitignore                Skip .gitignore configuration
+  --personas                    Enable persona features
+  --no-personas                 Disable persona features
+  --api-key-scope=<scope>       Save API key from OPENROUTER_API_KEY env: user | project
+  --auto-config=<mode>          Auto-configure preference: auto | ask | manual
+
+Examples:
+  sidekick setup                              Interactive wizard
+  sidekick setup --check                      Check current status
+  sidekick setup --statusline-scope=user      Configure statusline only
+  sidekick setup --gitignore --personas       Configure gitignore and enable personas
+  OPENROUTER_API_KEY=sk-xxx sidekick setup --personas --api-key-scope=user
+`;
     var STATUSLINE_COMMAND = "npx @scotthamilton77/sidekick statusline --project-dir=$CLAUDE_PROJECT_DIR";
     function getApiKeyStatusType(health) {
       switch (health) {
@@ -53846,17 +53930,16 @@ var require_setup = __commonJS({
     }
     async function writePersonaConfig(_projectDir, homeDir, enabled) {
       const configDir = path.join(homeDir, ".sidekick");
-      const configPath = path.join(configDir, "config.yaml");
+      const featuresPath = path.join(configDir, "features.yaml");
       await fs.mkdir(configDir, { recursive: true });
       let content = "";
       try {
-        content = await fs.readFile(configPath, "utf-8");
+        content = await fs.readFile(featuresPath, "utf-8");
       } catch {
       }
-      const personasRegex = /^features:\s*\n\s*personas:\s*\n\s*enabled:\s*(true|false)/m;
-      const newPersonasBlock = `features:
-  personas:
-    enabled: ${enabled}`;
+      const personasRegex = /^personas:\s*\n\s*enabled:\s*(true|false)/m;
+      const newPersonasBlock = `personas:
+  enabled: ${enabled}`;
       if (personasRegex.test(content)) {
         content = content.replace(personasRegex, newPersonasBlock);
       } else {
@@ -53865,7 +53948,7 @@ var require_setup = __commonJS({
         }
         content += newPersonasBlock + "\n";
       }
-      await fs.writeFile(configPath, content);
+      await fs.writeFile(featuresPath, 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");
@@ -54069,6 +54152,96 @@ var require_setup = __commonJS({
         stdout.write(`  Personas: enabled (API key not configured)
 `);
         stdout.write(`  Auto-configure: enabled
+`);
+      }
+      return { exitCode: 0 };
+    }
+    function hasScriptingFlags(options) {
+      return options.statuslineScope !== void 0 || options.gitignore !== void 0 || options.personas !== void 0 || options.apiKeyScope !== void 0 || options.autoConfig !== void 0;
+    }
+    async function runScripted(projectDir, logger, stdout, options) {
+      const homeDir = os.homedir();
+      const setupService = new core_1.SetupStatusService(projectDir, { homeDir, logger });
+      let configuredCount = 0;
+      if (options.statuslineScope) {
+        const statuslinePath = options.statuslineScope === "user" ? path.join(homeDir, ".claude", "settings.json") : path.join(projectDir, ".claude", "settings.local.json");
+        await configureStatusline(statuslinePath, logger);
+        stdout.write(`\u2713 Statusline configured (${options.statuslineScope}-level)
+`);
+        configuredCount++;
+      }
+      if (options.gitignore === true) {
+        const result = await (0, core_1.installGitignoreSection)(projectDir);
+        if (result.status === "error") {
+          stdout.write(`\u26A0 Failed to update .gitignore: ${result.error}
+`);
+        } else if (result.status === "already-installed") {
+          stdout.write("\u2713 Gitignore already configured\n");
+        } else {
+          stdout.write("\u2713 Gitignore configured\n");
+        }
+        configuredCount++;
+      } else if (options.gitignore === false) {
+        stdout.write("- Gitignore skipped\n");
+      }
+      if (options.personas !== void 0) {
+        await writePersonaConfig(projectDir, homeDir, options.personas);
+        stdout.write(`\u2713 Personas ${options.personas ? "enabled" : "disabled"}
+`);
+        configuredCount++;
+      }
+      if (options.apiKeyScope) {
+        const apiKey = process.env.OPENROUTER_API_KEY;
+        if (apiKey) {
+          const envPath = options.apiKeyScope === "user" ? path.join(homeDir, ".sidekick", ".env") : path.join(projectDir, ".sidekick", ".env");
+          stdout.write("Validating API key... ");
+          const result = await (0, validate_api_key_js_1.validateOpenRouterKey)(apiKey, logger);
+          if (result.valid) {
+            stdout.write("valid\n");
+            await writeApiKeyToEnv(envPath, "OPENROUTER_API_KEY", apiKey);
+            stdout.write(`\u2713 API key saved (${options.apiKeyScope}-level)
+`);
+          } else {
+            stdout.write(`invalid (${result.error})
+`);
+            stdout.write(`\u26A0 API key saved anyway (${options.apiKeyScope}-level)
+`);
+            await writeApiKeyToEnv(envPath, "OPENROUTER_API_KEY", apiKey);
+          }
+          configuredCount++;
+        } else {
+          stdout.write("\u26A0 --api-key-scope specified but OPENROUTER_API_KEY not set in environment\n");
+        }
+      }
+      if (options.autoConfig) {
+        const existingUserStatus = await setupService.getUserStatus();
+        const userStatus = existingUserStatus ?? {
+          version: 1,
+          lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          preferences: {
+            autoConfigureProjects: options.autoConfig === "auto",
+            defaultStatuslineScope: "user",
+            defaultApiKeyScope: "user"
+          },
+          statusline: "skipped",
+          // Default to skipped if no prior setup
+          apiKeys: {
+            OPENROUTER_API_KEY: "not-required",
+            OPENAI_API_KEY: "not-required"
+          }
+        };
+        userStatus.preferences.autoConfigureProjects = options.autoConfig === "auto";
+        userStatus.lastUpdatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        await setupService.writeUserStatus(userStatus);
+        stdout.write(`\u2713 Auto-config set to '${options.autoConfig}'
+`);
+        configuredCount++;
+      }
+      if (configuredCount === 0) {
+        stdout.write("No configuration changes made. Use --help to see available options.\n");
+      } else {
+        stdout.write(`
+Configured ${configuredCount} setting${configuredCount === 1 ? "" : "s"}.
 `);
       }
       return { exitCode: 0 };
@@ -54100,9 +54273,16 @@ var require_setup = __commonJS({
       return { exitCode: isHealthy && gitignore === "installed" ? 0 : 1 };
     }
     async function handleSetupCommand(projectDir, logger, stdout, options = {}) {
+      if (options.help) {
+        stdout.write(USAGE_TEXT);
+        return { exitCode: 0 };
+      }
       if (options.checkOnly) {
         return runDoctor(projectDir, logger, stdout);
       }
+      if (hasScriptingFlags(options)) {
+        return runScripted(projectDir, logger, stdout, options);
+      }
       return runWizard(projectDir, logger, stdout, options);
     }
   }
@@ -54175,7 +54355,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";
+    var VERSION = true ? "0.0.6-alpha" : "dev";
     function isInSandbox() {
       return process.env.SANDBOX_RUNTIME === "1";
     }
@@ -54190,8 +54370,18 @@ 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", "version", "kill", "force"],
-        string: ["project-dir", "log-level", "format", "host", "session-id", "type"],
+        boolean: ["wait", "open", "prefer-project", "help", "version", "kill", "force", "gitignore", "personas"],
+        string: [
+          "project-dir",
+          "log-level",
+          "format",
+          "host",
+          "session-id",
+          "type",
+          "statusline-scope",
+          "api-key-scope",
+          "auto-config"
+        ],
         number: ["port", "width"],
         alias: {
           h: "help",
@@ -54202,6 +54392,8 @@ Example: { "command": "pnpm sidekick daemon status", "dangerouslyDisableSandbox"
         }
       });
       const command = parsed._[0];
+      const hasGitignoreFlag = argv.some((arg) => arg === "--gitignore" || arg === "--no-gitignore");
+      const hasPersonasFlag = argv.some((arg) => arg === "--personas" || arg === "--no-personas");
       return {
         command,
         projectDir: parsed["project-dir"],
@@ -54219,7 +54411,13 @@ Example: { "command": "pnpm sidekick daemon status", "dangerouslyDisableSandbox"
         version: Boolean(parsed.version),
         kill: Boolean(parsed.kill),
         force: Boolean(parsed.force),
-        _: parsed._
+        _: parsed._,
+        // Setup command scripting flags - only set if explicitly provided
+        statuslineScope: parsed["statusline-scope"],
+        gitignore: hasGitignoreFlag ? Boolean(parsed.gitignore) : void 0,
+        personas: hasPersonasFlag ? Boolean(parsed.personas) : void 0,
+        apiKeyScope: parsed["api-key-scope"],
+        autoConfig: parsed["auto-config"]
       };
     }
     function parseHookInput(stdinData) {
@@ -54293,6 +54491,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);
@@ -54466,8 +54677,15 @@ Run 'sidekick hook --help' for available hooks.
       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
+          help: parsed.help,
+          checkOnly: parsed._?.[1] === "--check",
+          stdin: process.stdin,
+          // Scripting flags for non-interactive setup
+          statuslineScope: parsed.statuslineScope,
+          gitignore: parsed.gitignore,
+          personas: parsed.personas,
+          apiKeyScope: parsed.apiKeyScope,
+          autoConfig: parsed.autoConfig
         });
         return { exitCode: result.exitCode, stdout: "", stderr: "" };
       }

package/dist/daemon.js

@@ -32509,7 +32509,9 @@ var require_gitignore = __commonJS({
       ".sidekick/sessions/",
       ".sidekick/state/",
       ".sidekick/.env",
-      ".sidekick/.env.local"
+      ".sidekick/.env.local",
+      ".sidekick/sidekick*.pid",
+      ".sidekick/sidekick*.token"
     ];
     async function installGitignoreSection(projectDir2) {
       const gitignorePath = path.join(projectDir2, ".gitignore");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scotthamilton77/sidekick",
-  "version": "0.0.4-alpha",
+  "version": "0.0.6-alpha",
   "description": "AI pair programming assistant with personas, session tracking, and contextual nudges",
   "bin": {
     "sidekick": "dist/bin.js"