bobs-workshop 0.1.4

package/dist/tools/workRecorder.js

@@ -0,0 +1,215 @@
+// src/tools/workRecorder.ts
+import { specUpdateHandler } from "./specTools.js";
+/**
+ * Record detailed work activity with auto-interval logging
+ */
+export class WorkRecorder {
+    constructor(context) {
+        this.activities = [];
+        this.context = context;
+        this.lastActivity = new Date();
+    }
+    /**
+     * Start automatic work recording (no periodic updates - rely on explicit logging)
+     */
+    startRecording() {
+        this.lastActivity = new Date();
+        // Auto-stop after 30 minutes of inactivity (no periodic logging noise)
+        this.intervalId = setInterval(async () => {
+            const now = new Date();
+            const minutesSinceLastActivity = (now.getTime() - this.lastActivity.getTime()) / (1000 * 60);
+            // Auto-stop recording after 30 minutes of inactivity
+            if (minutesSinceLastActivity >= 30) {
+                console.log(`[WorkRecorder] Auto-stopping recording for ${this.context.spec_id} after 30 minutes of inactivity`);
+                this.stopRecording();
+                return;
+            }
+        }, 5 * 60 * 1000); // Check every 5 minutes
+        // Initial recording
+        this.recordActivity("started_work_session", "WORK_SESSION_START", [], `Started ${this.context.phase} phase work session as ${this.context.role}`);
+    }
+    /**
+     * Stop automatic recording
+     */
+    stopRecording() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+        this.recordActivity("ended_work_session", "WORK_SESSION_END", [], `Ended ${this.context.phase} phase work session. Total activities: ${this.activities.length}`);
+    }
+    /**
+     * Record a specific work activity
+     */
+    async recordActivity(action, task_id, files_changed, note, commit_hash = "pending") {
+        this.lastActivity = new Date();
+        const activity = {
+            timestamp: new Date().toISOString(),
+            engineer: this.context.role,
+            action: `${this.context.phase}: ${action}`,
+            task_id,
+            files_changed,
+            commit_hash,
+            note: `[${this.context.phase}] ${note}`
+        };
+        this.activities.push(activity);
+        // Log to spec
+        await specUpdateHandler({
+            spec_id: this.context.spec_id,
+            execution_log: activity
+        });
+    }
+    /**
+     * Record progress on a specific task
+     */
+    async recordProgress(task_id, progress_description, files_involved = [], completion_percentage) {
+        const progressNote = completion_percentage
+            ? `${progress_description} (${completion_percentage}% complete)`
+            : progress_description;
+        await this.recordActivity("task_progress", task_id, files_involved, `📈 Progress: ${progressNote}. Files involved: ${files_involved.join(', ') || 'none'}`);
+    }
+    /**
+     * Record decision made during work
+     */
+    async recordDecision(task_id, decision, reasoning, files_affected = []) {
+        await this.recordActivity("decision_made", task_id, files_affected, `🧠 Decision: ${decision}. Reasoning: ${reasoning}. Files affected: ${files_affected.join(', ') || 'none'}`);
+    }
+    /**
+     * Record milestone completion
+     */
+    async recordMilestone(task_id, milestone, deliverables, next_steps = []) {
+        const nextStepsText = next_steps.length > 0 ? ` Next: ${next_steps.join(', ')}` : "";
+        await this.recordActivity("milestone_completed", task_id, deliverables, `🎯 Milestone: ${milestone}. Deliverables: ${deliverables.join(', ')}.${nextStepsText}`);
+        // Check if this is a completion milestone
+        if (milestone.toLowerCase().includes('complete') || milestone.toLowerCase().includes('finished')) {
+            await this.recordActivity("implementation_completed", task_id, deliverables, `✅ Implementation completed: ${milestone}. Work session ending.`);
+            // Auto-stop recording for completed implementations
+            console.log(`[WorkRecorder] Auto-stopping recording for ${this.context.spec_id} - implementation completed`);
+            this.stopRecording();
+        }
+    }
+    /**
+     * Get recording statistics
+     */
+    getStats() {
+        const uniqueFiles = [...new Set(this.activities.flatMap(a => a.files_changed))];
+        const uniqueTasks = [...new Set(this.activities.map(a => a.task_id))];
+        const sessionStart = this.activities[0]?.timestamp ? new Date(this.activities[0].timestamp) : new Date();
+        const sessionDuration = (new Date().getTime() - sessionStart.getTime()) / (1000 * 60); // minutes
+        return {
+            totalActivities: this.activities.length,
+            sessionDuration: Math.floor(sessionDuration),
+            filesModified: uniqueFiles,
+            tasksWorkedOn: uniqueTasks
+        };
+    }
+    /**
+     * Update activity context (e.g., when phase changes)
+     */
+    updateContext(newContext) {
+        this.context = { ...this.context, ...newContext };
+    }
+}
+/**
+ * Global work recorder instances by spec_id
+ */
+const activeRecorders = new Map();
+/**
+ * Start work recording for a spec
+ */
+export function startWorkRecording(context) {
+    const existing = activeRecorders.get(context.spec_id);
+    if (existing) {
+        existing.stopRecording();
+    }
+    const recorder = new WorkRecorder(context);
+    recorder.startRecording();
+    activeRecorders.set(context.spec_id, recorder);
+    return recorder;
+}
+/**
+ * Stop work recording for a spec
+ */
+export function stopWorkRecording(spec_id) {
+    const recorder = activeRecorders.get(spec_id);
+    if (recorder) {
+        recorder.stopRecording();
+        activeRecorders.delete(spec_id);
+    }
+}
+/**
+ * Get active recorder for a spec
+ */
+export function getWorkRecorder(spec_id) {
+    return activeRecorders.get(spec_id);
+}
+/**
+ * Record quick activity for a spec (creates recorder if needed)
+ */
+export async function recordQuickActivity(spec_id, action, task_id, files_changed, note, context) {
+    let recorder = activeRecorders.get(spec_id);
+    if (!recorder && context) {
+        const fullContext = {
+            spec_id,
+            phase: "implementation",
+            role: "engineer",
+            ...context
+        };
+        recorder = startWorkRecording(fullContext);
+    }
+    if (recorder) {
+        await recorder.recordActivity(action, task_id, files_changed, note);
+    }
+}
+/**
+ * Cleanup orphaned work recorders (for completed SPECs)
+ */
+export async function cleanupOrphanedRecorders() {
+    const stoppedSpecs = [];
+    for (const [spec_id, recorder] of activeRecorders.entries()) {
+        try {
+            // Check if SPEC is completed by reading its file
+            const fs = await import('fs-extra');
+            const path = await import('path');
+            const specsDir = path.resolve(process.cwd(), ".bob/specs");
+            const filePath = path.join(specsDir, `${spec_id}.json`);
+            if (await fs.pathExists(filePath)) {
+                const specData = await fs.readJson(filePath);
+                // Stop recording for completed SPECs
+                if (specData.state === "completed") {
+                    console.log(`[WorkRecorder] Stopping orphaned recorder for completed SPEC: ${spec_id}`);
+                    recorder.stopRecording();
+                    activeRecorders.delete(spec_id);
+                    stoppedSpecs.push(spec_id);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`[WorkRecorder] Error checking SPEC ${spec_id}:`, error);
+        }
+    }
+    return {
+        stopped: stoppedSpecs,
+        active: activeRecorders.size
+    };
+}
+/**
+ * Get statistics about active recorders
+ */
+export function getActiveRecorderStats() {
+    const stats = {
+        total: activeRecorders.size,
+        specs: Array.from(activeRecorders.keys()),
+        oldestSession: null
+    };
+    let oldestTime = Infinity;
+    for (const [spec_id, recorder] of activeRecorders.entries()) {
+        const recorderStats = recorder.getStats();
+        if (recorderStats.sessionDuration < oldestTime) {
+            oldestTime = recorderStats.sessionDuration;
+            stats.oldestSession = { spec_id, duration: recorderStats.sessionDuration };
+        }
+    }
+    return stats;
+}
+//# sourceMappingURL=workRecorder.js.map

package/dist/tools/workRecorder.js.map

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