@skill-map/cli 0.43.0 → 0.45.0

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.
Files changed (46) hide show
  1. package/dist/cli/tutorial/sm-master/SKILL.md +7 -9
  2. package/dist/cli/tutorial/sm-master/references/fixture-templates.md +1 -1
  3. package/dist/cli/tutorial/sm-master/references/tour-plugins.md +10 -9
  4. package/dist/cli/tutorial/sm-master/references/tour-settings.md +4 -4
  5. package/dist/cli/tutorial/sm-tutorial/SKILL.md +263 -369
  6. package/dist/cli.js +945 -256
  7. package/dist/cli.js.map +1 -1
  8. package/dist/index.js +21 -15
  9. package/dist/index.js.map +1 -1
  10. package/dist/kernel/index.d.ts +43 -6
  11. package/dist/kernel/index.js +21 -15
  12. package/dist/kernel/index.js.map +1 -1
  13. package/dist/ui/chunk-27WQPOXP.js +1 -0
  14. package/dist/ui/{chunk-DZBSELHN.js → chunk-43S72FTV.js} +1 -1
  15. package/dist/ui/chunk-555ST76V.js +1 -0
  16. package/dist/ui/{chunk-JPYAASHN.js → chunk-5AD5ZV4I.js} +3 -3
  17. package/dist/ui/{chunk-CFJBTDAA.js → chunk-5ITZXW3A.js} +1 -1
  18. package/dist/ui/chunk-A7PRWMQD.js +1021 -0
  19. package/dist/ui/chunk-CBI77N5U.js +123 -0
  20. package/dist/ui/chunk-F7I6KMHX.js +1 -0
  21. package/dist/ui/{chunk-77J7XU3Y.js → chunk-I5AX4U2N.js} +28 -28
  22. package/dist/ui/chunk-IUZRAD7S.js +1 -0
  23. package/dist/ui/{chunk-XOHD5XWA.js → chunk-IYM26L3O.js} +1 -1
  24. package/dist/ui/{chunk-SBCO7ZSP.js → chunk-LGFABCIA.js} +1 -1
  25. package/dist/ui/{chunk-IUDL3NDH.js → chunk-MFLFIA7C.js} +1 -1
  26. package/dist/ui/chunk-MS6B7344.js +315 -0
  27. package/dist/ui/chunk-P3SNMV4X.js +2 -0
  28. package/dist/ui/chunk-PZQHB7GS.js +4 -0
  29. package/dist/ui/chunk-QDUSFOBE.js +1 -0
  30. package/dist/ui/{chunk-YCR3XCIW.js → chunk-QNTAOR2L.js} +5 -5
  31. package/dist/ui/{chunk-CR3AANNX.js → chunk-S4S5ZMXJ.js} +1 -1
  32. package/dist/ui/{chunk-5WJRN3LD.js → chunk-T3IVIRRJ.js} +1 -1
  33. package/dist/ui/{chunk-HP375T2O.js → chunk-VGPYYAVI.js} +1 -1
  34. package/dist/ui/chunk-X227ITGS.js +499 -0
  35. package/dist/ui/index.html +1 -1
  36. package/dist/ui/main-ERCTR2PR.js +3 -0
  37. package/package.json +10 -9
  38. package/dist/ui/chunk-2IF446BS.js +0 -1
  39. package/dist/ui/chunk-DIKPNZUZ.js +0 -315
  40. package/dist/ui/chunk-KGCJINI6.js +0 -1
  41. package/dist/ui/chunk-PPE3P2JD.js +0 -1
  42. package/dist/ui/chunk-UOCACZLI.js +0 -123
  43. package/dist/ui/chunk-YL6SWAFJ.js +0 -1024
  44. package/dist/ui/main-VHFB7Q2D.js +0 -3
  45. /package/dist/ui/{chunk-C2YUQODZ.js → chunk-4SG4352Z.js} +0 -0
  46. /package/dist/ui/{chunk-VB56BUGO.js → chunk-WCABR6TI.js} +0 -0
@@ -13,8 +13,6 @@ description: |
13
13
  pause/resume. Triggers: "sm-master", "advanced tutorial", "master
14
14
  tutorial", "tutorial avanzado", "tutorial maestro", "go deeper".
15
15
  ---
16
-
17
- saludo primero al usuario, dile "holaaaa16!"
18
16
 
19
17
  # sm-master: advanced walkthrough for skill-map
