@domain-first/project-structure 7.2.0 → 8.1.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 (66) hide show
  1. package/README.md +125 -26
  2. package/dist/201.js +87 -338
  3. package/dist/287.js +1235 -575
  4. package/dist/561.js +519 -0
  5. package/dist/711.js +22 -0
  6. package/dist/870.js +438 -0
  7. package/dist/agent-cli.d.ts +379 -0
  8. package/dist/agent-cli.spec.d.ts +1 -0
  9. package/dist/agent-identifiers.d.ts +4 -0
  10. package/dist/agent-requests.d.ts +490 -0
  11. package/dist/config-file.d.ts +231 -26
  12. package/dist/config-file.spec.d.ts +1 -0
  13. package/dist/context-dependencies.d.ts +16 -0
  14. package/dist/dependency-rules.d.ts +17 -17
  15. package/dist/file-system.d.ts +10 -1
  16. package/dist/implementation-choices.d.ts +8 -0
  17. package/dist/implementation-choices.spec.d.ts +1 -0
  18. package/dist/implementation-options-schema.d.ts +14 -0
  19. package/dist/index.cjs +3645 -584
  20. package/dist/index.js +20 -7
  21. package/dist/init.cjs +717 -122
  22. package/dist/init.js +24 -12
  23. package/dist/integration.cjs +3783 -186
  24. package/dist/integration.js +29 -17
  25. package/dist/integrations/rest-endpoint-generator.d.ts +4 -2
  26. package/dist/integrations/storybook.d.ts +1 -0
  27. package/dist/interaction.d.ts +41 -0
  28. package/dist/lint.cjs +165 -41
  29. package/dist/lint.js +22 -7
  30. package/dist/module-move.d.ts +6 -2
  31. package/dist/next-app.d.ts +7 -0
  32. package/dist/react-module-move.d.ts +17 -2
  33. package/dist/react.cjs +5181 -421
  34. package/dist/react.js +72 -60
  35. package/dist/system-implementations.d.ts +6 -0
  36. package/dist/upgrade-steps.d.ts +81 -0
  37. package/dist/upgrade-steps.spec.d.ts +1 -0
  38. package/dist/upgrade.cjs +593 -0
  39. package/dist/upgrade.d.ts +2 -0
  40. package/dist/upgrade.js +235 -0
  41. package/dist/use-cases/add-integration.d.ts +16 -1
  42. package/dist/use-cases/cross-context-dependencies.spec.d.ts +1 -0
  43. package/dist/use-cases/initialize.d.ts +4 -4
  44. package/dist/use-cases/initialize.spec.d.ts +1 -0
  45. package/dist/use-cases/prompt-implementation-type.d.ts +20 -0
  46. package/dist/use-cases/scaffold-react-page.d.ts +3 -1
  47. package/dist/wire-branches.d.ts +26 -0
  48. package/dist/wiring.d.ts +3 -2
  49. package/package.json +3 -2
  50. package/skills/df-ps-implement/SKILL.md +9 -8
  51. package/skills/df-ps-plan-feature/SKILL.md +8 -7
  52. package/skills/df-ps-react/SKILL.md +14 -8
  53. package/skills/df-ps-react/references/generators.md +6 -2
  54. package/skills/df-ps-scaffold/SKILL.md +28 -17
  55. package/skills/df-ps-scaffold/references/agent-mode.md +72 -0
  56. package/skills/df-ps-scaffold/references/agent-operations.md +155 -0
  57. package/skills/df-ps-scaffold/references/choosing-components.md +13 -13
  58. package/skills/df-ps-scaffold/references/generators.md +20 -3
  59. package/skills/df-ps-scaffold/references/units/aggregate.md +4 -3
  60. package/skills/df-ps-scaffold/references/units/bounded-context.md +1 -1
  61. package/skills/df-ps-scaffold/references/units/command-query.md +12 -12
  62. package/skills/df-ps-scaffold/references/units/implementation.md +2 -2
  63. package/skills/df-ps-scaffold/references/units/move-or-rename.md +1 -1
  64. package/skills/df-ps-scaffold/references/units/port.md +7 -4
  65. package/skills/df-ps-scaffold/references/units/use-case.md +1 -1
  66. package/skills/df-ps-scaffold/scripts/drive.mjs +9 -1
