@zigrivers/scaffold 3.4.1 → 3.5.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 (194) hide show
  1. package/README.md +91 -0
  2. package/content/knowledge/game/game-accessibility.md +328 -0
  3. package/content/knowledge/game/game-ai-patterns.md +542 -0
  4. package/content/knowledge/game/game-asset-pipeline.md +359 -0
  5. package/content/knowledge/game/game-audio-design.md +342 -0
  6. package/content/knowledge/game/game-binary-vcs-strategy.md +396 -0
  7. package/content/knowledge/game/game-design-document.md +260 -0
  8. package/content/knowledge/game/game-domain-patterns.md +297 -0
  9. package/content/knowledge/game/game-economy-design.md +355 -0
  10. package/content/knowledge/game/game-engine-selection.md +242 -0
  11. package/content/knowledge/game/game-input-systems.md +357 -0
  12. package/content/knowledge/game/game-level-content-design.md +455 -0
  13. package/content/knowledge/game/game-liveops-analytics.md +280 -0
  14. package/content/knowledge/game/game-localization.md +323 -0
  15. package/content/knowledge/game/game-milestone-definitions.md +337 -0
  16. package/content/knowledge/game/game-modding-ugc.md +390 -0
  17. package/content/knowledge/game/game-narrative-design.md +404 -0
  18. package/content/knowledge/game/game-networking.md +391 -0
  19. package/content/knowledge/game/game-performance-budgeting.md +378 -0
  20. package/content/knowledge/game/game-platform-certification.md +417 -0
  21. package/content/knowledge/game/game-project-structure.md +360 -0
  22. package/content/knowledge/game/game-save-systems.md +452 -0
  23. package/content/knowledge/game/game-testing-strategy.md +470 -0
  24. package/content/knowledge/game/game-ui-patterns.md +475 -0
  25. package/content/knowledge/game/game-vr-ar-design.md +313 -0
  26. package/content/knowledge/review/review-art-bible.md +305 -0
  27. package/content/knowledge/review/review-game-design.md +303 -0
  28. package/content/knowledge/review/review-game-economy.md +272 -0
  29. package/content/knowledge/review/review-netcode.md +280 -0
  30. package/content/knowledge/review/review-platform-cert.md +341 -0
  31. package/content/methodology/custom-defaults.yml +25 -0
  32. package/content/methodology/deep.yml +25 -0
  33. package/content/methodology/game-overlay.yml +145 -0
  34. package/content/methodology/mvp.yml +25 -0
  35. package/content/pipeline/architecture/ai-behavior-design.md +87 -0
  36. package/content/pipeline/architecture/netcode-spec.md +86 -0
  37. package/content/pipeline/architecture/review-netcode.md +78 -0
  38. package/content/pipeline/foundation/performance-budgets.md +91 -0
  39. package/content/pipeline/modeling/narrative-bible.md +84 -0
  40. package/content/pipeline/pre/game-design-document.md +89 -0
  41. package/content/pipeline/pre/review-gdd.md +74 -0
  42. package/content/pipeline/quality/analytics-telemetry.md +98 -0
  43. package/content/pipeline/quality/live-ops-plan.md +99 -0
  44. package/content/pipeline/quality/platform-cert-prep.md +129 -0
  45. package/content/pipeline/quality/playtest-plan.md +83 -0
  46. package/content/pipeline/specification/art-bible.md +87 -0
  47. package/content/pipeline/specification/audio-design.md +96 -0
  48. package/content/pipeline/specification/content-structure-design.md +141 -0
  49. package/content/pipeline/specification/economy-design.md +104 -0
  50. package/content/pipeline/specification/game-accessibility.md +82 -0
  51. package/content/pipeline/specification/game-ui-spec.md +97 -0
  52. package/content/pipeline/specification/input-controls-spec.md +81 -0
  53. package/content/pipeline/specification/localization-plan.md +113 -0
  54. package/content/pipeline/specification/modding-ugc-spec.md +116 -0
  55. package/content/pipeline/specification/online-services-spec.md +104 -0
  56. package/content/pipeline/specification/review-economy.md +87 -0
  57. package/content/pipeline/specification/review-game-ui.md +73 -0
  58. package/content/pipeline/specification/save-system-spec.md +116 -0
  59. package/dist/cli/commands/adopt.d.ts.map +1 -1
  60. package/dist/cli/commands/adopt.js +25 -0
  61. package/dist/cli/commands/adopt.js.map +1 -1
  62. package/dist/cli/commands/adopt.test.js +28 -1
  63. package/dist/cli/commands/adopt.test.js.map +1 -1
  64. package/dist/cli/commands/build.test.js +3 -0
  65. package/dist/cli/commands/build.test.js.map +1 -1
  66. package/dist/cli/commands/init.d.ts +1 -0
  67. package/dist/cli/commands/init.d.ts.map +1 -1
  68. package/dist/cli/commands/init.js +6 -0
  69. package/dist/cli/commands/init.js.map +1 -1
  70. package/dist/cli/commands/init.test.js +12 -1
  71. package/dist/cli/commands/init.test.js.map +1 -1
  72. package/dist/cli/commands/knowledge.test.js +8 -0
  73. package/dist/cli/commands/knowledge.test.js.map +1 -1
  74. package/dist/cli/commands/next.d.ts.map +1 -1
  75. package/dist/cli/commands/next.js +19 -5
  76. package/dist/cli/commands/next.js.map +1 -1
  77. package/dist/cli/commands/next.test.js +56 -0
  78. package/dist/cli/commands/next.test.js.map +1 -1
  79. package/dist/cli/commands/rework.d.ts.map +1 -1
  80. package/dist/cli/commands/rework.js +11 -2
  81. package/dist/cli/commands/rework.js.map +1 -1
  82. package/dist/cli/commands/rework.test.js +5 -0
  83. package/dist/cli/commands/rework.test.js.map +1 -1
  84. package/dist/cli/commands/run.d.ts.map +1 -1
  85. package/dist/cli/commands/run.js +54 -4
  86. package/dist/cli/commands/run.js.map +1 -1
  87. package/dist/cli/commands/run.test.js +384 -0
  88. package/dist/cli/commands/run.test.js.map +1 -1
  89. package/dist/cli/commands/skip.test.js +3 -0
  90. package/dist/cli/commands/skip.test.js.map +1 -1
  91. package/dist/cli/commands/status.d.ts.map +1 -1
  92. package/dist/cli/commands/status.js +16 -3
  93. package/dist/cli/commands/status.js.map +1 -1
  94. package/dist/cli/commands/status.test.js +55 -0
  95. package/dist/cli/commands/status.test.js.map +1 -1
  96. package/dist/cli/output/auto.d.ts +3 -0
  97. package/dist/cli/output/auto.d.ts.map +1 -1
  98. package/dist/cli/output/auto.js +9 -0
  99. package/dist/cli/output/auto.js.map +1 -1
  100. package/dist/cli/output/context.d.ts +6 -0
  101. package/dist/cli/output/context.d.ts.map +1 -1
  102. package/dist/cli/output/context.js.map +1 -1
  103. package/dist/cli/output/context.test.js +87 -0
  104. package/dist/cli/output/context.test.js.map +1 -1
  105. package/dist/cli/output/error-display.test.js +3 -0
  106. package/dist/cli/output/error-display.test.js.map +1 -1
  107. package/dist/cli/output/interactive.d.ts +3 -0
  108. package/dist/cli/output/interactive.d.ts.map +1 -1
  109. package/dist/cli/output/interactive.js +76 -0
  110. package/dist/cli/output/interactive.js.map +1 -1
  111. package/dist/cli/output/json.d.ts +3 -0
  112. package/dist/cli/output/json.d.ts.map +1 -1
  113. package/dist/cli/output/json.js +9 -0
  114. package/dist/cli/output/json.js.map +1 -1
  115. package/dist/config/loader.d.ts.map +1 -1
  116. package/dist/config/loader.js +3 -2
  117. package/dist/config/loader.js.map +1 -1
  118. package/dist/config/schema.d.ts +641 -15
  119. package/dist/config/schema.d.ts.map +1 -1
  120. package/dist/config/schema.js +26 -1
  121. package/dist/config/schema.js.map +1 -1
  122. package/dist/config/schema.test.js +192 -1
  123. package/dist/config/schema.test.js.map +1 -1
  124. package/dist/core/assembly/overlay-loader.d.ts +24 -0
  125. package/dist/core/assembly/overlay-loader.d.ts.map +1 -0
  126. package/dist/core/assembly/overlay-loader.js +190 -0
  127. package/dist/core/assembly/overlay-loader.js.map +1 -0
  128. package/dist/core/assembly/overlay-loader.test.d.ts +2 -0
  129. package/dist/core/assembly/overlay-loader.test.d.ts.map +1 -0
  130. package/dist/core/assembly/overlay-loader.test.js +106 -0
  131. package/dist/core/assembly/overlay-loader.test.js.map +1 -0
  132. package/dist/core/assembly/overlay-resolver.d.ts +15 -0
  133. package/dist/core/assembly/overlay-resolver.d.ts.map +1 -0
  134. package/dist/core/assembly/overlay-resolver.js +58 -0
  135. package/dist/core/assembly/overlay-resolver.js.map +1 -0
  136. package/dist/core/assembly/overlay-resolver.test.d.ts +2 -0
  137. package/dist/core/assembly/overlay-resolver.test.d.ts.map +1 -0
  138. package/dist/core/assembly/overlay-resolver.test.js +246 -0
  139. package/dist/core/assembly/overlay-resolver.test.js.map +1 -0
  140. package/dist/core/assembly/overlay-state-resolver.d.ts +26 -0
  141. package/dist/core/assembly/overlay-state-resolver.d.ts.map +1 -0
  142. package/dist/core/assembly/overlay-state-resolver.js +63 -0
  143. package/dist/core/assembly/overlay-state-resolver.js.map +1 -0
  144. package/dist/core/assembly/overlay-state-resolver.test.d.ts +2 -0
  145. package/dist/core/assembly/overlay-state-resolver.test.d.ts.map +1 -0
  146. package/dist/core/assembly/overlay-state-resolver.test.js +256 -0
  147. package/dist/core/assembly/overlay-state-resolver.test.js.map +1 -0
  148. package/dist/core/assembly/preset-loader.d.ts +1 -0
  149. package/dist/core/assembly/preset-loader.d.ts.map +1 -1
  150. package/dist/core/assembly/preset-loader.js +2 -0
  151. package/dist/core/assembly/preset-loader.js.map +1 -1
  152. package/dist/core/dependency/eligibility.test.js +3 -0
  153. package/dist/core/dependency/eligibility.test.js.map +1 -1
  154. package/dist/e2e/game-pipeline.test.d.ts +10 -0
  155. package/dist/e2e/game-pipeline.test.d.ts.map +1 -0
  156. package/dist/e2e/game-pipeline.test.js +298 -0
  157. package/dist/e2e/game-pipeline.test.js.map +1 -0
  158. package/dist/e2e/init.test.js +3 -0
  159. package/dist/e2e/init.test.js.map +1 -1
  160. package/dist/project/adopt.d.ts +3 -1
  161. package/dist/project/adopt.d.ts.map +1 -1
  162. package/dist/project/adopt.js +29 -1
  163. package/dist/project/adopt.js.map +1 -1
  164. package/dist/project/adopt.test.js +51 -1
  165. package/dist/project/adopt.test.js.map +1 -1
  166. package/dist/types/config.d.ts +50 -4
  167. package/dist/types/config.d.ts.map +1 -1
  168. package/dist/types/config.test.d.ts +2 -0
  169. package/dist/types/config.test.d.ts.map +1 -0
  170. package/dist/types/config.test.js +97 -0
  171. package/dist/types/config.test.js.map +1 -0
  172. package/dist/utils/eligible.d.ts +3 -2
  173. package/dist/utils/eligible.d.ts.map +1 -1
  174. package/dist/utils/eligible.js +18 -4
  175. package/dist/utils/eligible.js.map +1 -1
  176. package/dist/utils/errors.d.ts +4 -0
  177. package/dist/utils/errors.d.ts.map +1 -1
  178. package/dist/utils/errors.js +31 -0
  179. package/dist/utils/errors.js.map +1 -1
  180. package/dist/utils/errors.test.js +4 -1
  181. package/dist/utils/errors.test.js.map +1 -1
  182. package/dist/wizard/questions.d.ts +4 -0
  183. package/dist/wizard/questions.d.ts.map +1 -1
  184. package/dist/wizard/questions.js +59 -1
  185. package/dist/wizard/questions.js.map +1 -1
  186. package/dist/wizard/questions.test.js +178 -4
  187. package/dist/wizard/questions.test.js.map +1 -1
  188. package/dist/wizard/wizard.d.ts +1 -0
  189. package/dist/wizard/wizard.d.ts.map +1 -1
  190. package/dist/wizard/wizard.js +4 -1
  191. package/dist/wizard/wizard.js.map +1 -1
  192. package/dist/wizard/wizard.test.js +102 -4
  193. package/dist/wizard/wizard.test.js.map +1 -1
  194. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiBvB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAMT,CAAA;AAEhB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA"}
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB,eAAO,MAAM,iBAAiB,2EAE5B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBlB,CAAA;AAmBX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAMT,CAAA;AAEhB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA"}
@@ -8,10 +8,35 @@ const CustomSchema = z.object({
8
8
  default_depth: z.number().int().min(1).max(5).optional(),
9
9
  steps: z.record(z.string(), CustomStepSchema).optional(),
10
10
  }).strict();
