@muzzamil-khan/redmine-agent-mcp 1.0.0 → 1.2.0

package/dist/spreadsheet/parseBatchCreationCsvV1.js

@@ -0,0 +1,226 @@
+import { BATCH_TRACKER_BY_LEVEL, FEATURE_ROOT_NODE_ID, } from "./batchCreationTypes.js";
+import { findFeatureSheetRow, readFeatureRowExistingIdFromSheet, } from "./featureRow.js";
+import { buildSheetWriteBackTarget, extractFeatureTitle, findV1HeaderRowIndex, mapV1Columns, readExistingRedmineIdFromRow, } from "./sheetColumnMap.js";
+import { hoursForSubtaskOnRow, hoursForUserStoryOnRow, isAggregatingSheetRow, } from "./batchSheetHeuristics.js";
+import { normalizeHeaderCell, parseCsvRows, parseHours, splitSubjectAndDescription, } from "./csvUtils.js";
+import { normalizeSheetPriority, trackerForSheetRow, } from "./sheetRedmineFields.js";
+function sheetMetaNotes(row, cols) {
+    const parts = [];
+    if (cols.status >= 0) {
+        const v = cell(row, cols.status);
+        if (v)
+            parts.push(`Status: ${v}`);
+    }
+    return parts.join("\n");
+}
+function cell(row, index) {
+    return (row[index] ?? "").trim();
+}
+function descriptionFromParts(parts) {
+    const sections = [];
+    const { subject, description: bodyRest } = splitSubjectAndDescription(parts.body);
+    if (bodyRest)
+        sections.push(bodyRest);
+    else if (parts.body.trim() && parts.body.trim() !== subject) {
+        sections.push(parts.body.trim());
+    }
+    if (parts.comments.trim())
+        sections.push(parts.comments.trim());
+    if (parts.system.trim())
+        sections.push(`System: ${parts.system.trim()}`);
+    if (parts.meta?.trim())
+        sections.push(parts.meta.trim());
+    return sections.join("\n\n").trim();
+}
+function makeNode(params) {
+    const { subject } = splitSubjectAndDescription(params.subjectSource);
+    const etaHours = parseHours(params.eta);
+    const issue = {
+        nodeId: `row-${params.rowIndex}-${params.level}`,
+        rowIndex: params.rowIndex,
+        level: params.level,
+        tracker: trackerForSheetRow(params.sheetType ?? "", params.level),
+        subject,
+        description: descriptionFromParts({
+            body: params.subjectSource,
+            comments: params.comments,
+            system: params.system,
+            ...(params.meta ? { meta: params.meta } : {}),
+        }),
+        targetVersion: "",
+        assignedTo: params.assignedTo,
+        system: params.system,
+        parentNodeId: params.parentNodeId,
+        ...(params.sheetType?.trim()
+            ? { sheetType: params.sheetType.trim() }
+            : {}),
+        ...(params.existingRedmineId !== undefined
+            ? { existingRedmineId: params.existingRedmineId }
+            : {}),
+    };
+    if (etaHours !== undefined) {
+        issue.estimatedHours = etaHours;
+    }
+    const priority = normalizeSheetPriority(params.sheetPriority ?? "");
+    if (priority)
+        issue.priority = priority;
+    return issue;
+}
+export function parseBatchCreationCsvV1(content) {
+    const rows = parseCsvRows(content);
+    const parseWarnings = [];
+    const headerRowIndex = findV1HeaderRowIndex(rows);
+    if (headerRowIndex < 0) {
+        return {
+            format: "v1",
+            scopeNotes: "",
+            headerRowIndex: -1,
+            issues: [],
+            parseWarnings: [
+                'Could not find v1 header row with columns "Ticket", "Task", "Sub Tasks".',
+            ],
+        };
+    }
+    const featureTitle = extractFeatureTitle(rows, headerRowIndex);
+    const scopeRows = rows.slice(0, headerRowIndex);
+    const scopeNotes = featureTitle
+        ? `Feature: ${featureTitle}`
+        : scopeRows
+            .map((r) => r.map((c) => c.trim()).filter(Boolean).join(" "))
+            .filter(Boolean)
+            .join("\n");
+    const headerRow = rows[headerRowIndex] ?? [];
+    const featureSheetRow = findFeatureSheetRow(rows, headerRowIndex);
+    const existingFeatureId = featureTitle
+        ? readFeatureRowExistingIdFromSheet(rows, featureSheetRow, headerRow)
+        : undefined;
+    const issues = [];
+    const featureParentId = featureTitle ? FEATURE_ROOT_NODE_ID : null;
+    if (featureTitle) {
+        issues.push({
+            nodeId: FEATURE_ROOT_NODE_ID,
+            rowIndex: featureSheetRow,
+            level: "feature",
+            tracker: BATCH_TRACKER_BY_LEVEL.feature,
+            subject: featureTitle,
+            description: "",
+            targetVersion: "",
+            assignedTo: "",
+            system: "",
+            parentNodeId: null,
+            ...(existingFeatureId !== undefined
+                ? { existingRedmineId: existingFeatureId }
+                : {}),
+        });
+    }
+    const cols = mapV1Columns(headerRow);
+    const sheetWriteBack = buildSheetWriteBackTarget(headerRow);
+    let currentUserStoryNodeId = null;
+    let ticketGroupContext = "";
+    for (let i = headerRowIndex + 1; i < rows.length; i++) {
+        const row = rows[i] ?? [];
+        const ticket = cols.ticket >= 0 ? cell(row, cols.ticket) : "";
+        const task = cell(row, cols.userStory);
+        const sub = cell(row, cols.subtask);
+        const eta = cols.hours >= 0 ? cell(row, cols.hours) : "";
+        const system = cols.system >= 0 ? cell(row, cols.system) : "";
+        const comments = cols.comments >= 0 ? cell(row, cols.comments) : "";
+        const assignedTo = cols.assignedTo >= 0 ? cell(row, cols.assignedTo) : "";
+        const meta = sheetMetaNotes(row, cols);
+        const sheetType = cols.sheetType >= 0 ? cell(row, cols.sheetType) : "";
+        const sheetPriority = cols.priority >= 0 ? cell(row, cols.priority) : "";
+        const rowRedmineId = task || sub
+            ? readExistingRedmineIdFromRow(row, cols)
+            : undefined;
+        if (!ticket && !task && !sub)
+            continue;
+        if (ticket && !task && !sub) {
+            currentUserStoryNodeId = null;
+            ticketGroupContext = ticket;
+            continue;
+        }
+        if (isAggregatingSheetRow({ userStoryText: task, subtaskText: sub })) {
+            parseWarnings.push(`Row ${i + 1}: Rollup/summary row skipped (not created on Redmine).`);
+            currentUserStoryNodeId = null;
+            continue;
+        }
+        const subHoursCell = hoursForSubtaskOnRow(task, eta);
+        const storyHoursCell = hoursForUserStoryOnRow(sub, eta);
+        if (task) {
+            const groupPrefix = ticketGroupContext
+                ? `${ticketGroupContext}\n\n`
+                : "";
+            ticketGroupContext = "";
+            const body = groupPrefix + task;
+            const node = makeNode({
+                rowIndex: i + 1,
+                level: "userStory",
+                subjectSource: task,
+                comments,
+                system,
+                eta: storyHoursCell,
+                assignedTo,
+                parentNodeId: featureParentId,
+                meta,
+                sheetType,
+                sheetPriority,
+                ...(rowRedmineId !== undefined && !sub
+                    ? { existingRedmineId: rowRedmineId }
+                    : {}),
+            });
+            if (groupPrefix) {
+                node.description = descriptionFromParts({
+                    body,
+                    comments,
+                    system: node.system,
+                    ...(meta ? { meta } : {}),
+                });
+            }
+            if (!node.subject) {
+                parseWarnings.push(`Row ${i + 1}: Task has no subject text.`);
+                continue;
+            }
+            issues.push(node);
+            currentUserStoryNodeId = node.nodeId;
+        }
+        if (sub) {
+            if (!currentUserStoryNodeId) {
+                parseWarnings.push(`Row ${i + 1}: Sub Task skipped — no User Story (Task column) above.`);
+                continue;
+            }
+            const subRowId = readExistingRedmineIdFromRow(row, cols);
+            const node = makeNode({
+                rowIndex: i + 1,
+                level: "subtask",
+                subjectSource: sub,
+                comments,
+                system,
+                eta: subHoursCell,
+                assignedTo,
+                parentNodeId: currentUserStoryNodeId,
+                meta,
+                sheetType,
+                sheetPriority,
+                ...(subRowId !== undefined
+                    ? { existingRedmineId: subRowId }
+                    : {}),
+            });
+            if (!node.subject) {
+                parseWarnings.push(`Row ${i + 1}: Sub Task has no subject text.`);
+                continue;
+            }
+            issues.push(node);
+        }
+    }
+    return {
+        format: "v1",
+        scopeNotes,
+        headerRowIndex: headerRowIndex + 1,
+        sheetColumns: cols,
+        ...(sheetWriteBack ? { sheetWriteBack } : {}),
+        issues,
+        parseWarnings,
+        ...(featureTitle ? { featureTitle } : {}),
+    };
+}
+//# sourceMappingURL=parseBatchCreationCsvV1.js.map

