agentplane 0.1.8 → 0.2.0

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

@@ -0,0 +1,114 @@
+import { isRecord } from "../../../shared/guards.js";
+import { ensureDocMetadata, normalizePriority, nowIso, toStringSafe, } from "../shared.js";
+import { customFieldValue } from "./fields.js";
+import { coerceDocVersion, maybeParseJson } from "./parse.js";
+import { normalizeComments } from "./comments.js";
+export function startDateFromTaskId(taskId) {
+    if (!taskId.includes("-"))
+        return null;
+    const prefix = taskId.split("-", 1)[0] ?? "";
+    if (prefix.length < 8)
+        return null;
+    const year = prefix.slice(0, 4);
+    const month = prefix.slice(4, 6);
+    const day = prefix.slice(6, 8);
+    if (!/^\d{8}$/u.test(`${year}${month}${day}`))
+        return null;
+    return `${year}-${month}-${day}`;
+}
+export function doneRatioForStatus(status) {
+    if (!status)
+        return null;
+    if (status === "DONE")
+        return 100;
+    return 0;
+}
+export function issueToTask(opts) {
+    const taskId = opts.taskIdOverride ?? customFieldValue(opts.issue, opts.customFields.task_id);
+    if (!taskId)
+        return null;
+    const statusVal = isRecord(opts.issue.status) ? opts.issue.status : null;
+    const statusId = statusVal && typeof statusVal.id === "number" ? statusVal.id : null;
+    const status = statusId !== null && opts.reverseStatus.has(statusId)
+        ? opts.reverseStatus.get(statusId)
+        : "TODO";
+    const verifyVal = customFieldValue(opts.issue, opts.customFields.verify);
+    const commitVal = customFieldValue(opts.issue, opts.customFields.commit);
+    const docVal = customFieldValue(opts.issue, opts.customFields.doc);
+    const commentsVal = customFieldValue(opts.issue, opts.customFields.comments);
+    const docVersionVal = customFieldValue(opts.issue, opts.customFields.doc_version);
+    const docUpdatedAtVal = customFieldValue(opts.issue, opts.customFields.doc_updated_at);
+    const docUpdatedByVal = customFieldValue(opts.issue, opts.customFields.doc_updated_by);
+    const updatedOn = typeof opts.issue.updated_on === "string"
+        ? opts.issue.updated_on
+        : typeof opts.issue.created_on === "string"
+            ? opts.issue.created_on
+            : null;
+    const priorityVal = isRecord(opts.issue.priority) ? opts.issue.priority : null;
+    const priorityName = normalizePriority(priorityVal?.name);
+    const tags = [];
+    if (Array.isArray(opts.issue.tags)) {
+        for (const tag of opts.issue.tags) {
+            if (isRecord(tag) && tag.name)
+                tags.push(toStringSafe(tag.name));
+        }
+    }
+    const task = {
+        id: toStringSafe(taskId),
+        title: toStringSafe(opts.issue.subject),
+        description: toStringSafe(opts.issue.description),
+        status: status ?? "TODO",
+        priority: priorityName,
+        owner: opts.ownerAgent,
+        tags,
+        depends_on: [],
+        verify: maybeParseJson(verifyVal),
+        commit: maybeParseJson(commitVal),
+        comments: normalizeComments(maybeParseJson(commentsVal)),
+        id_source: "custom",
+    };
+    if (docVal)
+        task.doc = toStringSafe(docVal);
+    const docVersion = coerceDocVersion(docVersionVal);
+    task.doc_version = docVersion ?? opts.defaultDocVersion;
+    task.doc_updated_at = docUpdatedAtVal ? toStringSafe(docUpdatedAtVal) : (updatedOn ?? nowIso());
+    task.doc_updated_by = docUpdatedByVal ? toStringSafe(docUpdatedByVal) : opts.ownerAgent;
+    return task;
+}
+export function taskToIssuePayload(opts) {
+    const status = toStringSafe(opts.task.status).trim().toUpperCase();
+    const payload = {
+        subject: toStringSafe(opts.task.title),
+        description: toStringSafe(opts.task.description),
+    };
+    if (status && opts.statusMap && status in opts.statusMap) {
+        payload.status_id = opts.statusMap[status];
+    }
+    if (typeof opts.task.priority === "number")
+        payload.priority_id = opts.task.priority;
+    let existingAssignee = null;
+    if (opts.existingIssue && isRecord(opts.existingIssue.assigned_to)) {
+        existingAssignee = opts.existingIssue.assigned_to.id;
+    }
+    if (opts.assigneeId && !existingAssignee)
+        payload.assigned_to_id = opts.assigneeId;
+    const startDate = startDateFromTaskId(toStringSafe(opts.task.id));
+    if (startDate)
+        payload.start_date = startDate;
+    const doneRatio = doneRatioForStatus(status);
+    if (doneRatio !== null)
+        payload.done_ratio = doneRatio;
+    const customFields = [];
+    ensureDocMetadata(opts.task);
+    opts.appendCustomField(customFields, "task_id", opts.task.id);
+    opts.appendCustomField(customFields, "verify", opts.task.verify);
+    opts.appendCustomField(customFields, "commit", opts.task.commit);
+    opts.appendCustomField(customFields, "comments", opts.task.comments);
+    opts.appendCustomField(customFields, "doc", opts.task.doc);
+    opts.appendCustomField(customFields, "doc_version", opts.task.doc_version);
+    opts.appendCustomField(customFields, "doc_updated_at", opts.task.doc_updated_at);
+    opts.appendCustomField(customFields, "doc_updated_by", opts.task.doc_updated_by);
+    if (customFields.length > 0)
+        payload.custom_fields = customFields;
+    return payload;
+}

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

