create-snipara 1.3.33 → 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.33",
+  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}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "1.3.33",
+  "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",