@vodmal/vdx-cli 0.7.0 → 0.8.0

package/README.md

@@ -24,6 +24,11 @@ invocation; pick global when you'll run `vdx` repeatedly, npx when you
 don't want anything in your global `node_modules` or you're in an
 ephemeral environment.
 
+**First command after install: `vdx doctor`** — it inspects your environment
+(Node version, `vdx` on PATH, git, mise, npm auth, container runtime, Claude
+Code plugin) and points to remedies for everything that's missing or
+sub-optimal.
+
 ## Use
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vodmal/vdx-cli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "vdx — unified lifecycle interface (up/down/build/test/check/fix) + versioned maturity audit with drift detection. Pairs with the vdx Claude Code plugin.",
   "keywords": [
     "vdx",

package/src/doctor.ts

@@ -149,6 +149,39 @@ function checkContainerRuntime(): CheckResult {
   };
 }
 
+function findOnPath(name: string): string | null {
+  const PATH = process.env.PATH ?? '';
+  const sep = process.platform === 'win32' ? ';' : ':';
+  for (const dir of PATH.split(sep)) {
+    if (!dir) continue;
+    const p = path.join(dir, name);
+    if (fs.existsSync(p)) return p;
+  }
+  return null;
+}
+
+function checkVdxOnPath(): CheckResult {
+  const found = findOnPath('vdx');
+  if (found) {
+    return {
+      id: 'vdx-on-path',
+      label: 'vdx on PATH',
+      status: 'ok',
+      level: 4,
+      message: found,
+    };
+  }
+  return {
+    id: 'vdx-on-path',
+    label: 'vdx on PATH',
+    status: 'warning',
+    level: 1,
+    message: 'binary not on PATH — `vdx <verb>` will not work directly in shell',
+    remedy:
+      'npm i -g @vodmal/vdx-cli  (or alias vdx="npx -y -p @vodmal/vdx-cli vdx")',
+  };
+}
+
 function checkClaudeCodePlugin(): CheckResult {
   const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
   if (!fs.existsSync(settingsPath)) {
@@ -189,6 +222,7 @@ function checkClaudeCodePlugin(): CheckResult {
 
 const CHECKS: Array<() => CheckResult> = [
   checkNode,
+  checkVdxOnPath,
   checkGit,
   checkMise,
   checkNpmAuth,