jfl 0.1.0 → 0.2.0

package/dist/index.js

@@ -7,13 +7,13 @@
  */
 import { Command } from "commander";
 import chalk from "chalk";
-import { spawn, execSync } from "child_process";
-import { existsSync, symlinkSync, mkdirSync, unlinkSync } from "fs";
-import { homedir } from "os";
+import { spawn } from "child_process";
 import { join } from "path";
+import * as path from "path";
 import { fileURLToPath } from "url";
 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";
@@ -25,15 +25,23 @@ import { updateCommand } from "./commands/update.js";
 import { contextHubCommand } from "./commands/context-hub.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 { sessionCreate, sessionExec, sessionList, sessionDestroy, sessionInfo } from "./commands/session-mgmt.js";
+import { clawdbotSetupCommand, clawdbotStatusCommand } from "./commands/clawdbot.js";
 import { showDayPassStatus, hasWallet, getWalletAddress, } from "./utils/auth-guard.js";
+import { checkAndMigrate } from "./utils/jfl-migration.js";
+import { JFL_PATHS } from "./utils/jfl-paths.js";
+// Auto-migrate from ~/.jfl/ to XDG directories if needed
+await checkAndMigrate({ silent: true });
 const program = new Command();
 program
     .name("jfl")
-    .description("Just Fucking Launch - AI-powered GTM and development")
-    .version("0.1.0")
+    .description("Just Fucking Launch - AI gateway for GTM")
+    .version("0.1.1")
     .option("--no-update", "Skip automatic update check")
     .action(async (options) => {
     // Always update on session start (unless --no-update flag)
@@ -41,7 +49,7 @@ program
         await updateCommand({ autoUpdate: true });
         console.log(); // Add spacing before session starts
     }
-    await sessionCommand();
+    await sessionCommand({});
 });
 // ============================================================================
 // FREE TIER COMMANDS (work offline/standalone)
@@ -55,6 +63,12 @@ program
     .command("repair")
     .description("Repair a JFL project missing .jfl directory")
     .action(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);
 program
     .command("hud")
     .description("Show campaign dashboard")
@@ -69,8 +83,12 @@ program
     .description("Manage Context Hub daemon (unified context for AI agents)")
     .argument("[action]", "start, stop, restart, status, ensure, query, serve")
     .option("-p, --port <port>", "Port to run on (default: 4242)", "4242")
+    .option("-g, --global", "Run in global mode (serve all GTM projects)")
     .action(async (action, options) => {
-    await contextHubCommand(action, { port: parseInt(options.port, 10) });
+    await contextHubCommand(action, {
+        port: parseInt(options.port, 10),
+        global: options.global || false,
+    });
 });
 program
     .command("synopsis")
@@ -80,6 +98,185 @@ program
     .action(async (hours, author) => {
     await synopsisCommand(hours, author);
 });
