@elie-laloum/outpost 1.1.0

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { createInterface } from \"node:readline/promises\";\nimport { initialize, manageImage, type InitOptions } from \"./scaffold.ts\";\n\nconst help = `Outpost — sandboxed coding agents and workflows\n\noutpost init [--yes] [--agent codex|claude] [--provider docker|podman|vercel|daytona|local]\n             [--template blank|iterate|review|plan|plan-review] [--tracker github|beads|custom]\n             [--manager npm|pnpm|yarn|bun] [--model NAME] [--install] [--build] [--image NAME] [--label NAME] [--directory PATH]\noutpost image build|remove [--engine docker|podman] [--file PATH] [--image NAME] [--uid ID] [--gid ID]\n\nNode.js 24+ and Git are required. Run generated scripts with Node.js.\n`;\n\ntry {\n  const { values, positionals } = parseArgs({\n    allowPositionals: true,\n    options: {\n      help: { type: \"boolean\", short: \"h\" },\n      yes: { type: \"boolean\", short: \"y\" },\n      install: { type: \"boolean\" },\n      build: { type: \"boolean\" },\n      agent: { type: \"string\" },\n      provider: { type: \"string\" },\n      template: { type: \"string\" },\n      tracker: { type: \"string\" },\n      manager: { type: \"string\" },\n      model: { type: \"string\" },\n      label: { type: \"string\" },\n      directory: { type: \"string\" },\n      engine: { type: \"string\" },\n      file: { type: \"string\" },\n      image: { type: \"string\" },\n      uid: { type: \"string\" },\n      gid: { type: \"string\" },\n    },\n  });\n  if (values.help || !positionals.length) process.stdout.write(help);\n  else if (positionals[0] === \"init\") {\n    const options: Record<string, unknown> = Object.fromEntries(\n      Object.entries(values).filter(([key]) => ![\"help\", \"yes\"].includes(key)),\n    );\n    if (\n      !values.yes &&\n      !process.stdin.isTTY &&\n      (!values.agent || !values.provider || !values.template || !values.tracker)\n    )\n      throw new Error(\n        \"Headless initialization requires --yes for defaults, or --agent, --provider, --template and --tracker.\",\n      );\n    if (!values.yes && process.stdin.isTTY) {\n      const terminal = createInterface({\n        input: process.stdin,\n        output: process.stdout,\n      });\n      try {\n        for (const [key, label, fallback] of [\n          [\"agent\", \"Agent (codex/claude)\", \"codex\"],\n          [\n            \"provider\",\n            \"Sandbox (docker/podman/vercel/daytona/local)\",\n            \"docker\",\n          ],\n          [\n            \"template\",\n            \"Template (blank/iterate/review/plan/plan-review)\",\n            \"blank\",\n          ],\n          [\"tracker\", \"Issue tracker (github/beads/custom)\", \"github\"],\n        ] as const) {\n          options[key] ??=\n            (await terminal.question(`${label} [${fallback}]: `)).trim() ||\n            fallback;\n        }\n      } finally {\n        terminal.close();\n      }\n    }\n    const result = await initialize(options as InitOptions);\n    process.stdout.write(\n      `Created ${result.files.length} files.\\nRun: ${result.run}\\n`,\n    );\n  } else if (\n    positionals[0] === \"image\" &&\n    [\"build\", \"remove\"].includes(positionals[1] ?? \"\")\n  ) {\n    const options = Object.fromEntries(\n      Object.entries(values).filter(([key]) =>\n        [\"directory\", \"engine\", \"file\", \"image\"].includes(key),\n      ),\n    );\n    const image = await manageImage(positionals[1] as \"build\" | \"remove\", {\n      ...options,\n      ...(values.uid ? { uid: Number(values.uid) } : {}),\n      ...(values.gid ? { gid: Number(values.gid) } : {}),\n    });\n    process.stdout.write(`${positionals[1]}: ${image}\\n`);\n  } else throw new Error(\"Unknown command. Run outpost --help.\");\n} catch (error) {\n  process.stderr.write(\n    `${error instanceof Error ? error.message : String(error)}\\n`,\n  );\n  process.exitCode = 1;\n}\n"]}

package/dist/cli/scaffold.d.ts

@@ -0,0 +1,28 @@
+import { type Executor } from "../infrastructure/process.ts";
+export type Template = "blank" | "iterate" | "review" | "plan" | "plan-review";
+export interface InitOptions {
+    readonly directory?: string;
+    readonly agent?: "claude" | "codex";
+    readonly provider?: "docker" | "podman" | "vercel" | "daytona" | "local";
+    readonly template?: Template;
+    readonly tracker?: "github" | "beads" | "custom";
+    readonly manager?: "npm" | "pnpm" | "yarn" | "bun";
+    readonly model?: string;
+    readonly install?: boolean;
+    readonly label?: string;
+    readonly build?: boolean;
+    readonly image?: string;
+}
+export declare const imageRecipe: string;
+export declare function initialize(options?: InitOptions, executor?: Executor): Promise<{
+    files: readonly string[];
+    run: string;
+}>;
+export declare function manageImage(action: "build" | "remove", options?: {
+    directory?: string;
+    engine?: "docker" | "podman";
+    image?: string;
+    file?: string;
+    uid?: number;
+    gid?: number;
+}, executor?: Executor): Promise<string>;

package/dist/cli/scaffold.js

