@vodmal/vdx-cli 0.8.1 → 0.8.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vodmal/vdx-cli",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "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'] });
@@ -187,7 +203,9 @@ function checkVdxOnPath(): CheckResult {
       label: 'vdx install',
       status: 'ok',
       level: 3,
-      message: `via npx cache: ${found} (ephemeral; fine for npx-only workflows — always latest)`,
+      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') {
@@ -208,6 +226,52 @@ function checkVdxOnPath(): CheckResult {
   };
 }
 
+function checkVdxInShell(): CheckResult {
+  const found = findOnPath('vdx');
+  if (!found) {
+    return {
+      id: 'vdx-in-shell',
+      label: 'vdx in shell',
+      status: 'warning',
+      level: 1,
+      message:
+        'no — `vdx` command not on persistent PATH. If you set a shell alias, it works but doctor cannot detect aliases.',
+      remedy:
+        'npm i -g @vodmal/vdx-cli  OR  alias vdx="npx -y -p @vodmal/vdx-cli vdx"',
+    };
+  }
+  const ephemeral = isEphemeralPath(found);
+  if (ephemeral === 'npx-cache') {
+    return {
+      id: 'vdx-in-shell',
+      label: 'vdx in shell',
+      status: 'warning',
+      level: 1,
+      message:
+        'no — only the ephemeral npx-cache binary is on PATH; bare `vdx <verb>` in a fresh shell will not resolve',
+      remedy:
+        'npm i -g @vodmal/vdx-cli  OR  alias vdx="npx -y -p @vodmal/vdx-cli vdx"',
+    };
+  }
+  if (ephemeral === 'local-bin') {
+    return {
+      id: 'vdx-in-shell',
+      label: 'vdx in shell',
+      status: 'warning',
+      level: 2,
+      message: `project-only — \`vdx\` works inside this project root (${found}) but not elsewhere`,
+      remedy: 'npm i -g @vodmal/vdx-cli for global shell access',
+    };
+  }
+  return {
+    id: 'vdx-in-shell',
+    label: 'vdx in shell',
+    status: 'ok',
+    level: 4,
+    message: `yes — \`vdx\` resolves globally (${found})`,
+  };
+}
+
 function checkClaudeCodePlugin(): CheckResult {
   const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
   if (!fs.existsSync(settingsPath)) {
@@ -249,6 +313,7 @@ function checkClaudeCodePlugin(): CheckResult {
 const CHECKS: Array<() => CheckResult> = [
   checkNode,
   checkVdxOnPath,
+  checkVdxInShell,
   checkGit,
   checkMise,
   checkNpmAuth,
@@ -261,7 +326,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}`,
   );