@zigrivers/scaffold 2.1.0

package/dist/cli/commands/status.test.js

@@ -0,0 +1,245 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// ---------------------------------------------------------------------------
+// Hoisted mocks
+// ---------------------------------------------------------------------------
+vi.mock('../middleware/project-root.js', () => ({
+    findProjectRoot: vi.fn(),
+}));
+vi.mock('../middleware/output-mode.js', () => ({
+    resolveOutputMode: vi.fn(() => 'interactive'),
+}));
+vi.mock('../../config/loader.js', () => ({
+    loadConfig: vi.fn(() => ({ config: null, errors: [], warnings: [] })),
+}));
+vi.mock('../../state/state-manager.js', () => ({
+    StateManager: vi.fn().mockImplementation(() => ({
+        loadState: vi.fn(() => ({
+            'schema-version': 1,
+            'scaffold-version': '2.0.0',
+            init_methodology: 'deep',
+            config_methodology: 'deep',
+            'init-mode': 'greenfield',
+            created: '2024-01-01T00:00:00.000Z',
+            in_progress: null,
+            steps: {},
+            next_eligible: [],
+            'extra-steps': [],
+        })),
+    })),
+}));
+vi.mock('../../core/assembly/meta-prompt-loader.js', () => ({
+    discoverMetaPrompts: vi.fn(() => new Map()),
+}));
+vi.mock('../../core/assembly/preset-loader.js', () => ({
+    loadAllPresets: vi.fn(() => ({
+        deep: null,
+        mvp: null,
+        custom: null,
+        errors: [],
+        warnings: [],
+    })),
+}));
+// ---------------------------------------------------------------------------
+// Imports (after mocks)
+// ---------------------------------------------------------------------------
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { StateManager } from '../../state/state-manager.js';
+import { discoverMetaPrompts } from '../../core/assembly/meta-prompt-loader.js';
+import statusCommand from './status.js';
+function makeState(overrides = {}) {
+    return {
+        'schema-version': 1,
+        'scaffold-version': '2.0.0',
+        init_methodology: 'deep',
+        config_methodology: 'deep',
+        'init-mode': 'greenfield',
+        created: '2024-01-01T00:00:00.000Z',
+        in_progress: null,
+        steps: {},
+        next_eligible: [],
+        'extra-steps': [],
+        ...overrides,
+    };
+}
+function defaultArgv(overrides = {}) {
+    return {
+        phase: undefined,
+        format: undefined,
+        auto: undefined,
+        root: undefined,
+        verbose: undefined,
+        force: undefined,
+        ...overrides,
+    };
+}
+function mockStateWith(MockSM, steps, overrides = {}) {
+    MockSM.mockImplementation(() => ({
+        loadState: vi.fn(() => makeState({ steps, ...overrides })),
+    }));
+}
+function makeFrontmatter(name, phase, order) {
+    return {
+        frontmatter: {
+            name,
+            description: '',
+            phase,
+            order,
+            dependencies: [],
+            outputs: [],
+            conditional: null,
+            knowledgeBase: [],
+            reads: [],
+        },
+        stepName: name,
+        filePath: `/fake/${name}.md`,
+        body: '',
+        sections: {},
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('status command', () => {
+    let exitSpy;
+    let writtenLines;
+    const mockFindProjectRoot = vi.mocked(findProjectRoot);
+    const mockResolveOutputMode = vi.mocked(resolveOutputMode);
+    const MockStateManager = vi.mocked(StateManager);
+    const mockDiscoverMetaPrompts = vi.mocked(discoverMetaPrompts);
+    beforeEach(() => {
+        writtenLines = [];
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            writtenLines.push(String(chunk));
+            return true;
+        });
+        vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        mockResolveOutputMode.mockReturnValue('interactive');
+        mockFindProjectRoot.mockReturnValue('/fake/project');
+        mockDiscoverMetaPrompts.mockReturnValue(new Map());
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState()),
+        }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('exits 1 when project root not found', async () => {
+        mockFindProjectRoot.mockReturnValue(null);
+        await statusCommand.handler(defaultArgv());
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('outputs progress percentage to stdout', async () => {
+        const steps = {
+            'step-a': { status: 'completed', source: 'pipeline', produces: [] },
+            'step-b': { status: 'completed', source: 'pipeline', produces: [] },
+            'step-c': { status: 'pending', source: 'pipeline', produces: [] },
+            'step-d': { status: 'pending', source: 'pipeline', produces: [] },
+        };
+        mockStateWith(MockStateManager, steps, { next_eligible: [] });
+        await statusCommand.handler(defaultArgv());
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('50%');
+        expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+    it('shows correct status icons for completed and pending steps', async () => {
+        const steps = {
+            'step-a': { status: 'completed', source: 'pipeline', produces: [] },
+            'step-b': { status: 'pending', source: 'pipeline', produces: [] },
+        };
+        mockStateWith(MockStateManager, steps, { next_eligible: [] });
+        await statusCommand.handler(defaultArgv());
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('✓');
+        expect(allOutput).toContain('○');
+        expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+    it('JSON mode returns correct StatusResult shape', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        const steps = {
+            'step-a': { status: 'completed', source: 'pipeline', produces: [] },
+            'step-b': { status: 'skipped', source: 'pipeline', produces: [] },
+            'step-c': { status: 'pending', source: 'pipeline', produces: [] },
+            'step-d': { status: 'in_progress', source: 'pipeline', produces: [] },
+        };
+        mockStateWith(MockStateManager, steps, { next_eligible: ['step-c'] });
+        await statusCommand.handler(defaultArgv({ format: 'json' }));
+        const envelope = JSON.parse(writtenLines.join(''));
+        const parsed = envelope.data ?? envelope;
+        expect(parsed).toHaveProperty('pipeline');
+        expect(parsed).toHaveProperty('progress');
+        expect(parsed).toHaveProperty('phases');
+        expect(parsed).toHaveProperty('nextEligible');
+        expect(parsed).toHaveProperty('orphaned_entries');
+        expect(parsed.progress.completed).toBe(1);
+        expect(parsed.progress.skipped).toBe(1);
+        expect(parsed.progress.pending).toBe(1);
+        expect(parsed.progress.inProgress).toBe(1);
+        expect(parsed.progress.total).toBe(4);
+        expect(parsed.progress.percentage).toBe(50);
+        expect(Array.isArray(parsed.phases)).toBe(true);
+        expect(Array.isArray(parsed.nextEligible)).toBe(true);
+        expect(Array.isArray(parsed.orphaned_entries)).toBe(true);
+    });
+    it('--phase filter shows only steps matching that phase number', async () => {
+        const metaPrompts = new Map([
+            ['step-a', makeFrontmatter('step-a', '1', 1)],
+            ['step-b', makeFrontmatter('step-b', '2', 2)],
+        ]);
+        mockDiscoverMetaPrompts.mockReturnValue(metaPrompts);
+        const steps = {
+            'step-a': { status: 'completed', source: 'pipeline', produces: [] },
+            'step-b': { status: 'pending', source: 'pipeline', produces: [] },
+        };
+        mockStateWith(MockStateManager, steps, { next_eligible: [] });
+        await statusCommand.handler(defaultArgv({ phase: 1 }));
+        const stepLines = writtenLines
+            .join('')
+            .split('\n')
+            .filter(l => l.includes('[completed]') || l.includes('[pending]'));
+        expect(stepLines.some(l => l.includes('step-a'))).toBe(true);
+        expect(stepLines.some(l => l.includes('step-b'))).toBe(false);
+    });
+    it('shows next eligible steps', async () => {
+        const steps = {
+            'step-a': { status: 'completed', source: 'pipeline', produces: [] },
+            'step-b': { status: 'pending', source: 'pipeline', produces: [] },
+        };
+        mockStateWith(MockStateManager, steps, { next_eligible: ['step-b'] });
+        await statusCommand.handler(defaultArgv());
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('step-b');
+        expect(allOutput).toContain('Next eligible');
+    });
+    it('handles empty pipeline with 0% and shows none for next eligible', async () => {
+        mockStateWith(MockStateManager, {}, { next_eligible: [] });
+        await statusCommand.handler(defaultArgv());
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('0%');
+        expect(allOutput).toContain('none');
+        expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+    it('calculates percentage: completed+skipped count, pending+in_progress do not', async () => {
+        const steps = {
+            's1': { status: 'completed', source: 'pipeline', produces: [] },
+            's2': { status: 'completed', source: 'pipeline', produces: [] },
+            's3': { status: 'completed', source: 'pipeline', produces: [] },
+            's4': { status: 'skipped', source: 'pipeline', produces: [] },
+            's5': { status: 'pending', source: 'pipeline', produces: [] },
+            's6': { status: 'in_progress', source: 'pipeline', produces: [] },
+        };
+        mockStateWith(MockStateManager, steps, { next_eligible: [] });
+        mockResolveOutputMode.mockReturnValue('json');
+        await statusCommand.handler(defaultArgv({ format: 'json' }));
+        const envelope = JSON.parse(writtenLines.join(''));
+        const parsed = envelope.data ?? envelope;
+        expect(parsed.progress.percentage).toBe(67);
+        expect(parsed.progress.completed).toBe(3);
+        expect(parsed.progress.skipped).toBe(1);
+        expect(parsed.progress.pending).toBe(1);
+        expect(parsed.progress.inProgress).toBe(1);
+        expect(parsed.progress.total).toBe(6);
+    });
+});
+//# sourceMappingURL=status.test.js.map

package/dist/cli/commands/status.test.js.map

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

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,11 @@
+import type { CommandModule } from 'yargs';
+interface UpdateArgs {
+    'check-only': boolean;
+    'skip-build': boolean;
+    format?: string;
+    auto?: boolean;
+    verbose?: boolean;
+}
+declare const updateCommand: CommandModule<Record<string, unknown>, UpdateArgs>;
+export default updateCommand;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAQ,MAAM,OAAO,CAAA;AAOhD,UAAU,UAAU;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AA2ED,QAAA,MAAM,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAmFrE,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/cli/commands/update.js

@@ -0,0 +1,159 @@
+import { execSync } from 'node:child_process';
+import https from 'node:https';
+import fs from 'node:fs';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { createOutputContext } from '../output/context.js';
+/**
+ * Read the installed version from package.json.
+ * Falls back to '0.0.0' if not found.
+ */
+function readInstalledVersion() {
+    try {
+        const locations = [
+            new URL('../../../package.json', import.meta.url),
+            new URL('../../../../package.json', import.meta.url),
+        ];
+        for (const loc of locations) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(loc.pathname, 'utf8'));
+                if (pkg.version)
+                    return pkg.version;
+            }
+            catch {
+                // try next location
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return '0.0.0';
+}
+/**
+ * Detect the install channel and return the appropriate upgrade command.
+ */
+function detectInstallChannel() {
+    const execPath = process.execPath;
+    if (execPath.includes('/opt/homebrew/') || execPath.includes('/usr/local/Cellar/')) {
+        return { channel: 'homebrew', upgradeCommand: 'brew upgrade scaffold' };
+    }
+    try {
+        execSync('npm list -g @zigrivers/scaffold 2>/dev/null', { stdio: 'pipe' });
+        return { channel: 'npm-global', upgradeCommand: 'npm update -g @zigrivers/scaffold' };
+    }
+    catch {
+        // not npm global
+    }
+    return { channel: 'npx', upgradeCommand: 'npx @zigrivers/scaffold@latest' };
+}
+/**
+ * Fetch the latest version from the npm registry.
+ * Times out after 3 seconds and returns null on failure.
+ */
+function fetchLatestVersion(packageName) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => resolve(null), 3000);
+        const req = https.get(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`, (res) => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += String(chunk);
+            });
+            res.on('end', () => {
+                clearTimeout(timeout);
+                try {
+                    const parsed = JSON.parse(data);
+                    resolve(parsed.version ?? null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', () => {
+            clearTimeout(timeout);
+            resolve(null);
+        });
+    });
+}
+const updateCommand = {
+    command: 'update',
+    describe: 'Check for and display scaffold CLI updates',
+    builder: (yargs) => {
+        return yargs
+            .option('check-only', {
+            type: 'boolean',
+            description: 'Check for updates without installing',
+            default: false,
+        })
+            .option('skip-build', {
+            type: 'boolean',
+            description: 'Skip auto-rebuild after update',
+            default: false,
+        });
+    },
+    handler: async (argv) => {
+        const outputMode = resolveOutputMode(argv);
+        const output = createOutputContext(outputMode);
+        const currentVersion = readInstalledVersion();
+        const { channel, upgradeCommand } = detectInstallChannel();
+        // Dependency injection for testability
+        const _fetchLatestVersion = argv._fetchLatestVersion ?? fetchLatestVersion;
+        let latestVersion = null;
+        try {
+            latestVersion = await _fetchLatestVersion('@zigrivers/scaffold');
+        }
+        catch {
+            // network error — latestVersion stays null
+        }
+        const updateAvailable = latestVersion !== null && latestVersion !== currentVersion;
+        if (argv['check-only']) {
+            if (outputMode === 'json') {
+                output.result({
+                    current_version: currentVersion,
+                    latest_version: latestVersion,
+                    update_available: updateAvailable,
+                    channel,
+                });
+            }
+            else {
+                output.info(`scaffold v${currentVersion} (installed via ${channel})`);
+                if (latestVersion !== null) {
+                    if (updateAvailable) {
+                        output.info(`Update available: v${latestVersion} \u2014 run: ${upgradeCommand}`);
+                    }
+                    else {
+                        output.success('Up to date');
+                    }
+                }
+                else {
+                    output.info('Could not check for updates (network unavailable)');
+                }
+            }
+            process.exit(0);
+            return;
+        }
+        // Default: check and instruct (we don't run installs from within CLI)
+        if (updateAvailable) {
+            output.info(`Update available: v${latestVersion}`);
+            output.info(`Run: ${upgradeCommand}`);
+        }
+        else if (latestVersion !== null) {
+            output.success(`scaffold v${currentVersion} is up to date`);
+        }
+        else {
+            output.info(`Could not check for updates. Run: ${upgradeCommand}`);
+        }
+        if (outputMode === 'json') {
+            output.result({
+                updated: false,
+                previous_version: currentVersion,
+                new_version: latestVersion,
+                changelog: [],
+                rebuild_result: null,
+            });
+        }
+        process.exit(0);
+    },
+};
+export default updateCommand;
+//# sourceMappingURL=update.js.map

package/dist/cli/commands/update.js.map

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

package/dist/cli/commands/update.test.d.ts

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

package/dist/cli/commands/update.test.d.ts.map

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

package/dist/cli/commands/update.test.js

@@ -0,0 +1,140 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// ---------------------------------------------------------------------------
+// Hoisted mocks
+// ---------------------------------------------------------------------------
+vi.mock('../middleware/output-mode.js', () => ({
+    resolveOutputMode: vi.fn(() => 'interactive'),
+}));
+// ---------------------------------------------------------------------------
+// Imports (after mocks)
+// ---------------------------------------------------------------------------
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import updateCommand from './update.js';
+function makeArgv(overrides = {}) {
+    return {
+        'check-only': false,
+        'skip-build': false,
+        format: undefined,
+        auto: undefined,
+        verbose: undefined,
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('update command', () => {
+    let exitSpy;
+    let stdoutSpy;
+    let writtenLines;
+    const mockResolveOutputMode = vi.mocked(resolveOutputMode);
+    beforeEach(() => {
+        writtenLines = [];
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            writtenLines.push(String(chunk));
+            return true;
+        });
+        vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        mockResolveOutputMode.mockReturnValue('interactive');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    // Test 1: --check-only shows current and latest version
+    it('--check-only shows current version and latest version info', async () => {
+        const mockFetch = vi.fn().mockResolvedValue('9.9.9');
+        const argv = makeArgv({
+            'check-only': true,
+            _fetchLatestVersion: mockFetch,
+        });
+        await updateCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        // Should mention current version or latest
+        expect(allOutput).toMatch(/scaffold v|Up to date|Update available|update/);
+    });
+    // Test 2: Network failure returns null latest_version in JSON mode
+    it('network failure resolves gracefully with null latest_version in JSON', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        const mockFetch = vi.fn().mockResolvedValue(null);
+        const argv = makeArgv({
+            'check-only': true,
+            format: 'json',
+            _fetchLatestVersion: mockFetch,
+        });
+        await updateCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        const parsed = JSON.parse(allOutput);
+        const data = parsed.data ?? parsed;
+        expect(data.latest_version).toBeNull();
+    });
+    // Test 3: JSON output has correct shape
+    it('JSON output has correct shape with required fields', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        const mockFetch = vi.fn().mockResolvedValue('2.0.0');
+        const argv = makeArgv({
+            format: 'json',
+            _fetchLatestVersion: mockFetch,
+        });
+        await updateCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        const parsed = JSON.parse(allOutput);
+        const data = parsed.data ?? parsed;
+        expect(data).toHaveProperty('updated');
+        expect(data).toHaveProperty('previous_version');
+        expect(data).toHaveProperty('new_version');
+        expect(data).toHaveProperty('changelog');
+        expect(data).toHaveProperty('rebuild_result');
+        expect(Array.isArray(data.changelog)).toBe(true);
+    });
+    // Test 4: Shows "up to date" when versions match (network returns null, no update)
+    it('shows informational output when network returns null', async () => {
+        const mockFetch = vi.fn().mockResolvedValue(null);
+        const argv = makeArgv({
+            _fetchLatestVersion: mockFetch,
+        });
+        await updateCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        // Either "up to date" or "could not check" — both are valid when no network
+        const allOutput = writtenLines.join('');
+        expect(allOutput.length).toBeGreaterThan(0);
+    });
+    // Test 5: Shows upgrade command when update available
+    it('shows upgrade command when an update is available', async () => {
+        // Returning a version that is different from installed → update available
+        const mockFetch = vi.fn().mockResolvedValue('99.99.99');
+        const argv = makeArgv({
+            _fetchLatestVersion: mockFetch,
+        });
+        await updateCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        // Should show upgrade command or update info
+        expect(allOutput).toMatch(/Update available|Run:|99\.99\.99/);
+    });
+    // Test 6: --check-only JSON output has correct shape
+    it('--check-only JSON output has current_version, latest_version, update_available, channel', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        const mockFetch = vi.fn().mockResolvedValue('3.0.0');
+        const argv = makeArgv({
+            'check-only': true,
+            format: 'json',
+            _fetchLatestVersion: mockFetch,
+        });
+        await updateCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        const parsed = JSON.parse(allOutput);
+        const data = parsed.data ?? parsed;
+        expect(data).toHaveProperty('current_version');
+        expect(data).toHaveProperty('latest_version', '3.0.0');
+        expect(data).toHaveProperty('update_available');
+        expect(data).toHaveProperty('channel');
+        // Silence unused variable warnings
+        void stdoutSpy;
+    });
+});
+//# sourceMappingURL=update.test.js.map

package/dist/cli/commands/update.test.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,12 @@
+import type { CommandModule } from 'yargs';
+interface ValidateArgs {
+    format?: string;
+    auto?: boolean;
+    verbose?: boolean;
+    root?: string;
+    force?: boolean;
+    scope?: string;
+}
+declare const validateCommand: CommandModule<Record<string, unknown>, ValidateArgs>;
+export default validateCommand;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAQ1C,UAAU,YAAY;IACpB,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;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,QAAA,MAAM,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAkEzE,CAAA;AAED,eAAe,eAAe,CAAA"}