@@ -0,0 +1,169 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { OutpostError, invariant } from "../domain/errors.js";
+import { imageName } from "../providers/container.js";
+import { agentVersions } from "../providers/versions.js";
+import { requireSuccess } from "../infrastructure/process.js";
+import { starter, tracker } from "./starters.js";
+export const imageRecipe = `FROM node:24-bookworm-slim
+ARG AGENT_UID=1000
+ARG AGENT_GID=1000
+RUN apt-get update && apt-get install -y --no-install-recommends git gh openssh-client ca-certificates curl procps util-linux python3 && rm -rf /var/lib/apt/lists/*
+RUN npm install -g --allow-scripts=@anthropic-ai/claude-code @openai/codex@${agentVersions.codex} @anthropic-ai/claude-code@${agentVersions.claude}
+RUN groupmod -o -g "$AGENT_GID" node && usermod -o -u "$AGENT_UID" -g "$AGENT_GID" node
+ENV HOME=/home/agent
+USER $AGENT_UID:$AGENT_GID
+WORKDIR /workspace
+`;
+export async function initialize(options = {}, executor) {
+    const root = resolve(options.directory ?? process.cwd()), folder = join(root, ".outpost");
+    const agent = options.agent ?? "codex", provider = options.provider ?? "docker", template = options.template ?? "blank";
+    invariant(["codex", "claude"].includes(agent), "Choose codex or claude");
+    invariant(["docker", "podman", "vercel", "daytona", "local"].includes(provider), "Unknown sandbox provider");
+    invariant(["blank", "iterate", "review", "plan", "plan-review"].includes(template), "Unknown starter template");
+    if (options.tracker)
+        invariant(["github", "beads", "custom"].includes(options.tracker), "Unknown tracker");
+    let pkg = {};
+    try {
+        pkg = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+        if (!pkg || typeof pkg !== "object")
+            pkg = {};
+    }
+    catch (cause) {
+        if (!(cause instanceof SyntaxError) &&
+            cause.code !== "ENOENT")
+            throw cause;
+    }
+    const extension = pkg.type === "module" ? "ts" : "mts";
+    let detected = typeof pkg.packageManager === "string"
+        ? pkg.packageManager.split("@")[0]
+        : undefined;
+    if (!detected || !["npm", "pnpm", "yarn", "bun"].includes(detected)) {
+        detected = undefined;
+        for (const [file, manager] of [
+            ["pnpm-lock.yaml", "pnpm"],
+            ["yarn.lock", "yarn"],
+            ["bun.lock", "bun"],
+            ["bun.lockb", "bun"],
+        ]) {
+            if (await access(join(root, file))
+                .then(() => true)
+                .catch(() => false)) {
+                detected = manager;
+                break;
+            }
+        }
+    }
+    const manager = options.manager ?? detected ?? "npm";
+    invariant(["npm", "pnpm", "yarn", "bun"].includes(manager), "Unknown package manager");
+    const files = {
+        [`run.${extension}`]: starter(options, extension),
+        "brief.md": "Objective: {{OBJECTIVE}}\n\nWork on {{WORK_BRANCH}} from {{BASE_BRANCH}}. Inspect the repository, implement the objective, run relevant tests and commit your changes. When finished, write <outpost>done</outpost>.\n",
+        ".env.example": (agent === "codex" ? "OPENAI_API_KEY=\n" : "ANTHROPIC_API_KEY=\n") +
+            (options.tracker === "github" ? "GH_TOKEN=\n" : ""),
+        ".gitignore": ".env\nworkspaces/\nlocks/\nrecovery/\nlogs/\n",
+    };
+    if (provider === "docker" || provider === "podman")
+        files[provider === "docker" ? "Dockerfile" : "Containerfile"] =
+            options.tracker === "beads"
+                ? imageRecipe.replace("RUN groupmod", "RUN npm install -g --allow-scripts=@beads/bd @beads/bd@1.2.2\nRUN groupmod")
+                : imageRecipe;
+    if (template !== "blank")
+        files["STANDARDS.md"] =
+            "# Engineering standards\n\nKeep domain rules separate from infrastructure. Test observable behavior, handle failure and cancellation, and preserve existing user changes. Run the repository checks before committing. Prefer clear names to comments; keep necessary comments at most two lines. Review the complete diff against the supplied base commit.\n";
+    if (options.tracker)
+        files[`tickets.${extension}`] = tracker(options.tracker, options.label);
+    if (options.tracker === "custom")
+        files["TRACKER.md"] =
+            `# Custom issue tracker\n\nSet OUTPOST_TRACKER_URL in the host environment before running the starter. Implement GET issues?state=open (Issue[]), GET issues/:id (Issue), and POST issues/:id/close (any successful status). Issue has id, title, optional body and optional blockedBy ids. The generated tickets.${extension} is yours to adapt: add authentication, pagination and filtering for your tracker there. Never commit credentials.\n\nThe campaign reloads the backlog each cycle, reads an issue before implementation, and closes it only after its commits reach the host branch. Configure authentication in tickets.${extension}. A failed close is reported and must be reconciled before rerunning.\n`;
+    for (const name of Object.keys(files))
+        if (await access(join(folder, name))
+            .then(() => true)
+            .catch(() => false))
+            throw new OutpostError("configuration", `Initialization would overwrite .outpost/${name}`);
+    await mkdir(folder, { recursive: true });
+    for (const [name, content] of Object.entries(files))
+        await writeFile(join(folder, name), content, { flag: "wx" });
+    if (options.install) {
+        const packages = [
+            "@elie-laloum/outpost",
+            ...(provider === "vercel"
+                ? ["@vercel/sandbox"]
+                : provider === "daytona"
+                    ? ["@daytona/sdk"]
+                    : []),
+        ];
+        const args = manager === "npm"
+            ? ["install", "--save-dev", ...packages]
+            : ["add", "--dev", ...packages];
+        await requireSuccess(process.platform === "win32"
+            ? {
+                executable: "cmd.exe",
+                arguments: ["/d", "/c", [manager, ...args].join(" ")],
+                directory: root,
+            }
+            : { executable: manager, arguments: args, directory: root }, executor);
+    }
+    if (options.label) {
+        invariant(options.tracker === "github", "Labels require the GitHub tracker");
+        await requireSuccess({
+            executable: "gh",
+            arguments: [
+                "label",
+                "create",
+                options.label,
+                "--color",
+                "4969ED",
+                "--description",
+                "Ready for Outpost",
+                "--force",
+            ],
+            directory: root,
+        }, executor);
+    }
+    if (options.build && (provider === "docker" || provider === "podman"))
+        await manageImage("build", {
+            directory: root,
+            engine: provider,
+            ...(options.image ? { image: options.image } : {}),
+        }, executor);
+    return {
+        files: Object.keys(files).map((name) => join(folder, name)),
+        run: `node .outpost/run.${extension}`,
+    };
+}
+export async function manageImage(action, options = {}, executor) {
+    const root = resolve(options.directory ?? process.cwd()), engine = options.engine ?? "docker", image = options.image ?? imageName(root);
+    invariant(engine === "docker" || engine === "podman", "Image engine must be docker or podman");
+    const uid = options.uid ?? process.getuid?.() ?? 1000, gid = options.gid ?? process.getgid?.() ?? 1000;
+    invariant(Number.isSafeInteger(uid) &&
+        uid >= 0 &&
+        Number.isSafeInteger(gid) &&
+        gid >= 0, "UID and GID must be nonnegative integers");
+    const args = action === "remove"
+        ? ["image", "rm", image]
+        : [
+            "build",
+            "--tag",
+            image,
+            "--file",
+            resolve(root, options.file ??
+                `.outpost/${engine === "docker" ? "Dockerfile" : "Containerfile"}`),
+            "--build-arg",
+            `AGENT_UID=${uid}`,
+            "--build-arg",
+            `AGENT_GID=${gid}`,
+            root,
+        ];
+    await requireSuccess({
+        executable: engine,
+        arguments: args,
+        directory: root,
+        deadlineMs: 1_800_000,
+        observe(channel, text) {
+            (channel === "stdout" ? process.stdout : process.stderr).write(text);
+        },
+    }, executor);
+    return image;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/cli/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/cli/scaffold.ts"],"names":[],"mappings":"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","sourcesContent":["import { access, mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { OutpostError, invariant } from \"../domain/errors.ts\";\nimport { imageName } from \"../providers/container.ts\";\nimport { agentVersions } from \"../providers/versions.ts\";\nimport { requireSuccess, type Executor } from \"../infrastructure/process.ts\";\n\nimport { starter, tracker } from \"./starters.ts\";\n\nexport type Template = \"blank\" | \"iterate\" | \"review\" | \"plan\" | \"plan-review\";\nexport interface InitOptions {\n  readonly directory?: string;\n  readonly agent?: \"claude\" | \"codex\";\n  readonly provider?: \"docker\" | \"podman\" | \"vercel\" | \"daytona\" | \"local\";\n  readonly template?: Template;\n  readonly tracker?: \"github\" | \"beads\" | \"custom\";\n  readonly manager?: \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n  readonly model?: string;\n  readonly install?: boolean;\n  readonly label?: string;\n  readonly build?: boolean;\n  readonly image?: string;\n}\n\nexport const imageRecipe = `FROM node:24-bookworm-slim\nARG AGENT_UID=1000\nARG AGENT_GID=1000\nRUN apt-get update && apt-get install -y --no-install-recommends git gh openssh-client ca-certificates curl procps util-linux python3 && rm -rf /var/lib/apt/lists/*\nRUN npm install -g --allow-scripts=@anthropic-ai/claude-code @openai/codex@${agentVersions.codex} @anthropic-ai/claude-code@${agentVersions.claude}\nRUN groupmod -o -g \"$AGENT_GID\" node && usermod -o -u \"$AGENT_UID\" -g \"$AGENT_GID\" node\nENV HOME=/home/agent\nUSER $AGENT_UID:$AGENT_GID\nWORKDIR /workspace\n`;\n\nexport async function initialize(\n  options: InitOptions = {},\n  executor?: Executor,\n): Promise<{ files: readonly string[]; run: string }> {\n  const root = resolve(options.directory ?? process.cwd()),\n    folder = join(root, \".outpost\");\n  const agent = options.agent ?? \"codex\",\n    provider = options.provider ?? \"docker\",\n    template = options.template ?? \"blank\";\n  invariant([\"codex\", \"claude\"].includes(agent), \"Choose codex or claude\");\n  invariant(\n    [\"docker\", \"podman\", \"vercel\", \"daytona\", \"local\"].includes(provider),\n    \"Unknown sandbox provider\",\n  );\n  invariant(\n    [\"blank\", \"iterate\", \"review\", \"plan\", \"plan-review\"].includes(template),\n    \"Unknown starter template\",\n  );\n  if (options.tracker)\n    invariant(\n      [\"github\", \"beads\", \"custom\"].includes(options.tracker),\n      \"Unknown tracker\",\n    );\n  let pkg: { type?: string; packageManager?: string } = {};\n  try {\n    pkg = JSON.parse(await readFile(join(root, \"package.json\"), \"utf8\"));\n    if (!pkg || typeof pkg !== \"object\") pkg = {};\n  } catch (cause) {\n    if (\n      !(cause instanceof SyntaxError) &&\n      (cause as NodeJS.ErrnoException).code !== \"ENOENT\"\n    )\n      throw cause;\n  }\n  const extension = pkg.type === \"module\" ? \"ts\" : \"mts\";\n  let detected =\n    typeof pkg.packageManager === \"string\"\n      ? pkg.packageManager.split(\"@\")[0]\n      : undefined;\n  if (!detected || ![\"npm\", \"pnpm\", \"yarn\", \"bun\"].includes(detected)) {\n    detected = undefined;\n    for (const [file, manager] of [\n      [\"pnpm-lock.yaml\", \"pnpm\"],\n      [\"yarn.lock\", \"yarn\"],\n      [\"bun.lock\", \"bun\"],\n      [\"bun.lockb\", \"bun\"],\n    ]) {\n      if (\n        await access(join(root, file!))\n          .then(() => true)\n          .catch(() => false)\n      ) {\n        detected = manager;\n        break;\n      }\n    }\n  }\n  const manager = options.manager ?? detected ?? \"npm\";\n  invariant(\n    [\"npm\", \"pnpm\", \"yarn\", \"bun\"].includes(manager),\n    \"Unknown package manager\",\n  );\n  const files: Record<string, string> = {\n    [`run.${extension}`]: starter(options, extension),\n    \"brief.md\":\n      \"Objective: {{OBJECTIVE}}\\n\\nWork on {{WORK_BRANCH}} from {{BASE_BRANCH}}. Inspect the repository, implement the objective, run relevant tests and commit your changes. When finished, write <outpost>done</outpost>.\\n\",\n    \".env.example\":\n      (agent === \"codex\" ? \"OPENAI_API_KEY=\\n\" : \"ANTHROPIC_API_KEY=\\n\") +\n      (options.tracker === \"github\" ? \"GH_TOKEN=\\n\" : \"\"),\n    \".gitignore\": \".env\\nworkspaces/\\nlocks/\\nrecovery/\\nlogs/\\n\",\n  };\n  if (provider === \"docker\" || provider === \"podman\")\n    files[provider === \"docker\" ? \"Dockerfile\" : \"Containerfile\"] =\n      options.tracker === \"beads\"\n        ? imageRecipe.replace(\n            \"RUN groupmod\",\n            \"RUN npm install -g --allow-scripts=@beads/bd @beads/bd@1.2.2\\nRUN groupmod\",\n          )\n        : imageRecipe;\n  if (template !== \"blank\")\n    files[\"STANDARDS.md\"] =\n      \"# Engineering standards\\n\\nKeep domain rules separate from infrastructure. Test observable behavior, handle failure and cancellation, and preserve existing user changes. Run the repository checks before committing. Prefer clear names to comments; keep necessary comments at most two lines. Review the complete diff against the supplied base commit.\\n\";\n  if (options.tracker)\n    files[`tickets.${extension}`] = tracker(options.tracker, options.label);\n  if (options.tracker === \"custom\")\n    files[\"TRACKER.md\"] =\n      `# Custom issue tracker\\n\\nSet OUTPOST_TRACKER_URL in the host environment before running the starter. Implement GET issues?state=open (Issue[]), GET issues/:id (Issue), and POST issues/:id/close (any successful status). Issue has id, title, optional body and optional blockedBy ids. The generated tickets.${extension} is yours to adapt: add authentication, pagination and filtering for your tracker there. Never commit credentials.\\n\\nThe campaign reloads the backlog each cycle, reads an issue before implementation, and closes it only after its commits reach the host branch. Configure authentication in tickets.${extension}. A failed close is reported and must be reconciled before rerunning.\\n`;\n  for (const name of Object.keys(files))\n    if (\n      await access(join(folder, name))\n        .then(() => true)\n        .catch(() => false)\n    )\n      throw new OutpostError(\n        \"configuration\",\n        `Initialization would overwrite .outpost/${name}`,\n      );\n  await mkdir(folder, { recursive: true });\n  for (const [name, content] of Object.entries(files))\n    await writeFile(join(folder, name), content, { flag: \"wx\" });\n  if (options.install) {\n    const packages = [\n      \"@elie-laloum/outpost\",\n      ...(provider === \"vercel\"\n        ? [\"@vercel/sandbox\"]\n        : provider === \"daytona\"\n          ? [\"@daytona/sdk\"]\n          : []),\n    ];\n    const args =\n      manager === \"npm\"\n        ? [\"install\", \"--save-dev\", ...packages]\n        : [\"add\", \"--dev\", ...packages];\n    await requireSuccess(\n      process.platform === \"win32\"\n        ? {\n            executable: \"cmd.exe\",\n            arguments: [\"/d\", \"/c\", [manager, ...args].join(\" \")],\n            directory: root,\n          }\n        : { executable: manager, arguments: args, directory: root },\n      executor,\n    );\n  }\n  if (options.label) {\n    invariant(\n      options.tracker === \"github\",\n      \"Labels require the GitHub tracker\",\n    );\n    await requireSuccess(\n      {\n        executable: \"gh\",\n        arguments: [\n          \"label\",\n          \"create\",\n          options.label,\n          \"--color\",\n          \"4969ED\",\n          \"--description\",\n          \"Ready for Outpost\",\n          \"--force\",\n        ],\n        directory: root,\n      },\n      executor,\n    );\n  }\n  if (options.build && (provider === \"docker\" || provider === \"podman\"))\n    await manageImage(\n      \"build\",\n      {\n        directory: root,\n        engine: provider,\n        ...(options.image ? { image: options.image } : {}),\n      },\n      executor,\n    );\n  return {\n    files: Object.keys(files).map((name) => join(folder, name)),\n    run: `node .outpost/run.${extension}`,\n  };\n}\n\nexport async function manageImage(\n  action: \"build\" | \"remove\",\n  options: {\n    directory?: string;\n    engine?: \"docker\" | \"podman\";\n    image?: string;\n    file?: string;\n    uid?: number;\n    gid?: number;\n  } = {},\n  executor?: Executor,\n): Promise<string> {\n  const root = resolve(options.directory ?? process.cwd()),\n    engine = options.engine ?? \"docker\",\n    image = options.image ?? imageName(root);\n  invariant(\n    engine === \"docker\" || engine === \"podman\",\n    \"Image engine must be docker or podman\",\n  );\n  const uid = options.uid ?? process.getuid?.() ?? 1000,\n    gid = options.gid ?? process.getgid?.() ?? 1000;\n  invariant(\n    Number.isSafeInteger(uid) &&\n      uid >= 0 &&\n      Number.isSafeInteger(gid) &&\n      gid >= 0,\n    \"UID and GID must be nonnegative integers\",\n  );\n  const args =\n    action === \"remove\"\n      ? [\"image\", \"rm\", image]\n      : [\n          \"build\",\n          \"--tag\",\n          image,\n          \"--file\",\n          resolve(\n            root,\n            options.file ??\n              `.outpost/${engine === \"docker\" ? \"Dockerfile\" : \"Containerfile\"}`,\n          ),\n          \"--build-arg\",\n          `AGENT_UID=${uid}`,\n          \"--build-arg\",\n          `AGENT_GID=${gid}`,\n          root,\n        ];\n  await requireSuccess(\n    {\n      executable: engine,\n      arguments: args,\n      directory: root,\n      deadlineMs: 1_800_000,\n      observe(channel, text) {\n        (channel === \"stdout\" ? process.stdout : process.stderr).write(text);\n      },\n    },\n    executor,\n  );\n  return image;\n}\n"]}

