@orderful/droid 0.16.0 → 0.17.0

package/.claude/CLAUDE.md

@@ -1,22 +1,10 @@
 # CLAUDE.md
 
-Project instructions for Claude Code when working in this repository.
+@../AGENTS.md
 
-## Project Overview
+## Claude-Specific Instructions
 
-Droid is a TUI dashboard for managing AI tools. Each tool bundles related skills, commands, and agents. Installs to Claude Code (`~/.claude/`) and OpenCode (`~/.config/opencode/`).
-
-## Build & Test
-
-```bash
-bun run build      # Compile TypeScript and copy tools to dist/
-bun run dev        # Watch mode
-bun run test       # Run tests
-bun run lint       # Run ESLint
-bun run start      # Run the TUI (bun dist/bin/droid.js)
-```
-
-## Git Rules
+### Git Rules
 
 - **NEVER push directly to main**. Always create a branch and PR, even for small changes. The only exception is if the user explicitly says "push to main" in their message.
 - Branch naming: `tf/<ticket-or-description>` (e.g., `tf/tools-architecture`)
@@ -40,31 +28,3 @@ EOF
 - **patch**: Bug fixes, small improvements, internal refactors
 - **minor**: New features, new tools/skills/commands
 - **major**: Breaking changes
-
-## Structure
-
-```
-src/
-├── bin/           # CLI entry point
-├── commands/      # CLI commands (tui.tsx is the main dashboard)
-├── lib/           # Core logic (tools.ts, skills.ts, agents.ts, config.ts)
-└── tools/         # Bundled tools
-    └── {tool}/
-        ├── TOOL.yaml               # Tool manifest (version, includes, config)
-        ├── skills/{skill}/
-        │   ├── SKILL.md            # Frontmatter + instructions
-        │   └── references/         # Optional context files
-        ├── commands/
-        │   └── {command}.md        # Frontmatter + instructions
-        └── agents/
-            └── {agent}.md          # Frontmatter + instructions
-```
-
-## Key Patterns
-
-- Tools are the user-facing abstraction over skills, commands, and agents
-- `TOOL.yaml` defines tool-level metadata and lists what's included (just names)
-- Each artifact (.md file) owns its metadata in YAML frontmatter
-- Skills use folders (can have `references/` subdir), commands/agents are flat files
-- Install targets: `~/.claude/skills/`, `~/.claude/commands/`, `~/.claude/agents/`
-- TUI uses Ink (React for CLI)

package/AGENTS.md

@@ -0,0 +1,75 @@
+# AGENTS.md
+
+Project instructions for AI coding assistants.
+
+## Overview
+
+Droid is a TUI dashboard for managing AI tools. Each tool bundles related skills, commands, and agents. Installs to Claude Code (`~/.claude/`) and OpenCode (`~/.config/opencode/`).
+
+## Quick Start
+
+```bash
+bun install          # Install dependencies
+bun run build        # Compile TypeScript and copy tools to dist/
+bun run dev          # Watch mode
+bun run test         # Run tests
+bun run lint         # Run ESLint
+bun run start        # Run the TUI (bun dist/bin/droid.js)
+```
+
+## Structure
+
+```
+src/
+├── bin/           # CLI entry point
+├── commands/      # CLI commands
+│   ├── tui.tsx    # Main TUI dashboard (Ink/React)
+│   └── tui/       # TUI components, views, hooks
+├── lib/           # Core logic (tools.ts, skills.ts, agents.ts, config.ts)
+└── tools/         # Bundled tools
+    └── {tool}/
+        ├── TOOL.yaml               # Tool manifest (version, includes, config)
+        ├── skills/{skill}/
+        │   ├── SKILL.md            # Frontmatter + instructions
+        │   └── references/         # Optional context files
+        ├── commands/
+        │   └── {command}.md        # Frontmatter + instructions
+        └── agents/
+            └── {agent}.md          # Frontmatter + instructions
+```
+
+## Key Patterns
+
+- Tools are the user-facing abstraction over skills, commands, and agents
+- `TOOL.yaml` defines tool-level metadata and lists what's included (just names)
+- Each artifact (.md file) owns its metadata in YAML frontmatter
+- Skills use folders (can have `references/` subdir), commands/agents are flat files
+- Install targets: `~/.claude/skills/`, `~/.claude/commands/`, `~/.claude/agents/`
+
+## UI Libraries
+
+We use **two** terminal UI libraries for different purposes:
+
+| Library | Purpose | Used In |
+|---------|---------|---------|
+| **Ink** | Full React-based TUI dashboard | `tui.tsx`, `tui/components/`, `tui/views/` |
+| **Inquirer** | Simple CLI prompts (select, confirm, input) | `skills.ts`, `setup.ts`, `skill-config.ts` |
+
+**Why both?**
+- **Ink** is for the interactive dashboard—stateful, component-based, keyboard navigation
+- **Inquirer** is for quick sequential prompts ("Which tool?", "Configure now? y/n")
+
+Don't consolidate them. Using Ink for simple prompts would be overkill.
+
+## Do Not Touch
+
+- `.env` files and secrets
+- `node_modules/`, `dist/`
+- User config files (`~/.droid/`)
+
+## Code Style
+
+- TypeScript strict mode
+- Prefer `const` over `let`
+- Use Canadian/British spelling (behaviour, colour, favourite)
+- Use "allow list/deny list" not "whitelist/blacklist"

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @orderful/droid
 
