@secondlayer/cli 15.0.0 → 16.0.0

package/README.md

@@ -82,7 +82,7 @@ No account. Writes `.env.local`, restores history, prints the Stacks observer st
 | `secondlayer setup [--network …] [--node-mode external\|stacks\|full] [--api-port <spec>] [--dir <path>] [--against <manifest>] [--skip-bootstrap] [--skip-verify] [--yes] [--force]` | Guided self-host onboarding — secrets, compose + `.env`, docker up, observer stanza, bootstrap, verify. TUI when interactive; flags-only (no prompts) with `--yes` or no TTY |
 | `secondlayer init [--network mainnet\|testnet\|devnet] [--api-url <url>] [--force]` | Write `.env.local` (token, secrets key, webhook signing key). `--network` and `--api-url` are the global flags. Idempotent |
 | `secondlayer bootstrap --against <manifest> [--from-block <n>] [--to-block <n>] [--verify all\|blocks] [--public-key <pem>] [-y] [--json]` | Restore chain history from a verified archive into an empty database. A run that died mid-way resumes per dataset on re-run. After the load, digests for blocks, transactions, and events are checked over the restored range (`--verify blocks` skips the child datasets and the minutes they cost). Partition fetches retry three times with backoff on resets, timeouts, 429 (honoring `Retry-After`) and 5xx; a link that stays down exits `1` with a re-run hint, and the re-run resumes. Exit `0` restored, `1` diverged or interrupted, `2` refused |