package/dist/cli/starters.d.ts

@@ -0,0 +1,3 @@
+import type { InitOptions } from "./scaffold.ts";
+export declare function starter(options: InitOptions, extension: string): string;
+export declare function tracker(kind: NonNullable<InitOptions["tracker"]>, label?: string): string;

package/dist/cli/starters.js

@@ -0,0 +1,34 @@
+export function starter(options, extension) {
+    const agent = options.agent ?? "codex", provider = options.provider ?? "docker", template = options.template ?? "blank";
+    const planning = template === "plan" || template === "plan-review";
+    const reviewing = template === "review" || template === "plan-review";
+    const imports = `import { campaign, dispatch, ${agent} } from "@elie-laloum/outpost";\nimport type { Backlog } from "@elie-laloum/outpost";\nimport { ${provider} } from "@elie-laloum/outpost/providers/${provider}";\nimport { readFile } from "node:fs/promises";\n${options.tracker ? `import { backlog } from "./tickets.${extension}";\n` : ""}`;
+    const config = `const runtime = { agent: ${agent}(${options.model ? `{ model: ${JSON.stringify(options.model)} }` : ""}), provider: ${provider}(${options.image && (provider === "docker" || provider === "podman") ? `{ image: ${JSON.stringify(options.image)} }` : ""}) };\nconst objective = process.argv.slice(2).join(" ") || "Inspect this repository and implement one useful improvement.";\n`;
+    if (template === "blank")
+        return `${imports}\n${config}\nconst result = await dispatch({ ...runtime, branch: { mode: "integrate" }, brief: { file: ".outpost/brief.md", values: { OBJECTIVE: objective } } });\nconsole.log({ branch: result.branch, commits: result.commits, conversation: result.conversation });\n`;
+    const backlog = options.tracker
+        ? ""
+        : `let pending = true;\nconst requested = { id: "objective", title: objective };\nconst backlog: Backlog = {\n  async list() { return pending ? [requested] : []; },\n  async get() { return requested; },\n  async close() { pending = false; },\n};\n`;
+    return `${imports}\n${config}\n${backlog}\nconst result = await campaign({\n  ...runtime, backlog,\n  cycles: 10, concurrency: ${planning ? 3 : 1},\n  implementationPasses: ${planning ? 100 : 1}, reviewPasses: 1,\n  planner: ${planning ? "runtime.agent" : "false"}, reviewer: ${reviewing ? "runtime.agent" : "false"},\n  copies: ["node_modules"],\n  standards: await readFile(new URL("./STANDARDS.md", import.meta.url), "utf8"),\n  observe: event => console.log(\`[cycle \${event.cycle}] \${event.phase}\${event.issue ? " " + event.issue : ""}\`),\n});\nconsole.log(result);\nif (result.issues.some(issue => issue.state === "failed")) process.exitCode = 1;\n`;
+}
+export function tracker(kind, label) {
+    if (kind !== "custom") {
+        const factory = kind === "github" ? "githubBacklog" : "beadsBacklog";
+        return `import { ${factory} } from "@elie-laloum/outpost";\nexport const backlog = ${factory}(${label ? `{ label: ${JSON.stringify(label)} }` : ""});\n`;
+    }
+    return `import type { Backlog, Issue } from "@elie-laloum/outpost";
+async function request(path: string, method = "GET", signal?: AbortSignal) {
+  const base = process.env.OUTPOST_TRACKER_URL;
+  if (!base) throw new Error("Set OUTPOST_TRACKER_URL");
+  const reply = await fetch(new URL(path, base.endsWith("/") ? base : base + "/"), { method, signal });
+  if (!reply.ok) throw new Error(\`Tracker returned \${reply.status}\`);
+  return reply;
+}
+export const backlog: Backlog = {
+  async list(signal) { return await (await request("issues?state=open", "GET", signal)).json() as Issue[]; },
+  async get(id, signal) { return await (await request("issues/" + encodeURIComponent(id), "GET", signal)).json() as Issue; },
+  async close(id, signal) { await request("issues/" + encodeURIComponent(id) + "/close", "POST", signal); },
+};
+`;
+}
+//# sourceMappingURL=starters.js.map

