jfl 0.9.0 → 0.9.2

package/README.md

@@ -8,7 +8,7 @@
   <a href="https://www.npmjs.com/package/jfl"><img src="https://img.shields.io/npm/v/jfl.svg" alt="npm version" /></a>
   <a href="https://github.com/402goose/jfl-cli/actions"><img src="https://img.shields.io/github/actions/workflow/status/402goose/jfl-cli/ci.yml?branch=main" alt="CI" /></a>
   <a href="https://github.com/402goose/jfl-cli"><img src="https://img.shields.io/github/stars/402goose/jfl-cli" alt="GitHub stars" /></a>
-  <img src="https://img.shields.io/badge/tests-952%20passing-brightgreen" alt="tests" />
+  <img src="https://img.shields.io/badge/tests-1270%20passing-brightgreen" alt="tests" />
   <a href="https://github.com/402goose/jfl-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT license" /></a>
 </p>
 
@@ -59,7 +59,7 @@ You (or agent) works in a session
 | **MAP Event Bus** | Nervous system | Events flow between agents, services, and flows. SSE + WebSocket. |
 | **Flow Engine** | Declarative automation | YAML trigger-action flows: `eval:scored` → auto-merge, `telemetry:insight` → spawn fix. |
 | **Pi Runtime** | Multi-model TUI agent | JFL extension for Pi — full context injection, tools, custom rendering. |
-| **Kanban** | Task board | GitHub Issues-backed cards: `jfl kanban add` → `pick` → `done`. Dashboard + Peter integration. |
+| **Kanban** | Task board | GitHub Issues-backed cards with Linear bidirectional sync. PP picks up and ships autonomously. |
 
 ---
 
@@ -89,9 +89,12 @@ GTMs are context layers — they never house product code. Services register to
 
 ```bash
 jfl status                    # Project status
+jfl whoami                    # Current user, project, and root
 jfl hud                       # Campaign dashboard
 jfl synopsis [hours]          # Work summary
 jfl ask "what did we decide?" # Search memory
+jfl doctor                    # Health check
+jfl doctor --json             # Machine-readable health output (for CI/evals)
 jfl ide                       # Terminal workspace (tmux/cmux)
 ```
 
@@ -111,9 +114,22 @@ jfl eval list                 # Recent eval entries
 jfl eval trajectory -a shadow # Score over time
 jfl peter experiment          # Run autonomous improvement cycle
 jfl predict run --proposal "Fix auth" --goal "improve tests"
+jfl train policy-head         # Train RL policy head on journal data
+jfl train status              # Training pipeline status
+```
+
+### Kanban & Linear
+
+```bash
 jfl kanban ls                 # Task board
 jfl kanban add "Fix the thing" # Add card
 jfl kanban pick --agent cash  # Agent picks top card
+jfl kanban bootstrap          # Create kanban labels in GitHub repo
+jfl linear sync               # Bidirectional GitHub ↔ Linear sync
+jfl linear sync --direction github  # Push GitHub state to Linear
+jfl linear sync --direction linear  # Pull Linear into GitHub
+jfl linear link               # Link repo to Linear project
+jfl linear status             # Sync status and config
 ```
 
 ### Services
@@ -122,6 +138,7 @@ jfl kanban pick --agent cash  # Agent picks top card
 jfl onboard /path/to/repo     # Register a service
 jfl services                  # Interactive TUI
 jfl services validate --fix   # Auto-repair config issues
+jfl ci setup                  # Deploy eval + review CI workflows
 ```
 
 ### Pi Runtime
@@ -162,7 +179,21 @@ Agents detect issues, create fixes, and the system auto-merges if eval scores im
 | Cost spike | `telemetry:insight` (high) | Create fix PR |
 | Predict first | `peter:pr-proposed` | Stratus prediction gate |
 
