agentplane 0.3.16 → 0.3.17

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

@@ -0,0 +1,83 @@
+import { DOC_VERSION } from "../shared.js";
+import { appendCommentNotes as appendCommentNotesImpl, normalizeComments as normalizeCommentsImpl, } from "./comments.js";
+import { requestJson as requestRedmineJson } from "./client.js";
+import { appendCustomField as appendRedmineCustomField, customFieldValue as redmineCustomFieldValue, } from "./fields.js";
+import { issueToTask as issueToTaskImpl, taskToIssuePayload as taskToIssuePayloadImpl, } from "./mapping.js";
+import { maybeParseJson as maybeParseRedmineJson } from "./parse.js";
+import { findIssueByTaskId as findIssueByTaskIdImpl, listTasksRemote as listTasksRemoteImpl, } from "./remote.js";
+import { diffRedmineTasks, redmineTasksDiffer } from "./backend-report.js";
+import { redmineTaskIdFieldId } from "./runtime-state.js";
+export async function listRedmineRemoteTasks(host) {
+    const taskFieldId = redmineTaskIdFieldId(host);
+    return await listTasksRemoteImpl({
+        projectId: host.projectId,
+        taskFieldId,
+        issueCache: host.issueCache,
+        requestJson: async (method, reqPath, payload, params) => await host.requestJson(method, reqPath, payload, params),
+        customFieldValue: (issue, fieldId) => host.customFieldValue(issue, fieldId),
+        issueToTask: (issue, taskIdOverride) => host.issueToTask(issue, taskIdOverride),
+    });
+}
+export async function findRedmineIssueByTaskId(host, taskId) {
+    const taskFieldId = redmineTaskIdFieldId(host);
+    return await findIssueByTaskIdImpl({
+        taskId,
+        projectId: host.projectId,
+        taskFieldId,
+        issueCache: host.issueCache,
+        requestJson: async (method, reqPath, payload, params) => await host.requestJson(method, reqPath, payload, params),
+        customFieldValue: (issue, fieldId) => host.customFieldValue(issue, fieldId),
+        refreshList: async () => {
+            await host.listTasksRemote();
+        },
+    });
+}
+export function redmineIssueToTask(host, issue, taskIdOverride) {
+    return issueToTaskImpl({
+        issue,
+        taskIdOverride,
+        reverseStatus: host.reverseStatus,
+        customFields: host.customFields,
+        ownerAgent: host.ownerAgent,
+        defaultDocVersion: DOC_VERSION,
+    });
+}
+export function redmineTaskToIssuePayload(host, task, existingIssue) {
+    return taskToIssuePayloadImpl({
+        task,
+        existingIssue,
+        statusMap: host.statusMap,
+        assigneeId: host.assigneeId,
+        customFields: host.customFields,
+        appendCustomField: (fields, key, value) => appendRedmineBackendCustomField(host, fields, key, value),
+    });
+}
+export function appendRedmineBackendCustomField(host, fields, key, value) {
+    appendRedmineCustomField({ customFields: host.customFields, fields, key, value });
+}
+export function normalizeRedmineBackendComments(value) {
+    return normalizeCommentsImpl(value);
+}
+export async function appendRedmineBackendCommentNotes(host, issueId, existingComments, desiredComments) {
+    await appendCommentNotesImpl({
+        issueId,
+        existingComments,
+        desiredComments,
+        requestJson: async (method, reqPath, payload, params) => await requestRedmineBackendJson(host, method, reqPath, payload, params),
+    });
+}
+export function redmineBackendCustomFieldValue(issue, fieldId) {
+    return redmineCustomFieldValue(issue, fieldId);
+}
+export function maybeParseRedmineBackendJson(value) {
+    return maybeParseRedmineJson(value);
+}
+export function diffRedmineBackendTasks(localTask, remoteTask) {
+    return diffRedmineTasks(localTask, remoteTask);
+}
+export function redmineBackendTasksDiffer(localTask, remoteTask) {
+    return redmineTasksDiffer(localTask, remoteTask);
+}
+export async function requestRedmineBackendJson(host, method, reqPath, payload, params, opts) {
+    return await requestRedmineJson({ baseUrl: host.baseUrl, apiKey: host.apiKey }, method, reqPath, payload, params, opts);
+}

package/dist/backends/task-backend/redmine/runtime-state.d.ts

