@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/README.md CHANGED
@@ -121,6 +121,8 @@ For which artifacts are JSON vs YAML, and which are generated vs hand-written, s
121
121
 
122
122
  - **`dev-tasks` (bootstrap/distribution):** [`docs/dev-tasks-user-manual.md`](docs/dev-tasks-user-manual.md) — install, update, pin/unpin, profiles, manifest merging, reconciliation
123
123
  - **`dt` (extraction/catalog/context):** [`docs/dt-user-manual.md`](docs/dt-user-manual.md) — extract, catalog, context, scope
124
+ - **Architecture and artifacts:** [`docs/system-overview.md`](docs/system-overview.md) and [`docs/data-model.md`](docs/data-model.md)
125
+ - **Everything else:** [`docs/README.md`](docs/README.md)
124
126
 
125
127
  ### Global options
126
128
 
@@ -132,14 +134,20 @@ For which artifacts are JSON vs YAML, and which are generated vs hand-written, s
132
134
 
133
135
  ### Exit codes
134
136
 
137
+ Both binaries share one exit-code table. Common cases:
138
+
135
139
  | Code | Meaning |
136
140
  | ---- | ------------------------------------------------- |
137
141
  | 0 | OK |
138
142
  | 1 | Unexpected error |
139
143
  | 2 | Incorrect usage |
144
+ | 7 | Gate aborted (scope gate G1–G4) |
145
+ | 8 | Breaking contract change detected |
140
146
  | 13 | Incomplete extraction: required fields unresolved |
141
147
  | 14 | Reconciliation conflict (edited fields) |
142
148
 
149
+ Full table with all 15 codes: [`docs/data-model.md`](docs/data-model.md#exit-code-contract).
150
+
143
151
  ---
144
152
 
145
153
  ## `dev-tasks` Command Reference
@@ -166,14 +174,14 @@ dev-tasks unpin # Remove the pin (update will use the local package versi
166
174
 
167
175
  ### Options (install / update)
168
176
 
169
- | Option | Description |
170
- | ------------------ | ---------------------------------------------------- |
171
- | `--profile <name>` | `copilot` \| `claude` \| `kiro` \| `both` \| `all` |
172
- | `--dry-run` | Print planned changes without writing any files |
173
- | `--backup` | Backup managed files before replacing |
174
- | `--yes` | Skip confirmation prompts (useful in CI) |
175
- | `--pin <version>` | Pin to a specific release version |
176
- | `--force` | Accept all upstream changes without conflict prompts |
177
+ | Option | Applies to | Description |
178
+ | ------------------ | ---------- | ------------------------------------------------------------------- |
179
+ | `--profile <name>` | install | `copilot` \| `claude` \| `kiro` \| `both` \| `all` (default: `all`) |
180
+ | `--pin <version>` | install | Pin to a specific release version |
181
+ | `--force` | update | Back up conflicting files, then overwrite them |
182
+ | `--json` | both | Machine-readable output |
183
+
184
+ `update` never overwrites a locally modified managed file without `--force`; it reports the conflict and exits `14`.
177
185
 
178
186
  ---
179
187
 
@@ -195,11 +203,11 @@ This system brings structure and clarity to AI-assisted development by:
195
203
  | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
196
204
  | **Agent** | Autonomous role with decision-making, phases, and handoff discipline. Owns a workflow end-to-end. | Invoked by name (`@agent`) |
197
205
  | **Skill** | Reusable on-demand capability. Describes _procedures_ or _activities_ that any agent can invoke when needed. Not loaded unless referenced. | On demand (invoked by agent or prompt) |
198
- | **Instruction** | Always-loaded rule scoped via `applyTo` frontmatter. Enforced automatically for every matching context. | Always (auto-applied by runtime) |
206
+ | **Instruction** | Rule scoped via `applyTo`/`fileMatchPattern` frontmatter. Enforced automatically whenever the agent touches a matching file. | Auto-applied on matching context |
199
207
 
200
208
  **Key distinctions:**
201
209
 
202
- - Skills save context window space — they are loaded only when invoked, unlike instructions which are always present.
210
+ - Skills save context window space — they are loaded only when invoked, unlike instructions which load automatically for every matching file.
203
211
  - Agent files define _who_ (identity, phases, handoff rules). Skill files define _how_ (procedures, templates, steps).
204
212
  - Instructions are for cross-cutting rules that must never be forgotten (e.g., implementation discipline, planning format).
205
213
 
@@ -209,7 +217,7 @@ This system brings structure and clarity to AI-assisted development by:
209
217
 
210
218
  Agents are autonomous personas that orchestrate skills and activities.
211
219
 
212
- > **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). All three platforms define the same 8 agents below.
220
+ > **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). Copilot and Kiro define all 9 agents below. On Claude Code, the two orchestrators (`planner`, `product-engineer`) run in the main thread as `/commands` so they can pause for approval gates; the other 7 are subagents.
213
221
 
