@deksden-com/dd-flow-cli 0.9.0-beta.15 → 0.9.0-beta.150

package/dist/services/lifecycle-command.js

@@ -1,288 +1 @@
-import path from "node:path";
-import { parse, quote } from "shell-quote";
-const controlOperators = new Set(["&&", "||", ";", "|", "|&", "&", "(", ")", "<(", ">("]);
-const redirectionOperators = new Set(["<", ">", ">>", ">|", "<&", ">&", "<<<"]);
-/** Parse the deliberately small direct-command surface accepted by lifecycle hooks. */
-export function parseLifecycleCommand(command) {
-    return parseLifecycleCommandInner(command, false);
-}
-/** Preserve the historical Desktop contract: execute the payload, not its one-command shell wrapper. */
-export function unwrapShellCommand(command) {
-    let entries;
-    try {
-        entries = parse(command, (name) => `$${name}`);
-    }
-    catch {
-        return command;
-    }
-    if (!entries.every((entry) => typeof entry === "string"))
-        return command;
-    const words = entries;
-    let index = 0;
-    while (index < words.length && assignment(words[index]))
-        index += 1;
-    const executable = path.basename(words[index] ?? "");
-    if (!new Set(["bash", "sh", "zsh"]).has(executable))
-        return command;
-    if (!new Set(["-c", "-lc", "-cl"]).has(words[index + 1] ?? "") || words.length !== index + 3)
-        return command;
-    return words[index + 2] ?? command;
-}
-function parseLifecycleCommandInner(command, wrapped) {
-    const heredoc = stripHeredocBodies(command);
-    let entries;
-    try {
-        entries = parse(heredoc.command, (name) => `$${name}`);
-    }
-    catch {
-        // A command that cannot be tokenized cannot create a trusted claim. The
-        // real lifecycle CLI will consequently fail its binding requirement.
-        return { kind: "none" };
-    }
-    const { segments, composed } = commandSegments(entries);
-    const found = [];
-    const exportedEnv = {};
-    for (const segment of segments) {
-        Object.assign(exportedEnv, exportedAssignments(segment));
-        const direct = invocationFromSegment(segment, heredoc.present, wrapped, exportedEnv);
-        if (direct) {
-            found.push({ invocation: direct, nestedCompound: segment.dynamic });
-            continue;
-        }
-        const nested = wrappedInvocationFromSegment(segment);
-        if (nested && nested.kind !== "none")
-            found.push({ invocation: { ...nested.invocation, heredoc: nested.invocation.heredoc || heredoc.present, rewriteSafe: false, wrapped: true }, nestedCompound: nested.kind === "compound" });
-    }
-    if (!found.length)
-        return { kind: "none" };
-    const first = found[0];
-    if (found.length !== 1 || composed || first.nestedCompound) {
-        return {
-            kind: "compound",
-            invocation: { ...first.invocation, rewriteSafe: false },
-            reason: found.length !== 1 ? "multiple_lifecycle_invocations" : first.nestedCompound ? "nested_compound_invocation" : "shell_composition"
-        };
-    }
-    return { kind: "standalone", invocation: first.invocation };
-}
-function commandSegments(entries) {
-    const segments = [];
-    let words = [];
-    let dynamic = false;
-    let composed = false;
-    const flush = () => {
-        if (words.length || dynamic)
-            segments.push({ words, dynamic });
-        words = [];
-        dynamic = false;
-    };
-    for (let index = 0; index < entries.length; index += 1) {
-        const entry = entries[index];
-        if (typeof entry === "string") {
-            words.push(entry);
-            continue;
-        }
-        if ("comment" in entry)
-            break;
-        if (!("op" in entry) || typeof entry.op !== "string") {
-            dynamic = true;
-            continue;
-        }
-        const operator = entry.op;
-        if (operator === "glob") {
-            dynamic = true;
-            words.push("pattern" in entry && typeof entry.pattern === "string" ? entry.pattern : "");
-            continue;
-        }
-        if (controlOperators.has(operator)) {
-            composed = true;
-            flush();
-            continue;
-        }
-        if (redirectionOperators.has(operator)) {
-            const target = entries[index + 1];
-            if (typeof target === "string" || (target && typeof target === "object" && "op" in target && target.op === "glob"))
-                index += 1;
-            continue;
-        }
-        dynamic = true;
-    }
-    flush();
-    return { segments, composed };
-}
-function invocationFromSegment(segment, heredoc, wrapped, inheritedEnv) {
-    let index = 0;
-    const env = { ...inheritedEnv };
-    while (index < segment.words.length && assignment(segment.words[index])) {
-        addAssignment(env, segment.words[index]);
-        index += 1;
-    }
-    if (path.basename(segment.words[index] ?? "") === "env") {
-        index += 1;
-        if (segment.words[index]?.startsWith("-"))
-            return null;
-        while (index < segment.words.length && assignment(segment.words[index])) {
-            addAssignment(env, segment.words[index]);
-            index += 1;
-        }
-    }
-    const executable = segment.words[index];
-    if (!executable || path.basename(executable) !== "dd-flow")
-        return null;
-    const argv = segment.words.slice(index + 1);
-    const operation = lifecycleOperation(argv);
-    if (!operation)
-        return null;
-    return {
-        operation,
-        executable,
-        argv,
-        env,
-        args: parseCommandArgs(argv.slice(2)),
-        command: quote(segment.words),
-        rewriteSafe: !heredoc && !wrapped && !segment.dynamic,
-        wrapped,
-        heredoc
-    };
-}
-function exportedAssignments(segment) {
-    const result = {};
-    if (segment.words[0] !== "export")
-        return result;
-    for (const word of segment.words.slice(1)) {
-        if (!assignment(word))
-            return {};
-        addAssignment(result, word);
-    }
-    return result;
-}
-function wrappedInvocationFromSegment(segment) {
-    let index = 0;
-    while (index < segment.words.length && assignment(segment.words[index]))
-        index += 1;
-    const executable = path.basename(segment.words[index] ?? "");
-    if (!new Set(["bash", "sh", "zsh"]).has(executable))
-        return null;
-    const flag = segment.words[index + 1];
-    const payload = segment.words[index + 2];
-    if (!payload || !new Set(["-c", "-lc", "-cl"]).has(flag ?? "") || segment.words.length !== index + 3)
-        return null;
-    return parseLifecycleCommandInner(payload, true);
-}
-function lifecycleOperation(argv) {
-    const key = `${argv[0] ?? ""} ${argv[1] ?? ""}`;
-    if (key === "session register")
-        return "session_register";
-    if (key === "stage start")
-        return "stage_start";
-    if (key === "stage resume")
-        return "stage_resume";
-    if (key === "work start")
-        return "work_start";
-    return null;
-}
-export function parseCommandArgs(argv) {
-    const positional = [];
-    const options = new Map();
-    for (let index = 0; index < argv.length; index += 1) {
-        const value = argv[index];
-        if (value?.startsWith("--")) {
-            const key = value.slice(2);
-            const next = argv[index + 1];
-            const optionValue = !next || next.startsWith("--") ? "__dd_flow_flag__" : next;
-            options.set(key, [...(options.get(key) ?? []), optionValue]);
-            if (optionValue !== "__dd_flow_flag__")
-                index += 1;
-        }
-        else if (value)
-            positional.push(value);
-    }
-    return { positional, options };
-}
-export function commandOption(invocation, name) {
-    const values = invocation.args.options.get(name);
-    const value = values?.[values.length - 1];
-    return value === "__dd_flow_flag__" ? undefined : value;
-}
-export function commandHasOption(invocation, name) {
-    return invocation.args.options.has(name);
-}
-export function commandPosition(invocation, index) {
-    return invocation.args.positional[index];
-}
-function assignment(word) {
-    return /^[A-Za-z_][A-Za-z0-9_]*=/.test(word);
-}
-function addAssignment(env, word) {
-    const separator = word.indexOf("=");
-    env[word.slice(0, separator)] = word.slice(separator + 1);
-}
-function stripHeredocBodies(command) {
-    const lines = command.split(/\r?\n/);
-    const output = [];
-    const pending = [];
-    let active;
-    let present = false;
-    for (const line of lines) {
-        if (active) {
-            const candidate = active.stripTabs ? line.replace(/^\t+/, "") : line;
-            if (candidate === active.delimiter)
-                active = pending.shift();
-            continue;
-        }
-        if (line.trim())
-            output.push(line);
-        const found = heredocDelimiters(line);
-        if (found.length) {
-            present = true;
-            active = found[0];
-            pending.push(...found.slice(1));
-        }
-    }
-    return { command: output.join(" ; "), present };
-}
-function heredocDelimiters(line) {
-    const result = [];
-    let quoteState = null;
-    let escaped = false;
-    for (let index = 0; index < line.length - 1; index += 1) {
-        const char = line[index];
-        if (escaped) {
-            escaped = false;
-            continue;
-        }
-        if (char === "\\" && quoteState !== "'") {
-            escaped = true;
-            continue;
-        }
-        if (quoteState) {
-            if (char === quoteState)
-                quoteState = null;
-            continue;
-        }
-        if (char === "'" || char === '"') {
-            quoteState = char;
-            continue;
-        }
-        if (char !== "<" || line[index + 1] !== "<" || line[index + 2] === "<")
-            continue;
-        index += 2;
-        const stripTabs = line[index] === "-";
-        if (stripTabs)
-            index += 1;
-        while (/\s/.test(line[index] ?? ""))
-            index += 1;
-        const delimiterQuote = line[index] === "'" || line[index] === '"' ? line[index++] : null;
-        const start = index;
-        if (delimiterQuote)
-            while (index < line.length && line[index] !== delimiterQuote)
-                index += 1;
-        else
-            while (index < line.length && !/[\s;&|<>]/.test(line[index]))
-                index += 1;
-        const delimiter = line.slice(start, index);
-        if (delimiter)
-            result.push({ delimiter, stripTabs });
-    }
-    return result;
-}
+export { lifecycleCommandFromPayload, parseLifecycleCommand, continuationCommand, unwrapShellCommand, parseCommandArgs, commandOption, commandHasOption, commandPosition, shellSuffixOffset } from "../harness-runtime/lib/lifecycle-command.mjs";

package/dist/services/lifecycle-contract.js

@@ -0,0 +1 @@
+export { lifecycleRoutes, lifecycleInternalOptions, lifecycleOperationForArgv, lifecycleRouteForOperation } from "../harness-runtime/lib/lifecycle-contract.mjs";