Skip to content

Implementation plan: complete Humagen workspace and control plane

Baseline: main edc4f00, October 25, 2026. Both checked-in design sets are approved by the user.

Summary

Implement the real console and its backing system, preserving one runtime path and default-deny read confinement. Prototype records are design evidence only. This plan is not a claim that the listed gaps are implemented. Each row completes only with native behavior and recorded tests.

Technical context

Go module composition of fiber, saige, playscape and anchor; React/TypeScript workspace and shared web/Slack presentation. Existing state.Store-backed memory/Postgres stores, OpenAPI contract and generated TypeScript client remain authoritative. Preserve the framework, Page layout, AgentMark identity, native credential references and existing budget accounting.

Constitution check

Project constitution is AGENTS.md (there is no separate constitution.md in this repository). Every new record is tenant-scoped and bounded; each route checks one permission then p.Sees; narrower scope cannot grant access; records replay on memory and Postgres; secrets never enter response DTOs or audit snapshots. Historical accounting is immutable even when current audience placement changes.

Applied guidelines

Use the existing Go/React stack and style-brand shared web reference, repo copy.ts and primitives. No framework migration or duplicate execution path is planned. New wire fields change api/openapi.yaml before make client. No generated client hand edits.

Stack and ownership

Layer Branch Pull request Owner
Badge containment and shared message actions codex/agent-badge-layout #75, base main root
Plan, audit and source foundations codex/artifact-ui-completion #76, base #75 root, audit core from library_personal
Company and authoritative placement codex/company-placement #78, base #76 company_placement
Agent operations codex/agent-operations #79, base #78 agent_operations
Sources and integrations codex/source-lifecycle #80, base #79 source_lifecycle
Clean Library and personal review layer codex/library-personal-review #81, base #80 library_personal
Conversation interactions codex/conversation-actions #82, base #81 conversation_actions
Usage and Activity codex/workspace-observability #83, base #82 root
Native SMTP notifications codex/notification-email #84, base #83 root
Outcomes and integrated workspace codex/workspace-outcomes Upper PR publication pending, intended base #84 workspace_outcomes

Branches are integrated through no-ff merges, never rebase/reset/force-push. Each PR targets its immediate parent; root publishes after integrating the lower layer. Shared API/navigation changes are reconciled and verified before promotion.

Current implementation and acceptance status

Reconciled October 26 against the tested native union: runtime 902641d with source-learning adapter 8f43384, native document browser helper 9d5df97, repeated-agent action-row regression 1cce847. Every requirement below has its own status and checked evidence in requirements.json; the traceability table uses the same values.

A checked task means its native implementation and relevant automated checks passed. It does not certify full visual parity, final remote CI or external-account authorization. Live-account pending states remain explicit even when the native implementation task is checked.

The full Go race run at a0d7059 passed 47 tested packages and 2,380 test/subtest records, with zero failures and zero test skips using isolated Postgres and S3. After 902641d, focused platform/HTTP/Library race checks pass for skills, source dependencies, outcome learning, response contracts and private confinement on memory and Postgres. The final full rerun remains separate. The final Library/upper console suite passes 566 tests without skips and types pass. Adapter 58 tests, client 18 tests, generated-client no-diff, console build, OpenAPI lint, Biome and golangci-lint passed at the recorded checkpoints. Four actual phone/desktop native DOCX/XLSX journeys passed: editable original bytes, PDF export, exact-version requested-change draft, new v2 and unchanged v1 hash.

The P2 native follow-ups have now landed: the bounded source dependency graph and typed derived-skill/reviewed-memory reader (59baeef, 8f43384, REQ-028), exact-version skill Used By and publication readiness (3272306, REQ-034), and native Needs Review roster/filter plus Context links (902641d, REQ-023). Relevant native/contract and upper rendered regressions pass; this does not claim final screenshot acceptance for those controls.

Final canonical responsive, keyboard/touch and dark-mode acceptance, eight showcase captures, final stacked CI and external authorization/delivery checks remain open (REQ-001, REQ-004, REQ-060, REQ-064). The 484 static control mappings and supplemental dynamic-control table are traceability evidence, not a full-parity certificate. Root will record final capture outcomes and honest authorization limits separately.

Implementation steps

Phase 1: Foundation and review

  • T001 [Plan:1.1] Complete requirement traceability and native verification. Native implementation/evidence in docs/plans/2026-10-workspace-implementation.md, docs/plans/2026-10-workspace-control-audit.md, docs/assets/workspace-implementation/control-audit.json. [REQ-001]; owner root. Source: docs/reference/control-plane-gap-analysis.md.
  • T002 [Plan:1.2] Badge outlines contain labels at narrow widths and enlarged text. Native implementation/evidence in apps/web/src/ui.tsx, apps/web/src/Agents.tsx, scripts/screens/run.ts. [REQ-002]; owner root. Source: user supplied badge screenshot.
  • T003 [Plan:1.3] Copy and Reply share one consistent accessible action row. Native implementation/evidence in packages/web/src/AgentMessage.tsx, apps/web/src/Room.tsx, packages/web/src/MessageActionRow.tsx, apps/web/src/room.dom.test.tsx. [REQ-003]; owner workspace_outcomes. Source: user supplied message-actions screenshot.
  • T004 [Plan:1.4] Prototype controls become real authenticated state transitions. Native implementation/evidence in api/openapi.yaml, internal/httpapi/server.go, internal/httpapi/openapi_test.go. [REQ-004]; owner all. Source: docs/assets/workspace-prototype/README.md#try-the-interaction-loop.
  • T005 [Plan:1.5] Preserve agent identity, stable colors and compatibility history. Native implementation/evidence in internal/platform/builtin.go, pkg/agentcolors/store.go, pkg/agentcolors, docs/reference/design-requirements.md. [REQ-005]; owner root. Source: AGENTS.md; docs/reference/design-requirements.md#built-in-handles-and-slack-conversation-navigation.
  • T006 [Plan:1.6] Durable bounded safe audit attempts underpin domain mutations. Native implementation/evidence in pkg/audit, internal/platform/audit.go, pkg/audit/audit_test.go, internal/platform/audit_test.go. [REQ-006]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#control-plane-operations.

