crewly 1.5.17 → 1.5.19

package/dist/backend/backend/src/services/v3/kr-tracking.service.js

@@ -0,0 +1,314 @@
+/**
+ * Key Result Tracking Service
+ *
+ * CRUD, measurement recording, progress aggregation, and WorkItem linkage
+ * for structured Key Results attached to Missions.
+ *
+ * Does NOT contain LLM logic — all status derivation is pure math.
+ * Agent reasoning happens in skills (review-mission, measure-kr).
+ *
+ * @module services/v3/kr-tracking.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { existsSync, mkdirSync } from 'fs';
+import { LoggerService } from '../core/logger.service.js';
+import { createKeyResult, computeKRProgress, deriveKRStatus, deriveOKRRecommendation, MAX_MEASUREMENT_HISTORY, validateCreateKeyResultInput, } from '../../types/v2/key-result.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Base directory for mission data. */
+function getMissionsDir() {
+    return path.join(process.cwd(), '.crewly', 'missions');
+}
+/** Directory for a mission's key results. */
+function getKRDir(missionId) {
+    return path.join(getMissionsDir(), missionId, 'key-results');
+}
+/** File path for a single key result. */
+function getKRPath(missionId, krId) {
+    return path.join(getKRDir(missionId), `${krId}.json`);
+}
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Service for managing Key Result lifecycle, measurements, and aggregation.
+ */
+export class KRTrackingService {
+    static instance = null;
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('KRTracking');
+    }
+    /**
+     * Get the singleton instance.
+     */
+    static getInstance() {
+        if (!KRTrackingService.instance) {
+            KRTrackingService.instance = new KRTrackingService();
+        }
+        return KRTrackingService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        KRTrackingService.instance = null;
+    }
+    // -------------------------------------------------------------------------
+    // CRUD
+    // -------------------------------------------------------------------------
+    /**
+     * Create a new Key Result for a mission.
+     *
+     * @param input - Validated creation input
+     * @returns The created KeyResult
+     */
+    async create(input) {
+        const errors = validateCreateKeyResultInput(input);
+        if (errors.length > 0) {
+            throw new Error(`Invalid KeyResult input: ${errors.join(', ')}`);
+        }
+        const kr = createKeyResult(input);
+        await this.persist(kr);
+        this.logger.info('Created KeyResult', { krId: kr.id, missionId: kr.missionId, title: kr.title });
+        return kr;
+    }
+    /**
+     * Get a Key Result by ID.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @returns The KeyResult, or null if not found
+     */
+    async get(missionId, krId) {
+        try {
+            const raw = await fs.readFile(getKRPath(missionId, krId), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * List all Key Results for a mission.
+     *
+     * @param missionId - Mission ID
+     * @returns Array of KeyResults
+     */
+    async listByMission(missionId) {
+        const dir = getKRDir(missionId);
+        try {
+            const files = (await fs.readdir(dir)).filter(f => f.endsWith('.json'));
+            const results = await Promise.all(files.map(async (f) => {
+                try {
+                    const raw = await fs.readFile(path.join(dir, f), 'utf-8');
+                    return JSON.parse(raw);
+                }
+                catch {
+                    return null;
+                }
+            }));
+            return results.filter((kr) => kr !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Update a Key Result.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @param update - Fields to update
+     * @returns Updated KeyResult, or null if not found
+     */
+    async update(missionId, krId, update) {
+        const kr = await this.get(missionId, krId);
+        if (!kr)
+            return null;
+        if (update.current !== undefined)
+            kr.current = update.current;
+        if (update.target !== undefined)
+            kr.target = update.target;
+        if (update.status !== undefined)
+            kr.status = update.status;
+        if (update.measurementSource !== undefined)
+            kr.measurementSource = update.measurementSource;
+        if (update.measurementConfig !== undefined)
+            kr.measurementConfig = update.measurementConfig;
+        // Recompute status if current changed but status wasn't explicitly set
+        if (update.current !== undefined && update.status === undefined) {
+            const progress = computeKRProgress(kr);
+            kr.status = deriveKRStatus(progress, kr.current, kr.baseline);
+        }
+        kr.updatedAt = new Date().toISOString();
+        await this.persist(kr);
+        return kr;
+    }
+    /**
+     * Delete a Key Result.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     */
+    async delete(missionId, krId) {
+        try {
+            await fs.unlink(getKRPath(missionId, krId));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Measurement
+    // -------------------------------------------------------------------------
+    /**
+     * Record a new measurement for a Key Result.
+     * Automatically updates current value, recomputes status,
+     * and appends to measurement history.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @param value - Measured value
+     * @param source - Who/what took the measurement
+     * @param note - Optional context
+     * @returns The recorded measurement, or null if KR not found
+     */
+    async recordMeasurement(missionId, krId, value, source, note) {
+        const kr = await this.get(missionId, krId);
+        if (!kr)
+            return null;
+        const measurement = {
+            value,
+            measuredAt: new Date().toISOString(),
+            source,
+            note,
+        };
+        // Update current value and recompute status
+        kr.current = value;
+        const progress = computeKRProgress(kr);
+        kr.status = deriveKRStatus(progress, kr.current, kr.baseline);
+        // Prepend to history, cap at MAX_MEASUREMENT_HISTORY
+        kr.measurements.unshift(measurement);
+        if (kr.measurements.length > MAX_MEASUREMENT_HISTORY) {
+            kr.measurements = kr.measurements.slice(0, MAX_MEASUREMENT_HISTORY);
+        }
+        kr.updatedAt = new Date().toISOString();
+        await this.persist(kr);
+        this.logger.info('Recorded KR measurement', {
+            krId,
+            value,
+            status: kr.status,
+            progress: Math.round(progress),
+        });
+        return measurement;
+    }
+    // -------------------------------------------------------------------------
+    // WorkItem Linkage
+    // -------------------------------------------------------------------------
+    /**
+     * Link a WorkItem to a Key Result.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @param workItemId - WorkItem ID to link
+     */
+    async linkWorkItem(missionId, krId, workItemId) {
+        const kr = await this.get(missionId, krId);
+        if (!kr)
+            return;
+        if (!kr.linkedWorkItemIds.includes(workItemId)) {
+            kr.linkedWorkItemIds.push(workItemId);
+            kr.updatedAt = new Date().toISOString();
+            await this.persist(kr);
+        }
+    }
+    /**
+     * Handle WorkItem completion — auto-update KRs with task_completion source.
+     *
+     * For KRs measured by task completion, progress = completed linked items / total linked items.
+     *
+     * @param workItem - The completed WorkItem
+     */
+    async onWorkItemCompleted(workItem) {
+        const missionId = workItem.missionId;
+        const krId = workItem.metadata?.krId;
+        if (!missionId || !krId)
+            return;
+        const kr = await this.get(missionId, krId);
+        if (!kr || kr.measurementSource !== 'task_completion')
+            return;
+        // Count completed linked items using TaskPoolService
+        const { TaskPoolService } = await import('../task-pool/task-pool.service.js');
+        const pool = TaskPoolService.getInstance();
+        const allItems = await pool.getAllItems();
+        const linkedItems = allItems.filter(item => kr.linkedWorkItemIds.includes(item.id));
+        const completedCount = linkedItems.filter(item => item.status === 'done' || item.status === 'verified').length;
+        const totalLinked = kr.linkedWorkItemIds.length;
+        if (totalLinked === 0)
+            return;
+        // Map completion ratio to the KR's baseline→target range
+        const completionRatio = completedCount / totalLinked;
+        const range = kr.target - kr.baseline;
+        const newValue = kr.baseline + (range * completionRatio);
+        await this.recordMeasurement(missionId, krId, Math.round(newValue * 100) / 100, `task_completion:${workItem.id}`, `${completedCount}/${totalLinked} linked tasks completed`);
+    }
+    // -------------------------------------------------------------------------
+    // Aggregation
+    // -------------------------------------------------------------------------
+    /**
+     * Compute aggregated OKR progress for a mission.
+     *
+     * @param missionId - Mission ID
+     * @param staleCycles - Number of consecutive stale review cycles
+     * @returns Aggregated summary with recommendation
+     */
+    async computeMissionOKRProgress(missionId, staleCycles = 0) {
+        const krs = await this.listByMission(missionId);
+        const statuses = krs.map(kr => kr.status);
+        const counts = {
+            not_started: 0,
+            on_track: 0,
+            at_risk: 0,
+            off_track: 0,
+            achieved: 0,
+        };
+        for (const s of statuses)
+            counts[s]++;
+        // Weighted average progress
+        let overallProgress = 0;
+        if (krs.length > 0) {
+            const totalProgress = krs.reduce((sum, kr) => sum + computeKRProgress(kr), 0);
+            overallProgress = Math.round(totalProgress / krs.length);
+        }
+        const recommendation = deriveOKRRecommendation(statuses, staleCycles);
+        return {
+            missionId,
+            totalKRs: krs.length,
+            achieved: counts.achieved,
+            onTrack: counts.on_track,
+            atRisk: counts.at_risk,
+            offTrack: counts.off_track,
+            notStarted: counts.not_started,
+            overallProgress,
+            recommendation,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Persistence
+    // -------------------------------------------------------------------------
+    /**
+     * Persist a KeyResult to disk.
+     */
+    async persist(kr) {
+        const dir = getKRDir(kr.missionId);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        await fs.writeFile(getKRPath(kr.missionId, kr.id), JSON.stringify(kr, null, 2));
+    }
+}
+//# sourceMappingURL=kr-tracking.service.js.map

package/dist/backend/backend/src/services/v3/kr-tracking.service.js.map

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

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

@@ -0,0 +1,117 @@
+/**
+ * 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 { type Mission } from '../../types/v2/mission.types.js';
+/** A single task from the decomposition skill output. */
+export interface DecomposedTask {
+    title: string;
+    description: string;
+    type: 'delegate' | 'review' | 'check';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    suggestedRole?: string;
+    estimatedMinutes?: number;
+    dependsOn?: string[];
+    /** Key Result this task contributes to (OKR linkage) */
+    krId?: string;
+    /** How this task contributes to the KR */
+    krContribution?: 'direct' | 'indirect' | 'measurement';
+}
+/** Decomposition result submitted by the decompose-mission skill. */
+export interface DecompositionResult {
+    missionId: string;
+    phase: number;
+    tasks: DecomposedTask[];
+}
+/** Progress snapshot for a Mission. */
+export interface MissionProgress {
+    missionId: string;
+    status: string;
+    phase: number;
+    totalTasks: number;
+    completedTasks: number;
+    runningTasks: number;
+    queuedTasks: number;
+    blockedTasks: number;
+    failedTasks: number;
+    progressPercent: number;
+    totalCost: number;
+}
+export declare class MissionExecutorService {
+    private static instance;
+    private readonly logger;
+    /** Track which phase each mission is on */
+    private missionPhases;
+    private constructor();
+    static getInstance(): MissionExecutorService;
+    static resetInstance(): void;
+    /**
+     * 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
+     */
+    processDecomposition(result: DecompositionResult, mission: Mission): Promise<string[]>;
+    /**
+     * Compute Mission progress from WorkItem statuses.
+     *
+     * @param missionId - The Mission to check
+     * @returns Progress snapshot
+     */
+    checkProgress(missionId: string): Promise<MissionProgress>;
+    /**
+     * Pause a Mission — freeze all queued tasks (prevent claiming).
+     * Running tasks continue until completion.
+     *
+     * @param missionId - The Mission to pause
+     */
+    pauseMission(missionId: string): Promise<number>;
+    /**
+     * Resume a paused Mission — unfreeze scheduled tasks back to queued.
+     *
+     * @param missionId - The Mission to resume
+     */
+    resumeMission(missionId: string): Promise<number>;
+    /** Result of a phase completion check. */
+    static readonly PHASE_RESULT: {
+        readonly NOT_COMPLETE: "not_complete";
+        readonly ADVANCED: "advanced";
+        readonly 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
+     */
+    checkPhaseCompletion(missionId: string, phaseGateApproval?: 'none' | 'team_lead' | 'human'): Promise<{
+        result: string;
+        phase: number;
+    }>;
+    /**
+     * Cancel remaining queued/blocked tasks in current phase for replanning.
+     *
+     * @param missionId - Mission to replan
+     * @returns Number of cancelled tasks
+     */
+    cancelRemainingPhaseTasks(missionId: string): Promise<number>;
+    /**
+     * Derive a human-readable mission status from WorkItem counts.
+     */
+    private deriveMissionStatus;
+}
+//# sourceMappingURL=mission-executor.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mission-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/mission-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EACL,KAAK,OAAO,EAEb,MAAM,iCAAiC,CAAC;AAMzC,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;CACxD;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,2CAA2C;IAC3C,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO;WAIO,WAAW,IAAI,sBAAsB;WAOrC,aAAa,IAAI,IAAI;IAQnC;;;;;;;OAOG;IACG,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgG5F;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgDhE;;;;;OAKG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBtD;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBvD,0CAA0C;IAC1C,gBAAuB,YAAY;;;;MAIxB;IAEX;;;;;;;OAOG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,iBAAiB,GAAE,MAAM,GAAG,WAAW,GAAG,OAAgB,GACzD,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAmC7C;;;;;OAKG;IACG,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BnE;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAQ5B"}