@plateforme-ai/lobster 2026.6.12

package/dist/src/pipeline_resume_state.js

@@ -0,0 +1,186 @@
+import { randomUUID } from "node:crypto";
+import { encodeToken } from "./token.js";
+import { cleanupApprovalIndexByStateKey, createApprovalIndex, deleteStateJson, readStateJson, writeStateJson, } from "./state/store.js";
+import { compileCached } from "./validation.js";
+import { validateCommandInputState } from "./input_request.js";
+export function extractPipelineHalt(output) {
+    const halted = output.halted && output.items.length === 1
+        ? output.items[0]
+        : null;
+    const approval = halted?.type === "approval_request" ? halted : null;
+    const inputRequest = halted?.type === "input_request" ? halted : null;
+    return { approval, inputRequest };
+}
+export async function finalizePipelineToolRun(params) {
+    const { approval, inputRequest } = extractPipelineHalt(params.output);
+    if (approval) {
+        const nextStateKey = await savePipelineResumeState(params.env, {
+            pipeline: params.pipeline,
+            resumeAtIndex: (params.output.haltedAt?.index ?? -1) + 1,
+            items: approval.items,
+            haltType: "approval_request",
+            prompt: approval.prompt,
+            createdAt: new Date().toISOString(),
+        });
+        if (params.previousStateKey) {
+            await cleanupApprovalIndexByStateKey({ env: params.env, stateKey: params.previousStateKey });
+            await deleteStateJson({ env: params.env, key: params.previousStateKey });
+        }
+        let approvalId;
+        try {
+            approvalId = await createApprovalIndex({ env: params.env, stateKey: nextStateKey });
+        }
+        catch (err) {
+            await deleteStateJson({ env: params.env, key: nextStateKey }).catch(() => { });
+            throw err;
+        }
+        const resumeToken = encodeToken({
+            protocolVersion: 1,
+            v: 1,
+            kind: "pipeline-resume",
+            stateKey: nextStateKey,
+        });
+        return {
+            status: "needs_approval",
+            output: [],
+            requiresApproval: {
+                ...approval,
+                resumeToken,
+                ...(approvalId ? { approvalId } : null),
+            },
+            requiresInput: null,
+        };
+    }
+    if (inputRequest) {
+        const resumeMode = inputRequest.commandInput ? "same_stage" : "next_stage";
+        const nextStateKey = await savePipelineResumeState(params.env, {
+            pipeline: params.pipeline,
+            resumeAtIndex: resumeMode === "same_stage"
+                ? (params.output.haltedAt?.index ?? -1)
+                : (params.output.haltedAt?.index ?? -1) + 1,
+            items: resumeMode === "same_stage" ? (inputRequest.items ?? []) : [],
+            haltType: "input_request",
+            resumeMode,
+            inputSchema: inputRequest.responseSchema,
+            prompt: inputRequest.prompt,
+            ...(inputRequest.commandInput ? { commandInput: inputRequest.commandInput } : null),
+            createdAt: new Date().toISOString(),
+        });
+        if (params.previousStateKey) {
+            await cleanupApprovalIndexByStateKey({ env: params.env, stateKey: params.previousStateKey });
+            await deleteStateJson({ env: params.env, key: params.previousStateKey });
+        }
+        const resumeToken = encodeToken({
+            protocolVersion: 1,
+            v: 1,
+            kind: "pipeline-resume",
+            stateKey: nextStateKey,
+        });
+        return {
+            status: "needs_input",
+            output: [],
+            requiresApproval: null,
+            requiresInput: {
+                type: "input_request",
+                prompt: inputRequest.prompt,
+                responseSchema: inputRequest.responseSchema,
+                ...(inputRequest.defaults !== undefined ? { defaults: inputRequest.defaults } : null),
+                ...(inputRequest.subject !== undefined ? { subject: inputRequest.subject } : null),
+                resumeToken,
+            },
+        };
+    }
+    if (params.previousStateKey) {
+        await cleanupApprovalIndexByStateKey({ env: params.env, stateKey: params.previousStateKey });
+        await deleteStateJson({ env: params.env, key: params.previousStateKey });
+    }
+    return {
+        status: "ok",
+        output: params.output.items,
+        requiresApproval: null,
+        requiresInput: null,
+    };
+}
+export async function savePipelineResumeState(env, state) {
+    const stateKey = `pipeline_resume_${randomUUID()}`;
+    await writeStateJson({ env, key: stateKey, value: state });
+    return stateKey;
+}
+export async function loadPipelineResumeState(env, stateKey) {
+    const stored = await readStateJson({ env, key: stateKey });
+    if (!stored || typeof stored !== "object") {
+        throw new Error("Pipeline resume state not found");
+    }
+    const data = stored;
+    if (!Array.isArray(data.pipeline))
+        throw new Error("Invalid pipeline resume state");
+    validatePipelineShape(data.pipeline);
+    if (typeof data.resumeAtIndex !== "number" ||
+        !Number.isInteger(data.resumeAtIndex) ||
+        data.resumeAtIndex < 0 ||
+        data.resumeAtIndex > data.pipeline.length) {
+        throw new Error("Invalid pipeline resume state");
+    }
+    if (!Array.isArray(data.items))
+        throw new Error("Invalid pipeline resume state");
+    if (data.haltType !== undefined &&
+        !["approval_request", "input_request"].includes(data.haltType)) {
+        throw new Error("Invalid pipeline resume state");
+    }
+    if (data.resumeMode !== undefined && !["next_stage", "same_stage"].includes(data.resumeMode)) {
+        throw new Error("Invalid pipeline resume state");
+    }
+    if (data.haltType === "input_request") {
+        if (data.inputSchema === undefined || typeof data.prompt !== "string") {
+            throw new Error("Invalid pipeline resume state");
+        }
+        if (data.resumeMode === "same_stage") {
+            if (data.resumeAtIndex >= data.pipeline.length) {
+                throw new Error("Invalid pipeline resume state");
+            }
+            data.commandInput = validateCommandInputState(data.commandInput);
+        }
+        else if (data.commandInput !== undefined) {
+            throw new Error("Invalid pipeline resume state");
+        }
+    }
+    else if (data.resumeMode === "same_stage" || data.commandInput !== undefined) {
+        throw new Error("Invalid pipeline resume state");
+    }
+    return data;
+}
+export function validatePipelineInputResponse(schema, response) {
+    if (schema === undefined) {
+        throw new Error("pipeline input response schema is missing");
+    }
+    let validator;
+    try {
+        validator = compileCached(schema);
+    }
+    catch {
+        throw new Error("pipeline input response schema is invalid");
+    }
+    const ok = validator(response);
+    if (ok)
+        return;
+    const first = validator.errors?.[0];
+    const pathValue = first?.instancePath || "/";
+    const reason = first?.message ? ` ${first.message}` : "";
+    throw new Error(`pipeline input response failed schema validation at ${pathValue}:${reason}`);
+}
+function validatePipelineShape(pipeline) {
+    for (const stage of pipeline) {
+        if (!stage || typeof stage !== "object")
+            throw new Error("Invalid pipeline resume state");
+        const data = stage;
+        if (typeof data.name !== "string" || data.name.length === 0) {
+            throw new Error("Invalid pipeline resume state");
+        }
+        if (!data.args || typeof data.args !== "object" || Array.isArray(data.args)) {
+            throw new Error("Invalid pipeline resume state");
+        }
+        if (typeof data.raw !== "string")
+            throw new Error("Invalid pipeline resume state");
+    }
+}
+//# sourceMappingURL=pipeline_resume_state.js.map

