@llipe.com/dev-tasks 0.7.4 → 0.9.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.
Files changed (101) hide show
  1. package/.claude/agents/developer.md +20 -10
  2. package/.claude/agents/qa-engineer.md +104 -0
  3. package/.claude/agents/verifier.md +1 -1
  4. package/.claude/commands/developer.md +14 -10
  5. package/.claude/commands/planner.md +10 -8
  6. package/.claude/commands/qa-engineer.md +23 -0
  7. package/.claude/skills/activity-coverage-gap-analysis/SKILL.md +107 -0
  8. package/.claude/skills/activity-test-implementation/SKILL.md +109 -0
  9. package/.claude/skills/activity-test-standards/SKILL.md +122 -0
  10. package/.claude/skills/implement/SKILL.md +19 -13
  11. package/.github/agents/developer.agent.md +20 -10
  12. package/.github/agents/planner.agent.md +10 -8
  13. package/.github/agents/qa-engineer.agent.md +104 -0
  14. package/.github/agents/verifier.agent.md +1 -1
  15. package/.github/instructions/implement.instructions.md +19 -13
  16. package/.github/prompts/qa-engineer.prompt.md +23 -0
  17. package/.github/skills/activity-coverage-gap-analysis/SKILL.md +107 -0
  18. package/.github/skills/activity-test-implementation/SKILL.md +109 -0
  19. package/.github/skills/activity-test-standards/SKILL.md +122 -0
  20. package/.kiro/agents/developer.md +27 -11
  21. package/.kiro/agents/github-ops.md +2 -0
  22. package/.kiro/agents/housekeeping.md +3 -0
  23. package/.kiro/agents/planner.md +17 -9
  24. package/.kiro/agents/product-engineer.md +9 -1
  25. package/.kiro/agents/qa-engineer.md +108 -0
  26. package/.kiro/agents/technical-writer.md +4 -0
  27. package/.kiro/agents/ux-engineer.md +4 -0
  28. package/.kiro/agents/verifier.md +5 -1
  29. package/.kiro/hooks/git-guard.json +12 -1
  30. package/.kiro/hooks/scripts/branch-guard.sh +36 -0
  31. package/.kiro/skills/activity-coverage-gap-analysis/SKILL.md +107 -0
  32. package/.kiro/skills/activity-test-implementation/SKILL.md +109 -0
  33. package/.kiro/skills/activity-test-standards/SKILL.md +122 -0
  34. package/.kiro/steering/implement.md +23 -13
  35. package/AGENTS.md +102 -23
  36. package/CHANGELOG.md +70 -0
  37. package/CLAUDE.md +6 -3
  38. package/README.md +108 -112
  39. package/bundle-manifest.json +1 -0
  40. package/dist/core/distribution/install.d.ts.map +1 -1
  41. package/dist/core/distribution/install.js +25 -2
  42. package/dist/core/distribution/install.js.map +1 -1
  43. package/dist/core/distribution/profiles.d.ts +21 -0
  44. package/dist/core/distribution/profiles.d.ts.map +1 -1
  45. package/dist/core/distribution/profiles.js +21 -0
  46. package/dist/core/distribution/profiles.js.map +1 -1
  47. package/dist/core/extract/asyncapi/declared.d.ts +19 -0
  48. package/dist/core/extract/asyncapi/declared.d.ts.map +1 -0
  49. package/dist/core/extract/asyncapi/declared.js +168 -0
  50. package/dist/core/extract/asyncapi/declared.js.map +1 -0
  51. package/dist/core/extract/asyncapi/index.d.ts +1 -0
  52. package/dist/core/extract/asyncapi/index.d.ts.map +1 -1
  53. package/dist/core/extract/asyncapi/index.js +1 -0
  54. package/dist/core/extract/asyncapi/index.js.map +1 -1
  55. package/dist/core/extract/asyncapi/types.d.ts +1 -1
  56. package/dist/core/extract/asyncapi/types.d.ts.map +1 -1
  57. package/dist/core/extract/ladder.d.ts +79 -0
  58. package/dist/core/extract/ladder.d.ts.map +1 -0
  59. package/dist/core/extract/ladder.js +70 -0
  60. package/dist/core/extract/ladder.js.map +1 -0
  61. package/dist/core/extract/openapi/index.d.ts +35 -5
  62. package/dist/core/extract/openapi/index.d.ts.map +1 -1
  63. package/dist/core/extract/openapi/index.js +136 -3
  64. package/dist/core/extract/openapi/index.js.map +1 -1
  65. package/dist/core/extract/openapi/route2-introspect.d.ts +18 -0
  66. package/dist/core/extract/openapi/route2-introspect.d.ts.map +1 -0
  67. package/dist/core/extract/openapi/route2-introspect.js +249 -0
  68. package/dist/core/extract/openapi/route2-introspect.js.map +1 -0
  69. package/dist/core/extract/openapi/route2.d.ts +40 -17
  70. package/dist/core/extract/openapi/route2.d.ts.map +1 -1
  71. package/dist/core/extract/openapi/route2.js +202 -10
  72. package/dist/core/extract/openapi/route2.js.map +1 -1
  73. package/dist/core/extract/openapi/types.d.ts +3 -3
  74. package/dist/core/extract/openapi/types.d.ts.map +1 -1
  75. package/dist/core/extract/provider.d.ts +4 -0
  76. package/dist/core/extract/provider.d.ts.map +1 -1
  77. package/dist/core/extract/report.d.ts +29 -1
  78. package/dist/core/extract/report.d.ts.map +1 -1
  79. package/dist/core/extract/report.js +7 -2
  80. package/dist/core/extract/report.js.map +1 -1
  81. package/dist/core/extract/schema.d.ts +16 -18
  82. package/dist/core/extract/schema.d.ts.map +1 -1
  83. package/dist/core/extract/schema.js +48 -43
  84. package/dist/core/extract/schema.js.map +1 -1
  85. package/dist/core/extract/workspaces.d.ts +33 -0
  86. package/dist/core/extract/workspaces.d.ts.map +1 -0
  87. package/dist/core/extract/workspaces.js +193 -0
  88. package/dist/core/extract/workspaces.js.map +1 -0
  89. package/package.json +10 -2
  90. package/dist/core/extract/openapi/llm-descriptions.d.ts +0 -41
  91. package/dist/core/extract/openapi/llm-descriptions.d.ts.map +0 -1
  92. package/dist/core/extract/openapi/llm-descriptions.js +0 -36
  93. package/dist/core/extract/openapi/llm-descriptions.js.map +0 -1
  94. package/dist/core/extract/orm/llm-descriptions.d.ts +0 -28
  95. package/dist/core/extract/orm/llm-descriptions.d.ts.map +0 -1
  96. package/dist/core/extract/orm/llm-descriptions.js +0 -64
  97. package/dist/core/extract/orm/llm-descriptions.js.map +0 -1
  98. package/dist/core/extract/orm/migration-inference.d.ts +0 -25
  99. package/dist/core/extract/orm/migration-inference.d.ts.map +0 -1
  100. package/dist/core/extract/orm/migration-inference.js +0 -76
  101. package/dist/core/extract/orm/migration-inference.js.map +0 -1
