@vibe-validate/cli 0.9.10 → 0.10.0

package/dist/utils/setup-checks/workflow-check.js

@@ -0,0 +1,147 @@
+/**
+ * Workflow Setup Check
+ *
+ * Ensures that .github/workflows/validate.yml exists and is configured
+ * to run vibe-validate validation in CI.
+ *
+ * This check reuses the existing workflow generation logic from the
+ * generate-workflow command to create a standard GitHub Actions workflow.
+ */
+import { writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { generateWorkflow } from '../../commands/generate-workflow.js';
+import { loadConfig } from '../config-loader.js';
+export class WorkflowSetupCheck {
+    id = 'workflow';
+    name = 'GitHub Actions Workflow Setup';
+    async check(options) {
+        const cwd = options?.cwd ?? process.cwd();
+        const githubDir = join(cwd, '.github');
+        const workflowsDir = join(githubDir, 'workflows');
+        const workflowPath = join(workflowsDir, 'validate.yml');
+        // Check if .github directory exists
+        if (!existsSync(githubDir)) {
+            return {
+                passed: false,
+                message: '.github directory not found',
+                suggestion: 'Create .github/workflows/validate.yml with vibe-validate workflow',
+            };
+        }
+        // Check if workflows directory exists
+        if (!existsSync(workflowsDir)) {
+            return {
+                passed: false,
+                message: '.github/workflows directory not found',
+                suggestion: 'Create .github/workflows/validate.yml',
+            };
+        }
+        // Check if validate.yml exists
+        if (!existsSync(workflowPath)) {
+            return {
+                passed: false,
+                message: 'validate.yml workflow not found',
+                suggestion: 'Create .github/workflows/validate.yml',
+            };
+        }
+        return {
+            passed: true,
+            message: 'GitHub Actions workflow exists',
+        };
+    }
+    async preview(options) {
+        const cwd = options?.cwd ?? process.cwd();
+        // Check current state
+        const checkResult = await this.check(options);
+        if (checkResult.passed) {
+            return {
+                description: 'GitHub Actions workflow already exists',
+                filesAffected: [],
+                changes: [],
+            };
+        }
+        // Load config to generate workflow content
+        const config = await loadConfig(cwd);
+        if (!config) {
+            return {
+                description: 'Cannot generate workflow: No vibe-validate config found',
+                filesAffected: [],
+                changes: [],
+            };
+        }
+        const workflowContent = await this.generateWorkflowContent(cwd);
+        return {
+            description: 'Create GitHub Actions workflow for vibe-validate',
+            filesAffected: ['.github/workflows/validate.yml'],
+            changes: [
+                {
+                    file: '.github/workflows/validate.yml',
+                    action: 'create',
+                    content: workflowContent,
+                },
+            ],
+        };
+    }
+    async fix(options) {
+        const cwd = options?.cwd ?? process.cwd();
+        const githubDir = join(cwd, '.github');
+        const workflowsDir = join(githubDir, 'workflows');
+        const workflowPath = join(workflowsDir, 'validate.yml');
+        const dryRun = options?.dryRun ?? false;
+        // Check current state
+        const checkResult = await this.check(options);
+        if (checkResult.passed && !options?.force) {
+            return {
+                success: true,
+                message: 'GitHub Actions workflow already exists',
+                filesChanged: [],
+            };
+        }
+        if (dryRun) {
+            return {
+                success: true,
+                message: '[dry-run] Would create .github/workflows/validate.yml',
+                filesChanged: [],
+            };
+        }
+        // Generate workflow content
+        const workflowContent = await this.generateWorkflowContent(cwd);
+        // Ensure .github/workflows directory exists
+        if (!existsSync(workflowsDir)) {
+            await mkdir(workflowsDir, { recursive: true });
+        }
+        // Don't overwrite existing workflow unless force is true
+        if (existsSync(workflowPath) && !options?.force) {
+            return {
+                success: true,
+                message: 'GitHub Actions workflow already exists (use --force to overwrite)',
+                filesChanged: [],
+            };
+        }
+        // Write workflow file
+        await writeFile(workflowPath, workflowContent, 'utf-8');
+        return {
+            success: true,
+            message: 'Created .github/workflows/validate.yml',
+            filesChanged: ['.github/workflows/validate.yml'],
+        };
+    }
+    /**
+     * Generate workflow content using the existing workflow generator
+     */
+    async generateWorkflowContent(cwd) {
+        // Load config
+        const config = await loadConfig(cwd);
+        if (!config) {
+            throw new Error('No vibe-validate configuration found. Run `vibe-validate init` first.');
+        }
+        // Generate workflow with default options
+        const options = {
+            nodeVersions: ['20'], // Single version (no matrix) for simplicity
+            os: ['ubuntu-latest'],
+            packageManager: undefined, // Auto-detect
+        };
+        return generateWorkflow(config, options);
+    }
+}
+//# sourceMappingURL=workflow-check.js.map

package/dist/utils/setup-checks/workflow-check.js.map

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

package/dist/utils/setup-engine.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Setup Engine - Core types and interfaces for idempotent setup operations
+ *
+ * This module provides the foundation for focused init modes that can be run
+ * independently and repeatedly without side effects.
+ *
+ * Design principles:
+ * - Idempotent: Running a setup check multiple times produces the same result
+ * - Composable: Setup checks can be combined and run together
+ * - Previewable: All changes can be previewed before applying
+ * - Testable: All setup checks are fully unit-testable
+ *
+ * @example
+ * ```typescript
+ * const gitignoreCheck = new GitignoreSetupCheck();
+ *
+ * // Check current state
+ * const result = await gitignoreCheck.check();
+ * if (!result.passed) {
+ *   // Preview changes
+ *   const preview = await gitignoreCheck.preview();
+ *   console.log(preview.description);
+ *
+ *   // Apply fix
+ *   const fixResult = await gitignoreCheck.fix();
+ *   console.log(fixResult.message);
+ * }
+ * ```
+ */
+/**
+ * Result of a setup check operation
+ */
+export interface CheckResult {
+    /**
+     * Whether the check passed (setup is already complete)
+     */
+    passed: boolean;
+    /**
+     * Human-readable message describing the check result
+     */
+    message: string;
+    /**
+     * Optional suggestion for how to fix the issue (if check failed)
+     */
+    suggestion?: string;
+    /**
+     * Optional details about what was found
+     */
+    details?: Record<string, unknown>;
+}
+/**
+ * Result of a fix operation
+ */
+export interface FixResult {
+    /**
+     * Whether the fix was successful
+     */
+    success: boolean;
+    /**
+     * Human-readable message describing what was done
+     */
+    message: string;
+    /**
+     * List of files that were created or modified
+     */
+    filesChanged: string[];
+    /**
+     * Optional error if fix failed
+     */
+    error?: string;
+}
+/**
+ * Result of a preview operation
+ */
+export interface PreviewResult {
+    /**
+     * Human-readable description of changes that would be made
+     */
+    description: string;
+    /**
+     * List of files that would be created or modified
+     */
+    filesAffected: string[];
+    /**
+     * Optional preview of file contents that would be created/modified
+     */
+    changes?: Array<{
+        file: string;
+        action: 'create' | 'modify';
+        content?: string;
+        diff?: string;
+    }>;
+}
+/**
+ * Options for fix operations
+ */
+export interface FixOptions {
+    /**
+     * Working directory (defaults to process.cwd())
+     */
+    cwd?: string;
+    /**
+     * Whether to force the fix even if check passes
+     */
+    force?: boolean;
+    /**
+     * Dry-run mode: preview changes without applying
+     */
+    dryRun?: boolean;
+}
+/**
+ * Base interface for all setup checks
+ *
+ * Each setup check represents a specific aspect of the vibe-validate
+ * setup that can be verified, previewed, and fixed independently.
+ */
+export interface SetupCheck {
+    /**
+     * Unique identifier for this setup check
+     */
+    readonly id: string;
+    /**
+     * Human-readable name for this setup check
+     */
+    readonly name: string;
+    /**
+     * Check if the setup is complete
+     *
+     * This operation should be read-only and have no side effects.
+     *
+     * @param _options - Optional configuration
+     * @returns Result indicating whether setup is complete
+     */
+    check(_options?: FixOptions): Promise<CheckResult>;
+    /**
+     * Preview what changes would be made by fix()
+     *
+     * This operation should be read-only and have no side effects.
+     *
+     * @param _options - Optional configuration
+     * @returns Description of changes that would be made
+     */
+    preview(_options?: FixOptions): Promise<PreviewResult>;
+    /**
+     * Apply the fix to complete the setup
+     *
+     * This operation should be idempotent - running it multiple times
+     * should produce the same result.
+     *
+     * @param _options - Optional configuration
+     * @returns Result of the fix operation
+     */
+    fix(_options?: FixOptions): Promise<FixResult>;
+}
+//# sourceMappingURL=setup-engine.d.ts.map

package/dist/utils/setup-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-engine.d.ts","sourceRoot":"","sources":["../../src/utils/setup-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD;;;;;;;;OAQG;IACH,GAAG,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAChD"}

package/dist/utils/setup-engine.js

@@ -0,0 +1,31 @@
+/**
+ * Setup Engine - Core types and interfaces for idempotent setup operations
+ *
+ * This module provides the foundation for focused init modes that can be run
+ * independently and repeatedly without side effects.
+ *
+ * Design principles:
+ * - Idempotent: Running a setup check multiple times produces the same result
+ * - Composable: Setup checks can be combined and run together
+ * - Previewable: All changes can be previewed before applying
+ * - Testable: All setup checks are fully unit-testable
+ *
+ * @example
+ * ```typescript
+ * const gitignoreCheck = new GitignoreSetupCheck();
+ *
+ * // Check current state
+ * const result = await gitignoreCheck.check();
+ * if (!result.passed) {
+ *   // Preview changes
+ *   const preview = await gitignoreCheck.preview();
+ *   console.log(preview.description);
+ *
+ *   // Apply fix
+ *   const fixResult = await gitignoreCheck.fix();
+ *   console.log(fixResult.message);
+ * }
+ * ```
+ */
+export {};
+//# sourceMappingURL=setup-engine.js.map

package/dist/utils/setup-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-engine.js","sourceRoot":"","sources":["../../src/utils/setup-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-validate/cli",
-  "version": "0.9.10",
+  "version": "0.10.0",
   "description": "Command-line interface for vibe-validate validation framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,9 +57,9 @@
     "chalk": "^5.3.0",
     "yaml": "^2.6.1",
     "js-yaml": "^4.1.0",
-    "@vibe-validate/core": "0.9.10",
-    "@vibe-validate/config": "0.9.10",
-    "@vibe-validate/git": "0.9.10"
+    "@vibe-validate/git": "0.10.0",
+    "@vibe-validate/config": "0.10.0",
+    "@vibe-validate/core": "0.10.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.8",