agentplane 0.3.6 → 0.3.8

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

@@ -0,0 +1,43 @@
+import { canonicalizeJson } from "@agentplaneorg/core";
+import { detectConfiguredFieldNameDrift, inferVisibleCanonicalStateFieldId, inspectVisibleCustomFields, } from "./inspect.js";
+export async function inspectRedmineConfiguration(context) {
+    const visibleCustomFields = await inspectVisibleCustomFields({
+        projectId: context.projectId,
+        requestJson: async (method, reqPath, payload, params) => await context.requestJson(method, reqPath, payload, params),
+    });
+    const visibleCanonicalStateFieldId = inferVisibleCanonicalStateFieldId(visibleCustomFields);
+    return {
+        backendId: "redmine",
+        visibleCustomFields,
+        canonicalState: {
+            configuredFieldId: typeof context.customFields.canonical_state === "number"
+                ? context.customFields.canonical_state
+                : null,
+            visibleFieldId: visibleCanonicalStateFieldId,
+        },
+        configuredFieldNameDrift: detectConfiguredFieldNameDrift({
+            configuredFields: context.customFields,
+            visibleFields: visibleCustomFields,
+        }),
+    };
+}
+export function diffRedmineTasks(localTask, remoteTask) {
+    const localText = JSON.stringify(canonicalizeJson(localTask), null, 2).split("\n");
+    const remoteText = JSON.stringify(canonicalizeJson(remoteTask), null, 2).split("\n");
+    const diff = ["--- remote", "+++ local"];
+    const max = Math.max(localText.length, remoteText.length);
+    for (let i = 0; i < max; i++) {
+        const localLine = localText[i];
+        const remoteLine = remoteText[i];
+        if (localLine === remoteLine)
+            continue;
+        if (remoteLine !== undefined)
+            diff.push(`- ${remoteLine}`);
+        if (localLine !== undefined)
+            diff.push(`+ ${localLine}`);
+    }
+    return diff.join("\n");
+}
+export function redmineTasksDiffer(localTask, remoteTask) {
+    return (JSON.stringify(canonicalizeJson(localTask)) !== JSON.stringify(canonicalizeJson(remoteTask)));
+}

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

