@agentplaneorg/core 0.1.7 → 0.1.9

package/dist/commit/commit-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-policy.d.ts","sourceRoot":"","sources":["../../src/commit/commit-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAMF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAOlF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,kBAAkB,CAerB"}
+{"version":3,"file":"commit-policy.d.ts","sourceRoot":"","sources":["../../src/commit/commit-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAMF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAOlF;AA4BD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,kBAAkB,CAgCrB"}

package/dist/commit/commit-policy.js

@@ -15,17 +15,54 @@ export function isGenericSubject(subject, genericTokens) {
     const tokenSet = new Set(genericTokens.map((t) => t.toLowerCase()));
     return words.length <= 3 && words.every((w) => tokenSet.has(w));
 }
+function parseSubjectTemplate(subject) {
+    const trimmed = subject.trim();
+    if (!trimmed)
+        return null;
+    const match = /^(\S+)\s+(\S+)\s+(.+)$/.exec(trimmed);
+    if (!match)
+        return null;
+    const emoji = match[1] ?? "";
+    const suffix = match[2] ?? "";
+    const rest = (match[3] ?? "").trim();
+    if (!emoji || !suffix || !rest)
+        return null;
+    const scopeMatch = /^([a-z][a-z0-9_-]*):\s+(.+)$/.exec(rest);
+    if (!scopeMatch)
+        return null;
+    const scope = scopeMatch[1] ?? "";
+    const summary = (scopeMatch[2] ?? "").trim();
+    if (!scope || !summary)
+        return null;
+    return { emoji, suffix, scope, summary };
+}
 export function validateCommitSubject(opts) {
     const errors = [];
     const subject = opts.subject.trim();
     if (!subject)
         errors.push("commit subject must be non-empty");
     const suffix = extractTaskSuffix(opts.taskId);
-    if (!subject.includes(opts.taskId) && (suffix.length === 0 || !subject.includes(suffix))) {
-        errors.push("commit subject must include task id or suffix");
+    const template = parseSubjectTemplate(subject);
+    if (!template) {
+        errors.push("commit subject must match: <emoji> <suffix> <scope>: <summary>");
+        return { ok: false, errors };
+    }
+    if (!suffix) {
+        errors.push("task id has no suffix");
     }
-    if (isGenericSubject(subject, opts.genericTokens)) {
+    else if (template.suffix.toLowerCase() !== suffix.toLowerCase()) {
+        errors.push("commit subject must include task suffix as the second token");
+    }
+    const normalizedSummary = stripPunctuation(template.summary).toLowerCase().trim();
+    if (!normalizedSummary) {
         errors.push("commit subject is too generic");
+        return { ok: errors.length === 0, errors };
     }
+    const words = normalizedSummary.split(/\s+/).filter(Boolean);
+    const tokenSet = new Set(opts.genericTokens.map((t) => t.toLowerCase()));
+    const nonGenericCount = words.filter((w) => !tokenSet.has(w)).length;
+    // Require at least two words in the summary and at least one non-generic token.
+    if (words.length < 2 || nonGenericCount < 1)
+        errors.push("commit subject is too generic");
     return { ok: errors.length === 0, errors };
 }

package/dist/config/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,CAAC,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,yBAAyB,EAAE,OAAO,CAAC;IACnC,MAAM,CAAC,EAAE;QACP,SAAS,EAAE;YACT,YAAY,EAAE,OAAO,CAAC;YACtB,eAAe,EAAE,OAAO,CAAC;YACzB,cAAc,EAAE,OAAO,CAAC;SACzB,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;KAC7C,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1D,KAAK,EAAE;QACL,wBAAwB,EAAE,MAAM,CAAC;QACjC,MAAM,EAAE;YAAE,aAAa,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QACpC,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QACzD,QAAQ,EAAE;YACR,KAAK,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7C,OAAO,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAC/C,QAAQ,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;SACjD,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACrC,aAAa,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,gCAAgC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD;AAkED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAa7D;AAID,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC;AAQF,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8B7E;AAkBD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAgBN;AAED,wBAAsB,UAAU,CAC9B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,CAAC,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,yBAAyB,EAAE,OAAO,CAAC;IACnC,MAAM,CAAC,EAAE;QACP,SAAS,EAAE;YACT,YAAY,EAAE,OAAO,CAAC;YACtB,eAAe,EAAE,OAAO,CAAC;YACzB,cAAc,EAAE,OAAO,CAAC;SACzB,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;KAC7C,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1D,KAAK,EAAE;QACL,wBAAwB,EAAE,MAAM,CAAC;QACjC,MAAM,EAAE;YAAE,aAAa,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QACpC,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QACzD,QAAQ,EAAE;YACR,KAAK,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7C,OAAO,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAC/C,QAAQ,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;SACjD,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACrC,aAAa,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,gCAAgC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD;AAkED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAa7D;AAID,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC;AAQF,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8B7E;AAkBD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAgBN;AAED,wBAAsB,UAAU,CAC9B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}

package/dist/config/config.js

@@ -1,9 +1,10 @@
 import { readFileSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import AjvModule from "ajv";
 import AjvFormatsModule from "ajv-formats";
+import { atomicWriteFile } from "../fs/atomic-write.js";
 export function defaultConfig() {
     return structuredClone(DEFAULT_CONFIG);
 }
@@ -148,6 +149,6 @@ export async function saveConfig(agentplaneDir, raw) {
     await mkdir(agentplaneDir, { recursive: true });
     const filePath = path.join(agentplaneDir, "config.json");
     const text = `${JSON.stringify(sanitized.sanitized, null, 2)}\n`;
-    await writeFile(filePath, text, "utf8");
+    await atomicWriteFile(filePath, text, "utf8");
     return validated;
 }

package/dist/git/base-branch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-branch.d.ts","sourceRoot":"","sources":["../../src/git/base-branch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiDxD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGzB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBzB"}
+{"version":3,"file":"base-branch.d.ts","sourceRoot":"","sources":["../../src/git/base-branch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAgDxD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGzB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBzB"}

package/dist/git/base-branch.js

@@ -4,6 +4,7 @@ import { resolveProject } from "../project/project-root.js";
 const execFileAsync = promisify(execFile);
 const DEFAULT_BASE_BRANCH = "main";
 const GIT_CONFIG_BASE_BRANCH_KEY = "agentplane.baseBranch";
+const LEGACY_DEFAULT_BASE_BRANCH = "master";
 async function gitConfigGet(cwd, key) {
     try {
         const { stdout } = await execFileAsync("git", ["config", "--local", "--get", key], { cwd });
@@ -32,22 +33,19 @@ async function gitConfigUnset(cwd, key) {
         throw err;
     }
 }
-async function gitCurrentBranch(cwd) {
+async function gitLocalBranchExists(cwd, branch) {
     try {
-        const { stdout } = await execFileAsync("git", ["symbolic-ref", "--short", "HEAD"], { cwd });
-        const trimmed = stdout.trim();
-        if (trimmed)
-            return trimmed;
-    }
-    catch {
-        // fall through
+        await execFileAsync("git", ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`], {
+            cwd,
+        });
+        return true;
     }
-    const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd });
-    const trimmed = stdout.trim();
-    if (!trimmed || trimmed === "HEAD") {
-        throw new Error("Failed to resolve current branch");
+    catch (err) {
+        const code = err?.code;
+        if (code === 1)
+            return false;
+        throw err;
     }
-    return trimmed;
 }
 export async function getPinnedBaseBranch(opts) {
     const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
@@ -84,7 +82,12 @@ export async function resolveBaseBranch(opts) {
             cwd: opts.cwd,
             rootOverride: opts.rootOverride ?? null,
         });
-        return await gitCurrentBranch(resolved.gitRoot);
+        if (await gitLocalBranchExists(resolved.gitRoot, DEFAULT_BASE_BRANCH))
+            return DEFAULT_BASE_BRANCH;
+        if (await gitLocalBranchExists(resolved.gitRoot, LEGACY_DEFAULT_BASE_BRANCH))
+            return LEGACY_DEFAULT_BASE_BRANCH;
+        // No safe default: require pinning to avoid silently treating feature branches as base.
+        return null;
     }
     return null;
 }

package/dist/git/git-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../src/git/git-utils.ts"],"names":[],"mappings":"AAeA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGpB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcpB"}
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../src/git/git-utils.ts"],"names":[],"mappings":"AAoBA,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGpB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOpB"}

package/dist/git/git-utils.js

@@ -2,30 +2,27 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { resolveProject } from "../project/project-root.js";
 const execFileAsync = promisify(execFile);
-async function gitLines(cwd, args) {
-    const { stdout } = await execFileAsync("git", args, { cwd });
-    return stdout
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
+async function gitNullSeparatedPaths(cwd, args) {
+    const { stdout } = await execFileAsync("git", args, {
+        cwd,
+        encoding: "buffer",
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    const text = Buffer.isBuffer(stdout) ? stdout.toString("utf8") : String(stdout);
+    return text
+        .split("\0")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
 }
 export async function getStagedFiles(opts) {
     const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
-    return await gitLines(resolved.gitRoot, ["diff", "--name-only", "--cached"]);
+    return await gitNullSeparatedPaths(resolved.gitRoot, ["diff", "--name-only", "--cached", "-z"]);
 }
 export async function getUnstagedFiles(opts) {
     const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
-    const lines = await gitLines(resolved.gitRoot, ["status", "--porcelain"]);
-    const files = [];
-    for (const line of lines) {
-        const status = line.slice(0, 2);
-        const filePart = line.slice(3).trim();
-        if (!filePart)
-            continue;
-        const name = filePart.includes("->") ? filePart.split("->").at(-1)?.trim() : filePart;
-        if ((status === "??" || status[1] !== " ") && name) {
-            files.push(name);
-        }
-    }
-    return files;
+    const [unstaged, untracked] = await Promise.all([
+        gitNullSeparatedPaths(resolved.gitRoot, ["diff", "--name-only", "-z"]),
+        gitNullSeparatedPaths(resolved.gitRoot, ["ls-files", "--others", "--exclude-standard", "-z"]),
+    ]);
+    return [...new Set([...unstaged, ...untracked])].toSorted((a, b) => a.localeCompare(b));
 }

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export declare const CORE_VERSION = "0.0.0";
 export { findGitRoot, resolveProject, type ResolvedProject, type ResolveProjectOptions, } from "./project/project-root.js";
 export { defaultConfig, loadConfig, saveConfig, setByDottedKey, validateConfig, type AgentplaneConfig, type LoadedConfig, type StatusCommitPolicy, type WorkflowMode, } from "./config/config.js";
 export { parseTaskReadme, renderTaskFrontmatter, renderTaskReadme, type ParsedTaskReadme, } from "./tasks/task-readme.js";
+export { readTaskReadme, updateTaskReadmeAtomic } from "./tasks/task-readme-io.js";
 export { docChanged, ensureDocSections, extractTaskDoc, mergeTaskDoc, normalizeDocSectionName, normalizeTaskDoc, parseDocSections, setMarkdownSection, splitCombinedHeadingLines, } from "./tasks/task-doc.js";
 export { atomicWriteFile } from "./fs/atomic-write.js";
 export { generateTaskId, timestampIdPrefix, TASK_ID_ALPHABET } from "./tasks/task-id.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,OAAO,EACL,WAAW,EACX,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,OAAO,EACL,WAAW,EACX,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnF,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@ export const CORE_VERSION = "0.0.0";
 export { findGitRoot, resolveProject, } from "./project/project-root.js";
 export { defaultConfig, loadConfig, saveConfig, setByDottedKey, validateConfig, } from "./config/config.js";
 export { parseTaskReadme, renderTaskFrontmatter, renderTaskReadme, } from "./tasks/task-readme.js";
+export { readTaskReadme, updateTaskReadmeAtomic } from "./tasks/task-readme-io.js";
 export { docChanged, ensureDocSections, extractTaskDoc, mergeTaskDoc, normalizeDocSectionName, normalizeTaskDoc, parseDocSections, setMarkdownSection, splitCombinedHeadingLines, } from "./tasks/task-doc.js";
 export { atomicWriteFile } from "./fs/atomic-write.js";
 export { generateTaskId, timestampIdPrefix, TASK_ID_ALPHABET } from "./tasks/task-id.js";

package/dist/tasks/task-readme-io.d.ts

@@ -0,0 +1,7 @@
+import { type ParsedTaskReadme } from "./task-readme.js";
+export declare function readTaskReadme(readmePath: string): Promise<ParsedTaskReadme>;
+export declare function updateTaskReadmeAtomic(readmePath: string, updater: (parsed: ParsedTaskReadme) => {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}): Promise<void>;
+//# sourceMappingURL=task-readme-io.d.ts.map

package/dist/tasks/task-readme-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-readme-io.d.ts","sourceRoot":"","sources":["../../src/tasks/task-readme-io.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqC,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE5F,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGlF;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK;IAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5F,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/tasks/task-readme-io.js

@@ -0,0 +1,14 @@
+import { readFile } from "node:fs/promises";
+import { atomicWriteFile } from "../fs/atomic-write.js";
+import { parseTaskReadme, renderTaskReadme } from "./task-readme.js";
+export async function readTaskReadme(readmePath) {
+    const text = await readFile(readmePath, "utf8");
+    return parseTaskReadme(text);
+}
+export async function updateTaskReadmeAtomic(readmePath, updater) {
+    const text = await readFile(readmePath, "utf8");
+    const parsed = parseTaskReadme(text);
+    const next = updater(parsed);
+    const rendered = renderTaskReadme(next.frontmatter, next.body);
+    await atomicWriteFile(readmePath, rendered.endsWith("\n") ? rendered : `${rendered}\n`);
+}

package/dist/tasks/task-readme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-readme.d.ts","sourceRoot":"","sources":["../../src/tasks/task-readme.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAqBF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAYlE;AAiED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA8BlF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3F"}
+{"version":3,"file":"task-readme.d.ts","sourceRoot":"","sources":["../../src/tasks/task-readme.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAqBF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAYlE;AA6FD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAoClF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3F"}

package/dist/tasks/task-readme.js

@@ -2,6 +2,18 @@ import { parse as parseYaml } from "yaml";
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);
 }
+function orderedKeys(value, preferredKeyOrder) {
+    const keys = Object.keys(value);
+    const ordered = [];
+    if (preferredKeyOrder) {
+        for (const k of preferredKeyOrder)
+            if (k in value)
+                ordered.push(k);
+    }
+    const remaining = keys.filter((k) => !ordered.includes(k)).toSorted((a, b) => a.localeCompare(b));
+    ordered.push(...remaining);
+    return ordered;
+}
 function stripLeadingFrontmatterBlocks(body) {
     let next = body.replaceAll("\r\n", "\n");
     while (true) {
@@ -34,6 +46,8 @@ export function parseTaskReadme(markdown) {
     return { frontmatter: parsed, body };
 }
 function renderScalar(value) {
+    if (value === undefined)
+        return "null";
     if (value === null)
         return "null";
     if (typeof value === "string")
@@ -44,58 +58,80 @@ function renderScalar(value) {
         return value ? "true" : "false";
     throw new TypeError(`Unsupported scalar type: ${typeof value}`);
 }
-function renderInlineMap(value, preferredKeyOrder) {
-    const keys = Object.keys(value);
-    const ordered = [];
-    if (preferredKeyOrder) {
-        for (const k of preferredKeyOrder)
-            if (k in value)
-                ordered.push(k);
-    }
-    const remaining = keys.filter((k) => !ordered.includes(k)).toSorted((a, b) => a.localeCompare(b));
-    ordered.push(...remaining);
-    const parts = ordered.map((k) => {
-        const v = value[k];
-        if (Array.isArray(v))
-            return `${k}: ${renderFlowSeq(v)}`;
-        if (isRecord(v))
-            return `${k}: ${renderInlineMap(v, null)}`;
-        return `${k}: ${renderScalar(v)}`;
-    });
-    return `{ ${parts.join(", ")} }`;
-}
 function renderFlowSeq(value) {
-    const parts = value.map((v) => {
+    const parts = value
+        .filter((v) => v !== undefined)
+        .map((v) => {
         if (Array.isArray(v))
             return renderFlowSeq(v);
         if (isRecord(v))
-            return renderInlineMap(v, null);
+            return `{ ${orderedKeys(v, null)
+                .filter((k) => v[k] !== undefined)
+                .map((k) => `${k}: ${renderScalar(v[k])}`)
+                .join(", ")} }`;
         return renderScalar(v);
     });
     return `[${parts.join(", ")}]`;
 }
-function renderValue(key, value) {
+function renderMapLines(value, indent, preferredKeyOrder) {
+    const keys = orderedKeys(value, preferredKeyOrder);
+    const lines = [];
+    for (const k of keys) {
+        const v = value[k];
+        if (v === undefined)
+            continue;
+        lines.push(...renderValueLines(k, v, indent));
+    }
+    return lines;
+}
+function isStringArray(value) {
+    return value.every((v) => typeof v === "string");
+}
+function renderValueLines(key, value, indent) {
+    if (value === undefined)
+        return [];
     if (Array.isArray(value)) {
         if (value.length === 0)
-            return [`${key}: []`];
+            return [`${indent}${key}: []`];
+        if (isStringArray(value)) {
+            return [`${indent}${key}:`, ...value.map((item) => `${indent}  - ${renderScalar(item)}`)];
+        }
         const allObjects = value.every((v) => isRecord(v));
         if (!allObjects)
-            return [`${key}: ${renderFlowSeq(value)}`];
+            return [`${indent}${key}: ${renderFlowSeq(value)}`];
         return [
-            `${key}:`,
-            ...value.map((item) => {
+            `${indent}${key}:`,
+            ...value.flatMap((item) => {
                 if (!isRecord(item))
                     throw new TypeError("Expected an object item in YAML sequence");
-                const preferred = key === "comments" ? ["author", "body"] : null;
-                return `  - ${renderInlineMap(item, preferred)}`;
+                const preferred = key === "comments"
+                    ? ["author", "body"]
+                    : key === "events"
+                        ? ["type", "at", "author", "from", "to", "state", "note", "body"]
+                        : null;
+                const itemLines = renderMapLines(item, `${indent}    `, preferred);
+                if (itemLines.length === 0)
+                    return [`${indent}  - {}`];
+                return [`${indent}  -`, ...itemLines];
             }),
         ];
     }
     if (isRecord(value)) {
-        const preferred = key === "commit" ? ["hash", "message"] : null;
-        return [`${key}: ${renderInlineMap(value, preferred)}`];
+        const preferred = key === "origin"
+            ? ["system", "issue_id", "url"]
+            : key === "plan_approval"
+                ? ["state", "updated_at", "updated_by", "note"]
+                : key === "verification"
+                    ? ["state", "updated_at", "updated_by", "note"]
+                    : key === "commit"
+                        ? ["hash", "message"]
+                        : null;
+        const inner = renderMapLines(value, `${indent}  `, preferred);
+        if (inner.length === 0)
+            return [`${indent}${key}: {}`];
+        return [`${indent}${key}:`, ...inner];
     }
-    return [`${key}: ${renderScalar(value)}`];
+    return [`${indent}${key}: ${renderScalar(value)}`];
 }
 export function renderTaskFrontmatter(frontmatter) {
     const preferredKeyOrder = [
@@ -104,26 +140,31 @@ export function renderTaskFrontmatter(frontmatter) {
         "status",
         "priority",
         "owner",
+        "created_at",
+        "created_by",
+        "origin",
         "depends_on",
         "tags",
         "verify",
+        "plan_approval",
+        "verification",
         "commit",
         "comments",
+        "events",
         "doc_version",
         "doc_updated_at",
         "doc_updated_by",
         "description",
+        "id_source",
+        "dirty",
     ];
-    const keys = Object.keys(frontmatter);
-    const ordered = [];
-    for (const k of preferredKeyOrder)
-        if (k in frontmatter)
-            ordered.push(k);
-    const remaining = keys.filter((k) => !ordered.includes(k)).toSorted((a, b) => a.localeCompare(b));
-    ordered.push(...remaining);
+    const ordered = orderedKeys(frontmatter, preferredKeyOrder);
     const lines = [];
     for (const k of ordered) {
-        lines.push(...renderValue(k, frontmatter[k]));
+        const value = frontmatter[k];
+        if (value === undefined)
+            continue;
+        lines.push(...renderValueLines(k, value, ""));
     }
     return `---\n${lines.join("\n")}\n---\n`;
 }

package/dist/tasks/task-store.d.ts

@@ -1,6 +1,16 @@
 import { generateTaskId } from "./task-id.js";
 export type TaskStatus = "TODO" | "DOING" | "DONE" | "BLOCKED";
 export type TaskPriority = "low" | "normal" | "med" | "high";
+export type TaskEvent = {
+    type: "status" | "comment" | "verify";
+    at: string;
+    author: string;
+    from?: string;
+    to?: string;
+    state?: string;
+    note?: string;
+    body?: string;
+};
 export type TaskFrontmatter = {
     id: string;
     title: string;
@@ -10,10 +20,23 @@ export type TaskFrontmatter = {
     depends_on: string[];
     tags: string[];
     verify: string[];
+    plan_approval?: {
+        state: "pending" | "approved" | "rejected";
+        updated_at: string | null;
+        updated_by: string | null;
+        note: string | null;
+    };
+    verification?: {
+        state: "pending" | "ok" | "needs_rework";
+        updated_at: string | null;
+        updated_by: string | null;
+        note: string | null;
+    };
     comments: {
         author: string;
         body: string;
     }[];
+    events?: TaskEvent[];
     doc_version: 2;
     doc_updated_at: string;
     doc_updated_by: string;

package/dist/tasks/task-store.d.ts.map

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

package/dist/tasks/task-store.js

@@ -1,8 +1,10 @@
-import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { loadConfig } from "../config/config.js";
+import { atomicWriteFile } from "../fs/atomic-write.js";
 import { resolveProject } from "../project/project-root.js";
 import { parseTaskReadme, renderTaskReadme } from "./task-readme.js";
+import { updateTaskReadmeAtomic } from "./task-readme-io.js";
 import { ensureDocSections, setMarkdownSection } from "./task-doc.js";
 import { generateTaskId } from "./task-id.js";
 function nowIso() {
@@ -55,15 +57,25 @@ function defaultTaskBody() {
         "## Scope",
         "",
         "",
-        "## Risks",
+        "## Plan",
         "",
         "",
-        "## Verify Steps",
+        "## Risks",
         "",
         "",
         "## Verification",
         "",
         "",
+        "### Plan",
+        "",
+        "",
+        "### Results",
+        "",
+        "",
+        "<!-- BEGIN VERIFICATION RESULTS -->",
+        "<!-- END VERIFICATION RESULTS -->",
+        "",
+        "",
         "## Rollback Plan",
         "",
     ].join("\n");
@@ -133,7 +145,20 @@ export async function createTask(opts) {
         depends_on: opts.dependsOn,
         tags: opts.tags,
         verify: opts.verify,
+        plan_approval: {
+            state: "pending",
+            updated_at: null,
+            updated_by: null,
+            note: null,
+        },
+        verification: {
+            state: "pending",
+            updated_at: null,
+            updated_by: null,
+            note: null,
+        },
         comments: [],
+        events: [],
         doc_version: 2,
         doc_updated_at: nowIso(),
         doc_updated_by: opts.owner,
@@ -141,8 +166,7 @@ export async function createTask(opts) {
     };
     const body = defaultTaskBody();
     const text = renderTaskReadme(frontmatter, body);
-    await mkdir(path.dirname(readmePath), { recursive: true });
-    await writeFile(readmePath, text, "utf8");
+    await atomicWriteFile(readmePath, text, "utf8");
     return { id, readmePath };
 }
 export async function setTaskDocSection(opts) {
@@ -154,19 +178,18 @@ export async function setTaskDocSection(opts) {
     }
     const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
     const readmePath = taskReadmePath(tasksDir, opts.taskId);
-    const original = await readFile(readmePath, "utf8");
-    const parsed = parseTaskReadme(original);
-    const updatedBy = resolveDocUpdatedBy(parsed.frontmatter, opts.updatedBy);
-    const nextFrontmatter = {
-        ...parsed.frontmatter,
-        doc_version: 2,
-        doc_updated_at: nowIso(),
-        doc_updated_by: updatedBy,
-    };
-    const baseDoc = ensureDocSections(parsed.body, loaded.config.tasks.doc.required_sections);
-    const nextBody = ensureDocSections(setMarkdownSection(baseDoc, opts.section, opts.text), loaded.config.tasks.doc.required_sections);
-    const nextText = renderTaskReadme(nextFrontmatter, nextBody);
-    await writeFile(readmePath, nextText, "utf8");
+    await updateTaskReadmeAtomic(readmePath, (parsed) => {
+        const updatedBy = resolveDocUpdatedBy(parsed.frontmatter, opts.updatedBy);
+        const nextFrontmatter = {
+            ...parsed.frontmatter,
+            doc_version: 2,
+            doc_updated_at: nowIso(),
+            doc_updated_by: updatedBy,
+        };
+        const baseDoc = ensureDocSections(parsed.body, loaded.config.tasks.doc.required_sections);
+        const nextBody = ensureDocSections(setMarkdownSection(baseDoc, opts.section, opts.text), loaded.config.tasks.doc.required_sections);
+        return { frontmatter: nextFrontmatter, body: nextBody };
+    });
     return { readmePath };
 }
 export async function readTask(opts) {

package/dist/tasks/tasks-export.d.ts

@@ -22,6 +22,16 @@ export type TasksExportTask = {
         author: string;
         body: string;
     }[];
+    events?: {
+        type: string;
+        at: string;
+        author: string;
+        from?: string;
+        to?: string;
+        state?: string;
+        note?: string;
+        body?: string;
+    }[];
     doc_version: 2;
     doc_updated_at: string;
     doc_updated_by: string;

package/dist/tasks/tasks-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks-export.d.ts","sourceRoot":"","sources":["../../src/tasks/tasks-export.ts"],"names":[],"mappings":"AAaA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWxD;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,QAAQ,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAEtE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAGrE;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqE/B;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAW3D"}
+{"version":3,"file":"tasks-export.d.ts","sourceRoot":"","sources":["../../src/tasks/tasks-export.ts"],"names":[],"mappings":"AAaA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWxD;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,QAAQ,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,WAAW,EAAE,CAAC,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAEtE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAGrE;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyG/B;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAW3D"}

package/dist/tasks/tasks-export.js

@@ -55,7 +55,24 @@ export async function buildTasksExportSnapshot(opts) {
                 .filter((c) => typeof c.author === "string" && typeof c.body === "string")
                 .map((c) => ({ author: c.author, body: c.body }))
             : [];
-        return {
+        const events = Array.isArray(fm.events)
+            ? fm.events
+                .filter((event) => isRecord(event))
+                .filter((event) => typeof event.type === "string" &&
+                typeof event.at === "string" &&
+                typeof event.author === "string")
+                .map((event) => ({
+                type: event.type,
+                at: event.at,
+                author: event.author,
+                from: typeof event.from === "string" ? event.from : undefined,
+                to: typeof event.to === "string" ? event.to : undefined,
+                state: typeof event.state === "string" ? event.state : undefined,
+                note: typeof event.note === "string" ? event.note : undefined,
+                body: typeof event.body === "string" ? event.body : undefined,
+            }))
+            : [];
+        const base = {
             id: typeof fm.id === "string" ? fm.id : t.id,
             title: typeof fm.title === "string" ? fm.title : "",
             status: typeof fm.status === "string" ? fm.status : "",
@@ -73,6 +90,10 @@ export async function buildTasksExportSnapshot(opts) {
             dirty: false,
             id_source: "generated",
         };
+        if (events.length > 0) {
+            return { ...base, events };
+        }
+        return base;
     });
     const sorted = exportTasks.toSorted((a, b) => a.id.localeCompare(b.id));
     const checksum = computeTasksChecksum(sorted);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentplaneorg/core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Core utilities and models for the Agent Plane CLI.",
   "keywords": [
     "agentplane",

package/schemas/config.schema.json

@@ -111,6 +111,7 @@
             "Summary",
             "Context",
             "Scope",
+            "Plan",
             "Risks",
             "Verify Steps",
             "Verification",
@@ -120,8 +121,8 @@
           "required_sections": [
             "Summary",
             "Scope",
+            "Plan",
             "Risks",
-            "Verify Steps",
             "Verification",
             "Rollback Plan"
           ]
@@ -162,6 +163,7 @@
               "Summary",
               "Context",
               "Scope",
+              "Plan",
               "Risks",
               "Verify Steps",
               "Verification",
@@ -171,8 +173,8 @@
             "required_sections": [
               "Summary",
               "Scope",
+              "Plan",
               "Risks",
-              "Verify Steps",
               "Verification",
               "Rollback Plan"
             ]
@@ -185,6 +187,7 @@
                 "Summary",
                 "Context",
                 "Scope",
+                "Plan",
                 "Risks",
                 "Verify Steps",
                 "Verification",
@@ -195,14 +198,7 @@
             "required_sections": {
               "type": "array",
               "items": { "type": "string", "minLength": 1 },
-              "default": [
-                "Summary",
-                "Scope",
-                "Risks",
-                "Verify Steps",
-                "Verification",
-                "Rollback Plan"
-              ]
+              "default": ["Summary", "Scope", "Plan", "Risks", "Verification", "Rollback Plan"]
             }
           }
         },