@mc1global/opencode-jarvis 0.13.1 → 0.14.0

package/dist/domain/kanban/enum-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-values.js","sourceRoot":"","sources":["../../../src/domain/kanban/enum-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAGzD,CAAC;AAEF,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAGpD,CAAC;AAEF,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAG7D,CAAC;AAEF,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAGzD,CAAC;AAEF,yEAAyE;AAEzE;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU,CAAC,KAAK;IAChB,UAAU,CAAC,OAAO;CACsB,CAAC"}

package/dist/domain/kanban/grooming.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Grooming Validator
+ *
+ * Validates that a card meets all criteria to transition from
+ * GROOMING to READY. This is the most important gate in the
+ * kanban lifecycle — where design, documentation, acceptance
+ * criteria, dependencies, and value propositions must be
+ * established before work can begin.
+ *
+ * Validation rules:
+ *   1. Card must be in grooming status
+ *   2. Must have a description (summary of the work)
+ *   3. Must have a scope document linked (vault artifact)
+ *   4. Must have >= 2 acceptance criteria
+ *   5. Each acceptance criterion must be >= MIN_AC_DESCRIPTION_LENGTH chars
+ *   6. Must have story points estimated
+ *   7. Must have an epic assigned
+ *   8. If card has blockers (blockedBy), they must be acknowledged
+ *      (this is a soft check — presence is validated, not resolution)
+ *
+ * SOLID: SRP - grooming validation only (separate from card lifecycle)
+ * SOLID: OCP - new rules can be added without modifying existing ones
+ * DDD: Domain Service (validation logic spanning card properties)
+ */
+import type { Card } from "./entities.js";
+/** Minimum acceptance criteria required for grooming completion. */
+export declare const MIN_ACCEPTANCE_CRITERIA = 2;
+export interface GroomingResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings: readonly string[];
+    readonly checklist: GroomingChecklist;
+}
+/**
+ * Detailed checklist showing which grooming requirements are met.
+ * Useful for agents and humans to see progress toward readiness.
+ */
+export interface GroomingChecklist {
+    readonly inGroomingStatus: boolean;
+    readonly hasDescription: boolean;
+    readonly hasScopeDoc: boolean;
+    readonly hasAcceptanceCriteria: boolean;
+    readonly acceptanceCriteriaQuality: boolean;
+    readonly hasStoryPoints: boolean;
+    readonly hasEpic: boolean;
+    readonly dependenciesAcknowledged: boolean;
+}
+/**
+ * Validates card readiness for the grooming -> ready transition.
+ * Stateless service: all input via method parameters.
+ */
+export declare class GroomingValidator {
+    /**
+     * Validate a card for grooming completion.
+     * Returns a result with all validation errors (not just the first),
+     * plus warnings for non-blocking issues and a detailed checklist.
+     */
+    validate(card: Card): GroomingResult;
+}
+//# sourceMappingURL=grooming.d.ts.map

package/dist/domain/kanban/grooming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grooming.d.ts","sourceRoot":"","sources":["../../../src/domain/kanban/grooming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;CAC5C;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc;CAoGrC"}

package/dist/domain/kanban/grooming.js

