@skill-map/cli 0.53.4 → 0.53.6

package/dist/cli/tutorial/sm-tutorial/references/part-settings.md

@@ -1,6 +1,6 @@
-# Part 7 (a): Extend skill-map - settings (step library, `settings-*` ids)
+# Part 6 (a): Extend skill-map - settings (step library, `settings-*` ids)
 
-Step bodies for the settings chapters of Part 7 (config layers, the
+Step bodies for the settings chapters of Part 6 (config layers, the
 `sm config` verbs, the active provider lens), plus the shared step
 `settings-6-contributions` that the plugin-authoring chapters reuse.
 The SKILL.md orchestrator dispatches each `settings-*` chapter id

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]="888d57e8-17f0-5013-89d1-f60f3ef2828b")}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]="3bc438eb-6e57-550d-aab1-392242aca915")}catch(e){}}();
 import { existsSync as existsSync33 } from "fs";
 import { Builtins, Cli as Cli2 } from "clipanion";
 
@@ -246,7 +246,7 @@ function bucketByKind(kind, instance, bag) {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.53.4",
+  version: "0.53.6",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -14839,6 +14839,13 @@ var HELP_TEXTS = {
    * Tagline mirrors README.md "In a sentence", keep them in sync.
    */
   compactHeader: "{{binary}} {{version}}:  the missing map for Markdown-based generative-AI ecosystems",
+  /**
+   * Tutorial call-to-action rendered at the very top of the compact
+   * overview, directly under the header and above USAGE, to point new
+   * users at `sm tutorial`. `{{glyph}}` is a green `▶` when color is on,
+   * a bare `▶` otherwise.
+   */
+  compactTutorialCta: "{{glyph}}  New to skill-map? Run `sm tutorial` for a hands-on, guided walkthrough.",
   compactUsageHeading: "USAGE",
   compactUsageLine: "  sm <command> [options]",
   compactExamplesHeading: "EXAMPLES",
@@ -14916,9 +14923,16 @@ var HelpCommand = class extends Command15 {
   });
   verbParts = Option14.Rest({ required: 0 });
   format = Option14.String("--format", "human");
+  // `HelpCommand` extends Clipanion's `Command` directly (see block
+  // comment), so it does not inherit `SmCommand`'s `--no-color`. Declared
+  // here because the human overview now emits a coloured tutorial glyph;
+  // `ansiFor` still layers `NO_COLOR` / `FORCE_COLOR` / TTY on top.
+  noColor = Option14.Boolean("--no-color", false, {
+    description: "Disable ANSI color codes."
+  });
   async execute() {
     const stderr = this.context.stderr;
-    const ansi = ansiFor({ isTTY: stderr.isTTY === true, noColorFlag: false });
+    const ansi = ansiFor({ isTTY: stderr.isTTY === true, noColorFlag: this.noColor });
     const errGlyph = ansi.red("\u2715");
     const format = normalizeFormat(this.format);
     if (!format) {
@@ -14954,7 +14968,9 @@ var HelpCommand = class extends Command15 {
       return ExitCode.NotFound;
     }
     if (format === "human") {
-      this.context.stdout.write(renderCompactOverview(verbs));
+      const stdout = this.context.stdout;
+      const stdoutAnsi = ansiFor({ isTTY: stdout.isTTY === true, noColorFlag: this.noColor });
+      this.context.stdout.write(renderCompactOverview(verbs, stdoutAnsi));
       return ExitCode.Ok;
     }
     const doc = {
@@ -15255,10 +15271,12 @@ function truncate2(text, width) {
 function padRight(value, width) {
   return value.length >= width ? value : value + " ".repeat(width - value.length);
 }
-function renderCompactOverview(verbs) {
+function renderCompactOverview(verbs, ansi) {
   const lines = [];
   lines.push(tx(HELP_TEXTS.compactHeader, { binary: BINARY_LABEL, version: VERSION }));
   lines.push("");
+  lines.push(tx(HELP_TEXTS.compactTutorialCta, { glyph: ansi.green("\u25B6") }));
+  lines.push("");
   lines.push(HELP_TEXTS.compactUsageHeading);
   lines.push(HELP_TEXTS.compactUsageLine);
   lines.push("");
@@ -15303,9 +15321,17 @@ function renderCompactOverview(verbs) {
 }
 var RootHelpCommand = class extends Command15 {
   static paths = [["-h"], ["--help"]];
+  // Mirrors `HelpCommand.noColor`: this command extends Clipanion's
+  // `Command` directly, so the flag is declared here to gate the
+  // coloured tutorial glyph in the overview.
+  noColor = Option14.Boolean("--no-color", false, {
+    description: "Disable ANSI color codes."
+  });
   async execute() {
     const verbs = buildVerbCatalog(this.cli);
-    this.context.stdout.write(renderCompactOverview(verbs));
+    const stdout = this.context.stdout;
+    const ansi = ansiFor({ isTTY: stdout.isTTY === true, noColorFlag: this.noColor });
+    this.context.stdout.write(renderCompactOverview(verbs, ansi));
     return ExitCode.Ok;
   }
 };
@@ -30251,4 +30277,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=888d57e8-17f0-5013-89d1-f60f3ef2828b
+//# debugId=3bc438eb-6e57-550d-aab1-392242aca915

package/dist/index.js

@@ -1,6 +1,6 @@
 // kernel/i18n/registry.texts.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]="66543317-554b-53e5-b2d4-5ed32dfdc81a")}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]="e4042206-8e88-53b7-93f5-c2c9bbb77b3e")}catch(e){}}();
 var REGISTRY_TEXTS = {
   duplicateExtension: "Extension already registered: {{kind}}:{{qualifiedId}}",
   unknownKind: "Unknown extension kind: {{kind}}",
@@ -102,7 +102,7 @@ import { Tiktoken as Tiktoken2 } from "js-tiktoken/lite";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.53.4",
+  version: "0.53.6",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -3632,4 +3632,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=66543317-554b-53e5-b2d4-5ed32dfdc81a
+//# debugId=e4042206-8e88-53b7-93f5-c2c9bbb77b3e

package/dist/kernel/index.js

@@ -1,6 +1,6 @@
 // kernel/i18n/registry.texts.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]="3034c153-d87d-57ef-9e51-8770d99ad465")}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]="edd337e5-10f2-5ebc-92b6-0e1ea1dd4e3f")}catch(e){}}();
 var REGISTRY_TEXTS = {
   duplicateExtension: "Extension already registered: {{kind}}:{{qualifiedId}}",
   unknownKind: "Unknown extension kind: {{kind}}",
@@ -102,7 +102,7 @@ import { Tiktoken as Tiktoken2 } from "js-tiktoken/lite";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.53.4",
+  version: "0.53.6",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -3632,4 +3632,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=3034c153-d87d-57ef-9e51-8770d99ad465
+//# debugId=edd337e5-10f2-5ebc-92b6-0e1ea1dd4e3f