@zigrivers/scaffold 2.1.0

package/dist/cli/output/error-display.test.js

@@ -0,0 +1,230 @@
+import { describe, it, expect, vi } from 'vitest';
+import { ExitCode } from '../../types/index.js';
+import { formatError, formatWarning, formatBatch, formatErrorWithSuggestion, displayErrors, } from './error-display.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeError(overrides = {}) {
+    return {
+        code: 'CONFIG_MISSING',
+        message: 'The configuration file was not found',
+        exitCode: ExitCode.ValidationError,
+        ...overrides,
+    };
+}
+function makeWarning(overrides = {}) {
+    return {
+        code: 'CONFIG_UNKNOWN_FIELD',
+        message: 'Unknown field in configuration',
+        ...overrides,
+    };
+}
+function makeMockOutput() {
+    return {
+        success: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        result: vi.fn(),
+        prompt: vi.fn(),
+        confirm: vi.fn(),
+        startSpinner: vi.fn(),
+        stopSpinner: vi.fn(),
+        startProgress: vi.fn(),
+        updateProgress: vi.fn(),
+        stopProgress: vi.fn(),
+    };
+}
+// ---------------------------------------------------------------------------
+// formatError
+// ---------------------------------------------------------------------------
+describe('formatError', () => {
+    it('produces ✗ error [CODE]: message on the first line', () => {
+        const err = makeError();
+        const result = formatError(err);
+        const firstLine = result.split('\n')[0];
+        expect(firstLine).toBe('✗ error [CONFIG_MISSING]: The configuration file was not found');
+    });
+    it('includes File: line when context.file is set', () => {
+        const err = makeError({ context: { file: '.scaffold/config.yml' } });
+        const result = formatError(err);
+        expect(result).toContain('  File: .scaffold/config.yml');
+    });
+    it('includes Line: line when context.line is set', () => {
+        const err = makeError({ context: { line: 42 } });
+        const result = formatError(err);
+        expect(result).toContain('  Line: 42');
+    });
+    it('includes Fix: line when recovery is set', () => {
+        const err = makeError({ recovery: 'Run `scaffold init` to create the configuration file' });
+        const result = formatError(err);
+        expect(result).toContain('  Fix: Run `scaffold init` to create the configuration file');
+    });
+    it('excludes optional lines when context is empty and recovery is absent', () => {
+        const err = makeError();
+        const result = formatError(err);
+        expect(result).not.toContain('File:');
+        expect(result).not.toContain('Line:');
+        expect(result).not.toContain('Fix:');
+        // Only one line
+        expect(result.split('\n').length).toBe(1);
+    });
+    it('includes all optional lines when all fields are present', () => {
+        const err = makeError({
+            context: { file: 'config.yml', line: 10 },
+            recovery: 'Fix the config',
+        });
+        const result = formatError(err);
+        const lines = result.split('\n');
+        expect(lines[0]).toBe('✗ error [CONFIG_MISSING]: The configuration file was not found');
+        expect(lines[1]).toBe('  File: config.yml');
+        expect(lines[2]).toBe('  Line: 10');
+        expect(lines[3]).toBe('  Fix: Fix the config');
+    });
+});
+// ---------------------------------------------------------------------------
+// formatWarning
+// ---------------------------------------------------------------------------
+describe('formatWarning', () => {
+    it('produces ⚠ warning [CODE]: message', () => {
+        const warn = makeWarning();
+        const result = formatWarning(warn);
+        expect(result).toBe('⚠ warning [CONFIG_UNKNOWN_FIELD]: Unknown field in configuration');
+    });
+    it('uses the correct code and message', () => {
+        const warn = makeWarning({ code: 'DEPRECATED_KEY', message: 'This key is deprecated' });
+        const result = formatWarning(warn);
+        expect(result).toBe('⚠ warning [DEPRECATED_KEY]: This key is deprecated');
+    });
+});
+// ---------------------------------------------------------------------------
+// formatBatch
+// ---------------------------------------------------------------------------
+describe('formatBatch', () => {
+    it('returns empty array for empty inputs', () => {
+        const result = formatBatch([], []);
+        expect(result).toEqual([]);
+    });
+    it('returns formatted errors when only errors are present', () => {
+        const errors = [makeError(), makeError({ code: 'SECOND_ERROR', message: 'Second problem' })];
+        const result = formatBatch(errors, []);
+        expect(result).toHaveLength(2);
+        expect(result[0]).toContain('✗ error [CONFIG_MISSING]');
+        expect(result[1]).toContain('✗ error [SECOND_ERROR]');
+    });
+    it('returns formatted warnings when only warnings are present', () => {
+        const warnings = [makeWarning(), makeWarning({ code: 'ANOTHER_WARN', message: 'Watch out again' })];
+        const result = formatBatch([], warnings);
+        expect(result).toHaveLength(2);
+        expect(result[0]).toContain('⚠ warning [CONFIG_UNKNOWN_FIELD]');
+        expect(result[1]).toContain('⚠ warning [ANOTHER_WARN]');
+    });
+    it('puts errors before warnings', () => {
+        const errors = [makeError()];
+        const warnings = [makeWarning()];
+        const result = formatBatch(errors, warnings);
+        expect(result).toHaveLength(2);
+        expect(result[0]).toContain('✗ error');
+        expect(result[1]).toContain('⚠ warning');
+    });
+    it('handles multiple errors and warnings in correct order', () => {
+        const errors = [
+            makeError({ code: 'ERR_1', message: 'Error 1' }),
+            makeError({ code: 'ERR_2', message: 'Error 2' }),
+        ];
+        const warnings = [
+            makeWarning({ code: 'WARN_1', message: 'Warning 1' }),
+            makeWarning({ code: 'WARN_2', message: 'Warning 2' }),
+        ];
+        const result = formatBatch(errors, warnings);
+        expect(result).toHaveLength(4);
+        expect(result[0]).toContain('[ERR_1]');
+        expect(result[1]).toContain('[ERR_2]');
+        expect(result[2]).toContain('[WARN_1]');
+        expect(result[3]).toContain('[WARN_2]');
+    });
+});
+// ---------------------------------------------------------------------------
+// formatErrorWithSuggestion
+// ---------------------------------------------------------------------------
+describe('formatErrorWithSuggestion', () => {
+    it('appends "Did you mean...?" when a close match is found', () => {
+        const err = makeError({ context: { value: 'configg' } });
+        const candidates = ['config', 'context', 'content'];
+        const result = formatErrorWithSuggestion(err, candidates);
+        expect(result).toContain('Did you mean \'config\'?');
+    });
+    it('does not append suggestion when no candidate is within distance', () => {
+        const err = makeError({ context: { value: 'zzzzzzzzz' } });
+        const candidates = ['config', 'context', 'content'];
+        const result = formatErrorWithSuggestion(err, candidates);
+        expect(result).not.toContain('Did you mean');
+    });
+    it('still formats error normally when suggestion is appended', () => {
+        const err = makeError({ context: { value: 'configg' } });
+        const result = formatErrorWithSuggestion(err, ['config']);
+        const firstLine = result.split('\n')[0];
+        expect(firstLine).toContain('✗ error [CONFIG_MISSING]');
+        expect(firstLine).toContain('The configuration file was not found');
+        expect(firstLine).toContain('Did you mean \'config\'?');
+    });
+    it('works with empty candidates array (no suggestion)', () => {
+        const err = makeError({ context: { value: 'config' } });
+        const result = formatErrorWithSuggestion(err, []);
+        expect(result).not.toContain('Did you mean');
+    });
+    it('works when context.value is undefined (no suggestion)', () => {
+        const err = makeError({ context: {} });
+        const candidates = ['config', 'context'];
+        const result = formatErrorWithSuggestion(err, candidates);
+        expect(result).not.toContain('Did you mean');
+    });
+    it('works when context is undefined (no suggestion)', () => {
+        const err = makeError();
+        const candidates = ['config', 'context'];
+        const result = formatErrorWithSuggestion(err, candidates);
+        expect(result).not.toContain('Did you mean');
+    });
+});
+// ---------------------------------------------------------------------------
+// displayErrors
+// ---------------------------------------------------------------------------
+describe('displayErrors', () => {
+    it('calls output.error() for each error', () => {
+        const output = makeMockOutput();
+        const errors = [
+            makeError({ code: 'ERR_A' }),
+            makeError({ code: 'ERR_B' }),
+        ];
+        displayErrors(errors, [], output);
+        expect(output.error).toHaveBeenCalledTimes(2);
+        expect(vi.mocked(output.error).mock.calls[0]?.[0]).toMatchObject({ code: 'ERR_A' });
+        expect(vi.mocked(output.error).mock.calls[1]?.[0]).toMatchObject({ code: 'ERR_B' });
+    });
+    it('calls output.warn() for each warning', () => {
+        const output = makeMockOutput();
+        const warnings = [
+            makeWarning({ code: 'WARN_A' }),
+            makeWarning({ code: 'WARN_B' }),
+        ];
+        displayErrors([], warnings, output);
+        expect(output.warn).toHaveBeenCalledTimes(2);
+        expect(vi.mocked(output.warn).mock.calls[0]?.[0]).toMatchObject({ code: 'WARN_A' });
+        expect(vi.mocked(output.warn).mock.calls[1]?.[0]).toMatchObject({ code: 'WARN_B' });
+    });
+    it('calls both output.error() and output.warn() together', () => {
+        const output = makeMockOutput();
+        const errors = [makeError()];
+        const warnings = [makeWarning()];
+        displayErrors(errors, warnings, output);
+        expect(output.error).toHaveBeenCalledTimes(1);
+        expect(output.warn).toHaveBeenCalledTimes(1);
+    });
+    it('calls nothing when arrays are empty', () => {
+        const output = makeMockOutput();
+        displayErrors([], [], output);
+        expect(output.error).not.toHaveBeenCalled();
+        expect(output.warn).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=error-display.test.js.map

package/dist/cli/output/error-display.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-display.test.js","sourceRoot":"","sources":["../../../src/cli/output/error-display.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAG/C,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,aAAa,GACd,MAAM,oBAAoB,CAAA;AAE3B,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,SAAS,CAAC,YAAoC,EAAE;IACvD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,sCAAsC;QAC/C,QAAQ,EAAE,QAAQ,CAAC,eAAe;QAClC,GAAG,SAAS;KACb,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,YAAsC,EAAE;IAC3D,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,gCAAgC;QACzC,GAAG,SAAS;KACb,CAAA;AACH,CAAC;AAED,SAAS,cAAc;IACrB,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;QAChB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;QACf,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;QACf,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;QACrB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE;QACtB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;QACvB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;KACtB,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;QACvB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;IAC1F,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAA;QACpE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QAChD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,sDAAsD,EAAE,CAAC,CAAA;QAC3F,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,6DAA6D,CAAC,CAAA;IACzF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;QACvB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACpC,gBAAgB;QAChB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,GAAG,GAAG,SAAS,CAAC;YACpB,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE;YACzC,QAAQ,EAAE,gBAAgB;SAC3B,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;QACvF,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,IAAI,GAAG,WAAW,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAA;IACzF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAA;QACvF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAA;QAC5F,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAA;QACnG,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAA;QAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAA;QAC5B,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG;YACb,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YAChD,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;SACjD,CAAA;QACD,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YACrD,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;SACtD,CAAA;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;QACxD,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAA;QAC1D,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAA;QACvD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,sCAAsC,CAAC,CAAA;QACnE,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAA;QACvD,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;QACjD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;QACtC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QACxC,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;QACvB,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QACxC,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG;YACb,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC5B,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SAC7B,CAAA;QACD,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;QACjC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;QACnF,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACrF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;QAC/B,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAChC,CAAA;QACD,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAC5C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;QACnF,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IACrF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAA;QAC5B,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;QAChC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;QAC/B,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;IAC5C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/cli/output/interactive.d.ts

@@ -0,0 +1,22 @@
+import type { ScaffoldError, ScaffoldWarning } from '../../types/index.js';
+import type { OutputContext } from './context.js';
+export declare class InteractiveOutput implements OutputContext {
+    private spinnerInterval;
+    private spinnerFrame;
+    private progressTotal;
+    private progressLabel;
+    success(message: string): void;
+    info(message: string): void;
+    warn(warning: ScaffoldWarning | string): void;
+    error(error: ScaffoldError | string): void;
+    result(data: unknown): void;
+    prompt<T>(message: string, defaultValue: T): Promise<T>;
+    confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+    startSpinner(message: string): void;
+    stopSpinner(success?: boolean): void;
+    startProgress(total: number, label: string): void;
+    updateProgress(current: number): void;
+    stopProgress(): void;
+    private renderProgress;
+}
+//# sourceMappingURL=interactive.d.ts.map

package/dist/cli/output/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/cli/output/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAqCjD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IAK7C,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;IAW1C,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIrB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBvD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAStE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUnC,WAAW,CAAC,OAAO,UAAO,GAAG,IAAI;IAYjC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMjD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrC,YAAY,IAAI,IAAI;IAMpB,OAAO,CAAC,cAAc;CASvB"}

package/dist/cli/output/interactive.js

@@ -0,0 +1,126 @@
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+function isNoColor() {
+    return !!process.env['NO_COLOR'];
+}
+function isTTY() {
+    return process.stdout.isTTY === true;
+}
+function green(s) {
+    return isNoColor() || !isTTY() ? s : `\x1b[32m${s}\x1b[0m`;
+}
+function red(s) {
+    return isNoColor() || !isTTY() ? s : `\x1b[31m${s}\x1b[0m`;
+}
+function yellow(s) {
+    return isNoColor() || !isTTY() ? s : `\x1b[33m${s}\x1b[0m`;
+}
+// cyan is available for future use
+// function cyan(s: string): string {
+//   return isNoColor() || !isTTY() ? s : `\x1b[36m${s}\x1b[0m`
+// }
+function isScaffoldError(e) {
+    return typeof e === 'object' && e !== null && 'code' in e && 'message' in e;
+}
+function isScaffoldWarning(w) {
+    return typeof w === 'object' && w !== null && 'code' in w && 'message' in w;
+}
+export class InteractiveOutput {
+    spinnerInterval = null;
+    spinnerFrame = 0;
+    progressTotal = 0;
+    progressLabel = '';
+    success(message) {
+        process.stdout.write(green(`✓ ${message}`) + '\n');
+    }
+    info(message) {
+        process.stdout.write(`→ ${message}\n`);
+    }
+    warn(warning) {
+        const msg = isScaffoldWarning(warning) ? warning.message : warning;
+        process.stdout.write(yellow(`⚠ ${msg}`) + '\n');
+    }
+    error(error) {
+        if (isScaffoldError(error)) {
+            process.stdout.write(red(`✗ ${error.code}: ${error.message}`) + '\n');
+            if (error.recovery) {
+                process.stdout.write(`  Recovery: ${error.recovery}\n`);
+            }
+        }
+        else {
+            process.stdout.write(red(`✗ ${error}`) + '\n');
+        }
+    }
+    result(data) {
+        process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+    }
+    async prompt(message, defaultValue) {
+        // Non-TTY or NO_COLOR: return default immediately
+        if (!isTTY() || isNoColor()) {
+            return defaultValue;
+        }
+        // In TTY mode, use @inquirer/prompts
+        const { input } = await import('@inquirer/prompts');
+        const answer = await input({ message, default: String(defaultValue) });
+        // Attempt to preserve original type
+        if (typeof defaultValue === 'number') {
+            return Number(answer);
+        }
+        if (typeof defaultValue === 'boolean') {
+            return (answer === 'true');
+        }
+        return answer;
+    }
+    async confirm(message, defaultValue = false) {
+        // Non-TTY or NO_COLOR: return default immediately
+        if (!isTTY() || isNoColor()) {
+            return defaultValue;
+        }
+        const { confirm } = await import('@inquirer/prompts');
+        return confirm({ message, default: defaultValue });
+    }
+    startSpinner(message) {
+        if (!isTTY() || isNoColor())
+            return;
+        this.spinnerFrame = 0;
+        this.spinnerInterval = setInterval(() => {
+            const frame = SPINNER_FRAMES[this.spinnerFrame % SPINNER_FRAMES.length] ?? '⠋';
+            process.stdout.write(`\r${frame} ${message}`);
+            this.spinnerFrame++;
+        }, 80);
+    }
+    stopSpinner(success = true) {
+        if (this.spinnerInterval !== null) {
+            clearInterval(this.spinnerInterval);
+            this.spinnerInterval = null;
+            // Clear spinner line
+            process.stdout.write('\r\x1b[K');
+        }
+        if (success) {
+            // Spinner stopped successfully — caller will call success() if needed
+        }
+    }
+    startProgress(total, label) {
+        this.progressTotal = total;
+        this.progressLabel = label;
+        this.renderProgress(0);
+    }
+    updateProgress(current) {
+        this.renderProgress(current);
+    }
+    stopProgress() {
+        process.stdout.write('\n');
+        this.progressTotal = 0;
+        this.progressLabel = '';
+    }
+    renderProgress(current) {
+        if (!isTTY() || isNoColor())
+            return;
+        const BAR_WIDTH = 50;
+        const ratio = this.progressTotal > 0 ? current / this.progressTotal : 0;
+        const filled = Math.round(ratio * BAR_WIDTH);
+        const empty = BAR_WIDTH - filled;
+        const bar = '█'.repeat(filled) + '░'.repeat(empty);
+        process.stdout.write(`\r[${bar}] ${current}/${this.progressTotal} ${this.progressLabel}`);
+    }
+}
+//# sourceMappingURL=interactive.js.map

package/dist/cli/output/interactive.js.map

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

package/dist/cli/output/json.d.ts

@@ -0,0 +1,17 @@
+import type { ScaffoldError, ScaffoldWarning } from '../../types/index.js';
+import type { OutputContext } from './context.js';
+export declare class JsonOutput implements OutputContext {
+    success(message: string): void;
+    info(message: string): void;
+    warn(warning: ScaffoldWarning | string): void;
+    error(error: ScaffoldError | string): void;
+    result(data: unknown): void;
+    prompt<T>(message: string, defaultValue: T): Promise<T>;
+    confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+    startSpinner(message: string): void;
+    stopSpinner(success?: boolean): void;
+    startProgress(total: number, label: string): void;
+    updateProgress(current: number): void;
+    stopProgress(): void;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/cli/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/cli/output/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAUjD,qBAAa,UAAW,YAAW,aAAa;IAC9C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IAK7C,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;IAW1C,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIrB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMvD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAKpC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMjD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKrC,YAAY,IAAI,IAAI;CAGrB"}

package/dist/cli/output/json.js

@@ -0,0 +1,62 @@
+function isScaffoldError(e) {
+    return typeof e === 'object' && e !== null && 'code' in e && 'message' in e;
+}
+function isScaffoldWarning(w) {
+    return typeof w === 'object' && w !== null && 'code' in w && 'message' in w;
+}
+export class JsonOutput {
+    success(message) {
+        process.stderr.write(`✓ ${message}\n`);
+    }
+    info(message) {
+        process.stderr.write(`→ ${message}\n`);
+    }
+    warn(warning) {
+        const msg = isScaffoldWarning(warning) ? warning.message : warning;
+        process.stderr.write(`⚠ ${msg}\n`);
+    }
+    error(error) {
+        if (isScaffoldError(error)) {
+            process.stderr.write(`✗ ${error.code}: ${error.message}\n`);
+            if (error.recovery) {
+                process.stderr.write(`  Recovery: ${error.recovery}\n`);
+            }
+        }
+        else {
+            process.stderr.write(`✗ ${error}\n`);
+        }
+    }
+    result(data) {
+        process.stdout.write(JSON.stringify({ success: true, data }) + '\n');
+    }
+    async prompt(message, defaultValue) {
+        process.stderr.write(`Using default: ${String(defaultValue)}\n`);
+        void message;
+        return defaultValue;
+    }
+    async confirm(message, defaultValue = false) {
+        void message;
+        return defaultValue;
+    }
+    startSpinner(message) {
+        void message;
+        // no-op
+    }
+    stopSpinner(success) {
+        void success;
+        // no-op
+    }
+    startProgress(total, label) {
+        void total;
+        void label;
+        // no-op
+    }
+    updateProgress(current) {
+        void current;
+        // no-op
+    }
+    stopProgress() {
+        // no-op
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/cli/output/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/cli/output/json.ts"],"names":[],"mappings":"AAGA,SAAS,eAAe,CAAC,CAAyB;IAChD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,iBAAiB,CAAC,CAA2B;IACpD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,OAAO,UAAU;IACrB,OAAO,CAAC,OAAe;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,IAAI,CAAC,CAAA;IACxC,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,IAAI,CAAC,CAAA;IACxC,CAAC;IAED,IAAI,CAAC,OAAiC;QACpC,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;QAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,KAA6B;QACjC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC,CAAA;YAC3D,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAA;YACzD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAa;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,OAAe,EAAE,YAAe;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAChE,KAAK,OAAO,CAAA;QACZ,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,YAAY,GAAG,KAAK;QACjD,KAAK,OAAO,CAAA;QACZ,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,KAAK,OAAO,CAAA;QACZ,QAAQ;IACV,CAAC;IAED,WAAW,CAAC,OAAiB;QAC3B,KAAK,OAAO,CAAA;QACZ,QAAQ;IACV,CAAC;IAED,aAAa,CAAC,KAAa,EAAE,KAAa;QACxC,KAAK,KAAK,CAAA;QACV,KAAK,KAAK,CAAA;QACV,QAAQ;IACV,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,KAAK,OAAO,CAAA;QACZ,QAAQ;IACV,CAAC;IAED,YAAY;QACV,QAAQ;IACV,CAAC;CACF"}

package/dist/cli/types.d.ts

@@ -0,0 +1,11 @@
+import type { ScaffoldError, ScaffoldWarning } from '../types/index.js';
+/** Global flags available to all commands. */
+export interface GlobalArgs {
+    format?: 'json';
+    auto?: boolean;
+    verbose?: boolean;
+    root?: string;
+    force?: boolean;
+}
+export type { ScaffoldError, ScaffoldWarning };
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEvE,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAA"}

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":""}

package/dist/config/loader.d.ts

@@ -0,0 +1,22 @@
+import type { ScaffoldConfig } from '../types/index.js';
+import type { ScaffoldError, ScaffoldWarning } from '../utils/errors.js';
+/** Result of loadConfig. */
+interface LoadResult {
+    config: ScaffoldConfig | null;
+    errors: ScaffoldError[];
+    warnings: ScaffoldWarning[];
+}
+/**
+ * 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 declare function loadConfig(projectRoot: string, knownSteps: string[]): LoadResult;
+export {};
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAsBxE,4BAA4B;AAC5B,UAAU,UAAU;IAClB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,CAyIhF"}