{
  "id": "page:docs-agent-mux-archive-design-20-tui-kanban-workspaces",
  "_kind": "Page",
  "_file": "wiki/docs/agent-mux/archive/design/20-tui-kanban-workspaces.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/agent-mux/archive/design/20-tui-kanban-workspaces.md",
    "sourceKind": "repo-docs",
    "title": "Agent Mux TUI Kanban + Workspaces Design",
    "displayName": "Agent Mux TUI Kanban + Workspaces Design",
    "slug": "docs/agent-mux/archive/design/20-tui-kanban-workspaces",
    "articlePath": "wiki/docs/agent-mux/archive/design/20-tui-kanban-workspaces.md",
    "article": "\n# Agent Mux TUI Kanban + Workspaces Design\n\n## Summary\n\nThis design proposal covers adding `kanban` and `workspaces` views to `packages/agent-mux/tui` as a thin presentation and command layer over existing `packages/kanban` and `packages/agent-mux/core` seams.\n\nThe key architectural decision is simple:\n\n- `packages/agent-mux/tui` owns Ink rendering, navigation, and action invocation\n- `packages/kanban` remains the owner of backlog policy and workspace/worktree lifecycle\n- `packages/agent-mux/core` remains the shared type contract\n\n## Why this direction\n\nThe repository already has the hard parts:\n\n- shared kanban/workspace types in `packages/agent-mux/core/src/kanban.ts`\n- backlog policy and issue mutation logic in `packages/kanban/src/lib/services/backlog-query-service.ts`\n- worktree-aware workspace lifecycle logic in `packages/kanban/src/lib/workspace-lifecycle.ts`\n- MCP tool surfaces in `packages/kanban/src/mcp/tools/backlog.ts` and `packages/kanban/src/mcp/tools/workspaces.ts`\n\nDuplicating those behaviors in the TUI would create:\n\n- divergent issue/workspace mutation rules\n- duplicated worktree inventory logic\n- higher regression risk across CI/release and staging publish flows\n\n## Proposed package seams\n\n### `packages/agent-mux/tui`\n\nAdd:\n\n- a package-local integration adapter for kanban/workspace state\n- `kanban` and `workspaces` plugins under `src/plugins/`\n- cross-view navigation wiring in `src/app.tsx`\n- command-palette and hotkey integration\n- view-contract and feature tests\n\n### `packages/agent-mux/core`\n\nOnly add or refine shared types here when the TUI needs a stable contract that does not yet exist.\n\nDo not import `packages/kanban` private service result types into the TUI if they should be shared.\n\n### `packages/kanban`\n\nKeep ownership of:\n\n- backlog state and mutation policy\n- workspace/worktree lifecycle\n- issue-to-workspace provisioning and linking\n\nRefine tool payloads or typed seams only where the TUI integration proves a real contract gap.\n\n## View model expectations\n\n### `kanban`\n\nThe first phase can start with a backlog/issue-centric presentation instead of a dense ncurses-style board.\n\nThe important requirement is that it exposes:\n\n- issue state\n- dispatch/readiness state\n- repository lifecycle state\n- workspace/session linkage\n- management actions\n\n### `workspaces`\n\nThe workspaces surface must stay worktree-aware.\n\nIt should expose:\n\n- workspace path/name/branch/head\n- primary repo vs linked worktree state\n- archived/missing/rebase states\n- linked issue context\n- active session/run context\n- lifecycle actions\n\n## CI and publish implications\n\nThis feature touches both `@a5c-ai/agent-mux-tui` and the shared kanban/workspace release-critical surfaces.\n\nThat means implementation needs to remain compatible with:\n\n- `.github/workflows/ci.yml`\n- `.github/workflows/release.yml`\n- `.github/workflows/staging-publish.yml`\n\nIt also means the TUI package should ship its new `specs/` directory if the README links to those planning artifacts.\n\n## Planning artifacts\n\nThe canonical planning artifacts for this proposal are:\n\n- `packages/agent-mux/tui/specs/kanban-workspaces-spec.md`\n- `packages/agent-mux/tui/specs/kanban-workspaces-subtasks.md`\n- `.a5c/processes/agent-mux-tui-kanban-workspaces-planning.js`\n- `.a5c/processes/specs/agent-mux-tui-kanban-workspaces-planning-request.md`\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-agent-mux-archive-design",
      "to": "page:docs-agent-mux-archive-design-20-tui-kanban-workspaces",
      "kind": "contains_page"
    }
  ]
}