agentplane 0.1.4 → 0.1.6

package/dist/agents/agents-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-template.d.ts","sourceRoot":"","sources":["../../src/agents/agents-template.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElD,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAwC5D,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG1D;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAanE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CASvF"}

package/dist/{agents-template.js → agents/agents-template.js}

@@ -1,8 +1,8 @@
 import { readdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-const AGENTS_TEMPLATE_URL = new URL("../assets/AGENTS.md", import.meta.url);
-const AGENTS_DIR_URL = new URL("../assets/agents/", import.meta.url);
+const AGENTS_TEMPLATE_URL = new URL("../../assets/AGENTS.md", import.meta.url);
+const AGENTS_DIR_URL = new URL("../../assets/agents/", import.meta.url);
 const HEADING_RE = /^(#+)\s+(.*)$/;
 function ensureTrailingNewline(text) {
     return text.endsWith("\n") ? text : `${text}\n`;

package/dist/{task-backend.d.ts → backends/task-backend.d.ts}

@@ -1,6 +1,9 @@
 import { type AgentplaneConfig, type ResolvedProject, type TaskRecord } from "@agentplaneorg/core";
-export declare function extractTaskDoc(body: string): string;
-export declare function mergeTaskDoc(body: string, doc: string): string;
+type ExtractTaskDoc = (body: string) => string;
+type MergeTaskDoc = (body: string, doc: string) => string;
+declare const extractTaskDoc: ExtractTaskDoc;
+declare const mergeTaskDoc: MergeTaskDoc;
+export { extractTaskDoc, mergeTaskDoc };
 export type TaskData = {
     id: string;
     title: string;
@@ -171,5 +174,4 @@ export declare function loadTaskBackend(opts: {
     config: AgentplaneConfig;
     backendConfigPath: string;
 }>;
-export {};
 //# sourceMappingURL=task-backend.d.ts.map

package/dist/backends/task-backend.d.ts.map

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

package/dist/{task-backend.js → backends/task-backend.js}

@@ -1,15 +1,16 @@
-import { createHash, randomInt } from "node:crypto";
-import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { mkdir, readdir, readFile, stat } from "node:fs/promises";
 import path from "node:path";
-import { canonicalizeJson, loadConfig, parseTaskReadme, renderTaskReadme, resolveProject, taskReadmePath, } from "@agentplaneorg/core";
-import { loadDotEnv } from "./env.js";
-const ID_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-const TASK_ID_RE = new RegExp(String.raw `^\d{12}-[${ID_ALPHABET}]{4,}$`);
-const DOC_SECTION_HEADER = "## Summary";
-const DOC_SECTION_HEADER_RE = /^##\s+Summary(?:\s|$|#)/;
-const AUTO_SUMMARY_HEADER = "## Changes Summary (auto)";
+import { atomicWriteFile as atomicWriteFileCore, canonicalizeJson, docChanged, extractTaskDoc as extractTaskDocCore, generateTaskId as generateTaskIdCore, loadConfig, mergeTaskDoc as mergeTaskDocCore, parseTaskReadme, renderTaskReadme, resolveProject, TASK_ID_ALPHABET, taskReadmePath, } from "@agentplaneorg/core";
+import { loadDotEnv } from "../shared/env.js";
+import { buildTaskIndexEntry, loadTaskIndex, resolveTaskIndexPath, saveTaskIndex, } from "./task-index.js";
+const TASK_ID_RE = new RegExp(String.raw `^\d{12}-[${TASK_ID_ALPHABET}]{4,}$`);
 const DEFAULT_DOC_UPDATED_BY = "agentplane";
 const DOC_VERSION = 2;
+const atomicWriteFile = atomicWriteFileCore;
+const extractTaskDoc = extractTaskDocCore;
+const mergeTaskDoc = mergeTaskDocCore;
+const generateTaskId = generateTaskIdCore;
 function nowIso() {
     return new Date().toISOString();
 }
@@ -35,145 +36,6 @@ function firstNonEmptyString(...values) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function normalizeDoc(text) {
-    return (text ?? "")
-        .split("\n")
-        .map((line) => line.replaceAll(/\s+$/gu, ""))
-        .join("\n")
-        .trim();
-}
-function normalizeDocSectionName(section) {
-    return section.trim().replaceAll(/\s+/g, " ").toLowerCase();
-}
-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;
-}
-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 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();
-}
-function docChanged(existing, updated) {
-    return normalizeDoc(existing) !== normalizeDoc(updated);
-}
 function normalizeUpdatedBy(value) {
     if (typeof value !== "string")
         return "";
@@ -243,67 +105,7 @@ function resolveDocUpdatedByFromTask(task, fallback) {
     const fallbackValue = normalizeUpdatedBy(fallback);
     return fallbackValue || fallback;
 }
-function isDocSectionHeader(line) {
-    return DOC_SECTION_HEADER_RE.test(line.trim());
-}
-export function extractTaskDoc(body) {
-    if (!body)
-        return "";
-    const lines = body.split("\n");
-    let startIdx = null;
-    for (const [idx, line] of lines.entries()) {
-        if (isDocSectionHeader(line)) {
-            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++) {
-        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 (isDocSectionHeader(line)) {
-                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 { extractTaskDoc, mergeTaskDoc };
 function validateTaskId(taskId) {
     if (TASK_ID_RE.test(taskId))
         return;
@@ -341,6 +143,14 @@ function toStringArray(value) {
         return [];
     return value.filter((v) => typeof v === "string");
 }
+function normalizeDependsOn(value) {
+    if (Array.isArray(value)) {
+        return value.filter((v) => typeof v === "string" && v.trim() !== "[]");
+    }
+    if (typeof value === "string" && value.trim() === "[]")
+        return [];
+    return [];
+}
 function normalizePriority(value) {
     const raw = toStringSafe(value).trim().toLowerCase();
     if (!raw)
@@ -378,7 +188,7 @@ export function taskRecordToData(record) {
         status: typeof fm.status === "string" ? fm.status : "TODO",
         priority: typeof fm.priority === "string" || typeof fm.priority === "number" ? fm.priority : "",
         owner: typeof fm.owner === "string" ? fm.owner : "",
-        depends_on: toStringArray(fm.depends_on),
+        depends_on: normalizeDependsOn(fm.depends_on),
         tags: toStringArray(fm.tags),
         verify: toStringArray(fm.verify),
         commit,
@@ -435,7 +245,7 @@ export function buildTasksExportSnapshotFromTasks(tasks) {
 export async function writeTasksExportFromTasks(opts) {
     const snapshot = buildTasksExportSnapshotFromTasks(opts.tasks);
     await mkdir(path.dirname(opts.outputPath), { recursive: true });
-    await writeFile(opts.outputPath, `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
+    await atomicWriteFile(opts.outputPath, `${JSON.stringify(snapshot, null, 2)}\n`);
 }
 export class LocalBackend {
     id = "local";
@@ -450,40 +260,64 @@ export class LocalBackend {
         if (length < 4)
             throw new Error(invalidLengthMessage(length, 4));
         const attempts = Math.max(1, opts.attempts);
-        for (let i = 0; i < attempts; i++) {
-            const now = new Date();
-            const yyyy = String(now.getUTCFullYear()).padStart(4, "0");
-            const mm = String(now.getUTCMonth() + 1).padStart(2, "0");
-            const dd = String(now.getUTCDate()).padStart(2, "0");
-            const hh = String(now.getUTCHours()).padStart(2, "0");
-            const min = String(now.getUTCMinutes()).padStart(2, "0");
-            let suffix = "";
-            for (let j = 0; j < length; j++) {
-                suffix += ID_ALPHABET[randomInt(0, ID_ALPHABET.length)];
-            }
-            const taskId = `${yyyy}${mm}${dd}${hh}${min}-${suffix}`;
-            const readmePath = taskReadmePath(this.root, taskId);
-            try {
-                await readFile(readmePath, "utf8");
-                continue;
-            }
-            catch (err) {
-                const code = err?.code;
-                if (code === "ENOENT")
-                    return taskId;
-                throw err;
-            }
-        }
-        throw new Error("Failed to generate a unique task id (exhausted attempts)");
+        return await generateTaskId({
+            length,
+            attempts,
+            isAvailable: async (taskId) => {
+                const readmePath = taskReadmePath(this.root, taskId);
+                try {
+                    await readFile(readmePath, "utf8");
+                    return false;
+                }
+                catch (err) {
+                    const code = err?.code;
+                    if (code === "ENOENT")
+                        return true;
+                    throw err;
+                }
+            },
+        });
     }
     async listTasks() {
         const tasks = [];
         const entries = await readdir(this.root, { withFileTypes: true }).catch(() => []);
+        const indexPath = resolveTaskIndexPath(this.root);
+        const cachedIndex = await loadTaskIndex(indexPath);
+        const cachedByPath = new Map();
+        if (cachedIndex) {
+            for (const entry of cachedIndex.tasks) {
+                cachedByPath.set(entry.readmePath, entry);
+            }
+        }
+        const nextIndex = [];
         const seen = new Set();
         for (const entry of entries) {
             if (!entry.isDirectory())
                 continue;
             const readme = path.join(this.root, entry.name, "README.md");
+            let stats;
+            try {
+                stats = await stat(readme);
+            }
+            catch {
+                continue;
+            }
+            if (!stats.isFile())
+                continue;
+            const cached = cachedByPath.get(readme);
+            if (cached?.mtimeMs === stats.mtimeMs) {
+                const taskId = cached.task.id.trim();
+                if (taskId) {
+                    validateTaskId(taskId);
+                    if (seen.has(taskId)) {
+                        throw new Error(`Duplicate task id in local backend: ${taskId}`);
+                    }
+                    seen.add(taskId);
+                }
+                tasks.push(cached.task);
+                nextIndex.push(cached);
+                continue;
+            }
             let text = "";
             try {
                 text = await readFile(readme, "utf8");
@@ -516,6 +350,13 @@ export class LocalBackend {
                 readmePath: readme,
             });
             tasks.push(task);
+            nextIndex.push(buildTaskIndexEntry(task, readme, stats.mtimeMs));
+        }
+        try {
+            await saveTaskIndex(indexPath, { schema_version: 1, tasks: nextIndex });
+        }
+        catch {
+            // Best-effort cache; ignore failures.
         }
         return tasks;
     }
@@ -598,7 +439,7 @@ export class LocalBackend {
         }
         await mkdir(path.dirname(readme), { recursive: true });
         const text = renderTaskReadme(payload, body || "");
-        await writeFile(readme, text.endsWith("\n") ? text : `${text}\n`, "utf8");
+        await atomicWriteFile(readme, text.endsWith("\n") ? text : `${text}\n`);
     }
     async setTaskDoc(taskId, doc, updatedBy) {
         const readme = taskReadmePath(this.root, taskId);
@@ -616,7 +457,7 @@ export class LocalBackend {
             frontmatter.doc_version = DOC_VERSION;
         }
         const next = renderTaskReadme(frontmatter, body);
-        await writeFile(readme, next.endsWith("\n") ? next : `${next}\n`, "utf8");
+        await atomicWriteFile(readme, next.endsWith("\n") ? next : `${next}\n`);
     }
     async touchTaskDocMetadata(taskId, updatedBy) {
         const readme = taskReadmePath(this.root, taskId);
@@ -627,7 +468,7 @@ export class LocalBackend {
         frontmatter.doc_updated_at = nowIso();
         frontmatter.doc_updated_by = resolveDocUpdatedByFromFrontmatter(frontmatter, updatedBy, this.updatedBy);
         const next = renderTaskReadme(frontmatter, parsed.body || "");
-        await writeFile(readme, next.endsWith("\n") ? next : `${next}\n`, "utf8");
+        await atomicWriteFile(readme, next.endsWith("\n") ? next : `${next}\n`);
     }
     async writeTasks(tasks) {
         for (const task of tasks) {
@@ -654,11 +495,11 @@ export class RedmineBackend {
     issueCache = new Map();
     reverseStatus = new Map();
     constructor(settings, opts) {
-        const envUrl = firstNonEmptyString(process.env.CODEXSWARM_REDMINE_URL);
-        const envApiKey = firstNonEmptyString(process.env.CODEXSWARM_REDMINE_API_KEY);
-        const envProjectId = firstNonEmptyString(process.env.CODEXSWARM_REDMINE_PROJECT_ID);
-        const envAssignee = (process.env.CODEXSWARM_REDMINE_ASSIGNEE_ID ?? "").trim();
-        const envOwner = firstNonEmptyString(process.env.CODEXSWARM_REDMINE_OWNER, process.env.CODEXSWARM_REDMINE_OWNER_AGENT);
+        const envUrl = firstNonEmptyString(process.env.AGENTPLANE_REDMINE_URL);
+        const envApiKey = firstNonEmptyString(process.env.AGENTPLANE_REDMINE_API_KEY);
+        const envProjectId = firstNonEmptyString(process.env.AGENTPLANE_REDMINE_PROJECT_ID);
+        const envAssignee = (process.env.AGENTPLANE_REDMINE_ASSIGNEE_ID ?? "").trim();
+        const envOwner = firstNonEmptyString(process.env.AGENTPLANE_REDMINE_OWNER, process.env.AGENTPLANE_REDMINE_OWNER_AGENT);
         this.baseUrl = firstNonEmptyString(envUrl, settings.url).replaceAll(/\/+$/gu, "");
         this.apiKey = firstNonEmptyString(envApiKey, settings.api_key);
         this.projectId = firstNonEmptyString(envProjectId, settings.project_id);
@@ -696,7 +537,11 @@ export class RedmineBackend {
             const cached = await this.cache.listTasks();
             existingIds = new Set(cached.map((task) => toStringSafe(task.id)).filter(Boolean));
         }
-        return generateTaskId(existingIds, length, attempts);
+        return await generateTaskId({
+            length,
+            attempts,
+            isAvailable: (taskId) => !existingIds.has(taskId),
+        });
     }
     async listTasks() {
         try {
@@ -1388,26 +1233,6 @@ export class RedmineBackend {
         throw lastError instanceof Error ? lastError : new RedmineUnavailable("Redmine unavailable");
     }
 }
-function generateTaskId(existingIds, length, attempts) {
-    if (length < 4)
-        throw new Error(invalidLengthMessage(length, 4));
-    for (let i = 0; i < attempts; i++) {
-        const now = new Date();
-        const yyyy = String(now.getUTCFullYear()).padStart(4, "0");
-        const mm = String(now.getUTCMonth() + 1).padStart(2, "0");
-        const dd = String(now.getUTCDate()).padStart(2, "0");
-        const hh = String(now.getUTCHours()).padStart(2, "0");
-        const min = String(now.getUTCMinutes()).padStart(2, "0");
-        let suffix = "";
-        for (let j = 0; j < length; j++) {
-            suffix += ID_ALPHABET[randomInt(0, ID_ALPHABET.length)];
-        }
-        const candidate = `${yyyy}${mm}${dd}${hh}${min}-${suffix}`;
-        if (!existingIds.has(candidate))
-            return candidate;
-    }
-    throw new Error("Failed to generate a unique task id (exhausted attempts)");
-}
 async function loadBackendConfig(configPath) {
     try {
         const raw = JSON.parse(await readFile(configPath, "utf8"));
@@ -1428,14 +1253,23 @@ function resolveMaybeRelative(root, input) {
         return null;
     return path.isAbsolute(raw) ? raw : path.join(root, raw);
 }
+function normalizeBackendConfig(raw) {
+    if (!isRecord(raw)) {
+        return { id: "local", version: 1, settings: {} };
+    }
+    const id = toStringSafe(raw.id).trim() || "local";
+    const version = typeof raw.version === "number" ? raw.version : 1;
+    const settings = isRecord(raw.settings) ? raw.settings : {};
+    return { id, version, settings };
+}
 export async function loadTaskBackend(opts) {
     const resolved = await resolveProject({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
     const loaded = await loadConfig(resolved.agentplaneDir);
     const backendConfigPath = path.join(resolved.gitRoot, loaded.config.tasks_backend.config_path);
     const backendConfig = await loadBackendConfig(backendConfigPath);
-    const backendIdRaw = toStringSafe(backendConfig?.id).trim();
-    const backendId = backendIdRaw.length > 0 ? backendIdRaw : "local";
-    const settings = isRecord(backendConfig?.settings) ? backendConfig?.settings : {};
+    const normalized = normalizeBackendConfig(backendConfig);
+    const backendId = normalized.id;
+    const settings = normalized.settings;
     if (backendId === "redmine") {
         await loadDotEnv(resolved.gitRoot);
         const cacheDirRaw = resolveMaybeRelative(resolved.gitRoot, settings.cache_dir);

package/dist/backends/task-index.d.ts

@@ -0,0 +1,16 @@
+import type { TaskData } from "./task-backend.js";
+export declare const TASK_INDEX_SCHEMA_VERSION = 1;
+export type TaskIndexEntry = {
+    task: TaskData;
+    readmePath: string;
+    mtimeMs: number;
+};
+export type TaskIndexFile = {
+    schema_version: 1;
+    tasks: TaskIndexEntry[];
+};
+export declare function resolveTaskIndexPath(tasksDir: string): string;
+export declare function loadTaskIndex(indexPath: string): Promise<TaskIndexFile | null>;
+export declare function saveTaskIndex(indexPath: string, index: TaskIndexFile): Promise<void>;
+export declare function buildTaskIndexEntry(task: TaskData, readmePath: string, mtimeMs: number): TaskIndexEntry;
+//# sourceMappingURL=task-index.d.ts.map

package/dist/backends/task-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-index.d.ts","sourceRoot":"","sources":["../../src/backends/task-index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAG3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU7D;AAuBD,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAkBpF;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,cAAc,CAMhB"}

package/dist/backends/task-index.js

@@ -0,0 +1,84 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+export const TASK_INDEX_SCHEMA_VERSION = 1;
+const TASK_INDEX_FILENAME = "tasks-index.v1.json";
+export function resolveTaskIndexPath(tasksDir) {
+    const normalized = path.normalize(tasksDir);
+    const parts = normalized.split(path.sep);
+    const tail = parts.slice(-2).join(path.sep);
+    if (tail === path.join(".agentplane", "tasks")) {
+        const cacheDir = path.join(path.dirname(tasksDir), "cache");
+        return path.join(cacheDir, TASK_INDEX_FILENAME);
+    }
+    const cacheDir = path.join(tasksDir, ".cache");
+    return path.join(cacheDir, TASK_INDEX_FILENAME);
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isTaskIndexEntry(value) {
+    if (!isRecord(value))
+        return false;
+    if (!isRecord(value.task))
+        return false;
+    if (typeof value.readmePath !== "string")
+        return false;
+    if (typeof value.mtimeMs !== "number")
+        return false;
+    const task = value.task;
+    if (typeof task.id !== "string")
+        return false;
+    if (typeof task.title !== "string")
+        return false;
+    if (typeof task.description !== "string")
+        return false;
+    if (typeof task.status !== "string")
+        return false;
+    if (typeof task.owner !== "string")
+        return false;
+    if (!Array.isArray(task.depends_on))
+        return false;
+    if (!Array.isArray(task.tags))
+        return false;
+    if (!Array.isArray(task.verify))
+        return false;
+    return true;
+}
+export async function loadTaskIndex(indexPath) {
+    let raw = "";
+    try {
+        raw = await readFile(indexPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(parsed))
+        return null;
+    if (parsed.schema_version !== TASK_INDEX_SCHEMA_VERSION)
+        return null;
+    if (!Array.isArray(parsed.tasks))
+        return null;
+    const tasks = parsed.tasks.filter((entry) => isTaskIndexEntry(entry));
+    return { schema_version: TASK_INDEX_SCHEMA_VERSION, tasks };
+}
+export async function saveTaskIndex(indexPath, index) {
+    const dir = path.dirname(indexPath);
+    await mkdir(dir, { recursive: true });
+    const tmpPath = `${indexPath}.tmp-${process.pid}`;
+    await writeFile(tmpPath, `${JSON.stringify(index, null, 2)}\n`, "utf8");
+    await rename(tmpPath, indexPath);
+}
+export function buildTaskIndexEntry(task, readmePath, mtimeMs) {
+    return {
+        task,
+        readmePath,
+        mtimeMs,
+    };
+}

package/dist/cli/archive.d.ts

@@ -0,0 +1,16 @@
+type ArchiveType = "tar" | "zip";
+export type ArchiveEntryIssue = {
+    entry: string;
+    reason: string;
+};
+export declare function validateArchive(archivePath: string, type: ArchiveType): Promise<ArchiveEntryIssue[]>;
+export declare function detectArchiveType(filePath: string): ArchiveType | null;
+export declare function extractArchive(opts: {
+    archivePath: string;
+    destDir: string;
+    usage: string;
+    example?: string;
+}): Promise<void>;
+export declare function validateArchiveEntries(entries: string[], symlinks: string[]): ArchiveEntryIssue[];
+export {};
+//# sourceMappingURL=archive.d.ts.map

package/dist/cli/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/cli/archive.ts"],"names":[],"mappings":"AAYA,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AAOjC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAU9B;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAKtE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CA2BjG"}