create-snipara 1.3.47 → 1.3.49

package/README.md

@@ -12,7 +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.
+so an LLM client can use Snipara context and reviewed memory. Install once with
+`create-snipara`; continue every session with `snipara-companion`.
 
 Use it for:
 
@@ -50,7 +51,8 @@ The product surfaces remain:
 
 The default CLI path wires the local companion around those surfaces:
 
-- `snipara-companion` for local workflow commands and managed phase commits
+- `snipara-companion` for Git-style status, briefs, timelines, phase commits,
+  handoffs, resume, and local workflow commands
 - `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
@@ -101,7 +103,8 @@ That distinction matters:
 - writes Hosted MCP configuration
 - detects a GitHub remote and can open the Snipara GitHub App automation path
 - explains the GitHub PR Answer Packs path for AI-assisted pull request workflows
-- installs `snipara-companion` by default for local managed workflows
+- installs `snipara-companion` by default for local status, briefs, timelines,
+  phase commits, handoffs, resume, and managed workflows
 - installs optional `snipara-sandbox`
 - installs optional `snipara-orchestrator` for proof gates, drift checks, and htask workflows when requested
 - configures `.mcp.json`
@@ -178,14 +181,21 @@ Existing root `AGENTS.md` and `CLAUDE.md` files are not replaced. The installer
 adds or refreshes a marked Snipara section so project-specific instructions stay
 intact.
 
-When `snipara-companion` is installed, the companion pack also includes the compaction-safe managed workflow. Keep the machine plan in JSON for stable phase ids; an optional Markdown file can remain the human-facing contract.
+When `snipara-companion` is installed, the companion pack also includes the
+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.
 
 ```bash
+snipara-companion status
+snipara-companion brief --task "ship auth hardening" --changed-files src/auth.ts
 snipara-companion workflow start --goal "ship auth hardening" --plan-file ./plan.json
 snipara-companion workflow phase-start context
 snipara-companion workflow run --mode full --include-session-context --query "load auth context"
 snipara-companion code impact --changed-files src/auth.ts tests/auth.test.ts --diff-summary "auth hardening"
 snipara-companion workflow phase-commit context --summary "Loaded context and mapped impacted files" --files src/auth.ts
+snipara-companion timeline
+snipara-companion handoff --summary "auth context mapped" --next "implement auth hardening"
 snipara-companion workflow resume --include-session-context
 snipara-companion workflow phase-start implementation
 snipara-companion workflow run --mode full --include-session-context --query "implement auth hardening"

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "1.3.47",
+  version: "1.3.49",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -90,7 +90,7 @@ var API_URL = "https://api.snipara.com";
 var COMPANION_PACKAGE_NAME = "snipara-companion";
 var COMPANION_COMMAND_NAME = "snipara-companion";
 var COMPANION_NPX_COMMAND = "npx -y snipara-companion@latest";
-var MIN_COMPANION_VERSION = "1.1.37";
+var MIN_COMPANION_VERSION = "1.3.0";
 var GITHUB_ANSWER_PACKS_LABEL = "GitHub PR Answer Packs";
 var MCP_PACKAGE_NAME = "snipara-mcp";
 var SANDBOX_PACKAGE_NAME = "snipara-sandbox[all]";
@@ -248,6 +248,58 @@ function normalizeInitOptions(options) {
   }
   return normalized;
 }
