obsidian-accomplishments-mcp 0.1.9 → 0.1.11

package/dist/services/v2/lifecycle-manager.js

@@ -0,0 +1,310 @@
+/**
+ * V2 Lifecycle Manager
+ *
+ * Manages entity status transitions with validation, conditions, and side effects.
+ */
+// =============================================================================
+// Transition Rules by Entity Type
+// =============================================================================
+const MILESTONE_TRANSITIONS = [
+    { from: 'Not Started', to: 'In Progress', action: 'start' },
+    { from: 'Not Started', to: 'Blocked', action: 'block', conditions: ['has_incomplete_blockers'] },
+    { from: 'In Progress', to: 'Completed', action: 'complete', conditions: ['all_stories_complete'], side_effects: ['check_archive_trigger'] },
+    { from: 'In Progress', to: 'Blocked', action: 'block', conditions: ['has_incomplete_blockers'] },
+    { from: 'Blocked', to: 'In Progress', action: 'unblock', conditions: ['no_incomplete_blockers'] },
+    { from: 'Blocked', to: 'Not Started', action: 'unblock', conditions: ['no_incomplete_blockers', 'no_stories_started'] },
+];
+const STORY_TRANSITIONS = [
+    { from: 'Not Started', to: 'In Progress', action: 'start', side_effects: ['parent_in_progress'] },
+    { from: 'Not Started', to: 'Blocked', action: 'block', conditions: ['has_incomplete_blockers'] },
+    { from: 'In Progress', to: 'Completed', action: 'complete', conditions: ['all_tasks_complete'], side_effects: ['check_parent_completion'] },
+    { from: 'In Progress', to: 'Blocked', action: 'block', conditions: ['has_incomplete_blockers'] },
+    { from: 'Blocked', to: 'In Progress', action: 'unblock', conditions: ['no_incomplete_blockers'] },
+    { from: 'Blocked', to: 'Not Started', action: 'unblock', conditions: ['no_incomplete_blockers', 'no_tasks_started'] },
+    { from: 'Completed', to: 'In Progress', action: 'reopen' },
+];
+const TASK_TRANSITIONS = [
+    { from: 'Not Started', to: 'In Progress', action: 'start', side_effects: ['parent_in_progress'] },
+    { from: 'In Progress', to: 'Completed', action: 'complete', side_effects: ['check_parent_completion'] },
+    { from: 'In Progress', to: 'Blocked', action: 'block' },
+    { from: 'Blocked', to: 'In Progress', action: 'unblock' },
+    { from: 'Blocked', to: 'Not Started', action: 'reopen' },
+    { from: 'Completed', to: 'Not Started', action: 'reopen' },
+];
+const DECISION_TRANSITIONS = [
+    { from: 'Pending', to: 'Decided', action: 'decide', side_effects: ['unblock_enabled_entities'] },
+    { from: 'Decided', to: 'Superseded', action: 'supersede', conditions: ['has_replacement_decision'] },
+];
+const DOCUMENT_TRANSITIONS = [
+    { from: 'Draft', to: 'Review', action: 'submit' },
+    { from: 'Review', to: 'Draft', action: 'reject' },
+    { from: 'Review', to: 'Approved', action: 'approve', side_effects: ['enable_implementing_stories'] },
+    { from: 'Approved', to: 'Superseded', action: 'supersede', conditions: ['has_replacement_version'] },
+    { from: 'Approved', to: 'Draft', action: 'revise' },
+];
+const FEATURE_TRANSITIONS = [
+    { from: 'Planned', to: 'In Progress', action: 'start', side_effects: ['check_implementing_entities'] },
+    { from: 'Planned', to: 'Deferred', action: 'defer' },
+    { from: 'In Progress', to: 'Complete', action: 'complete', conditions: ['all_implementations_complete'] },
+    { from: 'In Progress', to: 'Deferred', action: 'defer' },
+    { from: 'Deferred', to: 'Planned', action: 'reactivate' },
+    { from: 'Complete', to: 'In Progress', action: 'reopen' },
+];
+// =============================================================================
+// Lifecycle Manager Class
+// =============================================================================
+/**
+ * Manages entity lifecycle transitions.
+ */
+export class LifecycleManager {
+    transitions;
+    // Callbacks for external dependencies
+    getIncompleteBlockers = () => [];
+    getChildren = () => [];
+    getParent = () => undefined;
+    constructor() {
+        this.transitions = new Map([
+            ['milestone', MILESTONE_TRANSITIONS],
+            ['story', STORY_TRANSITIONS],
+            ['task', TASK_TRANSITIONS],
+            ['decision', DECISION_TRANSITIONS],
+            ['document', DOCUMENT_TRANSITIONS],
+            ['feature', FEATURE_TRANSITIONS],
+        ]);
+    }
+    // ---------------------------------------------------------------------------
+    // Configuration
+    // ---------------------------------------------------------------------------
+    /** Set callback for getting incomplete blockers */
+    setBlockerCallback(fn) {
+        this.getIncompleteBlockers = fn;
+    }
+    /** Set callback for getting children */
+    setChildrenCallback(fn) {
+        this.getChildren = fn;
+    }
+    /** Set callback for getting parent */
+    setParentCallback(fn) {
+        this.getParent = fn;
+    }
+    // ---------------------------------------------------------------------------
+    // Transition Methods
+    // ---------------------------------------------------------------------------
+    /** Check if a transition is allowed */
+    canTransition(entity, newStatus) {
+        const rules = this.transitions.get(entity.type);
+        if (!rules) {
+            return { allowed: false, reason: 'Unknown entity type' };
+        }
+        const rule = rules.find(r => r.from === entity.status && r.to === newStatus);
+        if (!rule) {
+            return {
+                allowed: false,
+                reason: `Invalid transition: ${entity.status} → ${newStatus}`,
+            };
+        }
+        // Check conditions
+        if (rule.conditions) {
+            for (const condition of rule.conditions) {
+                const result = this.checkCondition(entity, condition);
+                if (!result.met) {
+                    return { allowed: false, reason: result.reason };
+                }
+            }
+        }
+        return { allowed: true };
+    }
+    /** Execute a status transition */
+    async transition(entity, newStatus) {
+        const check = this.canTransition(entity, newStatus);
+        if (!check.allowed) {
+            throw new Error(check.reason);
+        }
+        const rule = this.getRule(entity.type, entity.status, newStatus);
+        const oldStatus = entity.status;
+        // Apply transition
+        entity.status = newStatus;
+        entity.updated_at = new Date().toISOString();
+        // Execute side effects
+        const sideEffects = [];
+        if (rule?.side_effects) {
+            for (const effect of rule.side_effects) {
+                const result = await this.executeSideEffect(entity, effect);
+                sideEffects.push(...result);
+            }
+        }
+        return {
+            entity_id: entity.id,
+            old_status: oldStatus,
+            new_status: newStatus,
+            side_effects: sideEffects,
+        };
+    }
+    /** Get available transitions for an entity */
+    getAvailableTransitions(entity) {
+        const rules = this.transitions.get(entity.type);
+        if (!rules)
+            return [];
+        return rules
+            .filter(r => r.from === entity.status)
+            .filter(r => {
+            // Check if conditions are met
+            if (!r.conditions)
+                return true;
+            return r.conditions.every(c => this.checkCondition(entity, c).met);
+        })
+            .map(r => ({ action: r.action, to: r.to }));
+    }
+    // ---------------------------------------------------------------------------
+    // Condition Checking
+    // ---------------------------------------------------------------------------
+    checkCondition(entity, condition) {
+        switch (condition) {
+            case 'has_incomplete_blockers': {
+                const blockers = this.getIncompleteBlockers(entity.id);
+                return {
+                    met: blockers.length > 0,
+                    reason: blockers.length === 0 ? 'No incomplete blockers' : undefined,
+                };
+            }
+            case 'no_incomplete_blockers': {
+                const blockers = this.getIncompleteBlockers(entity.id);
+                return {
+                    met: blockers.length === 0,
+                    reason: blockers.length > 0 ? `Blocked by: ${blockers.join(', ')}` : undefined,
+                };
+            }
+            case 'all_stories_complete': {
+                const stories = this.getChildren(entity.id, 'story');
+                const incomplete = stories.filter(s => s.status !== 'Completed');
+                return {
+                    met: incomplete.length === 0,
+                    reason: incomplete.length > 0 ? `${incomplete.length} stories not complete` : undefined,
+                };
+            }
+            case 'all_tasks_complete': {
+                const tasks = this.getChildren(entity.id, 'task');
+                const incomplete = tasks.filter(t => t.status !== 'Completed');
+                return {
+                    met: incomplete.length === 0,
+                    reason: incomplete.length > 0 ? `${incomplete.length} tasks not complete` : undefined,
+                };
+            }
+            case 'no_stories_started': {
+                const stories = this.getChildren(entity.id, 'story');
+                const started = stories.filter(s => s.status !== 'Not Started');
+                return {
+                    met: started.length === 0,
+                    reason: started.length > 0 ? `${started.length} stories already started` : undefined,
+                };
+            }
+            case 'no_tasks_started': {
+                const tasks = this.getChildren(entity.id, 'task');
+                const started = tasks.filter(t => t.status !== 'Not Started');
+                return {
+                    met: started.length === 0,
+                    reason: started.length > 0 ? `${started.length} tasks already started` : undefined,
+                };
+            }
+            case 'has_replacement_decision': {
+                const decision = entity;
+                return {
+                    met: !!decision.supersedes,
+                    reason: !decision.supersedes ? 'No replacement decision specified' : undefined,
+                };
+            }
+            case 'has_replacement_version': {
+                const doc = entity;
+                return {
+                    met: !!(doc.previous_version && doc.previous_version.length > 0),
+                    reason: 'No replacement version specified',
+                };
+            }
+            case 'all_implementations_complete': {
+                // For features, check if all implementing milestones/stories are complete
+                const feature = entity;
+                if (!feature.implemented_by || feature.implemented_by.length === 0) {
+                    return { met: true }; // No implementations required
+                }
+                // Note: This would need access to the runtime to check actual entity statuses
+                // For now, we allow the transition and let the caller verify
+                return { met: true };
+            }
+            default:
+                return { met: true };
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Side Effect Execution
+    // ---------------------------------------------------------------------------
+    async executeSideEffect(entity, effect) {
+        const results = [];
+        switch (effect) {
+            case 'parent_in_progress': {
+                const parent = this.getParent(entity.id);
+                if (parent && parent.status === 'Not Started') {
+                    results.push(`Parent ${parent.id} marked as In Progress`);
+                }
+                break;
+            }
+            case 'check_parent_completion': {
+                const parent = this.getParent(entity.id);
+                if (parent) {
+                    const siblings = this.getChildren(parent.id, entity.type);
+                    const allComplete = siblings.every(s => s.status === 'Completed');
+                    if (allComplete) {
+                        results.push(`All children of ${parent.id} complete - ready for completion`);
+                    }
+                }
+                break;
+            }
+            case 'check_archive_trigger': {
+                results.push(`${entity.id} completed - eligible for archival`);
+                break;
+            }
+            case 'unblock_enabled_entities': {
+                results.push(`Decision ${entity.id} decided - enabled entities may be unblocked`);
+                break;
+            }
+            case 'enable_implementing_stories': {
+                results.push(`Document ${entity.id} approved - implementing stories enabled`);
+                break;
+            }
+            case 'check_implementing_entities': {
+                const feature = entity;
+                if (feature.implemented_by && feature.implemented_by.length > 0) {
+                    results.push(`Feature ${entity.id} started - ${feature.implemented_by.length} implementing entities`);
+                }
+                break;
+            }
+        }
+        return results;
+    }
+    // ---------------------------------------------------------------------------
+    // Helper Methods
+    // ---------------------------------------------------------------------------
+    getRule(type, from, to) {
+        const rules = this.transitions.get(type);
+        return rules?.find(r => r.from === from && r.to === to);
+    }
+    /** Check if a status is considered complete */
+    isComplete(status) {
+        return ['Completed', 'Decided', 'Approved', 'Complete'].includes(status);
+    }
+    /** Get the initial status for an entity type */
+    getInitialStatus(type) {
+        switch (type) {
+            case 'milestone':
+            case 'story':
+            case 'task':
+                return 'Not Started';
+            case 'decision':
+                return 'Pending';
+            case 'document':
+                return 'Draft';
+            case 'feature':
+                return 'Planned';
+        }
+    }
+}
+//# sourceMappingURL=lifecycle-manager.js.map

package/dist/services/v2/lifecycle-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-manager.js","sourceRoot":"","sources":["../../../src/services/v2/lifecycle-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6CH,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAEhF,MAAM,qBAAqB,GAAqB;IAC9C,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;IAC3D,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,yBAAyB,CAAC,EAAE;IAChG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,sBAAsB,CAAC,EAAE,YAAY,EAAE,CAAC,uBAAuB,CAAC,EAAE;IAC3I,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,yBAAyB,CAAC,EAAE;IAChG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,wBAAwB,CAAC,EAAE;IACjG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,EAAE;CACxH,CAAC;AAEF,MAAM,iBAAiB,GAAqB;IAC1C,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,oBAAoB,CAAC,EAAE;IACjG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,yBAAyB,CAAC,EAAE;IAChG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,oBAAoB,CAAC,EAAE,YAAY,EAAE,CAAC,yBAAyB,CAAC,EAAE;IAC3I,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,yBAAyB,CAAC,EAAE;IAChG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,wBAAwB,CAAC,EAAE;IACjG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,EAAE;IACrH,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE;CAC3D,CAAC;AAEF,MAAM,gBAAgB,GAAqB;IACzC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,oBAAoB,CAAC,EAAE;IACjG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,yBAAyB,CAAC,EAAE;IACvG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;IACvD,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;IACzD,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE;IACxD,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE;CAC3D,CAAC;AAEF,MAAM,oBAAoB,GAAqB;IAC7C,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,0BAA0B,CAAC,EAAE;IAChG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,0BAA0B,CAAC,EAAE;CACrG,CAAC;AAEF,MAAM,oBAAoB,GAAqB;IAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IACjD,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE;IACjD,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,6BAA6B,CAAC,EAAE;IACpG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,yBAAyB,CAAC,EAAE;IACpG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE;CACpD,CAAC;AAEF,MAAM,mBAAmB,GAAqB;IAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,6BAA6B,CAAC,EAAE;IACtG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;IACpD,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,8BAA8B,CAAC,EAAE;IACzG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;IACxD,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE;IACzD,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE;CAC1D,CAAC;AAEF,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,WAAW,CAAoC;IAEvD,sCAAsC;IAC9B,qBAAqB,GAAiC,GAAG,EAAE,CAAC,EAAE,CAAC;IAC/D,WAAW,GAAkD,GAAG,EAAE,CAAC,EAAE,CAAC;IACtE,SAAS,GAAyC,GAAG,EAAE,CAAC,SAAS,CAAC;IAE1E;QACE,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,CAAC;YACzB,CAAC,WAAW,EAAE,qBAAqB,CAAC;YACpC,CAAC,OAAO,EAAE,iBAAiB,CAAC;YAC5B,CAAC,MAAM,EAAE,gBAAgB,CAAC;YAC1B,CAAC,UAAU,EAAE,oBAAoB,CAAC;YAClC,CAAC,UAAU,EAAE,oBAAoB,CAAC;YAClC,CAAC,SAAS,EAAE,mBAAmB,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E,mDAAmD;IACnD,kBAAkB,CAAC,EAAgC;QACjD,IAAI,CAAC,qBAAqB,GAAG,EAAE,CAAC;IAClC,CAAC;IAED,wCAAwC;IACxC,mBAAmB,CAAC,EAAiD;QACnE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,sCAAsC;IACtC,iBAAiB,CAAC,EAAwC;QACxD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,8EAA8E;IAC9E,qBAAqB;IACrB,8EAA8E;IAE9E,uCAAuC;IACvC,aAAa,CAAC,MAAc,EAAE,SAAuB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,uBAAuB,MAAM,CAAC,MAAM,MAAM,SAAS,EAAE;aAC9D,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBACtD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;oBAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,SAAuB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAEhC,mBAAmB;QAClB,MAAc,CAAC,MAAM,GAAG,SAAS,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE7C,uBAAuB;QACvB,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,IAAI,EAAE,YAAY,EAAE,CAAC;YACvB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC5D,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,WAAW;SAC1B,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,uBAAuB,CAAC,MAAc;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,OAAO,KAAK;aACT,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC;aACrC,MAAM,CAAC,CAAC,CAAC,EAAE;YACV,8BAA8B;YAC9B,IAAI,CAAC,CAAC,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACrE,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,8EAA8E;IAC9E,qBAAqB;IACrB,8EAA8E;IAEtE,cAAc,CAAC,MAAc,EAAE,SAAiB;QACtD,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,yBAAyB,CAAC,CAAC,CAAC;gBAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACvD,OAAO;oBACL,GAAG,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;oBACxB,MAAM,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS;iBACrE,CAAC;YACJ,CAAC;YAED,KAAK,wBAAwB,CAAC,CAAC,CAAC;gBAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACvD,OAAO;oBACL,GAAG,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;iBAC/E,CAAC;YACJ,CAAC;YAED,KAAK,sBAAsB,CAAC,CAAC,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;gBACjE,OAAO;oBACL,GAAG,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;oBAC5B,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,uBAAuB,CAAC,CAAC,CAAC,SAAS;iBACxF,CAAC;YACJ,CAAC;YAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;gBAC/D,OAAO;oBACL,GAAG,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;oBAC5B,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,qBAAqB,CAAC,CAAC,CAAC,SAAS;iBACtF,CAAC;YACJ,CAAC;YAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;gBAChE,OAAO;oBACL,GAAG,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;oBACzB,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,0BAA0B,CAAC,CAAC,CAAC,SAAS;iBACrF,CAAC;YACJ,CAAC;YAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;gBAC9D,OAAO;oBACL,GAAG,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;oBACzB,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,wBAAwB,CAAC,CAAC,CAAC,SAAS;iBACnF,CAAC;YACJ,CAAC;YAED,KAAK,0BAA0B,CAAC,CAAC,CAAC;gBAChC,MAAM,QAAQ,GAAG,MAAkB,CAAC;gBACpC,OAAO;oBACL,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU;oBAC1B,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,SAAS;iBAC/E,CAAC;YACJ,CAAC;YAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;gBAC/B,MAAM,GAAG,GAAG,MAAkB,CAAC;gBAC/B,OAAO;oBACL,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,IAAI,GAAG,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;oBAChE,MAAM,EAAE,kCAAkC;iBAC3C,CAAC;YACJ,CAAC;YAED,KAAK,8BAA8B,CAAC,CAAC,CAAC;gBACpC,0EAA0E;gBAC1E,MAAM,OAAO,GAAG,MAAiB,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACnE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,8BAA8B;gBACtD,CAAC;gBACD,8EAA8E;gBAC9E,6DAA6D;gBAC7D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YACvB,CAAC;YAED;gBACE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,wBAAwB;IACxB,8EAA8E;IAEtE,KAAK,CAAC,iBAAiB,CAAC,MAAc,EAAE,MAAc;QAC5D,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;oBAC9C,OAAO,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,EAAE,wBAAwB,CAAC,CAAC;gBAC5D,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;gBAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC1D,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;oBAClE,IAAI,WAAW,EAAE,CAAC;wBAChB,OAAO,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,EAAE,kCAAkC,CAAC,CAAC;oBAC/E,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,uBAAuB,CAAC,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,EAAE,oCAAoC,CAAC,CAAC;gBAC/D,MAAM;YACR,CAAC;YAED,KAAK,0BAA0B,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,EAAE,8CAA8C,CAAC,CAAC;gBAClF,MAAM;YACR,CAAC;YAED,KAAK,6BAA6B,CAAC,CAAC,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,EAAE,0CAA0C,CAAC,CAAC;gBAC9E,MAAM;YACR,CAAC;YAED,KAAK,6BAA6B,CAAC,CAAC,CAAC;gBACnC,MAAM,OAAO,GAAG,MAAiB,CAAC;gBAClC,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChE,OAAO,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,EAAE,cAAc,OAAO,CAAC,cAAc,CAAC,MAAM,wBAAwB,CAAC,CAAC;gBACxG,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,8EAA8E;IAC9E,iBAAiB;IACjB,8EAA8E;IAEtE,OAAO,CAAC,IAAgB,EAAE,IAAkB,EAAE,EAAgB;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,+CAA+C;IAC/C,UAAU,CAAC,MAAoB;QAC7B,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED,gDAAgD;IAChD,gBAAgB,CAAC,IAAgB;QAC/B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,WAAW,CAAC;YACjB,KAAK,OAAO,CAAC;YACb,KAAK,MAAM;gBACT,OAAO,aAAa,CAAC;YACvB,KAAK,UAAU;gBACb,OAAO,SAAS,CAAC;YACnB,KAAK,UAAU;gBACb,OAAO,OAAO,CAAC;YACjB,KAAK,SAAS;gBACZ,OAAO,SAAS,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/services/v2/lifecycle-manager.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for V2 Lifecycle Manager
+ */
+export {};
+//# sourceMappingURL=lifecycle-manager.test.d.ts.map

package/dist/services/v2/lifecycle-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-manager.test.d.ts","sourceRoot":"","sources":["../../../src/services/v2/lifecycle-manager.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/services/v2/lifecycle-manager.test.js

@@ -0,0 +1,141 @@
+/**
+ * Tests for V2 Lifecycle Manager
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { LifecycleManager } from './lifecycle-manager.js';
+describe('LifecycleManager', () => {
+    let manager;
+    const createMilestone = (status = 'Not Started') => ({
+        id: 'M-001',
+        type: 'milestone',
+        title: 'Test Milestone',
+        workstream: 'engineering',
+        status: status,
+        archived: false,
+        created_at: '2024-01-01',
+        updated_at: '2024-01-15',
+        vault_path: '/vault/milestones/M-001.md',
+        canvas_source: '/vault/canvas.canvas',
+        cssclasses: [],
+        priority: 'High',
+        depends_on: [],
+    });
+    const createStory = (status = 'Not Started') => ({
+        id: 'S-001',
+        type: 'story',
+        title: 'Test Story',
+        workstream: 'engineering',
+        status: status,
+        archived: false,
+        created_at: '2024-01-01',
+        updated_at: '2024-01-15',
+        vault_path: '/vault/stories/S-001.md',
+        canvas_source: '/vault/canvas.canvas',
+        cssclasses: [],
+        priority: 'High',
+        depends_on: [],
+        implements: [],
+        tasks: [],
+    });
+    const createTask = (status = 'Not Started') => ({
+        id: 'T-001',
+        type: 'task',
+        title: 'Test Task',
+        workstream: 'engineering',
+        status: status,
+        archived: false,
+        created_at: '2024-01-01',
+        updated_at: '2024-01-15',
+        vault_path: '/vault/tasks/T-001.md',
+        canvas_source: '/vault/canvas.canvas',
+        cssclasses: [],
+        parent: 'S-001',
+        goal: 'Complete the task',
+    });
+    beforeEach(() => {
+        manager = new LifecycleManager();
+    });
+    describe('Milestone Transitions', () => {
+        it('should allow Not Started → In Progress', () => {
+            const milestone = createMilestone('Not Started');
+            const result = manager.canTransition(milestone, 'In Progress');
+            expect(result.allowed).toBe(true);
+        });
+        it('should not allow Not Started → Completed directly', () => {
+            const milestone = createMilestone('Not Started');
+            const result = manager.canTransition(milestone, 'Completed');
+            expect(result.allowed).toBe(false);
+            expect(result.reason).toContain('Invalid transition');
+        });
+        it('should allow In Progress → Completed when all stories complete', () => {
+            const milestone = createMilestone('In Progress');
+            // Set up callback to return no incomplete children
+            manager.setChildrenCallback(() => []);
+            const result = manager.canTransition(milestone, 'Completed');
+            expect(result.allowed).toBe(true);
+        });
+    });
+    describe('Story Transitions', () => {
+        it('should allow Not Started → In Progress', () => {
+            const story = createStory('Not Started');
+            const result = manager.canTransition(story, 'In Progress');
+            expect(result.allowed).toBe(true);
+        });
+        it('should allow Completed → In Progress (reopen)', () => {
+            const story = createStory('Completed');
+            const result = manager.canTransition(story, 'In Progress');
+            expect(result.allowed).toBe(true);
+        });
+    });
+    describe('Task Transitions', () => {
+        it('should allow Not Started → In Progress', () => {
+            const task = createTask('Not Started');
+            const result = manager.canTransition(task, 'In Progress');
+            expect(result.allowed).toBe(true);
+        });
+        it('should allow In Progress → Completed', () => {
+            const task = createTask('In Progress');
+            const result = manager.canTransition(task, 'Completed');
+            expect(result.allowed).toBe(true);
+        });
+        it('should allow In Progress → Blocked', () => {
+            const task = createTask('In Progress');
+            const result = manager.canTransition(task, 'Blocked');
+            expect(result.allowed).toBe(true);
+        });
+        it('should allow Completed → Not Started (reopen)', () => {
+            const task = createTask('Completed');
+            const result = manager.canTransition(task, 'Not Started');
+            expect(result.allowed).toBe(true);
+        });
+    });
+    describe('Available Transitions', () => {
+        it('should return available transitions for a milestone', () => {
+            const milestone = createMilestone('Not Started');
+            const available = manager.getAvailableTransitions(milestone);
+            const statuses = available.map(t => t.to);
+            expect(statuses).toContain('In Progress');
+            // Blocked requires has_incomplete_blockers condition
+        });
+        it('should return available transitions for a task', () => {
+            const task = createTask('Not Started');
+            const available = manager.getAvailableTransitions(task);
+            const statuses = available.map(t => t.to);
+            expect(statuses).toContain('In Progress');
+        });
+    });
+    describe('Transition Execution', () => {
+        it('should execute a valid transition', async () => {
+            const task = createTask('Not Started');
+            const result = await manager.transition(task, 'In Progress');
+            expect(result.old_status).toBe('Not Started');
+            expect(result.new_status).toBe('In Progress');
+            expect(task.status).toBe('In Progress');
+        });
+        it('should throw on invalid transition', async () => {
+            const task = createTask('Not Started');
+            await expect(manager.transition(task, 'Completed')).rejects.toThrow('Invalid transition');
+        });
+    });
+});
+//# sourceMappingURL=lifecycle-manager.test.js.map

package/dist/services/v2/lifecycle-manager.test.js.map

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

package/dist/services/v2/path-resolver.d.ts

@@ -0,0 +1,64 @@
+/**
+ * V2 Path Resolver
+ *
+ * Resolves entity paths, archive paths, and file naming conventions.
+ */
+import { EntityId, EntityType, VaultPath, V2Config } from '../../models/v2-types.js';
+/**
+ * Resolves file paths for entities in the vault.
+ */
+export declare class PathResolver {
+    private config;
+    constructor(config: V2Config);
+    /** Get folder path for entity type */
+    getTypeFolderPath(type: EntityType): VaultPath;
+    /** Get absolute folder path for entity type */
+    getAbsoluteTypeFolderPath(type: EntityType): string;
+    /** Generate file path for entity */
+    getEntityPath(id: EntityId, title: string): VaultPath;
+    /** Get absolute file path for entity */
+    getAbsoluteEntityPath(id: EntityId, title: string): string;
+    /** Generate filename from title (ID is stored in frontmatter, not filename) */
+    generateFilename(_id: EntityId, title: string): string;
+    /** Sanitize title for use in filename */
+    private sanitizeTitle;
+    /** Get archive folder path for a date */
+    getArchiveFolderPath(date?: Date): VaultPath;
+    /** Get absolute archive folder path */
+    getAbsoluteArchiveFolderPath(date?: Date): string;
+    /** Get archive path for entity */
+    getArchivePath(id: EntityId, title: string, date?: Date): VaultPath;
+    /** Get absolute archive path for entity */
+    getAbsoluteArchivePath(id: EntityId, title: string, date?: Date): string;
+    /**
+     * Extract entity ID from file path.
+     * NOTE: Since IDs are no longer in filenames, this returns null.
+     * Use entity-parser to get ID from frontmatter instead.
+     * @deprecated IDs are stored in frontmatter, not filenames
+     */
+    extractIdFromPath(_filePath: VaultPath): EntityId | null;
+    /** Check if path is in archive */
+    isArchivePath(filePath: VaultPath): boolean;
+    /** Check if path is an entity file (based on folder location) */
+    isEntityPath(filePath: VaultPath): boolean;
+    /** Get entity type from path */
+    getTypeFromPath(filePath: VaultPath): EntityType | null;
+    /** Get canvas folder path */
+    getCanvasFolderPath(): VaultPath;
+    /** Get absolute canvas folder path */
+    getAbsoluteCanvasFolderPath(): string;
+    /** Check if path is a canvas file */
+    isCanvasPath(filePath: VaultPath): boolean;
+    /** Get all entity folder paths */
+    getAllEntityFolders(): VaultPath[];
+    /** Get all absolute entity folder paths */
+    getAllAbsoluteEntityFolders(): string[];
+    /** Get config */
+    /** Convert absolute path to vault-relative path */
+    toVaultPath(absolutePath: string): VaultPath;
+    /** Convert vault-relative path to absolute path */
+    toAbsolutePath(vaultPath: VaultPath): string;
+    /** Get config */
+    getConfig(): V2Config;
+}
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/services/v2/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../../src/services/v2/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EAET,MAAM,0BAA0B,CAAC;AAuBlC;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAMpC,sCAAsC;IACtC,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAI9C,+CAA+C;IAC/C,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAInD,oCAAoC;IACpC,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IASrD,wCAAwC;IACxC,qBAAqB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1D,+EAA+E;IAC/E,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAKtD,yCAAyC;IACzC,OAAO,CAAC,aAAa;IAarB,yCAAyC;IACzC,oBAAoB,CAAC,IAAI,GAAE,IAAiB,GAAG,SAAS;IAMxD,uCAAuC;IACvC,4BAA4B,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM;IAI7D,kCAAkC;IAClC,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,SAAS;IAM/E,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM;IAQpF;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI;IAMxD,kCAAkC;IAClC,aAAa,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO;IAI3C,iEAAiE;IACjE,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO;IAO1C,gCAAgC;IAChC,eAAe,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI;IAavD,6BAA6B;IAC7B,mBAAmB,IAAI,SAAS;IAIhC,sCAAsC;IACtC,2BAA2B,IAAI,MAAM;IAIrC,qCAAqC;IACrC,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO;IAQ1C,kCAAkC;IAClC,mBAAmB,IAAI,SAAS,EAAE;IAMlC,2CAA2C;IAC3C,2BAA2B,IAAI,MAAM,EAAE;IAMvC,iBAAiB;IACjB,mDAAmD;IACnD,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS;IAO5C,mDAAmD;IACnD,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAK5C,iBAAiB;IACjB,SAAS,IAAI,QAAQ;CAGtB"}