snipara-companion 3.5.5 → 3.5.7

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 Release notes for `snipara-companion`, newest first.
 
+## New In 3.5.7
+
+- Bounds the best-effort hosted judgment lookup in `run` to 8 seconds instead
+  of silently waiting for up to 30 seconds.
+- Exposes `hostedJudgment.status` as `linked`, `unlinked`, or `unavailable` in
+  JSON and prints one concise human-readable diagnostic without blocking the
+  local Judgment Card.
+- Compatibility note: hosted context queries now treat an explicit
+  `max_tokens` value as immutable. Small conceptual or multi-hop budgets may
+  return less context than older servers that silently enlarged the request;
+  increase the requested budget when more context is intentional.
+- Clarifies that references mode budgets the Answer Pack plus previews. Full
+  referenced chunks remain retrievable and their `token_count` is planning
+  metadata rather than initial response usage.
+
+## 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;
@@ -2745,12 +2773,20 @@ interface ProjectRunAdvisorReceiptCapture {
     measurement: ProjectRunAdvisorMeasurementCoverage;
     reason?: ProjectRunAdvisorReceiptSkipReason;
 }
+interface ProjectRunHostedJudgmentLink {
+    version: "project-intelligence.hosted-judgment-link.v1";
+    status: "linked" | "unlinked" | "unavailable";
+    timeoutMs: number;
+    servedJudgmentId?: string;
+    error?: string;
+}
 interface ProjectIntelligenceRunResult {
     version: "project-intelligence.production-run.v1";
     generatedAt: string;
     runEnvelope: ProjectIntelligenceRunEnvelope;
     release: boolean;
     brief: ProjectIntelligenceBrief;
+    hostedJudgment: ProjectRunHostedJudgmentLink;
     guard?: ProjectRunGuardResult;
     packageReview?: ProjectRunPackageReview;
     policyGates: ProjectPolicyGatesResult;
@@ -4032,6 +4068,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 +4113,7 @@ interface ManagedWorkflowState {
     phases: ManagedWorkflowPhase[];
     runtime?: ManagedWorkflowRuntimeState;
     coordination?: ManagedWorkflowCoordinationState;
+    judgment?: ManagedWorkflowJudgmentState;
     phaseCommitReceipts?: WorkflowPhaseCommitReceipt[];
     finalReport?: FinalCommitReportArtifact;
     lastCommit?: {