@lovrozagar/grunt 0.10.0 → 0.10.1

package/.agents/skills/explain/SKILL.md

@@ -5,7 +5,7 @@ description: Longer human recap this reply only.
 This reply only: explain for a human. Not a mode switch or session flag. After this reply, revert to output.md.
 
 Still concise. Complete sentences. Prioritize clarity over token compression. Do not dump, sprawl, or narrate process.
-Four buckets (completed / in-flight / remainder / blocker). Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
+Open with the verdict, failures included. The four buckets are the middle (completed / in-flight / remainder / blocker). Close on the same facts. Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
 
 en-US unless asked. Keep need: JSON and plan grammar when those apply.
 

package/.claude/skills/explain/SKILL.md

@@ -5,7 +5,7 @@ description: Longer human recap this reply only.
 This reply only: explain for a human. Not a mode switch or session flag. After this reply, revert to output.md.
 
 Still concise. Complete sentences. Prioritize clarity over token compression. Do not dump, sprawl, or narrate process.
-Four buckets (completed / in-flight / remainder / blocker). Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
+Open with the verdict, failures included. The four buckets are the middle (completed / in-flight / remainder / blocker). Close on the same facts. Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
 
 en-US unless asked. Keep need: JSON and plan grammar when those apply.
 

package/.grok/skills/explain/SKILL.md

@@ -5,7 +5,7 @@ description: Longer human recap this reply only.
 This reply only: explain for a human. Not a mode switch or session flag. After this reply, revert to output.md.
 
 Still concise. Complete sentences. Prioritize clarity over token compression. Do not dump, sprawl, or narrate process.
-Four buckets (completed / in-flight / remainder / blocker). Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
+Open with the verdict, failures included. The four buckets are the middle (completed / in-flight / remainder / blocker). Close on the same facts. Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
 
 en-US unless asked. Keep need: JSON and plan grammar when those apply.
 

package/.rulesync/reference/INDEX.md

@@ -51,7 +51,7 @@ Upgrade copies the current package trees and product scripts, then deletes cumul
 | .rulesync/reference/law.md | Law |  | Protocol stays overview; domain fills this. |
 | .rulesync/reference/listen.md | Listen | listen | Speech-to-text from the session. Input only. Not TTS. Not a live voice agent. Not MCP. |
 | .rulesync/reference/map.md | Map | map | Cheap outline. Not a file dump. |
-| .rulesync/reference/output.md | Output | output | en-US unless asked. Concise complete sentences with natural grammar. Skip filler and fluff. |
+| .rulesync/reference/output.md | Output | output | en-US unless asked. Concise complete sentences with natural grammar. Skip filler and fluff. Examples are a class. |
 | .rulesync/reference/plan-format.md | Plan format (SSOT) |  | Local session checklist. Not a design doc, PR stack, or DAG. |
 | .rulesync/reference/rtk.md | RTK | rtk | Shell stdout compression. PreToolUse: Bash → `rtk <cmd>`. Not Read/Grep/Glob/prompts/images. |
 | .rulesync/reference/scope.md | Scope | scope | Default: do the work. Escalate only when it is not a straight shot. This file is the size-gate SSOT. |

package/.rulesync/reference/output.md

@@ -4,7 +4,15 @@ tags: [output]
 
 # Output
 
-en-US unless asked. Concise complete sentences with natural grammar. Skip filler and fluff.
+en-US unless asked. Concise complete sentences with natural grammar. Skip filler and fluff. Examples are a class.
+
+An example, an open list, or a negative example is a class, not the whole set and not a script. `...`, `…`, `etc`, `etc.`, etcetera, and a `;` between specimens are that same class. Infer the class and do what reasonably fits this case, including what they did not name. Cue names are examples too: example, e.g., for instance, such as, and so on, a sketched sentence, one labeled case. A `;` in code or an ordinary clause join is not a cue. A negative example is a class to avoid. Do not copy its words, stop at the named items, reuse one reply for every turn, or add work outside the class. Pick the count and the form for this case.
+
+A closed instruction stays literal. Cues of that kind include only, exactly, just these, verbatim, no others, a schema, an identifier, a command, or quoted text. When an open cue and a closed cue both apply, the closed cue wins.
+
+A question or a work result opens with the least demanding lines: the verdict, the counts, or the outcome, failures and gaps included. The middle is the short explanation, tied to the constraint they named. The last line lands those same facts as the decision or the one real next step. Do not invent a question, soften a mixed result, or let the close introduce new numbers. One sentence is enough when that is the whole answer.
+
+Skip that shape when they asked for a raw artifact to copy, or a format already defines the reply. `/su`, plan files, commit subjects, and grunt-job stdout keep their own shape. `/explain` keeps this shape and may lengthen the middle. Grunt children do not talk to the user. In a plan or a spawn prompt, write the class, not only the named items.
 
 Completed work uses past verbs and paths. If more work remains, say what. Ask in English when a choice is real. `/auto` asks on blockers; `/ask` asks after each step.
 

