@mcp-consultant-tools/azure-devops 27.0.0-beta.1 → 27.0.0-beta.11

package/build/sync/markdown-serializer.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Markdown Serialization Utilities
+ *
+ * Convert between ADO work items and local markdown files.
+ * Uses YAML frontmatter for metadata and markdown sections for content.
+ */
+export interface WorkItemFrontmatter {
+    id: number;
+    title: string;
+    type: string;
+    state: string;
+    url: string;
+    assignedTo?: string;
+    storyPoints?: number;
+    parent?: number;
+    moscow?: string;
+    tags?: string[];
+    areaPath?: string;
+    iterationPath?: string;
+    lastSyncedRevision: number;
+    lastSyncedAt: string;
+}
+export interface AdditionalFields {
+    howToTest?: string;
+    deploymentInformation?: string;
+    predeploymentSteps?: string;
+    postdeploymentSteps?: string;
+}
+export interface ParsedWorkItemFile {
+    frontmatter: WorkItemFrontmatter;
+    description: string;
+    acceptanceCriteria: string;
+    additionalFields: AdditionalFields;
+    rawContent: string;
+}
+export interface CommentsFrontmatter {
+    id: number;
+    title: string;
+    commentCount: number;
+    lastSyncedAt: string;
+}
+export interface ParsedComment {
+    author: string;
+    date: string;
+    content: string;
+}
+/**
+ * Result of converting work item to markdown
+ */
+export interface WorkItemToMarkdownResult {
+    content: string;
+    skippedFields: string[];
+}
+/**
+ * Convert an ADO work item to markdown file content
+ *
+ * @param workItem - The work item from ADO API
+ * @param revision - The revision number
+ * @returns Object with markdown content and list of skipped fields (if any were HTML)
+ */
+export declare function workItemToMarkdown(workItem: any, revision: number): WorkItemToMarkdownResult;
+/**
+ * Parse a markdown file to extract frontmatter and content sections
+ */
+export declare function parseWorkItemMarkdown(content: string): ParsedWorkItemFile;
+/**
+ * Convert ADO comments to a read-only markdown file
+ */
+export declare function commentsToMarkdown(workItem: any, comments: any[]): string;
+/**
+ * Build ADO patch operations from parsed markdown changes
+ * Only updates fields that have actually changed.
+ * Auto-converts HTML fields to markdown format unless skipAutoConvert is true.
+ *
+ * @param parsed - Parsed work item file
+ * @param currentWorkItem - Current work item from ADO
+ * @param skipAutoConvert - Skip automatic HTML-to-markdown conversion (default: false)
+ */
+export declare function buildPatchOperations(parsed: ParsedWorkItemFile, currentWorkItem: any, skipAutoConvert?: boolean): {
+    operations: any[];
+    skippedFields: string[];
+    convertedFields: string[];
+};
+/**
+ * Update the lastSyncedRevision in a markdown file content
+ */
+export declare function updateSyncRevision(content: string, newRevision: number): string;
+/**
+ * Frontmatter for new work items (before they have an ID)
+ */
+export interface NewWorkItemFrontmatter {
+    title: string;
+    type: string;
+    state: string;
+    parent: number;
+    assignedTo?: string;
+    storyPoints?: number;
+    moscow?: string;
+    tags?: string[];
+    areaPath?: string;
+    iterationPath?: string;
+}
+/**
+ * Parsed new work item file structure
+ */
+export interface ParsedNewWorkItemFile {
+    frontmatter: NewWorkItemFrontmatter;
+    description: string;
+    acceptanceCriteria: string;
+    additionalFields: AdditionalFields;
+    rawContent: string;
+}
+/**
+ * Check if a work item frontmatter indicates a new (not yet created) work item
+ * New work items don't have an 'id' field
+ */
+export declare function isNewWorkItem(frontmatter: Record<string, any>): boolean;
+/**
+ * Parse a markdown file for a NEW work item (no id required)
+ */
+export declare function parseNewWorkItemMarkdown(content: string): ParsedNewWorkItemFile;
+/**
+ * Build ADO fields object for creating a new work item
+ * Inherits areaPath and iterationPath from parent work item
+ */
+export declare function buildNewWorkItemFields(parsed: ParsedNewWorkItemFile, parentWorkItem: any): Record<string, any>;
+/**
+ * Generate a new work item template markdown file
+ */
+export declare function generateNewWorkItemTemplate(parentId: number, parentTitle: string, project: string, workItemType?: string): string;
+/**
+ * Update a new work item file after creation with the assigned ID
+ * Converts it from a "new" file to a synced file with proper frontmatter
+ */
+export declare function convertNewFileToSynced(content: string, workItemId: number, revision: number, url: string): string;
+//# sourceMappingURL=markdown-serializer.d.ts.map

package/build/sync/markdown-serializer.d.ts.map

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