@mcmcjs/julia 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -22,7 +22,10 @@ var index_exports = {};
 __export(index_exports, {
   detectJulia: () => detectJulia,
   detectJuliaup: () => detectJuliaup,
-  runDoctor: () => runDoctor
+  juliaupInstallCommand: () => juliaupInstallCommand,
+  planSetup: () => planSetup,
+  runDoctor: () => runDoctor,
+  runSetup: () => runSetup
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -32,10 +35,16 @@ var import_node_os = require("os");
 var import_node_path = require("path");
 var import_node_util = require("util");
 var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
-var defaultRunner = async (command, args) => {
-  const { stdout } = await execFileAsync(command, args, { timeout: 1e4 });
-  return stdout;
-};
+function createRunner(timeoutMs = 1e4) {
+  return async (command, args) => {
+    const { stdout } = await execFileAsync(command, args, {
+      timeout: timeoutMs,
+      maxBuffer: 16 * 1024 * 1024
+    });
+    return stdout;
+  };
+}
+var defaultRunner = createRunner();
 function candidates(binary) {
   return [(0, import_node_path.join)((0, import_node_os.homedir)(), ".juliaup", "bin", binary), binary];
 }
@@ -62,10 +71,74 @@ async function runDoctor(runner) {
   const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);
   return { juliaup, julia, ready: julia.found };
 }
+
+// src/setup.ts
+var JULIAUP_INSTALL_URL = "https://install.julialang.org";
+function juliaupInstallCommand(platform) {
+  if (platform === "win32") {
+    return null;
+  }
+  return { command: "sh", args: ["-c", `curl -fsSL ${JULIAUP_INSTALL_URL} | sh -s -- --yes`] };
+}
+function planSetup(report, platform) {
+  if (report.julia.found) return [];
+  if (report.juliaup.found) {
+    return [
+      {
+        tool: "julia",
+        label: "install the latest stable Julia via juliaup",
+        command: { command: report.juliaup.path ?? "juliaup", args: ["add", "release"] }
+      }
+    ];
+  }
+  return [
+    {
+      tool: "juliaup",
+      label: "install juliaup (this also installs Julia)",
+      command: juliaupInstallCommand(platform)
+    }
+  ];
+}
+async function runSetup(options = {}) {
+  const {
+    runner,
+    installer = createRunner(15 * 6e4),
+    platform = process.platform,
+    dryRun = false
+  } = options;
+  const before = await runDoctor(runner);
+  if (before.ready) return { ...before, steps: [] };
+  const plan = planSetup(before, platform);
+  if (dryRun) {
+    return {
+      ...before,
+      steps: plan.map((step) => ({ ...step, status: step.command ? "skipped" : "unsupported" }))
+    };
+  }
+  const steps = [];
+  for (const step of plan) {
+    if (!step.command) {
+      steps.push({ ...step, status: "unsupported" });
+      continue;
+    }
+    try {
+      await installer(step.command.command, step.command.args);
+      steps.push({ ...step, status: "ran" });
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      steps.push({ ...step, status: "failed", detail });
+    }
+  }
+  const after = await runDoctor(runner);
+  return { juliaup: after.juliaup, julia: after.julia, ready: after.ready, steps };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   detectJulia,
   detectJuliaup,
-  runDoctor
+  juliaupInstallCommand,
+  planSetup,
+  runDoctor,
+  runSetup
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/environment.ts","../src/doctor.ts"],"sourcesContent":["export type { DoctorReport } from \"./doctor\";\nexport { runDoctor } from \"./doctor\";\nexport type { CommandRunner, ToolInfo } from \"./environment\";\nexport { detectJulia, detectJuliaup } from \"./environment\";\n","import { execFile } from \"node:child_process\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Information about a detected command-line tool. */\nexport interface ToolInfo {\n  found: boolean;\n  version?: string;\n  path?: string;\n}\n\n/** Runs a command and resolves its stdout. Injectable so detection is testable. */\nexport type CommandRunner = (command: string, args: string[]) => Promise<string>;\n\nconst defaultRunner: CommandRunner = async (command, args) => {\n  const { stdout } = await execFileAsync(command, args, { timeout: 10_000 });\n  return stdout;\n};\n\n// juliaup installs its shims here; we also fall back to whatever is on PATH.\nfunction candidates(binary: string): string[] {\n  return [join(homedir(), \".juliaup\", \"bin\", binary), binary];\n}\n\nasync function detect(\n  binary: string,\n  parseVersion: (stdout: string) => string | undefined,\n  runner: CommandRunner,\n): Promise<ToolInfo> {\n  for (const path of candidates(binary)) {\n    try {\n      const version = parseVersion(await runner(path, [\"--version\"]));\n      if (version) return { found: true, version, path };\n    } catch {\n      // not available at this path; try the next candidate\n    }\n  }\n  return { found: false };\n}\n\nconst versionNumber = (stdout: string): string | undefined => stdout.match(/(\\d+\\.\\d+\\.\\d+)/)?.[1];\n\n/** Detects the Julia runtime via `julia --version`. */\nexport function detectJulia(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"julia\", versionNumber, runner);\n}\n\n/** Detects the juliaup version manager via `juliaup --version`. */\nexport function detectJuliaup(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"juliaup\", versionNumber, runner);\n}\n","import { type CommandRunner, detectJulia, detectJuliaup, type ToolInfo } from \"./environment\";\n\n/** A summary of the Julia toolchain available for inference. */\nexport interface DoctorReport {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia itself is available (the minimum needed to run inference). */\n  ready: boolean;\n}\n\n/** Detects the installed Julia toolchain and reports whether inference can run. */\nexport async function runDoctor(runner?: CommandRunner): Promise<DoctorReport> {\n  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);\n  return { juliaup, julia, ready: julia.found };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,gCAAyB;AACzB,qBAAwB;AACxB,uBAAqB;AACrB,uBAA0B;AAE1B,IAAM,oBAAgB,4BAAU,kCAAQ;AAYxC,IAAM,gBAA+B,OAAO,SAAS,SAAS;AAC5D,QAAM,EAAE,OAAO,IAAI,MAAM,cAAc,SAAS,MAAM,EAAE,SAAS,IAAO,CAAC;AACzE,SAAO;AACT;AAGA,SAAS,WAAW,QAA0B;AAC5C,SAAO,KAAC,2BAAK,wBAAQ,GAAG,YAAY,OAAO,MAAM,GAAG,MAAM;AAC5D;AAEA,eAAe,OACb,QACA,cACA,QACmB;AACnB,aAAW,QAAQ,WAAW,MAAM,GAAG;AACrC,QAAI;AACF,YAAM,UAAU,aAAa,MAAM,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC9D,UAAI,QAAS,QAAO,EAAE,OAAO,MAAM,SAAS,KAAK;AAAA,IACnD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,EAAE,OAAO,MAAM;AACxB;AAEA,IAAM,gBAAgB,CAAC,WAAuC,OAAO,MAAM,iBAAiB,IAAI,CAAC;AAG1F,SAAS,YAAY,SAAwB,eAAkC;AACpF,SAAO,OAAO,SAAS,eAAe,MAAM;AAC9C;AAGO,SAAS,cAAc,SAAwB,eAAkC;AACtF,SAAO,OAAO,WAAW,eAAe,MAAM;AAChD;;;AC1CA,eAAsB,UAAU,QAA+C;AAC7E,QAAM,CAAC,SAAS,KAAK,IAAI,MAAM,QAAQ,IAAI,CAAC,cAAc,MAAM,GAAG,YAAY,MAAM,CAAC,CAAC;AACvF,SAAO,EAAE,SAAS,OAAO,OAAO,MAAM,MAAM;AAC9C;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/environment.ts","../src/doctor.ts","../src/setup.ts"],"sourcesContent":["export type { DoctorReport } from \"./doctor\";\nexport { runDoctor } from \"./doctor\";\nexport type { CommandRunner, ToolInfo } from \"./environment\";\nexport { detectJulia, detectJuliaup } from \"./environment\";\nexport type {\n  InstallCommand,\n  SetupOptions,\n  SetupResult,\n  SetupStep,\n  SetupStepResult,\n  StepStatus,\n} from \"./setup\";\nexport { juliaupInstallCommand, planSetup, runSetup } from \"./setup\";\n","import { execFile } from \"node:child_process\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Information about a detected command-line tool. */\nexport interface ToolInfo {\n  found: boolean;\n  version?: string;\n  path?: string;\n}\n\n/** Runs a command and resolves its stdout. Injectable so detection is testable. */\nexport type CommandRunner = (command: string, args: string[]) => Promise<string>;\n\n/** Creates a runner backed by execFile with the given timeout in milliseconds. */\nexport function createRunner(timeoutMs = 10_000): CommandRunner {\n  return async (command, args) => {\n    const { stdout } = await execFileAsync(command, args, {\n      timeout: timeoutMs,\n      maxBuffer: 16 * 1024 * 1024,\n    });\n    return stdout;\n  };\n}\n\nconst defaultRunner = createRunner();\n\n// juliaup installs its shims here; we also fall back to whatever is on PATH.\nfunction candidates(binary: string): string[] {\n  return [join(homedir(), \".juliaup\", \"bin\", binary), binary];\n}\n\nasync function detect(\n  binary: string,\n  parseVersion: (stdout: string) => string | undefined,\n  runner: CommandRunner,\n): Promise<ToolInfo> {\n  for (const path of candidates(binary)) {\n    try {\n      const version = parseVersion(await runner(path, [\"--version\"]));\n      if (version) return { found: true, version, path };\n    } catch {\n      // not available at this path; try the next candidate\n    }\n  }\n  return { found: false };\n}\n\nconst versionNumber = (stdout: string): string | undefined => stdout.match(/(\\d+\\.\\d+\\.\\d+)/)?.[1];\n\n/** Detects the Julia runtime via `julia --version`. */\nexport function detectJulia(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"julia\", versionNumber, runner);\n}\n\n/** Detects the juliaup version manager via `juliaup --version`. */\nexport function detectJuliaup(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"juliaup\", versionNumber, runner);\n}\n","import { type CommandRunner, detectJulia, detectJuliaup, type ToolInfo } from \"./environment\";\n\n/** A summary of the Julia toolchain available for inference. */\nexport interface DoctorReport {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia itself is available (the minimum needed to run inference). */\n  ready: boolean;\n}\n\n/** Detects the installed Julia toolchain and reports whether inference can run. */\nexport async function runDoctor(runner?: CommandRunner): Promise<DoctorReport> {\n  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);\n  return { juliaup, julia, ready: julia.found };\n}\n","import { type DoctorReport, runDoctor } from \"./doctor\";\nimport { type CommandRunner, createRunner, type ToolInfo } from \"./environment\";\n\n/** The official juliaup install script, piped to a shell by the install step. */\nconst JULIAUP_INSTALL_URL = \"https://install.julialang.org\";\n\n/** An executable and its arguments, run directly (no shell word-splitting). */\nexport interface InstallCommand {\n  command: string;\n  args: string[];\n}\n\n/**\n * The command that installs juliaup on the given platform, or null when\n * automatic install is not yet supported there.\n */\nexport function juliaupInstallCommand(platform: NodeJS.Platform): InstallCommand | null {\n  if (platform === \"win32\") {\n    // TODO: install juliaup on Windows via winget or the Microsoft Store.\n    return null;\n  }\n  return { command: \"sh\", args: [\"-c\", `curl -fsSL ${JULIAUP_INSTALL_URL} | sh -s -- --yes`] };\n}\n\n/** A single provisioning step needed to make the toolchain ready. */\nexport interface SetupStep {\n  tool: \"juliaup\" | \"julia\";\n  /** A short description of what the step does. */\n  label: string;\n  /** The command to run, or null when the step cannot be performed automatically. */\n  command: InstallCommand | null;\n}\n\n/** The ordered steps needed to reach a ready toolchain, given the current state. */\nexport function planSetup(report: DoctorReport, platform: NodeJS.Platform): SetupStep[] {\n  if (report.julia.found) return [];\n  if (report.juliaup.found) {\n    return [\n      {\n        tool: \"julia\",\n        label: \"install the latest stable Julia via juliaup\",\n        command: { command: report.juliaup.path ?? \"juliaup\", args: [\"add\", \"release\"] },\n      },\n    ];\n  }\n  return [\n    {\n      tool: \"juliaup\",\n      label: \"install juliaup (this also installs Julia)\",\n      command: juliaupInstallCommand(platform),\n    },\n  ];\n}\n\nexport type StepStatus = \"ran\" | \"skipped\" | \"failed\" | \"unsupported\";\n\nexport interface SetupStepResult extends SetupStep {\n  status: StepStatus;\n  /** Error detail when the step failed. */\n  detail?: string;\n}\n\nexport interface SetupResult {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia is available after setup. */\n  ready: boolean;\n  steps: SetupStepResult[];\n}\n\nexport interface SetupOptions {\n  /** Runs detection commands. Injectable for tests. */\n  runner?: CommandRunner;\n  /** Runs install steps, which may take several minutes. Injectable for tests. */\n  installer?: CommandRunner;\n  /** Target platform; defaults to the current process platform. */\n  platform?: NodeJS.Platform;\n  /** Plan the steps but do not run them. */\n  dryRun?: boolean;\n}\n\n/** Installs the Julia toolchain (juliaup and Julia) needed for inference. */\nexport async function runSetup(options: SetupOptions = {}): Promise<SetupResult> {\n  const {\n    runner,\n    installer = createRunner(15 * 60_000),\n    platform = process.platform,\n    dryRun = false,\n  } = options;\n\n  const before = await runDoctor(runner);\n  if (before.ready) return { ...before, steps: [] };\n\n  const plan = planSetup(before, platform);\n\n  if (dryRun) {\n    return {\n      ...before,\n      steps: plan.map((step) => ({ ...step, status: step.command ? \"skipped\" : \"unsupported\" })),\n    };\n  }\n\n  const steps: SetupStepResult[] = [];\n  for (const step of plan) {\n    if (!step.command) {\n      steps.push({ ...step, status: \"unsupported\" });\n      continue;\n    }\n    try {\n      await installer(step.command.command, step.command.args);\n      steps.push({ ...step, status: \"ran\" });\n    } catch (error) {\n      const detail = error instanceof Error ? error.message : String(error);\n      steps.push({ ...step, status: \"failed\", detail });\n    }\n  }\n\n  const after = await runDoctor(runner);\n  return { juliaup: after.juliaup, julia: after.julia, ready: after.ready, steps };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -21,4 +21,50 @@ interface DoctorReport {
 /** Detects the installed Julia toolchain and reports whether inference can run. */
 declare function runDoctor(runner?: CommandRunner): Promise<DoctorReport>;
 
-export { type CommandRunner, type DoctorReport, type ToolInfo, detectJulia, detectJuliaup, runDoctor };
+/** An executable and its arguments, run directly (no shell word-splitting). */
+interface InstallCommand {
+    command: string;
+    args: string[];
+}
+/**
+ * The command that installs juliaup on the given platform, or null when
+ * automatic install is not yet supported there.
+ */
+declare function juliaupInstallCommand(platform: NodeJS.Platform): InstallCommand | null;
+/** A single provisioning step needed to make the toolchain ready. */
+interface SetupStep {
+    tool: "juliaup" | "julia";
+    /** A short description of what the step does. */
+    label: string;
+    /** The command to run, or null when the step cannot be performed automatically. */
+    command: InstallCommand | null;
+}
+/** The ordered steps needed to reach a ready toolchain, given the current state. */
+declare function planSetup(report: DoctorReport, platform: NodeJS.Platform): SetupStep[];
+type StepStatus = "ran" | "skipped" | "failed" | "unsupported";
+interface SetupStepResult extends SetupStep {
+    status: StepStatus;
+    /** Error detail when the step failed. */
+    detail?: string;
+}
+interface SetupResult {
+    juliaup: ToolInfo;
+    julia: ToolInfo;
+    /** True when Julia is available after setup. */
+    ready: boolean;
+    steps: SetupStepResult[];
+}
+interface SetupOptions {
+    /** Runs detection commands. Injectable for tests. */
+    runner?: CommandRunner;
+    /** Runs install steps, which may take several minutes. Injectable for tests. */
+    installer?: CommandRunner;
+    /** Target platform; defaults to the current process platform. */
+    platform?: NodeJS.Platform;
+    /** Plan the steps but do not run them. */
+    dryRun?: boolean;
+}
+/** Installs the Julia toolchain (juliaup and Julia) needed for inference. */
+declare function runSetup(options?: SetupOptions): Promise<SetupResult>;
+
+export { type CommandRunner, type DoctorReport, type InstallCommand, type SetupOptions, type SetupResult, type SetupStep, type SetupStepResult, type StepStatus, type ToolInfo, detectJulia, detectJuliaup, juliaupInstallCommand, planSetup, runDoctor, runSetup };

package/dist/index.d.ts

@@ -21,4 +21,50 @@ interface DoctorReport {
 /** Detects the installed Julia toolchain and reports whether inference can run. */
 declare function runDoctor(runner?: CommandRunner): Promise<DoctorReport>;
 
-export { type CommandRunner, type DoctorReport, type ToolInfo, detectJulia, detectJuliaup, runDoctor };
+/** An executable and its arguments, run directly (no shell word-splitting). */
+interface InstallCommand {
+    command: string;
+    args: string[];
+}
+/**
+ * The command that installs juliaup on the given platform, or null when
+ * automatic install is not yet supported there.
+ */
+declare function juliaupInstallCommand(platform: NodeJS.Platform): InstallCommand | null;
+/** A single provisioning step needed to make the toolchain ready. */
+interface SetupStep {
+    tool: "juliaup" | "julia";
+    /** A short description of what the step does. */
+    label: string;
+    /** The command to run, or null when the step cannot be performed automatically. */
+    command: InstallCommand | null;
+}
+/** The ordered steps needed to reach a ready toolchain, given the current state. */
+declare function planSetup(report: DoctorReport, platform: NodeJS.Platform): SetupStep[];
+type StepStatus = "ran" | "skipped" | "failed" | "unsupported";
+interface SetupStepResult extends SetupStep {
+    status: StepStatus;
+    /** Error detail when the step failed. */
+    detail?: string;
+}
+interface SetupResult {
+    juliaup: ToolInfo;
+    julia: ToolInfo;
+    /** True when Julia is available after setup. */
+    ready: boolean;
+    steps: SetupStepResult[];
+}
+interface SetupOptions {
+    /** Runs detection commands. Injectable for tests. */
+    runner?: CommandRunner;
+    /** Runs install steps, which may take several minutes. Injectable for tests. */
+    installer?: CommandRunner;
+    /** Target platform; defaults to the current process platform. */
+    platform?: NodeJS.Platform;
+    /** Plan the steps but do not run them. */
+    dryRun?: boolean;
+}
+/** Installs the Julia toolchain (juliaup and Julia) needed for inference. */
+declare function runSetup(options?: SetupOptions): Promise<SetupResult>;
+
+export { type CommandRunner, type DoctorReport, type InstallCommand, type SetupOptions, type SetupResult, type SetupStep, type SetupStepResult, type StepStatus, type ToolInfo, detectJulia, detectJuliaup, juliaupInstallCommand, planSetup, runDoctor, runSetup };

package/dist/index.js

@@ -4,10 +4,16 @@ import { homedir } from "os";
 import { join } from "path";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
-var defaultRunner = async (command, args) => {
-  const { stdout } = await execFileAsync(command, args, { timeout: 1e4 });
-  return stdout;
-};
+function createRunner(timeoutMs = 1e4) {
+  return async (command, args) => {
+    const { stdout } = await execFileAsync(command, args, {
+      timeout: timeoutMs,
+      maxBuffer: 16 * 1024 * 1024
+    });
+    return stdout;
+  };
+}
+var defaultRunner = createRunner();
 function candidates(binary) {
   return [join(homedir(), ".juliaup", "bin", binary), binary];
 }
@@ -34,9 +40,73 @@ async function runDoctor(runner) {
   const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);
   return { juliaup, julia, ready: julia.found };
 }
+
+// src/setup.ts
+var JULIAUP_INSTALL_URL = "https://install.julialang.org";
+function juliaupInstallCommand(platform) {
+  if (platform === "win32") {
+    return null;
+  }
+  return { command: "sh", args: ["-c", `curl -fsSL ${JULIAUP_INSTALL_URL} | sh -s -- --yes`] };
+}
+function planSetup(report, platform) {
+  if (report.julia.found) return [];
+  if (report.juliaup.found) {
+    return [
+      {
+        tool: "julia",
+        label: "install the latest stable Julia via juliaup",
+        command: { command: report.juliaup.path ?? "juliaup", args: ["add", "release"] }
+      }
+    ];
+  }
+  return [
+    {
+      tool: "juliaup",
+      label: "install juliaup (this also installs Julia)",
+      command: juliaupInstallCommand(platform)
+    }
+  ];
+}
+async function runSetup(options = {}) {
+  const {
+    runner,
+    installer = createRunner(15 * 6e4),
+    platform = process.platform,
+    dryRun = false
+  } = options;
+  const before = await runDoctor(runner);
+  if (before.ready) return { ...before, steps: [] };
+  const plan = planSetup(before, platform);
+  if (dryRun) {
+    return {
+      ...before,
+      steps: plan.map((step) => ({ ...step, status: step.command ? "skipped" : "unsupported" }))
+    };
+  }
+  const steps = [];
+  for (const step of plan) {
+    if (!step.command) {
+      steps.push({ ...step, status: "unsupported" });
+      continue;
+    }
+    try {
+      await installer(step.command.command, step.command.args);
+      steps.push({ ...step, status: "ran" });
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      steps.push({ ...step, status: "failed", detail });
+    }
+  }
+  const after = await runDoctor(runner);
+  return { juliaup: after.juliaup, julia: after.julia, ready: after.ready, steps };
+}
 export {
   detectJulia,
   detectJuliaup,
-  runDoctor
+  juliaupInstallCommand,
+  planSetup,
+  runDoctor,
+  runSetup
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/environment.ts","../src/doctor.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Information about a detected command-line tool. */\nexport interface ToolInfo {\n  found: boolean;\n  version?: string;\n  path?: string;\n}\n\n/** Runs a command and resolves its stdout. Injectable so detection is testable. */\nexport type CommandRunner = (command: string, args: string[]) => Promise<string>;\n\nconst defaultRunner: CommandRunner = async (command, args) => {\n  const { stdout } = await execFileAsync(command, args, { timeout: 10_000 });\n  return stdout;\n};\n\n// juliaup installs its shims here; we also fall back to whatever is on PATH.\nfunction candidates(binary: string): string[] {\n  return [join(homedir(), \".juliaup\", \"bin\", binary), binary];\n}\n\nasync function detect(\n  binary: string,\n  parseVersion: (stdout: string) => string | undefined,\n  runner: CommandRunner,\n): Promise<ToolInfo> {\n  for (const path of candidates(binary)) {\n    try {\n      const version = parseVersion(await runner(path, [\"--version\"]));\n      if (version) return { found: true, version, path };\n    } catch {\n      // not available at this path; try the next candidate\n    }\n  }\n  return { found: false };\n}\n\nconst versionNumber = (stdout: string): string | undefined => stdout.match(/(\\d+\\.\\d+\\.\\d+)/)?.[1];\n\n/** Detects the Julia runtime via `julia --version`. */\nexport function detectJulia(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"julia\", versionNumber, runner);\n}\n\n/** Detects the juliaup version manager via `juliaup --version`. */\nexport function detectJuliaup(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"juliaup\", versionNumber, runner);\n}\n","import { type CommandRunner, detectJulia, detectJuliaup, type ToolInfo } from \"./environment\";\n\n/** A summary of the Julia toolchain available for inference. */\nexport interface DoctorReport {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia itself is available (the minimum needed to run inference). */\n  ready: boolean;\n}\n\n/** Detects the installed Julia toolchain and reports whether inference can run. */\nexport async function runDoctor(runner?: CommandRunner): Promise<DoctorReport> {\n  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);\n  return { juliaup, julia, ready: julia.found };\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAE1B,IAAM,gBAAgB,UAAU,QAAQ;AAYxC,IAAM,gBAA+B,OAAO,SAAS,SAAS;AAC5D,QAAM,EAAE,OAAO,IAAI,MAAM,cAAc,SAAS,MAAM,EAAE,SAAS,IAAO,CAAC;AACzE,SAAO;AACT;AAGA,SAAS,WAAW,QAA0B;AAC5C,SAAO,CAAC,KAAK,QAAQ,GAAG,YAAY,OAAO,MAAM,GAAG,MAAM;AAC5D;AAEA,eAAe,OACb,QACA,cACA,QACmB;AACnB,aAAW,QAAQ,WAAW,MAAM,GAAG;AACrC,QAAI;AACF,YAAM,UAAU,aAAa,MAAM,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC9D,UAAI,QAAS,QAAO,EAAE,OAAO,MAAM,SAAS,KAAK;AAAA,IACnD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,EAAE,OAAO,MAAM;AACxB;AAEA,IAAM,gBAAgB,CAAC,WAAuC,OAAO,MAAM,iBAAiB,IAAI,CAAC;AAG1F,SAAS,YAAY,SAAwB,eAAkC;AACpF,SAAO,OAAO,SAAS,eAAe,MAAM;AAC9C;AAGO,SAAS,cAAc,SAAwB,eAAkC;AACtF,SAAO,OAAO,WAAW,eAAe,MAAM;AAChD;;;AC1CA,eAAsB,UAAU,QAA+C;AAC7E,QAAM,CAAC,SAAS,KAAK,IAAI,MAAM,QAAQ,IAAI,CAAC,cAAc,MAAM,GAAG,YAAY,MAAM,CAAC,CAAC;AACvF,SAAO,EAAE,SAAS,OAAO,OAAO,MAAM,MAAM;AAC9C;","names":[]}
+{"version":3,"sources":["../src/environment.ts","../src/doctor.ts","../src/setup.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Information about a detected command-line tool. */\nexport interface ToolInfo {\n  found: boolean;\n  version?: string;\n  path?: string;\n}\n\n/** Runs a command and resolves its stdout. Injectable so detection is testable. */\nexport type CommandRunner = (command: string, args: string[]) => Promise<string>;\n\n/** Creates a runner backed by execFile with the given timeout in milliseconds. */\nexport function createRunner(timeoutMs = 10_000): CommandRunner {\n  return async (command, args) => {\n    const { stdout } = await execFileAsync(command, args, {\n      timeout: timeoutMs,\n      maxBuffer: 16 * 1024 * 1024,\n    });\n    return stdout;\n  };\n}\n\nconst defaultRunner = createRunner();\n\n// juliaup installs its shims here; we also fall back to whatever is on PATH.\nfunction candidates(binary: string): string[] {\n  return [join(homedir(), \".juliaup\", \"bin\", binary), binary];\n}\n\nasync function detect(\n  binary: string,\n  parseVersion: (stdout: string) => string | undefined,\n  runner: CommandRunner,\n): Promise<ToolInfo> {\n  for (const path of candidates(binary)) {\n    try {\n      const version = parseVersion(await runner(path, [\"--version\"]));\n      if (version) return { found: true, version, path };\n    } catch {\n      // not available at this path; try the next candidate\n    }\n  }\n  return { found: false };\n}\n\nconst versionNumber = (stdout: string): string | undefined => stdout.match(/(\\d+\\.\\d+\\.\\d+)/)?.[1];\n\n/** Detects the Julia runtime via `julia --version`. */\nexport function detectJulia(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"julia\", versionNumber, runner);\n}\n\n/** Detects the juliaup version manager via `juliaup --version`. */\nexport function detectJuliaup(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"juliaup\", versionNumber, runner);\n}\n","import { type CommandRunner, detectJulia, detectJuliaup, type ToolInfo } from \"./environment\";\n\n/** A summary of the Julia toolchain available for inference. */\nexport interface DoctorReport {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia itself is available (the minimum needed to run inference). */\n  ready: boolean;\n}\n\n/** Detects the installed Julia toolchain and reports whether inference can run. */\nexport async function runDoctor(runner?: CommandRunner): Promise<DoctorReport> {\n  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);\n  return { juliaup, julia, ready: julia.found };\n}\n","import { type DoctorReport, runDoctor } from \"./doctor\";\nimport { type CommandRunner, createRunner, type ToolInfo } from \"./environment\";\n\n/** The official juliaup install script, piped to a shell by the install step. */\nconst JULIAUP_INSTALL_URL = \"https://install.julialang.org\";\n\n/** An executable and its arguments, run directly (no shell word-splitting). */\nexport interface InstallCommand {\n  command: string;\n  args: string[];\n}\n\n/**\n * The command that installs juliaup on the given platform, or null when\n * automatic install is not yet supported there.\n */\nexport function juliaupInstallCommand(platform: NodeJS.Platform): InstallCommand | null {\n  if (platform === \"win32\") {\n    // TODO: install juliaup on Windows via winget or the Microsoft Store.\n    return null;\n  }\n  return { command: \"sh\", args: [\"-c\", `curl -fsSL ${JULIAUP_INSTALL_URL} | sh -s -- --yes`] };\n}\n\n/** A single provisioning step needed to make the toolchain ready. */\nexport interface SetupStep {\n  tool: \"juliaup\" | \"julia\";\n  /** A short description of what the step does. */\n  label: string;\n  /** The command to run, or null when the step cannot be performed automatically. */\n  command: InstallCommand | null;\n}\n\n/** The ordered steps needed to reach a ready toolchain, given the current state. */\nexport function planSetup(report: DoctorReport, platform: NodeJS.Platform): SetupStep[] {\n  if (report.julia.found) return [];\n  if (report.juliaup.found) {\n    return [\n      {\n        tool: \"julia\",\n        label: \"install the latest stable Julia via juliaup\",\n        command: { command: report.juliaup.path ?? \"juliaup\", args: [\"add\", \"release\"] },\n      },\n    ];\n  }\n  return [\n    {\n      tool: \"juliaup\",\n      label: \"install juliaup (this also installs Julia)\",\n      command: juliaupInstallCommand(platform),\n    },\n  ];\n}\n\nexport type StepStatus = \"ran\" | \"skipped\" | \"failed\" | \"unsupported\";\n\nexport interface SetupStepResult extends SetupStep {\n  status: StepStatus;\n  /** Error detail when the step failed. */\n  detail?: string;\n}\n\nexport interface SetupResult {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia is available after setup. */\n  ready: boolean;\n  steps: SetupStepResult[];\n}\n\nexport interface SetupOptions {\n  /** Runs detection commands. Injectable for tests. */\n  runner?: CommandRunner;\n  /** Runs install steps, which may take several minutes. Injectable for tests. */\n  installer?: CommandRunner;\n  /** Target platform; defaults to the current process platform. */\n  platform?: NodeJS.Platform;\n  /** Plan the steps but do not run them. */\n  dryRun?: boolean;\n}\n\n/** Installs the Julia toolchain (juliaup and Julia) needed for inference. */\nexport async function runSetup(options: SetupOptions = {}): Promise<SetupResult> {\n  const {\n    runner,\n    installer = createRunner(15 * 60_000),\n    platform = process.platform,\n    dryRun = false,\n  } = options;\n\n  const before = await runDoctor(runner);\n  if (before.ready) return { ...before, steps: [] };\n\n  const plan = planSetup(before, platform);\n\n  if (dryRun) {\n    return {\n      ...before,\n      steps: plan.map((step) => ({ ...step, status: step.command ? \"skipped\" : \"unsupported\" })),\n    };\n  }\n\n  const steps: SetupStepResult[] = [];\n  for (const step of plan) {\n    if (!step.command) {\n      steps.push({ ...step, status: \"unsupported\" });\n      continue;\n    }\n    try {\n      await installer(step.command.command, step.command.args);\n      steps.push({ ...step, status: \"ran\" });\n    } catch (error) {\n      const detail = error instanceof Error ? error.message : String(error);\n      steps.push({ ...step, status: \"failed\", detail });\n    }\n  }\n\n  const after = await runDoctor(runner);\n  return { juliaup: after.juliaup, julia: after.julia, ready: after.ready, steps };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcmcjs/julia",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Julia toolchain detection and the inference runner for MCMC.js.",
   "keywords": [
     "mcmc",