@skill-map/cli 0.17.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.
- package/README.md +4 -0
- package/dist/cli/tutorial/sm-tutorial.md +7 -0
- package/dist/cli.js +12223 -6757
- package/dist/cli.js.map +1 -1
- package/dist/conformance/index.js +36 -14
- package/dist/conformance/index.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +776 -73
- package/dist/index.js.map +1 -1
- package/dist/kernel/index.d.ts +965 -134
- package/dist/kernel/index.js +776 -73
- package/dist/kernel/index.js.map +1 -1
- package/dist/migrations/001_initial.sql +122 -12
- package/dist/ui/chunk-3R7E3HPC.js +7 -0
- package/dist/ui/chunk-7CAK6MVK.js +2638 -0
- package/dist/ui/chunk-BORRASJB.js +247 -0
- package/dist/ui/chunk-CZSS4D6J.js +454 -0
- package/dist/ui/chunk-EQD7AYYJ.js +227 -0
- package/dist/ui/chunk-ETTRVTFV.js +1 -0
- package/dist/ui/chunk-LFIE4SCX.js +965 -0
- package/dist/ui/chunk-OKO3QOH6.js +1 -0
- package/dist/ui/chunk-PMIMYHBM.js +61 -0
- package/dist/ui/chunk-UHFGCO24.js +1 -0
- package/dist/ui/chunk-UJOZYR5I.js +1 -0
- package/dist/ui/chunk-VHIPW3TH.js +1 -0
- package/dist/ui/chunk-VWAUXWQX.js +237 -0
- package/dist/ui/index.html +10 -2
- package/dist/ui/main-BSYMJKTL.js +1 -0
- package/dist/ui/{styles-CBPFNGXA.css → styles-UAABA7VK.css} +1 -1
- package/migrations/001_initial.sql +122 -12
- package/package.json +6 -6
- package/dist/ui/chunk-5ZGVBIPP.js +0 -1031
- package/dist/ui/chunk-BWUDZKB6.js +0 -247
- package/dist/ui/chunk-LUDNWV6G.js +0 -3091
- package/dist/ui/chunk-WMWULWZX.js +0 -237
- package/dist/ui/main-7LR4JN4M.js +0 -1
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`.
|
|
@@ -863,6 +863,13 @@ 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
|
+
> ⚠️ **`.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.
|
|
872
|
+
>
|
|
866
873
|
> If you want, **we can keep going deeper**: I'll walk you through
|
|
867
874
|
> the CLI verbs and flags (`list`, `graph`, `export`, `orphans`,
|
|
868
875
|
> `plugins`, `db ops`, etc.). About ~20-30 min more, pausable
|