@mutmutco/opencode-mmi 2.56.0 → 2.57.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/dist/index.d.ts +3 -0
- package/dist/index.js +121 -1
- package/package.json +2 -2
- package/skills/_shared/doctrine.md +13 -11
- package/skills/bootstrap/SKILL.md +5 -5
- package/skills/build/SKILL.md +25 -20
- package/skills/build/references/loops.md +1 -1
- package/skills/build/references/worked-example.md +2 -2
- package/skills/build/templates/campaign-northstar.md +2 -0
- package/skills/coop/SKILL.md +91 -16
- package/skills/grind/SKILL.md +22 -15
- package/skills/grind/references/auto.md +1 -2
- package/skills/grind/references/routing.md +3 -4
- package/skills/grind/references/verify.md +5 -3
- package/skills/grind/templates/saga-snapshot.md +2 -0
- package/skills/grind/templates/synthesize-panel.md +1 -1
- package/skills/handoff/SKILL.md +4 -2
- package/skills/overlord/SKILL.md +12 -12
- package/skills/overlord/references/controller-orphan-guard.md +12 -15
- package/skills/overlord/references/failure-pressure-scenarios.md +13 -13
- package/skills/overlord/references/fugu-api-engine.md +62 -0
- package/skills/overlord/references/servant-liveness.md +9 -9
- package/skills/overlord/references/shell-adapters.md +2 -1
- package/skills/overlord/references/state-schema.md +10 -17
- package/skills/overlord/references/terminal-leash.md +25 -22
- package/skills/release/SKILL.md +5 -9
- package/skills/stage/SKILL.md +1 -1
- package/skills/overlord/references/codex-fugu-preflight.md +0 -25
- package/skills/overlord/references/opencode-fugu-engine.md +0 -104
package/skills/release/SKILL.md
CHANGED
|
@@ -182,24 +182,20 @@ Rejected → stop (nothing released).
|
|
|
182
182
|
|
|
183
183
|
## Step 4 — GitHub Release + start prod deploy (non-blocking)
|
|
184
184
|
|
|
185
|
-
For `tenant-container` repos, publish the GitHub Release
|
|
186
|
-
|
|
187
|
-
dispatched centrally — #759):
|
|
185
|
+
For `tenant-container` repos, publish the GitHub Release and dispatch the central tenant deploy. Repo-owned
|
|
186
|
+
wiki publication is a separate explicit step only when the release task asks for it or the user authorizes it.
|
|
188
187
|
```bash
|
|
189
188
|
gh release create "vX.Y.0" --target main --generate-notes --latest
|
|
190
189
|
gh workflow run tenant-deploy.yml --repo mutmutco/MMI-Hub \
|
|
191
190
|
-f slug={slug} -f repo={owner}/{repo} -f ref=main -f stage=main
|
|
192
|
-
gh workflow run cursor-agents.yml --repo mutmutco/MMI-Hub \
|
|
193
|
-
-f agent=wiki-keeper -f only_repo={owner}/{repo} # wiki-keeper, scoped to the released repo
|
|
194
191
|
gh run watch "$(gh run list --workflow tenant-deploy.yml --limit 1 --json databaseId -q '.[0].databaseId')" \
|
|
195
192
|
--exit-status # the central prod-deploy run — run this in the BACKGROUND (Bash run_in_background)
|
|
196
193
|
```
|
|
197
194
|
|
|
198
195
|
For `hub-serverless` (MMI-Hub), publish the GitHub Release but do **not** dispatch `tenant-deploy.yml` or
|
|
199
|
-
|
|
200
|
-
package
|
|
201
|
-
|
|
202
|
-
`publish.yml` runs instead.
|
|
196
|
+
repo wiki publication: the release event auto-fires `deploy.yml` for prod and `publish.yml` for the
|
|
197
|
+
plugin/CLI package. A missing `DEPLOY#main` registry row for MMI-Hub is expected, not a tenant stack repair
|
|
198
|
+
task. Watch/report the release-triggered `deploy.yml` and `publish.yml` runs instead.
|
|
203
199
|
|
|
204
200
|
For other direct-track repos, the train dispatches nothing centrally: a `registry-publish` repo's release
|
|
205
201
|
event fires its own `publish.yml` (npm / plugin marketplace); a `solo-container` repo deploys via its own
|
package/skills/stage/SKILL.md
CHANGED
|
@@ -62,7 +62,7 @@ All stage artifacts (build output, screenshots, Playwright traces, local DB file
|
|
|
62
62
|
— never tracked.
|
|
63
63
|
|
|
64
64
|
A local stage is bound to the worktree that started it. Concurrent worktrees on one machine each keep
|
|
65
|
-
their own stage on separate ports — you do not need to stop one before starting another.
|
|
65
|
+
their own stage on separate ports — you do not need to stop one before starting another. For `jervaise`, saga continuity
|
|
66
66
|
keys on branch; use a distinct North Star slug per parallel grind or feature. Stage JSON/state records
|
|
67
67
|
the starting `cwd` plus git branch/commit when available.
|
|
68
68
|
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# Codex/Fugu Preflight
|
|
2
|
-
|
|
3
|
-
Before servant launch:
|
|
4
|
-
|
|
5
|
-
- Detect `codex`.
|
|
6
|
-
- Detect `codex-fugu`.
|
|
7
|
-
- Check `codex --version`.
|
|
8
|
-
- Check `codex-fugu --status`.
|
|
9
|
-
- Detect stale deployed target after Codex update.
|
|
10
|
-
- Detect missing API key by name only, unless local Codex auth evidence exists; never print values.
|
|
11
|
-
- Detect missing `fugu-ultra`.
|
|
12
|
-
- Detect native Windows Codex receiving Git Bash `/c/Users/...` paths.
|
|
13
|
-
- Verify `--model fugu-ultra` launches the Ultra route.
|
|
14
|
-
|
|
15
|
-
If Fugu is missing, stale, or misconfigured:
|
|
16
|
-
|
|
17
|
-
- Print human-readable setup/update steps.
|
|
18
|
-
- Preserve repair backup paths.
|
|
19
|
-
- Do not launch partial servants.
|
|
20
|
-
- Treat PowerShell-discoverable `.ps1`/`.cmd` wrappers as valid on Windows; Node subprocess probes may need the shell adapter to resolve them.
|
|
21
|
-
|
|
22
|
-
Terminal compatibility warnings:
|
|
23
|
-
|
|
24
|
-
- Treat `TERM=dumb` as a compatibility warning, not proof of Fugu failure.
|
|
25
|
-
- Translate internal warnings into human-facing startup phases.
|
|
@@ -1,104 +0,0 @@
|
|
|
1
|
-
# OpenCode Fugu engine
|
|
2
|
-
|
|
3
|
-
OpenCode is the preferred Fugu engine when it is installed and exposes the required models.
|
|
4
|
-
|
|
5
|
-
## Preflight
|
|
6
|
-
|
|
7
|
-
Before servant launch, verify:
|
|
8
|
-
|
|
9
|
-
- `opencode` is on PATH
|
|
10
|
-
- `opencode --version` returns a version
|
|
11
|
-
- `opencode models` lists `sakana/fugu` and `sakana/fugu-ultra`
|
|
12
|
-
- `opencode run -m sakana/fugu --format json "ACK probe"` emits parseable JSON events
|
|
13
|
-
- the event stream includes a session id, text, step start/finish, and a finish reason
|
|
14
|
-
|
|
15
|
-
Fail closed if any required fact is missing.
|
|
16
|
-
|
|
17
|
-
## Session-backed servants
|
|
18
|
-
|
|
19
|
-
Start or resume servants through session ids.
|
|
20
|
-
|
|
21
|
-
Use normal servants with:
|
|
22
|
-
|
|
23
|
-
```text
|
|
24
|
-
opencode run --session <session-id> -m sakana/fugu --format json <message>
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
Use the Ultra servant with:
|
|
28
|
-
|
|
29
|
-
```text
|
|
30
|
-
opencode run --session <session-id> -m sakana/fugu-ultra --format json <message>
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Record these facts in the run registry:
|
|
34
|
-
|
|
35
|
-
- `engine`
|
|
36
|
-
- `provider`
|
|
37
|
-
- `model`
|
|
38
|
-
- `opencodeSessionId`
|
|
39
|
-
- `opencodeVersion`
|
|
40
|
-
- `eventJournalPath`
|
|
41
|
-
- `lastEventAt`
|
|
42
|
-
- `lastMessageCompletedAt`
|
|
43
|
-
|
|
44
|
-
## Mailbox lifecycle
|
|
45
|
-
|
|
46
|
-
A mailbox message is not complete when text is written.
|
|
47
|
-
|
|
48
|
-
Track:
|
|
49
|
-
|
|
50
|
-
- `queuedAt`
|
|
51
|
-
- `startedAt`
|
|
52
|
-
- `completedAt`
|
|
53
|
-
- `failedAt`
|
|
54
|
-
- `ackText`
|
|
55
|
-
- `responseText`
|
|
56
|
-
- `eventJournalPath`
|
|
57
|
-
|
|
58
|
-
`send` returns success only after a servant response is captured or a bounded failure is recorded.
|
|
59
|
-
|
|
60
|
-
## Ledger and artifacts
|
|
61
|
-
|
|
62
|
-
Append servant outputs to:
|
|
63
|
-
|
|
64
|
-
```text
|
|
65
|
-
tmp/overlord/<runId>/ledger.jsonl
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
Artifact records are references, not side channels:
|
|
69
|
-
|
|
70
|
-
- `artifactId`
|
|
71
|
-
- `ownerSlotId`
|
|
72
|
-
- `kind`
|
|
73
|
-
- `version`
|
|
74
|
-
- `path`
|
|
75
|
-
- `status`
|
|
76
|
-
- `dependsOn`
|
|
77
|
-
|
|
78
|
-
The coordinator routes artifact refs between servants.
|
|
79
|
-
|
|
80
|
-
Servants do not directly own PRs, merges, releases, browser sessions, Playwright, shared stage servers, or cross-servant worktrees.
|
|
81
|
-
|
|
82
|
-
## Liveness
|
|
83
|
-
|
|
84
|
-
Use JSON events as liveness signals.
|
|
85
|
-
|
|
86
|
-
Distinguish:
|
|
87
|
-
|
|
88
|
-
- idle
|
|
89
|
-
- running
|
|
90
|
-
- blocked
|
|
91
|
-
- failed
|
|
92
|
-
- lost
|
|
93
|
-
|
|
94
|
-
A ready servant that receives work but produces no non-TUI output before the bounded handoff interval is `stalled-after-delivery`.
|
|
95
|
-
|
|
96
|
-
A message pasted into a composer but not submitted is `delivery-stuck-composer`.
|
|
97
|
-
|
|
98
|
-
## Stop and resume
|
|
99
|
-
|
|
100
|
-
Stop only exact run-owned OpenCode resources.
|
|
101
|
-
|
|
102
|
-
Prefer headless `opencode run --session` calls so fewer live PTYs need process ownership.
|
|
103
|
-
|
|
104
|
-
Resume from registry session ids, event journals, and the ledger.
|