@mcp-consultant-tools/azure-devops 30.0.0-beta.9 → 31.0.0-beta.2

package/build/sync/field-aliases.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Frontmatter key → ADO reference name resolver.
+ *
+ * Frontmatter in synced markdown files uses raw ADO refnames as keys
+ * (e.g. `System.Title`, `Custom.ConsultancyProcess`). A small alias table
+ * provides friendly shortcuts for the most common fields so human-written
+ * files stay readable.
+ *
+ * Resolution rules:
+ *  1. Reserved keys (sync metadata) are returned as-is with a null refname.
+ *  2. Alias → refname lookup (case-sensitive).
+ *  3. Unknown keys are passed through unchanged (treated as refnames).
+ */
+/** Keys that are sync metadata, never sent to ADO as field updates. */
+export declare const RESERVED_FRONTMATTER_KEYS: Set<string>;
+/**
+ * Friendly aliases → ADO reference names. Add entries here when a field is
+ * common enough across clients to deserve a short key.
+ */
+export declare const FIELD_ALIASES: Record<string, string>;
+/**
+ * Resolve a frontmatter key to its ADO refname, or null if the key is reserved
+ * sync metadata.
+ */
+export declare function resolveRefname(key: string): string | null;
+/**
+ * When writing frontmatter from ADO data, pick the friendliest key for a given
+ * refname (alias if one exists, else the refname itself).
+ */
+export declare function preferredKey(refname: string): string;
+/**
+ * True when a frontmatter key is reserved sync metadata (not an ADO field).
+ */
+export declare function isReservedKey(key: string): boolean;
+//# sourceMappingURL=field-aliases.d.ts.map

package/build/sync/field-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-aliases.d.ts","sourceRoot":"","sources":["../../src/sync/field-aliases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,aASpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAehD,CAAC;AAWF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/build/sync/field-aliases.js

@@ -0,0 +1,76 @@
+/**
+ * Frontmatter key → ADO reference name resolver.
+ *
+ * Frontmatter in synced markdown files uses raw ADO refnames as keys
+ * (e.g. `System.Title`, `Custom.ConsultancyProcess`). A small alias table
+ * provides friendly shortcuts for the most common fields so human-written
+ * files stay readable.
+ *
+ * Resolution rules:
+ *  1. Reserved keys (sync metadata) are returned as-is with a null refname.
+ *  2. Alias → refname lookup (case-sensitive).
+ *  3. Unknown keys are passed through unchanged (treated as refnames).
+ */
+/** Keys that are sync metadata, never sent to ADO as field updates. */
+export const RESERVED_FRONTMATTER_KEYS = new Set([
+    'id',
+    'type',
+    'project',
+    'parent',
+    'parentTitle',
+    'url',
+    'lastSyncedRevision',
+    'lastSyncedAt',
+]);
+/**
+ * Friendly aliases → ADO reference names. Add entries here when a field is
+ * common enough across clients to deserve a short key.
+ */
+export const FIELD_ALIASES = {
+    title: 'System.Title',
+    state: 'System.State',
+    assignedTo: 'System.AssignedTo',
+    areaPath: 'System.AreaPath',
+    iterationPath: 'System.IterationPath',
+    tags: 'System.Tags',
+    priority: 'Microsoft.VSTS.Common.Priority',
+    severity: 'Microsoft.VSTS.Common.Severity',
+    storyPoints: 'Microsoft.VSTS.Scheduling.StoryPoints',
+    remainingWork: 'Microsoft.VSTS.Scheduling.RemainingWork',
+    effort: 'Microsoft.VSTS.Scheduling.Effort',
+    originalEstimate: 'Microsoft.VSTS.Scheduling.OriginalEstimate',
+    completedWork: 'Microsoft.VSTS.Scheduling.CompletedWork',
+    moscow: 'Custom.MoSCoW',
+};
+/** Reverse lookup: refname → canonical alias (first alias that resolves back). */
+const REFNAME_TO_ALIAS = (() => {
+    const map = {};
+    for (const [alias, refname] of Object.entries(FIELD_ALIASES)) {
+        if (!(refname in map))
+            map[refname] = alias;
+    }
+    return map;
+})();
+/**
+ * Resolve a frontmatter key to its ADO refname, or null if the key is reserved
+ * sync metadata.
+ */
+export function resolveRefname(key) {
+    if (RESERVED_FRONTMATTER_KEYS.has(key))
+        return null;
+    return FIELD_ALIASES[key] ?? key;
+}
+/**
+ * When writing frontmatter from ADO data, pick the friendliest key for a given
+ * refname (alias if one exists, else the refname itself).
+ */
+export function preferredKey(refname) {
+    return REFNAME_TO_ALIAS[refname] ?? refname;
+}
+/**
+ * True when a frontmatter key is reserved sync metadata (not an ADO field).
+ */
+export function isReservedKey(key) {
+    return RESERVED_FRONTMATTER_KEYS.has(key);
+}
+//# sourceMappingURL=field-aliases.js.map

