@secondlayer/cli 6.0.0 → 7.0.0

package/dist/cli.js

@@ -2522,7 +2522,7 @@ function resolveApiUrl() {
   return process.env.SL_API_URL ?? process.env.SL_PLATFORM_API_URL ?? DEFAULT_API_URL;
 }
 function resolveEnvKey() {
-  return process.env.SL_API_KEY ?? process.env.SL_SERVICE_KEY ?? process.env.SL_STREAMS_API_KEY;
+  return process.env.SL_API_KEY;
 }
 async function resolveAuth() {
   const apiUrl = resolveApiUrl();
@@ -4946,88 +4946,6 @@ var init_src = __esm(() => {
   src_default = Postgres;
 });
 
-// src/lib/dev-state.ts
-var exports_dev_state = {};
-__export(exports_dev_state, {
-  saveDevState: () => saveDevState,
-  loadDevState: () => loadDevState,
-  isProcessRunning: () => isProcessRunning,
-  isDevRunning: () => isDevRunning,
-  getRunningServices: () => getRunningServices,
-  getLogsDir: () => getLogsDir,
-  getLogFile: () => getLogFile,
-  ensureDirs: () => ensureDirs,
-  clearLogs: () => clearLogs,
-  clearDevState: () => clearDevState
-});
-import { homedir as homedir4 } from "node:os";
-import { join as join5 } from "node:path";
-function getLogsDir() {
-  return LOGS_DIR;
-}
-function getLogFile(service) {
-  return join5(LOGS_DIR, `${service}.log`);
-}
-async function ensureDirs() {
-  await Bun.$`mkdir -p ${STATE_DIR}`.quiet();
-  await Bun.$`mkdir -p ${LOGS_DIR}`.quiet();
-}
-async function loadDevState() {
-  const file = Bun.file(DEV_STATE_PATH);
-  if (!await file.exists()) {
-    return null;
-  }
-  try {
-    return await file.json();
-  } catch {
-    return null;
-  }
-}
-async function saveDevState(state) {
-  await ensureDirs();
-  await Bun.write(DEV_STATE_PATH, `${JSON.stringify(state, null, 2)}
-`);
-}
-async function clearDevState() {
-  const file = Bun.file(DEV_STATE_PATH);
-  if (await file.exists()) {
-    await Bun.$`rm ${DEV_STATE_PATH}`.quiet();
-  }
-}
-async function clearLogs() {
-  await Bun.$`rm -f ${LOGS_DIR}/*.log`.quiet().nothrow();
-}
-function isProcessRunning(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function getRunningServices() {
-  const state = await loadDevState();
-  if (!state)
-    return {};
-  const running = {};
-  for (const [name, service] of Object.entries(state.services)) {
-    if (isProcessRunning(service.pid)) {
-      running[name] = service;
-    }
-  }
-  return running;
-}
-async function isDevRunning() {
-  const running = await getRunningServices();
-  return Object.keys(running).length > 0;
-}
-var STATE_DIR, DEV_STATE_PATH, LOGS_DIR;
-var init_dev_state = __esm(() => {
-  STATE_DIR = join5(homedir4(), ".secondlayer");
-  DEV_STATE_PATH = join5(STATE_DIR, "dev.json");
-  LOGS_DIR = join5(STATE_DIR, "logs");
-});
-
 // src/utils/abi-compat.ts
 function normalizeAccess(access) {
   if (access === "read_only")
@@ -12990,6 +12908,88 @@ function inferNetwork(address) {
   return;
 }
 
+// src/lib/dev-state.ts
+var exports_dev_state = {};
+__export(exports_dev_state, {
+  saveDevState: () => saveDevState,
+  loadDevState: () => loadDevState,
+  isProcessRunning: () => isProcessRunning,
+  isDevRunning: () => isDevRunning,
+  getRunningServices: () => getRunningServices,
+  getLogsDir: () => getLogsDir,
+  getLogFile: () => getLogFile,
+  ensureDirs: () => ensureDirs,
+  clearLogs: () => clearLogs,
+  clearDevState: () => clearDevState
+});
+import { homedir as homedir4 } from "node:os";
+import { join as join8 } from "node:path";
+function getLogsDir() {
+  return LOGS_DIR;
+}
+function getLogFile(service) {
+  return join8(LOGS_DIR, `${service}.log`);
+}
+async function ensureDirs() {
+  await Bun.$`mkdir -p ${STATE_DIR}`.quiet();
+  await Bun.$`mkdir -p ${LOGS_DIR}`.quiet();
+}
+async function loadDevState() {
+  const file = Bun.file(DEV_STATE_PATH);
+  if (!await file.exists()) {
+    return null;
+  }
+  try {
+    return await file.json();
+  } catch {
+    return null;
+  }
+}
+async function saveDevState(state) {
+  await ensureDirs();
+  await Bun.write(DEV_STATE_PATH, `${JSON.stringify(state, null, 2)}
+`);
+}
+async function clearDevState() {
+  const file = Bun.file(DEV_STATE_PATH);
+  if (await file.exists()) {
+    await Bun.$`rm ${DEV_STATE_PATH}`.quiet();
+  }
+}
+async function clearLogs() {
+  await Bun.$`rm -f ${LOGS_DIR}/*.log`.quiet().nothrow();
+}
+function isProcessRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function getRunningServices() {
+  const state = await loadDevState();
+  if (!state)
+    return {};
+  const running = {};
+  for (const [name, service] of Object.entries(state.services)) {
+    if (isProcessRunning(service.pid)) {
+      running[name] = service;
+    }
+  }
+  return running;
+}
+async function isDevRunning() {
+  const running = await getRunningServices();
+  return Object.keys(running).length > 0;
+}
+var STATE_DIR, DEV_STATE_PATH, LOGS_DIR;
+var init_dev_state = __esm(() => {
+  STATE_DIR = join8(homedir4(), ".secondlayer");
+  DEV_STATE_PATH = join8(STATE_DIR, "dev.json");
+  LOGS_DIR = join8(STATE_DIR, "logs");
+});
+
 // src/lib/network.ts
 function getChainId(network) {
   return CHAIN_IDS[network].decimal.toString();
@@ -32354,7 +32354,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "6.0.0",
+  version: "7.0.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -32605,10 +32605,6 @@ async function runBillingStatus(json) {
 function addBillingCommand(parent) {
   parent.command("billing").description("Show your plan, Stripe subscription, trial, and discounts").option("--json", "Output as JSON").action((options) => runBillingStatus(options.json));
 }
-function registerBillingCommand(program2) {
-  const billing = program2.command("billing").description("Deprecated: use `account billing`");
-  billing.command("status").description("Show your current plan, Stripe subscription, trial, and discounts").option("--json", "Output as JSON").action((options) => runBillingStatus(options.json));
-}
 function renderBillingStatus(res) {
   if (!res.subscription) {
     console.log(formatKeyValue([
@@ -32700,13 +32696,6 @@ function registerAccountCommand(program2) {
   account.command("update").description("Update your public profile").option("--name <name>", "Set display name").option("--bio <bio>", "Set bio").option("--slug <slug>", "Set public URL slug").option("--json", "Output as JSON").action(withErrorHandling(async (options) => applyProfileUpdate(options), {
     action: "update profile"
   }));
-  account.command("profile").description("Deprecated: use `account get` / `account update`").option("--name <name>", "Set display name").option("--bio <bio>", "Set bio").option("--slug <slug>", "Set public URL slug").option("--json", "Output as JSON").action(withErrorHandling(async (options) => {
-    if (options.name || options.bio || options.slug) {
-      await applyProfileUpdate(options);
-    } else {
-      await showProfile(options.json);
-    }
-  }, { action: "manage profile" }));
 }
 // src/commands/config.ts
 init_config();
@@ -32952,7 +32941,7 @@ async function detectStacksNodes() {
 init_output();
 function registerConfigCommand(program2) {
   const config = program2.command("config").description("Manage CLI configuration");
-  config.command("get").alias("show").description("Show current configuration").option("--json", "Output as JSON").action(async (options) => {
+  config.command("get").description("Show current configuration").option("--json", "Output as JSON").action(async (options) => {
     try {
       const cfg = await loadConfig();
       if (options.json) {
@@ -33001,7 +32990,7 @@ Examples:
       process.exit(1);
     }
   });
-  config.command("delete").alias("clear").description("Delete all configuration (remove the config file)").option("-y, --yes", "Skip confirmation").action(async (opts) => {
+  config.command("delete").description("Delete all configuration (remove the config file)").option("-y, --yes", "Skip confirmation").action(async (opts) => {
     try {
       if (!opts.yes && !await confirmDestructive("Delete the config file?")) {
         return;
@@ -33106,20 +33095,97 @@ async function validateDatabaseConnection(url) {
     console.log(dim("The URL was saved but connection failed. Check your database settings."));
   }
 }
-// src/commands/create.ts
-import {
-  copyFileSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  statSync,
-  writeFileSync
-} from "node:fs";
-import { dirname as dirname2, join as join4, relative, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { input, select as select2 } from "@inquirer/prompts";
-import { SecondLayer as SecondLayer2 } from "@secondlayer/sdk";
+// src/commands/status.ts
+init_config();
+init_output();
+function registerStatusCommand(program2) {
+  program2.command("status").description("Show system status").option("--json", "Output as JSON").action(async (options) => {
+    const config = await loadConfig();
+    try {
+      const status = await httpPlatform("/status");
+      output({
+        json: options.json,
+        data: status,
+        human: () => printStatus(status)
+      });
+    } catch (err) {
+      if (err instanceof CliHttpError && err.code === "SESSION_EXPIRED") {
+        console.error("Not logged in. Run: sl login");
+        process.exit(1);
+      }
+      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("");
+      process.exit(1);
+    }
+  });
+}
+function printStatus(status) {
+  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("");
+  console.log(blue("Index Progress"));
+  if (status.indexProgress.length === 0) {
+    console.log(dim("  No data indexed yet"));
+  } else {
+    for (const p of status.indexProgress) {
+      const behind = p.highestSeenBlock - p.lastIndexedBlock;
+      const behindStr = behind > 0 ? yellow(` (${behind} behind)`) : green(" (synced)");
+      console.log(`  ${p.network}: block ${p.lastIndexedBlock}${behindStr}`);
+      if (status.chainTip && status.chainTip > 0) {
+        const pct = Math.min(p.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 = p.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" : ""})`)}`);
+          }
+        }
+      }
+    }
+  }
+  console.log("");
+  if (status.activeSubgraphs !== undefined) {
+    console.log(blue("Activity"));
+    console.log(formatKeyValue([
+      ["  Active Subgraphs", status.activeSubgraphs.toString()]
+    ]));
+    console.log("");
+  }
+  console.log(dim(`Last updated: ${status.timestamp}`));
+}
+// src/commands/subscriptions.ts
+import { confirm } from "@inquirer/prompts";
+import { sign } from "@secondlayer/shared/crypto/standard-webhooks";
 
 // src/lib/filter-params.ts
 var FILTER_OPERATORS = ["eq", "neq", "gt", "gte", "lt", "lte"];
@@ -33187,9 +33253,8 @@ function parseSubscriptionFilter(args) {
   return Object.keys(filters).length > 0 ? filters : undefined;
 }
 
-// src/commands/create.ts
+// src/commands/subscriptions.ts
 init_output();
-init_resolve_auth();
 
 // src/lib/subscription-validation.ts
 import {
@@ -33209,6 +33274,23 @@ async function validateSubscriptionTargetFromApi(client, input) {
   }
 }
 
+// src/commands/create.ts
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  statSync,
+  writeFileSync
+} from "node:fs";
+import { dirname as dirname2, join as join4, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { input, select as select2 } from "@inquirer/prompts";
+import { SecondLayer as SecondLayer2 } from "@secondlayer/sdk";
+init_output();
+init_resolve_auth();
+
 // src/utils/urls.ts
 function deriveBaseUrl(apiUrl) {
   const override = process.env.SL_DASHBOARD_URL?.trim();
@@ -33453,105 +33535,8 @@ function addSubscriptionsCreateCommand(subscriptions) {
     examplePrefix: "sl subscriptions create"
   });
 }
-function registerCreateCommand(program2) {
-  const create = program2.command("create").description("Deprecated: use `sl subscriptions create`");
-  addSubscriptionScaffold(create, "subscription <name>", {
-    description: "Deprecated: use `sl subscriptions create`",
-    examplePrefix: "sl create subscription"
-  });
-}
-// src/commands/status.ts
-init_config();
-init_output();
-function registerStatusCommand(program2) {
-  program2.command("status").description("Show system status").option("--json", "Output as JSON").action(async (options) => {
-    const config = await loadConfig();
-    try {
-      const status = await httpPlatform("/status");
-      output({
-        json: options.json,
-        data: status,
-        human: () => printStatus(status)
-      });
-    } catch (err) {
-      if (err instanceof CliHttpError && err.code === "SESSION_EXPIRED") {
-        console.error("Not logged in. Run: sl login");
-        process.exit(1);
-      }
-      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("");
-      process.exit(1);
-    }
-  });
-}
-function printStatus(status) {
-  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("");
-  console.log(blue("Index Progress"));
-  if (status.indexProgress.length === 0) {
-    console.log(dim("  No data indexed yet"));
-  } else {
-    for (const p of status.indexProgress) {
-      const behind = p.highestSeenBlock - p.lastIndexedBlock;
-      const behindStr = behind > 0 ? yellow(` (${behind} behind)`) : green(" (synced)");
-      console.log(`  ${p.network}: block ${p.lastIndexedBlock}${behindStr}`);
-      if (status.chainTip && status.chainTip > 0) {
-        const pct = Math.min(p.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 = p.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" : ""})`)}`);
-          }
-        }
-      }
-    }
-  }
-  console.log("");
-  if (status.activeSubgraphs !== undefined) {
-    console.log(blue("Activity"));
-    console.log(formatKeyValue([
-      ["  Active Subgraphs", status.activeSubgraphs.toString()]
-    ]));
-    console.log("");
-  }
-  console.log(dim(`Last updated: ${status.timestamp}`));
-}
+
 // src/commands/subscriptions.ts
-import { confirm } from "@inquirer/prompts";
-import { sign } from "@secondlayer/shared/crypto/standard-webhooks";
-init_output();
 function commonOptions(cmd) {
   return cmd.option("--service-key <key>", "SL_SERVICE_KEY override").option("--base-url <url>", "SL_API_URL override");
 }
@@ -34177,375 +34162,10 @@ POST result:`));
     }
   });
 }
-// src/commands/db.ts
-init_config();
-init_dev_state();
-init_output();
-import { confirm as confirm2 } from "@inquirer/prompts";
-import { getDb, sql } from "@secondlayer/shared/db";
-import {
-  countMissingBlocks,
-  findGaps
-} from "@secondlayer/shared/db/queries/integrity";
-import { StacksNodeClient } from "@secondlayer/shared/node";
-var DEV_DATABASE_URL = "postgres://postgres:postgres@localhost:5432/secondlayer_dev";
-function registerDbCommand(program2) {
-  addDbCommand(program2, { deprecated: true });
-}
-function addDbCommand(parent, opts) {
-  const dbCmd = parent.command("db").description(opts?.deprecated ? "Deprecated: use `sl local db`" : "Inspect indexer database tables").addHelpText("after", `
-Subcommands:
-  blocks    Show recent blocks
-  txs       Show recent transactions
-  events    Show recent events
-  gaps      Show gaps in indexed block data
-  truncate  Truncate all indexed data
-  resync    Reset database and restart indexer
-
-Run \`sl db\` with no subcommand to print an overview.`).hook("preAction", async () => {
-    await requireLocalNetwork();
-  }).action(async () => {
-    await showOverview(10);
-  });
-  dbCmd.command("blocks").description("Show recent blocks").option("--limit <n>", "Number of rows", "10").option("--json", "Output as JSON").action(async function() {
-    const opts2 = this.opts();
-    await showBlocks(Number.parseInt(opts2.limit), opts2.json);
-  });
-  dbCmd.command("txs").description("Show recent transactions").option("--limit <n>", "Number of rows", "10").option("--json", "Output as JSON").action(async function() {
-    const opts2 = this.opts();
-    await showTransactions(Number.parseInt(opts2.limit), opts2.json);
-  });
-  dbCmd.command("events").description("Show recent events").option("--limit <n>", "Number of rows", "10").option("--json", "Output as JSON").action(async function() {
-    const opts2 = this.opts();
-    await showEvents(Number.parseInt(opts2.limit), opts2.json);
-  });
-  dbCmd.command("gaps").description("Show gaps in indexed block data").option("--limit <n>", "Number of gaps to show", "50").option("--json", "Output as JSON").action(async function() {
-    const opts2 = this.opts();
-    await showGaps(Number.parseInt(opts2.limit), opts2.json);
-  });
-  dbCmd.command("truncate").alias("reset").description("Truncate all indexed data (blocks, txs, events)").option("-y, --yes", "Skip confirmation prompt").action(async function() {
-    const opts2 = this.opts();
-    await resetDatabase(opts2.yes);
-  });
-  dbCmd.command("resync").description("Reset database and restart indexer for fresh sync").option("-y, --yes", "Skip confirmation prompt").option("--backfill", "After reset, fetch all blocks from node").action(async function() {
-    const opts2 = this.opts();
-    await resyncDatabase(opts2.yes, opts2.backfill);
-  });
-}
-function ensureDb() {
-  if (!process.env.DATABASE_URL) {
-    process.env.DATABASE_URL = DEV_DATABASE_URL;
-  }
-  return getDb();
-}
-async function showOverview(_limit) {
-  try {
-    const db = ensureDb();
-    const blockCountResult = await db.selectFrom("blocks").select(sql`count(*)`.as("count")).executeTakeFirst();
-    const txCountResult = await db.selectFrom("transactions").select(sql`count(*)`.as("count")).executeTakeFirst();
-    const eventCountResult = await db.selectFrom("events").select(sql`count(*)`.as("count")).executeTakeFirst();
-    const blockCount = blockCountResult?.count ?? 0;
-    const txCount = txCountResult?.count ?? 0;
-    const eventCount = eventCountResult?.count ?? 0;
-    const latest = await db.selectFrom("blocks").select(["height", "hash", "timestamp"]).orderBy("height", "desc").limit(1).executeTakeFirst();
-    console.log("");
-    console.log(blue("Database Overview"));
-    console.log("");
-    console.log(`  Blocks:       ${green(blockCount.toString())}`);
-    console.log(`  Transactions: ${green(txCount.toString())}`);
-    console.log(`  Events:       ${green(eventCount.toString())}`);
-    console.log("");
-    if (latest) {
-      const time = new Date(latest.timestamp * 1000).toISOString();
-      console.log(blue("Latest Block"));
-      console.log(`  Height: ${latest.height}`);
-      console.log(`  Hash:   ${dim(latest.hash.slice(0, 20))}...`);
-      console.log(`  Time:   ${time}`);
-      console.log("");
-    }
-    console.log(dim(`Use 'sl db blocks|txs|events' to see records`));
-    console.log("");
-    process.exit(0);
-  } catch (err) {
-    error(`Failed to query database: ${err}`);
-    console.log(dim(`
-Make sure PostgreSQL is running.`));
-    console.log(dim("Run 'sl local start' to start all services."));
-    process.exit(1);
-  }
-}
-async function showBlocks(limit, json) {
-  try {
-    const db = ensureDb();
-    const rows = await db.selectFrom("blocks").select(["height", "hash", "timestamp", "canonical"]).orderBy("height", "desc").limit(limit).execute();
-    if (json) {
-      console.log(JSON.stringify(rows, null, 2));
-      process.exit(0);
-    }
-    console.log("");
-    console.log(blue(`Recent Blocks (${rows.length})`));
-    console.log("");
-    console.log(dim("  HEIGHT".padEnd(10)) + dim("HASH".padEnd(24)) + dim("TIME"));
-    for (const row of rows) {
-      const time = new Date(row.timestamp * 1000).toLocaleTimeString();
-      const canonicalMark = row.canonical ? "" : yellow(" (reorg)");
-      console.log(`  ${row.height.toString().padEnd(10)}${`${row.hash.slice(0, 20)}... `.padEnd(24)}${time}${canonicalMark}`);
-    }
-    console.log("");
-    process.exit(0);
-  } catch (err) {
-    error(`Failed to query blocks: ${err}`);
-    process.exit(1);
-  }
-}
-async function showTransactions(limit, json) {
-  try {
-    const db = ensureDb();
-    const rows = await db.selectFrom("transactions").select([
-      "tx_id",
-      "block_height",
-      "type",
-      "sender",
-      "status",
-      "contract_id",
-      "function_name"
-    ]).orderBy("block_height", "desc").limit(limit).execute();
-    if (json) {
-      console.log(JSON.stringify(rows, null, 2));
-      process.exit(0);
-    }
-    console.log("");
-    console.log(blue(`Recent Transactions (${rows.length})`));
-    console.log("");
-    console.log(dim("  BLOCK".padEnd(8)) + dim("TYPE".padEnd(18)) + dim("SENDER".padEnd(20)) + dim("CONTRACT/FUNCTION"));
-    for (const row of rows) {
-      const statusColor = row.status === "success" ? green : yellow;
-      const contractInfo = row.contract_id ? `${row.contract_id.split(".")[1] || row.contract_id}${row.function_name ? `::${row.function_name}` : ""}` : "-";
-      console.log(`  ${statusColor(row.block_height.toString().padEnd(8))}${row.type.padEnd(18)}${`${row.sender.slice(0, 18)}... `.padEnd(20)}${contractInfo}`);
-    }
-    console.log("");
-    process.exit(0);
-  } catch (err) {
-    error(`Failed to query transactions: ${err}`);
-    process.exit(1);
-  }
-}
-async function showEvents(limit, json) {
-  try {
-    const db = ensureDb();
-    const rows = await db.selectFrom("events").select(["block_height", "tx_id", "event_index", "type", "data"]).orderBy("block_height", "desc").limit(limit).execute();
-    if (json) {
-      console.log(JSON.stringify(rows, null, 2));
-      process.exit(0);
-    }
-    console.log("");
-    console.log(blue(`Recent Events (${rows.length})`));
-    console.log("");
-    if (rows.length === 0) {
-      console.log(dim("  No events found"));
-      console.log("");
-      process.exit(0);
-    }
-    console.log(dim("  BLOCK".padEnd(8)) + dim("INDEX".padEnd(8)) + dim("TYPE".padEnd(24)) + dim("TX"));
-    for (const row of rows) {
-      console.log(`  ${row.block_height.toString().padEnd(8)}` + `${row.event_index.toString().padEnd(8)}` + `${row.type.padEnd(24)}` + `${row.tx_id.slice(0, 16)}...`);
-    }
-    console.log("");
-    process.exit(0);
-  } catch (err) {
-    error(`Failed to query events: ${err}`);
-    process.exit(1);
-  }
-}
-async function showGaps(limit, json) {
-  try {
-    const db = ensureDb();
-    const gaps = await findGaps(db, limit);
-    const missing = await countMissingBlocks(db);
-    if (json) {
-      console.log(JSON.stringify({ gaps, totalMissingBlocks: missing }, null, 2));
-      process.exit(0);
-    }
-    console.log("");
-    if (gaps.length === 0) {
-      console.log(green("No gaps detected — block data is contiguous"));
-      console.log("");
-      process.exit(0);
-    }
-    console.log(blue(`Block Gaps (${gaps.length})`));
-    console.log("");
-    console.log(dim("  GAP_START".padEnd(14)) + dim("GAP_END".padEnd(14)) + dim("SIZE"));
-    for (const gap of gaps) {
-      console.log(`  ${gap.gapStart.toString().padEnd(14)}` + `${gap.gapEnd.toString().padEnd(14)}` + `${gap.size}`);
-    }
-    console.log("");
-    console.log(`${yellow(gaps.length.toString())} gaps, ${red(missing.toString())} missing blocks`);
-    console.log("");
-    process.exit(0);
-  } catch (err) {
-    error(`Failed to query gaps: ${err}`);
-    process.exit(1);
-  }
-}
-async function resetDatabase(skipConfirm) {
-  try {
-    const db = ensureDb();
-    const blockCount = (await db.selectFrom("blocks").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
-    const txCount = (await db.selectFrom("transactions").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
-    const eventCount = (await db.selectFrom("events").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
-    console.log("");
-    console.log(yellow("This will delete all indexed blockchain data:"));
-    console.log("");
-    console.log(`  ${red(blockCount.toString())} blocks`);
-    console.log(`  ${red(txCount.toString())} transactions`);
-    console.log(`  ${red(eventCount.toString())} events`);
-    console.log(`  ${dim("+ index_progress")}`);
-    console.log("");
-    console.log(dim("Note: Subgraph configurations will be preserved."));
-    console.log("");
-    if (!skipConfirm) {
-      const confirmed = await confirm2({
-        message: "Are you sure you want to reset the database?",
-        default: false
-      });
-      if (!confirmed) {
-        info("Cancelled");
-        process.exit(0);
-      }
-    }
-    info("Truncating tables...");
-    await sql`TRUNCATE TABLE events, transactions, blocks, index_progress RESTART IDENTITY CASCADE`.execute(db);
-    console.log("");
-    success("Database reset complete");
-    console.log("");
-    console.log(dim("Run 'sl local restart' to restart the indexer for fresh sync."));
-    console.log("");
-    process.exit(0);
-  } catch (err) {
-    error(`Failed to reset database: ${err}`);
-    process.exit(1);
-  }
-}
-async function resyncDatabase(skipConfirm, backfill) {
-  try {
-    const db = ensureDb();
-    const blockCount = (await db.selectFrom("blocks").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
-    console.log("");
-    console.log(yellow("This will:"));
-    console.log(`  1. Delete all indexed data (${red(blockCount.toString())} blocks)`);
-    console.log("  2. Restart the indexer for fresh sync");
-    if (backfill) {
-      console.log("  3. Fetch all blocks from node (backfill)");
-    }
-    console.log("");
-    console.log(dim("Note: Subgraph configurations will be preserved."));
-    console.log("");
-    if (!skipConfirm) {
-      const confirmed = await confirm2({
-        message: "Are you sure you want to resync?",
-        default: false
-      });
-      if (!confirmed) {
-        info("Cancelled");
-        process.exit(0);
-      }
-    }
-    info("Truncating tables...");
-    await sql`TRUNCATE TABLE events, transactions, blocks, index_progress RESTART IDENTITY CASCADE`.execute(db);
-    console.log(green("  ✓ Database reset"));
-    const state = await loadDevState();
-    if (state?.services?.indexer && isProcessRunning(state.services.indexer.pid)) {
-      info("Restarting indexer...");
-      try {
-        process.kill(state.services.indexer.pid, "SIGTERM");
-        await Bun.sleep(1000);
-      } catch {}
-      if (isProcessRunning(state.services.indexer.pid)) {
-        try {
-          process.kill(state.services.indexer.pid, "SIGKILL");
-        } catch {}
-      }
-      console.log(green("  ✓ Indexer stopped"));
-      console.log("");
-      info("Run 'sl local restart' to start fresh sync");
-    } else {
-      console.log("");
-      success("Database reset complete");
-      console.log("");
-      if (!backfill) {
-        console.log(dim("Indexer not running. Start with 'sl local start' to begin sync."));
-      }
-    }
-    if (backfill) {
-      console.log("");
-      info("Starting backfill from node...");
-      const nodeClient = new StacksNodeClient;
-      const healthy = await nodeClient.isHealthy();
-      if (!healthy) {
-        warn(`Cannot reach Stacks node at ${nodeClient.getRpcUrl()}`);
-        console.log(dim("Run 'sl sync --from 1 --to <tip>' manually once the node is available."));
-        console.log("");
-        process.exit(0);
-      }
-      const nodeInfo = await nodeClient.getInfo();
-      const tip = nodeInfo.stacks_tip_height;
-      info(`Node tip: block ${tip}. Fetching blocks 1 to ${tip}...`);
-      console.log(dim(`This may take a while. Run 'sl sync --from 1 --to ${tip}' if interrupted.`));
-      console.log("");
-      const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config(), exports_config));
-      const config = await loadConfig2();
-      const indexerUrl = process.env.INDEXER_URL || `http://localhost:${config.ports.indexer}`;
-      const concurrency = 5;
-      let fetched = 0;
-      let errors = 0;
-      for (let i = 1;i <= tip; i += concurrency) {
-        const batch = [];
-        for (let j = i;j < i + concurrency && j <= tip; j++) {
-          batch.push(j);
-        }
-        const results = await Promise.allSettled(batch.map(async (height) => {
-          const block = await nodeClient.getBlock(height);
-          if (!block)
-            throw new Error(`Block ${height} not found`);
-          const res = await fetch(`${indexerUrl}/new_block`, {
-            method: "POST",
-            headers: {
-              "Content-Type": "application/json",
-              "X-Source": "backfill"
-            },
-            body: JSON.stringify(block)
-          });
-          if (!res.ok)
-            throw new Error(`Indexer rejected block ${height}: ${res.status}`);
-        }));
-        for (const r of results) {
-          if (r.status === "fulfilled")
-            fetched++;
-          else
-            errors++;
-        }
-        const pct = Math.round((fetched + errors) / tip * 100);
-        process.stdout.write(`\r  ${green(`${fetched}`)} fetched, ${errors > 0 ? red(`${errors} errors`) : "0 errors"} (${pct}%)`);
-      }
-      console.log("");
-      console.log("");
-      if (errors === 0) {
-        success(`Backfill complete: ${fetched} blocks indexed`);
-      } else {
-        warn(`Backfill complete: ${fetched} indexed, ${errors} errors`);
-      }
-    }
-    console.log("");
-    process.exit(0);
-  } catch (err) {
-    error(`Failed to resync: ${err}`);
-    process.exit(1);
-  }
-}
 // src/commands/devnet.ts
 import { spawnSync } from "node:child_process";
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname4, join as join7 } from "node:path";
+import { dirname as dirname4, join as join6 } from "node:path";
 
 // src/lib/devnet-compose.ts
 var DEFAULT_IMAGE_OWNER = "ryanwaits";
@@ -34688,14 +34308,14 @@ volumes:
 
 // src/lib/devnet-config.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { dirname as dirname3, join as join6, parse as parsePath } from "node:path";
+import { dirname as dirname3, join as join5, parse as parsePath } from "node:path";
 import { parse as parseToml } from "smol-toml";
 var DEFAULT_INDEXER_OBSERVER = "host.docker.internal:3700";
 function findClarinetProject(startDir) {
   let dir = startDir;
   const { root } = parsePath(dir);
   while (true) {
-    if (existsSync2(join6(dir, "Clarinet.toml")))
+    if (existsSync2(join5(dir, "Clarinet.toml")))
       return dir;
     if (dir === root)
       return null;
@@ -34742,7 +34362,7 @@ stacks_node_events_observers = [${entry}]
 
 // src/commands/devnet.ts
 init_output();
-var COMPOSE_REL = join7(".secondlayer", "docker-compose.yml");
+var COMPOSE_REL = join6(".secondlayer", "docker-compose.yml");
 function ensureDocker() {
   const probe = spawnSync("docker", ["info"], { stdio: "ignore" });
   if (probe.error || probe.status !== 0) {
@@ -34780,13 +34400,13 @@ function registerDevnetCommand(program2) {
   devnet.command("status").description("Snapshot of the local stack: ingest, subgraphs, and recent activity").option("-w, --watch", "Refresh every 2s until Ctrl-C").option("--limit <n>", "Recent activity rows to show", "12").action(async (options) => {
     await status(options);
   });
-  devnet.command("logs [service]").description("Tail stack logs — all services, or one of: indexer, api, subgraph-processor, postgres").option("--project <dir>", "Clarinet project directory").option("-f, --follow", "Follow log output").option("-n, --lines <n>", "Lines to show from the end of each log").option("--tail <n>", "Deprecated alias for --lines").action(async (service, options) => {
+  devnet.command("logs [service]").description("Tail stack logs — all services, or one of: indexer, api, subgraph-processor, postgres").option("--project <dir>", "Clarinet project directory").option("-f, --follow", "Follow log output").option("-n, --lines <n>", "Lines to show from the end of each log").action(async (service, options) => {
     await logs(service, options);
   });
 }
 function resolveProject(explicit) {
   if (explicit) {
-    if (!existsSync3(join7(explicit, "Clarinet.toml"))) {
+    if (!existsSync3(join6(explicit, "Clarinet.toml"))) {
       error(`No Clarinet.toml in ${explicit}`);
       process.exit(1);
     }
@@ -34802,7 +34422,7 @@ function resolveProject(explicit) {
 }
 async function connect(options) {
   const project = resolveProject(options.project);
-  const devnetToml = join7(project, "settings", "Devnet.toml");
+  const devnetToml = join6(project, "settings", "Devnet.toml");
   mkdirSync2(dirname4(devnetToml), { recursive: true });
   const result = ensureEventObserver(devnetToml, DEFAULT_INDEXER_OBSERVER);
   console.log(`${green("✓")} found Clarinet.toml`);
@@ -34812,7 +34432,7 @@ async function connect(options) {
     console.log(`${green("✓")} ${result.status === "created" ? "created" : "patched"} settings/Devnet.toml`);
     console.log(dim(`    + stacks_node_events_observers = ["${DEFAULT_INDEXER_OBSERVER}"]`));
   }
-  const composePath = join7(project, COMPOSE_REL);
+  const composePath = join6(project, COMPOSE_REL);
   mkdirSync2(dirname4(composePath), { recursive: true });
   writeFileSync3(composePath, buildDevnetCompose({ owner: options.owner, imageTag: options.imageTag }));
   console.log(`${green("✓")} wrote ${COMPOSE_REL}`);
@@ -34836,13 +34456,13 @@ ${bold("Secondlayer stack up")}`);
   console.log(`
 ${bold("Next:")}`);
   console.log(`  ${yellow("clarinet devnet start")}   ${dim("# auto-deploys + streams to the indexer")}`);
-  console.log(`  ${yellow("SL_API_URL=http://localhost:3800 SL_SERVICE_KEY=dummy sl subgraphs deploy ./subgraph.ts")}`);
+  console.log(`  ${yellow("SL_API_URL=http://localhost:3800 SL_API_KEY=dummy sl subgraphs deploy ./subgraph.ts")}`);
   console.log(dim(`
 Stop with: sl devnet down`));
 }
 async function down(options) {
   const project = resolveProject(options.project);
-  const composePath = join7(project, COMPOSE_REL);
+  const composePath = join6(project, COMPOSE_REL);
   if (!existsSync3(composePath)) {
     error(`No ${COMPOSE_REL} in ${project} — nothing to stop. Run \`sl devnet connect\` first.`);
     process.exit(1);
@@ -34857,7 +34477,7 @@ async function down(options) {
 }
 async function logs(service, options) {
   const project = resolveProject(options.project);
-  const composePath = join7(project, COMPOSE_REL);
+  const composePath = join6(project, COMPOSE_REL);
   if (!existsSync3(composePath)) {
     error(`No ${COMPOSE_REL} in ${project} — run \`sl devnet connect\` first.`);
     process.exit(1);
@@ -34867,7 +34487,7 @@ async function logs(service, options) {
     process.exit(1);
   }
   ensureDocker();
-  const args = ["logs", "--tail", options.lines ?? options.tail ?? "200"];
+  const args = ["logs", "--tail", options.lines ?? "200"];
   if (options.follow)
     args.push("-f");
   if (service)
@@ -34984,9 +34604,9 @@ import {
   watch,
   writeFileSync as writeFileSync4
 } from "node:fs";
-import { dirname as dirname5, join as join8, resolve as resolve2 } from "node:path";
+import { dirname as dirname5, join as join7, resolve as resolve2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { confirm as confirm4 } from "@inquirer/prompts";
+import { confirm as confirm3 } from "@inquirer/prompts";
 
 // src/generators/subgraph-scaffold.ts
 init_format();
@@ -35249,7 +34869,7 @@ init_fs();
 init_output();
 
 // src/commands/login.ts
-import { confirm as confirm3, input as input2 } from "@inquirer/prompts";
+import { confirm as confirm2, input as input2 } from "@inquirer/prompts";
 init_output();
 init_session();
 function sessionExpiry() {
@@ -35293,7 +34913,7 @@ async function runLoginFlow(options = {}) {
         return;
       }
       try {
-        const proceed = await confirm3({
+        const proceed = await confirm2({
           message: "Log in as a different user?",
           default: false
         });
@@ -35764,7 +35384,7 @@ async function loadSubgraphWithDepCheck(absPath) {
     if (!missingSdk)
       throw err;
     warn("Missing dependency: @secondlayer/subgraphs");
-    const install = await confirm4({
+    const install = await confirm3({
       message: "Install with `bun add @secondlayer/subgraphs`?",
       default: true
     });
@@ -35833,6 +35453,35 @@ async function writeOrPrintSubgraphSpec(spec, format, output2) {
   await writeTextFile(outPath, text);
   success(`Created ${outPath}`);
 }
+async function specFromLocalFile(absPath, format, specOptions) {
+  const { readFile: readFile3 } = await import("node:fs/promises");
+  const { bundleSubgraphCode } = await import("@secondlayer/bundler");
+  const { generateSubgraphSQL } = await import("@secondlayer/subgraphs");
+  const {
+    generateSubgraphAgentSchema,
+    generateSubgraphMarkdown,
+    generateSubgraphOpenApi
+  } = await import("@secondlayer/shared/subgraphs/spec");
+  const source = await readFile3(absPath, "utf8");
+  const bundled = await bundleSubgraphCode(source);
+  const { hash } = generateSubgraphSQL({
+    name: bundled.name,
+    version: bundled.version,
+    description: bundled.description,
+    sources: bundled.sources,
+    schema: bundled.schema,
+    handlers: {}
+  });
+  const detail = createLocalSubgraphDetail({
+    name: bundled.name,
+    version: bundled.version,
+    description: bundled.description,
+    sources: bundled.sources,
+    schema: bundled.schema,
+    schemaHash: hash
+  });
+  return format === "openapi" ? generateSubgraphOpenApi(detail, specOptions) : format === "agent" ? generateSubgraphAgentSchema(detail, specOptions) : generateSubgraphMarkdown(detail, specOptions);
+}
 function createLocalSubgraphDetail(input3) {
   const tables = {};
   for (const [tableName, rawTable] of Object.entries(input3.schema)) {
@@ -35907,7 +35556,7 @@ function readCliSubgraphsDependency() {
   return "^1.3.2";
 }
 function ensureScaffoldPackageJson(dir) {
-  const packagePath = join8(dir, "package.json");
+  const packagePath = join7(dir, "package.json");
   const subgraphsDep = readCliSubgraphsDependency();
   if (!existsSync4(packagePath)) {
     writeFileSync4(packagePath, `${JSON.stringify({
@@ -36025,7 +35674,7 @@ function formatSubgraphSync(sync) {
 }
 function registerSubgraphsCommand(program2) {
   const subgraphs = program2.command("subgraphs").description("Manage materialized subgraphs");
-  subgraphs.command("create <name>").alias("new").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>", `Foundation Dataset starter (one of: ${SUBGRAPH_TEMPLATE_SLUGS.join(", ")})`).addHelpText("after", `
 Examples:
   $ sl subgraphs new my-graph
   $ sl subgraphs new token-balances --template sip-010-balances`).action(async (name, opts) => {
@@ -36070,9 +35719,9 @@ ${SUBGRAPH_TEMPLATE_SLUGS.map((s) => `  ${s.padEnd(20)} ${SUBGRAPH_TEMPLATE_DESC
         const def = mod.default ?? mod;
         const { validateSubgraphDefinition } = await import("@secondlayer/subgraphs/validate");
         const { deploySchema } = await import("@secondlayer/subgraphs");
-        const { getDb: getDb2 } = await import("@secondlayer/shared/db");
+        const { getDb } = await import("@secondlayer/shared/db");
         validateSubgraphDefinition(def);
-        const db = getDb2();
+        const db = getDb();
         const result = await deploySchema(db, def, absPath, {
           forceReindex: false
         });
@@ -36114,14 +35763,14 @@ Stopped watching.`);
     });
     await new Promise(() => {});
   });
-  subgraphs.command("deploy <file>").description("Deploy a subgraph definition file").option("--start-block <n>", "Override the subgraph definition startBlock for this deploy").option("--dry-run", "Validate and preview deploy without writing changes").option("--preview", "Deprecated alias for --dry-run").option("-y, --yes", "Skip the reindex confirmation prompt").option("--force", "Deprecated alias for --yes").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)").action(async (file, options2) => {
+  subgraphs.command("deploy <file>").description("Deploy a subgraph definition file").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)").action(async (file, options2) => {
     try {
       const absPath = resolve2(file);
       const config = await loadConfig();
       if (config.network !== "local") {
         await requireAuth();
       }
-      const dryRun = options2.dryRun || options2.preview;
+      const dryRun = options2.dryRun;
       const startBlock = parseStartBlockOption(options2.startBlock);
       if (startBlock !== undefined) {
         warn(`--start-block ${startBlock} overrides the definition's startBlock for this deploy.`);
@@ -36204,7 +35853,7 @@ Stopped watching.`);
               info(`  + columns: ${t}.${cols.join(", ")}`);
             }
           }
-          const confirmed = options2.yes || options2.force || await confirm4({
+          const confirmed = options2.yes || await confirm3({
             message: "⚠  This will drop all data and reindex from scratch. Continue?"
           });
           if (!confirmed) {
@@ -36238,8 +35887,8 @@ Stopped watching.`);
           return;
         }
         const { deploySchema } = await import("@secondlayer/subgraphs");
-        const { getDb: getDb2, closeDb } = await import("@secondlayer/shared/db");
-        const db = getDb2();
+        const { getDb, closeDb } = await import("@secondlayer/shared/db");
+        const db = getDb();
         const result = await deploySchema(db, effectiveDef, absPath, {
           version: undefined,
           forceReindex: startBlock !== undefined
@@ -36355,64 +36004,24 @@ Synced — exiting watch.`));
       handleApiError(err, "get subgraph status");
     }
   });
-  subgraphs.command("spec <name>").description("Output API documentation for a deployed subgraph").option("--format <format>", "Output format: openapi, agent, markdown", "openapi").option("-o, --output <path>", "Write output to a file").option("--server <url>", "Override the server URL in generated docs").action(async (name, options2) => {
+  subgraphs.command("spec <nameOrFile>").description("Output API documentation for a deployed subgraph or a local subgraph file").option("--format <format>", "Output format: openapi, agent, markdown", "openapi").option("-o, --output <path>", "Write output to a file").option("--server <url>", "Override the server URL in generated docs").action(async (nameOrFile, options2) => {
     try {
       const format = parseSubgraphSpecFormat(options2.format);
       const specOptions = options2.server ? { serverUrl: options2.server } : undefined;
-      const spec = format === "openapi" ? await getSubgraphOpenApi(name, specOptions) : format === "agent" ? await getSubgraphAgentSchema(name, specOptions) : await getSubgraphMarkdown(name, specOptions);
-      await writeOrPrintSubgraphSpec(spec, format, options2.output);
-    } catch (err) {
-      if (err instanceof Error && err.message.startsWith("--format")) {
-        error(err.message);
-        process.exit(1);
-      }
-      handleApiError(err, "generate subgraph spec");
-    }
-  });
-  subgraphs.command("inspect <file>").description("Output API documentation for a local subgraph file").option("--format <format>", "Output format: openapi, agent, markdown", "agent").option("-o, --output <path>", "Write output to a file").option("--server <url>", "Override the server URL in generated docs").action(async (file, options2) => {
-    try {
-      const format = parseSubgraphSpecFormat(options2.format);
-      const absPath = resolve2(file);
-      if (!existsSync4(absPath)) {
+      const absPath = resolve2(nameOrFile);
+      if (nameOrFile.endsWith(".ts") && !existsSync4(absPath)) {
         error(`File not found: ${absPath}`);
         process.exit(1);
       }
-      const { readFile: readFile3 } = await import("node:fs/promises");
-      const { bundleSubgraphCode } = await import("@secondlayer/bundler");
-      const { generateSubgraphSQL } = await import("@secondlayer/subgraphs");
-      const {
-        generateSubgraphAgentSchema,
-        generateSubgraphMarkdown,
-        generateSubgraphOpenApi
-      } = await import("@secondlayer/shared/subgraphs/spec");
-      const source = await readFile3(absPath, "utf8");
-      const bundled = await bundleSubgraphCode(source);
-      const { hash } = generateSubgraphSQL({
-        name: bundled.name,
-        version: bundled.version,
-        description: bundled.description,
-        sources: bundled.sources,
-        schema: bundled.schema,
-        handlers: {}
-      });
-      const detail = createLocalSubgraphDetail({
-        name: bundled.name,
-        version: bundled.version,
-        description: bundled.description,
-        sources: bundled.sources,
-        schema: bundled.schema,
-        schemaHash: hash
-      });
-      const specOptions = options2.server ? { serverUrl: options2.server } : undefined;
-      const spec = format === "openapi" ? generateSubgraphOpenApi(detail, specOptions) : format === "agent" ? generateSubgraphAgentSchema(detail, specOptions) : generateSubgraphMarkdown(detail, specOptions);
+      const isLocalFile = nameOrFile.endsWith(".ts");
+      const spec = isLocalFile ? await specFromLocalFile(absPath, format, specOptions) : format === "openapi" ? await getSubgraphOpenApi(nameOrFile, specOptions) : format === "agent" ? await getSubgraphAgentSchema(nameOrFile, specOptions) : await getSubgraphMarkdown(nameOrFile, specOptions);
       await writeOrPrintSubgraphSpec(spec, format, options2.output);
     } catch (err) {
       if (err instanceof Error && err.message.startsWith("--format")) {
         error(err.message);
         process.exit(1);
       }
-      error(`Failed to inspect subgraph: ${err}`);
-      process.exit(1);
+      handleApiError(err, "generate subgraph spec");
     }
   });
   subgraphs.command("codegen <file>").description("Generate an ORM schema (Prisma or Drizzle) for a subgraph's tables — point it at your BYO database").option("--target <orm>", "ORM target: prisma | drizzle", "prisma").option("--schema <name>", "Postgres schema name (defaults to subgraph_<name>)").option("--env <var>", "datasource url env var", "DATABASE_URL").option("--models-only", "Emit only Prisma models (compose via prismaSchemaFolder)").option("-o, --output <path>", "Write to a file (defaults to stdout)").action(async (file, options2) => {
@@ -36457,13 +36066,13 @@ Synced — exiting watch.`));
       process.exit(1);
     }
   });
-  subgraphs.command("reindex <name>").description("Reindex a subgraph from historical blocks (drops + reprocesses)").option("--from-block <n>", "Start block height").option("--to-block <n>", "End block height").option("--from <n>", "Deprecated alias for --from-block").option("--to <n>", "Deprecated alias for --to-block").option("-y, --yes", "Skip confirmation").addHelpText("after", `
+  subgraphs.command("reindex <name>").description("Reindex a subgraph from historical blocks (drops + reprocesses)").option("--from-block <n>", "Start block height").option("--to-block <n>", "End block height").option("-y, --yes", "Skip confirmation").addHelpText("after", `
 Examples:
   $ sl subgraphs reindex my-graph -y
   $ sl subgraphs reindex my-graph --from-block 150000 --to-block 160000 -y`).action(async (name, options2) => {
     try {
-      const fromRaw = options2.fromBlock ?? options2.from;
-      const toRaw = options2.toBlock ?? options2.to;
+      const fromRaw = options2.fromBlock;
+      const toRaw = options2.toBlock;
       const fromBlock = fromRaw ? Number.parseInt(fromRaw, 10) : undefined;
       const toBlock = toRaw ? Number.parseInt(toRaw, 10) : undefined;
       if (!options2.yes) {
@@ -36471,11 +36080,11 @@ Examples:
           error("Interactive prompt unavailable (stdin is not a TTY). Re-run with -y to skip confirmation.");
           process.exit(1);
         }
-        const { confirm: confirm5 } = await import("@inquirer/prompts");
+        const { confirm: confirm4 } = await import("@inquirer/prompts");
         const range = fromBlock !== undefined && toBlock !== undefined ? ` for blocks [${fromBlock}, ${toBlock}]` : fromBlock !== undefined ? ` from block ${fromBlock}` : toBlock !== undefined ? ` up to block ${toBlock}` : "";
         let ok = false;
         try {
-          ok = await confirm5({
+          ok = await confirm4({
             message: `Reindex subgraph "${name}"${range}? Existing rows in this range will be dropped and reprocessed.`,
             default: false
           });
@@ -36503,12 +36112,12 @@ Examples:
       handleApiError(err, "reindex subgraph");
     }
   });
-  subgraphs.command("backfill <name>").description("Backfill a block range without dropping existing data").option("--from-block <n>", "Start block height").option("--to-block <n>", "End block height").option("--from <n>", "Deprecated alias for --from-block").option("--to <n>", "Deprecated alias for --to-block").addHelpText("after", `
+  subgraphs.command("backfill <name>").description("Backfill a block range without dropping existing data").option("--from-block <n>", "Start block height").option("--to-block <n>", "End block height").addHelpText("after", `
 Examples:
   $ sl subgraphs backfill my-graph --from-block 150000 --to-block 160000`).action(async (name, options2) => {
     try {
-      const fromRaw = options2.fromBlock ?? options2.from;
-      const toRaw = options2.toBlock ?? options2.to;
+      const fromRaw = options2.fromBlock;
+      const toRaw = options2.toBlock;
       if (!fromRaw || !toRaw) {
         error("--from-block and --to-block are required");
         process.exit(1);
@@ -36530,7 +36139,7 @@ Examples:
       handleApiError(err, "backfill subgraph");
     }
   });
-  subgraphs.command("cancel <name>").alias("stop").description("Cancel a running reindex or backfill operation").action(async (name) => {
+  subgraphs.command("cancel <name>").description("Cancel a running reindex or backfill operation").action(async (name) => {
     try {
       info(`Stopping operation for subgraph "${name}"...`);
       const result = await stopSubgraphApi(name);
@@ -36633,10 +36242,10 @@ ${rows.length} row(s)`));
           error("Interactive prompt unavailable (stdin is not a TTY). Re-run with -y to skip confirmation.");
           process.exit(1);
         }
-        const { confirm: confirm5 } = await import("@inquirer/prompts");
+        const { confirm: confirm4 } = await import("@inquirer/prompts");
         let ok = false;
         try {
-          ok = await confirm5({
+          ok = await confirm4({
             message: `Delete subgraph "${name}" and all its data? This cannot be undone.`
           });
         } catch (promptErr) {
@@ -36754,185 +36363,6 @@ Examples:
     }
   });
 }
-// src/commands/stack.ts
-init_config();
-init_dev_state();
-init_docker();
-init_network();
-init_node_manager();
-init_output();
-function registerStackCommand(program2) {
-  const stack = program2.command("stack").description("Manage the full stack");
-  stack.command("start").description("Start the full stack (node + dev services)").option("--no-node", "Skip starting the Stacks node").option("--no-dev", "Skip starting dev services").hook("preAction", async () => {
-    await requireLocalNetwork();
-  }).action(async (options2) => {
-    await stackStart(options2);
-  });
-  stack.command("stop").description("Stop the full stack").option("--no-node", "Skip stopping the Stacks node").option("--no-dev", "Skip stopping dev services").option("--wait", "Wait for in-flight work to drain before stopping").hook("preAction", async () => {
-    await requireLocalNetwork();
-  }).action(async (options2) => {
-    await stackStop(options2);
-  });
-  stack.command("restart").description("Restart the full stack").option("--no-node", "Skip restarting the Stacks node").option("--no-dev", "Skip restarting dev services").hook("preAction", async () => {
-    await requireLocalNetwork();
-  }).action(async (options2) => {
-    await stackStop({ ...options2, wait: false });
-    await stackStart(options2);
-  });
-}
-async function stackStart(options2) {
-  const config = await loadConfig();
-  try {
-    await requireDocker();
-  } catch (err) {
-    if (err instanceof DockerNotAvailableError) {
-      error(err.message);
-      process.exit(1);
-    }
-    throw err;
-  }
-  const network = process.env.STACKS_NETWORK ?? config.node?.network ?? "mainnet";
-  const validation = await validateNetworkConsistency(config);
-  if (!validation.valid) {
-    error("Network mismatch detected:");
-    for (const issue of validation.issues) {
-      console.log(red(`  - ${issue}`));
-    }
-    console.log("");
-    console.log(dim("Fix your config or stop mismatched containers first."));
-    process.exit(1);
-  }
-  console.log("");
-  console.log(blue("Starting Secondlayer Stack"));
-  console.log(dim(`  Network: ${network}`));
-  console.log("");
-  if (options2.node) {
-    const nodePath = config.node?.installPath;
-    if (!nodePath) {
-      warn("No node configured, skipping. Run 'sl local node setup' to configure.");
-    } else if (await isNodeRunning()) {
-      info("Node already running");
-    } else {
-      info("Starting Stacks node...");
-      const started = await startNodeContainers(nodePath, network);
-      if (!started) {
-        error("Failed to start node containers");
-        process.exit(1);
-      }
-      success("Node containers started");
-      info("Waiting for node RPC...");
-      let rpcReady = false;
-      for (let i = 0;i < 60; i++) {
-        try {
-          const res = await fetch("http://localhost:20443/v2/info", {
-            signal: AbortSignal.timeout(2000)
-          });
-          if (res.ok) {
-            rpcReady = true;
-            break;
-          }
-        } catch {}
-        await Bun.sleep(1000);
-      }
-      if (rpcReady) {
-        success("Node RPC responsive");
-        const postValidation = await validateNetworkConsistency(config);
-        if (!postValidation.valid) {
-          warn("Post-start chain ID mismatch:");
-          for (const issue of postValidation.issues) {
-            console.log(yellow(`  - ${issue}`));
-          }
-        }
-      } else {
-        warn("Node RPC not responsive after 60s (may still be starting)");
-      }
-    }
-    console.log("");
-  }
-  if (options2.dev) {
-    if (await isDevRunning()) {
-      info("Dev services already running");
-    } else {
-      const args = [
-        "bun",
-        "run",
-        `${import.meta.dir}/../../bin/secondlayer.ts`,
-        "dev",
-        "start"
-      ];
-      if (config.node?.installPath) {
-        args.push("--stacks-node");
-      }
-      info("Starting dev services...");
-      const proc = Bun.spawn(args, {
-        stdin: "inherit",
-        stdout: "inherit",
-        stderr: "inherit"
-      });
-      await proc.exited;
-    }
-  }
-  console.log("");
-  success("Stack started");
-  console.log(dim("Run 'sl status' to check health"));
-  console.log("");
-}
-async function stackStop(options2) {
-  console.log("");
-  info("Stopping Secondlayer Stack...");
-  if (options2.dev) {
-    if (await isDevRunning()) {
-      info("Stopping dev services...");
-      const proc = Bun.spawn([
-        "bun",
-        "run",
-        `${import.meta.dir}/../../bin/secondlayer.ts`,
-        "dev",
-        "stop"
-      ], { stdin: "inherit", stdout: "inherit", stderr: "inherit" });
-      await proc.exited;
-    } else {
-      info("Dev services not running");
-    }
-  }
-  if (options2.node) {
-    if (await isNodeRunning()) {
-      info("Stopping node containers...");
-      const stopped = await stopNodeContainers();
-      if (stopped.length > 0) {
-        success(`Stopped: ${stopped.join(", ")}`);
-      }
-    } else {
-      info("Node not running");
-    }
-  }
-  try {
-    const result = await Bun.$`docker ps -a --format json --filter "name=secondlayer-dev" --filter "name=stacks"`.quiet().nothrow();
-    if (result.exitCode === 0) {
-      const lines = result.stdout.toString().trim().split(`
-`).filter(Boolean);
-      const orphans = [];
-      for (const line of lines) {
-        try {
-          const c = JSON.parse(line);
-          const name = c.Names || c.Name;
-          if (name && c.Status?.includes("Exited")) {
-            orphans.push(name);
-          }
-        } catch {}
-      }
-      if (orphans.length > 0) {
-        info(`Cleaning up ${orphans.length} orphaned container(s)...`);
-        for (const name of orphans) {
-          await Bun.$`docker rm ${name}`.quiet().nothrow();
-        }
-      }
-    }
-  } catch {}
-  console.log("");
-  success("Stack stopped");
-  console.log("");
-}
 // src/commands/streams.ts
 init_output();
 init_resolve_auth();
@@ -37005,7 +36435,7 @@ function registerStreamsCommand(program2) {
       process.exit(1);
     }
   });
-  streams.command("events").description("List events (cursor-paginated; one page per call)").option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")})`).option("--contract-id <id>", "filter to a single contract identifier").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--from-block <n>", "filter to blocks >= n").option("--to-block <n>", "filter to blocks <= n").option("--from-height <n>", "Deprecated alias for --from-block").option("--to-height <n>", "Deprecated alias for --to-block").option("--limit <n>", "page size (1-1000, default 100)", "100").addHelpText("after", `
+  streams.command("events").description("List events (cursor-paginated; one page per call)").option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")})`).option("--contract-id <id>", "filter to a single contract identifier").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--from-block <n>", "filter to blocks >= n").option("--to-block <n>", "filter to blocks <= n").option("--limit <n>", "page size (1-1000, default 100)", "100").addHelpText("after", `
 Examples:
   $ sl streams events --types stx_transfer,print --limit 50
   $ sl streams events --contract-id SP00....token --from-block 150000 --to-block 160000
@@ -37015,8 +36445,8 @@ Examples:
         types: parseTypes(options2.types),
         contractId: options2.contractId,
         cursor: options2.cursor,
-        fromHeight: parseHeight(options2.fromBlock ?? options2.fromHeight, "--from-block"),
-        toHeight: parseHeight(options2.toBlock ?? options2.toHeight, "--to-block"),
+        fromHeight: parseHeight(options2.fromBlock, "--from-block"),
+        toHeight: parseHeight(options2.toBlock, "--to-block"),
         limit: parseLimit(options2.limit)
       });
       writeData(JSON.stringify(envelope, null, 2));
@@ -37490,6 +36920,532 @@ async function runLocalDoctor(jsonOutput) {
 }
 // src/commands/local.ts
 init_config();
+
+// src/commands/db.ts
+init_config();
+init_dev_state();
+init_output();
+import { confirm as confirm4 } from "@inquirer/prompts";
+import { getDb, sql } from "@secondlayer/shared/db";
+import {
+  countMissingBlocks,
+  findGaps
+} from "@secondlayer/shared/db/queries/integrity";
+import { StacksNodeClient } from "@secondlayer/shared/node";
+var DEV_DATABASE_URL = "postgres://postgres:postgres@localhost:5432/secondlayer_dev";
+function addDbCommand(parent) {
+  const dbCmd = parent.command("db").description("Inspect indexer database tables").addHelpText("after", `
+Subcommands:
+  blocks    Show recent blocks
+  txs       Show recent transactions
+  events    Show recent events
+  gaps      Show gaps in indexed block data
+  truncate  Truncate all indexed data
+  resync    Reset database and restart indexer
+
+Run \`sl db\` with no subcommand to print an overview.`).hook("preAction", async () => {
+    await requireLocalNetwork();
+  }).action(async () => {
+    await showOverview(10);
+  });
+  dbCmd.command("blocks").description("Show recent blocks").option("--limit <n>", "Number of rows", "10").option("--json", "Output as JSON").action(async function() {
+    const opts = this.opts();
+    await showBlocks(Number.parseInt(opts.limit), opts.json);
+  });
+  dbCmd.command("txs").description("Show recent transactions").option("--limit <n>", "Number of rows", "10").option("--json", "Output as JSON").action(async function() {
+    const opts = this.opts();
+    await showTransactions(Number.parseInt(opts.limit), opts.json);
+  });
+  dbCmd.command("events").description("Show recent events").option("--limit <n>", "Number of rows", "10").option("--json", "Output as JSON").action(async function() {
+    const opts = this.opts();
+    await showEvents(Number.parseInt(opts.limit), opts.json);
+  });
+  dbCmd.command("gaps").description("Show gaps in indexed block data").option("--limit <n>", "Number of gaps to show", "50").option("--json", "Output as JSON").action(async function() {
+    const opts = this.opts();
+    await showGaps(Number.parseInt(opts.limit), opts.json);
+  });
+  dbCmd.command("truncate").description("Truncate all indexed data (blocks, txs, events)").option("-y, --yes", "Skip confirmation prompt").action(async function() {
+    const opts = this.opts();
+    await resetDatabase(opts.yes);
+  });
+  dbCmd.command("resync").description("Reset database and restart indexer for fresh sync").option("-y, --yes", "Skip confirmation prompt").option("--backfill", "After reset, fetch all blocks from node").action(async function() {
+    const opts = this.opts();
+    await resyncDatabase(opts.yes, opts.backfill);
+  });
+}
+function ensureDb() {
+  if (!process.env.DATABASE_URL) {
+    process.env.DATABASE_URL = DEV_DATABASE_URL;
+  }
+  return getDb();
+}
+async function showOverview(_limit) {
+  try {
+    const db = ensureDb();
+    const blockCountResult = await db.selectFrom("blocks").select(sql`count(*)`.as("count")).executeTakeFirst();
+    const txCountResult = await db.selectFrom("transactions").select(sql`count(*)`.as("count")).executeTakeFirst();
+    const eventCountResult = await db.selectFrom("events").select(sql`count(*)`.as("count")).executeTakeFirst();
+    const blockCount = blockCountResult?.count ?? 0;
+    const txCount = txCountResult?.count ?? 0;
+    const eventCount = eventCountResult?.count ?? 0;
+    const latest = await db.selectFrom("blocks").select(["height", "hash", "timestamp"]).orderBy("height", "desc").limit(1).executeTakeFirst();
+    console.log("");
+    console.log(blue("Database Overview"));
+    console.log("");
+    console.log(`  Blocks:       ${green(blockCount.toString())}`);
+    console.log(`  Transactions: ${green(txCount.toString())}`);
+    console.log(`  Events:       ${green(eventCount.toString())}`);
+    console.log("");
+    if (latest) {
+      const time = new Date(latest.timestamp * 1000).toISOString();
+      console.log(blue("Latest Block"));
+      console.log(`  Height: ${latest.height}`);
+      console.log(`  Hash:   ${dim(latest.hash.slice(0, 20))}...`);
+      console.log(`  Time:   ${time}`);
+      console.log("");
+    }
+    console.log(dim(`Use 'sl db blocks|txs|events' to see records`));
+    console.log("");
+    process.exit(0);
+  } catch (err) {
+    error(`Failed to query database: ${err}`);
+    console.log(dim(`
+Make sure PostgreSQL is running.`));
+    console.log(dim("Run 'sl local start' to start all services."));
+    process.exit(1);
+  }
+}
+async function showBlocks(limit, json) {
+  try {
+    const db = ensureDb();
+    const rows = await db.selectFrom("blocks").select(["height", "hash", "timestamp", "canonical"]).orderBy("height", "desc").limit(limit).execute();
+    if (json) {
+      console.log(JSON.stringify(rows, null, 2));
+      process.exit(0);
+    }
+    console.log("");
+    console.log(blue(`Recent Blocks (${rows.length})`));
+    console.log("");
+    console.log(dim("  HEIGHT".padEnd(10)) + dim("HASH".padEnd(24)) + dim("TIME"));
+    for (const row of rows) {
+      const time = new Date(row.timestamp * 1000).toLocaleTimeString();
+      const canonicalMark = row.canonical ? "" : yellow(" (reorg)");
+      console.log(`  ${row.height.toString().padEnd(10)}${`${row.hash.slice(0, 20)}... `.padEnd(24)}${time}${canonicalMark}`);
+    }
+    console.log("");
+    process.exit(0);
+  } catch (err) {
+    error(`Failed to query blocks: ${err}`);
+    process.exit(1);
+  }
+}
+async function showTransactions(limit, json) {
+  try {
+    const db = ensureDb();
+    const rows = await db.selectFrom("transactions").select([
+      "tx_id",
+      "block_height",
+      "type",
+      "sender",
+      "status",
+      "contract_id",
+      "function_name"
+    ]).orderBy("block_height", "desc").limit(limit).execute();
+    if (json) {
+      console.log(JSON.stringify(rows, null, 2));
+      process.exit(0);
+    }
+    console.log("");
+    console.log(blue(`Recent Transactions (${rows.length})`));
+    console.log("");
+    console.log(dim("  BLOCK".padEnd(8)) + dim("TYPE".padEnd(18)) + dim("SENDER".padEnd(20)) + dim("CONTRACT/FUNCTION"));
+    for (const row of rows) {
+      const statusColor = row.status === "success" ? green : yellow;
+      const contractInfo = row.contract_id ? `${row.contract_id.split(".")[1] || row.contract_id}${row.function_name ? `::${row.function_name}` : ""}` : "-";
+      console.log(`  ${statusColor(row.block_height.toString().padEnd(8))}${row.type.padEnd(18)}${`${row.sender.slice(0, 18)}... `.padEnd(20)}${contractInfo}`);
+    }
+    console.log("");
+    process.exit(0);
+  } catch (err) {
+    error(`Failed to query transactions: ${err}`);
+    process.exit(1);
+  }
+}
+async function showEvents(limit, json) {
+  try {
+    const db = ensureDb();
+    const rows = await db.selectFrom("events").select(["block_height", "tx_id", "event_index", "type", "data"]).orderBy("block_height", "desc").limit(limit).execute();
+    if (json) {
+      console.log(JSON.stringify(rows, null, 2));
+      process.exit(0);
+    }
+    console.log("");
+    console.log(blue(`Recent Events (${rows.length})`));
+    console.log("");
+    if (rows.length === 0) {
+      console.log(dim("  No events found"));
+      console.log("");
+      process.exit(0);
+    }
+    console.log(dim("  BLOCK".padEnd(8)) + dim("INDEX".padEnd(8)) + dim("TYPE".padEnd(24)) + dim("TX"));
+    for (const row of rows) {
+      console.log(`  ${row.block_height.toString().padEnd(8)}` + `${row.event_index.toString().padEnd(8)}` + `${row.type.padEnd(24)}` + `${row.tx_id.slice(0, 16)}...`);
+    }
+    console.log("");
+    process.exit(0);
+  } catch (err) {
+    error(`Failed to query events: ${err}`);
+    process.exit(1);
+  }
+}
+async function showGaps(limit, json) {
+  try {
+    const db = ensureDb();
+    const gaps = await findGaps(db, limit);
+    const missing = await countMissingBlocks(db);
+    if (json) {
+      console.log(JSON.stringify({ gaps, totalMissingBlocks: missing }, null, 2));
+      process.exit(0);
+    }
+    console.log("");
+    if (gaps.length === 0) {
+      console.log(green("No gaps detected — block data is contiguous"));
+      console.log("");
+      process.exit(0);
+    }
+    console.log(blue(`Block Gaps (${gaps.length})`));
+    console.log("");
+    console.log(dim("  GAP_START".padEnd(14)) + dim("GAP_END".padEnd(14)) + dim("SIZE"));
+    for (const gap of gaps) {
+      console.log(`  ${gap.gapStart.toString().padEnd(14)}` + `${gap.gapEnd.toString().padEnd(14)}` + `${gap.size}`);
+    }
+    console.log("");
+    console.log(`${yellow(gaps.length.toString())} gaps, ${red(missing.toString())} missing blocks`);
+    console.log("");
+    process.exit(0);
+  } catch (err) {
+    error(`Failed to query gaps: ${err}`);
+    process.exit(1);
+  }
+}
+async function resetDatabase(skipConfirm) {
+  try {
+    const db = ensureDb();
+    const blockCount = (await db.selectFrom("blocks").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
+    const txCount = (await db.selectFrom("transactions").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
+    const eventCount = (await db.selectFrom("events").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
+    console.log("");
+    console.log(yellow("This will delete all indexed blockchain data:"));
+    console.log("");
+    console.log(`  ${red(blockCount.toString())} blocks`);
+    console.log(`  ${red(txCount.toString())} transactions`);
+    console.log(`  ${red(eventCount.toString())} events`);
+    console.log(`  ${dim("+ index_progress")}`);
+    console.log("");
+    console.log(dim("Note: Subgraph configurations will be preserved."));
+    console.log("");
+    if (!skipConfirm) {
+      const confirmed = await confirm4({
+        message: "Are you sure you want to reset the database?",
+        default: false
+      });
+      if (!confirmed) {
+        info("Cancelled");
+        process.exit(0);
+      }
+    }
+    info("Truncating tables...");
+    await sql`TRUNCATE TABLE events, transactions, blocks, index_progress RESTART IDENTITY CASCADE`.execute(db);
+    console.log("");
+    success("Database reset complete");
+    console.log("");
+    console.log(dim("Run 'sl local restart' to restart the indexer for fresh sync."));
+    console.log("");
+    process.exit(0);
+  } catch (err) {
+    error(`Failed to reset database: ${err}`);
+    process.exit(1);
+  }
+}
+async function resyncDatabase(skipConfirm, backfill) {
+  try {
+    const db = ensureDb();
+    const blockCount = (await db.selectFrom("blocks").select(sql`count(*)`.as("count")).executeTakeFirst())?.count ?? 0;
+    console.log("");
+    console.log(yellow("This will:"));
+    console.log(`  1. Delete all indexed data (${red(blockCount.toString())} blocks)`);
+    console.log("  2. Restart the indexer for fresh sync");
+    if (backfill) {
+      console.log("  3. Fetch all blocks from node (backfill)");
+    }
+    console.log("");
+    console.log(dim("Note: Subgraph configurations will be preserved."));
+    console.log("");
+    if (!skipConfirm) {
+      const confirmed = await confirm4({
+        message: "Are you sure you want to resync?",
+        default: false
+      });
+      if (!confirmed) {
+        info("Cancelled");
+        process.exit(0);
+      }
+    }
+    info("Truncating tables...");
+    await sql`TRUNCATE TABLE events, transactions, blocks, index_progress RESTART IDENTITY CASCADE`.execute(db);
+    console.log(green("  ✓ Database reset"));
+    const state = await loadDevState();
+    if (state?.services?.indexer && isProcessRunning(state.services.indexer.pid)) {
+      info("Restarting indexer...");
+      try {
+        process.kill(state.services.indexer.pid, "SIGTERM");
+        await Bun.sleep(1000);
+      } catch {}
+      if (isProcessRunning(state.services.indexer.pid)) {
+        try {
+          process.kill(state.services.indexer.pid, "SIGKILL");
+        } catch {}
+      }
+      console.log(green("  ✓ Indexer stopped"));
+      console.log("");
+      info("Run 'sl local restart' to start fresh sync");
+    } else {
+      console.log("");
+      success("Database reset complete");
+      console.log("");
+      if (!backfill) {
+        console.log(dim("Indexer not running. Start with 'sl local start' to begin sync."));
+      }
+    }
+    if (backfill) {
+      console.log("");
+      info("Starting backfill from node...");
+      const nodeClient = new StacksNodeClient;
+      const healthy = await nodeClient.isHealthy();
+      if (!healthy) {
+        warn(`Cannot reach Stacks node at ${nodeClient.getRpcUrl()}`);
+        console.log(dim("Run 'sl sync --from 1 --to <tip>' manually once the node is available."));
+        console.log("");
+        process.exit(0);
+      }
+      const nodeInfo = await nodeClient.getInfo();
+      const tip = nodeInfo.stacks_tip_height;
+      info(`Node tip: block ${tip}. Fetching blocks 1 to ${tip}...`);
+      console.log(dim(`This may take a while. Run 'sl sync --from 1 --to ${tip}' if interrupted.`));
+      console.log("");
+      const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config(), exports_config));
+      const config = await loadConfig2();
+      const indexerUrl = process.env.INDEXER_URL || `http://localhost:${config.ports.indexer}`;
+      const concurrency = 5;
+      let fetched = 0;
+      let errors2 = 0;
+      for (let i = 1;i <= tip; i += concurrency) {
+        const batch = [];
+        for (let j = i;j < i + concurrency && j <= tip; j++) {
+          batch.push(j);
+        }
+        const results = await Promise.allSettled(batch.map(async (height) => {
+          const block = await nodeClient.getBlock(height);
+          if (!block)
+            throw new Error(`Block ${height} not found`);
+          const res = await fetch(`${indexerUrl}/new_block`, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              "X-Source": "backfill"
+            },
+            body: JSON.stringify(block)
+          });
+          if (!res.ok)
+            throw new Error(`Indexer rejected block ${height}: ${res.status}`);
+        }));
+        for (const r of results) {
+          if (r.status === "fulfilled")
+            fetched++;
+          else
+            errors2++;
+        }
+        const pct = Math.round((fetched + errors2) / tip * 100);
+        process.stdout.write(`\r  ${green(`${fetched}`)} fetched, ${errors2 > 0 ? red(`${errors2} errors`) : "0 errors"} (${pct}%)`);
+      }
+      console.log("");
+      console.log("");
+      if (errors2 === 0) {
+        success(`Backfill complete: ${fetched} blocks indexed`);
+      } else {
+        warn(`Backfill complete: ${fetched} indexed, ${errors2} errors`);
+      }
+    }
+    console.log("");
+    process.exit(0);
+  } catch (err) {
+    error(`Failed to resync: ${err}`);
+    process.exit(1);
+  }
+}
+
+// src/commands/stack.ts
+init_config();
+init_dev_state();
+init_docker();
+init_network();
+init_node_manager();
+init_output();
+async function stackStart(options2) {
+  const config = await loadConfig();
+  try {
+    await requireDocker();
+  } catch (err) {
+    if (err instanceof DockerNotAvailableError) {
+      error(err.message);
+      process.exit(1);
+    }
+    throw err;
+  }
+  const network = process.env.STACKS_NETWORK ?? config.node?.network ?? "mainnet";
+  const validation = await validateNetworkConsistency(config);
+  if (!validation.valid) {
+    error("Network mismatch detected:");
+    for (const issue of validation.issues) {
+      console.log(red(`  - ${issue}`));
+    }
+    console.log("");
+    console.log(dim("Fix your config or stop mismatched containers first."));
+    process.exit(1);
+  }
+  console.log("");
+  console.log(blue("Starting Secondlayer Stack"));
+  console.log(dim(`  Network: ${network}`));
+  console.log("");
+  if (options2.node) {
+    const nodePath = config.node?.installPath;
+    if (!nodePath) {
+      warn("No node configured, skipping. Run 'sl local node setup' to configure.");
+    } else if (await isNodeRunning()) {
+      info("Node already running");
+    } else {
+      info("Starting Stacks node...");
+      const started = await startNodeContainers(nodePath, network);
+      if (!started) {
+        error("Failed to start node containers");
+        process.exit(1);
+      }
+      success("Node containers started");
+      info("Waiting for node RPC...");
+      let rpcReady = false;
+      for (let i = 0;i < 60; i++) {
+        try {
+          const res = await fetch("http://localhost:20443/v2/info", {
+            signal: AbortSignal.timeout(2000)
+          });
+          if (res.ok) {
+            rpcReady = true;
+            break;
+          }
+        } catch {}
+        await Bun.sleep(1000);
+      }
+      if (rpcReady) {
+        success("Node RPC responsive");
+        const postValidation = await validateNetworkConsistency(config);
+        if (!postValidation.valid) {
+          warn("Post-start chain ID mismatch:");
+          for (const issue of postValidation.issues) {
+            console.log(yellow(`  - ${issue}`));
+          }
+        }
+      } else {
+        warn("Node RPC not responsive after 60s (may still be starting)");
+      }
+    }
+    console.log("");
+  }
+  if (options2.dev) {
+    if (await isDevRunning()) {
+      info("Dev services already running");
+    } else {
+      const args = [
+        "bun",
+        "run",
+        `${import.meta.dir}/../../bin/secondlayer.ts`,
+        "dev",
+        "start"
+      ];
+      if (config.node?.installPath) {
+        args.push("--stacks-node");
+      }
+      info("Starting dev services...");
+      const proc = Bun.spawn(args, {
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit"
+      });
+      await proc.exited;
+    }
+  }
+  console.log("");
+  success("Stack started");
+  console.log(dim("Run 'sl status' to check health"));
+  console.log("");
+}
+async function stackStop(options2) {
+  console.log("");
+  info("Stopping Secondlayer Stack...");
+  if (options2.dev) {
+    if (await isDevRunning()) {
+      info("Stopping dev services...");
+      const proc = Bun.spawn([
+        "bun",
+        "run",
+        `${import.meta.dir}/../../bin/secondlayer.ts`,
+        "dev",
+        "stop"
+      ], { stdin: "inherit", stdout: "inherit", stderr: "inherit" });
+      await proc.exited;
+    } else {
+      info("Dev services not running");
+    }
+  }
+  if (options2.node) {
+    if (await isNodeRunning()) {
+      info("Stopping node containers...");
+      const stopped = await stopNodeContainers();
+      if (stopped.length > 0) {
+        success(`Stopped: ${stopped.join(", ")}`);
+      }
+    } else {
+      info("Node not running");
+    }
+  }
+  try {
+    const result = await Bun.$`docker ps -a --format json --filter "name=secondlayer-dev" --filter "name=stacks"`.quiet().nothrow();
+    if (result.exitCode === 0) {
+      const lines = result.stdout.toString().trim().split(`
+`).filter(Boolean);
+      const orphans = [];
+      for (const line of lines) {
+        try {
+          const c = JSON.parse(line);
+          const name = c.Names || c.Name;
+          if (name && c.Status?.includes("Exited")) {
+            orphans.push(name);
+          }
+        } catch {}
+      }
+      if (orphans.length > 0) {
+        info(`Cleaning up ${orphans.length} orphaned container(s)...`);
+        for (const name of orphans) {
+          await Bun.$`docker rm ${name}`.quiet().nothrow();
+        }
+      }
+    }
+  } catch {}
+  console.log("");
+  success("Stack stopped");
+  console.log("");
+}
+
+// src/commands/local.ts
 init_dev_state();
 init_node_manager();
 init_output();
@@ -37519,6 +37475,29 @@ function registerLocalCommand(program2) {
     const { restartDev: restartDev2 } = await Promise.resolve().then(() => (init_dev_impl(), exports_dev_impl));
     await restartDev2();
   });
+  local.command("up").description("Start the full local stack (Stacks node + dev services)").option("--devnet", "Run against a local Clarinet devnet instead").option("--no-node", "Skip starting the Stacks node").option("--no-dev", "Skip starting dev services").option("--project <dir>", "[--devnet] Clarinet project directory").option("--image-tag <tag>", "[--devnet] Published image tag to run").option("--owner <owner>", "[--devnet] ghcr image owner to pull from").option("--no-up", "[--devnet] Patch config + write compose without starting").action(async (options2) => {
+    if (options2.devnet) {
+      await connect({
+        project: options2.project,
+        imageTag: options2.imageTag ?? DEFAULT_IMAGE_TAG,
+        owner: options2.owner,
+        up: options2.up
+      });
+    } else {
+      await stackStart({ node: options2.node, dev: options2.dev });
+    }
+  });
+  local.command("down").description("Stop the full local stack").option("--devnet", "Stop a local Clarinet devnet instead").option("--no-node", "Skip stopping the Stacks node").option("--no-dev", "Skip stopping dev services").option("--wait", "Wait for in-flight work to drain before stopping").option("--project <dir>", "[--devnet] Clarinet project directory").option("--purge", "[--devnet] Also remove volumes (wipes the local index)").action(async (options2) => {
+    if (options2.devnet) {
+      await down({ project: options2.project, purge: options2.purge });
+    } else {
+      await stackStop({
+        node: options2.node,
+        dev: options2.dev,
+        wait: options2.wait
+      });
+    }
+  });
   local.command("status").description("Show local environment status").action(async () => {
     await showLocalStatus();
   });
@@ -37535,13 +37514,13 @@ function registerLocalCommand(program2) {
     const { startNode: startNode2 } = await Promise.resolve().then(() => (init_node_impl(), exports_node_impl));
     await startNode2(options2.path, options2.withIndexer);
   });
-  node.command("stop").description("Stop the Stacks node").option("-p, --path <path>", "Path to stacks-blockchain-docker (overrides config)").option("-y, --yes", "Skip confirmation").option("--force", "Deprecated alias for --yes").option("--wait", "Wait for in-flight work to drain first").action(async (options2) => {
+  node.command("stop").description("Stop the Stacks node").option("-p, --path <path>", "Path to stacks-blockchain-docker (overrides config)").option("-y, --yes", "Skip confirmation").option("--wait", "Wait for in-flight work to drain first").action(async (options2) => {
     const { stopNode: stopNode2 } = await Promise.resolve().then(() => (init_node_impl(), exports_node_impl));
-    await stopNode2(options2.path, options2.yes ?? options2.force, options2.wait);
+    await stopNode2(options2.path, options2.yes, options2.wait);
   });
-  node.command("restart").description("Restart the Stacks node (stop then start)").option("-p, --path <path>", "Path to stacks-blockchain-docker (overrides config)").option("-y, --yes", "Skip confirmation").option("--force", "Deprecated alias for --yes").option("--wait", "Wait for in-flight work to drain before stopping").action(async (options2) => {
+  node.command("restart").description("Restart the Stacks node (stop then start)").option("-p, --path <path>", "Path to stacks-blockchain-docker (overrides config)").option("-y, --yes", "Skip confirmation").option("--wait", "Wait for in-flight work to drain before stopping").action(async (options2) => {
     const { restartNode: restartNode2 } = await Promise.resolve().then(() => (init_node_impl(), exports_node_impl));
-    await restartNode2(options2.path, options2.yes ?? options2.force, options2.wait);
+    await restartNode2(options2.path, options2.yes, options2.wait);
   });
   node.command("status").description("Show Stacks node status").option("-p, --path <path>", "Path to stacks-blockchain-docker (overrides config)").option("--json", "Output as JSON").action(async (options2) => {
     const { showStatus: showStatus2 } = await Promise.resolve().then(() => (init_node_impl(), exports_node_impl));
@@ -37966,7 +37945,7 @@ function registerProjectCommand(program2) {
     info(dim(`Written to ${path2}`));
     info(dim("Tip: add `.secondlayer/` to .gitignore — it's account-personal."));
   });
-  project.command("get").alias("current").description("Show the active project for this directory").option("--json", "Output as JSON").action(async (options2) => {
+  project.command("get").description("Show the active project for this directory").option("--json", "Output as JSON").action(async (options2) => {
     const config = await loadConfig();
     const active = await readActiveProject(process.cwd(), config.defaultProject);
     output({
@@ -38023,7 +38002,7 @@ program.hook("preAction", (thisCommand) => {
 program.addHelpText("after", `
 Quickstart:
   $ sl login                        # Authenticate (magic-link email)
-  $ sl subgraphs new my-watcher --template sip-010-balances
+  $ sl subgraphs create my-watcher --template sip-010-balances
   $ sl subgraphs deploy subgraphs/my-watcher.ts
   $ sl subgraphs status my-watcher
 `);
@@ -38037,14 +38016,13 @@ registerLogoutCommand(program);
 registerWhoamiCommand(program);
 program.commandsGroup("Data products:");
 registerSubgraphsCommand(program);
-registerCreateCommand(program);
 registerSubscriptionsCommand(program);
 registerStreamsCommand(program);
 registerDatasetsCommand(program);
 program.commandsGroup("Project & codegen:");
 registerProjectCommand(program);
-var configureGenerate = (cmd) => cmd.option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path (required when using direct files)").option("--out <path>", "Deprecated alias for --output").option("-k, --api-key <key>", "Stacks node API key for direct RPC URLs").option("-w, --watch", "Watch for changes").action(async (files, options3) => {
-  options3.out = options3.output ?? options3.out;
+var configureGenerate = (cmd) => cmd.option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path (required when using direct files)").option("-k, --api-key <key>", "Stacks node API key for direct RPC URLs").option("-w, --watch", "Watch for changes").action(async (files, options3) => {
+  options3.out = options3.output;
   const { generate: generate2 } = await Promise.resolve().then(() => (init_generate(), exports_generate));
   await generate2(files, options3);
 });
@@ -38054,20 +38032,16 @@ Examples:
   $ sl contracts generate
   $ sl contracts generate ./contracts/pool.clar -o ./src/generated.ts
   $ sl contracts generate --config secondlayer.config.ts --watch`);
-configureGenerate(program.command("generate [files...]").aliases(["gen"]).description("Deprecated: use `sl contracts generate`"));
 program.commandsGroup("Local development:");
 registerLocalCommand(program);
 registerDevnetCommand(program);
-registerStackCommand(program);
-registerDbCommand(program);
 program.commandsGroup("Diagnostics:");
 registerStatusCommand(program);
 registerDoctorCommand(program);
 registerConfigCommand(program);
 program.commandsGroup("Account:");
 registerAccountCommand(program);
-registerBillingCommand(program);
 program.parse();
 
-//# debugId=14BF0C548ABB243864756E2164756E21
+//# debugId=E63D3732E427AF4164756E2164756E21
 //# sourceMappingURL=cli.js.map