@snappedly-tools/shipyard 0.4.4 → 0.5.0

package/README.md

@@ -4,204 +4,157 @@
   <img src="assets/brand/shipyard-robot-on-boat.png" alt="A friendly robot steering a blue boat for Shipyard" width="320">
 </p>
 
-> **Source-available toolkit for running AI coding agents in isolated sandboxes.**
+> **Fully autonomous coding workflows, protected by Docker.**
 
 [![CI](https://github.com/snappedly/shipyard/actions/workflows/ci.yml/badge.svg)](https://github.com/snappedly/shipyard/actions/workflows/ci.yml)
 
-Shipyard runs AI coding agents in isolated sandboxes. Choose an agent, a
-sandbox provider, and a prompt; Shipyard manages the sandbox lifecycle,
-branches, logs, sessions, and commits.
+Give Shipyard a backlog and a policy. It plans dependencies, runs AI coding
+agents in isolated sandboxes, reviews their work, and returns reviewable
+commits—without babysitting.
 
-## Why Shipyard
+## The Shipyard advantage
 
-- **Isolated by default.** Keep agent work inside Docker locally or Vercel
-  Sandbox remotely.
-- **Purpose-built agents.** Use Codex or Claude Code without carrying support
-  for unrelated coding-agent CLIs.
-- **Reviewable changes.** Control how branches and worktrees move changes back
-  to the host repository.
+Most agent setups launch a CLI and hope for the best. Shipyard is the control
+plane around the agent:
 
-## Quick start
+- **Protected execution:** Run Codex or Claude Code in an isolated Docker-backed
+  sandbox with explicit mounts, credentials, and network access.
+- **Real orchestration:** Plan dependencies, parallelize safe work, leave
+  blocked work alone, review each branch, and merge completed work.
+- **Failure-aware by design:** Use finite budgets, no-progress detection,
+  cancellation, logs, and recovery artifacts instead of runaway loops.
+- **Reviewable output:** Runs preserve branches, worktrees, logs, and evidence;
+  completed work comes back as commits. You keep control of the repository and
+  the final release.
 
-You need Node.js 20.18.1 or newer, Git, Docker, and credentials for your chosen
-coding agent.
-Run these commands inside the Git repository the agent should change:
+## Install and run
+
+Requirements: Node.js 20.18.1+, Git, Docker, and credentials for your chosen
+agent. Run these commands in the repository Shipyard should change:
 
 ```sh
 npm install --save-dev @snappedly-tools/shipyard
 npx shipyard init
-cp .shipyard/.env.example .shipyard/.env
 ```
 
-`init` asks which agent, sandbox provider, and starter template to use. Its
-issue-based templates use GitHub Issues. When you select Codex, it also asks
-whether to sign in with ChatGPT or use an API key. Start with the `blank`
-template. Put any requested credentials in `.shipyard/.env`, then write one
-concrete task in `.shipyard/prompt.md`.
+`init` asks for the agent, authentication, sandbox, issue tracker, and workflow
+template, then creates `.shipyard/`. For the first run, choose Docker and
+`blank` or `sequential-reviewer`.
 
-Run it:
+Add the requested credentials to `.shipyard/.env`, write a task in
+`.shipyard/prompt.md` when using the `blank` template, then run:
 
 ```sh
 npx shipyard run
 ```
 
-`shipyard run` builds the generated Docker image, executes the
-generated TypeScript entry point, and cleans up the sandbox. Reuse the cached
-image when its definition has not changed:
+The first run builds the Docker image automatically. Reuse it when the
+Dockerfile has not changed:
 
 ```sh
 npx shipyard run --skip-build
 ```
 
-Inspect the generated branch strategy and start from a clean working tree. A
-completion marker means the agent stopped; inspect its commits and run the
-repository's checks before keeping the result.
+For Codex, `init` can sign in with a ChatGPT subscription or configure an OpenAI
+API key. Claude Code supports a subscription token or an Anthropic API key. See
+the [agent guide](docs/content/docs/agents.mdx) for authentication details.
 
-## JavaScript API
+## Pick the workflow you need
 
-The generated `.shipyard/main.ts` or `.shipyard/main.mts` is ordinary
-TypeScript:
+| Template                       | Best for              | Built-in flow                                     |
+| ------------------------------ | --------------------- | ------------------------------------------------- |
+| `blank`                        | One custom task       | One agent run                                     |
+| `simple-loop`                  | A small issue backlog | Implement issues sequentially                     |
+| `sequential-reviewer`          | Safer issue delivery  | Implement → review, one issue at a time           |
+| `parallel-planner`             | Independent issues    | Plan dependencies → implement in parallel → merge |
+| `parallel-planner-with-review` | Maximum autonomy      | Plan → implement and review in parallel → merge   |
 
-```ts
-import { CODEX_MODELS, codex, run } from "@snappedly-tools/shipyard";
-import { docker } from "@snappedly-tools/shipyard/sandboxes/docker";
+All templates are generated TypeScript. Adjust prompts, models, iteration
+limits, branch strategy, hooks, and checks in `.shipyard/main.ts` or
+`.shipyard/main.mts`.
 
-const result = await run({
-  agent: codex(CODEX_MODELS.routine),
-  sandbox: docker(),
-  promptFile: ".shipyard/prompt.md",
-});
+## Keep a repository running
 
-console.log(result.commits);
-```
+On Apple Silicon macOS, the optional repository runner keeps a foreground
+Shipyard controller ready for GitHub Issues. Label an issue `shipyard`; the
+controller wakes, drains a finite batch of eligible work, coalesces duplicate
+wake-ups, and stops when it makes no progress. Restarting it recovers work
+labelled while the host was offline.
 
-Use a dedicated branch when the scaffold has already been committed:
+Accept runner installation during `init`, or install it later:
 
-```ts
-const result = await run({
-  agent: codex(CODEX_MODELS.routine),
-  sandbox: docker(),
-  promptFile: ".shipyard/prompt.md",
-  branchStrategy: { type: "branch", branch: "agent/my-task" },
-  maxIterations: 1,
-  logging: { type: "stdout" },
-});
+```sh
+npx shipyard runner install
+git add .github/workflows/shipyard-wake.yml .shipyard/.gitignore
+git commit -m "Add Shipyard wake workflow"
+git push
+npx shipyard runner start
 ```
 
-Shipyard supports Codex and Claude Code agents, with Docker, Vercel Sandbox,
-and no-sandbox providers. `shipyard init` scaffolds Docker; configure Vercel
-Sandbox or no-sandbox mode through the JavaScript interface.
+Run `npx shipyard runner purge` to remove every dated run-log folder and
+root-level `.log` file under `.shipyard/logs/`. Shipyard automatically removes
+entries older than eight days before `shipyard run`, at runner startup, and
+daily while the runner stays active. Use a path outside `.shipyard/logs/` for
+logs that must be retained separately.
+
+See the [repository runner guide](docs/content/docs/repository-runner.mdx) for
+requirements, lifecycle commands, and the security model.
 
-To run directly on the host without isolation:
+## Build your own coordinator
+
+Shipyard is also a TypeScript library. Compose your own workflow with
+`run()`, `createSandbox()`, and `createWorktree()` while reusing its agent,
+sandbox, branch, prompt, logging, cancellation, and session primitives.
 
 ```ts
 import { CODEX_MODELS, codex, run } from "@snappedly-tools/shipyard";
-import { noSandbox } from "@snappedly-tools/shipyard/sandboxes/no-sandbox";
+import { docker } from "@snappedly-tools/shipyard/sandboxes/docker";
 
-const result = await run({
+await run({
   agent: codex(CODEX_MODELS.routine),
-  sandbox: noSandbox(),
+  sandbox: docker(),
   promptFile: ".shipyard/prompt.md",
 });
 ```
 
-No-sandbox mode grants the agent the permissions of the Shipyard process. Use
-it only with trusted repositories and prompts.
-
-## Branch behavior
-
-Docker keeps the repository and Git metadata inside the sandbox. It starts
-from committed history and syncs changes back. The generated blank
-template omits `branchStrategy`, which defaults to `merge-to-head`: commits
-are transferred to a temporary host branch and merged into your current
-branch. Direct `head` mode is not supported by Docker or Vercel Sandbox.
-
-The explicit `branch` strategy keeps commits on the named branch for review.
-Commit input files before either strategy, or use `copyToWorktree` for specific
-untracked or ignored files.
-
-## Authentication
-
-`shipyard init` generates the environment variables and mounts required by
-the chosen agent. Keep `.shipyard/.env`, agent login files, logs, and recovery
-patches private.
-
-Use a subscription first when the selected agent supports it. If subscription
-authentication does not work in your environment, use the API-key fallback:
-
-- Codex subscription authentication: choose **Sign in with ChatGPT** during
-  interactive init and complete the browser login. The generated configuration
-  mounts `~/.codex/auth.json` read-only. For non-interactive init, run
-  `codex login` on the host, then pass `--codex-auth chatgpt`.
-- Codex API authentication: choose **OpenAI API key** during interactive init
-  and put `OPENAI_API_KEY` in `.shipyard/.env`. For non-interactive init, pass
-  `--codex-auth api-key`.
-- Claude Code subscription authentication: run `claude setup-token` on the
-  host and put the result in `CLAUDE_CODE_OAUTH_TOKEN` in `.shipyard/.env`.
-- Claude Code API authentication: uncomment `ANTHROPIC_API_KEY` in
-  `.shipyard/.env` and put your API key there.
-- GitHub Issues authentication: set `GH_TOKEN` in `.shipyard/.env`. To use the
-  token from a host-side `gh auth login` without storing it in the file, leave
-  `GH_TOKEN=` blank and run `GH_TOKEN="$(gh auth token)" npx shipyard run`.
-
-## Generated files
+Docker is the default path. Vercel Sandbox is available for isolated cloud
+execution; `noSandbox()` is available only for trusted repositories and prompts.
 
-| Path                              | Purpose                                                      |
-| --------------------------------- | ------------------------------------------------------------ |
-| `.shipyard/main.ts` or `main.mts` | Agent, sandbox, prompt, branch, hook, and iteration settings |
-| `.shipyard/prompt.md`             | Task given to the agent                                      |
-| `.shipyard/Dockerfile`            | Sandbox image definition                                     |
-| `.shipyard/.env`                  | Untracked credentials passed into the sandbox                |
-| `.shipyard/logs/`                 | Run logs                                                     |
-| `.shipyard/worktrees/`            | Worktrees for separate-branch runs                           |
-| `.shipyard/patches/`              | Recovery artifacts preserved after some failures             |
+## What gets created
 
-## Workflow templates
-
-The bundled templates are:
-
-- `blank`: one agent and your prompt;
-- `simple-loop`: process issue-tracker tasks sequentially;
-- `sequential-reviewer`: implement and review each task;
-- `parallel-planner`: plan parallel work and merge its branches; and
-- `parallel-planner-with-review`: add review to each parallel branch.
-
-Read generated prompts before running an issue or merge workflow. Those
-templates can close issues, create branches, and merge work.
-
-The package also exports contracts for triage, implementation, review,
-repair, handoff, and release recording. They are building blocks for hosted
-automation, not a hosted service started by the quick-start commands.
-
-## Security
-
-Agents receive the permissions granted by their sandbox, mounts, credentials,
-and hooks. Docker isolates repository and Git storage; it does not
-mount the host checkout or Git metadata automatically. Explicit mounts must
-stay outside the sandbox workspace and its ancestors.
+```text
+.shipyard/
+├── main.ts or main.mts   # workflow configuration
+├── prompt.md              # task or issue instructions
+├── Dockerfile             # sandbox image definition
+├── .env                   # untracked credentials
+├── logs/                  # run logs
+├── worktrees/             # isolated branch worktrees
+└── patches/               # recovery artifacts
+```
 
-Mounted credentials, devices, Docker sockets, groups, and network access can
-still broaden an agent's access. Host hooks, no-sandbox mode, and custom
-provider code retain their own trust requirements. Use
-least-privilege credentials and review generated configuration before running
-untrusted code.
+## Security and control
 
-See the [security evaluation](docs/security-evaluation.md) for findings,
-fixes, and validation limits. Report vulnerabilities according to
-[SECURITY.md](SECURITY.md).
+Docker keeps the agent's repository and Git storage inside the sandbox by
+default. It is not a magic security boundary: mounts, credentials, devices,
+network access, host hooks, and `noSandbox()` can expand what an agent can do.
+Use least-privilege credentials and review generated configuration before
+running untrusted code. Read the [security evaluation](docs/security-evaluation.md)
+and [SECURITY.md](SECURITY.md).
 
-## Contributing
+Shipyard runs in your infrastructure. There is no required hosted control
+plane; you control the host, Docker, model access, logs, and release policy.
 
-See [CONTRIBUTING.md](CONTRIBUTING.md). The standard repository check is:
+## Learn more
 
-```sh
-npm ci
-npm run check
-```
+- [Getting started](docs/content/docs/index.mdx)
+- [Configuration](docs/content/docs/configuration.mdx)
+- [Repository runner operations](docs/runbooks/repository-runner-macos-validation.md)
+- [Contributing](CONTRIBUTING.md)
 
 ## License
 
 Shipyard is source-available under the
 [PolyForm Strict License 1.0.0](LICENSE). It is available for permitted
-noncommercial use; the license does not permit redistribution, modification,
-or derivative works. Contact Snappedly to request a commercial license.
+noncommercial use; the license does not permit redistribution, modification, or
+derivative works. Contact Snappedly to request a commercial license.

package/dist/chunk-56TDSWFU.js

@@ -0,0 +1,255 @@
+import { CONFIG_DIR, ConfigDirError, assertNoSymlinkComponents, LOGS_DIR, Display } from './chunk-FDYOTN55.js';
+import { Effect } from 'effect';
+import { FileSystem } from '@effect/platform';
+import { join } from 'path';
+import { readdir, lstat, rm } from 'fs/promises';
+
+var formatErrorMessage = (error) => {
+  switch (error._tag) {
+    case "ExecError":
+      return `Command failed in sandbox (${error.command}): ${error.message}`;
+    case "ExecHostError":
+      return `Command failed on host (${error.command}): ${error.message}`;
+    case "CopyError":
+      return `File copy failed: ${error.message}`;
+    case "DockerError":
+      return `Docker operation failed: ${error.message}. Is Docker running?`;
+    case "SyncError":
+      return `Git sync failed: ${error.message}`;
+    case "WorktreeError":
+      return `Git worktree operation failed: ${error.message}`;
+    case "PromptError":
+      return `Failed to resolve prompt: ${error.message}`;
+    case "AgentError":
+      return `Agent invocation failed: ${error.message}`;
+    case "ConfigDirError":
+      return `${error.message}`;
+    case "InitError":
+      return `${error.message}`;
+    case "AgentIdleTimeoutError":
+    case "WorktreeTimeoutError":
+    case "ContainerStartTimeoutError":
+    case "CopyToWorktreeTimeoutError":
+    case "CopyToWorktreeError":
+    case "SyncInTimeoutError":
+    case "HookTimeoutError":
+    case "GitSetupTimeoutError":
+    case "PromptExpansionTimeoutError":
+    case "CommitCollectionTimeoutError":
+    case "MergeToHostTimeoutError":
+    case "SessionCaptureError":
+    case "CwdError":
+      return error.message;
+  }
+};
+var showErrorAndExit = (error) => Effect.gen(function* () {
+  const d = yield* Display;
+  yield* d.status(formatErrorMessage(error), "error");
+  return yield* Effect.sync(() => process.exit(1));
+});
+var withFriendlyErrors = (effect) => (
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Effect.catchTags(effect, {
+    ExecError: showErrorAndExit,
+    ExecHostError: showErrorAndExit,
+    CopyError: showErrorAndExit,
+    DockerError: showErrorAndExit,
+    SyncError: showErrorAndExit,
+    WorktreeError: showErrorAndExit,
+    PromptError: showErrorAndExit,
+    AgentError: showErrorAndExit,
+    ConfigDirError: showErrorAndExit,
+    InitError: showErrorAndExit,
+    AgentIdleTimeoutError: showErrorAndExit,
+    WorktreeTimeoutError: showErrorAndExit,
+    ContainerStartTimeoutError: showErrorAndExit,
+    CopyToWorktreeTimeoutError: showErrorAndExit,
+    CopyToWorktreeError: showErrorAndExit,
+    SyncInTimeoutError: showErrorAndExit,
+    HookTimeoutError: showErrorAndExit,
+    GitSetupTimeoutError: showErrorAndExit,
+    PromptExpansionTimeoutError: showErrorAndExit,
+    CommitCollectionTimeoutError: showErrorAndExit,
+    MergeToHostTimeoutError: showErrorAndExit,
+    SessionCaptureError: showErrorAndExit,
+    CwdError: showErrorAndExit
+  })
+);
+
+// src/modelConfig.ts
+var CODEX_REASONING_EFFORTS = [
+  "low",
+  "medium",
+  "high",
+  "xhigh",
+  "max"
+];
+var DEFAULT_CODEX_MODELS = {
+  routine: { model: "gpt-5.6-luna", effort: "max" },
+  strong: { model: "gpt-5.6-sol", effort: "max" }
+};
+var readModel = (role) => process.env[`SHIPYARD_CODEX_${role.toUpperCase()}_MODEL`]?.trim() || DEFAULT_CODEX_MODELS[role].model;
+var readEffort = (role) => {
+  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_REASONING_EFFORT`;
+  const value = process.env[envName]?.trim();
+  if (!value) return DEFAULT_CODEX_MODELS[role].effort;
+  if (CODEX_REASONING_EFFORTS.includes(value)) {
+    return value;
+  }
+  throw new Error(
+    `${envName} must be one of ${CODEX_REASONING_EFFORTS.join(", ")}; received "${value}"`
+  );
+};
+var CODEX_MODELS = {
+  routine: {
+    model: readModel("routine"),
+    effort: readEffort("routine")
+  },
+  strong: {
+    model: readModel("strong"),
+    effort: readEffort("strong")
+  }
+};
+var parseEnvFile = (filePath) => Effect.gen(function* () {
+  const fs = yield* FileSystem.FileSystem;
+  const symlink = yield* fs.readLink(filePath).pipe(
+    Effect.map(() => true),
+    Effect.catchAll(() => Effect.succeed(false))
+  );
+  if (symlink) return {};
+  const content = yield* fs.readFileString(filePath).pipe(Effect.catchAll(() => Effect.succeed(null)));
+  if (content === null) return {};
+  const vars = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    let value = trimmed.slice(eqIndex + 1).trim();
+    const isDoubleQuoted = value.length >= 2 && value[0] === '"' && value[value.length - 1] === '"';
+    const isSingleQuoted = value.length >= 2 && value[0] === "'" && value[value.length - 1] === "'";
+    if (isDoubleQuoted || isSingleQuoted) {
+      value = value.slice(1, -1);
+    }
+    if (isDoubleQuoted) {
+      value = value.replace(/\\([nrt\\])/g, (_, ch) => {
+        const escapes = {
+          n: "\n",
+          r: "\r",
+          t: "	",
+          "\\": "\\"
+        };
+        return escapes[ch] ?? ch;
+      });
+    }
+    vars[key] = value;
+  }
+  return vars;
+});
+var resolveEnv = (repoDir) => Effect.gen(function* () {
+  const configDir = join(repoDir, CONFIG_DIR);
+  const envPath = join(configDir, ".env");
+  yield* Effect.tryPromise({
+    try: () => assertNoSymlinkComponents(repoDir, envPath, "environment file"),
+    catch: (e) => new ConfigDirError({
+      message: `Refusing symlinked environment path: ${e instanceof Error ? e.message : String(e)}`
+    })
+  });
+  const shipyardEnv = yield* parseEnvFile(envPath);
+  const result = {};
+  for (const key of Object.keys(shipyardEnv)) {
+    const value = shipyardEnv[key] || process.env[key];
+    if (value) {
+      result[key] = value;
+    }
+  }
+  return result;
+});
+var DEFAULT_LOG_RETENTION_DAYS = 8;
+var LOG_DIRECTORY_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+var buildLogDirectoryName = (date = /* @__PURE__ */ new Date()) => {
+  if (Number.isNaN(date.getTime())) {
+    throw new Error("Cannot build a log directory name from an invalid date.");
+  }
+  const pad = (value) => String(value).padStart(2, "0");
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+};
+var parseLogDirectoryDate = (name) => {
+  const match = LOG_DIRECTORY_PATTERN.exec(name);
+  if (!match) return void 0;
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  const date = new Date(year, month - 1, day);
+  return date.getFullYear() === year && date.getMonth() === month - 1 && date.getDate() === day ? date : void 0;
+};
+var validateRetentionDays = (retentionDays) => {
+  if (!Number.isSafeInteger(retentionDays) || retentionDays < 0) {
+    throw new Error("Log retention days must be a non-negative integer.");
+  }
+};
+var purgeRunLogs = async (options) => {
+  const retentionDays = options.retentionDays;
+  if (retentionDays !== void 0) validateRetentionDays(retentionDays);
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  if (retentionDays !== void 0 && Number.isNaN(now.getTime())) {
+    throw new Error("Cannot purge logs using an invalid date.");
+  }
+  const cutoff = retentionDays === void 0 ? void 0 : new Date(
+    now.getFullYear(),
+    now.getMonth(),
+    now.getDate() - retentionDays
+  );
+  const cutoffDate = cutoff === void 0 ? void 0 : buildLogDirectoryName(cutoff);
+  const logsDir = join(options.repoDir, CONFIG_DIR, LOGS_DIR);
+  let entries;
+  try {
+    entries = await readdir(logsDir, { withFileTypes: true });
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return {
+        logsDir,
+        ...retentionDays === void 0 ? {} : { retentionDays, cutoffDate },
+        scannedDirectories: 0,
+        removedCount: 0,
+        removedDirectories: [],
+        removedFiles: []
+      };
+    }
+    throw error;
+  }
+  const removedDirectories = [];
+  const removedFiles = [];
+  let scannedDirectories = 0;
+  for (const entry of entries) {
+    const entryPath = join(logsDir, entry.name);
+    if (entry.isFile() && entry.name.endsWith(".log")) {
+      const file = await lstat(entryPath);
+      if (file.isFile() && (cutoff === void 0 || file.mtime < cutoff)) {
+        await rm(entryPath, { force: true });
+        removedFiles.push(entry.name);
+      }
+      continue;
+    }
+    if (!entry.isDirectory()) continue;
+    const directoryDate = parseLogDirectoryDate(entry.name);
+    if (directoryDate === void 0) continue;
+    scannedDirectories += 1;
+    if (cutoff !== void 0 && directoryDate >= cutoff) continue;
+    await rm(entryPath, { recursive: true, force: true });
+    removedDirectories.push(entry.name);
+  }
+  return {
+    logsDir,
+    ...retentionDays === void 0 ? {} : { retentionDays, cutoffDate },
+    scannedDirectories,
+    removedCount: removedDirectories.length + removedFiles.length,
+    removedDirectories,
+    removedFiles
+  };
+};
+
+export { CODEX_MODELS, CODEX_REASONING_EFFORTS, DEFAULT_LOG_RETENTION_DAYS, buildLogDirectoryName, formatErrorMessage, purgeRunLogs, resolveEnv, withFriendlyErrors };
+//# sourceMappingURL=chunk-56TDSWFU.js.map
+//# sourceMappingURL=chunk-56TDSWFU.js.map

package/dist/chunk-56TDSWFU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ErrorHandler.ts","../src/modelConfig.ts","../src/EnvResolver.ts","../src/LogRetention.ts"],"names":["Effect","join"],"mappings":"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","file":"chunk-56TDSWFU.js","sourcesContent":["import { Effect } from \"effect\";\nimport { Display } from \"./Display.js\";\nimport type { SandboxError } from \"./errors.js\";\n\n/**\n * Formats a tagged SandboxError into a user-friendly message with\n * context-specific hints about what went wrong and how to recover.\n */\nexport const formatErrorMessage = (error: SandboxError): string => {\n  switch (error._tag) {\n    case \"ExecError\":\n      return `Command failed in sandbox (${error.command}): ${error.message}`;\n    case \"ExecHostError\":\n      return `Command failed on host (${error.command}): ${error.message}`;\n    case \"CopyError\":\n      return `File copy failed: ${error.message}`;\n    case \"DockerError\":\n      return `Docker operation failed: ${error.message}. Is Docker running?`;\n    case \"SyncError\":\n      return `Git sync failed: ${error.message}`;\n    case \"WorktreeError\":\n      return `Git worktree operation failed: ${error.message}`;\n    case \"PromptError\":\n      return `Failed to resolve prompt: ${error.message}`;\n    case \"AgentError\":\n      return `Agent invocation failed: ${error.message}`;\n    case \"ConfigDirError\":\n      return `${error.message}`;\n    case \"InitError\":\n      return `${error.message}`;\n    case \"AgentIdleTimeoutError\":\n    case \"WorktreeTimeoutError\":\n    case \"ContainerStartTimeoutError\":\n    case \"CopyToWorktreeTimeoutError\":\n    case \"CopyToWorktreeError\":\n    case \"SyncInTimeoutError\":\n    case \"HookTimeoutError\":\n    case \"GitSetupTimeoutError\":\n    case \"PromptExpansionTimeoutError\":\n    case \"CommitCollectionTimeoutError\":\n    case \"MergeToHostTimeoutError\":\n    case \"SessionCaptureError\":\n    case \"CwdError\":\n      return error.message;\n  }\n};\n\nconst showErrorAndExit = (error: SandboxError) =>\n  Effect.gen(function* () {\n    const d = yield* Display;\n    yield* d.status(formatErrorMessage(error), \"error\");\n    return yield* Effect.sync(() => process.exit(1) as never);\n  });\n\n/**\n * Wraps an effect so that any SandboxError is caught, displayed via the\n * Display service as an error-severity status message, then exits the process\n * with code 1. Non-SandboxError errors pass through unchanged.\n */\nexport const withFriendlyErrors = <A, E, R>(\n  effect: Effect.Effect<A, E, R>,\n): Effect.Effect<A, Exclude<E, SandboxError>, R | Display> =>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  Effect.catchTags(effect as Effect.Effect<A, SandboxError, R>, {\n    ExecError: showErrorAndExit,\n    ExecHostError: showErrorAndExit,\n    CopyError: showErrorAndExit,\n    DockerError: showErrorAndExit,\n    SyncError: showErrorAndExit,\n    WorktreeError: showErrorAndExit,\n    PromptError: showErrorAndExit,\n    AgentError: showErrorAndExit,\n    ConfigDirError: showErrorAndExit,\n    InitError: showErrorAndExit,\n    AgentIdleTimeoutError: showErrorAndExit,\n    WorktreeTimeoutError: showErrorAndExit,\n    ContainerStartTimeoutError: showErrorAndExit,\n    CopyToWorktreeTimeoutError: showErrorAndExit,\n    CopyToWorktreeError: showErrorAndExit,\n    SyncInTimeoutError: showErrorAndExit,\n    HookTimeoutError: showErrorAndExit,\n    GitSetupTimeoutError: showErrorAndExit,\n    PromptExpansionTimeoutError: showErrorAndExit,\n    CommitCollectionTimeoutError: showErrorAndExit,\n    MergeToHostTimeoutError: showErrorAndExit,\n    SessionCaptureError: showErrorAndExit,\n    CwdError: showErrorAndExit,\n  }) as Effect.Effect<A, Exclude<E, SandboxError>, R | Display>;\n","/** Reasoning efforts accepted by the Codex CLI. */\nexport const CODEX_REASONING_EFFORTS = [\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n  \"max\",\n] as const;\n\nexport type CodexReasoningEffort = (typeof CODEX_REASONING_EFFORTS)[number];\n\n/** A model identifier plus the reasoning policy used for that model role. */\nexport interface CodexModelConfig {\n  readonly model: string;\n  readonly effort: CodexReasoningEffort;\n}\n\n/**\n * Default values for Shipyard's built-in Codex roles.\n *\n * Runtime environment variables override these defaults:\n *   SHIPYARD_CODEX_ROUTINE_MODEL\n *   SHIPYARD_CODEX_ROUTINE_REASONING_EFFORT\n *   SHIPYARD_CODEX_STRONG_MODEL\n *   SHIPYARD_CODEX_STRONG_REASONING_EFFORT\n *\n * Keep the defaults here so runtime providers, generated templates, and the\n * repository workflows all use the same role definitions.\n */\nconst DEFAULT_CODEX_MODELS = {\n  routine: { model: \"gpt-5.6-luna\", effort: \"max\" },\n  strong: { model: \"gpt-5.6-sol\", effort: \"max\" },\n} as const satisfies Record<string, CodexModelConfig>;\n\nconst readModel = (role: keyof typeof DEFAULT_CODEX_MODELS): string =>\n  process.env[`SHIPYARD_CODEX_${role.toUpperCase()}_MODEL`]?.trim() ||\n  DEFAULT_CODEX_MODELS[role].model;\n\nconst readEffort = (\n  role: keyof typeof DEFAULT_CODEX_MODELS,\n): CodexReasoningEffort => {\n  const envName = `SHIPYARD_CODEX_${role.toUpperCase()}_REASONING_EFFORT`;\n  const value = process.env[envName]?.trim();\n  if (!value) return DEFAULT_CODEX_MODELS[role].effort;\n  if ((CODEX_REASONING_EFFORTS as readonly string[]).includes(value)) {\n    return value as CodexReasoningEffort;\n  }\n  throw new Error(\n    `${envName} must be one of ${CODEX_REASONING_EFFORTS.join(\", \")}; received \"${value}\"`,\n  );\n};\n\nexport const CODEX_MODELS = {\n  routine: {\n    model: readModel(\"routine\"),\n    effort: readEffort(\"routine\"),\n  },\n  strong: {\n    model: readModel(\"strong\"),\n    effort: readEffort(\"strong\"),\n  },\n} as const satisfies Record<string, CodexModelConfig>;\n","import { FileSystem } from \"@effect/platform\";\nimport { Effect } from \"effect\";\nimport { join } from \"node:path\";\n\nimport { ConfigDirError } from \"./errors.js\";\nimport { assertNoSymlinkComponents } from \"./pathSecurity.js\";\nimport { CONFIG_DIR } from \"./runtimeNames.js\";\n\nconst parseEnvFile = (\n  filePath: string,\n): Effect.Effect<Record<string, string>, never, FileSystem.FileSystem> =>\n  Effect.gen(function* () {\n    const fs = yield* FileSystem.FileSystem;\n    const symlink = yield* fs.readLink(filePath).pipe(\n      Effect.map(() => true),\n      Effect.catchAll(() => Effect.succeed(false)),\n    );\n    // A repository-controlled symlink could redirect this read to a host\n    // secret and then expose matching keys to the agent.\n    if (symlink) return {};\n    const content = yield* fs\n      .readFileString(filePath)\n      .pipe(Effect.catchAll(() => Effect.succeed(null)));\n    if (content === null) return {};\n    const vars: Record<string, string> = {};\n    for (const line of content.split(\"\\n\")) {\n      const trimmed = line.trim();\n      if (!trimmed || trimmed.startsWith(\"#\")) continue;\n      const eqIndex = trimmed.indexOf(\"=\");\n      if (eqIndex === -1) continue;\n      const key = trimmed.slice(0, eqIndex).trim();\n      let value = trimmed.slice(eqIndex + 1).trim();\n      const isDoubleQuoted =\n        value.length >= 2 &&\n        value[0] === '\"' &&\n        value[value.length - 1] === '\"';\n      const isSingleQuoted =\n        value.length >= 2 &&\n        value[0] === \"'\" &&\n        value[value.length - 1] === \"'\";\n      if (isDoubleQuoted || isSingleQuoted) {\n        value = value.slice(1, -1);\n      }\n      if (isDoubleQuoted) {\n        value = value.replace(/\\\\([nrt\\\\])/g, (_, ch: string) => {\n          const escapes: Record<string, string> = {\n            n: \"\\n\",\n            r: \"\\r\",\n            t: \"\\t\",\n            \"\\\\\": \"\\\\\",\n          };\n          return escapes[ch] ?? ch;\n        });\n      }\n      vars[key] = value;\n    }\n    return vars;\n  });\n\n/**\n * Resolve all env vars from .env files with process.env fallback.\n *\n * Precedence: .shipyard/.env > process.env\n * Only keys declared in .shipyard/.env are resolved from process.env.\n * Repo root .env is not part of the resolution chain.\n */\nexport const resolveEnv = (\n  repoDir: string,\n): Effect.Effect<\n  Record<string, string>,\n  ConfigDirError,\n  FileSystem.FileSystem\n> =>\n  Effect.gen(function* () {\n    const configDir = join(repoDir, CONFIG_DIR);\n    const envPath = join(configDir, \".env\");\n    yield* Effect.tryPromise({\n      try: () =>\n        assertNoSymlinkComponents(repoDir, envPath, \"environment file\"),\n      catch: (e) =>\n        new ConfigDirError({\n          message: `Refusing symlinked environment path: ${e instanceof Error ? e.message : String(e)}`,\n        }),\n    });\n    const shipyardEnv = yield* parseEnvFile(envPath);\n\n    const result: Record<string, string> = {};\n    for (const key of Object.keys(shipyardEnv)) {\n      // A blank placeholder falls back to process.env, so callers can source\n      // credentials from a host login for one invocation, e.g.\n      // `GH_TOKEN=\"$(gh auth token)\" npx shipyard run`. Only keys declared in\n      // .shipyard/.env are eligible for this fallback.\n      const value = shipyardEnv[key] || process.env[key];\n      if (value) {\n        result[key] = value;\n      }\n    }\n\n    return result;\n  });\n","import { lstat, readdir, rm } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { CONFIG_DIR, LOGS_DIR } from \"./runtimeNames.js\";\n\n/** The default age threshold for automatic run-log purges. */\nexport const DEFAULT_LOG_RETENTION_DAYS = 8;\n\nconst LOG_DIRECTORY_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\n/** Build the local calendar date directory used for default run logs. */\nexport const buildLogDirectoryName = (date: Date = new Date()): string => {\n  if (Number.isNaN(date.getTime())) {\n    throw new Error(\"Cannot build a log directory name from an invalid date.\");\n  }\n  const pad = (value: number): string => String(value).padStart(2, \"0\");\n  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;\n};\n\nconst parseLogDirectoryDate = (name: string): Date | undefined => {\n  const match = LOG_DIRECTORY_PATTERN.exec(name);\n  if (!match) return undefined;\n\n  const year = Number(match[1]);\n  const month = Number(match[2]);\n  const day = Number(match[3]);\n  const date = new Date(year, month - 1, day);\n  return date.getFullYear() === year &&\n    date.getMonth() === month - 1 &&\n    date.getDate() === day\n    ? date\n    : undefined;\n};\n\nconst validateRetentionDays = (retentionDays: number): void => {\n  if (!Number.isSafeInteger(retentionDays) || retentionDays < 0) {\n    throw new Error(\"Log retention days must be a non-negative integer.\");\n  }\n};\n\nexport interface PurgeRunLogsOptions {\n  /** Host repository containing `.shipyard/logs/`. */\n  readonly repoDir: string;\n  /** Remove run logs strictly older than this many calendar days. Omit to remove every default run log. */\n  readonly retentionDays?: number;\n  /** Local time used to calculate the cutoff. Primarily useful for tests. */\n  readonly now?: Date;\n}\n\nexport interface PurgeRunLogsResult {\n  readonly logsDir: string;\n  readonly retentionDays?: number;\n  /** Dated directories on or after this local date are retained when age-based purging is used. */\n  readonly cutoffDate?: string;\n  readonly scannedDirectories: number;\n  readonly removedCount: number;\n  /** Directory names removed from `logsDir`, without the parent path. */\n  readonly removedDirectories: readonly string[];\n  /** Root-level log filenames removed from `logsDir`. */\n  readonly removedFiles: readonly string[];\n}\n\n/**\n * Remove default run logs, either all of them or only those older than an\n * explicit retention threshold.\n *\n * Dated default run-log directories and regular root-level `.log` files inside\n * the managed logs directory are considered. Other files, malformed directory\n * names, and symlink entries are left alone.\n */\nexport const purgeRunLogs = async (\n  options: PurgeRunLogsOptions,\n): Promise<PurgeRunLogsResult> => {\n  const retentionDays = options.retentionDays;\n  if (retentionDays !== undefined) validateRetentionDays(retentionDays);\n\n  const now = options.now ?? new Date();\n  if (retentionDays !== undefined && Number.isNaN(now.getTime())) {\n    throw new Error(\"Cannot purge logs using an invalid date.\");\n  }\n  const cutoff =\n    retentionDays === undefined\n      ? undefined\n      : new Date(\n          now.getFullYear(),\n          now.getMonth(),\n          now.getDate() - retentionDays,\n        );\n  const cutoffDate =\n    cutoff === undefined ? undefined : buildLogDirectoryName(cutoff);\n  const logsDir = join(options.repoDir, CONFIG_DIR, LOGS_DIR);\n\n  let entries;\n  try {\n    entries = await readdir(logsDir, { withFileTypes: true });\n  } catch (error) {\n    if (error instanceof Error && \"code\" in error && error.code === \"ENOENT\") {\n      return {\n        logsDir,\n        ...(retentionDays === undefined ? {} : { retentionDays, cutoffDate }),\n        scannedDirectories: 0,\n        removedCount: 0,\n        removedDirectories: [],\n        removedFiles: [],\n      };\n    }\n    throw error;\n  }\n\n  const removedDirectories: string[] = [];\n  const removedFiles: string[] = [];\n  let scannedDirectories = 0;\n  for (const entry of entries) {\n    const entryPath = join(logsDir, entry.name);\n    if (entry.isFile() && entry.name.endsWith(\".log\")) {\n      const file = await lstat(entryPath);\n      if (file.isFile() && (cutoff === undefined || file.mtime < cutoff)) {\n        await rm(entryPath, { force: true });\n        removedFiles.push(entry.name);\n      }\n      continue;\n    }\n    if (!entry.isDirectory()) continue;\n    const directoryDate = parseLogDirectoryDate(entry.name);\n    if (directoryDate === undefined) continue;\n    scannedDirectories += 1;\n    if (cutoff !== undefined && directoryDate >= cutoff) continue;\n\n    await rm(entryPath, { recursive: true, force: true });\n    removedDirectories.push(entry.name);\n  }\n\n  return {\n    logsDir,\n    ...(retentionDays === undefined ? {} : { retentionDays, cutoffDate }),\n    scannedDirectories,\n    removedCount: removedDirectories.length + removedFiles.length,\n    removedDirectories,\n    removedFiles,\n  };\n};\n"]}