214
222
  ### `product-engineer`
215
223
 
@@ -223,7 +231,7 @@ Also owns drift reconciliation via `activity-drift-reconciliation`.
223
231
 
224
232
  ### `developer`
225
233
 
226
- Execution agent — implements code from an existing task list. Runs `implement`, including a mandatory `verifier` audit before every PR is marked ready. Uses `git-ops` for branch management.
234
+ Execution agent — implements code from an existing task list. Runs `implement`, including a `qa-engineer` coverage gate and a mandatory `verifier` audit before every PR is marked ready. Uses `git-ops` for branch management.
227
235
 
228
236
  ### `planner`
229
237
 
@@ -241,13 +249,14 @@ Multi-story orchestration with checkpoint/resume:
241
249
 
242
250
  ### Other Agents
243
251
 
244
- | Agent | Purpose |
245
- | ------------------ | -------------------------------------------------- |
246
- | `ux-engineer` | PRD/SPEC-to-mockup prototyping |
247
- | `technical-writer` | Documentation maintenance |
248
- | `housekeeping` | Lint, type, and test-wiring fixes |
249
- | `github-ops` | GitHub consistency — issues, PRs, branches, labels |
250
- | `verifier` | Compliance test-plan design and fidelity auditing |
252
+ | Agent | Purpose |
253
+ | ------------------ | -------------------------------------------------------------------- |
254
+ | `ux-engineer` | PRD/SPEC-to-mockup prototyping |
255
+ | `technical-writer` | Documentation maintenance |
256
+ | `housekeeping` | Lint, type, and test-wiring fixes |
257
+ | `github-ops` | GitHub consistency — issues, PRs, branches, labels |
258
+ | `verifier` | Compliance test-plan design and fidelity auditing |
259
+ | `qa-engineer` | Testing standard, missing test harnesses, coverage and gap reporting |
251
260
 
252
261
  ---
253
262
 
@@ -255,119 +264,105 @@ Multi-story orchestration with checkpoint/resume:
255
264
 
256
265
  On-demand capabilities loaded only when invoked.
257
266
 
