chore: release v0.2.4

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.2.4
+
+- Normalize npm package repository metadata.
+
+## 0.2.3
+
+- Always ask the model to report whether custom compaction instructions were applied.
+
+## 0.2.2
+
+- Add explicit markers for applied and skipped custom compaction instructions.
+
+## 0.2.1
+
+- Add the server entrypoint expected by OpenCode's npm plugin loader.
+
 ## 0.1.2
 
 - Skip compaction prompt changes when no prompt or memory file is provided.

README.md

@@ -1,16 +1,22 @@
 # opencode-plugin-compaction-prompt
 
-Customize OpenCode's compaction prompt to guide which context carries forward, which details are omitted, and what the next session should retain.
+**Compact fearlessly with priority-aware compaction.**
+
+When you work across multiple features, OpenCode's default compaction doesn't know how to distinguish active work from older discussions, so it gives them equal priority. This can make important current details easy to lose.
+
+Customize OpenCode's compaction prompt for priority-aware compaction, deciding which messages are prioritized or discarded in the next session. Specify which discussions to discard and which decisions, files, and snippets to prioritize in the summary.
 
 [GitHub](https://github.com/bendtherules/opencode-plugin-compaction-prompt) · [npm](https://www.npmjs.com/package/opencode-plugin-compaction-prompt)
 
 ## Install
 
 ```bash
-opencode plugin opencode-plugin-compaction-prompt
+opencode plugin -g opencode-plugin-compaction-prompt
 ```
 
-Or add it to `opencode.json` manually:
+This installs the plugin in your global OpenCode configuration. To install it for one project only, omit `-g`.
+
+You can also add it manually to your global `opencode.jsonc`:
 
 ```json
 {
@@ -21,7 +27,7 @@ Or add it to `opencode.json` manually:
       {
         "memoryFile": ".opencode/compaction.md",
         "mode": "append",
-        "completionMarker": "Custom compaction request honored."
+        "completionMarker": "opencode-plugin-compaction-prompt: Custom compaction done."
       }
     ]
   ]
@@ -32,15 +38,17 @@ Create `.opencode/compaction.md` in the project when you have project-specific c
 
 ## Options
 
-| Option             | Default                              | Description                                                                                                |
-| ------------------ | ------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
-| `memoryFile`       | `.opencode/compaction.md`            | File resolved relative to the active worktree.                                                             |
-| `mode`             | `append`                             | Append instructions to OpenCode's default prompt, or use `replace` to provide a complete prompt.           |
-| `prompt`           | "" (empty)                           | Additional instructions used together with `memoryFile`; both are included in the compaction instructions. |
-| `completionMarker` | `Custom compaction request honored.` | Exact text the model is asked to append at the end of the summary.                                         |
+| Option             | Default                                                      | Description                                                                                                |
+| ------------------ | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
+| `memoryFile`       | `.opencode/compaction.md`                                    | File resolved relative to the active worktree.                                                             |
+| `mode`             | `append`                                                     | Append instructions to OpenCode's default prompt, or use `replace` to provide a complete prompt.           |
+| `prompt`           | "" (empty)                                                   | Additional instructions used together with `memoryFile`; both are included in the compaction instructions. |
+| `completionMarker` | `opencode-plugin-compaction-prompt: Custom compaction done.` | Exact text the model is asked to append at the end of the summary.                                         |
 
 Append mode is the recommended default because it preserves OpenCode's built-in compaction behavior. Replace mode is available when the complete prompt needs to be controlled by this plugin.
 
+When neither a prompt nor a memory file is available, the plugin asks the model to echo `opencode-plugin-compaction-prompt: No custom compaction applied.` instead.
+
 ## Development
 
 ```bash
@@ -55,7 +63,11 @@ The npm package exposes the compiled entrypoint at `dist/index.js` and TypeScrip
 
 ## Publishing
 
-Before publishing a release:
+### Update the changelog
+
+Add the changes for the new version to `CHANGELOG.md`.
+
+### Verify the release
 
 ```bash
 bun run format:check
@@ -63,14 +75,19 @@ bun test
 bun run typecheck
 bun run build
 bun run pack:check
+```
+
+### Publish the release
+
+```bash
+npm version minor -m "chore: release v%s"
+git push origin main --follow-tags
 VERSION="$(node -p "require('./package.json').version")"
-git tag "v$VERSION"
-git push origin "v$VERSION"
 gh release create "v$VERSION" --generate-notes
 npm publish
 ```
 
-Update the version in `package.json`, changelog, and the tag before each release. `npm publish` rebuilds `dist/` automatically.
+Use `npm version patch` or `npm version major` when appropriate. `npm publish` rebuilds `dist/` automatically.
 
 ## Compatibility
 

examples/opencode.json

@@ -7,7 +7,7 @@
         "memoryFile": ".opencode/compaction.md",
         "mode": "append",
         "prompt": "<Example prompt for compaction>",
-        "completionMarker": "Custom compaction request honored."
+        "completionMarker": "opencode-plugin-compaction-prompt: Custom compaction done."
       }
     ]
   ]