package/dist/cli/starters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starters.js","sourceRoot":"","sources":["../../src/cli/starters.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,OAAO,CAAC,OAAoB,EAAE,SAAiB;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,EACpC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,EACvC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,aAAa,CAAC;IACnE,MAAM,SAAS,GAAG,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,aAAa,CAAC;IACtE,MAAM,OAAO,GAAG,gCAAgC,KAAK,mGAAmG,QAAQ,2CAA2C,QAAQ,qDAAqD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,sCAAsC,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvV,MAAM,MAAM,GAAG,4BAA4B,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,QAAQ,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,+HAA+H,CAAC;IACxY,IAAI,QAAQ,KAAK,OAAO;QACtB,OAAO,GAAG,OAAO,KAAK,MAAM,gQAAgQ,CAAC;IAC/R,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,sPAAsP,CAAC;IAC3P,OAAO,GAAG,OAAO,KAAK,MAAM,KAAK,OAAO,yFAAyF,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kCAAkC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,eAAe,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,wVAAwV,CAAC;AACtpB,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,IAAyC,EACzC,KAAc;IAEd,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC;QACrE,OAAO,YAAY,OAAO,2DAA2D,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAC3J,CAAC;IACD,OAAO;;;;;;;;;;;;;CAaR,CAAC;AACF,CAAC","sourcesContent":["import type { InitOptions } from \"./scaffold.ts\";\n\nexport function starter(options: InitOptions, extension: string): string {\n  const agent = options.agent ?? \"codex\",\n    provider = options.provider ?? \"docker\",\n    template = options.template ?? \"blank\";\n  const planning = template === \"plan\" || template === \"plan-review\";\n  const reviewing = template === \"review\" || template === \"plan-review\";\n  const imports = `import { campaign, dispatch, ${agent} } from \"@elie-laloum/outpost\";\\nimport type { Backlog } from \"@elie-laloum/outpost\";\\nimport { ${provider} } from \"@elie-laloum/outpost/providers/${provider}\";\\nimport { readFile } from \"node:fs/promises\";\\n${options.tracker ? `import { backlog } from \"./tickets.${extension}\";\\n` : \"\"}`;\n  const config = `const runtime = { agent: ${agent}(${options.model ? `{ model: ${JSON.stringify(options.model)} }` : \"\"}), provider: ${provider}(${options.image && (provider === \"docker\" || provider === \"podman\") ? `{ image: ${JSON.stringify(options.image)} }` : \"\"}) };\\nconst objective = process.argv.slice(2).join(\" \") || \"Inspect this repository and implement one useful improvement.\";\\n`;\n  if (template === \"blank\")\n    return `${imports}\\n${config}\\nconst result = await dispatch({ ...runtime, branch: { mode: \"integrate\" }, brief: { file: \".outpost/brief.md\", values: { OBJECTIVE: objective } } });\\nconsole.log({ branch: result.branch, commits: result.commits, conversation: result.conversation });\\n`;\n  const backlog = options.tracker\n    ? \"\"\n    : `let pending = true;\\nconst requested = { id: \"objective\", title: objective };\\nconst backlog: Backlog = {\\n  async list() { return pending ? [requested] : []; },\\n  async get() { return requested; },\\n  async close() { pending = false; },\\n};\\n`;\n  return `${imports}\\n${config}\\n${backlog}\\nconst result = await campaign({\\n  ...runtime, backlog,\\n  cycles: 10, concurrency: ${planning ? 3 : 1},\\n  implementationPasses: ${planning ? 100 : 1}, reviewPasses: 1,\\n  planner: ${planning ? \"runtime.agent\" : \"false\"}, reviewer: ${reviewing ? \"runtime.agent\" : \"false\"},\\n  copies: [\"node_modules\"],\\n  standards: await readFile(new URL(\"./STANDARDS.md\", import.meta.url), \"utf8\"),\\n  observe: event => console.log(\\`[cycle \\${event.cycle}] \\${event.phase}\\${event.issue ? \" \" + event.issue : \"\"}\\`),\\n});\\nconsole.log(result);\\nif (result.issues.some(issue => issue.state === \"failed\")) process.exitCode = 1;\\n`;\n}\n\nexport function tracker(\n  kind: NonNullable<InitOptions[\"tracker\"]>,\n  label?: string,\n): string {\n  if (kind !== \"custom\") {\n    const factory = kind === \"github\" ? \"githubBacklog\" : \"beadsBacklog\";\n    return `import { ${factory} } from \"@elie-laloum/outpost\";\\nexport const backlog = ${factory}(${label ? `{ label: ${JSON.stringify(label)} }` : \"\"});\\n`;\n  }\n  return `import type { Backlog, Issue } from \"@elie-laloum/outpost\";\nasync function request(path: string, method = \"GET\", signal?: AbortSignal) {\n  const base = process.env.OUTPOST_TRACKER_URL;\n  if (!base) throw new Error(\"Set OUTPOST_TRACKER_URL\");\n  const reply = await fetch(new URL(path, base.endsWith(\"/\") ? base : base + \"/\"), { method, signal });\n  if (!reply.ok) throw new Error(\\`Tracker returned \\${reply.status}\\`);\n  return reply;\n}\nexport const backlog: Backlog = {\n  async list(signal) { return await (await request(\"issues?state=open\", \"GET\", signal)).json() as Issue[]; },\n  async get(id, signal) { return await (await request(\"issues/\" + encodeURIComponent(id), \"GET\", signal)).json() as Issue; },\n  async close(id, signal) { await request(\"issues/\" + encodeURIComponent(id) + \"/close\", \"POST\", signal); },\n};\n`;\n}\n"]}

