@testivai/witness-playwright 1.0.0

package/__tests__/unit/types.spec.ts

@@ -0,0 +1,179 @@
+/**
+ * @jest-environment node
+ * 
+ * Tests to verify that all renamed types are correctly exported
+ * and that the public API no longer exposes internal 5-layer terminology.
+ * 
+ * Terminology mapping verified:
+ *   DOMData              → StructureData
+ *   DOMAnalysis          → StructureAnalysis
+ *   DOMAnalysisConfig    → StructureAnalysisConfig
+ *   DOMChange            → StructureChange
+ *   CSSData              → StylesData
+ *   SnapshotPayload.dom  → SnapshotPayload.structure
+ *   SnapshotPayload.css  → SnapshotPayload.styles
+ *   TestivAIConfig.dom   → TestivAIConfig.structure
+ */
+
+import type {
+  StructureData,
+  StructureAnalysis,
+  StructureAnalysisConfig,
+  StructureChange,
+  StylesData,
+  SnapshotPayload,
+  TestivAIConfig,
+  TestivAIProjectConfig,
+  LayoutData,
+} from '../../src/types';
+
+describe('Renamed SDK Types', () => {
+  describe('StructureData (was DOMData)', () => {
+    test('should have html field', () => {
+      const data: StructureData = { html: '<div>test</div>' };
+      expect(data.html).toBe('<div>test</div>');
+    });
+
+    test('should accept optional styles field', () => {
+      const data: StructureData = { html: '<div/>', styles: { color: 'red' } };
+      expect(data.styles).toEqual({ color: 'red' });
+    });
+  });
+
+  describe('StylesData (was CSSData)', () => {
+    test('should have computed_styles field', () => {
+      const data: StylesData = {
+        computed_styles: {
+          'div.container': { color: 'rgb(0,0,0)', 'font-size': '16px' },
+        },
+      };
+      expect(Object.keys(data.computed_styles)).toHaveLength(1);
+    });
+  });
+
+  describe('StructureAnalysis (was DOMAnalysis)', () => {
+    test('should accept fingerprint', () => {
+      const analysis: StructureAnalysis = { fingerprint: 'abc123' };
+      expect(analysis.fingerprint).toBe('abc123');
+    });
+
+    test('should accept structure info', () => {
+      const analysis: StructureAnalysis = {
+        structure: {
+          totalElements: 10,
+          elementTypes: { div: 5 },
+          maxDepth: 3,
+          interactiveElements: { buttons: 1, inputs: 0, links: 2, forms: 0 },
+        },
+      };
+      expect(analysis.structure!.totalElements).toBe(10);
+    });
+
+    test('should accept semantic info', () => {
+      const analysis: StructureAnalysis = {
+        semantic: {
+          headings: { h1: 1 },
+          landmarks: {
+            hasHeader: true,
+            hasNav: false,
+            hasMain: true,
+            hasFooter: false,
+            hasAside: false,
+          },
+          lists: { ordered: 0, unordered: 1 },
+          tables: 0,
+          images: 2,
+        },
+      };
+      expect(analysis.semantic!.landmarks.hasHeader).toBe(true);
+    });
+  });
+
+  describe('StructureAnalysisConfig (was DOMAnalysisConfig)', () => {
+    test('should accept all config fields', () => {
+      const config: StructureAnalysisConfig = {
+        enableFingerprint: true,
+        enableStructure: true,
+        enableSemantic: false,
+        ignoreAttributes: ['data-testid'],
+        ignoreElements: ['script'],
+        ignoreContentPatterns: [/\d+/],
+      };
+      expect(config.enableFingerprint).toBe(true);
+      expect(config.ignoreAttributes).toEqual(['data-testid']);
+    });
+  });
+
+  describe('StructureChange (was DOMChange)', () => {
+    test('should have correct shape', () => {
+      const change: StructureChange = {
+        type: 'fingerprint',
+        severity: 'high',
+        description: 'Page structure has changed',
+        details: { baseline: 'a', current: 'b' },
+      };
+      expect(change.type).toBe('fingerprint');
+      expect(change.severity).toBe('high');
+    });
+
+    test('should accept all change types', () => {
+      const types: StructureChange['type'][] = ['fingerprint', 'structure', 'semantic', 'component'];
+      types.forEach(type => {
+        const change: StructureChange = { type, severity: 'low', description: 'test' };
+        expect(change.type).toBe(type);
+      });
+    });
+  });
+
+  describe('SnapshotPayload field renames', () => {
+    test('should use "structure" field (was "dom")', () => {
+      const payload: Partial<SnapshotPayload> = {
+        structure: { html: '<div/>' },
+        snapshotName: 'test',
+        testName: 'test',
+        timestamp: Date.now(),
+      };
+      expect(payload.structure!.html).toBe('<div/>');
+    });
+
+    test('should use "styles" field (was "css")', () => {
+      const payload: Partial<SnapshotPayload> = {
+        styles: { computed_styles: { 'div': { color: 'red' } } },
+      };
+      expect(payload.styles!.computed_styles['div'].color).toBe('red');
+    });
+
+    test('should use "structureAnalysis" field (was "domAnalysis")', () => {
+      const payload: Partial<SnapshotPayload> = {
+        structureAnalysis: { fingerprint: 'test_hash' },
+      };
+      expect(payload.structureAnalysis!.fingerprint).toBe('test_hash');
+    });
+  });
+
+  describe('TestivAIConfig field renames', () => {
+    test('should use "structure" field (was "dom")', () => {
+      const config: TestivAIConfig = {
+        structure: {
+          enableFingerprint: true,
+          enableStructure: false,
+        },
+        layout: { sensitivity: 2 },
+      };
+      expect(config.structure!.enableFingerprint).toBe(true);
+    });
+  });
+
+  describe('TestivAIProjectConfig field renames', () => {
+    test('should use "structure" field (was "dom")', () => {
+      const config: TestivAIProjectConfig = {
+        layout: { sensitivity: 2, tolerance: 1 },
+        ai: { sensitivity: 2, confidence: 0.7 },
+        structure: {
+          enableFingerprint: true,
+        },
+      };
+      expect(config.structure!.enableFingerprint).toBe(true);
+    });
+  });
+});

