@skill-map/cli 0.18.0 → 0.19.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 (41) hide show
  1. package/README.md +4 -0
  2. package/dist/cli/tutorial/sm-tutorial.md +6 -7
  3. package/dist/cli.js +7011 -4047
  4. package/dist/cli.js.map +1 -1
  5. package/dist/index.d.ts +1 -1
  6. package/dist/index.js +277 -42
  7. package/dist/index.js.map +1 -1
  8. package/dist/kernel/index.d.ts +566 -68
  9. package/dist/kernel/index.js +277 -42
  10. package/dist/kernel/index.js.map +1 -1
  11. package/dist/migrations/001_initial.sql +122 -12
  12. package/dist/ui/chunk-7CAK6MVK.js +2638 -0
  13. package/dist/ui/chunk-BORRASJB.js +247 -0
  14. package/dist/ui/chunk-CZSS4D6J.js +454 -0
  15. package/dist/ui/chunk-EQD7AYYJ.js +227 -0
  16. package/dist/ui/chunk-ETTRVTFV.js +1 -0
  17. package/dist/ui/chunk-LFIE4SCX.js +965 -0
  18. package/dist/ui/chunk-OKO3QOH6.js +1 -0
  19. package/dist/ui/chunk-PMIMYHBM.js +61 -0
  20. package/dist/ui/chunk-UHFGCO24.js +1 -0
  21. package/dist/ui/chunk-VHIPW3TH.js +1 -0
  22. package/dist/ui/chunk-VWAUXWQX.js +237 -0
  23. package/dist/ui/index.html +10 -2
  24. package/dist/ui/main-BSYMJKTL.js +1 -0
  25. package/dist/ui/{styles-CBPFNGXA.css → styles-UAABA7VK.css} +1 -1
  26. package/migrations/001_initial.sql +122 -12
  27. package/package.json +2 -2
  28. package/dist/migrations/002_sidecar_columns.sql +0 -53
  29. package/dist/migrations/003_drop_node_author.sql +0 -20
  30. package/dist/migrations/004_sidecar_root_json.sql +0 -23
  31. package/dist/migrations/005_node_favorites.sql +0 -20
  32. package/dist/ui/chunk-JKJGGXCS.js +0 -1025
  33. package/dist/ui/chunk-SX2A3WBX.js +0 -247
  34. package/dist/ui/chunk-TWZHUCAT.js +0 -237
  35. package/dist/ui/chunk-WTAL2RK4.js +0 -1
  36. package/dist/ui/chunk-Z3UJHHTC.js +0 -3091
  37. package/dist/ui/main-AAYGMON4.js +0 -1
  38. package/migrations/002_sidecar_columns.sql +0 -53
  39. package/migrations/003_drop_node_author.sql +0 -20
  40. package/migrations/004_sidecar_root_json.sql +0 -23
  41. package/migrations/005_node_favorites.sql +0 -20
package/README.md CHANGED
@@ -78,6 +78,10 @@ Exit codes follow [`spec/cli-contract.md`](../spec/cli-contract.md):
78
78
  | `4` | Nonce mismatch |
79
79
  | `5` | Resource not found |
80
80
 
81
+ ## Sidecar `.sm` files
82
+
83
+ `sm bump` and `sm sidecar annotate` write a sibling `<basename>.sm` YAML next to each `.md` (same directory). Their purpose is to keep skill-map's bookkeeping — version, stability, supersession, tags, audit trail — **out of the `.md` body and frontmatter**. The `.md` stays vendor-pure (Claude Code, Codex, Cursor, …); the `.sm` is the only file skill-map writes. **`sm scan`, `sm watch`, and the live UI never create `.sm` files** — they only read existing ones; sidecars appear only when you opt in via `bump` or `annotate`. **Commit `.sm` files to git like any other source file** — don't `.gitignore` them; they carry the metadata that drives `sm check`, drift detection, and supersession graphs. Full spec: [`spec/architecture.md` §Annotation system](../spec/architecture.md#annotation-system).
84
+
81
85
  ## Spec
82
86
 
83
87
  This binary implements the [skill-map spec](https://www.npmjs.com/package/@skill-map/spec). The spec package ships JSON Schemas, conformance cases, and prose contracts; `skill-map` conforms to a declared range via its `specCompat`.
package/dist/cli/tutorial/sm-tutorial.md CHANGED
@@ -863,13 +863,12 @@ Mark `2-ui-live: done`.
863
863
  > UI sees it instantly. In **~10 minutes** you've already seen the
864
864
  > full flow.
865
865
  >
866
- > One thing worth knowing for later: alongside every `.md` skill-map
867
- > can write a sibling `.sm` file (same basename, different extension)
868
- > that holds the concrete metadata — version, stability, supersession,
869
- > tags, audit trail. The `.md` stays vendor-pure; the `.sm` is where
870
- > skill-map writes. Both travel via git like the rest of your scope.
871
- > You'll see them appear once you start using `sm bump` or
872
- > `sm sidecar annotate`.
866
+ > ⚠️ **`.sm` files (heads-up for later)** — when skill-map needs to
867
+ > record metadata on a node, it doesn't modify the `.md` directly;
868
+ > it creates a sibling file with `.sm` extension (e.g. `demo-agent.sm`
869
+ > next to `demo-agent.md`). You won't see any during this demo — they
870
+ > only appear after `sm bump` or `sm sidecar annotate`. Commit them
871
+ > to git like any other source file.
873
872
  >
874
873
  > If you want, **we can keep going deeper**: I'll walk you through
875
874
  > the CLI verbs and flags (`list`, `graph`, `export`, `orphans`,