pi-harness-runtime 1.1.95 → 1.1.97

package/packages/trajectory/dist/src/review-fork.js

@@ -0,0 +1,332 @@
+/**
+ * Background Review Fork
+ *
+ * Background review that analyzes trajectories and suggests:
+ * - Memory entries to persist
+ * - Skills to create/update
+ * - User preferences to learn
+ *
+ * Based on Hermes Agent's closed learning loop.
+ */
+/**
+ * Default background review configuration
+ */
+export const DEFAULT_REVIEW_CONFIG = {
+    enabled: true,
+    nudgeInterval: 5,
+    reasoningEffort: "medium",
+    routeToCheaperModel: true,
+    writeApproval: false,
+    deferWhenGpuBusy: true,
+    deferMaxAgeSeconds: 1800,
+};
+/**
+ * Background Review Fork
+ */
+export class BackgroundReviewFork {
+    config;
+    cycleCount = 0;
+    queuedReview = null;
+    handlers = new Set();
+    pendingSuggestions = [];
+    constructor(config) {
+        this.config = { ...DEFAULT_REVIEW_CONFIG, ...config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Register event handler
+     */
+    on(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    /**
+     * Emit event to all handlers
+     */
+    emit(event) {
+        for (const handler of this.handlers) {
+            try {
+                handler(event);
+            }
+            catch (err) {
+                console.error("[BackgroundReviewFork] Handler error:", err);
+            }
+        }
+    }
+    /**
+     * Process cycle end - check if review should run
+     */
+    onCycleEnd(trajectory) {
+        if (!this.config.enabled)
+            return;
+        this.cycleCount++;
+        // Check if we should run review now
+        if (this.cycleCount >= this.config.nudgeInterval) {
+            this.cycleCount = 0;
+            this.runReview(trajectory);
+        }
+        else {
+            // Queue for later
+            this.queuedReview = trajectory;
+        }
+    }
+    /**
+     * Run review on trajectory
+     */
+    async runReview(trajectory) {
+        this.emit({ type: "review.started", trajectoryId: trajectory.id });
+        try {
+            const result = await this.analyzeTrajectory(trajectory);
+            // Emit completion
+            this.emit({ type: "review.completed", result });
+            // Create suggestions
+            for (const suggestion of result.suggestions) {
+                this.emit({ type: "suggestion.created", suggestion });
+                this.pendingSuggestions.push(suggestion);
+            }
+            // Clear queued review
+            this.queuedReview = null;
+            return result;
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            this.emit({ type: "review.error", error: errorMsg, trajectoryId: trajectory.id });
+            throw err;
+        }
+    }
+    /**
+     * Analyze trajectory and generate suggestions
+     */
+    async analyzeTrajectory(trajectory) {
+        const suggestions = [];
+        const patterns = [];
+        const corrections = [];
+        // Analyze verdict
+        if (trajectory.verdict === "blocked") {
+            // Blocked cycles might need memory about blockers
+            suggestions.push({
+                id: `mem_blocked_${Date.now()}`,
+                type: "memory",
+                priority: "high",
+                content: `Blocked cycle: ${trajectory.taskRequest}. Reason: ${trajectory.reason}`,
+                reason: "Remember what caused blocks to avoid them",
+                trajectoryId: trajectory.id,
+            });
+        }
+        // Analyze iterations
+        if (trajectory.iterations > 5) {
+            // High iteration count might indicate pattern to optimize
+            suggestions.push({
+                id: `pat_high_iter_${Date.now()}`,
+                type: "pattern",
+                priority: "medium",
+                content: `High iteration pattern: ${trajectory.taskRequest.slice(0, 100)}...`,
+                reason: "Investigate why this task took many iterations",
+                trajectoryId: trajectory.id,
+            });
+        }
+        // Analyze files
+        if (trajectory.files.length > 0) {
+            // Check for repeated files across iterations
+            const fileCount = {};
+            for (const file of trajectory.files) {
+                fileCount[file] = (fileCount[file] || 0) + 1;
+            }
+            // Files with high counts might need conventions
+            for (const [file, count] of Object.entries(fileCount)) {
+                if (count > 3) {
+                    suggestions.push({
+                        id: `conv_${Date.now()}`,
+                        type: "memory",
+                        priority: "low",
+                        content: `Conventions for ${file}: Review patterns established in recent cycles`,
+                        reason: `File ${file} appears frequently (${count}x)`,
+                        trajectoryId: trajectory.id,
+                    });
+                }
+            }
+        }
+        // Analyze comments for patterns
+        for (const comment of trajectory.comments) {
+            // Detect corrections (repeated comments)
+            const commentText = comment.comment.toLowerCase();
+            if (commentText.includes("same") || commentText.includes("again") || commentText.includes("repeated")) {
+                corrections.push(comment.comment);
+            }
+            // Detect severity patterns
+            if (comment.severity === "major" || comment.severity === "critical") {
+                patterns.push(`high-severity: ${comment.comment.slice(0, 100)}`);
+            }
+        }
+        // Generate skill suggestion for complex tasks
+        if (trajectory.iterations >= 3 && trajectory.verdict === "approved") {
+            suggestions.push({
+                id: `skill_${Date.now()}`,
+                type: "skill_create",
+                priority: "medium",
+                content: this.generateSkillFromTrajectory(trajectory),
+                reason: "Complex task that succeeded - capture the pattern",
+                trajectoryId: trajectory.id,
+            });
+        }
+        // Analyze for user preferences
+        if (trajectory.summary) {
+            const userPrefs = this.extractUserPreferences(trajectory.summary);
+            for (const pref of userPrefs) {
+                suggestions.push({
+                    id: `user_${Date.now()}`,
+                    type: "user_profile",
+                    priority: "low",
+                    content: pref,
+                    reason: "Detected from cycle summary",
+                    trajectoryId: trajectory.id,
+                });
+            }
+        }
+        return {
+            trajectoryId: trajectory.id,
+            suggestions,
+            patterns,
+            corrections,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Generate skill content from trajectory
+     */
+    generateSkillFromTrajectory(trajectory) {
+        const lines = [];
+        // Extract task type from request
+        const taskType = this.extractTaskType(trajectory.taskRequest);
+        lines.push(`---\n`);
+        lines.push(`name: ${taskType}-pattern\n`);
+        lines.push(`description: ${trajectory.taskRequest.slice(0, 200)}\n`);
+        lines.push(`author: curator\n`);
+        lines.push(`confidence: 0.7\n`);
+        lines.push(`triggers:\n`);
+        lines.push(`  - "${taskType}"\n`);
+        lines.push(`  - "${trajectory.taskRequest.slice(0, 50)}"\n`);
+        lines.push(`---\n\n`);
+        lines.push(`# ${taskType} Pattern\n\n`);
+        lines.push(`## When to Use\n`);
+        lines.push(`Task: ${trajectory.taskRequest}\n\n`);
+        lines.push(`## Procedure\n`);
+        lines.push(`1. ${trajectory.plan.split("\n")[0] || "Plan based on task analysis"}\n\n`);
+        lines.push(`## Key Files\n`);
+        for (const file of trajectory.files.slice(0, 5)) {
+            lines.push(`- ${file}\n`);
+        }
+        lines.push(`\n`);
+        lines.push(`## Notes\n`);
+        lines.push(`Iterations: ${trajectory.iterations}\n`);
+        lines.push(`Duration: ${Math.round(trajectory.durationMs / 1000 / 60)} minutes\n\n`);
+        if (trajectory.comments.length > 0) {
+            lines.push(`## Common Issues\n`);
+            for (const comment of trajectory.comments.slice(0, 3)) {
+                lines.push(`- ${comment.comment}\n`);
+            }
+        }
+        return lines.join("");
+    }
+    /**
+     * Extract task type from request
+     */
+    extractTaskType(request) {
+        const lower = request.toLowerCase();
+        if (lower.includes("test"))
+            return "testing";
+        if (lower.includes("fix") || lower.includes("bug"))
+            return "bugfix";
+        if (lower.includes("refactor"))
+            return "refactoring";
+        if (lower.includes("api"))
+            return "api-development";
+        if (lower.includes("config") || lower.includes("setup"))
+            return "configuration";
+        if (lower.includes("deploy"))
+            return "deployment";
+        return "general-task";
+    }
+    /**
+     * Extract user preferences from summary
+     */
+    extractUserPreferences(summary) {
+        const prefs = [];
+        const lower = summary.toLowerCase();
+        // Detection patterns
+        if (lower.includes("prefer") || lower.includes("like") || lower.includes("want")) {
+            prefs.push(`Prefers concise responses where possible`);
+        }
+        if (lower.includes("style") || lower.includes("format")) {
+            prefs.push(`Has specific code style preferences`);
+        }
+        if (lower.includes("error") || lower.includes("fix")) {
+            prefs.push(`Focuses on fixing issues thoroughly`);
+        }
+        return prefs;
+    }
+    /**
+     * Get pending suggestions
+     */
+    getPendingSuggestions() {
+        return [...this.pendingSuggestions];
+    }
+    /**
+     * Approve suggestion
+     */
+    approveSuggestion(suggestionId) {
+        const index = this.pendingSuggestions.findIndex((s) => s.id === suggestionId);
+        if (index < 0)
+            return null;
+        const suggestion = this.pendingSuggestions[index];
+        this.pendingSuggestions.splice(index, 1);
+        this.emit({ type: "suggestion.approved", suggestion });
+        return suggestion;
+    }
+    /**
+     * Reject suggestion
+     */
+    rejectSuggestion(suggestionId) {
+        const index = this.pendingSuggestions.findIndex((s) => s.id === suggestionId);
+        if (index < 0)
+            return null;
+        const suggestion = this.pendingSuggestions[index];
+        this.pendingSuggestions.splice(index, 1);
+        this.emit({ type: "suggestion.rejected", suggestion });
+        return suggestion;
+    }
+    /**
+     * Clear all pending suggestions
+     */
+    clearSuggestions() {
+        this.pendingSuggestions = [];
+    }
+    /**
+     * Get review stats
+     */
+    getStats() {
+        return {
+            cycleCount: this.cycleCount,
+            pendingCount: this.pendingSuggestions.length,
+            enabled: this.config.enabled,
+            nudgeInterval: this.config.nudgeInterval,
+        };
+    }
+}
+// Global instance
+let globalReviewFork = null;
+export function getGlobalReviewFork() {
+    if (!globalReviewFork) {
+        globalReviewFork = new BackgroundReviewFork();
+    }
+    return globalReviewFork;
+}
+export function createReviewFork(config) {
+    return new BackgroundReviewFork(config);
+}
+//# sourceMappingURL=review-fork.js.map

package/packages/trajectory/dist/src/review-fork.js.map

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

package/packages/trajectory/dist/src/write-approval.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Write Approval Gate
+ *
+ * Stage writes (memory, skills) for human review before they land.
+ * Based on Hermes Agent's consent-aware learning loop.
+ */
+/**
+ * Pending write types
+ */
+export type PendingWriteType = "memory_add" | "memory_replace" | "memory_remove" | "skill_create" | "skill_patch" | "skill_delete" | "skill_file_write" | "skill_file_remove" | "user_profile_add";
+/**
+ * Pending write action
+ */
+export interface PendingWriteAction {
+    type: PendingWriteType;
+    target: string;
+    content?: string;
+    oldContent?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Pending write record
+ */
+export interface PendingWrite {
+    id: string;
+    action: PendingWriteAction;
+    author: "agent" | "user" | "curator";
+    timestamp: number;
+    summary: string;
+    details?: string;
+}
+/**
+ * Write approval configuration
+ */
+export interface WriteApprovalConfig {
+    /** Enable write approval */
+    enabled: boolean;
+    /** Directory to store pending writes */
+    pendingDir: string;
+    /** Max pending writes before warning */
+    maxPending: number;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_APPROVAL_CONFIG: WriteApprovalConfig;
+/**
+ * Write Approval Gate
+ */
+export declare class WriteApprovalGate {
+    private config;
+    private pending;
+    constructor(config?: Partial<WriteApprovalConfig>);
+    /**
+     * Load pending writes from disk
+     */
+    private load;
+    /**
+     * Save pending writes to disk
+     */
+    private save;
+    /**
+     * Stage a write for approval
+     */
+    stage(action: PendingWriteAction, author: "agent" | "user" | "curator"): PendingWrite;
+    /**
+     * Generate one-line summary for action
+     */
+    private generateSummary;
+    /**
+     * Generate details (diff) for action
+     */
+    private generateDetails;
+    /**
+     * Approve a pending write
+     */
+    approve(writeId: string): PendingWrite | null;
+    /**
+     * Approve all pending writes
+     */
+    approveAll(): PendingWrite[];
+    /**
+     * Reject a pending write
+     */
+    reject(writeId: string): PendingWrite | null;
+    /**
+     * Reject all pending writes
+     */
+    rejectAll(): PendingWrite[];
+    /**
+     * Get all pending writes
+     */
+    list(): PendingWrite[];
+    /**
+     * Get pending writes by type
+     */
+    listByType(type: PendingWriteType): PendingWrite[];
+    /**
+     * Get pending writes by author
+     */
+    listByAuthor(author: "agent" | "user" | "curator"): PendingWrite[];
+    /**
+     * Get pending count
+     */
+    count(): number;
+    /**
+     * Check if approval is required
+     */
+    requiresApproval(): boolean;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<WriteApprovalConfig>): void;
+    /**
+     * Get configuration
+     */
+    getConfig(): WriteApprovalConfig;
+    /**
+     * Format pending writes for display
+     */
+    formatList(): string;
+    /**
+     * Get age string for timestamp
+     */
+    private getAgeString;
+}
+export declare function getGlobalApprovalGate(): WriteApprovalGate;
+export declare function createApprovalGate(config?: Partial<WriteApprovalConfig>): WriteApprovalGate;
+/**
+ * Helper to stage write with auto-approval if disabled
+ */
+export declare function stageWrite(action: PendingWriteAction, author: "agent" | "user" | "curator", autoApprove?: boolean): {
+    staged: boolean;
+    write?: PendingWrite;
+};
+//# sourceMappingURL=write-approval.d.ts.map

package/packages/trajectory/dist/src/write-approval.d.ts.map

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