258
- | Skill | Purpose | Consumer |
259
- | ------------------------------- | ----------------------------------------------- | --------------------------------------------------- |
260
- | `activity-init` | Product context and technical guidelines | `product-engineer` |
261
- | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
262
- | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
263
- | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
264
- | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
265
- | `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
266
- | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
267
- | `webapp-mockup` | React mockup scaffold for UX testing | `ux-engineer` |
268
- | `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
269
- | `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
270
- | `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
271
- | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
272
- | `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
267
+ | Skill | Purpose | Consumer |
268
+ | -------------------------------- | ----------------------------------------------- | --------------------------------------------------- |
269
+ | `activity-init` | Product context and technical guidelines | `product-engineer` |
270
+ | `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
271
+ | `activity-generate-spec` | PRD → technical specification | `product-engineer` |
272
+ | `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
273
+ | `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
274
+ | `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
275
+ | `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
276
+ | `webapp-mockup` | React mockup scaffold for UX testing | `ux-engineer` |
277
+ | `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
278
+ | `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
279
+ | `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
280
+ | `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
281
+ | `activity-test-standards` | Establish and maintain `/TESTING.md` | `qa-engineer` |
282
+ | `activity-test-implementation` | Author Layer 1-2 tests with enforced boundaries | `qa-engineer` |
283
+ | `activity-coverage-gap-analysis` | Coverage measurement and risk-ranked gaps | `qa-engineer` |
284
+ | `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
273
285
 
274
286
  ---
275
287
 
276
- ## Instructions (Always-Loaded)
288
+ ## Instructions (Scoped)
277
289
 
278
- | Instruction | Scope | Purpose |
279
- | ------------------------------------------------ | ---------- | -------------------------------------- |
280
- | `plan.instructions.md` | `**` | Convert stories/issues into task lists |
281
- | `implement.instructions.md` | `**` | Execute task list with approval gates |
282
- | `domain/nextjs-pages-components.instructions.md` | `**/*.tsx` | Next.js + React conventions |
290
+ Auto-applied whenever the agent touches a matching file. Claude Code has no scoped-instruction mechanism, so `plan` and `implement` ship there as skills.
283
291
 
284
- ---
292
+ | Instruction | Scope | Purpose |
293
+ | ------------------------- | -------------------------- | -------------------------------------- |
294
+ | `plan` | `workstream/**` | Convert stories/issues into task lists |
295
+ | `implement` | `workstream/**/tasks-*.md` | Execute task list with approval gates |
296
+ | `nextjs-pages-components` | `**/app/**/*.tsx` | Next.js + React conventions |
297
+ | `git-guard-notice` | Always loaded (Kiro) | Restates the three git invariants |
285
298
 
286
- ## Prompts
299
+ Copilot reads `.github/instructions/*.instructions.md`, Kiro reads `.kiro/steering/*.md`, and Claude Code reads `.claude/skills/{plan,implement}/`.
287
300
 
288
- > Copilot: `.github/prompts/*.prompt.md`. Claude Code: `.claude/commands/*.md`. Kiro: embedded in `.kiro/agents/*.md`.
301
+ ### Hooks
289
302
 
290
- | Prompt | Agent | Purpose |
291
- | -------------------------- | ---------------- | --------------------------------- |
292
- | `product-engineer-init` | product-engineer | Initialize foundation documents |
293
- | `product-engineer-feature` | product-engineer | Design and plan a feature |
294
- | `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
295
- | `developer-execute` | developer | Execute an existing task list |
296
- | `planner` | planner | Orchestrate multi-story execution |
297
- | `planner-resume` | planner | Resume from checkpoint |
298
- | `ux-engineer` | ux-engineer | Generate UX mockups |
299
- | `github-ops` | github-ops | GitHub consistency |
300
- | `technical-writer` | technical-writer | Documentation maintenance |
301
- | `housekeeping` | housekeeping | Lint, type, test fixes |
302
- | `verifier-design` | verifier | Generate compliance test plan |
303
- | `verifier-audit` | verifier | Grey-box fidelity audit |
303
+ `git-guard` blocks pushes and merges to `main`, non-Conventional commit messages, and inline `gh --body`. `branch-guard` blocks write operations while on the default branch. Both are best-effort; human PR review is the actual gate.
304
304
 
305
305
  ---
306
306
 
307
- ## Workflow Chains
308
-
309
- Match your situation to a chain below, then invoke the first agent in the chain.
310
-
311
- ### Full Feature (PRD-Driven)
312
-
313
- ```
314
- product-engineer: refine → generate-spec → generate-stories → publish-github → plan
315
- ↓
316
- developer: implement
317
- ```
318
-
319
- ### Single GitHub Issue
307
+ ## Prompts
320
308
 
321
- ```
322
- product-engineer: refine → plan
323
- ↓
324
- developer: implement
325
- ```
309
+ > Copilot: `.github/prompts/*.prompt.md`. Claude Code: `.claude/commands/*.md`. Kiro: embedded in `.kiro/agents/*.md`.
326
310
 
327
- ### Multi-Story Orchestration
311
+ | Prompt | Agent | Purpose |
312
+ | -------------------------- | ---------------- | ---------------------------------- |
313
+ | `product-engineer-init` | product-engineer | Initialize foundation documents |
314
+ | `product-engineer-feature` | product-engineer | Design and plan a feature |
315
+ | `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
316
+ | `developer-execute` | developer | Execute an existing task list |
317
+ | `planner` | planner | Orchestrate multi-story execution |
318
+ | `planner-resume` | planner | Resume from checkpoint |
319
+ | `ux-engineer` | ux-engineer | Generate UX mockups |
320
+ | `github-ops` | github-ops | GitHub consistency |
321
+ | `technical-writer` | technical-writer | Documentation maintenance |
322
+ | `housekeeping` | housekeeping | Lint, type, test fixes |
323
+ | `qa-engineer` | qa-engineer | Testing standard and coverage gate |
324
+ | `verifier-design` | verifier | Generate compliance test plan |
325
+ | `verifier-audit` | verifier | Grey-box fidelity audit |
328
326
 
329
- ```
330
- product-engineer: ... → plan
331
- ↓
332
- planner: orchestrate → developer: implement (per story, sequential)
333
- ```
327
+ ---
334
328
 
335
- ### Quick Fix
329
+ ## Workflow Chains
336
330
 
337
- ```
338
- developer: implement
339
- ```
331
+ Match your situation to a chain, then invoke the first agent in it. Full diagrams, including the UX validation loop and project initialization, are in [`docs/workflow-chains.md`](docs/workflow-chains.md).
340
332
 
341
- ### Test-First Design (Verifier)
333
+ | Situation | Chain |
334
+ | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
335
+ | Full feature, PRD-driven | `product-engineer` (refine → spec → stories → publish → plan) → `developer` |
336
+ | Single GitHub Issue | `product-engineer` (refine → plan) → `developer` |
337
+ | Several dependent stories | `product-engineer` (… → plan) → `planner` → `developer` per story, sequential |
338
+ | Quick fix, task list exists | `developer` |
339
+ | Test-first design | … → plan → `verifier` (design) → `developer` → `qa-engineer` → `verifier` (audit) → `product-engineer` (drift reconciliation) |
340
+ | UX validation before build | `product-engineer` (refine → spec) → `ux-engineer` → `product-engineer` |
341
+ | New project | `product-engineer` (init mode) |
342
342
 
343
- ```
344
- product-engineer: spec → stories → plan
345
- ↓
346
- verifier (design mode): generate test plan
347
- ↓
348
- developer: implement (tests first, then code)
349
- ↓ (mandatory)
350
- verifier (audit mode): fidelity audit → report
351
- ↓ (drift findings, non-blocking)
352
- product-engineer: drift-reconciliation
353
- ```
343
+ The `verifier` audit after implementation is mandatory and non-skippable before a PR is marked ready.
354
344
 
355
345
  ---
356
346
 
357
347
  ## File Organization
358
348
 
359
- | Directory | Contents |
360
- | --------------------- | ------------------------------------------------------- |
361
- | `/docs/` | Foundation docs — product-context, technical-guidelines |
362
- | `/docs/requirements/` | PRDs produced by the refine skill |
363
- | `/workstream/` | Active feature work — specs, stories, task lists |
364
- | `bin/` | CLI entrypoints (`dev-tasks.ts`, `dt.ts`) |
365
- | `core/` | Business logic library (extract, distribution) |
366
- | `adapters/cli/` | CLI adapter — wraps core, formats stdout/JSON |
367
- | `schemas/` | JSON Schemas for validation |
368
- | `test/` | Unit and integration tests + fixtures |
369
- | `.github/` | Copilot agents, skills, instructions, prompts |
370
- | `.kiro/` | Kiro agents, skills, steering, hooks |
349
+ | Directory | Contents |
350
+ | --------------------- | ----------------------------------------------------------------------- |
351
+ | `/docs/` | Documentation — see [`docs/README.md`](docs/README.md) for the index |
352
+ | `/docs/adr/` | Architecture decision records |
353
+ | `/docs/requirements/` | PRDs produced by the refine skill |
354
+ | `/workstream/` | Active feature work — specs, stories, task lists, fidelity reports |
355
+ | `bin/` | CLI entrypoints (`dev-tasks.ts`, `dt.ts`) |
356
+ | `core/` | Business logic — catalog, context, distribution, extract, scope, verify |
357
+ | `adapters/cli/` | CLI adapter — wraps core, formats stdout/JSON |
358
+ | `adapters/mcp/` | MCP adapter placeholder (not implemented) |
359
+ | `schemas/` | JSON Schemas for validation |
360
+ | `scripts/` | Bundle build, release, and formatting scripts |
361
+ | `templates/` | Meta-repo scaffold and CI templates |
362
+ | `test/` | Unit and integration tests + fixtures |
363
+ | `.github/` | Copilot agents, skills, instructions, prompts; CI workflows |
364
+ | `.claude/` | Claude Code agents, skills, commands, hooks |
365
+ | `.kiro/` | Kiro agents, skills, steering, hooks |
371
366
 
372
367
  ---
373
368
 
@@ -389,11 +384,12 @@ memo setup init --repo <repo-name> --org <org-name> --domain <domain>
389
384
 
390
385
  ## Known Limitations
391
386
 
392
- - **Route 2 (isolated framework boot) is interface-only** — only routes 1 and 3 are functional for OpenAPI extraction.
393
- - **LLM inference is stubbed** — no real LLM provider is wired yet.
387
+ - **Route 2 (boot + introspect) supports Express and Express 5 only** — Fastify, Hono, and NestJS support is planned but not yet implemented.
388
+ - **Observed DB rung requires PostgreSQL** — the `information_schema` reader works with `pg` only; MySQL/SQLite support is deferred.
394
389
  - **Only Node/TS provider** — other language stacks require additional extraction providers.
395
390
  - **Zod extraction handles basic `z.object` patterns only** — complex compositions are not fully supported.
396
- - **Only kafkajs patterns supported** — other messaging clients are not detected.
391
+ - **Only kafkajs patterns supported** — other messaging clients are not detected; kafkajs inference is now low-confidence.
392
+ - **Monorepo detection is pnpm/npm workspaces only** — custom workspace layouts require manual configuration.
397
393
 
398
394
  ---
399
395
 
@@ -103,6 +103,7 @@
103
103
  "consumer_owned_paths": [
104
104
  "AGENTS.md",
105
105
  "CLAUDE.md",
106
+ "TESTING.md",
106
107
  ".claude/settings.json",
107
108
  ".kiro/settings/mcp.json",
108
109
  ".kiro/specs"
@@ -1 +1 @@
1
- {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../core/distribution/install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,QAAQ,EAEd,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAgED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA6DlF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IACpE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAGD"}
1
+ {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../core/distribution/install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,QAAQ,EAEd,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAgED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAoFlF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IACpE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAGD"}
@@ -6,7 +6,7 @@ import { readdir, readFile, writeFile, mkdir } from "node:fs/promises";
6
6
  import { join, relative } from "node:path";
7
7
  import { hashContent } from "./hash.js";
8
8
  import { readManifest, writeManifest } from "./manifest.js";
9
- import { resolveProfile, PROFILE_PATHS, } from "./profiles.js";
9
+ import { resolveProfile, PROFILE_PATHS, ROOT_FILES, ROOT_PROFILE_TAG, } from "./profiles.js";
10
10
  /**
11
11
  * Recursively collect all files under a directory.
12
12
  * Returns paths relative to the given baseDir.
@@ -97,6 +97,28 @@ export async function installFiles(options) {
97
97
  }
98
98
  }
99
99
  }
100
+ // Root files belong to no platform: install once per run, not once per platform.
101
+ for (const relFile of ROOT_FILES) {
102
+ const sourcePath = join(sourceDir, relFile);
103
+ let content;
104
+ try {
105
+ content = await readFile(sourcePath, "utf-8");
106
+ }
107
+ catch {
108
+ // A bundle that ships no root file is valid; skip silently.
109
+ continue;
110
+ }
111
+ const hash = hashContent(content);
112
+ const targetPath = join(targetDir, relFile);
113
+ await mkdir(join(targetPath, ".."), { recursive: true });
114
+ await writeFile(targetPath, content, "utf-8");
115
+ managedFiles.push({
116
+ path: relFile,
117
+ profile: ROOT_PROFILE_TAG,
118
+ sha256: hash,
119
+ origin_sha256: hash,
120
+ });
121
+ }
100
122
  const manifest = {
101
123
  version,
102
124
  pinned: pin,
@@ -107,7 +129,8 @@ export async function installFiles(options) {
107
129
  // Merge with existing manifest: preserve files from profiles not being installed
108
130
  const existing = await readManifest(targetDir);
109
131
  if (existing) {
110
- const installedProfileSet = new Set(platforms);
132
+ // Include the root tag so root entries are replaced, not duplicated.
133
+ const installedProfileSet = new Set([...platforms, ROOT_PROFILE_TAG]);
111
134
  const preservedFiles = existing.files.filter((f) => !installedProfileSet.has(f.profile));
112
135
  manifest.files = [...preservedFiles, ...managedFiles];
113
136
  manifest.extraction = existing.extraction;
@@ -1 +1 @@
1
- {"version":3,"file":"install.js","sourceRoot":"","sources":["../../../core/distribution/install.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"install.js","sourceRoot":"","sources":["../../../core/distribution/install.ts"],"names":[],"mappings":"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"}
@@ -17,6 +17,27 @@ export interface ManagedPath {
17
17
  }
18
18
  /** Profile-to-paths mapping for each individual platform. */
