@specific.dev/cli 0.1.159 → 0.1.161

package/dist/admin/workflows/index.txt

@@ -18,7 +18,7 @@ f:"$Sreact.suspense"
 :HL["/_next/static/media/797e433ab948586e-s.p.479bea2b.woff2","font",{"crossOrigin":"","type":"font/woff2"}]
 :HL["/_next/static/media/83afe278b6a6bb3c-s.p.3a6ba036.woff2","font",{"crossOrigin":"","type":"font/woff2"}]
 :HL["/_next/static/media/caa3a2e1cccd8315-s.p.3b6cae6d.woff2","font",{"crossOrigin":"","type":"font/woff2"}]
-0:{"P":null,"b":"tQIwPrBmfmqJ2i8TYKMQV","c":["","workflows",""],"q":"","i":false,"f":[[["",{"children":["(default)",{"children":["workflows",{"children":["__PAGE__",{}]}]}]},"$undefined","$undefined",true],[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/4ae8172f753ceb22.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/chunks/c52b2ebc474a0535.js","async":true,"nonce":"$undefined"}]],["$","html",null,{"lang":"en","className":"inter_b2991b2-module__9mH_6q__variable","suppressHydrationWarning":true,"children":["$","body",null,{"className":"geist_a71539c9-module__T19VSG__variable geist_mono_8d43a2aa-module__8Li5zG__variable antialiased","children":["$","$L2",null,{"attribute":"class","defaultTheme":"system","enableSystem":true,"disableTransitionOnChange":true,"children":["$","$L3",null,{"children":["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]}]}]}]]}],{"children":[["$","$1","c",{"children":[[["$","script","script-0",{"src":"/_next/static/chunks/c7aaec1998a39e17.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/b44581875c51fcd8.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/9835cc4e14c5aee3.js","async":true,"nonce":"$undefined"}],["$","script","script-3",{"src":"/_next/static/chunks/dc5c264e3262a84a.js","async":true,"nonce":"$undefined"}]],["$","$L6",null,{"children":[["$","$L7",null,{}],["$","$L8",null,{"className":"overflow-hidden","children":["$","$L9",null,{"children":["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:style","children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:children:props:children:1:props:style","children":404}],["$","div",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:style","children":["$","h2",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:children:props:style","children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]}]]}]]}],{"children":[["$","$1","c",{"children":[null,["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["$","$1","c",{"children":[["$","$La",null,{"Component":"$b","serverProvidedParams":{"searchParams":{},"params":{},"promises":["$@c","$@d"]}}],[["$","script","script-0",{"src":"/_next/static/chunks/e3baf0c708c5b9ae.js","async":true,"nonce":"$undefined"}]],["$","$Le",null,{"children":["$","$f",null,{"name":"Next.MetadataOutlet","children":"$@10"}]}]]}],{},null,false,false]},null,false,false]},null,false,false]},null,false,false],["$","$1","h",{"children":[null,["$","$L11",null,{"children":"$L12"}],["$","div",null,{"hidden":true,"children":["$","$L13",null,{"children":["$","$f",null,{"name":"Next.Metadata","children":"$L14"}]}]}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}],false]],"m":"$undefined","G":["$15",[]],"S":true}
+0:{"P":null,"b":"4_42SkCjqmgu0V3Wfnmok","c":["","workflows",""],"q":"","i":false,"f":[[["",{"children":["(default)",{"children":["workflows",{"children":["__PAGE__",{}]}]}]},"$undefined","$undefined",true],[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/4ae8172f753ceb22.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/chunks/c52b2ebc474a0535.js","async":true,"nonce":"$undefined"}]],["$","html",null,{"lang":"en","className":"inter_b2991b2-module__9mH_6q__variable","suppressHydrationWarning":true,"children":["$","body",null,{"className":"geist_a71539c9-module__T19VSG__variable geist_mono_8d43a2aa-module__8Li5zG__variable antialiased","children":["$","$L2",null,{"attribute":"class","defaultTheme":"system","enableSystem":true,"disableTransitionOnChange":true,"children":["$","$L3",null,{"children":["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]}]}]}]]}],{"children":[["$","$1","c",{"children":[[["$","script","script-0",{"src":"/_next/static/chunks/c7aaec1998a39e17.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/b44581875c51fcd8.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/9835cc4e14c5aee3.js","async":true,"nonce":"$undefined"}],["$","script","script-3",{"src":"/_next/static/chunks/dc5c264e3262a84a.js","async":true,"nonce":"$undefined"}]],["$","$L6",null,{"children":[["$","$L7",null,{}],["$","$L8",null,{"className":"overflow-hidden","children":["$","$L9",null,{"children":["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:style","children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:children:props:children:1:props:style","children":404}],["$","div",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:style","children":["$","h2",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:children:props:style","children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]}]]}]]}],{"children":[["$","$1","c",{"children":[null,["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["$","$1","c",{"children":[["$","$La",null,{"Component":"$b","serverProvidedParams":{"searchParams":{},"params":{},"promises":["$@c","$@d"]}}],[["$","script","script-0",{"src":"/_next/static/chunks/e3baf0c708c5b9ae.js","async":true,"nonce":"$undefined"}]],["$","$Le",null,{"children":["$","$f",null,{"name":"Next.MetadataOutlet","children":"$@10"}]}]]}],{},null,false,false]},null,false,false]},null,false,false]},null,false,false],["$","$1","h",{"children":[null,["$","$L11",null,{"children":"$L12"}],["$","div",null,{"hidden":true,"children":["$","$L13",null,{"children":["$","$f",null,{"name":"Next.Metadata","children":"$L14"}]}]}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}],false]],"m":"$undefined","G":["$15",[]],"S":true}
 c:{}
 d:"$0:f:0:1:1:children:1:children:1:children:0:props:children:0:props:serverProvidedParams:params"
 12:[["$","meta","0",{"charSet":"utf-8"}],["$","meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1"}]]

package/dist/cli.js

@@ -367507,6 +367507,29 @@ function closeDebugLog() {
     logStream = null;
   }
 }
+var UPLOAD_CHUNK_BYTES = 256 * 1024;
+function progressStreamFromBuffer(buffer, onProgress) {
+  const total = buffer.length;
+  let offset = 0;
+  return new ReadableStream({
+    pull(controller) {
+      if (offset >= total) {
+        controller.close();
+        return;
+      }
+      const end = Math.min(offset + UPLOAD_CHUNK_BYTES, total);
+      const chunk = new Uint8Array(buffer.subarray(offset, end));
+      controller.enqueue(chunk);
+      offset = end;
+      if (onProgress) {
+        try {
+          onProgress(offset, total);
+        } catch {
+        }
+      }
+    }
+  });
+}
 var ApiError = class extends Error {
   code;
   httpStatus;
@@ -367600,17 +367623,22 @@ var ApiClient = class {
     }
     return response.json();
   }
-  async uploadTarball(deploymentId, tarball, appPath = ".") {
+  async uploadTarball(deploymentId, tarball, appPath = ".", onProgress) {
     const url = `${this.baseUrl}/deployments/${deploymentId}/upload`;
     writeLog("api", `POST ${url} (${tarball.length} bytes, appPath: ${appPath})`);
     const response = await fetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/octet-stream",
+        "Content-Length": String(tarball.length),
         "X-App-Path": appPath,
         ...await this.authHeaders()
       },
-      body: new Uint8Array(tarball)
+      body: progressStreamFromBuffer(tarball, onProgress),
+      // Required by undici when body is a ReadableStream — the request body
+      // is streamed half-duplex, not duplex.
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      duplex: "half"
     });
     writeLog("api", `Response: ${response.status} ${response.statusText}`);
     if (!response.ok) {
@@ -367622,6 +367650,62 @@ var ApiClient = class {
     }
     return response.json();
   }
+  /**
+   * PUT the tarball directly to an S3 presigned URL handed back by
+   * createDeployment. Bypasses the platform API entirely on the data path
+   * so large repos don't time out at the ingress.
+   */
+  async uploadTarballToPresignedUrl(presignedUrl, tarball, onProgress) {
+    writeLog(
+      "api",
+      `PUT <presigned> (${tarball.length} bytes)`
+    );
+    const response = await fetch(presignedUrl, {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/gzip",
+        "Content-Length": String(tarball.length)
+      },
+      body: progressStreamFromBuffer(tarball, onProgress),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      duplex: "half"
+    });
+    writeLog("api", `Response: ${response.status} ${response.statusText}`);
+    if (!response.ok) {
+      const bodySnippet = await response.text().catch(() => "");
+      const snippet = bodySnippet.trim().slice(0, 200);
+      const suffix = snippet ? ` \u2014 ${snippet}` : "";
+      throw new Error(
+        `Failed to upload tarball to S3: HTTP ${response.status} ${response.statusText}${suffix}`
+      );
+    }
+  }
+  /**
+   * Tell the platform that the tarball is now in S3 at the deployment's
+   * canonical key. Triggers the same scan + build pipeline as the legacy
+   * /upload route, but without sending bytes through the API.
+   */
+  async notifyUploaded(deploymentId, appPath = ".") {
+    const url = `${this.baseUrl}/deployments/${deploymentId}/uploaded`;
+    writeLog("api", `POST ${url} (appPath: ${appPath})`);
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...await this.authHeaders()
+      },
+      body: JSON.stringify({ appPath })
+    });
+    writeLog("api", `Response: ${response.status} ${response.statusText}`);
+    if (!response.ok) {
+      throw await readApiError(
+        response,
+        "Failed to finalize tarball upload",
+        `POST ${url}`
+      );
+    }
+    return response.json();
+  }
   async getDeployment(deploymentId) {
     const url = `${this.baseUrl}/deployments/${deploymentId}`;
     writeLog("api", `GET ${url}`);
@@ -367907,9 +367991,29 @@ var SpecificClient = class {
       await this.client.createDeployment(projectId, environment, options2)
     );
   }
