snipara-companion 3.2.5 → 3.2.7

package/README.md

@@ -133,9 +133,10 @@ verification hints.
 Session Snapshot V0 includes latest activity, risk reasons, touched files, a
 next action, and advisory Intent Detection V0. Intent Detection V0 reports the
 inferred intent, confidence, reason-code signals, local evidence counts, and a
-suggested workflow mode hint for the human or agent to consider. It is
-observational and keeps `hardRoutingAllowed=false` until explicit routing policy
-and receipts exist.
+suggested workflow mode. `workflow run --mode auto` uses that same Control Plane
+principle to choose lite, standard, full, or orchestrate. Lite runs with zero
+mandatory hosted context calls; recall/context/code-impact are on-demand
+escalations, not an entry toll.
 `workflow timeline --export md` prints a compact redacted Markdown timeline for
 handoff or publication.
 

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);
   }
@@ -18868,11 +18874,42 @@ 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(why|pourquoi|decision|décision|rationale|positioning|positionnement|strategy|stratégie|cross-session|previous decision|prior decision|historical context)\b/.test(
+    normalized
+  )) {
+    return "standard";
+  }
+  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";
+  }
+  if (/\b(typo|copy edit|small diff|tiny diff|one-line|one line|known file|obvious fix|quick fix|format|formatting|rename)\b/.test(
+    normalized
+  ) && !/\b(architecture|release|deploy|migration|schema|auth|billing|security|multi-file|many files|5\+ files|cross-session|decision|décision)\b/.test(
+    normalized
+  )) {
+    return "lite";
+  }
+  return "standard";
 }