20
18
 
@@ -203,7 +201,7 @@ host-dependent rendering rule).
203
201
  file under `references/tour-*.md`) says `.claude/<…>`, swap it
204
202
  for the detected `<provider_dir>`. Skip any fixture file or step
205
203
  whose kind is not in the provider's supported set (`agent-skills`
206
- / Antigravity: only the skill + the markdown note are valid).
204
+ / Antigravity: only the skill + the markdown node are valid).
207
205
 
208
206
  **Reality check (don't mention)**: this skill ships at
209
207
  `.claude/skills/sm-master/`, so in practice Claude Code is the
@@ -317,7 +315,7 @@ Save the version internally and move on. Only break the silence if
317
315
  something fails.
318
316
 
319
317
  If `sm` is not installed, point them at `npm install -g
320
- @skill-map/cli` (Node 20+).
318
+ @skill-map/cli` (Node 24+).
321
319
 
322
320
  ### 3. Create the initial fixture
323
321
 
@@ -337,13 +335,13 @@ inicial" / "directorio limpio" out loud, those are agent-internal
337
335
  concepts the tester does not need.
338
336
 
339
337
  The fixture is **smaller than `sm-tutorial`'s** because the lessons
340
- focus on plugins, settings, and slots, not on graph topology. Three
338
+ focus on plugins, settings, and slots, not on map topology. Three
341
339
  nodes are enough. Read `references/fixture-templates.md` for the
342
340
  verbatim layout and file contents, then write each file to the cwd
343
341
  under the detected `<provider_dir>` (per §Provider detection).
344
342
  **Skip files whose kind is not in the provider's supported set**:
345
- on `agent-skills` / Antigravity keep only skill + note (no agent
346
- kind there). Translate the natural-language
343
+ on `agent-skills` / Antigravity keep only skill + markdown (no
344
+ agent kind there). Translate the natural-language
347
345
  prose to the tester's language; keep paths, frontmatter keys,
348
346
  identifiers, and link targets in English.
349
347
 
@@ -374,7 +372,7 @@ backstage, between writing the fixture and writing
374
372
 
375
373
  These three names must be in place BEFORE the first `sm scan`
376
374
  the tester runs in step 1; otherwise the scanner picks them
377
- up as graph nodes and pollutes the issue count. The append is
375
+ up as nodes in the map and pollutes the issue count. The append is
378
376
  a backstage edit (Inviolable rule #2): no tester-facing
379
377
  message, no preview, no confirmation.
380
378
 
@@ -674,7 +672,7 @@ anything**:
674
672
 
675
673
  ## Edge cases
676
674
 
677
- - **Tester does not have Node 20+** → guide them to `nvm` or
675
+ - **Tester does not have Node 24+** → guide them to `nvm` or
678
676
  nodejs.org. Don't try to install Node for them.
679
677
  - **Port 4242 in use** when a tour asks them to run `sm` →
680
678
  `sm serve --port 4243` (bare `sm` does not accept flags). The
@@ -46,7 +46,7 @@ keys, identifiers, and link targets in English.
46
46
  name: master-agent
47
47
  description: |
48
48
  Example agent used by the advanced tutorial. Has a couple of
49
- tools so the `core/tools-count` extractor emits a count.
49
+ tools so the `core/tools-counter` extractor emits a count.
50
50
  tools: [Read, Bash, Edit]
51
51
  model: sonnet
52
52
  metadata:
@@ -23,7 +23,7 @@ restore the files.") and stop.
23
23
  ## Step `tour-1-intro` — how plugins work (~4 min)
24
24
 
25
25
  **Context**: A short tour of what a plugin is, how they're
26
- packaged into bundles, and a peek at the four bundles that ship
26
+ packaged into bundles, and a peek at the five bundles that ship
27
27
  pre-installed.
28
28
 
29
29
  > Plugins are how skill-map gets extended. A **plugin** groups one
@@ -55,7 +55,7 @@ pre-installed.
55
55
  sm plugins list
56
56
  ```
57
57
 
58
- > There are the four bundles. The next step zooms into the six
58
+ > There are the five bundles. The next step zooms into the six
59
59
  > kinds of extension that bundles can carry, you'll see at least
60
60
  > one of each living inside `core`.
61
61
 
@@ -75,19 +75,19 @@ Mark `tour-1-intro: done`.
75
75
  > 🔍 **extractor**
76
76
  > Reads a node's body and emits structured findings (links,
77
77
  > counts, annotations).
