@skill-map/cli 0.24.4 → 0.25.0

package/dist/cli.js

@@ -4614,8 +4614,8 @@ async function saveUpdateCheckCache(db, cache) {
 var SORT_BY_COLUMNS = /* @__PURE__ */ new Set([
   "path",
   "kind",
-  "bytes_total",
-  "bytesTotal",
+  "tokens_total",
+  "tokensTotal",
   "links_out_count",
   "linksOutCount",
   "links_in_count",
@@ -4626,7 +4626,7 @@ var SORT_BY_COLUMNS = /* @__PURE__ */ new Set([
 var SORT_BY_DEFAULT_DIRECTION = {
   path: "asc",
   kind: "asc",
-  bytesTotal: "desc",
+  tokensTotal: "desc",
   linksOutCount: "desc",
   linksInCount: "desc",
   externalRefsCount: "desc"
@@ -5747,7 +5747,7 @@ var UPDATE_CHECK_TEXTS = {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.24.4",
+  version: "0.25.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -15209,7 +15209,7 @@ var LIST_TEXTS = {
   tableHeaderIn: "IN",
   tableHeaderExt: "EXT",
   tableHeaderIssues: "ISSUES",
-  tableHeaderBytes: "BYTES",
+  tableHeaderTokens: "TOKENS",
   /** Footer line: count of rendered nodes (`3 nodes` / `1 node`). */
   tableFooterCount: "{{count}} {{noun}}\n",
   tableFooterNounSingular: "node",
@@ -15222,7 +15222,7 @@ var LIST_TEXTS = {
 var SORT_BY = {
   path: { column: "path", direction: "asc" },
   kind: { column: "kind", direction: "asc" },
-  bytes_total: { column: "bytesTotal", direction: "desc" },
+  tokens_total: { column: "tokensTotal", direction: "desc" },
   links_out_count: { column: "linksOutCount", direction: "desc" },
   links_in_count: { column: "linksInCount", direction: "desc" },
   external_refs_count: { column: "externalRefsCount", direction: "desc" }
@@ -15241,7 +15241,7 @@ var ListCommand = class extends SmCommand {
       and sidecar.annotations.tags by default; --tag-source author|user
       narrows to one side).
 
-      --sort-by accepts: path, kind, bytes_total, links_out_count,
+      --sort-by accepts: path, kind, tokens_total, links_out_count,
       links_in_count, external_refs_count. Default: path. --limit N caps
       the result; default is no limit.
 
@@ -15250,7 +15250,7 @@ var ListCommand = class extends SmCommand {
     examples: [
       ["List every node", "$0 list"],
       ["List only agents", "$0 list --kind agent"],
-      ["Top 5 by total bytes", "$0 list --sort-by bytes_total --limit 5"],
+      ["Top 5 by total tokens", "$0 list --sort-by tokens_total --limit 5"],
       ["Only nodes with issues, machine-readable", "$0 list --issue --json"],
       ["Filter by tag (author or user surfaces)", "$0 list --tag urgent"],
       ["Filter by user-only tag", "$0 list --tag wip --tag-source user"]
@@ -15393,7 +15393,7 @@ function renderTable2(nodes, issuesByNode, ansi) {
     in: n.linksInCount,
     ext: n.externalRefsCount,
     issues: issuesByNode.get(n.path) ?? 0,
-    bytes: n.bytes.total
+    tokens: n.tokens?.total ?? null
   }));
   const widths = computeWidths(rows);
   const lines = [];
@@ -15421,9 +15421,12 @@ function computeWidths(rows) {
     in: Math.max(headerLen(LIST_TEXTS.tableHeaderIn), ...rows.map((r) => String(r.in).length)),
     ext: Math.max(headerLen(LIST_TEXTS.tableHeaderExt), ...rows.map((r) => String(r.ext).length)),
     issues: Math.max(headerLen(LIST_TEXTS.tableHeaderIssues), ...rows.map((r) => String(r.issues).length)),
-    bytes: Math.max(headerLen(LIST_TEXTS.tableHeaderBytes), ...rows.map((r) => String(r.bytes).length))
+    tokens: Math.max(headerLen(LIST_TEXTS.tableHeaderTokens), ...rows.map((r) => formatTokens(r.tokens).length))
   };
 }
+function formatTokens(value) {
+  return value === null ? "-" : String(value);
+}
 function clampMax(value, max) {
   return value > max ? max : value;
 }
@@ -15436,7 +15439,7 @@ function formatHeaderRow(w, ansi) {
     ansi.dim(LIST_TEXTS.tableHeaderIn.padStart(w.in)),
     ansi.dim(LIST_TEXTS.tableHeaderExt.padStart(w.ext)),
     ansi.dim(LIST_TEXTS.tableHeaderIssues.padStart(w.issues)),
-    ansi.dim(LIST_TEXTS.tableHeaderBytes.padStart(w.bytes))
+    ansi.dim(LIST_TEXTS.tableHeaderTokens.padStart(w.tokens))
   ].join("  ");
 }
 function formatDataRow(r, w, ansi) {
@@ -15449,7 +15452,7 @@ function formatDataRow(r, w, ansi) {
     String(r.in).padStart(w.in),
     String(r.ext).padStart(w.ext),
     issuesCol,
-    String(r.bytes).padStart(w.bytes)
+    formatTokens(r.tokens).padStart(w.tokens)
   ].join("  ");
 }
 
@@ -22308,7 +22311,7 @@ var SHOW_TEXTS = {
   /** Tail appended to `nodeHeader` when provider differs from kind. */
   providerSuffix: "   {{label}}",
   providerSuffixLabel: "provider: {{provider}}",
-  // --- field block (Title / Description / Bytes / Tokens / …) ---------
+  // --- field block (Title / Description / Tokens / …) -----------------
   /** Field row, label padded by the renderer to align values. */
   fieldRow: "  {{label}}  {{value}}\n",
   /** Continuation indent for multi-line values (description, etc.). */
@@ -22317,7 +22320,6 @@ var SHOW_TEXTS = {
   fieldLabelDescription: "Description",
   fieldLabelStability: "Stability",
   fieldLabelVersion: "Version",
-  fieldLabelBytes: "Bytes",
   fieldLabelTokens: "Tokens",
   fieldLabelExternalRefs: "External refs",
   /** `{{total}} total · {{frontmatter}} frontmatter · {{body}} body`. */
@@ -22431,23 +22433,13 @@ function collectNodeFields(node) {
     fields.push({ label: SHOW_TEXTS.fieldLabelVersion, value: sanitizeForTerminal(String(projected.version)) });
   }
   fields.push({
-    label: SHOW_TEXTS.fieldLabelBytes,
-    value: tx(SHOW_TEXTS.weightSplit, {
-      total: node.bytes.total,
-      frontmatter: node.bytes.frontmatter,
-      body: node.bytes.body
-    })
+    label: SHOW_TEXTS.fieldLabelTokens,
+    value: node.tokens ? tx(SHOW_TEXTS.weightSplit, {
+      total: node.tokens.total,
+      frontmatter: node.tokens.frontmatter,
+      body: node.tokens.body
+    }) : "-"
   });
-  if (node.tokens) {
-    fields.push({
-      label: SHOW_TEXTS.fieldLabelTokens,
-      value: tx(SHOW_TEXTS.weightSplit, {
-        total: node.tokens.total,
-        frontmatter: node.tokens.frontmatter,
-        body: node.tokens.body
-      })
-    });
-  }
   fields.push({ label: SHOW_TEXTS.fieldLabelExternalRefs, value: String(node.externalRefsCount) });
   return fields;
 }
@@ -23291,7 +23283,7 @@ import { Command as Command37, Option as Option35 } from "clipanion";
 
 // cli/i18n/tutorial.texts.ts
 var TUTORIAL_TEXTS = {
-  // Success, written to stdout after `<cwd>/sm-tutorial.md` is created.
+  // Success, written to stdout after `<cwd>/{{filename}}` is created.
   // Multi-line layout: the two trigger phrases (English / Spanish) are
   // indented and labelled so they're the most visible part of the
   // output. The reminder above them surfaces the SKILL's language
@@ -23303,55 +23295,91 @@ var TUTORIAL_TEXTS = {
    * `English` / `Español` labels print dim, the eye lands on the
    * trigger phrases the user is going to copy / paste.
    */
-  written: "  {{glyph}}  sm-tutorial.md created at {{cwd}}\n\n  Open Claude Code in this directory. Your first message sets\n  the tutorial language for the rest of the session:\n\n      {{enLabel}}  run @sm-tutorial.md\n      {{esLabel}}  ejecut\xE1 @sm-tutorial.md\n",
+  written: "  {{glyph}}  {{filename}} created at {{cwd}}\n\n  Open Claude Code in this directory. Your first message sets\n  the tutorial language for the rest of the session:\n\n      {{enLabel}}  run @{{filename}}\n      {{esLabel}}  ejecut\xE1 @{{filename}}\n",
   writtenLabelEn: "English",
   writtenLabelEs: "Espa\xF1ol",
-  // Refusal, `sm-tutorial.md` already exists and `--force` was not set.
+  // Refusal, `{{filename}}` already exists and `--force` was not set.
   // Goes to stderr, exit code 2 (operational error per spec § Exit codes).
   // Mirrors the success body shape: glyph + headline, then a dim hint
   // line spelling the fix.
-  alreadyExists: "{{glyph}}  sm-tutorial.md already exists at {{cwd}}\n   {{hint}}\n",
+  alreadyExists: "{{glyph}}  {{filename}} already exists at {{cwd}}\n   {{hint}}\n",
   alreadyExistsHint: "Pass `--force` to overwrite.",
+  // Invalid `variant` positional argument. Goes to stderr, exit code 2.
+  // Mirrors `alreadyExists`: glyph + headline + dim hint enumerating the
+  // valid values.
+  invalidVariant: "{{glyph}}  sm tutorial: unknown variant '{{variant}}'\n   {{hint}}\n",
+  invalidVariantHint: "Valid values: tutorial (default), master.",
   // I/O failure on write or on reading the bundled SKILL source.
-  writeFailed: "{{glyph}}  sm tutorial: failed to write sm-tutorial.md: {{message}}\n",
-  sourceMissing: "{{glyph}}  sm tutorial: could not read the bundled tutorial (SKILL.md) from the install.\n   {{hint}}\n",
+  writeFailed: "{{glyph}}  sm tutorial: failed to write {{filename}}: {{message}}\n",
+  sourceMissing: "{{glyph}}  sm tutorial: could not read the bundled tutorial ({{filename}}) from the install.\n   {{hint}}\n",
   sourceMissingHint: "Reinstall @skill-map/cli or report the bug."
 };
 
 // cli/commands/tutorial.ts
-var SM_TUTORIAL_FILENAME = "sm-tutorial.md";
+var VALID_VARIANTS = ["tutorial", "master"];
+var DEFAULT_VARIANT = "tutorial";
+var VARIANT_SPECS = {
+  tutorial: {
+    filename: "sm-tutorial.md",
+    sourcePath: ".claude/skills/sm-tutorial/SKILL.md",
+    bundledName: "sm-tutorial.md"
+  },
+  master: {
+    filename: "sm-master.md",
+    sourcePath: ".claude/skills/sm-master/SKILL.md",
+    bundledName: "sm-master.md"
+  }
+};
 var TutorialCommand = class extends SmCommand {
   static paths = [["tutorial"]];
   static usage = Command37.Usage({
     category: "Setup",
-    description: "Materialize the interactive tester tutorial (sm-tutorial.md) in the current directory.",
+    description: "Materialize an interactive tester tutorial (sm-tutorial.md or sm-master.md) in the current directory.",
     details: `
-      Drops the canonical SKILL.md content as ./sm-tutorial.md so a tester
-      can open Claude Code in the cwd and load the file as a skill by
-      typing "ejecut\xE1 @sm-tutorial.md". Top-level only; no subdirectory
-      is created.
+      Drops the canonical SKILL.md content as ./sm-tutorial.md (default)
+      or ./sm-master.md (when invoked as \`sm tutorial master\`) so a
+      tester can open Claude Code in the cwd and load the file as a
+      skill by typing "ejecut\xE1 @sm-tutorial.md" (or "@sm-master.md").
+      Top-level only; no subdirectory is created.
 
       Does NOT require an initialized .skill-map/ project. Refuses to
-      overwrite an existing sm-tutorial.md unless --force is passed.
+      overwrite the target file unless --force is passed. Valid values
+      for the positional argument are: tutorial (default), master.
     `,
     examples: [
-      ["Materialize the tutorial in the cwd", "$0 tutorial"],
-      ["Overwrite an existing sm-tutorial.md", "$0 tutorial --force"]
+      ["Materialize the basic tutorial in the cwd", "$0 tutorial"],
+      ["Materialize the advanced tutorial in the cwd", "$0 tutorial master"],
+      ["Overwrite an existing target file", "$0 tutorial --force"]
     ]
   });
+  variant = Option35.String({ required: false });
   force = Option35.Boolean("--force", false, {
-    description: "Overwrite an existing sm-tutorial.md without prompting."
+    description: "Overwrite an existing target file without prompting."
   });
   async run() {
     const ctx = defaultRuntimeContext();
-    const target = join17(ctx.cwd, SM_TUTORIAL_FILENAME);
     const stderr = this.context.stderr;
     const stderrAnsi = this.ansiFor("stderr");
     const errGlyph = stderrAnsi.red("\u2715");
+    const rawVariant = this.variant;
+    if (rawVariant !== void 0 && !isTutorialVariant(rawVariant)) {
+      this.printer.error(
+        tx(TUTORIAL_TEXTS.invalidVariant, {
+          glyph: errGlyph,
+          variant: rawVariant,
+          hint: stderrAnsi.dim(TUTORIAL_TEXTS.invalidVariantHint)
+        })
+      );
+      return ExitCode.Error;
+    }
+    const variant = rawVariant ?? DEFAULT_VARIANT;
+    const spec = VARIANT_SPECS[variant];
+    const target = join17(ctx.cwd, spec.filename);
     if (await pathExists(target) && !this.force) {
       this.printer.error(
         tx(TUTORIAL_TEXTS.alreadyExists, {
           glyph: errGlyph,
+          filename: spec.filename,
           cwd: stderrAnsi.dim(displayCwd(ctx.cwd)),
           hint: stderrAnsi.dim(TUTORIAL_TEXTS.alreadyExistsHint)
         })
@@ -23360,11 +23388,12 @@ var TutorialCommand = class extends SmCommand {
     }
     let body;
     try {
-      body = loadBundledTutorialText();
+      body = loadBundledTutorialText(variant);
     } catch {
       this.printer.error(
         tx(TUTORIAL_TEXTS.sourceMissing, {
           glyph: errGlyph,
+          filename: spec.filename,
           hint: stderrAnsi.dim(TUTORIAL_TEXTS.sourceMissingHint)
         })
       );
@@ -23376,6 +23405,7 @@ var TutorialCommand = class extends SmCommand {
       this.printer.error(
         tx(TUTORIAL_TEXTS.writeFailed, {
           glyph: errGlyph,
+          filename: spec.filename,
           message: formatErrorMessage(err)
         })
       );
@@ -23391,6 +23421,7 @@ var TutorialCommand = class extends SmCommand {
     this.printer.data(
       tx(TUTORIAL_TEXTS.written, {
         glyph: ansi.green("\u2713"),
+        filename: spec.filename,
         cwd: ansi.dim(displayCwd(ctx.cwd)),
         enLabel: ansi.dim(TUTORIAL_TEXTS.writtenLabelEn),
         esLabel: ansi.dim(TUTORIAL_TEXTS.writtenLabelEs)
@@ -23399,26 +23430,32 @@ var TutorialCommand = class extends SmCommand {
     return ExitCode.Ok;
   }
 };
+function isTutorialVariant(value) {
+  return VALID_VARIANTS.includes(value);
+}
 function displayCwd(cwd) {
   const segments = cwd.split("/").filter((s) => s.length > 0);
   if (segments.length === 0) return "./";
   return `./${segments[segments.length - 1]}/`;
 }
-var cachedTutorial = null;
-function loadBundledTutorialText() {
-  if (cachedTutorial !== null) return cachedTutorial;
-  cachedTutorial = readTutorialFromDisk();
-  return cachedTutorial;
+var cachedTutorials = /* @__PURE__ */ new Map();
+function loadBundledTutorialText(variant) {
+  const cached = cachedTutorials.get(variant);
+  if (cached !== void 0) return cached;
+  const body = readTutorialFromDisk(variant);
+  cachedTutorials.set(variant, body);
+  return body;
 }
-function readTutorialFromDisk() {
+function readTutorialFromDisk(variant) {
+  const spec = VARIANT_SPECS[variant];
   const here = dirname18(fileURLToPath6(import.meta.url));
   const candidates = [
-    // dev: src/cli/commands/ → repo-root .claude/skills/sm-tutorial/SKILL.md
-    resolve36(here, "../../../.claude/skills/sm-tutorial/SKILL.md"),
-    // bundled: dist/cli.js → dist/cli/tutorial/sm-tutorial.md (sibling)
-    resolve36(here, "cli/tutorial/sm-tutorial.md"),
-    // bundled fallback: any-depth → cli/tutorial/sm-tutorial.md
-    resolve36(here, "../cli/tutorial/sm-tutorial.md")
+    // dev: src/cli/commands/ → repo-root .claude/skills/<slug>/SKILL.md
+    resolve36(here, "../../..", spec.sourcePath),
+    // bundled: dist/cli.js → dist/cli/tutorial/<filename> (sibling)
+    resolve36(here, "cli/tutorial", spec.bundledName),
+    // bundled fallback: any-depth → cli/tutorial/<filename>
+    resolve36(here, "../cli/tutorial", spec.bundledName)
   ];
   for (const candidate of candidates) {
     if (existsSync28(candidate)) {