@llipe.com/dev-tasks 0.16.2 → 0.16.4

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.
@@ -47,7 +47,7 @@ Use this table to translate each convention in this file into a `gh` invocation.
47
47
  | Update PR | `gh pr edit <number> --title "<title>" --body "<body>"` | `update_pull_request` |
48
48
  | Comment on PR | `gh pr comment <number> --body "<comment>"` | `add_issue_comment` (PRs share issue comments) |
49
49
  | Review a PR | `gh pr review <number> --approve\|--request-changes\|--comment --body "<comment>"` | `create_pull_request_review` |
50
- | Merge PR (integration branch only, planner-authorized) | `gh pr merge <number> --squash --delete-branch` | `merge_pull_request` |
50
+ | Merge PR (integration branch only, planner-authorized) | `gh pr merge <number> --merge --delete-branch` | `merge_pull_request` |
51
51
  | List/audit PRs | `gh pr list --state all --json number,title,body,baseRefName,headRefName,labels --limit 500` | `list_pull_requests` |
52
52
  | Create/list labels | `gh label create "<name>" --color "<hex>" --description "<desc>"` / `gh label list` | `create_label` / `list_labels` |
53
53
  | Create/list milestones | `gh api repos/<owner>/<repo>/milestones -f title="<title>" -f description="<desc>" -f due_on="<ISO date>"` / `gh api repos/<owner>/<repo>/milestones` | (no dedicated MCP tool; use REST) |
@@ -257,7 +257,7 @@ Rules:
257
257
 
258
258
  ## Branch-Type Merge Rules
259
259
 
260
- - Issue and story PRs **MUST** merge by squash with source-branch deletion. The planner merges them into an integration branch; the user merges them into `main`.
260
+ - Issue and story PRs **MUST** merge by merge commit with source-branch deletion (`--merge --delete-branch`), so the per-task commits are preserved. Squash and rebase merges are **NOT** used unless the user explicitly asks for one on a specific PR. The planner merges them into an integration branch; the user merges them into `main`.
261
261
  - Integration PRs **MUST** merge into `main` by merge commit, and only the user may merge them.
262
262
 
263
263
  ---
@@ -463,7 +463,7 @@ For each completed story PR:
463
463
  8. Verify branch is up to date with integration branch (update/rebase if required by policy). Use the `git-ops` skill for rebase and conflict resolution.
464
464
  9. Detect merge conflicts before attempting merge. If conflicts are found, invoke the `git-ops` skill to resolve them.
465
465
  10. **Review the PR** — planner **MUST** review the story PR (verify scope, files, test and quality-gate results) and approve it.
466
- 11. Merge PR into integration branch using one consistent strategy (default: `squash`).
466
+ 11. Merge PR into integration branch using one consistent strategy (default: `merge`, a merge commit with source-branch deletion; never squash or rebase unless the user explicitly asks for it).
467
467
  12. Confirm integration branch is green after merge before moving to next story.
468
468
  13. **Verify the merge actually happened, then write checkpoint.** Before writing `✅ Merged` to the state file, confirm observed GitHub state — run `gh pr view <n> --json state,mergedAt` and require `state` to be `MERGED` and `mergedAt` to be non-null. If the check fails or errors, do **not** write `✅ Merged`; mark the story blocked, report the exact `gh pr view` output, and stop rather than guessing at the outcome. Only once this is confirmed: update the planner state file (see Phase 0.5 State File Format), mark the completed story as `✅ Merged` with its PR link and branch name, update `Current Position` to the next pending story, update the `Last updated` timestamp, and post a GitHub Issue comment on the plan/milestone issue with the current story status table.
469
469
 
@@ -10,7 +10,7 @@
10
10
  # `gh pr merge --admin` (blocked outright), `gh pr merge --auto` when the
11
11
  # resolved base is the default branch, and the raw-git escape of merging a
12
12
  # `story/*`/`issue/*` branch directly into an `integration/*` branch (the
13
- # reviewable path is `gh pr merge <n> --squash --delete-branch`).
13
+ # reviewable path is `gh pr merge <n> --merge --delete-branch`).
14
14
  # 2. `git commit` messages must follow Conventional Commits.
