specmem-hardwicksoftware 3.5.99

package/dist/team-members/teamMemberLimits.js

@@ -0,0 +1,259 @@
+import { EventEmitter } from 'events';
+import { logger } from '../utils/logger.js';
+const THRESHOLDS = {
+    warning: 70,
+    critical: 85,
+    exceeded: 100
+};
+const SUGGESTIONS = {
+    token: 'Consider chunking your analysis into smaller tasks',
+    memory: 'Flush logs to database, reduce in-memory caching',
+    file: 'Process files in batches of 10',
+    output: 'Stream output instead of buffering'
+};
+const WARNING_MESSAGES = {
+    token: {
+        warning: 'Token limit 70% reached',
+        critical: 'Token limit 85% reached',
+        exceeded: 'Token limit exceeded'
+    },
+    memory: {
+        warning: 'Memory limit 70% reached',
+        critical: 'Memory limit 85% reached',
+        exceeded: 'Memory limit exceeded'
+    },
+    file: {
+        warning: 'File limit 70% reached',
+        critical: 'File limit 85% reached',
+        exceeded: 'File limit exceeded'
+    },
+    output: {
+        warning: 'Output limit 70% reached',
+        critical: 'Output limit 85% reached',
+        exceeded: 'Output limit exceeded'
+    }
+};
+// TEAM_MEMBER 3 FIX: Set UNLIMITED defaults for everything!
+const DEFAULT_LIMITS = {
+    tokensLimit: Number.MAX_SAFE_INTEGER, // UNLIMITED tokens!
+    memoryLimit: 1024 * 1024 * 1024, // 1GB - effectively unlimited for most cases
+    filesLimit: Number.MAX_SAFE_INTEGER, // UNLIMITED files!
+    outputLimit: Number.MAX_SAFE_INTEGER // UNLIMITED output!
+};
+export class TeamMemberLimitsMonitor extends EventEmitter {
+    limits = new Map();
+    acknowledgments = new Map();
+    lastWarnings = new Map();
+    constructor() {
+        super();
+    }
+    initializeTeamMember(teamMemberId, config = {}) {
+        const teamMemberLimits = {
+            tokens_used: 0,
+            tokens_limit: config.tokensLimit ?? DEFAULT_LIMITS.tokensLimit,
+            memory_used: 0,
+            memory_limit: config.memoryLimit ?? DEFAULT_LIMITS.memoryLimit,
+            files_processed: 0,
+            files_limit: config.filesLimit ?? DEFAULT_LIMITS.filesLimit,
+            output_size: 0,
+            output_limit: config.outputLimit ?? DEFAULT_LIMITS.outputLimit
+        };
+        this.limits.set(teamMemberId, teamMemberLimits);
+        this.acknowledgments.set(teamMemberId, []);
+        this.lastWarnings.set(teamMemberId, new Map());
+        logger.debug({ teamMemberId, limits: teamMemberLimits }, 'Team Member limits initialized');
+        return teamMemberLimits;
+    }
+    getLimits(teamMemberId) {
+        return this.limits.get(teamMemberId);
+    }
+    updateTokens(teamMemberId, tokens) {
+        const limits = this.limits.get(teamMemberId);
+        if (!limits)
+            return null;
+        limits.tokens_used += tokens;
+        return this.checkLimit(teamMemberId, 'token', limits.tokens_used, limits.tokens_limit);
+    }
+    setTokens(teamMemberId, tokens) {
+        const limits = this.limits.get(teamMemberId);
+        if (!limits)
+            return null;
+        limits.tokens_used = tokens;
+        return this.checkLimit(teamMemberId, 'token', limits.tokens_used, limits.tokens_limit);
+    }
+    updateMemory(teamMemberId, bytes) {
+        const limits = this.limits.get(teamMemberId);
+        if (!limits)
+            return null;
+        limits.memory_used = bytes;
+        return this.checkLimit(teamMemberId, 'memory', limits.memory_used, limits.memory_limit);
+    }
+    updateFilesProcessed(teamMemberId, count) {
+        const limits = this.limits.get(teamMemberId);
+        if (!limits)
+            return null;
+        limits.files_processed += count;
+        return this.checkLimit(teamMemberId, 'file', limits.files_processed, limits.files_limit);
+    }
+    updateOutputSize(teamMemberId, bytes) {
+        const limits = this.limits.get(teamMemberId);
+        if (!limits)
+            return null;
+        limits.output_size += bytes;
+        return this.checkLimit(teamMemberId, 'output', limits.output_size, limits.output_limit);
+    }
+    checkLimit(teamMemberId, type, current, limit) {
+        const percentage = (current / limit) * 100;
+        let level = null;
+        if (percentage >= THRESHOLDS.exceeded) {
+            level = 'exceeded';
+        }
+        else if (percentage >= THRESHOLDS.critical) {
+            level = 'critical';
+        }
+        else if (percentage >= THRESHOLDS.warning) {
+            level = 'warning';
+        }
+        if (!level)
+            return null;
+        const lastWarningMap = this.lastWarnings.get(teamMemberId);
+        if (!lastWarningMap)
+            return null;
+        const lastLevel = lastWarningMap.get(type);
+        if (lastLevel === level) {
+            return null;
+        }
+        lastWarningMap.set(type, level);
+        const warning = {
+            type,
+            level,
+            current,
+            limit,
+            percentage: Math.round(percentage * 10) / 10,
+            message: this.formatMessage(type, level, percentage),
+            suggestion: SUGGESTIONS[type]
+        };
+        this.emit('limit:warning', { teamMemberId, warning });
+        logger.info({ teamMemberId, warning }, 'Team Member limit warning triggered');
+        return warning;
+    }
+    formatMessage(type, level, percentage) {
+        const baseMessage = WARNING_MESSAGES[type][level];
+        const icon = level === 'exceeded' ? '!!!' : level === 'critical' ? '!!' : '!';
+        return `${icon} ${baseMessage} (${Math.round(percentage)}%)`;
+    }
+    checkAllLimits(teamMemberId) {
+        const limits = this.limits.get(teamMemberId);
+        if (!limits)
+            return [];
+        const warnings = [];
+        const types = [
+            { type: 'token', current: limits.tokens_used, limit: limits.tokens_limit },
+            { type: 'memory', current: limits.memory_used, limit: limits.memory_limit },
+            { type: 'file', current: limits.files_processed, limit: limits.files_limit },
+            { type: 'output', current: limits.output_size, limit: limits.output_limit }
+        ];
+        for (const { type, current, limit } of types) {
+            const warning = this.checkLimit(teamMemberId, type, current, limit);
+            if (warning) {
+                warnings.push(warning);
+            }
+        }
+        return warnings;
+    }
+    getLimitStatus(teamMemberId) {
+        const limits = this.limits.get(teamMemberId);
+        if (!limits)
+            return [];
+        return [
+            { type: 'token', current: limits.tokens_used, limit: limits.tokens_limit },
+            { type: 'memory', current: limits.memory_used, limit: limits.memory_limit },
+            { type: 'file', current: limits.files_processed, limit: limits.files_limit },
+            { type: 'output', current: limits.output_size, limit: limits.output_limit }
+        ].map(({ type, current, limit }) => {
+            const percentage = (current / limit) * 100;
+            let level = 'ok';
+            if (percentage >= THRESHOLDS.exceeded)
+                level = 'exceeded';
+            else if (percentage >= THRESHOLDS.critical)
+                level = 'critical';
+            else if (percentage >= THRESHOLDS.warning)
+                level = 'warning';
+            return { type, percentage: Math.round(percentage * 10) / 10, level };
+        });
+    }
+    acknowledgeWarning(teamMemberId, type, action) {
+        const acks = this.acknowledgments.get(teamMemberId);
+        if (!acks)
+            return;
+        const ack = {
+            type,
+            action,
+            timestamp: new Date()
+        };
+        acks.push(ack);
+        this.emit('limit:acknowledged', { teamMemberId, acknowledgment: ack });
+        logger.info({ teamMemberId, ack }, 'Team Member acknowledged limit warning');
+    }
+    getAcknowledgments(teamMemberId) {
+        return this.acknowledgments.get(teamMemberId) || [];
+    }
+    parseAcknowledgment(line) {
+        if (!line.startsWith('LIMIT_ACK:'))
+            return null;
+        try {
+            const data = JSON.parse(line.replace('LIMIT_ACK:', '').trim());
+            if (data.type && data.action) {
+                return { type: data.type, action: data.action };
+            }
+        }
+        catch {
+            logger.debug({ line }, 'Failed to parse LIMIT_ACK');
+        }
+        return null;
+    }
+    formatWarningForTeamMember(warning) {
+        return JSON.stringify({
+            type: 'LIMIT_WARNING',
+            warning: {
+                type: warning.type,
+                level: warning.level,
+                current: warning.current,
+                limit: warning.limit,
+                percentage: warning.percentage,
+                message: warning.message,
+                suggestion: warning.suggestion
+            }
+        });
+    }
+    resetLimits(teamMemberId) {
+        const limits = this.limits.get(teamMemberId);
+        if (limits) {
+            limits.tokens_used = 0;
+            limits.memory_used = 0;
+            limits.files_processed = 0;
+            limits.output_size = 0;
+        }
+        const lastWarningMap = this.lastWarnings.get(teamMemberId);
+        if (lastWarningMap) {
+            lastWarningMap.clear();
+        }
+        logger.debug({ teamMemberId }, 'Team Member limits reset');
+    }
+    removeTeamMember(teamMemberId) {
+        this.limits.delete(teamMemberId);
+        this.acknowledgments.delete(teamMemberId);
+        this.lastWarnings.delete(teamMemberId);
+    }
+    getAllTeamMemberLimits() {
+        return new Map(this.limits);
+    }
+}
+let globalLimitsMonitor = null;
+export function getTeamMemberLimitsMonitor() {
+    if (!globalLimitsMonitor) {
+        globalLimitsMonitor = new TeamMemberLimitsMonitor();
+    }
+    return globalLimitsMonitor;
+}
+//# sourceMappingURL=teamMemberLimits.js.map

