clud-bug 0.6.34 → 0.7.0-rc.11

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-schema.d.ts

@@ -0,0 +1,42 @@
+type JSONSchemaObject = Record<string, unknown>;
+export declare const REVIEW_SCHEMA: JSONSchemaObject;
+export declare function serializedReviewSchema(): string;
+export type FindingSeverity = 'critical' | 'minor' | 'preexisting';
+export interface ReviewFinding {
+    skill: string;
+    summary: string;
+    file?: string;
+    line?: number;
+    reasoning?: string;
+}
+export interface PerSkillScanItem {
+    skill: string;
+    outcome: string;
+}
+export interface DedicatedSection {
+    section_name: string;
+    skill: string;
+    findings: ReviewFinding[];
+}
+export interface ReviewSummaryCounts {
+    critical: number;
+    minor: number;
+    preexisting: number;
+    resolved_from_prior: number;
+    still_open: number;
+}
+export type ReviewStatusHeader = 'critical findings' | 'clean' | 'bare';
+export interface ReviewData {
+    status_header: ReviewStatusHeader | string;
+    summary_counts: ReviewSummaryCounts;
+    per_skill_scan: PerSkillScanItem[];
+    critical_findings: ReviewFinding[];
+    minor_findings: ReviewFinding[];
+    preexisting_findings: ReviewFinding[];
+    skills_referenced: string[];
+    last_reviewed_sha: string;
+    dedicated_sections?: DedicatedSection[];
+    diagnostics?: string[];
+}
+export {};
+//# sourceMappingURL=review-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review-schema.d.ts","sourceRoot":"","sources":["../../src/core/review-schema.ts"],"names":[],"mappings":"AAqCA,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4ChD,eAAO,MAAM,aAAa,EAAE,gBAgF3B,CAAC;AAMF,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAUD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,OAAO,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,kBAAkB,GAAG,MAAM,CAAC;IAC3C,cAAc,EAAE,mBAAmB,CAAC;IACpC,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,oBAAoB,EAAE,aAAa,EAAE,CAAC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/core/review-schema.js

@@ -0,0 +1,156 @@
+// JSON Schema for clud-bug review structured output (0.0.O / v0.6.22).
+//
+// Passed to claude-code-action via `claude_args: --json-schema '<JSON>'`.
+// The Agent SDK validates the LLM's emitted JSON against this schema and
+// re-prompts on mismatch (internal retry; not a clud-bug-level loop).
+//
+// Schema design choices:
+//   - Flat top-level — composite-action outputs are a single string, so we
+//     fromJSON() once and pluck fields. No deep nesting that would force
+//     extra path traversal in the post-step shell.
+//   - Word/char caps in `description:` — the SDK doc names these as the
+//     primary lever for keeping output cheap. They're advisory (the SDK
+//     does not enforce numeric caps; the LLM treats them as instruction).
+//     0.0.X already lives in the prompt, so the schema description here is
+//     a complementary belt-and-suspenders signal.
+//   - Required minimum — only the fields a renderer absolutely needs to
+//     produce a valid summary comment. Counts are always required (the
+//     stats header + status block depend on them); finding arrays are
+//     required but may be empty (a clean review has 0 findings, not
+//     missing arrays).
+//   - `additionalProperties: false` on every object — schema-strict mode.
+//     Anthropic's structured-outputs doc explicitly recommends this to
+//     keep the model from inventing fields.
+//
+// Bumped via deliberate edit; not derived from a TypeScript type. The
+// rendering side (./render-review.ts) treats unknown fields permissively
+// — schema and renderer can drift up to one minor version safely.
+const FINDING_ITEM = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        skill: {
+            type: 'string',
+            description: 'The skill name in brackets, e.g. "critical-issues-only". Must match a loaded skill or "(none)".',
+        },
+        file: {
+            type: 'string',
+            description: 'Path of the affected file relative to repo root. Optional when the finding is cross-cutting.',
+        },
+        line: {
+            type: 'integer',
+            minimum: 1,
+            description: 'Line number in the affected file. Required when `file` is set.',
+        },
+        summary: {
+            type: 'string',
+            description: 'One sentence stating the claim. Max ~20 words; no trailing period (the renderer adds one).',
+        },
+        reasoning: {
+            type: 'string',
+            description: 'Evidence anchor + suggested fix. Max ~80 words. Rendered inside <details> block; can be omitted for self-evident findings.',
+        },
+    },
+    required: ['skill', 'summary'],
+};
+const PER_SKILL_SCAN_ITEM = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        skill: { type: 'string' },
+        outcome: {
+            type: 'string',
+            description: 'One sentence describing what the skill found. Max ~15 words. Examples: "scanned all paths. 2 critical findings below.", "0 findings.", "not applicable to this diff."',
+        },
+    },
+    required: ['skill', 'outcome'],
+};
+export const REVIEW_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        status_header: {
+            type: 'string',
+            enum: ['critical findings', 'clean', 'bare'],
+            description: 'Strict-mode opt-in repos: `critical findings` when ANY 🔴 finding exists, otherwise `clean`. Non-strict-mode repos (the default): emit `bare` — the renderer produces a `## 🐛 Clud Bug review` H2 with no suffix, matching the v0.6.21- behaviour. Check .claude/skills/.clud-bug.json for `strictMode: true` to pick critical/clean vs bare.',
+        },
+        summary_counts: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                critical: { type: 'integer', minimum: 0 },
+                minor: { type: 'integer', minimum: 0 },
+                preexisting: { type: 'integer', minimum: 0 },
+                resolved_from_prior: { type: 'integer', minimum: 0 },
+                still_open: { type: 'integer', minimum: 0 },
+            },
+            required: ['critical', 'minor', 'preexisting', 'resolved_from_prior', 'still_open'],
+        },
+        per_skill_scan: {
+            type: 'array',
+            description: 'One entry per LOADED skill — even silent ones. Empty when no skills are installed.',
+            items: PER_SKILL_SCAN_ITEM,
+        },
+        critical_findings: {
+            type: 'array',
+            description: 'NEW 🔴 findings (bugs, security, perf, missing test coverage). May be empty.',
+            items: FINDING_ITEM,
+        },
+        minor_findings: {
+            type: 'array',
+            description: 'NEW 🟡 findings (nits, style, observations). May be empty.',
+            items: FINDING_ITEM,
+        },
+        preexisting_findings: {
+            type: 'array',
+            description: 'NEW 🟣 findings (issues that pre-date this PR). May be empty.',
+            items: FINDING_ITEM,
+        },
+        dedicated_sections: {
+            type: 'array',
+            description: 'Per-dedicated-mode-skill section blocks. Each item carries the section header text and its findings.',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    section_name: { type: 'string', description: 'Human-readable section title, e.g. "Brand voice".' },
+                    skill: { type: 'string', description: 'The dedicated skill name.' },
+                    findings: { type: 'array', items: FINDING_ITEM },
+                },
+                required: ['section_name', 'skill', 'findings'],
+            },
+        },
+        diagnostics: {
+            type: 'array',
+            description: '0.0.T tee-hint diagnostics. One line per `head -c` cap that fired during fetch. Empty when no truncation occurred.',
+            items: { type: 'string' },
+        },
+        skills_referenced: {
+            type: 'array',
+            description: 'Names of every skill cited in any finding. Empty list (or ["(none)"]) when no skill applied.',
+            items: { type: 'string' },
+        },
+        last_reviewed_sha: {
+            type: 'string',
+            description: 'The HEAD SHA at review time, used by the incremental-diff handshake. Set to the literal value of the workflow env var $HEAD_SHA.',
+        },
+    },
+    required: [
+        'status_header',
+        'summary_counts',
+        'per_skill_scan',
+        'critical_findings',
+        'minor_findings',
+        'preexisting_findings',
+        'skills_referenced',
+        'last_reviewed_sha',
+    ],
+};
+// Serialize the schema for inclusion in workflow templates as the
+// `--json-schema '<JSON>'` argument. Single-line (the workflow YAML uses
+// the pipe block; single-quoted JSON inside that needs to stay flat to
+// avoid YAML parser surprises with embedded newlines).
+export function serializedReviewSchema() {
+    return JSON.stringify(REVIEW_SCHEMA);
+}
+//# sourceMappingURL=review-schema.js.map

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

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

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

