create-snipara 1.3.16 → 1.3.18

package/README.md

@@ -16,7 +16,7 @@ so an LLM client can use Snipara context and reviewed memory.
 
 Use it for:
 
-- Hosted MCP onboarding for Codex, Claude Code, Cursor, ChatGPT Desktop, and similar clients
+- Hosted MCP onboarding for Claude Code, Cursor, Windsurf, Codex, Gemini, VS Code/Copilot, Continue, ChatGPT Desktop, and similar clients
 - free account signup with reviewed Context + Memory
 - local project wiring, `doctor`, `repair`, and `upgrade`
 - GitHub repository sync and PR Answer Packs approval when the current folder is a GitHub repo
@@ -32,8 +32,8 @@ flowchart LR
     Project["Local project"] --> CLI["npx create-snipara"]
     CLI --> Auth["Snipara auth and project key"]
     CLI --> MCP["Hosted MCP config"]
-    CLI --> Templates["AGENTS.md, CLAUDE.md, Cursor, Codex snippets"]
-    MCP --> Agents["Codex, Claude Code, Cursor, ChatGPT Desktop"]
+    CLI --> Templates["AGENTS.md, CLAUDE.md, Cursor, Codex, MCP references"]
+    MCP --> Agents["Claude Code, Cursor, Codex, Gemini, VS Code, ChatGPT"]
     Templates --> Agents
     Agents --> Context["Snipara context and memory"]
 ```
@@ -52,6 +52,7 @@ The default CLI path wires the local companion around those surfaces:
 
 - `snipara-companion` for local workflow commands and managed phase commits; legacy `rlm-hook` commands remain compatible
 - `snipara-sandbox` for optional local code execution
+- `snipara-orchestrator` only when explicitly requested with `--with-orchestrator`
 - local config, env files, hook scripts, and a project companion pack
 - `snipara-mcp` only for local stdio compatibility, development, or testing
 
@@ -59,12 +60,12 @@ The default CLI path wires the local companion around those surfaces:
 
 The CLI now works around explicit install profiles:
 
-| Profile            | What it installs                              | Best for                                            |
-| ------------------ | --------------------------------------------- | --------------------------------------------------- |
-| `hosted-companion` | MCP + `snipara-companion`                     | Default: hosted context plus managed local workflow |
-| `hosted-only`      | Hosted MCP config only                        | Locked-down or minimal environments                 |
-| `full-stack`       | MCP + `snipara-companion` + `snipara-sandbox` | Hosted context plus sandboxed local execution       |
-| `runtime-only`     | `snipara-sandbox` only                        | Local execution without hosted API                  |
+| Profile            | What it installs                              | Best for                                                                                                            |
+| ------------------ | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `hosted-companion` | MCP + `snipara-companion`                     | Default: hosted context plus managed local workflow                                                                 |
+| `hosted-only`      | Hosted MCP config only                        | Locked-down or minimal environments                                                                                 |
+| `full-stack`       | MCP + `snipara-companion` + `snipara-sandbox` | Hosted context plus sandboxed local execution. Does not include orchestrator unless `--with-orchestrator` is passed |
+| `runtime-only`     | `snipara-sandbox` only                        | Local execution without hosted API                                                                                  |
 
 Default profile: `hosted-companion`
 
@@ -74,7 +75,7 @@ Free onboarding is now **Context + Memory**, not Context-only:
 
 - Context Free: three projects and 1,000 context queries/month
 - Memory Free: reviewed hosted memories for continuity across sessions
-- Hosted MCP: direct connection for Claude Code, Codex, Cursor, ChatGPT Desktop, and other MCP clients
+- Hosted MCP: direct connection for Claude Code, Cursor, Windsurf, Codex, Gemini, VS Code/Copilot, Continue, ChatGPT Desktop, and other MCP clients
 
 The CLI opens a browser device-flow login when the user does not already have a key, auto-provisions the free Context + Memory account when needed, then writes the returned API key into the local MCP config.
 
@@ -102,9 +103,11 @@ That distinction matters:
 - explains the GitHub PR Answer Packs path for AI-assisted pull request workflows
 - installs `snipara-companion` by default for local managed workflows
 - installs optional `snipara-sandbox`
+- 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
+- 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`
 - generates `.snipara/companion/commands.json`
@@ -139,6 +142,8 @@ By default, this uses the recommended `hosted-companion` setup: hosted MCP plus
 the local `snipara-companion` workflow helper. Legacy `rlm-hook` commands remain
 compatible. Add `--advanced` when you want profile selection, project id entry,
 hook prompts, GitHub automation prompts, or sandbox provider prompts.
+Use `--with-orchestrator` only when you explicitly need the advanced production
+validation and htask package; it is not part of `full-stack` by default.
 
 The advanced flow asks for:
 
@@ -155,6 +160,7 @@ The generated agent templates cover:
 - Cursor `.cursor/rules/snipara.mdc`
 - Codex `.codex/config.toml` snippet
 - ChatGPT/OpenAI HTTP MCP snippet
