snipara-companion 3.0.13 → 3.1.0

package/README.md

@@ -46,7 +46,10 @@ These commands are useful without hosted Snipara:
 | `reality-check`                                              | Intent Ledger, Unknown Registry, and verification checks     |
 | `code callers` / `imports` / `neighbors` / `shortest-path`   | Structural repo questions from local files                   |
 | `workflow start` / `phase-start` / `phase-commit` / `resume` | Agent continuity that survives compaction                    |
+| `workflow decisions` / `workflow decide`                     | Local human decision requests and response receipts          |
+| `workflow producer-triage`                                   | Ask for human review of unreviewed Producer Loop samples     |
 | `workflow producer-report`                                   | Local Producer Loop adoption and calibration report          |
+| `workflow producer-review`                                   | Mark local Producer Loop samples reviewed or rejected        |
 | `context-pack`                                               | Reversible local packs for long logs, diffs, and tool output |
 | `judgment-card`, `verify`, `lead-plan`, `agent-readiness`    | Local review artifacts and delegation contracts              |
 | `intelligence ledger-export`                                 | Structured redacted ledger JSON for replay and review        |
@@ -63,7 +66,11 @@ npx -y snipara-companion lead-plan --task "ship auth hardening" --changed-files
 npx -y snipara-companion lead-plan --from-plan ./project-health-lead-plan.json --reconcile --changed-files src/auth/session.ts
 npx -y snipara-companion lead-plan --from-plan ./project-health-lead-plan.json --json | jq '.engineeringLeadPlan.executionReceipts'
 npx -y snipara-companion workflow phase-commit audit --summary "mapped auth impact"
+npx -y snipara-companion workflow producer-triage
+npx -y snipara-companion workflow decisions
+npx -y snipara-companion workflow decide decision-abc123 --choose accept_all --reviewer alice
 npx -y snipara-companion workflow producer-report
+npx -y snipara-companion workflow producer-review --latest --outcome useful --reviewer alice
 npx -y snipara-companion handoff --summary "auth impact mapped" --next "run auth tests"
 ```
 
@@ -76,10 +83,23 @@ under `.snipara/producer-loop/`. These are local review evidence backed by the
 redacted Coding Intelligence Ledger, not automatic durable memory, worker
 execution, calibrated confidence, or server-side attestation. Use
 `workflow producer-report` to inspect local adoption, reason-code counts, sample
-size, invalid artifacts, and calibration caveats before any future hard gate.
+size, reviewed/rejected/unreviewed counts, invalid artifacts, and calibration
+caveats before any future hard gate.
 The report also recognizes exported PR Answer Pack decision-capture artifacts
 with producer kind `pr_answer_pack_decision_capture`, so calibration can track
 more than the workflow producer once those artifacts are present locally.
+Use `workflow producer-review --artifact <path|file|artifactId>` or
+`workflow producer-review --latest` after auditing embedded evidence to move a
+sample from `sample_unreviewed` to `sample_reviewed` or `sample_rejected`.
+For conversational human review, run `workflow producer-triage` to create a
+batched Decision Request V0 artifact, `workflow decisions --json` to give the
+LLM client the exact question/evidence/options to ask, and `workflow decide`
+only after the human answers. Decision requests never resolve by timeout or
+default, and only `workflow decide` applies the existing `producer-review` path.
+Other producers such as `outcome-capture preview --emit-decisions`,
+`workflow decision-producer memory`, and `workflow decision-producer context-risk`
+emit requests with their existing apply paths declared; they do not write
+canonical memory directly.
 
 ## Local First, Hosted When Useful
 

package/dist/index.d.ts

@@ -2462,6 +2462,7 @@ interface OutcomeCapturePreviewCommandOptions {
     reason?: string[];
     feedback?: string;
     maxCandidates?: string;
+    emitDecisions?: boolean;
     json?: boolean;
 }
 declare function buildWhyOutcomeCaptureReport(options: WhyOutcomeCaptureOptions): WhyOutcomeCaptureReport;
@@ -2795,6 +2796,7 @@ declare const PRODUCER_LOOP_ARTIFACT_VERSION: "snipara.producer_loop_artifact.v0
 declare const PRODUCER_LOOP_REPORT_VERSION: "snipara.producer_loop_report.v0";
 declare const PRODUCER_LOOP_RELATIVE_DIR: string;
 type ProducerLoopProducerKind = "workflow_phase_commit" | "workflow_final_commit" | "pr_answer_pack_decision_capture";
+type ProducerLoopSampleReviewStatus = "sample_unreviewed" | "sample_reviewed" | "sample_rejected";
 interface ProducerLoopArtifactWriteResult {
     status: "written" | "error";
     schemaVersion: typeof PRODUCER_LOOP_ARTIFACT_VERSION;
@@ -2820,6 +2822,10 @@ interface ProducerLoopArtifactReportSummary {
     reasonCodes: string[];
     files: string[];
     calibrationStatus?: string;
+    reviewStatus: ProducerLoopSampleReviewStatus;
+    reviewOutcome?: string;
+    reviewedAt?: string;
+    reviewer?: string;
 }
 interface ProducerLoopReport {
     version: typeof PRODUCER_LOOP_REPORT_VERSION;
@@ -2847,7 +2853,11 @@ interface ProducerLoopReport {
     calibration: {
         status: "no_samples" | "insufficient_samples" | "reviewable_sample_set";
         sampleSize: number;
+        reviewedSampleSize: number;
+        rejectedSampleSize: number;
+        unreviewedSampleSize: number;
         minReviewSampleSize: number;
+        reviewOutcomes: Record<string, number>;
         hardGateReady: false;
         notes: string[];
     };