@skill-map/cli 0.71.0 → 0.73.0

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

@@ -276,8 +276,8 @@ the `__PROVIDER__` token and skip kinds the provider does not claim.
      `rm -rf .skill-map`.
   2. Lay the portfolio boot (Express skeleton + handbook):
      `fixtures.js lay portfolio --only "AGENTS.md,server.js,package.json,public/index.html" --provider <provider> --lang <lang>`.
-     The harness members (`CLAUDE.md`, `content-editor`, the docs) are
-     laid by their own chapters.
+     The harness members (the entry pointer, `content-editor`, the docs)
+     are laid by their own chapters.
 
   The tester runs `sm init` in the first chapter. (Later campaign
   parts use `preflight: seed`; `portfolio-init` is Part 1's flavour,

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

@@ -19,6 +19,7 @@
     "portfolio": [
       "AGENTS.md",
       "CLAUDE.md",
+      "README.md",
       "server.js",
       "package.json",
       "AGENTS.sm",

package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/codex/shared/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

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

@@ -269,8 +269,15 @@ A skill-map project reads its files through exactly ONE active lens
 | `claude`       | `.claude/` (agents, commands, skills)     | agent, command, skill, markdown| `/` invokes, `@` mentions, refs| `.claude/`         | stable           | rich    |
 | `codex`        | `.codex/agents/*.toml` + `.agents/skills/`| agent (TOML), skill, markdown  | `$` invokes, `@` file-refs, refs| `.codex/`         | beta             | rich    |
 | `antigravity`  | `.agents/skills/` + `.agent/workflows/`   | skill, workflow, markdown      | `/` invokes, `@` file-refs, refs | `.agent/workflows/`| beta             | basic   |
+| `opencode`     | `.agents/skills/` (basic scope) + `.opencode/` | skill, markdown           | refs only                      | `.opencode/`       | beta             | basic   |
 | `agent-skills` | `.agents/skills/`                         | skill, markdown                | refs only                      | `.agents/`         | stable (default) | basic   |
 
+`opencode` is the one rich-capable lens on the basic track: the OpenCode product
+has `agent` + `command` kinds and `/`-invocation, but its tutorial teaches only
+the shared open-standard `.agents/skills/` skills + markdown references (its
+agents / commands are a deliberate out-of-scope simplification here; the real
+OpenCode lens still classifies them in a live project).
+
 `core/markdown` classifies every orphan `.md` under whatever lens is
 active; it is the universal base, never a selectable lens.
 
@@ -282,7 +289,7 @@ active; it is the universal base, never a selectable lens.
   (skills) and `@`-FILE references (Codex's `@` is a file picker, it cannot
   mention an agent by name, and `/` is a Codex built-in command, not a skill
   invocation). Both also use markdown references.
-- **basic** (`agent-skills`, `antigravity`): the open-standard family,
+- **basic** (`agent-skills`, `antigravity`, `opencode`): the open-standard family,
   built on `skill` + `markdown` and wired with **markdown references**
   (`[text](path)`), the one connection the Agent Skills standard
   documents. They diverge on what Antigravity bolts on top of the
@@ -311,14 +318,19 @@ built-in command, not a skill invocation).
      `provider = codex`, `track = rich`.
    - else a `.agent/workflows/` dir present → `provider = antigravity`,
      `track = basic`.
+   - else a `.opencode/` dir present → `provider = opencode`,
+     `<provider_dir> = .agents/skills`, `track = basic` (OpenCode joins the
+     open standard for the tutorial; its `.opencode/` marker rides on top of
+     the shared `.agents/skills/` skill home, like `.codex/` and
+     `.agent/workflows/` do).
    - else skill under `.claude/skills/sm-tutorial/` → `provider = claude`,
      `<provider_dir> = .claude`, `track = rich`.
    - else skill under `.agents/skills/sm-tutorial/` → `provider = agent-skills`,
      `<provider_dir> = .agents/skills`, `track = basic`.
-   **Lens precedence for codex / antigravity**: both adopt the open
+   **Lens precedence for codex / antigravity / opencode**: each adopts the open
    `.agents/skills/` layout, so the scaffold leaves the vendor marker
-   (`.codex/` or `.agent/workflows/`) alongside the `agent-skills` marker
-   (`.agents/`). The vendor marker WINS: `sm init` resolves `codex` /
+   (`.codex/`, `.agent/workflows/`, or `.opencode/`) alongside the
+   `agent-skills` marker (`.agents/`). The vendor marker WINS: `sm init` resolves `codex` /
    `antigravity` outright with no prompt (the `.agents/` open default only
    competes when no vendor marker is present). So the codex book runs
    exactly like claude, `sm init` then `sm`, with no lens prompt and no

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

@@ -289,7 +289,7 @@
         {
           "id": "reserved",
           "title": "A reserved name collides",
-          "est_min": 2
+          "est_min": 4
         },
         {
           "id": "publish",

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

@@ -209,7 +209,7 @@ parts:
       - id: setup       ; title: "Make it yours and bring it up" ; est_min: 4
       - id: add-page    ; title: "Add a page with your skill" ; est_min: 3
       - id: broken-ref  ; title: "A rename breaks a link" ; est_min: 3
-      - id: reserved    ; title: "A reserved name collides" ; est_min: 2
+      - id: reserved    ; title: "A reserved name collides" ; est_min: 4
       - id: publish     ; title: "Ship it: run the publish skill for real" ; est_min: 3
       - id: stability   ; title: "Set a node's stability (and the `.sm` sidecar)" ; est_min: 3
       - id: golive      ; title: "Your website, live next to the graph" ; est_min: 3

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

@@ -12,8 +12,11 @@ model; the per-chapter invocations live in each `part-*.md`.
 fixtures-data/
   manifest.json                 sets, footprints, edits, seeds, providerToken, langs
   sets/<set>/
-    shared/                     lang-invariant files (code: server.js, package.json, CLAUDE.md)
+    shared/                     lang-invariant files (code: server.js, package.json)
     en/  es/                    one tree per language (files with translatable prose)
+    providers/<provider>/       per-lens overlay (shared/ + en/ es/); e.g. the root
+                                entry pointer is CLAUDE.md on claude/codex,
+                                README.md on agent-skills/antigravity
   edits/<edit-id>/
     en/  es/                    append fragments (one file per fragment)
 ```

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

@@ -138,7 +138,7 @@ mv docs/DEPLOY.md docs/DEPLOYMENT.md
 Wait for confirmation. The harness MUST be clean again before Act C. Mark
 `broken-ref`: done. Auto-advance to `reserved`.
 
-## Chapter `reserved` - A reserved name collides (~2 min)
+## Chapter `reserved` - A reserved name collides (~4 min)
 
 **Preparation**: `Write` `<provider_dir>/model/SKILL.md`:
 ```markdown
@@ -169,7 +169,51 @@ The watcher picks up the new skill. Tell the tester:
 >
 > See the `model` node land clean, with no warning?
 
-Wait for confirmation. Mark `reserved`: done. Auto-advance to `publish`.
+Wait for confirmation.
+
+**Beat 2, prove the vendor exception by switching the lens (hands-on).** First
+`Write` `<provider_dir>/goal/SKILL.md` (a skill named after the Antigravity
+built-in verb `goal`):
+
+```markdown
+---
+name: goal
+description: |
+  Captures a goal for the site and tracks it to done.
+---
+
+# goal
+
+Notes a goal and checks it off when shipped.
+```
+
+The watcher adds it clean (on your open-standard lens `goal` is just a name). The
+agent does NOT touch settings (Inviolable rule #2); the tester drives the
+Settings UI. Tell the tester:
+
+> Now let's make that warning real by switching the lens. I added one more skill,
+> `goal`, an Antigravity built-in verb. On your open standard it landed clean,
+> same as `model`.
+>
+> Open **Settings** (the sliders icon, top right) and the **Project** tab. Find
+> **Active provider** and switch it from the open standard to **Google's
+> Antigravity**, then confirm. skill-map clears the old lens's scan, so the Map
+> goes quiet; click the **refresh** button (the sync icon in the topbar) to
+> re-scan under the new lens.
+>
+> Watch the Map: `goal` now wears a **`name-reserved`** warning (under Antigravity
+> `/goal` is a built-in command, so your skill would be shadowed), while `model`
+> stays clean (it is not one of Antigravity's verbs). Same files, different lens:
+> the lens decides what is reserved.
+>
+> Now switch **Active provider** back to the open standard, confirm, and click
+> refresh once more. The warning on `goal` clears, you are back on the neutral
+> standard that reserves nothing.
+>
+> Did the warning appear under Antigravity and clear when you switched back?
+
+Wait for confirmation. The lens MUST be back on the open standard before
+continuing. Mark `reserved`: done. Auto-advance to `publish`.
 
 ---
 

package/dist/cli/tutorial/sm-tutorial/references/part-basic-fundamentals.md

@@ -128,8 +128,8 @@ You edit `notes/todo.md` so it becomes the **hub** that points to the other
 nodes. On this lens there is exactly one connector: the **markdown reference**.
 A bullet links to another file with `[label](relative/path)`; skill-map reads
 that as a `references` link and draws an arrow when the target resolves to a
-real file. (The rich track also has `/`-invokes and `@`-mentions; the open
-standard connects by file links only, and that is all this lens emits.)
+real file. (Wiring everything with file links keeps the harness portable: a
+reference resolves the same way on any runtime that speaks the open standard.)
 
 Apply the hub bullets (content lives in `fixtures-data/`). The edit appends
 three bullets after the `# Pending` heading. Backstage (silent):

package/dist/cli/tutorial/sm-tutorial/references/part-basic-kickoff.md

@@ -60,13 +60,13 @@ Wait for confirmation. Mark `kickoff`: done.
 Tell the tester to create the file themselves (their project's file, Inviolable
 rule #2):
 
-> Create a file called `CLAUDE.md` at the project root with exactly this content:
+> Create a file called `README.md` at the project root with exactly this content:
 >
 > ```markdown
 > See the [handbook](AGENTS.md).
 > ```
 >
-> Save it. Watch the map: a new `CLAUDE.md` node appears with a `references`
+> Save it. Watch the map: a new `README.md` node appears with a `references`
 > connector pointing at `AGENTS.md`, solid at 1.00. The markdown link
 > `[handbook](AGENTS.md)` is a file pointer (the same kind of reference you met
 > in the prologue), and since the handbook is right there the link resolves with
@@ -117,7 +117,7 @@ Tell the tester:
 > front of you:
 >
 > - **skill**: `content-editor` (does work on your behalf).
-> - **markdown**: `AGENTS.md`, `CLAUDE.md`, the two docs (plain notes and
+> - **markdown**: `AGENTS.md`, `README.md`, the two docs (plain notes and
 >   manuals).
 >
 > Your lens authors exactly these two; Claude and Codex projects add `agent` and
@@ -188,10 +188,10 @@ Continue the tester message:
 > - `publish -> content-editor` (the `[content-editor](../content-editor/SKILL.md)` link)
 > - `publish -> docs/DEPLOY.md` (the `[deploy runbook](../../../docs/DEPLOY.md)` link)
 >
-> One node, three connectors, all references. On a vendor lens (claude/codex) the
-> first two would be a `/`-invoke and an `@`-mention; the open standard wires
-> everything with file links, and that is all this lens emits. The harness is
-> starting to look like a real graph.
+> One node, three connectors, all references. Wiring the whole harness with
+> markdown file links keeps it portable: each reference resolves the same way on
+> any runtime that speaks the open standard. The harness is starting to look
+> like a real graph.
 >
 > 💡 Tip: to tidy the layout, click **Re-arrange layout** in the map toolbar.
 >

package/dist/cli/tutorial/sm-tutorial/scripts/fixtures.js

@@ -78,7 +78,10 @@ function writeFileEnsuring(abs, content) {
  * tier, then the per-provider overlay (`providers/<provider>/{shared,<lang>}/`).
  * The overlay carries the skill-shaped variants of nodes a lens renders
  * differently (e.g. the `content-editor` agent becomes a skill on
- * agent-skills); claude declares no overlay because the base IS its shape.
+ * agent-skills). claude is mostly the base shape, but it still carries a tiny
+ * overlay for the entry-pointer file: the portfolio root pointer is `CLAUDE.md`
+ * (claude/codex overlays) vs `README.md` (agent-skills / antigravity), so it
+ * cannot live in the universal base `shared/` tier.
  */
 function laySet(manifest, set, o, only = null) {
   const { kinds } = pdirAndKinds(o);
@@ -297,5 +300,5 @@ function main() {
 }
 
 main();
-!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]="9e366749-efd9-5bc5-bba4-41147eabf625")}catch(e){}}();
-//# debugId=9e366749-efd9-5bc5-bba4-41147eabf625
+!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]="b7c7dad8-e6ce-5918-a25b-41b4e2d13a4c")}catch(e){}}();
+//# debugId=b7c7dad8-e6ce-5918-a25b-41b4e2d13a4c

