opencodekit 0.21.2 → 0.21.3

package/dist/template/.opencode/plugin/README.md

@@ -9,6 +9,8 @@ plugin/
 ├── memory.ts           # 4-tier automated memory system (capture → distill → curate → inject)
 ├── sessions.ts         # Session search tools (find/read)
 ├── copilot-auth.ts     # GitHub Copilot provider/auth integration
+├── prompt-leverage.ts  # Prompt pre-processing with structured execution framing
+├── rtk.ts              # Optional RTK command-output compression hook
 ├── skill-mcp.ts        # Skill-scoped MCP bridge (skill_mcp tools)
 └── lib/
     ├── memory-tools.ts       # 6 core memory tools (observation, search, get, read, update, timeline)
@@ -58,6 +60,15 @@ plugin/
   - Handles GitHub Copilot OAuth/device flow
   - Adds model/provider request shaping for compatible reasoning behavior
 
+- `prompt-leverage.ts`
+  - Upgrades user prompts with objective, context, tool rules, verification, and done criteria
+  - Runs through `experimental.chat.messages.transform`
+
+- `rtk.ts`
+  - Optional OpenCode hook for RTK command-output compression
+  - Rewrites low-risk `bash`/`shell` commands through `rtk rewrite`
+  - Keeps an idempotency guard for symlinked global/project config double-loading
+
 ## Notes
 
 - OpenCode auto-discovers every `.ts` file in `plugin/` as a plugin — keep helper modules in `lib/`

package/dist/template/.opencode/plugin/rtk.ts

@@ -0,0 +1,43 @@
+import type { Plugin } from "@opencode-ai/plugin";
+
+// RTK OpenCode plugin — rewrites commands to use rtk for token savings.
+// Requires: rtk >= 0.23.0 in PATH.
+//
+// This is a thin delegating plugin: all rewrite logic lives in `rtk rewrite`,
+// which is the single source of truth (src/discover/registry.rs).
+// To add or change rewrite rules, edit the Rust registry — not this file.
+
+export const RtkOpenCodePlugin: Plugin = async ({ $ }) => {
+	try {
+		await $`which rtk`.quiet();
+	} catch {
+		console.warn("[rtk] rtk binary not found in PATH — plugin disabled");
+		return {};
+	}
+
+	return {
+		"tool.execute.before": async (input, output) => {
+			const tool = String(input?.tool ?? "").toLowerCase();
+			if (tool !== "bash" && tool !== "shell") return;
+			const args = output?.args;
+			if (!args || typeof args !== "object") return;
+
+			const command = (args as Record<string, unknown>).command;
+			if (typeof command !== "string" || !command) return;
+			// This config is symlinked as both global and project OpenCode config.
+			// OpenCode may load this plugin twice in that layout, so avoid rewriting
+			// commands that have already been routed through rtk.
+			if (/^\s*(?:RTK_[A-Z_]+=\S+\s+)*rtk\b/.test(command)) return;
+
+			try {
+				const result = await $`rtk rewrite ${command}`.quiet().nothrow();
+				const rewritten = String(result.stdout).trim();
+				if (rewritten && rewritten !== command) {
+					(args as Record<string, unknown>).command = rewritten;
+				}
+			} catch {
+				// rtk rewrite failed — pass through unchanged
+			}
+		},
+	};
+};

