@10et/cli 1.0.0

package/packages/pi/extensions/notifications.ts

@@ -0,0 +1,73 @@
+/**
+ * Native Notifications Extension
+ *
+ * Sends terminal notifications (OSC 777/99) when:
+ * - Agent finishes a long task (>10s)
+ * - Journal entry is recommended
+ * - Eval score changes significantly
+ *
+ * Supports Ghostty, iTerm2, WezTerm, Kitty, Windows Terminal.
+ *
+ * @purpose Terminal-native notifications for key JFL events
+ */
+
+import type { PiContext, JflConfig } from "./types.js"
+
+let enabled = true
+let agentStartTime = 0
+const LONG_TASK_THRESHOLD_MS = 10000
+
+function notifyOSC777(title: string, body: string): void {
+  process.stdout.write(`\x1b]777;notify;${title};${body}\x07`)
+}
+
+function notifyOSC99(title: string, body: string): void {
+  process.stdout.write(`\x1b]99;i=1:d=0;${title}\x1b\\`)
+  process.stdout.write(`\x1b]99;i=1:p=body;${body}\x1b\\`)
+}
+
+function notify(title: string, body: string): void {
+  if (!enabled) return
+
+  try {
+    if (process.env.KITTY_WINDOW_ID) {
+      notifyOSC99(title, body)
+    } else {
+      notifyOSC777(title, body)
+    }
+  } catch {}
+}
+
+export function setupNotifications(ctx: PiContext, config: JflConfig): void {
+  if (config.pi?.disable_notifications) {
+    enabled = false
+    return
+  }
+
+  ctx.on("agent:start", () => {
+    agentStartTime = Date.now()
+  })
+
+  ctx.on("agent:end", (data: any) => {
+    const elapsed = Date.now() - agentStartTime
+    if (elapsed > LONG_TASK_THRESHOLD_MS) {
+      const seconds = Math.floor(elapsed / 1000)
+      const reason = data?.exitReason ?? "done"
+      notify("JFL", `Agent finished (${seconds}s) — ${reason}`)
+    }
+  })
+
+  ctx.on("journal:written", (data: any) => {
+    const title = data?.title ?? "entry"
+    notify("JFL Journal", title)
+  })
+
+  ctx.registerCommand({
+    name: "notify",
+    description: "Toggle native terminal notifications",
+    async handler(_args, ctx) {
+      enabled = !enabled
+      ctx.ui.notify(`Notifications ${enabled ? "enabled" : "disabled"}`, { level: "info" })
+    },
+  })
+}

package/packages/pi/extensions/onboarding-v1.ts

