devchain-cli 0.21.0 → 0.22.0

package/dist/server/modules/epic-time/services/epic-time.service.js

@@ -0,0 +1,224 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EpicTimeService = void 0;
+const common_1 = require("@nestjs/common");
+const error_types_1 = require("../../../common/errors/error-types");
+const epic_time_store_1 = require("./epic-time.store");
+const MILLIS_PER_MINUTE = 60_000;
+const MAX_BATCH_EPICS = 1_000;
+const MAX_ERROR_IDS = 20;
+let EpicTimeService = class EpicTimeService {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    getDetail(epicId, timeZone) {
+        const formatter = this.createDateFormatter(timeZone);
+        const scope = this.store.getEpicTimeScope(epicId);
+        if (!scope) {
+            throw new error_types_1.NotFoundError('Epic', epicId);
+        }
+        const segments = this.store.listClosedSegmentsForEpic(epicId, scope.parentId === null);
+        const totalItems = this.quantize(segments, formatter);
+        const directItems = this.quantize(segments.filter((segment) => segment.isDirect), formatter);
+        const totalMinutes = this.sumMinutes(totalItems);
+        const directMinutes = this.sumMinutes(directItems);
+        return {
+            isRoot: scope.parentId === null,
+            directMinutes: Math.min(directMinutes, totalMinutes),
+            totalMinutes,
+            items: totalItems,
+            taskItems: this.allocateTaskItems(epicId, segments, formatter),
+        };
+    }
+    getBatch(epicIds, timeZone) {
+        const formatter = this.createDateFormatter(timeZone);
+        this.validateBatchInput(epicIds);
+        const roots = this.store.getEpicTimeScopes(epicIds);
+        const rootsById = new Map(roots.map((root) => [root.id, root]));
+        const invalidIds = epicIds.filter((id) => {
+            const root = rootsById.get(id);
+            return !root || root.parentId !== null;
+        });
+        if (invalidIds.length > 0) {
+            throw new error_types_1.ValidationError('Batch time summaries require existing root Epics.', {
+                invalidCount: invalidIds.length,
+                invalidEpicIds: invalidIds.slice(0, MAX_ERROR_IDS),
+            });
+        }
+        const segments = this.store.listClosedSegmentsForRoots(epicIds);
+        const segmentsByRoot = new Map();
+        for (const segment of segments) {
+            const rootEpicId = segment.rootEpicId;
+            if (!rootEpicId) {
+                continue;
+            }
+            const group = segmentsByRoot.get(rootEpicId) ?? [];
+            group.push(segment);
+            segmentsByRoot.set(rootEpicId, group);
+        }
+        return {
+            items: epicIds.map((epicId) => ({
+                epicId,
+                totalMinutes: this.sumMinutes(this.quantize(segmentsByRoot.get(epicId) ?? [], formatter)),
+            })),
+        };
+    }
+    quantize(segments, formatter) {
+        const groups = new Map();
+        for (const segment of segments) {
+            const activityDate = this.formatActivityDate(segment.lastActivityAt, formatter);
+            const key = `${activityDate}\u0000${segment.agentId}`;
+            const existing = groups.get(key);
+            if (!existing) {
+                groups.set(key, {
+                    activityDate,
+                    agentId: segment.agentId,
+                    durationMs: segment.durationMs,
+                    latestName: segment.agentName,
+                    latestLastActivityAt: segment.lastActivityAt,
+                    latestUpdatedAt: segment.updatedAt,
+                    latestSegmentId: segment.id,
+                });
+                continue;
+            }
+            existing.durationMs += segment.durationMs;
+            if (this.isLaterNameSnapshot(segment, existing)) {
+                existing.latestName = segment.agentName;
+                existing.latestLastActivityAt = segment.lastActivityAt;
+                existing.latestUpdatedAt = segment.updatedAt;
+                existing.latestSegmentId = segment.id;
+            }
+        }
+        return [...groups.values()]
+            .map((group) => ({
+            activityDate: group.activityDate,
+            agentId: group.agentId,
+            agentName: group.latestName,
+            minutes: Math.floor(group.durationMs / MILLIS_PER_MINUTE),
+        }))
+            .filter((group) => group.minutes > 0)
+            .sort((left, right) => right.activityDate.localeCompare(left.activityDate) ||
+            left.agentId.localeCompare(right.agentId));
+    }
+    isLaterNameSnapshot(segment, group) {
+        return (segment.lastActivityAt > group.latestLastActivityAt ||
+            (segment.lastActivityAt === group.latestLastActivityAt &&
+                (segment.updatedAt > group.latestUpdatedAt ||
+                    (segment.updatedAt === group.latestUpdatedAt && segment.id > group.latestSegmentId))));
+    }
+    allocateTaskItems(requestedEpicId, segments, formatter) {
+        const buckets = new Map();
+        for (const segment of segments) {
+            const activityDate = this.formatActivityDate(segment.lastActivityAt, formatter);
+            const bucketKey = `${activityDate}\u0000${segment.agentId}`;
+            const shares = buckets.get(bucketKey) ?? new Map();
+            const existing = shares.get(segment.epicId);
+            if (existing) {
+                existing.durationMs += segment.durationMs;
+            }
+            else {
+                shares.set(segment.epicId, {
+                    epicId: segment.epicId,
+                    epicTitle: segment.epicTitle,
+                    isDirect: segment.isDirect,
+                    durationMs: segment.durationMs,
+                });
+            }
+            buckets.set(bucketKey, shares);
+        }
+        const totals = new Map();
+        for (const shares of buckets.values()) {
+            const allocations = [...shares.values()].map((share) => ({
+                ...share,
+                minutes: Math.floor(share.durationMs / MILLIS_PER_MINUTE),
+                remainderMs: share.durationMs % MILLIS_PER_MINUTE,
+            }));
+            const bucketMinutes = Math.floor(allocations.reduce((total, share) => total + share.durationMs, 0) / MILLIS_PER_MINUTE);
+            let remainingMinutes = bucketMinutes - allocations.reduce((total, share) => total + share.minutes, 0);
+            allocations.sort((left, right) => right.remainderMs - left.remainderMs || left.epicId.localeCompare(right.epicId));
+            for (const allocation of allocations) {
+                if (remainingMinutes > 0) {
+                    allocation.minutes += 1;
+                    remainingMinutes -= 1;
+                }
+                if (allocation.minutes === 0) {
+                    continue;
+                }
+                const existing = totals.get(allocation.epicId);
+                if (existing) {
+                    existing.minutes += allocation.minutes;
+                }
+                else {
+                    totals.set(allocation.epicId, {
+                        epicId: allocation.epicId,
+                        epicTitle: allocation.epicTitle,
+                        isDirect: allocation.isDirect,
+                        minutes: allocation.minutes,
+                    });
+                }
+            }
+        }
+        return [...totals.values()].sort((left, right) => {
+            if (left.epicId === requestedEpicId)
+                return -1;
+            if (right.epicId === requestedEpicId)
+                return 1;
+            return (left.epicTitle.localeCompare(right.epicTitle) || left.epicId.localeCompare(right.epicId));
+        });
+    }
+    formatActivityDate(value, formatter) {
+        const date = new Date(value);
+        if (!Number.isFinite(date.getTime())) {
+            throw new Error('Epic time persistence contains an invalid last activity timestamp.');
+        }
+        const parts = new Map(formatter
+            .formatToParts(date)
+            .filter((part) => part.type === 'year' || part.type === 'month' || part.type === 'day')
+            .map((part) => [part.type, part.value]));
+        return `${parts.get('year')}-${parts.get('month')}-${parts.get('day')}`;
+    }
+    createDateFormatter(timeZone) {
+        const normalized = timeZone.trim();
+        if (!normalized || normalized.length > 128 || /^[+-]\d{2}:?\d{2}$/.test(normalized)) {
+            throw new error_types_1.ValidationError('A valid IANA time zone is required.');
+        }
+        try {
+            return new Intl.DateTimeFormat('en-US', {
+                timeZone: normalized,
+                year: 'numeric',
+                month: '2-digit',
+                day: '2-digit',
+            });
+        }
+        catch {
+            throw new error_types_1.ValidationError('A valid IANA time zone is required.');
+        }
+    }
+    validateBatchInput(epicIds) {
+        if (epicIds.length === 0 || epicIds.length > MAX_BATCH_EPICS) {
+            throw new error_types_1.ValidationError(`Batch time summaries require 1-${MAX_BATCH_EPICS} Epic IDs.`);
+        }
+        if (new Set(epicIds).size !== epicIds.length) {
+            throw new error_types_1.ValidationError('Batch time summary Epic IDs must be unique.');
+        }
+    }
+    sumMinutes(items) {
+        return items.reduce((total, item) => total + item.minutes, 0);
+    }
+};
+exports.EpicTimeService = EpicTimeService;
+exports.EpicTimeService = EpicTimeService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [epic_time_store_1.EpicTimeStore])
+], EpicTimeService);
+//# sourceMappingURL=epic-time.service.js.map

