jfl 0.9.2 → 0.9.3

package/packages/pi/extensions/startup-briefing.ts

@@ -0,0 +1,313 @@
+/**
+ * Startup Briefing
+ *
+ * Gathers real data from synopsis, HUD, journal, git, and GitHub PRs
+ * to build a rich steer message on session start. The model uses this
+ * to produce a concise "here's where things stand" greeting.
+ *
+ * @purpose Startup steer message with real project data — synopsis, PRs, team activity
+ */
+
+import { existsSync, readFileSync, readdirSync } from "fs"
+import { join } from "path"
+import { execSync } from "child_process"
+import type { PiContext, JflConfig } from "./types.js"
+import { getHudForSteer } from "./hud-tool.js"
+
+// ─── Data gatherers (all async-safe, fail gracefully) ────────────────────────
+
+function getSynopsis(root: string, hours: number = 24): string {
+  try {
+    const result = execSync(`jfl synopsis ${hours}`, {
+      cwd: root,
+      timeout: 10000,
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "ignore"],
+    })
+    return result.trim()
+  } catch {
+    return ""
+  }
+}
+
+function getRecentJournalEntries(root: string, count: number = 8): Array<{
+  title: string
+  type: string
+  ts: string
+  session: string
+  summary?: string
+}> {
+  const journalDir = join(root, ".jfl", "journal")
+  if (!existsSync(journalDir)) return []
+
+  try {
+    const files = readdirSync(journalDir).filter(f => f.endsWith(".jsonl")).sort()
+    const entries: Array<{ title: string; type: string; ts: string; session: string; summary?: string }> = []
+
+    for (let i = files.length - 1; i >= 0 && entries.length < count * 2; i--) {
+      try {
+        const lines = readFileSync(join(journalDir, files[i]), "utf-8").trim().split("\n").filter(Boolean)
+        for (let j = lines.length - 1; j >= 0 && entries.length < count * 2; j--) {
+          try {
+            const e = JSON.parse(lines[j])
+            if (e.title && e.type !== "pivot") {
+              entries.push({
+                title: e.title,
+                type: e.type ?? "note",
+                ts: e.ts ?? "",
+                session: e.session ?? files[i].replace(".jsonl", ""),
+                summary: e.summary,
+              })
+            }
+          } catch {}
+        }
+      } catch {}
+    }
+
+    return entries.slice(0, count)
+  } catch {
+    return []
+  }
+}
+
+function getTeamActivity(root: string, hours: number = 48): string[] {
+  const activity: string[] = []
+
+  // Git commits by others (non-goose authors in last 48h)
+  try {
+    const log = execSync(
+      `git log --oneline --since="${hours} hours ago" --format="%an|||%s" --all`,
+      { cwd: root, timeout: 5000, encoding: "utf-8", stdio: ["pipe", "pipe", "ignore"] }
+    )
+    const lines = log.trim().split("\n").filter(Boolean)
+    const byAuthor = new Map<string, string[]>()
+
+    for (const line of lines) {
+      const [author, ...msgParts] = line.split("|||")
+      const msg = msgParts.join("|||")
+      if (!author || !msg) continue
+      // Skip auto-save commits
+      if (msg.startsWith("auto:")) continue
+      const list = byAuthor.get(author) || []
+      list.push(msg)
+      byAuthor.set(author, list)
+    }
+
+    for (const [author, commits] of byAuthor) {
+      if (commits.length <= 2) {
+        activity.push(`${author}: ${commits.join("; ")}`)
+      } else {
+        activity.push(`${author}: ${commits.length} commits — ${commits.slice(0, 3).join("; ")}`)
+      }
+    }
+  } catch {}
+
+  return activity
+}
+
+interface PullRequest {
+  number: number
+  title: string
+  author: string
+  state: string
+  createdAt?: string
+}
+
+function getOpenPRs(root: string): PullRequest[] {
+  try {
+    const result = execSync(
+      "gh pr list --limit 10 --json number,title,author,state,createdAt",
+      { cwd: root, timeout: 10000, encoding: "utf-8", stdio: ["pipe", "pipe", "ignore"] }
+    )
+    const prs = JSON.parse(result) as Array<{
+      number: number
+      title: string
+      author: { login: string; name?: string }
+      state: string
+      createdAt?: string
+    }>
+    return prs.map(pr => ({
+      number: pr.number,
+      title: pr.title.length > 80 ? pr.title.slice(0, 77) + "…" : pr.title,
+      author: pr.author.name || pr.author.login,
+      state: pr.state,
+      createdAt: pr.createdAt,
+    }))
+  } catch {
+    return []
+  }
+}
+
+function getNextActions(root: string): string[] {
+  const actions: string[] = []
+
+  // Check journal "next" fields from recent entries
+  const journalDir = join(root, ".jfl", "journal")
+  if (existsSync(journalDir)) {
+    try {
+      const files = readdirSync(journalDir).filter(f => f.endsWith(".jsonl")).sort()
+      for (let i = files.length - 1; i >= 0 && actions.length < 3; i--) {
+        try {
+          const lines = readFileSync(join(journalDir, files[i]), "utf-8").trim().split("\n").filter(Boolean)
+          for (let j = lines.length - 1; j >= 0 && actions.length < 3; j--) {
+            try {
+              const e = JSON.parse(lines[j])
+              if (e.next && typeof e.next === "string" && e.next.trim()) {
+                actions.push(e.next.trim())
+              } else if (Array.isArray(e.incomplete) && e.incomplete.length > 0) {
+                actions.push(`Incomplete: ${e.incomplete.slice(0, 2).join(", ")}`)
+              }
+            } catch {}
+          }
+        } catch {}
+      }
+    } catch {}
+  }
+
+  return actions
+}
+
+// ─── Cross-repo awareness ────────────────────────────────────────────────────
+
+function getRegisteredServices(root: string): Array<{ name: string; path: string }> {
+  const configPath = join(root, ".jfl", "config.json")
+  if (!existsSync(configPath)) return []
+  try {
+    const config = JSON.parse(readFileSync(configPath, "utf-8"))
+    return (config.registered_services || [])
+      .filter((s: any) => s.path && existsSync(s.path))
+      .map((s: any) => ({ name: s.name, path: s.path }))
+  } catch {
+    return []
+  }
+}
+
+function getCrossRepoPRs(root: string): PullRequest[] {
+  const services = getRegisteredServices(root)
+  const allPRs: PullRequest[] = []
+
+  for (const svc of services) {
+    try {
+      const prs = getOpenPRs(svc.path)
+      for (const pr of prs) {
+        allPRs.push({ ...pr, title: `[${svc.name}] ${pr.title}` })
+      }
+    } catch {}
+  }
+
+  return allPRs
+}
+
+// ─── Build the briefing ──────────────────────────────────────────────────────
+
+export async function buildStartupBriefing(ctx: PiContext, config: JflConfig): Promise<string> {
+  const root = ctx.session.projectRoot
+  const sections: string[] = []
+
+  // 1. HUD — compact project status
+  const hud = getHudForSteer()
+  if (hud) {
+    sections.push("## Project Dashboard\n" + hud)
+  }
+
+  // 2. Synopsis — recent work summary
+  const synopsis = getSynopsis(root, 48)
+  if (synopsis) {
+    sections.push("## Recent Work (48h)\n" + synopsis)
+  } else {
+    // Fallback to journal entries
+    const entries = getRecentJournalEntries(root, 6)
+    if (entries.length > 0) {
+      const entryLines = entries.map(e => {
+        const timeAgo = getTimeAgo(e.ts)
+        return `- [${e.type}] ${e.title}${timeAgo ? ` (${timeAgo})` : ""}${e.summary ? ` — ${e.summary}` : ""}`
+      })
+      sections.push("## Recent Work\n" + entryLines.join("\n"))
+    }
+  }
+
+  // 3. Team activity — commits by other authors
+  const teamActivity = getTeamActivity(root, 48)
+  if (teamActivity.length > 0) {
+    sections.push("## Team Activity (48h)\n" + teamActivity.map(a => `- ${a}`).join("\n"))
+  }
+
+  // 4. Open PRs — this repo + registered services
+  const localPRs = getOpenPRs(root)
+  const crossPRs = getCrossRepoPRs(root)
+  const allPRs = [...localPRs, ...crossPRs]
+  if (allPRs.length > 0) {
+    const prLines = allPRs.slice(0, 8).map(pr =>
+      `- #${pr.number} ${pr.title} (${pr.author})`
+    )
+    sections.push("## Open PRs\n" + prLines.join("\n"))
+  }
+
+  // 5. Next actions — from journal "next" fields
+  const nextActions = getNextActions(root)
+  if (nextActions.length > 0) {
+    const unique = [...new Set(nextActions)].slice(0, 3)
+    sections.push("## Suggested Next Actions\n" + unique.map(a => `- ${a}`).join("\n"))
+  }
+
+  return sections.join("\n\n")
+}
+
+function getTimeAgo(ts: string): string {
+  if (!ts) return ""
+  try {
+    const diff = Date.now() - new Date(ts).getTime()
+    const hours = Math.floor(diff / 3600000)
+    if (hours < 1) return "just now"
+    if (hours < 24) return `${hours}h ago`
+    const days = Math.floor(hours / 24)
+    return `${days}d ago`
+  } catch {
+    return ""
+  }
+}
+
+// ─── Fire the steer ──────────────────────────────────────────────────────────
+
+export async function fireStartupBriefing(ctx: PiContext, config: JflConfig): Promise<void> {
+  if (config.pi?.disable_briefing) return
+
+  try {
+    const briefingData = await buildStartupBriefing(ctx, config)
+    if (!briefingData) return
+
+    const projectName = config.name || ctx.session.projectRoot.split("/").pop() || "project"
+
+    const steerContent = [
+      `JFL session ready: "${projectName}" on branch ${ctx.session.branch}.`,
+      "",
+      "Here is the current project state. Use this to greet the user with a concise briefing:",
+      "",
+      briefingData,
+      "",
+      "---",
+      "INSTRUCTIONS: Give a concise briefing (5-10 lines). Include:",
+      "1. Current phase / what's hot right now",
+      "2. Key recent wins or changes (from synopsis/journal above)",
+      "3. What others on the team have been working on (if any team activity)",
+      "4. Open PRs that need attention (if any)",
+      "5. A suggested next action based on the journal 'next' fields",
+      "",
+      "End with: What do you want to hit?",
+      "",
+      "Be direct and useful. No setup noise. No tool calls needed — everything is above.",
+    ].join("\n")
+
+    // Fire immediately — called after onboarding overlay has already dismissed
+    ctx.pi.sendMessage(
+      {
+        customType: "jfl-startup-briefing",
+        content: steerContent,
+        display: false,
+      },
+      { triggerTurn: true, deliverAs: "steer" }
+    )
+  } catch (err) {
+    ctx.log(`Startup briefing failed: ${err}`, "debug")
+  }
+}