create-snipara 1.3.34 → 1.3.36

package/README.md

@@ -106,8 +106,7 @@ That distinction matters:
 - installs optional `snipara-orchestrator` for proof gates, drift checks, and htask workflows when requested
 - configures `.mcp.json`
 - generates merge-ready AI agent templates in `.snipara/templates/`, including Pro+ symbol-card, code-impact, and managed workflow guidance for paid Context plans
-- 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
+- creates `AGENTS.md`, `CLAUDE.md`, `.cursor/rules/snipara.mdc`, and `.codex/config.toml` when those files do not already exist
 - writes client-specific companion packs such as `.snipara/companion/CODEX.md` or `.snipara/companion/GEMINI.md`
 - updates `.env`, `.env.local`, and `.env.example`
 - generates `.snipara/companion/README.md`
@@ -163,10 +162,6 @@ The generated agent templates cover:
 - ChatGPT/OpenAI HTTP MCP snippet
 - Gemini, VS Code, Continue, and custom HTTP MCP reference snippets
 
-Existing root `AGENTS.md` and `CLAUDE.md` files are not replaced. The installer
-adds or refreshes a marked Snipara section so project-specific instructions stay
-intact.
-
 When `snipara-companion` is installed, the companion pack also includes the compaction-safe managed workflow:
 
 ```bash

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "1.3.34",
+  version: "1.3.36",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -285,6 +285,9 @@ async function runInit(options) {
   if (answers.profile !== "runtime-only" || answers.installRuntime) {
     await createMcpConfig(answers);
   }
+  if (answers.aiClient === "claude-code" && answers.profile !== "runtime-only") {
+    await createClaudeCodeConfig(answers);
+  }
   await createProjectBinding(answers);
   await createAgentTemplates(answers);
   if (answers.installHooks && answers.aiClient === "claude-code") {
@@ -331,6 +334,9 @@ async function runRepair(options) {
     await installNodeCompanion(true);
   }
   await createMcpConfig(answers);
+  if (answers.aiClient === "claude-code" && answers.profile !== "runtime-only") {
+    await createClaudeCodeConfig(answers);
+  }
   await createProjectBinding(answers);
   await createAgentTemplates(answers);
   await updateEnvFiles(answers);
@@ -362,6 +368,9 @@ async function runUpgrade(options) {
   if (options.withMcp || options.withRuntime || detection.files.mcpConfig) {
     await createMcpConfig(upgradedAnswers);
   }
+  if (upgradedAnswers.aiClient === "claude-code" && upgradedAnswers.profile !== "runtime-only") {
+    await createClaudeCodeConfig(upgradedAnswers);
+  }
   await createProjectBinding(upgradedAnswers);
   await createAgentTemplates(upgradedAnswers);
   await createCompanionConfig(upgradedAnswers);
@@ -1070,13 +1079,7 @@ async function createMcpConfig(answers) {
     }
   }
   if (answers.profile !== "runtime-only") {
-    mcpConfig.mcpServers.snipara = {
-      type: "http",
-      url: `${API_URL}/mcp/${answers.projectSlug}`,
-      headers: {
-        "X-API-Key": answers.apiKey || "YOUR_API_KEY_HERE"
-      }
-    };
+    mcpConfig.mcpServers.snipara = buildHostedMcpServer(answers);
   }
   if (answers.installRuntime) {
     mcpConfig.mcpServers[SANDBOX_SERVER_NAME] = {
@@ -1096,6 +1099,48 @@ async function createMcpConfig(answers) {
     await createClaudeDesktopConfig(answers);
   }
 }
+function buildHostedMcpServer(answers) {
+  return {
+    type: "http",
+    url: buildHostedMcpEndpoint(answers),
+    headers: {
+      "X-API-Key": answers.apiKey || "YOUR_API_KEY_HERE"
+    }
+  };
+}
+function asObjectRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+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."));
+  }
+}
 async function createProjectBinding(answers) {
   if (answers.profile === "runtime-only") {
     return;
@@ -1152,12 +1197,12 @@ async function createAgentTemplates(answers) {
     fs.writeFileSync(template.path, template.content);
   }
   console.log(chalk.green("   Created .snipara/templates agent snippets"));
-  writeOrMergeMarkdownInstructions(
+  writeIfMissing(
     path.join(process.cwd(), "AGENTS.md"),
     buildAgentsMdTemplate(answers),
     "AGENTS.md"
   );
-  writeOrMergeMarkdownInstructions(
+  writeIfMissing(
     path.join(process.cwd(), "CLAUDE.md"),
     buildClaudeMdTemplate(answers),
     "CLAUDE.md"
@@ -1186,45 +1231,6 @@ function writeIfMissing(filePath, content, label) {
   fs.writeFileSync(filePath, content);
   console.log(chalk.green(`   Created ${label}`));
 }
-function markdownInstructionMarker(label, type) {
-  return `<!-- snipara:instructions ${label}:${type} -->`;
-}
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function ensureTrailingNewline(content) {
-  return content.endsWith("\n") ? content : `${content}
-`;
-}
-function buildMarkdownInstructionBlock(label, content) {
-  return [
-    markdownInstructionMarker(label, "start"),
-    content.trimEnd(),
-    markdownInstructionMarker(label, "end"),
-    ""
-  ].join("\n");
-}
-function writeOrMergeMarkdownInstructions(filePath, content, label) {
-  if (!fs.existsSync(filePath)) {
-    fs.writeFileSync(filePath, content);
-    console.log(chalk.green(`   Created ${label}`));
-    return;
-  }
-  const current = fs.readFileSync(filePath, "utf8");
-  if (current.trim() === content.trim()) {
-    console.log(chalk.dim(`   ${label} already contains Snipara instructions`));
-    return;
-  }
-  const block = buildMarkdownInstructionBlock(label, content);
-  const start = markdownInstructionMarker(label, "start");
-  const end = markdownInstructionMarker(label, "end");
-  const existingBlockPattern = new RegExp(
-    `${escapeRegExp(start)}[\\s\\S]*?${escapeRegExp(end)}\\n?`
-  );
-  const nextContent = existingBlockPattern.test(current) ? ensureTrailingNewline(current.replace(existingBlockPattern, block)) : `${current}${current.endsWith("\n\n") ? "" : current.endsWith("\n") ? "\n" : "\n\n"}${block}`;
-  fs.writeFileSync(filePath, nextContent);
-  console.log(chalk.green(`   Updated ${label} with Snipara instructions`));
-}
 function buildHostedMcpEndpoint(answers) {
   return `${API_URL}/mcp/${answers.projectSlug}`;
 }
@@ -1269,8 +1275,7 @@ Agent task lifecycle:
 8. Use \`snipara_plan\` or \`snipara_decompose\` only for FULL-mode work and only
    when the hosted server exposes them.
 9. When the LLM has produced a visible multi-phase plan and \`snipara-companion\`
-   is installed, run \`snipara-companion workflow start --goal "<goal>" --plan-file
-   <plan_file>\`, then use \`workflow phase-start\`, \`workflow phase-commit\`,
+   is installed, run \`snipara-companion workflow start --goal "<goal>" --plan-file <plan_file>\`, then use \`workflow phase-start\`, \`workflow phase-commit\`,
    \`workflow resume\`, and \`final-commit\` so compaction cannot lose the next
    phase.
 10. Use local file reads, \`rg\`, git commands, and test commands for exact edits,
@@ -1423,13 +1428,7 @@ async function createClaudeDesktopConfig(answers) {
       config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
     }
     config.mcpServers = config.mcpServers || {};
-    config.mcpServers.snipara = {
-      type: "http",
-      url: buildHostedMcpEndpoint(answers),
-      headers: {
-        "X-API-Key": answers.apiKey
-      }
-    };
+    config.mcpServers.snipara = buildHostedMcpServer(answers);
     if (answers.installRuntime) {
       config.mcpServers[SANDBOX_SERVER_NAME] = {
         command: detectSandboxCommand() || SANDBOX_COMMAND_NAME,
@@ -1680,18 +1679,31 @@ async function createCompanionConfig(answers) {
   }
   const configDir = path.join(process.cwd(), ".snipara", "companion");
   const configPath = path.join(configDir, "config.json");
+  const globalConfigPath = getGlobalCompanionConfigPath();
   fs.mkdirSync(configDir, { recursive: true });
+  fs.mkdirSync(path.dirname(globalConfigPath), { recursive: true });
+  const existingGlobalConfig = readCompanionConfigFile(globalConfigPath);
   const existingWorkspaceConfig = readCompanionConfigFile(configPath);
-  const workspaceConfig = {
-    ...existingWorkspaceConfig,
+  const globalConfig = {
+    ...existingGlobalConfig,
     apiKey: answers.apiKey,
-    apiUrl: API_URL,
-    projectId: answers.projectId || answers.projectSlug,
+    apiUrl: API_URL
+  };
+  const workspaceConfig = {
+    projectId: answers.projectSlug,
     sessionId: typeof existingWorkspaceConfig.sessionId === "string" && existingWorkspaceConfig.sessionId ? existingWorkspaceConfig.sessionId : `sess_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
   };
