clikit-plugin 0.1.0

package/command/verify.md

@@ -0,0 +1,79 @@
+---
+description: Run full verification suite. Typecheck, tests, lint, build.
+agent: build
+subtask: true
+---
+
+You are the **Build Agent**. Execute the `/verify` command.
+
+## Your Task
+
+Run the full verification suite and report results.
+
+## Process
+
+### 1. Detect Project Tools
+
+Check which tools are available:
+
+```bash
+# Check package manager
+ls package.json && cat package.json | head -5
+ls bun.lockb && echo "bun" || ls pnpm-lock.yaml && echo "pnpm" || ls yarn.lock && echo "yarn" || echo "npm"
+```
+
+Read `package.json` scripts to determine available commands.
+
+### 2. Run Verification Gates
+
+Execute in order, collecting results:
+
+| Gate | Commands (try in order) | Required |
+|------|------------------------|----------|
+| **Typecheck** | `pnpm typecheck`, `npm run typecheck`, `tsc --noEmit` | Yes |
+| **Tests** | `pnpm test`, `npm test`, `bun test` | Yes |
+| **Lint** | `pnpm lint`, `npm run lint`, `eslint .` | Yes |
+| **Build** | `pnpm build`, `npm run build`, `bun run build` | Yes |
+
+Run each gate. If a gate fails, continue to the next but record the failure.
+
+### 3. Report Results
+
+Format results clearly:
+
+```
+## Verification Report
+
+| Gate       | Status | Details          |
+|------------|--------|------------------|
+| Typecheck  | ✅/❌  | [error count]    |
+| Tests      | ✅/❌  | [pass/fail/skip] |
+| Lint       | ✅/❌  | [warning/error]  |
+| Build      | ✅/❌  | [output]         |
+
+### Overall: PASS / FAIL
+
+### Failures (if any)
+[Detailed error output for each failing gate]
+
+### Recommended Fixes
+1. [Fix suggestion]
+```
+
+### 4. Fix Mode (Optional)
+
+If the user asks to fix issues:
+- Fix typecheck errors first (most foundational)
+- Then lint errors
+- Then test failures
+- Re-run verification after fixes
+
+## Rules
+
+- ✅ ALWAYS run all 4 gates even if one fails
+- ✅ ALWAYS report detailed error output
+- ✅ ALWAYS suggest fixes for failures
+- ❌ NEVER auto-fix without user confirmation
+- ❌ NEVER report passing if any gate fails
+
+Now, running verification...

package/command/vision.md

@@ -0,0 +1,142 @@
+---
+description: Review UI implementation for design quality, accessibility, and responsiveness.
+agent: vision
+subtask: true
+---
+
+You are the **Vision Agent**. Execute the `/vision` command.
+
+## Your Task
+
+Review the UI implementation for design quality, accessibility, responsiveness, and visual consistency.
+
+## Process
+
+### 1. Gather Context
+
+- Identify changed/target UI files (components, styles, layouts)
+- Load spec.md if it has UI requirements
+- Check existing design system, tokens, component patterns
+- Read `package.json` for CSS framework/library in use
+
+### 2. Design Quality Review
+
+| Aspect | Check |
+|--------|-------|
+| **Typography** | Font choices, hierarchy, readability, line-height |
+| **Color** | Palette consistency, contrast, semantic usage |
+| **Spacing** | Consistent gaps, padding, margins (tokens?) |
+| **Layout** | Grid alignment, responsiveness, overflow handling |
+| **Motion** | Appropriate animations, `prefers-reduced-motion` |
+| **Consistency** | Components match existing patterns |
+
+### 3. Accessibility Audit
+
+| Check | Standard |
+|-------|----------|
+| Color contrast | WCAG AA (4.5:1 text, 3:1 large text) |
+| Focus indicators | Visible, styled, keyboard-navigable |
+| ARIA attributes | Labels, roles, states for interactive elements |
+| Semantic HTML | Proper elements (button, nav, main, aside) |
+| Screen readers | Alt text, aria-label, sr-only text |
+| Reduced motion | `prefers-reduced-motion` media query |
+| Touch targets | Minimum 44x44px on mobile |
+
+### 4. Responsive Review
+
+Check at minimum these breakpoints:
+- Mobile: 375px
+- Tablet: 768px
+- Desktop: 1024px
+- Wide: 1440px
+
+Look for:
+- Content overflow
+- Illegible text sizes
+- Touch target sizes
+- Layout breakage
+- Hidden content accessibility
+
+### 5. Implementation Quality
+
+| Aspect | Check |
+|--------|-------|
+| CSS architecture | Custom properties, naming conventions, specificity |
+| Component patterns | Props, composition, reusability |
+| Hard-coded values | Should use tokens/variables |
+| `!important` usage | Should be minimal/justified |
+| Unused styles | Dead CSS, redundant rules |
+| Performance | Layout thrashing, heavy animations, large images |
+
+### 6. Generate Report
+
+Save to `.opencode/memory/reviews/YYYY-MM-DD-ui-review.md`
+
+```markdown
+---
+type: UI
+date: YYYY-MM-DD
+reviewer: Vision Agent
+artifact: [paths reviewed]
+verdict: approved | changes_required | blocked
+---
+
+# UI Review: [Feature/Component]
+
+## Summary
+[2-3 sentence overview]
+
+## Design Quality
+| Aspect | Rating | Notes |
+|--------|--------|-------|
+| Typography | ✅/⚠️/❌ | [Details] |
+| Color | ✅/⚠️/❌ | [Details] |
+| Spacing | ✅/⚠️/❌ | [Details] |
+| Layout | ✅/⚠️/❌ | [Details] |
+| Motion | ✅/⚠️/❌ | [Details] |
+| Consistency | ✅/⚠️/❌ | [Details] |
+
+## Accessibility
+| Check | Pass | Notes |
+|-------|------|-------|
+| Contrast | ✅/❌ | [Ratio if failing] |
+| Focus | ✅/❌ | [Details] |
+| ARIA | ✅/❌ | [Missing attrs] |
+| Semantic HTML | ✅/❌ | [Details] |
+| Keyboard | ✅/❌ | [Details] |
+
+## Responsive
+| Breakpoint | Status | Issues |
+|------------|--------|--------|
+| Mobile 375px | ✅/❌ | [Issues] |
+| Tablet 768px | ✅/❌ | [Issues] |
+| Desktop 1024px | ✅/❌ | [Issues] |
+
+## Required Changes
+1. [Change with file:line reference]
+
+## Suggestions
+- [Optional improvement]
+
+## Verdict
+[Why this verdict]
+```
+
+## Verdict Rules
+
+| Verdict | Criteria |
+|---------|----------|
+| `approved` | No critical a11y issues, responsive OK, design consistent |
+| `changes_required` | A11y issues OR responsive breakage OR design inconsistency |
+| `blocked` | Critical a11y failures, major design system violations |
+
+## Rules
+
+- ✅ ALWAYS check accessibility (non-negotiable)
+- ✅ ALWAYS check responsive behavior
+- ✅ ALWAYS reference specific file:line locations
+- ✅ ALWAYS provide actionable fix suggestions
+- ❌ NEVER approve with accessibility failures
+- ❌ NEVER block on subjective style preferences alone
+
+Now, gathering UI files to review...

