opencode-swarm 7.74.3 → 7.75.0

package/dist/hooks/review-receipt-collector.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Reviewer receipt collector (auto-review machinery, piece A).
+ *
+ * Parses the mandated reviewer OUTPUT FORMAT (`VERDICT:` / `RISK:` /
+ * `ISSUES:` / `FIXES:`) from a returning reviewer Task delegation and
+ * persists it as a durable review receipt under `.swarm/review-receipts/`
+ * via the existing receipt store (scope-fingerprinted over the delegation
+ * prompt, which defines the reviewed scope).
+ *
+ * Before this collector, reviewer verdicts existed only as free text inside
+ * the architect's context — re-reviews and drift verification had no durable
+ * machine-readable record of what the reviewer decided. Knowledge-directive
+ * lines (`DIRECTIVE_COMPLIANCE`) are handled separately by
+ * `reviewer-verdict-parser.ts`; this module covers the main verdict block.
+ *
+ * Fail-open: parsing or persistence failures never block tool execution.
+ */
+export type ParsedReviewSeverity = 'critical' | 'high' | 'medium';
+export interface ParsedReviewIssue {
+    /** Raw issue line (trimmed, bullet stripped) */
+    text: string;
+    /** Severity inferred from a CRITICAL/HIGH/MEDIUM/LOW/INFO tag, default medium */
+    severity: ParsedReviewSeverity;
+    /** `path:line` reference when one appears in the line */
+    location?: string;
+}
+export interface ParsedReviewerOutput {
+    verdict: 'approved' | 'rejected';
+    /** RISK: LOW | MEDIUM | HIGH | CRITICAL (uppercased), when present */
+    risk?: string;
+    /** Blocking/non-blocking issue lines from the ISSUES section */
+    issues: ParsedReviewIssue[];
+    /** Required-change lines from the FIXES section */
+    fixes: string[];
+}
+/**
+ * Parse the reviewer agent's mandated output block. Returns null when no
+ * unambiguous line-anchored `VERDICT: APPROVED|REJECTED` is present —
+ * including when multiple anchored verdict lines DISAGREE (ambiguous output
+ * fails toward "no machine-readable verdict", never toward approval).
+ */
+export declare function parseReviewerOutput(text: string): ParsedReviewerOutput | null;
+export interface ReviewerReceiptInput {
+    tool: unknown;
+    args?: unknown;
+    sessionID?: unknown;
+}
+export interface ReviewerReceiptOutput {
+    output?: unknown;
+}
+/**
+ * `tool.execute.after` collector. When a reviewer Task returns, parse its
+ * verdict block and persist a durable review receipt. No-op for non-reviewer
+ * delegations, missing prompts/outputs, or unparseable verdicts. Never throws.
+ *
+ * Returns the persisted receipt path (for tests/telemetry) or null.
+ */
+export declare function collectReviewerReceiptAfter(directory: string, input: ReviewerReceiptInput, output: ReviewerReceiptOutput): Promise<string | null>;

package/dist/hooks/review-receipt.d.ts

@@ -20,6 +20,13 @@
  *
  * Critic drift verification can consume prior receipts as supporting context
  * but MUST NOT blindly trust them — staleness check is mandatory.
+ *
+ * Scope-description heterogeneity: receipts in one index may be fingerprinted
+ * over different canonical contents (e.g. 'reviewer-task-prompt' hashes the
+ * delegation prompt; 'auto-review-*-diff' hashes the reviewed diff). A prompt
+ * fingerprint does NOT change when the worktree changes, so consumers MUST
+ * filter by `scope_fingerprint.scope_description` (or compare like-for-like
+ * content) before treating an approved receipt as fresh via isScopeStale().
  */
 export type ReceiptVerdict = 'rejected' | 'approved';
 /** Identity of the reviewer/curator that produced the receipt. */