clikit-plugin 0.2.28 → 0.2.30

package/dist/hooks/typecheck-gate.d.ts

@@ -1,31 +0,0 @@
-/**
- * TypeCheck Gate Hook
- *
- * Runs TypeScript type checking after .ts/.tsx file edits.
- * Reports type errors inline so agents can fix them immediately.
- * Runs on tool.execute.after for edit/write tools.
- */
-export interface TypeCheckConfig {
-    enabled?: boolean;
-    tsconfig?: string;
-    log?: boolean;
-    block_on_error?: boolean;
-}
-export interface TypeDiagnostic {
-    file: string;
-    line: number;
-    column: number;
-    code: string;
-    message: string;
-}
-export interface TypeCheckResult {
-    clean: boolean;
-    errors: TypeDiagnostic[];
-    checkedFile: string;
-}
-export declare function isTypeScriptFile(filePath: unknown): boolean;
-export declare function findTsConfig(projectDir: unknown, override?: string): string | undefined;
-export declare function hasTscInstalled(projectDir: unknown): boolean;
-export declare function runTypeCheck(filePath: unknown, projectDir: unknown, config?: TypeCheckConfig): TypeCheckResult;
-export declare function formatTypeCheckWarning(result: TypeCheckResult | unknown): string;
-//# sourceMappingURL=typecheck-gate.d.ts.map

package/dist/hooks/typecheck-gate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typecheck-gate.d.ts","sourceRoot":"","sources":["../../src/hooks/typecheck-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AA4BD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBvF;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAY5D;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,OAAO,EACnB,MAAM,CAAC,EAAE,eAAe,GACvB,eAAe,CAiCjB;AAsCD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAgBhF"}

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

@@ -1,136 +0,0 @@
----
-date: 2026-02-15
-phase: implementing
-branch: main
----
-
-# Handoff: CliKit Complete Type Guard Audit
-
----
-
-## Status Summary
-
-CliKit plugin v0.2.6 published with many type guards. Typecheck passes. However, there are still potential runtime issues where OpenCode passes non-string values that could cause `.toLowerCase()`, `.test()`, `.split()` etc. to fail.
-
----
-
-## 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 |
-
----
-
-## Remaining Issues (Need Type Guards)
-
-### 1. git-guard.ts: `checkDangerousCommand`
-**Line 25:** `command: string` - no type guard
-**Used:** `index.ts:221` - `toolInput.command as string | undefined`
-**Risk:** `pattern.test(command)` fails if command is object
-
-```typescript
-// Fix needed:
-export function checkDangerousCommand(command: unknown, allowForceWithLease = true): GitGuardResult {
-  if (typeof command !== "string") {
-    return { blocked: false, command: "" };
-  }
-  // ... rest
-}
-```
-
-### 2. swarm-enforcer.ts: `isFileInScope`
-**Line 33-36:** `filePath: string` - no type guard
-**Risk:** `path.resolve(filePath)` fails if filePath is not string
-
-```typescript
-// Fix needed:
-export function isFileInScope(filePath: unknown, scope: TaskScope): boolean {
-  if (typeof filePath !== "string") return false;
-  // ...
-}
-```
-
-### 3. swarm-enforcer.ts: `checkEditPermission`
-**Line 59-62:** `filePath: string` - no type guard
-
-### 4. index.ts: Tool input casting
-Multiple places where `toolInput.X as string | undefined` is used but the value could be an object:
-- Line 218: `toolInput.command` 
-- Line 269: `toolInput.prompt`
-- Line 335: `toolInput.filePath`
-- Line 351: `toolInput.filePath`
-
----
-
-## Files Modified (Uncommitted)
-
-| File | Status |
-|------|--------|
-| `.opencode/package.json` | v0.2.6 |
-| `.opencode/src/cli.ts` | Removed backup, fixed JSONC |
-| `.opencode/src/config.ts` | Type guard for loadCliKitConfig |
-| `.opencode/src/index.ts` | Array.isArray for todos |
-| `.opencode/src/hooks/auto-format.ts` | Type guards |
-| `.opencode/src/hooks/comment-checker.ts` | Type guards |
-| `.opencode/src/hooks/compaction.ts` | Type guards |
-| `.opencode/src/hooks/env-context.ts` | Type guards |
-| `.opencode/src/hooks/security-check.ts` | Type guards |
-| `.opencode/src/hooks/session-notification.ts` | Type guards |
-| `.opencode/src/hooks/subagent-question-blocker.ts` | Type guards |
-| `.opencode/src/hooks/swarm-enforcer.ts` | Partial (extractFileFromToolInput only) |
-| `.opencode/src/hooks/todo-enforcer.ts` | Type guards |
-| `.opencode/src/hooks/truncator.ts` | Type guards |
-| `.opencode/src/hooks/typecheck-gate.ts` | Type guards |
-
----
-
-## Git State
-
-- **Branch:** `main`
-- **Last commit:** `31b200c` - Update README with simplified installation
-- **Uncommitted changes:** 15 files
-
----
-
-## Next Steps
-
-1. [ ] Add type guard to `git-guard.ts:checkDangerousCommand(command: unknown)`
-2. [ ] Add type guard to `swarm-enforcer.ts:isFileInScope(filePath: unknown)`
-3. [ ] Add type guard to `swarm-enforcer.ts:checkEditPermission(filePath: unknown)`
-4. [ ] Run typecheck
-5. [ ] Publish v0.2.7
-6. [ ] Test: `opencode` starts without errors
-
----
-
-## Pattern for Type Guards
-
-```typescript
-// Before (breaks on non-string):
-export function myFunc(content: string): Result {
-  return content.split("\n");  // CRASH if content is object
-}
-
-// After (safe):
-export function myFunc(content: unknown): Result {
-  if (typeof content !== "string") {
-    return defaultResult;  // Safe fallback
-  }
-  return content.split("\n");
-}
-```
-
----
-
-## Resume Command
-
-To resume, use `/resume` and it will:
-1. Load this handoff
-2. Propose fixing remaining type guards in git-guard.ts and swarm-enforcer.ts
-3. Publish v0.2.7

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

