snipara-companion 3.2.4 → 3.2.6

package/dist/index.d.ts

@@ -1440,6 +1440,7 @@ interface MemoryGuardCheckOptions {
     confirmedByUser?: string;
     strict?: boolean;
     json?: boolean;
+    verbose?: boolean;
     limit?: number;
     categories?: string[];
     includeContext?: boolean;
@@ -3385,6 +3386,7 @@ declare function buildWorkflowPhaseCommitSummary(args: {
     phase: Pick<ManagedWorkflowPhase, "id" | "title">;
     summary: string;
 }): string;
+declare function resolveAutoWorkflowMode(query: string): Exclude<WorkflowMode, "auto">;
 /**
  * Compute the impact gate for committed-but-unpushed workflow phases.
  *
@@ -3869,6 +3871,7 @@ interface CollaborationCommandOptions {
     ackReviewOnly?: boolean;
     dir?: string;
     json?: boolean;
+    verbose?: boolean;
 }
 interface CollaborationHooksInstallOptions {
     dir?: string;
@@ -4255,4 +4258,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
 declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
 declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
 
-export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, appendActivityEvent, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, appendActivityEvent, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };

package/dist/index.js

@@ -192,6 +192,7 @@ __export(index_exports, {
   realityCheckCommand: () => realityCheckCommand,
   referencesIngestCommand: () => referencesIngestCommand,
   referencesScanCommand: () => referencesScanCommand,
+  resolveAutoWorkflowMode: () => resolveAutoWorkflowMode,
   resolveContextPackRecord: () => resolveContextPackRecord,
   resolveFullWorkflowTokenBudget: () => resolveFullWorkflowTokenBudget,
   resolveLocalWorkerRoutingDefaults: () => resolveLocalWorkerRoutingDefaults,
@@ -8361,6 +8362,9 @@ function printMemoryGuardResult(result) {
     }
   }
 }
+function shouldPrintCompactMemoryGuardSuccess(result, options) {
+  return !options.verbose && result.triggered && !result.shouldBlock && !result.requiresConfirmation && result.contradictions.length === 0 && result.recentFailures.length === 0 && result.warnings.length === 0;
+}
 async function runMemoryGuardCheck(options = {}) {
   const cwd = process.env.SNIPARA_WORKSPACE_DIR || process.cwd();
   const root = findWorkspaceRoot(cwd, true) || cwd;
@@ -8572,6 +8576,8 @@ async function memoryGuardCheckCommand(options) {
   const result = await runMemoryGuardCheck(options);
   if (options.json) {
     console.log(JSON.stringify(result, null, 2));
+  } else if (shouldPrintCompactMemoryGuardSuccess(result, options)) {
+    console.log(`Snipara Memory Guard: checked (${result.trigger})`);
   } else if (result.triggered || options.trigger === "manual") {
     printMemoryGuardResult(result);
   }
@@ -12461,7 +12467,7 @@ function printDoctorReport(report, companionVersion, auth, toolCatalog) {
     "- This doctor confirms local auth and hosted reachability; it does not prove how a specific agent UI ranked or exposed tools."
   );
   console.log(
-    "- If an agent session shows only a subset of Snipara tools, call snipara_help(list_all=true) in that session before concluding a tool is unavailable."
+    "- A lean Snipara tool set is expected in normal agent sessions. Use snipara_help(query=...) for routed guidance and snipara_help(list_all=true) to inspect specialist opt-in surfaces."
   );
   if (toolCatalog.available && toolCatalog.htaskToolCount) {
     console.log(
@@ -18868,11 +18874,30 @@ function shellQuote2(value) {
 function phaseQuery(state, phase) {
   return phase.query || `${state.goal}: ${phase.title}`;
 }
-function effectiveWorkflowMode(mode) {
-  return mode === "auto" ? "standard" : mode;
+function resolveAutoWorkflowMode(query) {
+  const normalized = query.toLowerCase();
+  if (/\b(orchestrate|swarm|htask|handoff|multi-agent|multi agent|worker|proof gate|proof-gate|drift check|release gate|production gate)\b/.test(
+    normalized
+  )) {
+    return "orchestrate";
+  }
+  if (/\b(deploy|deployment|release|merge|push|migration|schema|auth|billing|security|architecture|architectural|multi-phase|multiphase|phase commit|final commit|managed workflow|roadmap|plan)\b/.test(
+    normalized
+  )) {
+    return "full";
+  }
+  if (/\b(status|show|list|read|lookup|recall|brief|summarize|summary|what changed|question|docs?|documentation)\b/.test(
+    normalized
+  ) && !/\b(implement|change|fix|ship|code|refactor|test|write|create|build)\b/.test(normalized)) {
+    return "lite";
+  }
+  return "standard";
+}
+function effectiveWorkflowMode(mode, query = "") {
+  return mode === "auto" ? resolveAutoWorkflowMode(query) : mode;
 }
-function shouldFollowWorkflowRecommendations(mode) {
-  const effectiveMode = effectiveWorkflowMode(mode);
+function shouldFollowWorkflowRecommendations(mode, query = "") {
+  const effectiveMode = effectiveWorkflowMode(mode, query);
   return effectiveMode === "standard" || effectiveMode === "full";
 }
 function printManagedWorkflowState(state) {
@@ -18917,7 +18942,7 @@ function printManagedWorkflowDiscipline() {
     "- LITE: small single-phase edits still start with Snipara recall/context and end with local verification."
   );
   console.log(
-    "- STANDARD: normal coding work uses context plus recommended code-graph follow-up; --mode auto is a compatibility alias."
+    "- STANDARD: normal coding work uses context plus recommended code-graph follow-up; --mode auto deterministically selects lite/standard/full/orchestrate from task intent."
   );
   console.log(
     "- FULL: use this managed workflow with phases/chunks for multi-file, risky, release/deploy, architectural, or compaction-prone coding work."
@@ -22043,7 +22068,8 @@ async function workflowRunCommand(options) {
     routingOptions,
     adaptiveRoutingWithCatalog
   ) ? enrichAdaptiveRoutingWithLocalOrchestrator(adaptiveRoutingWithCatalog, routingOptions) : adaptiveRoutingWithCatalog;
-  const orchestratorRecommendation = getOrchestratorRecommendation(options.query, options.mode, {
+  const effectiveMode = effectiveWorkflowMode(options.mode, options.query);
+  const orchestratorRecommendation = getOrchestratorRecommendation(options.query, effectiveMode, {
     policyAutoRoute: options.autoRouteOrchestrator,
     policySource: options.orchestratorPolicySource,
     adaptiveRoutingDryRun: Boolean(adaptiveRouting)
@@ -22055,13 +22081,13 @@ async function workflowRunCommand(options) {
     query: options.query,
     summary: options.query,
     title: options.query,
-    mode: options.mode,
+    mode: effectiveMode,
     adaptiveRouting
   }) : null;
   if (!hostedConfigured) {
     const payload2 = {
       mode: options.mode,
-      effective_mode: effectiveWorkflowMode(options.mode),
+      effective_mode: effectiveMode,
       local_only: true,
       local_policy_path: localAdaptiveRoutingPolicy ? ADAPTIVE_ROUTING_POLICY_RELATIVE_PATH2 : null,
       orchestrator_recommendation: orchestratorRecommendation,
@@ -22091,7 +22117,7 @@ async function workflowRunCommand(options) {
   if (!client) {
     throw new Error("Hosted Snipara client unavailable after configuration check.");
   }
-  if (options.mode === "orchestrate") {
+  if (effectiveMode === "orchestrate") {
     const result = await client.orchestrate(options.query, options.maxTokens);
     if (options.json) {
       printJson2({
@@ -22106,8 +22132,8 @@ async function workflowRunCommand(options) {
     }
     printOrchestrateResult(result);
     if (options.runtimeHint !== false) {
-      printRuntimeHint(options.query, options.mode);
-      printOrchestratorHandoffHint(options.query, options.mode, orchestratorRecommendation);
+      printRuntimeHint(options.query, effectiveMode);
+      printOrchestratorHandoffHint(options.query, effectiveMode, orchestratorRecommendation);
     }
     if (adaptiveRouting) {
       printAdaptiveRoutingRecommendation(adaptiveRouting);
@@ -22117,8 +22143,7 @@ async function workflowRunCommand(options) {
     }
     return;
   }
-  const effectiveMode = effectiveWorkflowMode(options.mode);
-  const shouldRequestSharedContext = shouldFollowWorkflowRecommendations(options.mode) && hasSharedContextIntent(options.query);
+  const shouldRequestSharedContext = shouldFollowWorkflowRecommendations(options.mode, options.query) && hasSharedContextIntent(options.query);
   const workflowBudget = effectiveMode === "full" ? resolveFullWorkflowTokenBudget({
     maxTokens: options.maxTokens,
     includeSessionContext: options.includeSessionContext,
@@ -22162,7 +22187,7 @@ async function workflowRunCommand(options) {
       includeContent: true
     });
   }
-  if (context.recommended_tool && shouldFollowWorkflowRecommendations(options.mode)) {
+  if (context.recommended_tool && shouldFollowWorkflowRecommendations(options.mode, options.query)) {
     payload.executed_recommended_tool = await runRecommendedTool(context);
   }
   if (effectiveMode === "full") {
@@ -22256,8 +22281,8 @@ async function workflowRunCommand(options) {
     printManagedWorkflowStarted(payload.managed_workflow);
   }
   if (options.runtimeHint !== false) {
-    printRuntimeHint(options.query, options.mode);
-    printOrchestratorHandoffHint(options.query, options.mode, orchestratorRecommendation);
+    printRuntimeHint(options.query, effectiveMode);
+    printOrchestratorHandoffHint(options.query, effectiveMode, orchestratorRecommendation);
   }
   if (adaptiveRouting) {
     printAdaptiveRoutingRecommendation(adaptiveRouting);
@@ -29794,6 +29819,11 @@ var HOSTED_GUARD_MAX_FILES = 450;
 var HOSTED_GUARD_MAX_RESOURCES = 850;
 var HOSTED_GUARD_MAX_SYMBOL_RESOURCES = 160;
 var HOOK_BLOCK_PREFIX2 = "snipara:collaboration-guard";
+var CHECKOUT_GIT_WRITE_RESOURCE = {
+  kind: "SURFACE",
+  id: "checkout-git-write",
+  label: "Checkout git write access"
+};
 var CRITICAL_SURFACES = [
   {
     id: "auth",
@@ -30040,7 +30070,8 @@ async function collaborationStartCommand(options) {
       state,
       hosted
     },
-    options.json
+    options.json,
+    options.verbose
   );
 }
 async function collaborationClaimCommand(options) {
@@ -30082,7 +30113,8 @@ async function collaborationClaimCommand(options) {
       state,
       hosted
     },
-    options.json
+    options.json,
+    options.verbose
   );
 }
 async function collaborationGuardCommand(options) {
@@ -30140,7 +30172,8 @@ async function collaborationGuardCommand(options) {
         failed: guardFailed
       }
     },
-    options.json
+    options.json,
+    options.verbose
   );
 }
 function buildCollaborationHooksInstallPlan(options = {}) {
@@ -30647,6 +30680,9 @@ function resolveRepoRoot3(cwd) {
 }
 function deriveGuardProfileResources(profile, files) {
   const resources = [];
+  if (profile === "pre-commit" || profile === "pre-push") {
+    resources.push(CHECKOUT_GIT_WRITE_RESOURCE);
+  }
   if (profile === "pre-deploy") {
     resources.push(
       { kind: "DEPLOY", id: "production-deployment", label: "Production deployment" },
@@ -30861,11 +30897,12 @@ function buildCollaborationGitHookBlock(hookName) {
   const profile = hookName === "pre-push" ? "pre-push" : "pre-commit";
   return [
     collaborationHookBlockMarker(hookName, "start"),
-    "# Block unsafe parallel edits before code leaves the local worktree.",
+    "# Atomically claim checkout git writes, then block unsafe parallel edits.",
     'if [ "${SNIPARA_COLLABORATION_GUARD:-1}" = "0" ]; then',
     '  echo "Snipara collaboration guard bypassed by SNIPARA_COLLABORATION_GUARD=0" >&2',
     "elif command -v snipara-companion >/dev/null 2>&1; then",
-    `  snipara-companion collaboration guard --profile ${profile} --action ${profile} --enforce --json >/dev/null`,
+    `  snipara-companion collaboration claim --resource SURFACE:checkout-git-write --mode EXCLUSIVE --ttl-seconds 300 --reason "${profile} git write" --json >/dev/null`,
+    `  snipara-companion collaboration guard --profile ${profile} --action ${profile} --resource SURFACE:checkout-git-write --enforce --json >/dev/null`,
     "else",
     '  echo "snipara-companion is required for the Snipara collaboration guard. Install it or set SNIPARA_COLLABORATION_GUARD=0 for an explicit emergency bypass." >&2',
     "  exit 1",
@@ -30951,7 +30988,7 @@ function resolveReleaseLeaseIds(state, options) {
   }
   throw new Error("No collaboration lease id provided and no active local lease was found");
 }
-function printCollaborationResult(payload, json) {
+function printCollaborationResult(payload, json, verbose) {
   if (json) {
     console.log(JSON.stringify(payload, null, 2));
     return;
@@ -30959,6 +30996,10 @@ function printCollaborationResult(payload, json) {
   const action = String(payload.action ?? "status");
   const state = payload.state;
   const hosted = payload.hosted;
+  if (!verbose && action === "guard" && isQuietCollaborationGuardSuccess(payload, hosted)) {
+    console.log("Collaboration guard: go");
+    return;
+  }
   console.log(getCollaborationHeading(action));
   console.log(`State: ${payload.statePath}`);
   console.log(`Work session: ${state.workSessionId ?? "none"}`);
@@ -30986,6 +31027,17 @@ function printCollaborationResult(payload, json) {
     printGuardActionCards(payload.actionCards);
   }
 }
+function isQuietCollaborationGuardSuccess(payload, hosted) {
+  const guard = hosted?.status === "ok" ? hosted.data : void 0;
+  if (!guard || guard.evaluation.decision !== "CLEAR") {
+    return false;
+  }
+  if (guard.evaluation.conflicts.length > 0 || guard.evaluation.recommendedActions.length > 0) {
+    return false;
+  }
+  const actionCards = payload.actionCards;
+  return !actionCards || actionCards.length === 0;
+}
 function printHostedCollaboration(action, data) {
   if (!data) {
     return;
@@ -32051,7 +32103,7 @@ program.command("memory-guard").description(
   new import_commander.Command("check").description("Check whether memory/context guidance is required before continuing").option("--trigger <trigger>", "failure|pre-commit|commit|pre-final|manual", "manual").option("--file <file>", "Touched file").option("--files <files...>", "Touched files").option("--staged", "Use git staged files").option("--command <command>", "Command or action that failed").option("--intent <intent>", "Proposed user intent or action to check before mutating").option("--result <result>", "Command result preview").option("--exit-code <code>", "Command exit code").option("--status <status>", "Command status").option("--destructive", "Treat the proposed action as destructive or irreversible").option("--require-confirmation", "Require explicit user confirmation before continuing").option(
     "--confirmed-by-user <confirmation>",
     "Explicit user confirmation text that permits a strict destructive/contradictory override"
-  ).option("--strict", "Exit non-zero if guidance is required but unavailable").option("--category <categories...>", "Additional memory categories to recall").option("--no-context", "Skip source context query").option("--no-recent-failures", "Skip recent Companion event failure inspection").option("--json", "Print raw JSON").action(async (options) => {
+  ).option("--strict", "Exit non-zero if guidance is required but unavailable").option("--category <categories...>", "Additional memory categories to recall").option("--no-context", "Skip source context query").option("--no-recent-failures", "Skip recent Companion event failure inspection").option("--json", "Print raw JSON").option("--verbose", "Print full non-blocking guard details instead of one-line success").action(async (options) => {
     await memoryGuardCheckCommand({
       trigger: options.trigger,
       files: [
@@ -32071,7 +32123,8 @@ program.command("memory-guard").description(
       categories: options.category,
       includeContext: options.context,
       recentFailures: options.recentFailures,
-      json: options.json
+      json: options.json,
+      verbose: options.verbose
     });
   })
 ).addCommand(
@@ -32979,7 +33032,7 @@ collaboration.command("guard").description("Check files or resources against act
 ).option("-a, --action <action>", "Guarded action label", "edit").option("--actor <actor>", "Developer or agent display name").option("--actor-id <actorId>", "Stable developer or agent id").option("--actor-type <actorType>", "HUMAN|AGENT|SYSTEM", "AGENT").option("--session-id <sessionId>", "Automation/session id").option("--work-session-id <workSessionId>", "Existing hosted work session id").option("--client <client>", "Client label", "snipara-companion").option("--repository <repository>", "Repository id").option("-b, --branch <branch>", "Current branch name").option("--worktree <worktree>", "Worktree path").option("--max-files <number>", "Maximum files for local code resource expansion", "2000").option("--no-persist", "Evaluate without storing a guard event").option("--enforce", "Exit non-zero for REVIEW_REQUIRED or REQUIRES_ACK, not only BLOCKED").option(
   "--ack-review-only",
   "Under --enforce, acknowledge review-only stale-state and decision-consistency warnings"
-).option("-d, --dir <directory>", "Repository directory (default: current)").option("--json", "Print raw JSON").action(async (options) => {
+).option("-d, --dir <directory>", "Repository directory (default: current)").option("--json", "Print raw JSON").option("--verbose", "Print the full guard report even when the guard passes").action(async (options) => {
   await collaborationGuardCommand({
     files: options.files,
     resources: options.resource,
@@ -32999,7 +33052,8 @@ collaboration.command("guard").description("Check files or resources against act
     enforce: Boolean(options.enforce),
     ackReviewOnly: Boolean(options.ackReviewOnly),
     dir: options.dir,
-    json: options.json
+    json: options.json,
+    verbose: Boolean(options.verbose || process.argv.includes("--verbose"))
   });
 });
 collaboration.command("hooks").description("Install blocking Git hooks that run the hosted collaboration guard").addCommand(
@@ -33757,6 +33811,7 @@ if (require.main === module) {
   realityCheckCommand,
   referencesIngestCommand,
   referencesScanCommand,
+  resolveAutoWorkflowMode,
   resolveContextPackRecord,
   resolveFullWorkflowTokenBudget,
   resolveLocalWorkerRoutingDefaults,

package/docs/FULL_REFERENCE.md

@@ -137,11 +137,11 @@ For Codex, the primary integration remains Hosted MCP plus `AGENTS.md`.
 - `snipara-companion` is still skippable with `--profile hosted-only` or `--skip-companion`.
 - Use it when compaction-safe phase commits, Project Intelligence briefs, local doctor checks, or shared helper workflows are useful.
 - Use `workflow scaffold --preset project-intelligence-continuity-layer` for roadmap-sized Project Intelligence work that needs phase commits.
-- If an agent session exposes only a subset of Snipara tools, use `snipara_help(list_all=true)` in that session before concluding a tool is unavailable.
+- Normal agent sessions intentionally expose a small Snipara tool set. Use `snipara_help(query=...)` for routed guidance and `snipara_help(list_all=true)` to inspect specialist tools before requesting an expanded surface.
 
 ## Configuring MCP Tool Surfaces
 
-The MCP server advertises different tool surfaces depending on the `SNIPARA_EXPOSED_SURFACES` environment variable. Hosted MCP defaults to inline tools plus a small companion maintenance set for index health, reindexing, and read-only memory hygiene. To expose all companion tools directly in the advertised manifest, set `SNIPARA_EXPOSED_SURFACES=inline,companion` on the MCP server. To expose swarm and htask coordination tools, use `SNIPARA_EXPOSED_SURFACES=inline,orchestrator`. Remaining non-default tools are discoverable via `snipara_help` and can be executed by direct JSON-RPC or clients/server configurations that expose those surfaces. Standard MCP agents only receive schemas for tools returned by `tools/list`.
+The MCP server advertises different tool surfaces depending on the `SNIPARA_EXPOSED_SURFACES` environment variable. Hosted MCP defaults to the lean agent contract: context, search, read, stats, help, memory recall/capture, and end-of-task commit. Specialist inline, companion, and orchestrator tools stay discoverable via `snipara_help`, which now marks them as `routed_or_opt_in`; standard agents should usually stay on the simple verbs and let Snipara route internally. To expose companion tools directly in the advertised manifest, set `SNIPARA_EXPOSED_SURFACES=inline,companion` on the MCP server. To expose swarm and htask coordination tools, use `SNIPARA_EXPOSED_SURFACES=inline,orchestrator`. Standard MCP agents only receive schemas for tools returned by `tools/list`.
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "3.2.4",
+  "version": "3.2.6",
   "description": "Local-first CLI that asks your repo what breaks before an AI coding agent edits it.",
   "main": "dist/index.js",
   "bin": {