feat(console): land v2 proactivity live APIs on main (#79)

[Travis-Gilbert]

Summary

Rehomes the unique work from open PR #79 onto main (canonical CommonPlace console at apps/console / v2.theoremharness.com).

#79 targeted the stacked feature branch Travis-Gilbert/console-composer-density and conflicted with main after #75/#76/#78. This PR:

• Lands the live proactivity harness API routes, compilation/stream helpers, and ProactivityGraphView
• Keeps the existing editable ProactivityView (from feat(console): editable proactivity graph surface (SPEC-PROACTIVITY-GRAPH-SURFACE) #63/feat(console): typed node-model blocks and typography for proactivity #76) as the registered proactivity.graph surface
• Preserves Goal Stack stripe IA from feat(console): add V2 workspace and goal stack surfaces #78
• Makes initialProactivity optional on ConsoleApp so the live hydrate path does not break the fixture-backed view

Test plan

• pnpm test in apps/console (125 passing)
• gate:fence, gate:register, gate:motion, gate:icons
• CI console gates + Playwright visual baseline

Supersedes the merge intent of #79 (wrong base). #74/#73 remain open but are largely superseded by already-merged #75/#76; this agent cannot retarget or close them (token lacks update permission).

  

Summary by CodeRabbit

• New Features
  • Added a Proactivity graph view showing dependencies, node status, and resolved details.
  • Added live firing highlights through a streaming activity feed.
  • Added intent compilation with streamed candidate results for review.
  • Added options to commit or discard pending compilations.
  • Added reversible graph actions, including enabling nodes and updating configuration.
  • Added loading, unavailable, validation, and error states for Proactivity features.
• Bug Fixes
  • Improved tenant-specific stream routing and upstream error handling.
• Tests
  • Added coverage for graph layout, compilation validation and streaming, action safety, and firing-path highlighting.

[ecc-tools]

ECC bundle files are already tracked in this repository. Skipping generation of another bundle PR.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c45fbfa5-b78f-453c-b511-d9b1fd393ecc

📥 Commits

Reviewing files that changed from the base of the PR and between ea91d39 and b15be94.

⛔ Files ignored due to path filters (2)

• apps/console/e2e/proactivity.spec.ts-snapshots/proactivity-graph-darwin.png is excluded by !**/*.png
• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (28)

• apps/console/AGENTS.md
• apps/console/CLAUDE.md
• apps/console/package.json
• apps/console/playwright.config.ts
• apps/console/src/app/api/proactivity/actions/route.ts
• apps/console/src/app/api/proactivity/compilations/[compilationId]/route.ts
• apps/console/src/app/api/proactivity/compile/route.ts
• apps/console/src/app/api/proactivity/route.ts
• apps/console/src/app/api/proactivity/stream/route.ts
• apps/console/src/app/page.tsx
• apps/console/src/components/ConsoleApp.tsx
• apps/console/src/components/shell/IntuiShell.tsx
• apps/console/src/lib/proactivity/actions.test.ts
• apps/console/src/lib/proactivity/actions.ts
• apps/console/src/lib/proactivity/compilation-stream.test.ts
• apps/console/src/lib/proactivity/compilation-stream.ts
• apps/console/src/lib/proactivity/compilation.test.ts
• apps/console/src/lib/proactivity/compilation.ts
• apps/console/src/lib/proactivity/graph-layout.test.ts
• apps/console/src/lib/proactivity/graph-layout.ts
• apps/console/src/lib/proactivity/proactivity-store.ts
• apps/console/src/lib/proactivity/types.ts
• apps/console/src/lib/proactivity/use-proactivity-overlay.test.ts
• apps/console/src/lib/proactivity/use-proactivity-overlay.ts
• apps/console/src/lib/server/proactivity-harness.ts
• apps/console/src/styles/app.css
• apps/console/src/views/ProactivityGraphView.tsx
• railway.console.toml

---

📝 Walkthrough

Walkthrough

The console adds a typed proactivity graph projection with GraphQL mutations, tenant-filtered SSE events, ACP-backed compilation review, deterministic React Flow rendering, firing-path highlights, and commit/discard controls.

Changes

Proactivity graph integration

Layer / File(s)	Summary
Contracts and validation apps/console/src/lib/proactivity/types.ts, actions.ts, compilation.ts, *.test.ts	Adds graph, receipt, compilation, and strict action contracts with validation tests.
Projection and mutation backend apps/console/src/lib/server/proactivity-harness.ts, apps/console/src/app/api/proactivity/..., railway.console.toml	Connects GraphQL projection and mutations, exposes graph/action/compilation routes, and relays tenant-filtered SSE events.
ACP compilation review stream apps/console/src/app/api/proactivity/compile/route.ts, compilation-stream.ts, tests	Streams ACP output, validates candidates, stages pending compilations, and reports completion or errors.
Client graph surface apps/console/src/views/ProactivityGraphView.tsx, proactivity-store.ts, graph-layout.ts, use-proactivity-overlay.ts, app.css	Renders the deterministic graph, initializes projection state, and highlights firing paths from SSE events.
Compilation decisions and wiring apps/console/src/app/page.tsx, ConsoleApp.tsx, playwright.config.ts, package.json	Seeds the client store from the server projection and supports streamed compilation commit/discard flows with E2E fixture configuration.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant ProactivityGraphView
  participant ConsoleAPI
  participant GraphQLHarness
  participant Changefeed
  User->>ProactivityGraphView: Open console
  ProactivityGraphView->>ConsoleAPI: GET proactivity graph
  ConsoleAPI->>GraphQLHarness: Query projection
  GraphQLHarness-->>ConsoleAPI: Graph
  ConsoleAPI-->>ProactivityGraphView: Initial graph
  ProactivityGraphView->>ConsoleAPI: Open SSE stream
  ConsoleAPI->>Changefeed: Fetch tenant-filtered feed
  Changefeed-->>ProactivityGraphView: Firing event
  ProactivityGraphView->>ProactivityGraphView: Highlight firing path

Loading

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/proactivity-aliveness-v2-ba1b

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}