jfl 0.2.3 → 0.2.5

package/dist/commands/agent.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @purpose Manage narrowly-scoped agents — init scaffolding, list, status
+ */
+export declare function agentCommand(action?: string, nameOrOptions?: string, options?: {
+    description?: string;
+}): Promise<void>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsKH,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7H"}

package/dist/commands/agent.js

@@ -0,0 +1,170 @@
+/**
+ * @purpose Manage narrowly-scoped agents — init scaffolding, list, status
+ */
+import chalk from "chalk";
+import * as fs from "fs";
+import * as path from "path";
+import { generateManifest, generatePolicy, generateLifecycle } from "../lib/agent-manifest.js";
+function getAgentsDir() {
+    return path.join(process.cwd(), ".jfl", "agents");
+}
+function getFlowsDir() {
+    return path.join(process.cwd(), ".jfl", "flows");
+}
+async function initAgent(name, options = {}) {
+    if (!/^[a-z0-9-]+$/.test(name)) {
+        console.log(chalk.red(`\n  Invalid agent name: "${name}"`));
+        console.log(chalk.gray("  Use lowercase letters, numbers, and hyphens only\n"));
+        return;
+    }
+    const agentDir = path.join(getAgentsDir(), name);
+    if (fs.existsSync(agentDir)) {
+        console.log(chalk.yellow(`\n  Agent "${name}" already exists at .jfl/agents/${name}/\n`));
+        return;
+    }
+    fs.mkdirSync(agentDir, { recursive: true });
+    const manifestContent = generateManifest(name, options.description);
+    fs.writeFileSync(path.join(agentDir, "manifest.yaml"), manifestContent);
+    const policyContent = generatePolicy();
+    fs.writeFileSync(path.join(agentDir, "policy.json"), policyContent);
+    const triggerPattern = "session:ended";
+    const lifecycleContent = generateLifecycle(name, triggerPattern);
+    const flowsDir = getFlowsDir();
+    fs.mkdirSync(flowsDir, { recursive: true });
+    fs.writeFileSync(path.join(flowsDir, `${name}.yaml`), lifecycleContent);
+    console.log(chalk.bold(`\n  Agent scaffolded: ${name}\n`));
+    console.log(chalk.gray("  Created:"));
+    console.log(`    .jfl/agents/${name}/manifest.yaml`);
+    console.log(`    .jfl/agents/${name}/policy.json`);
+    console.log(`    .jfl/flows/${name}.yaml`);
+    console.log();
+    console.log(chalk.gray("  Next steps:"));
+    console.log(`    1. Edit manifest.yaml — set triggers, capabilities, runtime`);
+    console.log(`    2. Edit policy.json — set cost limits, approval gates`);
+    console.log(`    3. Edit .jfl/flows/${name}.yaml — customize lifecycle flow`);
+    console.log(`    4. Run ${chalk.cyan("jfl agent status " + name)} to verify`);
+    console.log();
+}
+async function listAgents() {
+    const agentsDir = getAgentsDir();
+    console.log(chalk.bold("\n  Registered Agents\n"));
+    if (!fs.existsSync(agentsDir)) {
+        console.log(chalk.gray("  No agents registered."));
+        console.log(chalk.gray(`  Run ${chalk.cyan("jfl agent init <name>")} to create one.\n`));
+        return;
+    }
+    const entries = fs.readdirSync(agentsDir).filter(f => fs.statSync(path.join(agentsDir, f)).isDirectory());
+    if (entries.length === 0) {
+        console.log(chalk.gray("  No agents registered."));
+        console.log(chalk.gray(`  Run ${chalk.cyan("jfl agent init <name>")} to create one.\n`));
+        return;
+    }
+    for (const name of entries) {
+        const manifestPath = path.join(agentsDir, name, "manifest.yaml");
+        const policyPath = path.join(agentsDir, name, "policy.json");
+        const hasManifest = fs.existsSync(manifestPath);
+        const hasPolicy = fs.existsSync(policyPath);
+        let description = "";
+        let agentType = "";
+        if (hasManifest) {
+            try {
+                const { parse } = await import("yaml");
+                const manifest = parse(fs.readFileSync(manifestPath, "utf-8"));
+                description = manifest.description || "";
+                agentType = manifest.type || "";
+            }
+            catch { }
+        }
+        const status = hasManifest && hasPolicy ? chalk.green("ok") : chalk.yellow("incomplete");
+        const typeTag = agentType ? chalk.gray(` [${agentType}]`) : "";
+        const desc = description ? chalk.gray(` — ${description}`) : "";
+        console.log(`  ${status}  ${chalk.bold(name)}${typeTag}${desc}`);
+    }
+    console.log();
+}
+async function statusAgent(name) {
+    const agentDir = path.join(getAgentsDir(), name);
+    if (!fs.existsSync(agentDir)) {
+        console.log(chalk.red(`\n  Agent "${name}" not found.`));
+        console.log(chalk.gray(`  Run ${chalk.cyan("jfl agent init " + name)} to create it.\n`));
+        return;
+    }
+    console.log(chalk.bold(`\n  Agent: ${name}\n`));
+    const manifestPath = path.join(agentDir, "manifest.yaml");
+    const policyPath = path.join(agentDir, "policy.json");
+    const flowPath = path.join(getFlowsDir(), `${name}.yaml`);
+    const checks = [
+        { file: "manifest.yaml", path: manifestPath },
+        { file: "policy.json", path: policyPath },
+        { file: `flows/${name}.yaml`, path: flowPath },
+    ];
+    for (const check of checks) {
+        if (fs.existsSync(check.path)) {
+            console.log(chalk.green("  [ok] ") + check.file);
+        }
+        else {
+            console.log(chalk.red("  [!!] ") + check.file + chalk.gray(" — missing"));
+        }
+    }
+    if (fs.existsSync(manifestPath)) {
+        try {
+            const { parse } = await import("yaml");
+            const manifest = parse(fs.readFileSync(manifestPath, "utf-8"));
+            console.log();
+            console.log(chalk.gray("  Type:         ") + (manifest.type || "unknown"));
+            console.log(chalk.gray("  Version:      ") + (manifest.version || "0.0.0"));
+            if (manifest.triggers?.length) {
+                const triggers = manifest.triggers.map((t) => t.pattern || t.schedule).join(", ");
+                console.log(chalk.gray("  Triggers:     ") + triggers);
+            }
+            if (manifest.capabilities?.length) {
+                console.log(chalk.gray("  Capabilities: ") + manifest.capabilities.join(", "));
+            }
+            if (manifest.runtime?.command) {
+                console.log(chalk.gray("  Runtime:      ") + manifest.runtime.command + " " + (manifest.runtime.args || []).join(" "));
+            }
+        }
+        catch { }
+    }
+    if (fs.existsSync(policyPath)) {
+        try {
+            const policy = JSON.parse(fs.readFileSync(policyPath, "utf-8"));
+            console.log(chalk.gray("  Cost limit:   ") + `$${policy.cost_limit_usd}`);
+            console.log(chalk.gray("  Approval:     ") + policy.approval_gate);
+            console.log(chalk.gray("  Max conc.:    ") + policy.max_concurrent);
+        }
+        catch { }
+    }
+    console.log();
+}
+export async function agentCommand(action, nameOrOptions, options) {
+    switch (action) {
+        case "init":
+            if (!nameOrOptions) {
+                console.log(chalk.red("\n  Agent name required."));
+                console.log(chalk.gray("  Usage: jfl agent init <name>\n"));
+                return;
+            }
+            await initAgent(nameOrOptions, options || {});
+            break;
+        case "list":
+            await listAgents();
+            break;
+        case "status":
+            if (!nameOrOptions) {
+                console.log(chalk.red("\n  Agent name required."));
+                console.log(chalk.gray("  Usage: jfl agent status <name>\n"));
+                return;
+            }
+            await statusAgent(nameOrOptions);
+            break;
+        default:
+            console.log(chalk.bold("\n  jfl agent — Manage narrowly-scoped agents\n"));
+            console.log(chalk.gray("  Commands:"));
+            console.log("    jfl agent init <name>     Scaffold a new agent (manifest + policy + flows)");
+            console.log("    jfl agent list            List registered agents");
+            console.log("    jfl agent status <name>   Show agent health and config");
+            console.log();
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/commands/agent.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;AAy7BH,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,iBAicnE"}
+{"version":3,"file":"context-hub.d.ts","sourceRoot":"","sources":["../../src/commands/context-hub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoiCH,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,iBAwenE"}

package/dist/commands/context-hub.js

@@ -21,7 +21,10 @@ import { getProjectPort } from "../utils/context-hub-port.js";
 import { getConfigValue, setConfig } from "../utils/jfl-config.js";
 import Conf from "conf";
 import { MAPEventBus } from "../lib/map-event-bus.js";
+import { FlowEngine } from "../lib/flow-engine.js";
 import { WebSocketServer } from "ws";
+import { telemetry } from "../lib/telemetry.js";
+import { transformHookPayload } from "../lib/hook-transformer.js";
 const PID_FILE = ".jfl/context-hub.pid";
 const LOG_FILE = ".jfl/logs/context-hub.log";
 const TOKEN_FILE = ".jfl/context-hub.token";
@@ -417,6 +420,32 @@ function getUnifiedContext(projectRoot, query, taskType) {
 // ============================================================================
 function createServer(projectRoot, port, eventBus) {
     const server = http.createServer((req, res) => {
+        const requestStart = Date.now();
+        const pathname = new URL(req.url || "/", `http://localhost:${port}`).pathname;
+        // Intercept writeHead to capture status code for telemetry
+        let capturedStatus = 200;
+        const originalWriteHead = res.writeHead.bind(res);
+        res.writeHead = function (statusCode, ...args) {
+            capturedStatus = statusCode;
+            return originalWriteHead(statusCode, ...args);
+        };
+        // Track request on response finish (skip health/OPTIONS/dashboard)
+        const shouldTrack = req.method !== "OPTIONS"
+            && pathname !== "/health"
+            && !pathname.startsWith("/dashboard");
+        if (shouldTrack) {
+            res.on('finish', () => {
+                telemetry.track({
+                    category: 'context_hub',
+                    event: 'context_hub:request',
+                    endpoint: pathname,
+                    method: req.method,
+                    status_code: capturedStatus,
+                    duration_ms: Date.now() - requestStart,
+                    hub_port: port,
+                });
+            });
+        }
         // CORS - include Authorization header
         res.setHeader("Access-Control-Allow-Origin", "*");
         res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
@@ -446,8 +475,56 @@ function createServer(projectRoot, port, eventBus) {
             });
             return;
         }
+        // Hook ingestion (Claude Code HTTP hooks)
+        // No auth required — localhost-only. Always returns 200.
+        if (url.pathname === "/api/hooks" && req.method === "POST") {
+            const remoteAddr = req.socket.remoteAddress || "";
+            const isLocalhost = remoteAddr === "127.0.0.1" || remoteAddr === "::1" || remoteAddr === "::ffff:127.0.0.1";
+            if (!isLocalhost) {
+                res.writeHead(403, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "localhost only" }));
+                return;
+            }
+            let body = "";
+            let bodySize = 0;
+            const MAX_BODY = 64 * 1024;
+            req.on("data", (chunk) => {
+                bodySize += typeof chunk === "string" ? chunk.length : chunk.byteLength;
+                if (bodySize <= MAX_BODY) {
+                    body += chunk;
+                }
+            });
+            req.on("end", () => {
+                try {
+                    if (bodySize > MAX_BODY) {
+                        console.warn(`[hooks] Dropped oversized payload: ${bodySize} bytes`);
+                        res.writeHead(200, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({ ok: true, dropped: true }));
+                        return;
+                    }
+                    const payload = JSON.parse(body);
+                    const partial = transformHookPayload(payload);
+                    if (eventBus) {
+                        eventBus.emit(partial);
+                    }
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: true }));
+                }
+                catch (err) {
+                    console.warn(`[hooks] Parse error: ${err.message}`);
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: true, parse_error: true }));
+                }
+            });
+            return;
+        }
         // All other endpoints require auth
         if (!validateAuth(req, projectRoot, url)) {
+            telemetry.track({
+                category: 'context_hub',
+                event: 'context_hub:auth_failed',
+                endpoint: pathname,
+            });
             res.writeHead(401, { "Content-Type": "application/json" });
             res.end(JSON.stringify({
                 error: "Unauthorized",
@@ -479,6 +556,15 @@ function createServer(projectRoot, port, eventBus) {
                     if (maxItems && context.items.length > maxItems) {
                         context.items = context.items.slice(0, maxItems);
                     }
+                    telemetry.track({
+                        category: 'context_hub',
+                        event: 'context_hub:context_loaded',
+                        item_count: context.items.length,
+                        journal_count: context.items.filter(i => i.source === 'journal').length,
+                        knowledge_count: context.items.filter(i => i.source === 'knowledge').length,
+                        code_count: context.items.filter(i => i.source === 'code').length,
+                        query_length: query ? query.length : 0,
+                    });
                     res.writeHead(200, { "Content-Type": "application/json" });
                     res.end(JSON.stringify(context));
                 }
@@ -501,10 +587,19 @@ function createServer(projectRoot, port, eventBus) {
                         res.end(JSON.stringify({ error: "query required" }));
                         return;
                     }
+                    const searchStart = Date.now();
                     const context = getUnifiedContext(projectRoot, query);
                     context.items = context.items
                         .filter(item => item.relevance && item.relevance > 0)
                         .slice(0, maxItems);
+                    telemetry.track({
+                        category: 'context_hub',
+                        event: 'context_hub:search',
+                        result_count: context.items.length,
+                        duration_ms: Date.now() - searchStart,
+                        has_query: true,
+                        query_length: query.length,
+                    });
                     res.writeHead(200, { "Content-Type": "application/json" });
                     res.end(JSON.stringify(context));
                 }
@@ -1319,7 +1414,14 @@ export async function contextHubCommand(action, options = {}) {
             process.on("uncaughtException", (err) => {
                 console.error(`Uncaught exception: ${err.message}`);
                 console.error(err.stack);
-                // Don't exit - log and continue
+                telemetry.track({
+                    category: 'error',
+                    event: 'error:hub_crash',
+                    error_type: err.constructor.name,
+                    error_code: err.code || undefined,
+                    hub_port: port,
+                    hub_uptime_s: isListening ? Math.floor((Date.now() - hubStartTime) / 1000) : 0,
+                });
             });
             process.on("unhandledRejection", (reason, promise) => {
                 console.error(`Unhandled rejection at ${promise}: ${reason}`);
@@ -1327,17 +1429,30 @@ export async function contextHubCommand(action, options = {}) {
             });
             server.on("error", (err) => {
                 console.error(`Server error: ${err.message}`);
+                telemetry.track({
+                    category: 'error',
+                    event: 'error:hub_server',
+                    error_type: err.constructor.name,
+                    error_code: err.code || undefined,
+                    hub_port: port,
+                });
                 if (err.code === "EADDRINUSE") {
                     console.error(`Port ${port} is already in use. Exiting.`);
                     process.exit(1);
                 }
-                // For other errors, don't exit
             });
+            const hubStartTime = Date.now();
             server.listen(port, async () => {
                 isListening = true;
                 const timestamp = new Date().toISOString();
                 console.log(`[${timestamp}] Context Hub listening on port ${port}`);
                 console.log(`[${timestamp}] PID: ${process.pid}`);
+                telemetry.track({
+                    category: 'context_hub',
+                    event: 'context_hub:started',
+                    hub_port: port,
+                    duration_ms: Date.now() - hubStartTime,
+                });
                 // Initialize memory system
                 try {
                     await initializeDatabase();
@@ -1355,6 +1470,17 @@ export async function contextHubCommand(action, options = {}) {
                     console.error(`[${timestamp}] Failed to initialize memory system:`, err.message);
                     // Don't exit - memory is optional
                 }
+                // Start flow engine
+                try {
+                    const flowEngine = new FlowEngine(eventBus, projectRoot);
+                    const flowCount = await flowEngine.start();
+                    if (flowCount > 0) {
+                        console.log(`[${timestamp}] Flow engine started with ${flowCount} active flow(s)`);
+                    }
+                }
+                catch (err) {
+                    console.error(`[${timestamp}] Failed to start flow engine:`, err.message);
+                }
                 console.log(`[${timestamp}] MAP event bus initialized (buffer: 1000, subscribers: ${eventBus.getSubscriberCount()})`);
                 console.log(`[${timestamp}] Ready to serve requests`);
             });
@@ -1378,6 +1504,12 @@ export async function contextHubCommand(action, options = {}) {
                 console.log(`[${timestamp}] Received ${signal}`);
                 console.log(`[${timestamp}] PID: ${process.pid}, Parent PID: ${process.ppid}`);
                 console.log(`[${timestamp}] Shutting down...`);
+                telemetry.track({
+                    category: 'context_hub',
+                    event: 'context_hub:stopped',
+                    hub_port: port,
+                    hub_uptime_s: Math.floor((Date.now() - hubStartTime) / 1000),
+                });
                 server.close(() => {
                     eventBus.destroy();
                     console.log(`[${new Date().toISOString()}] Server closed`);