jfl 0.3.0 → 0.4.3

package/dist/commands/ci-setup.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @purpose CLI command for `jfl ci setup` — deploys eval + review CI workflows to a project
+ */
+export declare function ciSetupCommand(): Promise<void>;
+//# sourceMappingURL=ci-setup.d.ts.map

package/dist/commands/ci-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-setup.d.ts","sourceRoot":"","sources":["../../src/commands/ci-setup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEpD"}

package/dist/commands/ci-setup.js

@@ -0,0 +1,82 @@
+/**
+ * @purpose CLI command for `jfl ci setup` — deploys eval + review CI workflows to a project
+ */
+import chalk from "chalk";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATE_DIR = join(__dirname, "../../template/.github/workflows");
+const WORKFLOW_FILES = ["jfl-eval.yml", "jfl-review.yml"];
+function getRepoSlug() {
+    try {
+        const remote = execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
+        const match = remote.match(/github\.com[:/](.+?)(?:\.git)?$/);
+        return match?.[1] ?? "OWNER/REPO";
+    }
+    catch {
+        return "OWNER/REPO";
+    }
+}
+export async function ciSetupCommand() {
+    const cwd = process.cwd();
+    const targetDir = join(cwd, ".github", "workflows");
+    if (!existsSync(TEMPLATE_DIR)) {
+        console.log(chalk.red("\n  Template workflows not found at: " + TEMPLATE_DIR));
+        console.log(chalk.gray("  This usually means the jfl CLI package is incomplete. Try: npm install -g jfl\n"));
+        process.exit(1);
+    }
+    if (!existsSync(join(cwd, ".github"))) {
+        mkdirSync(join(cwd, ".github"), { recursive: true });
+    }
+    if (!existsSync(targetDir)) {
+        mkdirSync(targetDir, { recursive: true });
+    }
+    let deployed = 0;
+    let skipped = 0;
+    for (const file of WORKFLOW_FILES) {
+        const src = join(TEMPLATE_DIR, file);
+        const dest = join(targetDir, file);
+        if (!existsSync(src)) {
+            console.log(chalk.yellow(`  Template missing: ${file} — skipping`));
+            skipped++;
+            continue;
+        }
+        const templateContent = readFileSync(src, "utf-8");
+        if (existsSync(dest)) {
+            const existingContent = readFileSync(dest, "utf-8");
+            if (existingContent === templateContent) {
+                console.log(chalk.gray(`  ${file} — already up to date`));
+                deployed++;
+                continue;
+            }
+            console.log(chalk.yellow(`  ${file} — exists and differs from template, overwriting`));
+        }
+        writeFileSync(dest, templateContent);
+        console.log(chalk.green(`  ${file} — deployed`));
+        deployed++;
+    }
+    const repoSlug = getRepoSlug();
+    console.log();
+    if (deployed > 0) {
+        console.log(chalk.green("  CI workflows deployed to .github/workflows/"));
+    }
+    if (skipped > 0) {
+        console.log(chalk.yellow(`  ${skipped} workflow(s) skipped (template missing)`));
+    }
+    console.log();
+    console.log(chalk.bold("  Required GitHub secrets") + chalk.gray(` (set at github.com/${repoSlug}/settings/secrets):`));
+    console.log(chalk.cyan("    OPENAI_API_KEY") + chalk.gray("     — For AI quality assessment and code review"));
+    console.log();
+    console.log(chalk.bold("  Optional:"));
+    console.log(chalk.cyan("    OPENROUTER_API_KEY") + chalk.gray(" — Fallback if OpenAI unavailable"));
+    console.log(chalk.cyan("    JFL_HUB_URL") + chalk.gray("        — Context Hub URL for real-time dashboard updates"));
+    console.log(chalk.cyan("    JFL_HUB_TOKEN") + chalk.gray("      — Auth token for hub API"));
+    console.log();
+    console.log(chalk.gray("  The eval workflow runs on PRs from Peter Parker (pp/ branches)."));
+    console.log(chalk.gray("  To trigger manually, add the 'run-eval' or 'ai-review' label to any PR."));
+    console.log();
+}
+//# sourceMappingURL=ci-setup.js.map

package/dist/commands/ci-setup.js.map

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

package/dist/commands/context-hub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-hub.d.ts","sourceRoot":"","sources":["../../src/commands/context-hub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmzCH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBjF;AA2ND,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAiHxF;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,iBA8enE"}
+{"version":3,"file":"context-hub.d.ts","sourceRoot":"","sources":["../../src/commands/context-hub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAg8CH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBjF;AA2ND,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAiHxF;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,iBA+fnE"}

package/dist/commands/context-hub.js

@@ -632,10 +632,16 @@ function createServer(projectRoot, port, eventBus, flowEngine) {
                         scope: cfg.context_scope || null,
                         registered_services: (cfg.registered_services || []).map((s) => ({
                             name: s.name,
+                            path: s.path,
                             type: s.type,
                             status: s.status,
                             context_scope: s.context_scope || null,
                         })),
+                        openclaw_agents: (cfg.openclaw_agents || []).map((a) => ({
+                            id: a.id,
+                            runtime: a.runtime,
+                            registered_at: a.registered_at,
+                        })),
                         gtm_parent: cfg.gtm_parent || null,
                         portfolio_parent: cfg.portfolio_parent || null,
                     };
@@ -876,6 +882,38 @@ function createServer(projectRoot, port, eventBus, flowEngine) {
             }
             return;
         }
