@agentplaneorg/core 0.1.4 → 0.1.5

package/dist/task-store.js

@@ -1,359 +0,0 @@
-import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { loadConfig } from "./config.js";
-import { resolveProject } from "./project-root.js";
-import { parseTaskReadme, renderTaskReadme } from "./task-readme.js";
-function nowIso() {
-    return new Date().toISOString();
-}
-function isRecord(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
-}
-export function validateTaskDocMetadata(frontmatter) {
-    const errors = [];
-    if (frontmatter.doc_version !== 2)
-        errors.push("doc_version must be 2");
-    const updatedAt = frontmatter.doc_updated_at;
-    if (typeof updatedAt !== "string" || Number.isNaN(Date.parse(updatedAt))) {
-        errors.push("doc_updated_at must be an ISO timestamp");
-    }
-    const updatedBy = frontmatter.doc_updated_by;
-    if (typeof updatedBy !== "string" || updatedBy.trim().length === 0) {
-        errors.push("doc_updated_by must be a non-empty string");
-    }
-    return errors;
-}
-const ID_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
-function randomSuffix(length) {
-    let out = "";
-    for (let i = 0; i < length; i++) {
-        out += ID_ALPHABET[Math.floor(Math.random() * ID_ALPHABET.length)];
-    }
-    return out;
-}
-function timestampIdPrefix(date) {
-    const yyyy = String(date.getUTCFullYear()).padStart(4, "0");
-    const mm = String(date.getUTCMonth() + 1).padStart(2, "0");
-    const dd = String(date.getUTCDate()).padStart(2, "0");
-    const hh = String(date.getUTCHours()).padStart(2, "0");
-    const min = String(date.getUTCMinutes()).padStart(2, "0");
-    return `${yyyy}${mm}${dd}${hh}${min}`;
-}
-async function fileExists(filePath) {
-    try {
-        await readFile(filePath, "utf8");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function getTasksDir(opts) {
-    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
-    const loaded = await loadConfig(resolved.agentplaneDir);
-    const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
-    return {
-        gitRoot: resolved.gitRoot,
-        tasksDir,
-        idSuffixLengthDefault: loaded.config.tasks.id_suffix_length_default,
-    };
-}
-export function taskReadmePath(tasksDir, taskId) {
-    return path.join(tasksDir, taskId, "README.md");
-}
-function defaultTaskBody() {
-    return [
-        "## Summary",
-        "",
-        "",
-        "## Scope",
-        "",
-        "",
-        "## Risks",
-        "",
-        "",
-        "## Verify Steps",
-        "",
-        "",
-        "## Rollback Plan",
-        "",
-    ].join("\n");
-}
-function escapeRegExp(text) {
-    return text.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\\$&`);
-}
-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 normalizeDocSectionName(section) {
-    return section.trim().replaceAll(/\s+/g, " ").toLowerCase();
-}
-function getLastCommentAuthor(frontmatter) {
-    const comments = frontmatter.comments;
-    if (!Array.isArray(comments))
-        return null;
-    const entries = comments;
-    for (let i = entries.length - 1; i >= 0; i -= 1) {
-        const entry = entries[i];
-        if (!isRecord(entry))
-            continue;
-        const author = entry.author;
-        if (typeof author === "string") {
-            const trimmed = author.trim();
-            if (trimmed)
-                return trimmed;
-        }
-    }
-    return null;
-}
-function resolveDocUpdatedBy(frontmatter, updatedBy) {
-    if (updatedBy != null) {
-        const explicit = updatedBy.trim();
-        if (explicit.length === 0) {
-            throw new Error("doc_updated_by must be a non-empty string");
-        }
-        return explicit;
-    }
-    const lastAuthor = getLastCommentAuthor(frontmatter);
-    if (lastAuthor)
-        return lastAuthor;
-    const existing = frontmatter.doc_updated_by;
-    if (typeof existing === "string") {
-        const trimmed = existing.trim();
-        if (trimmed && trimmed.toLowerCase() !== "agentplane")
-            return trimmed;
-    }
-    const owner = frontmatter.owner;
-    if (typeof owner === "string") {
-        const trimmed = owner.trim();
-        if (trimmed)
-            return trimmed;
-    }
-    return "agentplane";
-}
-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 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`;
-}
-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 async function createTask(opts) {
-    const { tasksDir, idSuffixLengthDefault } = await getTasksDir({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride ?? null,
-    });
-    await mkdir(tasksDir, { recursive: true });
-    const suffixLength = idSuffixLengthDefault;
-    const base = timestampIdPrefix(new Date());
-    for (let attempt = 0; attempt < 20; attempt++) {
-        const id = `${base}-${randomSuffix(suffixLength)}`;
-        const readmePath = taskReadmePath(tasksDir, id);
-        if (await fileExists(readmePath))
-            continue;
-        const frontmatter = {
-            id,
-            title: opts.title,
-            status: "TODO",
-            priority: opts.priority,
-            owner: opts.owner,
-            depends_on: opts.dependsOn,
-            tags: opts.tags,
-            verify: opts.verify,
-            comments: [],
-            doc_version: 2,
-            doc_updated_at: nowIso(),
-            doc_updated_by: opts.owner,
-            description: opts.description,
-        };
-        const body = defaultTaskBody();
-        const text = renderTaskReadme(frontmatter, body);
-        await mkdir(path.dirname(readmePath), { recursive: true });
-        await writeFile(readmePath, text, "utf8");
-        return { id, readmePath };
-    }
-    throw new Error("Failed to generate a unique task id");
-}
-export async function setTaskDocSection(opts) {
-    const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
-    const loaded = await loadConfig(resolved.agentplaneDir);
-    const allowed = loaded.config.tasks.doc.sections;
-    if (!allowed.includes(opts.section)) {
-        throw new Error(`Unknown doc section: ${opts.section}`);
-    }
-    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");
-    return { readmePath };
-}
-export async function readTask(opts) {
-    const { tasksDir } = await getTasksDir({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride ?? null,
-    });
-    const readmePath = taskReadmePath(tasksDir, opts.taskId);
-    const text = await readFile(readmePath, "utf8");
-    const parsed = parseTaskReadme(text);
-    return {
-        id: opts.taskId,
-        frontmatter: parsed.frontmatter,
-        body: parsed.body,
-        readmePath,
-    };
-}
-export async function listTasks(opts) {
-    const { tasksDir } = await getTasksDir({
-        cwd: opts.cwd,
-        rootOverride: opts.rootOverride ?? null,
-    });
-    const entries = await readdir(tasksDir, { withFileTypes: true }).catch(() => []);
-    const ids = entries.filter((e) => e.isDirectory()).map((e) => e.name);
-    const tasks = [];
-    for (const id of ids) {
-        const readmePath = taskReadmePath(tasksDir, id);
-        try {
-            const text = await readFile(readmePath, "utf8");
-            const parsed = parseTaskReadme(text);
-            tasks.push({
-                id,
-                frontmatter: parsed.frontmatter,
-                body: parsed.body,
-                readmePath,
-            });
-        }
-        catch {
-            // Skip unreadable/broken tasks for now; lint will handle this later.
-        }
-    }
-    return tasks.toSorted((a, b) => a.id.localeCompare(b.id));
-}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"tasks-lint.d.ts","sourceRoot":"","sources":["../src/tasks-lint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AA2DF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,gBAAgB,GACvB,eAAe,CA4GjB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAOrF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,eAAe,CAAC,CAG3B"}