create-snipara 1.3.50 → 1.3.52

package/README.md

@@ -112,6 +112,8 @@ That distinction matters:
 - creates `AGENTS.md` and `CLAUDE.md` when missing, or appends a marked Snipara section when those files already exist
 - creates `.cursor/rules/snipara.mdc` and `.codex/config.toml` when those files do not already exist
 - validates Codex config against Hosted MCP plus `bearer_token_env_var = "SNIPARA_API_KEY"` and tells users to restart Codex after MCP config changes
+- installs local code overlay Git hooks by default for Claude Code and Codex
+  companion setups, unless `--skip-hooks` is passed
 - runs a real hosted MCP `tools/list` check and warns if the server still advertises legacy `rlm_*` duplicate tools
 - generates Mistral Le Chat, Mistral Vibe, and LangChain `ChatMistralAI.bindTools` references without embedding secrets
 - writes client-specific companion packs such as `.snipara/companion/CODEX.md` or `.snipara/companion/GEMINI.md`
@@ -119,7 +121,7 @@ That distinction matters:
 - generates `.snipara/companion/README.md`
 - generates `.snipara/companion/commands.json`
 - generates `.snipara/companion/doctor.json`
-- optionally installs Claude Code hooks
+- optionally installs Claude Code agent hooks and companion local code overlay Git hooks
 - supports `doctor`, `repair`, `upgrade`, and `print-config`
 
 ## Product Boundary

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "1.3.50",
+  version: "1.3.52",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -178,6 +178,9 @@ function getAutomationClientId(aiClient) {
   }
   return aiClient;
 }
