@mutmutco/codex-plugin 4.3.43 → 4.3.45
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/.codex-plugin/plugin.json +1 -1
- package/package.json +1 -1
- package/skills/board/SKILL.md +2 -3
- package/skills/bootstrap/SKILL.md +2 -3
- package/skills/bootstrap/seeds/README.template.md +1 -1
- package/skills/epic/SKILL.md +2 -3
- package/skills/hotfix/SKILL.md +2 -2
- package/skills/org-guide/references/vault.md +2 -0
- package/skills/org-guide/references/work-and-releases.md +9 -2
- package/skills/rcand/SKILL.md +2 -2
- package/skills/release/SKILL.md +3 -3
- package/skills/secrets/SKILL.md +2 -3
- package/skills/stage/SKILL.md +2 -3
package/package.json
CHANGED
package/skills/board/SKILL.md
CHANGED
|
@@ -151,6 +151,5 @@ run — ambiguous wording, a misleading message, or an environment failure it sh
|
|
|
151
151
|
out to conflict, or a board read that misreported what was claimable.) If yes, file **one** lesson and
|
|
152
152
|
move on; a clean run is silent (hard cap: one per run). It lands on the owning board (deduped) and is
|
|
153
153
|
fixed only via a reviewed PR — never edit the skill live; the retro is advisory, so if the call fails,
|
|
154
|
-
note it and continue.
|
|
155
|
-
|
|
156
|
-
`jervcode learn --origin retro --surface skills --title "board: <what misfired>" --body "<what; evidence; proposed amendment>"`
|
|
154
|
+
note it and continue. File through MMI:
|
|
155
|
+
`mmi-cli learning skill-lesson --skill board --title "<what misfired>" --body "<what; evidence; proposed amendment>"`
|
|
@@ -544,6 +544,5 @@ this run — ambiguous wording, a misleading message, or an environment failure
|
|
|
544
544
|
about? (Process only — never the user's code or task; e.g. an ambiguous seed, registry, or OIDC step, or
|
|
545
545
|
a guard that fired on a healthy repo.) If yes, file **one** lesson and move on; a clean run is silent
|
|
546
546
|
(hard cap: one per run). It lands on the owning board (deduped) and is fixed only via a reviewed PR — never
|
|
547
|
-
edit the skill live; the retro is advisory, so if the call fails, note it and continue.
|
|
548
|
-
`
|
|
549
|
-
`jervcode learn --origin retro --surface skills --title "bootstrap: <what misfired>" --body "<what; evidence; proposed amendment>"`
|
|
547
|
+
edit the skill live; the retro is advisory, so if the call fails, note it and continue. File through MMI:
|
|
548
|
+
`mmi-cli learning skill-lesson --skill bootstrap --title "<what misfired>" --body "<what; evidence; proposed amendment>"`
|
|
@@ -18,7 +18,7 @@ access runbook → [repo-access](https://github.com/mutmutco/MMI-Hub/blob/develo
|
|
|
18
18
|
|
|
19
19
|
Read this section at the start of agent work in this repo.
|
|
20
20
|
|
|
21
|
-
- **Structure search:**
|
|
21
|
+
- **Structure search:** Use available code search tools. Verify results against cited source before acting.
|
|
22
22
|
- **Durable WHY:** `docs/decisions/` — one file per decision, prose only for what was chosen and
|
|
23
23
|
rejected; never a description of current state. Do not maintain living current-state under `docs/`.
|
|
24
24
|
- **Current state:** code + live CLI (`mmi-cli oracle org project get`, `board`, `status`,
|
package/skills/epic/SKILL.md
CHANGED
|
@@ -124,6 +124,5 @@ this run — ambiguous wording, a misleading message, or an environment failure
|
|
|
124
124
|
about? (Process only — never the user's code or task; e.g. a batch schema that rejected a valid row, or a
|
|
125
125
|
link that attached to the wrong parent.) If yes, file **one** lesson and move on; a clean run is silent
|
|
126
126
|
(hard cap: one per run). It lands on the owning board (deduped) and is fixed only via a reviewed PR — never
|
|
127
|
-
edit the skill live; the retro is advisory, so if the call fails, note it and continue.
|
|
128
|
-
`
|
|
129
|
-
`jervcode learn --origin retro --surface skills --title "epic: <what misfired>" --body "<what; evidence; proposed amendment>"`
|
|
127
|
+
edit the skill live; the retro is advisory, so if the call fails, note it and continue. File through MMI:
|
|
128
|
+
`mmi-cli learning skill-lesson --skill epic --title "<what misfired>" --body "<what; evidence; proposed amendment>"`
|
package/skills/hotfix/SKILL.md
CHANGED
|
@@ -94,8 +94,8 @@ Title first, verdict first. Name the resolved tag (never a placeholder like `vX.
|
|
|
94
94
|
|
|
95
95
|
## Retro
|
|
96
96
|
|
|
97
|
-
Before the final report, answer one question honestly: did this skill's own instructions misfire this run — ambiguous wording, a misleading message, or an environment failure it should have warned about? Process only, never the user's code or task. If yes, file one lesson and move on; a clean run is silent (hard cap: one per run). It lands on the owning board, deduplicated, and is fixed only through a reviewed PR — never edit the skill live. The retro is advisory: if the call fails, note it and continue.
|
|
97
|
+
Before the final report, answer one question honestly: did this skill's own instructions misfire this run — ambiguous wording, a misleading message, or an environment failure it should have warned about? Process only, never the user's code or task. If yes, file one lesson and move on; a clean run is silent (hard cap: one per run). It lands on the owning board, deduplicated, and is fixed only through a reviewed PR — never edit the skill live. The retro is advisory: if the call fails, note it and continue. File through MMI with the command below. The amendment itself stays reference-free: the skill-drift gate rejects issue references in any section outside Merge floor, so carry the evidence in words or point at the guide entry — never inline reference markers.
|
|
98
98
|
|
|
99
99
|
```bash
|
|
100
|
-
|
|
100
|
+
mmi-cli learning skill-lesson --skill hotfix --title "<what misfired>" --body "<what; evidence; proposed amendment>"
|
|
101
101
|
```
|
|
@@ -12,6 +12,8 @@ The two tiers describe authority and blast radius, not separate storage products
|
|
|
12
12
|
Read `mmi-cli oracle org access role <owner/repo> --json` and
|
|
13
13
|
`mmi-cli oracle org access capabilities` for your actual authority.
|
|
14
14
|
Installing MMI does not confer that authority. The server checks the caller and target scope.
|
|
15
|
+
An empty result describes only your visible MMI scope. Check your MMI access and catalog;
|
|
16
|
+
it does not require installing or querying a personal vault product.
|
|
15
17
|
|
|
16
18
|
The registry catalog declares secret names before values are set. A shared, stageless value is
|
|
17
19
|
the canonical default; a declared stage override wins for that stage. Avoid accidental duplicate
|
|
@@ -5,6 +5,11 @@ Reading or discussing the board is read-only until the developer authorizes work
|
|
|
5
5
|
Claim approved work with `mmi-cli oracle board claim <issue>`, then prepare an isolated task
|
|
6
6
|
workspace through the host. Preserve other developers' work.
|
|
7
7
|
|
|
8
|
+
MMI workflows require no personal Jerv installation. Use Git or your chosen host for worktree
|
|
9
|
+
creation; MMI performs its own guarded cleanup. Report a skill misfire with
|
|
10
|
+
`mmi-cli learning skill-lesson --skill <name> --title <summary> --body-file <path>`.
|
|
11
|
+
Feedback belongs on the MMI Hub board and never requires another developer's personal tooling.
|
|
12
|
+
|
|
8
13
|
Read the issue, implementation, callers, and repository policy before editing.
|
|
9
14
|
Run `mmi-cli tests policy --base <comparison-base>` to determine required checks against your target
|
|
10
15
|
branch (normally origin/development for train repositories). The repository's policy decides, not
|
|
@@ -34,8 +39,10 @@ Read the selected release skill before operating the train. Let it choose versio
|
|
|
34
39
|
publish, deploy, and verify the resulting release. A refusal requires fixing its cause; do not
|
|
35
40
|
finish by hand, bypass checks, or start a duplicate release.
|
|
36
41
|
A release announces itself in Slack: the Hub to the org alerts channel, a product to its own
|
|
37
|
-
project channel when the project
|
|
38
|
-
by hand.
|
|
42
|
+
project channel when the project's registry META sets `releaseChannel`; never post release notes
|
|
43
|
+
by hand. The Hub always needs a curated `--announce-summary-file`, and so does any product whose
|
|
44
|
+
META sets `releaseChannel` — 3–6 plain lines in the project's `releaseLanguage` (default `en`),
|
|
45
|
+
written for that project's audience, never the raw PR titles.
|
|
39
46
|
|
|
40
47
|
For local or private live testing, read [stage](../../stage/SKILL.md).
|
|
41
48
|
For a new product repository, use [bootstrap](../../bootstrap/SKILL.md).
|
package/skills/rcand/SKILL.md
CHANGED
|
@@ -73,8 +73,8 @@ Title first, verdict first. Name the resolved tag (never a placeholder like `vX.
|
|
|
73
73
|
|
|
74
74
|
## Retro
|
|
75
75
|
|
|
76
|
-
Before the final report, answer one question honestly: did this skill's own instructions misfire this run — ambiguous wording, a misleading message, or an environment failure it should have warned about? Process only, never the user's code or task. If yes, file one lesson and move on; a clean run is silent (hard cap: one per run). It lands on the owning board, deduplicated, and is fixed only through a reviewed PR — never edit the skill live. The retro is advisory: if the call fails, note it and continue.
|
|
76
|
+
Before the final report, answer one question honestly: did this skill's own instructions misfire this run — ambiguous wording, a misleading message, or an environment failure it should have warned about? Process only, never the user's code or task. If yes, file one lesson and move on; a clean run is silent (hard cap: one per run). It lands on the owning board, deduplicated, and is fixed only through a reviewed PR — never edit the skill live. The retro is advisory: if the call fails, note it and continue. File through MMI with the command below. The amendment itself stays reference-free: the skill-drift gate rejects issue references in any section outside Merge floor, so carry the evidence in words or point at the guide entry — never inline reference markers.
|
|
77
77
|
|
|
78
78
|
```bash
|
|
79
|
-
|
|
79
|
+
mmi-cli learning skill-lesson --skill rcand --title "<what misfired>" --body "<what; evidence; proposed amendment>"
|
|
80
80
|
```
|
package/skills/release/SKILL.md
CHANGED
|
@@ -33,7 +33,7 @@ Read `ready`, then `findings[]`: each carries `code`, `severity` (`blocker` · `
|
|
|
33
33
|
|
|
34
34
|
Run from the primary checkout on the lane's start branch (`rc`; `development` for direct-track and `--dev`). Export the bump intent once from the bare argument — `MMI_BUMP_INTENT=minor|major|patch`, unset → `patch`; `MMI_RELEASE_VERSION=X.Y.Z` only for an exact target the tag math cannot derive.
|
|
35
35
|
|
|
36
|
-
MMI-Hub
|
|
36
|
+
Two cases need a summary file. (1) **MMI-Hub** — always: write a fresh 3–6 line neutral summary to `f=$(mktemp tmp/release-summary.XXXXXX)` — sourced from Hub PR titles only (`origin/main..origin/development`), rewritten in Hub-subsystem terms, never a product or brand name. Hub scope is only `mutmutco/MMI-Hub`: never a product's board, `ds-propagate.yml`, or a product's deploy state. (2) **Any product repo whose META carries `releaseChannel`** (`mmi-cli oracle org project get {owner}/{repo} --json`) — required too: read `releaseLanguage` (default `en`) and write 3–6 lines IN THAT LANGUAGE, in plain words for the project's audience: what changed and why it matters to a user; no commit prefixes, no issue or PR numbers, no file names, no product-internal jargon. The train refuses `--apply` without the file, and raw release notes are never posted to a project channel. A repo with no `releaseChannel` announces nothing and needs no file.
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
39
|
r=$(mktemp tmp/release-receipt.XXXXXX)
|
|
@@ -82,8 +82,8 @@ Title first, verdict first. Name the resolved tag (never a placeholder like `vX.
|
|
|
82
82
|
|
|
83
83
|
## Retro
|
|
84
84
|
|
|
85
|
-
Before the final report, answer one question honestly: did this skill's own instructions misfire this run — ambiguous wording, a misleading message, or an environment failure it should have warned about? Process only, never the user's code or task. If yes, file one lesson and move on; a clean run is silent (hard cap: one per run). It lands on the owning board, deduplicated, and is fixed only through a reviewed PR — never edit the skill live. The retro is advisory: if the call fails, note it and continue.
|
|
85
|
+
Before the final report, answer one question honestly: did this skill's own instructions misfire this run — ambiguous wording, a misleading message, or an environment failure it should have warned about? Process only, never the user's code or task. If yes, file one lesson and move on; a clean run is silent (hard cap: one per run). It lands on the owning board, deduplicated, and is fixed only through a reviewed PR — never edit the skill live. The retro is advisory: if the call fails, note it and continue. File through MMI with the command below. The amendment itself stays reference-free: the skill-drift gate rejects issue references in any section outside Merge floor, so carry the evidence in words or point at the guide entry — never inline reference markers.
|
|
86
86
|
|
|
87
87
|
```bash
|
|
88
|
-
|
|
88
|
+
mmi-cli learning skill-lesson --skill release --title "<what misfired>" --body "<what; evidence; proposed amendment>"
|
|
89
89
|
```
|
package/skills/secrets/SKILL.md
CHANGED
|
@@ -164,6 +164,5 @@ this run — ambiguous wording, a misleading message, or an environment failure
|
|
|
164
164
|
about? (Process only — never the user's code or task; e.g. a canonical-name or tier mix-up, or a step
|
|
165
165
|
that risked echoing a value.) If yes, file **one** lesson and move on; a clean run is silent (hard cap:
|
|
166
166
|
one per run). It lands on the owning board (deduped) and is fixed only via a reviewed PR — never edit the
|
|
167
|
-
skill live; the retro is advisory, so if the call fails, note it and continue.
|
|
168
|
-
`
|
|
169
|
-
`jervcode learn --origin retro --surface skills --title "secrets: <what misfired>" --body "<what; evidence; proposed amendment>"`
|
|
167
|
+
skill live; the retro is advisory, so if the call fails, note it and continue. File through MMI:
|
|
168
|
+
`mmi-cli learning skill-lesson --skill secrets --title "<what misfired>" --body "<what; evidence; proposed amendment>"`
|
package/skills/stage/SKILL.md
CHANGED
|
@@ -190,6 +190,5 @@ this run — ambiguous wording, a misleading message, or an environment failure
|
|
|
190
190
|
about? (Process only — never the user's code or task; e.g. a teardown that left a port bound, or a
|
|
191
191
|
Playwright output path aimed at the repo root.) If yes, file **one** lesson and move on; a clean run is
|
|
192
192
|
silent (hard cap: one per run). It lands on the owning board (deduped) and is fixed only via a reviewed PR —
|
|
193
|
-
never edit the skill live; the retro is advisory, so if the call fails, note it and continue.
|
|
194
|
-
`
|
|
195
|
-
`jervcode learn --origin retro --surface skills --title "stage: <what misfired>" --body "<what; evidence; proposed amendment>"`
|
|
193
|
+
never edit the skill live; the retro is advisory, so if the call fails, note it and continue. File through MMI:
|
|
194
|
+
`mmi-cli learning skill-lesson --skill stage --title "<what misfired>" --body "<what; evidence; proposed amendment>"`
|