@skill-map/cli 0.16.6 → 0.17.0

package/dist/kernel/index.d.ts

@@ -57,8 +57,8 @@
  * prefix.
  */
 /**
- * The five node kinds the **built-in Claude Provider** declares — `skill`,
- * `agent`, `command`, `hook`, `note`. **NOT** the kernel-wide kind type.
+ * The four node kinds the **built-in Claude Provider** declares — `skill`,
+ * `agent`, `command`, `note`. **NOT** the kernel-wide kind type.
  *
  * `Node.kind` is `string`. An external Provider (Cursor, Obsidian, …)
  * MAY classify into its own kinds (e.g. `'cursorRule'`, `'daily'`); the
@@ -67,19 +67,25 @@
  * `node.schema.json#/properties/kind`, the contract is open-by-design
  * (matches `IProvider.kinds` "open by design" docstring).
  *
+ * Step 9.5 dropped `hook` from the catalog: `.claude/hooks/*.md` is NOT
+ * an Anthropic-defined node type — hooks live in `settings.json` or as
+ * sub-objects of agent / skill frontmatter (see
+ * https://code.claude.com/docs/en/hooks.md). Files at the old path now
+ * classify as `note` via the Provider's fallback.
+ *
  * This alias survives because:
- *   - claude-specific code legitimately wants to switch on the five
+ *   - claude-specific code legitimately wants to switch on the four
  *     hard-coded values (filter widgets, kind-aware UI cards, the
  *     `validate-all` built-in rule that maps each kind to its
  *     frontmatter schema);
  *   - sorting helpers want a stable `KIND_ORDER` for the canonical
  *     catalog;
- *   - tests expect to enumerate the five kinds when seeding fixtures.
+ *   - tests expect to enumerate the four kinds when seeding fixtures.
  *
  * For "any kind a Provider could declare", use plain `string`. Only use
  * `NodeKind` when the code is intentionally claude-catalog-specific.
  */
-type NodeKind = 'skill' | 'agent' | 'command' | 'hook' | 'note';
+type NodeKind = 'skill' | 'agent' | 'command' | 'note';
 type LinkKind = 'invokes' | 'references' | 'mentions' | 'supersedes';
 type Confidence = 'high' | 'medium' | 'low';
 type Severity = 'error' | 'warn' | 'info';
@@ -919,6 +925,23 @@ interface IProvider extends IExtensionBase {
      * column all accept any non-empty string an enabled Provider returns.
      */
     kinds: Record<string, IProviderKind>;
+    /**
+     * Optional auxiliary JSON Schemas this Provider's per-kind schemas
+     * `$ref` by `$id`. Registered with AJV via `addSchema` BEFORE the
+     * per-kind schemas compile, so cross-file `$ref` resolution succeeds.
+     *
+     * Use case: when several kinds share a common base (e.g. Anthropic's
+     * merged skill / command frontmatter — both extend a shared
+     * `skill-base.schema.json`), the Provider declares the base here so
+     * `skill.schema.json` and `command.schema.json` can `$ref` it without
+     * duplicating fields.
+     *
+     * Runtime-only — does NOT appear in the spec's `provider.schema.json`
+     * manifest. Manifest-validated schemas remain the per-kind ones in
+     * `kinds[<kind>].schema`; auxiliary schemas are an implementation
+     * concern of how the runtime composes those.
+     */
+    schemas?: unknown[];
     /**
      * Walk the given roots and yield every node the Provider recognises.
      * Non-matching files are silently skipped. Unreadable files produce

package/dist/kernel/index.js

@@ -102,7 +102,7 @@ import yaml from "js-yaml";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.16.6",
+  version: "0.17.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -168,7 +168,7 @@ var package_default = {
   },
   dependencies: {
     "@hono/node-server": "2.0.1",
-    "@skill-map/spec": "0.16.0",
+    "@skill-map/spec": "0.17.0",
     ajv: "8.18.0",
     "ajv-formats": "3.0.1",
     chokidar: "5.0.0",
@@ -384,6 +384,7 @@ function buildProviderFrontmatterValidator(providers) {
   const baseFile = resolve2(specRoot, "schemas/frontmatter/base.schema.json");
   const baseSchema = JSON.parse(readFileSync2(baseFile, "utf8"));
   ajv.addSchema(baseSchema);
+  registerProviderAuxiliarySchemas(ajv, providers);
   const compiled = /* @__PURE__ */ new Map();
   for (const provider of providers) {
     for (const [kind, entry] of Object.entries(provider.kinds)) {
@@ -408,6 +409,16 @@ function formatError(err) {
   const path = err.instancePath || "(root)";
   return `${path} ${err.message ?? err.keyword}`;
 }
+function registerProviderAuxiliarySchemas(ajv, providers) {
+  for (const provider of providers) {
+    if (!provider.schemas) continue;
+    for (const aux of provider.schemas) {
+      const auxJson = aux;
+      if (typeof auxJson.$id === "string" && ajv.getSchema(auxJson.$id)) continue;
+      ajv.addSchema(aux);
+    }
+  }
+}
 function resolveSpecRoot() {
   const require2 = createRequire2(import.meta.url);
   try {