clikit-plugin 0.2.45 → 0.2.46

package/dist/tools/index.d.ts

@@ -1,8 +1,5 @@
 export { memoryRead, memorySearch, memoryGet, memoryTimeline, memoryUpdate, memoryAdmin, type MemorySearchParams, type MemorySearchResult, type MemoryObservation, type MemoryUpdateParams, type MemoryTimelineParams, type MemoryAdminParams, type MemoryAdminResult, } from "./memory";
 export { createObservation, getObservationsByType, getObservationsByBead, linkObservations, type ObservationParams, type ObservationResult, } from "./observation";
-export { swarm, type SwarmParams, type SwarmTask, type SwarmResult, type SwarmPlanResult, type SwarmMonitorResult, type SwarmDelegateResult, type SwarmAbortResult, } from "./swarm";
-export { beadsMemorySync, type BeadsMemorySyncParams, type BeadsMemorySyncResult, } from "./beads-memory-sync";
-export { quickResearch, type QuickResearchParams, type QuickResearchResult, } from "./quick-research";
 export { contextSummary, type ContextSummaryParams, type ContextSummaryResult, } from "./context-summary";
 export { cassMemoryContext, cassMemoryMark, cassMemoryReflect, cassMemoryDoctor, cassMemoryOutcome, cassIsAvailable, cassResetCache, type CassMemoryContextParams, type CassMemoryMarkParams, type CassMemoryReflectParams, type CassMemoryOutcomeParams, type CassMemoryDoctorParams, type CassMemoryExecOptions, type CassMemoryResult, } from "./cass-memory";
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC"}

package/memory/_digest.md

@@ -1,6 +1,6 @@
 # Memory Digest
 
-> Auto-generated on 2026-02-26. Read-only reference for agents.
+> Auto-generated on 2026-03-17. Read-only reference for agents.
 > Source: `.opencode/memory/memory.db`
 
 *No observations found in memory database.*

package/memory/_templates/plan.md

@@ -77,6 +77,22 @@ Use this template when creating implementation plans.
 **Boundaries:**
 - [What NOT to do]
 
+**Task Packet:**
+- **packet_id:** P-T-001
+- **goal:** [Single executable concern]
+- **files_in_scope:**
+  - create: [`path/to/new-file.ts`]
+  - modify: [`path/to/existing.ts`]
+  - delete: []
+- **verification_commands:**
+  - `bun run typecheck`
+  - `bun test path/to/test.ts`
+- **risks:**
+  - [Top risk for this packet]
+- **escalate_if:**
+  - [Verification fails twice]
+  - [A file outside scope must be edited]
+
 ---
 
 ### Task 2: [Title]
@@ -98,6 +114,17 @@ Use this template when creating implementation plans.
 
 ---
 