19
19
  export declare const PROFILE_PATHS: Record<Platform, ManagedPath[]>;
20
+ /**
21
+ * Repo-root files that belong to no platform.
22
+ *
23
+ * These are canonical contract documents installed once per run regardless of
24
+ * how many platforms the profile resolves to. They are also listed in
25
+ * `consumer_owned_paths` in `bundle-manifest.json`, so `dev-tasks update` never
26
+ * overwrites a version the consumer has filled in.
27
+ *
28
+ * Entries MUST be bare filenames at the repository root — a nested or
29
+ * platform-prefixed path belongs in `PROFILE_PATHS` instead.
30
+ */
31
+ export declare const ROOT_FILES: readonly string[];
32
+ /**
33
+ * Manifest `profile` tag for root files.
34
+ *
35
+ * Platform-agnostic files cannot be tagged with a single platform: manifest
36
+ * merging replaces entries whose profile is in the installed set, so a root file
37
+ * tagged `kiro` would be dropped when installing `copilot` and duplicated when
38
+ * installing `all`. A dedicated tag keeps it to exactly one entry.
39
+ */
40
+ export declare const ROOT_PROFILE_TAG = "root";
20
41
  /** Valid profile values for CLI validation. */
21
42
  export declare const VALID_PROFILES: readonly Profile[];