package/dist/spreadsheet/parseBatchCreationCsvV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBatchCreationCsvV1.js","sourceRoot":"","sources":["../../src/spreadsheet/parseBatchCreationCsvV1.ts"],"names":[],"mappings":"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"}

package/dist/spreadsheet/parseBatchCreationCsvV2.d.ts

@@ -0,0 +1,4 @@
+import type { BatchParseResult } from "./batchCreationTypes.js";
+export { mapV2Columns, extractFeatureTitle, findV2HeaderRowIndex } from "./sheetColumnMap.js";
+export declare function parseBatchCreationCsvV2(content: string): BatchParseResult;
+//# sourceMappingURL=parseBatchCreationCsvV2.d.ts.map

package/dist/spreadsheet/parseBatchCreationCsvV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBatchCreationCsvV2.d.ts","sourceRoot":"","sources":["../../src/spreadsheet/parseBatchCreationCsvV2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAiC,MAAM,yBAAyB,CAAC;AA4B/F,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AA2D9F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAmJzE"}

package/dist/spreadsheet/parseBatchCreationCsvV2.js

@@ -0,0 +1,180 @@
+import { BATCH_TRACKER_BY_LEVEL, FEATURE_ROOT_NODE_ID, } from "./batchCreationTypes.js";
+import { appendCommentsToDescription, parseCsvRows, parseHours, splitSubjectAndDescription, } from "./csvUtils.js";
+import { isAggregatingSheetRow, hoursForSubtaskOnRow, hoursForUserStoryOnRow, } from "./batchSheetHeuristics.js";
+import { findFeatureSheetRow, readFeatureRowExistingIdFromSheet, } from "./featureRow.js";
+import { buildSheetWriteBackTarget, extractFeatureTitle, findV2HeaderRowIndex, mapV2Columns, readExistingRedmineIdFromRow, } from "./sheetColumnMap.js";
+export { mapV2Columns, extractFeatureTitle, findV2HeaderRowIndex } from "./sheetColumnMap.js";
+function toLegacyV2Columns(cols) {
+    return {
+        task: cols.userStory,
+        subTasks: cols.subtask,
+        description: cols.description,
+        hours: cols.hours,
+        targetVersion: cols.targetVersion,
+        assignedTo: cols.assignedTo,
+        comments: cols.comments,
+        taskId: cols.redmineId,
+    };
+}
+function cell(row, index) {
+    if (index < 0)
+        return "";
+    return (row[index] ?? "").trim();
+}
+function buildIssue(params) {
+    if (!params.subject.trim())
+        return null;
+    const issue = {
+        nodeId: `row-${params.rowIndex}-${params.level}`,
+        rowIndex: params.rowIndex,
+        level: params.level,
+        tracker: BATCH_TRACKER_BY_LEVEL[params.level],
+        subject: params.subject.trim(),
+        description: appendCommentsToDescription(params.description, params.comments),
+        targetVersion: params.targetVersion.trim(),
+        assignedTo: params.assignedTo.trim(),
+        system: "",
+        parentNodeId: params.parentNodeId,
+    };
+    if (params.hours !== undefined) {
+        issue.estimatedHours = params.hours;
+    }
+    if (params.existingRedmineId !== undefined) {
+        issue.existingRedmineId = params.existingRedmineId;
+    }
+    return issue;
+}
+export function parseBatchCreationCsvV2(content) {
+    const rows = parseCsvRows(content);
+    const parseWarnings = [];
+    const headerRowIndex = findV2HeaderRowIndex(rows);
+    if (headerRowIndex < 0) {
+        return {
+            format: "v2",
+            scopeNotes: "",
+            headerRowIndex: -1,
+            issues: [],
+            parseWarnings: [
+                'Could not find v2 header: Task, Sub-Tasks, Description, Hours, Target Version, Assigned To, Comments / Question',
+            ],
+        };
+    }
+    const headerRow = rows[headerRowIndex] ?? [];
+    const cols = mapV2Columns(headerRow);
+    const sheetWriteBack = buildSheetWriteBackTarget(headerRow);
+    const featureTitle = extractFeatureTitle(rows, headerRowIndex);
+    const issues = [];
+    const featureSheetRow = findFeatureSheetRow(rows, headerRowIndex);
+    const existingFeatureId = featureTitle
+        ? readFeatureRowExistingIdFromSheet(rows, featureSheetRow, headerRow)
+        : undefined;
+    if (featureTitle) {
+        const featureNode = buildIssue({
+            rowIndex: featureSheetRow,
+            level: "feature",
+            subject: featureTitle,
+            description: "",
+            targetVersion: "",
+            assignedTo: "",
+            comments: "",
+            parentNodeId: null,
+            ...(existingFeatureId !== undefined
+                ? { existingRedmineId: existingFeatureId }
+                : {}),
+        });
+        if (featureNode) {
+            featureNode.nodeId = FEATURE_ROOT_NODE_ID;
+            issues.push(featureNode);
+        }
+    }
+    let currentUserStoryNodeId = null;
+    const featureParentId = featureTitle ? FEATURE_ROOT_NODE_ID : null;
+    /** Target version for current User Story (set on Task row, applies until next Task) */
+    let currentTargetVersion = "";
+    for (let i = headerRowIndex + 1; i < rows.length; i++) {
+        const row = rows[i] ?? [];
+        const taskCell = cell(row, cols.userStory);
+        const subCell = cell(row, cols.subtask);
+        const descriptionCol = cell(row, cols.description);
+        const hoursCol = cols.hours >= 0 ? cell(row, cols.hours) : "";
+        const targetVersionCol = cols.targetVersion >= 0 ? cell(row, cols.targetVersion) : "";
+        const assignedToCol = cols.assignedTo >= 0 ? cell(row, cols.assignedTo) : "";
+        const commentsCol = cols.comments >= 0 ? cell(row, cols.comments) : "";
+        const rowRedmineId = readExistingRedmineIdFromRow(row, cols);
+        if (!taskCell && !subCell)
+            continue;
+        if (isAggregatingSheetRow({ userStoryText: taskCell, subtaskText: subCell })) {
+            parseWarnings.push(`Row ${i + 1}: Rollup/summary row skipped (not created on Redmine).`);
+            currentUserStoryNodeId = null;
+            continue;
+        }
+        if (taskCell) {
+            if (targetVersionCol) {
+                currentTargetVersion = targetVersionCol;
+            }
+            const { subject, description } = splitSubjectAndDescription(taskCell);
+            const storyHoursCell = hoursForUserStoryOnRow(subCell, hoursCol);
+            const hours = storyHoursCell ? parseHours(storyHoursCell) : undefined;
+            const node = buildIssue({
+                rowIndex: i + 1,
+                level: "userStory",
+                subject,
+                description,
+                ...(hours !== undefined ? { hours } : {}),
+                targetVersion: currentTargetVersion,
+                assignedTo: "",
+                comments: subCell ? "" : commentsCol,
+                parentNodeId: featureParentId,
+                ...(rowRedmineId !== undefined && !subCell
+                    ? { existingRedmineId: rowRedmineId }
+                    : {}),
+            });
+            if (!node) {
+                parseWarnings.push(`Row ${i + 1}: Task has no subject (first line).`);
+            }
+            else {
+                issues.push(node);
+                currentUserStoryNodeId = node.nodeId;
+            }
+        }
+        if (subCell) {
+            if (!currentUserStoryNodeId) {
+                parseWarnings.push(`Row ${i + 1}: Sub-Task skipped — no User Story (Task column) above.`);
+                continue;
+            }
+            const { subject } = splitSubjectAndDescription(subCell);
+            const subHoursCell = hoursForSubtaskOnRow(taskCell, hoursCol);
+            const hours = subHoursCell ? parseHours(subHoursCell) : undefined;
+            const subRowId = readExistingRedmineIdFromRow(row, cols);
+            const node = buildIssue({
+                rowIndex: i + 1,
+                level: "subtask",
+                subject,
+                description: descriptionCol,
+                ...(hours !== undefined ? { hours } : {}),
+                targetVersion: "",
+                assignedTo: assignedToCol,
+                comments: commentsCol,
+                parentNodeId: currentUserStoryNodeId,
+                ...(subRowId !== undefined ? { existingRedmineId: subRowId } : {}),
+            });
+            if (!node) {
+                parseWarnings.push(`Row ${i + 1}: Sub-Task has no subject.`);
+                continue;
+            }
+            issues.push(node);
+        }
+    }
+    return {
+        format: "v2",
+        scopeNotes: featureTitle ? `Feature: ${featureTitle}` : "",
+        headerRowIndex: headerRowIndex + 1,
+        sheetColumns: cols,
+        ...(sheetWriteBack ? { sheetWriteBack } : {}),
+        v2Columns: toLegacyV2Columns(cols),
+        ...(featureTitle ? { featureTitle } : {}),
+        issues,
+        parseWarnings,
+    };
+}
+//# sourceMappingURL=parseBatchCreationCsvV2.js.map

