@skill-map/cli 0.61.3 → 0.61.5

package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/__PROVIDER__/agents/content-editor.md

@@ -18,4 +18,4 @@ Turns a short brief into a finished portfolio page.
 4. Use one `<h1>`, group sections under `<h2>`, and reuse the shared header, nav, and footer so every page matches.
 5. Add a link back to Home, and link the new page from the home nav.
 
-Rules: plain static HTML, no framework, no client JS, one page per file.
+Rules: plain static HTML, no framework, no client JS, one page per file. If a page needs an image, use a free placeholder from https://placekittens.com/ (e.g. `https://placekittens.com/400/300`) so the `<img>` never points at a missing file.

package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/__PROVIDER__/agents/content-editor.md

@@ -18,4 +18,4 @@ Convierte un brief corto en una página de portfolio terminada.
 4. Usa un solo `<h1>`, agrupa las secciones bajo `<h2>` y reutiliza el header, la nav y el footer compartidos para que todas las páginas coincidan.
 5. Agrega un enlace de vuelta a Home, y enlaza la nueva página desde la nav de inicio.
 
-Reglas: HTML estático plano, sin framework, sin JS de cliente, una página por archivo.
+Reglas: HTML estático plano, sin framework, sin JS de cliente, una página por archivo. Si una página necesita una imagen, usa un placeholder gratuito de https://placekittens.com/ (por ejemplo `https://placekittens.com/400/300`) para que el `<img>` nunca apunte a un archivo inexistente.

package/dist/cli/tutorial/sm-tutorial/references/_manifest.json