-function shouldFollowWorkflowRecommendations(mode) {
-  const effectiveMode = effectiveWorkflowMode(mode);
+function effectiveWorkflowMode(mode, query = "") {
+  return mode === "auto" ? resolveAutoWorkflowMode(query) : mode;
+}
+function shouldFollowWorkflowRecommendations(mode, query = "") {
+  const effectiveMode = effectiveWorkflowMode(mode, query);
   return effectiveMode === "standard" || effectiveMode === "full";
 }
 function printManagedWorkflowState(state) {
@@ -18914,14 +18951,15 @@ function safeDecisionPendingCount() {
 function printManagedWorkflowDiscipline() {
   console.log(import_chalk6.default.bold("Coding workflow mode"));
   console.log(
-    "- LITE: small single-phase edits still start with Snipara recall/context and end with local verification."
+    "- LITE: small single-phase edits have no mandatory Snipara calls; use local verification and escalate on demand."
   );
   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 or code graph when the task needs source truth or prior rationale."
   );
   console.log(
     "- FULL: use this managed workflow with phases/chunks for multi-file, risky, release/deploy, architectural, or compaction-prone coding work."
   );
+  console.log("- --mode auto routes by task intent; a nudge is advisory, not a gate.");
   console.log(
     "- FULL + ORCHESTRATED: use explicit snipara-orchestrator handoff only for production gates, drift checks, htasks, or multi-agent coordination."
   );
@@ -20001,6 +20039,17 @@ function printRuntimeHint(query, mode) {
   console.log("Fresh setup: npx create-snipara --profile full-stack --advanced");
   console.log("Manual install: pip install 'snipara-sandbox[all]'");
 }
+function printLiteWorkflowRun(query, requestedMode) {
+  console.log(import_chalk6.default.bold("Workflow Lite"));
+  printKeyValue2("Requested mode:", requestedMode);
+  printKeyValue2("Effective mode:", "lite");
+  printKeyValue2("Task:", query);
+  console.log("No Snipara recall, context query, or bootstrap call was run.");
+  console.log(
+    "Escalate with recall, context_query, code impact, or task-commit only when the task creates that need."
+  );
+  console.log("");
+}
 function runtimeHintVersionLabel(report) {
   if (!report.runtime.cliVersion) {
     return report.runtime.version ? ` (${report.runtime.version})` : "";
@@ -20697,37 +20746,29 @@ function printChunkResult(chunkId, result) {
 function readSessionEntryPreview(entry) {
   return toPreview(entry.text ?? entry.content ?? entry.summary ?? entry.title, 220);
 }
-function printSessionTier(label, tier) {
-  if (tier.memories.length === 0) {
-    return;
-  }
-  console.log(import_chalk6.default.bold(label));
-  for (const entry of tier.memories.slice(0, 5)) {
-    console.log(`- ${readSessionEntryPreview(entry)}`);
-  }
-  console.log("");
+function compactSessionEntryLine(entry) {
+  const label = typeof entry.type === "string" && entry.type.trim().length > 0 ? entry.type.trim() : typeof entry.category === "string" && entry.category.trim().length > 0 ? entry.category.trim() : "memory";
+  return `- ${label}: ${readSessionEntryPreview(entry)}`;
 }
 function printSessionBootstrap(result, options) {
   const normalized = normalizeSessionMemoriesResult(result);
-  printKeyValue2("Durable memory:", normalized.critical.count);
-  printKeyValue2(
-    "Session context:",
-    options.includeSessionContext ? normalized.daily.count : "skipped by default (use --include-session-context)"
-  );
-  if (typeof normalized.total_tokens === "number") {
-    printKeyValue2("Tokens:", normalized.total_tokens);
-  }
-  if (typeof normalized.message === "string" && normalized.message.length > 0) {
-    printKeyValue2("Message:", normalized.message);
+  const entries = [
+    ...normalized.critical.memories,
+    ...options.includeSessionContext ? normalized.daily.memories : []
+  ].slice(0, 5);
+  if (entries.length === 0) {
+    return false;
   }
-  console.log("");
-  printSessionTier("Durable Memory", normalized.critical);
-  if (options.includeSessionContext) {
-    printSessionTier("Session Context (weak carryover)", normalized.daily);
+  console.log(import_chalk6.default.bold("Snipara Bootstrap Brief"));
+  for (const entry of entries) {
+    console.log(compactSessionEntryLine(entry));
   }
-  if (normalized.critical.count === 0 && normalized.daily.count === 0) {
-    printJson2(normalized);
+  const hiddenCount = normalized.critical.count + (options.includeSessionContext ? normalized.daily.count : 0) - entries.length;
+  if (hiddenCount > 0) {
+    console.log(`- ${hiddenCount} more available on demand via recall/session-bootstrap --json.`);
   }
+  console.log("");
+  return true;
 }
 function printSessionBootstrapQuality(report) {
   if (report.warnings.length === 0) {
@@ -22014,10 +22055,11 @@ async function sharedContextCommand(options) {
 }
 async function workflowRunCommand(options) {
   const hostedConfigured = isConfigured();
+  const effectiveMode = effectiveWorkflowMode(options.mode, options.query);
   const localAdaptiveRoutingPolicy = readLocalAdaptiveRoutingProjectPolicy();
   const localAdaptiveRoutingRequested = shouldBuildAdaptiveRouting(options);
-  const canRunLocalAdaptiveRouting = !hostedConfigured && options.mode !== "orchestrate" && (localAdaptiveRoutingRequested || localAdaptiveRoutingPolicy !== null && localAdaptiveRoutingPolicy.mode !== "off");
-  if (!hostedConfigured && !canRunLocalAdaptiveRouting) {
+  const canRunLocalAdaptiveRouting = !hostedConfigured && effectiveMode !== "orchestrate" && (localAdaptiveRoutingRequested || localAdaptiveRoutingPolicy !== null && localAdaptiveRoutingPolicy.mode !== "off");
+  if (!hostedConfigured && !canRunLocalAdaptiveRouting && effectiveMode !== "lite") {
     ensureConfigured();
   }
   const client = hostedConfigured ? createClient(2e4) : null;
@@ -22043,7 +22085,7 @@ async function workflowRunCommand(options) {
     routingOptions,
     adaptiveRoutingWithCatalog
   ) ? enrichAdaptiveRoutingWithLocalOrchestrator(adaptiveRoutingWithCatalog, routingOptions) : adaptiveRoutingWithCatalog;
-  const orchestratorRecommendation = getOrchestratorRecommendation(options.query, options.mode, {
+  const orchestratorRecommendation = getOrchestratorRecommendation(options.query, effectiveMode, {
     policyAutoRoute: options.autoRouteOrchestrator,
     policySource: options.orchestratorPolicySource,
     adaptiveRoutingDryRun: Boolean(adaptiveRouting)
@@ -22055,20 +22097,25 @@ 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,
+      retrieval_policy: effectiveMode === "lite" ? {
+        mandatory_calls: [],
+        escalation: "Run recall, context_query, or code impact only when the task needs them.",
+        persistence: "Use task-commit only when reusable durable knowledge was learned."
+      } : void 0,
       orchestrator_recommendation: orchestratorRecommendation,
       orchestrator_handoff: preparedHandoff,
       adaptive_routing: adaptiveRouting,
       local_worker: localWorkerRoutingDefaults?.worker,
-      warnings: [
+      warnings: effectiveMode === "lite" ? [] : [
         "Hosted Snipara is not configured; workflow run is limited to local Adaptive Work Routing metadata."
       ]
     };
@@ -22076,10 +22123,44 @@ async function workflowRunCommand(options) {
       printJson2(payload2);
       return;
     }
-    console.log(import_chalk6.default.bold("Local Adaptive Work Routing"));
-    console.log(
-      "Hosted Snipara is not configured; no context query, hosted catalog, or planner call ran."
-    );
+    if (effectiveMode === "lite") {
+      printLiteWorkflowRun(options.query, options.mode);
+    } else {
+      console.log(import_chalk6.default.bold("Local Adaptive Work Routing"));
+      console.log(
+        "Hosted Snipara is not configured; no context query, hosted catalog, or planner call ran."
+      );
+    }
+    if (adaptiveRouting) {
+      printAdaptiveRoutingRecommendation(adaptiveRouting);
+    }
+    if (preparedHandoff) {
+      printPreparedOrchestratorHandoff2(preparedHandoff);
+    }
+    return;
+  }
+  if (effectiveMode === "lite") {
+    const payload2 = {
+      mode: options.mode,
+      effective_mode: effectiveMode,
+      retrieval_policy: {
+        mandatory_calls: [],
+        escalation: "Run recall, context_query, or code impact only when the task needs them.",
+        persistence: "Use task-commit only when reusable durable knowledge was learned."
+      },
+      orchestrator_recommendation: orchestratorRecommendation,
+      orchestrator_handoff: preparedHandoff,
+      adaptive_routing: adaptiveRouting,
+      local_worker: localWorkerRoutingDefaults?.worker
+    };
+    if (options.json) {
+      printJson2(payload2);
+      return;
+    }
+    printLiteWorkflowRun(options.query, options.mode);
+    if (options.runtimeHint !== false) {
+      printRuntimeHint(options.query, effectiveMode);
+    }
     if (adaptiveRouting) {
       printAdaptiveRoutingRecommendation(adaptiveRouting);
     }
@@ -22091,7 +22172,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 +22187,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 +22198,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 +22242,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") {
@@ -22206,11 +22286,13 @@ async function workflowRunCommand(options) {
     return;
   }
   if (effectiveMode === "full" && payload.session_bootstrap) {
-    console.log(import_chalk6.default.bold("Workflow Bootstrap"));
-    printSessionBootstrap(payload.session_bootstrap, {
-      includeSessionContext: Boolean(workflowBudget?.include_session_context)
-    });
-    if (payload.session_bootstrap_quality && typeof payload.session_bootstrap_quality === "object") {
+    const printedBootstrap = printSessionBootstrap(
+      payload.session_bootstrap,
+      {
+        includeSessionContext: Boolean(workflowBudget?.include_session_context)
+      }
+    );
+    if (printedBootstrap && payload.session_bootstrap_quality && typeof payload.session_bootstrap_quality === "object") {
       printSessionBootstrapQuality(
         payload.session_bootstrap_quality
       );
@@ -22256,8 +22338,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);
@@ -23156,10 +23238,12 @@ async function workflowResumeCommand(options) {
   }
   console.log(import_chalk6.default.bold("Workflow Resume"));
   printManagedWorkflowState(state);
-  printSessionBootstrap(bootstrap, {
+  const printedBootstrap = printSessionBootstrap(bootstrap, {
     includeSessionContext: resolvedContextTokens > 0
   });
-  printSessionBootstrapQuality(bootstrapQuality);
+  if (printedBootstrap) {
+    printSessionBootstrapQuality(bootstrapQuality);
+  }
   printWorkflowLocalSessionSnapshot(localSessionSnapshot);
   printWorkflowTeamSyncResume(teamSyncResume);
   printWorkflowRuntimeResumePlan(runtimeResume);
@@ -23681,11 +23765,13 @@ async function sessionBootstrapCommand(options) {
     });
     return;
   }
-  printSessionBootstrap(result, {
+  const printedBootstrap = printSessionBootstrap(result, {
     includeSessionContext: resolvedContextTokens > 0
   });
-  printSessionBootstrapQuality(bootstrapQuality);
-  if (warmSnapshot.storedEntries > 0) {
+  if (printedBootstrap) {
+    printSessionBootstrapQuality(bootstrapQuality);
+  }
+  if (printedBootstrap && warmSnapshot.storedEntries > 0) {
     printKeyValue2(
       "Warm cache:",
       `${warmSnapshot.storedEntries} bootstrap memory/context entries primed locally`
@@ -30045,7 +30131,8 @@ async function collaborationStartCommand(options) {
       state,
       hosted
     },
-    options.json
+    options.json,
+    options.verbose
   );
 }
 async function collaborationClaimCommand(options) {
@@ -30087,7 +30174,8 @@ async function collaborationClaimCommand(options) {
       state,
       hosted
     },
-    options.json
+    options.json,
+    options.verbose
   );
 }
 async function collaborationGuardCommand(options) {
@@ -30145,7 +30233,8 @@ async function collaborationGuardCommand(options) {
         failed: guardFailed
       }
     },
-    options.json
+    options.json,
+    options.verbose
   );
 }
 function buildCollaborationHooksInstallPlan(options = {}) {
@@ -30960,7 +31049,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;
@@ -30968,6 +31057,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"}`);
@@ -30995,6 +31088,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;
@@ -32060,7 +32164,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: [
@@ -32080,7 +32184,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(
@@ -32988,7 +33093,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,
@@ -33008,7 +33113,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(
@@ -33766,6 +33872,7 @@ if (require.main === module) {
   realityCheckCommand,
   referencesIngestCommand,
   referencesScanCommand,
+  resolveAutoWorkflowMode,
   resolveContextPackRecord,
   resolveFullWorkflowTokenBudget,
   resolveLocalWorkerRoutingDefaults,

package/docs/FULL_REFERENCE.md

@@ -930,7 +930,9 @@ without an extra LLM provider key because your AI client supplies the reasoning;
 runtime-bound phases it also restores the recorded Sandbox binding and prints a reattach or
 rehydrate plan. It does not snapshot or exactly restore a live Snipara Sandbox or REPL process.
 Short-lived session context is skipped unless you pass `--include-session-context`
-or an explicit `--max-context-tokens`; durable memory still loads by default.
+or an explicit `--max-context-tokens`. Text output is a compact bootstrap brief
+and is silent when no high-signal item is available; use `--json` for the full
+payload.
 `workflow run --mode full --json` also reports `workflow_budget`,
 `session_bootstrap_quality`, and `plan_quality.warnings` so agents can detect
 oversized bootstrap context or weak generated-plan file hints before editing.
@@ -1121,16 +1123,16 @@ snipara-companion workflow scaffold \
 ### Context vs Memory
 
 - Use `snipara-companion query`, `shared-context`, and `load-document` for source truth.
-- Use `snipara-companion recall`, `session-bootstrap`, and `task-commit` for durable memory.
+- Use `snipara-companion recall`, `session-bootstrap`, and `task-commit` for durable memory when the task needs it.
 - Do not use memory as a substitute for document retrieval.
 - Do not upload specs or raw documents into memory.
 
 Semantics:
 
 - `snipara-companion query --follow-recommendation` = execute the hosted recommended structural tool instead of only printing it
-- `snipara-companion workflow run --mode lite` = focused context query for small known-file work
+- `snipara-companion workflow run --mode lite` = zero mandatory hosted calls for small known-file work
 - `snipara-companion workflow run --mode standard` = context query plus automatic `snipara_code_*` follow-up when Snipara recommends one
-- `snipara-companion workflow run --mode auto` = compatibility alias for STANDARD behavior
+- `snipara-companion workflow run --mode auto` = routes to lite, standard, full, or orchestrate from task intent
 - `snipara-companion workflow run --mode full` = budgeted durable bootstrap + optional session context + context query + automatic structural follow-up + hosted plan with quality diagnostics
 - `snipara-companion plan --write-plan-file ./plan.json` = convert hosted `snipara_plan` output into managed workflow JSON
 - `snipara-companion plan --start-workflow` or `workflow run --mode full --start-workflow-from-plan` = create local `.snipara/workflow/current.json` from a valid generated plan
@@ -1193,13 +1195,15 @@ Semantics:
 - `snipara-companion reindex` = trigger or poll hosted `snipara_reindex`; use after uploads when immediate chunk availability matters
 - `snipara-companion code *` = direct access to the code graph tools without routing through `snipara_context_query`
 - `snipara-companion recall` = direct durable memory lookup for decisions, learnings, preferences, and carryover
-- `snipara-companion session-bootstrap` = durable memory first, optional weak session carryover second
+- `snipara-companion session-bootstrap` = pushed compact brief of durable memory first, optional weak session carryover second; empty brief is silent in text mode
 - `snipara-companion task-commit` = durable task/phase/workflow outcomes only, not a mechanical mirror of every Git commit
-- `snipara-companion memory-guard check` = forced memory/context recall before retries, commits, or finalization when a command failed or a publishable package surface is touched
+- `snipara-companion memory-guard check` = deterministic guard recall/context before retries, commits, or finalization when a command failed or a publishable package surface is touched
 - `snipara-companion memory-guard check --intent "<action>" --destructive --strict` = contradiction check before irreversible actions; blocks until the user explicitly confirms when memory/context disagrees or the action is destructive
 - `snipara-companion memory-guard remember --guard-tag pre-commit --text "..."` = create a project/team memory in a guard category such as `pre-commit`, `commit`, `failure`, `pre-final`, or `workflow-policy`
 - `--max-daily-tokens` is still accepted as a compatibility alias for `--max-context-tokens`
 
+Use Outcome Loop data to calibrate these defaults: for small tasks, compare whether entry recall/context actually preceded retained commits before promoting a nudge into a gate.
+
 ### Memory Guard Before Commit Or Destructive Actions
 
 Memory Guard is deterministic, not a user preference. It detects two global signals:

package/package.json

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