-| `secondlayer observer [--mode indexer\|signer-shared] [--endpoint host:port] [--recovery journal\|archive] [--network …]` | Print the `[[events_observer]]` stanza. Signer-shared requires `--recovery` |
+| `secondlayer observer [--mode indexer\|signer-shared] [--endpoint host:port] [--network …]` | Print the `[[events_observer]]` stanza. Signer-shared skips retries; a missed block stays a gap until `repair` |
 | `secondlayer 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 |
 | `secondlayer repair --against <archive> [--apply] [-y]` | Plan (default) or apply an archive repair. A fixed block is rewritten with its transactions and events from the archive; when the reference has no child partition for a height, the block is rewritten alone, the height is named with a `bootstrap --from-block H --to-block H` remedy, and the exit is `1`. Partition fetches retry like `bootstrap`; a link that stays down exits `1` with a re-run hint, and heights already repaired are kept |
 

package/dist/cli.js

@@ -197993,7 +197993,8 @@ import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync3, wr
 import { dirname as dirname4, resolve as resolve3 } from "node:path";
 import { Index, resolveApiKey as resolveApiKey3, resolveBaseUrl } from "@secondlayer/sdk";
 import {
-  DECODED_EVENT_TYPES
+  DECODED_EVENT_TYPES,
+  VM_EVENT_TYPES
 } from "@secondlayer/stacks/filters";
 import {
   runSubgraphTest as applySubgraphTest,
@@ -198030,7 +198031,13 @@ function eventTypeFor(filter) {
     return null;
   }
   const candidate = filter.type === "print_event" ? "print" : filter.type;
-  return DECODED_EVENT_TYPES.includes(candidate) ? candidate : null;
+  if (DECODED_EVENT_TYPES.includes(candidate)) {
+    return candidate;
+  }
+  if (VM_EVENT_TYPES.includes(candidate)) {
+    return candidate;
+  }
+  return null;
 }
 function indexApiUrl() {
   return resolveBaseUrl();
@@ -202446,13 +202453,6 @@ function parseObserverMode(value) {
   }
   throw new UnsupportedObserverError(`observer mode must be indexer or signer-shared (got ${value})`);
 }
-function parseRecoverySource(value) {
-  const source = value.trim().toLowerCase();
-  if (RECOVERY_SOURCES.includes(source)) {
-    return source;
-  }
-  throw new UnsupportedObserverError(`recovery source must be journal or archive (got ${value})`);
-}
 function parseObserverEndpoint(value) {
   const trimmed = value.trim();
   if (/^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) || trimmed.startsWith("unix:")) {
@@ -202474,9 +202474,6 @@ function validateObserverStanza(input3) {
   if (input3.network !== "devnet" && LOOPBACK_HOSTS.has(host.toLowerCase())) {
     throw new UnsupportedObserverError(`loopback observer endpoint is not container-visible on ${input3.network}; use a docker DNS name such as indexer:3700`);
   }
-  if (input3.mode === "signer-shared" && !input3.recovery) {
-    throw new UnsupportedObserverError("signer-shared mode requires --recovery journal or --recovery archive");
-  }
   return { endpoint };
 }
 function renderObserverStanza(input3) {
@@ -202484,7 +202481,7 @@ function renderObserverStanza(input3) {
   const indexer = input3.mode === "indexer";
   const timeoutMs = indexer ? 2000 : 500;
   const disableRetries = !indexer;
-  const comment = indexer ? "# Pure indexer: retry delivery. A slow observer can stall the node." : "# Signer-shared: do not retry. Missed blocks refill from the journal/archive.";
+  const comment = indexer ? "# Pure indexer: retry delivery. A slow observer can stall the node." : "# Signer-shared: do not retry. A missed block stays a gap until `secondlayer repair`.";
   return [
     comment,
     "[[events_observer]]",
@@ -202501,10 +202498,9 @@ function defaultObserverEndpoint(network) {
     return "127.0.0.1:3700";
   return "indexer:3700";
 }
-var OBSERVER_MODES, RECOVERY_SOURCES, UnsupportedObserverError, LOOPBACK_HOSTS;
+var OBSERVER_MODES, UnsupportedObserverError, LOOPBACK_HOSTS;
 var init_observer_stanza = __esm(() => {
   OBSERVER_MODES = ["indexer", "signer-shared"];
-  RECOVERY_SOURCES = ["journal", "archive"];
   UnsupportedObserverError = class UnsupportedObserverError extends Error {
     name = "UnsupportedObserverError";
   };
@@ -202516,11 +202512,10 @@ function buildOssCompose(opts = {}) {
   const owner = opts.owner ?? DEFAULT_IMAGE_OWNER;
   const tag = opts.imageTag ?? DEFAULT_IMAGE_TAG;
   const runtimeImage = `ghcr.io/${owner}/secondlayer-runtime:${tag}`;
-  const consoleImage = `ghcr.io/${owner}/secondlayer-console:${tag}`;
   return `# Generated by \`secondlayer setup\` — do not edit by hand.
 # Mirrors docker/oss/docker-compose.yml; see that file for the source of truth
-# on env vars, profiles, and third-party digest pins. \`secondlayer\`/\`console\`
-# are swapped from a repo build to the published OSS images (no checkout here).
+# on env vars, profiles, and third-party digest pins. \`secondlayer\` is
+# swapped from a repo build to the published OSS image (no checkout here).
 name: secondlayer
 
 services:
@@ -202597,27 +202592,6 @@ services:
       retries: 3
     restart: unless-stopped
 
-  console:
-    image: ${consoleImage}
-    environment:
-      SL_API_URL: http://secondlayer:3800
-      INSTANCE_TOKEN: \${INSTANCE_TOKEN:-}
-      CONSOLE_TOKEN: \${CONSOLE_TOKEN:-}
-      NODE_ENV: production
-    ports:
-      - "\${CONSOLE_PORT:-3801}:3801"
-    depends_on:
-      secondlayer:
-        condition: service_started
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:3801/console"]
-      interval: 30s
-      timeout: 5s
-      start_period: 15s
-      retries: 3
-    restart: unless-stopped
-    profiles: ["console"]
-
   bitcoind:
     # Digest = kylemanna/bitcoind:latest as published 2026-07-20 — see
     # docker/oss/docker-compose.yml for why the digest is the real pin here.
@@ -202705,7 +202679,7 @@ dbcache=4096
 var init_oss_compose = () => {};
 
 // src/lib/setup-wizard.ts