package/dist/server/modules/epic-time/services/epic-time.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-time.service.js","sourceRoot":"","sources":["../../../../src/modules/epic-time/services/epic-time.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,oEAAoF;AAOpF,uDAA+E;AAE/E,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,aAAa,GAAG,EAAE,CAAC;AAoBlB,IAAM,eAAe,GAArB,MAAM,eAAe;IACG;IAA7B,YAA6B,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;IAErD,SAAS,CAAC,MAAc,EAAE,QAAgB;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,2BAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;QACvF,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAC/B,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC9C,SAAS,CACV,CAAC;QACF,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI;YAC/B,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC;YACpD,YAAY;YACZ,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;SAC/D,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAiB,EAAE,QAAgB;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,6BAAe,CAAC,mDAAmD,EAAE;gBAC7E,YAAY,EAAE,UAAU,CAAC,MAAM;gBAC/B,cAAc,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAoC,CAAC;QACnE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;YACtC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC9B,MAAM;gBACN,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;aAC1F,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAEO,QAAQ,CACd,QAA2C,EAC3C,SAA8B;QAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAChF,MAAM,GAAG,GAAG,GAAG,YAAY,SAAS,OAAO,CAAC,OAAO,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;oBACd,YAAY;oBACZ,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,UAAU,EAAE,OAAO,CAAC,SAAS;oBAC7B,oBAAoB,EAAE,OAAO,CAAC,cAAc;oBAC5C,eAAe,EAAE,OAAO,CAAC,SAAS;oBAClC,eAAe,EAAE,OAAO,CAAC,EAAE;iBAC5B,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;YAC1C,IAAI,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAChD,QAAQ,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;gBACxC,QAAQ,CAAC,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;gBACvD,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;gBAC7C,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC;YACxC,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;aACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACf,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,iBAAiB,CAAC;SAC1D,CAAC,CAAC;aACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;aACpC,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAC5C,CAAC;IACN,CAAC;IAEO,mBAAmB,CAAC,OAA+B,EAAE,KAAgB;QAC3E,OAAO,CACL,OAAO,CAAC,cAAc,GAAG,KAAK,CAAC,oBAAoB;YACnD,CAAC,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,oBAAoB;gBACpD,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,eAAe;oBACxC,CAAC,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC,eAAe,IAAI,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAC1F,CAAC;IACJ,CAAC;IAEO,iBAAiB,CACvB,eAAuB,EACvB,QAA2C,EAC3C,SAA8B;QAE9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkC,CAAC;QAC1D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAChF,MAAM,SAAS,GAAG,GAAG,YAAY,SAAS,OAAO,CAAC,OAAO,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAqB,CAAC;YACtE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE;oBACzB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC/B,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;QACnD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACvD,GAAG,KAAK;gBACR,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,iBAAiB,CAAC;gBACzD,WAAW,EAAE,KAAK,CAAC,UAAU,GAAG,iBAAiB;aAClD,CAAC,CAAC,CAAC;YACJ,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAC9B,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,iBAAiB,CACtF,CAAC;YACF,IAAI,gBAAgB,GAClB,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACjF,WAAW,CAAC,IAAI,CACd,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAClF,CAAC;YACF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;oBACzB,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;oBACxB,gBAAgB,IAAI,CAAC,CAAC;gBACxB,CAAC;gBACD,IAAI,UAAU,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;oBAC7B,SAAS;gBACX,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC/C,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE;wBAC5B,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,SAAS,EAAE,UAAU,CAAC,SAAS;wBAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;wBAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;qBAC5B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,eAAe;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe;gBAAE,OAAO,CAAC,CAAC;YAC/C,OAAO,CACL,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CACzF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,kBAAkB,CAAC,KAAa,EAAE,SAA8B;QACtE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,SAAS;aACN,aAAa,CAAC,IAAI,CAAC;aACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;aACtF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAC1C,CAAC;QACF,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1E,CAAC;IAEO,mBAAmB,CAAC,QAAgB;QAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,6BAAe,CAAC,qCAAqC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;gBACtC,QAAQ,EAAE,UAAU;gBACpB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,SAAS;gBAChB,GAAG,EAAE,SAAS;aACf,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,6BAAe,CAAC,qCAAqC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,OAAiB;QAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YAC7D,MAAM,IAAI,6BAAe,CAAC,kCAAkC,eAAe,YAAY,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,IAAI,6BAAe,CAAC,6CAA6C,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAAqC;QACtD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;CACF,CAAA;AArOY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;qCAEyB,+BAAa;GADtC,eAAe,CAqO3B"}