package/dist/src/pipeline_resume_state.js.map

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

package/dist/src/read_line.js

@@ -0,0 +1,50 @@
+export function readLineFromStream(stream, opts) {
+    const timeoutMs = Number(opts?.timeoutMs ?? 0);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let buf = "";
+        let timer = null;
+        const cleanup = () => {
+            stream.off("data", onData);
+            stream.off("end", onEnd);
+            stream.off("close", onClose);
+            stream.off("error", onError);
+            if (timer)
+                clearTimeout(timer);
+        };
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        };
+        const fail = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(err);
+        };
+        const onData = (chunk) => {
+            buf += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
+            const idx = buf.indexOf("\n");
+            if (idx !== -1) {
+                finish(buf.slice(0, idx));
+            }
+        };
+        const onEnd = () => finish(buf);
+        const onClose = () => finish(buf);
+        const onError = (err) => fail(err);
+        if (timeoutMs > 0) {
+            timer = setTimeout(() => {
+                fail(new Error(`Timed out waiting for input (${timeoutMs}ms)`));
+            }, timeoutMs);
+        }
+        stream.on("data", onData);
+        stream.on("end", onEnd);
+        stream.on("close", onClose);
+        stream.on("error", onError);
+    });
+}
+//# sourceMappingURL=read_line.js.map