+function normalizeMaintenanceOptions(options) {
+  const parsed = parseMaintenanceOptionsFromArgv(process.argv.slice(2));
+  const normalized = { ...parsed };
+  for (const [key, value] of Object.entries(options)) {
+    if (value !== void 0) {
+      normalized[key] = value;
+    }
+  }
+  return normalized;
+}
+function parseMaintenanceOptionsFromArgv(args) {
+  const parsed = {};
+  const valueFlags = {
+    "--api-key": "apiKey",
+    "--slug": "slug",
+    "--project-id": "projectId",
+    "--profile": "profile",
+    "--client": "client"
+  };
+  const booleanFlags = {
+    "--skip-npm-check": "skipNpmCheck",
+    "--with-hooks": "withHooks",
+    "--with-runtime": "withRuntime",
+    "--with-mcp": "withMcp",
+    "--with-companion": "withCompanion",
+    "--with-orchestrator": "withOrchestrator",
+    "--json": "json"
+  };
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (!arg.startsWith("-")) {
+      continue;
+    }
+    const [flag, inlineValue] = arg.split("=", 2);
+    const valueKey = valueFlags[flag];
+    if (valueKey) {
+      const value = inlineValue ?? args[index + 1];
+      if (value !== void 0 && !value.startsWith("-")) {
+        parsed[valueKey] = value;
+        if (inlineValue === void 0) {
+          index += 1;
+        }
+      }
+      continue;
+    }
+    const booleanKey = booleanFlags[flag];
+    if (booleanKey) {
+      parsed[booleanKey] = true;
+    }
+  }
+  return parsed;
+}
 function parseInitOptionsFromArgv(args) {
   const parsed = {};
   const valueFlags = {
@@ -331,18 +383,19 @@ async function runInit(options) {
   }
 }
 async function runDoctor(options) {
-  const requestedClient = normalizeClientOption(options.client);
-  const existingAnswers = loadExistingAnswers(options);
+  const normalizedOptions = normalizeMaintenanceOptions(options);
+  const requestedClient = normalizeClientOption(normalizedOptions.client);
+  const existingAnswers = loadExistingAnswers(normalizedOptions);
   const answers = {
     ...existingAnswers,
     aiClient: requestedClient || existingAnswers.aiClient
   };
   const report = await runValidation(answers, true, {
     client: requestedClient || answers.aiClient,
-    includeNpmFreshness: !options.skipNpmCheck
+    includeNpmFreshness: !normalizedOptions.skipNpmCheck
   });
   writeDoctorReport(report);
-  if (options.json) {
+  if (normalizedOptions.json) {
     console.log(JSON.stringify({ detection: detectEnvironment(), validation: report }, null, 2));
     return;
   }
@@ -1723,7 +1776,7 @@ async function installClaudeCodeHooks(answers) {
     {
       event: "PreToolUse",
       entry: {
-        matcher: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write",
+        matcher: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write|mcp__.*",
         hooks: [
           {
             type: "command",
@@ -1749,7 +1802,7 @@ async function installClaudeCodeHooks(answers) {
     {
       event: "PostToolUse",
       entry: {
-        matcher: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write",
+        matcher: "Bash|Read|Grep|Glob|Edit|MultiEdit|Write|mcp__.*",
         hooks: [
           {
             type: "command",
@@ -1814,7 +1867,17 @@ fi
 
 if [ -n "$SNIPARA_COMPANION_BIN" ]; then
   INPUT=$(cat || true)
-  "$SNIPARA_COMPANION_BIN" pre-tool "$INPUT" || true
+  TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // .tool // .name // "unknown"' 2>/dev/null || echo "unknown")
+  TOOL_INPUT_JSON=$(printf '%s' "$INPUT" | jq -c '.tool_input // .input // .arguments // .args // .' 2>/dev/null || printf '%s' "$INPUT")
+  CONTEXT=$("$SNIPARA_COMPANION_BIN" pre-tool "$TOOL_INPUT_JSON" --tool "$TOOL_NAME" --max-tokens "\${SNIPARA_HOOK_MAX_TOKENS:-1200}" 2>/dev/stderr || true)
+  if [ -n "$CONTEXT" ]; then
+    jq -n --arg content "$CONTEXT" '{
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        additionalContext: $content
+      }
+    }'
+  fi
 fi
 `;
 }
@@ -1832,9 +1895,17 @@ fi
 
 if [ -n "$SNIPARA_COMPANION_BIN" ]; then
   if [ -f ".snipara/workflow/current.json" ]; then
-    "$SNIPARA_COMPANION_BIN" workflow resume --include-session-context || true
+    CONTEXT=$("$SNIPARA_COMPANION_BIN" workflow resume --include-session-context 2>/dev/stderr || true)
   else
-    "$SNIPARA_COMPANION_BIN" session-bootstrap || true
+    CONTEXT=$("$SNIPARA_COMPANION_BIN" session-bootstrap --include-session-context --max-context-tokens "\${SNIPARA_HOOK_MAX_TOKENS:-1200}" 2>/dev/stderr || true)
+  fi
+  if [ -n "$CONTEXT" ]; then
+    jq -n --arg content "$CONTEXT" '{
+      hookSpecificOutput: {
+        hookEventName: "SessionStart",
+        additionalContext: $content
+      }
+    }'
   fi
 fi
 `;
@@ -1853,7 +1924,23 @@ fi
 
 if [ -n "$SNIPARA_COMPANION_BIN" ]; then
   INPUT=$(cat || true)
-  "$SNIPARA_COMPANION_BIN" post-tool "$INPUT" || true
+  TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // .tool // .name // "unknown"' 2>/dev/null || echo "unknown")
+  TOOL_INPUT_JSON=$(printf '%s' "$INPUT" | jq -c '.tool_input // .input // .arguments // .args // .' 2>/dev/null || printf '%s' "$INPUT")
+  TOOL_OUTPUT_JSON=$(printf '%s' "$INPUT" | jq -c '.tool_response // .tool_output // .result // .response // {}' 2>/dev/null || echo "{}")
+  STATUS=$(printf '%s' "$INPUT" | jq -r '.status // .tool_status // empty' 2>/dev/null || true)
+  ARGS=(post-tool "$TOOL_INPUT_JSON" --tool "$TOOL_NAME" --result "$TOOL_OUTPUT_JSON")
+  if [ -n "$STATUS" ]; then
+    ARGS+=(--status "$STATUS")
+  fi
+  CONTEXT=$("$SNIPARA_COMPANION_BIN" "\${ARGS[@]}" 2>/dev/stderr || true)
+  if [ -n "$CONTEXT" ]; then
+    jq -n --arg content "$CONTEXT" '{
+      hookSpecificOutput: {
+        hookEventName: "PostToolUse",
+        additionalContext: $content
+      }
+    }'
+  fi
 fi
 `;
 }
@@ -1871,9 +1958,17 @@ fi
 
 if [ -n "$SNIPARA_COMPANION_BIN" ]; then
   if [ -f ".snipara/workflow/current.json" ]; then
-    "$SNIPARA_COMPANION_BIN" task-commit --summary "Claude Code compacted while a managed workflow state existed. Resume with snipara-companion workflow resume --include-session-context and continue from .snipara/workflow/current.json." --category workflow-compaction --outcome partial || true
+    CONTEXT=$("$SNIPARA_COMPANION_BIN" task-commit --summary "Claude Code compacted while a managed workflow state existed. Resume with snipara-companion workflow resume --include-session-context and continue from .snipara/workflow/current.json." --category workflow-compaction --outcome partial 2>/dev/stderr || true)
   else
-    "$SNIPARA_COMPANION_BIN" task-commit --summary "Claude Code compacted local session context" --outcome partial || true
+    CONTEXT=$("$SNIPARA_COMPANION_BIN" task-commit --summary "Claude Code compacted local session context" --category session-compaction --outcome partial 2>/dev/stderr || true)
+  fi
+  if [ -n "$CONTEXT" ]; then
+    jq -n --arg content "$CONTEXT" '{
+      hookSpecificOutput: {
+        hookEventName: "PreCompact",
+        additionalContext: $content
+      }
+    }'
   fi
 fi
 `;
@@ -2517,7 +2612,11 @@ function getClaudeClientChecks(answers, detection) {
   const projectHasSnipara = containsSniparaMcpReference(projectConfig);
   const projectSettingsHasSnipara = containsSniparaMcpReference(projectSettings);
   const codeSettingsHasSnipara = containsSniparaMcpReference(codeSettings);
-  const hasLegacyCodeSettingsMcp = projectSettingsHasSnipara || codeSettingsHasSnipara;
+  const legacyCodeSettingsMcpLocations = [
+    projectSettingsHasSnipara ? "project .claude/settings.json" : null,
+    codeSettingsHasSnipara ? "global ~/.claude/settings.json" : null
+  ].filter(Boolean);
+  const hasLegacyCodeSettingsMcp = legacyCodeSettingsMcpLocations.length > 0;
   const desktopHasSnipara = containsSniparaMcpReference(desktopConfig);
   const projectHooksConfigured = containsClaudeHooksReference(projectSettings);
   checks.push({
@@ -2529,7 +2628,9 @@ function getClaudeClientChecks(answers, detection) {
     checks.push({
       name: "claude_code_settings",
       status: hasLegacyCodeSettingsMcp ? "warn" : "pass",
-      detail: hasLegacyCodeSettingsMcp ? "Legacy Claude settings contain an MCP server entry; Claude Code project MCP should live in .mcp.json or be managed by claude mcp add --scope project" : "Claude settings are not being used as the MCP destination; .claude/settings.json is hooks-only"
+      detail: hasLegacyCodeSettingsMcp ? `Legacy Claude settings contain an MCP server entry (${legacyCodeSettingsMcpLocations.join(
+        ", "
+      )}); Claude Code project MCP should live in .mcp.json or be managed by claude mcp add --scope project` : "Claude settings are not being used as the MCP destination; .claude/settings.json is hooks-only"
     });
     checks.push({
       name: "claude_code_hooks",

package/package.json

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