ralph-flow-pi 0.1.0

package/dist/engine/skills.js

@@ -0,0 +1,109 @@
+/**
+ * Skill discovery, in the same three tiers as workflows: project → global → built-in.
+ *
+ * The engine deliberately knows almost nothing about skills. A workflow step's
+ * `do:` text just says "use the c-to-rust-plan skill"; the model reads that,
+ * finds the skill in its system prompt catalog, and loads it. That decoupling is
+ * inherited from both plugin versions and is why the 12 domain skills could move
+ * here as plain text.
+ *
+ * What changed from the plan: pi already ships this. `loadSkillsFromDir` parses
+ * SKILL.md frontmatter, and the default system prompt appends a catalog (name,
+ * description, ABSOLUTE location) plus the instruction to resolve a skill's
+ * relative references against its own directory — as long as the session has the
+ * `read` tool. So there is no `use_skill` tool here: writing one would have
+ * duplicated pi's mechanism and fought its prompt.
+ *
+ * All this file adds is the tier resolution pi doesn't do: same-named skills
+ * shadow, nearest tier wins, and only the winners are handed to the session.
+ */
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { loadSkillsFromDir } from "../pi/adapter.js";
+/** Skills shipped inside the package. */
+export function getBuiltinSkillsDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    // dist/engine/skills.js → package root → skills/
+    return path.join(path.dirname(__filename), "..", "..", "skills");
+}
+export function getProjectSkillsDir(ralphFlowDir) {
+    return path.join(ralphFlowDir, "skills");
+}
+export function getGlobalSkillsDir(globalConfigHome) {
+    return globalConfigHome ? path.join(globalConfigHome, "skills") : null;
+}
+/**
+ * Resolve the skills available to a DO session.
+ *
+ * @param ralphFlowDir     the project's .ralph-flow dir
+ * @param globalConfigHome ~/.config/ralph-flow-pi, or null when there's no home
+ */
+export function loadSkillIndex(ralphFlowDir, globalConfigHome) {
+    const globalDir = getGlobalSkillsDir(globalConfigHome);
+    const tiers = [
+        { source: "project", dir: getProjectSkillsDir(ralphFlowDir) },
+        ...(globalDir ? [{ source: "global", dir: globalDir }] : []),
+        { source: "builtin", dir: getBuiltinSkillsDir() },
+    ];
+    const byName = new Map();
+    const diagnostics = [];
+    for (const { source, dir } of tiers) {
+        if (!fs.existsSync(dir))
+            continue;
+        let result;
+        try {
+            result = loadSkillsFromDir({ dir, source });
+        }
+        catch (e) {
+            diagnostics.push(`扫描 skill 目录 ${dir} 失败：${e.message}`);
+            continue;
+        }
+        for (const d of result.diagnostics ?? []) {
+            if (d?.message)
+                diagnostics.push(`${d.message}（${source}）`);
+        }
+        for (const skill of result.skills ?? []) {
+            const existing = byName.get(skill.name);
+            if (existing) {
+                // An earlier tier already won; record that this one is shadowed so
+                // doctor can explain why an edit to it had no effect.
+                existing.shadowed.push({ source, filePath: skill.filePath });
+                continue;
+            }
+            byName.set(skill.name, {
+                name: skill.name,
+                description: skill.description,
+                filePath: skill.filePath,
+                source,
+                shadowed: [],
+            });
+        }
+    }
+    const skills = [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+    return { skills, paths: skills.map((s) => s.filePath), diagnostics };
+}
+/** Doctor section: which skills are available, and what shadows what. */
+export function formatSkillReport(index) {
+    const lines = [];
+    const label = { project: "项目自定义", global: "全局用户", builtin: "内置" };
+    if (index.skills.length === 0) {
+        lines.push("没有找到任何 skill。");
+    }
+    else {
+        lines.push(`可用 skill：**${index.skills.length}** 个`, "");
+        for (const s of index.skills) {
+            lines.push(`- **${s.name}**（${label[s.source]}）：${s.description || "（无描述）"}`);
+            for (const sh of s.shadowed) {
+                lines.push(`  - ℹ️ 遮蔽了同名${label[sh.source]} skill：${sh.filePath}`);
+            }
+        }
+    }
+    if (index.diagnostics.length > 0) {
+        lines.push("", "问题：");
+        for (const d of index.diagnostics)
+            lines.push(`- ⚠️ ${d}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=skills.js.map

package/dist/engine/skills.js.map

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

package/dist/engine/step-tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Custom tools injected into every DO step session.
+ *
+ * `report_done` is the replacement for `<promise>done</promise>`. The plugin
+ * versions asked the model to end its message with that tag and then regex'd it
+ * back out — which needed rules for the last line, the last 100 characters, and
+ * stripping code fences, and still misfired when a model explained the tag
+ * instead of emitting it, or kept talking after it. A tool call is unambiguous:
+ * it either happened or it didn't, and prose can never look like one.
+ */
+import type { Engine } from "./core.js";
+import { type ToolDefinition } from "../pi/adapter.js";
+/**
+ * The DO session's only way to end its step.
+ *
+ * Calling it writes the .done-reported marker; the runner's keep-alive loop
+ * watches for that and moves on to CHECK. Nothing here judges the work — that is
+ * the independent verifier's job, and keeping this tool dumb is what stops the
+ * worker from grading its own homework.
+ */
+export declare function makeReportDoneTool(engine: Engine, instId: string): ToolDefinition;
+//# sourceMappingURL=step-tools.d.ts.map

package/dist/engine/step-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-tools.d.ts","sourceRoot":"","sources":["../../src/engine/step-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAwBjF"}

package/dist/engine/step-tools.js

@@ -0,0 +1,45 @@
+/**
+ * Custom tools injected into every DO step session.
+ *
+ * `report_done` is the replacement for `<promise>done</promise>`. The plugin
+ * versions asked the model to end its message with that tag and then regex'd it
+ * back out — which needed rules for the last line, the last 100 characters, and
+ * stripping code fences, and still misfired when a model explained the tag
+ * instead of emitting it, or kept talking after it. A tool call is unambiguous:
+ * it either happened or it didn't, and prose can never look like one.
+ */
+import { Type } from "typebox";
+import { defineTool } from "../pi/adapter.js";
+/**
+ * The DO session's only way to end its step.
+ *
+ * Calling it writes the .done-reported marker; the runner's keep-alive loop
+ * watches for that and moves on to CHECK. Nothing here judges the work — that is
+ * the independent verifier's job, and keeping this tool dumb is what stops the
+ * worker from grading its own homework.
+ */
+export function makeReportDoneTool(engine, instId) {
+    return defineTool({
+        name: "report_done",
+        label: "Report Done",
+        description: "在本步骤的所有任务要求和输出要求都满足后调用，声明 DO 阶段完成。这是结束本步骤的唯一方式。" +
+            "完成后会有一个独立的只读会话来验证你的工作，所以不要在工作未完成时调用。",
+        parameters: Type.Object({
+            summary: Type.Optional(Type.String({
+                description: "一句话说明你做了什么（可选，仅用于日志与报告；验证者不会看到它，只会看你的实际产出）。",
+            })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const summary = typeof params.summary === "string" ? params.summary.trim() : "";
+            // writeDoneReported no-ops on a destroyed instance, so a cancel racing this
+            // call cannot resurrect the instance dir.
+            engine.writeDoneReported(instId);
+            engine.logEvent(instId, "info", "done_reported", { summary: summary.slice(0, 200) });
+            return {
+                content: [{ type: "text", text: "已记录：DO 阶段完成。接下来由独立的只读会话验证本步骤，你无需再做其他事。" }],
+                details: {},
+            };
+        },
+    });
+}
+//# sourceMappingURL=step-tools.js.map

package/dist/engine/step-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-tools.js","sourceRoot":"","sources":["../../src/engine/step-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAc;IAC/D,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,iDAAiD;YACjD,sCAAsC;QACxC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;gBACjC,WAAW,EAAE,6CAA6C;aAC3D,CAAC,CAAC;SACJ,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,4EAA4E;YAC5E,0CAA0C;YAC1C,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wCAAwC,EAAE,CAAC;gBACpF,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAA8B,CAAC;AAClC,CAAC"}

package/dist/engine/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Shared types for the ralph-flow-pi engine.
+ *
+ * The WORKFLOW SCHEMA (StepDef/WorkflowDef/AdversarialCheckConfig) is a verbatim
+ * mirror of the opencode plugin's engine.ts so existing user YAML runs unchanged;
+ * see SYNC.md. RalphFlowState is likewise mirrored — instance state files stay
+ * semantically identical.
+ */
+export interface NormalStepDef {
+    id: string;
+    desc: string;
+    do: string;
+    input: string;
+    output: string;
+    check: string;
+    on_pass: string;
+    on_fail: string;
+    max_fail_count: number;
+}
+export interface SubWorkflowStepDef {
+    id: string;
+    desc: string;
+    workflow: string;
+    inputs?: Record<string, string>;
+    input: string;
+    output: string;
+    on_pass: string;
+    on_fail: string;
+    max_fail_count: number;
+}
+export type StepDef = NormalStepDef | SubWorkflowStepDef;
+export interface AdversarialCheckConfig {
+    /**
+     * Accepted in both historical shapes. The string form ("provider/model" or
+     * "provider/model:thinking") is what pi-ai resolves natively; the object form
+     * is the opencode SDK's shape and is normalized to the string form at parse
+     * time so downstream code only ever sees a string.
+     */
+    model?: string;
+    /**
+     * Accepted for YAML compatibility. pi has no agent concept — the verifier's
+     * read-only sandbox is a tool-set preset instead, so this field only produces
+     * a doctor warning.
+     */
+    agent?: string;
+    system_prompt?: string;
+    timeout_ms?: number;
+    /**
+     * Extra glob patterns merged into the CHECK bash whitelist for THIS
+     * workflow only (same `*`-glob syntax as the built-in table in core.ts,
+     * e.g. "./scripts/check.sh *", "just test*", "my-cli verify *"). Exists
+     * because the built-in table is a fixed, hardcoded list that cannot know
+     * about a project's own build tooling — a custom CLI, `just`, `bazel`,
+     * `poetry run pytest`, etc. would otherwise have no way to run during
+     * CHECK at all. Patterns still pass through every shell-escape guard in
+     * check-bash.ts unchanged (command substitution, write redirection,
+     * script-embedded writes) — this only adds entries to the "is this command
+     * NAME allowed" table, nothing here weakens those checks. What it does NOT
+     * do: sandbox what the allowed command does once it runs — same trust
+     * boundary as the built-in `cargo test`/`npm test` entries (see
+     * check-bash.ts's file header). The workflow author is trusting their own
+     * project's script, same as running it locally.
+     */
+    extra_allowed_bash?: string[];
+}
+export interface WorkflowDef {
+    name: string;
+    description: string;
+    manual_step: string[];
+    steps: StepDef[];
+    adversarial_check?: AdversarialCheckConfig;
+}
+export interface RalphFlowState {
+    active: boolean;
+    workflow_name: string;
+    current_step: string;
+    current_phase: string;
+    fail_count: number;
+    user_task: string;
+    paused: boolean;
+    pause_reason?: string;
+    last_failure_reason?: string;
+    instance_id?: string;
+    /** The session that owns/drives this instance. Set by the tool that touches it. */
+    session_id?: string;
+}
+export interface StepExecutionRecord {
+    stepId: string;
+    phase: string;
+    status: "passed" | "failed";
+    failCount: number;
+    startTime: string;
+    endTime?: string;
+    reason?: string;
+}
+export interface CheckResult {
+    passed: boolean;
+    /** True when the check could not run at all (crash/timeout/no verdict) — not a work failure. */
+    infra?: boolean;
+    reason: string;
+}
+export interface InstanceInfo {
+    id: string;
+    state: RalphFlowState;
+    owner: string | null;
+    manualGate: boolean;
+    doneReported: boolean;
+    lastActivity: Date | null;
+}
+export interface TransitionResult {
+    text: string;
+    paused?: boolean;
+    completed?: boolean;
+}
+/**
+ * Platform seam — the little the engine needs from the host.
+ *
+ * The opencode version only needed abortActiveCheck (the DO phase ran in the
+ * host's own session, which the plugin could not abort). Here the engine owns
+ * every session, so destroyInstance must be able to abort the step session too.
+ */
+export interface Platform {
+    /** Abort a still-running adversarial check (in-process handle). */
+    abortActiveCheck?(instId: string): void;
+    /** Abort a still-running DO step session (in-process handle). */
+    abortActiveStep?(instId: string): void;
+}
+export type PermissionAction = "allow" | "deny" | "ask";
+export declare function isSubWorkflowStep(step: StepDef): step is SubWorkflowStepDef;
+/**
+ * Strip UTF-8 BOM (Byte Order Mark) from file content.
+ * Windows Notepad and some editors add BOM to UTF-8 files.
+ * js-yaml and JSON.parse don't handle BOM, causing parse failures.
+ */
+export declare function stripBom(text: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/types.d.ts.map

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

package/dist/engine/types.js

@@ -0,0 +1,20 @@
+/**
+ * Shared types for the ralph-flow-pi engine.
+ *
+ * The WORKFLOW SCHEMA (StepDef/WorkflowDef/AdversarialCheckConfig) is a verbatim
+ * mirror of the opencode plugin's engine.ts so existing user YAML runs unchanged;
+ * see SYNC.md. RalphFlowState is likewise mirrored — instance state files stay
+ * semantically identical.
+ */
+export function isSubWorkflowStep(step) {
+    return "workflow" in step && typeof step.workflow === "string";
+}
+/**
+ * Strip UTF-8 BOM (Byte Order Mark) from file content.
+ * Windows Notepad and some editors add BOM to UTF-8 files.
+ * js-yaml and JSON.parse don't handle BOM, causing parse failures.
+ */
+export function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsIH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,UAAU,IAAI,IAAI,IAAI,OAAQ,IAA2B,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACzF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC"}

package/dist/headless.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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 { type Engine } from "./engine/core.js";
+import { type RunnerDeps } from "./engine/runner.js";
+export interface HeadlessResult {
+    text: string;
+    /** Process exit code: 0 = fine, 1 = the user asked about something that isn't there. */
+    code: number;
+}
+export declare function runStatus(engine: Engine, explicit?: string): HeadlessResult;
+export declare function runList(engine: Engine): HeadlessResult;
+export declare function runDoctor(engine: Engine): HeadlessResult;
+/**
+ * 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 declare function runCancel(engine: Engine, explicit?: string): Promise<HeadlessResult>;
+/**
+ * `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 declare function runContinue(engine: Engine, explicit?: string, runnerDeps?: RunnerDeps): Promise<HeadlessResult>;
+export declare function runHeadless(verb: string, args: string[], cwd: string): Promise<HeadlessResult>;
+//# sourceMappingURL=headless.d.ts.map

package/dist/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../src/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKnE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAoF3E;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAUtD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAKxD;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuC1F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CA+DrH;AA2CD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAYpG"}