Phase 2: Company and authoritative placement

  • T007 [Plan:2.1] Company is the root and every agent has an explicit home. Native implementation/evidence in pkg/projects/homes.go, internal/platform/agents.go, internal/httpapi/personal_address_test.go. [REQ-007]; owner company_placement. Source: docs/architecture/company-workspace.md#one-company-project.
  • T008 [Plan:2.2] Idempotent durable personal project provisioning for human members. Native implementation/evidence in pkg/projects, pkg/projects/personal_test.go, internal/httpapi/personal_address_test.go. [REQ-008]; owner company_placement. Source: docs/architecture/company-workspace.md#a-personal-project-for-each-person.
  • T009 [Plan:2.3] Exact-owner personal read/write confinement, governance recorded. Native implementation/evidence in internal/platform/sees.go, pkg/projects/roles.go, internal/platform/personal_context_test.go, internal/httpapi/confinement_test.go. [REQ-009]; owner company_placement. Source: docs/architecture/company-workspace.md#a-personal-project-for-each-person.
  • T010 [Plan:2.4] Versioned current placement separate from immutable accounting. Native implementation/evidence in pkg/threads, pkg/runs, internal/platform/threads.go, internal/platform/placement_projection_test.go. [REQ-010]; owner company_placement. Source: docs/architecture/company-workspace.md#moving-work-into-a-public-project.
  • T011 [Plan:2.5] Publish completed private work with audience preview and race safety. Native implementation/evidence in apps/web/src/ConversationShell.tsx, internal/platform/threads.go, internal/platform/publication_race_test.go, internal/platform/summary_publication.go. [REQ-011]; owner company_placement. Source: docs/architecture/company-workspace.md#moving-work-into-a-public-project.
  • T012 [Plan:2.6] One retained announcement banner above the greeting. Native implementation/evidence in internal/platform/announce.go, internal/platform/welcome.go, apps/web/src/HomePage.tsx. [REQ-012]; owner company_placement. Source: docs/architecture/company-workspace.md#an-announcement-above-the-greeting.
  • T013 [Plan:2.7] Permission-filtered Find Help and safe retirement of new SME routing. Native implementation/evidence in pkg/pick, internal/platform/threads.go, apps/web/src/Chat.tsx, internal/platform/find_help.go. [REQ-013]; owner company_placement. Source: docs/architecture/company-workspace.md#find-the-project-and-agent-for-the-work.

Phase 3: Delegation and agent operations

  • T014 [Plan:3.1] Durable assignment goal, owner, completion criteria and outcomes. Native implementation/evidence in pkg/operations, internal/platform/assignments.go, apps/web/src/Assignments.tsx, pkg/operations/operations_test.go. [REQ-014]; owner agent_operations. Source: docs/architecture/conversation-workspace.md#follow-through.
  • T015 [Plan:3.2] Standing work and triggers reuse scheduler, Invoke and pkg/call. Native implementation/evidence in pkg/call, internal/platform/assignments.go, internal/platform/assignment_cron_recovery_test.go, internal/platform/assignment_sources_test.go. [REQ-015]; owner agent_operations. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#agents-and-how-they-talk-to-each-other.
  • T016 [Plan:3.3] Inherited tighten-only Allow, Ask, Never action policy. Native implementation/evidence in pkg/operations, internal/platform/action_policy_view_test.go, apps/web/src/ActionPolicies.tsx. [REQ-016]; owner agent_operations. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#agents-and-how-they-talk-to-each-other.
  • T017 [Plan:3.4] Named managers, escalation, reminders, budgets and stop rules. Native implementation/evidence in pkg/operations, internal/platform/hooks.go, internal/platform/operation_reminders_runtime_test.go, internal/platform/operation_reminders_test.go. [REQ-017]; owner agent_operations. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#agents-and-how-they-talk-to-each-other.
  • T018 [Plan:3.5] Typed handoff contracts, deadlines, states, cycles and hop limits. Native implementation/evidence in pkg/operations, pkg/call, internal/platform/handoffs.go, pkg/operations/invocation_test.go. [REQ-018]; owner agent_operations. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#agents-and-how-they-talk-to-each-other.
  • T019 [Plan:3.6] Pause agent, pause all and enforce control at every admission path. Native implementation/evidence in pkg/operations, internal/platform/agents.go, apps/web/src/AgentControls.tsx, internal/platform/operations_internal_test.go. [REQ-019]; owner agent_operations. Source: docs/reference/control-plane-gap-analysis.md#not-built.
  • T020 [Plan:3.7] Real console Stop control follows terminal ledger state. Native implementation/evidence in apps/web/src/Room.tsx, packages/web/src/AgentMessage.tsx, apps/web/src/RunStop.tsx, apps/web/src/room.dom.test.tsx. [REQ-020]; owner workspace_outcomes. Source: docs/reference/control-plane-gap-analysis.md#not-built.
  • T021 [Plan:3.8] Bounded Agent Network volumes, waiting time and blocked work. Native implementation/evidence in apps/web/src/AgentNetwork.tsx, internal/httpapi/operations_test.go. [REQ-021]; owner agent_operations. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#agents-and-how-they-talk-to-each-other.
  • T022 [Plan:3.9] Needs you deduplicates one cause and records its owner. Native implementation/evidence in pkg/inbox, internal/platform/inbox.go, pkg/inbox/reminders_test.go, internal/platform/operations_internal_test.go. [REQ-022]; owner agent_operations. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#control-plane-operations.
  • T023 [Plan:3.10] Roster exposes working, waiting, watching, paused, failed and last run. Native implementation/evidence in apps/web/src/Agents.tsx, apps/web/src/AgentControls.tsx, internal/platform/operations.go, apps/web/src/AgentOperations.tsx. [REQ-023]; owner agent_operations. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#agents-and-how-they-talk-to-each-other.