@@ -0,0 +1,3 @@
+export declare function maybeParseJson(value: unknown): unknown;
+export declare function coerceDocVersion(value: unknown): number | null;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/parse.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYtD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAM9D"}

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

@@ -0,0 +1,27 @@
+import { toStringSafe } from "../shared.js";
+export function maybeParseJson(value) {
+    if (value === null || value === undefined)
+        return null;
+    const raw = toStringSafe(value).trim();
+    if (!raw)
+        return null;
+    if (raw.startsWith("{") || raw.startsWith("[")) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return raw;
+        }
+    }
+    return raw;
+}
+export function coerceDocVersion(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === "number")
+        return value;
+    const raw = toStringSafe(value).trim();
+    if (/^\d+$/u.test(raw))
+        return Number(raw);
+    return null;
+}

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

@@ -0,0 +1,19 @@
+import { type TaskData } from "../shared.js";
+export declare function listTasksRemote(opts: {
+    projectId: string;
+    taskFieldId: unknown;
+    issueCache: Map<string, Record<string, unknown>>;
+    requestJson: (method: string, reqPath: string, payload?: Record<string, unknown>, params?: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    customFieldValue: (issue: Record<string, unknown>, fieldId: unknown) => string | null;
+    issueToTask: (issue: Record<string, unknown>, taskIdOverride?: string) => TaskData | null;
+}): Promise<TaskData[]>;
+export declare function findIssueByTaskId(opts: {
+    taskId: string;
+    projectId: string;
+    taskFieldId: unknown;
+    issueCache: Map<string, Record<string, unknown>>;
+    requestJson: (method: string, reqPath: string, payload?: Record<string, unknown>, params?: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    customFieldValue: (issue: Record<string, unknown>, fieldId: unknown) => string | null;
+    refreshList: () => Promise<void>;
+}): Promise<Record<string, unknown> | null>;
+//# sourceMappingURL=remote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/remote.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0C,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAErF,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,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;IACtC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IACtF,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC;CAC3F,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAkDtB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,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;IACtC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IACtF,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAyB1C"}

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

@@ -0,0 +1,82 @@
+import { isRecord } from "../../../shared/guards.js";
+import { BackendError, TASK_ID_RE, toStringSafe } from "../shared.js";
+export async function listTasksRemote(opts) {
+    const tasks = [];
+    const allIssues = [];
+    let offset = 0;
+    const limit = 100;
+    opts.issueCache.clear();
+    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));
+        allIssues.push(...pageIssues);
+        const total = Number(payload.total_count ?? 0);
+        if (total === 0 || offset + limit >= total)
+            break;
+        offset += limit;
+    }
+    const existingIds = new Set();
+    const duplicates = new Set();
+    for (const issue of allIssues) {
+        const taskId = opts.customFieldValue(issue, opts.taskFieldId);
+        if (!taskId)
+            continue;
+        const taskIdStr = toStringSafe(taskId);
+        if (!TASK_ID_RE.test(taskIdStr))
+            continue;
+        if (existingIds.has(taskIdStr))
+            duplicates.add(taskIdStr);
+        existingIds.add(taskIdStr);
+    }
+    if (duplicates.size > 0) {
+        const sample = [...duplicates].toSorted().slice(0, 5).join(", ");
+        throw new BackendError(`Duplicate task_id values found in Redmine: ${sample}`, "E_BACKEND");
+    }
+    for (const issue of allIssues) {
+        const taskId = opts.customFieldValue(issue, opts.taskFieldId);
+        const taskIdText = toStringSafe(taskId);
+        if (!taskIdText || !TASK_ID_RE.test(taskIdText))
+            continue;
+        const task = opts.issueToTask(issue, taskIdText);
+        if (task) {
+            const idText = toStringSafe(task.id);
+            if (idText)
+                opts.issueCache.set(idText, issue);
+            tasks.push(task);
+        }
+    }
+    return tasks;
+}
+export async function findIssueByTaskId(opts) {
+    const id = toStringSafe(opts.taskId).trim();
+    if (!id)
+        return null;
+    const cached = opts.issueCache.get(id);
+    if (cached)
+        return cached;
+    const payload = await opts.requestJson("GET", "issues.json", undefined, {
+        project_id: opts.projectId,
+        status_id: "*",
+        [`cf_${String(opts.taskFieldId)}`]: id,
+        limit: 100,
+    });
+    const candidates = Array.isArray(payload.issues) ? payload.issues : [];
+    for (const candidate of candidates) {
+        if (!isRecord(candidate))
+            continue;
+        const val = opts.customFieldValue(candidate, opts.taskFieldId);
+        if (val && String(val) === id) {
+            opts.issueCache.set(id, candidate);
+            return candidate;
+        }
+    }
+    await opts.refreshList();
+    const refreshed = opts.issueCache.get(id);
+    return refreshed ?? null;
+}

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

