jfl 0.9.6 → 0.9.7

package/packages/pi/dist/service-skills.js

@@ -0,0 +1,198 @@
+/**
+ * Service Skills Bridge
+ *
+ * Scans .claude/skills/ for service-type skills (generated during jfl init
+ * service onboarding) and registers them as Pi commands + tools.
+ * This gives Pi parity with Claude Code's service agent access.
+ *
+ * Service skills in .claude/skills/ have frontmatter `type: service` and
+ * include commands like status, logs, start, stop, restart, health.
+ *
+ * @purpose Bridge .claude/skills/ service agents into Pi sessions
+ */
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const fm = {};
+    for (const line of match[1].split("\n")) {
+        const [key, ...rest] = line.split(":");
+        if (key && rest.length) {
+            fm[key.trim()] = rest.join(":").trim();
+        }
+    }
+    return fm;
+}
+function discoverServiceSkills(projectRoot) {
+    const claudeSkillsDir = join(projectRoot, ".claude", "skills");
+    if (!existsSync(claudeSkillsDir))
+        return [];
+    const skills = [];
+    try {
+        const entries = readdirSync(claudeSkillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillPath = join(claudeSkillsDir, entry.name, "SKILL.md");
+            if (!existsSync(skillPath))
+                continue;
+            try {
+                const content = readFileSync(skillPath, "utf-8");
+                const fm = parseFrontmatter(content);
+                if (fm.type !== "service")
+                    continue;
+                // Extract available commands from the markdown table
+                const commands = [];
+                const cmdMatch = content.match(/\| `(\w+)` \|/g);
+                if (cmdMatch) {
+                    for (const m of cmdMatch) {
+                        const cmd = m.match(/`(\w+)`/);
+                        if (cmd)
+                            commands.push(cmd[1]);
+                    }
+                }
+                // Fallback defaults
+                if (commands.length === 0) {
+                    commands.push("status", "logs", "start", "stop", "restart", "health", "recent");
+                }
+                skills.push({
+                    name: entry.name,
+                    description: fm.description || `${entry.name} service agent`,
+                    servicePath: fm.service_path || "",
+                    commands,
+                });
+            }
+            catch {
+                // Skip unparseable skills
+            }
+        }
+    }
+    catch {
+        // .claude/skills not readable
+    }
+    return skills;
+}
+function runServiceCommand(serviceName, command, servicePath, projectRoot) {
+    // Try jfl service-agent first
+    try {
+        const result = execSync(`jfl service-agent run ${serviceName} ${command}`, { cwd: projectRoot, encoding: "utf-8", timeout: 15000, stdio: ["pipe", "pipe", "pipe"] });
+        return result.trim();
+    }
+    catch {
+        // Fallback: direct execution based on command type
+    }
+    if (!servicePath || !existsSync(servicePath)) {
+        return `Service path not found: ${servicePath}`;
+    }
+    try {
+        switch (command) {
+            case "status": {
+                const branch = execSync("git branch --show-current", { cwd: servicePath, encoding: "utf-8" }).trim();
+                const lastCommit = execSync("git log -1 --pretty='%h %s (%cr)'", { cwd: servicePath, encoding: "utf-8" }).trim();
+                const dirty = execSync("git status --porcelain", { cwd: servicePath, encoding: "utf-8" }).trim();
+                return [
+                    `Service: ${serviceName}`,
+                    `Path: ${servicePath}`,
+                    `Branch: ${branch}`,
+                    `Last commit: ${lastCommit}`,
+                    `Working tree: ${dirty ? `${dirty.split("\n").length} changes` : "clean"}`,
+                ].join("\n");
+            }
+            case "logs": {
+                return execSync("git log --oneline -10", { cwd: servicePath, encoding: "utf-8" }).trim();
+            }
+            case "recent": {
+                const since = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+                try {
+                    return execSync(`git log --oneline --since="${since}"`, { cwd: servicePath, encoding: "utf-8" }).trim() || "No changes in last 24h";
+                }
+                catch {
+                    return "No changes in last 24h";
+                }
+            }
+            case "health": {
+                // Check if package.json exists and has a test script
+                const pkgPath = join(servicePath, "package.json");
+                if (existsSync(pkgPath)) {
+                    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+                    const hasTests = !!pkg.scripts?.test;
+                    const hasBuild = !!pkg.scripts?.build;
+                    return [
+                        `Service: ${serviceName}`,
+                        `Has tests: ${hasTests ? "yes" : "no"}`,
+                        `Has build: ${hasBuild ? "yes" : "no"}`,
+                        `Dependencies: ${Object.keys(pkg.dependencies || {}).length}`,
+                        `Dev dependencies: ${Object.keys(pkg.devDependencies || {}).length}`,
+                    ].join("\n");
+                }
+                return `No package.json found at ${servicePath}`;
+            }
+            default:
+                return `Unknown command: ${command}. Available: status, logs, recent, health`;
+        }
+    }
+    catch (err) {
+        return `Error running ${command} on ${serviceName}: ${err}`;
+    }
+}
+export async function setupServiceSkills(ctx, _config) {
+    const root = ctx.session.projectRoot;
+    const services = discoverServiceSkills(root);
+    if (services.length === 0)
+        return;
+    ctx.log(`Discovered ${services.length} service skill(s): ${services.map(s => s.name).join(", ")}`, "debug");
+    // Register a unified service tool
+    ctx.registerTool({
+        name: "jfl_service",
+        description: `Query registered service agents. Available services: ${services.map(s => s.name).join(", ")}. Commands: status, logs, recent, health, start, stop, restart.`,
+        promptSnippet: `Service agents: ${services.map(s => s.name).join(", ")}`,
+        promptGuidelines: [
+            `Use this tool to interact with registered services: ${services.map(s => s.name).join(", ")}`,
+            "Common commands: status (git info), logs (recent commits), recent (24h changes), health (package info)",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                service: {
+                    type: "string",
+                    description: `Service name: ${services.map(s => s.name).join(", ")}`,
+                    enum: services.map(s => s.name),
+                },
+                command: {
+                    type: "string",
+                    description: "Command to run on the service",
+                    enum: ["status", "logs", "recent", "health", "start", "stop", "restart"],
+                },
+            },
+            required: ["service", "command"],
+        },
+        async handler(input) {
+            const { service, command } = input;
+            const svc = services.find(s => s.name === service);
+            if (!svc)
+                return `Unknown service: ${service}. Available: ${services.map(s => s.name).join(", ")}`;
+            return runServiceCommand(service, command, svc.servicePath, root);
+        },
+    });
+    // Register per-service commands (e.g., /subclaw status, /subway-fe logs)
+    // Skip "subway" — /subway is owned by the mesh command (subway-mesh.ts or standalone ext).
+    // The jfl_service tool still covers all services including subway.
+    const reservedNames = new Set(["subway"]);
+    for (const svc of services) {
+        if (reservedNames.has(svc.name))
+            continue;
+        ctx.registerCommand({
+            name: svc.name,
+            description: `${svc.description} — commands: ${svc.commands.join(", ")}`,
+            async handler(args, _ctx) {
+                const command = args.trim().split(/\s+/)[0] || "status";
+                const result = runServiceCommand(svc.name, command, svc.servicePath, root);
+                ctx.ui.notify(result, { level: "info" });
+            },
+        });
+    }
+}
+//# sourceMappingURL=service-skills.js.map