+- Gemini, VS Code, Continue, and custom HTTP MCP reference snippets
 
 When `snipara-companion` is installed, the companion pack also includes the compaction-safe managed workflow:
 
@@ -297,18 +303,22 @@ The intended split is:
 - `snipara-mcp`: local stdio bridge, client-package development, compatibility, and testing
 - `snipara-sandbox`: optional local execution engine
 
-## Codex Setup
+## Client Packs
 
-For Codex, keep Hosted MCP as the core path and let companion add workflow
-ergonomics:
+For every selected AI client, keep Hosted MCP as the core path and let
+companion add workflow ergonomics:
 
 - use Hosted MCP as the core Snipara surface
 - use `AGENTS.md` for project instructions
+- use the selected pack under `.snipara/companion/`, for example `CODEX.md`, `CURSOR.md`, or `GEMINI.md`
 - use the default `hosted-companion` path when you want compaction-safe local phase commits
 - choose `hosted-only` or `--skip-companion` only in locked-down environments
 - use local `snipara-mcp` only for stdio compatibility, development, or tests
 
-Codex does not require hook presets to use Snipara successfully.
+Claude Code, Cursor, and Windsurf can receive generated automation files when
+that client has a useful local hook surface. Codex, Gemini, VS Code, Continue,
+ChatGPT, and custom clients are treated as MCP-first: they get the hosted MCP
+configuration/reference and agent instructions, not invented local hooks.
 
 This keeps setup and runtime separated while still giving the user one obvious command to start from.
 
@@ -317,6 +327,7 @@ This keeps setup and runtime separated while still giving the user one obvious c
 After setup, the project gets a local pack at `.snipara/companion/`:
 
 - `README.md`: local usage guidance
+- `<CLIENT>.md`: selected client setup overlay, such as `CODEX.md` or `GEMINI.md`
 - `commands.json`: starter commands for the current project
 - `doctor.json`: most recent validation report
 
@@ -414,6 +425,16 @@ npx create-snipara --profile full-stack --advanced
 
 Best when the user also wants sandboxed `snipara-sandbox` execution.
 
