@10et/cli 1.0.0

package/dist/commands/onboard.js

@@ -0,0 +1,873 @@
+/**
+ * Onboard Command
+ *
+ * Onboard a service repo as a service agent in the GTM ecosystem
+ *
+ * Usage:
+ *   jfl onboard <path|url>
+ *   jfl onboard /Users/user/code/myservice
+ *   jfl onboard git@github.com:user/repo.git
+ *
+ * @purpose Onboard services with full agent infrastructure
+ */
+import chalk from "chalk";
+import ora from "ora";
+import * as p from "@clack/prompts";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { execSync } from "child_process";
+import { join, resolve, basename } from "path";
+import { extractServiceMetadata, } from "../lib/service-detector.js";
+import { generateAgentDefinition, writeAgentDefinition, migrateAgentFiles, } from "../lib/agent-generator.js";
+import { writeSkillFiles } from "../lib/skill-generator.js";
+import { syncPeerAgents, getRegisteredServices } from "../lib/peer-agent-generator.js";
+import { writeAgentConfig } from "../lib/agent-config.js";
+/**
+ * Discover available metrics from a service's codebase
+ */
+function discoverServiceMetrics(servicePath, serviceName) {
+    const metrics = [];
+    const packageJsonPath = join(servicePath, "package.json");
+    const tsconfigPath = join(servicePath, "tsconfig.json");
+    const dockerfilePath = join(servicePath, "Dockerfile");
+    const benchmarkDir = join(servicePath, "benchmark");
+    const perfDir = join(servicePath, "perf");
+    if (existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+            if (pkg.scripts?.build) {
+                metrics.push({
+                    name: "build_time_ms",
+                    type: "build_time_ms",
+                    direction: "minimize",
+                    evalScript: `eval/${serviceName}-build-time.sh`,
+                    source: "package.json:scripts.build",
+                });
+            }
+            if (pkg.scripts?.test || pkg.scripts?.["test:ci"]) {
+                metrics.push({
+                    name: "test_pass_rate",
+                    type: "test_pass_rate",
+                    direction: "maximize",
+                    evalScript: `eval/${serviceName}-test-pass-rate.sh`,
+                    source: "package.json:scripts.test",
+                });
+            }
+        }
+        catch { }
+    }
+    if (existsSync(tsconfigPath)) {
+        metrics.push({
+            name: "type_error_count",
+            type: "type_error_count",
+            direction: "minimize",
+            evalScript: `eval/${serviceName}-type-errors.sh`,
+            source: "tsconfig.json",
+        });
+    }
+    if (existsSync(benchmarkDir) || existsSync(perfDir)) {
+        metrics.push({
+            name: "benchmark_score",
+            type: "benchmark_score",
+            direction: "maximize",
+            evalScript: `eval/${serviceName}-benchmark.sh`,
+            source: existsSync(benchmarkDir) ? "benchmark/" : "perf/",
+        });
+    }
+    if (existsSync(dockerfilePath)) {
+        metrics.push({
+            name: "image_size_bytes",
+            type: "image_size_bytes",
+            direction: "minimize",
+            evalScript: `eval/${serviceName}-image-size.sh`,
+            source: "Dockerfile",
+        });
+    }
+    return metrics;
+}
+/**
+ * Generate eval script content based on metric type
+ */
+function generateEvalScript(metric, servicePath, serviceName) {
+    const header = `#!/bin/bash
+# Eval script for ${serviceName} - ${metric.name}
+# Generated by jfl onboard
+# Source: ${metric.source}
+
+set -euo pipefail
+cd "${servicePath}"
+
+`;
+    switch (metric.type) {
+        case "build_time_ms":
+            return header + `# Measure build time
+START=$(date +%s%3N)
+npm run build 2>&1 > /dev/null
+END=$(date +%s%3N)
+DURATION=$((END - START))
+echo '{"metric": "build_time_ms", "value": '"$DURATION"', "direction": "minimize"}'
+`;
+        case "test_pass_rate":
+            return header + `# Run tests and calculate pass rate
+OUTPUT=$(npm test --json 2>&1 || true)
+
+# Try to parse Jest JSON output
+PASSED=$(echo "$OUTPUT" | grep -oP '"numPassedTests":\\s*\\K\\d+' || echo "0")
+TOTAL=$(echo "$OUTPUT" | grep -oP '"numTotalTests":\\s*\\K\\d+' || echo "1")
+
+if [ "$TOTAL" -gt 0 ]; then
+  RATE=$(awk "BEGIN {printf \\"%.4f\\", $PASSED / $TOTAL}")
+else
+  RATE="0.0000"
+fi
+
+echo '{"metric": "test_pass_rate", "value": '"$RATE"', "passed": '"$PASSED"', "total": '"$TOTAL"', "direction": "maximize"}'
+`;
+        case "type_error_count":
+            return header + `# Count TypeScript errors
+OUTPUT=$(npx tsc --noEmit 2>&1 || true)
+ERRORS=$(echo "$OUTPUT" | grep -c "error TS" || echo "0")
+echo '{"metric": "type_error_count", "value": '"$ERRORS"', "direction": "minimize"}'
+`;
+        case "benchmark_score":
+            return header + `# Run benchmarks
+# TODO: Customize this for your benchmark suite
+if [ -d "benchmark" ]; then
+  cd benchmark && npm run bench 2>&1 | tail -5
+elif [ -d "perf" ]; then
+  cd perf && npm run bench 2>&1 | tail -5
+fi
+echo '{"metric": "benchmark_score", "value": 0, "direction": "maximize", "note": "customize this script"}'
+`;
+        case "image_size_bytes":
+            return header + `# Measure Docker image size
+docker build -t ${serviceName}:eval-temp . > /dev/null 2>&1
+SIZE=$(docker image inspect ${serviceName}:eval-temp --format='{{.Size}}')
+docker rmi ${serviceName}:eval-temp > /dev/null 2>&1
+echo '{"metric": "image_size_bytes", "value": '"$SIZE"', "direction": "minimize"}'
+`;
+        default:
+            return header + `echo '{"metric": "unknown", "value": 0}'
+`;
+    }
+}
+/**
+ * Create RL agent configs and eval scripts for discovered metrics
+ */
+function createRLAgentConfigs(metrics, servicePath, serviceName, gtmPath) {
+    const evalScripts = [];
+    const agentConfigs = [];
+    let created = 0;
+    // Create eval directory in GTM
+    const evalDir = join(gtmPath, "eval");
+    if (!existsSync(evalDir)) {
+        mkdirSync(evalDir, { recursive: true });
+    }
+    for (const metric of metrics) {
+        // Generate eval script
+        const evalScriptPath = join(gtmPath, metric.evalScript);
+        const evalScriptContent = generateEvalScript(metric, servicePath, serviceName);
+        writeFileSync(evalScriptPath, evalScriptContent);
+        execSync(`chmod +x "${evalScriptPath}"`, { stdio: "ignore" });
+        evalScripts.push(metric.evalScript);
+        // Generate TOML agent config
+        const agentName = `${serviceName}-${metric.name.replace(/_/g, "-")}`;
+        const tomlPath = writeAgentConfig(gtmPath, {
+            name: agentName,
+            scope: serviceName,
+            metric: metric.name,
+            direction: metric.direction,
+            time_budget_seconds: 300,
+            eval: {
+                script: metric.evalScript,
+                data: `eval/${serviceName}-baseline.jsonl`,
+            },
+            constraints: {
+                files_in_scope: [`${servicePath}/src/**`],
+                files_readonly: ["eval/**"],
+                max_file_changes: 10,
+            },
+            policy: {
+                embedding_model: "stratus-x1ac-base-claude-sonnet-4-6",
+                exploration_rate: 0.2,
+                decay_per_round: 0.01,
+                min_exploration: 0.05,
+            },
+            context_scope: {
+                produces: [`${serviceName}:${metric.name.replace(/_/g, "-")}-improved`],
+                consumes: [`${serviceName}:code-changed`],
+            },
+        });
+        agentConfigs.push(tomlPath);
+        created++;
+    }
+    return { created, evalScripts, agentConfigs };
+}
+/**
+ * Find GTM directory (current dir or parent)
+ */
+function findGTMDirectory() {
+    let currentDir = process.cwd();
+    // Check current directory and up to 3 levels up
+    for (let i = 0; i < 4; i++) {
+        const configPath = join(currentDir, ".jfl/config.json");
+        if (existsSync(configPath)) {
+            try {
+                const config = JSON.parse(readFileSync(configPath, "utf-8"));
+                if (config.type === "gtm") {
+                    return currentDir;
+                }
+            }
+            catch {
+                // Invalid config, continue
+            }
+        }
+        const parent = join(currentDir, "..");
+        if (parent === currentDir)
+            break; // Reached root
+        currentDir = parent;
+    }
+    return null;
+}
+/**
+ * Clone git repository to standard location
+ */
+async function cloneRepository(url, targetDir) {
+    // Extract repo name from URL
+    const match = url.match(/\/([^\/]+?)(\.git)?$/);
+    if (!match) {
+        throw new Error(`Could not extract repo name from URL: ${url}`);
+    }
+    const repoName = match[1];
+    // Default clone directory - use user's code directory preference
+    let cloneDir;
+    if (targetDir) {
+        cloneDir = targetDir;
+    }
+    else {
+        const { getCodeDirectory } = await import("../utils/jfl-config.js");
+        const codeDir = await getCodeDirectory();
+        cloneDir = join(codeDir, "repos");
+    }
+    // Check if repo already exists
+    const repoPath = join(cloneDir, repoName);
+    if (existsSync(repoPath)) {
+        console.log(chalk.yellow(`\n⚠️  Repository already exists at ${repoPath}`));
+        // Pull latest
+        const spinner = ora("Pulling latest changes...").start();
+        try {
+            execSync("git pull", { cwd: repoPath, stdio: "pipe" });
+            spinner.succeed("Updated to latest");
+        }
+        catch (err) {
+            spinner.fail("Failed to pull (may have uncommitted changes)");
+            console.log(chalk.gray("  Continuing with existing repo"));
+        }
+        return repoPath;
+    }
+    // Clone the repo
+    const spinner = ora(`Cloning ${repoName}...`).start();
+    try {
+        execSync(`git clone ${url} ${repoPath}`, { stdio: "pipe" });
+        spinner.succeed(`Cloned to ${repoPath}`);
+        return repoPath;
+    }
+    catch (err) {
+        spinner.fail("Failed to clone repository");
+        throw new Error(`Git clone failed: ${err.message}`);
+    }
+}
+/**
+ * Run GTM onboard-service.sh script (optional - continue if it fails)
+ */
+function runGTMOnboardScript(servicePath, serviceName, serviceType, description, gtmPath) {
+    const scriptPath = join(gtmPath, "scripts/services/onboard-service.sh");
+    if (!existsSync(scriptPath)) {
+        console.log(chalk.yellow("⚠️  GTM onboard script not found, skipping"));
+        return;
+    }
+    console.log(chalk.cyan("Setting up service agent infrastructure..."));
+    try {
+        execSync(`bash ${scriptPath} "${servicePath}" "${serviceName}" "${serviceType}" "${description}"`, {
+            cwd: gtmPath,
+            stdio: "inherit",
+        });
+        console.log(chalk.green("✓ Service agent infrastructure created"));
+    }
+    catch (err) {
+        console.log(chalk.yellow("⚠️  GTM onboard script failed (Service Manager may not be running)"));
+        console.log(chalk.gray("   Continuing with basic setup..."));
+        // Don't throw - continue with our own setup
+    }
+}
+/**
+ * Update GTM services.json
+ */
+function updateServicesJSON(metadata, servicePath, gtmPath) {
+    const servicesFile = join(gtmPath, ".jfl/services.json");
+    if (!existsSync(servicesFile)) {
+        console.log(chalk.yellow("⚠️  services.json not found, skipping"));
+        return;
+    }
+    const services = JSON.parse(readFileSync(servicesFile, "utf-8"));
+    // Check if service already exists
+    if (services[metadata.name]) {
+        console.log(chalk.yellow(`  Service ${metadata.name} already in services.json, updating...`));
+    }
+    // Build service entry
+    const serviceEntry = {
+        name: metadata.name.charAt(0).toUpperCase() + metadata.name.slice(1),
+        type: metadata.type === "web" || metadata.type === "api" ? "process" : metadata.type,
+        description: metadata.description,
+        path: servicePath,
+    };
+    if (metadata.port) {
+        serviceEntry.port = metadata.port;
+        serviceEntry.detection = `lsof -i :${metadata.port} | grep LISTEN`;
+    }
+    if (metadata.commands) {
+        serviceEntry.commands = {};
+        if (metadata.commands.start)
+            serviceEntry.commands.start = metadata.commands.start;
+        if (metadata.commands.stop)
+            serviceEntry.commands.stop = metadata.commands.stop;
+        if (metadata.commands.logs)
+            serviceEntry.commands.logs = metadata.commands.logs;
+    }
+    if (metadata.healthcheck) {
+        serviceEntry.healthcheck = metadata.healthcheck;
+    }
+    // Add to services
+    services[metadata.name] = serviceEntry;
+    // Write back
+    writeFileSync(servicesFile, JSON.stringify(services, null, 2) + "\n");
+    console.log(chalk.green(`✓ Updated services.json`));
+}
+/**
+ * Update GTM projects.manifest.json
+ */
+function updateProjectsManifest(metadata, servicePath, gtmPath) {
+    const manifestFile = join(gtmPath, ".jfl/projects.manifest.json");
+    if (!existsSync(manifestFile)) {
+        console.log(chalk.yellow("⚠️  projects.manifest.json not found, skipping"));
+        return;
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, "utf-8"));
+    // Check if already exists
+    if (manifest.projects && manifest.projects[metadata.name]) {
+        // Update agent_enabled flag
+        manifest.projects[metadata.name].agent_enabled = true;
+        console.log(chalk.yellow(`  Service ${metadata.name} already in manifest, enabled agent`));
+    }
+    else {
+        // Add new entry
+        if (!manifest.projects) {
+            manifest.projects = {};
+        }
+        manifest.projects[metadata.name] = {
+            type: "service",
+            service_type: metadata.type,
+            location: servicePath,
+            description: metadata.description,
+            agent_enabled: true,
+        };
+        console.log(chalk.green(`✓ Added to projects.manifest.json`));
+    }
+    // Write back
+    writeFileSync(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
+}
+/**
+ * Create basic service directory structure
+ */
+function createServiceStructure(servicePath, serviceName) {
+    // Create .jfl directory
+    const jflDir = join(servicePath, ".jfl");
+    mkdirSync(join(jflDir, "journal"), { recursive: true });
+    mkdirSync(join(jflDir, "logs"), { recursive: true });
+    // Create .claude directory
+    const claudeDir = join(servicePath, ".claude");
+    mkdirSync(join(claudeDir, "skills"), { recursive: true });
+    mkdirSync(join(claudeDir, "agents"), { recursive: true });
+    // Create knowledge directory
+    mkdirSync(join(servicePath, "knowledge"), { recursive: true });
+    console.log(chalk.green("✓ Created service directory structure"));
+}
+/**
+ * Set up service-GTM link
+ */
+function setupServiceGTMLink(servicePath, serviceName, serviceType, description, gtmPath, workingBranch, metadata) {
+    // 1. Create/update service's .jfl/config.json
+    const serviceJflDir = join(servicePath, ".jfl");
+    mkdirSync(serviceJflDir, { recursive: true });
+    const serviceConfigPath = join(serviceJflDir, "config.json");
+    let serviceConfig;
+    if (existsSync(serviceConfigPath)) {
+        serviceConfig = JSON.parse(readFileSync(serviceConfigPath, "utf-8"));
+    }
+    else {
+        serviceConfig = {
+            name: serviceName,
+            type: "service",
+            description,
+        };
+    }
+    // Set service-specific fields
+    serviceConfig.type = "service";
+    serviceConfig.service_type = serviceType;
+    serviceConfig.gtm_parent = gtmPath;
+    serviceConfig.working_branch = workingBranch;
+    serviceConfig.sync_to_parent = {
+        journal: true,
+        knowledge: false,
+        content: false,
+    };
+    // Add environments config with detected commands
+    if (metadata) {
+        serviceConfig.environments = {
+            development: {
+                code_path: servicePath,
+                start_command: metadata.commands?.start || "echo 'No start command configured'",
+                port: metadata.port || null,
+                env: { NODE_ENV: "development" },
+                health_check: metadata.healthcheck ? {
+                    enabled: true,
+                    url: metadata.healthcheck,
+                    interval: 30000,
+                    timeout: 5000
+                } : null
+            }
+        };
+    }
+    writeFileSync(serviceConfigPath, JSON.stringify(serviceConfig, null, 2) + "\n");
+    console.log(chalk.green(`✓ Created service config at ${servicePath}/.jfl/config.json`));
+    // 2. Update GTM's .jfl/config.json to register this service
+    const gtmConfigPath = join(gtmPath, ".jfl", "config.json");
+    if (existsSync(gtmConfigPath)) {
+        const gtmConfig = JSON.parse(readFileSync(gtmConfigPath, "utf-8"));
+        // Initialize registered_services if needed
+        if (!gtmConfig.registered_services) {
+            gtmConfig.registered_services = [];
+        }
+        // Check if already registered
+        const existing = gtmConfig.registered_services.find((s) => s.name === serviceName);
+        if (existing) {
+            // Update existing
+            existing.status = "active";
+            existing.type = serviceType;
+        }
+        else {
+            // Add new
+            const relativePath = resolve(servicePath).replace(resolve(gtmPath) + "/", "");
+            gtmConfig.registered_services.push({
+                name: serviceName,
+                path: relativePath,
+                type: serviceType,
+                registered_at: new Date().toISOString(),
+                status: "active",
+            });
+        }
+        writeFileSync(gtmConfigPath, JSON.stringify(gtmConfig, null, 2) + "\n");
+        console.log(chalk.green(`✓ Registered service in GTM config`));
+    }
+}
+/**
+ * Emit onboard event to service-events.jsonl
+ */
+function emitOnboardEvent(metadata, gtmPath) {
+    const eventsFile = join(gtmPath, ".jfl/service-events.jsonl");
+    const event = {
+        ts: new Date().toISOString(),
+        service: metadata.name,
+        type: "onboard",
+        message: `Service agent onboarded for ${metadata.name}`,
+        session: "jfl-cli",
+    };
+    try {
+        const eventLine = JSON.stringify(event) + "\n";
+        if (existsSync(eventsFile)) {
+            // Append
+            const currentContent = readFileSync(eventsFile, "utf-8");
+            writeFileSync(eventsFile, currentContent + eventLine);
+        }
+        else {
+            // Create new
+            writeFileSync(eventsFile, eventLine);
+        }
+        console.log(chalk.green(`✓ Emitted onboard event`));
+    }
+    catch (err) {
+        console.log(chalk.yellow(`⚠️  Failed to emit event: ${err.message}`));
+    }
+}
+/**
+ * Main onboard command
+ */
+export async function onboardCommand(pathOrUrl, options = {}) {
+    p.intro(chalk.hex("#FFD700")("┌  JFL - Onboard Service Agent"));
+    // Find GTM directory
+    const gtmPath = findGTMDirectory();
+    if (!gtmPath) {
+        p.log.error("Not in a GTM directory");
+        p.log.info("Run this command from inside a JFL GTM workspace");
+        p.log.info("Or run: jfl init to create a new GTM workspace");
+        p.outro(chalk.red("Onboarding failed"));
+        return;
+    }
+    console.log(chalk.gray(`GTM Path: ${gtmPath}\n`));
+    let servicePath;
+    // Determine if path or URL
+    const isGitURL = pathOrUrl.startsWith("git@") ||
+        pathOrUrl.startsWith("https://") ||
+        pathOrUrl.startsWith("http://");
+    if (isGitURL && !options.skipGit) {
+        // Clone the repository
+        console.log(chalk.cyan("📦 Git repository detected"));
+        servicePath = await cloneRepository(pathOrUrl);
+        console.log();
+    }
+    else {
+        // Resolve local path
+        servicePath = resolve(pathOrUrl);
+        if (!existsSync(servicePath)) {
+            p.log.error(`Path does not exist: ${servicePath}`);
+            p.outro(chalk.red("Onboarding failed"));
+            return;
+        }
+        console.log(chalk.gray(`Service Path: ${servicePath}\n`));
+    }
+    // Auto-detect service metadata (but will ask user to confirm/override)
+    const spinner = ora("Auto-detecting service metadata...").start();
+    let detectedMetadata;
+    try {
+        detectedMetadata = extractServiceMetadata(servicePath);
+        spinner.succeed("Service metadata detected");
+    }
+    catch (err) {
+        spinner.fail("Auto-detection failed, will ask for details");
+        // Create empty metadata
+        detectedMetadata = {
+            name: basename(servicePath),
+            type: "api",
+            description: "",
+            version: "0.1.0",
+            dependencies: [],
+            commands: {},
+            port: null
+        };
+    }
+    console.log();
+    p.note(`Auto-detected:\n` +
+        `  Name: ${chalk.cyan(detectedMetadata.name)}\n` +
+        `  Type: ${chalk.cyan(detectedMetadata.type)}\n` +
+        `  Description: ${chalk.gray(detectedMetadata.description || "N/A")}\n` +
+        `  Port: ${detectedMetadata.port ? chalk.cyan(detectedMetadata.port) : chalk.gray("N/A")}`, "🔍 Detection Results");
+    console.log(chalk.cyan("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(chalk.cyan("  Service Configuration Wizard"));
+    console.log(chalk.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
+    // Interactive wizard
+    const serviceName = options.name || await p.text({
+        message: "Service name?",
+        placeholder: detectedMetadata.name,
+        initialValue: detectedMetadata.name,
+        validate: (value) => {
+            if (!value)
+                return "Service name is required";
+            if (!/^[a-z0-9-]+$/.test(value))
+                return "Use lowercase, numbers, and hyphens only";
+            return undefined;
+        }
+    });
+    if (p.isCancel(serviceName)) {
+        p.cancel("Onboarding cancelled");
+        return;
+    }
+    const serviceType = options.type || await p.select({
+        message: "Service type?",
+        options: [
+            { value: "api", label: "API - REST/GraphQL service", hint: detectedMetadata.type === "api" ? "detected" : "" },
+            { value: "web", label: "Web - Frontend application", hint: detectedMetadata.type === "web" ? "detected" : "" },
+            { value: "worker", label: "Worker - Background jobs/queue", hint: detectedMetadata.type === "worker" ? "detected" : "" },
+            { value: "cli", label: "CLI - Command-line tool", hint: detectedMetadata.type === "cli" ? "detected" : "" },
+            { value: "library", label: "Library - Plugin, package, or shared code", hint: detectedMetadata.type === "library" ? "detected" : "" },
+            { value: "infrastructure", label: "Infrastructure - Database, cache, etc.", hint: detectedMetadata.type === "infrastructure" ? "detected" : "" },
+            { value: "container", label: "Container - Docker service", hint: detectedMetadata.type === "container" ? "detected" : "" },
+        ],
+        initialValue: detectedMetadata.type
+    });
+    if (p.isCancel(serviceType)) {
+        p.cancel("Onboarding cancelled");
+        return;
+    }
+    const description = options.description || await p.text({
+        message: "Service description?",
+        placeholder: detectedMetadata.description || "What does this service do?",
+        initialValue: detectedMetadata.description,
+        validate: (value) => {
+            if (!value)
+                return "Description is required";
+            return undefined;
+        }
+    });
+    if (p.isCancel(description)) {
+        p.cancel("Onboarding cancelled");
+        return;
+    }
+    const hasPort = await p.confirm({
+        message: "Does this service expose a port?",
+        initialValue: !!detectedMetadata.port
+    });
+    if (p.isCancel(hasPort)) {
+        p.cancel("Onboarding cancelled");
+        return;
+    }
+    let port;
+    if (hasPort) {
+        const portInput = await p.text({
+            message: "Port number?",
+            placeholder: detectedMetadata.port?.toString() || "3000",
+            initialValue: detectedMetadata.port?.toString() || "",
+            validate: (value) => {
+                const num = parseInt(value, 10);
+                if (isNaN(num) || num < 1 || num > 65535)
+                    return "Enter a valid port (1-65535)";
+                return undefined;
+            }
+        });
+        if (p.isCancel(portInput)) {
+            p.cancel("Onboarding cancelled");
+            return;
+        }
+        port = parseInt(portInput, 10);
+    }
+    // If no start command detected, prompt user (skip for library types)
+    if (!detectedMetadata.commands?.start && serviceType !== "library") {
+        console.log();
+        p.note(`Could not auto-detect start command.\n\n` +
+            `Examples:\n` +
+            `  • npm run dev\n` +
+            `  • yarn start\n` +
+            `  • make run\n` +
+            `  • docker-compose up\n` +
+            `  • python manage.py runserver\n` +
+            `  • go run main.go\n` +
+            `  • mint dev`, "⚠️  Manual Input Required");
+        const startCommand = await p.text({
+            message: "How do you start this service in development?",
+            placeholder: "npm run dev",
+            validate: (value) => {
+                if (!value)
+                    return "Start command is required";
+                return undefined;
+            }
+        });
+        if (p.isCancel(startCommand)) {
+            p.cancel("Onboarding cancelled");
+            return;
+        }
+        detectedMetadata.commands = { ...detectedMetadata.commands, start: startCommand };
+        console.log(chalk.green(`✓ Using: ${startCommand}`));
+    }
+    else if (serviceType === "library" && !detectedMetadata.commands?.start) {
+        // For libraries, start command is optional - use build if available, otherwise skip
+        console.log(chalk.gray("ℹ  Libraries don't require a start command (not standalone services)"));
+    }
+    const enableMCP = await p.confirm({
+        message: "Enable MCP (Model Context Protocol) for AI agent coordination?",
+        initialValue: false
+    });
+    if (p.isCancel(enableMCP)) {
+        p.cancel("Onboarding cancelled");
+        return;
+    }
+    // Ask for working branch
+    const workingBranch = await p.text({
+        message: "Working branch? (session branches will be created from this)",
+        placeholder: "main",
+        initialValue: "main",
+        validate: (value) => {
+            if (!value)
+                return "Working branch is required";
+            if (!/^[a-zA-Z0-9/_-]+$/.test(value))
+                return "Invalid branch name";
+            return undefined;
+        }
+    });
+    if (p.isCancel(workingBranch)) {
+        p.cancel("Onboarding cancelled");
+        return;
+    }
+    // Build final metadata
+    const metadata = {
+        name: serviceName,
+        type: serviceType,
+        description: description,
+        version: detectedMetadata.version,
+        dependencies: detectedMetadata.dependencies,
+        commands: detectedMetadata.commands,
+        port: port || null
+    };
+    console.log();
+    p.note(`Name:           ${chalk.cyan(metadata.name)}\n` +
+        `Type:           ${chalk.cyan(metadata.type)}\n` +
+        `Description:    ${chalk.gray(metadata.description)}\n` +
+        `Port:           ${metadata.port ? chalk.cyan(metadata.port) : chalk.gray("None")}\n` +
+        `Working Branch: ${chalk.cyan(workingBranch)}\n` +
+        `MCP:            ${enableMCP ? chalk.green("Enabled") : chalk.gray("Disabled")}\n` +
+        `Version:        ${chalk.gray(metadata.version)}`, chalk.hex("#00FF88")("📋 Final Configuration"));
+    const confirmed = await p.confirm({
+        message: "Proceed with onboarding?",
+        initialValue: true,
+    });
+    if (p.isCancel(confirmed) || !confirmed) {
+        p.cancel("Onboarding cancelled");
+        return;
+    }
+    // Write service.json with MCP config if enabled
+    if (enableMCP) {
+        const serviceJsonPath = join(servicePath, "service.json");
+        const serviceJson = {
+            name: metadata.name,
+            version: metadata.version,
+            type: metadata.type,
+            description: metadata.description,
+            mcp: {
+                enabled: true,
+                transport: "stdio",
+                capabilities: {
+                    tools: true,
+                    resources: true
+                }
+            }
+        };
+        if (existsSync(serviceJsonPath)) {
+            const existing = JSON.parse(readFileSync(serviceJsonPath, "utf-8"));
+            Object.assign(existing, serviceJson);
+            writeFileSync(serviceJsonPath, JSON.stringify(existing, null, 2) + "\n");
+        }
+        else {
+            writeFileSync(serviceJsonPath, JSON.stringify(serviceJson, null, 2) + "\n");
+        }
+        console.log(chalk.green("✓ Created service.json with MCP config"));
+    }
+    console.log();
+    // Step 1: Run GTM onboard-service.sh script
+    console.log(chalk.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(chalk.cyan("  Step 1: Service Agent Infrastructure"));
+    console.log(chalk.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
+    runGTMOnboardScript(servicePath, metadata.name, metadata.type, metadata.description, gtmPath);
+    // Ensure basic service structure exists (in case script failed)
+    createServiceStructure(servicePath, metadata.name);
+    // Set up service-GTM link (for sync)
+    setupServiceGTMLink(servicePath, metadata.name, metadata.type, metadata.description, gtmPath, workingBranch, metadata);
+    console.log();
+    // Step 2: Generate agent definition
+    console.log(chalk.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(chalk.cyan("  Step 2: GTM Agent Integration"));
+    console.log(chalk.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
+    // Migrate any old-style agent files first
+    const agentsDir = join(gtmPath, ".claude", "agents");
+    const migration = migrateAgentFiles(agentsDir);
+    if (migration.renamed.length > 0) {
+        console.log(chalk.yellow(`  Migrated ${migration.renamed.length} agent file(s) to clean names`));
+        for (const r of migration.renamed) {
+            console.log(chalk.dim(`    ${r.from} → ${r.to}`));
+        }
+    }
+    const agentDef = generateAgentDefinition(metadata, servicePath, gtmPath);
+    const agentFile = writeAgentDefinition(agentDef, gtmPath);
+    console.log(chalk.green(`✓ Created agent definition: ${agentFile}`));
+    // Step 2.5: Sync peer agents
+    console.log(chalk.cyan("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(chalk.cyan("  Peer Agent Synchronization"));
+    console.log(chalk.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
+    try {
+        // Sync peer agents for this new service
+        const peerSyncResult = syncPeerAgents(servicePath, gtmPath);
+        console.log(chalk.green(`✓ Synced ${peerSyncResult.added} peer agent(s) to this service`));
+        // Also sync TO other services (add this new service as a peer)
+        const registeredServices = getRegisteredServices(gtmPath);
+        let peersUpdated = 0;
+        for (const peer of registeredServices) {
+            if (peer.name !== metadata.name) {
+                const peerPath = resolve(peer.path.startsWith("/") ? peer.path : join(gtmPath, peer.path));
+                if (existsSync(peerPath)) {
+                    try {
+                        const peerResult = syncPeerAgents(peerPath, gtmPath);
+                        if (peerResult.added > 0 || peerResult.updated > 0) {
+                            peersUpdated++;
+                        }
+                    }
+                    catch (err) {
+                        // Non-fatal - peer sync can fail if peer service isn't fully set up
+                        console.log(chalk.yellow(`⚠️  Could not sync to peer ${peer.name}: ${err.message}`));
+                    }
+                }
+            }
+        }
+        if (peersUpdated > 0) {
+            console.log(chalk.green(`✓ Updated ${peersUpdated} peer service(s) with this service`));
+        }
+    }
+    catch (error) {
+        console.log(chalk.yellow(`⚠️  Peer sync failed: ${error.message}`));
+        console.log(chalk.gray("   Run 'jfl services sync-agents' later to sync peer agents"));
+    }
+    // Step 2.6: Discover metrics and create RL agent configs
+    console.log(chalk.cyan("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(chalk.cyan("  RL Agent Discovery"));
+    console.log(chalk.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
+    const discoveredMetrics = discoverServiceMetrics(servicePath, metadata.name);
+    if (discoveredMetrics.length > 0) {
+        console.log(chalk.gray(`  Discovered ${discoveredMetrics.length} metrics for ${metadata.name}:`));
+        for (const m of discoveredMetrics) {
+            console.log(chalk.gray(`    • ${m.name} (${m.direction}, source: ${m.source})`));
+        }
+        console.log();
+        const rlResult = createRLAgentConfigs(discoveredMetrics, servicePath, metadata.name, gtmPath);
+        console.log(chalk.green(`✓ Created ${rlResult.created} RL agent config(s)`));
+        console.log(chalk.gray(`  Eval scripts: ${rlResult.evalScripts.join(", ")}`));
+    }
+    else {
+        console.log(chalk.gray("  No metrics discovered for this service"));
+        console.log(chalk.gray("  You can manually create RL agents with: jfl peter agent create"));
+    }
+    console.log();
+    // Step 3: Generate skill wrapper
+    const skillDir = writeSkillFiles(metadata, servicePath, gtmPath);
+    console.log(chalk.green(`✓ Created skill wrapper: ${skillDir}`));
+    // Step 4: Update GTM manifests
+    updateServicesJSON(metadata, servicePath, gtmPath);
+    updateProjectsManifest(metadata, servicePath, gtmPath);
+    // Step 5: Emit event
+    emitOnboardEvent(metadata, gtmPath);
+    console.log();
+    // Success summary
+    p.note(`Service agent is ready!\n\n` +
+        `Now you can:\n` +
+        `  • Use @-mentions: ${chalk.cyan(`@${metadata.name} what's your status?`)}\n` +
+        `  • Run skill commands: ${chalk.cyan(`/${metadata.name} status`)}\n` +
+        `  • Service agent manages its own codebase\n\n` +
+        `Files created:\n` +
+        `  ${chalk.gray(`${servicePath}/CLAUDE.md`)}\n` +
+        `  ${chalk.gray(`${servicePath}/.jfl/`)}\n` +
+        `  ${chalk.gray(`${servicePath}/.claude/`)}\n` +
+        `  ${chalk.gray(`${servicePath}/knowledge/`)}\n` +
+        `  ${chalk.gray(`${gtmPath}/.claude/agents/${metadata.name}.md`)}\n` +
+        `  ${chalk.gray(`${gtmPath}/.claude/skills/${metadata.name}/`)}\n\n` +
+        `Next steps:\n` +
+        `  1. Fill in service knowledge docs:\n` +
+        `     ${chalk.cyan(`cd ${servicePath}`)}\n` +
+        `     ${chalk.gray(`# Edit knowledge/SERVICE_SPEC.md`)}\n` +
+        `     ${chalk.gray(`# Edit knowledge/ARCHITECTURE.md`)}\n` +
+        `     ${chalk.gray(`# Edit knowledge/DEPLOYMENT.md`)}\n` +
+        `     ${chalk.gray(`# Edit knowledge/RUNBOOK.md`)}\n\n` +
+        `  2. Test the service agent:\n` +
+        `     ${chalk.cyan(`cd ${servicePath}`)}\n` +
+        `     ${chalk.cyan(`claude`)}\n` +
+        `     ${chalk.gray(`# Should greet you as service agent`)}\n\n` +
+        `  3. Test @-mention from GTM:\n` +
+        `     ${chalk.cyan(`cd ${gtmPath}`)}\n` +
+        `     ${chalk.cyan(`claude`)}\n` +
+        `     ${chalk.cyan(`> @${metadata.name} what's your status?`)}`, chalk.hex("#00FF88")("✅ Service Onboarded Successfully"));
+    p.outro(chalk.hex("#FFA500")("Happy shipping! 🚀"));
+}
+//# sourceMappingURL=onboard.js.map