AE See-Suite full green product pass: living state atlas to product surface

[AtomEons]

What this patch does

This PR is the first full-green product pass after the 72-state AE See-Suite mockup atlas.

It moves the build from a state-atlas harness toward a real living product surface.

Product law

• One AppShell.
• Many semantic states.
• No 72 pages.
• No mockup images as UI.
• State atlas remains QA/dev control rig.
• Product behavior must be reachable through real UI actions, chat commands, backend events, or MCP/proof tools.

Major changes

State truth + temporal memory

• Adds startup cleanup so normal calm boot does not keep accidental preloaded causality when no ?state= preset is requested.
• Adds a real TemporalMemoryExpandedOverlay for state 22 / temporal memory inspection.
• Wires temporal expansion into AppShell.
• Adds temporal.css.
• Clicking Temporal Memory now opens the expanded temporal surface and enters reviewing context.

Real product surfaces

The generic StateWorkbenchOverlay is now demoted to fallback. Dedicated product surfaces route first:

• ProductSurfaceOverlay
• SurfaceShell
• SettingsDrawer
• NotificationsDrawer
• ArtifactInspectorDrawer
• ProductModalStack

Real modal surfaces include:

• Add Widget
• Context Picker
• Model Selector
• Export
• Deployment Approval
• Keyboard Shortcuts
• Compare
• Stop Confirm

Navigation and trigger wiring

• Top rail buttons now open real product surfaces.
• Left rail now opens real product surfaces.
• Command palette now opens real product surfaces.
• Anchor proof scripts now include state 22.
• Frontend proof CI now includes state 22.

AE See-Suite MCP lane

Adds dedicated MCP tooling:

• scripts/ae-see-suite-mcp-tools.mjs
• scripts/ae-see-suite-mcp-server.mjs

Tools include:

• ae_see_suite_help
• ae_see_suite_build_frontend
• ae_see_suite_proof_anchors
• ae_see_suite_proof_72
• ae_see_suite_state_open_command

Direct run:

node ./scripts/ae-see-suite-mcp-server.mjs

Cross-platform script direction

Core web/API/proof root scripts have been moved away from Windows-only npm.cmd where patched.

Anchor states now targeted

• 01 Calm Overview
• 06 Alert / Critical Latency
• 22 Temporal Memory Expanded
• 26 Command Palette
• 37 Agent Queue
• 61 Living Canvas

Validation target

From repo root:

npm run build:web
npm run frontend:proof:visual
npm run frontend:proof:pixel
npm run frontend:proof:visual:72

Or from frontend/:

npm run build
npm run proof:visual
npm run proof:pixel
npm run proof:visual:72

Notes

This PR intentionally keeps StateWorkbenchOverlay as fallback while real product surfaces replace the most important drawer/modal states. Remaining work after this pass: build-error patching, proof receipt review, and more direct trigger wiring if needed.

[AtomEons]

AE See-Suite Big Roll Update

Pushed another major wave into this PR.

New product behavior added

• Dedicated AE See-Suite MCP tool pack:
  • scripts/ae-see-suite-mcp-tools.mjs
  • scripts/ae-see-suite-mcp-server.mjs
• Real product surface router:
  • ProductSurfaceOverlay
  • routes real drawers/modals before the older StateWorkbenchOverlay fallback
• Real product drawers:
  • SettingsDrawer
  • NotificationsDrawer
  • ArtifactInspectorDrawer
• Real product modal stack:
  • Add Widget
  • Context Picker
  • Model Selector
  • Export
  • Approval
  • Shortcuts
  • Compare
  • Stop Confirm
• Reusable product shell:
  • SurfaceShell
• Command palette now opens real product surfaces directly, not only mockup states.
• Root scripts changed toward cross-platform npm run instead of npm.cmd where the patch landed.
• Temporal memory expanded overlay is present for state 22.

Current product direction

This PR is now more than a state-atlas harness. It is turning AE See-Suite into a real living app shell:

• State atlas remains QA/dev control rig.
• Product states are increasingly reachable through real UI triggers.
• StateWorkbenchOverlay is being demoted to fallback only.
• Dedicated product components now read/write Zustand store state.

