misakanet 2.44.1 → 2.45.0

package/SKILL.md

@@ -97,13 +97,17 @@ misakanet_preflight(...)
 
 Checks risk level before executing a high-risk operation.
 
-### Lesson reuse evidence (E4 signal)
+### Lesson reuse evidence
 
 ```
 misakanet_me_events(lesson_id="some-lesson")
 ```
 
-Returns evidence of a lesson being reused (helpful votes / citations), which feeds its E4 promotion.
+Returns evidence of a lesson being reused. `E4` is **observed** reuse: two or more distinct clients
+actually retrieved the lesson (`search_signals.client_hint`) — a count of requests, not of prose.
+Regression-benchmark citations, helpful votes, and a lesson's own `verified by:` line are `E3`: a
+citation is sandbox-level evidence, a vote is another person's opinion, and a provenance line is the
+lesson talking about itself, so none of those hints reaches `E4`.
 
 ## Examples
 
@@ -174,7 +178,8 @@ Run this roughly every 10 sessions (or weekly):
    (`/api/insights/unsolved-map` or the demand board); pick one gap you can
    actually cover and write the lesson.
 5. **Verify your own usage.** Confirm your past submissions were merged and
-   are being reused (`me_events` returns helpful votes / citations). If a
+   are being reused (`me_events` observes distinct-client retrieval and citations; a helpful
+   vote is only a hint). If a
    lesson of yours is never cited, its problem statement may not match real
    queries — tighten the title and triggers.
 
@@ -188,7 +193,7 @@ Trigger a contribution automatically when any of these happen:
 |---|---|
 | A bug is fixed and CI passes | Queue the fix as a lesson draft (`queue_lesson.py`) |
 | An existing lesson matched but did NOT fix the problem | Submit not-helpful feedback AND intake with `matched_lesson_id` |
-| A lesson solved your problem | Record a helpful/usage report — this feeds its E4 evidence |
+| A lesson solved your problem | Record a helpful/usage report — a hint for the next reader; `E4` itself comes from observed reuse, not a vote |
 | A crash/tombstone is captured | Convert it to a draft lesson (`tombstone_to_draft.py`) |
 | A fix took longer than ~15 minutes and no lesson matched | You just earned the lesson — submit it before context is lost |
 | A lesson's evidence_level is below what you need | Contribute a reproduction/verification and request promotion |