@@ -1,140 +0,0 @@
----
-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/memory/handoffs/2026-02-15-importmeta-fix.md

@@ -1,121 +0,0 @@
----
-date: 2026-02-15
-phase: completed
-branch: main
----
-
-# Handoff: CliKit `import.meta.dir` Path Fix (v0.2.11)
-
----
-
-## Status Summary
-
-Fixed critical bug where bun build inlined `__dirname` to absolute build-time paths, AND fixed incorrect relative path resolution for bundled output. Plugin now correctly resolves paths at runtime from `dist/` directory.
-
----
-
-## Bug Description
-
-**Problem 1:** After `bun build`, `__dirname` was inlined to absolute build-time path:
-```javascript
-var __dirname = "/mnt/c/Users/Kira/Desktop/clikit/.opencode/src/agents";
-```
-
-**Problem 2:** Even after fixing to `import.meta.dir`, the relative paths were wrong because the bundled code runs from `dist/` but the paths were calculated from source file locations:
-
-| File | Source Location | Bundled Location |
-|------|-----------------|------------------|
-| `agents/index.ts` | `src/agents/` | `dist/index.js` |
-| `commands/index.ts` | `src/commands/` | `dist/index.js` |
-| `skills/index.ts` | `src/skills/` | `dist/index.js` |
-
----
-
-## Fix Applied
-
-| File | v0.2.10 (Broken) | v0.2.11 (Fixed) |
-|------|------------------|-----------------|
-| `src/agents/index.ts` | `import.meta.dir` → `dist/` | `path.join(import.meta.dir, "../src/agents")` |
-| `src/commands/index.ts` | `import.meta.dir + "../../command"` | `path.join(import.meta.dir, "../command")` |
-| `src/skills/index.ts` | `import.meta.dir + "../../skill"` | `path.join(import.meta.dir, "../skill")` |
-
----
-
-## Path Resolution (Correct)
-
-```
-Installed: ~/.cache/opencode/node_modules/clikit-plugin/
-
-dist/index.js                    ← import.meta.dir points here
-├── ../src/agents/               ← AGENTS_DIR (agent .md files)
-├── ../command/                  ← COMMANDS_DIR (command .md files)
-└── ../skill/                    ← SKILLS_DIR (skill directories)
-```
-
----
-
-## Version History
-
-| Version | Fix |
-|---------|-----|
-| 0.2.1-0.2.9 | Type guards for hooks/tools |
-| 0.2.10 | `__dirname` → `import.meta.dir` (paths still wrong) |
-| 0.2.11 | Correct relative paths from `dist/` directory |
-| 0.2.19 | Retry `getObservationsByType` when SQLite reports datatype mismatch |
-| 0.2.20 | Guard `memoryRead` against non-string paths |
-
----
-
-## Verification
-
-```bash
-# Check published package
-npm pack clikit-plugin@latest && tar -xzf clikit-plugin-0.2.11.tgz
-
-# Verify paths in bundled code
-grep -E "AGENTS_DIR|COMMANDS_DIR|SKILLS_DIR" package/dist/index.js
-
-# Output (correct):
-# var AGENTS_DIR = path.join(import.meta.dir, "../src/agents");
-# var COMMANDS_DIR = path2.join(import.meta.dir, "../command");
-# var SKILLS_DIR = path9.join(import.meta.dir, "../skill");
-```
-
----
-
-## 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. [ ] Verify `[CliKit] Loaded 10/10 agents` in logs
-5. [ ] Verify `[CliKit] Loaded 19/19 commands` in logs
-
----
-
-## Files Modified (3 files)
-
-| File | Changes |
-|------|---------|
-| `src/agents/index.ts` | `import.meta.dir` → `path.join(import.meta.dir, "../src/agents")` |
-| `src/commands/index.ts` | `../../command` → `../command` |
-| `src/skills/index.ts` | `../../skill` → `../skill` |
-| `package.json` | v0.2.11 |
-| `src/cli.ts` | VERSION = "0.2.11" |
-
----
-
-## Git State
-
-- **Branch:** `main`
-- **Uncommitted changes:** All fixes from this session
-
----
-
-## Root Cause Analysis
-
-Bun's bundler inlines `__dirname` to the build-time absolute path. However, `import.meta.dir` is preserved as a runtime expression. The key insight is that when code is bundled:
-
-1. All source files (`src/agents/index.ts`, `src/commands/index.ts`, `src/skills/index.ts`) are combined into a single `dist/index.js`
-2. `import.meta.dir` in the bundled code refers to the location of `dist/index.js`, not the original source files
-3. Resource files (`.md` files) are NOT bundled - they must be found via relative paths from `dist/`

