@descryy/runtime-controller 0.3.7 → 0.3.8

package/dist/orchestration.d.ts

@@ -1,55 +0,0 @@
-/**
- * Turns a declarative `services` map (§6, RT-028) into a concrete spawn order for
- * `ExecutionController.run()` (RT-032). Pure and side-effect-free -- validated and
- * ordered before anything is spawned, so a bad reference is refused atomically
- * rather than discovered mid-sequence.
- *
- * Start order and port injection are declared, never inferred (RT-023's "ask, don't
- * guess"): a `${name.port}` reference alone doesn't create an ordering guarantee --
- * `name` must also appear in the referencing service's `dependsOn`, or validation refuses.
- */
-import type { ServiceConfiguration } from "@descryy/runtime-contracts";
-export type ServicesValidation = {
-    readonly valid: true;
-    readonly order: readonly string[];
-} | {
-    readonly valid: false;
-    readonly reason: string;
-};
-/**
- * Validates a `services` map and returns a topological spawn order. Checks, all
- * before anything is spawned: every `dependsOn` names a real key; the `dependsOn`
- * graph has no cycle; every `${name}.port` placeholder in a service's `env` has
- * `name` in that service's own `dependsOn`.
- */
-export declare function validateServicesConfiguration(services: Readonly<Record<string, ServiceConfiguration>>): ServicesValidation;
-/**
- * Replaces every `${name}.port` in `env`'s values with the resolved port for `name`.
- * Assumes `validateServicesConfiguration` already confirmed the reference. An
- * unresolvable reference is left untouched, not dropped -- a caller that skipped
- * validation sees an obviously-wrong literal instead of a silent empty substitution.
- */
-export declare function substitutePortPlaceholders(env: Readonly<Record<string, string>> | undefined, resolvedPorts: ReadonlyMap<string, number>): Record<string, string>;
-export type CommandTokenization = {
-    readonly ok: true;
-    readonly command: string;
-    readonly args: readonly string[];
-} | {
-    readonly ok: false;
-    readonly reason: string;
-};
-/**
- * POSIX-style tokenizer for `ServiceConfiguration.command`: single quotes (literal),
- * double quotes (`\` escapes `"` and `\`), backslash escapes outside quotes. Needed
- * because config carries one string (§6) but `spawnProcess` wants `command`/`args`
- * separately, and plain whitespace-split breaks paths with spaces.
- *
- * Refuses rather than guesses on an unterminated quote, trailing backslash, or
- * unquoted shell operator -- a plausible-but-wrong tokenization would disguise a
- * config error as an application failure.
- *
- * Globs and `~` pass through literally, unrefused -- exactly what happens with no
- * shell, and frequently intended literally.
- */
-export declare function tokenizeCommand(raw: string): CommandTokenization;
-//# sourceMappingURL=orchestration.d.ts.map

package/dist/orchestration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../src/orchestration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAUvE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,GACvD,kBAAkB,CAyDpB;AAkCD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACjD,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAWpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CA6EhE"}

package/dist/orchestration.js

