@enderfga/claw-orchestrator 3.7.1 → 4.0.0

package/dist/src/ultraapp/router.js.map

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

package/dist/src/ultraapp/spec-delta.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Spec-delta — focused mini-interview when the user's done-mode feedback
+ * implies an AppSpec change rather than a cosmetic patch.
+ *
+ * Reuses the existing interview engine wholesale: we only inject a bootstrap
+ * system message naming the slots in scope and flip the run's mode back to
+ * 'interview'. The user then answers as in v0.1, and on [INTERVIEW: COMPLETE]
+ * the existing build flow takes over (council rerun is wired in v0.5+ — for
+ * v0.5 the user clicks Start Build manually for the focused rerun).
+ */
+import type { AppSpec } from './spec.js';
+interface SpecDeltaManagerLike {
+    injectSystemMessage(runId: string, text: string): Promise<void>;
+    setModeForDelta(runId: string): Promise<void>;
+}
+export declare function composeDeltaBootstrap(spec: AppSpec, feedback: string): string;
+export declare function startSpecDeltaInterview(manager: SpecDeltaManagerLike, runId: string, feedback: string, currentSpec: AppSpec): Promise<void>;
+export {};

package/dist/src/ultraapp/spec-delta.js

@@ -0,0 +1,35 @@
+/**
+ * Spec-delta — focused mini-interview when the user's done-mode feedback
+ * implies an AppSpec change rather than a cosmetic patch.
+ *
+ * Reuses the existing interview engine wholesale: we only inject a bootstrap
+ * system message naming the slots in scope and flip the run's mode back to
+ * 'interview'. The user then answers as in v0.1, and on [INTERVIEW: COMPLETE]
+ * the existing build flow takes over (council rerun is wired in v0.5+ — for
+ * v0.5 the user clicks Start Build manually for the focused rerun).
+ */
+export function composeDeltaBootstrap(spec, feedback) {
+    return `The user has a previously-deployed ultraapp with the AppSpec below. They've
+just sent feedback that requires a spec change. Run a FOCUSED interview that
+asks ONLY about the slots that need to change to honour the feedback. Do not
+re-confirm slots that are unaffected.
+
+When the focused interview is done, call check_completeness and emit
+[INTERVIEW: COMPLETE] as usual. The user can then click Start Build to
+trigger a delta-aware council rerun.
+
+## Existing AppSpec
+
+\`\`\`json
+${JSON.stringify(spec, null, 2)}
+\`\`\`
+
+## User feedback
+
+${feedback}`;
+}
+export async function startSpecDeltaInterview(manager, runId, feedback, currentSpec) {
+    await manager.injectSystemMessage(runId, composeDeltaBootstrap(currentSpec, feedback));
+    await manager.setModeForDelta(runId);
+}
+//# sourceMappingURL=spec-delta.js.map

package/dist/src/ultraapp/spec-delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-delta.js","sourceRoot":"","sources":["../../../src/ultraapp/spec-delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,UAAU,qBAAqB,CAAC,IAAa,EAAE,QAAgB;IACnE,OAAO;;;;;;;;;;;;EAYP,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;EAK7B,QAAQ,EAAE,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA6B,EAC7B,KAAa,EACb,QAAgB,EAChB,WAAoB;IAEpB,MAAM,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvF,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/ultraapp/spec.d.ts