+### Full local stack plus production orchestration
+
+```bash
+npx create-snipara --profile full-stack --with-orchestrator
+```
+
+Best when the user wants Hosted MCP, companion workflows, Sandbox execution, and
+the explicit `snipara-orchestrator` package for production gates, drift checks,
+or htask coordination.
+
 ### Connect the current repository
 
 ```bash

package/dist/index.js

@@ -9,7 +9,7 @@ import fs from "fs";
 import path from "path";
 import { execSync, spawn } from "child_process";
 import { homedir } from "os";
-var VERSION = "1.3.15";
+var VERSION = "1.3.18";
 var BASE_URL = "https://www.snipara.com";
 var API_URL = "https://api.snipara.com";
 var COMPANION_PACKAGE_NAME = "snipara-companion";
@@ -18,18 +18,77 @@ var LEGACY_COMPANION_COMMAND_NAME = "rlm-hook";
 var GITHUB_ANSWER_PACKS_LABEL = "GitHub PR Answer Packs";
 var MCP_PACKAGE_NAME = "snipara-mcp";
 var SANDBOX_PACKAGE_NAME = "snipara-sandbox[all]";
+var ORCHESTRATOR_PACKAGE_NAME = "snipara-orchestrator";
 var SANDBOX_SERVER_NAME = "snipara-sandbox";
 var LEGACY_RUNTIME_SERVER_NAME = "rlm-runtime";
 var SANDBOX_COMMAND_NAME = "snipara-sandbox";
 var LEGACY_SANDBOX_COMMAND_NAME = "rlm";
+var ORCHESTRATOR_COMMAND_NAME = "snipara-orchestrator";
 var DEVICE_CLIENT_ID = "create-snipara";
 var DeviceAuthorizationAborted = class extends Error {
 };
+var AI_CLIENT_CHOICES = [
+  {
+    title: "Claude Code (CLI/VS Code extension)",
+    value: "claude-code",
+    description: "Best hooks support"
+  },
+  {
+    title: "Cursor",
+    value: "cursor",
+    description: "Hosted MCP plus Cursor rules and automation bundles"
+  },
+  {
+    title: "Windsurf",
+    value: "windsurf",
+    description: "Hosted MCP plus Windsurf automation bundles"
+  },
+  {
+    title: "OpenAI Codex",
+    value: "codex",
+    description: "Hosted MCP plus AGENTS.md and Codex config"
+  },
+  {
+    title: "Gemini CLI",
+    value: "gemini",
+    description: "Hosted MCP reference plus agent instructions"
+  },
+  {
+    title: "VS Code / Copilot",
+    value: "vscode",
+    description: "Hosted MCP reference for VS Code-compatible clients"
+  },
+  {
+    title: "Continue",
+    value: "continue",
+    description: "Hosted MCP reference for Continue"
+  },
+  {
+    title: "ChatGPT / OpenAI MCP",
+    value: "chatgpt",
+    description: "Hosted MCP for ChatGPT Desktop or OpenAI-compatible clients"
+  },
+  {
+    title: "Claude Desktop",
+    value: "claude-desktop",
+    description: "Desktop MCP config flow"
+  },
+  { title: "Other MCP client", value: "other" }
+];
 function getCompanionInitClientFlag(aiClient) {
-  if (aiClient === "cursor") {
-    return " --client cursor";
-  }
-  return aiClient === "claude-code" ? " --client claude-code" : "";
+  const supportedClientMap = {
+    "claude-code": "claude-code",
+    cursor: "cursor",
+    windsurf: "windsurf",
+    codex: "codex",
+    gemini: "gemini",
+    chatgpt: "chatgpt",
+    vscode: "vscode",
+    continue: "continue",
+    other: "custom"
+  };
+  const companionClient = supportedClientMap[aiClient];
+  return companionClient ? ` --client ${companionClient}` : "";
 }
 function buildProgram() {
   const program = new Command();
@@ -37,7 +96,7 @@ function buildProgram() {
   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(
     "--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("--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").option("-y, --yes", "Accept defaults without prompting").action(async (options) => {
+  ).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").option("-y, --yes", "Accept defaults without prompting").action(async (options) => {
     printBanner();
     await runInit(options);
   });
@@ -45,11 +104,11 @@ function buildProgram() {
     printBanner();
     await runDoctor(options);
   });
-  program.command("repair").description("Rebuild local Snipara config and re-run validation").option("--api-key <key>", "Snipara API key override").option("--slug <slug>", "Project slug override").option("--project-id <id>", "Project ID override").option("--profile <profile>", "Target install profile").option("--with-hooks", "Force hook generation").option("--with-runtime", "Force Snipara Sandbox server/config").option("--with-mcp", "Force MCP config").option("--with-companion", "Force companion pack generation").action(async (options) => {
+  program.command("repair").description("Rebuild local Snipara config and re-run validation").option("--api-key <key>", "Snipara API key override").option("--slug <slug>", "Project slug override").option("--project-id <id>", "Project ID override").option("--profile <profile>", "Target install profile").option("--with-hooks", "Force hook generation").option("--with-runtime", "Force Snipara Sandbox server/config").option("--with-mcp", "Force MCP config").option("--with-companion", "Force companion pack generation").option("--with-orchestrator", "Install optional snipara-orchestrator package").action(async (options) => {
     printBanner();
     await runRepair(options);
   });
-  program.command("upgrade").description("Upgrade installed Snipara local components").option("--with-hooks", "Refresh hooks after upgrade").option("--with-runtime", "Upgrade Snipara Sandbox even if not detected").option("--with-mcp", "Upgrade snipara-mcp even if not detected").option("--with-companion", "Upgrade companion even if not detected").action(async (options) => {
+  program.command("upgrade").description("Upgrade installed Snipara local components").option("--with-hooks", "Refresh hooks after upgrade").option("--with-runtime", "Upgrade Snipara Sandbox even if not detected").option("--with-mcp", "Upgrade snipara-mcp even if not detected").option("--with-companion", "Upgrade companion even if not detected").option("--with-orchestrator", "Upgrade snipara-orchestrator even if not detected").action(async (options) => {
     printBanner();
     await runUpgrade(options);
   });
@@ -68,7 +127,7 @@ 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(
     "--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("--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").option("-y, --yes", "Accept defaults without prompting");
+  ).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").option("-y, --yes", "Accept defaults without prompting");
 }
 async function main() {
   const program = buildProgram();
@@ -100,6 +159,7 @@ function parseInitOptionsFromArgv(args) {
     "--skip-runtime": "skipRuntime",
     "--skip-hooks": "skipHooks",
     "--skip-test": "skipTest",
+    "--with-orchestrator": "withOrchestrator",
     "--runtime-only": "runtimeOnly",
     "--github": "github",
     "--skip-github": "skipGithub",
@@ -130,7 +190,7 @@ function parseInitOptionsFromArgv(args) {
 }
 async function runInit(options) {
   const answers = await gatherConfiguration(normalizeInitOptions(options));
-  if (answers.installMcp || answers.installRuntime) {
+  if (answers.installMcp || answers.installRuntime || answers.installOrchestrator) {
     await installPythonPackages(answers, false);
   }
   if (answers.installCompanion) {
@@ -168,7 +228,7 @@ async function runDoctor(options) {
 async function runRepair(options) {
   const answers = loadExistingAnswers(options);
   console.log(chalk.bold("\n\u{1F6E0}\uFE0F  Repairing Local Setup\n"));
-  if (answers.installMcp || answers.installRuntime) {
+  if (answers.installMcp || answers.installRuntime || answers.installOrchestrator) {
     await installPythonPackages(answers, true);
   }
   if (answers.installCompanion) {
@@ -191,10 +251,11 @@ async function runUpgrade(options) {
   const upgradedAnswers = {
     ...answers,
     installMcp: options.withMcp || answers.installMcp,
-    installRuntime: options.withRuntime || answers.installRuntime
+    installRuntime: options.withRuntime || answers.installRuntime,
+    installOrchestrator: options.withOrchestrator || answers.installOrchestrator
   };
   console.log(chalk.bold("\n\u2B06\uFE0F  Upgrading Local Components\n"));
-  if (options.withMcp || options.withRuntime || detection.existingConfig.hasRuntimeServer) {
+  if (options.withMcp || options.withRuntime || options.withOrchestrator || detection.existingConfig.hasRuntimeServer || detection.tooling.orchestratorCli) {
     await installPythonPackages(upgradedAnswers, true);
   }
   if (options.withCompanion || detection.tooling.companionCli || answers.installCompanion) {
@@ -207,8 +268,8 @@ async function runUpgrade(options) {
   if (options.withHooks || answers.installHooks) {
     await installClaudeCodeHooks({ ...answers, installHooks: true });
   }
-  await createCompanionPack(answers);
-  const report = await runValidation(answers, true);
+  await createCompanionPack(upgradedAnswers);
+  const report = await runValidation(upgradedAnswers, true);
   writeDoctorReport(report);
   printDoctorReport(detectEnvironment(), report);
 }
@@ -245,6 +306,7 @@ async function runPrintConfig(options) {
   );
   console.log(`   Local snipara-mcp package: ${answers.installMcp ? "enabled" : "disabled"}`);
   console.log(`   Snipara Sandbox: ${answers.installRuntime ? "enabled" : "disabled"}`);
+  console.log(`   Snipara Orchestrator: ${answers.installOrchestrator ? "enabled" : "disabled"}`);
   console.log(`   Hooks: ${answers.installHooks ? "enabled" : "disabled"}`);
   console.log(`   GitHub repo: ${githubRepo ? githubRepo.fullName : "not detected"}`);
   console.log(`   ${GITHUB_ANSWER_PACKS_LABEL}: ${githubAnswerPacks}`);
@@ -305,6 +367,7 @@ async function gatherConfiguration(options) {
       skipCompanion: !!options.skipCompanion,
       skipMcp: !!options.skipMcp,
       skipRuntime: !!options.skipRuntime,
+      withOrchestrator: !!options.withOrchestrator,
       skipHooks: !!options.skipHooks,
       configureGitHub: Boolean(options.github && detectedGitRepo && !options.skipGithub),
       githubRepo: detectedGitRepo || void 0,
@@ -363,37 +426,17 @@ async function gatherConfiguration(options) {
       type: "select",
       name: "aiClient",
       message: "Which AI client are you using?",
-      initial: ["claude-code", "cursor", "codex", "chatgpt", "claude-desktop", "other"].indexOf(
-        detectedClient
+      initial: Math.max(
+        0,
+        AI_CLIENT_CHOICES.findIndex((choice) => choice.value === detectedClient)
       ),
-      choices: [
-        {
-          title: "Claude Code (CLI/VS Code extension)",
-          value: "claude-code",
-          description: "Best hooks support"
-        },
-        {
-          title: "Cursor",
-          value: "cursor",
-          description: "MCP via .mcp.json plus companion terminal workflows"
-        },
-        {
-          title: "OpenAI Codex",
-          value: "codex",
-          description: "Hosted MCP plus AGENTS.md"
-        },
-        {
-          title: "ChatGPT / OpenAI MCP",
-          value: "chatgpt",
-          description: "Hosted MCP for ChatGPT Desktop or OpenAI-compatible clients"
-        },
-        {
-          title: "Claude Desktop",
-          value: "claude-desktop",
-          description: "Desktop MCP config flow"
-        },
-        { title: "Other", value: "other" }
-      ]
+      choices: AI_CLIENT_CHOICES
+    },
+    {
+      type: showAdvancedPrompts ? "confirm" : null,
+      name: "installOrchestrator",
+      message: "Install snipara-orchestrator for production gates, drift checks, or htask workflows?",
+      initial: Boolean(options.withOrchestrator)
     },
     {
       type: showAdvancedPrompts ? "confirm" : null,
@@ -440,6 +483,7 @@ async function gatherConfiguration(options) {
     skipCompanion: !!options.skipCompanion,
     skipMcp: !!options.skipMcp,
     skipRuntime: !!options.skipRuntime,
+    withOrchestrator: Boolean(options.withOrchestrator || response.installOrchestrator),
     skipHooks: !!options.skipHooks || !response.installHooks,
     configureGitHub: Boolean(
       (response.configureGitHub || options.github) && detectedGitRepo && !options.skipGithub
@@ -571,6 +615,7 @@ function buildAnswersFromProfile(input) {
     installCompanion: selected.installCompanion && !input.skipCompanion,
     installMcp: selected.installMcp && !input.skipMcp,
     installRuntime: selected.installRuntime && !input.skipRuntime,
+    installOrchestrator: input.withOrchestrator,
     installHooks: selected.installHooks && !input.skipHooks,
     aiClient: input.aiClient,
     configureGitHub: Boolean(input.configureGitHub && input.githubRepo),
@@ -725,6 +770,9 @@ function detectSandboxCommand() {
   }
   return null;
 }
+function detectOrchestratorCommand() {
+  return commandExists(ORCHESTRATOR_COMMAND_NAME) ? ORCHESTRATOR_COMMAND_NAME : null;
+}
 async function installPythonPackages(answers, upgrade) {
   console.log(chalk.bold(`
 \u{1F4E6} ${upgrade ? "Upgrading" : "Installing"} Python Packages
