snipara-companion 3.6.8 → 3.6.10

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 Release notes for `snipara-companion`, newest first.
 
+## New In 3.6.10
+
+- Captures rationale-shaped messages from verified standalone commits through
+  Why Capture, carrying commit SHA and changed-file provenance while keeping
+  candidates pending human review.
+- Skips automatic commit capture during managed workflows so phase/final
+  rationale is not duplicated.
+
+## New In 3.6.9
+
+- Auto-accepts only `info` and `watch` Advisor recommendations in managed
+  workflows, with an auditable `policy_auto` source and stable reason codes;
+  `risk` and `block` recommendations still require explicit authority.
+- Adds an evidence-derived Judgment Resolution V1 beside the immutable original
+  card. Verification-only warnings can become `ready` after a completed outcome
+  and matching passed evidence, while failed evidence, collaboration blockers,
+  `resolve_blocker` actions, and explicit blocked decisions remain hard blocks.
+- Preserves superseded responses and refreshed cards in bounded local history,
+  and normalizes older Judgment V1 states without a migration or schema reset.
+- Makes action-to-evidence matching explicit for tests, type checks, lint,
+  builds, package review, deployment/guard review, impact inspection, and Team
+  Sync handoffs.
+
 ## New In 3.6.8
 
 - Redacts macOS workspace paths consistently when the same temporary directory

package/README.md

@@ -313,6 +313,7 @@ After the first impact check, keep the work resumable:
 
 ```bash
 npx -y snipara-companion workflow start --goal "ship auth hardening"
+npx -y snipara-companion workflow judgment
 npx -y snipara-companion workflow phase-start audit
 npx -y snipara-companion lead-plan --task "ship auth hardening" --changed-files src/auth/session.ts --proof "pnpm test auth" --acceptance "auth tests pass"
 npx -y snipara-companion lead-plan --from-plan ./project-health-lead-plan.json --reconcile --changed-files src/auth/session.ts
@@ -332,12 +333,21 @@ npx -y snipara-companion workflow producer-review --latest --outcome useful --re
 npx -y snipara-companion handoff --summary "auth impact mapped" --next "run auth tests"
 ```
 
+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
+card is never rewritten. Companion appends an effective resolution and can lift
+a verification-only `proof_required` state only after a completed outcome and
+matching passed evidence. Failed evidence, a blocked collaboration guard, a
+`resolve_blocker` action, or an explicit blocked response remains a hard stop.
+
 `snipara-companion` writes local state under `.snipara/` so a coding agent can
 resume with the current phase, recent handoffs, timeline, context packs, and
 verification hints.
 
 `workflow timeline` reads the append-only activity log at
-`.snipara/activity/timeline.jsonl`. `workflow session` derives
+`.snipara/activity/timeline.jsonl`, including privacy-safe PostToolUse outcomes
+and file evidence when the Companion hook is installed. `workflow session` derives
 `.snipara/activity/session.json` for fast local resume and Orchestrator dogfood;
 Session Snapshot V0 includes latest activity, risk reasons, touched files, a
 next action, and advisory Intent Detection V0. Intent Detection V0 reports the
@@ -489,8 +499,15 @@ Release notes live in [CHANGELOG.md](./CHANGELOG.md).
 When project auth is configured, `workflow phase-commit`, `final-commit`, and
 `team-sync handoff` also run reviewed Why Capture. The Companion first sends a
 read-only preview and confirms only when the server detects durable rationale.
