@skill-map/cli 0.62.1 → 0.63.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 // cli/entry.ts
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="be3954fe-3e41-5dae-bb8d-1d8225ffd77a")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="09459eb1-3d6f-565d-9552-4819baae6f1a")}catch(e){}}();
 import { existsSync as existsSync33 } from "fs";
 import { Builtins, Cli as Cli2 } from "clipanion";
 
@@ -250,7 +250,7 @@ function bucketByKind(kind, instance, bag) {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.62.1",
+  version: "0.63.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -1068,6 +1068,108 @@ function buildTooltip(names) {
   return `${joined.slice(0, TOOLTIP_MAX - 1)}\u2026`;
 }
 
+// plugins/agent-skills/providers/agent-skills/schemas/skill.schema.json
+var skill_schema_default2 = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://skill-map.ai/providers/agent-skills/v1/frontmatter/skill.schema.json",
+  title: "FrontmatterAgentSkillsSkill",
+  description: "Frontmatter shape for nodes classified as `skill` by the neutral `agent-skills` Provider, Agent Skills delivered as `SKILL.md` files at the open-standard path `.agents/skills/<name>/SKILL.md`. Jointly adopted by Anthropic, OpenAI (Codex), and Google (Gemini); the path is vendor-neutral so no single Provider should own it. Required fields are `name` and `description` (from spec base). The standard's optional frontmatter fields are declared below, mirrored verbatim from https://agentskills.io/specification: `license`, `compatibility`, `metadata`, and the experimental `allowed-tools`. `additionalProperties: true` so any future standard field flows through unchanged until this schema catches up.",
+  allOf: [
+    { $ref: "https://skill-map.ai/spec/v0/frontmatter/base.schema.json" }
+  ],
+  type: "object",
+  additionalProperties: true,
+  properties: {
+    license: {
+      type: "string",
+      description: "License applied to the skill: a license name (e.g. `Apache-2.0`) or a reference to a bundled license file. Source: https://agentskills.io/specification."
+    },
+    compatibility: {
+      type: "string",
+      maxLength: 500,
+      description: "Environment requirements (intended product, required system packages, network access, etc.). Most skills omit it. Max 500 characters. Source: https://agentskills.io/specification."
+    },
+    metadata: {
+      type: "object",
+      additionalProperties: { type: "string" },
+      description: "Arbitrary string-keyed, string-valued map for client-defined metadata not covered by the standard. Source: https://agentskills.io/specification."
+    },
+    "allowed-tools": {
+      type: "string",
+      description: "Space-separated list of pre-approved tools the skill may run (e.g. `Bash(git:*) Read`). Experimental in the open standard; support varies between agent implementations. Source: https://agentskills.io/specification."
+    }
+  }
+};
+
+// plugins/agent-skills/providers/agent-skills/index.ts
+var OPEN_SKILLS_READ = {
+  extensions: [".md"],
+  parser: "frontmatter-yaml"
+};
+var OPEN_SKILLS_KINDS = {
+  skill: {
+    schema: "./schemas/skill.schema.json",
+    schemaJson: skill_schema_default2,
+    ui: {
+      label: "Skills",
+      color: "#10b981",
+      colorDark: "#34d399",
+      icon: { kind: "pi", id: "pi-bolt" }
+    },
+    // Open-standard skills mirror Anthropic's: dirname between
+    // `.agents/skills/` and `/SKILL.md` is the canonical handle,
+    // `frontmatter.name` overrides when present.
+    identifiers: ["frontmatter.name", "dirname"]
+  }
+};
+var OPEN_SKILLS_RESOLUTION = { invokes: ["skill"] };
+function classifyOpenSkillsPath(path) {
+  if (/^\.agents\/skills\/[^/]+\/skill\.md$/.test(path.toLowerCase())) return "skill";
+  return null;
+}
+var agentSkillsProvider = {
+  id: "agent-skills",
+  pluginId: AGENT_SKILLS_PLUGIN_ID,
+  kind: "provider",
+  description: "Classifies files under `.agents/skills/<name>/SKILL.md` as Agent Skills.",
+  // Provider identity for the active-lens dropdown, the topbar lens chip,
+  // and the per-node provider chip. Neutral slate (this is the
+  // vendor-agnostic open-standard Provider, not a brand). Verbatim from
+  // the previous static UI catalog (`ui/src/services/provider-ui.ts`).
+  presentation: {
+    label: "Open Skills",
+    color: "#64748b",
+    colorDark: "#94a3b8"
+  },
+  // Gated like the vendor providers: `.agents/skills/*` is classified as
+  // `skill` ONLY under the `agent-skills` lens; under any other lens
+  // (including `markdown`) it falls through to `core/markdown`, the sole
+  // universal provider. Keeps the "one active lens" model honest.
+  gatedByActiveLens: true,
+  // Not yet ready for end users: ships disabled by default. The operator
+  // opts in via `sm plugins enable` / the Settings toggle / the tutorial's
+  // `--experimental` flow, so it neither classifies nor auto-detects until
+  // enabled.
+  stability: "experimental",
+  // Auto-detect marker: a `.agents/` directory marks an open-standard
+  // project. This is also the marker a Google/Antigravity project carries
+  // (Antigravity adopted the open standard). The marker only produces an
+  // auto-detect candidate once this experimental provider is enabled.
+  // Provider-owned.
+  detect: { markers: [".agents"] },
+  // Authoring target for `sm tutorial`: the open standard discovers skills
+  // under `.agents/skills/<name>/SKILL.md`. The same path is consumed by
+  // Antigravity (adopted the standard rather than a `.gemini/` layout) and
+  // OpenAI Codex (skills mirror the open standard), so `aka` surfaces both
+  // names in the destination prompt to orient testers on those agents.
+  // `aka` is display-only, `--for` still matches the `agent-skills` id.
+  scaffold: { skillDir: ".agents/skills", aka: ["Antigravity", "OpenAI Codex"] },
+  read: OPEN_SKILLS_READ,
+  kinds: OPEN_SKILLS_KINDS,
+  resolution: OPEN_SKILLS_RESOLUTION,
+  classify: classifyOpenSkillsPath
+};
+
 // plugins/antigravity/providers/antigravity/index.ts
 var antigravityProvider = {
   id: "antigravity",
@@ -1080,10 +1182,7 @@ var antigravityProvider = {
   presentation: {
     label: "Antigravity",
     color: "#7c3aed",
-    colorDark: "#a78bfa",
-    // Registered but not yet selectable as the active lens; the UI greys
-    // it with a `(coming soon)` suffix.
-    comingSoon: true
+    colorDark: "#a78bfa"
   },
   // No `detect` block: Antigravity has no vendor-specific workspace marker
   // (it adopted the open-standard `.agents/`, owned by `agent-skills`), so
@@ -1095,17 +1194,23 @@ var antigravityProvider = {
   // declaration anticipates the migration moment so we don't have to
   // remember to flip it then.
   gatedByActiveLens: true,
-  // No `read` config: this Provider does not walk the filesystem. The
-  // kernel walker only fires for Providers with `read` or `walk`; an
-  // empty Provider participates in registration (its `ui` block is
-  // available, its `reservedNames` catalog is loaded) without owning
-  // any on-disk territory.
-  kinds: {},
-  // Always disclaim: paths are owned by other Providers (`.agents/` ->
-  // `agent-skills`, `AGENTS.md` -> `core/markdown` fallback).
-  classify() {
-    return null;
-  },
+  // Not yet ready for end users: ships disabled by default (the operator
+  // opts in via `sm plugins enable` / Settings / the tutorial's
+  // `--experimental` flow). Replaces the retired `comingSoon` flag.
+  stability: "experimental",
+  // Adopt the open-standard `.agents/skills/` layout by REUSING the
+  // `agent-skills` classifier + kind + read config (composition at the
+  // manifest level, not a kernel rule). Under the antigravity lens the
+  // walker classifies `.agents/skills/<name>/SKILL.md` as
+  // `{ provider: 'antigravity', kind: 'skill' }`, so the reservedNames
+  // below apply via SELF scope. `agent-skills` itself is gated to its own
+  // lens, so it never competes here (under the antigravity lens it does
+  // not participate). This is why there is no cross-provider lens-scope
+  // rule in the kernel any more.
+  read: OPEN_SKILLS_READ,
+  kinds: OPEN_SKILLS_KINDS,
+  resolution: OPEN_SKILLS_RESOLUTION,
+  classify: classifyOpenSkillsPath,
   // Built-in slash-command catalog, captured verbatim from `agy /help`
   // (Antigravity CLI v1.0.3). This REPLACES the earlier provisional list
   // that mirrored Gemini CLI's verbs: `agy` ships its own surface. It
@@ -1123,12 +1228,10 @@ var antigravityProvider = {
   //
   // Declared under the `skill` kind (NOT `command`): Antigravity has no
   // vendor-specific command directory, its user slash-commands are skills
-  // (`.agents/skills/<name>/SKILL.md`, owned by the universal `agent-skills`
-  // Provider). The catalog is ACTIVE via the LENS SCOPE in
-  // `buildReservedNodePaths` (spec/architecture.md §Provider ·
-  // reservedNames): when `activeProvider === 'antigravity'` the orchestrator
-  // lends this `skill` catalog to `agent-skills` skill nodes, so a user
-  // `.agents/skills/goal/SKILL.md` is flagged because `/goal` is built-in.
+  // (`.agents/skills/<name>/SKILL.md`). Because the antigravity lens now
+  // classifies those files itself (inherited classifier above), a user
+  // `.agents/skills/goal/SKILL.md` is flagged by SELF scope because `/goal`
+  // is built-in.
   //
   // **Reconciliation marker**: re-capture from `agy /help` on each major
   // Antigravity CLI release and bump the cited version above.
@@ -1245,10 +1348,7 @@ var openaiProvider = {
   presentation: {
     label: "OpenAI Codex",
     color: "#22c55e",
-    colorDark: "#4ade80",
-    // Registered but not yet selectable as the active lens; auto-detect
-    // skips its markers and the UI greys it with a `(coming soon)` suffix.
-    comingSoon: true
+    colorDark: "#4ade80"
   },
   // Auto-detect markers: a `.codex/` directory or a root `AGENTS.md` marks
   // a Codex CLI project. Provider-owned (replaces the old central
@@ -1259,6 +1359,10 @@ var openaiProvider = {
   // claiming Codex agents under a `claude` (or any other) lens, where
   // the Codex runtime would never resolve them anyway.
   gatedByActiveLens: true,
+  // Not yet ready for end users: ships disabled by default (the operator
+  // opts in via `sm plugins enable` / Settings / the tutorial's
+  // `--experimental` flow). Replaces the retired `comingSoon` flag.
+  stability: "experimental",
   read: { extensions: [".toml"], parser: "toml" },
   kinds: {
     agent: {
@@ -1291,98 +1395,6 @@ var openaiProvider = {
   }
 };
 
-// plugins/agent-skills/providers/agent-skills/schemas/skill.schema.json
-var skill_schema_default2 = {
-  $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "https://skill-map.ai/providers/agent-skills/v1/frontmatter/skill.schema.json",
-  title: "FrontmatterAgentSkillsSkill",
-  description: "Frontmatter shape for nodes classified as `skill` by the neutral `agent-skills` Provider, Agent Skills delivered as `SKILL.md` files at the open-standard path `.agents/skills/<name>/SKILL.md`. Jointly adopted by Anthropic, OpenAI (Codex), and Google (Gemini); the path is vendor-neutral so no single Provider should own it. Required fields are `name` and `description` (from spec base). The standard's optional frontmatter fields are declared below, mirrored verbatim from https://agentskills.io/specification: `license`, `compatibility`, `metadata`, and the experimental `allowed-tools`. `additionalProperties: true` so any future standard field flows through unchanged until this schema catches up.",
-  allOf: [
-    { $ref: "https://skill-map.ai/spec/v0/frontmatter/base.schema.json" }
-  ],
-  type: "object",
-  additionalProperties: true,
-  properties: {
-    license: {
-      type: "string",
-      description: "License applied to the skill: a license name (e.g. `Apache-2.0`) or a reference to a bundled license file. Source: https://agentskills.io/specification."
-    },
-    compatibility: {
-      type: "string",
-      maxLength: 500,
-      description: "Environment requirements (intended product, required system packages, network access, etc.). Most skills omit it. Max 500 characters. Source: https://agentskills.io/specification."
-    },
-    metadata: {
-      type: "object",
-      additionalProperties: { type: "string" },
-      description: "Arbitrary string-keyed, string-valued map for client-defined metadata not covered by the standard. Source: https://agentskills.io/specification."
-    },
-    "allowed-tools": {
-      type: "string",
-      description: "Space-separated list of pre-approved tools the skill may run (e.g. `Bash(git:*) Read`). Experimental in the open standard; support varies between agent implementations. Source: https://agentskills.io/specification."
-    }
-  }
-};
-
-// plugins/agent-skills/providers/agent-skills/index.ts
-var agentSkillsProvider = {
-  id: "agent-skills",
-  pluginId: AGENT_SKILLS_PLUGIN_ID,
-  kind: "provider",
-  description: "Classifies files under `.agents/skills/<name>/SKILL.md` as Agent Skills.",
-  // Provider identity for the active-lens dropdown, the topbar lens chip,
-  // and the per-node provider chip. Neutral slate (this is the
-  // vendor-agnostic open-standard Provider, not a brand). Verbatim from
-  // the previous static UI catalog (`ui/src/services/provider-ui.ts`).
-  presentation: {
-    label: "Open Skills",
-    color: "#64748b",
-    colorDark: "#94a3b8",
-    // Registered but not yet selectable as the active lens; auto-detect
-    // skips its `.agents/` marker and the UI greys it with a
-    // `(coming soon)` suffix.
-    comingSoon: true
-  },
-  // Auto-detect marker: a `.agents/` directory marks an open-standard
-  // project. This is also the marker a Google/Antigravity project carries
-  // (Antigravity adopted the open standard), so such projects auto-detect
-  // as this universal lens. Provider-owned.
-  detect: { markers: [".agents"] },
-  // Authoring target for `sm tutorial`: the open standard discovers skills
-  // under `.agents/skills/<name>/SKILL.md`. The same path is consumed by
-  // Antigravity (adopted the standard rather than a `.gemini/` layout) and
-  // OpenAI Codex (skills mirror the open standard), so `aka` surfaces both
-  // names in the destination prompt to orient testers on those agents.
-  // `aka` is display-only, `--for` still matches the `agent-skills` id.
-  scaffold: { skillDir: ".agents/skills", aka: ["Antigravity", "OpenAI Codex"] },
-  read: { extensions: [".md"], parser: "frontmatter-yaml" },
-  kinds: {
-    skill: {
-      schema: "./schemas/skill.schema.json",
-      schemaJson: skill_schema_default2,
-      ui: {
-        label: "Skills",
-        color: "#10b981",
-        colorDark: "#34d399",
-        icon: { kind: "pi", id: "pi-bolt" }
-      },
-      // Open-standard skills mirror Anthropic's: dirname between
-      // `.agents/skills/` and `/SKILL.md` is the canonical handle,
-      // `frontmatter.name` overrides when present.
-      identifiers: ["frontmatter.name", "dirname"]
-    }
-  },
-  // The open standard documents slash-style invocation of skills; no
-  // mention surface (no agents in this Provider's territory).
-  resolution: {
-    invokes: ["skill"]
-  },
-  classify(path) {
-    if (/^\.agents\/skills\/[^/]+\/skill\.md$/.test(path.toLowerCase())) return "skill";
-    return null;
-  }
-};
-
 // plugins/core/providers/core-markdown/schemas/markdown.schema.json
 var markdown_schema_default = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
@@ -7659,7 +7671,7 @@ async function loadBranch(db, prefixes, limit) {
   }
   const paths = [...pathSet];
   const [linkRows, issueRows] = await Promise.all([
-    db.selectFrom("scan_links").selectAll().where("sourcePath", "in", paths).where("targetPath", "in", paths).execute(),
+    db.selectFrom("scan_links").selectAll().where("sourcePath", "in", paths).where(sql2`coalesce(resolved_target, target_path)`, "in", paths).execute(),
     db.selectFrom("scan_issues").selectAll().where(
       ({ exists, selectFrom }) => exists(
         selectFrom(
@@ -11826,13 +11838,14 @@ function detectProvidersFromFilesystem(cwd, providers) {
   return out;
 }
 function isDetectableUnderCwd(cwd, provider) {
-  if (provider.presentation?.comingSoon === true) return false;
+  if (!installedDefaultEnabled(provider.stability)) return false;
   const markers = provider.detect?.markers;
   if (!markers || markers.length === 0) return false;
   return markers.some((marker) => existsSync15(join10(cwd, marker)));
 }
 
 // core/config/active-provider.ts
+var MARKDOWN_LENS_ID = "markdown";
 function resolveActiveProvider(cwd, providers = []) {
   const detected = detectProvidersFromFilesystem(cwd, providers);
   const fromConfig = readConfigValue("activeProvider", { cwd });
@@ -11842,7 +11855,7 @@ function resolveActiveProvider(cwd, providers = []) {
   if (detected.length > 0) {
     return { resolved: detected[0], source: "autodetect", detected };
   }
-  return { resolved: null, source: "none", detected };
+  return { resolved: MARKDOWN_LENS_ID, source: "default", detected };
 }
 
 // cli/util/path-display.ts
@@ -16290,8 +16303,7 @@ function matchesKindPrecondition(ex, kind) {
 function matchesProviderPrecondition(ex, activeProvider) {
   const providers = ex.precondition?.provider;
   if (!providers || providers.length === 0) return true;
-  if (activeProvider === null) return false;
-  return providers.includes(activeProvider);
+  return activeProvider !== null && providers.includes(activeProvider);
 }
 function splitLegacy(applicableExtractors, applicableQualifiedIds, nodeHashCacheEligible) {
   const cachedQualifiedIds = /* @__PURE__ */ new Set();
@@ -17351,7 +17363,6 @@ function buildPriorMtimes(opts) {
 }
 function providerParticipates(provider, activeProvider) {
   if (!provider.gatedByActiveLens) return true;
-  if (activeProvider === null) return true;
   return provider.id === activeProvider;
 }
 function createWalkAccumulators() {
@@ -17773,8 +17784,7 @@ function buildPostWalkTransformCtx(providers, nodes, activeProvider) {
   const reservedNodePaths = buildReservedNodePaths(
     nodes,
     kindRegistry,
-    reservedNamesByProviderKind,
-    activeProvider
+    reservedNamesByProviderKind
   );
   return { kindRegistry, providerResolution, activeProvider, reservedNodePaths };
 }
@@ -17805,15 +17815,14 @@ function indexReservedNames(provider, out) {
     }
   }
 }
-function buildReservedNodePaths(nodes, kindRegistry, reservedNamesByProviderKind, activeProvider) {
+function buildReservedNodePaths(nodes, kindRegistry, reservedNamesByProviderKind) {
   const out = /* @__PURE__ */ new Set();
   for (const node of nodes) {
     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;
+    if (!hasEntries(selfReserved)) continue;
     const ids = deriveNodeIdentifiers(node, kindRegistry.get(selfKey));
-    if (ids.some((id) => selfReserved?.has(id) === true || lensReserved?.has(id) === true)) {
+    if (ids.some((id) => selfReserved?.has(id) === true)) {
       out.add(node.path);
     }
   }
@@ -18374,23 +18383,6 @@ var SCAN_RUNNER_TEXTS = {
    * operator notices a typo without the walker silently swallowing it.
    */
   referenceWalkMissingRoot: 'scan.referencePaths: configured path "{{path}}" does not exist; skipped.',
-  /**
-   * Active-provider bootstrap: filesystem auto-detect found no
-   * markers (`.claude/`, `.codex/`, `AGENTS.md`, `.cursor/`) anywhere
-   * under cwd or the effective scan roots. Plain-markdown projects
-   * keep scanning fine; provider-specific extractors silently no-op
-   * for this scan. Follows `context/cli-output-style.md` §3.1b
-   * (two-line block, glyph + dim hint):
-   *   - line 1: `{{glyph}}` (yellow `⚠`) + headline naming the
-   *     missing markers,
-   *   - line 2 (indent 3): `{{hint}}`, dim, names the consequence
-   *     and the actionable next step.
-   * Both the full block AND the bare hint are catalog-side so the
-   * caller can wrap the hint in `ansi.dim(...)` without splitting
-   * the template manually.
-   */
-  activeProviderNoMarkerWarning: "{{glyph}}  No provider markers detected (.claude/, .codex/, AGENTS.md, .cursor/).\n   {{hint}}\n",
-  activeProviderNoMarkerWarningHint: "Scanning as universal markdown only; provider-specific link types (e.g. claude @-directives, /-commands) will not appear. Set `activeProvider` in .skill-map/settings.json or install a provider plugin to enable them.",
   /**
    * Active-provider bootstrap: filesystem auto-detect found exactly
    * one marker and persisted the detected id to project settings.
@@ -18549,15 +18541,7 @@ async function bootstrapActiveProvider(opts) {
     opts.providers
   );
   if (detected.length === 0) {
-    const warnGlyph = opts.style?.warnGlyph ?? "\u26A0";
-    const dim = opts.style?.dim ?? ((s) => s);
-    opts.printer.warn(
-      tx(SCAN_RUNNER_TEXTS.activeProviderNoMarkerWarning, {
-        glyph: warnGlyph,
-        hint: dim(SCAN_RUNNER_TEXTS.activeProviderNoMarkerWarningHint)
-      })
-    );
-    return { kind: "ok", activeProvider: null, source: "none" };
+    return { kind: "ok", activeProvider: MARKDOWN_LENS_ID, source: "default" };
   }
   if (detected.length === 1) {
     const picked2 = detected[0];
@@ -18620,7 +18604,13 @@ function handleDrift(opts, resolvedLens, currentMarkers) {
     backfillMarkersSnapshot(opts.cwd, currentMarkers);
     return;
   }
-  const diff = diffMarkers(snapshot, currentMarkers);
+  const shipsDisabled = new Set(
+    opts.providers.filter((p) => !installedDefaultEnabled(p.stability)).map((p) => p.id)
+  );
+  const diff = diffMarkers(
+    snapshot.filter((id) => !shipsDisabled.has(id)),
+    currentMarkers.filter((id) => !shipsDisabled.has(id))
+  );
   if (diff.added.length === 0 && diff.removed.length === 0) return;
   emitDriftWarn(opts, resolvedLens, diff);
 }
@@ -18630,7 +18620,7 @@ function emitDriftWarn(opts, resolvedLens, diff) {
   const hint = tx(SCAN_RUNNER_TEXTS.activeProviderDriftWarnHint, {
     added: diff.added.length === 0 ? "(none)" : diff.added.join(", "),
     removed: diff.removed.length === 0 ? "(none)" : diff.removed.join(", "),
-    currentLens: resolvedLens ?? "(none)"
+    currentLens: resolvedLens
   });
   opts.printer.warn(
     tx(SCAN_RUNNER_TEXTS.activeProviderDriftWarn, {
@@ -18662,7 +18652,6 @@ function diffMarkers(snapshot, current) {
   return { added, removed };
 }
 function warnIfLensPluginDisabled(args2) {
-  if (args2.activeProvider === null) return;
   if (args2.resolveEnabled(args2.activeProvider)) return;
   args2.printer.warn(
     tx(SCAN_RUNNER_TEXTS.activeProviderPluginDisabledWarning, {
@@ -24089,6 +24078,9 @@ function relativeFromRoots2(absolute, absRoots) {
   }
   return null;
 }
+function resolveWatcherLens(cwd, composed) {
+  return resolveActiveProvider(cwd, composed?.providers ?? []).resolved;
+}
 function createWatcherRuntime(opts) {
   const events = opts.events ?? {};
   const cwd = opts.runtimeContext.cwd;
@@ -24196,7 +24188,14 @@ function createWatcherRuntime(opts) {
         overrideScanCeiling: opts.maxScanOverride ?? null,
         maxRenderNodes: cfg.scan.maxNodes,
         overrideMaxRenderNodes: opts.maxNodesOverride ?? null,
-        maxFileSizeBytes: cfg.scan.maxFileSizeBytes
+        maxFileSizeBytes: cfg.scan.maxFileSizeBytes,
+        // Resolve the active lens from the persisted config (settings.json)
+        // so a lens switched via `PATCH /api/active-provider` is honoured by
+        // the next watcher batch. Without an explicit value the orchestrator
+        // falls back to filesystem detection, which ignores the operator's
+        // choice (e.g. selecting `markdown` while `.claude/` is still on disk
+        // would re-detect `claude` and silently overwrite the chosen lens).
+        activeProvider: resolveWatcherLens(cwd, composed)
       };
       if (cfg.scan.referencePaths.length > 0) {
         const walk3 = walkReferencePaths(cfg.scan.referencePaths, cwd);
@@ -27927,7 +27926,6 @@ async function resolveSelectableProviders(deps) {
   });
   const selectable = /* @__PURE__ */ new Set();
   for (const provider of deps.providers) {
-    if (provider.presentation?.comingSoon === true) continue;
     if (isPluginExtensionEnabled(provider, resolveEnabled)) {
       selectable.add(provider.id);
     }
@@ -29271,7 +29269,6 @@ function buildProviderRegistry(providers) {
     if (ui.emoji !== void 0) entry.emoji = ui.emoji;
     if (ui.icon !== void 0) entry.icon = ui.icon;
     if (ui.hideChip !== void 0) entry.hideChip = ui.hideChip;
-    if (ui.comingSoon !== void 0) entry.comingSoon = ui.comingSoon;
     registry[provider.id] = entry;
   }
   return registry;
@@ -31428,14 +31425,8 @@ var TUTORIAL_TEXTS = {
   // default).
   promptHeader: "{{glyph}}  Which agent should host the tutorial skill?",
   promptOption: "     {{index}}) {{label}}: {{skillDir}}{{marker}}",
-  // Coming-soon Providers are listed for visibility but cannot be picked
-  // (no skillDir, a `(coming soon)` tag instead of a target path).
-  promptOptionComingSoon: "     {{index}}) {{label}}  (coming soon)",
   promptDefaultMarker: "  (default)",
   promptInput: "  Enter the number or provider id [default {{index}}]: ",
-  // Shown (and the prompt re-asked) when the tester picks a coming-soon
-  // entry: it is visible but not selectable yet.
-  promptComingSoonNotice: "  {{label}} is coming soon, not selectable yet. Pick {{defaultLabel}}.",
   // Prompt answer matched neither an index nor an id. Goes to stderr,
   // exit code 2. Mirrors the error shape: glyph + headline + dim hint.
   promptInvalid: "{{glyph}}  sm tutorial: that is not one of the listed providers\n   {{hint}}\n",
@@ -31486,10 +31477,16 @@ var TutorialCommand = class extends SmCommand {
       Does NOT require an initialized .skill-map/ project. Refuses to
       overwrite the target directory unless --force is passed. Takes no
       positional argument.
+
+      By default only ready providers are offered as destinations. Pass
+      --experimental to also offer experimental ones (e.g. agent-skills);
+      they ship disabled, so enable the chosen one with
+      \`sm plugins enable <id>\` before scanning under its lens.
     `,
     examples: [
       ["Materialize the tutorial skill in the cwd", "$0 tutorial"],
-      ["Overwrite an existing target directory", "$0 tutorial --force"]
+      ["Overwrite an existing target directory", "$0 tutorial --force"],
+      ["Offer experimental providers as destinations", "$0 tutorial --experimental"]
     ]
   });
   // Legacy positional catcher: the verb takes no positional argument any
@@ -31507,6 +31504,9 @@ var TutorialCommand = class extends SmCommand {
   force = Option36.Boolean("--force", false, {
     description: "Overwrite an existing target directory without prompting."
   });
+  experimental = Option36.Boolean("--experimental", false, {
+    description: "Offer experimental providers (e.g. agent-skills) as destinations. They ship disabled; enable the chosen one with `sm plugins enable <id>`."
+  });
   async run() {
     const ctx = defaultRuntimeContext();
     const stderr = this.context.stderr;
@@ -31532,7 +31532,7 @@ var TutorialCommand = class extends SmCommand {
       );
       return ExitCode.Error;
     }
-    const targets = listScaffoldTargets();
+    const targets = listScaffoldTargets(this.experimental);
     const target = await this.resolveScaffoldTarget(targets, stderrAnsi, errGlyph);
     if (target === null) return ExitCode.Error;
     if (target.skillDir === void 0) {
@@ -31602,21 +31602,20 @@ var TutorialCommand = class extends SmCommand {
    * Returns `null` after printing an error (caller exits non-zero).
    */
   async resolveScaffoldTarget(targets, stderrAnsi, errGlyph) {
-    const selectable = selectableTargets(targets);
-    if (selectable.length === 0) {
+    if (targets.length === 0) {
       this.printer.error(tx(TUTORIAL_TEXTS.noTargets, { glyph: errGlyph }));
       return null;
     }
     const requested = this.forProvider;
     if (requested !== void 0) {
-      const found = selectable.find((t) => t.id === requested);
+      const found = targets.find((t) => t.id === requested);
       if (found === void 0) {
         this.printer.error(
           tx(TUTORIAL_TEXTS.forUnknown, {
             glyph: errGlyph,
             provider: requested,
             hint: stderrAnsi.dim(
-              tx(TUTORIAL_TEXTS.forUnknownHint, { ids: selectable.map((t) => t.id).join(", ") })
+              tx(TUTORIAL_TEXTS.forUnknownHint, { ids: targets.map((t) => t.id).join(", ") })
             )
           })
         );
@@ -31624,7 +31623,7 @@ var TutorialCommand = class extends SmCommand {
       }
       return found;
     }
-    const def = selectable[0];
+    const def = targets[0];
     const stdin = this.context.stdin;
     if (stdin.isTTY !== true) return def;
     const stderr = this.context.stderr;
@@ -31640,7 +31639,7 @@ var TutorialCommand = class extends SmCommand {
         tx(TUTORIAL_TEXTS.promptInvalid, {
           glyph: errGlyph,
           hint: stderrAnsi.dim(
-            tx(TUTORIAL_TEXTS.forUnknownHint, { ids: selectable.map((t) => t.id).join(", ") })
+            tx(TUTORIAL_TEXTS.forUnknownHint, { ids: targets.map((t) => t.id).join(", ") })
           )
         })
       );
@@ -31649,37 +31648,25 @@ var TutorialCommand = class extends SmCommand {
     return picked;
   }
 };
-function toScaffoldTarget(provider) {
-  const comingSoon = provider.presentation.comingSoon === true;
-  if (comingSoon) {
-    return {
-      id: provider.id,
-      label: provider.presentation.label,
-      aka: provider.scaffold?.aka ?? [],
-      comingSoon: true
-    };
-  }
+function toScaffoldTarget(provider, includeExperimental) {
   const scaffold = provider.scaffold;
   if (!scaffold || !scaffold.skillDir) return null;
+  if (!installedDefaultEnabled(provider.stability) && !includeExperimental) return null;
   return {
     id: provider.id,
     label: provider.presentation.label,
     skillDir: scaffold.skillDir,
-    aka: scaffold.aka ?? [],
-    comingSoon: false
+    aka: scaffold.aka ?? []
   };
 }
-function listScaffoldTargets() {
+function listScaffoldTargets(includeExperimental = false) {
   const out = [];
   for (const provider of builtIns().providers) {
-    const target = toScaffoldTarget(provider);
+    const target = toScaffoldTarget(provider, includeExperimental);
     if (target !== null) out.push(target);
   }
   return out;
 }
-function selectableTargets(targets) {
-  return targets.filter((t) => !t.comingSoon);
-}
 function labelWithAka(target) {
   return target.aka.length > 0 ? `${target.label} (${target.aka.join(", ")})` : target.label;
 }
@@ -31688,7 +31675,7 @@ function renderTargetLines(targets, def, glyph) {
   for (let i = 0; i < targets.length; i += 1) {
     const t = targets[i];
     lines.push(
-      t.comingSoon ? tx(TUTORIAL_TEXTS.promptOptionComingSoon, { index: i + 1, label: t.label }) : tx(TUTORIAL_TEXTS.promptOption, {
+      tx(TUTORIAL_TEXTS.promptOption, {
         index: i + 1,
         label: labelWithAka(t),
         skillDir: `${t.skillDir}/`,
@@ -31714,14 +31701,7 @@ async function promptForTarget(targets, def, stdin, stderr, glyph) {
         (resolveP) => rl.question(tx(TUTORIAL_TEXTS.promptInput, { index: defIndex + 1 }), resolveP)
       );
       const result = classifyAnswer(answer.trim(), targets, def);
-      if (result === null) continue;
-      if (!result.comingSoon) return result;
-      stderr.write(
-        tx(TUTORIAL_TEXTS.promptComingSoonNotice, {
-          label: result.label,
-          defaultLabel: def.label
-        }) + "\n"
-      );
+      if (result !== null) return result;
     }
     return null;
   } finally {
@@ -31977,4 +31957,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=be3954fe-3e41-5dae-bb8d-1d8225ffd77a
+//# debugId=09459eb1-3d6f-565d-9552-4819baae6f1a