Phase 4: Sources and integrations

  • T024 [Plan:4.1] Source origin, owner, access mode and freshness are real and visible. Native implementation/evidence in pkg/knowledge, apps/web/src/conversation-sources.dom.test.tsx, apps/web/src/SourceLifecycle.tsx. [REQ-024]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#context-provenance-and-the-sync-lifecycle.
  • T025 [Plan:4.2] Durable source lifecycle, bounded attempts and last good copy. Native implementation/evidence in pkg/knowledge, internal/platform/source_lifecycle.go, pkg/knowledge/lifecycle_test.go, internal/platform/source_lifecycle_test.go. [REQ-025]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#context-provenance-and-the-sync-lifecycle.
  • T026 [Plan:4.3] Stale failures raise one cause and pause dependent work by stop rule. Native implementation/evidence in internal/platform/source_lifecycle.go, pkg/inbox, pkg/operations, internal/platform/source_assignment.go. [REQ-026]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#context-provenance-and-the-sync-lifecycle.
  • T027 [Plan:4.4] Indexed, live and hybrid honor the reader on every request. Native implementation/evidence in pkg/knowledge, internal/platform/knowledge.go, pkg/credentials, internal/platform/source_grounding_test.go. [REQ-027]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#context-access-modes.
  • T028 [Plan:4.5] Source dependency graph answers Used by without hidden names/counts. Native implementation/evidence in pkg/knowledge, internal/platform/source_attachments.go, internal/platform/source_rules.go. [REQ-028]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#system-foundations-and-phasing.
  • T029 [Plan:4.6] GitHub resources link to projects with explicit people mapping. Native implementation/evidence in pkg/clients, internal/platform/surfaces.go, apps/web/src/Clients.tsx, internal/platform/source_suggestions.go. [REQ-029]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#integrations.
  • T030 [Plan:4.7] Slack binding directions and guest approval boundaries. Native implementation/evidence in pkg/clients, pkg/projects/channels.go, apps/web/src/Clients.tsx, internal/platform/bridge_delivery_test.go. [REQ-030]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#integrations.
  • T031 [Plan:4.8] Drive and Notion provider paths use real API boundaries and references. Native implementation/evidence in pkg/knowledge, pkg/knowledge/provider_test.go, internal/platform/source_refresh_test.go. [REQ-031]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#integrations.
  • T032 [Plan:4.9] Connect Resources Links Access Events Actions report real state. Native implementation/evidence in apps/web/src/Clients.tsx, apps/web/src/ClientConnect.tsx, apps/web/src/Integrations.tsx, apps/web/src/integrations.dom.test.tsx. [REQ-032]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#integrations.
  • T033 [Plan:4.10] Suggest, auto-link and off rules are bounded, previewable and auditable. Native implementation/evidence in pkg/clients, pkg/sourcelinks/suggestions_test.go, internal/platform/source_rules_test.go, apps/web/src/integrations.dom.test.tsx. [REQ-033]; owner source_lifecycle. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#integrations.