-import { spawn as spawn4, spawnSync as spawnSync5 } from "node:child_process";
+import { spawn as spawn3, spawnSync as spawnSync5 } from "node:child_process";
 import { randomBytes as randomBytes4 } from "node:crypto";
 import { existsSync as existsSync12 } from "node:fs";
 import { writeFile as writeFile6 } from "node:fs/promises";
@@ -202728,7 +202702,7 @@ function resolveNonInteractiveConfig(flags) {
     throw new MissingSetupFlagError("--node-mode", "Missing --node-mode <external|stacks|full>. Non-interactive setup requires it explicitly — there is no safe default.");
   }
   if (!flags.against && !flags.skipBootstrap) {
-    throw new MissingSetupFlagError("--against", "Missing --against <manifest-url>. Pass an archive manifest to bootstrap from, or --skip-bootstrap to sync from genesis instead.");
+    throw new MissingSetupFlagError("--against", "Missing --against <manifest-url>. Pass an archive manifest to bootstrap from, or --skip-bootstrap to index only what your node sends from now on.");
   }
   const network = parseInstanceNetwork(flags.network);
   const nodeMode = parseSetupNodeMode(flags.nodeMode);
@@ -202925,7 +202899,7 @@ function composeProfileArgs(nodeMode) {
 }
 function runStreaming(command, args, opts) {
   return new Promise((resolvePromise, reject) => {
-    const child = spawn4(command, args, {
+    const child = spawn3(command, args, {
       cwd: opts.cwd,
       env: opts.env ?? process.env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -203916,7 +203890,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "15.0.0",
+  version: "16.0.0",
   description: "Run a Stacks index on your own hardware — set it up, restore verified history, and keep it current.",
   repository: {
     type: "git",
@@ -203957,10 +203931,10 @@ var package_default = {
     "@opentui/react": "^0.5.3",
     "@secondlayer/bundler": "^0.5.3",
     "@secondlayer/scaffold": "^1.5.7",
-    "@secondlayer/sdk": "^10.4.2",
-    "@secondlayer/shared": "^11.6.0",
-    "@secondlayer/stacks": "^6.0.0",
-    "@secondlayer/subgraphs": "^4.3.4",
+    "@secondlayer/sdk": "^10.4.3",
+    "@secondlayer/shared": "^11.7.0",
+    "@secondlayer/stacks": "^6.1.0",
+    "@secondlayer/subgraphs": "^4.4.0",
     esbuild: "^0.28.2",
     react: "^19.1.0",
     "smol-toml": "^1.8.0",
@@ -204537,10 +204511,13 @@ Exit codes:
               console.error(dim(`  Scope starts at ${startHeight.toLocaleString()} — earlier history is declared out of scope, not missing.`));
             }
             if (seam) {
-              console.error(dim(`The chain advanced to ${seam.nodeTip.toLocaleString()} while restoring — ${seam.gap.toLocaleString()} blocks to catch up.`));
-              console.error(dim("  Start the indexer; it backfills that range before following the tip."));
+              console.error(dim(`Your node was at ${seam.nodeTip.toLocaleString()} when the restore started, ${seam.gap.toLocaleString()} blocks past the archive tip.`));
+              console.error(dim(`  The index has a gap from ${(tipHeight + 1).toLocaleString()} to ${seam.nodeTip.toLocaleString()}. Blocks your node sent during the restore are ingested; nothing fills the gap on its own.`));
+              console.error(dim(`  After the next archive publish covers it: secondlayer repair --against ${opts.against} --from-block ${tipHeight + 1} --to-block ${seam.nodeTip} --apply`));
+            } else if (nodeTipAtStart === null) {
+              console.error(dim("  Start the indexer to continue from there. Node unreachable, so any gap past the archive tip is unknown; `secondlayer verify` finds it once the archive covers it."));
             } else {
-              console.error(dim("  Start the indexer to continue from there. (Node unreachable — catch-up range unknown.)"));
+              console.error(dim("  Start the indexer to continue from there."));
             }
           } else {
             const byDataset = verifyDatasets.map((d) => `${divergentRanges.filter((r) => r.dataset === d).length} ${d}`).join(", ");
@@ -205927,66 +205904,6 @@ async function validateDatabaseConnection(url) {
     console.log(dim("The URL was saved but connection failed. Check your database settings."));
   }
 }
-// src/commands/console.ts
-init_output();
-init_resolve_auth();
-import { spawn as spawn3 } from "node:child_process";
-var DEFAULT_CONSOLE_URL = "http://localhost:3801/console";
-var CONSOLE_PORT = 3801;
-function resolveConsoleUrl(override) {
-  if (override)
-    return override.replace(/\/+$/, "");
-  const apiUrl = process.env.SL_API_URL;
-  if (apiUrl && isOssMode()) {
-    try {
-      const { protocol, hostname } = new URL(apiUrl);
-      return `${protocol}//${hostname}:${CONSOLE_PORT}/console`;
-    } catch {}
-  }
-  return DEFAULT_CONSOLE_URL;
-}
-async function isReachable(url) {
-  try {
-    await fetch(url, { signal: AbortSignal.timeout(2000) });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function openBrowser(url) {
-  const opener = process.platform === "darwin" ? "open" : process.platform === "linux" ? "xdg-open" : undefined;
-  if (!opener)
-    return Promise.resolve(false);
-  return new Promise((resolve7) => {
-    const child = spawn3(opener, [url], { stdio: "ignore", detached: true });
-    child.once("error", () => resolve7(false));
-    child.once("spawn", () => {
-      child.unref();
-      resolve7(true);
-    });
-  });
-}
-function registerConsoleCommand(program2) {
-  program2.command("console").description("Open the console UI in a browser").option("--url <url>", `Console URL (default ${DEFAULT_CONSOLE_URL})`).option("--no-open", "Print the console URL instead of opening a browser").action(async (options3) => {
-    assertInstanceUrl();
-    const url = resolveConsoleUrl(options3.url);
-    if (options3.open === false) {
-      writeData(url);
-      return;
-    }
-    if (!await isReachable(url)) {
-      printError(`Console not reachable at ${url}`, {
-        hint: "docker compose --profile console up -d"
-      });
-      process.exit(1);
-    }
-    if (await openBrowser(url)) {
-      success(`console: ${url}`);
-    } else {
-      writeData(url);
-    }
-  });
-}
 // src/commands/context.ts
 init_http();
 import {
@@ -209043,7 +208960,7 @@ init_observer_stanza();
 init_output();
 init_resolve_auth();
 function registerObserverCommand(program2) {
-  program2.command("observer").description("Print the Stacks events_observer stanza for this node mode").option("--mode <mode>", "indexer (retry) or signer-shared (no retry)", "indexer").option("--endpoint <host:port>", "Observer callback the node will POST to").option("--recovery <source>", "Required for signer-shared: journal or archive").addHelpText("after", `
+  program2.command("observer").description("Print the Stacks events_observer stanza for this node mode").option("--mode <mode>", "indexer (retry) or signer-shared (no retry)", "indexer").option("--endpoint <host:port>", "Observer callback the node will POST to").addHelpText("after", `
 --network <mainnet|testnet|devnet> is the top-level global flag (see
 \`secondlayer --help\`) — default mainnet, same as before.
 `).action((opts) => {
@@ -209051,11 +208968,10 @@ function registerObserverCommand(program2) {
     const mode = parseObserverMode(opts.mode);
     const network = instanceNetworkFromEnv();
     const endpoint = opts.endpoint ?? defaultObserverEndpoint(network);
-    const recovery = opts.recovery ? parseRecoverySource(opts.recovery) : undefined;
     if (mode === "signer-shared") {
-      note("Signer-shared nodes skip observer retries. Pair with a journal or archive for completeness.");
+      note("Signer-shared nodes skip observer retries. A missed block stays a gap until `secondlayer repair` fills it from the archive.");
     }
-    writeData(renderObserverStanza({ mode, endpoint, network, recovery }));
+    writeData(renderObserverStanza({ mode, endpoint, network }));
   });
 }
 // src/commands/setup.ts
@@ -209138,9 +209054,9 @@ async function promptSetupConfig(flags) {
           description: "Enter your own"
         },
         {
-          name: "Sync from genesis",
+          name: "Skip the archive",
           value: "skip",
-          description: "Skip bootstrap — slower, no download"
+          description: "Index only what your node sends from now on"
         }
       ]
     });
@@ -209175,7 +209091,7 @@ async function promptSetupConfig(flags) {
   console.error(`  node mode    ${config.nodeMode}`);
   console.error(`  dir          ${config.dir}`);
   console.error(`  api port     ${config.apiPort}`);
-  console.error(`  bootstrap    ${config.skipBootstrap ? "skip (sync from genesis)" : config.against}`);
+  console.error(`  bootstrap    ${config.skipBootstrap ? "skip (from the node's tip)" : config.against}`);
   console.error("");
   const proceed = await confirm4({ message: "Start setup?", default: true });
   if (!proceed)
@@ -209254,7 +209170,7 @@ async function runPromptedInteractive(flags) {
   await executeAndRender(config);
 }
 function registerSetupCommand(program2) {
-  program2.command("setup").description("Guided self-host onboarding: secrets, config, docker, bootstrap, verify — one command").option("--node-mode <mode>", "external, stacks, or full (required)").option("--api-port <spec>", "API publish spec", "127.0.0.1:3800").option("--dir <path>", "Target directory for compose + .env", ".").option("--against <manifest>", `Archive manifest to bootstrap from (suggested default: ${DEFAULT_ARCHIVE_MANIFEST})`).option("--skip-bootstrap", "Sync from genesis instead of restoring an archive").option("--skip-verify", "Skip the post-bootstrap verify pass").option("--yes", "Non-interactive: skip the TUI, require flags, never prompt").option("--force", "Regenerate secrets even if a .env already exists in --dir").option("--owner <owner>", "ghcr image owner (namespace) to pull from").option("--image-tag <tag>", "Published image tag to run").addHelpText("after", `
+  program2.command("setup").description("Guided self-host onboarding: secrets, config, docker, bootstrap, verify — one command").option("--node-mode <mode>", "external, stacks, or full (required)").option("--api-port <spec>", "API publish spec", "127.0.0.1:3800").option("--dir <path>", "Target directory for compose + .env", ".").option("--against <manifest>", `Archive manifest to bootstrap from (suggested default: ${DEFAULT_ARCHIVE_MANIFEST})`).option("--skip-bootstrap", "Skip the archive restore; index only what your node sends from now on").option("--skip-verify", "Skip the post-bootstrap verify pass").option("--yes", "Non-interactive: skip the TUI, require flags, never prompt").option("--force", "Regenerate secrets even if a .env already exists in --dir").option("--owner <owner>", "ghcr image owner (namespace) to pull from").option("--image-tag <tag>", "Published image tag to run").addHelpText("after", `
 --network <mainnet|testnet|devnet> is the top-level global flag (see
 \`secondlayer --help\`) — required here too, just parsed one level up.
 
@@ -209321,7 +209237,6 @@ registerSetupCommand(program);
 registerInitCommand(program);
 registerBootstrapCommand(program);
 registerObserverCommand(program);
-registerConsoleCommand(program);
 registerLoginCommand(program);
 registerLogoutCommand(program);
 registerWhoamiCommand(program);
@@ -209349,5 +209264,5 @@ registerCreditsCommand(program);
 registerArchiveCommand(program);
 program.parse();
 
-//# debugId=400188075261398364756E2164756E21
+//# debugId=F035865DCA2A5BEE64756E2164756E21
 //# sourceMappingURL=cli.js.map