clikit-plugin 0.2.9 → 0.2.10

package/dist/cli.js

@@ -6,7 +6,7 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 var PLUGIN_NAME = "clikit-plugin";
-var VERSION = "0.2.0";
+var VERSION = "0.2.10";
 function getRealHome() {
   if (process.env.SNAP_REAL_HOME) {
     return process.env.SNAP_REAL_HOME;

package/dist/index.js

@@ -3495,8 +3495,7 @@ var require_gray_matter = __commonJS((exports, module) => {
 var import_gray_matter = __toESM(require_gray_matter(), 1);
 import * as fs from "fs";
 import * as path from "path";
-var __dirname = "/mnt/c/Users/Kira/Desktop/clikit/.opencode/src/agents";
-var AGENTS_DIR = __dirname;
+var AGENTS_DIR = import.meta.dir;
 function parseAgentMarkdown(filePath) {
   try {
     const content = fs.readFileSync(filePath, "utf-8");
@@ -3549,8 +3548,7 @@ function getBuiltinAgents() {
 var import_gray_matter2 = __toESM(require_gray_matter(), 1);
 import * as fs2 from "fs";
 import * as path2 from "path";
-var __dirname = "/mnt/c/Users/Kira/Desktop/clikit/.opencode/src/commands";
-var COMMANDS_DIR = path2.join(__dirname, "../../command");
+var COMMANDS_DIR = path2.join(import.meta.dir, "../../command");
 function parseCommandMarkdown(filePath) {
   try {
     const content = fs2.readFileSync(filePath, "utf-8");
@@ -4791,8 +4789,7 @@ var RITUAL_FILE = path8.join(process.cwd(), ".opencode", "memory", "ritual-state
 var import_gray_matter3 = __toESM(require_gray_matter(), 1);
 import * as fs8 from "fs";
 import * as path9 from "path";
-var __dirname = "/mnt/c/Users/Kira/Desktop/clikit/.opencode/src/skills";
-var SKILLS_DIR = path9.join(__dirname, "..", "..", "skill");
+var SKILLS_DIR = path9.join(import.meta.dir, "../../skill");
 function getBuiltinSkills() {
   const skills = {};
   if (!fs8.existsSync(SKILLS_DIR)) {

package/memory/handoffs/2026-02-15-complete-fix.md

@@ -0,0 +1,140 @@
+---
+date: 2026-02-15
+phase: implementing
+branch: main
+---
+
+# Handoff: CliKit Complete Type Guard & SQLite Fix
+
+---
+
+## Status Summary
+
+CliKit plugin v0.2.1 → v0.2.9 published with comprehensive type guards across all hooks and tools. Fixed SQLite schema migration issues, removed backup logic, and added defensive programming patterns throughout the codebase. Plugin should now handle all edge cases where OpenCode passes unexpected data types.
+
+---
+
+## Version History
+
+| Version | Fix |
+|---------|-----|
+| 0.2.1 | Type guards in hooks (truncator, security-check, compaction) |
+| 0.2.2 | Abort on JSON parse error |
+| 0.2.3 | Fix JSONC comment stripping breaking URLs |
+| 0.2.4 | Remove backup logic, fix `todos.filter` error |
+| 0.2.5 | Fix `path.join` error - guards for projectDir/cwd params |
+| 0.2.6 | Fix `text.toLowerCase` error in subagent-question-blocker |
+| 0.2.7 | Fix remaining type guards (git-guard, swarm-enforcer) |
+| 0.2.8 | SQLite migration - add missing columns |
+| 0.2.9 | Type guards for ALL tool functions |
+
+---
+
+## Task Status
+
+### ✅ Completed
+- [x] Fix installer to MERGE with existing opencode.json
+- [x] Remove backup creation from cli.ts
+- [x] Add type guards to all hooks (14 hooks)
+- [x] Add type guards to all tools (6 tool files)
+- [x] Fix SQLite schema migration with ALTER TABLE
+- [x] Publish v0.2.1 → v0.2.9 to npm
+
+### 📋 Not Started
+- [ ] Test: `opencode` starts without errors
+- [ ] Test: Plugin loads correctly after fresh install
+
+---
+
+## Files Modified (22 files)
+
+| File | Changes |
+|------|---------|
+| `package.json` | v0.2.9 |
+| `cli.ts` | Removed backup, fixed JSONC parsing |
+| `config.ts` | Type guard for loadCliKitConfig |
+| `index.ts` | Array.isArray for todos |
+| `hooks/auto-format.ts` | Type guards for filePath, projectDir |
+| `hooks/comment-checker.ts` | Type guard for content |
+| `hooks/compaction.ts` | Type guards for projectDir, raw content |
+| `hooks/env-context.ts` | Type guard for cwd |
+| `hooks/git-guard.ts` | Type guard for command |
+| `hooks/security-check.ts` | Type guard for content |
+| `hooks/session-notification.ts` | Type guards for sessionId, error |
+| `hooks/subagent-question-blocker.ts` | Type guards for text, toolName |
+| `hooks/swarm-enforcer.ts` | Type guards for filePath, toolName |
+| `hooks/todo-enforcer.ts` | Type guard for todos array |
+| `hooks/truncator.ts` | Type guard for content |
+| `hooks/typecheck-gate.ts` | Type guards for filePath, projectDir, output |
+| `tools/observation.ts` | Type guard + SQLite migration |
+| `tools/memory.ts` | Type guards + SQLite migration |
+| `tools/beads-memory-sync.ts` | Type guard + SQLite migration |
+| `tools/context-summary.ts` | Type guard + SQLite migration |
+| `tools/quick-research.ts` | Type guard for params |
+| `tools/swarm.ts` | Type guard for params |
+
+---
+
+## Git State
+
+- **Branch:** `main`
+- **Last commit:** `31b200c` - Update README with simplified installation
+- **Uncommitted changes:** 22 modified files, 5 handoff files
+
+---
+
+## Known Issues
+
+None - all reported runtime errors have been addressed with type guards.
+
+---
+
+## Next Steps
+
+1. [ ] User test: `rm -rf ~/.cache/opencode/node_modules/clikit-plugin`
+2. [ ] User test: `bun x clikit-plugin@latest install`
+3. [ ] User test: `opencode` - should start without errors
+4. [ ] If errors persist, check error message and add appropriate type guard
+
+---
+
+## Context for Resumption
+
+### Type Guard Pattern Used Throughout
+
+```typescript
+export function myFunc(params: unknown): Result | null {
+  if (!params || typeof params !== "object") {
+    return defaultResult;
+  }
+  const p = params as Partial<Params>;
+  if (!p.requiredField) {
+    return defaultResult;
+  }
+  // ... rest of function
+}
+```
+
+### SQLite Migration Pattern
+
+```typescript
+// Create table with all columns
+db.exec(`CREATE TABLE IF NOT EXISTS observations (...)`);
+
+// Migration: add missing columns if they don't exist
+try { db.exec(`ALTER TABLE observations ADD COLUMN new_col TEXT`); } catch {}
+```
+
+### Key Files to Review
+- `.opencode/src/hooks/*.ts` — All hooks have type guards
+- `.opencode/src/tools/*.ts` — All tools have type guards + SQLite migration
+- `.opencode/src/cli.ts` — Installer logic, JSONC parsing
+
+---
+
+## Resume Command
+
+To resume, use `/resume` and it will:
+1. Load this handoff
+2. Check for new runtime errors
+3. Propose adding appropriate type guards if needed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clikit-plugin",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "OpenCode plugin with 10 agents, 19 commands, 48 skills, 14 hooks",
   "type": "module",
   "main": "./dist/index.js",

package/src/agents/index.ts

@@ -3,7 +3,7 @@ import * as fs from "fs";
 import * as path from "path";
 import matter from "gray-matter";
 
-const AGENTS_DIR = __dirname;
+const AGENTS_DIR = import.meta.dir;
 
 function parseAgentMarkdown(filePath: string): AgentConfig | null {
   try {