@@ -0,0 +1,113 @@
+/**
+ * Grooming Validator
+ *
+ * Validates that a card meets all criteria to transition from
+ * GROOMING to READY. This is the most important gate in the
+ * kanban lifecycle — where design, documentation, acceptance
+ * criteria, dependencies, and value propositions must be
+ * established before work can begin.
+ *
+ * Validation rules:
+ *   1. Card must be in grooming status
+ *   2. Must have a description (summary of the work)
+ *   3. Must have a scope document linked (vault artifact)
+ *   4. Must have >= 2 acceptance criteria
+ *   5. Each acceptance criterion must be >= MIN_AC_DESCRIPTION_LENGTH chars
+ *   6. Must have story points estimated
+ *   7. Must have an epic assigned
+ *   8. If card has blockers (blockedBy), they must be acknowledged
+ *      (this is a soft check — presence is validated, not resolution)
+ *
+ * SOLID: SRP - grooming validation only (separate from card lifecycle)
+ * SOLID: OCP - new rules can be added without modifying existing ones
+ * DDD: Domain Service (validation logic spanning card properties)
+ */
+import { CardStatus, MIN_AC_DESCRIPTION_LENGTH } from "./value-objects.js";
+/** Minimum acceptance criteria required for grooming completion. */
+export const MIN_ACCEPTANCE_CRITERIA = 2;
+/**
+ * Validates card readiness for the grooming -> ready transition.
+ * Stateless service: all input via method parameters.
+ */
+export class GroomingValidator {
+    /**
+     * Validate a card for grooming completion.
+     * Returns a result with all validation errors (not just the first),
+     * plus warnings for non-blocking issues and a detailed checklist.
+     */
+    validate(card) {
+        const errors = [];
+        const warnings = [];
+        // Rule 1: Must be in grooming status
+        const inGroomingStatus = card.status === CardStatus.Grooming;
+        if (!inGroomingStatus) {
+            errors.push(`Card must be in grooming status, current: "${card.status}"`);
+        }
+        // Rule 2: Must have a description (summary)
+        const hasDescription = card.description !== undefined && card.description.trim().length > 0;
+        if (!hasDescription) {
+            errors.push("Missing description (card summary required)");
+        }
+        // Rule 3: Must have a scope document linked
+        const hasScopeDoc = card.scopeDocPath !== undefined;
+        if (!hasScopeDoc) {
+            errors.push("Scope document not linked. " +
+                "1) Create a vault doc (vault-create-document path='12-Scope-Docs/CD-XXX-title.md'). " +
+                "2) Link it to this card using the kanban-card-scope-doc tool.");
+        }
+        // Rule 4: Must have >= 2 acceptance criteria
+        const hasAcceptanceCriteria = card.acceptanceCriteria.length >= MIN_ACCEPTANCE_CRITERIA;
+        if (!hasAcceptanceCriteria) {
+            errors.push(`Need at least ${MIN_ACCEPTANCE_CRITERIA} acceptance criteria, ` +
+                `found: ${card.acceptanceCriteria.length}`);
+        }
+        // Rule 5: Each AC must meet minimum quality (length)
+        const shortCriteria = card.acceptanceCriteria.filter((ac) => ac.description.length < MIN_AC_DESCRIPTION_LENGTH);
+        const acceptanceCriteriaQuality = shortCriteria.length === 0;
+        if (!acceptanceCriteriaQuality && card.acceptanceCriteria.length > 0) {
+            errors.push(`${shortCriteria.length} acceptance criteria too short ` +
+                `(min ${MIN_AC_DESCRIPTION_LENGTH} chars). ` +
+                `Criteria must be specific and measurable`);
+        }
+        // Rule 6: Must have story points
+        const hasStoryPoints = card.storyPoints !== undefined;
+        if (!hasStoryPoints) {
+            errors.push("Story points not estimated");
+        }
+        // Rule 7: Must have an epic
+        const hasEpic = card.epicId !== undefined;
+        if (!hasEpic) {
+            errors.push("Epic not assigned");
+        }
+        // Rule 8: Dependencies acknowledgement
+        // If the card has blockedBy entries, this is informational —
+        // the card can still pass grooming, but we warn about blockers
+        const dependenciesAcknowledged = true; // Always passes (soft check)
+        if (card.blockedBy.length > 0) {
+            const blockerIds = card.blockedBy.map((id) => id.value).join(", ");
+            warnings.push(`Card has ${card.blockedBy.length} blocker(s): ${blockerIds}. ` +
+                `Ensure blockers are documented in the scope document`);
+        }
+        // Report on dependsOn for awareness
+        if (card.dependsOn.length > 0) {
+            const depIds = card.dependsOn.map((id) => id.value).join(", ");
+            warnings.push(`Card depends on ${card.dependsOn.length} card(s): ${depIds}`);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            checklist: {
+                inGroomingStatus,
+                hasDescription,
+                hasScopeDoc,
+                hasAcceptanceCriteria,
+                acceptanceCriteriaQuality,
+                hasStoryPoints,
+                hasEpic,
+                dependenciesAcknowledged,
+            },
+        };
+    }
+}
+//# sourceMappingURL=grooming.js.map

package/dist/domain/kanban/grooming.js.map

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