package/AGENTS.md CHANGED
@@ -27,6 +27,19 @@ If `/DESIGN.md` is missing and the requested scope includes UI work, agents **MU
27
27
 
28
28
  ---
29
29
 
30
+ ## Testing Standard Contract (TESTING.md)
31
+
32
+ `/TESTING.md` is the canonical testing contract for a repository. It declares the layer taxonomy and what belongs at each layer, the per-package runner and commands, coverage thresholds and baseline policy, the fixture and mocking strategy, and the mandatory security-negative cases.
33
+
34
+ - `qa-engineer` **OWNS** `/TESTING.md` and fills it per project via `activity-test-standards`.
35
+ - `developer` **MUST** keep it current when the testing contract changes.
36
+ - Agents that read it **MUST** treat an unfilled placeholder as "no standard established", never as permission.
37
+ - The contract is **per-package**: a repository mixing languages (for example vitest and pytest) **MUST** be describable without forcing every package into one language's script names.
38
+
39
+ It ships with dev-tasks as a placeholder and is listed in `consumer_owned_paths`, so `dev-tasks update` never overwrites a filled version.
40
+
41
+ ---
42
+
30
43
  ## Taxonomy: Agent vs Skill vs Instruction
31
44
 
32
45
  | Concept | Purpose | Loaded When |
