refactor(monorepo): remove root cmd entrypoints

2026-03-20 14:25:50 +08:00
parent d00b2a30ee
commit bc08feda59
30 changed files with 231 additions and 176 deletions
@@ -0,0 +1,60 @@
+# Remove Root Cmd Compatibility Shims
+
+## Status
+
+- `completed`
+
+## Owner
+
+- Codex
+
+## Started At
+
+- `2026-03-20`
+
+## Goal
+
+- Remove the legacy root `cmd/` compatibility shims now that package-owned runtimes are the source of truth, and clean up the remaining current docs and test indexes that still point at deleted root runtime paths.
+
+## Scope
+
+- remove root `cmd/inbox`, `cmd/orch`, and `cmd/orchd`
+- update current docs and test-plan indexes that still reference removed root runtime paths
+- keep package-owned runtime workflows and skill packaging validated after the cleanup
+
+## Checklist
+
+- [x] inspect remaining references to root `cmd/` and deleted root `internal/` runtime paths
+- [x] update current docs and test indexes to point at package-owned runtime paths
+- [x] remove the root `cmd/` files and any now-unneeded root shim wiring
+- [x] validate package-owned runtime and skill packaging workflows after the cleanup
+- [x] update roadmap state and archive this workstream if complete
+
+## Files
+
+- `docs/roadmaps/archive/remove-root-cmd-compat-shims.md`
+- `cmd/`
+- `docs/implementation-roadmap.md`
+- `docs/tests/`
+- `docs/skill-workspace-monorepo.md`
+- `docs/web-product-monorepo.md`
+- `go.mod`
+
+## Decisions
+
+- treat archived roadmaps as historical records; fix only current source-of-truth docs and current test indexes unless a broken archived reference blocks real workflows
+
+## Blockers
+
+- none
+
+## Next Step
+
+- continue routine feature work on top of the package-owned runtime workspace without recreating root-owned Go entrypoints
+
+## Completion Summary
+
+- updated the current inbox and orch test-plan indexes so they now point at package-owned runtime test files instead of deleted root `internal/cli/*` paths
+- removed the root `cmd/` compatibility shims and the now-unneeded root Go module files so package-owned runtimes under `packages/*/cmd/*` are the only maintained Go entrypoints
+- added a root `pnpm run go:test` script that validates package-owned Go runtimes directly, replacing reliance on a root Go module
+- synchronized the current implementation and web monorepo docs with the package-owned runtime layout after the cleanup