TenantAtlas/specs/296-full-suite-green-signal-restoration/quickstart.md
ahmido 38523814c2 fix: restore full-suite green signals across platform workflows (#351)
## Summary
- restore broad full-suite green-signal coverage across platform governance, operations, onboarding, dashboard/productization, and customer review flows
- align related platform tests and supporting behavior with the current expected state for this restoration pass
- update the spec-candidates queue as part of the same suite-restoration sweep

## Validation
- `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Browser/Dashboard/TenantDashboardProductizationSmokeTest.php tests/Browser/Reviews/CustomerReviewWorkspaceSmokeTest.php tests/Browser/Spec194GovernanceFrictionSmokeTest.php tests/Browser/Spec265DecisionRegisterSmokeTest.php`

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #351
2026-05-12 18:50:40 +00:00

143 lines
3.0 KiB
Markdown

# Quickstart: Full Suite Green Signal Restoration
## 1. Safety Gate
```bash
git branch --show-current
git status --short
git diff --stat
```
Expected branch:
```text
296-full-suite-green-signal-restoration
```
Stop if unrelated uncommitted changes exist.
## 2. Read Context
```text
.specify/memory/constitution.md
specs/293-post-cutover-suite-stabilization/failure-classification.md
specs/294-provider-verification-runtime-semantics/failure-classification.md
specs/295-full-suite-ci-baseline/failure-classification.md
specs/295-full-suite-ci-baseline/tasks.md
```
## 3. Baseline
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact
```
If output is too broad or truncated:
```bash
./scripts/platform-test-lane fast-feedback
./scripts/platform-test-lane confidence
./scripts/platform-test-lane heavy-governance
./scripts/platform-test-lane browser
```
Record groups in `failure-inventory.md` before repair.
## 4. Guard Lanes
Run the Spec 288 guard lane from `spec.md`.
Run the Spec 293 cutover lane from `spec.md`.
Run:
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact tests/Feature/ProviderConnections tests/Feature/Verification
```
Repair guard failures first.
## 5. Repair Loop
For every failure group:
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact <test-file>
```
Then:
1. Read owner code.
2. Classify the group.
3. Apply the smallest fix.
4. Rerun focused file.
5. Rerun affected lane.
6. Update `failure-inventory.md`.
7. Update `fix-log.md`.
## 6. Browser Evidence
Before browser work:
```bash
mkdir -p /tmp/tenantpilot-296-browser-evidence
cp -R apps/platform/tests/Browser/Screenshots/* /tmp/tenantpilot-296-browser-evidence/ || true
```
After browser runs:
```bash
git status --short apps/platform/tests/Browser/Screenshots
git diff --stat apps/platform/tests/Browser/Screenshots
```
Do not commit screenshot baselines unless `browser-evidence.md` documents the file and reason.
## 7. Final Validation
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact
./vendor/bin/sail artisan test --compact tests/Feature/ProviderConnections tests/Feature/Verification
./vendor/bin/sail bin pint --dirty --format agent
git diff --check
```
Also run Spec 288 and Spec 293 command blocks from `spec.md`.
If browser files changed:
```bash
./scripts/platform-test-lane browser
```
## 8. Final Answer Data
Report:
```text
- Full Suite: green / not green
- Anzahl Tests / Assertions
- Spec 288 Guard Lane: green / not green
- Spec 293 Cutover Lane: green / not green
- Spec 294 Provider/Verification Lane: green / not green
- Browser Lane: green / not green / N/A
- Pint: green / not green
- git diff --check: green / not green
- Runtime files changed
- Test files changed
- Spec artifacts changed
- Screenshots changed? yes/no
- Screenshots committed? yes/no and why
- Welche Root Causes wurden gefixt?
- Welche Tests wurden rebaselined?
- Welche Tests wurden verschoben/skipped?
- Gibt es Restfehler?
- Ist Tenant Cutover formal abgeschlossen?
- Ist Full Suite wieder belastbares CI-Signal?
```