@@ -48,26 +61,32 @@ If `/DESIGN.md` is missing and the requested scope includes UI work, agents **MU
48
61
  | **housekeeping** | `housekeeping.agent.md` | Lint, type, and test-wiring fixes |
49
62
  | **github-ops** | `github-ops.agent.md` | GitHub consistency — standardizes issues, PRs, branches, labels, milestones, comments, and enforces merge authority policy |
50
63
  | **ux-engineer** | `ux-engineer.agent.md` | UX prototyping and gap analysis — turns PRD/SPEC into testable mockups and feeds refinements back to `product-engineer` |
64
+ | **qa-engineer** | `qa-engineer.agent.md` | Quality agent — establishes the `/TESTING.md` standard, authors tests for layers the project lacks, and reports coverage and structural gaps. Invoked by `developer` at the completion gate, before the `verifier` audit |
51
65
  | **verifier** | `verifier.agent.md` | Verification agent — owns compliance test-plan design (`design` mode) and post-implementation grey-box fidelity auditing (`audit` mode) against codebase, `/workstream`, tests, and PRD/spec intent |
52
66
 
67
+ `.github/agents/` and `.kiro/agents/` carry all nine agents. `.claude/agents/` carries seven by design: `planner` and `product-engineer` are orchestrators that must pause for user-approval gates, so on Claude Code they run in the main thread as `.claude/commands/` entry points rather than as subagents. See `CLAUDE.md`.
68
+
53
69
  ## Skills
54
70
 
55
71
  Skills are on-demand capabilities invoked by agents — **not** loaded unless explicitly referenced.
56
72
 
57
73
  ### Activity Skills
58
74
 
59
- | Skill | Directory | Purpose | Primary Consumer |
60
- | --------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
61
- | **activity-init** | `skills/activity-init/` | Establish product context and technical guidelines (mono/multi-repo/greenfield mode detection) | `product-engineer` |
62
- | **activity-refine** | `skills/activity-refine/` | Clarify scope — issue refinement or full PRD creation | `product-engineer` |
63
- | **activity-generate-spec** | `skills/activity-generate-spec/` | Transform PRD into technical specification | `product-engineer` |
64
- | **activity-generate-stories** | `skills/activity-generate-stories/` | Break spec into user stories with coverage validation | `product-engineer` |
65
- | **activity-publish-github** | `skills/activity-publish-github/` | Publish stories as GitHub Issues via MCP | `product-engineer` |
66
- | **activity-e2e-test-design** | `skills/activity-e2e-test-design/` | End-to-end black-box test scenario generation from spec/stories | `verifier` |
67
- | **activity-contract-test-design** | `skills/activity-contract-test-design/` | Consumer/provider contract and schema compatibility test strategy | `verifier` |
68
- | **activity-edge-case-refinement** | `skills/activity-edge-case-refinement/` | Systematic edge-case discovery by category with concrete examples | `verifier` |
69
- | **activity-random-test-tactics** | `skills/activity-random-test-tactics/` | Randomized, fuzz, and property-inspired test generation with reproducibility | `verifier` |
70
- | **activity-drift-reconciliation** | `skills/activity-drift-reconciliation/` | Routes verifier drift findings into task-list/checklist expansion, new issues, or PRD/spec changelog write-back (human-confirmed) | `product-engineer` |
75
+ | Skill | Directory | Purpose | Primary Consumer |
76
+ | ---------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
77
+ | **activity-init** | `skills/activity-init/` | Establish product context and technical guidelines (mono/multi-repo/greenfield mode detection) | `product-engineer` |
78
+ | **activity-refine** | `skills/activity-refine/` | Clarify scope — issue refinement or full PRD creation | `product-engineer` |
79
+ | **activity-generate-spec** | `skills/activity-generate-spec/` | Transform PRD into technical specification | `product-engineer` |
80
+ | **activity-generate-stories** | `skills/activity-generate-stories/` | Break spec into user stories with coverage validation | `product-engineer` |
81
+ | **activity-publish-github** | `skills/activity-publish-github/` | Publish stories as GitHub Issues via MCP | `product-engineer` |
82
+ | **activity-e2e-test-design** | `skills/activity-e2e-test-design/` | End-to-end black-box test scenario generation from spec/stories | `verifier` |
83
+ | **activity-contract-test-design** | `skills/activity-contract-test-design/` | Consumer/provider contract and schema compatibility test strategy | `verifier` |
84
+ | **activity-edge-case-refinement** | `skills/activity-edge-case-refinement/` | Systematic edge-case discovery by category with concrete examples | `verifier` |
85
+ | **activity-random-test-tactics** | `skills/activity-random-test-tactics/` | Randomized, fuzz, and property-inspired test generation with reproducibility | `verifier` |
86
+ | **activity-test-standards** | `skills/activity-test-standards/` | Establish and maintain `/TESTING.md`, detect harness defects, verify test-script and CI/deploy gate reachability | `qa-engineer` |
87
+ | **activity-test-implementation** | `skills/activity-test-implementation/` | Author Layer 1-2 tests with enforceable boundaries and a mandatory security-negative category | `qa-engineer` |
88
+ | **activity-coverage-gap-analysis** | `skills/activity-coverage-gap-analysis/` | Measure coverage against a baseline, or run risk-ranked structural gap analysis when no provider exists | `qa-engineer` |
89
+ | **activity-drift-reconciliation** | `skills/activity-drift-reconciliation/` | Routes verifier drift findings into task-list/checklist expansion, new issues, or PRD/spec changelog write-back (human-confirmed) | `product-engineer` |
71
90
 