package/packages/pi/dist/service-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-skills.js","sourceRoot":"","sources":["../extensions/service-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAUxC,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,MAAM,EAAE,GAA2B,EAAE,CAAA;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QACxC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC9D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,EAAE,CAAA;IAE3C,MAAM,MAAM,GAAmB,EAAE,CAAA;IAEjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAErE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAQ;YAElC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;YAC/D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,SAAQ;YAEpC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;gBAChD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;gBAEpC,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS;oBAAE,SAAQ;gBAEnC,qDAAqD;gBACrD,MAAM,QAAQ,GAAa,EAAE,CAAA;gBAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;gBAChD,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;wBACzB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;wBAC9B,IAAI,GAAG;4BAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;oBAChC,CAAC;gBACH,CAAC;gBACD,oBAAoB;gBACpB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;gBACjF,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,gBAAgB;oBAC5D,WAAW,EAAE,EAAE,CAAC,YAAY,IAAI,EAAE;oBAClC,QAAQ;iBACT,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB,EAAE,OAAe,EAAE,WAAmB,EAAE,WAAmB;IACvG,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CACrB,yBAAyB,WAAW,IAAI,OAAO,EAAE,EACjD,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACzF,CAAA;QACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,OAAO,2BAA2B,WAAW,EAAE,CAAA;IACjD,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBACpG,MAAM,UAAU,GAAG,QAAQ,CAAC,mCAAmC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBAChH,MAAM,KAAK,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBAChG,OAAO;oBACL,YAAY,WAAW,EAAE;oBACzB,SAAS,WAAW,EAAE;oBACtB,WAAW,MAAM,EAAE;oBACnB,gBAAgB,UAAU,EAAE;oBAC5B,iBAAiB,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE;iBAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACd,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,OAAO,QAAQ,CAAC,uBAAuB,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YAC1F,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;gBACtE,IAAI,CAAC;oBACH,OAAO,QAAQ,CAAC,8BAA8B,KAAK,GAAG,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,wBAAwB,CAAA;gBACrI,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,wBAAwB,CAAA;gBACjC,CAAC;YACH,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,qDAAqD;gBACrD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;gBACjD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;oBACtD,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAA;oBACpC,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAA;oBACrC,OAAO;wBACL,YAAY,WAAW,EAAE;wBACzB,cAAc,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;wBACvC,cAAc,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;wBACvC,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;wBAC7D,qBAAqB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;qBACrE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACd,CAAC;gBACD,OAAO,4BAA4B,WAAW,EAAE,CAAA;YAClD,CAAC;YAED;gBACE,OAAO,oBAAoB,OAAO,2CAA2C,CAAA;QACjF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,iBAAiB,OAAO,OAAO,WAAW,KAAK,GAAG,EAAE,CAAA;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAc,EAAE,OAAkB;IACzE,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAA;IACpC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAE5C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEjC,GAAG,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,MAAM,sBAAsB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAE3G,kCAAkC;IAClC,GAAG,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,wDAAwD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iEAAiE;QAC1K,aAAa,EAAE,mBAAmB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACxE,gBAAgB,EAAE;YAChB,uDAAuD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC7F,wGAAwG;SACzG;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACpE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAChC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;oBAC5C,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;iBACzE;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;SACjC;QACD,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAA6C,CAAA;YAC1E,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;YAClD,IAAI,CAAC,GAAG;gBAAE,OAAO,oBAAoB,OAAO,gBAAgB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;YAClG,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;QACnE,CAAC;KACF,CAAC,CAAA;IAEF,yEAAyE;IACzE,2FAA2F;IAC3F,mEAAmE;IACnE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEzC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAQ;QACzC,GAAG,CAAC,eAAe,CAAC;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,GAAG,CAAC,WAAW,gBAAgB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACxE,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAe;gBACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAA;gBACvD,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;gBAC1E,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;YAC1C,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/packages/pi/dist/session.d.ts

