@mutmutco/opencode-mmi 2.56.0 → 2.58.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.
@@ -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, dispatch the central tenant deploy, and dispatch
186
- the release-scoped wiki refresh (release events never leave the releasing repo, so the keeper must be
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
- `cursor-agents.yml`: the release event auto-fires `deploy.yml` for prod, `publish.yml` for the plugin/CLI
200
- package, and `cursor-agents.yml` for the Hub-scoped wiki refresh. A missing `DEPLOY#main` registry row for
201
- MMI-Hub is expected, not a tenant stack repair task. Watch/report the release-triggered `deploy.yml` and
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
@@ -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. Saga continuity
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.