agentplane 0.1.5 → 0.1.7

package/dist/commands/shared/git-diff.d.ts

@@ -0,0 +1,9 @@
+export declare function toGitPath(filePath: string): string;
+export declare function gitShowFile(cwd: string, ref: string, relPath: string): Promise<string>;
+export declare function gitDiffNames(cwd: string, base: string, branch: string): Promise<string[]>;
+export declare function gitDiffStat(cwd: string, base: string, branch: string): Promise<string>;
+export declare function gitAheadBehind(cwd: string, base: string, branch: string): Promise<{
+    ahead: number;
+    behind: number;
+}>;
+//# sourceMappingURL=git-diff.d.ts.map

package/dist/commands/shared/git-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-diff.ts"],"names":[],"mappings":"AAIA,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5F;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAS/F;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5F;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAa5C"}

package/dist/commands/shared/git-diff.js

@@ -0,0 +1,41 @@
+import path from "node:path";
+import { execFileAsync, gitEnv } from "./git.js";
+export function toGitPath(filePath) {
+    return filePath.split(path.sep).join("/");
+}
+export async function gitShowFile(cwd, ref, relPath) {
+    const { stdout } = await execFileAsync("git", ["show", `${ref}:${relPath}`], {
+        cwd,
+        env: gitEnv(),
+    });
+    return stdout;
+}
+export async function gitDiffNames(cwd, base, branch) {
+    const { stdout } = await execFileAsync("git", ["diff", "--name-only", `${base}...${branch}`], {
+        cwd,
+        env: gitEnv(),
+    });
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+export async function gitDiffStat(cwd, base, branch) {
+    const { stdout } = await execFileAsync("git", ["diff", "--stat", `${base}...${branch}`], {
+        cwd,
+        env: gitEnv(),
+    });
+    return stdout.trimEnd();
+}
+export async function gitAheadBehind(cwd, base, branch) {
+    const { stdout } = await execFileAsync("git", ["rev-list", "--left-right", "--count", `${base}...${branch}`], { cwd, env: gitEnv() });
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return { ahead: 0, behind: 0 };
+    const parts = trimmed.split(/\s+/);
+    if (parts.length !== 2)
+        return { ahead: 0, behind: 0 };
+    const behind = Number.parseInt(parts[0] ?? "0", 10) || 0;
+    const ahead = Number.parseInt(parts[1] ?? "0", 10) || 0;
+    return { ahead, behind };
+}

package/dist/commands/shared/git-ops.d.ts

@@ -0,0 +1,24 @@
+export declare function gitRevParse(cwd: string, args: string[]): Promise<string>;
+export declare function gitCurrentBranch(cwd: string): Promise<string>;
+export declare function gitBranchExists(cwd: string, branch: string): Promise<boolean>;
+export declare function gitListBranches(cwd: string): Promise<string[]>;
+export declare function gitStagedPaths(cwd: string): Promise<string[]>;
+export declare function gitAddPaths(cwd: string, paths: string[]): Promise<void>;
+export declare function gitCommit(cwd: string, message: string, opts?: {
+    env?: NodeJS.ProcessEnv;
+    skipHooks?: boolean;
+}): Promise<void>;
+export declare function gitInitRepo(cwd: string, branch: string): Promise<void>;
+export declare function resolveInitBaseBranch(gitRoot: string, fallback: string): Promise<string>;
+export declare function promptInitBaseBranch(opts: {
+    gitRoot: string;
+    fallback: string;
+}): Promise<string>;
+export declare function ensureInitCommit(opts: {
+    gitRoot: string;
+    baseBranch: string;
+    installPaths: string[];
+    version: string;
+    skipHooks: boolean;
+}): Promise<void>;
+//# sourceMappingURL=git-ops.d.ts.map

package/dist/commands/shared/git-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-ops.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBnE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYnF;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASnE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}

package/dist/commands/shared/git-ops.js

