@specific.dev/cli 0.1.181 → 0.1.184

package/dist/cli.js

@@ -368079,8 +368079,13 @@ function toDeployment(response) {
     error: response.error,
     changes: response.changes,
     pendingActions: response.pendingActions,
+    builds: response.builds,
     publicUrls: response.publicUrls,
+    triggeredBy: response.triggeredBy,
+    gitCommitSha: response.gitCommitSha,
     createdAt: response.createdAt,
+    startedAt: response.startedAt,
+    completedAt: response.completedAt,
     uploadUrl: response.uploadUrl,
     maxTarballBytes: response.maxTarballBytes
   };
@@ -368220,6 +368225,14 @@ async function createTarball(config, projectDir) {
   return await createProjectTarball(projectDir, widestContext);
 }
 var import_hcl2_json_parser = __toESM2(require_dist(), 1);
+function extractEnvReferences(value) {
+  if (typeof value === "string")
+    return [];
+  if (value.type === "interpolated") {
+    return value.parts.filter((p) => p.type === "ref").map((p) => p.ref);
+  }
+  return [value];
+}
 var { parseToObject } = import_hcl2_json_parser.default;
 function parseReference(value) {
   if (typeof value !== "string") {
@@ -368991,19 +369004,11 @@ async function parseConfig(hcl) {
     environments: parseEnvironments(json.environment)
   };
 }
-function envValueReferences(value) {
-  if (typeof value === "string")
-    return [];
-  if (value.type === "interpolated") {
-    return value.parts.filter((p) => p.type === "ref").map((p) => p.ref);
-  }
-  return [value];
-}
 function hasPortReference(env2) {
   if (!env2)
     return false;
   for (const value of Object.values(env2)) {
-    for (const ref of envValueReferences(value)) {
+    for (const ref of extractEnvReferences(value)) {
       if (ref.type === "port")
         return true;
     }
@@ -369020,7 +369025,7 @@ function validateEndpointReferences(config) {
     if (!service.env)
       continue;
     for (const [key, value] of Object.entries(service.env)) {
-      const refs = envValueReferences(value);
+      const refs = extractEnvReferences(value);
       for (const ref of refs) {
         if (service.endpoints.length > 1 && ref.type === "port") {
           errors.push({
@@ -369099,6 +369104,82 @@ function validateEndpointReferences(config) {
   }
   return errors;
 }
+var UnknownServiceError = class extends Error {
+  unknownNames;
+  availableServices;
+  cronNames;
+  constructor(unknownNames, availableServices, cronNames) {
+    const plural = unknownNames.length > 1 ? "services" : "service";
+    const names = unknownNames.map((n) => `"${n}"`).join(", ");
+    const available = availableServices.length > 0 ? ` Available services: ${availableServices.join(", ")}` : " No services are defined in specific.hcl.";
+    super(`Unknown ${plural} ${names}.${available}`);
+    this.unknownNames = unknownNames;
+    this.availableServices = availableServices;
+    this.cronNames = cronNames;
+    this.name = "UnknownServiceError";
+  }
+};
+function resolveServiceClosure(config, roots, options2 = {}) {
+  const devMode = options2.devMode ?? true;
+  const byName = new Map(config.services.map((s) => [s.name, s]));
+  const dedupedRoots = [...new Set(roots)];
+  const unknown = dedupedRoots.filter((name) => !byName.has(name));
+  if (unknown.length > 0) {
+    throw new UnknownServiceError(unknown, [...byName.keys()], config.crons.map((c) => c.name));
+  }
+  const visited = new Set(dedupedRoots);
+  const queue = [...dedupedRoots];
+  const postgres = /* @__PURE__ */ new Set();
+  const redis = /* @__PURE__ */ new Set();
+  const storage = /* @__PURE__ */ new Set();
+  const temporal = /* @__PURE__ */ new Set();
+  const mail = /* @__PURE__ */ new Set();
+  const syncPostgres = /* @__PURE__ */ new Set();
+  const effectiveEnv = (service) => devMode ? { ...service.env, ...service.dev?.env } : { ...service.env };
+  while (queue.length > 0) {
+    const service = byName.get(queue.shift());
+    for (const value of Object.values(effectiveEnv(service))) {
+      for (const ref of extractEnvReferences(value)) {
+        switch (ref.type) {
+          case "service":
+            if (byName.has(ref.serviceName) && !visited.has(ref.serviceName)) {
+              visited.add(ref.serviceName);
+              queue.push(ref.serviceName);
+            }
+            break;
+          case "postgres":
+            postgres.add(ref.name);
+            if (ref.attribute === "sync.url" || ref.attribute === "sync.secret") {
+              syncPostgres.add(ref.name);
+            }
+            break;
+          case "redis":
+            redis.add(ref.name);
+            break;
+          case "storage":
+            storage.add(ref.name);
+            break;
+          case "temporal":
+            temporal.add(ref.name);
+            break;
+          case "mail":
+            mail.add(ref.name);
+            break;
+        }
+      }
+    }
+  }
+  const names = (items, set) => items.filter((item) => set.has(item.name)).map((item) => item.name);
+  return {
+    services: names(config.services, visited),
+    postgres: names(config.postgres, postgres),
+    redis: names(config.redis, redis),
+    storage: names(config.storage, storage),
+    temporal: names(config.temporal, temporal),
+    mail: names(config.mail, mail),
+    syncPostgres: names(config.postgres, syncPostgres)
+  };
+}
 function parseHclErrors(rawError) {
   const raw = rawError.trim();
   if (!raw.startsWith("parse config: [")) {
@@ -372583,7 +372664,7 @@ async function startResources(options2) {
     });
   }
   if (shouldStartElectric) {
-    const syncDatabases = detectSyncDatabases(config);
+    const syncDatabases = options2.syncDatabases ?? detectSyncDatabases(config);
     for (const pgName of syncDatabases) {
       if (signal?.cancelled) {
         return { resources, electric, mail: mailServers, startedResources, startedElectric, cancelled: true };
@@ -373082,9 +373163,11 @@ var DevEnvironment = class extends TypedEventEmitter {
   tunnelEnabled;
   preSuppliedSecrets;
   preSuppliedConfigs;
+  servicesFilter;
   // Status
   _status = "idle";
   _config;
+  _selection;
   // Guards
   started = false;
   shuttingDown = false;
@@ -373128,6 +373211,7 @@ var DevEnvironment = class extends TypedEventEmitter {
     this.tunnelEnabled = options2?.tunnel ?? false;
     this.preSuppliedSecrets = options2?.secrets ?? {};
     this.preSuppliedConfigs = options2?.configs ?? {};
+    this.servicesFilter = options2?.services ?? [];
   }
   // ── Public getters ─────────────────────────────────────────────────────────
   get status() {
@@ -373136,6 +373220,10 @@ var DevEnvironment = class extends TypedEventEmitter {
   get config() {
     return this._config;
   }
+  /** The resolved service selection when a services filter is active. */
+  get selection() {
+    return this._selection;
+  }
   // ── Status helper ──────────────────────────────────────────────────────────
   setStatus(status) {
     this._status = status;
@@ -373510,6 +373598,31 @@ var DevEnvironment = class extends TypedEventEmitter {
     }
     if (this.cancelled) return;
     this._config = config;
+    let closure;
+    if (this.servicesFilter.length > 0) {
+      try {
+        closure = resolveServiceClosure(config, this.servicesFilter);
+      } catch (err) {
+        let message = err instanceof Error ? err.message : String(err);
+        if (err instanceof UnknownServiceError) {
+          const crons = err.unknownNames.filter(
+            (n) => err.cronNames.includes(n)
+          );
+          for (const cron of crons) {
+            message += `
+"${cron}" is a cron \u2014 crons don't run in specific dev. Trigger it with: specific exec ${cron}`;
+          }
+        }
+        this.setStatus("error");
+        this.emit("error", new Error(message));
+        return;
+      }
+      this.systemLog(
+        `Starting ${closure.services.length} of ${config.services.length} services: ${closure.services.join(", ")}`
+      );
+    }
+    this._selection = closure;
+    const servicesToRun = closure ? config.services.filter((s) => closure.services.includes(s.name)) : config.services;
     this.colorMap = /* @__PURE__ */ new Map();
     let colorIndex = 0;
     for (const pg of config.postgres) {
@@ -373547,13 +373660,21 @@ var DevEnvironment = class extends TypedEventEmitter {
     this.setStatus("starting");
     const portAllocator = await BlockPortAllocator.create();
     this.systemLog(`Using port block ${portAllocator.getBasePort()}\u2013${portAllocator.getBasePort() + 99}`);
-    const syncDatabases = detectSyncDatabases(config);
+    const syncDatabases = closure ? new Set(closure.syncPostgres) : detectSyncDatabases(config);
     let resources;
     const startedElectric = [];
     try {
       const result = await startResources({
         config,
-        selection: { mode: "all" },
+        selection: closure ? {
+          mode: "required",
+          postgres: closure.postgres,
+          redis: closure.redis,
+          storage: closure.storage,
+          temporal: closure.temporal,
+          mail: closure.mail
+        } : { mode: "all" },
+        syncDatabases,
         stateManager,
         dataDir: `.specific/keys/${this.instanceKey}/data`,
         portAllocator,
@@ -373715,8 +373836,8 @@ var DevEnvironment = class extends TypedEventEmitter {
     if (this.cancelled) return;
     const secrets = await prepareSecrets(config.secrets, true);
     const configs = await prepareConfigs(config.configs, void 0, true);
-    const usedSecrets = findUsedSecrets(config.services, true);
-    const usedConfigs = findUsedConfigs(config.services, true);
+    const usedSecrets = findUsedSecrets(servicesToRun, true);
+    const usedConfigs = findUsedConfigs(servicesToRun, true);
     let missingSecrets = findMissingSecrets(
       config.secrets,
       secrets,
@@ -373800,7 +373921,7 @@ Add them to the config block in specific.local`
     }
     const serviceEndpoints = /* @__PURE__ */ new Map();
     const serviceEndpointPorts = /* @__PURE__ */ new Map();
-    for (const service of config.services) {
+    for (const service of servicesToRun) {
       if (!service.command && !service.dev?.command) continue;
       const endpointPorts = /* @__PURE__ */ new Map();
       const endpointInfos = [];
@@ -373827,7 +373948,7 @@ Add them to the config block in specific.local`
       serviceEndpoints.set(service.name, endpointInfos);
     }
     const exposedServices = [];
-    for (const service of config.services) {
+    for (const service of servicesToRun) {
       const endpointInfos = serviceEndpoints.get(service.name) || [];
       for (const info of endpointInfos) {
         const endpointConfig = service.endpoints.find(
@@ -373873,7 +373994,7 @@ Add them to the config block in specific.local`
       }
       return this.projectDir;
     };
-    for (const service of config.services) {
+    for (const service of servicesToRun) {
       if (this.cancelled) break;
       if (!service.command && !service.dev?.command) {
         continue;
@@ -373942,7 +374063,7 @@ Add them to the config block in specific.local`
       this.systemLog("Restarting services (migration changed)");
       await Promise.all(this.services.map((s) => s.stop()));
       const newServices = [];
-      for (const service of config.services) {
+      for (const service of servicesToRun) {
         if (!service.command && !service.dev?.command) continue;
         try {
           const endpointPorts = serviceEndpointPorts.get(service.name) || /* @__PURE__ */ new Map();
@@ -374765,7 +374886,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.181",
+      cli_version: "0.1.184",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -376233,7 +376354,18 @@ function ConfigInput({ configName, defaultValue, onSubmit, onCancel }) {
 
 // src/commands/dev.tsx
 var COLORS2 = ["cyan", "yellow", "green", "magenta", "blue"];
-function DevUI({ instanceKey, tunnelEnabled }) {
+function filterConfigToSelection(config, selection) {
+  return {
+    ...config,
+    services: config.services.filter((s) => selection.services.includes(s.name)),
+    postgres: config.postgres.filter((p) => selection.postgres.includes(p.name)),
+    redis: config.redis.filter((r) => selection.redis.includes(r.name)),
+    storage: config.storage.filter((s) => selection.storage.includes(s.name)),
+    temporal: config.temporal.filter((t) => selection.temporal.includes(t.name)),
+    mail: config.mail.filter((m) => selection.mail.includes(m.name))
+  };
+}
+function DevUI({ instanceKey, tunnelEnabled, services: serviceFilter }) {
   const { exit } = useApp2();
   const [state, setState] = useState5({
     status: "loading",
@@ -376276,7 +376408,8 @@ function DevUI({ instanceKey, tunnelEnabled }) {
     const devEnv = new DevEnvironment({
       projectDir: process.cwd(),
       instanceKey,
-      tunnel: tunnelEnabled
+      tunnel: tunnelEnabled,
+      services: serviceFilter
     });
     devEnvRef.current = devEnv;
     let currentColorMap = /* @__PURE__ */ new Map();
@@ -376286,12 +376419,18 @@ function DevUI({ instanceKey, tunnelEnabled }) {
       } else if (status === "starting") {
         const config2 = devEnv.config;
         if (config2) {
-          currentColorMap = buildColorMap(config2);
+          const selection = devEnv.selection;
+          const displayConfig = selection ? filterConfigToSelection(config2, selection) : config2;
+          currentColorMap = buildColorMap(displayConfig);
           setState((s) => ({
             ...s,
             status: "starting",
-            config: config2,
-            colorMap: currentColorMap
+            config: displayConfig,
+            colorMap: currentColorMap,
+            filterInfo: selection ? {
+              selected: selection.services.length,
+              total: config2.services.length
+            } : void 0
           }));
         } else {
           setState((s) => ({ ...s, status: "starting" }));
@@ -376408,7 +376547,7 @@ function DevUI({ instanceKey, tunnelEnabled }) {
       devEnv.removeAllListeners();
       devEnvRef.current = null;
     };
-  }, [instanceKey, tunnelEnabled]);
+  }, [instanceKey, tunnelEnabled, serviceFilter.join(",")]);
   useEffect5(() => {
     const handleSignal = () => {
       const devEnv = devEnvRef.current;
@@ -376555,7 +376694,7 @@ function DevUI({ instanceKey, tunnelEnabled }) {
     return /* @__PURE__ */ React6.createElement(Box6, null, /* @__PURE__ */ React6.createElement(Text6, { color: "blue" }, /* @__PURE__ */ React6.createElement(Spinner3, { type: "dots" })));
   }
   if (state.status === "starting") {
-    return /* @__PURE__ */ React6.createElement(Box6, { flexDirection: "column" }, /* @__PURE__ */ React6.createElement(Text6, null, /* @__PURE__ */ React6.createElement(Text6, { bold: true, color: "cyan" }, "Specific dev server"), /* @__PURE__ */ React6.createElement(Text6, { dimColor: true }, " (Ctrl+C to stop)")), /* @__PURE__ */ React6.createElement(Text6, null, " "), (config.postgres.length > 0 || config.redis.length > 0 || config.storage.length > 0 || config.temporal.length > 0) && /* @__PURE__ */ React6.createElement(React6.Fragment, null, /* @__PURE__ */ React6.createElement(Text6, { bold: true }, "Resources:"), config.postgres.map((pg) => {
+    return /* @__PURE__ */ React6.createElement(Box6, { flexDirection: "column" }, /* @__PURE__ */ React6.createElement(Text6, null, /* @__PURE__ */ React6.createElement(Text6, { bold: true, color: "cyan" }, "Specific dev server"), state.filterInfo && /* @__PURE__ */ React6.createElement(Text6, { dimColor: true }, " ", "[", state.filterInfo.selected, " of ", state.filterInfo.total, " services]"), /* @__PURE__ */ React6.createElement(Text6, { dimColor: true }, " (Ctrl+C to stop)")), /* @__PURE__ */ React6.createElement(Text6, null, " "), (config.postgres.length > 0 || config.redis.length > 0 || config.storage.length > 0 || config.temporal.length > 0) && /* @__PURE__ */ React6.createElement(React6.Fragment, null, /* @__PURE__ */ React6.createElement(Text6, { bold: true }, "Resources:"), config.postgres.map((pg) => {
       const instance = resources.get(pg.name);
       const resStatus = state.resourceStatus.get(pg.name);
       const isReady = !!instance;
@@ -376620,7 +376759,7 @@ function DevUI({ instanceKey, tunnelEnabled }) {
   const staticItems = [
     {
       key: "title",
-      content: /* @__PURE__ */ React6.createElement(Text6, null, /* @__PURE__ */ React6.createElement(Text6, { bold: true, color: "cyan" }, "Specific dev server"), tunnelEnabled && /* @__PURE__ */ React6.createElement(Text6, { color: "magenta" }, " [tunnel]"), instanceKey !== "default" && /* @__PURE__ */ React6.createElement(Text6, { color: "yellow" }, " [", instanceKey, "]"), /* @__PURE__ */ React6.createElement(Text6, { dimColor: true }, " (Ctrl+C to stop)"))
+      content: /* @__PURE__ */ React6.createElement(Text6, null, /* @__PURE__ */ React6.createElement(Text6, { bold: true, color: "cyan" }, "Specific dev server"), tunnelEnabled && /* @__PURE__ */ React6.createElement(Text6, { color: "magenta" }, " [tunnel]"), instanceKey !== "default" && /* @__PURE__ */ React6.createElement(Text6, { color: "yellow" }, " [", instanceKey, "]"), state.filterInfo && /* @__PURE__ */ React6.createElement(Text6, { dimColor: true }, " ", "[", state.filterInfo.selected, " of ", state.filterInfo.total, " services]"), /* @__PURE__ */ React6.createElement(Text6, { dimColor: true }, " (Ctrl+C to stop)"))
     },
     { key: "space1", content: /* @__PURE__ */ React6.createElement(Text6, null, " ") },
     // Show admin UI URL
@@ -376730,10 +376869,20 @@ function DevUI({ instanceKey, tunnelEnabled }) {
   ];
   return /* @__PURE__ */ React6.createElement(Box6, { flexDirection: "column" }, /* @__PURE__ */ React6.createElement(Static, { items: staticItems }, (item) => /* @__PURE__ */ React6.createElement(Box6, { key: item.key }, item.content)));
 }
-function devCommand(instanceKey, tunnelEnabled = false) {
+function devCommand(instanceKey, tunnelEnabled = false, services = []) {
   const options2 = isInteractive() ? {} : { stdin: new Readable2({ read() {
   } }) };
-  render4(/* @__PURE__ */ React6.createElement(DevUI, { instanceKey, tunnelEnabled }), options2);
+  render4(
+    /* @__PURE__ */ React6.createElement(
+      DevUI,
+      {
+        instanceKey,
+        tunnelEnabled,
+        services
+      }
+    ),
+    options2
+  );
 }
 
 // src/commands/deploy.tsx
@@ -376743,6 +376892,22 @@ import { render as render5, Text as Text7, Box as Box7, useApp as useApp3, useIn
 import Spinner4 from "ink-spinner";
 import * as fs23 from "fs";
 import * as path21 from "path";
+
+// src/lib/deployments/format.ts
+function formatErrorCode(code) {
+  const labels = {
+    build_failed: "Build failed",
+    pre_deploy_failed: "Pre-deploy hook failed",
+    deploy_failed: "Service failed to deploy",
+    health_check_failed: "Health check failed",
+    post_deploy_failed: "Post-deploy hook failed",
+    volume_reset_failed: "Volume reset failed",
+    internal_error: "Internal error"
+  };
+  return labels[code] || code;
+}
+
+// src/commands/deploy.tsx
 import { execFileSync as execFileSync2 } from "child_process";
 function getGitInfo(cwd) {
   try {
@@ -376944,17 +377109,6 @@ function getFailedBuild(pendingActions) {
   if (!pendingActions) return void 0;
   return pendingActions.find((a) => a.type === "build_failed");
 }
-function formatErrorCode(code) {
-  const labels = {
-    pre_deploy_failed: "Pre-deploy hook failed",
-    deploy_failed: "Service failed to deploy",
-    health_check_failed: "Health check failed",
-    post_deploy_failed: "Post-deploy hook failed",
-    volume_reset_failed: "Volume reset failed",
-    internal_error: "Internal error"
-  };
-  return labels[code] || code;
-}
 function StructuredError({ error }) {
   return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, /* @__PURE__ */ React7.createElement(Text7, { color: "red", bold: true }, formatErrorCode(error.code), ": ", error.message), error.resource && /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, "Resource: ", error.resource), error.output && /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column", marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, { bold: true }, "Output:"), /* @__PURE__ */ React7.createElement(Text7, null, error.output)));
 }
@@ -379147,7 +379301,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.181";
+  const currentVersion = "0.1.184";
   const response = await fetch(`${BINARIES_BASE_URL}/latest?t=${Date.now()}`);
   if (!response.ok) {
     throw new Error(`Failed to check for updates: HTTP ${response.status}`);
@@ -379434,13 +379588,35 @@ function PreviewBlock({ env: env2 }) {
   const urls = managedUrls(env2.domains);
   return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, env2.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.id, ")")), env2.prNumber !== null && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "PR #", env2.prNumber, env2.prTitle ? /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " \u2014 ", env2.prTitle) : null), urls.length > 0 && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "URL: ", urls.join(", ")), env2.expiresAt && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Expires: ", /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, new Date(env2.expiresAt).toLocaleString())));
 }
+function PreviewConfigurationBlock({
+  config,
+  activePreviewCount,
+  showDetails
+}) {
+  const configured = config.github;
+  const enabledConfigs = configured.filter((c) => c.prPreviewsEnabled);
+  const labelGated = enabledConfigs.filter((c) => c.previewsRequireLabel);
+  const githubSummary = enabledConfigs.length > 0 ? `enabled for ${enabledConfigs.length} environment${enabledConfigs.length === 1 ? "" : "s"}` : configured.length > 0 ? "configured but disabled" : "not configured";
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, "Preview configuration"), /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", marginLeft: 2 }, /* @__PURE__ */ React12.createElement(Text12, null, "PR previews: ", config.enabledForOrganization ? "available" : "unavailable", "; GitHub ", githubSummary, ";", " ", labelGated.length > 0 ? `requires ${config.requiredLabel}` : "no label required", "; active ", activePreviewCount), !showDetails && configured.length > 0 && /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "  ", "Run `specific status --previews` for GitHub preview details."), showDetails && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", marginTop: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, "Required label: ", config.requiredLabel), configured.length === 0 ? /* @__PURE__ */ React12.createElement(Text12, null, "GitHub PR automation: not configured") : configured.map((githubConfig) => /* @__PURE__ */ React12.createElement(Box11, { key: githubConfig.environmentId, flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, githubConfig.environmentName), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", githubConfig.environmentId, ")")), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "PR previews: ", githubConfig.prPreviewsEnabled ? "enabled" : "disabled", "; ", "requires label: ", githubConfig.previewsRequireLabel ? "yes" : "no"), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Repository: ", githubConfig.repositoryFullName, /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", githubConfig.branch, ", ", githubConfig.hclPath, ")")))))));
+}
 function EnvironmentBlock({ env: env2 }) {
-  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, env2.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.id, ")")), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Status: ", /* @__PURE__ */ React12.createElement(Text12, { color: statusColor(env2.status), bold: true }, env2.status)), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Active deployment:", " ", env2.activeDeployment ? /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, env2.activeDeployment.id) : /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "none")), env2.inProgressDeployment && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "In progress:", " ", /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, env2.inProgressDeployment.id), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.inProgressDeployment.state, ")")), env2.domains && Object.keys(env2.domains).length > 0 && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Domains:"), Object.entries(env2.domains).map(([serviceName, urls]) => {
+  const latest = env2.latestDeployment;
+  const latestIsShownElsewhere = !latest || latest.id === env2.activeDeployment?.id || latest.id === env2.inProgressDeployment?.id;
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, env2.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.id, ")")), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Status: ", /* @__PURE__ */ React12.createElement(Text12, { color: statusColor(env2.status), bold: true }, env2.status)), /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Active deployment:", " ", env2.activeDeployment ? /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, env2.activeDeployment.id) : /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "none")), env2.inProgressDeployment && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "In progress:", " ", /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, env2.inProgressDeployment.id), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", env2.inProgressDeployment.state, ")")), !latestIsShownElsewhere && /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Last deployment:", " ", /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, latest.id), " ", /* @__PURE__ */ React12.createElement(
+    Text12,
+    {
+      ...latest.state === "failed" ? { color: "red", bold: true } : {}
+    },
+    "(",
+    latest.state,
+    latest.triggeredBy ? ` via ${latest.triggeredBy}` : "",
+    ")"
+  )), !latestIsShownElsewhere && latest.state === "failed" && /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "    ", "Run `specific deployment show ", latest.id, "` for details."), env2.domains && Object.keys(env2.domains).length > 0 && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, null, "  ", "Domains:"), Object.entries(env2.domains).map(([serviceName, urls]) => {
     const displayUrls = urls.custom.length > 0 ? urls.custom : urls.managed ? [urls.managed] : [];
     return /* @__PURE__ */ React12.createElement(Text12, { key: serviceName }, "    - ", serviceName, displayUrls.length > 0 ? `: ${displayUrls.join(", ")}` : null);
   })));
 }
-function StatusUI() {
+function StatusUI({ previews = false }) {
   const [state, setState] = useState11({ phase: "loading" });
   useEffect11(() => {
     (async () => {
@@ -379468,14 +379644,21 @@ function StatusUI() {
     return /* @__PURE__ */ React12.createElement(Text12, { color: "red" }, "Failed to get status: ", state.error);
   }
   const status = state.status;
-  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, status.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", status.id, ")")), /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, "Environments"), status.environments.length === 0 ? /* @__PURE__ */ React12.createElement(Box11, { marginLeft: 2 }, /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "No environments found.")) : /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1, marginLeft: 2 }, status.environments.map((env2) => /* @__PURE__ */ React12.createElement(EnvironmentBlock, { key: env2.id, env: env2 })))), (status.previewEnvironments ?? []).length > 0 && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, "Preview environments"), /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1, marginLeft: 2 }, status.previewEnvironments.map((env2) => /* @__PURE__ */ React12.createElement(PreviewBlock, { key: env2.id, env: env2 })))));
+  return /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React12.createElement(Text12, null, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, status.name), /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, " (", status.id, ")")), /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, "Environments"), status.environments.length === 0 ? /* @__PURE__ */ React12.createElement(Box11, { marginLeft: 2 }, /* @__PURE__ */ React12.createElement(Text12, { dimColor: true }, "No environments found.")) : /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1, marginLeft: 2 }, status.environments.map((env2) => /* @__PURE__ */ React12.createElement(EnvironmentBlock, { key: env2.id, env: env2 })))), /* @__PURE__ */ React12.createElement(
+    PreviewConfigurationBlock,
+    {
+      config: status.previewEnvironmentConfig,
+      activePreviewCount: (status.previewEnvironments ?? []).length,
+      showDetails: previews
+    }
+  ), (status.previewEnvironments ?? []).length > 0 && /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column" }, /* @__PURE__ */ React12.createElement(Text12, { bold: true }, "Preview environments"), /* @__PURE__ */ React12.createElement(Box11, { flexDirection: "column", gap: 1, marginLeft: 2 }, status.previewEnvironments.map((env2) => /* @__PURE__ */ React12.createElement(PreviewBlock, { key: env2.id, env: env2 })))));
 }
-function statusCommand() {
-  render10(/* @__PURE__ */ React12.createElement(StatusUI, null));
+function statusCommand(options2 = {}) {
+  render10(/* @__PURE__ */ React12.createElement(StatusUI, { previews: options2.previews ?? false }));
 }
 
 // src/lib/project/resolve-env.ts
-async function resolveEnvironmentId(client2, projectId, envFlag) {
+async function resolveEnvironmentStatus(client2, projectId, envFlag) {
   const status = await client2.getProjectStatus(projectId);
   const environments = status.environments;
   const previewEnvironments = status.previewEnvironments ?? [];
@@ -379490,16 +379673,19 @@ async function resolveEnvironmentId(client2, projectId, envFlag) {
         `Environment "${envFlag}" not found (matched against name and ID). Available: ${available}`
       );
     }
-    return match.id;
+    return match;
   }
   if (hasEnvironmentId()) {
     const savedId = readEnvironmentId();
-    if (environments.some((e) => e.id === savedId)) {
-      return savedId;
+    const saved = environments.find(
+      (e) => e.id === savedId
+    );
+    if (saved) {
+      return saved;
     }
   }
   if (environments.length === 1) {
-    return environments[0].id;
+    return environments[0];
   }
   if (environments.length === 0) {
     throw new Error("This project has no environments yet.");
@@ -379509,6 +379695,10 @@ async function resolveEnvironmentId(client2, projectId, envFlag) {
     `Project has multiple environments (${names}). Pass --environment <name|id>.`
   );
 }
+async function resolveEnvironmentId(client2, projectId, envFlag) {
+  const match = await resolveEnvironmentStatus(client2, projectId, envFlag);
+  return match.id;
+}
 
 // src/lib/query/render-table.ts
 var MAX_COL_WIDTH = 60;
@@ -379750,6 +379940,204 @@ function friendlyErrorMessage(raw) {
   return raw;
 }
 
+// src/commands/deployment.tsx
+var ANSI2 = {
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  bold: "\x1B[1m",
+  reset: "\x1B[0m"
+};
+async function deploymentShowCommand(idArg, options2) {
+  try {
+    const format = resolveOutputFormat2(options2.format);
+    const includeOutput = options2.output ?? false;
+    const client2 = new SpecificClient({ tokenProvider: getValidAccessToken });
+    let deploymentId = idArg;
+    if (!deploymentId) {
+      const projectId = readProjectId();
+      const env2 = await resolveEnvironmentStatus(
+        client2,
+        projectId,
+        options2.environment
+      );
+      const latest = env2.latestDeployment ?? env2.inProgressDeployment ?? env2.activeDeployment;
+      if (!latest) {
+        throw new Error(
+          `No deployments found for environment "${env2.name}".`
+        );
+      }
+      deploymentId = latest.id;
+    }
+    const deployment = await client2.getDeployment(deploymentId);
+    if (format === "json") {
+      const payload = includeOutput ? deployment : stripOutput(deployment);
+      process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
+      return;
+    }
+    process.stdout.write(renderDeployment(deployment, includeOutput));
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error occurred";
+    console.error(`Error: ${message}`);
+    process.exit(1);
+  }
+}
+function resolveOutputFormat2(format) {
+  if (!format) {
+    return isInteractive() ? "text" : "json";
+  }
+  if (format === "text" || format === "json") {
+    return format;
+  }
+  throw new Error(`Invalid format "${format}". Expected one of: text, json.`);
+}
+function omitOutput(value) {
+  const copy = { ...value };
+  delete copy.output;
+  return copy;
+}
+function stripOutput(deployment) {
+  const stripped = { ...deployment };
+  if (stripped.error) {
+    stripped.error = omitOutput(stripped.error);
+  }
+  if (stripped.builds) {
+    stripped.builds = stripped.builds.map(omitOutput);
+  }
+  if (stripped.pendingActions) {
+    stripped.pendingActions = stripped.pendingActions.map(
+      (a) => a.type === "build_failed" ? omitOutput(a) : a
+    );
+  }
+  return stripped;
+}
+function stateColor(state) {
+  switch (state) {
+    case "active":
+    case "completed":
+      return ANSI2.green;
+    case "failed":
+    case "cancelled":
+      return ANSI2.red;
+    case "superseded":
+      return ANSI2.dim;
+    default:
+      return ANSI2.yellow;
+  }
+}
+function colored(color, text) {
+  return `${color}${text}${ANSI2.reset}`;
+}
+function formatDuration(startIso, endIso) {
+  const ms = new Date(endIso).getTime() - new Date(startIso).getTime();
+  if (!Number.isFinite(ms) || ms < 0) return null;
+  const totalSeconds = Math.round(ms / 1e3);
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  return minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+}
+function formatBytes3(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  return `${(bytes / 1024).toFixed(1)} KB`;
+}
+function renderDeployment(deployment, includeOutput) {
+  const lines = [];
+  lines.push(
+    `${ANSI2.bold}Deployment ${deployment.id}${ANSI2.reset} ${ANSI2.dim}(${deployment.environment})${ANSI2.reset}`
+  );
+  lines.push(
+    `  State:      ${colored(stateColor(deployment.state), deployment.state)}`
+  );
+  if (deployment.stateMessage) {
+    lines.push(`  Message:    ${deployment.stateMessage}`);
+  }
+  if (deployment.triggeredBy) {
+    lines.push(`  Triggered:  ${deployment.triggeredBy}`);
+  }
+  if (deployment.gitCommitSha) {
+    lines.push(`  Commit:     ${deployment.gitCommitSha}`);
+  }
+  lines.push(`  Created:    ${deployment.createdAt}`);
+  if (deployment.completedAt) {
+    const duration = deployment.startedAt ? formatDuration(deployment.startedAt, deployment.completedAt) : null;
+    lines.push(
+      `  Completed:  ${deployment.completedAt}${duration ? ` ${ANSI2.dim}(took ${duration})${ANSI2.reset}` : ""}`
+    );
+  }
+  const builds = deployment.builds ?? [];
+  if (builds.length > 0) {
+    lines.push("");
+    lines.push(`${ANSI2.bold}Builds${ANSI2.reset}`);
+    const nameWidth = Math.max(...builds.map((b) => b.name.length));
+    for (const build of builds) {
+      const marker = build.state === "failed" ? "\u2716" : build.state === "completed" ? "\u2714" : "\u2026";
+      let line = `  ${colored(stateColor(build.state), marker)} ${build.name.padEnd(nameWidth)}  ${colored(stateColor(build.state), build.state)}`;
+      if (build.state === "failed" && build.error) {
+        line += ` ${ANSI2.dim}\u2014 ${build.error}${ANSI2.reset}`;
+      }
+      lines.push(line);
+    }
+  }
+  const pendingActions = deployment.pendingActions ?? [];
+  const missingSecrets = pendingActions.flatMap(
+    (a) => a.type === "missing_secrets" ? a.secrets : []
+  );
+  const missingConfigs = pendingActions.flatMap(
+    (a) => a.type === "missing_configs" ? a.configs : []
+  );
+  if (missingSecrets.length > 0 || missingConfigs.length > 0) {
+    lines.push("");
+    lines.push(colored(ANSI2.yellow, `${ANSI2.bold}Action required${ANSI2.reset}`));
+    if (missingSecrets.length > 0) {
+      lines.push(`  Missing secrets: ${missingSecrets.join(", ")}`);
+    }
+    if (missingConfigs.length > 0) {
+      lines.push(`  Missing configs: ${missingConfigs.join(", ")}`);
+    }
+  }
+  if (deployment.error) {
+    lines.push("");
+    lines.push(
+      colored(
+        ANSI2.red,
+        `${ANSI2.bold}${formatErrorCode(deployment.error.code)}:${ANSI2.reset}${ANSI2.red} ${deployment.error.message}`
+      )
+    );
+    if (deployment.error.resource) {
+      lines.push(`${ANSI2.dim}Resource: ${deployment.error.resource}${ANSI2.reset}`);
+    }
+  }
+  const buildsWithOutput = builds.filter(
+    (b) => typeof b.output === "string" && b.output.length > 0
+  );
+  const extraErrorOutput = deployment.error?.output && !buildsWithOutput.some((b) => b.output === deployment.error?.output) ? deployment.error.output : null;
+  if (includeOutput) {
+    const ordered = [...buildsWithOutput].sort(
+      (a, b) => Number(b.state === "failed") - Number(a.state === "failed")
+    );
+    for (const build of ordered) {
+      lines.push("");
+      lines.push(`${ANSI2.bold}Output (${build.name})${ANSI2.reset}`);
+      lines.push(build.output.trimEnd());
+    }
+    if (extraErrorOutput) {
+      lines.push("");
+      lines.push(`${ANSI2.bold}Output${ANSI2.reset}`);
+      lines.push(extraErrorOutput.trimEnd());
+    }
+  } else {
+    const totalBytes = buildsWithOutput.reduce((sum, b) => sum + b.output.length, 0) + (extraErrorOutput?.length ?? 0);
+    if (totalBytes > 0) {
+      lines.push("");
+      lines.push(
+        `${ANSI2.dim}Output hidden (${formatBytes3(totalBytes)}). Run \`specific deployment show ${deployment.id} --output\` to print it.${ANSI2.reset}`
+      );
+    }
+  }
+  return lines.join("\n") + "\n";
+}
+
 // src/lib/domain/format-dns-instructions.ts
 function isApex(domain) {
   return domain.split(".").length === 2;
@@ -379830,7 +380218,7 @@ async function domainAddCommand(service, domain, options2) {
 var program = new Command();
 var env = "production";
 var envLabel = env !== "production" ? `[${env.toUpperCase()}] ` : "";
-program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.181").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.184").enablePositionalOptions();
 program.command("init").description("Initialize project for use with a coding agent").option("--agent <name...>", "Agents to configure (cursor, claude, codex, other)").addHelpText("after", `
 Examples:
   $ specific init
@@ -379843,13 +380231,14 @@ Examples:
 program.command("check").description("Validate specific.hcl configuration").addHelpText("after", `
 Examples:
   $ specific check`).action(checkCommand);
-program.command("dev").description("Start local development environment").option("-k, --key <key>", "Namespace for isolated dev environment (auto-detected from git worktree if not specified)").option("--tunnel", "Expose public services via public *.tunnel.spcf.app URLs").addHelpText("after", `
+program.command("dev").description("Start local development environment").option("-k, --key <key>", "Namespace for isolated dev environment (auto-detected from git worktree if not specified)").option("--tunnel", "Expose public services via public *.tunnel.spcf.app URLs").option("--services <services...>", "Only start these services and everything they depend on").addHelpText("after", `
 Examples:
   $ specific dev
+  $ specific dev --services api worker
   $ specific dev --tunnel
   $ specific dev --key feature-branch`).action((options2) => {
   const key = options2.key ?? getDefaultKey();
-  devCommand(key, options2.tunnel ?? false);
+  devCommand(key, options2.tunnel ?? false, options2.services ?? []);
 });
 program.command("deploy").description("Deploy to Specific infrastructure").option("--project <id>", "Project ID to deploy to (overrides .projectid file)").option("-e, --environment <name|id>", "Target environment (auto-selected if only one exists)").option("--secret <key=value...>", "Secret values (repeatable)").option("--config <key=value...>", "Config values (repeatable)").option("--preview", "Deploy to an ephemeral preview environment").addHelpText("after", `
 Examples:
@@ -379912,9 +380301,28 @@ Examples:
   $ specific domain add web example.com --environment staging`).action((service, domain, options2) => {
   domainAddCommand(service, domain, options2);
 });
-program.command("status").description("Show project, environments, and deployment status").addHelpText("after", `
+var deploymentCmd = program.command("deployment").description("Inspect deployments");
+deploymentCmd.command("show [id]").description(
+  "Show a deployment's state, builds, and errors (defaults to the latest deployment)"
+).option("-e, --environment <name|id>", "Target environment (defaults to the current one; ignored when an ID is given)").option(
+  "--format <text|json>",
+  "Output format (defaults to text on a TTY, json when piped)"
+).option(
+  "--output",
+  "Include build output (logs); can be large, so it is hidden by default"
+).addHelpText("after", `
+Examples:
+  $ specific deployment show
+  $ specific deployment show dep_0abc123
+  $ specific deployment show dep_0abc123 --output
+  $ specific deployment show --environment staging
+  $ specific deployment show -e preview-a1b2c3d4 --format json`).action((id, options2) => {
+  deploymentShowCommand(id, options2);
+});
+program.command("status").description("Show project, environments, and deployment status").option("--previews", "Show detailed preview environment and GitHub PR preview configuration").addHelpText("after", `
 Examples:
-  $ specific status`).action(statusCommand);
+  $ specific status
+  $ specific status --previews`).action((options2) => statusCommand(options2));
 program.command("query [sql]").description(
   "Run a SQL query against your environment's observability data (ClickHouse), or a Postgres database with --db"
 ).option("-e, --environment <name|id>", "Target environment (defaults to the current one)").option(