@milehimikey/em 1.14.0 → 1.14.2

package/plugin/shared/reference/slice-doc-schema.md

@@ -480,6 +480,14 @@ diverges from git, grows unboundedly over a long-lived slice's life, and forces
 work out which resolutions are still relevant to the *current* version versus leftover from a
 prior one — exactly the ambiguity a live, current-version-only section avoids.
 
+**Deferral marker (MIL-275).** A question this version will not answer is not left `- [ ]` and
+not deleted: `em slice defer` checks it and rewrites it as `- [x] <original> — v<current>:
+<decision>; deferred to v<n> (<date>[, <by>])`. The `deferred to v<n>` marker is what
+`em slice reratify` reads: when a bump reaches v<n> it rewrites each such item back to
+`- [ ] <original>`, so the question must be resolved or re-deferred before `--slice-ready` passes
+again. The prune rule above does not apply to a deferred item before v<n> (it stays as the
+record); once reopened it is an ordinary open question.
+
 **Not a parsing/grammar change.** `countOpenQuestions()` (`sliceDoc.ts`) and
 `slice-ready-open-questions-unchecked` (`sliceReadyValidate.ts`,
 [validation.md#slice-readiness](https://github.com/milehimikey/em/blob/main/docs/validation.md#slice-readiness)) are unaffected: both already

package/plugin/skills/conform/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: conform
-em-version: 1.14.0
+em-version: 1.14.2
 description: >-
   Use when checking a ratified event model (and its slice docs) for drift against the codebase
   that implements it — advisory only, never a gate, never an unprompted edit — or when walking

package/plugin/skills/design/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: design
-em-version: 1.14.0
+em-version: 1.14.2
 description: >-
   Use when structuring a draft event model into swimlanes and the four patterns (State Change,
   State View, Automation, Translation), evaluating a model's structural completeness, or writing
@@ -212,6 +212,7 @@ For each slice:
    (`em validate` flags a block missing one as `slice-doc/structured-section-malformed`, and
    `--slice-ready` refuses it). A doc written before em 1.14 has no markers; leave it as it is
    unless you are re-creating it (`em slice new … --wire --force`, carrying the prose across).
+   A question this version will not answer is deferred with `em slice defer <model> <key> "<question>" --until v<n> --decision "<what this version does>"` — never left `- [ ]`, never deleted, never answered by guessing.
 2. **First-time authoring:** scaffold the doc mechanically rather than hand-writing the
    frontmatter — `em slice new "<slice name>" --pattern <state-change|state-view|automation|
    translation> --swimlane "<Persona> → <Context>" --wire <model>.em` writes `slices/<slice-name>.md`

package/plugin/skills/discover/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: discover
-em-version: 1.14.0
+em-version: 1.14.2
 description: >-
   Use when starting a brand-new event model from scratch — greenfield discovery: brainstorming
   past-tense events, storyboarding the happy path, finding the commands and read models — or when

package/plugin/skills/engagement/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: engagement
-em-version: 1.14.0
+em-version: 1.14.2
 description: >-
   Use when leading an engagement: building a named set of ratified event-modeling slices
   (`em engagement`) into a stack of PRs by dispatching the em-implementer, em-validator,

package/plugin/skills/event-modeling/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: event-modeling
-em-version: 1.14.0
+em-version: 1.14.2
 description: >-
   Use when the user runs `/em:event-modeling` (with or without a phase name), or wants to resume an
   event-modeling session without specifying which part of the process applies. Reads the model's

package/plugin/skills/implement/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: implement
-em-version: 1.14.0
+em-version: 1.14.2
 description: >-
   Use when building a single ratified event-modeling slice (status: ready-to-implement) into
   merged, tested code — the one phase where the agent builds rather than facilitates. Gates on

package/plugin/skills/implement/reference/implement.md

@@ -229,7 +229,10 @@ a bump here is a ledger defect.
 `em slice mark-implemented <model>.em <slice-key> <pr-url>` does the flip for you (MIL-103) —
 resolves the doc via the same note-binding join `--slice-ready` uses, is idempotent on a re-run
 with the same URL, and refuses (never silently overwrites) if the doc is already `implemented`
-with a different URL. Prefer it over hand-editing the doc's frontmatter.
+with a different URL. It also refuses a doc that isn't `ready-to-implement` (MIL-277): if it
+reports `doc is \`status: draft\``/`reviewed`, the slice was never ratified — stop and surface
+that to the human rather than editing the frontmatter by hand; the §1 gate should have caught it.
+Prefer it over hand-editing the doc's frontmatter.
 
 Then, if the project keeps a model README (from `../../../shared/templates/model-readme.md`), run
 `em slice index <model-name>.em` so its generated Slices table reflects the new status and

package/plugin/skills/review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: review
-em-version: 1.14.0
+em-version: 1.14.2
 description: >-
   Use when starting em's live browser viewer (`em watch --serve`) so a team can watch a model
   update in real time, or facilitating a SCHEDULED stakeholder walkthrough that steps through
@@ -57,7 +57,7 @@ review:` marker (mirrors `Last conformance:`).
 **Per-slice outcome.** A slice whose open questions are all resolved in the room →
 `em slice review <model>.em <key> --by <name>` (flips its doc to `status: reviewed` and records
 `reviewedBy:`/`reviewedOn:`). Anything still open stays `draft` — the walkthrough doesn't decide
-it, the next session or the open-questions list does.
+it, the next session or the open-questions list does. A question this version will not answer is deferred with `em slice defer <model> <key> "<question>" --until v<n> --decision "<what this version does>"` — never left `- [ ]`, never deleted, never answered by guessing.
 
 **The facilitator never ratifies, never offers to ratify, and never suggests ratification in a
 review session. Ratification is a separate human gate after review**