orizu 0.5.18 → 0.5.19

package/dist/diff-comments-cli.js

@@ -1,5 +1,6 @@
 import { extractErrorMessage, isJsonErrorResponsePayload, } from './error-response.js';
 import { sanitizeHumanInlineText } from './json-response.js';
+import { formatFiniteLengthCount, } from './prompt-length-wire.js';
 const DETAIL_LEVELS = ['hunk', 'diff', 'full'];
 const CONTEXT_UNAVAILABLE_WITHOUT_REASON = '    Context unavailable (no reason supplied)';
 function isCandidatePair(pair) {
@@ -47,6 +48,56 @@ function humanLineNumber(ctx, line) {
         ? '-'
         : sanitizeHumanInlineText(ctx.sanitizeTerminalText, String(line + 1));
 }
+function formatStats(stats) {
+    const tokens = formatFiniteLengthCount(stats.tokens);
+    return `${tokens === null ? '—' : `~${tokens}`} tokens · ` +
+        `${formatFiniteLengthCount(stats.lines) ?? '—'} lines · ` +
+        `${formatFiniteLengthCount(stats.chars) ?? '—'} chars · ` +
+        `${formatFiniteLengthCount(stats.words) ?? '—'} words`;
+}
+function formatDeltaValue(value, metric, signed = false) {
+    const formatted = formatFiniteLengthCount(value, signed);
+    if (formatted === null)
+        return '—';
+    return metric === 'tokens' ? `~${formatted}` : formatted;
+}
+function printLengthMeasurements(ctx, pair) {
+    function unavailableSuffix(reason) {
+        if (typeof reason !== 'string' || reason.length === 0)
+            return '';
+        return ` (${sanitizeHumanInlineText(ctx.sanitizeTerminalText, reason)})`;
+    }
+    if (!pair.lengthStats && !pair.lengthDelta) {
+        ctx.printLine(`  Length: unavailable${unavailableSuffix(pair.lengthDeltaUnavailableReason ?? pair.degraded?.reason)}`);
+        return;
+    }
+    if (pair.lengthStats) {
+        ctx.printLine(pair.lengthStats.from
+            ? `  From: ${formatStats(pair.lengthStats.from)}`
+            : `  From: unavailable${unavailableSuffix(pair.lengthStats.fromUnavailableReason)}`);
+        ctx.printLine(pair.lengthStats.to
+            ? `  To: ${formatStats(pair.lengthStats.to)}`
+            : `  To: unavailable${unavailableSuffix(pair.lengthStats.toUnavailableReason)}`);
+    }
+    if (!pair.lengthDelta) {
+        ctx.printLine(`  Length delta: unavailable${unavailableSuffix(pair.lengthDeltaUnavailableReason ?? pair.degraded?.reason)}`);
+        return;
+    }
+    if (pair.lengthDelta.splitUnavailableReason) {
+        ctx.printLine(`  Split unavailable: ${sanitizeHumanInlineText(ctx.sanitizeTerminalText, pair.lengthDelta.splitUnavailableReason)}`);
+    }
+    for (const [metric, label] of [
+        ['tokens', 'Tokens'],
+        ['lines', 'Lines'],
+        ['chars', 'Chars'],
+        ['words', 'Words'],
+    ]) {
+        const delta = pair.lengthDelta[metric];
+        ctx.printLine(`  ${label}: removed ${formatDeltaValue(delta.removed, metric)} · ` +
+            `added ${formatDeltaValue(delta.added, metric)} · ` +
+            `net ${formatDeltaValue(delta.net, metric, true)}`);
+    }
+}
 function buildParams(ctx) {
     const runId = ctx.getArg('--run');
     const promptId = ctx.getArg('--prompt');
@@ -106,6 +157,7 @@ function printDiffComments(ctx, payload) {
         ctx.printLine(`${hasCandidateIds ? 'Candidates' : 'Versions'} ` +
             `${sanitizeHumanInlineText(ctx.sanitizeTerminalText, from)} → ` +
             `${sanitizeHumanInlineText(ctx.sanitizeTerminalText, to)}`);
+        printLengthMeasurements(ctx, pair);
         if (pair.degraded) {
             ctx.printLine(`  Context unavailable: ${sanitizeHumanInlineText(ctx.sanitizeTerminalText, pair.degraded.reason)}`);
         }

package/dist/index.js

@@ -43,6 +43,7 @@ import { runGitCredentialInvocation } from './git-credential.js';
 import { pushPromptDraft } from './prompt-draft-push.js';
 import { readMarkdownReportInput } from './markdown-report-input.js';
 import { promptPushErrorMessage, promptReportCommand } from './prompt-report-cli.js';
+import { printPromptSummaryTable } from './prompt-summary-table.js';
 import { assertSnapshotManifestConfined, verifyGepaRunnerDirsFromArgs, verifyRunnerDirRegistered } from './runner-dir-verify.js';
 import { runScorersRegister } from './scorer-draft-push.js';
 import { runZipArtifactPush } from './zip-draft-push.js';
@@ -246,27 +247,6 @@ export function formatTerminalLink(url) {
 function shellQuote(value) {
     return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
 }
-function printPromptSummaries(items, emptyMessage) {
-    if (items.length === 0) {
-        printLine(emptyMessage);
-        return;
-    }
-    const rows = items.map(item => ({
-        id: sanitizeTerminalText(item.id),
-        name: sanitizeTerminalText(item.name),
-        role: sanitizeTerminalText(item.role),
-        status: sanitizeTerminalText(item.status || 'active'),
-    }));
-    const idWidth = Math.max('ID'.length, ...rows.map(row => row.id.length));
-    const nameWidth = Math.max('NAME'.length, ...rows.map(row => row.name.length));
-    const roleWidth = Math.max('ROLE'.length, ...rows.map(row => row.role.length));
-    const statusWidth = Math.max('STATUS'.length, ...rows.map(row => row.status.length));
-    printLine(`${'ID'.padEnd(idWidth)}  ${'NAME'.padEnd(nameWidth)}  ${'ROLE'.padEnd(roleWidth)}  ${'STATUS'.padEnd(statusWidth)}`);
-    printLine(`${'-'.repeat(idWidth)}  ${'-'.repeat(nameWidth)}  ${'-'.repeat(roleWidth)}  ${'-'.repeat(statusWidth)}`);
-    rows.forEach(row => {
-        printLine(`${row.id.padEnd(idWidth)}  ${row.name.padEnd(nameWidth)}  ${row.role.padEnd(roleWidth)}  ${row.status.padEnd(statusWidth)}`);
-    });
-}
 function readJsonObjectArg(valueArg, label) {
     if (!valueArg) {
         return {};
@@ -905,7 +885,7 @@ async function listPrompts() {
         printJson(data);
         return;
     }
-    printPromptSummaries(data.prompts, 'No prompts found.');
+    printPromptSummaryTable(data.prompts, 'No prompts found.', printLine);
 }
 async function listJudges() {
     const project = getArg('--project') || await resolveProjectSlug(null);
@@ -923,7 +903,7 @@ async function listJudges() {
         printJson(data);
         return;
     }
-    printPromptSummaries(data.judges, 'No judges found.');
+    printPromptSummaryTable(data.judges, 'No judges found.', printLine);
 }
 async function listScorers() {
     const project = getArg('--project') || await resolveProjectSlug(null);

package/dist/prompt-length-wire.js

@@ -0,0 +1,30 @@
+export const CLI_LENGTH_STATS_FIELDS = [
+    'tokens',
+    'lines',
+    'chars',
+    'words',
+];
+export const CLI_LENGTH_DELTA_SPLIT_UNAVAILABLE_REASONS = [
+    'diff_degraded_size_limit',
+    'diff_degraded_cell_limit',
+];
+export const CLI_LENGTH_MEASUREMENT_UNAVAILABLE_REASONS = [
+    'length_measurement_size_limit',
+    'length_measurement_failed',
+    'body_resolution_failed',
+    'measurement_cap_exceeded',
+    'enrichment_failed',
+    'bodies_unavailable_event_cap',
+];
+export function formatFiniteLengthCount(value, signed = false) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return null;
+    const formatted = Math.abs(value).toLocaleString('en-US');
+    if (!signed)
+        return formatted;
+    if (value > 0)
+        return `+${formatted}`;
+    if (value < 0)
+        return `-${formatted}`;
+    return formatted;
+}

package/dist/prompt-summary-table.js

@@ -0,0 +1,37 @@
+import { sanitizeTerminalText } from './json-response.js';
+import { formatFiniteLengthCount, } from './prompt-length-wire.js';
+export function printPromptSummaryTable(items, emptyMessage, printLine) {
+    if (items.length === 0) {
+        printLine(emptyMessage);
+        return;
+    }
+    const rows = items.map(item => ({
+        id: sanitizeTerminalText(item.id),
+        name: sanitizeTerminalText(item.name),
+        role: sanitizeTerminalText(item.role),
+        status: sanitizeTerminalText(item.status || 'active'),
+        tokens: item.lengthStats == null
+            ? '—'
+            : (() => {
+                const count = formatFiniteLengthCount(item.lengthStats.tokens);
+                return count === null ? '—' : `~${count}`;
+            })(),
+        lines: item.lengthStats == null
+            ? '—'
+            : formatFiniteLengthCount(item.lengthStats.lines) ?? '—',
+        chars: item.lengthStats == null
+            ? '—'
+            : formatFiniteLengthCount(item.lengthStats.chars) ?? '—',
+        words: item.lengthStats == null
+            ? '—'
+            : formatFiniteLengthCount(item.lengthStats.words) ?? '—',
+    }));
+    const headers = ['ID', 'NAME', 'ROLE', 'STATUS', 'TOKENS', 'LINES', 'CHARS', 'WORDS'];
+    const keys = ['id', 'name', 'role', 'status', 'tokens', 'lines', 'chars', 'words'];
+    const widths = keys.map((key, index) => Math.max(headers[index].length, ...rows.map(row => row[key].length)));
+    printLine(headers.map((header, index) => header.padEnd(widths[index])).join('  '));
+    printLine(widths.map(width => '-'.repeat(width)).join('  '));
+    rows.forEach(row => {
+        printLine(keys.map((key, index) => row[key].padEnd(widths[index])).join('  '));
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orizu",
-  "version": "0.5.18",
+  "version": "0.5.19",
   "private": false,
   "type": "module",
   "bin": {

package/src/diff-comments-cli.ts

@@ -3,6 +3,13 @@ import {
   isJsonErrorResponsePayload,
 } from './error-response.js'
 import { sanitizeHumanInlineText } from './json-response.js'
+import {
+  formatFiniteLengthCount,
+  type CliLengthDelta,
+  type CliLengthMeasurementUnavailableReason,
+  type CliLengthStats,
+  type CliLengthStatsPair,
+} from './prompt-length-wire.js'
 
 interface DiffCommentAuthor {
   name?: string
@@ -42,6 +49,9 @@ interface DiffCommentPayloadPairContext {
   diff: string | null
   bodies: { from: string; to: string } | null
   degraded: { reason: DiffCommentContextUnavailableReason } | null
+  lengthStats: CliLengthStatsPair | null
+  lengthDelta: CliLengthDelta | null
+  lengthDeltaUnavailableReason?: CliLengthMeasurementUnavailableReason
   comments: DiffCommentPayloadComment[]
 }
 
@@ -143,6 +153,86 @@ function humanLineNumber(
     : sanitizeHumanInlineText(ctx.sanitizeTerminalText, String(line + 1))
 }
 
+function formatStats(stats: CliLengthStats): string {
+  const tokens = formatFiniteLengthCount(stats.tokens)
+  return `${tokens === null ? '—' : `~${tokens}`} tokens · ` +
+    `${formatFiniteLengthCount(stats.lines) ?? '—'} lines · ` +
+    `${formatFiniteLengthCount(stats.chars) ?? '—'} chars · ` +
+    `${formatFiniteLengthCount(stats.words) ?? '—'} words`
+}
+
+function formatDeltaValue(
+  value: number | null,
+  metric: keyof Omit<CliLengthDelta, 'splitUnavailableReason'>,
+  signed = false
+): string {
+  const formatted = formatFiniteLengthCount(value, signed)
+  if (formatted === null) return '—'
+  return metric === 'tokens' ? `~${formatted}` : formatted
+}
+
+function printLengthMeasurements(
+  ctx: DiffCommentsCliContext,
+  pair: DiffCommentPayloadPair
+) {
+  function unavailableSuffix(reason: unknown): string {
+    if (typeof reason !== 'string' || reason.length === 0) return ''
+    return ` (${sanitizeHumanInlineText(ctx.sanitizeTerminalText, reason)})`
+  }
+
+  if (!pair.lengthStats && !pair.lengthDelta) {
+    ctx.printLine(
+      `  Length: unavailable${unavailableSuffix(
+        pair.lengthDeltaUnavailableReason ?? pair.degraded?.reason
+      )}`
+    )
+    return
+  }
+
+  if (pair.lengthStats) {
+    ctx.printLine(pair.lengthStats.from
+      ? `  From: ${formatStats(pair.lengthStats.from)}`
+      : `  From: unavailable${unavailableSuffix(
+        pair.lengthStats.fromUnavailableReason
+      )}`)
+    ctx.printLine(pair.lengthStats.to
+      ? `  To: ${formatStats(pair.lengthStats.to)}`
+      : `  To: unavailable${unavailableSuffix(
+        pair.lengthStats.toUnavailableReason
+      )}`)
+  }
+  if (!pair.lengthDelta) {
+    ctx.printLine(
+      `  Length delta: unavailable${unavailableSuffix(
+        pair.lengthDeltaUnavailableReason ?? pair.degraded?.reason
+      )}`
+    )
+    return
+  }
+
+  if (pair.lengthDelta.splitUnavailableReason) {
+    ctx.printLine(
+      `  Split unavailable: ${sanitizeHumanInlineText(
+        ctx.sanitizeTerminalText,
+        pair.lengthDelta.splitUnavailableReason
+      )}`
+    )
+  }
+  for (const [metric, label] of [
+    ['tokens', 'Tokens'],
+    ['lines', 'Lines'],
+    ['chars', 'Chars'],
+    ['words', 'Words'],
+  ] as const) {
+    const delta = pair.lengthDelta[metric]
+    ctx.printLine(
+      `  ${label}: removed ${formatDeltaValue(delta.removed, metric)} · ` +
+      `added ${formatDeltaValue(delta.added, metric)} · ` +
+      `net ${formatDeltaValue(delta.net, metric, true)}`
+    )
+  }
+}
+
 function buildParams(ctx: DiffCommentsCliContext): URLSearchParams {
   const runId = ctx.getArg('--run')
   const promptId = ctx.getArg('--prompt')
@@ -210,6 +300,7 @@ function printDiffComments(ctx: DiffCommentsCliContext, payload: DiffCommentsPay
       `${sanitizeHumanInlineText(ctx.sanitizeTerminalText, from)} → ` +
       `${sanitizeHumanInlineText(ctx.sanitizeTerminalText, to)}`
     )
+    printLengthMeasurements(ctx, pair)
     if (pair.degraded) {
       ctx.printLine(
         `  Context unavailable: ${sanitizeHumanInlineText(ctx.sanitizeTerminalText, pair.degraded.reason)}`

package/src/index.ts

@@ -88,6 +88,11 @@ import { runGitCredentialInvocation } from './git-credential.js'
 import { pushPromptDraft } from './prompt-draft-push.js'
 import { readMarkdownReportInput } from './markdown-report-input.js'
 import { promptPushErrorMessage, promptReportCommand } from './prompt-report-cli.js'
+import { printPromptSummaryTable } from './prompt-summary-table.js'
+import type {
+  CliLengthMeasurementUnavailableReason,
+  CliLengthStats,
+} from './prompt-length-wire.js'
 import { assertSnapshotManifestConfined, verifyGepaRunnerDirsFromArgs, verifyRunnerDirRegistered } from './runner-dir-verify.js'
 import { runScorersRegister } from './scorer-draft-push.js'
 import { runZipArtifactPush } from './zip-draft-push.js'
@@ -182,6 +187,10 @@ interface PromptSummary {
   status?: string
   archivedAt?: string | null
   description?: string | null
+  lengthStats?: CliLengthStats | null
+  lengthStatsUnavailableReason?: CliLengthMeasurementUnavailableReason
+  lengthStatsVersionId?: string
+  lengthStatsVersionNumber?: number
 }
 
 interface TaskReportPayload {
@@ -536,30 +545,6 @@ function shellQuote(value: string): string {
   return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`
 }
 
-function printPromptSummaries(items: PromptSummary[], emptyMessage: string) {
-  if (items.length === 0) {
-    printLine(emptyMessage)
-    return
-  }
-
-  const rows = items.map(item => ({
-    id: sanitizeTerminalText(item.id),
-    name: sanitizeTerminalText(item.name),
-    role: sanitizeTerminalText(item.role),
-    status: sanitizeTerminalText(item.status || 'active'),
-  }))
-  const idWidth = Math.max('ID'.length, ...rows.map(row => row.id.length))
-  const nameWidth = Math.max('NAME'.length, ...rows.map(row => row.name.length))
-  const roleWidth = Math.max('ROLE'.length, ...rows.map(row => row.role.length))
-  const statusWidth = Math.max('STATUS'.length, ...rows.map(row => row.status.length))
-
-  printLine(`${'ID'.padEnd(idWidth)}  ${'NAME'.padEnd(nameWidth)}  ${'ROLE'.padEnd(roleWidth)}  ${'STATUS'.padEnd(statusWidth)}`)
-  printLine(`${'-'.repeat(idWidth)}  ${'-'.repeat(nameWidth)}  ${'-'.repeat(roleWidth)}  ${'-'.repeat(statusWidth)}`)
-  rows.forEach(row => {
-    printLine(`${row.id.padEnd(idWidth)}  ${row.name.padEnd(nameWidth)}  ${row.role.padEnd(roleWidth)}  ${row.status.padEnd(statusWidth)}`)
-  })
-}
-
 function readJsonObjectArg(valueArg: string | null, label: string): Record<string, unknown> {
   if (!valueArg) {
     return {}
@@ -1383,7 +1368,7 @@ async function listPrompts() {
     printJson(data as unknown as Record<string, unknown>)
     return
   }
-  printPromptSummaries(data.prompts, 'No prompts found.')
+  printPromptSummaryTable(data.prompts, 'No prompts found.', printLine)
 }
 
 async function listJudges() {
@@ -1404,7 +1389,7 @@ async function listJudges() {
     printJson(data as unknown as Record<string, unknown>)
     return
   }
-  printPromptSummaries(data.judges, 'No judges found.')
+  printPromptSummaryTable(data.judges, 'No judges found.', printLine)
 }
 
 async function listScorers() {

package/src/prompt-length-wire.ts

@@ -0,0 +1,65 @@
+export const CLI_LENGTH_STATS_FIELDS = [
+  'tokens',
+  'lines',
+  'chars',
+  'words',
+] as const
+
+export const CLI_LENGTH_DELTA_SPLIT_UNAVAILABLE_REASONS = [
+  'diff_degraded_size_limit',
+  'diff_degraded_cell_limit',
+] as const
+export const CLI_LENGTH_MEASUREMENT_UNAVAILABLE_REASONS = [
+  'length_measurement_size_limit',
+  'length_measurement_failed',
+  'body_resolution_failed',
+  'measurement_cap_exceeded',
+  'enrichment_failed',
+  'bodies_unavailable_event_cap',
+] as const
+
+export type CliLengthStatsField = typeof CLI_LENGTH_STATS_FIELDS[number]
+export type CliLengthDeltaSplitUnavailableReason =
+  typeof CLI_LENGTH_DELTA_SPLIT_UNAVAILABLE_REASONS[number]
+export type CliLengthMeasurementUnavailableReason =
+  typeof CLI_LENGTH_MEASUREMENT_UNAVAILABLE_REASONS[number]
+
+export interface CliLengthStats {
+  tokens: number
+  lines: number
+  chars: number
+  words: number
+}
+
+export interface CliLengthStatsPair {
+  from: CliLengthStats | null
+  to: CliLengthStats | null
+  fromUnavailableReason?: CliLengthMeasurementUnavailableReason
+  toUnavailableReason?: CliLengthMeasurementUnavailableReason
+}
+
+export interface CliLengthMetricDelta {
+  removed: number | null
+  added: number | null
+  net: number
+}
+
+export interface CliLengthDelta extends Record<
+  CliLengthStatsField,
+  CliLengthMetricDelta
+> {
+  splitUnavailableReason: CliLengthDeltaSplitUnavailableReason | null
+}
+
+export function formatFiniteLengthCount(
+  value: unknown,
+  signed = false
+): string | null {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return null
+
+  const formatted = Math.abs(value).toLocaleString('en-US')
+  if (!signed) return formatted
+  if (value > 0) return `+${formatted}`
+  if (value < 0) return `-${formatted}`
+  return formatted
+}

package/src/prompt-summary-table.ts

@@ -0,0 +1,57 @@
+import { sanitizeTerminalText } from './json-response.js'
+import {
+  formatFiniteLengthCount,
+  type CliLengthStats,
+} from './prompt-length-wire.js'
+
+interface PromptSummaryRow {
+  id: string
+  name: string
+  role: string
+  status?: string
+  lengthStats?: CliLengthStats | null
+}
+
+export function printPromptSummaryTable(
+  items: PromptSummaryRow[],
+  emptyMessage: string,
+  printLine: (line: string) => void
+) {
+  if (items.length === 0) {
+    printLine(emptyMessage)
+    return
+  }
+
+  const rows = items.map(item => ({
+    id: sanitizeTerminalText(item.id),
+    name: sanitizeTerminalText(item.name),
+    role: sanitizeTerminalText(item.role),
+    status: sanitizeTerminalText(item.status || 'active'),
+    tokens: item.lengthStats == null
+      ? '—'
+      : (() => {
+          const count = formatFiniteLengthCount(item.lengthStats.tokens)
+          return count === null ? '—' : `~${count}`
+        })(),
+    lines: item.lengthStats == null
+      ? '—'
+      : formatFiniteLengthCount(item.lengthStats.lines) ?? '—',
+    chars: item.lengthStats == null
+      ? '—'
+      : formatFiniteLengthCount(item.lengthStats.chars) ?? '—',
+    words: item.lengthStats == null
+      ? '—'
+      : formatFiniteLengthCount(item.lengthStats.words) ?? '—',
+  }))
+  const headers = ['ID', 'NAME', 'ROLE', 'STATUS', 'TOKENS', 'LINES', 'CHARS', 'WORDS']
+  const keys = ['id', 'name', 'role', 'status', 'tokens', 'lines', 'chars', 'words'] as const
+  const widths = keys.map((key, index) =>
+    Math.max(headers[index].length, ...rows.map(row => row[key].length))
+  )
+
+  printLine(headers.map((header, index) => header.padEnd(widths[index])).join('  '))
+  printLine(widths.map(width => '-'.repeat(width)).join('  '))
+  rows.forEach(row => {
+    printLine(keys.map((key, index) => row[key].padEnd(widths[index])).join('  '))
+  })
+}

package/vendor/skills/orizu-cli/references/cli-reference.md

@@ -290,6 +290,15 @@ orizu comments diff --prompt <prompt-id> [--from <version> --to <version>] [--de
 Exactly one target is required, and `--from` / `--to` must appear together.
 Prompt pair selectors are integer version numbers. Human output groups comments
 by pair and renders anchored hunks; `--json` emits the complete machine payload.
+Each available side prints `From:` or `To:` length stats; one side can be
+`unavailable (<reason>)` while the other remains visible. Machine output allows
+`lengthStats.from` and `lengthStats.to` to be independently null and names the
+side failures in `fromUnavailableReason` and `toUnavailableReason`. A wholly
+unavailable pair prints `Length: unavailable (<reason>)`; a missing delta
+prints `Length delta: unavailable`. Otherwise `Tokens:`, `Lines:`, `Chars:`,
+and `Words:` show removed/added/net rows. A `Split unavailable:` row names the
+exact guard when split churn cannot be computed; removed/added are `—` but the
+independent net remains numeric.
 Unrecoverable context is retained with a named degradation reason rather than
 dropping a comment. Optimization export includes the same data at
 `diffComments` using hunk detail. It also includes
@@ -313,6 +322,7 @@ Behavior:
 - `run-gepa` writes a complete local trace under `logs/<optimization_run_id>` by default.
 - The local trace is the best artifact for coding-agent analysis because it includes full rows, outputs, scores, feedback, scorer responses, reflection prompts, reflection responses, candidate text, and `result.json`.
 - `optimizations export` writes a portable JSON artifact from server data when the local log is unavailable or the run happened elsewhere.
+- The v1 export preserves the run row's `best_candidate_id` in `summary.bestCandidateId` when event derivation rejects it as unknown; candidate detail may be absent, and the field is `null` when neither source names a best candidate.
 - Server optimization events redact row snapshots and reflection prompts by default; export rehydrates row inputs from dataset artifacts when possible and includes bundled `run-gepa` reflection responses.
 
 ## End-to-End Flows

package/vendor/skills/orizu-cli/references/prompt-control-plane.md

@@ -413,6 +413,20 @@ orizu --local judges list --project <team>/<project>
 Prompt and judge lists show active artifacts by default. Use `--status archived`
 or `--status all` when you need archived artifacts.
 
+Prompt and judge list tables include `ID`, `NAME`, `ROLE`, `STATUS`, `TOKENS`,
+`LINES`, `CHARS`, and `WORDS`, measured from the latest sealed version. `—`
+means the canonical body could not be measured; zero remains `0`. The `~`
+prefix on token counts means approximate: Orizu uses one fixed, model-agnostic
+`gpt-tokenizer` encoding rather than claiming an exact count for every model.
+Failed or deliberately skipped JSON enrichment carries a named
+`lengthStatsUnavailableReason`. Measured summaries also include
+`lengthStatsVersionId` and `lengthStatsVersionNumber`, identifying the latest
+sealed version behind each measurement even when the canonical body could not
+be measured. Length enrichment is best-effort: a supporting query failure
+leaves the list available with null stats and `enrichment_failed`. At most the
+first 500 sorted summaries are enriched per request; later summaries carry
+null stats and `measurement_cap_exceeded`.
+
 Archive or restore a prompt:
 
 ```bash
@@ -742,6 +756,11 @@ orizu --local optimizations export <optimization-run-id> \
 
 Use export when the local log is unavailable, the run happened on another machine, or a coding agent needs a portable single JSON artifact. The export fetches all optimization events, derives seed vs best, Pareto frontier, score-over-time, candidates, iterations, minibatch rows, and validation rows, and rehydrates row inputs from the dataset version artifact when possible. Server events may not contain row snapshots or reflection prompts unless the run used `--log-row-snapshots`; reflection responses are included for bundled `run-gepa` runs.
 
+The v1 export keeps the run row's `best_candidate_id` in
+`summary.bestCandidateId` when event derivation rejects that identifier as an
+unknown candidate. Candidate detail can therefore be absent for the preserved
+identifier. If neither source names a best candidate, the field is `null`.
+
 Lifecycle controls:
 
 ```bash