@agentplaneorg/core 0.1.3 → 0.1.5

package/README.md

@@ -9,18 +9,31 @@ for project discovery, config handling, task readme parsing, and task export/lin
 
 If you are an end-user, install the CLI instead: https://www.npmjs.com/package/agentplane
 
-## Install
+## 5-minute start (CLI)
+
+```bash
+npm install -g agentplane
+agentplane init
+agentplane quickstart
+agentplane task new --title "First task" --description "Describe the change" --priority med --owner ORCHESTRATOR --tag docs
+agentplane verify <task-id>
+agentplane finish <task-id>
+```
+
+## For library usage
+
+### Install
 
 ```bash
 npm install @agentplaneorg/core
 ```
 
-## Requirements
+### Requirements
 
 - Node.js >= 20
 - ESM-only (`type: module`)
 
-## Usage
+### Usage
 
 ```ts
 import {

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

@@ -0,0 +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"}

package/dist/{config.d.ts → config/config.d.ts}

@@ -10,6 +10,7 @@ export type AgentplaneConfig = {
         approvals: {
             require_plan: boolean;
             require_network: boolean;
+            require_verify: boolean;
         };
     };
     recipes?: {

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

@@ -0,0 +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"}

package/dist/config/config.js

@@ -0,0 +1,124 @@
+import { readFileSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import AjvModule from "ajv";
+import AjvFormatsModule from "ajv-formats";
+export function defaultConfig() {
+    return structuredClone(DEFAULT_CONFIG);
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+const CONFIG_SCHEMA_URL = new URL("../../../spec/schemas/config.schema.json", import.meta.url);
+const CONFIG_SCHEMA = JSON.parse(readFileSync(fileURLToPath(CONFIG_SCHEMA_URL), "utf8"));
+const Ajv = AjvModule.default ??
+    AjvModule;
+const addFormats = AjvFormatsModule.default ??
+    AjvFormatsModule;
+const AJV = new Ajv({
+    allErrors: true,
+    allowUnionTypes: true,
+    useDefaults: true,
+    strict: false,
+});
+addFormats(AJV);
+const validateSchema = AJV.compile(CONFIG_SCHEMA);
+function formatSchemaErrors(errors) {
+    if (!errors || errors.length === 0)
+        return "config schema validation failed";
+    return AJV.errorsText(errors, { dataVar: "config" });
+}
+export function validateConfig(raw) {
+    const candidate = raw && typeof raw === "object" ? structuredClone(raw) : raw;
+    if (!validateSchema(candidate)) {
+        throw new Error(formatSchemaErrors(validateSchema.errors));
+    }
+    if (!isRecord(candidate)) {
+        throw new Error("config must be an object");
+    }
+    return candidate;
+}
+const DEFAULT_CONFIG = validateConfig({});
+function toErrnoException(err) {
+    if (!err || typeof err !== "object")
+        return null;
+    if (!("code" in err))
+        return null;
+    return err;
+}
+export async function loadConfig(agentplaneDir) {
+    const filePath = path.join(agentplaneDir, "config.json");
+    try {
+        const rawText = await readFile(filePath, "utf8");
+        const parsed = JSON.parse(rawText);
+        const validated = validateConfig(parsed);
+        return {
+            path: filePath,
+            exists: true,
+            config: validated,
+            raw: parsed,
+        };
+    }
+    catch (err) {
+        const errno = toErrnoException(err);
+        if (errno?.code === "ENOENT") {
+            const def = defaultConfig();
+            return {
+                path: filePath,
+                exists: false,
+                config: def,
+                raw: def,
+            };
+        }
+        throw err;
+    }
+}
+function parseScalar(value) {
+    const trimmed = value.trim();
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (trimmed === "null")
+        return null;
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return value;
+        }
+    }
+    if (/^-?\d+(?:\.\d+)?$/.test(trimmed))
+        return Number(trimmed);
+    return value;
+}
+export function setByDottedKey(obj, dottedKey, value) {
+    const parts = dottedKey.split(".").filter(Boolean);
+    if (parts.length === 0)
+        throw new Error("config key must be non-empty");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!part)
+            continue;
+        const next = current[part];
+        if (!isRecord(next)) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    const last = parts.at(-1);
+    if (!last)
+        throw new Error("config key must be non-empty");
+    current[last] = parseScalar(value);
+}
+export async function saveConfig(agentplaneDir, raw) {
+    const validated = validateConfig(raw);
+    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");
+    return validated;
+}

package/dist/fs/atomic-write.d.ts

@@ -0,0 +1,2 @@
+export declare function atomicWriteFile(filePath: string, contents: string | Buffer, encoding?: BufferEncoding): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/fs/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/fs/atomic-write.ts"],"names":[],"mappings":"AAGA,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,QAAQ,GAAE,cAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/fs/atomic-write.js

@@ -0,0 +1,9 @@
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+export async function atomicWriteFile(filePath, contents, encoding = "utf8") {
+    const dir = path.dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    const tmpPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    await writeFile(tmpPath, contents, typeof contents === "string" ? encoding : undefined);
+    await rename(tmpPath, filePath);
+}

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

@@ -0,0 +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"}

package/dist/{base-branch.js → git/base-branch.js}

@@ -1,6 +1,6 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { resolveProject } from "./project-root.js";
+import { resolveProject } from "../project/project-root.js";
 const execFileAsync = promisify(execFile);
 const DEFAULT_BASE_BRANCH = "main";
 const GIT_CONFIG_BASE_BRANCH_KEY = "agentplane.baseBranch";

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

@@ -0,0 +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"}

package/dist/{git-utils.js → git/git-utils.js}

@@ -1,6 +1,6 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { resolveProject } from "./project-root.js";
+import { resolveProject } from "../project/project-root.js";
 const execFileAsync = promisify(execFile);
 async function gitLines(cwd, args) {
     const { stdout } = await execFileAsync("git", args, { cwd });

package/dist/index.d.ts

@@ -1,11 +1,14 @@
 export declare const CORE_VERSION = "0.0.0";
-export { findGitRoot, resolveProject, type ResolvedProject, type ResolveProjectOptions, } from "./project-root.js";
-export { defaultConfig, loadConfig, saveConfig, setByDottedKey, validateConfig, type AgentplaneConfig, type LoadedConfig, type StatusCommitPolicy, type WorkflowMode, } from "./config.js";
-export { parseTaskReadme, renderTaskFrontmatter, renderTaskReadme, type ParsedTaskReadme, } from "./task-readme.js";
-export { createTask, getTasksDir, listTasks, readTask, setTaskDocSection, taskReadmePath, validateTaskDocMetadata, type TaskFrontmatter, type TaskPriority, type TaskRecord, type TaskStatus, } from "./task-store.js";
-export { buildTasksExportSnapshot, canonicalTasksPayload, canonicalizeJson, computeTasksChecksum, writeTasksExport, type TasksExportMeta, type TasksExportSnapshot, type TasksExportTask, } from "./tasks-export.js";
-export { lintTasksFile, lintTasksSnapshot, readTasksExport, type TasksLintResult, } from "./tasks-lint.js";
-export { getBaseBranch, getPinnedBaseBranch, setPinnedBaseBranch } from "./base-branch.js";
-export { extractTaskSuffix, isGenericSubject, validateCommitSubject, type CommitPolicyResult, } from "./commit-policy.js";
-export { getStagedFiles, getUnstagedFiles } from "./git-utils.js";
+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 { 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 { 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,mBAAmB,CAAC;AAE3B,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,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,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,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE3F,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,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,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"}

package/dist/index.js

@@ -1,10 +1,13 @@
 export const CORE_VERSION = "0.0.0";
-export { findGitRoot, resolveProject, } from "./project-root.js";
-export { defaultConfig, loadConfig, saveConfig, setByDottedKey, validateConfig, } from "./config.js";
-export { parseTaskReadme, renderTaskFrontmatter, renderTaskReadme, } from "./task-readme.js";
-export { createTask, getTasksDir, listTasks, readTask, setTaskDocSection, taskReadmePath, validateTaskDocMetadata, } from "./task-store.js";
-export { buildTasksExportSnapshot, canonicalTasksPayload, canonicalizeJson, computeTasksChecksum, writeTasksExport, } from "./tasks-export.js";
-export { lintTasksFile, lintTasksSnapshot, readTasksExport, } from "./tasks-lint.js";
-export { getBaseBranch, getPinnedBaseBranch, setPinnedBaseBranch } from "./base-branch.js";
-export { extractTaskSuffix, isGenericSubject, validateCommitSubject, } from "./commit-policy.js";
-export { getStagedFiles, getUnstagedFiles } from "./git-utils.js";
+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 { 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 { extractTaskSuffix, isGenericSubject, validateCommitSubject, } from "./commit/commit-policy.js";
+export { getStagedFiles, getUnstagedFiles } from "./git/git-utils.js";

package/dist/project/project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../../src/project/project-root.ts"],"names":[],"mappings":"AAiBA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU1E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAU1F"}

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

@@ -0,0 +1,16 @@
+export declare function normalizeDocSectionName(section: string): string;
+export declare function splitCombinedHeadingLines(doc: string): string[];
+export declare function normalizeTaskDoc(doc: string): string;
+export declare function extractTaskDoc(body: string): string;
+export declare function mergeTaskDoc(body: string, doc: string): string;
+export declare function docChanged(existing: string, updated: string): boolean;
+export declare function setMarkdownSection(body: string, section: string, text: string): string;
+export declare function ensureDocSections(doc: string, required: string[]): string;
+export declare function parseDocSections(doc: string): {
+    sections: Map<string, {
+        title: string;
+        lines: string[];
+    }>;
+    order: string[];
+};
+//# sourceMappingURL=task-doc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-doc.d.ts","sourceRoot":"","sources":["../../src/tasks/task-doc.ts"],"names":[],"mappings":"AAIA,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAUD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAiC/D;AA2CD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwDpD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBnD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAiC9D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAErE;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA6BtF;AA+DD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAOzE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAyBA"}

package/dist/tasks/task-doc.js

@@ -0,0 +1,326 @@
+const DOC_SECTION_HEADER = "## Summary";
+const DOC_SECTION_HEADER_RE = /^##\s+Summary(?:\s|$|#)/;
+const AUTO_SUMMARY_HEADER = "## Changes Summary (auto)";
+export function normalizeDocSectionName(section) {
+    return section.trim().replaceAll(/\s+/g, " ").toLowerCase();
+}
+function normalizeDoc(text) {
+    return (text ?? "")
+        .split("\n")
+        .map((line) => line.replaceAll(/\s+$/gu, ""))
+        .join("\n")
+        .trim();
+}
+export function splitCombinedHeadingLines(doc) {
+    const lines = doc.replaceAll("\r\n", "\n").split("\n");
+    const out = [];
+    let inFence = false;
+    for (const line of lines) {
+        const trimmed = line.trimStart();
+        if (trimmed.startsWith("```")) {
+            inFence = !inFence;
+            out.push(line);
+            continue;
+        }
+        if (!inFence && line.includes("## ")) {
+            const matches = [...line.matchAll(/##\s+/g)];
+            if (matches.length > 1 && matches[0]?.index === 0) {
+                let start = 0;
+                for (let i = 1; i < matches.length; i += 1) {
+                    const idx = matches[i]?.index ?? 0;
+                    const chunk = line.slice(start, idx).trimEnd();
+                    if (chunk)
+                        out.push(chunk);
+                    start = idx;
+                }
+                const last = line.slice(start).trimEnd();
+                if (last)
+                    out.push(last);
+                continue;
+            }
+        }
+        out.push(line);
+    }
+    return out;
+}
+function normalizeSectionLines(lines) {
+    const trimmedLines = [...lines];
+    while (trimmedLines.length > 0 && trimmedLines[0]?.trim() === "")
+        trimmedLines.shift();
+    while (trimmedLines.length > 0 && trimmedLines.at(-1)?.trim() === "")
+        trimmedLines.pop();
+    const out = [];
+    let inFence = false;
+    let pendingBlank = false;
+    for (const line of trimmedLines) {
+        const fenceCheck = line.trimStart();
+        if (fenceCheck.startsWith("```")) {
+            if (pendingBlank) {
+                out.push("");
+                pendingBlank = false;
+            }
+            out.push(line);
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence) {
+            out.push(line);
+            continue;
+        }
+        if (line.trim() === "") {
+            pendingBlank = true;
+            continue;
+        }
+        if (pendingBlank) {
+            out.push("");
+            pendingBlank = false;
+        }
+        out.push(line);
+    }
+    return out;
+}
+export function normalizeTaskDoc(doc) {
+    const normalized = doc.replaceAll("\r\n", "\n");
+    const trimmed = normalized.replaceAll(/^\n+|\n+$/g, "");
+    if (!trimmed)
+        return "";
+    const lines = splitCombinedHeadingLines(trimmed);
+    const sections = new Map();
+    const order = [];
+    const pendingSeparator = new Set();
+    let currentKey = null;
+    for (const line of lines) {
+        const match = /^##\s+(.*)$/.exec(line.trim());
+        if (match) {
+            const title = match[1]?.trim() ?? "";
+            const key = normalizeDocSectionName(title);
+            if (key) {
+                const existing = sections.get(key);
+                if (existing) {
+                    if (existing.lines.some((entry) => entry.trim() !== "")) {
+                        pendingSeparator.add(key);
+                    }
+                }
+                else {
+                    sections.set(key, { title, lines: [] });
+                    order.push(key);
+                }
+                currentKey = key;
+                continue;
+            }
+        }
+        if (currentKey) {
+            const entry = sections.get(currentKey);
+            if (!entry)
+                continue;
+            if (pendingSeparator.has(currentKey) && line.trim() !== "") {
+                entry.lines.push("");
+                pendingSeparator.delete(currentKey);
+            }
+            entry.lines.push(line);
+        }
+    }
+    if (order.length === 0)
+        return trimmed;
+    const out = [];
+    for (const key of order) {
+        const section = sections.get(key);
+        if (!section)
+            continue;
+        const normalizedLines = normalizeSectionLines(section.lines);
+        if (normalizedLines.length > 0) {
+            out.push(`## ${section.title}`, "", ...normalizedLines, "");
+        }
+        else {
+            out.push(`## ${section.title}`, "", "");
+        }
+    }
+    return out.join("\n").trimEnd();
+}
+export function extractTaskDoc(body) {
+    if (!body)
+        return "";
+    const lines = body.split("\n");
+    let startIdx = null;
+    for (const [idx, line] of lines.entries()) {
+        if (DOC_SECTION_HEADER_RE.test(line.trim())) {
+            startIdx = idx;
+            break;
+        }
+    }
+    if (startIdx === null)
+        return "";
+    if (lines[startIdx]?.trim() !== DOC_SECTION_HEADER) {
+        lines[startIdx] = DOC_SECTION_HEADER;
+    }
+    let endIdx = lines.length;
+    for (let idx = startIdx + 1; idx < lines.length; idx += 1) {
+        if (lines[idx]?.trim() === AUTO_SUMMARY_HEADER) {
+            endIdx = idx;
+            break;
+        }
+    }
+    const doc = lines.slice(startIdx, endIdx).join("\n").trimEnd();
+    return normalizeTaskDoc(doc);
+}
+export function mergeTaskDoc(body, doc) {
+    const docText = normalizeTaskDoc(String(doc ?? ""));
+    if (docText) {
+        const lines = body ? body.split("\n") : [];
+        let prefixIdx = null;
+        for (const [idx, line] of lines.entries()) {
+            if (DOC_SECTION_HEADER_RE.test(line.trim())) {
+                prefixIdx = idx;
+                break;
+            }
+        }
+        const prefixText = prefixIdx === null ? "" : lines.slice(0, prefixIdx).join("\n").trimEnd();
+        let autoIdx = null;
+        for (const [idx, line] of lines.entries()) {
+            if (line.trim() === AUTO_SUMMARY_HEADER) {
+                autoIdx = idx;
+                break;
+            }
+        }
+        const autoBlock = autoIdx === null ? "" : lines.slice(autoIdx).join("\n").trimEnd();
+        const parts = [];
+        if (prefixText) {
+            parts.push(prefixText, "");
+        }
+        parts.push(docText.trimEnd());
+        if (autoBlock) {
+            parts.push("", autoBlock);
+        }
+        return `${parts.join("\n").trimEnd()}\n`;
+    }
+    return body;
+}
+export function docChanged(existing, updated) {
+    return normalizeDoc(existing) !== normalizeDoc(updated);
+}
+function escapeRegExp(text) {
+    return text.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\\$&`);
+}
+export function setMarkdownSection(body, section, text) {
+    const lines = body.replaceAll("\r\n", "\n").split("\n");
+    const headingRe = new RegExp(String.raw `^##\s+${escapeRegExp(section)}\s*$`);
+    let start = -1;
+    let nextHeading = lines.length;
+    for (const [i, line] of lines.entries()) {
+        if (!line.startsWith("## "))
+            continue;
+        if (start === -1) {
+            if (headingRe.test(line))
+                start = i;
+            continue;
+        }
+        nextHeading = i;
+        break;
+    }
+    const newTextLines = text.replaceAll("\r\n", "\n").split("\n");
+    const replacement = ["", ...newTextLines, ""];
+    if (start === -1) {
+        const out = [...lines];
+        if (out.length > 0 && out.at(-1)?.trim() !== "")
+            out.push("");
+        out.push(`## ${section}`, ...replacement);
+        return `${out.join("\n")}\n`;
+    }
+    const out = [...lines.slice(0, start + 1), ...replacement, ...lines.slice(nextHeading)];
+    return `${out.join("\n")}\n`;
+}
+function normalizeDocSections(doc, required) {
+    const lines = splitCombinedHeadingLines(doc);
+    const sections = new Map();
+    const order = [];
+    const pendingSeparator = new Set();
+    let currentKey = null;
+    for (const line of lines) {
+        const match = /^##\s+(.*)$/.exec(line.trim());
+        if (match) {
+            const title = match[1]?.trim() ?? "";
+            const key = normalizeDocSectionName(title);
+            if (key) {
+                const existing = sections.get(key);
+                if (existing) {
+                    if (existing.lines.some((entry) => entry.trim() !== "")) {
+                        pendingSeparator.add(key);
+                    }
+                }
+                else {
+                    sections.set(key, { title, lines: [] });
+                    order.push(key);
+                }
+                currentKey = key;
+                continue;
+            }
+        }
+        if (currentKey) {
+            const entry = sections.get(currentKey);
+            if (!entry)
+                continue;
+            if (pendingSeparator.has(currentKey) && line.trim() !== "") {
+                entry.lines.push("");
+                pendingSeparator.delete(currentKey);
+            }
+            entry.lines.push(line);
+        }
+    }
+    const out = [];
+    const seen = new Set(order);
+    for (const key of order) {
+        const section = sections.get(key);
+        if (!section)
+            continue;
+        out.push(`## ${section.title}`);
+        if (section.lines.length > 0) {
+            out.push(...section.lines);
+        }
+        else {
+            out.push("");
+        }
+        out.push("");
+    }
+    for (const requiredSection of required) {
+        const requiredKey = normalizeDocSectionName(requiredSection);
+        if (seen.has(requiredKey))
+            continue;
+        out.push(`## ${requiredSection}`, "", "");
+    }
+    return `${out.join("\n").trimEnd()}\n`;
+}
+export function ensureDocSections(doc, required) {
+    const trimmed = doc.trim();
+    if (!trimmed) {
+        const blocks = required.map((section) => `## ${section}\n`);
+        return `${blocks.join("\n").trimEnd()}\n`;
+    }
+    return normalizeDocSections(doc, required);
+}
+export function parseDocSections(doc) {
+    const lines = splitCombinedHeadingLines(doc);
+    const sections = new Map();
+    const order = [];
+    let currentKey = null;
+    for (const line of lines) {
+        const match = /^##\s+(.*)$/.exec(line.trim());
+        if (match) {
+            const title = match[1]?.trim() ?? "";
+            const key = normalizeDocSectionName(title);
+            if (key) {
+                if (!sections.has(key)) {
+                    sections.set(key, { title, lines: [] });
+                    order.push(key);
+                }
+                currentKey = key;
+                continue;
+            }
+        }
+        if (currentKey) {
+            const entry = sections.get(currentKey);
+            if (entry)
+                entry.lines.push(line);
+        }
+    }
+    return { sections, order };
+}

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

@@ -0,0 +1,9 @@
+export declare const TASK_ID_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+export declare function timestampIdPrefix(date: Date): string;
+export declare function generateTaskId(opts: {
+    length: number;
+    attempts: number;
+    isAvailable?: (taskId: string) => boolean | Promise<boolean>;
+    date?: Date;
+}): Promise<string>;
+//# sourceMappingURL=task-id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-id.d.ts","sourceRoot":"","sources":["../../src/tasks/task-id.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AAEnE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAOpD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB"}