devmap 0.3.5__py3-none-any.whl → 0.3.6__py3-none-any.whl

devmap/_devmap.mjs

@@ -2,7 +2,7 @@
 // @bun
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.3.6";
 
 // src/install.ts
 function isIsolated(i) {
@@ -662,6 +662,138 @@ 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" };
+}
+
+// src/health/scan.ts
+var PROBES = [
+  {
+    id: "pip",
+    label: "pip",
+    kind: "conflict",
+    network: false,
+    candidates: [
+      ["pip", ["check"]],
+      ["pip3", ["check"]],
+      ["python", ["-m", "pip", "check"]],
+      ["python3", ["-m", "pip", "check"]]
+    ],
+    timeout: 15000,
+    parse: parsePipCheck
+  },
+  {
+    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
+  }
+];
+function pickCandidate(p) {
+  const dirs = pathDirs();
+  for (const [cmd, args] of p.candidates) {
+    if (whichInDirs(cmd, dirs).length > 0)
+      return [cmd, args];
+  }
+  return null;
+}
+var SEV_OF = {
+  ok: "ok",
+  warn: "warn",
+  info: "info",
+  skipped: "info"
+};
+function toCheck(p, r) {
+  const sev = SEV_OF[r.status];
+  const id = `health.${p.id}.check`;
+  const realId = r.status === "skipped" ? `health.${p.id}.skipped` : id;
+  return makeCheck(realId, p.kind, sev, r.summary, r.detail || "", [], r.status === "ok" ? undefined : undefined);
+}
+async function computeHealth(opts = {}) {
+  const checks = [];
+  const network = opts.healthNetwork === true;
+  for (const p of PROBES) {
+    const picked = pickCandidate(p);
+    if (!picked)
+      continue;
+    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 [cmd, args] = picked;
+    const out = await runAsync(cmd, args, p.timeout);
+    const result = p.parse(out);
+    checks.push(toCheck(p, result));
+  }
+  return checks;
+}
+
 // src/output/json.ts
 function buildManifest(byName, conflicts, checks, environments, shells) {
   const sys = byName.system || {};
@@ -841,7 +973,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 +983,13 @@ async function runScan(shells, disabled, opts = {}) {
     ...byName.ides || []
   ];
   const conflicts = computeConflicts(groups, shells, disabled);
+  const healthChecks = await computeHealth({ healthNetwork: opts.healthNetwork });
   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,
@@ -1906,7 +2040,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);
@@ -2193,6 +2328,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.dist-info → devmap-0.3.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devmap
-Version: 0.3.5
+Version: 0.3.6
 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 — `pip check` (broken dependency requirements, **offline by default**) and, with `--health-network`, `npm doctor` / `rustup check`. Unavailable or offline probes degrade gracefully to `info`.
 - **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.6.dist-info/RECORD

@@ -0,0 +1,7 @@
+devmap/__init__.py,sha256=4Ek7Di0FYYl76FKnHJ8VYiJPHlUTfoqyBB_hul_pFbk,1728
+devmap/_devmap.mjs,sha256=kYiHodxsTRu90Anb1QtKk_llF1-Q21S4N9KrLuHgQsw,84108
+devmap-0.3.6.dist-info/METADATA,sha256=J89bwvXkn1xoRuyarTu7e1LQgQyCohhgIVylFrS21nI,6796
+devmap-0.3.6.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+devmap-0.3.6.dist-info/entry_points.txt,sha256=FOQKZCLz0WGWemrTw0suYRqKWrUB4_XJ2Gkrw60ZEcg,39
+devmap-0.3.6.dist-info/top_level.txt,sha256=QeomiD_JKcjSd_jTZv0WJF3darUb2sUsxmocjgYJ6Qc,7
+devmap-0.3.6.dist-info/RECORD,,

devmap-0.3.5.dist-info/RECORD

@@ -1,7 +0,0 @@
-devmap/__init__.py,sha256=4Ek7Di0FYYl76FKnHJ8VYiJPHlUTfoqyBB_hul_pFbk,1728
-devmap/_devmap.mjs,sha256=xRTpuwBHdOAWySpx4TEudvxS0aIA288NYmluaXyoEAw,79539
-devmap-0.3.5.dist-info/METADATA,sha256=mwnfHI_6L1uNkqqjinecVYDiy0vtTWSS0fguLrtLk5s,6536
-devmap-0.3.5.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-devmap-0.3.5.dist-info/entry_points.txt,sha256=FOQKZCLz0WGWemrTw0suYRqKWrUB4_XJ2Gkrw60ZEcg,39
-devmap-0.3.5.dist-info/top_level.txt,sha256=QeomiD_JKcjSd_jTZv0WJF3darUb2sUsxmocjgYJ6Qc,7
-devmap-0.3.5.dist-info/RECORD,,