wardo 0.1.0

package/dist/workflow.js

@@ -0,0 +1,212 @@
+import { randomUUID } from "node:crypto";
+import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { loadConfig } from "./config.js";
+import { EventBus } from "./events.js";
+import { LlmRegistry } from "./llm.js";
+import { WardoStore } from "./store.js";
+import { ClaudeAdapter } from "./agents/claude.js";
+import { CodexAdapter } from "./agents/codex.js";
+import { TaskAgent } from "./task-agent.js";
+import { planWorkflow } from "./planner.js";
+import { consoleRenderer } from "./renderer.js";
+import { detectAgentEnvironment } from "./environment.js";
+export function defineTask(task) {
+    return { ...task, dependsOn: task.dependsOn ? [...task.dependsOn] : [] };
+}
+export function defineWorkflow(workflow) {
+    return { ...workflow, tasks: workflow.tasks.map(defineTask) };
+}
+export async function forkWorkflow(sourceWorkspace, destinationWorkspace) {
+    const source = resolve(sourceWorkspace);
+    const destination = resolve(destinationWorkspace);
+    await mkdir(destination, { recursive: true });
+    await cp(join(source, ".wardo"), join(destination, ".wardo"), { recursive: true, force: true });
+    const workflowPath = join(destination, ".wardo/workflow.json");
+    const existing = JSON.parse(await readFile(workflowPath, "utf8"));
+    const runId = randomUUID();
+    await writeFile(workflowPath, `${JSON.stringify({ ...existing, runId, parentRunId: existing.runId }, null, 2)}\n`, "utf8");
+    return runId;
+}
+function flatten(tasks, parentId) {
+    return tasks.flatMap((task) => {
+        const current = { ...task, ...(parentId ? { parentId } : {}) };
+        return task.children?.length ? [current, ...flatten(task.children, task.id)] : [current];
+    });
+}
+function validate(tasks) {
+    const ids = new Set();
+    for (const task of tasks) {
+        if (ids.has(task.id))
+            throw new Error(`Duplicate task id: ${task.id}`);
+        ids.add(task.id);
+    }
+    for (const task of tasks)
+        for (const dep of task.dependsOn ?? [])
+            if (!ids.has(dep))
+                throw new Error(`Unknown dependency ${dep} for ${task.id}`);
+    const visiting = new Set();
+    const visited = new Set();
+    const byId = new Map(tasks.map((task) => [task.id, task]));
+    const visit = (id) => {
+        if (visiting.has(id))
+            throw new Error(`Task dependency cycle includes ${id}`);
+        if (visited.has(id))
+            return;
+        visiting.add(id);
+        for (const dep of byId.get(id)?.dependsOn ?? [])
+            visit(dep);
+        visiting.delete(id);
+        visited.add(id);
+    };
+    for (const task of tasks)
+        visit(task.id);
+}
+export class WorkflowRunner {
+    workflow;
+    agent;
+    store;
+    config;
+    environment;
+    tasks;
+    statuses = new Map();
+    constructor(workflow, agent, store, config, environment) {
+        this.workflow = workflow;
+        this.agent = agent;
+        this.store = store;
+        this.config = config;
+        this.environment = environment;
+        this.tasks = flatten(workflow.tasks);
+        validate(this.tasks);
+    }
+    async run(options = {}) {
+        const release = await this.store.lock();
+        try {
+            return await this.runLocked(options);
+        }
+        finally {
+            await release();
+        }
+    }
+    async runLocked(options = {}) {
+        const existing = options.resume ? await this.store.readJson("workflow.json") : undefined;
+        const savedState = options.resume ? await this.store.readJson("state.json") : undefined;
+        const runId = options.runId ?? existing?.runId ?? randomUUID();
+        if (savedState)
+            for (const [id, result] of Object.entries(savedState))
+                this.statuses.set(id, result);
+        await this.store.init(this.workflow.objective);
+        await this.store.atomicWrite("workflow.json", { runId, workflow: this.workflow, environment: this.environment, config: { maxConcurrency: options.maxConcurrency ?? this.workflow.maxConcurrency ?? this.config.maxConcurrency } });
+        await this.store.atomicWrite("plan.json", { schemaVersion: 1, objective: this.workflow.objective, tasks: this.tasks });
+        const max = options.maxConcurrency ?? this.workflow.maxConcurrency ?? this.config.maxConcurrency;
+        const active = new Map();
+        const done = (id) => this.statuses.get(id)?.status === "succeeded";
+        const blocked = (id) => {
+            const task = this.tasks.find((item) => item.id === id);
+            return (task?.dependsOn ?? []).some((dep) => ["failed", "partial", "blocked", "cancelled", "unknown"].includes(this.statuses.get(dep)?.status ?? ""));
+        };
+        while (this.statuses.size < this.tasks.length || active.size) {
+            for (const task of this.tasks) {
+                if (this.statuses.has(task.id) || active.has(task.id))
+                    continue;
+                if (blocked(task.id)) {
+                    const result = { status: "blocked", text: "A dependency failed", attempt: 0 };
+                    this.statuses.set(task.id, result);
+                    await this.store.saveTaskState(task.id, result);
+                    await this.store.atomicWrite("state.json", Object.fromEntries(this.statuses));
+                    continue;
+                }
+                if (!(task.dependsOn ?? []).every(done))
+                    continue;
+                if (active.size >= max)
+                    break;
+                const providerLimit = task.provider && task.provider !== "auto" ? this.config.providerConcurrency?.[task.provider] : undefined;
+                if (providerLimit !== undefined) {
+                    const activeForProvider = [...active.keys()].map((id) => this.tasks.find((item) => item.id === id)).filter((item) => item?.provider === task.provider).length;
+                    if (activeForProvider >= providerLimit)
+                        continue;
+                }
+                const context = (task.dependsOn ?? []).map((dep) => `${dep}: ${this.statuses.get(dep)?.text ?? ""}`).join("\n\n");
+                const promise = this.agent.execute(task, runId, context, options.signal).then((result) => ({ id: task.id, result }));
+                active.set(task.id, promise);
+            }
+            if (!active.size) {
+                const unresolved = this.tasks.filter((task) => !this.statuses.has(task.id));
+                if (unresolved.length)
+                    throw new Error(`Scheduler stalled; unresolved tasks: ${unresolved.map((task) => task.id).join(", ")}`);
+                break;
+            }
+            const completed = await Promise.race(active.values());
+            active.delete(completed.id);
+            this.statuses.set(completed.id, completed.result);
+            await this.store.saveTaskState(completed.id, completed.result);
+            await this.store.atomicWrite("state.json", Object.fromEntries(this.statuses));
+            if (completed.result.status === "paused" || options.signal?.aborted) {
+                const pending = await Promise.all(active.values());
+                for (const item of pending) {
+                    active.delete(item.id);
+                    this.statuses.set(item.id, item.result);
+                    await this.store.saveTaskState(item.id, item.result);
+                }
+                await this.store.atomicWrite("state.json", Object.fromEntries(this.statuses));
+                break;
+            }
+            if (completed.result.status === "failed" && this.workflow.failFast) {
+                for (const task of this.tasks)
+                    if (!this.statuses.has(task.id))
+                        this.statuses.set(task.id, { status: "cancelled", text: "failFast", attempt: 0 });
+                await this.store.atomicWrite("state.json", Object.fromEntries(this.statuses));
+            }
+        }
+        await this.store.atomicWrite("state.json", Object.fromEntries(this.statuses));
+        return this.statuses;
+    }
+}
+export async function runWorkflow(workflow, options = {}) {
+    const workspace = resolve(options.workspace ?? process.cwd());
+    const config = options.config ?? await loadConfig({ workspace });
+    const environment = await detectAgentEnvironment();
+    const store = new WardoStore(workspace);
+    const events = new EventBus(store);
+    events.subscribe(consoleRenderer({ enabled: options.stream !== false }));
+    const openai = config.providers.openai;
+    const anthropic = config.providers.anthropic;
+    const claudeEnv = Object.fromEntries(Object.entries({
+        ...process.env,
+        ...(anthropic?.apiKey ? { ANTHROPIC_API_KEY: anthropic.apiKey } : {}),
+        ...(anthropic?.baseUrl ? { ANTHROPIC_BASE_URL: anthropic.baseUrl } : {}),
+    }).filter((entry) => typeof entry[1] === "string"));
+    const adapters = {
+        codex: new CodexAdapter({
+            apiKey: openai?.apiKey,
+            baseUrl: openai?.baseUrl,
+            model: config.agentDefaults.codex?.model,
+            sandboxMode: config.agentDefaults.codex?.sandboxMode,
+            approvalPolicy: config.agentDefaults.codex?.approvalPolicy,
+        }),
+        claude: new ClaudeAdapter({
+            model: config.agentDefaults.claude?.model,
+            fallbackModel: config.agentDefaults.claude?.fallbackModel,
+            permissionMode: config.agentDefaults.claude?.permissionMode,
+            env: claudeEnv,
+        }),
+    };
+    const registry = new LlmRegistry(config);
+    const agent = new TaskAgent({ adapters, registry, config, store, events, workspace, activeProvider: environment.active });
+    return new WorkflowRunner(workflow, agent, store, config, environment).run(options);
+}
+export async function execute(options) {
+    const workspace = resolve(options.workspace ?? process.cwd());
+    const config = options.config ?? await loadConfig({ workspace });
+    const registry = new LlmRegistry(config);
+    const workflow = options.workflow ?? (options.plan === "auto"
+        ? await planWorkflow(options.prompt, registry, options.signal)
+        : defineWorkflow({
+            id: "main",
+            objective: options.prompt,
+            ...(options.maxConcurrency !== undefined ? { maxConcurrency: options.maxConcurrency } : {}),
+            tasks: [defineTask({ id: "main", goal: options.prompt, acceptance: "完成目标并提供验证结果", provider: "auto" })],
+        }));
+    return runWorkflow(workflow, { ...options, config });
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "wardo",
+  "version": "0.1.0",
+  "description": "Durable TypeScript orchestration for Codex and Claude Code agents",
+  "type": "module",
+  "engines": { "node": ">=20" },
+  "bin": { "wardo": "dist/cli.js" },
+  "exports": {
+    ".": "./dist/index.js",
+    "./config": "./dist/config.js",
+    "./agents": "./dist/agents/index.js"
+  },
+  "files": ["dist", "skill", "templates"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsx --test test/**/*.test.ts",
+    "check": "npm run typecheck && npm test"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "2.0.105",
+    "@ai-sdk/openai": "2.0.130",
+    "@anthropic-ai/claude-agent-sdk": "0.3.282",
+    "@openai/codex-sdk": "0.157.0",
+    "ai": "6.0.291",
+    "yaml": "2.9.1",
+    "zod": "4.6.5"
+  },
+  "overrides": {
+    "@ai-sdk/provider-utils": {
+      "undici": "6.28.1"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "22.18.6",
+    "tsx": "4.20.6",
+    "typescript": "5.9.3"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: wardo
+description: Transform complex user requests into TypeScript workflows that orchestrate Codex and Claude Code agents with durable .wardo state.
+---
+
+# wardo skill
+
+Generate a TypeScript script using the `wardo` package. Do not generate Python.
+
+Use one `execute({ prompt, workspace })` call for a simple task. For a complex task, use `defineWorkflow` and `defineTask` with explicit goals, acceptance criteria, dependencies, and a provider hint. Keep independent tasks independent so the scheduler can run up to the configured concurrency. Every task result is checked by a separate lightweight judge request and is persisted under `.wardo`.
+
+The script must:
+
+- preserve the original user request and task acceptance criteria;
+- pass dependency results through summaries and artifact references;
+- use `resume: true` for long-running work;
+- avoid putting API keys in the script or `.wardo` files;
+- leave simple file discovery and deterministic data processing to TypeScript code;
+- request a Codex or Claude review when the workflow itself needs to change.
+
+Provider keys and URLs are configured in `~/.wardo/config.yml` or environment variables. The generated script should not hard-code a provider secret.
+
+## Runtime bootstrap
+
+The skill can be installed in either `~/.codex/skills/wardo` or `~/.claude/skills/wardo`. Before generating or running a script, identify the active host:
+
+- `WARDO_ACTIVE_AGENT=codex` means Codex is the current host;
+- `WARDO_ACTIVE_AGENT=claude` means Claude Code is the current host;
+- if the variable is absent, the runtime checks `CODEX_*` and `CLAUDE_CODE*` environment variables and the installed binaries.
+
+Pass the detected value to the generated script so automatic provider selection starts with the current host. An explicit task provider still takes precedence.
+
+The generated script must bootstrap the package before importing it. This supports a freshly created project and local development where the package has not been installed yet:
+
+```ts
+import { createRequire } from "node:module";
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+
+const packageName = "wardo";
+const requireFromScript = createRequire(import.meta.url);
+try {
+  requireFromScript.resolve(packageName);
+} catch {
+  const source = process.env.WARDO_LOCAL_PATH ?? process.env.WARDO_PACKAGE ?? packageName;
+  if (source.startsWith("/") && !existsSync(resolve(source, "dist/index.js"))) {
+    execFileSync("npm", ["run", "build", "--prefix", source], { stdio: "inherit", env: process.env });
+  }
+  execFileSync("npm", ["install", "--no-save", source], {
+    cwd: process.cwd(),
+    stdio: "inherit",
+    env: process.env,
+  });
+}
+
+const { execute } = await import(packageName);
+await execute({
+  prompt: "用户目标",
+  workspace: process.cwd(),
+  resume: true,
+});
+```
+
+For local testing, set `WARDO_LOCAL_PATH=/data/wardo` (or the absolute path of this checkout). The bootstrap must use an absolute local path when the npm package has not been published. The `wardo install-skill` command installs this skill into every detected agent, or into a selected target with `--agent codex` or `--agent claude`.

package/templates/workflow.ts

@@ -0,0 +1,9 @@
+import { execute } from "wardo";
+
+await execute({
+  prompt: "把用户目标写在这里",
+  workspace: process.cwd(),
+  maxConcurrency: 3,
+  resume: true,
+});
+