22
43
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AACnC,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE,qEAAqE;AACrE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,6DAA6D;AAC7D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAmBzD,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAMnC,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAa3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAE9D"}
1
+ {"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AACnC,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE,qEAAqE;AACrE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,6DAA6D;AAC7D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAmBzD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAA4B,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,+CAA+C;AAC/C,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAMnC,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAa3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAE9D"}
@@ -23,6 +23,27 @@ export const PROFILE_PATHS = {
23
23
  { source: ".kiro/hooks", target: ".kiro/hooks", recursive: true },
24
24
  ],
25
25
  };
26
+ /**
27
+ * Repo-root files that belong to no platform.
28
+ *
29
+ * These are canonical contract documents installed once per run regardless of
30
+ * how many platforms the profile resolves to. They are also listed in
31
+ * `consumer_owned_paths` in `bundle-manifest.json`, so `dev-tasks update` never
32
+ * overwrites a version the consumer has filled in.
33
+ *
34
+ * Entries MUST be bare filenames at the repository root — a nested or
35
+ * platform-prefixed path belongs in `PROFILE_PATHS` instead.
36
+ */
37
+ export const ROOT_FILES = ["TESTING.md"];
38
+ /**
39
+ * Manifest `profile` tag for root files.
40
+ *
41
+ * Platform-agnostic files cannot be tagged with a single platform: manifest
42
+ * merging replaces entries whose profile is in the installed set, so a root file
43
+ * tagged `kiro` would be dropped when installing `copilot` and duplicated when
44
+ * installing `all`. A dedicated tag keeps it to exactly one entry.
45
+ */
46
+ export const ROOT_PROFILE_TAG = "root";
26
47
  /** Valid profile values for CLI validation. */
