@agentplaneorg/core 0.1.6 → 0.1.8

package/dist/config/config.d.ts

@@ -5,7 +5,6 @@ export type AgentplaneConfig = {
     workflow_mode: WorkflowMode;
     status_commit_policy: StatusCommitPolicy;
     finish_auto_status_commit: boolean;
-    base_branch: string;
     agents?: {
         approvals: {
             require_plan: boolean;

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,WAAW,EAAE,MAAM,CAAC;IACpB,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;AA2CD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAU7D;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,CAyB7E;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,CAO3B"}
+{"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);
 }
@@ -29,8 +30,28 @@ function formatSchemaErrors(errors) {
         return "config schema validation failed";
     return AJV.errorsText(errors, { dataVar: "config" });
 }
+const DEPRECATED_CONFIG_KEYS = ["base_branch"];
+function stripDeprecatedConfigKeys(raw) {
+    const sanitized = { ...raw };
+    const removed = [];
+    for (const key of DEPRECATED_CONFIG_KEYS) {
+        if (key in sanitized) {
+            delete sanitized[key];
+            removed.push(key);
+        }
+    }
+    return { sanitized, removed };
+}
+function warnDeprecatedConfigKeys(keys) {
+    for (const key of keys) {
+        console.warn(`config key "${key}" is deprecated and ignored`);
+    }
+}
 export function validateConfig(raw) {
-    const candidate = raw && typeof raw === "object" ? structuredClone(raw) : raw;
+    let candidate = raw && typeof raw === "object" ? structuredClone(raw) : raw;
+    if (isRecord(candidate)) {
+        candidate = stripDeprecatedConfigKeys(candidate).sanitized;
+    }
     if (!validateSchema(candidate)) {
         throw new Error(formatSchemaErrors(validateSchema.errors));
     }
@@ -52,12 +73,18 @@ export async function loadConfig(agentplaneDir) {
     try {
         const rawText = await readFile(filePath, "utf8");
         const parsed = JSON.parse(rawText);
-        const validated = validateConfig(parsed);
+        const rawRecord = isRecord(parsed) ? parsed : null;
+        const sanitized = rawRecord
+            ? stripDeprecatedConfigKeys(rawRecord)
+            : { sanitized: parsed, removed: [] };
+        if (sanitized.removed.length > 0)
+            warnDeprecatedConfigKeys(sanitized.removed);
+        const validated = validateConfig(sanitized.sanitized);
         return {
             path: filePath,
             exists: true,
             config: validated,
-            raw: parsed,
+            raw: (sanitized.sanitized ?? parsed),
         };
     }
     catch (err) {
@@ -115,10 +142,13 @@ export function setByDottedKey(obj, dottedKey, value) {
     current[last] = parseScalar(value);
 }
 export async function saveConfig(agentplaneDir, raw) {
-    const validated = validateConfig(raw);
+    const sanitized = stripDeprecatedConfigKeys(raw);
+    if (sanitized.removed.length > 0)
+        warnDeprecatedConfigKeys(sanitized.removed);
+    const validated = validateConfig(sanitized.sanitized);
     await mkdir(agentplaneDir, { recursive: true });
     const filePath = path.join(agentplaneDir, "config.json");
-    const text = `${JSON.stringify(raw, null, 2)}\n`;
-    await writeFile(filePath, text, "utf8");
+    const text = `${JSON.stringify(sanitized.sanitized, null, 2)}\n`;
+    await atomicWriteFile(filePath, text, "utf8");
     return validated;
 }

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

@@ -1,3 +1,4 @@
+import type { WorkflowMode } from "../config/config.js";
 export declare function getPinnedBaseBranch(opts: {
     cwd: string;
     rootOverride?: string | null;
@@ -11,4 +12,14 @@ export declare function setPinnedBaseBranch(opts: {
     rootOverride?: string | null;
     value: string;
 }): Promise<string>;
+export declare function clearPinnedBaseBranch(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+}): Promise<boolean>;
+export declare function resolveBaseBranch(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    cliBaseOpt?: string | null;
+    mode: WorkflowMode;
+}): Promise<string | null>;
 //# sourceMappingURL=base-branch.d.ts.map

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":"AA0BA,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"}
+{"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"}

package/dist/git/base-branch.js

@@ -20,6 +20,35 @@ async function gitConfigGet(cwd, key) {
 async function gitConfigSet(cwd, key, value) {
     await execFileAsync("git", ["config", "--local", key, value], { cwd });
 }
+async function gitConfigUnset(cwd, key) {
+    try {
+        await execFileAsync("git", ["config", "--local", "--unset", key], { cwd });
+        return true;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 1 || code === 5)
+            return false;
+        throw err;
+    }
+}
+async function gitCurrentBranch(cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", ["symbolic-ref", "--short", "HEAD"], { cwd });
+        const trimmed = stdout.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    catch {
+        // fall through
+    }
+    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");
+    }
+    return trimmed;
+}
 export async function getPinnedBaseBranch(opts) {
     const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
     return await gitConfigGet(resolved.gitRoot, GIT_CONFIG_BASE_BRANCH_KEY);
@@ -36,3 +65,26 @@ export async function setPinnedBaseBranch(opts) {
     await gitConfigSet(resolved.gitRoot, GIT_CONFIG_BASE_BRANCH_KEY, trimmed);
     return trimmed;
 }
+export async function clearPinnedBaseBranch(opts) {
+    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
+    return await gitConfigUnset(resolved.gitRoot, GIT_CONFIG_BASE_BRANCH_KEY);
+}
+export async function resolveBaseBranch(opts) {
+    const explicit = (opts.cliBaseOpt ?? "").trim();
+    if (explicit.length > 0)
+        return explicit;
+    const pinned = await getPinnedBaseBranch({
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+    });
+    if (pinned)
+        return pinned;
+    if (opts.mode === "branch_pr") {
+        const resolved = await resolveProject({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        return await gitCurrentBranch(resolved.gitRoot);
+    }
+    return null;
+}

package/dist/index.d.ts

@@ -2,13 +2,14 @@ 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";
 export { createTask, getTasksDir, listTasks, readTask, setTaskDocSection, taskReadmePath, validateTaskDocMetadata, type TaskFrontmatter, type TaskPriority, type TaskRecord, type TaskStatus, } from "./tasks/task-store.js";
 export { buildTasksExportSnapshot, canonicalTasksPayload, canonicalizeJson, computeTasksChecksum, writeTasksExport, type TasksExportMeta, type TasksExportSnapshot, type TasksExportTask, } from "./tasks/tasks-export.js";
 export { lintTasksFile, lintTasksSnapshot, readTasksExport, type TasksLintResult, } from "./tasks/tasks-lint.js";
-export { getBaseBranch, getPinnedBaseBranch, setPinnedBaseBranch } from "./git/base-branch.js";
+export { clearPinnedBaseBranch, getBaseBranch, getPinnedBaseBranch, resolveBaseBranch, setPinnedBaseBranch, } from "./git/base-branch.js";
 export { extractTaskSuffix, isGenericSubject, validateCommitSubject, type CommitPolicyResult, } from "./commit/commit-policy.js";
 export { getStagedFiles, getUnstagedFiles } from "./git/git-utils.js";
 //# sourceMappingURL=index.d.ts.map

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,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/F,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,12 +2,13 @@ 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";
 export { createTask, getTasksDir, listTasks, readTask, setTaskDocSection, taskReadmePath, validateTaskDocMetadata, } from "./tasks/task-store.js";
 export { buildTasksExportSnapshot, canonicalTasksPayload, canonicalizeJson, computeTasksChecksum, writeTasksExport, } from "./tasks/tasks-export.js";
 export { lintTasksFile, lintTasksSnapshot, readTasksExport, } from "./tasks/tasks-lint.js";
-export { getBaseBranch, getPinnedBaseBranch, setPinnedBaseBranch } from "./git/base-branch.js";
+export { clearPinnedBaseBranch, getBaseBranch, getPinnedBaseBranch, resolveBaseBranch, setPinnedBaseBranch, } from "./git/base-branch.js";
 export { extractTaskSuffix, isGenericSubject, validateCommitSubject, } from "./commit/commit-policy.js";
 export { getStagedFiles, getUnstagedFiles } from "./git/git-utils.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;AAkFD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiClF;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) {
@@ -44,58 +56,69 @@ 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) => {
         if (Array.isArray(v))
             return renderFlowSeq(v);
         if (isRecord(v))
-            return renderInlineMap(v, null);
+            return `{ ${orderedKeys(v, null)
+                .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];
+        lines.push(...renderValueLines(k, v, indent));
+    }
+    return lines;
+}
+function isStringArray(value) {
+    return value.every((v) => typeof v === "string");
+}
+function renderValueLines(key, value, indent) {
     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 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 +127,27 @@ export function renderTaskFrontmatter(frontmatter) {
         "status",
         "priority",
         "owner",
+        "created_at",
+        "created_by",
+        "origin",
         "depends_on",
         "tags",
         "verify",
+        "plan_approval",
+        "verification",
         "commit",
         "comments",
         "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]));
+        lines.push(...renderValueLines(k, frontmatter[k], ""));
     }
     return `---\n${lines.join("\n")}\n---\n`;
 }

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

@@ -10,6 +10,18 @@ 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;

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":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,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,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAUF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAgBtF;AAWD,wBAAsB,WAAW,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC,CASD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAkED,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,cAAc,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAoC9C;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BlC;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,CAAC,CActB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0BxB"}
+{"version":3,"file":"task-store.d.ts","sourceRoot":"","sources":["../../src/tasks/task-store.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;QAC3C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,cAAc,CAAC;QACzC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC;IACF,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,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAUF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAgBtF;AAWD,wBAAsB,WAAW,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC,CASD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AA4ED,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,cAAc,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA+C9C;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BlC;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,CAAC,CActB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0BxB"}

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,6 +145,18 @@ 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: [],
         doc_version: 2,
         doc_updated_at: nowIso(),
@@ -141,8 +165,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 +177,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/package.json

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

package/schemas/config.schema.json

@@ -18,7 +18,6 @@
       "default": "warn"
     },
     "finish_auto_status_commit": { "type": "boolean", "default": true },
-    "base_branch": { "type": "string", "minLength": 1, "default": "main" },
     "agents": {
       "type": "object",
       "additionalProperties": true,
@@ -112,6 +111,7 @@
             "Summary",
             "Context",
             "Scope",
+            "Plan",
             "Risks",
             "Verify Steps",
             "Verification",
@@ -121,8 +121,8 @@
           "required_sections": [
             "Summary",
             "Scope",
+            "Plan",
             "Risks",
-            "Verify Steps",
             "Verification",
             "Rollback Plan"
           ]
@@ -163,6 +163,7 @@
               "Summary",
               "Context",
               "Scope",
+              "Plan",
               "Risks",
               "Verify Steps",
               "Verification",
@@ -172,8 +173,8 @@
             "required_sections": [
               "Summary",
               "Scope",
+              "Plan",
               "Risks",
-              "Verify Steps",
               "Verification",
               "Rollback Plan"
             ]
@@ -186,6 +187,7 @@
                 "Summary",
                 "Context",
                 "Scope",
+                "Plan",
                 "Risks",
                 "Verify Steps",
                 "Verification",
@@ -196,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"]
             }
           }
         },