create-snipara 2.0.5 → 2.0.6

package/README.md

@@ -188,11 +188,12 @@ native skills should keep using `AGENTS.md`, `CLAUDE.md`, or project rules as th
 shared instruction surface.
 
 For Codex, `SNIPARA_API_KEY` is the only generated bearer token environment
-variable. If Codex lazily exposes only a minimal Snipara MCP surface after
-restart, force exact discovery for `snipara_recall`, `snipara_context_query`,
-and `snipara_settings`. Use `snipara-companion recall`, `snipara-companion
-query`, and `snipara-companion task-commit` as the reliable local fallback while
-the Codex session reloads or rediscovers tools.
+variable. If Codex exposes only the lean Snipara MCP surface after restart,
+that is expected. Use `snipara_help(query=...)` for routed guidance and
+`snipara_help(list_all=true)` to inspect specialist opt-in surfaces. Use
+`snipara-companion recall`, `snipara-companion query`, and
+`snipara-companion task-commit` as the reliable local fallback when the simple
+hosted tools are not callable.
 
 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

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "2.0.5",
+  version: "2.0.6",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -1492,7 +1492,7 @@ function buildSniparaOnboardingSkill(endpoint, companionPrefix) {
     "",
     `Use the Hosted MCP endpoint: \`${endpoint}\`. Keep the API key in \`SNIPARA_API_KEY\` or the client secret store. Never paste keys into tracked files, prompts, logs, screenshots, or durable memory.`,
     "",
-    "Validate availability with a tool-oriented call such as `snipara_help(list_all=true)`, `snipara_settings`, or a lightweight `snipara_context_query`. Empty MCP resources or resource templates do not prove an outage because Snipara may be exposed as a tool-only MCP server.",
+    'Validate availability with a simple tool-oriented call such as `snipara_help(query="what should I use for project context?")`, `snipara_settings`, or a lightweight `snipara_context_query`. Empty MCP resources or resource templates do not prove an outage because Snipara may be exposed as a tool-only MCP server.',
     "",
     "## Setup Steps",
     "",
@@ -1512,7 +1512,7 @@ function buildSniparaOnboardingSkill(endpoint, companionPrefix) {
     "",
     "## Failure Handling",
     "",
-    "If broad discovery shows only a partial tool surface, call `snipara_help(list_all=true)` before concluding a tool is unavailable. If the client still lags after config changes, use Companion commands as a local fallback for recall, query, and task commit until the MCP session refreshes.",
+    "If broad discovery shows only the lean default tool surface, treat that as normal. Use `snipara_help(query=...)` for routed guidance, `snipara_help(list_all=true)` to inspect specialist opt-in surfaces, and Companion commands as a local fallback for recall, query, and task commit until the MCP session refreshes.",
     ""
   ].join("\n");
 }
