# 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?
```

