jfl 0.4.3 → 0.5.0

package/dist/index.js

@@ -12,47 +12,30 @@ import { readFileSync } from "fs";
 import { join } from "path";
 import * as path from "path";
 import { fileURLToPath } from "url";
-import { doctorCommand } from "./commands/doctor.js";
-import { agentCommand } from "./commands/agent.js";
-import { initCommand } from "./commands/init.js";
-import { repairCommand } from "./commands/repair.js";
-import { validateSettingsCommand } from "./commands/validate-settings.js";
-import { loginCommand, logout } from "./commands/login.js";
-import { statusCommand } from "./commands/status.js";
-import { deployCommand } from "./commands/deploy.js";
-import { agentsCommand } from "./commands/agents.js";
-import { hudCommand } from "./commands/hud.js";
-import { sessionCommand } from "./commands/session.js";
-import { feedbackCommand } from "./commands/feedback.js";
-import { updateCommand } from "./commands/update.js";
-import { contextHubCommand } from "./commands/context-hub.js";
-import { hooksCommand } from "./commands/hooks.js";
-import { flowsCommand } from "./commands/flows.js";
-import { scopeCommand } from "./commands/scope.js";
-import { voiceCommand } from "./commands/voice.js";
-import { synopsisCommand } from "./commands/synopsis.js";
-import { onboardCommand } from "./commands/onboard.js";
-import { profileCommand } from "./commands/profile.js";
-import { migrateServices } from "./commands/migrate-services.js";
-import { memoryInitCommand, memoryStatusCommand, memorySearchCommand, memoryIndexCommand } from "./commands/memory.js";
-import { listSkillsCommand, installSkillCommand, removeSkillCommand, updateSkillsCommand, searchSkillsCommand, } from "./commands/skills.js";
-import { ralphCommand, showRalphHelp } from "./commands/ralph.js";
-import { peterCommand } from "./commands/peter.js";
-import { clawdbotSetupCommand, clawdbotStatusCommand } from "./commands/clawdbot.js";
-import { showDayPassStatus, hasWallet, getWalletAddress, } from "./utils/auth-guard.js";
-import { checkAndMigrate } from "./utils/jfl-migration.js";
+// Lazy imports - only load when needed to reduce startup latency
+// All commands use dynamic import() to defer loading until invoked
 import { JFL_PATHS } from "./utils/jfl-paths.js";
-import { telemetry } from "./lib/telemetry.js";
-// Auto-migrate from ~/.jfl/ to XDG directories if needed
-await checkAndMigrate({ silent: true });
+// Telemetry loaded lazily on first track() call
+let _telemetry;
+async function getTelemetry() {
+    if (!_telemetry) {
+        const mod = await import("./lib/telemetry.js");
+        _telemetry = mod.telemetry;
+    }
+    return _telemetry;
+}
+// Migration check runs in background, doesn't block startup
+import("./utils/jfl-migration.js").then(mod => mod.checkAndMigrate({ silent: true })).catch(() => { });
 const program = new Command();
-// Telemetry hooks — auto-track all commands
+// Telemetry hooks — auto-track all commands (lazy load telemetry)
 program.hook('preAction', (_thisCommand, actionCommand) => {
     ;
     actionCommand.__telemetryStart = Date.now();
 });
