@secondlayer/cli 15.0.1 → 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";
   };
@@ -202706,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);
@@ -203894,7 +203890,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "15.0.1",
+  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",
@@ -203935,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.1",
-    "@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",
@@ -204515,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(", ");
@@ -208961,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) => {
@@ -208969,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
@@ -209056,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"
         }
       ]
     });
@@ -209093,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)
@@ -209172,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.
 
@@ -209266,5 +209264,5 @@ registerCreditsCommand(program);
 registerArchiveCommand(program);
 program.parse();
 
-//# debugId=83D336B04841B78A64756E2164756E21
+//# debugId=F035865DCA2A5BEE64756E2164756E21
 //# sourceMappingURL=cli.js.map