+## Execution Model
+
+- Workflow quick mode: `/create → /start → /ship → /verify`
+- Workflow deep mode: `/create → /research → /design → /start → /ship → /verify`
+- Execution unit: **Task Packet**
+- Source of truth: **Beads**
+- `/start`: execute + per-packet verify loop
+- `/verify`: pre-ship gate (all 4 checks, SHIP_READY verdict required before `/ship`)
+
+---
+
 ## Dependencies
 
 ```mermaid
@@ -134,6 +161,14 @@ graph TD
 Tasks eligible for Quick Mode (no full plan needed):
 - [ ] T-001 (S, ≤3 files, no security/db/api)
 
+## Packet Checklist
+
+- [ ] Every task has a packet_id
+- [ ] Every packet stays within 1–3 files
+- [ ] Every packet has executable verification commands
+- [ ] Every packet has an escalate_if clause
+- [ ] File Impact matches all packet scopes
+
 ---
 
 ## Rollout Plan

package/memory/_templates/spec.md

@@ -92,6 +92,12 @@ Use this template when creating specifications.
 | AC-01 | [Criteria] | [How to verify] |
 | AC-02 | [Criteria] | [How to verify] |
 
+### Execution Notes
+- Preferred workflow mode: `compressed`
+- Expected execution unit: **Task Packet**
+- Beads issue/task is the live execution state
+- Manual-only verification is not allowed unless explicitly marked as follow-up
+
 ---
 
 ## Assumptions
@@ -107,6 +113,12 @@ Use this template when creating specifications.
 - [ ] [Question 1]
 - [ ] [Question 2]
 
+## Planning Handoff Hints
+
+- Likely files in scope: [candidate files/directories]
+- Likely packet boundaries: [how the work should split into 1–3 file packets]
+- Escalate if: [conditions that should trigger re-plan or Oracle]
+
 ---
 
 ## References

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clikit-plugin",
-  "version": "0.2.45",
-  "description": "OpenCode plugin with 7 agents, 19 commands, 48 skills, 10 hooks",
+  "version": "0.2.46",
+  "description": "OpenCode plugin — 7 agents, 15 commands, 22 skills, 10 hooks",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -56,7 +56,7 @@
   },
   "homepage": "https://github.com/KiraKas-Tr/CliKit#readme",
   "dependencies": {
-    "@opencode-ai/plugin": "1.2.15",
+    "@opencode-ai/plugin": "1.2.25",
     "gray-matter": "^4.0.3"
   },
   "devDependencies": {
@@ -67,4 +67,4 @@
   "peerDependencies": {
     "bun": ">=1.0.0"
   }
-}
+}

package/skill/beads/SKILL.md

@@ -1,56 +1,55 @@
 ---
 name: beads
-description: Use for multi-agent task coordination, file locking, and dependency management via beads-village tools.
+description: Use for multi-agent task coordination, file locking, and dependency management via beads-village MCP tools.
 ---
 
-# Beads Skill
+# Beads
 
-You are running the **beads** skill. Multi-agent coordination via beads-village.
+**AI agents: always use `beads-village_*` MCP tools — never shell `bd` commands.**
 
-## Core Cycle
+## Session Cycle
 
 ```
