opencode-context-dropper-plugin 0.1.4 → 0.1.6

package/README.md

@@ -1,6 +1,9 @@
 # OpenCode Context Dropper Plugin
 
-A Context Dropper plugin for OpenCode, built with Bun and TypeScript. It leverages the internal `context-dropper` APIs to efficiently process a large set of files one-by-one entirely within your OpenCode sessions. It automatically tracks context and handles token pruning to allow continuous agent iteration.
+A Context Dropper plugin for OpenCode, built with Bun and TypeScript. It
+leverages the internal `context-dropper` APIs to efficiently process a large set
+of files one-by-one entirely within your OpenCode sessions. It automatically
+tracks context and handles token pruning to allow continuous agent iteration.
 
 ## Prerequisites
 
@@ -9,24 +12,44 @@ A Context Dropper plugin for OpenCode, built with Bun and TypeScript. It leverag
 
 ## Installation
 
-This plugin bundles `context-dropper` directly and acts as a self-contained module.
+You can install the `context-dropper` plugin using one of the following methods.
 
-1. Build the plugin in this directory:
+### 1. Configure OpenCode (Recommended)
 
-```bash
-bun install
-bun run build
+You do not need to manually install the package. OpenCode will automatically
+resolve and install it from the NPM registry when you add it to your
+configuration.
+
+You can configure the plugin either globally for all projects, or locally for a
+single project:
+
+**Option A: Project-Level (Local)**
+
+1. Create or edit the `opencode.json` file in the root of your project.
+2. Add the package name to the `plugin` array:
+
+```json
+{
+  "plugin": ["opencode-context-dropper-plugin"]
+}
 ```
 
-2. Find or create your OpenCode global configuration file at `~/.opencode/config.json`.
-3. Add the absolute path to this directory (`opencode-plugin`) to the `plugins` array. For example:
+**Option B: Global-Level**
+
+1. Create or edit your global OpenCode config file at
+   `~/.config/opencode/opencode.json`.
+2. Add the package name to the `plugin` array:
 
 ```json
 {
-  "plugins": ["/Users/far/Projects/context-dropper/opencode-plugin"]
+  "plugin": ["opencode-context-dropper-plugin"]
 }
 ```
 
+(Optional) If you prefer to manage the installation yourself, you can install
+the plugin globally using Bun (`bun install -g opencode-context-dropper-plugin`)
+or NPM (`npm install -g opencode-context-dropper-plugin`).
+
 ## Usage
 
 Once installed, start OpenCode:
@@ -35,14 +58,16 @@ Once installed, start OpenCode:
 opencode
 ```
 
-You can invoke the context dropper loop inside chat simply by using the `/drop` slash command:
+You can invoke the context dropper loop inside chat simply by using the `/drop`
+slash command:
 
 ```text
 /drop <filesetName> <instructions>
 ```
 
 - `<filesetName>` is the name of a pre-existing fileset in your project.
-- `<instructions>` is the prompt you want the AI to perform on each file sequentially.
+- `<instructions>` is the prompt you want the AI to perform on each file
+  sequentially.
 
 **Example:**
 
@@ -54,33 +79,27 @@ You can invoke the context dropper loop inside chat simply by using the `/drop`
 
 Once invoked, the plugin completely takes over the context management:
 
-1. It automatically fetches the first file in the fileset and provides it to the agent along with your instructions.
-2. The agent performs the instructions and automatically calls the `context-dropper.next` tool.
-3. **Context Pruning**: When the tool is called, the file is tagged as processed. The plugin drops the previous file's context from the chat history (saving tokens), and feeds the next file to the agent.
+1. It automatically fetches the first file in the fileset and provides it to the
+   agent along with your instructions.
+2. The agent performs the instructions and automatically calls the
+   `context-dropper.next` tool.
+3. **Context Pruning**: When the tool is called, the file is tagged as
+   processed. The plugin drops the previous file's context from the chat history
+   (saving tokens), and feeds the next file to the agent.
 4. This loop continues until all files are processed.
 
 To forcefully stop the loop before it finishes, type **"stop context-dropper"**.
 
-## Development & Debugging
+## Logging
 
-To develop the plugin further, modify files under `src/`.
+Plugin activity is written to OpenCode's native log system via the
+`context-dropper` service. To view logs, run OpenCode with debug-level output
+enabled:
 
 ```bash
-bun install
-# rebuild the bundle after changes
-bun run build
+opencode --log-level debug
 ```
 
-### Debugging Logs
-
-The plugin writes activity and execution state to a dedicated log file located at:
-
-```bash
-~/.opencode/context-dropper.log
-```
-
-You can monitor these logs in real-time by running the following command in your terminal:
-
-```bash
-tail -f ~/.opencode/context-dropper.log
-```
+Unexpected errors are logged at `error` level and are visible at any log level.
+Operational events (dropper lifecycle, context pruning) are logged at `info`
+level.

package/dist/index.js

@@ -12333,14 +12333,10 @@ function tool(input) {
   return input;
 }
 tool.schema = exports_external;