+  fs.writeFileSync(globalConfigPath, JSON.stringify(globalConfig, null, 2) + "\n");
   fs.writeFileSync(configPath, JSON.stringify(workspaceConfig, null, 2) + "\n");
-  ensureGitignoreEntry(".snipara/companion/config.json", "# Snipara local companion config");
-  console.log(chalk.green("   \u2713 Configured local companion config"));
+  ensureGitignoreEntry(
+    ".snipara/companion/config.json",
+    "# Snipara local companion workspace config"
+  );
+  console.log(chalk.green("   \u2713 Configured global companion auth"));
+  console.log(chalk.green("   \u2713 Configured local companion workspace"));
+}
+function getGlobalCompanionConfigPath() {
+  return path.join(homedir(), ".rlmsaas", "config.json");
 }
 function readCompanionConfigFile(filePath) {
   if (!fs.existsSync(filePath)) {
@@ -1926,7 +1938,7 @@ function getClientPackFilename(client) {
 }
 function getClientConfigArtifacts(client) {
   if (client === "claude-code") {
-    return ["AGENTS.md", "CLAUDE.md", ".claude/settings.json when hooks are installed"];
+    return ["AGENTS.md", "CLAUDE.md", "~/.claude/settings.json MCP server"];
   }
   if (client === "cursor") {
     return [".mcp.json", ".cursor/rules/snipara.mdc", "dashboard automation bundle when installed"];
@@ -2199,7 +2211,7 @@ function getClaudeClientChecks(answers, detection) {
     checks.push({
       name: "claude_code_settings",
       status: detection.files.claudeSettings ? codeSettingsHasSnipara ? "pass" : "warn" : "warn",
-      detail: detection.files.claudeSettings ? codeSettingsHasSnipara ? "~/.claude/settings.json references Snipara" : "~/.claude/settings.json exists but no Snipara MCP server was found" : "~/.claude/settings.json not found; Claude may require Settings -> MCP UI setup"
+      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"
     });
   }
   if (answers.aiClient === "claude-desktop") {
@@ -2625,6 +2637,11 @@ function printSuccess(answers, report) {
   if (answers.profile !== "runtime-only") {
     console.log(chalk.green("   \u2713 .mcp.json") + chalk.dim(" - Hosted MCP config"));
   }
+  if (answers.aiClient === "claude-code" && answers.profile !== "runtime-only") {
+    console.log(
+      chalk.green("   \u2713 ~/.claude/settings.json") + chalk.dim(" - Claude Code Hosted MCP server")
+    );
+  }
   console.log(chalk.green("   \u2713 .snipara/companion") + chalk.dim(" - Local pack + doctor report"));
   const failedChecks = report.checks.filter((check) => check.status === "fail");
   const warnedChecks = report.checks.filter((check) => check.status === "warn");
@@ -2637,7 +2654,7 @@ function printSuccess(answers, report) {
   printNextStep("Restart your AI client if you created or changed hosted MCP config.");
   if (answers.aiClient === "claude-code") {
     printNextStep(
-      "For Claude Code, confirm Snipara appears in Settings -> MCP or ToolSearch; local files alone do not prove Claude loaded the server."
+      "For Claude Code, start a new session and confirm Snipara appears in Settings -> MCP or ToolSearch."
     );
     printNextStep("If Snipara tools are missing, run: npx create-snipara doctor --client claude");
   }

package/package.json

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