create-snipara 2.0.6 → 2.0.7

package/README.md

@@ -12,8 +12,8 @@ npx create-snipara
 
 `create-snipara` is the simple onboarding package for the agent path. It
 creates or reuses auth, writes Hosted MCP config, and prepares the local project
-so an LLM client can use Snipara context and reviewed memory. Install once with
-`create-snipara`; continue every session with `snipara-companion`.
+so an LLM client can use Snipara context and reviewed memory. The default path is
+hosted-only so the first success is a grounded answer, not a local tooling tour.
 
 Use it when the goal is outcome-first agent work: the user asks for judgment,
 implementation, release, or verification, and the agent handles Snipara context,
@@ -54,7 +54,7 @@ The product surfaces remain:
 - Hosted MCP for LLM agents, context, and reviewed memory
 - HTTP API / SDK for apps, integrators, backends, and pipelines
 
-The default CLI path wires the local companion around those surfaces:
+Advanced flags can wire local helpers around those surfaces:
 
 - `snipara-companion` for Git-style status, briefs, timelines, phase commits,
   handoffs, resume, and local workflow commands
@@ -69,12 +69,12 @@ 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                                                                                 |
+| `hosted-only`      | Hosted MCP config only                        | Default: first grounded answer with no local companion, hooks, or sandbox                                           |
+| `hosted-companion` | MCP + `snipara-companion`                     | Hosted context plus managed local workflow after first value                                                        |
 | `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`
+Default profile: `hosted-only`
 
 ## Free Account Fit
 
@@ -107,10 +107,10 @@ That distinction matters:
 - opens the browser device-flow free Context + Memory account flow when needed
 - writes Hosted MCP configuration
 - detects a GitHub remote and can open the Snipara GitHub App automation path
-- activates the current folder locally through `snipara-companion source init` so docs and code overlay context are available before GitHub approval
+- can activate the current folder locally through `snipara-companion source init` after the user opts into Companion
 - explains the GitHub PR Answer Packs path for AI-assisted pull request workflows
-- installs `snipara-companion` by default for local status, briefs, timelines,
-  phase commits, handoffs, resume, and managed workflows
+- installs `snipara-companion` only with `--advanced`, `--profile hosted-companion`,
+  `--profile full-stack`, or `repair --with-companion`
 - installs optional `snipara-sandbox`
 - installs optional `snipara-orchestrator` for proof gates, drift checks, and htask workflows when requested
 - configures `.mcp.json`
@@ -118,8 +118,8 @@ That distinction matters:
 - 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
 - validates Codex config against Hosted MCP plus `bearer_token_env_var = "SNIPARA_API_KEY"` and tells users to restart Codex after MCP config changes
-- installs local code overlay Git hooks by default for Claude Code and Codex
-  companion setups, unless `--skip-hooks` is passed
+- installs local code overlay Git hooks only for explicit companion/full-stack
+  setups unless `--skip-hooks` is passed
 - runs a real hosted MCP `tools/list` check and warns if the server still advertises legacy `rlm_*` duplicate tools
 - generates Mistral Le Chat, Mistral Vibe, and LangChain `ChatMistralAI.bindTools` references without embedding secrets
 - writes client-specific companion packs such as `.snipara/companion/CODEX.md` or `.snipara/companion/GEMINI.md`
@@ -155,9 +155,10 @@ The interactive flow now asks for:
 - API key path: existing API key, free signup, or add key later
 - AI client
 
-By default, this uses the recommended `hosted-companion` setup: hosted MCP plus
-the local `snipara-companion` workflow helper. Add `--advanced` when you want profile selection, project id entry,
-hook prompts, GitHub automation prompts, or sandbox provider prompts.
+By default, this uses the minimal `hosted-only` setup: hosted MCP config and a
+doctor report, with no local Companion install, hooks, GitHub approval prompt, or
+sandbox prompt. 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.
 
