@skill-map/cli 0.68.0 → 0.69.0

package/dist/cli/tutorial/sm-tutorial/SKILL.md

@@ -44,7 +44,7 @@ prefix when a part spans several files: `settings-*` →
 > For the tester this is a single guided session, never a course
 > catalogue. Refer to a chapter by its tester-facing `section.chapter`
 > number plus its friendly title (`_core.md` §Numbering); never expose
-> the internal `order` index ("Part 4", off by one from the menu), a
+> the internal `order` index ("Part 3", off by one from the menu), a
 > raw "chapter id", or tour jargon ("the settings tour").
 
 ## Pre-flight (run once, silent on success)
@@ -214,9 +214,10 @@ for the data layout and the verb surface.
 
 - **Fixture sets** (laid by `fixtures.js lay <set>` / `seed <snap>`):
   `universal` (the two files above), `prologue` (the Part 0 demo),
-  `portfolio` (Part 1 boot + harness members), `harness` (the Part 2
-  additions), `master` (Part 4), `cli-external` (Part 5
-  reference-paths). The script resolves the `__PROVIDER__` token,
+  `portfolio` (Part 1 boot + harness members), `harness` (the connect
+  chapters, now folded into Part 1), `master` (Part 3 Extend),
+  `cli-external` (Part 4 reference-paths). The script resolves the
+  `__PROVIDER__` token,
   skips kinds the provider does not claim, and reports `nodeCount` +
   `skipped` for you to narrate.
 - **Footprints** (the on-disk reach of each fixture, including files a
@@ -277,7 +278,7 @@ the `__PROVIDER__` token and skip kinds the provider does not claim.
   parts use `preflight: seed`; `portfolio-init` is Part 1's flavour,
   handling the Part 0 to Part 1 transition.)
 
-- **`backstage-init`** (Part 4 `extend`): teaches plugins on its own
+- **`backstage-init`** (Part 3 `extend`): teaches plugins on its own
   **master fixture**. On entry, silently:
   1. Clear whatever prior fixture is present (each a no-op when absent),
      then drop the DB: `fixtures.js clear prologue --provider <provider>`,
@@ -285,10 +286,10 @@ the `__PROVIDER__` token and skip kinds the provider does not claim.
   2. `sm init --no-scan` (the pre-flight `.skillmapignore` stays).
   3. `fixtures.js lay master --provider <provider> --lang <lang>`.
 
-  On a Part 4 re-entry where the master fixture is already in place the
+  On a Part 3 re-entry where the master fixture is already in place the
   clears + lay are idempotent; just `sm scan`.
 
-- **`seed: prologue-built`** (Part 5 `cli`): reads the Part 0 demo
+- **`seed: prologue-built`** (Part 4 `cli`): reads the Part 0 demo
   fixture, NOT the portfolio. On entry:
   1. If the portfolio is present, clear it + drop the DB:
      `fixtures.js clear portfolio --provider <provider>`, `rm -rf .skill-map`.
@@ -301,15 +302,13 @@ the `__PROVIDER__` token and skip kinds the provider does not claim.
   3. `sm init` (single `.claude/` marker, no lens prompt), then `sm scan`.
      If `.skill-map/` already exists, skip the init and just `sm scan`.
 
-- **`seed`** (campaign parts `connect-harness`, `daily-loop`): builds
-  on the accumulating portfolio, but the tester may have jumped here.
-  Run `state.js status`; if every predecessor up the `prereq` chain is
-  `done`, the harness is already on disk, just `sm scan`. Otherwise
-  **fast-forward, silently**:
+- **`seed`** (campaign part `daily-loop`): builds on the accumulating
+  portfolio, but the tester may have jumped here. Run `state.js status`;
+  if every predecessor up the `prereq` chain is `done`, the harness is
+  already on disk, just `sm scan`. Otherwise **fast-forward, silently**:
   1. If the prologue ran first here, `fixtures.js clear prologue --provider <provider>`.
-  2. Seed: `fixtures.js seed <harness-built|harness-connected> --provider <provider> --lang <lang>`
-     (`harness-built` for `connect-harness`, `harness-connected` for
-     `daily-loop`).
+  2. Seed: `fixtures.js seed harness-connected --provider <provider> --lang <lang>`
+     (the wired harness that `daily-loop` builds on).
   3. Provision the lens: the seeded portfolio carries the scaffold
      marker (`.claude/` on the rich track, `.agents/` on the basic
      track), so a plain `sm init` resolves the matching lens with no