@@ -128,13 +128,8 @@
       "chapters": [
         {
           "id": "setup",
-          "title": "Make it yours, make it presentable",
-          "est_min": 3
-        },
-        {
-          "id": "preview",
-          "title": "Bring it up and see your site",
-          "est_min": 2
+          "title": "Make it yours and bring it up",
+          "est_min": 5
         },
         {
           "id": "add-page",

package/dist/cli/tutorial/sm-tutorial/references/_manifest.yml

@@ -143,8 +143,7 @@ parts:
     fixture: portfolio        # reuses the wired harness; lays the pretty site (style.css + pages) as taught steps
     status: active
     chapters:
-      - id: setup            ; title: "Make it yours, make it presentable" ; est_min: 3
-      - id: preview          ; title: "Bring it up and see your site" ; est_min: 2
+      - id: setup            ; title: "Make it yours and bring it up" ; est_min: 5
       - id: add-page         ; title: "Add a page with your agent" ; est_min: 4
       - id: broken-ref       ; title: "A rename breaks a link" ; est_min: 4
       - id: reserved         ; title: "A reserved name collides" ; est_min: 2

package/dist/cli/tutorial/sm-tutorial/references/part-connect-harness.md

@@ -162,6 +162,12 @@ Tell the tester:
 > daily-loop part. The opacity on the canvas is just that number drawn
 > as transparency.
 >
+> **Note:** why does confidence matter? It mirrors how the runtime itself
+> resolves a reference: a deterministic name-and-path lookup, no guessing
+> and no scanning the tree for a file under some other extension. That is
+> cheaper and it does not fail, so the agent spends fewer tokens and less
+> time, the same reason a clean, well-named harness is worth keeping.
+>
 > Do you see every badge reading 1.00 in the Inspector?
 
 Wait for confirmation. Mark `confidence`: done. Last chapter of the part: apply §Closing a part (the close names the part by its title and routes back to the menu; do NOT lead into the next part from here).

package/dist/cli/tutorial/sm-tutorial/references/part-daily-loop.md

@@ -45,14 +45,16 @@ broken-reference markers, and confidence live.
 
 **Act A - Add**
 
-## Chapter `setup` - Make it yours, make it presentable (~3 min)
+## Chapter `setup` - Make it yours and bring it up (~5 min)
 
 **Context**: the harness is wired (you built it in the earlier parts). Now you
 put it to work on a real day. First, make the site yours and give it a look you
-would not be embarrassed to share. The honest beat: the HTML and CSS are
-Layer 2 (the harness's output); skill-map maps the harness (Layer 1, the `.md`
-files), so the site landing on disk does NOT move the graph, and that is
-correct, not a bug.
+would not be embarrassed to share, then serve it and open it in the browser, the
+early payoff before the daily loop fills it with pages. The honest beat: the HTML
+and CSS are Layer 2 (the harness's output); skill-map maps the harness (Layer 1,
+the `.md` files), so the site landing on disk does NOT move the graph, and that
+is correct, not a bug. The tester runs the serve commands themselves (one of the
+few non-`sm` beats); guide them, do not run them.
 
 **Preparation**:
 
@@ -169,31 +171,25 @@ footer.site { border-top: 1px solid var(--border); padding: 2rem 0; color: var(-
 </html>
 ```
 
-Tell the tester the face is on (no serving yet, that is the next chapter):
-
-> I gave your site a face: a shared stylesheet plus a styled **Home** and
-> **About** page, named after you. These are Layer 2 (the harness's output), so
-> the **Map** did not move, and that is correct: skill-map maps the harness (the
-> `.md` files, Layer 1), not the HTML it produces. Next we bring it up so you
-> can see it.
-
-Mark `setup`: done. Auto-advance to `preview`.
-
-## Chapter `preview` - Bring it up and see your site (~2 min)
-
-**Context**: the first look. The site is styled but the tester has only seen it
-as files; now serve it and open it in the browser, the early payoff before the
-daily loop fills it with pages. The tester runs the commands themselves (one of
-the few non-`sm` beats); guide them, do not run them.
+The site is styled now, so bring it up in the same beat (the tester runs the
+serve commands themselves). `sm` is still running in their second terminal, so
+the server needs a **third terminal** anchored to the same project folder:
 
 ```bash
 npm install
 node server.js
 ```
 
-> Bring your site up. `npm install` pulls the one small library the server needs
-> (Express, on the Node you already have), and `node server.js` starts it and
-> prints a line like `Listening on http://localhost:3000`.
+> **Note:** I gave your site a face: a shared stylesheet plus a styled **Home**
+> and **About** page, named after you. These are Layer 2 (the harness's output),
+> so the **Map** did not move, and that is correct: skill-map maps the harness
+> (the `.md` files, Layer 1), not the HTML it produces.
+>
+> Now bring your site up. `sm` is still running in your second terminal, so open
+> a **third terminal** in this same project folder and run the two commands
+> there. `npm install` pulls the one small library the server needs (Express, on
+> the Node you already have), and `node server.js` starts it and prints a line
+> like `Listening on http://localhost:3000`.
 >
 > Open `http://localhost:3000`: there is your site, named after you, with a
 > clean layout. Click **About** and back to **Home**.
@@ -209,7 +205,7 @@ node server.js
 Wait for confirmation. If `node server.js` reports `Cannot find module
 'express'`, `npm install` did not run first, run it (it reads `package.json` and
 pulls Express), then retry; if `npm install` itself fails, check they are in the
-project root and Node is on PATH. Mark `preview`: done. Auto-advance to
+project root and Node is on PATH. Mark `setup`: done. Auto-advance to
 `add-page`.
 
 ## Chapter `add-page` - Add a page with your agent (~4 min)
@@ -335,10 +331,11 @@ The watcher picks up the new command. Tell the tester:
 > `/help`, `/clear`, `/config`), so the runtime would silently ignore your file,
 > it never runs. The fix is a name the runtime does not own.
 >
-> Rename it to `new-page`: rename the file `.claude/commands/init.md` to
-> `.claude/commands/new-page.md`, AND change `frontmatter.name` to `new-page`
-> and the H1 to `# new-page` (a command's H1 stays a plain title, never
-> `# /new-page`). Save.
+> Rename it to `new-page`: first rename the file `.claude/commands/init.md` to
+> `.claude/commands/new-page.md`. Then open it in your text editor / IDE and, at
+> the top, where the frontmatter says `name: init`, change it to
+> `name: new-page`; also change the H1 to `# new-page` (a command's H1 stays a
+> plain title, never `# /new-page`). Save.
 >
 > Watch the **Map** again: the warning clears and the node is now `new-page`,
 > all live. Notice what cleared it: changing the **name** (`frontmatter.name`),
@@ -396,7 +393,9 @@ conditional on the real result):
 > And the Map did not move while the pipeline ran: the pages are Layer 2 output;
 > the harness on the canvas is Layer 1, and that is what skill-map maps.
 >
-> Did the publish run report the link check clean?
+> As you saw in the lines just above, I did not report anything odd: the link
+> check came back clean and `/publish` is wired correctly across your pages.
+> Shall we continue?
 
 Wait for confirmation. Mark `publish`: done. Auto-advance to `stability`.
 
@@ -472,7 +471,14 @@ Wait for confirmation. The tester runs the commands; do not run them. If
 server with Ctrl+C and apply the ports edge case.
 
 This is the campaign finale. Congratulate them plainly: they went from an empty
-directory to a real, running portfolio plus a complete map of its harness. Mark
-`golive`: done. Last chapter of the part: apply §Closing a part (name the part
-by its title); since this closes the campaign spine, if every active part is now
-done route to the §Final wrap-up instead of the menu.
+directory to a real, running portfolio plus a complete map of its harness. Then
+invite them to keep going on their own:
+
+> And this site is yours to keep playing with: add more pages, refine the style
+> guide, wire a new command, then watch the map react. Creating and maintaining a
+> small site like this, by hand, is the best practice there is for getting a feel
+> for how to build a harness.
+
+Mark `golive`: done. Last chapter of the part: apply §Closing a part (name the
+part by its title); since this closes the campaign spine, if every active part is
+now done route to the §Final wrap-up instead of the menu.

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]="ce13dce1-d18b-5abf-b6a8-1ef997ccaf99")}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]="971924c5-3da8-5670-8c42-6f13b41acfa0")}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.61.3",
+  version: "0.61.5",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -30561,8 +30561,14 @@ 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",
@@ -30629,7 +30635,7 @@ var TutorialCommand = class extends SmCommand {
   // the skill is materialised under, skipping the interactive prompt.
   forProvider = Option36.String("--for", {
     required: false,
-    description: "Destination provider id (e.g. claude, agent-skills). Skips the prompt."
+    description: "Destination provider id (e.g. claude). Skips the prompt."
   });
   force = Option36.Boolean("--force", false, {
     description: "Overwrite an existing target directory without prompting."
@@ -30662,6 +30668,10 @@ var TutorialCommand = class extends SmCommand {
     const targets = listScaffoldTargets();
     const target = await this.resolveScaffoldTarget(targets, stderrAnsi, errGlyph);
     if (target === null) return ExitCode.Error;
+    if (target.skillDir === void 0) {
+      this.printer.error(tx(TUTORIAL_TEXTS.noTargets, { glyph: errGlyph }));
+      return ExitCode.Error;
+    }
     const targetDir = join21(ctx.cwd, target.skillDir, SKILL_SLUG);
     const targetDisplay = `${target.skillDir}/${SKILL_SLUG}/`;
     let sourceDir;
@@ -30725,20 +30735,21 @@ var TutorialCommand = class extends SmCommand {
    * Returns `null` after printing an error (caller exits non-zero).
    */
   async resolveScaffoldTarget(targets, stderrAnsi, errGlyph) {
-    if (targets.length === 0) {
+    const selectable = selectableTargets(targets);
+    if (selectable.length === 0) {
       this.printer.error(tx(TUTORIAL_TEXTS.noTargets, { glyph: errGlyph }));
       return null;
     }
     const requested = this.forProvider;
     if (requested !== void 0) {
-      const found = targets.find((t) => t.id === requested);
+      const found = selectable.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: targets.map((t) => t.id).join(", ") })
+              tx(TUTORIAL_TEXTS.forUnknownHint, { ids: selectable.map((t) => t.id).join(", ") })
             )
           })
         );
@@ -30746,14 +30757,13 @@ var TutorialCommand = class extends SmCommand {
       }
       return found;
     }
-    const defaultIndex = 0;
-    const def = targets[defaultIndex];
+    const def = selectable[0];
     const stdin = this.context.stdin;
-    if (targets.length === 1 || stdin.isTTY !== true) return def;
+    if (stdin.isTTY !== true) return def;
     const stderr = this.context.stderr;
     const picked = await promptForTarget(
       targets,
-      defaultIndex,
+      def,
       stdin,
       stderr,
       stderrAnsi.yellow("?")
@@ -30763,7 +30773,7 @@ var TutorialCommand = class extends SmCommand {
         tx(TUTORIAL_TEXTS.promptInvalid, {
           glyph: errGlyph,
           hint: stderrAnsi.dim(
-            tx(TUTORIAL_TEXTS.forUnknownHint, { ids: targets.map((t) => t.id).join(", ") })
+            tx(TUTORIAL_TEXTS.forUnknownHint, { ids: selectable.map((t) => t.id).join(", ") })
           )
         })
       );
@@ -30773,13 +30783,23 @@ var TutorialCommand = class extends SmCommand {
   }
 };
 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
+    };
+  }
   const scaffold = provider.scaffold;
   if (!scaffold || !scaffold.skillDir) return null;
   return {
     id: provider.id,
     label: provider.presentation.label,
     skillDir: scaffold.skillDir,
-    aka: scaffold.aka ?? []
+    aka: scaffold.aka ?? [],
+    comingSoon: false
   };
 }
 function listScaffoldTargets() {
@@ -30790,36 +30810,53 @@ function listScaffoldTargets() {
   }
   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;
 }
