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

package/dist/spreadsheet/batchColumnMapping.d.ts

@@ -0,0 +1,93 @@
+import type { BatchParseResult } from "./batchCreationTypes.js";
+import { type BatchSheetColumnMap } from "./sheetColumnMap.js";
+import type { RawBatchSheet } from "./extractRawBatchSheet.js";
+/** Column role keys the agent maps from sheet headers (by name or 0-based index). */
+export type BatchColumnRole = "userStory" | "subtask" | "description" | "hours" | "targetVersion" | "assignedTo" | "comments" | "redmineId" | "ticket" | "system" | "status" | "priority" | "sheetType";
+export type BatchColumnMappingInput = {
+    /** 0-based index into raw rows for the header line */
+    headerRowIndex: number;
+    /** Header label or 0-based column index per role */
+    columns: Partial<Record<BatchColumnRole, string | number>>;
+};
+export type BatchColumnFieldSchemaEntry = {
+    role: BatchColumnRole;
+    required: boolean;
+    redmineUse: string;
+    /**
+     * When set, this mapped role feeds the Steps to Reproduce custom field (Bug/Task)
+     * at this priority. Not a separate sheet column — agent maps these roles only.
+     */
+    stepsToReproducePriority?: number;
+};
+/**
+ * Steps to Reproduce is never its own sheet column. Workflow derives it from mapped roles.
+ * Returned on map_columns / confirm_mapping so the agent does not invent a column.
+ */
+export declare const STEPS_TO_REPRODUCE_RULE: {
+    readonly notASheetColumn: true;
+    readonly doNotMapSeparateColumn: true;
+    readonly appliesToTrackers: readonly ["Bug", "Task"];
+    readonly valuePriority: readonly [{
+        readonly priority: 1;
+        readonly source: "comments";
+        readonly role: BatchColumnRole;
+        readonly label: "comments role (e.g. Comments / Question, RT Comment)";
+    }, {
+        readonly priority: 2;
+        readonly source: "description";
+        readonly role: BatchColumnRole;
+        readonly label: "description role (Description column when present)";
+    }, {
+        readonly priority: 3;
+        readonly source: "issueSubject";
+        readonly roles: BatchColumnRole[];
+        readonly label: "issue subject — first line of subtask cell, else userStory cell";
+    }, {
+        readonly priority: 4;
+        readonly source: "fallback";
+        readonly label: "\"...\"";
+    }];
+    readonly summary: "Map comments and description roles when headers exist. Bug/Task Steps to Reproduce is filled automatically from those mapped values, then issue subject — never map a dedicated Steps to Reproduce column.";
+};
+export declare const BATCH_COLUMN_FIELD_SCHEMA: BatchColumnFieldSchemaEntry[];
+export type ColumnMappingProblem = {
+    role: BatchColumnRole;
+    issue: string;
+    spec?: string | number;
+};
+export type ColumnMappingValidation = {
+    valid: boolean;
+    problems: ColumnMappingProblem[];
+    detectedHeaders: string[];
+    headerRowIndex: number;
+};
+export type SuggestedColumnMapping = {
+    headerRowIndex: number;
+    columns: Partial<Record<BatchColumnRole, string>>;
+    suggestedColumnIndices: Partial<Record<BatchColumnRole, number>>;
+    unmappedOptionalRoles: BatchColumnRole[];
+    ambiguousRoles: BatchColumnRole[];
+};
+/**
+ * Derive column roles from detected headers (MCP — agent uses this, no repo file search).
+ * Recognizes User Stories + Tasks layout as well as Task + Sub-Tasks.
+ */
+export declare function suggestColumnMappingFromHeaders(headers: string[], headerRowIndex: number): SuggestedColumnMapping;
+/** Resolved Steps to Reproduce sources for a concrete columnMapping (MCP + mapping preview). */
+export declare function buildStepsToReproduceMappingSection(mapping: BatchColumnMappingInput, headers: string[]): string;
+/** Validate agent columnMapping before building the issue tree. */
+export declare function validateColumnMapping(raw: RawBatchSheet, mapping: BatchColumnMappingInput): ColumnMappingValidation;
+/** AskQuestion prompts for map_columns / fix_column_mapping steps. */
+export declare function buildColumnMappingQuestions(validation: ColumnMappingValidation, options?: {
+    includeOptional?: boolean;
+}): Array<{
+    id: string;
+    field: string;
+    question: string;
+    options: string[];
+}>;
+/** Human-readable table of agent columnMapping for confirm_mapping step. */
+export declare function buildMappingPreview(mapping: BatchColumnMappingInput, headers: string[]): string;
+export declare function columnMappingToSheetMap(headers: string[], mapping: BatchColumnMappingInput): BatchSheetColumnMap;
+export declare function parseBatchWithColumnMapping(raw: RawBatchSheet, mapping: BatchColumnMappingInput): BatchParseResult;
+//# sourceMappingURL=batchColumnMapping.d.ts.map

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

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