package/memory/handoffs/2026-02-15-installing.md

@@ -1,90 +0,0 @@
----
-date: 2026-02-15
-phase: implementing
-branch: main
----
-
-# Handoff: CliKit Plugin Installation Fix
-
-## Status Summary
-
-CliKit plugin fully implemented (10 agents, 19 commands, 48 skills, 14 hooks, 6 tools). Published to npm as `clikit-plugin@0.1.6`. **Critical issue**: Plugin NOT registered in `~/.config/opencode/opencode.json` — the "plugin" key is missing entirely. This means the CLI installer was either never run or failed silently.
-
-## Task Status
-
-### ✅ Completed
-- [x] T-001: Create 10 agents with proper model assignments
-- [x] T-002: Create 19 slash commands  
-- [x] T-003: Create 48 workflow skills
-- [x] T-004: Create 14 runtime hooks
-- [x] T-005: Create 6 custom tools
-- [x] T-006: Publish to npm as clikit-plugin@0.1.6
-- [x] T-007: Create CLI installer code
-
-### 🔄 In Progress
-- [ ] T-008: Fix plugin registration in OpenCode config
-  - **Current state:** `~/.config/opencode/opencode.json` has no "plugin" key
-  - **Next step:** Run CLI installer and debug why registration isn't persisting
-
-### 📋 Not Started
-- [ ] T-009: Verify plugin loads when OpenCode starts
-- [ ] T-010: Test installation in fresh environment
-
-## Files Modified
-
-| File | Status | Notes |
-|------|--------|-------|
-| `.opencode/src/index.ts` | Complete | Main plugin entry point |
-| `.opencode/src/cli.ts` | Complete | CLI installer script |
-| `.opencode/src/config.ts` | Complete | Config loader |
-| `.opencode/package.json` | Complete | npm package config |
-
-## Git State
-
-- **Branch:** `main`
-- **Last commit:** `31b200c` - Update README with simplified installation
-- **Uncommitted:** No
-
-## Known Issues
-
-1. **Plugin not registered** - `~/.config/opencode/opencode.json` has NO "plugin" array
-2. **Plugin not cached** - `~/.cache/opencode/node_modules/` missing clikit-plugin
-3. **Possible path mismatch** - snap/bun may use different config path than native bun
-
-## Next Steps
-
-1. [ ] Run `bun x clikit-plugin install` to test CLI
-2. [ ] Verify output with `grep '"plugin"' ~/.config/opencode/opencode.json`
-3. [ ] Check if snap/bun path issue: `/home/kira/snap/bun-js/87/.config/opencode/`
-4. [ ] Restart OpenCode and check for `[CliKit]` logs
-
-## Context for Resumption
-
-### Key Discovery
-The opencode.json at `~/.config/opencode/opencode.json` exists but has no "plugin" array. CLI code at `.opencode/src/cli.ts:72-84` writes to this path, but the key is missing.
-
-### Possible Causes
-1. CLI was never executed by user
-2. Bun snap uses different home path: `/home/kira/snap/bun-js/87/`
-3. Write operation failed silently
-
-### Verification Commands
-```bash
-# Run installer
-bun x clikit-plugin install
-
-# Check registration
-grep -A2 '"plugin"' ~/.config/opencode/opencode.json
-
-# Check snap path
-ls /home/kira/snap/bun-js/87/.config/opencode/
-```
-
-### Reference Implementation
-- oh-my-opencode-slim: https://github.com/alvinunreal/oh-my-opencode-slim
-- Plugin docs: https://opencode.ai/docs/plugins/
-
-### Key Files to Review
-- `.opencode/src/cli.ts` — CLI installer logic (lines 55-88)
-- `~/.config/opencode/opencode.json` — Target config file
-- `.opencode/package.json` — Package config with `main` and `bin`

