agentplane 0.3.5 → 0.3.7

package/dist/backends/task-backend/redmine-backend.js

@@ -1,4 +1,4 @@
-import { canonicalizeJson } from "@agentplaneorg/core";
+import { canonicalizeJson, taskDocToSectionMap } from "@agentplaneorg/core";
 import { isRecord } from "../../shared/guards.js";
 import { appendCommentNotes as appendCommentNotesImpl, normalizeComments as normalizeCommentsImpl, } from "./redmine/comments.js";
 import { requestJson as requestRedmineJson } from "./redmine/client.js";
@@ -6,6 +6,8 @@ import { appendCustomField as appendRedmineCustomField, customFieldValue as redm
 import { doneRatioForStatus, issueToTask as issueToTaskImpl, startDateFromTaskId, taskToIssuePayload as taskToIssuePayloadImpl, } from "./redmine/mapping.js";
 import { coerceDocVersion as coerceRedmineDocVersion, maybeParseJson as maybeParseRedmineJson, } from "./redmine/parse.js";
 import { findIssueByTaskId as findIssueByTaskIdImpl, listTasksRemote as listTasksRemoteImpl, } from "./redmine/remote.js";
+import { detectConfiguredFieldNameDrift, inferVisibleCanonicalStateFieldId, inspectVisibleCustomFields, } from "./redmine/inspect.js";
+import { buildRedmineCanonicalStateWithOptions, parseRedmineCanonicalState, } from "./redmine/state.js";
 import { readRedmineEnv } from "./redmine/env.js";
 import { BackendError, DEFAULT_DOC_UPDATED_BY, DOC_VERSION, RedmineUnavailable, ensureDocMetadata, firstNonEmptyString, generateTaskId, mapLimit, missingTaskIdMessage, normalizeDocVersion, nowIso, redmineConfigMissingEnvMessage, redmineIssueIdMissingMessage, sleep, toStringSafe, unknownTaskIdMessage, validateTaskId, writeTasksExportFromTasks, } from "./shared.js";
 export class RedmineBackend {
@@ -15,6 +17,8 @@ export class RedmineBackend {
         projection: "cache",
         reads_from_projection_by_default: true,
         writes_task_readmes: true,
+        supports_task_revisions: false,
+        supports_revision_guarded_writes: false,
         may_access_network_on_read: false,
         may_access_network_on_write: true,
         supports_projection_refresh: true,
@@ -72,6 +76,12 @@ export class RedmineBackend {
         if (!this.customFields?.task_id) {
             throw new BackendError(redmineConfigMissingEnvMessage("AGENTPLANE_REDMINE_CUSTOM_FIELDS_TASK_ID"), "E_BACKEND");
         }
+        const supportsStructuredRevisions = Boolean(this.customFields?.canonical_state);
+        this.capabilities = {
+            ...this.capabilities,
+            supports_task_revisions: supportsStructuredRevisions,
+            supports_revision_guarded_writes: supportsStructuredRevisions,
+        };
         for (const [key, value] of Object.entries(this.statusMap)) {
             if (typeof value === "number")
                 this.reverseStatus.set(value, key);
@@ -134,6 +144,107 @@ export class RedmineBackend {
             return await this.cache.normalizeTasks();
         return { scanned: 0, changed: 0 };
     }
+    async migrateCanonicalState() {
+        if (!this.customFields.canonical_state) {
+            throw new BackendError(redmineConfigMissingEnvMessage("AGENTPLANE_REDMINE_CUSTOM_FIELDS_CANONICAL_STATE"), "E_BACKEND");
+        }
+        const tasks = await this.listTasksRemote();
+        const result = {
+            scanned: tasks.length,
+            migrated: [],
+            skippedStructured: [],
+            skippedNoDoc: [],
+            failed: [],
+        };
+        for (const [index, task] of tasks.entries()) {
+            const taskId = toStringSafe(task.id).trim();
+            if (!taskId)
+                continue;
+            const issue = this.issueCache.get(taskId);
+            if (!issue) {
+                result.failed.push({
+                    taskId,
+                    reason: "Redmine issue payload was not cached during remote list refresh",
+                });
+                continue;
+            }
+            const currentState = parseRedmineCanonicalState(this.customFieldValue(issue, this.customFields.canonical_state));
+            if (currentState) {
+                result.skippedStructured.push(taskId);
+                continue;
+            }
+            const sections = task.sections && Object.keys(task.sections).length > 0
+                ? task.sections
+                : task.doc
+                    ? taskDocToSectionMap(task.doc)
+                    : undefined;
+            if (!sections || Object.keys(sections).length === 0) {
+                result.skippedNoDoc.push(taskId);
+                continue;
+            }
+            const issueIdText = toStringSafe(issue.id);
+            if (!issueIdText) {
+                result.failed.push({ taskId, reason: redmineIssueIdMissingMessage() });
+                continue;
+            }
+            const currentRevision = 0;
+            const nextRevision = Math.max(task.revision ?? 0, currentRevision, 1);
+            const nextCanonicalState = buildRedmineCanonicalStateWithOptions({
+                ...task,
+                sections,
+                revision: nextRevision,
+            }, { base: currentState, revision: nextRevision });
+            if (!nextCanonicalState) {
+                result.skippedNoDoc.push(taskId);
+                continue;
+            }
+            const customFields = [];
+            this.appendCustomField(customFields, "canonical_state", nextCanonicalState);
+            try {
+                await this.requestJson("PUT", `issues/${issueIdText}.json`, {
+                    issue: { custom_fields: customFields },
+                });
+                this.setIssueCustomFieldValue(issue, this.customFields.canonical_state, nextCanonicalState);
+                this.issueCache.set(taskId, issue);
+                await this.cacheTask({
+                    ...task,
+                    sections,
+                    revision: nextRevision,
+                    dirty: false,
+                }, false);
+                result.migrated.push(taskId);
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : "Unknown Redmine canonical_state migration failure";
+                result.failed.push({ taskId, reason });
+            }
+            if (this.batchPauseMs > 0 && this.batchSize > 0 && (index + 1) % this.batchSize === 0) {
+                await sleep(this.batchPauseMs);
+            }
+        }
+        return result;
+    }
+    async inspectConfiguration() {
+        const visibleCustomFields = await inspectVisibleCustomFields({
+            projectId: this.projectId,
+            requestJson: async (method, reqPath, payload, params) => await this.requestJson(method, reqPath, payload, params),
+        });
+        const visibleCanonicalStateFieldId = inferVisibleCanonicalStateFieldId(visibleCustomFields);
+        return {
+            backendId: this.id,
+            visibleCustomFields,
+            canonicalState: {
+                configuredFieldId: typeof this.customFields.canonical_state === "number"
+                    ? this.customFields.canonical_state
+                    : null,
+                visibleFieldId: visibleCanonicalStateFieldId,
+            },
+            configuredFieldNameDrift: detectConfiguredFieldNameDrift({
+                configuredFields: this.customFields,
+                visibleFields: visibleCustomFields,
+            }),
+        };
+    }
     async getTask(taskId) {
         if (!this.cache) {
             throw new BackendError("Redmine cache is disabled; projection reads are unavailable", "E_BACKEND");
@@ -150,7 +261,7 @@ export class RedmineBackend {
             throw new Error(unknownTaskIdMessage(taskId));
         return toStringSafe(task.doc);
     }
-    async setTaskDoc(taskId, doc, updatedBy) {
+    async setTaskDoc(taskId, doc, updatedBy, opts) {
         if (!this.customFields.doc) {
             throw new BackendError(redmineConfigMissingEnvMessage("AGENTPLANE_REDMINE_CUSTOM_FIELDS_DOC"), "E_BACKEND");
         }
@@ -162,13 +273,38 @@ export class RedmineBackend {
             if (!issueIdText)
                 throw new Error(redmineIssueIdMissingMessage());
             const cachedTask = this.issueToTask(issue, taskId);
+            const currentState = parseRedmineCanonicalState(this.customFieldValue(issue, this.customFields.canonical_state));
+            this.assertExpectedRevisionSupported(taskId, opts);
+            this.assertExpectedRevision(taskId, opts?.expectedRevision, currentState?.revision ?? 1);
             const taskDoc = {
                 doc: String(doc ?? ""),
                 doc_version: cachedTask?.doc_version,
             };
             ensureDocMetadata(taskDoc, updatedBy);
+            const nextSections = taskDocToSectionMap(String(taskDoc.doc ?? ""));
+            const nextRevision = Math.max(cachedTask?.revision ?? 0, currentState?.revision ?? 0, 0) + 1;
             const customFields = [];
             this.appendCustomField(customFields, "doc", taskDoc.doc);
+            const nextCanonicalState = buildRedmineCanonicalStateWithOptions({
+                id: taskId,
+                title: cachedTask?.title ?? "",
+                description: cachedTask?.description ?? "",
+                status: cachedTask?.status ?? "TODO",
+                priority: cachedTask?.priority ?? "med",
+                owner: cachedTask?.owner ?? this.ownerAgent,
+                depends_on: cachedTask?.depends_on ?? [],
+                tags: cachedTask?.tags ?? [],
+                verify: cachedTask?.verify ?? [],
+                doc: taskDoc.doc,
+                sections: nextSections,
+                revision: nextRevision,
+                plan_approval: cachedTask?.plan_approval,
+                verification: cachedTask?.verification,
+                events: cachedTask?.events,
+            }, { base: currentState, revision: nextRevision });
+            if (nextCanonicalState) {
+                this.appendCustomField(customFields, "canonical_state", nextCanonicalState);
+            }
             this.appendCustomField(customFields, "doc_version", taskDoc.doc_version);
             this.appendCustomField(customFields, "doc_updated_at", taskDoc.doc_updated_at);
             this.appendCustomField(customFields, "doc_updated_by", taskDoc.doc_updated_by);
@@ -177,6 +313,8 @@ export class RedmineBackend {
             });
             if (cachedTask) {
                 cachedTask.doc = taskDoc.doc;
+                cachedTask.sections = nextSections;
+                cachedTask.revision = nextRevision;
                 cachedTask.doc_version = taskDoc.doc_version;
                 cachedTask.doc_updated_at = taskDoc.doc_updated_at;
                 cachedTask.doc_updated_by = taskDoc.doc_updated_by;
@@ -190,16 +328,20 @@ export class RedmineBackend {
                 const cached = await this.cache.getTask(taskId);
                 if (!cached)
                     throw new Error(unknownTaskIdMessage(taskId));
+                this.assertExpectedRevisionSupported(taskId, opts);
+                this.assertExpectedRevision(taskId, opts?.expectedRevision, cached.revision ?? 1);
                 cached.doc = String(doc ?? "");
+                cached.sections = taskDocToSectionMap(cached.doc);
+                cached.revision = Math.max(cached.revision ?? 0, 0) + 1;
                 ensureDocMetadata(cached, updatedBy);
                 cached.dirty = true;
-                await this.cache.writeTask(cached);
+                await this.cache.writeTask(cached, opts);
                 return;
             }
             throw err;
         }
     }
-    async touchTaskDocMetadata(taskId, updatedBy) {
+    async touchTaskDocMetadata(taskId, updatedBy, opts) {
         try {
             const issue = await this.findIssueByTaskId(taskId);
             if (!issue)
@@ -209,6 +351,9 @@ export class RedmineBackend {
                 throw new Error(redmineIssueIdMissingMessage());
             const docValue = this.customFieldValue(issue, this.customFields.doc);
             const cachedTask = this.issueToTask(issue, taskId);
+            const currentState = parseRedmineCanonicalState(this.customFieldValue(issue, this.customFields.canonical_state));
+            this.assertExpectedRevisionSupported(taskId, opts);
+            this.assertExpectedRevision(taskId, opts?.expectedRevision, currentState?.revision ?? 1);
             const taskDoc = {
                 doc: docValue ?? "",
                 doc_version: cachedTask?.doc_version,
@@ -237,15 +382,17 @@ export class RedmineBackend {
                 const cached = await this.cache.getTask(taskId);
                 if (!cached)
                     throw new Error(unknownTaskIdMessage(taskId));
+                this.assertExpectedRevisionSupported(taskId, opts);
+                this.assertExpectedRevision(taskId, opts?.expectedRevision, cached.revision ?? 1);
                 ensureDocMetadata(cached, updatedBy);
                 cached.dirty = true;
-                await this.cache.writeTask(cached);
+                await this.cache.writeTask(cached, opts);
                 return;
             }
             throw err;
         }
     }
-    async writeTask(task) {
+    async writeTask(task, opts) {
         const taskId = toStringSafe(task.id).trim();
         if (!taskId)
             throw new Error(missingTaskIdMessage());
@@ -260,9 +407,26 @@ export class RedmineBackend {
                 const payload = await this.requestJson("GET", `issues/${issueIdText}.json`);
                 existingIssue = this.issueFromPayload(payload);
             }
-            const payload = this.taskToIssuePayload(task, existingIssue ?? undefined);
+            const currentState = existingIssue && this.customFields.canonical_state
+                ? parseRedmineCanonicalState(this.customFieldValue(existingIssue, this.customFields.canonical_state))
+                : null;
+            this.assertExpectedRevisionSupported(taskId, opts);
+            this.assertExpectedRevision(taskId, opts?.expectedRevision, currentState?.revision ?? 0);
+            const nextRevision = issueIdText
+                ? Math.max(task.revision ?? 0, currentState?.revision ?? 0, 0) + 1
+                : Math.max(task.revision ?? 0, currentState?.revision ?? 0, 1);
+            const taskForWrite = {
+                ...task,
+                revision: nextRevision,
+                sections: task.sections && Object.keys(task.sections).length > 0
+                    ? task.sections
+                    : task.doc
+                        ? taskDocToSectionMap(task.doc)
+                        : undefined,
+            };
+            const payload = this.taskToIssuePayload(taskForWrite, existingIssue ?? undefined);
             if (payload.status_id === undefined) {
-                const inferredStatusId = await this.inferStatusIdForTaskStatus(task.status);
+                const inferredStatusId = await this.inferStatusIdForTaskStatus(taskForWrite.status);
                 if (inferredStatusId !== null)
                     payload.status_id = inferredStatusId;
             }
@@ -287,27 +451,37 @@ export class RedmineBackend {
                 const existingComments = existingIssue && this.customFields.comments
                     ? this.normalizeComments(this.maybeParseJson(this.customFieldValue(existingIssue, this.customFields.comments)))
                     : [];
-                const desiredComments = this.normalizeComments(task.comments);
+                const desiredComments = this.normalizeComments(taskForWrite.comments);
                 await this.appendCommentNotes(issueIdText, existingComments, desiredComments);
             }
-            task.dirty = false;
-            await this.cacheTask(task, false);
+            taskForWrite.dirty = false;
+            await this.cacheTask(taskForWrite, false);
             this.issueCache.clear();
         }
         catch (err) {
             if (err instanceof RedmineUnavailable) {
                 if (!this.cache)
                     throw err;
-                task.dirty = true;
-                await this.cacheTask(task, true);
+                this.assertExpectedRevisionSupported(taskId, opts);
+                const taskForCache = {
+                    ...task,
+                    revision: Math.max(task.revision ?? 0, 1),
+                    sections: task.sections && Object.keys(task.sections).length > 0
+                        ? task.sections
+                        : task.doc
+                            ? taskDocToSectionMap(task.doc)
+                            : undefined,
+                    dirty: true,
+                };
+                await this.cache.writeTask(taskForCache, opts);
                 return;
             }
             throw err;
         }
     }
-    async writeTasks(tasks) {
+    async writeTasks(tasks, opts) {
         for (const [index, task] of tasks.entries()) {
-            await this.writeTask(task);
+            await this.writeTask(task, opts);
             if (this.batchPauseMs > 0 && this.batchSize > 0 && (index + 1) % this.batchSize === 0) {
                 await sleep(this.batchPauseMs);
             }
@@ -430,6 +604,22 @@ export class RedmineBackend {
         const next = { ...task, dirty };
         await this.cache.writeTask(next);
     }
+    assertExpectedRevisionSupported(taskId, opts) {
+        if (opts?.expectedRevision === undefined)
+            return;
+        if (this.capabilities.supports_revision_guarded_writes)
+            return;
+        throw new BackendError(`Task revision guarding is unavailable for ${taskId} without AGENTPLANE_REDMINE_CUSTOM_FIELDS_CANONICAL_STATE`, "E_BACKEND");
+    }
+    assertExpectedRevision(taskId, expectedRevision, currentRevision) {
+        if (expectedRevision === undefined)
+            return;
+        const expected = Math.trunc(expectedRevision);
+        if (expected <= 0 || expected === currentRevision)
+            return;
+        throw new BackendError(`Task revision changed concurrently: ${taskId} ` +
+            `(expected revision ${expected}, current revision ${currentRevision})`, "E_BACKEND");
+    }
     taskIdFieldId() {
         const fieldId = this.customFields?.task_id;
         if (fieldId)

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

@@ -1,5 +1,5 @@
 export declare const TASK_ID_RE: RegExp;
 export declare const DEFAULT_DOC_UPDATED_BY = "agentplane";
-export declare const DOC_VERSION = 2;
+export declare const DOC_VERSION = 3;
 export declare const SUPPORTED_DOC_VERSIONS: readonly [2, 3];
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1,5 +1,5 @@
 import { TASK_ID_ALPHABET } from "@agentplaneorg/core";
 export const TASK_ID_RE = new RegExp(String.raw `^\d{12}-[${TASK_ID_ALPHABET}]{4,}$`);
 export const DEFAULT_DOC_UPDATED_BY = "agentplane";
-export const DOC_VERSION = 2;
+export const DOC_VERSION = 3;
 export const SUPPORTED_DOC_VERSIONS = [2, 3];

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;AAE3C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAwD7D"}
+{"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"}

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

@@ -3,6 +3,22 @@ import { extractTaskDoc } from "./doc.js";
 import { normalizeEvents } from "./events.js";
 import { normalizeDependsOn, normalizePlanApproval, normalizeVerificationResult, } from "./normalize.js";
 import { toStringArray } from "./strings.js";
+import { renderTaskDocFromSections, taskDocToSectionMap } from "@agentplaneorg/core";
+function normalizeRevision(value) {
+    return Number.isInteger(value) && Number(value) > 0 ? Number(value) : undefined;
+}
+function normalizeCanonicalSections(value) {
+    if (!isRecord(value))
+        return undefined;
+    const out = {};
+    for (const [title, text] of Object.entries(value)) {
+        const normalizedTitle = title.trim();
+        if (!normalizedTitle || typeof text !== "string")
+            continue;
+        out[normalizedTitle] = text.replaceAll("\r\n", "\n").trimEnd();
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
 export function taskRecordToData(record) {
     const fm = record.frontmatter;
     const comments = Array.isArray(fm.comments)
@@ -19,6 +35,8 @@ export function taskRecordToData(record) {
     const events = normalizeEvents(fm.events);
     const planApproval = normalizePlanApproval(fm.plan_approval);
     const verification = normalizeVerificationResult(fm.verification);
+    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 : "";
     const task = {
         id: baseId.trim(),
@@ -32,6 +50,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 : "",
+        revision: normalizeRevision(fm.revision) ?? 1,
         depends_on: normalizeDependsOn(fm.depends_on),
         tags: toStringArray(fm.tags),
         verify: toStringArray(fm.verify),
@@ -46,8 +65,8 @@ export function taskRecordToData(record) {
         dirty: typeof fm.dirty === "boolean" ? fm.dirty : undefined,
         id_source: typeof fm.id_source === "string" ? fm.id_source : undefined,
     };
-    const doc = extractTaskDoc(record.body);
     if (doc)
         task.doc = doc;
+    task.sections = sections ?? (doc ? taskDocToSectionMap(doc) : undefined);
     return task;
 }

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

@@ -33,6 +33,7 @@ export type TaskData = {
     status: string;
     priority: string | number;
     owner: string;
+    revision?: number;
     depends_on: string[];
     tags: string[];
     verify: string[];
@@ -48,6 +49,7 @@ export type TaskData = {
     }[];
     events?: TaskEvent[];
     doc?: string;
+    sections?: Record<string, string>;
     doc_version?: number;
     doc_updated_at?: string;
     doc_updated_by?: string;
@@ -55,11 +57,16 @@ export type TaskData = {
     id_source?: string;
 };
 export type TaskDocMeta = Pick<TaskData, "doc" | "doc_version" | "doc_updated_at" | "doc_updated_by">;
+export type TaskWriteOptions = {
+    expectedRevision?: number;
+};
 export type TaskBackendCapabilities = {
     canonical_source: "local" | "remote";
     projection: "canonical" | "cache";
     reads_from_projection_by_default: boolean;
     writes_task_readmes?: boolean;
+    supports_task_revisions: boolean;
+    supports_revision_guarded_writes: boolean;
     may_access_network_on_read: boolean;
     may_access_network_on_write: boolean;
     supports_projection_refresh: boolean;
@@ -71,6 +78,35 @@ export type TaskProjectionRefreshOptions = {
     quiet?: boolean;
     conflict?: "diff" | "prefer-local" | "prefer-remote" | "fail";
 };
+export type TaskCanonicalStateMigrationResult = {
+    scanned: number;
+    migrated: string[];
+    skippedStructured: string[];
+    skippedNoDoc: string[];
+    failed: {
+        taskId: string;
+        reason: string;
+    }[];
+};
+export type TaskBackendVisibleField = {
+    id: number;
+    name: string;
+    nonEmptyCount: number;
+};
+export type TaskBackendFieldNameDrift = {
+    key: string;
+    configuredId: number;
+    visibleName: string;
+};
+export type TaskBackendInspectionResult = {
+    backendId: string;
+    visibleCustomFields: TaskBackendVisibleField[];
+    canonicalState: {
+        configuredFieldId: number | null;
+        visibleFieldId: number | null;
+    };
+    configuredFieldNameDrift: TaskBackendFieldNameDrift[];
+};
 export type TaskBackend = {
     id: string;
     capabilities: TaskBackendCapabilities;
@@ -79,18 +115,20 @@ export type TaskBackend = {
     getLastListWarnings?(): string[];
     getTask(taskId: string): Promise<TaskData | null>;
     getTasks?(taskIds: string[]): Promise<(TaskData | null)[]>;
-    writeTask(task: TaskData): Promise<void>;
-    writeTasks?(tasks: TaskData[]): Promise<void>;
+    writeTask(task: TaskData, opts?: TaskWriteOptions): Promise<void>;
+    writeTasks?(tasks: TaskData[], opts?: TaskWriteOptions): Promise<void>;
     normalizeTasks?(): Promise<{
         scanned: number;
         changed: number;
     }>;
     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): Promise<void>;
-    touchTaskDocMetadata?(taskId: string, updatedBy?: string): Promise<void>;
+    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";

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

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

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

@@ -1,5 +1,5 @@
 export { DEFAULT_DOC_UPDATED_BY, DOC_VERSION, TASK_ID_RE } from "./shared/constants.js";
-export type { PlanApproval, PlanApprovalState, TaskBackend, TaskBackendCapabilities, TaskData, TaskDocMeta, TaskEvent, TaskEventType, TaskProjectionRefreshOptions, VerificationResult, VerificationState, } from "./shared/types.js";
+export type { PlanApproval, PlanApprovalState, TaskBackend, TaskBackendCapabilities, TaskBackendFieldNameDrift, TaskBackendInspectionResult, TaskBackendVisibleField, TaskCanonicalStateMigrationResult, TaskData, TaskDocMeta, TaskEvent, TaskEventType, TaskProjectionRefreshOptions, TaskWriteOptions, VerificationResult, VerificationState, } from "./shared/types.js";
 export * from "./shared/concurrency.js";
 export * from "./shared/doc.js";
 export * from "./shared/errors.js";

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExF,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExF,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,iCAAiC,EACjC,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,4BAA4B,EAC5B,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

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

@@ -1,4 +1,4 @@
-export { BackendError, RedmineUnavailable, buildTasksExportSnapshotFromTasks, extractTaskDoc, mergeTaskDoc, taskRecordToData, writeTasksExportFromTasks, type PlanApproval, type PlanApprovalState, type TaskBackend, type TaskBackendCapabilities, type TaskData, type TaskEvent, type TaskEventType, type TaskProjectionRefreshOptions, type VerificationResult, type VerificationState, } from "./task-backend/shared.js";
+export { BackendError, RedmineUnavailable, buildTasksExportSnapshotFromTasks, extractTaskDoc, mergeTaskDoc, taskRecordToData, writeTasksExportFromTasks, type PlanApproval, type PlanApprovalState, type TaskBackend, type TaskBackendCapabilities, type TaskBackendFieldNameDrift, type TaskBackendInspectionResult, type TaskBackendVisibleField, type TaskData, type TaskEvent, type TaskEventType, type TaskProjectionRefreshOptions, type TaskWriteOptions, type VerificationResult, type VerificationState, } from "./task-backend/shared.js";
 export { LocalBackend } from "./task-backend/local-backend.js";
 export { RedmineBackend } from "./task-backend/redmine-backend.js";
 export { loadTaskBackend } from "./task-backend/load.js";

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

@@ -1 +1 @@
-{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../src/backends/task-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iCAAiC,EACjC,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../src/backends/task-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iCAAiC,EACjC,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/backends/task-backend.test-helpers.d.ts

@@ -0,0 +1,4 @@
+export declare function installTaskBackendTestHarness(): void;
+export declare function makeTempDir(): Promise<string>;
+export declare const makeIssue: (priorityName?: string) => Record<string, unknown>;
+//# sourceMappingURL=task-backend.test-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-backend.test-helpers.d.ts","sourceRoot":"","sources":["../../src/backends/task-backend.test-helpers.ts"],"names":[],"mappings":"AAUA,wBAAgB,6BAA6B,IAAI,IAAI,CAWpD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAEnD;AAED,eAAO,MAAM,SAAS,GAAI,eAAe,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAatE,CAAC"}

package/dist/backends/task-backend.test-helpers.js

@@ -0,0 +1,33 @@
+import { mkdtemp } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach } from "vitest";
+import { silenceStdIO } from "../cli/run-cli.test-helpers.js";
+const TMP_PREFIX = "agentplane-task-backend-";
+export function installTaskBackendTestHarness() {
+    let restoreStdIO = null;
+    beforeEach(() => {
+        restoreStdIO = silenceStdIO();
+    });
+    afterEach(() => {
+        restoreStdIO?.();
+        restoreStdIO = null;
+    });
+}
+export async function makeTempDir() {
+    return await mkdtemp(path.join(os.tmpdir(), TMP_PREFIX));
+}
+export const makeIssue = (priorityName) => ({
+    id: 1,
+    subject: "Subject",
+    description: "Desc",
+    status: { id: 1 },
+    priority: priorityName ? { name: priorityName } : undefined,
+    custom_fields: [
+        { id: 2, value: '["echo ok"]' },
+        { id: 3, value: '{"hash":"h","message":"m"}' },
+        { id: 4, value: "note" },
+        { id: 5, value: "2" },
+    ],
+    updated_on: "2026-01-30T00:00:00Z",
+});

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

@@ -1 +1 @@
-{"version":3,"file":"task-index.d.ts","sourceRoot":"","sources":["../../src/backends/task-index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAI3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU7D;AA8ED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWpF;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,cAAc,CAahB"}
+{"version":3,"file":"task-index.d.ts","sourceRoot":"","sources":["../../src/backends/task-index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAI3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU7D;AA8ED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWpF;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,cAAc,CAchB"}

package/dist/backends/task-index.js

@@ -127,6 +127,7 @@ export function buildTaskIndexEntry(task, readmePath, mtimeMs) {
         ...task,
         // Keep the index payload lean for list/search/next paths.
         doc: undefined,
+        sections: undefined,
         comments: undefined,
         events: undefined,
     };

package/dist/cli/bootstrap-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-guide.d.ts","sourceRoot":"","sources":["../../src/cli/bootstrap-guide.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,4CAA4C,CAAC;AAClF,eAAO,MAAM,+BAA+B,0BAA0B,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,4BAA4B,oKAM/B,CAAC;AAEX,eAAO,MAAM,4BAA4B,UAIxC,CAAC;AAEF,eAAO,MAAM,oCAAoC,oUAMvC,CAAC;AAEX,eAAO,MAAM,2BAA2B,sFAI9B,CAAC;AAEX,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAmChD,CAAC;AAEX,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAiB3F;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,CA2B3C"}
+{"version":3,"file":"bootstrap-guide.d.ts","sourceRoot":"","sources":["../../src/cli/bootstrap-guide.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,4CAA4C,CAAC;AAClF,eAAO,MAAM,+BAA+B,0BAA0B,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,4BAA4B,oKAM/B,CAAC;AAEX,eAAO,MAAM,4BAA4B,UAIxC,CAAC;AAEF,eAAO,MAAM,oCAAoC,oUAMvC,CAAC;AAEX,eAAO,MAAM,2BAA2B,sFAI9B,CAAC;AAEX,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAoChD,CAAC;AAEX,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAiB3F;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,CA2B3C"}

package/dist/cli/bootstrap-guide.js

@@ -40,6 +40,7 @@ export const BOOTSTRAP_SECTIONS = [
         summary: "Use one short direct-mode route: create the task, approve it, start it, verify it, and finish it.",
         commands: BOOTSTRAP_DIRECT_HAPPY_PATH_COMMANDS,
         notes: [
+            "Use `agentplane role ORCHESTRATOR` during planning, then switch to `agentplane role <OWNER>` before owner-scoped execution.",
             "Use `task doc set` to fill required README sections before approval.",
             "For dependent tasks, wait until upstream tasks are DONE before `task start-ready`.",
             "`task plan approve` and `task start-ready` must run sequentially, never in parallel.",

package/dist/cli/command-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAkGF,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAMvE;AAMD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAO,GAC/C,MAAM,GAAG,IAAI,CA6Bf;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAoCzC"}
+{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAmGF,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAMvE;AAMD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAO,GAC/C,MAAM,GAAG,IAAI,CA6Bf;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAoCzC"}