-claim → reserve → work → done
+init → ls(ready) → show → claim → reserve(files) → work → done
 ```
 
-## beads-village Tools
+## Core Tools
 
 | Tool | Purpose |
 |------|---------|
-| `beads-village_claim` | Pick up next ready task |
-| `beads-village_reserve` | Lock files before editing |
-| `beads-village_done` | Complete task, release files |
-| `beads-village_ready` | List tasks with no blockers |
-| `beads-village_add` | Create new task |
-| `beads-village_assign` | Delegate to role (leader only) |
-| `beads-village_ls` | List all tasks |
-| `beads-village_show` | Get task details |
-| `beads-village_status` | Workspace overview |
-
-## Dependency Management
-
-- Tasks with `deps` wait for dependencies to complete
-- Use `beads-village_ready` to find unblocked tasks
-- Check status with `beads-village_status`
-
-## File Locking Protocol
-
-1. Call `reserve` before editing shared files
-2. TTL defaults to 10 minutes
-3. Locks auto-release on `done`
-4. Check `reservations` before editing
-
-## Session Workflow
-
-1. `beads-village_init` on session start
-2. `beads-village_claim` to get work
-3. `beads-village_reserve` files you'll edit
-4. `beads-village_done` when complete
-5. `beads-village_sync` to push/pull changes
-
-## Best Practices
-
-- Always check dependencies before claiming
-- Reserve files early to prevent conflicts
-- Use descriptive task titles
-- Tag tasks with roles (fe, be, mobile, devops, qa)
+| `beads-village_init(team=…)` | **First call every session** |
+| `beads-village_ls(status="ready")` | List unblocked tasks |
+| `beads-village_show(id)` | Read task details |
+| `beads-village_claim()` | Claim next ready task |
+| `beads-village_add(title, typ, pri, tags, deps)` | Create issue |
+| `beads-village_reserve(paths, reason)` | Lock files before editing |
+| `beads-village_done(id, msg)` | Complete + auto-release locks |
+| `beads-village_msg(subj, global=true, to="all")` | Broadcast |
+| `beads-village_inbox(unread=true)` | Read messages |
+| `beads-village_status(include_agents=true)` | Workspace overview |
+| `beads-village_sync()` | Git push/pull |
+
+## Issue Schema
+
+```
+typ:  task | bug | feature | epic | chore
+pri:  0=critical  1=high  2=normal  3=low  4=backlog
+tags: fe | be | devops | qa
+deps: ["bv-id"]  or  ["discovered-from:bv-id"]
+```
+
+## When to Create Issues
+
+- Trivial (< 2 min, 1-line): skip, just do it
+- Non-trivial (2+ min, 2+ files): create issue first, then work
+
+## v1.3 API — Correct Names
+
+| ❌ Old | ✅ Correct |
+|--------|-----------|
+| `beads-village_ready` | `beads-village_ls(status="ready")` |
+| `beads-village_broadcast` | `beads-village_msg(global=true, to="all")` |
+| `beads-village_discover` | `beads-village_status(include_agents=true)` |
+
+See [references/api-reference.md](references/api-reference.md) for full tool params and examples.
+- MCP: `beads-village` — see [mcp.json](mcp.json)

package/skill/beads/mcp.json

@@ -0,0 +1,26 @@
+{
+  "mcpServers": {
+    "beads-village": {
+      "type": "local",
+      "command": ["npx", "-y", "beads-village"],
+      "description": "Multi-agent task coordination, file locking, issue tracking",
+      "tools": [
+        "beads-village_init",
+        "beads-village_add",
+        "beads-village_claim",
+        "beads-village_done",
+        "beads-village_ls",
+        "beads-village_show",
+        "beads-village_reserve",
+        "beads-village_release",
+        "beads-village_reservations",
+        "beads-village_msg",
+        "beads-village_inbox",
+        "beads-village_status",
+        "beads-village_sync",
+        "beads-village_cleanup",
+        "beads-village_doctor"
+      ]
+    }
+  }
+}

package/skill/beads/references/api-reference.md

@@ -0,0 +1,64 @@
+# Beads API Reference
+
+## Full Tool Parameters
+
+### beads-village_init
+```
+team:      string  (required)
+role:      string  (be | fe | devops | qa)
+leader:    bool    (default: false)
+start_tui: bool    (default: false)
+```
+
+### beads-village_add
+```
+title:   string  (required)
+desc:    string
+typ:     task | bug | feature | epic | chore
+pri:     0–4  (0=critical, 4=backlog, default: 2)
+tags:    string[]
+deps:    string[]  (e.g. ["bv-1", "discovered-from:bv-2"])
+parent:  string  (epic id)
+```
+
+### beads-village_reserve
+```
+paths:  string[]  (required)
+reason: string
+ttl:    int  (minutes, default: 10)
+```
+
+### beads-village_msg
+```
+subj:       string  (required)
+body:       string
+to:         string
+global:     bool    (true = team broadcast)
+importance: string
+thread:     string
+```
+
+## Example: Build Agent Session
+
+```
+beads-village_init(team="myproject")
+beads-village_inbox(unread=true)
+beads-village_ls(status="ready")
+
+# → pick issue bv-42
+beads-village_show("bv-42")
+beads-village_claim()
+beads-village_reserve(paths=["src/auth/login.ts"], reason="bv-42")
+
+# ... implement ...
+
+beads-village_done(id="bv-42", msg="Fixed null check in token validation")
+beads-village_sync()
+```
+
+## File Locking Protocol
+
+1. `beads-village_reservations()` — check what's locked before editing
+2. `beads-village_reserve(paths=[…])` — lock your files
+3. TTL default: 10 min — extend for longer tasks
+4. `beads-village_done()` — auto-releases all locks, no manual release needed

package/skill/chrome-devtools/SKILL.md

@@ -1,36 +1,35 @@
 ---
 name: chrome-devtools
-description: Use for web debugging, performance analysis, network inspection, and runtime diagnostics.
+description: Use for web debugging, performance analysis, network inspection, and runtime diagnostics via Chrome DevTools protocol.
 ---
 
-# Chrome DevTools Skill
-
-You are running the **chrome-devtools** skill. Deep debugging via embedded Chrome DevTools MCP.
+# Chrome DevTools
 
 ## Capabilities
 
-| Action | Description |
-|--------|-------------|
-| Inspect network | Request/response headers, timing, payloads |
-| Debug web apps | Breakpoints, call stacks, variable inspection |
-| Analyze performance | Lighthouse audits, Core Web Vitals, profiling |
-| Console access | Execute JS, log analysis, error tracing |
-| DOM inspection | Element selection, computed styles, layout |
-
-## Usage
-
-1. Connect to target page (URL or local dev server)
-2. Select tool: Network, Performance, Console, Elements
-3. Perform inspection or profiling
-4. Export results for analysis
+| Task | What to use |
+|------|-------------|
+| Network timing / payloads | Network panel → HAR export |
+| JS breakpoints & call stack | Sources panel |
+| Core Web Vitals / Lighthouse | Performance / Lighthouse audit |
+| Console errors & JS execution | Console panel |
+| DOM + computed styles | Elements panel |
 
-## MCP Loading
+## Workflow
 
-This skill uses an embedded Chrome DevTools protocol connection. No external MCP server required.
+1. Connect to target (URL or local dev server)
+2. Choose panel: Network · Performance · Console · Elements
+3. Inspect or profile
+4. Export results (HAR / report) for analysis
 
 ## Best Practices
 
-- Profile before optimizing to identify real bottlenecks
-- Use network throttling to test slow connections
+- Profile before optimizing — identify real bottlenecks, not guesses
+- Use network throttling (Fast 3G / Slow 3G) to test real-world conditions
 - Check both desktop and mobile viewports
-- Export HAR files for network analysis
+- Export HAR for async network analysis
+
+## References
+
+- [Tool reference](references/tool-reference.md) — Puppeteer MCP tools, evaluate() snippets, debug workflow
+- MCP: `puppeteer` — see [mcp.json](mcp.json)

package/skill/chrome-devtools/mcp.json

@@ -0,0 +1,17 @@
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "type": "local",
+      "command": ["npx", "-y", "@modelcontextprotocol/server-puppeteer"],
+      "description": "Chrome DevTools — network, console, DOM, performance via Puppeteer",
+      "tools": [
+        "puppeteer_navigate",
+        "puppeteer_screenshot",
+        "puppeteer_click",
+        "puppeteer_fill",
+        "puppeteer_evaluate",
+        "puppeteer_pdf"
+      ]
+    }
+  }
+}

package/skill/chrome-devtools/references/tool-reference.md

@@ -0,0 +1,63 @@
+# Chrome DevTools — Tool Reference
+
+## Puppeteer MCP Tools
+
+```
+puppeteer_navigate(url)
+puppeteer_screenshot(selector?)           # capture page or element
+puppeteer_click(selector)
+puppeteer_fill(selector, value)
+puppeteer_evaluate(script)                # run JS, returns result
+puppeteer_pdf(path)                       # save page as PDF
+```
+
+## Useful evaluate() Snippets
+
+### Network timing
+```js
+puppeteer_evaluate(`
+  JSON.stringify(
+    performance.getEntriesByType('navigation')[0]
+  )
+`)
+```
+
+### Core Web Vitals
+```js
+puppeteer_evaluate(`
+  new Promise(resolve => {
+    new PerformanceObserver(list => {
+      resolve(list.getEntries().map(e => ({name: e.name, value: e.value})))
+    }).observe({entryTypes: ['largest-contentful-paint','first-input','layout-shift']})
+  })
+`)
+```
+
+### Console errors capture
+```js
+puppeteer_evaluate(`
+  window.__errors = [];
+  window.onerror = (msg, src, line) => window.__errors.push({msg,src,line});
+  'listening'
+`)
+# ... navigate, interact ...
+puppeteer_evaluate("JSON.stringify(window.__errors)")
+```
+
+### DOM state
+```js
+puppeteer_evaluate("document.querySelector('.component')?.innerHTML")
+puppeteer_evaluate("getComputedStyle(document.querySelector('.btn')).backgroundColor")
+```
+
+## Debug Workflow
+
+```
+1. puppeteer_navigate(url)
+2. puppeteer_evaluate(capture console errors)
+3. puppeteer_screenshot()                  → baseline
+4. puppeteer_click / puppeteer_fill
+5. puppeteer_screenshot()                  → after interaction
+6. puppeteer_evaluate(check state)
+7. compare screenshots + state
+```

package/skill/condition-based-waiting/SKILL.md

@@ -1,92 +1,54 @@
 ---
 name: condition-based-waiting
-description: Replace arbitrary timeouts with condition polling. Wait for actual state changes. Eliminates flaky tests from race conditions.
+description: Replace arbitrary timeouts with condition polling. Eliminates flaky tests from race conditions — wait for actual state, not clock time.
 ---
 
-# Condition-Based Waiting Skill
+# Condition-Based Waiting
 
-You are running the **condition-based-waiting** skill. Never use arbitrary sleeps. Always wait for conditions.
+## Rule
 
-## The Problem
-
-```javascript
-// BAD: Arbitrary timeout
-await sleep(2000);
-expect(element.isVisible).toBe(true);
-
-// Why it fails:
-// - Too short: Flaky on slow CI
-// - Too long: Wastes time on fast machines
-// - Never correct: Race condition waiting to happen
 ```
-
-## The Solution
-
-```javascript
-// GOOD: Wait for condition
-await waitFor(() => expect(element.isVisible).toBe(true), { timeout: 5000 });
-
-// Why it works:
-// - Passes immediately when ready
-// - Fails fast with clear error
-// - No wasted time
+NEVER: await sleep(2000)
+ALWAYS: await waitFor(() => condition, { timeout: 5000 })
 ```
 
 ## Patterns
 
-### UI Waiting
-```javascript
-// Wait for element
+```js
+// UI element
 await page.waitForSelector('.loaded');
 
-// Wait for text
-await waitFor(() => page.textContent('.status') === 'Ready');
-
-// Wait for visibility
+// Custom condition
 await waitFor(() => element.isVisible());
-```
 
