@domain-first/project-structure 7.1.1 → 8.0.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 (71) hide show
  1. package/README.md +128 -25
  2. package/dist/201.js +146 -342
  3. package/dist/287.js +1304 -568
  4. package/dist/561.js +518 -0
  5. package/dist/711.js +22 -0
  6. package/dist/870.js +438 -0
  7. package/dist/agent-cli.d.ts +378 -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 +488 -0
  11. package/dist/backend-module-move.d.ts +1 -0
  12. package/dist/config-file.d.ts +231 -26
  13. package/dist/config-file.spec.d.ts +1 -0
  14. package/dist/context-dependencies.d.ts +16 -0
  15. package/dist/dependency-rules.d.ts +17 -17
  16. package/dist/file-system.d.ts +10 -1
  17. package/dist/implementation-choices.d.ts +8 -0
  18. package/dist/implementation-choices.spec.d.ts +1 -0
  19. package/dist/implementation-options-schema.d.ts +14 -0
  20. package/dist/implementations.d.ts +48 -0
  21. package/dist/index.cjs +3768 -574
  22. package/dist/index.js +25 -9
  23. package/dist/init.cjs +717 -122
  24. package/dist/init.js +24 -12
  25. package/dist/integration.cjs +3737 -186
  26. package/dist/integration.js +29 -17
  27. package/dist/integrations/rest-endpoint-generator.d.ts +4 -2
  28. package/dist/integrations/storybook.d.ts +1 -0
  29. package/dist/interaction.d.ts +41 -0
  30. package/dist/lint.cjs +173 -46
  31. package/dist/lint.js +22 -7
  32. package/dist/next-app.d.ts +7 -0
  33. package/dist/react.cjs +5128 -414
  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/index.d.ts +1 -0
  44. package/dist/use-cases/initialize.d.ts +4 -4
  45. package/dist/use-cases/initialize.spec.d.ts +1 -0
  46. package/dist/use-cases/prompt-implementation-type.d.ts +20 -0
  47. package/dist/use-cases/scaffold-new-aggregate.d.ts +1 -1
  48. package/dist/use-cases/scaffold-new-implementation.d.ts +6 -0
  49. package/dist/use-cases/scaffold-new-implementation.spec.d.ts +1 -0
  50. package/dist/use-cases/scaffold-react-page.d.ts +3 -1
  51. package/dist/use-cases/wire-dependency.d.ts +5 -0
  52. package/dist/wire-branches.d.ts +26 -0
  53. package/dist/wiring.d.ts +24 -2
  54. package/package.json +3 -2
  55. package/skills/df-ps-implement/SKILL.md +9 -8
  56. package/skills/df-ps-plan-feature/SKILL.md +8 -7
  57. package/skills/df-ps-react/SKILL.md +13 -7
  58. package/skills/df-ps-react/references/generators.md +6 -2
  59. package/skills/df-ps-scaffold/SKILL.md +31 -19
  60. package/skills/df-ps-scaffold/references/agent-mode.md +72 -0
  61. package/skills/df-ps-scaffold/references/agent-operations.md +155 -0
  62. package/skills/df-ps-scaffold/references/choosing-components.md +14 -13
  63. package/skills/df-ps-scaffold/references/generators.md +20 -3
  64. package/skills/df-ps-scaffold/references/units/aggregate.md +4 -3
  65. package/skills/df-ps-scaffold/references/units/bounded-context.md +1 -1
  66. package/skills/df-ps-scaffold/references/units/command-query.md +12 -12
  67. package/skills/df-ps-scaffold/references/units/implementation.md +20 -0
  68. package/skills/df-ps-scaffold/references/units/move-or-rename.md +1 -1
  69. package/skills/df-ps-scaffold/references/units/port.md +7 -4
  70. package/skills/df-ps-scaffold/references/units/use-case.md +1 -1
  71. package/skills/df-ps-scaffold/scripts/drive.mjs +9 -1
