@skill-map/cli 0.68.1 → 0.69.0

package/dist/cli/tutorial/sm-tutorial/references/_core.md

@@ -20,7 +20,7 @@ Two numbering systems coexist; keep them apart:
 
 - **Internal (authoring only)**: the `order` field in `_manifest.yml`
   and the `# Part N` file headers, 0-based (Part 0 the prologue …
-  Part 4 the CLI deep-dive; `mcp` at Part 5 is parked / hidden). Use it
+  Part 3 the CLI deep-dive, Part 4 the Extend dev section; `mcp` at Part 5 is parked / hidden). Use it
   in `**Context**:` blocks and author
   notes; NEVER say it to the tester, it is off by one from what they
   see.
@@ -336,14 +336,23 @@ references all resolve on both), so the rich part bodies are written in the
   "open the agent file" point at the `.toml`; a chapter that has the tester
   read or tweak an agent works on the TOML frontmatter / `developer_instructions`.
 - **No `command` kind.** Where the claude book authors a `command` (the
-  `/publish` command, the reserved-name chapter's `init` command), Codex uses a
+  `/publish` command, the reserved-name chapter's `model` command), Codex uses a
   **skill** at `.agents/skills/<name>/SKILL.md`. The body is identical (same
   `/check-links` + `@content-editor` + deploy reference); only the kind and path
   change. `cat <set> --file … --provider codex` already returns the Codex skill
   body, so the create-the-file block stays a copy-paste. The reserved-name beat
   uses a skill named with a reserved verb (Codex inherits the open-standard
-  `COMMONS_RESERVED_NAMES`, e.g. `config`), exactly like the basic track's
+  `COMMONS_RESERVED_NAMES`, e.g. `model`), exactly like the basic track's
   `reserved` chapter, on a skill instead of a command.
+  **Apply every substitution silently.** Use the Codex path, kind and file
+  directly in the tester-facing prose, but never EXPLAIN the substitution or
+  compare it to the claude shape. The Codex tester only ever sees a `skill`
+  where the claude book has a command; never tell them "Codex has no `command`
+  kind", never say a node "is a command that shows as a skill", never reference
+  "the claude command". On Codex these nodes were always skills, there is
+  nothing to explain. (Same for the TOML-agent and path swaps above: point the
+  tester at the real `.toml` / `.agents/` file when they interact with it, just
+  do not narrate that it "would be" something else on claude.)
 - **Skills** live under `.agents/skills/<name>/SKILL.md` (the open layout Codex
   adopted), same as the basic family.
 - Everything else (the `@`/`/` syntax, the confidence numbers, the hub, the
@@ -444,7 +453,7 @@ promise or pre-announce the next part, the close and the menu own the
 transition. Sample (Claude variant, mirror the tester's language,
 apply the host rendering rule):
 
-> ✓ Listo, terminaste **El proyecto desde cero**. Levantaste un
+> ✓ Listo, terminaste **El harness desde cero**. Levantaste un
 > proyecto real, su handbook y el harness `.claude/` con sus primeros
 > nodos.
 >
@@ -484,7 +493,7 @@ fill the parts and durations from `_manifest.yml`):
 **1. El mapa en vivo** (~12 min)
 > El prólogo: corrés `sm`, abrís el browser y ves el mapa actualizarse en vivo mientras editás `.md`. Si es tu primera vez, empezá por acá.
 
-**2. El proyecto desde cero** (~8 min)
+**2. El harness desde cero** (~8 min)
 > Arrancás un proyecto real (un portfolio) y su harness `.claude/`.
 
 ¿Cuál?
@@ -503,7 +512,7 @@ the title stays plain):
 **1. El mapa en vivo** (~12 min)
 > ✓ Ya la hiciste.
 