15
15
  # 3. `gh issue|pr create|edit|comment|review` must not pass a multi-line body
16
16
  # inline via `--body`; `--body-file` (or stdin `--body-file -`) is required.
@@ -511,7 +511,7 @@ if printf '%s' "$norm" | grep -Eq "${_cmd_prefix}git +merge([[:space:]]|$)|[;&|]
511
511
  integration/*)
512
512
  case "$merge_arg" in
513
513
  story/*|issue/*)
514
- block "raw 'git merge' of a story/issue branch into an integration branch is not allowed — it bypasses PR review. Use 'gh pr merge <n> --squash --delete-branch' instead."
514
+ block "raw 'git merge' of a story/issue branch into an integration branch is not allowed — it bypasses PR review. Use 'gh pr merge <n> --merge --delete-branch' instead."
515
515
  ;;
516
516
  esac
517
517
  ;;
@@ -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 | Command |
100
- | ---------------- | ----------------------------------------------------------------------------------- | ------------------------------------------- |
101
- | **Squash merge** | Issue/story PRs → integration (planner) or `main` (user); delete the source branch. | `gh pr merge <pr> --squash --delete-branch` |
102
- | **Merge commit** | Integration PRs → `main` (user); preserve the story history. | `gh pr merge <pr> --merge` |
103
- | **Rebase merge** | Not part of the issue/story/integration policy; use only when explicitly approved. | `gh pr merge <pr> --rebase` |
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**: Issue/story PRs use squash with branch deletion; integration PRs use a merge commit. Planner handles integration targets, and the user handles `main`.
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
 
@@ -45,7 +45,7 @@ Use this table to translate each convention in this file into a `gh` invocation
45
45
  | Update PR | `gh pr edit <number> --title "<title>" --body "<body>"` | `update_pull_request` |
46
46
  | Comment on PR | `gh pr comment <number> --body "<comment>"` | `add_issue_comment` (PRs share issue comments) |
47
47
  | Review a PR | `gh pr review <number> --approve\|--request-changes\|--comment --body "<comment>"` | `create_pull_request_review` |
48
- | Merge PR (integration branch only, planner-authorized) | `gh pr merge <number> --squash --delete-branch` | `merge_pull_request` |
48
+ | Merge PR (integration branch only, planner-authorized) | `gh pr merge <number> --merge --delete-branch` | `merge_pull_request` |
49
49
  | List/audit PRs | `gh pr list --state all --json number,title,body,baseRefName,headRefName,labels --limit 500` | `list_pull_requests` |
50
50
  | Create/list labels | `gh label create "<name>" --color "<hex>" --description "<desc>"` / `gh label list` | `create_label` / `list_labels` |
51
51
  | Create/list milestones | `gh api repos/<owner>/<repo>/milestones -f title="<title>" -f description="<desc>" -f due_on="<ISO date>"` / `gh api repos/<owner>/<repo>/milestones` | (no dedicated MCP tool; use REST) |
@@ -263,7 +263,7 @@ Rules:
263
263
 
264
264
  ## Branch-Type Merge Rules
265
265
 
266
- - Issue and story PRs **MUST** merge by squash with source-branch deletion. The planner merges them into an integration branch; the user merges them into `main`.
266
+ - Issue and story PRs **MUST** merge by merge commit with source-branch deletion (`--merge --delete-branch`), so the per-task commits are preserved. Squash and rebase merges are **NOT** used unless the user explicitly asks for one on a specific PR. The planner merges them into an integration branch; the user merges them into `main`.
267
267
  - Integration PRs **MUST** merge into `main` by merge commit, and only the user may merge them.
268
268
 
269
269
  ---
@@ -454,7 +454,7 @@ For each completed story PR:
454
454
  8. Verify branch is up to date with integration branch (update/rebase if required by policy). Use the `git-ops` skill for rebase and conflict resolution.
455
455
  9. Detect merge conflicts before attempting merge. If conflicts are found, invoke the `git-ops` skill to resolve them.
456
456
  10. **Review the PR** — planner **MUST** review the story PR (verify scope, files, test and quality-gate results) and approve it.
457
- 11. Merge PR into integration branch using one consistent strategy (default: `squash`).
457
+ 11. Merge PR into integration branch using one consistent strategy (default: `merge`, a merge commit with source-branch deletion; never squash or rebase unless the user explicitly asks for it).
458
458
  12. Confirm integration branch is green after merge before moving to next story.
459
459
  13. **Write checkpoint** — update the planner state file (see Phase 0.5 State File Format), mark the completed story as `✅ Merged` with its PR link and branch name, update `Current Position` to the next pending story, update the `Last updated` timestamp, and post a GitHub Issue comment on the plan/milestone issue with the current story status table.
460
460
 
@@ -91,13 +91,13 @@ Before merging any PR or branch, verify:
91
91
 
92
92
  Choose the appropriate strategy based on context:
93
93
 
94
- | Strategy | When to Use | Command |
95
- | ---------------- | ----------------------------------------------------------------------------------- | ------------------------------------------- |
96
- | **Squash merge** | Issue/story PRs → integration (planner) or `main` (user); delete the source branch. | `gh pr merge <pr> --squash --delete-branch` |
97
- | **Merge commit** | Integration PRs → `main` (user); preserve the story history. | `gh pr merge <pr> --merge` |
98
- | **Rebase merge** | Not part of the issue/story/integration policy; use only when explicitly approved. | `gh pr merge <pr> --rebase` |
94
+ | Strategy | When to Use | Command |
95
+ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- |
96
+ | **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` |
97
+ | **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` |
98
+ | **Rebase merge** | Not part of the policy; use only when the user explicitly approves it on a specific PR. | `gh pr merge <pr> --rebase` |
99
99
 
100
- **Default**: Issue/story PRs use squash with branch deletion; integration PRs use a merge commit. Planner handles integration targets, and the user handles `main`.
100
+ **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.
101
101
 
102
102
  ### 6. Resolve Merge Conflicts
103
103
 
@@ -45,7 +45,7 @@ Use this table to translate each convention in this file into a `gh` invocation
45
45
  | Update PR | `gh pr edit <number> --title "<title>" --body "<body>"` | `update_pull_request` |
46
46
  | Comment on PR | `gh pr comment <number> --body "<comment>"` | `add_issue_comment` (PRs share issue comments) |
47
47
  | Review a PR | `gh pr review <number> --approve\|--request-changes\|--comment --body "<comment>"` | `create_pull_request_review` |
48
- | Merge PR (integration branch only, planner-authorized) | `gh pr merge <number> --squash --delete-branch` | `merge_pull_request` |
48
+ | Merge PR (integration branch only, planner-authorized) | `gh pr merge <number> --merge --delete-branch` | `merge_pull_request` |
49
49
  | List/audit PRs | `gh pr list --state all --json number,title,body,baseRefName,headRefName,labels --limit 500` | `list_pull_requests` |
50
50
  | Create/list labels | `gh label create "<name>" --color "<hex>" --description "<desc>"` / `gh label list` | `create_label` / `list_labels` |
51
51
  | Create/list milestones | `gh api repos/<owner>/<repo>/milestones -f title="<title>" -f description="<desc>" -f due_on="<ISO date>"` / `gh api repos/<owner>/<repo>/milestones` | (no dedicated MCP tool; use REST) |
@@ -277,7 +277,7 @@ Rules:
277
277
 
278
278
  ## Branch-Type Merge Rules
279
279
 
280
- - Issue and story PRs **MUST** merge by squash with source-branch deletion. The planner merges them into an integration branch; the user merges them into `main`.
280
+ - Issue and story PRs **MUST** merge by merge commit with source-branch deletion (`--merge --delete-branch`), so the per-task commits are preserved. Squash and rebase merges are **NOT** used unless the user explicitly asks for one on a specific PR. The planner merges them into an integration branch; the user merges them into `main`.
281
281
  - Integration PRs **MUST** merge into `main` by merge commit, and only the user may merge them.
282
282
 
283
283
  ---
@@ -491,7 +491,7 @@ For each completed story PR:
491
491
  8. Verify branch is up to date with integration branch (update/rebase if required by policy). Use the `git-ops` skill for rebase and conflict resolution.
492
492
  9. Detect merge conflicts before attempting merge. If conflicts are found, invoke the `git-ops` skill to resolve them.
493
493
  10. **Review the PR** — planner **MUST** review the story PR (verify scope, files, test and quality-gate results) and approve it.
494
- 11. Merge PR into integration branch using one consistent strategy (default: `squash`).
494
+ 11. Merge PR into integration branch using one consistent strategy (default: `merge`, a merge commit with source-branch deletion; never squash or rebase unless the user explicitly asks for it).
495
495
  12. Confirm integration branch is green after merge before moving to next story.
496
496
  13. **Verify the merge actually happened, then write checkpoint.** Before writing `✅ Merged` to the state file, confirm observed GitHub state — run `gh pr view <n> --json state,mergedAt` and require `state` to be `MERGED` and `mergedAt` to be non-null. If the check fails or errors, do **not** write `✅ Merged`; mark the story blocked, report the exact `gh pr view` output, and stop rather than guessing at the outcome. Only once this is confirmed: update the planner state file (see Phase 0.5 State File Format), mark the completed story as `✅ Merged` with its PR link and branch name, update `Current Position` to the next pending story, update the `Last updated` timestamp, and post a GitHub Issue comment on the plan/milestone issue with the current story status table.
497
497
 
@@ -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 | Command |
100
- | ---------------- | ----------------------------------------------------------------------------------- | ------------------------------------------- |
101
- | **Squash merge** | Issue/story PRs → integration (planner) or `main` (user); delete the source branch. | `gh pr merge <pr> --squash --delete-branch` |
102
- | **Merge commit** | Integration PRs → `main` (user); preserve the story history. | `gh pr merge <pr> --merge` |
103
- | **Rebase merge** | Not part of the issue/story/integration policy; use only when explicitly approved. | `gh pr merge <pr> --rebase` |
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**: Issue/story PRs use squash with branch deletion; integration PRs use a merge commit. Planner handles integration targets, and the user handles `main`.
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
 
package/CHANGELOG.md CHANGED
@@ -5,6 +5,24 @@ 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
+ ## [0.16.4] - 2026-10-06
9
+
10
+ ### Changed
11
+
12
+ - chore: validation update pre release
13
+ - chore(lock): reformat pnpm-lock.yaml with prettier
14
+
15
+ ## [0.16.3] - 2026-10-06
16
+
17
+ ### Added
18
+
19
+ - feat: quality-gate hardening — PR validate CI, coverage baseline, format scope, decision-log row validation (#245, #246, #247, #248) (#265)
20
+
21
+ ### Changed
22
+
23
+ - chore: prettier update
24
+ - refactor(merge-policy): default issue/story PR merges to merge commit (#267)
25
+
8
26
  ## [0.16.2] - 2026-10-02
9
27
 
10
28
  ### Fixed
@@ -14,15 +32,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
14
32
 
15
33
  ## [Unreleased]
16
34
 
35
+ ### Changed
36
+
37
+ - 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)
38
+
17
39
  ### Added
18
40
 
19
41
  - 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
42
  - feat(memo): `product-engineer` writes confirmed grilling decisions to `kb`; `planner` verifies per-story memo fields and writes one run-outcome entry (#253)
43
+ - feat(ci): `validate.yml` runs `pnpm run validate` on every pull request, with runbook `docs/runbooks/runbook-diagnose-pr-validate.md` (#248)
44
+ - 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
45
 
22
46
  ### Fixed
23
47
 
24
48
  - 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
49
  - 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)
50
+ - 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)
51
+ - fix(deps): `brace-expansion` pnpm overrides bounded to their own major (patched floors unchanged) (#247)
52
+
53
+ ### Changed
54
+
55
+ - chore(format): `format` and `format:check` cover `.claude/`, `.github/`, and `.kiro/` (#246)
26
56
 
27
57
  ## [0.16.1] - 2026-09-23
28
58
 
package/TESTING.md CHANGED
@@ -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 provider declared in `vitest.config.ts`, but no usable coverage command/provider package is installed |
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 workflow `publish-npm.yml` uses Node `24`.
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 runs at 64 files / 2138 tests with zero failures on both runtimes.
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; the CLI and toolkit operate across both versions without defect.
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 static analysis **and** `tsx core/checks/run.ts` (docs-structure gate) | 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 | missing; no usable provider configured |
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:** `publish-npm.yml` invokes `pnpm run validate`, which reaches the aggregate test command, but only on its tag-triggered publish workflow. No general CI test workflow/job was detected.
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 is declared in `vitest.config.ts`, but `test:coverage` is absent and the coverage provider is not available as a project dependency.
99
- - Threshold policy: no numeric threshold has been established.
100
- - Baseline: none recorded.
101
- - Regression policy: coverage must not be reported as measured until a provider and command are configured; structural gap analysis is mandatory meanwhile.
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
 
@@ -116,12 +133,13 @@ This package has no authentication or authorization implementation path in the a
116
133
 
117
134
  ### Environment-fragility patterns
118
135
 
119
- The test suite runs to completion with zero failures. However, some patterns in test design carry environment-fragility risk if new tests adopt them. Avoid these patterns:
136
+ 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
137
 
121
138
  - **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
139
  - **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
140
 
124
141
  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. `package.json` and `vitest.config.ts`: V8 coverage is declared but no usable `test:coverage` command/provider is configured. Expected state: add the approved provider and canonical command in a separate approved change, then record thresholds and baseline; until then coverage is skipped.
126
- 3. CI/deploy wiring: no general CI test job and no deploy workflow invoke the aggregate test command. Expected state: every CI test job and deploy quality gate must run `pnpm run test` or `pnpm run validate`.
127
- 4. Runtime alignment: `publish-npm.yml` uses Node 24 while local development uses Node 26. Both runtimes pass the full test suite with zero failures, 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.
142
+ 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.
143
+ 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.
144
+ 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.
145
+ 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.
@@ -1,14 +1,14 @@
1
1
  /** A single format finding. */