-**CI closes the loop:** `jfl-eval.yml` runs eval on PP pull requests. `jfl-review.yml` does AI code review. Both post events to Context Hub.
+**CI closes the loop:** `jfl-eval.yml` runs eval on PP pull requests. `jfl-review.yml` does AI code review. Both post events to Context Hub. `jfl ci setup` deploys both workflows to any repo.
+
+---
+
+## Linear Integration
+
+JFL syncs GitHub Issues ↔ Linear bidirectionally. When a PR is merged, the linked Linear issue moves to Done automatically.
+
+```bash
+jfl linear link               # Connect to your Linear workspace
+jfl linear sync               # Full bidirectional sync
+jfl linear sync --direction github --json  # CI-friendly output
+```
+
+The `linear-sync` GitHub Actions workflow runs on every issue event and on a 30-minute cron for drift correction. PP picks up Linear issues, creates PRs with cross-repo references (`Closes org/repo#N`), and the kanban moves them through `backlog → in-progress → eval → done`.
 
 ---
 
@@ -207,7 +238,7 @@ git clone https://github.com/402goose/jfl-cli
 cd jfl-cli
 npm install
 npm run build
-npm test          # 952 tests
+npm test          # 1270 tests
 npm link          # Use local build globally
 ```
 

package/dist/commands/context-hub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-hub.d.ts","sourceRoot":"","sources":["../../src/commands/context-hub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAolFH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBjF;AAkMD,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAiHxF;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,iBA8lBzF"}
+{"version":3,"file":"context-hub.d.ts","sourceRoot":"","sources":["../../src/commands/context-hub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAktFH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBjF;AAkMD,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAiHxF;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,iBA8lBzF"}

package/dist/commands/context-hub.js

@@ -318,6 +318,74 @@ function readCodeContext(projectRoot, limit = 30) {
     }
     return items;
 }
+/**
+ * Read GTM content artifacts — drafts, specs, content, scripts.
+ * Used instead of code indexing for GTM-type projects.
+ */
+function readGtmContent(projectRoot, limit = 40) {
+    const items = [];
+    const gtmDirs = [
+        { dir: "content", type: "content" },
+        { dir: "drafts", type: "draft" },
+        { dir: "specs", type: "spec" },
+        { dir: "scripts", type: "script" },
+    ];
+    const mdExtensions = [".md", ".txt"];
+    const scriptExtensions = [".sh", ".py", ".mjs", ".js"];
+    for (const { dir, type } of gtmDirs) {
+        const fullDir = path.join(projectRoot, dir);
+        if (!fs.existsSync(fullDir))
+            continue;
+        function scanDir(d, depth = 0) {
+            if (depth > 3 || items.length >= limit)
+                return;
+            try {
+                const entries = fs.readdirSync(d, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (items.length >= limit)
+                        break;
+                    if (entry.name.startsWith(".") || entry.name === "node_modules")
+                        continue;
+                    const fullPath = path.join(d, entry.name);
+                    if (entry.isDirectory()) {
+                        scanDir(fullPath, depth + 1);
+                    }
+                    else {
+                        const isMarkdown = mdExtensions.some(ext => entry.name.endsWith(ext));
+                        const isScript = type === "script" && scriptExtensions.some(ext => entry.name.endsWith(ext));
+                        if (isMarkdown || isScript) {
+                            try {
+                                const raw = fs.readFileSync(fullPath, "utf-8");
+                                // Extract first heading + first paragraph as summary
+                                const lines = raw.split("\n").filter(l => l.trim());
+                                const heading = lines.find(l => l.startsWith("#"))?.replace(/^#+\s*/, "") || entry.name;
+                                const bodyLines = lines.filter(l => !l.startsWith("#") && !l.startsWith("---"));
+                                const summary = bodyLines.slice(0, 5).join(" ").slice(0, 500);
+                                if (summary.length > 20) {
+                                    items.push({
+                                        source: "content",
+                                        type,
+                                        title: heading,
+                                        content: summary,
+                                        path: fullPath
+                                    });
+                                }
+                            }
+                            catch {
+                                // Skip unreadable files
+                            }
+                        }
+                    }
+                }
+            }
+            catch {
+                // Skip unreadable directories
+            }
+        }
+        scanDir(fullDir);
+    }
+    return items;
+}
 // ============================================================================
 // Search & Scoring (TF-IDF style)
 // ============================================================================
@@ -401,11 +469,24 @@ function semanticSearch(items, query) {
 // ============================================================================
 // Orchestrator
 // ============================================================================
+function getProjectType(projectRoot) {
+    const configPath = path.join(projectRoot, ".jfl", "config.json");
+    if (fs.existsSync(configPath)) {
+        try {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            return config.type || "standalone";
+        }
+        catch { }
+    }
+    return "standalone";
+}
 function getUnifiedContext(projectRoot, query, taskType) {
     const journalItems = readJournalEntries(projectRoot);
     const knowledgeItems = readKnowledgeDocs(projectRoot);
+    const projectType = getProjectType(projectRoot);
     const codeItems = readCodeContext(projectRoot);
-    let items = [...journalItems, ...knowledgeItems, ...codeItems];
+    const contentItems = projectType === "gtm" ? readGtmContent(projectRoot) : [];
+    let items = [...journalItems, ...knowledgeItems, ...codeItems, ...contentItems];
     // Apply semantic search if query provided
     if (query) {
         items = semanticSearch(items, query);
@@ -416,6 +497,7 @@ function getUnifiedContext(projectRoot, query, taskType) {
             journal: journalItems.length > 0,
             knowledge: knowledgeItems.length > 0,
             code: codeItems.length > 0,
+            content: contentItems.length > 0,
             memory: fs.existsSync(path.join(projectRoot, ".jfl", "memory.db")),
         },
         query,
@@ -476,8 +558,11 @@ async function fetchChildContext(child, endpoint, body) {
 async function getPortfolioContext(projectRoot, query, taskType, maxItems) {
     const local = getUnifiedContext(projectRoot, query, taskType);
     const children = getChildHubs(projectRoot);
-    if (children.length === 0)
+    if (children.length === 0) {
+        if (maxItems)
+            local.items = local.items.slice(0, maxItems);
         return local;
+    }
     const endpoint = query ? "/api/context/search" : "/api/context";
     const body = { maxItems: maxItems || 20 };
     if (query)
@@ -707,6 +792,7 @@ function createServer(projectRoot, port, eventBus, flowEngine) {
                         journal_count: context.items.filter(i => i.source === 'journal').length,
                         knowledge_count: context.items.filter(i => i.source === 'knowledge').length,
                         code_count: context.items.filter(i => i.source === 'code').length,
+                        content_count: context.items.filter(i => i.source === 'content').length,
                         query_length: query ? query.length : 0,
                     });
                     res.writeHead(200, { "Content-Type": "application/json" });
@@ -2274,6 +2360,36 @@ function createServer(projectRoot, port, eventBus, flowEngine) {
             }
             return;
         }
+        // POST /api/webhooks/linear — handle Linear webhook events
+        if (url.pathname === "/api/webhooks/linear" && req.method === "POST") {
+            let body = "";
+            req.on("data", (chunk) => { body += chunk; });
+            req.on("end", async () => {
+                try {
+                    const payload = JSON.parse(body || "{}");
+                    const { handleLinearWebhook } = await import("../lib/linear-webhook.js");
+                    const result = handleLinearWebhook(payload, projectRoot);
+                    if (result.handled && eventBus) {
+                        eventBus.emit({
+                            type: "linear:document-sync",
+                            source: "linear-webhook",
+                            data: {
+                                action: payload.action,
+                                documentTitle: payload.data?.title,
+                                journalFile: result.journalFile,
+                            },
+                        });
+                    }
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify(result));
+                }
+                catch (err) {
+                    res.writeHead(400, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: err.message }));
+                }
+            });
+            return;
+        }
         // 404
         res.writeHead(404, { "Content-Type": "application/json" });
         res.end(JSON.stringify({ error: "Not found" }));