package.json

@@ -1,11 +1,13 @@
 {
   "name": "opencode-plugin-compaction-prompt",
-  "version": "0.1.2",
+  "version": "0.2.4",
   "description": "Customize OpenCode's compaction prompt to preserve important context and omit unnecessary details.",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "https://github.com/bendtherules/opencode-plugin-compaction-prompt.git"
+    "url": "git+https://github.com/bendtherules/opencode-plugin-compaction-prompt.git"
   },
   "homepage": "https://github.com/bendtherules/opencode-plugin-compaction-prompt#readme",
   "bugs": {
@@ -15,6 +17,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [

src/index.ts

@@ -13,7 +13,10 @@ export type CompactionOptions = PluginOptions & {
 
 const defaultMemoryFile = ".opencode/compaction.md";
 const defaultPrompt = "";
-const defaultCompletionMarker = "Custom compaction request honored.";
+const defaultCompletionMarker =
+  "opencode-plugin-compaction-prompt: Custom compaction done.";
+const skippedCompactionMarker =
+  "opencode-plugin-compaction-prompt: No custom compaction applied.";
 
 function asString(value: unknown): string | undefined {
   if (typeof value !== "string") {
@@ -28,11 +31,7 @@ function buildInstructions(
   prompt: string,
   completionMarker: string,
   memory: string,
-): string | undefined {
-  if (!prompt && !memory) {
-    return undefined;
-  }
-
+): string {
   const sections = [
     "## User Compaction Instructions",
     `These instructions take precedence over previous instructions if there is conflict. At the very end of the summary, echo exactly: **${completionMarker}**`,
@@ -112,11 +111,9 @@ export const CompactionPromptPlugin: Plugin = async (
       output,
     ): Promise<void> => {
       const memory = await readMemory(memoryPath, logError);
-      const instructions = buildInstructions(prompt, completionMarker, memory);
-
-      if (!instructions) {
-        return;
-      }
+      const marker =
+        prompt || memory ? completionMarker : skippedCompactionMarker;
+      const instructions = buildInstructions(prompt, marker, memory);
 
       if (mode === "replace") {
         output.prompt = instructions;

test/index.test.ts

@@ -55,7 +55,9 @@ describe("CompactionPromptPlugin", () => {
     );
 
     expect(output.context[0]).toContain("Keep the active hypothesis.");
-    expect(output.context[0]).toContain("Custom compaction request honored.");
+    expect(output.context[0]).toContain(
+      "opencode-plugin-compaction-prompt: Custom compaction done.",
+    );
   });
 
   test("combines custom instructions with a configured memory file", async () => {
@@ -114,10 +116,12 @@ describe("CompactionPromptPlugin", () => {
     );
 
     expect(context.logs).toHaveLength(0);
-    expect(output.context).toHaveLength(0);
+    expect(output.context[0]).toContain(
+      "echo exactly: **opencode-plugin-compaction-prompt: No custom compaction applied.**",
+    );
   });
 
-  test("does not modify compaction when no instructions are provided", async () => {
+  test("adds a skipped marker when no instructions are provided", async () => {
     const context = await createContext();
     const hooks = await CompactionPromptPlugin(context as never);
     const output: { context: string[]; prompt?: string } = {
@@ -129,7 +133,10 @@ describe("CompactionPromptPlugin", () => {
       output,
     );
 
-    expect(output.context).toEqual(["Existing context"]);
+    expect(output.context[0]).toBe("Existing context");
+    expect(output.context[1]).toContain(
+      "echo exactly: **opencode-plugin-compaction-prompt: No custom compaction applied.**",
+    );
     expect(output.prompt).toBeUndefined();
   });
 
@@ -147,6 +154,8 @@ describe("CompactionPromptPlugin", () => {
     );
 
     expect(context.logs).toHaveLength(1);
-    expect(output.context).toHaveLength(0);
+    expect(output.context[0]).toContain(
+      "echo exactly: **opencode-plugin-compaction-prompt: No custom compaction applied.**",
+    );
   });
 });