@@ -0,0 +1,24 @@
+/**
+ * JFL Session Extension
+ *
+ * Pi-native session lifecycle via Context Hub API.
+ * Calls POST /api/session/init on start and POST /api/session/end on shutdown.
+ * Hub handles sync, branch creation, doctor — single source of truth.
+ * Pi only manages the auto-commit daemon locally (needs a detached process).
+ *
+ * @purpose Pi session lifecycle — Hub API for init/end, local auto-commit daemon
+ */
+import type { PiContext, JflConfig } from "./types.js";
+export declare function setupSession(ctx: PiContext, _config: JflConfig): Promise<void>;
+export declare function getSessionBranch(): string;
+export declare function pivot(ctx: PiContext, summary?: string): Promise<{
+    ok: boolean;
+    pivotNumber: number;
+    committed: boolean;
+    commitHash: string | null;
+    filesChanged: number;
+    indexed: boolean;
+}>;
+export declare function onShutdown(ctx: PiContext): Promise<void>;
+export declare function getCurrentBranch(root: string): string;
+//# sourceMappingURL=session.d.ts.map

package/packages/pi/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../extensions/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAmHtD,wBAAsB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEpF;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAsB,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrE,EAAE,EAAE,OAAO,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAC,CAiDD;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAiI9D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWrD"}

