@vodmal/vdx-cli 0.8.1 → 0.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vodmal/vdx-cli",
-  "version": "0.8.1",
+  "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'] });
@@ -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') {
@@ -261,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}`,
   );