package/dist/domain/backlog.d.ts

@@ -0,0 +1,16 @@
+export interface Issue {
+    readonly id: string;
+    readonly title: string;
+    readonly body?: string;
+    readonly blockedBy?: readonly string[];
+}
+export interface Backlog {
+    list(signal?: AbortSignal): Promise<readonly Issue[]>;
+    get(id: string, signal?: AbortSignal): Promise<Issue>;
+    close(id: string, signal?: AbortSignal): Promise<void>;
+}
+export interface Assignment {
+    readonly id: string;
+    readonly branch: string;
+}
+export declare function readPlan(input: unknown): readonly Assignment[];

package/dist/domain/backlog.js

@@ -0,0 +1,23 @@
+import { invariant } from "./errors.js";
+export function readPlan(input) {
+    invariant(!!input &&
+        typeof input === "object" &&
+        "issues" in input &&
+        Array.isArray(input.issues), "Plan must contain an issues array");
+    const ids = new Set(), branches = new Set();
+    return input.issues.map((entry) => {
+        invariant(!!entry &&
+            typeof entry === "object" &&
+            "id" in entry &&
+            typeof entry.id === "string" &&
+            entry.id.trim().length > 0 &&
+            "branch" in entry &&
+            typeof entry.branch === "string" &&
+            entry.branch.startsWith("outpost/"), "Each assignment needs an issue id and an outpost/ branch");
+        invariant(!ids.has(entry.id) && !branches.has(entry.branch), "Plan contains duplicate issues or branches");
+        ids.add(entry.id);
+        branches.add(entry.branch);
+        return { id: entry.id, branch: entry.branch };
+    });
+}
+//# sourceMappingURL=backlog.js.map

