create-snipara 1.3.0 → 1.3.2

package/README.md

@@ -1,36 +1,42 @@
 # create-snipara
 
-One-command setup and maintenance CLI for **Snipara MCP + snipara-companion + optional RLM-Runtime**.
+One-command scaffolding and maintenance CLI for **Hosted MCP config + optional snipara-companion + optional RLM-Runtime**.
 
 ```bash
 npx create-snipara
 ```
 
-`create-snipara` is the entry point. It bootstraps and maintains a complete local Snipara setup for one project. It does not replace the runtime packages. Instead, it installs and wires them together:
+`create-snipara` is onboarding and scaffolding. It is not a product connection surface. The product surfaces remain:
 
-- `snipara-mcp` for hosted MCP access
-- `snipara-companion` for local `rlm-hook` workflows
+- Hosted MCP for LLM agents
+- HTTP API / SDK for apps, integrators, backends, and pipelines
+
+The CLI can wire local helpers around those surfaces:
+
+- `snipara-companion` for local `rlm-hook` workflows when you want them
 - `rlm-runtime` for optional local code execution
 - local config, env files, hook scripts, and a project companion pack
+- `snipara-mcp` only for local stdio compatibility, development, or testing
 
 ## Install Profiles
 
 The CLI now works around explicit install profiles:
 
-| Profile            | What it installs                          | Best for                                  |
-| ------------------ | ----------------------------------------- | ----------------------------------------- |
-| `hosted-only`      | MCP config only                           | SaaS-first setups without local workflows |
-| `hosted-companion` | MCP + `snipara-companion`                 | Recommended default                       |
-| `full-stack`       | MCP + `snipara-companion` + `rlm-runtime` | Hosted context plus local execution       |
-| `runtime-only`     | `rlm-runtime` only                        | Local execution without hosted API        |
+| Profile            | What it installs                          | Best for                                            |
+| ------------------ | ----------------------------------------- | --------------------------------------------------- |
+| `hosted-only`      | Hosted MCP config only                    | Default: agents without local helper workflows      |
+| `hosted-companion` | MCP + `snipara-companion`                 | Hook-heavy clients that want local helper workflows |
+| `full-stack`       | MCP + `snipara-companion` + `rlm-runtime` | Hosted context plus local execution                 |
+| `runtime-only`     | `rlm-runtime` only                        | Local execution without hosted API                  |
 
-Default profile: `hosted-companion`
+Default profile: `hosted-only`
 
 ## What It Does
 
 - detects local environment and project state
-- installs `snipara-companion` by default for local workflows
-- installs `snipara-mcp` and optional `rlm-runtime`
+- writes Hosted MCP configuration
+- installs `snipara-companion` when the selected profile needs local helper workflows
+- installs optional `rlm-runtime`
 - configures `.mcp.json`
 - updates `.env`, `.env.local`, and `.env.example`
 - generates `.snipara/companion/README.md`
