@secondlayer/cli 5.8.0 → 5.9.0

package/dist/cli.js

@@ -2565,6 +2565,9 @@ function cyan(text) {
 function dim(text) {
   return `${colors.dim}${text}${colors.reset}`;
 }
+function bold(text) {
+  return `${colors.bold}${text}${colors.reset}`;
+}
 function success(message) {
   console.log(green(`✓ ${message}`));
 }
@@ -5906,8 +5909,8 @@ var require_source = __commonJS((exports, module) => {
   var deferToConnect = (socket, fn) => {
     let listeners;
     if (typeof fn === "function") {
-      const connect = fn;
-      listeners = { connect };
+      const connect2 = fn;
+      listeners = { connect: connect2 };
     } else {
       listeners = fn;
     }
@@ -9808,7 +9811,7 @@ var require_client_request = __commonJS((exports, module) => {
 // ../../node_modules/resolve-alpn/index.js
 var require_resolve_alpn = __commonJS((exports, module) => {
   var tls2 = __require("tls");
-  module.exports = (options = {}, connect = tls2.connect) => new Promise((resolve2, reject) => {
+  module.exports = (options = {}, connect2 = tls2.connect) => new Promise((resolve2, reject) => {
     let timeout = false;
     let socket;
     const callback = async () => {
@@ -9832,7 +9835,7 @@ var require_resolve_alpn = __commonJS((exports, module) => {
     };
     const socketPromise = (async () => {
       try {
-        socket = await connect(options, callback);
+        socket = await connect2(options, callback);
         socket.on("error", reject);
         socket.once("timeout", onTimeout);
       } catch (error2) {
@@ -9910,7 +9913,7 @@ var require_auto = __commonJS((exports, module) => {
     socket.on("agentRemove", onRemove);
     agent.emit("free", socket, options);
   };
-  var createResolveProtocol = (cache2, queue2 = new Map, connect = undefined) => {
+  var createResolveProtocol = (cache2, queue2 = new Map, connect2 = undefined) => {
     return async (options) => {
       const name = `${options.host}:${options.port}:${options.ALPNProtocols.sort()}`;
       if (!cache2.has(name)) {
@@ -9920,7 +9923,7 @@ var require_auto = __commonJS((exports, module) => {
         }
         const { path: path2 } = options;
         options.path = options.socketPath;
-        const resultPromise = resolveALPN(options, connect);
+        const resultPromise = resolveALPN(options, connect2);
         queue2.set(name, resultPromise);
         try {
           const result = await resultPromise;
@@ -13345,10 +13348,10 @@ var init_manager = __esm(() => {
 });
 
 // src/services/indexer.ts
-import { dirname as dirname4, resolve as resolve3 } from "node:path";
+import { dirname as dirname6, resolve as resolve3 } from "node:path";
 async function startIndexer(options2) {
   const port = options2.port ?? 3700;
-  const rootDir = dirname4(dirname4(dirname4(dirname4(import.meta.dir))));
+  const rootDir = dirname6(dirname6(dirname6(dirname6(import.meta.dir))));
   const indexerPath = resolve3(rootDir, "packages/indexer/src/index.ts");
   await serviceManager.start(SERVICE_NAME, ["bun", "run", "--watch", indexerPath], {
     port,
@@ -13365,9 +13368,9 @@ var init_indexer = __esm(() => {
 });
 
 // src/services/worker.ts
-import { dirname as dirname5, resolve as resolve4 } from "node:path";
+import { dirname as dirname7, resolve as resolve4 } from "node:path";
 async function startWorker(options2) {
-  const rootDir = dirname5(dirname5(dirname5(dirname5(import.meta.dir))));
+  const rootDir = dirname7(dirname7(dirname7(dirname7(import.meta.dir))));
   const workerPath = resolve4(rootDir, "packages/worker/src/index.ts");
   await serviceManager.start(SERVICE_NAME2, ["bun", "run", "--watch", workerPath], {
     onStdout: options2.onLog,
@@ -13380,10 +13383,10 @@ var init_worker = __esm(() => {
 });
 
 // src/services/api.ts
-import { dirname as dirname6, resolve as resolve5 } from "node:path";
+import { dirname as dirname8, resolve as resolve5 } from "node:path";
 async function startApi(options2) {
   const port = options2.port ?? 3800;
-  const rootDir = dirname6(dirname6(dirname6(dirname6(import.meta.dir))));
+  const rootDir = dirname8(dirname8(dirname8(dirname8(import.meta.dir))));
   const apiPath = resolve5(rootDir, "packages/api/src/index.ts");
   await serviceManager.start(SERVICE_NAME3, ["bun", "run", "--watch", apiPath], {
     port,
@@ -13400,9 +13403,9 @@ var init_api2 = __esm(() => {
 });
 
 // src/services/subgraph-processor.ts
-import { dirname as dirname7, resolve as resolve6 } from "node:path";
+import { dirname as dirname9, resolve as resolve6 } from "node:path";
 async function startSubgraphProcessor(options2) {
-  const rootDir = dirname7(dirname7(dirname7(dirname7(import.meta.dir))));
+  const rootDir = dirname9(dirname9(dirname9(dirname9(import.meta.dir))));
   const servicePath = resolve6(rootDir, "packages/subgraphs/src/service.ts");
   await serviceManager.start(SERVICE_NAME4, ["bun", "run", "--watch", servicePath], {
     env: {
@@ -13437,8 +13440,8 @@ __export(exports_dev_impl, {
   restartDev: () => restartDev,
   isDevAlreadyRunning: () => isDevAlreadyRunning
 });
-import { mkdirSync as mkdirSync3 } from "node:fs";
-import { dirname as dirname8, join as join7, resolve as resolve7 } from "node:path";
+import { mkdirSync as mkdirSync4 } from "node:fs";
+import { dirname as dirname10, join as join9, resolve as resolve7 } from "node:path";
 async function isDevAlreadyRunning() {
   if (await isDevRunning()) {
     const running = await getRunningServices();
@@ -13516,7 +13519,7 @@ async function runBackground(options2) {
     startedAt: new Date().toISOString()
   };
   try {
-    const packagesDir = dirname8(dirname8(dirname8(dirname8(import.meta.dir))));
+    const packagesDir = dirname10(dirname10(dirname10(dirname10(import.meta.dir))));
     const env = { DATABASE_URL: databaseUrl, DEV_MODE: "true" };
     const apiLogFile = getLogFile("api");
     const apiProc = Bun.spawn(["bun", "run", resolve7(packagesDir, "packages/api/src/index.ts")], {
@@ -13866,7 +13869,7 @@ async function restartDev() {
   await clearDevState();
   await clearLogs();
   const config = await loadConfig();
-  const packagesDir = dirname8(dirname8(dirname8(dirname8(import.meta.dir))));
+  const packagesDir = dirname10(dirname10(dirname10(dirname10(import.meta.dir))));
   const env = state.env;
   const newState = {
     services: {},
@@ -14047,8 +14050,8 @@ async function ensureDevPostgres(dataDir) {
   if (check.stdout.toString().trim()) {
     return false;
   }
-  const pgDataDir = join7(dataDir, "postgres");
-  mkdirSync3(pgDataDir, { recursive: true });
+  const pgDataDir = join9(dataDir, "postgres");
+  mkdirSync4(pgDataDir, { recursive: true });
   const stopped = await Bun.$`docker ps -aq -f name=secondlayer-dev-postgres`.quiet().nothrow();
   if (stopped.stdout.toString().trim()) {
     await Bun.$`docker rm secondlayer-dev-postgres`.quiet().nothrow();
@@ -14063,7 +14066,7 @@ async function ensureDevPostgres(dataDir) {
   throw new Error("PostgreSQL failed to start");
 }
 async function runMigrations(databaseUrl) {
-  const packagesDir = dirname8(dirname8(dirname8(dirname8(import.meta.dir))));
+  const packagesDir = dirname10(dirname10(dirname10(dirname10(import.meta.dir))));
   const migrateScript = resolve7(packagesDir, "packages/shared/src/db/migrate.ts");
   const result = await Bun.$`DATABASE_URL=${databaseUrl} bun run ${migrateScript}`.quiet().nothrow();
   if (result.exitCode !== 0) {
@@ -21791,11 +21794,11 @@ var init_commands = __esm(() => {
 });
 
 // ../../node_modules/@antfu/ni/dist/shared/ni.B5qNAuoI.mjs
-import path3, { join as join9, dirname as dirname10, resolve as resolve9 } from "node:path";
+import path3, { join as join11, dirname as dirname12, resolve as resolve9 } from "node:path";
 import process$1 from "node:process";
 import require$$0 from "readline";
 import require$$2 from "events";
-import fs5, { promises, existsSync as existsSync4 } from "node:fs";
+import fs5, { promises, existsSync as existsSync6 } from "node:fs";
 import require$$0$1 from "os";
 import require$$1 from "tty";
 import os4 from "node:os";
@@ -24806,7 +24809,7 @@ function requireLib() {
     return lib;
   hasRequiredLib = 1;
   const { isexe, sync: isexeSync } = requireCjs();
-  const { join: join10, delimiter, sep, posix: posix2 } = require$$1$2;
+  const { join: join12, delimiter, sep, posix: posix2 } = require$$1$2;
   const isWindows = process.platform === "win32";
   const rSlash = new RegExp(`[${posix2.sep}${sep === posix2.sep ? "" : sep}]`.replace(/(\\)/g, "\\$1"));
   const rRel = new RegExp(`^\\.${rSlash.source}`);
@@ -24833,7 +24836,7 @@ function requireLib() {
   const getPathPart = (raw, cmd) => {
     const pathPart = /^".*"$/.test(raw) ? raw.slice(1, -1) : raw;
     const prefix = !pathPart && rRel.test(cmd) ? cmd.slice(0, 2) : "";
-    return prefix + join10(pathPart, cmd);
+    return prefix + join12(pathPart, cmd);
   };
   const which = async (cmd, opt = {}) => {
     const { pathEnv, pathExt, pathExtExe } = getPathInfo(cmd, opt);
@@ -24982,7 +24985,7 @@ var init_ni_B5qNAuoI = __esm(() => {
   options2 = {};
   libExports = requireLib();
   which = /* @__PURE__ */ getDefaultExportFromCjs(libExports);
-  CLI_TEMP_DIR = join9(os4.tmpdir(), "antfu-ni");
+  CLI_TEMP_DIR = join11(os4.tmpdir(), "antfu-ni");
   customRcPath = process$1.env.NI_CONFIG_FILE;
   home = process$1.platform === "win32" ? process$1.env.USERPROFILE : process$1.env.HOME;
   defaultRcPath = path3.join(home || "~/", ".nirc");
@@ -25635,11 +25638,11 @@ var hasColors, format = (open, close) => {
     result += string.slice(lastIndex) + closeCode;
     return result;
   };
-}, reset2, bold, dim2, italic, underline, overline, inverse, hidden, strikethrough, black, red2, green2, yellow2, blue2, magenta2, cyan2, white, gray, bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite, bgGray, redBright, greenBright, yellowBright, blueBright, magentaBright, cyanBright, whiteBright, bgRedBright, bgGreenBright, bgYellowBright, bgBlueBright, bgMagentaBright, bgCyanBright, bgWhiteBright;
+}, reset2, bold2, dim2, italic, underline, overline, inverse, hidden, strikethrough, black, red2, green2, yellow2, blue2, magenta2, cyan2, white, gray, bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite, bgGray, redBright, greenBright, yellowBright, blueBright, magentaBright, cyanBright, whiteBright, bgRedBright, bgGreenBright, bgYellowBright, bgBlueBright, bgMagentaBright, bgCyanBright, bgWhiteBright;
 var init_base = __esm(() => {
   hasColors = tty2?.WriteStream?.prototype?.hasColors?.() ?? false;
   reset2 = format(0, 0);
-  bold = format(1, 22);
+  bold2 = format(1, 22);
   dim2 = format(2, 22);
   italic = format(3, 23);
   underline = format(4, 24);
@@ -25717,7 +25720,7 @@ var init_default = __esm(() => {
     duration: getFinalIcon
   };
   COLORS = {
-    command: () => bold,
+    command: () => bold2,
     output: () => identity,
     ipc: () => identity,
     error: ({ reject }) => reject ? redBright : yellowBright,
@@ -26294,7 +26297,7 @@ var require_cross_spawn = __commonJS((exports, module) => {
     enoent.hookChildProcess(spawned, parsed);
     return spawned;
   }
-  function spawnSync(command, args, options3) {
+  function spawnSync2(command, args, options3) {
     const parsed = parse2(command, args, options3);
     const result = cp.spawnSync(parsed.command, parsed.args, parsed.options);
     result.error = result.error || enoent.verifyENOENTSync(result.status, parsed);
@@ -26302,7 +26305,7 @@ var require_cross_spawn = __commonJS((exports, module) => {
   }
   module.exports = spawn2;
   module.exports.spawn = spawn2;
-  module.exports.sync = spawnSync;
+  module.exports.sync = spawnSync2;
   module.exports._parse = parse2;
   module.exports._enoent = enoent;
 });
@@ -28706,7 +28709,7 @@ var init_stdio_option = __esm(() => {
 });
 
 // ../../node_modules/execa/lib/stdio/native.js
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 import tty3 from "node:tty";
 var handleNativeStream = ({ stdioItem, stdioItem: { type }, isStdioArray, fdNumber, direction, isSync }) => {
   if (!isStdioArray || type !== "native") {
@@ -28738,7 +28741,7 @@ var handleNativeStream = ({ stdioItem, stdioItem: { type }, isStdioArray, fdNumb
   if (tty3.isatty(targetFdNumber)) {
     throw new TypeError(`The \`${optionName}: ${serializeOptionValue(value)}\` option is invalid: it cannot be a TTY with synchronous methods.`);
   }
-  return { type: "uint8Array", value: bufferToUint8Array(readFileSync3(targetFdNumber)), optionName };
+  return { type: "uint8Array", value: bufferToUint8Array(readFileSync4(targetFdNumber)), optionName };
 }, getTargetFdNumber = (value, fdNumber) => {
   if (value === "inherit") {
     return fdNumber;
@@ -29041,7 +29044,7 @@ var init_handle = __esm(() => {
 });
 
 // ../../node_modules/execa/lib/stdio/handle-sync.js
-import { readFileSync as readFileSync4 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 var handleStdioSync = (options3, verboseInfo) => handleStdio(addPropertiesSync, options3, verboseInfo, true), forbiddenIfSync = ({ type, optionName }) => {
   throwInvalidSyncValue(optionName, TYPE_TO_MESSAGE[type]);
 }, forbiddenNativeIfSync = ({ optionName, value }) => {
@@ -29069,8 +29072,8 @@ var init_handle_sync = __esm(() => {
   addPropertiesSync = {
     input: {
       ...addProperties,
-      fileUrl: ({ value }) => ({ contents: [bufferToUint8Array(readFileSync4(value))] }),
-      filePath: ({ value: { file } }) => ({ contents: [bufferToUint8Array(readFileSync4(file))] }),
+      fileUrl: ({ value }) => ({ contents: [bufferToUint8Array(readFileSync5(value))] }),
+      filePath: ({ value: { file } }) => ({ contents: [bufferToUint8Array(readFileSync5(file))] }),
       fileNumber: forbiddenIfSync,
       iterable: ({ value }) => ({ contents: [...value] }),
       string: ({ value }) => ({ contents: [value] }),
@@ -29439,7 +29442,7 @@ var init_output2 = __esm(() => {
 });
 
 // ../../node_modules/execa/lib/io/output-sync.js
-import { writeFileSync as writeFileSync3, appendFileSync } from "node:fs";
+import { writeFileSync as writeFileSync5, appendFileSync } from "node:fs";
 var transformOutputSync = ({ fileDescriptors, syncResult: { output }, options: options3, isMaxBuffer, verboseInfo }) => {
   if (output === null) {
     return { output: Array.from({ length: 3 }) };
@@ -29532,7 +29535,7 @@ var transformOutputSync = ({ fileDescriptors, syncResult: { output }, options: o
       appendFileSync(path9, serializedResult);
     } else {
       outputFiles.add(pathString);
-      writeFileSync3(path9, serializedResult);
+      writeFileSync5(path9, serializedResult);
     }
   }
 };
@@ -29629,7 +29632,7 @@ var init_exit_sync = __esm(() => {
 });
 
 // ../../node_modules/execa/lib/methods/main-sync.js
-import { spawnSync } from "node:child_process";
+import { spawnSync as spawnSync2 } from "node:child_process";
 var execaCoreSync = (rawFile, rawArguments, rawOptions) => {
   const { file, commandArguments, command, escapedCommand, startTime, verboseInfo, options: options3, fileDescriptors } = handleSyncArguments(rawFile, rawArguments, rawOptions);
   const result = spawnSubprocessSync({
@@ -29714,7 +29717,7 @@ var execaCoreSync = (rawFile, rawArguments, rawOptions) => {
   try {
     addInputOptionsSync(fileDescriptors, options3);
     const normalizedOptions = normalizeSpawnSyncOptions(options3);
-    return spawnSync(...concatenateShell(file, commandArguments, normalizedOptions));
+    return spawnSync2(...concatenateShell(file, commandArguments, normalizedOptions));
   } catch (error2) {
     return makeEarlyError({
       error: error2,
@@ -32321,7 +32324,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "5.8.0",
+  version: "5.9.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -32377,6 +32380,7 @@ var package_default = {
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.0",
     esbuild: "^0.19.0",
+    "smol-toml": "^1.6.1",
     zod: "^4.3.6"
   },
   devDependencies: {
@@ -34429,16 +34433,303 @@ async function resyncDatabase(skipConfirm, backfill) {
     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";
+
+// src/lib/devnet-compose.ts
+var DEFAULT_IMAGE_OWNER = "ryanwaits";
+var DEFAULT_IMAGE_TAG = "latest";
+function buildDevnetCompose(opts = {}) {
+  const owner = opts.owner ?? DEFAULT_IMAGE_OWNER;
+  const tag = opts.imageTag ?? DEFAULT_IMAGE_TAG;
+  const apiPort = opts.apiPort ?? 3800;
+  const indexerPort = opts.indexerPort ?? 3700;
+  const apiImage = `ghcr.io/${owner}/secondlayer-api:${tag}`;
+  const indexerImage = `ghcr.io/${owner}/secondlayer-indexer:${tag}`;
+  const dbUrl = "postgres://secondlayer:secondlayer@postgres:5432/secondlayer";
+  return `# Generated by \`sl devnet connect\` — do not edit by hand.
+# Secondlayer app services for local clarinet devnet development.
+name: secondlayer-devnet
+
+services:
+  postgres:
+    image: postgres:17-alpine
+    environment:
+      POSTGRES_USER: secondlayer
+      POSTGRES_PASSWORD: secondlayer
+      POSTGRES_DB: secondlayer
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U secondlayer"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+    restart: unless-stopped
+
+  migrate:
+    image: ${apiImage}
+    command: ["bun", "run", "packages/shared/src/db/migrate.ts"]
+    environment:
+      DATABASE_URL: ${dbUrl}
+    depends_on:
+      postgres:
+        condition: service_healthy
+    restart: "no"
+
+  api:
+    image: ${apiImage}
+    environment:
+      INSTANCE_MODE: oss
+      DATABASE_URL: ${dbUrl}
+      PORT: 3800
+      NODE_ENV: production
+      DATA_DIR: /data
+    ports:
+      - "${apiPort}:3800"
+    volumes:
+      - subgraphs_data:/data/subgraphs
+    depends_on:
+      migrate:
+        condition: service_completed_successfully
+      postgres:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:3800/health"]
+      interval: 10s
+      timeout: 3s
+      start_period: 10s
+      retries: 5
+    restart: unless-stopped
+
+  indexer:
+    image: ${indexerImage}
+    environment:
+      DATABASE_URL: ${dbUrl}
+      PORT: 3700
+      NODE_ENV: production
+      # Keep every network key aligned: the indexer writes index_progress under
+      # STACKS_NETWORK, the subgraph processor reads it under NETWORK. If they
+      # differ, catch-up finds no progress row and subgraphs never advance.
+      NETWORKS: testnet
+      STACKS_NETWORK: testnet
+      NETWORK: testnet
+      # Fed by the devnet node's event observer — never reach out to Hiro mainnet.
+      AUTO_BACKFILL_ENABLED: "false"
+      TIP_FOLLOWER_ENABLED: "false"
+    # Bind on all interfaces so the devnet's stacks-node container can POST to
+    # host.docker.internal:3700.
+    ports:
+      - "${indexerPort}:3700"
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    depends_on:
+      migrate:
+        condition: service_completed_successfully
+      postgres:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:3700/health"]
+      interval: 10s
+      timeout: 3s
+      start_period: 10s
+      retries: 5
+    restart: unless-stopped
+
+  subgraph-processor:
+    image: ${apiImage}
+    command: ["bun", "run", "packages/subgraphs/src/service.ts"]
+    environment:
+      DATABASE_URL: ${dbUrl}
+      NODE_ENV: production
+      DATA_DIR: /data
+      # Must match the indexer's network key (see indexer note) — catch-up reads
+      # index_progress under NETWORK.
+      NETWORK: testnet
+      STACKS_NETWORK: testnet
+    volumes:
+      - subgraphs_data:/data/subgraphs
+    depends_on:
+      migrate:
+        condition: service_completed_successfully
+      postgres:
+        condition: service_healthy
+    healthcheck:
+      disable: true
+    restart: unless-stopped
+
+volumes:
+  postgres_data:
+  subgraphs_data:
+`;
+}
+
+// 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 { 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")))
+      return dir;
+    if (dir === root)
+      return null;
+    dir = dirname3(dir);
+  }
+}
+function ensureEventObserver(devnetTomlPath, endpoint = DEFAULT_INDEXER_OBSERVER) {
+  const exists = existsSync2(devnetTomlPath);
+  const original = exists ? readFileSync2(devnetTomlPath, "utf8") : "";
+  if (original.trim()) {
+    const parsed = parseToml(original);
+    const observers = parsed.devnet?.stacks_node_events_observers;
+    if (Array.isArray(observers) && observers.includes(endpoint)) {
+      return { status: "present" };
+    }
+  }
+  const entry = JSON.stringify(endpoint);
+  const arrayStart = original.match(/^[^#\n]*stacks_node_events_observers\s*=\s*\[/m);
+  if (arrayStart) {
+    const at = (arrayStart.index ?? 0) + arrayStart[0].length;
+    const next = original.slice(at).trimStart().startsWith("]") ? entry : `${entry}, `;
+    const patched = original.slice(0, at) + next + original.slice(at);
+    writeFileSync2(devnetTomlPath, patched);
+    return { status: "added" };
+  }
+  const header = original.match(/^\[devnet\]\s*$/m);
+  if (header) {
+    const at = (header.index ?? 0) + header[0].length;
+    const patched = `${original.slice(0, at)}
+stacks_node_events_observers = [${entry}]${original.slice(at)}`;
+    writeFileSync2(devnetTomlPath, patched);
+    return { status: "added" };
+  }
+  const prefix = original && !original.endsWith(`
+`) ? `${original}
+` : original;
+  const block = `${prefix}${original.trim() ? `
+` : ""}[devnet]
+stacks_node_events_observers = [${entry}]
+`;
+  writeFileSync2(devnetTomlPath, block);
+  return { status: exists ? "added" : "created" };
+}
+
+// src/commands/devnet.ts
+init_output();
+var COMPOSE_REL = join7(".secondlayer", "docker-compose.yml");
+function ensureDocker() {
+  const probe = spawnSync("docker", ["info"], { stdio: "ignore" });
+  if (probe.error || probe.status !== 0) {
+    error(`Docker isn't available.
+
+` + `Start Docker Desktop or OrbStack (macOS), or install Docker:
+` + `  macOS:  brew install --cask docker  (or https://orbstack.dev)
+` + "  Linux:  curl -fsSL https://get.docker.com | sh");
+    process.exit(1);
+  }
+}
+function dockerCompose(composePath, args) {
+  const res = spawnSync("docker", ["compose", "-f", composePath, ...args], {
+    stdio: "inherit"
+  });
+  return res.status ?? 1;
+}
+function registerDevnetCommand(program2) {
+  const devnet = program2.command("devnet").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);
+  });
+  devnet.command("down").description("Stop the local Secondlayer stack started by `sl devnet connect`").option("--project <dir>", "Clarinet project directory").option("--purge", "Also remove volumes (wipes the local index)").action(async (options) => {
+    await down(options);
+  });
+}
+function resolveProject(explicit) {
+  if (explicit) {
+    if (!existsSync3(join7(explicit, "Clarinet.toml"))) {
+      error(`No Clarinet.toml in ${explicit}`);
+      process.exit(1);
+    }
+    return explicit;
+  }
+  const found = findClarinetProject(process.cwd());
+  if (!found) {
+    error(`No Clarinet.toml found in this directory or any parent.
+` + "Run this from inside a clarinet project, or pass --project <dir>.");
+    process.exit(1);
+  }
+  return found;
+}
+async function connect(options) {
+  const project = resolveProject(options.project);
+  const devnetToml = join7(project, "settings", "Devnet.toml");
+  mkdirSync2(dirname4(devnetToml), { recursive: true });
+  const result = ensureEventObserver(devnetToml, DEFAULT_INDEXER_OBSERVER);
+  console.log(`${green("✓")} found Clarinet.toml`);
+  if (result.status === "present") {
+    console.log(dim(`  settings/Devnet.toml already forwards to ${DEFAULT_INDEXER_OBSERVER}`));
+  } else {
+    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);
+  mkdirSync2(dirname4(composePath), { recursive: true });
+  writeFileSync3(composePath, buildDevnetCompose({ owner: options.owner, imageTag: options.imageTag }));
+  console.log(`${green("✓")} wrote ${COMPOSE_REL}`);
+  if (!options.up) {
+    console.log(dim(`
+Skipped docker. Start it with:
+  docker compose -f ${COMPOSE_REL} up -d`));
+    return;
+  }
+  ensureDocker();
+  console.log(dim(`
+Starting Secondlayer stack (docker compose up -d)…`));
+  if (dockerCompose(composePath, ["up", "-d"]) !== 0) {
+    error("docker compose up failed — see output above.");
+    process.exit(1);
+  }
+  console.log(`
+${bold("Secondlayer stack up")}`);
+  console.log(`  api      → ${cyan("http://localhost:3800")}`);
+  console.log(`  indexer  → ${cyan("http://localhost:3700")}`);
+  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(dim(`
+Stop with: sl devnet down`));
+}
+async function down(options) {
+  const project = resolveProject(options.project);
+  const composePath = join7(project, COMPOSE_REL);
+  if (!existsSync3(composePath)) {
+    error(`No ${COMPOSE_REL} in ${project} — nothing to stop. Run \`sl devnet connect\` first.`);
+    process.exit(1);
+  }
+  ensureDocker();
+  const args = options.purge ? ["down", "-v"] : ["down"];
+  if (dockerCompose(composePath, args) !== 0) {
+    error("docker compose down failed — see output above.");
+    process.exit(1);
+  }
+  console.log(`${green("✓")}${options.purge ? " stack stopped, volumes removed" : " stack stopped"}`);
+}
 // src/commands/subgraphs.ts
 import { spawn } from "node:child_process";
 import {
-  existsSync as existsSync2,
-  mkdirSync as mkdirSync2,
-  readFileSync as readFileSync2,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync3,
   watch,
-  writeFileSync as writeFileSync2
+  writeFileSync as writeFileSync4
 } from "node:fs";
-import { dirname as dirname3, join as join6, resolve as resolve2 } from "node:path";
+import { dirname as dirname5, join as join8, resolve as resolve2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { confirm as confirm4 } from "@inquirer/prompts";
 
@@ -35249,8 +35540,8 @@ async function writeOrPrintSubgraphSpec(spec, format, output) {
   }
   const outPath = resolve2(output);
   const dir = resolve2(outPath, "..");
-  if (!existsSync2(dir))
-    mkdirSync2(dir, { recursive: true });
+  if (!existsSync4(dir))
+    mkdirSync3(dir, { recursive: true });
   await writeTextFile(outPath, text);
   success(`Created ${outPath}`);
 }
@@ -35312,15 +35603,15 @@ function createLocalSubgraphDetail(input3) {
   };
 }
 function readCliSubgraphsDependency() {
-  const here = dirname3(fileURLToPath2(import.meta.url));
+  const here = dirname5(fileURLToPath2(import.meta.url));
   const candidates = [
     resolve2(here, "..", "..", "package.json"),
     resolve2(here, "..", "package.json")
   ];
   for (const candidate of candidates) {
-    if (!existsSync2(candidate))
+    if (!existsSync4(candidate))
       continue;
-    const pkg = JSON.parse(readFileSync2(candidate, "utf8"));
+    const pkg = JSON.parse(readFileSync3(candidate, "utf8"));
     const dep = pkg.dependencies?.["@secondlayer/subgraphs"];
     if (dep)
       return dep;
@@ -35328,10 +35619,10 @@ function readCliSubgraphsDependency() {
   return "^1.3.2";
 }
 function ensureScaffoldPackageJson(dir) {
-  const packagePath = join6(dir, "package.json");
+  const packagePath = join8(dir, "package.json");
   const subgraphsDep = readCliSubgraphsDependency();
-  if (!existsSync2(packagePath)) {
-    writeFileSync2(packagePath, `${JSON.stringify({
+  if (!existsSync4(packagePath)) {
+    writeFileSync4(packagePath, `${JSON.stringify({
       type: "module",
       dependencies: {
         "@secondlayer/subgraphs": subgraphsDep
@@ -35340,14 +35631,14 @@ function ensureScaffoldPackageJson(dir) {
 `, "utf8");
     return;
   }
-  const pkg = JSON.parse(readFileSync2(packagePath, "utf8"));
+  const pkg = JSON.parse(readFileSync3(packagePath, "utf8"));
   if (pkg.dependencies?.["@secondlayer/subgraphs"])
     return;
   pkg.dependencies = {
     ...pkg.dependencies ?? {},
     "@secondlayer/subgraphs": subgraphsDep
   };
-  writeFileSync2(packagePath, `${JSON.stringify(pkg, null, 2)}
+  writeFileSync4(packagePath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
 }
 async function runBunInstall(dir) {
@@ -35456,12 +35747,12 @@ ${SUBGRAPH_TEMPLATE_SLUGS.map((s) => `  ${s.padEnd(20)} ${SUBGRAPH_TEMPLATE_DESC
     }
     const dir = resolve2("subgraphs");
     const filePath = resolve2(dir, `${name}.ts`);
-    if (existsSync2(filePath)) {
+    if (existsSync4(filePath)) {
       error(`File already exists: ${filePath}`);
       process.exit(1);
     }
-    if (!existsSync2(dir)) {
-      mkdirSync2(dir, { recursive: true });
+    if (!existsSync4(dir)) {
+      mkdirSync3(dir, { recursive: true });
     }
     const content = generateSubgraphTemplate(name, slug);
     await writeTextFile(filePath, content);
@@ -35474,7 +35765,7 @@ ${SUBGRAPH_TEMPLATE_SLUGS.map((s) => `  ${s.padEnd(20)} ${SUBGRAPH_TEMPLATE_DESC
   subgraphs.command("dev <file>").description("Watch a subgraph file and auto-redeploy on change").action(async (file) => {
     await requireLocalNetwork();
     const absPath = resolve2(file);
-    if (!existsSync2(absPath)) {
+    if (!existsSync4(absPath)) {
       error(`File not found: ${absPath}`);
       process.exit(1);
     }
@@ -35791,7 +36082,7 @@ Synced — exiting watch.`));
     try {
       const format = parseSubgraphSpecFormat(options2.format);
       const absPath = resolve2(file);
-      if (!existsSync2(absPath)) {
+      if (!existsSync4(absPath)) {
         error(`File not found: ${absPath}`);
         process.exit(1);
       }
@@ -35841,7 +36132,7 @@ Synced — exiting watch.`));
         process.exit(1);
       }
       const absPath = resolve2(file);
-      if (!existsSync2(absPath)) {
+      if (!existsSync4(absPath)) {
         error(`File not found: ${absPath}`);
         process.exit(1);
       }
@@ -36104,8 +36395,8 @@ ${rows.length} row(s)`));
         });
       }
       const dir = resolve2(outPath, "..");
-      if (!existsSync2(dir))
-        mkdirSync2(dir, { recursive: true });
+      if (!existsSync4(dir))
+        mkdirSync3(dir, { recursive: true });
       await writeTextFile(outPath, content);
       ensureScaffoldPackageJson(dir);
       success(`Created ${outPath}`);
@@ -36139,8 +36430,8 @@ ${rows.length} row(s)`));
       info("Generating typed client...");
       const content = await generateSubgraphConsumer(subgraphName, subgraphDetail);
       const dir = resolve2(outPath, "..");
-      if (!existsSync2(dir))
-        mkdirSync2(dir, { recursive: true });
+      if (!existsSync4(dir))
+        mkdirSync3(dir, { recursive: true });
       await writeTextFile(outPath, content);
       success(`Created ${outPath}`);
     } catch (err) {
@@ -37152,10 +37443,10 @@ init_config();
 init_output();
 
 // src/lib/project-file.ts
-import { existsSync as existsSync3 } from "node:fs";
+import { existsSync as existsSync5 } from "node:fs";
 import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
-import { dirname as dirname9, join as join8, parse as parsePath, resolve as resolve8 } from "node:path";
+import { dirname as dirname11, join as join10, parse as parsePath2, resolve as resolve8 } from "node:path";
 import { z as z3 } from "zod/v4";
 var ProjectFileSchema = z3.object({
   slug: z3.string().min(1)
@@ -37165,21 +37456,21 @@ var DIRNAME = ".secondlayer";
 async function readActiveProject(cwd, globalDefault) {
   let dir = resolve8(cwd);
   const home = resolve8(homedir5());
-  const fsRoot = parsePath(dir).root;
+  const fsRoot = parsePath2(dir).root;
   while (true) {
-    const candidate = join8(dir, DIRNAME, FILENAME);
-    if (existsSync3(candidate)) {
+    const candidate = join10(dir, DIRNAME, FILENAME);
+    if (existsSync5(candidate)) {
       try {
         const raw = await readFile3(candidate, "utf8");
         const parsed = ProjectFileSchema.parse(JSON.parse(raw));
         return { slug: parsed.slug, resolvedFrom: candidate };
       } catch {}
     }
-    if (existsSync3(join8(dir, ".git")))
+    if (existsSync5(join10(dir, ".git")))
       break;
     if (dir === home || dir === fsRoot)
       break;
-    const parent = dirname9(dir);
+    const parent = dirname11(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -37187,15 +37478,15 @@ async function readActiveProject(cwd, globalDefault) {
   if (globalDefault) {
     return {
       slug: globalDefault,
-      resolvedFrom: join8(homedir5(), ".secondlayer", "config.json")
+      resolvedFrom: join10(homedir5(), ".secondlayer", "config.json")
     };
   }
   return null;
 }
 async function writeActiveProject(slug, cwd) {
-  const dir = join8(resolve8(cwd), DIRNAME);
+  const dir = join10(resolve8(cwd), DIRNAME);
   await mkdir3(dir, { recursive: true });
-  const file = join8(dir, FILENAME);
+  const file = join10(dir, FILENAME);
   await writeFile3(file, `${JSON.stringify({ slug }, null, 2)}
 `, "utf8");
   return file;
@@ -37400,9 +37691,10 @@ registerDbCommand(program);
 registerDoctorCommand(program);
 registerConfigCommand(program);
 registerLocalCommand(program);
+registerDevnetCommand(program);
 registerAccountCommand(program);
 registerBillingCommand(program);
 program.parse();
 
-//# debugId=BC7D4D440C943F4464756E2164756E21
+//# debugId=FDDBCAB122A19D1564756E2164756E21
 //# sourceMappingURL=cli.js.map