@@ -0,0 +1,379 @@
1
+ import z from 'zod';
2
+ import { type AgentCommand } from './agent-requests';
3
+ export type AgentRequest = {
4
+ operation: string;
5
+ context?: string;
6
+ name?: string;
7
+ module?: string;
8
+ aggregate?: string;
9
+ namespace?: string;
10
+ targetContext?: string;
11
+ controller?: string;
12
+ withRepository?: boolean;
13
+ dryRun?: boolean;
14
+ overwrite?: boolean;
15
+ dependencies?: Record<string, string[]>;
16
+ scriptConflicts?: Record<string, string>;
17
+ scriptNames?: Record<string, string>;
18
+ [key: string]: unknown;
19
+ };
20
+ /** Schema and selectable IDs use the same scanners and dependency rules as the menus. */
21
+ export declare const describeAgentCommand: (command: AgentCommand) => {
22
+ schemaVersion: number;
23
+ command: AgentCommand;
24
+ requestSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodDiscriminatedUnion<[z.ZodObject<{
25
+ operation: z.ZodLiteral<"bounded-context">;
26
+ name: z.ZodString;
27
+ overwrite: z.ZodOptional<z.ZodBoolean>;
28
+ dryRun: z.ZodOptional<z.ZodBoolean>;
29
+ }, z.core.$strict>, z.ZodObject<{
30
+ operation: z.ZodLiteral<"aggregate">;
31
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
32
+ withRepository: z.ZodOptional<z.ZodBoolean>;
33
+ implementation: z.ZodOptional<z.ZodObject<{
34
+ type: z.ZodString;
35
+ save: z.ZodOptional<z.ZodBoolean>;
36
+ }, z.core.$strict>>;
37
+ testImplementation: z.ZodOptional<z.ZodObject<{
38
+ type: z.ZodString;
39
+ save: z.ZodOptional<z.ZodBoolean>;
40
+ }, z.core.$strict>>;
41
+ name: z.ZodString;
42
+ context: z.ZodString;
43
+ overwrite: z.ZodOptional<z.ZodBoolean>;
44
+ dryRun: z.ZodOptional<z.ZodBoolean>;
45
+ }, z.core.$strict>, z.ZodObject<{
46
+ operation: z.ZodLiteral<"entity">;
47
+ aggregate: z.ZodOptional<z.ZodString>;
48
+ name: z.ZodString;
49
+ context: z.ZodString;
50
+ overwrite: z.ZodOptional<z.ZodBoolean>;
51
+ dryRun: z.ZodOptional<z.ZodBoolean>;
52
+ }, z.core.$strict>, z.ZodObject<{
53
+ operation: z.ZodLiteral<"value-object">;
54
+ aggregate: z.ZodOptional<z.ZodString>;
55
+ name: z.ZodString;
56
+ context: z.ZodString;
57
+ overwrite: z.ZodOptional<z.ZodBoolean>;
58
+ dryRun: z.ZodOptional<z.ZodBoolean>;
59
+ }, z.core.$strict>, z.ZodObject<{
60
+ operation: z.ZodLiteral<"error">;
61
+ namespace: z.ZodOptional<z.ZodString>;
62
+ name: z.ZodString;
63
+ context: z.ZodString;
64
+ overwrite: z.ZodOptional<z.ZodBoolean>;
65
+ dryRun: z.ZodOptional<z.ZodBoolean>;
66
+ }, z.core.$strict>, z.ZodObject<{
67
+ operation: z.ZodLiteral<"error-namespace">;
68
+ name: z.ZodString;
69
+ context: z.ZodString;
70
+ overwrite: z.ZodOptional<z.ZodBoolean>;
71
+ dryRun: z.ZodOptional<z.ZodBoolean>;
72
+ }, z.core.$strict>, z.ZodObject<{
73
+ operation: z.ZodLiteral<"domain-service">;
74
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
75
+ name: z.ZodString;
76
+ context: z.ZodString;
77
+ overwrite: z.ZodOptional<z.ZodBoolean>;
78
+ dryRun: z.ZodOptional<z.ZodBoolean>;
79
+ }, z.core.$strict>, z.ZodObject<{
80
+ operation: z.ZodLiteral<"application-service">;
81
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
82
+ name: z.ZodString;
83
+ context: z.ZodString;
84
+ overwrite: z.ZodOptional<z.ZodBoolean>;
85
+ dryRun: z.ZodOptional<z.ZodBoolean>;
86
+ }, z.core.$strict>, z.ZodObject<{
87
+ operation: z.ZodLiteral<"infrastructure-service">;
88
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
89
+ name: z.ZodString;
90
+ context: z.ZodString;
91
+ overwrite: z.ZodOptional<z.ZodBoolean>;
92
+ dryRun: z.ZodOptional<z.ZodBoolean>;
93
+ }, z.core.$strict>, z.ZodObject<{
94
+ operation: z.ZodLiteral<"presentation-service">;
95
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
96
+ name: z.ZodString;
97
+ context: z.ZodString;
98
+ overwrite: z.ZodOptional<z.ZodBoolean>;
99
+ dryRun: z.ZodOptional<z.ZodBoolean>;
100
+ }, z.core.$strict>, z.ZodObject<{
101
+ operation: z.ZodLiteral<"use-case">;
102
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
103
+ name: z.ZodString;
104
+ context: z.ZodString;
105
+ overwrite: z.ZodOptional<z.ZodBoolean>;
106
+ dryRun: z.ZodOptional<z.ZodBoolean>;
107
+ }, z.core.$strict>, z.ZodObject<{
108
+ operation: z.ZodLiteral<"command">;
109
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
110
+ implementation: z.ZodObject<{
111
+ type: z.ZodString;
112
+ save: z.ZodOptional<z.ZodBoolean>;
113
+ }, z.core.$strict>;
114
+ testImplementation: z.ZodOptional<z.ZodObject<{
115
+ type: z.ZodString;
116
+ save: z.ZodOptional<z.ZodBoolean>;
117
+ }, z.core.$strict>>;
118
+ name: z.ZodString;
119
+ context: z.ZodString;
120
+ overwrite: z.ZodOptional<z.ZodBoolean>;
121
+ dryRun: z.ZodOptional<z.ZodBoolean>;
122
+ }, z.core.$strict>, z.ZodObject<{
123
+ operation: z.ZodLiteral<"query">;
124
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
125
+ implementation: z.ZodObject<{
126
+ type: z.ZodString;
127
+ save: z.ZodOptional<z.ZodBoolean>;
128
+ }, z.core.$strict>;
129
+ testImplementation: z.ZodOptional<z.ZodObject<{
130
+ type: z.ZodString;
131
+ save: z.ZodOptional<z.ZodBoolean>;
132
+ }, z.core.$strict>>;
133
+ name: z.ZodString;
134
+ context: z.ZodString;
135
+ overwrite: z.ZodOptional<z.ZodBoolean>;
136
+ dryRun: z.ZodOptional<z.ZodBoolean>;
137
+ }, z.core.$strict>, z.ZodObject<{
138
+ operation: z.ZodLiteral<"port">;
139
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
140
+ implementation: z.ZodObject<{
141
+ type: z.ZodString;
142
+ save: z.ZodOptional<z.ZodBoolean>;
143
+ }, z.core.$strict>;
144
+ testImplementation: z.ZodOptional<z.ZodObject<{
145
+ type: z.ZodString;
146
+ save: z.ZodOptional<z.ZodBoolean>;
147
+ }, z.core.$strict>>;
148
+ name: z.ZodString;
149
+ context: z.ZodString;
150
+ overwrite: z.ZodOptional<z.ZodBoolean>;
151
+ dryRun: z.ZodOptional<z.ZodBoolean>;
152
+ }, z.core.$strict>, z.ZodObject<{
153
+ operation: z.ZodLiteral<"implementation">;
154
+ dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
155
+ contract: z.ZodString;
156
+ implementation: z.ZodObject<{
157
+ type: z.ZodString;
158
+ save: z.ZodOptional<z.ZodBoolean>;
159
+ }, z.core.$strict>;
160
+ environments: z.ZodOptional<z.ZodArray<z.ZodString>>;
161
+ context: z.ZodString;
162
+ overwrite: z.ZodOptional<z.ZodBoolean>;
163
+ dryRun: z.ZodOptional<z.ZodBoolean>;
164
+ }, z.core.$strict>, z.ZodObject<{
165
+ operation: z.ZodLiteral<"endpoint">;
166
+ controller: z.ZodString;
167
+ method: z.ZodEnum<{
168
+ get: "get";
169
+ post: "post";
170
+ put: "put";
171
+ patch: "patch";
172
+ delete: "delete";
173
+ }>;
174
+ path: z.ZodString;
175
+ handler: z.ZodOptional<z.ZodString>;
176
+ context: z.ZodString;
177
+ overwrite: z.ZodOptional<z.ZodBoolean>;
178
+ dryRun: z.ZodOptional<z.ZodBoolean>;
179
+ }, z.core.$strict>, z.ZodObject<{
180
+ operation: z.ZodLiteral<"wire-dependency">;
181
+ module: z.ZodString;
182
+ dependencies: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
183
+ context: z.ZodString;
184
+ overwrite: z.ZodOptional<z.ZodBoolean>;
185
+ dryRun: z.ZodOptional<z.ZodBoolean>;
186
+ }, z.core.$strict>, z.ZodObject<{
187
+ operation: z.ZodLiteral<"move">;
188
+ module: z.ZodString;
189
+ targetContext: z.ZodOptional<z.ZodString>;
190
+ name: z.ZodOptional<z.ZodString>;
191
+ aggregate: z.ZodOptional<z.ZodString>;
192
+ context: z.ZodString;
193
+ overwrite: z.ZodOptional<z.ZodBoolean>;
194
+ dryRun: z.ZodOptional<z.ZodBoolean>;
195
+ }, z.core.$strict>], "operation"> | z.ZodDiscriminatedUnion<[z.ZodObject<{
196
+ operation: z.ZodLiteral<"page">;
197
+ name: z.ZodString;
198
+ overwrite: z.ZodOptional<z.ZodBoolean>;
199
+ dryRun: z.ZodOptional<z.ZodBoolean>;
200
+ }, z.core.$strict>, z.ZodObject<{
201
+ operation: z.ZodLiteral<"widget">;
202
+ name: z.ZodString;
203
+ widgetType: z.ZodOptional<z.ZodEnum<{
204
+ monolithic: "monolithic";
205
+ separated: "separated";
206
+ headless: "headless";
207
+ }>>;
208
+ overwrite: z.ZodOptional<z.ZodBoolean>;
209
+ dryRun: z.ZodOptional<z.ZodBoolean>;
210
+ }, z.core.$strict>, z.ZodObject<{
211
+ operation: z.ZodLiteral<"ui-kit-component">;
212
+ name: z.ZodString;
213
+ overwrite: z.ZodOptional<z.ZodBoolean>;
214
+ dryRun: z.ZodOptional<z.ZodBoolean>;
215
+ }, z.core.$strict>, z.ZodObject<{
216
+ operation: z.ZodLiteral<"shared-hook">;
217
+ name: z.ZodString;
218
+ overwrite: z.ZodOptional<z.ZodBoolean>;
219
+ dryRun: z.ZodOptional<z.ZodBoolean>;
220
+ }, z.core.$strict>, z.ZodObject<{
221
+ operation: z.ZodLiteral<"move-page">;
222
+ module: z.ZodString;
223
+ name: z.ZodString;
224
+ moveRoute: z.ZodOptional<z.ZodBoolean>;
225
+ overwrite: z.ZodOptional<z.ZodBoolean>;
226
+ dryRun: z.ZodOptional<z.ZodBoolean>;
227
+ }, z.core.$strict>, z.ZodObject<{
228
+ operation: z.ZodLiteral<"move-widget">;
229
+ module: z.ZodString;
230
+ name: z.ZodString;
231
+ overwrite: z.ZodOptional<z.ZodBoolean>;
232
+ dryRun: z.ZodOptional<z.ZodBoolean>;
233
+ }, z.core.$strict>], "operation"> | z.ZodObject<{
234
+ operation: z.ZodLiteral<"add">;
235
+ integrations: z.ZodArray<z.ZodEnum<{
236
+ openapi: "openapi";
237
+ orval: "orval";
238
+ prisma: "prisma";
239
+ "rest-endpoint-generator": "rest-endpoint-generator";
240
+ storybook: "storybook";
241
+ vitest: "vitest";
242
+ testcontainers: "testcontainers";
243
+ "in-memory-db": "in-memory-db";
244
+ playwright: "playwright";
245
+ }>>;
246
+ nextAdapter: z.ZodOptional<z.ZodBoolean>;
247
+ configureReact: z.ZodOptional<z.ZodBoolean>;
248
+ replaceTestingLibrary: z.ZodOptional<z.ZodBoolean>;
249
+ withService: z.ZodOptional<z.ZodBoolean>;
250
+ routePrefix: z.ZodOptional<z.ZodString>;
251
+ openapiPath: z.ZodOptional<z.ZodString>;
252
+ withExtractor: z.ZodOptional<z.ZodBoolean>;
253
+ swaggerPage: z.ZodOptional<z.ZodBoolean>;
254
+ targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
255
+ hooks: "hooks";
256
+ client: "client";
257
+ }>>>;
258
+ scriptConflicts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
259
+ replace: "replace";
260
+ rename: "rename";
261
+ keep: "keep";
262
+ }>>>;
263
+ scriptNames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
264
+ overwrite: z.ZodOptional<z.ZodBoolean>;
265
+ dryRun: z.ZodOptional<z.ZodBoolean>;
266
+ }, z.core.$strict>>;
267
+ project: {
268
+ root: string;
269
+ configured: boolean;
270
+ configStatus: string;
271
+ config: {
272
+ [x: string]: unknown;
273
+ project: {
274
+ [x: string]: unknown;
275
+ rootFolder: string;
276
+ };
277
+ backend?: {
278
+ [x: string]: unknown;
279
+ domainFirstPackages: ("@domain-first/types" | "@domain-first/errors" | "@domain-first/handlers" | "@domain-first/wire" | "@domain-first/handlers-rest")[];
280
+ envBranches?: {
281
+ names: string[];
282
+ test?: string | undefined;
283
+ } | undefined;
284
+ withInMemoryDb?: boolean | undefined;
285
+ testingLibrary?: string | undefined;
286
+ implementations?: Partial<Record<"queries" | "commands" | "repositories" | "ports", {
287
+ primary: string[];
288
+ test: string[];
289
+ }>> | undefined;
290
+ rules?: {
291
+ dependencies?: Partial<Record<"queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services", ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | {
292
+ add?: ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | undefined;
293
+ remove?: ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | undefined;
294
+ }>> | undefined;
295
+ lint?: Partial<Record<"context-isolation" | "shared-kernel" | "layers" | "dependencies" | "react" | "clock", boolean>> | undefined;
296
+ } | undefined;
297
+ } | undefined;
298
+ frontend?: {
299
+ [x: string]: unknown;
300
+ react?: {
301
+ [x: string]: unknown;
302
+ framework?: "react" | "next" | undefined;
303
+ storybookFramework?: string | undefined;
304
+ } | undefined;
305
+ } | undefined;
306
+ } | undefined;
307
+ contexts: {
308
+ name: string;
309
+ units: {
310
+ id: string;
311
+ kind: import("./backend-module-move").BackendUnitKind;
312
+ name: string;
313
+ aggregate: string | undefined;
314
+ implementations: string[];
315
+ }[];
316
+ contracts: {
317
+ id: string;
318
+ kind: import("./backend-module-move").BackendUnitKind;
319
+ implementations: string[];
320
+ }[];
321
+ modules: {
322
+ id: string;
323
+ kind: string;
324
+ file: string;
325
+ implementations: {
326
+ className: string;
327
+ target: string;
328
+ dependencies: string[];
329
+ }[];
330
+ }[];
331
+ implementationTypes: {
332
+ [k: string]: {
333
+ primary: string[];
334
+ test: string[];
335
+ system: {
336
+ name: string;
337
+ value: string;
338
+ }[];
339
+ };
340
+ } | undefined;
341
+ }[];
342
+ integrations: {
343
+ id: "openapi" | "orval" | "prisma" | "rest-endpoint-generator" | "storybook" | "vitest" | "testcontainers" | "in-memory-db" | "playwright";
344
+ name: string;
345
+ group: "backend" | "frontend";
346
+ available: boolean;
347
+ }[];
348
+ reactModules: {
349
+ kind: string;
350
+ name: string;
351
+ file: string;
352
+ }[];
353
+ } | null;
354
+ };
355
+ export declare const executeAgentRequest: (command: AgentCommand, value: unknown) => Promise<{
356
+ messages: string[];
357
+ schemaVersion: number;
358
+ ok: boolean;
359
+ operation: string;
360
+ dryRun: boolean;
361
+ files: {
362
+ created: string[];
363
+ updated: string[];
364
+ deleted: string[];
365
+ };
366
+ directories: string[];
367
+ overwriteRequired: string[];
368
+ nextSteps: string[];
369
+ }>;
370
+ export declare const agentError: (error: unknown) => {
371
+ schemaVersion: number;
372
+ ok: boolean;
373
+ error: {
374
+ details?: {} | undefined;
375
+ code: string;
376
+ message: string;
377
+ };
378
+ };
379
+ export declare const runCLI: (command: AgentCommand, interactive: () => Promise<unknown>) => Promise<void>;
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,4 @@
1
+ import type { BackendUnit } from './backend-module-move';
2
+ import type { WiredModule } from './wiring';
3
+ export declare const moduleId: (module: WiredModule) => string;
4
+ export declare const unitId: (unit: BackendUnit) => string;