devmap 0.3.5__tar.gz → 0.3.7__tar.gz

{devmap-0.3.5 → devmap-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devmap
-Version: 0.3.5
+Version: 0.3.7
 Summary: Map your machine's dev environment and surface issues (PATH conflicts, ghost binaries, multi-version collisions). fastfetch-for-dev-tools. This PyPI package ships the real devmap CLI (a bundled JavaScript app launched via Node.js or Bun), so `pip install devmap && devmap` works standalone.
 Author: devmap contributors
 License: MIT
@@ -40,6 +40,7 @@ Requirements at runtime: a Node.js (or Bun) runtime available on `PATH`. Python
 - **Off-PATH awareness**: reports installed-but-not-on-PATH tools, while correctly treating version-manager environments (conda envs, nvm versions) as by-design off-PATH.
 - **Environment layers**: vcpkg packages, per-python pip packages (incl. upgradable), apt packages (Linux), conda environments, Docker (binary + daemon + images/containers), WSL distros, Visual Studio dev shells, and project-local environments (`.venv`, `node_modules`).
 - **Dependency auditing (optional)**: with `--audit-deps`, devmap detects and invokes installed SCA tools (osv-scanner, govulncheck, pip-audit, Trivy), parses their JSON, and merges results into a unified view. devmap is a *scanner/orchestrator*, not a CVE database — for authoritative vulnerability data, use those tools directly.
+- **Health layer**: converges official self-checks into one view, **per environment**. Offline by default: `pip check` runs for **every** Python interpreter, and `conda doctor` runs for **every** conda env. With `--health-network`, `npm doctor` / `rustup check` are added. Missing/offline probes degrade gracefully to `info` (skipped). Only `warn`/`error` surface under `issues (N)`; passing checks are summarized as `✓ N checks passed`.
 - **Three sub-commands**: `scan` (the fact source), `query` (ask the manifest), `devdiff` (compare two manifests — environment drift / cross-machine consistency).
 - **Zero Python dependencies.** The bundled app is pure TypeScript compiled to JavaScript.
 

{devmap-0.3.5 → devmap-0.3.7}/README.md

@@ -22,6 +22,7 @@ Requirements at runtime: a Node.js (or Bun) runtime available on `PATH`. Python
 - **Off-PATH awareness**: reports installed-but-not-on-PATH tools, while correctly treating version-manager environments (conda envs, nvm versions) as by-design off-PATH.
 - **Environment layers**: vcpkg packages, per-python pip packages (incl. upgradable), apt packages (Linux), conda environments, Docker (binary + daemon + images/containers), WSL distros, Visual Studio dev shells, and project-local environments (`.venv`, `node_modules`).
 - **Dependency auditing (optional)**: with `--audit-deps`, devmap detects and invokes installed SCA tools (osv-scanner, govulncheck, pip-audit, Trivy), parses their JSON, and merges results into a unified view. devmap is a *scanner/orchestrator*, not a CVE database — for authoritative vulnerability data, use those tools directly.
+- **Health layer**: converges official self-checks into one view, **per environment**. Offline by default: `pip check` runs for **every** Python interpreter, and `conda doctor` runs for **every** conda env. With `--health-network`, `npm doctor` / `rustup check` are added. Missing/offline probes degrade gracefully to `info` (skipped). Only `warn`/`error` surface under `issues (N)`; passing checks are summarized as `✓ N checks passed`.
 - **Three sub-commands**: `scan` (the fact source), `query` (ask the manifest), `devdiff` (compare two manifests — environment drift / cross-machine consistency).
 - **Zero Python dependencies.** The bundled app is pure TypeScript compiled to JavaScript.
 

{devmap-0.3.5 → devmap-0.3.7}/devmap/_devmap.mjs

@@ -2,7 +2,7 @@
 // @bun
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.3.7";
 
 // src/install.ts
 function isIsolated(i) {
@@ -662,6 +662,194 @@ function runScaAudit(cwd) {
   return checks;
 }
 
+// src/health/parse.ts
+function parsePipCheck(text) {
+  const lines = (text || "").split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  const clean = lines.some((l) => /^no broken requirements found/i.test(l));
+  const conflicts = lines.filter((l) => !/^no broken requirements found/i.test(l));
+  if (clean || conflicts.length === 0) {
+    return { status: "ok", summary: "pip dependencies consistent" };
+  }
+  return {
+    status: "warn",
+    summary: `pip has ${conflicts.length} broken dependency requirement${conflicts.length === 1 ? "" : "s"}`,
+    detail: conflicts.join(`
+`)
+  };
+}
+function parseNpmDoctor(text) {
+  const t = (text || "").trim();
+  if (!t)
+    return { status: "skipped", summary: "npm doctor produced no output (timed out or silent)" };
+  const lines = t.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  const NET_RE = /ECONNREFUSED|ETIMEDOUT|ENOTFOUND|getaddrinfo|EAI_|network request|registry\.npmjs\.org|request to https?:/i;
+  const BOILER_RE = /complete log of this run|^\s+at\s|node:internal|file:\/\//i;
+  const netLines = lines.filter((l) => NET_RE.test(l));
+  const failLines = lines.filter((l) => /npm error|✗|✖/i.test(l) && !BOILER_RE.test(l));
+  const realFails = failLines.filter((l) => !NET_RE.test(l));
+  if (realFails.length) {
+    return {
+      status: "warn",
+      summary: `npm doctor reported ${realFails.length} issue${realFails.length === 1 ? "" : "s"}`,
+      detail: realFails.join(`
+`)
+    };
+  }
+  if (netLines.length) {
+    return { status: "skipped", summary: "npm doctor skipped (registry/network unreachable)" };
+  }
+  return { status: "ok", summary: "npm doctor passed" };
+}
+function parseRustupCheck(text) {
+  const t = (text || "").trim();
+  if (!t)
+    return { status: "skipped", summary: "rustup check produced no output (timed out or silent)" };
+  const lines = t.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  const updates = lines.filter((l) => /update available/i.test(l));
+  const upToDate = lines.filter((l) => /up to date/i.test(l));
+  if (updates.length) {
+    return {
+      status: "info",
+      summary: `rustup: ${updates.length} toolchain update${updates.length === 1 ? "" : "s"} available`,
+      detail: updates.join(`
+`)
+    };
+  }
+  if (upToDate.length)
+    return { status: "ok", summary: "rustup toolchains up to date" };
+  return { status: "ok", summary: "rustup check passed" };
+}
+function parseCondaDoctor(text) {
+  const t = (text || "").trim();
+  if (!t)
+    return { status: "skipped", summary: "conda doctor produced no output (timed out or silent)" };
+  const lines = t.split(/\r?\n/).map((l) => l.trim());
+  const problemSections = [];
+  let cur = null;
+  for (const line of lines) {
+    if (!line)
+      continue;
+    const hdr = line.match(/^[❌✅]\s*(.+?)\s*:?\s*$/);
+    if (hdr) {
+      const name = hdr[1].replace(/:\s*$/, "").trim();
+      cur = { name, items: 0 };
+      if (line.startsWith("❌"))
+        problemSections.push(cur);
+      continue;
+    }
+    if (cur) {
+      const m = line.match(/:\s*(\d+)\s*$/);
+      if (m)
+        cur.items += parseInt(m[1], 10);
+    }
+  }
+  const real = problemSections.filter((p) => p.items > 0);
+  if (real.length === 0) {
+    return { status: "ok", summary: "conda environment healthy", detail: t };
+  }
+  const total = real.reduce((a, p) => a + p.items, 0);
+  const detail = real.map((p) => `${p.name}: ${p.items}`).join(`
+`);
+  return {
+    status: "warn",
+    summary: `conda doctor: ${real.length} check${real.length === 1 ? "" : "s"} failed (${total} affected files)`,
+    detail
+  };
+}
+
+// src/health/scan.ts
+var NETWORK_PROBES = [
+  {
+    id: "npm",
+    label: "npm",
+    kind: "mismatch",
+    network: true,
+    candidates: [["npm", ["doctor"]]],
+    timeout: 20000,
+    parse: parseNpmDoctor
+  },
+  {
+    id: "rustup",
+    label: "rustup",
+    kind: "stale",
+    network: true,
+    candidates: [["rustup", ["check"]]],
+    timeout: 15000,
+    parse: parseRustupCheck
+  }
+];
+var SEV_OF = {
+  ok: "ok",
+  warn: "warn",
+  info: "info",
+  skipped: "info"
+};
+function skippedCheck(prefix, kind, summary) {
+  return makeCheck(`health.${prefix}.skipped`, kind, "info", summary, "");
+}
+function toCheckPerEnv(prefix, envLabel, r, kind, path) {
+  if (r.status === "skipped") {
+    return makeCheck(`health.${prefix}.${envLabel}.skipped`, kind, "info", `${prefix} doctor (${envLabel}) produced no output`, "");
+  }
+  const id = `health.${prefix}.${envLabel}.check`;
+  const summary = r.status === "ok" ? `${prefix} check (${envLabel}): consistent` : r.summary;
+  return makeCheck(id, kind, SEV_OF[r.status], summary, r.detail || "", path ? [path] : []);
+}
+function pickCandidate(p) {
+  const dirs = pathDirs();
+  for (const [cmd, args] of p.candidates) {
+    if (whichInDirs(cmd, dirs).length > 0)
+      return [cmd, args];
+  }
+  return null;
+}
+function toCheckNetwork(p, r) {
+  const sev = SEV_OF[r.status];
+  const id = r.status === "skipped" ? `health.${p.id}.skipped` : `health.${p.id}.check`;
+  return makeCheck(id, p.kind, sev, r.summary, r.detail || "");
+}
+async function computeHealth(opts = {}) {
+  const checks = [];
+  const network = opts.healthNetwork === true;
+  const pythons = opts.pythons || [];
+  if (pythons.length === 0) {
+    checks.push(skippedCheck("pip", "conflict", "no python interpreters detected (pip check skipped)"));
+  } else {
+    await Promise.all(pythons.map(async (py) => {
+      const out = await runBinAsync(py.path, ["-m", "pip", "check"], 15000);
+      const r = parsePipCheck(out);
+      checks.push(toCheckPerEnv("pip", py.label, r, "conflict", py.path));
+    }));
+  }
+  const condaEnvs = opts.condaEnvs || [];
+  const condaOnPath = whichInDirs("conda", pathDirs()).length > 0;
+  if (!condaOnPath) {
+    checks.push(skippedCheck("conda", "stale", "conda not on PATH (conda doctor skipped)"));
+  } else if (condaEnvs.length === 0) {
+    checks.push(skippedCheck("conda", "stale", "no conda environments detected (conda doctor skipped)"));
+  } else {
+    await Promise.all(condaEnvs.map(async (e) => {
+      const out = await runAsync("conda", ["doctor", "-n", e.name], 30000);
+      const r = parseCondaDoctor(out);
+      checks.push(toCheckPerEnv("conda", e.name, r, "stale", e.pythonPath || undefined));
+    }));
+  }
+  for (const p of NETWORK_PROBES) {
+    if (p.network && !network) {
+      checks.push(makeCheck(`health.${p.id}.skipped`, p.kind, "info", `${p.label} doctor skipped (offline by default)`, `Run with --health-network to invoke ${p.label} self-checks (they require network).`));
+      continue;
+    }
+    const picked = pickCandidate(p);
+    if (!picked)
+      continue;
+    const [cmd, args] = picked;
+    const out = await runAsync(cmd, args, p.timeout);
+    const result = p.parse(out);
+    checks.push(toCheckNetwork(p, result));
+  }
+  return checks;
+}
+
 // src/output/json.ts
 function buildManifest(byName, conflicts, checks, environments, shells) {
   const sys = byName.system || {};
@@ -832,6 +1020,46 @@ class ScanProgress {
 }
 
 // src/scan.ts
+import { realpathSync } from "node:fs";
+import { dirname } from "node:path";
+function healthPythonLabel(path) {
+  const lower = path.toLowerCase().replace(/\\/g, "/");
+  const env = lower.match(/[\\/]envs[\\/]([^\\/]+)[\\/]/);
+  if (env)
+    return env[1];
+  if (/miniconda3[\\/]python/i.test(lower) || /anaconda3[\\/]python/i.test(lower))
+    return "base";
+  if (lower.includes("workbuddy/binaries/python"))
+    return "managed";
+  if (lower.includes("/nvm") || lower.includes("\\nvm"))
+    return "nvm";
+  const parts = lower.split("/").filter(Boolean);
+  const parent = parts[parts.length - 2] || "";
+  return parent || "python";
+}
+function dedupePythons(raw) {
+  const byDir = new Map;
+  for (const p of raw) {
+    let rp = p.pythonPath;
+    try {
+      rp = realpathSync(p.pythonPath);
+    } catch {}
+    const dir = dirname(rp);
+    if (!byDir.has(dir))
+      byDir.set(dir, p.pythonPath);
+  }
+  const out = [];
+  const used = new Set;
+  for (const path of byDir.values()) {
+    let label = healthPythonLabel(path);
+    let n = 2;
+    while (used.has(label))
+      label = `${healthPythonLabel(path)}#${n++}`;
+    used.add(label);
+    out.push({ path, label });
+  }
+  return out;
+}
 async function runScan(shells, disabled, opts = {}) {
   const progress = opts.silent ? undefined : new ScanProgress(0, process.stderr.isTTY);
   const ctx = {
@@ -841,7 +1069,8 @@ async function runScan(shells, disabled, opts = {}) {
     progress,
     checkOutdated: opts.checkOutdated,
     wslDeep: opts.wslDeep,
-    auditDeps: opts.auditDeps
+    auditDeps: opts.auditDeps,
+    healthNetwork: opts.healthNetwork
   };
   const { byName, allChecks } = await runDetectors(ctx, progress);
   const groups = [
@@ -850,12 +1079,18 @@ async function runScan(shells, disabled, opts = {}) {
     ...byName.ides || []
   ];
   const conflicts = computeConflicts(groups, shells, disabled);
+  const pythons = dedupePythons(byName.pip?.perInterpreter || []);
+  const condaEnvs = (byName.condaenv?.envs || []).map((e) => ({
+    name: e.name,
+    pythonPath: e.pythonPath
+  }));
+  const healthChecks = await computeHealth({ healthNetwork: opts.healthNetwork, pythons, condaEnvs });
   const securityChecks = [
     ...computeSecurity(byName),
     ...computeScaInventory(),
     ...opts.auditDeps ? runScaAudit(process.cwd()) : []
   ];
-  const collected = [...allChecks, ...conflicts.checks, ...securityChecks].filter((c) => !isCheckDisabled(c.ID, disabled));
+  const collected = [...allChecks, ...conflicts.checks, ...securityChecks, ...healthChecks].filter((c) => !isCheckDisabled(c.ID, disabled));
   const environments = {
     vcpkg: byName.vcpkg,
     pip: byName.pip,
@@ -1742,7 +1977,7 @@ register({
 
 // src/detector/projects.ts
 import { readdirSync as readdirSync4, existsSync as existsSync5, statSync as statSync3 } from "node:fs";
-import { join as join6, basename as basename3, dirname } from "node:path";
+import { join as join6, basename as basename3, dirname as dirname2 } from "node:path";
 function isVenv(dir) {
   if (!existsSync5(join6(dir, "pyvenv.cfg")))
     return false;
@@ -1785,7 +2020,7 @@ function walk(root, maxDepth, out, seen) {
       if (e === ".venv" || e === "venv") {
         if (isVenv(full) && !seen.has(full.toLowerCase())) {
           seen.add(full.toLowerCase());
-          out.push({ project: basename3(dirname(full)), type: "venv", path: full });
+          out.push({ project: basename3(dirname2(full)), type: "venv", path: full });
         }
         continue;
       }
@@ -1906,7 +2141,8 @@ async function cmdScan(opts, pos) {
     silent: opts.quiet === true,
     checkOutdated: opts.outdated === true,
     wslDeep: opts["wsl-deep"] === true,
-    auditDeps: opts["audit-deps"] === true
+    auditDeps: opts["audit-deps"] === true,
+    healthNetwork: opts["health-network"] === true
   });
   if (opts.json) {
     emitText(JSON.stringify(manifest, null, 2), opts.bom === true);
@@ -1963,13 +2199,25 @@ async function cmdQuery(opts, pos) {
     const c = result.conflicts;
     console.log(`  \x1B[1mconflicts\x1B[0m  multiVersion=${c.multiVersionTools?.length || 0}  path=${c.pathConflicts?.length || 0}  ghost=${c.ghostBinaries?.length || 0}`);
   }
-  if (result.checks && result.checks.length) {
-    console.log(`  \x1B[1missues (${result.checks.length})\x1B[0m`);
-    for (const c of result.checks) {
+  const allChecks = result.checks || [];
+  const issues = allChecks.filter((c) => bucketOf(c.Severity) === "issue");
+  const infos = allChecks.filter((c) => bucketOf(c.Severity) === "info");
+  const oks = allChecks.filter((c) => bucketOf(c.Severity) === "ok");
+  if (issues.length) {
+    console.log(`  \x1B[1missues (${issues.length})\x1B[0m`);
+    for (const c of issues) {
       const sev = sevColor(c.Severity);
       console.log(`    ${sev}${c.Severity}\x1B[0m  ${c.ID}  ${c.Label}`);
     }
   }
+  if (infos.length) {
+    console.log(`  \x1B[1minfo (${infos.length})\x1B[0m`);
+    for (const c of infos)
+      console.log(`    ${sevColor(c.Severity)}${c.Severity}\x1B[0m  ${c.ID}  ${c.Label}`);
+  }
+  if (oks.length) {
+    console.log(`  \x1B[32m✓ ${oks.length} checks passed\x1B[0m`);
+  }
   if (!result.groups.length && !result.checks.length && !result.conflicts) {
     console.log("  (no match)");
   }
@@ -2039,6 +2287,13 @@ function sevColor(sev) {
       return "\x1B[0m";
   }
 }
+function bucketOf(sev) {
+  if (sev === "error" || sev === "warn" || sev === "missing")
+    return "issue";
+  if (sev === "info")
+    return "info";
+  return "ok";
+}
 function renderPrettyFromManifest(m) {
   const sys = m.system || {};
   console.log(`\x1B[1mdevmap\x1B[0m v${m.meta?.version || VERSION}  \x1B[2m${sys.hostname || "?"}\x1B[0m  ${sys.platform}/${sys.arch}`);
@@ -2053,13 +2308,26 @@ function renderPrettyFromManifest(m) {
       }
     }
   }
-  const checks = m.checks || [];
+  const allChecks = m.checks || [];
+  const issues = allChecks.filter((c) => bucketOf(c.Severity) === "issue");
+  const infos = allChecks.filter((c) => bucketOf(c.Severity) === "info");
+  const oks = allChecks.filter((c) => bucketOf(c.Severity) === "ok");
   renderEnvironments(m.environments);
-  if (checks.length) {
+  if (issues.length || infos.length || oks.length) {
     console.log("  " + "─".repeat(40));
-    console.log(`  \x1B[1missues (${checks.length})\x1B[0m`);
-    for (const c of checks)
-      console.log(`    ${sevColor(c.Severity)}${c.Severity}\x1B[0m  ${c.ID}  ${c.Label}`);
+    if (issues.length) {
+      console.log(`  \x1B[1missues (${issues.length})\x1B[0m`);
+      for (const c of issues)
+        console.log(`    ${sevColor(c.Severity)}${c.Severity}\x1B[0m  ${c.ID}  ${c.Label}`);
+    }
+    if (infos.length) {
+      console.log(`  \x1B[1minfo (${infos.length})\x1B[0m`);
+      for (const c of infos)
+        console.log(`    ${sevColor(c.Severity)}${c.Severity}\x1B[0m  ${c.ID}  ${c.Label}`);
+    }
+    if (oks.length) {
+      console.log(`  \x1B[32m✓ ${oks.length} checks passed\x1B[0m`);
+    }
   }
 }
 var plur = (n, one, many = one + "s") => `${n} ${n === 1 ? one : many}`;
@@ -2141,11 +2409,25 @@ function renderMarkdownLite(m) {
     }
     lines.push("");
   }
-  if ((m.checks || []).length) {
-    lines.push(`## issues (${m.checks.length})`);
-    for (const c of m.checks)
+  const allChecks = m.checks || [];
+  const issues = allChecks.filter((c) => bucketOf(c.Severity) === "issue");
+  const infos = allChecks.filter((c) => bucketOf(c.Severity) === "info");
+  const oks = allChecks.filter((c) => bucketOf(c.Severity) === "ok");
+  if (issues.length) {
+    lines.push(`## issues (${issues.length})`);
+    for (const c of issues)
+      lines.push(`- [${c.Severity}] \`${c.ID}\` ${c.Label} — ${c.Detail}`);
+  }
+  if (infos.length) {
+    lines.push(`## info (${infos.length})`);
+    for (const c of infos)
       lines.push(`- [${c.Severity}] \`${c.ID}\` ${c.Label} — ${c.Detail}`);
   }
+  if (oks.length) {
+    lines.push(`## checks passed (${oks.length})`);
+    for (const c of oks)
+      lines.push(`- [${c.Severity}] \`${c.ID}\` ${c.Label}`);
+  }
   const env = m.environments || {};
   const envLines = [];
   if (env.vcpkg?.installed)
@@ -2193,6 +2475,7 @@ scan options:
   --wsl-deep        probe inside stopped WSL distros (default probes only running ones to avoid waking distros)
   --ci              CI gate: clean → exit 0; any warn → exit 2; any error → exit 1
   --audit-deps      dependency CVE audit via OSV-Scanner/pip-audit/govulncheck/Trivy (opt-in, uses network)
+  --health-network  run network health probes too (npm doctor / rustup check; off by default to stay offline-fast)
   --quiet           suppress scan progress feedback (for scripts/CI)
   --bom             prepend UTF-8 BOM for viewing in Notepad etc. (only on redirect/pipe)
   --version / --help

{devmap-0.3.5 → devmap-0.3.7}/devmap.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devmap
-Version: 0.3.5
+Version: 0.3.7
 Summary: Map your machine's dev environment and surface issues (PATH conflicts, ghost binaries, multi-version collisions). fastfetch-for-dev-tools. This PyPI package ships the real devmap CLI (a bundled JavaScript app launched via Node.js or Bun), so `pip install devmap && devmap` works standalone.
 Author: devmap contributors
 License: MIT
@@ -40,6 +40,7 @@ Requirements at runtime: a Node.js (or Bun) runtime available on `PATH`. Python
 - **Off-PATH awareness**: reports installed-but-not-on-PATH tools, while correctly treating version-manager environments (conda envs, nvm versions) as by-design off-PATH.
 - **Environment layers**: vcpkg packages, per-python pip packages (incl. upgradable), apt packages (Linux), conda environments, Docker (binary + daemon + images/containers), WSL distros, Visual Studio dev shells, and project-local environments (`.venv`, `node_modules`).
 - **Dependency auditing (optional)**: with `--audit-deps`, devmap detects and invokes installed SCA tools (osv-scanner, govulncheck, pip-audit, Trivy), parses their JSON, and merges results into a unified view. devmap is a *scanner/orchestrator*, not a CVE database — for authoritative vulnerability data, use those tools directly.
+- **Health layer**: converges official self-checks into one view, **per environment**. Offline by default: `pip check` runs for **every** Python interpreter, and `conda doctor` runs for **every** conda env. With `--health-network`, `npm doctor` / `rustup check` are added. Missing/offline probes degrade gracefully to `info` (skipped). Only `warn`/`error` surface under `issues (N)`; passing checks are summarized as `✓ N checks passed`.
 - **Three sub-commands**: `scan` (the fact source), `query` (ask the manifest), `devdiff` (compare two manifests — environment drift / cross-machine consistency).
 - **Zero Python dependencies.** The bundled app is pure TypeScript compiled to JavaScript.
 

{devmap-0.3.5 → devmap-0.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devmap"
-version = "0.3.5"
+version = "0.3.7"
 description = "Map your machine's dev environment and surface issues (PATH conflicts, ghost binaries, multi-version collisions). fastfetch-for-dev-tools. This PyPI package ships the real devmap CLI (a bundled JavaScript app launched via Node.js or Bun), so `pip install devmap && devmap` works standalone."
 readme = "README.md"
 requires-python = ">=3.8"