@vodmal/vdx-cli 0.8.0 → 0.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vodmal/vdx-cli",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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

@@ -1,6 +1,7 @@
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { execFileSync } from 'node:child_process';
 
 export type CheckStatus = 'ok' | 'warning' | 'missing';
@@ -15,12 +16,27 @@ export interface CheckResult {
 }
 
 export interface DoctorReport {
+  cliVersion: string;
   checks: CheckResult[];
   ok: number;
   warning: number;
   missing: number;
 }
 
+function readCliVersion(): string {
+  try {
+    const pkgPath = path.resolve(
+      path.dirname(fileURLToPath(import.meta.url)),
+      '..',
+      'package.json',
+    );
+    const raw = JSON.parse(fs.readFileSync(pkgPath, 'utf8')) as { version?: string };
+    return raw.version ?? 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
 function probeVersion(binary: string, args: string[] = ['--version']): string | null {
   try {
     const out = execFileSync(binary, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
@@ -160,25 +176,53 @@ function findOnPath(name: string): string | null {
   return null;
 }
 
+function isEphemeralPath(p: string): 'npx-cache' | 'local-bin' | null {
+  if (p.includes(`${path.sep}.npm${path.sep}_npx${path.sep}`)) return 'npx-cache';
+  if (p.includes(`${path.sep}node_modules${path.sep}.bin${path.sep}`)) return 'local-bin';
+  return null;
+}
+
 function checkVdxOnPath(): CheckResult {
   const found = findOnPath('vdx');
-  if (found) {
+  if (!found) {
     return {
       id: 'vdx-on-path',
-      label: 'vdx on PATH',
+      label: 'vdx install',
+      status: 'warning',
+      level: 1,
+      message:
+        '`vdx` not on PATH at check time. If you use a shell alias it is also fine — doctor cannot detect aliases.',
+      remedy:
+        'npm i -g @vodmal/vdx-cli  OR  alias vdx="npx -y -p @vodmal/vdx-cli vdx"  OR  keep using `npx -y -p @vodmal/vdx-cli vdx …` ad-hoc',
+    };
+  }
+  const ephemeral = isEphemeralPath(found);
+  if (ephemeral === 'npx-cache') {
+    return {
+      id: 'vdx-on-path',
+      label: 'vdx install',
       status: 'ok',
-      level: 4,
-      message: found,
+      level: 3,
+      message:
+        `via npx cache: ${found} — invoked-only (shell command \`vdx\` will not resolve outside npx). ` +
+        `For shell-global command run: npm i -g @vodmal/vdx-cli  OR  alias vdx="npx -y -p @vodmal/vdx-cli vdx".`,
+    };
+  }
+  if (ephemeral === 'local-bin') {
+    return {
+      id: 'vdx-on-path',
+      label: 'vdx install',
+      status: 'ok',
+      level: 2,
+      message: `local node_modules: ${found} (works inside this project only)`,
     };
   }
   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")',
+    label: 'vdx install',
+    status: 'ok',
+    level: 4,
+    message: `global: ${found}`,
   };
 }
 
@@ -235,7 +279,7 @@ export function runDoctor(): DoctorReport {
   const ok = checks.filter((c) => c.status === 'ok').length;
   const warning = checks.filter((c) => c.status === 'warning').length;
   const missing = checks.filter((c) => c.status === 'missing').length;
-  return { checks, ok, warning, missing };
+  return { cliVersion: readCliVersion(), checks, ok, warning, missing };
 }
 
 const PROJECT_MARKER_FILES = [

package/src/report.ts

@@ -76,6 +76,7 @@ export function reportDoctorMarkdown(r: DoctorReport): string {
   const lines: string[] = [];
   lines.push('# vdx doctor report');
   lines.push('');
+  lines.push(`- **@vodmal/vdx-cli version**: \`${r.cliVersion}\``);
   lines.push(
     `- **OK**: ${r.ok}  **Warning**: ${r.warning}  **Missing**: ${r.missing}`,
   );