package/dist/domain/backlog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.js","sourceRoot":"","sources":["../../src/domain/backlog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoBxC,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,SAAS,CACP,CAAC,CAAC,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAC7B,mCAAmC,CACpC,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,EAC3B,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAc,EAAE,EAAE;QACzC,SAAS,CACP,CAAC,CAAC,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,IAAI,IAAI,KAAK;YACb,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;YAC5B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAC1B,QAAQ,IAAI,KAAK;YACjB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAChC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EACrC,0DAA0D,CAC3D,CAAC;QACF,SAAS,CACP,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EACjD,4CAA4C,CAC7C,CAAC;QACF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { invariant } from \"./errors.ts\";\n\nexport interface Issue {\n  readonly id: string;\n  readonly title: string;\n  readonly body?: string;\n  readonly blockedBy?: readonly string[];\n}\n\nexport interface Backlog {\n  list(signal?: AbortSignal): Promise<readonly Issue[]>;\n  get(id: string, signal?: AbortSignal): Promise<Issue>;\n  close(id: string, signal?: AbortSignal): Promise<void>;\n}\n\nexport interface Assignment {\n  readonly id: string;\n  readonly branch: string;\n}\n\nexport function readPlan(input: unknown): readonly Assignment[] {\n  invariant(\n    !!input &&\n      typeof input === \"object\" &&\n      \"issues\" in input &&\n      Array.isArray(input.issues),\n    \"Plan must contain an issues array\",\n  );\n  const ids = new Set<string>(),\n    branches = new Set<string>();\n  return input.issues.map((entry: unknown) => {\n    invariant(\n      !!entry &&\n        typeof entry === \"object\" &&\n        \"id\" in entry &&\n        typeof entry.id === \"string\" &&\n        entry.id.trim().length > 0 &&\n        \"branch\" in entry &&\n        typeof entry.branch === \"string\" &&\n        entry.branch.startsWith(\"outpost/\"),\n      \"Each assignment needs an issue id and an outpost/ branch\",\n    );\n    invariant(\n      !ids.has(entry.id) && !branches.has(entry.branch),\n      \"Plan contains duplicate issues or branches\",\n    );\n    ids.add(entry.id);\n    branches.add(entry.branch);\n    return { id: entry.id, branch: entry.branch };\n  });\n}\n"]}

package/dist/domain/errors.d.ts

@@ -0,0 +1,11 @@
+export type FaultCode = "configuration" | "process" | "timeout" | "aborted" | "workspace" | "conflict" | "prompt" | "response" | "session" | "provider";
+export declare class OutpostError extends Error {
+    recovery: Readonly<Record<string, unknown>>;
+    readonly code: FaultCode;
+    readonly details: Readonly<Record<string, unknown>>;
+    constructor(code: FaultCode, message: string, details?: Record<string, unknown>, cause?: unknown);
+}
+export declare function recordRecovery(error: unknown, details: Record<string, unknown>): void;
+export declare function recoveryDetails(error: unknown): Readonly<Record<string, unknown>> | undefined;
+export declare function invariant(condition: unknown, message: string): asserts condition;
+export declare function positive(value: number, label: string): number;

package/dist/domain/errors.js

@@ -0,0 +1,37 @@
+export class OutpostError extends Error {
+    recovery = {};
+    code;
+    details;
+    constructor(code, message, details = {}, cause) {
+        super(message, { cause });
+        this.name = "OutpostError";
+        this.code = code;
+        this.details = Object.freeze({ ...details });
+    }
+}
+const recoveryRecords = new WeakMap();
+export function recordRecovery(error, details) {
+    if (error && (typeof error === "object" || typeof error === "function")) {
+        const previous = recoveryDetails(error);
+        const recovery = Object.freeze({ ...previous, ...details });
+        recoveryRecords.set(error, recovery);
+        if (error instanceof OutpostError)
+            error.recovery = recovery;
+    }
+}
+export function recoveryDetails(error) {
+    return error instanceof OutpostError
+        ? error.recovery
+        : error && (typeof error === "object" || typeof error === "function")
+            ? recoveryRecords.get(error)
+            : undefined;
+}
+export function invariant(condition, message) {
+    if (!condition)
+        throw new OutpostError("configuration", message);
+}
+export function positive(value, label) {
+    invariant(Number.isSafeInteger(value) && value > 0, `${label} must be a positive integer`);
+    return value;
+}
+//# sourceMappingURL=errors.js.map