@@ -1733,17 +1733,13 @@ This project uses Snipara Hosted MCP for project context and reviewed memory.
 - For Codex, expose the endpoint as a streamable HTTP MCP server and load the
   key from \`SNIPARA_API_KEY\`.
 - At the start of every new thread, validate hosted MCP with a tool-oriented
-  call such as \`snipara_settings\`, \`tools/list\`, or a lightweight
+  call such as \`snipara_settings\`, \`snipara_help(query=...)\`, or a lightweight
   \`snipara_context_query\`. Do not treat empty MCP resources/templates as an
   outage because Snipara may be tool-only.
-- In Codex, if only a minimal Snipara tool subset appears, force precise tool
-  discovery for \`snipara_recall\`, \`snipara_context_query\`, and
-  \`snipara_settings\` before concluding the MCP server is incomplete.
-- If a session appears to expose only a subset of expected Snipara tools, call
-  \`snipara_help(list_all=true)\` and compare exact tool names before concluding
-  that a tool is unavailable. Do not infer absence from one broad discovery
-  pass or a ranked tool-search result.
-- If Codex still exposes only a partial surface after exact discovery, use
+- In Codex, a lean Snipara tool set is expected. Use \`snipara_help(query=...)\`
+  for routed guidance and \`snipara_help(list_all=true)\` to inspect specialist
+  opt-in surfaces before requesting expanded schemas.
+- If Codex still cannot call the simple context or memory tools, use
   \`snipara-companion recall\`, \`snipara-companion query\`, and
   \`snipara-companion task-commit\` as the reliable local fallback, then restart
   or reload Codex after MCP config changes.
@@ -1823,8 +1819,8 @@ Use Snipara Hosted MCP before answering project-specific questions.
 
 - Endpoint: \`${buildHostedMcpEndpoint(answers)}\`
 - Auth: use \`SNIPARA_API_KEY\` from the environment. Never commit keys.
-- At the start of every new thread, validate hosted MCP with a tool-oriented call such as \`snipara_settings\`, \`tools/list\`, or a lightweight \`snipara_context_query\`. Do not treat empty MCP resources/templates as an outage because Snipara may be tool-only.
-- If a session exposes only a subset of expected Snipara tools, call \`snipara_help(list_all=true)\` and compare exact tool names before concluding a tool is unavailable. If only a partial surface remains after exact discovery, use \`snipara-companion recall\`, \`snipara-companion query\`, and \`snipara-companion task-commit\` as a reliable local fallback.
+- At the start of every new thread, validate hosted MCP with a tool-oriented call such as \`snipara_settings\`, \`snipara_help(query=...)\`, or a lightweight \`snipara_context_query\`. Do not treat empty MCP resources/templates as an outage because Snipara may be tool-only.
+- A lean default Snipara tool set is expected. Use \`snipara_help(query=...)\` for routed guidance, \`snipara_help(list_all=true)\` to inspect specialist opt-in surfaces, and \`snipara-companion recall\`, \`snipara-companion query\`, or \`snipara-companion task-commit\` as local fallbacks when the simple tools are unavailable.
 - If the client supports native skills, install the generated Snipara skill pack from \`.snipara/templates/skills\`. Keep \`AGENTS.md\` as the shared fallback for clients without native skill support.
 
 ${EXPERIENCE_GOAL_SECTION}
@@ -1863,8 +1859,8 @@ This workspace uses Snipara Hosted MCP for current project context, business/cli
 
 - Check the configured Snipara MCP server before answering project-specific questions.
 - Endpoint: \`${buildHostedMcpEndpoint(answers)}\`
-- At the start of every new thread, validate hosted MCP with a tool-oriented call such as \`snipara_settings\`, \`tools/list\`, or a lightweight \`snipara_context_query\`. Do not treat empty MCP resources/templates as an outage because Snipara may be tool-only.
-- If a session exposes only a subset of expected Snipara tools, call \`snipara_help(list_all=true)\` and compare exact tool names before concluding a tool is unavailable. If only a partial surface remains after exact discovery, use \`snipara-companion recall\`, \`snipara-companion query\`, and \`snipara-companion task-commit\` as a reliable local fallback.
+- At the start of every new thread, validate hosted MCP with a tool-oriented call such as \`snipara_settings\`, \`snipara_help(query=...)\`, or a lightweight \`snipara_context_query\`. Do not treat empty MCP resources/templates as an outage because Snipara may be tool-only.
+- A lean default Snipara tool set is expected. Use \`snipara_help(query=...)\` for routed guidance, \`snipara_help(list_all=true)\` to inspect specialist opt-in surfaces, and \`snipara-companion recall\`, \`snipara-companion query\`, or \`snipara-companion task-commit\` as local fallbacks when the simple tools are unavailable.
 - If the client supports native skills, install the generated Snipara skill pack from \`.snipara/templates/skills\`. Keep \`AGENTS.md\` as the shared fallback for clients without native skill support.
 
 ${EXPERIENCE_GOAL_SECTION}
@@ -2541,8 +2537,8 @@ function getClientGuidance(client) {
       "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.",
       "Use SNIPARA_API_KEY as the only Codex bearer_token_env_var; restart Codex after changing MCP config.",
-      "If Codex lazily exposes only a minimal tool set, force discovery for snipara_recall, snipara_context_query, snipara_settings, and the exact htask or swarm tool names you need; use snipara_help(list_all=true) to confirm the hosted catalog before concluding the MCP surface is incomplete.",
-      "When Codex still exposes only the minimal core tools, use snipara-orchestrator swarm-* and htask-* as the primary path for shared queues and multi-agent task work."
+      "If Codex exposes only the lean Snipara tool set, that is expected. Use snipara_help(query=...) for routed guidance and snipara_help(list_all=true) to inspect specialist opt-in surfaces before requesting exact htask or swarm schemas.",
+      "When Codex cannot expose orchestration schemas directly, use snipara-orchestrator swarm-* and htask-* as the primary path for shared queues and multi-agent task work."
     ];
   }
   if (client === "gemini") {
@@ -2840,8 +2836,8 @@ ${guidance.map((line) => `- ${line}`).join("\n")}
 
 ## Agent Workflow
 
-- At the start of every new thread, validate hosted MCP with a tool-oriented call such as \`snipara_settings\`, \`tools/list\`, or a lightweight \`snipara_context_query\`. Do not treat empty MCP resources/templates as an outage because Snipara may be tool-only.
-- If a session exposes only a subset of expected Snipara tools, call \`snipara_help(list_all=true)\` and compare exact tool names before concluding a tool is unavailable. If only a partial surface remains after exact discovery, use \`snipara-companion recall\`, \`snipara-companion query\`, and \`snipara-companion task-commit\` as a reliable local fallback.
+- At the start of every new thread, validate hosted MCP with a tool-oriented call such as \`snipara_settings\`, \`snipara_help(query=...)\`, or a lightweight \`snipara_context_query\`. Do not treat empty MCP resources/templates as an outage because Snipara may be tool-only.
+- A lean default Snipara tool set is expected. Use \`snipara_help(query=...)\` for routed guidance, \`snipara_help(list_all=true)\` to inspect specialist opt-in surfaces, and \`snipara-companion recall\`, \`snipara-companion query\`, or \`snipara-companion task-commit\` as local fallbacks when the simple tools are unavailable.
 - Start substantial work with \`snipara_recall\` and \`snipara_context_query\`.
 - Use \`answer_pack\` facts, caveats, source maps, and verification checks before making claims.
 - For coding tasks, choose a workflow mode before editing: LITE for small single-phase changes, FULL managed workflow for multi-file, risky, release/deploy, architectural, compaction-prone, or future-maintainer-sensitive work.
@@ -3712,7 +3708,7 @@ function printSuccess(answers, report) {
       "Restart Codex after changing ~/.codex/config.toml so it rediscovers the hosted Snipara MCP tools."
     );
     printNextStep(
-      "If Codex shows only a minimal Snipara tool set, force discovery for snipara_recall, snipara_context_query, snipara_settings, and any exact htask or swarm tool names you need; confirm the hosted catalog with snipara_help(list_all=true)."
+      "If Codex shows only the lean Snipara tool set, that is expected. Use snipara_help(query=...) for routed guidance, confirm specialist opt-in surfaces with snipara_help(list_all=true), and request exact htask or swarm tools only when the workflow explicitly needs them."
     );
     printNextStep(
       "If Codex still does not expose the hosted task-routing tools, prefer snipara-orchestrator swarm-* and htask-* for shared queue or multi-agent task work."

package/package.json

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