@deeeed/metamask-harness 0.16.0 → 0.17.0
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/CHANGELOG.md +16 -0
- package/README.md +4 -1
- package/dist/cli.js +2 -0
- package/dist/command-contract.js +441 -0
- package/dist/command-journal.js +225 -0
- package/dist/commands/call.js +35 -17
- package/dist/commands/check.js +9 -3
- package/dist/commands/device-target.js +27 -12
- package/dist/commands/doctor.js +19 -6
- package/dist/commands/fixtures.js +1 -1
- package/dist/commands/last.js +52 -0
- package/dist/commands/launch/index.js +156 -59
- package/dist/commands/manifest.js +109 -12
- package/dist/commands/parse-args.js +1 -0
- package/dist/commands/provision.js +10 -3
- package/dist/commands/run-engine.js +26 -10
- package/dist/commands/run.js +194 -39
- package/dist/commands/shared.js +11 -1
- package/dist/commands/status.js +1 -1
- package/dist/commands/stop.js +7 -2
- package/dist/harness.js +16 -4
- package/dist/json-stream.js +57 -0
- package/dist/mm-harness-cli.js +110 -3
- package/dist/runner.js +32 -1
- package/docs/CLI-ERGONOMICS-AUDIT.md +32 -0
- package/docs/CLI-ERGONOMICS-HUMAN-QA.md +104 -0
- package/docs/CLI-SPEC.md +58 -18
- package/docs/MENTAL-MODEL.md +1 -1
- package/docs/UX-PRINCIPLES.md +2 -0
- package/package.json +2 -1
package/docs/MENTAL-MODEL.md
CHANGED
|
@@ -189,7 +189,7 @@ The composition loop: `actions --json` → `call <action>` (try one via real eng
|
|
|
189
189
|
| | |
|
|
190
190
|
|---|---|
|
|
191
191
|
| **Human form** | `mm-harness actions --adapter mobile` · `mm-harness call unlock` · `mm-harness flows` |
|
|
192
|
-
| **Agent PRIMARY** | `mm-harness actions --adapter mobile --
|
|
192
|
+
| **Agent PRIMARY** | `mm-harness actions <task-term> --adapter mobile --json`, then one focused `--action <name>` schema; use `--categories` only without a useful term |
|
|
193
193
|
| | `mm-harness call metamask.perps.read_positions --arg symbol=BTC --adapter core --json` → `{ action, resolvedAction, args, trace, evidence, recovered, mutations, exitCode, schemaVersion }` (same shape as `run --json`, one-node subset) |
|
|
194
194
|
| | `mm-harness flows --json` → `{ sources, flows: [{ ref, source, file, description?, requiredParams?, shadows?, lastVerified? }] }` |
|
|
195
195
|
| **Plan before run** | `mm-harness run recipe.json --plan --json` → `{ plan[], validation: { status, findings }, schemaVersion }` (adapter-aware; exit 5 on errors) |
|
package/docs/UX-PRINCIPLES.md
CHANGED
|
@@ -27,6 +27,8 @@ The CLI answers relative to the checkout it is standing in.
|
|
|
27
27
|
Long operations show intent immediately and progress continuously.
|
|
28
28
|
- First line within milliseconds: what is being done, where (device/port), and
|
|
29
29
|
where the full log lives.
|
|
30
|
+
- Add an explicit first line only when work can block before existing output. Fast
|
|
31
|
+
commands use their result as acknowledgement; they do not print a redundant banner.
|
|
30
32
|
- Leaf output streams live to stderr — `--json` reserves stdout for the envelope,
|
|
31
33
|
it never buys silence. Quiet stretches get heartbeats with elapsed time.
|
|
32
34
|
- Each dev server a command starts gets its tmux log-tail window at launch time
|
package/package.json
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deeeed/metamask-harness",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.17.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": {
|
|
6
6
|
"mm-harness": "bin/mm-harness"
|
|
7
7
|
},
|
|
8
8
|
"scripts": {
|
|
9
9
|
"build": "node scripts/build-dist.mjs",
|
|
10
|
+
"audit:cli-ergonomics": "node scripts/generate-cli-ergonomics-audit.mjs",
|
|
10
11
|
"prepack": "npm run build",
|
|
11
12
|
"dev:link-farmslot": "node scripts/link-local-farmslot.mjs",
|
|
12
13
|
"check": "node scripts/check.mjs",
|