npm - @dev.sail.money/sailor - Versions diffs - 0.0.2 → 0.1.0-local - Mend

@dev.sail.money/sailor 0.0.2 → 0.1.0-local

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (211) hide show

package/packages/ui/dist/assets/{walletconnect-8pZBDvVI.js → walletconnect-CRKIuUHH.js} RENAMED Viewed

@@ -1,4 +1,4 @@
-import{F as l}from"./core-Ckx_cyuH.js";import"./index-Q2Yai4Fe.js";import"./events-CiKP71cK.js";import"./index.es-C78cE5SI.js";import"./fallback-Ofl6uSnB.js";const o=l`<svg fill="none" viewBox="0 0 96 67">
+import{F as l}from"./core-BFnStQd-.js";import"./index-BUhrHLpY.js";import"./events-Bz33Unzu.js";import"./index.es-DdkHhQAj.js";import"./fallback-DATyrQlb.js";const o=l`<svg fill="none" viewBox="0 0 96 67">
   <path
     fill="currentColor"
     d="M25.32 18.8a32.56 32.56 0 0 1 45.36 0l1.5 1.47c.63.62.63 1.61 0 2.22l-5.15 5.05c-.31.3-.82.3-1.14 0l-2.07-2.03a22.71 22.71 0 0 0-31.64 0l-2.22 2.18c-.31.3-.82.3-1.14 0l-5.15-5.05a1.55 1.55 0 0 1 0-2.22l1.65-1.62Zm56.02 10.44 4.59 4.5c.63.6.63 1.6 0 2.21l-20.7 20.26c-.62.61-1.63.61-2.26 0L48.28 41.83a.4.4 0 0 0-.56 0L33.03 56.21c-.63.61-1.64.61-2.27 0L10.07 35.95a1.55 1.55 0 0 1 0-2.22l4.59-4.5a1.63 1.63 0 0 1 2.27 0L31.6 43.63a.4.4 0 0 0 .57 0l14.69-14.38a1.63 1.63 0 0 1 2.26 0l14.69 14.38a.4.4 0 0 0 .57 0l14.68-14.38a1.63 1.63 0 0 1 2.27 0Z"

package/packages/ui/dist/assets/{warning-circle-ylLEE0Yp.js → warning-circle-DB2NnwlJ.js} RENAMED Viewed

@@ -1,4 +1,4 @@
-import{F as r}from"./core-Ckx_cyuH.js";import"./index-Q2Yai4Fe.js";import"./events-CiKP71cK.js";import"./index.es-C78cE5SI.js";import"./fallback-Ofl6uSnB.js";const a=r`<svg fill="none" viewBox="0 0 20 20">
+import{F as r}from"./core-BFnStQd-.js";import"./index-BUhrHLpY.js";import"./events-Bz33Unzu.js";import"./index.es-DdkHhQAj.js";import"./fallback-DATyrQlb.js";const a=r`<svg fill="none" viewBox="0 0 20 20">
   <path
     fill="currentColor"
     d="M11 6.67a1 1 0 1 0-2 0v2.66a1 1 0 0 0 2 0V6.67ZM10 14.5a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Z"

package/packages/ui/dist/assets/{x-C_TBsTMj.js → x-DT4RmwL5.js} RENAMED Viewed

@@ -1,4 +1,4 @@
-import{F as l}from"./core-Ckx_cyuH.js";import"./index-Q2Yai4Fe.js";import"./events-CiKP71cK.js";import"./index.es-C78cE5SI.js";import"./fallback-Ofl6uSnB.js";const a=l`<svg fill="none" viewBox="0 0 41 40">
+import{F as l}from"./core-BFnStQd-.js";import"./index-BUhrHLpY.js";import"./events-Bz33Unzu.js";import"./index.es-DdkHhQAj.js";import"./fallback-DATyrQlb.js";const a=l`<svg fill="none" viewBox="0 0 41 40">
   <g clip-path="url(#a)">
     <path fill="#000" d="M.8 0h40v40H.8z" />
     <path