+program
+    .command("service-manager")
+    .description("Manage Service Manager API daemon")
+    .argument("[action]", "start, stop, restart, status, serve")
+    .option("-p, --port <port>", "Port to run on (default: from config or 3402)")
+    .action(async (action, options) => {
+    const { serviceManagerCommand } = await import("./commands/service-manager.js");
+    await serviceManagerCommand(action, {
+        port: options.port ? parseInt(options.port, 10) : undefined
+    });
+});
+program
+    .command("services")
+    .description("Manage services across all GTM projects (interactive TUI or CLI)")
+    .argument("[action]", "create, scan, list, status, start, stop, deps, validate, sync-agents, or leave empty for TUI")
+    .argument("[service]", "Service name")
+    .option("--dry-run", "Preview what would be discovered (for scan) or preview sync changes (for sync-agents)")
+    .option("--current", "Sync only current service (for sync-agents)")
+    .option("--path <path>", "Path to scan (default: current directory)")
+    .option("--force", "Force operation (for stop with dependents)")
+    .option("--verbose", "Verbose output")
+    .option("--fix", "Auto-repair issues (for validate)")
+    .option("--json", "Output JSON (for validate)")
+    .option("--skip-ai", "Skip AI tool, just scaffold (for create)")
+    .action(async (action, service, options) => {
+    // Handle scan action
+    if (action === "scan") {
+        const { scanServices } = await import("./commands/services-scan.js");
+        await scanServices({
+            path: options.path,
+            dryRun: options.dryRun
+        });
+        return;
+    }
+    // Handle dependency actions
+    if (action === "deps" || action === "dependencies") {
+        const { buildDependencyGraph, visualizeDependencies, validateDependencies } = await import("./lib/service-dependencies.js");
+        const fs = await import("fs");
+        const servicesConfigPath = path.join(JFL_PATHS.data, "services.json");
+        const servicesConfig = JSON.parse(fs.readFileSync(servicesConfigPath, "utf-8"));
+        if (service === "validate") {
+            const result = validateDependencies(servicesConfig.services);
+            if (result.valid) {
+                console.log(chalk.green("\n✓ All dependencies valid\n"));
+            }
+            else {
+                console.log(chalk.red("\n✗ Dependency validation failed:\n"));
+                result.errors.forEach(err => console.log(chalk.red(`  - ${err}`)));
+                console.log();
+            }
+        }
+        else {
+            console.log(visualizeDependencies(servicesConfig.services));
+        }
+        return;
+    }
+    // If no action, launch interactive TUI
+    if (!action) {
+        const { spawn } = await import("child_process");
+        const { fileURLToPath } = await import("url");
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        const tui = spawn(process.execPath, [
+            path.join(__dirname, "../dist/ui/services-manager.js")
+        ], {
+            stdio: "inherit"
+        });
+        tui.on("exit", (code) => {
+            process.exit(code || 0);
+        });
+    }
+    else {
+        // CLI mode
+        const { servicesCommand } = await import("./commands/services.js");
+        await servicesCommand(action, service, {
+            fix: options.fix,
+            json: options.json,
+            dryRun: options.dryRun,
+            current: options.current,
+            skipAI: options.skipAi
+        });
+    }
+});
+program
+    .command("onboard <path-or-url>")
+    .description("Onboard a service repo as a service agent")
+    .option("-n, --name <name>", "Override service name")
+    .option("-t, --type <type>", "Override service type (web, api, container, worker, cli, infrastructure, library)")
+    .option("-d, --description <desc>", "Override service description")
+    .option("--skip-git", "Skip git clone (treat URL as local path)")
+    .action(async (pathOrUrl, options) => {
+    await onboardCommand(pathOrUrl, options);
+});
+program
+    .command("orchestrate [name]")
+    .description("Execute multi-service orchestration workflows")
+    .option("--dry-run", "Preview orchestration steps without executing")
+    .option("--list", "List available orchestrations")
+    .option("--create <name>", "Create new orchestration template")
+    .action(async (name, options) => {
+    const { orchestrate, listOrchestrations, createOrchestration } = await import("./commands/orchestrate.js");
+    if (options.list) {
+        await listOrchestrations();
+    }
+    else if (options.create) {
+        await createOrchestration(options.create);
+    }
+    else if (name) {
+        await orchestrate(name, { dryRun: options.dryRun });
+    }
+    else {
+        await listOrchestrations();
+    }
+});
+program
+    .command("dashboard")
+    .description("Launch interactive service monitoring dashboard")
+    .action(async () => {
+    const { startDashboard } = await import("./ui/service-dashboard.js");
+    await startDashboard();
+});
+program
+    .command("service-agent <action> [name]")
+    .description("Manage service MCP agents (init, generate, register, list)")
+    .action(async (action, name) => {
+    const { init, generate, generateAll, register, unregister, list, clean } = await import("./commands/service-agent.js");
+    switch (action) {
+        case "init":
+            await init(name); // name is optional path
+            break;
+        case "generate":
+            if (!name) {
+                console.log(chalk.red("Error: service name required"));
+                console.log(chalk.gray("Usage: jfl service-agent generate <service-name>"));
+                process.exit(1);
+            }
+            await generate(name);
+            break;
+        case "generate-all":
+            await generateAll();
+            break;
+        case "register":
+            await register(name);
+            break;
+        case "unregister":
+            if (!name) {
+                console.log(chalk.red("Error: service name required"));
+                console.log(chalk.gray("Usage: jfl service-agent unregister <service-name>"));
+                process.exit(1);
+            }
+            await unregister(name);
+            break;
+        case "list":
+            await list();
+            break;
+        case "clean":
+            await clean();
+            break;
+        default:
+            console.log(chalk.red(`Unknown action: ${action}`));
+            console.log(chalk.gray("Available actions: init, generate, generate-all, register, unregister, list, clean"));
+            process.exit(1);
+    }
+});
+program
+    .command("profile [action]")
+    .description("Manage your JFL profile (stored in config)")
+    .argument("[action]", "show, edit, export, import, generate")
+    .option("-f, --file <path>", "File path for export/import/generate output")
+    .action(async (action, options) => {
+    await profileCommand(action, options);
+});
+program
+    .command("migrate-services")
+    .description("Migrate services from references/ to service manager")
+    .argument("[gtm-path]", "Path to GTM project (default: current directory)")
+    .action(async (gtmPath) => {
+    await migrateServices(gtmPath);
+});
 // ============================================================================
 // PLATFORM COMMANDS (require login for full features)
 // ============================================================================