@@ -110,6 +116,7 @@ npx create-snipara print-config --json
 
 ```bash
 # Use an explicit install profile
+npx create-snipara --profile hosted-only
 npx create-snipara --profile hosted-companion
 npx create-snipara --profile full-stack
 
@@ -121,7 +128,7 @@ npx create-snipara -y --api-key rlm_xxx --slug my-project
 
 # Skip selected layers
 npx create-snipara --skip-companion
-npx create-snipara --skip-mcp
+npx create-snipara --skip-mcp      # Skip local snipara-mcp package if explicitly requested
 npx create-snipara --skip-runtime
 npx create-snipara --skip-hooks
 
@@ -135,10 +142,22 @@ npx create-snipara upgrade --with-runtime
 The intended split is:
 
 - `create-snipara`: install, inspect, repair, and upgrade the local project setup
-- `snipara-companion`: ongoing local runtime workflows through `rlm-hook`
-- `snipara-mcp`: hosted MCP bridge
+- `snipara-companion`: optional ongoing local runtime workflows through `rlm-hook`
+- `snipara-mcp`: local stdio bridge, client-package development, compatibility, and testing
 - `rlm-runtime`: optional local execution engine
 
+## Codex Setup
+
+For Codex, keep the setup minimal:
+
+- use Hosted MCP as the core Snipara surface
+- use `AGENTS.md` for project instructions
+- choose `hosted-only` if you do not need local helper workflows
+- add `snipara-companion` only if you explicitly want the local helper CLI
+- use local `snipara-mcp` only for stdio compatibility, development, or tests
+
+Codex does not require hook presets to use Snipara successfully.
+
 This keeps setup and runtime separated while still giving the user one obvious command to start from.
 
 ## Generated Local Pack
@@ -149,7 +168,18 @@ After setup, the project gets a local pack at `.snipara/companion/`:
 - `commands.json`: starter commands for the current project
 - `doctor.json`: most recent validation report
 
-This pack is meant to be the local source of truth for machine-level setup.
+This pack is meant to be the local source of truth for machine-level setup. When
+`snipara-companion` is installed, it includes business-folder onboarding commands
+such as:
+
+```bash
+rlm-hook onboard-folder ./client-export --source-provider local_folder --write-manifest ./snipara-onboard.json
+rlm-hook onboard-folder ./client-export --source-provider local_folder --apply
+```
+
+Use this for dashboardless business-context imports after an LLM client has
+materialized Drive, Notion, Gmail, or local files into a folder. For source-code
+repositories, use the GitHub OAuth/code onboarding path instead.
 
 ## API Key Requirements
 
@@ -157,16 +187,16 @@ This pack is meant to be the local source of truth for machine-level setup.
 | ------------------------------------ | -------------------- | ----------- |
 | Hosted MCP queries                   | Required             | Not needed  |
 | Memory / planning tools              | Required             | Not needed  |
-| `snipara-companion` hosted workflows | Required             | Not needed  |
+| `snipara-companion` hosted workflows | Optional             | Not needed  |
 | `rlm-runtime` `execute_python` MCP   | Not needed           | Not needed  |
 | `rlm run` / `rlm agent` CLI          | Optional for context | Required    |
 
 ## Example Flows
 
-### Default recommended setup
+### Default hosted setup
 
 ```bash
-npx create-snipara --profile hosted-companion
+npx create-snipara --profile hosted-only
 ```
 
 ### Full local stack
@@ -193,7 +223,7 @@ npx create-snipara print-config --json
 When testing a locally packed tarball, use `npm exec --package` instead of `npx`, for example:
 
 ```bash
