@secondlayer/cli 10.1.0 → 10.2.1

package/README.md

@@ -69,6 +69,7 @@ No account. Writes `.env.local`, restores history, prints the Stacks observer st
 | Command | What it does |
 |---|---|
 | `sl init [--network mainnet\|testnet\|devnet] [--api-url <url>] [--force]` | Write `.env.local` (token, secrets key, webhook signing key). Idempotent |
+| `sl start [--print]` | Validate one-box config and print `docker compose up` |
 | `sl bootstrap --against <manifest> [--to-block <n>] [--public-key <pem>] [-y] [--json]` | Restore chain history from a verified archive into an empty database. Exit `0` restored, `1` diverged, `2` refused |
 | `sl observer [--mode indexer\|signer-shared] [--endpoint host:port] [--recovery journal\|archive] [--network …]` | Print the `[[events_observer]]` stanza. Signer-shared requires `--recovery` |
 | `sl verify [all\|raw\|decode:<name>\|subgraph:<name>] --against <manifest> [--quick\|--deep\|--anchor]` | Compare local data to a signed archive. Default target `raw`. Exit `0` clean, `1` diverged, `2` unanchored |

package/dist/cli.js

@@ -2551,7 +2551,7 @@ var init_session = __esm(() => {
 
 // src/lib/resolve-auth.ts
 function resolveApiUrl() {
-  return process.env.SL_API_URL ?? process.env.SL_PLATFORM_API_URL ?? DEFAULT_API_URL;
+  return (process.env.SL_API_URL ?? process.env.SL_PLATFORM_API_URL ?? LOCAL_API_URL).replace(/\/+$/, "");
 }
 function resolveEnvKey() {
   return process.env.SL_API_KEY;
@@ -2574,9 +2574,13 @@ async function resolveAuth() {
   return { apiUrl, ephemeralKey: session.token, fromEnv: false };
 }
 function isOssMode() {
-  return !!process.env.SL_API_URL;
+  try {
+    return new URL(resolveApiUrl()).hostname !== "api.secondlayer.tools";
+  } catch {
+    return true;
+  }
 }
-var DEFAULT_API_URL = "https://api.secondlayer.tools";
+var LOCAL_API_URL = "http://127.0.0.1:3800";
 var init_resolve_auth = __esm(() => {
   init_session();
 });
@@ -30902,7 +30906,7 @@ import { resolve as resolve4 } from "node:path";
 import { Index as Index2 } from "@secondlayer/sdk";
 function client() {
   return new Index2({
-    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL,
+    baseUrl: resolveApiUrl(),
     apiKey: resolveEnvKey()
   });
 }
@@ -30910,7 +30914,7 @@ function fail(action2, err) {
   const message = err instanceof Error ? err.message : String(err);
   error(`Failed to ${action2}: ${message}`);
   if (/\b403\b/.test(message) || /forbidden/i.test(message)) {
-    note("The Index API requires a Build+ tier key (free-tier keys are rejected).");
+    note("The local API refused this read. Check INSTANCE_TOKEN / SL_API_KEY.");
   }
   process.exit(1);
 }
@@ -31101,7 +31105,6 @@ async function runIndexCodegen(o3) {
     process.exit(1);
   }
 }
-var DEFAULT_BASE_URL = "https://api.secondlayer.tools";
 var init_index_api = __esm(() => {
   init_fs();
   init_output();
@@ -34784,7 +34787,7 @@ init_esm();
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "10.1.0",
+  version: "10.2.1",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -34827,8 +34830,8 @@ var package_default = {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.5.0",
     "@secondlayer/scaffold": "^1.5.1",
-    "@secondlayer/sdk": "^6.51.0",
-    "@secondlayer/shared": "^7.10.0",
+    "@secondlayer/sdk": "^6.54.0",
+    "@secondlayer/shared": "^7.11.0",
     "@secondlayer/stacks": "^3.3.1",
     "@secondlayer/subgraphs": "^3.26.4",
     esbuild: "^0.27.4",
@@ -35383,12 +35386,11 @@ async function validateDatabaseConnection(url) {
 init_output();
 init_resolve_auth();
 import { SecondLayer as SecondLayer2 } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL2 = "https://api.secondlayer.tools";
 function registerContextCommand(program2) {
   program2.command("context").description("Print an agent orientation snapshot: account, live Streams/Index tips, your subgraphs/subscriptions, and in-flight reindex operations").option("--json", "Print as JSON (default)").action(async (o3) => {
     try {
       const sl = new SecondLayer2({
-        baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL2,
+        baseUrl: resolveApiUrl(),
         apiKey: resolveEnvKey()
       });
       const snapshot = await sl.context();
@@ -35404,93 +35406,71 @@ function registerContextCommand(program2) {
   });
 }
 // src/commands/status.ts
-init_config2();
 init_http();
 init_output();
+init_resolve_auth();
 function registerStatusCommand(program2) {
-  program2.command("status").description("Show system status").option("--json", "Output as JSON").action(async (options3) => {
-    const config = await loadConfig2();
+  program2.command("status").description("Show local instance status").option("--json", "Output as JSON").action(async (options3) => {
     try {
-      const status = await httpPlatform("/status");
+      const status = await httpPlatformAnon("/public/status");
       output({
         json: options3.json,
         data: status,
-        human: () => printStatus(status)
+        human: () => printPublicStatus(status)
       });
-    } catch (err) {
-      if (err instanceof CliHttpError && err.code === "SESSION_EXPIRED") {
-        console.error("Not logged in. Run: sl login");
-        process.exit(1);
-      }
+    } catch {
       console.log("");
       console.log(blue("System Status"));
       console.log(`  ${red("NOT RUNNING")}`);
       console.log("");
-      if (config.network === "local") {
-        console.log(dim("  API service is not running."));
-        console.log(dim("  Start with: sl local start"));
-      } else {
-        console.log(dim("  Can't reach the platform API."));
-        console.log(dim("  Check your connection or try again."));
-      }
+      console.log(dim(`  Can't reach ${resolveApiUrl()}/public/status.`));
+      console.log(dim("  Start with: docker compose up -d"));
       console.log("");
       process.exit(1);
     }
   });
 }
-function printStatus(status) {
+function printPublicStatus(status) {
+  const overall = String(status.status ?? "unknown");
+  const color = overall === "healthy" ? green : red;
   console.log("");
-  const statusColor = status.status === "healthy" ? green : red;
   console.log(blue("System Status"));
-  console.log(`  ${statusColor(status.status.toUpperCase())}${status.network ? dim(` (${status.network})`) : ""}`);
-  console.log("");
-  console.log(blue("Database"));
-  const dbColor = status.database.status === "ok" ? green : red;
-  console.log(`  Status: ${dbColor(status.database.status)}`);
+  console.log(`  ${color(overall.toUpperCase())}`);
   console.log("");
-  console.log(blue("Index Progress"));
-  if (status.indexProgress.length === 0) {
-    console.log(dim("  No data indexed yet"));
-  } else {
-    for (const p2 of status.indexProgress) {
-      const behind = p2.highestSeenBlock - p2.lastIndexedBlock;
-      const behindStr = behind > 0 ? yellow(` (${behind} behind)`) : green(" (synced)");
-      console.log(`  ${p2.network}: block ${p2.lastIndexedBlock}${behindStr}`);
-      if (status.chainTip && status.chainTip > 0) {
-        const pct = Math.min(p2.lastIndexedBlock / status.chainTip * 100, 100);
-        const barWidth = 30;
-        const filled = Math.round(pct / 100 * barWidth);
-        const empty = barWidth - filled;
-        const bar = `${"█".repeat(filled)}${"░".repeat(empty)}`;
-        const pctStr = `${pct.toFixed(1)}%`;
-        const color = pct >= 99.9 ? green : pct >= 50 ? yellow : red;
-        console.log(`  ${dim("chain:")} ${color(bar)} ${color(pctStr)} ${dim(`(tip: ${status.chainTip.toLocaleString()})`)}`);
-      }
-      const contiguous = p2.lastContiguousBlock ?? 0;
-      if (status.integrity === "complete") {
-        console.log(`  ${dim("contiguous:")} ${contiguous} ${green("(complete)")}`);
-      } else {
-        const gapCount = status.gaps?.length ?? 0;
-        const missing = status.totalMissingBlocks ?? 0;
-        console.log(`  ${dim("contiguous:")} ${contiguous} ${yellow(`(${gapCount} gaps, ${missing} missing blocks)`)}`);
-        if (status.gaps) {
-          for (const gap of status.gaps.slice(0, 5)) {
-            const range = gap.gapStart === gap.gapEnd ? `${gap.gapStart}` : `${gap.gapStart}-${gap.gapEnd}`;
-            console.log(`    ${dim("gap:")} ${range} ${dim(`(${gap.size} block${gap.size > 1 ? "s" : ""})`)}`);
-          }
-        }
-      }
+  const tip = status.chainTip;
+  if (typeof tip === "number") {
+    console.log(blue("Chain"));
+    console.log(`  tip: ${tip.toLocaleString()}`);
+    const integrity = status.chainIntegrity;
+    if (integrity) {
+      console.log(`  integrity: ${integrity.ok ? green("ok") : yellow("check")}`);
     }
+    console.log("");
   }
-  console.log("");
-  if (status.activeSubgraphs !== undefined) {
-    console.log(blue("Activity"));
-    console.log(formatKeyValue([
-      ["  Active Subgraphs", status.activeSubgraphs.toString()]
-    ]));
+  const streams = status.streams;
+  if (streams) {
+    console.log(blue("Streams"));
+    console.log(`  ${streams.status ?? "unknown"}`);
+    if (typeof streams.tip?.lag_seconds === "number") {
+      console.log(`  lag: ${streams.tip.lag_seconds}s`);
+    }
     console.log("");
   }
-  console.log(dim(`Last updated: ${status.timestamp}`));
+  const index = status.index;
+  if (index) {
+    console.log(blue("Index"));
+    console.log(`  ${index.status ?? "unknown"}`);
+    const bad = (index.decoders ?? []).filter((d2) => d2.status !== "ok");
+    if (bad.length > 0) {
+      for (const d2 of bad.slice(0, 8)) {
+        console.log(`  ${yellow(d2.decoder)} ${d2.status}`);
+      }
+    }
+    console.log("");
+  }
+  if (typeof status.timestamp === "string") {
+    console.log(dim(`Last updated: ${status.timestamp}`));
+  }
 }
 // src/commands/subscriptions.ts
 init_api_client();
@@ -37065,20 +37045,11 @@ import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname9, join as join10 } from "node:path";
 import { createStreamsClient } from "@secondlayer/sdk";
 import { STREAMS_EVENT_TYPES } from "@secondlayer/shared";
-var DEFAULT_BASE_URL3 = "https://api.secondlayer.tools";
 var VALID_TYPES = STREAMS_EVENT_TYPES;
-function readApiKey() {
-  const key = resolveEnvKey();
-  if (!key) {
-    error("No API key set. Export SL_API_KEY (issue one at https://www.secondlayer.tools/platform/api-keys).");
-    process.exit(1);
-  }
-  return key;
-}
 function client2() {
   return createStreamsClient({
-    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL3,
-    apiKey: readApiKey()
+    baseUrl: resolveApiUrl(),
+    apiKey: resolveEnvKey() ?? ""
   });
 }
 function dumpsClient(dumpsUrl) {
@@ -37088,7 +37059,7 @@ function dumpsClient(dumpsUrl) {
     process.exit(1);
   }
   return createStreamsClient({
-    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL3,
+    baseUrl: resolveApiUrl(),
     apiKey: resolveEnvKey() ?? "",
     dumpsBaseUrl
   });
@@ -37131,7 +37102,7 @@ function parseHeight(value, name) {
   return n3;
 }
 function registerStreamsCommand(program2) {
-  const streams = program2.command("streams").description("Read raw chain events from Streams (requires SL_API_KEY)");
+  const streams = program2.command("streams").description("Read raw chain events from Streams");
   streams.command("tip").description("Print current canonical tip").option("--json", "Output as JSON (streams always emits JSON)").action(async () => {
     try {
       const tip = await client2().tip();
@@ -37285,7 +37256,6 @@ init_index_api();
 init_output();
 init_resolve_auth();
 import { SecondLayer as SecondLayer4 } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL4 = "https://api.secondlayer.tools";
 function registerKeysCommand(program2) {
   const keys = program2.command("keys", { hidden: true }).description("Manage API keys");
   keys.command("create").description("Mint a scoped streams/index read key (requires an account-level key)").option("--product <product>", "Key scope: streams or index", "streams").option("--name <name>", "Optional label for the key").option("--json", "Print the full response as JSON").action(async (o3) => {
@@ -37300,7 +37270,7 @@ function registerKeysCommand(program2) {
     }
     try {
       const sl = new SecondLayer4({
-        baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL4,
+        baseUrl: resolveApiUrl(),
         apiKey
       });
       const minted = await sl.apiKeys.create({
@@ -37323,7 +37293,6 @@ function registerKeysCommand(program2) {
   });
 }
 // src/commands/doctor.ts
-init_api_client();
 init_config2();
 
 // src/lib/health.ts
@@ -37469,50 +37438,31 @@ async function checkHealth() {
 init_http();
 init_network();
 init_output();
+init_resolve_auth();
 function registerDoctorCommand(program2) {
   program2.command("doctor").description("Run diagnostics on the full stack").option("--json", "Output as JSON").action(async (options3) => {
     const config = await loadConfig2();
     if (config.network === "local") {
       await runLocalDoctor(options3.json);
-    } else {
-      await runHostedDoctor(options3.json);
+      return;
     }
+    await runInstanceDoctor(options3.json);
   });
 }
-async function runHostedDoctor(jsonOutput) {
+async function runInstanceDoctor(jsonOutput) {
   const config = await loadConfig2();
-  const apiUrl = process.env.SL_PLATFORM_API_URL ?? "https://api.secondlayer.tools";
+  const apiUrl = resolveApiUrl();
   const issues = [];
   const results = { network: config.network, apiUrl };
   let apiHealthy = false;
   let statusData = null;
   try {
-    statusData = await httpPlatform("/status");
+    statusData = await httpPlatformAnon("/public/status");
     apiHealthy = true;
-  } catch (err) {
-    if (err instanceof CliHttpError) {
-      if (err.code === "SESSION_EXPIRED") {
-        issues.push("Not authenticated. Run: sl login");
-      } else {
-        issues.push(`API error: ${err.code}`);
-      }
-    } else {
-      issues.push(`Cannot reach API at ${apiUrl}`);
-    }
+  } catch {
+    issues.push(`Cannot reach ${apiUrl}/public/status`);
   }
   results.apiHealthy = apiHealthy;
-  let authOk = false;
-  let account = null;
-  try {
-    account = await getAccountProfile();
-    authOk = true;
-  } catch (err) {
-    if (err instanceof CliHttpError && err.code === "SESSION_EXPIRED") {
-      issues.push("Not authenticated. Run: sl login");
-    }
-  }
-  results.authOk = authOk;
-  results.account = account;
   if (jsonOutput) {
     console.log(JSON.stringify({ ...results, status: statusData, issues }, null, 2));
     return;
@@ -37524,28 +37474,18 @@ async function runHostedDoctor(jsonOutput) {
   console.log(blue("API"));
   console.log(`  ${apiHealthy ? green("✓") : red("✗")} ${apiHealthy ? green("reachable") : red("unreachable")}`);
   console.log("");
-  console.log(blue("Auth"));
-  if (authOk && account) {
-    console.log(`  ${green("✓")} Authenticated`);
-    console.log(formatKeyValue([
-      ["  Email", account.email ?? dim("unknown")],
-      ["  Plan", account.plan ?? dim("unknown")]
-    ]));
-  } else {
-    console.log(`  ${red("✗")} Not authenticated`);
-  }
-  console.log("");
   if (statusData) {
-    const progress = statusData.indexProgress;
-    if (progress?.length) {
-      console.log(blue("Index Progress"));
-      for (const p2 of progress) {
-        const behind = p2.highestSeenBlock - p2.lastIndexedBlock;
-        const behindStr = behind > 0 ? yellow(` (${behind} behind)`) : green(" (synced)");
-        console.log(`  ${p2.network}: block ${p2.lastIndexedBlock}${behindStr}`);
-      }
-      console.log("");
-    }
+    const tip = statusData.chainTip;
+    const streams = statusData.streams;
+    const index = statusData.index;
+    console.log(blue("Instance"));
+    if (typeof tip === "number")
+      console.log(`  tip: ${tip.toLocaleString()}`);
+    if (streams?.status)
+      console.log(`  streams: ${streams.status}`);
+    if (index?.status)
+      console.log(`  index: ${index.status}`);
+    console.log("");
   }
   console.log(blue("Issues"));
   if (issues.length === 0) {
@@ -39801,6 +39741,39 @@ function registerObserverCommand(program2) {
     writeData(renderObserverStanza({ mode, endpoint, network, recovery }));
   });
 }
+// src/commands/start.ts
+init_output();
+import { parseRuntimeConfig } from "@secondlayer/shared/runtime";
+function registerStartCommand(program2) {
+  program2.command("start").description("Validate one-box runtime config and print the compose command").option("--print", "print the compose invocation only").action((opts) => {
+    const parsed = parseRuntimeConfig({
+      NETWORK: process.env.NETWORK ?? process.env.STACKS_NETWORK,
+      DATABASE_URL: process.env.DATABASE_URL,
+      NODE_MODE: process.env.NODE_MODE ?? "external",
+      DATA_DIR: process.env.DATA_DIR ?? "/data",
+      API_PORT: process.env.API_PORT ?? "3800",
+      INDEXER_PORT: process.env.INDEXER_PORT ?? "3700",
+      STACKS_NODE_RPC_URL: process.env.STACKS_NODE_RPC_URL,
+      LISTEN_HOST: process.env.LISTEN_HOST,
+      LOG_LEVEL: process.env.LOG_LEVEL,
+      BITCOIN_RPC_PASSWORD: process.env.BITCOIN_RPC_PASSWORD
+    });
+    if (!parsed.ok) {
+      printError(parsed.errors.join("; "), {
+        hint: "Set NETWORK, DATABASE_URL, and NODE_MODE (external | stacks | full)."
+      });
+      process.exit(1);
+    }
+    const extra = parsed.config.NODE_MODE === "full" ? " --profile full-node" : parsed.config.NODE_MODE === "stacks" ? " --profile stacks-node" : "";
+    const cmd = `docker compose -f docker/oss/docker-compose.yml${extra} up -d`;
+    if (opts.print) {
+      console.log(cmd);
+      return;
+    }
+    success(`config ok (${parsed.config.NETWORK}, ${parsed.config.NODE_MODE})`);
+    console.log(cmd);
+  });
+}
 // src/cli.ts
 var { version } = package_default;
 program.name("secondlayer").alias("sl").description("Secondlayer CLI — self-hosted Stacks data runtime").version(version).option("--network <network>", "Override network (local, testnet, mainnet)").option("--api-key <key>", "API credential (overrides SL_API_KEY)").option("--api-url <url>", "API endpoint (overrides SL_API_URL)").showSuggestionAfterError(true).showHelpAfterError("(run `sl --help` to see available commands)");
@@ -39824,6 +39797,7 @@ program.commandsGroup("Getting started:");
 registerInitCommand(program);
 registerBootstrapCommand(program);
 registerObserverCommand(program);
+registerStartCommand(program);
 registerLoginCommand(program);
 registerLogoutCommand(program);
 registerWhoamiCommand(program);
@@ -39863,5 +39837,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=43937D51F562F20264756E2164756E21
+//# debugId=60FAFC7C2FFCA95764756E2164756E21
 //# sourceMappingURL=cli.js.map