checkpoint

⚒️ Generated with [Fabro](https://fabro.sh)

stages/006-simplify_opus@1/diff.patch

@@ -0,0 +1,284 @@
+diff --git a/apps/fabro-web/app/components/run-summary-panel.test.tsx b/apps/fabro-web/app/components/run-summary-panel.test.tsx
+index 56e4c3171..3d7175d9d 100644
+--- a/apps/fabro-web/app/components/run-summary-panel.test.tsx
++++ b/apps/fabro-web/app/components/run-summary-panel.test.tsx
+@@ -6,6 +6,7 @@ import {
+   RunSummaryPanelView,
+   type RunSummaryPanelViewProps,
+ } from "./run-summary-panel";
++import { testPrincipal } from "../lib/test-fixtures";
+ 
+ function instanceText(instance: TestRenderer.ReactTestInstance): string {
+   const parts: string[] = [];
+@@ -52,15 +53,10 @@ function cellAfterLabel(
+ 
+ function makeRun(overrides: Record<string, any> = {}) {
+   return {
+-    id: "run_1",
+-    created_by: {
+-      kind:        "user",
+-      identity:    { issuer: "fabro:test", subject: "test-user" },
+-      login:       "test",
+-      auth_method: "dev_token",
+-    },
+-    diff:    null,
+-    billing: null,
++    id:         "run_1",
++    created_by: testPrincipal(),
++    diff:       null,
++    billing:    null,
+     ...overrides,
+   } as any;
+ }
+diff --git a/apps/fabro-web/app/data/runs.test.ts b/apps/fabro-web/app/data/runs.test.ts
+index e8a461cf3..adff4a1a0 100644
+--- a/apps/fabro-web/app/data/runs.test.ts
++++ b/apps/fabro-web/app/data/runs.test.ts
+@@ -1,5 +1,5 @@
+ import { describe, expect, test } from "bun:test";
+-import type { Principal, Run, RunStatus as ApiRunStatus } from "@qltysh/fabro-api-client";
++import type { Run, RunStatus as ApiRunStatus } from "@qltysh/fabro-api-client";
+ import {
+   columnForStatus,
+   columnStatusDisplay,
+@@ -8,15 +8,7 @@ import {
+   mapRunToRunItem,
+   runStatusDisplay,
+ } from "./runs";
+-
+-function testPrincipal(): Principal {
+-  return {
+-    kind:        "user",
+-    identity:    { issuer: "fabro:test", subject: "test-user" },
+-    login:       "test",
+-    auth_method: "dev_token",
+-  };
+-}
++import { testPrincipal } from "../lib/test-fixtures";
+ 
+ function makeRun(overrides: Partial<Run> = {}): Run {
+   return {
+diff --git a/apps/fabro-web/app/lib/run-actions.test.ts b/apps/fabro-web/app/lib/run-actions.test.ts
+index d8745f19b..a13afd650 100644
+--- a/apps/fabro-web/app/lib/run-actions.test.ts
++++ b/apps/fabro-web/app/lib/run-actions.test.ts
+@@ -24,13 +24,7 @@ import {
+   unarchiveRuns,
+ } from "./run-actions";
+ import { generatedAxios } from "./api-client";
+-
+-const TEST_PRINCIPAL = {
+-  kind:        "user",
+-  identity:    { issuer: "fabro:test", subject: "test-user" },
+-  login:       "test",
+-  auth_method: "dev_token",
+-};
++import { testPrincipal } from "./test-fixtures";
+ 
+ type StubResponseInit = {
+   status: number;
+@@ -54,7 +48,7 @@ function makeRun(status: RunStatus, archived = false): Run {
+     workflow:         { slug: "fix_build", name: "Fix Build", graph_name: null, node_count: 0, edge_count: 0 },
+     automation:       null,
+     repository:       null,
+-    created_by:       TEST_PRINCIPAL,
++    created_by:       testPrincipal(),
+     origin:           { kind: "api" },
+     labels:           {},
+     lifecycle:        {
+diff --git a/apps/fabro-web/app/lib/test-fixtures.ts b/apps/fabro-web/app/lib/test-fixtures.ts
+new file mode 100644
+index 000000000..3d669dcad
+--- /dev/null
++++ b/apps/fabro-web/app/lib/test-fixtures.ts
+@@ -0,0 +1,10 @@
++import type { Principal } from "@qltysh/fabro-api-client";
++
++export function testPrincipal(): Principal {
++  return {
++    kind:        "user",
++    identity:    { issuer: "fabro:test", subject: "test-user" },
++    login:       "test",
++    auth_method: "dev_token",
++  };
++}
+diff --git a/apps/fabro-web/app/routes/automations-new.test.tsx b/apps/fabro-web/app/routes/automations-new.test.tsx
+index 9667247b8..69f8ae58f 100644
+--- a/apps/fabro-web/app/routes/automations-new.test.tsx
++++ b/apps/fabro-web/app/routes/automations-new.test.tsx
+@@ -4,6 +4,7 @@ import TestRenderer, { act } from "react-test-renderer";
+ import { createMemoryRouter, RouterProvider } from "react-router";
+ 
+ import { ToastProvider } from "../components/toast";
++import { testPrincipal } from "../lib/test-fixtures";
+ import { setupReactTestEnv } from "../lib/test-utils";
+ 
+ let currentRun: any = null;
+@@ -101,13 +102,6 @@ mock.module("swr", () => ({
+ const { default: AutomationsNew } = await import("./automations-new");
+ mock.restore();
+ 
+-const TEST_PRINCIPAL = {
+-  kind:        "user",
+-  identity:    { issuer: "fabro:test", subject: "test-user" },
+-  login:       "test",
+-  auth_method: "dev_token",
+-};
+-
+ function makeRun(overrides: Record<string, unknown> = {}) {
+   return {
+     id:               "run_1",
+@@ -127,7 +121,7 @@ function makeRun(overrides: Record<string, unknown> = {}) {
+       origin_url: "https://github.com/fallback/repo.git",
+       provider:   "github",
+     },
+-    created_by:       TEST_PRINCIPAL,
++    created_by:       testPrincipal(),
+     origin:           { kind: "api" },
+     labels:           {},
+     lifecycle:        {
+diff --git a/apps/fabro-web/app/routes/run-detail.test.ts b/apps/fabro-web/app/routes/run-detail.test.ts
+index 1fc2a775f..3cc8ad351 100644
+--- a/apps/fabro-web/app/routes/run-detail.test.ts
++++ b/apps/fabro-web/app/routes/run-detail.test.ts
+@@ -13,6 +13,7 @@ import {
+ 
+ import { ToastProvider } from "../components/toast";
+ import { DemoModeProvider } from "../lib/demo-mode";
++import { testPrincipal } from "../lib/test-fixtures";
+ 
+ let currentRunSummary: any = null;
+ let currentRunState: any = null;
+@@ -20,13 +21,6 @@ let currentQuestions: any[] = [];
+ let deleteRunApiResult: Promise<unknown> | null = null;
+ const mountedRenderers: TestRenderer.ReactTestRenderer[] = [];
+ 
+-const TEST_PRINCIPAL = {
+-  kind:        "user",
+-  identity:    { issuer: "fabro:test", subject: "test-user" },
+-  login:       "test",
+-  auth_method: "dev_token",
+-};
+-
+ const deleteRunApiMock = mock((_id: string) =>
+   deleteRunApiResult ?? Promise.resolve({}),
+ );
+@@ -228,7 +222,7 @@ function makeRunSummary({
+     workflow:         { slug: "default", name: "Default", graph_name: null, node_count: 0, edge_count: 0 },
+     automation,
+     repository:       { name: "fabro", origin_url: null, provider: "unknown" },
+-    created_by:       TEST_PRINCIPAL,
++    created_by:       testPrincipal(),
+     origin:           { kind: "api" },
+     labels:           {},
+     lifecycle:        {
+diff --git a/apps/fabro-web/app/routes/run-files.render.test.tsx b/apps/fabro-web/app/routes/run-files.render.test.tsx
+index 9b4cb1a08..1b434d76b 100644
+--- a/apps/fabro-web/app/routes/run-files.render.test.tsx
++++ b/apps/fabro-web/app/routes/run-files.render.test.tsx
+@@ -5,13 +5,7 @@ import { MemoryRouter, Route, Routes } from "react-router";
+ import { toast as sonnerToast } from "sonner";
+ 
+ import { ToastProvider } from "../components/toast";
+-
+-const TEST_PRINCIPAL = {
+-  kind:        "user",
+-  identity:    { issuer: "fabro:test", subject: "test-user" },
+-  login:       "test",
+-  auth_method: "dev_token",
+-};
++import { testPrincipal } from "../lib/test-fixtures";
+ 
+ let currentFilesPayload: any = null;
+ let currentCommitsPayload: any = null;
+@@ -58,7 +52,7 @@ mock.module("../lib/queries", () => ({
+       workflow:         { slug: "default", name: "Default", graph_name: null, node_count: 0, edge_count: 0 },
+       automation:       null,
+       repository:       { name: "fabro", origin_url: null, provider: "unknown" },
+-      created_by:       TEST_PRINCIPAL,
++      created_by:       testPrincipal(),
+       origin:           { kind: "api" },
+       labels:           {},
+       lifecycle:        {
+diff --git a/apps/fabro-web/app/routes/runs.preferences.test.tsx b/apps/fabro-web/app/routes/runs.preferences.test.tsx
+index 21af44aef..fd217d152 100644
+--- a/apps/fabro-web/app/routes/runs.preferences.test.tsx
++++ b/apps/fabro-web/app/routes/runs.preferences.test.tsx
+@@ -1,10 +1,11 @@
+ import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
+ import TestRenderer, { act } from "react-test-renderer";
+ import { createMemoryRouter, RouterProvider } from "react-router";
+-import type { PaginatedRunList, Principal, Run } from "@qltysh/fabro-api-client";
++import type { PaginatedRunList, Run } from "@qltysh/fabro-api-client";
+ 
+ import { ToastProvider } from "../components/toast";
+ import { CHILD_RUNS_LIST_PREFERENCES_STORAGE_KEY } from "../components/runs-list/preferences";
++import { testPrincipal } from "../lib/test-fixtures";
+ import { setupReactTestEnv } from "../lib/test-utils";
+ 
+ class MemoryStorage {
+@@ -27,15 +28,6 @@ let previousElement: unknown;
+ let hadElement = false;
+ const mountedRenderers: TestRenderer.ReactTestRenderer[] = [];
+ 
+-function testPrincipal(): Principal {
+-  return {
+-    kind:        "user",
+-    identity:    { issuer: "fabro:test", subject: "test-user" },
+-    login:       "test",
+-    auth_method: "dev_token",
+-  };
+-}
+-
+ function run(id: string, repo = "qlty/fabro", workflow = "release"): Run {
+   return {
+     id,
+diff --git a/apps/fabro-web/app/routes/runs.test.tsx b/apps/fabro-web/app/routes/runs.test.tsx
+index 6f71938c9..e20e018ed 100644
+--- a/apps/fabro-web/app/routes/runs.test.tsx
++++ b/apps/fabro-web/app/routes/runs.test.tsx
+@@ -1,5 +1,5 @@
+ import { describe, expect, test } from "bun:test";
+-import type { BoardColumn, Principal, Run } from "@qltysh/fabro-api-client";
++import type { BoardColumn, Run } from "@qltysh/fabro-api-client";
+ 
+ import {
+   buildBoardColumns,
+@@ -11,15 +11,7 @@ import {
+   shouldRefreshBoardForEvent,
+ } from "./runs";
+ import { summarizeBatchLifecycleAction } from "../components/runs-list/batch-lifecycle";
+-
+-function testPrincipal(): Principal {
+-  return {
+-    kind:        "user",
+-    identity:    { issuer: "fabro:test", subject: "test-user" },
+-    login:       "test",
+-    auth_method: "dev_token",
+-  };
+-}
++import { testPrincipal } from "../lib/test-fixtures";
+ 
+ function boardRun(id: string, column: BoardColumn, questionText?: string): Run {
+   const status =
+diff --git a/lib/crates/fabro-cli/tests/it/cmd/support.rs b/lib/crates/fabro-cli/tests/it/cmd/support.rs
+index 93ad4d6a9..4625cb81c 100644
+--- a/lib/crates/fabro-cli/tests/it/cmd/support.rs
++++ b/lib/crates/fabro-cli/tests/it/cmd/support.rs
+@@ -177,15 +177,7 @@ pub(crate) fn remote_run_summary_json(
+             "origin_url": null,
+             "provider": "unknown"
+         },
+-        "created_by": {
+-            "kind": "user",
+-            "identity": {
+-                "issuer": "fabro:test",
+-                "subject": "test-user"
+-            },
+-            "login": "test",
+-            "auth_method": "dev_token"
+-        },
++        "created_by": fabro_types::test_support::test_principal(),
+         "origin": {
+             "kind": "api"
+         },

stages/006-simplify_opus@1/status.json

@@ -0,0 +1,6 @@
+{
+  "outcome": "succeeded",
+  "notes": "Stage completed: simplify_opus",
+  "failure_reason": null,
+  "timestamp": "2026-06-04T23:26:07.508023Z"
+}

stages/007-simplify_gpt@1/prompt.md

@@ -0,0 +1,337 @@
+Goal: # Plan: Make run actors and provenance total
+
+## Context
+
+This is a greenfield app. Backward compatibility with old serialized runs, old API clients, old generated models, and old tests is not a constraint. Prefer the clean invariant and remove all traces of the placeholder shape.
+
+`Principal::Anonymous` currently represents "no authenticated actor on this request" inside auth middleware. That is auth state, not an actor. A `Principal` should only mean "who acted."
+
+Likewise, a persisted run should always have a creator. `Run.created_by`, `RunSpec.provenance`, `RunProvenance.subject`, and `run.created` event provenance should all be total. No `Option<Principal>`, no nullable OpenAPI fields, no legacy deserialization defaults, and no fallback creator in projection code.
+
+Two commits, in order.
+
+---
+
+## Commit 1 - Remove `Principal::Anonymous`
+
+Breaking cleanup. `Principal` becomes actor-only. Missing/invalid auth is represented as absent request principal, not as an anonymous principal variant.
+
+### Rust
+
+`lib/crates/fabro-types/src/principal.rs`:
+- Drop `Anonymous`.
+- Drop `Anonymous` arms in `kind()` and `display()`.
+- Delete anonymous serialization/round-trip test coverage.
+
+`lib/crates/fabro-server/src/principal_middleware.rs`:
+- `RequestAuthContext.principal: Principal` -> `Option<Principal>`.
+- `RequestAuthLogContext.principal: Principal` -> `Option<Principal>`.
+- `initial()` and `rejected()` set `principal: None`.
+- `authenticated(...)`, `authenticated_worker(...)`, and `authenticated_user(...)` set `principal: Some(...)`.
+- Update `principal_without_log_unused_fields` to preserve `None` and strip user avatar data only inside `Some(Principal::User(...))`.
+- Update all gate helpers to match `Option<Principal>`:
+  - `require_user`
+  - `require_authenticated_user`
+  - `require_run_management_actor`
+  - `require_worker_or_user_for_run`
+  - `require_run_management_target`
+- `None` routes to the existing `auth_rejection(context.auth_status, context.auth_error_code)` behavior.
+- `Some(Principal::Worker { .. })` keeps the current forbidden-vs-auth-rejection distinctions.
+- Update tests that assert the initial/rejected principal to assert `None`.
+
+`lib/crates/fabro-server/src/server.rs` HTTP logging:
+- Keep the `principal_kind` field on every HTTP log line.
+- Compute `principal_kind` as `auth_context.principal.as_ref().map(Principal::kind).unwrap_or("none")`.
+- Match `auth_context.principal` as an `Option<Principal>`:
+  - `Some(User(...))`, `Some(Worker { ... })`, `Some(Webhook { ... })`, `Some(Slack { ... })` keep their extra fields.
+  - `None | Some(Agent { .. } | System { .. })` emits only the common HTTP fields.
+
+`docs/internal/logging-strategy.md`:
+- Replace the `anonymous` HTTP caller category guidance with `none` for requests that have no principal.
+- Keep `auth_status` as the field that distinguishes missing, invalid, expired, and authenticated auth state.
+
+### OpenAPI and generated clients
+
+`docs/public/api-reference/fabro-api.yaml`:
+- Remove `PrincipalAnonymous` from the `Principal` `oneOf`.
+- Remove `anonymous` from the `Principal` discriminator mapping.
+- Delete the `PrincipalAnonymous` schema.
+
+Regenerate:
+- `cargo build -p fabro-api`
+- `cd lib/packages/fabro-api-client && bun run generate`
+
+Expected generated cleanup:
+- `lib/packages/fabro-api-client/src/models/principal-anonymous.ts` disappears.
+- `Principal` union no longer includes `{ kind: "anonymous" }`.
+- `lib/packages/fabro-api-client/src/models/index.ts` no longer exports `principal-anonymous`.
+
+### Frontend
+
+`apps/fabro-web/app/lib/principal-display.tsx`:
+- Remove the `"anonymous"` switch case and unused icon import.
+
+`apps/fabro-web/app/components/run-summary-panel.test.tsx` and API-client exhaustiveness tests:
+- Remove anonymous principal cases.
+
+### Documentation sweep
+
+Remove anonymous-principal references from product/API docs and tests. Be careful not to touch unrelated uses of "anonymous" such as telemetry anonymous IDs or Git's `remote_anonymous` API.
+
+Useful sweep:
+- `rg -n "Principal::Anonymous|PrincipalAnonymous|kind: 'anonymous'|kind: \"anonymous\"|anonymous actor|anonymous subject|principal_kind.*anonymous|\"anonymous\"" lib/crates apps/fabro-web lib/packages/fabro-api-client docs/public docs/internal`
+
+### Verification
+
+- `cargo +nightly-2026-04-14 fmt --check --all`
+- `cargo +nightly-2026-04-14 clippy --workspace --all-targets -- -D warnings`
+- `cargo build --workspace`
+- `cargo nextest run --workspace`
+- `cd apps/fabro-web && bun run typecheck && bun test`
+- Manual: start `fabro server start`, hit a protected endpoint without a token, confirm 401 and an HTTP log with `principal_kind="none"` and `auth_status="missing"`.
+
+---
+
+## Commit 2 - Make run provenance and creator non-optional
+
+Full-chain invariant. Every persisted run has exactly one creator principal. No nullable schema fields, no legacy defaults, no projection fallbacks.
+
+### Core type changes
+
+`lib/crates/fabro-types/src/run_summary.rs`:
+- `Run.created_by: Option<Principal>` -> `Principal`.
+- Drop `#[serde(default)]`.
+
+`lib/crates/fabro-types/src/run.rs`:
+- `RunProvenance.subject: Option<Principal>` -> `Principal`.
+- Drop `#[serde(default, skip_serializing_if = "Option::is_none")]`.
+- Drop `Default` derive on `RunProvenance`.
+- `RunSpec.provenance: Option<RunProvenance>` -> `RunProvenance`.
+- Drop `#[serde(default, skip_serializing_if = "Option::is_none")]` on `RunSpec.provenance`.
+
+`lib/crates/fabro-types/src/run_event/run.rs`:
+- `RunCreatedProps.provenance: Option<RunProvenance>` -> `RunProvenance`.
+- Drop default/skip serialization attributes for provenance.
+
+`lib/crates/fabro-workflow/src/event/events.rs`:
+- `Event::RunCreated.provenance: Option<RunProvenance>` -> `RunProvenance`.
+- Drop default/skip serialization attributes for provenance.
+
+### Creation and retry flow
+
+`lib/crates/fabro-workflow/src/operations/create.rs`:
+- `CreateRunInput.provenance: Option<RunProvenance>` -> `RunProvenance`.
+- `PersistCreateOptions.provenance: Option<RunProvenance>` -> `RunProvenance`.
+- `RunSpec { provenance }` stores the total provenance directly.
+- `Event::RunCreated { provenance }` emits total provenance directly.
+
+`lib/crates/fabro-server/src/server/handler/runs.rs`:
+- `run_provenance(headers, subject)` returns `RunProvenance { subject: subject.clone(), ... }`.
+- Build provenance before creating `CreateRunInput`.
+
+`lib/crates/fabro-server/src/run_manifest.rs`:
+- Change `create_run_input(...)` to accept `provenance: RunProvenance` and set it directly, or stop using the helper for the final `CreateRunInput` construction. Do not create a temporary input with missing provenance.
+
+`lib/crates/fabro-workflow/src/operations/retry.rs`:
+- `RetryRunInput.provenance: Option<RunProvenance>` -> `RunProvenance`.
+- `retry_run(...)` writes the new run's `run.created` event with total provenance.
+
+`lib/crates/fabro-server/src/server/handler/lifecycle.rs`:
+- Pass `run_provenance(&headers, &actor)` directly into `RetryRunInput`.
+
+### Event conversion and projections
+
+`lib/crates/fabro-workflow/src/event/convert.rs`:
+- Convert `Event::RunCreated.provenance` into `RunCreatedProps.provenance` directly.
+- Remove `Some(...)` wrapping for run-created provenance.
+
+`lib/crates/fabro-workflow/src/event/stored_fields.rs`:
+- `Event::RunCreated { provenance, .. }` sets `actor: Some(provenance.subject.clone())`.
+
+`lib/crates/fabro-store/src/run_state.rs`:
+- `projection_from_created(...)` builds `RunSpec { provenance: props.provenance.clone(), ... }`.
+- `build_summary(...)` sets `created_by: state.spec.provenance.subject.clone()`.
+- Delete or rewrite tests that deserialize projections with `"provenance": null`.
+
+`lib/crates/fabro-types/src/run_projection.rs` and projection tests:
+- Replace all test `RunSpec` literals with total provenance.
+- Remove tests whose only purpose is legacy/null provenance tolerance.
+
+### OpenAPI
+
+`docs/public/api-reference/fabro-api.yaml`:
+- `Run.created_by` references `Principal` directly. Remove `oneOf [..., null]`.
+- `RunProvenance.required` includes `subject`.
+- `RunProvenance.subject` references `Principal` directly. Remove `oneOf [..., null]`.
+- `RunSpec.required` includes `provenance`.
+- `RunSpec.provenance` references `RunProvenance` directly. Remove `oneOf [..., null]`.
+- If `run.created` event properties are represented separately in the spec, make that event provenance required and non-nullable too.
+
+Regenerate:
+- `cargo build -p fabro-api`
+- `cd lib/packages/fabro-api-client && bun run generate`
+
+Do not hand-edit generated client files.
+
+### Demo mode
+
+`lib/crates/fabro-server/src/demo/mod.rs`:
+- Add a clearly synthetic demo principal using `AuthMethod::DevToken`, not GitHub:
+  ```rust
+  static DEMO_PRINCIPAL: LazyLock<Principal> = LazyLock::new(|| {
+      Principal::user(
+          IdpIdentity::new("fabro:demo", "demo").unwrap(),
+          "demo".to_string(),
+          AuthMethod::DevToken,
+      )
+  });
+  ```
+- Replace `created_by: None` with `created_by: DEMO_PRINCIPAL.clone()`.
+- If demo creates any full `RunSpec` or `run.created` event data, give it `RunProvenance { subject: DEMO_PRINCIPAL.clone(), ... }`.
+
+### Test support
+
+Do not add fake auth helpers to `fabro_types::fixtures`; that module is run-id constants.
+
+Use the existing `fabro-types` `test-support` feature:
+- Add `#[cfg(any(test, feature = "test-support"))] pub mod test_support;` in `lib/crates/fabro-types/src/lib.rs` if it does not already exist.
+- Add `lib/crates/fabro-types/src/test_support.rs` with:
+  - `test_principal() -> Principal`
+  - `test_run_provenance() -> RunProvenance`
+- Use an obviously fake dev-token identity, e.g. issuer `fabro:test`, subject `test-user`, login `test`.
+- In crates that need the helper from integration tests or cross-crate tests, dual-list `fabro-types` in `dev-dependencies` with `features = ["test-support"]`, following existing repo patterns.
+
+Update all constructors:
+- Replace `provenance: None` in `RunSpec`, `CreateRunInput`, `RetryRunInput`, `Event::RunCreated`, and `RunCreatedProps` literals with `test_run_provenance()` or a locally meaningful provenance.
+- Replace `subject: Some(...)` with `subject: ...`.
+- Replace `subject: None` only when it is actually `RunProvenance.subject`; leave unrelated todo/commit/message `subject` fields alone.
+- Replace `created_by: None` / `created_by: null` with `test_principal()` or a frontend TS principal fixture.
+- Delete tests that assert nullable or omitted creator/provenance behavior.
+
+Representative Rust areas:
+- `lib/crates/fabro-store/src/run_state.rs`
+- `lib/crates/fabro-store/tests/serializable_projection.rs`
+- `lib/crates/fabro-workflow/src/operations/{create,retry,start}.rs`
+- `lib/crates/fabro-workflow/src/event/{convert,sink,stored_fields}.rs`
+- `lib/crates/fabro-workflow/src/handler/**`
+- `lib/crates/fabro-workflow/src/pipeline/**`
+- `lib/crates/fabro-workflow/src/run_{lookup,metadata}.rs`
+- `lib/crates/fabro-server/src/server/tests.rs`
+- `lib/crates/fabro-server/src/server/handler/**`
+- `lib/crates/fabro-server/tests/it/**`
+- `lib/crates/fabro-cli/tests/it/support/mod.rs`
+- `lib/crates/fabro-dump/src/lib.rs`
+- `lib/crates/fabro-tool/src/{common,create,interact,search}.rs`
+- `lib/crates/fabro-api/tests/{principal_round_trip,run_summary_round_trip,run_projection_round_trip,run_event_round_trip}.rs`
+- `lib/crates/fabro-types/tests/{run_spec_serde,run_spec_methods,run_event_serde}.rs`
+
+Representative TypeScript areas:
+- `apps/fabro-web/app/**` tests with `created_by: null`
+- `apps/fabro-web/app/data/runs.ts`
+- `apps/fabro-web/app/components/run-summary-panel.tsx`
+- `apps/fabro-web/app/components/runs-list/**`
+- `lib/packages/fabro-api-client/tests/principal-exhaustive.ts`
+
+Useful sweep after edits:
+- `rg -n "Principal::Anonymous|PrincipalAnonymous|principal-anonymous|kind: ['\"]anonymous|created_by:\\s*(None|null)|provenance:\\s*None|subject:\\s*Some\\(|subject:\\s*None" lib/crates apps/fabro-web lib/packages/fabro-api-client docs/public docs/internal`
+
+Review each hit. The only acceptable remaining matches should be unrelated uses of "anonymous" and unrelated non-principal `subject` fields.
+
+### Frontend
+
+`apps/fabro-web/app/components/run-summary-panel.tsx`:
+- `run?.created_by` may still be guarded by `run` loading state, but `created_by` itself is non-null once `run` exists.
+- Pass `run.created_by` directly to `principalDisplay(...)` inside loaded-run branches.
+
+`apps/fabro-web/app/data/runs.ts` and run-list components:
+- Treat `createdBy` as a total principal in UI data derived from a loaded API run.
+- Remove empty/fallback rendering that only existed for missing creator data.
+
+### Verification
+
+- `cargo +nightly-2026-04-14 fmt --check --all`
+- `cargo +nightly-2026-04-14 clippy --workspace --all-targets -- -D warnings`
+- `cargo build --workspace`
+- `cargo nextest run --workspace`
+- `cargo nextest run -p fabro-server`
+- `cd apps/fabro-web && bun run typecheck && bun test && bun run build`
+- Manual end-to-end:
+  - `fabro server start`
+  - `cd apps/fabro-web && bun run dev`
+  - Authenticate and create a run through the UI.
+  - Confirm `/api/v1/runs/:id` has non-null `created_by`.
+  - Confirm `/api/v1/runs/:id/state` has non-null `spec.provenance.subject`.
+  - Retry a failed run and confirm the retried run has the retrying user as creator.
+  - Hit demo mode with `X-Fabro-Demo: 1` and confirm the run summary renders the synthetic `demo` dev-token user.
+
+
+## Completed stages
+- **toolchain**: succeeded
+  - Script: `command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1`
+  - Output:
+    ```
+    cargo 1.95.0 (f2d3ce0bd 2026-03-21)
+    ```
+- **preflight_compile**: succeeded
+  - Script: `cargo check -q --workspace 2>&1`
+  - Output: (empty)
+- **preflight_lint**: succeeded
+  - Script: `cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1`
+  - Output: (empty)
+- **implement**: succeeded
+  - Model: gpt-5.5, 5.0m tokens in / 68.2k out
+  - Files: /home/daytona/workspace/fabro/lib/crates/fabro-types/src/test_support.rs
+- **simplify_opus**: succeeded
+  - Model: claude-opus-4-7, 115.0k tokens in / 25.5k out
+  - Files: /home/daytona/workspace/fabro/apps/fabro-web/app/components/run-summary-panel.test.tsx, /home/daytona/workspace/fabro/apps/fabro-web/app/data/runs.test.ts, /home/daytona/workspace/fabro/apps/fabro-web/app/lib/run-actions.test.ts, /home/daytona/workspace/fabro/apps/fabro-web/app/lib/test-fixtures.ts, /home/daytona/workspace/fabro/apps/fabro-web/app/routes/automations-new.test.tsx, /home/daytona/workspace/fabro/apps/fabro-web/app/routes/run-detail.test.ts, /home/daytona/workspace/fabro/apps/fabro-web/app/routes/run-files.render.test.tsx, /home/daytona/workspace/fabro/apps/fabro-web/app/routes/runs.preferences.test.tsx, /home/daytona/workspace/fabro/apps/fabro-web/app/routes/runs.test.tsx, /home/daytona/workspace/fabro/lib/crates/fabro-cli/tests/it/cmd/support.rs
+
+
+# Simplify: Code Review and Cleanup
+
+Review all changed files for reuse, quality, and efficiency. Fix any issues found.
+
+## Phase 1: Identify Changes
+
+Run \`git diff\` (or \`git diff HEAD\` if there are staged changes) to see what changed. If there are no git changes, review the most recently modified files that the user mentioned or that you edited earlier in this conversation.
+
+## Phase 2: Launch Three Review Agents in Parallel
+
+Use the ${AGENT_TOOL_NAME} tool to launch all three agents concurrently in a single message. Pass each agent the full diff so it has the complete context.
+
+### Agent 1: Code Reuse Review
+
+For each change:
+
+1. **Search for existing utilities and helpers** that could replace newly written code. Look for similar patterns elsewhere in the codebase — common locations are utility directories, shared modules, and files adjacent to the changed ones.
+2. **Flag any new function that duplicates existing functionality.** Suggest the existing function to use instead.
+3. **Flag any inline logic that could use an existing utility** — hand-rolled string manipulation, manual path handling, custom environment checks, ad-hoc type guards, and similar patterns are common candidates.
+
+### Agent 2: Code Quality Review
+
+Review the same changes for hacky patterns:
+
+1. **Redundant state**: state that duplicates existing state, cached values that could be derived, observers/effects that could be direct calls
+2. **Parameter sprawl**: adding new parameters to a function instead of generalizing or restructuring existing ones
+3. **Copy-paste with slight variation**: near-duplicate code blocks that should be unified with a shared abstraction
+4. **Leaky abstractions**: exposing internal details that should be encapsulated, or breaking existing abstraction boundaries
+5. **Stringly-typed code**: using raw strings where constants, enums (string unions), or branded types already exist in the codebase
+6. **Unnecessary JSX nesting**: wrapper Boxes/elements that add no layout value — check if inner component props (flexShrink, alignItems, etc.) already provide the needed behavior
+7. **Unnecessary comments**: comments explaining WHAT the code does (well-named identifiers already do that), narrating the change, or referencing the task/caller — delete; keep only non-obvious WHY (hidden constraints, subtle invariants, workarounds)
+
+### Agent 3: Efficiency Review
+
+Review the same changes for efficiency:
+
+1. **Unnecessary work**: redundant computations, repeated file reads, duplicate network/API calls, N+1 patterns
+2. **Missed concurrency**: independent operations run sequentially when they could run in parallel
+3. **Hot-path bloat**: new blocking work added to startup or per-request/per-render hot paths
+4. **Recurring no-op updates**: state/store updates inside polling loops, intervals, or event handlers that fire unconditionally — add a change-detection guard so downstream consumers aren't notified when nothing changed. Also: if a wrapper function takes an updater/reducer callback, verify it honors same-reference returns (or whatever the "no change" signal is) — otherwise callers' early-return no-ops are silently defeated
+5. **Unnecessary existence checks**: pre-checking file/resource existence before operating (TOCTOU anti-pattern) — operate directly and handle the error
+6. **Memory**: unbounded data structures, missing cleanup, event listener leaks
+7. **Overly broad operations**: reading entire files when only a portion is needed, loading all items when filtering for one
+
+## Phase 3: Fix Issues
+
+Wait for all three agents to complete. Aggregate their findings and fix each issue directly. If a finding is a false positive or not worth addressing, note it and move on — do not argue with the finding, just skip it.
+
+When done, briefly summarize what was fixed (or confirm the code was already clean).

stages/007-simplify_gpt@1/provider_used.json

@@ -0,0 +1,5 @@
+{
+  "mode": "agent",
+  "provider": "openai",
+  "model": "gpt-5.5"
+}

stages/007-simplify_gpt@1/response.md

@@ -0,0 +1,25 @@
+Reviewed the latest simplification diff with all three agents:
+
+- Code reuse review: no actionable issues.
+- Code quality review: no actionable issues. The only note was that `testPrincipal()` returns a fresh object per call, which is already safe and appropriate.
+- Efficiency review: no findings.
+
+No code changes were needed.
+
+Verification run:
+
+```bash
+cd apps/fabro-web && bun test \
+  app/components/run-summary-panel.test.tsx \
+  app/data/runs.test.ts \
+  app/lib/run-actions.test.ts \
+  app/routes/automations-new.test.tsx \
+  app/routes/run-detail.test.ts \
+  app/routes/run-files.render.test.tsx \
+  app/routes/runs.preferences.test.tsx \
+  app/routes/runs.test.tsx
+```
+
+Result: `104 pass, 0 fail`.
+
+Working tree remains clean.