+        // Synopsis (work summary)
+        if (url.pathname === "/api/synopsis" && req.method === "GET") {
+            try {
+                const hours = parseInt(url.searchParams.get("hours") || "24", 10);
+                const author = url.searchParams.get("author") || undefined;
+                const { generateSynopsis } = await import("./synopsis.js");
+                const synopsis = generateSynopsis(projectRoot, hours, author);
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(synopsis));
+            }
+            catch (err) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: err.message }));
+            }
+            return;
+        }
+        // Prediction accuracy (Stratus)
+        if (url.pathname === "/api/eval/predictions" && req.method === "GET") {
+            try {
+                const { Predictor } = await import("../lib/predictor.js");
+                const predictor = new Predictor({ projectRoot });
+                const accuracy = predictor.getAccuracy();
+                const recent = predictor.getHistory(20).reverse();
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ accuracy, recent }));
+            }
+            catch (err) {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ accuracy: { total: 0, resolved: 0, direction_accuracy: 0, mean_delta_error: 0, calibration: 0 }, recent: [] }));
+            }
+            return;
+        }
         // Cross-project health
         if (url.pathname === "/api/projects" && req.method === "GET") {
             const tracked = getTrackedProjects();
@@ -1005,6 +1043,39 @@ function createServer(projectRoot, port, eventBus, flowEngine) {
             }
             return;
         }
+        // Telemetry agent status
+        if (url.pathname === "/api/telemetry/agent" && req.method === "GET") {
+            const agent = server.__telemetryAgent;
+            if (agent) {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(agent.getStatus()));
+            }
+            else {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ running: false, lastRun: '', runCount: 0, lastInsights: [] }));
+            }
+            return;
+        }
+        // Telemetry agent: trigger manual run
+        if (url.pathname === "/api/telemetry/agent/run" && req.method === "POST") {
+            const agent = server.__telemetryAgent;
+            if (agent) {
+                try {
+                    const insights = await agent.run();
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: true, insights }));
+                }
+                catch (err) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: err.message }));
+                }
+            }
+            else {
+                res.writeHead(503, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Telemetry agent not running" }));
+            }
+            return;
+        }
         // Flow definitions
         if (url.pathname === "/api/flows" && req.method === "GET") {
             if (!flowEngine) {
@@ -1061,6 +1132,72 @@ function createServer(projectRoot, port, eventBus, flowEngine) {
             });
             return;
         }
+        if (url.pathname.match(/^\/api\/flows\/[^/]+\/toggle$/) && req.method === "POST") {
+            if (!flowEngine) {
+                res.writeHead(503, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Flow engine not initialized" }));
+                return;
+            }
+            const flowName = decodeURIComponent(url.pathname.split("/")[3]);
+            let body = "";
+            req.on("data", chunk => body += chunk);
+            req.on("end", () => {
+                try {
+                    const { enabled } = JSON.parse(body || "{}");
+                    const result = flowEngine.toggleFlow(flowName, enabled);
+                    if (!result) {
+                        res.writeHead(404, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({ error: "Flow not found" }));
+                        return;
+                    }
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: true, flow: flowName, enabled: result.enabled }));
+                }
+                catch (err) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: err.message }));
+                }
+            });
+            return;
+        }
+        if (url.pathname === "/api/actions/spawn" && req.method === "POST") {
+            let body = "";
+            req.on("data", chunk => body += chunk);
+            req.on("end", () => {
+                try {
+                    const { command, args, cwd, event_type, event_data } = JSON.parse(body || "{}");
+                    if (!command) {
+                        res.writeHead(400, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({ error: "command required" }));
+                        return;
+                    }
+                    const env = { ...process.env };
+                    delete env.ANTHROPIC_API_KEY;
+                    delete env.CLAUDE_CODE_ENTRYPOINT;
+                    const child = spawn(command, args || [], {
+                        cwd: cwd || projectRoot,
+                        detached: true,
+                        stdio: "ignore",
+                        env,
+                    });
+                    child.unref();
+                    if (event_type && eventBus) {
+                        eventBus.emit({
+                            type: event_type,
+                            source: "dashboard:action",
+                            data: event_data || { command, args, pid: child.pid },
+                        });
+                    }
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: true, pid: child.pid }));
+                }
+                catch (err) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: err.message }));
+                }
+            });
+            return;
+        }
         // 404
         res.writeHead(404, { "Content-Type": "application/json" });
         res.end(JSON.stringify({ error: "Not found" }));
@@ -1728,6 +1865,23 @@ export async function contextHubCommand(action, options = {}) {
                 catch (err) {
                     console.error(`[${timestamp}] Failed to start flow engine:`, err.message);
                 }
+                // Start telemetry agent (periodic pattern detection)
+                try {
+                    const { TelemetryAgent } = await import("../lib/telemetry-agent.js");
+                    const telemetryAgent = new TelemetryAgent({
+                        projectRoot,
+                        intervalMs: 30 * 60 * 1000,
+                        emitEvent: (type, data, source) => {
+                            eventBus.emit({ type: type, data, source: source || 'telemetry-agent' });
+                        },
+                    });
+                    telemetryAgent.start();
+                    server.__telemetryAgent = telemetryAgent;
+                    console.log(`[${timestamp}] Telemetry agent started (interval: 30m)`);
+                }
+                catch (err) {
+                    console.error(`[${timestamp}] Failed to start telemetry agent:`, err.message);
+                }
                 console.log(`[${timestamp}] MAP event bus initialized (buffer: 1000, subscribers: ${eventBus.getSubscriberCount()})`);
                 console.log(`[${timestamp}] Ready to serve requests`);
             });