spec-ctx 0.2.0 → 0.3.0

package/README.md

@@ -229,7 +229,7 @@ ignore = []                             # globs that the scan skips
 [ids]
 caps = []                               # capability codes. Empty means any code is valid.
 task_pattern = '\d+\.\d+'               # the task number in a tasks.md checkbox
-brackets = false                        # true: adopt and id new write [REQ-UA-001]. The scan reads both forms.
+brackets = false                        # true: adopt, id new, and init --schema write [REQ-UA-001] in headers. The scan reads both forms.
 
 [ids.paths]
 UA = "user-auth"                        # capability path of each code. adopt writes the derived ones.
@@ -251,6 +251,8 @@ max_attempts = 3                        # Verify failures on one task before tas
 archive = "ask"                         # "ask" stops before archive for a human. "auto" lets the loop archive.
 ```
 
+With `brackets = true`, `init --schema` installs templates with `[REQ-<CAP>-NNN]` and `[SCN-<CAP>-NNN-N]` in the headers. The merged rules show the same form. Task citations, `Refs:` lines, and tags stay bare. After you change the value, run `specctx init --schema` again. It switches each template and rule that you did not edit. It keeps the ones you edited, unless you add `--force`.
+
 Two environment variables change the engine:
 
 | Variable | Effect |
@@ -284,18 +286,18 @@ The action runs `specctx gate`: `check --strict`, both markdown linters, `opensp
 
 ## Status
 
