create-snipara 1.3.32 → 1.3.34

package/README.md

@@ -106,7 +106,8 @@ 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`, `CLAUDE.md`, `.cursor/rules/snipara.mdc`, and `.codex/config.toml` when those files do not already exist
+- 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
 - 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`
@@ -162,6 +163,10 @@ 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.32",
+  version: "1.3.34",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -1152,12 +1152,12 @@ async function createAgentTemplates(answers) {
     fs.writeFileSync(template.path, template.content);
   }
   console.log(chalk.green("   Created .snipara/templates agent snippets"));
-  writeIfMissing(
+  writeOrMergeMarkdownInstructions(
     path.join(process.cwd(), "AGENTS.md"),
     buildAgentsMdTemplate(answers),
     "AGENTS.md"
   );
-  writeIfMissing(
+  writeOrMergeMarkdownInstructions(
     path.join(process.cwd(), "CLAUDE.md"),
     buildClaudeMdTemplate(answers),
     "CLAUDE.md"
@@ -1186,6 +1186,45 @@ 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}`;
 }
@@ -1641,31 +1680,18 @@ 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 globalConfig = {
-    ...existingGlobalConfig,
-    apiKey: answers.apiKey,
-    apiUrl: API_URL
-  };
   const workspaceConfig = {
-    projectId: answers.projectSlug,
+    ...existingWorkspaceConfig,
+    apiKey: answers.apiKey,
+    apiUrl: API_URL,
+    projectId: answers.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 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");
+  ensureGitignoreEntry(".snipara/companion/config.json", "# Snipara local companion config");
+  console.log(chalk.green("   \u2713 Configured local companion config"));
 }
 function readCompanionConfigFile(filePath) {
   if (!fs.existsSync(filePath)) {

package/package.json

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