@@ -0,0 +1,80 @@
+import type { LocalBackend } from "./local-backend.js";
+import { type TaskBackend, type TaskData } from "./shared.js";
+export type RedmineSettings = {
+    url?: string;
+    api_key?: string;
+    project_id?: string;
+    status_map?: Record<string, unknown>;
+    custom_fields?: Record<string, unknown>;
+    batch_size?: number;
+    batch_pause?: number;
+    owner_agent?: string;
+    cache_dir?: string;
+};
+export declare class RedmineBackend implements TaskBackend {
+    id: string;
+    baseUrl: string;
+    apiKey: string;
+    projectId: string;
+    assigneeId: number | null;
+    ownerAgent: string;
+    statusMap: Record<string, unknown>;
+    customFields: Record<string, unknown>;
+    batchSize: number;
+    batchPause: number;
+    cache: LocalBackend | null;
+    issueCache: Map<string, Record<string, unknown>>;
+    reverseStatus: Map<number, string>;
+    constructor(settings: RedmineSettings, opts: {
+        cache?: LocalBackend | null;
+    });
+    generateTaskId(opts: {
+        length: number;
+        attempts: number;
+    }): Promise<string>;
+    listTasks(): Promise<TaskData[]>;
+    exportTasksJson(outputPath: string): Promise<void>;
+    normalizeTasks(): Promise<{
+        scanned: number;
+        changed: number;
+    }>;
+    getTask(taskId: string): Promise<TaskData | null>;
+    getTasks(taskIds: string[]): Promise<(TaskData | null)[]>;
+    getTaskDoc(taskId: string): Promise<string>;
+    setTaskDoc(taskId: string, doc: string, updatedBy?: string): Promise<void>;
+    touchTaskDocMetadata(taskId: string, updatedBy?: string): Promise<void>;
+    writeTask(task: TaskData): Promise<void>;
+    writeTasks(tasks: TaskData[]): Promise<void>;
+    sync(opts: {
+        direction: "push" | "pull";
+        conflict: "diff" | "prefer-local" | "prefer-remote" | "fail";
+        quiet: boolean;
+        confirm: boolean;
+    }): Promise<void>;
+    private ensureDocMetadata;
+    private syncPush;
+    private syncPull;
+    private handleConflict;
+    private diffTasks;
+    private tasksDiffer;
+    private cacheTask;
+    private taskIdFieldId;
+    private setIssueCustomFieldValue;
+    private listTasksRemote;
+    private issueFromPayload;
+    private findIssueByTaskId;
+    private issueToTask;
+    private taskToIssuePayload;
+    private appendCustomField;
+    private normalizeComments;
+    private appendCommentNotes;
+    private startDateFromTaskId;
+    private doneRatioForStatus;
+    private commentsToPairs;
+    private formatCommentNote;
+    private customFieldValue;
+    private maybeParseJson;
+    private coerceDocVersion;
+    private requestJson;
+}
+//# sourceMappingURL=redmine-backend.d.ts.map

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

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