@@ -0,0 +1,181 @@
+import { execFileAsync, gitEnv } from "./git.js";
+import { setPinnedBaseBranch } from "@agentplaneorg/core";
+import { promptChoice, promptInput } from "../../cli/prompts.js";
+import { CliError } from "../../shared/errors.js";
+export async function gitRevParse(cwd, args) {
+    const { stdout } = await execFileAsync("git", ["rev-parse", ...args], { cwd, env: gitEnv() });
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        throw new Error("Failed to resolve git path");
+    return trimmed;
+}
+export async function gitCurrentBranch(cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", ["symbolic-ref", "--short", "HEAD"], {
+            cwd,
+            env: gitEnv(),
+        });
+        const trimmed = stdout.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    catch {
+        // fall through
+    }
+    const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+        cwd,
+        env: gitEnv(),
+    });
+    const trimmed = stdout.trim();
+    if (!trimmed || trimmed === "HEAD")
+        throw new Error("Failed to resolve git branch");
+    return trimmed;
+}
+export async function gitBranchExists(cwd, branch) {
+    try {
+        await execFileAsync("git", ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`], {
+            cwd,
+            env: gitEnv(),
+        });
+        return true;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 1)
+            return false;
+        throw err;
+    }
+}
+export async function gitListBranches(cwd) {
+    const { stdout } = await execFileAsync("git", ["branch", "--format=%(refname:short)"], {
+        cwd,
+        env: gitEnv(),
+    });
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+export async function gitStagedPaths(cwd) {
+    const { stdout } = await execFileAsync("git", ["diff", "--cached", "--name-only"], {
+        cwd,
+        env: gitEnv(),
+    });
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+export async function gitAddPaths(cwd, paths) {
+    if (paths.length === 0)
+        return;
+    await execFileAsync("git", ["add", "--", ...paths], { cwd, env: gitEnv() });
+}
+export async function gitCommit(cwd, message, opts) {
+    const args = ["commit", "-m", message];
+    if (opts?.skipHooks)
+        args.push("--no-verify");
+    const env = opts?.env ? { ...gitEnv(), ...opts.env } : gitEnv();
+    await execFileAsync("git", args, { cwd, env });
+}
+export async function gitInitRepo(cwd, branch) {
+    try {
+        await execFileAsync("git", ["init", "-q", "-b", branch], { cwd, env: gitEnv() });
+        return;
+    }
+    catch {
+        await execFileAsync("git", ["init", "-q"], { cwd, env: gitEnv() });
+    }
+    try {
+        const current = await gitCurrentBranch(cwd);
+        if (current !== branch) {
+            await execFileAsync("git", ["checkout", "-q", "-b", branch], { cwd, env: gitEnv() });
+        }
+    }
+    catch {
+        await execFileAsync("git", ["checkout", "-q", "-b", branch], { cwd, env: gitEnv() });
+    }
+}
+export async function resolveInitBaseBranch(gitRoot, fallback) {
+    let current = null;
+    try {
+        current = await gitCurrentBranch(gitRoot);
+    }
+    catch {
+        current = null;
+    }
+    const branches = await gitListBranches(gitRoot);
+    if (current)
+        return current;
+    if (branches.includes(fallback))
+        return fallback;
+    if (branches.length > 0) {
+        const first = branches[0];
+        if (first)
+            return first;
+    }
+    return fallback;
+}
+export async function promptInitBaseBranch(opts) {
+    const branches = await gitListBranches(opts.gitRoot);
+    let current = null;
+    try {
+        current = await gitCurrentBranch(opts.gitRoot);
+    }
+    catch {
+        current = null;
+    }
+    const promptNewBranch = async (hasBranches) => {
+        const raw = await promptInput(`Enter new base branch name (default ${opts.fallback}): `);
+        const candidate = raw.trim() || opts.fallback;
+        if (!candidate) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: "Base branch name cannot be empty",
+            });
+        }
+        if (await gitBranchExists(opts.gitRoot, candidate))
+            return candidate;
+        try {
+            await execFileAsync("git", hasBranches ? ["branch", candidate] : ["checkout", "-q", "-b", candidate], { cwd: opts.gitRoot, env: gitEnv() });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : `Failed to create branch ${candidate}`;
+            throw new CliError({ exitCode: 5, code: "E_GIT", message });
+        }
+        return candidate;
+    };
+    if (branches.length === 0) {
+        return await promptNewBranch(false);
+    }
+    const createLabel = "Create new branch";
+    const defaultChoice = current && branches.includes(current) ? current : (branches[0] ?? opts.fallback);
+    const choice = await promptChoice("Select base branch", [...branches, createLabel], defaultChoice);
+    if (choice === createLabel) {
+        return await promptNewBranch(true);
+    }
+    return choice;
+}
+export async function ensureInitCommit(opts) {
+    const stagedBefore = await gitStagedPaths(opts.gitRoot);
+    if (stagedBefore.length > 0) {
+        throw new CliError({
+            exitCode: 5,
+            code: "E_GIT",
+            message: "Git index has staged changes; commit or unstage them before running agentplane init.",
+        });
+    }
+    await setPinnedBaseBranch({
+        cwd: opts.gitRoot,
+        rootOverride: opts.gitRoot,
+        value: opts.baseBranch,
+    });
+    const dedupedPaths = [...new Set(opts.installPaths)].filter((entry) => entry.length > 0);
+    await gitAddPaths(opts.gitRoot, dedupedPaths);
+    const staged = await gitStagedPaths(opts.gitRoot);
+    if (staged.length === 0)
+        return;
+    const message = `chore: install agentplane ${opts.version}`;
+    await gitCommit(opts.gitRoot, message, { skipHooks: opts.skipHooks });
+}

package/dist/commands/shared/git-worktree.d.ts

@@ -0,0 +1,8 @@
+export declare function listWorktrees(cwd: string): Promise<{
+    path: string;
+    branch: string | null;
+}[]>;
+export declare function findWorktreeForBranch(cwd: string, branch: string): Promise<string | null>;
+export declare function parseTaskIdFromBranch(prefix: string, branch: string): string | null;
+export declare function gitListTaskBranches(cwd: string, prefix: string): Promise<string[]>;
+//# sourceMappingURL=git-worktree.d.ts.map

package/dist/commands/shared/git-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-worktree.ts"],"names":[],"mappings":"AAEA,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,CAAC,CAoBpD;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/F;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMnF;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUxF"}

package/dist/commands/shared/git-worktree.js

@@ -0,0 +1,48 @@
+import { execFileAsync, gitEnv } from "./git.js";
+export async function listWorktrees(cwd) {
+    const { stdout } = await execFileAsync("git", ["worktree", "list", "--porcelain"], {
+        cwd,
+        env: gitEnv(),
+    });
+    const worktrees = [];
+    const lines = stdout.split("\n");
+    let current = null;
+    for (const line of lines) {
+        if (line.startsWith("worktree ")) {
+            if (current)
+                worktrees.push(current);
+            current = { path: line.slice("worktree ".length).trim(), branch: null };
+            continue;
+        }
+        if (line.startsWith("branch ") && current) {
+            current.branch = line.slice("branch ".length).trim();
+        }
+    }
+    if (current)
+        worktrees.push(current);
+    return worktrees;
+}
+export async function findWorktreeForBranch(cwd, branch) {
+    const target = branch.startsWith("refs/heads/") ? branch : `refs/heads/${branch}`;
+    const worktrees = await listWorktrees(cwd);
+    const match = worktrees.find((entry) => entry.branch === branch || entry.branch === target || entry.branch === `refs/heads/${branch}`);
+    return match ? match.path : null;
+}
+function stripBranchRef(branch) {
+    return branch.startsWith("refs/heads/") ? branch.slice("refs/heads/".length) : branch;
+}
+export function parseTaskIdFromBranch(prefix, branch) {
+    const normalized = stripBranchRef(branch);
+    if (!normalized.startsWith(`${prefix}/`))
+        return null;
+    const rest = normalized.slice(prefix.length + 1);
+    const taskId = rest.split("/", 1)[0];
+    return taskId ? taskId.trim() : null;
+}
+export async function gitListTaskBranches(cwd, prefix) {
+    const { stdout } = await execFileAsync("git", ["for-each-ref", "--format=%(refname:short)", `refs/heads/${prefix}`], { cwd, env: gitEnv() });
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}

package/dist/commands/shared/git.d.ts

@@ -0,0 +1,4 @@
+import { execFile } from "node:child_process";
+export declare const execFileAsync: typeof execFile.__promisify__;
+export declare function gitEnv(): NodeJS.ProcessEnv;
+//# sourceMappingURL=git.d.ts.map

package/dist/commands/shared/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,eAAO,MAAM,aAAa,+BAAsB,CAAC;AAGjD,wBAAgB,MAAM,IAAI,MAAM,CAAC,UAAU,CAS1C"}

package/dist/commands/shared/git.js

@@ -0,0 +1,14 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+export const execFileAsync = promisify(execFile);
+// Avoid leaking worktree-index overrides into git subprocesses.
+export function gitEnv() {
+    const env = { ...process.env };
+    delete env.GIT_DIR;
+    delete env.GIT_WORK_TREE;
+    delete env.GIT_COMMON_DIR;
+    delete env.GIT_INDEX_FILE;
+    delete env.GIT_OBJECT_DIRECTORY;
+    delete env.GIT_ALTERNATE_OBJECT_DIRECTORIES;
+    return env;
+}

package/dist/commands/shared/path.d.ts

@@ -0,0 +1,3 @@
+export declare function resolvePathFallback(filePath: string): Promise<string>;
+export declare function isPathWithin(parent: string, candidate: string): boolean;
+//# sourceMappingURL=path.d.ts.map

package/dist/commands/shared/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/path.ts"],"names":[],"mappings":"AAGA,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGvE"}

package/dist/commands/shared/path.js

@@ -0,0 +1,14 @@
+import { realpath } from "node:fs/promises";
+import path from "node:path";
+export async function resolvePathFallback(filePath) {
+    try {
+        return await realpath(filePath);
+    }
+    catch {
+        return path.resolve(filePath);
+    }
+}
+export function isPathWithin(parent, candidate) {
+    const rel = path.relative(parent, candidate);
+    return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+}

package/dist/commands/shared/pr-meta.d.ts

@@ -0,0 +1,21 @@
+export type PrMeta = {
+    schema_version: 1;
+    task_id: string;
+    branch?: string;
+    created_at: string;
+    updated_at: string;
+    last_verified_sha: string | null;
+    last_verified_at: string | null;
+    verify?: {
+        status?: "pass" | "fail" | "skipped";
+        command?: string;
+    };
+};
+export declare function parsePrMeta(raw: string, taskId: string): PrMeta;
+export declare function extractLastVerifiedSha(logText: string): string | null;
+export declare function appendVerifyLog(logPath: string, header: string, content: string): Promise<void>;
+export declare function runShellCommand(command: string, cwd: string): Promise<{
+    code: number;
+    output: string;
+}>;
+//# sourceMappingURL=pr-meta.d.ts.map

package/dist/commands/shared/pr-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-meta.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/pr-meta.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,MAAM,GAAG;IACnB,cAAc,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE,CAAC;AAEF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAoBD"}

package/dist/commands/shared/pr-meta.js

@@ -0,0 +1,72 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { execFileAsync } from "./git.js";
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isIsoDate(value) {
+    return typeof value === "string" && !Number.isNaN(Date.parse(value));
+}
+export function parsePrMeta(raw, taskId) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`JSON Parse error: ${message}`);
+    }
+    if (!isRecord(parsed))
+        throw new Error("pr/meta.json must be an object");
+    if (parsed.schema_version !== 1)
+        throw new Error("pr/meta.json schema_version must be 1");
+    if (parsed.task_id !== taskId)
+        throw new Error("pr/meta.json task_id mismatch");
+    if (!isIsoDate(parsed.created_at))
+        throw new Error("pr/meta.json created_at must be ISO");
+    if (!isIsoDate(parsed.updated_at))
+        throw new Error("pr/meta.json updated_at must be ISO");
+    return parsed;
+}
+export function extractLastVerifiedSha(logText) {
+    const regex = /verified_sha=([0-9a-f]{7,40})/gi;
+    let match = null;
+    let last = null;
+    while ((match = regex.exec(logText))) {
+        last = match[1] ?? null;
+    }
+    return last;
+}
+export async function appendVerifyLog(logPath, header, content) {
+    await mkdir(path.dirname(logPath), { recursive: true });
+    const lines = [header.trimEnd()];
+    if (content)
+        lines.push(content.trimEnd());
+    lines.push("");
+    await writeFile(logPath, `${lines.join("\n")}\n`, { flag: "a" });
+}
+export async function runShellCommand(command, cwd) {
+    try {
+        const { stdout, stderr } = await execFileAsync("sh", ["-lc", command], {
+            cwd,
+            env: process.env,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        let output = "";
+        if (stdout)
+            output += stdout;
+        if (stderr)
+            output += (output && !output.endsWith("\n") ? "\n" : "") + stderr;
+        return { code: 0, output };
+    }
+    catch (err) {
+        const error = err;
+        let output = "";
+        if (error.stdout)
+            output += String(error.stdout);
+        if (error.stderr)
+            output += (output && !output.endsWith("\n") ? "\n" : "") + String(error.stderr);
+        const code = typeof error.code === "number" ? error.code : 1;
+        return { code, output };
+    }
+}

package/dist/commands/shared/task-backend.d.ts

@@ -0,0 +1,15 @@
+import { loadTaskBackend, type TaskData } from "../../backends/task-backend.js";
+export declare function resolveDocUpdatedBy(task: TaskData, author?: string): string;
+export declare function taskDataToFrontmatter(task: TaskData): Record<string, unknown>;
+export declare function loadBackendTask(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    taskId: string;
+}): Promise<{
+    backend: Awaited<ReturnType<typeof loadTaskBackend>>["backend"];
+    backendId: string;
+    resolved: Awaited<ReturnType<typeof loadTaskBackend>>["resolved"];
+    config: Awaited<ReturnType<typeof loadTaskBackend>>["config"];
+    task: TaskData;
+}>;
+//# sourceMappingURL=task-backend.d.ts.map

package/dist/commands/shared/task-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAShF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB7E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC,CAgBD"}

package/dist/commands/shared/task-backend.js

@@ -0,0 +1,55 @@
+import path from "node:path";
+import { CliError } from "../../shared/errors.js";
+import { loadTaskBackend } from "../../backends/task-backend.js";
+function normalizeDocUpdatedBy(value) {
+    const trimmed = value?.trim() ?? "";
+    if (!trimmed)
+        return "";
+    if (trimmed.toLowerCase() === "agentplane")
+        return "";
+    return trimmed;
+}
+export function resolveDocUpdatedBy(task, author) {
+    const fromAuthor = normalizeDocUpdatedBy(author);
+    if (fromAuthor)
+        return fromAuthor;
+    const fromTask = normalizeDocUpdatedBy(typeof task.doc_updated_by === "string" ? task.doc_updated_by : undefined);
+    if (fromTask)
+        return fromTask;
+    return normalizeDocUpdatedBy(typeof task.owner === "string" ? task.owner : undefined);
+}
+export function taskDataToFrontmatter(task) {
+    return {
+        id: task.id,
+        title: task.title,
+        status: task.status,
+        priority: task.priority,
+        owner: task.owner,
+        depends_on: task.depends_on ?? [],
+        tags: task.tags ?? [],
+        verify: task.verify ?? [],
+        commit: task.commit ?? null,
+        comments: task.comments ?? [],
+        doc_version: task.doc_version,
+        doc_updated_at: task.doc_updated_at,
+        doc_updated_by: task.doc_updated_by,
+        description: task.description ?? "",
+    };
+}
+export async function loadBackendTask(opts) {
+    const { backend, backendId, resolved, config } = await loadTaskBackend({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    const task = await backend.getTask(opts.taskId);
+    if (!task) {
+        const tasksDir = path.join(resolved.gitRoot, config.paths.workflow_dir);
+        const readmePath = path.join(tasksDir, opts.taskId, "README.md");
+        throw new CliError({
+            exitCode: 4,
+            code: "E_IO",
+            message: `ENOENT: no such file or directory, open '${readmePath}'`,
+        });
+    }
+    return { backend, backendId, resolved, config, task };
+}

package/dist/commands/task/add.d.ts

@@ -0,0 +1,8 @@
+export declare const TASK_ADD_USAGE = "Usage: agentplane task add <task-id> [<task-id> ...] --title <text> --description <text> --priority <low|normal|med|high> --owner <id> --tag <tag> [--tag <tag>...]";
+export declare const TASK_ADD_USAGE_EXAMPLE = "agentplane task add 202602030608-F1Q8AB --title \"...\" --description \"...\" --priority med --owner CODER --tag cli";
+export declare function cmdTaskAdd(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/task/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/commands/task/add.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,cAAc,wKAC4I,CAAC;AACxK,eAAO,MAAM,sBAAsB,yHACiF,CAAC;AAgGrH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFlB"}