@@ -1,219 +0,0 @@
-/**
- * Turns a declarative `services` map (§6, RT-028) into a concrete spawn order for
- * `ExecutionController.run()` (RT-032). Pure and side-effect-free -- validated and
- * ordered before anything is spawned, so a bad reference is refused atomically
- * rather than discovered mid-sequence.
- *
- * Start order and port injection are declared, never inferred (RT-023's "ask, don't
- * guess"): a `${name.port}` reference alone doesn't create an ordering guarantee --
- * `name` must also appear in the referencing service's `dependsOn`, or validation refuses.
- */
-// Bounded at {1,256}, not `+`: RT-070's regex audit (after RT-069's ReDoS finding in
-// evidence-store/redaction.ts) flagged this exact shape -- unbounded class followed by
-// a literal (`.port}`) that can be absent -- as O(n^2) backtracking on a long
-// unterminated string. Low-risk since `service.env` is developer-authored, not
-// adversarial, but the shape matches a real same-day DoS elsewhere. 256 is far more
-// than any real name needs.
-const PORT_PLACEHOLDER = /\$\{([^}]{1,256})\.port\}/g;
-/**
- * Validates a `services` map and returns a topological spawn order. Checks, all
- * before anything is spawned: every `dependsOn` names a real key; the `dependsOn`
- * graph has no cycle; every `${name}.port` placeholder in a service's `env` has
- * `name` in that service's own `dependsOn`.
- */
-export function validateServicesConfiguration(services) {
-    const names = Object.keys(services);
-    for (const name of names) {
-        for (const dep of services[name]?.dependsOn ?? []) {
-            if (!(dep in services)) {
-                return { valid: false, reason: `service "${name}" depends on "${dep}", which is not in services` };
-            }
-        }
-    }
-    const orderResult = topologicalOrder(services, names);
-    if (!orderResult.valid) {
-        return orderResult;
-    }
-    for (const name of names) {
-        const declared = new Set(services[name]?.dependsOn ?? []);
-        for (const value of Object.values(services[name]?.env ?? {})) {
-            for (const match of value.matchAll(PORT_PLACEHOLDER)) {
-                const referenced = match[1];
-                if (referenced !== undefined && !declared.has(referenced)) {
-                    return {
-                        valid: false,
-                        reason: `service "${name}" references "\${${referenced}.port}" in env but does not declare "${referenced}" in dependsOn`,
-                    };
-                }
-            }
-        }
-    }
-    // Exactly one of `command`/`attach` per service, checked before spawning.
-    // Neither: nothing tells run() how to start it. Both: ambiguous, don't guess.
-    for (const name of names) {
-        const service = services[name];
-        const hasCommand = service?.command !== undefined;
-        const hasAttach = service?.attach !== undefined;
-        if (hasCommand === hasAttach) {
-            return {
-                valid: false,
-                reason: `service "${name}" must declare exactly one of "command" (spawn) or "attach" (attach to an already-running process), not ${hasCommand ? "both" : "neither"}`,
-            };
-        }
-    }
-    // A command that can't be tokenized is a config error -- check before spawning
-    // rather than discovering it mid-sequence with earlier services already running.
-    for (const name of names) {
-        const command = services[name]?.command;
-        if (command === undefined)
-            continue;
-        const tokenized = tokenizeCommand(command);
-        if (!tokenized.ok) {
-            return { valid: false, reason: `service "${name}": ${tokenized.reason}` };
-        }
-    }
-    return orderResult;
-}
-function topologicalOrder(services, names) {
-    const order = [];
-    const visited = new Set();
-    const visiting = new Set();
-    function visit(name) {
-        if (visited.has(name))
-            return null;
-        if (visiting.has(name))
-            return `cycle detected in dependsOn involving "${name}"`;
-        visiting.add(name);
-        for (const dep of services[name]?.dependsOn ?? []) {
-            const err = visit(dep);
-            if (err !== null)
-                return err;
-        }
-        visiting.delete(name);
-        visited.add(name);
-        order.push(name);
-        return null;
-    }
-    for (const name of names) {
-        const err = visit(name);
-        if (err !== null) {
-            return { valid: false, reason: err };
-        }
-    }
-    return { valid: true, order };
-}
-/**
- * Replaces every `${name}.port` in `env`'s values with the resolved port for `name`.
- * Assumes `validateServicesConfiguration` already confirmed the reference. An
- * unresolvable reference is left untouched, not dropped -- a caller that skipped
- * validation sees an obviously-wrong literal instead of a silent empty substitution.
- */
-export function substitutePortPlaceholders(env, resolvedPorts) {
-    const result = {};
-    for (const [key, value] of Object.entries(env ?? {})) {
-        result[key] = value.replace(PORT_PLACEHOLDER, (literal, name) => {
-            const port = resolvedPorts.get(name);
-            return port === undefined ? literal : String(port);
-        });
-    }
-    return result;
-}
-/**
- * Shell operators that only mean anything to a shell. `spawnProcess` uses
- * `child_process.spawn` without one -- no implicit shell, no injection surface. A
- * command containing these was never going to behave as written; refusing beats the
- * old whitespace-split behavior of silently passing `> out.log` as literal args to
- * `node`. `sh -c "..."` still works for anyone who wants a real shell.
- */
-const SHELL_OPERATORS = new Set(["|", "&", ";", "<", ">", "`", "$"]);
-/**
- * POSIX-style tokenizer for `ServiceConfiguration.command`: single quotes (literal),
- * double quotes (`\` escapes `"` and `\`), backslash escapes outside quotes. Needed
- * because config carries one string (§6) but `spawnProcess` wants `command`/`args`
- * separately, and plain whitespace-split breaks paths with spaces.
- *
- * Refuses rather than guesses on an unterminated quote, trailing backslash, or
- * unquoted shell operator -- a plausible-but-wrong tokenization would disguise a
- * config error as an application failure.
- *
- * Globs and `~` pass through literally, unrefused -- exactly what happens with no
- * shell, and frequently intended literally.
- */
-export function tokenizeCommand(raw) {
-    const tokens = [];
-    let current = "";
-    let started = false; // distinguishes an empty quoted token ('') from no token
-    let quote = null;
-    for (let i = 0; i < raw.length; i++) {
-        const char = raw[i];
-        if (quote === "'") {
-            if (char === "'")
-                quote = null;
-            else
-                current += char;
-            continue;
-        }
-        if (quote === '"') {
-            if (char === "\\") {
-                const next = raw[i + 1];
-                if (next === undefined)
-                    return { ok: false, reason: 'command ends with a trailing backslash inside a double-quoted string, which escapes nothing' };
-                // Only `"` and `\` are escapable in double quotes; else keep the backslash.
-                if (next === '"' || next === "\\") {
-                    current += next;
-                    i++;
-                }
-                else {
-                    current += char;
-                }
-                continue;
-            }
-            if (char === '"')
-                quote = null;
-            else
-                current += char;
-            continue;
-        }
-        if (char === "'" || char === '"') {
-            quote = char;
-            started = true;
-            continue;
-        }
-        if (char === "\\") {
-            const next = raw[i + 1];
-            if (next === undefined)
-                return { ok: false, reason: "command ends with a trailing backslash, which escapes nothing" };
-            current += next;
-            started = true;
-            i++;
-            continue;
-        }
-        if (SHELL_OPERATORS.has(char)) {
-            return {
-                ok: false,
-                reason: `command contains the shell operator "${char}" outside quotes, but processes are spawned without a shell — ` +
-                    `it would be passed to the program as a literal argument rather than interpreted. ` +
-                    `Use an explicit shell (sh -c "...") if that is what you meant.`,
-            };
-        }
-        if (/\s/.test(char)) {
-            if (started) {
-                tokens.push(current);
-                current = "";
-                started = false;
-            }
-            continue;
-        }
-        current += char;
-        started = true;
-    }
-    if (quote !== null)
-        return { ok: false, reason: `command has an unterminated ${quote === '"' ? "double" : "single"} quote` };
-    if (started)
-        tokens.push(current);
-    const [head, ...rest] = tokens;
-    if (head === undefined || head === "")
-        return { ok: false, reason: "command is empty" };
-    return { ok: true, command: head, args: rest };
-}
-//# sourceMappingURL=orchestration.js.map

