---
phase: 02
slug: external-sync-integrations
status: complete
nyquist_compliant: true
wave_0_complete: true
created: 2026-03-11
---

# Phase 02 — Validation Strategy

> Per-phase validation contract for feedback sampling during execution.

---

## Test Infrastructure

| Property | Value |
|----------|-------|
| **Framework** | Rust built-in test runner (`cargo test`) |
| **Config file** | `Cargo.toml` workspace (no separate test config) |
| **Quick run command** | `cargo test -p service sync -- --nocapture` |
| **Full suite command** | `cargo test --workspace` |
| **Estimated runtime** | ~30 seconds |

---

## Sampling Rate

- **After every task commit:** Run `cargo test -p service sync -- --nocapture`
- **After every plan wave:** Run `cargo test --workspace`
- **Before `/gsd:verify-work`:** Full suite must be green
- **Max feedback latency:** 30 seconds

---

## Per-Task Verification Map

| Task ID | Plan | Wave | Requirement | Test Type | Automated Command | File Exists | Status |
|---------|------|------|-------------|-----------|-------------------|-------------|--------|
| 02-01-01 | 01 | 1 | DATA-01 | unit | `cargo test -p service -- github_ingest_mapping_skips_invalid` | ✅ | ✅ green |
| 02-01-02 | 01 | 1 | DATA-01 | unit | `cargo test -p service -- github_ingest_tests_computes` | ✅ | ✅ green |
| 02-02-01 | 02 | 1 | DATA-02 | unit | `cargo test -p service -- shopify_sync_tests` | ✅ | ✅ green |
| 02-02-02 | 02 | 1 | DATA-03 | unit | `cargo test -p service -- shopify_sync_tests` | ✅ | ✅ green |
| 02-03-01 | 03 | 2 | DATA-07 | unit | `cargo test -p service -- scheduler_backoff_grows` | ✅ | ✅ green |
| 02-03-02 | 03 | 2 | DATA-07 | unit | `cargo test -p service -- sync_status_policy_only` | ✅ | ✅ green |
| 02-03-03 | 03 | 2 | DATA-07 | unit | `cargo test -p service -- scheduler_tests_adapts` | ✅ | ✅ green |
| 02-04-01 | 04 | 3 | DATA-01/02/03 | unit | `cargo test -p service -- merge_precedence` | ✅ | ✅ green |
| 02-04-02 | 04 | 3 | DATA-01/02/03 | unit | `cargo test -p service -- merge_conflicts_and_overrides` | ✅ | ✅ green |
| 02-04-03 | 04 | 3 | DATA-01/02/03 | unit | `cargo test -p service -- merge_pipeline_tests` | ✅ | ✅ green |

*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*

---

## Wave 0 Requirements

Existing infrastructure covers all phase requirements.

---

## Manual-Only Verifications

| Behavior | Requirement | Why Manual | Test Instructions |
|----------|-------------|------------|-------------------|
| Polling runs every 5 min without destabilizing UI | DATA-07 | Requires real timer + UI interaction | Start app, trigger sync, verify UI remains responsive during poll cycle |

---

## Validation Sign-Off

- [x] All tasks have `<automated>` verify or Wave 0 dependencies
- [x] Sampling continuity: no 3 consecutive tasks without automated verify
- [x] Wave 0 covers all MISSING references
- [x] No watch-mode flags
- [x] Feedback latency < 30s
- [x] `nyquist_compliant: true` set in frontmatter

**Approval:** approved

---

## Validation Audit 2026-03-11

| Metric | Count |
|--------|-------|
| Gaps found | 0 |
| Resolved | 0 |
| Escalated | 0 |

All 10 mapped tests verified green. 3 additional integration-crate tests also passing (github_project_client x2, shopify_order_fulfillment_client x1). Test commands corrected with `--` separator.
