pi-harness-runtime 1.1.95 → 1.1.97

package/packages/trajectory/dist/src/write-approval.js

@@ -0,0 +1,281 @@
+/**
+ * Write Approval Gate
+ *
+ * Stage writes (memory, skills) for human review before they land.
+ * Based on Hermes Agent's consent-aware learning loop.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+/**
+ * Default configuration
+ */
+export const DEFAULT_APPROVAL_CONFIG = {
+    enabled: false,
+    pendingDir: "~/.pi-harness/pending",
+    maxPending: 50,
+};
+/**
+ * Expand path with ~
+ */
+function expandPath(path) {
+    if (path.startsWith("~/")) {
+        return join(homedir(), path.slice(2));
+    }
+    return path;
+}
+/**
+ * Write Approval Gate
+ */
+export class WriteApprovalGate {
+    config;
+    pending = [];
+    constructor(config) {
+        this.config = { ...DEFAULT_APPROVAL_CONFIG, ...config };
+        this.config.pendingDir = expandPath(this.config.pendingDir);
+        this.load();
+    }
+    /**
+     * Load pending writes from disk
+     */
+    load() {
+        const pendingFile = join(this.config.pendingDir, "writes.json");
+        if (!existsSync(pendingFile)) {
+            this.pending = [];
+            return;
+        }
+        try {
+            const content = readFileSync(pendingFile, "utf-8");
+            this.pending = JSON.parse(content);
+        }
+        catch (err) {
+            console.error("[WriteApprovalGate] Failed to load:", err);
+            this.pending = [];
+        }
+    }
+    /**
+     * Save pending writes to disk
+     */
+    save() {
+        mkdirSync(this.config.pendingDir, { recursive: true });
+        const pendingFile = join(this.config.pendingDir, "writes.json");
+        writeFileSync(pendingFile, JSON.stringify(this.pending, null, 2), "utf-8");
+    }
+    /**
+     * Stage a write for approval
+     */
+    stage(action, author) {
+        // Generate ID
+        const id = `pw_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        // Generate summary
+        const summary = this.generateSummary(action);
+        // Generate details (diff)
+        const details = this.generateDetails(action);
+        const pending = {
+            id,
+            action,
+            author,
+            timestamp: Date.now(),
+            summary,
+            details,
+        };
+        this.pending.push(pending);
+        this.save();
+        return pending;
+    }
+    /**
+     * Generate one-line summary for action
+     */
+    generateSummary(action) {
+        switch (action.type) {
+            case "memory_add":
+                return `Add memory: "${action.content?.slice(0, 50)}..."`;
+            case "memory_replace":
+                return `Replace memory`;
+            case "memory_remove":
+                return `Remove memory`;
+            case "skill_create":
+                return `Create skill: ${action.target}`;
+            case "skill_patch":
+                return `Patch skill: ${action.target}`;
+            case "skill_delete":
+                return `Delete skill: ${action.target}`;
+            case "skill_file_write":
+                return `Write file to skill ${action.target}: ${action.metadata?.file}`;
+            case "skill_file_remove":
+                return `Remove file from skill ${action.target}: ${action.metadata?.file}`;
+            case "user_profile_add":
+                return `Add user preference: "${action.content?.slice(0, 50)}..."`;
+            default:
+                return `Unknown action: ${action.type}`;
+        }
+    }
+    /**
+     * Generate details (diff) for action
+     */
+    generateDetails(action) {
+        switch (action.type) {
+            case "memory_add":
+            case "user_profile_add":
+                return action.content;
+            case "memory_replace":
+                return `OLD:\n${action.oldContent}\n\nNEW:\n${action.content}`;
+            case "skill_create":
+            case "skill_patch":
+                return action.content;
+            default:
+                return undefined;
+        }
+    }
+    /**
+     * Approve a pending write
+     */
+    approve(writeId) {
+        const index = this.pending.findIndex((w) => w.id === writeId);
+        if (index < 0)
+            return null;
+        const write = this.pending[index];
+        this.pending.splice(index, 1);
+        this.save();
+        return write;
+    }
+    /**
+     * Approve all pending writes
+     */
+    approveAll() {
+        const approved = [...this.pending];
+        this.pending = [];
+        this.save();
+        return approved;
+    }
+    /**
+     * Reject a pending write
+     */
+    reject(writeId) {
+        const index = this.pending.findIndex((w) => w.id === writeId);
+        if (index < 0)
+            return null;
+        const write = this.pending[index];
+        this.pending.splice(index, 1);
+        this.save();
+        return write;
+    }
+    /**
+     * Reject all pending writes
+     */
+    rejectAll() {
+        const rejected = [...this.pending];
+        this.pending = [];
+        this.save();
+        return rejected;
+    }
+    /**
+     * Get all pending writes
+     */
+    list() {
+        return [...this.pending];
+    }
+    /**
+     * Get pending writes by type
+     */
+    listByType(type) {
+        return this.pending.filter((w) => w.action.type === type);
+    }
+    /**
+     * Get pending writes by author
+     */
+    listByAuthor(author) {
+        return this.pending.filter((w) => w.author === author);
+    }
+    /**
+     * Get pending count
+     */
+    count() {
+        return this.pending.length;
+    }
+    /**
+     * Check if approval is required
+     */
+    requiresApproval() {
+        return this.config.enabled;
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        if (config.pendingDir) {
+            this.config.pendingDir = expandPath(config.pendingDir);
+        }
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Format pending writes for display
+     */
+    formatList() {
+        if (this.pending.length === 0) {
+            return "No pending writes.";
+        }
+        const lines = [];
+        for (const write of this.pending) {
+            const age = this.getAgeString(write.timestamp);
+            lines.push(`[${write.id}] ${age} ${write.author}: ${write.summary}`);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Get age string for timestamp
+     */
+    getAgeString(timestamp) {
+        const age = Date.now() - timestamp;
+        const minutes = Math.floor(age / 60000);
+        if (minutes < 1)
+            return "<1m";
+        if (minutes < 60)
+            return `${minutes}m`;
+        const hours = Math.floor(minutes / 60);
+        if (hours < 24)
+            return `${hours}h`;
+        const days = Math.floor(hours / 24);
+        return `${days}d`;
+    }
+}
+// Global instance
+let globalGate = null;
+export function getGlobalApprovalGate() {
+    if (!globalGate) {
+        globalGate = new WriteApprovalGate();
+    }
+    return globalGate;
+}
+export function createApprovalGate(config) {
+    return new WriteApprovalGate(config);
+}
+/**
+ * Helper to stage write with auto-approval if disabled
+ */
+export function stageWrite(action, author, autoApprove = false) {
+    const gate = getGlobalApprovalGate();
+    if (!gate.requiresApproval() || autoApprove) {
+        // Return action directly for execution
+        return {
+            staged: false,
+            write: {
+                id: "auto",
+                action,
+                author,
+                timestamp: Date.now(),
+                summary: `Auto-approved: ${action.type}`,
+            },
+        };
+    }
+    // Stage for approval
+    const write = gate.stage(action, author);
+    return { staged: true, write };
+}
+//# sourceMappingURL=write-approval.js.map

package/packages/trajectory/dist/src/write-approval.js.map

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

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/trajectory",
-  "version": "1.1.95",
+  "version": "1.1.97",
   "description": "Trajectory capture for the write-review loop — persists cycle records for learning",
   "type": "module",
   "main": "./dist/src/index.js",