@mc1global/opencode-jarvis 0.1.1 → 0.3.0

package/dist/application/azure-sync/push-use-cases.js

@@ -0,0 +1,341 @@
+/**
+ * Azure Sync Application — Use Cases
+ *
+ * Orchestrates discover, push, and sync-status operations.
+ * Coordinates between azure-sync domain, kanban BC, and Azure DevOps.
+ *
+ * SOLID: SRP — sync orchestration only
+ * SOLID: DIP — depends on interfaces (ports, repositories)
+ * DDD: Application service coordinating bounded contexts
+ */
+import { ok, fail, Timestamp } from "../../domain/shared/value-objects.js";
+import { FieldMapper, AZURE_FIELDS, sanitizeIterationName } from "../../domain/azure-sync/services.js";
+import { SyncMapping, SyncLog } from "../../domain/azure-sync/entities.js";
+import { SyncMappingId, SyncLogId, WorkItemId } from "../../domain/azure-sync/value-objects.js";
+import { AzureFieldBuilder } from "./field-builders.js";
+import { TaskPushUseCases } from "./task-push-use-cases.js";
+// ─── Use Cases ────────────────────────────────────────────────────────────────
+/**
+ * Orchestrates Azure DevOps sync operations.
+ * Coordinates local kanban data with Azure DevOps Board via REST API.
+ */
+export class AzureSyncUseCases {
+    deps;
+    fieldMapper = new FieldMapper();
+    fieldBuilder = new AzureFieldBuilder(this.fieldMapper);
+    taskPush;
+    constructor(deps) {
+        this.deps = deps;
+        this.taskPush = new TaskPushUseCases({
+            azureClient: deps.azureClient,
+            syncMappingRepo: deps.syncMappingRepo,
+            syncLogRepo: deps.syncLogRepo,
+        });
+    }
+    // ── Discover ──────────────────────────────────────────────────────
+    /** Detect project template, list existing work items and iterations. */
+    async discover(req) {
+        const projResult = await this.deps.azureClient.getProjectInfo(req.org, req.project);
+        if (!projResult.success)
+            return projResult;
+        const proj = projResult.data;
+        const wiType = this.fieldMapper.mapWorkItemType(proj.processTemplate, "card");
+        let workItems = [];
+        if (wiType) {
+            const wiResult = await this.deps.azureClient.listWorkItems(req.org, req.project, wiType, 50);
+            if (wiResult.success) {
+                workItems = wiResult.data.map((wi) => {
+                    const f = wi.fields;
+                    return {
+                        id: wi.id,
+                        title: String(f[AZURE_FIELDS.TITLE] ?? ""),
+                        type: String(f[AZURE_FIELDS.WORK_ITEM_TYPE] ?? ""),
+                        state: String(f[AZURE_FIELDS.STATE] ?? ""),
+                        tags: String(f[AZURE_FIELDS.TAGS] ?? ""),
+                    };
+                });
+            }
+        }
+        const iterResult = await this.deps.azureClient.listIterations(req.org, req.project);
+        const iterations = iterResult.success
+            ? iterResult.data.map((it) => ({
+                name: it.name,
+                path: it.path,
+                startDate: it.attributes?.startDate,
+                finishDate: it.attributes?.finishDate,
+            }))
+            : [];
+        const types = wiType ? ["Epic", wiType, "Task"] : ["Epic", "Task"];
+        return ok({
+            projectName: proj.name,
+            projectId: proj.id,
+            processTemplate: proj.processTemplate,
+            workItemTypes: types,
+            existingWorkItems: workItems,
+            iterations,
+        });
+    }
+    // ── Push ──────────────────────────────────────────────────────────
+    /** Push local entities to Azure DevOps as work items. */
+    async push(req) {
+        const projResult = await this.deps.azureClient.getProjectInfo(req.org, req.project);
+        if (!projResult.success)
+            return projResult;
+        const template = projResult.data.processTemplate;
+        const pushed = [];
+        const skipped = [];
+        const errors = [];
+        if (req.entityType === "epic" || req.entityType === "all") {
+            await this.pushEpics(req, template, pushed, skipped, errors);
+        }
+        if (req.entityType === "card" || req.entityType === "all") {
+            await this.pushCards(req, template, pushed, skipped, errors);
+        }
+        if (req.entityType === "sprint" || req.entityType === "all") {
+            await this.pushSprints(req, template, pushed, skipped, errors);
+        }
+        const summary = `Pushed ${pushed.length}, skipped ${skipped.length}, errors ${errors.length}`;
+        return ok({ pushed, skipped, errors, summary });
+    }
+    // ── Sync Status ───────────────────────────────────────────────────
+    /** Show diff between local kanban and Azure DevOps board. */
+    async syncStatus(req) {
+        const mappings = await this.deps.syncMappingRepo.findByProject(req.project);
+        const mappingItems = mappings.map((m) => ({
+            localId: m.localId,
+            localTitle: m.localId,
+            azureWorkItemId: m.azureWorkItemId.value,
+            syncStatus: m.syncStatus,
+            lastSyncedAt: m.lastSyncedAt.toISO(),
+            localModifiedAt: m.localModifiedAt.toISO(),
+            azureModifiedAt: m.azureModifiedAt.toISO(),
+        }));
+        // Find local cards not yet mapped
+        const cardsResult = await this.deps.cardUseCases.listCards({
+            workspace: req.workspace,
+        });
+        const localCards = cardsResult.success ? cardsResult.data : [];
+        const mappedLocalIds = new Set(mappings.map((m) => m.localId));
+        const unmappedLocal = localCards
+            .filter((c) => !mappedLocalIds.has(c.id))
+            .map((c) => ({
+            localId: c.id,
+            localTitle: c.title,
+            entityType: "card",
+        }));
+        const summary = `${mappingItems.length} synced, ${unmappedLocal.length} local-only`;
+        return ok({
+            mappings: mappingItems,
+            unmappedLocal,
+            unmappedAzure: [],
+            summary,
+        });
+    }
+    // ── Config ────────────────────────────────────────────────────────
+    /** Show current config and test connectivity. */
+    async configStatus() {
+        const config = this.deps.configService.getAzureSyncConfig();
+        const connResult = await this.deps.azureClient.testConnection();
+        return ok({
+            organization: config.organization,
+            project: config.project,
+            repository: config.repository,
+            authMethod: config.authMethod,
+            defaultSyncDirection: config.defaultSyncDirection,
+            autoDetectTemplate: config.autoDetectTemplate,
+            connectionStatus: connResult.success
+                ? "Connected"
+                : `Failed: ${connResult.error}`,
+        });
+    }
+    // ── Private: Push Epics ─────────────────────────────────────────
+    async pushEpics(req, template, pushed, _skipped, errors) {
+        const epicsResult = await this.deps.epicUseCases.listEpics({
+            workspace: req.workspace,
+        });
+        if (!epicsResult.success) {
+            errors.push({ localId: "epics", error: epicsResult.error });
+            return;
+        }
+        const epics = req.entityId
+            ? epicsResult.data.filter((e) => e.id === req.entityId)
+            : epicsResult.data;
+        for (const epic of epics) {
+            try {
+                const result = await this.pushSingleEntity(req, template, epic.id, "epic", epic.title, this.fieldBuilder.buildEpicFields(epic, template));
+                if (result.success) {
+                    pushed.push(result.data);
+                }
+                else {
+                    errors.push({ localId: epic.id, error: result.error });
+                }
+            }
+            catch (err) {
+                errors.push({
+                    localId: epic.id,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    // ── Private: Push Cards ─────────────────────────────────────────
+    async pushCards(req, template, pushed, _skipped, errors) {
+        const cardsResult = await this.deps.cardUseCases.listCards({
+            workspace: req.workspace,
+        });
+        if (!cardsResult.success) {
+            errors.push({ localId: "cards", error: cardsResult.error });
+            return;
+        }
+        // Build sprint -> iteration path map for card assignment
+        const iterationPathMap = await this.buildIterationPathMap(req);
+        const cards = req.entityId
+            ? cardsResult.data.filter((c) => c.id === req.entityId)
+            : cardsResult.data;
+        for (const card of cards) {
+            try {
+                const iterationPath = card.sprintId
+                    ? iterationPathMap.get(card.sprintId)
+                    : undefined;
+                const fields = this.fieldBuilder.buildCardFields({ ...card, iterationPath }, template);
+                const result = await this.pushSingleEntity(req, template, card.id, "card", card.title, fields);
+                if (result.success) {
+                    pushed.push(result.data);
+                    // Link to parent epic if mapped
+                    if (card.epicId) {
+                        await this.linkToParentEpic(req, result.data.azureWorkItemId, card.epicId);
+                    }
+                    // Push AC as child Tasks
+                    if (card.acceptanceCriteria.length > 0) {
+                        const taskResult = await this.taskPush.pushCardTasks(req.org, req.project, template, card, result.data.azureWorkItemId, iterationPath);
+                        pushed.push(...taskResult.pushed);
+                        errors.push(...taskResult.errors);
+                    }
+                }
+                else {
+                    errors.push({ localId: card.id, error: result.error });
+                }
+            }
+            catch (err) {
+                errors.push({
+                    localId: card.id,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    // ── Private: Push Sprints ───────────────────────────────────────
+    async pushSprints(req, _template, pushed, skipped, errors) {
+        const sprintsResult = await this.deps.sprintUseCases.listSprints({
+            workspace: req.workspace,
+        });
+        if (!sprintsResult.success) {
+            errors.push({ localId: "sprints", error: sprintsResult.error });
+            return;
+        }
+        const sprints = req.entityId
+            ? sprintsResult.data.filter((s) => s.id === req.entityId)
+            : sprintsResult.data;
+        for (const sprint of sprints) {
+            try {
+                const sanitizedName = sanitizeIterationName(sprint.name);
+                const iterResult = await this.deps.azureClient.createIteration(req.org, req.project, sanitizedName, sprint.startDate, sprint.endDate);
+                if (iterResult.success) {
+                    // Register iteration with the default team so it appears in sprint views
+                    await this.deps.azureClient.addIterationToTeam(req.org, req.project, iterResult.data.id);
+                    pushed.push({
+                        localId: sprint.id,
+                        localTitle: sprint.name,
+                        azureWorkItemId: 0,
+                        action: "created",
+                        url: iterResult.data.path,
+                    });
+                }
+                else {
+                    // Iteration may already exist — treat as skip
+                    skipped.push({
+                        localId: sprint.id,
+                        reason: `Iteration may already exist: ${iterResult.error}`,
+                    });
+                }
+            }
+            catch (err) {
+                errors.push({
+                    localId: sprint.id,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    /** Build a map of local sprint ID -> Azure iteration path. */
+    async buildIterationPathMap(req) {
+        const map = new Map();
+        const sprintsResult = await this.deps.sprintUseCases.listSprints({
+            workspace: req.workspace,
+        });
+        if (!sprintsResult.success)
+            return map;
+        for (const sprint of sprintsResult.data) {
+            const sanitizedName = sanitizeIterationName(sprint.name);
+            map.set(sprint.id, `${req.project}\\${sanitizedName}`);
+        }
+        return map;
+    }
+    async pushSingleEntity(req, template, localId, entityType, title, fields) {
+        const existing = await this.deps.syncMappingRepo.findByLocalId(localId, entityType);
+        const wiType = this.fieldMapper.mapWorkItemType(template, entityType);
+        if (!wiType) {
+            return fail(`No work item type mapping for ${entityType} on ${template}`);
+        }
+        let action;
+        let azureId, azureRev, url;
+        let mappingId;
+        if (existing) {
+            const res = await this.deps.azureClient.updateWorkItem(req.org, req.project, existing.azureWorkItemId.value, fields);
+            if (!res.success)
+                return res;
+            action = "updated";
+            azureId = res.data.id;
+            azureRev = res.data.rev;
+            url = res.data.url;
+            mappingId = existing.id;
+            const now = Timestamp.now();
+            existing.markSynced(now, azureRev);
+            await this.deps.syncMappingRepo.save(existing);
+        }
+        else {
+            const res = await this.deps.azureClient.createWorkItem(req.org, req.project, wiType, fields);
+            if (!res.success)
+                return res;
+            action = "created";
+            azureId = res.data.id;
+            azureRev = res.data.rev;
+            url = res.data.url;
+            const now = Timestamp.now();
+            const seq = await this.deps.syncMappingRepo.nextMappingSequence();
+            mappingId = SyncMappingId.create(seq);
+            const mapping = SyncMapping.create({
+                id: mappingId, localId, localEntityType: entityType,
+                azureWorkItemId: WorkItemId.create(azureId),
+                azureProject: req.project, azureOrg: req.org,
+                processTemplate: template, syncDirection: "push", now, azureRevision: azureRev,
+            });
+            await this.deps.syncMappingRepo.save(mapping);
+        }
+        const logSeq = await this.deps.syncMappingRepo.nextLogSequence();
+        await this.deps.syncLogRepo.append(SyncLog.create({
+            id: SyncLogId.create(logSeq), mappingId, direction: "push",
+            status: "success",
+            detail: `${action} ${entityType} ${localId} as work item #${azureId}`,
+            timestamp: Timestamp.now(),
+        }));
+        return ok({ localId, localTitle: title, azureWorkItemId: azureId, action, url });
+    }
+    async linkToParentEpic(req, childWorkItemId, epicLocalId) {
+        const epicMapping = await this.deps.syncMappingRepo.findByLocalId(epicLocalId, "epic");
+        if (!epicMapping)
+            return;
+        await this.deps.azureClient.addParentLink(req.org, req.project, childWorkItemId, epicMapping.azureWorkItemId.value);
+    }
+}
+//# sourceMappingURL=push-use-cases.js.map

package/dist/application/azure-sync/push-use-cases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-use-cases.js","sourceRoot":"","sources":["../../../src/application/azure-sync/push-use-cases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAEhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAsB5D,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAKC;IAJZ,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAChC,YAAY,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,QAAQ,CAAmB;IAE5C,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC;YACnC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IAErE,wEAAwE;IACxE,KAAK,CAAC,QAAQ,CAAC,GAAoB;QACjC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAC3D,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,CACZ,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO,UAAU,CAAC;QAE3C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAC7C,IAAI,CAAC,eAAe,EACpB,MAAM,CACP,CAAC;QAEF,IAAI,SAAS,GAA0C,EAAE,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CACxD,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,EACX,MAAM,EACN,EAAE,CACH,CAAC;YACF,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;oBACnC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAiC,CAAC;oBAC/C,OAAO;wBACL,EAAE,EAAE,EAAE,CAAC,EAAE;wBACT,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;wBAC1C,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;wBAClD,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;wBAC1C,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;qBACzC,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAC3D,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,CACZ,CAAC;QACF,MAAM,UAAU,GACd,UAAU,CAAC,OAAO;YAChB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3B,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS;gBACnC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,UAAU;aACtC,CAAC,CAAC;YACL,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEnE,OAAO,EAAE,CAAC;YACR,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,aAAa,EAAE,KAAK;YACpB,iBAAiB,EAAE,SAAS;YAC5B,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IAErE,yDAAyD;IACzD,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAC3D,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,CACZ,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO,UAAU,CAAC;QAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC;QAEjD,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,MAAM,CAAC,MAAM,aAAa,OAAO,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9F,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,qEAAqE;IAErE,6DAA6D;IAC7D,KAAK,CAAC,UAAU,CACd,GAAsB;QAEtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAC5D,GAAG,CAAC,OAAO,CACZ,CAAC;QAEF,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,UAAU,EAAE,CAAC,CAAC,OAAO;YACrB,eAAe,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK;YACxC,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE;YACpC,eAAe,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE;YAC1C,eAAe,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE;SAC3C,CAAC,CAAC,CAAC;QAEJ,kCAAkC;QAClC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;YACzD,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;QACH,MAAM,UAAU,GACd,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,MAAM,aAAa,GAAG,UAAU;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACxC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,CAAC,CAAC,EAAE;YACb,UAAU,EAAE,CAAC,CAAC,KAAK;YACnB,UAAU,EAAE,MAAe;SAC5B,CAAC,CAAC,CAAC;QAEN,MAAM,OAAO,GACX,GAAG,YAAY,CAAC,MAAM,YAAY,aAAa,CAAC,MAAM,aAAa,CAAC;QAEtE,OAAO,EAAE,CAAC;YACR,QAAQ,EAAE,YAAY;YACtB,aAAa;YACb,aAAa,EAAE,EAAE;YACjB,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IAErE,iDAAiD;IACjD,KAAK,CAAC,YAAY;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;QAEhE,OAAO,EAAE,CAAC;YACR,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,gBAAgB,EAAE,UAAU,CAAC,OAAO;gBAClC,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,WAAW,UAAU,CAAC,KAAK,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IAE3D,KAAK,CAAC,SAAS,CACrB,GAAgB,EAChB,QAAyB,EACzB,MAAwB,EACxB,QAA2B,EAC3B,MAAuB;QAEvB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;YACzD,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ;YACxB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,QAAQ,CAAC;YACvD,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;QAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CACxC,GAAG,EACH,QAAQ,EACR,IAAI,CAAC,EAAE,EACP,MAAM,EACN,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAClD,CAAC;gBACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,mEAAmE;IAE3D,KAAK,CAAC,SAAS,CACrB,GAAgB,EAChB,QAAyB,EACzB,MAAwB,EACxB,QAA2B,EAC3B,MAAuB;QAEvB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;YACzD,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,yDAAyD;QACzD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAE/D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ;YACxB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,QAAQ,CAAC;YACvD,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;QAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ;oBACjC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;oBACrC,CAAC,CAAC,SAAS,CAAC;gBACd,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe,CAC9C,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,EAC1B,QAAQ,CACT,CAAC;gBACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CACxC,GAAG,EACH,QAAQ,EACR,IAAI,CAAC,EAAE,EACP,MAAM,EACN,IAAI,CAAC,KAAK,EACV,MAAM,CACP,CAAC;gBACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACzB,gCAAgC;oBAChC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChB,MAAM,IAAI,CAAC,gBAAgB,CACzB,GAAG,EACH,MAAM,CAAC,IAAI,CAAC,eAAe,EAC3B,IAAI,CAAC,MAAM,CACZ,CAAC;oBACJ,CAAC;oBACD,yBAAyB;oBACzB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACvC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAClD,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,EACX,QAAQ,EACR,IAAI,EACJ,MAAM,CAAC,IAAI,CAAC,eAAe,EAC3B,aAAa,CACd,CAAC;wBACF,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;wBAClC,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,mEAAmE;IAE3D,KAAK,CAAC,WAAW,CACvB,GAAgB,EAChB,SAA0B,EAC1B,MAAwB,EACxB,OAA0B,EAC1B,MAAuB;QAEvB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;YAC/D,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ;YAC1B,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,QAAQ,CAAC;YACzD,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;QAEvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAC5D,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,EACX,aAAa,EACb,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,OAAO,CACf,CAAC;gBACF,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;oBACvB,yEAAyE;oBACzE,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAC5C,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,EACX,UAAU,CAAC,IAAI,CAAC,EAAE,CACnB,CAAC;oBACF,MAAM,CAAC,IAAI,CAAC;wBACV,OAAO,EAAE,MAAM,CAAC,EAAE;wBAClB,UAAU,EAAE,MAAM,CAAC,IAAI;wBACvB,eAAe,EAAE,CAAC;wBAClB,MAAM,EAAE,SAAS;wBACjB,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI;qBAC1B,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,8CAA8C;oBAC9C,OAAO,CAAC,IAAI,CAAC;wBACX,OAAO,EAAE,MAAM,CAAC,EAAE;wBAClB,MAAM,EAAE,gCAAgC,UAAU,CAAC,KAAK,EAAE;qBAC3D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,MAAM,CAAC,EAAE;oBAClB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,8DAA8D;IACtD,KAAK,CAAC,qBAAqB,CACjC,GAAgB;QAEhB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;YAC/D,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC;QAEvC,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,GAAgB,EAChB,QAAyB,EACzB,OAAe,EACf,UAA2B,EAC3B,KAAa,EACb,MAAkC;QAElC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAC5D,OAAO,EACP,UAAU,CACX,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,iCAAiC,UAAU,OAAO,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,MAA6B,CAAC;QAClC,IAAI,OAAe,EAAE,QAAgB,EAAE,GAAW,CAAC;QACnD,IAAI,SAAwB,CAAC;QAE7B,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CACpD,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAC7D,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,OAAO,GAAG,CAAC;YAC7B,MAAM,GAAG,SAAS,CAAC;YACnB,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAC,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YACnE,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;YAC5B,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CACpD,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CACrC,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,OAAO,GAAG,CAAC;YAC7B,MAAM,GAAG,SAAS,CAAC;YACnB,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAC,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YACnE,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,mBAAmB,EAAE,CAAC;YAClE,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;gBACjC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU;gBACnD,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC3C,YAAY,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG;gBAC5C,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ;aAC/E,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,CAAC;QACjE,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAChD,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM;YAC1D,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,GAAG,MAAM,IAAI,UAAU,IAAI,OAAO,kBAAkB,OAAO,EAAE;YACrE,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE;SAC3B,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACnF,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,GAAgB,EAChB,eAAuB,EACvB,WAAmB;QAEnB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAC/D,WAAW,EACX,MAAM,CACP,CAAC;QACF,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CACvC,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,OAAO,EACX,eAAe,EACf,WAAW,CAAC,eAAe,CAAC,KAAK,CAClC,CAAC;IACJ,CAAC;CACF"}

package/dist/application/azure-sync/reverse-field-builder.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Azure Sync Application — Reverse Field Builder
+ *
+ * Extracts local entity data from Azure DevOps work item fields.
+ * Template-aware: handles field placement differences across
+ * Basic, Agile, Scrum, and CMMI process templates.
+ *
+ * SOLID: SRP — reverse field extraction only
+ * DDD: Application-layer transformation from Azure to local representation
+ */
+import type { AzureWorkItem } from "../../domain/azure-sync/ports.js";
+import type { ProcessTemplate, LocalKanbanState } from "../../domain/azure-sync/value-objects.js";
+import { FieldMapper } from "../../domain/azure-sync/services.js";
+/** Data extracted from an Azure work item for creating a local card. */
+export interface ExtractedCardData {
+    readonly title: string;
+    readonly description: string | undefined;
+    readonly priority: string;
+    readonly status: LocalKanbanState | undefined;
+    readonly storyPoints: number | undefined;
+    readonly acceptanceCriteria: readonly string[];
+}
+/** Data extracted from an Azure work item for creating a local epic. */
+export interface ExtractedEpicData {
+    readonly title: string;
+    readonly description: string | undefined;
+    readonly priority: string;
+}
+/**
+ * Extracts local entity properties from Azure DevOps work item fields.
+ * Template-aware: adapts extraction based on process template capabilities.
+ */
+export declare class ReverseFieldBuilder {
+    private readonly fieldMapper;
+    constructor(fieldMapper: FieldMapper);
+    /** Extract card data from an Azure work item. */
+    extractCardData(workItem: AzureWorkItem, template: ProcessTemplate): ExtractedCardData;
+    /** Extract epic data from an Azure work item. */
+    extractEpicData(workItem: AzureWorkItem): ExtractedEpicData;
+    /** Compute a list of changes between current local state and Azure data. */
+    diffCardChanges(local: {
+        title: string;
+        description: string | undefined;
+        priority: string;
+        status: string;
+    }, extracted: ExtractedCardData): readonly string[];
+    private extractPriority;
+    private extractString;
+    private extractTemplateFields;
+    private extractListItems;
+}
+//# sourceMappingURL=reverse-field-builder.d.ts.map

package/dist/application/azure-sync/reverse-field-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverse-field-builder.d.ts","sourceRoot":"","sources":["../../../src/application/azure-sync/reverse-field-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAClG,OAAO,EAAE,WAAW,EAAgB,MAAM,qCAAqC,CAAC;AAIhF,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAaD;;;GAGG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAErD,iDAAiD;IACjD,eAAe,CACb,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,eAAe,GACxB,iBAAiB;IAapB,iDAAiD;IACjD,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,iBAAiB;IAS3D,4EAA4E;IAC5E,eAAe,CACb,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC3F,SAAS,EAAE,iBAAiB,GAC3B,SAAS,MAAM,EAAE;IAmBpB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/application/azure-sync/reverse-field-builder.js

@@ -0,0 +1,130 @@
+/**
+ * Azure Sync Application — Reverse Field Builder
+ *
+ * Extracts local entity data from Azure DevOps work item fields.
+ * Template-aware: handles field placement differences across
+ * Basic, Agile, Scrum, and CMMI process templates.
+ *
+ * SOLID: SRP — reverse field extraction only
+ * DDD: Application-layer transformation from Azure to local representation
+ */
+import { FieldMapper, AZURE_FIELDS } from "../../domain/azure-sync/services.js";
+// ─── Priority Reverse Map ─────────────────────────────────────────────────────
+const AZURE_PRIORITY_TO_LOCAL = {
+    1: "high",
+    2: "medium",
+    3: "low",
+    4: "low",
+};
+// ─── Reverse Field Builder ────────────────────────────────────────────────────
+/**
+ * Extracts local entity properties from Azure DevOps work item fields.
+ * Template-aware: adapts extraction based on process template capabilities.
+ */
+export class ReverseFieldBuilder {
+    fieldMapper;
+    constructor(fieldMapper) {
+        this.fieldMapper = fieldMapper;
+    }
+    /** Extract card data from an Azure work item. */
+    extractCardData(workItem, template) {
+        const fields = workItem.fields;
+        const title = String(fields[AZURE_FIELDS.TITLE] ?? "");
+        const azureState = String(fields[AZURE_FIELDS.STATE] ?? "");
+        const status = this.fieldMapper.mapStateFromAzure(template, azureState);
+        const priority = this.extractPriority(fields);
+        const { description, storyPoints, acceptanceCriteria } = this.extractTemplateFields(fields, template);
+        return { title, description, priority, status, storyPoints, acceptanceCriteria };
+    }
+    /** Extract epic data from an Azure work item. */
+    extractEpicData(workItem) {
+        const fields = workItem.fields;
+        return {
+            title: String(fields[AZURE_FIELDS.TITLE] ?? ""),
+            description: this.extractString(fields, AZURE_FIELDS.DESCRIPTION),
+            priority: this.extractPriority(fields),
+        };
+    }
+    /** Compute a list of changes between current local state and Azure data. */
+    diffCardChanges(local, extracted) {
+        const changes = [];
+        if (local.title !== extracted.title) {
+            changes.push(`title: "${local.title}" -> "${extracted.title}"`);
+        }
+        if (local.description !== extracted.description) {
+            changes.push("description changed");
+        }
+        if (local.priority !== extracted.priority) {
+            changes.push(`priority: ${local.priority} -> ${extracted.priority}`);
+        }
+        if (extracted.status !== undefined && local.status !== extracted.status) {
+            changes.push(`status: ${local.status} -> ${extracted.status}`);
+        }
+        return changes;
+    }
+    // ── Private ─────────────────────────────────────────────────────
+    extractPriority(fields) {
+        const raw = fields[AZURE_FIELDS.PRIORITY];
+        if (typeof raw === "number") {
+            return AZURE_PRIORITY_TO_LOCAL[raw] ?? "medium";
+        }
+        return "medium";
+    }
+    extractString(fields, key) {
+        const val = fields[key];
+        if (typeof val === "string" && val.trim().length > 0)
+            return val.trim();
+        return undefined;
+    }
+    extractTemplateFields(fields, template) {
+        const mappings = this.fieldMapper.getFieldMappings(template);
+        const acMapping = mappings.find((m) => m.localField === "acceptanceCriteria");
+        const spMapping = mappings.find((m) => m.localField === "storyPoints");
+        let description;
+        let acceptanceCriteria = [];
+        let storyPoints;
+        if (acMapping && acMapping.fallback === "description") {
+            // Basic/CMMI: AC embedded in description HTML
+            const rawDesc = this.extractString(fields, AZURE_FIELDS.DESCRIPTION) ?? "";
+            const extracted = this.fieldMapper.extractAcceptanceCriteriaFromHtml(rawDesc);
+            description = extracted.description || undefined;
+            acceptanceCriteria = extracted.criteria;
+        }
+        else {
+            // Agile/Scrum: separate fields
+            description = this.extractString(fields, AZURE_FIELDS.DESCRIPTION);
+            if (acMapping) {
+                const acHtml = this.extractString(fields, acMapping.azureField);
+                if (acHtml) {
+                    acceptanceCriteria = this.extractListItems(acHtml);
+                }
+            }
+        }
+        if (spMapping && spMapping.fallback === "tag") {
+            // Basic/CMMI: SP in tags
+            const tags = String(fields[AZURE_FIELDS.TAGS] ?? "");
+            storyPoints = this.fieldMapper.extractStoryPointsFromTags(tags);
+        }
+        else if (spMapping) {
+            // Agile/Scrum: native field
+            const raw = fields[spMapping.azureField];
+            if (typeof raw === "number")
+                storyPoints = raw;
+        }
+        return { description, storyPoints, acceptanceCriteria };
+    }
+    extractListItems(html) {
+        const liRegex = /<li>\s*(.*?)\s*<\/li>/gi;
+        const items = [];
+        let match = liRegex.exec(html);
+        while (match !== null) {
+            const content = match[1];
+            if (content !== undefined && content.trim().length > 0) {
+                items.push(content.trim());
+            }
+            match = liRegex.exec(html);
+        }
+        return items;
+    }
+}
+//# sourceMappingURL=reverse-field-builder.js.map

package/dist/application/azure-sync/reverse-field-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverse-field-builder.js","sourceRoot":"","sources":["../../../src/application/azure-sync/reverse-field-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAqBhF,iFAAiF;AAEjF,MAAM,uBAAuB,GAAqC;IAChE,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,KAAK;CACT,CAAC;AAEF,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,WAAwB;QAAxB,gBAAW,GAAX,WAAW,CAAa;IAAG,CAAC;IAEzD,iDAAiD;IACjD,eAAe,CACb,QAAuB,EACvB,QAAyB;QAEzB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAiC,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAE9C,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,GACpD,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE/C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IACnF,CAAC;IAED,iDAAiD;IACjD,eAAe,CAAC,QAAuB;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAiC,CAAC;QAC1D,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC/C,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC;YACjE,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,eAAe,CACb,KAA2F,EAC3F,SAA4B;QAE5B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,KAAK,SAAS,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,mEAAmE;IAE3D,eAAe,CAAC,MAA+B;QACrD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;QAClD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,aAAa,CACnB,MAA+B,EAC/B,GAAW;QAEX,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,qBAAqB,CAC3B,MAA+B,EAC/B,QAAyB;QAMzB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,oBAAoB,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC;QAEvE,IAAI,WAA+B,CAAC;QACpC,IAAI,kBAAkB,GAAsB,EAAE,CAAC;QAC/C,IAAI,WAA+B,CAAC;QAEpC,IAAI,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YACtD,8CAA8C;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,iCAAiC,CAAC,OAAO,CAAC,CAAC;YAC9E,WAAW,GAAG,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC;YACjD,kBAAkB,GAAG,SAAS,CAAC,QAAQ,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,+BAA+B;YAC/B,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;YACnE,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;gBAChE,IAAI,MAAM,EAAE,CAAC;oBACX,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9C,yBAAyB;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC;QAClE,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,4BAA4B;YAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,WAAW,GAAG,GAAG,CAAC;QACjD,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAC1D,CAAC;IAEO,gBAAgB,CAAC,IAAY;QACnC,MAAM,OAAO,GAAG,yBAAyB,CAAC;QAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7B,CAAC;YACD,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/application/azure-sync/task-push-use-cases.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Azure Sync Application — Task Push Use Cases
+ *
+ * Pushes card acceptance criteria as Azure DevOps Task work items.
+ * Each AC becomes a child Task linked to the parent card work item.
+ * Tracks AC-Task mappings with local_entity_type 'task' and composite
+ * local IDs (e.g. "CD-005:AC-0", "CD-005:AC-1").
+ *
+ * SOLID: SRP — task push orchestration only (split from push-use-cases.ts)
+ * SOLID: DIP — depends on interfaces (ports, repositories)
+ * DDD: Application service coordinating bounded contexts
+ */
+import type { AzureDevOpsPort } from "../../domain/azure-sync/ports.js";
+import type { SyncMappingRepository, SyncLogRepository } from "../../domain/azure-sync/repositories.js";
+import type { ProcessTemplate } from "../../domain/azure-sync/value-objects.js";
+import type { PushResultItem, PushErrorItem } from "./dtos.js";
+/** Card data needed for task push. */
+export interface CardForTaskPush {
+    readonly id: string;
+    readonly title: string;
+    readonly acceptanceCriteria: readonly {
+        description: string;
+        met: boolean;
+    }[];
+    readonly sprintId: string | undefined;
+}
+/** Dependencies for TaskPushUseCases. */
+export interface TaskPushDeps {
+    readonly azureClient: AzureDevOpsPort;
+    readonly syncMappingRepo: SyncMappingRepository;
+    readonly syncLogRepo: SyncLogRepository;
+}
+/** Result of pushing tasks for a single card. */
+export interface TaskPushResult {
+    readonly pushed: readonly PushResultItem[];
+    readonly errors: readonly PushErrorItem[];
+}
+/**
+ * Build a composite local ID for an AC-derived task.
+ * Format: "{cardId}:AC-{index}" (e.g. "CD-005:AC-0").
+ */
+export declare function buildTaskLocalId(cardId: string, acIndex: number): string;
+/**
+ * Parse a composite task local ID back into card ID and AC index.
+ * Returns undefined if the format is invalid.
+ */
+export declare function parseTaskLocalId(localId: string): {
+    cardId: string;
+    acIndex: number;
+} | undefined;
+/**
+ * Pushes card acceptance criteria as Azure DevOps Task work items.
+ * Each AC maps to one Task, linked as child of the parent card work item.
+ */
+export declare class TaskPushUseCases {
+    private readonly deps;
+    private readonly fieldMapper;
+    private readonly fieldBuilder;
+    constructor(deps: TaskPushDeps);
+    /**
+     * Push all acceptance criteria for a card as Tasks in Azure DevOps.
+     * Creates new Tasks for unmapped AC, updates existing Tasks for mapped AC.
+     * Links each Task as child of the parent card work item.
+     */
+    pushCardTasks(org: string, project: string, template: ProcessTemplate, card: CardForTaskPush, parentWorkItemId: number, iterationPath: string | undefined): Promise<TaskPushResult>;
+    private pushSingleTask;
+}
+//# sourceMappingURL=task-push-use-cases.d.ts.map

package/dist/application/azure-sync/task-push-use-cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-push-use-cases.d.ts","sourceRoot":"","sources":["../../../src/application/azure-sync/task-push-use-cases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,kCAAkC,CAAC;AACzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAIxG,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,0CAA0C,CAAC;AAGjG,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI/D,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;CACzC;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAOjD;AAID;;;GAGG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;gBAE3C,IAAI,EAAE,YAAY;IAE/C;;;;OAIG;IACG,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,eAAe,EACrB,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAAC,cAAc,CAAC;YA0CZ,cAAc;CA0G7B"}