@usine/server 0.1.0 → 0.2.0

package/README.md

@@ -12,4 +12,45 @@ The command prints `http://127.0.0.1:7331` and stays attached to the terminal. P
 
 Without GitHub App credentials, it opens the setup screen in the default browser, logs the typed credential error, and leaves both trigger streams idle instead of crashing. The browser command has a two-second timeout; a failed opener produces a warning and does not stop the server. Existing Runs, transcript detail, and database-backed Loop pause state remain observable, while interventions stay unavailable. Credentials may come from `USINE_GITHUB_APP_ID` plus `USINE_GITHUB_PRIVATE_KEY`, or from a mode-0600 `.usine/github-app.json` file with `app_id` and `private_key` fields. The running process reads credentials only at startup, so stop and rerun `usine up` after adding them; the setup screen states that restart requirement explicitly.
 
-The local-only UI opens each project as a Board built from its authored or proposed lanes. Moving an Item between label-backed lanes updates its GitHub labels; normal polling then evaluates label-protocol loops. Board cards show the latest Run and open its existing detail drawer. The UI can also approve, retry, or cancel a Run; pause or unpause a Loop's database runtime state; page backward through older transcript rows; and tail parent and one-level child session activity.
+The local-only UI opens each project as a Board built from its authored or proposed lanes. Proposed lanes are read-only. Configure `repos[].lanes` in `usine.yaml` and restart `usine up` to enable moves; see the [lane configuration example](../../packages/config/README.md). Moving an Item into an authored label-backed lane exchanges only the labels in that map, preserving descriptive labels outside it; normal polling then evaluates label-protocol loops. Board cards show the latest Run and open its existing detail drawer. The UI can also approve, retry, or cancel a Run; pause or unpause a Loop's database runtime state; page backward through older transcript rows; and tail parent and one-level child session activity.
+
+Run conversations remember the reader’s filter, inspected disclosures and reading place when the drawer reopens or the page refreshes. Bookmarks are specific to each Run and browser origin; unread activity remains pending while a saved place is restored. See the [conversation reader behavior](../web/README.md#returning-to-a-conversation) for retention and history-recovery limits.
+
+Direct browser requests for UI routes serve the application shell, so refreshing or sharing a Project or Configuration URL works. Unknown `/api/*` routes, missing `/assets/*` files, and other file-like paths remain 404 responses.
+
+Run conversations summarize adjacent completed tools by their recorded actions, including the files read or changed and recognized test or build invocations. Expand a group to inspect each tool and its result.
+
+The operator API includes `POST /api/cycle-budgets/reset` with an Ask identity. It uses the same request-origin guard and typed error contract as other interventions; stale Asks return 409 and needs-setup mode rejects resets until the runtime is available.
+
+## Runtime backup and Run evidence
+
+From the instance folder, copy the runtime store while the orchestrator runs:
+
+```sh
+usine backup /path/to/runtime-backup.sqlite
+```
+
+`usine backup` copies all runtime tables, including committed WAL data, while the orchestrator runs. It opens the source read-only and doesn't need GitHub credentials.
+
+Use a new filename in an existing writable directory on a filesystem that supports hard links. The command writes a complete backup with owner-only permissions and won't overwrite existing files. Errors identify the affected path and cause.
+
+Keep the backup outside the instance folder to protect it against loss of that folder. Back up the authored instance files and credentials separately. To restore, stop the orchestrator, move the existing `.usine/runtime.sqlite` and any `runtime.sqlite-wal` / `runtime.sqlite-shm` files aside, and copy the backup to `.usine/runtime.sqlite`. Restart with the matching instance configuration and engine version. Restoring an older backup also restores its older deduplication ledger, so work performed after that backup can run again.
+
+From the instance folder, export one Run into a local JSON file:
+
+```sh
+usine export-run <runId>
+usine export-run <runId> --output /path/to/evidence.json
+```
+
+The default destination is `run-<encoded-runId>.json` in the current directory; characters such as `/` in the Run id are percent-encoded. The output directory must already exist. The command writes a complete file with owner-only permissions, preserves existing destinations, and prints its path after success. A missing Run, unreadable runtime store, encoding failure, or write failure returns a nonzero exit status.
+
+The versioned JSON contains `exportedAt`, the full durable Run `snapshot` (Event, effective task and Agent, repository revision, Step result, and all Attempts), and every saved transcript envelope for those Attempts in append order. The snapshot and transcripts come from one database transaction, including history beyond the drawer's current page. Active Runs continue accumulating history, so export a settled Run for its final evidence.
+
+Exporting opens the instance's existing `.usine/runtime.sqlite` in read-only mode, without creating tables, running migrations, starting Attempts, or polling triggers. The command keeps the output local. Transcripts can contain repository content and tool output; inspect the file before sharing it. A Run export preserves selected evidence; use `usine backup <path>` for a restorable runtime database, as described in [ADR 0010](../../docs/adr/0010-single-sqlite-runtime-store.md).
+
+## Stopping and updating
+
+Send SIGTERM or press Ctrl+C once to stop trigger polling and drain admitted Attempts. The server waits up to `max_attempt_minutes` from the shutdown request before closing the runtime. A second SIGTERM or Ctrl+C stops the wait immediately. Queued Runs and automatic retries remain saved for the next start. An Attempt interrupted by the deadline or force stop uses normal restart recovery.
+
+After `pnpm build`, reload the page to use the rebuilt web bundle; no process restart is required. Instance configuration and GitHub credentials are read at startup.

package/dist/backend.d.ts

@@ -1,6 +1,8 @@
-import type { LoadedInstance } from "@usine/config";
-import { Loop, Run } from "@usine/core";
-import type { FactoryOverview, BoardMove, Operator, OperatorObservation, OperatorError, RunDetailView, TranscriptRequest } from "@usine/orchestrator";
+import type { LoadedInstance } from "@usine/config/instance";
+import { LoopName } from "@usine/core/loop";
+import { CycleBudgetAskId } from "@usine/core/cycle-budget";
+import { RunId } from "@usine/core/run";
+import { type BoardMove, type FactoryOverview, type RunDetailView, type TranscriptRequest, type Operator, type OperatorError, type OperatorObservation } from "@usine/orchestrator/operator";
 import { Context, Effect, Layer, Schema } from "effect";
 declare const BackendUnavailableError_base: Schema.Class<BackendUnavailableError, Schema.TaggedStruct<"BackendUnavailableError", {
     readonly message: Schema.String;
@@ -10,13 +12,14 @@ export declare class BackendUnavailableError extends BackendUnavailableError_bas
 export type BackendError = OperatorError | BackendUnavailableError;
 declare const FactoryBackend_base: Context.ServiceClass<FactoryBackend, "@usine/server/FactoryBackend", {
     readonly overview: Effect.Effect<FactoryOverview, BackendError>;
-    readonly detail: (runId: Run.RunId, request: TranscriptRequest) => Effect.Effect<RunDetailView, BackendError>;
-    readonly approve: (runId: Run.RunId) => Effect.Effect<void, BackendError>;
-    readonly retry: (runId: Run.RunId) => Effect.Effect<void, BackendError>;
-    readonly cancel: (runId: Run.RunId) => Effect.Effect<void, BackendError>;
+    readonly detail: (runId: RunId, request: TranscriptRequest) => Effect.Effect<RunDetailView, BackendError>;
+    readonly approve: (runId: RunId) => Effect.Effect<void, BackendError>;
+    readonly resetCycleBudget: (askId: CycleBudgetAskId) => Effect.Effect<void, BackendError>;
+    readonly retry: (runId: RunId) => Effect.Effect<void, BackendError>;
+    readonly cancel: (runId: RunId) => Effect.Effect<void, BackendError>;
     readonly moveBoardItem: (move: BoardMove) => Effect.Effect<void, BackendError>;
-    readonly pause: (loop: Loop.LoopName) => Effect.Effect<void, BackendError>;
-    readonly unpause: (loop: Loop.LoopName) => Effect.Effect<void, BackendError>;
+    readonly pause: (loop: LoopName) => Effect.Effect<void, BackendError>;
+    readonly unpause: (loop: LoopName) => Effect.Effect<void, BackendError>;
 }>;
 export declare class FactoryBackend extends FactoryBackend_base {
 }

package/dist/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;AAExD,qBAAa,uBAAwB,SAAQ,4BAI3C;CAAG;AAEL,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,uBAAuB,CAAC;;uBAK5C,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;qBAC9C,CACf,KAAK,EAAE,GAAG,CAAC,KAAK,EAChB,OAAO,EAAE,iBAAiB,KACvB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC;sBAC7B,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;oBACzD,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;qBACtD,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;4BAChD,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;oBAC9D,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;sBACxD,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;;AAbhF,qBAAa,cAAe,SAAQ,mBAeD;CAAG;AAEtC,eAAO,MAAM,gBAAgB,aACjB,cAAc,YACd,QAAQ,CAAC,SAAS,CAAC,KAC5B,KAAK,CAAC,KAAK,CAAC,cAAc,CAUzB,CAAC;AAEL,eAAO,MAAM,sBAAsB,aACvB,cAAc,YACd,MAAM,eACH,mBAAmB,CAAC,SAAS,CAAC,KAC1C,KAAK,CAAC,KAAK,CAAC,cAAc,CAuB5B,CAAC"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EAEpB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;AAExD,qBAAa,uBAAwB,SAAQ,4BAI3C;CAAG;AAEL,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,uBAAuB,CAAC;;uBAK5C,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;qBAC9C,CACf,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,KACvB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC;sBAC7B,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;+BAC1C,CAAC,KAAK,EAAE,gBAAgB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;oBACzE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;qBAClD,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;4BAC5C,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;oBAC9D,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;sBACnD,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;;AAd3E,qBAAa,cAAe,SAAQ,mBAgBD;CAAG;AAEtC,eAAO,MAAM,gBAAgB,aACjB,cAAc,YACd,QAAQ,CAAC,SAAS,CAAC,KAC5B,KAAK,CAAC,KAAK,CAAC,cAAc,CAWzB,CAAC;AAEL,eAAO,MAAM,sBAAsB,aACvB,cAAc,YACd,MAAM,eACH,mBAAmB,CAAC,SAAS,CAAC,KAC1C,KAAK,CAAC,KAAK,CAAC,cAAc,CAwB5B,CAAC"}

package/dist/backend.js

@@ -1,5 +1,7 @@
-import { Loop, Run } from "@usine/core";
-import { NeedsSetupOverview } from "@usine/orchestrator";
+import { LoopName } from "@usine/core/loop";
+import { CycleBudgetAskId } from "@usine/core/cycle-budget";
+import { RunId } from "@usine/core/run";
+import { NeedsSetupOverview, } from "@usine/orchestrator/operator";
 import { Context, Effect, Layer, Schema } from "effect";
 export class BackendUnavailableError extends Schema.TaggedError("@usine/server/BackendUnavailableError")("BackendUnavailableError", {
     message: Schema.String,
@@ -11,6 +13,7 @@ export const liveBackendLayer = (instance, operator) => Layer.succeed(FactoryBac
     overview: operator.overview(instance),
     detail: operator.detail,
     approve: operator.approve,
+    resetCycleBudget: operator.resetCycleBudget,
     retry: operator.retry,
     cancel: operator.cancel,
     moveBoardItem: (move) => operator.moveBoardItem(instance, move),
@@ -29,6 +32,7 @@ export const needsSetupBackendLayer = (instance, errorTag, observation) => {
         overview,
         detail: observation.detail,
         approve: fail,
+        resetCycleBudget: fail,
         retry: fail,
         cancel: fail,
         moveBoardItem: fail,

package/dist/backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAUxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExD,MAAM,OAAO,uBAAwB,SAAQ,MAAM,CAAC,WAAW,CAC7D,uCAAuC,CACxC,CAAC,yBAAyB,EAAE;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AAIL,MAAM,OAAO,cAAe,SAAQ,OAAO,CAAC,OAAO,EAehD,CAAC,8BAA8B,CAAC;CAAG;AAEtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,QAAwB,EACxB,QAA6B,EACA,EAAE,CAC/B,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;IACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;IACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;IACvB,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC;IAC/D,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;CAC9D,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAwB,EACxB,QAAgB,EAChB,WAA2C,EACd,EAAE;IAC/B,MAAM,WAAW,GAAG,IAAI,uBAAuB,CAAC;QAC9C,OAAO,EAAE,qEAAqE;KAC/E,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,WAAW;SACzB,QAAQ,CAAC,QAAQ,CAAC;SAClB,IAAI,CACH,MAAM,CAAC,GAAG,CACR,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAChC,IAAI,kBAAkB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAClE,CACF,CAAC;IACJ,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACnC,QAAQ;QACR,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAGL,kBAAkB,GAMnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExD,MAAM,OAAO,uBAAwB,SAAQ,MAAM,CAAC,WAAW,CAC7D,uCAAuC,CACxC,CAAC,yBAAyB,EAAE;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AAIL,MAAM,OAAO,cAAe,SAAQ,OAAO,CAAC,OAAO,EAgBhD,CAAC,8BAA8B,CAAC;CAAG;AAEtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,QAAwB,EACxB,QAA6B,EACA,EAAE,CAC/B,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;IACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;IACzB,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;IAC3C,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;IACvB,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC;IAC/D,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;CAC9D,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAwB,EACxB,QAAgB,EAChB,WAA2C,EACd,EAAE;IAC/B,MAAM,WAAW,GAAG,IAAI,uBAAuB,CAAC;QAC9C,OAAO,EAAE,qEAAqE;KAC/E,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,WAAW;SACzB,QAAQ,CAAC,QAAQ,CAAC;SAClB,IAAI,CACH,MAAM,CAAC,GAAG,CACR,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAChC,IAAI,kBAAkB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAClE,CACF,CAAC;IACJ,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACnC,QAAQ;QACR,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,IAAI;QACtB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/backup.d.ts

@@ -0,0 +1,4 @@
+import { Effect, Path } from "effect";
+/** Copies the current instance's runtime database to `output`, resolved from the working directory. */
+export declare const backup: (output: string) => Effect.Effect<void, import("@usine/engine/local-sqlite").RuntimeStoreBackupError, Path.Path>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE/C,uGAAuG;AACvG,eAAO,MAAM,MAAM,kHAOjB,CAAC"}

package/dist/backup.js

@@ -0,0 +1,13 @@
+import { InstanceDirectory } from "@usine/core/instance";
+import { backup as backupDatabase } from "@usine/engine/local-sqlite";
+import { Console, Effect, Path } from "effect";
+/** Copies the current instance's runtime database to `output`, resolved from the working directory. */
+export const backup = Effect.fn("Cli.backup")(function* (output) {
+    const directory = InstanceDirectory.make(process.cwd());
+    const path = yield* Path.Path;
+    const destination = path.resolve(output);
+    yield* Effect.annotateCurrentSpan({ instanceDirectory: directory, destination });
+    yield* backupDatabase(directory, destination);
+    yield* Console.log(`Backed up runtime store to ${destination}`);
+});
+//# sourceMappingURL=backup.js.map

package/dist/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE/C,uGAAuG;AACvG,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAc;IACrE,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IACjF,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9C,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -5,7 +5,7 @@ export declare const DEFAULT_PORT = 7331;
 export declare const BROWSER_OPEN_TIMEOUT = "2 seconds";
 export declare const Port: Schema.brand<Schema.Int, "ServerPort">;
 export type Port = typeof Port.Type;
-export declare const CLI_USAGE = "Usage:\n  usine up [--port <port>]\n  usine --help\n  usine --version\n\nOptions:\n  -p, --port <port>  Listen on this port (default: 7331)\n  -h, --help         Print this usage\n  -v, --version      Print the pinned @usine/server version\n\nEnvironment:\n  USINE_PORT         Listen on this port when --port is absent";
+export declare const CLI_USAGE = "Usage:\n  usine up [--port <port>] [--allow-volatile-instance]\n  usine backup <path>\n  usine export-run <runId> [--output <path>]\n  usine --help\n  usine --version\n\nOptions:\n  -p, --port <port>            Listen on this port (default: 7331)\n  --allow-volatile-instance    Start even when the instance folder sits under a temp path\n  -o, --output <path>          Write Run evidence here (default: run-<encoded-runId>.json)\n  -h, --help                   Print this usage\n  -v, --version                Print the pinned @usine/server version\n\nEnvironment:\n  USINE_PORT                     Listen on this port when --port is absent\n  USINE_ALLOW_VOLATILE_INSTANCE  Same as --allow-volatile-instance when set to 1";
 declare const CliUsageError_base: Schema.Class<CliUsageError, Schema.TaggedStruct<"CliUsageError", {
     readonly message: Schema.String;
 }>, import("effect/Cause").YieldableError>;
@@ -27,6 +27,13 @@ declare const ServerStartError_base: Schema.Class<ServerStartError, Schema.Tagge
 }>, import("effect/Cause").YieldableError>;
 export declare class ServerStartError extends ServerStartError_base {
 }
+declare const VolatileInstanceDirectoryError_base: Schema.Class<VolatileInstanceDirectoryError, Schema.TaggedStruct<"VolatileInstanceDirectoryError", {
+    readonly directory: Schema.String;
+    readonly root: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Raised when the instance folder sits under a path the OS may clear, since its runtime store is the only copy of run history. */
+export declare class VolatileInstanceDirectoryError extends VolatileInstanceDirectoryError_base {
+}
 declare const BrowserOpenError_base: Schema.Class<BrowserOpenError, Schema.TaggedStruct<"BrowserOpenError", {
     readonly command: Schema.String;
     readonly cause: Schema.Defect;
@@ -41,18 +48,40 @@ export declare class VersionCommand extends VersionCommand_base {
 }
 declare const UpCommand_base: Schema.Class<UpCommand, Schema.TaggedStruct<"UpCommand", {
     readonly port: Schema.brand<Schema.Int, "ServerPort">;
+    readonly allowVolatileInstance: Schema.Boolean;
 }>, {}>;
 export declare class UpCommand extends UpCommand_base {
 }
-export declare const CliCommand: Schema.Union<readonly [typeof HelpCommand, typeof VersionCommand, typeof UpCommand]>;
+declare const ExportRunCommand_base: Schema.Class<ExportRunCommand, Schema.TaggedStruct<"ExportRunCommand", {
+    readonly runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+    readonly output: Schema.Option<Schema.NonEmptyString>;
+}>, {}>;
+/** Exports one Run from the current instance into a new local JSON file. */
+export declare class ExportRunCommand extends ExportRunCommand_base {
+}
+declare const BackupCommand_base: Schema.Class<BackupCommand, Schema.TaggedStruct<"BackupCommand", {
+    readonly output: Schema.NonEmptyString;
+}>, {}>;
+/** Copies the current instance's runtime store into a new SQLite file. */
+export declare class BackupCommand extends BackupCommand_base {
+}
+export interface CliEnvironment {
+    readonly port: Option.Option<string>;
+    readonly allowVolatileInstance: Option.Option<string>;
+}
+export declare const CliCommand: Schema.Union<readonly [typeof HelpCommand, typeof VersionCommand, typeof UpCommand, typeof ExportRunCommand, typeof BackupCommand]>;
 export type CliCommand = typeof CliCommand.Type;
-/** Parse process arguments and environment into one validated CLI command. */
-export declare const parseCli: (args: readonly string[], environmentPort: Option.Option<string>) => Effect.Effect<HelpCommand | UpCommand | VersionCommand, CliUsageError, never>;
-/** Read the package version npm pinned for this installed server. */
+/** Parses process arguments and the environment into one validated CLI command. */
+export declare const parseCli: (args: readonly string[], environment: CliEnvironment) => Effect.Effect<BackupCommand | ExportRunCommand | HelpCommand | UpCommand | VersionCommand, CliUsageError, never>;
+/** Directories the OS may clear: `os.tmpdir()`, `$TMPDIR`, and the usual temp locations. */
+export declare const volatileRoots: (environmentTmpdir: Option.Option<string>) => ReadonlyArray<string>;
+/** Returns the volatile root the directory sits under, if any. Paths are compared as given, with symlinks unresolved. */
+export declare const volatileRoot: (directory: string, roots: ReadonlyArray<string>) => Option.Option<string>;
+/** Reads the version of this installed server from its package.json. */
 export declare const packageVersion: () => Effect.Effect<string, CliVersionError, FileSystem.FileSystem>;
-/** Translate Effect's low-level bind failure into the CLI's startup vocabulary. */
+/** Maps a bind failure to the CLI's startup error, so an address already in use is reported as such. */
 export declare const serverStartError: (port: Port, error: ServeError) => PortInUseError | ServerStartError;
-/** Open the setup page after the HTTP server has bound successfully. */
+/** Opens the setup page in a browser; call it only after the HTTP server has bound. */
 export declare const openBrowser: (url: string, timeout?: Duration.Input | undefined) => Effect.Effect<undefined, BrowserOpenError, ChildProcessSpawner.ChildProcessSpawner>;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC/E,OAAO,EAAgB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAEvE,eAAO,MAAM,YAAY,OAAQ,CAAC;AAClC,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,eAAO,MAAM,IAAI,wCAEiB,CAAC;AACnC,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAC;AAIpC,eAAO,MAAM,SAAS,oUAWyC,CAAC;;;;AAEhE,qBAAa,aAAc,SAAQ,kBAGlC;CAAG;;;;AAEJ,qBAAa,eAAgB,SAAQ,oBAEW;CAAG;;;;AAEnD,qBAAa,cAAe,SAAQ,mBAED;CAAG;;;;;AAEtC,qBAAa,gBAAiB,SAAQ,qBAEuB;CAAG;;;;;AAEhE,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG;;AAEL,qBAAa,WAAY,SAAQ,gBAGhC;CAAG;;AAEJ,qBAAa,cAAe,SAAQ,mBAEb;CAAG;;;;AAE1B,qBAAa,SAAU,SAAQ,cAG9B;CAAG;AAEJ,eAAO,MAAM,UAAU,sFAAyD,CAAC;AACjF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAkChD,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,oJAenB,CAAC;AAMH,qEAAqE;AACrE,eAAO,MAAM,cAAc,qEAUzB,CAAC;AAIH,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,SAAU,IAAI,SAAS,UAAU,sCAGN,CAAC;AAUzD,wEAAwE;AACxE,eAAO,MAAM,WAAW,4IAyBtB,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC/E,OAAO,EAAgB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAEvE,eAAO,MAAM,YAAY,OAAQ,CAAC;AAClC,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,eAAO,MAAM,IAAI,wCAEiB,CAAC;AACnC,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAC;AAIpC,eAAO,MAAM,SAAS,wtBAgB2D,CAAC;;;;AAElF,qBAAa,aAAc,SAAQ,kBAGlC;CAAG;;;;AAEJ,qBAAa,eAAgB,SAAQ,oBAEW;CAAG;;;;AAEnD,qBAAa,cAAe,SAAQ,mBAED;CAAG;;;;;AAEtC,qBAAa,gBAAiB,SAAQ,qBAEuB;CAAG;;;;;AAEhE,mIAAmI;AACnI,qBAAa,8BAA+B,SAAQ,mCAKlD;CAAG;;;;;AAEL,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG;;AAEL,qBAAa,WAAY,SAAQ,gBAGhC;CAAG;;AAEJ,qBAAa,cAAe,SAAQ,mBAEb;CAAG;;;;;AAE1B,qBAAa,SAAU,SAAQ,cAG9B;CAAG;;;;;AAEJ,4EAA4E;AAC5E,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG;;;;AAEL,0EAA0E;AAC1E,qBAAa,aAAc,SAAQ,kBAGlC;CAAG;AAEJ,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,UAAU,qIAMrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAyEhD,mFAAmF;AACnF,eAAO,MAAM,QAAQ,4KAmBnB,CAAC;AAEH,4FAA4F;AAC5F,eAAO,MAAM,aAAa,sBAAuB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAG,aAAa,CAAC,MAAM,CAW5D,CAAC;AAKlC,yHAAyH;AACzH,eAAO,MAAM,YAAY,cACZ,MAAM,SACV,aAAa,CAAC,MAAM,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,CAGtB,CAAC;AAMF,wEAAwE;AACxE,eAAO,MAAM,cAAc,qEAUzB,CAAC;AAIH,wGAAwG;AACxG,eAAO,MAAM,gBAAgB,SAAU,IAAI,SAAS,UAAU,sCAGN,CAAC;AAUzD,uFAAuF;AACvF,eAAO,MAAM,WAAW,4IAyBtB,CAAC"}

package/dist/cli.js

@@ -1,4 +1,7 @@
+import { tmpdir } from "node:os";
+import { resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
+import { RunId } from "@usine/core/run";
 import { Console, Duration, Effect, FileSystem, Option, Schema } from "effect";
 import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
 export const DEFAULT_PORT = 7_331;
@@ -6,17 +9,22 @@ export const BROWSER_OPEN_TIMEOUT = "2 seconds";
 export const Port = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65_535 }, { message: "Expected a TCP port" })).pipe(Schema.brand("ServerPort"));
 const PortFromString = Schema.NumberFromString.pipe(Schema.decodeTo(Port));
 export const CLI_USAGE = `Usage:
-  usine up [--port <port>]
+  usine up [--port <port>] [--allow-volatile-instance]
+  usine backup <path>
+  usine export-run <runId> [--output <path>]
   usine --help
   usine --version
 
 Options:
-  -p, --port <port>  Listen on this port (default: 7331)
-  -h, --help         Print this usage
-  -v, --version      Print the pinned @usine/server version
+  -p, --port <port>            Listen on this port (default: 7331)
+  --allow-volatile-instance    Start even when the instance folder sits under a temp path
+  -o, --output <path>          Write Run evidence here (default: run-<encoded-runId>.json)
+  -h, --help                   Print this usage
+  -v, --version                Print the pinned @usine/server version
 
 Environment:
-  USINE_PORT         Listen on this port when --port is absent`;
+  USINE_PORT                     Listen on this port when --port is absent
+  USINE_ALLOW_VOLATILE_INSTANCE  Same as --allow-volatile-instance when set to 1`;
 export class CliUsageError extends Schema.TaggedError("@usine/server/CliUsageError")("CliUsageError", { message: Schema.String }) {
 }
 export class CliVersionError extends Schema.TaggedError("@usine/server/CliVersionError")("CliVersionError", { cause: Schema.Defect() }) {
@@ -25,6 +33,12 @@ export class PortInUseError extends Schema.TaggedError("@usine/server/PortInUseE
 }
 export class ServerStartError extends Schema.TaggedError("@usine/server/ServerStartError")("ServerStartError", { port: Port, cause: Schema.Defect() }) {
 }
+/** Raised when the instance folder sits under a path the OS may clear, since its runtime store is the only copy of run history. */
+export class VolatileInstanceDirectoryError extends Schema.TaggedError("@usine/server/VolatileInstanceDirectoryError")("VolatileInstanceDirectoryError", {
+    directory: Schema.String,
+    root: Schema.String,
+}) {
+}
 export class BrowserOpenError extends Schema.TaggedError("@usine/server/BrowserOpenError")("BrowserOpenError", {
     command: Schema.String,
     cause: Schema.Defect(),
@@ -34,42 +48,115 @@ export class HelpCommand extends Schema.TaggedClass("@usine/server/HelpCommand")
 }
 export class VersionCommand extends Schema.TaggedClass("@usine/server/VersionCommand")("VersionCommand", {}) {
 }
-export class UpCommand extends Schema.TaggedClass("@usine/server/UpCommand")("UpCommand", { port: Port }) {
+export class UpCommand extends Schema.TaggedClass("@usine/server/UpCommand")("UpCommand", { port: Port, allowVolatileInstance: Schema.Boolean }) {
+}
+/** Exports one Run from the current instance into a new local JSON file. */
+export class ExportRunCommand extends Schema.TaggedClass("@usine/server/ExportRunCommand")("ExportRunCommand", {
+    runId: RunId,
+    output: Schema.Option(Schema.NonEmptyString),
+}) {
+}
+/** Copies the current instance's runtime store into a new SQLite file. */
+export class BackupCommand extends Schema.TaggedClass("@usine/server/BackupCommand")("BackupCommand", { output: Schema.NonEmptyString }) {
 }
-export const CliCommand = Schema.Union([HelpCommand, VersionCommand, UpCommand]);
+export const CliCommand = Schema.Union([
+    HelpCommand,
+    VersionCommand,
+    UpCommand,
+    ExportRunCommand,
+    BackupCommand,
+]);
 const usageError = (message = CLI_USAGE) => new CliUsageError({ message });
 const decodePort = (source, value) => Schema.decodeUnknownEffect(PortFromString)(value).pipe(Effect.mapError(() => usageError(`${source} must be a whole number between 1 and 65535.\n\n${CLI_USAGE}`)));
-const upPort = (args, environmentPort) => {
-    if (args.length === 0) {
-        return Option.match(environmentPort, {
+const ALLOW_VOLATILE_FLAG = "--allow-volatile-instance";
+const exportRunCommand = (args) => {
+    const [runId, flag, output] = args;
+    if (runId === undefined ||
+        runId.startsWith("-") ||
+        !(args.length === 1 || (args.length === 3 && (flag === "--output" || flag === "-o"))))
+        return Effect.fail(usageError());
+    return Schema.decodeUnknownEffect(ExportRunCommand)({
+        _tag: "ExportRunCommand",
+        runId,
+        output: Option.fromUndefinedOr(output),
+    }).pipe(Effect.mapError(() => usageError()));
+};
+const backupCommand = (args) => {
+    const [output] = args;
+    if (args.length !== 1 || output === undefined || output.startsWith("-"))
+        return Effect.fail(usageError());
+    return Schema.decodeUnknownEffect(BackupCommand)({ _tag: "BackupCommand", output }).pipe(Effect.mapError(() => usageError()));
+};
+const upCommand = (args, environment) => Effect.gen(function* () {
+    let port = Option.none();
+    let allowVolatileInstance = Option.exists(environment.allowVolatileInstance, (v) => v === "1");
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--port" || arg === "-p") {
+            const value = args[index + 1];
+            if (value === undefined)
+                return yield* usageError();
+            port = Option.some(value);
+            index += 1;
+        }
+        else if (arg?.startsWith("--port=")) {
+            port = Option.some(arg.slice("--port=".length));
+        }
+        else if (arg === ALLOW_VOLATILE_FLAG) {
+            allowVolatileInstance = true;
+        }
+        else {
+            return yield* usageError();
+        }
+    }
+    const resolvedPort = yield* Option.match(port, {
+        onNone: () => Option.match(environment.port, {
             onNone: () => Effect.succeed(Port.make(DEFAULT_PORT)),
             onSome: (value) => decodePort("USINE_PORT", value),
-        });
-    }
-    if (args.length === 2 && (args[0] === "--port" || args[0] === "-p")) {
-        const value = args[1];
-        return value === undefined ? Effect.fail(usageError()) : decodePort("--port", value);
-    }
-    if (args.length === 1 && args[0]?.startsWith("--port=")) {
-        return decodePort("--port", args[0].slice("--port=".length));
-    }
-    return Effect.fail(usageError());
-};
-/** Parse process arguments and environment into one validated CLI command. */
-export const parseCli = Effect.fn("Cli.parse")((args, environmentPort) => {
+        }),
+        onSome: (value) => decodePort("--port", value),
+    });
+    return new UpCommand({ port: resolvedPort, allowVolatileInstance });
+});
+/** Parses process arguments and the environment into one validated CLI command. */
+export const parseCli = Effect.fn("Cli.parse")((args, environment) => {
     if ((args.length === 1 && (args[0] === "--help" || args[0] === "-h")) ||
-        (args.length === 2 && args[0] === "up" && (args[1] === "--help" || args[1] === "-h"))) {
+        (args.length === 2 &&
+            (args[0] === "up" || args[0] === "export-run" || args[0] === "backup") &&
+            (args[1] === "--help" || args[1] === "-h"))) {
         return Effect.succeed(new HelpCommand());
     }
     if (args.length === 1 && (args[0] === "--version" || args[0] === "-v")) {
         return Effect.succeed(new VersionCommand());
     }
+    if (args[0] === "backup")
+        return backupCommand(args.slice(1));
+    if (args[0] === "export-run")
+        return exportRunCommand(args.slice(1));
     if (args[0] !== "up")
         return Effect.fail(usageError());
-    return upPort(args.slice(1), environmentPort).pipe(Effect.map((port) => new UpCommand({ port })));
+    return upCommand(args.slice(1), environment);
 });
+/** Directories the OS may clear: `os.tmpdir()`, `$TMPDIR`, and the usual temp locations. */
+export const volatileRoots = (environmentTmpdir) => [
+    ...new Set([
+        tmpdir(),
+        ...Option.toArray(environmentTmpdir),
+        "/tmp",
+        "/private/tmp",
+        "/var/folders",
+    ]),
+]
+    .filter((root) => root.length > 0)
+    .map((root) => resolve(root));
+const isUnder = (directory, root) => directory === root || directory.startsWith(root.endsWith(sep) ? root : `${root}${sep}`);
+/** Returns the volatile root the directory sits under, if any. Paths are compared as given, with symlinks unresolved. */
+export const volatileRoot = (directory, roots) => {
+    const resolved = resolve(directory);
+    return Option.fromNullishOr(roots.find((root) => isUnder(resolved, root)));
+};
 const PackageMetadataFromJson = Schema.fromJsonString(Schema.Struct({ version: Schema.NonEmptyString }));
-/** Read the package version npm pinned for this installed server. */
+/** Reads the version of this installed server from its package.json. */
 export const packageVersion = Effect.fn("Cli.packageVersion")(function* () {
     const fileSystem = yield* FileSystem.FileSystem;
     const packagePath = fileURLToPath(new URL("../package.json", import.meta.url));
@@ -80,7 +167,7 @@ export const packageVersion = Effect.fn("Cli.packageVersion")(function* () {
     return metadata.version;
 });
 const AddressInUse = Schema.Struct({ code: Schema.Literal("EADDRINUSE") });
-/** Translate Effect's low-level bind failure into the CLI's startup vocabulary. */
+/** Maps a bind failure to the CLI's startup error, so an address already in use is reported as such. */
 export const serverStartError = (port, error) => Schema.is(AddressInUse)(error.cause)
     ? new PortInUseError({ port })
     : new ServerStartError({ port, cause: error.cause });
@@ -92,7 +179,7 @@ const browserCommand = (url) => {
     }
     return { command: "xdg-open", args: [url] };
 };
-/** Open the setup page after the HTTP server has bound successfully. */
+/** Opens the setup page in a browser; call it only after the HTTP server has bound. */
 export const openBrowser = Effect.fn("Cli.openBrowser")(function* (url, timeout = BROWSER_OPEN_TIMEOUT) {
     const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
     const { command, args } = browserCommand(url);

package/dist/cli.js.map

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

package/dist/export-run.d.ts

@@ -0,0 +1,22 @@
+import { Effect, FileSystem, Option, Path, Schema } from "effect";
+/** JSON encoding preserves timestamps, optional values, and typed Attempt outcomes. */
+export declare const RunEvidenceFromJson: Schema.fromJsonString<Schema.toCodecJson<Schema.Struct<{
+    readonly snapshot: typeof import("@usine/engine/run-reader").RunSnapshot;
+    readonly transcript: Schema.$Array<typeof import("@usine/engine/transcript").TranscriptEntry>;
+    readonly version: Schema.Literal<1>;
+    readonly exportedAt: Schema.DateTimeUtc;
+}>>>;
+declare const RunExportError_base: Schema.Class<RunExportError, Schema.TaggedStruct<"RunExportError", {
+    readonly runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+    readonly operation: Schema.Literals<readonly ["read", "encode", "write"]>;
+    readonly path: Schema.String;
+    readonly reason: Schema.String;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** Reading, encoding, or writing Run evidence failed; no successful export was reported. */
+export declare class RunExportError extends RunExportError_base {
+}
+/** Exports from the current instance without loading GitHub credentials or starting execution. */
+export declare const exportRun: (runId: string & import("effect/Brand").Brand<"RunId">, output: Option.Option<string>) => Effect.Effect<void, RunExportError | import("@usine/engine/engine").RunNotFoundError, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=export-run.d.ts.map

package/dist/export-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-run.d.ts","sourceRoot":"","sources":["../src/export-run.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,MAAM,EAAE,UAAU,EAAS,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE5F,uFAAuF;AACvF,eAAO,MAAM,mBAAmB;;;;;IAS/B,CAAC;;;;;;;;AAEF,4FAA4F;AAC5F,qBAAa,cAAe,SAAQ,mBAQlC;CAAG;AAoDL,kGAAkG;AAClG,eAAO,MAAM,SAAS,oNA2CrB,CAAC"}

package/dist/export-run.js

@@ -0,0 +1,85 @@
+import { InstanceDirectory } from "@usine/core/instance";
+import { RunId } from "@usine/core/run";
+import { runReaderLayer } from "@usine/engine/local-sqlite";
+import { RunEvidence, RunReader } from "@usine/engine/run-reader";
+import { Console, DateTime, Effect, FileSystem, Match, Option, Path, Schema } from "effect";
+/** JSON encoding preserves timestamps, optional values, and typed Attempt outcomes. */
+export const RunEvidenceFromJson = Schema.fromJsonString(Schema.toCodecJson(Schema.Struct({
+    version: Schema.Literal(1),
+    exportedAt: Schema.DateTimeUtc,
+    ...RunEvidence.fields,
+})), { space: 2 });
+/** Reading, encoding, or writing Run evidence failed; no successful export was reported. */
+export class RunExportError extends Schema.TaggedError("@usine/server/RunExportError")("RunExportError", {
+    runId: RunId,
+    operation: Schema.Literals(["read", "encode", "write"]),
+    path: Schema.String,
+    reason: Schema.String,
+    cause: Schema.Defect(),
+}) {
+}
+/** Writes a complete evidence file without overwriting an existing destination. */
+const writeRunEvidence = Effect.fn("RunEvidence.write")(function* (evidence, output) {
+    const runId = evidence.snapshot.run.id;
+    yield* Effect.annotateCurrentSpan({ runId, output });
+    const json = yield* Schema.encodeEffect(RunEvidenceFromJson)({
+        version: 1,
+        exportedAt: yield* DateTime.now,
+        ...evidence,
+    }).pipe(Effect.mapError((cause) => new RunExportError({ runId, operation: "encode", path: output, reason: cause._tag, cause })));
+    const fileSystem = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    yield* Effect.scoped(Effect.gen(function* () {
+        const temporary = yield* fileSystem.makeTempDirectoryScoped({
+            directory: path.dirname(output),
+            prefix: ".usine-export-",
+        });
+        const staged = path.join(temporary, "evidence.json");
+        yield* fileSystem.writeFileString(staged, `${json}\n`, { mode: 0o600 });
+        // Publish the complete file atomically. A hard link refuses an existing destination.
+        yield* fileSystem.link(staged, output);
+    })).pipe(Effect.mapError((cause) => new RunExportError({
+        runId,
+        operation: "write",
+        path: output,
+        reason: cause.reason._tag,
+        cause,
+    })));
+    yield* Effect.logInfo("Run evidence exported", {
+        runId,
+        output,
+        attempts: evidence.snapshot.attempts.length,
+        transcriptRows: evidence.transcript.length,
+    });
+});
+/** Exports from the current instance without loading GitHub credentials or starting execution. */
+export const exportRun = Effect.fn("Cli.exportRun")(function* (runId, output) {
+    const directory = InstanceDirectory.make(process.cwd());
+    const path = yield* Path.Path;
+    const destination = path.resolve(Option.getOrElse(output, () => `run-${encodeURIComponent(runId)}.json`));
+    yield* Effect.annotateCurrentSpan({ runId, instanceDirectory: directory, output: destination });
+    const databasePath = path.join(directory, ".usine", "runtime.sqlite");
+    const reader = runReaderLayer(directory);
+    const evidence = yield* Effect.flatMap(RunReader, (reader) => reader.evidence(runId)).pipe(Effect.provide(reader), Effect.mapError((cause) => cause._tag === "RunNotFoundError"
+        ? cause
+        : new RunExportError({
+            runId,
+            operation: "read",
+            path: databasePath,
+            reason: cause._tag,
+            cause,
+        })));
+    yield* writeRunEvidence(evidence, destination);
+    yield* Console.log(`Exported Run ${runId} to ${destination}`);
+}, Effect.tapError((error) => Effect.logWarning("Run evidence export failed", Match.valueTags(error, {
+    RunNotFoundError: ({ runId, _tag }) => ({ runId, errorTag: _tag }),
+    RunExportError: ({ runId, _tag, operation, path, reason, cause }) => ({
+        runId,
+        errorTag: _tag,
+        operation,
+        path,
+        reason,
+        cause,
+    }),
+}))));
+//# sourceMappingURL=export-run.js.map