jfl 0.2.3 → 0.2.5

package/dist/commands/hooks.js

@@ -0,0 +1,304 @@
+/**
+ * jfl hooks - Manage Claude Code HTTP hooks for Context Hub
+ *
+ * Configures Claude Code to POST hook events to Context Hub's /api/hooks
+ * endpoint, bridging tool use, session lifecycle, and subagent events
+ * into the MAP event bus.
+ *
+ * @purpose CLI command to init/status/remove Claude Code HTTP hooks
+ */
+import chalk from "chalk";
+import * as fs from "fs";
+import * as path from "path";
+import { getProjectPort } from "../utils/context-hub-port.js";
+import { stringify as stringifyYaml } from "yaml";
+const HOOK_EVENTS = ["PostToolUse", "Stop", "PreCompact", "SubagentStart", "SubagentStop"];
+const DEFAULT_FLOWS_YAML = {
+    flows: [
+        {
+            name: "session-activity-log",
+            description: "Log tool use activity for session analysis",
+            enabled: true,
+            trigger: { pattern: "hook:tool-use" },
+            actions: [{ type: "log", message: "Tool used: {{data.tool_name}} on {{data.file_paths}}" }],
+        },
+        {
+            name: "session-end-summary",
+            description: "Emit summary event when session stops",
+            enabled: true,
+            trigger: { pattern: "hook:stop" },
+            actions: [{
+                    type: "emit",
+                    event_type: "session:ended",
+                    data: { source: "flow:session-end-summary", auto_captured: true },
+                }],
+        },
+    ],
+};
+function findProjectRoot() {
+    let dir = process.cwd();
+    while (dir !== path.dirname(dir)) {
+        if (fs.existsSync(path.join(dir, ".jfl", "config.json"))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+function resolvePort() {
+    const projectRoot = findProjectRoot();
+    if (projectRoot) {
+        const configPath = path.join(projectRoot, ".jfl", "config.json");
+        try {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            if (config.type === "service" && config.gtm_parent) {
+                const parentPort = getProjectPort(config.gtm_parent);
+                return parentPort;
+            }
+        }
+        catch { }
+    }
+    return getProjectPort(projectRoot || process.cwd());
+}
+function readSettings() {
+    const settingsPath = path.join(process.cwd(), ".claude", "settings.json");
+    if (!fs.existsSync(settingsPath)) {
+        return {};
+    }
+    return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+}
+function writeSettings(settings) {
+    const settingsDir = path.join(process.cwd(), ".claude");
+    if (!fs.existsSync(settingsDir)) {
+        fs.mkdirSync(settingsDir, { recursive: true });
+    }
+    fs.writeFileSync(path.join(settingsDir, "settings.json"), JSON.stringify(settings, null, 2) + "\n");
+}
+function isHttpHook(cmd) {
+    return cmd.type === "http";
+}
+async function initHooks() {
+    const port = resolvePort();
+    const hookUrl = `http://localhost:${port}/api/hooks`;
+    const settings = readSettings();
+    if (!settings.hooks) {
+        settings.hooks = {};
+    }
+    let added = 0;
+    for (const eventName of HOOK_EVENTS) {
+        if (!settings.hooks[eventName]) {
+            settings.hooks[eventName] = [];
+        }
+        const entries = settings.hooks[eventName];
+        const alreadyHasHttp = entries.some((entry) => entry.hooks?.some((h) => isHttpHook(h) && h.url?.includes("/api/hooks")));
+        if (alreadyHasHttp) {
+            continue;
+        }
+        entries.push({
+            matcher: "",
+            hooks: [{ type: "http", url: hookUrl }],
+        });
+        added++;
+    }
+    writeSettings(settings);
+    if (added > 0) {
+        console.log(chalk.green(`\n  HTTP hooks configured for ${added} events → ${hookUrl}\n`));
+    }
+    else {
+        console.log(chalk.yellow(`\n  HTTP hooks already configured → ${hookUrl}\n`));
+    }
+    console.log(chalk.gray("  Events:"));
+    for (const eventName of HOOK_EVENTS) {
+        console.log(chalk.gray(`    ${eventName}`));
+    }
+    console.log();
+    const flowsPath = path.join(process.cwd(), ".jfl", "flows.yaml");
+    if (!fs.existsSync(flowsPath)) {
+        const jflDir = path.join(process.cwd(), ".jfl");
+        if (!fs.existsSync(jflDir)) {
+            fs.mkdirSync(jflDir, { recursive: true });
+        }
+        fs.writeFileSync(flowsPath, stringifyYaml(DEFAULT_FLOWS_YAML, { lineWidth: 120 }));
+        console.log(chalk.green("  Default flows created → .jfl/flows.yaml"));
+        console.log(chalk.gray("  Run: jfl flows list"));
+        console.log();
+    }
+}
+async function statusHooks() {
+    const port = resolvePort();
+    const hookUrl = `http://localhost:${port}/api/hooks`;
+    const settings = readSettings();
+    console.log(chalk.bold("\n  Claude Code HTTP Hooks\n"));
+    console.log(chalk.gray("  Target: ") + chalk.cyan(hookUrl));
+    if (!settings.hooks) {
+        console.log(chalk.yellow("\n  No hooks configured.\n"));
+        return;
+    }
+    let httpCount = 0;
+    for (const [eventName, entries] of Object.entries(settings.hooks)) {
+        for (const entry of entries) {
+            for (const cmd of entry.hooks || []) {
+                if (isHttpHook(cmd)) {
+                    console.log(chalk.green("  ✓ ") + chalk.bold(eventName) + chalk.gray(` → ${cmd.url}`));
+                    httpCount++;
+                }
+            }
+        }
+    }
+    if (httpCount === 0) {
+        console.log(chalk.yellow("  No HTTP hooks found."));
+        console.log(chalk.gray("  Run: jfl hooks init"));
+    }
+    console.log();
+    try {
+        const response = await fetch(`http://localhost:${port}/health`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (response.ok) {
+            console.log(chalk.green("  Context Hub: running") + chalk.gray(` (port ${port})`));
+        }
+        else {
+            console.log(chalk.red("  Context Hub: not responding"));
+        }
+    }
+    catch {
+        console.log(chalk.red("  Context Hub: not running"));
+        console.log(chalk.gray("  Run: jfl context-hub start"));
+    }
+    console.log();
+}
+async function removeHooks() {
+    const settings = readSettings();
+    if (!settings.hooks) {
+        console.log(chalk.yellow("\n  No hooks configured.\n"));
+        return;
+    }
+    let removed = 0;
+    for (const [eventName, entries] of Object.entries(settings.hooks)) {
+        const filtered = entries.map((entry) => {
+            const originalLen = entry.hooks?.length || 0;
+            const kept = (entry.hooks || []).filter((cmd) => !isHttpHook(cmd));
+            removed += originalLen - kept.length;
+            return { ...entry, hooks: kept };
+        }).filter((entry) => entry.hooks.length > 0);
+        if (filtered.length > 0) {
+            settings.hooks[eventName] = filtered;
+        }
+        else {
+            delete settings.hooks[eventName];
+        }
+    }
+    writeSettings(settings);
+    if (removed > 0) {
+        console.log(chalk.green(`\n  Removed ${removed} HTTP hook(s). Shell hooks preserved.\n`));
+    }
+    else {
+        console.log(chalk.yellow("\n  No HTTP hooks found to remove.\n"));
+    }
+}
+async function deployHooks(all) {
+    const projectRoot = findProjectRoot();
+    if (!projectRoot) {
+        console.log(chalk.red("\n  Not in a JFL project. Run from a directory with .jfl/config.json\n"));
+        return;
+    }
+    const configPath = path.join(projectRoot, ".jfl", "config.json");
+    let config;
+    try {
+        config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        console.log(chalk.red("\n  Failed to read .jfl/config.json\n"));
+        return;
+    }
+    const services = config.registered_services || [];
+    if (services.length === 0) {
+        console.log(chalk.yellow("\n  No registered services found in .jfl/config.json"));
+        console.log(chalk.gray("  Register services with: jfl services register <path>\n"));
+        return;
+    }
+    console.log(chalk.bold(`\n  Deploying hooks to ${services.length} service(s)\n`));
+    let success = 0;
+    let skipped = 0;
+    let failed = 0;
+    for (const service of services) {
+        const servicePath = path.isAbsolute(service.path)
+            ? service.path
+            : path.resolve(projectRoot, service.path);
+        const serviceName = service.name || path.basename(servicePath);
+        if (!fs.existsSync(servicePath)) {
+            console.log(chalk.red(`  ✗ ${serviceName} — directory not found: ${servicePath}`));
+            failed++;
+            continue;
+        }
+        const settingsDir = path.join(servicePath, ".claude");
+        const settingsPath = path.join(settingsDir, "settings.json");
+        let settings = {};
+        if (fs.existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+            }
+            catch {
+                settings = {};
+            }
+        }
+        if (!settings.hooks) {
+            settings.hooks = {};
+        }
+        const port = getProjectPort(projectRoot);
+        const hookUrl = `http://localhost:${port}/api/hooks`;
+        let added = 0;
+        for (const eventName of HOOK_EVENTS) {
+            if (!settings.hooks[eventName]) {
+                settings.hooks[eventName] = [];
+            }
+            const entries = settings.hooks[eventName];
+            const alreadyHasHttp = entries.some((entry) => entry.hooks?.some((h) => h.type === "http" && h.url?.includes("/api/hooks")));
+            if (alreadyHasHttp)
+                continue;
+            entries.push({
+                matcher: "",
+                hooks: [{ type: "http", url: hookUrl }],
+            });
+            added++;
+        }
+        if (added === 0) {
+            console.log(chalk.gray(`  - ${serviceName} — hooks already configured`));
+            skipped++;
+            continue;
+        }
+        if (!fs.existsSync(settingsDir)) {
+            fs.mkdirSync(settingsDir, { recursive: true });
+        }
+        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+        console.log(chalk.green(`  ✓ ${serviceName} — ${added} hook events → ${hookUrl}`));
+        success++;
+    }
+    console.log(chalk.bold(`\n  Done: ${success} configured, ${skipped} already set, ${failed} failed\n`));
+}
+export { initHooks };
+export async function hooksCommand(action) {
+    switch (action) {
+        case "init":
+            await initHooks();
+            break;
+        case "status":
+            await statusHooks();
+            break;
+        case "remove":
+            await removeHooks();
+            break;
+        case "deploy":
+            await deployHooks(true);
+            break;
+        default:
+            console.log(chalk.bold("\n  jfl hooks - Claude Code HTTP hooks for Context Hub\n"));
+            console.log(chalk.gray("  Commands:"));
+            console.log("    jfl hooks init     Configure HTTP hooks in .claude/settings.json");
+            console.log("    jfl hooks status   Show configured hooks and hub connectivity");
+            console.log("    jfl hooks remove   Remove HTTP hooks (preserve shell hooks)");
+            console.log("    jfl hooks deploy   Deploy hooks to all registered services");
+            console.log();
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/commands/hooks.js.map

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

package/dist/commands/improve.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @purpose Self-improvement loop: analyze telemetry, generate suggestions, optionally create GitHub issues
+ */
+interface ImproveOptions {
+    dryRun?: boolean;
+    auto?: boolean;
+    hours?: string;
+}
+export declare function improveCommand(options: ImproveOptions): Promise<void>;
+export {};
+//# sourceMappingURL=improve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve.d.ts","sourceRoot":"","sources":["../../src/commands/improve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF3E"}

package/dist/commands/improve.js

@@ -0,0 +1,77 @@
+/**
+ * @purpose Self-improvement loop: analyze telemetry, generate suggestions, optionally create GitHub issues
+ */
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import { telemetry } from '../lib/telemetry.js';
+import { loadLocalEvents, analyzeEvents, generateSuggestions, formatDigest } from '../lib/telemetry-digest.js';
+export async function improveCommand(options) {
+    const hours = parseInt(options.hours || '24', 10) || 24;
+    const events = [
+        ...loadLocalEvents(),
+        ...telemetry.getSpilloverEvents(),
+    ];
+    const uniqueEvents = Array.from(new Map(events.map(e => [e.event_id, e])).values());
+    if (uniqueEvents.length === 0) {
+        console.log(chalk.gray('\n  No telemetry events found. Run some commands first.\n'));
+        return;
+    }
+    const digest = analyzeEvents(uniqueEvents, hours);
+    const suggestions = generateSuggestions(digest);
+    console.log(formatDigest(digest, 'text'));
+    if (suggestions.length === 0) {
+        console.log(chalk.green('\n  No improvement suggestions — everything looks healthy.\n'));
+        return;
+    }
+    const actionable = suggestions.filter(s => s.severity === 'high' || s.severity === 'medium');
+    console.log(chalk.bold(`\n  ${suggestions.length} Improvement Suggestions`));
+    console.log(chalk.gray(`  (${actionable.length} actionable)\n`));
+    for (const s of suggestions) {
+        const severityLabel = s.severity === 'high' ? chalk.red(`[${s.severity}]`) :
+            s.severity === 'medium' ? chalk.yellow(`[${s.severity}]`) :
+                chalk.gray(`[${s.severity}]`);
+        const typeLabel = chalk.cyan(`[${s.type}]`);
+        console.log(`  ${severityLabel} ${typeLabel} ${s.title}`);
+        console.log(chalk.gray(`    ${s.description}`));
+        console.log(chalk.white(`    Fix: ${s.suggestedFix}`));
+        console.log();
+    }
+    const hookSuggestions = suggestions.filter(s => s.type === 'usage');
+    if (hookSuggestions.length > 0) {
+        console.log(chalk.bold(`\n  Hook Insights`));
+        for (const s of hookSuggestions) {
+            console.log(chalk.cyan(`    ${s.title}`));
+            console.log(chalk.gray(`    ${s.description}\n`));
+        }
+    }
+    if (options.dryRun) {
+        console.log(chalk.gray(`  --dry-run: Would create ${actionable.length} GitHub issues.\n`));
+        return;
+    }
+    if (options.auto && actionable.length > 0) {
+        console.log(chalk.bold(`  Creating ${actionable.length} GitHub issues...\n`));
+        for (const s of actionable) {
+            try {
+                const title = `[jfl-improve] ${s.title}`;
+                const body = [
+                    `**Type:** ${s.type}`,
+                    `**Severity:** ${s.severity}`,
+                    '',
+                    s.description,
+                    '',
+                    `**Suggested Fix:** ${s.suggestedFix}`,
+                    '',
+                    `_Auto-generated by \`jfl improve\` at ${new Date().toISOString()}_`,
+                ].join('\n');
+                const result = execSync(`gh issue create --title "${title.replace(/"/g, '\\"')}" --body "${body.replace(/"/g, '\\"')}" --label "jfl-improve" 2>&1`, { encoding: 'utf-8', timeout: 15000 }).trim();
+                console.log(chalk.green(`  Created: ${result}`));
+            }
+            catch (err) {
+                const msg = err.stderr || err.message || 'Unknown error';
+                console.log(chalk.red(`  Failed to create issue for "${s.title}": ${msg}`));
+            }
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=improve.js.map

package/dist/commands/improve.js.map

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

package/dist/commands/scope.d.ts

@@ -0,0 +1,7 @@
+/**
+ * jfl scope — View and manage service context scopes
+ *
+ * @purpose CLI commands to view, set, and test context scope declarations
+ */
+export declare function scopeCommand(action?: string, ...args: string[]): Promise<void>;
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/commands/scope.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8NH,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpF"}

package/dist/commands/scope.js

@@ -0,0 +1,227 @@
+/**
+ * jfl scope — View and manage service context scopes
+ *
+ * @purpose CLI commands to view, set, and test context scope declarations
+ */
+import chalk from "chalk";
+import * as fs from "fs";
+import * as path from "path";
+function findProjectRoot() {
+    let dir = process.cwd();
+    while (dir !== path.dirname(dir)) {
+        if (fs.existsSync(path.join(dir, ".jfl", "config.json"))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+function loadConfig(root) {
+    const configPath = path.join(root, ".jfl", "config.json");
+    if (!fs.existsSync(configPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveConfig(root, config) {
+    const configPath = path.join(root, ".jfl", "config.json");
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+function formatScope(scope, indent = "  ") {
+    if (!scope)
+        return `${indent}${chalk.dim("(no scope declared — unrestricted)")}`;
+    const lines = [];
+    if (scope.produces?.length) {
+        lines.push(`${indent}${chalk.green("produces:")}`);
+        for (const p of scope.produces) {
+            lines.push(`${indent}  ${chalk.green("+")} ${p}`);
+        }
+    }
+    if (scope.consumes?.length) {
+        lines.push(`${indent}${chalk.cyan("consumes:")}`);
+        for (const c of scope.consumes) {
+            lines.push(`${indent}  ${chalk.cyan("←")} ${c}`);
+        }
+    }
+    if (scope.denied?.length) {
+        lines.push(`${indent}${chalk.red("denied:")}`);
+        for (const d of scope.denied) {
+            lines.push(`${indent}  ${chalk.red("✗")} ${d}`);
+        }
+    }
+    return lines.length > 0 ? lines.join("\n") : `${indent}${chalk.dim("(empty scope)")}`;
+}
+async function listScopes() {
+    const root = findProjectRoot();
+    if (!root) {
+        console.log(chalk.red("Not in a JFL project"));
+        return;
+    }
+    const config = loadConfig(root);
+    if (!config) {
+        console.log(chalk.red("No .jfl/config.json found"));
+        return;
+    }
+    console.log(chalk.bold("\nContext Scopes"));
+    console.log(chalk.dim("─".repeat(50)));
+    // Show this workspace's scope
+    console.log(`\n${chalk.bold(config.name || "this workspace")} ${chalk.dim(`(${config.type})`)}`);
+    console.log(formatScope(config.context_scope));
+    // Show registered services' scopes
+    const services = config.registered_services || [];
+    if (services.length === 0) {
+        console.log(chalk.dim("\nNo registered services"));
+        return;
+    }
+    for (const svc of services) {
+        const status = svc.status === "active" ? chalk.green("active") : chalk.dim("inactive");
+        console.log(`\n${chalk.bold(svc.name)} ${chalk.dim("—")} ${status}`);
+        // Check the service's own config for scope
+        const svcConfigPath = path.join(svc.path, ".jfl", "config.json");
+        let svcScope = svc.context_scope;
+        if (!svcScope && fs.existsSync(svcConfigPath)) {
+            try {
+                const svcConfig = JSON.parse(fs.readFileSync(svcConfigPath, "utf-8"));
+                svcScope = svcConfig.context_scope;
+            }
+            catch {
+                // skip
+            }
+        }
+        console.log(formatScope(svcScope));
+    }
+    console.log();
+}
+async function setScope(serviceName, scopeType, patterns) {
+    const root = findProjectRoot();
+    if (!root) {
+        console.log(chalk.red("Not in a JFL project"));
+        return;
+    }
+    const config = loadConfig(root);
+    if (!config) {
+        console.log(chalk.red("No .jfl/config.json found"));
+        return;
+    }
+    if (!["produces", "consumes", "denied"].includes(scopeType)) {
+        console.log(chalk.red(`Invalid scope type: ${scopeType}. Must be: produces, consumes, denied`));
+        return;
+    }
+    // Find the service
+    if (serviceName === "self" || serviceName === config.name) {
+        if (!config.context_scope)
+            config.context_scope = {};
+        config.context_scope[scopeType] = patterns;
+        saveConfig(root, config);
+        console.log(chalk.green(`Updated ${config.name || "workspace"} scope.${scopeType}`));
+        return;
+    }
+    const services = config.registered_services || [];
+    const svc = services.find(s => s.name === serviceName);
+    if (!svc) {
+        console.log(chalk.red(`Service "${serviceName}" not found. Available: ${services.map(s => s.name).join(", ")}`));
+        return;
+    }
+    if (!svc.context_scope)
+        svc.context_scope = {};
+    svc.context_scope[scopeType] = patterns;
+    saveConfig(root, config);
+    // Also update the service's own config if it exists
+    const svcConfigPath = path.join(svc.path, ".jfl", "config.json");
+    if (fs.existsSync(svcConfigPath)) {
+        try {
+            const svcConfig = JSON.parse(fs.readFileSync(svcConfigPath, "utf-8"));
+            if (!svcConfig.context_scope)
+                svcConfig.context_scope = {};
+            svcConfig.context_scope[scopeType] = patterns;
+            fs.writeFileSync(svcConfigPath, JSON.stringify(svcConfig, null, 2) + "\n");
+        }
+        catch {
+            // non-fatal
+        }
+    }
+    console.log(chalk.green(`Updated ${serviceName} scope.${scopeType}: [${patterns.join(", ")}]`));
+}
+async function testScope(serviceName, eventType, eventSource) {
+    const root = findProjectRoot();
+    if (!root) {
+        console.log(chalk.red("Not in a JFL project"));
+        return;
+    }
+    const config = loadConfig(root);
+    if (!config) {
+        console.log(chalk.red("No .jfl/config.json found"));
+        return;
+    }
+    const services = config.registered_services || [];
+    const svc = services.find(s => s.name === serviceName);
+    const scope = svc?.context_scope || (serviceName === "self" ? config.context_scope : undefined);
+    if (!scope) {
+        console.log(chalk.yellow(`${serviceName}: No scope declared — event would be ${chalk.green("ALLOWED")} (unrestricted)`));
+        return;
+    }
+    // Check denied
+    const denied = scope.denied || [];
+    for (const pattern of denied) {
+        if (matchScopePattern(pattern, eventType) || matchScopePattern(pattern, eventSource)) {
+            console.log(chalk.red(`${serviceName}: event "${eventType}" from "${eventSource}" — DENIED by pattern "${pattern}"`));
+            return;
+        }
+    }
+    // Check consumes
+    const consumes = scope.consumes || [];
+    if (consumes.length > 0) {
+        const allowed = consumes.some(p => matchScopePattern(p, eventType) || matchScopePattern(p, eventSource));
+        if (!allowed) {
+            console.log(chalk.red(`${serviceName}: event "${eventType}" from "${eventSource}" — NOT in consumes list`));
+            return;
+        }
+    }
+    console.log(chalk.green(`${serviceName}: event "${eventType}" from "${eventSource}" — ALLOWED`));
+}
+function matchScopePattern(pattern, value) {
+    if (pattern === "*")
+        return true;
+    if (pattern === value)
+        return true;
+    if (pattern.includes("*")) {
+        const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+        return regex.test(value);
+    }
+    return false;
+}
+export async function scopeCommand(action, ...args) {
+    switch (action) {
+        case "list":
+        case undefined:
+            await listScopes();
+            break;
+        case "set": {
+            const [serviceName, scopeType, ...patterns] = args;
+            if (!serviceName || !scopeType || patterns.length === 0) {
+                console.log(chalk.yellow("Usage: jfl scope set <service> <produces|consumes|denied> <pattern1> [pattern2] ..."));
+                console.log(chalk.dim('  Example: jfl scope set seo-agent denied "team-journals:*" "shadow:*"'));
+                return;
+            }
+            await setScope(serviceName, scopeType, patterns);
+            break;
+        }
+        case "test": {
+            const [serviceName, eventType, eventSource] = args;
+            if (!serviceName || !eventType) {
+                console.log(chalk.yellow("Usage: jfl scope test <service> <event-type> [event-source]"));
+                console.log(chalk.dim('  Example: jfl scope test seo-agent journal:entry journal:productrank-lobsters'));
+                return;
+            }
+            await testScope(serviceName, eventType, eventSource || "unknown");
+            break;
+        }
+        default:
+            console.log(chalk.yellow("Unknown action. Usage: jfl scope [list|set|test]"));
+    }
+}
+//# sourceMappingURL=scope.js.map