package/packages/ui/dist/index.html CHANGED Viewed

@@ -1,14 +1,14 @@
-<!DOCTYPE html>
-<html lang="en" style="color-scheme: dark">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="theme-color" content="#040b16" />
-    <title>Sail - Unlocking Personalized Money</title>
-    <script type="module" crossorigin src="/assets/index-Q2Yai4Fe.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CKxgNxS9.css">
-  </head>
-  <body>
-    <div id="root"></div>
-  </body>
-</html>
+<!DOCTYPE html>
+<html lang="en" style="color-scheme: dark">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#040b16" />
+    <title>Sail - Unlocking Personalized Money</title>
+    <script type="module" crossorigin src="/assets/index-BUhrHLpY.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Cq02kQmy.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/scripts/check-docs.mjs CHANGED Viewed

@@ -1,262 +1,262 @@
-#!/usr/bin/env node
-/**
- * Doc-drift gate.
- *
- * The agent-facing docs (CLAUDE.md, AGENTS.md, AGENT_PLAYBOOK.md, the scaffolded
- * template, package READMEs) tell an LLM agent which `sailor` commands and which
- * `client.<ns>.<method>(...)` SDK calls to use. If a doc names a command or method
- * that no longer exists, the agent confidently does the wrong thing. This script
- * is the regression net: it derives the *real* surface from source and fails if a
- * doc references something that isn't there.
- *
- *   - CLI commands  ← parsed from packages/cli/src/index.ts (commander tree)
- *   - SDK methods   ← parsed from packages/sdk/src/client.ts (namespace classes)
- *
- * Only `sailor …` is validated, never the SailFramework `sail …` binary that some
- * docs reference. Only references inside `inline code` or ```fenced``` blocks are
- * checked, so prose ("the sailor CLI") never trips it.
- *
- * Run: `node scripts/check-docs.mjs` (or `pnpm docs:check`). Exit 1 on any miss.
- */
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import { dirname, join, relative } from "node:path";
-import { fileURLToPath } from "node:url";
-const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
-const rel = (p) => relative(ROOT, p);
-// ── 1. Derive the real CLI command surface ──────────────────────────────────
-/**
- * Parse the commander tree from index.ts into:
- *   leaves  — Set of full top-level invocations ("init", "doctor", "dispatch preview")
- *   groups  — Map<groupName, Set<subcommand>>  (e.g. "mandate" → {prepare, sign, …})
- */
-function parseCliSurface() {
-  const src = readFileSync(join(ROOT, "packages/cli/src/index.ts"), "utf-8");
-  const leaves = new Set();
-  const groups = new Map();
-  const varToGroup = new Map(); // commander variable name → group command name
-  // `const ui = program.command("ui")` — a group declared on a variable.
-  for (const m of src.matchAll(/const\s+(\w+)\s*=\s*program\s*\.command\(\s*"([^"]+)"/g)) {
-    const groupName = m[2].split(/\s+/)[0];
-    varToGroup.set(m[1], groupName);
-    if (!groups.has(groupName)) groups.set(groupName, new Set());
-  }
-  // `program.command("init [dir]")` — a top-level leaf (not assigned to a var).
-  for (const m of src.matchAll(/program\s*\.command\(\s*"([^"]+)"/g)) {
-    const name = m[1].split(/\s+/)[0];
-    // Multi-word leaf names (e.g. the "dispatch preview" stub) keep their full form too.
-    const full = m[1]
-      .replace(/\s*\[.*$/, "")
-      .replace(/\s*<.*$/, "")
-      .trim();
-    if (!groups.has(name)) {
-      leaves.add(name);
-      if (full.includes(" ")) leaves.add(full);
-    }
-  }
-  // `stub("setup", …)` / `stub("dispatch preview", …)` — registered top-level commands.
-  for (const m of src.matchAll(/\bstub\(\s*"([^"]+)"/g)) {
-    leaves.add(m[1]);
-    leaves.add(m[1].split(/\s+/)[0]);
-  }
-  // `ui.command("start")` / `mandate.command("prepare")` — subcommands of a group.
-  for (const m of src.matchAll(/(\w+)\s*\.command\(\s*"([^"]+)"/g)) {
-    const groupName = varToGroup.get(m[1]);
-    if (!groupName) continue; // not a known group variable (e.g. program.command handled above)
-    const sub = m[2].split(/\s+/)[0];
-    groups.get(groupName).add(sub);
-  }
-  return { leaves, groups };
-}
-// ── 2. Derive the real SDK surface ───────────────────────────────────────────
-/**
- * Parse client.ts into:
- *   namespaces  — Map<propertyName, Set<methodName>>  (account → {create, get, …})
- *   clientMethods — Set of direct SailorClient methods (capabilities, withSigner, …)
- */
-function parseSdkSurface() {
-  const src = readFileSync(join(ROOT, "packages/sdk/src/client.ts"), "utf-8");
-  const lines = src.split("\n");
-  // Map namespace *class* → set of method names, by slicing each class body.
-  const classMethods = new Map();
-  let current = null;
-  let depth = 0;
-  const reserved = new Set([
-    "if",
-    "for",
-    "while",
-    "switch",
-    "catch",
-    "return",
-    "super",
-    "constructor",
-    "function",
-    "await",
-    "typeof",
-    "new",
-  ]);
-  for (const line of lines) {
-    const classMatch = line.match(/^\s*(?:export\s+)?(?:abstract\s+)?class\s+(\w+)/);
-    if (classMatch) {
-      current = classMatch[1];
-      classMethods.set(current, new Set());
-      depth = 0;
-    }
-    if (current) {
-      // Method declarations live at class-body depth 1.
-      const methodMatch = line.match(
-        /^\s{2}(?:public\s+|private\s+|protected\s+)?(?:async\s+)?(?:get\s+)?(\w+)\s*[(<]/,
-      );
-      if (methodMatch && !reserved.has(methodMatch[1])) {
-        classMethods.get(current).add(methodMatch[1]);
-      }
-      depth += (line.match(/{/g)?.length ?? 0) - (line.match(/}/g)?.length ?? 0);
-      if (depth <= 0 && line.includes("}")) current = null;
-    }
-  }
-  // Map runtime property name → class: `this.account = new AccountNamespace(`
-  const namespaces = new Map();
-  for (const m of src.matchAll(/this\.(\w+)\s*=\s*new\s+(\w+)\s*\(/g)) {
-    const [, prop, cls] = m;
-    if (classMethods.has(cls)) namespaces.set(prop, classMethods.get(cls));
-  }
-  // `this.dispatch = dispatch;` — assigned from a local built earlier in the ctor.
-  for (const m of src.matchAll(/this\.(\w+)\s*=\s*(\w+);/g)) {
-    const [, prop, localVar] = m;
-    if (namespaces.has(prop)) continue;
-    // Resolve the local: `const dispatch = new DispatchNamespace(`
-    const localDecl = new RegExp(`(?:const|let)\\s+${localVar}\\s*=\\s*new\\s+(\\w+)\\s*\\(`);
-    const lm = src.match(localDecl);
-    if (lm && classMethods.has(lm[1])) namespaces.set(prop, classMethods.get(lm[1]));
-  }
-  // Direct methods on the SailorClient class itself.
-  const clientMethods = classMethods.get("SailorClient") ?? new Set();
-  return { namespaces, clientMethods };
-}
-// ── 3. Collect doc files + extract code references ───────────────────────────
-const DOC_GLOBS = [
-  "CLAUDE.md",
-  "AGENTS.md",
-  "AGENT_PLAYBOOK.md",
-  "README.md",
-  "docs",
-  "templates",
-  "packages/cli/README.md",
-  "packages/sdk/README.md",
-  "packages/chains/README.md",
-  "packages/create-app/README.md",
-];
-function collectDocs() {
-  const files = [];
-  const walk = (p) => {
-    const st = statSync(p, { throwIfNoEntry: false });
-    if (!st) return;
-    if (st.isDirectory()) {
-      for (const e of readdirSync(p)) {
-        if (e === "node_modules" || e === "dist" || e.startsWith(".git")) continue;
-        walk(join(p, e));
-      }
-    } else if (p.endsWith(".md")) {
-      files.push(p);
-    }
-  };
-  for (const g of DOC_GLOBS) walk(join(ROOT, g));
-  return [...new Set(files)];
-}
-/** Pull the text of every `inline` and ```fenced``` code region from markdown. */
-function codeRegions(md) {
-  const regions = [];
-  // Fenced blocks first, then strip them so inline matching doesn't double-count.
-  const rest = md.replace(/```[\s\S]*?```/g, (block) => {
-    regions.push(block.replace(/```/g, ""));
-    return "\n";
-  });
-  for (const m of rest.matchAll(/`([^`\n]+)`/g)) regions.push(m[1]);
-  return regions;
-}
-// ── 4. Validate ──────────────────────────────────────────────────────────────
-function main() {
-  const cli = parseCliSurface();
-  const sdk = parseSdkSurface();
-  const docs = collectDocs();
-  const errors = [];
-  for (const file of docs) {
-    const md = readFileSync(file, "utf-8");
-    for (const code of codeRegions(md)) {
-      for (const lineRaw of code.split("\n")) {
-        const line = lineRaw.trim();
-        // ── CLI: `sailor <word1> [<word2>]` ──────────────────────────────────
-        for (const m of line.matchAll(/\bsailor\s+([a-z][\w-]*)(?:\s+([a-z][\w-]*))?/g)) {
-          const [, w1, w2] = m;
-          const two = w2 ? `${w1} ${w2}` : null;
-          if (cli.leaves.has(w1) || (two && cli.leaves.has(two))) continue; // top-level leaf
-          if (cli.groups.has(w1)) {
-            // Group: if a subcommand word follows (and isn't a flag), it must exist.
-            if (!w2 || w2.startsWith("-")) continue; // bare group invocation, or a flag
-            if (cli.groups.get(w1).has(w2)) continue;
-            errors.push(
-              `${rel(file)}: \`sailor ${w1} ${w2}\` — "${w2}" is not a subcommand of "${w1}" (have: ${[...cli.groups.get(w1)].join(", ")})`,
-            );
-            continue;
-          }
-          errors.push(`${rel(file)}: \`sailor ${w1}\` — unknown command`);
-        }
-        // ── SDK: `client.<ns>[.<method>]` ────────────────────────────────────
-        for (const m of line.matchAll(/\bclient\.(\w+)(?:\.(\w+))?/g)) {
-          const [, ns, method] = m;
-          if (sdk.namespaces.has(ns)) {
-            if (!method) continue;
-            if (sdk.namespaces.get(ns).has(method)) continue;
-            errors.push(
-              `${rel(file)}: \`client.${ns}.${method}\` — "${method}" is not a method of the "${ns}" namespace (have: ${[...sdk.namespaces.get(ns)].join(", ")})`,
-            );
-            continue;
-          }
-          if (sdk.clientMethods.has(ns)) continue; // direct client method, e.g. capabilities/withSigner
-          errors.push(`${rel(file)}: \`client.${ns}\` — unknown SDK namespace or method`);
-        }
-      }
-    }
-  }
-  // ── Report ───────────────────────────────────────────────────────────────
-  const cliCount = cli.leaves.size + [...cli.groups.values()].reduce((n, s) => n + s.size, 0);
-  const sdkCount =
-    [...sdk.namespaces.values()].reduce((n, s) => n + s.size, 0) + sdk.clientMethods.size;
-  console.log(
-    `Doc-drift check: ${docs.length} docs vs ${cliCount} CLI commands, ${sdkCount} SDK methods`,
-  );
-  if (errors.length > 0) {
-    console.error(`\n✗ ${errors.length} stale reference(s):\n`);
-    for (const e of [...new Set(errors)].sort()) console.error(`  ${e}`);
-    console.error("\nFix the doc, or update the CLI/SDK so the referenced surface exists.");
-    process.exit(1);
-  }
-  console.log("✓ Every sailor command and client.* method referenced in docs exists.");
-}
-main();
+#!/usr/bin/env node
+/**
+ * Doc-drift gate.
+ *
+ * The agent-facing docs (CLAUDE.md, AGENTS.md, AGENT_PLAYBOOK.md, the scaffolded
+ * template, package READMEs) tell an LLM agent which `sailor` commands and which
+ * `client.<ns>.<method>(...)` SDK calls to use. If a doc names a command or method
+ * that no longer exists, the agent confidently does the wrong thing. This script
+ * is the regression net: it derives the *real* surface from source and fails if a
+ * doc references something that isn't there.
+ *
+ *   - CLI commands  ← parsed from packages/cli/src/index.ts (commander tree)
+ *   - SDK methods   ← parsed from packages/sdk/src/client.ts (namespace classes)
+ *
+ * Only `sailor …` is validated, never the SailFramework `sail …` binary that some
+ * docs reference. Only references inside `inline code` or ```fenced``` blocks are
+ * checked, so prose ("the sailor CLI") never trips it.
+ *
+ * Run: `node scripts/check-docs.mjs` (or `pnpm docs:check`). Exit 1 on any miss.
+ */
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+const rel = (p) => relative(ROOT, p);
+// ── 1. Derive the real CLI command surface ──────────────────────────────────
+/**
+ * Parse the commander tree from index.ts into:
+ *   leaves  — Set of full top-level invocations ("init", "doctor", "dispatch preview")
+ *   groups  — Map<groupName, Set<subcommand>>  (e.g. "mandate" → {prepare, sign, …})
+ */
+function parseCliSurface() {
+  const src = readFileSync(join(ROOT, "packages/cli/src/index.ts"), "utf-8");
+  const leaves = new Set();
+  const groups = new Map();
+  const varToGroup = new Map(); // commander variable name → group command name
+  // `const ui = program.command("ui")` — a group declared on a variable.
+  for (const m of src.matchAll(/const\s+(\w+)\s*=\s*program\s*\.command\(\s*"([^"]+)"/g)) {
+    const groupName = m[2].split(/\s+/)[0];
+    varToGroup.set(m[1], groupName);
+    if (!groups.has(groupName)) groups.set(groupName, new Set());
+  }
+  // `program.command("init [dir]")` — a top-level leaf (not assigned to a var).
+  for (const m of src.matchAll(/program\s*\.command\(\s*"([^"]+)"/g)) {
+    const name = m[1].split(/\s+/)[0];
+    // Multi-word leaf names (e.g. the "dispatch preview" stub) keep their full form too.
+    const full = m[1]
+      .replace(/\s*\[.*$/, "")
+      .replace(/\s*<.*$/, "")
+      .trim();
+    if (!groups.has(name)) {
+      leaves.add(name);
+      if (full.includes(" ")) leaves.add(full);
+    }
+  }
+  // `stub("setup", …)` / `stub("dispatch preview", …)` — registered top-level commands.
+  for (const m of src.matchAll(/\bstub\(\s*"([^"]+)"/g)) {
+    leaves.add(m[1]);
+    leaves.add(m[1].split(/\s+/)[0]);
+  }
+  // `ui.command("start")` / `mandate.command("prepare")` — subcommands of a group.
+  for (const m of src.matchAll(/(\w+)\s*\.command\(\s*"([^"]+)"/g)) {
+    const groupName = varToGroup.get(m[1]);
+    if (!groupName) continue; // not a known group variable (e.g. program.command handled above)
+    const sub = m[2].split(/\s+/)[0];
+    groups.get(groupName).add(sub);
+  }
+  return { leaves, groups };
+}
+// ── 2. Derive the real SDK surface ───────────────────────────────────────────
+/**
+ * Parse client.ts into:
+ *   namespaces  — Map<propertyName, Set<methodName>>  (account → {create, get, …})
+ *   clientMethods — Set of direct SailorClient methods (capabilities, withSigner, …)
+ */
+function parseSdkSurface() {
+  const src = readFileSync(join(ROOT, "packages/sdk/src/client.ts"), "utf-8");
+  const lines = src.split("\n");
+  // Map namespace *class* → set of method names, by slicing each class body.
+  const classMethods = new Map();
+  let current = null;
+  let depth = 0;
+  const reserved = new Set([
+    "if",
+    "for",
+    "while",
+    "switch",
+    "catch",
+    "return",
+    "super",
+    "constructor",
+    "function",
+    "await",
+    "typeof",
+    "new",
+  ]);
+  for (const line of lines) {
+    const classMatch = line.match(/^\s*(?:export\s+)?(?:abstract\s+)?class\s+(\w+)/);
+    if (classMatch) {
+      current = classMatch[1];
+      classMethods.set(current, new Set());
+      depth = 0;
+    }
+    if (current) {
+      // Method declarations live at class-body depth 1.
+      const methodMatch = line.match(
+        /^\s{2}(?:public\s+|private\s+|protected\s+)?(?:async\s+)?(?:get\s+)?(\w+)\s*[(<]/,
+      );
+      if (methodMatch && !reserved.has(methodMatch[1])) {
+        classMethods.get(current).add(methodMatch[1]);
+      }
+      depth += (line.match(/{/g)?.length ?? 0) - (line.match(/}/g)?.length ?? 0);
+      if (depth <= 0 && line.includes("}")) current = null;
+    }
+  }
+  // Map runtime property name → class: `this.account = new AccountNamespace(`
+  const namespaces = new Map();
+  for (const m of src.matchAll(/this\.(\w+)\s*=\s*new\s+(\w+)\s*\(/g)) {
+    const [, prop, cls] = m;
+    if (classMethods.has(cls)) namespaces.set(prop, classMethods.get(cls));
+  }
+  // `this.dispatch = dispatch;` — assigned from a local built earlier in the ctor.
+  for (const m of src.matchAll(/this\.(\w+)\s*=\s*(\w+);/g)) {
+    const [, prop, localVar] = m;
+    if (namespaces.has(prop)) continue;
+    // Resolve the local: `const dispatch = new DispatchNamespace(`
+    const localDecl = new RegExp(`(?:const|let)\\s+${localVar}\\s*=\\s*new\\s+(\\w+)\\s*\\(`);
+    const lm = src.match(localDecl);
+    if (lm && classMethods.has(lm[1])) namespaces.set(prop, classMethods.get(lm[1]));
+  }
+  // Direct methods on the SailorClient class itself.
+  const clientMethods = classMethods.get("SailorClient") ?? new Set();
+  return { namespaces, clientMethods };
+}
+// ── 3. Collect doc files + extract code references ───────────────────────────
+const DOC_GLOBS = [
+  "CLAUDE.md",
+  "AGENTS.md",
+  "AGENT_PLAYBOOK.md",
+  "README.md",
+  "docs",
+  "templates",
+  "packages/cli/README.md",
+  "packages/sdk/README.md",
+  "packages/chains/README.md",
+  "packages/create-app/README.md",
+];
+function collectDocs() {
+  const files = [];
+  const walk = (p) => {
+    const st = statSync(p, { throwIfNoEntry: false });
+    if (!st) return;
+    if (st.isDirectory()) {
+      for (const e of readdirSync(p)) {
+        if (e === "node_modules" || e === "dist" || e.startsWith(".git")) continue;
+        walk(join(p, e));
+      }
+    } else if (p.endsWith(".md")) {
+      files.push(p);
+    }
+  };
+  for (const g of DOC_GLOBS) walk(join(ROOT, g));
+  return [...new Set(files)];
+}
+/** Pull the text of every `inline` and ```fenced``` code region from markdown. */
+function codeRegions(md) {
+  const regions = [];
+  // Fenced blocks first, then strip them so inline matching doesn't double-count.
+  const rest = md.replace(/```[\s\S]*?```/g, (block) => {
+    regions.push(block.replace(/```/g, ""));
+    return "\n";
+  });
+  for (const m of rest.matchAll(/`([^`\n]+)`/g)) regions.push(m[1]);
+  return regions;
+}
+// ── 4. Validate ──────────────────────────────────────────────────────────────
+function main() {
+  const cli = parseCliSurface();
+  const sdk = parseSdkSurface();
+  const docs = collectDocs();
+  const errors = [];
+  for (const file of docs) {
+    const md = readFileSync(file, "utf-8");
+    for (const code of codeRegions(md)) {
+      for (const lineRaw of code.split("\n")) {
+        const line = lineRaw.trim();
+        // ── CLI: `sailor <word1> [<word2>]` ──────────────────────────────────
+        for (const m of line.matchAll(/\bsailor\s+([a-z][\w-]*)(?:\s+([a-z][\w-]*))?/g)) {
+          const [, w1, w2] = m;
+          const two = w2 ? `${w1} ${w2}` : null;
+          if (cli.leaves.has(w1) || (two && cli.leaves.has(two))) continue; // top-level leaf
+          if (cli.groups.has(w1)) {
+            // Group: if a subcommand word follows (and isn't a flag), it must exist.
+            if (!w2 || w2.startsWith("-")) continue; // bare group invocation, or a flag
+            if (cli.groups.get(w1).has(w2)) continue;
+            errors.push(
+              `${rel(file)}: \`sailor ${w1} ${w2}\` — "${w2}" is not a subcommand of "${w1}" (have: ${[...cli.groups.get(w1)].join(", ")})`,
+            );
+            continue;
+          }
+          errors.push(`${rel(file)}: \`sailor ${w1}\` — unknown command`);
+        }
+        // ── SDK: `client.<ns>[.<method>]` ────────────────────────────────────
+        for (const m of line.matchAll(/\bclient\.(\w+)(?:\.(\w+))?/g)) {
+          const [, ns, method] = m;
+          if (sdk.namespaces.has(ns)) {
+            if (!method) continue;
+            if (sdk.namespaces.get(ns).has(method)) continue;
+            errors.push(
+              `${rel(file)}: \`client.${ns}.${method}\` — "${method}" is not a method of the "${ns}" namespace (have: ${[...sdk.namespaces.get(ns)].join(", ")})`,
+            );
+            continue;
+          }
+          if (sdk.clientMethods.has(ns)) continue; // direct client method, e.g. capabilities/withSigner
+          errors.push(`${rel(file)}: \`client.${ns}\` — unknown SDK namespace or method`);
+        }
+      }
+    }
+  }
+  // ── Report ───────────────────────────────────────────────────────────────
+  const cliCount = cli.leaves.size + [...cli.groups.values()].reduce((n, s) => n + s.size, 0);
+  const sdkCount =
+    [...sdk.namespaces.values()].reduce((n, s) => n + s.size, 0) + sdk.clientMethods.size;
+  console.log(
+    `Doc-drift check: ${docs.length} docs vs ${cliCount} CLI commands, ${sdkCount} SDK methods`,
+  );
+  if (errors.length > 0) {
+    console.error(`\n✗ ${errors.length} stale reference(s):\n`);
+    for (const e of [...new Set(errors)].sort()) console.error(`  ${e}`);
+    console.error("\nFix the doc, or update the CLI/SDK so the referenced surface exists.");
+    process.exit(1);
+  }
+  console.log("✓ Every sailor command and client.* method referenced in docs exists.");
+}
+main();