+function shouldInstallDefaultHooks(aiClient) {
+  return aiClient === "claude-code" || aiClient === "codex";
+}
 function buildProgram() {
   const program = new Command();
   program.name("create-snipara").description("Scaffold hosted Snipara MCP config plus companion workflow helpers").version(VERSION);
@@ -370,6 +373,7 @@ async function runInit(options) {
   }
   await updateEnvFiles(answers);
   await createCompanionConfig(answers);
+  await installLocalCodeOverlayHooks(answers);
   await syncRemoteAutomationClient(answers, { enabled: !normalizedOptions.skipTest });
   await createCompanionPack(answers);
   const validationReport = await runValidation(answers, !normalizedOptions.skipTest);
@@ -418,6 +422,7 @@ async function runRepair(options) {
   await createAgentTemplates(answers);
   await updateEnvFiles(answers);
   await createCompanionConfig(answers);
+  await installLocalCodeOverlayHooks(answers);
   await createCompanionPack(answers);
   if (answers.installHooks && answers.aiClient === "claude-code") {
     await installClaudeCodeHooks(answers);
@@ -451,9 +456,13 @@ async function runUpgrade(options) {
   await createProjectBinding(upgradedAnswers);
   await createAgentTemplates(upgradedAnswers);
   await createCompanionConfig(upgradedAnswers);
-  if (options.withHooks || answers.installHooks) {
+  if ((options.withHooks || answers.installHooks) && upgradedAnswers.aiClient === "claude-code") {
     await installClaudeCodeHooks({ ...answers, installHooks: true });
   }
+  await installLocalCodeOverlayHooks({
+    ...upgradedAnswers,
+    installHooks: Boolean(options.withHooks || answers.installHooks)
+  });
   await createCompanionPack(upgradedAnswers);
   const report = await runValidation(upgradedAnswers, true);
   writeDoctorReport(report);
@@ -647,7 +656,7 @@ async function gatherConfiguration(options) {
       type: showAdvancedPrompts ? "confirm" : null,
       name: "installHooks",
       message: "Generate local hooks when supported?",
-      initial: detectedClient === "claude-code"
+      initial: shouldInstallDefaultHooks(requestedClient || detectedClient)
     },
     {
       type: (_, values) => detectedGitRepo && showAdvancedPrompts && !options.skipGithub && (values.profile || initialProfile) !== "runtime-only" ? "confirm" : null,
@@ -692,7 +701,7 @@ async function gatherConfiguration(options) {
     skipMcp: !!options.skipMcp,
     skipRuntime: !!options.skipRuntime,
     withOrchestrator: Boolean(options.withOrchestrator || response.installOrchestrator),
-    skipHooks: !!options.skipHooks || !response.installHooks,
+    skipHooks: !!options.skipHooks || !(typeof response.installHooks === "boolean" ? response.installHooks : shouldInstallDefaultHooks(requestedClient || response.aiClient || detectedClient)),
     configureGitHub: Boolean(
       (response.configureGitHub || options.github || options.githubPath) && detectedGitRepo && !options.skipGithub
     ),
@@ -838,13 +847,13 @@ function buildAnswersFromProfile(input) {
       installCompanion: true,
       installMcp: false,
       installRuntime: false,
-      installHooks: input.aiClient === "claude-code"
+      installHooks: shouldInstallDefaultHooks(input.aiClient)
     },
     "full-stack": {
       installCompanion: true,
       installMcp: false,
       installRuntime: true,
-      installHooks: input.aiClient === "claude-code"
+      installHooks: shouldInstallDefaultHooks(input.aiClient)
     },
     "runtime-only": {
       installCompanion: false,
@@ -2061,6 +2070,41 @@ async function createCompanionConfig(answers) {
   ensureGitignoreEntry(".snipara/companion/config.json", "# Snipara local companion config");
   console.log(chalk.green("   \u2713 Configured local companion config"));
 }
+async function installLocalCodeOverlayHooks(answers) {
+  if (!answers.installCompanion || !answers.installHooks || answers.profile === "runtime-only") {
+    return;
+  }
+  if (!isGitRepo()) {
+    console.log(
+      chalk.dim("   Skipped local code overlay Git hooks: current directory is not a Git repo")
+    );
+    return;
+  }
+  const companionCommand = detectCompanionCommand();
+  if (!companionCommand) {
+    console.log(
+      chalk.yellow(
+        `   \u26A0 Could not install local code overlay Git hooks: ${COMPANION_COMMAND_NAME} ${MIN_COMPANION_VERSION}+ is not on PATH`
+      )
+    );
+    return;
+  }
+  const spinner = ora("Installing local code overlay Git hooks").start();
+  try {
+    execSync(`${companionCommand} code hooks install --json`, {
+      cwd: process.cwd(),
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 3e4
+    });
+    spinner.succeed("Installed local code overlay Git hooks");
+  } catch (error) {
+    spinner.warn("Local code overlay Git hooks were not installed");
+    const message = error instanceof Error && error.message ? error.message : "unknown companion hook error";
+    console.log(chalk.dim(`   Retry with: ${COMPANION_NPX_COMMAND} code hooks install`));
+    console.log(chalk.dim(`   ${message}`));
+  }
+}
 async function syncRemoteAutomationClient(answers, options) {
   if (!options.enabled || answers.apiKeyType === "none" || !answers.apiKey || answers.apiKey.includes("YOUR_") || !answers.projectSlug) {
     return;
@@ -3404,7 +3448,7 @@ function loadExistingAnswers(options) {
     skipMcp: options.withMcp === true ? false : !detection.existingConfig.hasSniparaServer && effectiveProfile === "runtime-only",
     skipRuntime: options.withRuntime === true ? false : !detection.existingConfig.hasRuntimeServer && effectiveProfile !== "full-stack" && effectiveProfile !== "runtime-only",
     withOrchestrator: Boolean(options.withOrchestrator || detection.tooling.orchestratorCli),
-    skipHooks: options.withHooks ? false : detection.aiClient !== "claude-code"
+    skipHooks: options.withHooks ? false : !shouldInstallDefaultHooks(detection.aiClient)
   });
 }
 function resolveMaintenanceProfile(detection, explicitProfile) {

package/package.json

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