package/dist/src/read_line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_line.js","sourceRoot":"","sources":["../../src/read_line.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,MAA6B,EAAE,IAA6B;IAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC;IAE/C,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,KAAK,GAA0B,IAAI,CAAC;QAExC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,GAAU,EAAE,EAAE;YAC1B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,EAAE;YACxC,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,GAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,IAAI,CAAC,IAAI,KAAK,CAAC,gCAAgC,SAAS,KAAK,CAAC,CAAC,CAAC;YAClE,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;QAED,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/recipes/github/index.js

@@ -0,0 +1,16 @@
+/**
+ * GitHub Recipes
+ *
+ * @example
+ * import { prMonitor, prMonitorNotify } from 'lobster/recipes/github';
+ *
+ * const result = await prMonitor({ repo: 'owner/repo', pr: 123 }).run();
+ */
+export { prMonitor, prMonitorNotify } from "./pr-monitor.js";
+export { ghPrView } from "./stages/pr-view.js";
+// Register recipes
+import { registerRecipe } from "../registry.js";
+import { prMonitor, prMonitorNotify } from "./pr-monitor.js";
+registerRecipe(prMonitor);
+registerRecipe(prMonitorNotify);
+//# sourceMappingURL=index.js.map

package/dist/src/recipes/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/recipes/github/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,cAAc,CAAC,SAAS,CAAC,CAAC;AAC1B,cAAc,CAAC,eAAe,CAAC,CAAC"}

package/dist/src/recipes/github/pr-monitor.js