@@ -0,0 +1,82 @@
+export interface AppSpec {
+    version: 1;
+    runId: string;
+    createdAt: string;
+    updatedAt: string;
+    meta: {
+        name: string;
+        title: string;
+        description: string;
+    };
+    inputs: AppSpecInput[];
+    outputs: AppSpecOutput[];
+    pipeline: {
+        steps: AppSpecStep[];
+    };
+    runtime: AppSpecRuntime;
+    ui: AppSpecUi;
+}
+export interface AppSpecInput {
+    name: string;
+    type: 'file' | 'files' | 'text' | 'enum' | 'number';
+    accept?: string;
+    required: boolean;
+    description: string;
+    examples?: Array<{
+        ref: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    enumValues?: string[];
+}
+export interface AppSpecOutput {
+    name: string;
+    type: 'file' | 'text' | 'json' | 'image-gallery' | 'video';
+    description: string;
+}
+export interface AppSpecStep {
+    id: string;
+    description: string;
+    inputs: string[];
+    outputs: string[];
+    hints: {
+        likelyTools?: string[];
+        referenceCommand?: string;
+        referenceCode?: string;
+        notes?: string;
+    };
+    validates: {
+        outputType: string;
+    };
+}
+export interface AppSpecRuntime {
+    needsLLM: boolean;
+    llmProviders: Array<'anthropic' | 'openai' | 'google'>;
+    binaryDeps: string[];
+    estimatedRuntimeSec: number;
+    estimatedFileSizeMB: number;
+}
+export interface AppSpecUi {
+    layout: 'single-form' | 'wizard' | 'split-view';
+    showProgress: boolean;
+    accentColor?: string;
+}
+export declare function makeEmptySpec(runId: string): AppSpec;
+/**
+ * Lax shape check for intermediate AppSpec writes during interview iteration.
+ * Catches obviously-broken state but tolerates partial pipelines, references
+ * to inputs not yet declared, etc. — Claude builds the spec incrementally and
+ * transient invalid states are expected. Strict cross-ref + DAG check happens
+ * at startBuild via {@link validateAppSpec}.
+ */
+export declare function validateAppSpecShape(spec: AppSpec): void;
+/**
+ * Strict validation: shape + every pipeline step's input refs must resolve to
+ * a declared input or a prior step + the pipeline DAG must be acyclic. Called
+ * at startBuild; do NOT call from writeSpec (that fires on every interview
+ * patch and Claude iterates incrementally).
+ */
+export declare function validateAppSpec(spec: AppSpec): void;
+export declare function isComplete(spec: AppSpec): {
+    ok: boolean;
+    missing: string[];
+};

package/dist/src/ultraapp/spec.js

@@ -0,0 +1,125 @@
+const NAME_RE = /^[a-z0-9][a-z0-9-]{2,31}$/;
+export function makeEmptySpec(runId) {
+    const now = new Date().toISOString();
+    return {
+        version: 1,
+        runId,
+        createdAt: now,
+        updatedAt: now,
+        meta: { name: '', title: '', description: '' },
+        inputs: [],
+        outputs: [],
+        pipeline: { steps: [] },
+        runtime: {
+            needsLLM: false,
+            llmProviders: [],
+            binaryDeps: [],
+            estimatedRuntimeSec: 0,
+            estimatedFileSizeMB: 0,
+        },
+        ui: { layout: 'single-form', showProgress: false },
+    };
+}
+/**
+ * Lax shape check for intermediate AppSpec writes during interview iteration.
+ * Catches obviously-broken state but tolerates partial pipelines, references
+ * to inputs not yet declared, etc. — Claude builds the spec incrementally and
+ * transient invalid states are expected. Strict cross-ref + DAG check happens
+ * at startBuild via {@link validateAppSpec}.
+ */
+export function validateAppSpecShape(spec) {
+    if (spec.version !== 1)
+        throw new Error('AppSpec.version must be 1');
+    if (typeof spec.runId !== 'string' || spec.runId.length === 0) {
+        throw new Error('AppSpec.runId required');
+    }
+    if (spec.meta.name && !NAME_RE.test(spec.meta.name)) {
+        throw new Error('AppSpec.meta.name must match [a-z0-9][a-z0-9-]{2,31}');
+    }
+}
+/**
+ * Strict validation: shape + every pipeline step's input refs must resolve to
+ * a declared input or a prior step + the pipeline DAG must be acyclic. Called
+ * at startBuild; do NOT call from writeSpec (that fires on every interview
+ * patch and Claude iterates incrementally).
+ */
+export function validateAppSpec(spec) {
+    validateAppSpecShape(spec);
+    const stepIds = new Set(spec.pipeline.steps.map((s) => s.id));
+    const inputNames = new Set(spec.inputs.map((i) => i.name));
+    for (const step of spec.pipeline.steps) {
+        for (const ref of step.inputs) {
+            if (ref.startsWith('inputs.')) {
+                const k = ref.slice('inputs.'.length);
+                if (!inputNames.has(k)) {
+                    throw new Error(`pipeline step '${step.id}': unknown ref '${ref}'`);
+                }
+            }
+            else {
+                const [stepId] = ref.split('.');
+                if (!stepIds.has(stepId)) {
+                    throw new Error(`pipeline step '${step.id}': unknown ref '${ref}'`);
+                }
+            }
+        }
+    }
+    const incoming = new Map();
+    for (const s of spec.pipeline.steps)
+        incoming.set(s.id, new Set());
+    for (const s of spec.pipeline.steps) {
+        for (const ref of s.inputs) {
+            if (!ref.startsWith('inputs.')) {
+                const [src] = ref.split('.');
+                incoming.get(s.id).add(src);
+            }
+        }
+    }
+    const queue = [];
+    for (const s of spec.pipeline.steps) {
+        if (incoming.get(s.id).size === 0)
+            queue.push(s.id);
+    }
+    let visited = 0;
+    while (queue.length) {
+        const id = queue.shift();
+        visited++;
+        for (const s of spec.pipeline.steps) {
+            const deps = incoming.get(s.id);
+            if (deps.has(id)) {
+                deps.delete(id);
+                if (deps.size === 0)
+                    queue.push(s.id);
+            }
+        }
+    }
+    if (visited !== spec.pipeline.steps.length)
+        throw new Error('pipeline has a cycle');
+}
+export function isComplete(spec) {
+    const missing = [];
+    if (!spec.meta.name)
+        missing.push('meta.name');
+    if (!spec.meta.title)
+        missing.push('meta.title');
+    if (!spec.meta.description)
+        missing.push('meta.description');
+    if (spec.inputs.length === 0) {
+        missing.push('inputs[0]');
+    }
+    else {
+        spec.inputs.forEach((inp, i) => {
+            if (!inp.name)
+                missing.push(`inputs[${i}].name`);
+            if (!inp.type)
+                missing.push(`inputs[${i}].type`);
+            if (!inp.description)
+                missing.push(`inputs[${i}].description`);
+        });
+    }
+    if (spec.outputs.length === 0)
+        missing.push('outputs[0]');
+    if (spec.pipeline.steps.length === 0)
+        missing.push('pipeline.steps[0]');
+    return { ok: missing.length === 0, missing };
+}
+//# sourceMappingURL=spec.js.map

package/dist/src/ultraapp/spec.js.map

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

package/dist/src/ultraapp/store.d.ts

@@ -0,0 +1,67 @@
+import { type AppSpec } from './spec.js';
+export type RunMode = 'interview' | 'queued' | 'building' | 'build-complete' | 'deploying' | 'done' | 'failed' | 'cancelled';
+export interface DeployInfo {
+    url: string;
+    port: number;
+    containerName: string;
+    imageTag: string;
+}
+export interface RunState {
+    runId: string;
+    mode: RunMode;
+    createdAt: string;
+    updatedAt: string;
+    failure?: string;
+}
+export interface RunSummary {
+    runId: string;
+    mode: RunMode;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ChatEntry {
+    role: 'assistant' | 'user' | 'system';
+    kind: 'question' | 'answer' | 'free' | 'narrator' | 'error';
+    text: string;
+    payload?: Record<string, unknown>;
+    ts?: string;
+}
+export interface SpecHistoryEntry {
+    ts: string;
+    source: 'interview' | 'manual-edit';
+    spec: AppSpec;
+}
+export declare class UltraappStore {
+    private readonly root;
+    constructor(root: string);
+    createRun(): Promise<string>;
+    listRuns(): Promise<RunSummary[]>;
+    readState(runId: string): Promise<RunState>;
+    setMode(runId: string, mode: RunMode, failure?: string): Promise<void>;
+    readSpec(runId: string): Promise<AppSpec>;
+    writeSpec(runId: string, spec: AppSpec, source?: SpecHistoryEntry['source']): Promise<void>;
+    readSpecHistory(runId: string): Promise<SpecHistoryEntry[]>;
+    appendChat(runId: string, entry: ChatEntry): Promise<void>;
+    readChat(runId: string): Promise<ChatEntry[]>;
+    examplesDir(runId: string): string;
+    worktreesDir(runId: string): string;
+    versionsDir(runId: string): string;
+    runDirAbsolute(runId: string): string;
+    recordBuildArtifact(runId: string, args: {
+        worktreePath: string;
+        version: string;
+    }): Promise<void>;
+    readArtifacts(runId: string): Promise<Array<{
+        version: string;
+        worktreePath: string;
+        builtAt: string;
+        deploy?: DeployInfo;
+        deployedAt?: string;
+    }>>;
+    recordDeploy(runId: string, version: string, deploy: DeployInfo): Promise<void>;
+    deleteRunFiles(runId: string): Promise<void>;
+    rootDir(): string;
+    private runDir;
+}
+export declare function defaultStoreRoot(): string;

package/dist/src/ultraapp/store.js

@@ -0,0 +1,177 @@
+import * as fs from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { makeEmptySpec, validateAppSpecShape } from './spec.js';
+export class UltraappStore {
+    root;
+    constructor(root) {
+        this.root = root;
+        fs.mkdirSync(root, { recursive: true });
+    }
+    async createRun() {
+        const id = `ua-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+        const dir = this.runDir(id);
+        await fsp.mkdir(dir, { recursive: true });
+        await fsp.mkdir(path.join(dir, 'examples'), { recursive: true });
+        const now = new Date().toISOString();
+        const state = { runId: id, mode: 'interview', createdAt: now, updatedAt: now };
+        await fsp.writeFile(path.join(dir, 'state.json'), JSON.stringify(state, null, 2));
+        const spec = makeEmptySpec(id);
+        await fsp.writeFile(path.join(dir, 'spec.json'), JSON.stringify(spec, null, 2));
+        return id;
+    }
+    async listRuns() {
+        let entries;
+        try {
+            entries = await fsp.readdir(this.root);
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const e of entries) {
+            if (!e.startsWith('ua-'))
+                continue;
+            try {
+                const state = await this.readState(e);
+                const spec = await this.readSpec(e);
+                out.push({
+                    runId: e,
+                    mode: state.mode,
+                    title: spec.meta.title || spec.meta.name || '(untitled)',
+                    createdAt: state.createdAt,
+                    updatedAt: state.updatedAt,
+                });
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        out.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+        return out;
+    }
+    async readState(runId) {
+        const raw = await fsp.readFile(path.join(this.runDir(runId), 'state.json'), 'utf8');
+        return JSON.parse(raw);
+    }
+    async setMode(runId, mode, failure) {
+        const state = await this.readState(runId);
+        state.mode = mode;
+        state.updatedAt = new Date().toISOString();
+        if (failure !== undefined)
+            state.failure = failure;
+        await fsp.writeFile(path.join(this.runDir(runId), 'state.json'), JSON.stringify(state, null, 2));
+    }
+    async readSpec(runId) {
+        const raw = await fsp.readFile(path.join(this.runDir(runId), 'spec.json'), 'utf8');
+        return JSON.parse(raw);
+    }
+    async writeSpec(runId, spec, source = 'interview') {
+        spec.updatedAt = new Date().toISOString();
+        // Lax shape-only check: cross-ref + DAG strict checks happen at startBuild,
+        // not on every interview patch. Claude iterates incrementally and transient
+        // invalid states (e.g., a step refs an input not yet declared) are normal.
+        validateAppSpecShape(spec);
+        const dir = this.runDir(runId);
+        await fsp.writeFile(path.join(dir, 'spec.json'), JSON.stringify(spec, null, 2));
+        const entry = { ts: spec.updatedAt, source, spec };
+        await fsp.appendFile(path.join(dir, 'spec.history.jsonl'), JSON.stringify(entry) + '\n');
+        const state = await this.readState(runId);
+        state.updatedAt = spec.updatedAt;
+        await fsp.writeFile(path.join(dir, 'state.json'), JSON.stringify(state, null, 2));
+    }
+    async readSpecHistory(runId) {
+        try {
+            const raw = await fsp.readFile(path.join(this.runDir(runId), 'spec.history.jsonl'), 'utf8');
+            return raw
+                .split('\n')
+                .filter((l) => l.length > 0)
+                .map((l) => JSON.parse(l));
+        }
+        catch {
+            return [];
+        }
+    }
+    async appendChat(runId, entry) {
+        const e = { ...entry, ts: entry.ts ?? new Date().toISOString() };
+        await fsp.appendFile(path.join(this.runDir(runId), 'chat.jsonl'), JSON.stringify(e) + '\n');
+    }
+    async readChat(runId) {
+        try {
+            const raw = await fsp.readFile(path.join(this.runDir(runId), 'chat.jsonl'), 'utf8');
+            return raw
+                .split('\n')
+                .filter((l) => l.length > 0)
+                .map((l) => JSON.parse(l));
+        }
+        catch {
+            return [];
+        }
+    }
+    examplesDir(runId) {
+        return path.join(this.runDir(runId), 'examples');
+    }
+    worktreesDir(runId) {
+        return path.join(this.runDir(runId), 'worktrees');
+    }
+    versionsDir(runId) {
+        return path.join(this.runDir(runId), 'versions');
+    }
+    runDirAbsolute(runId) {
+        return this.runDir(runId);
+    }
+    async recordBuildArtifact(runId, args) {
+        const dir = path.join(this.versionsDir(runId), args.version);
+        await fsp.mkdir(dir, { recursive: true });
+        await fsp.writeFile(path.join(dir, 'artifact.json'), JSON.stringify({ worktreePath: args.worktreePath, builtAt: new Date().toISOString() }, null, 2));
+    }
+    async readArtifacts(runId) {
+        try {
+            const versions = await fsp.readdir(this.versionsDir(runId));
+            const out = [];
+            for (const v of versions) {
+                try {
+                    const a = JSON.parse(await fsp.readFile(path.join(this.versionsDir(runId), v, 'artifact.json'), 'utf8'));
+                    out.push({
+                        version: v,
+                        worktreePath: a.worktreePath,
+                        builtAt: a.builtAt,
+                        deploy: a.deploy,
+                        deployedAt: a.deployedAt,
+                    });
+                }
+                catch {
+                    /* skip */
+                }
+            }
+            return out.sort((a, b) => a.version.localeCompare(b.version));
+        }
+        catch {
+            return [];
+        }
+    }
+    async recordDeploy(runId, version, deploy) {
+        const file = path.join(this.versionsDir(runId), version, 'artifact.json');
+        const cur = JSON.parse(await fsp.readFile(file, 'utf8'));
+        cur.deploy = deploy;
+        cur.deployedAt = new Date().toISOString();
+        await fsp.writeFile(file, JSON.stringify(cur, null, 2));
+    }
+    async deleteRunFiles(runId) {
+        await fsp.rm(this.runDir(runId), { recursive: true, force: true });
+    }
+    rootDir() {
+        return this.root;
+    }
+    runDir(runId) {
+        if (!/^ua-[a-zA-Z0-9-]+$/.test(runId))
+            throw new Error(`bad runId: ${runId}`);
+        return path.join(this.root, runId);
+    }
+}
+export function defaultStoreRoot() {
+    const home = process.env.HOME ?? process.cwd();
+    return path.join(home, '.claw-orchestrator', 'ultraapps');
+}
+//# sourceMappingURL=store.js.map

package/dist/src/ultraapp/store.js.map

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

package/dist/src/ultraapp/versions.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Version snapshot + swap mechanics.
+ *
+ * Each successful patcher / spec-delta / structural-rerun bumps a version.
+ * Versions live under `<runDir>/versions/v1/`, `v2/`, ..., each with their
+ * own `artifact.json` carrying worktreePath + (optionally) deploy info.
+ *
+ * `swapVersion` atomically retargets the router: deregister current slug,
+ * stop current container, start new container, register slug to new port.
+ */
+export interface DeployInfoLite {
+    url: string;
+    port: number;
+    containerName: string;
+    imageTag: string;
+}
+export interface VersionEntry {
+    version: string;
+    worktreePath: string;
+    builtAt: string;
+    source?: string;
+    deploy?: DeployInfoLite;
+}
+export declare function listVersions(versionsDir: string): VersionEntry[];
+export declare function snapshotVersion(versionsDir: string, args: {
+    worktreePath: string;
+    source: string;
+}): string;
+export interface SwapArgs {
+    versionsDir: string;
+    fromVersion: string;
+    toVersion: string;
+    slug: string;
+    router: {
+        register: (slug: string, port: number) => void;
+        deregister: (slug: string) => void;
+    };
+    startContainer: (containerName: string) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    stopContainer: (containerName: string) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+}
+export declare function swapVersion(args: SwapArgs): Promise<{
+    ok: boolean;
+    error?: string;
+}>;

package/dist/src/ultraapp/versions.js

@@ -0,0 +1,65 @@
+/**
+ * Version snapshot + swap mechanics.
+ *
+ * Each successful patcher / spec-delta / structural-rerun bumps a version.
+ * Versions live under `<runDir>/versions/v1/`, `v2/`, ..., each with their
+ * own `artifact.json` carrying worktreePath + (optionally) deploy info.
+ *
+ * `swapVersion` atomically retargets the router: deregister current slug,
+ * stop current container, start new container, register slug to new port.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export function listVersions(versionsDir) {
+    if (!fs.existsSync(versionsDir))
+        return [];
+    const out = [];
+    for (const v of fs.readdirSync(versionsDir)) {
+        try {
+            const a = JSON.parse(fs.readFileSync(path.join(versionsDir, v, 'artifact.json'), 'utf8'));
+            out.push({ version: v, ...a });
+        }
+        catch {
+            /* skip non-version dirs */
+        }
+    }
+    out.sort((a, b) => parseVersionNumber(a.version) - parseVersionNumber(b.version));
+    return out;
+}
+function parseVersionNumber(version) {
+    const m = /^v(\d+)$/.exec(version);
+    return m ? parseInt(m[1], 10) : Number.MAX_SAFE_INTEGER;
+}
+export function snapshotVersion(versionsDir, args) {
+    fs.mkdirSync(versionsDir, { recursive: true });
+    const existing = listVersions(versionsDir);
+    const next = `v${existing.length + 1}`;
+    const dir = path.join(versionsDir, next);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, 'artifact.json'), JSON.stringify({
+        worktreePath: args.worktreePath,
+        builtAt: new Date().toISOString(),
+        source: args.source,
+    }, null, 2));
+    return next;
+}
+export async function swapVersion(args) {
+    const versions = listVersions(args.versionsDir);
+    const from = versions.find((v) => v.version === args.fromVersion);
+    const to = versions.find((v) => v.version === args.toVersion);
+    if (!to?.deploy) {
+        return { ok: false, error: `target version ${args.toVersion} has no deploy info` };
+    }
+    args.router.deregister(args.slug);
+    if (from?.deploy) {
+        await args.stopContainer(from.deploy.containerName).catch(() => {
+            /* best effort */
+        });
+    }
+    const r = await args.startContainer(to.deploy.containerName);
+    if (!r.ok)
+        return { ok: false, error: r.error };
+    args.router.register(args.slug, to.deploy.port);
+    return { ok: true };
+}
+//# sourceMappingURL=versions.js.map