ralph-flow-pi 0.1.0

package/dist/headless.js

@@ -0,0 +1,318 @@
+/**
+ * Non-interactive CLI verbs: `ralphflow status|list|doctor|cancel|continue`.
+ *
+ * These reach the same state machine as the ralphflow_* tools without
+ * starting the chat, so scripts and CI can inspect, unblock, and stop
+ * workflows. The formatting helpers are the engine's own, so headless output
+ * and the in-chat tool responses stay in sync. `continue` is the one verb
+ * that also drives the instance afterward (via a real runner, blocking until
+ * the next stopping point) rather than being a pure read/mutate-and-return —
+ * see its own doc comment for why that's still a bounded, one-shot operation
+ * and not a background daemon.
+ *
+ * There is no session id out here — every instance looks "owned by someone
+ * else", which is exactly right: a headless invocation is not a chat session.
+ */
+import fs from "fs";
+import path from "path";
+import { createEngine, MANUAL_GATE_MARKER } from "./engine/core.js";
+import { abortActiveCheck, adversarialCheck } from "./engine/check.js";
+import { isInstanceGone, withInstanceLock } from "./engine/lock.js";
+import { createRunner } from "./engine/runner.js";
+import { formatSkillReport, loadSkillIndex } from "./engine/skills.js";
+import { isSubWorkflowStep } from "./engine/types.js";
+import { resolveContinueAction } from "./commands/tools.js";
+export function runStatus(engine, explicit) {
+    const instances = engine.listInstances();
+    let target = null;
+    if (explicit) {
+        const wanted = String(explicit).trim();
+        const exact = instances.filter((i) => i.id === wanted);
+        const matches = exact.length > 0 ? exact : instances.filter((i) => i.id.startsWith(wanted));
+        if (matches.length === 1)
+            target = matches[0];
+        else if (matches.length === 0) {
+            return {
+                code: 1,
+                text: instances.length === 0
+                    ? `没有找到实例 "${wanted}"。当前没有活跃的工作流实例。`
+                    : `没有找到匹配 "${wanted}" 的实例。\n\n${engine.formatInstanceList(instances)}`,
+            };
+        }
+        else {
+            return { code: 1, text: `前缀 "${wanted}" 匹配到多个实例：\n\n${engine.formatInstanceList(matches)}` };
+        }
+    }
+    else if (instances.length === 1) {
+        target = instances[0];
+    }
+    if (!target) {
+        if (instances.length === 0)
+            return { code: 0, text: "没有活跃的工作流实例。运行 `ralphflow` 进入交互界面后用 /ralphflow-start 启动一个。" };
+        return {
+            code: 0,
+            text: engine.formatInstanceList(instances, "查看某个实例详情：`ralphflow status <实例ID>`（支持唯一前缀）。"),
+        };
+    }
+    const state = target.state;
+    const workflow = engine.loadWorkflow(state.workflow_name);
+    const currentStep = workflow ? engine.getStep(workflow, state.current_step) : null;
+    const driver = engine.foreignRunnerPid(target.id);
+    let status = `## 工作流状态
+
+- **实例**: \`${target.id}\`
+- **工作流**: ${state.workflow_name}
+- **状态**: ${engine.instanceStatusLabel(target)}
+- **当前步骤**: ${state.current_step}
+- **当前阶段**: ${state.current_phase}
+- **失败次数**: ${state.fail_count}
+- **属主会话**: ${target.owner ? `\`${target.owner.slice(0, 8)}\`` : "无"}
+- **最后活动**: ${engine.formatLastActivity(target.lastActivity)}`;
+    if (driver)
+        status += `\n- **驱动进程**: pid ${driver}（正在执行中）`;
+    if (state.last_failure_reason)
+        status += `\n- **上次失败原因**: ${state.last_failure_reason}`;
+    if (target.manualGate) {
+        status += `\n\n> 📋 该实例正在等待手动审查。审查完成后在 TUI 中调用 \`/ralphflow-continue\` 进入验证阶段。`;
+    }
+    if (currentStep) {
+        if (isSubWorkflowStep(currentStep)) {
+            status += `
+
+## 当前步骤详情
+
+- **描述**: ${currentStep.desc}
+- **类型**: 子工作流
+- **子工作流**: ${currentStep.workflow}
+- **输入**: ${currentStep.inputs ? JSON.stringify(currentStep.inputs) : "无"}
+- **最大失败次数**: ${currentStep.max_fail_count}`;
+        }
+        else {
+            status += `
+
+## 当前步骤详情
+
+- **描述**: ${currentStep.desc}
+- **任务**: ${currentStep.do}
+- **输入**: ${currentStep.input || "无"}
+- **输出**: ${currentStep.output || "无"}
+- **检查**: ${currentStep.check}
+- **最大失败次数**: ${currentStep.max_fail_count}`;
+        }
+    }
+    if (instances.length > 1) {
+        status += `\n\n> ℹ️ 本目录共有 ${instances.length} 个活跃实例。\`ralphflow status\` 不带参数会列出全部。`;
+    }
+    return { code: 0, text: status };
+}
+export function runList(engine) {
+    const workflows = engine.listWorkflows();
+    let text = workflows.length > 0
+        ? `## 可用工作流\n\n${workflows.map((w) => `- **${w.name}**: ${w.desc}`).join("\n")}`
+        : "没有找到工作流。请在 .ralph-flow/workflows/ 目录创建工作流定义文件。";
+    const instances = engine.listInstances();
+    if (instances.length > 0) {
+        text += `\n\n---\n\n${engine.formatInstanceList(instances)}`;
+    }
+    return { code: 0, text };
+}
+export function runDoctor(engine) {
+    // Skills get the same treatment as workflows: a shadowed skill is exactly as
+    // confusing as a shadowed workflow ("I edited it and nothing changed").
+    const index = loadSkillIndex(engine.getRalphFlowDir(), engine.getGlobalConfigHome());
+    return { code: 0, text: `${engine.buildDoctorReport()}\n\n## Skill\n\n${formatSkillReport(index)}` };
+}
+/**
+ * Cancel an instance. Takes the cross-process lock so a cancel can't interleave
+ * with a runner committing a check verdict in another process. The runner there
+ * notices the instance is gone on its next state read and discards its result.
+ */
+export async function runCancel(engine, explicit) {
+    const instances = engine.listInstances();
+    if (instances.length === 0)
+        return { code: 1, text: "没有活跃的工作流实例。" };
+    let target = null;
+    if (explicit) {
+        const wanted = String(explicit).trim();
+        const exact = instances.filter((i) => i.id === wanted);
+        const matches = exact.length > 0 ? exact : instances.filter((i) => i.id.startsWith(wanted));
+        if (matches.length === 1)
+            target = matches[0];
+        else if (matches.length === 0)
+            return { code: 1, text: `没有找到匹配 "${wanted}" 的实例。\n\n${engine.formatInstanceList(instances)}` };
+        else
+            return { code: 1, text: `前缀 "${wanted}" 匹配到 ${matches.length} 个实例，请提供更长的前缀：\n\n${engine.formatInstanceList(matches)}` };
+    }
+    else if (instances.length === 1) {
+        target = instances[0];
+    }
+    else {
+        return { code: 1, text: engine.formatInstanceList(instances, "存在多个实例，请指定要取消的实例：`ralphflow cancel <实例ID>`（支持唯一前缀）。") };
+    }
+    const instId = target.id;
+    const state = engine.readState(instId);
+    const workflowName = state ? state.workflow_name : instId;
+    const driver = engine.foreignRunnerPid(instId);
+    try {
+        const reportPath = await withInstanceLock(engine.getInstanceDir(instId), instId, () => {
+            engine.logEvent(instId, "info", "workflow_cancelled", { workflow: workflowName, instance: instId });
+            return engine.destroyInstance(instId, "cancelled");
+        });
+        let text = `工作流 "${workflowName}"（实例 \`${instId}\`）已取消。`;
+        if (reportPath)
+            text += `\n执行报告：${path.relative(engine.projectDir, reportPath)}`;
+        if (driver) {
+            // destroyInstance's abort handles only reach sessions in THIS process.
+            text += `\n\n> ⚠️ 该实例正被 pid ${driver} 的 ralph 进程驱动。它在下一次读取状态时会发现实例已消失并停止；已在途的模型调用可能还会跑完当前一轮。`;
+        }
+        return { code: 0, text };
+    }
+    catch (e) {
+        if (isInstanceGone(e))
+            return { code: 0, text: `实例 \`${instId}\` 已经不存在（可能刚被其他进程取消或完成）。` };
+        return { code: 1, text: `取消失败：${e.message}` };
+    }
+}
+/**
+ * `ralphflow continue [实例ID]` — approve a manual review / resume a paused
+ * workflow / recover from a crash, without an interactive session. Reuses
+ * ralphflow_continue's exact state machine (`resolveContinueAction`,
+ * commands/tools.ts) — the only difference is what happens after: an
+ * interactive session hands off to the run view; this drives the instance
+ * with a real runner and blocks until it reaches its NEXT stopping point
+ * (another gate/pause, or completion) instead of returning immediately.
+ * That is a deliberate, bounded scope for "headless" — it does not turn this
+ * into a background daemon; the process exits once the instance stops moving
+ * on its own again, exactly as if a human were watching it.
+ *
+ * `attached: true` always — a one-shot CLI invocation has no standing session
+ * identity to already "be" the owner of anything, so the crash-recovery
+ * re-attach branch (resolveContinueAction's #5) is always reachable here,
+ * which is the right default for a headless caller.
+ *
+ * `runnerDeps` is a test seam (real callers never pass it) — same shape as
+ * `RunnerDeps` in engine/runner.ts, so a test can inject `createSession`/
+ * `checkDeps` fakes to drive the "runs to the next stop" behavior without
+ * API credentials, the same way runner.test.ts already does for the runner
+ * itself.
+ */
+export async function runContinue(engine, explicit, runnerDeps) {
+    const instances = engine.listInstances();
+    if (instances.length === 0)
+        return { code: 1, text: "没有活跃的工作流实例。" };
+    let target = null;
+    if (explicit) {
+        const wanted = String(explicit).trim();
+        const exact = instances.filter((i) => i.id === wanted);
+        const matches = exact.length > 0 ? exact : instances.filter((i) => i.id.startsWith(wanted));
+        if (matches.length === 1)
+            target = matches[0];
+        else if (matches.length === 0)
+            return { code: 1, text: `没有找到匹配 "${wanted}" 的实例。\n\n${engine.formatInstanceList(instances)}` };
+        else
+            return { code: 1, text: `前缀 "${wanted}" 匹配到 ${matches.length} 个实例，请提供更长的前缀：\n\n${engine.formatInstanceList(matches)}` };
+    }
+    else if (instances.length === 1) {
+        target = instances[0];
+    }
+    else {
+        return { code: 1, text: engine.formatInstanceList(instances, "存在多个实例，请指定要继续的实例：`ralphflow continue <实例ID>`（支持唯一前缀）。") };
+    }
+    const instId = target.id;
+    const driver = engine.foreignRunnerPid(instId);
+    if (driver) {
+        return { code: 1, text: `实例 \`${instId}\` 正被另一个 ralph 进程（pid ${driver}）驱动。请在那个进程里操作它，或先结束该进程。` };
+    }
+    const sessionId = `ralphflow-headless-${process.pid}-${Date.now().toString(36)}`;
+    let response;
+    try {
+        response = await withInstanceLock(engine.getInstanceDir(instId), instId, () => resolveContinueAction(engine, instId, sessionId, /* attached */ true));
+    }
+    catch (e) {
+        if (isInstanceGone(e))
+            return { code: 0, text: `实例 \`${instId}\` 已经不存在（可能刚被其他进程取消或完成）。` };
+        return { code: 1, text: `继续失败：${e.message}` };
+    }
+    if (!engine.instanceExists(instId)) {
+        return { code: 0, text: response };
+    }
+    // Drive it to its next stopping point — same bounded semantics as watching
+    // it in an interactive session, just without a UI.
+    const runner = createRunner(engine, {}, {
+        skillPaths: () => loadSkillIndex(engine.getRalphFlowDir(), engine.getGlobalConfigHome()).paths,
+        ...runnerDeps,
+    });
+    engine.setAbortActiveStep?.(runner.abortActiveStep);
+    runner.ensureRunning(instId);
+    await runner.idle();
+    let outcome;
+    if (!engine.instanceExists(instId)) {
+        outcome = "工作流已完成。";
+        const reports = fs.readdirSync(engine.getReportsDir()).filter((f) => f.startsWith(instId)).sort();
+        if (reports.length > 0)
+            outcome += `\n执行报告：${path.relative(engine.projectDir, path.join(engine.getReportsDir(), reports[reports.length - 1]))}`;
+    }
+    else if (engine.markerExists(MANUAL_GATE_MARKER, instId)) {
+        outcome = "工作流到达人工审查门，等待审查。再次运行 `ralphflow continue` 通过。";
+    }
+    else {
+        const finalState = engine.readState(instId);
+        outcome = finalState?.paused
+            ? `工作流再次暂停（${finalState.pause_reason || "未知原因"}）：${finalState.last_failure_reason || "（无详情）"}`
+            : "工作流仍在运行中。";
+    }
+    return { code: 0, text: `${response}\n\n---\n\n${outcome}` };
+}
+/**
+ * `ralphflow _check-once <workflow> <step> [task]` — run ONE real CHECK against the
+ * current directory and print the verdict. Hidden and underscore-prefixed: it is
+ * the vertical smoke test for the check path (real model, real sandbox) without
+ * needing a whole workflow run. Creates a throwaway instance and destroys it.
+ */
+async function runCheckOnce(engine, args) {
+    const [workflowName, stepId, ...taskParts] = args;
+    if (!workflowName || !stepId) {
+        return { code: 1, text: "用法：ralphflow _check-once <工作流> <步骤ID> [任务描述]" };
+    }
+    const problems = [];
+    const workflow = engine.loadWorkflow(workflowName, problems);
+    if (!workflow)
+        return { code: 1, text: `工作流 "${workflowName}" 无法加载：${problems[0] || "未找到"}` };
+    const step = engine.getStep(workflow, stepId);
+    if (!step)
+        return { code: 1, text: `工作流 "${workflowName}" 中没有步骤 "${stepId}"` };
+    if (isSubWorkflowStep(step))
+        return { code: 1, text: `步骤 "${stepId}" 是子工作流步骤，没有 check 阶段` };
+    const task = taskParts.join(" ") || "check-once 冒烟测试";
+    const instId = engine.generateInstanceId(workflowName);
+    fs.mkdirSync(engine.getInstanceDir(instId), { recursive: true });
+    engine.writeArtifactsDirName(instId, task);
+    engine.writeState({
+        active: true, workflow_name: workflowName, current_step: stepId, current_phase: "check",
+        fail_count: 0, user_task: task, paused: false,
+    }, instId);
+    try {
+        const prompt = engine.buildCheckPrompt(instId, step, task);
+        process.stderr.write(`[check-once] 实例 ${instId}，模型 ${workflow.adversarial_check?.model || "默认"}\n`);
+        const result = await adversarialCheck(engine, instId, step, prompt, task, workflow.adversarial_check, (line) => process.stderr.write(`[bash] ${line}\n`));
+        const verdict = result.infra ? "INFRA（验证未能运行，不计失败次数）" : result.passed ? "PASS" : "FAIL";
+        return { code: result.passed ? 0 : 1, text: `## 检查结论：${verdict}\n\n${result.reason}` };
+    }
+    finally {
+        engine.destroyInstance(instId, "cancelled");
+    }
+}
+export async function runHeadless(verb, args, cwd) {
+    const engine = createEngine(cwd, { abortActiveCheck });
+    switch (verb) {
+        case "status": return runStatus(engine, args[0]);
+        case "list": return runList(engine);
+        case "doctor": return runDoctor(engine);
+        case "cancel": return await runCancel(engine, args[0]);
+        case "continue": return await runContinue(engine, args[0]);
+        case "_check-once": return await runCheckOnce(engine, args);
+        default:
+            return { code: 1, text: `未知命令：${verb}\n\n可用命令：status、list、doctor、cancel、continue。不带命令运行 \`ralphflow\` 进入交互界面。` };
+    }
+}
+//# sourceMappingURL=headless.js.map