package/dist/__tests__/unit/ci.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/unit/ci.spec.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ci_1 = require("../../ci");
+describe('CI Environment Detection', () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        // Reset env to a clean slate before each test
+        process.env = { ...originalEnv };
+        // Remove all CI-related env vars
+        delete process.env.GITHUB_RUN_ID;
+        delete process.env.GITHUB_ACTIONS;
+        delete process.env.GITHUB_SERVER_URL;
+        delete process.env.GITHUB_REPOSITORY;
+        delete process.env.GITHUB_EVENT_NUMBER;
+        delete process.env.GITHUB_REF;
+        delete process.env.GITLAB_CI;
+        delete process.env.CI_PIPELINE_ID;
+        delete process.env.CI_MERGE_REQUEST_IID;
+        delete process.env.CI_PIPELINE_URL;
+        delete process.env.CIRCLECI;
+        delete process.env.CIRCLE_WORKFLOW_ID;
+        delete process.env.CIRCLE_PULL_REQUEST;
+        delete process.env.CIRCLE_BUILD_URL;
+        delete process.env.JENKINS_URL;
+        delete process.env.BUILD_ID;
+        delete process.env.BUILD_URL;
+        delete process.env.CHANGE_ID;
+        delete process.env.TRAVIS;
+        delete process.env.TRAVIS_BUILD_ID;
+        delete process.env.TRAVIS_PULL_REQUEST;
+        delete process.env.TRAVIS_BUILD_WEB_URL;
+    });
+    afterAll(() => {
+        process.env = originalEnv;
+    });
+    describe('getCiRunId', () => {
+        it('should return null when not in CI', () => {
+            expect((0, ci_1.getCiRunId)()).toBeNull();
+        });
+        it('should detect GitHub Actions', () => {
+            process.env.GITHUB_RUN_ID = '123456';
+            expect((0, ci_1.getCiRunId)()).toBe('github-123456');
+        });
+        it('should detect GitLab CI', () => {
+            process.env.GITLAB_CI = 'true';
+            process.env.CI_PIPELINE_ID = '789';
+            expect((0, ci_1.getCiRunId)()).toBe('gitlab-789');
+        });
+        it('should detect Jenkins', () => {
+            process.env.JENKINS_URL = 'https://jenkins.example.com';
+            process.env.BUILD_ID = '42';
+            expect((0, ci_1.getCiRunId)()).toBe('jenkins-42');
+        });
+        it('should detect CircleCI', () => {
+            process.env.CIRCLECI = 'true';
+            process.env.CIRCLE_WORKFLOW_ID = 'wf-abc';
+            expect((0, ci_1.getCiRunId)()).toBe('circleci-wf-abc');
+        });
+        it('should detect Travis CI', () => {
+            process.env.TRAVIS = 'true';
+            process.env.TRAVIS_BUILD_ID = '999';
+            expect((0, ci_1.getCiRunId)()).toBe('travis-999');
+        });
+        it('should prioritize GitHub Actions over other providers', () => {
+            process.env.GITHUB_RUN_ID = '111';
+            process.env.GITLAB_CI = 'true';
+            process.env.CI_PIPELINE_ID = '222';
+            expect((0, ci_1.getCiRunId)()).toBe('github-111');
+        });
+    });
+    describe('getCiInfo', () => {
+        it('should return null when not in CI', () => {
+            expect((0, ci_1.getCiInfo)()).toBeNull();
+        });
+        describe('GitHub Actions', () => {
+            beforeEach(() => {
+                process.env.GITHUB_ACTIONS = 'true';
+                process.env.GITHUB_RUN_ID = '12345';
+                process.env.GITHUB_REPOSITORY = 'owner/repo';
+                process.env.GITHUB_SERVER_URL = 'https://github.com';
+            });
+            it('should return basic GitHub Actions info', () => {
+                const info = (0, ci_1.getCiInfo)();
+                expect(info).toEqual({
+                    provider: 'github_actions',
+                    prNumber: undefined,
+                    runUrl: 'https://github.com/owner/repo/actions/runs/12345',
+                    buildId: '12345',
+                });
+            });
+            it('should detect PR number from GITHUB_EVENT_NUMBER', () => {
+                process.env.GITHUB_EVENT_NUMBER = '42';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBe(42);
+            });
+            it('should detect PR number from GITHUB_REF', () => {
+                process.env.GITHUB_REF = 'refs/pull/99/merge';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBe(99);
+            });
+            it('should not set PR number for non-PR refs', () => {
+                process.env.GITHUB_REF = 'refs/heads/main';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBeUndefined();
+            });
+            it('should use default server URL', () => {
+                delete process.env.GITHUB_SERVER_URL;
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.runUrl).toBe('https://github.com/owner/repo/actions/runs/12345');
+            });
+            it('should handle missing repository', () => {
+                delete process.env.GITHUB_REPOSITORY;
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.runUrl).toBeUndefined();
+            });
+        });
+        describe('GitLab CI', () => {
+            beforeEach(() => {
+                process.env.GITLAB_CI = 'true';
+                process.env.CI_PIPELINE_ID = '456';
+                process.env.CI_PIPELINE_URL = 'https://gitlab.com/project/-/pipelines/456';
+            });
+            it('should return basic GitLab CI info', () => {
+                const info = (0, ci_1.getCiInfo)();
+                expect(info).toEqual({
+                    provider: 'gitlab_ci',
+                    prNumber: undefined,
+                    runUrl: 'https://gitlab.com/project/-/pipelines/456',
+                    buildId: '456',
+                });
+            });
+            it('should detect MR number', () => {
+                process.env.CI_MERGE_REQUEST_IID = '7';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBe(7);
+            });
+        });
+        describe('CircleCI', () => {
+            beforeEach(() => {
+                process.env.CIRCLECI = 'true';
+                process.env.CIRCLE_WORKFLOW_ID = 'wf-xyz';
+                process.env.CIRCLE_BUILD_URL = 'https://circleci.com/gh/owner/repo/123';
+            });
+            it('should return basic CircleCI info', () => {
+                const info = (0, ci_1.getCiInfo)();
+                expect(info).toEqual({
+                    provider: 'circleci',
+                    prNumber: undefined,
+                    runUrl: 'https://circleci.com/gh/owner/repo/123',
+                    buildId: 'wf-xyz',
+                });
+            });
+            it('should detect PR number from pull request URL', () => {
+                process.env.CIRCLE_PULL_REQUEST = 'https://github.com/owner/repo/pull/55';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBe(55);
+            });
+        });
+        describe('Jenkins', () => {
+            beforeEach(() => {
+                process.env.JENKINS_URL = 'https://jenkins.example.com';
+                process.env.BUILD_ID = '100';
+                process.env.BUILD_URL = 'https://jenkins.example.com/job/my-job/100/';
+            });
+            it('should return basic Jenkins info', () => {
+                const info = (0, ci_1.getCiInfo)();
+                expect(info).toEqual({
+                    provider: 'jenkins',
+                    prNumber: undefined,
+                    runUrl: 'https://jenkins.example.com/job/my-job/100/',
+                    buildId: '100',
+                });
+            });
+            it('should detect PR number from CHANGE_ID', () => {
+                process.env.CHANGE_ID = '33';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBe(33);
+            });
+        });
+        describe('Travis CI', () => {
+            beforeEach(() => {
+                process.env.TRAVIS = 'true';
+                process.env.TRAVIS_BUILD_ID = '888';
+                process.env.TRAVIS_BUILD_WEB_URL = 'https://app.travis-ci.com/owner/repo/builds/888';
+            });
+            it('should return basic Travis CI info', () => {
+                const info = (0, ci_1.getCiInfo)();
+                expect(info).toEqual({
+                    provider: 'travis_ci',
+                    prNumber: undefined,
+                    runUrl: 'https://app.travis-ci.com/owner/repo/builds/888',
+                    buildId: '888',
+                });
+            });
+            it('should detect PR number', () => {
+                process.env.TRAVIS_PULL_REQUEST = '17';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBe(17);
+            });
+            it('should not set PR number when TRAVIS_PULL_REQUEST is false', () => {
+                process.env.TRAVIS_PULL_REQUEST = 'false';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info?.prNumber).toBeUndefined();
+            });
+        });
+        describe('Payload shape matches Core API CiInfo schema', () => {
+            it('should produce fields matching Core API aliases: provider, prNumber, runUrl, buildId', () => {
+                process.env.GITHUB_ACTIONS = 'true';
+                process.env.GITHUB_RUN_ID = '1';
+                process.env.GITHUB_REPOSITORY = 'o/r';
+                process.env.GITHUB_EVENT_NUMBER = '10';
+                const info = (0, ci_1.getCiInfo)();
+                expect(info).toBeDefined();
+                // These are the exact camelCase keys the Core API CiInfo Pydantic model expects via aliases
+                expect(info).toHaveProperty('provider');
+                expect(info).toHaveProperty('prNumber');
+                expect(info).toHaveProperty('runUrl');
+                expect(info).toHaveProperty('buildId');
+                // Ensure no unexpected snake_case keys
+                expect(info).not.toHaveProperty('pr_number');
+                expect(info).not.toHaveProperty('run_url');
+                expect(info).not.toHaveProperty('build_id');
+            });
+        });
+    });
+});

