snipara-companion 3.2.30 → 3.2.32

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 Release notes for `snipara-companion`, newest first.
 
+## New In 3.2.32
+
+- Promotes a Hosted MCP `servedJudgmentId` into the first-class Project
+  Intelligence brief so `run` can persist Advisor Influence receipts without a
+  fragile nested lookup or manual flag when the hosted brief already supplies
+  the identity.
+- Adds an explicit Advisor measurement funnel to JSON and text output:
+  identity linked/missing, targeted versus unscoped, acknowledged, applied,
+  verified, blocked, unmeasured, and receipt coverage.
+- Stores a bounded measurement state with each first-party receipt so a runtime
+  acknowledgement is never presented as recommendation-scoped application.
+- Emits one stable `project-intelligence.judgment-run-envelope.v1` per `run`
+  invocation. It reuses a bounded Snipara or Codex session id when available,
+  otherwise generates an opaque run id, and attaches the same envelope to every
+  first-party Advisor receipt.
+
+## New In 3.2.31
+
+- Sends phase commits, final commits, and Team Sync handoffs to project-scoped
+  Why Capture with the existing goal, summary, files, verification commands,
+  session reference, and commit SHA.
+- Preserves reviewed-memory governance with an automatic read-only preview
+  followed by confirmation only when durable rationale candidates exist; filed
+  candidates remain `PENDING` in the review queue.
+- Keeps capture best-effort and observable in JSON receipts and the activity
+  timeline, so a Why Capture outage never rolls back a completed workflow or
+  handoff and never introduces a documentation prompt.
+
 ## New In 3.2.30
 
 - Persists an explicit `--ack-review-only` as a 15-minute, one-use

package/README.md

@@ -359,3 +359,9 @@ Launch assets, demo scripts, and post drafts live in
 [docs/launch/LAUNCH_KIT.md](./docs/launch/LAUNCH_KIT.md).
 
 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.

package/dist/index.d.ts

@@ -441,6 +441,27 @@ interface SessionPersistResult {
     session_id: string;
     files_tracked: number;
 }
+type WhyCaptureSourceKind = "phase_commit" | "final_commit" | "handoff";
+interface WhyCaptureInput {
+    decision?: string;
+    why?: string;
+    rationale?: string;
+    sourceText?: string;
+    sourceKind: WhyCaptureSourceKind;
+    sourceSessionId?: string;
+    task?: string;
+    changedFiles?: string[];
+    commands?: string[];
+    commitSha?: string;
+    confirmed?: boolean;
+    previewOnly?: boolean;
+}
+interface WhyCaptureResult {
+    previewOnly: boolean;
+    confirmed: boolean;
+    candidateCount: number;
+    capturedCount?: number;
+}
 interface JournalAppendResult {
     success?: boolean;
     date?: string;
@@ -1273,6 +1294,7 @@ declare class RLMClient {
         payload?: Record<string, unknown>;
     }): Promise<EmitEventResult>;
     recordAdvisorInfluenceReceipt(input: RecordAdvisorInfluenceReceiptInput): Promise<RecordAdvisorInfluenceReceiptResult>;
+    captureWhy(input: WhyCaptureInput): Promise<WhyCaptureResult>;
     getAutomationEvents(args?: {
         sessionId?: string;
         limit?: number;
@@ -2064,6 +2086,7 @@ interface ProjectIntelligenceBriefOptions {
 interface ProjectIntelligenceBrief {
     version: "project-intelligence-brief-v1";
     generatedAt: string;
+    servedJudgmentId?: string;
     branch?: string;
     task?: string;
     changedFiles: string[];
@@ -2594,10 +2617,27 @@ interface ProjectRunAdvisorReceiptWrite {
     agentDecision?: AdvisorInfluenceAgentDecision;
     changedBecauseOfRecommendation?: boolean;
     lifecycleState?: AdvisorInfluenceLifecycleState;
+    measurementState?: ProjectRunAdvisorMeasurementState;
+    targeted?: boolean;
     result?: RecordAdvisorInfluenceReceiptResult;
     reason?: ProjectRunAdvisorReceiptSkipReason;
     error?: string;
 }
+type ProjectRunAdvisorMeasurementState = "unmeasured" | "acknowledged_unscoped" | "acknowledged" | "applied" | "verified" | "blocked";
+interface ProjectRunAdvisorMeasurementCoverage {
+    version: "project-intelligence.advisor-measurement-coverage.v1";
+    identityStatus: "linked" | "missing";
+    recommendationCount: number;
+    recordedCount: number;
+    targetedCount: number;
+    unscopedCount: number;
+    acknowledgedCount: number;
+    appliedCount: number;
+    verifiedCount: number;
+    blockedCount: number;
+    unmeasuredCount: number;
+    receiptCoverage: number | null;
+}
 type ProjectRunAdvisorReceiptSkipReason = "explicitly_skipped" | "no_advisor_recommendations" | "missing_served_judgment_id" | "no_plan_adaptation" | "write_limit_exceeded";
 interface ProjectRunAdvisorReceiptCapture {
     status: "skipped" | "recorded" | "partial" | "error";
@@ -2608,11 +2648,13 @@ interface ProjectRunAdvisorReceiptCapture {
     recordedCount: number;
     skippedCount: number;
     writes: ProjectRunAdvisorReceiptWrite[];
+    measurement: ProjectRunAdvisorMeasurementCoverage;
     reason?: ProjectRunAdvisorReceiptSkipReason;
 }
 interface ProjectIntelligenceRunResult {
     version: "project-intelligence.production-run.v1";
     generatedAt: string;
+    runEnvelope: ProjectIntelligenceRunEnvelope;
     release: boolean;
     brief: ProjectIntelligenceBrief;
     guard?: ProjectRunGuardResult;
@@ -2624,6 +2666,12 @@ interface ProjectIntelligenceRunResult {
     judgmentCard: ProjectIntelligenceJudgmentCard;
     suggestedCommands: string[];
 }
+interface ProjectIntelligenceRunEnvelope {
+    version: "project-intelligence.judgment-run-envelope.v1";
+    runId: string;
+    identitySource: "snipara_session" | "codex_session" | "generated";
+    startedAt: string;
+}
 interface ProjectRunPolicyDecisionRequests {
     version: "project-intelligence.policy-decision-requests.v1";
     emitted: boolean;