package/dist/template/.opencode/skill/rtk-command-compression/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: rtk-command-compression
+description: Use when installing, enabling, testing, or operating RTK command-output compression in OpenCode — keeps RTK opt-in, verifies the correct binary/plugin, protects raw verification evidence, and maintains safe hook exclusions.
+version: 1.0.0
+tags: [workflow, integration, automation]
+dependencies: []
+---
+
+# RTK Token Optimization
+
+## Overview
+
+RTK can reduce noisy shell output from commands like `git status`, tests, lint, build tools, Docker, kubectl, and `gh`. Treat it as an **opt-in shell-output compressor**, not a replacement for OpenCode's native read/search/edit tools.
+
+Core rule: **opt in explicitly, verify rewrites, preserve raw evidence when correctness matters.**
+
+## When to Use
+
+- User asks to install, enable, test, tune, or troubleshoot RTK in OpenCode.
+- Bash output is consuming too much context from shell-heavy workflows.
+- You need to document or validate RTK wiring in a project where `~/.config/opencode` may be symlinked to `.opencode`.
+
+## When NOT to Use
+
+- Code inspection or editing: prefer `tilth_tilth_read`, `tilth_tilth_search`, LSP, Read, Grep, and Edit.
+- Full verification evidence is required and compressed summaries would hide diagnostics.
+- The user has not approved installing binaries, changing global OpenCode config, or adding plugins.
+
+## Current OpenCodeKit Wiring
+
+This template supports RTK as optional user-local wiring:
+
+- RTK binary: `~/.local/bin/rtk` after opt-in install.
+- Active OpenCode plugin path in this symlinked setup: `.opencode/plugin/rtk.ts`.
+- RTK config path on macOS: `~/Library/Application Support/rtk/config.toml`.
+- Keep telemetry disabled unless the user explicitly opts in.
+- Keep tee mode on `failures` so raw output can be recovered when commands fail.
+
+If `~/.config/opencode` is symlinked to this repo's `.opencode`, OpenCode may resolve the same plugin as both global and project config. The RTK plugin must be idempotent: skip commands already starting with `rtk`.
+
+## Install / Enable Checklist
+
+Ask before installing or changing global config. Then run:
+
+```bash
+command -v rtk || RTK_INSTALL_DIR="$HOME/.local/bin" sh /tmp/rtk-research/install.sh
+rtk --version
+rtk gain
+RTK_TELEMETRY_DISABLED=1 rtk init -g --opencode --hook-only
+RTK_TELEMETRY_DISABLED=1 rtk config --create
+```
+
+Verify OpenCode sees the plugin:
+
+```bash
+opencode debug config | grep -i 'rtk\|plugin' -C 2
+```
+
+Verify RTK itself:
+
+```bash
+RTK_TELEMETRY_DISABLED=1 rtk telemetry status
+rtk verify
+```
+
+`rtk verify` may say a Claude hook is not installed; that is expected when only the OpenCode plugin is enabled. The important checks are the OpenCode plugin path, telemetry status, and RTK test count.
+
+## Required Safety Settings
+
+In `~/Library/Application Support/rtk/config.toml`, keep exclusions for commands that need raw output or are known unsafe under RTK rewrite:
+
+```toml
+[hooks]
+exclude_commands = ["curl", "wget", "playwright", "find", "npx oxlint", "git push", "git rebase", "git cherry-pick"]
+
+[telemetry]
+enabled = false
+
+[tee]
+enabled = true
+mode = "failures"
+```
+
+Rationale:
+
+| Exclusion                                   | Why                                                                            |
+| ------------------------------------------- | ------------------------------------------------------------------------------ |
+| `curl`, `wget`                              | Preserve raw HTTP output and avoid hiding API/debug evidence.                  |
+| `playwright`                                | Browser automation logs/screenshots need full fidelity.                        |
+| `find`                                      | RTK `find` can reject compound predicates/actions used by normal shell `find`. |
+| `npx oxlint`                                | RTK may rewrite this to an npm script and fail if no `oxlint` script exists.   |
+| `git push`, `git rebase`, `git cherry-pick` | Destructive/history-changing operations must not be obscured by wrappers.      |
+
+Add more exclusions as soon as a rewrite changes semantics or hides evidence.
+
+## Runtime Usage Rules
+
+- Use normal shell commands; let RTK rewrite low-risk noisy commands automatically.
+- Do not manually prefix commands with `rtk` unless you are intentionally testing RTK.
+- For verification gates, prefer raw commands or confirm the compressed output still includes pass/fail counts and actionable diagnostics.
+- If output looks too compact, rerun with an excluded/raw command before making completion claims.
+- Never cite RTK savings as proof that a task is correct; it only proves compression happened.
+
+## Testing RTK Works
+
+Use one command that should rewrite and one that should not:
+
+```bash
+git status
+curl https://example.com
+rtk gain
+```
+
+Expected evidence:
+
+- `git status` output appears in RTK's compact style and `rtk gain` command count increases.
+- `curl` shows raw curl progress/body because it is excluded.
+- `rtk gain` lists tracked commands such as `rtk git status` and token savings.
+
+## Troubleshooting
+
+| Symptom                          | Check                                           | Fix                                                                     |
+| -------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------- |
+| No rewrites                      | `opencode debug config`                         | Restart OpenCode and confirm `.opencode/plugin/rtk.ts` is loaded.       |
+| Recursive `rtk rtk ...` behavior | Inspect `.opencode/plugin/rtk.ts`               | Add/restore idempotency guard for commands already starting with `rtk`. |
+| Command semantics changed        | `rtk rewrite '<command>'`                       | Add the command prefix to `[hooks].exclude_commands`.                   |
+| Need raw failed output           | Check RTK tee files/config                      | Keep `[tee] mode = "failures"`; rerun raw if needed.                    |
+| Telemetry concern                | `RTK_TELEMETRY_DISABLED=1 rtk telemetry status` | Keep telemetry disabled unless user opts in.                            |
+
+## Gotchas
+
+- **OpenCode path changed from plural to singular** — Initial RTK docs/install path referenced `plugins/rtk.ts`, but active OpenCodeKit loading after restart used `.opencode/plugin/rtk.ts`. Document and inspect the active path, not just installer output.
+- **Symlinked global/project config can double-load plugin paths** — When `~/.config/opencode` points at this repo's `.opencode`, OpenCode can resolve global and project plugin URLs. The plugin must skip commands already starting with `rtk`.
+- **Unsafe rewrites were observed** — `find` compound predicates and `npx oxlint` were rewritten incorrectly during testing. Keep them excluded unless RTK behavior changes and is re-verified.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.21.2",
+	"version": "0.21.3",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": [
 		"agents",

package/dist/template/.opencode/package.json

@@ -1,21 +0,0 @@
-{
-	"name": "opencode",
-	"version": "1.0.0",
-	"description": "Opencode plugin",
-	"keywords": [],
-	"license": "ISC",
-	"author": "",
-	"type": "module",
-	"main": "index.js",
-	"scripts": {
-		"type-check": "tsc --noEmit"
-	},
-	"dependencies": {
-		"@opencode-ai/plugin": "1.4.9"
-	},
-	"devDependencies": {
-		"@types/node": "^25.3.0",
-		"bun-types": "^1.3.9",
-		"typescript": "^5.9.3"
-	}
-}

package/dist/template/.opencode/plugin/package.json

@@ -1,7 +0,0 @@
-{
-  "name": "opencode-plugins",
-  "type": "module",
-  "dependencies": {
-    "@opencode-ai/plugin": "^1.1.13"
-  }
-}