@secondlayer/cli 8.7.1 → 8.9.0

package/README.md

@@ -104,9 +104,8 @@ scoped reads and cannot mint (403). Minted keys inherit your plan's tier.
 
 | Command | What it does |
 |---|---|
-| `sl datasets list` / `query <dataset> [--filter k=v] [--cursor] [--limit] [--json]` | Foundation Datasets (sBTC, BNS, PoX-4, STX transfers). Public — no key |
-| `sl index ft-transfers` / `nft-transfers` / `events --event-type <t>` / `contract-calls` | Decoded L2 layer. Anonymous reads OK; free-tier keys rejected (Build+ for keyed) |
-| `sl streams tip` / `events` / `consume` / `reorgs` / `canonical <h>` / `pull` | Raw L1 event firehose. **Requires `SL_API_KEY`** |
+| `sl index ft-transfers` / `nft-transfers` / `events --event-type <t>` / `contract-calls` | Decoded Index layer. Anonymous reads OK; free-tier keys rejected (Build+ for keyed) |
+| `sl streams tip` / `events` / `consume` / `reorgs` / `canonical <h>` / `pull` | Raw chain event firehose. **Requires `SL_API_KEY`** |
 
 Reads emit JSON to stdout (`--json` accepted across all read commands); `-o/--output` is a file path, not a format.
 
@@ -136,16 +135,6 @@ trait — via the SDK, REST, or MCP with a `triggers` array. Every other
 `sl subscriptions` command (list/get/update/pause/resume/delete/doctor/test/
 deliveries/...) operates on both kinds.
 
-### Local dev & OSS
-
-| Command | What it does |
-|---|---|
-| `sl local up [--devnet]` / `sl local down [--devnet]` | Start/stop the full local stack (Stacks node + dev services), or a Clarinet devnet |
-| `sl local start/stop/restart/status/logs` | Manage just the local dev services |
-| `sl local node setup/start/stop/...` | Manage the local Stacks node |
-| `sl local db blocks/txs/events/gaps/truncate/resync` | Inspect the local source DB |
-| `sl devnet connect/down/status/logs` | Clarinet devnet integration |
-
 ### Other
 
 | Command | What it does |
@@ -220,6 +209,17 @@ await token.write.transfer({ amount: 100n, recipient: "SP..." })
 const supply = await token.vars.totalSupply.get()
 ```
 
+## Frozen commands
+
+Local-dev periphery: still functional, hidden from `sl --help`, no further
+investment — may be removed in a future major. The hosted dev loop
+(`sl subgraphs create/deploy`) is the supported path.
+
+- `sl local up/down/start/stop/restart/status/logs` — local stack + dev services
+- `sl local node ...` — local Stacks node management
+- `sl local db ...` — local source DB inspection
+- `sl devnet connect/down/status/logs` — Clarinet devnet integration
+
 ## Docs
 
 Full reference: https://secondlayer.tools/docs

package/dist/cli.js

@@ -31811,7 +31811,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "8.7.1",
+  version: "8.9.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -31861,10 +31861,10 @@ var package_default = {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.3.7",
     "@secondlayer/scaffold": "^1.2.0",
-    "@secondlayer/sdk": "^6.21.0",
-    "@secondlayer/shared": "^6.30.0",
-    "@secondlayer/stacks": "^2.5.0",
-    "@secondlayer/subgraphs": "^3.11.0",
+    "@secondlayer/sdk": "^6.21.2",
+    "@secondlayer/shared": "^6.31.0",
+    "@secondlayer/stacks": "^2.5.1",
+    "@secondlayer/subgraphs": "^3.12.0",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.0",
     esbuild: "^0.19.0",
@@ -33847,6 +33847,24 @@ stacks_node_events_observers = [${entry}]
   return { status: exists ? "added" : "created" };
 }
 
+// src/lib/frozen.ts
+function markFrozen(cmd) {
+  let warned = false;
+  const warn2 = () => {
+    if (warned)
+      return;
+    warned = true;
+    process.stderr.write(`⚠ \`sl ${cmd.name()}\` is frozen — no further investment; it may be removed in a future major. The hosted dev loop (sl subgraphs create/deploy) is the supported path.
+`);
+  };
+  cmd.hook("preAction", warn2);
+  cmd.addHelpText("beforeAll", () => {
+    warn2();
+    return "";
+  });
+  return cmd;
+}
+
 // src/commands/devnet.ts
 init_output();
 var COMPOSE_REL = join6(".secondlayer", "docker-compose.yml");