@@ -0,0 +1,10 @@
+import { type TaskData, type TaskDocMeta, type TaskWriteOptions } from "../shared.js";
+import type { RedmineBackendRuntimeHost } from "./runtime-context.js";
+export declare function ensureRedmineDocMetadata(task: TaskDocMeta): void;
+export declare function cacheRedmineTask(host: RedmineBackendRuntimeHost, task: TaskData, dirty: boolean): Promise<void>;
+export declare function assertRedmineExpectedRevisionSupported(host: RedmineBackendRuntimeHost, taskId: string, opts?: TaskWriteOptions): void;
+export declare function assertRedmineExpectedRevision(taskId: string, expectedRevision: number | undefined, currentRevision: number): void;
+export declare function redmineTaskIdFieldId(host: RedmineBackendRuntimeHost): unknown;
+export declare function setRedmineIssueCustomField(issue: Record<string, unknown>, fieldId: unknown, value: unknown): void;
+export declare function coerceRedmineBackendDocVersion(value: unknown): 2 | 3 | null;
+//# sourceMappingURL=runtime-state.d.ts.map

package/dist/backends/task-backend/redmine/runtime-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAKhE;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,gBAAgB,GACtB,IAAI,CAON;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,eAAe,EAAE,MAAM,GACtB,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAO7E;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,GACb,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAG3E"}

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

