@mickorz/opencode-agentic-workflow 0.3.0

package/dist/workspace/git-worktree.js

@@ -0,0 +1,110 @@
+/**
+ * GitWorktreeProvider（P2.7）—— WorkspaceProvider 的 git worktree 实现
+ *
+ *   git -C <repo> worktree add -b agw/<runId> <dir>/<runId> [<baseRef>]
+ *
+ * - worktree 目录默认放在仓库**同级**目录（<项目名>-worktrees/<runId>），
+ *   不污染仓库本身（无需 .gitignore）；
+ * - dispose 只移除 worktree（+prune），**不删分支**——分支是廉价 ref，
+ *   删除是破坏性操作，留给用户（git branch --list 'agw/*' 可批量清理）；
+ * - attach 严格校验存在性，缺失即抛错（durable resume 纪律）。
+ */
+import { execFile } from "node:child_process";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+async function git(args, cwd) {
+    const { stdout } = await exec("git", args, { cwd });
+    return stdout.trim();
+}
+export class GitWorktreeProvider {
+    kind = "git-worktree";
+    startDir;
+    dirOverride;
+    cache;
+    constructor(options) {
+        this.startDir = options.startDir;
+        this.dirOverride = options.dir;
+    }
+    async resolvePaths() {
+        if (this.cache)
+            return this.cache;
+        const repoRoot = await git(["rev-parse", "--show-toplevel"], this.startDir);
+        const dir = this.dirOverride ??
+            path.join(path.dirname(repoRoot), `${path.basename(repoRoot)}-worktrees`);
+        this.cache = { repoRoot, dir };
+        return this.cache;
+    }
+    async create(runId, options = {}) {
+        const { repoRoot, dir } = await this.resolvePaths();
+        const branch = options.branch ?? `agw/${runId}`;
+        const root = options.path ?? path.join(dir, runId);
+        await fs.mkdir(path.dirname(root), { recursive: true });
+        const args = ["worktree", "add", "-b", branch, root];
+        if (options.baseRef)
+            args.push(options.baseRef);
+        await git(args, repoRoot);
+        const identity = {
+            provider: this.kind,
+            path: root,
+            branch,
+            baseRef: options.baseRef,
+        };
+        return {
+            root,
+            identity,
+            dispose: (disposeOptions) => this.removeWorktree(root, disposeOptions),
+        };
+    }
+    async attach(identity) {
+        if (identity.provider !== this.kind) {
+            throw new Error(`[agentic-workflow] workspace provider mismatch: ${identity.provider} != ${this.kind}`);
+        }
+        const stat = await fs.stat(identity.path).catch(() => undefined);
+        if (!stat?.isDirectory()) {
+            throw new Error(`[agentic-workflow] workspace missing: ${identity.path} ` +
+                `(durable resume requires the original worktree; it may have been cleaned up — ` +
+                `re-run from scratch if the work product is recoverable)`);
+        }
+        const inside = await git(["rev-parse", "--is-inside-work-tree"], identity.path);
+        if (inside !== "true") {
+            throw new Error(`[agentic-workflow] not a git worktree: ${identity.path}`);
+        }
+        return {
+            root: identity.path,
+            identity,
+            dispose: (disposeOptions) => this.removeWorktree(identity.path, disposeOptions),
+        };
+    }
+    async removeWorktree(root, options) {
+        // 从 worktree 自身解析主仓库根：跨目录/跨服务 resume 时，provider 的
+        // startDir 可能已不是该 worktree 所属仓库（journal 里的 path 才是事实源）
+        let repoRoot;
+        try {
+            const commonDir = await git(["rev-parse", "--git-common-dir"], root);
+            repoRoot = path.dirname(path.resolve(root, commonDir));
+        }
+        catch {
+            // worktree 目录已不存在：视为已清理（幂等）
+            return;
+        }
+        const args = ["worktree", "remove"];
+        if (options?.force)
+            args.push("--force");
+        args.push(root);
+        try {
+            await git(args, repoRoot);
+        }
+        catch (error) {
+            // 幂等：目录已不存在视为成功
+            const gone = !(await fs.stat(root).catch(() => undefined));
+            if (!gone)
+                throw error;
+        }
+        finally {
+            await git(["worktree", "prune"], repoRoot).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=git-worktree.js.map

package/dist/workspace/git-worktree.js.map

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

package/dist/workspace/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Workspace 公共出口（P2.7）
+ */
+export type { WorkspaceHandle, WorkspaceIdentity, WorkspaceOptions, WorkspaceProvider, CleanupPolicy, } from "./provider.js";
+export { GitWorktreeProvider, type GitWorktreeProviderOptions } from "./git-worktree.js";
+export { currentWorkspace, setCurrentWorkspace } from "./ambient.js";

package/dist/workspace/index.js

@@ -0,0 +1,6 @@
+/**
+ * Workspace 公共出口（P2.7）
+ */
+export { GitWorktreeProvider } from "./git-worktree.js";
+export { currentWorkspace, setCurrentWorkspace } from "./ambient.js";
+//# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,mBAAmB,EAAmC,MAAM,mBAAmB,CAAA;AACxF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA"}

package/dist/workspace/provider.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Workspace 抽象（P2.7）—— Workflow 的文件系统隔离边界
+ *
+ * Core 不知道 Git、也不知道 OpenCode：只依赖本抽象。
+ * GitWorktreeProvider 是其中一个实现（经 child_process 执行 git，
+ * 同样零 OpenCode 依赖）；未来可有 DockerWorkspaceProvider 等。
+ *
+ * 关键纪律：
+ *   - worktree 属于 runtime infrastructure，不是业务 workflow 原语——
+ *     workflow 定义只看到 ctx.workspaceRoot，绝不自己执行 git 命令。
+ *   - resume 必须重新附着 journal 记录的**原** workspace（绝不静默重建）：
+ *     durable resume = journal 状态 + 文件系统状态 同时恢复。
+ */
+/** 持久化到 journal 的 workspace 身份（resume attach 的依据） */
+export interface WorkspaceIdentity {
+    /** 提供者类型（如 "git-worktree"） */
+    provider: string;
+    /** 工作区根目录（绝对路径） */
+    path: string;
+    /** 分支名（git-worktree） */
+    branch?: string;
+    /** 创建时的基准 ref */
+    baseRef?: string;
+}
+export interface WorkspaceOptions {
+    /** 基准 ref（缺省 = 仓库当前 HEAD） */
+    baseRef?: string;
+    /** 分支名（缺省 agw/<runId>） */
+    branch?: string;
+    /** 工作区路径（缺省由 provider 决定） */
+    path?: string;
+}
+export interface WorkspaceHandle {
+    /** 工作区根目录（子 agent 的 cwd） */
+    root: string;
+    identity: WorkspaceIdentity;
+    /**
+     * 清理工作区。force 时丢弃未提交变更；
+     * 已被移除视为成功（幂等）。
+     */
+    dispose(options?: {
+        force?: boolean;
+    }): Promise<void>;
+}
+export interface WorkspaceProvider {
+    readonly kind: string;
+    /** 为新 run 创建工作区 */
+    create(runId: string, options?: WorkspaceOptions): Promise<WorkspaceHandle>;
+    /**
+     * 重新附着已有工作区（resume）。
+     * 不存在时必须抛错——绝不静默重建（文件系统状态丢失 = 假恢复）。
+     */
+    attach(identity: WorkspaceIdentity): Promise<WorkspaceHandle>;
+}
+/**
+ * 清理策略：
+ *   - "always"     无论成败都清理
+ *   - "on-success" 仅成功清理；失败保留现场（debug/resume 取证，默认）
+ *   - "never"      永不清理
+ */
+export type CleanupPolicy = "always" | "on-success" | "never";

package/dist/workspace/provider.js

@@ -0,0 +1,15 @@
+/**
+ * Workspace 抽象（P2.7）—— Workflow 的文件系统隔离边界
+ *
+ * Core 不知道 Git、也不知道 OpenCode：只依赖本抽象。
+ * GitWorktreeProvider 是其中一个实现（经 child_process 执行 git，
+ * 同样零 OpenCode 依赖）；未来可有 DockerWorkspaceProvider 等。
+ *
+ * 关键纪律：
+ *   - worktree 属于 runtime infrastructure，不是业务 workflow 原语——
+ *     workflow 定义只看到 ctx.workspaceRoot，绝不自己执行 git 命令。
+ *   - resume 必须重新附着 journal 记录的**原** workspace（绝不静默重建）：
+ *     durable resume = journal 状态 + 文件系统状态 同时恢复。
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/workspace/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/workspace/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@mickorz/opencode-agentic-workflow",
+  "version": "0.3.0",
+  "description": "Durable Agentic Workflow Runtime for OpenCode V2: journal & resume, version registry, tracing, token/cost metrics, git worktree isolation",
+  "type": "module",
+  "license": "MIT",
+  "author": "mickorz",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mickorz/opencode-agentic-workflow.git"
+  },
+  "homepage": "https://github.com/mickorz/opencode-agentic-workflow#readme",
+  "bugs": {
+    "url": "https://github.com/mickorz/opencode-agentic-workflow/issues"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "workflow",
+    "agentic",
+    "multi-agent",
+    "agent-orchestration",
+    "durable",
+    "resume",
+    "worktree",
+    "llm"
+  ],
+  "main": "./dist/plugin/index.js",
+  "types": "./dist/plugin/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/plugin/index.js",
+      "types": "./dist/plugin/index.d.ts"
+    },
+    "./tui": {
+      "import": "./dist/plugin/tui.js",
+      "types": "./dist/plugin/tui.d.ts"
+    },
+    "./rpc": {
+      "import": "./dist/plugin/checkpoint-rpc.js",
+      "types": "./dist/plugin/checkpoint-rpc.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test tests/**/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@opencode/plugin": "^2.0.22"
+  },
+  "devDependencies": {
+    "@opencode/theme": "^2.0.22",
+    "@opentui/core": "^0.5.14",
+    "@opentui/solid": "^0.5.14",
+    "@types/node": "^26.6.4",
+    "solid-js": "^1.9.9",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
+  }
+}