@@ -100,6 +297,28 @@ program
     logout();
     console.log(chalk.green("Logged out successfully."));
 });
+program
+    .command("preferences")
+    .description("Manage JFL preferences")
+    .option("--clear-ai", "Clear saved AI CLI preference")
+    .option("--show", "Show current preferences")
+    .action(async (options) => {
+    const { getConfigValue, deleteConfigKey, getConfig } = await import("./utils/jfl-config.js");
+    if (options.clearAi) {
+        deleteConfigKey("aiCLI");
+        console.log(chalk.green("\n✓ Cleared AI CLI preference"));
+        console.log(chalk.gray("  Next 'jfl' will show selection menu\n"));
+        return;
+    }
+    if (options.show || !options.clearAi) {
+        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));
+        console.log();
+        console.log(chalk.gray("To clear AI preference: jfl preferences --clear-ai"));
+        console.log();
+    }
+});
 program
     .command("wallet")
     .description("Show wallet and day pass status")
@@ -282,6 +501,38 @@ voice
     });
 });
 // ============================================================================
+// MEMORY SYSTEM (work offline)
+// ============================================================================
+const memory = program.command("memory").description("Memory system management");
+memory
+    .command("init")
+    .description("Initialize memory database")
+    .action(memoryInitCommand);
+memory
+    .command("status")
+    .description("Show memory statistics")
+    .action(memoryStatusCommand);
+memory
+    .command("search <query>")
+    .description("Search memories")
+    .option("-t, --type <type>", "Filter by type (feature, fix, decision, etc.)")
+    .option("-n, --max <n>", "Maximum results", "10")
+    .action(memorySearchCommand);
+memory
+    .command("index")
+    .description("Reindex journal entries")
+    .option("-f, --force", "Force full reindex")
+    .action(memoryIndexCommand);
+// Alias: jfl ask <question> → jfl memory search <question>
+program
+    .command("ask <question>")
+    .description("Ask a question - searches memory system")
+    .option("-t, --type <type>", "Filter by type (feature, fix, decision, etc.)")
+    .option("-n, --max <n>", "Maximum results", "5")
+    .action(async (question, options) => {
+    await memorySearchCommand(question, options);
+});
+// ============================================================================
 // SKILL SHORTCUTS (work offline)
 // ============================================================================
 program
@@ -320,86 +571,6 @@ program
     await ralphCommand(args);
 });
 // ============================================================================