-program.hook('postAction', (_thisCommand, actionCommand) => {
+program.hook('postAction', async (_thisCommand, actionCommand) => {
     const start = actionCommand.__telemetryStart;
+    // Lazy load telemetry only when actually tracking
+    const telemetry = await getTelemetry();
     telemetry.track({
         category: 'command',
         event: `command:${actionCommand.name()}`,
@@ -62,9 +45,9 @@ program.hook('postAction', (_thisCommand, actionCommand) => {
     });
 });
 const HELP_GROUPS = {
-    "Getting Started": ["init", "status", "hud", "doctor"],
+    "Getting Started": ["init", "status", "hud", "ide", "doctor"],
     "Daily Use": ["synopsis", "ask", "improve", "events", "voice"],
-    "Management": ["services", "portfolio", "flows", "hooks", "scope", "memory", "eval", "viz", "telemetry", "context-hub", "skills", "ci"],
+    "Management": ["services", "portfolio", "flows", "hooks", "scope", "memory", "eval", "findings", "viz", "telemetry", "context-hub", "skills", "ci"],
     "Platform": ["login", "deploy", "wallet", "preferences"],
     "Advanced": ["peter", "orchestrate", "openclaw", "ralph", "agent"],
 };
@@ -158,9 +141,11 @@ program
     .action(async (options) => {
     // Always update on session start (unless --no-update flag)
     if (options.update !== false) {
+        const { updateCommand } = await import("./commands/update.js");
         await updateCommand({ autoUpdate: true });
         console.log(); // Add spacing before session starts
     }
+    const { sessionCommand } = await import("./commands/session.js");
     await sessionCommand({});
 });
 // ============================================================================
@@ -170,26 +155,55 @@ program
     .command("init")
     .description("Initialize a new JFL project")
     .option("-n, --name <name>", "Project name")
-    .action(initCommand);
+    .action(async (options) => {
+    const { initCommand } = await import("./commands/init.js");
+    await initCommand(options);
+});
 program
     .command("repair")
     .description("Repair a JFL project missing .jfl directory")
-    .action(repairCommand);
+    .action(async () => {
+    const { repairCommand } = await import("./commands/repair.js");
+    await repairCommand();
+});
 program
     .command("validate-settings")
     .description("Validate and repair .claude/settings.json")
     .option("--fix", "Attempt to auto-repair common issues")
     .option("--json", "Output in JSON format")
-    .action(validateSettingsCommand);
+    .action(async (options) => {
+    const { validateSettingsCommand } = await import("./commands/validate-settings.js");
+    await validateSettingsCommand(options);
+});
 program
     .command("hud")
     .description("Show campaign dashboard")
     .option("-c, --compact", "Show compact one-line status")
-    .action(hudCommand);
+    .action(async (options) => {
+    const { hudCommand } = await import("./commands/hud.js");
+    await hudCommand(options);
+});
 program
     .command("status")
     .description("Show project status")
-    .action(statusCommand);
+    .action(async () => {
+    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); });
+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(); });
+ide.command("status").description("Show current workspace layout and session state").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/ide.js"); await m.ideStatusCommand(options); });
+ide.command("surfaces").description("List active surfaces with live sidebar data").option("--json", "Output as JSON").action(async (options) => { const m = await import("./commands/ide.js"); await m.ideSurfacesCommand(options); });
+ide.command("stop").description("Stop the running workspace session").action(async () => { const m = await import("./commands/ide.js"); await m.ideStopCommand(); });
+ide.command("restart").description("Restart the workspace session").action(async () => { const m = await import("./commands/ide.js"); await m.ideRestartCommand(); });
+ide.command("reset").description("Reset workspace to welcome state").action(async () => { const m = await import("./commands/ide.js"); await m.ideResetCommand(); });
+ide.command("open").description("Open a child project/service in the workspace").argument("<name>", "Service or product name to open").action(async (name) => { const m = await import("./commands/ide.js"); await m.ideOpenCommand(name); });
+ide.command("up").description("Navigate to parent project (portfolio or GTM)").action(async () => { const m = await import("./commands/ide.js"); await m.ideUpCommand(); });
+ide.command("config").description("View or set IDE configuration").argument("[key]", "Config key (e.g., primary, backend)").argument("[value]", "Config value").action(async (key, value) => { const m = await import("./commands/ide.js"); await m.ideConfigCommand(key, value); });
 program
     .command("context-hub")
     .description("Manage Context Hub daemon (unified context for AI agents)")
@@ -201,6 +215,7 @@ program
     .option("--purge", "Also delete token file (for stop)")
     .allowUnknownOption()
     .action(async (action, options) => {
+    const { contextHubCommand } = await import("./commands/context-hub.js");
     await contextHubCommand(action, {
         port: options.port ? parseInt(options.port, 10) : undefined,
         global: options.global || false,
@@ -212,6 +227,7 @@ program
     .description("Manage Claude Code HTTP hooks for Context Hub")
     .argument("[action]", "init, status, remove")
     .action(async (action) => {
+    const { hooksCommand } = await import("./commands/hooks.js");
     await hooksCommand(action);
 });
 program
@@ -222,6 +238,7 @@ program
     .option("--flow <name>", "Filter approvals to a specific flow")
     .option("--all", "Approve all pending gated executions")
     .action(async (action, name, options) => {
+    const { flowsCommand } = await import("./commands/flows.js");
     await flowsCommand(action, name, options);
 });
 program
@@ -230,6 +247,7 @@ program
     .argument("[action]", "list, set, test, viz")
     .argument("[args...]", "Arguments for the action")
     .action(async (action, args) => {
+    const { scopeCommand } = await import("./commands/scope.js");
     await scopeCommand(action, ...args);
 });
 program
@@ -238,6 +256,7 @@ program
     .argument("[hours]", "Hours to look back (default: 24)", "24")
     .argument("[author]", "Filter by author name")
     .action(async (hours, author) => {
+    const { synopsisCommand } = await import("./commands/synopsis.js");
     await synopsisCommand(hours, author);
 });
 program
@@ -332,6 +351,7 @@ program
     .option("-d, --description <desc>", "Override service description")
     .option("--skip-git", "Skip git clone (treat URL as local path)")
     .action(async (pathOrUrl, options) => {
+    const { onboardCommand } = await import("./commands/onboard.js");
     await onboardCommand(pathOrUrl, options);
 });
 program
@@ -414,6 +434,7 @@ program
     .argument("[action]", "show, edit, export, import, generate")
     .option("-f, --file <path>", "File path for export/import/generate output")
     .action(async (action, options) => {
+    const { profileCommand } = await import("./commands/profile.js");
     await profileCommand(action, options);
 });
 program
@@ -421,6 +442,7 @@ program
     .description("Migrate services from references/ to service manager")
     .argument("[gtm-path]", "Path to GTM project (default: current directory)")
     .action(async (gtmPath) => {
+    const { migrateServices } = await import("./commands/migrate-services.js");
     await migrateServices(gtmPath);
 });
 // ============================================================================
@@ -435,11 +457,15 @@ program
     .option("--team", "Use Team plan ($199/mo)")
     .option("--free", "Stay on trial")
     .option("--force", "Force re-authentication")
-    .action(loginCommand);
+    .action(async (options) => {
+    const { loginCommand } = await import("./commands/login.js");
+    await loginCommand(options);
+});
 program
     .command("logout")
     .description("Logout from JFL platform")
-    .action(() => {
+    .action(async () => {
+    const { logout } = await import("./commands/login.js");
     logout();
     console.log(chalk.green("Logged out successfully."));
 });
@@ -451,7 +477,7 @@ program
     .option("--telemetry", "Enable anonymous telemetry")
     .option("--show", "Show current preferences")
     .action(async (options) => {
-    const { getConfigValue, deleteConfigKey, getConfig } = await import("./utils/jfl-config.js");
+    const { getConfigValue, deleteConfigKey } = await import("./utils/jfl-config.js");
     if (options.clearAi) {
         deleteConfigKey("aiCLI");
         console.log(chalk.green("\n✓ Cleared AI CLI preference"));
@@ -459,18 +485,21 @@ program
         return;
     }
     if (options.telemetry === false) {
+        const telemetry = await getTelemetry();
         telemetry.disable();
         console.log(chalk.green("\n✓ Telemetry disabled"));
         console.log(chalk.gray("  No data will be collected\n"));
         return;
     }
     if (options.telemetry === true) {
+        const telemetry = await getTelemetry();
         telemetry.enable();
         console.log(chalk.green("\n✓ Telemetry enabled"));
         console.log(chalk.gray("  Anonymous usage data helps improve JFL\n"));
         return;
     }
     if (options.show || (!options.clearAi && options.telemetry === undefined)) {
+        const telemetry = await getTelemetry();
         console.log(chalk.bold("\n  JFL Preferences\n"));
         console.log(chalk.gray("  AI CLI:") + " " + (getConfigValue("aiCLI") || chalk.gray("none")));
         console.log(chalk.gray("  Projects tracked:") + " " + ((getConfigValue("projects") || []).length));
@@ -484,7 +513,8 @@ program
 program
     .command("wallet")
     .description("Show wallet and day pass status")
-    .action(() => {
+    .action(async () => {
+    const { showDayPassStatus, hasWallet, getWalletAddress } = await import("./utils/auth-guard.js");
     const address = getWalletAddress();
     if (!address) {
         console.log(chalk.yellow("\n⚠️  No wallet configured"));
@@ -508,25 +538,37 @@ program
     .command("deploy")
     .description("Deploy project to JFL platform")
     .option("-f, --force", "Force deploy even if no changes")
-    .action(deployCommand);
+    .action(async (options) => {
+    const { deployCommand } = await import("./commands/deploy.js");
+    await deployCommand(options);
+});
 program
     .command("agents")
     .description("Manage parallel agents")
     .argument("[action]", "Action: list, create, start, stop, destroy")
     .option("-n, --name <name>", "Agent name")
     .option("-t, --task <task>", "Task for agent")
-    .action(agentsCommand);
+    .action(async (action, options) => {
+    const { agentsCommand } = await import("./commands/agents.js");
+    await agentsCommand(action, options);
+});
 program
     .command("feedback")
     .description("Rate your JFL session")
     .argument("[action]", "view or sync")
-    .action(feedbackCommand);
+    .action(async (action) => {
+    const { feedbackCommand } = await import("./commands/feedback.js");
+    await feedbackCommand(action);
+});
 program
     .command("update")
     .description("Pull latest JFL product updates")
     .option("--dry", "Show what would be updated without making changes")
     .option("--auto", "Auto mode: check once per 24h, skip if recently updated")
-    .action((options) => updateCommand({ dry: options.dry, autoUpdate: options.auto }));
+    .action(async (options) => {
+    const { updateCommand } = await import("./commands/update.js");
+    await updateCommand({ dry: options.dry, autoUpdate: options.auto });
+});
 // ============================================================================
 // SKILL MANAGEMENT (work offline)
 // ============================================================================
@@ -537,28 +579,43 @@ skills
     .option("-a, --available", "Show all available skills")
     .option("-c, --category <category>", "Filter by category (core or catalog)")
     .option("-t, --tag <tag>", "Filter by tag")
-    .action(listSkillsCommand);
+    .action(async (options) => {
+    const { listSkillsCommand } = await import("./commands/skills.js");
+    await listSkillsCommand(options);
+});
 skills
     .command("install")
     .description("Install skill(s)")
     .argument("<skills...>", "Skill name(s) to install")
-    .action(installSkillCommand);
+    .action(async (skills) => {
+    const { installSkillCommand } = await import("./commands/skills.js");
+    await installSkillCommand(skills);
+});
 skills
     .command("remove")
     .description("Remove skill(s)")
     .argument("<skills...>", "Skill name(s) to remove")
-    .action(removeSkillCommand);
+    .action(async (skills) => {
+    const { removeSkillCommand } = await import("./commands/skills.js");
+    await removeSkillCommand(skills);
+});
 skills
     .command("update")
     .description("Update installed skill(s)")
     .argument("[skill]", "Skill name to update (omit to update all)")
     .option("--dry", "Show what would be updated without making changes")
-    .action((skill, options) => updateSkillsCommand({ ...options, skillName: skill }));
+    .action(async (skill, options) => {
+    const { updateSkillsCommand } = await import("./commands/skills.js");
+    await updateSkillsCommand({ ...options, skillName: skill });
+});
 skills
     .command("search")
     .description("Search for skills")
     .argument("<query>", "Search query")
-    .action(searchSkillsCommand);
+    .action(async (query) => {
+    const { searchSkillsCommand } = await import("./commands/skills.js");
+    await searchSkillsCommand(query);
+});
 // ============================================================================
 // VOICE INPUT (work offline)
 // ============================================================================
@@ -570,12 +627,14 @@ voice
     .argument("[name]", "Model name (tiny, base, small, etc.)")
     .option("-f, --force", "Force re-download")
     .action(async (action, name, options) => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("model", action, name, options);
 });
 voice
     .command("devices")
     .description("List audio input devices")
     .action(async () => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("devices");
 });
 voice
@@ -583,6 +642,7 @@ voice
     .description("Test voice input (record 3s and transcribe)")
     .option("-d, --device <id>", "Device ID to use")
     .action(async (options) => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("test", undefined, undefined, {
         device: options.device,
     });
@@ -593,6 +653,7 @@ voice
     .option("-d, --device <id>", "Device ID to use")
     .option("-t, --duration <seconds>", "Recording duration in seconds", "5")
     .action(async (options) => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("recording", undefined, undefined, {
         device: options.device,
         duration: parseInt(options.duration, 10),
@@ -602,6 +663,7 @@ voice
     .command("setup")
     .description("First-time setup wizard for voice input")
     .action(async () => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("setup");
 });
 voice
@@ -609,6 +671,7 @@ voice
     .description("Record voice with VAD (same as running jfl voice)")
     .option("-d, --device <id>", "Device ID to use")
     .action(async (options) => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("record", undefined, undefined, {
         device: options.device,
     });
@@ -617,6 +680,7 @@ voice
     .command("help")
     .description("Show voice command help")
     .action(async () => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("help");
 });
 voice
@@ -625,6 +689,7 @@ voice
     .option("-d, --device <id>", "Device ID to use")
     .option("-m, --mode <mode>", "Hotkey mode: auto, tap, or hold (default: auto)")
     .action(async (options) => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("hotkey", undefined, undefined, {
         device: options.device,
         mode: options.mode,
@@ -639,6 +704,7 @@ daemon
     .description("Start hotkey listener in background")
     .option("-m, --mode <mode>", "Hotkey mode: auto, tap, or hold (default: auto)")
     .action(async (options) => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("daemon", "start", undefined, {
         mode: options.mode,
     });
@@ -647,22 +713,26 @@ daemon
     .command("stop")
     .description("Stop the background daemon")
     .action(async () => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("daemon", "stop");
 });
 daemon
     .command("status")
     .description("Show daemon status and uptime")
     .action(async () => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("daemon", "status");
 });
 // Default daemon action (show status)
 daemon.action(async () => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand("daemon", "status");
 });
 // Running `jfl voice` without subcommand starts recording with VAD
 voice
     .option("-d, --device <id>", "Device ID to use")
     .action(async (options) => {
+    const { voiceCommand } = await import("./commands/voice.js");
     await voiceCommand(undefined, undefined, undefined, {
         device: options.device,
     });
@@ -674,23 +744,35 @@ const memory = program.command("memory").description("Memory system management")
 memory
     .command("init")
     .description("Initialize memory database")
-    .action(memoryInitCommand);
+    .action(async () => {
+    const { memoryInitCommand } = await import("./commands/memory.js");
+    await memoryInitCommand();
+});
 memory
     .command("status")
     .description("Show memory statistics")
-    .action(memoryStatusCommand);
+    .action(async () => {
+    const { memoryStatusCommand } = await import("./commands/memory.js");
+    await memoryStatusCommand();
+});
 memory
     .command("search")
     .description("Search memories")
     .argument("<query>", "Search query")
     .option("-t, --type <type>", "Filter by type (feature, fix, decision, etc.)")
     .option("-n, --max <n>", "Maximum results", "10")
-    .action(memorySearchCommand);
+    .action(async (query, options) => {
+    const { memorySearchCommand } = await import("./commands/memory.js");
+    await memorySearchCommand(query, options);
+});
 memory
     .command("index")
     .description("Reindex journal entries")
     .option("-f, --force", "Force full reindex")
-    .action(memoryIndexCommand);
+    .action(async (options) => {
+    const { memoryIndexCommand } = await import("./commands/memory.js");
+    await memoryIndexCommand(options);
+});
 // Alias: jfl ask <question> → jfl memory search <question>
 program
     .command("ask")
@@ -699,6 +781,7 @@ program
     .option("-t, --type <type>", "Filter by type (feature, fix, decision, etc.)")
     .option("-n, --max <n>", "Maximum results", "5")
     .action(async (question, options) => {
+    const { memorySearchCommand } = await import("./commands/memory.js");
     await memorySearchCommand(question, options);
 });
 // ============================================================================
@@ -733,6 +816,7 @@ program
     .option("-h, --help", "Show ralph-tui help")
     .allowUnknownOption()
     .action(async (args, options) => {
+    const { ralphCommand, showRalphHelp } = await import("./commands/ralph.js");
     if (options.help || args.length === 0) {
         showRalphHelp();
         return;
@@ -750,12 +834,15 @@ program
 program
     .command("peter")
     .description("Peter Parker - model-routed agent orchestrator")
-    .argument("[action]", "setup, run, pr, experiment, status, or dashboard")
+    .argument("[action]", "setup, run, pr, experiment, autoresearch, status, or dashboard")
     .option("--cost", "Cost-optimized model routing (haiku-heavy)")
     .option("--balanced", "Balanced model routing (default)")
     .option("--quality", "Quality-first model routing (opus-heavy)")
     .option("-t, --task <task>", "Task to run (for run action)")
+    .option("-r, --rounds <n>", "Number of autoresearch rounds (default: 5)")
+    .option("--mode <mode>", "Experiment mode: default or autoresearch")
     .action(async (action, options) => {
+    const { peterCommand } = await import("./commands/peter.js");
     await peterCommand(action, options);
 });
 // ============================================================================
@@ -783,13 +870,22 @@ const clawdbot = program.command("clawdbot").description("Manage JFL plugin for
 clawdbot
     .command("setup")
     .description("Install JFL plugin into Clawdbot and configure it")
-    .action(clawdbotSetupCommand);
+    .action(async () => {
+    const { clawdbotSetupCommand } = await import("./commands/clawdbot.js");
+    await clawdbotSetupCommand();
+});
 clawdbot
     .command("status")
     .description("Show JFL Clawdbot plugin installation status")
-    .action(clawdbotStatusCommand);
+    .action(async () => {
+    const { clawdbotStatusCommand } = await import("./commands/clawdbot.js");
+    await clawdbotStatusCommand();
+});
 // Default action: show status
-clawdbot.action(clawdbotStatusCommand);
+clawdbot.action(async () => {
+    const { clawdbotStatusCommand } = await import("./commands/clawdbot.js");
+    await clawdbotStatusCommand();
+});
 // ============================================================================
 // OPENCLAW (runtime-agnostic agent protocol)
 // ============================================================================
@@ -899,6 +995,14 @@ openclaw
     const { tagCommand } = await import("./commands/openclaw.js");
     await tagCommand(service, message, options);
 });
+openclaw
+    .command("install-skill")
+    .description("Install jfl-gtm skill into OpenClaw (~/.openclaw/skills/)")
+    .option("--dir <path>", "Custom install directory")
+    .action(async (options) => {
+    const { installSkillCommand } = await import("./commands/openclaw.js");
+    await installSkillCommand(options);
+});
 // ============================================================================
 // CI WORKFLOWS
 // ============================================================================
@@ -920,12 +1024,14 @@ registerEvalCommand(program);
 registerPredictCommand(program);
 registerPortfolioCommand(program);
 registerVizCommand(program);
+registerFindingsCommand(program);
 // ============================================================================
 // 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";
@@ -934,6 +1040,7 @@ telemetryCmd
     .command("status")
     .description("Show telemetry status")
     .action(async () => {
+    const telemetry = await getTelemetry();
     const enabled = telemetry.isEnabled();
     const installId = telemetry.getInstallId();
     const queueSize = telemetry.getQueueSize();
@@ -952,6 +1059,7 @@ telemetryCmd
     .command("show")
     .description("Show recent telemetry events from spillover queue")
     .action(async () => {
+    const telemetry = await getTelemetry();
     const spillover = telemetry.getSpilloverEvents();
     if (spillover.length === 0) {
         console.log(chalk.gray("\n  No events in spillover queue.\n"));
@@ -968,6 +1076,7 @@ telemetryCmd
     .command("reset")
     .description("Reset install ID (generates new anonymous ID)")
     .action(async () => {
+    const telemetry = await getTelemetry();
     telemetry.resetInstallId();
     console.log(chalk.green("\n  Install ID reset. New ID: ") + chalk.cyan(telemetry.getInstallId()) + "\n");
 });
@@ -983,6 +1092,7 @@ telemetryCmd
     .option("--error-code <code>", "Error code")
     .allowUnknownOption()
     .action(async (options) => {
+    const telemetry = await getTelemetry();
     telemetry.track({
         category: options.category,
         event: options.event,
@@ -997,6 +1107,7 @@ telemetryCmd
 // Default telemetry action
 telemetryCmd.action(async () => {
     // Show status by default
+    const telemetry = await getTelemetry();
     const enabled = telemetry.isEnabled();
     const installId = telemetry.getInstallId();
     console.log(chalk.bold("\n  Telemetry Status\n"));
@@ -1032,6 +1143,7 @@ program
     .description("Check project health and auto-repair")
     .option("--fix", "Auto-repair fixable issues")
     .action(async (options) => {
+    const { doctorCommand } = await import("./commands/doctor.js");
     await doctorCommand({ fix: options.fix });
 });
 // ============================================================================
@@ -1044,12 +1156,14 @@ agent
     .argument("<name>", "Agent name (lowercase, hyphens allowed)")
     .option("-d, --description <desc>", "Agent description")
     .action(async (name, options) => {
+    const { agentCommand } = await import("./commands/agent.js");
     await agentCommand("init", name, { description: options.description });
 });
 agent
     .command("list")
     .description("List registered agents")
     .action(async () => {
+    const { agentCommand } = await import("./commands/agent.js");
     await agentCommand("list");
 });
 agent
@@ -1057,9 +1171,11 @@ agent
     .description("Show agent health and config")
     .argument("<name>", "Agent name")
     .action(async (name) => {
+    const { agentCommand } = await import("./commands/agent.js");
     await agentCommand("status", name);
 });
 agent.action(async () => {
+    const { agentCommand } = await import("./commands/agent.js");
     await agentCommand();
 });
 // ============================================================================
@@ -1099,6 +1215,56 @@ piAgents
     await piAgentsRunCommand(options);
 });
 // ============================================================================
+const piFleet = piCmd.command("fleet").description("VM agent fleet — spawn, collect, destroy waves of autonomous agents");
+piFleet
+    .command("setup")
+    .description("Install VM backend, check boot arg, create base image")
+    .option("--backend <name>", "VM backend: lume (default)", "lume")
+    .option("--cpus <n>", "CPUs per VM", "4")
+    .option("--memory <mb>", "Memory per VM in MB", "4096")
+    .option("--skip-boot-arg", "Skip VM quota boot arg check")
+    .action(async (options) => {
+    const { fleetSetup } = await import("./commands/pi-fleet.js");
+    await fleetSetup({ ...options, cpus: parseInt(options.cpus), memory: parseInt(options.memory) });
+});
+piFleet
+    .command("spawn <count>")
+    .description("Spawn N agent VMs for parallel autoresearch")
+    .option("--rounds <n>", "Autoresearch rounds per agent", "5")
+    .option("--repo <url>", "Target repo (defaults to git remote origin)")
+    .action(async (count, options) => {
+    const { fleetSpawn } = await import("./commands/pi-fleet.js");
+    await fleetSpawn(parseInt(count), { ...options, rounds: parseInt(options.rounds) });
+});
+piFleet
+    .command("status")
+    .description("Show running agents, tuple counts, health")
+    .action(async () => {
+    const { fleetStatus } = await import("./commands/pi-fleet.js");
+    await fleetStatus();
+});
+piFleet
+    .command("collect [waveId]")
+    .description("Pull tuples from agents, dedup, append to training buffer")
+    .action(async (waveId) => {
+    const { fleetCollect } = await import("./commands/pi-fleet.js");
+    await fleetCollect(waveId);
+});
+piFleet
+    .command("destroy [waveId]")
+    .description("Tear down a wave of agent VMs")
+    .action(async (waveId) => {
+    const { fleetDestroy } = await import("./commands/pi-fleet.js");
+    await fleetDestroy(waveId);
+});
+piFleet
+    .command("logs <agent>")
+    .description("Tail an agent's autoresearch log")
+    .action(async (agent) => {
+    const { fleetLogs } = await import("./commands/pi-fleet.js");
+    await fleetLogs(agent);
+});
+// ============================================================================
 // Parse and run
 program.parse();
 //# sourceMappingURL=index.js.map