droid-mode 0.0.13 → 0.1.0

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/Gitmaxd/droid-mode/main/assets/droid-mode-readme.webp" alt="Droid Mode" width="600" />
+<img src="https://res.cloudinary.com/ds7w5yhjh/image/upload/v1767480336/droid-mode-readme_ymx61e.webp" alt="Droid Mode" width="600" />
 
 **Progressive MCP for AI Agents. Zero Context Bloat.**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-mode",
-  "version": "0.0.13",
+  "version": "0.1.0",
   "description": "Progressive Code-Mode MCP integration for Factory.ai Droid - access MCP tools without context bloat",
   "type": "module",
   "main": "dist/cli.js",

package/templates/skills/droid-mode/SKILL.md

@@ -14,8 +14,23 @@ Access MCP tools **without loading them into context**. Progressive discovery
 - **Procedural workflows** (filter/join/iterate between tool calls)
 - **Auditability** (explicit scripts + saved artifacts)
 
+## Requirements
+
+| Requirement | Details |
+|-------------|---------|
+| Node.js | >= 18.0.0 |
+| Permissions | `bin/dm` must be executable (`chmod +x`) |
+| MCP Config | Valid `mcp.json` with at least one server |
+
 ## Commands
 
+**IMPORTANT**: The `dm` script must be called with full path. **Try workspace first**:
+
+1. **Workspace** (try first): `./.factory/skills/droid-mode/bin/dm`
+2. **Personal** (fallback): `~/.factory/skills/droid-mode/bin/dm`
+
+If workspace path fails with "not found", use personal path.
+
 | Level | Command | Purpose |
 |-------|---------|---------|
 | 1 | `dm servers` | Discover available MCP servers |
@@ -44,10 +59,49 @@ All droid-mode commands are safe to rerun:
 
 No cleanup required between invocations.
 
+## Tool Execution Options
+
+**Option 1: Direct MCP Call (Single Tool)**
+
+```bash
+# 1. Hydrate the tool schema
+dm hydrate search_documents --server contextrepo
+
+# 2. Call via MCP server directly (tool now available in context)
+```
+
+No workflow file needed for single tool calls.
+
+**Option 2: Procedural Workflow (Multiple Tools)**
+
+For loops, conditionals, or chaining multiple calls, use `dm run`:
+
+| Input | Flag | Required | Example |
+|-------|------|----------|---------|
+| Workflow file | `--workflow` | Yes | `workflow.js` |
+| Tool list | `--tools` | Yes | `search,query` |
+| Server name | `--server` | If multiple servers | `contextrepo` |
+
+## Naming Convention
+
+Tool names use **snake_case** in CLI flags but **camelCase** in workflow code:
+
+| Context | Format | Example |
+|---------|--------|---------|
+| CLI `--tools` flag | snake_case | `--tools list_collections` |
+| Workflow `t.` accessor | camelCase | `t.listCollections({})` |
+
+**Conversion rule**: Remove underscores, capitalize each word after first.
+- `list_collections` → `listCollections`
+- `search_documents` → `searchDocuments`
+- `get_file_content` → `getFileContent`
+
 ## Workflow Example
 
 ```js
 // workflow.js
+// Note: Tool name converts from snake_case to camelCase
+// search_documents → t.searchDocuments()
 workflow = async () => {
   const docs = await t.searchDocuments({ query: "PRD", limit: 5 })
   return docs.results.map(d => d.id)
@@ -55,12 +109,24 @@ workflow = async () => {
 ```
 
 ```bash
-dm run --server contextrepo --tools search_documents --workflow workflow.js
+# Workspace skill
+./.factory/skills/droid-mode/bin/dm run --server contextrepo --tools search_documents --workflow workflow.js
+
+# Personal skill
+~/.factory/skills/droid-mode/bin/dm run --server contextrepo --tools search_documents --workflow workflow.js
 ```
 
 ## Verification
 
-After using droid-mode, verify:
+After using droid-mode, verify (using full path to `dm` for your installation):
+
+```bash
+# Workspace skill
+./.factory/skills/droid-mode/bin/dm doctor --server X
+
+# Personal skill
+~/.factory/skills/droid-mode/bin/dm doctor --server X
+```
 
 - [ ] `dm doctor --server X` passes (connection works)
 - [ ] Artifacts exist in `.factory/droid-mode/` (cache, hydrated, runs)
@@ -86,12 +152,18 @@ The skill completes successfully when these artifacts exist:
 | TypeScript types | `.factory/droid-mode/hydrated/<server>/<ts>/types.d.ts` | Generated type definitions |
 | Execution trace | `.factory/droid-mode/runs/<server>/<ts>/run.json` | `{ error: false, result: ... }` |
 
-Verify with: `dm doctor --server X` (should exit 0)
+Verify with the appropriate full path for your installation:
+- Workspace: `./.factory/skills/droid-mode/bin/dm doctor --server X`
+- Personal: `~/.factory/skills/droid-mode/bin/dm doctor --server X`
+
+Command should exit 0.
 
 ## Fallbacks
 
 | Issue | Resolution |
 |-------|------------|
+| Node.js version error | Upgrade to Node.js >= 18.0.0 |
+| Permission denied on dm | Run `chmod +x bin/dm` in skill directory |
 | Server not found | Run `dm servers` to list available servers |
 | Connection timeout | Check `mcp.json` config, run `dm doctor` |
 | Tool not found | Run `dm index --server X` to refresh cache |
@@ -121,6 +193,27 @@ All JSON artifacts are machine-parseable for downstream skill chaining. Workflow
 - `examples/hooks/` — PreToolUse hook examples
 - `README.md` — full documentation
 
+## Quick Reference
+
+**Find dm**: Always at `./.factory/skills/droid-mode/bin/dm` (workspace) or `~/.factory/skills/droid-mode/bin/dm` (personal)
+
+**Minimal workflow** (using workspace path):
+```bash
+# 1. Discover tools (snake_case names)
+./.factory/skills/droid-mode/bin/dm index --server X
+
+# 2. Hydrate (use snake_case)
+./.factory/skills/droid-mode/bin/dm hydrate tool_name --server X
+
+# 3. Execute (use camelCase in workflow)
+echo 'workflow = async () => await t.toolName({})' > /tmp/wf.js
+./.factory/skills/droid-mode/bin/dm run --server X --tools tool_name --workflow /tmp/wf.js
+```
+
+For personal skill, replace `./.factory/` with `~/.factory/`.
+
+**Common mistake**: Using `t.tool_name()` instead of `t.toolName()` in workflows.
+
 ## References
 
 For project-specific conventions, see: