create-snipara 1.3.51 → 1.3.53

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.51",
+  version: "1.3.53",
   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,
@@ -1467,7 +1476,8 @@ Use Snipara Hosted MCP before answering project-specific questions.
 - Start substantial work with \`snipara_recall\` and a targeted \`snipara_context_query\`.
 - Use \`snipara_context_query\` for source truth and \`snipara_get_chunk\` for exact cited sections.
 - When \`snipara_context_query\` returns \`answer_pack\`, use its facts, caveats, source map, and verification checklist before drafting claims.
-- Use \`snipara_code_callers\`, \`snipara_code_imports\`, \`snipara_code_neighbors\`, or \`snipara_code_shortest_path\` for structural code questions.
+- Use \`snipara_code_callers\`, \`snipara_code_imports\`, \`snipara_code_neighbors\`, or \`snipara_code_shortest_path\` for canonical structural code questions.
+- When local commits or a dirty working tree matter and \`snipara-companion\` is installed, use \`snipara-companion code callers/imports/neighbors/shortest-path/impact\`; it auto-selects hosted MCP or the local overlay and reports \`sourceSelection\`.
 - On paid Context plans, use \`snipara_code_symbol_card\` before editing important symbols and \`snipara_code_impact\` before risky multi-file changes or PR reviews.
 - Check every \`snipara_code_*\` response for indexed commit SHA, indexing time, included files, coverage, and freshness warnings.
 - Use local file reads, \`rg\`, \`git status --short\`, and tests for exact edits/current working tree; use Snipara for architecture and indexed code graph context.
@@ -1497,7 +1507,8 @@ This workspace uses Snipara Hosted MCP for current project context, business/cli
 - Use \`snipara_context_query\` for docs, business context, current client/project truth, and narrative source material.
 - When \`snipara_context_query\` returns \`answer_pack\`, use its facts, caveats, source map, and verification checklist before drafting claims.
 - Use \`snipara_get_chunk\` before relying on exact cited wording from reference-based results.
-- Use \`snipara_code_callers\`, \`snipara_code_imports\`, \`snipara_code_neighbors\`, or \`snipara_code_shortest_path\` for structural code questions.
+- Use \`snipara_code_callers\`, \`snipara_code_imports\`, \`snipara_code_neighbors\`, or \`snipara_code_shortest_path\` for canonical structural code questions.
+- When local commits or a dirty working tree matter and \`snipara-companion\` is installed, use \`snipara-companion code callers/imports/neighbors/shortest-path/impact\`; it auto-selects hosted MCP or the local overlay and reports \`sourceSelection\`.
 - On paid Context plans, use \`snipara_code_symbol_card\` before editing important symbols and \`snipara_code_impact\` before risky multi-file changes or PR reviews.
 - Check every \`snipara_code_*\` response for indexed commit SHA, indexing time, included files, coverage, and freshness warnings.
 - Use \`snipara_plan\` or \`snipara_decompose\` only for complex work and only when available.
@@ -2061,6 +2072,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;
@@ -2430,7 +2476,7 @@ async function createCompanionPack(answers) {
   fs.mkdirSync(packDir, { recursive: true });
   const readme = `# Snipara Companion Pack
 
-This project uses Snipara as a hosted-first context and memory layer with local companion workflow helpers.
+This project uses Snipara as a hosted-first project intelligence layer with source-backed context, reviewed memory, and local companion workflow helpers.
 
 ## Install Profile
 
@@ -3404,7 +3450,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.51",
+  "version": "1.3.53",
   "description": "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   "main": "dist/index.js",
   "type": "module",