vibe-validate 0.19.0-rc.9 → 0.19.0

package/bin/vibe-validate

@@ -2,17 +2,33 @@
 /**
  * Thin wrapper that delegates to @vibe-validate/cli
  * This ensures single source of truth for all wrapper logic.
+ *
+ * Supports VV_ROOT_DIR override for developer testing:
+ *   VV_ROOT_DIR=~/Workspaces/vibe-validate vibe-validate validate
  */
+import { existsSync } from 'fs';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { dirname, join } from 'path';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Resolve the CLI package's wrapper script
-// Go from: vibe-validate/bin/vibe-validate
-// To: @vibe-validate/cli/dist/bin/vibe-validate.js
-const cliWrapperPath = join(__dirname, '../node_modules/@vibe-validate/cli/dist/bin/vibe-validate.js');
+// VV_ROOT_DIR override: use dev build's CLI wrapper instead of published one
+// This lets developers test their local build against any project
+const vvRootDir = process.env.VV_ROOT_DIR;
+let cliWrapperPath;
+if (vvRootDir) {
+  const devWrapper = join(vvRootDir, 'packages/cli/dist/bin/vibe-validate.js');
+  if (existsSync(devWrapper)) {
+    console.error(`[vv] Using VV_ROOT_DIR: ${vvRootDir}`);
+    cliWrapperPath = devWrapper;
+  } else {
+    console.error(`[vv] VV_ROOT_DIR set but ${devWrapper} not found — ignoring`);
+    cliWrapperPath = join(__dirname, '../node_modules/@vibe-validate/cli/dist/bin/vibe-validate.js');
+  }
+} else {
+  cliWrapperPath = join(__dirname, '../node_modules/@vibe-validate/cli/dist/bin/vibe-validate.js');
+}
 
 // Import and execute the CLI wrapper
 // Use pathToFileURL for Windows compatibility (import() requires file:// URLs)

package/bin/vv

@@ -2,17 +2,33 @@
 /**
  * Thin wrapper that delegates to @vibe-validate/cli
  * This ensures single source of truth for all wrapper logic.
+ *
+ * Supports VV_ROOT_DIR override for developer testing:
+ *   VV_ROOT_DIR=~/Workspaces/vibe-validate vv validate
  */
+import { existsSync } from 'fs';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { dirname, join } from 'path';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Resolve the CLI package's wrapper script
-// Go from: vibe-validate/bin/vv
-// To: @vibe-validate/cli/dist/bin/vv (which is really vibe-validate.js)
-const cliWrapperPath = join(__dirname, '../node_modules/@vibe-validate/cli/dist/bin/vibe-validate.js');
+// VV_ROOT_DIR override: use dev build's CLI wrapper instead of published one
+// This lets developers test their local build against any project
+const vvRootDir = process.env.VV_ROOT_DIR;
+let cliWrapperPath;
+if (vvRootDir) {
+  const devWrapper = join(vvRootDir, 'packages/cli/dist/bin/vibe-validate.js');
+  if (existsSync(devWrapper)) {
+    console.error(`[vv] Using VV_ROOT_DIR: ${vvRootDir}`);
+    cliWrapperPath = devWrapper;
+  } else {
+    console.error(`[vv] VV_ROOT_DIR set but ${devWrapper} not found — ignoring`);
+    cliWrapperPath = join(__dirname, '../node_modules/@vibe-validate/cli/dist/bin/vibe-validate.js');
+  }
+} else {
+  cliWrapperPath = join(__dirname, '../node_modules/@vibe-validate/cli/dist/bin/vibe-validate.js');
+}
 
 // Import and execute the CLI wrapper
 // Use pathToFileURL for Windows compatibility (import() requires file:// URLs)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-validate",
-  "version": "0.19.0-rc.9",
+  "version": "0.19.0",
   "description": "Git-aware validation orchestration for vibe coding (LLM-assisted development) - umbrella package",
   "type": "module",
   "bin": {
@@ -50,13 +50,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@vibe-validate/cli": "0.19.0-rc.9"
+    "@vibe-validate/cli": "0.19.0",
+    "@vibe-validate/utils": "0.19.0"
   },
   "devDependencies": {
     "@types/node": "^20.19.26",
     "typescript": "^5.9.3",
-    "vitest": "^2.1.9",
-    "@vibe-validate/utils": "0.19.0-rc.9"
+    "vitest": "^2.1.9"
   },
   "scripts": {
     "test": "vitest run",

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vibe-validate
-version: 0.19.0-rc.9 # Tracks vibe-validate package version
+version: 0.19.0 # Tracks vibe-validate package version
 description: Expert guidance for vibe-validate, an LLM-optimized validation orchestration tool. Use when working with vibe-validate commands, configuration, pre-commit workflows, or validation orchestration in TypeScript projects.
 model: claude-sonnet-4-5
 tools:
@@ -160,6 +160,9 @@ npx vibe-validate validate
 # Force re-validation (bypass cache)
 npx vibe-validate validate --force
 
+# Retry only failed steps (preserves cache for passed steps)
+npx vibe-validate validate --retry-failed
+
 # Check validation status without running
 npx vibe-validate validate --check
 ```
@@ -170,6 +173,10 @@ npx vibe-validate validate --check
 - Caches result by git tree hash
 - Exit code 0 = pass, 1 = fail
 
+**`--force` vs `--retry-failed`**:
+- `--force` — Re-runs **everything** from scratch, ignoring all cached results
+- `--retry-failed` — Re-runs **only failed steps**, preserving passed step results from cache. Detects and warns about flaky tests (steps that pass on retry without code changes). Use this when a transient failure occurred (network timeout, resource contention) and you want a fast retry without re-running steps that already passed.
+
 ### 4. Setup Diagnostics
 
 **When**: After install/upgrade, or when validation behaves unexpectedly

package/skill/resources/cli-reference.md

@@ -48,6 +48,7 @@ Run validation with git tree hash caching
 - `-y, --yaml` - Output validation result as YAML to stdout
 - `-c, --check` - Check if validation has already passed (do not run)
 - `-d, --debug` - Create output files for all steps (for debugging)
+- `--retry-failed` - Retry only failed steps from previous validation
 - `--no-lock` - Allow concurrent validation runs (disables single-instance mode)
 - `--no-wait` - Exit immediately if validation is already running (for background hooks)
 - `--wait-timeout <seconds>` - Maximum time to wait for running validation (default: 300)
@@ -313,8 +314,8 @@ Generate GitHub Actions workflow from vibe-validate config
 **What it does:**
 
 Generates .github/workflows/validate.yml from config
-Supports matrix mode (multiple Node/OS versions)
-Supports non-matrix mode (separate jobs per phase)
+Generates single validate job matching local behavior
+Supports matrix strategy for multiple Node/OS versions
 Can check if workflow is in sync with config
 
 **Exit codes:**