clud-bug 0.7.0-rc.1 → 0.7.0-rc.2

package/dist/core/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../src/core/prompt-builder.ts"],"names":[],"mappings":"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"}

package/dist/core/review-schema-zod.d.ts

@@ -0,0 +1,240 @@
+import { z } from 'zod';
+export declare const severityValues: readonly ["critical", "minor", "preexisting"];
+export declare const severitySchema: z.ZodEnum<{
+    critical: "critical";
+    minor: "minor";
+    preexisting: "preexisting";
+}>;
+export type Severity = z.infer<typeof severitySchema>;
+export declare const statusHeaderValues: readonly ["critical findings", "clean", "bare"];
+export declare const statusHeaderSchema: z.ZodEnum<{
+    "critical findings": "critical findings";
+    clean: "clean";
+    bare: "bare";
+}>;
+export type StatusHeader = z.infer<typeof statusHeaderSchema>;
+export declare const summaryCountsSchema: z.ZodObject<{
+    critical: z.ZodNumber;
+    minor: z.ZodNumber;
+    preexisting: z.ZodNumber;
+    resolved_from_prior: z.ZodNumber;
+    still_open: z.ZodNumber;
+}, z.core.$strip>;
+export type SummaryCounts = z.infer<typeof summaryCountsSchema>;
+/**
+ * Wire-shape finding item — NO severity field (mirrors the CLI's
+ * `FINDING_ITEM` JSON Schema in `./review-schema.ts`). Severity is implicit
+ * in which array the item lives in (`critical_findings`/`minor_findings`/
+ * `preexisting_findings`).
+ */
+export declare const findingItemSchema: z.ZodObject<{
+    skill: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    line: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodString;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FindingItem = z.infer<typeof findingItemSchema>;
+/** Per-skill scan report — one entry per loaded skill (even silent ones). */
+export declare const perSkillScanItemSchema: z.ZodObject<{
+    skill: z.ZodString;
+    outcome: z.ZodString;
+}, z.core.$strip>;
+export type PerSkillScanItem = z.infer<typeof perSkillScanItemSchema>;
+/** Dedicated-section block for `review_mode: dedicated` skills. */
+export declare const dedicatedSectionSchema: z.ZodObject<{
+    section_name: z.ZodString;
+    skill: z.ZodString;
+    findings: z.ZodArray<z.ZodObject<{
+        skill: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodString;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DedicatedSection = z.infer<typeof dedicatedSectionSchema>;
+/**
+ * Full review payload — wire shape. The model produces this; the App
+ * orchestrator immediately flattens to the internal `Finding[]` shape via
+ * `flattenFindings()` for multi-pass + aggregator work, then unflattens
+ * back via `unflattenFindings()` before writeback.
+ */
+export declare const reviewSchema: z.ZodObject<{
+    status_header: z.ZodEnum<{
+        "critical findings": "critical findings";
+        clean: "clean";
+        bare: "bare";
+    }>;
+    summary_counts: z.ZodObject<{
+        critical: z.ZodNumber;
+        minor: z.ZodNumber;
+        preexisting: z.ZodNumber;
+        resolved_from_prior: z.ZodNumber;
+        still_open: z.ZodNumber;
+    }, z.core.$strip>;
+    per_skill_scan: z.ZodArray<z.ZodObject<{
+        skill: z.ZodString;
+        outcome: z.ZodString;
+    }, z.core.$strip>>;
+    critical_findings: z.ZodArray<z.ZodObject<{
+        skill: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodString;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    minor_findings: z.ZodArray<z.ZodObject<{
+        skill: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodString;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    preexisting_findings: z.ZodArray<z.ZodObject<{
+        skill: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodString;
+        reasoning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    dedicated_sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        section_name: z.ZodString;
+        skill: z.ZodString;
+        findings: z.ZodArray<z.ZodObject<{
+            skill: z.ZodString;
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            summary: z.ZodString;
+            reasoning: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    diagnostics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    skills_referenced: z.ZodArray<z.ZodString>;
+    last_reviewed_sha: z.ZodString;
+}, z.core.$strip>;
+export type Review = z.infer<typeof reviewSchema>;
+/**
+ * Internal flat-finding type used by App orchestrator, multi-pass
+ * aggregator, skill-usage telemetry, etc. Created from a wire-shape
+ * `Review` via `flattenFindings()`. Has explicit `severity` field so
+ * internal code doesn't need to track which array a finding came from.
+ *
+ * Exported from the core barrel as `ZodFinding` to disambiguate from
+ * the CLI-shape `ReviewFinding` (which never carries severity — its
+ * severity comes from the array it lives in).
+ */
+export type Finding = FindingItem & {
+    severity: Severity;
+};
+/**
+ * Zod schema describing the internal Finding shape (for tests + cross-check
+ * Pass 2 independentFindings). The wire equivalent is `findingItemSchema`
+ * which does NOT have severity.
+ */
+export declare const findingSchema: z.ZodObject<{
+    skill: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    line: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodString;
+    reasoning: z.ZodOptional<z.ZodString>;
+    severity: z.ZodEnum<{
+        critical: "critical";
+        minor: "minor";
+        preexisting: "preexisting";
+    }>;
+}, z.core.$strip>;
+/**
+ * Flatten wire-shape `Review.critical_findings / minor_findings /
+ * preexisting_findings` into a single `Finding[]` with severity tagged.
+ * Preserves ordering: criticals first, then minors, then preexistings.
+ */
+export declare function flattenFindings(review: Review): Finding[];
+/**
+ * Inverse of `flattenFindings`: split a flat `Finding[]` back into the
+ * three wire-shape arrays. Used at writeback time after multi-pass
+ * aggregation has produced the final flat list.
+ */
+export declare function unflattenFindings(findings: Finding[]): {
+    critical_findings: FindingItem[];
+    minor_findings: FindingItem[];
+    preexisting_findings: FindingItem[];
+};
+/**
+ * Derive `summary_counts` from a flat `Finding[]` list. Canonical
+ * source-of-truth used by the orchestrator after flattening, to
+ * overwrite the model's potentially-drifted counts.
+ */
+export declare function deriveSummaryCounts(findings: Finding[]): SummaryCounts;
+/**
+ * Derive `skills_referenced` from a flat `Finding[]` list, preserving
+ * citation order (first appearance wins) and deduplicating.
+ */
+export declare function deriveSkillsReferenced(findings: Finding[]): string[];
+/**
+ * Test helper: build a wire-shape `Review` from a flat `Finding[]` list.
+ * Tests historically built reviews with a flat `findings: [...]` field; the
+ * wire shape (separate severity arrays + per_skill_scan + last_reviewed_sha
+ * required) is more verbose. This helper keeps fixtures short — pass a
+ * flat list, get back a valid wire-shape Review with derived counts and
+ * skills.
+ *
+ * Production code should NOT use this; it constructs reviews from AI output
+ * directly. This is purely for test ergonomics.
+ */
+export declare function buildReviewFromFindings(opts: {
+    findings: Finding[];
+    status_header?: StatusHeader;
+    last_reviewed_sha?: string;
+    per_skill_scan?: PerSkillScanItem[];
+    dedicated_sections?: DedicatedSection[];
+    diagnostics?: string[];
+}): Review;
+/**
+ * Per-finding verdict from a cross-check pass. The pass2 model echoes
+ * back Pass 1's findings by 0-indexed `pass1Index` + `agreed`/`disagreed`
+ * + rationale. The aggregator stitches these into
+ * `MultiPassReview.findings[].attributions`.
+ *
+ * Cross-check Pass 2 operates on a flat finding list (its own
+ * representation), so its independentFindings carry severity — uses the
+ * legacy `findingSchema` shape.
+ */
+export declare const crossCheckVerdictSchema: z.ZodObject<{
+    pass1Index: z.ZodNumber;
+    verdict: z.ZodEnum<{
+        agreed: "agreed";
+        disagreed: "disagreed";
+    }>;
+    rationale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CrossCheckVerdictSchema = z.infer<typeof crossCheckVerdictSchema>;
+/**
+ * Full cross-check response. Pass 2 outputs verdicts on Pass-1 findings
+ * plus its own independent finds (in the internal `findingSchema` shape
+ * with severity, since cross-check works on already-flattened lists).
+ */
+export declare const crossCheckSchema: z.ZodObject<{
+    verdicts: z.ZodArray<z.ZodObject<{
+        pass1Index: z.ZodNumber;
+        verdict: z.ZodEnum<{
+            agreed: "agreed";
+            disagreed: "disagreed";
+        }>;
+        rationale: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    independentFindings: z.ZodArray<z.ZodObject<{
+        skill: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodString;
+        reasoning: z.ZodOptional<z.ZodString>;
+        severity: z.ZodEnum<{
+            critical: "critical";
+            minor: "minor";
+            preexisting: "preexisting";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CrossCheck = z.infer<typeof crossCheckSchema>;
+//# sourceMappingURL=review-schema-zod.d.ts.map

package/dist/core/review-schema-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-schema-zod.d.ts","sourceRoot":"","sources":["../../src/core/review-schema-zod.ts"],"names":[],"mappings":"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"}

package/dist/core/review-schema-zod.js

@@ -0,0 +1,218 @@
+// Zod-typed review schema for the AI-Gateway-shape consumer (clud-bug-app).
+//
+// The CLI runtime in `./review-schema.ts` ships a plain JSON-Schema object
+// because that's what the Agent SDK validator expects on the
+// `--json-schema '<JSON>'` argument. The App's runtime instead funnels the
+// model output through the Vercel AI SDK, which derives a JSON Schema from
+// a Zod schema. Both consumers need to agree on the WIRE shape — separate
+// `critical_findings[] / minor_findings[] / preexisting_findings[]` arrays
+// per SPEC §1.8.1 — but each builds its validator from a different source.
+//
+// This module ports the App's Zod schemas + flat-shape helpers into core
+// so a future drift between the App's Zod and the CLI's JSON-Schema lives
+// in one repo. The equivalence test (test/review-schema-zod.test.js)
+// asserts the two schemas describe the same wire shape (required fields,
+// finding-item shape) for every release.
+//
+// Ported from clud-bug-app/lib/review-schema.ts (commit shipped 2026-06-08).
+// The pure helpers (`flattenFindings`, `unflattenFindings`,
+// `deriveSummaryCounts`, `deriveSkillsReferenced`, `buildReviewFromFindings`)
+// are byte-equivalent to the App's helpers — see test for the equivalence
+// fixtures.
+import { z } from 'zod';
+// Severity buckets per SPEC §1.8.1. Only used by the internal `Finding`
+// type — the wire `findingItemSchema` does NOT carry severity.
+export const severityValues = ['critical', 'minor', 'preexisting'];
+export const severitySchema = z.enum(severityValues);
+// Status header at the top of the review file.
+export const statusHeaderValues = [
+    'critical findings',
+    'clean',
+    'bare',
+];
+export const statusHeaderSchema = z.enum(statusHeaderValues);
+export const summaryCountsSchema = z.object({
+    critical: z.number().int().min(0),
+    minor: z.number().int().min(0),
+    preexisting: z.number().int().min(0),
+    resolved_from_prior: z.number().int().min(0),
+    still_open: z.number().int().min(0),
+});
+/**
+ * Wire-shape finding item — NO severity field (mirrors the CLI's
+ * `FINDING_ITEM` JSON Schema in `./review-schema.ts`). Severity is implicit
+ * in which array the item lives in (`critical_findings`/`minor_findings`/
+ * `preexisting_findings`).
+ */
+export const findingItemSchema = z.object({
+    skill: z.string().min(1),
+    file: z.string().optional(),
+    line: z.number().int().min(1).optional(),
+    summary: z.string().min(1),
+    reasoning: z.string().optional(),
+});
+/** Per-skill scan report — one entry per loaded skill (even silent ones). */
+export const perSkillScanItemSchema = z.object({
+    skill: z.string(),
+    outcome: z.string(),
+});
+/** Dedicated-section block for `review_mode: dedicated` skills. */
+export const dedicatedSectionSchema = z.object({
+    section_name: z.string(),
+    skill: z.string(),
+    findings: z.array(findingItemSchema),
+});
+/**
+ * Full review payload — wire shape. The model produces this; the App
+ * orchestrator immediately flattens to the internal `Finding[]` shape via
+ * `flattenFindings()` for multi-pass + aggregator work, then unflattens
+ * back via `unflattenFindings()` before writeback.
+ */
+export const reviewSchema = z.object({
+    status_header: statusHeaderSchema,
+    summary_counts: summaryCountsSchema,
+    per_skill_scan: z.array(perSkillScanItemSchema),
+    critical_findings: z.array(findingItemSchema),
+    minor_findings: z.array(findingItemSchema),
+    preexisting_findings: z.array(findingItemSchema),
+    dedicated_sections: z.array(dedicatedSectionSchema).optional(),
+    diagnostics: z.array(z.string()).optional(),
+    skills_referenced: z.array(z.string()),
+    last_reviewed_sha: z.string(),
+});
+/**
+ * Zod schema describing the internal Finding shape (for tests + cross-check
+ * Pass 2 independentFindings). The wire equivalent is `findingItemSchema`
+ * which does NOT have severity.
+ */
+export const findingSchema = findingItemSchema.extend({
+    severity: severitySchema,
+});
+/**
+ * Flatten wire-shape `Review.critical_findings / minor_findings /
+ * preexisting_findings` into a single `Finding[]` with severity tagged.
+ * Preserves ordering: criticals first, then minors, then preexistings.
+ */
+export function flattenFindings(review) {
+    const out = [];
+    for (const f of review.critical_findings)
+        out.push({ ...f, severity: 'critical' });
+    for (const f of review.minor_findings)
+        out.push({ ...f, severity: 'minor' });
+    for (const f of review.preexisting_findings)
+        out.push({ ...f, severity: 'preexisting' });
+    return out;
+}
+/**
+ * Inverse of `flattenFindings`: split a flat `Finding[]` back into the
+ * three wire-shape arrays. Used at writeback time after multi-pass
+ * aggregation has produced the final flat list.
+ */
+export function unflattenFindings(findings) {
+    const stripSeverity = (f) => {
+        const { severity: _s, ...rest } = f;
+        return rest;
+    };
+    return {
+        critical_findings: findings.filter((f) => f.severity === 'critical').map(stripSeverity),
+        minor_findings: findings.filter((f) => f.severity === 'minor').map(stripSeverity),
+        preexisting_findings: findings.filter((f) => f.severity === 'preexisting').map(stripSeverity),
+    };
+}
+/**
+ * Derive `summary_counts` from a flat `Finding[]` list. Canonical
+ * source-of-truth used by the orchestrator after flattening, to
+ * overwrite the model's potentially-drifted counts.
+ */
+export function deriveSummaryCounts(findings) {
+    return {
+        critical: findings.filter((f) => f.severity === 'critical').length,
+        minor: findings.filter((f) => f.severity === 'minor').length,
+        preexisting: findings.filter((f) => f.severity === 'preexisting').length,
+        resolved_from_prior: 0,
+        still_open: 0,
+    };
+}
+/**
+ * Derive `skills_referenced` from a flat `Finding[]` list, preserving
+ * citation order (first appearance wins) and deduplicating.
+ */
+export function deriveSkillsReferenced(findings) {
+    const seen = new Set();
+    const out = [];
+    for (const f of findings) {
+        if (seen.has(f.skill))
+            continue;
+        seen.add(f.skill);
+        out.push(f.skill);
+    }
+    return out;
+}
+/**
+ * Test helper: build a wire-shape `Review` from a flat `Finding[]` list.
+ * Tests historically built reviews with a flat `findings: [...]` field; the
+ * wire shape (separate severity arrays + per_skill_scan + last_reviewed_sha
+ * required) is more verbose. This helper keeps fixtures short — pass a
+ * flat list, get back a valid wire-shape Review with derived counts and
+ * skills.
+ *
+ * Production code should NOT use this; it constructs reviews from AI output
+ * directly. This is purely for test ergonomics.
+ */
+export function buildReviewFromFindings(opts) {
+    const split = unflattenFindings(opts.findings);
+    // Default status_header is derived from severity, NOT just emptiness.
+    // The App's original buildReviewFromFindings defaulted to
+    // 'critical findings' for ANY non-empty list, including minor-only and
+    // preexisting-only inputs. That was a bug (caught by clud-bug-review
+    // on PR #158): a review with only minor findings should be 'clean', not
+    // 'critical findings'. Fixed here on port to core.
+    //
+    // Callers that need the old behavior can pass `status_header` explicitly.
+    // Callers that want SPEC §1.8.1 semantics (the default) get the correct
+    // bucket: criticals present → 'critical findings'; else → 'clean'.
+    const hasCritical = opts.findings.some((f) => f.severity === 'critical');
+    const defaultStatus = hasCritical ? 'critical findings' : 'clean';
+    return {
+        status_header: opts.status_header ?? defaultStatus,
+        summary_counts: deriveSummaryCounts(opts.findings),
+        skills_referenced: deriveSkillsReferenced(opts.findings),
+        per_skill_scan: opts.per_skill_scan ?? [],
+        critical_findings: split.critical_findings,
+        minor_findings: split.minor_findings,
+        preexisting_findings: split.preexisting_findings,
+        ...(opts.dedicated_sections !== undefined
+            ? { dedicated_sections: opts.dedicated_sections }
+            : {}),
+        ...(opts.diagnostics !== undefined ? { diagnostics: opts.diagnostics } : {}),
+        last_reviewed_sha: opts.last_reviewed_sha ?? '',
+    };
+}
+// ---------------------------------------------------------------------------
+// D.2.5 — cross-check pass schema
+// ---------------------------------------------------------------------------
+/**
+ * Per-finding verdict from a cross-check pass. The pass2 model echoes
+ * back Pass 1's findings by 0-indexed `pass1Index` + `agreed`/`disagreed`
+ * + rationale. The aggregator stitches these into
+ * `MultiPassReview.findings[].attributions`.
+ *
+ * Cross-check Pass 2 operates on a flat finding list (its own
+ * representation), so its independentFindings carry severity — uses the
+ * legacy `findingSchema` shape.
+ */
+export const crossCheckVerdictSchema = z.object({
+    pass1Index: z.number().int().min(0),
+    verdict: z.enum(['agreed', 'disagreed']),
+    rationale: z.string().optional(),
+});
+/**
+ * Full cross-check response. Pass 2 outputs verdicts on Pass-1 findings
+ * plus its own independent finds (in the internal `findingSchema` shape
+ * with severity, since cross-check works on already-flattened lists).
+ */
+export const crossCheckSchema = z.object({
+    verdicts: z.array(crossCheckVerdictSchema),
+    independentFindings: z.array(findingSchema),
+});
+//# sourceMappingURL=review-schema-zod.js.map

package/dist/core/review-schema-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-schema-zod.js","sourceRoot":"","sources":["../../src/core/review-schema-zod.ts"],"names":[],"mappings":"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"}

package/dist/core/review-writeback.d.ts

@@ -0,0 +1,139 @@
+import { type Finding, type Review } from './review-schema-zod.js';
+/** Protocol version this implementation emits. */
+export declare const PROTOCOL_VERSION = "0.1.0";
+/** "Written by" tag for the App writeback (SPEC §6.1). */
+export declare const WRITTEN_BY = "clud-bug[bot]";
+export declare const SEVERITY_EMOJI: {
+    readonly critical: "🔴";
+    readonly minor: "🟡";
+    readonly preexisting: "🟣";
+};
+export interface RenderReviewFileInput {
+    review: Review;
+    prNumber: number;
+    /** 40-char head SHA. Pinned to `<!-- review-sha: ... -->`. */
+    headSha: string;
+    /** GitHub PR URL — appended verbatim to the trailing rule. */
+    prUrl: string;
+}
+/**
+ * Renders the review object to the SPEC §1.8.1 markdown template.
+ *
+ * Pure: no I/O, no time-of-day, no provider info — fixture-stable.
+ *
+ * NB: This produces the doc-file shape (`# clud-bug review — PR #N` H1).
+ * The CLI's `renderReview` produces the PR-comment shape (`## 🐛 Clud Bug
+ * review` H2). Both are valid review outputs; SPEC §6.2 says they share
+ * the underlying finding data but differ in container.
+ */
+export declare function renderReviewFile(input: RenderReviewFileInput): string;
+/**
+ * Provenance label for a single finding's attribution from one pass.
+ * Mirrors the App's `PassSource` discriminator.
+ *
+ * `mode === 'cross-check'`:
+ *   - 'first'       → finding raised by Pass 1
+ *   - 'agreed'      → later pass agreed
+ *   - 'disagreed'   → later pass disagreed
+ *   - 'independent' → later pass surfaced this finding independently
+ *
+ * `mode === 'consensus'`:
+ *   - 'first'        → finding tuple unique to Pass 1
+ *   - 'independent'  → finding tuple unique to Pass N (N > 1)
+ *   - 'agreed'       → finding tuple appeared in 2+ passes (consensus)
+ */
+export type PassSource = 'first' | 'agreed' | 'disagreed' | 'independent';
+export interface PassAttribution {
+    /** 1-indexed pass number — matches the spec's "[Pass N]" label. */
+    passNumber: number;
+    /** Role display name, e.g. "Beetle". */
+    roleName: string;
+    /** Model slug for this pass — used by the renderer for the "· Sonnet 4.6" tail. */
+    model: string;
+    /** Provenance — see PassSource doc. */
+    source: PassSource;
+    /** Optional one-line note from the pass, e.g. cross-check rationale. */
+    note?: string;
+}
+export interface UnifiedFinding extends Finding {
+    /** One PassAttribution per pass involved with this finding. Order: by passNumber. */
+    attributions: PassAttribution[];
+}
+/** Effective resolution verdict the multi-pass orchestrator emits. */
+export type MultiPassVerdict = 'request_changes' | 'review_only' | 'clean';
+/** Effective multi-pass mode. */
+export type ReviewPassMode = 'cross-check' | 'consensus' | 'independent';
+export interface MultiPassReview {
+    /** Status header — derived from aggregated findings + mode resolution rules. */
+    status_header: Review['status_header'];
+    /** Summary counts, derived from the unified findings list. */
+    summary_counts: Review['summary_counts'];
+    /** Skills cited at least once across any pass. */
+    skills_referenced: string[];
+    /** Unified findings, with per-pass attribution. */
+    findings: UnifiedFinding[];
+    /** Effective mode (for the renderer's "(N passes · mode)" header line). */
+    mode: ReviewPassMode;
+    /** Number of passes that actually ran. */
+    passCount: number;
+    /** Role labels per pass, parallel to passCount. Used by the renderer. */
+    roles: Array<{
+        passNumber: number;
+        roleName: string;
+        model: string;
+    }>;
+    /** Resolution verdict — see App's multi-pass-aggregator for derivation. */
+    verdict: MultiPassVerdict;
+}
+export interface RenderMultiPassMarkdownInput {
+    review: MultiPassReview;
+    prNumber: number;
+    /** 40-char head SHA. Pinned to `<!-- review-sha: ... -->`. */
+    headSha: string;
+    /** GitHub PR URL — appended verbatim to the trailing rule. */
+    prUrl: string;
+}
+/**
+ * Renders a multi-pass review with per-pass attribution lines.
+ *
+ * Output layout (SPEC §1.8.5):
+ *
+ *   # clud-bug review — PR #N (M passes · mode)
+ *   <!-- protocol-version: ... -->
+ *   <!-- written-by: clud-bug[bot] -->
+ *   <!-- review-sha: ... -->
+ *   <!-- passes: M -->
+ *   <!-- mode: cross-check|consensus|independent -->
+ *
+ *   **Summary:** ... · **Verdict:** request_changes / review_only / clean
+ *
+ *   **Reviewers:**
+ *     - Pass 1 — Beetle · anthropic/claude-sonnet-4.6
+ *     - Pass 2 — Wasp   · anthropic/claude-opus-4.7
+ *
+ *   **Skills cited:** ...
+ *
+ *   **Findings:**
+ *
+ *   ### (red) Critical
+ *   - [Pass 1 — Beetle · Sonnet 4.6] auth.ts:42 — race-conditions: Race condition
+ *     Reasoning: ...
+ *     [Pass 2 — Wasp · Opus 4.7]: (check) AGREED — same finding identified independently.
+ *
+ *   ...
+ *
+ *   ---
+ *   [Link to PR](...)
+ *
+ * Pure: no I/O, no time-of-day, fixture-stable.
+ */
+export declare function renderMultiPassMarkdown(input: RenderMultiPassMarkdownInput): string;
+/** SPEC §6.1 / §1.8 path. The App's Octokit writeback uses this. */
+export declare function reviewFilePath(prNumber: number): string;
+/**
+ * SPEC §6.1 commit message: exactly `[skip-logmind] clud-bug review: PR #<n>`.
+ * The `[skip-logmind]` prefix tells `check-decisions.yml` to ignore this
+ * commit (SPEC §6.4). The App's Octokit writeback uses this.
+ */
+export declare function reviewCommitMessage(prNumber: number): string;
+//# sourceMappingURL=review-writeback.d.ts.map

package/dist/core/review-writeback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-writeback.d.ts","sourceRoot":"","sources":["../../src/core/review-writeback.ts"],"names":[],"mappings":"AAwBA,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,MAAM,EACZ,MAAM,wBAAwB,CAAC;AAEhC,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAM1C,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAsErE;AAkCD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC7C,qFAAqF;IACrF,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,aAAa,GAAG,OAAO,CAAC;AAE3E,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IACvC,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACzC,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,2EAA2E;IAC3E,IAAI,EAAE,cAAc,CAAC;IACrB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,2EAA2E;IAC3E,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,MAAM,CAmER;AA0FD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D"}