npm - @dev.sail.money/sailor - Versions diffs - 0.0.2-12 - Mend

@dev.sail.money/sailor 0.0.2-12

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 (319) hide show

package/packages/ui/dist/assets/zksync-DH7HK5U4-Dt4usFw6.js ADDED Viewed

@@ -0,0 +1 @@

+ var l="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20fill%3D%22none%22%20viewBox%3D%220%200%2028%2028%22%3E%3Cg%20transform%3D%22translate(0%2C0)%20scale(0.7)%22%3E%3Cg%20clip-path%3D%22url(%23a)%22%3E%3Cpath%20fill%3D%22%23000%22%20d%3D%22M0%200h40v40H0z%22%2F%3E%3Cpath%20fill%3D%22url(%23b)%22%20fill-opacity%3D%22.1%22%20d%3D%22M0%200h40v40H0z%22%2F%3E%3Cpath%20fill%3D%22%23fff%22%20fill-rule%3D%22evenodd%22%20d%3D%22m32.25%2020.005-6.954-6.922v5.066l-6.901%205.078h6.901v3.7l6.954-6.922ZM7.75%2020.005l6.954%206.923v-5.036l6.901-5.119h-6.901v-3.7L7.75%2020.004Z%22%20clip-rule%3D%22evenodd%22%2F%3E%3C%2Fg%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22b%22%20x1%3D%220%22%20x2%3D%2220%22%20y1%3D%220%22%20y2%3D%2240%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20stop-color%3D%22%23fff%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%23fff%22%20stop-opacity%3D%220%22%2F%3E%3C%2FlinearGradient%3E%3CclipPath%20id%3D%22a%22%3E%3Cpath%20fill%3D%22%23fff%22%20d%3D%22M0%200h40v40H0z%22%2F%3E%3C%2FclipPath%3E%3C%2Fdefs%3E%3C%2Fg%3E%3C%2Fsvg%3E";export{l as default};

package/packages/ui/dist/assets/zora-FYL5H3IO-iB4wygST.js ADDED Viewed

@@ -0,0 +1 @@

+ var o="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2228%22%20height%3D%2228%22%20fill%3D%22none%22%3E%3Cg%20clip-path%3D%22url(%23a)%22%3E%3Cpath%20fill%3D%22url(%23b)%22%20d%3D%22M.943%2013.754c0%207.586%205.944%2013.755%2013.252%2013.755%207.308%200%2013.252-6.17%2013.252-13.755C27.44%206.17%2021.497%200%2014.195%200%206.887%200%20.943%206.17.943%2013.754Z%22%2F%3E%3Cpath%20fill%3D%22url(%23c)%22%20d%3D%22M.943%2013.754c0%207.586%205.944%2013.755%2013.252%2013.755%207.308%200%2013.252-6.17%2013.252-13.755C27.44%206.17%2021.497%200%2014.195%200%206.887%200%20.943%206.17.943%2013.754Z%22%2F%3E%3Cpath%20fill%3D%22url(%23d)%22%20d%3D%22M.943%2013.754c0%207.586%205.944%2013.755%2013.252%2013.755%207.308%200%2013.252-6.17%2013.252-13.755C27.44%206.17%2021.497%200%2014.195%200%206.887%200%20.943%206.17.943%2013.754Z%22%2F%3E%3C%2Fg%3E%3Cdefs%3E%3CradialGradient%20id%3D%22b%22%20cx%3D%220%22%20cy%3D%220%22%20r%3D%221%22%20gradientTransform%3D%22matrix(19.9547%200%200%2020.7113%2018.16%206.7)%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%22.005%22%20stop-color%3D%22%23fff%22%2F%3E%3Cstop%20offset%3D%22.458%22%20stop-color%3D%22%23B7D8C8%22%2F%3E%3Cstop%20offset%3D%22.656%22%20stop-color%3D%22%236D9487%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%234B4C3C%22%2F%3E%3C%2FradialGradient%3E%3CradialGradient%20id%3D%22c%22%20cx%3D%220%22%20cy%3D%220%22%20r%3D%221%22%20gradientTransform%3D%22matrix(19.9547%200%200%2020.7113%2018.16%206.7)%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%22.005%22%20stop-color%3D%22%23fff%22%2F%3E%3Cstop%20offset%3D%22.458%22%20stop-color%3D%22%23B5B4C6%22%2F%3E%3Cstop%20offset%3D%22.656%22%20stop-color%3D%22%239B8F8F%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%234B4C3C%22%2F%3E%3C%2FradialGradient%3E%3CradialGradient%20id%3D%22d%22%20cx%3D%220%22%20cy%3D%220%22%20r%3D%221%22%20gradientTransform%3D%22matrix(19.9547%200%200%2020.7113%2018.16%206.7)%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%22.156%22%20stop-color%3D%22%23DCC8D0%22%2F%3E%3Cstop%20offset%3D%22.302%22%20stop-color%3D%22%2378C8CF%22%2F%3E%3Cstop%20offset%3D%22.427%22%20stop-color%3D%22%234D959E%22%2F%3E%3Cstop%20offset%3D%22.557%22%20stop-color%3D%22%23305EB9%22%2F%3E%3Cstop%20offset%3D%22.797%22%20stop-color%3D%22%23311F12%22%2F%3E%3Cstop%20offset%3D%22.906%22%20stop-color%3D%22%23684232%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%232D1C13%22%2F%3E%3C%2FradialGradient%3E%3CclipPath%20id%3D%22a%22%3E%3Cpath%20fill%3D%22%23fff%22%20d%3D%22M0%200h28v28H0z%22%2F%3E%3C%2FclipPath%3E%3C%2Fdefs%3E%3C%2Fsvg%3E";export{o as default};

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

