agentplane 0.3.7 → 0.3.8

package/dist/backends/task-backend/shared/constants.d.ts

@@ -1,5 +1,6 @@
+import { type TaskDocVersion } from "@agentplaneorg/core";
 export declare const TASK_ID_RE: RegExp;
 export declare const DEFAULT_DOC_UPDATED_BY = "agentplane";
-export declare const DOC_VERSION = 3;
+export declare const DOC_VERSION: TaskDocVersion;
 export declare const SUPPORTED_DOC_VERSIONS: readonly [2, 3];
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,QAA6D,CAAC;AACrF,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,sBAAsB,iBAAkB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,UAAU,QAA6D,CAAC;AACrF,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,WAAW,EAAE,cAAkB,CAAC;AAC7C,eAAO,MAAM,sBAAsB,iBAAkB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/doc.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAC/C,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAE1D,QAAA,MAAM,cAAc,EAAE,cAAmC,CAAC;AAC1D,QAAA,MAAM,YAAY,EAAE,YAA+B,CAAC;AAEpD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAyBD,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAaR;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASpF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,CAAC,GAAG,CAAe,GAAG,CAAC,GAAG,CAAC,CAExF;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,EACjE,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAUN;AAED,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/doc.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAC/C,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAG1D,QAAA,MAAM,cAAc,EAAE,cAAmC,CAAC;AAC1D,QAAA,MAAM,YAAY,EAAE,YAA+B,CAAC;AAGpD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAmBD,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAaR;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,CAAC,GAAG,CAAe,GAAG,CAAC,GAAG,CAAC,CAExF;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,EACjE,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAUN;AAED,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}

package/dist/backends/task-backend/shared/doc.js

@@ -1,8 +1,9 @@
-import { extractTaskDoc as extractTaskDocCore, mergeTaskDoc as mergeTaskDocCore, } from "@agentplaneorg/core";
+import { extractTaskDoc as extractTaskDocCore, mergeTaskDoc as mergeTaskDocCore, normalizeTaskDocVersion as normalizeTaskDocVersionCore, resolveTaskDocUpdatedBy, } from "@agentplaneorg/core";
 import { isRecord } from "../../../shared/guards.js";
 import { DEFAULT_DOC_UPDATED_BY, DOC_VERSION } from "./constants.js";
 const extractTaskDoc = extractTaskDocCore;
 const mergeTaskDoc = mergeTaskDocCore;
+const normalizeTaskDocVersion = normalizeTaskDocVersionCore;
 export function nowIso() {
     return new Date().toISOString();
 }
@@ -16,56 +17,41 @@ function normalizeUpdatedBy(value) {
         return "";
     return trimmed;
 }