27
48
  export const VALID_PROFILES = [
28
49
  "copilot",
@@ -1 +1 @@
1
- {"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAoC;IAC5D,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,EAAE;QACnF,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE;KAC3E;IACD,MAAM,EAAE;QACN,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE;QAC5E,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE;KACtE;IACD,IAAI,EAAE;QACJ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE;QACpE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE;QACnE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE;KAClE;CACF,CAAC;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,KAAK;CACG,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/B,KAAK,KAAK;YACR,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC;AACnD,CAAC"}
1
+ {"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../core/distribution/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAoC;IAC5D,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,EAAE;QACnF,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE;KAC3E;IACD,MAAM,EAAE;QACN,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE;QACvE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE;QAC5E,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE;KACtE;IACD,IAAI,EAAE;QACJ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE;QACpE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE;QACnE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;QACxE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE;KAClE;CACF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB,CAAC,YAAY,CAAU,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,KAAK;CACG,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/B,KAAK,KAAK;YACR,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC;AACnD,CAAC"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * AsyncAPI Declared Rung: On-disk AsyncAPI spec detection.
3
+ *
4
+ * Detects an existing asyncapi.yaml/asyncapi.json in the repository.
5
+ * If found, reads and validates it as the authoritative source.
6
+ * Returns confidence: high, rung: declared.
7
+ */
8
+ import type { AsyncApiExtractionResult } from "./types.js";
9
+ /**
10
+ * Detect an on-disk AsyncAPI specification.
11
+ * Returns the path if found, null otherwise.
12
+ */
13
+ export declare function detectOnDiskAsyncApiSpec(rootDir: string): string | null;
14
+ /**
15
+ * Extract AsyncAPI channels from an on-disk specification.
16
+ * Returns null if no spec is found.
17
+ */
18
+ export declare function extractAsyncApiDeclared(rootDir: string): AsyncApiExtractionResult | null;
19
+ //# sourceMappingURL=declared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"declared.d.ts","sourceRoot":"","sources":["../../../../core/extract/asyncapi/declared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,wBAAwB,EAAmB,MAAM,YAAY,CAAC;AAkB5E;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQvE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAmCxF"}