@variantree/watcher 0.1.0

package/dist/tools/index.js

@@ -0,0 +1,42 @@
+/**
+ * All registered tool integrations.
+ *
+ * To add a new tool: create src/tools/<toolname>/ implementing ToolIntegration,
+ * then add it to the ALL_TOOLS array below.
+ */
+export { VARIANTREE_MARKER, VARIANTREE_INSTRUCTIONS_SECTION, mergeInstructions } from './instructions.js';
+export { opencodeTool, OpenCodeAdapter, mergeAgentsMd } from './opencode/index.js';
+export { claudecodeTool, ClaudeCodeAdapter } from './claudecode/index.js';
+import { opencodeTool } from './opencode/index.js';
+import { claudecodeTool } from './claudecode/index.js';
+/** Every tool Variantree knows about. Used by postinstall and ensureInstructions. */
+export const ALL_TOOLS = [opencodeTool, claudecodeTool];
+/**
+ * Write standing instructions for all tools into the project directory.
+ * Called on every MCP session start and `variantree init`.
+ */
+export function ensureProjectInstructions(projectDir) {
+    for (const tool of ALL_TOOLS) {
+        try {
+            tool.writeProjectInstructions(projectDir);
+        }
+        catch {
+            // Never let instruction writing break the main flow
+        }
+    }
+}
+/**
+ * Register MCP server in all tools' global configs.
+ * Called once by the postinstall script.
+ */
+export function registerAllMcp() {
+    for (const tool of ALL_TOOLS) {
+        try {
+            tool.registerGlobalMcp?.();
+        }
+        catch {
+            // Postinstall must never fail
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE1G,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,qFAAqF;AACrF,MAAM,CAAC,MAAM,SAAS,GAAsB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tools/instructions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Canonical standing-instructions text for Variantree.
+ *
+ * This is the single source of truth. Each tool module uses the marker +
+ * body to write into its own file format (AGENTS.md, CLAUDE.md, etc.).
+ */
+export declare const VARIANTREE_MARKER = "<!-- variantree:instructions -->";
+export declare const VARIANTREE_INSTRUCTIONS_BODY = "## Variantree \u2014 AI Version Control\n\nYou have access to Variantree MCP tools for managing conversation context and\ncode snapshots. Use them **proactively** \u2014 don't wait for the user to ask.\n\n### On session start\n- If `.variantree/branch-context.md` exists, read it immediately for context\n  on prior work done on this branch.\n\n### When to checkpoint\n- After completing a distinct task or sub-task (e.g. \"auth is working\",\n  \"tests pass\", \"refactor done\").\n- When the user says \"done\", \"looks good\", \"ship it\", or \"let's move on\".\n- Before any branch, switch, or restore \u2014 the tools will warn you if you\n  forget, but it's better to checkpoint proactively.\n\n### When to branch\n- When the user wants to explore an alternative approach (\"let's try X\n  instead\", \"what if we used Y\").\n- When the user asks to experiment without losing current progress.\n\n### When to switch / restore\n- When the user wants to go back to a previous line of work or a known-good\n  state (\"go back to main\", \"restore the working version\").\n\n### Handling unsaved-message warnings\nIf a tool returns an unsaved-message warning (e.g. \"4 messages will be lost\"):\n1. **STOP** \u2014 do NOT silently pass `force: true`.\n2. Tell the user exactly how many messages will be lost.\n3. Ask: *\"Should I checkpoint first to save them, or discard them and\n   proceed?\"*\n4. Only use `force: true` after the user explicitly says to discard /\n   proceed without saving.\n\n### Presenting results to the user\n**IMPORTANT:** Always relay the COMPLETE tool output to the user. Do not\nsummarise or omit details. Specifically:\n\n- **checkpoint:** Show messages synced count, snapshot diff (files added,\n  modified, deleted), and total file count.\n- **branch / switch / restore:** Show files written and deleted, then show\n  the full conversation context summary that was returned.\n- **status:** Show ALL fields: active branch, message count, every branch\n  name, and every checkpoint label with snapshot indicator.\n- **tree:** Show the FULL tree output exactly as returned \u2014 branches AND\n  checkpoints. Do not collapse or summarise it.\n- **log:** Show the full conversation history returned by the tool.\n\n### Tool reference\n| Tool        | Purpose                                      |\n|-------------|----------------------------------------------|\n| checkpoint  | Sync conversation + snapshot code             |\n| branch      | Create a new branch from a checkpoint         |\n| switch      | Switch to an existing branch                  |\n| restore     | Restore code to a specific checkpoint         |\n| status      | Show active branch, checkpoints               |\n| tree        | ASCII tree of branches and checkpoints        |\n| log         | Show conversation history for a branch        |";
+/** The full fenced section, ready to embed in any markdown file. */
+export declare const VARIANTREE_INSTRUCTIONS_SECTION = "<!-- variantree:instructions -->\n## Variantree \u2014 AI Version Control\n\nYou have access to Variantree MCP tools for managing conversation context and\ncode snapshots. Use them **proactively** \u2014 don't wait for the user to ask.\n\n### On session start\n- If `.variantree/branch-context.md` exists, read it immediately for context\n  on prior work done on this branch.\n\n### When to checkpoint\n- After completing a distinct task or sub-task (e.g. \"auth is working\",\n  \"tests pass\", \"refactor done\").\n- When the user says \"done\", \"looks good\", \"ship it\", or \"let's move on\".\n- Before any branch, switch, or restore \u2014 the tools will warn you if you\n  forget, but it's better to checkpoint proactively.\n\n### When to branch\n- When the user wants to explore an alternative approach (\"let's try X\n  instead\", \"what if we used Y\").\n- When the user asks to experiment without losing current progress.\n\n### When to switch / restore\n- When the user wants to go back to a previous line of work or a known-good\n  state (\"go back to main\", \"restore the working version\").\n\n### Handling unsaved-message warnings\nIf a tool returns an unsaved-message warning (e.g. \"4 messages will be lost\"):\n1. **STOP** \u2014 do NOT silently pass `force: true`.\n2. Tell the user exactly how many messages will be lost.\n3. Ask: *\"Should I checkpoint first to save them, or discard them and\n   proceed?\"*\n4. Only use `force: true` after the user explicitly says to discard /\n   proceed without saving.\n\n### Presenting results to the user\n**IMPORTANT:** Always relay the COMPLETE tool output to the user. Do not\nsummarise or omit details. Specifically:\n\n- **checkpoint:** Show messages synced count, snapshot diff (files added,\n  modified, deleted), and total file count.\n- **branch / switch / restore:** Show files written and deleted, then show\n  the full conversation context summary that was returned.\n- **status:** Show ALL fields: active branch, message count, every branch\n  name, and every checkpoint label with snapshot indicator.\n- **tree:** Show the FULL tree output exactly as returned \u2014 branches AND\n  checkpoints. Do not collapse or summarise it.\n- **log:** Show the full conversation history returned by the tool.\n\n### Tool reference\n| Tool        | Purpose                                      |\n|-------------|----------------------------------------------|\n| checkpoint  | Sync conversation + snapshot code             |\n| branch      | Create a new branch from a checkpoint         |\n| switch      | Switch to an existing branch                  |\n| restore     | Restore code to a specific checkpoint         |\n| status      | Show active branch, checkpoints               |\n| tree        | ASCII tree of branches and checkpoints        |\n| log         | Show conversation history for a branch        |\n<!-- variantree:instructions -->";
+/**
+ * Merge the Variantree instructions section into an existing file's content.
+ *
+ * - No existing content → wraps in a minimal markdown document.
+ * - Content without the marker → appends the section.
+ * - Content with the marker → replaces the section in-place.
+ */
+export declare function mergeInstructions(existingContent: string | null, heading: string): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/tools/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/tools/instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AAEpE,eAAO,MAAM,4BAA4B,oyFA0DuB,CAAC;AAEjE,oEAAoE;AACpE,eAAO,MAAM,+BAA+B,w2FACmC,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBzF"}

package/dist/tools/instructions.js

@@ -0,0 +1,93 @@
+/**
+ * Canonical standing-instructions text for Variantree.
+ *
+ * This is the single source of truth. Each tool module uses the marker +
+ * body to write into its own file format (AGENTS.md, CLAUDE.md, etc.).
+ */
+export const VARIANTREE_MARKER = '<!-- variantree:instructions -->';
+export const VARIANTREE_INSTRUCTIONS_BODY = `\
+## Variantree — AI Version Control
+
+You have access to Variantree MCP tools for managing conversation context and
+code snapshots. Use them **proactively** — don't wait for the user to ask.
+
+### On session start
+- If \`.variantree/branch-context.md\` exists, read it immediately for context
+  on prior work done on this branch.
+
+### When to checkpoint
+- After completing a distinct task or sub-task (e.g. "auth is working",
+  "tests pass", "refactor done").
+- When the user says "done", "looks good", "ship it", or "let's move on".
+- Before any branch, switch, or restore — the tools will warn you if you
+  forget, but it's better to checkpoint proactively.
+
+### When to branch
+- When the user wants to explore an alternative approach ("let's try X
+  instead", "what if we used Y").
+- When the user asks to experiment without losing current progress.
+
+### When to switch / restore
+- When the user wants to go back to a previous line of work or a known-good
+  state ("go back to main", "restore the working version").
+
+### Handling unsaved-message warnings
+If a tool returns an unsaved-message warning (e.g. "4 messages will be lost"):
+1. **STOP** — do NOT silently pass \`force: true\`.
+2. Tell the user exactly how many messages will be lost.
+3. Ask: *"Should I checkpoint first to save them, or discard them and
+   proceed?"*
+4. Only use \`force: true\` after the user explicitly says to discard /
+   proceed without saving.
+
+### Presenting results to the user
+**IMPORTANT:** Always relay the COMPLETE tool output to the user. Do not
+summarise or omit details. Specifically:
+
+- **checkpoint:** Show messages synced count, snapshot diff (files added,
+  modified, deleted), and total file count.
+- **branch / switch / restore:** Show files written and deleted, then show
+  the full conversation context summary that was returned.
+- **status:** Show ALL fields: active branch, message count, every branch
+  name, and every checkpoint label with snapshot indicator.
+- **tree:** Show the FULL tree output exactly as returned — branches AND
+  checkpoints. Do not collapse or summarise it.
+- **log:** Show the full conversation history returned by the tool.
+
+### Tool reference
+| Tool        | Purpose                                      |
+|-------------|----------------------------------------------|
+| checkpoint  | Sync conversation + snapshot code             |
+| branch      | Create a new branch from a checkpoint         |
+| switch      | Switch to an existing branch                  |
+| restore     | Restore code to a specific checkpoint         |
+| status      | Show active branch, checkpoints               |
+| tree        | ASCII tree of branches and checkpoints        |
+| log         | Show conversation history for a branch        |`;
+/** The full fenced section, ready to embed in any markdown file. */
+export const VARIANTREE_INSTRUCTIONS_SECTION = `${VARIANTREE_MARKER}\n${VARIANTREE_INSTRUCTIONS_BODY}\n${VARIANTREE_MARKER}`;
+/**
+ * Merge the Variantree instructions section into an existing file's content.
+ *
+ * - No existing content → wraps in a minimal markdown document.
+ * - Content without the marker → appends the section.
+ * - Content with the marker → replaces the section in-place.
+ */
+export function mergeInstructions(existingContent, heading) {
+    const section = VARIANTREE_INSTRUCTIONS_SECTION;
+    if (!existingContent) {
+        return `# ${heading}\n\n${section}\n`;
+    }
+    const start = existingContent.indexOf(VARIANTREE_MARKER);
+    if (start === -1) {
+        return existingContent.trimEnd() + '\n\n' + section + '\n';
+    }
+    const end = existingContent.indexOf(VARIANTREE_MARKER, start + VARIANTREE_MARKER.length);
+    if (end === -1) {
+        return existingContent.trimEnd() + '\n\n' + section + '\n';
+    }
+    const before = existingContent.slice(0, start);
+    const after = existingContent.slice(end + VARIANTREE_MARKER.length);
+    return before + section + after;
+}
+//# sourceMappingURL=instructions.js.map

package/dist/tools/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/tools/instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAEpE,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEA0DoB,CAAC;AAEjE,oEAAoE;AACpE,MAAM,CAAC,MAAM,+BAA+B,GAC1C,GAAG,iBAAiB,KAAK,4BAA4B,KAAK,iBAAiB,EAAE,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,eAA8B,EAAE,OAAe;IAC/E,MAAM,OAAO,GAAG,+BAA+B,CAAC;IAEhD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,KAAK,OAAO,OAAO,OAAO,IAAI,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC7D,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACzF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAClC,CAAC"}

package/dist/tools/opencode/adapter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @variantree/watcher — OpenCode Session Adapter
+ *
+ * OpenCode stores all data in a SQLite database (WAL mode).
+ * Location varies by OS:
+ *   macOS/Linux: ~/.local/share/opencode/opencode.db
+ *   Windows:     %APPDATA%/opencode/opencode.db
+ *
+ * Uses better-sqlite3 (native binding) so WAL-mode writes are visible
+ * immediately — sql.js only reads the main DB file and misses WAL data.
+ *
+ * Schema:
+ *   session → message (data JSON: {role, time, ...})
+ *             → part (data JSON: {type:"text", text:"..."})
+ */
+import type { Message } from '@variantree/core';
+import type { SessionAdapter } from '../base.js';
+export declare class OpenCodeAdapter implements SessionAdapter {
+    readonly name = "opencode";
+    private getDbPath;
+    private openDb;
+    /**
+     * Returns the path to the WAL file — this changes on every DB write,
+     * making it the perfect file for chokidar to watch.
+     */
+    findSessionFile(workspacePath: string): Promise<string | null>;
+    /**
+     * parseMessages reads from the SQLite DB directly.
+     * The `raw` parameter is ignored — use readMessagesAsync instead.
+     */
+    parseMessages(_raw: string): Message[];
+    /**
+     * Get the ID of the most recently active OpenCode session for a directory.
+     * Returns null if no session exists yet.
+     */
+    getCurrentSessionId(workspacePath: string): Promise<string | null>;
+    /**
+     * Read messages from OpenCode's DB, optionally scoped to a specific session.
+     *
+     * @param workspacePath - Filter to sessions for this directory
+     * @param sessionId - If provided, read from this specific session instead of
+     *   querying for the latest. Prevents stale messages from old sessions.
+     */
+    readMessagesAsync(workspacePath?: string, sessionId?: string): Promise<Message[]>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/tools/opencode/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/tools/opencode/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAkBjD,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAKd;;;OAGG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkBpE;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAItC;;;OAGG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAaxE;;;;;;OAMG;IACG,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAqExF"}

package/dist/tools/opencode/adapter.js

@@ -0,0 +1,166 @@
+/**
+ * @variantree/watcher — OpenCode Session Adapter
+ *
+ * OpenCode stores all data in a SQLite database (WAL mode).
+ * Location varies by OS:
+ *   macOS/Linux: ~/.local/share/opencode/opencode.db
+ *   Windows:     %APPDATA%/opencode/opencode.db
+ *
+ * Uses better-sqlite3 (native binding) so WAL-mode writes are visible
+ * immediately — sql.js only reads the main DB file and misses WAL data.
+ *
+ * Schema:
+ *   session → message (data JSON: {role, time, ...})
+ *             → part (data JSON: {type:"text", text:"..."})
+ */
+import Database from 'better-sqlite3';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+/**
+ * Get the OpenCode data directory based on the current OS.
+ *
+ * macOS/Linux: ~/.local/share/opencode/
+ * Windows:     %APPDATA%/opencode/
+ */
+function getOpenCodeDataDir() {
+    const platform = os.platform();
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
+        return path.join(appData, 'opencode');
+    }
+    const dataHome = process.env.XDG_DATA_HOME ?? path.join(os.homedir(), '.local', 'share');
+    return path.join(dataHome, 'opencode');
+}
+export class OpenCodeAdapter {
+    name = 'opencode';
+    getDbPath() {
+        return path.join(getOpenCodeDataDir(), 'opencode.db');
+    }
+    openDb() {
+        const dbPath = this.getDbPath();
+        return new Database(dbPath, { readonly: true });
+    }
+    /**
+     * Returns the path to the WAL file — this changes on every DB write,
+     * making it the perfect file for chokidar to watch.
+     */
+    async findSessionFile(workspacePath) {
+        const dbPath = this.getDbPath();
+        try {
+            fs.accessSync(dbPath);
+            const db = this.openDb();
+            const row = db.prepare(`SELECT id FROM session WHERE directory = ? ORDER BY time_updated DESC LIMIT 1`).get(workspacePath);
+            db.close();
+            if (!row)
+                return null;
+            const walPath = dbPath + '-wal';
+            try {
+                fs.accessSync(walPath);
+                return walPath;
+            }
+            catch {
+                return dbPath;
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * parseMessages reads from the SQLite DB directly.
+     * The `raw` parameter is ignored — use readMessagesAsync instead.
+     */
+    parseMessages(_raw) {
+        return [];
+    }
+    /**
+     * Get the ID of the most recently active OpenCode session for a directory.
+     * Returns null if no session exists yet.
+     */
+    async getCurrentSessionId(workspacePath) {
+        try {
+            const db = this.openDb();
+            const row = db.prepare(`SELECT id FROM session WHERE directory = ? ORDER BY time_updated DESC LIMIT 1`).get(workspacePath);
+            db.close();
+            return row?.id ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Read messages from OpenCode's DB, optionally scoped to a specific session.
+     *
+     * @param workspacePath - Filter to sessions for this directory
+     * @param sessionId - If provided, read from this specific session instead of
+     *   querying for the latest. Prevents stale messages from old sessions.
+     */
+    async readMessagesAsync(workspacePath, sessionId) {
+        try {
+            const db = this.openDb();
+            let resolvedSessionId;
+            if (sessionId) {
+                const check = db.prepare(`SELECT id FROM session WHERE id = ? LIMIT 1`).get(sessionId);
+                if (!check) {
+                    db.close();
+                    return [];
+                }
+                resolvedSessionId = sessionId;
+            }
+            else {
+                let row;
+                if (workspacePath) {
+                    row = db.prepare(`SELECT id FROM session WHERE directory = ? ORDER BY time_updated DESC LIMIT 1`).get(workspacePath);
+                }
+                else {
+                    row = db.prepare(`SELECT id FROM session ORDER BY time_updated DESC LIMIT 1`).get();
+                }
+                if (!row) {
+                    db.close();
+                    return [];
+                }
+                resolvedSessionId = row.id;
+            }
+            const msgRows = db.prepare(`SELECT id, data, time_created FROM message WHERE session_id = ? ORDER BY time_created ASC`).all(resolvedSessionId);
+            const partRows = db.prepare(`SELECT message_id, data FROM part WHERE session_id = ? ORDER BY time_created ASC`).all(resolvedSessionId);
+            db.close();
+            // Group text parts by message ID
+            const partsByMsg = new Map();
+            for (const row of partRows) {
+                try {
+                    const partData = JSON.parse(row.data);
+                    if (partData.type === 'text' && partData.text) {
+                        if (!partsByMsg.has(row.message_id))
+                            partsByMsg.set(row.message_id, []);
+                        partsByMsg.get(row.message_id).push(partData.text);
+                    }
+                }
+                catch { /* skip malformed parts */ }
+            }
+            // Build Message array
+            const result = [];
+            for (const msg of msgRows) {
+                try {
+                    const msgData = JSON.parse(msg.data);
+                    const textParts = partsByMsg.get(msg.id) ?? [];
+                    const content = textParts.join('');
+                    if (!content)
+                        continue;
+                    result.push({
+                        id: msg.id,
+                        role: msgData.role === 'user' ? 'user' : 'assistant',
+                        content,
+                        timestamp: msg.time_created,
+                    });
+                }
+                catch { /* skip malformed messages */ }
+            }
+            return result;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/tools/opencode/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/tools/opencode/adapter.ts"],"names":[],"mappings":"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"}

package/dist/tools/opencode/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OpenCode global MCP registration.
+ *
+ * Writes the Variantree MCP server entry into ~/.config/opencode/opencode.json.
+ * Called once by the postinstall script.
+ */
+export declare function registerGlobalMcp(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/tools/opencode/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/tools/opencode/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,wBAAgB,iBAAiB,IAAI,IAAI,CAiBxC"}

package/dist/tools/opencode/config.js

@@ -0,0 +1,37 @@
+/**
+ * OpenCode global MCP registration.
+ *
+ * Writes the Variantree MCP server entry into ~/.config/opencode/opencode.json.
+ * Called once by the postinstall script.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const MCP_ENTRY = {
+    type: 'local',
+    command: ['npx', '-y', '@variantree/mcp'],
+    environment: { VARIANTREE_DIR: '.' },
+};
+function getConfigPath() {
+    const configDir = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), '.config');
+    return path.join(configDir, 'opencode', 'opencode.json');
+}
+export function registerGlobalMcp() {
+    const configPath = getConfigPath();
+    const configDir = path.dirname(configPath);
+    let config = {};
+    try {
+        config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+    catch { }
+    if (!config.mcp)
+        config.mcp = {};
+    const mcp = config.mcp;
+    if (mcp.variantree)
+        return; // already registered
+    mcp.variantree = MCP_ENTRY;
+    fs.mkdirSync(configDir, { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    console.log('[variantree] OpenCode: MCP server registered in', configPath);
+}
+//# sourceMappingURL=config.js.map

package/dist/tools/opencode/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/tools/opencode/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,iBAAiB,CAAC;IACzC,WAAW,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE;CACrC,CAAC;AAEF,SAAS,aAAa;IACpB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACpF,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3C,IAAI,MAAM,GAA4B,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,IAAI,CAAC,MAAM,CAAC,GAAG;QAAE,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,GAA8B,CAAC;IAClD,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,CAAC,qBAAqB;IAEjD,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC;IAC3B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,iDAAiD,EAAE,UAAU,CAAC,CAAC;AAC7E,CAAC"}

package/dist/tools/opencode/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * OpenCode tool integration.
+ */
+import type { ToolIntegration } from '../base.js';
+export { OpenCodeAdapter } from './adapter.js';
+export { writeProjectInstructions, mergeAgentsMd } from './instructions.js';
+export { registerGlobalMcp } from './config.js';
+export declare const opencodeTool: ToolIntegration;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/opencode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/opencode/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,YAAY,EAAE,eAK1B,CAAC"}

package/dist/tools/opencode/index.js

@@ -0,0 +1,16 @@
+/**
+ * OpenCode tool integration.
+ */
+import { OpenCodeAdapter } from './adapter.js';
+import { writeProjectInstructions } from './instructions.js';
+import { registerGlobalMcp } from './config.js';
+export { OpenCodeAdapter } from './adapter.js';
+export { writeProjectInstructions, mergeAgentsMd } from './instructions.js';
+export { registerGlobalMcp } from './config.js';
+export const opencodeTool = {
+    name: 'opencode',
+    adapter: new OpenCodeAdapter(),
+    registerGlobalMcp,
+    writeProjectInstructions,
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/opencode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/opencode/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,IAAI,eAAe,EAAE;IAC9B,iBAAiB;IACjB,wBAAwB;CACzB,CAAC"}

package/dist/tools/opencode/instructions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OpenCode standing instructions — writes/merges into AGENTS.md.
+ *
+ * OpenCode reads AGENTS.md (and AGENTS, .agents.md variants) from the project
+ * root. OpenAI Codex also follows the same convention.
+ */
+export declare function writeProjectInstructions(projectDir: string): void;
+/** @deprecated Use writeProjectInstructions. Kept for backwards compatibility. */
+export declare function mergeAgentsMd(existingContent: string | null): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/tools/opencode/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/tools/opencode/instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMjE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEpE"}

package/dist/tools/opencode/instructions.js

@@ -0,0 +1,26 @@
+/**
+ * OpenCode standing instructions — writes/merges into AGENTS.md.
+ *
+ * OpenCode reads AGENTS.md (and AGENTS, .agents.md variants) from the project
+ * root. OpenAI Codex also follows the same convention.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { mergeInstructions, VARIANTREE_MARKER } from '../instructions.js';
+const FILENAME = 'AGENTS.md';
+export function writeProjectInstructions(projectDir) {
+    const filePath = path.join(projectDir, FILENAME);
+    let existing = null;
+    try {
+        existing = fs.readFileSync(filePath, 'utf8');
+    }
+    catch { }
+    if (existing?.includes(VARIANTREE_MARKER))
+        return;
+    fs.writeFileSync(filePath, mergeInstructions(existing, 'AGENTS'), 'utf8');
+}
+/** @deprecated Use writeProjectInstructions. Kept for backwards compatibility. */
+export function mergeAgentsMd(existingContent) {
+    return mergeInstructions(existingContent, 'AGENTS');
+}
+//# sourceMappingURL=instructions.js.map

package/dist/tools/opencode/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../src/tools/opencode/instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,QAAQ,GAAG,WAAW,CAAC;AAE7B,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,CAAC;QAAC,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAC9D,IAAI,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO;IAClD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,eAA8B;IAC1D,OAAO,iBAAiB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/dist/watcher.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @variantree/watcher — VariantreeWatcher
+ *
+ * Watches an AI tool's session for new messages using chokidar.
+ * On every change event:
+ *   1. Reads messages via the adapter's readMessagesAsync
+ *   2. Diffs to find new messages
+ *   3. Adds new messages to the active Variantree branch
+ */
+import { VariantTree } from '@variantree/core';
+import type { SessionAdapter } from './tools/base.js';
+export interface WatcherOptions {
+    /** Absolute path to the workspace being watched */
+    workspacePath: string;
+    /** Session adapter for the AI tool (e.g. OpenCodeAdapter) */
+    adapter: SessionAdapter;
+    /** Pre-configured VariantTree engine instance */
+    engine: VariantTree;
+    /** Called when new messages are synced (optional, for logging) */
+    onSync?: (count: number) => void;
+    /** Called on errors (optional) */
+    onError?: (err: Error) => void;
+}
+export declare class VariantreeWatcher {
+    private watcher;
+    private readonly differ;
+    private readonly opts;
+    private sessionId;
+    constructor(opts: WatcherOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Pick the best file to watch for changes.
+     * OpenCode: the WAL file changes on every DB write.
+     * Claude Code: the session JSONL file itself.
+     * Fallback: poll the workspace directory.
+     */
+    private resolveWatchTarget;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,OAAO,EAAE,cAAc,CAAC;IACxB,iDAAiD;IACjD,MAAM,EAAE,WAAW,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,IAAI,EAAE,cAAc;IAI1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAS3B"}