Phase 5: Library, personal settings and audit

  • T034 [Plan:5.1] Versioned scoped skill drafts, tests, publish and promotion. Native implementation/evidence in internal/platform/skills.go, pkg/library/skills_test.go, internal/platform/skill_library_test.go, apps/web/src/SkillsLibrary.tsx. [REQ-034]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#skills-and-memory.
  • T035 [Plan:5.2] Skill and new-agent dry runs force actions to Ask. Native implementation/evidence in internal/platform/agent_setup_test.go, internal/platform/skill_library_test.go. [REQ-035]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#core-flows.
  • T036 [Plan:5.3] Memory scope, kind, provenance, review, expiry, usage and audited forget. Native implementation/evidence in pkg/memory, apps/web/src/MemoryLibrary.tsx, internal/platform/personal_context_test.go. [REQ-036]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#skills-and-memory.
  • T037 [Plan:5.4] Personal memory stays out of projects without explicit permission. Native implementation/evidence in pkg/memory, internal/platform/knowledge.go, internal/platform/personal_context_test.go, internal/platform/agent_skill_defaults_test.go. [REQ-037]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#skills-and-memory.
  • T038 [Plan:5.5] Personal profile and briefing style are persisted and used. Native implementation/evidence in pkg/prefs, apps/web/src/Settings.tsx, internal/httpapi/personal_profile_test.go, pkg/prefs/personal_test.go. [REQ-038]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#user-level-configuration-you.
  • T039 [Plan:5.6] Notification kind, digest and quiet-hour settings drive dispatch. Native implementation/evidence in pkg/prefs, internal/platform/notifications.go, internal/platform/notifications_test.go, internal/platform/email_notifications_test.go. [REQ-039]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#user-level-configuration-you.
  • T040 [Plan:5.7] Personal agents expose ownership, pause and project promotion. Native implementation/evidence in pkg/prefs, internal/platform/agents.go, apps/web/src/PersonalAgents.tsx, pkg/projects/personal_test.go. [REQ-040]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#user-level-configuration-you.
  • T041 [Plan:5.8] Connected accounts expose actual scopes, use and disconnect. Native implementation/evidence in pkg/credentials, apps/web/src/Connections.tsx, internal/platform/credentials_test.go, internal/httpapi/credentials_test.go. [REQ-041]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#user-level-configuration-you.
  • T042 [Plan:5.9] Cross-domain audit view is bounded, confined, durable and retained. Native implementation/evidence in pkg/audit, internal/httpapi/audit.go, apps/web/src/Audit.tsx, internal/httpapi/audit_test.go. [REQ-042]; owner library_personal. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#control-plane-operations.

Phase 6: Conversation and project interaction

  • T043 [Plan:6.1] Saved fork from message preserves bounded read-only history and lineage. Native implementation/evidence in pkg/threads, internal/platform/forks.go, apps/web/src/ForkConversation.tsx, internal/platform/forks_test.go. [REQ-043]; owner conversation_actions. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#forking.
  • T044 [Plan:6.2] Bring back result posts a reviewed result and never executes pending actions. Native implementation/evidence in internal/platform/forks.go, apps/web/src/ForkConversation.tsx, internal/platform/forks_test.go. [REQ-044]; owner conversation_actions. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#forking.
  • T045 [Plan:6.3] Project fork copies chosen structure/config safely, rules disabled. Native implementation/evidence in pkg/projects, internal/platform/project_forks.go, internal/platform/project_forks_test.go, pkg/projectforks/projectforks_test.go. [REQ-045]; owner conversation_actions. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#forking.
  • T046 [Plan:6.4] People shows actual audience, roles, removal and safe invitations. Native implementation/evidence in apps/web/src/ConversationShell.tsx, internal/platform/threads.go, apps/web/src/ConversationAccess.tsx, apps/web/src/conversation-sources.dom.test.tsx. [REQ-046]; owner conversation_actions. Source: docs/reference/control-plane-gap-analysis.md#partial.
  • T047 [Plan:6.5] Quick switcher returns bounded readable destinations only. Native implementation/evidence in internal/httpapi/discovery.go, apps/web/src/QuickSwitcher.tsx, internal/platform/discovery_test.go. [REQ-047]; owner conversation_actions. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#hierarchy-initiatives-projects-and-sub-projects.
  • T048 [Plan:6.6] Initiatives roll up status, risks, decisions, usage and needs safely. Native implementation/evidence in pkg/projects, internal/platform/projects.go, apps/web/src/Projects.tsx, internal/platform/project_rollup_test.go. [REQ-048]; owner conversation_actions. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#hierarchy-initiatives-projects-and-sub-projects.
  • T049 [Plan:6.7] Create project blank, template, fork or under initiative. Native implementation/evidence in apps/web/src/Projects.tsx, internal/platform/project_forks.go, pkg/projects/templates_test.go, apps/web/src/ForkProject.tsx. [REQ-049]; owner conversation_actions. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#hierarchy-initiatives-projects-and-sub-projects.

