argsbarg 3.6.4 → 4.0.0

package/src/invoke.ts

@@ -1,217 +0,0 @@
-/*
-This module invokes leaf CLI handlers without exiting the process.
-It parses argv against the user schema, captures stdout/stderr, and patches
-process.exit so MCP tool calls can run handlers repeatedly.
-*/
-
-import { format } from "node:util";
-import { builtinInterceptRoot, dispatchBuiltin } from "./builtins/dispatch.ts";
-import { cliParseRoot, cliPresentationRoot } from "./builtins/presentation.ts";
-import { CliContext } from "./context.ts";
-import { ParseKind, parse, postParseValidate } from "./parse.ts";
-import { type CliNode, type CliProgram, type CliRouter, isCliLeaf, isCliRouter } from "./types.ts";
-
-/** Outcome of a non-exiting CLI invocation. */
-export type CliInvokeKind = "ok" | "help" | "error";
-
-/** Result of cliInvoke: captured output and exit metadata without process.exit. */
-export interface CliInvokeResult {
-  /** Invocation outcome. */
-  kind: CliInvokeKind;
-  /** Simulated exit code. */
-  exitCode: number;
-  /** Captured stdout during handler execution. */
-  stdout: string;
-  /** Captured stderr during handler execution. */
-  stderr: string;
-  /** Set when kind === "error" (parse/validation message). */
-  errorMsg?: string;
-}
-
-/** Thrown internally when a patched process.exit fires during handler execution. */
-class CliInvokeExit extends Error {
-  /** Exit code passed to process.exit. */
-  readonly code: number;
-
-  /** Creates an exit signal with the given status code. */
-  constructor(code: number) {
-    super(`process.exit(${code})`);
-    this.name = "CliInvokeExit";
-    this.code = code;
-  }
-}
-
-/** Looks up a subcommand or routing node by `key`. */
-function findChild(cmds: CliNode[], name: string): CliNode | undefined {
-  return cmds.find((c) => c.key === name);
-}
-
-/**
- * Parses argv against the user root, runs the leaf handler, and returns captured output.
- * Never calls process.exit.
- */
-export async function cliInvoke(root: CliProgram, argv: string[]): Promise<CliInvokeResult> {
-  let parseRoot: CliNode = root;
-  let completionParseRoot: CliRouter = cliPresentationRoot(root);
-  let isLeafCompletionIntercept = false;
-
-  if (isCliLeaf(root)) {
-    const intercept = builtinInterceptRoot(root, argv);
-    if (intercept.isLeafCompletionIntercept || intercept.parseRoot !== root) {
-      parseRoot = intercept.parseRoot;
-      completionParseRoot = isCliRouter(intercept.parseRoot)
-        ? intercept.parseRoot
-        : cliPresentationRoot(root);
-      isLeafCompletionIntercept = intercept.isLeafCompletionIntercept;
-    }
-  } else {
-    parseRoot = cliParseRoot(root);
-  }
-
-  let pr = parse(parseRoot, argv);
-  pr = postParseValidate(parseRoot, pr);
-
-  if (pr.kind === ParseKind.Help) {
-    return {
-      kind: "help",
-      exitCode: 1,
-      stdout: "",
-      stderr: "",
-      errorMsg: "Help is not available via MCP tool calls.",
-    };
-  }
-
-  if (pr.kind === ParseKind.Error) {
-    return {
-      kind: "error",
-      exitCode: 1,
-      stdout: "",
-      stderr: pr.errorMsg,
-      errorMsg: pr.errorMsg,
-    };
-  }
-
-  let current: CliNode = parseRoot;
-  for (const seg of pr.path) {
-    if (!isCliRouter(current)) {
-      return {
-        kind: "error",
-        exitCode: 1,
-        stdout: "",
-        stderr: "Internal error: missing handler for path.",
-        errorMsg: "Internal error: missing handler for path.",
-      };
-    }
-    const ch = findChild(current.commands, seg);
-    if (!ch) {
-      return {
-        kind: "error",
-        exitCode: 1,
-        stdout: "",
-        stderr: "Internal error: missing handler for path.",
-        errorMsg: "Internal error: missing handler for path.",
-      };
-    }
-    current = ch;
-  }
-
-  if (!("handler" in current) || !current.handler) {
-    return {
-      kind: "error",
-      exitCode: 1,
-      stdout: "",
-      stderr: "Internal error: missing handler for path.",
-      errorMsg: "Internal error: missing handler for path.",
-    };
-  }
-
-  const handler = current.handler;
-  const ctx = new CliContext(root.key, pr.path, pr.args, pr.opts, root, "mcp");
-
-  let stdout = "";
-  let stderr = "";
-  const origExit = process.exit;
-  const origStdoutWrite = process.stdout.write.bind(process.stdout);
-  const origStderrWrite = process.stderr.write.bind(process.stderr);
-  const origConsoleLog = console.log;
-  const origConsoleError = console.error;
-  const origConsoleInfo = console.info;
-  const origConsoleWarn = console.warn;
-
-  process.exit = ((code?: number) => {
-    throw new CliInvokeExit(code ?? 0);
-  }) as typeof process.exit;
-
-  process.stdout.write = ((chunk: string | Uint8Array, ...args: unknown[]) => {
-    stdout += typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk);
-    if (typeof args[0] === "function") {
-      (args[0] as () => void)();
-    }
-    return true;
-  }) as typeof process.stdout.write;
-
-  process.stderr.write = ((chunk: string | Uint8Array, ...args: unknown[]) => {
-    stderr += typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk);
-    if (typeof args[0] === "function") {
-      (args[0] as () => void)();
-    }
-    return true;
-  }) as typeof process.stderr.write;
-
-  console.log = (...args: unknown[]) => {
-    stdout += `${format(...args)}\n`;
-  };
-  console.info = (...args: unknown[]) => {
-    stdout += `${format(...args)}\n`;
-  };
-  console.warn = (...args: unknown[]) => {
-    stderr += `${format(...args)}\n`;
-  };
-  console.error = (...args: unknown[]) => {
-    stderr += `${format(...args)}\n`;
-  };
-
-  try {
-    if (pr.kind === ParseKind.Ok) {
-      await dispatchBuiltin(root, pr, {
-        isLeafCompletionIntercept,
-        parseRoot: completionParseRoot,
-      });
-    }
-
-    await Promise.resolve(handler(ctx));
-    return { kind: "ok", exitCode: 0, stdout, stderr };
-  } catch (err) {
-    if (err instanceof CliInvokeExit) {
-      if (err.code === 0) {
-        return { kind: "ok", exitCode: 0, stdout, stderr };
-      }
-      const msg = stderr.trim() || `Exit code ${err.code}`;
-      return { kind: "error", exitCode: err.code, stdout, stderr, errorMsg: msg };
-    }
-    if (err instanceof Error) {
-      return {
-        kind: "error",
-        exitCode: 1,
-        stdout,
-        stderr: `${err.message}\n`,
-        errorMsg: err.message,
-      };
-    }
-    return {
-      kind: "error",
-      exitCode: 1,
-      stdout,
-      stderr: "Unknown error\n",
-      errorMsg: "Unknown error",
-    };
-  } finally {
-    process.exit = origExit;
-    process.stdout.write = origStdoutWrite;
-    process.stderr.write = origStderrWrite;
-    console.log = origConsoleLog;
-    console.error = origConsoleError;
-    console.info = origConsoleInfo;
-    console.warn = origConsoleWarn;
-  }
-}

