@theford/runly 0.0.0-stage → 0.20.0

package/dist/drivers/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * DESIGN TARGET — NOT YET WIRED. These are sketches for the remote SUBSTRATE
+ * seam, which the engine does not call: it supervises local processes itself.
+ * The LIVE datastore seam is `DsDriver` in ./datastores.ts and the live preview
+ * seam is `PreviewPublisher` in ./preview.ts, not this file. Do not import
+ * these types expecting the engine to honor them (see docs/driver-spec.md).
+ *
+ * Drivers own TRANSPORT and STORAGE mechanics; the engine owns all POLICY
+ * (leases, hygiene, upkeep, idle and teardown, the load budget, error
+ * taxonomy). A driver that wants policy is a design bug.
+ */
+export interface ExecOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    /** Remote substrates must support detached (submit-and-poll) execution. */
+    detach?: boolean;
+    timeoutMs?: number;
+}
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    /** Set when detach:true — poll/reattach handle, journaled on the box. */
+    jobId?: string;
+}
+export interface EnvHandle {
+    id: string;
+    /** Filesystem root of the environment's tree (local path or remote path). */
+    root: string;
+    substrate: string;
+}
+export interface SubstrateCapabilities {
+    pause: boolean;
+    checkpoint: boolean;
+}
+export interface SubstrateDriver {
+    readonly name: string;
+    readonly capabilities: SubstrateCapabilities;
+    /** Idempotent per env id. */
+    provision(envId: string): Promise<EnvHandle>;
+    exec(env: EnvHandle, cmd: string[], opts?: ExecOptions): Promise<ExecResult>;
+    /** Superseded design: the git-sync transport went with the source copy (decision 0032); how a remote substrate reaches the worktree is open. */
+    gitEndpoint(env: EnvHandle): Promise<string>;
+    /** Consumer-reachable URL for a port inside the environment. */
+    expose(env: EnvHandle, port: number): Promise<string>;
+    destroy(env: EnvHandle): Promise<void>;
+    pause?(env: EnvHandle): Promise<void>;
+    resume?(env: EnvHandle): Promise<void>;
+    checkpoint?(env: EnvHandle, key: string): Promise<void>;
+    restore?(key: string, envId: string): Promise<EnvHandle>;
+    /** Adopt-or-reap discovery of instances the local journal forgot (remote). */
+    reconcile?(): Promise<EnvHandle[]>;
+}
+export interface DatastoreCapabilities {
+    template: boolean;
+    /** Reset-data degenerates to flush; presets are meaningless. */
+    ephemeral: boolean;
+}
+export interface DatastoreDriver {
+    readonly name: string;
+    readonly capabilities: DatastoreCapabilities;
+    /** infra-error (never code blame) when the external server is unreachable. */
+    probe(): Promise<void>;
+    create(ns: string, preset: string): Promise<void>;
+    /** Must refuse namespaces outside runly's own pattern. */
+    drop(ns: string): Promise<void>;
+    url(ns: string): string;
+    templateBake?(preset: string, seedHash: string): Promise<void>;
+    templateRestore?(ns: string, preset: string, seedHash: string): Promise<void>;
+}

package/dist/drivers/types.js

@@ -0,0 +1,13 @@
+/**
+ * DESIGN TARGET — NOT YET WIRED. These are sketches for the remote SUBSTRATE
+ * seam, which the engine does not call: it supervises local processes itself.
+ * The LIVE datastore seam is `DsDriver` in ./datastores.ts and the live preview
+ * seam is `PreviewPublisher` in ./preview.ts, not this file. Do not import
+ * these types expecting the engine to honor them (see docs/driver-spec.md).
+ *
+ * Drivers own TRANSPORT and STORAGE mechanics; the engine owns all POLICY
+ * (leases, hygiene, upkeep, idle and teardown, the load budget, error
+ * taxonomy). A driver that wants policy is a design bug.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/drivers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/drivers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@theford/runly",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.20.0",
+  "description": "The repo-aware environment broker: puts a working, seeded, provable instance of your web application in front of coding agents and humans — warm pools, leases, bind-by-sync. Brokers environments; never provides them.",
+  "keywords": [
+    "environment",
+    "broker",
+    "dev-environment",
+    "coding-agents",
+    "e2e",
+    "preview",
+    "warm-pool",
+    "sandbox",
+    "harness"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "bin": {
+    "runly": "dist/cli/index.js",
+    "backlot": "dist/cli/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.json && node scripts/mark-bin.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "coverage": "npm run build && rm -rf coverage && NODE_V8_COVERAGE=\"$PWD/coverage/tmp\" vitest run; c8 report --temp-directory coverage/tmp --report-dir coverage --reporter text --reporter lcov --exclude-after-remap --include 'src/**'",
+    "lint": "eslint src",
+    "pretest": "npm run build",
+    "prepublishOnly": "npm run build",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "c8": "12.0.0",
+    "eslint": "9.39.5",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "8.64.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "ajv": "^8.17.0",
+    "yaml": "^2.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ChristianKohlberg/backlot.git"
+  },
+  "homepage": "https://github.com/ChristianKohlberg/backlot#readme",
+  "bugs": {
+    "url": "https://github.com/ChristianKohlberg/backlot/issues"
+  },
+  "author": "Christian Kohlberg"
+}