package/dist/orchestration.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestration.js","sourceRoot":"","sources":["../src/orchestration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,qFAAqF;AACrF,uFAAuF;AACvF,8EAA8E;AAC9E,+EAA+E;AAC/E,oFAAoF;AACpF,4BAA4B;AAC5B,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAMtD;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAAwD;IAExD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,IAAI,iBAAiB,GAAG,6BAA6B,EAAE,CAAC;YACrG,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;YAC7D,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACrD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC1D,OAAO;wBACL,KAAK,EAAE,KAAK;wBACZ,MAAM,EAAE,YAAY,IAAI,oBAAoB,UAAU,wCAAwC,UAAU,gBAAgB;qBACzH,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,8EAA8E;IAC9E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC;QAChD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,YAAY,IAAI,2GAA2G,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE;aACrK,CAAC;QACJ,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,iFAAiF;IACjF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,IAAI,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAwD,EACxD,KAAwB;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,SAAS,KAAK,CAAC,IAAY;QACzB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,0CAA0C,IAAI,GAAG,CAAC;QACjF,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,GAAG,CAAC;QAC/B,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAiD,EACjD,aAA0C;IAE1C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,IAAY,EAAE,EAAE;YACtE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAMD;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC,CAAC,yDAAyD;IAC9E,IAAI,KAAK,GAAqB,IAAI,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QAErB,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,IAAI,IAAI,KAAK,GAAG;gBAAE,KAAK,GAAG,IAAI,CAAC;;gBAC1B,OAAO,IAAI,IAAI,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxB,IAAI,IAAI,KAAK,SAAS;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6FAA6F,EAAE,CAAC;gBACpJ,4EAA4E;gBAC5E,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClC,OAAO,IAAI,IAAI,CAAC;oBAChB,CAAC,EAAE,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAI,IAAI,CAAC;gBAClB,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG;gBAAE,KAAK,GAAG,IAAI,CAAC;;gBAC1B,OAAO,IAAI,IAAI,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,+DAA+D,EAAE,CAAC;YACtH,OAAO,IAAI,IAAI,CAAC;YAChB,OAAO,GAAG,IAAI,CAAC;YACf,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EACJ,wCAAwC,IAAI,gEAAgE;oBAC5G,mFAAmF;oBACnF,gEAAgE;aACnE,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;YACD,SAAS;QACX,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;QAChB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,QAAQ,EAAE,CAAC;IAC7H,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;IAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/preflight.d.ts

@@ -1,121 +0,0 @@
-/**
- * Ready check before a run (RT-263). A broken setup used to be discovered only after a
- * full readiness wait (up to `RunOptions.readiness[*].timeoutMs`, often ~30s-2min) had
- * already failed. This runs a short, read-only pass first — the same declared checks a
- * run is about to depend on, single-shot rather than polled to a full timeout — and
- * reports a plain-words problem and fix before the caller starts anything.
- *
- * Deliberately generic: this module owns the engine (status, timing, disclosure), never
- * a specific check's mechanism it would have to import a language, a browser, a graph
- * store or a database driver to perform. `customCheck` is the seam every one of those
- * uses — `chromiumCanLaunch`, `graphExists`, and any future "database reachable" check
- * are built by the caller that already depends on the thing being checked, and handed in
- * as a probe. Nothing here decides what a broken setup is, only how many of the caller's
- * own answers it takes to call one "ready", "partial" or "broken".
- *
- * **Read-only, always.** Every probe built here (`portFreeCheck`, `portAnswersCheck`,
- * `readinessTargetCheck`) only ever connects or asks; none binds a port, starts a
- * process or writes anything. A `customCheck` probe is the caller's own code and this
- * module cannot enforce that discipline on it, but every caller in this codebase that
- * builds one must hold to it too (Build A step 4).
- */
-import { type ReadinessCheck } from "./readiness.ts";
-export declare const PREFLIGHT_CHECK_KINDS: readonly ["port", "readiness", "chromium", "graph", "database", "custom"];
-export type PreflightCheckKind = (typeof PREFLIGHT_CHECK_KINDS)[number];
-export declare const PREFLIGHT_STATUSES: readonly ["ready", "partial", "broken"];
-export type PreflightStatus = (typeof PREFLIGHT_STATUSES)[number];
-/**
- * Bounds one check's own probe — not the whole preflight. Every check in a call runs
- * concurrently (`Promise.all`), so a caller with several checks still finishes near this
- * bound rather than their sum. Starting value, not a measurement: it is what lets a
- * `broken` setup report within the lane's 5s target while still giving a slow-but-honest
- * TCP probe (a loaded machine, a container cold-starting) more than an instant to answer.
- */
-export declare const PREFLIGHT_CHECK_TIMEOUT_MS = 4000;
-export interface PreflightProbeOutcome {
-    readonly ok: boolean;
-    /**
-     * Plain words, always — this is what the user sees. When `!ok`, names the exact
-     * problem AND the fix ("Nothing is listening on localhost:3000. Is your app
-     * running?"), never a bare boolean or a stack trace. Ignored (by convention "ok")
-     * when `ok` is true.
-     */
-    readonly message: string;
-}
-export interface PreflightCheckSpec {
-    readonly kind: PreflightCheckKind;
-    /** Named for the report — "port 3000 is free", "chromium can launch". */
-    readonly label: string;
-    /**
-     * A failing required check makes the whole preflight `broken` — this run cannot
-     * proceed without it. A failing non-required check makes it `partial` instead: the
-     * run continues, and the failure becomes a disclosed gap (what won't be observed),
-     * never silently dropped (rule 7).
-     */
-    readonly required: boolean;
-    readonly probe: () => Promise<PreflightProbeOutcome>;
-}
-export interface PreflightCheckResult {
-    readonly kind: PreflightCheckKind;
-    readonly label: string;
-    readonly required: boolean;
-    readonly ok: boolean;
-    readonly message: string;
-}
-export interface PreflightResult {
-    readonly status: PreflightStatus;
-    readonly elapsedMs: number;
-    readonly checks: readonly PreflightCheckResult[];
-    /**
-     * Plain-word problems from every failed non-required check — what this run will
-     * proceed without observing. Empty exactly when `status === "ready"`. A `broken`
-     * result's problems are read off `checks` instead (every failed required check),
-     * because those stop the run rather than being disclosed alongside it.
-     */
-    readonly disclosures: readonly string[];
-}
-/**
- * Runs every check concurrently and folds the results into one status. Never throws —
- * a probe that rejects or hangs past its own bound is recorded as a failed check
- * (`runOne` below), not a crash of the preflight itself, because "the check broke" and
- * "the setup is broken" are different facts the caller still needs told apart... except
- * they aren't told apart here: a check that cannot even answer is exactly as blocking as
- * one that answered "no", which is why it is folded in as `!ok` rather than a third
- * outcome. What is preserved is the message, which always names which check and why.
- */
-export declare function runPreflight(checks: readonly PreflightCheckSpec[]): Promise<PreflightResult>;
-/**
- * Boot precondition: nothing may already be listening at `host:port` before this run
- * spawns its own process there — a stale listener from a dead session would otherwise
- * be mistaken for this run's own (the same RT-024 hazard `readiness.ts` names). `ready`
- * is `!answered` — the inverse polarity of `portAnswersCheck` below, for the attach case.
- */
-export declare function portFreeCheck(host: string, port: number, label?: string): PreflightCheckSpec;
-/**
- * Attach precondition: the caller is attaching to an app it expects to already be
- * running, so something must already answer at `host:port`. `ready` is `answered` —
- * the inverse polarity of `portFreeCheck` above, for the boot case.
- */
-export declare function portAnswersCheck(host: string, port: number, label?: string): PreflightCheckSpec;
-/**
- * Wraps a run's own declared `ReadinessCheck`s as a single-shot preflight probe — one
- * pass at `PREFLIGHT_CHECK_TIMEOUT_MS`, never the full poll loop `awaitReadiness` runs
- * once the run actually starts. Reuses `awaitReadiness` itself rather than a second
- * probing mechanism that could drift from what the real readiness wait checks.
- *
- * Required by default: a target this run declared and cannot reach is this run being
- * broken, not a gap it can disclose and continue past. A caller may mark a secondary
- * target `required: false` when the run can genuinely proceed without it.
- */
-export declare function readinessTargetCheck(label: string, checks: readonly ReadinessCheck[], options?: {
-    readonly required?: boolean;
-}): PreflightCheckSpec;
-/**
- * The seam for anything this package must not name (rule 1's dependency-direction
- * cousin: `@descryy/runtime-controller` has no browser, graph or database dependency,
- * and must not gain one just to phrase a preflight check). A caller that already
- * depends on the thing being checked — `@descryy/runtime-browser` for Chromium,
- * `@descryy/mcp` for the graph — builds the probe and hands it in with this.
- */
-export declare function customCheck(kind: PreflightCheckKind, label: string, required: boolean, probe: () => Promise<PreflightProbeOutcome>): PreflightCheckSpec;
-//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErE,eAAO,MAAM,qBAAqB,2EAA4E,CAAC;AAC/G,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,eAAO,MAAM,kBAAkB,yCAA0C,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAUlG;AA+CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAgB5F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAW/F;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5C,kBAAkB,CAUpB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,GAC1C,kBAAkB,CAEpB"}