package/dist/spreadsheet/parseBatchCreationCsvV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBatchCreationCsvV2.js","sourceRoot":"","sources":["../../src/spreadsheet/parseBatchCreationCsvV2.ts"],"names":[],"mappings":"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"}

package/dist/spreadsheet/redmineIssueCell.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Task ID / Ticket column: store Redmine issues as clickable HYPERLINK formulas.
+ *
+ * Composite Ticket column (user story + task on one row):
+ *   =HYPERLINK(url,"Ticket:#123") & " " & HYPERLINK(url,"MainTicket:#456")
+ * Task-only rows: =HYPERLINK(url,"Ticket:#123")
+ * Story-only rows: =HYPERLINK(url,"MainTicket:#456")
+ *
+ * Plain text Ticket:#id / MainTicket:#id (no formula) is still parsed on read.
+ */
+export type TicketCellLabel = "Ticket" | "MainTicket";
+export type ParsedTicketCell = {
+    ticketId?: number;
+    mainTicketId?: number;
+    ticketPart?: string;
+    mainTicketPart?: string;
+    hasLabels: boolean;
+};
+export declare function buildRedmineIssueUrl(baseUrl: string, issueId: number): string;
+/** Google Sheets formula — clickable #id linking to the issue (Task ID column). */
+export declare function buildRedmineIssueIdCell(issueId: number, issueUrl: string): string;
+/** HYPERLINK(...) segment without leading = (for joining composite cells). */
+export declare function buildLabeledTicketHyperlinkSegment(label: TicketCellLabel, issueId: number, issueUrl: string): string;
+/** Single labeled Ticket-column formula. */
+export declare function buildLabeledTicketHyperlink(label: TicketCellLabel, issueId: number, issueUrl: string): string;
+export declare function hasCompositeTicketLabels(value: string): boolean;
+/** Parse Ticket / MainTicket segments from a composite Ticket column cell. */
+export declare function parseTicketCell(value: string): ParsedTicketCell;
+/** Merge Ticket / MainTicket segments for sheet write-back (Ticket first). */
+export declare function buildCompositeTicketCell(parts: {
+    ticketPart?: string;
+    mainTicketPart?: string;
+}): string;
+export declare function mergeTicketCellWriteBack(existingCell: string, level: "userStory" | "subtask", issueId: number, issueUrl: string): string;
+/** Parse issue id from bare id, #id, URL, or HYPERLINK formula text. */
+export declare function parseRedmineIssueId(value: string): number | undefined;
+export declare function isSheetsFormulaValue(value: string | number): boolean;
+//# sourceMappingURL=redmineIssueCell.d.ts.map