-Confirmed candidates enter the pending review queue; capture failures remain
-visible but do not block the primary workflow command. No documentation prompt
-is shown. `final-commit` remains handoff-only: the report explains what was
-stored or proposed, but it does not approve pending candidates or write final
-summary text as durable memory.
+Low-risk, directly confirmed and sufficiently evidenced captures can be
+approved by the hosted memory policy; shared-scope, conflicting, weakly
+supported, imported, or canonical decision-draft candidates remain reviewed.
+Capture failures stay visible but do not block the primary workflow command. No
+documentation prompt is shown. `final-commit` remains handoff-only: the report
+explains what was stored or proposed, but it does not itself approve canonical
+decision drafts or write final summary text as durable memory.
+After a verified `git commit`, `git revert`, or `git cherry-pick` result, the
+PostToolUse hook runs the same preview-then-confirm flow when no managed
+workflow is active. It submits the commit message, commit SHA, and changed-file
+evidence as `sourceKind=commit`; ordinary messages produce no candidate, and
+any captured rationale remains pending human review.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { AdvisorInfluenceLifecycle, HostedContextControlSource, HostedContextControlPlan, HostedContextControlApplyReceipt, ProjectIntentDetectionResult, ProjectPolicyDecision, ProjectRealityCheckResult, ContextMutationPlan, ContextMutationApplyReceipt, ProjectContextValidationReport, ProjectDriftReport, AgentContextResolution, AgentContextValidationReport, AgentContextEvidenceReceipt, AgentContextEvidenceReport, ProjectIntelligenceEngineeringLeadPlanSummary, ProjectPolicyRule, DecisionRequest, AdvisorInfluenceLifecycleState, OutcomeIntelligenceCalibration, OutcomeIntelligenceReceipt, ControlledWorkerExecutionMode, WorkerTrustCategory, ControlledWorkerExecutionReceipt, UnifiedReceiptEnvelope, WorkerTrustCandidate, WorkerProfile, WorkerTrustEvent } from '@snipara/project-intelligence-contracts';
+import { AdvisorInfluenceLifecycle, HostedContextControlSource, HostedContextControlPlan, HostedContextControlApplyReceipt, ProjectIntentDetectionResult, ProjectPolicyDecision, ProjectRealityCheckResult, ContextMutationPlan, ContextMutationApplyReceipt, ProjectContextValidationReport, ProjectDriftReport, AgentContextResolution, AgentContextValidationReport, AgentContextEvidenceReceipt, AgentContextEvidenceReport, ProjectIntelligenceEngineeringLeadPlanSummary, ProjectPolicyRule, AdvisorInfluenceLifecycleState, DecisionRequest, OutcomeIntelligenceCalibration, OutcomeIntelligenceReceipt, OutcomeIntelligenceEvidence, ControlledWorkerExecutionMode, WorkerTrustCategory, ControlledWorkerExecutionReceipt, UnifiedReceiptEnvelope, WorkerTrustCandidate, WorkerProfile, WorkerTrustEvent } from '@snipara/project-intelligence-contracts';
 
 declare function resolveQueryFromToolInput(toolInput?: string, tool?: string): string | null;
 