@@ -0,0 +1,248 @@
+/**
+ * GitHub PR Monitor Recipe - Track PR changes over time
+ *
+ * @example
+ * import { prMonitor, prMonitorNotify } from 'lobster/recipes/github';
+ *
+ * // Full PR state with diff
+ * const result = await prMonitor({ repo: 'owner/repo', pr: 123 }).run();
+ *
+ * // Compact notification when changed
+ * const notify = await prMonitorNotify({ repo: 'owner/repo', pr: 123 }).run();
+ */
+import { Lobster } from "../../sdk/index.js";
+import { diffLast } from "../../sdk/primitives/diff.js";
+import { ghPrView } from "./stages/pr-view.js";
+/**
+ * Pick a subset of PR fields for comparison
+ * @param {Object} snapshot
+ * @returns {Object|null}
+ */
+function pickSubset(snapshot) {
+    if (!snapshot || typeof snapshot !== "object")
+        return null;
+    return {
+        number: snapshot.number,
+        title: snapshot.title,
+        url: snapshot.url,
+        state: snapshot.state,
+        isDraft: snapshot.isDraft,
+        mergeable: snapshot.mergeable,
+        reviewDecision: snapshot.reviewDecision,
+        updatedAt: snapshot.updatedAt,
+        baseRefName: snapshot.baseRefName,
+        headRefName: snapshot.headRefName,
+    };
+}
+/**
+ * Build a summary of what changed between two snapshots
+ * @param {Object|null} before
+ * @param {Object} after
+ * @returns {{ changedFields: string[], changes: Object }}
+ */
+function buildChangeSummary(before, after) {
+    const a = pickSubset(after);
+    const b = pickSubset(before);
+    if (!a)
+        return { changedFields: [], changes: {} };
+    if (!b) {
+        return {
+            changedFields: Object.keys(a),
+            changes: Object.fromEntries(Object.keys(a).map((k) => [k, { from: null, to: a[k] }])),
+        };
+    }
+    const changes = {};
+    for (const key of Object.keys(a)) {
+        if (JSON.stringify(a[key]) !== JSON.stringify(b[key])) {
+            changes[key] = { from: b[key], to: a[key] };
+        }
+    }
+    return {
+        changedFields: Object.keys(changes),
+        changes,
+    };
+}
+/**
+ * Format a human-readable change message
+ * @param {Object} options
+ * @returns {string}
+ */
+function formatChangeMessage({ repo, pr, changedFields, prInfo }) {
+    const fields = changedFields.length ? ` (${changedFields.join(", ")})` : "";
+    const title = prInfo?.title ? `: ${prInfo.title}` : "";
+    const url = prInfo?.url ? ` ${prInfo.url}` : "";
+    return `PR updated: ${repo}#${pr}${title}${fields}.${url}`.replace(/\s+/g, " ").trim();
+}
+/**
+ * Create a PR monitor workflow
+ *
+ * @param {Object} options
+ * @param {string} options.repo - Repository in owner/repo format
+ * @param {number} options.pr - PR number
+ * @param {string} [options.key] - State key override
+ * @param {boolean} [options.changesOnly=false] - Only output when changed
+ * @param {boolean} [options.summaryOnly=false] - Return compact summary
+ * @returns {Lobster}
+ */
+export function prMonitor(options) {
+    const { repo, pr, changesOnly = false, summaryOnly = false } = options;
+    const key = options.key ?? `github.pr:${repo}#${pr}`;
+    if (!repo)
+        throw new Error("prMonitor requires repo");
+    if (!pr)
+        throw new Error("prMonitor requires pr");
+    const workflow = new Lobster()
+        .pipe(ghPrView({ repo, pr }))
+        .pipe(diffLast(key))
+        .pipe((results) => {
+        const diffResult = results[0];
+        const current = diffResult.after;
+        const before = diffResult.before;
+        const changed = diffResult.changed;
+        // If changesOnly and no change, suppress output
+        if (changesOnly && !changed) {
+            return [
+                {
+                    kind: "github.pr.monitor",
+                    repo,
+                    pr: Number(pr),
+                    key,
+                    changed: false,
+                    suppressed: true,
+                },
+            ];
+        }
+        const summary = buildChangeSummary(before, current);
+        if (summaryOnly) {
+            return [
+                {
+                    kind: "github.pr.monitor",
+                    repo,
+                    pr: Number(pr),
+                    key,
+                    changed,
+                    summary,
+                    prInfo: {
+                        number: current.number,
+                        title: current.title,
+                        url: current.url,
+                        state: current.state,
+                        updatedAt: current.updatedAt,
+                    },
+                },
+            ];
+        }
+        return [
+            {
+                kind: "github.pr.monitor",
+                repo,
+                pr: Number(pr),
+                key,
+                changed,
+                summary,
+                prSnapshot: current,
+            },
+        ];
+    })
+        .meta({
+        name: "github.pr.monitor",
+        description: "Monitor PR state and detect changes",
+        requires: ["gh"],
+        args: {
+            repo: { type: "string", required: true, description: "Repository (owner/repo)" },
+            pr: { type: "number", required: true, description: "PR number" },
+            key: { type: "string", description: "State key override" },
+            changesOnly: { type: "boolean", default: false, description: "Only output when changed" },
+            summaryOnly: { type: "boolean", default: false, description: "Return compact summary" },
+        },
+    });
+    return workflow;
+}
+// Attach metadata
+prMonitor.meta = {
+    name: "github.pr.monitor",
+    description: "Monitor PR state and detect changes",
+    requires: ["gh"],
+    args: {
+        repo: { type: "string", required: true },
+        pr: { type: "number", required: true },
+        key: { type: "string" },
+        changesOnly: { type: "boolean", default: false },
+        summaryOnly: { type: "boolean", default: false },
+    },
+};
+/**
+ * Create a PR monitor notify workflow
+ * Returns a compact message only when PR changes
+ *
+ * @param {Object} options
+ * @param {string} options.repo - Repository in owner/repo format
+ * @param {number} options.pr - PR number
+ * @param {string} [options.key] - State key override
+ * @returns {Lobster}
+ */
+export function prMonitorNotify(options) {
+    const { repo, pr } = options;
+    const key = options.key ?? `github.pr:${repo}#${pr}`;
+    if (!repo)
+        throw new Error("prMonitorNotify requires repo");
+    if (!pr)
+        throw new Error("prMonitorNotify requires pr");
+    const workflow = new Lobster()
+        .pipe(ghPrView({ repo, pr }))
+        .pipe(diffLast(key, { changesOnly: true }))
+        .pipe((results) => {
+        const diffResult = results[0];
+        if (diffResult.suppressed) {
+            return [{ kind: "github.pr.monitor.notify", suppressed: true }];
+        }
+        const current = diffResult.after;
+        const before = diffResult.before;
+        const summary = buildChangeSummary(before, current);
+        const message = formatChangeMessage({
+            repo,
+            pr: Number(pr),
+            changedFields: summary.changedFields,
+            prInfo: current,
+        });
+        return [
+            {
+                kind: "github.pr.monitor.notify",
+                changed: true,
+                repo,
+                pr: Number(pr),
+                message,
+                prInfo: {
+                    number: current.number,
+                    title: current.title,
+                    url: current.url,
+                    state: current.state,
+                },
+                summary,
+            },
+        ];
+    })
+        .meta({
+        name: "github.pr.monitor.notify",
+        description: "Emit a notification message when PR changes",
+        requires: ["gh"],
+        args: {
+            repo: { type: "string", required: true },
+            pr: { type: "number", required: true },
+            key: { type: "string" },
+        },
+    });
+    return workflow;
+}
+// Attach metadata
+prMonitorNotify.meta = {
+    name: "github.pr.monitor.notify",
+    description: "Emit a notification message when PR changes",
+    requires: ["gh"],
+    args: {
+        repo: { type: "string", required: true },
+        pr: { type: "number", required: true },
+        key: { type: "string" },
+    },
+};
+//# sourceMappingURL=pr-monitor.js.map