-  async uploadTarball(deploymentId, tarball, appPath) {
+  async uploadTarball(deploymentId, tarball, appPath, options2) {
+    if (options2?.maxTarballBytes !== void 0 && tarball.length > options2.maxTarballBytes) {
+      throw new Error(
+        `Tarball is ${formatBytes(tarball.length)}; the platform accepts up to ${formatBytes(options2.maxTarballBytes)}. Check for large files that don't need to be deployed (build artifacts, uncompressed media) and exclude them via .gitignore.`
+      );
+    }
+    if (options2?.uploadUrl) {
+      await this.client.uploadTarballToPresignedUrl(
+        options2.uploadUrl,
+        tarball,
+        options2.onProgress
+      );
+      return toDeployment(
+        await this.client.notifyUploaded(deploymentId, appPath ?? ".")
+      );
+    }
     return toDeployment(
-      await this.client.uploadTarball(deploymentId, tarball, appPath)
+      await this.client.uploadTarball(
+        deploymentId,
+        tarball,
+        appPath,
+        options2?.onProgress
+      )
     );
   }
   async getDeployment(deploymentId) {
@@ -367951,9 +368055,18 @@ function toDeployment(response) {
     changes: response.changes,
     pendingActions: response.pendingActions,
     publicUrls: response.publicUrls,
-    createdAt: response.createdAt
+    createdAt: response.createdAt,
+    uploadUrl: response.uploadUrl,
+    maxTarballBytes: response.maxTarballBytes
   };
 }
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 * 1024 * 1024)
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
 function isInsideGitRepository(dir) {
   try {
     const result = execSync("git rev-parse --is-inside-work-tree", {
@@ -368402,7 +368515,26 @@ function parseBuildRef(build) {
   }
   return void 0;
 }
-function parseEndpoints(fieldObj) {
+function parseHealthCheckBlock(serviceName, endpointName, healthCheck) {
+  if (healthCheck === void 0) {
+    return void 0;
+  }
+  const arr = Array.isArray(healthCheck) ? healthCheck : [healthCheck];
+  const obj = arr[0];
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+    throw new Error(`Service "${serviceName}" endpoint "${endpointName}" has an invalid health_check block.`);
+  }
+  const fields = obj;
+  const pathValue = Array.isArray(fields.path) ? fields.path[0] : fields.path;
+  if (typeof pathValue !== "string" || pathValue.trim() === "") {
+    throw new Error(`Service "${serviceName}" endpoint "${endpointName}" health_check is missing required "path".`);
+  }
+  if (!pathValue.startsWith("/")) {
+    throw new Error(`Service "${serviceName}" endpoint "${endpointName}" health_check "path" must start with "/" (got "${pathValue}").`);
+  }
+  return { path: pathValue };
+}
+function parseEndpoints(serviceName, fieldObj) {
   const endpoints = [];
   const endpointData = fieldObj.endpoint;
   if (!endpointData) {
@@ -368416,9 +368548,11 @@ function parseEndpoints(fieldObj) {
       if (ep && typeof ep === "object" && !Array.isArray(ep)) {
         const epObj = ep;
         const publicValue = Array.isArray(epObj.public) ? epObj.public[0] : epObj.public;
+        const healthCheck = parseHealthCheckBlock(serviceName, "default", epObj.health_check);
         endpoints.push({
           name: "default",
-          public: publicValue === true
+          public: publicValue === true,
+          ...healthCheck ? { health_check: healthCheck } : {}
         });
       }
     }
@@ -368428,9 +368562,11 @@ function parseEndpoints(fieldObj) {
       if (fields && typeof fields === "object" && !Array.isArray(fields)) {
         const fieldObj2 = fields;
         const publicValue = Array.isArray(fieldObj2.public) ? fieldObj2.public[0] : fieldObj2.public;
+        const healthCheck = parseHealthCheckBlock(serviceName, name, fieldObj2.health_check);
         endpoints.push({
           name,
-          public: publicValue === true
+          public: publicValue === true,
+          ...healthCheck ? { health_check: healthCheck } : {}
         });
       } else {
         endpoints.push({
@@ -368492,7 +368628,7 @@ function parseServices(serviceData) {
     if (fieldObj.root) {
       service.root = String(fieldObj.root);
     }
-    const endpoints = parseEndpoints(fieldObj);
+    const endpoints = parseEndpoints(name, fieldObj);
     const volumes = parseVolumes(fieldObj);
     if (volumes.length > 0) {
       service.volumes = volumes;
@@ -374493,7 +374629,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.159",
+      cli_version: "0.1.161",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -375282,7 +375418,26 @@ function parseBuildRef2(build) {
   }
   return void 0;
 }
-function parseEndpoints2(fieldObj) {
+function parseHealthCheckBlock2(serviceName, endpointName, healthCheck) {
+  if (healthCheck === void 0) {
+    return void 0;
+  }
+  const arr = Array.isArray(healthCheck) ? healthCheck : [healthCheck];
+  const obj = arr[0];
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+    throw new Error(`Service "${serviceName}" endpoint "${endpointName}" has an invalid health_check block.`);
+  }
+  const fields = obj;
+  const pathValue = Array.isArray(fields.path) ? fields.path[0] : fields.path;
+  if (typeof pathValue !== "string" || pathValue.trim() === "") {
+    throw new Error(`Service "${serviceName}" endpoint "${endpointName}" health_check is missing required "path".`);
+  }
+  if (!pathValue.startsWith("/")) {
+    throw new Error(`Service "${serviceName}" endpoint "${endpointName}" health_check "path" must start with "/" (got "${pathValue}").`);
+  }
+  return { path: pathValue };
+}
+function parseEndpoints2(serviceName, fieldObj) {
   const endpoints = [];
   const endpointData = fieldObj.endpoint;
   if (!endpointData) {
@@ -375296,9 +375451,11 @@ function parseEndpoints2(fieldObj) {
       if (ep && typeof ep === "object" && !Array.isArray(ep)) {
         const epObj = ep;
         const publicValue = Array.isArray(epObj.public) ? epObj.public[0] : epObj.public;
+        const healthCheck = parseHealthCheckBlock2(serviceName, "default", epObj.health_check);
         endpoints.push({
           name: "default",
-          public: publicValue === true
+          public: publicValue === true,
+          ...healthCheck ? { health_check: healthCheck } : {}
         });
       }
     }
@@ -375308,9 +375465,11 @@ function parseEndpoints2(fieldObj) {
       if (fields && typeof fields === "object" && !Array.isArray(fields)) {
         const fieldObj2 = fields;
         const publicValue = Array.isArray(fieldObj2.public) ? fieldObj2.public[0] : fieldObj2.public;
+        const healthCheck = parseHealthCheckBlock2(serviceName, name, fieldObj2.health_check);
         endpoints.push({
           name,
-          public: publicValue === true
+          public: publicValue === true,
+          ...healthCheck ? { health_check: healthCheck } : {}
         });
       } else {
         endpoints.push({
@@ -375372,7 +375531,7 @@ function parseServices2(serviceData) {
     if (fieldObj.root) {
       service.root = String(fieldObj.root);
     }
-    const endpoints = parseEndpoints2(fieldObj);
+    const endpoints = parseEndpoints2(name, fieldObj);
     const volumes = parseVolumes2(fieldObj);
     if (volumes.length > 0) {
       service.volumes = volumes;
@@ -376361,11 +376520,37 @@ function getGitInfo(cwd) {
     return null;
   }
 }
-function formatBytes(bytes) {
+function formatBytes2(bytes) {
   if (bytes < 1024) return `${bytes} B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
   return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
+var PROGRESS_BAR_CELLS = 20;
+var PROGRESS_REPORT_STEP_BYTES = 1024 * 1024;
+function renderProgressBar(bytesSent, totalBytes) {
+  if (totalBytes <= 0) return "";
+  const ratio = Math.min(1, Math.max(0, bytesSent / totalBytes));
+  const filled = Math.round(ratio * PROGRESS_BAR_CELLS);
+  const empty = PROGRESS_BAR_CELLS - filled;
+  const bar = "\u2588".repeat(filled) + "\u2591".repeat(empty);
+  const pct = Math.floor(ratio * 100);
+  return `${bar} ${pct}%  ${formatBytes2(bytesSent)} / ${formatBytes2(totalBytes)}`;
+}
+var PROGRESS_BAR_REVEAL_DELAY_MS = 2e3;
+function makeUploadProgressHandler(setState) {
+  let lastReported = 0;
+  const startedAt = Date.now();
+  return (bytesSent, totalBytes) => {
+    if (Date.now() - startedAt < PROGRESS_BAR_REVEAL_DELAY_MS) return;
+    const done = bytesSent >= totalBytes;
+    if (!done && bytesSent - lastReported < PROGRESS_REPORT_STEP_BYTES) return;
+    lastReported = bytesSent;
+    setState((s) => ({
+      ...s,
+      uploadProgress: { bytesSent, totalBytes }
+    }));
+  };
+}
 function PhaseIndicator({
   phase,
   currentPhase,
@@ -376517,6 +376702,7 @@ 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",
     internal_error: "Internal error"
   };
@@ -377080,7 +377266,11 @@ function DeployUI({ envFlag, preview, config }) {
       setState((s) => ({ ...s, phase: "uploading", deployment: deployment2 }));
       try {
         writeLog("deploy", `Uploading tarball (${tarball.length} bytes, appPath: ${appPath})`);
-        deployment2 = await client2.uploadTarball(deployment2.id, tarball, appPath);
+        deployment2 = await client2.uploadTarball(deployment2.id, tarball, appPath, {
+          uploadUrl: deployment2.uploadUrl,
+          maxTarballBytes: deployment2.maxTarballBytes,
+          onProgress: makeUploadProgressHandler(setState)
+        });
         writeLog("deploy", "Tarball uploaded successfully");
       } catch (err) {
         const errorMsg = `Failed to upload tarball: ${err instanceof Error ? err.message : String(err)}`;
@@ -377319,6 +377509,7 @@ function DeployUI({ envFlag, preview, config }) {
     error,
     buildOutput,
     tarballSize,
+    uploadProgress,
     pendingActions,
     missingSecrets,
     currentSecretIndex,
@@ -377429,7 +377620,7 @@ function DeployUI({ envFlag, preview, config }) {
     {
       phase: "creating-tarball",
       currentPhase: displayPhase,
-      label: `Creating archive${tarballSize ? ` (${formatBytes(tarballSize)})` : ""}`
+      label: `Creating archive${tarballSize ? ` (${formatBytes2(tarballSize)})` : ""}`
     }
   ), /* @__PURE__ */ React7.createElement(
     PhaseIndicator,
@@ -377443,7 +377634,12 @@ function DeployUI({ envFlag, preview, config }) {
     {
       phase: "uploading",
       currentPhase: displayPhase,
-      label: "Uploading"
+      label: (
+        // Only show the bar while we're actively uploading. Once we move
+        // to the next phase, drop back to plain "Uploading" so the
+        // completed-step line stays clean.
+        displayPhase === "uploading" && uploadProgress ? `Uploading  ${renderProgressBar(uploadProgress.bytesSent, uploadProgress.totalBytes)}` : "Uploading"
+      )
     }
   ), /* @__PURE__ */ React7.createElement(
     PhaseIndicator,
@@ -377647,7 +377843,19 @@ async function runDeployPipeline(options2) {
   }
   console.log("Uploading...");
   try {
-    deployment = await client2.uploadTarball(deployment.id, tarball, appPath);
+    let lastPct = -1;
+    deployment = await client2.uploadTarball(deployment.id, tarball, appPath, {
+      uploadUrl: deployment.uploadUrl,
+      maxTarballBytes: deployment.maxTarballBytes,
+      onProgress: (bytesSent, totalBytes) => {
+        const pct = Math.floor(bytesSent / totalBytes * 100);
+        if (pct !== lastPct) {
+          lastPct = pct;
+          process.stdout.write(`\rUploading... ${pct}%`);
+          if (bytesSent >= totalBytes) process.stdout.write("\n");
+        }
+      }
+    });
   } catch (err) {
     console.error(`Error: Failed to upload: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
@@ -378677,7 +378885,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.159";
+  const currentVersion = "0.1.161";
   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}`);
@@ -379266,7 +379474,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.159").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.161").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

package/dist/docs/services.md

@@ -121,6 +121,41 @@ service "worker" {
 }
 ```
 
+### Health checks
+
+Add a `health_check` block inside an `endpoint` to tell Specific how to verify the service is healthy. The platform sends an HTTP `GET` to the given path on the endpoint's port — if the response is `2xx`, the service is considered healthy.
+
+```hcl
+service "api" {
+  build = build.api
+  command = "./api"
+
+  endpoint {
+    public = true
+    health_check {
+      path = "/healthz"
+    }
+  }
+
+  env = {
+    PORT = port
+  }
+}
+```
+
+- `path` - The HTTP path to probe (required, must start with `/`). The service must respond with a `2xx` status code when healthy.
+- A health check should be a low-cost endpoint: don't query the database, call other services, or do real work. Just confirm the process is up and able to respond.
+- Only one `health_check` per service is used. If multiple endpoints declare one, the first one wins.
+- Background workers (services without endpoints) don't support `health_check` yet — only HTTP-serving endpoints do.
+
+**Behavior in production:**
+
+- During a deploy, the new pod doesn't receive traffic until its health check passes. The old version stays up until then, so users never hit a half-started process.
+- If the health check starts failing after the deploy is live, the service is restarted automatically. Traffic is drained from the unhealthy instance well before the restart happens.
+- If the health check never passes during a deploy (typically a misconfigured `path`), the deploy fails fast with a `health_check_failed` error pointing at the probe URL, rather than hanging until the deploy timeout.
+
+A handler that returns `200 OK` with a constant body is sufficient. If the service already exposes a root path that always returns `2xx` (e.g. a static site), you can point `health_check` at `/` instead of adding a dedicated route.
+
 ## Private inter-service communication
 
 Services can reference other services' endpoints using `private_url` to communicate with each other over a private network:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/cli",
-  "version": "0.1.159",
+  "version": "0.1.161",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",