@@ -0,0 +1,67 @@
+import { type TaskCanonicalStateMigrationResult, type TaskData, type TaskDocMeta, type TaskWriteOptions } from "../shared.js";
+import { type TaskComment } from "./comments.js";
+type RedmineCachePort = {
+    listTasks: () => Promise<TaskData[]>;
+    writeTask: (task: TaskData, opts?: TaskWriteOptions) => Promise<void>;
+};
+export type RedmineSyncContext = {
+    cache: RedmineCachePort | null;
+    customFields: Record<string, unknown>;
+    ownerAgent: string;
+    projectId: string;
+    batchSize: number;
+    batchPauseMs: number;
+    statusMap: Record<string, unknown>;
+    issueCache: Map<string, Record<string, unknown>>;
+    inferredStatusByTaskStatus: Map<string, number> | null;
+    setInferredStatusByTaskStatus: (next: Map<string, number> | null) => void;
+    listTasksRemote: () => Promise<TaskData[]>;
+    writeTask: (task: TaskData, opts?: TaskWriteOptions) => Promise<void>;
+    writeTasks: (tasks: TaskData[], opts?: TaskWriteOptions) => Promise<void>;
+    findIssueByTaskId: (taskId: string) => Promise<Record<string, unknown> | null>;
+    issueToTask: (issue: Record<string, unknown>, taskIdOverride?: string) => TaskData | null;
+    taskToIssuePayload: (task: TaskData, existingIssue?: Record<string, unknown>) => Record<string, unknown>;
+    appendCustomField: (fields: Record<string, unknown>[], key: string, value: unknown) => void;
+    customFieldValue: (issue: Record<string, unknown>, fieldId: unknown) => string | null;
+    maybeParseJson: (value: unknown) => unknown;
+    normalizeComments: (value: unknown) => TaskComment[];
+    appendCommentNotes: (issueId: string, existingComments: TaskComment[], desiredComments: TaskComment[]) => Promise<void>;
+    cacheTask: (task: TaskData, dirty: boolean) => Promise<void>;
+    assertExpectedRevisionSupported: (taskId: string, opts?: TaskWriteOptions) => void;
+    assertExpectedRevision: (taskId: string, expectedRevision: number | undefined, currentRevision: number) => void;
+    ensureDocMetadata: (task: TaskDocMeta) => void;
+    diffTasks: (localTask: TaskData, remoteTask: TaskData) => string;
+    tasksDiffer: (localTask: TaskData, remoteTask: TaskData) => boolean;
+    taskIdFieldId: () => unknown;
+    setIssueCustomFieldValue: (issue: Record<string, unknown>, fieldId: unknown, value: unknown) => void;
+    requestJson: (method: string, reqPath: string, payload?: Record<string, unknown>, params?: Record<string, unknown>, opts?: {
+        attempts?: number;
+        backoff?: number;
+    }) => Promise<Record<string, unknown>>;
+};
+export declare function generateRedmineTaskId(context: RedmineSyncContext, opts: {
+    length: number;
+    attempts: number;
+}): Promise<string>;
+export declare function migrateRedmineCanonicalState(context: RedmineSyncContext): Promise<TaskCanonicalStateMigrationResult>;
+export declare function writeRedmineTask(context: RedmineSyncContext, task: TaskData, opts?: TaskWriteOptions): Promise<void>;
+export declare function writeRedmineTasks(context: RedmineSyncContext, tasks: TaskData[], opts?: TaskWriteOptions): Promise<void>;
+export declare function syncRedmine(context: RedmineSyncContext, opts: {
+    direction: "push" | "pull";
+    conflict: "diff" | "prefer-local" | "prefer-remote" | "fail";
+    quiet: boolean;
+    confirm: boolean;
+}): Promise<void>;
+export declare function syncPushRedmine(context: RedmineSyncContext, quiet: boolean, confirm: boolean): Promise<void>;
+export declare function syncPullRedmine(context: RedmineSyncContext, conflict: "diff" | "prefer-local" | "prefer-remote" | "fail", quiet: boolean): Promise<void>;
+export declare function handleRedmineConflict(context: RedmineSyncContext, taskId: string, localTask: TaskData, remoteTask: TaskData, conflict: "diff" | "prefer-local" | "prefer-remote" | "fail"): Promise<void>;
+export declare function inferRedmineStatusIdForTaskStatus(context: RedmineSyncContext, statusRaw: unknown): Promise<number | null>;
+export declare function loadRedmineInferredStatusByTaskStatus(context: RedmineSyncContext): Promise<Map<string, number>>;
+export declare function selectRedmineInferredStatus(statuses: {
+    id: number;
+    name: string;
+    isClosed: boolean;
+    isDefault: boolean;
+}[], target: "TODO" | "DOING" | "DONE"): number | null;
+export {};
+//# sourceMappingURL=backend-sync.d.ts.map

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

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

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

