@ranger-testing/opencode-plugin 0.0.1

package/README.md

@@ -0,0 +1,32 @@
+# Ranger OpenCode Plugin
+
+Ranger hooks for OpenCode sessions. Use this plugin to track features and run browser verification from OpenCode.
+
+## Install
+
+1. Install the Ranger CLI.
+
+```bash
+npm install -g @ranger-testing/ranger-cli
+```
+
+2. Run setup from your project root.
+
+```bash
+ranger setup --opencode
+```
+
+This writes `opencode.json` with the plugin entry and completes authentication.
+
+3. Start OpenCode and run the `ranger_enable` tool to enable hooks.
+
+## Manual config
+
+If you prefer to edit the config yourself, add this to `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@ranger-testing/opencode-plugin"]
+}
+```

package/build/index.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from '@opencode-ai/plugin';
+export declare const RangerPlugin: Plugin;

package/build/index.js

@@ -0,0 +1,184 @@
+import { tool } from '@opencode-ai/plugin/tool';
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+const require = createRequire(import.meta.url);
+const resolveRangerCommand = () => {
+    try {
+        const pkgPath = require.resolve('@ranger-testing/ranger-cli/package.json');
+        return path.join(path.dirname(pkgPath), 'build', 'cli.js');
+    }
+    catch {
+        return 'ranger';
+    }
+};
+const rangerCommand = resolveRangerCommand();
+async function runHook($, name, sessionId, onError) {
+    try {
+        const result = await $ `${rangerCommand} hook --name=${name} --session-id=${sessionId}`
+            .quiet()
+            .text();
+        return result.trim();
+    }
+    catch (error) {
+        onError?.(name, error);
+        return '';
+    }
+}
+async function runEnable($, sessionId) {
+    try {
+        const result = await $ `${rangerCommand} hook enable --session-id=${sessionId}`
+            .quiet()
+            .text();
+        return { ok: true, output: result.trim() };
+    }
+    catch {
+        return {
+            ok: false,
+            output: 'Failed to enable Ranger. Make sure @ranger-testing/ranger-cli ' +
+                'is installed.',
+        };
+    }
+}
+async function runDisable($, sessionId) {
+    try {
+        const result = await $ `${rangerCommand} hook disable --session-id=${sessionId}`
+            .quiet()
+            .text();
+        return { ok: true, output: result.trim() };
+    }
+    catch {
+        return { ok: false, output: 'Failed to disable Ranger.' };
+    }
+}
+export const RangerPlugin = async ({ $ }) => {
+    let enabled = false;
+    let currentSessionId = '';
+    let lastEditEventAt = 0;
+    let lastEditHookOutput = null;
+    let hookErrorLogged = false;
+    const editDedupeWindowMs = 2000;
+    const logHookError = (name, error) => {
+        if (hookErrorLogged)
+            return;
+        hookErrorLogged = true;
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[ranger] hook "${name}" failed: ${message}`);
+    };
+    return {
+        tool: {
+            ranger_enable: tool({
+                description: 'Enable Ranger feature tracking hooks for this session. ' +
+                    'Call this when the user asks to enable ranger or use the /ranger workflow.',
+                args: {},
+                async execute(_args, ctx) {
+                    const sid = ctx.sessionID || currentSessionId;
+                    if (!sid)
+                        return 'No session ID available.';
+                    const result = await runEnable($, sid);
+                    if (result.ok) {
+                        enabled = true;
+                        currentSessionId = sid;
+                    }
+                    return result.output || 'Ranger enabled.';
+                },
+            }),
+            ranger_disable: tool({
+                description: 'Disable Ranger feature tracking hooks for this session. ' +
+                    'Call this when the user asks to disable ranger.',
+                args: {},
+                async execute(_args, ctx) {
+                    const sid = ctx.sessionID || currentSessionId;
+                    if (!sid)
+                        return 'No session ID available.';
+                    const result = await runDisable($, sid);
+                    if (result.ok)
+                        enabled = false;
+                    return result.output || 'Ranger disabled.';
+                },
+            }),
+        },
+        event: async ({ event }) => {
+            switch (event.type) {
+                case 'session.created': {
+                    currentSessionId = event.properties.info.id;
+                    lastEditEventAt = 0;
+                    lastEditHookOutput = null;
+                    hookErrorLogged = false;
+                    try {
+                        const result = await $ `${rangerCommand} hook --name=session-start --session-id=${currentSessionId}`
+                            .quiet()
+                            .nothrow()
+                            .text();
+                        enabled = result.length > 0;
+                    }
+                    catch {
+                        enabled = false;
+                    }
+                    break;
+                }
+                case 'session.idle':
+                    if (!enabled || !currentSessionId)
+                        return;
+                    await runHook($, 'stop', currentSessionId, logHookError);
+                    await runHook($, 'session-end', currentSessionId, logHookError);
+                    enabled = false;
+                    currentSessionId = '';
+                    lastEditEventAt = 0;
+                    lastEditHookOutput = null;
+                    break;
+                case 'file.edited':
+                    if (!enabled || !currentSessionId)
+                        return;
+                    lastEditEventAt = Date.now();
+                    lastEditHookOutput = await runHook($, 'post-edit', currentSessionId, logHookError);
+                    await runHook($, 'plan-reminder', currentSessionId, logHookError);
+                    break;
+                case 'message.updated':
+                    if (!enabled || !currentSessionId)
+                        return;
+                    await runHook($, 'plan-reminder', currentSessionId, logHookError);
+                    break;
+            }
+        },
+        'experimental.session.compacting': async ({ sessionID }, output) => {
+            if (!enabled)
+                return;
+            const sid = sessionID || currentSessionId;
+            if (!sid)
+                return;
+            const context = await runHook($, 'pre-compact', sid, logHookError);
+            if (context) {
+                output.context.push(context);
+            }
+        },
+        'tool.execute.after': async ({ tool: toolName, sessionID }, output) => {
+            if (!enabled)
+                return;
+            const sid = sessionID || currentSessionId;
+            if (!sid)
+                return;
+            const editTools = ['file_edit', 'edit', 'write', 'multi_edit'];
+            if (editTools.includes(toolName)) {
+                const now = Date.now();
+                const isRecentEditEvent = lastEditEventAt > 0 &&
+                    now - lastEditEventAt < editDedupeWindowMs;
+                const hookOutput = isRecentEditEvent
+                    ? lastEditHookOutput || ''
+                    : await runHook($, 'post-edit', sid, logHookError);
+                if (!isRecentEditEvent) {
+                    await runHook($, 'plan-reminder', sid, logHookError);
+                }
+                lastEditEventAt = 0;
+                lastEditHookOutput = null;
+                if (hookOutput) {
+                    output.output = [output.output, hookOutput]
+                        .filter(Boolean)
+                        .join('\n');
+                }
+                return;
+            }
+            await runHook($, 'plan-reminder', sid, logHookError);
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,oBAAoB,GAAG,GAAW,EAAE;IACtC,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC3B,yCAAyC,CAC5C,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,QAAQ,CAAC;IACpB,CAAC;AACL,CAAC,CAAC;AACF,MAAM,aAAa,GAAG,oBAAoB,EAAE,CAAC;AAE7C,KAAK,UAAU,OAAO,CAClB,CAAU,EACV,IAAY,EACZ,SAAiB,EACjB,OAAgD;IAEhD,IAAI,CAAC;QACD,MAAM,MAAM,GACR,MAAM,CAAC,CAAA,GAAG,aAAa,gBAAgB,IAAI,iBAAiB,SAAS,EAAE;aAClE,KAAK,EAAE;aACP,IAAI,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,KAAK,UAAU,SAAS,CACpB,CAAU,EACV,SAAiB;IAEjB,IAAI,CAAC;QACD,MAAM,MAAM,GACR,MAAM,CAAC,CAAA,GAAG,aAAa,6BAA6B,SAAS,EAAE;aAC9D,KAAK,EAAE;aACP,IAAI,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO;YACH,EAAE,EAAE,KAAK;YACT,MAAM,EACF,gEAAgE;gBAChE,eAAe;SACtB,CAAC;IACN,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CACrB,CAAU,EACV,SAAiB;IAEjB,IAAI,CAAC;QACD,MAAM,MAAM,GACR,MAAM,CAAC,CAAA,GAAG,aAAa,8BAA8B,SAAS,EAAE;aAC/D,KAAK,EAAE;aACP,IAAI,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAC9D,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAW,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;IAChD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAC1B,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAC7C,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,MAAM,kBAAkB,GAAG,IAAI,CAAC;IAEhC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;QAClD,IAAI,eAAe;YAAE,OAAO;QAC5B,eAAe,GAAG,IAAI,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,kBAAkB,IAAI,aAAa,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,OAAO;QACH,IAAI,EAAE;YACF,aAAa,EAAE,IAAI,CAAC;gBAChB,WAAW,EACP,yDAAyD;oBACzD,4EAA4E;gBAChF,IAAI,EAAE,EAAE;gBACR,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;oBACpB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,gBAAgB,CAAC;oBAC9C,IAAI,CAAC,GAAG;wBAAE,OAAO,0BAA0B,CAAC;oBAC5C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACvC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;wBACZ,OAAO,GAAG,IAAI,CAAC;wBACf,gBAAgB,GAAG,GAAG,CAAC;oBAC3B,CAAC;oBACD,OAAO,MAAM,CAAC,MAAM,IAAI,iBAAiB,CAAC;gBAC9C,CAAC;aACJ,CAAC;YAEF,cAAc,EAAE,IAAI,CAAC;gBACjB,WAAW,EACP,0DAA0D;oBAC1D,iDAAiD;gBACrD,IAAI,EAAE,EAAE;gBACR,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;oBACpB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,gBAAgB,CAAC;oBAC9C,IAAI,CAAC,GAAG;wBAAE,OAAO,0BAA0B,CAAC;oBAC5C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACxC,IAAI,MAAM,CAAC,EAAE;wBAAE,OAAO,GAAG,KAAK,CAAC;oBAC/B,OAAO,MAAM,CAAC,MAAM,IAAI,kBAAkB,CAAC;gBAC/C,CAAC;aACJ,CAAC;SACL;QAED,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACvB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,iBAAiB,CAAC,CAAC,CAAC;oBACrB,gBAAgB,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5C,eAAe,GAAG,CAAC,CAAC;oBACpB,kBAAkB,GAAG,IAAI,CAAC;oBAC1B,eAAe,GAAG,KAAK,CAAC;oBACxB,IAAI,CAAC;wBACD,MAAM,MAAM,GACR,MAAM,CAAC,CAAA,GAAG,aAAa,2CAA2C,gBAAgB,EAAE;6BAC/E,KAAK,EAAE;6BACP,OAAO,EAAE;6BACT,IAAI,EAAE,CAAC;wBAChB,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;oBAChC,CAAC;oBAAC,MAAM,CAAC;wBACL,OAAO,GAAG,KAAK,CAAC;oBACpB,CAAC;oBACD,MAAM;gBACV,CAAC;gBAED,KAAK,cAAc;oBACf,IAAI,CAAC,OAAO,IAAI,CAAC,gBAAgB;wBAAE,OAAO;oBAC1C,MAAM,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;oBACzD,MAAM,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;oBAChE,OAAO,GAAG,KAAK,CAAC;oBAChB,gBAAgB,GAAG,EAAE,CAAC;oBACtB,eAAe,GAAG,CAAC,CAAC;oBACpB,kBAAkB,GAAG,IAAI,CAAC;oBAC1B,MAAM;gBAEV,KAAK,aAAa;oBACd,IAAI,CAAC,OAAO,IAAI,CAAC,gBAAgB;wBAAE,OAAO;oBAC1C,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,kBAAkB,GAAG,MAAM,OAAO,CAC9B,CAAC,EACD,WAAW,EACX,gBAAgB,EAChB,YAAY,CACf,CAAC;oBACF,MAAM,OAAO,CACT,CAAC,EACD,eAAe,EACf,gBAAgB,EAChB,YAAY,CACf,CAAC;oBACF,MAAM;gBAEV,KAAK,iBAAiB;oBAClB,IAAI,CAAC,OAAO,IAAI,CAAC,gBAAgB;wBAAE,OAAO;oBAC1C,MAAM,OAAO,CACT,CAAC,EACD,eAAe,EACf,gBAAgB,EAChB,YAAY,CACf,CAAC;oBACF,MAAM;YACd,CAAC;QACL,CAAC;QAED,iCAAiC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE;YAC/D,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,GAAG,GAAG,SAAS,IAAI,gBAAgB,CAAC;YAC1C,IAAI,CAAC,GAAG;gBAAE,OAAO;YACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;YACnE,IAAI,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QAED,oBAAoB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE;YAClE,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,GAAG,GAAG,SAAS,IAAI,gBAAgB,CAAC;YAC1C,IAAI,CAAC,GAAG;gBAAE,OAAO;YAEjB,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAC/D,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,MAAM,iBAAiB,GACnB,eAAe,GAAG,CAAC;oBACnB,GAAG,GAAG,eAAe,GAAG,kBAAkB,CAAC;gBAC/C,MAAM,UAAU,GAAG,iBAAiB;oBAChC,CAAC,CAAC,kBAAkB,IAAI,EAAE;oBAC1B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;gBACvD,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACrB,MAAM,OAAO,CACT,CAAC,EACD,eAAe,EACf,GAAG,EACH,YAAY,CACf,CAAC;gBACN,CAAC;gBACD,eAAe,GAAG,CAAC,CAAC;gBACpB,kBAAkB,GAAG,IAAI,CAAC;gBAC1B,IAAI,UAAU,EAAE,CAAC;oBACb,MAAM,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;yBACtC,MAAM,CAAC,OAAO,CAAC;yBACf,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;gBACD,OAAO;YACX,CAAC;YAED,MAAM,OAAO,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QACzD,CAAC;KACJ,CAAC;AACN,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "@ranger-testing/opencode-plugin",
+    "version": "0.0.1",
+    "description": "Ranger plugin for OpenCode - feature tracking hooks for AI coding sessions",
+    "type": "module",
+    "main": "./build/index.js",
+    "types": "./build/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./build/index.js",
+            "types": "./build/index.d.ts"
+        }
+    },
+    "files": [
+        "build"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "@ranger-testing/ranger-cli": "^2.0.6"
+    },
+    "peerDependencies": {
+        "@opencode-ai/plugin": ">=1.0.0"
+    },
+    "devDependencies": {
+        "@opencode-ai/plugin": "^1.1.50",
+        "@types/node": "^22.0.0",
+        "typescript": "^5.0.0"
+    },
+    "keywords": [
+        "opencode",
+        "opencode-plugin",
+        "ranger",
+        "testing",
+        "qa"
+    ],
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/ranger-testing/trailhead",
+        "directory": "opencode-plugin"
+    }
+}