-- Published: `spec-ctx@0.2.0` on npm, with tags `v0.2.0` and `v0` and binaries on the GitHub release.
-- Archived: 001 to 025, and 027. No change is open. See `CHANGELOG.md` for each release.
+- Published: `spec-ctx@0.3.0` on npm, with tags `v0.3.0` and `v0` and binaries on the GitHub release.
+- Archived: 001 to 025 and 027 to 032. No change is open. See `CHANGELOG.md` for each release.
 - A version bump on `main` publishes the next release. See `docs/CONTRIBUTING.md`.
 - Upstream: the ID scheme is proposed as a comment on [OpenSpec#1967](https://github.com/Fission-AI/OpenSpec/issues/1967#issuecomment-6414314730). The schema bundle is submitted to the community table in [OpenSpec#2157](https://github.com/Fission-AI/OpenSpec/issues/2157). No pull request until a maintainer asks.
 
 ## Measured
 
-`specctx stats --write` measures this repository after each change. The newest file is `docs/metrics/2026-10-29.md`. Its total row:
+`specctx stats --write` measures this repository after each change. The newest file is `docs/metrics/2026-10-30.md`. Its total row:
 
 | change | context_ratio | evidence_ratio | stale_catches | cycle_time_median_s | debt |
 | --- | --- | --- | --- | --- | --- |
-| total | 0.0327 (n=76) | 0.90 (143/159) | 36 (of 81 reopens) | 98 (n=76) | 0 (0 baselined + 0 new) |
+| total | 0.0281 (n=93) | 0.91 (166/182) | 43 (of 90 reopens) | 76 (n=93) | 0 (0 baselined + 0 new) |
 
 - `context_ratio`: the size of one task bundle divided by the size of all spec text. Lower is better.
 - `evidence_ratio`: done tasks with a passed Verify command, divided by all done tasks. The rest have a manual note. Higher is better.

package/dist/assets.generated.js

@@ -10,5 +10,5 @@ export const ASSETS = {
     "skills/specctx-bootstrap/SKILL.md": "LS0tCm5hbWU6IHNwZWNjdHgtYm9vdHN0cmFwCmRlc2NyaXB0aW9uOiBTdGFydCBhIHNlc3Npb24gaW4gYW4gT3BlblNwZWMgcHJvamVjdCB0aGF0IHVzZXMgc3BlYy1jdHguIFVzZSBhdCB0aGUgc3RhcnQgb2YgZXZlcnkgc2Vzc2lvbiwgYW5kIG9uICJzdGFydCIsICJib290c3RyYXAiLCBvciAid2hhdCBzaG91bGQgSSB3b3JrIG9uIi4gTG9hZHMgb25seSB0aGUgc3BlYyB0ZXh0IHRoYXQgdGhlIG5leHQgdGFzayBuZWVkcy4KLS0tCgpUaGlzIHNraWxsIGlzIG5vdyBgc3BlY2N0eC1ydW5gLiBSdW4gaXQuCg==",
     "skills/specctx-done/SKILL.md": "LS0tCm5hbWU6IHNwZWNjdHgtZG9uZQpkZXNjcmlwdGlvbjogQ2xvc2UgYSB0YXNrIGluIGFuIE9wZW5TcGVjIHByb2plY3QgdGhhdCB1c2VzIHNwZWMtY3R4LiBSdW5zIHRoZSBWZXJpZnkgY29tbWFuZCwgd3JpdGVzIGV2aWRlbmNlLCBzZXRzIHRoZSBjaGVja2JveCwgd3JpdGVzIHRoZSBoYW5kb2ZmLCBhbmQgc2hvd3MgdGhlIG1ldHJpY3MuIFVzZSB3aGVuIHRoZSB3b3JrIG9mIGEgdGFzayBpcyBjb21wbGV0ZSwgb3Igb24gImRvbmUiLCAiY2xvc2UgdGhlIHRhc2siLCBhbmQgImVuZCB0aGUgc2Vzc2lvbiIuCi0tLQoKVGhpcyBza2lsbCBpcyBub3cgYHNwZWNjdHgtcnVuYC4gUnVuIGl0Lgo=",
     "skills/specctx-next/SKILL.md": "LS0tCm5hbWU6IHNwZWNjdHgtbmV4dApkZXNjcmlwdGlvbjogUGljayBhbmQgc3RhcnQgdGhlIG5leHQgdGFzayBpbiB0aGUgbWlkZGxlIG9mIGEgc2Vzc2lvbiBpbiBhbiBPcGVuU3BlYyBwcm9qZWN0IHRoYXQgdXNlcyBzcGVjLWN0eC4gVXNlIGFmdGVyIHlvdSBjbG9zZSBhIHRhc2ssIG9yIG9uICJuZXh0IHRhc2siIGFuZCAid2hhdCBpcyBuZXh0Ii4KLS0tCgpUaGlzIHNraWxsIGlzIG5vdyBgc3BlY2N0eC1ydW5gLiBSdW4gaXQuCg==",
-    "skills/specctx-run/SKILL.md": "LS0tCm5hbWU6IHNwZWNjdHgtcnVuCmRlc2NyaXB0aW9uOiBSdW4gdGhlIHNwZWMtY3R4IGxvb3AgaW4gYW4gT3BlblNwZWMgcHJvamVjdC4gVXNlIG9uICJydW4iLCAiY29udGludWUiLCAibmV4dCB0YXNrIiwgImJ1aWxkIHRoaXMiLCAiY2Fycnkgb24iLCBhbmQgb24gYSBmaXJzdCBtZXNzYWdlIHRoYXQgZGVzY3JpYmVzIGEgY2hhbmdlIHRvIGJ1aWxkLiBUaGUgZW5naW5lIHBpY2tzIHRoZSBuZXh0IGFjdGlvbi4gVGhlIHNraWxsIGFjdHMgb24gaXQgdW50aWwgdGhlIGNoYW5nZSByZWFjaGVzIHRoZSBhcmNoaXZlIG9yIGEgaHVtYW4gbXVzdCBkZWNpZGUuCi0tLQoKIyBzcGVjY3R4LXJ1bgoKUnVuIGBzcGVjY3R4YCBhcyBgbnB4IHNwZWMtY3R4YCB3aGVuIGl0IGlzIG5vdCBpbnN0YWxsZWQuIGBvcGVuc3BlY2AgaXMgdGhlIGNvbW1hbmQgaW4gYFtnYXRlXSBvcGVuc3BlY2Agb2YgYHNwZWMtY3R4LnRvbWxgLgoKIyMgVGhlIGxvb3AKCjEuIFJ1biBgc3BlY2N0eCBuZXh0IC0tanNvbmAuIFJlYWQgYGFjdGlvbmAsIGBjaGFuZ2VgIChgPGM+YCksIGB0YXNrYCAoYDx0PmApLCBgY29tbWFuZGAsIGByZWFzb25gLCBhbmQgYGh1bWFuYC4KMi4gQWN0IG9uIGBhY3Rpb25gIGFzIHRoZSB0YWJsZSBiZWxvdyBzYXlzLgozLiBSdW4gYHNwZWNjdHggaGFuZG9mZiB3cml0ZWAuCjQuIFJlcGVhdCBmcm9tIHN0ZXAgMSB1bnRpbCBgYWN0aW9uYCBpcyBgc3RvcGAgb3IgYGh1bWFuYCBpcyB0cnVlLgoKIyMgQWN0aW9ucwoKLSBgcGxhbmA6IGZvbGxvdyB0aGUgdXBzdHJlYW0gYG9wZW5zcGVjLXByb3Bvc2VgIHNraWxsIGZvciB0aGUgY2hhbmdlIGluIGBjb21tYW5kYC4gVGFrZSBldmVyeSBJRCBmcm9tIGBzcGVjY3R4IGlkIG5ldyBSRVEgPENBUD5gIGFuZCBgc3BlY2N0eCBpZCBuZXcgU0NOIDxDQVA+IC0tZm9yIDxSRVE+YC4gR2l2ZSBldmVyeSB0YXNrIGEgYFtSRVEtLi4uXWAgY2l0YXRpb24gYW5kIGEgYFZlcmlmeTpgIGNvZGUgc3Bhbi4gVGhlbiBydW4gYHNwZWNjdHggY2hlY2sgLS1zdHJpY3RgIGFuZCBgb3BlbnNwZWMgdmFsaWRhdGUgPGM+IC0tc3RyaWN0YC4gRml4IGV2ZXJ5IGZpbmRpbmcuIFN0b3AgYW5kIHNob3cgdGhlIHBsYW4gdG8gdGhlIHVzZXIuIFRoaXMgaXMgdGhlIHBsYW4gc3RvcC4KLSBgY2l0ZWA6IHJ1biBgc3BlY2N0eCBxdWVyeSAtLWNoYW5nZSA8Yz4gLS1raW5kIHJlcWAuIEFkZCB0aGUgYFtSRVEtLi4uXWAgY2l0YXRpb24gYW5kIGEgYFZlcmlmeTpgIGNvZGUgc3BhbiB0byB0aGUgdGFzayBsaW5lIG5hbWVkIGluIGB0YXNrYC4gUnVuIGBzcGVjY3R4IGNoZWNrYC4gQ29udGludWUuCi0gYHN0YXJ0YDogcnVuIGBzcGVjY3R4IHRhc2sgc3RhcnQgPHQ+YC4gUmVhZCB0aGUgYnVuZGxlIGl0IHByaW50cy4gQ29udGludWUuCi0gYHdvcmtgOiBpbXBsZW1lbnQgdGhlIHRhc2suIFRhZyBjb2RlIHdpdGggYC8vIFJFUS0uLi5gLiBUYWcgdGVzdHMgd2l0aCBgLy8gQ292ZXJzOiBSRVEtLi4uYC4gVGhlbiBydW4gYHNwZWNjdHggdGFzayBkb25lIDx0PmAuCi0gYGZpeGA6IHJlYWQgYHJlYXNvbmAuIEl0IGhvbGRzIHRoZSB0YWlsIG9mIHRoZSBmYWlsZWQgVmVyaWZ5IG91dHB1dC4gRml4IHRoZSBjYXVzZS4gUnVuIGBzcGVjY3R4IHRhc2sgZG9uZSA8dD5gIGFnYWluLgotIGByZXBhaXJgOiBydW4gYHNwZWNjdHggdGFzayBkb25lIDx0PmAuIEl0IHJ1bnMgVmVyaWZ5IGZvciBhIHRpY2tlZCB0YXNrIHRoYXQgaGFzIG5vIGV2aWRlbmNlLgotIGBnYXRlYDogcnVuIGBzcGVjY3R4IGdhdGUgLS1zdHJpY3RgLiBGaXggZXZlcnkgZmluZGluZy4gUnVuIGl0IGFnYWluIHVudGlsIGl0IGV4aXRzIDAuCi0gYGFyY2hpdmVgOiB3aGVuIGBodW1hbmAgaXMgdHJ1ZSwgc3RvcCBhbmQgYXNrIHRoZSB1c2VyIGluIG9uZSBsaW5lIHdoZXRoZXIgdG8gYXJjaGl2ZSBgPGM+YC4gV2hlbiBgaHVtYW5gIGlzIGZhbHNlLCBmb2xsb3cgdGhlIHVwc3RyZWFtIGBvcGVuc3BlYy1hcmNoaXZlLWNoYW5nZWAgc2tpbGwuIFRoZW4gcnVuIGBvcGVuc3BlYyB2YWxpZGF0ZSAtLWFsbCAtLXN0cmljdGAsIGBzcGVjY3R4IGNoZWNrIC0tc3RyaWN0YCwgYW5kIGBzcGVjY3R4IGhhbmRvZmYgd3JpdGVgLgotIGBhc2tgOiBwcmludCBgcmVhc29uYC4gSXQgaXMgdGhlIG9wZW4gcXVlc3Rpb24uIFN0b3AuIFRoZSB1c2VyIGFuc3dlcnMgd2l0aCBgc3BlY2N0eCBoYW5kb2ZmIHJlc29sdmUgPG4+ICI8YW5zd2VyPiJgLgotIGBzdG9wYDogcHJpbnQgYHJlYXNvbmAuIFN0b3AuCgojIyBSdWxlcwoKLSBOZXZlciB0aWNrIGEgY2hlY2tib3ggYnkgaGFuZC4gYHNwZWNjdHggdGFzayBkb25lYCBpcyB0aGUgb25seSB3YXkgYSB0YXNrIGNsb3Nlcy4KLSBOZXZlciB1c2UgYC0tbWFudWFsYCBvbiBhIHRhc2sgd2l0aCBhIFZlcmlmeSBjb21tYW5kLgotIE5ldmVyIGNhbGwgYC9vcHN4OmFwcGx5YC4gVGhpcyBza2lsbCByZXBsYWNlcyBpdC4KLSBOZXZlciByZWFkIGBvcGVuc3BlYy9zcGVjcy9gIG9yIGBvcGVuc3BlYy9jaGFuZ2VzLyovc3BlY3MvYCBkaXJlY3RseS4gVXNlIHRoZSBidW5kbGUgZnJvbSBgdGFzayBzdGFydGAgb3IgYHNwZWNjdHggYnVuZGxlIDxpZD5gLgotIFN0b3Agb24gYW55IGBhY3Rpb25gIG5vdCBpbiB0aGUgbGlzdCBhYm92ZS4gUHJpbnQgdGhlIG9iamVjdCBhbmQgYXNrIHRoZSB1c2VyLgotIEtlZXAgbm8gc3RhdGUgaW4geW91ciBjb250ZXh0LiBBIG5ldyBzZXNzaW9uIHN0YXJ0cyB0aGUgc2FtZSBsb29wIGFnYWluIHdpdGggc3RlcCAxLgo=",
+    "skills/specctx-run/SKILL.md": "LS0tCm5hbWU6IHNwZWNjdHgtcnVuCmRlc2NyaXB0aW9uOiBSdW4gdGhlIHNwZWMtY3R4IGxvb3AgaW4gYW4gT3BlblNwZWMgcHJvamVjdC4gVXNlIG9uICJydW4iLCAiY29udGludWUiLCAibmV4dCB0YXNrIiwgImJ1aWxkIHRoaXMiLCAiY2Fycnkgb24iLCBhbmQgb24gYSBmaXJzdCBtZXNzYWdlIHRoYXQgZGVzY3JpYmVzIGEgY2hhbmdlIHRvIGJ1aWxkLiBUaGUgZW5naW5lIHBpY2tzIHRoZSBuZXh0IGFjdGlvbi4gVGhlIHNraWxsIGFjdHMgb24gaXQgdW50aWwgdGhlIGNoYW5nZSByZWFjaGVzIHRoZSBhcmNoaXZlIG9yIGEgaHVtYW4gbXVzdCBkZWNpZGUuCi0tLQoKIyBzcGVjY3R4LXJ1bgoKUnVuIGBzcGVjY3R4YCBhcyBgbnB4IHNwZWMtY3R4YCB3aGVuIGl0IGlzIG5vdCBpbnN0YWxsZWQuIGBvcGVuc3BlY2AgaXMgdGhlIGNvbW1hbmQgaW4gYFtnYXRlXSBvcGVuc3BlY2Agb2YgYHNwZWMtY3R4LnRvbWxgLiBXaGVuIHRoYXQga2V5IGlzIGFic2VudCwgYG9wZW5zcGVjYCBpcyBgbnB4IC15IEBmaXNzaW9uLWFpL29wZW5zcGVjQGxhdGVzdGAuCgojIyBUaGUgbG9vcAoKMS4gUnVuIGBzcGVjY3R4IG5leHQgLS1qc29uYC4gUmVhZCBgYWN0aW9uYCwgYGNoYW5nZWAgKGA8Yz5gKSwgYHRhc2tgIChgPHQ+YCksIGBjb21tYW5kYCwgYHJlYXNvbmAsIGFuZCBgaHVtYW5gLgoyLiBBY3Qgb24gYGFjdGlvbmAgYXMgdGhlIHRhYmxlIGJlbG93IHNheXMuCjMuIFJ1biBgc3BlY2N0eCBoYW5kb2ZmIHdyaXRlYC4KNC4gUmVwZWF0IGZyb20gc3RlcCAxIHVudGlsIGBhY3Rpb25gIGlzIGBzdG9wYCBvciBgaHVtYW5gIGlzIHRydWUuCgojIyBBY3Rpb25zCgotIGBwbGFuYDogdGFrZSB0aGUgY2hhbmdlIG5hbWUgZnJvbSB0aGUgcmVxdWVzdCBvZiB0aGUgdXNlciBpbiBrZWJhYiBjYXNlLiBUaGF0IG5hbWUgaXMgYDxjPmAuIEZvbGxvdyB0aGUgdXBzdHJlYW0gYG9wZW5zcGVjLXByb3Bvc2VgIHNraWxsIGZvciBgPGM+YC4gUmVhZCBleGlzdGluZyByZXF1aXJlbWVudHMgd2l0aCBgc3BlY2N0eCBidW5kbGUgPGlkPmAgb3IgYHNwZWNjdHggcXVlcnlgLCBuZXZlciBgb3BlbnNwZWMgc2hvd2AuIFRha2UgZXZlcnkgSUQgZnJvbSBgc3BlY2N0eCBpZCBuZXcgUkVRIDxDQVA+YCBhbmQgYHNwZWNjdHggaWQgbmV3IFNDTiA8Q0FQPiAtLWZvciA8UkVRPmAuIFdoZW4gdGhlIGNoYW5nZSBuZWVkcyBzZXZlcmFsIElEcyBvZiBvbmUga2luZCwgcnVuIGBzcGVjY3R4IGlkIG5ldyAtLWNvdW50IDxuPmAgb25jZS4gR2l2ZSBldmVyeSB0YXNrIGEgYFtSRVEtLi4uXWAgY2l0YXRpb24gYW5kIGEgYFZlcmlmeTpgIGNvZGUgc3Bhbi4gVGhlbiBydW4gYHNwZWNjdHggY2hlY2sgLS1zdHJpY3RgIGFuZCBgc3BlY2N0eCBnYXRlIC0tc3RyaWN0YC4gVGhlIGdhdGUgcnVucyB0aGUgT3BlblNwZWMgdmFsaWRhdGUgYW5kIHRoZSBzcGVjLWxlbmd0aCBjaGVjay4gRml4IGV2ZXJ5IGZpbmRpbmcuIFRoZW4gcnVuIGBzcGVjY3R4IGhhbmRvZmYgYXNrIC0tY2hhbmdlIDxjPiAicGxhbiByZWFkeSBmb3IgPGM+LiBBcHByb3ZlIHRvIHN0YXJ0IHRoZSB0YXNrcz8iYC4gVGhpcyBpcyB0aGUgcGxhbiBzdG9wLiBgbmV4dGAgcmV0dXJucyBgYXNrYCB1bnRpbCB0aGUgdXNlciByZXNvbHZlcyB0aGUgcXVlc3Rpb24uCi0gYGNpdGVgOiBydW4gYHNwZWNjdHggcXVlcnkgLS1jaGFuZ2UgPGM+IC0ta2luZCByZXFgLiBBZGQgdGhlIGBbUkVRLS4uLl1gIGNpdGF0aW9uIGFuZCBhIGBWZXJpZnk6YCBjb2RlIHNwYW4gdG8gdGhlIHRhc2sgbGluZSBuYW1lZCBpbiBgdGFza2AuIFJ1biBgc3BlY2N0eCBjaGVja2AuIENvbnRpbnVlLgotIGBzdGFydGA6IHJ1biBgc3BlY2N0eCB0YXNrIHN0YXJ0IDx0PmAuIFJlYWQgdGhlIGJ1bmRsZSBpdCBwcmludHMuIENvbnRpbnVlLgotIGB3b3JrYDogaW1wbGVtZW50IHRoZSB0YXNrLiBUYWcgY29kZSB3aXRoIGAvLyBSRVEtLi4uYC4gVGFnIHRlc3RzIHdpdGggYC8vIENvdmVyczogUkVRLS4uLmAuIFRoZW4gcnVuIGBzcGVjY3R4IHRhc2sgZG9uZSA8dD5gLgotIGBmaXhgOiByZWFkIGByZWFzb25gLiBJdCBob2xkcyB0aGUgdGFpbCBvZiB0aGUgZmFpbGVkIFZlcmlmeSBvdXRwdXQuIEZpeCB0aGUgY2F1c2UuIFJ1biBgc3BlY2N0eCB0YXNrIGRvbmUgPHQ+YCBhZ2Fpbi4KLSBgcmVwYWlyYDogcnVuIHRoZSBjb21tYW5kIGluIHRoZSBgY29tbWFuZGAgZmllbGQuIEl0IHJ1bnMgVmVyaWZ5IGFnYWluIGZvciBhIHRpY2tlZCB0YXNrIHdob3NlIGV2aWRlbmNlIGlzIGFic2VudCBvciBzdGFsZS4KLSBgZ2F0ZWA6IHJ1biBgc3BlY2N0eCBnYXRlIC0tc3RyaWN0YC4gRml4IGV2ZXJ5IGZpbmRpbmcuIFJ1biBpdCBhZ2FpbiB1bnRpbCBpdCBleGl0cyAwLgotIGBhcmNoaXZlYDogd2hlbiBgaHVtYW5gIGlzIHRydWUsIHJ1biBgc3BlY2N0eCBoYW5kb2ZmIGFzayAtLWNoYW5nZSA8Yz4gImFyY2hpdmUgPGM+PyJgIGFuZCBzdG9wLiBUaGlzIGlzIHRoZSBhcmNoaXZlIHN0b3AuIGBuZXh0YCByZXR1cm5zIGBhc2tgIHVudGlsIHRoZSB1c2VyIHJlc29sdmVzIHRoZSBxdWVzdGlvbi4gV2hlbiBgaHVtYW5gIGlzIGZhbHNlLCB0aGUgdXNlciBhcHByb3ZlZCBvciBgW2xvb3BdIGFyY2hpdmVgIGlzIGBhdXRvYC4gVGhlbiBydW4gZWFjaCBzdGVwIHVuZGVyIGBvcGVyYXRpb25zLmFyY2hpdmUuZ3VpZGFuY2VgIGluIGBvcGVuc3BlYy9jb25maWcueWFtbGAuIFRoZW4gcnVuIHRoZSBjb21tYW5kIGluIHRoZSBgY29tbWFuZGAgZmllbGQuIFRoZW4gcnVuIGBvcGVuc3BlYyB2YWxpZGF0ZSAtLWFsbCAtLXN0cmljdGAsIGBzcGVjY3R4IGNoZWNrIC0tc3RyaWN0YCwgYW5kIGBzcGVjY3R4IGhhbmRvZmYgd3JpdGVgLgotIGBhc2tgOiBwcmludCBgcmVhc29uYC4gSXQgaXMgdGhlIG9wZW4gcXVlc3Rpb24uIFN0b3AuIFRoZSB1c2VyIGFuc3dlcnMgd2l0aCBgc3BlY2N0eCBoYW5kb2ZmIHJlc29sdmUgPG4+ICI8YW5zd2VyPiJgLgotIGBzdG9wYDogcHJpbnQgYHJlYXNvbmAuIFN0b3AuCgojIyBSdWxlcwoKLSBOZXZlciB0aWNrIGEgY2hlY2tib3ggYnkgaGFuZC4gYHNwZWNjdHggdGFzayBkb25lYCBpcyB0aGUgb25seSB3YXkgYSB0YXNrIGNsb3Nlcy4KLSBOZXZlciB1c2UgYC0tbWFudWFsYCBvbiBhIHRhc2sgd2l0aCBhIFZlcmlmeSBjb21tYW5kLgotIE5ldmVyIGNhbGwgYC9vcHN4OmFwcGx5YC4gVGhpcyBza2lsbCByZXBsYWNlcyBpdC4KLSBOZXZlciByZWFkIGBvcGVuc3BlYy9zcGVjcy9gIG9yIGBvcGVuc3BlYy9jaGFuZ2VzLyovc3BlY3MvYCBkaXJlY3RseS4gVXNlIHRoZSBidW5kbGUgZnJvbSBgdGFzayBzdGFydGAgb3IgYHNwZWNjdHggYnVuZGxlIDxpZD5gLgotIFN0b3Agb24gYW55IGBhY3Rpb25gIG5vdCBpbiB0aGUgbGlzdCBhYm92ZS4gUHJpbnQgdGhlIG9iamVjdCBhbmQgYXNrIHRoZSB1c2VyLgotIEtlZXAgbm8gc3RhdGUgaW4geW91ciBjb250ZXh0LiBBIG5ldyBzZXNzaW9uIHN0YXJ0cyB0aGUgc2FtZSBsb29wIGFnYWluIHdpdGggc3RlcCAxLgo=",
 };

package/dist/baseline/baseline.js

@@ -4,11 +4,14 @@ import { join } from "node:path";
 import { lintLine, parseLintLine } from "../lint/counts.js";
 import { cmpStr } from "../util/pystr.js";
 export const BASELINE_PATH = ".ctx/baseline.json";
-export const BASELINE_RULES = ["uncovered", "scenario-untested", "done-without-evidence", "manual-evidence", "task-without-req", "task-without-verify", "missing-id"];
+export const BASELINE_RULES = ["uncovered", "scenario-untested", "done-without-evidence", "manual-evidence", "task-without-req", "task-without-verify", "weak-verify", "missing-id"];
 /** REQ-ADOPT-005 a missing-id finding has no ID. Its key carries the file and the header title. */
 const key = (f) => (f.rule === "missing-id" ? `${f.rule} ${f.file} ${f.id}` : `${f.rule} ${f.id}`);
-/** A warning line reads "manual-evidence <task>". */
-const warningKey = (w) => w;
+/**
+ * A warning line reads "manual-evidence <task>" or "weak-verify <task> <file>:<line>".
+ * REQ-ADOPT-005 the key keeps the rule and the task, so a weak-verify warning matches its strict finding (028/D10).
+ */
+const warningKey = (w) => w.split(" ").slice(0, 2).join(" ");
 export function readBaseline(root) {
     const p = join(root, BASELINE_PATH);
     if (!existsSync(p))

package/dist/check/check.js

@@ -6,6 +6,7 @@ import { changeKey } from "../index/scan.js";
 import { listEvidence } from "../tasks/evidence.js";
 import { cmpTuple } from "../util/pystr.js";
 import { evidenceFindings } from "./evidence.js";
+import { isWeakVerify, parseVerify } from "../verify/parse.js";
 // the first ID of a retired row can be a scenario. Only a REQ or ADR can be reused, but the SCN still counts as the row ID.
 const RETIRED_RE = /\b(REQ-[A-Z]{2,6}-\d{3}|SCN-[A-Z]{2,6}-\d{3}-\d+|ADR-\d{3})\b/g;
 const REQ_CAP = /^REQ-([A-Z]{2,6})-/;
@@ -69,6 +70,11 @@ function renamedTargets(root, file) {
     }
     return out;
 }
+/** REQ-CHK-006 the header line of an entry as its file writes it, without the line end. */
+function headerLine(root, e) {
+    const line = readFileSync(join(root, e.file), "utf8").split(/\r?\n/)[e.line - 1];
+    return (line ?? `### Requirement: ${e.id} ${e.title}`).trimEnd();
+}
 /**
  * REQ-CHK-001 retitle-needs-renamed: a MODIFIED or REMOVED header of an active change whose ID exists in main
  * with another title, and whose delta file has no RENAMED TO line with that header. Upstream OpenSpec matches
@@ -91,10 +97,31 @@ export function retitleFindings(root, entries) {
             targets.set(e.file, renamedTargets(root, e.file));
         if (targets.get(e.file).some(([id, title]) => title === e.title && (id === null || id === e.id)))
             continue;
-        out.push({ file: e.file, line: e.line, rule: "retitle-needs-renamed", id: e.id, detail: `"${m.title}" -> "${e.title}"` });
+        // REQ-CHK-006 the hint copies both header lines as the files write them, bare or in brackets (031/D7)
+        const hint = `Add to the delta before the MODIFIED block:\n## RENAMED Requirements\n- FROM: \`${headerLine(root, m)}\`\n- TO: \`${headerLine(root, e)}\``;
+        out.push({ file: e.file, line: e.line, rule: "retitle-needs-renamed", id: e.id, detail: `"${m.title}" -> "${e.title}"`, hint });
+    }
+    return out;
+}
+/**
+ * REQ-CHK-005 weak-verify: a task of an active change whose Verify command always exits 0 (028/D2).
+ * A task with no Verify command has task-without-verify already, so it gets no second finding.
+ */
+export function weakVerifyFindings(entries) {
+    const out = [];
+    for (const e of entries) {
+        if (e.kind !== "task" || e.change === "main" || e.file.includes("/archive/"))
+            continue;
+        const v = parseVerify(e.title);
+        if (v.command !== null && isWeakVerify(v.command))
+            out.push({ file: e.file, line: e.line, rule: "weak-verify", id: e.id });
     }
     return out;
 }
+/** REQ-CHK-005 the plain-mode form of weak-verify: one warning "weak-verify <task> <file>:<line>" per task (028/D3). */
+export function weakVerifyWarnings(entries) {
+    return weakVerifyFindings(entries).map((f) => `weak-verify ${f.id} ${f.file}:${f.line}`);
+}
 /** Sorted, unique findings. The scan never reads .ctx/, so evidence adds no index entry. */
 export function check(root, cfg, data, strict) {
     const entries = data.entries;
@@ -169,6 +196,7 @@ export function check(root, cfg, data, strict) {
     for (const f of findings)
         uniq.set(JSON.stringify(f), f);
     const plain = [...uniq.values()].map(([file, line, rule, id]) => ({ file, line, rule, id }));
-    const all = [...plain, ...retitleFindings(root, entries)];
+    // REQ-CHK-005 weak-verify is hard only in strict mode. Plain mode prints it as a warning (028/D3).
+    const all = [...plain, ...retitleFindings(root, entries), ...(strict ? weakVerifyFindings(entries) : [])];
     return all.sort((a, b) => cmpTuple([a.file, a.line, a.rule, a.id], [b.file, b.line, b.rule, b.id]));
 }

package/dist/check/evidence.js

@@ -1,7 +1,30 @@
 // REQ-CHK-003 evidence rules of check --strict.
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { fileSha256 } from "../util/hash.js";
+import { evidenceRel } from "../tasks/tasks.js";
+/**
+ * REQ-CHK-003 REQ-LOOP-008 the stale paths of one evidence file, sorted. A damaged file is stale as a whole and
+ * returns its own path. check and next both read this, so the two never differ (031/D5).
+ */
+export function staleFiles(root, rel) {
+    let files = {};
+    try {
+        const ev = JSON.parse(readFileSync(join(root, rel), "utf8"));
+        files = ev.files ?? {};
+    }
+    catch {
+        return [rel];
+    }
+    return Object.keys(files).filter((p) => fileSha256(join(root, p)) !== files[p]).sort();
+}
+/** REQ-LOOP-008 the first stale path of the evidence of a task, or null when it is fresh or absent (031/D5). */
+export function staleOf(root, task) {
+    const rel = evidenceRel({ id: task });
+    if (!existsSync(join(root, rel)))
+        return null;
+    return staleFiles(root, rel)[0] ?? null;
+}
 export function evidenceFindings(root, entries, evidence) {
     const out = [];
     const tasks = new Map();
@@ -27,19 +50,8 @@ export function evidenceFindings(root, entries, evidence) {
         // archived changes are exempt from stale-evidence
         if (!active)
             continue;
-        let files = {};
-        try {
-            const ev = JSON.parse(readFileSync(join(root, rel), "utf8"));
-            files = ev.files ?? {};
-        }
-        catch {
-            out.push([rel, 1, "stale-evidence", `${id} ${rel}`]);
-            continue;
-        }
-        for (const [path, digest] of Object.entries(files)) {
-            if (fileSha256(join(root, path)) !== digest)
-                out.push([rel, 1, "stale-evidence", `${id} ${path}`]);
-        }
+        for (const path of staleFiles(root, rel))
+            out.push([rel, 1, "stale-evidence", `${id} ${path}`]);
     }
     for (const e of entries) {
         if (e.kind === "task" && e.status === "done" && !e.file.includes("/archive/") && !have.has(e.id)) {

package/dist/check/hints.js

@@ -17,8 +17,11 @@ export const RULES = {
     uncovered: { level: "hard", hint: "Add a test with a Covers tag for the requirement." },
     "scenario-untested": { level: "hard", hint: "Name the scenario ID in a test." },
     "done-without-evidence": { level: "hard", hint: "Run specctx task done. It runs the Verify command and writes the evidence." },
-    "stale-evidence": { level: "hard", hint: "Run specctx task reopen and then specctx task done." },
+    // REQ-CHK-006 the hint names the why argument of task reopen (031/D8)
+    "stale-evidence": { level: "hard", hint: "Run specctx task reopen <task> <why>, then specctx task done <task>." },
     "evidence-without-done": { level: "hard", hint: "Run specctx task done, or remove the evidence file." },
+    // REQ-CHK-005 advisory in plain check. check --strict reports it as a hard finding (028/D5).
+    "weak-verify": { level: "advisory", hint: "Name a test file or a command whose exit code proves the task." },
     "manual-evidence": { level: "advisory", hint: "Give the task a Verify command and run specctx task done again." },
     // REQ-CHK-001 the hint is the block to paste. The finding line carries the ID and both titles (021/D3).
     // REQ-ADOPT-010 FROM copies the main header and TO copies the delta header, each in its own form (027/D4).

package/dist/cli/args.js

@@ -19,7 +19,7 @@ export const COMMAND_FLAGS = {
     "task done": { manual: "string" },
     "task reopen": {},
     "handoff write": {},
-    "handoff ask": {},
+    "handoff ask": { change: "string" },
     "handoff resolve": {},
     adopt: { "dry-run": "bool" },
     "baseline write": {},

package/dist/cli/commands.js

@@ -10,7 +10,12 @@ async function runCheck(root, cfg, data, strict) {
     const { applyBaseline } = await import("../baseline/baseline.js");
     const findings = check(root, cfg, data, strict);
     let warnings = [];
-    if (strict) {
+    if (!strict) {
+        // REQ-CHK-005 plain check prints weak-verify as an advisory warning (028/D3)
+        const { weakVerifyWarnings } = await import("../check/check.js");
+        warnings = weakVerifyWarnings(data.entries);
+    }
+    else {
         const { manualWarnings } = await import("../check/evidence.js");
         const { listEvidence } = await import("../tasks/evidence.js");
         warnings = manualWarnings(root, data.entries, listEvidence(root));
@@ -35,16 +40,29 @@ export function checkText(r, tty) {
     for (const x of r.findings)
         count.set(x.rule, (count.get(x.rule) ?? 0) + 1);
     for (const w of r.warnings) {
-        const [rule, task] = w.split(" ");
+        const [rule, task, at] = w.split(" ");
         count.set(rule, (count.get(rule) ?? 0) + 1);
+        // REQ-CHK-005 a weak-verify warning ends with <file>:<line> of the task line (028/D4)
+        if (rule === "weak-verify" && at)
+            files.add(at.replace(/:\d+$/, ""));
         // a manual-evidence warning names a task. Its file is the evidence file of the task.
-        if (task?.includes("/"))
+        else if (task?.includes("/"))
             files.add(`.ctx/evidence/${task}.json`);
     }
+    // REQ-CHK-006 the distinct hints that findings carry, in finding order. A rule with none prints the table hint (031/D6).
+    const own = new Map();
+    for (const x of r.findings) {
+        if (x.hint === undefined)
+            continue;
+        const l = own.get(x.rule) ?? [];
+        if (!l.includes(x.hint))
+            l.push(x.hint);
+        own.set(x.rule, l);
+    }
     const rules = [...count.keys()].sort();
     return body
         + "\n" + paint("dim", `${n} finding${n === 1 ? "" : "s"} in ${files.size} file${files.size === 1 ? "" : "s"} (${r.findings.length} hard, ${r.warnings.length} advisory)\n`, tty)
-        + rules.map((rule) => `${rule}  ${count.get(rule)}  ${hintOf(rule)}\n`).join("")
+        + rules.map((rule) => `${rule}  ${count.get(rule)}  ${own.get(rule)?.join("\n") ?? hintOf(rule)}\n`).join("")
         + base;
 }
 export async function run(p, io) {
@@ -182,9 +200,13 @@ export async function run(p, io) {
             const r = statusReport(root, entries);
             if (json)
                 print(r);
-            // REQ-CLI-008 the next: line is dim
-            else
-                io.out(statusLines(r).map((l) => (l.startsWith("next: ") ? paint("dim", l, io.tty) : l) + "\n").join(""));
+            else {
+                // REQ-CLI-007 the next: line is the command of the decision of specctx next, so the two never disagree (030/D1)
+                const { decideNext } = await import("../loop/next.js");
+                const d = decideNext(root, cfg, data);
+                // REQ-CLI-008 the next: line is dim
+                io.out(statusLines(r, d.command).map((l) => (l.startsWith("next: ") ? paint("dim", l, io.tty) : l) + "\n").join(""));
+            }
             return 0;
         }
         case "next": {
@@ -269,8 +291,10 @@ export async function run(p, io) {
         }
         case "check": {
             const r = await runCheck(root, cfg, data, !!f.strict);
+            // REQ-CHK-004 REQ-CHK-006 the JSON keeps its shape. A finding hint is for the human form only (031/D6).
+            const findings = r.findings.map(({ hint: _hint, ...rest }) => rest);
             if (json)
-                print({ baselined: r.baselined, count: r.findings.length, findings: r.findings, warnings: r.warnings });
+                print({ baselined: r.baselined, count: findings.length, findings, warnings: r.warnings });
             else
                 io.out(checkText(r, io.tty));
             return r.findings.length ? 1 : 0;

package/dist/cli/help.js

@@ -114,7 +114,8 @@ export const TABLE = [
     { name: "handoff write", group: "Write", args: "", summary: "Write .ctx/handoff.md from the index and the evidence.", flags: [], exit: PLAIN, example: "specctx handoff write" },
     {
         name: "handoff ask", group: "Write", args: "<question>", summary: "Add an open question to the handoff.",
-        flags: [], exit: PLAIN, example: "specctx handoff ask \"Keep the old flag?\"",
+        flags: [["--change <name>", "Give the question to this change, not to the current task. The key or the full folder name works."]],
+        exit: PLAIN, example: "specctx handoff ask --change 008 \"plan ready for 008-tasks. Approve to start the tasks?\"",
     },
     {
         name: "handoff resolve", group: "Write", args: "<n> <answer>", summary: "Move open question n to the resolved list.",

package/dist/cli/status.js

@@ -64,7 +64,11 @@ export function statusReport(root, entries) {
         open_questions: openQuestions(root),
     };
 }
-export function statusLines(r) {
+/**
+ * REQ-CLI-007 the status lines. The last line is always `next: ` and the command of the decision
+ * of `specctx next`, or `none` when the decision has no command (030/D1, 030/D2).
+ */
+export function statusLines(r, next) {
     const out = r.changes.map((c) => `${c.change}  done ${c.done}  open ${c.open}`);
     if (!r.changes.length) {
         out.push("no active change");
@@ -82,19 +86,6 @@ export function statusLines(r) {
             for (const q of r.open_questions)
                 out.push(`- ${q}`);
     }
-    const next = nextStep(r);
-    if (next)
-        out.push(`next: ${next}`);
+    out.push(`next: ${next ?? "none"}`);
     return out;
 }
-/** REQ-CLI-007 the next step by state: an open task, then a change with every task done, then uncovered REQs. */
-export function nextStep(r) {
-    if (r.changes.some((c) => c.open > 0))
-        return "specctx task next";
-    const ready = r.changes.find((c) => c.done > 0 && c.open === 0);
-    if (ready)
-        return `archive ${ready.change}`;
-    if (r.uncovered > 0)
-        return "specctx check";
-    return null;
-}

package/dist/cli/workflow.js

@@ -240,7 +240,7 @@ export async function runWorkflow(c) {
         }
         case "handoff ask": {
             const { ask } = await import("../handoff/handoff.js");
-            const h = ask(c.root, entries, c.p.positional.join(" "));
+            const h = ask(c.root, entries, c.p.positional.join(" "), c.p.flags.change);
             if (c.json)
                 print(c, { open_questions: h.open_questions });
             else

package/dist/handoff/handoff.js

@@ -2,7 +2,8 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { UsageExit } from "../cli/errors.js";
-import { changeKey } from "../index/scan.js";
+import { changeKey, matchesChange } from "../index/scan.js";
+import { activeFolders } from "../loop/next.js";
 import { listEvidence } from "../tasks/evidence.js";
 import { activeChanges, nextTask } from "../tasks/tasks.js";
 import { cmpStr, splitLines } from "../util/pystr.js";
@@ -144,13 +145,30 @@ function refresh(root, entries) {
     save(root, h);
     return h;
 }
-/** REQ-HND-002 append an open question to questions.json and render the handoff again (022/D6). */
-export function ask(root, entries, text) {
-    const q = addQuestion(root, currentTask(root), text);
+/**
+ * REQ-HND-002 append an open question to questions.json and render the handoff again (022/D6).
+ * REQ-LOOP-005 with a change, the question carries the active change folder, so next blocks the change (029/D1).
+ */
+export function ask(root, entries, text, change) {
+    let task = currentTask(root);
+    let stage;
+    if (change !== undefined) {
+        const folder = activeFolders(root).find((f) => matchesChange(f, change));
+        if (folder === undefined)
+            throw new UsageExit(`no active change ${change}`);
+        task = folder;
+        stage = stageOf(entries, folder);
+    }
+    const q = addQuestion(root, task, text, stage);
     const h = refresh(root, entries);
     h.asked = q.n;
     return h;
 }
+/** REQ-LOOP-007 archive when the change has a task and every task is [x], plan otherwise. The text plays no part (031/D1). */
+export function stageOf(entries, folder) {
+    const tasks = entries.filter((e) => e.kind === "task" && e.change === folder && !e.file.includes("/archive/"));
+    return tasks.length > 0 && tasks.every((t) => t.status === "done") ? "archive" : "plan";
+}
 /** REQ-HND-002 resolve question n in questions.json and render the handoff again (022/D6). */
 export function resolve(root, entries, n, answer) {
     resolveQuestion(root, n, answer);

package/dist/handoff/questions.js

@@ -33,13 +33,15 @@ export function oneLine(text) {
     return text.replace(/\s*\n\s*/g, " ").trim();
 }
 /** REQ-HND-002 append an open question with the next n. Returns the new question. */
-export function addQuestion(root, task, text) {
+export function addQuestion(root, task, text, stage) {
     const q = oneLine(text);
     if (!q)
         throw new UsageExit("handoff ask needs a question");
     const qs = readQuestions(root);
     const n = qs.reduce((m, x) => Math.max(m, x.n), 0) + 1;
     const item = { n, asked_at: isoNow(), task, text: q, status: "open" };
+    if (stage !== undefined)
+        item.stage = stage;
     qs.push(item);
     writeQuestions(root, qs);
     return item;

package/dist/init/init.js

@@ -4,7 +4,7 @@ import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "no
 import { dirname, join } from "node:path";
 import { ASSETS } from "../assets.generated.js";
 import { UsageExit } from "../cli/errors.js";
-import { CONFIG_FILE, DEFAULT_OPENSPEC, INIT_TEXT } from "../config.js";
+import { CONFIG_FILE, DEFAULT_OPENSPEC, INIT_TEXT, loadConfig } from "../config.js";
 export const SCHEMA = "spec-driven-ids";
 /** REQ-SCH-003 where the templates land in a project. Upstream reads no project override for the stock templates, so this is a reference path (025/D4). */
 export const TEMPLATES_DIR = `openspec/templates/${SCHEMA}`;
@@ -51,13 +51,34 @@ export function configText(root, openspec = DEFAULT_OPENSPEC) {
         text = text.replace(`\nopenspec = "${DEFAULT_OPENSPEC}"\n`, `\nopenspec = ${JSON.stringify(openspec)}\n`);
     return text;
 }
+/**
+ * REQ-SCH-006 wrap the ID after a requirement or scenario header prefix in square brackets (032/D1).
+ * An ID in brackets already stays. Task citations, Refs lines, and tags have no header prefix, so they stay bare.
+ */
+export function bracketForm(text) {
+    return text.replace(/(### Requirement: |#### Scenario: )((?:REQ|SCN)-[^\s\]"'`]+)/g, "$1[$2]");
+}
+/** REQ-SCH-006 the bytes of one template in the form that `brackets` names (032/D1). */
+export function templateBytes(rel, brackets) {
+    const b = asset(rel);
+    return brackets ? Buffer.from(bracketForm(b.toString("utf8"))) : b;
+}
+/** REQ-SCH-006 the config fragment in the form that `brackets` names (032/D1). */
+export function fragmentText(brackets) {
+    const t = asset(`schemas/${SCHEMA}/config-fragment.yaml`).toString("utf8");
+    return brackets ? bracketForm(t) : t;
+}
+/** REQ-SCH-006 the value of [ids] brackets, false when spec-ctx.toml is absent (032/D2). */
+export function bracketsOf(root) {
+    return existsSync(join(root, CONFIG_FILE)) ? loadConfig(root).ids.brackets : false;
+}
 /** Target path relative to the project root for every file that init installs, with its bytes. */
-export function plan(o, root, openspec = DEFAULT_OPENSPEC) {
+export function plan(o, root, openspec = DEFAULT_OPENSPEC, brackets = false) {
     const out = [[CONFIG_FILE, Buffer.from(configText(root, openspec))]];
     for (const rel of Object.keys(ASSETS).sort()) {
         // REQ-SCH-003 only the four templates land in the project. The fragment merges into config.yaml. No schema folder (025/D3)
         if (o.schema && rel.startsWith(TEMPLATES_SRC)) {
-            out.push([`${TEMPLATES_DIR}/${rel.slice(TEMPLATES_SRC.length)}`, asset(rel)]);
+            out.push([`${TEMPLATES_DIR}/${rel.slice(TEMPLATES_SRC.length)}`, templateBytes(rel, brackets)]);
         }
         if (o.skills && rel.startsWith("skills/")) {
             for (const d of SKILL_DIRS)
@@ -268,20 +289,26 @@ export const LEGACY_SCHEMA_NOTE = `note: schema ${SCHEMA} is no longer installed
  * REQ-SCH-003 add each top-level key of the fragment that the project config lacks.
  * A key that exists gets the fragment items it lacks (022/D4). The schema key stays as the project wrote it (025/D5).
  */
-export function mergeConfig(current, fragment) {
+export function mergeConfig(current, fragment, other) {
     let text = current ?? "";
     const added = [];
     const kept = [];
     const merged = [];
     const have = topKeys(text);
-    for (const [key, block] of topBlocks(fragment)) {
+    const blocks = topBlocks(fragment);
+    // REQ-SCH-007 an item that holds the other bracket form gets the current form in place (032/D4)
+    const swapped = other === undefined ? { text, size: 0, get: (_k) => undefined } : swapItems(text, blocks, topBlocks(other));
+    if (swapped.size)
+        text = swapped.text;
+    for (const [key, block] of blocks) {
         if (have.has(key)) {
             const lines = text.split("\n");
             const n = mergeItems(lines, key, block);
-            if (n) {
+            const r = swapped.get(key) ?? 0;
+            if (n)
                 text = lines.join("\n");
-                merged.push({ key, added: n });
-            }
+            if (n || r)
+                merged.push(r ? { key, added: n, replaced: r } : { key, added: n });
             else
                 kept.push(key);
             continue;
@@ -296,6 +323,46 @@ export function mergeConfig(current, fragment) {
     }
     return { text, added, kept, merged };
 }
+/**
+ * REQ-SCH-007 replace each project item whose value equals an item of the other form with the line of the current form (032/D4).
+ * The two fragments have the same lists in the same order, so items pair by position. The indent of the project line stays.
+ * Returns the new text and the count per top key.
+ */
+function swapItems(text, cur, other) {
+    const swap = new Map();
+    for (const [key, block] of cur) {
+        const a = fragmentLists(block);
+        const b = fragmentLists(other.get(key) ?? "");
+        a.forEach((list, i) => list.items.forEach((item, j) => {
+            const o = b[i]?.items[j];
+            if (o !== undefined && itemValue(o) !== itemValue(item))
+                swap.set(`${key}\0${itemValue(o)}`, item.trim());
+        }));
+    }
+    const counts = new Map();
+    if (!swap.size)
+        return { text, size: 0, get: (k) => counts.get(k) };
+    let top = null;
+    const lines = text.split("\n").map((line) => {
+        const m = TOP_KEY.exec(line);
+        if (m)
+            top = m[1];
+        if (!top || !/^[ \t]+- /.test(line))
+            return line;
+        const to = swap.get(`${top}\0${itemValue(line)}`);
+        if (to === undefined)
+            return line;
+        counts.set(top, (counts.get(top) ?? 0) + 1);
+        return " ".repeat(indentOf(line)) + to;
+    });
+    return { text: lines.join("\n"), size: counts.size, get: (k) => counts.get(k) };
+}
+/** REQ-SCH-007 the text of the `merged` count: added, replaced, or both (032/D4). */
+export function mergedCount(x) {
+    if (!x.replaced)
+        return `${x.added} added`;
+    return x.added ? `${x.added} added, ${x.replaced} replaced` : `${x.replaced} replaced`;
+}
 /** REQ-DIST-002 the four lines init owns in .gitignore (017/D2, 022/D5). current.json and gate-log.jsonl are per session. */
 export const GITIGNORE_LINES = [".ctx/index.json", "adopt-report.md", ".ctx/current.json", ".ctx/gate-log.jsonl"];
 const GITIGNORE = ".gitignore";
@@ -344,7 +411,11 @@ export function runInit(root, o) {
         if (d.note)
             res.notes.push(d.note);
     }
-    let files = plan(o, root, openspec);
+    // REQ-SCH-006 the form of the templates and the rules follows [ids] brackets (032/D2)
+    const brackets = bracketsOf(root);
+    const fragment = fragmentText(brackets);
+    const otherFragment = fragmentText(!brackets);
+    let files = plan(o, root, openspec, brackets);
     // REQ-CLI-007 every file present with the same bytes and no config key to add: nothing to do
     // an existing spec-ctx.toml counts as present, because the user owns it (014/D4)
     const same = files.every(([rel, data]) => existsSync(join(root, rel)) && (rel === CONFIG_FILE || readFileSync(join(root, rel)).equals(data)));
@@ -352,7 +423,7 @@ export function runInit(root, o) {
     if (same && ignoreDone && !o.force) {
         const cfgPath = join(root, "openspec/config.yaml");
         const cur = existsSync(cfgPath) ? readFileSync(cfgPath, "utf8") : null;
-        const m = o.schema ? mergeConfig(cur, asset(`schemas/${SCHEMA}/config-fragment.yaml`).toString("utf8")) : null;
+        const m = o.schema ? mergeConfig(cur, fragment, otherFragment) : null;
         if (!m || (!m.added.length && !m.merged.length)) {
             res.nothing = true;
             if (o.skills && ignoresClaude(root))
@@ -370,11 +441,16 @@ export function runInit(root, o) {
         res.kept.push(CONFIG_FILE);
     }
     if (!o.force) {
-        const differs = (rel, data) => !readFileSync(join(root, rel)).equals(data);
+        // REQ-SCH-007 a template that holds the other bracket form is unchanged, so it gets the current form (032/D3)
+        const other = new Map(plan(o, root, openspec, !brackets).filter(([rel]) => rel.startsWith(`${TEMPLATES_DIR}/`)));
+        const differs = (rel, data) => {
+            const have = readFileSync(join(root, rel));
+            return !have.equals(data) && !(other.get(rel)?.equals(have) ?? false);
+        };
         res.changed = files.filter(([rel, data]) => existsSync(join(root, rel)) && differs(rel, data)).map(([rel]) => rel);
         for (const rel of res.changed)
             res.kept.push(`${rel} (other content)`);
-        files = files.filter(([rel]) => !existsSync(join(root, rel)));
+        files = files.filter(([rel, data]) => !existsSync(join(root, rel)) || (!readFileSync(join(root, rel)).equals(data) && !differs(rel, data)));
     }
     for (const [rel, data] of files) {
         const p = join(root, rel);
@@ -385,7 +461,7 @@ export function runInit(root, o) {
     if (o.schema) {
         const cfgPath = join(root, "openspec/config.yaml");
         const cur = existsSync(cfgPath) ? readFileSync(cfgPath, "utf8") : null;
-        const m = mergeConfig(cur, asset(`schemas/${SCHEMA}/config-fragment.yaml`).toString("utf8"));
+        const m = mergeConfig(cur, fragment, otherFragment);
         if (m.added.length || m.merged.length) {
             mkdirSync(dirname(cfgPath), { recursive: true });
             writeFileSync(cfgPath, m.text);
@@ -394,7 +470,7 @@ export function runInit(root, o) {
         }
         // REQ-SCH-003 one line per key that gained items (022/D4)
         for (const x of m.merged)
-            res.merged.push(`openspec/config.yaml ${x.key} (${x.added} added)`);
+            res.merged.push(`openspec/config.yaml ${x.key} (${mergedCount(x)})`);
         for (const k of m.kept)
             res.kept.push(`openspec/config.yaml ${k}`);
         // REQ-SCH-003 the schema line is the user's. A legacy value gets a note and stays (025/D5)

package/dist/loop/fails.js

@@ -89,3 +89,14 @@ export function capQuestion(task, attempts, tail) {
 export function blockedLine(n) {
     return `blocked: question ${n} written. Run specctx handoff resolve ${n} "<answer>" to continue.`;
 }
+/**
+ * REQ-LOOP-006 the reason line of a Verify tail (029/D3): the last line that starts with `fail:` or `FAIL` after
+ * leading spaces, else the last non-empty line, else `no output`. The match is case sensitive.
+ */
+export function failLine(tail) {
+    const lines = tail.split("\n").map((l) => l.trimEnd());
+    const hit = lines.filter((l) => /^\s*(?:fail:|FAIL)/.test(l)).at(-1);
+    if (hit !== undefined)
+        return hit.trim();
+    return lines.filter((l) => l.trim()).at(-1)?.trim() ?? "no output";
+}

package/dist/loop/next.js

@@ -3,20 +3,22 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { applyBaseline } from "../baseline/baseline.js";
 import { check } from "../check/check.js";
+import { staleOf } from "../check/evidence.js";
 import { readQuestions } from "../handoff/questions.js";
 import { changeKey, matchesChange } from "../index/scan.js";
 import { listEvidence } from "../tasks/evidence.js";
 import { hasEvidence, nextTask, tasksOf } from "../tasks/tasks.js";
 import { cmpStr, cmpTuple } from "../util/pystr.js";
-import { capQuestion, failsInWindow, openQuestionFor } from "./fails.js";
+import { capQuestion, failLine, failsInWindow, openQuestionFor } from "./fails.js";
 import { openspecCommand, openspecStatus } from "./openspec.js";
 /** The closed action list. A skill stops on any value outside it. */
 export const ACTIONS = ["plan", "cite", "start", "work", "fix", "repair", "gate", "archive", "ask", "stop"];
 /** The keys of the object, sorted. Every state prints all of them. */
 export const KEYS = ["action", "attempt", "change", "command", "human", "max_attempts", "reason", "state", "task"];
 /** The rules of check whose finding means a task or a header lacks its citation (024/D2 step 4). */
-const CITE_RULES = new Set(["missing-id", "task-without-req", "task-without-verify", "unknown-task-req"]);
-const TASK_RULES = new Set(["task-without-req", "task-without-verify", "unknown-task-req"]);
+// REQ-LOOP-004 a weak Verify command is a citation gap too (028/D7)
+const CITE_RULES = new Set(["missing-id", "task-without-req", "task-without-verify", "unknown-task-req", "weak-verify"]);
+const TASK_RULES = new Set(["task-without-req", "task-without-verify", "unknown-task-req", "weak-verify"]);
 /** The active change folders under openspec/changes/, sorted. The file system decides, so a change with no tasks.md counts. */
 export function activeFolders(root) {
     const dir = join(root, "openspec", "changes");
@@ -138,7 +140,8 @@ export function decideNext(root, cfg, data, want) {
     if (current) {
         const fails = failsInWindow(root, current.id, qs);
         const last = fails.at(-1);
-        const reason = last ? `Verify failed (exit ${last.file.verify.exit ?? "timeout"}): ${last.file.stderr_tail.split("\n")[0]?.trim() || "no output"}` : null;
+        // REQ-LOOP-006 the reason names the last fail line of the tail (029/D3)
+        const reason = last ? `Verify failed (exit ${last.file.verify.exit ?? "timeout"}): ${failLine(last.file.stderr_tail)}` : null;
         if (fails.length >= cfg.loop.max_attempts && !openQuestionFor(root, current.id, qs)) {
             const q = capQuestion(current.id, fails.length, last?.file.stderr_tail ?? "");
             return done({ action: "ask", attempt: fails.length, command: `specctx handoff ask "${q}"`, human: true, reason, state: "attempts_exhausted", task: current.id });
@@ -147,6 +150,15 @@ export function decideNext(root, cfg, data, want) {
             return done({ action: "fix", attempt: fails.length, command: `specctx task done ${current.id}`, reason, state: "task_failed", task: current.id });
         return done({ action: "work", command: `specctx task done ${current.id}`, state: "task_started", task: current.id });
     }
+    // REQ-LOOP-008 step 6b: the earliest done task whose evidence went stale gets the repair run, after the current task (031/D4, 031/D5)
+    for (const t of tasks) {
+        if (t.status !== "done")
+            continue;
+        const path = staleOf(root, t.id);
+        if (path === null)
+            continue;
+        return done({ action: "repair", command: `specctx task reopen ${t.id} "stale evidence: ${path}" && specctx task done ${t.id}`, reason: `stale-evidence ${t.id} ${path}`, state: "evidence_stale", task: t.id });
+    }
     // step 7: the next open task
     const open = nextTask(root, entries, folder);
     if (open)
@@ -157,7 +169,15 @@ export function decideNext(root, cfg, data, want) {
         return done({ action: "gate", command: "specctx gate --strict", state: "gate_due" });
     }
     // step 9: archive, with the human stop from [loop] archive
-    return done({ action: "archive", command: `${openspec} archive ${folder} -y`, human: cfg.loop.archive === "ask", state: "gate_passed" });
+    const archive = `${openspec} archive ${folder} -y`;
+    if (cfg.loop.archive !== "ask")
+        return done({ action: "archive", command: archive, human: false, state: "gate_passed" });
+    // REQ-LOOP-007 a resolved archive question after the newest evidence is the approval. The stage field decides, not the text (031/D2).
+    const newest = newestEvidenceAt(root, key);
+    const approved = qs.filter((q) => q.status === "resolved" && q.task === folder && q.stage === "archive" && typeof q.resolved_at === "string" && cmpStr(q.resolved_at, newest) > 0).at(-1);
+    if (approved)
+        return done({ action: "archive", command: archive, human: false, reason: `archive approved in question ${approved.n}`, state: "gate_passed" });
+    return done({ action: "archive", command: `specctx handoff ask --change ${folder} "archive ${folder}?"`, human: true, state: "gate_passed" });
 }
 /** REQ-LOOP-001 REQ-CLI-007 the human form: action first, one line per key, next last (024/D1). Strict mode. */
 export function renderNext(d) {

package/dist/stats/stats.js

@@ -5,7 +5,10 @@ import { readBaseline } from "../baseline/baseline.js";
 import { changeKey, matchesChange } from "../index/scan.js";
 import { isFailFile } from "../tasks/evidence.js";
 import { cmpStr, cpLen } from "../util/pystr.js";
-export const DEBT_RULES = ["uncovered", "scenario-untested", "done-without-evidence", "manual-evidence"];
+// REQ-STAT-004 the two Verify rules count as debt too, the same rules the baseline can hold (029/D5)
+export const DEBT_RULES = ["uncovered", "scenario-untested", "done-without-evidence", "manual-evidence", "task-without-verify", "weak-verify"];
+/** The debt rules whose ID is a task. A change row counts them. */
+const TASK_DEBT_RULES = ["done-without-evidence", "manual-evidence", "task-without-verify", "weak-verify"];
 const NA = (n = 0) => ({ value: null, n, text: "n/a" });
 function readEvidence(root) {
     const dir = join(root, ".ctx/evidence");
@@ -120,11 +123,11 @@ export function computeStats(root, entries, strictFindings, warnings, only) {
     ];
     const fresh = [...new Set(current)].filter((k) => !base.has(k));
     const debtAll = { value: base.size + fresh.length, n: base.size + fresh.length, text: `${base.size + fresh.length} (${base.size} baselined + ${fresh.length} new)` };
-    // a change row counts the task scoped debt: tasks without evidence and tasks with manual evidence
+    // a change row counts the task scoped debt: no evidence, manual evidence, no Verify, and a weak Verify (029/D5)
     const taskDebt = (change) => {
         const keys = [...base, ...fresh].filter((k) => {
             const [rule, id] = k.split(" ");
-            return (rule === "done-without-evidence" || rule === "manual-evidence") && nameOf(id ?? "") === change;
+            return TASK_DEBT_RULES.includes(rule ?? "") && nameOf(id ?? "") === change;
         });
         return { value: keys.length, n: keys.length, text: String(keys.length) };
     };

package/dist/verify/parse.js

@@ -56,3 +56,9 @@ export function parseVerify(taskLine) {
     }
     return { kind: "command", command: spans.join(" && ") };
 }
+// REQ-CHK-005 a Verify command that always exits 0: `true`, `:`, `exit 0`, or one `echo` with no `;`, `&`, `|` (028/D1)
+const WEAK_VERIFY = /^(?:true|:|exit\s+0|echo(?:\s[^;&|\n]*)?)$/;
+/** REQ-CHK-005 true when the command, trimmed, is one of the weak forms. */
+export function isWeakVerify(command) {
+    return WEAK_VERIFY.test(command.trim());
+}

package/dist/version.js

@@ -1,2 +1,2 @@
 // REQ-CLI-001 version string. tests/cli/version.test.ts keeps it equal to package.json.
-export const VERSION = "0.2.0";
+export const VERSION = "0.3.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-ctx",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Deterministic context engine and task workflow for OpenSpec projects.",
   "type": "module",
   "license": "MIT",

package/skills/specctx-run/SKILL.md

@@ -5,7 +5,7 @@ description: Run the spec-ctx loop in an OpenSpec project. Use on "run", "contin
 
 # specctx-run
 
-Run `specctx` as `npx spec-ctx` when it is not installed. `openspec` is the command in `[gate] openspec` of `spec-ctx.toml`.
+Run `specctx` as `npx spec-ctx` when it is not installed. `openspec` is the command in `[gate] openspec` of `spec-ctx.toml`. When that key is absent, `openspec` is `npx -y @fission-ai/openspec@latest`.
 
 ## The loop
 
@@ -16,14 +16,14 @@ Run `specctx` as `npx spec-ctx` when it is not installed. `openspec` is the comm
 
 ## Actions
 
-- `plan`: follow the upstream `openspec-propose` skill for the change in `command`. Take every ID from `specctx id new REQ <CAP>` and `specctx id new SCN <CAP> --for <REQ>`. Give every task a `[REQ-...]` citation and a `Verify:` code span. Then run `specctx check --strict` and `openspec validate <c> --strict`. Fix every finding. Stop and show the plan to the user. This is the plan stop.
+- `plan`: take the change name from the request of the user in kebab case. That name is `<c>`. Follow the upstream `openspec-propose` skill for `<c>`. Read existing requirements with `specctx bundle <id>` or `specctx query`, never `openspec show`. Take every ID from `specctx id new REQ <CAP>` and `specctx id new SCN <CAP> --for <REQ>`. When the change needs several IDs of one kind, run `specctx id new --count <n>` once. Give every task a `[REQ-...]` citation and a `Verify:` code span. Then run `specctx check --strict` and `specctx gate --strict`. The gate runs the OpenSpec validate and the spec-length check. Fix every finding. Then run `specctx handoff ask --change <c> "plan ready for <c>. Approve to start the tasks?"`. This is the plan stop. `next` returns `ask` until the user resolves the question.
 - `cite`: run `specctx query --change <c> --kind req`. Add the `[REQ-...]` citation and a `Verify:` code span to the task line named in `task`. Run `specctx check`. Continue.
 - `start`: run `specctx task start <t>`. Read the bundle it prints. Continue.
 - `work`: implement the task. Tag code with `// REQ-...`. Tag tests with `// Covers: REQ-...`. Then run `specctx task done <t>`.
 - `fix`: read `reason`. It holds the tail of the failed Verify output. Fix the cause. Run `specctx task done <t>` again.
-- `repair`: run `specctx task done <t>`. It runs Verify for a ticked task that has no evidence.
+- `repair`: run the command in the `command` field. It runs Verify again for a ticked task whose evidence is absent or stale.
 - `gate`: run `specctx gate --strict`. Fix every finding. Run it again until it exits 0.
-- `archive`: when `human` is true, stop and ask the user in one line whether to archive `<c>`. When `human` is false, follow the upstream `openspec-archive-change` skill. Then run `openspec validate --all --strict`, `specctx check --strict`, and `specctx handoff write`.
+- `archive`: when `human` is true, run `specctx handoff ask --change <c> "archive <c>?"` and stop. This is the archive stop. `next` returns `ask` until the user resolves the question. When `human` is false, the user approved or `[loop] archive` is `auto`. Then run each step under `operations.archive.guidance` in `openspec/config.yaml`. Then run the command in the `command` field. Then run `openspec validate --all --strict`, `specctx check --strict`, and `specctx handoff write`.
 - `ask`: print `reason`. It is the open question. Stop. The user answers with `specctx handoff resolve <n> "<answer>"`.
 - `stop`: print `reason`. Stop.