Skip to content

feat(studio): ship AgentReact and a project-first workbench - #120

Open
phodal wants to merge 5 commits into
mainfrom
feat/agent-react-production-runtime
Open

feat(studio): ship AgentReact and a project-first workbench#120
phodal wants to merge 5 commits into
mainfrom
feat/agent-react-production-runtime

Conversation

@phodal

@phodal phodal commented Aug 27, 2026

Copy link
Copy Markdown
Member

Summary

  • ship the spec-backed AgentReact production pipeline: immutable revisions, Oxc semantic compilation, confined linking, restartable Worker execution, opaque Current/Staging frames, and Host-owned state, Actions, observations, and addressing
  • make Projects the persistent Studio scope so every View shares one opaque active Project, Project switch and run binding are revision-safe, and native filesystem paths remain server-side
  • make the published CLI Project-first by bundling workspace discovery and customization runtimes, and add actionable CLI, bootstrap, empty-state, keyboard, and narrow-screen recovery
  • close the release-review gaps: unavailable checkpoints are blocked consistently in UI and server, Qoder experiments never inherit ACP identity, Session Compare is semantic and responsive, and zero Artifact catalogs are not advertised as ready
  • merge current main so native Session Artifact opening and the refined Compare hierarchy coexist with the Project-first shell and readiness boundaries

Traceability

  • Spec: docs/specs/2026-08-27-agent-react-artifact-runtime-poc.md — AR-AC-1 through AR-AC-30
  • Spec: docs/specs/2026-08-27-studio-project-first-workbench.md — AC-1 through AC-9
  • Spec: docs/specs/2026-08-28-studio-published-first-run.md — AC-1 through AC-15
  • No external Story or Issue was provided; none is inferred.

Validation

  • Node 24 root npm run check passed: 1,545 root tests with 2 skipped, 173 Harness tests, 31 Harness UI tests, 489 Studio tests, generated-source verification, and package verification (597 npm entries / 859 runtime-zip entries)
  • npm run test:browser -w @qoder-ai/harness-studio — 52 Chromium tests passed, including 1440x900, 1024x768, and 390x844 layouts with changed-surface console/page-error checks
  • Studio build and typecheck passed; npm pack -w @qoder-ai/harness-studio --dry-run --ignore-scripts listed 1,142 files / 6.9 MB and both bundled runtimes
  • npx vitest run test/skills-docs/doc-link-graph.test.mjs — 8 tests passed
  • focused AgentReact/compile delivery suite passed 207 tests across 14 files; Intel macOS dependency-plan closure selected both pinned Oxc native bindings
  • visual review confirmed the primary decision, focus, and bounded overflow for Project shell, blocked Qoder comparison, Session Compare, native Session Artifact opening, and refined Compare at wide, compact, and narrow widths

Risk and delivery boundaries

  • Oxc adds platform-specific native optional dependencies. Versions and integrity remain pinned behind OxcCompilerPort; Windows and Linux runtime claims still depend on their corresponding CI jobs.
  • The Project catalog is process-local. Project ids are opaque, native paths stay server-side, and Project switching, imports, async analysis, and run retention are revision-bound.
  • Experiment readiness is enforced again at the server before runner allocation. The manifest host is authoritative for Qoder versus ACP identity and Agent selection.
  • The bundled discovery and customization entries are Node-only runtimes. Browser contracts expose bounded labels and safe failure categories, not commands, environment values, credentials, or native paths.
  • Publication, release, version, changelog, tag creation, and release notes are not part of this PR.

phodal and others added 4 commits August 27, 2026 20:45
Introduce a spec-backed AgentReact pipeline across semantic compilation, confined linking, immutable snapshots, opaque iframe staging, Host-owned state and Actions, and Studio registration.

The implementation covers AR-AC-1 through AR-AC-30 in docs/specs/2026-08-27-agent-react-artifact-runtime-poc.md. It was validated with npm run check, the 47-test Chromium suite, and Intel macOS npm install-plan closure.

Co-authored-by: Codex (GPT 5.6 Sol) <codex@openai.com>
Introduce an opaque process-local Project catalog and a persistent Project-first sidebar so every Studio View shares one active workbench context. Preserve configured Sources as independent inputs and retain legacy workspace routes for compatibility.

Bind Project-default runs and asynchronous Project evidence to the captured Project revision, serialize Project mutations, and prevent native paths or stale Git and analysis results from crossing Project boundaries.

This implements docs/specs/2026-08-27-studio-project-first-workbench.md and was validated with the Node 24 root check, the scoped Studio suite, and browser coverage at wide, compact, and narrow layouts. The main risks reviewed were Project switching, in-flight evidence, native-path privacy, and legacy route compatibility.

AI assistance is recorded by the co-author line.

Co-authored-by: Codex (GPT 5.6 Sol) <codex@openai.com>
Bundle Project discovery and its Inspector assets into the npm runtime, restore ESM customization collection, and make CLI failures actionable.

Keep run retention bound to the starting Project, serialize workspace imports, prevent execution from read-only imports, and tighten empty, error, keyboard, and narrow-screen states.

Spec: docs/specs/2026-08-28-studio-published-first-run.md
Test: Studio 61 files / 483 tests; Playwright 51 tests plus focused post-review regression; root check and packed CLI smoke passed.

Co-authored-by: Codex (GPT 5.6 Sol) <codex@openai.com>
Gate every experiment surface and the server run route with the shared checkpoint readiness contract. Derive Qoder and ACP identity from the manifest, and expose Agent selection only to ACP experiments.

Make blocked and empty shell states actionable, add semantic and responsive Session comparison behavior, and record the follow-up acceptance evidence in the published-first-run spec.

Validated with the harness-studio package suite (61 files, 487 tests), the full Playwright suite (52 tests), tarball dry-run, and the documentation link graph (8 tests).

Co-authored-by: Codex (GPT 5.6 Sol) <codex@openai.com>
@phodal phodal changed the title feat(artifacts): add production AgentReact runtime feat(studio): ship AgentReact and a project-first workbench Aug 28, 2026
Integrate the native Session Artifact opening and responsive Compare UX changes from main with the Project-first Studio shell.

Resolve the overlapping shell, composer, CSS, and browser coverage while preserving checkpoint readiness gates, Qoder versus ACP identity, Session roving focus, and Project revision boundaries.

Validated under Node 24 with the complete root check, 61 Studio files / 489 tests, 52 Playwright tests, 8 documentation link tests, generated-source verification, and package verification.

Co-authored-by: Codex (GPT 5.6 Sol) <codex@openai.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant