opencodekit 0.6.3 → 0.6.5

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.6.3",
+  version: "0.6.5",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {

package/dist/template/.opencode/command/handoff.md

@@ -136,11 +136,11 @@ Branch: [branch]
 
 Saved: .beads/artifacts/<bead-id>/handoffs/<timestamp>.md
 
-Resume: /resume <bead-id>
+━━━━━━━━━━━━━━━━━━━━━━━━
+🔄 Press Ctrl+K to compact session with handoff context
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+The handoff plugin will automatically inject this context into the new session.
 
-Next session will auto-load:
-- This handoff
-- Previous session context (read_session)
-- Git state
-- Bead artifacts
+Alternatively, resume manually: /resume <bead-id>
 ```

package/dist/template/.opencode/lib/lsp/config.ts

@@ -1,8 +1,71 @@
-import { existsSync } from "node:fs";
-import { extname } from "node:path";
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { extname, join } from "node:path";
 import { BUILTIN_SERVERS, EXT_TO_LANG } from "./constants";
 import type { LSPServerConfig } from "./types";
 
+/**
+ * Known paths where OpenCode installs bundled LSP servers
+ * These are checked when the command isn't found in PATH
+ */
+function getOpenCodeDataDir(): string {
+	const home = homedir();
+	switch (process.platform) {
+		case "darwin":
+			return join(home, ".local/share/opencode");
+		case "win32":
+			return join(
+				process.env.APPDATA ?? join(home, "AppData/Roaming"),
+				"opencode",
+			);
+		default: // linux
+			return join(
+				process.env.XDG_DATA_HOME ?? join(home, ".local/share"),
+				"opencode",
+			);
+	}
+}
+
+/**
+ * Find OpenCode's bundled jdtls launcher jar
+ */
+function findOpenCodeJdtls(): string[] | null {
+	const jdtlsDir = join(getOpenCodeDataDir(), "bin/jdtls");
+	const pluginsDir = join(jdtlsDir, "plugins");
+
+	if (!existsSync(pluginsDir)) return null;
+
+	try {
+		const files = readdirSync(pluginsDir);
+		const launcherJar = files.find(
+			(f) =>
+				f.startsWith("org.eclipse.equinox.launcher_") && f.endsWith(".jar"),
+		);
+		if (!launcherJar) return null;
+
+		const configDir = join(
+			jdtlsDir,
+			process.platform === "darwin"
+				? "config_mac"
+				: process.platform === "win32"
+					? "config_win"
+					: "config_linux",
+		);
+
+		if (!existsSync(configDir)) return null;
+
+		return [
+			"java",
+			"-jar",
+			join(pluginsDir, launcherJar),
+			"-configuration",
+			configDir,
+		];
+	} catch {
+		return null;
+	}
+}
+
 export interface ResolvedServer extends LSPServerConfig {
 	id: string;
 }
@@ -58,6 +121,18 @@ export function resolveServer(filePath: string): ResolvedServer | null {
 		}
 	}
 
+	// Special case: Try OpenCode's bundled jdtls for Java files
+	if (ext === ".java") {
+		const jdtlsCommand = findOpenCodeJdtls();
+		if (jdtlsCommand && commandExists("java")) {
+			return {
+				id: "jdtls",
+				command: jdtlsCommand,
+				extensions: [".java"],
+			};
+		}
+	}
+
 	return null;
 }
 
@@ -87,10 +162,17 @@ export function listAvailableServers(): Array<{
 	for (const [id, config] of Object.entries(BUILTIN_SERVERS)) {
 		if (configuredIds.has(id)) continue;
 		const [cmd] = config.command;
+
+		// Special case: jdtls can use OpenCode's bundled version
+		let available = !!cmd && commandExists(cmd);
+		if (!available && id === "jdtls") {
+			available = !!(findOpenCodeJdtls() && commandExists("java"));
+		}
+
 		results.push({
 			id,
 			extensions: config.extensions,
-			available: !!cmd && commandExists(cmd),
+			available,
 		});
 	}
 

package/dist/template/.opencode/lib/lsp/constants.ts

@@ -40,20 +40,45 @@ export const DEFAULT_MAX_REFERENCES = 200;
 export const DEFAULT_MAX_SYMBOLS = 200;
 export const DEFAULT_MAX_DIAGNOSTICS = 200;
 
-// Synced with OpenCode's server.ts
+/**
+ * Built-in LSP servers synced with OpenCode's LSP configuration
+ * @see https://opencode.ai/docs/lsp/
+ *
+ * Servers are matched in order - first match wins.
+ * Some servers (jdtls, pyright, etc.) may use OpenCode's bundled installation.
+ */
 export const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, "id">> = {
+	// TypeScript/JavaScript
 	typescript: {
 		command: ["typescript-language-server", "--stdio"],
 		extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts"],
 	},
+	deno: {
+		command: ["deno", "lsp"],
+		extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs"],
+	},
+
+	// Frontend frameworks
 	vue: {
 		command: ["vue-language-server", "--stdio"],
 		extensions: [".vue"],
 	},
+	svelte: {
+		command: ["svelteserver", "--stdio"],
+		extensions: [".svelte"],
+	},
+	astro: {
+		command: ["astro-ls", "--stdio"],
+		extensions: [".astro"],
+	},
+
+	// Go
 	gopls: {
 		command: ["gopls"],
 		extensions: [".go"],
 	},
+
+	// Python
 	basedpyright: {
 		command: ["basedpyright-langserver", "--stdio"],
 		extensions: [".py", ".pyi"],
@@ -62,10 +87,14 @@ export const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, "id">> = {
 		command: ["pyright-langserver", "--stdio"],
 		extensions: [".py", ".pyi"],
 	},
+
+	// Rust
 	rust: {
 		command: ["rust-analyzer"],
 		extensions: [".rs"],
 	},
+
+	// C/C++
 	clangd: {
 		command: ["clangd", "--background-index", "--clang-tidy"],
 		extensions: [
@@ -81,26 +110,117 @@ export const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, "id">> = {
 			".h++",
 		],
 	},
-	svelte: {
-		command: ["svelteserver", "--stdio"],
-		extensions: [".svelte"],
-	},
-	astro: {
-		command: ["astro-ls", "--stdio"],
-		extensions: [".astro"],
-	},
+
+	// Java - OpenCode auto-installs jdtls, requires Java 21+
 	jdtls: {
 		command: ["jdtls"],
 		extensions: [".java"],
 	},
-	lua: {
+
+	// C#/F#
+	csharp: {
+		command: ["OmniSharp", "-lsp"],
+		extensions: [".cs"],
+	},
+	fsharp: {
+		command: ["fsautocomplete", "--adaptive-lsp-server-enabled"],
+		extensions: [".fs", ".fsi", ".fsx", ".fsscript"],
+	},
+
+	// Ruby
+	"ruby-lsp": {
+		command: ["ruby-lsp"],
+		extensions: [".rb", ".rake", ".gemspec", ".ru"],
+	},
+
+	// PHP
+	intelephense: {
+		command: ["intelephense", "--stdio"],
+		extensions: [".php"],
+	},
+
+	// Lua
+	"lua-ls": {
 		command: ["lua-language-server"],
 		extensions: [".lua"],
 	},
+
+	// Shell
+	bash: {
+		command: ["bash-language-server", "start"],
+		extensions: [".sh", ".bash", ".zsh", ".ksh"],
+	},
+
+	// Swift/Objective-C
+	"sourcekit-lsp": {
+		command: ["sourcekit-lsp"],
+		extensions: [".swift", ".objc", ".objcpp"],
+	},
+
+	// Dart
+	dart: {
+		command: ["dart", "language-server", "--protocol=lsp"],
+		extensions: [".dart"],
+	},
+
+	// Elixir
+	"elixir-ls": {
+		command: ["elixir-ls"],
+		extensions: [".ex", ".exs"],
+	},
+
+	// Gleam
+	gleam: {
+		command: ["gleam", "lsp"],
+		extensions: [".gleam"],
+	},
+
+	// Clojure
+	"clojure-lsp": {
+		command: ["clojure-lsp"],
+		extensions: [".clj", ".cljs", ".cljc", ".edn"],
+	},
+
+	// OCaml
+	"ocaml-lsp": {
+		command: ["ocamllsp"],
+		extensions: [".ml", ".mli"],
+	},
+
+	// Zig
+	zls: {
+		command: ["zls"],
+		extensions: [".zig", ".zon"],
+	},
+
+	// Nix
+	nixd: {
+		command: ["nixd"],
+		extensions: [".nix"],
+	},
+
+	// Terraform
+	terraform: {
+		command: ["terraform-ls", "serve"],
+		extensions: [".tf", ".tfvars"],
+	},
+
+	// Typst
+	tinymist: {
+		command: ["tinymist", "lsp"],
+		extensions: [".typ", ".typc"],
+	},
+
+	// YAML
+	"yaml-ls": {
+		command: ["yaml-language-server", "--stdio"],
+		extensions: [".yaml", ".yml"],
+	},
 };
 
-// Extension to language ID mapping
+// Extension to language ID mapping (used for LSP textDocument/didOpen)
 export const EXT_TO_LANG: Record<string, string> = {
+	// TypeScript/JavaScript
 	".ts": "typescript",
 	".tsx": "typescriptreact",
 	".mts": "typescript",
@@ -111,28 +231,109 @@ export const EXT_TO_LANG: Record<string, string> = {
 	".cjs": "javascript",
 	".json": "json",
 	".jsonc": "jsonc",
+
+	// Python
 	".py": "python",
 	".pyi": "python",
+
+	// Go
 	".go": "go",
+
+	// Rust
 	".rs": "rust",
+
+	// C/C++
 	".c": "c",
 	".cpp": "cpp",
 	".cc": "cpp",
 	".cxx": "cpp",
+	".c++": "cpp",
 	".h": "c",
 	".hpp": "cpp",
+	".hh": "cpp",
+	".hxx": "cpp",
+	".h++": "cpp",
+
+	// Java
 	".java": "java",
+
+	// C#/F#
+	".cs": "csharp",
+	".fs": "fsharp",
+	".fsi": "fsharp",
+	".fsx": "fsharp",
+	".fsscript": "fsharp",
+
+	// Ruby
+	".rb": "ruby",
+	".rake": "ruby",
+	".gemspec": "ruby",
+	".ru": "ruby",
+
+	// PHP
+	".php": "php",
+
+	// Lua
 	".lua": "lua",
+
+	// Shell
+	".sh": "shellscript",
+	".bash": "shellscript",
+	".zsh": "shellscript",
+	".ksh": "shellscript",
+
+	// Swift/Objective-C
+	".swift": "swift",
+	".objc": "objective-c",
+	".objcpp": "objective-cpp",
+
+	// Dart
+	".dart": "dart",
+
+	// Elixir
+	".ex": "elixir",
+	".exs": "elixir",
+
+	// Gleam
+	".gleam": "gleam",
+
+	// Clojure
+	".clj": "clojure",
+	".cljs": "clojurescript",
+	".cljc": "clojure",
+	".edn": "edn",
+
+	// OCaml
+	".ml": "ocaml",
+	".mli": "ocaml",
+
+	// Zig
+	".zig": "zig",
+	".zon": "zig",
+
+	// Nix
+	".nix": "nix",
+
+	// Terraform
+	".tf": "terraform",
+	".tfvars": "terraform",
+
+	// Typst
+	".typ": "typst",
+	".typc": "typst",
+
+	// Frontend frameworks
 	".vue": "vue",
 	".svelte": "svelte",
 	".astro": "astro",
+
+	// Web
 	".html": "html",
 	".css": "css",
 	".scss": "scss",
-	".md": "markdown",
+
+	// Config/Data
 	".yaml": "yaml",
 	".yml": "yaml",
-	".sh": "shellscript",
-	".bash": "shellscript",
-	".zsh": "shellscript",
+	".md": "markdown",
 };

package/dist/template/.opencode/memory/handoffs/2025-12-27T103000Z.md

@@ -0,0 +1,76 @@
+# Handoff: test-handoff-plugin
+
+**Created:** 2025-12-27T10:30:00Z
+**Agent:** build
+
+## Provenance
+
+| Key    | Value                                               |
+| ------ | --------------------------------------------------- |
+| Repo   | git@github.com:opencodekit/opencodekit-template.git |
+| Branch | main                                                |
+| Commit | ae38a95f899300419e9b17030268cedc60ebb44f            |
+| Clean  | no                                                  |
+
+## Session Context
+
+**Current Session:** testing handoff plugin
+**Token Usage:** ~50k estimated
+
+Next session can load context with:
+
+```
+read_session("last", project="current")
+```
+
+## Progress
+
+### Completed
+
+- [x] Released v0.6.4 (version bump, changelog, tag, GitHub release)
+- [x] Reviewed Agent-Skills-for-Context-Engineering repo (verdict: mostly theory, not worth stealing)
+- [x] Reviewed Karpathy's hn-time-capsule (verdict: useful patterns)
+- [x] Created handoff plugin (`plugin/handoff.ts`)
+- [x] Updated `/handoff` command to instruct Ctrl+K
+
+### In Progress
+
+- [ ] Testing handoff plugin - verifying it injects context on compaction
+
+### Remaining
+
+- [ ] Commit new handoff plugin and updated command
+- [ ] Test full flow: handoff → Ctrl+K → new session with context
+
+## Context
+
+### Key Files
+
+- `.opencode/plugin/handoff.ts` - New plugin that injects handoff on compaction
+- `.opencode/command/handoff.md` - Updated to tell user to press Ctrl+K
+- `.opencode/plugin/compactor.ts` - Reference for plugin structure
+
+### Decisions Made
+
+- Use `experimental.session.compacting` hook to inject handoff context
+- Only inject handoffs < 1 hour old to prevent stale context
+- Search both `.opencode/memory/handoffs/` and `.beads/artifacts/` for handoffs
+
+### Blockers/Issues
+
+- OpenCode lacks `session.start` hook (Issue #5409) - can't auto-navigate to new session
+- Workaround: User must manually press Ctrl+K after /handoff
+
+## Resume Instructions
+
+1. Commit the new handoff plugin and updated command
+2. Test the full flow: run /handoff, press Ctrl+K, verify context injected
+3. If working, consider adding to v0.6.5 release
+
+**Recommended:** Start next session with `/resume test-handoff-plugin` to auto-load this handoff + previous session context.
+
+## Artifacts
+
+- spec.md: missing
+- research.md: missing
+- plan.md: missing