@@ -0,0 +1,455 @@
+/**
+ * Onboarding V1 — Minimal
+ *
+ * Linear-inspired, typography-first TUI onboarding sequence.
+ * Monochrome with single cyan accent. No emojis, no icons — just clean text.
+ * Runs as a full-screen overlay during session init, then hands off to agent.
+ *
+ * Sequence: Welcome -> Detect -> Load -> Ready -> Handoff
+ * Target: under 3 seconds total.
+ *
+ * @purpose Variant 1 onboarding — minimal, typography-first, monochrome + cyan
+ */
+
+import { existsSync, readFileSync, readdirSync, statSync } from "fs"
+import { join, basename } from "path"
+import { execSync } from "child_process"
+import type { PiContext, JflConfig, PiTheme } from "./types.js"
+
+// ─── Data structures ────────────────────────────────────────────────────────
+
+interface ProjectInfo {
+  name: string
+  type: "gtm" | "service" | "portfolio" | "new"
+  branch: string
+  agentCount: number
+  lastSession: string | null
+  lastSessionAge: string | null
+  journalEntries: number
+  recentEntries: Array<{ title: string; type: string; ts: string }>
+  hasSubway: boolean
+  hubPort: string | null
+  version: string
+  runtime: string
+}
+
+// ─── Detection helpers ──────────────────────────────────────────────────────
+
+function detectVersion(): string {
+  try {
+    const pkgPath = join(__dirname, "..", "..", "package.json")
+    if (existsSync(pkgPath)) {
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"))
+      return pkg.version ?? "dev"
+    }
+  } catch {}
+  try {
+    return execSync("jfl --version 2>/dev/null", { encoding: "utf-8", timeout: 2000 }).trim().replace(/^jfl\s+/i, "")
+  } catch {}
+  return "dev"
+}
+
+function detectRuntime(): string {
+  if (process.env.PI_VERSION) return `Pi ${process.env.PI_VERSION}`
+  if (process.env.PI_HOME) return "Pi"
+  return "Pi"
+}
+
+function detectProjectType(root: string, config: JflConfig): ProjectInfo["type"] {
+  if (config.type === "portfolio") return "portfolio"
+  if (config.type === "service") return "service"
+  if (config.type === "gtm") return "gtm"
+  if (existsSync(join(root, ".jfl", "config.json"))) return "gtm"
+  return "new"
+}
+
+function getActiveAgentCount(root: string): number {
+  const journalDir = join(root, ".jfl", "journal")
+  if (!existsSync(journalDir)) return 0
+  const now = Date.now()
+  let active = 0
+  try {
+    for (const f of readdirSync(journalDir)) {
+      if (!f.startsWith("session-") || !f.endsWith(".jsonl")) continue
+      try {
+        const stat = statSync(join(journalDir, f))
+        if (now - stat.mtimeMs < 300000) active++
+      } catch {}
+    }
+  } catch {}
+  return active
+}
+
+function getRecentJournalEntries(root: string, limit = 3): Array<{ title: string; type: string; ts: string }> {
+  const journalDir = join(root, ".jfl", "journal")
+  if (!existsSync(journalDir)) return []
+  const entries: Array<{ title: string; type: string; ts: string }> = []
+  try {
+    const files = readdirSync(journalDir)
+      .filter(f => f.endsWith(".jsonl"))
+      .map(f => ({ name: f, mtime: statSync(join(journalDir, f)).mtimeMs }))
+      .sort((a, b) => b.mtime - a.mtime)
+      .slice(0, 5)
+
+    for (const file of files) {
+      try {
+        const content = readFileSync(join(journalDir, file.name), "utf-8").trim()
+        const lines = content.split("\n").filter(Boolean)
+        for (const line of lines.reverse()) {
+          try {
+            const entry = JSON.parse(line)
+            if (entry.title) {
+              entries.push({
+                title: entry.title,
+                type: entry.type ?? "note",
+                ts: entry.ts ?? "",
+              })
+            }
+          } catch {}
+          if (entries.length >= limit) break
+        }
+      } catch {}
+      if (entries.length >= limit) break
+    }
+  } catch {}
+  return entries.slice(0, limit)
+}
+
+function getLastSessionInfo(root: string): { name: string | null; age: string | null } {
+  const journalDir = join(root, ".jfl", "journal")
+  if (!existsSync(journalDir)) return { name: null, age: null }
+  try {
+    const files = readdirSync(journalDir)
+      .filter(f => f.startsWith("session-") && f.endsWith(".jsonl"))
+      .map(f => ({ name: f, mtime: statSync(join(journalDir, f)).mtimeMs }))
+      .sort((a, b) => b.mtime - a.mtime)
+
+    if (files.length === 0) return { name: null, age: null }
+    const last = files[0]
+    const age = Date.now() - last.mtime
+    return {
+      name: last.name.replace("session-", "").replace(".jsonl", ""),
+      age: formatAge(age),
+    }
+  } catch {}
+  return { name: null, age: null }
+}
+
+function formatAge(ms: number): string {
+  const seconds = Math.floor(ms / 1000)
+  if (seconds < 60) return `${seconds}s ago`
+  const minutes = Math.floor(seconds / 60)
+  if (minutes < 60) return `${minutes}m ago`
+  const hours = Math.floor(minutes / 60)
+  if (hours < 24) return `${hours}h ago`
+  const days = Math.floor(hours / 24)
+  return `${days}d ago`
+}
+
+function getJournalCount(root: string): number {
+  const journalDir = join(root, ".jfl", "journal")
+  if (!existsSync(journalDir)) return 0
+  let count = 0
+  try {
+    for (const f of readdirSync(journalDir).filter(f => f.endsWith(".jsonl"))) {
+      const content = readFileSync(join(journalDir, f), "utf-8").trim()
+      count += content.split("\n").filter(Boolean).length
+    }
+  } catch {}
+  return count
+}
+
+function hasSubwayConfig(root: string): boolean {
+  return existsSync(join(root, ".jfl", "subway.json")) ||
+    existsSync(join(root, ".jfl", "subway.toml"))
+}
+
+function getHubPort(root: string): string | null {
+  const portFile = join(root, ".jfl", "context-hub.port")
+  if (existsSync(portFile)) {
+    try {
+      return readFileSync(portFile, "utf-8").trim()
+    } catch {}
+  }
+  return null
+}
+
+// ─── Hub ensure (background) ────────────────────────────────────────────────
+
+function ensureHubSilent(root: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    try {
+      execSync("jfl context-hub ensure", {
+        cwd: root,
+        stdio: "pipe",
+        timeout: 12000,
+      })
+      resolve(true)
+    } catch {
+      resolve(false)
+    }
+  })
+}
+
+// ─── Gather all project info ────────────────────────────────────────────────
+
+function gatherProjectInfo(root: string, config: JflConfig): ProjectInfo {
+  const lastSession = getLastSessionInfo(root)
+  return {
+    name: config.name ?? basename(root),
+    type: detectProjectType(root, config),
+    branch: (() => {
+      try {
+        return execSync("git branch --show-current", { cwd: root, encoding: "utf-8", timeout: 2000 }).trim() || "main"
+      } catch { return "main" }
+    })(),
+    agentCount: getActiveAgentCount(root),
+    lastSession: lastSession.name,
+    lastSessionAge: lastSession.age,
+    journalEntries: getJournalCount(root),
+    recentEntries: getRecentJournalEntries(root, 3),
+    hasSubway: hasSubwayConfig(root),
+    hubPort: getHubPort(root),
+    version: detectVersion(),
+    runtime: detectRuntime(),
+  }
+}
+
+// ─── Onboarding phases ──────────────────────────────────────────────────────
+
+const enum Phase {
+  Welcome = 0,
+  Detect = 1,
+  Loading = 2,
+  Ready = 3,
+}
+
+// ─── Render helpers ─────────────────────────────────────────────────────────
+
+function stripAnsi(str: string): string {
+  return str.replace(/\x1b\[[0-9;]*m/g, "")
+}
+
+function centerLine(text: string, width: number): string {
+  const visible = stripAnsi(text).length
+  const pad = Math.max(0, Math.floor((width - visible) / 2))
+  return " ".repeat(pad) + text
+}
+
+// ─── Main onboarding ────────────────────────────────────────────────────────
+
+export async function setupOnboarding(ctx: PiContext, config: JflConfig): Promise<void> {
+  if (!ctx.ui.hasUI) return
+
+  const root = ctx.session.projectRoot
+  const info = gatherProjectInfo(root, config)
+
+  let hubReady = false
+  const hubPromise = ensureHubSilent(root).then((ok) => {
+    hubReady = ok
+    return ok
+  })
+
+  await ctx.ui.custom<void>((tui: any, theme: PiTheme, _kb: any, done: (r: void) => void) => {
+    let phase: Phase = Phase.Welcome
+    let tick = 0
+    let dotCount = 0
+    let disposed = false
+    let hubDone = false
+    let contextLoaded = false
+
+    const PHASE_DURATIONS = [600, 500, 1200, 800]
+
+    function advance() {
+      if (disposed) return
+      if (phase < Phase.Ready) {
+        phase++
+        tick = 0
+        tui.requestRender()
+        if (phase === Phase.Loading) {
+          hubPromise.then(() => {
+            hubDone = true
+            setTimeout(() => {
+              contextLoaded = true
+              tui.requestRender()
+            }, 300)
+          })
+        }
+        if (phase < Phase.Ready) {
+          setTimeout(advance, PHASE_DURATIONS[phase])
+        } else {
+          setTimeout(() => {
+            if (!disposed) done(undefined)
+          }, PHASE_DURATIONS[Phase.Ready])
+        }
+      }
+    }
+
+    setTimeout(advance, PHASE_DURATIONS[Phase.Welcome])
+
+    const dotInterval = setInterval(() => {
+      if (disposed) return
+      dotCount = (dotCount + 1) % 4
+      tick++
+      if (phase === Phase.Loading || phase === Phase.Ready) {
+        tui.requestRender()
+      }
+    }, 200)
+
+    return {
+      handleInput(key: string) {
+        if (key === "\r" || key === " ") {
+          if (!disposed) {
+            disposed = true
+            clearInterval(dotInterval)
+            done(undefined)
+          }
+        }
+      },
+
+      dispose() {
+        disposed = true
+        clearInterval(dotInterval)
+      },
+
+      invalidate() {},
+
+      render(width: number): string[] {
+        const w = Math.min(width, 72)
+        const lines: string[] = []
+        const margin = "  "
+
+        // Consistent top padding
+        lines.push("")
+        lines.push("")
+
+        if (phase === Phase.Welcome) {
+          // ─── Welcome ────────────────────────────────────────────────
+          lines.push("")
+          lines.push(centerLine(theme.bold("T E N E T"), w))
+          lines.push("")
+          lines.push(centerLine(theme.fg("dim", `v${info.version}`), w))
+          lines.push("")
+          lines.push("")
+          lines.push("")
+          lines.push(centerLine(theme.fg("muted", info.runtime), w))
+          lines.push("")
+
+        } else if (phase === Phase.Detect) {
+          // ─── Project Detection ──────────────────────────────────────
+          lines.push("")
+          lines.push(`${margin}${theme.bold(info.name)}`)
+          lines.push(`${margin}${theme.fg("dim", typeLabel(info.type))}`)
+          lines.push("")
+
+          lines.push(`${margin}${theme.fg("dim", "branch")}  ${theme.fg("accent", info.branch)}`)
+
+          if (info.agentCount > 0) {
+            lines.push(`${margin}${theme.fg("dim", "agents")}  ${theme.fg("accent", String(info.agentCount))} active`)
+          }
+
+          if (info.journalEntries > 0) {
+            lines.push(`${margin}${theme.fg("dim", "journal")} ${theme.fg("muted", `${info.journalEntries} entries`)}`)
+          }
+
+          if (info.lastSession && info.lastSessionAge) {
+            lines.push(`${margin}${theme.fg("dim", "last")}    ${theme.fg("muted", info.lastSessionAge)}`)
+          }
+
+          lines.push("")
+
+        } else if (phase === Phase.Loading) {
+          // ─── Context Loading ────────────────────────────────────────
+          lines.push("")
+          lines.push(`${margin}${theme.bold(info.name)}`)
+          lines.push("")
+
+          const dots = ".".repeat(dotCount)
+          const hubStatus = hubDone
+            ? `${margin}  ${theme.fg("accent", "+")} hub`
+            : `${margin}  ${theme.fg("dim", "-")} hub${dots}`
+          const ctxStatus = contextLoaded
+            ? `${margin}  ${theme.fg("accent", "+")} context`
+            : hubDone
+              ? `${margin}  ${theme.fg("dim", "-")} context${dots}`
+              : `${margin}  ${theme.fg("dim", "-")} context`
+
+          lines.push(`${margin}${theme.fg("dim", "loading")}`)
+          lines.push(hubStatus)
+          lines.push(ctxStatus)
+
+          if (info.hasSubway) {
+            lines.push(`${margin}  ${theme.fg("dim", "-")} subway`)
+          }
+
+          lines.push("")
+
+          if (info.recentEntries.length > 0) {
+            lines.push(`${margin}${theme.fg("dim", "last session")}`)
+            lines.push("")
+            for (const entry of info.recentEntries) {
+              const typeTag = theme.fg("dim", padRight(entry.type, 10))
+              const title = theme.fg("muted", truncate(entry.title, w - 18))
+              lines.push(`${margin}  ${typeTag} ${title}`)
+            }
+          }
+
+          lines.push("")
+
+        } else if (phase === Phase.Ready) {
+          // ─── Ready ──────────────────────────────────────────────────
+          lines.push("")
+          lines.push(`${margin}${theme.bold(info.name)}`)
+          lines.push(`${margin}${theme.fg("dim", typeLabel(info.type))}  ${theme.fg("dim", "on")} ${theme.fg("accent", info.branch)}`)
+          lines.push("")
+
+          const parts: string[] = []
+          if (hubReady) parts.push(theme.fg("accent", "hub"))
+          if (info.journalEntries > 0) parts.push(theme.fg("dim", `${info.journalEntries}j`))
+          if (info.agentCount > 0) parts.push(theme.fg("accent", `${info.agentCount} agent${info.agentCount !== 1 ? "s" : ""}`))
+          if (info.hasSubway) parts.push(theme.fg("dim", "subway"))
+
+          if (parts.length > 0) {
+            lines.push(`${margin}${parts.join(theme.fg("dim", "  /  "))}`)
+          }
+
+          lines.push("")
+          lines.push(`${margin}${theme.fg("accent", "ready")}`)
+          lines.push("")
+        }
+
+        // Bottom padding to fill
+        while (lines.length < 16) lines.push("")
+
+        return lines
+      },
+    }
+  }, {
+    overlay: true,
+    overlayOptions: {
+      borderStyle: "none",
+      padding: 0,
+    },
+  })
+}
+
+// ─── Utilities ──────────────────────────────────────────────────────────────
+
+function typeLabel(type: ProjectInfo["type"]): string {
+  switch (type) {
+    case "gtm": return "GTM workspace"
+    case "service": return "service"
+    case "portfolio": return "portfolio"
+    case "new": return "new project"
+  }
+}
+
+function truncate(text: string, max: number): string {
+  if (text.length <= max) return text
+  return text.slice(0, max - 1) + "\u2026"
+}
+
+function padRight(text: string, width: number): string {
+  if (text.length >= width) return text.slice(0, width)
+  return text + " ".repeat(width - text.length)
+}