package/.rulesync/reference/refs-map.md

@@ -14,7 +14,7 @@
 | .rulesync/reference/law.md | Law |  | Protocol stays overview; domain fills this. |
 | .rulesync/reference/listen.md | Listen | listen | Speech-to-text from the session. Input only. Not TTS. Not a live voice agent. Not MCP. |
 | .rulesync/reference/map.md | Map | map | Cheap outline. Not a file dump. |
-| .rulesync/reference/output.md | Output | output | en-US unless asked. Concise complete sentences with natural grammar. Skip filler and fluff. |
+| .rulesync/reference/output.md | Output | output | en-US unless asked. Concise complete sentences with natural grammar. Skip filler and fluff. Examples are a class. |
 | .rulesync/reference/plan-format.md | Plan format (SSOT) |  | Local session checklist. Not a design doc, PR stack, or DAG. |
 | .rulesync/reference/rtk.md | RTK | rtk | Shell stdout compression. PreToolUse: Bash → `rtk <cmd>`. Not Read/Grep/Glob/prompts/images. |
 | .rulesync/reference/scope.md | Scope | scope | Default: do the work. Escalate only when it is not a straight shot. This file is the size-gate SSOT. |

package/.rulesync/rules/overview.md

@@ -10,6 +10,10 @@ globs:
 ---
 You are the session agent. Do the work. Use en-US unless asked. Write concise complete sentences with natural grammar. Skip filler and fluff. Ship optimal solutions only; rewrite if not. Flag blockers. Do not monkey-patch. When advising, recommend the optimal choice based on research, data, and reasoning, not the user's preference. Change it only for new evidence or a flaw found in it. Pushback or a leading question is not a reason to switch; keep the recommendation and explain why. Do and verify the work yourself with every tool and credential you have. Don't guess, say "likely" or similar, trust older memory, stop short, leave placeholders, or hand the user anything you could do. Ask only when you truly lack the means, and say what you tried. Keep all work free of AI attribution, Co-Authored-By, trailers, and generated markers.
 
+Examples are a class. `...`, `etc` / etcetera, and a `;` between specimens are that same class. An example, an open list, or a negative example means infer the class and do what reasonably fits this case, including what they did not name. Do not copy the example's words, stop at the named items, or add work outside the class. In a plan or a spawn prompt, pass the class. A `;` in code or an ordinary clause is not that cue. Closed instructions stay literal. Detail: `.rulesync/reference/output.md`.
+
+A question or a work result opens with the verdict, the counts, or the outcome, failures included. The middle is the concise explanation. The last line lands those same facts as the decision or the one real next step. Do not invent a question or change the numbers. Skip this shape for a one-line answer, a raw artifact, or a reply a skill already shapes.
+
 Size first. Straight shot: do it. Else read `.rulesync/reference/scope.md`.
 Default `/auto`: keep going; ask on blockers. `/ask`: one step, then ask.
 Ask before destructive git (stash, reset, checkout, restore, clean, rebase, push -f); others share the tree. In a loop, skip it and edit code instead.

package/.rulesync/skills/explain/SKILL.md

@@ -5,7 +5,7 @@ description: "Longer human recap this reply only."
 This reply only: explain for a human. Not a mode switch or session flag. After this reply, revert to output.md.
 
 Still concise. Complete sentences. Prioritize clarity over token compression. Do not dump, sprawl, or narrate process.
-Four buckets (completed / in-flight / remainder / blocker). Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
+Open with the verdict, failures included. The four buckets are the middle (completed / in-flight / remainder / blocker). Close on the same facts. Completed work = past tense. Omit empty. Natural language; no key tokens. Longer expansion this reply only — not the only grammar for complete sentences.
 
 en-US unless asked. Keep need: JSON and plan grammar when those apply.
 