package/dist/cli/tutorial/sm-tutorial/fixtures-data/manifest.json

@@ -82,9 +82,6 @@
       "edits": ["todo-connectors"],
       "drop": ["notes/private-credentials.md"]
     },
-    "harness-built": {
-      "lay": ["portfolio"]
-    },
     "harness-connected": {
       "lay": ["portfolio", "harness"],
       "edits": ["agents-hub", "content-editor-style"]

package/dist/cli/tutorial/sm-tutorial/references/_core.md

@@ -20,7 +20,7 @@ Two numbering systems coexist; keep them apart:
 
 - **Internal (authoring only)**: the `order` field in `_manifest.yml`
   and the `# Part N` file headers, 0-based (Part 0 the prologue …
-  Part 5 the CLI deep-dive; `mcp` at Part 6 is parked / hidden). Use it
+  Part 3 the CLI deep-dive, Part 4 the Extend dev section; `mcp` at Part 5 is parked / hidden). Use it
   in `**Context**:` blocks and author
   notes; NEVER say it to the tester, it is off by one from what they
   see.
@@ -336,14 +336,23 @@ references all resolve on both), so the rich part bodies are written in the
   "open the agent file" point at the `.toml`; a chapter that has the tester
   read or tweak an agent works on the TOML frontmatter / `developer_instructions`.
 - **No `command` kind.** Where the claude book authors a `command` (the
-  `/publish` command, the reserved-name chapter's `init` command), Codex uses a
+  `/publish` command, the reserved-name chapter's `model` command), Codex uses a
   **skill** at `.agents/skills/<name>/SKILL.md`. The body is identical (same
   `/check-links` + `@content-editor` + deploy reference); only the kind and path
   change. `cat <set> --file … --provider codex` already returns the Codex skill
   body, so the create-the-file block stays a copy-paste. The reserved-name beat
   uses a skill named with a reserved verb (Codex inherits the open-standard
-  `COMMONS_RESERVED_NAMES`, e.g. `config`), exactly like the basic track's
+  `COMMONS_RESERVED_NAMES`, e.g. `model`), exactly like the basic track's
   `reserved` chapter, on a skill instead of a command.
+  **Apply every substitution silently.** Use the Codex path, kind and file
+  directly in the tester-facing prose, but never EXPLAIN the substitution or
+  compare it to the claude shape. The Codex tester only ever sees a `skill`
+  where the claude book has a command; never tell them "Codex has no `command`
+  kind", never say a node "is a command that shows as a skill", never reference
+  "the claude command". On Codex these nodes were always skills, there is
+  nothing to explain. (Same for the TOML-agent and path swaps above: point the
+  tester at the real `.toml` / `.agents/` file when they interact with it, just
+  do not narrate that it "would be" something else on claude.)
 - **Skills** live under `.agents/skills/<name>/SKILL.md` (the open layout Codex
   adopted), same as the basic family.
 - Everything else (the `@`/`/` syntax, the confidence numbers, the hub, the
@@ -444,7 +453,7 @@ promise or pre-announce the next part, the close and the menu own the
 transition. Sample (Claude variant, mirror the tester's language,
 apply the host rendering rule):
 
-> ✓ Listo, terminaste **El proyecto desde cero**. Levantaste un
+> ✓ Listo, terminaste **El harness desde cero**. Levantaste un
 > proyecto real, su handbook y el harness `.claude/` con sus primeros
 > nodos.
 >
@@ -484,7 +493,7 @@ fill the parts and durations from `_manifest.yml`):
 **1. El mapa en vivo** (~12 min)
 > El prólogo: corrés `sm`, abrís el browser y ves el mapa actualizarse en vivo mientras editás `.md`. Si es tu primera vez, empezá por acá.
 
-**2. El proyecto desde cero** (~8 min)
+**2. El harness desde cero** (~8 min)
 > Arrancás un proyecto real (un portfolio) y su harness `.claude/`.
 
 ¿Cuál?
@@ -503,7 +512,7 @@ the title stays plain):
 **1. El mapa en vivo** (~12 min)
 > ✓ Ya la hiciste.
 
