create-snipara 1.3.36 → 1.3.37

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.36",
+  version: "1.3.37",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -163,10 +163,19 @@ function getCompanionInitClientFlag(aiClient) {
   const companionClient = supportedClientMap[aiClient];
   return companionClient ? ` --client ${companionClient}` : "";
 }
+function getAutomationClientId(aiClient) {
+  if (aiClient === "other" || aiClient === "claude-desktop") {
+    return "custom";
+  }
+  return aiClient;
+}
 function buildProgram() {
   const program = new Command();
   program.name("create-snipara").description("Scaffold hosted Snipara MCP config plus companion workflow helpers").version(VERSION);
-  program.command("init").description("Install and configure Snipara for this project").option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
+  program.command("init").description("Install and configure Snipara for this project").option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option(
+    "--client <client>",
+    "AI client: claude-code, cursor, windsurf, codex, gemini, chatgpt, vscode, continue, claude-desktop, other"
+  ).option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
     "--profile <profile>",
     "Install profile: hosted-only, hosted-companion, full-stack, runtime-only"
   ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting").action(async (options) => {
@@ -200,7 +209,10 @@ function buildProgram() {
   return program;
 }
 function addSharedRootOptions(program) {
-  program.option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
+  program.option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option(
+    "--client <client>",
+    "AI client: claude-code, cursor, windsurf, codex, gemini, chatgpt, vscode, continue, claude-desktop, other"
+  ).option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
     "--profile <profile>",
     "Install profile: hosted-only, hosted-companion, full-stack, runtime-only"
   ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting");
@@ -233,6 +245,7 @@ function parseInitOptionsFromArgv(args) {
     "--api-key": "apiKey",
     "--slug": "slug",
     "--project-id": "projectId",
+    "--client": "client",
     "--profile": "profile",
     "--github-path": "githubPath"
   };
@@ -295,6 +308,7 @@ async function runInit(options) {
   }
   await updateEnvFiles(answers);
   await createCompanionConfig(answers);
+  await syncRemoteAutomationClient(answers, { enabled: !options.skipTest });
   await createCompanionPack(answers);
   const validationReport = await runValidation(answers, !options.skipTest);
   writeDoctorReport(validationReport);
@@ -454,6 +468,7 @@ function printBanner() {
 async function gatherConfiguration(options) {
   console.log(chalk.bold("\n\u{1F4CB} Project Configuration\n"));
   const detectedClient = detectAiClient();
+  const requestedClient = normalizeClientOption(options.client);
   const existingConfig = getExistingConfig();
   const projectSlugResolution = resolveProjectSlug(existingConfig);
   let detectedSlug = projectSlugResolution.slug;
@@ -486,7 +501,7 @@ async function gatherConfiguration(options) {
       apiKey: providedApiKey || "YOUR_API_KEY_HERE",
       apiKeyType: providedApiKey ? "api" : "none",
       profile: initialProfile,
-      aiClient: detectedClient,
+      aiClient: requestedClient || detectedClient,
       skipCompanion: !!options.skipCompanion,
       skipMcp: !!options.skipMcp,
       skipRuntime: !!options.skipRuntime,
@@ -553,7 +568,9 @@ async function gatherConfiguration(options) {
       message: "Which AI client are you using?",
       initial: Math.max(
         0,
-        AI_CLIENT_CHOICES.findIndex((choice) => choice.value === detectedClient)
+        AI_CLIENT_CHOICES.findIndex(
+          (choice) => choice.value === (requestedClient || detectedClient)
+        )
       ),
       choices: AI_CLIENT_CHOICES
     },
@@ -604,7 +621,7 @@ async function gatherConfiguration(options) {
     apiKey: apiKey || "",
     apiKeyType,
     profile: response.profile || initialProfile,
-    aiClient: response.aiClient || detectedClient,
+    aiClient: requestedClient || response.aiClient || detectedClient,
     skipCompanion: !!options.skipCompanion,
     skipMcp: !!options.skipMcp,
     skipRuntime: !!options.skipRuntime,
@@ -702,7 +719,8 @@ function normalizeClientOption(value) {
     chatgpt: "chatgpt",
     vscode: "vscode",
     continue: "continue",
-    other: "other"
+    other: "other",
+    custom: "other"
   };
   const client = aliases[normalized];
   if (!client) {
@@ -870,10 +888,14 @@ async function runDeviceAuthorization() {
   spinner.fail("Authorization expired");
   throw new Error("device code expired");
 }
-async function postJson(url, body, allowErrorResponse = false) {
+async function postJson(url, body, allowErrorResponse = false, init = {}) {
+  const headers = {
+    ...init.headers ?? {},
+    "Content-Type": "application/json"
+  };
   const response = await fetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
+    method: init.method ?? "POST",
+    headers,
     body: JSON.stringify(body)
   });
   const data = await response.json().catch(() => ({}));
@@ -1679,31 +1701,49 @@ 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,
-    sessionId: typeof existingWorkspaceConfig.sessionId === "string" && existingWorkspaceConfig.sessionId ? existingWorkspaceConfig.sessionId : `sess_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+    ...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)}`,
+    client: getAutomationClientId(answers.aiClient)
   };
-  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"));
+  ensureGitignoreEntry(".snipara/companion/config.json", "# Snipara local companion config");
+  console.log(chalk.green("   \u2713 Configured local companion config"));
 }
-function getGlobalCompanionConfigPath() {
-  return path.join(homedir(), ".rlmsaas", "config.json");
+async function syncRemoteAutomationClient(answers, options) {
+  if (!options.enabled || answers.apiKeyType === "none" || !answers.apiKey || answers.apiKey.includes("YOUR_") || !answers.projectSlug) {
+    return;
+  }
+  const automationClient = getAutomationClientId(answers.aiClient);
+  const url = `${BASE_URL}/api/cli/projects/${encodeURIComponent(
+    answers.projectSlug
+  )}/automation-client`;
+  try {
+    const response = await postJson(
+      url,
+      { automationClient },
+      false,
+      {
+        method: "PATCH",
+        headers: { "X-API-Key": answers.apiKey }
+      }
+    );
+    if (response.success === false) {
+      throw new Error(response.message || "dashboard rejected automation client update");
+    }
+    console.log(chalk.green(`   \u2713 Synced dashboard automation client: ${automationClient}`));
+  } catch (error) {
+    console.log(
+      chalk.yellow(
+        `   \u26A0\uFE0F  Could not sync dashboard automation client: ${error instanceof Error ? error.message : "unknown error"}`
+      )
+    );
+  }
 }
 function readCompanionConfigFile(filePath) {
   if (!fs.existsSync(filePath)) {

package/package.json

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