crewly 1.5.17 → 1.5.19

package/dist/backend/backend/src/services/v3/mission-executor.service.js

@@ -0,0 +1,301 @@
+/**
+ * Mission Executor Service
+ *
+ * Lightweight orchestration service for Mission autonomous execution.
+ * Does NOT contain LLM logic — the agent runtime handles thinking
+ * via the decompose-mission skill. This service handles:
+ *
+ * - Processing decomposition results (skill output → WorkItems)
+ * - Mission lifecycle (start, pause, resume)
+ * - Progress tracking (aggregate WorkItem statuses)
+ * - Policy enforcement before creating tasks
+ *
+ * @module services/v3/mission-executor.service
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { TaskPoolService } from '../task-pool/task-pool.service.js';
+import { createWorkItem } from '../../types/v2/work-item.types.js';
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export class MissionExecutorService {
+    static instance = null;
+    logger;
+    /** Track which phase each mission is on */
+    missionPhases = new Map();
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('MissionExecutor');
+    }
+    static getInstance() {
+        if (!MissionExecutorService.instance) {
+            MissionExecutorService.instance = new MissionExecutorService();
+        }
+        return MissionExecutorService.instance;
+    }
+    static resetInstance() {
+        MissionExecutorService.instance = null;
+    }
+    // ---------------------------------------------------------------------------
+    // Decomposition Processing
+    // ---------------------------------------------------------------------------
+    /**
+     * Process decomposition output from the decompose-mission skill.
+     * Creates WorkItems in the TaskPool with dependency metadata.
+     *
+     * @param result - Decomposition result from the skill
+     * @param mission - The parent Mission
+     * @returns Created WorkItem IDs
+     */
+    async processDecomposition(result, mission) {
+        // Policy check
+        if (!mission.policy.canCreateTasks) {
+            throw new Error(`Mission ${mission.id} policy does not allow task creation`);
+        }
+        const taskPool = TaskPoolService.getInstance();
+        const createdIds = [];
+        const titleToId = new Map();
+        const createdItems = new Map();
+        // First pass: create all WorkItems (queued or blocked)
+        for (const task of result.tasks) {
+            const hasDeps = task.dependsOn && task.dependsOn.length > 0;
+            const workItem = createWorkItem({
+                type: (task.type === 'delegate' ? 'delegate' : task.type),
+                owner: 'orchestrator',
+                title: task.title,
+                description: task.description,
+                missionId: mission.id,
+                metadata: {
+                    phase: result.phase,
+                    suggestedRole: task.suggestedRole,
+                    estimatedMinutes: task.estimatedMinutes,
+                    priority: task.priority,
+                    _dependsOnTitles: task.dependsOn ?? [],
+                    krId: task.krId,
+                    krContribution: task.krContribution,
+                },
+            });
+            if (hasDeps) {
+                workItem.status = 'blocked';
+            }
+            titleToId.set(task.title, workItem.id);
+            createdItems.set(workItem.id, workItem);
+            createdIds.push(workItem.id);
+        }
+        // Second pass: resolve title-based dependencies to WorkItem IDs
+        for (const task of result.tasks) {
+            if (!task.dependsOn || task.dependsOn.length === 0)
+                continue;
+            const workItemId = titleToId.get(task.title);
+            if (!workItemId)
+                continue;
+            const blockedByIds = task.dependsOn
+                .map((depTitle) => titleToId.get(depTitle))
+                .filter((id) => id !== undefined);
+            if (blockedByIds.length > 0) {
+                const wi = createdItems.get(workItemId);
+                if (wi?.metadata) {
+                    wi.metadata._blockedBy = blockedByIds;
+                }
+            }
+        }
+        // Add all items to pool (after dependency resolution)
+        for (const wi of createdItems.values()) {
+            await taskPool.addToPool(wi);
+        }
+        // Link WorkItems to KRs (OKR integration)
+        for (const task of result.tasks) {
+            if (task.krId) {
+                const workItemId = titleToId.get(task.title);
+                if (workItemId) {
+                    try {
+                        const { KRTrackingService } = await import('./kr-tracking.service.js');
+                        await KRTrackingService.getInstance().linkWorkItem(mission.id, task.krId, workItemId);
+                    }
+                    catch {
+                        // KR linkage is best-effort — don't block decomposition
+                    }
+                }
+            }
+        }
+        this.missionPhases.set(mission.id, result.phase);
+        this.logger.info('Decomposition processed — WorkItems created', {
+            missionId: mission.id,
+            phase: result.phase,
+            taskCount: result.tasks.length,
+            blockedCount: result.tasks.filter((t) => t.dependsOn && t.dependsOn.length > 0).length,
+        });
+        return createdIds;
+    }
+    // ---------------------------------------------------------------------------
+    // Progress
+    // ---------------------------------------------------------------------------
+    /**
+     * Compute Mission progress from WorkItem statuses.
+     *
+     * @param missionId - The Mission to check
+     * @returns Progress snapshot
+     */
+    async checkProgress(missionId) {
+        const taskPool = TaskPoolService.getInstance();
+        const allItems = await taskPool.getAllItems();
+        const missionItems = allItems.filter((wi) => wi.missionId === missionId);
+        const counts = {
+            total: missionItems.length,
+            done: 0,
+            running: 0,
+            queued: 0,
+            blocked: 0,
+            failed: 0,
+        };
+        let totalCost = 0;
+        for (const wi of missionItems) {
+            if (wi.status === 'done')
+                counts.done++;
+            else if (wi.status === 'running')
+                counts.running++;
+            else if (wi.status === 'queued' || wi.status === 'scheduled')
+                counts.queued++;
+            else if (wi.status === 'blocked')
+                counts.blocked++;
+            else if (wi.status === 'failed')
+                counts.failed++;
+            totalCost += wi.cost || 0;
+        }
+        const progressPercent = counts.total > 0
+            ? Math.round((counts.done / counts.total) * 100)
+            : 0;
+        return {
+            missionId,
+            status: this.deriveMissionStatus(counts),
+            phase: this.missionPhases.get(missionId) ?? 1,
+            totalTasks: counts.total,
+            completedTasks: counts.done,
+            runningTasks: counts.running,
+            queuedTasks: counts.queued,
+            blockedTasks: counts.blocked,
+            failedTasks: counts.failed,
+            progressPercent,
+            totalCost,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Pause a Mission — freeze all queued tasks (prevent claiming).
+     * Running tasks continue until completion.
+     *
+     * @param missionId - The Mission to pause
+     */
+    async pauseMission(missionId) {
+        const taskPool = TaskPoolService.getInstance();
+        const allItems = await taskPool.getAllItems();
+        const queuedItems = allItems.filter((wi) => wi.missionId === missionId && wi.status === 'queued');
+        let frozenCount = 0;
+        for (const wi of queuedItems) {
+            await taskPool.updateItemStatus(wi.id, 'scheduled');
+            frozenCount++;
+        }
+        this.logger.info('Mission paused', { missionId, frozenTasks: frozenCount });
+        return frozenCount;
+    }
+    /**
+     * Resume a paused Mission — unfreeze scheduled tasks back to queued.
+     *
+     * @param missionId - The Mission to resume
+     */
+    async resumeMission(missionId) {
+        const taskPool = TaskPoolService.getInstance();
+        const allItems = await taskPool.getAllItems();
+        const frozenItems = allItems.filter((wi) => wi.missionId === missionId && wi.status === 'scheduled');
+        let unfrozenCount = 0;
+        for (const wi of frozenItems) {
+            await taskPool.updateItemStatus(wi.id, 'queued');
+            unfrozenCount++;
+        }
+        this.logger.info('Mission resumed', { missionId, unfrozenTasks: unfrozenCount });
+        return unfrozenCount;
+    }
+    // ---------------------------------------------------------------------------
+    // Phase Advancement
+    // ---------------------------------------------------------------------------
+    /** Result of a phase completion check. */
+    static PHASE_RESULT = {
+        NOT_COMPLETE: 'not_complete',
+        ADVANCED: 'advanced',
+        GATE_PENDING: 'gate_pending',
+    };
+    /**
+     * Check if all WorkItems in the current phase are done/verified.
+     * If complete, advance to next phase based on phaseGateApproval policy.
+     *
+     * @param missionId - Mission to check
+     * @param phaseGateApproval - How phase transitions are approved
+     * @returns Phase advancement result
+     */
+    async checkPhaseCompletion(missionId, phaseGateApproval = 'none') {
+        const currentPhase = this.missionPhases.get(missionId) ?? 1;
+        const taskPool = TaskPoolService.getInstance();
+        const allItems = await taskPool.getAllItems();
+        const phaseItems = allItems.filter((wi) => wi.missionId === missionId &&
+            wi.metadata?.phase === currentPhase);
+        if (phaseItems.length === 0) {
+            return { result: MissionExecutorService.PHASE_RESULT.NOT_COMPLETE, phase: currentPhase };
+        }
+        const allTerminal = phaseItems.every((wi) => wi.status === 'done' || wi.status === 'verified' || wi.status === 'cancelled');
+        if (!allTerminal) {
+            return { result: MissionExecutorService.PHASE_RESULT.NOT_COMPLETE, phase: currentPhase };
+        }
+        // All items in current phase are done
+        if (phaseGateApproval === 'none') {
+            const nextPhase = currentPhase + 1;
+            this.missionPhases.set(missionId, nextPhase);
+            this.logger.info('Phase auto-advanced', { missionId, from: currentPhase, to: nextPhase });
+            return { result: MissionExecutorService.PHASE_RESULT.ADVANCED, phase: nextPhase };
+        }
+        // Needs approval — return gate_pending for caller to handle
+        this.logger.info('Phase complete, awaiting approval', { missionId, phase: currentPhase, gateType: phaseGateApproval });
+        return { result: MissionExecutorService.PHASE_RESULT.GATE_PENDING, phase: currentPhase };
+    }
+    /**
+     * Cancel remaining queued/blocked tasks in current phase for replanning.
+     *
+     * @param missionId - Mission to replan
+     * @returns Number of cancelled tasks
+     */
+    async cancelRemainingPhaseTasks(missionId) {
+        const currentPhase = this.missionPhases.get(missionId) ?? 1;
+        const taskPool = TaskPoolService.getInstance();
+        const allItems = await taskPool.getAllItems();
+        const cancelableItems = allItems.filter((wi) => wi.missionId === missionId &&
+            wi.metadata?.phase === currentPhase &&
+            (wi.status === 'queued' || wi.status === 'blocked' || wi.status === 'scheduled'));
+        let cancelled = 0;
+        for (const wi of cancelableItems) {
+            await taskPool.updateItemStatus(wi.id, 'cancelled');
+            cancelled++;
+        }
+        this.logger.info('Cancelled remaining phase tasks for replan', { missionId, phase: currentPhase, cancelled });
+        return cancelled;
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Derive a human-readable mission status from WorkItem counts.
+     */
+    deriveMissionStatus(counts) {
+        if (counts.total === 0)
+            return 'planning';
+        if (counts.done === counts.total)
+            return 'completed';
+        if (counts.running > 0)
+            return 'executing';
+        if (counts.blocked === counts.total - counts.done)
+            return 'blocked';
+        if (counts.queued > 0)
+            return 'ready';
+        return 'executing';
+    }
+}
+//# sourceMappingURL=mission-executor.service.js.map

package/dist/backend/backend/src/services/v3/mission-executor.service.js.map

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

package/dist/backend/backend/src/services/v3/mission-period.service.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Mission Period Lifecycle Service
+ *
+ * Manages automatic activation and deactivation of Missions based on
+ * their OKR period (weekly, monthly, quarterly, etc.).
+ *
+ * Responsibilities:
+ * - Activate missions whose period has started (paused → active)
+ * - Trigger end-of-period review for missions whose period has ended
+ * - Filter missions by current/future/past period
+ * - Sort missions by priority for scheduling
+ *
+ * Runs as part of the cron evaluation loop — called periodically
+ * to reconcile mission statuses with their time periods.
+ *
+ * @module services/v3/mission-period.service
+ */
+import type { Mission } from '../../types/v2/mission.types.js';
+/** Result of a period reconciliation cycle. */
+export interface PeriodReconcileResult {
+    /** Missions activated because their period started */
+    activated: string[];
+    /** Missions that reached end-of-period and need review */
+    endOfPeriod: string[];
+    /** Total missions evaluated */
+    evaluated: number;
+}
+/**
+ * Service for reconciling Mission lifecycle with OKR time periods.
+ */
+export declare class MissionPeriodService {
+    private static instance;
+    private readonly logger;
+    private constructor();
+    static getInstance(): MissionPeriodService;
+    static resetInstance(): void;
+    /**
+     * Reconcile all missions with time periods against the current date.
+     *
+     * - Paused missions whose period is now active → activate
+     * - Active missions whose period has ended → mark for end-of-period review
+     * - Terminal missions are skipped
+     *
+     * @param now - Reference date (defaults to current time)
+     * @returns Summary of actions taken
+     */
+    reconcile(now?: Date): Promise<PeriodReconcileResult>;
+    /**
+     * Get all active missions for the current period, sorted by priority.
+     *
+     * @param now - Reference date (defaults to current time)
+     * @returns Missions whose period contains 'now' and status is 'active', sorted by priority
+     */
+    getActivePeriodMissions(now?: Date): Promise<Mission[]>;
+    /**
+     * Get missions for a specific team, filtered by period status and sorted by priority.
+     *
+     * @param teamId - Team to filter by
+     * @param periodFilter - 'current', 'future', 'past', or 'all'
+     * @param now - Reference date
+     * @returns Filtered and sorted missions
+     */
+    getMissionsByTeamAndPeriod(teamId: string, periodFilter?: 'current' | 'future' | 'past' | 'all', now?: Date): Promise<Mission[]>;
+    /**
+     * Load all missions from disk.
+     */
+    private loadAllMissions;
+    /**
+     * Update a mission's status on disk.
+     */
+    private updateMissionStatus;
+}
+//# sourceMappingURL=mission-period.service.d.ts.map

package/dist/backend/backend/src/services/v3/mission-period.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-period.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/mission-period.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAgC,MAAM,iCAAiC,CAAC;AAqB7F,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;;;;OASG;IACG,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkD3D;;;;;OAKG;IACG,uBAAuB,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAY7D;;;;;;;OAOG;IACG,0BAA0B,CAC9B,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAa,EAC3D,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,OAAO,EAAE,CAAC;IAkCrB;;OAEG;YACW,eAAe;IAoB7B;;OAEG;YACW,mBAAmB;CAYlC"}

package/dist/backend/backend/src/services/v3/mission-period.service.js

@@ -0,0 +1,200 @@
+/**
+ * Mission Period Lifecycle Service
+ *
+ * Manages automatic activation and deactivation of Missions based on
+ * their OKR period (weekly, monthly, quarterly, etc.).
+ *
+ * Responsibilities:
+ * - Activate missions whose period has started (paused → active)
+ * - Trigger end-of-period review for missions whose period has ended
+ * - Filter missions by current/future/past period
+ * - Sort missions by priority for scheduling
+ *
+ * Runs as part of the cron evaluation loop — called periodically
+ * to reconcile mission statuses with their time periods.
+ *
+ * @module services/v3/mission-period.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { isPeriodActive, isPeriodPast, isPeriodFuture, sortMissionsByPriority, TERMINAL_MISSION_STATUSES, } from '../../types/v2/mission.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+function getMissionsDir() {
+    return path.join(process.cwd(), '.crewly', 'missions');
+}
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Service for reconciling Mission lifecycle with OKR time periods.
+ */
+export class MissionPeriodService {
+    static instance = null;
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('MissionPeriod');
+    }
+    static getInstance() {
+        if (!MissionPeriodService.instance) {
+            MissionPeriodService.instance = new MissionPeriodService();
+        }
+        return MissionPeriodService.instance;
+    }
+    static resetInstance() {
+        MissionPeriodService.instance = null;
+    }
+    // -------------------------------------------------------------------------
+    // Period Reconciliation
+    // -------------------------------------------------------------------------
+    /**
+     * Reconcile all missions with time periods against the current date.
+     *
+     * - Paused missions whose period is now active → activate
+     * - Active missions whose period has ended → mark for end-of-period review
+     * - Terminal missions are skipped
+     *
+     * @param now - Reference date (defaults to current time)
+     * @returns Summary of actions taken
+     */
+    async reconcile(now) {
+        const ref = now ?? new Date();
+        const missions = await this.loadAllMissions();
+        const result = {
+            activated: [],
+            endOfPeriod: [],
+            evaluated: 0,
+        };
+        for (const mission of missions) {
+            // Skip missions without a period — they use manual lifecycle
+            if (!mission.period)
+                continue;
+            // Skip terminal missions
+            if (TERMINAL_MISSION_STATUSES.has(mission.status))
+                continue;
+            result.evaluated++;
+            if (mission.status === 'paused' && isPeriodActive(mission.period, ref)) {
+                // Period has started — activate the mission
+                await this.updateMissionStatus(mission.id, 'active');
+                result.activated.push(mission.id);
+                this.logger.info('Mission auto-activated — period started', {
+                    missionId: mission.id,
+                    period: mission.period.label ?? mission.period.type,
+                });
+            }
+            else if (mission.status === 'active' && isPeriodPast(mission.period, ref)) {
+                // Period has ended — flag for end-of-period review
+                result.endOfPeriod.push(mission.id);
+                this.logger.info('Mission period ended — triggering review', {
+                    missionId: mission.id,
+                    period: mission.period.label ?? mission.period.type,
+                });
+            }
+        }
+        if (result.activated.length > 0 || result.endOfPeriod.length > 0) {
+            this.logger.info('Period reconciliation complete', {
+                evaluated: result.evaluated,
+                activated: result.activated.length,
+                endOfPeriod: result.endOfPeriod.length,
+            });
+        }
+        return result;
+    }
+    // -------------------------------------------------------------------------
+    // Query Helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Get all active missions for the current period, sorted by priority.
+     *
+     * @param now - Reference date (defaults to current time)
+     * @returns Missions whose period contains 'now' and status is 'active', sorted by priority
+     */
+    async getActivePeriodMissions(now) {
+        const ref = now ?? new Date();
+        const missions = await this.loadAllMissions();
+        const active = missions.filter((m) => {
+            if (m.status !== 'active')
+                return false;
+            // Missions without a period are always considered "in period"
+            if (!m.period)
+                return true;
+            return isPeriodActive(m.period, ref);
+        });
+        return sortMissionsByPriority(active);
+    }
+    /**
+     * Get missions for a specific team, filtered by period status and sorted by priority.
+     *
+     * @param teamId - Team to filter by
+     * @param periodFilter - 'current', 'future', 'past', or 'all'
+     * @param now - Reference date
+     * @returns Filtered and sorted missions
+     */
+    async getMissionsByTeamAndPeriod(teamId, periodFilter = 'all', now) {
+        const ref = now ?? new Date();
+        const missions = await this.loadAllMissions();
+        const teamMissions = missions.filter((m) => m.ownerTeamId === teamId);
+        let filtered;
+        switch (periodFilter) {
+            case 'current':
+                filtered = teamMissions.filter((m) => !m.period || isPeriodActive(m.period, ref));
+                break;
+            case 'future':
+                filtered = teamMissions.filter((m) => m.period && isPeriodFuture(m.period, ref));
+                break;
+            case 'past':
+                filtered = teamMissions.filter((m) => m.period && isPeriodPast(m.period, ref));
+                break;
+            default:
+                filtered = teamMissions;
+        }
+        return sortMissionsByPriority(filtered);
+    }
+    // -------------------------------------------------------------------------
+    // Storage Helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Load all missions from disk.
+     */
+    async loadAllMissions() {
+        const dir = getMissionsDir();
+        try {
+            const files = await fs.readdir(dir);
+            const missions = [];
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const raw = await fs.readFile(path.join(dir, file), 'utf-8');
+                    missions.push(JSON.parse(raw));
+                }
+                catch {
+                    // Skip corrupt files
+                }
+            }
+            return missions;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Update a mission's status on disk.
+     */
+    async updateMissionStatus(missionId, status) {
+        const filePath = path.join(getMissionsDir(), `${missionId}.json`);
+        try {
+            const raw = await fs.readFile(filePath, 'utf-8');
+            const mission = JSON.parse(raw);
+            mission.status = status;
+            mission.updatedAt = new Date().toISOString();
+            await fs.writeFile(filePath, JSON.stringify(mission, null, 2));
+        }
+        catch {
+            this.logger.error('Failed to update mission status', { missionId, status });
+        }
+    }
+}
+//# sourceMappingURL=mission-period.service.js.map

package/dist/backend/backend/src/services/v3/mission-period.service.js.map

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

package/dist/backend/backend/src/services/v3/okr-review.service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OKR Review Service
+ *
+ * Implements the feedback loop for Mission OKR execution:
+ * 1. Aggregate KR + task progress
+ * 2. Derive recommendation (pure math)
+ * 3. Trigger next action (continue / review skill / replan / escalate)
+ *
+ * Does NOT contain LLM logic — triggers the review-mission skill
+ * when agent reasoning is needed.
+ *
+ * @module services/v3/okr-review.service
+ */
+import type { OKRReviewResult, ReviewDecision } from '../../types/v2/key-result.types.js';
+/**
+ * Service for executing periodic OKR reviews and processing review decisions.
+ */
+export declare class OKRReviewService {
+    private static instance;
+    private readonly logger;
+    private constructor();
+    static getInstance(): OKRReviewService;
+    static resetInstance(): void;
+    /**
+     * Execute a scheduled OKR review for a mission.
+     *
+     * 1. Load mission
+     * 2. Aggregate KR progress
+     * 3. Aggregate task progress
+     * 4. Derive recommendation
+     * 5. Determine action based on recommendation + policy
+     * 6. Persist review summary on mission
+     *
+     * @param missionId - Mission to review
+     * @returns Review result with recommendation and action
+     */
+    executeReview(missionId: string): Promise<OKRReviewResult>;
+    /**
+     * Process a review decision from the review-mission skill.
+     *
+     * @param missionId - Mission ID
+     * @param decision - The agent's review decision
+     */
+    processReviewDecision(missionId: string, decision: ReviewDecision): Promise<void>;
+    /**
+     * Load a mission from disk.
+     */
+    private loadMission;
+    /**
+     * Update mission fields on disk (partial merge).
+     */
+    private updateMissionReview;
+    /**
+     * Extract previous overall progress from review summary string.
+     */
+    private extractPreviousProgress;
+}
+//# sourceMappingURL=okr-review.service.d.ts.map

package/dist/backend/backend/src/services/v3/okr-review.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okr-review.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/okr-review.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEf,MAAM,oCAAoC,CAAC;AAgB5C;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAyEhE;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEvF;;OAEG;YACW,WAAW;IAUzB;;OAEG;YACW,mBAAmB;IAYjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAKhC"}