11
+ export const ProjectTypeSchema = z.enum([
12
+ 'web-app', 'mobile-app', 'backend', 'cli', 'library', 'game',
13
+ ]);
14
+ export const GameConfigSchema = z.object({
15
+ engine: z.enum(['unity', 'unreal', 'godot', 'custom']),
16
+ multiplayerMode: z.enum(['none', 'local', 'online', 'hybrid']).default('none'),
17
+ narrative: z.enum(['none', 'light', 'heavy']).default('none'),
18
+ contentStructure: z.enum(['discrete', 'open-world', 'procedural', 'endless', 'mission-based']).default('discrete'),
19
+ economy: z.enum(['none', 'progression', 'monetized', 'both']).default('none'),
20
+ onlineServices: z.array(z.enum(['leaderboards', 'accounts', 'matchmaking', 'live-ops'])).default([]),
21
+ persistence: z.enum(['none', 'settings-only', 'profile', 'progression', 'cloud']).default('progression'),
22
+ targetPlatforms: z.array(z.enum(['pc', 'web', 'ios', 'android', 'ps5', 'xbox', 'switch', 'vr', 'ar'])).min(1).default(['pc']),
23
+ supportedLocales: z.array(z.string().regex(/^[a-z]{2}(-[A-Z]{2})?$/, 'Must be a valid locale code (e.g. "en", "en-US", "ja", "fr-FR")')).min(1).default(['en']),
24
+ hasModding: z.boolean().default(false),
25
+ npcAiComplexity: z.enum(['none', 'simple', 'complex']).default('none'),
26
+ }).strict();
11
27
  const ProjectSchema = z.object({
12
28
  name: z.string().min(1).optional(),
13
29
  platforms: z.array(z.enum(['web', 'mobile', 'desktop'])).optional(),
14
- }).passthrough(); // allow unknown fields per ADR-033
30
+ projectType: ProjectTypeSchema.optional(),
31
+ gameConfig: GameConfigSchema.optional(),
32
+ }).passthrough() // allow unknown fields per ADR-033
33
+ .refine((data) => {
34
+ // gameConfig is only valid when projectType === 'game'
35
+ if (data.gameConfig !== undefined && data.projectType !== 'game') {
36
+ return false;
37
+ }
38
+ return true;
39
+ }, { message: 'gameConfig is only valid when projectType is "game"', path: ['gameConfig'] });
15
40
  export const ConfigSchema = z.object({
16
41
  version: z.literal(2),
17
42
  methodology: z.enum(['deep', 'mvp', 'custom']),
@@ -1 +1 @@
1
- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAEvB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC,MAAM,EAAE,CAAA;AAEX,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC,MAAM,EAAE,CAAA;AAEX,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC,CAAC,WAAW,EAAE,CAAA,CAAE,mCAAmC;AAErD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,WAAW,EAAE,CAAA,CAAE,gDAAgD"}
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  // src/config/schema.test.ts
2
2
  import { describe, it, expect } from 'vitest';
3
- import { ConfigSchema } from './schema.js';
3
+ import { ConfigSchema, GameConfigSchema } from './schema.js';
4
4
  describe('ConfigSchema', () => {
5
5
  it('accepts a valid minimal config', () => {
6
6
  const result = ConfigSchema.safeParse({
@@ -131,4 +131,195 @@ describe('ConfigSchema', () => {
131
131
  expect(result.success).toBe(false);
132
132
  });
133
133
  });
134
+ describe('GameConfigSchema', () => {
135
+ it('accepts valid game config with all fields', () => {
136
+ const result = GameConfigSchema.safeParse({
137
+ engine: 'unity',
138
+ multiplayerMode: 'online',
139
+ narrative: 'heavy',
140
+ contentStructure: 'open-world',
141
+ economy: 'monetized',
142
+ onlineServices: ['leaderboards', 'matchmaking'],
143
+ persistence: 'cloud',
144
+ targetPlatforms: ['pc', 'ps5'],
145
+ supportedLocales: ['en', 'ja'],
146
+ hasModding: true,
147
+ npcAiComplexity: 'complex',
148
+ });
149
+ expect(result.success).toBe(true);
150
+ });
151
+ it('applies defaults for all fields except engine', () => {
152
+ const result = GameConfigSchema.safeParse({
153
+ engine: 'godot',
154
+ });
155
+ expect(result.success).toBe(true);
156
+ if (result.success) {
157
+ expect(result.data).toEqual({
158
+ engine: 'godot',
159
+ multiplayerMode: 'none',
160
+ narrative: 'none',
161
+ contentStructure: 'discrete',
162
+ economy: 'none',
163
+ onlineServices: [],
164
+ persistence: 'progression',
165
+ targetPlatforms: ['pc'],
166
+ supportedLocales: ['en'],
167
+ hasModding: false,
168
+ npcAiComplexity: 'none',
169
+ });
170
+ }
171
+ });
172
+ it('rejects invalid engine value', () => {
173
+ const result = GameConfigSchema.safeParse({
174
+ engine: 'rpgmaker',
175
+ });
176
+ expect(result.success).toBe(false);
177
+ });
178
+ it('rejects invalid targetPlatform value', () => {
179
+ const result = GameConfigSchema.safeParse({
180
+ engine: 'unity',
181
+ targetPlatforms: ['pc', 'commodore64'],
182
+ });
183
+ expect(result.success).toBe(false);
184
+ });
185
+ it('rejects empty targetPlatforms array', () => {
186
+ const result = GameConfigSchema.safeParse({
187
+ engine: 'unity',
188
+ targetPlatforms: [],
189
+ });
190
+ expect(result.success).toBe(false);
191
+ });
192
+ it('rejects empty supportedLocales array', () => {
193
+ const result = GameConfigSchema.safeParse({
194
+ engine: 'unity',
195
+ supportedLocales: [],
196
+ });
197
+ expect(result.success).toBe(false);
198
+ });
199
+ it('rejects invalid locale format', () => {
200
+ const result = GameConfigSchema.safeParse({
201
+ engine: 'unity',
202
+ supportedLocales: ['english'],
203
+ });
204
+ expect(result.success).toBe(false);
205
+ });
206
+ it('accepts valid locale codes (xx and xx-XX)', () => {
207
+ const result = GameConfigSchema.safeParse({
208
+ engine: 'unity',
209
+ supportedLocales: ['en', 'en-US', 'ja', 'fr-FR'],
210
+ });
211
+ expect(result.success).toBe(true);
212
+ });
213
+ });
214
+ describe('ConfigSchema with projectType and gameConfig', () => {
215
+ it('config without projectType still passes (backwards compatible)', () => {
216
+ const result = ConfigSchema.safeParse({
217
+ version: 2,
218
+ methodology: 'deep',
219
+ platforms: ['claude-code'],
220
+ project: {
221
+ name: 'my-app',
222
+ },
223
+ });
224
+ expect(result.success).toBe(true);
225
+ });
226
+ it('config with projectType game and valid gameConfig passes', () => {
227
+ const result = ConfigSchema.safeParse({
228
+ version: 2,
229
+ methodology: 'deep',
230
+ platforms: ['claude-code'],
231
+ project: {
232
+ name: 'my-game',
233
+ projectType: 'game',
234
+ gameConfig: {
235
+ engine: 'unreal',
236
+ multiplayerMode: 'hybrid',
237
+ narrative: 'light',
238
+ contentStructure: 'mission-based',
239
+ economy: 'both',
240
+ onlineServices: ['accounts', 'live-ops'],
241
+ persistence: 'profile',
242
+ targetPlatforms: ['pc', 'xbox'],
243
+ supportedLocales: ['en', 'fr'],
244
+ hasModding: false,
245
+ npcAiComplexity: 'simple',
246
+ },
247
+ },
248
+ });
249
+ expect(result.success).toBe(true);
250
+ });
251
+ it('config with projectType game and only engine set gets defaults', () => {
252
+ const result = ConfigSchema.safeParse({
253
+ version: 2,
254
+ methodology: 'deep',
255
+ platforms: ['claude-code'],
256
+ project: {
257
+ name: 'my-game',
258
+ projectType: 'game',
259
+ gameConfig: {
260
+ engine: 'godot',
261
+ },
262
+ },
263
+ });
264
+ expect(result.success).toBe(true);
265
+ if (result.success) {
266
+ const project = result.data.project;
267
+ const gc = project['gameConfig'];
268
+ expect(gc).toEqual({
269
+ engine: 'godot',
270
+ multiplayerMode: 'none',
271
+ narrative: 'none',
272
+ contentStructure: 'discrete',
273
+ economy: 'none',
274
+ onlineServices: [],
275
+ persistence: 'progression',
276
+ targetPlatforms: ['pc'],
277
+ supportedLocales: ['en'],
278
+ hasModding: false,
279
+ npcAiComplexity: 'none',
280
+ });
281
+ }
282
+ });
283
+ it('rejects gameConfig when projectType is not game', () => {
284
+ const result = ConfigSchema.safeParse({
285
+ version: 2,
286
+ methodology: 'deep',
287
+ platforms: ['claude-code'],
288
+ project: {
289
+ name: 'my-web-app',
290
+ projectType: 'web-app',
291
+ gameConfig: {
292
+ engine: 'unity',
293
+ },
294
+ },
295
+ });
296
+ expect(result.success).toBe(false);
297
+ });
298
+ it('rejects gameConfig when projectType is missing', () => {
299
+ const result = ConfigSchema.safeParse({
300
+ version: 2,
301
+ methodology: 'deep',
302
+ platforms: ['claude-code'],
303
+ project: {
304
+ name: 'my-app',
305
+ gameConfig: {
306
+ engine: 'unity',
307
+ },
308
+ },
309
+ });
310
+ expect(result.success).toBe(false);
311
+ });
312
+ it('accepts non-game projectType without gameConfig', () => {
313
+ const result = ConfigSchema.safeParse({
314
+ version: 2,
315
+ methodology: 'deep',
316
+ platforms: ['claude-code'],
317
+ project: {
318
+ name: 'my-api',
319
+ projectType: 'backend',
320
+ },
321
+ });
322
+ expect(result.success).toBe(true);
323
+ });
324
+ });
134
325
  //# sourceMappingURL=schema.test.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"schema.test.js","sourceRoot":"","sources":["../../src/config/schema.test.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,CAAC,aAAa,CAAC;SAC3B,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,QAAQ;YACrB,SAAS,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC;YACnC,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC;gBAChB,KAAK,EAAE;oBACL,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE;iBACnC;aACF;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC,KAAK,CAAC;aACnB;SACF,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;SACrC,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,CAAC,aAAa,CAAC;SAC3B,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;SACpB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,SAAS;YACtB,SAAS,EAAE,CAAC,aAAa,CAAC;SAC3B,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,CAAC,kBAAkB,CAAC;SAChC,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,QAAQ;YACrB,SAAS,EAAE,CAAC,aAAa,CAAC;YAC1B,MAAM,EAAE;gBACN,KAAK,EAAE;oBACL,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;iBACpB;aACF;SACF,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,QAAQ;YACrB,SAAS,EAAE,CAAC,aAAa,CAAC;YAC1B,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC;aACjB;SACF,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,CAAC,aAAa,CAAC;YAC1B,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAE,MAAM,CAAC,IAAgC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACrF,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,CAAC,aAAa,CAAC;YAC1B,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,qBAAqB,EAAE,IAAI;aAC5B;SACF,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,CAAC,aAAa,CAAC;SAC3B,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
1
+ {"version":3,"file":"schema.test.js","sourceRoot":"","sources":["../../src/config/schema.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import type { StepEnablementEntry } from '../../types/index.js';
2
+ import type { ProjectTypeOverlay, KnowledgeOverride, ReadsOverride, DependencyOverride } from '../../types/index.js';
3
+ import type { ScaffoldError, ScaffoldWarning } from '../../types/index.js';
4
+ /** Check if a value is a plain object (not null, not array). */
5
+ export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
6
+ /** Parse step-overrides section from YAML object. */
7
+ export declare function parseStepOverrides(raw: Record<string, unknown>, warnings: ScaffoldWarning[], filePath: string): Record<string, StepEnablementEntry>;
8
+ /** Parse knowledge-overrides section from YAML object. */
9
+ export declare function parseKnowledgeOverrides(raw: Record<string, unknown>, warnings: ScaffoldWarning[], filePath: string): Record<string, KnowledgeOverride>;
10
+ /** Parse reads-overrides section from YAML object. */
11
+ export declare function parseReadsOverrides(raw: Record<string, unknown>, warnings: ScaffoldWarning[], filePath: string): Record<string, ReadsOverride>;
12
+ /** Parse dependency-overrides section from YAML object. */
13
+ export declare function parseDependencyOverrides(raw: Record<string, unknown>, warnings: ScaffoldWarning[], filePath: string): Record<string, DependencyOverride>;
14
+ /**
15
+ * Load a project-type overlay YAML file.
16
+ * @param overlayPath - Absolute path to overlay file
17
+ * @returns { overlay, errors, warnings }
18
+ */
19
+ export declare function loadOverlay(overlayPath: string): {
20
+ overlay: ProjectTypeOverlay | null;
21
+ errors: ScaffoldError[];
22
+ warnings: ScaffoldWarning[];
23
+ };
24
+ //# sourceMappingURL=overlay-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overlay-loader.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/overlay-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC5E,OAAO,KAAK,EACV,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,kBAAkB,EACzE,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAS1E,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAmBrC;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAiBnC;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CA0B/B;AAED,2DAA2D;AAC3D,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CA0BpC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;CAAE,CA0F9F"}
@@ -0,0 +1,190 @@
1
+ import { fileExists } from '../../utils/fs.js';
2
+ import { overlayMissing, overlayParseError, overlayMalformedSection, overlayMalformedEntry, } from '../../utils/errors.js';
3
+ import yaml from 'js-yaml';
4
+ import fs from 'node:fs';
5
+ import path from 'node:path';
6
+ /** Check if a value is a plain object (not null, not array). */
7
+ export function isPlainObject(value) {
8
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
9
+ }
10
+ /** Parse step-overrides section from YAML object. */
11
+ export function parseStepOverrides(raw, warnings, filePath) {
12
+ const result = {};
13
+ for (const [key, value] of Object.entries(raw)) {
14
+ if (typeof value !== 'object' || value === null || Array.isArray(value)) {
15
+ warnings.push(overlayMalformedEntry(key, 'value', filePath));
16
+ continue;
17
+ }
18
+ const obj = value;
19
+ if (typeof obj['enabled'] !== 'boolean') {
20
+ warnings.push(overlayMalformedEntry(key, 'enabled', filePath));
21
+ continue;
22
+ }
23
+ const entry = { enabled: obj['enabled'] };
24
+ if (obj['conditional'] === 'if-needed') {
25
+ entry.conditional = 'if-needed';
26
+ }
27
+ result[key] = entry;
28
+ }
29
+ return result;
30
+ }
31
+ /** Parse knowledge-overrides section from YAML object. */
32
+ export function parseKnowledgeOverrides(raw, warnings, filePath) {
33
+ const result = {};
34
+ for (const [key, value] of Object.entries(raw)) {
35
+ if (typeof value !== 'object' || value === null || Array.isArray(value)) {
36
+ warnings.push(overlayMalformedEntry(key, 'value', filePath));
37
+ continue;
38
+ }
39
+ const obj = value;
40
+ if (obj['append'] !== undefined && !Array.isArray(obj['append'])) {
41
+ warnings.push(overlayMalformedEntry(key, 'append', filePath));
42
+ }
43
+ const append = Array.isArray(obj['append'])
44
+ ? obj['append'].filter((v) => typeof v === 'string')
45
+ : [];
46
+ result[key] = { append };
47
+ }
48
+ return result;
49
+ }
50
+ /** Parse reads-overrides section from YAML object. */
51
+ export function parseReadsOverrides(raw, warnings, filePath) {
52
+ const result = {};
53
+ for (const [key, value] of Object.entries(raw)) {
54
+ if (typeof value !== 'object' || value === null || Array.isArray(value)) {
55
+ warnings.push(overlayMalformedEntry(key, 'value', filePath));
56
+ continue;
57
+ }
58
+ const obj = value;
59
+ if (obj['replace'] !== undefined && !isPlainObject(obj['replace'])) {
60
+ warnings.push(overlayMalformedEntry(key, 'replace', filePath));
61
+ }
62
+ if (obj['append'] !== undefined && !Array.isArray(obj['append'])) {
63
+ warnings.push(overlayMalformedEntry(key, 'append', filePath));
64
+ }
65
+ const replace = {};
66
+ if (typeof obj['replace'] === 'object' && obj['replace'] !== null && !Array.isArray(obj['replace'])) {
67
+ for (const [rk, rv] of Object.entries(obj['replace'])) {
68
+ if (typeof rv === 'string')
69
+ replace[rk] = rv;
70
+ }
71
+ }
72
+ const append = Array.isArray(obj['append'])
73
+ ? obj['append'].filter((v) => typeof v === 'string')
74
+ : [];
75
+ result[key] = { replace, append };
76
+ }
77
+ return result;
78
+ }
79
+ /** Parse dependency-overrides section from YAML object. */
80
+ export function parseDependencyOverrides(raw, warnings, filePath) {
81
+ const result = {};
82
+ for (const [key, value] of Object.entries(raw)) {
83
+ if (typeof value !== 'object' || value === null || Array.isArray(value)) {
84
+ warnings.push(overlayMalformedEntry(key, 'value', filePath));
85
+ continue;
86
+ }
87
+ const obj = value;
88
+ if (obj['replace'] !== undefined && !isPlainObject(obj['replace'])) {
89
+ warnings.push(overlayMalformedEntry(key, 'replace', filePath));
90
+ }
91
+ if (obj['append'] !== undefined && !Array.isArray(obj['append'])) {
92
+ warnings.push(overlayMalformedEntry(key, 'append', filePath));
93
+ }
94
+ const replace = {};
95
+ if (typeof obj['replace'] === 'object' && obj['replace'] !== null && !Array.isArray(obj['replace'])) {
96
+ for (const [rk, rv] of Object.entries(obj['replace'])) {
97
+ if (typeof rv === 'string')
98
+ replace[rk] = rv;
99
+ }
100
+ }
101
+ const append = Array.isArray(obj['append'])
102
+ ? obj['append'].filter((v) => typeof v === 'string')
103
+ : [];
104
+ result[key] = { replace, append };
105
+ }
106
+ return result;
107
+ }
108
+ /**
109
+ * Load a project-type overlay YAML file.
110
+ * @param overlayPath - Absolute path to overlay file
111
+ * @returns { overlay, errors, warnings }
112
+ */
113
+ export function loadOverlay(overlayPath) {
114
+ const errors = [];
115
+ const warnings = [];
116
+ // 1. Check file exists
117
+ if (!fileExists(overlayPath)) {
118
+ const overlayName = path.basename(overlayPath, '.yml');
119
+ errors.push(overlayMissing(overlayName, overlayPath));
120
+ return { overlay: null, errors, warnings };
121
+ }
122
+ // 2. Read file
123
+ const raw = fs.readFileSync(overlayPath, 'utf8');
124
+ // 3. Parse YAML
125
+ let parsed;
126
+ try {
127
+ parsed = yaml.load(raw);
128
+ }
129
+ catch (err) {
130
+ const detail = err instanceof Error ? err.message : String(err);
131
+ errors.push(overlayParseError(overlayPath, detail));
132
+ return { overlay: null, errors, warnings };
133
+ }
134
+ // 4. Validate top-level structure
135
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
136
+ errors.push(overlayParseError(overlayPath, 'overlay must be a YAML object'));
137
+ return { overlay: null, errors, warnings };
138
+ }
139
+ const obj = parsed;
140
+ // Validate required fields
141
+ if (typeof obj['name'] !== 'string' || obj['name'].trim() === '') {
142
+ errors.push(overlayParseError(overlayPath, 'required field "name" must be a non-empty string'));
143
+ }
144
+ if (typeof obj['description'] !== 'string' || obj['description'].trim() === '') {
145
+ errors.push(overlayParseError(overlayPath, 'required field "description" must be a non-empty string'));
146
+ }
147
+ if (typeof obj['project-type'] !== 'string' || obj['project-type'].trim() === '') {
148
+ errors.push(overlayParseError(overlayPath, 'required field "project-type" must be a non-empty string'));
149
+ }
150
+ else {
151
+ const validProjectTypes = ['web-app', 'mobile-app', 'backend', 'cli', 'library', 'game'];
152
+ const pt = obj['project-type'].trim();
153
+ if (!validProjectTypes.includes(pt)) {
154
+ const allowed = validProjectTypes.join(', ');
155
+ errors.push(overlayParseError(overlayPath, `"project-type" must be one of ${allowed}, got "${pt}"`));
156
+ }
157
+ }
158
+ if (errors.length > 0) {
159
+ return { overlay: null, errors, warnings };
160
+ }
161
+ // 5. Parse override sections (gracefully handle missing/malformed)
162
+ const overrideSections = ['step-overrides', 'knowledge-overrides', 'reads-overrides', 'dependency-overrides'];
163
+ for (const section of overrideSections) {
164
+ const value = obj[section];
165
+ if (value !== undefined && value !== null) {
166
+ if (typeof value !== 'object' || Array.isArray(value)) {
167
+ warnings.push(overlayMalformedSection(section, overlayPath));
168
+ }
169
+ }
170
+ }
171
+ const stepOverridesRaw = isPlainObject(obj['step-overrides'])
172
+ ? obj['step-overrides'] : {};
173
+ const knowledgeOverridesRaw = isPlainObject(obj['knowledge-overrides'])
174
+ ? obj['knowledge-overrides'] : {};
175
+ const readsOverridesRaw = isPlainObject(obj['reads-overrides'])
176
+ ? obj['reads-overrides'] : {};
177
+ const dependencyOverridesRaw = isPlainObject(obj['dependency-overrides'])
178
+ ? obj['dependency-overrides'] : {};
179
+ const overlay = {
180
+ name: obj['name'].trim(),
181
+ description: obj['description'].trim(),
182
+ projectType: obj['project-type'].trim(),
183
+ stepOverrides: parseStepOverrides(stepOverridesRaw, warnings, overlayPath),
184
+ knowledgeOverrides: parseKnowledgeOverrides(knowledgeOverridesRaw, warnings, overlayPath),
185
+ readsOverrides: parseReadsOverrides(readsOverridesRaw, warnings, overlayPath),
186
+ dependencyOverrides: parseDependencyOverrides(dependencyOverridesRaw, warnings, overlayPath),
187
+ };
188
+ return { overlay, errors, warnings };
189
+ }
190
+ //# sourceMappingURL=overlay-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overlay-loader.js","sourceRoot":"","sources":["../../../src/core/assembly/overlay-loader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=overlay-loader.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overlay-loader.test.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/overlay-loader.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,106 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import path from 'node:path';
3
+ import fs from 'node:fs';
4
+ import os from 'node:os';
5
+ import { fileURLToPath } from 'node:url';
6
+ import { loadOverlay } from './overlay-loader.js';
7
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
8
+ const fixtureDir = path.resolve(__dirname, '../../../tests/fixtures/methodology');
9
+ describe('loadOverlay', () => {
10
+ it('loads game-overlay.yml with correct name and projectType', () => {
11
+ const { overlay, errors } = loadOverlay(path.join(fixtureDir, 'game-overlay.yml'));
12
+ expect(errors).toHaveLength(0);
13
+ expect(overlay).not.toBeNull();
14
+ expect(overlay.name).toBe('game');
15
+ expect(overlay.description).toBe('Game development overlay for testing');
16
+ expect(overlay.projectType).toBe('game');
17
+ });
18
+ it('parses step-overrides correctly', () => {
19
+ const { overlay, errors } = loadOverlay(path.join(fixtureDir, 'game-overlay.yml'));
20
+ expect(errors).toHaveLength(0);
21
+ expect(overlay).not.toBeNull();
22
+ expect(overlay.stepOverrides['game-design-document']).toEqual({ enabled: true });
23
+ expect(overlay.stepOverrides['review-gdd']).toEqual({ enabled: true });
24
+ expect(overlay.stepOverrides['design-system']).toEqual({ enabled: false });
25
+ });
26
+ it('parses knowledge-overrides (append arrays)', () => {
27
+ const { overlay, errors } = loadOverlay(path.join(fixtureDir, 'game-overlay.yml'));
28
+ expect(errors).toHaveLength(0);
29
+ expect(overlay).not.toBeNull();
30
+ expect(overlay.knowledgeOverrides['tech-stack']).toEqual({
31
+ append: ['game-engine-selection'],
32
+ });
33
+ expect(overlay.knowledgeOverrides['tdd']).toEqual({
34
+ append: ['game-testing-strategy'],
35
+ });
36
+ });
37
+ it('parses reads-overrides (replace maps and append arrays)', () => {
38
+ const { overlay, errors } = loadOverlay(path.join(fixtureDir, 'game-overlay.yml'));
39
+ expect(errors).toHaveLength(0);
40
+ expect(overlay).not.toBeNull();
41
+ expect(overlay.readsOverrides['story-tests']).toEqual({
42
+ replace: { 'ux-spec': 'game-ui-spec' },
43
+ append: [],
44
+ });
45
+ expect(overlay.readsOverrides['implementation-plan']).toEqual({
46
+ replace: { 'ux-spec': 'game-ui-spec' },
47
+ append: ['game-design-document'],
48
+ });
49
+ });
50
+ it('parses dependency-overrides (replace maps and append arrays)', () => {
51
+ const { overlay, errors } = loadOverlay(path.join(fixtureDir, 'game-overlay.yml'));
52
+ expect(errors).toHaveLength(0);
53
+ expect(overlay).not.toBeNull();
54
+ expect(overlay.dependencyOverrides['user-stories']).toEqual({
55
+ replace: {},
56
+ append: ['review-gdd'],
57
+ });
58
+ expect(overlay.dependencyOverrides['platform-parity-review']).toEqual({
59
+ replace: { 'review-ux': 'review-game-ui' },
60
+ append: [],
61
+ });
62
+ });
63
+ it('returns error for missing file', () => {
64
+ const { overlay, errors } = loadOverlay(path.join(fixtureDir, 'nonexistent-overlay.yml'));
65
+ expect(overlay).toBeNull();
66
+ expect(errors).toHaveLength(1);
67
+ expect(errors[0].code).toBe('OVERLAY_MISSING');
68
+ });
69
+ it('returns empty overrides for minimal overlay (no override sections)', () => {
70
+ const { overlay, errors } = loadOverlay(path.join(fixtureDir, 'minimal-overlay.yml'));
71
+ expect(errors).toHaveLength(0);
72
+ expect(overlay).not.toBeNull();
73
+ expect(overlay.name).toBe('minimal');
74
+ expect(overlay.projectType).toBe('game');
75
+ expect(overlay.stepOverrides).toEqual({});
76
+ expect(overlay.knowledgeOverrides).toEqual({});
77
+ expect(overlay.readsOverrides).toEqual({});
78
+ expect(overlay.dependencyOverrides).toEqual({});
79
+ });
80
+ it('warns on malformed override structure (e.g., knowledge-overrides as array)', () => {
81
+ // Create a temp file with malformed structure
82
+ const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'overlay-test-'));
83
+ const tmpFile = path.join(tmpDir, 'malformed-overlay.yml');
84
+ fs.writeFileSync(tmpFile, [
85
+ 'name: malformed',
86
+ 'description: Malformed overlay for testing',
87
+ 'project-type: game',
88
+ 'knowledge-overrides:',
89
+ ' - item1',
90
+ ' - item2',
91
+ ].join('\n'));
92
+ try {
93
+ const { overlay, errors: _errors, warnings } = loadOverlay(tmpFile);
94
+ // Should still load (gracefully degrade) but warn
95
+ expect(warnings.length).toBeGreaterThan(0);
96
+ expect(warnings[0].code).toBe('OVERLAY_MALFORMED_SECTION');
97
+ // Overlay should still be returned with empty knowledgeOverrides
98
+ expect(overlay).not.toBeNull();
99
+ expect(overlay.knowledgeOverrides).toEqual({});
100
+ }
101
+ finally {
102
+ fs.rmSync(tmpDir, { recursive: true });
103
+ }
104
+ });
105
+ });
106
+ //# sourceMappingURL=overlay-loader.test.js.map