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

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-detection.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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>;
+/**
+ * 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;AA8BF;;;;;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,146 @@
+/**
+ * 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',
+};
+// 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,11 @@
+/**
+ * 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 './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,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/build/sync/index.js

@@ -0,0 +1,11 @@
+/**
+ * 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 './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,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

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

@@ -0,0 +1,130 @@
+/**
+ * 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
+ */
+export declare function buildPatchOperations(parsed: ParsedWorkItemFile, currentWorkItem: any): {
+    operations: any[];
+    skippedFields: 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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"}