package/dist/headless.js.map

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

package/dist/pi/adapter.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Anti-corruption layer over the Pi SDK.
+ *
+ * This is the ONLY file in the package allowed to import @earendil-works/*.
+ * Pi is on 0.x with a fast release cadence (244 releases by v0.80.7), so the
+ * blast radius of an API change has to stay inside these ~250 lines: everything
+ * else talks to the narrow interfaces below and to our own normalized event
+ * type, never to Pi's.
+ *
+ * Upgrade drill: bump the pinned version → fix this file → run the adapter
+ * contract tests → run the CHECK smoke (`ralph _check-once`).
+ */
+import { defineTool, CURRENT_SESSION_VERSION, loadSkillsFromDir, type Skill, type ToolDefinition } from "@earendil-works/pi-coding-agent";
+export { defineTool, loadSkillsFromDir, CURRENT_SESSION_VERSION, type Skill, type ToolDefinition };
+/** Pi's read-only built-in tool set. Deliberately excludes bash: the verifier's
+ *  only shell access is our whitelisted check_bash custom tool. This matches the
+ *  Claude version's `--allowedTools "Read(*) Glob(*) Grep(*) …"` allow-list. */
+export declare const READ_ONLY_TOOL_NAMES: readonly ["read", "grep", "find", "ls"];
+/** Full coding tool set for DO steps. */
+export declare const CODING_TOOL_NAMES: readonly ["read", "bash", "edit", "write", "grep", "find", "ls"];
+export type StepEvent = {
+    type: "text";
+    delta: string;
+} | {
+    type: "reasoning";
+    delta: string;
+} | {
+    type: "tool_start";
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+} | {
+    type: "tool_end";
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+    text: string;
+} | {
+    type: "turn_end";
+} | {
+    type: "agent_end";
+} | {
+    type: "compaction_end";
+} | {
+    type: "error";
+    message: string;
+};
+export type StepEventListener = (event: StepEvent) => void;
+export interface SessionHandle {
+    /** Send a prompt and resolve when the agent settles (turn complete). */
+    prompt(text: string): Promise<void>;
+    /** Queue a message for the next turn. */
+    followUp(text: string): Promise<void>;
+    /** Redirect the turn currently streaming. */
+    steer(text: string): Promise<void>;
+    /** Subscribe to normalized events; returns an unsubscribe function. */
+    subscribe(listener: StepEventListener): () => void;
+    /** Abort whatever is in flight. */
+    abort(): Promise<void>;
+    /** Release resources. Safe to call twice. */
+    dispose(): void;
+    /** Absolute path of this session's JSONL, when persisted. */
+    readonly jsonlPath: string | null;
+}
+export interface ResolvedModel {
+    /** Opaque to callers — only ever handed back to createStepSession/createCheckSession. */
+    model: unknown;
+    thinkingLevel?: string;
+    warning?: string;
+    error?: string;
+}
+/**
+ * Resolve a "provider/model" or "provider/model:thinking" string.
+ *
+ * This is where adversarial_check.model gets its cross-provider superpower for
+ * free: pi-ai resolves any provider, so a workflow can verify Claude's work with
+ * GPT without the engine knowing anything about either.
+ *
+ * Returns `{ error }` rather than throwing — callers fall back to the session's
+ * default model, matching the plugin versions' "unresolvable model falls back"
+ * behavior.
+ */
+export declare function resolveModel(spec: string): Promise<ResolvedModel>;
+export interface CreateSessionOptions {
+    cwd: string;
+    /** Resolved model, or undefined to use Pi's configured default. */
+    model?: unknown;
+    thinkingLevel?: string;
+    /** Built-in tool allowlist. */
+    tools: readonly string[];
+    customTools?: ToolDefinition[];
+    /** Replaces the whole system prompt when set. */
+    systemPrompt?: string;
+    /** Appended to the default system prompt when set (used for the skill catalog). */
+    appendSystemPrompt?: string;
+    /**
+     * Persist the transcript into this directory, one session per directory.
+     *
+     * Pi derives its own filename (`<timestamp>_<id>.jsonl`) and gives no way to
+     * dictate it, so the unit we control is the directory: the runner passes one
+     * dir per step attempt. A dir that already holds a .jsonl is RESUMED — that is
+     * what lets a check-failed retry continue the same step session, and a crashed
+     * run pick its step session back up. Omit for an unpersisted session.
+     */
+    sessionDir?: string;
+    /** Disable auto-compaction (steps are short; determinism beats headroom). */
+    disableCompaction?: boolean;
+    /** Don't load the user's pi extensions into this session. */
+    noExtensions?: boolean;
+    /**
+     * Absolute SKILL.md paths to offer this session. Pi appends a catalog (name,
+     * description, absolute location) to the system prompt and the model loads a
+     * skill with the `read` tool — no custom tool involved.
+     */
+    skillPaths?: string[];
+    /** Load no skills at all, not even the user's own. */
+    noSkills?: boolean;
+}
+/** The existing transcript in a session dir, if any. */
+export declare function findSessionFile(sessionDir: string): string | null;
+/** A DO step session: full coding tools, persisted, fresh context per step. */
+export declare function createStepSession(options: Omit<CreateSessionOptions, "tools"> & {
+    tools?: readonly string[];
+}): Promise<SessionHandle>;
+/**
+ * A CHECK session: read-only built-ins only.
+ *
+ * The read-only guarantee is structural, not prompted — `edit`/`write`/`bash`
+ * are simply not in the tool set, so the verifier cannot mutate the workspace it
+ * is judging even if the model decides it wants to.
+ */
+export declare function createCheckSession(options: Omit<CreateSessionOptions, "tools" | "noExtensions" | "skillPaths" | "noSkills">): Promise<SessionHandle>;
+/** The pinned Pi version, surfaced for diagnostics. */
+export declare function piVersion(): string;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/pi/adapter.d.ts.map

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