@aeolus-fleet/trierarch 0.0.0-stage → 0.17.0

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# @aeolus-fleet/trierarch
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Keeps the ships on its wanted list crewed on the machine it runs on: it starts, restarts, wakes and stops their sessions. It crews ships with `fleet:crew`; it never commissions or retires them. What a trierarch does is in [docs/trierarch.md](../../docs/trierarch.md); how this package is built is in [docs/architecture.md](../../docs/architecture.md#the-trierarch). Optional, like squadrons.
+
+## Install
+
+On the machine that will run the sessions (macOS or Linux), with Node 26, `git`, `tmux`, Claude Code and the aeolus plugin for Claude Code installed:
+
+```sh
+npm install --global @aeolus-fleet/trierarch
+```
+
+1. In the console, commission the trierarch's own ship: type `trierarch`, with **Crew ships** (`fleet:crew`). Copy its ship id and secret from the starting prompt.
+2. Register it and write a configuration:
+
+   ```sh
+   aeolus-trierarch init https://fleet.example.com shp_... aeolus_sk_v1_...
+   ```
+
+   This keeps the trierarch's own crew token in `~/.aeolus/trierarch/crew-token`, readable by you only, and never writes the secret. It writes `~/.aeolus/trierarch/config.json` when there is none yet, with `config.schema.json` beside it so an editor checks it.
+3. Edit the configuration (below), then check it:
+
+   ```sh
+   aeolus-trierarch config check
+   ```
+
+   It prints the flags each harness launches with, and each option value's flags.
+4. Keep it running:
+
+   ```sh
+   aeolus-trierarch install
+   ```
+
+   On macOS this loads a launchd agent (`~/Library/LaunchAgents/dev.aeolus-fleet.trierarch.plist`) that starts the trierarch at login and again whenever it stops. On Linux it enables a systemd user unit (`aeolus-trierarch.service`). With `--no-load` it only writes the file. Logs go to `~/.aeolus/trierarch/logs/`. To run it in the foreground instead: `aeolus-trierarch run`.
+
+## Configure
+
+`~/.aeolus/trierarch/config.json` (or the file `--config` or `AEOLUS_TRIERARCH_CONFIG` names):
+
+```json
+{
+  "$schema": "./config.schema.json",
+  "caps": { "ships": 4, "running": 2 },
+  "repositories": { "aeolus-fleet": { "path": "/Users/thomas/Projects/aeolus-fleet" } },
+  "folders": { "notes": { "path": "/Users/thomas/notes" } },
+  "harnesses": {
+    "claude-code": {
+      "flags": ["--remote-control"],
+      "options": {
+        "model": { "values": { "opus": ["--model", "claude-opus-5-5"], "sonnet": ["--model", "claude-sonnet-5-5"] }, "default": "opus" }
+      }
+    }
+  }
+}
+```
+
+- **caps**: how many ships it keeps on its list, and how many sessions run at once.
+- **repositories**: by name. A want for a worktree of one gets a git worktree under `~/.aeolus/trierarch/worktrees/<repository>/<ship>`, detached at the want's ref or the repository's HEAD. `worktreeRoot` moves that root.
+- **folders**: by name, used as they are, one ship per folder, never removed.
+- **harnesses**: the flags every launch gets, and named options. A want picks option values by name; it never adds a flag, and messages never carry paths or flags. There is no policy on which flags: put `--dangerously-skip-permissions` in `flags` if you want it. The trierarch never adds a flag by itself.
+
+The trierarch finds the aeolus plugin in Claude Code's plugin cache (the newest version). Set `AEOLUS_PLUGIN_ROOT` and `AEOLUS_PLUGIN_DATA` to point it elsewhere. `aeolus-trierarch install` carries these, `AEOLUS_TRIERARCH_CONFIG` and `PATH` into the service as they are set where it runs.
+
+## What is here
+
+- **Core** (`src/core`), with no framework, adapter or clock of its own:
+  - the wanted list;
+  - a pure Reconciler, carried out by the run pass;
+  - the restart policy: 5 s, 30 s, 2 min, then 10 min, with a budget of 5 restarts an hour;
+  - the ports.
+- **Adapters** (`src/adapters`):
+  - the fleet over REST;
+  - tmux, on its own server (`tmux -L aeolus-trierarch`, sessions named `trierarch-<ship id>` and kept on exit). Attach to one with `tmux -L aeolus-trierarch attach -t trierarch-<ship id>`;
+  - git worktrees and folders;
+  - Claude Code, through the aeolus plugin's `aeolus-identity.sh`;
+  - the JSON state store.
+- **The command** (`src/cli`): `init`, `config check`, `run`, `install`.

package/dist/adapters/claude-code.d.ts

@@ -0,0 +1,23 @@
+import type { TrierarchConfiguration } from '@aeolus-fleet/common';
+import type { HarnessPort } from '../core/ports.js';
+import type { Tmux } from './tmux.js';
+/**
+ * Claude Code as a harness (docs/architecture.md, "First adapters"): `claude`
+ * in the folder, `--continue` on a restart, `/aeolus:wake` typed to wake an
+ * idle session. A session's identity is written and read through the aeolus
+ * plugin's own `aeolus-identity.sh`, never a copy of how the plugin names its
+ * files.
+ */
+/** The aeolus plugin as Claude Code installed it: its scripts and its data folder. */
+export interface AeolusPlugin {
+    readonly root: string;
+    readonly data: string;
+}
+export declare const WAKE_PROMPT = "/aeolus:wake";
+export declare function createClaudeCodeHarness(options: {
+    configuration: TrierarchConfiguration;
+    plugin: AeolusPlugin;
+    sessions: Pick<Tmux, 'start' | 'type'>;
+    /** The program to run; `claude` unless a test runs another. */
+    command?: string;
+}): HarnessPort;

package/dist/adapters/claude-code.js

@@ -0,0 +1,52 @@
+import { readFile } from 'node:fs/promises';
+import { effectiveFlags } from './flags.js';
+import { runCommand } from './run-command.js';
+export const WAKE_PROMPT = '/aeolus:wake';
+export function createClaudeCodeHarness(options) {
+    const { configuration, plugin, sessions } = options;
+    const identity = async (folder, args) => runCommand('bash', { args: [`${plugin.root}/scripts/aeolus-identity.sh`, ...args], env: { AEOLUS_FOLDER: folder, AEOLUS_DATA: plugin.data } });
+    return {
+        prepareIdentity: async ({ folder, identity: crew }) => {
+            const written = await identity(folder, [
+                'write',
+                '--wake-by',
+                'trierarch',
+                crew.fleetUrl,
+                crew.shipId,
+                crew.shipName,
+                crew.crewToken,
+                ...(crew.squadron === undefined ? [] : [crew.squadron]),
+            ]);
+            if (written.status !== 0) {
+                throw new Error(`aeolus-identity.sh write failed: ${written.stderr.trim()}`);
+            }
+        },
+        crewTokenOf: async (folder) => {
+            const path = (await identity(folder, ['path'])).stdout.trim();
+            const text = await readFile(path, 'utf8').catch(() => '');
+            return /^crewToken=(.+)$/m.exec(text)?.[1];
+        },
+        removeIdentity: async (folder) => {
+            await identity(folder, ['delete']);
+        },
+        launch: async ({ shipId, folder, harness, options: picked, isFirstStart, firstPrompt }) => {
+            const settings = configuration.harnesses[harness];
+            if (settings === undefined) {
+                throw new Error(`The configuration has no harness ${harness}`);
+            }
+            const prompt = isFirstStart && firstPrompt !== undefined ? firstPrompt : WAKE_PROMPT;
+            // The prompt goes first: a flag with an optional value, such as `--remote-control [name]`, would take it.
+            const command = [options.command ?? 'claude', prompt, ...effectiveFlags(settings, picked), ...(isFirstStart ? [] : ['--continue'])];
+            await sessions.start({ shipId, folder, command });
+        },
+        turnOf: async (folder) => {
+            const turn = await identity(folder, ['turn']);
+            const [state] = turn.stdout.split(' ');
+            return turn.status === 0 && (state === 'busy' || state === 'idle') ? state : 'unknown';
+        },
+        wake: async ({ shipId }) => {
+            await sessions.type({ shipId, text: WAKE_PROMPT });
+        },
+    };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"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"}

package/dist/adapters/files.d.ts

@@ -0,0 +1,23 @@
+import { type TrierarchConfiguration } from '@aeolus-fleet/common';
+/**
+ * The trierarch's own files: its configuration, written by the operator, and
+ * its crew file, written by `init`: the fleet's URL and the trierarch's own
+ * crew token, readable by its user only.
+ */
+/** A file the trierarch cannot use, with why, for the operator to read. */
+export declare class TrierarchFileError extends Error {
+}
+/** The configuration a fresh `init` writes: no repository or folder yet, Claude Code with no flag. The trierarch adds no flag by itself. */
+export declare function initialConfiguration(): TrierarchConfiguration & {
+    $schema: string;
+};
+/** The configuration's JSON Schema, written beside it so an editor checks it. */
+export declare function configurationJsonSchema(): Record<string, unknown>;
+export declare function loadConfiguration(path: string): Promise<TrierarchConfiguration>;
+/** The fleet and the trierarch's own crew token. */
+export interface CrewFile {
+    readonly fleetUrl: string;
+    readonly crewToken: string;
+}
+export declare function writeCrewFile(path: string, crew: CrewFile): Promise<void>;
+export declare function readCrewFile(path: string): Promise<CrewFile>;

package/dist/adapters/files.js

@@ -0,0 +1,69 @@
+import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { trierarchConfigurationSchema } from '@aeolus-fleet/common';
+import { z } from 'zod';
+/**
+ * The trierarch's own files: its configuration, written by the operator, and
+ * its crew file, written by `init`: the fleet's URL and the trierarch's own
+ * crew token, readable by its user only.
+ */
+/** A file the trierarch cannot use, with why, for the operator to read. */
+export class TrierarchFileError extends Error {
+}
+/** The configuration a fresh `init` writes: no repository or folder yet, Claude Code with no flag. The trierarch adds no flag by itself. */
+export function initialConfiguration() {
+    return {
+        $schema: './config.schema.json',
+        caps: { ships: 4, running: 2 },
+        repositories: {},
+        folders: {},
+        harnesses: { 'claude-code': { flags: [], options: {} } },
+    };
+}
+/** The configuration's JSON Schema, written beside it so an editor checks it. */
+export function configurationJsonSchema() {
+    return z.toJSONSchema(trierarchConfigurationSchema, { io: 'input' });
+}
+export async function loadConfiguration(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch {
+        throw new TrierarchFileError(`No configuration at ${path}: run aeolus-trierarch init first`);
+    }
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch (error) {
+        throw new TrierarchFileError(`The configuration at ${path} is no JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const parsed = trierarchConfigurationSchema.safeParse(json);
+    if (!parsed.success) {
+        throw new TrierarchFileError(`The configuration at ${path} does not fit:\n${z.prettifyError(parsed.error)}`);
+    }
+    return parsed.data;
+}
+export async function writeCrewFile(path, crew) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    await writeFile(path, `fleetUrl=${crew.fleetUrl}\ncrewToken=${crew.crewToken}\n`, { mode: 0o600 });
+    await chmod(path, 0o600);
+}
+export async function readCrewFile(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch {
+        throw new TrierarchFileError(`No crew token at ${path}: run aeolus-trierarch init first`);
+    }
+    const field = (name) => new RegExp(`^${name}=(.+)$`, 'm').exec(text)?.[1];
+    const fleetUrl = field('fleetUrl');
+    const crewToken = field('crewToken');
+    if (fleetUrl === undefined || crewToken === undefined) {
+        throw new TrierarchFileError(`The crew file at ${path} lacks its fleetUrl or crewToken line: run aeolus-trierarch init again`);
+    }
+    return { fleetUrl, crewToken };
+}
+//# sourceMappingURL=files.js.map

package/dist/adapters/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/adapters/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,4BAA4B,EAA+B,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,2EAA2E;AAC3E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,4IAA4I;AAC5I,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,OAAO,EAAE,sBAAsB;QAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;QAC9B,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE;KACzD,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,CAAC,YAAY,CAAC,4BAA4B,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAAC,uBAAuB,IAAI,mCAAmC,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,IAAI,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrI,CAAC;IACD,MAAM,MAAM,GAAG,4BAA4B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,IAAI,mBAAmB,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,IAAc;IAC9D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,IAAI,EAAE,YAAY,IAAI,CAAC,QAAQ,eAAe,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,IAAI,mCAAmC,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtG,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,IAAI,wEAAwE,CAAC,CAAC;IACjI,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC"}

package/dist/adapters/flags.d.ts

@@ -0,0 +1,11 @@
+import type { TrierarchConfiguration } from '@aeolus-fleet/common';
+type HarnessConfiguration = TrierarchConfiguration['harnesses'][string];
+/**
+ * The flags a launch gets: the harness's own, then each option's value as the
+ * want picked it, or its default. A want picks names only; the flags come
+ * from the configuration alone.
+ */
+export declare function effectiveFlags(harness: HarnessConfiguration, options: Readonly<Record<string, string>>): string[];
+/** What `config check` prints: per harness, the flags a want with no options launches with, and each option's values. */
+export declare function describeFlags(configuration: TrierarchConfiguration): string;
+export {};

package/dist/adapters/flags.js

@@ -0,0 +1,28 @@
+/**
+ * The flags a launch gets: the harness's own, then each option's value as the
+ * want picked it, or its default. A want picks names only; the flags come
+ * from the configuration alone.
+ */
+export function effectiveFlags(harness, options) {
+    const picked = Object.entries(harness.options).flatMap(([name, option]) => {
+        const value = options[name] ?? option.default;
+        return value === undefined ? [] : (option.values[value] ?? []);
+    });
+    return [...harness.flags, ...picked];
+}
+/** What `config check` prints: per harness, the flags a want with no options launches with, and each option's values. */
+export function describeFlags(configuration) {
+    return Object.entries(configuration.harnesses)
+        .map(([name, harness]) => {
+        const lines = [`${name}: ${[...effectiveFlags(harness, {})].join(' ') || '(no flags)'}`];
+        for (const [option, settings] of Object.entries(harness.options)) {
+            for (const [value, flags] of Object.entries(settings.values)) {
+                const isDefault = settings.default === value;
+                lines.push(`  ${option}=${value}${isDefault ? ' (default)' : ''}: ${flags.join(' ') || '(no flags)'}`);
+            }
+        }
+        return lines.join('\n');
+    })
+        .join('\n');
+}
+//# sourceMappingURL=flags.js.map

package/dist/adapters/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/adapters/flags.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAA6B,EAAE,OAAyC;IACrG,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;QACxE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;QAC9C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,yHAAyH;AACzH,MAAM,UAAU,aAAa,CAAC,aAAqC;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;QACzF,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACjE,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7D,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC;gBAC7C,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;YACzG,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/adapters/git-workspace.d.ts

@@ -0,0 +1,12 @@
+import type { TrierarchConfiguration } from '@aeolus-fleet/common';
+import type { WorkspacePort } from '../core/ports.js';
+/**
+ * Workspaces (docs/architecture.md, "First adapters"): a git worktree of a
+ * configured repository under the worktree root, one folder per ship
+ * (`<root>/<repository>/<ship>`), detached at the want's ref or the
+ * repository's HEAD; or a configured folder used as it is.
+ */
+export declare function createGitWorkspace(options: {
+    configuration: TrierarchConfiguration;
+    root: string;
+}): WorkspacePort;

package/dist/adapters/git-workspace.js

@@ -0,0 +1,64 @@
+import { mkdir, readdir, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { runCommand } from './run-command.js';
+/**
+ * Workspaces (docs/architecture.md, "First adapters"): a git worktree of a
+ * configured repository under the worktree root, one folder per ship
+ * (`<root>/<repository>/<ship>`), detached at the want's ref or the
+ * repository's HEAD; or a configured folder used as it is.
+ */
+export function createGitWorkspace(options) {
+    const { configuration, root } = options;
+    const git = async (args) => {
+        const result = await runCommand('git', { args });
+        if (result.status !== 0) {
+            throw new Error(`git ${args.join(' ')} failed: ${result.stderr.trim()}`);
+        }
+        return result.stdout;
+    };
+    const exists = async (path) => (await stat(path).catch(() => undefined)) !== undefined;
+    const repositoryOf = (folder) => {
+        const [repository] = relative(root, folder).split(sep);
+        return repository === undefined ? undefined : configuration.repositories[repository]?.path;
+    };
+    return {
+        prepare: async ({ shipName, workspace }) => {
+            if (workspace.kind === 'folder') {
+                const folder = configuration.folders[workspace.name]?.path;
+                if (folder === undefined) {
+                    throw new Error(`The configuration has no folder ${workspace.name}`);
+                }
+                return { folder };
+            }
+            const repository = configuration.repositories[workspace.repository]?.path;
+            if (repository === undefined) {
+                throw new Error(`The configuration has no repository ${workspace.repository}`);
+            }
+            const folder = join(root, workspace.repository, shipName);
+            // A worktree a stop mid-crew left is used as it is.
+            if (!(await exists(folder))) {
+                await mkdir(join(root, workspace.repository), { recursive: true });
+                await git(['-C', repository, 'worktree', 'add', '--detach', folder, ...(workspace.ref === undefined ? [] : [workspace.ref])]);
+            }
+            return { folder };
+        },
+        isClean: async (folder) => (await git(['-C', folder, 'status', '--porcelain'])).trim() === '',
+        remove: async (folder) => {
+            const repository = repositoryOf(folder);
+            if (repository === undefined) {
+                throw new Error(`${folder} is no worktree under ${root}: the trierarch removes only what it made`);
+            }
+            await git(['-C', repository, 'worktree', 'remove', '--force', folder]);
+        },
+        worktrees: async () => {
+            const found = [];
+            for (const repository of await readdir(root).catch(() => [])) {
+                for (const ship of await readdir(join(root, repository)).catch(() => [])) {
+                    found.push({ path: join(root, repository, ship) });
+                }
+            }
+            return found;
+        },
+    };
+}
+//# sourceMappingURL=git-workspace.js.map

package/dist/adapters/git-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-workspace.js","sourceRoot":"","sources":["../../src/adapters/git-workspace.ts"],"names":[],"mappings":"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"}

package/dist/adapters/json-state.d.ts

@@ -0,0 +1,10 @@
+import type { StatePort } from '../core/ports.js';
+/**
+ * The state store: `~/.aeolus/trierarch/state.json`, written whole and
+ * atomically (a temporary file, then a rename), so a stop mid-write leaves the
+ * last state. It holds no secret. Only the most recent applied messages are
+ * kept, enough for the fleet to deliver one again.
+ */
+/** How many applied messages the store keeps, newest last. */
+export declare const APPLIED_CAP = 1000;
+export declare function createJsonState(path: string): StatePort;

package/dist/adapters/json-state.js

@@ -0,0 +1,70 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { idSchema, TRIERARCH_ENTRY_STATES, trierarchWorkspaceSchema } from '@aeolus-fleet/common';
+import { z } from 'zod';
+import { EMPTY_STATE } from '../core/entry.js';
+/**
+ * The state store: `~/.aeolus/trierarch/state.json`, written whole and
+ * atomically (a temporary file, then a rename), so a stop mid-write leaves the
+ * last state. It holds no secret. Only the most recent applied messages are
+ * kept, enough for the fleet to deliver one again.
+ */
+/** How many applied messages the store keeps, newest last. */
+export const APPLIED_CAP = 1000;
+const outgoingSchema = z.object({
+    to: idSchema('ship'),
+    inReplyTo: z.string().optional(),
+    name: z.string(),
+    payload: z.record(z.string(), z.unknown()),
+    idempotencyKey: z.string(),
+});
+const stateSchema = z.object({
+    entries: z.record(z.string(), z.object({
+        shipId: idSchema('ship'),
+        harness: z.string(),
+        workspace: trierarchWorkspaceSchema,
+        squadron: z.string().optional(),
+        firstPrompt: z.string().optional(),
+        options: z.record(z.string(), z.string()),
+        requester: idSchema('ship'),
+        state: z.enum(TRIERARCH_ENTRY_STATES),
+        since: z.string(),
+        exits: z.array(z.string()),
+        restartAt: z.string().optional(),
+        folder: z.string().optional(),
+        hasStarted: z.boolean(),
+        release: z.object({ messageId: z.string(), sender: idSchema('ship'), isForced: z.boolean() }).optional(),
+        wake: z.object({ waiting: z.int().nonnegative(), isPending: z.boolean() }),
+    })),
+    applied: z.record(z.string(), z.array(outgoingSchema)),
+    kept: z.array(z.object({ shipId: idSchema('ship'), path: z.string() })),
+    orphans: z.array(z.string()),
+});
+function isMissing(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+export function createJsonState(path) {
+    return {
+        load: async () => {
+            let text;
+            try {
+                text = await readFile(path, 'utf8');
+            }
+            catch (error) {
+                if (isMissing(error)) {
+                    return EMPTY_STATE;
+                }
+                throw error;
+            }
+            return stateSchema.parse(JSON.parse(text));
+        },
+        save: async (state) => {
+            const applied = Object.fromEntries(Object.entries(state.applied).slice(-APPLIED_CAP));
+            await mkdir(dirname(path), { recursive: true });
+            const temporary = `${path}.tmp`;
+            await writeFile(temporary, `${JSON.stringify({ ...state, applied }, null, 2)}\n`, { mode: 0o600 });
+            await rename(temporary, path);
+        },
+    };
+}
+//# sourceMappingURL=json-state.js.map

package/dist/adapters/json-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-state.js","sourceRoot":"","sources":["../../src/adapters/json-state.ts"],"names":[],"mappings":"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"}

package/dist/adapters/paths.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Where the trierarch keeps its files (docs/architecture.md, "Files on the
+ * machine"): everything under `~/.aeolus/trierarch/`. The configuration's
+ * path can be moved with `--config` or AEOLUS_TRIERARCH_CONFIG, and the
+ * worktree root by the configuration.
+ */
+export interface TrierarchPaths {
+    readonly home: string;
+    readonly config: string;
+    readonly configSchema: string;
+    readonly crewToken: string;
+    readonly state: string;
+    readonly logs: string;
+    readonly worktrees: string;
+}
+export declare function trierarchPaths(at: {
+    homeDirectory: string;
+    config?: string;
+}): TrierarchPaths;

package/dist/adapters/paths.js

@@ -0,0 +1,14 @@
+import { join } from 'node:path';
+export function trierarchPaths(at) {
+    const home = join(at.homeDirectory, '.aeolus', 'trierarch');
+    return {
+        home,
+        config: at.config ?? join(home, 'config.json'),
+        configSchema: join(home, 'config.schema.json'),
+        crewToken: join(home, 'crew-token'),
+        state: join(home, 'state.json'),
+        logs: join(home, 'logs'),
+        worktrees: join(home, 'worktrees'),
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/adapters/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/adapters/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkBjC,MAAM,UAAU,cAAc,CAAC,EAA8C;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC;QAC9C,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QACnC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QAC/B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/adapters/plugin.d.ts

@@ -0,0 +1,10 @@
+import type { AeolusPlugin } from './claude-code.js';
+/**
+ * Where Claude Code installed the aeolus plugin: AEOLUS_PLUGIN_ROOT and
+ * AEOLUS_PLUGIN_DATA when set, else the newest version in Claude Code's
+ * plugin cache and the plugin's data folder.
+ */
+export declare function findAeolusPlugin(at: {
+    homeDirectory: string;
+    env: Readonly<Record<string, string | undefined>>;
+}): Promise<AeolusPlugin>;

package/dist/adapters/plugin.js

@@ -0,0 +1,32 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Where Claude Code installed the aeolus plugin: AEOLUS_PLUGIN_ROOT and
+ * AEOLUS_PLUGIN_DATA when set, else the newest version in Claude Code's
+ * plugin cache and the plugin's data folder.
+ */
+export async function findAeolusPlugin(at) {
+    const plugins = join(at.homeDirectory, '.claude', 'plugins');
+    const data = at.env.AEOLUS_PLUGIN_DATA ?? join(plugins, 'data', 'aeolus-aeolus-fleet');
+    if (at.env.AEOLUS_PLUGIN_ROOT !== undefined) {
+        return { root: at.env.AEOLUS_PLUGIN_ROOT, data };
+    }
+    const cache = join(plugins, 'cache', 'aeolus-fleet', 'aeolus');
+    const versions = (await readdir(cache).catch(() => [])).filter((name) => /^\d+\.\d+\.\d+$/.test(name)).sort(byVersion);
+    const newest = versions.at(-1);
+    if (newest === undefined) {
+        throw new Error(`The aeolus plugin is not installed for Claude Code (nothing in ${cache}): install it, or set AEOLUS_PLUGIN_ROOT`);
+    }
+    return { root: join(cache, newest), data };
+}
+function byVersion(left, right) {
+    const [a, b] = [left, right].map((version) => version.split('.').map(Number));
+    for (let index = 0; index < 3; index += 1) {
+        const difference = (a?.[index] ?? 0) - (b?.[index] ?? 0);
+        if (difference !== 0) {
+            return difference;
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/adapters/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/adapters/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAgF;IACrH,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACvF,IAAI,EAAE,CAAC,GAAG,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvH,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kEAAkE,KAAK,0CAA0C,CAAC,CAAC;IACrI,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa;IAC5C,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/adapters/rest-fleet.d.ts

@@ -0,0 +1,34 @@
+import { type ShipId } from '@aeolus-fleet/common';
+import type { Delivery, FleetPort } from '../core/ports.js';
+/**
+ * The fleet over its REST API (`/api/v1`), as any ship may call it: the
+ * trierarch's own crew (receive, ack, send) with its crew token, its
+ * `fleet:crew` calls (ship, getStartingPrompt, release), and a session's
+ * register, inbox and report. A refusal the trierarch does not expect throws
+ * with the fleet's code and message.
+ */
+/** What the trierarch states as model and harness: it is software, not a model, as squadrons is (#157). */
+export declare const TRIERARCH_SELF: {
+    readonly model: `@aeolus-fleet/trierarch@${string}`;
+    readonly harness: "aeolus-trierarch";
+};
+/** A refusal from the fleet: its code and message. */
+export declare class FleetRefusal extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export interface RestFleet extends FleetPort {
+    /** The deliveries waiting for the trierarch's own ship. */
+    receive(): Promise<Delivery[]>;
+    /** Registers a ship with its secret, as the trierarch itself at init: its crew token. */
+    registerSelf(crew: {
+        shipId: ShipId;
+        secret: string;
+    }): Promise<{
+        crewToken: string;
+    }>;
+}
+export declare function createRestFleet(options: {
+    fleetUrl: string;
+    crewToken: string;
+}): RestFleet;