jfl 0.4.3 → 0.5.0

package/dist/lib/peer-agent-generator.js

@@ -6,9 +6,15 @@
  *
  * @purpose Generate peer service agent references for cross-service collaboration
  */
-import { writeFileSync, mkdirSync, existsSync, readdirSync, unlinkSync } from "fs";
+import { writeFileSync, mkdirSync, existsSync, readdirSync, unlinkSync, readFileSync } from "fs";
 import { join } from "path";
-import { readFileSync } from "fs";
+const ACRONYMS = new Set(["api", "ui", "cli", "db", "ml", "ai", "ci", "cd", "io", "id", "url", "uri", "sdk", "rl", "mcp", "gtm", "crm", "cms", "cdn", "dns", "tcp", "udp", "ssh", "tls", "ssl", "jwt", "aws", "gcp"]);
+function titleCase(str) {
+    return str
+        .split("-")
+        .map(w => ACRONYMS.has(w.toLowerCase()) ? w.toUpperCase() : w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
 /**
  * Get registered services from GTM config
  */
@@ -29,8 +35,7 @@ export function getRegisteredServices(gtmPath) {
  * Generate peer agent definition from service metadata
  */
 export function generatePeerAgentDefinition(peerService, currentServicePath, gtmPath) {
-    const name = `peer-service-${peerService.name}`;
-    // Generate capability-based triggers
+    const name = peerService.name;
     const capabilities = generatePeerCapabilities(peerService.type);
     return {
         name,
@@ -94,16 +99,18 @@ export function writePeerAgentDefinition(agentDef, servicePath) {
         mkdirSync(agentsDir, { recursive: true });
     }
     const agentFile = join(agentsDir, `${agentDef.name}.md`);
+    const label = titleCase(agentDef.serviceName);
     const whenToUse = generateWhenToUse(agentDef.serviceType, agentDef.serviceName);
     const content = `---
 name: ${agentDef.name}
+label: ${label}
 version: 1.0.0
 color: blue
 description: ${agentDef.description}
 type: peer-service
 ---
 
-# Peer Service: ${agentDef.serviceName}
+# ${label}
 
 **Service Type:** ${agentDef.serviceType}
 **Service Path:** \`${agentDef.servicePath}\`
@@ -174,56 +181,56 @@ When you @-mention this peer:
 function generateWhenToUse(serviceType, serviceName) {
     switch (serviceType) {
         case "api":
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Check API endpoint status or health
 - Understand API routes and handlers
 - Coordinate API changes that affect your service
 - Get data from API endpoints
 - Verify API schema or contracts`;
         case "web":
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Check frontend deployment status
 - Understand UI components or flows
 - Coordinate UI changes with backend
 - Get user-facing content or copy
 - Verify frontend build status`;
         case "worker":
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Check background job status
 - Understand job queue state
 - Coordinate async operations
 - Trigger or schedule jobs
 - Verify job processing results`;
         case "library":
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Understand library APIs and interfaces
 - Work on plugin or package features
 - Run library tests and builds
 - Update documentation
 - Debug integration issues`;
         case "infrastructure":
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Check system health across services
 - Get aggregated metrics or logs
 - Coordinate service deployments
 - Understand infrastructure state
 - Verify connectivity or resources`;
         case "container":
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Check container status
 - Understand Docker configuration
 - Coordinate container operations
 - Verify container health
 - Get container logs or metrics`;
         case "cli":
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Execute CLI commands
 - Automate workflows
 - Run scripts or tools
 - Get CLI output or results
 - Verify CLI functionality`;
         default:
-            return `Use \`@peer-service-${serviceName}\` when you need to:
+            return `Use \`@${serviceName}\` when you need to:
 - Check service status
 - Understand service capabilities
 - Coordinate with this service
@@ -252,31 +259,48 @@ export function syncPeerAgents(servicePath, gtmPath) {
     if (!existsSync(agentsDir)) {
         mkdirSync(agentsDir, { recursive: true });
     }
-    // Get existing peer agent files
+    // Get existing peer agent files (check both old and new naming conventions)
     const existingPeerFiles = existsSync(agentsDir)
-        ? readdirSync(agentsDir).filter((f) => f.startsWith("peer-service-") && f.endsWith(".md"))
+        ? readdirSync(agentsDir).filter((f) => f.endsWith(".md") && !f.startsWith("_") && f !== "README.md")
         : [];
+    // Read frontmatter to identify peer agent files (works with old and new naming)
+    const peerFileSet = new Set();
+    for (const f of existingPeerFiles) {
+        try {
+            const content = readFileSync(join(agentsDir, f), "utf-8");
+            if (content.includes("type: peer-service") || f.startsWith("peer-service-")) {
+                peerFileSet.add(f);
+            }
+        }
+        catch { }
+    }
     // Generate/update peer agent files for all registered services
     const currentPeerFiles = new Set();
     for (const peerService of peerServices) {
         const agentDef = generatePeerAgentDefinition(peerService, servicePath, gtmPath);
         const fileName = `${agentDef.name}.md`;
         currentPeerFiles.add(fileName);
+        // Remove old-style file if it exists (migration)
+        const oldFileName = `peer-service-${agentDef.name}.md`;
+        const oldFilePath = join(agentsDir, oldFileName);
+        if (existsSync(oldFilePath)) {
+            unlinkSync(oldFilePath);
+            peerFileSet.delete(oldFileName);
+        }
         const filePath = join(agentsDir, fileName);
         if (existsSync(filePath)) {
-            // Update existing
             writePeerAgentDefinition(agentDef, servicePath);
             stats.updated++;
         }
         else {
-            // Add new
             writePeerAgentDefinition(agentDef, servicePath);
             stats.added++;
         }
     }
     // Remove stale peer agent files (services that were unregistered)
-    for (const existingFile of existingPeerFiles) {
-        if (!currentPeerFiles.has(existingFile)) {
+    for (const existingFile of peerFileSet) {
+        const nameWithoutExt = existingFile.replace(/\.md$/, "").replace(/^peer-service-/, "");
+        if (!currentPeerFiles.has(existingFile) && !currentPeerFiles.has(`${nameWithoutExt}.md`)) {
             unlinkSync(join(agentsDir, existingFile));
             stats.removed++;
         }

package/dist/lib/peer-agent-generator.js.map

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

package/dist/lib/policy-head.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @purpose Policy head inference — loads trained weights, scores candidate actions for autoresearch
+ */
+import type { RLState, RLAction } from "./training-buffer.js";
+export declare class PolicyHeadInference {
+    private weights;
+    private embedCache;
+    constructor(projectRoot?: string);
+    get isLoaded(): boolean;
+    get stats(): {
+        trained_on: number;
+        direction_accuracy: number;
+        rank_correlation: number;
+    } | null;
+    embedText(text: string): Promise<number[]>;
+    formatStateText(state: RLState): string;
+    formatActionText(action: RLAction): string;
+    predictReward(state: RLState, action: RLAction): Promise<number>;
+    rankActions(state: RLState, actions: RLAction[]): Promise<Array<{
+        action: RLAction;
+        predictedReward: number;
+        rank: number;
+    }>>;
+}
+//# sourceMappingURL=policy-head.d.ts.map

package/dist/lib/policy-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-head.d.ts","sourceRoot":"","sources":["../../src/lib/policy-head.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AA+D7D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAA8B;gBAEpC,WAAW,CAAC,EAAE,MAAM;IAQhC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,KAAK,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAO/F;IAEK,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BhD,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAevC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAUpC,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAahE,WAAW,CACf,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAsB/E"}

package/dist/lib/policy-head.js

@@ -0,0 +1,136 @@
+/**
+ * @purpose Policy head inference — loads trained weights, scores candidate actions for autoresearch
+ */
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+function relu(x) {
+    return Math.max(0, x);
+}
+function matVecMul(mat, vec) {
+    return mat.map(row => row.reduce((sum, w, j) => sum + w * vec[j], 0));
+}
+function vecAdd(a, b) {
+    return a.map((v, i) => v + b[i]);
+}
+function forward(weights, input) {
+    const { W1, b1, W2, b2, W3, b3 } = weights.layers;
+    // Transpose W1 for (input_dim, hidden_dim) → need input @ W1
+    // W1 stored as [input_dim][hidden_dim], so W1[i][j] = weight from input i to hidden j
+    const z1 = vecAdd(matVecMulTransposed(W1, input), b1);
+    const a1 = z1.map(relu);
+    const z2 = vecAdd(matVecMulTransposed(W2, a1), b2);
+    const a2 = z2.map(relu);
+    const z3 = vecAdd(matVecMulTransposed(W3, a2), b3);
+    return z3[0];
+}
+function matVecMulTransposed(mat, vec) {
+    // mat is [rows][cols], we want vec @ mat = result[cols]
+    // result[j] = sum_i(vec[i] * mat[i][j])
+    const cols = mat[0].length;
+    const result = new Array(cols).fill(0);
+    for (let i = 0; i < vec.length; i++) {
+        for (let j = 0; j < cols; j++) {
+            result[j] += vec[i] * mat[i][j];
+        }
+    }
+    return result;
+}
+export class PolicyHeadInference {
+    weights = null;
+    embedCache = new Map();
+    constructor(projectRoot) {
+        const root = projectRoot || process.cwd();
+        const weightsPath = join(root, ".jfl", "policy-weights.json");
+        if (existsSync(weightsPath)) {
+            this.weights = JSON.parse(readFileSync(weightsPath, "utf-8"));
+        }
+    }
+    get isLoaded() {
+        return this.weights !== null;
+    }
+    get stats() {
+        if (!this.weights)
+            return null;
+        return {
+            trained_on: this.weights.trained_on,
+            direction_accuracy: this.weights.direction_accuracy,
+            rank_correlation: this.weights.rank_correlation,
+        };
+    }
+    async embedText(text) {
+        if (this.embedCache.has(text))
+            return this.embedCache.get(text);
+        const apiKey = process.env.STRATUS_API_KEY;
+        if (!apiKey)
+            throw new Error("STRATUS_API_KEY not set");
+        const url = `${process.env.STRATUS_API_URL || "https://api.stratus.run"}/v1/embeddings`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: "stratus-x1ac-base",
+                input: text,
+            }),
+        });
+        if (!response.ok)
+            throw new Error(`Embedding failed: ${response.status}`);
+        const data = await response.json();
+        const embedding = data.data[0].embedding;
+        this.embedCache.set(text, embedding);
+        return embedding;
+    }
+    formatStateText(state) {
+        const dims = Object.entries(state.dimension_scores)
+            .map(([k, v]) => `${k}=${v.toFixed(4)}`).join(", ");
+        const deltas = state.recent_deltas
+            .map(d => `${d >= 0 ? "+" : ""}${d.toFixed(4)}`).join(", ");
+        return [
+            `Agent: ${state.agent}`,
+            `Composite: ${state.composite_score.toFixed(4)}`,
+            `Tests: ${state.tests_passing}/${state.tests_total}`,
+            `Trajectory: ${state.trajectory_length}`,
+            `Dimensions: ${dims || "none"}`,
+            `Recent deltas: ${deltas || "none"}`,
+        ].join("\n");
+    }
+    formatActionText(action) {
+        const files = action.files_affected.slice(0, 5).join(", ");
+        return [
+            `Type: ${action.type}`,
+            `Description: ${action.description.slice(0, 150)}`,
+            `Scope: ${action.scope}`,
+            `Files: ${files || "none"}`,
+        ].join("\n");
+    }
+    async predictReward(state, action) {
+        if (!this.weights)
+            throw new Error("No policy weights loaded");
+        const stateEmb = await this.embedText(this.formatStateText(state));
+        const actionEmb = await this.embedText(this.formatActionText(action));
+        const input = [...stateEmb, ...actionEmb];
+        const rawPred = forward(this.weights, input);
+        // Denormalize
+        return rawPred * this.weights.target_std + this.weights.target_mean;
+    }
+    async rankActions(state, actions) {
+        if (!this.weights)
+            throw new Error("No policy weights loaded");
+        const stateText = this.formatStateText(state);
+        const stateEmb = await this.embedText(stateText);
+        const results = [];
+        for (const action of actions) {
+            const actionEmb = await this.embedText(this.formatActionText(action));
+            const input = [...stateEmb, ...actionEmb];
+            const rawPred = forward(this.weights, input);
+            const reward = rawPred * this.weights.target_std + this.weights.target_mean;
+            results.push({ action, predictedReward: reward, rank: 0 });
+        }
+        results.sort((a, b) => b.predictedReward - a.predictedReward);
+        results.forEach((r, i) => { r.rank = i + 1; });
+        return results;
+    }
+}
+//# sourceMappingURL=policy-head.js.map

package/dist/lib/policy-head.js.map

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

package/dist/lib/replay-buffer.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Shared Replay Buffer
+ *
+ * Cross-agent learning via append-only JSONL file.
+ * Enables agents to learn from each other's experiences.
+ * 80% from own agent, 20% from others by default.
+ *
+ * @purpose Shared replay buffer for cross-agent reinforcement learning
+ */
+import type { RLState, RLAction } from "./training-buffer.js";
+export interface ReplayEntry {
+    id: string;
+    agent: string;
+    session_id: string;
+    state_hash: string;
+    state: RLState;
+    action_diff: string;
+    action: RLAction;
+    hypothesis: string;
+    reward: number;
+    timestamp: string;
+}
+export interface ReplayStats {
+    totalEntries: number;
+    perAgent: Record<string, number>;
+    avgReward: number;
+    positiveRate: number;
+    oldestEntry?: string;
+    newestEntry?: string;
+}
+export interface SampleOptions {
+    batchSize: number;
+    crossAgentRatio: number;
+    minReward?: number;
+    maxAge?: number;
+}
+export declare class ReplayBuffer {
+    private bufferPath;
+    private projectRoot;
+    constructor(projectRoot?: string);
+    /**
+     * Append a new entry to the replay buffer
+     */
+    write(entry: Omit<ReplayEntry, "id">): ReplayEntry;
+    /**
+     * Read all entries from the replay buffer
+     */
+    readAll(): ReplayEntry[];
+    /**
+     * Sample entries for training
+     * By default: 80% from target agent, 20% from others
+     */
+    sample(agent: string, options: SampleOptions): ReplayEntry[];
+    /**
+     * Sample with prioritized experience replay
+     * Prioritizes entries with higher absolute reward (more informative)
+     */
+    samplePrioritized(agent: string, options: SampleOptions): ReplayEntry[];
+    private prioritizedSample;
+    /**
+     * Get statistics about the replay buffer
+     */
+    stats(): ReplayStats;
+    /**
+     * Get entries for a specific agent
+     */
+    getForAgent(agent: string): ReplayEntry[];
+    /**
+     * Get recent entries
+     */
+    getRecent(count?: number): ReplayEntry[];
+    /**
+     * Export for policy head training
+     */
+    exportForTraining(): Array<{
+        state_text: string;
+        action_text: string;
+        reward: number;
+        agent: string;
+        ts: string;
+    }>;
+    private formatStateText;
+    private formatActionText;
+    private shuffle;
+    /**
+     * Clear old entries (keep last N or by age)
+     */
+    prune(options: {
+        maxEntries?: number;
+        maxAge?: number;
+    }): number;
+}
+//# sourceMappingURL=replay-buffer.d.ts.map

package/dist/lib/replay-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-buffer.d.ts","sourceRoot":"","sources":["../../src/lib/replay-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAY,MAAM,sBAAsB,CAAA;AAMvE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,QAAQ,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAwBD,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAQ;gBAEf,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,WAAW;IAalD;;OAEG;IACH,OAAO,IAAI,WAAW,EAAE;IAgBxB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE;IAsC5D;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE;IAwCvE,OAAO,CAAC,iBAAiB;IAsCzB;;OAEG;IACH,KAAK,IAAI,WAAW;IAoCpB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAIzC;;OAEG;IACH,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,WAAW,EAAE;IAO5C;;OAEG;IACH,iBAAiB,IAAI,KAAK,CAAC;QACzB,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,EAAE,EAAE,MAAM,CAAA;KACX,CAAC;IAYF,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CA+BjE"}