@beignet/cli 0.0.49 → 0.0.50

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 (47) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +41 -1
  3. package/dist/analysis/workspace.d.ts +1 -0
  4. package/dist/analysis/workspace.d.ts.map +1 -1
  5. package/dist/analysis/workspace.js +20 -10
  6. package/dist/analysis/workspace.js.map +1 -1
  7. package/dist/app-map-changes.d.ts +103 -0
  8. package/dist/app-map-changes.d.ts.map +1 -0
  9. package/dist/app-map-changes.js +949 -0
  10. package/dist/app-map-changes.js.map +1 -0
  11. package/dist/git-changes.d.ts +30 -0
  12. package/dist/git-changes.d.ts.map +1 -0
  13. package/dist/git-changes.js +367 -0
  14. package/dist/git-changes.js.map +1 -0
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +26 -1
  17. package/dist/index.js.map +1 -1
  18. package/dist/inspect.js +291 -18
  19. package/dist/inspect.js.map +1 -1
  20. package/dist/lib.d.ts +3 -0
  21. package/dist/lib.d.ts.map +1 -1
  22. package/dist/lib.js +1 -0
  23. package/dist/lib.js.map +1 -1
  24. package/dist/make/shared.d.ts.map +1 -1
  25. package/dist/make/shared.js +31 -27
  26. package/dist/make/shared.js.map +1 -1
  27. package/dist/mcp.d.ts.map +1 -1
  28. package/dist/mcp.js +24 -2
  29. package/dist/mcp.js.map +1 -1
  30. package/dist/templates/agents.d.ts.map +1 -1
  31. package/dist/templates/agents.js +21 -1
  32. package/dist/templates/agents.js.map +1 -1
  33. package/dist/templates/base.d.ts.map +1 -1
  34. package/dist/templates/base.js +4 -1
  35. package/dist/templates/base.js.map +1 -1
  36. package/package.json +2 -2
  37. package/skills/app-structure/SKILL.md +25 -2
  38. package/src/analysis/workspace.ts +25 -9
  39. package/src/app-map-changes.ts +1462 -0
  40. package/src/git-changes.ts +511 -0
  41. package/src/index.ts +39 -1
  42. package/src/inspect.ts +422 -23
  43. package/src/lib.ts +21 -0
  44. package/src/make/shared.ts +31 -27
  45. package/src/mcp.ts +32 -2
  46. package/src/templates/agents.ts +21 -1
  47. package/src/templates/base.ts +4 -1
@@ -64,6 +64,8 @@ is a silent failure — the file exists but never runs:
64
64
  fallback and rejects unmarked custom inline wiring as a conflict.
65
65
  - Listeners must be added to the \`listeners\` array in \`server/listeners.ts\`
66
66
  and wired through a \`registerListeners(...)\` call in server provider wiring.
67
+ Register them in \`start()\`, await \`registration.ready\`, and await
68
+ \`registration.unsubscribe()\` in \`stop()\`.
67
69
  - Apps using Inngest must also spread feature job registries into
68
70
  \`inngestJobs\` in \`server/inngest.ts\`.
69
71
  - Apps using runtime integrity must list workflow registries in
@@ -157,6 +159,15 @@ to one feature. The graph honors the app's complete TypeScript \`baseUrl\` and
157
159
  edges as proof that no relationship exists. Registration diagnostics expose
158
160
  the declaration as \`subject.file\` and \`subject.exportName\`.
159
161
 
162
+ After editing in a Git worktree, run \`${cli} map --changed\` before the full
163
+ check. It reports direct changes, reverse imports, one-hop semantic consumers,
164
+ feature context, and unresolved evidence without claiming that the change is
165
+ correct. Use \`--base <local-ref>\` for branch-wide impact from the merge base;
166
+ Beignet never fetches the ref. Recognized guide files and
167
+ root documentation-directory content stay non-impacting; other \`.mdx\` and
168
+ \`.txt\` paths remain application changes. Changed files with no mapped concept
169
+ appear as explicit gaps.
170
+
160
171
  ## Package skills
161
172
 
162
173
  This app trusts Beignet's package-shipped agent skills through
@@ -173,6 +184,12 @@ skill-loading block.
173
184
 
174
185
  ## Placement rules
175
186
 
187
+ - Checked-in SQL migrations and Drizzle metadata live in root \`drizzle/\`.
188
+ - Seed generators compose feature seeds through the optional
189
+ \`server/seed.ts\` entrypoint.
190
+ - Long-running runtime entrypoints such as BullMQ workers live under optional
191
+ \`server/workers/\`; never start worker loops in lifecycle providers or
192
+ serverless route modules.
176
193
  - Feature artifacts live under \`features/<feature>/\`, with tests in
177
194
  \`features/<feature>/tests/\` (not \`__tests__/\`).
178
195
  - Feature-specific client data-fetching helpers, query options, mutation
@@ -204,7 +221,10 @@ stable operation IDs, hashes, exact patches, and current diagnostics before
204
221
  passing its \`planId\` and optional \`fixIds\` to \`doctor_fix\`. Guarded
205
222
  apply returns the same plan metadata and inspection payload as the CLI. Use
206
223
  \`app_map\` before broad code search and pass a feature
207
- or node kinds to keep context focused. Use \`explain\` for source-backed
224
+ or node kinds to keep context focused. After edits, pass
225
+ \`{ changed: true, base?: string }\` for the same report as
226
+ \`${cli} map --changed --json\`; changed mode rejects projection and diagnostic
227
+ inputs. Use \`explain\` for source-backed
208
228
  relationships, conventions, findings, and suggested files for any mapped
209
229
  concept or diagnostic; its kinds match the app map. Use \`check\` after edits
210
230
  to run the complete validation loop; it returns the same versioned result as
@@ -324,7 +324,10 @@ Use \`${cli} make feature projects --recipe full-slice\` when you want a richer
324
324
 
325
325
  Run \`${cli} map\` for the current architecture or \`${cli} map --json\` for
326
326
  the versioned graph used by coding agents. Add \`--feature todos\` to focus on
327
- one slice and its direct relationships.
327
+ one slice and its direct relationships. After editing in a Git worktree, run
328
+ \`${cli} map --changed\` to inspect direct changes, potential semantic
329
+ consumers, feature context, and unresolved evidence before \`${cli} check\`.
330
+ The changed map is report-only and does not prove correctness.
328
331
 
329
332
  - \`features/todos/contracts.ts\` owns the HTTP contract and reuses shared feature schemas.
330
333
  - \`features/todos/schemas.ts\` owns shared DTO and validation schemas used by contracts, use cases, ports, tests, and clients.