# Grand Project - Special One Preparation Package

## GPO Snapshot
- Snapshot timestamp: 2026-08-21 08:10:08 Pacific/Auckland
- Project: GP-PROJ-001 - Grand Project
- Overall state: 34.0% complete
- Canonical SHA: 82091a1ed67f8b40b48c63111cd2953c4f82bc86
- Documentation state: current through CMD-20260820-003; health Healthy

## Previous Round Closure
- Previous milestone/run: GP-M10 - SEO / Public Surface Optimization
- Git closure state: Recorded canonical SHA 82091a1ed67f8b40b48c63111cd2953c4f82bc86
- CI/smoke state: evidence exists in the reconciled roadmap and test history, with current review items still tracked separately.

## Current Milestone
- Current/next milestone: GP-M02 - COMPANIES & RELATIONSHIPS FOUNDATION
- Ready queue count: 1
- Review queue count: 2
- Candidate queue kind: ready
- Candidate work item count: 1

## Ready Work
- GP-COMP-012: Admin company management UI. [Ready] (GP-M02)

## Review Items
- GP-COMP-010: Tenant isolation. [Needs Review] (GP-M02)
- GP-COMP-017: Tenant isolation tests. [Needs Review] (GP-M02)

## Recommended Round Objective
- Work the ready queue in milestone order.

## Workstreams
## Admin company management UI.
- Task IDs: GP-COMP-012
- Existing Minion: MINION-08
- Objective: Admin company management UI.
- Detailed Objective: Admin company management UI.
- Dependencies: GP-COMP-003, GP-COMP-011
- Relevant Components: Core Platform/Common Application Framework/src/CompaniesRelationships/CompaniesRelationshipsService.php, Plugin Modules/Companies & Relationships/COMPANIES-RELATIONSHIPS-FOUNDATION.md, Plugin Modules/Companies & Relationships/database/migrations/2026_08_13_000001_create_companies_relationships_tables.php, Plugin Modules/Companies & Relationships/routes/api.php, Plugin Modules/Companies & Relationships/routes/web.php, app/routers/dashboard.py, app/templates/base.html, app/templates/dashboard.html
- Acceptance Criteria: GP-COMP-012 is implemented against the canonical GPO state., GP-COMP-012 is validated through the relevant route or service test coverage., The public dashboard and generated handoff remain consistent.
- Required Tests: python -m pytest tests/test_next_round.py, python -m pytest tests/test_documentation_part_d.py, php tests/smoke/companies-relationships-installation.php, php tests/smoke/companies-relationships-contract.php, php tests/smoke/company-relationship-context.php
- Collision Risk: Low
- Parallelisation Suitability: Safe Parallel
- Why Now: GP-COMP-012 is Ready, GP-M01 is closed, and MINION-08 can be reused.

## Parallelisation
- Classification: Safe Parallel
- Reason: Only one ready workstream exists, so no scheduling collision is expected.

## Integration Order
- Document Generator first, Notifications second, then review the SEO carry-forward items if they remain unresolved.

## Minions On Demand
- Reuse a suitable existing Minion when one exists.
- Do not create a new Minion merely because a new workstream exists.
- Create a Minion only when the work is genuinely independent, no existing Minion is suitable, and ownership boundaries are safe.
- Register any new Minion in the coordinator control plane.
- MINION-10 remains the persistent Documentation Helper.

## Documentation Helper Gate
- Current documentation helper state: Healthy
- Documentation action: verify/no-op

## Git Startup Gate
- Previous completed accepted work must be committed, pushed, and synchronized before new work starts.

## Required Validation
- Preserve canonical hostname handling.
- Validate the changed routes and generated outputs through the public dashboard.
- Keep review items out of the ready queue until evidence supports promotion.

## Git Closure Gate
- Integration -> validation -> CI -> smoke tests -> documentation -> commit -> push -> remote SHA verification -> round closure.

## Completion Criteria
- The ready work is integrated and validated.
- The documentation helper is current or explicitly no-op.
- The generated prompt can be pasted directly into ChatGPT or Special One.
- The next-round plan is saved with a stable ID and current snapshot.

## Carry-Forward / Review Items
- GP-COMP-010, GP-COMP-017

## GPO Context
- Project: GP-PROJ-001 - Grand Project
- Canonical URL: https://gpo.jamie.waltons.co.nz
- Persistent helper: MINION-10