Run the v1.0.0 acceptance pass against a real collection #53

Open
opened 2026-07-28 04:59:59 +00:00 by claude-bot · 0 comments

Context

Every milestone has its own exit criteria, and CI verifies the suite on every push. What
none of that establishes is whether the finished product actually works on a real family
collection at real scale — which is the only question v1.0.0 genuinely turns on.

Scope

A full acceptance pass over the complete feature set against a real collection.

Implementation notes

  • Verify the acceptance criteria from all four phases in docs/circa-spec.md section 14,
    as a checklist, against the built software.
  • Run against a real collection of meaningful size, not seeded fixtures. Real scans carry
    the messy filenames, missing backs, odd EXIF, and genuine near-duplicates that fixtures
    never reproduce — those are exactly the cases worth finding before declaring 1.0.
  • Walk the complete journey: scan, ingest, AI and OCR analysis, review, resolve duplicates,
    propagate constraints, dispute and resolve with a second reviewer, back up, and export.
  • Verify the export output independently of Circa: check the manifest hashes, confirm EXIF
    dates read correctly in a normal photo application, and confirm the folder structure
    matches the spec.
  • Exercise restore from backup into a scratch environment, proving the backup is real.
  • Record anything found as issues rather than fixing in place, so the trail is preserved.
  • Measure how long reviewing a batch actually takes — if the workflow is too slow to be
    used at collection scale, that is a v1.0.0 finding regardless of correctness.
  • Confirm the review history has been preserved intact throughout: no lost decisions, no
    broken provenance chains, no missing audit events.

Done when

  • Every phase acceptance criterion is verified against the built software
  • The full journey completes on a real collection
  • Export output is verified independently of Circa
  • Restore from backup is proven in a scratch environment
  • Review history and audit trail are confirmed intact
  • Findings are recorded as issues and triaged before release

References

  • docs/circa-spec.md section 14 (phase acceptance criteria)
  • docs/circa-phase1-plan.md section 12

Depends on: every other milestone.

## Context Every milestone has its own exit criteria, and CI verifies the suite on every push. What none of that establishes is whether the finished product actually works on a real family collection at real scale — which is the only question v1.0.0 genuinely turns on. ## Scope A full acceptance pass over the complete feature set against a real collection. ## Implementation notes - Verify the acceptance criteria from all four phases in `docs/circa-spec.md` section 14, as a checklist, against the built software. - Run against a real collection of meaningful size, not seeded fixtures. Real scans carry the messy filenames, missing backs, odd EXIF, and genuine near-duplicates that fixtures never reproduce — those are exactly the cases worth finding before declaring 1.0. - Walk the complete journey: scan, ingest, AI and OCR analysis, review, resolve duplicates, propagate constraints, dispute and resolve with a second reviewer, back up, and export. - Verify the export output independently of Circa: check the manifest hashes, confirm EXIF dates read correctly in a normal photo application, and confirm the folder structure matches the spec. - Exercise restore from backup into a scratch environment, proving the backup is real. - Record anything found as issues rather than fixing in place, so the trail is preserved. - Measure how long reviewing a batch actually takes — if the workflow is too slow to be used at collection scale, that is a v1.0.0 finding regardless of correctness. - Confirm the review history has been preserved intact throughout: no lost decisions, no broken provenance chains, no missing audit events. ## Done when - [ ] Every phase acceptance criterion is verified against the built software - [ ] The full journey completes on a real collection - [ ] Export output is verified independently of Circa - [ ] Restore from backup is proven in a scratch environment - [ ] Review history and audit trail are confirmed intact - [ ] Findings are recorded as issues and triaged before release ## References - `docs/circa-spec.md` section 14 (phase acceptance criteria) - `docs/circa-phase1-plan.md` section 12 Depends on: every other milestone.
claude-bot added this to the v1.0.0 milestone 2026-07-28 04:59:59 +00:00
Sign in to join this conversation.
No description provided.