-npm exec --package ./create-snipara-1.3.0.tgz create-snipara -- --help
+npm exec --package ./create-snipara-1.3.1.tgz create-snipara -- --help
 ```
 
 This avoids `npx` resolution issues with unpublished tarballs.

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.0";
+var VERSION = "1.3.1";
 var BASE_URL = "https://www.snipara.com";
 var API_URL = "https://api.snipara.com";
 var COMPANION_PACKAGE_NAME = "snipara-companion";
@@ -23,11 +23,11 @@ function getCompanionInitClientFlag(aiClient) {
 }
 function buildProgram() {
   const program = new Command();
-  program.name("create-snipara").description("Initialize and maintain Snipara MCP + local companion workflows").version(VERSION);
+  program.name("create-snipara").description("Scaffold hosted Snipara MCP config plus optional local helper workflows").version(VERSION);
   program.command("init").description("Install and configure Snipara for this project").option("--api-key <key>", "Snipara project API key").option("--team-key <key>", "Snipara team API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").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 snipara-mcp installation").option("--skip-runtime", "Skip rlm-runtime installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--runtime-only", "Install only RLM-Runtime").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 rlm-runtime installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--runtime-only", "Install only RLM-Runtime").option("-y, --yes", "Accept defaults without prompting").action(async (options) => {
     printBanner();
     await runInit(options);
   });
@@ -58,7 +58,7 @@ function addSharedRootOptions(program) {
   program.option("--api-key <key>", "Snipara project API key").option("--team-key <key>", "Snipara team API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").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 snipara-mcp installation").option("--skip-runtime", "Skip rlm-runtime installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--runtime-only", "Install only RLM-Runtime").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 rlm-runtime installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--runtime-only", "Install only RLM-Runtime").option("-y, --yes", "Accept defaults without prompting");
 }
 async function main() {
   const program = buildProgram();
@@ -72,7 +72,7 @@ async function runInit(options) {
   if (answers.installCompanion) {
     await installNodeCompanion(false);
   }
-  if (answers.apiKeyType !== "none" || answers.installRuntime || answers.installMcp) {
+  if (answers.profile !== "runtime-only" || answers.installRuntime) {
     await createMcpConfig(answers);
   }
   if (answers.installHooks && answers.aiClient === "claude-code") {
@@ -154,7 +154,10 @@ async function runPrintConfig(options) {
   console.log(`   Profile: ${answers.profile}`);
   console.log(`   AI client: ${answers.aiClient}`);
   console.log(`   Companion: ${answers.installCompanion ? "enabled" : "disabled"}`);
-  console.log(`   Hosted MCP: ${answers.installMcp ? "enabled" : "disabled"}`);
+  console.log(
+    `   Hosted MCP config: ${answers.profile !== "runtime-only" ? "enabled" : "disabled"}`
+  );
+  console.log(`   Local snipara-mcp package: ${answers.installMcp ? "enabled" : "disabled"}`);
   console.log(`   Runtime: ${answers.installRuntime ? "enabled" : "disabled"}`);
   console.log(`   Hooks: ${answers.installHooks ? "enabled" : "disabled"}`);
   console.log(`   Existing .mcp.json: ${detection.files.mcpConfig ? "yes" : "no"}`);
@@ -166,12 +169,12 @@ function printBanner() {
     chalk.cyan(`
 \u2554\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\u2557
 \u2551                                                                       \u2551
-\u2551   ${chalk.bold("Snipara")} - Context Optimization + RLM-Runtime                      \u2551
+\u2551   ${chalk.bold("Snipara")} - Hosted MCP + API / SDK setup                           \u2551
 \u2551                                                                       \u2551