package/dist/domain/kanban/repositories.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Kanban Repository Interfaces (Ports)
+ *
+ * DDD: Repository pattern - persistence abstraction in domain layer
+ * SOLID: DIP - domain defines interfaces, infrastructure implements
+ * SOLID: ISP - separate interfaces per aggregate root
+ */
+import type { WorkspaceId } from "../shared/value-objects.js";
+import type { Card } from "./entities.js";
+import type { Sprint, Epic } from "./sprint.js";
+import type { CardId, CardStatus, SprintId, EpicId } from "./value-objects.js";
+/** Persistence port for Card aggregate root. */
+export interface CardRepository {
+    save(card: Card): Promise<void>;
+    findById(id: CardId): Promise<Card | null>;
+    findByWorkspace(workspace: WorkspaceId, status?: CardStatus): Promise<readonly Card[]>;
+    findBySprint(sprintId: SprintId): Promise<readonly Card[]>;
+    findByEpic(epicId: EpicId): Promise<readonly Card[]>;
+    findByAgent(agent: string, workspace: WorkspaceId): Promise<readonly Card[]>;
+    countByStatus(workspace: WorkspaceId, status: CardStatus): Promise<number>;
+    nextSequence(workspace: WorkspaceId): Promise<number>;
+    delete(id: CardId): Promise<void>;
+}
+/** Persistence port for Sprint aggregate root. */
+export interface SprintRepository {
+    save(sprint: Sprint): Promise<void>;
+    findById(id: SprintId): Promise<Sprint | null>;
+    findByWorkspace(workspace: WorkspaceId): Promise<readonly Sprint[]>;
+    findActive(workspace: WorkspaceId): Promise<Sprint | null>;
+    nextSequence(workspace: WorkspaceId): Promise<number>;
+    delete(id: SprintId): Promise<void>;
+}
+/** Persistence port for Epic aggregate root. */
+export interface EpicRepository {
+    save(epic: Epic): Promise<void>;
+    findById(id: EpicId): Promise<Epic | null>;
+    findByWorkspace(workspace: WorkspaceId): Promise<readonly Epic[]>;
+    nextSequence(workspace: WorkspaceId): Promise<number>;
+    delete(id: EpicId): Promise<void>;
+}
+//# sourceMappingURL=repositories.d.ts.map

package/dist/domain/kanban/repositories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../../src/domain/kanban/repositories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE/E,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC3C,eAAe,CACb,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC5B,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC3D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC7E,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACpE,UAAU,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC3C,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAClE,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/domain/kanban/repositories.js

@@ -0,0 +1,9 @@
+/**
+ * Kanban Repository Interfaces (Ports)
+ *
+ * DDD: Repository pattern - persistence abstraction in domain layer
+ * SOLID: DIP - domain defines interfaces, infrastructure implements
+ * SOLID: ISP - separate interfaces per aggregate root
+ */
+export {};
+//# sourceMappingURL=repositories.js.map

package/dist/domain/kanban/repositories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.js","sourceRoot":"","sources":["../../../src/domain/kanban/repositories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/domain/kanban/services.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Kanban Domain Services
+ *
+ * Stateless services that coordinate operations across kanban aggregates.
+ * Enforces WIP limits, grooming validation on transitions, and
+ * review iteration limits.
+ *
+ * DDD: Domain Services - logic coordinating multiple aggregates
+ * SOLID: SRP - kanban workflow orchestration only
+ * SOLID: DIP - depends on repository interfaces, not implementations
+ */
+import type { WorkspaceId, Result } from "../shared/value-objects.js";
+import type { Card } from "./entities.js";
+import { CardStatus } from "./value-objects.js";
+import type { CardId, SprintId, EpicId, StoryPoints, GateTaskDefinition } from "./value-objects.js";
+import type { CardRepository } from "./repositories.js";
+/**
+ * Port for resolving gate task configuration.
+ * The domain service uses this to get gate definitions and interval settings
+ * without depending on the config bounded context directly.
+ *
+ * DDD: Port interface — domain defines, infrastructure/application implements
+ */
+export interface GateConfigPort {
+    /** Get gate task definitions for a given phase. Returns empty array if no gates configured. */
+    getGateDefinitions(phase: string): readonly GateTaskDefinition[];
+    /** Minimum seconds between status transitions. Returns 0 if no cooldown. */
+    getMinTransitionIntervalSecs(): number;
+}
+/**
+ * Orchestrates card lifecycle operations with cross-cutting validations.
+ */
+export declare class CardDomainService {
+    private readonly cardRepo;
+    private readonly gateConfig?;
+    private readonly groomingValidator;
+    constructor(cardRepo: CardRepository, gateConfig?: GateConfigPort | undefined);
+    /**
+     * Move a card to a new status with full validation:
+     * - State machine transition
+     * - WIP limits
+     * - Grooming validation (grooming -> ready)
+     * - Sprint/agent assignment checks
+     */
+    moveCard(cardId: CardId, targetStatus: CardStatus): Promise<Result<Card>>;
+    /** Assign card to an epic. */
+    assignToEpic(cardId: CardId, epicId: EpicId): Promise<Result<Card>>;
+    /** Assign card to a sprint. */
+    assignToSprint(cardId: CardId, sprintId: SprintId): Promise<Result<Card>>;
+    /** Set story points on a card. */
+    setStoryPoints(cardId: CardId, points: StoryPoints): Promise<Result<Card>>;
+    /** Assign an agent to a card. */
+    assignAgent(cardId: CardId, agent: string): Promise<Result<Card>>;
+    /** List cards by workspace with optional status filter. */
+    listCards(workspace: WorkspaceId, status?: CardStatus): Promise<Result<readonly Card[]>>;
+    /** Get a single card by ID. */
+    getCard(cardId: CardId): Promise<Result<Card | null>>;
+    /**
+     * Get board statistics: card count per status column.
+     */
+    getBoardStats(workspace: WorkspaceId): Promise<Result<Record<CardStatus, number>>>;
+}
+//# sourceMappingURL=services.d.ts.map

