jfl 0.8.1 → 0.9.1

package/dist/index.js

@@ -28,12 +28,37 @@ async function getTelemetry() {
 import("./utils/jfl-migration.js").then(mod => mod.checkAndMigrate({ silent: true })).catch(() => { });
 const program = new Command();
 // Telemetry hooks — auto-track all commands (lazy load telemetry)
-program.hook('preAction', (_thisCommand, actionCommand) => {
+program.hook('preAction', async (_thisCommand, actionCommand) => {
     ;
     actionCommand.__telemetryStart = Date.now();
+    // ResourceOptimizer: decide() before every command (<5ms)
+    try {
+        const { resourceOptimizerPreAction, applyGuidance } = await import("./lib/resource-optimizer-middleware.js");
+        const guidance = await resourceOptimizerPreAction(actionCommand.name());
+        actionCommand.__roGuidance = guidance;
+        // Apply guidance (delay if thermal/CPU issue)
+        if (guidance.action !== "passthrough" && guidance.action !== "monitor") {
+            await applyGuidance(guidance);
+            if (guidance.delay_ms > 0) {
+                const chalk = (await import("chalk")).default;
+                console.log(chalk.yellow(`  ⚡ ${guidance.reason}`));
+            }
+        }
+    }
+    catch {
+        // Never block commands for RO failures
+    }
 });
 program.hook('postAction', async (_thisCommand, actionCommand) => {
     const start = actionCommand.__telemetryStart;
+    // ResourceOptimizer: record transition after every command
+    try {
+        const { resourceOptimizerPostAction } = await import("./lib/resource-optimizer-middleware.js");
+        await resourceOptimizerPostAction(actionCommand.name(), process.cwd());
+    }
+    catch {
+        // Non-blocking
+    }
     // Lazy load telemetry only when actually tracking
     const telemetry = await getTelemetry();
     telemetry.track({
@@ -45,7 +70,7 @@ program.hook('postAction', async (_thisCommand, actionCommand) => {
     });
 });
 const HELP_GROUPS = {
-    "Getting Started": ["init", "status", "hud", "ide", "doctor"],
+    "Getting Started": ["init", "status", "whoami", "hud", "ide", "doctor"],
     "Daily Use": ["synopsis", "ask", "improve", "events", "voice", "kanban"],
     "Management": ["services", "portfolio", "flows", "hooks", "scope", "memory", "eval", "findings", "viz", "telemetry", "context-hub", "skills", "ci"],
     "Platform": ["login", "deploy", "wallet", "preferences"],
@@ -151,6 +176,19 @@ program
 // ============================================================================
 // FREE TIER COMMANDS (work offline/standalone)
 // ============================================================================
+program
+    .command("start")
+    .description("One-command activation: init → setup → launch (zero to intelligence in <2 min)")
+    .argument("[name]", "Project name or path")
+    .option("--repo <path>", "Analyze existing repo and create GTM workspace")
+    .option("--pi", "Launch Pi instead of Claude Code")
+    .option("--ci", "Deploy CI workflows (eval + review)")
+    .option("-s, --service <path...>", "Service repo paths/URLs to onboard (repeatable)")
+    .option("--no-launch", "Don't launch editor after setup")
+    .action(async (name, options) => {
+    const { startCommand } = await import("./commands/start.js");
+    await startCommand(name, options);
+});
 program
     .command("init")
     .description("Initialize a new JFL project")
@@ -159,6 +197,7 @@ program
     .option("-d, --description <desc>", "Project description")
     .option("--product-repo <url>", "Product repo URL (for gtm type)")
     .option("-s, --service <path...>", "Service repo paths/URLs to onboard (repeatable)")
+    .option("--from-service", "Deep-analyze current directory and create GTM in sibling directory")
     .option("--ci", "Deploy eval + review CI workflows after init")
     .option("--no-interactive", "Skip all prompts, use defaults")
     .option("--no-search", "Skip search setup")
@@ -209,9 +248,18 @@ program
     const { statusCommand } = await import("./commands/status.js");
     await statusCommand();
 });
-// IDE workspace command — uses dynamic imports to avoid linter stripping
-const ide = program.command("ide").description("Terminal workspace — cmux/tmux with live sidebar data and notifications");
-ide.command("launch", { isDefault: true }).description("Launch workspace (default)").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/ide.js"); await m.ideLaunchCommand(options); });
+program
+    .command("whoami")
+    .description("Print current user and project info")
+    .action(async () => {
+    const { whoamiCommand } = await import("./commands/whoami.js");
+    whoamiCommand();
+});
+// RL learning agents now accessible via: jfl agents rl <action>
+// (integrated into existing agents command)
+// IDE workspace command — uses dynamic imports to avoid linter stripping  
+const ide = program.command("ide").description("Launch smart development environment (jfl ide) or manage workspace (jfl ide <command>)");
+ide.command("launch", { isDefault: true }).description("Launch workspace (same as 'jfl ide')").option("--json", "Output as JSON").option("--sidebar", "Include sidebar pane (20% width)").action(async (options) => { const m = await import("./commands/ide.js"); await m.ideLaunchCommand(options); });
 ide.command("add").description("Add a surface to the workspace").argument("[name]", "Surface name (agent, built-in type, or service)").option("--row <n>", "Row index (0-based)").option("--position <n>", "Position within row (0-based)").option("--title <title>", "Custom surface title").option("--cmd <command>", "Custom surface command").action(async (name, options) => { const m = await import("./commands/ide.js"); await m.ideAddCommand(name, options); });
 ide.command("remove").description("Remove a surface from the workspace").argument("<name>", "Surface name or title to remove").action(async (name) => { const m = await import("./commands/ide.js"); await m.ideRemoveCommand(name); });
 ide.command("available").description("List available surface types, agents, and services").action(async () => { const m = await import("./commands/ide.js"); await m.ideAvailableCommand(); });
@@ -565,13 +613,23 @@ program
 });
 program
     .command("agents")
-    .description("Manage parallel agents")
-    .argument("[action]", "Action: list, create, start, stop, destroy")
+    .description("Manage parallel agents and RL learning agents")
+    .argument("[action]", "Action: list, create, start, stop, destroy, rl")
+    .argument("[subaction]", "For 'rl': status, dashboard, train, tune, feedback, explain")
     .option("-n, --name <name>", "Agent name")
     .option("-t, --task <task>", "Task for agent")
-    .action(async (action, options) => {
-    const { agentsCommand } = await import("./commands/agents.js");
-    await agentsCommand(action, options);
+    .option("--agent <name>", "Target specific RL agent")
+    .option("--insight-id <id>", "Insight ID for RL agent feedback")
+    .option("--feedback <type>", "RL agent feedback: helpful, not_helpful, needs_adjustment")
+    .action(async (action, subaction, options) => {
+    if (action === 'rl') {
+        const { tenentAgentsCommand } = await import("./commands/tenet-agents.js");
+        await tenentAgentsCommand(subaction, options);
+    }
+    else {
+        const { agentsCommand } = await import("./commands/agents.js");
+        await agentsCommand(action, options);
+    }
 });
 program
     .command("feedback")
@@ -1059,24 +1117,73 @@ ci.action(() => {
 // ============================================================================
 // EVAL FRAMEWORK
 // ============================================================================
-registerEvalCommand(program);
-registerPredictCommand(program);
-registerPortfolioCommand(program);
-registerVizCommand(program);
-registerFindingsCommand(program);
-registerVerifyCommand(program);
+// Lazy command registration — modules loaded only when command is invoked
+// (was: registerXxxCommand eager imports adding ~200ms to startup)
+// --- eval ---
+const evalCmd = program.command("eval").description("Eval framework — track agent metrics over time");
+evalCmd.command("list").description("List recent eval entries").option("--agent <name>", "Filter by agent name").option("--limit <n>", "Max entries to show", "20").action(async (options) => { const m = await import("./commands/eval.js"); await m.listCommand(options); });
+evalCmd.command("trajectory").description("Show metric trajectory over time").requiredOption("--agent <name>", "Agent name").option("--metric <name>", "Metric to plot (default: composite)").action(async (options) => { const m = await import("./commands/eval.js"); await m.trajectoryCommand(options); });
+evalCmd.command("log").description("Log an eval entry").requiredOption("--agent <name>", "Agent name").requiredOption("--metrics <json>", "Metrics as JSON object").option("--composite <n>", "Composite score").option("--model-version <v>", "Model version").option("--dataset <ds>", "Dataset name").option("--run-id <id>", "Run ID").option("--notes <text>", "Notes").action(async (options) => { const m = await import("./commands/eval.js"); await m.logCommand(options); });
+evalCmd.command("compare").description("Compare agents side-by-side").requiredOption("--agents <list>", "Comma-separated agent names").option("--metric <name>", "Metric to compare (default: composite)").action(async (options) => { const m = await import("./commands/eval.js"); await m.compareCommand(options); });
+evalCmd.command("tuples").description("Extract training tuples from journals").option("--team <name>", "Filter by team").option("--since <date>", "Only tuples after this date").option("--report", "Full markdown report").action(async (options) => { const m = await import("./commands/eval.js"); await m.tuplesCommand(options); });
+evalCmd.command("buffer").description("View or export RL training buffer (.jfl/training-buffer.jsonl)").option("--export", "Export as JSONL for policy head training").option("--limit <n>", "Max entries to show", "10").action(async (options) => { const m = await import("./commands/eval.js"); await m.bufferCommand(options); });
+evalCmd.command("mine").description("Mine training tuples from journals, events, telemetry, and eval history").option("--all", "Scan all JFL projects (from ~/.config/jfl/config.json)").option("--telemetry", "Include global telemetry archive (58k+ events)").option("--dry-run", "Show what would be mined without writing").option("--dir <path>", "Specific directory to mine").action(async (options) => { const m = await import("./commands/eval.js"); await m.mineCommand(options); });
+evalCmd.command("train").description("Train policy head from training buffer (requires STRATUS_API_KEY)").option("--epochs <n>", "Training epochs", "50").option("--lr <rate>", "Learning rate", "0.0001").action(async (options) => { const m = await import("./commands/eval.js"); await m.trainCommand(options); });
+evalCmd.action(async () => { const m = await import("./commands/eval.js"); await m.listCommand({}); });
+// --- predict ---
+const predictCmd = program.command("predict").description("Predict eval score delta before executing changes (Stratus world model)");
+predictCmd.command("run").description("Generate a prediction for a proposed change").requiredOption("--proposal <text>", "Description of the proposed change").requiredOption("--goal <text>", "Goal expression (e.g. 'test_pass_rate > 0.9')").option("--score <n>", "Current composite score", "0").option("--type <type>", "Change type: fix, refactor, feature, config", "fix").option("--scope <scope>", "Change scope: small, medium, large", "medium").option("--files <list>", "Comma-separated affected files").option("--failing-evals <list>", "Comma-separated failing eval names").action(async (options) => { const m = await import("./commands/predict.js"); await m.predictCommand(options); });
+predictCmd.command("resolve").description("Resolve a prediction with actual results").requiredOption("--id <prediction_id>", "Prediction ID to resolve").requiredOption("--actual-delta <n>", "Actual score delta").requiredOption("--actual-score <n>", "Actual final score").requiredOption("--eval-run <id>", "Eval run ID").action(async (options) => { const m = await import("./commands/predict.js"); await m.resolveCommand({ resolve: options.id, actualDelta: options.actualDelta, actualScore: options.actualScore, evalRun: options.evalRun }); });
+predictCmd.command("accuracy").description("Show prediction accuracy statistics").action(async () => { const m = await import("./commands/predict.js"); await m.accuracyCommand(); });
+predictCmd.command("history").description("Show recent predictions").option("--limit <n>", "Max entries to show", "20").action(async (options) => { const m = await import("./commands/predict.js"); await m.historyCommand(options); });
+predictCmd.action(async () => { console.log(chalk.bold("\n  Stratus Prediction Engine\n")); console.log(chalk.gray("  Commands:")); console.log(chalk.gray('    jfl predict run --proposal "..." --goal "..."  Generate prediction')); console.log(chalk.gray("    jfl predict resolve --id <id> ...              Resolve with actuals")); console.log(chalk.gray("    jfl predict accuracy                           Show accuracy stats")); console.log(chalk.gray("    jfl predict history                            Recent predictions")); console.log(); });
+// --- portfolio ---
+const portfolioCmd = program.command("portfolio").description("Manage portfolio of GTM workspaces");
+portfolioCmd.command("register <path>").description("Register a GTM workspace in this portfolio").action(async (gtmPath) => { const m = await import("./commands/portfolio.js"); await m.portfolioRegisterCommand(gtmPath); });
+portfolioCmd.command("list").description("List registered GTM workspaces").action(async () => { const m = await import("./commands/portfolio.js"); await m.portfolioListCommand(); });
+portfolioCmd.command("unregister <name>").description("Remove a GTM workspace from this portfolio").action(async (name) => { const m = await import("./commands/portfolio.js"); await m.portfolioUnregisterCommand(name); });
+portfolioCmd.command("status").description("Portfolio health and eval summary").action(async () => { const m = await import("./commands/portfolio.js"); await m.portfolioStatusCommand(); });
+portfolioCmd.command("phone-home").description("Sync this GTM's journals and activity to its portfolio parent").action(async () => { const m = await import("./commands/portfolio.js"); await m.portfolioPhoneHomeCommand(); });
+// --- viz ---
+const vizCmd = program.command("viz").description("Terminal visualizations — headless dashboard data via Context Hub");
+vizCmd.command("experiments").description("Show experiment runs with dot plot, sparklines, and score table").option("--agent <name>", "Filter to a specific agent").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.experimentsCommand(options); });
+vizCmd.command("leaderboard").description("Ranked agent leaderboard with sparklines and bar chart").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.leaderboardCommand(options); });
+vizCmd.command("flows").description("Flow definitions and pending executions").option("--pending", "Show only pending approval executions").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.flowsVizCommand(options); });
+vizCmd.command("events").description("Recent event stream with type coloring").option("--pattern <pattern>", "Filter events by type pattern").option("--limit <n>", "Max events to show", "20").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.eventsCommand(options); });
+vizCmd.command("status").description("Hub health, children, sources, item count").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.statusCommand(options); });
+vizCmd.command("dash").description("Composite dashboard — leaderboard, pending flows, events, status").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.dashCommand(options); });
+vizCmd.command("loop").description("Self-driving loop pipeline — detect, propose, eval, merge, learn").option("--days <n>", "Lookback period in days", "7").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.loopCommand(options); });
+vizCmd.command("learning").description("Policy head learning curve — tuples, accuracy, action rewards").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.learningCommand(options); });
+vizCmd.command("fleet").description("VM fleet status — parallel agent waves and tuple collection").option("--wave <id>", "Filter to a specific wave ID").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/viz.js"); await m.fleetCommand(options); });
+vizCmd.action(async () => { const m = await import("./commands/viz.js"); await m.dashCommand({}); });
+// --- findings ---
+const findingsCmd = program.command("findings").description("Surface and fix problems automatically");
+findingsCmd.command("list", { isDefault: true }).description("List current findings").option("--refresh", "Re-analyze before listing").option("--all", "Include dismissed findings").action(async (options) => { const m = await import("./commands/findings.js"); await m.listCommand(options); });
+findingsCmd.command("fix <n>").description("Spawn an agent to fix finding #n").action(async (n) => { const m = await import("./commands/findings.js"); await m.fixCommand(n); });
+findingsCmd.command("dismiss <n>").description("Dismiss finding #n").action(async (n) => { const m = await import("./commands/findings.js"); await m.dismissCommand(n); });
+findingsCmd.command("analyze").description("Force re-analyze the project").action(async () => { const m = await import("./commands/findings.js"); await m.analyzeCommand(); });
+findingsCmd.action(async () => { const m = await import("./commands/findings.js"); await m.listCommand({}); });
+// --- verify ---
+program.command("verify").description("Run TLA+ model checking on system specs")
+    .option("-s, --spec <name>", "Check a specific spec (default: all)")
+    .option("-t, --timeout <seconds>", "TLC timeout in seconds", "120")
+    .option("--apalache", "Use Apalache (symbolic bounded) instead of TLC")
+    .option("-v, --verbose", "Show full TLC output")
+    .option("--json", "Output results as JSON (pipe-friendly)")
+    .action(async (options) => { const m = await import("./commands/verify.js"); await m.verifyCommand({ ...options, timeout: parseInt(options.timeout) }); });
 // ============================================================================
 // TELEMETRY
 // ============================================================================
 const telemetryCmd = program.command("telemetry").description("Manage anonymous usage telemetry");