@@ -0,0 +1,45 @@
+import { DEFAULT_DOC_UPDATED_BY, BackendError, normalizeDocVersion, nowIso, redmineConfigMissingEnvMessage, } from "../shared.js";
+import { setIssueCustomFieldValue as setRedmineIssueCustomFieldValue } from "./fields.js";
+export function ensureRedmineDocMetadata(task) {
+    if (task.doc === undefined)
+        return;
+    task.doc_version = normalizeDocVersion(task.doc_version);
+    task.doc_updated_at ??= nowIso();
+    task.doc_updated_by ??= DEFAULT_DOC_UPDATED_BY;
+}
+export async function cacheRedmineTask(host, task, dirty) {
+    if (!host.cache)
+        return;
+    const next = { ...task, dirty };
+    await host.cache.writeTask(next);
+}
+export function assertRedmineExpectedRevisionSupported(host, taskId, opts) {
+    if (opts?.expectedRevision === undefined)
+        return;
+    if (host.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");
+}
+export function assertRedmineExpectedRevision(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");
+}
+export function redmineTaskIdFieldId(host) {
+    const fieldId = host.customFields?.task_id;
+    if (fieldId)
+        return fieldId;
+    throw new BackendError(redmineConfigMissingEnvMessage("AGENTPLANE_REDMINE_CUSTOM_FIELDS_TASK_ID"), "E_BACKEND");
+}
+export function setRedmineIssueCustomField(issue, fieldId, value) {
+    setRedmineIssueCustomFieldValue(issue, fieldId, value);
+}
+export function coerceRedmineBackendDocVersion(value) {
+    if (value === 2 || value === 3)
+        return value;
+    return null;
+}

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

@@ -2,5 +2,5 @@ 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: TaskDocVersion;
-export declare const SUPPORTED_DOC_VERSIONS: readonly [2, 3];
+export declare const SUPPORTED_DOC_VERSIONS: readonly [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":"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"}
+{"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,cAAe,CAAC"}

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

@@ -2,4 +2,4 @@ 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 = 3;
-export const SUPPORTED_DOC_VERSIONS = [2, 3];
+export const SUPPORTED_DOC_VERSIONS = [3];

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

@@ -5,10 +5,6 @@ export type TaskIndexEntry = {
     readmePath: string;
     mtimeMs: number;
 };
-export type TaskIndexFileV1 = {
-    schema_version: 1;
-    tasks: TaskIndexEntry[];
-};
 export type TaskIndexFileV2 = {
     schema_version: 2;
     byId: Record<string, TaskIndexEntry>;

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,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAI3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,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;AA+ED,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,CAgBhB"}
+{"version":3,"file":"task-index.d.ts","sourceRoot":"","sources":["../../src/backends/task-index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAG3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,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;AAsDD,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAIpF;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,CAgBhB"}

package/dist/backends/task-index.js

@@ -3,7 +3,6 @@ import path from "node:path";
 import { writeJsonStableIfChanged } from "../shared/write-if-changed.js";
 export const TASK_INDEX_SCHEMA_VERSION = 2;
 const TASK_INDEX_FILENAME = "tasks-index.v2.json";
-const LEGACY_TASK_INDEX_FILENAME = "tasks-index.v1.json";
 export function resolveTaskIndexPath(tasksDir) {
     const normalized = path.normalize(tasksDir);
     const parts = normalized.split(path.sep);
@@ -18,11 +17,6 @@ export function resolveTaskIndexPath(tasksDir) {
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);
 }
-function resolveLegacyIndexPath(indexPath) {
-    // Best-effort migration path: when upgrading from v1->v2, the v1 file may still exist.
-    const dir = path.dirname(indexPath);
-    return path.join(dir, LEGACY_TASK_INDEX_FILENAME);
-}
 function isTaskIndexEntry(value) {
     if (!isRecord(value))
         return false;
@@ -53,18 +47,6 @@ function isTaskIndexEntry(value) {
         return false;
     return true;
 }
-function toV2FromEntries(entries) {
-    const byId = {};
-    const byPath = {};
-    for (const entry of entries) {
-        const id = entry.task.id;
-        if (typeof id !== "string" || !id.trim())
-            continue;
-        byId[id] = entry;
-        byPath[entry.readmePath] = id;
-    }
-    return { schema_version: 2, byId, byPath };
-}
 function isTaskIndexFileV2(value) {
     if (!isRecord(value))
         return false;
@@ -85,15 +67,6 @@ function isTaskIndexFileV2(value) {
     }
     return true;
 }
-function isTaskIndexFileV1(value) {
-    if (!isRecord(value))
-        return false;
-    if (value.schema_version !== 1)
-        return false;
-    if (!Array.isArray(value.tasks))
-        return false;
-    return true;
-}
 async function readJsonFile(p) {
     let raw = "";
     try {
@@ -113,12 +86,6 @@ export async function loadTaskIndex(indexPath) {
     const v2 = await readJsonFile(indexPath);
     if (v2 && isTaskIndexFileV2(v2))
         return v2;
-    const legacyPath = resolveLegacyIndexPath(indexPath);
-    const v1 = await readJsonFile(legacyPath);
-    if (v1 && isTaskIndexFileV1(v1)) {
-        const entries = v1.tasks.filter((entry) => isTaskIndexEntry(entry));
-        return toV2FromEntries(entries);
-    }
     return null;
 }
 export async function saveTaskIndex(indexPath, index) {

package/dist/cli/exit-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE/E,oBAAY,QAAQ;IAClB,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,UAAU,IAAI;IACd,EAAE,IAAI;IACN,GAAG,IAAI;IACP,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;CACZ;AAED,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAU/D,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAE1D"}
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE/E,oBAAY,QAAQ;IAClB,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,UAAU,IAAI;IACd,EAAE,IAAI;IACN,GAAG,IAAI;IACP,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;CACZ;AAED,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAW/D,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAE1D"}

package/dist/cli/exit-codes.js

@@ -13,6 +13,7 @@ export var ExitCode;
 })(ExitCode || (ExitCode = {}));
 export const ERROR_TO_EXIT = {
     E_USAGE: DEFAULT_ERROR_EXIT_CODES.E_USAGE,
+    E_DEPRECATED_FLAG: DEFAULT_ERROR_EXIT_CODES.E_DEPRECATED_FLAG,
     E_VALIDATION: DEFAULT_ERROR_EXIT_CODES.E_VALIDATION,
     E_IO: DEFAULT_ERROR_EXIT_CODES.E_IO,
     E_GIT: DEFAULT_ERROR_EXIT_CODES.E_GIT,

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

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/cli/http.ts"],"names":[],"mappings":"AAWA,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,SAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,SAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,SAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,CAkCf"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/cli/http.ts"],"names":[],"mappings":"AA+CA,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,SAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,SAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,SAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/cli/http.js

@@ -4,16 +4,46 @@ import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { exitCodeForError } from "./exit-codes.js";
 import { CliError } from "../shared/errors.js";
-const DEFAULT_FETCH_TIMEOUT_MS = 1500;
+const DEFAULT_FETCH_TIMEOUT_MS = 5000;
 const DEFAULT_DOWNLOAD_TIMEOUT_MS = 30_000;
-export async function fetchJson(url, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+const FETCH_ATTEMPTS = 2;
+const FETCH_RETRY_BACKOFF_MS = 100;
+function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+async function fetchWithTimeout(url, timeoutMs) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), timeoutMs);
     try {
-        const res = await fetch(url, {
+        return await fetch(url, {
             headers: { "User-Agent": "agentplane" },
             signal: controller.signal,
         });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function fetchWithRetry(url, timeoutMs) {
+    let lastError;
+    for (let attempt = 1; attempt <= FETCH_ATTEMPTS; attempt += 1) {
+        try {
+            return await fetchWithTimeout(url, timeoutMs);
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt < FETCH_ATTEMPTS) {
+                await delay(FETCH_RETRY_BACKOFF_MS * attempt);
+            }
+        }
+    }
+    throw lastError;
+}
+export async function fetchJson(url, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    try {
+        const res = await fetchWithRetry(url, timeoutMs);
         if (!res.ok) {
             throw new CliError({
                 exitCode: exitCodeForError("E_NETWORK"),
@@ -32,18 +62,10 @@ export async function fetchJson(url, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
             message: `Failed to fetch ${url}`,
         });
     }
-    finally {
-        clearTimeout(timeout);
-    }
 }
 export async function fetchText(url, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), timeoutMs);
     try {
-        const res = await fetch(url, {
-            headers: { "User-Agent": "agentplane" },
-            signal: controller.signal,
-        });
+        const res = await fetchWithRetry(url, timeoutMs);
         if (!res.ok) {
             throw new CliError({
                 exitCode: exitCodeForError("E_NETWORK"),
@@ -62,9 +84,6 @@ export async function fetchText(url, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
             message: `Failed to fetch ${url}`,
         });
     }
-    finally {
-        clearTimeout(timeout);
-    }
 }
 export async function downloadToFile(url, destPath, timeoutMs = DEFAULT_DOWNLOAD_TIMEOUT_MS) {
     const controller = new AbortController();

package/dist/cli/run-cli/command-loaders.d.ts

@@ -67,11 +67,7 @@ export declare const fromCommandsTaskVerifyCommand: <TParsed>(spec: import("../s
 export declare const fromCommandsTaskResumeContextCommand: <TParsed>(spec: import("../spec/spec.js").CommandSpec<TParsed>, runExport: "taskResumeContextSpec" | "runTaskResumeContext", meta?: import("./command-catalog/shared.js").CommandMeta) => import("./command-catalog/shared.js").CommandEntry;
 export declare const fromTaskHandoffShowSpec: <TParsed>(spec: import("../spec/spec.js").CommandSpec<TParsed>, runExport: "taskHandoffShowSpec" | "runTaskHandoffShow", meta?: import("./command-catalog/shared.js").CommandMeta) => import("./command-catalog/shared.js").CommandEntry;
 export declare const loadTaskHostedCloseSpec: (deps: RunDeps) => Promise<(ctx: import("../spec/spec.js").CommandCtx, parsed: import("../../commands/task/hosted-close.command.js").TaskHostedCloseParsed) => Promise<number>>;
-export declare const loadTaskHostedClosePrSpec: (deps: RunDeps) => Promise<(ctx: import("../spec/spec.js").CommandCtx, p: {
-    taskIds: string[];
-    branch: string | null;
-    repo: string | null;
-}) => Promise<number>>;
+export declare const loadTaskHostedClosePrSpec: (deps: RunDeps) => Promise<(ctx: import("../spec/spec.js").CommandCtx, p: import("../../commands/task/hosted-close-pr.types.js").TaskHostedClosePrParsed) => Promise<number>>;
 export declare const loadTaskListSpec: (deps: RunDeps) => Promise<(ctx: import("../spec/spec.js").CommandCtx, p: import("../../commands/task/list.spec.js").TaskListParsed) => Promise<number>>;
 export declare const loadTaskNextSpec: (deps: RunDeps) => Promise<(ctx: import("../spec/spec.js").CommandCtx, p: import("../../commands/task/next.spec.js").TaskNextParsed) => Promise<number>>;
 export declare const loadTaskSearchSpec: (deps: RunDeps) => Promise<(ctx: import("../spec/spec.js").CommandCtx, p: import("../../commands/task/search.spec.js").TaskSearchParsed) => Promise<number>>;

package/dist/cli/run-cli/command-loaders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-loaders.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-loaders.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-loaders.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-loaders.ts"],"names":[],"mappings":"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"}

package/dist/cli/spec/errors.d.ts

@@ -18,4 +18,9 @@ export declare function usageError(opts: {
     command?: string;
     context?: Record<string, unknown>;
 }): CliError;
+export declare function deprecatedFlagError(opts: {
+    option: string;
+    deprecated: string;
+    spec?: CommandSpec<unknown>;
+}): CliError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/cli/spec/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,QAAQ,CAcX"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,QAAQ,CAcX;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC7B,GAAG,QAAQ,CAgBX"}

package/dist/cli/spec/errors.js

@@ -1,4 +1,4 @@
-import { UsageError } from "../../shared/errors.js";
+import { DeprecatedFlagError, UsageError } from "../../shared/errors.js";
 import { renderCommandHelpText } from "./help-render.js";
 /**
  * Usage-error helpers for command-spec parsing/rendering only.
@@ -26,3 +26,16 @@ export function usageError(opts) {
         context: Object.keys(context).length > 0 ? context : undefined,
     });
 }
+export function deprecatedFlagError(opts) {
+    const command = opts.spec ? opts.spec.id.join(" ") : undefined;
+    const usage = opts.spec && renderCommandHelpText(opts.spec, { compact: true, includeHeader: false });
+    const fullMessage = `Deprecated option ${opts.option} is ${opts.deprecated}; remove it or use the documented replacement.${usage ? `\n\n${usage}` : ""}`;
+    return new DeprecatedFlagError({
+        message: fullMessage,
+        context: {
+            option: opts.option,
+            deprecated: opts.deprecated,
+            ...(command ? { command } : {}),
+        },
+    });
+}

package/dist/cli/spec/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,SAAS,EAAE,MAAM,WAAW,CAAC;AAIpE,KAAK,aAAa,CAAC,OAAO,IAAI;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AA6EF,wBAAgB,gBAAgB,CAAC,OAAO,EACtC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,aAAa,CAAC,OAAO,CAAC,CAiIxB"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,SAAS,EAAE,MAAM,WAAW,CAAC;AAIpE,KAAK,aAAa,CAAC,OAAO,IAAI;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAkFF,wBAAgB,gBAAgB,CAAC,OAAO,EACtC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,aAAa,CAAC,OAAO,CAAC,CAmIxB"}

package/dist/cli/spec/parse.js

@@ -1,5 +1,5 @@
 import { suggestOne } from "./suggest.js";
-import { usageError } from "./errors.js";
+import { deprecatedFlagError, usageError } from "./errors.js";
 function isOptionToken(tok) {
     return tok.startsWith("-") && tok !== "-";
 }
@@ -67,6 +67,11 @@ function normalizeForValidation(opt, rawValue) {
     const coerced = opt.coerce(rawValue);
     return typeof coerced === "string" ? coerced : rawValue;
 }
+function assertNotDeprecated(spec, opt, token) {
+    if (!opt.deprecated)
+        return;
+    throw deprecatedFlagError({ spec, option: token, deprecated: opt.deprecated });
+}
 export function parseCommandArgv(spec, argv) {
     const { byLong, byShort, candidates } = indexOptions(spec);
     const raw = { args: {}, opts: {}, extra: [] };
@@ -93,6 +98,7 @@ export function parseCommandArgv(spec, argv) {
                 const suffix = sugg ? ` Did you mean ${sugg}?` : "";
                 throw usageError({ spec, message: `Unknown option: ${head}.${suffix}` });
             }
+            assertNotDeprecated(spec, opt, head);
             if (opt.kind === "boolean") {
                 if (eq === -1) {
                     setOpt(raw, opt, true);
@@ -118,6 +124,7 @@ export function parseCommandArgv(spec, argv) {
             const suffix = sugg ? ` Did you mean ${sugg}?` : "";
             throw usageError({ spec, message: `Unknown option: ${tok}.${suffix}` });
         }
+        assertNotDeprecated(spec, opt, tok);
         if (opt.kind === "boolean") {
             setOpt(raw, opt, true);
             continue;

package/dist/commands/branch/work-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work-start.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.ts"],"names":[],"mappings":"AA0BA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAsRnC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+JlB"}
+{"version":3,"file":"work-start.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAmBnC,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+JlB"}

package/dist/commands/branch/work-start.direct.d.ts

@@ -0,0 +1,13 @@
+type DirectWorkLock = {
+    task_id: string;
+    agent: string;
+    slug: string;
+    branch: string;
+    started_at: string;
+};
+export declare function directWorkLockPath(agentplaneDir: string): string;
+export declare function readDirectWorkLock(agentplaneDir: string): Promise<DirectWorkLock | null>;
+export declare function writeDirectWorkLock(agentplaneDir: string, lock: DirectWorkLock): Promise<void>;
+export declare function ensureGitClean(gitRoot: string): Promise<void>;
+export {};
+//# sourceMappingURL=work-start.direct.d.ts.map

package/dist/commands/branch/work-start.direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.direct.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.direct.ts"],"names":[],"mappings":"AAOA,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkB9F;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCnE"}

package/dist/commands/branch/work-start.direct.js

@@ -0,0 +1,75 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { execFileAsync, gitEnv } from "../shared/git.js";
+export function directWorkLockPath(agentplaneDir) {
+    // Intentionally under cache/ so it stays out of git by default.
+    return path.join(agentplaneDir, "cache", "direct-work.json");
+}
+export async function readDirectWorkLock(agentplaneDir) {
+    try {
+        const text = await readFile(directWorkLockPath(agentplaneDir), "utf8");
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        if (typeof parsed.task_id !== "string" ||
+            typeof parsed.agent !== "string" ||
+            typeof parsed.slug !== "string" ||
+            typeof parsed.branch !== "string" ||
+            typeof parsed.started_at !== "string") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeDirectWorkLock(agentplaneDir, lock) {
+    const dir = path.dirname(directWorkLockPath(agentplaneDir));
+    await mkdir(dir, { recursive: true });
+    await writeFile(directWorkLockPath(agentplaneDir), JSON.stringify(lock, null, 2) + "\n", "utf8");
+}
+export async function ensureGitClean(gitRoot) {
+    const { stdout } = await execFileAsync("git", ["status", "--porcelain"], {
+        cwd: gitRoot,
+        env: gitEnv(),
+    });
+    const lines = stdout
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .filter((line) => line.trim().length > 0);
+    if (lines.length === 0)
+        return;
+    // Allow task workflow artifacts to be dirty. In direct mode we want a single-stream
+    // workflow without task branches, but we still expect task docs to change.
+    const allowedPrefixes = [
+        ".agentplane/tasks/",
+        ".agentplane/tasks.json",
+        ".agentplane/cache/",
+        ".agentplane/.upgrade/",
+        ".agentplane/upgrade/",
+    ];
+    const isAllowed = (p) => allowedPrefixes.some((prefix) => p.startsWith(prefix));
+    const dirty = lines
+        .map((line) => {
+        // Format: XY <path> (we only need the path-ish tail).
+        const rest = line.slice(2).trim();
+        if (!rest)
+            return "";
+        // Rename/copy format: "old -> new"
+        const arrow = rest.lastIndexOf(" -> ");
+        if (arrow === -1)
+            return rest;
+        return rest.slice(arrow + 4).trim();
+    })
+        .filter((p) => p.length > 0 && !isAllowed(p));
+    if (dirty.length === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: "Working tree has non-task changes. In workflow_mode=direct, agentplane runs tasks in a single stream on the current branch; commit/stash your changes before starting a different task.",
+    });
+}

package/dist/commands/branch/work-start.git.d.ts

@@ -0,0 +1,3 @@
+export { resolveBaseBranch } from "@agentplaneorg/core";
+export declare function ensureCurrentBaseBranch(gitRoot: string, baseBranch: string): Promise<void>;
+//# sourceMappingURL=work-start.git.d.ts.map

package/dist/commands/branch/work-start.git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.git.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.git.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchG"}

package/dist/commands/branch/work-start.git.js

@@ -0,0 +1,19 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { CliError } from "../../shared/errors.js";
+import { gitAheadBehind } from "../shared/git-diff.js";
+import { gitBranchUpstream } from "../shared/git-ops.js";
+export { resolveBaseBranch } from "@agentplaneorg/core";
+export async function ensureCurrentBaseBranch(gitRoot, baseBranch) {
+    const upstreamBranch = await gitBranchUpstream(gitRoot, baseBranch);
+    if (!upstreamBranch)
+        return;
+    const { behind } = await gitAheadBehind(gitRoot, upstreamBranch, baseBranch);
+    if (behind === 0)
+        return;
+    throw new CliError({
+        exitCode: exitCodeForError("E_GIT"),
+        code: "E_GIT",
+        message: `Base branch ${baseBranch} is behind its upstream ${upstreamBranch} by ${behind} commit(s). ` +
+            "Refresh the base branch before `agentplane work start` to avoid DIRTY hosted PRs.",
+    });
+}

package/dist/commands/branch/work-start.hook-shim.d.ts

@@ -0,0 +1,2 @@
+export declare function materializeHookShimForWorktree(worktreePath: string): Promise<void>;
+//# sourceMappingURL=work-start.hook-shim.d.ts.map

package/dist/commands/branch/work-start.hook-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-start.hook-shim.d.ts","sourceRoot":"","sources":["../../../src/commands/branch/work-start.hook-shim.ts"],"names":[],"mappings":"AAkCA,wBAAsB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxF"}