Skip to content

docs(spec): repoint 95 citations at case-flow-human-steps' canonical specs - #2426

Merged
rubenvdlinde merged 1 commit into
developmentfrom
fix/case-flow-human-steps-citations
Sep 11, 2026
Merged

rubenvdlinde merged 1 commit into
developmentfrom
fix/case-flow-human-steps-citations

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

openspec/changes/case-flow-human-steps/ was archived on 2026-09-09. Every @spec / @e2e citation that named the change's own spec files kept pointing at the old path, which no longer exists: 95 citations across 32 files in lib/, src/ and tests/, all resolving to nothing.

The change's three delta specs were synced into the canonical tree on archive, so each citation now points there:

openspec/changes/case-flow-human-steps/specs/<cap>/spec.md
  -> openspec/specs/<cap>/spec.md
Capability Citations
case-flow-human-steps 63
task-management 16
status-transition-engine 16

All three canonical files exist. The canonical spec is preferred over the archive copy because it is the one kept current.

Verified as mechanical, not assumed

Scripted, so the diff rather than the command is the evidence:

  • The pattern is the full literal prefix, not a fragment of it.
  • Reading the diff back line by line: 95 removed, 95 added, 0 lines that differ by anything other than the prefix.
  • The old prefix now occurs 0 times. Every new target resolves.
  • php -l clean on all 24 PHP files touched; phpcs exit 0 on the lib/ ones.

No code changes. Every edit is inside a docblock or comment.

Why it matters

A citation that resolves to nothing looks exactly like a covered scenario to a reader and to any tool that only checks the tag is present. This is the same shape as dossiq #2057, which left 119 citations dangling after an archive.

…specs

`openspec/changes/case-flow-human-steps/` was archived on 2026-09-09 to
`openspec/changes/archive/2026-09-09-case-flow-human-steps/`. Every `@spec` and
`@e2e` citation that named the change's own spec files kept pointing at the old
path, which no longer exists: 95 citations across 32 files in lib/, src/ and
tests/, all resolving to nothing.

The change's three delta specs were synced into the canonical tree when it was
archived, so each citation now points there:

  openspec/changes/case-flow-human-steps/specs/<cap>/spec.md
    -> openspec/specs/<cap>/spec.md

for case-flow-human-steps (63), task-management (16) and
status-transition-engine (16). All three canonical files exist; the canonical
spec is preferred over the archive copy because it is the one kept current.

Mechanical, and verified as mechanical rather than assumed. The pattern is the
full literal prefix, not a fragment of it. Reading the diff back line by line:
95 lines removed, 95 added, and ZERO lines that differ by anything other than
that prefix. The old prefix now occurs 0 times. Every new target resolves.
php -l clean on all 24 PHP files touched, phpcs exit 0 on the lib/ ones. No
code changes; every edit is inside a docblock or comment.
@rubenvdlinde
rubenvdlinde merged commit c065ab5 into development Sep 11, 2026
34 checks passed
@rubenvdlinde
rubenvdlinde deleted the fix/case-flow-human-steps-citations branch September 11, 2026 03:00
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/dossiq @ 1982d85

Check PHP Vue Security License Tests
lint ✅
phpcs ✅
phpmd ✅
psalm ✅
phpstan ✅
phpmetrics ✅
eslint ✅
stylelint ✅
build ✅
check-manifest ✅
check-vue3-compile ✅
test-l10n ✅
format ✅
check-schema-l10n ✅
check-l10n-js ✅
composer ✅ ✅ 106/106
npm ✅ ✅ 548/548
app:check-code ⏭️
info.xml ✅
REUSE ❌
PHPUnit ✅
Newman ⏭️
Playwright ✅
Hydra gates ✅

Quality workflow — 2026-09-11 03:43 UTC

Download the full PDF report from the workflow artifacts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant