smol-symphony 0.1.0 → 0.2.0

package/dist/actions/parsing.js

@@ -0,0 +1,273 @@
+// Parse a per-state `actions:` block into typed records (issue 36).
+//
+// Lifts the YAML shape into the closed `WorkflowAction` union, validating
+// each kind's required fields up-front so a missing `head:` on
+// `create_pr_if_missing` (or a misspelled `kind:`) fails at workflow load
+// instead of at the first dispatch into the terminal state.
+import { WorkflowError } from '../errors.js';
+const KNOWN_KINDS = [
+    'push_branch',
+    'create_pr_if_missing',
+    'ensure_branch',
+    'checkout',
+    'merge',
+    'delete_branch',
+    'run_in_vm',
+    'propose_followup',
+];
+function asString(v) {
+    return typeof v === 'string' ? v : null;
+}
+function asInt(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return Math.trunc(v);
+    if (typeof v === 'string' && /^-?\d+$/.test(v))
+        return parseInt(v, 10);
+    return null;
+}
+function expectString(stateName, idx, kind, key, v) {
+    const s = asString(v);
+    if (s === null || s.length === 0) {
+        throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (${kind}): "${key}" must be a non-empty string`);
+    }
+    return s;
+}
+function parsePredicate(stateName, idx, raw) {
+    if (raw === undefined || raw === null)
+        return null;
+    if (typeof raw === 'string')
+        return raw;
+    if (typeof raw === 'object' && !Array.isArray(raw)) {
+        const m = raw;
+        if (typeof m.branch_exists === 'string')
+            return { branch_exists: m.branch_exists };
+        if (typeof m.file_present === 'string')
+            return { file_present: m.file_present };
+    }
+    throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] "if" must be a "$var" string, {branch_exists: <ref>}, or {file_present: <path>}`);
+}
+function parseErrorPolicy(stateName, idx, raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] "on_error" must be a map`);
+    }
+    const m = raw;
+    const out = {};
+    if (m.retry !== undefined) {
+        if (typeof m.retry !== 'object' || m.retry === null || Array.isArray(m.retry)) {
+            throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] "on_error.retry" must be a map`);
+        }
+        const r = m.retry;
+        const count = asInt(r.count);
+        const backoff = asInt(r.backoff_ms);
+        if (count === null || count < 0) {
+            throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] "on_error.retry.count" must be a non-negative integer`);
+        }
+        if (backoff === null || backoff < 0) {
+            throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] "on_error.retry.backoff_ms" must be a non-negative integer`);
+        }
+        out.retry = { count, backoff_ms: backoff };
+    }
+    if (m.then !== undefined) {
+        if (m.then === 'abort') {
+            out.then = 'abort';
+        }
+        else if (typeof m.then === 'object' &&
+            !Array.isArray(m.then) &&
+            typeof m.then.route_to === 'string') {
+            out.then = { route_to: m.then.route_to };
+        }
+        else {
+            throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] "on_error.then" must be "abort" or {route_to: <state>}`);
+        }
+    }
+    return out;
+}
+function parseAction(stateName, idx, raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] must be a map with a "kind" field`);
+    }
+    const m = raw;
+    const kind = asString(m.kind);
+    if (!kind || !KNOWN_KINDS.includes(kind)) {
+        throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] "kind" must be one of: ${KNOWN_KINDS.join(', ')} (got: ${String(m.kind)})`);
+    }
+    const base = {
+        name: asString(m.name) ?? undefined,
+        if: parsePredicate(stateName, idx, m.if),
+        on_error: parseErrorPolicy(stateName, idx, m.on_error),
+    };
+    // Strip undefined to keep parsed records clean (deep-equal in tests).
+    const cleanBase = {};
+    if (base.name !== undefined)
+        cleanBase.name = base.name;
+    if (base.if !== null)
+        cleanBase.if = base.if;
+    if (base.on_error !== undefined)
+        cleanBase.on_error = base.on_error;
+    switch (kind) {
+        case 'push_branch':
+            return {
+                kind: 'push_branch',
+                remote: expectString(stateName, idx, kind, 'remote', m.remote),
+                ref: expectString(stateName, idx, kind, 'ref', m.ref),
+                ...cleanBase,
+            };
+        case 'create_pr_if_missing':
+            return {
+                kind: 'create_pr_if_missing',
+                base: expectString(stateName, idx, kind, 'base', m.base),
+                head: expectString(stateName, idx, kind, 'head', m.head),
+                title_from: expectString(stateName, idx, kind, 'title_from', m.title_from),
+                body_from: expectString(stateName, idx, kind, 'body_from', m.body_from),
+                ...cleanBase,
+            };
+        case 'ensure_branch':
+            return {
+                kind: 'ensure_branch',
+                name: expectString(stateName, idx, kind, 'name', m.name),
+                seed_from: asString(m.seed_from) ?? undefined,
+                ...cleanBase,
+            };
+        case 'checkout':
+            return {
+                kind: 'checkout',
+                ref: expectString(stateName, idx, kind, 'ref', m.ref),
+                ...cleanBase,
+            };
+        case 'merge': {
+            const onConflictRaw = m.on_conflict;
+            let onConflict;
+            if (onConflictRaw === 'abort') {
+                onConflict = 'abort';
+            }
+            else if (typeof onConflictRaw === 'object' &&
+                onConflictRaw !== null &&
+                !Array.isArray(onConflictRaw) &&
+                typeof onConflictRaw.route_to === 'string') {
+                onConflict = { route_to: onConflictRaw.route_to };
+            }
+            else {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (merge): "on_conflict" must be "abort" or {route_to: <state>}`);
+            }
+            return {
+                kind: 'merge',
+                source: expectString(stateName, idx, kind, 'source', m.source),
+                target: expectString(stateName, idx, kind, 'target', m.target),
+                on_conflict: onConflict,
+                ...cleanBase,
+            };
+        }
+        case 'delete_branch': {
+            const scope = asString(m.scope);
+            if (scope !== 'local' && scope !== 'remote' && scope !== 'both') {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (delete_branch): "scope" must be one of local|remote|both`);
+            }
+            const remote = asString(m.remote) ?? undefined;
+            if ((scope === 'remote' || scope === 'both') && !remote) {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (delete_branch): "remote" is required when scope includes "remote"`);
+            }
+            return {
+                kind: 'delete_branch',
+                name: expectString(stateName, idx, kind, 'name', m.name),
+                scope,
+                remote,
+                ...cleanBase,
+            };
+        }
+        case 'run_in_vm': {
+            const name = asString(m.name);
+            if (!name || name.length === 0) {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (run_in_vm): "name" is required (used by cache + rerun CLI)`);
+            }
+            // Names are used as a path segment in the cache layout
+            // (`<root>/actions/run_in_vm/<name>/<hash>/result.json`). Restrict to a
+            // safe identifier set so `--check=<name>` is unambiguous and no name
+            // can escape the namespace (e.g. via `..`). The cache layer also
+            // defensively encodes unsafe chars, but rejecting at parse time keeps
+            // the CLI surface honest.
+            if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name)) {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (run_in_vm): "name" must match /^[A-Za-z0-9][A-Za-z0-9._-]*$/ (got: ${JSON.stringify(name)})`);
+            }
+            const cmdRaw = m.cmd;
+            if (!Array.isArray(cmdRaw) || cmdRaw.length === 0 || !cmdRaw.every((s) => typeof s === 'string')) {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (run_in_vm): "cmd" must be a non-empty list of strings`);
+            }
+            const envRaw = m.env;
+            let env;
+            if (envRaw !== undefined) {
+                if (typeof envRaw !== 'object' || envRaw === null || Array.isArray(envRaw)) {
+                    throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (run_in_vm): "env" must be a map of string→string`);
+                }
+                env = {};
+                for (const [k, v] of Object.entries(envRaw)) {
+                    if (typeof v !== 'string') {
+                        throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (run_in_vm): env["${k}"] must be a string`);
+                    }
+                    env[k] = v;
+                }
+            }
+            const timeout = m.timeout === undefined ? undefined : asInt(m.timeout);
+            if (m.timeout !== undefined && (timeout === null || timeout === undefined || timeout <= 0)) {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (run_in_vm): "timeout" must be a positive integer (seconds)`);
+            }
+            const action = {
+                kind: 'run_in_vm',
+                name,
+                cmd: cmdRaw,
+                ...cleanBase,
+            };
+            if (env !== undefined)
+                action.env = env;
+            if (timeout !== undefined && timeout !== null)
+                action.timeout = timeout;
+            return action;
+        }
+        case 'propose_followup': {
+            const labelsRaw = m.labels;
+            let labels;
+            if (labelsRaw !== undefined) {
+                if (!Array.isArray(labelsRaw) || !labelsRaw.every((s) => typeof s === 'string')) {
+                    throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (propose_followup): "labels" must be a list of strings`);
+                }
+                labels = labelsRaw;
+            }
+            const priority = m.priority === undefined ? undefined : asInt(m.priority);
+            if (m.priority !== undefined && priority === null) {
+                throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions[${idx}] (propose_followup): "priority" must be an integer`);
+            }
+            const action = {
+                kind: 'propose_followup',
+                title: expectString(stateName, idx, kind, 'title', m.title),
+                ...cleanBase,
+            };
+            const body = asString(m.body);
+            if (body !== null)
+                action.body = body;
+            if (labels !== undefined)
+                action.labels = labels;
+            if (priority !== undefined && priority !== null)
+                action.priority = priority;
+            return action;
+        }
+        default: {
+            // Exhaustiveness check at the type level — adding a new kind to the union
+            // without extending this switch is a TypeScript error.
+            const _exhaustive = kind;
+            void _exhaustive;
+            throw new WorkflowError('workflow_parse_error', `unreachable action kind: ${String(kind)}`);
+        }
+    }
+}
+export function parseActionsBlock(stateName, raw) {
+    if (raw === undefined)
+        return undefined;
+    if (raw === null)
+        return [];
+    if (!Array.isArray(raw)) {
+        throw new WorkflowError('workflow_parse_error', `state "${stateName}": actions must be a list of typed action records`);
+    }
+    return raw.map((entry, idx) => parseAction(stateName, idx, entry));
+}
+//# sourceMappingURL=parsing.js.map

package/dist/actions/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../src/actions/parsing.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,0EAA0E;AAC1E,+DAA+D;AAC/D,0EAA0E;AAC1E,4DAA4D;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQ7C,MAAM,WAAW,GAAkC;IACjD,aAAa;IACb,sBAAsB;IACtB,eAAe;IACf,UAAU;IACV,OAAO;IACP,eAAe;IACf,WAAW;IACX,kBAAkB;CACV,CAAC;AAEX,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,SAAS,KAAK,CAAC,CAAU;IACvB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,SAAiB,EAAE,GAAW,EAAE,IAAY,EAAE,GAAW,EAAE,CAAU;IACzF,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,MAAM,IAAI,OAAO,GAAG,8BAA8B,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB,EAAE,GAAW,EAAE,GAAY;IAClE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ;YAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;QACnF,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;YAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,mFAAmF,CACxH,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,GAAW,EAAE,GAAY;IACpE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACxD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,4BAA4B,CACjE,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,kCAAkC,CACvE,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAgC,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,yDAAyD,CAC9F,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,8DAA8D,CACnG,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;QACrB,CAAC;aAAM,IACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YACtB,OAAQ,CAAC,CAAC,IAAgC,CAAC,QAAQ,KAAK,QAAQ,EAChE,CAAC;YACD,GAAG,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAG,CAAC,CAAC,IAA+B,CAAC,QAAS,EAAE,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,0DAA0D,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,GAAW,EAAE,GAAY;IAC/D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,qCAAqC,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,4BAA4B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAClH,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS;QACnC,EAAE,EAAE,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACxC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC;KACvD,CAAC;IACF,sEAAsE;IACtE,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxD,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI;QAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAEpE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC9D,GAAG,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC;gBACrD,GAAG,SAAS;aACb,CAAC;QACJ,KAAK,sBAAsB;YACzB,OAAO;gBACL,IAAI,EAAE,sBAAsB;gBAC5B,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;gBACxD,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;gBACxD,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;gBAC1E,SAAS,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC;gBACvE,GAAG,SAAS;aACb,CAAC;QACJ,KAAK,eAAe;YAClB,OAAO;gBACL,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;gBACxD,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,SAAS;gBAC7C,GAAG,SAAS;aACK,CAAC;QACtB,KAAK,UAAU;YACb,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,GAAG,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC;gBACrD,GAAG,SAAS;aACb,CAAC;QACJ,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC;YACpC,IAAI,UAA0C,CAAC;YAC/C,IAAI,aAAa,KAAK,OAAO,EAAE,CAAC;gBAC9B,UAAU,GAAG,OAAO,CAAC;YACvB,CAAC;iBAAM,IACL,OAAO,aAAa,KAAK,QAAQ;gBACjC,aAAa,KAAK,IAAI;gBACtB,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;gBAC7B,OAAQ,aAAyC,CAAC,QAAQ,KAAK,QAAQ,EACvE,CAAC;gBACD,UAAU,GAAG,EAAE,QAAQ,EAAG,aAAwC,CAAC,QAAS,EAAE,CAAC;YACjF,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,iEAAiE,CACtG,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC9D,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC9D,WAAW,EAAE,UAAU;gBACvB,GAAG,SAAS;aACb,CAAC;QACJ,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBAChE,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,6DAA6D,CAClG,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;YAC/C,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACxD,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,sEAAsE,CAC3G,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;gBACxD,KAAK;gBACL,MAAM;gBACN,GAAG,SAAS;aACK,CAAC;QACtB,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,+DAA+D,CACpG,CAAC;YACJ,CAAC;YACD,uDAAuD;YACvD,wEAAwE;YACxE,qEAAqE;YACrE,iEAAiE;YACjE,sEAAsE;YACtE,0BAA0B;YAC1B,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,yEAAyE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CACrI,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACjG,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,0DAA0D,CAC/F,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC;YACrB,IAAI,GAAuC,CAAC;YAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3E,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,qDAAqD,CAC1F,CAAC;gBACJ,CAAC;gBACD,GAAG,GAAG,EAAE,CAAC;gBACT,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;oBACvE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;wBAC1B,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,uBAAuB,CAAC,qBAAqB,CAClF,CAAC;oBACJ,CAAC;oBACD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACb,CAAC;YACH,CAAC;YACD,MAAM,OAAO,GACX,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC3F,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,+DAA+D,CACpG,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAuC;gBACjD,IAAI,EAAE,WAAW;gBACjB,IAAI;gBACJ,GAAG,EAAE,MAAkB;gBACvB,GAAG,SAAS;aACb,CAAC;YACF,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;YACxC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;gBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;YACxE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;YAC3B,IAAI,MAA4B,CAAC;YACjC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;oBAChF,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,0DAA0D,CAC/F,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,SAAqB,CAAC;YACjC,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC1E,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAClD,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,cAAc,GAAG,qDAAqD,CAC1F,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAA+C;gBACzD,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;gBAC3D,GAAG,SAAS;aACb,CAAC;YACF,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,KAAK,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACtC,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YACjD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;gBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC5E,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,0EAA0E;YAC1E,uDAAuD;YACvD,MAAM,WAAW,GAAU,IAAa,CAAC;YACzC,KAAK,WAAW,CAAC;YACjB,MAAM,IAAI,aAAa,CAAC,sBAAsB,EAAE,4BAA4B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,GAAY;IAC/D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,UAAU,SAAS,mDAAmD,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/actions/predicate-env.js

@@ -0,0 +1,27 @@
+// Production-side adapter for `PredicateEnv` (issue 96). Backs
+// `branchExists` with `git rev-parse --verify --quiet` (via the unified
+// `runProcess`) and `pathExists` with `fs.stat`. Lives outside the
+// functional-core lint group so `src/actions/predicates.ts` can stay free of
+// `node:fs/promises` and `runProcess` direct imports; the runner threads
+// `defaultPredicateEnv` into the executor.
+import { stat } from 'node:fs/promises';
+import { runProcess } from '../util/process.js';
+export const defaultPredicateEnv = {
+    async branchExists(ref, workspacePath) {
+        // `--verify --quiet` keeps both streams empty on the happy path; the
+        // tiny default byte clamp is plenty and `appendErrorToStderr: false`
+        // skips stderr decoration for the missing-ref case (the common one).
+        const r = await runProcess('git', ['rev-parse', '--verify', '--quiet', `refs/heads/${ref}`], { cwd: workspacePath, appendErrorToStderr: false });
+        return r.exit_code === 0;
+    },
+    async pathExists(absPath) {
+        try {
+            const st = await stat(absPath);
+            return st.isFile() || st.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    },
+};
+//# sourceMappingURL=predicate-env.js.map

package/dist/actions/predicate-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-env.js","sourceRoot":"","sources":["../../src/actions/predicate-env.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wEAAwE;AACxE,mEAAmE;AACnE,6EAA6E;AAC7E,yEAAyE;AACzE,2CAA2C;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,aAAa;QACnC,qEAAqE;QACrE,qEAAqE;QACrE,qEAAqE;QACrE,MAAM,CAAC,GAAG,MAAM,UAAU,CACxB,KAAK,EACL,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,GAAG,EAAE,CAAC,EACzD,EAAE,GAAG,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,EAAE,CACnD,CAAC;QACF,OAAO,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,OAAO;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/actions/predicates.js

@@ -0,0 +1,49 @@
+// `if:` predicate evaluation (issue 36).
+//
+// Three predicate shapes — env-var-truthy, branch-exists, file-present.
+// These are the three predicates the hook shell actually exercised across
+// today's WORKFLOW.md; the issue body explicitly caps the predicate set
+// there: "If users want more, they've outgrown declarative."
+import path from 'node:path';
+import { renderTemplate } from './templating.js';
+/**
+ * Evaluate a predicate against the context. `null`/undefined → always true
+ * (no `if:` → run unconditionally).
+ *
+ * The string form `"$var"` is a truthiness check on the named context field
+ * — `if: $repo` matches the issue body's example exactly. A bare literal
+ * (`if: yes`) is treated as truthy; the literal-false case `if: ""` /
+ * `if: null` falls through to "always".
+ *
+ * IO is routed through the injected `PredicateEnv` so the evaluator core
+ * stays pure (no `node:fs` / `runProcess` imports). String-truthy predicates
+ * never touch the env.
+ */
+export async function evaluatePredicate(predicate, ctx, workspacePath, env) {
+    if (predicate === null || predicate === undefined)
+        return true;
+    if (typeof predicate === 'string') {
+        // Templates may already have been rendered by the executor's renderTree
+        // pass before evaluatePredicate is called; re-rendering an already-rendered
+        // empty string is a no-op. An empty (or empty-after-render) predicate is
+        // explicitly false — the intent of `if: $repo` with $repo unset is "skip
+        // when the var is empty," not "always run".
+        const expanded = renderTemplate(predicate, ctx).trim();
+        return expanded.length > 0;
+    }
+    if ('branch_exists' in predicate) {
+        const ref = renderTemplate(predicate.branch_exists, ctx).trim();
+        if (ref.length === 0)
+            return false;
+        return env.branchExists(ref, workspacePath);
+    }
+    if ('file_present' in predicate) {
+        const file = renderTemplate(predicate.file_present, ctx).trim();
+        if (file.length === 0)
+            return false;
+        const abs = path.isAbsolute(file) ? file : path.join(workspacePath, file);
+        return env.pathExists(abs);
+    }
+    return false;
+}
+//# sourceMappingURL=predicates.js.map

package/dist/actions/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../src/actions/predicates.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AACxE,6DAA6D;AAE7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAsC,EACtC,GAAkB,EAClB,aAAqB,EACrB,GAAiB;IAEjB,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,wEAAwE;QACxE,4EAA4E;QAC5E,yEAAyE;QACzE,yEAAyE;QACzE,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,eAAe,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,OAAO,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,cAAc,IAAI,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC1E,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/actions/templating.js

@@ -0,0 +1,66 @@
+// $-substitution against a fixed ActionContext namespace (issue 36).
+//
+// The issue body explicitly says "Mustache or `$`-substitution with a fixed
+// namespace is enough; Bazel's Starlark is overkill." We pick `$identifier`
+// over `${{ identifier }}` because the Done after_run already uses
+// `$SYMPHONY_*` env-var shapes; sharing the prefix style keeps cognitive
+// load low for operators converting hooks to actions.
+//
+// Behavior:
+//   • `$name` expands to the named ActionContext field.
+//   • An unknown `$name` throws — silent expansion to "" was the most common
+//     hook-shell bug (typo'd `$SYMPHONY_PR_TITTLE` is the canonical example).
+//   • Literal `$` followed by a non-word char is left alone.
+//   • `\$name` escapes the substitution (literal `$name` in output).
+export class TemplateError extends Error {
+    name;
+    constructor(name, message) {
+        super(message);
+        this.name = name;
+        this.name = 'TemplateError';
+    }
+}
+const VAR_RE = /(\\?)\$([A-Za-z_][A-Za-z0-9_]*)/g;
+/**
+ * Substitute `$name` references in `template` against the ActionContext.
+ * Throws TemplateError when a referenced variable is not in the fixed
+ * namespace — silent "" expansion masks operator typos.
+ */
+export function renderTemplate(template, ctx) {
+    if (typeof template !== 'string') {
+        return template;
+    }
+    return template.replace(VAR_RE, (full, escape, name) => {
+        if (escape === '\\')
+            return `$${name}`;
+        if (!(name in ctx)) {
+            throw new TemplateError(name, `unknown template variable "$${name}" (available: ${Object.keys(ctx).join(', ')})`);
+        }
+        const v = ctx[name];
+        if (v === null || v === undefined)
+            return '';
+        return String(v);
+    });
+}
+/**
+ * Render every string field of an object. Used to render an action's
+ * declarative fields in one pass before execution. Recurses into arrays and
+ * plain objects; primitives other than strings (numbers, booleans) pass
+ * through unchanged.
+ */
+export function renderTree(value, ctx) {
+    if (typeof value === 'string')
+        return renderTemplate(value, ctx);
+    if (Array.isArray(value)) {
+        return value.map((v) => renderTree(v, ctx));
+    }
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = renderTree(v, ctx);
+        }
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=templating.js.map

package/dist/actions/templating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.js","sourceRoot":"","sources":["../../src/actions/templating.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,mEAAmE;AACnE,yEAAyE;AACzE,sDAAsD;AACtD,EAAE;AACF,YAAY;AACZ,wDAAwD;AACxD,6EAA6E;AAC7E,8EAA8E;AAC9E,6DAA6D;AAC7D,qEAAqE;AAIrE,MAAM,OAAO,aAAc,SAAQ,KAAK;IACnB;IAAnB,YAAmB,IAAY,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,SAAI,GAAJ,IAAI,CAAQ;QAE7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,MAAM,GAAG,kCAAkC,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,GAAkB;IACjE,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE;QACrE,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,aAAa,CACrB,IAAI,EACJ,+BAA+B,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACnF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAI,GAA0C,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAI,KAAQ,EAAE,GAAkB;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC,KAAK,EAAE,GAAG,CAAiB,CAAC;IACjF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAiB,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,GAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/actions/types.js

@@ -0,0 +1,15 @@
+// Workflow action records (issue 36 — reconciler v2 / typed action DAG).
+//
+// Per-state `actions:` blocks declare a closed set of typed records that the
+// orchestrator runs in place of an `after_run` shell hook. Each kind has a
+// fixed schema; the only escape hatch for arbitrary commands is `run_in_vm`,
+// which is content-hash cached so identical (workspace, cmd, env) tuples
+// don't re-execute.
+//
+// Action records are pure data; the executor (src/actions/executor.ts) is the
+// one place that knows how to apply each kind. This mirrors the reconciler's
+// `KillSessionAction`/`RemoveWorkspaceAction`/… pattern (records, not closures)
+// so the snapshot machinery and the dashboard can render per-action state
+// uniformly across both surfaces.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/actions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/actions/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,oBAAoB;AACpB,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,0EAA0E;AAC1E,kCAAkC"}