@specific.dev/cli 0.1.159 → 0.1.160

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":"e6-YvpGd9Q3oQIstxRX3d","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

@@ -368402,7 +368402,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 +368435,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 +368449,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 +368515,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 +374516,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.159",
+      cli_version: "0.1.160",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -375282,7 +375305,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 +375338,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 +375352,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 +375418,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;
@@ -376517,6 +376563,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"
   };
@@ -378677,7 +378724,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.159";
+  const currentVersion = "0.1.160";
   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 +379313,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.160").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.160",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",