opencode-context-persistence 0.0.0-stage → 0.1.5

package/.github/workflows/publish.yml

@@ -0,0 +1,22 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+      - run: npm install
+      - run: npm publish --provenance --access public

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alfonso de la Guarda Reyes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# opencode-context-persistence
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+OpenCode plugin that re-injects `AGENTS.md` context
+after compaction to prevent context loss.
+
+## Problem
+
+Long OpenCode sessions compact older conversation into a summary. When this
+happens, project rules in `AGENTS.md` can be dropped, causing the agent to
+forget mandates (issues-first, conventional commits, no hardcoded values, etc.).
+
+## Solution
+
+This plugin hooks into `experimental.session.compacting` and injects the
+contents of `AGENTS.md` into the compaction context, ensuring the rules
+survive compaction.
+
+## Installation
+
+### From npm (when published)
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-context-persistence"]
+}
+```
+
+### From local files
+
+Copy `src/index.ts` to `.opencode/plugins/context-persistence.ts` in your
+project, or to `~/.config/opencode/plugins/context-persistence.ts` for global
+use.
+
+## Usage
+
+Place an `AGENTS.md` at your project root. The plugin reads it automatically
+and re-injects it after every compaction.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "opencode-context-persistence",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.5",
+  "description": "OpenCode plugin that re-injects AGENTS.md context after compaction to prevent context loss.",
+  "type": "module",
+  "main": "src/index.ts",
+  "scripts": {
+    "build": "bun build src/index.ts --target bun --outfile dist/index.js",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.19.0"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "context",
+    "compaction",
+    "agents-md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alfonsodg/opencode-context-persistence.git"
+  },
+  "author": "Alfonso de la Guarda Reyes <alfonsodg@gmail.com>"
+}

package/src/index.ts

@@ -0,0 +1,35 @@
+import type { Plugin } from "@opencode-ai/plugin"
+import { readFileSync, existsSync } from "node:fs"
+import { join } from "node:path"
+
+export const ContextPersistence: Plugin = async ({ directory, worktree }) => {
+  const agentsPath = join(worktree || directory, "AGENTS.md")
+
+  const readAgents = (): string => {
+    try {
+      if (existsSync(agentsPath)) {
+        return readFileSync(agentsPath, "utf-8")
+      }
+    } catch {
+      // ignore read errors
+    }
+    return ""
+  }
+
+  return {
+    "experimental.session.compacting": async (_input, output) => {
+      const agents = readAgents()
+      if (agents) {
+        output.context.push(`
+## Re-injected AGENTS.md (context persistence)
+The following rules were re-injected after compaction to prevent context loss.
+Follow them without exception:
+
+${agents}
+`)
+      }
+    },
+  }
+}
+
+export default ContextPersistence

package/tests/index.test.ts

@@ -0,0 +1,8 @@
+import { describe, test, expect } from "bun:test"
+
+describe("ContextPersistence plugin", () => {
+  test("module exports a default function", async () => {
+    const mod = await import("../src/index.ts")
+    expect(typeof mod.default).toBe("function")
+  })
+})