@@ -0,0 +1,193 @@
+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: "🟣";
+};
+/**
+ * One parsed finding suitable for the SPEC §1.8.1 Resolved / Still-open
+ * blocks. Mirrors `ParsedFinding` from `./diff-findings.ts`; declared
+ * here as a structural interface (not re-imported) so callers without
+ * `diff-findings` in scope can still construct the input.
+ */
+export interface RenderedFindingRef {
+    file: string;
+    line: number;
+    severity: 'critical' | 'minor' | 'preexisting';
+    skillName: string;
+    summary: string;
+}
+/**
+ * SPEC §6.7.3 cache telemetry — per-invocation token counts from the
+ * Anthropic-family `usage` block. When present, the renderer emits a
+ * `<!-- cache: ... -->` HTML comment immediately below the
+ * `<!-- review-sha: ... -->` metadata line so downstream cost analysis
+ * tooling can audit cache behaviour from the committed doc-file.
+ */
+export interface CacheStats {
+    /** `cache_read_input_tokens` from the Anthropic usage block. */
+    cachedInputTokens: number;
+    /** `cache_creation_input_tokens` from the Anthropic usage block. */
+    cacheCreationInputTokens: number;
+}
+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;
+    /**
+     * Findings present in the prior `docs/reviews/PR-<n>.md` that are NOT
+     * present in this round's `review`. When non-empty, emits the SPEC
+     * §1.8.1 `**Resolved this round:**` block AFTER the severity buckets
+     * and BEFORE the trailing `---` separator. Omitted entirely when
+     * empty/undefined (SPEC §1.8.1: blocks MUST be omitted when empty).
+     *
+     * Produced by `diffFindings()` from `./diff-findings.ts`.
+     */
+    resolvedFindings?: RenderedFindingRef[];
+    /**
+     * Findings present in BOTH the prior `docs/reviews/PR-<n>.md` AND
+     * this round's `review` — the persistent ones. When non-empty, emits
+     * the SPEC §1.8.1 `**Still open:**` block AFTER `**Resolved this
+     * round:**` and before the trailing `---` separator. Omitted entirely
+     * when empty/undefined.
+     *
+     * Produced by `diffFindings()` from `./diff-findings.ts`.
+     */
+    stillOpenFindings?: RenderedFindingRef[];
+    /**
+     * SPEC §6.7.3 cache telemetry. When present, emits a
+     * `<!-- cache: <read> read · <created> created -->` HTML comment
+     * immediately below the `<!-- review-sha: ... -->` metadata line.
+     * Omitted entirely when undefined (this comment is OPTIONAL per the
+     * SPEC, but SHOULD be implemented for cost-analysis tooling).
+     */
+    cacheStats?: CacheStats;
+}
+/**
+ * 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":"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"}