# Quickstart (096 Ops Polish Bundle)

This spec is background-operations only (no new routes/pages). Verification is via Pest tests and seed workflows.

## Prereqs

- Start Sail: `vendor/bin/sail up -d`

## Run targeted tests (recommended during implementation)

- Run a single spec-focused file (once created):
  - `vendor/bin/sail artisan test --compact tests/Feature/OpsPolishBundleTest.php`

- Or run by filter:
  - `vendor/bin/sail artisan test --compact --filter=assignment`
  - `vendor/bin/sail artisan test --compact --filter=dedupe`
  - `vendor/bin/sail artisan test --compact --filter=reconcile`

## Verify seeding DX

- Reset + seed:
  - `vendor/bin/sail artisan migrate:fresh --seed --no-interaction`

- Expectation:
  - Seed completes without DB constraint errors.
  - Seeded tenant has `external_id` formatted as UUID v4.

## Formatting

- Run Pint on changed files:
  - `vendor/bin/sail bin pint --dirty`

## Strategic Health Audit (evidence-based checklist)

This repo does not have a single “audit” command. For Spec 096 we treat the audit as a small bundle of objective gates.

### Gate 1 — Full suite

- `vendor/bin/sail artisan test --compact`

### Gate 2 — PostgreSQL schema/constraints suite

- `vendor/bin/sail composer test:pgsql`

### Gate 3 — Seed DX

- `vendor/bin/sail artisan migrate:fresh --seed --no-interaction`

**Pass criteria:** all 3 gates succeed.

### Evidence links (tests)

- A (summary persistence): `tests/Feature/Operations/AssignmentRunSummaryCountsTest.php`
- B (dedupe + cooldown): `tests/Feature/Operations/AssignmentJobDedupeTest.php`
- C (reconcile tracking + overlap): `tests/Feature/Operations/ReconcileAdapterRunsJobTrackingTest.php`
- D (seed UUID + DX): `tests/Feature/Seed/PoliciesSeederExternalIdTest.php`
