@dashai/cli 0.3.1 → 0.4.0

package/dist/bin.js

@@ -2032,6 +2032,47 @@ var init_init = __esm({
     init_workspaces();
   }
 });
+function loadSchemaCommandContext(opts) {
+  const projectRoot = resolve(opts.dir ?? process.cwd());
+  const manifestPath2 = join(projectRoot, "module.json");
+  const manifest = readManifestOrThrow(projectRoot);
+  const manifestRawBytes = readFileSync(manifestPath2, "utf-8");
+  const slug = manifest.module?.slug;
+  if (!slug) {
+    throw new Error(
+      `module.json at ${manifestPath2} has no module.slug \u2014 the manifest is malformed.`
+    );
+  }
+  const cfg = readConfig();
+  if (!cfg) {
+    throw new Error("Not logged in. Run `dashwise login` first.");
+  }
+  const entry = readModuleEntry(slug);
+  if (!entry) {
+    throw new Error(
+      `No dev install cached for module "${slug}". Run \`dashwise init ${slug} --force\` to provision one.`
+    );
+  }
+  return {
+    projectRoot,
+    manifestPath: manifestPath2,
+    manifest,
+    manifestRawBytes,
+    slug,
+    cfg,
+    entry,
+    requestOptions: {
+      baseUrl: resolveApiUrl(),
+      auth: { token: entry.runtimeToken }
+    }
+  };
+}
+var init_schema_command_context = __esm({
+  "src/lib/schema-command-context.ts"() {
+    init_config();
+    init_manifest_io();
+  }
+});
 
 // src/commands/module/destroy-dev-install.ts
 var destroy_dev_install_exports = {};
@@ -2202,47 +2243,6 @@ var init_reset_dev_install = __esm({
     init_output();
   }
 });