package/build/sync/field-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-aliases.js","sourceRoot":"","sources":["../../src/sync/field-aliases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS;IACvD,IAAI;IACJ,MAAM;IACN,SAAS;IACT,QAAQ;IACR,aAAa;IACb,KAAK;IACL,oBAAoB;IACpB,cAAc;CACf,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,mBAAmB;IAC/B,QAAQ,EAAE,iBAAiB;IAC3B,aAAa,EAAE,sBAAsB;IACrC,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,gCAAgC;IAC1C,QAAQ,EAAE,gCAAgC;IAC1C,WAAW,EAAE,uCAAuC;IACpD,aAAa,EAAE,yCAAyC;IACxD,MAAM,EAAE,kCAAkC;IAC1C,gBAAgB,EAAE,4CAA4C;IAC9D,aAAa,EAAE,yCAAyC;IACxD,MAAM,EAAE,eAAe;CACxB,CAAC;AAEF,kFAAkF;AAClF,MAAM,gBAAgB,GAA2B,CAAC,GAAG,EAAE;IACrD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC;YAAE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC,EAAE,CAAC;AAEL;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -1 +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,CA0BnD;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"}
+{"version":3,"file":"html-converter.d.ts","sourceRoot":"","sources":["../../src/sync/html-converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmCH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BnD;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

@@ -18,10 +18,20 @@ turndown.addRule('adoSpan', {
     filter: ['span'],
     replacement: (content) => content,
 });
-// Remove empty divs that ADO sometimes creates
+// Remove empty divs that ADO sometimes creates.
+// IMPORTANT: do NOT strip divs whose only "content" is a meaningful element
+// like <img>, <iframe>, <video> etc. — those have no text content but are
+// not visually empty and stripping them silently deletes embedded media.
 turndown.addRule('emptyDiv', {
     filter: (node) => {
-        return node.nodeName === 'DIV' && !node.textContent?.trim();
+        if (node.nodeName !== 'DIV')
+            return false;
+        if (node.textContent?.trim())
+            return false;
+        if (node.querySelector?.('img, iframe, video, audio, picture, embed, object, svg, canvas')) {
+            return false;
+        }
+        return true;
     },
     replacement: () => '',
 });

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

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

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

@@ -1,93 +1,46 @@
 /**
- * HTML Detection Utility
+ * HTML detection for ADO large-text fields.
  *
- * 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.
+ * ADO supports both HTML and Markdown for long-text fields. Sync only
+ * works against markdown, so before pulling (or pushing) we auto-detect
+ * HTML and either convert it or report it as skipped.
  *
- * 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.
+ * This module is intentionally generic — it no longer maintains a fixed
+ * list of "additional" custom fields. Callers pass in the refname list
+ * they care about (usually derived from the loaded template).
  */
-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.
+ * Standard ADO large-text fields with native markdown support.
  */
-export declare function getAllLargeTextFields(): string[];
+export declare const STANDARD_LARGE_TEXT_FIELDS: readonly ["System.Description", "Microsoft.VSTS.Common.AcceptanceCriteria", "Microsoft.VSTS.TCM.ReproSteps"];
 /**
- * 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
+ * Return the list of large-text fields to check for a work item. Combines
+ * the standard set with any caller-supplied custom refnames (from the
+ * loaded template).
  */
+export declare function getAllLargeTextFields(customRefnames?: string[]): string[];
 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';
+    reproSteps: 'markdown' | 'html' | 'not_present';
     ready: boolean;
     warnings: string[];
-    additionalFields: AdditionalFieldFormats;
+    /** Format for each custom body field, keyed by refname. */
+    additionalFields: Record<string, FieldFormat>;
     details: {
         descriptionLength: number;
         acceptanceCriteriaLength: number;
+        reproStepsLength: 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
- */
+}, additionalRefnames?: string[]): FieldFormatResult;
 export declare function getConversionInstructions(): string;
 //# sourceMappingURL=html-detection.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"html-detection.d.ts","sourceRoot":"","sources":["../../src/sync/html-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B,8GAI7B,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAG7E;AAgCD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CASzE;AAMD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,kBAAkB,EAAE,UAAU,GAAG,MAAM,CAAC;IACxC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,OAAO,EAAE;QACP,iBAAiB,EAAE,MAAM,CAAC;QAC1B,wBAAwB,EAAE,MAAM,CAAC;QACjC,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE;IACR,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,EACD,kBAAkB,GAAE,MAAM,EAAO,GAChC,iBAAiB,CAqDnB;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAUlD"}

package/build/sync/html-detection.js

@@ -1,160 +1,119 @@
 /**
- * HTML Detection Utility
+ * HTML detection for ADO large-text fields.
  *
- * 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)
+ * ADO supports both HTML and Markdown for long-text fields. Sync only
+ * works against markdown, so before pulling (or pushing) we auto-detect
+ * HTML and either convert it or report it as skipped.
+ *
+ * This module is intentionally generic — it no longer maintains a fixed
+ * list of "additional" custom fields. Callers pass in the refname list
+ * they care about (usually derived from the loaded template).
  */
-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.
+ * Standard ADO large-text fields with native markdown support.
  */
-export const LARGE_TEXT_FIELDS = [
+export const STANDARD_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.
+ * Return the list of large-text fields to check for a work item. Combines
+ * the standard set with any caller-supplied custom refnames (from the
+ * loaded template).
  */
-export function getAllLargeTextFields() {
-    const config = getAdditionalFieldConfig();
-    return [
-        ...LARGE_TEXT_FIELDS,
-        config.howToTest,
-        config.deploymentInformation,
-        config.predeploymentSteps,
-        config.postdeploymentSteps,
-    ];
+export function getAllLargeTextFields(customRefnames = []) {
+    const set = new Set([...STANDARD_LARGE_TEXT_FIELDS, ...customRefnames]);
+    return [...set];
 }
-// Structural HTML patterns that indicate the content is HTML (not markdown)
+// ---------------------------------------------------------------------------
+// HTML detection (pattern-based heuristic)
+// ---------------------------------------------------------------------------
 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)
+    /<div[^>]*>/i,
+    /<p[^>]*>/i,
+    /<h[1-6][^>]*>/i,
+    /<strong[^>]*>/i,
+    /<em[^>]*>/i,
+    /<ul[^>]*>/i,
+    /<ol[^>]*>/i,
+    /<li[^>]*>/i,
+    /<table[^>]*>/i,
+    /<tr[^>]*>/i,
+    /<td[^>]*>/i,
+    /<span[^>]*>/i,
 ];
-// 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
+    /^#{1,6}\s+/m,
+    /\*\*[^*]+\*\*/,
+    /^\s*[-*+]\s+/m,
+    /^\s*\d+\.\s+/m,
+    /\[.+?\]\(.+?\)/,
+    /```[\s\S]*?```/,
+    /`[^`]+`/,
+    /^\s*>\s+/m,
 ];
-/**
- * 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()) {
+    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)) {
+        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)) {
+        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) {
+export function checkFieldFormats(workItem, additionalRefnames = []) {
     const fields = workItem.fields || {};
-    const fieldConfig = getAdditionalFieldConfig();
     const description = fields['System.Description'] || '';
     const acceptanceCriteria = fields['Microsoft.VSTS.Common.AcceptanceCriteria'] || '';
+    const reproSteps = fields['Microsoft.VSTS.TCM.ReproSteps'] || '';
     const descriptionIsHtml = isHtmlContent(description);
     const acceptanceCriteriaIsHtml = isHtmlContent(acceptanceCriteria);
-    // Check additional fields
+    const reproStepsIsHtml = isHtmlContent(reproSteps);
     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';
+    const additionalFields = {};
+    for (const refname of additionalRefnames) {
+        if (refname === 'System.Description' ||
+            refname === 'Microsoft.VSTS.Common.AcceptanceCriteria' ||
+            refname === 'Microsoft.VSTS.TCM.ReproSteps') {
+            // Covered by the dedicated slots above.
+            continue;
         }
-        if (isHtmlContent(content)) {
-            warnings.push(`${ADDITIONAL_FIELD_DISPLAY_NAMES[configKey]} is HTML - will be skipped`);
-            return 'html';
+        const content = fields[refname];
+        if (!content || (typeof content === 'string' && !content.trim())) {
+            additionalFields[refname] = 'not_present';
+            continue;
         }
-        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');
+        if (typeof content === 'string' && isHtmlContent(content)) {
+            warnings.push(`${refname} is HTML - will be skipped`);
+            additionalFields[refname] = 'html';
+        }
+        else {
+            additionalFields[refname] = 'markdown';
+        }
+    }
+    let reproStepsFormat = 'not_present';
+    if (reproSteps && reproSteps.trim()) {
+        reproStepsFormat = reproStepsIsHtml ? 'html' : 'markdown';
+    }
     return {
         description: descriptionIsHtml ? 'html' : 'markdown',
         acceptanceCriteria: acceptanceCriteriaIsHtml ? 'html' : 'markdown',
-        ready: !descriptionIsHtml && !acceptanceCriteriaIsHtml,
+        reproSteps: reproStepsFormat,
+        ready: !descriptionIsHtml && !acceptanceCriteriaIsHtml && reproStepsFormat !== 'html',
         warnings,
         additionalFields,
         details: {
             descriptionLength: description.length,
             acceptanceCriteriaLength: acceptanceCriteria.length,
-        }
+            reproStepsLength: reproSteps.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

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

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

package/build/sync/image-handler.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Image Reference Handler
+ *
+ * Detects and rewrites image references in ADO work item content.
+ *
+ * Two source forms are recognised:
+ *   - HTML <img src="..."> (raw HTML, typically pre-conversion)
+ *   - Markdown ![alt](src) (post Turndown conversion or hand-written)
+ *
+ * Each <img>/![] reference is parsed; if the URL points at an ADO work item
+ * attachment (`_apis/wit/attachments/{guid}`), we extract the GUID, fileName,
+ * and project GUID. Callers can then download the file and rewrite the source
+ * to a local relative path — or, on push, walk the manifest and rewrite local
+ * paths back to the original ADO URL.
+ */
+export interface AdoAttachmentRef {
+    /** Attachment GUID extracted from the URL path */
+    guid: string;
+    /** Filename inferred from the `fileName` query param or the alt text */
+    fileName: string;
+    /** Project GUID from the URL (e.g. e4476c68-75d1-4d4b-...) */
+    projectGuid?: string;
+    /** The full original URL */
+    originalUrl: string;
+}
+export interface ImageRef {
+    /** Original src/url string from the markdown or HTML */
+    originalSrc: string;
+    /** True when the src is an HTML <img src="..."> tag (vs markdown ![]()) */
+    isHtmlTag: boolean;
+    /** Index of the match in the source string (for ordered processing) */
+    index: number;
+    /** Length of the matched substring */
+    length: number;
+    /** Parsed ADO attachment metadata, when the URL is an ADO attachment */
+    adoAttachment?: AdoAttachmentRef;
+}
+/**
+ * Parse an ADO work item attachment URL.
+ *
+ * Recognised patterns:
+ *   https://dev.azure.com/{org}/{projectGuid}/_apis/wit/attachments/{guid}?fileName=image.png&...
+ *   https://dev.azure.com/{org}/_apis/wit/attachments/{guid}?fileName=image.png&...
+ *
+ * Returns null when the URL is not an ADO attachment URL.
+ */
+export declare function parseAdoAttachmentUrl(url: string): AdoAttachmentRef | null;
+/**
+ * Extract every image reference from a string of HTML or markdown content.
+ *
+ * Returns refs in source order. Both HTML <img> tags and markdown ![]() are
+ * detected. Refs whose URL parses as an ADO attachment have `adoAttachment`
+ * populated.
+ */
+export declare function extractImageRefs(content: string): ImageRef[];
+/**
+ * Rewrite image src/url values in content using a mapper function.
+ *
+ * The mapper receives the original src and the parsed ADO attachment (if any)
+ * and returns the new src to substitute. Returning null/undefined leaves the
+ * original src in place.
+ *
+ * Both HTML <img src="..."> and markdown ![](src) forms are rewritten.
+ */
+export declare function rewriteImageSrcs(content: string, mapper: (src: string, ado: AdoAttachmentRef | undefined) => string | null | undefined): string;
+//# sourceMappingURL=image-handler.d.ts.map

package/build/sync/image-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-handler.d.ts","sourceRoot":"","sources":["../../src/sync/image-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAgC1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAmC5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GACpF,MAAM,CA6BR"}