-import { registerDigestCommand } from "./commands/digest.js";
-import { registerEvalCommand } from "./commands/eval.js";
-import { registerFindingsCommand } from "./commands/findings.js";
-import { registerPortfolioCommand } from "./commands/portfolio.js";
-import { registerPredictCommand } from "./commands/predict.js";
-import { registerVizCommand } from "./commands/viz.js";
-import { registerVerifyCommand } from "./commands/verify.js";
-registerDigestCommand(telemetryCmd);
+// Digest command registered lazily (was: registerDigestCommand)
+telemetryCmd
+    .command('digest')
+    .description('Analyze telemetry events: costs, stats, and suggestions')
+    .option('--hours <hours>', 'Analysis period in hours', '24')
+    .option('--format <format>', 'Output format: text or json', 'text')
+    .option('--plots', 'Render terminal charts for key metrics')
+    .option('--platform', 'Include platform-side data (requires network)')
+    .action(async (options) => { const m = await import("./commands/digest.js"); await m.digestCommand(options); });
 telemetryCmd
     .command("status")
     .description("Show telemetry status")
@@ -1145,6 +1252,27 @@ telemetryCmd
     });
     await telemetry.flush();
 });
+telemetryCmd
+    .command("monitor")
+    .description("Monitor physical-world telemetry data in real-time")
+    .option("--live", "Live monitoring with auto-refresh")
+    .option("--compact", "Compact display mode")
+    .option("--interval <seconds>", "Update interval in seconds (default: 5)", "5")
+    .option("--filter <pattern>", "Filter events by category, event name, or content")
+    .action(async (options) => {
+    const { telemetryMonitorCommand } = await import("./commands/telemetry-monitor.js");
+    await telemetryMonitorCommand(options);
+});
+telemetryCmd
+    .command("test")
+    .description("Generate test physical-world telemetry data (for testing)")
+    .option("--count <n>", "Number of events to generate (default: 10)", "10")
+    .option("--interval <ms>", "Interval between events in ms (default: 1000)", "1000")
+    .option("--categories <list>", "Comma-separated event categories (default: command,performance,session)")
+    .action(async (options) => {
+    const { telemetryTestCommand } = await import("./commands/telemetry-test.js");
+    await telemetryTestCommand(options);
+});
 // Default telemetry action
 telemetryCmd.action(async () => {
     // Show status by default
@@ -1157,10 +1285,11 @@ telemetryCmd.action(async () => {
         console.log(chalk.gray("  Install ID: ") + chalk.cyan(installId));
     }
     console.log(chalk.gray("\n  Commands:"));
-    console.log("    jfl telemetry status   Show detailed status");
-    console.log("    jfl telemetry show     Show queued events");
-    console.log("    jfl telemetry digest   Cost and health analysis");
-    console.log("    jfl telemetry reset    Reset install ID");
+    console.log("    jfl telemetry status    Show detailed status");
+    console.log("    jfl telemetry show      Show queued events");
+    console.log("    jfl telemetry digest    Cost and health analysis");
+    console.log("    jfl telemetry monitor   Monitor physical-world data");
+    console.log("    jfl telemetry reset     Reset install ID");
     console.log();
 });
 // ============================================================================
@@ -1183,9 +1312,10 @@ program
     .command("doctor")
     .description("Check project health and auto-repair")
     .option("--fix", "Auto-repair fixable issues")
+    .option("--json", "Output structured JSON (machine-readable)")
     .action(async (options) => {
     const { doctorCommand } = await import("./commands/doctor.js");
-    await doctorCommand({ fix: options.fix });
+    await doctorCommand({ fix: options.fix, json: options.json });
 });
 // ============================================================================
 // TRAIN (policy head training pipeline)
@@ -1297,7 +1427,7 @@ agent.action(async () => {
 // ============================================================================
 program
     .command("setup")
-    .description("Auto-configure RL agents from project context")
+    .description("Progressive intelligent setup - personalized RL agents based on your development patterns")
     .option("--dry-run", "Show recommendations without writing files")
     .option("-f, --force", "Proceed even if readiness check fails")
     .option("--from-violations", "Generate agents from TLC invariant violations")
@@ -1455,6 +1585,76 @@ kanban
     const { kanbanBootstrap } = await import("./commands/kanban.js");
     await kanbanBootstrap(process.cwd(), options);
 });
+// ============================================================================
+// Linear
+// ============================================================================
+const linear = program
+    .command("linear")
+    .description("Sync with Linear — bidirectional issue sync (GitHub ↔ Linear)");
+linear
+    .command("link")
+    .description("Link a Linear project to this workspace")
+    .action(async () => {
+    const { findProjectRoot: fpr } = await import("./utils/jfl-config.js");
+    const root = fpr(process.cwd());
+    if (!root) {
+        console.error(chalk.red("Not in a JFL project. Run jfl init first."));
+        process.exit(1);
+    }
+    const { linearLink } = await import("./commands/linear.js");
+    await linearLink(root);
+});
+linear
+    .command("unlink")
+    .description("Unlink the Linear project")
+    .action(async () => {
+    const { findProjectRoot: fpr } = await import("./utils/jfl-config.js");
+    const root = fpr(process.cwd());
+    if (!root) {
+        console.error(chalk.red("Not in a JFL project."));
+        process.exit(1);
+    }
+    const { linearUnlink } = await import("./commands/linear.js");
+    await linearUnlink(root);
+});
+linear
+    .command("status")
+    .description("Show Linear sync state and mapped issues")
+    .action(async () => {
+    const { findProjectRoot: fpr } = await import("./utils/jfl-config.js");
+    const root = fpr(process.cwd()) ?? process.cwd();
+    const { linearStatus } = await import("./commands/linear.js");
+    await linearStatus(root);
+});
+linear
+    .command("sync")
+    .description("Bidirectional sync: GitHub Issues ↔ Linear")
+    .option("--direction <dir>", "Sync direction: github, linear, or both (default: both)", "both")
+    .option("--dry-run", "Preview changes without applying them")
+    .option("--json", "Output structured JSON (for CI and agents)")
+    .action(async (options) => {
+    const { findProjectRoot: fpr } = await import("./utils/jfl-config.js");
+    const root = fpr(process.cwd());
+    if (!root) {
+        console.error(chalk.red("Not in a JFL project."));
+        process.exit(1);
+    }
+    const { linearSync } = await import("./commands/linear.js");
+    await linearSync(root, { direction: options.direction, dryRun: options.dryRun, json: options.json });
+});
+linear
+    .command("bootstrap")
+    .description("Deploy GitHub Actions sync workflow + set secrets (one-time setup)")
+    .action(async () => {
+    const { findProjectRoot: fpr } = await import("./utils/jfl-config.js");
+    const root = fpr(process.cwd());
+    if (!root) {
+        console.error(chalk.red("Not in a JFL project."));
+        process.exit(1);
+    }
+    const { linearBootstrap } = await import("./commands/linear.js");
+    await linearBootstrap(root);
+});
 // Parse and run
 program.parse();
 //# sourceMappingURL=index.js.map