Direct MCP run command

The standalone AE See-Suite MCP server can be run directly:

node ./scripts/ae-see-suite-mcp-server.mjs

Validation target

From repo root where supported:

npm run build:web
npm run frontend:proof:visual -- --states=01,06,22,26,37,61 --label=anchor-pass
npm run frontend:proof:visual:72

Or from frontend/:

npm run build
npm run proof:visual -- --states=01,06,22,26,37,61 --label=anchor-pass
npm run proof:visual:72

Next wave

Next target is build stabilization + state legitimacy:

• patch any TypeScript errors from the new surfaces
• wire remaining direct triggers into nav/chat/tool buttons
• make 01/06/22/26/37/61 pass as real product states, not just preset states
• upgrade proof receipts and PR notes after build results

[AtomEons]

Big Roll Wave — Product Legitimacy + MCP + Trigger Wiring

Kept it moving inside the same PR.

Added / upgraded in this wave

• Dedicated AE See-Suite MCP lane

  • scripts/ae-see-suite-mcp-tools.mjs
  • scripts/ae-see-suite-mcp-server.mjs
  • Tools cover build, anchor proof, 72-state proof, state URL helper, and AE See-Suite help.

• Real product surfaces

  • ProductSurfaceOverlay
  • SurfaceShell
  • SettingsDrawer
  • NotificationsDrawer
  • ArtifactInspectorDrawer
  • ProductModalStack

• StateWorkbenchOverlay demotion

  • Dedicated product drawers/modals are now routed to real components first.
  • Old StateWorkbenchOverlay remains fallback only.

• Command palette product actions

  • Direct actions for Settings, Notifications, Artifact Inspector, Add Widget, Context Picker, Model Selector, Export, Approval, Shortcuts, Compare, Stop Confirm, and Temporal Memory expansion.
  • This moves states away from pure ?state=XX preset dependency and toward real UI triggers.

• Temporal ribbon trigger

  • Clicking Temporal Memory now opens the expanded temporal memory surface and moves the system into reviewing mode.

• Cross-platform scripts

  • Root scripts moved away from Windows-only npm.cmd for the core web/API/proof paths where the patch landed.

Product meaning

The 72-state atlas is no longer just a gallery or screenshot target. It is becoming a controllable state machine with real app triggers.

Anchor state legitimacy status:

• 01 Calm — startup cleanup protects calm boot.
• 06 Alert — latency anomaly / command path can trigger causality.
• 22 Temporal Memory — now has a real temporal expansion surface and ribbon trigger.
• 26 Command Palette — real global command system.
• 37 Agent Queue — real drawer action.
• 61 Living Canvas — real artifact/canvas path.

Still needs validation

Run from repo root or frontend:

npm run build:web
npm run frontend:proof:visual -- --states=01,06,22,26,37,61 --label=anchor-pass
npm run frontend:proof:visual:72

If build flags TypeScript issues in the new surface components, patch those next in this same PR.

[AtomEons]

Continue Roll — Navigation + Proof Anchor Wiring

Additional product-legitimacy wave pushed.

Added in this wave

• Frontend anchor proofs now include state 22

  • frontend/package.json now targets 01,06,22,26,37,61 for visual and pixel anchor proof scripts.
  • This brings Temporal Memory into the canonical anchor set instead of leaving it only in the full 72-state pass.

• Top rail controls now open real surfaces

  • Live stream/context control opens Context Picker.
  • Notifications opens real Notifications drawer.
  • Create opens Add Widget modal.
  • Agent Queue already opens real Agent Queue.

• Left rail controls now open real product surfaces

  • Models opens Model Selector.
  • Deployments opens Deployment Approval.
  • Alerts opens Notifications.
  • Reports opens Artifact Inspector.
  • Settings opens Settings drawer.
  • Agents and Memory continue to open real drawers.

Product meaning

This shifts AE See-Suite further from state-preview mode into product mode. More of the same shell is now reachable by normal navigation, not just / ?state=XX or command palette.

The anchor set is now:

• 01 Calm Overview
• 06 Alert / Critical Latency
• 22 Temporal Memory Expanded
• 26 Command Palette
• 37 Agent Queue
• 61 Living Canvas