Phase 7: Outcomes, native deliverables and full workspace presentation

  • T050 [Plan:7.1] Outcomes lead with recommendation, decisions, deliverables and next action. Native implementation/evidence in packages/core/src/types.ts, packages/components/src/components.tsx, packages/web/src/AgentMessage.tsx, internal/platform/outcome_test.go. [REQ-050]; owner workspace_outcomes. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#summary-and-principles.
  • T051 [Plan:7.2] Redirect records revised intent separately from approval. Native implementation/evidence in packages/components/src/components.tsx, apps/web/src/Chat.tsx, apps/web/src/Room.tsx, apps/web/src/workspace.dom.test.tsx. [REQ-051]; owner workspace_outcomes. Source: docs/assets/workspace-prototype/index.html.
  • T052 [Plan:7.3] Completed work collapses; blocked work exposes result/input/output on demand. Native implementation/evidence in packages/web/src/AgentMessage.tsx, packages/components/src/components.tsx, apps/web/src/Activity.tsx, apps/web/src/activity.dom.test.tsx. [REQ-052]; owner workspace_outcomes. Source: docs/architecture/conversation-workspace.md#five-interactions.
  • T053 [Plan:7.4] Versioned native previews keep real bytes, provenance and parser bounds. Native implementation/evidence in apps/web/src/Deliverables.tsx, apps/web/src/artifactPreview.ts, pkg/nativefiles/tables_test.go, apps/web/src/artifactPreview.test.ts. [REQ-053]; owner workspace_outcomes. Source: docs/architecture/conversation-workspace.md#versioned-deliverables.
  • T054 [Plan:7.5] Native deliverables are real editable files, not prototype exports. Native implementation/evidence in pkg/artifacts, internal/platform/sandbox.go, apps/web/src/Deliverables.tsx, internal/platform/sandbox_test.go. [REQ-054]; owner workspace_outcomes. Source: docs/assets/workspace-prototype/README.md#try-the-interaction-loop.
  • T055 [Plan:7.6] Revision requests retain immutable version/slide context and unsent draft. Native implementation/evidence in apps/web/src/Deliverables.tsx, apps/web/src/Room.tsx, scripts/screens/workspace.ts, apps/web/src/workspace.dom.test.tsx. [REQ-055]; owner workspace_outcomes. Source: docs/architecture/conversation-workspace.md#versioned-deliverables.
  • T056 [Plan:7.7] Accepted outputs promote to knowledge/reviewed memory with audience checks. Native implementation/evidence in pkg/knowledge, pkg/memory, internal/platform/outcome_learning_race_test.go, internal/platform/outcome_learning_test.go. [REQ-056]; owner workspace_outcomes. Source: docs/architecture/conversation-workspace.md#follow-through.
  • T057 [Plan:7.8] Agent and human timestamps use recorded instants, hover/focus/tap and timezone. Native implementation/evidence in packages/web/src/AgentMessage.tsx, packages/adapter/src/fold.ts, apps/web/src/Room.tsx, apps/web/src/MessageTime.tsx. [REQ-057]; owner workspace_outcomes. Source: docs/reference/design-requirements.md#des-004-date-and-time-on-hover-or-focus.
  • T058 [Plan:7.9] Composer is compact, mobile safe, textual and permission aware. Native implementation/evidence in apps/web/src/Chat.tsx, apps/web/src/Room.tsx, packages/core/src/queue.test.ts, apps/web/src/chat.dom.test.tsx. [REQ-058]; owner workspace_outcomes. Source: docs/reference/control-plane-gap-analysis.md#partial.
  • T059 [Plan:7.10] Projects Library Operations You navigation exposes working routed pages. Native implementation/evidence in apps/web/src/Sidebar.tsx, apps/web/src/App.tsx, apps/web/src/route.ts, apps/web/src/route.test.ts. [REQ-059]; owner workspace_outcomes. Source: docs/rfcs/0001-agentic-workspace-control-plane.md#mental-model-and-information-architecture.
  • T060 [Plan:7.11] Phone/tablet/desktop, dark mode, keyboard and touch complete all journeys. Native implementation/evidence in scripts/screens/run.ts, apps/web/src/styles.css, scripts/screens/workspace.ts, scripts/screens/library.ts. [REQ-060]; owner workspace_outcomes. Source: docs/assets/workspace-prototype/README.md.
  • T061 [Plan:7.12] Saved-turn citations retain provenance and truthful indexed/live labels. Native implementation/evidence in pkg/runs, packages/adapter/src/run.ts, packages/web/src/AgentMessage.tsx, internal/platform/source_provenance_test.go. [REQ-061]; owner workspace_outcomes. Source: docs/reference/control-plane-gap-analysis.md#partial.
  • T062 [Plan:7.13] Presentation, notes, versions and downloads preserve immutable selection. Native implementation/evidence in apps/web/src/Deliverables.tsx, packages/web/src/ArtifactPreview.tsx, apps/web/src/workspace.dom.test.tsx, scripts/screens/native.ts. [REQ-062]; owner workspace_outcomes. Source: docs/assets/workspace-prototype/README.md#try-the-interaction-loop.
  • T063 [Plan:7.14] Identity, scope chips and punctuation follow repo accessibility/copy rules. Native implementation/evidence in packages/components/src/copy.ts, packages/core/src/types.ts, apps/web/src/ui.tsx, apps/web/src/Plus.tsx. [REQ-063]; owner workspace_outcomes. Source: AGENTS.md; docs/rfcs/0001-agentic-workspace-control-plane.md#objects-scopes-and-identity.
  • T064 [Plan:7.15] Every shipped capability has automated and honest live validation evidence. Native implementation/evidence in docs/plans/2026-10-workspace-implementation.md, docs/architecture/overview.md, scripts/screens/run.ts, docs/plans/2026-10-workspace-control-audit.md. [REQ-064]; owner root. Source: docs/reference/design-requirements.md#implementation-and-review-evidence.

Project structure

Existing packages retain their ownership. New domain records belong in their named pkg packages, composition in internal/platform, HTTP in internal/httpapi, shared presentation in packages/core/components/web, and console hosts in apps/web. Prototype HTML remains a design reference.

