snipara-companion 3.5.5 → 3.5.6

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 Release notes for `snipara-companion`, newest first.
 
+## New In 3.5.6
+
+- Adds a managed workflow Judgment V1 loop: `workflow judgment` serves and
+  persists a bounded Project Intelligence card, while `workflow
+judgment-respond` records one explicit accepted, modified, ignored, or
+  blocked response per recommendation.
+- Uses the canonical hosted Project Intelligence Brief V2 endpoint to persist
+  the served judgment identity; the endpoint now accepts validated,
+  project-scoped API keys used by Companion.
+- Replays the same hosted Advisor Influence receipt at evidence-bearing phase
+  commits and final closeout, so one idempotent receipt advances from
+  acknowledgement/application to verified outcome evidence without duplicates.
+- Refuses managed final closeout when a served recommendation has no explicit
+  response; Companion never manufactures an implicit ignored decision.
+
 ## New In 3.5.5
 
 - Gives Memory Guard source-context retrieval its own bounded 30-second window

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, ProjectIntelligenceEngineeringLeadPlanSummary, ProjectPolicyRule, DecisionRequest, AdvisorInfluenceLifecycleState, OutcomeIntelligenceCalibration, ControlledWorkerExecutionMode, WorkerTrustCategory, ControlledWorkerExecutionReceipt, UnifiedReceiptEnvelope, WorkerTrustCandidate, WorkerProfile, WorkerTrustEvent } from '@snipara/project-intelligence-contracts';
+import { AdvisorInfluenceLifecycle, HostedContextControlSource, HostedContextControlPlan, HostedContextControlApplyReceipt, ProjectIntentDetectionResult, ProjectPolicyDecision, ProjectRealityCheckResult, ContextMutationPlan, ContextMutationApplyReceipt, ProjectContextValidationReport, ProjectDriftReport, ProjectIntelligenceEngineeringLeadPlanSummary, ProjectPolicyRule, DecisionRequest, AdvisorInfluenceLifecycleState, OutcomeIntelligenceCalibration, OutcomeIntelligenceReceipt, ControlledWorkerExecutionMode, WorkerTrustCategory, ControlledWorkerExecutionReceipt, UnifiedReceiptEnvelope, WorkerTrustCandidate, WorkerProfile, WorkerTrustEvent } from '@snipara/project-intelligence-contracts';
 
 declare function resolveQueryFromToolInput(toolInput?: string, tool?: string): string | null;
 
@@ -712,6 +712,29 @@ interface RecordAdvisorInfluenceReceiptResult {
     receipt: Record<string, unknown>;
     advisorInfluence: Record<string, unknown>;
 }
+interface ProjectIntelligenceBriefRequest {
+    task?: string;
+    diffSummary?: string;
+    changedFiles?: string[];
+    symbols?: string[];
+    routes?: string[];
+}
+interface HostedProjectIntelligenceBriefResult {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    servedJudgmentId: string | null;
+    persistedShadowSignalCount: number;
+    brief: {
+        version: string;
+        task?: string | null;
+        judgment?: {
+            advisorRecommendations?: unknown[];
+        };
+    };
+}
 interface AutomationConfigFile {
     path: string;
     content: string;
@@ -1351,6 +1374,7 @@ declare class RLMClient {
         payload?: Record<string, unknown>;
     }): Promise<EmitEventResult>;
     recordAdvisorInfluenceReceipt(input: RecordAdvisorInfluenceReceiptInput): Promise<RecordAdvisorInfluenceReceiptResult>;
+    createProjectIntelligenceBrief(input: ProjectIntelligenceBriefRequest): Promise<HostedProjectIntelligenceBriefResult>;
     captureWhy(input: WhyCaptureInput): Promise<WhyCaptureResult>;
     getAutomationEvents(args?: {
         sessionId?: string;
@@ -2686,6 +2710,10 @@ interface ProjectRunCommandOptions {
     advisorPlanBefore?: string;
     advisorPlanAfter?: string;
     advisorRecommendationId?: string;
+    advisorDecision?: AdvisorInfluenceAgentDecision;
+    advisorReceiptScope?: "all" | "selected";
+    advisorReceiptSource?: string;
+    advisorReceiptTrigger?: string;
     outcomeReceiptFiles?: string[];
     emitPolicyDecisions?: boolean;
     json?: boolean;
@@ -4032,6 +4060,38 @@ interface ManagedWorkflowPhase {
     summary?: string;
     outcome?: TaskCommitOutcome;
 }
+interface ManagedWorkflowJudgmentBrief {
+    version: "project-intelligence-brief-v1";
+    generatedAt: string;
+    servedJudgmentId?: string;
+    branch?: string;
+    task?: string;
+    changedFiles: string[];
+    recentFiles: string[];
+    errors: Array<{
+        surface: string;
+        message: string;
+    }>;
+    suggestedCommands: string[];
+}
+interface ManagedWorkflowJudgmentResponse {
+    recommendationId: string;
+    decision: AdvisorInfluenceAgentDecision;
+    respondedAt: string;
+    planBefore?: string;
+    planAfter?: string;
+    initialReceipt?: ProjectRunAdvisorReceiptCapture;
+    closeoutReceipt?: ProjectRunAdvisorReceiptCapture;
+    outcomeReceipts?: OutcomeIntelligenceReceipt[];
+}
+interface ManagedWorkflowJudgmentState {
+    version: "snipara.workflow.judgment.v1";
+    generatedAt: string;
+    runEnvelope: ProjectIntelligenceRunEnvelope;
+    brief: ManagedWorkflowJudgmentBrief;
+    card: ProjectIntelligenceJudgmentCard;
+    responses: ManagedWorkflowJudgmentResponse[];
+}
 interface ManagedWorkflowState {
     schemaVersion: ManagedWorkflowSchemaVersion;
     workflowId: string;
@@ -4045,6 +4105,7 @@ interface ManagedWorkflowState {
     phases: ManagedWorkflowPhase[];
     runtime?: ManagedWorkflowRuntimeState;
     coordination?: ManagedWorkflowCoordinationState;
+    judgment?: ManagedWorkflowJudgmentState;
     phaseCommitReceipts?: WorkflowPhaseCommitReceipt[];
     finalReport?: FinalCommitReportArtifact;
     lastCommit?: {