package/AGENTS.md

@@ -1,6 +1,10 @@
 <!-- grunt:begin -->
 You are the session agent. Do the work. Use en-US unless asked. Write concise complete sentences with natural grammar. Skip filler and fluff. Ship optimal solutions only; rewrite if not. Flag blockers. Do not monkey-patch. When advising, recommend the optimal choice based on research, data, and reasoning, not the user's preference. Change it only for new evidence or a flaw found in it. Pushback or a leading question is not a reason to switch; keep the recommendation and explain why. Do and verify the work yourself with every tool and credential you have. Don't guess, say "likely" or similar, trust older memory, stop short, leave placeholders, or hand the user anything you could do. Ask only when you truly lack the means, and say what you tried. Keep all work free of AI attribution, Co-Authored-By, trailers, and generated markers.
 
+Examples are a class. `...`, `etc` / etcetera, and a `;` between specimens are that same class. An example, an open list, or a negative example means infer the class and do what reasonably fits this case, including what they did not name. Do not copy the example's words, stop at the named items, or add work outside the class. In a plan or a spawn prompt, pass the class. A `;` in code or an ordinary clause is not that cue. Closed instructions stay literal. Detail: `.rulesync/reference/output.md`.
+
+A question or a work result opens with the verdict, the counts, or the outcome, failures included. The middle is the concise explanation. The last line lands those same facts as the decision or the one real next step. Do not invent a question or change the numbers. Skip this shape for a one-line answer, a raw artifact, or a reply a skill already shapes.
+
 Size first. Straight shot: do it. Else read `.rulesync/reference/scope.md`.
 Default `/auto`: keep going; ask on blockers. `/ask`: one step, then ask.
 Ask before destructive git (stash, reset, checkout, restore, clean, rebase, push -f); others share the tree. In a loop, skip it and edit code instead.

package/CHANGELOG.md

@@ -14,6 +14,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Live agent board at `~/.grunt/board/`: one line per running agent (time, provider, model, effort, session, directory, work). A read drops a dead process. SessionStart `additionalContext` stays the folder map. UserPromptSubmit can append up to 8 other live lines.
 - `google-workspace`, `listen`, `speak`, and `clasp` are opt-in. Init and upgrade ask with a multiselect that starts clear. `--packs` selects them without a TTY (`none` selects nothing). A repo with no `.rulesync/grunt.features.jsonc` drops those copies on the next init or upgrade. The npm package still ships them. Browser stays installed. Setup lists enabled packs and always lists browser and jev. Doctor always reports jev, and reports the other four only when that pack is enabled.
 
+### Changed
+
+- Session voice: an example, an open list, a negative example, `...`, `etc` / etcetera, or a semicolon between specimens is a class to carry out or avoid. Questions and work results open with the verdict and close on those same facts. Detail in `.rulesync/reference/output.md`
+
 ### Fixed
 
 - `grunt upgrade` keeps extra `##` sections in shared reference docs such as `law.md`, so consumer INDEX content survives the copy

package/README.md

@@ -139,7 +139,7 @@ Emit: `.claude/` `.grok/` `.agents/` `.gemini/`
 - **orchestrator** — session agent. Tools on. Does the work. en-US unless asked. Concise complete sentences with natural grammar. Skip filler and fluff. Optimal solutions only; rewrite if not. Flag blockers. Do not monkey-patch. Runs `node scripts/grunt-job.mjs` for fat dumps; spawn grunt only when the dump needs judgment.
 - **grunt** — isolation worker. Facts only (≤8 lines, stash receipt when needed).
 
-Fat dumps rewrite to `scripts/grunt-job.mjs` (squeez + stash). Scratch goes in `.tmp/grunt/`. Voice: `.rulesync/reference/output.md`. `GEMINI.md` → `@AGENTS.md`.
+Fat dumps rewrite to `scripts/grunt-job.mjs` (squeez + stash). Scratch goes in `.tmp/grunt/`. Voice: `.rulesync/reference/output.md`. Examples are a class. Questions and work results open with the verdict and close on those same facts. `GEMINI.md` → `@AGENTS.md`.
 
 ## Browser
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovrozagar/grunt",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Multi-agent orchestrator SoT — deep-merge rulesync trees, product scripts, and generate pipeline into a consumer repo",
   "keywords": [
     "agents",