-\u2551   \u2022 Hosted MCP, memory, and orchestration                             \u2551
-\u2551   \u2022 Optional local companion workflows                                \u2551
-\u2551   \u2022 Safe code execution with Docker isolation                         \u2551
-\u2551   \u2022 One CLI for install, doctor, repair, and upgrade                  \u2551
+\u2551   \u2022 Hosted MCP for LLM agents                                         \u2551
+\u2551   \u2022 API / SDK for product integrations                                \u2551
+\u2551   \u2022 Optional local companion and runtime helpers                      \u2551
+\u2551   \u2022 One CLI for scaffolding, 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
 `)
@@ -370,7 +373,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);
@@ -380,12 +383,12 @@ function installProfileChoices() {
     {
       title: "Hosted only",
       value: "hosted-only",
-      description: "Snipara MCP only, no local companion or runtime"
+      description: "Default: hosted MCP config, no local companion or runtime"
     },
     {
       title: "Hosted + Companion",
       value: "hosted-companion",
-      description: "Recommended default: hosted MCP plus snipara-companion"
+      description: "Hosted MCP config plus optional local companion workflows"
     },
     {
       title: "Hosted + Companion + Runtime",
@@ -403,19 +406,19 @@ function buildAnswersFromProfile(input) {
   const defaults = {
     "hosted-only": {
       installCompanion: false,
-      installMcp: true,
+      installMcp: false,
       installRuntime: false,
       installHooks: false
     },
     "hosted-companion": {
       installCompanion: true,
-      installMcp: true,
+      installMcp: false,
       installRuntime: false,
       installHooks: input.aiClient === "claude-code"
     },
     "full-stack": {
       installCompanion: true,
-      installMcp: true,
+      installMcp: false,
       installRuntime: true,
       installHooks: input.aiClient === "claude-code"
     },
@@ -507,17 +510,28 @@ async function installPythonPackages(answers, upgrade) {
 function stripExtras(name) {
   return name.replace(/\[.*\]$/, "");
 }
-function detectNodePackageManager() {
-  if (commandExists("pnpm")) return "pnpm";
-  if (commandExists("npm")) return "npm";
-  return null;
+function detectNodePackageManagers() {
+  const managers = [];
+  if (commandExists("pnpm")) {
+    managers.push("pnpm");
+  }
+  if (commandExists("npm")) {
+    managers.push("npm");
+  }
+  return managers;
+}
+function getCompanionInstallCommand(packageManager, upgrade) {
+  if (packageManager === "pnpm") {
+    return `pnpm add -g ${upgrade ? "--latest " : ""}${COMPANION_PACKAGE_NAME}`;
+  }
+  return `npm install -g ${upgrade ? COMPANION_PACKAGE_NAME + "@latest" : COMPANION_PACKAGE_NAME}`;
 }
 async function installNodeCompanion(upgrade) {
   console.log(chalk.bold(`
 \u{1F9F0} ${upgrade ? "Upgrading" : "Installing"} Local Companion CLI
 `));
-  const packageManager = detectNodePackageManager();
-  if (!packageManager) {
+  const packageManagers = detectNodePackageManagers();
+  if (packageManagers.length === 0) {
     console.log(chalk.yellow("   \u26A0\uFE0F  npm/pnpm not found. Please install manually:\n"));
     console.log(chalk.gray(`      npm install -g ${COMPANION_PACKAGE_NAME}
 `));
@@ -526,23 +540,40 @@ async function installNodeCompanion(upgrade) {
   const spinner = ora(
     `${upgrade ? "Upgrading" : "Installing"} ${COMPANION_PACKAGE_NAME}...`
   ).start();
-  try {
-    const installCmd = packageManager === "pnpm" ? `pnpm add -g ${upgrade ? "--latest " : ""}${COMPANION_PACKAGE_NAME}` : `npm install -g ${upgrade ? COMPANION_PACKAGE_NAME + "@latest" : COMPANION_PACKAGE_NAME}`;
-    execSync(installCmd, {
-      stdio: "pipe",
-      encoding: "utf-8"
-    });
-    spinner.succeed(`${upgrade ? "Upgraded" : "Installed"} ${COMPANION_PACKAGE_NAME}`);
-  } catch {
-    spinner.fail(`Failed to ${upgrade ? "upgrade" : "install"} ${COMPANION_PACKAGE_NAME}`);
-    console.log(chalk.yellow("\n   Install manually with:"));
-    console.log(
-      chalk.gray(
-        `   npm install -g ${upgrade ? COMPANION_PACKAGE_NAME + "@latest" : COMPANION_PACKAGE_NAME}
-`
-      )
-    );
+  const failures = [];
+  for (const packageManager of packageManagers) {
+    const installCmd = getCompanionInstallCommand(packageManager, upgrade);
+    try {
+      execSync(installCmd, {
+        stdio: "pipe",
+        encoding: "utf-8"
+      });
+      if (commandExists("rlm-hook")) {
+        spinner.succeed(
+          `${upgrade ? "Upgraded" : "Installed"} ${COMPANION_PACKAGE_NAME} via ${packageManager}`
+        );
+        return;
+      }
+      failures.push(
+        `${packageManager}: command completed but rlm-hook is still not available on PATH`
+      );
+    } catch (error) {
+      const detail = error instanceof Error && "message" in error ? error.message.split("\n")[0] : "unknown error";
+      failures.push(`${packageManager}: ${detail}`);
+    }
   }
+  spinner.fail(`Failed to ${upgrade ? "upgrade" : "install"} ${COMPANION_PACKAGE_NAME}`);
+  console.log(chalk.yellow("\n   Attempt summary:"));
+  for (const failure of failures) {
+    console.log(chalk.gray(`   - ${failure}`));
+  }
+  console.log(chalk.yellow("\n   Install manually with:"));
+  console.log(
+    chalk.gray(
+      `   npm install -g ${upgrade ? COMPANION_PACKAGE_NAME + "@latest" : COMPANION_PACKAGE_NAME}
+`
+    )
+  );
 }
 async function createMcpConfig(answers) {
   console.log(chalk.bold("\n\u2699\uFE0F  Creating Configuration\n"));
@@ -556,7 +587,7 @@ async function createMcpConfig(answers) {
       console.log(chalk.yellow("   Could not parse existing .mcp.json, creating new..."));
     }
   }
-  if (answers.apiKeyType !== "none" || answers.installMcp) {
+  if (answers.profile !== "runtime-only") {
     mcpConfig.mcpServers.snipara = {
       type: "http",
       url: `${API_URL}/mcp/${answers.projectSlug}`,
@@ -810,24 +841,42 @@ function getClientGuidance(client) {
   if (client === "cursor") {
     return [
       "Cursor reads the generated .mcp.json directly, so the hosted Snipara MCP surface is available after restart.",
-      "Use the companion CLI for explicit upload, planning, chunk lookup, doctor, and task commit workflows outside the editor UI."
+      "Use the companion CLI only for explicit upload, planning, chunk lookup, doctor, and task commit workflows outside the editor UI."
     ];
   }
   if (client === "claude-desktop") {
     return [
       "Claude Desktop uses the generated desktop MCP config plus the same hosted Snipara tool contract.",
-      "Keep the companion CLI nearby for bootstrap, upload, and task summaries that are easier to run from a terminal."
+      "Use companion only for bootstrap, upload, and task summaries that are easier to run from a terminal."
     ];
   }
   return [
-    "The generated pack assumes a hosted-first Snipara setup with optional local companion workflows.",
-    "Use the companion CLI whenever your client does not expose an equivalent UX for planning, upload, doctor, or task commit flows."
+    "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."
   ];
 }
 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 clientFlag = getCompanionInitClientFlag(answers.aiClient);
+  const businessOnboardingCommands = answers.installCompanion ? [
+    {
+      title: "Preview a business folder import",
+      command: "rlm-hook onboard-folder ./client-export --source-provider local_folder --write-manifest ./snipara-onboard.json",
+      purpose: "Classify a local or LLM-materialized business folder and review the Snipara sync manifest before upload."
+    },
+    {
+      title: "Apply a business folder import",
+      command: "rlm-hook onboard-folder ./client-export --source-provider local_folder --apply",
+      purpose: "Upload approved business-context documents to hosted Snipara and trigger document reindexing."
+    }
+  ] : [
+    {
+      title: "Enable business folder onboarding",
+      command: "npx create-snipara repair --with-companion",
+      purpose: "Install snipara-companion so this project can run rlm-hook onboard-folder without using the dashboard."
+    }
+  ];
   return [
     {
       title: "Bootstrap local companion",
@@ -846,8 +895,13 @@ function getCompanionCommands(answers) {
     },
     {
       title: "Run a focused hosted query",
-      command: 'rlm-hook query --query "recent auth decisions" --max-tokens 4000',
-      purpose: "Pull ranked context before editing or reviewing code."
+      command: 'rlm-hook query --query "how does auth middleware work?" --max-tokens 4000',
+      purpose: "Pull ranked source context before editing, reviewing, or drafting."
+    },
+    {
+      title: "Load linked standards only when needed",
+      command: "rlm-hook shared-context --categories MANDATORY BEST_PRACTICES",
+      purpose: "Fetch project-linked team or workspace guidance without treating it as memory."
     },
     {
       title: "Generate a hosted plan",
@@ -859,6 +913,7 @@ function getCompanionCommands(answers) {
       command: "rlm-hook upload --path docs/local-playbook.md --file ./docs/local-playbook.md",
       purpose: "Push local notes or docs into hosted Snipara context."
     },
+    ...businessOnboardingCommands,
     {
       title: "Inspect a specific chunk",
       command: "rlm-hook chunk get --chunk-id <chunk_id>",
@@ -867,12 +922,17 @@ function getCompanionCommands(answers) {
     {
       title: "Bootstrap the session memory view",
       command: "rlm-hook session-bootstrap",
-      purpose: "Load critical and daily memories at session start."
+      purpose: "Load durable decisions, learnings, and optional short-lived carryover at session start."
+    },
+    {
+      title: "Ask memory about past decisions",
+      command: 'rlm-hook recall --query "What did we decide about auth retries?" --type decision',
+      purpose: "Query durable memory for past decisions, preferences, or validated learnings."
     },
     {
       title: "Commit durable task memory",
       command: 'rlm-hook task-commit --summary "Hardened webhook retries and updated tests" --category engineering --outcome completed --files src/api/webhooks.ts tests/webhooks.test.ts',
-      purpose: "Persist reusable task outcomes back into hosted memory."
+      purpose: "Persist reusable outcomes back into hosted memory after the work is done."
     }
   ];
 }
@@ -894,7 +954,8 @@ This project uses Snipara as a hosted-first context and memory layer with an opt
 - Project id: \`${answers.projectId || "not-set"}\`
 - AI client: \`${answers.aiClient}\`
 - Installed local companion: \`${answers.installCompanion ? "yes" : "no"}\`
-- Installed MCP server: \`${answers.installMcp ? "yes" : "no"}\`
+- Generated hosted MCP config: \`${answers.profile !== "runtime-only" ? "yes" : "no"}\`
+- Installed local snipara-mcp package: \`${answers.installMcp ? "yes" : "no"}\`
 - Installed runtime: \`${answers.installRuntime ? "yes" : "no"}\`
 - Generated hooks: \`${answers.installHooks ? "yes" : "no"}\`
 
@@ -910,6 +971,22 @@ This project uses Snipara as a hosted-first context and memory layer with an opt
 
 ${guidance.map((line) => `- ${line}`).join("\n")}
 
+## Business Folder Onboarding
+
+Use this when Claude, ChatGPT, Codex, or another LLM client has already materialized Drive, Notion, Gmail, or local business files into a folder.
+
+${answers.installCompanion ? `Preview first:
+
+\`rlm-hook onboard-folder ./client-export --source-provider local_folder --write-manifest ./snipara-onboard.json\`
+
+Apply only after reviewing the manifest:
+
+\`rlm-hook onboard-folder ./client-export --source-provider local_folder --apply\`` : `This setup did not install snipara-companion. Enable it before business folder imports:
+
+\`npx create-snipara repair --with-companion\``}
+
+For source-code repositories, use the GitHub OAuth/code onboarding path instead of \`onboard-folder\`.
+
 ## Suggested Commands
 
 ${commands.map(
@@ -922,8 +999,10 @@ ${item.purpose}`
 
 ## Design Rule
 
