droid-mode 0.0.2 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -35,6 +35,15 @@ Servers with `disabled: true` in `mcp.json` are **fully available** to droid-mod
|
|
|
35
35
|
|
|
36
36
|
This is the entire point of the skill.
|
|
37
37
|
|
|
38
|
+
## Idempotency
|
|
39
|
+
|
|
40
|
+
All droid-mode commands are safe to rerun:
|
|
41
|
+
- `dm servers` / `dm index` — read-only discovery
|
|
42
|
+
- `dm hydrate` — overwrites previous hydration (timestamped)
|
|
43
|
+
- `dm run` — each run creates a new timestamped trace
|
|
44
|
+
|
|
45
|
+
No cleanup required between invocations.
|
|
46
|
+
|
|
38
47
|
## Workflow Example
|
|
39
48
|
|
|
40
49
|
```js
|
|
@@ -57,13 +66,27 @@ After using droid-mode, verify:
|
|
|
57
66
|
- [ ] Artifacts exist in `.factory/droid-mode/` (cache, hydrated, runs)
|
|
58
67
|
- [ ] Workflow trace shows no errors (`runs/<server>/<ts>/run.json`)
|
|
59
68
|
|
|
69
|
+
## Proof Artifacts
|
|
70
|
+
|
|
71
|
+
After completing a workflow, produce evidence:
|
|
72
|
+
|
|
73
|
+
- **Discovery proof**: Screenshot or paste of `dm index --server X` output
|
|
74
|
+
- **Hydration proof**: Confirm `types.d.ts` exists and compiles (`tsc --noEmit`)
|
|
75
|
+
- **Execution proof**: Link to `run.json` trace showing `error: false`
|
|
76
|
+
- **For PRs**: Include trace file or summary in PR description
|
|
77
|
+
|
|
60
78
|
## Success Criteria
|
|
61
79
|
|
|
62
|
-
The skill completes successfully when:
|
|
80
|
+
The skill completes successfully when these artifacts exist:
|
|
63
81
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
82
|
+
| Artifact | Path | Content |
|
|
83
|
+
|----------|------|---------|
|
|
84
|
+
| Tool cache | `.factory/droid-mode/cache/<server>/tools.json` | Array of tool objects |
|
|
85
|
+
| Hydrated schemas | `.factory/droid-mode/hydrated/<server>/<ts>/schemas.json` | Full JSON schemas |
|
|
86
|
+
| TypeScript types | `.factory/droid-mode/hydrated/<server>/<ts>/types.d.ts` | Generated type definitions |
|
|
87
|
+
| Execution trace | `.factory/droid-mode/runs/<server>/<ts>/run.json` | `{ error: false, result: ... }` |
|
|
88
|
+
|
|
89
|
+
Verify with: `dm doctor --server X` (should exit 0)
|
|
67
90
|
|
|
68
91
|
## Fallbacks
|
|
69
92
|
|
|
@@ -88,6 +111,8 @@ All outputs written to `.factory/droid-mode/`:
|
|
|
88
111
|
- `hydrated/<server>/<ts>/` — schemas + types
|
|
89
112
|
- `runs/<server>/<ts>/run.json` — execution trace
|
|
90
113
|
|
|
114
|
+
All JSON artifacts are machine-parseable for downstream skill chaining. Workflows can read `tools.json` or `run.json` to inform subsequent steps.
|
|
115
|
+
|
|
91
116
|
## Supporting Files
|
|
92
117
|
|
|
93
118
|
- `bin/dm` — CLI entry point
|
|
@@ -95,3 +120,14 @@ All outputs written to `.factory/droid-mode/`:
|
|
|
95
120
|
- `examples/workflows/` — sample workflow files
|
|
96
121
|
- `examples/hooks/` — PreToolUse hook examples
|
|
97
122
|
- `README.md` — full documentation
|
|
123
|
+
|
|
124
|
+
## References
|
|
125
|
+
|
|
126
|
+
For project-specific conventions, see:
|
|
127
|
+
- `AGENTS.md` — project-wide agent guidance (if present)
|
|
128
|
+
- `mcp.json` — MCP server configuration
|
|
129
|
+
- `.factory/skills/*/SKILL.md` — related skills that may chain with droid-mode
|
|
130
|
+
|
|
131
|
+
For droid-mode internals:
|
|
132
|
+
- `README.md` — full CLI documentation
|
|
133
|
+
- `examples/` — sample workflows and hooks
|