@@ -33877,7 +33895,7 @@ var SERVICES = [
   "migrate"
 ];
 function registerDevnetCommand(program2) {
-  const devnet = program2.command("devnet").description("Run Secondlayer services against a local Clarinet devnet");
+  const devnet = markFrozen(program2.command("devnet", { hidden: true }).description("Run Secondlayer services against a local Clarinet devnet"));
   devnet.command("connect").description("Point your clarinet project's devnet at a local Secondlayer stack and start it").option("--project <dir>", "Clarinet project directory (defaults to the nearest Clarinet.toml)").option("--image-tag <tag>", "Published image tag to run", DEFAULT_IMAGE_TAG).option("--owner <owner>", "ghcr image owner (namespace) to pull from").option("--no-up", "Patch config + write compose without starting docker").action(async (options) => {
     await connect(options);
   });
@@ -34595,7 +34613,7 @@ function sip010Balances(name) {
 
 /**
  * Track SIP-010 token balances per (asset_identifier, holder).
- * Mirrors the shape of the Foundation Datasets sBTC token-events
+ * Mirrors the shape of the curated sBTC token-events view
  * surface — but works for ANY SIP-010 token. Constrain to a single
  * token by adding \`assetIdentifier: "SP...token::token-name"\` to each
  * source filter.
@@ -35157,11 +35175,37 @@ Grant (first deploy only):`);
 ${yellow("This DROPS all rows in that schema, then rebuilds it. Re-deploy after.")}`);
   console.log(dim("(--force destructive rebuild not yet supported — manual DROP required.)"));
 }
+function formatDuration(seconds) {
+  if (seconds < 90)
+    return `${Math.max(1, Math.round(seconds))}s`;
+  if (seconds < 5400)
+    return `${Math.round(seconds / 60)}m`;
+  return `${(seconds / 3600).toFixed(1)}h`;
+}
 function formatSubgraphSync(sync) {
   const targetBlock = sync.targetBlock ?? sync.chainTip;
   const totalBlocks = sync.totalBlocks;
   const processedBlocks = sync.processedBlocks;
   const progress = `${(sync.progress * 100).toFixed(1)}%`;
+  if (sync.queue) {
+    const pos = sync.queue.position != null ? `position ~${sync.queue.position}` : "queued";
+    const est = sync.queue.estimatedStartSeconds != null ? `, est. start ~${formatDuration(sync.queue.estimatedStartSeconds)}` : "";
+    const denom = sync.queue.estimatedEvents != null ? ` · ~${sync.queue.estimatedEvents.toLocaleString()} events to sync` : "";
+    return {
+      line: `queued — ${pos}${est}${denom}`,
+      remainingLabel: "Queue",
+      remaining: sync.queue.position != null ? `~${sync.queue.position} ahead` : "N/A"
+    };
+  }
+  if (sync.estimatedEvents != null && sync.estimatedEvents > 0 && sync.processedEvents != null) {
+    const pct = `${(sync.processedEvents / sync.estimatedEvents * 100).toFixed(1)}%`;
+    const eta = sync.etaSeconds != null ? ` · est ${formatDuration(sync.etaSeconds)}` : "";
+    return {
+      line: `${sync.status} — ${pct} of ~${sync.estimatedEvents.toLocaleString()} events${eta}`,
+      remainingLabel: "Events Remaining",
+      remaining: `${Math.max(0, sync.estimatedEvents - sync.processedEvents).toLocaleString()}`
+    };
+  }
   if (sync.status === "reindexing" || sync.mode === "reindex") {
     if (targetBlock <= 0) {
       return {
@@ -35185,7 +35229,7 @@ function formatSubgraphSync(sync) {
 }
 function registerSubgraphsCommand(program2) {
   const subgraphs = program2.command("subgraphs").description("Manage materialized subgraphs");
-  subgraphs.command("create <name>").description("Create a new subgraph definition file").option("--template <slug>", `Foundation Dataset starter (one of: ${SUBGRAPH_TEMPLATE_SLUGS.join(", ")})`).addHelpText("after", `
+  subgraphs.command("create <name>").description("Create a new subgraph definition file").option("--template <slug>", `Starter template (one of: ${SUBGRAPH_TEMPLATE_SLUGS.join(", ")})`).addHelpText("after", `
 Examples:
   $ sl subgraphs create my-graph
   $ sl subgraphs create token-balances --template sip-010-balances`).action(async (name, opts) => {
@@ -35274,7 +35318,7 @@ Stopped watching.`);
     });
     await new Promise(() => {});
   });
-  subgraphs.command("deploy <file>").alias("update").description("Deploy a subgraph definition file (alias: update — deploy is create-or-update)").option("--start-block <n>", "Override the subgraph definition startBlock for this deploy").option("--dry-run", "Validate and preview deploy without writing changes").option("-y, --yes", "Skip the reindex confirmation prompt").option("--database-url <url>", "BYO data plane: write the subgraph's schema/rows to your own Postgres. With --dry-run, prints the DDL + grant script and verifies the connection.").option("--strict", "Run `tsc --noEmit` against the handler before deploy (slower; catches TS type errors)").option("--visibility <visibility>", "Read visibility: public (anon /v1 reads, global name claim) or private (your key only). Defaults: managed → public, BYO → private.").action(async (file, options2) => {
+  subgraphs.command("deploy <file>").alias("update").description("Deploy a subgraph definition file (alias: update — deploy is create-or-update)").option("--start-block <n>", "Override the subgraph definition startBlock for this deploy").option("--tip-first", "Go live at chain tip immediately; history backfills in the background (requires order-tolerant handlers — commutative or insert-only writes)").option("--dry-run", "Validate and preview deploy without writing changes").option("-y, --yes", "Skip the reindex confirmation prompt").option("--database-url <url>", "BYO data plane: write the subgraph's schema/rows to your own Postgres. With --dry-run, prints the DDL + grant script and verifies the connection.").option("--strict", "Run `tsc --noEmit` against the handler before deploy (slower; catches TS type errors)").option("--visibility <visibility>", "Read visibility: public (anon /v1 reads, global name claim) or private (your key only). Defaults: managed → public, BYO → private.").action(async (file, options2) => {
     try {
       const absPath = resolve2(file);
       const config = await loadConfig();
@@ -35303,7 +35347,10 @@ Stopped watching.`);
       info(`Loading subgraph from ${absPath}`);
       const mod = await loadSubgraphWithDepCheck(absPath);
       const def = mod.default ?? mod;
-      const effectiveDef = startBlock === undefined ? def : { ...def, startBlock };
+      const effectiveDef = {
+        ...startBlock === undefined ? def : { ...def, startBlock },
+        ...options2.tipFirst ? { backfillMode: "concurrent" } : {}
+      };
       const { validateSubgraphDefinition } = await import("@secondlayer/subgraphs/validate");
       const validated = validateSubgraphDefinition(effectiveDef);
       if (config.network !== "local") {
@@ -35360,6 +35407,9 @@ Stopped watching.`);
               info(`  Publish:   sl subgraphs publish ${effectiveDef.name} (open anon /v1 reads)`);
             }
             info(`  Watch:     sl subgraphs status ${effectiveDef.name}`);
+            if (firstTable) {
+              info(`  Webhook:   sl subscriptions create ${effectiveDef.name}-hook --subgraph ${effectiveDef.name} --table ${firstTable} --url <your-endpoint>`);
+            }
           } catch {}
         };
         if (result.action === "unchanged") {
@@ -36207,7 +36257,7 @@ function emitOne(doc, label, json) {
   });
 }
 function registerIndexCommand(program2) {
-  const index = program2.command("index").description("Query the decoded Index layer (L2 events + contract calls)");
+  const index = program2.command("index").description("Query the decoded Index layer (events + contract calls)");
   index.command("codegen").description("Generate a typed schema (Prisma, Kysely, Drizzle, or JSON-Schema) for the Index domain tables — point it at your BYO database mirror").option("--target <orm>", "prisma | kysely | drizzle | json-schema", "kysely").option("--schema <name>", "Postgres schema to qualify table names with").option("--tables <list>", "Comma-separated subset of Index tables (default: all)").option("--env <var>", "Prisma datasource url env var", "DATABASE_URL").option("-o, --output <path>", "Write to a file (defaults to stdout)").action(async (o) => {
     try {
       const target = o.target ?? "kysely";
@@ -37301,7 +37351,7 @@ async function stopStack(options2) {
   }
 }
 function registerLocalCommand(program2) {
-  const local = program2.command("local").description("Manage local development environment and Stacks node").hook("preAction", async (_thisCommand, actionCommand) => {
+  const local = markFrozen(program2.command("local", { hidden: true }).description("Manage local development environment and Stacks node")).hook("preAction", async (_thisCommand, actionCommand) => {
     if (actionCommand.name() === "help")
       return;
     await requireLocalNetwork();
@@ -37913,5 +37963,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=C4DF51841ACD727C64756E2164756E21
+//# debugId=C1F218ABB7E9AF8864756E2164756E21
 //# sourceMappingURL=cli.js.map