backlot 0.4.0

package/dist/drivers/datastore-sqlite.js.map

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

package/dist/drivers/datastores.d.ts

@@ -0,0 +1,22 @@
+import type { DatastoreSpec } from '../core/manifest.js';
+export interface DsHandle {
+    envId: string;
+    envTree: string;
+    dataDir: string;
+}
+export interface DsDriver {
+    readonly name: string;
+    /** The ns for an environment: sqlite = file path; server = SQL-safe db name. */
+    ns(h: DsHandle): string;
+    /** The connection string services/checks receive. */
+    url(h: DsHandle): string;
+    /** infra-error (never code blame) when the external server is unreachable. */
+    probe(): Promise<void>;
+    /** Create/restore the namespace at the preset. force = recreate even if present. */
+    ensure(h: DsHandle, preset: string, force: boolean, exists: boolean): Promise<void>;
+    /** Best-effort removal (recycle). */
+    drop(h: DsHandle): Promise<void>;
+    /** @rebake-template: invalidate baked templates. */
+    rebake(): void;
+}
+export declare function makeDatastore(name: string, spec: DatastoreSpec, stackId: string): DsDriver;

package/dist/drivers/datastores.js

@@ -0,0 +1,190 @@
+/**
+ * Datastore drivers (see docs/driver-spec.md).
+ *
+ * Two families:
+ *  - sqlite: fully engine-native — the ns IS a file; template restore is a copy.
+ *  - command (postgres/mssql/mysql/redis): ALL mechanics are repo-declared
+ *    commands ({{ns}}/{{preset}}/{{template}} resolved by the engine). backlot
+ *    embeds no database clients — the anti-scope ("orchestrate, don't
+ *    reimplement") applied to data.
+ *
+ * Template model: bake once per seed-content hash into a template ns, then
+ * restore per environment (postgres: `createdb -T`; mssql: the repo's
+ * backup/restore script). Templates are machine-global and immutable-keyed
+ * (decision 0006/0008).
+ */
+import { copyFileSync, mkdirSync, rmSync, existsSync, writeFileSync, constants as fsConstants } from 'node:fs';
+import { join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { connect } from 'node:net';
+import { templatesRoot } from '../core/paths.js';
+import { sha256, template, BrokerError } from '../core/util.js';
+const sh = (cmd, cwd, errCtx) => new Promise((resolve, reject) => {
+    execFile('sh', ['-c', cmd], { cwd, maxBuffer: 16 * 1024 * 1024 }, (err, _out, stderr) => {
+        if (err)
+            reject(new BrokerError('work-error', errCtx, 'datastore', String(stderr).slice(0, 800)));
+        else
+            resolve();
+    });
+});
+const shQuiet = (cmd, cwd) => new Promise((resolve) => {
+    execFile('sh', ['-c', cmd], { cwd, maxBuffer: 16 * 1024 * 1024 }, () => resolve());
+});
+// ---------------------------------------------------------------- sqlite
+class SqliteDs {
+    name;
+    spec;
+    stackId;
+    constructor(name, spec, stackId) {
+        this.name = name;
+        this.spec = spec;
+        this.stackId = stackId;
+    }
+    ns(h) {
+        // The datastore KEY becomes a filename; a key with `/` or `..` must not
+        // escape dataDir (the command-family sibling already sanitizes — this
+        // closes the same hole here). Reject rather than mangle so a bad key is loud.
+        if (/[/\\]|\.\./.test(this.name)) {
+            throw new BrokerError('work-error', `sqlite datastore key '${this.name}' must not contain '/', '\\', or '..'`, 'manifest');
+        }
+        return join(h.dataDir, `${this.name}.db`);
+    }
+    url(h) {
+        return this.ns(h);
+    }
+    async probe() {
+        /* in-process — nothing external */
+    }
+    tplPath(preset) {
+        const dir = join(templatesRoot(), this.stackId);
+        mkdirSync(dir, { recursive: true });
+        return join(dir, `${this.name}-${preset}@${sha256(this.spec.create ?? '').slice(0, 12)}.db`);
+    }
+    async runCreate(envTree, ns, preset) {
+        if (!this.spec.create)
+            throw new BrokerError('work-error', `datastore '${this.name}' has no create: command`, 'datastore');
+        await sh(template(this.spec.create, { ns, preset }), envTree, `seed failed for '${this.name}' preset '${preset}'`);
+    }
+    async ensure(h, preset, force, exists) {
+        mkdirSync(h.dataDir, { recursive: true });
+        const dbPath = this.ns(h);
+        if (exists && !force && existsSync(dbPath))
+            return;
+        if (this.spec.template === true) {
+            const tpl = this.tplPath(preset);
+            if (!existsSync(tpl))
+                await this.runCreate(h.envTree, tpl, preset); // bake once
+            copyFileSync(tpl, dbPath, fsConstants.COPYFILE_FICLONE); // restore = CoW clone where the fs supports it
+        }
+        else {
+            await this.runCreate(h.envTree, dbPath, preset);
+        }
+    }
+    async drop(h) {
+        rmSync(this.ns(h), { force: true });
+    }
+    rebake() {
+        rmSync(join(templatesRoot(), this.stackId), { recursive: true, force: true });
+    }
+}
+// ---------------------------------------------------------------- command family
+class CommandDs {
+    name;
+    spec;
+    stackId;
+    constructor(name, spec, stackId) {
+        this.name = name;
+        this.spec = spec;
+        this.stackId = stackId;
+        if (!spec.url) {
+            throw new BrokerError('work-error', `datastore '${name}' (driver ${spec.driver}) needs a url: template with {{ns}}`, 'manifest');
+        }
+    }
+    get capabilities() {
+        return { template: Boolean(this.spec.template_restore), ephemeral: this.spec.ephemeral === true };
+    }
+    ns(h) {
+        return `backlot_${h.envId}`.replace(/[^A-Za-z0-9_]/g, '_');
+    }
+    url(h) {
+        return template(this.spec.url, { ns: this.ns(h) });
+    }
+    async probe() {
+        if (!this.spec.probe)
+            return;
+        const [host, portStr] = this.spec.probe.split(':');
+        const port = Number(portStr);
+        await new Promise((resolve, reject) => {
+            const sock = connect({ host: host || 'localhost', port, timeout: 3000 });
+            sock.once('connect', () => {
+                sock.end();
+                resolve();
+            });
+            const fail = () => reject(new BrokerError('infra-error', `datastore '${this.name}' unreachable at ${this.spec.probe} — is the server running?`, 'datastore'));
+            sock.once('error', fail);
+            sock.once('timeout', fail);
+        });
+    }
+    templateNs(preset) {
+        return `backlot_tpl_${this.stackId}_${preset}_${sha256(this.spec.create ?? '').slice(0, 8)}`.replace(/[^A-Za-z0-9_]/g, '_');
+    }
+    bakedMarker(preset) {
+        const dir = join(templatesRoot(), this.stackId);
+        mkdirSync(dir, { recursive: true });
+        return join(dir, `${this.name}-${preset}@${sha256(this.spec.create ?? '').slice(0, 12)}.baked`);
+    }
+    async ensure(h, preset, force, exists) {
+        const nsE = this.ns(h);
+        if (this.spec.ephemeral) {
+            // Ephemeral (redis-class): no presets, no templates — reset = the drop:
+            // command as a flush; create (optional) runs only on first bind.
+            if (force && exists && this.spec.drop)
+                await shQuiet(template(this.spec.drop, { ns: nsE }), h.envTree);
+            if (!exists && this.spec.create) {
+                await sh(template(this.spec.create, { ns: nsE, preset }), h.envTree, `create failed for ephemeral '${this.name}'`);
+            }
+            return;
+        }
+        if (exists && !force)
+            return;
+        if (!this.spec.create)
+            throw new BrokerError('work-error', `datastore '${this.name}' has no create: command`, 'datastore');
+        const ns = this.ns(h);
+        if (this.spec.drop)
+            await shQuiet(template(this.spec.drop, { ns }), h.envTree); // clean slate, best-effort
+        if (this.spec.template_restore) {
+            const tpl = this.templateNs(preset);
+            if (!existsSync(this.bakedMarker(preset))) {
+                await shQuiet(this.spec.drop ? template(this.spec.drop, { ns: tpl }) : 'true', h.envTree);
+                await sh(template(this.spec.create, { ns: tpl, preset }), h.envTree, `template bake failed for '${this.name}' preset '${preset}'`);
+                writeFileSync(this.bakedMarker(preset), tpl);
+            }
+            await sh(template(this.spec.template_restore, { template: tpl, ns }), h.envTree, `template restore failed for '${this.name}' preset '${preset}'`);
+        }
+        else {
+            await sh(template(this.spec.create, { ns, preset }), h.envTree, `seed failed for '${this.name}' preset '${preset}'`);
+        }
+    }
+    async drop(h) {
+        if (this.spec.drop)
+            await shQuiet(template(this.spec.drop, { ns: this.ns(h) }), h.envTree);
+    }
+    rebake() {
+        rmSync(join(templatesRoot(), this.stackId), { recursive: true, force: true });
+    }
+}
+// ---------------------------------------------------------------- factory
+export function makeDatastore(name, spec, stackId) {
+    switch (spec.driver) {
+        case 'sqlite':
+            return new SqliteDs(name, spec, stackId);
+        case 'postgres':
+        case 'mssql':
+        case 'mysql':
+        case 'redis':
+            return new CommandDs(name, spec, stackId);
+        default:
+            throw new BrokerError('work-error', `unknown datastore driver '${spec.driver}'`, 'manifest');
+    }
+}
+//# sourceMappingURL=datastores.js.map

package/dist/drivers/datastores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datastores.js","sourceRoot":"","sources":["../../src/drivers/datastores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/G,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyBhE,MAAM,EAAE,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,MAAc,EAAiB,EAAE,CACrE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QACtF,IAAI,GAAG;YAAE,MAAM,CAAC,IAAI,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;;YAC7F,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,GAAW,EAAiB,EAAE,CAC1D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;AACrF,CAAC,CAAC,CAAC;AAEL,0EAA0E;AAE1E,MAAM,QAAQ;IAED;IACQ;IACA;IAHnB,YACW,IAAY,EACJ,IAAmB,EACnB,OAAe;QAFvB,SAAI,GAAJ,IAAI,CAAQ;QACJ,SAAI,GAAJ,IAAI,CAAe;QACnB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,EAAE,CAAC,CAAW;QACZ,wEAAwE;QACxE,sEAAsE;QACtE,8EAA8E;QAC9E,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,yBAAyB,IAAI,CAAC,IAAI,uCAAuC,EAAE,UAAU,CAAC,CAAC;QAC7H,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,GAAG,CAAC,CAAW;QACb,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,KAAK,CAAC,KAAK;QACT,mCAAmC;IACrC,CAAC;IAEO,OAAO,CAAC,MAAc;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/F,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,EAAU,EAAE,MAAc;QACjE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,cAAc,IAAI,CAAC,IAAI,0BAA0B,EAAE,WAAW,CAAC,CAAC;QAC3H,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,oBAAoB,IAAI,CAAC,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;IACrH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,CAAW,EAAE,MAAc,EAAE,KAAc,EAAE,MAAe;QACvE,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,MAAM,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO;QACnD,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY;YAChF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,+CAA+C;QAC1G,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAW;QACpB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM;QACJ,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAED,kFAAkF;AAElF,MAAM,SAAS;IAEF;IACQ;IACA;IAHnB,YACW,IAAY,EACJ,IAAmB,EACnB,OAAe;QAFvB,SAAI,GAAJ,IAAI,CAAQ;QACJ,SAAI,GAAJ,IAAI,CAAe;QACnB,YAAO,GAAP,OAAO,CAAQ;QAEhC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,cAAc,IAAI,aAAa,IAAI,CAAC,MAAM,qCAAqC,EAAE,UAAU,CAAC,CAAC;QACnI,CAAC;IACH,CAAC;IAED,IAAI,YAAY;QACd,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;IACpG,CAAC;IAED,EAAE,CAAC,CAAW;QACZ,OAAO,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,GAAG,CAAC,CAAW;QACb,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAC7B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBACxB,IAAI,CAAC,GAAG,EAAE,CAAC;gBACX,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,GAAG,EAAE,CAChB,MAAM,CACJ,IAAI,WAAW,CAAC,aAAa,EAAE,cAAc,IAAI,CAAC,IAAI,oBAAoB,IAAI,CAAC,IAAI,CAAC,KAAK,2BAA2B,EAAE,WAAW,CAAC,CACnI,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,MAAc;QAC/B,OAAO,eAAe,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC9H,CAAC;IACO,WAAW,CAAC,MAAc;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,CAAW,EAAE,MAAc,EAAE,KAAc,EAAE,MAAe;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACxB,wEAAwE;YACxE,iEAAiE;YACjE,IAAI,KAAK,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACvG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,gCAAgC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACrH,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,MAAM,IAAI,CAAC,KAAK;YAAE,OAAO;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,cAAc,IAAI,CAAC,IAAI,0BAA0B,EAAE,WAAW,CAAC,CAAC;QAC3H,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;QAC3G,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAC1C,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC1F,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,6BAA6B,IAAI,CAAC,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;gBACnI,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,gCAAgC,IAAI,CAAC,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;QACpJ,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,oBAAoB,IAAI,CAAC,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;QACvH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAW;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM;QACJ,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAED,2EAA2E;AAE3E,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAmB,EAAE,OAAe;IAC9E,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C;YACE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,6BAA8B,IAA2B,CAAC,MAAM,GAAG,EAAE,UAAU,CAAC,CAAC;IACzH,CAAC;AACH,CAAC"}

package/dist/drivers/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * DESIGN TARGET — NOT YET WIRED. These are the FROZEN-FOR-0.3 shapes for the
+ * remote SUBSTRATE seam, which the engine does not yet call (v0.4 hardcodes
+ * local process supervision). The LIVE datastore seam is `DsDriver` in
+ * ./datastores.ts, not this file. Do not import these types expecting the
+ * engine to honor them; they exist so the substrate interface is designed
+ * before it is built (see docs/driver-spec.md).
+ *
+ * Drivers own TRANSPORT and STORAGE mechanics; the engine owns all POLICY
+ * (pooling, leases, hygiene, upkeep, sync, 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>;
+    /** A git remote/path the sync layer can fetch/push through. */
+    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 backlot'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,14 @@
+/**
+ * DESIGN TARGET — NOT YET WIRED. These are the FROZEN-FOR-0.3 shapes for the
+ * remote SUBSTRATE seam, which the engine does not yet call (v0.4 hardcodes
+ * local process supervision). The LIVE datastore seam is `DsDriver` in
+ * ./datastores.ts, not this file. Do not import these types expecting the
+ * engine to honor them; they exist so the substrate interface is designed
+ * before it is built (see docs/driver-spec.md).
+ *
+ * Drivers own TRANSPORT and STORAGE mechanics; the engine owns all POLICY
+ * (pooling, leases, hygiene, upkeep, sync, 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;;;;;;;;;;;GAWG"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/mcp/index.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * Minimal MCP (Model Context Protocol) server over stdio — a THIN adapter on
+ * the same daemon RPC the CLI uses (decision 0014: never a second
+ * implementation). Newline-delimited JSON-RPC 2.0; implements initialize,
+ * tools/list, tools/call. Start with:  backlot-mcp  (or node dist/mcp/index.js)
+ *
+ * Every tool result is the same JSON the CLI's --json emits, as text content.
+ */
+import { createInterface } from 'node:readline';
+import { ensureDaemon, rpc } from '../cli/client.js';
+const PROTOCOL = '2025-06-18';
+const cwdProp = {
+    cwd: { type: 'string', description: 'Worktree directory (a stack.yaml is found upward from here). REQUIRED — the MCP server has no meaningful cwd of its own.' },
+};
+const TOOLS = [
+    {
+        name: 'backlot_up',
+        description: 'Lease a warm environment for this worktree: sync, upkeep, seed, start services. Returns the context blob (URLs, logins, connection strings).',
+        inputSchema: { type: 'object', properties: { ...cwdProp, hygiene: { type: 'string', enum: ['reuse', 'reset-data', 'pristine'] } }, required: ['cwd'] },
+        verb: 'up',
+    },
+    {
+        name: 'backlot_run',
+        description: 'Run a named check from stack.yaml against a fresh binding: verdict with ok/exitCode/failure taxonomy (work-error = your code, env-error = environment, infra-error = external), artifacts dir, outputs_changed.',
+        inputSchema: { type: 'object', properties: { ...cwdProp, check: { type: 'string' }, hygiene: { type: 'string', enum: ['reuse', 'reset-data', 'pristine'] } }, required: ['cwd', 'check'] },
+        verb: 'run',
+    },
+    {
+        name: 'backlot_ctx',
+        description: 'The current lease context: service URLs, logins, token command, datastore connection strings, artifacts dir, recent service events.',
+        inputSchema: { type: 'object', properties: { ...cwdProp }, required: ['cwd'] },
+        verb: 'ctx',
+    },
+    {
+        name: 'backlot_sync',
+        description: 'Project the worktree state (including dirty/untracked files) into the leased environment; services restart only if the source changed.',
+        inputSchema: { type: 'object', properties: { ...cwdProp }, required: ['cwd'] },
+        verb: 'sync',
+    },
+    {
+        name: 'backlot_exec',
+        description: 'Run a shell command inside the leased environment tree (BACKLOT_URL_*/BACKLOT_DS_* env injected).',
+        inputSchema: { type: 'object', properties: { ...cwdProp, cmd: { type: 'string' } }, required: ['cwd', 'cmd'] },
+        verb: 'exec',
+    },
+    {
+        name: 'backlot_logs',
+        description: 'Tail a supervised service log from the leased environment.',
+        inputSchema: { type: 'object', properties: { ...cwdProp, service: { type: 'string' }, lines: { type: 'number' } }, required: ['cwd', 'service'] },
+        verb: 'logs',
+    },
+    {
+        name: 'backlot_reset_data',
+        description: 'Restore the data template on the current lease (replay a repro against pristine data). URLs stay stable.',
+        inputSchema: { type: 'object', properties: { ...cwdProp }, required: ['cwd'] },
+        verb: 'reset-data',
+    },
+    {
+        name: 'backlot_pull',
+        description: 'Copy the environment\'s changed declared outputs (regenerated lockfiles, generated clients) back into the worktree — the only sanctioned write-back.',
+        inputSchema: { type: 'object', properties: { ...cwdProp }, required: ['cwd'] },
+        verb: 'pull',
+    },
+    {
+        name: 'backlot_token',
+        description: 'Mint an auth token via the stack\'s auth.token hook (resolves {{role}}). Returns {token, role}.',
+        inputSchema: { type: 'object', properties: { ...cwdProp, role: { type: 'string', description: 'Role to mint for (default admin).' } }, required: ['cwd'] },
+        verb: 'token',
+    },
+    {
+        name: 'backlot_release',
+        description: 'Release the current lease; the environment returns to the pool warm.',
+        inputSchema: { type: 'object', properties: { ...cwdProp }, required: ['cwd'] },
+        verb: 'release',
+    },
+    {
+        name: 'backlot_status',
+        description: 'Pool overview: environments, states, leases, recent daemon events.',
+        inputSchema: { type: 'object', properties: {} },
+        verb: 'status',
+    },
+    {
+        name: 'backlot_doctor',
+        description: 'Active health check of the pool: pid divergence, stuck-recycling envs, plus recent events.',
+        inputSchema: { type: 'object', properties: {} },
+        verb: 'doctor',
+    },
+];
+function respond(id, result) {
+    process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id, result }) + '\n');
+}
+function respondError(id, code, message) {
+    process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id, error: { code, message } }) + '\n');
+}
+const rl = createInterface({ input: process.stdin });
+rl.on('line', (line) => {
+    void (async () => {
+        if (!line.trim())
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            return respondError(null, -32700, 'parse error');
+        }
+        const { id, method, params } = msg;
+        try {
+            switch (method) {
+                case 'initialize':
+                    return respond(id, {
+                        protocolVersion: PROTOCOL,
+                        capabilities: { tools: {} },
+                        serverInfo: { name: 'backlot', version: '0.4.0' },
+                    });
+                case 'notifications/initialized':
+                    return; // notification — no response
+                case 'ping':
+                    return respond(id, {});
+                case 'tools/list':
+                    return respond(id, { tools: TOOLS.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })) });
+                case 'tools/call': {
+                    const toolName = String(params?.name);
+                    const tool = TOOLS.find((t) => t.name === toolName);
+                    if (!tool)
+                        return respondError(id, -32602, `unknown tool '${toolName}'`);
+                    const args = (params?.arguments ?? {});
+                    await ensureDaemon();
+                    const res = await rpc(tool.verb, args);
+                    const text = JSON.stringify(res.ok ? res.data : { error: res.error });
+                    return respond(id, { content: [{ type: 'text', text }], isError: !res.ok });
+                }
+                default:
+                    if (id !== undefined)
+                        return respondError(id, -32601, `method '${method}' not found`);
+            }
+        }
+        catch (err) {
+            return respondError(id, -32603, String(err.message ?? err));
+        }
+    })();
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "backlot",
+  "version": "0.4.0",
+  "description": "The repo-aware environment broker: puts a working, seeded, provable instance of your web application in front of coding agents and humans \u2014 warm pools, leases, bind-by-sync. Brokers environments; never provides them.",
+  "keywords": [
+    "environment",
+    "broker",
+    "dev-environment",
+    "coding-agents",
+    "e2e",
+    "preview",
+    "warm-pool",
+    "sandbox",
+    "harness",
+    "mcp"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "bin": {
+    "backlot": "./dist/cli/index.js",
+    "backlot-mcp": "./dist/mcp/index.js"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "pretest": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.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"
+}