package/dist/__tests__/unit/compression.spec.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for Playwright SDK compression integration
+ */
+export {};

package/dist/__tests__/unit/compression.spec.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Tests for Playwright SDK compression integration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const reporter_1 = require("../../reporter");
+const common_1 = require("@testivai/common");
+describe('Playwright Reporter Compression', () => {
+    let reporter;
+    beforeEach(() => {
+        reporter = new reporter_1.TestivAIPlaywrightReporter({
+            apiKey: 'test-key',
+            apiUrl: 'http://localhost:3000',
+            compression: {
+                compressUploads: true,
+                compressionThreshold: 100, // Small threshold for testing
+                compressionLevel: 6,
+            },
+        });
+    });
+    it('should initialize with compression helper', () => {
+        expect(reporter).toBeDefined();
+        // Access private property through type assertion for testing
+        const helper = reporter.compressionHelper;
+        expect(helper).toBeInstanceOf(common_1.CompressionHelper);
+    });
+    it('should use custom compression options', () => {
+        const customReporter = new reporter_1.TestivAIPlaywrightReporter({
+            apiKey: 'test-key',
+            compression: {
+                compressUploads: false,
+                compressionLevel: 9,
+                compressionThreshold: 1000,
+            },
+        });
+        const helper = customReporter.compressionHelper;
+        expect(helper).toBeInstanceOf(common_1.CompressionHelper);
+    });
+    it('should use default compression options when none provided', () => {
+        const defaultReporter = new reporter_1.TestivAIPlaywrightReporter({
+            apiKey: 'test-key',
+        });
+        const helper = defaultReporter.compressionHelper;
+        expect(helper).toBeInstanceOf(common_1.CompressionHelper);
+    });
+});