@@ -0,0 +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>

package/scripts/check-docs.mjs ADDED Viewed

@@ -0,0 +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();

package/scripts/check-init.mjs ADDED Viewed

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * `sailor init` smoke test.
+ *
+ * Scaffolds a fresh project from the in-tree CLI bundle into a temp dir and
+ * asserts the scaffold succeeded. This exists to catch the class of regression
+ * the doc-drift gate structurally cannot — e.g. `packageRoot()` resolving to a
+ * `bin.sailor` package that ships no `templates/`, which made `init` fail from a
+ * monorepo checkout with "Template ... not found. Available: none".
+ *
+ * It runs the REAL built bundle from a monorepo layout, which is exactly the
+ * in-tree path that broke before. Pure Node + child_process; the only build
+ * dependency is the CLI bundle (`pnpm --filter sailor build`).
+ *
+ * Run:  node scripts/check-init.mjs   (CI builds the CLI first)
+ * Exit: 0 = scaffold OK, 1 = failure (prints what was missing).
+ */
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+const BUNDLE = path.join(ROOT, "packages/cli/dist/index.cjs");
+const PROJECT = "smoke-agent";
+function fail(msg) {
+  console.error(`✗ init smoke test FAILED: ${msg}`);
+  process.exit(1);
+}
+if (!fs.existsSync(BUNDLE)) {
+  fail(`CLI bundle not found at ${BUNDLE}.\n  Build it first: pnpm --filter sailor build`);
+}
+// Scaffold into a temp dir. `init` requires the destination to live inside the
+// process cwd, so we run the bundle with cwd set to a fresh temp root.
+const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "sailor-init-smoke-"));
+const dest = path.join(tmpRoot, PROJECT);
+try {
+  let stdout = "";
+  try {
+    stdout = execFileSync(process.execPath, [BUNDLE, "init", PROJECT], {
+      cwd: tmpRoot,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+  } catch (err) {
+    const out = `${err.stdout ?? ""}${err.stderr ?? ""}`.trim();
+    fail(`\`sailor init ${PROJECT}\` exited non-zero.\n  ${out || err.message}`);
+  }
+  // A successful fresh init prints the welcome + next steps, ending with the
+  // `Say: "start"` call-to-action. (Older builds printed "Done!".)
+  if (!/Say: "start"/.test(stdout)) {
+    fail(`init did not report success.\n  stdout: ${stdout.trim()}`);
+  }
+  // Assert the scaffold landed.
+  const mustExist = [
+    ".sail/config.json",
+    "package.json",
+    "foundry.toml",
+    "mandates",
+    "AGENTS.md",
+  ];
+  for (const rel of mustExist) {
+    if (!fs.existsSync(path.join(dest, rel))) fail(`expected scaffolded "${rel}" — not found`);
+  }
+  // config.json is valid JSON named after the project.
+  const config = JSON.parse(fs.readFileSync(path.join(dest, ".sail/config.json"), "utf-8"));
+  if (config.name !== PROJECT) fail(`config.json name is "${config.name}", expected "${PROJECT}"`);
+  // package.json is valid, renamed, and the workspace protocol was resolved away
+  // (a leftover "workspace:*" would make the scaffold un-installable for users).
+  const pkg = JSON.parse(fs.readFileSync(path.join(dest, "package.json"), "utf-8"));
+  if (pkg.name !== PROJECT) fail(`package.json name is "${pkg.name}", expected "${PROJECT}"`);
+  if (pkg.dependencies?.["@sail/sdk"] === "workspace:*") {
+    fail(`package.json still has "@sail/sdk": "workspace:*" — init did not resolve it`);
+  }
+  // Regression guard: an absolute path outside the cwd must be REJECTED, not
+  // silently nested into `<cwd>/<abs path>`. (Pre-fix, `path.join` swallowed the
+  // leading slash and scaffolded a bogus nested tree while printing success.)
+  const outside = path.join(os.tmpdir(), "sailor-init-outside", "agent");
+  let rejected = false;
+  try {
+    execFileSync(process.execPath, [BUNDLE, "init", outside], {
+      cwd: tmpRoot,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+  } catch {
+    rejected = true; // non-zero exit = correctly refused
+  }
+  if (!rejected) fail(`an absolute path outside cwd ("${outside}") was accepted — should be rejected`);
+  if (fs.existsSync(path.join(outside, ".sail/config.json"))) {
+    fail(`init scaffolded into an out-of-cwd absolute path "${outside}"`);
+  }
+  console.log(`✓ init smoke test passed — scaffolded ${PROJECT}/ from the in-tree bundle`);
+  console.log("✓ init guard passed — absolute path outside cwd rejected, not silently nested");
+} finally {
+  fs.rmSync(path.join(os.tmpdir(), "sailor-init-outside"), { recursive: true, force: true });
+  fs.rmSync(tmpRoot, { recursive: true, force: true });
+}