72
91
  ### Operational Skills
73
92
 
@@ -79,20 +98,27 @@ Skills are on-demand capabilities invoked by agents — **not** loaded unless ex
79
98
 
80
99
  ### Third-Party Skills
81
100
 
82
- | Skill | Directory | Purpose | Primary Consumer |
83
- | ------------------------------- | ------------------------------------- | ------------------------------------- | -------------------------- |
84
- | **vercel-composition-patterns** | `skills/vercel-composition-patterns/` | Vercel component composition patterns | `developer`, `ux-engineer` |
85
- | **vercel-react-best-practices** | `skills/vercel-react-best-practices/` | Vercel React best practices | `developer`, `ux-engineer` |
101
+ None currently vendored. Third-party skills, when added, are installed under each platform's skills directory alongside the skills above.
86
102
 
87
103
  ## Instructions (Scoped)
88
104
 
89
- Instructions are scoped via `applyTo`/`fileMatchPattern` and auto-applied to matching files.
105
+ Instructions are scoped via `applyTo`/`fileMatchPattern` and auto-applied to matching files. Claude Code has no scoped-instruction mechanism, so `plan` and `implement` ship there as skills instead.
90
106
 
91
- | Instruction | File | Scope | Purpose |
92
- | --------------------------- | ------------------------------------------------ | -------------------------- | ------------------------------------------------------------------------ |
93
- | **plan** | `plan.instructions.md` | `workstream/**` | Convert stories or refined issues into execution-ready task lists |
94
- | **implement** | `implement.instructions.md` | `workstream/**/tasks-*.md` | Execute task list with step-gated approval, branching, and PR discipline |
95
- | **nextjs-pages-components** | `domain/nextjs-pages-components.instructions.md` | `**/app/**/*.tsx` | Next.js + React conventions |
107
+ | Instruction | Copilot / Kiro file | Claude equivalent | Scope | Purpose |
108
+ | --------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------- |
109
+ | **plan** | `.github/instructions/plan.instructions.md` / `.kiro/steering/plan.md` | `.claude/skills/plan/` | `workstream/**` | Convert stories or refined issues into execution-ready task lists |
110
+ | **implement** | `.github/instructions/implement.instructions.md` / `.kiro/steering/implement.md` | `.claude/skills/implement/` | `workstream/**/tasks-*.md` | Execute task list with step-gated approval, branching, and PR discipline |
111
+ | **nextjs-pages-components** | `.github/instructions/domain/nextjs-pages-components.instructions.md` / `.kiro/steering/nextjs-pages-components.md` | — | `**/app/**/*.tsx` | Next.js + React conventions |
112
+ | **git-guard-notice** | `.kiro/steering/git-guard-notice.md` | — | Always loaded (Kiro) | Restates the three git invariants: no push/merge to `main`, Conventional Commits, `--body-file` for `gh` bodies |
113
+
114
+ ## Hooks
115
+
116
+ | Hook | Files | Purpose |
117
+ | ---------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
118
+ | **git-guard** | `.kiro/hooks/git-guard.json`, `.kiro/hooks/scripts/git-guard.sh`, `.claude/hooks/git-guard.sh` | Blocks pushes/merges to `main`, non-Conventional commit messages, and inline `gh --body` |
119
+ | **branch-guard** | `.kiro/hooks/scripts/branch-guard.sh` | Blocks write operations while on the default branch |
120
+
121
+ Hook enforcement is best-effort. Human PR review is the actual gate for these invariants.
96
122
 