package/dist/domain/kanban/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/domain/kanban/services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAoC,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,MAAM,EACN,WAAW,EACX,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,+FAA+F;IAC/F,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE,CAAC;IAEjE,4EAA4E;IAC5E,4BAA4B,IAAI,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAJ9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;gBAG1C,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,cAAc,YAAA;IAG9C;;;;;;OAMG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IA4FxB,8BAA8B;IACxB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAazE,+BAA+B;IACzB,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAaxB,kCAAkC;IAC5B,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAaxB,iCAAiC;IAC3B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAavE,2DAA2D;IACrD,SAAS,CACb,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IASnC,+BAA+B;IACzB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAS3D;;OAEG;IACG,aAAa,CACjB,SAAS,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CAW/C"}

package/dist/domain/kanban/services.js

@@ -0,0 +1,192 @@
+/**
+ * Kanban Domain Services
+ *
+ * Stateless services that coordinate operations across kanban aggregates.
+ * Enforces WIP limits, grooming validation on transitions, and
+ * review iteration limits.
+ *
+ * DDD: Domain Services - logic coordinating multiple aggregates
+ * SOLID: SRP - kanban workflow orchestration only
+ * SOLID: DIP - depends on repository interfaces, not implementations
+ */
+import { ok, fail } from "../shared/value-objects.js";
+import { CardStatus, DEFAULT_WIP_LIMITS, GATED_PHASES } from "./value-objects.js";
+import { GroomingValidator } from "./grooming.js";
+/**
+ * Orchestrates card lifecycle operations with cross-cutting validations.
+ */
+export class CardDomainService {
+    cardRepo;
+    gateConfig;
+    groomingValidator = new GroomingValidator();
+    constructor(cardRepo, gateConfig) {
+        this.cardRepo = cardRepo;
+        this.gateConfig = gateConfig;
+    }
+    /**
+     * Move a card to a new status with full validation:
+     * - State machine transition
+     * - WIP limits
+     * - Grooming validation (grooming -> ready)
+     * - Sprint/agent assignment checks
+     */
+    async moveCard(cardId, targetStatus) {
+        try {
+            const card = await this.cardRepo.findById(cardId);
+            if (card === null) {
+                return fail(`Card not found: ${cardId.value}`);
+            }
+            // Grooming validation: grooming -> ready requires passing validation
+            if (card.status === CardStatus.Grooming &&
+                targetStatus === CardStatus.Ready) {
+                const groomingResult = this.groomingValidator.validate(card);
+                if (!groomingResult.valid) {
+                    return fail(`Grooming incomplete: ${groomingResult.errors.join("; ")}`);
+                }
+                card.completeGrooming();
+            }
+            // Ready -> Doing requires sprint and agent assignment
+            if (card.status === CardStatus.Ready &&
+                targetStatus === CardStatus.Doing) {
+                if (card.sprintId === undefined) {
+                    return fail("Card must be assigned to a sprint before doing");
+                }
+                if (card.assignedAgent === undefined) {
+                    return fail("Card must have an assigned agent before doing");
+                }
+            }
+            // WIP limit check for the target column
+            const wipLimit = DEFAULT_WIP_LIMITS[targetStatus];
+            if (wipLimit !== null) {
+                const currentCount = await this.cardRepo.countByStatus(card.workspace, targetStatus);
+                if (currentCount >= wipLimit) {
+                    return fail(`WIP limit reached for "${targetStatus}": ${currentCount}/${wipLimit}`);
+                }
+            }
+            // Gate task enforcement (if config is provided)
+            if (this.gateConfig !== undefined && GATED_PHASES.includes(card.status)) {
+                // Auto-verify any "ac-met" gates before checking
+                card.autoVerifyGates();
+                // Check all required gates are met before allowing promotion
+                if (!card.allRequiredGatesMet()) {
+                    const unmet = card.unmetRequiredGates();
+                    const descriptions = unmet.map((g) => g.description).join("; ");
+                    return fail(`Gate tasks not met for "${card.status}": ${descriptions}`);
+                }
+                // Enforce minimum transition interval (cooldown)
+                const minSecs = this.gateConfig.getMinTransitionIntervalSecs();
+                if (minSecs > 0 && card.lastTransitionAt !== undefined) {
+                    const elapsed = (Date.now() - card.lastTransitionAt.value.getTime()) / 1000;
+                    if (elapsed < minSecs) {
+                        return fail(`Transition too fast: ${Math.round(elapsed)}s since last ` +
+                            `transition, minimum is ${minSecs}s`);
+                    }
+                }
+            }
+            // Execute the transition (entity enforces state machine)
+            card.moveTo(targetStatus);
+            // Initialize gate tasks for the new phase (if gated)
+            if (this.gateConfig !== undefined && GATED_PHASES.includes(targetStatus)) {
+                const definitions = this.gateConfig.getGateDefinitions(targetStatus);
+                card.initGateTasks(definitions);
+            }
+            await this.cardRepo.save(card);
+            return ok(card);
+        }
+        catch (error) {
+            return fail(`Failed to move card: ${String(error)}`);
+        }
+    }
+    /** Assign card to an epic. */
+    async assignToEpic(cardId, epicId) {
+        try {
+            const card = await this.cardRepo.findById(cardId);
+            if (card === null)
+                return fail(`Card not found: ${cardId.value}`);
+            card.assignToEpic(epicId);
+            await this.cardRepo.save(card);
+            return ok(card);
+        }
+        catch (error) {
+            return fail(`Failed to assign epic: ${String(error)}`);
+        }
+    }
+    /** Assign card to a sprint. */
+    async assignToSprint(cardId, sprintId) {
+        try {
+            const card = await this.cardRepo.findById(cardId);
+            if (card === null)
+                return fail(`Card not found: ${cardId.value}`);
+            card.assignToSprint(sprintId);
+            await this.cardRepo.save(card);
+            return ok(card);
+        }
+        catch (error) {
+            return fail(`Failed to assign sprint: ${String(error)}`);
+        }
+    }
+    /** Set story points on a card. */
+    async setStoryPoints(cardId, points) {
+        try {
+            const card = await this.cardRepo.findById(cardId);
+            if (card === null)
+                return fail(`Card not found: ${cardId.value}`);
+            card.setStoryPoints(points);
+            await this.cardRepo.save(card);
+            return ok(card);
+        }
+        catch (error) {
+            return fail(`Failed to set story points: ${String(error)}`);
+        }
+    }
+    /** Assign an agent to a card. */
+    async assignAgent(cardId, agent) {
+        try {
+            const card = await this.cardRepo.findById(cardId);
+            if (card === null)
+                return fail(`Card not found: ${cardId.value}`);
+            card.assignAgent(agent);
+            await this.cardRepo.save(card);
+            return ok(card);
+        }
+        catch (error) {
+            return fail(`Failed to assign agent: ${String(error)}`);
+        }
+    }
+    /** List cards by workspace with optional status filter. */
+    async listCards(workspace, status) {
+        try {
+            const cards = await this.cardRepo.findByWorkspace(workspace, status);
+            return ok(cards);
+        }
+        catch (error) {
+            return fail(`Failed to list cards: ${String(error)}`);
+        }
+    }
+    /** Get a single card by ID. */
+    async getCard(cardId) {
+        try {
+            const card = await this.cardRepo.findById(cardId);
+            return ok(card);
+        }
+        catch (error) {
+            return fail(`Failed to get card: ${String(error)}`);
+        }
+    }
+    /**
+     * Get board statistics: card count per status column.
+     */
+    async getBoardStats(workspace) {
+        try {
+            const stats = {};
+            for (const status of Object.values(CardStatus)) {
+                stats[status] = await this.cardRepo.countByStatus(workspace, status);
+            }
+            return ok(stats);
+        }
+        catch (error) {
+            return fail(`Failed to get board stats: ${String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=services.js.map

package/dist/domain/kanban/services.js.map

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

package/dist/domain/kanban/sprint.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Sprint and Epic Entities
+ *
+ * Separate aggregate roots for sprint and epic management.
+ * Sprints are 2-week iterations containing cards.
+ * Epics are feature-level groupings spanning multiple sprints.
+ *
+ * DDD: Aggregate roots with their own lifecycle
+ * SOLID: SRP - sprint and epic lifecycle, split from Card (entities.ts)
+ */
+import { WorkspaceId, Timestamp } from "../shared/value-objects.js";
+import { SprintId, SprintStatus, EpicId, EpicStatus, Priority } from "./value-objects.js";
+export { SprintId, SprintStatus, EpicId, EpicStatus, Priority, WorkspaceId };
+export interface SprintProps {
+    readonly id: SprintId;
+    readonly workspace: WorkspaceId;
+    readonly name: string;
+    readonly status: SprintStatus;
+    readonly goal?: string;
+    readonly startDate?: Timestamp;
+    readonly endDate?: Timestamp;
+    readonly velocityPlanned?: number;
+    readonly velocityActual?: number;
+    readonly createdAt: Timestamp;
+}
+export declare class Sprint {
+    readonly id: SprintId;
+    readonly workspace: WorkspaceId;
+    readonly name: string;
+    readonly createdAt: Timestamp;
+    private _status;
+    private _goal?;
+    private _startDate?;
+    private _endDate?;
+    private _velocityPlanned?;
+    private _velocityActual?;
+    private constructor();
+    get status(): SprintStatus;
+    get goal(): string | undefined;
+    get startDate(): Timestamp | undefined;
+    get endDate(): Timestamp | undefined;
+    get velocityPlanned(): number | undefined;
+    get velocityActual(): number | undefined;
+    static create(params: {
+        id: SprintId;
+        workspace: WorkspaceId;
+        name: string;
+        goal?: string;
+        velocityPlanned?: number;
+    }): Sprint;
+    static reconstitute(props: SprintProps): Sprint;
+    /** Activate the sprint. Sets start date. */
+    activate(): void;
+    /** Close the sprint. Sets end date and actual velocity. */
+    close(velocityActual?: number): void;
+    /** Cancel the sprint. */
+    cancel(): void;
+    setGoal(goal: string): void;
+    setPlannedVelocity(velocity: number): void;
+    get isActive(): boolean;
+    get isTerminal(): boolean;
+    private transitionTo;
+}
+export interface EpicProps {
+    readonly id: EpicId;
+    readonly workspace: WorkspaceId;
+    readonly title: string;
+    readonly status: EpicStatus;
+    readonly priority: Priority;
+    readonly description?: string;
+    readonly owner?: string;
+    readonly createdAt: Timestamp;
+}
+export declare class Epic {
+    readonly id: EpicId;
+    readonly workspace: WorkspaceId;
+    readonly title: string;
+    readonly createdAt: Timestamp;
+    private _status;
+    private _priority;
+    private _description?;
+    private _owner?;
+    private constructor();
+    get status(): EpicStatus;
+    get priority(): Priority;
+    get description(): string | undefined;
+    get owner(): string | undefined;
+    static create(params: {
+        id: EpicId;
+        workspace: WorkspaceId;
+        title: string;
+        priority?: Priority;
+        description?: string;
+        owner?: string;
+    }): Epic;
+    static reconstitute(props: EpicProps): Epic;
+    startWork(): void;
+    complete(): void;
+    setDescription(description: string): void;
+    setOwner(owner: string): void;
+    setPriority(priority: Priority): void;
+}
+//# sourceMappingURL=sprint.d.ts.map

package/dist/domain/kanban/sprint.d.ts.map

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