@skill-map/spec 0.38.0 → 0.40.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 (55) hide show
  1. package/CHANGELOG.md +48 -2302
  2. package/README.md +2 -2
  3. package/architecture.md +11 -14
  4. package/cli-contract.md +5 -1
  5. package/conformance/README.md +1 -1
  6. package/conformance/cases/extractor-emits-signal.json +1 -1
  7. package/conformance/cases/kernel-empty-boot.json +1 -1
  8. package/conformance/cases/no-global-scope.json +1 -1
  9. package/conformance/cases/orphan-markdown-fallback.json +1 -1
  10. package/conformance/cases/plugin-missing-ui-rejected.json +1 -1
  11. package/conformance/cases/sidecar-end-to-end.json +1 -1
  12. package/conformance/cases/signal-collision-detection.json +1 -1
  13. package/conformance/fixtures/plugin-missing-ui/.skill-map/plugins/bad-provider/providers/bad-provider/index.js +4 -0
  14. package/conformance/fixtures/sidecar-example/agent-example.sm +3 -3
  15. package/db-schema.md +19 -5
  16. package/index.json +55 -55
  17. package/package.json +2 -2
  18. package/schemas/annotations.schema.json +2 -2
  19. package/schemas/api/rest-envelope.schema.json +57 -12
  20. package/schemas/bump-report.schema.json +1 -1
  21. package/schemas/conformance-case.schema.json +1 -1
  22. package/schemas/conformance-result.schema.json +1 -1
  23. package/schemas/execution-record.schema.json +1 -1
  24. package/schemas/extensions/action.schema.json +1 -1
  25. package/schemas/extensions/analyzer.schema.json +1 -1
  26. package/schemas/extensions/base.schema.json +1 -1
  27. package/schemas/extensions/extractor.schema.json +1 -1
  28. package/schemas/extensions/formatter.schema.json +1 -1
  29. package/schemas/extensions/hook.schema.json +1 -1
  30. package/schemas/extensions/provider-kind.schema.json +1 -1
  31. package/schemas/extensions/provider.schema.json +80 -2
  32. package/schemas/frontmatter/base.schema.json +2 -7
  33. package/schemas/history-stats.schema.json +1 -1
  34. package/schemas/input-types.schema.json +1 -1
  35. package/schemas/issue.schema.json +1 -1
  36. package/schemas/job.schema.json +1 -1
  37. package/schemas/link.schema.json +1 -1
  38. package/schemas/node.schema.json +1 -1
  39. package/schemas/plugins-doctor.schema.json +1 -1
  40. package/schemas/plugins-registry.schema.json +1 -1
  41. package/schemas/project-config.schema.json +1 -1
  42. package/schemas/refresh-report.schema.json +1 -1
  43. package/schemas/report-base-deterministic.schema.json +1 -1
  44. package/schemas/report-base.schema.json +1 -1
  45. package/schemas/scan-result.schema.json +1 -1
  46. package/schemas/sidecar.schema.json +1 -1
  47. package/schemas/signal.schema.json +1 -1
  48. package/schemas/summaries/agent.schema.json +1 -1
  49. package/schemas/summaries/command.schema.json +1 -1
  50. package/schemas/summaries/hook.schema.json +1 -1
  51. package/schemas/summaries/markdown.schema.json +1 -1
  52. package/schemas/summaries/skill.schema.json +1 -1
  53. package/schemas/user-settings.schema.json +1 -1
  54. package/schemas/view-slots.schema.json +1 -1
  55. package/versioning.md +2 -2
package/schemas/user-settings.schema.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://skill-map.dev/spec/v0/user-settings.schema.json",
3
+ "$id": "https://skill-map.ai/spec/v0/user-settings.schema.json",
4
4
  "title": "UserSettings",
5
5
  "description": "Per-user, per-machine settings file persisted at `~/.skill-map/settings.json`. Holds the small set of preferences that genuinely belong to the operator (not to a project) plus the bookkeeping each one needs. The file is NOT part of the project config layer system (no merge, no PROJECT_LOCAL_ONLY_KEYS interaction); it is read directly by the few modules that own a user-scope feature. See `spec/cli-contract.md` §Scope is always project-local for the broader principle: skill-map never reads `$HOME` by default, this file is the narrow, documented exception. There is intentionally no `.local` partner; values here are already per-machine, so the project / project-local split would have no meaning.",
6
6
  "type": "object",
package/schemas/view-slots.schema.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://skill-map.dev/spec/v0/view-slots.schema.json",
3
+ "$id": "https://skill-map.ai/spec/v0/view-slots.schema.json",
4
4
  "title": "ViewSlots",
5
5
  "description": "Closed catalog of view slots. A view slot is a kernel-published handle that names a visual surface in the UI, fixes the renderer that draws there, and fixes the payload shape the plugin emits. The plugin author picks ONE slot per view contribution; the kernel validates `ctx.emitContribution(id, payload)` against that slot's payload schema in `$defs.payloads`. There is no separate notion of a 'contract', the slot IS the contract. Closed catalog by design: every new slot requires a spec change + UI renderer mount + scaffolder support + conformance fixtures + tests. Compounds catalog evolution cost; see ROADMAP.md §UI contribution system → 'Known limitations carried forward'. Slots are versioned via the manifest field `catalogCompat` (semver against the catalog as a whole), not per-slot.",
6
6
  "type": "object",
package/versioning.md CHANGED
@@ -87,8 +87,8 @@ The first stable commitment is `spec-v1.0.0`. In the current reference roadmap,
87
87
  Once the domain is live, schemas resolve at stable URLs:
88
88
 
89
89
  ```
90
- https://skill-map.dev/spec/v1/node.schema.json
91
- https://skill-map.dev/spec/v1.2/node.schema.json
90
+ https://skill-map.ai/spec/v1/node.schema.json
91
+ https://skill-map.ai/spec/v1.2/node.schema.json
92
92
  ```
93
93
 
94
94
  Major version is always present in the path. Implementations MUST NOT rely on `latest`.