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

package/build/sync/git-utils.js

@@ -0,0 +1,116 @@
+/**
+ * Git Utilities for Work Item Sync
+ *
+ * Handles git operations for auto-commit functionality.
+ * All git operations are optional and fail gracefully.
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import * as path from 'node:path';
+const execAsync = promisify(exec);
+/**
+ * Check if the current directory is a git repository
+ */
+export async function isGitRepo(cwd) {
+    try {
+        await execAsync('git rev-parse --is-inside-work-tree', {
+            cwd: cwd || process.cwd(),
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Git add a file
+ */
+async function gitAdd(filePath, cwd) {
+    await execAsync(`git add "${filePath}"`, {
+        cwd: cwd || process.cwd(),
+    });
+}
+/**
+ * Git commit with a message
+ */
+async function gitCommit(message, cwd) {
+    const { stdout } = await execAsync(`git commit -m "${message.replace(/"/g, '\\"')}"`, {
+        cwd: cwd || process.cwd(),
+    });
+    return stdout;
+}
+/**
+ * Auto-commit a work item file after pull
+ * Returns result indicating success or failure (non-blocking)
+ */
+export async function autoCommitPulledFile(filePath, workItemId, revision, cwd) {
+    try {
+        // Check if we're in a git repo
+        if (!await isGitRepo(cwd)) {
+            return {
+                committed: false,
+                error: 'Not a git repository',
+            };
+        }
+        // Get relative path for cleaner commit message
+        const workingDir = cwd || process.cwd();
+        const relativePath = path.relative(workingDir, filePath);
+        // Add the file
+        await gitAdd(filePath, workingDir);
+        // Commit with descriptive message
+        const commitMessage = `Pull user story #${workItemId} from ADO (rev ${revision})`;
+        await gitCommit(commitMessage, workingDir);
+        return {
+            committed: true,
+            message: commitMessage,
+        };
+    }
+    catch (error) {
+        // Git failures are non-blocking - log and continue
+        console.error(`Git auto-commit failed for work item #${workItemId}: ${error.message}`);
+        return {
+            committed: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * Auto-commit multiple work item files in a single commit
+ */
+export async function autoCommitMultipleFiles(files, revision, cwd) {
+    if (files.length === 0) {
+        return { committed: false, error: 'No files to commit' };
+    }
+    try {
+        // Check if we're in a git repo
+        if (!await isGitRepo(cwd)) {
+            return {
+                committed: false,
+                error: 'Not a git repository',
+            };
+        }
+        const workingDir = cwd || process.cwd();
+        // Add all files
+        for (const file of files) {
+            await gitAdd(file.filePath, workingDir);
+        }
+        // Build commit message
+        const ids = files.map(f => `#${f.workItemId}`).join(', ');
+        const commitMessage = files.length === 1
+            ? `Pull user story ${ids} from ADO`
+            : `Pull user stories ${ids} from ADO`;
+        await gitCommit(commitMessage, workingDir);
+        return {
+            committed: true,
+            message: commitMessage,
+        };
+    }
+    catch (error) {
+        console.error(`Git auto-commit failed: ${error.message}`);
+        return {
+            committed: false,
+            error: error.message,
+        };
+    }
+}
+//# sourceMappingURL=git-utils.js.map

package/build/sync/git-utils.js.map

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

package/build/sync/html-converter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * HTML to Markdown Converter
+ *
+ * Converts HTML content to Markdown format for ADO work item fields.
+ * Used for auto-converting HTML fields to markdown when syncing.
+ */
+/**
+ * Convert HTML content to Markdown
+ *
+ * @param html - HTML content string
+ * @returns Markdown formatted string
+ */
+export declare function htmlToMarkdown(html: string): string;
+/**
+ * Auto-convert HTML fields to markdown in ADO
+ *
+ * This function:
+ * 1. Converts HTML content to markdown using turndown
+ * 2. Updates the field value in ADO with the converted content
+ * 3. Sets the field format to Markdown (irreversible)
+ *
+ * @param service - Azure DevOps service instance
+ * @param project - Project name
+ * @param workItemId - Work item ID
+ * @param currentFields - Current field values from ADO
+ * @param fieldsToConvert - Fields to check and convert if HTML
+ * @returns Array of field names that were converted
+ */
+export declare function autoConvertFieldsToMarkdown(service: {
+    updateWorkItem: (project: string, workItemId: number, operations: any[]) => Promise<any>;
+}, project: string, workItemId: number, currentFields: Record<string, any>, fieldsToConvert: string[]): Promise<string[]>;
+//# sourceMappingURL=html-converter.d.ts.map

package/build/sync/html-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-converter.d.ts","sourceRoot":"","sources":["../../src/sync/html-converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE;IAAE,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,EACrG,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB"}

package/build/sync/html-converter.js

@@ -0,0 +1,91 @@
+/**
+ * HTML to Markdown Converter
+ *
+ * Converts HTML content to Markdown format for ADO work item fields.
+ * Used for auto-converting HTML fields to markdown when syncing.
+ */
+import TurndownService from 'turndown';
+import { isHtmlContent } from './html-detection.js';
+const turndown = new TurndownService({
+    headingStyle: 'atx', // Use # style headings
+    bulletListMarker: '-', // Use - for lists
+    codeBlockStyle: 'fenced', // Use ``` for code blocks
+    emDelimiter: '*', // Use * for emphasis
+    strongDelimiter: '**', // Use ** for strong
+});
+// Configure turndown to handle ADO-specific HTML patterns
+turndown.addRule('adoSpan', {
+    filter: ['span'],
+    replacement: (content) => content,
+});
+// Remove empty divs that ADO sometimes creates
+turndown.addRule('emptyDiv', {
+    filter: (node) => {
+        return node.nodeName === 'DIV' && !node.textContent?.trim();
+    },
+    replacement: () => '',
+});
+/**
+ * Convert HTML content to Markdown
+ *
+ * @param html - HTML content string
+ * @returns Markdown formatted string
+ */
+export function htmlToMarkdown(html) {
+    if (!html?.trim())
+        return '';
+    try {
+        const markdown = turndown.turndown(html);
+        // Clean up excessive newlines
+        return markdown.replace(/\n{3,}/g, '\n\n').trim();
+    }
+    catch (error) {
+        // If conversion fails, return the original content stripped of HTML tags
+        console.error('HTML to markdown conversion failed, stripping tags:', error);
+        return html.replace(/<[^>]*>/g, '').trim();
+    }
+}
+/**
+ * Auto-convert HTML fields to markdown in ADO
+ *
+ * This function:
+ * 1. Converts HTML content to markdown using turndown
+ * 2. Updates the field value in ADO with the converted content
+ * 3. Sets the field format to Markdown (irreversible)
+ *
+ * @param service - Azure DevOps service instance
+ * @param project - Project name
+ * @param workItemId - Work item ID
+ * @param currentFields - Current field values from ADO
+ * @param fieldsToConvert - Fields to check and convert if HTML
+ * @returns Array of field names that were converted
+ */
+export async function autoConvertFieldsToMarkdown(service, project, workItemId, currentFields, fieldsToConvert) {
+    const patchOperations = [];
+    const convertedFields = [];
+    for (const field of fieldsToConvert) {
+        const content = currentFields[field];
+        if (content && isHtmlContent(content)) {
+            const markdownContent = htmlToMarkdown(content);
+            // Update content with converted markdown
+            patchOperations.push({
+                op: 'replace',
+                path: `/fields/${field}`,
+                value: markdownContent,
+            });
+            // Set format to markdown (irreversible)
+            patchOperations.push({
+                op: 'add',
+                path: `/multilineFieldsFormat/${field}`,
+                value: 'Markdown',
+            });
+            convertedFields.push(field);
+        }
+    }
+    if (patchOperations.length > 0) {
+        await service.updateWorkItem(project, workItemId, patchOperations);
+        console.error(`Auto-converted ${convertedFields.length} HTML field(s) to markdown for work item #${workItemId}: ${convertedFields.join(', ')}`);
+    }
+    return convertedFields;
+}
+//# sourceMappingURL=html-converter.js.map

package/build/sync/html-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-converter.js","sourceRoot":"","sources":["../../src/sync/html-converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,eAAe,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;IACnC,YAAY,EAAE,KAAK,EAAS,uBAAuB;IACnD,gBAAgB,EAAE,GAAG,EAAO,kBAAkB;IAC9C,cAAc,EAAE,QAAQ,EAAI,0BAA0B;IACtD,WAAW,EAAE,GAAG,EAAY,qBAAqB;IACjD,eAAe,EAAE,IAAI,EAAO,oBAAoB;CACjD,CAAC,CAAC;AAEH,0DAA0D;AAC1D,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE;IAC1B,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;CAClC,CAAC,CAAC;AAEH,+CAA+C;AAC/C,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE;IAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,OAAO,IAAI,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;IACD,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE;CACtB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzC,8BAA8B;QAC9B,OAAO,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAqG,EACrG,OAAe,EACf,UAAkB,EAClB,aAAkC,EAClC,eAAyB;IAEzB,MAAM,eAAe,GAAU,EAAE,CAAC;IAClC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YAEhD,yCAAyC;YACzC,eAAe,CAAC,IAAI,CAAC;gBACnB,EAAE,EAAE,SAAS;gBACb,IAAI,EAAE,WAAW,KAAK,EAAE;gBACxB,KAAK,EAAE,eAAe;aACvB,CAAC,CAAC;YAEH,wCAAwC;YACxC,eAAe,CAAC,IAAI,CAAC;gBACnB,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,0BAA0B,KAAK,EAAE;gBACvC,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;YAEH,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,kBAAkB,eAAe,CAAC,MAAM,6CAA6C,UAAU,KAAK,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClJ,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/build/sync/html-detection.d.ts

@@ -0,0 +1,93 @@
+/**
+ * HTML Detection Utility
+ *
+ * Detects whether ADO work item content is HTML (legacy) or Markdown format.
+ * ADO supports both formats and we can only sync markdown fields.
+ */
+/**
+ * Additional custom fields that can be synced.
+ * These are configurable via environment variables since field names may vary by organization.
+ *
+ * Default field names are based on typical ADO custom field patterns.
+ * GUID-based fields (like pre/post deployment) may vary between organizations.
+ */
+export interface AdditionalFieldConfig {
+    howToTest: string;
+    deploymentInformation: string;
+    predeploymentSteps: string;
+    postdeploymentSteps: string;
+}
+/**
+ * Get additional field configuration from environment variables
+ * Falls back to common default field names
+ */
+export declare function getAdditionalFieldConfig(): AdditionalFieldConfig;
+/**
+ * Human-readable names for additional fields (for display/logging)
+ */
+export declare const ADDITIONAL_FIELD_DISPLAY_NAMES: Record<keyof AdditionalFieldConfig, string>;
+/**
+ * Large text fields that support markdown format in Azure DevOps.
+ * These are the standard ADO fields that can be set to markdown format.
+ */
+export declare const LARGE_TEXT_FIELDS: readonly ["System.Description", "Microsoft.VSTS.Common.AcceptanceCriteria", "Microsoft.VSTS.TCM.ReproSteps"];
+/**
+ * Get all large text fields including custom ones from config.
+ * Used to determine which fields should have markdown format set.
+ */
+export declare function getAllLargeTextFields(): string[];
+/**
+ * Check if content is HTML format (as opposed to markdown)
+ *
+ * @param content - The content string to check
+ * @returns true if content appears to be HTML, false if markdown or empty
+ */
+export declare function isHtmlContent(content: string | null | undefined): boolean;
+/**
+ * Field format result type
+ */
+export type FieldFormat = 'markdown' | 'html' | 'not_present';
+/**
+ * Result of checking additional field formats
+ */
+export interface AdditionalFieldFormats {
+    howToTest: FieldFormat;
+    deploymentInformation: FieldFormat;
+    predeploymentSteps: FieldFormat;
+    postdeploymentSteps: FieldFormat;
+}
+/**
+ * Full field format check result
+ */
+export interface FieldFormatResult {
+    description: 'markdown' | 'html';
+    acceptanceCriteria: 'markdown' | 'html';
+    ready: boolean;
+    warnings: string[];
+    additionalFields: AdditionalFieldFormats;
+    details: {
+        descriptionLength: number;
+        acceptanceCriteriaLength: number;
+    };
+}
+/**
+ * Check field formats for a work item
+ *
+ * Primary fields (Description, Acceptance Criteria): If HTML, work item is not ready for sync.
+ * Secondary fields (How to Test, Deployment fields): If HTML, warn but allow sync (skip those fields).
+ *
+ * @param workItem - The work item object from ADO API
+ * @returns Object with field format information
+ */
+export declare function checkFieldFormats(workItem: {
+    fields?: {
+        'System.Description'?: string;
+        'Microsoft.VSTS.Common.AcceptanceCriteria'?: string;
+        [key: string]: any;
+    };
+}): FieldFormatResult;
+/**
+ * Get human-readable conversion instructions
+ */
+export declare function getConversionInstructions(): string;
+//# sourceMappingURL=html-detection.d.ts.map

package/build/sync/html-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-detection.d.ts","sourceRoot":"","sources":["../../src/sync/html-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAOhE;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,qBAAqB,EAAE,MAAM,CAKtF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,8GAIpB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAShD;AA8BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAsBzE;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,WAAW,CAAC;IACvB,qBAAqB,EAAE,WAAW,CAAC;IACnC,kBAAkB,EAAE,WAAW,CAAC;IAChC,mBAAmB,EAAE,WAAW,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,kBAAkB,EAAE,UAAU,GAAG,MAAM,CAAC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,OAAO,EAAE;QACP,iBAAiB,EAAE,MAAM,CAAC;QAC1B,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,MAAM,CAAC,EAAE;QACP,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,0CAA0C,CAAC,EAAE,MAAM,CAAC;QACpD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH,GAAG,iBAAiB,CAmDpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAUlD"}

package/build/sync/html-detection.js

@@ -0,0 +1,169 @@
+/**
+ * HTML Detection Utility
+ *
+ * Detects whether ADO work item content is HTML (legacy) or Markdown format.
+ * ADO supports both formats and we can only sync markdown fields.
+ */
+/**
+ * Get additional field configuration from environment variables
+ * Falls back to common default field names
+ */
+export function getAdditionalFieldConfig() {
+    return {
+        howToTest: process.env.AZUREDEVOPS_SYNC_FIELD_HOW_TO_TEST || 'Custom.Howtotest',
+        deploymentInformation: process.env.AZUREDEVOPS_SYNC_FIELD_DEPLOYMENT_INFO || 'Custom.Deploymentinformation',
+        predeploymentSteps: process.env.AZUREDEVOPS_SYNC_FIELD_PREDEPLOY || 'Custom.7519d1bc-5305-4905-822b-2b380e61b154',
+        postdeploymentSteps: process.env.AZUREDEVOPS_SYNC_FIELD_POSTDEPLOY || 'Custom.abd6763f-a242-4938-85ed-bda419e34e7e',
+    };
+}
+/**
+ * Human-readable names for additional fields (for display/logging)
+ */
+export const ADDITIONAL_FIELD_DISPLAY_NAMES = {
+    howToTest: 'How to Test',
+    deploymentInformation: 'Deployment Information',
+    predeploymentSteps: 'Predeployment Steps',
+    postdeploymentSteps: 'Postdeployment Steps',
+};
+/**
+ * Large text fields that support markdown format in Azure DevOps.
+ * These are the standard ADO fields that can be set to markdown format.
+ */
+export const LARGE_TEXT_FIELDS = [
+    'System.Description',
+    'Microsoft.VSTS.Common.AcceptanceCriteria',
+    'Microsoft.VSTS.TCM.ReproSteps',
+];
+/**
+ * Get all large text fields including custom ones from config.
+ * Used to determine which fields should have markdown format set.
+ */
+export function getAllLargeTextFields() {
+    const config = getAdditionalFieldConfig();
+    return [
+        ...LARGE_TEXT_FIELDS,
+        config.howToTest,
+        config.deploymentInformation,
+        config.predeploymentSteps,
+        config.postdeploymentSteps,
+    ];
+}
+// Structural HTML patterns that indicate the content is HTML (not markdown)
+const HTML_STRUCTURAL_PATTERNS = [
+    /<div[^>]*>/i, // <div> tags
+    /<p[^>]*>/i, // <p> tags
+    /<h[1-6][^>]*>/i, // HTML heading tags
+    /<strong[^>]*>/i, // <strong> tags (instead of **)
+    /<em[^>]*>/i, // <em> tags (instead of *)
+    /<ul[^>]*>/i, // HTML unordered lists
+    /<ol[^>]*>/i, // HTML ordered lists
+    /<li[^>]*>/i, // List items in HTML
+    /<table[^>]*>/i, // HTML tables
+    /<tr[^>]*>/i, // Table rows
+    /<td[^>]*>/i, // Table cells
+    /<span[^>]*>/i, // Span elements (ADO often uses these)
+];
+// Markdown patterns that indicate the content is already markdown
+const MARKDOWN_PATTERNS = [
+    /^#{1,6}\s+/m, // Markdown headings (# Heading)
+    /\*\*[^*]+\*\*/, // Bold text with **
+    /^\s*[-*+]\s+/m, // Unordered list items (-, *, +)
+    /^\s*\d+\.\s+/m, // Numbered list items (1. item)
+    /\[.+?\]\(.+?\)/, // Markdown links [text](url)
+    /```[\s\S]*?```/, // Fenced code blocks
+    /`[^`]+`/, // Inline code
+    /^\s*>\s+/m, // Block quotes
+];
+/**
+ * Check if content is HTML format (as opposed to markdown)
+ *
+ * @param content - The content string to check
+ * @returns true if content appears to be HTML, false if markdown or empty
+ */
+export function isHtmlContent(content) {
+    if (!content?.trim()) {
+        return false;
+    }
+    // If clear markdown syntax is present, treat as markdown (even if some inline HTML exists)
+    // This handles cases where users mix markdown with allowed inline HTML
+    for (const pattern of MARKDOWN_PATTERNS) {
+        if (pattern.test(content)) {
+            return false;
+        }
+    }
+    // Check for structural HTML patterns that indicate this is HTML content
+    for (const pattern of HTML_STRUCTURAL_PATTERNS) {
+        if (pattern.test(content)) {
+            return true;
+        }
+    }
+    // Default to markdown (plain text is valid markdown)
+    return false;
+}
+/**
+ * Check field formats for a work item
+ *
+ * Primary fields (Description, Acceptance Criteria): If HTML, work item is not ready for sync.
+ * Secondary fields (How to Test, Deployment fields): If HTML, warn but allow sync (skip those fields).
+ *
+ * @param workItem - The work item object from ADO API
+ * @returns Object with field format information
+ */
+export function checkFieldFormats(workItem) {
+    const fields = workItem.fields || {};
+    const fieldConfig = getAdditionalFieldConfig();
+    const description = fields['System.Description'] || '';
+    const acceptanceCriteria = fields['Microsoft.VSTS.Common.AcceptanceCriteria'] || '';
+    const descriptionIsHtml = isHtmlContent(description);
+    const acceptanceCriteriaIsHtml = isHtmlContent(acceptanceCriteria);
+    // Check additional fields
+    const warnings = [];
+    const additionalFields = {
+        howToTest: 'not_present',
+        deploymentInformation: 'not_present',
+        predeploymentSteps: 'not_present',
+        postdeploymentSteps: 'not_present',
+    };
+    // Helper to check an additional field
+    const checkAdditionalField = (fieldName, configKey) => {
+        const content = fields[fieldName];
+        if (!content || !content.trim()) {
+            return 'not_present';
+        }
+        if (isHtmlContent(content)) {
+            warnings.push(`${ADDITIONAL_FIELD_DISPLAY_NAMES[configKey]} is HTML - will be skipped`);
+            return 'html';
+        }
+        return 'markdown';
+    };
+    additionalFields.howToTest = checkAdditionalField(fieldConfig.howToTest, 'howToTest');
+    additionalFields.deploymentInformation = checkAdditionalField(fieldConfig.deploymentInformation, 'deploymentInformation');
+    additionalFields.predeploymentSteps = checkAdditionalField(fieldConfig.predeploymentSteps, 'predeploymentSteps');
+    additionalFields.postdeploymentSteps = checkAdditionalField(fieldConfig.postdeploymentSteps, 'postdeploymentSteps');
+    return {
+        description: descriptionIsHtml ? 'html' : 'markdown',
+        acceptanceCriteria: acceptanceCriteriaIsHtml ? 'html' : 'markdown',
+        ready: !descriptionIsHtml && !acceptanceCriteriaIsHtml,
+        warnings,
+        additionalFields,
+        details: {
+            descriptionLength: description.length,
+            acceptanceCriteriaLength: acceptanceCriteria.length,
+        }
+    };
+}
+/**
+ * Get human-readable conversion instructions
+ */
+export function getConversionInstructions() {
+    return `To convert HTML fields to markdown in Azure DevOps:
+1. Open the work item in Azure DevOps
+2. Click in the Description or Acceptance Criteria field
+3. Look for the "Convert to Markdown" button in the toolbar
+4. Click it and confirm the conversion
+5. Save the work item
+6. Re-run the sync command
+
+Note: Some organizations may have HTML format enforced. Contact your ADO admin if the option is not available.`;
+}
+//# sourceMappingURL=html-detection.js.map

package/build/sync/html-detection.js.map

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

package/build/sync/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Work Item Sync Module
+ *
+ * Exports all sync-related utilities for syncing ADO work items to local markdown files.
+ */
+export * from './html-detection.js';
+export * from './html-converter.js';
+export * from './markdown-serializer.js';
+export * from './file-utils.js';
+export * from './git-utils.js';
+export * from './task-serializer.js';
+//# sourceMappingURL=index.d.ts.map

package/build/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/build/sync/index.js

@@ -0,0 +1,12 @@
+/**
+ * Work Item Sync Module
+ *
+ * Exports all sync-related utilities for syncing ADO work items to local markdown files.
+ */
+export * from './html-detection.js';
+export * from './html-converter.js';
+export * from './markdown-serializer.js';
+export * from './file-utils.js';
+export * from './git-utils.js';
+export * from './task-serializer.js';
+//# sourceMappingURL=index.js.map

package/build/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}