snipara-companion 3.6.22 → 3.6.24

package/CHANGELOG.md

@@ -4,6 +4,23 @@ Release notes for `snipara-companion`, newest first.
 
 ## Unreleased
 
+## New In 3.6.24 - 2026-09-21
+
+- Makes `workflow run` use AUTO mode by default and adds French intent signals
+  for LITE, STANDARD, FULL, and ORCHESTRATED routing.
+- Reports an automatic setup card showing when Companion, hosted memory,
+  Orchestrator, and policy-gated workers are selected.
+- Keeps standalone `snipara-memory` opt-in and worker execution policy-gated.
+
+## New In 3.6.23 - 2026-09-14
+
+- Adds opt-in strict closeout for `workflow task-commit` and
+  `workflow phase-commit`, requiring passed verification evidence before a
+  task commit and requiring all declared phase tasks to be completed or
+  skipped before hosted workflow writes.
+- Keeps the default workflow behavior backward-compatible while making strict
+  mode suitable for release, security, and multi-agent dogfooding.
+
 ## New In 3.6.22 - 2026-09-12
 
 - Saves explicit session summaries and file checkpoints to the hosted journal,

package/README.md

@@ -131,13 +131,13 @@ These commands are useful without hosted Snipara:
 
 Use the exact CLI value after `workflow run --mode`:
 
-| CLI value     | Guide label         | Meaning                                                               |
-| ------------- | ------------------- | --------------------------------------------------------------------- |
-| `lite`        | LITE                | Small, known-scope work with no mandatory hosted context call         |
-| `standard`    | STANDARD            | Normal work with context and code-graph follow-up when needed         |
-| `auto`        | AUTO                | Routes by task intent to `lite`, `standard`, `full`, or `orchestrate` |
-| `full`        | FULL                | Managed, phased work with durable context and plan support            |
-| `orchestrate` | FULL + ORCHESTRATED | Explicit deeper orchestration for multi-agent or proof-gate work      |
+| CLI value     | Guide label         | Meaning                                                                             |
+| ------------- | ------------------- | ----------------------------------------------------------------------------------- |
+| `lite`        | LITE                | Small, known-scope work with no mandatory hosted context call                       |
+| `standard`    | STANDARD            | Normal work with context and code-graph follow-up when needed                       |
+| `auto`        | AUTO                | Default mode; routes by task intent to `lite`, `standard`, `full`, or `orchestrate` |
+| `full`        | FULL                | Managed, phased work with durable context and plan support                          |
+| `orchestrate` | FULL + ORCHESTRATED | Explicit deeper orchestration for multi-agent or proof-gate work                    |
 
 The root `run` command is the Project Intelligence judgment/release flow.
 `workflow run` is the workflow-mode runner. They share a verb but are not
