greprag 5.73.13 → 5.73.15
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/commands/codex-chip/selection.js +1 -1
- package/dist/commands/codex-chip/selection.js.map +1 -1
- package/dist/commands/codex.js +1 -1
- package/dist/commands/codex.js.map +1 -1
- package/dist/commands/fix.d.ts +1 -1
- package/dist/commands/fix.js +11 -8
- package/dist/commands/fix.js.map +1 -1
- package/dist/commands/friction-reminder.js +7 -5
- package/dist/commands/friction-reminder.js.map +1 -1
- package/dist/commands/load-primer-reminder.js +1 -1
- package/dist/commands/load-primer-reminder.js.map +1 -1
- package/dist/commands/mechanic-spawn.d.ts +5 -1
- package/dist/commands/mechanic-spawn.js +72 -6
- package/dist/commands/mechanic-spawn.js.map +1 -1
- package/dist/commands/opencode-relay.js +1 -1
- package/dist/commands/opencode-relay.js.map +1 -1
- package/dist/commands/os-primer-reminder.js +1 -1
- package/dist/commands/os-primer-reminder.js.map +1 -1
- package/dist/index.js +4 -3
- package/dist/index.js.map +1 -1
- package/dist/mechanic-friction.js +3 -3
- package/dist/mechanic-friction.js.map +1 -1
- package/dist/opencode-plugin.bundle.js +9 -7
- package/dist/skill-mirror-client.js +58 -3
- package/dist/skill-mirror-client.js.map +1 -1
- package/package.json +1 -1
- package/skill/greprag/docs/codex-chip.md +1 -1
- package/skill/mechanic/SKILL.md +14 -5
- package/skill/mechanic/docs/skill-fix-conventions.md +2 -2
- package/skill/templates/chip-leader.md +1 -1
- package/skill/templates/codex-chip-spawn.md +17 -6
- package/skill/templates/os.md +8 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-mirror-client.js","sourceRoot":"","sources":["../src/skill-mirror-client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;0DAU0D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0B1D,8CA8BC;AAGD,8CAEC;AASD,8DAQC;
|
|
1
|
+
{"version":3,"file":"skill-mirror-client.js","sourceRoot":"","sources":["../src/skill-mirror-client.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -14,7 +14,7 @@ Normal chips are writable and own discovery, design, implementation, tests, and
|
|
|
14
14
|
commit. Preserve the Codex-provided worktree, committed result artifact, and
|
|
15
15
|
parent cleanup. The child opening prompt starts with the exact visible title
|
|
16
16
|
alone (`Chip A: <Specific Purview>`, `LEAD: <Mission>`, `PLANNER: <Mission>`,
|
|
17
|
-
`ADVISOR: <Purview>`, or `FIX: <one friction unit>`) and then carries Block 1
|
|
17
|
+
`ADVISOR: <Purview>`, or `FIX: [type] <one friction unit>`) and then carries Block 1
|
|
18
18
|
setup, task body, and Block 2 report-back. It has no lease,
|
|
19
19
|
read-only, mandatory nested-goal, or nonce/ACK requirement. Completion is the
|
|
20
20
|
native Codex parent-child task reply: commit the durable result, then reply to
|
package/skill/mechanic/SKILL.md
CHANGED
|
@@ -21,7 +21,7 @@ license: MIT
|
|
|
21
21
|
|
|
22
22
|
> **Fix-spawn reflex (ratified 2026-07-12, grepragOS law 4 — supersedes the
|
|
23
23
|
> routing/queueing reflex below wherever they conflict).** Friction is fixed at
|
|
24
|
-
> the MOMENT it happens: `greprag fix spawn "<one unit
|
|
24
|
+
> the MOMENT it happens: `greprag fix spawn --type <type> "<one unit>"` emits a
|
|
25
25
|
> FIX chip for exactly that unit (never absorb adjacent friction). The chip's
|
|
26
26
|
> contract: identify the exact friction → make the smallest durable root-cause
|
|
27
27
|
> fix → explain the friction and fix in human terms → STOP for human approval
|
|
@@ -32,9 +32,17 @@ license: MIT
|
|
|
32
32
|
> `FIX: <friction>` follows this contract; legacy `MECHANIC: <Mission>` chips
|
|
33
33
|
> read the same way.
|
|
34
34
|
|
|
35
|
+
**FIX type router.** Type means durable repair surface, not symptom:
|
|
36
|
+
`harness` = hooks/watchers/task dispatch/harness behavior; `doctrine` =
|
|
37
|
+
`greprag load`, bundled skills, AGENTS/CLAUDE rendered instructions;
|
|
38
|
+
`injection` = recap/Capture/doc-pointer/stateful injection content; `env` =
|
|
39
|
+
bootstrap/deps/scripts/worktree setup; `code` = product/source behavior. Repo
|
|
40
|
+
write requires the dispatch-provided isolated worktree; data-only repair rows
|
|
41
|
+
and diagnosis do not write the repo.
|
|
42
|
+
|
|
35
43
|
The Mechanic keeps the harness healthy. The loop is **friction → fix → repair**:
|
|
36
44
|
|
|
37
|
-
- **friction** — a rough spot the agent or operator hit: a gotcha, a rediscovery, a repeated correction, churn, rework. Live friction becomes one `greprag fix spawn "<unit>"` chip at the moment it happens.
|
|
45
|
+
- **friction** — a rough spot the agent or operator hit: a gotcha, a rediscovery, a repeated correction, churn, rework. Live friction becomes one `greprag fix spawn --type <type> "<unit>"` chip at the moment it happens.
|
|
38
46
|
- **fix** — the repair mission or audit note. Live fixes are owned by spawned FIX chips; the queue remains for existing backlog and deliberate design-input notes.
|
|
39
47
|
- **repair** — the fix wired in so it can't recur: a hook, a code change, or *surfacing it* (a doc line / a fact-seed / an injection). A repaired fix is done.
|
|
40
48
|
|
|
@@ -69,6 +77,7 @@ Same gate the hourly compactor applies at write-time — Mechanic and compactor
|
|
|
69
77
|
## Hard rules
|
|
70
78
|
|
|
71
79
|
- **Tier-2 actions need explicit confirm** (arm/graduate, deny/transform, prod·secrets·external, deleting what you didn't author). Tier 0/1 don't — just do + report.
|
|
80
|
+
- **Removal-first repair.** Remove the offending text, gate, control, duplicated doctrine, or wrong boundary before adding new guidance. Add prose or controls only when no removal action can solve the friction; never wrap bad doctrine in explanatory caveats when deleting the bad boundary fixes it.
|
|
72
81
|
- **Bulk is fine for Tier-0 when the set is named aloud** (clearing verified-stale / noise fixes); never bulk a Tier-2 action.
|
|
73
82
|
- **Never edit `~/.claude/docs/chip-spawn.md` without confirm.** Global rules are sticky.
|
|
74
83
|
- **Cross-project carve-out.** Default to the current project (resolved via `greprag fix list`). The Phase 0 census MAY read sibling queues to show where fixes piled up; *draining* one requires the operator to name it, and every `add`/`delete` against it MUST carry `--project <that-project>`. Never touch a sibling silently.
|
|
@@ -119,7 +128,7 @@ do not retry blindly, and never treat two visible copies as two requests.
|
|
|
119
128
|
|
|
120
129
|
A fix note is a raw, undigested signal. Historical auto-detected friction rows
|
|
121
130
|
may carry a type; deliberate audit/design notes are freeform. New live friction
|
|
122
|
-
does not enter this queue: it becomes one `greprag fix spawn "<unit>"` chip at
|
|
131
|
+
does not enter this queue: it becomes one `greprag fix spawn --type <type> "<unit>"` chip at
|
|
123
132
|
the moment it happens. Digestion does two jobs per queued note — **repair** the
|
|
124
133
|
mechanism and/or **record** the durable gotcha — and runs FIRST.
|
|
125
134
|
|
|
@@ -263,7 +272,7 @@ greprag mechanic set legacy role marker for mechanic follow-up
|
|
|
263
272
|
fan out `mechanic_live` to open sessions
|
|
264
273
|
greprag mechanic role show whether this project is the live Mechanic
|
|
265
274
|
greprag mechanic friction "obs" RETIRED as the reflex (2026-07-12): spawn a fix chip
|
|
266
|
-
instead — `greprag fix spawn "<unit>"`. The CLI refuses
|
|
275
|
+
instead — `greprag fix spawn --type <type> "<unit>"`. The CLI refuses
|
|
267
276
|
new working-session use.
|
|
268
277
|
greprag mechanic reply --to <8hex> typed follow-up from Mechanic to source session;
|
|
269
278
|
"msg" [--friction-id <id>] do not use generic send for mechanic workflow
|
|
@@ -280,7 +289,7 @@ greprag mechanic off / on PANIC SWITCH — local file, no network; s
|
|
|
280
289
|
**Legacy Mechanic role.** A `--mechanic` inbox watcher can still receive
|
|
281
290
|
legacy `mechanic_friction` / `mechanic_reply` rows in addition to its own session
|
|
282
291
|
lane, but live working sessions no longer route friction there. New friction is
|
|
283
|
-
always Law 4: `greprag fix spawn "<one unit
|
|
292
|
+
always Law 4: `greprag fix spawn --type <type> "<one unit>"`, one FIX chip per
|
|
284
293
|
unit, at the moment it happens. `greprag mechanic set` only fans out a notice
|
|
285
294
|
that teaches this fix-spawn reflex and preserves the reply rail for old mechanic
|
|
286
295
|
threads. The Mechanic replies with `greprag mechanic reply --to <source-session>
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
The skill-tuning reflex injects a directive when a skill under break-in loads. The old directive said "watch your execution, emit a SELF-TUNING block, propose a fix" — vague (it pointed at the *run*, not the *skill*) and propose-only (no edit ever landed). This doc replaces that with **six locatable skill defects**, each mapped to one concrete edit. The reflex's loop is: **detect a defined friction → locate it in the skill's SKILL.md → apply the fix per the matching recipe → show the diff for one accept/revert.**
|
|
8
8
|
|
|
9
|
-
A friction that doesn't match one of the six below is **not auto-fixable inline** — spawn a fix chip for the one unit (`greprag fix spawn "<skill friction unit>"`) and keep working. Use `greprag fix log` only for deliberate audit/design notes, not as the live-friction reflex. Do not invent edits outside these recipes.
|
|
9
|
+
A friction that doesn't match one of the six below is **not auto-fixable inline** — spawn a doctrine fix chip for the one unit (`greprag fix spawn --type doctrine "<skill friction unit>"`) and keep working. Use `greprag fix log` only for deliberate audit/design notes, not as the live-friction reflex. Do not invent edits outside these recipes.
|
|
10
10
|
|
|
11
11
|
## The two edit primitives (skill-optimize vocabulary)
|
|
12
12
|
|
|
@@ -55,4 +55,4 @@ Each: **signature** (how it shows up in the run) · **location** (where it lives
|
|
|
55
55
|
- **Apply + show diff.** Make the edit, then show the unified diff and stop for one accept/revert. (This is the operator-chosen gate; the Mechanic "always confirm" rule still holds.)
|
|
56
56
|
- **Bundled skills:** if the target is a greprag bundled skill, author the edit at `packages/cli/skill/<name>/` — never the `~/.claude/skills/<name>/` install artifact (it's overwritten on the next `init`). See greprag `CLAUDE.md`.
|
|
57
57
|
- **Line budget:** a fix must not grow SKILL.md without adding a real proactive-fire rule or per-task step. Converting wallpaper → Convention B is net-neutral or smaller; mis-route adds at most one line.
|
|
58
|
-
- **Out of taxonomy → spawn, don't improvise.** Anything not matching the six becomes one `greprag fix spawn "<unit>"` chip. `greprag fix log` is only for deliberate audit/design notes.
|
|
58
|
+
- **Out of taxonomy → spawn, don't improvise.** Anything not matching the six becomes one `greprag fix spawn --type doctrine "<unit>"` chip. `greprag fix log` is only for deliberate audit/design notes.
|
|
@@ -89,7 +89,7 @@ ordering in the brief rather than relying on hidden coordination metadata.
|
|
|
89
89
|
`create_goal`, then verify it with `get_goal`.
|
|
90
90
|
5. From the LEAD, spawn each `Chip A/B/C: <Specific Purview>` with its own
|
|
91
91
|
visible worktree and the mission context it needs.
|
|
92
|
-
A `FIX: <one friction unit>` child must make `greprag load mechanic` its
|
|
92
|
+
A `FIX: [type] <one friction unit>` child must make `greprag load mechanic` its
|
|
93
93
|
first Setup action before diagnosis or edits.
|
|
94
94
|
6. Keep children writable and let them investigate, edit, test, and commit
|
|
95
95
|
within their worktrees.
|
|
@@ -13,7 +13,7 @@ parent-child reply channel.
|
|
|
13
13
|
- `LEAD: <Mission>`
|
|
14
14
|
- `PLANNER: <Mission>`
|
|
15
15
|
- `ADVISOR: <Purview>`
|
|
16
|
-
- `FIX: <one friction unit>`
|
|
16
|
+
- `FIX: [harness|doctrine|injection|env|code] <one friction unit>`
|
|
17
17
|
- `prompt:` Block 1 + task body + Block 2 below.
|
|
18
18
|
- `target:` current project with `environment: { "type": "worktree" }`.
|
|
19
19
|
- `model` / `thinking:` selected from the role slot:
|
|
@@ -91,7 +91,7 @@ another checkout.
|
|
|
91
91
|
If the exact first-line title is `LEAD: <Mission>`, create a native top-level
|
|
92
92
|
mission goal with `create_goal`, then run `get_goal` and verify the active goal
|
|
93
93
|
names this mission before any child fanout.
|
|
94
|
-
If the exact first-line title
|
|
94
|
+
If the exact first-line title starts with `FIX:`, run
|
|
95
95
|
`greprag load mechanic` before diagnosis or edits.
|
|
96
96
|
If the exact first-line title is `ADVISOR: <Purview>`, report consultation to
|
|
97
97
|
the LEAD only: findings, questions, tradeoffs, and recommendations. Do not
|
|
@@ -145,10 +145,21 @@ For `FIX:` tasks, the mission printed by `greprag fix spawn` is the source of
|
|
|
145
145
|
truth. `fix spawn` only prints the mission; this Codex dispatch creates the
|
|
146
146
|
visible task and isolated worktree.
|
|
147
147
|
|
|
148
|
-
The FIX chip
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
148
|
+
The FIX chip keeps the existing `FIX:` route and carries its type in the title,
|
|
149
|
+
for example `FIX: [doctrine] stale skill text sent Codex to Claude rules`.
|
|
150
|
+
Type means durable repair surface: `harness` hooks/watchers/task dispatch,
|
|
151
|
+
`doctrine` load entries/skills/rendered instructions, `injection`
|
|
152
|
+
recap/Capture/doc-pointer/stateful injection, `env` bootstrap/deps/scripts, and
|
|
153
|
+
`code` product/source behavior. Repo write requires the isolated worktree;
|
|
154
|
+
data-only repair rows and diagnosis do not write the repo. The chip identifies
|
|
155
|
+
the exact friction, makes the smallest durable root-cause fix, explains the
|
|
156
|
+
friction and fix in human terms, reports checks, then stops for human approval.
|
|
157
|
+
Removal comes first: remove offending text, gates, controls, duplicated
|
|
158
|
+
doctrine, and wrong boundaries before adding new guidance. Add prose or
|
|
159
|
+
controls only when no removal action can solve the friction; never wrap bad
|
|
160
|
+
doctrine in explanatory caveats when deleting the bad boundary fixes it.
|
|
161
|
+
It must not merge, push, deploy, publish, archive, prune, or delete
|
|
162
|
+
branch/worktree state before approval.
|
|
152
163
|
|
|
153
164
|
## After spawning
|
|
154
165
|
|
package/skill/templates/os.md
CHANGED
|
@@ -58,7 +58,7 @@ Friction — you repeated yourself, fought a tool, got corrected twice on the
|
|
|
58
58
|
same thing, rediscovered something already known, hit a setup failure that
|
|
59
59
|
wasn't your edit — is fixed at the MOMENT it happens:
|
|
60
60
|
|
|
61
|
-
greprag fix spawn "<one unit
|
|
61
|
+
greprag fix spawn --type <harness|doctrine|injection|env|code> "<one unit>"
|
|
62
62
|
|
|
63
63
|
- **What the command does:** it PRINTS a mission (JSON with a `mission`
|
|
64
64
|
field) — it does not spawn anything itself. A **chip** is a spawned child
|
|
@@ -69,6 +69,13 @@ wasn't your edit — is fixed at the MOMENT it happens:
|
|
|
69
69
|
- **One unit = one chip.** A fix chip exists for exactly one unit of
|
|
70
70
|
friction. Adjacent friction gets its own spawn — a chip that absorbs new
|
|
71
71
|
friction loses the context each unit needs.
|
|
72
|
+
- **Type = durable repair surface.** `harness` fixes hooks/watchers/task
|
|
73
|
+
dispatch/harness behavior; `doctrine` fixes `greprag load`, bundled skills,
|
|
74
|
+
and rendered AGENTS/CLAUDE instructions; `injection` fixes recap, Capture,
|
|
75
|
+
doc-pointer, and stateful-injection content; `env` fixes bootstrap, deps,
|
|
76
|
+
scripts, and worktree setup; `code` fixes product/source behavior.
|
|
77
|
+
- **Worktree rule:** repo write = isolated worktree. Data-only repair row or
|
|
78
|
+
diagnosis = no repo write.
|
|
72
79
|
- **The chip's contract** (it self-enforces): INVESTIGATE first — reproduce,
|
|
73
80
|
locate the root mechanism, draft the durable repair, score confidence
|
|
74
81
|
0–100. Then the gate: **≥90** → implement, test, commit, report DONE.
|