-**2. El proyecto desde cero** (~8 min)
+**2. El harness desde cero** (~8 min)
 > Arrancás un proyecto real (un portfolio) y su harness `.claude/`.
 ```
 

package/dist/cli/tutorial/sm-tutorial/references/_manifest.json

@@ -29,7 +29,7 @@
         {
           "id": "connectors",
           "title": "The connectors light up",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "inspector",
@@ -39,17 +39,17 @@
         {
           "id": "edit-link",
           "title": "Edit a link, the topology changes",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "workspace",
           "title": "Navigate the workspace (files, search, isolate)",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "ignore",
           "title": "Silence a file via .skillmapignore",
-          "est_min": 2
+          "est_min": 1
         }
       ]
     },
@@ -82,7 +82,7 @@
         {
           "id": "connectors",
           "title": "Connect with references (markdown links)",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "inspector",
@@ -92,24 +92,24 @@
         {
           "id": "edit-link",
           "title": "Edit a link, the topology changes",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "workspace",
           "title": "Navigate the workspace (files, search, isolate)",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "ignore",
           "title": "Silence a file via .skillmapignore",
-          "est_min": 2
+          "est_min": 1
         }
       ]
     },
     {
       "id": "project-kickoff",
       "order": 1,
-      "title": "The project from zero",
+      "title": "The harness from zero",
       "status": "active",
       "preflight": "portfolio-init",
       "seed": null,
@@ -135,22 +135,22 @@
         {
           "id": "real-kinds",
           "title": "The real kinds in context",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "check-links",
           "title": "The check-links skill",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "publish",
           "title": "The /publish command invokes the skill",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "links",
           "title": "Mentions (@) and references between assets",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "confidence",
@@ -162,7 +162,7 @@
     {
       "id": "basic-kickoff",
       "order": 1,
-      "title": "The project from zero",
+      "title": "The harness from zero",
       "status": "active",
       "preflight": "portfolio-init",
       "seed": null,
@@ -193,22 +193,22 @@
         {
           "id": "check-links",
           "title": "The link checker",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "publish",
           "title": "The publish skill references the harness",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "links",
           "title": "The handbook becomes the hub (references)",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "confidence",
           "title": "Connector confidence (opacity = certainty)",
-          "est_min": 3
+          "est_min": 2
         }
       ]
     },
@@ -226,17 +226,17 @@
         {
           "id": "setup",
           "title": "Make it yours and bring it up",
-          "est_min": 5
+          "est_min": 4
         },
         {
           "id": "add-page",
           "title": "Add a page with your agent",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "broken-ref",
           "title": "A rename breaks a link",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "reserved",
@@ -246,7 +246,7 @@
         {
           "id": "publish",
           "title": "Ship it: run /publish for real",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "stability",
@@ -274,17 +274,17 @@
         {
           "id": "setup",
           "title": "Make it yours and bring it up",
-          "est_min": 5
+          "est_min": 4
         },
         {
           "id": "add-page",
           "title": "Add a page with your skill",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "broken-ref",
           "title": "A rename breaks a link",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "reserved",
@@ -294,7 +294,7 @@
         {
           "id": "publish",
           "title": "Ship it: run the publish skill for real",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "stability",
@@ -309,9 +309,47 @@
       ]
     },
     {
-      "id": "extend",
+      "id": "cli",
       "order": 3,
-      "title": "Extend skill-map for the site",
+      "title": "The CLI for you and your agent",
+      "status": "active",
+      "preflight": "seed",
+      "seed": "prologue-built",
+      "prereq": "fundamentals",
+      "pace": "auto-advance",
+      "track": "both",
+      "chapters": [
+        {
+          "id": "browse",
+          "title": "list / show / check",
+          "est_min": 2
+        },
+        {
+          "id": "graph-export",
+          "title": "graph / export (query, formatters)",
+          "est_min": 2
+        },
+        {
+          "id": "issues",
+          "title": "Issues and broken refs (--analyzers, --json)",
+          "est_min": 2
+        },
+        {
+          "id": "annotations",
+          "title": "Annotations and the .sm consent prompt",
+          "est_min": 3
+        },
+        {
+          "id": "reference-paths",
+          "title": "Validate links to folders outside the scan scope",
+          "est_min": 3
+        }
+      ]
+    },
+    {
+      "id": "extend",
+      "order": 4,
+      "title": "Extend skill-map with plugins",
       "status": "active",
       "preflight": "backstage-init",
       "seed": null,
@@ -332,22 +370,22 @@
         {
           "id": "settings-3-lens",
           "title": "The active provider lens (`activeProvider`)",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "tour-1-intro",
           "title": "How plugins work",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "tour-2-kinds",
           "title": "The six extension kinds",
-          "est_min": 5
+          "est_min": 4
         },
         {
           "id": "tour-3-explore",
           "title": "Explore one extension up close",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "authoring-1-scaffold",
@@ -376,44 +414,6 @@
         }
       ]
     },
-    {
-      "id": "cli",
-      "order": 4,
-      "title": "The CLI in depth",
-      "status": "active",
-      "preflight": "seed",
-      "seed": "prologue-built",
-      "prereq": "fundamentals",
-      "pace": "auto-advance",
-      "track": "both",
-      "chapters": [
-        {
-          "id": "browse",
-          "title": "list / show / check",
-          "est_min": 3
-        },
-        {
-          "id": "graph-export",
-          "title": "graph / export (query, formatters)",
-          "est_min": 3
-        },
-        {
-          "id": "issues",
-          "title": "Issues and broken refs (--analyzers, --json)",
-          "est_min": 3
-        },
-        {
-          "id": "annotations",
-          "title": "Annotations and the .sm consent prompt",
-          "est_min": 3
-        },
-        {
-          "id": "reference-paths",
-          "title": "Validate links to folders outside the scan scope",
-          "est_min": 4
-        }
-      ]
-    },
     {
       "id": "mcp",
       "order": 5,

package/dist/cli/tutorial/sm-tutorial/references/_manifest.yml

@@ -53,11 +53,11 @@ parts:
       - id: init            ; title: "Your first node (sm init, sm, the UI)" ; est_min: 2
       - id: kinds           ; title: "The other kinds appear"               ; est_min: 1
       - id: first-edit      ; title: "Your first edit (the watcher reacts)" ; est_min: 1
-      - id: connectors      ; title: "The connectors light up"             ; est_min: 2
+      - id: connectors      ; title: "The connectors light up"             ; est_min: 1
       - id: inspector       ; title: "The inspector and connections"       ; est_min: 1
-      - id: edit-link       ; title: "Edit a link, the topology changes"   ; est_min: 3
-      - id: workspace       ; title: "Navigate the workspace (files, search, isolate)" ; est_min: 2
-      - id: ignore          ; title: "Silence a file via .skillmapignore"  ; est_min: 2
+      - id: edit-link       ; title: "Edit a link, the topology changes"   ; est_min: 2
+      - id: workspace       ; title: "Navigate the workspace (files, search, isolate)" ; est_min: 1
+      - id: ignore          ; title: "Silence a file via .skillmapignore"  ; est_min: 1
 
   - id: basic-fundamentals
     order: 0
@@ -72,15 +72,15 @@ parts:
       - id: init            ; title: "Your first node (sm init, sm, the UI)" ; est_min: 2
       - id: kinds           ; title: "Skills and notes appear"             ; est_min: 1
       - id: first-edit      ; title: "Your first edit (the watcher reacts)" ; est_min: 1
-      - id: connectors      ; title: "Connect with references (markdown links)" ; est_min: 2
+      - id: connectors      ; title: "Connect with references (markdown links)" ; est_min: 1
       - id: inspector       ; title: "The inspector and connections"       ; est_min: 1
-      - id: edit-link       ; title: "Edit a link, the topology changes"   ; est_min: 3
-      - id: workspace       ; title: "Navigate the workspace (files, search, isolate)" ; est_min: 2
-      - id: ignore          ; title: "Silence a file via .skillmapignore"  ; est_min: 2
+      - id: edit-link       ; title: "Edit a link, the topology changes"   ; est_min: 2
+      - id: workspace       ; title: "Navigate the workspace (files, search, isolate)" ; est_min: 1
+      - id: ignore          ; title: "Silence a file via .skillmapignore"  ; est_min: 1
 
   - id: extend
-    order: 3
-    title: "Extend skill-map for the site"
+    order: 4
+    title: "Extend skill-map with plugins"
     # Spans three chapter libraries; dispatch by chapter-id prefix:
     #   settings-*  -> part-settings.md
     #   tour-*      -> part-plugins.md
@@ -97,10 +97,10 @@ parts:
     chapters:
       - id: settings-1-layers        ; title: "The config layers and `sm config list`" ; est_min: 3
       - id: settings-2-resolve       ; title: "Read, resolve, and set a value with `sm config`" ; est_min: 3
-      - id: settings-3-lens          ; title: "The active provider lens (`activeProvider`)" ; est_min: 4
-      - id: tour-1-intro             ; title: "How plugins work" ; est_min: 4
-      - id: tour-2-kinds             ; title: "The six extension kinds" ; est_min: 5
-      - id: tour-3-explore           ; title: "Explore one extension up close" ; est_min: 4
+      - id: settings-3-lens          ; title: "The active provider lens (`activeProvider`)" ; est_min: 3
+      - id: tour-1-intro             ; title: "How plugins work" ; est_min: 3
+      - id: tour-2-kinds             ; title: "The six extension kinds" ; est_min: 4
+      - id: tour-3-explore           ; title: "Explore one extension up close" ; est_min: 3
       - id: authoring-1-scaffold     ; title: "`sm plugins create extractor demo-highlight`" ; est_min: 2
       - id: authoring-2-anatomy      ; title: "Tour the scaffold (plugin.json + stubs + README)" ; est_min: 3
       - id: authoring-3-edit-setting ; title: "Edit a setting (string-list) and observe it in the UI" ; est_min: 3
@@ -108,8 +108,8 @@ parts:
       - id: authoring-5-doctor-author ; title: "Catch a manifest mistake with `sm plugins doctor`" ; est_min: 2
 
   - id: cli
-    order: 4
-    title: "The CLI in depth"
+    order: 3
+    title: "The CLI for you and your agent"
     step_file: part-cli.md
     pace: auto-advance
     preflight: seed            # self-seeds the Part 0 demo fixture
@@ -118,11 +118,11 @@ parts:
     track: both                # CLI verbs are lens-agnostic; prose notes lens-specific node counts
     status: active
     chapters:
-      - id: browse           ; title: "list / show / check" ; est_min: 3
-      - id: graph-export     ; title: "graph / export (query, formatters)" ; est_min: 3
-      - id: issues           ; title: "Issues and broken refs (--analyzers, --json)" ; est_min: 3
+      - id: browse           ; title: "list / show / check" ; est_min: 2
+      - id: graph-export     ; title: "graph / export (query, formatters)" ; est_min: 2
+      - id: issues           ; title: "Issues and broken refs (--analyzers, --json)" ; est_min: 2
       - id: annotations      ; title: "Annotations and the .sm consent prompt" ; est_min: 3
-      - id: reference-paths  ; title: "Validate links to folders outside the scan scope" ; est_min: 4
+      - id: reference-paths  ; title: "Validate links to folders outside the scan scope" ; est_min: 3
 
   # ----- the portfolio campaign (the spine's real project) -----
   # Each part builds on the prior one's accumulated harness. Run in
@@ -133,7 +133,7 @@ parts:
 
   - id: project-kickoff
     order: 1
-    title: "The project from zero"
+    title: "The harness from zero"
     step_file: part-project-kickoff.md
     pace: per-step
     preflight: portfolio-init   # lays the Express skeleton + AGENTS.md; clears the prologue demo fixture if present
@@ -144,10 +144,10 @@ parts:
       - id: kickoff     ; title: "Start the portfolio (sm init on the real skeleton)" ; est_min: 2
       - id: manual      ; title: "The handbook (AGENTS.md) and CLAUDE.md" ; est_min: 2
       - id: first-agent ; title: "The first harness agent (content-editor)" ; est_min: 2
-      - id: real-kinds  ; title: "The real kinds in context" ; est_min: 2
-      - id: check-links ; title: "The check-links skill" ; est_min: 2
-      - id: publish     ; title: "The /publish command invokes the skill" ; est_min: 3
-      - id: links       ; title: "Mentions (@) and references between assets" ; est_min: 3
+      - id: real-kinds  ; title: "The real kinds in context" ; est_min: 1
+      - id: check-links ; title: "The check-links skill" ; est_min: 1
+      - id: publish     ; title: "The /publish command invokes the skill" ; est_min: 2
+      - id: links       ; title: "Mentions (@) and references between assets" ; est_min: 2
       - id: confidence  ; title: "Connector confidence (opacity = certainty)" ; est_min: 2
 
   - id: daily-loop
@@ -162,11 +162,11 @@ parts:
     track: rich               # agent-driven page add + reserved command; basic track has its own counterpart
     status: active
     chapters:
-      - id: setup            ; title: "Make it yours and bring it up" ; est_min: 5
-      - id: add-page         ; title: "Add a page with your agent" ; est_min: 4
-      - id: broken-ref       ; title: "A rename breaks a link" ; est_min: 4
+      - id: setup            ; title: "Make it yours and bring it up" ; est_min: 4
+      - id: add-page         ; title: "Add a page with your agent" ; est_min: 3
+      - id: broken-ref       ; title: "A rename breaks a link" ; est_min: 3
       - id: reserved         ; title: "A reserved name collides" ; est_min: 2
-      - id: publish          ; title: "Ship it: run /publish for real" ; est_min: 4
+      - id: publish          ; title: "Ship it: run /publish for real" ; est_min: 3
       - id: stability        ; title: "Set a node's stability (and the `.sm` sidecar)" ; est_min: 3
       - id: golive           ; title: "Your website, live next to the graph" ; est_min: 3
 
@@ -177,7 +177,7 @@ parts:
 
   - id: basic-kickoff
     order: 1
-    title: "The project from zero"
+    title: "The harness from zero"
     step_file: part-basic-kickoff.md
     pace: per-step
     preflight: portfolio-init
@@ -189,10 +189,10 @@ parts:
       - id: manual       ; title: "The handbook (AGENTS.md) and an entry pointer" ; est_min: 2
       - id: first-skill  ; title: "The first harness skill (content-editor)" ; est_min: 2
       - id: real-kinds   ; title: "The kinds in context" ; est_min: 2
-      - id: check-links ; title: "The link checker" ; est_min: 3
-      - id: publish     ; title: "The publish skill references the harness" ; est_min: 4
-      - id: links       ; title: "The handbook becomes the hub (references)" ; est_min: 4
-      - id: confidence  ; title: "Connector confidence (opacity = certainty)" ; est_min: 3
+      - id: check-links ; title: "The link checker" ; est_min: 2
+      - id: publish     ; title: "The publish skill references the harness" ; est_min: 3
+      - id: links       ; title: "The handbook becomes the hub (references)" ; est_min: 3
+      - id: confidence  ; title: "Connector confidence (opacity = certainty)" ; est_min: 2
 
   - id: basic-daily
     order: 2
@@ -206,11 +206,11 @@ parts:
     track: basic
     status: active
     chapters:
-      - id: setup       ; title: "Make it yours and bring it up" ; est_min: 5
-      - id: add-page    ; title: "Add a page with your skill" ; est_min: 4
-      - id: broken-ref  ; title: "A rename breaks a link" ; est_min: 4
+      - id: setup       ; title: "Make it yours and bring it up" ; est_min: 4
+      - id: add-page    ; title: "Add a page with your skill" ; est_min: 3
+      - id: broken-ref  ; title: "A rename breaks a link" ; est_min: 3
       - id: reserved    ; title: "A reserved name collides" ; est_min: 2
-      - id: publish     ; title: "Ship it: run the publish skill for real" ; est_min: 4
+      - id: publish     ; title: "Ship it: run the publish skill for real" ; est_min: 3
       - id: stability   ; title: "Set a node's stability (and the `.sm` sidecar)" ; est_min: 3
       - id: golive      ; title: "Your website, live next to the graph" ; est_min: 3
 

package/dist/cli/tutorial/sm-tutorial/references/fixtures.md

@@ -40,8 +40,8 @@ fixtures-data/
 | `prologue` | the seven Part 0 demo nodes | Part 0 (progressive, `--only`), `prologue-built` seed |
 | `portfolio` | Express skeleton, handbook, `content-editor`, `docs/STYLE` + `DEPLOY` | Part 1 (`--only` boot, chapters lay the rest), `harness-connected` seed |
 | `harness` | `check-links` skill, `publish` command | Part 1 connect chapters, `harness-connected` seed |
-| `master` | `master-agent`, `master-skill`, `notes/ideas` | Part 3 `backstage-init` |
-| `cli-external` | `link-validation/hijoA` + `hijoB` | Part 4 `reference-paths` |
+| `master` | `master-agent`, `master-skill`, `notes/ideas` | Part 4 `backstage-init` |
+| `cli-external` | `link-validation/hijoA` + `hijoB` | Part 3 `reference-paths` |
 
 ## Edits (append fragments)
 
@@ -62,7 +62,7 @@ entered out of order.
 
 | Seed | Lays | Edits | Drops |
 |---|---|---|---|
-| `prologue-built` (Part 4) | `prologue` | `todo-connectors` | `notes/private-credentials.md` |
+| `prologue-built` (Part 3) | `prologue` | `todo-connectors` | `notes/private-credentials.md` |
 | `harness-connected` (Part 2) | `portfolio` + `harness` | `agents-hub`, `content-editor-style` | , |
 
 ## Footprints (what `clear` and `wipe` remove)

package/dist/cli/tutorial/sm-tutorial/references/part-authoring.md

@@ -1,6 +1,6 @@
-# Part 3 (c): Extend skill-map - build plugins (step library, `authoring-*` ids)
+# Part 4 (c): Extend skill-map - build plugins (step library, `authoring-*` ids)
 
-Step bodies for the plugin-authoring chapters of Part 3.
+Step bodies for the plugin-authoring chapters of Part 4.
 The SKILL.md orchestrator dispatches each `authoring-*` chapter id
 here; `settings-*` ids it dispatches to `part-settings.md`.
 
@@ -41,6 +41,7 @@ Created /<cwd>/.skill-map/plugins/demo-highlight
 Next:
   - Edit extractors/demo-highlight-extractor/index.js
   - Run sm plugins doctor to confirm it loads
+  - Run sm plugins trust demo-highlight to let its code run (project-local plugins are untrusted until you allow them)
   - sm plugins slots list: browse slots and input-types
 ```
 
