@skill-map/cli 0.72.0 → 0.73.0

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/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

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]="2c7d4927-4422-59d2-a37a-59fed3a2ec80")}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]="b28a958b-1d55-5195-b54e-2998b22e5818")}catch(e){}}();
 import { existsSync as existsSync34 } 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.72.0",
+  version: "0.73.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -1186,15 +1186,17 @@ var agentSkillsProvider = {
   // wins when no vendor marker is present. Provider-owned.
   detect: { markers: [".agents"], fallback: true },
   // Authoring target for `sm tutorial`: the open standard discovers skills
-  // under `.agents/skills/<name>/SKILL.md`. `aka` lists Antigravity, which
-  // shares this territory AND the BASIC tutorial track (skill + markdown,
-  // references), so a tester on Antigravity scaffolds here. OpenAI Codex
+  // under `.agents/skills/<name>/SKILL.md`. `aka` lists Antigravity and
+  // OpenCode, which share this territory AND the BASIC tutorial track (skill +
+  // markdown, references), so a tester on either scaffolds here. OpenCode is
+  // rich-capable (`agent` + `command` kinds) but is deliberately taught on the
+  // basic track via the shared open standard. OpenAI Codex
   // also reads `.agents/skills/`, but Codex is a RICH-track lens (it has the
   // `agent` kind, plus `$`-skill invocation and `@`-file references), so
   // advertising it under this basic row
   // would hand it the wrong book; Codex is surfaced once a Codex rich
   // scaffold target lands. `aka` is display-only, `--for` matches the id.
-  scaffold: { skillDir: ".agents/skills", aka: ["Google's Antigravity"] },
+  scaffold: { skillDir: ".agents/skills", aka: ["Google's Antigravity", "OpenCode"] },
   read: COMMONS_READ,
   kinds: COMMONS_KINDS,
   resolution: COMMONS_RESOLUTION,
