iterate-plugin 3.9.2 → 3.11.0

package/src/client/index.ts

@@ -113,6 +113,7 @@ import {
 import {
   renderRunReportMarkdown, // Markdown run report (PR-pasteable)
   renderRunReportSarif, // SARIF 2.1.0 log (CI / Code Scanning)
+  renderRunReportJson, // full normalized run model (CI dashboards / PR bots)
   runReportFilename, // deterministic download filename
 } from '../report-render.ts'
 import {
@@ -2419,12 +2420,14 @@ function ObservatoryPanel(props: SlotProps) {
    *  SARIF 2.1.0 (CI / GitHub Code Scanning). Rendered from the SAME shared
    *  data model as the `iterate_report` tool, so the button and the tool can
    *  never disagree. Download-first with a copy fallback, like `exportObservatory`. */
-  const exportReport = (format: 'markdown' | 'sarif') => {
+  const exportReport = (format: 'markdown' | 'sarif' | 'json') => {
     if (!manifest) return
     const extra = { qualityGate, experienceBank, defenseEvents }
     const content = format === 'sarif'
       ? JSON.stringify(renderRunReportSarif(manifest, extra), null, 2)
-      : renderRunReportMarkdown(manifest, extra, { lang: getLang() })
+      : format === 'json'
+        ? JSON.stringify(renderRunReportJson(manifest, extra), null, 2)
+        : renderRunReportMarkdown(manifest, extra, { lang: getLang() })
     const filename = runReportFilename(format)
     const key = `report-${format}`
     const flash = () => {
@@ -3481,8 +3484,8 @@ function ObservatoryPanel(props: SlotProps) {
               title: t('将观测台全部数据导出为 JSON（优先下载，失败则复制）'),
             }, copiedKey === 'export' ? t('已导出') : t('导出 JSON')),
             // v3.9: portable report export — Markdown for a PR body, SARIF for
-            // CI / GitHub Code Scanning. Rendered from the same data model as
-            // the `iterate_report` tool.
+            // CI / GitHub Code Scanning, JSON for CI dashboards / PR bots.
+            // Rendered from the same data model as the `iterate_report` tool.
             React.createElement('button', {
               className: 'iterate-btn', 'data-copied': copiedKey === 'report-markdown' ? '' : undefined,
               onClick: () => exportReport('markdown'),
@@ -3493,6 +3496,14 @@ function ObservatoryPanel(props: SlotProps) {
               onClick: () => exportReport('sarif'),
               title: t('导出 SARIF 2.1.0（供 CI / GitHub Code Scanning 消费）'),
             }, copiedKey === 'report-sarif' ? t('已导出') : t('导出 SARIF')),
+            // v3.11: lossless JSON export — the complete normalized run model
+            // (findings + fixes + validations + quality gate + experience bank
+            // + defense events) for CI dashboards and PR bots.
+            React.createElement('button', {
+              className: 'iterate-btn', 'data-copied': copiedKey === 'report-json' ? '' : undefined,
+              onClick: () => exportReport('json'),
+              title: t('导出完整运行模型的 JSON（供 CI 仪表盘 / PR 机器人消费，无损格式）'),
+            }, copiedKey === 'report-json' ? t('已导出') : t('导出 JSON 报告')),
             // Gap #4: `.iterate/` artifacts are unreachable from the browser;
             // this copies the one instruction that makes the model echo them
             // into the session stream (which is what every panel scans).

package/src/report-render.ts

@@ -20,10 +20,15 @@
  *   - **sarif**    — SARIF 2.1.0 for CI / GitHub Code Scanning (ruleId =
  *     review dimension, severity → error | warning | note, file+line
  *     locations, suggested fix attached).
+ *   - **json**     — the complete normalized run model (see {@link RunReportData})
+ *     as a machine-readable JSON document. This is the ONLY format that carries
+ *     the full model (findings + fixes + validations + quality gate + experience
+ *     bank + defense events) without lossy projection, so CI dashboards and PR
+ *     bots can consume the exact same facts the human report shows.
  */
 
 /** Report formats accepted by the tool and the export buttons. */
-export const REPORT_FORMATS = ['markdown', 'sarif'] as const
+export const REPORT_FORMATS = ['markdown', 'sarif', 'json'] as const
 
 /** Severity ordering (lowest index = most severe). */
 const SEVERITY_ORDER = ['critical', 'high', 'medium', 'low'] as const
@@ -563,6 +568,66 @@ export function renderRunReportSarif(
   }
 }
 
+/**
+ * Render the complete normalized run model as a JSON document.
+ *
+ * This is the lossless format: unlike Markdown (human projection) and SARIF
+ * (findings-only code-scanning log), the JSON carries EVERY fact the run
+ * recorded — findings, fixes, validations, convergence, the quality gate, the
+ * experience bank, and defense events — as structured data. CI dashboards and
+ * PR bots can consume it without re-parsing a human report. A missing or
+ * partial transcript still yields a valid document (empty arrays, null stores),
+ * so an export never fails because a run was interrupted.
+ */
+export interface RunReportJson {
+  $schema: 'iterate-run-report/1'
+  project: string
+  goal: string
+  mode: string | null
+  taskMode: string | null
+  round: number
+  maxRounds: number
+  active: boolean
+  stoppedReason: string | null
+  updatedAt: string
+  convergence: number[]
+  severityCounts: { critical: number; high: number; medium: number; low: number }
+  findings: ReportFinding[]
+  fixes: ReportFix[]
+  validations: ReportValidation[]
+  qualityGate: Record<string, unknown> | null
+  experienceBank: Record<string, unknown> | null
+  defenseEvents: Record<string, unknown> | null
+}
+
+/** Render a JSON document from the same normalized data. */
+export function renderRunReportJson(
+  manifest: unknown,
+  extra?: { qualityGate?: unknown; experienceBank?: unknown; defenseEvents?: unknown } | null,
+): RunReportJson {
+  const data = buildRunReportData(manifest, extra)
+  return {
+    $schema: 'iterate-run-report/1',
+    project: data.project,
+    goal: data.goal,
+    mode: data.mode,
+    taskMode: data.taskMode,
+    round: data.round,
+    maxRounds: data.maxRounds,
+    active: data.active,
+    stoppedReason: data.stoppedReason,
+    updatedAt: data.updatedAt,
+    convergence: data.convergence,
+    severityCounts: data.severityCounts,
+    findings: data.findings,
+    fixes: data.fixes,
+    validations: data.validations,
+    qualityGate: data.qualityGate,
+    experienceBank: data.experienceBank,
+    defenseEvents: data.defenseEvents,
+  }
+}
+
 /**
  * Render a report in the requested format. Unknown formats fall back to
  * Markdown (the tool's default).
@@ -572,8 +637,9 @@ export function renderRunReport(
   manifest: unknown,
   extra?: { qualityGate?: unknown; experienceBank?: unknown; defenseEvents?: unknown } | null,
   opts?: ReportRenderOptions,
-): string | SarifLog {
+): string | SarifLog | RunReportJson {
   if (format === 'sarif') return renderRunReportSarif(manifest, extra, opts)
+  if (format === 'json') return renderRunReportJson(manifest, extra)
   return renderRunReportMarkdown(manifest, extra, opts)
 }
 
@@ -582,7 +648,7 @@ export function renderRunReport(
  * `iterate-report-2026-10-18T01-02-03-000Z.md`.
  */
 export function runReportFilename(format: string, opts?: { now?: string }): string {
-  const ext = format === 'sarif' ? 'sarif' : 'md'
+  const ext = format === 'sarif' ? 'sarif' : format === 'json' ? 'json' : 'md'
   const stamp =
     opts?.now && opts.now ? opts.now.replace(/[:.]/g, '-') : new Date().toISOString().replace(/[:.]/g, '-')
   return `iterate-report-${stamp}.${ext}`