package/dist/domain/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/domain/errors.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,QAAQ,GAAsC,EAAE,CAAC;IACxC,IAAI,CAAY;IAChB,OAAO,CAAoC;IACpD,YACE,IAAe,EACf,OAAe,EACf,UAAmC,EAAE,EACrC,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,MAAM,eAAe,GAAG,IAAI,OAAO,EAGhC,CAAC;AAEJ,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAgC;IAEhC,IAAI,KAAK,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;QACxE,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAC5D,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACrC,IAAI,KAAK,YAAY,YAAY;YAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAc;IAEd,OAAO,KAAK,YAAY,YAAY;QAClC,CAAC,CAAC,KAAK,CAAC,QAAQ;QAChB,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;YACnE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC;YAC5B,CAAC,CAAC,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,SAAkB,EAClB,OAAe;IAEf,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAa;IACnD,SAAS,CACP,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EACxC,GAAG,KAAK,6BAA6B,CACtC,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["export type FaultCode =\n  | \"configuration\"\n  | \"process\"\n  | \"timeout\"\n  | \"aborted\"\n  | \"workspace\"\n  | \"conflict\"\n  | \"prompt\"\n  | \"response\"\n  | \"session\"\n  | \"provider\";\n\nexport class OutpostError extends Error {\n  recovery: Readonly<Record<string, unknown>> = {};\n  readonly code: FaultCode;\n  readonly details: Readonly<Record<string, unknown>>;\n  constructor(\n    code: FaultCode,\n    message: string,\n    details: Record<string, unknown> = {},\n    cause?: unknown,\n  ) {\n    super(message, { cause });\n    this.name = \"OutpostError\";\n    this.code = code;\n    this.details = Object.freeze({ ...details });\n  }\n}\n\nconst recoveryRecords = new WeakMap<\n  object,\n  Readonly<Record<string, unknown>>\n>();\n\nexport function recordRecovery(\n  error: unknown,\n  details: Record<string, unknown>,\n): void {\n  if (error && (typeof error === \"object\" || typeof error === \"function\")) {\n    const previous = recoveryDetails(error);\n    const recovery = Object.freeze({ ...previous, ...details });\n    recoveryRecords.set(error, recovery);\n    if (error instanceof OutpostError) error.recovery = recovery;\n  }\n}\n\nexport function recoveryDetails(\n  error: unknown,\n): Readonly<Record<string, unknown>> | undefined {\n  return error instanceof OutpostError\n    ? error.recovery\n    : error && (typeof error === \"object\" || typeof error === \"function\")\n      ? recoveryRecords.get(error)\n      : undefined;\n}\n\nexport function invariant(\n  condition: unknown,\n  message: string,\n): asserts condition {\n  if (!condition) throw new OutpostError(\"configuration\", message);\n}\n\nexport function positive(value: number, label: string): number {\n  invariant(\n    Number.isSafeInteger(value) && value > 0,\n    `${label} must be a positive integer`,\n  );\n  return value;\n}\n"]}

package/dist/domain/ports.d.ts