-**2. El proyecto desde cero** (~8 min)
+**2. El harness desde cero** (~8 min)
 > Arrancás un proyecto real (un portfolio) y su harness `.claude/`.
 ```
 

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

@@ -29,7 +29,7 @@
         {
           "id": "connectors",
           "title": "The connectors light up",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "inspector",
@@ -39,17 +39,17 @@
         {
           "id": "edit-link",
           "title": "Edit a link, the topology changes",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "workspace",
           "title": "Navigate the workspace (files, search, isolate)",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "ignore",
           "title": "Silence a file via .skillmapignore",
-          "est_min": 2
+          "est_min": 1
         }
       ]
     },
@@ -82,7 +82,7 @@
         {
           "id": "connectors",
           "title": "Connect with references (markdown links)",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "inspector",
@@ -92,24 +92,24 @@
         {
           "id": "edit-link",
           "title": "Edit a link, the topology changes",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "workspace",
           "title": "Navigate the workspace (files, search, isolate)",
-          "est_min": 2
+          "est_min": 1
         },
         {
           "id": "ignore",
           "title": "Silence a file via .skillmapignore",
-          "est_min": 2
+          "est_min": 1
         }
       ]
     },
     {
       "id": "project-kickoff",
       "order": 1,
-      "title": "The project from zero",
+      "title": "The harness from zero",
       "status": "active",
       "preflight": "portfolio-init",
       "seed": null,
@@ -135,6 +135,26 @@
         {
           "id": "real-kinds",
           "title": "The real kinds in context",
+          "est_min": 1
+        },
+        {
+          "id": "check-links",
+          "title": "The check-links skill",
+          "est_min": 1
+        },
+        {
+          "id": "publish",
+          "title": "The /publish command invokes the skill",
+          "est_min": 2
+        },
+        {
+          "id": "links",
+          "title": "Mentions (@) and references between assets",
+          "est_min": 2
+        },
+        {
+          "id": "confidence",
+          "title": "Connector confidence (opacity = certainty)",
           "est_min": 2
         }
       ]
@@ -142,7 +162,7 @@
     {
       "id": "basic-kickoff",
       "order": 1,
-      "title": "The project from zero",
+      "title": "The harness from zero",
       "status": "active",
       "preflight": "portfolio-init",
       "seed": null,
@@ -169,100 +189,54 @@
           "id": "real-kinds",
           "title": "The kinds in context",
           "est_min": 2
-        }
-      ]
-    },
-    {
-      "id": "connect-harness",
-      "order": 2,
-      "title": "Connect the harness",
-      "status": "active",
-      "preflight": "seed",
-      "seed": "harness-built",
-      "prereq": "project-kickoff",
-      "pace": "auto-advance",
-      "track": "rich",
-      "chapters": [
-        {
-          "id": "check-links",
-          "title": "The check-links skill",
-          "est_min": 2
-        },
-        {
-          "id": "publish",
-          "title": "The /publish command invokes the skill",
-          "est_min": 3
-        },
-        {
-          "id": "links",
-          "title": "Mentions (@) and references between assets",
-          "est_min": 3
         },
-        {
-          "id": "confidence",
-          "title": "Connector confidence (opacity = certainty)",
-          "est_min": 2
-        }
-      ]
-    },
-    {
-      "id": "basic-connect",
-      "order": 2,
-      "title": "Connect the harness",
-      "status": "active",
-      "preflight": "seed",
-      "seed": "harness-built",
-      "prereq": "basic-kickoff",
-      "pace": "auto-advance",
-      "track": "basic",
-      "chapters": [
         {
           "id": "check-links",
           "title": "The link checker",
-          "est_min": 3
+          "est_min": 2
         },
         {
           "id": "publish",
           "title": "The publish skill references the harness",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "links",
           "title": "The handbook becomes the hub (references)",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "confidence",
           "title": "Connector confidence (opacity = certainty)",
-          "est_min": 3
+          "est_min": 2
         }
       ]
     },
     {
       "id": "daily-loop",
-      "order": 3,
+      "order": 2,
       "title": "The daily loop (add, improve, publish)",
       "status": "active",
       "preflight": "seed",
       "seed": "harness-connected",
-      "prereq": "connect-harness",
+      "prereq": "project-kickoff",
       "pace": "auto-advance",
       "track": "rich",
       "chapters": [
         {
           "id": "setup",
           "title": "Make it yours and bring it up",
-          "est_min": 5
+          "est_min": 4
         },
         {
           "id": "add-page",
           "title": "Add a page with your agent",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "broken-ref",
           "title": "A rename breaks a link",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "reserved",
@@ -272,7 +246,7 @@
         {
           "id": "publish",
           "title": "Ship it: run /publish for real",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "stability",
@@ -281,36 +255,36 @@
         },
         {
           "id": "golive",
-          "title": "Your portfolio, live next to the graph",
+          "title": "Your website, live next to the graph",
           "est_min": 3
         }
       ]
     },
     {
       "id": "basic-daily",
-      "order": 3,
+      "order": 2,
       "title": "The daily loop (add, improve, publish)",
       "status": "active",
       "preflight": "seed",
       "seed": "harness-connected",
-      "prereq": "basic-connect",
+      "prereq": "basic-kickoff",
       "pace": "auto-advance",
       "track": "basic",
       "chapters": [
         {
           "id": "setup",
           "title": "Make it yours and bring it up",
-          "est_min": 5
+          "est_min": 4
         },
         {
           "id": "add-page",
           "title": "Add a page with your skill",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "broken-ref",
           "title": "A rename breaks a link",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "reserved",
@@ -320,7 +294,7 @@
         {
           "id": "publish",
           "title": "Ship it: run the publish skill for real",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "stability",
@@ -329,7 +303,45 @@
         },
         {
           "id": "golive",
-          "title": "Your portfolio, live next to the graph",
+          "title": "Your website, live next to the graph",
+          "est_min": 3
+        }
+      ]
+    },
+    {
+      "id": "cli",
+      "order": 3,
+      "title": "The CLI for you and your agent",
+      "status": "active",
+      "preflight": "seed",
+      "seed": "prologue-built",
+      "prereq": "fundamentals",
+      "pace": "auto-advance",
+      "track": "both",
+      "chapters": [
+        {
+          "id": "browse",
+          "title": "list / show / check",
+          "est_min": 2
+        },
+        {
+          "id": "graph-export",
+          "title": "graph / export (query, formatters)",
+          "est_min": 2
+        },
+        {
+          "id": "issues",
+          "title": "Issues and broken refs (--analyzers, --json)",
+          "est_min": 2
+        },
+        {
+          "id": "annotations",
+          "title": "Annotations and the .sm consent prompt",
+          "est_min": 3
+        },
+        {
+          "id": "reference-paths",
+          "title": "Validate links to folders outside the scan scope",
           "est_min": 3
         }
       ]
@@ -337,7 +349,7 @@
     {
       "id": "extend",
       "order": 4,
-      "title": "Extend skill-map for the site",
+      "title": "Extend skill-map with plugins",
       "status": "active",
       "preflight": "backstage-init",
       "seed": null,
@@ -358,22 +370,22 @@
         {
           "id": "settings-3-lens",
           "title": "The active provider lens (`activeProvider`)",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "tour-1-intro",
           "title": "How plugins work",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "tour-2-kinds",
           "title": "The six extension kinds",
-          "est_min": 5
+          "est_min": 4
         },
         {
           "id": "tour-3-explore",
           "title": "Explore one extension up close",
-          "est_min": 4
+          "est_min": 3
         },
         {
           "id": "authoring-1-scaffold",
@@ -402,52 +414,14 @@
         }
       ]
     },
-    {
-      "id": "cli",
-      "order": 5,
-      "title": "The CLI in depth",
-      "status": "active",
-      "preflight": "seed",
-      "seed": "prologue-built",
-      "prereq": "fundamentals",
-      "pace": "auto-advance",
-      "track": "both",
-      "chapters": [
-        {
-          "id": "browse",
-          "title": "list / show / check",
-          "est_min": 3
-        },
-        {
-          "id": "graph-export",
-          "title": "graph / export (query, formatters)",
-          "est_min": 3
-        },
-        {
-          "id": "issues",
-          "title": "Issues and broken refs (--analyzers, --json)",
-          "est_min": 3
-        },
-        {
-          "id": "annotations",
-          "title": "Annotations and the .sm consent prompt",
-          "est_min": 3
-        },
-        {
-          "id": "reference-paths",
-          "title": "Validate links to folders outside the scan scope",
-          "est_min": 4
-        }
-      ]
-    },
     {
       "id": "mcp",
-      "order": 6,
+      "order": 5,
       "title": "MCP",
       "status": "planned",
       "preflight": "seed",
       "seed": "harness-connected",
-      "prereq": "connect-harness",
+      "prereq": "project-kickoff",
       "pace": "auto-advance",
       "track": "rich",
       "chapters": [