@orderful/droid 0.10.4 → 0.11.0

package/src/lib/types.ts

@@ -1,8 +1,14 @@
-export enum AITool {
+export enum Platform {
   ClaudeCode = 'claude-code',
   OpenCode = 'opencode',
 }
 
+// Backwards compatibility alias - using different names to avoid redeclare error
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const AIToolValue = Platform;
+export { AIToolValue as AITool };
+export type AITool = Platform;
+
 /**
  * Get the AI's mention tag
  * Always @droid - consistent branding regardless of underlying AI tool
@@ -32,14 +38,44 @@ export enum ConfigOptionType {
   Select = 'select',
 }
 
+export interface PlatformConfig {
+  tools: Record<string, InstalledSkill>;
+}
+
 export interface DroidConfig {
-  ai_tool: AITool;
+  platform: Platform;
+  user_mention: string;
+  output_preference: OutputPreference;
+  git_username: string;
+  platforms: Record<string, PlatformConfig>;
+}
+
+// Legacy config structure for migration
+export interface LegacyDroidConfig {
+  ai_tool: Platform;
   user_mention: string;
   output_preference: OutputPreference;
   git_username: string;
   skills: Record<string, InstalledSkill>;
 }
 
+/**
+ * Get installed tools for the current platform
+ */
+export function getPlatformTools(config: DroidConfig): Record<string, InstalledSkill> {
+  return config.platforms[config.platform]?.tools ?? {};
+}
+
+/**
+ * Set installed tools for the current platform
+ */
+export function setPlatformTools(config: DroidConfig, tools: Record<string, InstalledSkill>): void {
+  if (!config.platforms[config.platform]) {
+    config.platforms[config.platform] = { tools: {} };
+  }
+  config.platforms[config.platform].tools = tools;
+}
+
 export interface InstalledSkill {
   version: string;
   installed_at: string;
@@ -77,3 +113,28 @@ export interface ConfigOption {
 export interface SkillOverrides {
   [key: string]: string | boolean | number;
 }
+
+/**
+ * Tool manifest structure (TOOL.yaml)
+ */
+export interface ToolSkillInclude {
+  name: string;
+  required: boolean;
+  description?: string;
+}
+
+export interface ToolIncludes {
+  skills: ToolSkillInclude[];
+  commands: string[];
+  agents: string[];
+}
+
+export interface ToolManifest {
+  name: string;
+  description: string;
+  version: string;
+  status?: SkillStatus;
+  includes: ToolIncludes;
+  dependencies?: string[];
+  config_schema?: Record<string, ConfigOption>;
+}

package/src/tools/brain/TOOL.yaml

@@ -0,0 +1,27 @@
+name: brain
+description: "Collaborative scratchpad for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
+version: 0.2.0
+status: beta
+
+includes:
+  skills:
+    - name: brain
+      required: true
+    - name: brain-obsidian
+      required: false
+      description: "Obsidian vault integration with YAML frontmatter and wikilinks"
+  commands:
+    - brain
+    - scratchpad
+  agents: []
+
+dependencies: []
+
+config_schema:
+  brain_dir:
+    type: string
+    description: Directory for brain docs (default varies by platform)
+  inbox_folder:
+    type: string
+    description: Subfolder for new docs (empty = flat structure)
+    default: ""

package/src/tools/coach/TOOL.yaml

@@ -0,0 +1,21 @@
+name: coach
+description: "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions."
+version: 0.1.0
+status: beta
+
+includes:
+  skills:
+    - name: coach
+      required: true
+  commands:
+    - coach
+  agents: []
+
+dependencies:
+  - comments
+
+config_schema:
+  scaffold_verbosity:
+    type: string
+    description: "How detailed scaffold hints should be: minimal, medium, detailed"
+    default: "medium"

package/src/tools/code-review/TOOL.yaml

@@ -0,0 +1,18 @@
+name: code-review
+description: "Comprehensive code review using specialized agents. Reviews PRs, staged changes, branches, or specific files with confidence scoring."
+version: 0.1.0
+status: alpha
+
+includes:
+  skills:
+    - name: code-review
+      required: true
+  commands:
+    - code-review
+  agents:
+    - edi-standards-reviewer
+    - error-handling-reviewer
+    - test-coverage-analyzer
+    - type-reviewer
+
+dependencies: []

package/src/{skills → tools}/code-review/commands/code-review.md

@@ -17,29 +17,46 @@ Review target: $ARGUMENTS
 /code-review path/to/file   # Review specific file
 ```
 
+### Step 0: Check for Brain Integration
+
+**If the `brain` skill is installed** (check for `~/.claude/skills/brain/SKILL.md` or `~/.config/opencode/skills/brain/SKILL.md`):
+
+Ask the user: **"Would you like the review results saved to a `/brain review` doc?"**
+
+- If yes: Create a brain review doc at the start using `/brain review {PR title or branch name}`
+- The final report will be written to the brain doc instead of just displayed
+- This allows for async discussion via `@droid`/`@{user}` comments
+
+If brain skill is not installed or user declines, proceed with normal terminal output.
+
 ### Step 1: Determine Review Scope
 
 Parse the argument to determine what to review:
 
 **If argument starts with `#` or is a number (e.g., `#123` or `123`):**
+
 - This is a PR number
 - Fetch PR details: `gh pr view $PR_NUMBER --json title,body,baseRefName,headRefName,files`
 - Get the diff: `gh pr diff $PR_NUMBER`
 - Note the PR author and description for context
 
 **If argument is `staged` or empty:**
+
 - Review staged changes: `git diff --cached`
 
 **If argument is `branch`:**
+
 - Review current branch vs main: `git diff origin/main...HEAD`
 
 **If argument is a file path:**
+
 - Review specific file: `git diff HEAD -- $FILE_PATH`
 - If no changes, review the entire file for issues
 
 ### Step 2: Gather Context
 
 For PR reviews, also fetch:
+
 - PR description (may contain context about the change)
 - Linked issues: `gh pr view $PR_NUMBER --json body` and parse for #issue refs
 - Changed files list for targeted agent assignment
@@ -54,6 +71,7 @@ Launch these agents in parallel using the Task tool with `run_in_background: tru
 4. **type-reviewer**: Type design, interface contracts
 
 Pass each agent:
+
 1. The diff content
 2. The full file content for changed files (for context)
 3. PR description if available
@@ -70,15 +88,18 @@ Filter out issues with confidence < 80.
 Compile findings into a prioritized report:
 
 **PR #123: "Add partnership billing events"** (if reviewing a PR)
-*Author: @username*
+_Author: @username_
 
 **Critical** (security, data loss, billing errors)
+
 - `file.ts:42` - Issue description
 
 **Important** (bugs, missing tests, type issues)
+
 - `file.ts:67` - Issue description
 
 **Suggestions** (style, readability)
+
 - `file.ts:89` - Issue description
 
 **Summary**: X critical, Y important, Z suggestions across N files.
@@ -86,6 +107,7 @@ Compile findings into a prioritized report:
 ### Step 6: Offer Actions (for PRs)
 
 After presenting the report, offer:
+
 - "Would you like me to post this as a PR comment?"
 - "Should I suggest fixes for any of these issues?"
 - "Want me to check out this branch and fix the critical issues?"

package/src/tools/comments/TOOL.yaml

@@ -0,0 +1,27 @@
+name: comments
+description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Ideal for code review notes and async collaboration."
+version: 0.2.2
+status: beta
+
+includes:
+  skills:
+    - name: comments
+      required: true
+  commands:
+    - comments
+  agents: []
+
+dependencies: []
+
+config_schema:
+  user_mention:
+    type: string
+    description: Override the global user mention for this skill
+  ai_mentions:
+    type: string
+    description: Additional AI mentions to recognize (comma-separated)
+    default: ""
+  preserve_comments:
+    type: boolean
+    description: Keep original comments after addressing (vs removing them)
+    default: true

package/src/tools/project/TOOL.yaml

@@ -0,0 +1,26 @@
+name: project
+description: "Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features."
+version: 0.1.2
+status: beta
+
+includes:
+  skills:
+    - name: project
+      required: true
+  commands:
+    - project
+  agents: []
+
+dependencies: []
+
+config_schema:
+  projects_dir:
+    type: string
+    description: Path to projects directory (default varies by platform)
+  preset:
+    type: select
+    description: Output format for templates
+    default: "markdown"
+    options:
+      - markdown
+      - obsidian

package/dist/agents/README.md

@@ -1,137 +0,0 @@
-# Contributing Agents
-
-Agents are specialized AI personas with specific expertise or roles. They augment the AI's capabilities for particular tasks.
-
-## Directory Structure
-
-Each agent is a directory containing:
-
-```
-agents/
-└── my-agent/
-    ├── AGENT.yaml      # Required: Manifest with metadata and persona
-    └── AGENT.md        # Required: Documentation for users
-```
-
-## AGENT.yaml (Manifest)
-
-```yaml
-name: my-agent                          # Must match directory name
-description: Short description          # Shown in TUI and listings
-version: 1.0.0                          # Semver
-status: alpha                           # alpha | beta | stable (optional)
-
-# Agent type (required)
-mode: subagent                          # primary | subagent | all
-
-# Tools this agent can use (optional)
-tools:
-  - Read
-  - Glob
-  - Grep
-  - Bash
-
-# Suggested triggers - phrases that might invoke this agent
-triggers:
-  - "review my code"
-  - "check for bugs"
-
-# Persona - system prompt additions for this agent (used if AGENT.md is minimal)
-persona: |
-  You are a specialized assistant focused on...
-
-  Your priorities are:
-  1. First priority
-  2. Second priority
-
-  Always be specific and constructive.
-```
-
-### Agent Modes
-
-- **`primary`** - Main agents you interact with directly. Cycle through them with Tab key.
-- **`subagent`** - Specialized helpers invoked via @mention (e.g., `@code-reviewer check this`) or by primary agents.
-- **`all`** - Agent works as both primary and subagent.
-
-## AGENT.md (Documentation)
-
-The AGENT.md file documents the agent for users:
-
-```markdown
----
-name: my-agent
-description: Short description (must match AGENT.yaml)
----
-
-# My Agent
-
-Description of what this agent does and when to use it.
-
-## What It Does
-
-- Bullet points of capabilities
-- What it focuses on
-- What it ignores
-
-## Usage
-
-Examples of how to invoke or use this agent.
-
-## Output Format
-
-Description of how the agent formats its responses.
-```
-
-## Example Agent
-
-See `code-reviewer/` for a complete example:
-
-- Reviews code for bugs, security issues, style
-- Categorizes issues by severity (critical/warning/suggestion)
-- References specific file and line numbers
-
-## Ideas for Agents
-
-- **test-writer** - Generates unit tests for code
-- **doc-writer** - Writes documentation and comments
-- **refactorer** - Suggests and applies refactoring patterns
-- **security-auditor** - Deep security analysis
-- **performance-optimizer** - Identifies performance bottlenecks
-
-## Installation
-
-When you install an agent via the TUI, droid:
-
-1. Reads `AGENT.yaml` for metadata (name, description, tools)
-2. Reads `AGENT.md` for the agent's instructions/persona
-3. Combines them into a single `.md` file with frontmatter
-4. Writes to `~/.claude/agents/{name}.md`
-
-The installed format matches what Claude Code expects:
-
-```markdown
----
-name: my-agent
-description: Short description
-tools: Read, Glob, Grep, Bash
----
-
-[Content from AGENT.md]
-```
-
-## Testing Your Agent
-
-1. Run `npm run build` to compile
-2. Run `droid` to open the TUI
-3. Navigate to Agents tab
-4. Verify your agent appears with correct metadata
-5. Install and verify it appears in `~/.claude/agents/`
-
-## Checklist
-
-- [ ] `AGENT.yaml` has all required fields (name, description, version, mode)
-- [ ] `AGENT.md` contains the agent's instructions/persona
-- [ ] Name matches directory name
-- [ ] Description is clear and concise
-- [ ] Mode is appropriate (subagent for specialized tasks, primary for main assistants)
-- [ ] Tools list only includes what the agent needs

package/src/agents/README.md

@@ -1,137 +0,0 @@
-# Contributing Agents
-
-Agents are specialized AI personas with specific expertise or roles. They augment the AI's capabilities for particular tasks.
-
-## Directory Structure
-
-Each agent is a directory containing:
-
-```
-agents/
-└── my-agent/
-    ├── AGENT.yaml      # Required: Manifest with metadata and persona
-    └── AGENT.md        # Required: Documentation for users
-```
-
-## AGENT.yaml (Manifest)
-
-```yaml
-name: my-agent                          # Must match directory name
-description: Short description          # Shown in TUI and listings
-version: 1.0.0                          # Semver
-status: alpha                           # alpha | beta | stable (optional)
-
-# Agent type (required)
-mode: subagent                          # primary | subagent | all
-
-# Tools this agent can use (optional)
-tools:
-  - Read
-  - Glob
-  - Grep
-  - Bash
-
-# Suggested triggers - phrases that might invoke this agent
-triggers:
-  - "review my code"
-  - "check for bugs"
-
-# Persona - system prompt additions for this agent (used if AGENT.md is minimal)
-persona: |
-  You are a specialized assistant focused on...
-
-  Your priorities are:
-  1. First priority
-  2. Second priority
-
-  Always be specific and constructive.
-```
-
-### Agent Modes
-
-- **`primary`** - Main agents you interact with directly. Cycle through them with Tab key.
-- **`subagent`** - Specialized helpers invoked via @mention (e.g., `@code-reviewer check this`) or by primary agents.
-- **`all`** - Agent works as both primary and subagent.
-
-## AGENT.md (Documentation)
-
-The AGENT.md file documents the agent for users:
-
-```markdown
----
-name: my-agent
-description: Short description (must match AGENT.yaml)
----
-
-# My Agent
-
-Description of what this agent does and when to use it.
-
-## What It Does
-
-- Bullet points of capabilities
-- What it focuses on
-- What it ignores
-
-## Usage
-
-Examples of how to invoke or use this agent.
-
-## Output Format
-
-Description of how the agent formats its responses.
-```
-
-## Example Agent
-
-See `code-reviewer/` for a complete example:
-
-- Reviews code for bugs, security issues, style
-- Categorizes issues by severity (critical/warning/suggestion)
-- References specific file and line numbers
-
-## Ideas for Agents
-
-- **test-writer** - Generates unit tests for code
-- **doc-writer** - Writes documentation and comments
-- **refactorer** - Suggests and applies refactoring patterns
-- **security-auditor** - Deep security analysis
-- **performance-optimizer** - Identifies performance bottlenecks
-
-## Installation
-
-When you install an agent via the TUI, droid:
-
-1. Reads `AGENT.yaml` for metadata (name, description, tools)
-2. Reads `AGENT.md` for the agent's instructions/persona
-3. Combines them into a single `.md` file with frontmatter
-4. Writes to `~/.claude/agents/{name}.md`
-
-The installed format matches what Claude Code expects:
-
-```markdown
----
-name: my-agent
-description: Short description
-tools: Read, Glob, Grep, Bash
----
-
-[Content from AGENT.md]
-```
-
-## Testing Your Agent
-
-1. Run `npm run build` to compile
-2. Run `droid` to open the TUI
-3. Navigate to Agents tab
-4. Verify your agent appears with correct metadata
-5. Install and verify it appears in `~/.claude/agents/`
-
-## Checklist
-
-- [ ] `AGENT.yaml` has all required fields (name, description, version, mode)
-- [ ] `AGENT.md` contains the agent's instructions/persona
-- [ ] Name matches directory name
-- [ ] Description is clear and concise
-- [ ] Mode is appropriate (subagent for specialized tasks, primary for main assistants)
-- [ ] Tools list only includes what the agent needs