@@ -0,0 +1,183 @@
+import type { Readable, Writable } from "node:stream";
+export type Variables = Readonly<Record<string, string>>;
+export type Channel = "stdout" | "stderr";
+export interface Command {
+    readonly executable: string;
+    readonly arguments?: readonly string[];
+    readonly stdin?: string;
+    readonly directory?: string;
+    readonly variables?: Variables;
+    readonly signal?: AbortSignal;
+    readonly deadlineMs?: number;
+    readonly interactive?: boolean;
+    readonly terminal?: {
+        readonly input?: Readable;
+        readonly output?: Writable;
+        readonly error?: Writable;
+    };
+    readonly elevated?: boolean;
+    readonly retain?: number;
+    readonly observe?: (channel: Channel, text: string) => void;
+}
+export interface CommandResult {
+    readonly status: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface Volume {
+    readonly source: string;
+    readonly target: string;
+    readonly readOnly?: boolean;
+}
+export interface SandboxContext {
+    readonly repository: string;
+    readonly directory: string;
+    readonly gitDirectories: readonly string[];
+    readonly variables: Variables;
+    readonly signal?: AbortSignal;
+}
+export interface TransferOptions {
+    readonly signal?: AbortSignal;
+    readonly deadlineMs?: number;
+}
+export interface SandboxLease {
+    readonly root: string;
+    readonly home: string;
+    invoke(command: Command): Promise<CommandResult>;
+    upload(source: string, destination: string, options?: TransferOptions): Promise<void>;
+    download(source: string, destination: string, options?: TransferOptions): Promise<void>;
+    release(): Promise<void>;
+}
+export interface SandboxProvider {
+    readonly name: string;
+    readonly placement: "mounted" | "remote" | "host";
+    readonly variables?: Variables;
+    acquire(context: SandboxContext): Promise<SandboxLease>;
+}
+export interface Usage {
+    readonly input: number;
+    readonly cached: number;
+    readonly cacheCreated?: number;
+    readonly output: number;
+}
+export type AgentEvent = {
+    readonly kind: "phase";
+    readonly name: string;
+    readonly agent?: string;
+    readonly branch?: string;
+    readonly directory?: string;
+} | {
+    readonly kind: "summary";
+    readonly durationMs: number;
+    readonly status: number;
+    readonly tokens: Usage;
+} | {
+    readonly kind: "warning";
+    readonly message: string;
+} | {
+    readonly kind: "text";
+    readonly text: string;
+} | {
+    readonly kind: "result";
+    readonly text: string;
+} | {
+    readonly kind: "prompt";
+    readonly text: string;
+} | {
+    readonly kind: "tool";
+    readonly name: string;
+    readonly input: unknown;
+} | {
+    readonly kind: "conversation";
+    readonly id: string;
+} | {
+    readonly kind: "usage";
+    readonly tokens: Usage;
+} | {
+    readonly kind: "failure";
+    readonly message: string;
+} | {
+    readonly kind: "finished";
+} | {
+    readonly kind: "raw";
+    readonly value: unknown;
+};
+export type AgentObservation = AgentEvent & {
+    readonly pass: number;
+    readonly at: string;
+};
+export interface AgentInput {
+    readonly text?: string;
+    readonly interactive?: boolean;
+    readonly continuation?: {
+        readonly id: string;
+        readonly fork?: boolean;
+    };
+}
+export interface ConversationRecord {
+    readonly id: string;
+    readonly file: string;
+    readonly format: string;
+}
+export interface ConversationContext {
+    readonly repository: string;
+    readonly sandbox: SandboxLease;
+    readonly staging: string;
+    readonly home?: string;
+    readonly local?: boolean;
+    readonly warn?: (message: string) => void;
+}
+export interface ConversationStore {
+    readonly name: string;
+    locate(id: string, repository: string, home?: string): Promise<ConversationRecord>;
+    capture(id: string, context: ConversationContext): Promise<ConversationRecord>;
+    restore(record: ConversationRecord, context: ConversationContext): Promise<void>;
+}
+export interface AgentAdapter {
+    readonly name: string;
+    readonly variables?: Variables;
+    readonly conversations?: "claude" | "codex";
+    readonly storage?: ConversationStore;
+    readonly capture?: boolean;
+    readonly resumable?: boolean;
+    transcriptUsage?(text: string): Usage | undefined;
+    request(input: AgentInput): Command;
+    events(line: string): readonly AgentEvent[];
+}
+export interface StageLimits {
+    readonly copyMs?: number;
+    readonly gitMs?: number;
+    readonly collectMs?: number;
+    readonly mergeMs?: number;
+}
+export type BranchPolicy = {
+    readonly mode: "current";
+} | {
+    readonly mode: "named";
+    readonly name: string;
+    readonly from?: string;
+} | {
+    readonly mode: "integrate";
+    readonly from?: string;
+};
+export interface WorkspaceRecord {
+    readonly repository: string;
+    readonly directory: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly baseline: string;
+    readonly gitDirectories: readonly string[];
+    readonly policy: BranchPolicy;
+}
+export interface Commit {
+    readonly oid: string;
+    readonly subject: string;
+}
+export interface Disposal {
+    readonly retainedDirectory?: string;
+}
+export interface LifecycleHooks {
+    readonly workspaceReady?: readonly Command[];
+    readonly hostReady?: readonly Command[];
+    readonly sandboxReady?: readonly Command[];
+}

package/dist/domain/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/domain/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/domain/ports.ts"],"names":[],"mappings":"","sourcesContent":["import type { Readable, Writable } from \"node:stream\";\n\nexport type Variables = Readonly<Record<string, string>>;\nexport type Channel = \"stdout\" | \"stderr\";\n\nexport interface Command {\n  readonly executable: string;\n  readonly arguments?: readonly string[];\n  readonly stdin?: string;\n  readonly directory?: string;\n  readonly variables?: Variables;\n  readonly signal?: AbortSignal;\n  readonly deadlineMs?: number;\n  readonly interactive?: boolean;\n  readonly terminal?: {\n    readonly input?: Readable;\n    readonly output?: Writable;\n    readonly error?: Writable;\n  };\n  readonly elevated?: boolean;\n  readonly retain?: number;\n  readonly observe?: (channel: Channel, text: string) => void;\n}\n\nexport interface CommandResult {\n  readonly status: number;\n  readonly stdout: string;\n  readonly stderr: string;\n}\n\nexport interface Volume {\n  readonly source: string;\n  readonly target: string;\n  readonly readOnly?: boolean;\n}\n\nexport interface SandboxContext {\n  readonly repository: string;\n  readonly directory: string;\n  readonly gitDirectories: readonly string[];\n  readonly variables: Variables;\n  readonly signal?: AbortSignal;\n}\n\nexport interface TransferOptions {\n  readonly signal?: AbortSignal;\n  readonly deadlineMs?: number;\n}\n\nexport interface SandboxLease {\n  readonly root: string;\n  readonly home: string;\n  invoke(command: Command): Promise<CommandResult>;\n  upload(\n    source: string,\n    destination: string,\n    options?: TransferOptions,\n  ): Promise<void>;\n  download(\n    source: string,\n    destination: string,\n    options?: TransferOptions,\n  ): Promise<void>;\n  release(): Promise<void>;\n}\n\nexport interface SandboxProvider {\n  readonly name: string;\n  readonly placement: \"mounted\" | \"remote\" | \"host\";\n  readonly variables?: Variables;\n  acquire(context: SandboxContext): Promise<SandboxLease>;\n}\n\nexport interface Usage {\n  readonly input: number;\n  readonly cached: number;\n  readonly cacheCreated?: number;\n  readonly output: number;\n}\n\nexport type AgentEvent =\n  | {\n      readonly kind: \"phase\";\n      readonly name: string;\n      readonly agent?: string;\n      readonly branch?: string;\n      readonly directory?: string;\n    }\n  | {\n      readonly kind: \"summary\";\n      readonly durationMs: number;\n      readonly status: number;\n      readonly tokens: Usage;\n    }\n  | { readonly kind: \"warning\"; readonly message: string }\n  | { readonly kind: \"text\"; readonly text: string }\n  | { readonly kind: \"result\"; readonly text: string }\n  | { readonly kind: \"prompt\"; readonly text: string }\n  | { readonly kind: \"tool\"; readonly name: string; readonly input: unknown }\n  | { readonly kind: \"conversation\"; readonly id: string }\n  | { readonly kind: \"usage\"; readonly tokens: Usage }\n  | { readonly kind: \"failure\"; readonly message: string }\n  | { readonly kind: \"finished\" }\n  | { readonly kind: \"raw\"; readonly value: unknown };\n\nexport type AgentObservation = AgentEvent & {\n  readonly pass: number;\n  readonly at: string;\n};\n\nexport interface AgentInput {\n  readonly text?: string;\n  readonly interactive?: boolean;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n}\n\nexport interface ConversationRecord {\n  readonly id: string;\n  readonly file: string;\n  readonly format: string;\n}\n\nexport interface ConversationContext {\n  readonly repository: string;\n  readonly sandbox: SandboxLease;\n  readonly staging: string;\n  readonly home?: string;\n  readonly local?: boolean;\n  readonly warn?: (message: string) => void;\n}\n\nexport interface ConversationStore {\n  readonly name: string;\n  locate(\n    id: string,\n    repository: string,\n    home?: string,\n  ): Promise<ConversationRecord>;\n  capture(\n    id: string,\n    context: ConversationContext,\n  ): Promise<ConversationRecord>;\n  restore(\n    record: ConversationRecord,\n    context: ConversationContext,\n  ): Promise<void>;\n}\n\nexport interface AgentAdapter {\n  readonly name: string;\n  readonly variables?: Variables;\n  readonly conversations?: \"claude\" | \"codex\";\n  readonly storage?: ConversationStore;\n  readonly capture?: boolean;\n  readonly resumable?: boolean;\n  transcriptUsage?(text: string): Usage | undefined;\n  request(input: AgentInput): Command;\n  events(line: string): readonly AgentEvent[];\n}\n\nexport interface StageLimits {\n  readonly copyMs?: number;\n  readonly gitMs?: number;\n  readonly collectMs?: number;\n  readonly mergeMs?: number;\n}\n\nexport type BranchPolicy =\n  | { readonly mode: \"current\" }\n  | { readonly mode: \"named\"; readonly name: string; readonly from?: string }\n  | { readonly mode: \"integrate\"; readonly from?: string };\n\nexport interface WorkspaceRecord {\n  readonly repository: string;\n  readonly directory: string;\n  readonly branch: string;\n  readonly baseBranch: string;\n  readonly baseline: string;\n  readonly gitDirectories: readonly string[];\n  readonly policy: BranchPolicy;\n}\n\nexport interface Commit {\n  readonly oid: string;\n  readonly subject: string;\n}\n\nexport interface Disposal {\n  readonly retainedDirectory?: string;\n}\n\nexport interface LifecycleHooks {\n  readonly workspaceReady?: readonly Command[];\n  readonly hostReady?: readonly Command[];\n  readonly sandboxReady?: readonly Command[];\n}\n"]}