78
- > Example: `markdown-link`, `external-url-counter`, `tools-count`.
78
+ > Example: `markdown-link`, `external-url-counter`, `tools-counter`.
79
79
  >
80
80
  > 🩺 **analyzer**
81
81
  > Cross-checks the scan and emits issues plus various
82
82
  > detections (errors, warnings, informational signals: broken
83
83
  > refs, stale annotations, schema drift, and more).
84
- > Example: `broken-ref`, `stability`, `unknown-field`.
84
+ > Example: `reference-broken`, `node-stability`, `annotation-field-unknown`.
85
85
  >
86
86
  > ⚡ **action**
87
87
  > Performs a write operation on a node, the graph, or the
88
88
  > filesystem. May modify your `.md` files (frontmatter, body)
89
89
  > ONLY with your explicit permission.
90
- > Examples: `bump`, `mark-superseded`.
90
+ > Examples: `node-bump`, `node-supersede`.
91
91
  >
92
92
  > 🎨 **formatter**
93
93
  > Renders a result in a specific shape (`sm export --format md`
@@ -118,9 +118,10 @@ Mark `tour-1-intro: done`.
118
118
  sm plugins show core
119
119
  ```
120
120
 
121
- Expected: a table with 24 rows, each carrying `kind/id@version`.
122
- You can spot at least one of each of the six kinds you just read
123
- about, all packed into a single bundle.
121
+ Expected: the 28 extensions grouped by kind, each row showing its
122
+ kind and qualified id (e.g. `extractor core/markdown-link`). You
123
+ can spot at least one of each of the six kinds you just read about,
124
+ all packed into a single bundle.
124
125
 
125
126
  Mark `tour-2-kinds: done`.
126
127
 
@@ -149,7 +150,7 @@ Kind, Version, Stability, Description, Preconditions, Entry).
149
150
  sm plugins doctor
150
151
  ```
151
152
 
152
- Expected on a clean machine: `27 enabled · 0 issues · 0 warnings`.
153
+ Expected on a clean machine: `34 enabled extensions · 0 issues · 0 warnings`.
153
154
  If any plugin reports a load error, manifest validity issue, or
154
155
  spec-compatibility mismatch, `doctor` is the verb that flags it.
155
156
 
@@ -111,7 +111,7 @@ Mark `settings-2-local: done`.
111
111
 
112
112
  > Last step. Let's see a contribution land in the inspector
113
113
  > live. The fixture's `master-agent` declares `tools: [Read,
114
- > Bash, Edit]`, which the `core/tools-count` extractor picks up.
114
+ > Bash, Edit]`, which the `core/tools-counter` extractor picks up.
115
115
 
116
116
  If the tester does not have `sm` running, ask them to launch it
117
117
  in their second terminal (same drill as the basic tutorial:
@@ -126,7 +126,7 @@ Once the UI is open, ask the tester to:
126
126
 
127
127
  > Click the `master-agent` node. The inspector opens on the
128
128
  > right side. Look at the **header badge cluster** (just under
129
- > the title): you should see a small chip from `tools-count`
129
+ > the title): you should see a small chip from `tools-counter`
130
130
  > showing the value `3`.
131
131
  >
132
132
  > That chip is a plugin contribution. It landed in the slot
@@ -146,7 +146,7 @@ remove one tool), save, and watch the chip refresh.
146
146
 
147
147
  > Same flow as the basic tutorial's live UI: edit the markdown,
148
148
  > watch the UI refresh. The difference is that the value flowed
149
- > through a plugin (`core/tools-count`) and landed in a specific
149
+ > through a plugin (`core/tools-counter`) and landed in a specific
150
150
  > slot (`inspector.header.badge.counter`). You now know the full
151
151
  > path from `.md` to UI chip.
152
152
 
@@ -165,6 +165,6 @@ Not for the tester unless they ask. Cheat sheet for the agent:
165
165
  binding).
166
166
  - **Input-types catalogue (normative)**: `spec/input-types.md`.
167
167
  - **Plugin manifest schema**:
168
- `spec/schemas/plugin-manifest.schema.json`.
168
+ `spec/schemas/plugins-registry.schema.json` (`$defs/PluginManifest`).
169
169
  - **Author tutorial**: `spec/plugin-author-guide.md`.
170
170
  - **Slot annex for agents**: `context/view-slots.md`.