package/dist/team-members/teamMemberLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamMemberLimits.js","sourceRoot":"","sources":["../../src/team-members/teamMemberLimits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAgC5C,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,GAAG;CACL,CAAC;AAEX,MAAM,WAAW,GAA8B;IAC7C,KAAK,EAAE,oDAAoD;IAC3D,MAAM,EAAE,kDAAkD;IAC1D,IAAI,EAAE,gCAAgC;IACtC,MAAM,EAAE,oCAAoC;CAC7C,CAAC;AAEF,MAAM,gBAAgB,GAAkD;IACtE,KAAK,EAAE;QACL,OAAO,EAAE,yBAAyB;QAClC,QAAQ,EAAE,yBAAyB;QACnC,QAAQ,EAAE,sBAAsB;KACjC;IACD,MAAM,EAAE;QACN,OAAO,EAAE,0BAA0B;QACnC,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE,uBAAuB;KAClC;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,wBAAwB;QACjC,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE,qBAAqB;KAChC;IACD,MAAM,EAAE;QACN,OAAO,EAAE,0BAA0B;QACnC,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE,uBAAuB;KAClC;CACF,CAAC;AASF,4DAA4D;AAC5D,MAAM,cAAc,GAAoC;IACtD,WAAW,EAAE,MAAM,CAAC,gBAAgB,EAAG,oBAAoB;IAC3D,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,6CAA6C;IAC9E,UAAU,EAAE,MAAM,CAAC,gBAAgB,EAAI,mBAAmB;IAC1D,WAAW,EAAE,MAAM,CAAC,gBAAgB,CAAG,oBAAoB;CAC5D,CAAC;AAEF,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IAC/C,MAAM,GAAkC,IAAI,GAAG,EAAE,CAAC;IAClD,eAAe,GAAuC,IAAI,GAAG,EAAE,CAAC;IAChE,YAAY,GAA4C,IAAI,GAAG,EAAE,CAAC;IAE1E;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,oBAAoB,CAAC,YAAoB,EAAE,SAAgC,EAAE;QAC3E,MAAM,gBAAgB,GAAqB;YACzC,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;YAC9D,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;YAC9D,eAAe,EAAE,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;YAC3D,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;SAC/D,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;QAChD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAE/C,MAAM,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,gCAAgC,CAAC,CAAC;QAC3F,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,SAAS,CAAC,YAAoB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,YAAY,CAAC,YAAoB,EAAE,MAAc;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACzF,CAAC;IAED,SAAS,CAAC,YAAoB,EAAE,MAAc;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACzF,CAAC;IAED,YAAY,CAAC,YAAoB,EAAE,KAAa;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1F,CAAC;IAED,oBAAoB,CAAC,YAAoB,EAAE,KAAa;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,CAAC,eAAe,IAAI,KAAK,CAAC;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3F,CAAC;IAED,gBAAgB,CAAC,YAAoB,EAAE,KAAa;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1F,CAAC;IAEO,UAAU,CAAC,YAAoB,EAAE,IAAe,EAAE,OAAe,EAAE,KAAa;QACtF,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;QAC3C,IAAI,KAAK,GAAsB,IAAI,CAAC;QAEpC,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YACtC,KAAK,GAAG,UAAU,CAAC;QACrB,CAAC;aAAM,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC7C,KAAK,GAAG,UAAU,CAAC;QACrB,CAAC;aAAM,IAAI,UAAU,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YAC5C,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC;QAEjC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEhC,MAAM,OAAO,GAAiB;YAC5B,IAAI;YACJ,KAAK;YACL,OAAO;YACP,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE;YAC5C,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC;YACpD,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC;SAC9B,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,qCAAqC,CAAC,CAAC;QAE9E,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,aAAa,CAAC,IAAe,EAAE,KAAiB,EAAE,UAAkB;QAC1E,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9E,OAAO,GAAG,IAAI,IAAI,WAAW,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;IAC/D,CAAC;IAED,cAAc,CAAC,YAAoB;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,QAAQ,GAAmB,EAAE,CAAC;QAEpC,MAAM,KAAK,GAA+D;YACxE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE;YAC1E,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE;YAC3E,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5E,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE;SAC5E,CAAC;QAEF,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACpE,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,YAAoB;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,OAAO;YACL,EAAE,IAAI,EAAE,OAAoB,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE;YACvF,EAAE,IAAI,EAAE,QAAqB,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE;YACxF,EAAE,IAAI,EAAE,MAAmB,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE;YACzF,EAAE,IAAI,EAAE,QAAqB,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE;SACzF,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;YACjC,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;YAC3C,IAAI,KAAK,GAAsB,IAAI,CAAC;YACpC,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ;gBAAE,KAAK,GAAG,UAAU,CAAC;iBACrD,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ;gBAAE,KAAK,GAAG,UAAU,CAAC;iBAC1D,IAAI,UAAU,IAAI,UAAU,CAAC,OAAO;gBAAE,KAAK,GAAG,SAAS,CAAC;YAC7D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB,CAAC,YAAoB,EAAE,IAAe,EAAE,MAAc;QACtE,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,GAAG,GAAwB;YAC/B,IAAI;YACJ,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE,wCAAwC,CAAC,CAAC;IAC/E,CAAC;IAED,kBAAkB,CAAC,YAAoB;QACrC,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACtD,CAAC;IAED,mBAAmB,CAAC,IAAY;QAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC7B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,2BAA2B,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0BAA0B,CAAC,OAAqB;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B;SACF,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,YAAoB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;YACvB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;YACvB,MAAM,CAAC,eAAe,GAAG,CAAC,CAAC;YAC3B,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,cAAc,EAAE,CAAC;YACnB,cAAc,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAC7D,CAAC;IAED,gBAAgB,CAAC,YAAoB;QACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACjC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,sBAAsB;QACpB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,IAAI,mBAAmB,GAAmC,IAAI,CAAC;AAE/D,MAAM,UAAU,0BAA0B;IACxC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,mBAAmB,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/team-members/teamMemberRegistry.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Team Member Registry - Dynamic Team Member Registration & Discovery
+ *
+ * Maintains a registry of ALL active team members with:
+ * - TeamMember metadata (ID, type, capabilities, status, load)
+ * - Heartbeat-based lifecycle management
+ * - Query interfaces for capability and load-based discovery
+ *
+ * PENDING TEAM REVIEW:
+ * - Team Member 2: TeamMemberInfo interface, storage schema integration
+ * - Team Member 3: Dashboard integration, query methods for TaskOrchestrator
+ *
+ * SpecMem Tag Schema:
+ * ['team-member-registry', 'teamMember:{id}', 'status:{status}', 'capability:{cap}', 'load:{bucket}', 'type:{type}']
+ */
+import { SpecMemClient, Memory } from './workers/specmemClient.js';
+import { EventEmitter } from 'events';
+export type TeamMemberStatus = 'active' | 'idle' | 'busy' | 'offline';
+export type LoadBucket = 'low' | 'medium' | 'high';
+/**
+ * TeamMemberInfo - Complete information about a registered team member
+ *
+ * DISCUSSION NEEDED with Team Member 2:
+ * - Should capabilities be string[] or a more structured type?
+ * - Should we add 'group' or 'team' field for channel integration?
+ */
+export interface TeamMemberInfo {
+    id: string;
+    name?: string;
+    type: string;
+    capabilities: string[];
+    status: TeamMemberStatus;
+    load: number;
+    loadBucket: LoadBucket;
+    lastHeartbeat: Date;
+    registeredAt: Date;
+    metadata: Record<string, any>;
+}
+/**
+ * Input for registering a new team member (some fields auto-generated)
+ */
+export interface TeamMemberRegistrationInput {
+    id: string;
+    name?: string;
+    type: string;
+    capabilities: string[];
+    status?: TeamMemberStatus;
+    load?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * TeamMemberRegistry interface - for mock implementations and testing
+ *
+ * DISCUSSION NEEDED with Team Member 3:
+ * - Are getIdleTeamMembersByCapability and getAvailableTeamMembersByCapability sufficient?
+ * - Do you need additional query methods for TaskOrchestrator?
+ */
+export interface ITeamMemberRegistry {
+    register(input: TeamMemberRegistrationInput): Promise<TeamMemberInfo>;
+    unregister(teamMemberId: string): Promise<boolean>;
+    getTeamMember(teamMemberId: string): Promise<TeamMemberInfo | null>;
+    getAllTeamMembers(): Promise<TeamMemberInfo[]>;
+    getTeamMembersByCapability(capability: string): Promise<TeamMemberInfo[]>;
+    getTeamMembersByStatus(status: TeamMemberStatus): Promise<TeamMemberInfo[]>;
+    getTeamMembersByType(type: string): Promise<TeamMemberInfo[]>;
+    getIdleTeamMembersByCapability(capability: string): Promise<TeamMemberInfo[]>;
+    getAvailableTeamMembersByCapability(capability: string, maxLoad?: number): Promise<TeamMemberInfo[]>;
+    updateTeamMemberStatus(teamMemberId: string, status: TeamMemberStatus): Promise<boolean>;
+    updateTeamMemberLoad(teamMemberId: string, load: number): Promise<boolean>;
+    heartbeat(teamMemberId: string): Promise<boolean>;
+    cleanupStaleTeamMembers(): Promise<string[]>;
+    getTeamMemberCount(): Promise<number>;
+    getTeamMemberCountByStatus(): Promise<Record<TeamMemberStatus, number>>;
+}
+export interface TeamMemberRegistryConfig {
+    /** Heartbeat timeout in milliseconds - team members offline after this (default: 60000) */
+    heartbeatTimeoutMs?: number;
+    /** Cleanup interval in milliseconds (default: 120000) */
+    cleanupIntervalMs?: number;
+    /** Auto-cleanup stale team members (default: true) */
+    autoCleanup?: boolean;
+    /** SpecMem client (optional - will create default if not provided) */
+    client?: SpecMemClient;
+}
+/**
+ * Calculate load bucket from numeric load value
+ */
+export declare function calculateLoadBucket(load: number): LoadBucket;
+/**
+ * Create registry tags for a team member
+ */
+export declare function createRegistryTags(teamMember: TeamMemberInfo): string[];
+/**
+ * Parse team member info from memory
+ */
+export declare function parseTeamMemberFromMemory(memory: Memory): TeamMemberInfo | null;
+export declare class TeamMemberRegistry extends EventEmitter implements ITeamMemberRegistry {
+    private client;
+    private heartbeatTimeoutMs;
+    private cleanupIntervalMs;
+    private autoCleanup;
+    private cleanupTimer?;
+    private localCache;
+    private isRunning;
+    constructor(config?: TeamMemberRegistryConfig);
+    /**
+     * Start the registry service
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the registry service
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a new team member
+     */
+    register(input: TeamMemberRegistrationInput): Promise<TeamMemberInfo>;
+    /**
+     * Unregister a team member
+     */
+    unregister(teamMemberId: string): Promise<boolean>;
+    /**
+     * Get a specific team member by ID
+     */
+    getTeamMember(teamMemberId: string): Promise<TeamMemberInfo | null>;
+    /**
+     * Get all registered team members
+     */
+    getAllTeamMembers(): Promise<TeamMemberInfo[]>;
+    /**
+     * Get team members by capability
+     */
+    getTeamMembersByCapability(capability: string): Promise<TeamMemberInfo[]>;
+    /**
+     * Get team members by status
+     */
+    getTeamMembersByStatus(status: TeamMemberStatus): Promise<TeamMemberInfo[]>;
+    /**
+     * Get team members by type
+     */
+    getTeamMembersByType(type: string): Promise<TeamMemberInfo[]>;
+    /**
+     * Get idle team members with a specific capability
+     */
+    getIdleTeamMembersByCapability(capability: string): Promise<TeamMemberInfo[]>;
+    /**
+     * Get available team members (idle or active with low load) with a specific capability
+     */
+    getAvailableTeamMembersByCapability(capability: string, maxLoad?: number): Promise<TeamMemberInfo[]>;
+    /**
+     * Update team member status
+     */
+    updateTeamMemberStatus(teamMemberId: string, status: TeamMemberStatus): Promise<boolean>;
+    /**
+     * Update team member load
+     */
+    updateTeamMemberLoad(teamMemberId: string, load: number): Promise<boolean>;
+    /**
+     * Send heartbeat for a team member
+     */
+    heartbeat(teamMemberId: string): Promise<boolean>;
+    /**
+     * Clean up stale team members (no heartbeat within timeout)
+     */
+    cleanupStaleTeamMembers(): Promise<string[]>;
+    /**
+     * Get total number of registered team members (not offline)
+     */
+    getTeamMemberCount(): Promise<number>;
+    /**
+     * Get count of teamMembers by status
+     */
+    getTeamMemberCountByStatus(): Promise<Record<TeamMemberStatus, number>>;
+    /**
+     * Refresh local cache from SpecMem
+     */
+    private refreshCache;
+    /**
+     * Parse unique team members from memories (keeping most recent)
+     */
+    private parseUniqueTeamMembers;
+}
+/**
+ * Create a new TeamMemberRegistry instance
+ */
+export declare function createTeamMemberRegistry(config?: TeamMemberRegistryConfig): TeamMemberRegistry;
+/**
+ * Get the global registry instance
+ */
+export declare function getGlobalRegistry(): TeamMemberRegistry;
+/**
+ * Initialize and start the global registry
+ */
+export declare function initializeGlobalRegistry(config?: TeamMemberRegistryConfig): Promise<TeamMemberRegistry>;
+/**
+ * Shutdown the global registry
+ */
+export declare function shutdownGlobalRegistry(): Promise<void>;
+//# sourceMappingURL=teamMemberRegistry.d.ts.map

package/dist/team-members/teamMemberRegistry.d.ts.map

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