@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.
- package/README.md +91 -0
- package/content/knowledge/game/game-accessibility.md +328 -0
- package/content/knowledge/game/game-ai-patterns.md +542 -0
- package/content/knowledge/game/game-asset-pipeline.md +359 -0
- package/content/knowledge/game/game-audio-design.md +342 -0
- package/content/knowledge/game/game-binary-vcs-strategy.md +396 -0
- package/content/knowledge/game/game-design-document.md +260 -0
- package/content/knowledge/game/game-domain-patterns.md +297 -0
- package/content/knowledge/game/game-economy-design.md +355 -0
- package/content/knowledge/game/game-engine-selection.md +242 -0
- package/content/knowledge/game/game-input-systems.md +357 -0
- package/content/knowledge/game/game-level-content-design.md +455 -0
- package/content/knowledge/game/game-liveops-analytics.md +280 -0
- package/content/knowledge/game/game-localization.md +323 -0
- package/content/knowledge/game/game-milestone-definitions.md +337 -0
- package/content/knowledge/game/game-modding-ugc.md +390 -0
- package/content/knowledge/game/game-narrative-design.md +404 -0
- package/content/knowledge/game/game-networking.md +391 -0
- package/content/knowledge/game/game-performance-budgeting.md +378 -0
- package/content/knowledge/game/game-platform-certification.md +417 -0
- package/content/knowledge/game/game-project-structure.md +360 -0
- package/content/knowledge/game/game-save-systems.md +452 -0
- package/content/knowledge/game/game-testing-strategy.md +470 -0
- package/content/knowledge/game/game-ui-patterns.md +475 -0
- package/content/knowledge/game/game-vr-ar-design.md +313 -0
- package/content/knowledge/review/review-art-bible.md +305 -0
- package/content/knowledge/review/review-game-design.md +303 -0
- package/content/knowledge/review/review-game-economy.md +272 -0
- package/content/knowledge/review/review-netcode.md +280 -0
- package/content/knowledge/review/review-platform-cert.md +341 -0
- package/content/methodology/custom-defaults.yml +25 -0
- package/content/methodology/deep.yml +25 -0
- package/content/methodology/game-overlay.yml +145 -0
- package/content/methodology/mvp.yml +25 -0
- package/content/pipeline/architecture/ai-behavior-design.md +87 -0
- package/content/pipeline/architecture/netcode-spec.md +86 -0
- package/content/pipeline/architecture/review-netcode.md +78 -0
- package/content/pipeline/foundation/performance-budgets.md +91 -0
- package/content/pipeline/modeling/narrative-bible.md +84 -0
- package/content/pipeline/pre/game-design-document.md +89 -0
- package/content/pipeline/pre/review-gdd.md +74 -0
- package/content/pipeline/quality/analytics-telemetry.md +98 -0
- package/content/pipeline/quality/live-ops-plan.md +99 -0
- package/content/pipeline/quality/platform-cert-prep.md +129 -0
- package/content/pipeline/quality/playtest-plan.md +83 -0
- package/content/pipeline/specification/art-bible.md +87 -0
- package/content/pipeline/specification/audio-design.md +96 -0
- package/content/pipeline/specification/content-structure-design.md +141 -0
- package/content/pipeline/specification/economy-design.md +104 -0
- package/content/pipeline/specification/game-accessibility.md +82 -0
- package/content/pipeline/specification/game-ui-spec.md +97 -0
- package/content/pipeline/specification/input-controls-spec.md +81 -0
- package/content/pipeline/specification/localization-plan.md +113 -0
- package/content/pipeline/specification/modding-ugc-spec.md +116 -0
- package/content/pipeline/specification/online-services-spec.md +104 -0
- package/content/pipeline/specification/review-economy.md +87 -0
- package/content/pipeline/specification/review-game-ui.md +73 -0
- package/content/pipeline/specification/save-system-spec.md +116 -0
- package/dist/cli/commands/adopt.d.ts.map +1 -1
- package/dist/cli/commands/adopt.js +25 -0
- package/dist/cli/commands/adopt.js.map +1 -1
- package/dist/cli/commands/adopt.test.js +28 -1
- package/dist/cli/commands/adopt.test.js.map +1 -1
- package/dist/cli/commands/build.test.js +3 -0
- package/dist/cli/commands/build.test.js.map +1 -1
- package/dist/cli/commands/init.d.ts +1 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +6 -0
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/init.test.js +12 -1
- package/dist/cli/commands/init.test.js.map +1 -1
- package/dist/cli/commands/knowledge.test.js +8 -0
- package/dist/cli/commands/knowledge.test.js.map +1 -1
- package/dist/cli/commands/next.d.ts.map +1 -1
- package/dist/cli/commands/next.js +19 -5
- package/dist/cli/commands/next.js.map +1 -1
- package/dist/cli/commands/next.test.js +56 -0
- package/dist/cli/commands/next.test.js.map +1 -1
- package/dist/cli/commands/rework.d.ts.map +1 -1
- package/dist/cli/commands/rework.js +11 -2
- package/dist/cli/commands/rework.js.map +1 -1
- package/dist/cli/commands/rework.test.js +5 -0
- package/dist/cli/commands/rework.test.js.map +1 -1
- package/dist/cli/commands/run.d.ts.map +1 -1
- package/dist/cli/commands/run.js +54 -4
- package/dist/cli/commands/run.js.map +1 -1
- package/dist/cli/commands/run.test.js +384 -0
- package/dist/cli/commands/run.test.js.map +1 -1
- package/dist/cli/commands/skip.test.js +3 -0
- package/dist/cli/commands/skip.test.js.map +1 -1
- package/dist/cli/commands/status.d.ts.map +1 -1
- package/dist/cli/commands/status.js +16 -3
- package/dist/cli/commands/status.js.map +1 -1
- package/dist/cli/commands/status.test.js +55 -0
- package/dist/cli/commands/status.test.js.map +1 -1
- package/dist/cli/output/auto.d.ts +3 -0
- package/dist/cli/output/auto.d.ts.map +1 -1
- package/dist/cli/output/auto.js +9 -0
- package/dist/cli/output/auto.js.map +1 -1
- package/dist/cli/output/context.d.ts +6 -0
- package/dist/cli/output/context.d.ts.map +1 -1
- package/dist/cli/output/context.js.map +1 -1
- package/dist/cli/output/context.test.js +87 -0
- package/dist/cli/output/context.test.js.map +1 -1
- package/dist/cli/output/error-display.test.js +3 -0
- package/dist/cli/output/error-display.test.js.map +1 -1
- package/dist/cli/output/interactive.d.ts +3 -0
- package/dist/cli/output/interactive.d.ts.map +1 -1
- package/dist/cli/output/interactive.js +76 -0
- package/dist/cli/output/interactive.js.map +1 -1
- package/dist/cli/output/json.d.ts +3 -0
- package/dist/cli/output/json.d.ts.map +1 -1
- package/dist/cli/output/json.js +9 -0
- package/dist/cli/output/json.js.map +1 -1
- package/dist/config/loader.d.ts.map +1 -1
- package/dist/config/loader.js +3 -2
- package/dist/config/loader.js.map +1 -1
- package/dist/config/schema.d.ts +641 -15
- package/dist/config/schema.d.ts.map +1 -1
- package/dist/config/schema.js +26 -1
- package/dist/config/schema.js.map +1 -1
- package/dist/config/schema.test.js +192 -1
- package/dist/config/schema.test.js.map +1 -1
- package/dist/core/assembly/overlay-loader.d.ts +24 -0
- package/dist/core/assembly/overlay-loader.d.ts.map +1 -0
- package/dist/core/assembly/overlay-loader.js +190 -0
- package/dist/core/assembly/overlay-loader.js.map +1 -0
- package/dist/core/assembly/overlay-loader.test.d.ts +2 -0
- package/dist/core/assembly/overlay-loader.test.d.ts.map +1 -0
- package/dist/core/assembly/overlay-loader.test.js +106 -0
- package/dist/core/assembly/overlay-loader.test.js.map +1 -0
- package/dist/core/assembly/overlay-resolver.d.ts +15 -0
- package/dist/core/assembly/overlay-resolver.d.ts.map +1 -0
- package/dist/core/assembly/overlay-resolver.js +58 -0
- package/dist/core/assembly/overlay-resolver.js.map +1 -0
- package/dist/core/assembly/overlay-resolver.test.d.ts +2 -0
- package/dist/core/assembly/overlay-resolver.test.d.ts.map +1 -0
- package/dist/core/assembly/overlay-resolver.test.js +246 -0
- package/dist/core/assembly/overlay-resolver.test.js.map +1 -0
- package/dist/core/assembly/overlay-state-resolver.d.ts +26 -0
- package/dist/core/assembly/overlay-state-resolver.d.ts.map +1 -0
- package/dist/core/assembly/overlay-state-resolver.js +63 -0
- package/dist/core/assembly/overlay-state-resolver.js.map +1 -0
- package/dist/core/assembly/overlay-state-resolver.test.d.ts +2 -0
- package/dist/core/assembly/overlay-state-resolver.test.d.ts.map +1 -0
- package/dist/core/assembly/overlay-state-resolver.test.js +256 -0
- package/dist/core/assembly/overlay-state-resolver.test.js.map +1 -0
- package/dist/core/assembly/preset-loader.d.ts +1 -0
- package/dist/core/assembly/preset-loader.d.ts.map +1 -1
- package/dist/core/assembly/preset-loader.js +2 -0
- package/dist/core/assembly/preset-loader.js.map +1 -1
- package/dist/core/dependency/eligibility.test.js +3 -0
- package/dist/core/dependency/eligibility.test.js.map +1 -1
- package/dist/e2e/game-pipeline.test.d.ts +10 -0
- package/dist/e2e/game-pipeline.test.d.ts.map +1 -0
- package/dist/e2e/game-pipeline.test.js +298 -0
- package/dist/e2e/game-pipeline.test.js.map +1 -0
- package/dist/e2e/init.test.js +3 -0
- package/dist/e2e/init.test.js.map +1 -1
- package/dist/project/adopt.d.ts +3 -1
- package/dist/project/adopt.d.ts.map +1 -1
- package/dist/project/adopt.js +29 -1
- package/dist/project/adopt.js.map +1 -1
- package/dist/project/adopt.test.js +51 -1
- package/dist/project/adopt.test.js.map +1 -1
- package/dist/types/config.d.ts +50 -4
- package/dist/types/config.d.ts.map +1 -1
- package/dist/types/config.test.d.ts +2 -0
- package/dist/types/config.test.d.ts.map +1 -0
- package/dist/types/config.test.js +97 -0
- package/dist/types/config.test.js.map +1 -0
- package/dist/utils/eligible.d.ts +3 -2
- package/dist/utils/eligible.d.ts.map +1 -1
- package/dist/utils/eligible.js +18 -4
- package/dist/utils/eligible.js.map +1 -1
- package/dist/utils/errors.d.ts +4 -0
- package/dist/utils/errors.d.ts.map +1 -1
- package/dist/utils/errors.js +31 -0
- package/dist/utils/errors.js.map +1 -1
- package/dist/utils/errors.test.js +4 -1
- package/dist/utils/errors.test.js.map +1 -1
- package/dist/wizard/questions.d.ts +4 -0
- package/dist/wizard/questions.d.ts.map +1 -1
- package/dist/wizard/questions.js +59 -1
- package/dist/wizard/questions.js.map +1 -1
- package/dist/wizard/questions.test.js +178 -4
- package/dist/wizard/questions.test.js.map +1 -1
- package/dist/wizard/wizard.d.ts +1 -0
- package/dist/wizard/wizard.d.ts.map +1 -1
- package/dist/wizard/wizard.js +4 -1
- package/dist/wizard/wizard.js.map +1 -1
- package/dist/wizard/wizard.test.js +102 -4
- package/dist/wizard/wizard.test.js.map +1 -1
- 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;
|
|
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"}
|
package/dist/config/schema.js
CHANGED
|
@@ -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
|
-
|
|
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;
|
|
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,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM;CAC7D,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9E,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7D,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAClH,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7E,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpG,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IACxG,eAAe,EAAE,CAAC,CAAC,KAAK,CACtB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAC7E,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CACvB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,EAAE,iEAAiE,CAAC,CAC9G,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACvE,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;IACnE,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC,WAAW,EAAE,CAAE,mCAAmC;KAClD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,uDAAuD;IACvD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QACjE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,EACD,EAAE,OAAO,EAAE,qDAAqD,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,CACzF,CAAA;AAEH,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,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;
|
|
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 @@
|
|
|
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
|