-function loadSchemaCommandContext(opts) {
-  const projectRoot = resolve(opts.dir ?? process.cwd());
-  const manifestPath2 = join(projectRoot, "module.json");
-  const manifest = readManifestOrThrow(projectRoot);
-  const manifestRawBytes = readFileSync(manifestPath2, "utf-8");
-  const slug = manifest.module?.slug;
-  if (!slug) {
-    throw new Error(
-      `module.json at ${manifestPath2} has no module.slug \u2014 the manifest is malformed.`
-    );
-  }
-  const cfg = readConfig();
-  if (!cfg) {
-    throw new Error("Not logged in. Run `dashwise login` first.");
-  }
-  const entry = readModuleEntry(slug);
-  if (!entry) {
-    throw new Error(
-      `No dev install cached for module "${slug}". Run \`dashwise init ${slug} --force\` to provision one.`
-    );
-  }
-  return {
-    projectRoot,
-    manifestPath: manifestPath2,
-    manifest,
-    manifestRawBytes,
-    slug,
-    cfg,
-    entry,
-    requestOptions: {
-      baseUrl: resolveApiUrl(),
-      auth: { token: entry.runtimeToken }
-    }
-  };
-}
-var init_schema_command_context = __esm({
-  "src/lib/schema-command-context.ts"() {
-    init_config();
-    init_manifest_io();
-  }
-});
 
 // src/lib/field-spec.ts
 function parseFieldSpec(spec) {
@@ -2707,10 +2707,76 @@ var init_set_type = __esm({
 init_api_client();
 init_config();
 init_manifest_io();
+
+// src/lib/manifest-poll.ts
+init_api_client();
+function startManifestPollLoop(opts) {
+  const {
+    installationId,
+    manifestPath: manifestPath2,
+    requestOptions,
+    intervalMs,
+    onUpdate,
+    onError
+  } = opts;
+  let lastSeenJson = existsSync(manifestPath2) ? readFileSync(manifestPath2, "utf-8") : "";
+  let timer = null;
+  let stopped = false;
+  const tick = async () => {
+    if (stopped) return;
+    try {
+      const { manifest } = await getInstallationSchema(
+        installationId,
+        requestOptions
+      );
+      const remoteJson = JSON.stringify(manifest, null, 2) + "\n";
+      const currentLocal = existsSync(manifestPath2) ? readFileSync(manifestPath2, "utf-8") : "";
+      if (remoteJson === currentLocal) {
+        lastSeenJson = remoteJson;
+      } else if (remoteJson !== lastSeenJson) {
+        writeFileSync(manifestPath2, remoteJson, "utf-8");
+        lastSeenJson = remoteJson;
+        if (onUpdate) {
+          const delta = Buffer.byteLength(remoteJson, "utf8") - Buffer.byteLength(currentLocal, "utf8");
+          const deltaStr = delta === 0 ? "0 bytes" : `${delta > 0 ? "+" : ""}${delta} bytes`;
+          onUpdate(
+            `Backend manifest changed \u2014 synced to module.json (${deltaStr}).`
+          );
+        }
+      }
+    } catch (err) {
+      if (onError) {
+        const message = err instanceof ApiError ? `${err.code} (HTTP ${err.status}): ${err.message}` : err.message;
+        onError(new Error(message));
+      }
+    } finally {
+      if (!stopped) {
+        timer = setTimeout(() => void tick(), intervalMs);
+      }
+    }
+  };
+  timer = setTimeout(() => void tick(), intervalMs);
+  return {
+    stop: () => {
+      if (stopped) return;
+      stopped = true;
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+    },
+    isRunning: () => !stopped
+  };
+}
+
+// src/commands/dev.ts
 init_output();
 var DEFAULT_NEXT_PORT = 3e3;
 var PREFIX_SDK = `\x1B[36m[sdk]\x1B[0m `;
 var PREFIX_NEXT = `\x1B[35m[next]\x1B[0m `;
+var PREFIX_POLL = `\x1B[33m[poll]\x1B[0m `;
+var DEFAULT_REMOTE_POLL_INTERVAL_SEC = 5;
+var MIN_REMOTE_POLL_INTERVAL_SEC = 1;
 async function devCommand(options) {
   if (options.sdkOnly && options.nextOnly) {
     fail(
@@ -2748,7 +2814,13 @@ async function devCommand(options) {
     return 1;
   }
   const apiUrl = options.apiUrl ?? process.env.DASHWISE_API_URL ?? savedConfig?.apiUrl ?? "http://localhost:3000";
-  const port = options.port ?? DEFAULT_NEXT_PORT;
+  let port;
+  try {
+    port = await resolveDevPort(options.port);
+  } catch (err) {
+    fail(err.message);
+    return 1;
+  }
   const explicitInstallationId = options.installationId ?? process.env.DASHWISE_INSTALLATION_ID;
   const reuseDevSessionId = process.env.DASHWISE_DEV_SESSION_ID;
   const moduleEntry = manifestSlug !== void 0 ? readModuleEntry(manifestSlug) : null;
@@ -2839,10 +2911,43 @@ async function devCommand(options) {
     pipeWithPrefix(child.stdout, process.stdout, prefix);
     pipeWithPrefix(child.stderr, process.stderr, prefix);
   }
+  let manifestPoll = null;
+  const enablePoll = !options.noRemotePoll && moduleEntry !== void 0 && manifestSlug !== void 0;
+  if (enablePoll) {
+    const intervalSec = Math.max(
+      MIN_REMOTE_POLL_INTERVAL_SEC,
+      options.remotePollIntervalSec ?? DEFAULT_REMOTE_POLL_INTERVAL_SEC
+    );
+    manifestPoll = startManifestPollLoop({
+      installationId: moduleEntry.installationId,
+      manifestPath: manifestPath2,
+      requestOptions: {
+        baseUrl: apiUrl,
+        auth: { token: moduleEntry.runtimeToken }
+      },
+      intervalMs: intervalSec * 1e3,
+      onUpdate: (msg) => {
+        process.stdout.write(`${PREFIX_POLL}${msg}
+`);
+      },
+      onError: (err) => {
+        process.stderr.write(`${PREFIX_POLL}${err.message}
+`);
+      }
+    });
+    info(
+      `  ${dim("poll")}        backend manifest every ${intervalSec}s ${dim("(--no-remote-poll to disable)")}`
+    );
+    info("");
+  }
   let shuttingDown = false;
   const forwardSignal = (sig) => {
     if (shuttingDown) return;
     shuttingDown = true;
+    if (manifestPoll) {
+      manifestPoll.stop();
+      manifestPoll = null;
+    }
     info(`
 Received ${sig}, stopping children\u2026`);
     for (const { child } of children) {
@@ -2879,6 +2984,10 @@ Received ${sig}, stopping children\u2026`);
       }
     }
   }
+  if (manifestPoll) {
+    manifestPoll.stop();
+    manifestPoll = null;
+  }
   const exitCode = Math.max(0, ...results.map((r) => r.code));
   if (exitCode === 0) {
     success("Dev loop stopped cleanly.");
@@ -2951,6 +3060,44 @@ function computeCallbackOrigins(port, extra) {
   const def = `http://localhost:${port}`;
   return Array.from(/* @__PURE__ */ new Set([def, ...extra]));
 }
+var PORT_PROBE_LIMIT = 10;
+async function resolveDevPort(requested) {
+  if (requested !== void 0) {
+    if (await isPortFree(requested)) return requested;
+    const suggestion = await findFirstFreePort(requested + 1, PORT_PROBE_LIMIT);
+    const suggestionHint = suggestion !== null ? `Try \`dashwise dev --port ${suggestion}\`.` : `No free port found between ${requested + 1} and ${requested + PORT_PROBE_LIMIT} either \u2014 check what's listening with \`lsof -i :${requested}\`.`;
+    throw new Error(
+      `Port ${requested} is already in use. ${suggestionHint}`
+    );
+  }
+  const found = await findFirstFreePort(DEFAULT_NEXT_PORT, PORT_PROBE_LIMIT);
+  if (found === null) {
+    throw new Error(
+      `No free port found between ${DEFAULT_NEXT_PORT} and ${DEFAULT_NEXT_PORT + PORT_PROBE_LIMIT - 1}. Free a port (e.g. \`lsof -i :${DEFAULT_NEXT_PORT}\`) or pass \`--port <N>\` explicitly.`
+    );
+  }
+  return found;
+}
+async function isPortFree(port) {
+  const { createServer } = await import('net');
+  return new Promise((resolve11) => {
+    const server = createServer();
+    server.once("error", () => {
+      resolve11(false);
+    });
+    server.once("listening", () => {
+      server.close(() => resolve11(true));
+    });
+    server.listen(port, "0.0.0.0");
+  });
+}
+async function findFirstFreePort(start, limit) {
+  for (let i = 0; i < limit; i++) {
+    const port = start + i;
+    if (await isPortFree(port)) return port;
+  }
+  return null;
+}
 async function resolveTargetWorkspace(apiUrl, apiToken, flag) {
   const workspaces = await apiRequest(
     "GET",
@@ -4986,6 +5133,92 @@ async function depsRemoveCommand(providerSlug, options) {
   return 0;
 }
 
+// src/commands/pull.ts
+init_api_client();
+init_manifest_io();
+init_schema_command_context();
+init_output();
+async function pullCommand(options) {
+  let ctx;
+  try {
+    ctx = loadSchemaCommandContext({
+      ...options.dir !== void 0 ? { dir: options.dir } : {}
+    });
+  } catch (err) {
+    fail(err.message);
+    return 1;
+  }
+  info(`Pulling manifest for installation ${ctx.entry.installationId}\u2026`);
+  let remoteManifest;
+  try {
+    const response = await getInstallationSchema(
+      ctx.entry.installationId,
+      ctx.requestOptions
+    );
+    remoteManifest = response.manifest;
+  } catch (err) {
+    return surfacePullFailure(err);
+  }
+  const localJson = JSON.stringify(ctx.manifest, null, 2) + "\n";
+  const remoteJson = JSON.stringify(remoteManifest, null, 2) + "\n";
+  if (localJson === remoteJson) {
+    success("Already in sync \u2014 local module.json matches backend.");
+    return 0;
+  }
+  const localBytes = Buffer.byteLength(localJson, "utf8");
+  const remoteBytes = Buffer.byteLength(remoteJson, "utf8");
+  const delta = remoteBytes - localBytes;
+  const deltaStr = delta === 0 ? "0 bytes" : `${delta > 0 ? "+" : ""}${delta} bytes`;
+  if (options.dryRun) {
+    info(
+      `Drift detected (${deltaStr}). ${code("--dry-run")} \u2014 not writing.`
+    );
+    info(`Run ${code("dashwise pull")} without ${code("--dry-run")} to apply.`);
+    return 0;
+  }
+  try {
+    writeManifest(remoteManifest, ctx.projectRoot);
+  } catch (err) {
+    fail(`Failed to write ${manifestPath(ctx.projectRoot)}: ${err.message}`);
+    return 1;
+  }
+  success(
+    `Synced module.json from backend (${deltaStr}). ${dim(`Run \`dashwise module generate\` to refresh typed SDK if your watcher isn't running.`)}`
+  );
+  return 0;
+}
+function surfacePullFailure(err) {
+  if (err instanceof ApiError) {
+    switch (err.code) {
+      case "UNAUTHENTICATED":
+        fail(
+          `Runtime token rejected. The cached token for this module may be expired \u2014 re-run \`dashwise init <slug> --force\` to mint a fresh one.`
+        );
+        break;
+      case "SANDBOX_TOKEN_NOT_ACCEPTED":
+        fail(
+          `Schema-read endpoint requires a local-dev runtime token (kind=local). The cached token is the wrong kind \u2014 re-run \`dashwise init <slug> --force\`.`
+        );
+        break;
+      case "INSTALL_MISMATCH":
+        fail(
+          `Runtime token is bound to a different installation than expected. The cached install id may be stale \u2014 re-run \`dashwise init <slug> --force\`.`
+        );
+        break;
+      case "INSTALLATION_NOT_FOUND":
+        fail(
+          `The backend has no record of this installation. It may have been destroyed (GC, manual cleanup). Re-run \`dashwise init <slug>\` to provision a fresh one.`
+        );
+        break;
+      default:
+        fail(`Backend rejected: ${err.code} ${err.status} \u2014 ${err.message}`);
+    }
+    return 1;
+  }
+  fail(`Pull failed: ${err.message}`);
+  return 1;
+}
+
 // src/commands/query.ts
 init_manifest_io();
 init_output();
@@ -5591,7 +5824,14 @@ program.command("dev").description(
 ).option(
   "--api-url <url>",
   "Override the `DASHWISE_API_URL` env var passed to children (default: saved CLI config)."
-).option("--port <number>", "Port for `next dev` (default: 3000).", parseIntOption).option("--sdk-only", "Only run the manifest watcher; skip `next dev`.").option("--next-only", "Only run `next dev`; skip the manifest watcher.").action(
+).option("--port <number>", "Port for `next dev` (default: 3000).", parseIntOption).option("--sdk-only", "Only run the manifest watcher; skip `next dev`.").option("--next-only", "Only run `next dev`; skip the manifest watcher.").option(
+  "--no-remote-poll",
+  "Disable periodic backend manifest polling. By default, `dashwise dev` polls `GET /api/installations/:id/schema` every few seconds + writes module.json when the backend has advanced (dashboard edits, AI builder mutations, teammate commands)."
+).option(
+  "--remote-poll-interval <seconds>",
+  "Backend manifest poll interval, in seconds. Default: 5. Minimum: 1.",
+  parseIntOption
+).action(
   async (cmdOpts) => {
     process.exitCode = await devCommand({
       ...cmdOpts.dir !== void 0 ? { dir: cmdOpts.dir } : {},
@@ -5601,7 +5841,11 @@ program.command("dev").description(
       ...cmdOpts.apiUrl !== void 0 ? { apiUrl: cmdOpts.apiUrl } : {},
       ...cmdOpts.port !== void 0 ? { port: cmdOpts.port } : {},
       ...cmdOpts.sdkOnly !== void 0 ? { sdkOnly: cmdOpts.sdkOnly } : {},
-      ...cmdOpts.nextOnly !== void 0 ? { nextOnly: cmdOpts.nextOnly } : {}
+      ...cmdOpts.nextOnly !== void 0 ? { nextOnly: cmdOpts.nextOnly } : {},
+      // Commander's --no-foo flag maps to `foo: false`. devCommand's
+      // option is `noRemotePoll: boolean` — invert to map cleanly.
+      ...cmdOpts.remotePoll === false ? { noRemotePoll: true } : {},
+      ...cmdOpts.remotePollInterval !== void 0 ? { remotePollIntervalSec: cmdOpts.remotePollInterval } : {}
     });
   }
 );
@@ -5753,6 +5997,14 @@ program.command("query").description(
     });
   }
 );
+program.command("pull").description(
+  "Sync local module.json from the backend. Fetches the canonical manifest for the current install and writes it to disk. Inverse of `dashwise table/field` commands."
+).option("--dir <path>", "Project root containing `module.json` (default: current directory).").option("--dry-run", "Fetch + report drift but do not write to module.json.").action(async (cmdOpts) => {
+  process.exitCode = await pullCommand({
+    ...cmdOpts.dir !== void 0 ? { dir: cmdOpts.dir } : {},
+    ...cmdOpts.dryRun !== void 0 ? { dryRun: cmdOpts.dryRun } : {}
+  });
+});
 moduleCmd.command("publish").description("Pack the current directory + upload it as a new module version.").option("--dir <path>", "Project root (default: current directory).").option("--bump <direction>", "Semver bump: patch | minor | major.").option("--dry-run", "Validate + upload but do not persist the version row.").option("-y, --yes", "Skip the confirmation prompt (for CI / scripted use).").option(
   "--exclude <pattern...>",
   "Extra exclude patterns (segment-matched) appended to the defaults."
@@ -5944,7 +6196,7 @@ fieldCmd.command("set-type <table-slug> <field-slug> <new-type>").description(
   }
 })();
 function getVersion() {
-  return "0.3.1";
+  return "0.4.0";
 }
 function parseIntOption(value) {
   const n = Number.parseInt(value, 10);