monomind 1.19.0 → 2.0.0

package/packages/@monomind/cli/dist/src/services/claim-service.js

@@ -1,890 +0,0 @@
-/**
- * V1 Collaborative Issue Claims Service
- *
- * Implements ADR-016: Collaborative Issue Claims for Human-Agent Workflows
- *
- * Features:
- * - Issue claiming/releasing for humans and agents
- * - Handoff mechanisms between humans and agents
- * - Work stealing for idle agents
- * - Load balancing across swarm
- * - GitHub integration
- *
- * @see /packages/implementation/adrs/ADR-016-collaborative-issue-claims.md
- */
-import { EventEmitter } from 'node:events';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { execFileSync } from 'node:child_process';
-// ============================================================================
-// Default Configuration
-// ============================================================================
-const DEFAULT_CONFIG = {
-    staleThresholdMinutes: 30,
-    blockedThresholdMinutes: 60,
-    overloadThreshold: 5,
-    gracePeriodMinutes: 10,
-    minProgressToProtect: 75,
-    contestWindowMinutes: 5,
-    requireSameType: false,
-    allowCrossTypeSteal: [
-        ['coder', 'debugger'],
-        ['tester', 'reviewer'],
-    ],
-};
-// ============================================================================
-// Claim Service Implementation
-// ============================================================================
-export class ClaimService extends EventEmitter {
-    claims = new Map();
-    stealableInfo = new Map();
-    storagePath;
-    config;
-    eventLog = [];
-    constructor(projectRoot, config) {
-        super();
-        this.storagePath = path.join(projectRoot, '.monomind', 'claims');
-        this.config = { ...DEFAULT_CONFIG, ...config };
-    }
-    // ==========================================================================
-    // Initialization
-    // ==========================================================================
-    async initialize() {
-        // Ensure storage directory exists
-        if (!fs.existsSync(this.storagePath)) {
-            fs.mkdirSync(this.storagePath, { recursive: true });
-        }
-        // Load existing claims
-        await this.loadClaims();
-    }
-    // Hard cap on claims.json: a file larger than this is malformed or
-    // adversarially crafted (normal claim files are tiny).
-    static MAX_CLAIMS_FILE_BYTES = 10 * 1024 * 1024; // 10 MB
-    async loadClaims() {
-        const claimsFile = path.join(this.storagePath, 'claims.json');
-        if (fs.existsSync(claimsFile)) {
-            try {
-                const fileSize = fs.statSync(claimsFile).size;
-                if (fileSize > ClaimService.MAX_CLAIMS_FILE_BYTES) {
-                    // Oversized file — skip loading rather than OOM-ing the daemon
-                    return;
-                }
-                const data = JSON.parse(fs.readFileSync(claimsFile, 'utf-8'));
-                for (const claim of data.claims || []) {
-                    claim.claimedAt = new Date(claim.claimedAt);
-                    claim.statusChangedAt = new Date(claim.statusChangedAt);
-                    if (claim.expiresAt)
-                        claim.expiresAt = new Date(claim.expiresAt);
-                    this.claims.set(claim.issueId, claim);
-                }
-            }
-            catch {
-                // Start fresh if file is corrupted
-            }
-        }
-    }
-    // Single-flight save lock: serializes concurrent saveClaims() calls so that
-    // two writers cannot collide on the .tmp file or interleave their renames.
-    // Combined with the unique tmp suffix below, this defends against in-process
-    // corruption of claims.json. Cross-process safety still requires fcntl/flock
-    // around the read-modify-write at higher level.
-    _saveQueue = Promise.resolve();
-    async saveClaims() {
-        // CRITICAL: do NOT let a single rejection (ENOSPC / EROFS / EACCES)
-        // poison the entire chain. Previously every subsequent saveClaims would
-        // inherit the rejection and silently skip _doSaveClaims, causing the
-        // in-memory Map to drift from disk indefinitely — a permanent
-        // authorization-state desync. Catch the chain link so the next link runs;
-        // re-expose the real rejection to the caller via a separate promise.
-        const next = this._saveQueue
-            .catch(() => undefined)
-            .then(() => this._doSaveClaims());
-        this._saveQueue = next.catch(() => undefined);
-        return next;
-    }
-    async _doSaveClaims() {
-        const claimsFile = path.join(this.storagePath, 'claims.json');
-        const data = {
-            claims: Array.from(this.claims.values()),
-            savedAt: new Date().toISOString(),
-        };
-        // Unique tmp filename so a previous in-flight write cannot be clobbered
-        // by a concurrent fs.writeFileSync truncating the same .tmp path.
-        const { randomBytes } = await import('node:crypto');
-        const tmp = `${claimsFile}.${process.pid}.${Date.now()}.${randomBytes(4).toString('hex')}.tmp`;
-        fs.writeFileSync(tmp, JSON.stringify(data, null, 2));
-        fs.renameSync(tmp, claimsFile);
-    }
-    // ==========================================================================
-    // Core Claiming
-    // ==========================================================================
-    async claim(issueId, claimant) {
-        // Check if already claimed
-        const existing = this.claims.get(issueId);
-        if (existing && existing.status !== 'stealable') {
-            return {
-                success: false,
-                error: `Issue ${issueId} is already claimed by ${this.formatClaimant(existing.claimant)}`,
-            };
-        }
-        const now = new Date();
-        const claim = {
-            issueId,
-            claimant,
-            claimedAt: now,
-            status: 'active',
-            statusChangedAt: now,
-            progress: 0,
-        };
-        this.claims.set(issueId, claim);
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:claimed',
-            timestamp: now,
-            issueId,
-            claimant,
-            previousClaimant: existing?.claimant,
-        });
-        return { success: true, claim };
-    }
-    async release(issueId, claimant) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            throw new Error(`Issue ${issueId} is not claimed`);
-        }
-        if (!this.isSameClaimant(claim.claimant, claimant)) {
-            throw new Error(`Issue ${issueId} is not claimed by ${this.formatClaimant(claimant)}`);
-        }
-        this.claims.delete(issueId);
-        this.stealableInfo.delete(issueId);
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:released',
-            timestamp: new Date(),
-            issueId,
-            claimant,
-        });
-    }
-    // ==========================================================================
-    // Handoffs
-    // ==========================================================================
-    async requestHandoff(issueId, from, to, reason) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            throw new Error(`Issue ${issueId} is not claimed`);
-        }
-        if (!this.isSameClaimant(claim.claimant, from)) {
-            throw new Error(`Issue ${issueId} is not claimed by ${this.formatClaimant(from)}`);
-        }
-        claim.status = 'handoff-pending';
-        claim.statusChangedAt = new Date();
-        claim.handoffTo = to;
-        claim.handoffReason = reason;
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:handoff:requested',
-            timestamp: new Date(),
-            issueId,
-            claimant: from,
-            data: { to, reason },
-        });
-    }
-    async acceptHandoff(issueId, claimant) {
-        const claim = this.claims.get(issueId);
-        if (!claim || claim.status !== 'handoff-pending') {
-            throw new Error(`No pending handoff for issue ${issueId}`);
-        }
-        if (!claim.handoffTo || !this.isSameClaimant(claim.handoffTo, claimant)) {
-            throw new Error(`Handoff not addressed to ${this.formatClaimant(claimant)}`);
-        }
-        const previousClaimant = claim.claimant;
-        claim.claimant = claimant;
-        claim.status = 'active';
-        claim.statusChangedAt = new Date();
-        delete claim.handoffTo;
-        delete claim.handoffReason;
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:handoff:accepted',
-            timestamp: new Date(),
-            issueId,
-            claimant,
-            previousClaimant,
-        });
-    }
-    async rejectHandoff(issueId, claimant, reason) {
-        const claim = this.claims.get(issueId);
-        if (!claim || claim.status !== 'handoff-pending') {
-            throw new Error(`No pending handoff for issue ${issueId}`);
-        }
-        if (!claim.handoffTo || !this.isSameClaimant(claim.handoffTo, claimant)) {
-            throw new Error(`Handoff not addressed to ${this.formatClaimant(claimant)}`);
-        }
-        claim.status = 'active';
-        claim.statusChangedAt = new Date();
-        delete claim.handoffTo;
-        delete claim.handoffReason;
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:handoff:rejected',
-            timestamp: new Date(),
-            issueId,
-            claimant,
-            data: { reason },
-        });
-    }
-    // ==========================================================================
-    // Status Updates
-    // ==========================================================================
-    async updateStatus(issueId, status, note) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            throw new Error(`Issue ${issueId} is not claimed`);
-        }
-        const previousStatus = claim.status;
-        claim.status = status;
-        claim.statusChangedAt = new Date();
-        if (status === 'blocked' && note) {
-            claim.blockReason = note;
-        }
-        if (status === 'completed') {
-            claim.progress = 100;
-            // Evict completed claims after saving to prevent unbounded Map growth
-            await this.saveClaims();
-            this.claims.delete(issueId);
-            return;
-        }
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:status:changed',
-            timestamp: new Date(),
-            issueId,
-            data: { previousStatus, newStatus: status, note },
-        });
-    }
-    async updateProgress(issueId, progress) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            throw new Error(`Issue ${issueId} is not claimed`);
-        }
-        claim.progress = Math.min(100, Math.max(0, progress));
-        await this.saveClaims();
-    }
-    async requestReview(issueId, reviewers) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            throw new Error(`Issue ${issueId} is not claimed`);
-        }
-        claim.status = 'review-requested';
-        claim.statusChangedAt = new Date();
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:review:requested',
-            timestamp: new Date(),
-            issueId,
-            claimant: claim.claimant,
-            data: { reviewers },
-        });
-    }
-    // ==========================================================================
-    // Work Stealing
-    // ==========================================================================
-    async markStealable(issueId, info, claimant) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            throw new Error(`Issue ${issueId} is not claimed`);
-        }
-        if (claimant !== undefined && !this.isSameClaimant(claim.claimant, claimant)) {
-            throw new Error(`Issue ${issueId} is not owned by ${this.formatClaimant(claimant)}`);
-        }
-        claim.status = 'stealable';
-        claim.statusChangedAt = new Date();
-        claim.context = info.context;
-        claim.progress = info.progress;
-        this.stealableInfo.set(issueId, info);
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:stealable',
-            timestamp: new Date(),
-            issueId,
-            claimant: claim.claimant,
-            data: { info },
-        });
-    }
-    async steal(issueId, stealer) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            return { success: false, error: `Issue ${issueId} is not claimed` };
-        }
-        if (claim.status !== 'stealable') {
-            return { success: false, error: `Issue ${issueId} is not stealable` };
-        }
-        const info = this.stealableInfo.get(issueId);
-        const previousOwner = claim.claimant;
-        // Check if steal is allowed
-        if (this.config.requireSameType &&
-            stealer.type === 'agent' &&
-            previousOwner.type === 'agent') {
-            if (stealer.agentType !== previousOwner.agentType) {
-                const allowed = this.config.allowCrossTypeSteal.some((pair) => pair.includes(stealer.agentType) &&
-                    pair.includes(previousOwner.agentType));
-                if (!allowed) {
-                    return { success: false, error: `Cross-type steal not allowed` };
-                }
-            }
-        }
-        // Execute steal
-        claim.claimant = stealer;
-        claim.status = 'active';
-        claim.statusChangedAt = new Date();
-        claim.claimedAt = new Date();
-        this.stealableInfo.delete(issueId);
-        await this.saveClaims();
-        this.emitEvent({
-            type: 'issue:stolen',
-            timestamp: new Date(),
-            issueId,
-            claimant: stealer,
-            previousClaimant: previousOwner,
-            data: { context: info },
-        });
-        return { success: true, claim, previousOwner, context: info };
-    }
-    async getStealable(agentType) {
-        const stealable = [];
-        for (const claim of this.claims.values()) {
-            if (claim.status !== 'stealable')
-                continue;
-            const info = this.stealableInfo.get(claim.issueId);
-            if (agentType && info?.preferredTypes?.length) {
-                if (!info.preferredTypes.includes(agentType))
-                    continue;
-            }
-            stealable.push(claim);
-        }
-        return stealable;
-    }
-    async contestSteal(issueId, originalClaimant, reason) {
-        const claim = this.claims.get(issueId);
-        if (!claim) {
-            throw new Error(`Issue ${issueId} is not claimed`);
-        }
-        this.emitEvent({
-            type: 'issue:steal:contested',
-            timestamp: new Date(),
-            issueId,
-            claimant: originalClaimant,
-            data: { reason, currentOwner: claim.claimant },
-        });
-        // Contest resolution would typically be handled by a coordinator or human
-    }
-    // ==========================================================================
-    // Load Balancing
-    // ==========================================================================
-    async getAgentLoad(agentId) {
-        const claims = [];
-        let blockedCount = 0;
-        for (const claim of this.claims.values()) {
-            if (claim.claimant.type === 'agent' && claim.claimant.agentId === agentId) {
-                claims.push(claim);
-                if (claim.status === 'blocked')
-                    blockedCount++;
-            }
-        }
-        const first = claims[0]?.claimant;
-        const agentType = first?.type === 'agent' ? first.agentType : 'unknown';
-        return {
-            agentId,
-            agentType,
-            claimCount: claims.length,
-            maxClaims: this.config.overloadThreshold,
-            utilization: claims.length / this.config.overloadThreshold,
-            claims,
-            avgCompletionTime: 0, // Would need historical data
-            currentBlockedCount: blockedCount,
-        };
-    }
-    async rebalance(_swarmId) {
-        const result = { moved: [], suggested: [] };
-        // Get all agent loads
-        const agentLoads = new Map();
-        const agentTypes = new Set();
-        for (const claim of this.claims.values()) {
-            if (claim.claimant.type !== 'agent')
-                continue;
-            const agentId = claim.claimant.agentId;
-            if (!agentLoads.has(agentId)) {
-                const load = await this.getAgentLoad(agentId);
-                agentLoads.set(agentId, load);
-                agentTypes.add(load.agentType);
-            }
-        }
-        // For each agent type, calculate average load
-        for (const agentType of agentTypes) {
-            const typeLoads = Array.from(agentLoads.values()).filter((l) => l.agentType === agentType);
-            const avgLoad = typeLoads.reduce((sum, l) => sum + l.utilization, 0) / typeLoads.length;
-            const overloaded = typeLoads.filter((l) => l.utilization > avgLoad * 1.5);
-            const underloaded = typeLoads.filter((l) => l.utilization < avgLoad * 0.5);
-            // Generate suggestions
-            for (const over of overloaded) {
-                const lowProgressClaims = over.claims
-                    .filter((c) => c.progress < 25)
-                    .sort((a, b) => a.progress - b.progress);
-                for (const claim of lowProgressClaims) {
-                    const target = underloaded.find((u) => u.claimCount < u.maxClaims);
-                    if (target) {
-                        result.suggested.push({
-                            issueId: claim.issueId,
-                            currentOwner: claim.claimant,
-                            suggestedOwner: {
-                                type: 'agent',
-                                agentId: target.agentId,
-                                agentType: target.agentType,
-                            },
-                            reason: 'Load balancing: redistributing work across swarm',
-                        });
-                    }
-                }
-            }
-        }
-        return result;
-    }
-    // ==========================================================================
-    // Queries
-    // ==========================================================================
-    async getClaimedBy(claimant) {
-        return Array.from(this.claims.values()).filter((c) => this.isSameClaimant(c.claimant, claimant));
-    }
-    async getAvailableIssues(_filters) {
-        // This would integrate with GitHub API
-        // For now, return issues that are not claimed
-        return [];
-    }
-    async getIssueStatus(issueId) {
-        return this.claims.get(issueId) || null;
-    }
-    async getAllClaims() {
-        return Array.from(this.claims.values());
-    }
-    async getByStatus(status) {
-        return Array.from(this.claims.values()).filter((c) => c.status === status);
-    }
-    // ==========================================================================
-    // Auto-Management
-    // ==========================================================================
-    async expireStale(maxAgeMinutes) {
-        const threshold = maxAgeMinutes ?? this.config.staleThresholdMinutes;
-        const now = Date.now();
-        const expired = [];
-        for (const claim of this.claims.values()) {
-            if (claim.status === 'stealable' || claim.status === 'completed')
-                continue;
-            const age = (now - claim.statusChangedAt.getTime()) / 60000;
-            if (age > threshold) {
-                // Mark as stealable
-                await this.markStealable(claim.issueId, {
-                    reason: 'stale',
-                    stealableAt: new Date(),
-                    progress: claim.progress,
-                    context: `Stale: No activity for ${Math.round(age)} minutes`,
-                });
-                expired.push(claim);
-            }
-        }
-        return expired;
-    }
-    // ==========================================================================
-    // Helpers
-    // ==========================================================================
-    formatClaimant(claimant) {
-        return claimant.type === 'human'
-            ? `human:${claimant.name}`
-            : `agent:${claimant.agentType}:${claimant.agentId}`;
-    }
-    isSameClaimant(a, b) {
-        if (a.type !== b.type)
-            return false;
-        if (a.type === 'human' && b.type === 'human') {
-            return a.userId === b.userId;
-        }
-        if (a.type === 'agent' && b.type === 'agent') {
-            return a.agentId === b.agentId;
-        }
-        return false;
-    }
-    emitEvent(event) {
-        this.eventLog.push(event);
-        if (this.eventLog.length > 1000) {
-            this.eventLog = this.eventLog.slice(-500);
-        }
-        this.emit(event.type, event);
-    }
-    getEventLog(limit = 100) {
-        return this.eventLog.slice(-limit);
-    }
-}
-// ============================================================================
-// GitHub Sync Implementation
-// ============================================================================
-const DEFAULT_GITHUB_CONFIG = {
-    enabled: false,
-    syncLabels: true,
-    claimLabel: 'claimed',
-    autoAssign: true,
-    commentOnClaim: true,
-    commentOnRelease: true,
-};
-// ============================================================================
-// Input Validation (Security)
-// ============================================================================
-/**
- * Validate GitHub repository format (owner/repo)
- * Prevents command injection via malicious repo names
- */
-function isValidRepo(repo) {
-    // owner/repo format: alphanumeric, hyphens, underscores, dots
-    return /^[\w.-]+\/[\w.-]+$/.test(repo) && repo.length <= 100;
-}
-/**
- * Validate issue number (positive integer)
- */
-function isValidIssueNumber(num) {
-    return Number.isInteger(num) && num > 0 && num < 1000000000;
-}
-/**
- * Validate claimant name (GitHub username format)
- * Prevents command injection via malicious usernames
- */
-function isValidClaimantName(name) {
-    // GitHub usernames: alphanumeric, hyphens, max 39 chars
-    return /^[\w-]+$/.test(name) && name.length >= 1 && name.length <= 39;
-}
-/**
- * Validate label name
- * Prevents command injection via malicious label names
- */
-function isValidLabel(label) {
-    // Labels: alphanumeric, hyphens, underscores, spaces, max 50 chars
-    return /^[\w\s-]+$/.test(label) && label.length >= 1 && label.length <= 50;
-}
-/**
- * Sanitize error messages to prevent information disclosure
- */
-function sanitizeError(error) {
-    const msg = error.message || 'Unknown error';
-    // Remove paths and sensitive details
-    return msg.replace(/\/[\w./-]+/g, '[path]').substring(0, 200);
-}
-export class GitHubSync {
-    config;
-    claimService;
-    constructor(claimService, config) {
-        this.claimService = claimService;
-        this.config = { ...DEFAULT_GITHUB_CONFIG, ...config };
-    }
-    /**
-     * Check if GitHub CLI is available
-     */
-    isGhAvailable() {
-        try {
-            execFileSync('gh', ['--version'], { stdio: 'ignore' });
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Get the current repository from git remote
-     */
-    getRepo() {
-        if (this.config.repo) {
-            return isValidRepo(this.config.repo) ? this.config.repo : null;
-        }
-        try {
-            const remote = execFileSync('git', ['remote', 'get-url', 'origin'], {
-                encoding: 'utf-8',
-            }).trim();
-            const match = remote.match(/github\.com[/:]([\w.-]+\/[\w.-]+)/);
-            const repo = match ? match[1].replace('.git', '') : null;
-            return repo && isValidRepo(repo) ? repo : null;
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Sync issues from GitHub
-     */
-    async syncIssues(state = 'open') {
-        const errors = [];
-        const issues = [];
-        if (!this.isGhAvailable()) {
-            return { success: false, synced: 0, errors: ['GitHub CLI (gh) not installed'] };
-        }
-        const repo = this.getRepo();
-        if (!repo) {
-            return {
-                success: false,
-                synced: 0,
-                errors: ['Could not determine GitHub repository'],
-            };
-        }
-        // Validate state parameter (whitelist)
-        const validStates = ['open', 'closed', 'all'];
-        if (!validStates.includes(state)) {
-            return { success: false, synced: 0, errors: ['Invalid state parameter'] };
-        }
-        try {
-            const issuesJson = execFileSync('gh', [
-                'issue',
-                'list',
-                '--repo',
-                repo,
-                '--state',
-                state,
-                '--json',
-                'number,title,body,state,labels,assignees,url,createdAt,updatedAt',
-                '--limit',
-                '100',
-            ], { encoding: 'utf-8' });
-            const rawIssues = JSON.parse(issuesJson);
-            for (const raw of rawIssues) {
-                issues.push({
-                    number: raw.number,
-                    title: raw.title,
-                    body: raw.body || '',
-                    state: raw.state === 'OPEN' ? 'open' : 'closed',
-                    labels: raw.labels?.map((l) => l.name) || [],
-                    assignees: raw.assignees?.map((a) => a.login) || [],
-                    url: raw.url,
-                    createdAt: new Date(raw.createdAt),
-                    updatedAt: new Date(raw.updatedAt),
-                });
-            }
-            return { success: true, synced: issues.length, errors, issues };
-        }
-        catch (error) {
-            errors.push(`Failed to fetch issues: ${sanitizeError(error)}`);
-            return { success: false, synced: 0, errors };
-        }
-    }
-    /**
-     * Sync a local claim to GitHub (add label/assignee/comment)
-     */
-    async claimOnGitHub(issueNumber, claimant) {
-        const errors = [];
-        if (!this.config.enabled) {
-            return { success: true, synced: 0, errors: ['GitHub sync not enabled'] };
-        }
-        if (!this.isGhAvailable()) {
-            return { success: false, synced: 0, errors: ['GitHub CLI (gh) not installed'] };
-        }
-        // Validate issue number
-        if (!isValidIssueNumber(issueNumber)) {
-            return { success: false, synced: 0, errors: ['Invalid issue number'] };
-        }
-        const repo = this.getRepo();
-        if (!repo) {
-            return { success: false, synced: 0, errors: ['Could not determine repository'] };
-        }
-        // Validate claim label
-        if (!isValidLabel(this.config.claimLabel)) {
-            return {
-                success: false,
-                synced: 0,
-                errors: ['Invalid claim label configuration'],
-            };
-        }
-        try {
-            // Add claim label
-            if (this.config.syncLabels) {
-                try {
-                    execFileSync('gh', [
-                        'issue',
-                        'edit',
-                        String(issueNumber),
-                        '--repo',
-                        repo,
-                        '--add-label',
-                        this.config.claimLabel,
-                    ], { stdio: 'ignore' });
-                }
-                catch {
-                    errors.push('Failed to add claim label (label may not exist)');
-                }
-            }
-            // Auto-assign if human claimant
-            if (this.config.autoAssign && claimant.type === 'human') {
-                if (!isValidClaimantName(claimant.name)) {
-                    errors.push('Invalid claimant name format');
-                }
-                else {
-                    try {
-                        execFileSync('gh', [
-                            'issue',
-                            'edit',
-                            String(issueNumber),
-                            '--repo',
-                            repo,
-                            '--add-assignee',
-                            claimant.name,
-                        ], { stdio: 'ignore' });
-                    }
-                    catch {
-                        errors.push('Failed to assign issue');
-                    }
-                }
-            }
-            // Add comment
-            if (this.config.commentOnClaim) {
-                const claimantStr = claimant.type === 'human'
-                    ? `@${claimant.name.replace(/[^a-zA-Z0-9_-]/g, '')}`
-                    : `Agent: ${(claimant.agentType || 'unknown').replace(/[^a-zA-Z0-9_-]/g, '')}`;
-                const comment = `🤖 **Issue claimed** by ${claimantStr}\n\n_Coordinated by Monomind_`;
-                try {
-                    execFileSync('gh', ['issue', 'comment', String(issueNumber), '--repo', repo, '--body', comment], { stdio: 'ignore' });
-                }
-                catch {
-                    errors.push('Failed to add comment');
-                }
-            }
-            return { success: errors.length === 0, synced: 1, errors };
-        }
-        catch (error) {
-            errors.push(`GitHub sync failed: ${sanitizeError(error)}`);
-            return { success: false, synced: 0, errors };
-        }
-    }
-    /**
-     * Release claim on GitHub (remove label/assignee/comment)
-     */
-    async releaseOnGitHub(issueNumber, claimant) {
-        const errors = [];
-        if (!this.config.enabled) {
-            return { success: true, synced: 0, errors: ['GitHub sync not enabled'] };
-        }
-        if (!this.isGhAvailable()) {
-            return { success: false, synced: 0, errors: ['GitHub CLI (gh) not installed'] };
-        }
-        // Validate issue number
-        if (!isValidIssueNumber(issueNumber)) {
-            return { success: false, synced: 0, errors: ['Invalid issue number'] };
-        }
-        const repo = this.getRepo();
-        if (!repo) {
-            return { success: false, synced: 0, errors: ['Could not determine repository'] };
-        }
-        // Validate claim label
-        if (!isValidLabel(this.config.claimLabel)) {
-            return {
-                success: false,
-                synced: 0,
-                errors: ['Invalid claim label configuration'],
-            };
-        }
-        try {
-            // Remove claim label
-            if (this.config.syncLabels) {
-                try {
-                    execFileSync('gh', [
-                        'issue',
-                        'edit',
-                        String(issueNumber),
-                        '--repo',
-                        repo,
-                        '--remove-label',
-                        this.config.claimLabel,
-                    ], { stdio: 'ignore' });
-                }
-                catch {
-                    // Label might not exist
-                }
-            }
-            // Remove assignee if human claimant
-            if (this.config.autoAssign && claimant.type === 'human') {
-                if (isValidClaimantName(claimant.name)) {
-                    try {
-                        execFileSync('gh', [
-                            'issue',
-                            'edit',
-                            String(issueNumber),
-                            '--repo',
-                            repo,
-                            '--remove-assignee',
-                            claimant.name,
-                        ], { stdio: 'ignore' });
-                    }
-                    catch {
-                        errors.push('Failed to remove assignee');
-                    }
-                }
-            }
-            // Add release comment
-            if (this.config.commentOnRelease) {
-                const claimantStr = claimant.type === 'human'
-                    ? `@${claimant.name.replace(/[^a-zA-Z0-9_-]/g, '')}`
-                    : `Agent: ${(claimant.agentType || 'unknown').replace(/[^a-zA-Z0-9_-]/g, '')}`;
-                const comment = `🔓 **Issue released** by ${claimantStr}\n\n_This issue is now available for others to claim._`;
-                try {
-                    execFileSync('gh', ['issue', 'comment', String(issueNumber), '--repo', repo, '--body', comment], { stdio: 'ignore' });
-                }
-                catch {
-                    errors.push('Failed to add release comment');
-                }
-            }
-            return { success: errors.length === 0, synced: 1, errors };
-        }
-        catch (error) {
-            errors.push(`GitHub release sync failed: ${sanitizeError(error)}`);
-            return { success: false, synced: 0, errors };
-        }
-    }
-    /**
-     * Bulk sync all local claims to GitHub
-     */
-    async syncAllClaimsToGitHub() {
-        const errors = [];
-        let synced = 0;
-        const claims = await this.claimService.getAllClaims();
-        for (const claim of claims) {
-            // Extract issue number from issueId (assumes format like "123" or "issue-123")
-            const issueMatch = claim.issueId.match(/(\d+)/);
-            if (issueMatch) {
-                const result = await this.claimOnGitHub(parseInt(issueMatch[1], 10), claim.claimant);
-                if (result.success)
-                    synced++;
-                else
-                    errors.push(...result.errors);
-            }
-        }
-        return { success: errors.length === 0, synced, errors };
-    }
-    /**
-     * Get GitHub issues that are claimed locally
-     */
-    async getClaimedGitHubIssues() {
-        const syncResult = await this.syncIssues('open');
-        if (!syncResult.success || !syncResult.issues)
-            return [];
-        const localClaims = await this.claimService.getAllClaims();
-        const claimedIds = new Set(localClaims
-            .map((c) => {
-            const match = c.issueId.match(/(\d+)/);
-            return match ? parseInt(match[1], 10) : null;
-        })
-            .filter((n) => n !== null));
-        return syncResult.issues.filter((issue) => claimedIds.has(issue.number));
-    }
-}
-// ============================================================================
-// Factory
-// ============================================================================
-export function createClaimService(projectRoot, config) {
-    return new ClaimService(projectRoot, config);
-}
-export function createGitHubSync(claimService, config) {
-    return new GitHubSync(claimService, config);
-}
-export default ClaimService;
-//# sourceMappingURL=claim-service.js.map