Testing strategy

  • Mixed SPA, HTTP API and Slack/GitHub surfaces. Critical journeys: private work to reviewed public outcome; source change to retained last-good context and one decision; durable assignment through handoff/pause/restart; fork and bring-back without action replay; native deliverable revision/presentation; human and agent message actions.
  • Regressions fail first. Memory/Postgres replay, cross-tenant/private confinement, bounded aggregates, admission races and denied actions are required for backend work.
  • Browser validation uses the real seeded server and existing scripts/screens at phone and desktop, with explicit dark/enlarged-text and relevant 320/768/1440 scenarios. Test fixtures are labelled, and are not live external-delivery evidence.
  • Shared local fixtures are isolated loopback Postgres/S3. Each test uses its own schema/prefix. Root owns fixture cleanup and the user preview on 8080.
  • Local checks: gofmt, golangci-lint v2, Go race suite with Postgres and no test skips, frozen install, Biome, typechecks, JS tests, real-server Slack tests, console build, spec lint, unchanged client generation, client checks, screens and Slack validation.
  • External providers require configured credentials and explicit installation scopes. Missing authorization is shown honestly. Do not create external registrations or send external messages merely to make a prototype control appear successful.

Requirement mapping

Requirement Source requirement Plan item Owner Implementation evidence
REQ-001 Complete requirement traceability and native verification 1.1 root implemented_native_checks_passed: docs/plans/2026-10-workspace-control-audit.md; docs/assets/workspace-implementation/control-audit.json
REQ-002 Badge outlines contain labels at narrow widths and enlarged text 1.2 root implemented_native_checks_passed: apps/web/src/ui.tsx; scripts/screens/run.ts
REQ-003 Copy and Reply share one consistent accessible action row 1.3 workspace_outcomes implemented_native_checks_passed: packages/web/src/MessageActionRow.tsx; apps/web/src/room.dom.test.tsx
REQ-004 Prototype controls become real authenticated state transitions 1.4 all implemented_native_checks_passed: api/openapi.yaml; internal/httpapi/openapi_test.go
REQ-005 Preserve agent identity, stable colors and compatibility history 1.5 root implemented_native_checks_passed: pkg/agentcolors; docs/reference/design-requirements.md
REQ-006 Durable bounded safe audit attempts underpin domain mutations 1.6 library_personal implemented_native_checks_passed: pkg/audit/audit_test.go; internal/platform/audit_test.go
REQ-007 Company is the root and every agent has an explicit home 2.1 company_placement implemented_native_checks_passed: pkg/projects/homes.go; internal/httpapi/personal_address_test.go
REQ-008 Idempotent durable personal project provisioning for human members 2.2 company_placement implemented_native_checks_passed: pkg/projects/personal_test.go; internal/httpapi/personal_address_test.go
REQ-009 Exact-owner personal read/write confinement, governance recorded 2.3 company_placement implemented_native_checks_passed: internal/platform/personal_context_test.go; internal/httpapi/confinement_test.go
REQ-010 Versioned current placement separate from immutable accounting 2.4 company_placement implemented_native_checks_passed: internal/platform/placement_projection_test.go; internal/platform/placement.go
REQ-011 Publish completed private work with audience preview and race safety 2.5 company_placement implemented_native_checks_passed: internal/platform/publication_race_test.go; internal/platform/summary_publication.go
REQ-012 One retained announcement banner above the greeting 2.6 company_placement implemented_native_checks_passed: internal/platform/welcome.go; apps/web/src/HomePage.tsx
REQ-013 Permission-filtered Find Help and safe retirement of new SME routing 2.7 company_placement implemented_native_checks_passed: internal/platform/find_help.go; apps/web/src/FindHelp.tsx
REQ-014 Durable assignment goal, owner, completion criteria and outcomes 3.1 agent_operations implemented_native_checks_passed: pkg/operations/operations_test.go; internal/platform/assignment_deadline_runtime_test.go
REQ-015 Standing work and triggers reuse scheduler, Invoke and pkg/call 3.2 agent_operations implemented_native_checks_passed: internal/platform/assignment_cron_recovery_test.go; internal/platform/assignment_sources_test.go
REQ-016 Inherited tighten-only Allow, Ask, Never action policy 3.3 agent_operations implemented_native_checks_passed: internal/platform/action_policy_view_test.go; apps/web/src/ActionPolicies.tsx
REQ-017 Named managers, escalation, reminders, budgets and stop rules 3.4 agent_operations implemented_native_checks_passed: internal/platform/operation_reminders_runtime_test.go; internal/platform/operation_reminders_test.go
REQ-018 Typed handoff contracts, deadlines, states, cycles and hop limits 3.5 agent_operations implemented_native_checks_passed: internal/platform/handoffs.go; pkg/operations/invocation_test.go
REQ-019 Pause agent, pause all and enforce control at every admission path 3.6 agent_operations implemented_native_checks_passed: internal/platform/operations_internal_test.go; apps/web/src/AgentControls.tsx
REQ-020 Real console Stop control follows terminal ledger state 3.7 workspace_outcomes implemented_native_checks_passed: apps/web/src/RunStop.tsx; apps/web/src/room.dom.test.tsx
REQ-021 Bounded Agent Network volumes, waiting time and blocked work 3.8 agent_operations implemented_native_checks_passed: apps/web/src/AgentNetwork.tsx; internal/httpapi/operations_test.go
REQ-022 Needs you deduplicates one cause and records its owner 3.9 agent_operations implemented_native_checks_passed: pkg/inbox/reminders_test.go; internal/platform/operations_internal_test.go
REQ-023 Roster exposes working, waiting, watching, paused, failed and last run 3.10 agent_operations implemented_native_checks_passed: internal/platform/operations.go; internal/platform/agent_skill_defaults_test.go
REQ-024 Source origin, owner, access mode and freshness are real and visible 4.1 source_lifecycle implemented_native_checks_passed: apps/web/src/conversation-sources.dom.test.tsx; apps/web/src/SourceLifecycle.tsx
REQ-025 Durable source lifecycle, bounded attempts and last good copy 4.2 source_lifecycle implemented_native_checks_passed: pkg/knowledge/lifecycle_test.go; internal/platform/source_lifecycle_test.go
REQ-026 Stale failures raise one cause and pause dependent work by stop rule 4.3 source_lifecycle implemented_native_checks_passed: internal/platform/source_assignment.go; internal/platform/source_operations_test.go
REQ-027 Indexed, live and hybrid honor the reader on every request 4.4 source_lifecycle implemented_native_checks_passed: internal/platform/source_grounding_test.go; internal/platform/source_privacy_test.go
REQ-028 Source dependency graph answers Used by without hidden names/counts 4.5 source_lifecycle implemented_native_checks_passed: internal/platform/source_dependency_reader.go; internal/platform/source_dependencies_test.go
REQ-029 GitHub resources link to projects with explicit people mapping 4.6 source_lifecycle implemented_live_authorization_pending: internal/platform/source_suggestions.go; pkg/integrations/github/runtime_test.go
REQ-030 Slack binding directions and guest approval boundaries 4.7 source_lifecycle implemented_live_authorization_pending: internal/platform/bridge_delivery_test.go; pkg/projects/bridge_direction_test.go
REQ-031 Drive and Notion provider paths use real API boundaries and references 4.8 source_lifecycle implemented_live_authorization_pending: pkg/knowledge/provider_test.go; internal/platform/source_refresh_test.go
REQ-032 Connect Resources Links Access Events Actions report real state 4.9 source_lifecycle implemented_native_checks_passed: apps/web/src/Integrations.tsx; apps/web/src/integrations.dom.test.tsx
REQ-033 Suggest, auto-link and off rules are bounded, previewable and auditable 4.10 source_lifecycle implemented_native_checks_passed: pkg/sourcelinks/suggestions_test.go; internal/platform/source_rules_test.go
REQ-034 Versioned scoped skill drafts, tests, publish and promotion 5.1 library_personal implemented_native_checks_passed: internal/platform/skill_usage.go; internal/httpapi/skill_usage_test.go
REQ-035 Skill and new-agent dry runs force actions to Ask 5.2 library_personal implemented_native_checks_passed: internal/platform/agent_setup_test.go; internal/platform/skill_library_test.go
REQ-036 Memory scope, kind, provenance, review, expiry, usage and audited forget 5.3 library_personal implemented_native_checks_passed: pkg/memory; apps/web/src/MemoryLibrary.tsx
REQ-037 Personal memory stays out of projects without explicit permission 5.4 library_personal implemented_native_checks_passed: internal/platform/personal_context_test.go; internal/platform/agent_skill_defaults_test.go
REQ-038 Personal profile and briefing style are persisted and used 5.5 library_personal implemented_native_checks_passed: internal/httpapi/personal_profile_test.go; pkg/prefs/personal_test.go
REQ-039 Notification kind, digest and quiet-hour settings drive dispatch 5.6 library_personal implemented_native_checks_passed: internal/platform/notifications_test.go; internal/platform/email_notifications_test.go
REQ-040 Personal agents expose ownership, pause and project promotion 5.7 library_personal implemented_native_checks_passed: apps/web/src/PersonalAgents.tsx; pkg/projects/personal_test.go
REQ-041 Connected accounts expose actual scopes, use and disconnect 5.8 library_personal implemented_native_checks_passed: internal/platform/credentials_test.go; internal/httpapi/credentials_test.go
REQ-042 Cross-domain audit view is bounded, confined, durable and retained 5.9 library_personal implemented_native_checks_passed: internal/httpapi/audit_test.go; internal/platform/audit_client_visibility_test.go
REQ-043 Saved fork from message preserves bounded read-only history and lineage 6.1 conversation_actions implemented_native_checks_passed: internal/platform/forks_test.go; pkg/threads/forks_test.go
REQ-044 Bring back result posts a reviewed result and never executes pending actions 6.2 conversation_actions implemented_native_checks_passed: internal/platform/forks_test.go; apps/web/src/ForkConversation.tsx
REQ-045 Project fork copies chosen structure/config safely, rules disabled 6.3 conversation_actions implemented_native_checks_passed: internal/platform/project_forks_test.go; pkg/projectforks/projectforks_test.go
REQ-046 People shows actual audience, roles, removal and safe invitations 6.4 conversation_actions implemented_native_checks_passed: apps/web/src/ConversationAccess.tsx; apps/web/src/conversation-sources.dom.test.tsx
REQ-047 Quick switcher returns bounded readable destinations only 6.5 conversation_actions implemented_native_checks_passed: internal/platform/discovery_test.go; apps/web/src/QuickSwitcher.tsx
REQ-048 Initiatives roll up status, risks, decisions, usage and needs safely 6.6 conversation_actions implemented_native_checks_passed: internal/platform/project_rollup_test.go; apps/web/src/ProjectRollup.tsx
REQ-049 Create project blank, template, fork or under initiative 6.7 conversation_actions implemented_native_checks_passed: pkg/projects/templates_test.go; apps/web/src/Projects.tsx
REQ-050 Outcomes lead with recommendation, decisions, deliverables and next action 7.1 workspace_outcomes implemented_native_checks_passed: internal/platform/outcome_test.go; packages/web/src/AgentMessage.tsx
REQ-051 Redirect records revised intent separately from approval 7.2 workspace_outcomes implemented_native_checks_passed: apps/web/src/Chat.tsx; apps/web/src/Room.tsx
REQ-052 Completed work collapses; blocked work exposes result/input/output on demand 7.3 workspace_outcomes implemented_native_checks_passed: packages/web/src/AgentMessage.tsx; apps/web/src/Activity.tsx
REQ-053 Versioned native previews keep real bytes, provenance and parser bounds 7.4 workspace_outcomes implemented_native_checks_passed: pkg/nativefiles/tables_test.go; apps/web/src/artifactPreview.test.ts
REQ-054 Native deliverables are real editable files, not prototype exports 7.5 workspace_outcomes implemented_native_checks_passed: internal/platform/sandbox_test.go; pkg/nativefiles/nativefiles_test.go
REQ-055 Revision requests retain immutable version/slide context and unsent draft 7.6 workspace_outcomes implemented_native_checks_passed: scripts/screens/workspace.ts; apps/web/src/workspace.dom.test.tsx
REQ-056 Accepted outputs promote to knowledge/reviewed memory with audience checks 7.7 workspace_outcomes implemented_native_checks_passed: internal/platform/outcome_learning_race_test.go; internal/platform/outcome_learning_test.go
REQ-057 Agent and human timestamps use recorded instants, hover/focus/tap and timezone 7.8 workspace_outcomes implemented_native_checks_passed: apps/web/src/MessageTime.tsx; apps/web/src/room.dom.test.tsx
REQ-058 Composer is compact, mobile safe, textual and permission aware 7.9 workspace_outcomes implemented_native_checks_passed: packages/core/src/queue.test.ts; apps/web/src/chat.dom.test.tsx
REQ-059 Projects Library Operations You navigation exposes working routed pages 7.10 workspace_outcomes implemented_native_checks_passed: apps/web/src/App.tsx; apps/web/src/Sidebar.tsx
REQ-060 Phone/tablet/desktop, dark mode, keyboard and touch complete all journeys 7.11 workspace_outcomes implemented_native_checks_passed: scripts/screens/run.ts; scripts/screens/workspace.ts
REQ-061 Saved-turn citations retain provenance and truthful indexed/live labels 7.12 workspace_outcomes implemented_native_checks_passed: internal/platform/source_provenance_test.go; pkg/runs/citations_test.go
REQ-062 Presentation, notes, versions and downloads preserve immutable selection 7.13 workspace_outcomes implemented_native_checks_passed: apps/web/src/Deliverables.tsx; apps/web/src/workspace.dom.test.tsx
REQ-063 Identity, scope chips and punctuation follow repo accessibility/copy rules 7.14 workspace_outcomes implemented_native_checks_passed: packages/components/src/copy.ts; apps/web/src/Plus.tsx
REQ-064 Every shipped capability has automated and honest live validation evidence 7.15 root implemented_native_checks_passed: docs/plans/2026-10-workspace-control-audit.md; docs/plans/2026-10-workspace-local-browser-validation.md
DES-001 Real integration results 4.8, 7.15 source_lifecycle, root Live checks recorded separately from configured credentials
DES-002 No decorative metadata dots 7.14 workspace_outcomes Shared copy/render checks
DES-003 Native persisted fork 6.1, 6.2 conversation_actions Fork lineage and isolation regressions
DES-004 Recorded full message times 7.8 workspace_outcomes Human/agent tooltip interaction and layout checks
DES-005 Discoverable honest implementation record 1.1 root This plan and architecture status
DES-006 Independent sidebar scrolling 7.11, 7.12 workspace_outcomes Existing Chromium wheel regression retained
DES-007 Badge containment 1.2 root Dark enlarged-text browser regression

Completion rule

Requirement mapping coverage is not implementation completeness. Root updates each evidence entry only after reviewing real code, its contract, failure/permission cases, persistence where applicable, and relevant browser state. The old gap analysis is a baseline to recheck, not a completion certificate.

Verified foundation checkpoint

PR #75 contains the message action row, badge containment, recorded agent timestamps, and ledger-confirmed Stop Turn. All 164 phone/desktop layouts, workspace typechecks/tests, console build and real-server Slack tests passed. The stacked audit foundation passed golangci-lint v2, the full Go race suite with real Postgres/S3 fixtures, spec lint, generated-client no-diff and client checks. This is historical lower-layer evidence; the current per-requirement statuses above supersede the original pending list.

Structured full-suite evidence on the shared foundation: 39 packages passed with Postgres and S3, zero failed packages and zero skipped tests. Concurrent main changes retain DES-006 for sidebar scrolling and DES-007 for badge containment.

Final native acceptance is recorded in the acceptance checkpoint. Live authorization for the three external-provider requirements remains explicitly pending.