@@ -0,0 +1,378 @@
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
+ overwrite: z.ZodOptional<z.ZodBoolean>;
225
+ dryRun: z.ZodOptional<z.ZodBoolean>;
226
+ }, z.core.$strict>, z.ZodObject<{
227
+ operation: z.ZodLiteral<"move-widget">;
228
+ module: z.ZodString;
229
+ name: z.ZodString;
230
+ overwrite: z.ZodOptional<z.ZodBoolean>;
231
+ dryRun: z.ZodOptional<z.ZodBoolean>;
232
+ }, z.core.$strict>], "operation"> | z.ZodObject<{
233
+ operation: z.ZodLiteral<"add">;
234
+ integrations: z.ZodArray<z.ZodEnum<{
235
+ openapi: "openapi";
236
+ orval: "orval";
237
+ prisma: "prisma";
238
+ "rest-endpoint-generator": "rest-endpoint-generator";
239
+ storybook: "storybook";
240
+ vitest: "vitest";
241
+ testcontainers: "testcontainers";
242
+ "in-memory-db": "in-memory-db";
243
+ playwright: "playwright";
244
+ }>>;
245
+ nextAdapter: z.ZodOptional<z.ZodBoolean>;
246
+ configureReact: z.ZodOptional<z.ZodBoolean>;
247
+ replaceTestingLibrary: z.ZodOptional<z.ZodBoolean>;
248
+ withService: z.ZodOptional<z.ZodBoolean>;
249
+ routePrefix: z.ZodOptional<z.ZodString>;
250
+ openapiPath: z.ZodOptional<z.ZodString>;
251
+ withExtractor: z.ZodOptional<z.ZodBoolean>;
252
+ swaggerPage: z.ZodOptional<z.ZodBoolean>;
253
+ targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
254
+ hooks: "hooks";
255
+ client: "client";
256
+ }>>>;
257
+ scriptConflicts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
258
+ replace: "replace";
259
+ rename: "rename";
260
+ keep: "keep";
261
+ }>>>;
262
+ scriptNames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
263
+ overwrite: z.ZodOptional<z.ZodBoolean>;
264
+ dryRun: z.ZodOptional<z.ZodBoolean>;
265
+ }, z.core.$strict>>;
266
+ project: {
267
+ root: string;
268
+ configured: boolean;
269
+ configStatus: string;
270
+ config: {
271
+ [x: string]: unknown;
272
+ project: {
273
+ [x: string]: unknown;
274
+ rootFolder: string;
275
+ };
276
+ backend?: {
277
+ [x: string]: unknown;
278
+ domainFirstPackages: ("@domain-first/types" | "@domain-first/errors" | "@domain-first/handlers" | "@domain-first/wire" | "@domain-first/handlers-rest")[];
279
+ envBranches?: {
280
+ names: string[];
281
+ test?: string | undefined;
282
+ } | undefined;
283
+ withInMemoryDb?: boolean | undefined;
284
+ testingLibrary?: string | undefined;
285
+ implementations?: Partial<Record<"queries" | "commands" | "repositories" | "ports", {
286
+ primary: string[];
287
+ test: string[];
288
+ }>> | undefined;
289
+ rules?: {
290
+ 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")[] | {
291
+ add?: ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | undefined;
292
+ remove?: ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | undefined;
293
+ }>> | undefined;
294
+ lint?: Partial<Record<"context-isolation" | "shared-kernel" | "layers" | "dependencies" | "react" | "clock", boolean>> | undefined;
295
+ } | undefined;
296
+ } | undefined;
297
+ frontend?: {
298
+ [x: string]: unknown;
299
+ react?: {
300
+ [x: string]: unknown;
301
+ framework?: "react" | "next" | undefined;
302
+ storybookFramework?: string | undefined;
303
+ } | undefined;
304
+ } | undefined;
305
+ } | undefined;
306
+ contexts: {
307
+ name: string;
308
+ units: {
309
+ id: string;
310
+ kind: import("./backend-module-move").BackendUnitKind;
311
+ name: string;
312
+ aggregate: string | undefined;
313
+ implementations: string[];
314
+ }[];
315
+ contracts: {
316
+ id: string;
317
+ kind: import("./backend-module-move").BackendUnitKind;
318
+ implementations: string[];
319
+ }[];
320
+ modules: {
321
+ id: string;
322
+ kind: string;
323
+ file: string;
324
+ implementations: {
325
+ className: string;
326
+ target: string;
327
+ dependencies: string[];
328
+ }[];
329
+ }[];
330
+ implementationTypes: {
331
+ [k: string]: {
332
+ primary: string[];
333
+ test: string[];
334
+ system: {
335
+ name: string;
336
+ value: string;
337
+ }[];
338
+ };
339
+ } | undefined;
340
+ }[];
341
+ integrations: {
342
+ id: "openapi" | "orval" | "prisma" | "rest-endpoint-generator" | "storybook" | "vitest" | "testcontainers" | "in-memory-db" | "playwright";
343
+ name: string;
344
+ group: "backend" | "frontend";
345
+ available: boolean;
346
+ }[];
347
+ reactModules: {
348
+ kind: string;
349
+ name: string;
350
+ file: string;
351
+ }[];
352
+ } | null;
353
+ };
354
+ export declare const executeAgentRequest: (command: AgentCommand, value: unknown) => Promise<{
355
+ messages: string[];
356
+ schemaVersion: number;
357
+ ok: boolean;
358
+ operation: string;
359
+ dryRun: boolean;
360
+ files: {
361
+ created: string[];
362
+ updated: string[];
363
+ deleted: string[];
364
+ };
365
+ directories: string[];
366
+ overwriteRequired: string[];
367
+ nextSteps: string[];
368
+ }>;
369
+ export declare const agentError: (error: unknown) => {
370
+ schemaVersion: number;
371
+ ok: boolean;
372
+ error: {
373
+ details?: {} | undefined;
374
+ code: string;
375
+ message: string;
376
+ };
377
+ };
378
+ 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;