@getmarrow/install 0.1.17 → 0.1.19

package/README.md

@@ -11,6 +11,16 @@ npx @getmarrow/install --repair
 npx @getmarrow/install doctor
 ```
 
+## What's New in v0.1.19
+
+v0.1.19 makes Marrow doctor and release smoke stricter, so agents know exactly why logging is degraded.
+
+- `npx @getmarrow/install doctor --self-test` now validates: key found, key valid, account active, agent identity accepted, harmless write test created, and outcome closed.
+- Doctor reports exact failure reasons such as `missing_key`, `invalid_key`, `wrong_agent_id`, `network_blocked`, and `proof_required`.
+- Doctor warns when local `@getmarrow/install`, `@getmarrow/sdk`, or `@getmarrow/mcp` versions are behind the current release.
+- New `scripts/fresh-install-smoke.sh` verifies a clean temp install can load `.marrow/env`, run doctor, write a test event, and close the outcome.
+- Full keys are still never printed in diagnostics. Keep `.marrow/env` out of git and set file permissions to owner-only when possible.
+
 ## What's New in v0.1.17
 
 v0.1.17 expands the Govern TUI harness addon coverage while preserving adaptive mode recommendations.
@@ -223,6 +233,14 @@ Doctor check:
 MARROW_API_KEY=mrw_live_xxx npx @getmarrow/install doctor
 ```
 