+## 0.17.0
+
+### Minor Changes
+
+- [#86](https://github.com/Orderful/droid/pull/86) [`af57231`](https://github.com/Orderful/droid/commit/af5723101f301dc7d5357558325bd9d6997259f7) Thanks [@frytyler](https://github.com/frytyler)! - Add TUI testing infrastructure with ink-testing-library for component tests and Playwright + ttyd for E2E visual testing
+
+## 0.16.1
+
+### Patch Changes
+
+- [#83](https://github.com/Orderful/droid/pull/83) [`023660a`](https://github.com/Orderful/droid/commit/023660a951ae1674989ae69d16b29e432a198300) Thanks [@frytyler](https://github.com/frytyler)! - Add AGENTS.md standard for cross-AI-tool compatibility
+
+  Introduces AGENTS.md at repo root with shared project instructions that work across Claude Code, Cursor, Copilot, and other AI coding assistants. CLAUDE.md now imports AGENTS.md and only contains Claude-specific instructions (git rules, changesets).
+
+- [#85](https://github.com/Orderful/droid/pull/85) [`d5a1637`](https://github.com/Orderful/droid/commit/d5a1637974805ffb35d93726ec56db4580c556b5) Thanks [@frytyler](https://github.com/frytyler)! - Fix ESM module resolution for npm global installs
+
+  Switches build from tsc to esbuild bundling. This fixes the ERR_MODULE_NOT_FOUND error when running droid after npm install -g, caused by Node ESM requiring explicit .js extensions that TypeScript doesn't add.
+
 ## 0.16.0
 
 ### Minor Changes

package/bun.lock

@@ -18,6 +18,7 @@
       "devDependencies": {
         "@changesets/changelog-github": "^0.5.2",
         "@changesets/cli": "^2.29.8",
+        "@playwright/test": "^1.57.0",
         "@types/bun": "latest",
         "@types/ink-text-input": "^2.0.5",
         "@types/inquirer": "^9.0.7",
@@ -27,6 +28,7 @@
         "@typescript-eslint/parser": "^8.49.0",
         "esbuild": "^0.27.1",
         "eslint": "^8.57.0",
+        "ink-testing-library": "^4.0.0",
         "prettier": "^3.2.5",
         "typescript": "^5.4.2",
       },
@@ -155,6 +157,8 @@
 
     "@nodelib/fs.walk": ["@nodelib/fs.walk@1.2.8", "", { "dependencies": { "@nodelib/fs.scandir": "2.1.5", "fastq": "^1.6.0" } }, "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg=="],
 
+    "@playwright/test": ["@playwright/test@1.57.0", "", { "dependencies": { "playwright": "1.57.0" }, "bin": { "playwright": "cli.js" } }, "sha512-6TyEnHgd6SArQO8UO2OMTxshln3QMWBtPGrOCgs3wVEmQmwyuNtB10IZMfmYDE0riwNR1cu4q+pPcxMVtaG3TA=="],
+
     "@types/bun": ["@types/bun@1.3.4", "", { "dependencies": { "bun-types": "1.3.4" } }, "sha512-EEPTKXHP+zKGPkhRLv+HI0UEX8/o+65hqARxLy8Ov5rIxMBPNTjeZww00CIihrIQGEQBYg+0roO5qOnS/7boGA=="],
 
     "@types/ink": ["@types/ink@0.5.2", "", { "dependencies": { "@types/node": "*", "@types/prop-types": "*" } }, "sha512-yEuhWTRMXJkIWiaM58c5kuRot5HFccv9kjjgy0fBZG0+tYb+sMBaxHNPVqyZXspGGlmwDOQ1d3BsygWpWlW17w=="],
@@ -341,6 +345,8 @@
 
     "fs.realpath": ["fs.realpath@1.0.0", "", {}, "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw=="],
 
+    "fsevents": ["fsevents@2.3.2", "", { "os": "darwin" }, "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA=="],
+
     "get-east-asian-width": ["get-east-asian-width@1.4.0", "", {}, "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q=="],
 
     "glob": ["glob@7.2.3", "", { "dependencies": { "fs.realpath": "^1.0.0", "inflight": "^1.0.4", "inherits": "2", "minimatch": "^3.1.1", "once": "^1.3.0", "path-is-absolute": "^1.0.0" } }, "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q=="],
@@ -379,6 +385,8 @@
 
     "ink-select-input": ["ink-select-input@6.2.0", "", { "dependencies": { "figures": "^6.1.0", "to-rotated": "^1.0.0" }, "peerDependencies": { "ink": ">=5.0.0", "react": ">=18.0.0" } }, "sha512-304fZXxkpYxJ9si5lxRCaX01GNlmPBgOZumXXRnPYbHW/iI31cgQynqk2tRypGLOF1cMIwPUzL2LSm6q4I5rQQ=="],
 
+    "ink-testing-library": ["ink-testing-library@4.0.0", "", { "peerDependencies": { "@types/react": ">=18.0.0" }, "optionalPeers": ["@types/react"] }, "sha512-yF92kj3pmBvk7oKbSq5vEALO//o7Z9Ck/OaLNlkzXNeYdwfpxMQkSowGTFUCS5MSu9bWfSZMewGpp7bFc66D7Q=="],
+
     "ink-text-input": ["ink-text-input@6.0.0", "", { "dependencies": { "chalk": "^5.3.0", "type-fest": "^4.18.2" }, "peerDependencies": { "ink": ">=5", "react": ">=18" } }, "sha512-Fw64n7Yha5deb1rHY137zHTAbSTNelUKuB5Kkk2HACXEtwIHBCf9OH2tP/LQ9fRYTl1F0dZgbW0zPnZk6FA9Lw=="],
 
     "inquirer": ["inquirer@9.3.8", "", { "dependencies": { "@inquirer/external-editor": "^1.0.2", "@inquirer/figures": "^1.0.3", "ansi-escapes": "^4.3.2", "cli-width": "^4.1.0", "mute-stream": "1.0.0", "ora": "^5.4.1", "run-async": "^3.0.0", "rxjs": "^7.8.1", "string-width": "^4.2.3", "strip-ansi": "^6.0.1", "wrap-ansi": "^6.2.0", "yoctocolors-cjs": "^2.1.2" } }, "sha512-pFGGdaHrmRKMh4WoDDSowddgjT1Vkl90atobmTeSmcPGdYiwikch/m/Ef5wRaiamHejtw0cUUMMerzDUXCci2w=="],
@@ -487,6 +495,10 @@
 
     "pify": ["pify@4.0.1", "", {}, "sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g=="],
 
+    "playwright": ["playwright@1.57.0", "", { "dependencies": { "playwright-core": "1.57.0" }, "optionalDependencies": { "fsevents": "2.3.2" }, "bin": { "playwright": "cli.js" } }, "sha512-ilYQj1s8sr2ppEJ2YVadYBN0Mb3mdo9J0wQ+UuDhzYqURwSoW4n1Xs5vs7ORwgDGmyEh33tRMeS8KhdkMoLXQw=="],
+
+    "playwright-core": ["playwright-core@1.57.0", "", { "bin": { "playwright-core": "cli.js" } }, "sha512-agTcKlMw/mjBWOnD6kFZttAAGHgi/Nw0CZ2o6JqWSbMlI219lAFLZZCyqByTsvVAJq5XA5H8cA6PrvBRpBWEuQ=="],
+
     "prelude-ls": ["prelude-ls@1.2.1", "", {}, "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g=="],
 
     "prettier": ["prettier@3.7.4", "", { "bin": "bin/prettier.cjs" }, "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA=="],