opencode-bonfire 0.9.6

package/files/plugin/bonfire-hooks.ts

@@ -0,0 +1,51 @@
+/**
+ * Bonfire Plugin for OpenCode
+ *
+ * Provides event hooks for:
+ * - Suggesting archive after PR merge
+ * - Preserving session context during compaction
+ */
+
+import type { Plugin } from "@opencode-ai/plugin"
+import { existsSync, readFileSync } from "fs"
+import { join } from "path"
+
+export const BonfirePlugin: Plugin = async ({ directory }) => {
+  const bonfirePath = join(directory, ".bonfire")
+  const indexPath = join(bonfirePath, "index.md")
+
+  return {
+    /**
+     * After tool execution - detect PR merges and suggest archiving
+     */
+    "tool.execute.after": async (input, output) => {
+      if (input.tool !== "bash") return
+
+      const command = input.args?.command as string | undefined
+      if (!command) return
+
+      const isPrMerge =
+        command.includes("gh pr merge") || command.includes("gh pr close")
+
+      const succeeded = !output.error && output.result
+
+      if (isPrMerge && succeeded && existsSync(indexPath)) {
+        return {
+          message: `PR merged! Run \`/bonfire-archive\` to archive this session.`,
+        }
+      }
+    },
+
+    /**
+     * Preserve bonfire context during session compaction
+     */
+    "experimental.session.compacting": async (_input, output) => {
+      if (existsSync(indexPath)) {
+        const content = readFileSync(indexPath, "utf-8")
+        output.context.push(`## Bonfire Session Context\n\n${content}`)
+      }
+    },
+  }
+}
+
+// Plugin auto-discovered by filename - no default export needed

package/files/skill/bonfire-context/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: bonfire-context
+description: Load .bonfire/index.md context to understand ongoing work, previous decisions, blockers, and session history. Use when user references past work or asks about project status.
+license: MIT
+compatibility: opencode
+metadata:
+  category: session-management
+  author: vieko
+---
+
+# Bonfire Context
+
+This skill loads project session context from `.bonfire/index.md` to provide continuity across AI coding sessions.
+
+## When to Use This Skill
+
+Load this skill when the user:
+- Asks about previous work or decisions
+- References "last time", "previously", "before"
+- Wants to know about blockers or pending issues
+- Asks what the project status is
+- Starts a significant task that might have prior context
+
+## Instructions
+
+1. Find the git root: `git rev-parse --show-toplevel`
+
+2. Check if `.bonfire/index.md` exists at the git root
+
+3. If it exists, read it to understand:
+   - Current project status and recent work
+   - Active decisions and their rationale
+   - Known blockers or pending issues
+   - Links to relevant specs or documentation
+
+4. Check `.bonfire/specs/` if the user asks about implementation specs
+
+5. Check `.bonfire/docs/` if the user asks about documented topics
+
+## File Structure
+
+```
+.bonfire/
+├── index.md          # Main session context (read this first)
+├── config.json       # Project settings
+├── archive/          # Completed work history
+├── docs/             # Topic documentation
+└── specs/            # Implementation specs
+```
+
+## Important
+
+- This skill is for **reading** context, not updating it
+- Session updates happen via `/bonfire-end` command
+- Don't modify `.bonfire/index.md` unless explicitly asked
+- If `.bonfire/` doesn't exist, the project may not use this pattern

package/files/tool/bonfire.ts

@@ -0,0 +1,103 @@
+/**
+ * Bonfire Status Tool
+ *
+ * Returns structured session context for programmatic access.
+ */
+
+import { tool } from "@opencode-ai/plugin"
+import { existsSync, readFileSync } from "fs"
+
+interface BonfireStatus {
+  exists: boolean
+  project?: string
+  status?: string
+  branch?: string
+  currentState?: string
+  priorities?: string[]
+  recentSession?: {
+    number: number
+    date: string
+    goal: string
+  }
+}
+
+function extractSection(content: string, header: string): string | undefined {
+  const regex = new RegExp(`## ${header}\\n\\n([\\s\\S]*?)(?=\\n## |$)`, "i")
+  const match = content.match(regex)
+  return match ? match[1].trim() : undefined
+}
+
+function extractPriorities(content: string): string[] {
+  const section = extractSection(content, "Next Session Priorities")
+  if (!section) return []
+  const lines = section.split("\n")
+  return lines
+    .filter((line) => line.match(/^\d+\./))
+    .map((line) =>
+      line
+        .replace(/^\d+\.\s*\*\*/, "")
+        .replace(/\*\*.*$/, "")
+        .trim()
+    )
+    .slice(0, 5)
+}
+
+function extractMetadata(content: string): {
+  project?: string
+  status?: string
+  branch?: string
+} {
+  const projectMatch = content.match(/# Session Context: (.+)/)
+  const statusMatch = content.match(/\*\*Status\*\*: (.+)/)
+  const branchMatch = content.match(/\*\*Branch\*\*: `?([^`\n]+)`?/)
+  return {
+    project: projectMatch?.[1],
+    status: statusMatch?.[1],
+    branch: branchMatch?.[1],
+  }
+}
+
+function extractRecentSession(
+  content: string
+): { number: number; date: string; goal: string } | undefined {
+  const match = content.match(
+    /### Session (\d+) - ([\d-]+)[^\n]*\n\n\*\*Goal\*\*: (.+)/
+  )
+  if (!match) return undefined
+  return {
+    number: parseInt(match[1]),
+    date: match[2],
+    goal: match[3],
+  }
+}
+
+export default tool({
+  description:
+    "Get bonfire session status with structured context summary. Returns project info, current state, priorities, and recent session details.",
+  args: {},
+  async execute() {
+    const indexPath = ".bonfire/index.md"
+
+    if (!existsSync(indexPath)) {
+      const result: BonfireStatus = {
+        exists: false,
+      }
+      return JSON.stringify(result, null, 2)
+    }
+
+    const content = readFileSync(indexPath, "utf-8")
+    const metadata = extractMetadata(content)
+
+    const result: BonfireStatus = {
+      exists: true,
+      project: metadata.project,
+      status: metadata.status,
+      branch: metadata.branch,
+      currentState: extractSection(content, "Current State"),
+      priorities: extractPriorities(content),
+      recentSession: extractRecentSession(content),
+    }
+
+    return JSON.stringify(result, null, 2)
+  },
+})

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "opencode-bonfire",
+  "version": "0.9.6",
+  "description": "A plugin that maintains a living context document—read at session start, updated at session end. Pick up exactly where you left off.",
+  "type": "module",
+  "bin": {
+    "opencode-bonfire": "./dist/cli.js"
+  },
+  "scripts": {
+    "copy-files": "rm -rf files && mkdir -p files && cp -r ../opencode/agent ../opencode/command ../opencode/plugin ../opencode/skill ../opencode/tool ../opencode/opencode.json ../opencode/package.json files/",
+    "build": "bun run copy-files && bun build src/cli.ts --outdir dist --target node",
+    "prepublishOnly": "bun run build"
+  },
+  "files": [
+    "dist",
+    "files"
+  ],
+  "keywords": [
+    "opencode",
+    "ai",
+    "coding",
+    "session",
+    "context",
+    "plugin"
+  ],
+  "author": "vieko",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vieko/bonfire"
+  },
+  "homepage": "https://github.com/vieko/bonfire",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}