+Deep doctor with harmless write/outcome verification:
+
+```bash
+MARROW_API_KEY=mrw_live_xxx npx @getmarrow/install doctor --self-test
+```
+
+Expected healthy output includes `key valid: yes`, `write test event: passed`, and `outcome closed: passed`.
+
 Repair missing hooks/config:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmarrow/install",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Universal installer for Marrow passive agent setup.",
   "bin": {
     "marrow-install": "bin/marrow-install.js"

package/src/installer.js

@@ -4,6 +4,9 @@ const os = require('node:os');
 const crypto = require('node:crypto');
 
 const DEFAULT_BASE_URL = 'https://api.getmarrow.ai';
+const INSTALLER_LATEST = '0.1.19';
+const SDK_LATEST = '3.7.35';
+const MCP_LATEST = '3.9.35';
 const MARROW_BLOCK_START = '<!-- marrow:passive-start -->';
 const MARROW_BLOCK_END = '<!-- marrow:passive-end -->';
 
@@ -15,7 +18,7 @@ function parseArgs(argv) {
     doctor: false,
     repair: false,
     mode: 'auto',
-    apiKey: process.env.MARROW_API_KEY || '',
+    apiKey: process.env.MARROW_API_KEY || process.env.MARROW_KEY || '',
     baseUrl: process.env.MARROW_BASE_URL || DEFAULT_BASE_URL,
     agentId: process.env.MARROW_FLEET_AGENT_ID || process.env.MARROW_AGENT_ID || '',
     selfTest: true,
@@ -57,6 +60,12 @@ function parseArgs(argv) {
     throw new Error('--mode must be one of auto, mcp, sdk, both, md');
   }
 
+  const resolved = resolveMarrowKeyMaterial(options.cwd);
+  if (!options.apiKey && resolved.apiKey) options.apiKey = resolved.apiKey;
+  if (!options.agentId && resolved.agentId) options.agentId = resolved.agentId;
+  if (options.baseUrl === DEFAULT_BASE_URL && resolved.baseUrl) options.baseUrl = resolved.baseUrl;
+  if (!options.keySource && resolved.source) options.keySource = resolved.source;
+
   return options;
 }
 
@@ -71,14 +80,14 @@ function usage() {
 
 Options:
   --dry-run          Print planned changes without writing
-  --doctor           Check install health without writing
+  --doctor           Check install health; self-test writes and closes a harmless test event
   --repair           Write missing hooks/config, then run self-test and status check
   --yes, -y          Write detected config files
   --mode <mode>      auto, mcp, sdk, both, or md
   --key <key>        Marrow API key for self-test. Prefer MARROW_API_KEY because CLI args can appear in process listings.
   --base-url <url>   Marrow API base URL
   --agent-id <id>    Agent/fleet id for self-test headers
-  --no-self-test     Skip API smoke/self-test
+  --no-self-test     Skip API smoke/self-test for a read-only doctor check
 `;
 }
 
@@ -157,8 +166,7 @@ function findLikelyEnvFiles(detection, env = process.env) {
     path.join(detection.root, '.marrow', 'env'),
     path.join(detection.root, '.marrow', 'env.local'),
     path.join(home, '.marrow', 'env'),
-    path.join(home, '.openclaw', 'credentials', 'marrow-mcp.env'),
-    path.join(home, '.openclaw', 'gateway.systemd.env'),
+    path.join(home, '.marrow', 'env.local'),
   ];
   return candidates.filter((filePath) => {
     if (!exists(filePath)) return false;
@@ -183,6 +191,36 @@ function readEnvVar(filePath, name) {
   return match ? stripQuotes(match[1]) : '';
 }
 
+function resolveMarrowKeyMaterial(cwd = process.cwd(), env = process.env) {
+  if (env.MARROW_API_KEY || env.MARROW_KEY) {
+    return {
+      apiKey: env.MARROW_API_KEY || env.MARROW_KEY,
+      baseUrl: env.MARROW_BASE_URL || DEFAULT_BASE_URL,
+      agentId: env.MARROW_FLEET_AGENT_ID || env.MARROW_AGENT_ID || '',
+      source: env.MARROW_API_KEY ? 'MARROW_API_KEY' : 'MARROW_KEY',
+    };
+  }
+
+  const detection = detectEnvironment(cwd, env);
+  for (const filePath of findLikelyEnvFiles(detection, env)) {
+    const apiKey = readEnvVar(filePath, 'MARROW_API_KEY') || readEnvVar(filePath, 'MARROW_KEY');
+    if (!apiKey) continue;
+    return {
+      apiKey,
+      baseUrl: readEnvVar(filePath, 'MARROW_BASE_URL') || env.MARROW_BASE_URL || DEFAULT_BASE_URL,
+      agentId: readEnvVar(filePath, 'MARROW_FLEET_AGENT_ID') || readEnvVar(filePath, 'MARROW_AGENT_ID') || env.MARROW_FLEET_AGENT_ID || env.MARROW_AGENT_ID || '',
+      source: filePath,
+    };
+  }
+
+  return {
+    apiKey: '',
+    baseUrl: env.MARROW_BASE_URL || DEFAULT_BASE_URL,
+    agentId: env.MARROW_FLEET_AGENT_ID || env.MARROW_AGENT_ID || '',
+    source: null,
+  };
+}
+
 function readFirstLineSecret(filePath) {
   if (!exists(filePath)) return '';
   return safeRead(filePath).split(/\r?\n/).map((line) => line.trim()).find(Boolean) || '';
@@ -297,27 +335,79 @@ Required environment:
 
 - \`MARROW_API_KEY\`
 - Optional: \`MARROW_BASE_URL\`, \`MARROW_FLEET_AGENT_ID\`
+
+Key loading:
+
+- Prefer your shell, MCP secret store, or agent secret manager.
+- Marrow also auto-detects \`.marrow/env\`, \`.marrow/env.local\`, \`.env\`, \`.env.local\`, and \`~/.marrow/env\`.
+- Run \`npx @getmarrow/install doctor\` any time an agent says Marrow is missing or degraded.
 ${MARROW_BLOCK_END}`;
 }
 
 function passiveRuntimeSource() {
-  return `const apiKey = process.env.MARROW_API_KEY;
+  return `import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+function stripQuotes(value) {
+  const trimmed = String(value || '').trim();
+  if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) return trimmed.slice(1, -1);
+  return trimmed;
+}
+
+function readEnvFile(filePath) {
+  if (!fs.existsSync(filePath)) return {};
+  const values = {};
+  const allowed = new Set(['MARROW_API_KEY', 'MARROW_KEY', 'MARROW_BASE_URL', 'MARROW_FLEET_AGENT_ID', 'MARROW_AGENT_ID', 'MARROW_SESSION_ID', 'MARROW_ENFORCEMENT_MODE', 'MARROW_PASSIVE_VALUE_REPORT', 'MARROW_VALUE_REPORT_PERIOD', 'MARROW_AGENT_RUNTIME', 'MARROW_WORKFLOW_GATE', 'MARROW_REQUIRE_OUTCOME_CLOSURE']);
+  for (const line of fs.readFileSync(filePath, 'utf8').split(/\\r?\\n/)) {
+    const match = line.match(/^\\s*(?:export\\s+)?([A-Z_][A-Z0-9_]*)\\s*=\\s*(.*?)\\s*$/);
+    if (!match) continue;
+    if (!allowed.has(match[1])) continue;
+    let value = match[2] || '';
+    const hashIndex = value.search(/\\s+#/);
+    if (hashIndex >= 0) value = value.slice(0, hashIndex);
+    values[match[1]] = stripQuotes(value);
+  }
+  return values;
+}
+
+function resolveMarrowEnv() {
+  if (process.env.MARROW_API_KEY || process.env.MARROW_KEY) return process.env;
+  const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+  const files = [];
+  let dir = process.cwd();
+  for (let depth = 0; depth < 8; depth += 1) {
+    files.push(path.join(dir, '.marrow', 'env'), path.join(dir, '.marrow', 'env.local'), path.join(dir, '.env'), path.join(dir, '.env.local'));
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  files.push(path.join(home, '.marrow', 'env'), path.join(home, '.marrow', 'env.local'));
+  for (const filePath of [...new Set(files)]) {
+    const values = readEnvFile(filePath);
+    if (values.MARROW_API_KEY || values.MARROW_KEY) return { ...process.env, ...values };
+  }
+  return process.env;
+}
+
+const marrowEnv = resolveMarrowEnv();
+const apiKey = marrowEnv.MARROW_API_KEY || marrowEnv.MARROW_KEY;
 if (apiKey && !globalThis.__MARROW_PASSIVE_RUNTIME__) {
   try {
     const { MarrowClient } = await import('@getmarrow/sdk');
     const marrow = new MarrowClient(apiKey, {
-      baseUrl: process.env.MARROW_BASE_URL,
-      agentId: process.env.MARROW_FLEET_AGENT_ID || process.env.MARROW_AGENT_ID,
-      sessionId: process.env.MARROW_SESSION_ID,
-      mode: process.env.MARROW_ENFORCEMENT_MODE || 'auto',
+      baseUrl: marrowEnv.MARROW_BASE_URL,
+      agentId: marrowEnv.MARROW_FLEET_AGENT_ID || marrowEnv.MARROW_AGENT_ID,
+      sessionId: marrowEnv.MARROW_SESSION_ID,
+      mode: marrowEnv.MARROW_ENFORCEMENT_MODE || 'auto',
     });
 
     const runtime = marrow.createPassiveRuntime({
-      includeValueReport: process.env.MARROW_PASSIVE_VALUE_REPORT !== 'false',
-      valueReportPeriod: process.env.MARROW_VALUE_REPORT_PERIOD || '7d',
-      useAgentRuntime: process.env.MARROW_AGENT_RUNTIME !== 'false',
-      useWorkflowGate: process.env.MARROW_WORKFLOW_GATE !== 'false',
-      requireOutcomeClosure: process.env.MARROW_REQUIRE_OUTCOME_CLOSURE !== 'false',
+      includeValueReport: marrowEnv.MARROW_PASSIVE_VALUE_REPORT !== 'false',
+      valueReportPeriod: marrowEnv.MARROW_VALUE_REPORT_PERIOD || '7d',
+      useAgentRuntime: marrowEnv.MARROW_AGENT_RUNTIME !== 'false',
+      useWorkflowGate: marrowEnv.MARROW_WORKFLOW_GATE !== 'false',
+      requireOutcomeClosure: marrowEnv.MARROW_REQUIRE_OUTCOME_CLOSURE !== 'false',
     });
 
     runtime.install();
@@ -325,6 +415,8 @@ if (apiKey && !globalThis.__MARROW_PASSIVE_RUNTIME__) {
   } catch {
     console.warn('[Marrow] passive runtime skipped: install @getmarrow/sdk or verify SDK initialization. Run npm install @getmarrow/sdk, then rerun npx @getmarrow/install --repair.');
   }
+} else if (!apiKey) {
+  console.warn('[Marrow] passive runtime skipped: MARROW_API_KEY missing. Put it in .marrow/env or run npx @getmarrow/install doctor for the exact fix.');
 }
 `;
 }
@@ -444,6 +536,82 @@ function inspectSdkDependency(detection) {
   };
 }
 
+function compareVersions(a, b) {
+  const left = String(a || '0.0.0').replace(/^[^\d]*/, '').split('.').map((part) => parseInt(part, 10) || 0);
+  const right = String(b || '0.0.0').replace(/^[^\d]*/, '').split('.').map((part) => parseInt(part, 10) || 0);
+  for (let i = 0; i < Math.max(left.length, right.length); i += 1) {
+    const x = left[i] || 0;
+    const y = right[i] || 0;
+    if (x > y) return 1;
+    if (x < y) return -1;
+  }
+  return 0;
+}
+
+function dependencyVersion(packageJson, packageName) {
+  for (const block of ['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies']) {
+    const value = packageJson?.[block]?.[packageName];
+    if (typeof value === 'string') return value;
+  }
+  return null;
+}
+
+function installedPackageVersion(root, packageName) {
+  const packageJsonPath = path.join(root, 'node_modules', ...packageName.split('/'), 'package.json');
+  try {
+    const raw = safeRead(packageJsonPath);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    return typeof parsed.version === 'string' ? parsed.version : null;
+  } catch {
+    return null;
+  }
+}
+
+function inspectPackageVersions(detection) {
+  const rootPackage = safeRead(detection.paths.packageJson);
+  let packageJson = {};
+  try {
+    packageJson = rootPackage ? JSON.parse(rootPackage) : {};
+  } catch {
+    packageJson = {};
+  }
+  const versions = [
+    {
+      name: '@getmarrow/install',
+      installed: require('../package.json').version,
+      latest: INSTALLER_LATEST,
+      source: 'current installer',
+      update_command: 'npm install -g @getmarrow/install@latest',
+    },
+    {
+      name: '@getmarrow/sdk',
+      installed: installedPackageVersion(detection.root, '@getmarrow/sdk') || dependencyVersion(packageJson, '@getmarrow/sdk'),
+      latest: SDK_LATEST,
+      source: installedPackageVersion(detection.root, '@getmarrow/sdk') ? 'node_modules' : 'package.json',
+      update_command: 'npm install @getmarrow/sdk@latest',
+    },
+    {
+      name: '@getmarrow/mcp',
+      installed: installedPackageVersion(detection.root, '@getmarrow/mcp') || dependencyVersion(packageJson, '@getmarrow/mcp'),
+      latest: MCP_LATEST,
+      source: installedPackageVersion(detection.root, '@getmarrow/mcp') ? 'node_modules' : 'package.json',
+      update_command: 'npm install @getmarrow/mcp@latest',
+    },
+  ];
+  return versions.map((entry) => {
+    const normalized = entry.installed ? String(entry.installed).replace(/^[^\d]*/, '') : null;
+    const outdated = normalized ? compareVersions(normalized, entry.latest) < 0 : false;
+    return {
+      ...entry,
+      installed: normalized,
+      present: Boolean(normalized),
+      outdated,
+      warning: outdated ? `${entry.name} ${normalized} is older than ${entry.latest}.` : null,
+    };
+  });
+}
+
 function buildPlan(detection, options) {
   const mode = options.mode === 'auto'
     ? detection.node && (detection.claudeCode || detection.cursor || detection.codex || detection.openclaw)
@@ -548,11 +716,108 @@ async function requestJson(url, options) {
   }
   if (!res.ok) {
     const message = json.error || json.message || `HTTP ${res.status}`;
-    throw new Error(String(message));
+    const error = new Error(String(message));
+    error.status = res.status;
+    error.code = json.code || null;
+    error.details = json.details || null;
+    throw error;
   }
   return json.data || json;
 }
 
+function classifyDoctorFailure(error) {
+  const status = error?.status || 0;
+  const text = `${error?.code || ''} ${error?.message || error}`.toLowerCase();
+  if (status === 401 || /missing_key|invalid_key|unauthorized|invalid api key/.test(text)) return 'invalid_key';
+  if (status === 403 && /agent|bound|identity/.test(text)) return 'wrong_agent_id';
+  if (status === 403) return 'invalid_key';
+  if (status === 409 || /proof/.test(text)) return 'proof_required';
+  if (status === 429 || /rate limit|too many/.test(text)) return 'network_blocked';
+  if (status >= 500 || /timeout|network|fetch failed|econnreset|enotfound|eai_again/.test(text)) return 'network_blocked';
+  return 'unknown';
+}
+
+async function runDoctorValidation(options, selfTest) {
+  if (!options.apiKey) {
+    return {
+      key_found: false,
+      key_valid: false,
+      account_active: false,
+      agent_identity_accepted: false,
+      write_test_event: 'skipped',
+      outcome_closed: 'skipped',
+      failure_reason: 'missing_key',
+      exact_fix: 'Create an API key at https://getmarrow.ai/account, then put MARROW_API_KEY in .marrow/env and run npx @getmarrow/install doctor --self-test.',
+    };
+  }
+
+  if (selfTest && !selfTest.skipped && selfTest.active && !selfTest.error) {
+    return {
+      key_found: true,
+      key_valid: true,
+      account_active: true,
+      agent_identity_accepted: true,
+      write_test_event: 'passed',
+      outcome_closed: 'passed',
+      failure_reason: null,
+      decision_id: selfTest.decision_id,
+      exact_fix: null,
+    };
+  }
+
+  if (selfTest && selfTest.error) {
+    const reason = classifyDoctorFailure(selfTest);
+    return {
+      key_found: true,
+      key_valid: !['missing_key', 'invalid_key'].includes(reason),
+      account_active: !['missing_key', 'invalid_key'].includes(reason),
+      agent_identity_accepted: reason !== 'wrong_agent_id',
+      write_test_event: 'failed',
+      outcome_closed: 'failed',
+      failure_reason: reason,
+      exact_fix: reason === 'wrong_agent_id'
+        ? 'Set MARROW_FLEET_AGENT_ID/MARROW_AGENT_ID to the id bound to this key, then rerun doctor.'
+        : reason === 'network_blocked'
+        ? 'Retry from a network path that can reach api.getmarrow.ai, or reduce status polling if rate-limited.'
+        : 'Create/copy a live API key from the Marrow dashboard and update MARROW_API_KEY.',
+    };
+  }
+
+  const headers = { authorization: `Bearer ${options.apiKey}` };
+  if (options.agentId) headers['x-marrow-agent-id'] = options.agentId;
+  try {
+    const status = await requestJson(`${options.baseUrl.replace(/\/+$/, '')}/v1/agent/status`, { headers });
+    return {
+      key_found: true,
+      key_valid: true,
+      account_active: true,
+      agent_identity_accepted: true,
+      write_test_event: 'skipped',
+      outcome_closed: 'skipped',
+      failure_reason: null,
+      status_health: status.health || 'unknown',
+      status_failure_reasons: status.failure_reasons || [],
+      exact_fix: status.recommended_fix || status.diagnostics?.exact_fix || null,
+    };
+  } catch (error) {
+    const reason = classifyDoctorFailure(error);
+    return {
+      key_found: true,
+      key_valid: !['missing_key', 'invalid_key'].includes(reason),
+      account_active: !['missing_key', 'invalid_key'].includes(reason),
+      agent_identity_accepted: reason !== 'wrong_agent_id',
+      write_test_event: 'skipped',
+      outcome_closed: 'skipped',
+      failure_reason: reason,
+      exact_fix: reason === 'wrong_agent_id'
+        ? 'Set MARROW_FLEET_AGENT_ID/MARROW_AGENT_ID to the id bound to this key, then rerun doctor.'
+        : reason === 'network_blocked'
+        ? 'Check network access to api.getmarrow.ai and rerun doctor.'
+        : 'Create/copy a live API key from the Marrow dashboard and update MARROW_API_KEY.',
+    };
+  }
+}
+
 async function runSelfTest(options) {
   if (!options.selfTest) return { skipped: true, reason: 'disabled' };
   if (!options.apiKey) {
@@ -838,6 +1103,24 @@ function printReport(report) {
     process.stdout.write(`- missing env: ${report.doctor.missingEnv.length ? report.doctor.missingEnv.join(', ') : 'none'}\n`);
     if (report.doctor.envHints.length) process.stdout.write(`- possible env files: ${report.doctor.envHints.join(', ')}\n`);
     process.stdout.write(`- missing hooks/config: ${report.doctor.missingHooks.length ? report.doctor.missingHooks.join('; ') : 'none'}\n`);
+    if (report.doctor.validation) {
+      const validation = report.doctor.validation;
+      process.stdout.write(`- key found: ${validation.key_found ? 'yes' : 'no'}\n`);
+      process.stdout.write(`- key valid: ${validation.key_valid ? 'yes' : 'no'}\n`);
+      process.stdout.write(`- account active: ${validation.account_active ? 'yes' : 'no'}\n`);
+      process.stdout.write(`- agent identity accepted: ${validation.agent_identity_accepted ? 'yes' : 'no'}\n`);
+      process.stdout.write(`- write test event: ${validation.write_test_event}\n`);
+      process.stdout.write(`- outcome closed: ${validation.outcome_closed}\n`);
+      if (validation.failure_reason) process.stdout.write(`- failure reason: ${validation.failure_reason}\n`);
+      if (validation.exact_fix) process.stdout.write(`- exact fix: ${validation.exact_fix}\n`);
+    }
+    if (report.packageVersions?.length) {
+      const outdated = report.packageVersions.filter((pkg) => pkg.outdated);
+      process.stdout.write(`- package versions: ${outdated.length ? 'updates recommended' : 'current'}\n`);
+      for (const pkg of outdated) {
+        process.stdout.write(`  - ${pkg.warning} Fix: ${pkg.update_command}\n`);
+      }
+    }
     if (report.doctor.recommendedFix) process.stdout.write(`- recommended fix: ${report.doctor.recommendedFix}\n`);
   }
 
@@ -860,6 +1143,7 @@ async function install(options) {
   const changes = applyPlan(plan, options);
   const configInspection = inspectNpmTokenConfig();
   const sdkDependency = inspectSdkDependency(detection);
+  const packageVersions = inspectPackageVersions(detection);
   const configDiagnostics = configInspection.safe;
   const configRepairs = options.repair && !options.dryRun && !options.doctor
     ? repairConfigDiagnostics(configDiagnostics)
@@ -869,7 +1153,11 @@ async function install(options) {
     skipped: false,
     active: false,
     error: error instanceof Error ? error.message : String(error),
+    status: error?.status || null,
+    code: error?.code || null,
+    details: error?.details || null,
   }));
+  const doctorValidation = await runDoctorValidation(options, selfTest);
   const changedConfig = changes.some((change) => change.changed) || configRepairs.some((repair) => repair.changed);
   const selfTestPassed = Boolean(!selfTest.skipped && selfTest.active && !selfTest.error);
   const remediation = options.repair
@@ -906,16 +1194,19 @@ async function install(options) {
       missingEnv: options.apiKey ? [] : ['MARROW_API_KEY'],
       envHints,
       missingHooks: changes.filter((change) => change.changed).map((change) => change.label),
+      validation: doctorValidation,
+      packageVersions,
       recommendedFix: configDiagnostics.npm_token.recommended_fix || selfTest.recommended_fix || (!options.apiKey
         ? envHints.length
-          ? `MARROW_API_KEY was found in a likely env file at ${envHints[0]}. Load that key from trusted secret storage, export only MARROW_API_KEY, then run npx @getmarrow/install --repair.`
-          : 'Set MARROW_API_KEY, then run npx @getmarrow/install --repair.'
+          ? `MARROW_API_KEY was found in ${envHints[0]} and can now be auto-loaded by Marrow SDK/MCP runtimes. Run npx @getmarrow/install --repair to refresh hooks and self-test.`
+          : 'Set MARROW_API_KEY or MARROW_KEY in your shell, MCP secret store, .marrow/env, or ~/.marrow/env, then run npx @getmarrow/install --repair.'
         : null),
     },
     remediation,
     configDiagnostics,
     configRepairs,
     sdkDependency,
+    packageVersions,
     selfTest,
     warnings: options.keyFromArg
       ? ['Avoid --key in shared shells because command-line arguments can be visible in process listings. Prefer MARROW_API_KEY in your environment or secret manager.']
@@ -946,7 +1237,10 @@ module.exports = {
   runSelfTest,
   runCli,
   passiveRuntimeSource,
+  resolveMarrowKeyMaterial,
   inspectNpmTokenConfig,
   inspectSdkDependency,
+  inspectPackageVersions,
+  runDoctorValidation,
   buildInstallValueMoment,
 };