@@ -0,0 +1,367 @@
+import { taskDocToSectionMap } from "@agentplaneorg/core";
+import { BackendError, RedmineUnavailable, generateTaskId, missingTaskIdMessage, redmineConfigMissingEnvMessage, redmineIssueIdMissingMessage, sleep, toStringSafe, validateTaskId, } from "../shared.js";
+import { buildRedmineCanonicalStateWithOptions, parseRedmineCanonicalState } from "./state.js";
+function revisionNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function issueFromPayload(payload) {
+    return payload.issue && typeof payload.issue === "object" && !Array.isArray(payload.issue)
+        ? payload.issue
+        : null;
+}
+export async function generateRedmineTaskId(context, opts) {
+    let existingIds = new Set();
+    try {
+        const tasks = await context.listTasksRemote();
+        existingIds = new Set(tasks.map((task) => toStringSafe(task.id)).filter(Boolean));
+    }
+    catch (err) {
+        if (!(err instanceof RedmineUnavailable))
+            throw err;
+        if (!context.cache)
+            throw err;
+        const cached = await context.cache.listTasks();
+        existingIds = new Set(cached.map((task) => toStringSafe(task.id)).filter(Boolean));
+    }
+    return await generateTaskId({
+        length: opts.length,
+        attempts: opts.attempts,
+        isAvailable: (taskId) => !existingIds.has(taskId),
+    });
+}
+export async function migrateRedmineCanonicalState(context) {
+    if (!context.customFields.canonical_state) {
+        throw new BackendError(redmineConfigMissingEnvMessage("AGENTPLANE_REDMINE_CUSTOM_FIELDS_CANONICAL_STATE"), "E_BACKEND");
+    }
+    const tasks = await context.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 = context.issueCache.get(taskId);
+        if (!issue) {
+            result.failed.push({
+                taskId,
+                reason: "Redmine issue payload was not cached during remote list refresh",
+            });
+            continue;
+        }
+        const currentState = parseRedmineCanonicalState(context.customFieldValue(issue, context.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 nextRevision = Math.max(revisionNumber(task.revision), 0, 1);
+        const nextCanonicalState = buildRedmineCanonicalStateWithOptions({
+            ...task,
+            sections,
+            revision: nextRevision,
+        }, { base: currentState, revision: nextRevision });
+        if (!nextCanonicalState) {
+            result.skippedNoDoc.push(taskId);
+            continue;
+        }
+        const customFields = [];
+        context.appendCustomField(customFields, "canonical_state", nextCanonicalState);
+        try {
+            await context.requestJson("PUT", `issues/${issueIdText}.json`, {
+                issue: { custom_fields: customFields },
+            });
+            context.setIssueCustomFieldValue(issue, context.customFields.canonical_state, nextCanonicalState);
+            context.issueCache.set(taskId, issue);
+            await context.cacheTask({
+                ...task,
+                sections,
+                revision: nextRevision,
+                dirty: false,
+            }, false);
+            result.migrated.push(taskId);
+        }
+        catch (err) {
+            result.failed.push({
+                taskId,
+                reason: err instanceof Error ? err.message : "Unknown Redmine canonical_state migration failure",
+            });
+        }
+        if (context.batchPauseMs > 0 &&
+            context.batchSize > 0 &&
+            (index + 1) % context.batchSize === 0) {
+            await sleep(context.batchPauseMs);
+        }
+    }
+    return result;
+}
+export async function writeRedmineTask(context, task, opts) {
+    const taskId = toStringSafe(task.id).trim();
+    if (!taskId)
+        throw new Error(missingTaskIdMessage());
+    validateTaskId(taskId);
+    try {
+        context.ensureDocMetadata(task);
+        let issue = await context.findIssueByTaskId(taskId);
+        let issueId = issue?.id;
+        let issueIdText = issueId ? toStringSafe(issueId) : "";
+        let existingIssue = issue ?? null;
+        if (issueIdText && !existingIssue) {
+            const payload = await context.requestJson("GET", `issues/${issueIdText}.json`);
+            existingIssue = issueFromPayload(payload);
+        }
+        const currentState = existingIssue && context.customFields.canonical_state
+            ? parseRedmineCanonicalState(context.customFieldValue(existingIssue, context.customFields.canonical_state))
+            : null;
+        context.assertExpectedRevisionSupported(taskId, opts);
+        context.assertExpectedRevision(taskId, opts?.expectedRevision, currentState?.revision ?? 0);
+        const nextRevision = issueIdText
+            ? Math.max(revisionNumber(task.revision), revisionNumber(currentState?.revision), 0) + 1
+            : Math.max(revisionNumber(task.revision), revisionNumber(currentState?.revision), 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 = context.taskToIssuePayload(taskForWrite, existingIssue ?? undefined);
+        if (payload.status_id === undefined) {
+            const inferredStatusId = await inferRedmineStatusIdForTaskStatus(context, taskForWrite.status);
+            if (inferredStatusId !== null)
+                payload.status_id = inferredStatusId;
+        }
+        if (issueIdText) {
+            await context.requestJson("PUT", `issues/${issueIdText}.json`, { issue: payload });
+        }
+        else {
+            const createPayload = { ...payload, project_id: context.projectId };
+            const created = await context.requestJson("POST", "issues.json", { issue: createPayload });
+            const createdIssue = issueFromPayload(created);
+            issueId = createdIssue?.id;
+            issueIdText = issueId ? toStringSafe(issueId) : "";
+            if (issueIdText) {
+                const updatePayload = { ...payload };
+                delete updatePayload.project_id;
+                await context.requestJson("PUT", `issues/${issueIdText}.json`, { issue: updatePayload });
+                const refreshed = await context.requestJson("GET", `issues/${issueIdText}.json`);
+                existingIssue = issueFromPayload(refreshed);
+            }
+        }
+        if (issueIdText) {
+            const existingComments = existingIssue && context.customFields.comments
+                ? context.normalizeComments(context.maybeParseJson(context.customFieldValue(existingIssue, context.customFields.comments)))
+                : [];
+            const desiredComments = context.normalizeComments(taskForWrite.comments);
+            await context.appendCommentNotes(issueIdText, existingComments, desiredComments);
+        }
+        taskForWrite.dirty = false;
+        await context.cacheTask(taskForWrite, false);
+        context.issueCache.clear();
+    }
+    catch (err) {
+        if (!(err instanceof RedmineUnavailable))
+            throw err;
+        if (!context.cache)
+            throw err;
+        context.assertExpectedRevisionSupported(taskId, opts);
+        const taskForCache = {
+            ...task,
+            revision: Math.max(revisionNumber(task.revision), 1),
+            sections: task.sections && Object.keys(task.sections).length > 0
+                ? task.sections
+                : task.doc
+                    ? taskDocToSectionMap(task.doc)
+                    : undefined,
+            dirty: true,
+        };
+        await context.cache.writeTask(taskForCache, opts);
+    }
+}
+export async function writeRedmineTasks(context, tasks, opts) {
+    for (const [index, task] of tasks.entries()) {
+        await context.writeTask(task, opts);
+        if (context.batchPauseMs > 0 &&
+            context.batchSize > 0 &&
+            (index + 1) % context.batchSize === 0) {
+            await sleep(context.batchPauseMs);
+        }
+    }
+}
+export async function syncRedmine(context, opts) {
+    if (opts.direction === "push") {
+        await syncPushRedmine(context, opts.quiet, opts.confirm);
+        return;
+    }
+    if (opts.direction === "pull") {
+        await syncPullRedmine(context, opts.conflict, opts.quiet);
+        return;
+    }
+    throw new BackendError("Invalid sync direction (expected push|pull)", "E_BACKEND");
+}
+export async function syncPushRedmine(context, quiet, confirm) {
+    if (!context.cache) {
+        throw new BackendError("Redmine cache is disabled; sync push is unavailable", "E_BACKEND");
+    }
+    const tasks = await context.cache.listTasks();
+    const dirty = tasks.filter((task) => task.dirty);
+    if (dirty.length === 0) {
+        if (!quiet)
+            process.stdout.write("ℹ️ no local task changes to push\n");
+        return;
+    }
+    if (!confirm) {
+        for (const task of dirty) {
+            process.stdout.write(`- pending push: ${task.id}\n`);
+        }
+        throw new BackendError("Refusing to push without --yes (preview above)", "E_BACKEND");
+    }
+    await context.writeTasks(dirty);
+    if (!quiet)
+        process.stdout.write(`✅ pushed ${dirty.length} task(s) (dirty)\n`);
+}
+export async function syncPullRedmine(context, conflict, quiet) {
+    if (!context.cache) {
+        throw new BackendError("Redmine cache is disabled; sync pull is unavailable", "E_BACKEND");
+    }
+    const remoteTasks = await context.listTasksRemote();
+    const remoteById = new Map();
+    for (const task of remoteTasks) {
+        const taskId = toStringSafe(task.id);
+        if (taskId)
+            remoteById.set(taskId, task);
+    }
+    const localTasks = await context.cache.listTasks();
+    const localById = new Map();
+    for (const task of localTasks) {
+        const taskId = toStringSafe(task.id);
+        if (taskId)
+            localById.set(taskId, task);
+    }
+    for (const [taskId, remoteTask] of remoteById.entries()) {
+        const localTask = localById.get(taskId);
+        if (localTask?.dirty) {
+            if (context.tasksDiffer(localTask, remoteTask)) {
+                await handleRedmineConflict(context, taskId, localTask, remoteTask, conflict);
+                continue;
+            }
+            localTask.dirty = false;
+            await context.cacheTask(localTask, false);
+            continue;
+        }
+        await context.cacheTask(remoteTask, false);
+    }
+    if (!quiet)
+        process.stdout.write(`✅ pulled ${remoteById.size} task(s) (remote)\n`);
+}
+export async function handleRedmineConflict(context, taskId, localTask, remoteTask, conflict) {
+    if (conflict === "prefer-local") {
+        await context.writeTask(localTask);
+        return;
+    }
+    if (conflict === "prefer-remote") {
+        await context.cacheTask(remoteTask, false);
+        return;
+    }
+    if (conflict === "diff") {
+        process.stdout.write(`${context.diffTasks(localTask, remoteTask)}\n`);
+        throw new BackendError(`Conflict detected for ${taskId}`, "E_BACKEND");
+    }
+    throw new BackendError(`Conflict detected for ${taskId}`, "E_BACKEND");
+}
+export async function inferRedmineStatusIdForTaskStatus(context, statusRaw) {
+    const status = toStringSafe(statusRaw).trim().toUpperCase();
+    if (!status)
+        return null;
+    const explicit = context.statusMap?.[status];
+    if (typeof explicit === "number" && Number.isFinite(explicit))
+        return explicit;
+    const inferred = await loadRedmineInferredStatusByTaskStatus(context);
+    return inferred.get(status) ?? null;
+}
+export async function loadRedmineInferredStatusByTaskStatus(context) {
+    if (context.inferredStatusByTaskStatus)
+        return context.inferredStatusByTaskStatus;
+    const map = new Map();
+    context.setInferredStatusByTaskStatus(map);
+    try {
+        const payload = await context.requestJson("GET", "issue_statuses.json");
+        const statuses = Array.isArray(payload.issue_statuses) ? payload.issue_statuses : [];
+        const parsed = [];
+        for (const item of statuses) {
+            if (!item || typeof item !== "object" || Array.isArray(item))
+                continue;
+            const status = item;
+            const id = typeof status.id === "number" ? status.id : null;
+            if (!id || !Number.isFinite(id))
+                continue;
+            parsed.push({
+                id,
+                name: toStringSafe(status.name).trim().toLowerCase(),
+                isClosed: status.is_closed === true,
+                isDefault: status.is_default === true,
+            });
+        }
+        const done = selectRedmineInferredStatus(parsed, "DONE");
+        const doing = selectRedmineInferredStatus(parsed, "DOING");
+        const todo = selectRedmineInferredStatus(parsed, "TODO");
+        if (done !== null)
+            map.set("DONE", done);
+        if (doing !== null)
+            map.set("DOING", doing);
+        if (todo !== null)
+            map.set("TODO", todo);
+    }
+    catch {
+        // Best effort: keep previous behavior when status discovery is unavailable.
+    }
+    return map;
+}
+export function selectRedmineInferredStatus(statuses, target) {
+    if (statuses.length === 0)
+        return null;
+    if (target === "DOING") {
+        const byId = statuses.find((item) => item.id === 2);
+        if (byId)
+            return byId.id;
+        const byName = statuses.find((item) => item.name.includes("progress") || item.name.includes("doing"));
+        return byName?.id ?? null;
+    }
+    if (target === "DONE") {
+        const closed = statuses.find((item) => item.isClosed);
+        if (closed)
+            return closed.id;
+        const byId = statuses.find((item) => item.id === 5 || item.id === 3 || item.id === 6);
+        if (byId)
+            return byId.id;
+        const byName = statuses.find((item) => item.name.includes("done") ||
+            item.name.includes("closed") ||
+            item.name.includes("resolved") ||
+            item.name.includes("complete"));
+        return byName?.id ?? null;
+    }
+    const byDefault = statuses.find((item) => item.isDefault);
+    if (byDefault)
+        return byDefault.id;
+    const byId = statuses.find((item) => item.id === 1);
+    return byId?.id ?? statuses[0]?.id ?? null;
+}

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

@@ -10,7 +10,7 @@ export type RedmineEnvConfig = {
         pauseMs?: number;
     };
 };
-type RedmineCustomFieldKey = "task_id" | "doc" | "doc_version" | "doc_updated_at" | "doc_updated_by" | "tags" | "priority" | "owner";
+type RedmineCustomFieldKey = "task_id" | "canonical_state" | "doc" | "doc_version" | "doc_updated_at" | "doc_updated_by" | "tags" | "priority" | "owner";
 export declare function readRedmineEnv(): RedmineEnvConfig;
 export {};
 //# sourceMappingURL=env.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/env.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,KAAK,qBAAqB,GACtB,SAAS,GACT,KAAK,GACL,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,MAAM,GACN,UAAU,GACV,OAAO,CAAC;AA6BZ,wBAAgB,cAAc,IAAI,gBAAgB,CAiCjD"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/env.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,KAAK,qBAAqB,GACtB,SAAS,GACT,iBAAiB,GACjB,KAAK,GACL,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,MAAM,GACN,UAAU,GACV,OAAO,CAAC;AA6BZ,wBAAgB,cAAc,IAAI,gBAAgB,CAmCjD"}

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

@@ -25,6 +25,9 @@ export function readRedmineEnv() {
     const taskId = parsePositiveIntEnv("AGENTPLANE_REDMINE_CUSTOM_FIELDS_TASK_ID");
     if (taskId !== undefined)
         customFields.task_id = taskId;
+    const canonicalState = parsePositiveIntEnv("AGENTPLANE_REDMINE_CUSTOM_FIELDS_CANONICAL_STATE");
+    if (canonicalState !== undefined)
+        customFields.canonical_state = canonicalState;
     const doc = parsePositiveIntEnv("AGENTPLANE_REDMINE_CUSTOM_FIELDS_DOC");
     if (doc !== undefined)
         customFields.doc = doc;

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

@@ -0,0 +1,11 @@
+import { type TaskBackendFieldNameDrift, type TaskBackendVisibleField } from "../shared.js";
+export declare function inspectVisibleCustomFields(opts: {
+    projectId: string;
+    requestJson: (method: string, reqPath: string, payload?: Record<string, unknown>, params?: Record<string, unknown>) => Promise<Record<string, unknown>>;
+}): Promise<TaskBackendVisibleField[]>;
+export declare function inferVisibleCanonicalStateFieldId(visibleFields: TaskBackendVisibleField[]): number | null;
+export declare function detectConfiguredFieldNameDrift(opts: {
+    configuredFields: Record<string, unknown>;
+    visibleFields: TaskBackendVisibleField[];
+}): TaskBackendFieldNameDrift[];
+//# sourceMappingURL=inspect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/inspect.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAYtB,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA6CrC;AAED,wBAAgB,iCAAiC,CAC/C,aAAa,EAAE,uBAAuB,EAAE,GACvC,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,aAAa,EAAE,uBAAuB,EAAE,CAAC;CAC1C,GAAG,yBAAyB,EAAE,CAkB9B"}

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

@@ -0,0 +1,75 @@
+import { isRecord } from "../../../shared/guards.js";
+import { toStringSafe, } from "../shared.js";
+function expectedFieldNameForKey(key) {
+    return key;
+}
+export async function inspectVisibleCustomFields(opts) {
+    const fields = new Map();
+    let offset = 0;
+    const limit = 100;
+    while (true) {
+        const payload = await opts.requestJson("GET", "issues.json", undefined, {
+            project_id: opts.projectId,
+            limit,
+            offset,
+            status_id: "*",
+        });
+        const issues = Array.isArray(payload.issues) ? payload.issues : [];
+        const pageIssues = issues.filter((issue) => isRecord(issue));
+        for (const issue of pageIssues) {
+            const customFields = Array.isArray(issue.custom_fields) ? issue.custom_fields : [];
+            for (const field of customFields) {
+                if (!isRecord(field) || typeof field.id !== "number")
+                    continue;
+                const name = toStringSafe(field.name).trim();
+                if (!name)
+                    continue;
+                const current = fields.get(field.id) ?? {
+                    id: field.id,
+                    name,
+                    nonEmptyCount: 0,
+                };
+                const value = field.value;
+                if (value !== undefined && value !== null && toStringSafe(value).trim().length > 0) {
+                    current.nonEmptyCount += 1;
+                }
+                fields.set(field.id, current);
+            }
+        }
+        const total = Number(payload.total_count ?? 0);
+        if (total === 0 || offset + limit >= total)
+            break;
+        offset += limit;
+    }
+    return [...fields.values()]
+        .toSorted((a, b) => a.id - b.id)
+        .map((field) => ({
+        id: field.id,
+        name: field.name,
+        nonEmptyCount: field.nonEmptyCount,
+    }));
+}
+export function inferVisibleCanonicalStateFieldId(visibleFields) {
+    const field = visibleFields.find((entry) => entry.name.trim() === "canonical_state");
+    return field?.id ?? null;
+}
+export function detectConfiguredFieldNameDrift(opts) {
+    const byId = new Map(opts.visibleFields.map((field) => [field.id, field]));
+    const drift = [];
+    for (const [key, rawId] of Object.entries(opts.configuredFields)) {
+        if (typeof rawId !== "number")
+            continue;
+        const visible = byId.get(rawId);
+        if (!visible)
+            continue;
+        const expectedName = expectedFieldNameForKey(key);
+        if (visible.name.trim() === expectedName)
+            continue;
+        drift.push({
+            key,
+            configuredId: rawId,
+            visibleName: visible.name,
+        });
+    }
+    return drift.toSorted((a, b) => a.configuredId - b.configuredId || a.key.localeCompare(b.key));
+}

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

@@ -1,3 +1,4 @@
+import { type TaskDocVersion } from "@agentplaneorg/core";
 import { type TaskData } from "../shared.js";
 export declare function startDateFromTaskId(taskId: string): string | null;
 export declare function doneRatioForStatus(status: string): number | null;
@@ -7,7 +8,7 @@ export declare function issueToTask(opts: {
     reverseStatus: Map<number, string>;
     customFields: Record<string, unknown>;
     ownerAgent: string;
-    defaultDocVersion: number;
+    defaultDocVersion: TaskDocVersion;
 }): TaskData | null;
 export declare function taskToIssuePayload(opts: {
     task: TaskData;

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

@@ -1 +1 @@
-{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/mapping.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AAMtB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE;AA2BD,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,QAAQ,GAAG,IAAI,CAwElB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7F,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyC1B"}
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAML,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AAOtB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE;AA2BD,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,cAAc,CAAC;CACnC,GAAG,QAAQ,GAAG,IAAI,CAgGlB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7F,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6C1B"}