@@ -738,6 +786,11 @@ async function installPythonPackages(answers, upgrade) {
     if (answers.installRuntime) {
       console.log(chalk.gray(`      pip install ${upgrade ? "-U " : ""}${SANDBOX_PACKAGE_NAME}`));
     }
+    if (answers.installOrchestrator) {
+      console.log(
+        chalk.gray(`      pip install ${upgrade ? "-U " : ""}${ORCHESTRATOR_PACKAGE_NAME}`)
+      );
+    }
     console.log("");
     return;
   }
@@ -748,6 +801,9 @@ async function installPythonPackages(answers, upgrade) {
   if (answers.installRuntime) {
     packages.push(SANDBOX_PACKAGE_NAME);
   }
+  if (answers.installOrchestrator) {
+    packages.push(ORCHESTRATOR_PACKAGE_NAME);
+  }
   if (packages.length === 0) return;
   const spinner = ora(
     `${upgrade ? "Upgrading" : "Installing"} ${packages.map(stripExtras).join(", ")}...`
@@ -906,6 +962,22 @@ async function createAgentTemplates(answers) {
     {
       path: path.join(templatesDir, "chatgpt-openai-mcp.json"),
       content: buildChatGptMcpTemplate(answers)
+    },
+    {
+      path: path.join(templatesDir, "gemini-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "gemini")
+    },
+    {
+      path: path.join(templatesDir, "vscode-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "vscode")
+    },
+    {
+      path: path.join(templatesDir, "continue-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "continue")
+    },
+    {
+      path: path.join(templatesDir, "custom-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "custom")
     }
   ];
   for (const template of templates) {
@@ -1054,6 +1126,26 @@ function buildChatGptMcpTemplate(answers) {
   )}
 `;
 }
+function buildGenericMcpReferenceTemplate(answers, client) {
+  return `${JSON.stringify(
+    {
+      client,
+      note: "Reference format only; paste the server fields into this client's MCP settings.",
+      mcpServers: {
+        snipara: {
+          type: "http",
+          url: buildHostedMcpEndpoint(answers),
+          headers: {
+            "X-API-Key": "${SNIPARA_API_KEY}"
+          }
+        }
+      }
+    },
+    null,
+    2
+  )}
+`;
+}
 function ensureGitignoreEntry(entry, comment) {
   const gitignorePath = path.join(process.cwd(), ".gitignore");
   if (fs.existsSync(gitignorePath)) {
@@ -1347,12 +1439,36 @@ function getClientGuidance(client) {
       "Use the companion CLI only for explicit upload, planning, chunk lookup, doctor, and task commit workflows outside the editor UI."
     ];
   }
+  if (client === "windsurf") {
+    return [
+      "Windsurf should use the hosted MCP surface plus generated Windsurf automation bundles when available.",
+      "Use snipara-companion automations install --client windsurf when you want dashboard-managed hook files in the local project."
+    ];
+  }
   if (client === "codex") {
     return [
       "Codex should use the hosted MCP surface plus AGENTS.md as the canonical project instruction file.",
       "The generated .snipara/templates/codex-config.toml is a merge-ready snippet for ~/.codex/config.toml if your Codex app does not read project .codex/config.toml."
     ];
   }
+  if (client === "gemini") {
+    return [
+      "Gemini should use Hosted MCP plus the generated AGENTS.md rules; no local shell hooks are assumed.",
+      "Use .snipara/templates/gemini-mcp-reference.json as a field reference for the client's MCP settings."
+    ];
+  }
+  if (client === "vscode") {
+    return [
+      "VS Code and Copilot-style clients should use Hosted MCP plus AGENTS.md for project workflow rules.",
+      "Use .snipara/templates/vscode-mcp-reference.json as the Snipara server reference when adding an MCP server."
+    ];
+  }
+  if (client === "continue") {
+    return [
+      "Continue should use Hosted MCP for Snipara tools and keep AGENTS.md as the shared project instruction source.",
+      "Use .snipara/templates/continue-mcp-reference.json as the Snipara server reference when wiring MCP."
+    ];
+  }
   if (client === "chatgpt") {
     return [
       "ChatGPT and OpenAI-compatible MCP clients should use the direct hosted MCP endpoint.",
@@ -1366,13 +1482,13 @@ function getClientGuidance(client) {
     ];
   }
   return [
-    "The generated pack assumes Hosted MCP for agents and API / SDK for product integrations.",
-    "Use the companion CLI only when local planning, upload, doctor, or task commit flows help."
+    "The generated pack assumes a generic streamable HTTP MCP client plus AGENTS.md for shared workflow rules.",
+    "Use .snipara/templates/custom-mcp-reference.json as the server reference and use companion only when local planning, upload, doctor, or task commit flows help."
   ];
 }
 function getCompanionCommands(answers) {
   const projectIdFlag = answers.projectId ? ` --project-id ${answers.projectId}` : "";
-  const apiKeyFlag = answers.apiKeyType === "none" || answers.apiKey.includes("YOUR_") ? " --api-key <rlm-key>" : ` --api-key ${answers.apiKey}`;
+  const apiKeyFlag = " --api-key <snipara-key>";
   const clientFlag = getCompanionInitClientFlag(answers.aiClient);
   const businessOnboardingCommands = answers.installCompanion ? [
     {
@@ -1447,6 +1563,11 @@ function getCompanionCommands(answers) {
       command: `${COMPANION_COMMAND_NAME} code impact --changed-files src/api/webhooks.ts tests/webhooks.test.ts --diff-summary "webhook retry hardening"`,
       purpose: "Use paid Context code impact analysis to surface likely tests, docs, routes, config, and risks."
     },
+    {
+      title: answers.installOrchestrator ? "Run an explicit production orchestration gate" : "Enable explicit production orchestration",
+      command: answers.installOrchestrator ? `${ORCHESTRATOR_COMMAND_NAME} check-drift --route /api/health` : "npx create-snipara repair --with-orchestrator",
+      purpose: answers.installOrchestrator ? "Use snipara-orchestrator only for proof-based validation, drift checks, htasks, or multi-agent coordination." : "Install snipara-orchestrator only when production gates, drift checks, htasks, or multi-agent coordination are required."
+    },
     githubAnswerPacksCommand,
     {
       title: "Upload or refresh a doc",
@@ -1496,12 +1617,118 @@ function getCompanionCommands(answers) {
     }
   ];
 }
+function getClientDisplayName(client) {
+  const names = {
+    "claude-code": "Claude Code",
+    cursor: "Cursor",
+    windsurf: "Windsurf",
+    codex: "OpenAI Codex",
+    gemini: "Gemini",
+    chatgpt: "ChatGPT / OpenAI MCP",
+    vscode: "VS Code",
+    continue: "Continue",
+    "claude-desktop": "Claude Desktop",
+    other: "Custom MCP client"
+  };
+  return names[client];
+}
+function getClientPackFilename(client) {
+  const names = {
+    "claude-code": "CLAUDE_CODE.md",
+    cursor: "CURSOR.md",
+    windsurf: "WINDSURF.md",
+    codex: "CODEX.md",
+    gemini: "GEMINI.md",
+    chatgpt: "CHATGPT.md",
+    vscode: "VSCODE.md",
+    continue: "CONTINUE.md",
+    "claude-desktop": "CLAUDE_DESKTOP.md",
+    other: "CUSTOM_MCP.md"
+  };
+  return names[client];
+}
+function getClientConfigArtifacts(client) {
+  if (client === "claude-code") {
+    return ["AGENTS.md", "CLAUDE.md", ".claude/settings.json when hooks are installed"];
+  }
+  if (client === "cursor") {
+    return [".mcp.json", ".cursor/rules/snipara.mdc", "dashboard automation bundle when installed"];
+  }
+  if (client === "windsurf") {
+    return [".mcp.json", "dashboard automation bundle when installed"];
+  }
+  if (client === "codex") {
+    return ["AGENTS.md", ".codex/config.toml", ".snipara/templates/codex-config.toml"];
+  }
+  if (client === "gemini") {
+    return ["AGENTS.md", ".snipara/templates/gemini-mcp-reference.json"];
+  }
+  if (client === "vscode") {
+    return ["AGENTS.md", ".snipara/templates/vscode-mcp-reference.json"];
+  }
+  if (client === "continue") {
+    return ["AGENTS.md", ".snipara/templates/continue-mcp-reference.json"];
+  }
+  if (client === "chatgpt") {
+    return ["AGENTS.md", ".snipara/templates/chatgpt-openai-mcp.json"];
+  }
+  if (client === "claude-desktop") {
+    return ["AGENTS.md", "Claude Desktop MCP config"];
+  }
+  return ["AGENTS.md", ".snipara/templates/custom-mcp-reference.json"];
+}
+function getClientAutomationCommand(client) {
+  const companionClient = getCompanionInitClientFlag(client).match(/--client\s+(\S+)/)?.[1];
+  return companionClient ? `${COMPANION_COMMAND_NAME} automations install --client ${companionClient}` : null;
+}
+function buildClientPackMarkdown(answers, commands, guidance) {
+  const clientName = getClientDisplayName(answers.aiClient);
+  const automationCommand = getClientAutomationCommand(answers.aiClient);
+  const bootstrapCommand = commands.find(
+    (command) => command.title === "Bootstrap local companion"
+  );
+  return `# Snipara Pack: ${clientName}
+
+This pack is the client-specific overlay for the generated Snipara project setup.
+Use \`AGENTS.md\` as the shared source of agent behavior, then apply the client-specific files below.
+
+## Hosted MCP
+
+- Endpoint: \`${buildHostedMcpEndpoint(answers)}\`
+- Auth: \`SNIPARA_API_KEY\` from the environment or local client secret store
+- Do not commit API keys or bearer tokens.
+
+## Client Files
+
+${getClientConfigArtifacts(answers.aiClient).map((item) => `- \`${item}\``).join("\n")}
+
+## Recommended Setup
+
+${bootstrapCommand ? `1. Bootstrap companion: \`${bootstrapCommand.command}\`` : "1. Bootstrap companion with `snipara-companion init`."}
+2. Confirm the client can list or call the \`snipara_*\` MCP tools.
+3. Keep exact edits, tests, and dirty working-tree checks local; use Snipara for memory, source truth, and indexed code graph context.
+${automationCommand ? `4. For generated local automations, run \`${automationCommand}\` when that client exposes usable automation files.` : "4. This client is treated as MCP-first; no local hook surface is assumed."}
+
+## Client Guidance
+
+${guidance.map((line) => `- ${line}`).join("\n")}
+
+## Agent Workflow
+
+- Start substantial work with \`snipara_recall\` and \`snipara_context_query\`.
+- Use \`answer_pack\` facts, caveats, source maps, and verification checks before making claims.
+- Use \`snipara_code_symbol_card\` and \`snipara_code_impact\` for important symbols or risky multi-file changes when available.
+- Use \`snipara-companion workflow start\`, \`phase-start\`, \`phase-commit\`, \`workflow resume\`, and \`final-commit\` for multi-phase work.
+- Persist only durable decisions, learnings, preferences, workflows, and troubleshooting outcomes. Never persist secrets.
+`;
+}
 async function createCompanionPack(answers) {
   console.log(chalk.bold("\n\u{1F5C2}\uFE0F  Generating Companion Pack\n"));
   const packDir = path.join(process.cwd(), ".snipara", "companion");
   const commands = getCompanionCommands(answers);
   const guidance = getClientGuidance(answers.aiClient);
   const detection = detectEnvironment();
+  const clientPackFilename = getClientPackFilename(answers.aiClient);
   fs.mkdirSync(packDir, { recursive: true });
   const readme = `# Snipara Companion Pack
 
@@ -1513,10 +1740,12 @@ This project uses Snipara as a hosted-first context and memory layer with local
 - Project slug: \`${answers.projectSlug}\`
 - Project id: \`${answers.projectId || "not-set"}\`
 - AI client: \`${answers.aiClient}\`
+- Client pack: \`${clientPackFilename}\`
 - Installed local companion: \`${answers.installCompanion ? "yes" : "no"}\`
 - Generated hosted MCP config: \`${answers.profile !== "runtime-only" ? "yes" : "no"}\`
 - Installed local snipara-mcp package: \`${answers.installMcp ? "yes" : "no"}\`
 - Installed Snipara Sandbox: \`${answers.installRuntime ? "yes" : "no"}\`
+- Installed Snipara Orchestrator: \`${answers.installOrchestrator ? "yes" : "no"}\`
 - Generated hooks: \`${answers.installHooks ? "yes" : "no"}\`
 - GitHub repository: \`${answers.githubRepo ? answers.githubRepo.fullName : "not-detected"}\`
 
@@ -1527,6 +1756,7 @@ This project uses Snipara as a hosted-first context and memory layer with local
 - .env.local present: \`${detection.files.envLocal ? "yes" : "no"}\`
 - Companion CLI on PATH: \`${detection.tooling.companionCli ? "yes" : "no"}\`
 - Snipara Sandbox CLI on PATH: \`${detection.tooling.runtimeCli ? "yes" : "no"}\`
+- Snipara Orchestrator CLI on PATH: \`${detection.tooling.orchestratorCli ? "yes" : "no"}\`
 
 ## Client Guidance
 
@@ -1592,15 +1822,22 @@ ${item.purpose}`
     ai_client: answers.aiClient,
     profile: answers.profile,
     llm_provider: answers.llmProvider || null,
+    install_orchestrator: answers.installOrchestrator,
     github_repository: answers.githubRepo || null,
     github_automation_url: answers.githubRepo ? buildGitHubAutomationUrl(answers) : null,
+    client_pack: clientPackFilename,
     commands,
     guidance,
     detection
   };
   fs.writeFileSync(path.join(packDir, "README.md"), readme + "\n");
+  fs.writeFileSync(
+    path.join(packDir, clientPackFilename),
+    buildClientPackMarkdown(answers, commands, guidance) + "\n"
+  );
   fs.writeFileSync(path.join(packDir, "commands.json"), JSON.stringify(pack, null, 2) + "\n");
   console.log(chalk.green("   \u2713 Created .snipara/companion/README.md"));
+  console.log(chalk.green(`   \u2713 Created .snipara/companion/${clientPackFilename}`));
   console.log(chalk.green("   \u2713 Created .snipara/companion/commands.json"));
 }
 async function runSandboxInit() {
@@ -1691,6 +1928,11 @@ async function runValidation(answers, includeHostedCheck) {
     status: answers.installRuntime ? detection.tooling.runtimeCli ? "pass" : "warn" : "pass",
     detail: answers.installRuntime && !detection.tooling.runtimeCli ? `${SANDBOX_COMMAND_NAME} CLI not found on PATH` : "Snipara Sandbox CLI ready or not requested"
   });
+  checks.push({
+    name: "orchestrator_cli",
+    status: answers.installOrchestrator ? detection.tooling.orchestratorCli ? "pass" : "warn" : "pass",
+    detail: answers.installOrchestrator && !detection.tooling.orchestratorCli ? `${ORCHESTRATOR_COMMAND_NAME} CLI not found on PATH` : "Snipara Orchestrator ready or not requested"
+  });
   checks.push({
     name: "companion_pack",
     status: detection.files.sniparaCompanionPack ? "pass" : "warn",
@@ -1892,6 +2134,11 @@ function printSuccess(answers, report) {
       chalk.green(`   \u2713 ${stripExtras(SANDBOX_PACKAGE_NAME)}`) + chalk.dim(" - Safe code execution")
     );
   }
+  if (answers.installOrchestrator) {
+    console.log(
+      chalk.green(`   \u2713 ${ORCHESTRATOR_PACKAGE_NAME}`) + chalk.dim(" - Production gates, drift checks, and htask workflows")
+    );
+  }
   if (answers.installCompanion) {
     console.log(
       chalk.green(`   \u2713 ${COMPANION_PACKAGE_NAME}`) + chalk.dim(" - Local companion workflows and hook bootstrap")
@@ -1943,6 +2190,11 @@ function printSuccess(answers, report) {
       `Run ${SANDBOX_COMMAND_NAME} init when you want to choose sandbox/docker/local execution.`
     );
   }
+  if (answers.installOrchestrator) {
+    printNextStep(
+      `Use ${ORCHESTRATOR_COMMAND_NAME} explicitly for production proof gates, drift checks, or htask coordination.`
+    );
+  }
   if (answers.githubRepo) {
     printNextStep(
       `Connect GitHub automation for ${answers.githubRepo.fullName} from the generated Snipara link.`
@@ -2009,7 +2261,8 @@ function detectEnvironment() {
       docker: commandExists("docker"),
       git: commandExists("git"),
       companionCli: Boolean(detectCompanionCommand()),
-      runtimeCli: Boolean(detectSandboxCommand())
+      runtimeCli: Boolean(detectSandboxCommand()),
+      orchestratorCli: Boolean(detectOrchestratorCommand())
     },
     existingConfig: {
       slug: existingConfig?.slug,
@@ -2039,6 +2292,7 @@ function loadExistingAnswers(options) {
     skipCompanion: options.withCompanion === true ? false : !detection.tooling.companionCli && effectiveProfile !== "hosted-companion" && effectiveProfile !== "full-stack",
     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"
   });
 }
@@ -2143,12 +2397,36 @@ function detectAiClient() {
   if (fs.existsSync(path.join(process.cwd(), ".codex"))) {
     return "codex";
   }
+  if (fs.existsSync(path.join(process.cwd(), ".cursor"))) {
+    return "cursor";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".windsurf"))) {
+    return "windsurf";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".gemini"))) {
+    return "gemini";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".continue"))) {
+    return "continue";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".vscode"))) {
+    return "vscode";
+  }
   if (fs.existsSync(path.join(homedir(), ".claude")) || process.env.CLAUDE_CODE) {
     return "claude-code";
   }
   if (fs.existsSync(path.join(homedir(), ".cursor")) || process.env.CURSOR_EDITOR) {
     return "cursor";
   }
+  if (fs.existsSync(path.join(homedir(), ".windsurf")) || process.env.WINDSURF_EDITOR) {
+    return "windsurf";
+  }
+  if (fs.existsSync(path.join(homedir(), ".gemini")) || process.env.GEMINI_CLI) {
+    return "gemini";
+  }
+  if (fs.existsSync(path.join(homedir(), ".continue")) || process.env.CONTINUE_GLOBAL_DIR) {
+    return "continue";
+  }
   const claudeDesktopPath = process.platform === "darwin" ? path.join(homedir(), "Library", "Application Support", "Claude") : process.platform === "win32" ? path.join(homedir(), "AppData", "Roaming", "Claude") : path.join(homedir(), ".config", "claude");
   if (fs.existsSync(claudeDesktopPath)) {
     return "claude-desktop";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "1.3.16",
+  "version": "1.3.18",
   "description": "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   "main": "dist/index.js",
   "type": "module",
@@ -32,6 +32,10 @@
     "chatgpt",
     "openai",
     "cursor",
+    "windsurf",
+    "gemini",
+    "vscode",
+    "continue",
     "claude-desktop"
   ],
   "author": "Snipara",