@zigrivers/scaffold 2.1.0

package/dist/config/loader.js

@@ -0,0 +1,159 @@
+// src/config/loader.ts
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { fileExists } from '../utils/fs.js';
+import { configMissing, configEmpty, configParseError, configNotObject, configUnknownField, fieldWrongType, fieldInvalidDepth, fieldInvalidMethodology, } from '../utils/errors.js';
+import { findClosestMatch } from '../utils/levenshtein.js';
+import { ConfigSchema } from './schema.js';
+import { migrateV1 } from './migration.js';
+/** Known valid top-level fields in a v2 config. */
+const KNOWN_FIELDS = new Set(['version', 'methodology', 'custom', 'platforms', 'project']);
+/** Valid methodology values. */
+const VALID_METHODOLOGIES = ['deep', 'mvp', 'custom'];
+/**
+ * Load and validate .scaffold/config.yml.
+ *
+ * Implements a 6-phase validation pipeline:
+ * - Phase 1: File existence (short-circuit)
+ * - Phase 2: YAML parse + shape check (short-circuit)
+ * - Phase 3: Version check + v1 migration (short-circuit)
+ * - Phase 4: Required fields validation (accumulate)
+ * - Phase 5: Unknown top-level fields → warnings (accumulate)
+ * - Phase 6: Cross-field validation (accumulate)
+ */
+export function loadConfig(projectRoot, knownSteps) {
+    const configPath = path.join(projectRoot, '.scaffold', 'config.yml');
+    const errors = [];
+    const warnings = [];
+    // Phase 1: File existence
+    if (!fileExists(configPath)) {
+        return { config: null, errors: [configMissing(configPath)], warnings: [] };
+    }
+    // Phase 2: YAML parse + shape check
+    let raw;
+    const content = fs.readFileSync(configPath, 'utf8');
+    if (content.trim() === '') {
+        return { config: null, errors: [configEmpty(configPath)], warnings: [] };
+    }
+    try {
+        raw = yaml.load(content);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        return { config: null, errors: [configParseError(configPath, detail)], warnings: [] };
+    }
+    if (raw === null || raw === undefined || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { config: null, errors: [configNotObject(configPath)], warnings: [] };
+    }
+    let obj = raw;
+    // Phase 3: Version check + v1 migration
+    const version = obj['version'];
+    if (version === 1 || version === undefined) {
+        // Auto-migrate v1 config
+        obj = migrateV1(obj);
+    }
+    else if (version !== 2) {
+        // Unexpected version
+        return {
+            config: null,
+            errors: [fieldWrongType('version', '2', String(version), configPath)],
+            warnings: [],
+        };
+    }
+    // Phase 4: Required fields validation (accumulate errors)
+    const methodology = obj['methodology'];
+    if (methodology === undefined || methodology === null) {
+        errors.push({
+            code: 'FIELD_MISSING',
+            message: 'Required field "methodology" is missing',
+            exitCode: 1,
+            recovery: `Add "methodology" to ${configPath}`,
+            context: { file: configPath, field: 'methodology' },
+        });
+    }
+    else if (typeof methodology !== 'string' || !VALID_METHODOLOGIES.includes(methodology)) {
+        const suggestion = typeof methodology === 'string'
+            ? findClosestMatch(methodology, VALID_METHODOLOGIES)
+            : null;
+        errors.push(fieldInvalidMethodology(String(methodology), suggestion, configPath));
+    }
+    const platforms = obj['platforms'];
+    if (platforms === undefined || platforms === null) {
+        errors.push({
+            code: 'FIELD_MISSING',
+            message: 'Required field "platforms" is missing',
+            exitCode: 1,
+            recovery: `Add "platforms" to ${configPath}`,
+            context: { file: configPath, field: 'platforms' },
+        });
+    }
+    else if (!Array.isArray(platforms) || platforms.length === 0) {
+        errors.push({
+            code: 'FIELD_EMPTY_VALUE',
+            message: 'Field "platforms" must not be empty',
+            exitCode: 1,
+            context: { file: configPath, field: 'platforms' },
+        });
+    }
+    // Validate custom section depths via Zod
+    const zodResult = ConfigSchema.safeParse(obj);
+    if (!zodResult.success) {
+        for (const issue of zodResult.error.issues) {
+            const fieldPath = issue.path.join('.');
+            // Depth violations
+            if (fieldPath.includes('depth')) {
+                const depthValue = getNestedValue(obj, issue.path);
+                errors.push(fieldInvalidDepth(depthValue, configPath));
+            }
+            // Platforms type issues not already captured above
+        }
+    }
+    // Short-circuit if Phase 4 produced errors
+    if (errors.length > 0) {
+        return { config: null, errors, warnings };
+    }
+    // Phase 5: Unknown top-level fields → warnings (accumulate)
+    for (const key of Object.keys(obj)) {
+        if (!KNOWN_FIELDS.has(key)) {
+            warnings.push(configUnknownField(key, configPath));
+        }
+    }
+    // Phase 6: Cross-field validation (accumulate)
+    if (methodology === 'custom' && knownSteps.length > 0) {
+        const custom = obj['custom'];
+        if (custom !== undefined) {
+            const steps = custom['steps'];
+            if (steps !== undefined) {
+                for (const stepName of Object.keys(steps)) {
+                    if (!knownSteps.includes(stepName)) {
+                        errors.push({
+                            code: 'FIELD_INVALID_VALUE',
+                            message: `Unknown step "${stepName}" in custom.steps`,
+                            exitCode: 1,
+                            recovery: `Valid steps: ${knownSteps.join(', ')}`,
+                            context: { file: configPath, field: 'custom.steps', value: stepName },
+                        });
+                    }
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { config: null, errors, warnings };
+    }
+    // Success — return config with unknown fields preserved (ADR-033)
+    const config = obj;
+    return { config, errors: [], warnings };
+}
+/** Safely retrieve a nested value by path array. */
+function getNestedValue(obj, pathArr) {
+    let current = obj;
+    for (const key of pathArr) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"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"}

package/dist/config/loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loader.test.d.ts.map

package/dist/config/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../src/config/loader.test.ts"],"names":[],"mappings":""}

package/dist/config/loader.test.js

@@ -0,0 +1,226 @@
+// src/config/loader.test.ts
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { describe, it, expect, afterEach } from 'vitest';
+import { loadConfig } from './loader.js';
+const tmpDirs = [];
+function makeTmpDir() {
+    const d = path.join(os.tmpdir(), `scaffold-config-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(d, { recursive: true });
+    tmpDirs.push(d);
+    return d;
+}
+function writeConfig(projectRoot, content) {
+    const dir = path.join(projectRoot, '.scaffold');
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, 'config.yml'), content, 'utf8');
+}
+afterEach(() => {
+    for (const d of tmpDirs) {
+        try {
+            fs.rmSync(d, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpDirs.length = 0;
+});
+describe('loadConfig', () => {
+    it('loads a valid config.yml and returns typed ScaffoldConfig', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 2
+methodology: deep
+platforms:
+  - claude-code
+`);
+        const { config, errors, warnings } = loadConfig(root, []);
+        expect(errors).toHaveLength(0);
+        expect(warnings).toHaveLength(0);
+        expect(config).not.toBeNull();
+        expect(config?.version).toBe(2);
+        expect(config?.methodology).toBe('deep');
+        expect(config?.platforms).toEqual(['claude-code']);
+    });
+    it('returns CONFIG_MISSING error when config file does not exist', () => {
+        const root = makeTmpDir();
+        const { config, errors } = loadConfig(root, []);
+        expect(config).toBeNull();
+        expect(errors).toHaveLength(1);
+        expect(errors[0].code).toBe('CONFIG_MISSING');
+        expect(errors[0].exitCode).toBe(1);
+    });
+    it('returns CONFIG_PARSE_ERROR for invalid YAML syntax', () => {
+        const root = makeTmpDir();
+        writeConfig(root, 'key: [unclosed bracket');
+        const { config, errors } = loadConfig(root, []);
+        expect(config).toBeNull();
+        expect(errors).toHaveLength(1);
+        expect(errors[0].code).toBe('CONFIG_PARSE_ERROR');
+    });
+    it('returns CONFIG_EMPTY for empty config file', () => {
+        const root = makeTmpDir();
+        writeConfig(root, '');
+        const { config, errors } = loadConfig(root, []);
+        expect(config).toBeNull();
+        expect(errors).toHaveLength(1);
+        expect(errors[0].code).toBe('CONFIG_EMPTY');
+    });
+    it('returns CONFIG_NOT_OBJECT when config is not an object', () => {
+        const root = makeTmpDir();
+        writeConfig(root, 'just a string');
+        const { config, errors } = loadConfig(root, []);
+        expect(config).toBeNull();
+        expect(errors).toHaveLength(1);
+        expect(errors[0].code).toBe('CONFIG_NOT_OBJECT');
+    });
+    it('returns CONFIG_NOT_OBJECT when config is an array', () => {
+        const root = makeTmpDir();
+        writeConfig(root, '- item1\n- item2\n');
+        const { config, errors } = loadConfig(root, []);
+        expect(config).toBeNull();
+        expect(errors).toHaveLength(1);
+        expect(errors[0].code).toBe('CONFIG_NOT_OBJECT');
+    });
+    it('returns FIELD_INVALID_METHODOLOGY for unknown methodology with fuzzy suggestion', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 2
+methodology: deap
+platforms:
+  - claude-code
+`);
+        const { config, errors } = loadConfig(root, []);
+        expect(config).toBeNull();
+        expect(errors.length).toBeGreaterThan(0);
+        const err = errors.find(e => e.code === 'FIELD_INVALID_METHODOLOGY');
+        expect(err).toBeDefined();
+        expect(err?.recovery).toContain('Did you mean "deep"?');
+    });
+    it('returns FIELD_INVALID_DEPTH for depth outside 1-5 range', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 2
+methodology: custom
+platforms:
+  - claude-code
+custom:
+  steps:
+    prd:
+      depth: 9
+`);
+        const { config, errors } = loadConfig(root, ['prd']);
+        expect(config).toBeNull();
+        expect(errors.some(e => e.code === 'FIELD_INVALID_DEPTH')).toBe(true);
+    });
+    it('validates custom.steps entries match knownSteps', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 2
+methodology: custom
+platforms:
+  - claude-code
+custom:
+  steps:
+    unknown-step:
+      enabled: true
+`);
+        const { config, errors } = loadConfig(root, ['prd', 'trd']);
+        expect(config).toBeNull();
+        expect(errors.some(e => e.code === 'FIELD_INVALID_VALUE')).toBe(true);
+    });
+    it('skips custom.steps validation when knownSteps is empty', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 2
+methodology: custom
+platforms:
+  - claude-code
+custom:
+  steps:
+    any-step:
+      enabled: true
+`);
+        const { errors } = loadConfig(root, []);
+        // When knownSteps is empty, skip cross-field validation
+        expect(errors.filter(e => e.code === 'FIELD_INVALID_VALUE')).toHaveLength(0);
+    });
+    it('emits CONFIG_UNKNOWN_FIELD warning for unknown top-level fields without failing', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 2
+methodology: deep
+platforms:
+  - claude-code
+future_feature: some-value
+`);
+        const { config, errors, warnings } = loadConfig(root, []);
+        expect(config).not.toBeNull();
+        expect(errors).toHaveLength(0);
+        expect(warnings.some(w => w.code === 'CONFIG_UNKNOWN_FIELD')).toBe(true);
+        const warn = warnings.find(w => w.code === 'CONFIG_UNKNOWN_FIELD');
+        expect(warn?.context?.field).toBe('future_feature');
+    });
+    it('preserves unknown fields in returned config object (forward compatibility)', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 2
+methodology: deep
+platforms:
+  - claude-code
+future_feature: some-value
+`);
+        const { config } = loadConfig(root, []);
+        expect(config).not.toBeNull();
+        expect(config['future_feature']).toBe('some-value');
+    });
+    it('migrates v1 config: removes mixins and maps methodology names', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 1
+methodology: classic
+mixins:
+  extra: true
+`);
+        const { config, errors } = loadConfig(root, []);
+        expect(errors).toHaveLength(0);
+        expect(config).not.toBeNull();
+        expect(config?.version).toBe(2);
+        expect(config?.methodology).toBe('deep');
+        expect(Object.prototype.hasOwnProperty.call(config, 'mixins')).toBe(false);
+    });
+    it('migrates v1 config without version field', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+methodology: classic-lite
+mixins: {}
+`);
+        const { config, errors } = loadConfig(root, []);
+        expect(errors).toHaveLength(0);
+        expect(config?.version).toBe(2);
+        expect(config?.methodology).toBe('mvp');
+    });
+    it('auto-adds platforms to migrated v1 config if missing', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 1
+methodology: classic
+`);
+        const { config } = loadConfig(root, []);
+        expect(config?.platforms).toEqual(['claude-code']);
+    });
+    it('returns FIELD_WRONG_TYPE when version is an unexpected value', () => {
+        const root = makeTmpDir();
+        writeConfig(root, `
+version: 99
+methodology: deep
+platforms:
+  - claude-code
+`);
+        const { config, errors } = loadConfig(root, []);
+        expect(config).toBeNull();
+        expect(errors.some(e => e.code === 'FIELD_WRONG_TYPE')).toBe(true);
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/config/loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.js","sourceRoot":"","sources":["../../src/config/loader.test.ts"],"names":[],"mappings":"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"}

package/dist/config/migration.d.ts

@@ -0,0 +1,15 @@
+import type { ScaffoldConfig } from '../types/index.js';
+/**
+ * Migrate a v1 config object to v2 format.
+ *
+ * V1 detection: has version === 1 or no version field, may have a mixins object.
+ *
+ * Migration rules:
+ * - Remove mixins
+ * - Map methodology: 'classic' → 'deep', 'classic-lite' → 'mvp', else → 'custom'
+ * - Set version: 2
+ * - Add platforms: ['claude-code'] if missing
+ * - Preserve other fields
+ */
+export declare function migrateV1(raw: Record<string, unknown>): ScaffoldConfig;
+//# sourceMappingURL=migration.d.ts.map

package/dist/config/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/config/migration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAoBtE"}

package/dist/config/migration.js

@@ -0,0 +1,39 @@
+// src/config/migration.ts
+/**
+ * Migrate a v1 config object to v2 format.
+ *
+ * V1 detection: has version === 1 or no version field, may have a mixins object.
+ *
+ * Migration rules:
+ * - Remove mixins
+ * - Map methodology: 'classic' → 'deep', 'classic-lite' → 'mvp', else → 'custom'
+ * - Set version: 2
+ * - Add platforms: ['claude-code'] if missing
+ * - Preserve other fields
+ */
+export function migrateV1(raw) {
+    const rest = {};
+    for (const key of Object.keys(raw)) {
+        if (key !== 'mixins' && key !== 'version') {
+            rest[key] = raw[key];
+        }
+    }
+    const methodology = raw['methodology'];
+    const platforms = raw['platforms'];
+    const migratedMethodology = mapMethodology(String(methodology ?? ''));
+    const migratedPlatforms = platforms ?? ['claude-code'];
+    return {
+        ...rest,
+        version: 2,
+        methodology: migratedMethodology,
+        platforms: migratedPlatforms,
+    };
+}
+function mapMethodology(value) {
+    if (value === 'classic')
+        return 'deep';
+    if (value === 'classic-lite')
+        return 'mvp';
+    return 'custom';
+}
+//# sourceMappingURL=migration.js.map

package/dist/config/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/config/migration.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAI1B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,GAA4B;IACpD,MAAM,IAAI,GAA4B,EAAE,CAAA;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,CAAA;IAElC,MAAM,mBAAmB,GAAG,cAAc,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAA;IACrE,MAAM,iBAAiB,GAAI,SAAwD,IAAI,CAAC,aAAa,CAAC,CAAA;IAEtG,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,iBAAiB;KACX,CAAA;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACtC,IAAI,KAAK,KAAK,cAAc;QAAE,OAAO,KAAK,CAAA;IAC1C,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/config/migration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migration.test.d.ts.map

package/dist/config/migration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.test.d.ts","sourceRoot":"","sources":["../../src/config/migration.test.ts"],"names":[],"mappings":""}

package/dist/config/migration.test.js

@@ -0,0 +1,44 @@
+// src/config/migration.test.ts
+import { describe, it, expect } from 'vitest';
+import { migrateV1 } from './migration.js';
+describe('migrateV1', () => {
+    it('migrates classic methodology to deep', () => {
+        const result = migrateV1({ version: 1, methodology: 'classic', mixins: {} });
+        expect(result.methodology).toBe('deep');
+    });
+    it('migrates classic-lite methodology to mvp', () => {
+        const result = migrateV1({ methodology: 'classic-lite' });
+        expect(result.methodology).toBe('mvp');
+    });
+    it('migrates unknown methodology to custom', () => {
+        const result = migrateV1({ methodology: 'anything-else' });
+        expect(result.methodology).toBe('custom');
+    });
+    it('sets version to 2', () => {
+        const result = migrateV1({ version: 1, methodology: 'classic' });
+        expect(result.version).toBe(2);
+    });
+    it('removes mixins from output', () => {
+        const result = migrateV1({ version: 1, methodology: 'classic', mixins: { key: 'value' } });
+        expect(Object.prototype.hasOwnProperty.call(result, 'mixins')).toBe(false);
+    });
+    it('preserves platforms if already present', () => {
+        const result = migrateV1({ version: 1, methodology: 'classic', platforms: ['codex'] });
+        expect(result.platforms).toEqual(['codex']);
+    });
+    it('adds platforms claude-code if missing', () => {
+        const result = migrateV1({ version: 1, methodology: 'classic' });
+        expect(result.platforms).toEqual(['claude-code']);
+    });
+    it('preserves project if present', () => {
+        const result = migrateV1({ version: 1, methodology: 'classic', project: { name: 'my-app' } });
+        expect(result.project).toEqual({ name: 'my-app' });
+    });
+    it('handles missing version (no version field)', () => {
+        const result = migrateV1({ methodology: 'classic', mixins: {} });
+        expect(result.version).toBe(2);
+        expect(result.methodology).toBe('deep');
+        expect(Object.prototype.hasOwnProperty.call(result, 'mixins')).toBe(false);
+    });
+});
+//# sourceMappingURL=migration.test.js.map

package/dist/config/migration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.test.js","sourceRoot":"","sources":["../../src/config/migration.test.ts"],"names":[],"mappings":"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"}