@skill-map/cli 0.43.0 → 0.45.0

package/dist/kernel/index.d.ts

@@ -2026,6 +2026,31 @@ interface IProviderDetect {
      */
     markers: string[];
 }
+/**
+ * Authoring targets for verbs that MATERIALISE files into this
+ * Provider's on-disk territory (today only `sm tutorial`). The WRITE
+ * counterpart to `detect` (which READS markers to suggest a lens) and
+ * `classify` (which READS paths during a scan). Mirrors
+ * `spec/schemas/extensions/provider.schema.json#/properties/scaffold`.
+ */
+interface IProviderScaffold {
+    /**
+     * Directory (relative to the scope root) under which a materialising
+     * verb writes a skill folder, e.g. `.claude/skills` for Claude,
+     * `.agents/skills` for the open standard. The verb appends
+     * `/<skillName>/SKILL.md`. Relative, no leading slash, no `..`
+     * traversal; the consuming verb joins it onto the cwd.
+     */
+    skillDir: string;
+    /**
+     * Display-only hints naming the agents that consume this scaffold
+     * territory, rendered in parentheses next to the Provider label in the
+     * `sm tutorial` destination prompt (e.g. `.agents/skills` is read by
+     * Antigravity and OpenAI Codex). Purely presentational: NOT matched by
+     * `--for` (only registered Provider ids are) and has no runtime effect.
+     */
+    aka?: readonly string[];
+}
 interface IProvider extends IExtensionBase {
     /** Discriminant injected by the loader from the folder structure. */
     kind: 'provider';
@@ -2049,6 +2074,16 @@ interface IProvider extends IExtensionBase {
      * auto-suggested (it can still be selected manually).
      */
     detect?: IProviderDetect;
+    /**
+     * Optional authoring targets for materialising verbs (`sm tutorial`).
+     * When present, the Provider is offered as a destination for newly
+     * generated content (a skill folder dropped under `scaffold.skillDir`).
+     * Absent means a materialising verb never offers this Provider, e.g.
+     * `openai` until Codex skills land, `antigravity` (skills live under
+     * the open-standard `agent-skills` territory), `core/markdown` (owns
+     * no authoring convention).
+     */
+    scaffold?: IProviderScaffold;
     /**
      * Catalog of node kinds this Provider emits. Populated by the loader
      * from the `<plugin>/kinds/<kindName>/` directory layout: each subfolder
@@ -2560,12 +2595,14 @@ interface IAnalyzerContext {
      */
     referenceablePaths?: ReadonlySet<string>;
     /**
-     * Paths of nodes whose normalised identifier(s) intersect their
-     * Provider's `reservedNames[kind]` catalog (e.g. a user-authored
-     * `.claude/commands/help.md` whose name normalises to `help`,
-     * shadowed by Claude's built-in `/help` command). The set is
-     * computed once per scan by the orchestrator (mirroring the same
-     * set threaded to the post-walk confidence-lift transform), so
+     * Paths of nodes whose normalised identifier(s) intersect a
+     * `reservedNames[kind]` catalog under self scope (the node's own
+     * Provider, e.g. `.claude/commands/help.md` shadowed by Claude's
+     * built-in `/help`) or lens scope (the active lens lending its catalog
+     * to the universal `agent-skills` skill nodes it consumes, e.g.
+     * `.agents/skills/goal/SKILL.md` shadowed by Antigravity's `/goal`).
+     * The set is computed once per scan by the orchestrator (mirroring the
+     * same set threaded to the post-walk confidence-lift transform), so
      * analyzers consume it without re-deriving every node's
      * identifiers. The single consumer today is `core/name-reserved`,
      * which projects one warn issue per entry; future analyzers MAY

package/dist/kernel/index.js

@@ -101,7 +101,7 @@ import cl100k_base from "js-tiktoken/ranks/cl100k_base";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.43.0",
+  version: "0.45.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -152,25 +152,25 @@ var package_default = {
     typecheck: "tsc --noEmit",
     lint: "eslint .",
     "lint:fix": "eslint . --fix",
-    reference: "node scripts/build-reference.js",
-    "reference:check": "node scripts/build-reference.js --check",
     "build-built-ins": "node ../scripts/generate-built-ins.js",
     "built-ins:check": "node ../scripts/generate-built-ins.js --check",
     prebuild: "pnpm build-built-ins",
     validate: "pnpm validate:compile && pnpm validate:test",
-    "validate:compile": "pnpm typecheck && pnpm lint && pnpm build && pnpm reference:check && pnpm built-ins:check",
+    "validate:compile": "pnpm typecheck && pnpm lint && pnpm build && pnpm built-ins:check",
     "validate:test": "pnpm test:ci",
     pretest: "tsup",
     "pretest:coverage": "tsup",
     "pretest:coverage:html": "tsup",
-    test: "tsc --noEmit && node --import tsx --test --test-reporter=spec '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
-    "test:ci": "node --import tsx --test '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
-    "test:coverage": "tsc --noEmit && SKILL_MAP_SKIP_BENCHMARK=1 node --experimental-default-config-file --import tsx --test --experimental-test-coverage '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
-    "test:coverage:html": "tsc --noEmit && SKILL_MAP_SKIP_BENCHMARK=1 c8 node --import tsx --test '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    test: "tsc --noEmit && SKILL_MAP_TELEMETRY=0 node --import tsx --test --test-reporter=./scripts/test-reporter.js --test-reporter-destination=stdout '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:ci": "FORCE_COLOR=1 SKILL_MAP_TELEMETRY=0 node --import tsx --test --test-reporter=./scripts/test-reporter.js --test-reporter-destination=stdout '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:spec": "SKILL_MAP_TELEMETRY=0 node --import tsx --test --test-reporter=spec '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:coverage": "tsc --noEmit && SKILL_MAP_TELEMETRY=0 SKILL_MAP_SKIP_BENCHMARK=1 node --experimental-default-config-file --import tsx --test --experimental-test-coverage '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:coverage:html": "tsc --noEmit && SKILL_MAP_TELEMETRY=0 SKILL_MAP_SKIP_BENCHMARK=1 c8 node --import tsx --test '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
     clean: "rm -rf dist coverage"
   },
   dependencies: {
     "@hono/node-server": "2.0.1",
+    "@sentry/node": "10.55.0",
     "@skill-map/spec": "workspace:*",
     ajv: "8.18.0",
     "ajv-formats": "3.0.1",
@@ -181,6 +181,7 @@ var package_default = {
     "js-tiktoken": "1.0.21",
     "js-yaml": "4.1.1",
     kysely: "0.28.17",
+    "posthog-node": "5.35.6",
     semver: "7.7.4",
     "smol-toml": "1.6.1",
     typanion: "3.14.0",
@@ -3220,7 +3221,8 @@ function buildPostWalkTransformCtx(providers, nodes, activeProvider) {
   const reservedNodePaths = buildReservedNodePaths(
     nodes,
     kindRegistry,
-    reservedNamesByProviderKind
+    reservedNamesByProviderKind,
+    activeProvider
   );
   return { kindRegistry, providerResolution, activeProvider, reservedNodePaths };
 }
@@ -3251,19 +3253,23 @@ function indexReservedNames(provider, out) {
     }
   }
 }
-function buildReservedNodePaths(nodes, kindRegistry, reservedNamesByProviderKind) {
+function buildReservedNodePaths(nodes, kindRegistry, reservedNamesByProviderKind, activeProvider) {
   const out = /* @__PURE__ */ new Set();
   for (const node of nodes) {
-    const key = `${node.provider}/${node.kind}`;
-    const reservedSet = reservedNamesByProviderKind.get(key);
-    if (!reservedSet || reservedSet.size === 0) continue;
-    const ids = deriveNodeIdentifiers(node, kindRegistry.get(key));
-    if (ids.some((id) => reservedSet.has(id))) {
+    const selfKey = `${node.provider}/${node.kind}`;
+    const selfReserved = reservedNamesByProviderKind.get(selfKey);
+    const lensReserved = activeProvider && activeProvider !== node.provider ? reservedNamesByProviderKind.get(`${activeProvider}/${node.kind}`) : void 0;
+    if (!hasEntries(selfReserved) && !hasEntries(lensReserved)) continue;
+    const ids = deriveNodeIdentifiers(node, kindRegistry.get(selfKey));
+    if (ids.some((id) => selfReserved?.has(id) === true || lensReserved?.has(id) === true)) {
       out.add(node.path);
     }
   }
   return out;
 }
+function hasEntries(set) {
+  return set !== void 0 && set.size > 0;
+}
 function buildScanSetup(options) {
   const start = Date.now();
   const emitter = options.emitter ?? new InMemoryProgressEmitter();