package/dist/spreadsheet/redmineIssueCell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redmineIssueCell.d.ts","sourceRoot":"","sources":["../../src/spreadsheet/redmineIssueCell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACjB,MAAM,CAGR;AAED,8EAA8E;AAC9E,wBAAgB,kCAAkC,CAC9C,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACjB,MAAM,CAGR;AAED,4CAA4C;AAC5C,wBAAgB,2BAA2B,CACvC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM/D;AA0DD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CA6B/D;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAST;AAED,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,WAAW,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACjB,MAAM,CA4BR;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BrE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAEpE"}

package/dist/spreadsheet/redmineIssueCell.js

@@ -0,0 +1,176 @@
+/**
+ * Task ID / Ticket column: store Redmine issues as clickable HYPERLINK formulas.
+ *
+ * Composite Ticket column (user story + task on one row):
+ *   =HYPERLINK(url,"Ticket:#123") & " " & HYPERLINK(url,"MainTicket:#456")
+ * Task-only rows: =HYPERLINK(url,"Ticket:#123")
+ * Story-only rows: =HYPERLINK(url,"MainTicket:#456")
+ *
+ * Plain text Ticket:#id / MainTicket:#id (no formula) is still parsed on read.
+ */
+function escapeFormulaUrl(url) {
+    return url.replace(/"/g, '""');
+}
+export function buildRedmineIssueUrl(baseUrl, issueId) {
+    const base = baseUrl.replace(/\/$/, "");
+    return `${base}/issues/${issueId}`;
+}
+/** Google Sheets formula — clickable #id linking to the issue (Task ID column). */
+export function buildRedmineIssueIdCell(issueId, issueUrl) {
+    const url = escapeFormulaUrl(issueUrl);
+    return `=HYPERLINK("${url}","#${issueId}")`;
+}
+/** HYPERLINK(...) segment without leading = (for joining composite cells). */
+export function buildLabeledTicketHyperlinkSegment(label, issueId, issueUrl) {
+    const url = escapeFormulaUrl(issueUrl);
+    return `HYPERLINK("${url}","${label}:#${issueId}")`;
+}
+/** Single labeled Ticket-column formula. */
+export function buildLabeledTicketHyperlink(label, issueId, issueUrl) {
+    return `=${buildLabeledTicketHyperlinkSegment(label, issueId, issueUrl)}`;
+}
+export function hasCompositeTicketLabels(value) {
+    const trimmed = value.trim();
+    return (/\b(?:Ticket|MainTicket):/i.test(trimmed) ||
+        /HYPERLINK\s*\([^,]+,\s*"(?:Ticket|MainTicket):#/i.test(trimmed));
+}
+function hyperlinkSegment(part) {
+    return part.trim().replace(/^=/, "");
+}
+function extractLabeledHyperlinkPart(text, label) {
+    const displayRe = new RegExp(`(HYPERLINK\\s*\\([^,]+,\\s*"${label}:#\\d+"\\))`, "i");
+    const displayMatch = displayRe.exec(text);
+    if (displayMatch?.[1])
+        return displayMatch[1];
+    const legacyRe = new RegExp(`(${label}:=HYPERLINK\\s*\\([^)]+\\))`, "i");
+    const legacyMatch = legacyRe.exec(text);
+    if (legacyMatch?.[1])
+        return legacyMatch[1];
+    const plainRe = new RegExp(`(${label}:#\\d+)`, "i");
+    const plainMatch = plainRe.exec(text);
+    if (plainMatch?.[1])
+        return plainMatch[1];
+    return undefined;
+}
+function extractLabeledId(text, label) {
+    const displayRe = new RegExp(`HYPERLINK\\s*\\([^,]+,\\s*"${label}:#(\\d+)"`, "i");
+    const displayMatch = displayRe.exec(text);
+    if (displayMatch?.[1]) {
+        const id = Number(displayMatch[1]);
+        return Number.isInteger(id) && id > 0 ? id : undefined;
+    }
+    const legacyRe = new RegExp(`${label}:=HYPERLINK\\s*\\([^,]+,\\s*"#?(\\d+)"`, "i");
+    const legacyMatch = legacyRe.exec(text);
+    if (legacyMatch?.[1]) {
+        const id = Number(legacyMatch[1]);
+        return Number.isInteger(id) && id > 0 ? id : undefined;
+    }
+    const part = extractLabeledHyperlinkPart(text, label);
+    if (!part)
+        return undefined;
+    const value = part.slice(label.length + 1).trim();
+    return parseRedmineIssueId(value);
+}
+/** Parse Ticket / MainTicket segments from a composite Ticket column cell. */
+export function parseTicketCell(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return { hasLabels: false };
+    }
+    const hasLabels = hasCompositeTicketLabels(trimmed);
+    if (!hasLabels) {
+        const legacyId = parseRedmineIssueId(trimmed);
+        return {
+            hasLabels: false,
+            ...(legacyId !== undefined ? { ticketId: legacyId } : {}),
+        };
+    }
+    const ticketPart = extractLabeledHyperlinkPart(trimmed, "Ticket");
+    const mainTicketPart = extractLabeledHyperlinkPart(trimmed, "MainTicket");
+    const ticketId = ticketPart
+        ? extractLabeledId(trimmed, "Ticket")
+        : undefined;
+    const mainTicketId = mainTicketPart
+        ? extractLabeledId(trimmed, "MainTicket")
+        : undefined;
+    const parsed = { hasLabels: true };
+    if (ticketPart)
+        parsed.ticketPart = ticketPart;
+    if (mainTicketPart)
+        parsed.mainTicketPart = mainTicketPart;
+    if (ticketId !== undefined)
+        parsed.ticketId = ticketId;
+    if (mainTicketId !== undefined)
+        parsed.mainTicketId = mainTicketId;
+    return parsed;
+}
+/** Merge Ticket / MainTicket segments for sheet write-back (Ticket first). */
+export function buildCompositeTicketCell(parts) {
+    const segments = [];
+    if (parts.ticketPart)
+        segments.push(hyperlinkSegment(parts.ticketPart));
+    if (parts.mainTicketPart) {
+        segments.push(hyperlinkSegment(parts.mainTicketPart));
+    }
+    if (segments.length === 0)
+        return "";
+    if (segments.length === 1)
+        return `=${segments[0]}`;
+    return `=${segments.join(' & " " & ')}`;
+}
+export function mergeTicketCellWriteBack(existingCell, level, issueId, issueUrl) {
+    const label = level === "userStory" ? "MainTicket" : "Ticket";
+    const newPart = buildLabeledTicketHyperlinkSegment(label, issueId, issueUrl);
+    const parsed = parseTicketCell(existingCell);
+    if (!parsed.hasLabels) {
+        if (level === "userStory") {
+            return buildCompositeTicketCell({ mainTicketPart: newPart });
+        }
+        return buildCompositeTicketCell({ ticketPart: newPart });
+    }
+    if (level === "userStory") {
+        return buildCompositeTicketCell({
+            ...(parsed.ticketPart
+                ? { ticketPart: hyperlinkSegment(parsed.ticketPart) }
+                : {}),
+            mainTicketPart: newPart,
+        });
+    }
+    return buildCompositeTicketCell({
+        ticketPart: newPart,
+        ...(parsed.mainTicketPart
+            ? { mainTicketPart: hyperlinkSegment(parsed.mainTicketPart) }
+            : {}),
+    });
+}
+/** Parse issue id from bare id, #id, URL, or HYPERLINK formula text. */
+export function parseRedmineIssueId(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    const fromLabeledDisplay = /HYPERLINK\s*\([^,]+,\s*"(?:Ticket|MainTicket):#(\d+)"/i.exec(trimmed);
+    if (fromLabeledDisplay?.[1]) {
+        const id = Number(fromLabeledDisplay[1]);
+        return Number.isInteger(id) && id > 0 ? id : undefined;
+    }
+    const fromUrl = /\/issues\/(\d+)/i.exec(trimmed);
+    if (fromUrl?.[1]) {
+        const id = Number(fromUrl[1]);
+        return Number.isInteger(id) && id > 0 ? id : undefined;
+    }
+    const fromHyperlink = /HYPERLINK\s*\([^)]*\/issues\/(\d+)/i.exec(trimmed);
+    if (fromHyperlink?.[1]) {
+        const id = Number(fromHyperlink[1]);
+        return Number.isInteger(id) && id > 0 ? id : undefined;
+    }
+    const digits = /^#?(\d+)$/.exec(trimmed);
+    if (digits?.[1]) {
+        const id = Number(digits[1]);
+        return Number.isInteger(id) && id > 0 ? id : undefined;
+    }
+    return undefined;
+}
+export function isSheetsFormulaValue(value) {
+    return typeof value === "string" && value.trimStart().startsWith("=");
+}
+//# sourceMappingURL=redmineIssueCell.js.map