jfl 0.1.0 → 0.2.0

package/dist/lib/service-utils.js

@@ -0,0 +1,368 @@
+/**
+ * Service Management Utilities
+ *
+ * Shared utilities for service lifecycle management across commands.
+ * Provides version tracking, health checks, and restart logic.
+ *
+ * @purpose Shared service management utilities for update flow
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { execSync } from "child_process";
+import chalk from "chalk";
+import ora from "ora";
+import { JFL_PATHS } from "../utils/jfl-paths.js";
+// ============================================================================
+// Version Tracking
+// ============================================================================
+const CLI_VERSION_FILE = path.join(JFL_PATHS.data, "cli-version.json");
+/**
+ * Get current CLI version from package.json
+ */
+export function getCurrentCliVersion() {
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, "../../package.json"), "utf-8"));
+        return packageJson.version;
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/**
+ * Read stored CLI version info
+ */
+export function readCliVersion() {
+    if (!fs.existsSync(CLI_VERSION_FILE)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(CLI_VERSION_FILE, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write CLI version info
+ */
+export function writeCliVersion(version, services) {
+    const dir = path.dirname(CLI_VERSION_FILE);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const versionInfo = {
+        version,
+        updated_at: new Date().toISOString(),
+        services: services || {
+            "context-hub": { version, port: 4242 },
+            "service-manager": { version, port: 3402 }
+        }
+    };
+    fs.writeFileSync(CLI_VERSION_FILE, JSON.stringify(versionInfo, null, 2));
+}
+/**
+ * Detect if services have changed (CLI version bump)
+ */
+export async function detectServiceChanges() {
+    const currentVersion = getCurrentCliVersion();
+    const storedInfo = readCliVersion();
+    if (!storedInfo) {
+        // First time - no stored version yet
+        return { changed: false, newVersion: currentVersion };
+    }
+    const changed = storedInfo.version !== currentVersion;
+    return {
+        changed,
+        oldVersion: storedInfo.version,
+        newVersion: currentVersion
+    };
+}
+// ============================================================================
+// Service Health Checks
+// ============================================================================
+/**
+ * Check if a service is running via health endpoint
+ */
+export async function waitForHealthy(url, timeout = 5000) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 2000);
+            const response = await fetch(url, {
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (response.ok) {
+                return true;
+            }
+        }
+        catch {
+            // Health check failed, retry
+        }
+        // Wait 500ms before retry
+        await new Promise(resolve => setTimeout(resolve, 500));
+    }
+    return false;
+}
+/**
+ * Check if a service is running via PID file
+ */
+export function isServiceRunningViaPid(pidFile) {
+    if (!fs.existsSync(pidFile)) {
+        return { running: false };
+    }
+    try {
+        const pid = parseInt(fs.readFileSync(pidFile, "utf-8").trim(), 10);
+        process.kill(pid, 0); // Check if process exists
+        return { running: true, pid };
+    }
+    catch {
+        // Process doesn't exist, clean up stale PID file
+        try {
+            fs.unlinkSync(pidFile);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        return { running: false };
+    }
+}
+/**
+ * Check health of a service
+ */
+export async function checkServiceHealth(serviceName, healthUrl, pidFile) {
+    // If health URL provided, check that
+    if (healthUrl) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 3000);
+            const response = await fetch(healthUrl, {
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (response.ok) {
+                const data = await response.json().catch(() => ({}));
+                return {
+                    healthy: true,
+                    message: `${serviceName} is healthy`,
+                    port: data.port
+                };
+            }
+            return {
+                healthy: false,
+                message: `${serviceName} health check failed: HTTP ${response.status}`
+            };
+        }
+        catch (err) {
+            return {
+                healthy: false,
+                message: `${serviceName} health check failed: ${err.message}`
+            };
+        }
+    }
+    // Fallback to PID file check
+    if (pidFile) {
+        const status = isServiceRunningViaPid(pidFile);
+        return {
+            healthy: status.running,
+            message: status.running
+                ? `${serviceName} is running (PID: ${status.pid})`
+                : `${serviceName} is not running`
+        };
+    }
+    return {
+        healthy: false,
+        message: `Cannot determine health for ${serviceName} (no health URL or PID file)`
+    };
+}
+// ============================================================================
+// Service Control
+// ============================================================================
+/**
+ * Wait for a service to stop
+ */
+async function waitForStop(pidFile, timeout) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        if (!fs.existsSync(pidFile)) {
+            return true;
+        }
+        try {
+            const pid = parseInt(fs.readFileSync(pidFile, "utf-8").trim(), 10);
+            process.kill(pid, 0); // Check if process exists
+        }
+        catch {
+            // Process is gone
+            return true;
+        }
+        await new Promise(resolve => setTimeout(resolve, 200));
+    }
+    return false;
+}
+/**
+ * Execute a command silently
+ */
+function execSilent(command) {
+    try {
+        execSync(command, { stdio: "pipe" });
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+/**
+ * Restart a service with health validation
+ */
+export async function restartService(serviceName, opts) {
+    const spinner = ora(`Restarting ${serviceName}...`).start();
+    try {
+        // 1. Stop the service
+        const stopResult = execSilent(opts.stopCommand);
+        if (stopResult.success) {
+            spinner.text = `${serviceName} stopped, starting...`;
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+        // 2. Start the service
+        const startResult = execSilent(opts.startCommand);
+        if (!startResult.success) {
+            spinner.fail(`${serviceName} failed to start`);
+            return {
+                success: false,
+                message: `Failed to start: ${startResult.error}`
+            };
+        }
+        // 3. Wait a moment for startup
+        await new Promise(resolve => setTimeout(resolve, 800));
+        // 4. Health check if URL provided
+        if (opts.healthCheck) {
+            spinner.text = `Checking ${serviceName} health...`;
+            const healthy = await waitForHealthy(opts.healthCheck, opts.timeout || 5000);
+            if (healthy) {
+                spinner.succeed(`${serviceName} restarted`);
+                return { success: true, message: "Service restarted and healthy" };
+            }
+            else {
+                spinner.warn(`${serviceName} started but health check failed`);
+                return {
+                    success: false,
+                    message: "Service started but not responding to health checks"
+                };
+            }
+        }
+        spinner.succeed(`${serviceName} restarted`);
+        return { success: true, message: "Service restarted" };
+    }
+    catch (error) {
+        spinner.fail(`${serviceName} restart failed`);
+        return {
+            success: false,
+            message: error.message
+        };
+    }
+}
+/**
+ * Ensure a service is running (start if not, validate if running)
+ */
+export async function ensureServiceRunning(serviceName, startCommand, healthCheck, pidFile) {
+    // Check if already running
+    if (pidFile) {
+        const status = isServiceRunningViaPid(pidFile);
+        if (status.running && healthCheck) {
+            // Verify health
+            const healthy = await waitForHealthy(healthCheck, 2000);
+            if (healthy) {
+                return { success: true, message: `${serviceName} already running` };
+            }
+            // Process exists but not healthy - fall through to restart
+        }
+        else if (status.running) {
+            return { success: true, message: `${serviceName} already running` };
+        }
+    }
+    // Start the service
+    const result = execSilent(startCommand);
+    if (!result.success) {
+        return {
+            success: false,
+            message: `Failed to start: ${result.error}`
+        };
+    }
+    // Wait for startup
+    await new Promise(resolve => setTimeout(resolve, 800));
+    // Validate health if URL provided
+    if (healthCheck) {
+        const healthy = await waitForHealthy(healthCheck, 5000);
+        if (healthy) {
+            return { success: true, message: `${serviceName} started successfully` };
+        }
+        else {
+            return {
+                success: false,
+                message: `${serviceName} started but health check failed`
+            };
+        }
+    }
+    return { success: true, message: `${serviceName} started` };
+}
+// ============================================================================
+// Multi-Service Operations
+// ============================================================================
+/**
+ * Restart all core services (Context Hub + Service Manager)
+ */
+export async function restartCoreServices(options = {}) {
+    const results = {
+        contextHub: false,
+        serviceManager: false
+    };
+    console.log(chalk.cyan("\n📦 Restarting services...\n"));
+    // Restart Context Hub
+    const contextHubResult = await restartService("context-hub", {
+        stopCommand: "jfl context-hub stop",
+        startCommand: "jfl context-hub ensure",
+        healthCheck: "http://localhost:4242/health",
+        timeout: 5000
+    });
+    results.contextHub = contextHubResult.success;
+    // Restart Service Manager
+    const serviceManagerResult = await restartService("service-manager", {
+        stopCommand: "jfl service-manager stop",
+        startCommand: "jfl service-manager ensure",
+        healthCheck: "http://localhost:3402/health",
+        timeout: 5000
+    });
+    results.serviceManager = serviceManagerResult.success;
+    return results;
+}
+/**
+ * Validate all core services are healthy
+ */
+export async function validateCoreServices() {
+    const issues = [];
+    // Check Context Hub
+    const contextHubHealth = await checkServiceHealth("context-hub", "http://localhost:4242/health", ".jfl/context-hub.pid");
+    if (!contextHubHealth.healthy) {
+        issues.push({
+            service: "context-hub",
+            message: contextHubHealth.message,
+            remedy: "Run: jfl context-hub restart"
+        });
+    }
+    // Check Service Manager
+    const serviceManagerHealth = await checkServiceHealth("service-manager", "http://localhost:3402/health", path.join(JFL_PATHS.data, "services", "pids", "service-manager.pid"));
+    if (!serviceManagerHealth.healthy) {
+        issues.push({
+            service: "service-manager",
+            message: serviceManagerHealth.message,
+            remedy: "Run: jfl service-manager restart"
+        });
+    }
+    return {
+        healthy: issues.length === 0,
+        issues
+    };
+}
+//# sourceMappingURL=service-utils.js.map

package/dist/lib/service-utils.js.map

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

package/dist/lib/skill-generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Skill Generator
+ *
+ * Generates service skill wrappers in GTM .claude/skills/ directory
+ *
+ * @purpose Generate skill wrappers for service agent invocation
+ */
+import type { ServiceMetadata } from "./service-detector.js";
+/**
+ * Generate skill definition (SKILL.md)
+ */
+export declare function generateSkillDefinition(metadata: ServiceMetadata, servicePath: string): string;
+/**
+ * Generate skill handler script
+ */
+export declare function generateSkillHandler(metadata: ServiceMetadata, servicePath: string, gtmPath: string): string;
+/**
+ * Write skill files to GTM repo
+ */
+export declare function writeSkillFiles(metadata: ServiceMetadata, servicePath: string, gtmPath: string): string;
+//# sourceMappingURL=skill-generator.d.ts.map

package/dist/lib/skill-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../src/lib/skill-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,GAClB,MAAM,CAmFR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAsIR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAoBR"}

package/dist/lib/skill-generator.js

@@ -0,0 +1,253 @@
+/**
+ * Skill Generator
+ *
+ * Generates service skill wrappers in GTM .claude/skills/ directory
+ *
+ * @purpose Generate skill wrappers for service agent invocation
+ */
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+/**
+ * Generate skill definition (SKILL.md)
+ */
+export function generateSkillDefinition(metadata, servicePath) {
+    const skillName = metadata.name;
+    return `---
+name: ${skillName}
+version: 1.0.0
+type: service
+description: ${metadata.description}
+service_path: ${servicePath}
+---
+
+# ${skillName} - Service Agent Skill
+
+Quick access to **${metadata.name}** service agent.
+
+## Usage
+
+\`\`\`
+/${skillName} [command]
+\`\`\`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| \`status\` | Show service status |
+| \`logs\` | Show service logs |
+| \`start\` | Start the service |
+| \`stop\` | Stop the service |
+| \`restart\` | Restart the service |
+| \`health\` | Check service health |
+| \`recent\` | Show recent changes |
+| \`deploy\` | Deploy to production (requires approval) |
+
+## Examples
+
+\`\`\`
+/${skillName} status
+/${skillName} logs
+/${skillName} restart
+/${skillName} deploy
+\`\`\`
+
+## How It Works
+
+This skill spawns the **service-${skillName}** agent with your request. The agent:
+
+1. Reads service knowledge docs (SERVICE_SPEC, ARCHITECTURE, DEPLOYMENT, RUNBOOK)
+2. Performs the requested operation
+3. Updates service status
+4. Emits event to GTM
+5. Writes journal entry if significant
+6. Returns the result
+
+## Metadata
+
+- **Type**: ${metadata.type}
+- **Port**: ${metadata.port || "N/A"}
+- **Version**: ${metadata.version}
+- **Dependencies**: ${metadata.dependencies.join(", ") || "None"}
+${metadata.healthcheck ? `- **Healthcheck**: \`${metadata.healthcheck}\`` : ""}
+
+## Service Path
+
+\`${servicePath}\`
+
+## Knowledge Docs
+
+- \`${servicePath}/knowledge/SERVICE_SPEC.md\`
+- \`${servicePath}/knowledge/ARCHITECTURE.md\`
+- \`${servicePath}/knowledge/DEPLOYMENT.md\`
+- \`${servicePath}/knowledge/RUNBOOK.md\`
+
+## Direct Invocation
+
+You can also invoke via @-mention in conversation:
+
+\`\`\`
+@${skillName} what's your current status?
+@${skillName} show me recent changes
+@${skillName} deploy latest changes
+\`\`\`
+`;
+}
+/**
+ * Generate skill handler script
+ */
+export function generateSkillHandler(metadata, servicePath, gtmPath) {
+    const skillName = metadata.name;
+    return `#!/bin/bash
+#
+# Service Agent Skill Handler: ${skillName}
+#
+# Routes skill invocations to service agent
+#
+
+set -e
+
+COMMAND="\${1:-status}"
+GTM_PATH="${gtmPath}"
+SERVICE_PATH="${servicePath}"
+SERVICE_NAME="${skillName}"
+
+# Validate command
+case "$COMMAND" in
+    status|logs|start|stop|restart|health|recent|deploy|help)
+        # Valid command
+        ;;
+    *)
+        echo "Unknown command: $COMMAND"
+        echo ""
+        echo "Available commands:"
+        echo "  status   - Show service status"
+        echo "  logs     - Show service logs"
+        echo "  start    - Start the service"
+        echo "  stop     - Stop the service"
+        echo "  restart  - Restart the service"
+        echo "  health   - Check service health"
+        echo "  recent   - Show recent changes"
+        echo "  deploy   - Deploy to production"
+        echo "  help     - Show this help"
+        exit 1
+        ;;
+esac
+
+# For help, show skill documentation
+if [[ "$COMMAND" == "help" ]]; then
+    cat << EOF
+Service Agent Skill: ${skillName}
+
+Commands:
+  /${skillName} status   - Show service status
+  /${skillName} logs     - Show service logs
+  /${skillName} start    - Start the service
+  /${skillName} stop     - Stop the service
+  /${skillName} restart  - Restart the service
+  /${skillName} health   - Check service health
+  /${skillName} recent   - Show recent changes
+  /${skillName} deploy   - Deploy to production
+
+Metadata:
+  Type:    ${metadata.type}
+  Port:    ${metadata.port || "N/A"}
+  Version: ${metadata.version}
+  Path:    ${servicePath}
+
+You can also use @-mentions:
+  @${skillName} what's your status?
+  @${skillName} show recent changes
+  @${skillName} deploy latest version
+EOF
+    exit 0
+fi
+
+# Quick status check (no agent spawn needed)
+if [[ "$COMMAND" == "status" ]]; then
+    if [[ -f "$SERVICE_PATH/.jfl/status.json" ]]; then
+        echo "Service Status: ${skillName}"
+        echo ""
+        jq '.' "$SERVICE_PATH/.jfl/status.json"
+    else
+        echo "Status file not found. Service may not be onboarded yet."
+        exit 1
+    fi
+    exit 0
+fi
+
+# Quick health check (no agent spawn needed)
+if [[ "$COMMAND" == "health" ]]; then
+    ${metadata.healthcheck || 'echo "No healthcheck defined"'}
+    exit $?
+fi
+
+# Quick recent changes (no agent spawn needed)
+if [[ "$COMMAND" == "recent" ]]; then
+    echo "Recent Changes: ${skillName}"
+    echo ""
+    if [[ -f "$SERVICE_PATH/.jfl/status.json" ]]; then
+        jq -r '.recent_changes[]' "$SERVICE_PATH/.jfl/status.json"
+    fi
+    echo ""
+    echo "Recent Journal Entries:"
+    cat "$SERVICE_PATH/.jfl/journal"/*.jsonl 2>/dev/null | tail -5 | jq -r '"\(.ts) - \(.title)"'
+    echo ""
+    echo "Recent Commits:"
+    cd "$SERVICE_PATH" && git log --oneline -5
+    exit 0
+fi
+
+# For other commands, this should spawn the service agent via Claude Code
+# Since we're in a skill handler, we need to return instructions for Claude
+cat << EOF
+[SPAWN_SERVICE_AGENT]
+Service: ${skillName}
+Command: $COMMAND
+Agent: service-${skillName}
+Working Directory: ${servicePath}
+
+Claude should:
+1. Spawn Task tool with subagent_type="general-purpose"
+2. Set working directory to: ${servicePath}
+3. Pass this request to the agent:
+
+   "You are the service agent for ${skillName}.
+
+   Your working directory is: ${servicePath}
+
+   Read your knowledge docs to understand the service:
+   - knowledge/SERVICE_SPEC.md
+   - knowledge/ARCHITECTURE.md
+   - knowledge/DEPLOYMENT.md
+   - knowledge/RUNBOOK.md
+
+   User request: $COMMAND the service
+
+   Execute the operation, update status, emit event, write journal, and report outcome."
+
+[/SPAWN_SERVICE_AGENT]
+EOF
+`;
+}
+/**
+ * Write skill files to GTM repo
+ */
+export function writeSkillFiles(metadata, servicePath, gtmPath) {
+    const skillName = metadata.name;
+    const skillDir = join(gtmPath, ".claude/skills", skillName);
+    // Ensure directory exists
+    if (!existsSync(skillDir)) {
+        mkdirSync(skillDir, { recursive: true });
+    }
+    // Write SKILL.md
+    const skillMd = generateSkillDefinition(metadata, servicePath);
+    const skillMdPath = join(skillDir, "SKILL.md");
+    writeFileSync(skillMdPath, skillMd);
+    // Write handler.sh
+    const handler = generateSkillHandler(metadata, servicePath, gtmPath);
+    const handlerPath = join(skillDir, "handler.sh");
+    writeFileSync(handlerPath, handler, { mode: 0o755 });
+    return skillDir;
+}
+//# sourceMappingURL=skill-generator.js.map

package/dist/lib/skill-generator.js.map

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