97
123
  ## Prompts
98
124
 
@@ -100,6 +126,58 @@ See individual agent files for invocation modes and entry points. Reference: Cop
100
126
 
101
127
  ---
102
128
 
129
+ ## Agent File Format (Kiro Custom Agents)
130
+
131
+ Agent files in `.kiro/agents/` use YAML frontmatter followed by a markdown body containing the system prompt. The frontmatter conforms to the [official Kiro custom agent configuration reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/).
132
+
133
+ ### Frontmatter Schema
134
+
135
+ ```yaml
136
+ ---
137
+ description: "<human-readable agent description>"
138
+ tools: [<tool-tags>] # Allowed: read, write, shell, web
139
+ resources: # Context files auto-loaded into the agent
140
+ - file://<relative-path> # Project files (e.g., file://AGENTS.md)
141
+ - skill://<glob-pattern> # Skill definitions (e.g., skill://.kiro/skills/**/SKILL.md)
142
+ permissions: # (Optional) Fine-grained access control
143
+ - allow: <action>
144
+ paths: ["<glob>"]
145
+ - deny: <action>
146
+ paths: ["<glob>"]
147
+ ---
148
+ ```
149
+
150
+ ### Field Reference
151
+
152
+ | Field | Required | Description |
153
+ | -------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
154
+ | `description` | Yes | Human-readable purpose. Used by the runtime for agent selection and routing. |
155
+ | `tools` | Yes | Tag-based tool categories: `read`, `write`, `shell`, `web`. Use `["*"]` for unrestricted. |
156
+ | `resources` | No | Context files auto-loaded via `file://` (project files) and `skill://` (skill definitions). |
157
+ | `permissions` | No | Inline permission rules for fine-grained access control (allow/deny by path glob). **Note:** Not yet supported by the Kiro runtime as of v1.0 — presence causes agents to fail to load. |
158
+ | `model` | No | Model selection override (omit to use the runtime default). |
159
+ | `mcpServers` | No | Embedded MCP server configurations for tool extensions. |
160
+ | `allowedTools` | No | Tools that execute without prompting (pre-approved). |
161
+
162
+ ### Tool Categories
163
+
164
+ | Tag | Grants Access To |
165
+ | ------- | ------------------------------------- |
166
+ | `read` | File reading, search, code navigation |
167
+ | `write` | File creation, editing, deletion |
168
+ | `shell` | Terminal command execution |
169
+ | `web` | Web browsing and HTTP requests |
170
+
171
+ > **Note:** `subagent` is not an official tool category. Subagent delegation is a runtime capability, not a tool permission.
172
+
173
+ ### References
174
+
175
+ - [Kiro Custom Agent Configuration Reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/)
176
+ - [Kiro CLI v3 Agent Config](https://kiro.dev/docs/cli/v3/agent-config/)
177
+ - [Sample Multi-Agent Repository](https://github.com/aws-samples/sample-kiro-cli-multiagent-development)
178
+
179
+ ---
180
+
103
181
  ## General Agent Guidelines
104
182
 
105
183
  All AI coding agents working in this repository **MUST**:
@@ -115,6 +193,7 @@ All AI coding agents working in this repository **MUST**:
115
193
  - Use canonical script names: `lint`, `format:check`, `typecheck`, `test`, `audit`, `validate`
116
194
  - Enforce quality gates before completion: `test`, `lint`, `format:check`, `typecheck`, `audit`
117
195
  - Use the `git-ops` skill for branch management, rebase, and conflict resolution
196
+ - `qa-engineer` runs at the completion gate, before the `verifier` audit, and records `coverage_gate`. It **MAY** be skipped only as `SKIPPED(<reason>)` with a non-empty reason; omitting the field is treated as incomplete.
118
197
  - The `verifier` audit is mandatory and non-skippable before every PR is marked ready. Drift findings are non-blocking and route to `product-engineer`'s `activity-drift-reconciliation`.
119
198
  - **Test-first design is the default:** `product-engineer` recommends `verifier` Design Mode after planning; `developer` writes tests before implementation code; `planner` checks for test plans and enforces test-first in developer handoffs
120
199
  - If `memo-cli` is installed and configured: agents **MUST** read/write entries per their role (see agent files for details)
@@ -214,4 +293,4 @@ When `scope.primary` contains exactly 1 component, no partitioning is needed. Th
214
293
 
215
294
  ---
216
295
 
217
- For workflow chains and sequencing diagrams, see [`docs/workflow-chains.md`](docs/workflow-chains.md).
296
+ For workflow chains and sequencing diagrams, see [`docs/workflow-chains.md`](docs/workflow-chains.md). For architecture, artifacts, and invariants, see [`docs/system-overview.md`](docs/system-overview.md) and [`docs/data-model.md`](docs/data-model.md). Full documentation index: [`docs/README.md`](docs/README.md).
package/CHANGELOG.md CHANGED
@@ -5,6 +5,75 @@ 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.9.0] - 2026-08-18
9
+
10
+ ### Added
11
+
12
+ - feat(qa): wire TESTING.md distribution and update all registries
13
+ - feat(qa): wire qa-engineer into developer, planner, implement, verifier
14
+ - feat(qa): add three testing skills mirrored across platforms
15
+ - feat(qa): add TESTING.md contract and qa-engineer agent
16
+ - feat(extract): wire schema extraction through ladder (declared → observed)
17
+ - feat(extract): add pg as optional peer dep, update Known Limitations
18
+ - feat(extract): add AsyncAPI declared rung for on-disk spec detection
19
+ - feat(extract): add OpenAPI ladder orchestrator (declared → observed → inferred)
20
+ - feat(extract): remove in-CLI LLM, extend report with provenance and handoff
21
+ - feat(extract): add workspace discovery and ladder runner
22
+ - feat(extract): implement route2 spike — boot + introspect for Express
23
+
24
+ ### Fixed
25
+
26
+ - fix: format
27
+ - fix(qa): address Major audit findings D-1 and D-2
28
+ - fix(workflow): open draft PR after first commit, not before
29
+
30
+ ### Changed
31
+
32
+ - Merge pull request #129 from llipe:issue/123-qa-agent-and-testing-standard
33
+ - docs(qa): sync registries, guidelines, and ADR-003 for the coverage gate
34
+ - test(qa): add fixture projects reproducing the home-ledger defects
35
+ - test(dist): add failing root-file distribution assertions for TESTING.md
36
+ - test(qa): add failing testing-standard assertions and rule-19 guard
37
+ - test(qa): add failing qa-engineer parity and prompt-cap assertions
38
+ - Merge pull request #128 from llipe/docs/current-state-sync-post-125
39
+ - chore(workstream): reorganize docs into archive directory
40
+ - docs: sync documentation with current dt implementation state
41
+ - Merge pull request #125 from llipe:claude/dev-tasks-codebase-analysis-oxda22
42
+ - chore: resolve merge conflict with main in catalog index.yaml
43
+ - docs(workstream): fix manual test plan — scripts must run from project root
44
+ - docs(workstream): fix manual test plan — scripts must run from project root
45
+ - docs(workstream): rewrite manual test plan with proper tsx file approach
46
+ - docs(workstream): fix manual test plan for tsx top-level await limitation
47
+ - chore: fix lint and format issues, update task checklist
48
+ - chore(workstream): link task list to issue #127 and PR #125
49
+ - Merge pull request #126 from llipe:issue/docs-current-state-sync
50
+ - docs: reorganize and document system architecture and agent framework
51
+ - chore(workstream): add task list for extraction ladder inversion plan
52
+
53
+ ## [0.8.0] - 2026-08-11
54
+
55
+ ### Fixed
56
+
57
+ - fix(hooks): update git-guard matcher and add branch-guard for write tools (issue #110, task 5.0)
58
+ - fix(agent): add branch/PR to per-turn output contract (issue #110, task 4.0)
59
+ - fix(agent): harden branch creation gate across all platforms (issue #110, task 3.0)
60
+ - fix(agent): add subagent tool to developer agent (issue #110, task 1.0)
61
+ - fix: remove unsupported permissions field from agent frontmatter
62
+
63
+ ### Changed
64
+
65
+ - chore: format corrections
66
+ - chore: doc archiving
67
+ - Merge pull request #120 from llipe:issue/110-developer-branch-creation
68
+ - chore(workstream): mark all tasks complete for issue #110
69
+ - docs(steering): document fileMatchPattern glob behavior for zero-depth (issue #110, task 2.0)
70
+ - chore(workstream): activate task list for issue #110
71
+ - chore: docs housekeeping
72
+ - Merge pull request #119 from llipe:issue/103-kiro-agent-format
73
+ - chore: update catalog fixture timestamps and generator version
74
+ - docs: note permissions field is unsupported in current Kiro runtime
75
+ - chore: adapt .kiro/agents to official Kiro custom agent format
76
+
8
77
  ## [0.7.4] - 2026-08-07
9
78
 
10
79
  ### Changed
@@ -55,6 +124,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
55
124
  - feat(catalog): implement catalog query and routing commands (S-013) Implements dt catalog resolve, get, deps, consumers, flow, closure, and coverage subcommands with full --json support. - core/catalog/resolve.ts: text normalization (lowercase, de-accent, light es/en stemming, stopword removal) and weighted lexical scorer (exact id 100, alias 80, flow alias 75, domain 60, alias-token 40, name/desc 25) - core/catalog/queries.ts: graph reads (get, deps with depth/direction, consumers, flow, closure with include-consumers/max cap) - core/catalog/coverage.ts: extraction quality aggregation per component - adapters/cli/catalog-query.ts: CLI handler for all query subcommands - FlowEntry model extended with optional aliases field - Flow fixture files updated with aliases for routing tests Refs #46
56
125
  - feat(catalog): implement dt catalog validate with V01-V19 checks Implements referential integrity and structural validation checks per spec §6.2. Errors (V01-V11, V14-V15, V19) abort with exit 4; warnings (V12-V13, V16-V18) do not. Under --strict, V12 cycle warnings become errors. Supports allowed_cycles config. Closes #45
57
126
  - feat(catalog): support component.yaml in addition to component.json Build now looks for component.json first, then falls back to component.yaml. This matches the spec's mention of component.yaml while preserving backward compat with JSON format.
127
+ - **Correction (2026-08-14):** this fallback was reverted within the same release (`7bebc79` reverting `f697265`) and was never shipped. The released behavior of 0.7.0 is `component.json` only; a repo carrying only `component.yaml` is reported in `index.errors[]`. See [`docs/adr/ADR-001-component-json-manifest-format.md`](docs/adr/ADR-001-component-json-manifest-format.md).
58
128
  - feat(catalog): implement dt catalog build — aggregate manifests and generate index Implements Story S-011 (#43): - Define CatalogIndex types in core/catalog/index-model.ts - Implement registry parsing, manifest fetching, and mirroring - Build inverted consumer index from provides/consumes - Tally extraction quality from provenance fields - Aggregate domains and flows from manifests and catalog/flows/ - Generate deterministic catalog/index.yaml (sorted keys, stable order) - Implement idempotent write (skip when nothing changed) - Handle single repo failure: record in errors[], exit 3 - Detect duplicate component IDs across repos - Wire dt catalog build --registry <path> [--concurrency] [--json] CLI - Add 20-component fixture registry with diverse scenarios - Add yaml@2.7.1 dependency for YAML serialization Closes #43
59
129
  - feat(catalog): add JSON Schemas and dt validate-component Adds component.schema.json, flow.schema.json, and scope-output.schema.json (JSON Schema draft 2020-12) plus a local validate-component module using ajv's Ajv2020 class. Wires dt validate-component <path> with human and --json output, exit 0/4. No network access required. Refs #42
60
130
 
package/CLAUDE.md CHANGED
@@ -19,6 +19,8 @@ All work in this repository **MUST**:
19
19
  - Prefer `pnpm` over `npm` for JavaScript/TypeScript workflows (fallback to `npm` only when `pnpm` is unavailable or explicitly disallowed).
20
20
  - Use canonical `package.json` script names for JS/TS projects: `lint`, `lint:fix`, `format`, `format:check`, `typecheck`, `test`, `test:unit`, `test:integration`, `test:e2e`, `audit`, `validate`.
21
21
  - Before developer/planner completion, enforce and record quality gates: `test`, `lint`, `format:check`, `typecheck`, `audit`.
22
+ - `qa-engineer` runs at the completion gate, before the `verifier` audit, and records `coverage_gate: PASS | FAIL | SKIPPED(<reason>)`. Skipping requires a non-empty reason; omitting the field is treated as incomplete.
23
+ - `/TESTING.md` is the canonical testing contract — owned by `qa-engineer`, kept current by `developer`, and treated as "no standard established" while unfilled.
22
24
  - Reference GitHub Issues in branch names and commits; follow the `github-ops` conventions for all GitHub artifacts (issues, PRs, branches, labels, milestones, comments).
23
25
  - Treat `/DESIGN.md` as the source of truth for visual tokens, components, and design guidance; update it whenever UI contracts change.
24
26
  - Maintain document changelogs when updating generated artifacts (PRDs, specs, stories, refinements).
@@ -52,13 +54,14 @@ This toolkit is exposed as **commands** (entry points you invoke with `/`), **su
52
54
  | `/github-ops` | Audit/standardize GitHub artifacts. |
53
55
  | `/technical-writer` | Sync `/docs` with the codebase. |
54
56
  | `/housekeeping` | Fix lint/type/test-wiring issues. |
57
+ | `/qa-engineer` | Establish `/TESTING.md`, author missing Layer 1-2 tests, and report `coverage_gate` plus risk-ranked gaps. |
55
58
  | `/ux-engineer` | PRD/SPEC → React mockups + refinement handoff. |
56
59
  | `/verifier-design` | Generate a compliance test plan + traceability matrix from a spec/story (Design Mode). |
57
60
  | `/verifier-audit` | Grey-box fidelity audit of delivered work against requirements and PRD/spec intent (Audit Mode). |
58
61
 
59
62
  ### Subagents (`.claude/agents/`)
60
63
 
61
- `developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
64
+ `developer`, `github-ops`, `technical-writer`, `housekeeping`, `ux-engineer`, `verifier`, `qa-engineer` — isolated, scoped-tool workers. Claude delegates to these automatically when a task matches their description, and the orchestrator commands (`/planner`, `/product-engineer`) drive them via the Task tool.
62
65
 
63
66
  ### Orchestration model (important)
64
67
 
@@ -69,9 +72,9 @@ Claude Code subagents **cannot spawn other subagents** — the hierarchy is flat
69
72
 
70
73
  ### Skills (`.claude/skills/`)
71
74
 
72
- Activity skills: `activity-init`, `activity-refine`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-contract-test-design`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `webapp-mockup`, `memo-cli-usage`.
75
+ Activity skills: `activity-init`, `activity-refine`, `activity-generate-spec`, `activity-generate-stories`, `activity-publish-github`, `activity-e2e-test-design`, `activity-contract-test-design`, `activity-edge-case-refinement`, `activity-random-test-tactics`, `activity-test-standards`, `activity-test-implementation`, `activity-coverage-gap-analysis`, `activity-drift-reconciliation` (routes `verifier` drift findings into task-list/checklist expansion, new issues, or human-confirmed PRD/spec changelog updates — used by `product-engineer`). Process skills: `plan`, `implement` (the single source of truth for task-list execution rules, including the mandatory `verifier` audit gate). Operational: `git-ops`, `webapp-mockup`, `memo-cli-usage`.
73
76
 
74
- `plan` and `implement` were the always-loaded Copilot instructions; as skills they load on demand instead of consuming context every turn.
77
+ `plan` and `implement` are scoped instructions on Copilot (`applyTo`) and scoped steering on Kiro (`fileMatchPattern`); as Claude skills they load on demand instead of consuming context on every matching turn.
75
78
 
76
79
  ---
77
80