@@ -48,6 +49,28 @@ Next:
 slashes, no uppercase. `demo-highlight` is fine, `demo/highlight`
 or `Demo-Highlight` are rejected.
 
+**Trust it before it can run.** A project-local plugin you just dropped
+into `.skill-map/plugins/` is discovered but its code does NOT run until
+you trust it on this machine, a security gate so cloning a repo never
+auto-executes its plugins behind your back. The plugin is yours (you just
+wrote it), so grant trust now; the next chapters need it to run. Tell the
+tester:
+
+> One more step before your plugin can run. skill-map found it but will
+> not execute its code until you **trust** it, your local consent that
+> this code may run on your machine. It is yours, so trust it:
+
+```bash
+sm plugins trust demo-highlight
+```
+
+> Two separate ideas, on purpose: **enable** says "this plugin is part of
+> the project" (shared, lives in the config), **trust** says "I let it run
+> on this machine" (local, never travels in a commit). A scaffolded plugin
+> is enabled by default, so trusting it is all it needs to run. You can
+> revoke later with `sm plugins untrust demo-highlight`, or use the
+> per-plugin Trust control in the Settings UI.
+
 Mark `authoring-1-scaffold: done`.
 
 ## Step `authoring-2-anatomy` - tour the scaffold (~3 min)
@@ -162,12 +185,6 @@ the browser, click `notes/ideas`, and find the chip in the card's
 **left footer** (it also shows in the inspector). It reads
 `🔍 kw 3`, one match per keyword.
 
-> Heads up: editing only the fixture (`notes/ideas.md`) updates
-> live through the watcher, but it recounts with the OLD keyword
-> set, so the chip would read `🔍 kw 2`. The new `XXX` keyword
-> lives in the plugin, and the plugin is read at boot, that is why
-> restarting `sm` is the step that takes the count to 3.
-
 > Three matches. The setting flowed from the extension's `settings`
 > through `ctx.settings.keywords` into the extractor, the extractor
 > counted them, the kernel persisted the contribution, and the UI