package/dist/preflight.js

@@ -1,163 +0,0 @@
-/**
- * Ready check before a run (RT-263). A broken setup used to be discovered only after a
- * full readiness wait (up to `RunOptions.readiness[*].timeoutMs`, often ~30s-2min) had
- * already failed. This runs a short, read-only pass first — the same declared checks a
- * run is about to depend on, single-shot rather than polled to a full timeout — and
- * reports a plain-words problem and fix before the caller starts anything.
- *
- * Deliberately generic: this module owns the engine (status, timing, disclosure), never
- * a specific check's mechanism it would have to import a language, a browser, a graph
- * store or a database driver to perform. `customCheck` is the seam every one of those
- * uses — `chromiumCanLaunch`, `graphExists`, and any future "database reachable" check
- * are built by the caller that already depends on the thing being checked, and handed in
- * as a probe. Nothing here decides what a broken setup is, only how many of the caller's
- * own answers it takes to call one "ready", "partial" or "broken".
- *
- * **Read-only, always.** Every probe built here (`portFreeCheck`, `portAnswersCheck`,
- * `readinessTargetCheck`) only ever connects or asks; none binds a port, starts a
- * process or writes anything. A `customCheck` probe is the caller's own code and this
- * module cannot enforce that discipline on it, but every caller in this codebase that
- * builds one must hold to it too (Build A step 4).
- */
-import { createConnection } from "node:net";
-import { awaitReadiness } from "./readiness.js";
-export const PREFLIGHT_CHECK_KINDS = ["port", "readiness", "chromium", "graph", "database", "custom"];
-export const PREFLIGHT_STATUSES = ["ready", "partial", "broken"];
-/**
- * Bounds one check's own probe — not the whole preflight. Every check in a call runs
- * concurrently (`Promise.all`), so a caller with several checks still finishes near this
- * bound rather than their sum. Starting value, not a measurement: it is what lets a
- * `broken` setup report within the lane's 5s target while still giving a slow-but-honest
- * TCP probe (a loaded machine, a container cold-starting) more than an instant to answer.
- */
-export const PREFLIGHT_CHECK_TIMEOUT_MS = 4_000;
-/**
- * Runs every check concurrently and folds the results into one status. Never throws —
- * a probe that rejects or hangs past its own bound is recorded as a failed check
- * (`runOne` below), not a crash of the preflight itself, because "the check broke" and
- * "the setup is broken" are different facts the caller still needs told apart... except
- * they aren't told apart here: a check that cannot even answer is exactly as blocking as
- * one that answered "no", which is why it is folded in as `!ok` rather than a third
- * outcome. What is preserved is the message, which always names which check and why.
- */
-export async function runPreflight(checks) {
-    const startedAt = Date.now();
-    const results = await Promise.all(checks.map((check) => runOne(check)));
-    const elapsedMs = Date.now() - startedAt;
-    const brokenChecks = results.filter((result) => result.required && !result.ok);
-    const gaps = results.filter((result) => !result.required && !result.ok);
-    const status = brokenChecks.length > 0 ? "broken" : gaps.length > 0 ? "partial" : "ready";
-    return { status, elapsedMs, checks: results, disclosures: gaps.map((gap) => gap.message) };
-}
-async function runOne(check) {
-    try {
-        const outcome = await withTimeout(check.probe(), PREFLIGHT_CHECK_TIMEOUT_MS, check.label);
-        return { kind: check.kind, label: check.label, required: check.required, ok: outcome.ok, message: outcome.message };
-    }
-    catch (error) {
-        return {
-            kind: check.kind,
-            label: check.label,
-            required: check.required,
-            ok: false,
-            message: `${check.label}: the check itself did not complete — ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-}
-function withTimeout(promise, ms, label) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => reject(new Error(`no answer within ${String(ms)}ms while checking ${label}`)), ms);
-        promise.then((value) => {
-            clearTimeout(timer);
-            resolve(value);
-        }, (error) => {
-            clearTimeout(timer);
-            reject(error instanceof Error ? error : new Error(String(error)));
-        });
-    });
-}
-function tcpAnswers(host, port) {
-    return new Promise((resolve) => {
-        const socket = createConnection({ host, port });
-        socket.setTimeout(PREFLIGHT_CHECK_TIMEOUT_MS);
-        const finish = (ok) => {
-            socket.destroy();
-            resolve(ok);
-        };
-        socket.once("connect", () => finish(true));
-        socket.once("error", () => finish(false));
-        socket.once("timeout", () => finish(false));
-    });
-}
-/**
- * Boot precondition: nothing may already be listening at `host:port` before this run
- * spawns its own process there — a stale listener from a dead session would otherwise
- * be mistaken for this run's own (the same RT-024 hazard `readiness.ts` names). `ready`
- * is `!answered` — the inverse polarity of `portAnswersCheck` below, for the attach case.
- */
-export function portFreeCheck(host, port, label) {
-    const checkLabel = label ?? `port ${String(port)} on ${host} is free`;
-    return {
-        kind: "port",
-        label: checkLabel,
-        required: true,
-        probe: async () => {
-            const answered = await tcpAnswers(host, port);
-            return answered
-                ? {
-                    ok: false,
-                    message: `Something is already listening on ${host}:${String(port)}. Stop it, or configure a different port, before starting this run.`,
-                }
-                : { ok: true, message: "ok" };
-        },
-    };
-}
-/**
- * Attach precondition: the caller is attaching to an app it expects to already be
- * running, so something must already answer at `host:port`. `ready` is `answered` —
- * the inverse polarity of `portFreeCheck` above, for the boot case.
- */
-export function portAnswersCheck(host, port, label) {
-    const checkLabel = label ?? `${host}:${String(port)} answers`;
-    return {
-        kind: "port",
-        label: checkLabel,
-        required: true,
-        probe: async () => {
-            const answered = await tcpAnswers(host, port);
-            return answered ? { ok: true, message: "ok" } : { ok: false, message: `Nothing is listening on ${host}:${String(port)}. Is your app running?` };
-        },
-    };
-}
-/**
- * Wraps a run's own declared `ReadinessCheck`s as a single-shot preflight probe — one
- * pass at `PREFLIGHT_CHECK_TIMEOUT_MS`, never the full poll loop `awaitReadiness` runs
- * once the run actually starts. Reuses `awaitReadiness` itself rather than a second
- * probing mechanism that could drift from what the real readiness wait checks.
- *
- * Required by default: a target this run declared and cannot reach is this run being
- * broken, not a gap it can disclose and continue past. A caller may mark a secondary
- * target `required: false` when the run can genuinely proceed without it.
- */
-export function readinessTargetCheck(label, checks, options = {}) {
-    return {
-        kind: "readiness",
-        label,
-        required: options.required ?? true,
-        probe: async () => {
-            const result = await awaitReadiness(checks, { timeoutMs: PREFLIGHT_CHECK_TIMEOUT_MS, pollIntervalMs: 200 });
-            return result.ready ? { ok: true, message: "ok" } : { ok: false, message: result.reason ?? `${label} did not answer` };
-        },
-    };
-}
-/**
- * The seam for anything this package must not name (rule 1's dependency-direction
- * cousin: `@descryy/runtime-controller` has no browser, graph or database dependency,
- * and must not gain one just to phrase a preflight check). A caller that already
- * depends on the thing being checked — `@descryy/runtime-browser` for Chromium,
- * `@descryy/mcp` for the graph — builds the probe and hands it in with this.
- */
-export function customCheck(kind, label, required, probe) {
-    return { kind, label, required, probe };
-}
-//# sourceMappingURL=preflight.js.map

package/dist/preflight.js.map

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

package/dist/process-collector.d.ts

@@ -1,20 +0,0 @@
-/**
- * `ProcessCollector`: turns `ProcessLifecycleEvent` (`controller.ts`) into
- * `PROCESS_STARTED` / `PROCESS_READY` / `PROCESS_EXITED` Evidence. A plain translator
- * with no lifecycle logic of its own — `ExecutionController` decides when each
- * transition happens and calls `RunOptions.onProcessLifecycleEvent`; this collector
- * just turns that call into one `context.emit()`.
- *
- * **Wiring order is load-bearing.** `start(context)` must run before
- * `onProcessLifecycleEvent` can fire. `handleLifecycleEvent` throws rather than
- * silently dropping an event on violation — a lost PROCESS_STARTED would otherwise
- * read downstream as "never observed," a worse, quieter failure than a thrown error.
- */
-import type { Collector } from "@descryy/runtime-contracts";
-import type { ProcessLifecycleEvent } from "./controller.ts";
-export interface ProcessCollector extends Collector {
-    /** Wire as `RunOptions.onProcessLifecycleEvent` — see the module doc for the ordering this depends on. */
-    handleLifecycleEvent(event: ProcessLifecycleEvent): void;
-}
-export declare function createProcessCollector(): ProcessCollector;
-//# sourceMappingURL=process-collector.d.ts.map

package/dist/process-collector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"process-collector.d.ts","sourceRoot":"","sources":["../src/process-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmF,MAAM,4BAA4B,CAAC;AAC7I,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,0GAA0G;IAC1G,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC1D;AA6DD,wBAAgB,sBAAsB,IAAI,gBAAgB,CAoDzD"}