+- Context first: use hosted queries, shared-context, and document loads for source truth.
+- Memory second: use session bootstrap and task commit for durable decisions, learnings, and preferences.
 - Durable memory, policy, and orchestration stay hosted in Snipara.
-- The local companion is for capture, bootstrap, upload, exploration, doctor, repair, and explicit task summaries.
+- The local companion is optional tooling for capture, bootstrap, upload, exploration, doctor, repair, and explicit task summaries.
 `;
   const pack = {
     generated_at: (/* @__PURE__ */ new Date()).toISOString(),
@@ -1104,7 +1183,9 @@ function printSuccess(answers, report) {
   console.log(`   ${chalk.green("\u2713")} ${answers.profile}`);
   console.log(chalk.bold("\nWhat was installed:\n"));
   if (answers.installMcp) {
-    console.log(chalk.green("   \u2713 snipara-mcp") + chalk.dim(" - Hosted MCP server wiring"));
+    console.log(
+      chalk.green("   \u2713 snipara-mcp") + chalk.dim(" - Local stdio compatibility package")
+    );
   }
   if (answers.installRuntime) {
     console.log(chalk.green("   \u2713 rlm-runtime") + chalk.dim(" - Safe code execution"));
@@ -1117,20 +1198,36 @@ function printSuccess(answers, report) {
   if (answers.installHooks) {
     console.log(chalk.green("   \u2713 hooks") + chalk.dim(" - Local session lifecycle scripts"));
   }
+  if (answers.profile !== "runtime-only") {
+    console.log(chalk.green("   \u2713 .mcp.json") + chalk.dim(" - Hosted MCP config"));
+  }
   console.log(chalk.green("   \u2713 .snipara/companion") + chalk.dim(" - Local pack + doctor report"));
   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"));
-  console.log("  1. Restart your AI client if you installed or changed MCP config.");
-  console.log("  2. Open .snipara/companion/README.md for local commands and repair flow.");
-  console.log("  3. Run create-snipara doctor anytime you want a fresh local validation report.");
+  let nextStep = 1;
+  const printNextStep = (message) => {
+    console.log(`  ${nextStep}. ${message}`);
+    nextStep += 1;
+  };
+  printNextStep("Restart your AI client if you created or changed hosted MCP config.");
+  printNextStep("Open .snipara/companion/README.md for local commands and repair flow.");
+  printNextStep("Run create-snipara doctor anytime you want a fresh local validation report.");
   if (answers.installCompanion) {
-    console.log(
-      "  4. Use rlm-hook query / plan / upload / task-commit for explicit local workflows."
+    printNextStep("Use rlm-hook query / plan / upload / task-commit for explicit local workflows.");
+    printNextStep(
+      "For business folders, preview with: rlm-hook onboard-folder ./client-export --source-provider local_folder --write-manifest ./snipara-onboard.json"
+    );
+    printNextStep(
+      "Apply after review with: rlm-hook onboard-folder ./client-export --source-provider local_folder --apply"
+    );
+  } else if (answers.profile !== "runtime-only") {
+    printNextStep(
+      "For dashboardless business folder imports, enable companion with: npx create-snipara repair --with-companion"
     );
   }
   if (answers.installRuntime && !answers.runRlmInit) {
-    console.log("  5. Run rlm init when you want to choose sandbox/docker/local execution.");
+    printNextStep("Run rlm init when you want to choose sandbox/docker/local execution.");
   }
   if (failedChecks.length > 0 || warnedChecks.length > 0) {
     console.log(chalk.bold("\nValidation summary:\n"));
@@ -1229,7 +1326,7 @@ function resolveMaintenanceProfile(detection, explicitProfile) {
   if (detection.existingConfig.hasSniparaServer) {
     return "hosted-only";
   }
-  return detection.tooling.runtimeCli ? "runtime-only" : "hosted-companion";
+  return detection.tooling.runtimeCli ? "runtime-only" : "hosted-only";
 }
 function readApiKeyFromEnvFiles() {
   const candidates = [".env.local", ".env"];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-snipara",
-  "version": "1.3.0",
-  "description": "Initialize Snipara MCP + RLM-Runtime with a single command - context optimization, semantic memory, and safe code execution",
+  "version": "1.3.2",
+  "description": "Scaffold hosted Snipara MCP config plus optional local helper and runtime workflows",
   "main": "dist/index.js",
   "type": "module",
   "bin": {