package/dist/agents/index.d.ts

@@ -0,0 +1,4 @@
+import type { AgentConfig } from "../types";
+export declare function loadAgents(): Record<string, AgentConfig>;
+export declare function getBuiltinAgents(): Record<string, AgentConfig>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAuC5C,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAoBxD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAE9D"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env bun
+// @bun
+
+// src/cli.ts
+import * as fs from "fs";
+import * as path from "path";
+var VERSION = "0.1.0";
+function getCwd() {
+  return process.cwd();
+}
+async function install() {
+  const cwd = getCwd();
+  const opencodeDir = path.join(cwd, ".opencode");
+  console.log(`\uD83D\uDE80 Installing CliKit...
+`);
+  if (!fs.existsSync(opencodeDir)) {
+    fs.mkdirSync(opencodeDir, { recursive: true });
+    console.log("\u2705 Created .opencode directory");
+  }
+  const indexPath = path.join(opencodeDir, "index.ts");
+  if (!fs.existsSync(indexPath)) {
+    fs.writeFileSync(indexPath, `import CliKitPlugin from "clikit-plugin";
+export default CliKitPlugin;
+`);
+    console.log("\u2705 Created .opencode/index.ts");
+  } else {
+    console.log("\u2139\uFE0F  .opencode/index.ts already exists");
+  }
+  const configPath = path.join(opencodeDir, "clikit.config.json");
+  if (!fs.existsSync(configPath)) {
+    fs.writeFileSync(configPath, JSON.stringify({
+      $schema: "https://unpkg.com/clikit-plugin/schema.json",
+      disabled_agents: [],
+      disabled_commands: [],
+      agents: {},
+      hooks: {}
+    }, null, 2));
+    console.log("\u2705 Created .opencode/clikit.config.json");
+  } else {
+    console.log("\u2139\uFE0F  .opencode/clikit.config.json already exists");
+  }
+  const memoryDir = path.join(opencodeDir, "memory");
+  const memorySubdirs = ["specs", "plans", "research", "reviews", "handoffs", "beads", "prds"];
+  for (const subdir of memorySubdirs) {
+    const dir = path.join(memoryDir, subdir);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+      console.log(`\u2705 Created .opencode/memory/${subdir}/`);
+    }
+  }
+  console.log(`
+\u2705 CliKit installed successfully!`);
+  console.log(`
+Next steps:`);
+  console.log("  1. Run: bun add -d clikit-plugin");
+  console.log("  2. Restart OpenCode");
+  console.log(`
+Available commands: /create, /start, /plan, /ship, /verify, /review, /debug, /pr`);
+}
+function help() {
+  console.log(`
+CliKit - OpenCode Plugin
+
+Usage:
+  clikit <command>
+
+Commands:
+  install     Install CliKit in current project
+  help        Show this help message
+  version     Show version
+
+Examples:
+  bunx clikit install
+`);
+}
+function version() {
+  console.log(`clikit-plugin v${VERSION}`);
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] || "help";
+  switch (command) {
+    case "install":
+    case "i":
+      await install();
+      break;
+    case "help":
+    case "-h":
+    case "--help":
+      help();
+      break;
+    case "version":
+    case "-v":
+    case "--version":
+      version();
+      break;
+    default:
+      console.error(`Unknown command: ${command}`);
+      help();
+      process.exit(1);
+  }
+}
+main().catch(console.error);