@secondlayer/cli 8.7.1 → 8.8.0

package/README.md

@@ -104,7 +104,6 @@ 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`** |
 
@@ -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.8.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -31861,9 +31861,9 @@ var package_default = {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.3.7",
     "@secondlayer/scaffold": "^1.2.0",
-    "@secondlayer/sdk": "^6.21.0",
+    "@secondlayer/sdk": "^6.21.1",
     "@secondlayer/shared": "^6.30.0",
-    "@secondlayer/stacks": "^2.5.0",
+    "@secondlayer/stacks": "^2.5.1",
     "@secondlayer/subgraphs": "^3.11.0",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.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.
@@ -35360,6 +35378,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") {
@@ -37301,7 +37322,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 +37934,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=C4DF51841ACD727C64756E2164756E21
+//# debugId=B164F591CA98B53C64756E2164756E21
 //# sourceMappingURL=cli.js.map