2
2
  export interface DecisionLogFinding {
3
3
  /** Stable rule identifier, for grouping output. */
4
- rule: "duplicate-id" | "invalid-phase" | "dangling-supersedes";
4
+ rule: "duplicate-id" | "invalid-phase" | "cell-count-mismatch" | "dangling-supersedes";
5
5
  /** Repo-relative path of the file the finding is about. */
6
6
  path: string;
7
7
  /** One line, naming the row and the condition. */
8
8
  message: string;
9
9
  }
10
10
  export interface DecisionLogResult {
11
- /** Findings that fail the gate: duplicate ID, invalid Phase. */
11
+ /** Findings that fail the gate: duplicate ID, invalid Phase, cell-count mismatch. */
12
12
  failures: DecisionLogFinding[];
13
13
  /** Findings that are reported and do not fail the gate: dangling Supersedes. */
14
14
  staleness: DecisionLogFinding[];
@@ -18,14 +18,35 @@ interface Row {
18
18
  phase: string;
19
19
  supersedes: string;
20
20
  }
21
+ /** A body row whose cell count differs from its table header's. */
22
+ interface MalformedRow {
23
+ /** 1-based line number in the file. */
24
+ line: number;
25
+ /** The row's first cell, as split — usually the (possibly mangled) ID. */
26
+ firstCell: string;
27
+ /** Cells the row split into. */
28
+ cells: number;
29
+ /** Cells the header split into. */
30
+ expected: number;
31
+ }
32
+ export interface ParsedDecisionRows {
33
+ /** Rows whose cell count matched their header, read positionally. */
34
+ rows: Row[];
35
+ /** Rows skipped because their cell count did not match (#245). */
36
+ malformed: MalformedRow[];
37
+ }
21
38
  /**
22
39
  * Parse every decision row out of one file's content. A file may hold
23
40
  * several tables (WHAT phase, HOW phase, one per specification phase);
24
41
  * each is read independently by its own header, and all rows are
25
42
  * pooled — `ID` uniqueness and `Supersedes` resolution are file-wide,
26
43
  * not per-table (the format has one ID space for the whole file).
44
+ *
45
+ * A body row is read positionally only after its cell count is checked
46
+ * against the header's; a mismatched row is returned in `malformed`
47
+ * and never in `rows` (#245).
27
48
  */
28
- export declare function parseDecisionRows(content: string): Row[];
49
+ export declare function parseDecisionRows(content: string): ParsedDecisionRows;
29
50
  /**
30
51
  * Check one decision log's already-read content. `path` is the
31
52
  * repo-relative path used only in finding messages.
@@ -1 +1 @@
1
- {"version":3,"file":"decision-log-format.d.ts","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"AAyBA,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,qBAAqB,CAAC;IAC/D,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,gFAAgF;IAChF,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAUD,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,EAAE,CAoDxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA2CxF;AAYD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAY1E"}
1
+ {"version":3,"file":"decision-log-format.d.ts","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"AAsCA,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;IACvF,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,gFAAgF;IAChF,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAUD,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mEAAmE;AACnE,UAAU,YAAY;IACpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,kEAAkE;IAClE,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAqErE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAqDxF;AAYD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAY1E"}
@@ -8,7 +8,20 @@
8
8
  * file (the column is intra-file only — a value that happens to match
9
9
  * another feature's `D-NN` is still dangling here).
10
10
  *
11
- * Uniqueness and `Phase` are hard failures. A dangling `Supersedes` is
11
+ * Every body row must also have exactly as many cells as its table's
12
+ * header (#245). `splitRow` splits on every `|`, and a Markdown-escaped
13
+ * pipe (`\|`) inside a cell is still a `|` to it: the row grows a cell
14
+ * and every later column slides one position right. Read positionally,
15
+ * that row yields garbage — a regex fragment in `Supersedes`, or, for a
16
+ * shift landing after `Supersedes`, a silently corrupted `Author` and
17
+ * `Date` with no finding at all. So a row whose cell count differs from
18
+ * the header's is reported as `cell-count-mismatch` and skipped, never
19
+ * read. Teaching `splitRow` the escape is deliberately not done here;
20
+ * the point is that corruption is loud, not that it is repaired.
21
+ *
22
+ * Uniqueness, `Phase`, and cell count are hard failures — a shifted row
23
+ * makes every column read from it untrustworthy, which is a defect in
24
+ * the file, not work in progress. A dangling `Supersedes` is
12
25
  * reported the same way docs-structure reports staleness (D-21's
13
26
  * precedent): printed, not failed, so a decision log mid-session — a
14
27
  * row citing a `Supersedes` ID not yet appended — never blocks
@@ -49,13 +62,19 @@ function splitRow(line) {
49
62
  * each is read independently by its own header, and all rows are
50
63
  * pooled — `ID` uniqueness and `Supersedes` resolution are file-wide,
51
64
  * not per-table (the format has one ID space for the whole file).
65
+ *
66
+ * A body row is read positionally only after its cell count is checked
67
+ * against the header's; a mismatched row is returned in `malformed`
68
+ * and never in `rows` (#245).
52
69
  */
53
70
  export function parseDecisionRows(content) {
54
71
  const lines = content.split("\n");
55
72
  const rows = [];
73
+ const malformed = [];
56
74
  let idCol = -1;
57
75
  let phaseCol = -1;
58
76
  let supersedesCol = -1;
77
+ let headerCount = 0;
59
78
  let inTable = false;
60
79
  for (let i = 0; i < lines.length; i++) {
61
80
  const line = lines[i];
@@ -76,6 +95,7 @@ export function parseDecisionRows(content) {
76
95
  supersedesCol = headerCells.indexOf("supersedes");
77
96
  if (idCol === -1)
78
97
  continue; // not a decision table
98
+ headerCount = headerCells.length;
79
99
  inTable = true;
80
100
  i++; // consume the separator row too
81
101
  continue;
@@ -83,6 +103,18 @@ export function parseDecisionRows(content) {
83
103
  if (isSeparatorRow(trimmed))
84
104
  continue;
85
105
  const cells = splitRow(trimmed);
106
+ // Before any positional read: a row that split into a different
107
+ // number of cells than its header has shifted columns, and every
108
+ // value read from it by index would be wrong.
109
+ if (cells.length !== headerCount) {
110
+ malformed.push({
111
+ line: i + 1,
112
+ firstCell: cells[0] ?? "",
113
+ cells: cells.length,
114
+ expected: headerCount,
115
+ });
116
+ continue;
117
+ }
86
118
  const id = cells[idCol];
87
119
  if (id === undefined || id.length === 0) {
88
120
  inTable = false;
@@ -94,16 +126,24 @@ export function parseDecisionRows(content) {
94
126
  supersedes: supersedesCol === -1 ? "" : (cells[supersedesCol] ?? ""),
95
127
  });
96
128
  }
97
- return rows;
129
+ return { rows, malformed };
98
130
  }
99
131
  /**
100
132
  * Check one decision log's already-read content. `path` is the
101
133
  * repo-relative path used only in finding messages.
102
134
  */
103
135
  export function checkDecisionLogContent(content, path) {
104
- const rows = parseDecisionRows(content);
136
+ const { rows, malformed } = parseDecisionRows(content);
105
137
  const failures = [];
106
138
  const staleness = [];
139
+ for (const bad of malformed) {
140
+ failures.push({
141
+ rule: "cell-count-mismatch",
142
+ path,
143
+ message: `${path}:${bad.line}: row '${bad.firstCell}' has ${bad.cells} cells, header has ${bad.expected}. ` +
144
+ "A '|' inside a cell — escaped as '\\|' or not — splits it; reword the cell without a pipe.",
145
+ });
146
+ }
107
147
  const seen = new Set();
108
148
  const ids = new Set(rows.map((r) => r.id));
109
149
  for (const row of rows) {
@@ -1 +1 @@
1
- {"version":3,"file":"decision-log-format.js","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"decision-log-format.js","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@llipe.com/dev-tasks",
3
- "version": "0.16.2",
3
+ "version": "0.16.4",
4
4
  "description": "AI agent toolkit for structured, PRD-driven development workflows",
5
5
  "type": "module",
6
6
  "imports": {
@@ -48,11 +48,12 @@
48
48
  "typecheck": "tsc --noEmit",
49
49
  "lint": "eslint . --max-warnings 0 && tsx core/checks/run.ts",
50
50
  "lint:fix": "eslint . --fix",
51
- "format": "prettier --write \"bin/\" \"core/\" \"test/\" \"*.json\" \"*.ts\" \"eslint.config.js\" --ignore-unknown",
52
- "format:check": "prettier --check \"bin/\" \"core/\" \"test/\" \"*.json\" \"*.ts\" \"eslint.config.js\" --ignore-unknown",
51
+ "format": "prettier --write \"bin/\" \"core/\" \"test/\" \".claude/\" \".github/\" \".kiro/\" \"*.json\" \"*.ts\" \"eslint.config.js\" --ignore-unknown",
52
+ "format:check": "prettier --check \"bin/\" \"core/\" \"test/\" \".claude/\" \".github/\" \".kiro/\" \"*.json\" \"*.ts\" \"eslint.config.js\" --ignore-unknown",
53
53
  "test": "vitest run",
54
54
  "test:unit": "vitest run test/unit",
55
55
  "test:integration": "vitest run test/integration",
56
+ "test:coverage": "vitest run --coverage",
56
57
  "audit": "pnpm audit --prod",
57
58
  "validate": "pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test"
58
59
  },
@@ -74,6 +75,7 @@
74
75
  "@types/node": "24.13.3",
75
76
  "@typescript-eslint/eslint-plugin": "8.32.1",
76
77
  "@typescript-eslint/parser": "8.32.1",
78
+ "@vitest/coverage-v8": "3.2.6",
77
79
  "eslint": "9.27.0",
78
80
  "eslint-config-prettier": "10.1.5",
79
81
  "globals": "16.1.0",
@@ -92,9 +94,9 @@
92
94
  },
93
95
  "pnpm": {
94
96
  "overrides": {
95
- "brace-expansion@>=2.0.0 <2.1.4": ">=2.1.4",
96
- "brace-expansion@>=4.0.0 <5.0.9": ">=5.0.9",
97
- "brace-expansion@<1.1.18": ">=1.1.18"
97
+ "brace-expansion@>=2.0.0 <2.1.4": "^2.1.4",
98
+ "brace-expansion@>=4.0.0 <5.0.9": "^5.0.9",
99
+ "brace-expansion@<1.1.18": "^1.1.18"
98
100
  }
99
101
  }
100
102
  }