claude-nomad 0.29.1 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.30.0](https://github.com/funkadelic/claude-nomad/compare/v0.29.1...v0.30.0) (2026-05-29)
+
+
+### Added
+
+* **doctor:** report gh and curl presence in Version Checks ([#175](https://github.com/funkadelic/claude-nomad/issues/175)) ([5163833](https://github.com/funkadelic/claude-nomad/commit/516383301dbd9c64cfc8f1c7a654655b61c29280))
+
+
+### Changed
+
+* widen npm-publish smoke-test propagation window ([#176](https://github.com/funkadelic/claude-nomad/issues/176)) ([f8b1eef](https://github.com/funkadelic/claude-nomad/commit/f8b1eef18dcee91fb894d2036c42356f82c76f79))
+
 ## [0.29.1](https://github.com/funkadelic/claude-nomad/compare/v0.29.0...v0.29.1) (2026-05-29)
 
 

package/README.md

@@ -380,10 +380,11 @@ Read these before adopting so you opt in with eyes open.
 
 - `gh` ([GitHub CLI](https://cli.github.com/)), used only by `nomad init` to auto-disable Actions on
   the private repo; if it is missing or unauthenticated, init prints a manual fallback tip and
-  continues
+  continues. `nomad doctor` reports its presence in the Version Checks section.
 - [curl](https://curl.se/), used by the version/update check (the `nomad doctor` latest-release line
   and the post-`nomad update` check) and by `nomad doctor --check-schema`; it degrades silently when
-  curl is absent or offline, so the rest of the CLI works without it
+  curl is absent or offline, so the rest of the CLI works without it. `nomad doctor` reports its
+  presence in the Version Checks section.
 
 ## Setup
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-nomad",
-  "version": "0.29.1",
+  "version": "0.30.0",
   "type": "module",
   "description": "Sync Claude Code config (~/.claude/) across machines via a private Git repo, with path remapping and per-host settings overrides.",
   "keywords": [

package/src/commands.doctor.checks.deps.ts

@@ -0,0 +1,97 @@
+import { execFileSync } from 'node:child_process';
+
+import { green, okGlyph, warnGlyph, yellow } from './color.ts';
+import { addItem, type DoctorSection } from './commands.doctor.format.ts';
+import type { SpawnSyncFn } from './gh-actions.ts';
+
+/**
+ * Optional-dependency presence reporter for `nomad doctor`. Probes for `gh`
+ * and `curl` (both optional CLIs used by nomad features) and emits one row
+ * per binary in the Version Checks section:
+ *   - present with parsed version: `okGlyph gh: X.Y.Z`
+ *   - present but version unparseable: `okGlyph gh: present`
+ *   - not installed (ENOENT): `warnGlyph gh: not installed (optional; ...)`
+ *
+ * This reporter MUST NOT set `process.exitCode`: absent optional deps are
+ * informational only (D-02). Both probes always run unconditionally.
+ */
+
+/**
+ * Regex to extract the first X.Y.Z version token from a string. Each segment
+ * is bounded (`{1,9}`) rather than `+` so the pattern is provably linear: a
+ * `--version` line never has a segment longer than a few digits, and bounding
+ * the repetition removes the super-linear backtracking an unbounded
+ * `\d+\.\d+\.\d+` carries on a degenerate all-digit input.
+ */
+const VERSION_TOKEN = /(\d{1,9}\.\d{1,9}\.\d{1,9})/;
+
+/**
+ * Extract the first X.Y.Z-shaped version token from a string.
+ *
+ * @param line - A single line of --version output (already trimmed).
+ * @returns The first version token, or `null` if none found.
+ */
+function parseFirstVersion(line: string): string | null {
+  const m = VERSION_TOKEN.exec(line);
+  return m ? m[1] : null;
+}
+
+/** Discriminated union for binary probe results. */
+type DepProbeResult = { status: 'present'; version: string | null } | { status: 'not-installed' };
+
+/**
+ * Probe a binary by running `bin --version` and parsing the first output line.
+ * Returns a DepProbeResult: present (with optional version token) or
+ * not-installed (ENOENT). Non-ENOENT errors are treated as present with no
+ * version (D-03: "never FAIL on unexpected --version output").
+ *
+ * @param bin - The binary name to probe (e.g. `gh` or `curl`).
+ * @param run - Injectable subprocess runner; defaults to `execFileSync`.
+ */
+function probeOptionalDep(bin: string, run: SpawnSyncFn): DepProbeResult {
+  try {
+    const firstLine = run(bin, ['--version'], { stdio: ['ignore', 'pipe', 'pipe'] })
+      .toString()
+      .split('\n')[0]
+      .trim();
+    const version = parseFirstVersion(firstLine);
+    return { status: 'present', version };
+  } catch (err) {
+    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {
+      return { status: 'not-installed' };
+    }
+    // Non-ENOENT: binary may exist but --version misbehaved; report as present.
+    return { status: 'present', version: null };
+  }
+}
+
+/**
+ * Emit presence rows for the optional `gh` and `curl` CLIs into the given
+ * doctor section. Each row shows the binary's install status and version (if
+ * parseable). Absent binaries emit a WARN naming the features they enable.
+ * Never sets `process.exitCode` (D-02): both deps are optional.
+ *
+ * @param section - The Version Checks section to append rows to.
+ * @param run - Injectable subprocess runner; defaults to `execFileSync`.
+ */
+export function reportOptionalDeps(section: DoctorSection, run: SpawnSyncFn = execFileSync): void {
+  const gh = probeOptionalDep('gh', run);
+  if (gh.status === 'present') {
+    addItem(section, `${green(okGlyph)} gh: ${gh.version ?? 'present'}`);
+  } else {
+    addItem(
+      section,
+      `${yellow(warnGlyph)} gh: not installed (optional; needed for nomad init Actions auto-disable + mirror-Actions drift check)`,
+    );
+  }
+
+  const curl = probeOptionalDep('curl', run);
+  if (curl.status === 'present') {
+    addItem(section, `${green(okGlyph)} curl: ${curl.version ?? 'present'}`);
+  } else {
+    addItem(
+      section,
+      `${yellow(warnGlyph)} curl: not installed (optional; needed for release-version staleness check + nomad doctor --check-schema)`,
+    );
+  }
+}

package/src/commands.doctor.ts

@@ -25,6 +25,7 @@ import { REPO_HOME, type PathMap } from './config.ts';
 import { reportNodeEngineCheck } from './commands.doctor.engine.ts';
 import { readJsonSafe, renderDoctor, section } from './commands.doctor.format.ts';
 import { reportGitleaksVersionCheck } from './commands.doctor.gitleaks-version.ts';
+import { reportOptionalDeps } from './commands.doctor.checks.deps.ts';
 import { reportMirrorActions } from './commands.doctor.mirror-actions.ts';
 import { reportVersionCheck } from './commands.doctor.version.ts';
 
@@ -85,6 +86,7 @@ export function cmdDoctor(opts: { checkShared?: boolean; checkSchema?: boolean }
   reportVersionCheck(version);
   reportNodeEngineCheck(version);
   reportGitleaksVersionCheck(version);
+  reportOptionalDeps(version);
 
   const sharedScan = section('Shared scan');
   // Reuse the Repository-section readiness probe so reportCheckShared does not