-async function promptForTarget(targets, defaultIndex, stdin, stderr, glyph) {
+function renderTargetLines(targets, def, glyph) {
   const lines = [tx(TUTORIAL_TEXTS.promptHeader, { glyph })];
   for (let i = 0; i < targets.length; i += 1) {
     const t = targets[i];
     lines.push(
-      tx(TUTORIAL_TEXTS.promptOption, {
+      t.comingSoon ? tx(TUTORIAL_TEXTS.promptOptionComingSoon, { index: i + 1, label: t.label }) : tx(TUTORIAL_TEXTS.promptOption, {
         index: i + 1,
         label: labelWithAka(t),
         skillDir: `${t.skillDir}/`,
-        marker: i === defaultIndex ? TUTORIAL_TEXTS.promptDefaultMarker : ""
+        marker: t.id === def.id ? TUTORIAL_TEXTS.promptDefaultMarker : ""
       })
     );
   }
-  stderr.write(lines.join("\n") + "\n");
+  return lines.join("\n");
+}
+function classifyAnswer(trimmed, targets, def) {
+  if (trimmed === "") return def;
+  const asNumber = Number.parseInt(trimmed, 10);
+  const byIndex = !Number.isNaN(asNumber) && asNumber >= 1 && asNumber <= targets.length ? targets[asNumber - 1] : void 0;
+  return byIndex ?? targets.find((t) => t.id.toLowerCase() === trimmed.toLowerCase()) ?? null;
+}
+async function promptForTarget(targets, def, stdin, stderr, glyph) {
+  stderr.write(renderTargetLines(targets, def, glyph) + "\n");
+  const defIndex = targets.findIndex((t) => t.id === def.id);
   const rl = createInterface5({ input: stdin, output: stderr });
   try {
-    const answer = await new Promise(
-      (resolveP) => rl.question(tx(TUTORIAL_TEXTS.promptInput, { index: defaultIndex + 1 }), resolveP)
-    );
-    const trimmed = answer.trim();
-    if (trimmed === "") return targets[defaultIndex];
-    const asNumber = Number.parseInt(trimmed, 10);
-    if (!Number.isNaN(asNumber) && asNumber >= 1 && asNumber <= targets.length) {
-      return targets[asNumber - 1];
+    for (let attempt = 0; attempt < 5; attempt += 1) {
+      const answer = await new Promise(
+        (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"
+      );
     }
-    const byId = targets.find((t) => t.id.toLowerCase() === trimmed.toLowerCase());
-    return byId ?? null;
+    return null;
   } finally {
     rl.close();
   }
@@ -31073,4 +31110,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=ce13dce1-d18b-5abf-b6a8-1ef997ccaf99
+//# debugId=971924c5-3da8-5670-8c42-6f13b41acfa0

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]="f3e27769-f4cb-5526-a022-5ef018a37ef8")}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]="b1dadbaf-2a39-57c7-80df-bbba973403c5")}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.61.3",
+  version: "0.61.5",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -3851,4 +3851,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=f3e27769-f4cb-5526-a022-5ef018a37ef8
+//# debugId=b1dadbaf-2a39-57c7-80df-bbba973403c5

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]="efabc578-2328-5428-97bc-6c89a870170a")}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]="5077263a-bf07-58af-b37d-ea6ab8f9a27c")}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.61.3",
+  version: "0.61.5",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -3851,4 +3851,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=efabc578-2328-5428-97bc-6c89a870170a
+//# debugId=5077263a-bf07-58af-b37d-ea6ab8f9a27c