@@ -23,199 +23,6 @@ declare function buildCommitResultMetadata(options: {
 };
 declare function extractFilesFromToolInput(toolInput?: string): string[];
 
-type ContextPackKind = "tool_output" | "log" | "diff" | "file" | "text" | "note";
-interface ContextPackRecord {
-    version: "snipara.context_pack.v1";
-    id: string;
-    createdAt: string;
-    updatedAt: string;
-    kind: ContextPackKind;
-    label: string | null;
-    source: string | null;
-    tags: string[];
-    repoRoot: string;
-    sha256: string;
-    bytes: number;
-    lineCount: number;
-    contentType: "text/plain";
-    contentEncoding: "utf8";
-    preview: string;
-    expiresAt: string | null;
-    sensitive: boolean;
-    warnings: Array<{
-        code: string;
-        message: string;
-    }>;
-    storage: {
-        baseRelativePath: string;
-        manifestRelativePath: string;
-        blobRelativePath: string;
-    };
-}
-interface PackContextOptions {
-    cwd?: string;
-    content: string;
-    label?: string;
-    source?: string;
-    kind?: string;
-    tags?: string[];
-    ttlDays?: number;
-    maxBytes?: number;
-    allowSensitive?: boolean;
-    now?: Date;
-}
-interface ContextPackPackCommandOptions {
-    cwd?: string;
-    text?: string;
-    file?: string;
-    input?: string;
-    label?: string;
-    source?: string;
-    kind?: string;
-    tags?: string[];
-    ttlDays?: number;
-    maxBytes?: number;
-    allowSensitive?: boolean;
-    json?: boolean;
-}
-interface ContextPackRetrieveCommandOptions {
-    cwd?: string;
-    output?: string;
-    metadataOnly?: boolean;
-    json?: boolean;
-}
-interface ContextPackStatsCommandOptions {
-    cwd?: string;
-    json?: boolean;
-}
-interface ContextPackCleanCommandOptions {
-    cwd?: string;
-    all?: boolean;
-    expired?: boolean;
-    olderThanDays?: number;
-    dryRun?: boolean;
-    json?: boolean;
-    now?: Date;
-}
-interface ContextPackStoragePaths {
-    repoRoot: string;
-    baseDir: string;
-    blobsDir: string;
-    manifestsDir: string;
-    latestPath: string;
-}
-interface PackContextResult {
-    record: ContextPackRecord;
-    created: boolean;
-    baseDir: string;
-    manifestPath: string;
-    blobPath: string;
-}
-interface RetrieveContextPackResult {
-    record: ContextPackRecord;
-    content: string;
-    baseDir: string;
-    manifestPath: string;
-    blobPath: string;
-}
-interface ContextPackStats {
-    version: "snipara.context_pack.stats.v1";
-    baseDir: string;
-    totalPacks: number;
-    totalBytes: number;
-    sensitivePacks: number;
-    expiredPacks: number;
-    kinds: Record<string, number>;
-    oldestCreatedAt: string | null;
-    newestCreatedAt: string | null;
-    latestId: string | null;
-}
-interface ContextPackCleanResult {
-    version: "snipara.context_pack.clean.v1";
-    baseDir: string;
-    dryRun: boolean;
-    selected: number;
-    deleted: number;
-    deletedIds: string[];
-}
-declare function getContextPackStoragePaths(cwd?: string): ContextPackStoragePaths;
-declare function packContext(options: PackContextOptions): PackContextResult;
-declare function resolveContextPackRecord(idOrRef: string, cwd?: string): {
-    paths: ContextPackStoragePaths;
-    record: ContextPackRecord;
-    manifestPath: string;
-};
-declare function retrieveContextPack(idOrRef: string, cwd?: string): RetrieveContextPackResult;
-declare function buildContextPackStats(options?: ContextPackStatsCommandOptions): ContextPackStats;
-declare function cleanContextPacks(options?: ContextPackCleanCommandOptions): ContextPackCleanResult;
-declare function contextPackPackCommand(options: ContextPackPackCommandOptions): Promise<void>;
-declare function contextPackRetrieveCommand(idOrRef: string, options?: ContextPackRetrieveCommandOptions): Promise<void>;
-declare function contextPackStatsCommand(options?: ContextPackStatsCommandOptions): Promise<void>;
-declare function contextPackCleanCommand(options?: ContextPackCleanCommandOptions): Promise<void>;
-
-type PrivacyLevel = "standard" | "sensitive" | "restricted";
-type CanonicalEventType = "session_start" | "session_end" | "compact" | "message_user" | "message_assistant" | "tool_call" | "tool_result" | "file_changed" | "error_observed";
-interface CanonicalEventOptions {
-    eventType: CanonicalEventType;
-    client?: string;
-    workspace?: string;
-    sessionId?: string;
-    agentId?: string;
-    privacyLevel?: PrivacyLevel;
-    payload?: Record<string, unknown>;
-    contextPackReceipts?: LocalContextPackReceiptPayload[];
-}
-type LocalContextPackReceiptOperation = "pack" | "retrieve" | "reference";
-interface LocalContextPackReceiptPayload {
-    version: "snipara.context_pack.receipt.v1";
-    receipt_id: string;
-    pack_id: string;
-    operation: LocalContextPackReceiptOperation;
-    content_uploaded: false;
-    policy_decision: "local_only" | "blocked" | "metadata_only";
-    privacy_level: PrivacyLevel;
-    kind: ContextPackRecord["kind"];
-    label?: string | null;
-    source?: string | null;
-    tags: string[];
-    bytes: number;
-    line_count: number;
-    baseline_tokens?: number;
-    packed_tokens?: number;
-    retrieved_tokens?: number;
-    saved_tokens?: number;
-    payload_digest?: string;
-    sensitive: boolean;
-    created_at: string;
-    expires_at?: string | null;
-    local_ref: {
-        base_relative_path: string;
-        manifest_relative_path: string;
-    };
-}
-declare function buildLocalContextPackReceipt(record: ContextPackRecord, options?: {
-    operation?: LocalContextPackReceiptOperation;
-    privacyLevel?: PrivacyLevel;
-    policyDecision?: LocalContextPackReceiptPayload["policy_decision"];
-}): LocalContextPackReceiptPayload;
-declare function buildLocalContextPackReceipts(options: {
-    ids: string[];
-    cwd?: string;
-    operation?: LocalContextPackReceiptOperation;
-    privacyLevel?: PrivacyLevel;
-}): LocalContextPackReceiptPayload[];
-declare function attachLocalContextPackReceipts(payload: Record<string, unknown>, receipts: LocalContextPackReceiptPayload[]): Record<string, unknown>;
-declare function buildCanonicalEvent(options: CanonicalEventOptions): {
-    type: CanonicalEventType;
-    client: string;
-    workspace: string;
-    session_id: string;
-    agent_id: string;
-    timestamp: string;
-    privacy_level: PrivacyLevel;
-    payload: Record<string, unknown>;
-};
-
 interface RLMConfig {
     apiKey?: string;
     projectId?: string;
@@ -478,7 +285,7 @@ interface SessionPersistResult {
     session_id: string;
     files_tracked: number;
 }
-type WhyCaptureSourceKind = "phase_commit" | "final_commit" | "handoff";
+type WhyCaptureSourceKind = "commit" | "phase_commit" | "final_commit" | "handoff";
 interface WhyCaptureInput {
     decision?: string;
     why?: string;
@@ -1565,6 +1372,242 @@ declare function listProjectsForApiKey(apiKey: string, apiUrl?: string, timeout?
  */
 declare function createClient(timeout?: number, options?: ConfigResolutionOptions): RLMClient;
 
+interface CompanionWhyCaptureCandidate {
+    text: string;
+    type?: string;
+    category?: string;
+    decision?: string;
+    rationale?: string;
+}
+interface CompanionWhyCaptureMemory {
+    memoryId?: string;
+    text: string;
+    type?: string;
+    category?: string;
+    reviewStatus?: string;
+}
+interface CompanionWhyCaptureIssue {
+    text: string;
+    reason?: string;
+}
+interface CompanionWhyCaptureReceipt {
+    status: "captured" | "no_candidates" | "skipped" | "error";
+    sourceKind: WhyCaptureSourceKind;
+    previewCandidateCount: number;
+    capturedCount: number;
+    previewCandidates: CompanionWhyCaptureCandidate[];
+    pendingMemories: CompanionWhyCaptureMemory[];
+    duplicates: CompanionWhyCaptureIssue[];
+    failed: CompanionWhyCaptureIssue[];
+    commitSha?: string;
+    error?: string;
+}
+interface StandaloneCommitEvidence {
+    commitSha: string;
+    summary: string;
+    files: string[];
+}
+declare function hasActiveManagedWorkflow(cwd: string): boolean;
+declare function readStandaloneCommitEvidence(cwd: string, commitSha: string, additionalFiles?: string[]): StandaloneCommitEvidence | undefined;
+declare function captureStandaloneCommitWhy(input: {
+    cwd: string;
+    commitSha: string;
+    files?: string[];
+}): Promise<CompanionWhyCaptureReceipt>;
+
+type ContextPackKind = "tool_output" | "log" | "diff" | "file" | "text" | "note";
+interface ContextPackRecord {
+    version: "snipara.context_pack.v1";
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    kind: ContextPackKind;
+    label: string | null;
+    source: string | null;
+    tags: string[];
+    repoRoot: string;
+    sha256: string;
+    bytes: number;
+    lineCount: number;
+    contentType: "text/plain";
+    contentEncoding: "utf8";
+    preview: string;
+    expiresAt: string | null;
+    sensitive: boolean;
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    storage: {
+        baseRelativePath: string;
+        manifestRelativePath: string;
+        blobRelativePath: string;
+    };
+}
+interface PackContextOptions {
+    cwd?: string;
+    content: string;
+    label?: string;
+    source?: string;
+    kind?: string;
+    tags?: string[];
+    ttlDays?: number;
+    maxBytes?: number;
+    allowSensitive?: boolean;
+    now?: Date;
+}
+interface ContextPackPackCommandOptions {
+    cwd?: string;
+    text?: string;
+    file?: string;
+    input?: string;
+    label?: string;
+    source?: string;
+    kind?: string;
+    tags?: string[];
+    ttlDays?: number;
+    maxBytes?: number;
+    allowSensitive?: boolean;
+    json?: boolean;
+}
+interface ContextPackRetrieveCommandOptions {
+    cwd?: string;
+    output?: string;
+    metadataOnly?: boolean;
+    json?: boolean;
+}
+interface ContextPackStatsCommandOptions {
+    cwd?: string;
+    json?: boolean;
+}
+interface ContextPackCleanCommandOptions {
+    cwd?: string;
+    all?: boolean;
+    expired?: boolean;
+    olderThanDays?: number;
+    dryRun?: boolean;
+    json?: boolean;
+    now?: Date;
+}
+interface ContextPackStoragePaths {
+    repoRoot: string;
+    baseDir: string;
+    blobsDir: string;
+    manifestsDir: string;
+    latestPath: string;
+}
+interface PackContextResult {
+    record: ContextPackRecord;
+    created: boolean;
+    baseDir: string;
+    manifestPath: string;
+    blobPath: string;
+}
+interface RetrieveContextPackResult {
+    record: ContextPackRecord;
+    content: string;
+    baseDir: string;
+    manifestPath: string;
+    blobPath: string;
+}
+interface ContextPackStats {
+    version: "snipara.context_pack.stats.v1";
+    baseDir: string;
+    totalPacks: number;
+    totalBytes: number;
+    sensitivePacks: number;
+    expiredPacks: number;
+    kinds: Record<string, number>;
+    oldestCreatedAt: string | null;
+    newestCreatedAt: string | null;
+    latestId: string | null;
+}
+interface ContextPackCleanResult {
+    version: "snipara.context_pack.clean.v1";
+    baseDir: string;
+    dryRun: boolean;
+    selected: number;
+    deleted: number;
+    deletedIds: string[];
+}
+declare function getContextPackStoragePaths(cwd?: string): ContextPackStoragePaths;
+declare function packContext(options: PackContextOptions): PackContextResult;
+declare function resolveContextPackRecord(idOrRef: string, cwd?: string): {
+    paths: ContextPackStoragePaths;
+    record: ContextPackRecord;
+    manifestPath: string;
+};
+declare function retrieveContextPack(idOrRef: string, cwd?: string): RetrieveContextPackResult;
+declare function buildContextPackStats(options?: ContextPackStatsCommandOptions): ContextPackStats;
+declare function cleanContextPacks(options?: ContextPackCleanCommandOptions): ContextPackCleanResult;
+declare function contextPackPackCommand(options: ContextPackPackCommandOptions): Promise<void>;
+declare function contextPackRetrieveCommand(idOrRef: string, options?: ContextPackRetrieveCommandOptions): Promise<void>;
+declare function contextPackStatsCommand(options?: ContextPackStatsCommandOptions): Promise<void>;
+declare function contextPackCleanCommand(options?: ContextPackCleanCommandOptions): Promise<void>;
+
+type PrivacyLevel = "standard" | "sensitive" | "restricted";
+type CanonicalEventType = "session_start" | "session_end" | "compact" | "message_user" | "message_assistant" | "tool_call" | "tool_result" | "file_changed" | "error_observed";
+interface CanonicalEventOptions {
+    eventType: CanonicalEventType;
+    client?: string;
+    workspace?: string;
+    sessionId?: string;
+    agentId?: string;
+    privacyLevel?: PrivacyLevel;
+    payload?: Record<string, unknown>;
+    contextPackReceipts?: LocalContextPackReceiptPayload[];
+}
+type LocalContextPackReceiptOperation = "pack" | "retrieve" | "reference";
+interface LocalContextPackReceiptPayload {
+    version: "snipara.context_pack.receipt.v1";
+    receipt_id: string;
+    pack_id: string;
+    operation: LocalContextPackReceiptOperation;
+    content_uploaded: false;
+    policy_decision: "local_only" | "blocked" | "metadata_only";
+    privacy_level: PrivacyLevel;
+    kind: ContextPackRecord["kind"];
+    label?: string | null;
+    source?: string | null;
+    tags: string[];
+    bytes: number;
+    line_count: number;
+    baseline_tokens?: number;
+    packed_tokens?: number;
+    retrieved_tokens?: number;
+    saved_tokens?: number;
+    payload_digest?: string;
+    sensitive: boolean;
+    created_at: string;
+    expires_at?: string | null;
+    local_ref: {
+        base_relative_path: string;
+        manifest_relative_path: string;
+    };
+}
+declare function buildLocalContextPackReceipt(record: ContextPackRecord, options?: {
+    operation?: LocalContextPackReceiptOperation;
+    privacyLevel?: PrivacyLevel;
+    policyDecision?: LocalContextPackReceiptPayload["policy_decision"];
+}): LocalContextPackReceiptPayload;
+declare function buildLocalContextPackReceipts(options: {
+    ids: string[];
+    cwd?: string;
+    operation?: LocalContextPackReceiptOperation;
+    privacyLevel?: PrivacyLevel;
+}): LocalContextPackReceiptPayload[];
+declare function attachLocalContextPackReceipts(payload: Record<string, unknown>, receipts: LocalContextPackReceiptPayload[]): Record<string, unknown>;
+declare function buildCanonicalEvent(options: CanonicalEventOptions): {
+    type: CanonicalEventType;
+    client: string;
+    workspace: string;
+    session_id: string;
+    agent_id: string;
+    timestamp: string;
+    privacy_level: PrivacyLevel;
+    payload: Record<string, unknown>;
+};
+
 type ToolResultClassification = "success" | "failure" | "empty_result" | "timeout";
 interface ToolResultPayloadOptions {
     tool?: string;
@@ -1699,7 +1742,7 @@ declare function runMemoryGuardCheck(options?: MemoryGuardCheckOptions): Promise
 
 declare const ACTIVITY_TIMELINE_VERSION: "snipara.activity_timeline.v0";
 declare const SESSION_SNAPSHOT_VERSION: "snipara.session_snapshot.v0";
-type ActivityEventSource = "workflow" | "team-sync" | "decision" | "producer-loop" | "journal" | "orchestrator";
+type ActivityEventSource = "workflow" | "tool" | "team-sync" | "decision" | "producer-loop" | "journal" | "orchestrator";
 interface ActivityTimelineEvent {
     schemaVersion: typeof ACTIVITY_TIMELINE_VERSION;
     eventId: string;
@@ -3921,37 +3964,6 @@ declare function getTeamSyncStatePath(rootDir?: string): string;
 declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
 declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
 
-interface CompanionWhyCaptureCandidate {
-    text: string;
-    type?: string;
-    category?: string;
-    decision?: string;
-    rationale?: string;
-}
-interface CompanionWhyCaptureMemory {
-    memoryId?: string;
-    text: string;
-    type?: string;
-    category?: string;
-    reviewStatus?: string;
-}
-interface CompanionWhyCaptureIssue {
-    text: string;
-    reason?: string;
-}
-interface CompanionWhyCaptureReceipt {
-    status: "captured" | "no_candidates" | "skipped" | "error";
-    sourceKind: WhyCaptureSourceKind;
-    previewCandidateCount: number;
-    capturedCount: number;
-    previewCandidates: CompanionWhyCaptureCandidate[];
-    pendingMemories: CompanionWhyCaptureMemory[];
-    duplicates: CompanionWhyCaptureIssue[];
-    failed: CompanionWhyCaptureIssue[];
-    commitSha?: string;
-    error?: string;
-}
-
 declare const FINAL_COMMIT_REPORT_VERSION: "snipara.final_commit_report.v1";
 declare const FINAL_COMMIT_REPORT_RELATIVE_PATH: string;
 type FinalCommitOutcome = "completed" | "partial" | "blocked" | "abandoned";
@@ -4316,12 +4328,39 @@ interface ManagedWorkflowJudgmentResponse {
     recommendationId: string;
     decision: AdvisorInfluenceAgentDecision;
     respondedAt: string;
+    source: "explicit" | "policy_auto";
+    policyVersion?: "snipara.workflow.judgment-autonomy.v1";
+    reasonCodes: string[];
     planBefore?: string;
     planAfter?: string;
     initialReceipt?: ProjectRunAdvisorReceiptCapture;
     closeoutReceipt?: ProjectRunAdvisorReceiptCapture;
     outcomeReceipts?: OutcomeIntelligenceReceipt[];
 }
+interface ManagedWorkflowJudgmentResolution {
+    version: "snipara.workflow.judgment-resolution.v1";
+    evaluatedAt: string;
+    state: ProjectJudgmentState;
+    canProceed: ProjectJudgmentCanProceed;
+    originalCard: {
+        generatedAt: string;
+        state: ProjectJudgmentState;
+        canProceed: ProjectJudgmentCanProceed;
+        score: number;
+    };
+    reasonCodes: string[];
+    hardBlockerCodes: string[];
+    pendingExplicitRecommendationIds: string[];
+    autoResponseCount: number;
+    evidence: {
+        passedCount: number;
+        failedCount: number;
+        skippedCount: number;
+        requiredActionCount: number;
+        satisfiedRequiredActionCount: number;
+        unsatisfiedRequiredActions: string[];
+    };
+}
 interface ManagedWorkflowJudgmentState {
     version: "snipara.workflow.judgment.v1";
     generatedAt: string;
@@ -4329,6 +4368,8 @@ interface ManagedWorkflowJudgmentState {
     brief: ManagedWorkflowJudgmentBrief;
     card: ProjectIntelligenceJudgmentCard;
     responses: ManagedWorkflowJudgmentResponse[];
+    responseHistory?: ManagedWorkflowJudgmentResponse[];
+    resolution?: ManagedWorkflowJudgmentResolution;
 }
 interface ManagedWorkflowState {
     schemaVersion: ManagedWorkflowSchemaVersion;
@@ -4344,6 +4385,7 @@ interface ManagedWorkflowState {
     runtime?: ManagedWorkflowRuntimeState;
     coordination?: ManagedWorkflowCoordinationState;
     judgment?: ManagedWorkflowJudgmentState;
+    judgmentHistory?: ManagedWorkflowJudgmentState[];
     phaseCommitReceipts?: WorkflowPhaseCommitReceipt[];
     finalReport?: FinalCommitReportArtifact;
     lastCommit?: {
@@ -4743,6 +4785,12 @@ declare function buildSyncDocumentsDryRun(documents: SyncDocumentInput[], option
     reindexMode?: ReindexMode;
     now?: Date;
 }): SyncDocumentsDryRunSummary;
+declare function applyManagedWorkflowPolicyAutoResponses(judgment: ManagedWorkflowJudgmentState, respondedAt?: string): ManagedWorkflowJudgmentResponse[];
+declare function deriveManagedWorkflowJudgmentResolution(judgment: ManagedWorkflowJudgmentState, options?: {
+    evidence?: OutcomeIntelligenceEvidence[];
+    outcome?: TaskCommitOutcome;
+    evaluatedAt?: string;
+}): ManagedWorkflowJudgmentResolution;
 declare function buildAgenticWorkStatus(cwd?: string): AgenticWorkStatus;
 declare function buildAgenticTimeline(options?: {
     limit?: number;
@@ -5232,4 +5280,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, 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, FINAL_COMMIT_REPORT_RELATIVE_PATH, FINAL_COMMIT_REPORT_VERSION, MEMORY_GUARD_CONTEXT_TIMEOUT_MS, MEMORY_GUARD_RECALL_TIMEOUT_MS, 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, agentContextEvidenceRecordCommand, agentContextEvidenceStatusCommand, agentContextEvidenceTemplateCommand, agentContextResolveCommand, agentContextValidateCommand, agentReadinessAuditCommand, appendActivityEvent, applyLocalContextMutationPlan, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCommitResultMetadata, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildFinalCommitReport, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalAgentContextValidationReport, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextMutationPlan, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectContextValidationReport, buildLocalProjectDriftReport, buildLocalProjectRealityCheck, buildLocalProjectRealityCheckWithAutoContext, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildPolicyLedgerSyncReport, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkerTrustCandidates, buildWorkflowImpactGate, buildWorkflowPhaseCommitReceipt, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, 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, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentContextResolution, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatFinalCommitReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, hashWorkerProfile, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, mergeHybridCodeResults, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readAgentContextEvidenceLedger, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, readWorkerTrustEvent, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveCodeGraphMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, 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, 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, FINAL_COMMIT_REPORT_RELATIVE_PATH, FINAL_COMMIT_REPORT_VERSION, MEMORY_GUARD_CONTEXT_TIMEOUT_MS, MEMORY_GUARD_RECALL_TIMEOUT_MS, 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, 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, buildEvalCaseArtifact, buildFinalCommitReport, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalAgentContextValidationReport, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextMutationPlan, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectContextValidationReport, buildLocalProjectDriftReport, buildLocalProjectRealityCheck, buildLocalProjectRealityCheckWithAutoContext, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildPolicyLedgerSyncReport, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, 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, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, 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, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readAgentContextEvidenceLedger, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, readStandaloneCommitEvidence, readWorkerTrustEvent, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveCodeGraphMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, 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 };