create-snipara 1.3.37 → 1.3.38

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "1.3.37",
+  version: "1.3.38",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -288,7 +288,8 @@ function parseInitOptionsFromArgv(args) {
   return parsed;
 }
 async function runInit(options) {
-  const answers = await gatherConfiguration(normalizeInitOptions(options));
+  const normalizedOptions = normalizeInitOptions(options);
+  const answers = await gatherConfiguration(normalizedOptions);
   if (answers.installMcp || answers.installRuntime || answers.installOrchestrator) {
     await installPythonPackages(answers, false);
   }
@@ -308,9 +309,9 @@ async function runInit(options) {
   }
   await updateEnvFiles(answers);
   await createCompanionConfig(answers);
-  await syncRemoteAutomationClient(answers, { enabled: !options.skipTest });
+  await syncRemoteAutomationClient(answers, { enabled: !normalizedOptions.skipTest });
   await createCompanionPack(answers);
-  const validationReport = await runValidation(answers, !options.skipTest);
+  const validationReport = await runValidation(answers, !normalizedOptions.skipTest);
   writeDoctorReport(validationReport);
   printSuccess(answers, validationReport);
   if (answers.configureGitHub && answers.githubRepo) {
@@ -1137,31 +1138,10 @@ async function createClaudeCodeConfig(answers) {
   if (answers.profile === "runtime-only") {
     return;
   }
-  const claudeDir = path.join(homedir(), ".claude");
-  const settingsPath = path.join(claudeDir, "settings.json");
-  console.log(chalk.bold("\n\u{1F916} Configuring Claude Code MCP\n"));
-  try {
-    fs.mkdirSync(claudeDir, { recursive: true });
-    let settings = {};
-    if (fs.existsSync(settingsPath)) {
-      settings = asObjectRecord(JSON.parse(fs.readFileSync(settingsPath, "utf-8")));
-    }
-    const mcpServers = asObjectRecord(settings.mcpServers);
-    settings.mcpServers = {
-      ...mcpServers,
-      snipara: buildHostedMcpServer(answers)
-    };
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", { mode: 384 });
-    try {
-      fs.chmodSync(settingsPath, 384);
-    } catch {
-    }
-    console.log(chalk.green("   \u2713 Updated ~/.claude/settings.json with Snipara MCP"));
-  } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error);
-    console.log(chalk.yellow(`   \u26A0\uFE0F  Could not update Claude Code MCP config: ${detail}`));
-    console.log(chalk.dim("   Run create-snipara doctor --client claude after manual setup."));
-  }
+  console.log(chalk.bold("\n\u{1F916} Claude Code MCP\n"));
+  console.log(chalk.green("   \u2713 Project .mcp.json contains the Snipara Hosted MCP server"));
+  console.log(chalk.dim("   Claude Code loads project-scoped MCP servers from .mcp.json."));
+  console.log(chalk.dim(`   Verify with: claude mcp list && claude mcp test snipara`));
 }
 async function createProjectBinding(answers) {
   if (answers.profile === "runtime-only") {
@@ -1469,14 +1449,8 @@ async function createClaudeDesktopConfig(answers) {
 }
 async function installClaudeCodeHooks(answers) {
   console.log(chalk.bold("\n\u{1FA9D} Installing Claude Code Hooks\n"));
-  const claudeDir = path.join(homedir(), ".claude");
+  const claudeDir = path.join(process.cwd(), ".claude");
   const hooksDir = path.join(claudeDir, "hooks");
-  if (!fs.existsSync(claudeDir)) {
-    console.log(
-      chalk.yellow("   \u26A0\uFE0F  ~/.claude not found. Install Claude Code first, then rerun repair.\n")
-    );
-    return;
-  }
   if (!fs.existsSync(hooksDir)) {
     fs.mkdirSync(hooksDir, { recursive: true });
   }
@@ -1513,41 +1487,88 @@ async function installClaudeCodeHooks(answers) {
       settings = {};
     }
   }
-  settings.hooks = settings.hooks || {};
+  settings.hooks = asObjectRecord(settings.hooks);
   const hooksConfig = settings.hooks;
   const hookEntries = [
     {
       event: "PreToolUse",
-      script: path.join(hooksDir, "snipara-stuck-guard.sh"),
-      matcher: { tool_name: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write" }
+      entry: {
+        matcher: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write",
+        hooks: [
+          {
+            type: "command",
+            command: createClaudeProjectHookCommand("snipara-stuck-guard.sh"),
+            timeout: 10
+          }
+        ]
+      }
     },
     {
-      event: "PreToolUse",
-      script: path.join(hooksDir, "snipara-startup.sh"),
-      matcher: { tool_name: "TodoWrite" }
+      event: "SessionStart",
+      entry: {
+        matcher: "startup|resume|compact|clear",
+        hooks: [
+          {
+            type: "command",
+            command: createClaudeProjectHookCommand("snipara-startup.sh"),
+            timeout: 30
+          }
+        ]
+      }
     },
     {
       event: "PostToolUse",
-      script: path.join(hooksDir, "snipara-session.sh"),
-      matcher: { tool_name: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write" }
+      entry: {
+        matcher: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write",
+        hooks: [
+          {
+            type: "command",
+            command: createClaudeProjectHookCommand("snipara-session.sh"),
+            timeout: 10
+          }
+        ]
+      }
     },
     {
       event: "PreCompact",
-      script: path.join(hooksDir, "snipara-compact.sh")
+      entry: {
+        matcher: "manual|auto",
+        hooks: [
+          {
+            type: "command",
+            command: createClaudeProjectHookCommand("snipara-compact.sh"),
+            timeout: 30
+          }
+        ]
+      }
     }
   ];
-  for (const entry of hookEntries) {
-    const eventHooks = hooksConfig[entry.event] || [];
-    const exists = eventHooks.some(
-      (hook) => typeof hook === "object" && hook !== null && "script" in hook && hook.script === entry.script
-    );
+  for (const { event, entry } of hookEntries) {
+    const eventHooks = Array.isArray(hooksConfig[event]) ? hooksConfig[event] : [];
+    const expectedCommand = entry.hooks[0].command;
+    const exists = eventHooks.some((hook) => hookConfigEntryHasCommand(hook, expectedCommand));
     if (!exists) {
       eventHooks.push(entry);
-      hooksConfig[entry.event] = eventHooks;
+      hooksConfig[event] = eventHooks;
     }
   }
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-  console.log(chalk.green("   \u2713 Updated ~/.claude/settings.json"));
+  console.log(chalk.green("   \u2713 Updated .claude/settings.json hooks"));
+}
+function createClaudeProjectHookCommand(scriptName) {
+  return `bash -lc 'cd "\${CLAUDE_PROJECT_DIR:-$PWD}" && ./.claude/hooks/${scriptName}'`;
+}
+function hookConfigEntryHasCommand(entry, expectedCommand) {
+  if (!entry || typeof entry !== "object") {
+    return false;
+  }
+  const hooks = entry.hooks;
+  if (!Array.isArray(hooks)) {
+    return false;
+  }
+  return hooks.some(
+    (hook) => hook && typeof hook === "object" && hook.command === expectedCommand
+  );
 }
 function createStuckGuardHook(answers) {
   return `#!/usr/bin/env bash
@@ -1978,7 +1999,7 @@ function getClientPackFilename(client) {
 }
 function getClientConfigArtifacts(client) {
   if (client === "claude-code") {
-    return ["AGENTS.md", "CLAUDE.md", "~/.claude/settings.json MCP server"];
+    return ["AGENTS.md", "CLAUDE.md", ".mcp.json MCP server", ".claude/settings.json hooks"];
   }
   if (client === "cursor") {
     return [".mcp.json", ".cursor/rules/snipara.mdc", "dashboard automation bundle when installed"];
@@ -2237,11 +2258,15 @@ function getClaudeClientChecks(answers, detection) {
   const checks = [];
   const claudePaths = getClaudeConfigPaths();
   const projectConfig = readJsonFile(path.join(process.cwd(), ".mcp.json"));
+  const projectSettings = readJsonFile(path.join(process.cwd(), ".claude", "settings.json"));
   const codeSettings = readJsonFile(claudePaths.codeSettingsPath);
   const desktopConfig = readJsonFile(claudePaths.desktopConfigPath);
   const projectHasSnipara = containsSniparaMcpReference(projectConfig);
+  const projectSettingsHasSnipara = containsSniparaMcpReference(projectSettings);
   const codeSettingsHasSnipara = containsSniparaMcpReference(codeSettings);
+  const hasLegacyCodeSettingsMcp = projectSettingsHasSnipara || codeSettingsHasSnipara;
   const desktopHasSnipara = containsSniparaMcpReference(desktopConfig);
+  const projectHooksConfigured = containsClaudeHooksReference(projectSettings);
   checks.push({
     name: "claude_project_config",
     status: projectHasSnipara ? "pass" : "warn",
@@ -2250,8 +2275,13 @@ function getClaudeClientChecks(answers, detection) {
   if (answers.aiClient === "claude-code") {
     checks.push({
       name: "claude_code_settings",
-      status: detection.files.claudeSettings ? codeSettingsHasSnipara ? "pass" : "warn" : "warn",
-      detail: detection.files.claudeSettings ? codeSettingsHasSnipara ? "~/.claude/settings.json contains a Snipara MCP server" : "~/.claude/settings.json exists but no Snipara MCP server was found" : "~/.claude/settings.json not found; Claude may require Settings -> MCP UI setup"
+      status: hasLegacyCodeSettingsMcp ? "warn" : "pass",
+      detail: hasLegacyCodeSettingsMcp ? "Legacy Claude settings contain an MCP server entry; Claude Code project MCP should live in .mcp.json or be managed by claude mcp add --scope project" : "Claude settings are not being used as the MCP destination; .claude/settings.json is hooks-only"
+    });
+    checks.push({
+      name: "claude_code_hooks",
+      status: !answers.installHooks || projectHooksConfigured ? "pass" : "warn",
+      detail: answers.installHooks ? projectHooksConfigured ? "Project .claude/settings.json contains Snipara hook commands" : "Project .claude/settings.json hooks missing; run create-snipara repair --with-hooks" : "Claude hooks not requested"
     });
   }
   if (answers.aiClient === "claude-desktop") {
@@ -2298,6 +2328,15 @@ function containsSniparaMcpReference(value) {
   }
   return false;
 }
+function containsClaudeHooksReference(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  const hooks = value.hooks;
+  return Boolean(
+    hooks && typeof hooks === "object" && JSON.stringify(hooks).includes(COMPANION_COMMAND_NAME)
+  );
+}
 function getCreateSniparaPackageFreshnessCheck() {
   if (!commandExists("npm")) {
     return {
@@ -2417,8 +2456,8 @@ async function runValidation(answers, includeHostedCheck, options = {}) {
   });
   checks.push({
     name: "hooks",
-    status: answers.installHooks && targetClient === "claude-code" ? detection.files.claudeDir ? "pass" : "warn" : "pass",
-    detail: answers.installHooks && targetClient === "claude-code" ? detection.files.claudeDir ? "~/.claude detected" : "~/.claude missing" : "Hooks not requested"
+    status: answers.installHooks && targetClient === "claude-code" ? detection.files.claudeProjectSettings ? "pass" : "warn" : "pass",
+    detail: answers.installHooks && targetClient === "claude-code" ? detection.files.claudeProjectSettings ? "Project .claude/settings.json hooks present" : "Project .claude/settings.json hooks missing" : "Hooks not requested"
   });
   if (targetClient === "claude-code" || targetClient === "claude-desktop") {
     checks.push(...getClaudeClientChecks(effectiveAnswers, detection));
@@ -2679,7 +2718,7 @@ function printSuccess(answers, report) {
   }
   if (answers.aiClient === "claude-code" && answers.profile !== "runtime-only") {
     console.log(
-      chalk.green("   \u2713 ~/.claude/settings.json") + chalk.dim(" - Claude Code Hosted MCP server")
+      chalk.green("   \u2713 Claude Code") + chalk.dim(" - .mcp.json MCP config, .claude/settings.json hooks when enabled")
     );
   }
   console.log(chalk.green("   \u2713 .snipara/companion") + chalk.dim(" - Local pack + doctor report"));
@@ -2799,6 +2838,8 @@ function detectEnvironment() {
       sniparaProject: fs.existsSync(path.join(process.cwd(), ".snipara", "project")),
       claudeDir: fs.existsSync(path.join(homedir(), ".claude")),
       claudeSettings: fs.existsSync(claudePaths.codeSettingsPath),
+      claudeProjectDir: fs.existsSync(path.join(process.cwd(), ".claude")),
+      claudeProjectSettings: fs.existsSync(path.join(process.cwd(), ".claude", "settings.json")),
       claudeDesktopConfig: fs.existsSync(claudePaths.desktopConfigPath),
       cursorDir: fs.existsSync(path.join(homedir(), ".cursor")),
       sniparaCompanionPack: fs.existsSync(path.join(process.cwd(), ".snipara", "companion")),
@@ -3024,7 +3065,8 @@ function detectRepoProjectSlug() {
   try {
     const remote = execSync("git remote get-url origin", {
       encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 500
     }).trim();
     const match = remote.match(/[/:]([^/]+?)(?:\.git)?$/);
     if (match) {
@@ -3041,7 +3083,8 @@ function detectGitRepository() {
   try {
     const remoteUrl = execSync("git remote get-url origin", {
       encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 500
     }).trim();
     const match = remoteUrl.match(/github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?$/) || remoteUrl.match(/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/);
     if (!match) {
@@ -3065,7 +3108,8 @@ function detectGitBranch() {
   try {
     const branch = execSync("git branch --show-current", {
       encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 500
     }).trim();
     if (branch) {
       return branch;
@@ -3075,7 +3119,8 @@ function detectGitBranch() {
   try {
     const branch = execSync("git rev-parse --abbrev-ref HEAD", {
       encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 500
     }).trim();
     return branch && branch !== "HEAD" ? branch : "main";
   } catch {
@@ -3085,7 +3130,8 @@ function detectGitBranch() {
 function isGitRepo() {
   try {
     execSync("git rev-parse --is-inside-work-tree", {
-      stdio: "ignore"
+      stdio: "ignore",
+      timeout: 500
     });
     return true;
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "1.3.37",
+  "version": "1.3.38",
   "description": "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   "main": "dist/index.js",
   "type": "module",