package/memory/handoffs/2026-02-15-plugin-install-fix.md

@@ -1,140 +0,0 @@
----
-date: 2026-02-15
-phase: implementing
-branch: main
----
-
-# Handoff: CliKit Plugin Installation & Runtime Fixes
-
----
-
-## Status Summary
-
-CliKit plugin published to npm (v0.1.9 → v0.2.0). Fixed snap/bun path detection and multiple runtime errors. **CRITICAL ISSUE IDENTIFIED**: Installer overwrites `opencode.json` instead of merging with existing config, deleting user's existing settings. Multiple `.split()`, `.substring()` errors still occurring in hooks due to non-string arguments.
-
----
-
-## Artifacts
-
-| Type | Path | Status |
-|------|------|--------|
-| Handoff | `.opencode/memory/handoffs/2026-02-15-installing.md` | 📚 Previous |
-| Config | `~/.config/opencode/opencode.json` | ⚠️ Gets overwritten |
-
----
-
-## Task Status
-
-### ✅ Completed
-- [x] T-001-T-007: Plugin implementation (10 agents, 19 commands, 48 skills, 14 hooks, 6 tools)
-- [x] Fix snap/bun path detection using `SNAP_REAL_HOME` and regex fallback
-- [x] Fix `buildErrorNotification` to handle Error objects
-- [x] Fix `buildIdleNotification` to handle non-string sessionId
-- [x] Fix `checkCommentDensity` and `hasExcessiveAIComments` to handle non-string content
-- [x] Published v0.1.7, v0.1.8, v0.1.9, v0.2.0 to npm
-
-### 🔄 In Progress
-- [ ] **CRITICAL**: Fix installer to MERGE with existing opencode.json instead of overwriting
-  - **Current state:** `parseConfig()` reads existing config, but may not preserve all keys
-  - **User report:** "nó ghi đè file opencode.json làm xóa config có sẵn của tôi"
-  - **Root cause:** Need to deep merge, not shallow overwrite
-  
-- [ ] Fix remaining runtime errors in hooks
-  - **Files needing defensive type checks:**
-    - `src/hooks/truncator.ts` - `shouldTruncate()`, `truncateOutput()`
-    - `src/hooks/security-check.ts` - `scanContentForSecrets()`
-    - `src/hooks/compaction.ts` - multiple `.substring()` calls
-  - **Pattern:** Add `if (typeof content !== "string") return defaultResult;` at function start
-
-### 📋 Not Started
-- [ ] T-009: Verify plugin loads when OpenCode starts
-- [ ] T-010: Test installation in fresh environment
-- [ ] Add automated tests for installer
-
----
-
-## Files Modified
-
-| File | Status | Notes |
-|------|--------|-------|
-| `src/cli.ts` | Modified | Added `getRealHome()` for snap path detection |
-| `src/hooks/session-notification.ts` | Modified | Fixed `buildIdleNotification`, `buildErrorNotification` |
-| `src/hooks/comment-checker.ts` | Modified | Added type guards for content param |
-| `src/index.ts` | Modified | Pass raw error to `buildErrorNotification` |
-| `package.json` | Modified | Version bumps to 0.2.0 |
-
----
-
-## Git State
-
-- **Branch:** `main`
-- **Last commit:** `31b200c` - Update README with simplified installation
-- **Uncommitted changes:** Yes (5 modified files)
-
----
-
-## Known Issues
-
-1. **CRITICAL: Installer overwrites opencode.json** - deletes user's existing config (mcp, provider settings)
-   - Need to deep merge instead of shallow merge
-   - Should backup existing config before modifying
-
-2. **Runtime TypeError: `.split()`, `.substring()` on undefined**
-   - Multiple hooks receive non-string arguments from OpenCode events
-   - Need defensive type checks in ALL functions that call string methods
-
-3. **Snap/bun path mismatch** - partially fixed but user still sees wrong path
-   - `bun x` may cache old versions
-   - Need to verify `SNAP_REAL_HOME` detection works in user's environment
-
----
-
-## Next Steps
-
-1. [ ] **FIX INSTALLER** - Merge with existing config, don't overwrite:
-   ```typescript
-   // In cli.ts, preserve existing config keys
-   const existingConfig = parseConfig(configPath);
-   const newConfig = { ...existingConfig, plugin: filteredPlugins };
-   writeConfig(configPath, newConfig);
-   ```
-
-2. [ ] Add defensive type checks to all hooks that use string methods:
-   - `truncator.ts`: `shouldTruncate()`, `truncateOutput()`
-   - `security-check.ts`: `scanContentForSecrets()`
-   - `compaction.ts`: All substring calls
-
-3. [ ] Publish v0.2.1 with fixes
-
-4. [ ] Test: `bun x clikit-plugin@latest install` should preserve existing config
-
----
-
-## Context for Resumption
-
-### The Core Problem
-The installer's `writeConfig()` function writes the entire config object to disk. The current code does spread, but needs to ensure `parseConfig()` returns complete existing config.
-
-### Solution Approach
-```typescript
-// cli.ts - install() function:
-const existingConfig = parseConfig(configPath) || {};
-const plugins = Array.isArray(existingConfig.plugin) ? [...existingConfig.plugin] : [];
-// ... modify plugins array ...
-config.plugin = filteredPlugins;
-// existingConfig already has all keys, we just update plugin
-```
-
-### Files to Review
-- `src/cli.ts:55-108` — Installer logic
-- `src/hooks/truncator.ts` — Needs type guards
-- `src/hooks/security-check.ts` — Needs type guards
-
----
-
-## Resume Command
-
-To resume, use `/resume` and it will:
-1. Load this handoff
-2. Check for drift
-3. Propose fixing installer merge logic first