package/src/mcp.ts

@@ -1,28 +0,0 @@
-/*
-This module starts the ArgsBarg MCP stdio server for opt-in program roots.
-*/
-
-import { bootstrapMcpEnv } from "./mcp/env.ts";
-import { mcpServeStdioLoop } from "./mcp/server.ts";
-import type { CliProgram } from "./types.ts";
-
-/**
- * Runs the MCP JSON-RPC server on stdin/stdout until stdin closes, then exits.
- * Caller must ensure `root.mcpServer` is set.
- */
-export async function cliMcpServeStdio(root: CliProgram): Promise<never> {
-  try {
-    if (root.mcpServer) {
-      bootstrapMcpEnv(root.mcpServer);
-    }
-    await mcpServeStdioLoop(root);
-    process.exit(0);
-  } catch (err) {
-    if (err instanceof Error) {
-      process.stderr.write(`${err.message}\n`);
-    } else {
-      process.stderr.write("MCP server error.\n");
-    }
-    process.exit(1);
-  }
-}

package/src/runtime.ts

@@ -1,134 +0,0 @@
-/*
-This module runs parsed commands, help, errors, completion, and leaf handlers.
-*/
-
-import { builtinInterceptRoot, dispatchBuiltin } from "./builtins/dispatch.ts";
-import { cliParseRoot, cliPresentationRoot } from "./builtins/presentation.ts";
-import { resolveCapabilities } from "./capabilities.ts";
-import { CliContext } from "./context.ts";
-import { cliHelpRender } from "./help.ts";
-import { ParseKind, parse, postParseValidate } from "./parse.ts";
-import type { CliRouter } from "./types.ts";
-import { type CliNode, type CliProgram, isCliLeaf, isCliRouter } from "./types.ts";
-import { cliValidateProgram } from "./validate.ts";
-
-function cliRootMergedWithBuiltins(program: CliProgram): CliRouter {
-  return cliParseRoot(program);
-}
-
-export async function cliRun(
-  program: CliProgram,
-  argv: string[] = process.argv.slice(2),
-): Promise<never> {
-  try {
-    cliValidateProgram(program);
-  } catch (err) {
-    if (err instanceof Error) {
-      process.stderr.write(`${err.message}\n`);
-    } else {
-      process.stderr.write("Invalid CLI definition.\n");
-    }
-    process.exit(1);
-  }
-
-  const caps = resolveCapabilities(program);
-
-  if (argv.length >= 1 && argv[0] === "mcp" && !caps.mcp) {
-    process.stderr.write(
-      "MCP is not enabled. Set mcpServer: { enabled: true } on the program root.\n",
-    );
-    process.exit(1);
-  }
-
-  if (argv.length >= 1 && argv[0] === "install" && !caps.install) {
-    process.stderr.write(
-      "install is disabled. Remove install.enabled: false from the program root.\n",
-    );
-    process.exit(1);
-  }
-
-  if (argv.length >= 1 && argv[0] === "docs" && !caps.docs) {
-    process.stderr.write("docs is not enabled. Set docs: { enabled: true } on the program root.\n");
-    process.exit(1);
-  }
-
-  let parseRoot: CliNode;
-  let completionParseRoot: CliRouter = cliRootMergedWithBuiltins(program);
-  let isLeafCompletionIntercept = false;
-
-  if (isCliLeaf(program)) {
-    const intercept = builtinInterceptRoot(program, argv);
-    if (intercept.isLeafCompletionIntercept || intercept.parseRoot !== program) {
-      parseRoot = intercept.parseRoot;
-      completionParseRoot = isCliRouter(intercept.parseRoot)
-        ? intercept.parseRoot
-        : cliRootMergedWithBuiltins(program);
-      isLeafCompletionIntercept = intercept.isLeafCompletionIntercept;
-    } else {
-      parseRoot = program;
-    }
-  } else {
-    parseRoot = cliRootMergedWithBuiltins(program);
-  }
-
-  let pr = parse(parseRoot, argv);
-  pr = postParseValidate(parseRoot, pr);
-
-  if (pr.kind === ParseKind.Help) {
-    process.stdout.write(cliHelpRender(cliParseRoot(program), pr.helpPath, false));
-    process.exit(pr.helpExplicit ? 0 : 1);
-  }
-
-  if (pr.kind === "error") {
-    const color = process.stderr.isTTY;
-    const msg = color ? `\u001B[31m${pr.errorMsg}\u001B[0m` : pr.errorMsg;
-    process.stderr.write(`${msg}\n`);
-    process.stderr.write(cliHelpRender(cliPresentationRoot(program), pr.errorHelpPath, true));
-    process.exit(1);
-  }
-
-  if (pr.kind === ParseKind.Ok) {
-    await dispatchBuiltin(program, pr, {
-      isLeafCompletionIntercept,
-      parseRoot: completionParseRoot,
-    });
-  }
-
-  let current: CliNode = parseRoot;
-  for (const seg of pr.path) {
-    if (!isCliRouter(current)) {
-      process.stderr.write("Internal error: missing handler for path.\n");
-      process.exit(1);
-    }
-    const ch = current.commands.find((candidate) => candidate.key === seg);
-    if (!ch) {
-      process.stderr.write("Internal error: missing handler for path.\n");
-      process.exit(1);
-    }
-    current = ch;
-  }
-
-  if (!isCliLeaf(current) || !current.handler) {
-    process.stderr.write("Internal error: missing handler for path.\n");
-    process.exit(1);
-  }
-
-  const ctx = new CliContext(program.key, pr.path, pr.args, pr.opts, program, "cli");
-  try {
-    await Promise.resolve(current.handler(ctx));
-    process.exit(0);
-  } catch (err) {
-    if (err instanceof Error) {
-      process.stderr.write(`${err.message}\n`);
-    }
-    process.exit(1);
-  }
-}
-
-export function cliErrWithHelp(ctx: CliContext, msg: string): never {
-  const color = process.stderr.isTTY;
-  const line = color ? `\u001B[31m${msg}\u001B[0m` : msg;
-  process.stderr.write(`${line}\n`);
-  process.stderr.write(cliHelpRender(cliPresentationRoot(ctx.program), ctx.commandPath, true));
-  process.exit(1);
-}