Track HiveGrid Cloud planning reference

hivegrid-cloud/docs/archive/architecture-handoff-summary.md

@@ -0,0 +1,69 @@
+# Architecture Closure Handoff Summary
+
+> **Archived status surface:** this document is preserved as the official
+> Architecture Closure record. It remains referenced by static closure tests,
+> but current runtime truth still comes from the canonical sources listed
+> below.
+
+## Closure scope
+
+Architecture Closure closes as a documentation, manifest, and static-verification handoff contract for the architecture migration state. It does not claim that every runtime feature has already been extracted, removed, or rewritten; the `@toolctrl/web` React Router runtime in `apps/web/app` remains authoritative, with root scripts delegating to it, until later sequential tasks replace specific surfaces directly. The closure package ties together current boundary status, feature pruning decisions, manifest contracts, bundle evidence, and executor entrypoints so future agents can start from one consistent contract.
+
+R001 is supported by complete Architecture Closure handoff coverage across the closure documents, feature manifests, static tests, and this summary. R002 is preserved by requiring sequential follow-up order and by avoiding any assumption that downstream feature slices can run in parallel or rely on parallel runtime changes.
+
+## Canonical sources
+
+Future agents should treat these files as the canonical Architecture Closure coverage set:
+
+- `docs/architecture-migration-status.md` — current API, worker, package, pruning, URL-boundary, and bundle/performance handoff status.
+- `docs/feature-inventory.md` — human-readable Core, Plugin, and Removal inventory for boilerplate pruning.
+- `docs/feature-manifests/README.md` — executor-facing manifest contract and update rules.
+- `docs/feature-manifests/*.json` — machine-readable ownership, dependency, configuration, provider, worker, UAT, and pruning contracts.
+- `docs/agent-entrypoints.md` — first-stop routing for future feature, MVP import, admin-managed, worker-backed, UI, and Architecture Closure closure work.
+- `apps/web/app/application/architectureClosureDocs.test.ts` — static closure assertions for Architecture Closure source alignment, closure status, pruning actions, and S04 evidence.
+- `apps/web/app/application/featureManifests.test.ts` — manifest schema, dependency, secret ownership, worker declaration, config, and queue validation.
+
+## Requirement coverage
+
+- R001: covered by the aligned handoff sources above, the explicit Architecture Closure final closure status in `docs/architecture-migration-status.md`, the feature inventory, manifest README, JSON manifests, agent entrypoints, and static tests that guard those references.
+- R002: covered by the sequential follow-up order below. Do not assume parallel feature-slice execution, parallel runtime ownership, or hidden migration completion outside the documented source set.
+- R003 and pruning continuity: use `docs/feature-inventory.md` plus `docs/feature-manifests/*.json` before implementing, extracting, or removing features. Manifest classifications are action contracts (`core`, `plugin-candidate`, `remove-candidate`, or `mixed`), not permanent legacy-support promises.
+- S04 bundle/performance continuity: consult the bundle evidence referenced from `docs/architecture-migration-status.md`; optional production-build verification remains manual unless explicitly approved outside Auto-Mode.
+
+## Full non-E2E gate commands
+
+Run these focused non-E2E gates when closing or revalidating the Architecture Closure handoff contract:
+
+```sh
+pnpm exec vitest run apps/web/app/application/architectureClosureDocs.test.ts apps/web/app/application/featureManifests.test.ts
+pnpm exec eslint --ext .tsx,.ts docs apps/web/app/application --max-warnings=0
+pnpm typecheck
+```
+
+No E2E, browser, Cypress, or Playwright execution is part of this Auto-Mode closure gate.
+
+## Sequential follow-up order
+
+Future work should proceed in this order:
+
+1. Read `docs/agent-entrypoints.md` and route the work to the relevant playbook before implementation.
+2. Read `docs/architecture-migration-status.md` for current boundary status and explicit skeleton-only versus runtime-wired ownership.
+3. Read `docs/feature-inventory.md` for the human-readable Core, Plugin, and Removal decision context.
+4. Read `docs/feature-manifests/README.md` and the matching `docs/feature-manifests/*.json` files.
+5. Update or add the relevant manifest contract before changing feature code when ownership, configuration, provider, worker, UAT, or pruning behavior changes.
+6. Implement one atomic migration, extraction, removal, or replacement step at a time, keeping the root runtime authoritative until that step directly replaces it.
+7. Re-run the relevant static tests and scoped lint/test commands for the changed surface before continuing to the next step.
+
+This order intentionally preserves R002 by preventing downstream agents from treating separate migration slices as parallel prerequisites.
+
+## Manual build note
+
+`pnpm build` remains an optional manual follow-up for production bundle behavior and deployment confidence. It is not an Auto-Mode completion gate for this handoff task, and lack of an Auto-Mode build run does not weaken the static Architecture Closure closure contract.
+
+## Future-agent start points
+
+- For any new or migrated feature, start at `docs/agent-entrypoints.md`, then follow `docs/agent-playbooks/feature-integration.md` and the relevant manifest.
+- For plugin extraction or pruning work, start with `docs/feature-inventory.md`, `docs/feature-manifests/README.md`, and the matching `docs/feature-manifests/*.json` contract.
+- For architecture boundary questions, start with `docs/architecture-migration-status.md` and keep runtime-wired versus skeleton-only distinctions intact.
+- For closure verification, start with `apps/web/app/application/architectureClosureDocs.test.ts` and `apps/web/app/application/featureManifests.test.ts`.
+- For optional production bundle confidence, schedule manual `pnpm build` after the static non-E2E gate instead of treating it as an Auto-Mode requirement.