@barnum/barnum 0.0.0-main-2c283b26 → 0.0.0-main-bca0b910

package/barnum-cli-schema.zod.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+
+const SchemaType = z.union([
+  z.literal("zod").describe("Zod TypeScript schema."),
+  z.literal("json").describe("JSON Schema."),
+]).describe("Output format for `barnum config schema`.");
+
+const ConfigCommand = z.discriminatedUnion("kind", [
+  z.object({
+    config: z.string().describe("Config (JSON string or path to file)"),
+    kind: z.literal("Docs"),
+  }).describe("Generate markdown documentation from config"),
+  z.object({
+    config: z.string().describe("Config (JSON string or path to file)"),
+    kind: z.literal("Validate"),
+  }).describe("Validate a config file"),
+  z.object({
+    config: z.string().describe("Config (JSON string or path to file)"),
+    kind: z.literal("Graph"),
+  }).describe("Generate DOT visualization of config (for `GraphViz`)"),
+  z.object({
+    kind: z.literal("Schema"),
+    schemaType: SchemaType.describe("Output format: zod (default) or json"),
+  }).describe("Print the config schema (Zod by default, JSON with --type json)"),
+]).describe("Subcommands for `barnum config`.");
+
+const Command = z.discriminatedUnion("kind", [
+  z.object({
+    config: z.string().nullable().optional().describe("Config (JSON string or path to file). Required unless `--resume-from` is used."),
+    entrypointValue: z.string().nullable().optional().describe("Initial value for the entrypoint step (JSON string or path to file). Only valid when config has an `entrypoint`. Defaults to `{}` if not provided."),
+    initialState: z.string().nullable().optional().describe("Initial tasks (JSON string or path to file). Required if config has no `entrypoint`. Cannot be used with `--entrypoint-value`."),
+    kind: z.literal("Run"),
+    logFile: z.string().nullable().optional().describe("Log file path (logs emitted in addition to stderr)"),
+    pool: z.string().nullable().optional().describe("Agent pool ID (e.g., `abc123` resolves to `<root>/pools/abc123/`). Defaults to `default`."),
+    resumeFrom: z.string().nullable().optional().describe("Resume from a previous state log file. Incompatible with `--config`, `--initial-state`, and `--entrypoint-value`."),
+    stateLog: z.string().nullable().optional().describe("State log file path (NDJSON file for persistence/resume)"),
+    wake: z.string().nullable().optional().describe("Wake script to call before starting"),
+  }).describe("Run the task queue"),
+  z.object({
+    command: ConfigCommand.describe("Config subcommand to run."),
+    kind: z.literal("Config"),
+  }).describe("Config file operations (docs, validate, graph, schema)"),
+  z.object({
+    json: z.boolean().describe("Output as JSON (for programmatic access)"),
+    kind: z.literal("Version"),
+  }).describe("Print version information"),
+]).describe("Barnum subcommands.");
+
+const LogLevel = z.union([
+  z.literal("off").describe("No logging"),
+  z.literal("error").describe("Error messages only"),
+  z.literal("warn").describe("Warnings and errors"),
+  z.literal("info").describe("Informational messages (default)"),
+  z.literal("debug").describe("Debug messages (includes task return values)"),
+  z.literal("trace").describe("Trace messages (very verbose)"),
+]).describe("Log level for barnum output.");
+
+export const cliSchema = z.object({
+  command: Command.describe("Subcommand to run."),
+  logLevel: LogLevel.describe("Log level (debug shows task return values)"),
+  root: z.string().nullable().optional().describe("Root directory. Pools live in `<root>/pools/<id>/`. Defaults to `/tmp/troupe` on Unix."),
+}).describe("Top-level CLI arguments for barnum.");
+
+export type Cli = z.infer<typeof cliSchema>;
+export type SchemaType = z.infer<typeof SchemaType>;
+export type ConfigCommand = z.infer<typeof ConfigCommand>;
+export type Command = z.infer<typeof Command>;
+export type LogLevel = z.infer<typeof LogLevel>;

package/index.ts

@@ -1 +1,2 @@
 export * from "./barnum-config-schema.zod.js";
+export * from "./barnum-cli-schema.zod.js";

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@barnum/barnum",
-  "version": "0.0.0-main-2c283b26",
+  "version": "0.0.0-main-bca0b910",
   "description": "Barnum CLI - workflow engine for agents.",
   "main": "index.ts",
   "types": "index.ts",
   "exports": {
     ".": "./index.ts",
     "./schema": "./barnum-config-schema.zod.ts",
+    "./cli-schema": "./barnum-cli-schema.zod.ts",
     "./binary": "./index.js"
   },
   "bin": {
@@ -35,10 +36,17 @@
     "cli.js",
     "artifacts/**/*",
     "barnum-config-schema.json",
-    "barnum-config-schema.zod.ts"
+    "barnum-config-schema.zod.ts",
+    "barnum-cli-schema.zod.ts"
   ],
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
     "zod": "^3.0.0"
   },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
   "sideEffects": false
 }