package/dist/src/recipes/github/pr-monitor.js.map

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

package/dist/src/recipes/github/stages/pr-view.js

@@ -0,0 +1,107 @@
+/**
+ * GitHub PR View Stage - Fetch PR details via gh CLI
+ *
+ * @example
+ * import { Lobster } from 'lobster-sdk';
+ * import { ghPrView } from 'lobster/recipes/github';
+ *
+ * new Lobster()
+ *   .pipe(ghPrView({ repo: 'owner/repo', pr: 123 }))
+ *   .pipe(pr => console.log(pr.state));
+ */
+import { spawn } from "node:child_process";
+/**
+ * Run gh command
+ * @param {string[]} argv
+ * @param {Object} options
+ * @returns {Promise<{stdout: string, stderr: string}>}
+ */
+function runGh(argv, { env, cwd }) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("gh", argv, {
+            env,
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (d) => {
+            stdout += d;
+        });
+        child.stderr.on("data", (d) => {
+            stderr += d;
+        });
+        child.on("error", (err) => {
+            if (err?.code === "ENOENT") {
+                reject(new Error("gh not found on PATH (install GitHub CLI)"));
+                return;
+            }
+            reject(err);
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve({ stdout, stderr });
+            }
+            else {
+                reject(new Error(`gh failed (${code}): ${stderr.trim() || stdout.trim()}`));
+            }
+        });
+    });
+}
+/**
+ * Create a GitHub PR view stage
+ *
+ * @param {Object} options
+ * @param {string} options.repo - Repository in owner/repo format
+ * @param {number} options.pr - PR number
+ * @param {string[]} [options.fields] - Fields to fetch
+ * @returns {Object} Stage object with run method
+ */
+export function ghPrView(options) {
+    const { repo, pr } = options;
+    const fields = options.fields ?? [
+        "number",
+        "title",
+        "url",
+        "state",
+        "isDraft",
+        "mergeable",
+        "reviewDecision",
+        "author",
+        "baseRefName",
+        "headRefName",
+        "updatedAt",
+    ];
+    if (!repo)
+        throw new Error("ghPrView requires repo");
+    if (!pr)
+        throw new Error("ghPrView requires pr");
+    return {
+        type: "github.pr.view",
+        repo,
+        pr,
+        async run({ input, ctx }) {
+            // Drain input
+            for await (const _item of input) {
+                // no-op
+            }
+            const argv = ["pr", "view", String(pr), "--repo", String(repo), "--json", fields.join(",")];
+            const { stdout } = (await runGh(argv, { env: ctx.env, cwd: process.cwd() }));
+            let parsed;
+            try {
+                parsed = JSON.parse(stdout.trim());
+            }
+            catch {
+                throw new Error("gh returned non-JSON output");
+            }
+            return {
+                output: (async function* () {
+                    yield parsed;
+                })(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=pr-view.js.map

package/dist/src/recipes/github/stages/pr-view.js.map

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

package/dist/src/recipes/index.js

@@ -0,0 +1,7 @@
+/**
+ * Recipe entrypoints.
+ *
+ * Core Lobster intentionally keeps only OpenClaw-first recipes here.
+ */
+export * from "./github/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/recipes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recipes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC"}