package/packages/pi/dist/session.js

@@ -0,0 +1,394 @@
+/**
+ * JFL Session Extension
+ *
+ * Pi-native session lifecycle via Context Hub API.
+ * Calls POST /api/session/init on start and POST /api/session/end on shutdown.
+ * Hub handles sync, branch creation, doctor — single source of truth.
+ * Pi only manages the auto-commit daemon locally (needs a detached process).
+ *
+ * @purpose Pi session lifecycle — Hub API for init/end, local auto-commit daemon
+ */
+import { execSync, spawn } from "child_process";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { hubUrl, authToken } from "./map-bridge.js";
+let autoCommitProcess = null;
+let sessionBranch = "";
+/**
+ * Create a session branch locally without the Hub.
+ * Parity with scripts/session/session-init.sh:
+ * 1. Commit or stash dirty state
+ * 2. If on a stale session branch, try to switch to working branch
+ * 3. Create new session branch from clean base
+ * 4. Pop stash if needed
+ */
+function createSessionBranchLocally(root, ctx) {
+    // Generate session branch name
+    const user = (() => {
+        try {
+            return execSync("git config user.name", { cwd: root, stdio: ["pipe", "pipe", "pipe"] })
+                .toString().trim().replace(/\s+/g, "-").toLowerCase().replace(/[^a-z0-9-]/g, "").slice(0, 30) || "user";
+        }
+        catch {
+            return "user";
+        }
+    })();
+    const now = new Date();
+    const dateStr = now.toISOString().slice(0, 10).replace(/-/g, "");
+    const timeStr = now.toISOString().slice(11, 16).replace(":", "");
+    const randomId = Math.random().toString(16).slice(2, 8);
+    const branchName = `session-${user}-${dateStr}-${timeStr}-${randomId}`;
+    // Get working branch from config
+    let workingBranch = "main";
+    const configPath = join(root, ".jfl", "config.json");
+    if (existsSync(configPath)) {
+        try {
+            const cfg = JSON.parse(readFileSync(configPath, "utf-8"));
+            if (cfg.working_branch)
+                workingBranch = cfg.working_branch;
+        }
+        catch { }
+    }
+    // Step 1: Commit or stash dirty state so checkout doesn't fail
+    let stashed = false;
+    try {
+        const status = execSync("git status --porcelain", { cwd: root, timeout: 5000, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+        if (status) {
+            try {
+                execSync("git add -A && git commit -m 'auto: session-init save before branch switch' --no-verify", { cwd: root, timeout: 10000, stdio: ["pipe", "pipe", "pipe"] });
+            }
+            catch {
+                // Commit failed — stash instead
+                try {
+                    execSync("git stash push -m 'jfl-session-init-stash' --include-untracked", { cwd: root, timeout: 10000, stdio: ["pipe", "pipe", "pipe"] });
+                    stashed = true;
+                }
+                catch { }
+            }
+        }
+    }
+    catch { }
+    // Step 2: If on a stale session branch, try to switch to working branch
+    const currentBranch = getCurrentBranch(root);
+    if (currentBranch.startsWith("session-")) {
+        try {
+            execSync(`git checkout "${workingBranch}"`, { cwd: root, timeout: 10000, stdio: ["pipe", "pipe", "pipe"] });
+            ctx.log(`Switched from stale session branch ${currentBranch} → ${workingBranch}`, "info");
+        }
+        catch {
+            ctx.log(`Could not switch from ${currentBranch} — branching from it`, "warn");
+        }
+    }
+    // Step 3: Create new session branch
+    let finalBranch = branchName;
+    try {
+        execSync(`git checkout -b "${branchName}"`, { cwd: root, stdio: ["pipe", "pipe", "pipe"] });
+        ctx.ui.notify(`Session branch: ${branchName}`, { level: "info" });
+    }
+    catch {
+        // Branch name collision — retry with longer ID
+        const fallbackId = Math.random().toString(16).slice(2, 14);
+        const fallbackBranch = `session-${user}-${dateStr}-${timeStr}-${fallbackId}`;
+        try {
+            execSync(`git checkout -b "${fallbackBranch}"`, { cwd: root, stdio: ["pipe", "pipe", "pipe"] });
+            finalBranch = fallbackBranch;
+        }
+        catch {
+            // Give up — use current branch
+            finalBranch = getCurrentBranch(root);
+            ctx.log(`Could not create session branch — using ${finalBranch}`, "warn");
+            ctx.ui.notify(`Branch creation failed — using ${finalBranch}`, { level: "warn" });
+        }
+    }
+    // Step 4: Pop stash if we stashed
+    if (stashed) {
+        try {
+            execSync("git stash pop", { cwd: root, timeout: 10000, stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch {
+            ctx.log("Could not pop stash — run 'git stash pop' manually", "warn");
+        }
+    }
+    // Save session info
+    try {
+        const jflDir = join(root, ".jfl");
+        writeFileSync(join(jflDir, "current-session-branch.txt"), finalBranch);
+    }
+    catch { }
+    return finalBranch;
+}
+function findScript(root, scriptName) {
+    const candidates = [
+        join(root, "scripts", "session", scriptName),
+        join(root, "scripts", scriptName),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+export async function setupSession(ctx, _config) {
+    const root = ctx.session.projectRoot;
+    // Call Hub session init — handles sync, doctor, branch creation
+    try {
+        const resp = await fetch(`${hubUrl}/api/session/init`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+            },
+            body: JSON.stringify({ runtime: "pi" }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (resp.ok) {
+            const data = await resp.json();
+            if (data.warnings?.length) {
+                for (const w of data.warnings)
+                    ctx.log(w, "warn");
+            }
+            if (data.doctor?.errors) {
+                ctx.ui.notify(`Doctor: ${data.doctor.errors} errors`, { level: "warn" });
+            }
+            // Hub may return 200 OK but fail to create a branch (dirty state, etc).
+            // If branch is missing or is the working branch (main), fall back to local creation.
+            const hubBranch = data.branch ?? "";
+            if (hubBranch.startsWith("session-")) {
+                sessionBranch = hubBranch;
+                ctx.log(`Session init via Hub: branch=${sessionBranch}, sync=${data.syncOk}`, "debug");
+            }
+            else {
+                ctx.log(`Hub returned non-session branch "${hubBranch}" — creating locally`, "warn");
+                sessionBranch = createSessionBranchLocally(root, ctx);
+            }
+        }
+        else {
+            const errText = await resp.text().catch(() => "unknown");
+            ctx.log(`Hub session init failed (${resp.status}): ${errText}`, "warn");
+            sessionBranch = createSessionBranchLocally(root, ctx);
+        }
+    }
+    catch (err) {
+        // Hub not available — create session branch locally (parity with session-init.sh)
+        const msg = err instanceof Error ? err.message : String(err);
+        ctx.log(`Hub unavailable for session init: ${msg}`, "warn");
+        ctx.ui.notify(`Hub unreachable — creating session branch locally`, { level: "warn" });
+        sessionBranch = createSessionBranchLocally(root, ctx);
+    }
+    // Start auto-commit daemon — must be local (detached process)
+    const autoCommitScript = findScript(root, "auto-commit.sh");
+    if (autoCommitScript) {
+        autoCommitProcess = spawn("bash", [autoCommitScript, "start", "120"], {
+            cwd: root,
+            detached: true,
+            stdio: "ignore",
+        });
+        autoCommitProcess.unref();
+        ctx.log("Auto-commit daemon started (120s interval)", "debug");
+    }
+    ctx.emit("hook:session-start", {
+        session: ctx.session.id,
+        branch: sessionBranch,
+        projectRoot: root,
+        ts: new Date().toISOString(),
+    });
+}
+export function getSessionBranch() {
+    return sessionBranch;
+}
+export async function pivot(ctx, summary) {
+    const root = ctx.session.projectRoot;
+    try {
+        const resp = await fetch(`${hubUrl}/api/session/pivot`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+            },
+            body: JSON.stringify({ summary }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (resp.ok) {
+            const data = await resp.json();
+            ctx.emit("hook:session-pivot", {
+                session: ctx.session.id,
+                branch: sessionBranch,
+                pivotNumber: data.pivotNumber,
+                summary: summary || "",
+                ts: new Date().toISOString(),
+            });
+            ctx.log(`Pivot #${data.pivotNumber} via Hub`, "debug");
+            return data;
+        }
+    }
+    catch {
+        ctx.log("Hub unavailable for pivot, falling back to CLI", "debug");
+    }
+    // Fallback: shell out to jfl pivot
+    try {
+        const result = execSync(`jfl pivot --json${summary ? ` --summary "${summary.replace(/"/g, '\\"')}"` : ""}`, { cwd: root, encoding: "utf-8", timeout: 30000, stdio: ["pipe", "pipe", "pipe"] });
+        const parsed = JSON.parse(result);
+        ctx.emit("hook:session-pivot", {
+            session: ctx.session.id,
+            branch: sessionBranch,
+            pivotNumber: parsed.pivotNumber,
+            summary: summary || "",
+            ts: new Date().toISOString(),
+        });
+        return parsed;
+    }
+    catch (err) {
+        ctx.log(`Pivot fallback failed: ${err}`, "warn");
+        return { ok: false, pivotNumber: 0, committed: false, commitHash: null, filesChanged: 0, indexed: false };
+    }
+}
+export async function onShutdown(ctx) {
+    const root = ctx.session.projectRoot;
+    const branch = getSessionBranch() || getCurrentBranch(root);
+    ctx.ui.notify("Shutting down session…", { level: "info" });
+    // ── 1. Journal check (parity with CC Stop hook) ──────────────────────
+    const journalPath = join(root, ".jfl", "journal", `${branch}.jsonl`);
+    const hasJournal = existsSync(journalPath) && readFileSync(journalPath, "utf-8").trim().length > 0;
+    if (!hasJournal) {
+        ctx.ui.notify("⚠️  No journal entry for this session. Context will be lost.\n" +
+            `   File: .jfl/journal/${branch}.jsonl`, { level: "warn" });
+    }
+    // ── 2. Kill auto-commit daemon ───────────────────────────────────────
+    if (autoCommitProcess) {
+        try {
+            autoCommitProcess.kill();
+        }
+        catch { }
+        autoCommitProcess = null;
+        ctx.ui.notify("  ✓ Auto-commit stopped", { level: "info" });
+    }
+    // ── 3. Auto-commit any uncommitted changes ───────────────────────────
+    try {
+        const status = execSync("git status --porcelain", { cwd: root, timeout: 3000, encoding: "utf-8" }).trim();
+        if (status) {
+            execSync("git add -A && git commit -m 'auto: session-end save'", { cwd: root, timeout: 5000, stdio: "pipe" });
+            ctx.ui.notify("  ✓ Uncommitted changes saved", { level: "info" });
+        }
+    }
+    catch { }
+    // ── 4. Call Hub session end ──────────────────────────────────────────
+    try {
+        await fetch(`${hubUrl}/api/session/end`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+            },
+            body: JSON.stringify({ runtime: "pi" }),
+            signal: AbortSignal.timeout(5000),
+        });
+        ctx.ui.notify("  ✓ Hub session closed", { level: "info" });
+    }
+    catch {
+        ctx.log("Hub session end failed — running local cleanup", "debug");
+    }
+    // ── 5. Merge session branch back (parity with CC session-cleanup.sh) ─
+    if (branch.startsWith("session-")) {
+        // Guard: if git is already on a DIFFERENT branch (e.g. a new session started),
+        // don't merge — the old session branch may already be gone.
+        const currentGitBranch = getCurrentBranch(root);
+        if (currentGitBranch !== branch) {
+            ctx.log(`Skipping merge — git is on ${currentGitBranch}, not ${branch} (new session likely started)`, "debug");
+            ctx.ui.notify(`  ⚠ Skipped merge — already on ${currentGitBranch}`, { level: "info" });
+        }
+        else
+            try {
+                // Get working branch from config or default to main
+                let workingBranch = "main";
+                const configPath = join(root, ".jfl", "config.json");
+                if (existsSync(configPath)) {
+                    try {
+                        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+                        if (config.working_branch)
+                            workingBranch = config.working_branch;
+                    }
+                    catch { }
+                }
+                // Remove stale lock files that block git operations
+                const lockFile = join(root, ".git", "index.lock");
+                if (existsSync(lockFile)) {
+                    try {
+                        require("fs").unlinkSync(lockFile);
+                    }
+                    catch { }
+                }
+                // Commit any dirty tracked files before switching branches
+                try {
+                    execSync("git add -A && git commit -m 'session: auto-commit before merge' --no-verify", {
+                        cwd: root, timeout: 10000, stdio: "pipe",
+                    });
+                }
+                catch { } // OK if nothing to commit
+                // Push session branch first
+                try {
+                    execSync(`git push origin ${branch}`, { cwd: root, timeout: 15000, stdio: "pipe" });
+                    ctx.ui.notify("  ✓ Session branch pushed", { level: "info" });
+                }
+                catch { }
+                // Merge session into working branch
+                execSync(`git checkout ${workingBranch}`, { cwd: root, timeout: 5000, stdio: "pipe" });
+                execSync(`git merge ${branch} --no-edit`, { cwd: root, timeout: 10000, stdio: "pipe" });
+                ctx.ui.notify(`  ✓ Merged ${branch} → ${workingBranch}`, { level: "info" });
+                // Push merged working branch
+                try {
+                    execSync(`git push origin ${workingBranch}`, { cwd: root, timeout: 15000, stdio: "pipe" });
+                }
+                catch { }
+                // Delete session branch (local + remote)
+                try {
+                    execSync(`git branch -d ${branch}`, { cwd: root, timeout: 5000, stdio: "pipe" });
+                    execSync(`git push origin --delete ${branch}`, { cwd: root, timeout: 10000, stdio: "pipe" });
+                    ctx.ui.notify("  ✓ Session branch cleaned up", { level: "info" });
+                }
+                catch { }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes("CONFLICT") || msg.includes("conflict")) {
+                    ctx.ui.notify(`  ⚠ Merge conflict — session branch ${branch} preserved`, { level: "warn" });
+                    // Switch back to session branch so user can resolve
+                    try {
+                        execSync(`git checkout ${branch}`, { cwd: root, timeout: 5000, stdio: "pipe" });
+                    }
+                    catch { }
+                }
+                else {
+                    ctx.ui.notify(`  ⚠ Branch merge failed: ${msg.slice(0, 80)}`, { level: "warn" });
+                }
+            }
+    }
+    // ── 6. Fallback cleanup script ───────────────────────────────────────
+    const cleanupScript = findScript(root, "session-cleanup.sh");
+    if (cleanupScript && !branch.startsWith("session-")) {
+        // Only run cleanup script if we didn't already handle merge above
+        try {
+            execSync(`bash "${cleanupScript}"`, { cwd: root, timeout: 10000, stdio: "pipe" });
+        }
+        catch { }
+    }
+    ctx.emit("hook:session-end", {
+        session: ctx.session.id,
+        branch,
+        ts: new Date().toISOString(),
+    });
+}
+export function getCurrentBranch(root) {
+    try {
+        return execSync("git branch --show-current", { cwd: root }).toString().trim();
+    }
+    catch {
+        try {
+            const saved = readFileSync(join(root, ".jfl", "current-session-branch.txt"), "utf-8").trim();
+            return saved;
+        }
+        catch {
+            return "main";
+        }
+    }
+}
+//# sourceMappingURL=session.js.map