@@ -484,6 +484,13 @@ npx -y snipara-companion workflow producer-review --latest --outcome useful --re
 npx -y snipara-companion handoff --summary "auth impact mapped" --next "run auth tests"
 ```
 
+For a stricter engineering workflow, add `--strict` to a completed
+`workflow task-commit` or `workflow phase-commit`. Strict phase closeout requires
+all declared tasks to be completed or skipped and requires every supplied
+verification item to be passed. The default remains backward-compatible for
+older workflows; strict mode is recommended for release, security, and
+multi-agent work.
+
 Managed workflow judgments use risk-based authority. `info` and `watch`
 recommendations are accepted locally by policy and remain auditable; `risk` and
 `block` recommendations still need `workflow judgment-respond`. The immutable
@@ -503,8 +510,11 @@ and file evidence when the Companion hook is installed. `workflow session` deriv
 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. `workflow run --mode auto` uses that same Control Plane
-principle to choose lite, standard, full, or orchestrate. Lite runs with zero
+suggested workflow mode. `workflow run` uses AUTO by default and that same
+Control Plane principle to choose lite, standard, full, or orchestrate. It
+reports an automatic setup card for Companion, hosted memory, Orchestrator,
+and policy-gated workers. Standalone `snipara-memory` remains an explicit
+application choice. 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

package/dist/index.d.ts

@@ -4176,6 +4176,20 @@ declare function formatFinalCommitReport(report: FinalCommitReportV1): string;
 
 type SyncDocumentKind = "DOC" | "BINARY";
 type WorkflowMode = "lite" | "standard" | "auto" | "full" | "orchestrate";
+type AutomaticMemorySetup = "none" | "hosted";
+type AutomaticOrchestratorSetup = "none" | "available" | "required";
+type AutomaticWorkerSetup = "none" | "policy_gated";
+interface AutomaticSetupSelection {
+    requestedMode: WorkflowMode;
+    effectiveMode: Exclude<WorkflowMode, "auto">;
+    companion: "active";
+    memory: AutomaticMemorySetup;
+    orchestrator: AutomaticOrchestratorSetup;
+    workers: AutomaticWorkerSetup;
+    standaloneMemory: "not_selected";
+    tokenStrategy: "minimal" | "budgeted";
+    reasons: string[];
+}
 type OnboardFolderMode = "auto" | "business_context" | "code_project" | "mixed";
 type DetectedOnboardFolderMode = "business_context" | "code_project" | "mixed" | "unknown";
 type ManagedWorkflowStatus = "active" | "completed" | "blocked";
@@ -4915,6 +4929,15 @@ declare function buildWorkflowPhaseCommitSummary(args: {
     summary: string;
 }): string;
 declare function resolveAutoWorkflowMode(query: string): Exclude<WorkflowMode, "auto">;
+/**
+ * Describe the smallest effective Snipara setup selected for a task.
+ * This is deliberately a decision card: it never enables standalone memory
+ * or executes a worker by itself. Worker execution remains policy-gated and
+ * requires an explicit orchestrator path or project policy.
+ */
+declare function resolveAutomaticSetup(query: string, requestedMode: WorkflowMode, options?: {
+    hostedConfigured?: boolean;
+}): AutomaticSetupSelection;
 /**
  * Compute the impact gate for committed-but-unpushed workflow phases.
  *
@@ -5587,4 +5610,4 @@ declare function installAutomationBundle(args: {
 }): Promise<AutomationInstallResult>;
 declare function getAutomationStatus(projectDir?: string): AutomationStatusResult;
 
-export { AGENT_CONTEXT_EVIDENCE_DEFAULT_LEDGER, AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, DEFAULT_DOCS_BOOTSTRAP_OUTPUT, DOCS_BOOTSTRAP_VERSION, 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, FEATURE_DEFAULT_OUTPUT_DIR, FEATURE_WORK_ITEM_VERSION, FINAL_COMMIT_REPORT_RELATIVE_PATH, FINAL_COMMIT_REPORT_VERSION, type GeneratedWorkflowTaskDocument, MEMORY_GUARD_CONTEXT_TIMEOUT_MS, MEMORY_GUARD_RECALL_TIMEOUT_MS, type ManagedWorkflowTask, type ManagedWorkflowTaskContextEnvelope, type ManagedWorkflowTaskStatus, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, POLICY_LEDGER_SYNC_REPORT_VERSION, 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, agentContextEvidenceCollectCommand, agentContextEvidenceRecordCommand, agentContextEvidenceStatusCommand, agentContextEvidenceTemplateCommand, agentContextResolveCommand, agentContextValidateCommand, agentReadinessAuditCommand, appendActivityEvent, applyLocalContextMutationPlan, applyManagedWorkflowPolicyAutoResponses, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCommitResultMetadata, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildDocsBootstrapResult, buildEvalCaseArtifact, buildFeaturePlanMarkdown, buildFeatureSpecMarkdown, buildFeatureTasksMarkdown, buildFinalCommitReport, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildInstalledDependencyEvidence, buildJournalCheckpointEntry, buildLocalAgentContextValidationReport, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextMutationPlan, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectContextValidationReport, buildLocalProjectDriftReport, buildLocalProjectRealityCheck, buildLocalProjectRealityCheckWithAutoContext, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildPolicyLedgerSyncReport, buildProducerLoopReport, buildProjectBriefMarkdown, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, buildSmallestSafeDiffEvidence, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkerTrustCandidates, buildWorkflowImpactGate, buildWorkflowPhaseCommitReceipt, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, captureStandaloneCommitWhy, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectPolicyLedgerSyncArtifacts, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextControlApplyCommand, contextControlDriftCommand, contextControlHostedApplyCommand, contextControlHostedDiffCommand, contextControlPlanCommand, contextControlValidateCommand, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, controlledWorkerExecuteCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, deriveManagedWorkflowJudgmentResolution, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, docsBootstrapCommand, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, featureInitCommand, featurePlanCommand, featureSpecifyCommand, featureStartCommand, featureStatusCommand, featureTasksCommand, formatAgentContextResolution, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatFinalCommitReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, hasActiveManagedWorkflow, hashWorkerProfile, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, mergeHybridCodeResults, normalizeCollaborationFiles, normalizeFeatureSlug, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readAgentContextEvidenceLedger, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, readStandaloneCommitEvidence, readWorkerTrustEvent, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveCodeGraphMode, resolveContextPackRecord, resolveFeatureArtifactPaths, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveMinimumChangeMode, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldFailCollaborationGuard, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workerTrustCandidateCommand, workerTrustReviewCommand, workerTrustStatusCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, workflowSyncPolicyLedgerCommand, writeFinalCommitReport, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };
+export { AGENT_CONTEXT_EVIDENCE_DEFAULT_LEDGER, AUTOMATION_MANIFEST_RELATIVE_PATH, type AutomaticMemorySetup, type AutomaticOrchestratorSetup, type AutomaticSetupSelection, type AutomaticWorkerSetup, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, DEFAULT_DOCS_BOOTSTRAP_OUTPUT, DOCS_BOOTSTRAP_VERSION, 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, FEATURE_DEFAULT_OUTPUT_DIR, FEATURE_WORK_ITEM_VERSION, FINAL_COMMIT_REPORT_RELATIVE_PATH, FINAL_COMMIT_REPORT_VERSION, type GeneratedWorkflowTaskDocument, MEMORY_GUARD_CONTEXT_TIMEOUT_MS, MEMORY_GUARD_RECALL_TIMEOUT_MS, type ManagedWorkflowTask, type ManagedWorkflowTaskContextEnvelope, type ManagedWorkflowTaskStatus, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, POLICY_LEDGER_SYNC_REPORT_VERSION, 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, agentContextEvidenceCollectCommand, agentContextEvidenceRecordCommand, agentContextEvidenceStatusCommand, agentContextEvidenceTemplateCommand, agentContextResolveCommand, agentContextValidateCommand, agentReadinessAuditCommand, appendActivityEvent, applyLocalContextMutationPlan, applyManagedWorkflowPolicyAutoResponses, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCommitResultMetadata, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildDocsBootstrapResult, buildEvalCaseArtifact, buildFeaturePlanMarkdown, buildFeatureSpecMarkdown, buildFeatureTasksMarkdown, buildFinalCommitReport, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildInstalledDependencyEvidence, buildJournalCheckpointEntry, buildLocalAgentContextValidationReport, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextMutationPlan, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectContextValidationReport, buildLocalProjectDriftReport, buildLocalProjectRealityCheck, buildLocalProjectRealityCheckWithAutoContext, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildPolicyLedgerSyncReport, buildProducerLoopReport, buildProjectBriefMarkdown, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, buildSmallestSafeDiffEvidence, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkerTrustCandidates, buildWorkflowImpactGate, buildWorkflowPhaseCommitReceipt, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, captureStandaloneCommitWhy, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectPolicyLedgerSyncArtifacts, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextControlApplyCommand, contextControlDriftCommand, contextControlHostedApplyCommand, contextControlHostedDiffCommand, contextControlPlanCommand, contextControlValidateCommand, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, controlledWorkerExecuteCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, deriveManagedWorkflowJudgmentResolution, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, docsBootstrapCommand, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, featureInitCommand, featurePlanCommand, featureSpecifyCommand, featureStartCommand, featureStatusCommand, featureTasksCommand, formatAgentContextResolution, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatFinalCommitReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, hasActiveManagedWorkflow, hashWorkerProfile, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, mergeHybridCodeResults, normalizeCollaborationFiles, normalizeFeatureSlug, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readAgentContextEvidenceLedger, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, readStandaloneCommitEvidence, readWorkerTrustEvent, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveAutomaticSetup, resolveCodeGraphMode, resolveContextPackRecord, resolveFeatureArtifactPaths, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveMinimumChangeMode, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldFailCollaborationGuard, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workerTrustCandidateCommand, workerTrustReviewCommand, workerTrustStatusCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, workflowSyncPolicyLedgerCommand, writeFinalCommitReport, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };

package/dist/index.js

@@ -255,6 +255,7 @@ __export(index_exports, {
   referencesIngestCommand: () => referencesIngestCommand,
   referencesScanCommand: () => referencesScanCommand,
   resolveAutoWorkflowMode: () => resolveAutoWorkflowMode,
+  resolveAutomaticSetup: () => resolveAutomaticSetup,
   resolveCodeGraphMode: () => resolveCodeGraphMode,
   resolveContextPackRecord: () => resolveContextPackRecord,
   resolveFeatureArtifactPaths: () => resolveFeatureArtifactPaths,
@@ -31527,35 +31528,59 @@ function phaseQuery(state, phase) {
 }
 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(
+  if (/\b(orchestrate|orchestrat|swarm|essaim|htask|h[- ]?tache|handoff|passation|multi-agent|multi agent|multi-agent|sous-agent|sous agent|worker|travailleur|parall[eè]le|coordonn(?:er|ation)|proof gate|proof-gate|preuve|garde-fou|gate|drift check|d[eé]rive|release gate|production gate|mise en production|contr[oô]le de production)\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(
+  if (/\b(deploy|deployment|d[eé]ployer|d[eé]ploiement|release|livraison|mise en production|merge|fusionner|push|pousser|migration|sch[eé]ma|auth|authentification|billing|facturation|security|s[eé]curit[eé]|architecture|architectural|multi-phase|multiphase|phase commit|commit de phase|final commit|commit final|managed workflow|workflow g[eé]r[eé]|roadmap|feuille de route|plan|chantier)\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(
+  if (/\b(why|pourquoi|decision|d[eé]cision|rationale|positioning|positionnement|strategy|strat[eé]gie|contexte|pr[eé]f[eé]rence|cross-session|multi-session|previous decision|prior decision|historical context|contexte historique)\b/.test(
     normalized
   )) {
     return "standard";
   }
-  if (/\b(status|show|list|read|lookup|recall|brief|summarize|summary|what changed|question|docs?|documentation)\b/.test(
+  if (/\b(status|statut|show|montre|montrer|afficher|list|liste|lister|read|lire|lookup|chercher|retrouver|recall|rappel|brief|r[eé]sum[eé]|summarize|summary|what changed|ce qui a chang[eé]|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(
+  if (/\b(typo|faute|correction de texte|copy edit|petite correction|petit diff|small diff|tiny diff|one-line|one line|une ligne|fichier connu|known file|obvious fix|quick fix|correction rapide|format|formatting|formatage|rename|renommer)\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(
+  ) && !/\b(architecture|release|deploy|d[eé]ploiement|migration|schema|sch[eé]ma|auth|billing|security|s[eé]curit[eé]|multi-file|multi-fichier|many files|plusieurs fichiers|5\+ files|cross-session|multi-session|decision|d[eé]cision)\b/.test(
     normalized
   )) {
     return "lite";
   }
   return "standard";
 }
+function resolveAutomaticSetup(query, requestedMode, options = {}) {
+  const effectiveMode = effectiveWorkflowMode(requestedMode, query);
+  const hostedMemory = options.hostedConfigured !== false && effectiveMode !== "lite";
+  const orchestratorRequired = effectiveMode === "orchestrate";
+  const hasOrchestratorSignal = getOrchestratorRecommendation(query, effectiveMode) !== null;
+  return {
+    requestedMode,
+    effectiveMode,
+    companion: "active",
+    memory: hostedMemory ? "hosted" : "none",
+    orchestrator: orchestratorRequired ? "required" : hasOrchestratorSignal ? "available" : "none",
+    workers: orchestratorRequired && /\b(worker|travailleur|sous-agent(?:s)?|sous agent(?:s)?|parall[eè]le(?:s)?|swarm|essaim)\b/i.test(
+      query
+    ) ? "policy_gated" : "none",
+    standaloneMemory: "not_selected",
+    tokenStrategy: effectiveMode === "full" || effectiveMode === "orchestrate" ? "budgeted" : "minimal",
+    reasons: [
+      `task intent selected ${effectiveMode.toUpperCase()}`,
+      hostedMemory ? "hosted memory is used for this workflow depth" : "no mandatory memory call for this workflow depth",
+      orchestratorRequired ? "orchestrator capabilities are required for proof, coordination, or production gates" : hasOrchestratorSignal ? "orchestrator remains available if the task escalates" : "orchestration is not needed for the detected task scope",
+      "standalone snipara-memory is reserved for applications that explicitly choose the autonomous memory package"
+    ]
+  };
+}
 function effectiveWorkflowMode(mode, query = "") {
   return mode === "auto" ? resolveAutoWorkflowMode(query) : mode;
 }
@@ -32809,6 +32834,26 @@ function printLiteWorkflowRun(query, requestedMode) {
   );
   console.log("");
 }
+function printAutomaticSetup(selection) {
+  console.log(import_chalk9.default.bold("Automatic Snipara setup"));
+  printKeyValue2("Companion:", "active router");
+  printKeyValue2("Workflow:", `${selection.effectiveMode} (${selection.requestedMode} requested)`);
+  printKeyValue2(
+    "Memory:",
+    selection.memory === "hosted" ? "hosted Snipara memory" : "none required"
+  );
+  printKeyValue2(
+    "Orchestrator:",
+    selection.orchestrator === "required" ? "required" : selection.orchestrator === "available" ? "available on escalation" : "not selected"
+  );
+  printKeyValue2(
+    "Workers:",
+    selection.workers === "policy_gated" ? "policy-gated recommendation" : "not selected"
+  );
+  printKeyValue2("Standalone memory:", "not selected automatically");
+  printKeyValue2("Token strategy:", selection.tokenStrategy);
+  console.log("");
+}
 function runtimeHintVersionLabel(report) {
   if (!report.runtime.cliVersion) {
     return report.runtime.version ? ` (${report.runtime.version})` : "";
@@ -34951,6 +34996,9 @@ async function sharedContextCommand(options) {
 async function workflowRunCommand(options) {
   const hostedConfigured = isConfigured();
   const effectiveMode = effectiveWorkflowMode(options.mode, options.query);
+  const automaticSetup = resolveAutomaticSetup(options.query, options.mode, {
+    hostedConfigured
+  });
   const localAdaptiveRoutingPolicy = readLocalAdaptiveRoutingProjectPolicy();
   const localAdaptiveRoutingRequested = shouldBuildAdaptiveRouting(options);
   const canRunLocalAdaptiveRouting = !hostedConfigured && effectiveMode !== "orchestrate" && (localAdaptiveRoutingRequested || localAdaptiveRoutingPolicy !== null && localAdaptiveRoutingPolicy.mode !== "off");
@@ -34985,7 +35033,7 @@ async function workflowRunCommand(options) {
     policySource: options.orchestratorPolicySource,
     adaptiveRoutingDryRun: Boolean(adaptiveRouting)
   });
-  const shouldEmitOrchestratorHandoff = options.emitOrchestratorHandoff || options.autoRouteOrchestrator;
+  const shouldEmitOrchestratorHandoff = options.emitOrchestratorHandoff || options.autoRouteOrchestrator || options.mode === "auto" && effectiveMode === "orchestrate";
   const preparedHandoff = shouldEmitOrchestratorHandoff && orchestratorRecommendation ? writeOrchestratorHandoff({
     sourceCommand: "workflow run",
     recommendation: orchestratorRecommendation,
@@ -34999,6 +35047,7 @@ async function workflowRunCommand(options) {
     const payload2 = {
       mode: options.mode,
       effective_mode: effectiveMode,
+      automatic_setup: automaticSetup,
       local_only: true,
       local_policy_path: localAdaptiveRoutingPolicy ? ADAPTIVE_ROUTING_POLICY_RELATIVE_PATH2 : null,
       retrieval_policy: effectiveMode === "lite" ? {
@@ -35021,6 +35070,7 @@ async function workflowRunCommand(options) {
     if (effectiveMode === "lite") {
       printLiteWorkflowRun(options.query, options.mode);
     } else {
+      printAutomaticSetup(automaticSetup);
       console.log(import_chalk9.default.bold("Local Adaptive Work Routing"));
       console.log(
         "Hosted Snipara is not configured; no context query, hosted catalog, or planner call ran."
@@ -35038,6 +35088,7 @@ async function workflowRunCommand(options) {
     const payload2 = {
       mode: options.mode,
       effective_mode: effectiveMode,
+      automatic_setup: automaticSetup,
       retrieval_policy: {
         mandatory_calls: [],
         escalation: "Run recall, context_query, or code impact only when the task needs them.",
@@ -35053,6 +35104,7 @@ async function workflowRunCommand(options) {
       return;
     }
     printLiteWorkflowRun(options.query, options.mode);
+    printAutomaticSetup(automaticSetup);
     if (options.runtimeHint !== false) {
       printRuntimeHint(options.query, effectiveMode);
     }
@@ -35072,6 +35124,7 @@ async function workflowRunCommand(options) {
     if (options.json) {
       printJson2({
         mode: options.mode,
+        automatic_setup: automaticSetup,
         orchestrate: result,
         orchestrator_recommendation: orchestratorRecommendation,
         orchestrator_handoff: preparedHandoff,
@@ -35081,6 +35134,7 @@ async function workflowRunCommand(options) {
       return;
     }
     printOrchestrateResult(result);
+    printAutomaticSetup(automaticSetup);
     if (options.runtimeHint !== false) {
       printRuntimeHint(options.query, effectiveMode);
       printOrchestratorHandoffHint(options.query, effectiveMode, orchestratorRecommendation);
@@ -35104,6 +35158,7 @@ async function workflowRunCommand(options) {
   const payload = {
     mode: options.mode,
     effective_mode: effectiveMode,
+    automatic_setup: automaticSetup,
     orchestrator_recommendation: orchestratorRecommendation,
     orchestrator_handoff: preparedHandoff,
     adaptive_routing: adaptiveRouting,
@@ -35183,6 +35238,7 @@ async function workflowRunCommand(options) {
     printJson2(payload);
     return;
   }
+  printAutomaticSetup(automaticSetup);
   if (effectiveMode === "full" && payload.session_bootstrap) {
     const printedBootstrap = printSessionBootstrap(
       payload.session_bootstrap,
@@ -35537,6 +35593,29 @@ function workflowOutcomeEvidence(values) {
     ];
   });
 }
+function assertStrictVerificationEvidence(values, subject) {
+  const evidence = workflowOutcomeEvidence(values);
+  if (evidence.length === 0) {
+    throw new Error(`${subject} requires at least one --evidence passed:<check> in strict mode.`);
+  }
+  const nonPassing = evidence.filter((item) => item.status !== "passed");
+  if (nonPassing.length > 0) {
+    throw new Error(
+      `${subject} has non-passing evidence in strict mode: ${nonPassing.map((item) => `${item.status}:${item.label}`).join(" | ")}`
+    );
+  }
+  return evidence;
+}
+function assertStrictPhaseTasksCompleted(phase) {
+  const incomplete = workflowTasks(phase).filter(
+    (task) => !["completed", "skipped"].includes(task.status)
+  );
+  if (incomplete.length > 0) {
+    throw new Error(
+      `Phase '${phase.id}' has incomplete tasks in strict mode: ${incomplete.map((task) => `${task.id} (${task.status})`).join(", ")}`
+    );
+  }
+}
 var MANAGED_WORKFLOW_JUDGMENT_AUTONOMY_VERSION = "snipara.workflow.judgment-autonomy.v1";
 function isPolicyAutoEligibleRecommendation(recommendation) {
   return recommendation.severity === "info" || recommendation.severity === "watch";
@@ -36887,6 +36966,9 @@ async function workflowTaskCommitCommand(options) {
   const outcome = options.outcome ?? "completed";
   const category = options.category ?? "workflow-task";
   const files = options.files && options.files.length > 0 ? options.files : task.files ?? phase.files;
+  if (options.strict && outcome === "completed") {
+    assertStrictVerificationEvidence(options.evidence, `Task '${task.id}'`);
+  }
   await memoryGuardCheckCommand({
     trigger: "commit",
     files,
@@ -37533,6 +37615,10 @@ async function workflowPhaseCommitCommand(options) {
   const outcome = options.outcome ?? "completed";
   const category = options.category ?? "workflow-phase";
   const files = options.files && options.files.length > 0 ? options.files : phase.files;
+  if (options.strict && outcome === "completed") {
+    assertStrictPhaseTasksCompleted(phase);
+    assertStrictVerificationEvidence(options.evidence, `Phase '${phase.id}'`);
+  }
   if (outcome === "completed" && workflowTasks(phase).some((task) => task.status === "blocked")) {
     throw new Error(
       `Phase '${phase.id}' still has blocked tasks. Retry or complete their recovery tasks before phase-commit.`
@@ -46464,7 +46550,7 @@ workflow.command("task-commit").description("Persist a task outcome and keep the
   "Task evidence as passed|failed|not-run|unknown:text; repeatable",
   collectOption,
   []
-).option("--json", "Print raw JSON").action(async (phaseId, taskId, options) => {
+).option("--strict", "Require passed evidence before completing this task").option("--json", "Print raw JSON").action(async (phaseId, taskId, options) => {
   await workflowTaskCommitCommand({
     phaseId,
     taskId,
@@ -46478,6 +46564,7 @@ workflow.command("task-commit").description("Persist a task outcome and keep the
     outcome: options.outcome,
     files: options.files,
     evidence: options.evidence,
+    strict: Boolean(options.strict),
     json: options.json
   });
 });
@@ -46524,7 +46611,7 @@ workflow.command("phase-commit").description(
   "Phase evidence as passed|failed|not-run|unknown:text; repeatable",
   collectOption,
   []
-).option("--json", "Print raw JSON").action(async (phaseId, options) => {
+).option("--strict", "Require all tasks complete and passed evidence before completing this phase").option("--json", "Print raw JSON").action(async (phaseId, options) => {
   await workflowPhaseCommitCommand({
     phaseId,
     summary: options.summary,
@@ -46537,6 +46624,7 @@ workflow.command("phase-commit").description(
     outcome: options.outcome,
     files: options.files,
     evidence: options.evidence,
+    strict: Boolean(options.strict),
     json: options.json
   });
 });
@@ -46562,7 +46650,11 @@ workflow.command("final-commit").description("Persist the final workflow outcome
     json: options.json
   });
 });
-workflow.command("run").description("Run a LITE/STANDARD/FULL/orchestrate workflow preset").requiredOption("-q, --query <query>", "Workflow query").option("-M, --mode <mode>", "lite|standard|auto|full|orchestrate", "standard").option(
+workflow.command("run").description("Run a LITE/STANDARD/FULL/orchestrate workflow preset").requiredOption("-q, --query <query>", "Workflow query").option(
+  "-M, --mode <mode>",
+  "lite|standard|auto|full|orchestrate (auto selects the smallest effective setup)",
+  "auto"
+).option(
   "-m, --max-tokens <number>",
   "Maximum tokens; FULL mode splits this across workflow surfaces",
   "8000"
@@ -47931,6 +48023,7 @@ if (require.main === module) {
   referencesIngestCommand,
   referencesScanCommand,
   resolveAutoWorkflowMode,
+  resolveAutomaticSetup,
   resolveCodeGraphMode,
   resolveContextPackRecord,
   resolveFeatureArtifactPaths,

package/docs/FULL_REFERENCE.md

@@ -1131,13 +1131,13 @@ where the specific command needs hosted context or memory:
 
 `workflow run --mode` accepts exactly these values:
 
-| CLI value     | Guide label         | Runtime behavior                                                      |
-| ------------- | ------------------- | --------------------------------------------------------------------- |
-| `lite`        | LITE                | Small, known-scope work with no mandatory hosted context call         |
-| `standard`    | STANDARD            | Normal work with context and code-graph follow-up when needed         |
-| `auto`        | AUTO                | Routes by task intent to `lite`, `standard`, `full`, or `orchestrate` |
-| `full`        | FULL                | Managed, phased work with durable context and plan support            |
-| `orchestrate` | FULL + ORCHESTRATED | Explicit deeper orchestration for multi-agent or proof-gate work      |
+| CLI value     | Guide label         | Runtime behavior                                                                    |
+| ------------- | ------------------- | ----------------------------------------------------------------------------------- |
+| `lite`        | LITE                | Small, known-scope work with no mandatory hosted context call                       |
+| `standard`    | STANDARD            | Normal work with context and code-graph follow-up when needed                       |
+| `auto`        | AUTO                | Default mode; routes by task intent to `lite`, `standard`, `full`, or `orchestrate` |
+| `full`        | FULL                | Managed, phased work with durable context and plan support                          |
+| `orchestrate` | FULL + ORCHESTRATED | Explicit deeper orchestration for multi-agent or proof-gate work                    |
 
 The root `run` command is the Project Intelligence judgment/release flow.
 `workflow run` is the workflow-mode runner; they are different commands.
@@ -1180,6 +1180,15 @@ snipara-companion workflow run --mode full --no-runtime-hint --query "implement
 snipara-companion workflow run --mode orchestrate --query "map production rollout risks"
 snipara-companion workflow final-commit --summary "Shipped auth hardening and tests" --why "Close the reported session replay gap" --evidence "passed:pnpm test auth" --risk "Monitor production auth errors" --next-step "Review the first 24 hours of telemetry" --files src/auth.ts tests/auth.test.ts
 snipara-companion workflow producer-report
+```
+
+Use `--strict` on a completed `workflow task-commit` or `workflow phase-commit`
+when the work needs a hard engineering closeout. Strict phase commit refuses
+pending or in-progress declared tasks and requires every supplied evidence item
+to be passed. Without the flag, legacy workflows retain their existing
+compatibility behavior.
+
+```
 snipara-companion workflow producer-review --artifact producer-abc123 --outcome useful --reviewer alice
 snipara-companion final-commit --summary "Shipped auth hardening and tests" --why "Close the reported session replay gap" --evidence "passed:pnpm test auth" --next-step "Review the first 24 hours of telemetry" --files src/auth.ts tests/auth.test.ts
 snipara-companion doctor
@@ -1663,7 +1672,7 @@ Semantics:
 - `snipara-companion query --follow-recommendation` = execute the hosted recommended structural tool instead of only printing it; context retrieval defaults to a 30-second timeout and supports `--search-mode keyword|semantic|hybrid`, `--no-answer-pack`, `--no-auto-decompose`, and `--no-shared-context`
 - `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` = routes to lite, standard, full, or orchestrate from task intent
+- `snipara-companion workflow run` = AUTO by default; routes to lite, standard, full, or orchestrate from task intent and reports the selected Companion/memory/orchestrator setup
 - `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

package/package.json

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