-// src/index.ts
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path4 from "node:path";
 // ../package.json
 var package_default = {
   name: "context-dropper",
-  version: "0.1.4",
+  version: "0.1.6",
   description: "CLI for iterating through a fixed list of files, tracking position, and tagging progress within an AI agent's session.",
   author: {
     name: "Fardjad Davari",
@@ -12376,10 +12372,30 @@ var package_default = {
 // ../src/version/version.ts
 var getPackageVersion = () => package_default.version;
 
+// src/logger.ts
+function createLogger(service, client) {
+  return (msg, extra, level = "info") => {
+    client.app.log({
+      body: {
+        service,
+        level,
+        message: msg,
+        ...extra !== undefined ? { extra } : {}
+      }
+    }).catch((e) => {
+      console.error(`[${service}] Failed to send log: ${e}`);
+    });
+  };
+}
+
 // src/session.ts
 class SessionManager {
   sessionStates = new Map;
   sessionPruneMap = new Map;
+  log;
+  constructor(log) {
+    this.log = log;
+  }
   setSession(sessionId, state) {
     this.sessionStates.set(sessionId, state);
   }
@@ -12387,10 +12403,12 @@ class SessionManager {
     return this.sessionStates.get(sessionId);
   }
   deleteSession(sessionId) {
+    this.log(`Deleting session ${sessionId}`);
     this.sessionStates.delete(sessionId);
     this.sessionPruneMap.delete(sessionId);
   }
   setPruneMessageId(sessionId, messageId) {
+    this.log(`Prune anchor set`, { sessionId, messageId });
     this.sessionPruneMap.set(sessionId, messageId);
   }
   getPruneMessageId(sessionId) {
@@ -12903,12 +12921,15 @@ class Toolkit {
   dropperService;
   filesetService;
   dataDir;
-  constructor(cwd, dropperService, filesetService) {
+  log;
+  constructor(cwd, log, dropperService, filesetService) {
+    this.log = log;
     this.dropperService = dropperService ?? new DefaultDropperService;
     this.filesetService = filesetService ?? new DefaultFilesetService;
     this.dataDir = path3.resolve(cwd, ".context-dropper");
   }
   async createDropper(filesetName, dropperName) {
+    this.log(`Creating dropper`, { dropperName, filesetName });
     await this.dropperService.create({
       dataDir: this.dataDir,
       filesetName,
@@ -12916,6 +12937,7 @@ class Toolkit {
     });
   }
   async removeDropper(dropperName) {
+    this.log(`Removing dropper`, { dropperName });
     try {
       await this.dropperService.remove({
         dataDir: this.dataDir,
@@ -12929,6 +12951,7 @@ class Toolkit {
     }
   }
   async tagProcessed(dropperName) {
+    this.log(`Tagging current file as 'processed'`, { dropperName });
     await this.dropperService.tag({
       dataDir: this.dataDir,
       dropperName,
@@ -12936,6 +12959,7 @@ class Toolkit {
     });
   }
   async isDone(dropperName) {
+    this.log(`Checking if done`, { dropperName });
     try {
       await this.dropperService.isDone({
         dataDir: this.dataDir,
@@ -12947,6 +12971,7 @@ class Toolkit {
     }
   }
   async nextFile(dropperName) {
+    this.log(`Advancing to next file`, { dropperName });
     await this.dropperService.next({
       dataDir: this.dataDir,
       dropperName
@@ -12984,40 +13009,11 @@ ${fileContent}
 }
 
 // src/index.ts
-var opencodeDir = path4.join(os.homedir(), ".opencode");
-if (!fs.existsSync(opencodeDir)) {
-  fs.mkdirSync(opencodeDir, { recursive: true });
-}
-var logFile = path4.join(opencodeDir, "context-dropper.log");
-var MAX_LOG_SIZE_BYTES = 10 * 1024 * 1024;
-var log = (msg, ...args) => {
-  const timestamp = new Date().toISOString();
-  const formattedArgs = args.length > 0 ? " " + args.map((a) => typeof a === "object" ? JSON.stringify(a) : a).join(" ") : "";
-  const logMessage = `[${timestamp}] [ContextDropper] ${msg}${formattedArgs}
-`;
-  console.error(`[ContextDropper] ${msg}`, ...args);
-  try {
-    if (fs.existsSync(logFile)) {
-      const stats = fs.statSync(logFile);
-      if (stats.size >= MAX_LOG_SIZE_BYTES) {
-        const content = fs.readFileSync(logFile, "utf-8");
-        const keepLength = Math.floor(content.length / 2);
-        const rotatedContent = content.slice(-keepLength);
-        const firstNewlineIndex = rotatedContent.indexOf(`
-`);
-        const cleanContent = firstNewlineIndex !== -1 ? rotatedContent.slice(firstNewlineIndex + 1) : rotatedContent;
-        fs.writeFileSync(logFile, cleanContent);
-      }
-    }
-    fs.appendFileSync(logFile, logMessage);
-  } catch (e) {
-    console.error("Failed to write/rotate plugin log file", e);
-  }
-};
-var sessionManager = new SessionManager;
-var toolkit = new Toolkit(process.cwd());
 var ContextDropperPlugin = async (ctx) => {
   const version2 = getPackageVersion();
+  const log = createLogger("context-dropper", ctx.client);
+  const toolkit = new Toolkit(ctx.worktree, log);
+  const sessionManager = new SessionManager(log);
   log(`Plugin initializing! Version: ${version2}`);
   setTimeout(() => {
     ctx.client.tui.showToast({
@@ -13027,8 +13023,8 @@ var ContextDropperPlugin = async (ctx) => {
         variant: "success",
         duration: 5000
       }
-    }).catch((e) => log("Failed to show toast", e));
-    log("Initialization toast sent");
+    }).catch((e) => log("Failed to show toast", { error: String(e) }, "warn"));
+    log("Initialization complete", { worktree: ctx.worktree, version: version2 });
   }, 1000);
   return {
     tool: {
@@ -13045,13 +13041,11 @@ var ContextDropperPlugin = async (ctx) => {
             instructions: args.instructions
           });
           try {
-            log(`Removing existing dropper ${dropperName}`);
             await toolkit.removeDropper(dropperName);
-            log(`Creating dropper ${dropperName} from fileset ${args.filesetName}`);
             await toolkit.createDropper(args.filesetName, dropperName);
             return await toolkit.getFilePrompt(dropperName, args.instructions, false);
           } catch (error45) {
-            log(`Error in tool execution: ${error45.message}`);
+            log(`Error in tool execution`, { error: error45.message }, "error");
             return `Error initializing context-dropper: ${error45.message}`;
           }
         }
@@ -13066,22 +13060,19 @@ var ContextDropperPlugin = async (ctx) => {
             return "No active context-dropper session found. Please initialize one first.";
           }
           try {
-            log(`Tagging ${state.dropperName} current file as 'processed'`);
             await toolkit.tagProcessed(state.dropperName);
-            log(`Checking if ${state.dropperName} is done`);
             const isDone = await toolkit.isDone(state.dropperName);
             if (isDone) {
-              log(`Session ${state.dropperName} completed.`);
+              log(`Session completed`, { dropperName: state.dropperName });
               sessionManager.deleteSession(sessionId);
               return `[Context-Dropper: All files have been processed. Task complete.]`;
             }
-            log(`Advancing to next file in ${state.dropperName}`);
             await toolkit.nextFile(state.dropperName);
             const prompt = await toolkit.getFilePrompt(state.dropperName, state.instructions, true);
             sessionManager.setPruneMessageId(sessionId, context.messageID);
             return prompt;
           } catch (error45) {
-            log(`Error during 'next' processing: ${error45.message}`);
+            log(`Error during 'next' processing`, { error: error45.message }, "error");
             return `[Context-Dropper Error: ${error45.message}]`;
           }
         }
@@ -13092,7 +13083,10 @@ var ContextDropperPlugin = async (ctx) => {
       for (const part of output.parts) {
         if (part.type === "text") {
           const text = part.text.trim().toLowerCase();
-          log(`Processing message chunk in session ${sessionId}. Starts with /drop? ${text.startsWith("/drop")}`);
+          log(`Processing message chunk`, {
+            sessionId,
+            startsWithDrop: text.startsWith("/drop")
+          });
           if (text.startsWith("/drop ")) {
             const originalText = part.text.trim();
             const match = originalText.match(/^\/drop\s+([^\s]+)\s+(.+)$/is);
@@ -13105,9 +13099,7 @@ var ContextDropperPlugin = async (ctx) => {
                 instructions
               });
               try {
-                log(`Removing existing dropper ${dropperName}`);
                 await toolkit.removeDropper(dropperName);
-                log(`Creating dropper ${dropperName} from fileset ${filesetName}`);
                 await toolkit.createDropper(filesetName, dropperName);
                 const prompt = await toolkit.getFilePrompt(dropperName, instructions, false);
                 part.text = prompt;
@@ -13115,7 +13107,9 @@ var ContextDropperPlugin = async (ctx) => {
                   sessionManager.setPruneMessageId(sessionId, output.message.id);
                 }
               } catch (error45) {
-                log(`Error starting context-dropper via /drop: ${error45.message}`);
+                log(`Error starting context-dropper via /drop`, {
+                  error: error45.message
+                }, "error");
                 part.text = `Error starting context-dropper: ${error45.message}`;
               }
             } else {
@@ -13144,9 +13138,16 @@ var ContextDropperPlugin = async (ctx) => {
         return;
       const pruneStartId = sessionManager.getPruneMessageId(sessionId);
       if (pruneStartId) {
+        const totalBefore = output.messages.length;
         const index = output.messages.findIndex((m) => m.info && m.info.id === pruneStartId);
         if (index !== -1) {
           output.messages.splice(0, index);
+          log(`Context pruned`, {
+            sessionId,
+            removed: index,
+            totalBefore,
+            remaining: output.messages.length
+          });
         }
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-context-dropper-plugin",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "A Context Dropper plugin for OpenCode that automates file iteration context management.",
   "author": {
     "name": "Fardjad Davari",