package/dist/cli/tutorial/sm-tutorial/scripts/lib/paths.js

@@ -7,11 +7,13 @@
 export const PROVIDER_TOKEN = '__PROVIDER__';
 
 export function providerDir(provider) {
-  // agent-skills, Antigravity and Codex all keep their SKILLS under the
-  // open `.agents/skills/` layout. (Codex additionally has TOML agents under
-  // `.codex/agents/`, supplied by the codex overlay's literal paths, not this
-  // single base dir.)
-  return provider === 'agent-skills' || provider === 'antigravity' || provider === 'codex'
+  // agent-skills, Antigravity, Codex, and OpenCode all keep their SKILLS under
+  // the open `.agents/skills/` layout. (Codex additionally has TOML agents
+  // under `.codex/agents/`, supplied by the codex overlay's literal paths, not
+  // this single base dir. OpenCode is rich-capable but joins the open-standard
+  // BASIC track here: the tutorial teaches its shared `.agents/skills/` layer,
+  // not its own `.opencode/` agents/commands.)
+  return provider === 'agent-skills' || provider === 'antigravity' || provider === 'codex' || provider === 'opencode'
     ? '.agents/skills'
     : '.claude';
 }
@@ -25,6 +27,10 @@ export const PROVIDER_KINDS = {
   codex: new Set(['skill', 'markdown']),
   'agent-skills': new Set(['skill', 'markdown']),
   antigravity: new Set(['skill', 'markdown']),
+  // OpenCode is rich-capable (it has agent + command kinds in the product), but
+  // its tutorial runs on the BASIC track via the shared open standard, so only
+  // skill + markdown are taught here (its agents/commands are out of scope).
+  opencode: new Set(['skill', 'markdown']),
 };
 
 export function kindsFor(provider) {
@@ -36,7 +42,8 @@ export function kindsFor(provider) {
  * kind?" axis (see `_core.md` §Provider detection):
  *   - `rich`  (agent + skill + slash + `@`): `claude`, `codex`.
  *   - `basic` (skill + markdown, connected by markdown references): the
- *     open-standard family `agent-skills`, `antigravity`.
+ *     open-standard family `agent-skills`, `antigravity`, `opencode`
+ *     (OpenCode is rich-capable but joins basic via the shared open standard).
  * The book renders the track's parts; the same lens always resolves to
  * the same track, so a resumed session never re-derives it.
  */
@@ -46,13 +53,14 @@ export function trackFor(provider) {
 
 /**
  * The provider whose fixture overlays a given provider reuses. The
- * open-standard family (`agent-skills`, `antigravity`) shares one on-disk
- * shape (`.agents/skills/`, skill + markdown, connected by markdown
- * references), so `antigravity` reuses the canonical `agent-skills`
- * overlays rather than duplicating them. Every other provider keys its own.
+ * open-standard family (`agent-skills`, `antigravity`, `opencode`) shares one
+ * on-disk shape (`.agents/skills/`, skill + markdown, connected by markdown
+ * references), so `antigravity` and `opencode` reuse the canonical
+ * `agent-skills` overlays rather than duplicating them. Every other provider
+ * keys its own.
  */
 export function overlayKey(provider) {
-  return provider === 'antigravity' ? 'agent-skills' : provider;
+  return provider === 'antigravity' || provider === 'opencode' ? 'agent-skills' : provider;
 }
 
 /**
@@ -81,6 +89,7 @@ const KIND_DIRS = {
   codex: { skills: '.agents/skills' },
   'agent-skills': { skills: '.agents/skills' },
   antigravity: { skills: '.agents/skills' },
+  opencode: { skills: '.agents/skills' },
 };
 
 /**
@@ -135,5 +144,5 @@ export function nodeIdForTokenPath(tokenRelPath) {
   if (codexAgent) return codexAgent[1];
   return tokenRelPath;
 }
-!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]="54e1e331-4312-5c77-adc1-287ab9df7502")}catch(e){}}();
-//# debugId=54e1e331-4312-5c77-adc1-287ab9df7502
+!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]="d231a237-bec6-57bf-a67b-98b9edc47ec9")}catch(e){}}();
+//# debugId=d231a237-bec6-57bf-a67b-98b9edc47ec9