@@ -204,6 +205,12 @@ compaction-safe managed workflow and Git-style agent work commands. Keep the
 machine plan in JSON for stable phase ids; an optional Markdown file can remain
 the human-facing contract.
 
+Enable those local helpers later with:
+
+```bash
+npx create-snipara repair --with-companion
+```
+
 ```bash
 snipara-companion status
 snipara-companion source init .

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "2.0.6",
+  version: "2.0.7",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -197,7 +197,7 @@ function shouldInstallDefaultHooks(aiClient) {
 }
 function buildProgram() {
   const program = new Command();
-  program.name("create-snipara").description("Scaffold hosted Snipara MCP config plus companion workflow helpers").version(VERSION);
+  program.name("create-snipara").description("Scaffold hosted Snipara MCP config; advanced flags add local 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(
     "--client <client>",
     "AI client: claude-code, cursor, windsurf, codex, gemini, mistral, chatgpt, vscode, continue, claude-desktop, other"
@@ -543,9 +543,9 @@ function printBanner() {
 \u2551                                                                       \u2551
 \u2551   \u2022 Hosted MCP for LLM agents                                         \u2551
 \u2551   \u2022 Free account path with hosted context and reviewed memory         \u2551
-\u2551   \u2022 Local source activation before GitHub approval                    \u2551
+\u2551   \u2022 First grounded answer before local workflow setup                 \u2551
 \u2551   \u2022 API / SDK for product integrations                                \u2551
-\u2551   \u2022 Optional local companion and Snipara Sandbox helpers              \u2551
+\u2551   \u2022 Optional advanced companion, hooks, and Snipara Sandbox helpers   \u2551
 \u2551   \u2022 One CLI for auth, config, doctor, repair, and upgrade             \u2551
 \u2551                                                                       \u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
@@ -784,7 +784,7 @@ function resolveRequestedProfile(options) {
   if (options.profile && isInstallProfile(options.profile)) {
     return options.profile;
   }
-  return "hosted-companion";
+  return "hosted-only";
 }
 function isInstallProfile(value) {
   return ["hosted-only", "hosted-companion", "full-stack", "runtime-only"].includes(value);
@@ -828,15 +828,15 @@ function normalizeClientOption(value) {
 }
 function installProfileChoices() {
   return [
-    {
-      title: "Hosted + Companion",
-      value: "hosted-companion",
-      description: "Default: hosted MCP config plus managed local workflow commands"
-    },
     {
       title: "Hosted only",
       value: "hosted-only",
-      description: "Minimal setup: hosted MCP config, no local companion or sandbox"
+      description: "Default: hosted MCP config, no local companion, hooks, or sandbox"
+    },
+    {
+      title: "Hosted + Companion",
+      value: "hosted-companion",
+      description: "Add managed local workflow commands after first value"
     },
     {
       title: "Hosted + Companion + Sandbox",
@@ -2587,6 +2587,26 @@ function getClientGuidance(client) {
 function getCompanionCommands(answers) {
   const projectFlag = answers.projectSlug ? ` --project ${answers.projectSlug}` : "";
   const clientFlag = getCompanionInitClientFlag(answers.aiClient);
+  if (!answers.installCompanion) {
+    const commands = [
+      {
+        title: "Run doctor for this project",
+        command: `${CREATE_SNIPARA_NPX_COMMAND} doctor`,
+        purpose: "Inspect local wiring and hosted MCP reachability after the AI client restarts."
+      },
+      {
+        title: "Enable local companion later",
+        command: `${CREATE_SNIPARA_NPX_COMMAND} repair --with-companion`,
+        purpose: "Opt into local source activation, managed workflows, guards, and task commits after the first hosted answer works."
+      }
+    ];
+    commands.push({
+      title: answers.githubRepo ? "Connect GitHub PR Answer Packs later" : "Connect a GitHub repo for PR Answer Packs",
+      command: `${CREATE_SNIPARA_NPX_COMMAND} --github${answers.githubPath ? ` --github-path ${answers.githubPath}` : ""}`,
+      purpose: "Open the Snipara GitHub App flow only when the user is ready to approve repository access."
+    });
+    return commands;
+  }
   const localSourceCommands = answers.installCompanion ? [
     {
       title: "Activate this folder locally",
@@ -2598,13 +2618,7 @@ function getCompanionCommands(answers) {
       command: `${COMPANION_NPX_COMMAND} source sync --json`,
       purpose: "Refresh the local snapshot, document dry-run, and code overlay cache after files change."
     }
-  ] : [
-    {
-      title: "Enable local companion workflows",
-      command: `${CREATE_SNIPARA_NPX_COMMAND} repair --with-companion`,
-      purpose: `Install ${COMPANION_PACKAGE_NAME} so this project can run local source activation, folder onboarding, and managed workflow commands without the dashboard.`
-    }
-  ];
+  ] : [];
   const businessOnboardingCommands = answers.installCompanion ? [
     {
       title: "Preview a business folder import",
@@ -3674,7 +3688,9 @@ function printSuccess(answers, report) {
       chalk.green("   \u2713 Claude Code") + chalk.dim(" - .mcp.json MCP config, .claude/settings.json hooks when enabled")
     );
   }
-  console.log(chalk.green("   \u2713 .snipara/companion") + chalk.dim(" - Local pack + doctor report"));
+  console.log(
+    chalk.green("   \u2713 .snipara/companion") + chalk.dim(" - Doctor report and optional command references")
+  );
   const failedChecks = report.checks.filter((check) => check.status === "fail");
   const warnedChecks = report.checks.filter((check) => check.status === "warn");
   console.log(chalk.bold("\nNext steps:\n"));
@@ -3684,6 +3700,11 @@ function printSuccess(answers, report) {
     nextStep += 1;
   };
   printNextStep("Restart your AI client if you created or changed hosted MCP config.");
+  if (!answers.installCompanion && answers.profile !== "runtime-only") {
+    printNextStep(
+      "Ask your AI client for a first grounded answer using snipara_context_query before enabling local workflow helpers."
+    );
+  }
   if (answers.aiClient === "claude-code") {
     printNextStep(
       "For Claude Code, start a new session and confirm Snipara appears in Settings -> MCP or ToolSearch."
@@ -3725,11 +3746,11 @@ function printSuccess(answers, report) {
       "For LangChain JavaScript, adapt .snipara/templates/mistral-langchain-tools.ts to bind Snipara recall, context_query, and settings tools to ChatMistralAI."
     );
   }
-  printNextStep("Open .snipara/companion/README.md for local commands and repair flow.");
   printNextStep(
     `Run ${CREATE_SNIPARA_NPX_COMMAND} doctor anytime you want a fresh local validation report.`
   );
   if (answers.installCompanion) {
+    printNextStep("Open .snipara/companion/README.md for local commands and repair flow.");
     printNextStep(
       `${COMPANION_COMMAND_NAME} ${MIN_COMPANION_VERSION}+ is installed for low-latency local hooks.`
     );
@@ -3745,7 +3766,7 @@ function printSuccess(answers, report) {
     );
   } else if (answers.profile !== "runtime-only") {
     printNextStep(
-      `For dashboardless business folder imports, enable companion with: ${CREATE_SNIPARA_NPX_COMMAND} repair --with-companion`
+      `Enable Companion, guards, managed workflows, and local folder helpers later with: ${CREATE_SNIPARA_NPX_COMMAND} repair --with-companion`
     );
   }
   if (answers.installRuntime && !answers.runSandboxInit) {
@@ -3892,7 +3913,7 @@ function resolveMaintenanceProfile(detection, explicitProfile) {
   if (detection.existingConfig.hasSniparaServer) {
     return "hosted-only";
   }
-  return "hosted-companion";
+  return "hosted-only";
 }
 function readApiKeyFromEnvFiles() {
   const candidates = [".env.local", ".env"];

package/package.json

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