@@ -4879,7 +4881,7 @@ var builtInPlugins = [
   },
   {
     id: "antigravity",
-    description: "Google Antigravity CLI platform integration (replaces the retired Gemini CLI). Classifies Antigravity workflows under `.agent/workflows/*.md` (its own kind) and adopts the open-standard `.agents/skills/` layout for skills; contributes the Antigravity runtime identity and reserved built-in names.",
+    description: "Google Antigravity CLI platform integration (replaces the retired Gemini CLI). Classifies workflows under `.agent/workflows/`, plus the open-standard `.agents/skills/` layout.",
     extensions: [
       antigravityProvider2
     ]
@@ -4894,7 +4896,7 @@ var builtInPlugins = [
   },
   {
     id: "opencode",
-    description: "OpenCode CLI platform integration (open-source, model-agnostic terminal coding agent). Classifies OpenCode agents under `.opencode/agent/*.md` and commands under `.opencode/commands/*.md` (its own kinds), and adopts the skill homes OpenCode reads (`.opencode/skills/`, `.claude/skills/`, `.agents/skills/`); contributes the OpenCode runtime identity and reserved built-in names.",
+    description: "OpenCode CLI platform integration (open-source, model-agnostic terminal coding agent). Classifies agents and commands under `.opencode/`, plus the skill homes it reads.",
     extensions: [
       opencodeProvider2
     ]
@@ -5847,6 +5849,7 @@ var defaults_default = {
   schemaVersion: 1,
   allowEditSmFiles: false,
   allowSidecarWriters: true,
+  tutorialReminderDismissed: false,
   tokenizer: "cl100k_base",
   roots: [],
   ignore: [],
@@ -5878,6 +5881,7 @@ var defaults_default = {
 // kernel/config/loader.ts
 var PROJECT_LOCAL_ONLY_KEYS = /* @__PURE__ */ new Set([
   "allowEditSmFiles",
+  "tutorialReminderDismissed",
   "scan.referencePaths",
   "pluginTrust.projectEnabled"
 ]);
@@ -27115,6 +27119,7 @@ var SERVER_TEXTS = {
   projectPrefsBodyEmpty: "Request body must contain `allowSidecarWriters`, a `scan` block with `referencePaths`, and/or a `pluginTrust` block with `projectEnabled`.",
   projectPrefsConfirmNotBoolean: "`confirm` must be a boolean.",
   projectPrefsSidecarWritersNotBoolean: "`allowSidecarWriters` must be a boolean.",
+  projectPrefsReminderNotBoolean: "`tutorialReminderDismissed` must be a boolean.",
   projectPrefsTrustNotObject: '`pluginTrust` must be an object (e.g. `{"pluginTrust": {"projectEnabled": true}}`).',
   projectPrefsTrustEnabledNotBoolean: "`pluginTrust.projectEnabled` must be a boolean.",
   // Server-stderr advisory after `PATCH /api/project-preferences`
@@ -29168,7 +29173,11 @@ function buildEnvelope3(deps) {
         cwd,
         default: false
       }) ?? false
-    }
+    },
+    tutorialReminderDismissed: readConfigValue("tutorialReminderDismissed", {
+      cwd,
+      default: false
+    }) ?? false
   };
 }
 async function applyPatch3(deps, body) {
@@ -29176,8 +29185,11 @@ async function applyPatch3(deps, body) {
   const policyChanged = typeof body.allowSidecarWriters === "boolean" && writeSidecarWritersPolicy(body.allowSidecarWriters, cwd);
   const scan = applyScanWrites(body, cwd);
   const trustChanged = applyTrustWrite(body, cwd);
+  const reminderChanged = applyTutorialReminderWrite(body, cwd);
   if (policyChanged || scan.mutated) await maybeRestartWatcher2(deps);
-  if (policyChanged || scan.attempted || trustChanged) deps.configService.reload();
+  if (policyChanged || scan.attempted || trustChanged || reminderChanged) {
+    deps.configService.reload();
+  }
 }
 function applyTrustWrite(body, cwd) {
   const next = body.pluginTrust?.projectEnabled;
@@ -29202,6 +29214,23 @@ function applyTrustWrite(body, cwd) {
   log.warn(tx(SERVER_TEXTS.projectPrefsTrustSet, { value: String(next) }));
   return true;
 }
+function applyTutorialReminderWrite(body, cwd) {
+  const next = body.tutorialReminderDismissed;
+  if (next === void 0) return false;
+  const before = readConfigValue("tutorialReminderDismissed", { cwd, default: false }) ?? false;
+  if (before === next) return false;
+  try {
+    writeConfigValue("tutorialReminderDismissed", next, { target: "project-local", cwd });
+  } catch (err) {
+    throw new HTTPException13(400, {
+      message: tx(SERVER_TEXTS.projectPrefsPersistFailed, {
+        key: "tutorialReminderDismissed",
+        message: formatErrorMessage(err)
+      })
+    });
+  }
+  return true;
+}
 function applyScanWrites(body, cwd) {
   const writes = collectWrites(body);
   if (writes.length === 0) return { attempted: false, mutated: false };
@@ -29355,11 +29384,13 @@ var PATCH_BODY_SCHEMA3 = {
   anyOf: [
     { required: ["allowSidecarWriters"] },
     { required: ["scan"] },
-    { required: ["pluginTrust"] }
+    { required: ["pluginTrust"] },
+    { required: ["tutorialReminderDismissed"] }
   ],
   properties: {
     confirm: { type: "boolean" },
     allowSidecarWriters: { type: "boolean" },
+    tutorialReminderDismissed: { type: "boolean" },
     scan: {
       type: "object",
       additionalProperties: false,
@@ -29394,6 +29425,7 @@ var parsePatchBody4 = makeBodyValidator(PATCH_BODY_SCHEMA3, {
     "/pluginTrust/projectEnabled:type:boolean": SERVER_TEXTS.projectPrefsTrustEnabledNotBoolean,
     "/confirm:type:boolean": SERVER_TEXTS.projectPrefsConfirmNotBoolean,
     "/allowSidecarWriters:type:boolean": SERVER_TEXTS.projectPrefsSidecarWritersNotBoolean,
+    "/tutorialReminderDismissed:type:boolean": SERVER_TEXTS.projectPrefsReminderNotBoolean,
     "/scan/referencePaths:type:array": tx(SERVER_TEXTS.projectPrefsListNotArray, { key: "scan.referencePaths" }),
     "/scan/referencePaths/*:type:string": tx(SERVER_TEXTS.projectPrefsListEntryNotString, { key: "scan.referencePaths" }),
     "/scan/referencePaths/*:pattern": SERVER_TEXTS.projectPrefsEntryHasComma
@@ -33358,4 +33390,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=2c7d4927-4422-59d2-a37a-59fed3a2ec80
+//# debugId=b28a958b-1d55-5195-b54e-2998b22e5818

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]="36d7449f-872d-54bb-bf4a-a57a0865bea9")}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]="302a8177-c654-50bd-828f-f658a568e578")}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.72.0",
+  version: "0.73.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -4261,4 +4261,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=36d7449f-872d-54bb-bf4a-a57a0865bea9
+//# debugId=302a8177-c654-50bd-828f-f658a568e578

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]="0cf98661-b345-5259-9225-d50ee3f837db")}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]="4dbe72ce-1485-5a29-adf0-bfb088a9bad4")}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.72.0",
+  version: "0.73.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -4261,4 +4261,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=0cf98661-b345-5259-9225-d50ee3f837db
+//# debugId=4dbe72ce-1485-5a29-adf0-bfb088a9bad4