@amsterdamdatalabs/enact-factory 0.1.1

package/dist/azureDevOps/hierarchy.js

@@ -0,0 +1,470 @@
+// ============================================
+// EnactFactory - Azure DevOps Hierarchy Provisioning
+// ============================================
+//
+// Provisions a stable Epic -> Feature -> (PBI/Bug) hierarchy in production
+// Azure DevOps for orphaned work items (open PBIs/Bugs that have no parent).
+//
+// Design constraints:
+//  - This module CREATES real Epics/Features in production AzDO and re-parents
+//    work items. It MUST be idempotent: find-or-create, never duplicate.
+//  - Idempotency is enforced two ways:
+//      1. A persistent KV cache (store.getSyncMeta / setSyncMeta) keyed by
+//         project + title so repeated backfills (across process restarts)
+//         re-use the same Epic/Feature ids.
+//      2. A WIQL "find by title + type" probe so even a cold cache will adopt
+//         an existing Epic/Feature instead of creating a duplicate.
+//      3. An in-run Map cache so a single backfill over many orphans never
+//         re-hits getSyncMeta / WIQL for the same Epic/Feature.
+//  - One bad orphan never aborts the backfill (per-item try/catch -> errors[]).
+//
+// Naming scheme:
+//   Epic    : `${projectName}-v${major}.0.0`   (e.g. "enact-factory-v1.0.0")
+//   Feature : `v${major}.${minor}.0`           (e.g. "v1.3.0")    -- for PBIs
+//   Feature : "Maintenance"                     -- for Bugs
+// ============================================
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { areaToProjectId } from '../core/areaMapping.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Feature title used to collect all Bug-type orphans for a repo. */
+export const MAINTENANCE_FEATURE_TITLE = 'Maintenance';
+/** Default assignee stamped on every Epic/Feature this module creates. */
+const DEFAULT_ASSIGNEE = 'Tarun Rana <tarun.rana@amsterdamdatalabs.com>';
+/** Floor that all repos provision against (the user wants minimum v1.0.0). */
+const VERSION_FLOOR = { major: 1, minor: 0, patch: 0 };
+/**
+ * Read `${repoPath}/package.json` and parse its `version` semver.
+ * On any failure (missing file/field/parse error) returns the floor
+ * { major: 1, minor: 0, patch: 0 }. Major is always floored at 1.
+ */
+export function getRepoVersion(repoPath) {
+    try {
+        const pkgPath = join(repoPath, 'package.json');
+        const raw = readFileSync(pkgPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const version = parsed.version;
+        if (typeof version !== 'string')
+            return { ...VERSION_FLOOR };
+        // Strip a leading 'v' and any pre-release / build metadata suffix.
+        const core = version.trim().replace(/^v/i, '').split(/[-+]/)[0];
+        const parts = core.split('.');
+        const major = Number.parseInt(parts[0] ?? '', 10);
+        const minor = Number.parseInt(parts[1] ?? '', 10);
+        const patch = Number.parseInt(parts[2] ?? '', 10);
+        if (!Number.isFinite(major))
+            return { ...VERSION_FLOOR };
+        return {
+            major: Math.max(1, major),
+            minor: Number.isFinite(minor) ? Math.max(0, minor) : 0,
+            patch: Number.isFinite(patch) ? Math.max(0, patch) : 0,
+        };
+    }
+    catch {
+        return { ...VERSION_FLOOR };
+    }
+}
+// ---------------------------------------------------------------------------
+// Naming helpers (pure)
+// ---------------------------------------------------------------------------
+/** Epic title for a repo at a given major version, e.g. "enact-factory-v1.0.0". */
+export function epicTitle(projectName, major) {
+    return `${projectName}-v${Math.max(1, major)}.0.0`;
+}
+/** Feature title for a repo version line, e.g. "v1.3.0". */
+export function versionFeatureTitle(major, minor) {
+    return `v${Math.max(1, major)}.${minor}.0`;
+}
+/** Convert an area path slug into an AzDO area path, e.g. 'Enact/Factory' -> 'Enact\\Factory'. */
+export function areaToAzdoAreaPath(area) {
+    return area.replace(/\//g, '\\');
+}
+/** Basename of a path, e.g. '/repos/enact-factory' -> 'enact-factory'. */
+function pathBasename(p) {
+    const parts = p.replace(/[\\/]+$/, '').split(/[\\/]/);
+    return parts[parts.length - 1] ?? '';
+}
+/** Lowercase + hyphenate a name for tolerant comparison against a projectId. */
+function slugify(name) {
+    return name.trim().toLowerCase().replace(/[\s/_]+/g, '-');
+}
+/**
+ * Resolve the repo for a given area using the EXPLICIT hardcoded area->projectId
+ * mapping. Returns null when the area is not in the map (the caller then skips
+ * the orphan — intended). When mapped, the projectId slug is the repo name used
+ * for the Epic title; we best-effort recover a ProjectConfig path (by path
+ * basename or slugified name) for version detection — a miss floors to v1.0.0.
+ */
+export function resolveRepo(area, projects) {
+    const projectId = areaToProjectId(area);
+    if (!projectId)
+        return null;
+    const match = projects.find((p) => pathBasename(p.path) === projectId || slugify(p.name) === projectId);
+    return { name: projectId, path: match?.path };
+}
+// ---------------------------------------------------------------------------
+// Parent relation patch
+// ---------------------------------------------------------------------------
+/**
+ * Build the JSON-patch that parents a work item under `parentId`. Mirrors the
+ * shape in src/azdo/azdo.ts (createParentRelationPatch) but takes org/project
+ * explicitly so it has no dependency on global config.
+ */
+function buildParentRelationPatch(organization, project, parentId) {
+    return {
+        op: 'add',
+        path: '/relations/-',
+        value: {
+            rel: 'System.LinkTypes.Hierarchy-Reverse',
+            url: `https://dev.azure.com/${organization}/${project}/_apis/wit/workItems/${parentId}`,
+        },
+    };
+}
+function fieldPatch(path, value) {
+    return { op: 'add', path, value };
+}
+// ---------------------------------------------------------------------------
+// Retry (429 / 503 only)
+// ---------------------------------------------------------------------------
+function isRetryableStatus(err) {
+    const status = err?.status;
+    return status === 429 || status === 503;
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Retry `fn` on 429/503 with exponential backoff (capped). Any non-throttle
+ * error is rethrown immediately. Deliberately self-contained to avoid a
+ * dependency cycle with azureDevOpsSync.ts.
+ */
+export async function withRetry(fn, attempts = 3, baseMs = 1000, capMs = 30000) {
+    let lastErr;
+    for (let attempt = 0; attempt < attempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = err;
+            if (!isRetryableStatus(err) || attempt === attempts - 1)
+                throw err;
+            const delay = Math.min(capMs, baseMs * 2 ** attempt);
+            await sleep(delay);
+        }
+    }
+    throw lastErr;
+}
+// ---------------------------------------------------------------------------
+// Find-or-create
+// ---------------------------------------------------------------------------
+/** Escape a WIQL string literal by doubling embedded single quotes. */
+function escapeWiqlLiteral(value) {
+    return value.replace(/'/g, "''");
+}
+/**
+ * Find ALL work items of an exact title + type within a project via WIQL.
+ * Titles are NOT unique across repos (e.g. 'Maintenance', 'v1.0.0'), so callers
+ * that need a repo-scoped match must further filter by parent (see
+ * findFeatureUnderEpic). Returns every matching id.
+ */
+async function findWorkItemIdsByTitleAndType(client, project, type, title) {
+    const wiql = `SELECT [System.Id] FROM WorkItems WHERE ` +
+        `[System.TeamProject] = '${escapeWiqlLiteral(project)}' AND ` +
+        `[System.WorkItemType] = '${escapeWiqlLiteral(type)}' AND ` +
+        `[System.Title] = '${escapeWiqlLiteral(title)}'`;
+    return withRetry(() => client.queryByWiql(wiql));
+}
+/**
+ * Find a work item by exact title + type within a project via WIQL.
+ * Returns the first matching id, or null. Project-wide — only safe for items
+ * whose title is unique per project (Epics: '<projectId>-v<major>.0.0').
+ */
+export async function findWorkItemByTitleAndType(client, project, type, title) {
+    const ids = await findWorkItemIdsByTitleAndType(client, project, type, title);
+    return ids[0] ?? null;
+}
+/**
+ * Extract the parent work item id from a Hierarchy-Reverse relation, matching
+ * the extraction used by azureDevOpsSync.extractParentId (/workItems/(\d+)/i).
+ */
+function parentIdFromRelationUrl(url) {
+    if (!url)
+        return null;
+    const match = url.match(/workItems\/(\d+)/i);
+    return match ? Number(match[1]) : null;
+}
+/**
+ * Index of the work item's Hierarchy-Reverse (parent) relation within its
+ * relations array, or -1 if it has none. Used to build the `remove` patch when
+ * re-parenting (AzDO removes relations by positional index).
+ */
+function parentRelationIndex(workItem) {
+    const relations = workItem.relations ?? [];
+    return relations.findIndex((r) => r.rel === 'System.LinkTypes.Hierarchy-Reverse');
+}
+/**
+ * Find a Feature with `title` that is a CHILD of `epicId`. Feature titles are
+ * NOT unique across repos, so we WIQL all same-title Features in the project,
+ * batch-fetch them, and return the first whose Hierarchy-Reverse parent
+ * resolves to `epicId`. Returns null when no same-title Feature is parented to
+ * this Epic (caller then creates one under the correct Epic).
+ */
+export async function findFeatureUnderEpic(client, project, epicId, title) {
+    const candidateIds = await findWorkItemIdsByTitleAndType(client, project, 'Feature', title);
+    if (candidateIds.length === 0)
+        return null;
+    const candidates = await withRetry(() => client.getWorkItems(candidateIds));
+    for (const candidate of candidates) {
+        const parent = candidate.relations
+            ?.filter((r) => r.rel === 'System.LinkTypes.Hierarchy-Reverse')
+            .map((r) => parentIdFromRelationUrl(r.url))
+            .find((id) => id != null);
+        if (parent === epicId)
+            return candidate.id;
+    }
+    return null;
+}
+/**
+ * Resolve a cached id, checking the in-run memo first then the persistent KV
+ * store. Returns the id if present, else null. Populates the memo on a KV hit.
+ */
+async function readCachedId(ctx, cacheKey, validate) {
+    const memoHit = ctx.memo.get(cacheKey);
+    if (memoHit !== undefined) {
+        if (!validate || await validate(memoHit))
+            return memoHit;
+        ctx.memo.delete(cacheKey);
+    }
+    const stored = await ctx.deps.store.getSyncMeta(cacheKey);
+    if (stored != null) {
+        const id = Number.parseInt(stored, 10);
+        if (Number.isFinite(id) && id > 0) {
+            if (validate && !(await validate(id))) {
+                return null;
+            }
+            ctx.memo.set(cacheKey, id);
+            return id;
+        }
+    }
+    return null;
+}
+/** Persist a resolved id to both the in-run memo and the KV store. */
+async function writeCachedId(ctx, cacheKey, id) {
+    ctx.memo.set(cacheKey, id);
+    await ctx.deps.store.setSyncMeta(cacheKey, String(id));
+}
+async function validateEpicCacheHit(ctx, id, title) {
+    try {
+        const item = await withRetry(() => ctx.deps.client.getWorkItem(id));
+        return item.fields['System.WorkItemType'] === 'Epic'
+            && String(item.fields['System.Title'] ?? '') === title;
+    }
+    catch {
+        return false;
+    }
+}
+async function validateFeatureCacheHit(ctx, id, title, epicId) {
+    try {
+        const item = await withRetry(() => ctx.deps.client.getWorkItem(id));
+        if (item.fields['System.WorkItemType'] !== 'Feature')
+            return false;
+        if (String(item.fields['System.Title'] ?? '') !== title)
+            return false;
+        return parentRelationIndex(item) >= 0
+            && parentIdFromRelationUrl(item.relations?.[parentRelationIndex(item)]?.url) === epicId;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find-or-create the Epic for a repo's major version line. Idempotent via the
+ * cache key `azdo:epic:<cacheKeyName>`, falling back to a WIQL title probe, then
+ * to creation. Increments result.epicsCreated only on an actual create.
+ */
+async function ensureEpic(ctx, args) {
+    const { project, projectName, cacheKeyName, areaPath, major } = args;
+    const cacheKey = `azdo:epic:${cacheKeyName}`;
+    const title = epicTitle(projectName, major);
+    const cached = await readCachedId(ctx, cacheKey, async (id) => validateEpicCacheHit(ctx, id, title));
+    if (cached != null)
+        return cached;
+    const existing = await findWorkItemByTitleAndType(ctx.deps.client, project, 'Epic', title);
+    if (existing != null) {
+        await writeCachedId(ctx, cacheKey, existing);
+        return existing;
+    }
+    const created = await withRetry(() => ctx.deps.client.createWorkItem('Epic', [
+        fieldPatch('/fields/System.Title', title),
+        fieldPatch('/fields/System.AreaPath', areaPath),
+        fieldPatch('/fields/System.AssignedTo', DEFAULT_ASSIGNEE),
+    ]));
+    ctx.result.epicsCreated++;
+    await writeCachedId(ctx, cacheKey, created.id);
+    return created.id;
+}
+/**
+ * Find-or-create a Feature under `epicId`. Idempotent via the cache key
+ * `azdo:feature:<cacheKeyName>:<title>`, falling back to a PARENT-SCOPED probe
+ * (findFeatureUnderEpic), then to creation. When CREATING, the Feature is
+ * parented to the Epic in the same patch document. Increments
+ * result.featuresCreated only on an actual create.
+ *
+ * The probe MUST be scoped to this Epic: Feature titles ('Maintenance',
+ * 'v1.0.0') are not unique across repos, so a project-wide title match would
+ * mis-link a new repo's items under another repo's Feature.
+ *
+ * Note: on a find/cache hit we assume the Feature is already linked to its
+ * Epic (the only code path that creates these Features always links them).
+ */
+async function ensureFeature(ctx, args) {
+    const { project, cacheKeyName, areaPath, title, epicId } = args;
+    const cacheKey = `azdo:feature:${cacheKeyName}:${title}`;
+    const cached = await readCachedId(ctx, cacheKey, async (id) => validateFeatureCacheHit(ctx, id, title, epicId));
+    if (cached != null)
+        return cached;
+    const existing = await findFeatureUnderEpic(ctx.deps.client, project, epicId, title);
+    if (existing != null) {
+        await writeCachedId(ctx, cacheKey, existing);
+        return existing;
+    }
+    const created = await withRetry(() => ctx.deps.client.createWorkItem('Feature', [
+        fieldPatch('/fields/System.Title', title),
+        fieldPatch('/fields/System.AreaPath', areaPath),
+        fieldPatch('/fields/System.AssignedTo', DEFAULT_ASSIGNEE),
+        buildParentRelationPatch(ctx.deps.organization, ctx.deps.project, epicId),
+    ]));
+    ctx.result.featuresCreated++;
+    await writeCachedId(ctx, cacheKey, created.id);
+    return created.id;
+}
+/**
+ * Resolve the target Feature id for an item: find-or-create its Epic and the
+ * appropriate Feature (Bug -> Maintenance, PBI -> version line), all scoped to
+ * the item's repo. Returns null when the item can't be placed (unmapped area).
+ */
+async function resolveTargetFeature(ctx, item) {
+    // Resolve the owning repo via the explicit area->projectId map. An area not
+    // in the map is unresolvable -> caller skips (intended).
+    const repo = resolveRepo(item.area, ctx.deps.projects);
+    if (!repo)
+        return null;
+    const area = item.area; // resolveRepo guarantees a mapped area
+    // When the repo is configured we read its package.json; otherwise floor to
+    // v1.0.0 (the user's minimum) so a brand-new repo still provisions.
+    const version = repo.path ? getRepoVersion(repo.path) : { major: 1, minor: 0, patch: 0 };
+    const areaPath = areaToAzdoAreaPath(area);
+    const cacheKeyName = repo.name.toLowerCase();
+    const epicId = await ensureEpic(ctx, {
+        project: ctx.deps.project,
+        projectName: repo.name,
+        cacheKeyName,
+        areaPath,
+        major: version.major,
+    });
+    const featureTitle = item.kind === 'Bug'
+        ? MAINTENANCE_FEATURE_TITLE
+        : versionFeatureTitle(version.major, version.minor);
+    return ensureFeature(ctx, {
+        project: ctx.deps.project,
+        cacheKeyName,
+        areaPath,
+        title: featureTitle,
+        epicId,
+    });
+}
+/**
+ * Provision the Epic -> Feature hierarchy for a set of open executable items
+ * and CORRECT their parentage so each lands under the right per-repo Feature.
+ *
+ * The caller should pass ALL open PBIs/Bugs (each carrying its current AzDO
+ * parent id), not just parentless orphans — items mis-parented by an earlier
+ * buggy run are self-healed here. For each item:
+ *   - unmapped area / bad id -> skipped (no AzDO write)
+ *   - already under the correct Feature -> alreadyCorrect (no AzDO write)
+ *   - no parent -> add the parent link (linked)
+ *   - under a different (wrong) Feature -> remove the old relation + add the
+ *     new one in a single PATCH (reparented)
+ * Each item is processed in its own try/catch so one failure never aborts.
+ */
+export async function provisionHierarchy(deps, items) {
+    const ctx = {
+        deps,
+        memo: new Map(),
+        result: {
+            epicsCreated: 0,
+            featuresCreated: 0,
+            linked: 0,
+            reparented: 0,
+            alreadyCorrect: 0,
+            skipped: 0,
+            errors: [],
+        },
+    };
+    for (const item of items) {
+        try {
+            // Defend against malformed ids.
+            const numericId = Number(item.id);
+            if (!Number.isFinite(numericId) || numericId <= 0) {
+                ctx.result.skipped++;
+                continue;
+            }
+            const targetFeatureId = await resolveTargetFeature(ctx, item);
+            if (targetFeatureId == null) {
+                ctx.result.skipped++;
+                continue;
+            }
+            const currentParent = item.currentParentId != null ? Number(item.currentParentId) : null;
+            // Already correctly parented -> no write.
+            if (currentParent === targetFeatureId) {
+                ctx.result.alreadyCorrect++;
+                continue;
+            }
+            const addParent = buildParentRelationPatch(deps.organization, deps.project, targetFeatureId);
+            if (currentParent == null || !Number.isFinite(currentParent)) {
+                // No parent -> just add the link.
+                await withRetry(() => deps.client.updateWorkItem(numericId, [addParent]));
+                ctx.result.linked++;
+            }
+            else {
+                // Wrong parent -> remove the existing Hierarchy-Reverse relation by its
+                // positional index, then add the correct one, in a single PATCH.
+                const fetched = await withRetry(() => deps.client.getWorkItem(numericId));
+                const idx = parentRelationIndex(fetched);
+                const patches = [];
+                if (idx >= 0) {
+                    patches.push({ op: 'remove', path: `/relations/${idx}` });
+                }
+                patches.push(addParent);
+                await withRetry(() => deps.client.updateWorkItem(numericId, patches));
+                ctx.result.reparented++;
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            ctx.result.errors.push({ workItemId: item.id, message });
+        }
+    }
+    const r = ctx.result;
+    console.log(`[hierarchy] provisioned ${items.length} item(s): ` +
+        `epicsCreated=${r.epicsCreated} featuresCreated=${r.featuresCreated} ` +
+        `linked=${r.linked} reparented=${r.reparented} alreadyCorrect=${r.alreadyCorrect} ` +
+        `skipped=${r.skipped} errors=${r.errors.length}`);
+    return ctx.result;
+}
+/**
+ * Backward-compatible wrapper: provision hierarchy from WorkItemRecord orphans.
+ * Maps each record to a HierarchyItem, carrying its `parentId` as the current
+ * parent so the self-heal path applies. Prefer provisionHierarchy + the sync
+ * layer's extractParentId for the canonical (AzDO-sourced) current parent id.
+ */
+export async function provisionHierarchyForOrphans(deps, orphans) {
+    const items = orphans.map((o) => ({
+        id: o.id,
+        kind: o.kind,
+        area: o.area,
+        currentParentId: o.parentId ?? null,
+    }));
+    return provisionHierarchy(deps, items);
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/azureDevOps/hierarchy.js.map

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

package/dist/azureDevOps/mapper.d.ts

@@ -0,0 +1,101 @@
+import type { AzdoWorkItem, AzdoFieldPatch } from '../azureDevOps/client.js';
+import type { AzdoSyncConfig } from '../core/types.js';
+import type { WorkItemRecord } from '../workItems/schema.js';
+import type { WorkItemPayload, LayeredState, AzdoFields } from '../core/workItemPayload.js';
+import type { WorkItemKind, WorkItemState, EpicFeatureState, Area } from '../core/workItemModel.js';
+/** Thrown when an AzDO value cannot be mapped to an internal type. */
+export declare class MapperError extends Error {
+    constructor(message: string);
+}
+/**
+ * Maps our logical field display names to their AzDO reference names.
+ * Override individual entries via `createAzdoClient` config or pass inline.
+ * All values follow the AzDO pattern: 'System.*', 'Microsoft.VSTS.*', or 'Custom.*'.
+ */
+export interface AzdoFieldNames {
+    id: string;
+    workItemType: string;
+    title: string;
+    description: string;
+    areaPath: string;
+    state: string;
+    reason: string;
+    acceptanceCriteria: string;
+    reproSteps: string;
+    systemInfo: string;
+    severity: string;
+    priority: string;
+    startDate: string;
+    targetDate: string;
+    planWritten: string;
+    implementationComplete: string;
+    reviewPassed: string;
+    testsPassing: string;
+    docsUpdated: string;
+    mergedToDevelop: string;
+    assignedTo: string;
+    tags: string;
+    iterationPath: string;
+    operatorLane: string;
+    failureReason: string;
+}
+/**
+ * Default reference-name mapping.
+ * Callers may spread and override any entry.
+ */
+export declare const DEFAULT_FIELD_NAMES: AzdoFieldNames;
+/**
+ * Map AzDO `System.WorkItemType` to our `WorkItemKind`.
+ * Throws `MapperError` for unknown type strings.
+ */
+export declare function azdoToWorkItemKind(azdo: AzdoWorkItem): WorkItemKind;
+/**
+ * Map AzDO `System.State` to our `WorkItemState` discriminated union.
+ * Uses the kind to determine which tier state machine to apply.
+ */
+export declare function azdoToWorkItemState(azdo: AzdoWorkItem, syncConfig?: AzdoSyncConfig): WorkItemState | EpicFeatureState;
+/**
+ * Map AzDO area path to our `Area` type.
+ * Returns `null` for root-only paths (e.g. 'Enact' with no sub-area).
+ */
+export declare function azdoToArea(azdo: AzdoWorkItem): Area | null;
+/**
+ * Build a `LayeredState` from an AzDO work item.
+ * Execution snapshot and prSidecar are not present in AzDO — they default to null.
+ * The six Boolean fields are read from the custom field reference names.
+ */
+export declare function azdoToLayeredState(azdo: AzdoWorkItem, fieldNames?: AzdoFieldNames, syncConfig?: AzdoSyncConfig): LayeredState;
+/**
+ * Map an AzDO work item to a `Partial<WorkItemRecord>`.
+ * Only the fields that are present in both systems are populated.
+ */
+export declare function azdoToWorkItemRecord(azdo: AzdoWorkItem, syncConfig?: AzdoSyncConfig): Partial<WorkItemRecord>;
+/**
+ * Project an AzDO work item into the flat `AzdoFields` sub-object that gets
+ * embedded under `WorkItemPayload.azdoFields`. Pulls every field the board
+ * card or detail panel might want to render so the API doesn't need to
+ * round-trip back to AzDO on every request.
+ */
+export declare function azdoToAzdoFields(azdo: AzdoWorkItem, fieldNames?: AzdoFieldNames): AzdoFields;
+/**
+ * Map an AzDO work item to a full `WorkItemPayload`.
+ * Fields that cannot be derived from AzDO alone (worktreeLifecycle, execution snapshot)
+ * are set to `null`. Provider-specific fields land under `azdoFields`.
+ */
+export declare function azdoToWorkItemPayload(azdo: AzdoWorkItem, fieldNames?: AzdoFieldNames, syncConfig?: AzdoSyncConfig): WorkItemPayload;
+/**
+ * Build AzDO patches to set `System.State` (and optionally `System.Reason`)
+ * from a `WorkItemState` or `EpicFeatureState`.
+ */
+export declare function workItemStateToAzdoPatches(state: WorkItemState | EpicFeatureState, syncConfig?: AzdoSyncConfig): AzdoFieldPatch[];
+/**
+ * Build AzDO patches from a `LayeredState`.
+ * Maps business state + six lifecycle Boolean fields + review/resolution.
+ */
+export declare function layeredStateToAzdoPatches(state: LayeredState, fieldNames?: AzdoFieldNames, syncConfig?: AzdoSyncConfig): AzdoFieldPatch[];
+/**
+ * Build the full set of AzDO patches from a `WorkItemPayload`.
+ * Patches title, area, and all layered-state fields.
+ */
+export declare function payloadToAzdoPatches(payload: WorkItemPayload, fieldNames?: AzdoFieldNames, syncConfig?: AzdoSyncConfig): AzdoFieldPatch[];
+//# sourceMappingURL=mapper.d.ts.map

package/dist/azureDevOps/mapper.d.ts.map

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