@llipe.com/dev-tasks 0.16.2 → 0.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/developer.md +8 -3
- package/.claude/agents/github-ops.md +187 -59
- package/.claude/agents/technical-writer.md +1 -1
- package/.claude/agents/verifier.md +10 -5
- package/.claude/commands/planner.md +110 -15
- package/.claude/commands/product-engineer.md +27 -3
- package/.claude/hooks/git-guard.sh +2 -2
- package/.claude/skills/activity-init/SKILL.md +4 -0
- package/.claude/skills/activity-publish-github/SKILL.md +84 -15
- package/.claude/skills/git-ops/SKILL.md +6 -6
- package/.claude/skills/implement/SKILL.md +29 -13
- package/.claude/skills/memo-cli-usage/REFERENCE.md +1 -0
- package/.claude/skills/memo-cli-usage/SKILL.md +3 -1
- package/.claude/skills/plan/SKILL.md +6 -0
- package/.github/agents/developer.agent.md +8 -3
- package/.github/agents/github-ops.agent.md +182 -64
- package/.github/agents/planner.agent.md +123 -28
- package/.github/agents/product-engineer.agent.md +27 -3
- package/.github/agents/technical-writer.agent.md +1 -1
- package/.github/agents/verifier.agent.md +10 -5
- package/.github/instructions/implement.instructions.md +29 -13
- package/.github/instructions/plan.instructions.md +6 -0
- package/.github/skills/activity-init/SKILL.md +4 -0
- package/.github/skills/activity-publish-github/SKILL.md +84 -15
- package/.github/skills/git-ops/SKILL.md +6 -6
- package/.github/skills/memo-cli-usage/REFERENCE.md +1 -0
- package/.github/skills/memo-cli-usage/SKILL.md +3 -1
- package/.kiro/agents/developer.md +8 -3
- package/.kiro/agents/github-ops.md +182 -64
- package/.kiro/agents/planner.md +123 -28
- package/.kiro/agents/product-engineer.md +27 -3
- package/.kiro/agents/technical-writer.md +1 -1
- package/.kiro/agents/verifier.md +10 -5
- package/.kiro/skills/activity-init/SKILL.md +4 -0
- package/.kiro/skills/activity-publish-github/SKILL.md +84 -15
- package/.kiro/skills/git-ops/SKILL.md +6 -6
- package/.kiro/skills/memo-cli-usage/REFERENCE.md +1 -0
- package/.kiro/skills/memo-cli-usage/SKILL.md +3 -1
- package/.kiro/steering/implement.md +29 -13
- package/.kiro/steering/plan.md +6 -0
- package/CHANGELOG.md +42 -0
- package/README.md +79 -7
- package/TESTING.md +108 -30
- package/dist/bin/dev-tasks.d.ts +1 -1
- package/dist/bin/dev-tasks.js +126 -4
- package/dist/bin/dev-tasks.js.map +1 -1
- package/dist/bin/parse-args.d.ts +49 -1
- package/dist/bin/parse-args.d.ts.map +1 -1
- package/dist/bin/parse-args.js +132 -11
- package/dist/bin/parse-args.js.map +1 -1
- package/dist/core/checks/decision-log-format.d.ts +24 -3
- package/dist/core/checks/decision-log-format.d.ts.map +1 -1
- package/dist/core/checks/decision-log-format.js +43 -3
- package/dist/core/checks/decision-log-format.js.map +1 -1
- package/dist/core/checks/index.d.ts +2 -0
- package/dist/core/checks/index.d.ts.map +1 -1
- package/dist/core/checks/index.js +1 -0
- package/dist/core/checks/index.js.map +1 -1
- package/dist/core/checks/roadmap.d.ts +40 -0
- package/dist/core/checks/roadmap.d.ts.map +1 -0
- package/dist/core/checks/roadmap.js +78 -0
- package/dist/core/checks/roadmap.js.map +1 -0
- package/dist/core/migrate-projects/answers.d.ts +63 -0
- package/dist/core/migrate-projects/answers.d.ts.map +1 -0
- package/dist/core/migrate-projects/answers.js +79 -0
- package/dist/core/migrate-projects/answers.js.map +1 -0
- package/dist/core/migrate-projects/apply.d.ts +51 -0
- package/dist/core/migrate-projects/apply.d.ts.map +1 -0
- package/dist/core/migrate-projects/apply.js +828 -0
- package/dist/core/migrate-projects/apply.js.map +1 -0
- package/dist/core/migrate-projects/classify.d.ts +93 -0
- package/dist/core/migrate-projects/classify.d.ts.map +1 -0
- package/dist/core/migrate-projects/classify.js +170 -0
- package/dist/core/migrate-projects/classify.js.map +1 -0
- package/dist/core/migrate-projects/conventions.d.ts +118 -0
- package/dist/core/migrate-projects/conventions.d.ts.map +1 -0
- package/dist/core/migrate-projects/conventions.js +213 -0
- package/dist/core/migrate-projects/conventions.js.map +1 -0
- package/dist/core/migrate-projects/gh.d.ts +40 -0
- package/dist/core/migrate-projects/gh.d.ts.map +1 -0
- package/dist/core/migrate-projects/gh.js +115 -0
- package/dist/core/migrate-projects/gh.js.map +1 -0
- package/dist/core/migrate-projects/index.d.ts +61 -0
- package/dist/core/migrate-projects/index.d.ts.map +1 -0
- package/dist/core/migrate-projects/index.js +183 -0
- package/dist/core/migrate-projects/index.js.map +1 -0
- package/dist/core/migrate-projects/local-reader.d.ts +8 -0
- package/dist/core/migrate-projects/local-reader.d.ts.map +1 -0
- package/dist/core/migrate-projects/local-reader.js +30 -0
- package/dist/core/migrate-projects/local-reader.js.map +1 -0
- package/dist/core/migrate-projects/map.d.ts +36 -0
- package/dist/core/migrate-projects/map.d.ts.map +1 -0
- package/dist/core/migrate-projects/map.js +75 -0
- package/dist/core/migrate-projects/map.js.map +1 -0
- package/dist/core/migrate-projects/plan.d.ts +71 -0
- package/dist/core/migrate-projects/plan.d.ts.map +1 -0
- package/dist/core/migrate-projects/plan.js +638 -0
- package/dist/core/migrate-projects/plan.js.map +1 -0
- package/dist/core/migrate-projects/planfile.d.ts +149 -0
- package/dist/core/migrate-projects/planfile.d.ts.map +1 -0
- package/dist/core/migrate-projects/planfile.js +608 -0
- package/dist/core/migrate-projects/planfile.js.map +1 -0
- package/dist/core/migrate-projects/roadmap.d.ts +43 -0
- package/dist/core/migrate-projects/roadmap.d.ts.map +1 -0
- package/dist/core/migrate-projects/roadmap.js +54 -0
- package/dist/core/migrate-projects/roadmap.js.map +1 -0
- package/dist/core/migrate-projects/snapshot.d.ts +91 -0
- package/dist/core/migrate-projects/snapshot.d.ts.map +1 -0
- package/dist/core/migrate-projects/snapshot.js +285 -0
- package/dist/core/migrate-projects/snapshot.js.map +1 -0
- package/dist/core/migrate-projects/summary.d.ts +27 -0
- package/dist/core/migrate-projects/summary.d.ts.map +1 -0
- package/dist/core/migrate-projects/summary.js +35 -0
- package/dist/core/migrate-projects/summary.js.map +1 -0
- package/package.json +8 -6
|
@@ -96,13 +96,13 @@ Before merging any PR or branch, verify:
|
|
|
96
96
|
|
|
97
97
|
Choose the appropriate strategy based on context:
|
|
98
98
|
|
|
99
|
-
| Strategy | When to Use
|
|
100
|
-
| ---------------- |
|
|
101
|
-
| **
|
|
102
|
-
| **
|
|
103
|
-
| **Rebase merge** | Not part of the
|
|
99
|
+
| Strategy | When to Use | Command |
|
|
100
|
+
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- |
|
|
101
|
+
| **Merge commit** | **Default for every PR.** Issue/story PRs → integration (planner) or `main` (user), and integration PRs → `main` (user). Preserves every commit. | `gh pr merge <pr> --merge --delete-branch` |
|
|
102
|
+
| **Squash merge** | Not part of the policy; use only when the user explicitly asks for a single-commit history on a specific PR. | `gh pr merge <pr> --squash --delete-branch` |
|
|
103
|
+
| **Rebase merge** | Not part of the policy; use only when the user explicitly approves it on a specific PR. | `gh pr merge <pr> --rebase` |
|
|
104
104
|
|
|
105
|
-
**Default**:
|
|
105
|
+
**Default**: Every PR merges by merge commit, so the per-task Conventional Commits survive to `main`. Issue/story PRs also delete the source branch. Planner handles integration targets, and the user handles `main`. Never squash or rebase unless the user asks for it on a specific PR.
|
|
106
106
|
|
|
107
107
|
### 6. Resolve Merge Conflicts
|
|
108
108
|
|
|
@@ -118,6 +118,7 @@ memo write \
|
|
|
118
118
|
--entry-type decision \
|
|
119
119
|
--source agent \
|
|
120
120
|
--provenance "<csv of episodic entry ids this consolidates, if any>" \
|
|
121
|
+
--on-duplicate create-new \
|
|
121
122
|
--json
|
|
122
123
|
```
|
|
123
124
|
|
|
@@ -166,7 +167,8 @@ A `semantic` entry with `--source agent` **MUST** carry `--provenance <csv>` unl
|
|
|
166
167
|
## Agent Mode Rules
|
|
167
168
|
|
|
168
169
|
- Always pass `--json` for parseable output
|
|
169
|
-
- Always pass `--on-duplicate
|
|
170
|
+
- Always pass `--on-duplicate` for writes; in `--json` mode memo-cli fails on a duplicate without it
|
|
171
|
+
- Pass `create-new` for distinct decisions, one entry per decision row (a feature's decision write-back); pass `consolidate` only when restating or updating the same decision, such as re-writing an entry after an amendment on the same story and commit to correct its rationale (D-78)
|
|
170
172
|
- Never log API keys or secrets
|
|
171
173
|
- Bulk delete is blocked in `--json` mode (safety guard)
|
|
172
174
|
|
|
@@ -123,10 +123,26 @@ When `workstream/decisions-<feature>.md` exists and was read per step 2 above:
|
|
|
123
123
|
- If drift is detected between local and GitHub, you **MUST** reconcile immediately and report the reconciliation.
|
|
124
124
|
- If schema/data-model changes are in scope, migration artifacts **MUST** be tracked in the task list unless an explicit opt-out rationale is documented.
|
|
125
125
|
|
|
126
|
-
###
|
|
127
|
-
|
|
128
|
-
- You **
|
|
129
|
-
- You **SHOULD** route
|
|
126
|
+
### Status Comment
|
|
127
|
+
|
|
128
|
+
- You **MUST** keep the story's status comment current per `github-ops` § Status comment: create it at the first sub-task completion, edit it in place at every later sub-task completion, at PR open, at each gate recorded, and on block. The template (marker, prefix line, story table) lives in `github-ops` and is never restated here.
|
|
129
|
+
- You **SHOULD** route the status-comment write through `github-ops` whenever possible; when delegation is unavailable, run the commands below directly.
|
|
130
|
+
- Procedure, for story issue `{n}` of `repos/{o}/{r}`:
|
|
131
|
+
1. Find the comment by its marker: `gh api repos/{o}/{r}/issues/{n}/comments --paginate --jq '.[] | select(.body | startswith("<!-- dev-tasks:status -->")) | .id'`.
|
|
132
|
+
2. Absent → create it: `gh issue comment {n} --body-file <path>`.
|
|
133
|
+
3. Present → edit it in place: `gh api -X PATCH repos/{o}/{r}/issues/comments/{id} -F body=@<path>`.
|
|
134
|
+
4. Two or more comments carry the marker → edit the oldest (lowest id), never post another, and report `status_comment: failed(duplicate marker)` so a human removes the extra one.
|
|
135
|
+
5. The marker is the first byte of the body file — no leading blank line, whitespace or BOM — because the `startswith` match on line one is how the comment is found; a marker on line two means a second comment gets posted. The body always goes through a file, never inline.
|
|
136
|
+
- Each write is reported as `status_comment: written | failed(<reason>) | skipped(no issue)`. A task list with no GitHub Issue skips the comment and reports `skipped(no issue)`; a refused write (permissions, locked issue) reports `failed(<reason>)`. A failed write never blocks the sub-task — it is reported, never dropped silently.
|
|
137
|
+
|
|
138
|
+
### Wave Status Update (Main Thread Only)
|
|
139
|
+
|
|
140
|
+
- Under the `planner`, the wave's status comment belongs to the planner: report `wave_status: owned-by-planner` and do nothing further.
|
|
141
|
+
- In the main thread with no planner (the interactive `/developer` command), after PR open and at PR ready you **MUST** look up the story's parent: `gh api repos/{o}/{r}/issues/{n}/parent`.
|
|
142
|
+
- `200` → edit this story's row (state, PR, sub-task count) in the wave issue's status comment, found and edited by the same marker procedure above, and report `wave_status: written`. If the wave issue has no status comment yet, create it from the wave table in `github-ops` § Status comment and report `wave_status: written`.
|
|
143
|
+
- Header lines on this path, which has no integration branch (D-75, RD-17): `Current story` names this story; `Last merged PR` and `Integration HEAD` keep the existing comment's values when editing it and read `none` when creating the comment; `Gates` carries this story's gates.
|
|
144
|
+
- `404` → the story has no parent (published before the hierarchy convention); report `wave_status: skipped(no parent)`. This is expected, not an error.
|
|
145
|
+
- A refused read or write → `wave_status: failed(<reason>)`; it never blocks the sub-task.
|
|
130
146
|
|
|
131
147
|
---
|
|
132
148
|
|
|
@@ -157,19 +173,19 @@ When `workstream/decisions-<feature>.md` exists and was read per step 2 above:
|
|
|
157
173
|
- PRs targeting **`main`**: the **user** reviews and approves.
|
|
158
174
|
|
|
159
175
|
11. The PR **MUST** be merged by the authorized party (planner for integration branches, user for `main`).
|
|
160
|
-
12.
|
|
161
|
-
13. You **MUST NOT** close the issue
|
|
176
|
+
12. Nobody closes the GitHub Issue: not the implementing agent, not the `planner`. It closes when a PR against the default branch carrying `Closes #N` merges: under the `planner` that is the consolidated PR, and in a main-thread run with no planner (the interactive `/developer` command) it is the story PR itself. A story PR into an integration branch closes nothing, because GitHub ignores closing keywords on a PR whose base is not the default branch.
|
|
177
|
+
13. You **MUST NOT** close the issue by hand at any point, before or after the merge; if it is still open after the closing PR merged, report that instead of closing it.
|
|
162
178
|
14. You **MUST** notify the user when the PR is ready for review — explicitly inform them so they can review and merge.
|
|
163
179
|
|
|
164
180
|
---
|
|
165
181
|
|
|
166
182
|
## GitHub Execution Rules Summary
|
|
167
183
|
|
|
168
|
-
| Phase | Rule
|
|
169
|
-
| ------------------ |
|
|
170
|
-
| **Before coding** | Confirm issue open → Create branch (`github-ops`) → First commit → Open draft PR (`github-ops`) → Sync checklists
|
|
171
|
-
| **During coding** | One sub-task at a time → Mark `[x]` locally + GitHub → Wait for approval
|
|
172
|
-
| **Before closing** | All ACs verified → Quality gates pass (test/lint/format/typecheck/audit) → migration confirmation/apply/verify (when applicable) → docs drift check clear → coverage_gate recorded → verifier audit run + summary posted (non-blocking on drift) → PR ready → Approved → Merged →
|
|
184
|
+
| Phase | Rule |
|
|
185
|
+
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
186
|
+
| **Before coding** | Confirm issue open → Create branch (`github-ops`) → First commit → Open draft PR (`github-ops`) → Sync checklists |
|
|
187
|
+
| **During coding** | One sub-task at a time → Mark `[x]` locally + GitHub → Update the status comment (`github-ops` § Status comment) → Wait for approval |
|
|
188
|
+
| **Before closing** | All ACs verified → Quality gates pass (test/lint/format/typecheck/audit) → migration confirmation/apply/verify (when applicable) → docs drift check clear → coverage_gate recorded → verifier audit run + summary posted (non-blocking on drift) → PR ready → Approved → Merged → GitHub closes the issue (`Closes #N` on a default-branch PR) |
|
|
173
189
|
|
|
174
190
|
---
|
|
175
191
|
|
|
@@ -182,7 +198,7 @@ When `workstream/decisions-<feature>.md` exists and was read per step 2 above:
|
|
|
182
198
|
## Final Instructions
|
|
183
199
|
|
|
184
200
|
1. You **MUST** always respect the task list execution order.
|
|
185
|
-
2. You **MUST** keep the GitHub Issue updated with checklist and
|
|
201
|
+
2. You **MUST** keep the GitHub Issue updated with its checklist and its status comment.
|
|
186
202
|
3. You **MUST** ensure branch, PR, and issue naming follow `github-ops` conventions.
|
|
187
203
|
4. You **MUST** stop after each sub-task and request user approval.
|
|
188
|
-
5. You **MUST NOT** close a GitHub Issue
|
|
204
|
+
5. You **MUST NOT** close a GitHub Issue by hand: nobody closes it; it closes when a PR against the default branch carrying `Closes #N` merges.
|
package/.kiro/steering/plan.md
CHANGED
|
@@ -26,8 +26,10 @@ This activity adapts to the input — it works with a user stories file (from th
|
|
|
26
26
|
2. **Review Available Work:** You **MUST** read the source and list available stories or the issue scope.
|
|
27
27
|
3. **Select Scope:** In Stories Mode, you **MUST** ask which stories to include. In Issue Mode, the scope is the single issue.
|
|
28
28
|
4. **Generate Task List:** You **MUST** produce a `tasks-*.md` file in the required format.
|
|
29
|
+
- **Plan header:** The header carries `Source:` (the source document) and, on the next line, `Wave issue: #N`, its own line with no bold or backticks so the planner can read it at Phase 0. In Stories Mode, take the number from the publication report's `Wave issue` line (`workstream/github-publication-<prd-name>.md`, written by `activity-publish-github`). When the report predates the tracking hierarchy or has no `Wave issue` line, or in Issue Mode, write `Wave issue: none` and add a `> Note:` line under it saying the planner will search for the wave issue at Phase 0. When the plan fully resolves follow-up issues outside its story set, add a `Resolves: #N, #M` line after `Wave issue:`; the planner carries `Closes #N` for each on the consolidated PR (planner D-74). Omit the line when there are none.
|
|
29
30
|
5. **Publish to GitHub:** You **MUST** update the corresponding GitHub Issue(s) with the task checklist by delegating to `github-ops` whenever possible.
|
|
30
31
|
6. **Save Output.**
|
|
32
|
+
7. **Set the Task Plan Line:** When the plan header reads `Wave issue: #N`, set the wave issue body's `Task plan:` line under `## Artifacts` to a root-relative link to the saved task list, after the file is saved: read the body with `gh issue view <N> --json body --jq .body` into a file, change only that line, and write it back with `gh issue edit <N> --body-file <path>`. With `Wave issue: none` there is no wave issue body to edit, and the line stays `pending` until a later plan names the wave issue.
|
|
31
33
|
|
|
32
34
|
## Package Manager and Command Standards
|
|
33
35
|
|
|
@@ -56,6 +58,9 @@ The task list **MUST** follow this structure:
|
|
|
56
58
|
```markdown
|
|
57
59
|
# Implementation Plan - [Name]
|
|
58
60
|
|
|
61
|
+
Source: `[path to the user stories file or refined issue]`
|
|
62
|
+
Wave issue: #N
|
|
63
|
+
|
|
59
64
|
## Relevant Files
|
|
60
65
|
|
|
61
66
|
- `path/to/file1.ts` - [Description]
|
|
@@ -184,4 +189,5 @@ If this is a **greenfield project** or a **new component**, you **MUST** include
|
|
|
184
189
|
8. For schema/data-model changes, you **MUST** include migration lifecycle tasks and an explicit user-confirmation gate before applying migrations unless an opt-out rationale is documented.
|
|
185
190
|
9. You **MUST** update the corresponding GitHub Issue(s) with the task checklist by delegating to `github-ops` whenever possible. If no issue exists, you **MUST** ask the user whether to create one first.
|
|
186
191
|
10. You **MUST** save the task list file.
|
|
192
|
+
10a. When the wave issue is known, you **MUST** set its body's `Task plan:` Artifacts line to the saved task list (Process step 7).
|
|
187
193
|
11. You **MUST** inform the user they can now use the **implement** activity to start coding.
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
7
7
|
|
|
8
|
+
## [Unreleased]
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- feat(cli): `dev-tasks migrate projects --plan` writes a reviewable, read-only projects-tracking migration plan (#320)
|
|
13
|
+
- feat(cli): `dev-tasks migrate projects --apply` runs an approved migration plan's batches 1 to 6, records each write's state in the plan file and resumes from it; it never runs the Project batch, deletes nothing and refuses an unapproved, edited, locked or stale plan with exit `14` (#322)
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
|
|
17
|
+
- fix(cli): `migrate projects --plan` exits `2` with a pointer to product-engineer's roadmap conversion when `docs/roadmap.md` has no canonical table, instead of writing a plan with a roadmap note (#321)
|
|
18
|
+
- fix(cli): every command now exits `2` on an unknown flag, naming it, and on a value flag given without a value (`--profile`, `--pin`, `--repo`, `--out`, `--plan-file`, including an empty `--flag=`), instead of silently ignoring it; `dev-tasks migrate --plan`/`--apply` without the `projects` sub-verb exits `2` with a hint and never runs the legacy migration. A value that starts with `-` is given as `--flag=value` (#320)
|
|
19
|
+
|
|
20
|
+
## [0.16.4] - 2026-10-06
|
|
21
|
+
|
|
22
|
+
### Changed
|
|
23
|
+
|
|
24
|
+
- chore: validation update pre release
|
|
25
|
+
- chore(lock): reformat pnpm-lock.yaml with prettier
|
|
26
|
+
|
|
27
|
+
## [0.16.3] - 2026-10-06
|
|
28
|
+
|
|
29
|
+
### Added
|
|
30
|
+
|
|
31
|
+
- feat: quality-gate hardening — PR validate CI, coverage baseline, format scope, decision-log row validation (#245, #246, #247, #248) (#265)
|
|
32
|
+
|
|
33
|
+
### Changed
|
|
34
|
+
|
|
35
|
+
- chore: prettier update
|
|
36
|
+
- refactor(merge-policy): default issue/story PR merges to merge commit (#267)
|
|
37
|
+
|
|
8
38
|
## [0.16.2] - 2026-10-02
|
|
9
39
|
|
|
10
40
|
### Fixed
|
|
@@ -14,15 +44,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
|
14
44
|
|
|
15
45
|
## [Unreleased]
|
|
16
46
|
|
|
47
|
+
### Changed
|
|
48
|
+
|
|
49
|
+
- refactor(merge-policy): the default merge strategy for issue and story PRs is now a merge commit (`gh pr merge <n> --merge --delete-branch`) instead of squash, so the per-task Conventional Commits survive to `main`; squash and rebase merges require an explicit user request on a specific PR. Updated in `git-ops`, `github-ops`, and `planner` on all three platforms, and in the `git-guard` hook guidance (#266)
|
|
50
|
+
|
|
17
51
|
### Added
|
|
18
52
|
|
|
19
53
|
- feat(roadmap): `docs/roadmap.md` overview of PRD phases and waves, owned by `product-engineer`, updated by `planner` in the consolidated PR, and checked by a `verifier` roadmap-mismatch finding (#254)
|
|
20
54
|
- feat(memo): `product-engineer` writes confirmed grilling decisions to `kb`; `planner` verifies per-story memo fields and writes one run-outcome entry (#253)
|
|
55
|
+
- feat(ci): `validate.yml` runs `pnpm run validate` on every pull request, with runbook `docs/runbooks/runbook-diagnose-pr-validate.md` (#248)
|
|
56
|
+
- feat(test): `@vitest/coverage-v8` and `pnpm run test:coverage`; coverage baseline recorded (not enforced) in `TESTING.md`; coverage stays out of `validate` (#247)
|
|
21
57
|
|
|
22
58
|
### Fixed
|
|
23
59
|
|
|
24
60
|
- fix(git-guard): read each command's arguments from its own segment of a chained command, so a feature push followed by `gh pr create --base main` or a commit message mentioning tags no longer blocks, and every push, merge, and tag command in a chain is checked instead of only the last one (#256)
|
|
25
61
|
- fix(memo): name memo banks literally instead of `--bank $MEMO_BANK`, which is empty in a fresh shell and made every write fail; use `--manual` for `technical-writer` `kb` entries without provenance; record every write result in the closeout payload and gate merges on its presence (#253)
|
|
62
|
+
- fix(checks): decision-log rows whose cell count differs from the header now fail with `cell-count-mismatch` instead of being parsed with shifted columns (#245)
|
|
63
|
+
- fix(deps): `brace-expansion` pnpm overrides bounded to their own major (patched floors unchanged) (#247)
|
|
64
|
+
|
|
65
|
+
### Changed
|
|
66
|
+
|
|
67
|
+
- chore(format): `format` and `format:check` cover `.claude/`, `.github/`, and `.kiro/` (#246)
|
|
26
68
|
|
|
27
69
|
## [0.16.1] - 2026-09-23
|
|
28
70
|
|
package/README.md
CHANGED
|
@@ -116,13 +116,13 @@ dev-tasks status # compare installed vs latest version
|
|
|
116
116
|
|
|
117
117
|
### Exit codes
|
|
118
118
|
|
|
119
|
-
| Code | Meaning
|
|
120
|
-
| ---- |
|
|
121
|
-
| 0 | Success
|
|
122
|
-
| 1 | Unexpected error
|
|
123
|
-
| 2 | Incorrect usage
|
|
124
|
-
| 11 | Dependency check failed (`doctor`)
|
|
125
|
-
| 14 | Reconciliation conflict (edited fields)
|
|
119
|
+
| Code | Meaning |
|
|
120
|
+
| ---- | ---------------------------------------------------------------------------------------------------------------------- |
|
|
121
|
+
| 0 | Success |
|
|
122
|
+
| 1 | Unexpected error, or a write that failed (`migrate projects --apply`) |
|
|
123
|
+
| 2 | Incorrect usage, no canonical `docs/roadmap.md` table, or an unparsable or foreign migration plan (`migrate projects`) |
|
|
124
|
+
| 11 | Dependency check failed (`doctor`), or `gh` missing or unauthenticated (`migrate projects`) |
|
|
125
|
+
| 14 | Reconciliation conflict (edited fields; an unapproved, edited, locked, changing or stale migration plan) |
|
|
126
126
|
|
|
127
127
|
Full contract, including retirement history for codes no longer in use: [`core/exit-codes.ts`](core/exit-codes.ts).
|
|
128
128
|
|
|
@@ -139,6 +139,8 @@ dev-tasks unpin # Remove the version pin
|
|
|
139
139
|
dev-tasks doctor # Check Node ≥24, git ≥2.37, cache writable
|
|
140
140
|
dev-tasks migrate # Migrate from legacy shell-script install
|
|
141
141
|
dev-tasks migrate docs [--force] # Rename the foundation docs to their current names
|
|
142
|
+
dev-tasks migrate projects --plan # Write a reviewable projects-tracking migration plan (read-only)
|
|
143
|
+
dev-tasks migrate projects --apply # Apply an approved migration plan, recording every write
|
|
142
144
|
```
|
|
143
145
|
|
|
144
146
|
### Version Pinning
|
|
@@ -196,6 +198,76 @@ Files you own are yours to update. The command reports which of them still
|
|
|
196
198
|
name the old documents; it does not edit them, and neither does
|
|
197
199
|
`dev-tasks update`.
|
|
198
200
|
|
|
201
|
+
### Projects-Tracking Migration Plan
|
|
202
|
+
|
|
203
|
+
`dev-tasks migrate projects --plan` reads an existing repository through `gh`
|
|
204
|
+
and writes a migration plan to `workstream/migration-projects.md`: the lists
|
|
205
|
+
that need your answer (stories it could not map to a wave, issues that need
|
|
206
|
+
a `type:`, `priority: critical` issues with no blocking link, planner state
|
|
207
|
+
files without a `Wave issue:` line, roadmap notes) and the write batches the
|
|
208
|
+
projects-tracking scope rules permit, from labels to the PRD status comment,
|
|
209
|
+
ending with the Project cleanup steps you run yourself. It is **read-only**:
|
|
210
|
+
nothing on GitHub changes, and the plan file holds issue numbers, titles and
|
|
211
|
+
label names, never issue bodies.
|
|
212
|
+
|
|
213
|
+
A story maps to its wave by its `**Story:**` body line, then by a `phase:`
|
|
214
|
+
label within the PRD named in its `[PRD-<name>]` title prefix; anything else
|
|
215
|
+
is listed for you, never guessed. Answer in the plan's Answer columns and run
|
|
216
|
+
`--plan` again: it reads your answers, rebuilds the batches and resets
|
|
217
|
+
`Approved: no`.
|
|
218
|
+
|
|
219
|
+
```bash
|
|
220
|
+
dev-tasks migrate projects --plan # Plan for the current repository
|
|
221
|
+
dev-tasks migrate projects --plan --out /tmp/plan.md # Write the plan elsewhere
|
|
222
|
+
dev-tasks migrate projects --plan --json # Summary as JSON
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
It needs `gh` authenticated to github.com with the `repo` scope, checked
|
|
226
|
+
first (exit `11` with the `gh auth login` hint otherwise), and it must run
|
|
227
|
+
inside a clone of the repository: `--repo` may only confirm it (exit `2`
|
|
228
|
+
otherwise). It exits `2` when `docs/roadmap.md` has no canonical table:
|
|
229
|
+
run product-engineer's roadmap conversion first. It refuses with exit `14`
|
|
230
|
+
to overwrite a plan file that already records applied writes.
|
|
231
|
+
|
|
232
|
+
`dev-tasks migrate projects --apply [--plan-file <path>] [--json]` applies the
|
|
233
|
+
plan once you have reviewed it and set its header to exactly `Approved: yes`.
|
|
234
|
+
It runs batches 1 to 6 in order and records each write's state in the plan
|
|
235
|
+
file after its call (`done`, `done(#N)` for a created issue,
|
|
236
|
+
`failed(<reason>)`, `skipped(already applied)`, `skipped(depends on W-NNN)`),
|
|
237
|
+
so an interrupted or failed run is resumed by running it again: it never
|
|
238
|
+
repeats a `done` write, and it checks each write's target first, so a write
|
|
239
|
+
that landed without being recorded is found, not made twice. The target
|
|
240
|
+
check reads the repository as the run's start-of-run snapshot plus the run's
|
|
241
|
+
own writes; a status comment, a sub-issue parent and a blocking list are
|
|
242
|
+
read live just before their write. It exits `2` for a plan file that is
|
|
243
|
+
missing or unparsable (a plan with no `Approved:` header at all, such as a
|
|
244
|
+
lower-case `approved: yes`, is unparsable), for a repository other than the
|
|
245
|
+
plan's, or when `docs/roadmap.md` lost its canonical table. It refuses with
|
|
246
|
+
exit `14`, writing nothing, when the header is not exactly one
|
|
247
|
+
`Approved: yes` line, when a row was edited after the plan was generated
|
|
248
|
+
(`Plan digest:`), when another run holds `workstream/.migration-projects.lock`,
|
|
249
|
+
when the plan file changes while `--apply` is starting, or, before any write
|
|
250
|
+
is recorded, when the repository changed since the plan (regenerate it with
|
|
251
|
+
`--plan`). It exits `1` when any write failed or the run was interrupted
|
|
252
|
+
(`SIGINT`, `SIGTERM` and `SIGHUP` kill the `gh` call in flight, release the
|
|
253
|
+
lock and keep the states so far).
|
|
254
|
+
|
|
255
|
+
If the very first write lands but its state cannot be written back (a full
|
|
256
|
+
disk, a killed process), every row still reads `pending`, so the next
|
|
257
|
+
`--apply` sees a changed repository and exits `14`. Run `--plan` again,
|
|
258
|
+
approve the new plan, and run `--apply`: the new plan does not propose the
|
|
259
|
+
write that landed, so no write is repeated. It never runs batch 7, never makes a
|
|
260
|
+
Project call, never deletes a label or anything else, and never writes a
|
|
261
|
+
title or a Status: it prints batch 7's steps for you to run. Answers in the
|
|
262
|
+
review tables become writes only through a fresh `--plan`.
|
|
263
|
+
|
|
264
|
+
The whole procedure, from the roadmap check to the committed plan file and
|
|
265
|
+
rollback by hand, is
|
|
266
|
+
[`docs/runbooks/runbook-migrate-to-projects-tracking.md`](docs/runbooks/runbook-migrate-to-projects-tracking.md).
|
|
267
|
+
github-ops' migration mode walks you through it: it asks one question per
|
|
268
|
+
review item, writes your answers into the plan, runs `--apply` only after you
|
|
269
|
+
approve, and leaves the Project batch to you.
|
|
270
|
+
|
|
199
271
|
**Note the asymmetry with the bare `migrate` command.** `dev-tasks migrate`
|
|
200
272
|
(no sub-verb) migrates a legacy shell-script install and applies its change
|
|
201
273
|
immediately. `dev-tasks migrate docs` proposes by default. The difference is
|
package/TESTING.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
version: 1.
|
|
2
|
+
version: 1.12
|
|
3
3
|
name: Testing Standard
|
|
4
4
|
description: Canonical testing contract for dev-tasks — declares test layers, runners, commands, fixtures, and coverage policy.
|
|
5
5
|
status: filled
|
|
@@ -29,9 +29,9 @@ owner: qa-engineer
|
|
|
29
29
|
|
|
30
30
|
This is a single-package TypeScript repository; no workspace manifest or additional package was detected.
|
|
31
31
|
|
|
32
|
-
| Package | Language | Runner | Test command | Test environment | Coverage tooling
|
|
33
|
-
| ---------------------- | -------------- | ------------ | --------------- | ---------------------------- |
|
|
34
|
-
| `@llipe.com/dev-tasks` | TypeScript/ESM | Vitest 3.2.6 | `pnpm run test` | Node (`environment: "node"`) | V8
|
|
32
|
+
| Package | Language | Runner | Test command | Test environment | Coverage tooling |
|
|
33
|
+
| ---------------------- | -------------- | ------------ | --------------- | ---------------------------- | ------------------------------------------------------------------------------- |
|
|
34
|
+
| `@llipe.com/dev-tasks` | TypeScript/ESM | Vitest 3.2.6 | `pnpm run test` | Node (`environment: "node"`) | V8 via `@vitest/coverage-v8` 3.2.6 (exact pin), run by `pnpm run test:coverage` |
|
|
35
35
|
|
|
36
36
|
Tests live in `test/unit/` and `test/integration/` and use `*.test.ts`. `test/fixtures/` is excluded from `.test.ts` collection by `vitest.config.ts`. That exclusion is about collection only — it does not mean the tree is inert. `test/fixtures/docs-structure/*` and `test/fixtures/workspace-*` are live input fixtures read by passing tests, and editing one changes what those tests assert.
|
|
37
37
|
|
|
@@ -61,33 +61,33 @@ The package is a CLI and filesystem toolkit, so Node is the correct environment;
|
|
|
61
61
|
|
|
62
62
|
### Runtime parity
|
|
63
63
|
|
|
64
|
-
- CI
|
|
64
|
+
- CI workflows `validate.yml` and `publish-npm.yml` use Node `24`.
|
|
65
65
|
- The package declares production engine `>=24`.
|
|
66
66
|
- Local validation has been observed on Node `v26.7.0`, which is above the declared engine floor.
|
|
67
|
-
- The test suite
|
|
68
|
-
- A deployment of CI against Node 24 while the development environment uses Node 26 represents a minor runtime mismatch but carries no known risk to the harness itself;
|
|
67
|
+
- The full test suite passes on both runtimes, locally on Node 26 and on Node 24 in the `validate.yml` pull request check, apart from the known HEAD-dependent test listed under [Harness defects to track](#harness-defects-to-track). That test depends on the git state of the checkout, not on the Node version.
|
|
68
|
+
- A deployment of CI against Node 24 while the development environment uses Node 26 represents a minor runtime mismatch but carries no known risk to the harness itself; no runtime-specific failure has been observed on either version.
|
|
69
69
|
|
|
70
70
|
## Commands
|
|
71
71
|
|
|
72
|
-
| Script | Purpose | Status
|
|
73
|
-
| ------------------ | ----------------------------------------------------------------------------------------------------- |
|
|
74
|
-
| `lint` | ESLint
|
|
75
|
-
| `lint:fix` | ESLint auto-fix | present
|
|
76
|
-
| `format` | Prettier write | present
|
|
77
|
-
| `format:check` | Prettier verification | present
|
|
78
|
-
| `typecheck` | TypeScript analysis | present
|
|
79
|
-
| `test` | Aggregate Vitest run; reaches this package's unit and integration tests | present
|
|
80
|
-
| `test:unit` | Unit tests | present
|
|
81
|
-
| `test:integration` | Integration-directory tests; these are CLI/filesystem integration tests, not Layer 2.5 database tests | present
|
|
82
|
-
| `test:e2e` | Playwright tests | not configured; no Playwright setup
|
|
83
|
-
| `test:coverage` | Coverage measurement
|
|
84
|
-
| `audit` | Production dependency audit | present
|
|
85
|
-
| `validate` | `typecheck` → `lint` → `format:check` → aggregate `test` | present
|
|
72
|
+
| Script | Purpose | Status |
|
|
73
|
+
| ------------------ | ----------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
|
74
|
+
| `lint` | ESLint **and** `tsx core/checks/run.ts` (docs-structure, decision-log, glossary, vocabulary checks) | present |
|
|
75
|
+
| `lint:fix` | ESLint auto-fix | present |
|
|
76
|
+
| `format` | Prettier write | present |
|
|
77
|
+
| `format:check` | Prettier verification | present |
|
|
78
|
+
| `typecheck` | TypeScript analysis | present |
|
|
79
|
+
| `test` | Aggregate Vitest run; reaches this package's unit and integration tests | present |
|
|
80
|
+
| `test:unit` | Unit tests | present |
|
|
81
|
+
| `test:integration` | Integration-directory tests; these are CLI/filesystem integration tests, not Layer 2.5 database tests | present |
|
|
82
|
+
| `test:e2e` | Playwright tests | not configured; no Playwright setup |
|
|
83
|
+
| `test:coverage` | Coverage measurement (`vitest run --coverage`); separate from `validate`, which does not run coverage | present |
|
|
84
|
+
| `audit` | Production dependency audit | present |
|
|
85
|
+
| `validate` | `typecheck` → `lint` → `format:check` → aggregate `test` | present |
|
|
86
86
|
|
|
87
87
|
### Gate reachability
|
|
88
88
|
|
|
89
89
|
- **Aggregate test command:** `pnpm run test` (`vitest run`), which includes `test/**/*.test.ts` and excludes `test/fixtures/**`; the single package is reached, including both `test/unit/` and `test/integration/`.
|
|
90
|
-
- **CI gate:** `
|
|
90
|
+
- **CI gate:** `validate.yml` runs `pnpm run validate`, which reaches the aggregate test command, on every pull request into any base branch (#248; runbook `docs/runbooks/runbook-diagnose-pr-validate.md`). `publish-npm.yml` runs it again on the tag-triggered publish. The PR check is not yet _required_ by branch protection: that is a manual repository setting (`docs/runbooks/runbook-configure-branch-protection.md`). Coverage (`test:coverage`) is not part of either gate.
|
|
91
91
|
- **Deploy gate:** no deploy workflow was detected; deploy quality-gate status is not automatically enforced.
|
|
92
92
|
- `release-bundle.yml` does not invoke `validate` or the aggregate test command.
|
|
93
93
|
|
|
@@ -95,10 +95,27 @@ The package is a CLI and filesystem toolkit, so Node is the correct environment;
|
|
|
95
95
|
|
|
96
96
|
### Thresholds and baseline policy
|
|
97
97
|
|
|
98
|
-
- Measurement tool: V8
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
- Regression policy:
|
|
98
|
+
- Measurement tool: V8, through `@vitest/coverage-v8` 3.2.6, pinned exactly to the installed `vitest` version. `vitest.config.ts` scopes measurement to `core/**/*.ts` and `bin/**/*.ts`. Run it with `pnpm run test:coverage`; reports are written to `coverage/` (text summary on stdout, plus HTML, `clover.xml`, and `coverage-final.json`), which is ignored by git, Prettier, and ESLint.
|
|
99
|
+
- Gate placement: coverage is **not** part of `validate`. `validate` runs the plain aggregate `test` command, so its runtime is unaffected by coverage instrumentation.
|
|
100
|
+
- Threshold policy: no numeric threshold has been established. The baseline below is **recorded, not enforced** this pass: `vitest.config.ts` declares no `thresholds`, and a coverage drop does not fail any script or gate.
|
|
101
|
+
- Regression policy: compare a new `pnpm run test:coverage` run against the baseline and report the delta in the `qa-engineer` coverage gate. Whether to enforce a floor is a later, separate decision.
|
|
102
|
+
|
|
103
|
+
### Baseline
|
|
104
|
+
|
|
105
|
+
Measured 2026-10-02 at commit `463638d` (branch `story/S-247-coverage-baseline`, off `integration/quality-gate-hardening` at `1224aee`), 69 test files / 2271 tests, all passing. Covered / total in parentheses.
|
|
106
|
+
|
|
107
|
+
| Tree | Files | Statements | Branches | Functions | Lines |
|
|
108
|
+
| --------- | ----- | -------------------- | ------------------ | ---------------- | -------------------- |
|
|
109
|
+
| `core/**` | 23 | 91.12% (2063 / 2264) | 91.47% (644 / 704) | 91.75% (89 / 97) | 91.12% (2063 / 2264) |
|
|
110
|
+
| `bin/**` | 2 | 0.00% (0 / 500) | 0.00% (0 / 2) | 0.00% (0 / 2) | 0.00% (0 / 500) |
|
|
111
|
+
| All files | 25 | 74.63% (2063 / 2764) | 91.21% (644 / 706) | 89.89% (89 / 99) | 74.63% (2063 / 2764) |
|
|
112
|
+
|
|
113
|
+
How to read these numbers:
|
|
114
|
+
|
|
115
|
+
- The 0% for `bin/**` is mostly a measurement artifact. `test/unit/cli-binaries.test.ts` and the integration suite run `bin/dev-tasks.ts` by spawning it in a `tsx` child process. V8 coverage instruments only the Vitest worker process, so child-process execution is not recorded.
|
|
116
|
+
- `bin/parse-args.ts` is a real gap as well as an artifact: no test imports it directly, so it is exercised only end to end through the CLI child process.
|
|
117
|
+
- The same artifact affects `core/**`. `core/checks/run.ts` reads 0% (57 statements) because it runs only through `tsx`, from the `lint` script or a child process. The `core/**` baseline is therefore slightly understated, but it is still the meaningful baseline; the `All files` row is pulled down mainly by `bin/**`.
|
|
118
|
+
- Statements and lines are identical because the V8 provider maps coverage per line.
|
|
102
119
|
|
|
103
120
|
When coverage cannot be measured, report `coverage_gate: SKIPPED(<non-empty reason>)` and enumerate untested or weakly tested surfaces, source-to-test ratios, exclusions, and limitations. Never infer zero coverage or a pass.
|
|
104
121
|
|
|
@@ -106,6 +123,8 @@ When coverage cannot be measured, report `coverage_gate: SKIPPED(<non-empty reas
|
|
|
106
123
|
|
|
107
124
|
Tests primarily use deterministic fixture repositories under `test/fixtures/`, temporary directories rooted in the OS temp directory, and subprocess execution for CLI entry points. Fixture projects that intentionally model harness defects are excluded from Vitest collection. No duplicated token builders or client mocks were detected, and no global `fetch`/timer stubs were detected. Any future global stub must be restored explicitly.
|
|
108
125
|
|
|
126
|
+
`migrate projects` (`core/migrate-projects/`) is tested against an in-memory GitHub model (`test/unit/migrate-projects/helpers/fake-github.ts`) served through an injected `GhRunner`, never the network. Its read-only guarantee is checked by a write classifier written in the test (`helpers/is-write.ts`), never imported from production, so the property is not checked by the code it checks. The Layer 2 CLI tests run the real binary and the real `execFile("gh")` runner against a fake `gh` (`test/fixtures/migrate-projects/fake-gh/gh`) placed alone with a `node` symlink in a purpose-built `PATH` directory, with the clock injected through `DEV_TASKS_NOW`. Property tests use a seeded PRNG (`helpers/prng.ts`, seed from `MIGRATE_SEED`, printed in every failure message), not a property-testing dependency. The model also serves issue comments, for the PRD status-comment marker, and `helpers/model-apply.ts` replays a plan's batch 1 to 6 rows onto it from the documented Detail grammar, on the test side, so "re-planning after the writes proposes none" (RT-12) is not checked by the planner itself. The AC-11 expected plan in `ac11-fixture.test.ts` is written by hand, never regenerated from the code (RV-3). For `--apply`, `helpers/fake-github-writes.ts` is the model's write half, written from what `gh` and GitHub do with each write argv rather than from `apply.ts`, so the `apply-*.test.ts` files assert the resulting repository state; it throws on a call `--apply` must never make (a Project call, `label delete`, a title edit, an inline `--body`), and its `Intercept` answers a write with a failure, an interruption before it, or an interruption after it landed. `helpers/apply-run.ts` runs `--apply` in process with an in-memory plan store and lock, and `helpers/random-repo.ts` feeds the RT-11 walk. The CLI tests build an `--apply` scenario by running it in process over a copy of the model and replaying the answers through the fake `gh`, which keys a body-file path as `<file>` and can slow each answer (`FAKE_GH_DELAY_MS`) so a test interrupts a run between calls. `apply-writeback.test.ts` wraps `node:fs` with `vi.mock` so a write stops half-way and the rename fails, the way a killed process would, to show the plan file is old or new and never truncated (EC-140).
|
|
127
|
+
|
|
109
128
|
Gold or generated fixture files must record their source and regeneration path where applicable. Generated catalog outputs are test artifacts, not coverage evidence, and must not be used as durable validation without freshness and scope checks.
|
|
110
129
|
|
|
111
130
|
## Security-Negative Tests
|
|
@@ -116,12 +135,71 @@ This package has no authentication or authorization implementation path in the a
|
|
|
116
135
|
|
|
117
136
|
### Environment-fragility patterns
|
|
118
137
|
|
|
119
|
-
The test suite runs to completion
|
|
138
|
+
The test suite runs to completion, and its only known intermittent failure is the HEAD-dependent test in item 5 below. Some patterns in test design carry environment-fragility risk if new tests adopt them. Avoid these patterns:
|
|
120
139
|
|
|
121
140
|
- **Root-permission assumptions.** A test that `chmod`s a path unwritable and expects a failure passes only as a non-root user. Root ignores the bits. `test/unit/migrate-docs.test.ts` shows the correct pattern: probe whether writes are actually blocked, and `ctx.skip()` when they are not. `checkCacheDir` and `runUpdate --force` should adopt it if they are written.
|
|
122
141
|
- **PATH assumptions.** A test that sets `PATH=/usr/bin:/bin` to simulate a missing binary depends on that binary being absent from those directories. `yq` is present at `/usr/bin/yq` in some containers. A purpose-built empty directory is the reliable form.
|
|
123
142
|
|
|
124
143
|
1. `vitest.config.ts`: `restoreMocks` is not enabled. Expected state: enable explicit mock restoration if mocks/stubs are introduced, and retain per-test cleanup for any global stubs.
|
|
125
|
-
2.
|
|
126
|
-
3. CI/deploy wiring:
|
|
127
|
-
4. Runtime alignment: `publish-npm.yml`
|
|
144
|
+
2. Coverage of `bin/**`: resolved for `core/**` by #247 (provider, `test:coverage`, and a recorded baseline). `bin/**` still measures 0% because it is exercised only through child processes, which in-process V8 coverage does not capture. Expected state: either measure child processes (for example via `NODE_V8_COVERAGE`) or record `bin/**` as out of measured scope.
|
|
145
|
+
3. CI/deploy wiring: the pull request half is resolved by #248 — `validate.yml` runs `pnpm run validate` on every pull request. Still open: no deploy workflow invokes the aggregate test command, and the pull request check is not yet a _required_ status check in branch protection (a manual repository setting, see `docs/runbooks/runbook-configure-branch-protection.md`). Expected state: every CI test job and deploy quality gate runs `pnpm run test` or `pnpm run validate`, and the pull request check is required.
|
|
146
|
+
4. Runtime alignment: `validate.yml` and `publish-npm.yml` use Node 24 while local development uses Node 26. Both runtimes pass the full test suite (the HEAD-dependent test in item 5 aside, which is not runtime-related), so there is no blocker to release. Future work may align these to a single supported range or explicitly document the tested range in the engine constraint.
|
|
147
|
+
5. HEAD-dependent test: `test/unit/infra-script-contract.test.ts`, case `deploy.sh prod — ref rules (AC-4) > refuses when the ref is not an annotated tag on main`, expects a refusal and fails when `HEAD` is the tagged release commit. It was observed failing intermittently during the quality-gate-hardening batch (#245–#248). The pull request runbook (`docs/runbooks/runbook-diagnose-pr-validate.md`) tells a reader to re-run the job once when it is the only failure. Expected state: the test's result does not depend on which commit is checked out.
|
|
148
|
+
|
|
149
|
+
## Known limitations
|
|
150
|
+
|
|
151
|
+
**Regex parity tests prove presence, not meaning.** The prompt parity suites (for example `test/unit/projects-tracking-parity.test.ts`) prove that each required sentence is present, appears in the required order, and is identical across the `.claude`, `.github` and `.kiro` trees. They cannot prove that nearby text does not contradict, qualify or weaken those sentences: an added "unless", a synonym, or a conflicting rule elsewhere in the same prompt passes every assertion. Wave 2 of projects-tracking closed with 8 such synonym and qualifier probes still surviving after hardening; chasing them with more patterns has diminishing returns. Meaning-level fidelity therefore rests on the `verifier` audit (Audit Mode fidelity reports) and on the dogfood reads in the Dogfood checks table, not on the test suite. A green parity suite is evidence of presence only.
|
|
152
|
+
|
|
153
|
+
## Dogfood checks
|
|
154
|
+
|
|
155
|
+
Behavioural acceptance criteria of the projects-tracking PRD cannot run inside Vitest: a mocked `gh` would test the mock, not the agent (D-39). Each is verified by reading GitHub after a real event, using the `DF-*` rows of `workstream/test-plan-projects-tracking-phase-1.md`, and recorded here with the satisfying issue number. `pending` means the event has not happened yet; `n/a (pre-rule)` marks the two wave 1 stories that ran before S-003's status-comment rule existed in the loaded prompt (D-42).
|
|
156
|
+
|
|
157
|
+
| Criterion | Event | Issue | Status |
|
|
158
|
+
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
159
|
+
| PRD AC-1 — publish creates the PRD/wave/story hierarchy | Wave 2 publish by `product-engineer` (DF-1, zero-match path) | #289, #290, #291 to #296 | observed 2026-10-21: wave 2 publish created the PRD and wave tracking issues and attached six stories, hierarchy verified(7 of 7) |
|
|
160
|
+
| PRD AC-2 (live half) — tracking issues carry `level:` only | Wave 2 publish (DF-1) | #289, #290 | observed 2026-10-21: both tracking issues carry their `level:` label only |
|
|
161
|
+
| PRD AC-3 (b) — story status comment, S-001 | `/developer` on #270 (DF-2) | #270 | n/a (pre-rule) |
|
|
162
|
+
| PRD AC-3 (b) — story status comment, S-002 | `/developer` on #271 (DF-2) | #271 | n/a (pre-rule) |
|
|
163
|
+
| PRD AC-3 (b) — story status comment, S-003 | `/developer` on #272 (DF-2) | #272 | observed 2026-10-20: one marked comment (id 6302983274), edited in place; comment created at sub-task 3.2a, after the draft PR, because the rule did not exist before 3.2 (S-003 DR-2) |
|
|
164
|
+
| PRD AC-3 (b) — story status comment, S-004 | `/developer` on #273 (DF-2) | #273 | observed 2026-10-20: one marked comment (id 6303270800), edited in place |
|
|
165
|
+
| PRD AC-3 (b) — story status comment, S-005 | `/developer` on #274 (DF-2) | #274 | observed 2026-10-20: one marked comment (id 6303586826), edited in place |
|
|
166
|
+
| PRD AC-3 (b) — story status comment, S-006 | `/developer` on #275 (DF-2) | #275 | observed 2026-10-21: one marked comment (id 6305768927), edited in place |
|
|
167
|
+
| PRD AC-3 (a, live half) — Project Status written only by automations | Consolidated PR to main opens with `Closes #N` (Status → In progress) and merges (→ Done); story PRs into the integration branch move nothing (D-50) (DF-5) | #270 to #275; #285, #290 to #296 | observed: wave 1 Done after PR #282 merged; wave 2 In progress for all eight issues at 20:39Z 2026-10-22 after consolidated PR #312 opened, read with `projectItems`, no agent write; Done for all eight at 21:00Z after PR #312 merged, `project_observation: observed` |
|
|
168
|
+
| FR-24 — wave update, no-parent path (404) | Any wave 1 story's `/developer` run (DF-3) | #272, #273, #274, #275 | observed: `gh api …/parent` returns 404; closeout carries `wave_status: skipped(no parent)` |
|
|
169
|
+
| FR-24 — wave update, success path (200) | First main-thread `/developer` run on a wave 2 story: parent found, wave comment edited (DF-3) | pending | pending |
|
|
170
|
+
| D-36 — second publish reuses the PRD issue (one-match path) | Wave 3 publish (DF-1b) | #289, #317 | observed 2026-10-24: the wave 3 publish found exactly one open `[PRD-projects-tracking]` issue and reused #289, then created wave #317 under it (`workstream/github-publication-projects-tracking-phase-3.md`). |
|
|
171
|
+
| PRD AC-5 (live half) — runbook exercise (DF-4) | Owner follows `docs/runbooks/runbook-configure-github-project.md` on `llipe/dev-tasks` | #274 (Project 5) | observed 2026-10-21: Project 5 created from the Team planning template; seven shipped workflows enabled; auto-add `is:issue`; fields kept by decision D-48 |
|
|
172
|
+
| Wave 2 DF-6 — checkpoint committed after every merge | `/planner` wave 2 run (S-008 rule) | integration/projects-tracking-phase-2 | observed 2026-10-22, hand-applied (rule merged at S-008): six `chore(planner): checkpoint after S-0xx merge` commits, each after its merge |
|
|
173
|
+
| Wave 2 DF-7 — state file carries `Wave issue` and `PRD issue` | `/planner` wave 2 run (S-008, S-018 rules) | #290, #289 | observed 2026-10-22, hand-applied |
|
|
174
|
+
| Wave 2 DF-8 — one wave status comment, edited in place | `/planner` wave 2 run (S-009 rule) | #290 | partly observed 2026-10-22, hand-applied: one marker comment edited at run start and every merge; never edited at a story's PR-ready closeout, so no story showed `PR open` (rollup RD-1) |
|
|
175
|
+
| Wave 2 DF-9 — no per-merge table comments | `/planner` wave 2 run (S-009 rule) | #290 to #296 | observed 2026-10-22 |
|
|
176
|
+
| Wave 2 DF-11 — consolidated PR carries `Closes` for every merged story and the wave | Consolidated PR open (S-010 rule) | #312 | observed 2026-10-22: `Closes` for #291 to #296, #290 and #285 under `## Why`; GitHub links all eight |
|
|
177
|
+
| Wave 2 DF-15 — close-out runs from the merged prompt | Phase 6 in a fresh session on `main` (S-011 rule) | close-out PR | observed 2026-10-22: Phase 6 run from the merged prompt on `main` |
|
|
178
|
+
| Wave 2 DF-16 — PRD status comment at run start, PR open and close-out | `/planner` wave 2 run (S-018 rule) | #289 | run start hand-applied; PR open and shipped observed 2026-10-22 from the merged prompt |
|
|
179
|
+
| DF-21 — S-016 roadmap check is a no-op on a canonical roadmap | Wave 3 migration, before `--plan` | #323 | observed 2026-10-25: `roadmap-parity` 28/28; this repository's roadmap was already canonical, so no conversion PR. |
|
|
180
|
+
| DF-22 — `--plan` is read-only (FR-17) | Wave 3 migration, `--plan` | #323 | observed 2026-10-26: labels and open issues identical before and after a `--plan` run (qa-engineer, PR #332). |
|
|
181
|
+
| DF-23 — Migration Mode asks one question per review item (S-017/AC-2) | Wave 3 migration review walk | #323 | observed 2026-10-25 (planner attestation): nine items asked one per message; the owner overrode two recommendations (#108, #262). |
|
|
182
|
+
| DF-24 — `Approved: yes` set only on explicit approval (D-80) | Before `--apply` | #323 | observed 2026-10-25 (planner attestation): set after the owner wrote "approved"; one `Approved: yes` line; Plan digest recomputes to the header. |
|
|
183
|
+
| DF-25 — `--apply` records every write (S-015/AC-3, AC-8) | Wave 3 migration, `--apply` | #323 | observed 2026-10-25: exit 0, 14 done, 0 skipped, 0 failed; every row matches GitHub. |
|
|
184
|
+
| DF-26 — the Project batch is the owner's (PRD AC-12, D-81) | Owner runs batch 7 | #323 | observed 2026-10-26: four steps ticked by the owner (screenshot: auto-add `is:issue`, Item closed and Pull request merged on); Project 5 holds 48 issue items, 0 pull requests. |
|
|
185
|
+
| DF-27 — re-plan after apply proposes nothing | After `--apply` | #323 | observed 2026-10-26: fresh `--plan --out <scratch>` has 0 rows in batches 1 to 6. |
|
|
186
|
+
| DF-28 — the record ships in the consolidated PR (D-93, D-112) | Record PR | #323 | observed 2026-10-26: PR #332 (`chore/323-projects-migration` into the integration branch) carries `workstream/migration-projects.md`; the consolidated PR references #332. |
|
|
187
|
+
| DF-29 — PRD AC-12, FR-19, FR-20 on live data | After `--apply` | #323 | observed 2026-10-26: no D-91 retired label defined; #317 under #289 with #318 to #323; one marker comment on #289; titles unchanged. |
|
|
188
|
+
|
|
189
|
+
## Changelog
|
|
190
|
+
|
|
191
|
+
| Version | Date | Change | Author |
|
|
192
|
+
| ------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
|
|
193
|
+
| 1.12 | 2026-10-27 | Dogfood checks: wave 3 rows DF-21 to DF-29 observed (#323, PR #332); the D-36 one-match publish row observed on the wave 3 publish (#289 reused). | planner |
|
|
194
|
+
| 1.11 | 2026-10-24 | Fixtures and Mocking: the `node:fs` crash mock for EC-140 (S-015 task 5.22, #322). | developer |
|
|
195
|
+
| 1.10 | 2026-10-24 | Fixtures and Mocking: the `--apply` harness (the model's write half, `apply-run.ts`, `random-repo.ts`, the fake `gh`'s `<file>` keys and delay) (S-015, #322). | developer |
|
|
196
|
+
| 1.9 | 2026-10-24 | Fixtures and Mocking: the model serves issue comments; `helpers/model-apply.ts` replays a plan onto it for RT-12; the AC-11 expected plan is hand-written (S-014, #321). | developer |
|
|
197
|
+
| 1.8 | 2026-10-24 | Fixtures and Mocking: the `migrate projects` harness (fake GitHub model, test-side write oracle, fake `gh` on a purpose-built `PATH`, `DEV_TASKS_NOW`, seeded PRNG) (S-013, #320). | developer |
|
|
198
|
+
| 1.7 | 2026-10-22 | DF-5 Done observed after PR #312 merged; wave 2 DF-15 and DF-16 observed from the merged prompt (Phase 6). | planner |
|
|
199
|
+
| 1.6 | 2026-10-22 | DF-5 (PRD AC-3 a) and wave 2 DF-11 observed on consolidated PR #312: GitHub moved all eight linked issues to In progress (#285). | planner |
|
|
200
|
+
| 1.5 | 2026-10-22 | Known limitations section: regex parity tests prove presence, not meaning (wave 2 decision). PRD AC-1 row observed; wave 2 dogfood rows DF-6 to DF-16 added (hand-applied, Design Mode A-25). | planner |
|
|
201
|
+
| 1.4 | 2026-10-22 | Changelog rows 1.2 and 1.3 moved out of the Test Layers table into this section (A-38); no content change. | developer |
|
|
202
|
+
| 1.3 | 2026-10-21 | DF-1 rows observed on the wave 2 publish (#289, #290, #291 to #296); DF-1b reuse path still pending. | product-engineer |
|
|
203
|
+
| 1.2 | 2026-10-21 | DF-5 row observed: Project Status reached Done for #270 to #275 through GitHub's own automation when PR #282 merged (D-50); the row's Criterion cell, overwritten on 2026-10-21, restored. | planner |
|
|
204
|
+
| 1.1 | 2026-10-21 | Dogfood checks table added for the projects-tracking wave 1 behavioural criteria (D-39, D-42): PRD AC-1 pending wave 2's publish, PRD AC-3 rows per story, FR-24 and D-36 paths, DF-4. | @llipe / developer |
|
|
205
|
+
| 1.0 | 2026-08-18 | Initial testing standard. | qa-engineer |
|
package/dist/bin/dev-tasks.d.ts
CHANGED