-function lastCommentAuthor(comments) {
+function toTaskDocMutationComments(comments) {
     if (!Array.isArray(comments))
         return null;
     const entries = comments;
-    for (let i = entries.length - 1; i >= 0; i -= 1) {
-        const entry = entries[i];
+    return entries.flatMap((entry) => {
         if (!isRecord(entry))
-            continue;
-        const author = entry.author;
-        if (typeof author === "string") {
-            const trimmed = author.trim();
-            if (trimmed)
-                return trimmed;
-        }
-    }
-    return null;
+            return [];
+        return [{ author: typeof entry.author === "string" ? entry.author : undefined }];
+    });
 }
 export function resolveDocUpdatedByFromFrontmatter(frontmatter, updatedBy, fallback) {
-    if (updatedBy !== undefined) {
-        const explicit = normalizeUpdatedBy(updatedBy);
-        if (explicit)
-            return explicit;
-    }
-    const author = lastCommentAuthor(frontmatter.comments);
-    if (author)
-        return author;
-    const existing = normalizeUpdatedBy(frontmatter.doc_updated_by);
-    if (existing)
-        return existing;
-    const owner = normalizeUpdatedBy(frontmatter.owner);
-    if (owner)
-        return owner;
+    const explicit = updatedBy === undefined ? undefined : normalizeUpdatedBy(updatedBy);
+    const resolved = resolveTaskDocUpdatedBy({
+        comments: toTaskDocMutationComments(frontmatter.comments),
+        doc_updated_by: frontmatter.doc_updated_by,
+        owner: frontmatter.owner,
+    }, explicit ?? null);
+    if (resolved.toLowerCase() !== DEFAULT_DOC_UPDATED_BY.toLowerCase())
+        return resolved;
     const fallbackValue = normalizeUpdatedBy(fallback);
-    return fallbackValue || fallback;
+    return fallbackValue.length > 0 ? fallbackValue : fallback;
 }
 export function resolveDocUpdatedByFromTask(task, fallback) {
-    const author = lastCommentAuthor(task.comments);
-    if (author)
-        return author;
-    const existing = normalizeUpdatedBy(task.doc_updated_by);
-    if (existing)
-        return existing;
-    const owner = normalizeUpdatedBy(task.owner);
-    if (owner)
-        return owner;
+    const resolved = resolveTaskDocUpdatedBy({
+        comments: toTaskDocMutationComments(task.comments),
+        doc_updated_by: task.doc_updated_by,
+        owner: task.owner,
+    }, null);
+    if (resolved.toLowerCase() !== DEFAULT_DOC_UPDATED_BY.toLowerCase())
+        return resolved;
     const fallbackValue = normalizeUpdatedBy(fallback);
-    return fallbackValue || fallback;
+    return fallbackValue.length > 0 ? fallbackValue : fallback;
 }
 export function normalizeDocVersion(value, fallback = DOC_VERSION) {
-    return value === 3 ? 3 : value === 2 ? 2 : fallback;
+    return normalizeTaskDocVersion(value, fallback);
 }
 export function ensureDocMetadata(task, updatedBy) {
     task.doc_version = normalizeDocVersion(task.doc_version);

package/dist/backends/task-backend/shared/export.d.ts

@@ -1,13 +1,6 @@
+import { type TasksExportSnapshot } from "@agentplaneorg/core";
 import type { TaskData } from "./types.js";
-export declare function buildTasksExportSnapshotFromTasks(tasks: TaskData[]): {
-    tasks: TaskData[];
-    meta: {
-        schema_version: 1;
-        managed_by: string;
-        checksum_algo: "sha256";
-        checksum: string;
-    };
-};
+export declare function buildTasksExportSnapshotFromTasks(tasks: TaskData[]): TasksExportSnapshot;
 export declare function writeTasksExportFromTasks(opts: {
     outputPath: string;
     tasks: TaskData[];

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

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/export.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,YAAY,CAAC;AA0CtD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG;IACpE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,IAAI,EAAE;QAAE,cAAc,EAAE,CAAC,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5F,CAcA;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhB"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/export.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,YAAY,CAAC;AAoHtD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAcxF;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhB"}

package/dist/backends/task-backend/shared/export.js

@@ -1,29 +1,94 @@
 import { createHash } from "node:crypto";
 import { mkdir } from "node:fs/promises";
 import path from "node:path";
-import { canonicalizeJson } from "@agentplaneorg/core";
+import { canonicalizeJson, validateTasksExportSnapshot, } from "@agentplaneorg/core";
 import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
 import { DEFAULT_DOC_UPDATED_BY } from "./constants.js";
 import { normalizeDocVersion, resolveDocUpdatedByFromTask } from "./doc.js";
+import { normalizeTaskOrigin, normalizeTaskRunnerOutcome } from "./normalize.js";
 import { toStringArray } from "./strings.js";
+const DEFAULT_EXPORT_DOC_UPDATED_AT = "1970-01-01T00:00:00.000Z";
+const DEFAULT_EXPORT_TITLE = "(untitled task)";
+const DEFAULT_EXPORT_OWNER = "UNKNOWN";
+function normalizeExportTitle(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : DEFAULT_EXPORT_TITLE;
+}
+function normalizeExportStatus(value) {
+    if (typeof value === "string") {
+        const normalized = value.trim().toUpperCase();
+        if (normalized === "TODO" ||
+            normalized === "DOING" ||
+            normalized === "DONE" ||
+            normalized === "BLOCKED") {
+            return normalized;
+        }
+    }
+    return "TODO";
+}
+function normalizeExportOwner(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : DEFAULT_EXPORT_OWNER;
+}
+function normalizeExportPriority(value) {
+    if (value === "low" || value === "normal" || value === "med" || value === "high")
+        return value;
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "medium")
+            return "med";
+        if (normalized === "low" ||
+            normalized === "normal" ||
+            normalized === "med" ||
+            normalized === "high") {
+            return normalized;
+        }
+    }
+    return "med";
+}
+function normalizeExportDocUpdatedAt(value) {
+    return typeof value === "string" && !Number.isNaN(Date.parse(value))
+        ? value
+        : DEFAULT_EXPORT_DOC_UPDATED_AT;
+}
 function taskDataToExport(task) {
     const base = {
         ...task,
         id: task.id,
-        title: task.title ?? "",
+        title: normalizeExportTitle(task.title),
         description: task.description ?? "",
-        status: task.status ?? "",
-        priority: typeof task.priority === "number" ? String(task.priority) : (task.priority ?? ""),
-        owner: task.owner ?? "",
+        status: normalizeExportStatus(task.status),
+        priority: normalizeExportPriority(task.priority),
+        owner: normalizeExportOwner(task.owner),
+        result_summary: typeof task.result_summary === "string" ? task.result_summary : undefined,
+        risk_level: task.risk_level === "low" || task.risk_level === "med" || task.risk_level === "high"
+            ? task.risk_level
+            : undefined,
+        breaking: typeof task.breaking === "boolean" ? task.breaking : undefined,
+        revision: typeof task.revision === "number" && Number.isInteger(task.revision) && task.revision > 0
+            ? task.revision
+            : undefined,
+        origin: normalizeTaskOrigin(task.origin) ?? undefined,
+        runner: normalizeTaskRunnerOutcome(task.runner) ?? undefined,
         depends_on: toStringArray(task.depends_on),
         tags: toStringArray(task.tags),
         verify: toStringArray(task.verify),
+        plan_approval: task.plan_approval ?? {
+            state: "pending",
+            updated_at: null,
+            updated_by: null,
+            note: null,
+        },
+        verification: task.verification ?? {
+            state: "pending",
+            updated_at: null,
+            updated_by: null,
+            note: null,
+        },
         commit: task.commit ?? null,
         comments: Array.isArray(task.comments)
             ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
             : [],
         doc_version: normalizeDocVersion(task.doc_version),
-        doc_updated_at: task.doc_updated_at ?? "",
+        doc_updated_at: normalizeExportDocUpdatedAt(task.doc_updated_at),
         doc_updated_by: resolveDocUpdatedByFromTask(task, DEFAULT_DOC_UPDATED_BY),
         dirty: Boolean(task.dirty),
         id_source: task.id_source ?? "generated",
@@ -43,7 +108,7 @@ export function buildTasksExportSnapshotFromTasks(tasks) {
     const sorted = exportTasks.toSorted((a, b) => a.id.localeCompare(b.id));
     const canonical = JSON.stringify(canonicalizeJson({ tasks: sorted }));
     const checksum = createHash("sha256").update(canonical, "utf8").digest("hex");
-    return {
+    return validateTasksExportSnapshot({
         tasks: sorted,
         meta: {
             schema_version: 1,
@@ -51,7 +116,7 @@ export function buildTasksExportSnapshotFromTasks(tasks) {
             checksum_algo: "sha256",
             checksum,
         },
-    };
+    });
 }
 export async function writeTasksExportFromTasks(opts) {
     const snapshot = buildTasksExportSnapshotFromTasks(opts.tasks);

package/dist/backends/task-backend/shared/normalize.d.ts

@@ -1,8 +1,12 @@
-import type { PlanApproval, VerificationResult } from "./types.js";
+import type { PlanApproval, TaskData, TaskOrigin, TaskSummary, TaskRunnerOutcome, VerificationResult } from "./types.js";
 export declare function normalizeDependsOn(value: unknown): string[];
 export declare function normalizePriority(value: unknown): string;
 export declare function defaultPlanApproval(): PlanApproval;
 export declare function defaultVerificationResult(): VerificationResult;
+export declare function normalizeTaskOrigin(value: unknown): TaskOrigin | null;
 export declare function normalizePlanApproval(value: unknown): PlanApproval | null;
 export declare function normalizeVerificationResult(value: unknown): VerificationResult | null;
+export declare function normalizeTaskRunnerOutcome(value: unknown): TaskRunnerOutcome | null;
+export declare function toTaskSummary(task: TaskData): TaskSummary;
+export declare function toTaskSummaries(tasks: TaskData[]): TaskSummary[];
 //# sourceMappingURL=normalize.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/normalize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAM3D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASxD;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,CAE9D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAUzE;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAUrF"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/normalize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,WAAW,EAIX,iBAAiB,EAEjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAGpB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAM3D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASxD;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAcrE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAUzE;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAUrF;AA+HD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAYnF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAMzD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAEhE"}

package/dist/backends/task-backend/shared/normalize.js

@@ -30,6 +30,26 @@ export function defaultPlanApproval() {
 export function defaultVerificationResult() {
     return { state: "pending", updated_at: null, updated_by: null, note: null };
 }
+export function normalizeTaskOrigin(value) {
+    if (!isRecord(value))
+        return null;
+    const system = typeof value.system === "string" ? value.system.trim() : "";
+    if (!system)
+        return null;
+    const origin = { system };
+    for (const [key, raw] of Object.entries(value)) {
+        if (key === "system")
+            continue;
+        if (typeof raw !== "string")
+            continue;
+        const normalizedKey = key.trim();
+        const normalizedValue = raw.trim();
+        if (!normalizedKey || !normalizedValue)
+            continue;
+        origin[normalizedKey] = normalizedValue;
+    }
+    return origin;
+}
 export function normalizePlanApproval(value) {
     if (!isRecord(value))
         return null;
@@ -52,3 +72,149 @@ export function normalizeVerificationResult(value) {
     const note = value.note === null || typeof value.note === "string" ? value.note : null;
     return { state, updated_at: updatedAt, updated_by: updatedBy, note };
 }
+function normalizeTaskRunnerTarget(value) {
+    if (!isRecord(value))
+        return null;
+    const kind = typeof value.kind === "string" ? value.kind.trim() : "";
+    if (kind !== "task" && kind !== "recipe_scenario")
+        return null;
+    const target = { kind };
+    if (typeof value.task_id === "string" && value.task_id.trim()) {
+        target.task_id = value.task_id.trim();
+    }
+    if (typeof value.recipe_id === "string" && value.recipe_id.trim()) {
+        target.recipe_id = value.recipe_id.trim();
+    }
+    if (typeof value.scenario_id === "string" && value.scenario_id.trim()) {
+        target.scenario_id = value.scenario_id.trim();
+    }
+    return target;
+}
+function normalizeTaskRunnerMetrics(value) {
+    if (!isRecord(value))
+        return null;
+    const metrics = {};
+    if (typeof value.duration_ms === "number" && Number.isFinite(value.duration_ms)) {
+        metrics.duration_ms = value.duration_ms;
+    }
+    if (typeof value.stdout_bytes === "number" && Number.isFinite(value.stdout_bytes)) {
+        metrics.stdout_bytes = value.stdout_bytes;
+    }
+    if (typeof value.stderr_bytes === "number" && Number.isFinite(value.stderr_bytes)) {
+        metrics.stderr_bytes = value.stderr_bytes;
+    }
+    if (value.output_last_message_bytes === null ||
+        (typeof value.output_last_message_bytes === "number" &&
+            Number.isFinite(value.output_last_message_bytes))) {
+        metrics.output_last_message_bytes = value.output_last_message_bytes;
+    }
+    return Object.keys(metrics).length > 0 ? metrics : null;
+}
+function normalizeStringArray(value) {
+    if (!Array.isArray(value))
+        return null;
+    const entries = value
+        .filter((item) => typeof item === "string" && item.trim().length > 0)
+        .map((item) => item.trim());
+    return entries.length > 0 ? entries : null;
+}
+function normalizeTaskRunnerEvidence(value) {
+    if (!isRecord(value))
+        return null;
+    const evidence = {};
+    const evidencePaths = normalizeStringArray(value.evidence_paths);
+    if (evidencePaths)
+        evidence.evidence_paths = evidencePaths;
+    const changedPaths = normalizeStringArray(value.changed_paths);
+    if (changedPaths)
+        evidence.changed_paths = changedPaths;
+    const testsRun = normalizeStringArray(value.tests_run);
+    if (testsRun)
+        evidence.tests_run = testsRun;
+    const verificationCandidates = normalizeStringArray(value.verification_candidates);
+    if (verificationCandidates)
+        evidence.verification_candidates = verificationCandidates;
+    if (typeof value.files_changed_count === "number" &&
+        Number.isInteger(value.files_changed_count) &&
+        value.files_changed_count >= 0) {
+        evidence.files_changed_count = value.files_changed_count;
+    }
+    return Object.keys(evidence).length > 0 ? evidence : null;
+}
+function normalizeTaskRunnerHistoryEntry(value) {
+    if (!isRecord(value))
+        return null;
+    const runId = typeof value.run_id === "string" ? value.run_id.trim() : "";
+    const status = typeof value.status === "string" ? value.status.trim() : "";
+    const adapterId = typeof value.adapter_id === "string" ? value.adapter_id.trim() : "";
+    const mode = value.mode === "execute" || value.mode === "dry_run" ? value.mode : null;
+    const updatedAt = typeof value.updated_at === "string" ? value.updated_at.trim() : "";
+    const target = normalizeTaskRunnerTarget(value.target);
+    if (!runId || !adapterId || !updatedAt || !target || !mode)
+        return null;
+    if (status !== "prepared" &&
+        status !== "running" &&
+        status !== "success" &&
+        status !== "failed" &&
+        status !== "cancelled") {
+        return null;
+    }
+    const outcome = {
+        run_id: runId,
+        status,
+        adapter_id: adapterId,
+        mode,
+        updated_at: updatedAt,
+        exit_code: value.exit_code === null || typeof value.exit_code === "number" ? value.exit_code : null,
+        target,
+    };
+    if (typeof value.started_at === "string" && value.started_at.trim()) {
+        outcome.started_at = value.started_at.trim();
+    }
+    if (typeof value.ended_at === "string" && value.ended_at.trim()) {
+        outcome.ended_at = value.ended_at.trim();
+    }
+    if (Array.isArray(value.output_paths)) {
+        const outputPaths = value.output_paths.filter((item) => typeof item === "string" && item.trim().length > 0);
+        if (outputPaths.length > 0)
+            outcome.output_paths = outputPaths;
+    }
+    if (typeof value.summary === "string" && value.summary.trim()) {
+        outcome.summary = value.summary.trim();
+    }
+    if (typeof value.stdout_summary === "string" && value.stdout_summary.trim()) {
+        outcome.stdout_summary = value.stdout_summary.trim();
+    }
+    if (typeof value.stderr_summary === "string" && value.stderr_summary.trim()) {
+        outcome.stderr_summary = value.stderr_summary.trim();
+    }
+    const metrics = normalizeTaskRunnerMetrics(value.metrics);
+    if (metrics)
+        outcome.metrics = metrics;
+    const evidence = normalizeTaskRunnerEvidence(value.evidence);
+    if (evidence)
+        outcome.evidence = evidence;
+    return outcome;
+}
+export function normalizeTaskRunnerOutcome(value) {
+    const outcome = normalizeTaskRunnerHistoryEntry(value);
+    if (!outcome)
+        return null;
+    const record = value;
+    const history = Array.isArray(record.history)
+        ? record.history
+            .map((entry) => normalizeTaskRunnerHistoryEntry(entry))
+            .filter((entry) => !!entry)
+        : [];
+    return history.length > 0 ? { ...outcome, history } : outcome;
+}
+export function toTaskSummary(task) {
+    const { doc, sections, events, ...summary } = task;
+    void doc;
+    void sections;
+    void events;
+    return summary;
+}
+export function toTaskSummaries(tasks) {
+    return tasks.map((task) => toTaskSummary(task));
+}

package/dist/backends/task-backend/shared/record.d.ts

@@ -1,4 +1,4 @@
-import type { TaskRecord } from "@agentplaneorg/core";
+import { type TaskRecord } from "@agentplaneorg/core";
 import type { TaskData } from "./types.js";
 export declare function taskRecordToData(record: TaskRecord): TaskData;
 //# sourceMappingURL=record.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAYtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkB3C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CA2D7D"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAc/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkB3C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAgE7D"}

package/dist/backends/task-backend/shared/record.js

@@ -1,7 +1,8 @@
+import { normalizeTaskDocVersion } from "@agentplaneorg/core";
 import { isRecord } from "../../../shared/guards.js";
 import { extractTaskDoc } from "./doc.js";
 import { normalizeEvents } from "./events.js";
-import { normalizeDependsOn, normalizePlanApproval, normalizeVerificationResult, } from "./normalize.js";
+import { normalizeDependsOn, normalizePlanApproval, normalizeTaskOrigin, normalizeTaskRunnerOutcome, normalizeVerificationResult, } from "./normalize.js";
 import { toStringArray } from "./strings.js";
 import { renderTaskDocFromSections, taskDocToSectionMap } from "@agentplaneorg/core";
 function normalizeRevision(value) {
@@ -35,6 +36,8 @@ export function taskRecordToData(record) {
     const events = normalizeEvents(fm.events);
     const planApproval = normalizePlanApproval(fm.plan_approval);
     const verification = normalizeVerificationResult(fm.verification);
+    const origin = normalizeTaskOrigin(fm.origin);
+    const runner = normalizeTaskRunnerOutcome(fm.runner);
     const sections = normalizeCanonicalSections(fm.sections);
     const doc = sections ? renderTaskDocFromSections(sections) : extractTaskDoc(record.body);
     const baseId = typeof fm.id === "string" ? fm.id : typeof record.id === "string" ? record.id : "";
@@ -51,15 +54,17 @@ export function taskRecordToData(record) {
         priority: typeof fm.priority === "string" || typeof fm.priority === "number" ? fm.priority : "",
         owner: typeof fm.owner === "string" ? fm.owner : "",
         revision: normalizeRevision(fm.revision) ?? 1,
+        origin: origin ?? undefined,
         depends_on: normalizeDependsOn(fm.depends_on),
         tags: toStringArray(fm.tags),
         verify: toStringArray(fm.verify),
         plan_approval: planApproval ?? undefined,
         verification: verification ?? undefined,
+        runner: runner ?? undefined,
         commit,
         comments,
         events,
-        doc_version: typeof fm.doc_version === "number" ? fm.doc_version : undefined,
+        doc_version: typeof fm.doc_version === "number" ? normalizeTaskDocVersion(fm.doc_version) : undefined,
         doc_updated_at: typeof fm.doc_updated_at === "string" ? fm.doc_updated_at : undefined,
         doc_updated_by: typeof fm.doc_updated_by === "string" ? fm.doc_updated_by : undefined,
         dirty: typeof fm.dirty === "boolean" ? fm.dirty : undefined,

package/dist/backends/task-backend/shared/types.d.ts

@@ -1,28 +1,5 @@
-export type PlanApprovalState = "pending" | "approved" | "rejected";
-export type PlanApproval = {
-    state: PlanApprovalState;
-    updated_at: string | null;
-    updated_by: string | null;
-    note: string | null;
-};
-export type VerificationState = "pending" | "ok" | "needs_rework";
-export type VerificationResult = {
-    state: VerificationState;
-    updated_at: string | null;
-    updated_by: string | null;
-    note: string | null;
-};
-export type TaskEventType = "status" | "comment" | "verify";
-export type TaskEvent = {
-    type: TaskEventType;
-    at: string;
-    author: string;
-    from?: string;
-    to?: string;
-    state?: string;
-    note?: string;
-    body?: string;
-};
+import type { PlanApproval, TaskDocSections, TaskDocVersion, TaskEvent, TaskOrigin, TaskRunnerOutcome, VerificationResult } from "@agentplaneorg/core";
+export type { PlanApproval, PlanApprovalState, TaskEvent, TaskEventType, TaskOrigin, TaskRunnerEvidence, TaskRunnerExecutionMetrics, TaskRunnerHistoryEntry, TaskRunnerOutcome, TaskRunnerOutcomeStatus, TaskRunnerTarget, VerificationResult, VerificationState, } from "@agentplaneorg/core";
 export type TaskData = {
     id: string;
     title: string;
@@ -34,11 +11,13 @@ export type TaskData = {
     priority: string | number;
     owner: string;
     revision?: number;
+    origin?: TaskOrigin | null;
     depends_on: string[];
     tags: string[];
     verify: string[];
     plan_approval?: PlanApproval;
     verification?: VerificationResult;
+    runner?: TaskRunnerOutcome;
     commit?: {
         hash: string;
         message: string;
@@ -49,20 +28,26 @@ export type TaskData = {
     }[];
     events?: TaskEvent[];
     doc?: string;
-    sections?: Record<string, string>;
-    doc_version?: number;
+    sections?: TaskDocSections;
+    doc_version?: TaskDocVersion;
     doc_updated_at?: string;
     doc_updated_by?: string;
     dirty?: boolean;
     id_source?: string;
 };
+export type TaskSummary = Omit<TaskData, "doc" | "sections" | "events">;
 export type TaskDocMeta = Pick<TaskData, "doc" | "doc_version" | "doc_updated_at" | "doc_updated_by">;
 export type TaskWriteOptions = {
     expectedRevision?: number;
+    expectedCurrentDoc?: string | null;
+    expectedCurrentText?: string | null;
+    expectedSection?: string;
 };
+export type TaskBackendProjectionReadMode = "native" | "fallback";
 export type TaskBackendCapabilities = {
     canonical_source: "local" | "remote";
     projection: "canonical" | "cache";
+    projection_read_mode: TaskBackendProjectionReadMode;
     reads_from_projection_by_default: boolean;
     writes_task_readmes?: boolean;
     supports_task_revisions: boolean;
@@ -107,37 +92,54 @@ export type TaskBackendInspectionResult = {
     };
     configuredFieldNameDrift: TaskBackendFieldNameDrift[];
 };
-export type TaskBackend = {
+export type TaskBackendBase = {
     id: string;
     capabilities: TaskBackendCapabilities;
+};
+export type TaskBackendQueryPort = {
     listTasks(): Promise<TaskData[]>;
-    listProjectionTasks?(): Promise<TaskData[]>;
-    getLastListWarnings?(): string[];
     getTask(taskId: string): Promise<TaskData | null>;
     getTasks?(taskIds: string[]): Promise<(TaskData | null)[]>;
+};
+export type TaskBackendProjectionPort = {
+    listProjectionTasks?(): Promise<TaskSummary[]>;
+    getLastListWarnings?(): string[];
+};
+export type TaskBackendMutationPort = {
     writeTask(task: TaskData, opts?: TaskWriteOptions): Promise<void>;
     writeTasks?(tasks: TaskData[], opts?: TaskWriteOptions): Promise<void>;
     normalizeTasks?(): Promise<{
         scanned: number;
         changed: number;
     }>;
+};
+export type TaskBackendSyncPort = {
     refreshProjection?(opts: TaskProjectionRefreshOptions): Promise<void>;
     migrateCanonicalState?(): Promise<TaskCanonicalStateMigrationResult>;
-    inspectConfiguration?(): Promise<TaskBackendInspectionResult>;
-    exportProjectionSnapshot?(outputPath: string): Promise<void>;
-    exportTasksJson?(outputPath: string): Promise<void>;
-    getTaskDoc?(taskId: string): Promise<string>;
-    setTaskDoc?(taskId: string, doc: string, updatedBy?: string, opts?: TaskWriteOptions): Promise<void>;
-    touchTaskDocMetadata?(taskId: string, updatedBy?: string, opts?: TaskWriteOptions): Promise<void>;
     sync?(opts: {
         direction: "push" | "pull";
         conflict: "diff" | "prefer-local" | "prefer-remote" | "fail";
         quiet: boolean;
         confirm: boolean;
     }): Promise<void>;
+};
+export type TaskBackendInspectionPort = {
+    inspectConfiguration?(): Promise<TaskBackendInspectionResult>;
+};
+export type TaskBackendExportPort = {
+    exportProjectionSnapshot?(outputPath: string): Promise<void>;
+    exportTasksJson?(outputPath: string): Promise<void>;
+};
+export type TaskBackendDocPort = {
+    getTaskDoc?(taskId: string): Promise<string>;
+    setTaskDoc?(taskId: string, doc: string, updatedBy?: string, opts?: TaskWriteOptions): Promise<void>;
+    touchTaskDocMetadata?(taskId: string, updatedBy?: string, opts?: TaskWriteOptions): Promise<void>;
+};
+export type TaskBackendIdentityPort = {
     generateTaskId?(opts: {
         length: number;
         attempts: number;
     }): Promise<string>;
 };
+export type TaskBackend = TaskBackendBase & TaskBackendQueryPort & TaskBackendProjectionPort & TaskBackendMutationPort & TaskBackendSyncPort & TaskBackendInspectionPort & TaskBackendExportPort & TaskBackendDocPort & TaskBackendIdentityPort;
 //# sourceMappingURL=types.d.ts.map