Implements Spec 110 Ops‑UX Enforcement and applies the repo‑wide “enterprise” standard for operation start + dedup surfaces. Key points - Start surfaces: only ephemeral queued toast (no DB notifications for started/queued/running). - Dedup paths: canonical “already queued” toast. - Progress refresh: dispatch run-enqueued browser event so the global widget updates immediately. - Completion: exactly-once terminal DB notification on completion (per Ops‑UX contract). Tests & formatting - Full suite: 1738 passed, 8 skipped (8477 assertions). - Pint: `vendor/bin/sail bin pint --dirty --format agent` (pass). Notable change - Removed legacy `RunStatusChangedNotification` (replaced by the terminal-only completion notification policy). Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #134
38 lines
1.5 KiB
Markdown
38 lines
1.5 KiB
Markdown
# Specification Quality Checklist: Ops-UX Enforcement & Cleanup (Enterprise Standard Rollout)
|
||
|
||
**Purpose**: Validate specification completeness and quality before proceeding to planning
|
||
**Created**: 2026-02-23
|
||
**Feature**: [spec.md](../spec.md)
|
||
|
||
## Content Quality
|
||
|
||
- [x] No implementation details (languages, frameworks, APIs)
|
||
- [x] Focused on user value and business needs
|
||
- [x] Written for non-technical stakeholders
|
||
- [x] All mandatory sections completed
|
||
|
||
## Requirement Completeness
|
||
|
||
- [x] No [NEEDS CLARIFICATION] markers remain
|
||
- [x] Requirements are testable and unambiguous
|
||
- [x] Success criteria are measurable
|
||
- [x] Success criteria are technology-agnostic (no implementation details)
|
||
- [x] All acceptance scenarios are defined
|
||
- [x] Edge cases are identified
|
||
- [x] Scope is clearly bounded
|
||
- [x] Dependencies and assumptions identified
|
||
|
||
## Feature Readiness
|
||
|
||
- [x] All functional requirements have clear acceptance criteria
|
||
- [x] User scenarios cover primary flows
|
||
- [x] Feature meets measurable outcomes defined in Success Criteria
|
||
- [x] No implementation details leak into specification
|
||
|
||
## Notes
|
||
|
||
- All items pass.
|
||
- Spec includes the mandatory UI Action Matrix and explicitly states “no new screens” while allowing targeted start-surface cleanup.
|
||
- Remediation targets are enumerated in the spec’s “Known Violations” tables; the executable task list is the single source of truth in `tasks.md`.
|
||
- Guard tests (FR-012) are specced as static analysis (filesystem scan) with explicit allowlist, so they fail fast with actionable output.
|