settld 0.2.1 → 0.2.3

package/scripts/setup/onboard.mjs

@@ -13,10 +13,13 @@ import { bootstrapWalletProvider } from "../../src/core/wallet-provider-bootstra
 import { extractBootstrapMcpEnv, loadHostConfigHelper, runWizard } from "./wizard.mjs";
 import { SUPPORTED_HOSTS } from "./host-config.mjs";
 import { defaultSessionPath, readSavedSession } from "./session-store.mjs";
+import { runLogin } from "./login.mjs";
+import { runWalletCli } from "../wallet/cli.mjs";
 
 const WALLET_MODES = new Set(["managed", "byo", "none"]);
 const WALLET_PROVIDERS = new Set(["circle"]);
 const WALLET_BOOTSTRAP_MODES = new Set(["auto", "local", "remote"]);
+const SETUP_MODES = new Set(["quick", "advanced"]);
 const FORMAT_OPTIONS = new Set(["text", "json"]);
 const HOST_BINARY_HINTS = Object.freeze({
   codex: "codex",
@@ -38,6 +41,7 @@ const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const REPO_ROOT = path.resolve(SCRIPT_DIR, "..", "..");
 const SETTLD_BIN = path.join(REPO_ROOT, "bin", "settld.js");
 const PROFILE_FINGERPRINT_REGEX = /^[0-9a-f]{64}$/;
+const DEFAULT_PUBLIC_BASE_URL = "https://api.settld.work";
 const ANSI_RESET = "\u001b[0m";
 const ANSI_BOLD = "\u001b[1m";
 const ANSI_DIM = "\u001b[2m";
@@ -54,6 +58,10 @@ function usage() {
     "",
     "flags:",
     "  --non-interactive               Disable prompts; require explicit flags",
+    "  --quick                         Quick setup mode (default for interactive)",
+    "  --advanced                      Advanced setup mode (shows all prompts)",
+    "  --guided-next                   Run guided fund + first paid check after setup (default in quick mode)",
+    "  --skip-guided-next              Skip guided post-setup actions",
     `  --host <${SUPPORTED_HOSTS.join("|")}>      Host target (default: auto-detect, fallback openclaw)`,
     "  --base-url <url>                Settld API base URL (or SETTLD_BASE_URL)",
     "  --tenant-id <id>                Settld tenant ID (or SETTLD_TENANT_ID)",
@@ -109,6 +117,8 @@ function parseWalletEnvAssignment(raw) {
 function parseArgs(argv) {
   const out = {
     nonInteractive: false,
+    setupMode: null,
+    guidedNext: null,
     host: null,
     baseUrl: null,
     tenantId: null,
@@ -149,6 +159,22 @@ function parseArgs(argv) {
       out.nonInteractive = true;
       continue;
     }
+    if (arg === "--quick") {
+      out.setupMode = "quick";
+      continue;
+    }
+    if (arg === "--advanced") {
+      out.setupMode = "advanced";
+      continue;
+    }
+    if (arg === "--guided-next") {
+      out.guidedNext = true;
+      continue;
+    }
+    if (arg === "--skip-guided-next") {
+      out.guidedNext = false;
+      continue;
+    }
     if (arg === "--skip-profile-apply") {
       out.skipProfileApply = true;
       continue;
@@ -310,6 +336,9 @@ function parseArgs(argv) {
   if (out.host && !SUPPORTED_HOSTS.includes(out.host)) {
     throw new Error(`--host must be one of: ${SUPPORTED_HOSTS.join(", ")}`);
   }
+  if (out.setupMode && !SETUP_MODES.has(out.setupMode)) {
+    throw new Error("--quick or --advanced are the supported setup modes");
+  }
   if (!WALLET_MODES.has(out.walletMode)) throw new Error("--wallet-mode must be managed|byo|none");
   if (!WALLET_PROVIDERS.has(out.walletProvider)) throw new Error(`--wallet-provider must be one of: ${[...WALLET_PROVIDERS].join(", ")}`);
   if (!WALLET_BOOTSTRAP_MODES.has(out.walletBootstrap)) throw new Error("--wallet-bootstrap must be auto|local|remote");
@@ -865,6 +894,144 @@ function buildHostNextSteps({ host, installedHosts }) {
   return steps;
 }
 
+function runMcpPaidCallProbe({ env, timeoutMs = 45_000 } = {}) {
+  const args = [
+    path.join("scripts", "mcp", "probe.mjs"),
+    "--call",
+    "settld.weather_current_paid",
+    JSON.stringify({ city: "Chicago", unit: "f" }),
+    "--timeout-ms",
+    String(timeoutMs)
+  ];
+  const result = spawnSync(process.execPath, args, {
+    cwd: REPO_ROOT,
+    env: { ...process.env, ...(env ?? {}) },
+    encoding: "utf8",
+    timeout: timeoutMs + 5000,
+    maxBuffer: 4 * 1024 * 1024,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  const stdoutText = String(result.stdout ?? "");
+  const stderrText = String(result.stderr ?? "");
+  const sawToolError = /"isError"\s*:\s*true/.test(stdoutText);
+  const sawToolSuccess = /"isError"\s*:\s*false/.test(stdoutText);
+  const ok = Number(result.status) === 0 && sawToolSuccess && !sawToolError;
+  return {
+    ok,
+    exitCode: typeof result.status === "number" ? result.status : 1,
+    stdout: stdoutText,
+    stderr: stderrText
+  };
+}
+
+async function runGuidedQuickFlow({
+  enabled = false,
+  walletMode = "none",
+  normalizedBaseUrl,
+  tenantId,
+  sessionFile,
+  sessionCookie = "",
+  mergedEnv = {},
+  runtimeEnv = process.env,
+  stdin = process.stdin,
+  stdout = process.stdout,
+  runWalletCliImpl = runWalletCli
+} = {}) {
+  const summary = {
+    enabled: Boolean(enabled),
+    ran: false,
+    walletFund: null,
+    walletBalanceWatch: null,
+    firstPaidCall: null,
+    warnings: []
+  };
+  if (!summary.enabled) return summary;
+  if (!stdin?.isTTY || !stdout?.isTTY) {
+    summary.warnings.push("guided quick flow skipped (non-interactive terminal)");
+    return summary;
+  }
+
+  const actionEnv = {
+    ...runtimeEnv,
+    ...mergedEnv,
+    SETTLD_BASE_URL: normalizedBaseUrl,
+    SETTLD_TENANT_ID: tenantId,
+    ...(sessionCookie ? { SETTLD_SESSION_COOKIE: sessionCookie } : {})
+  };
+  summary.ran = true;
+
+  if (walletMode !== "none") {
+    try {
+      const fundResult = await runWalletCliImpl({
+        argv: ["fund", "--open", "--base-url", normalizedBaseUrl, "--tenant-id", tenantId, "--session-file", sessionFile, "--format", "json"],
+        env: actionEnv,
+        stdin,
+        stdout
+      });
+      summary.walletFund = {
+        ok: true,
+        method: String(fundResult?.method ?? "").trim() || null
+      };
+    } catch (err) {
+      summary.walletFund = {
+        ok: false,
+        error: err?.message ?? String(err ?? "")
+      };
+      summary.warnings.push("wallet funding did not complete during guided flow");
+    }
+
+    try {
+      const watchResult = await runWalletCliImpl({
+        argv: [
+          "balance",
+          "--watch",
+          "--min-usdc",
+          "1",
+          "--timeout-seconds",
+          "300",
+          "--interval-seconds",
+          "5",
+          "--base-url",
+          normalizedBaseUrl,
+          "--tenant-id",
+          tenantId,
+          "--session-file",
+          sessionFile,
+          "--format",
+          "json"
+        ],
+        env: actionEnv,
+        stdin,
+        stdout
+      });
+      summary.walletBalanceWatch = {
+        ok: Boolean(watchResult?.ok),
+        satisfied: Boolean(watchResult?.watch?.satisfied)
+      };
+    } catch (err) {
+      summary.walletBalanceWatch = {
+        ok: false,
+        error: err?.message ?? String(err ?? "")
+      };
+      summary.warnings.push("wallet balance watch did not reach target within timeout");
+    }
+  }
+
+  const paidProbe = runMcpPaidCallProbe({ env: actionEnv });
+  if (paidProbe.ok) {
+    summary.firstPaidCall = { ok: true };
+  } else {
+    summary.firstPaidCall = {
+      ok: false,
+      exitCode: paidProbe.exitCode,
+      error: paidProbe.stderr || "paid call returned tool error"
+    };
+    summary.warnings.push("first paid call probe failed");
+  }
+
+  return summary;
+}
+
 function resolveByoWalletEnv({ walletProvider, walletEnvRows, runtimeEnv }) {
   const env = {};
   for (const row of walletEnvRows ?? []) env[row.key] = row.value;
@@ -1028,16 +1195,21 @@ async function resolveRuntimeConfig({
   runtimeEnv,
   stdin = process.stdin,
   stdout = process.stdout,
-  detectInstalledHostsImpl = detectInstalledHosts
+  detectInstalledHostsImpl = detectInstalledHosts,
+  fetchImpl = fetch,
+  runLoginImpl = runLogin,
+  readSavedSessionImpl = readSavedSession
 }) {
   const sessionFile = String(args.sessionFile ?? runtimeEnv.SETTLD_SESSION_FILE ?? defaultSessionPath()).trim();
-  const savedSession = await readSavedSession({ sessionPath: sessionFile });
+  const savedSession = await readSavedSessionImpl({ sessionPath: sessionFile });
   const installedHosts = detectInstalledHostsImpl();
   const defaultHost = selectDefaultHost({
     explicitHost: args.host ? String(args.host).toLowerCase() : "",
     installedHosts
   });
   const out = {
+    setupMode: args.setupMode ?? "quick",
+    guidedNext: args.guidedNext,
     host: args.host ?? defaultHost,
     walletMode: args.walletMode,
     baseUrl: String(args.baseUrl ?? runtimeEnv.SETTLD_BASE_URL ?? "").trim(),
@@ -1071,6 +1243,9 @@ async function resolveRuntimeConfig({
   }
 
   if (args.nonInteractive) {
+    if (!out.setupMode) out.setupMode = "quick";
+    if (!SETUP_MODES.has(out.setupMode)) throw new Error("--quick or --advanced are the supported setup modes");
+    if (out.guidedNext === null || out.guidedNext === undefined) out.guidedNext = false;
     if (!SUPPORTED_HOSTS.includes(out.host)) throw new Error(`--host must be one of: ${SUPPORTED_HOSTS.join(", ")}`);
     if (!out.baseUrl) throw new Error("--base-url is required");
     if (!out.tenantId) throw new Error("--tenant-id is required");
@@ -1105,6 +1280,24 @@ async function resolveRuntimeConfig({
     }
     stdout.write("\n");
 
+    if (!out.setupMode || !SETUP_MODES.has(out.setupMode)) {
+      out.setupMode = "quick";
+    }
+    out.setupMode = await promptSelect(
+      rl,
+      stdin,
+      stdout,
+      "Setup mode",
+      [
+        { value: "quick", label: "quick", hint: "Recommended: minimal prompts and guided next steps" },
+        { value: "advanced", label: "advanced", hint: "Full control over all setup options" }
+      ],
+      { defaultValue: out.setupMode, color }
+    );
+    if (out.guidedNext === null || out.guidedNext === undefined) {
+      out.guidedNext = out.setupMode === "quick";
+    }
+
     const hostPromptDefault = out.host && SUPPORTED_HOSTS.includes(out.host) ? out.host : defaultHost;
     const hostOptions = SUPPORTED_HOSTS.map((host) => ({
       value: host,
@@ -1133,68 +1326,100 @@ async function resolveRuntimeConfig({
       { defaultValue: out.walletMode, color }
     );
 
-    if (!out.baseUrl) {
-      out.baseUrl = await promptLine(rl, "Settld base URL", { defaultValue: "https://api.settld.work" });
-    }
-    if (!out.tenantId) {
-      out.tenantId = await promptLine(rl, "Tenant ID", { defaultValue: "tenant_default" });
-    }
+    if (!out.baseUrl) out.baseUrl = DEFAULT_PUBLIC_BASE_URL;
     if (!out.settldApiKey) {
-      const canUseSavedSession =
-        Boolean(out.sessionCookie) &&
-        (!savedSession ||
-          (normalizeHttpUrl(out.baseUrl) === normalizeHttpUrl(savedSession?.baseUrl) &&
-            String(out.tenantId ?? "").trim() === String(savedSession?.tenantId ?? "").trim()));
-      const keyOptions = [];
-      if (canUseSavedSession) {
-        keyOptions.push({
-          value: "session",
-          label: "Use saved login session",
-          hint: `Reuse ${out.sessionFile} to mint runtime key`
-        });
-      }
-      keyOptions.push(
-        { value: "bootstrap", label: "Generate during setup", hint: "Use onboarding bootstrap API key" },
-        { value: "manual", label: "Paste existing key", hint: "Use an existing tenant API key" }
-      );
-      const keyMode = await promptSelect(
-        rl,
-        stdin,
-        stdout,
-        "How should setup get your Settld API key?",
-        keyOptions,
-        { defaultValue: canUseSavedSession ? "session" : "bootstrap", color }
-      );
-      if (keyMode === "bootstrap") {
-        if (!out.bootstrapApiKey) {
-          out.bootstrapApiKey = await promptSecretLine(rl, mutableOutput, stdout, "Onboarding bootstrap API key");
+      while (!out.settldApiKey) {
+        const canUseSavedSession =
+          Boolean(out.sessionCookie) &&
+          (!savedSession ||
+            (normalizeHttpUrl(out.baseUrl) === normalizeHttpUrl(savedSession?.baseUrl) &&
+              (!out.tenantId || String(out.tenantId ?? "").trim() === String(savedSession?.tenantId ?? "").trim())));
+        const keyOptions = [];
+        if (canUseSavedSession) {
+          keyOptions.push({
+            value: "session",
+            label: "Use saved login session",
+            hint: `Reuse ${out.sessionFile} to mint runtime key`
+          });
+        } else {
+          keyOptions.push({
+            value: "login",
+            label: "Login / create tenant (recommended)",
+            hint: "OTP sign-in; no API key required"
+          });
+        }
+        keyOptions.push(
+          { value: "bootstrap", label: "Generate during setup", hint: "Use onboarding bootstrap API key" },
+          { value: "manual", label: "Paste existing key", hint: "Use an existing tenant API key" }
+        );
+        const keyMode = await promptSelect(
+          rl,
+          stdin,
+          stdout,
+          "How should setup get your Settld API key?",
+          keyOptions,
+          { defaultValue: canUseSavedSession ? "session" : "login", color }
+        );
+        if (keyMode === "login") {
+          await runLoginImpl({
+            argv: ["--base-url", out.baseUrl, "--session-file", out.sessionFile],
+            stdin,
+            stdout,
+            fetchImpl
+          });
+          const refreshedSession = await readSavedSessionImpl({ sessionPath: out.sessionFile });
+          if (!refreshedSession) throw new Error("login did not produce a saved session");
+          out.baseUrl = String(refreshedSession.baseUrl ?? out.baseUrl).trim() || out.baseUrl;
+          out.tenantId = String(refreshedSession.tenantId ?? out.tenantId).trim();
+          out.sessionCookie = String(refreshedSession.cookie ?? out.sessionCookie).trim();
+          if (savedSession) {
+            savedSession.baseUrl = refreshedSession.baseUrl;
+            savedSession.tenantId = refreshedSession.tenantId;
+            savedSession.cookie = refreshedSession.cookie;
+          }
+          continue;
         }
-        if (!out.bootstrapKeyId) {
-          out.bootstrapKeyId = await promptLine(rl, "Generated key ID (optional)", { required: false });
+        if (keyMode === "bootstrap") {
+          if (!out.bootstrapApiKey) {
+            out.bootstrapApiKey = await promptSecretLine(rl, mutableOutput, stdout, "Onboarding bootstrap API key");
+          }
+          if (!out.bootstrapKeyId) {
+            out.bootstrapKeyId = await promptLine(rl, "Generated key ID (optional)", { required: false });
+          }
+          if (!out.bootstrapScopes) {
+            out.bootstrapScopes = await promptLine(rl, "Generated key scopes CSV (optional)", { required: false });
+          }
+          break;
         }
-        if (!out.bootstrapScopes) {
-          out.bootstrapScopes = await promptLine(rl, "Generated key scopes CSV (optional)", { required: false });
+        if (keyMode === "manual") {
+          out.settldApiKey = await promptSecretLine(rl, mutableOutput, stdout, "Settld API key");
+          break;
         }
-      } else if (keyMode === "manual") {
-        out.settldApiKey = await promptSecretLine(rl, mutableOutput, stdout, "Settld API key");
-      } else {
         out.bootstrapApiKey = "";
+        break;
       }
     }
+    if (!out.tenantId) {
+      out.tenantId = await promptLine(rl, "Tenant ID", { defaultValue: "tenant_default" });
+    }
 
     if (out.walletMode === "managed") {
-      out.walletBootstrap = await promptSelect(
-        rl,
-        stdin,
-        stdout,
-        "Managed wallet bootstrap",
-        [
-          { value: "auto", label: "auto", hint: "Use local Circle key when present, else remote bootstrap" },
-          { value: "local", label: "local", hint: "Always use local Circle API key flow" },
-          { value: "remote", label: "remote", hint: "Always use tenant onboarding endpoint" }
-        ],
-        { defaultValue: out.walletBootstrap || "auto", color }
-      );
+      if (out.setupMode === "quick") {
+        out.walletBootstrap = out.walletBootstrap || "auto";
+      } else {
+        out.walletBootstrap = await promptSelect(
+          rl,
+          stdin,
+          stdout,
+          "Managed wallet bootstrap",
+          [
+            { value: "auto", label: "auto", hint: "Use local Circle key when present, else remote bootstrap" },
+            { value: "local", label: "local", hint: "Always use local Circle API key flow" },
+            { value: "remote", label: "remote", hint: "Always use tenant onboarding endpoint" }
+          ],
+          { defaultValue: out.walletBootstrap || "auto", color }
+        );
+      }
       if (out.walletBootstrap === "local" && !out.circleApiKey) {
         out.circleApiKey = await promptSecretLine(rl, mutableOutput, stdout, "Circle API key");
       }
@@ -1220,6 +1445,9 @@ async function resolveRuntimeConfig({
       out.smoke = false;
       out.skipProfileApply = true;
       out.dryRun = true;
+      out.guidedNext = false;
+    } else if (out.setupMode === "quick") {
+      out.profileId = out.profileId || "engineering-spend";
     } else {
       out.preflight = await promptBooleanChoice(
         rl,
@@ -1296,7 +1524,10 @@ export async function runOnboard({
   requestRuntimeBootstrapMcpEnvImpl = requestRuntimeBootstrapMcpEnv,
   requestRemoteWalletBootstrapImpl = requestRemoteWalletBootstrap,
   runPreflightChecksImpl = runPreflightChecks,
-  detectInstalledHostsImpl = detectInstalledHosts
+  detectInstalledHostsImpl = detectInstalledHosts,
+  runLoginImpl = runLogin,
+  readSavedSessionImpl = readSavedSession,
+  runWalletCliImpl = runWalletCli
 } = {}) {
   const args = parseArgs(argv);
   if (args.help) {
@@ -1305,7 +1536,7 @@ export async function runOnboard({
   }
 
   const showSteps = args.format !== "json";
-  const totalSteps = args.preflightOnly ? 4 : 5;
+  const totalSteps = args.preflightOnly ? 4 : 6;
   let step = 1;
 
   if (showSteps) printStep(stdout, step, totalSteps, "Resolve setup configuration");
@@ -1314,7 +1545,10 @@ export async function runOnboard({
     runtimeEnv,
     stdin,
     stdout,
-    detectInstalledHostsImpl
+    detectInstalledHostsImpl,
+    fetchImpl,
+    runLoginImpl,
+    readSavedSessionImpl
   });
   step += 1;
   const normalizedBaseUrl = normalizeHttpUrl(mustString(config.baseUrl, "SETTLD_BASE_URL / --base-url"));
@@ -1453,6 +1687,12 @@ export async function runOnboard({
       lines.push(`Settld: ${normalizedBaseUrl} (tenant=${tenantId})`);
       lines.push(`Wallet mode: ${config.walletMode}`);
       lines.push(`Wallet bootstrap mode: ${walletBootstrapMode}`);
+      if (config.walletMode !== "none") {
+        lines.push("Wallet next steps:");
+        lines.push("- settld wallet status");
+        lines.push("- settld wallet fund --method transfer");
+        lines.push("- settld wallet balance --watch --min-usdc 1");
+      }
       if (args.outEnv) lines.push(`Wrote env file: ${args.outEnv}`);
       if (args.reportPath) lines.push(`Wrote report: ${args.reportPath}`);
       lines.push("");
@@ -1506,9 +1746,27 @@ export async function runOnboard({
     await fs.writeFile(args.outEnv, toEnvFileText(mergedEnv), "utf8");
   }
 
+  if (showSteps) printStep(stdout, step, totalSteps, "Guided next steps");
+  const guided = await runGuidedQuickFlow({
+    enabled: Boolean(config.setupMode === "quick" && config.guidedNext),
+    walletMode: config.walletMode,
+    normalizedBaseUrl,
+    tenantId,
+    sessionFile: config.sessionFile,
+    sessionCookie: config.sessionCookie,
+    mergedEnv,
+    runtimeEnv,
+    stdin,
+    stdout,
+    runWalletCliImpl
+  });
+  step += 1;
+
   if (showSteps) printStep(stdout, step, totalSteps, "Finalize output");
   const payload = {
     ok: true,
+    setupMode: config.setupMode,
+    guided,
     host: config.host,
     wallet: {
       mode: config.walletMode,
@@ -1540,6 +1798,7 @@ export async function runOnboard({
     lines.push("Settld onboard complete.");
     lines.push(`Host: ${config.host}`);
     lines.push(`Settld: ${normalizedBaseUrl} (tenant=${tenantId})`);
+    lines.push(`Setup mode: ${config.setupMode}`);
     lines.push(`Preflight: ${config.preflight ? "passed" : "skipped"}`);
     lines.push(`Wallet mode: ${config.walletMode}`);
     lines.push(`Wallet bootstrap mode: ${walletBootstrapMode}`);
@@ -1547,6 +1806,18 @@ export async function runOnboard({
     if (wallet?.wallets?.escrow?.walletId) lines.push(`Escrow wallet: ${wallet.wallets.escrow.walletId}`);
     if (wallet?.tokenIdUsdc) lines.push(`USDC token id: ${wallet.tokenIdUsdc}`);
     if (args.outEnv) lines.push(`Wrote env file: ${args.outEnv}`);
+    if (guided?.enabled) {
+      lines.push("");
+      lines.push("Guided quick flow:");
+      if (guided.ran) {
+        lines.push(`- wallet fund: ${guided.walletFund?.ok ? "ok" : "not completed"}`);
+        lines.push(`- wallet balance watch: ${guided.walletBalanceWatch?.ok ? "ok" : "not completed"}`);
+        lines.push(`- first paid call: ${guided.firstPaidCall?.ok ? "ok" : "failed"}`);
+      } else {
+        lines.push("- skipped");
+      }
+      for (const warning of guided.warnings ?? []) lines.push(`- warning: ${warning}`);
+    }
     lines.push("");
     lines.push("Combined exports:");
     lines.push(toExportText(mergedEnv));
@@ -1557,6 +1828,14 @@ export async function runOnboard({
       lines.push(`${step}. ${row}`);
       step += 1;
     }
+    if (config.walletMode !== "none") {
+      lines.push(`${step}. Run \`settld wallet status\` to confirm wallet wiring.`);
+      step += 1;
+      lines.push(`${step}. Fund with \`settld wallet fund --method transfer\` (or \`--method card --open\` if hosted links are configured).`);
+      step += 1;
+      lines.push(`${step}. Confirm funds: \`settld wallet balance --watch --min-usdc 1\`.`);
+      step += 1;
+    }
     lines.push(`${step}. Run \`npm run mcp:probe\` for an immediate health check.`);
     stdout.write(`${lines.join("\n")}\n`);
   }

package/scripts/vercel/build-mkdocs.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-if [ ! -x ".vercel-venv/bin/mkdocs" ]; then
-  echo "MkDocs venv not found; running install step first..."
+if ! python3 -m mkdocs --version >/dev/null 2>&1; then
+  echo "MkDocs not found; running install step first..."
   bash scripts/vercel/install-mkdocs.sh
 fi
 
-.vercel-venv/bin/mkdocs build --strict --config-file mkdocs.yml
+python3 -m mkdocs build --strict --config-file mkdocs.yml

package/scripts/vercel/ignore-dashboard.sh

@@ -5,6 +5,9 @@ set -euo pipefail
 # - exit 0 => skip deployment
 # - exit 1 => continue with deployment
 
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+cd "$REPO_ROOT"
+
 if ! git rev-parse --verify HEAD^ >/dev/null 2>&1; then
   # No parent commit context available; build to stay safe.
   exit 1

package/scripts/vercel/install-mkdocs.sh

@@ -1,6 +1,5 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-python3 -m venv .vercel-venv
-.vercel-venv/bin/python -m pip install --upgrade pip setuptools wheel
-.vercel-venv/bin/pip install mkdocs mkdocs-material
+python3 -m pip install --break-system-packages --upgrade pip setuptools wheel
+python3 -m pip install --break-system-packages mkdocs mkdocs-material