Validation reminder

Run:

npm run build:web
npm run frontend:proof:visual
npm run frontend:proof:pixel
npm run frontend:proof:visual:72

If TypeScript flags the new surface/router changes, patch those next in this PR.

[AtomEons]

Continue Roll — MCP Documentation + MCP CI Check

Added another support wave to make the new AE See-Suite MCP lane usable and guarded.

Added

• docs/ae-see-suite/MCP_SETUP.md

  • documents direct server run command
  • lists AE See-Suite MCP tools
  • documents product law
  • documents anchor proof states
  • includes example MCP client config shape

• .github/workflows/ae-see-suite-mcp.yml

  • syntax-checks the AE See-Suite MCP tool pack
  • syntax-checks the standalone AE See-Suite MCP server
  • runs on PRs/pushes touching MCP files

Current MCP direct command

node ./scripts/ae-see-suite-mcp-server.mjs

MCP anchor proof path

Use tool:

ae_see_suite_proof_anchors

or shell:

npm run build:web
npm run frontend:proof:visual -- --states=01,06,22,26,37,61 --label=anchor-pass

Product meaning

This gives the living dashboard its own dedicated build/proof control rail. The MCP now carries the state-atlas discipline directly: one AppShell, many states, no mockup backgrounds, no 72 pages.

[AtomEons]

Codex Test Handoff — Run This Locally / In Git Workspace

Codex can run the repo tests/builds directly from a checked-out copy of this PR branch. Use this as the green protocol.

Branch

git fetch origin pull/1/head:ae-see-suite/full-green-product-pass
# or checkout existing remote branch if present
git checkout ae-see-suite/full-green-product-pass

Install

npm install

Primary green path

npm run check
npm run build:api
npm run test:api
npm run build:web

AE See-Suite proof path

npm run frontend:proof:visual
npm run frontend:proof:pixel
npm run frontend:proof:summary

Full atlas proof

npm run frontend:proof:visual:72

If build fails

Patch exact TypeScript/Vite errors first. Do not start new features until these are green.

Likely areas to inspect first:

• frontend/src/components/surfaces/*
• frontend/src/components/overlays/ProductSurfaceOverlay.tsx
• frontend/src/components/overlays/StateWorkbenchOverlay.tsx
• frontend/src/store/useAppStore.ts
• frontend/src/engine/commandPaletteRegistry.ts

Product acceptance anchors

The minimum visual/product anchor set is:

01 Calm Overview
06 Alert / Critical Latency
22 Temporal Memory Expanded
26 Command Palette
37 Agent Queue
61 Living Canvas

Important law

Do not convert mockups into pages. Keep one AppShell and make states reachable through real Zustand state, UI triggers, command palette actions, chat commands, backend stream events, and MCP/proof tools.

[AtomEons]

AELID Naming / Module Direction

New module name accepted for the frontend:

AELID = AtomEons Living Intelligence Dashboard

Pronounced: eyelid.

AELID is the frontend living dashboard module that connects to OrangeBOX. AE See-Suite is the broader product experience. OrangeBOX remains the backend / command / proof / MCP system.

Module boundary

AELID owns:

• one living AppShell
• floating no-grid panels
• chat / LLM IDE command dock
• state atlas rendering
• causality visualization
• temporal memory surface
• command palette
• product drawers/modals
• artifact canvas
• visual proof capture

OrangeBOX owns:

• agent execution
• receipted commands
• MCP rails
• backend routes
• durable actions
• proofs
• operational services

Connection rule

AELID should connect to OrangeBOX through explicit interfaces:

• HTTP API
• SSE event streams
• MCP tools
• proof artifacts
• receipts
• normalized workspace snapshots

The current remote adapter already points in this direction through:

/api/v4/see-suite/agent/run

Build law

Do not make AELID 72 pages. It remains one AppShell with many semantic states.

Anchor states remain:

01 Calm Overview
06 Alert / Critical Latency
22 Temporal Memory Expanded
26 Command Palette
37 Agent Queue
61 Living Canvas

This PR should now be treated as the first AELID module pass toward OrangeBOX connection.