-// SESSION MANAGEMENT (multi-platform sessions)
-// ============================================================================
-const session = program
-    .command("session")
-    .description("Manage GTM sessions across platforms (CLI, Telegram, Slack, Web)");
-session
-    .command("create")
-    .description("Create or get existing session")
-    .requiredOption("-p, --platform <platform>", "Platform (cli, telegram, slack, web)")
-    .option("-t, --thread <id>", "Thread/channel ID")
-    .option("-u, --user <name>", "User name")
-    .action(async (options) => {
-    try {
-        const sessionId = await sessionCreate({
-            platform: options.platform,
-            thread: options.thread,
-            user: options.user
-        });
-        console.log(sessionId);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}`));
-        process.exit(1);
-    }
-});
-session
-    .command("exec")
-    .description("Execute command in session context")
-    .argument("<sessionId>", "Session ID")
-    .argument("<command>", "Command to execute")
-    .action(async (sessionId, command) => {
-    try {
-        const output = await sessionExec(sessionId, command);
-        console.log(output);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}`));
-        process.exit(1);
-    }
-});
-session
-    .command("list")
-    .description("List all active sessions")
-    .action(async () => {
-    try {
-        await sessionList();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}`));
-        process.exit(1);
-    }
-});
-session
-    .command("info")
-    .description("Show session information")
-    .argument("<sessionId>", "Session ID")
-    .action(async (sessionId) => {
-    try {
-        await sessionInfo(sessionId);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}`));
-        process.exit(1);
-    }
-});
-session
-    .command("destroy")
-    .description("Destroy session")
-    .argument("<sessionId>", "Session ID")
-    .option("-f, --force", "Force destroy even with uncommitted changes")
-    .action(async (sessionId, options) => {
-    try {
-        await sessionDestroy(sessionId, { force: options.force });
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}`));
-        process.exit(1);
-    }
-});
-// ============================================================================
 // TEST MODE (for development)
 // ============================================================================
 program
@@ -420,63 +591,140 @@ program
 // ============================================================================
 // CLAWDBOT INTEGRATION
 // ============================================================================
-program
-    .command("clawdbot")
-    .description("Install JFL skill for Clawdbot")
-    .action(() => {
-    try {
-        // Check if clawdbot is installed
-        execSync("which clawdbot", { stdio: "pipe" });
-    }
-    catch {
-        console.log(chalk.red("\n❌ Clawdbot not installed"));
-        console.log(chalk.gray("   Install Clawdbot first: https://clawd.bot\n"));
-        process.exit(1);
-    }
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = join(__filename, "..");
-    const skillsDir = join(homedir(), ".clawdbot/skills");
-    const targetPath = join(skillsDir, "jfl-gtm");
-    // Find the skill source (either in node_modules or local dev)
-    let skillSource = null;
-    // Try node_modules first (installed via npm)
-    const npmSkillPath = join(__dirname, "../clawdbot-skill");
-    if (existsSync(npmSkillPath)) {
-        skillSource = npmSkillPath;
-    }
-    if (!skillSource) {
-        console.log(chalk.red("\n❌ JFL Clawdbot skill not found"));
-        console.log(chalk.gray("   This shouldn't happen. Please report a bug.\n"));
-        process.exit(1);
-    }
-    // Create .clawdbot/skills directory if it doesn't exist
-    if (!existsSync(skillsDir)) {
-        mkdirSync(skillsDir, { recursive: true });
-    }
-    // Remove existing symlink if present
-    if (existsSync(targetPath)) {
-        try {
-            unlinkSync(targetPath);
-        }
-        catch (error) {
-            console.log(chalk.yellow("⚠️  Could not remove existing skill (continuing)"));
-        }
-    }
-    // Create symlink
-    try {
-        symlinkSync(skillSource, targetPath);
-        console.log(chalk.green("\n✓ JFL skill installed for Clawdbot"));
-        console.log(chalk.gray("   Clawdbot will auto-detect the skill"));
-        console.log(chalk.cyan("\n   Ready! Use /jfl in Telegram/Slack/Discord\n"));
-    }
-    catch (error) {
-        console.log(chalk.red(`\n❌ Failed to install skill: ${error.message}\n`));
-        process.exit(1);
-    }
+const clawdbot = program.command("clawdbot").description("Manage JFL plugin for Clawdbot gateway");
+clawdbot
+    .command("setup")
+    .description("Install JFL plugin into Clawdbot and configure it")
+    .action(clawdbotSetupCommand);
+clawdbot
+    .command("status")
+    .description("Show JFL Clawdbot plugin installation status")
+    .action(clawdbotStatusCommand);
+// Default action: show status
+clawdbot.action(clawdbotStatusCommand);
+// ============================================================================
+// OPENCLAW (runtime-agnostic agent protocol)
+// ============================================================================
+const openclaw = program.command("openclaw").description("OpenClaw agent protocol - runtime-agnostic JFL integration");
+openclaw
+    .command("session-start")
+    .description("Start an agent session (branch, auto-commit, Context Hub)")
+    .requiredOption("-a, --agent <name>", "Agent name/ID")
+    .option("-g, --gtm <path>", "GTM workspace path")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { sessionStartCommand } = await import("./commands/openclaw.js");
+    await sessionStartCommand(options);
+});
+openclaw
+    .command("session-end")
+    .description("End session (commit, merge, cleanup)")
+    .option("-s, --sync", "Sync to GTM parent (for services)")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { sessionEndCommand } = await import("./commands/openclaw.js");
+    await sessionEndCommand(options);
+});
+openclaw
+    .command("heartbeat")
+    .description("Health pulse (auto-commit, check Context Hub)")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { heartbeatCommand: openclawHeartbeat } = await import("./commands/openclaw.js");
+    await openclawHeartbeat(options);
+});
+openclaw
+    .command("context")
+    .description("Get unified context from Context Hub")
+    .option("-q, --query <query>", "Search query")
+    .option("-t, --task-type <type>", "Task type (code, spec, content, strategy, general)")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { contextCommand } = await import("./commands/openclaw.js");
+    await contextCommand(options);
+});
+openclaw
+    .command("journal")
+    .description("Write a journal entry")
+    .requiredOption("--type <type>", "Entry type (feature, fix, decision, milestone, spec, discovery)")
+    .requiredOption("--title <title>", "Entry title")
+    .requiredOption("--summary <summary>", "Entry summary")
+    .option("--detail <detail>", "Full detail")
+    .option("--files <files>", "Comma-separated file paths")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { journalCommand } = await import("./commands/openclaw.js");
+    await journalCommand(options);
+});
+openclaw
+    .command("status")
+    .description("Show agent session state and health")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { statusCommand: openclawStatus } = await import("./commands/openclaw.js");
+    await openclawStatus(options);
+});
+openclaw
+    .command("gtm-list")
+    .description("List registered GTM workspaces")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { gtmListCommand } = await import("./commands/openclaw.js");
+    await gtmListCommand(options);
+});
+openclaw
+    .command("gtm-switch")
+    .description("Switch active GTM workspace")
+    .argument("<gtm-id>", "GTM ID to switch to")
+    .option("--json", "Output JSON")
+    .action(async (gtmId, options) => {
+    const { gtmSwitchCommand } = await import("./commands/openclaw.js");
+    await gtmSwitchCommand(gtmId, options);
+});
+openclaw
+    .command("gtm-create")
+    .description("Create and register a new GTM workspace")
+    .argument("<name>", "GTM workspace name")
+    .option("-p, --path <dir>", "Target directory")
+    .option("--json", "Output JSON")
+    .action(async (name, options) => {
+    const { gtmCreateCommand } = await import("./commands/openclaw.js");
+    await gtmCreateCommand(name, options);
+});
+openclaw
+    .command("register")
+    .description("Register agent with a GTM workspace")
+    .requiredOption("-g, --gtm <path>", "GTM workspace path")
+    .option("-a, --agent <name>", "Agent name (auto-detected from manifest)")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    const { registerCommand } = await import("./commands/openclaw.js");
+    await registerCommand(options);
+});
+openclaw
+    .command("tag")
+    .description("Send message to a service agent")
+    .argument("<service>", "Service name")
+    .argument("<message>", "Message to send")
+    .option("--json", "Output JSON")
+    .action(async (service, message, options) => {
+    const { tagCommand } = await import("./commands/openclaw.js");
+    await tagCommand(service, message, options);
 });
 // ============================================================================
 // HELP
 // ============================================================================
+// GTM COMMANDS
+// ============================================================================
+const gtm = program.command("gtm").description("GTM workspace management");
+gtm
+    .command("process-service-update [event-file]")
+    .description("Process service sync notification (called by hooks)")
+    .action(async (eventFile) => {
+    const { gtmProcessUpdate } = await import("./commands/gtm-process-update.js");
+    await gtmProcessUpdate(eventFile);
+});
+// ============================================================================
 program
     .command("help")
     .description("Show help")
@@ -486,14 +734,20 @@ program
     console.log(chalk.cyan("  Free Tier (works offline):"));
     console.log("    jfl init              Initialize project");
     console.log("    jfl repair            Repair missing .jfl directory");
+    console.log("    jfl validate-settings Validate .claude/settings.json");
     console.log("    jfl update            Pull latest JFL updates");
+    console.log("    jfl profile           Manage your profile");
+    console.log("    jfl profile generate  Generate CLAUDE.md w/ AI");
     console.log("    jfl hud               Project dashboard");
     console.log("    jfl status            Project status");
+    console.log("    jfl onboard           Onboard service as agent");
+    console.log("    jfl services          Manage services");
     console.log("    jfl brand             Brand architect");
     console.log("    jfl content           Content creator");
     console.log("    jfl voice             Voice input commands");
     console.log("    jfl ralph             AI agent loop (ralph-tui)");
     console.log("    jfl context-hub       Context Hub (unified AI context)");
+    console.log("    jfl openclaw          OpenClaw agent protocol");
     console.log("    jfl test              Test onboarding (isolated)");
     console.log(chalk.cyan("\n  Platform (requires login):"));
     console.log("    jfl login             Login to platform");