-### API Waiting
-```javascript
-// Wait for response
+// API state
 await waitFor(async () => {
-  const res = await fetch('/status');
-  const data = await res.json();
-  return data.ready === true;
+  const { ready } = await fetch('/status').then(r => r.json());
+  return ready === true;
 });
 
-// Wait for state
-await waitFor(() => store.getState().loaded === true);
+// DB record
+await waitFor(async () => (await db.find(id)) !== null);
 ```
 
-### Database Waiting
-```javascript
-// Wait for record
-await waitFor(async () => {
-  const record = await db.find(id);
-  return record !== null;
-});
-```
-
-## Rules
+## Timeout Strategy
 
-| Pattern | Verdict |
-|---------|---------|
-| `sleep(n)` or `wait(n)` | DELETE. Replace with condition. |
-| `setTimeout` in tests | DELETE. Use polling. |
-| "It works on my machine" | Race condition. Fix with condition. |
-| Fixed delay "to be safe" | Not safe. Use condition. |
+- Default timeout: **5000ms**
+- Poll interval: **50ms**
+- Include current state in error message
+- External services: use exponential backoff
 
-## Timeout Strategy
+## Verdict Table
 
-1. Set reasonable timeout (default: 5000ms)
-2. Poll frequently (default: 50ms intervals)
-3. Include state in error message
-4. Consider exponential backoff for external services
+| Pattern | Action |
+|---------|--------|
+| `sleep(n)` / `wait(n)` | DELETE — replace with condition |
+| `setTimeout` in tests | DELETE — use polling |
+| Fixed delay "to be safe" | DELETE — not safe |
+| "Flaky in CI" | Race condition — apply condition wait |
 
 ## Red Flags
 
-- Any hardcoded delay in test code
-- Comments explaining why timeout is needed
-- Tests that pass locally but fail in CI
-- "Flaky" test label without investigation
+- Hardcoded delay in test code
+- Comment explaining why the delay is needed
+- Test passes locally but flakes in CI