package/dist/ci.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Utilities for detecting CI/CD environments and extracting a unique run identifier.
+ */
+/**
+ * CI environment information for integration feedback (e.g., GitHub commit statuses, PR comments).
+ */
+export interface CiInfo {
+    /** CI provider name */
+    provider: string;
+    /** Pull/Merge request number (if available) */
+    prNumber?: number;
+    /** URL to the CI run (if available) */
+    runUrl?: string;
+    /** CI build/run identifier */
+    buildId?: string;
+}
+/**
+ * Gets a unique identifier for the current CI run.
+ * This ID is used to group snapshots from parallel shards into a single batch.
+ *
+ * @returns A unique string identifier for the CI run, or null if not in a known CI environment.
+ */
+export declare function getCiRunId(): string | null;
+/**
+ * Gets detailed CI environment information including PR number and run URL.
+ * Used for integration feedback (GitHub commit statuses, PR comments, etc.).
+ *
+ * @returns CiInfo object if in a known CI environment, or null otherwise.
+ */
+export declare function getCiInfo(): CiInfo | null;

package/dist/ci.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Utilities for detecting CI/CD environments and extracting a unique run identifier.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCiRunId = getCiRunId;
+exports.getCiInfo = getCiInfo;
+/**
+ * Gets a unique identifier for the current CI run.
+ * This ID is used to group snapshots from parallel shards into a single batch.
+ *
+ * @returns A unique string identifier for the CI run, or null if not in a known CI environment.
+ */
+function getCiRunId() {
+    // GitHub Actions
+    if (process.env.GITHUB_RUN_ID) {
+        return `github-${process.env.GITHUB_RUN_ID}`;
+    }
+    // GitLab CI
+    if (process.env.GITLAB_CI) {
+        return `gitlab-${process.env.CI_PIPELINE_ID}`;
+    }
+    // Jenkins
+    if (process.env.JENKINS_URL) {
+        return `jenkins-${process.env.BUILD_ID}`;
+    }
+    // CircleCI
+    if (process.env.CIRCLECI) {
+        return `circleci-${process.env.CIRCLE_WORKFLOW_ID}`;
+    }
+    // Travis CI
+    if (process.env.TRAVIS) {
+        return `travis-${process.env.TRAVIS_BUILD_ID}`;
+    }
+    return null;
+}
+/**
+ * Gets detailed CI environment information including PR number and run URL.
+ * Used for integration feedback (GitHub commit statuses, PR comments, etc.).
+ *
+ * @returns CiInfo object if in a known CI environment, or null otherwise.
+ */
+function getCiInfo() {
+    // GitHub Actions
+    if (process.env.GITHUB_ACTIONS) {
+        const serverUrl = process.env.GITHUB_SERVER_URL || 'https://github.com';
+        const repo = process.env.GITHUB_REPOSITORY;
+        const runId = process.env.GITHUB_RUN_ID;
+        // PR number: available via GITHUB_EVENT_NUMBER in pull_request events,
+        // or from GITHUB_REF (refs/pull/<number>/merge)
+        let prNumber;
+        if (process.env.GITHUB_EVENT_NUMBER) {
+            prNumber = parseInt(process.env.GITHUB_EVENT_NUMBER, 10) || undefined;
+        }
+        else if (process.env.GITHUB_REF?.startsWith('refs/pull/')) {
+            const match = process.env.GITHUB_REF.match(/^refs\/pull\/(\d+)\//);
+            if (match) {
+                prNumber = parseInt(match[1], 10);
+            }
+        }
+        return {
+            provider: 'github_actions',
+            prNumber,
+            runUrl: repo && runId ? `${serverUrl}/${repo}/actions/runs/${runId}` : undefined,
+            buildId: runId,
+        };
+    }
+    // GitLab CI
+    if (process.env.GITLAB_CI) {
+        const prNumber = process.env.CI_MERGE_REQUEST_IID
+            ? parseInt(process.env.CI_MERGE_REQUEST_IID, 10) || undefined
+            : undefined;
+        return {
+            provider: 'gitlab_ci',
+            prNumber,
+            runUrl: process.env.CI_PIPELINE_URL || undefined,
+            buildId: process.env.CI_PIPELINE_ID,
+        };
+    }
+    // CircleCI
+    if (process.env.CIRCLECI) {
+        const prNumber = process.env.CIRCLE_PULL_REQUEST
+            ? parseInt(process.env.CIRCLE_PULL_REQUEST.split('/').pop() || '', 10) || undefined
+            : undefined;
+        return {
+            provider: 'circleci',
+            prNumber,
+            runUrl: process.env.CIRCLE_BUILD_URL || undefined,
+            buildId: process.env.CIRCLE_WORKFLOW_ID,
+        };
+    }
+    // Jenkins
+    if (process.env.JENKINS_URL) {
+        const prNumber = process.env.CHANGE_ID
+            ? parseInt(process.env.CHANGE_ID, 10) || undefined
+            : undefined;
+        return {
+            provider: 'jenkins',
+            prNumber,
+            runUrl: process.env.BUILD_URL || undefined,
+            buildId: process.env.BUILD_ID,
+        };
+    }
+    // Travis CI
+    if (process.env.TRAVIS) {
+        const prNumber = process.env.TRAVIS_PULL_REQUEST && process.env.TRAVIS_PULL_REQUEST !== 'false'
+            ? parseInt(process.env.TRAVIS_PULL_REQUEST, 10) || undefined
+            : undefined;
+        return {
+            provider: 'travis_ci',
+            prNumber,
+            runUrl: process.env.TRAVIS_BUILD_WEB_URL || undefined,
+            buildId: process.env.TRAVIS_BUILD_ID,
+        };
+    }
+    return null;
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const init_1 = require("./init");
+const program = new commander_1.Command();
+// Display banner
+const showBanner = () => {
+    console.log();
+    console.log(chalk_1.default.cyan.bold('  TestivAI'));
+    console.log(chalk_1.default.gray('  Catch Visual Bugs Automatically'));
+    console.log(chalk_1.default.gray('  AI that catches real bugs, ignores the noise.'));
+    console.log();
+};
+program
+    .name('testivai')
+    .description('TestivAI Playwright SDK CLI')
+    .version(require('../../package.json').version)
+    .hook('preAction', () => {
+    if (!process.argv.includes('--quiet') && !process.argv.includes('-q')) {
+        showBanner();
+    }
+});
+// Global options
+program
+    .option('-q, --quiet', 'Suppress banner output (ideal for CI)');
+program
+    .command('init')
+    .description('Initialize TestivAI configuration file')
+    .action(async () => {
+    try {
+        await (0, init_1.createConfigFile)();
+    }
+    catch (error) {
+        console.error('❌ Failed to initialize:', error);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/dist/cli/init.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+declare function createConfigFile(): Promise<void>;
+export { createConfigFile };