package/dist/server/modules/epic-time/services/epic-time.store.d.ts

@@ -0,0 +1,75 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+export interface EpicTimeActivation {
+    trackingStartedAt: string;
+    idleTimeoutMs: number;
+    firstActivation: boolean;
+    recoveredOpenSegments: number;
+}
+export type EpicTimeReconciliationAction = 'noop' | 'created' | 'created_closed' | 'advanced' | 'advanced_closed' | 'closed' | 'discarded';
+export interface EpicTimeReconciliationResult {
+    sessionId: string;
+    action: EpicTimeReconciliationAction;
+    watermark: string | null;
+    segmentId: string | null;
+}
+export interface EpicTimeReconciliationOptions {
+    forceCloseOpenSegment?: boolean;
+}
+export interface EpicTimeTaskTouch {
+    committedEventId: string;
+    eventName: 'epic.created' | 'epic.updated';
+    projectId: string;
+    actorAgentId: string;
+    targetEpicId: string;
+    targetEpicTitle: string;
+    publishedAt: string;
+}
+export interface EpicTimeTaskTouchResult {
+    receiptCreated: boolean;
+    claimedSegments: number;
+    discardedSegments: number;
+}
+export interface EpicTimeScope {
+    id: string;
+    parentId: string | null;
+}
+export interface EpicTimeSummarySegment {
+    id: string;
+    rootEpicId: string | null;
+    epicId: string;
+    epicTitle: string;
+    isDirect: boolean;
+    agentId: string;
+    agentName: string;
+    durationMs: number;
+    lastActivityAt: string;
+    updatedAt: string;
+}
+export declare class EpicTimeStore {
+    private readonly rawClient;
+    private readonly transactionRunner;
+    constructor(db: BetterSQLite3Database);
+    activate(now?: Date): Promise<EpicTimeActivation>;
+    listReconciliationSessionIds(trackingStartedAt: string): string[];
+    reconcileSession(sessionId: string, trackingStartedAt: string, idleTimeoutMs: number, now?: Date, options?: EpicTimeReconciliationOptions): Promise<EpicTimeReconciliationResult>;
+    recordTaskTouch(touch: EpicTimeTaskTouch, now?: Date): Promise<EpicTimeTaskTouchResult>;
+    getEpicTimeScope(epicId: string): EpicTimeScope | null;
+    getEpicTimeScopes(epicIds: readonly string[]): EpicTimeScope[];
+    listClosedSegmentsForEpic(epicId: string, includeDirectChildren: boolean): EpicTimeSummarySegment[];
+    listClosedSegmentsForRoots(rootEpicIds: readonly string[]): EpicTimeSummarySegment[];
+    private loadSession;
+    private mapSummarySegment;
+    private loadWatermark;
+    private loadOpenSegment;
+    private resolveAttributionEpic;
+    private upsertWatermark;
+    private applyPendingBufferClaims;
+    private closeSegment;
+    private shouldClose;
+    private readSetting;
+    private readIdleTimeoutMs;
+    private isAfter;
+    private elapsedMs;
+    private latestTimestamp;
+    private timestampMs;
+}