@mc1global/opencode-jarvis 0.1.1 → 0.3.1

package/dist/domain/azure-sync/services.js

@@ -0,0 +1,316 @@
+/**
+ * Azure Sync Domain — Services
+ *
+ * FieldMapper adapts field mappings per Azure DevOps process template.
+ * ConflictResolver determines sync outcomes when both sides are modified.
+ *
+ * SOLID: SRP — each service has one responsibility
+ * SOLID: OCP — new templates added by extending mapping tables
+ * DDD: Domain services encapsulating logic that doesn't belong to entities
+ */
+import { FieldMapping, LOCAL_TO_AZURE_STATE, AZURE_TO_LOCAL_STATE, LOCAL_TO_AZURE_TYPE, } from "./value-objects.js";
+// ─── Azure DevOps Field References ───────────────────────────────────────────
+/** Well-known Azure DevOps field reference names. */
+export const AZURE_FIELDS = {
+    TITLE: "System.Title",
+    STATE: "System.State",
+    DESCRIPTION: "System.Description",
+    PRIORITY: "Microsoft.VSTS.Common.Priority",
+    ITERATION_PATH: "System.IterationPath",
+    AREA_PATH: "System.AreaPath",
+    WORK_ITEM_TYPE: "System.WorkItemType",
+    TAGS: "System.Tags",
+    // Agile-specific
+    STORY_POINTS: "Microsoft.VSTS.Scheduling.StoryPoints",
+    ACCEPTANCE_CRITERIA_HTML: "Microsoft.VSTS.Common.AcceptanceCriteria",
+    // Scrum-specific
+    EFFORT: "Microsoft.VSTS.Scheduling.Effort",
+};
+// ─── Per-Template Field Rules ─────────────────────────────────────────────────
+/** Fields available across all process templates. */
+const UNIVERSAL_FIELDS = [
+    { localField: "title", azureField: AZURE_FIELDS.TITLE, fallback: "none" },
+    {
+        localField: "description",
+        azureField: AZURE_FIELDS.DESCRIPTION,
+        fallback: "none",
+    },
+    {
+        localField: "priority",
+        azureField: AZURE_FIELDS.PRIORITY,
+        fallback: "none",
+    },
+    {
+        localField: "iterationPath",
+        azureField: AZURE_FIELDS.ITERATION_PATH,
+        fallback: "none",
+    },
+    {
+        localField: "areaPath",
+        azureField: AZURE_FIELDS.AREA_PATH,
+        fallback: "none",
+    },
+    { localField: "tags", azureField: AZURE_FIELDS.TAGS, fallback: "none" },
+];
+/** Additional field rules per process template (beyond universal). */
+const TEMPLATE_SPECIFIC_FIELDS = {
+    basic: [
+        { localField: "storyPoints", azureField: AZURE_FIELDS.TAGS, fallback: "tag" },
+        {
+            localField: "acceptanceCriteria",
+            azureField: AZURE_FIELDS.DESCRIPTION,
+            fallback: "description",
+        },
+    ],
+    agile: [
+        {
+            localField: "storyPoints",
+            azureField: AZURE_FIELDS.STORY_POINTS,
+            fallback: "none",
+        },
+        {
+            localField: "acceptanceCriteria",
+            azureField: AZURE_FIELDS.ACCEPTANCE_CRITERIA_HTML,
+            fallback: "none",
+        },
+    ],
+    scrum: [
+        {
+            localField: "storyPoints",
+            azureField: AZURE_FIELDS.EFFORT,
+            fallback: "none",
+        },
+        {
+            localField: "acceptanceCriteria",
+            azureField: AZURE_FIELDS.ACCEPTANCE_CRITERIA_HTML,
+            fallback: "none",
+        },
+    ],
+    cmmi: [
+        { localField: "storyPoints", azureField: AZURE_FIELDS.TAGS, fallback: "tag" },
+        {
+            localField: "acceptanceCriteria",
+            azureField: AZURE_FIELDS.DESCRIPTION,
+            fallback: "description",
+        },
+    ],
+};
+// ─── FieldMapper Service ──────────────────────────────────────────────────────
+/**
+ * Produces field mappings adapted to the target Azure DevOps process template.
+ * Handles the differences between Basic, Agile, Scrum, and CMMI templates
+ * by selecting the correct Azure field reference or applying fallback strategies.
+ */
+export class FieldMapper {
+    /**
+     * Get all field mappings for a given process template.
+     * Returns universal fields plus template-specific fields.
+     */
+    getFieldMappings(template) {
+        const universal = UNIVERSAL_FIELDS.map((r) => FieldMapping.create(r.localField, r.azureField, r.fallback));
+        const specific = TEMPLATE_SPECIFIC_FIELDS[template].map((r) => FieldMapping.create(r.localField, r.azureField, r.fallback));
+        return [...universal, ...specific];
+    }
+    /**
+     * Map a local kanban state to an Azure DevOps work item state.
+     * Returns the state string expected by Azure DevOps REST API.
+     */
+    mapStateToAzure(template, localState) {
+        const mapping = LOCAL_TO_AZURE_STATE[template];
+        return mapping[localState];
+    }
+    /**
+     * Map an Azure DevOps work item state to a local kanban state.
+     * Returns undefined if the Azure state is not recognized for this template.
+     */
+    mapStateFromAzure(template, azureState) {
+        const mapping = AZURE_TO_LOCAL_STATE[template];
+        return mapping[azureState];
+    }
+    /**
+     * Get the Azure DevOps work item type for a local entity type.
+     * Returns the work item type string for the REST API.
+     */
+    mapWorkItemType(template, localType) {
+        const mapping = LOCAL_TO_AZURE_TYPE[template];
+        return mapping[localType];
+    }
+    /**
+     * Build the Azure DevOps tag string for story points fallback.
+     * Used by Basic/CMMI templates that lack a native story points field.
+     * Format: "SP:N" appended to existing tags.
+     */
+    buildStoryPointsTag(points, existingTags) {
+        // Remove any existing SP tag
+        const filtered = existingTags
+            .split(";")
+            .map((t) => t.trim())
+            .filter((t) => !t.startsWith("SP:") && t.length > 0);
+        filtered.push(`SP:${points}`);
+        return filtered.join("; ");
+    }
+    /**
+     * Extract story points from an Azure DevOps tag string.
+     * Returns undefined if no SP tag is found.
+     */
+    extractStoryPointsFromTags(tags) {
+        const parts = tags.split(";").map((t) => t.trim());
+        const spTag = parts.find((t) => t.startsWith("SP:"));
+        if (!spTag)
+            return undefined;
+        const value = parseInt(spTag.substring(3), 10);
+        return isNaN(value) ? undefined : value;
+    }
+    /**
+     * Build acceptance criteria HTML to embed in the Description field.
+     * Used by Basic/CMMI templates that lack a dedicated AC field.
+     */
+    buildAcceptanceCriteriaHtml(description, criteria) {
+        if (criteria.length === 0)
+            return description;
+        const acHtml = criteria
+            .map((c) => `<li>${escapeHtml(c)}</li>`)
+            .join("");
+        const acSection = `<h3>Acceptance Criteria</h3><ul>${acHtml}</ul>`;
+        return description
+            ? `${description}<hr/>${acSection}`
+            : acSection;
+    }
+    /**
+     * Extract acceptance criteria from Description HTML.
+     * Looks for the AC section appended by buildAcceptanceCriteriaHtml.
+     * Handles Azure DevOps HTML normalization (whitespace, self-closing tags).
+     */
+    extractAcceptanceCriteriaFromHtml(html) {
+        // Azure DevOps normalizes HTML: <hr/> -> <hr>, adds whitespace around tags.
+        // Use a flexible regex to find the separator pattern.
+        const separatorPattern = /<hr\s*\/?>[\s]*<h3>\s*Acceptance Criteria\s*<\/h3>/i;
+        const separatorMatch = separatorPattern.exec(html);
+        if (!separatorMatch) {
+            return { description: html, criteria: [] };
+        }
+        const description = html.substring(0, separatorMatch.index).trim();
+        const acPart = html.substring(separatorMatch.index + separatorMatch[0].length);
+        // Flexible li extraction — handles whitespace around content
+        const liRegex = /<li>\s*(.*?)\s*<\/li>/gi;
+        const criteria = [];
+        let match = liRegex.exec(acPart);
+        while (match !== null) {
+            const content = match[1];
+            if (content !== undefined && content.trim().length > 0) {
+                criteria.push(unescapeHtml(content.trim()));
+            }
+            match = liRegex.exec(acPart);
+        }
+        return { description, criteria };
+    }
+}
+/**
+ * Resolves conflicts when both local and Azure sides have been modified
+ * since the last successful sync. Uses timestamp-based last-write-wins
+ * with revision checking.
+ */
+export class ConflictResolver {
+    /**
+     * Determine the sync outcome for a mapping with potential conflicts.
+     *
+     * Strategy:
+     * 1. If only one side modified → that side wins (no conflict)
+     * 2. If both modified → last-write-wins based on timestamps
+     * 3. If timestamps equal → Azure wins (external source of truth)
+     */
+    resolve(mapping, direction) {
+        const localNewer = mapping.isLocalNewer();
+        const azureNewer = mapping.isAzureNewer();
+        // No changes on either side
+        if (!localNewer && !azureNewer) {
+            return { winner: "skip", reason: "No changes detected on either side" };
+        }
+        // Only local changed — push is safe
+        if (localNewer && !azureNewer) {
+            if (direction === "pull") {
+                return {
+                    winner: "skip",
+                    reason: "Only local changes exist but direction is pull",
+                };
+            }
+            return { winner: "local", reason: "Only local side modified since last sync" };
+        }
+        // Only Azure changed — pull is safe
+        if (!localNewer && azureNewer) {
+            if (direction === "push") {
+                return {
+                    winner: "skip",
+                    reason: "Only Azure changes exist but direction is push",
+                };
+            }
+            return { winner: "azure", reason: "Only Azure side modified since last sync" };
+        }
+        // Both sides modified — true conflict
+        return this.resolveConflict(mapping, direction);
+    }
+    resolveConflict(mapping, direction) {
+        if (direction === "push") {
+            return {
+                winner: "local",
+                reason: "Both sides modified — push direction forces local wins",
+            };
+        }
+        if (direction === "pull") {
+            return {
+                winner: "azure",
+                reason: "Both sides modified — pull direction forces Azure wins",
+            };
+        }
+        // Bidirectional: last-write-wins
+        const localTime = mapping.localModifiedAt.value.getTime();
+        const azureTime = mapping.azureModifiedAt.value.getTime();
+        if (localTime > azureTime) {
+            return {
+                winner: "local",
+                reason: "Both sides modified — local is newer (last-write-wins)",
+            };
+        }
+        // Azure wins on tie or when azure is newer
+        return {
+            winner: "azure",
+            reason: localTime === azureTime
+                ? "Both sides modified — timestamps equal, Azure wins as external source of truth"
+                : "Both sides modified — Azure is newer (last-write-wins)",
+        };
+    }
+}
+// ─── HTML Utilities ───────────────────────────────────────────────────────────
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function unescapeHtml(text) {
+    return text
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, "\"");
+}
+// ─── Iteration Name Sanitization ──────────────────────────────────────────────
+/**
+ * Characters forbidden in Azure DevOps classification node names.
+ * See: https://learn.microsoft.com/en-us/azure/devops/organizations/settings/naming-restrictions
+ */
+const INVALID_ITERATION_CHARS = /[\\/$?*:"&><#%|+;]/g;
+/**
+ * Sanitize a sprint name for use as an Azure DevOps iteration node name.
+ * Replaces invalid characters with dash, normalizes whitespace around dashes, trims.
+ */
+export function sanitizeIterationName(name) {
+    return name
+        .replace(INVALID_ITERATION_CHARS, "-")
+        .replace(/\s*-+\s*/g, " - ")
+        .replace(/ {2,}/g, " ")
+        .replace(/^[ -]+|[ -]+$/g, "")
+        .trim();
+}
+//# sourceMappingURL=services.js.map

package/dist/domain/azure-sync/services.js.map

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

package/dist/domain/azure-sync/value-objects.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Azure Sync Domain — Value Objects
+ *
+ * Identifiers, enums, and constrained types for the azure-sync bounded context.
+ * Models Azure DevOps concepts (organizations, work items, process templates)
+ * with validation and immutability. Zero external dependencies (pure domain).
+ *
+ * SOLID: SRP — each type models a single domain concept
+ * DDD: Value Objects compared by value, no identity of their own
+ */
+import { EntityId } from "../shared/value-objects.js";
+/** Sync mapping identifier (format: SM-NNN). */
+export declare class SyncMappingId extends EntityId {
+    private constructor();
+    static create(sequence: number): SyncMappingId;
+    static from(value: string): SyncMappingId;
+    get sequence(): number;
+}
+/** Sync log entry identifier (format: SL-NNN). */
+export declare class SyncLogId extends EntityId {
+    private constructor();
+    static create(sequence: number): SyncLogId;
+    static from(value: string): SyncLogId;
+    get sequence(): number;
+}
+/**
+ * Validated Azure DevOps organization URL.
+ * Accepts formats:
+ *   - https://dev.azure.com/{org}
+ *   - https://{org}.visualstudio.com
+ */
+export declare class AzureOrgUrl {
+    readonly value: string;
+    private static readonly DEV_AZURE_PATTERN;
+    private static readonly VSTS_PATTERN;
+    private constructor();
+    static create(url: string): AzureOrgUrl;
+    static from(value: string): AzureOrgUrl;
+    /** Extract the organization name from the URL. */
+    get orgName(): string;
+    equals(other: AzureOrgUrl): boolean;
+    toString(): string;
+}
+/**
+ * Azure DevOps work item numeric identifier.
+ * Always a positive integer assigned by Azure DevOps.
+ */
+export declare class WorkItemId {
+    readonly value: number;
+    private constructor();
+    static create(id: number): WorkItemId;
+    static from(value: number): WorkItemId;
+    equals(other: WorkItemId): boolean;
+    toString(): string;
+}
+/** Azure DevOps process templates that determine available fields and states. */
+export declare const PROCESS_TEMPLATES: readonly ["basic", "agile", "scrum", "cmmi"];
+export type ProcessTemplate = (typeof PROCESS_TEMPLATES)[number];
+export declare function isValidProcessTemplate(value: string): value is ProcessTemplate;
+/** Azure DevOps work item types across all process templates. */
+export declare const WORK_ITEM_TYPES: readonly ["Epic", "Issue", "Task", "User Story", "Product Backlog Item", "Bug", "Feature", "Requirement"];
+export type WorkItemType = (typeof WORK_ITEM_TYPES)[number];
+/**
+ * Maps local entity types to Azure DevOps work item types per process template.
+ * Local "card" maps to the primary work item type for the template.
+ */
+export declare const LOCAL_TO_AZURE_TYPE: Record<ProcessTemplate, Record<string, WorkItemType>>;
+export declare const SYNC_DIRECTIONS: readonly ["push", "pull", "bidirectional"];
+export type SyncDirection = (typeof SYNC_DIRECTIONS)[number];
+export declare function isValidSyncDirection(value: string): value is SyncDirection;
+export declare const SYNC_STATUSES: readonly ["pending", "synced", "conflict", "error", "stale"];
+export type SyncStatus = (typeof SYNC_STATUSES)[number];
+export declare function isValidSyncStatus(value: string): value is SyncStatus;
+/** Azure DevOps work item states per process template. */
+export declare const AZURE_STATES: Record<ProcessTemplate, readonly string[]>;
+/**
+ * Local kanban states ordered by workflow progression.
+ * Used for mapping to/from Azure DevOps states.
+ */
+export declare const LOCAL_KANBAN_STATES: readonly ["backlog", "grooming", "ready", "doing", "review", "blocked", "tested", "done"];
+export type LocalKanbanState = (typeof LOCAL_KANBAN_STATES)[number];
+/**
+ * Maps local kanban states to Azure DevOps states per process template.
+ * Multiple local states may map to a single Azure state.
+ */
+export declare const LOCAL_TO_AZURE_STATE: Record<ProcessTemplate, Record<LocalKanbanState, string>>;
+/**
+ * Maps Azure DevOps states back to the most likely local kanban state.
+ * Since the mapping is many-to-one, we pick the "earliest" local state
+ * that maps to the Azure state (conservative approach).
+ */
+export declare const AZURE_TO_LOCAL_STATE: Record<ProcessTemplate, Record<string, LocalKanbanState>>;
+/**
+ * Maps acceptance criteria "met" status to Azure DevOps Task states.
+ * Tasks have simpler state workflows than parent work items.
+ * met=true → completed state, met=false → initial state.
+ */
+export declare const TASK_STATE_FOR_MET: Record<ProcessTemplate, {
+    done: string;
+    todo: string;
+}>;
+/**
+ * Represents a mapping between a local field name and an Azure DevOps field reference.
+ * Some fields only exist on certain process templates; the `fallback` strategy
+ * specifies how to handle the field on templates that lack native support.
+ */
+export declare class FieldMapping {
+    readonly localField: string;
+    readonly azureField: string;
+    readonly fallback: FieldFallback;
+    private constructor();
+    static create(localField: string, azureField: string, fallback?: FieldFallback): FieldMapping;
+    static from(localField: string, azureField: string, fallback: FieldFallback): FieldMapping;
+    equals(other: FieldMapping): boolean;
+    toString(): string;
+}
+/** Strategy for handling fields that don't exist on the target process template. */
+export declare const FIELD_FALLBACKS: readonly ["none", "tag", "description", "skip"];
+export type FieldFallback = (typeof FIELD_FALLBACKS)[number];
+export declare function isValidFieldFallback(value: string): value is FieldFallback;
+/** Supported authentication methods for Azure DevOps REST API. */
+export declare const AUTH_METHODS: readonly ["az-cli", "pat"];
+export type AuthMethod = (typeof AUTH_METHODS)[number];
+export declare function isValidAuthMethod(value: string): value is AuthMethod;
+/** Local JARVIS entity types that can be synced to Azure DevOps. */
+export declare const LOCAL_ENTITY_TYPES: readonly ["card", "epic", "sprint", "task"];
+export type LocalEntityType = (typeof LOCAL_ENTITY_TYPES)[number];
+export declare function isValidLocalEntityType(value: string): value is LocalEntityType;
+//# sourceMappingURL=value-objects.d.ts.map

package/dist/domain/azure-sync/value-objects.d.ts.map

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