@specific.dev/cli 0.1.158 → 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":"SdGBMqd60o93Rm-No_m_B","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

@@ -367507,6 +367507,20 @@ function closeDebugLog() {
     logStream = null;
   }
 }
+var ApiError = class extends Error {
+  code;
+  httpStatus;
+  apiError;
+  pendingActions;
+  constructor(args) {
+    super(`${args.operation}: ${args.apiError} (${args.code})`);
+    this.name = "ApiError";
+    this.code = args.code;
+    this.httpStatus = args.httpStatus;
+    this.apiError = args.apiError;
+    if (args.pendingActions) this.pendingActions = args.pendingActions;
+  }
+};
 async function readApiError(response, operation, requestDescriptor) {
   const rawBody = await response.text().catch(() => "");
   writeLog("api:error", `Request was: ${requestDescriptor}`);
@@ -367519,7 +367533,13 @@ async function readApiError(response, operation, requestDescriptor) {
       const parsed = JSON.parse(rawBody);
       if (parsed && typeof parsed === "object" && typeof parsed.error === "string" && typeof parsed.code === "string") {
         const apiErr = parsed;
-        return new Error(`${operation}: ${apiErr.error} (${apiErr.code})`);
+        return new ApiError({
+          operation,
+          code: apiErr.code,
+          httpStatus: response.status,
+          apiError: apiErr.error,
+          ...apiErr.pendingActions && { pendingActions: apiErr.pendingActions }
+        });
       }
     } catch {
     }
@@ -368382,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) {
@@ -368396,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 } : {}
         });
       }
     }
@@ -368408,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({
@@ -368472,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;
@@ -373932,6 +373975,12 @@ function writeProjectId(projectId, projectDir = process.cwd()) {
   }
   fs3.writeFileSync(path3.join(specificDir, "project_id"), projectId + "\n");
 }
+function clearProjectId(projectDir = process.cwd()) {
+  const projectIdPath = path3.join(projectDir, PROJECT_ID_FILE);
+  if (fs3.existsSync(projectIdPath)) {
+    fs3.unlinkSync(projectIdPath);
+  }
+}
 function readEnvironmentId(projectDir = process.cwd()) {
   const envIdPath = path3.join(projectDir, ENVIRONMENT_ID_FILE);
   if (!fs3.existsSync(envIdPath)) {
@@ -373954,6 +374003,12 @@ function writeEnvironmentId(environmentId, projectDir = process.cwd()) {
   }
   fs3.writeFileSync(path3.join(specificDir, "environment_id"), environmentId + "\n");
 }
+function clearEnvironmentId(projectDir = process.cwd()) {
+  const envIdPath = path3.join(projectDir, ENVIRONMENT_ID_FILE);
+  if (fs3.existsSync(envIdPath)) {
+    fs3.unlinkSync(envIdPath);
+  }
+}
 function readPreviewEnvironmentId(projectDir = process.cwd()) {
   const filePath = path3.join(projectDir, PREVIEW_ENVIRONMENT_ID_FILE);
   if (!fs3.existsSync(filePath)) {
@@ -374461,7 +374516,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.158",
+      cli_version: "0.1.160",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -375250,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) {
@@ -375264,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 } : {}
         });
       }
     }
@@ -375276,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({
@@ -375340,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;
@@ -376485,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"
   };
@@ -376611,7 +376690,12 @@ function DeployUI({ envFlag, preview, config }) {
   const handleProjectSelect = useCallback3(
     (project) => {
       if ("type" in project && project.type === "new") {
-        setState((s) => ({ ...s, phase: "entering-name", selectedOrganizationId: project.orgId }));
+        setState((s) => ({
+          ...s,
+          phase: "entering-name",
+          selectedOrganizationId: project.orgId,
+          error: void 0
+        }));
       } else {
         const proj = project;
         writeProjectId(proj.id);
@@ -376667,7 +376751,17 @@ function DeployUI({ envFlag, preview, config }) {
           const client2 = new SpecificClient({ tokenProvider: getValidAccessToken });
           const projects2 = await client2.listProjects();
           const project = projects2.find((p) => p.id === state.projectId);
-          environments = project?.environments ?? [];
+          if (!project) {
+            if (cancelled) return;
+            clearProjectId();
+            clearEnvironmentId();
+            setState({
+              phase: "loading-projects",
+              error: "The linked project no longer exists. Pick another to deploy to."
+            });
+            return;
+          }
+          environments = project.environments;
         }
         if (cancelled) return;
         if (environments.length === 0) {
@@ -376708,6 +376802,7 @@ function DeployUI({ envFlag, preview, config }) {
           return;
         }
         const projectDir = process.cwd();
+        let staleEnvironmentNote;
         if (hasEnvironmentId(projectDir)) {
           const savedEnvId = readEnvironmentId(projectDir);
           const match = environments.find((e) => e.id === savedEnvId);
@@ -376721,6 +376816,8 @@ function DeployUI({ envFlag, preview, config }) {
             }));
             return;
           }
+          clearEnvironmentId(projectDir);
+          staleEnvironmentNote = "The linked environment no longer exists. Pick another.";
         }
         if (environments.length === 1) {
           writeEnvironmentId(environments[0].id);
@@ -376737,7 +376834,8 @@ function DeployUI({ envFlag, preview, config }) {
           ...s,
           phase: "selecting-environment",
           environments,
-          environmentSelectedIndex: 0
+          environmentSelectedIndex: 0,
+          ...staleEnvironmentNote && { error: staleEnvironmentNote }
         }));
       } catch (err) {
         if (cancelled) return;
@@ -376798,7 +376896,8 @@ function DeployUI({ envFlag, preview, config }) {
         ...s,
         phase: "creating-tarball",
         environmentId: env2.id,
-        environmentName: env2.name
+        environmentName: env2.name,
+        error: void 0
       }));
     },
     []
@@ -376994,6 +377093,28 @@ function DeployUI({ envFlag, preview, config }) {
         });
         writeLog("deploy", `Deployment created: ${deployment2.id}`);
       } catch (err) {
+        if (err instanceof ApiError) {
+          if (err.code === "PROJECT_DELETED" || err.code === "PROJECT_NOT_FOUND") {
+            writeLog("deploy:error", `Linked project ${err.code} \u2014 re-linking`);
+            clearProjectId();
+            clearEnvironmentId();
+            setState({
+              phase: "loading-projects",
+              error: err.code === "PROJECT_DELETED" ? "The linked project was deleted. Pick another to deploy to." : "The linked project no longer exists. Pick another to deploy to."
+            });
+            return;
+          }
+          if (err.code === "ENVIRONMENT_NOT_FOUND") {
+            writeLog("deploy:error", "Linked environment ENVIRONMENT_NOT_FOUND \u2014 re-prompting");
+            clearEnvironmentId();
+            setState((s) => ({
+              phase: "loading-environments",
+              projectId: s.projectId,
+              error: "The linked environment no longer exists. Pick another."
+            }));
+            return;
+          }
+        }
         const errorMsg = `Failed to create deployment: ${err instanceof Error ? err.message : String(err)}`;
         writeLog("deploy:error", errorMsg);
         setState({
@@ -377262,12 +377383,12 @@ function DeployUI({ envFlag, preview, config }) {
     return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column", gap: 1 }, /* @__PURE__ */ React7.createElement(Text7, { bold: true }, "Log in to Specific"), userCode ? /* @__PURE__ */ React7.createElement(React7.Fragment, null, /* @__PURE__ */ React7.createElement(Text7, null, "Your authentication code:", " ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan", bold: true }, userCode)), /* @__PURE__ */ React7.createElement(Box7, null, /* @__PURE__ */ React7.createElement(Text7, { color: "blue" }, /* @__PURE__ */ React7.createElement(Spinner4, { type: "dots" })), /* @__PURE__ */ React7.createElement(Text7, null, " Waiting for authentication in browser...")), /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, "If the browser didn't open, visit: ", verificationUri)) : /* @__PURE__ */ React7.createElement(Box7, null, /* @__PURE__ */ React7.createElement(Text7, { color: "blue" }, /* @__PURE__ */ React7.createElement(Spinner4, { type: "dots" })), /* @__PURE__ */ React7.createElement(Text7, null, " Initiating login...")));
   }
   if (phase === "loading-projects") {
-    return /* @__PURE__ */ React7.createElement(Box7, null, /* @__PURE__ */ React7.createElement(Text7, { color: "blue" }, /* @__PURE__ */ React7.createElement(Spinner4, { type: "dots" })), /* @__PURE__ */ React7.createElement(Text7, null, " Loading projects..."));
+    return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, state.error && /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, "Note: ", state.error), /* @__PURE__ */ React7.createElement(Box7, null, /* @__PURE__ */ React7.createElement(Text7, { color: "blue" }, /* @__PURE__ */ React7.createElement(Spinner4, { type: "dots" })), /* @__PURE__ */ React7.createElement(Text7, null, " Loading projects...")));
   }
   if (phase === "selecting-project" && projects && state.organizations && selectedIndex !== void 0) {
     const selectorItems = buildSelectorItems(projects, state.organizations);
     const selectableIndices = selectorItems.map((item, index) => item.type !== "header" ? index : -1).filter((i) => i >= 0);
-    return /* @__PURE__ */ React7.createElement(
+    return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, state.error && /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, "Note: ", state.error), /* @__PURE__ */ React7.createElement(
       ProjectSelector,
       {
         projects,
@@ -377287,7 +377408,7 @@ function DeployUI({ envFlag, preview, config }) {
           return { ...s, selectedIndex: selectableIndices[nextPos] ?? idx };
         })
       }
-    );
+    ));
   }
   if (phase === "entering-name") {
     return /* @__PURE__ */ React7.createElement(NameInput, { onSubmit: handleNameSubmit, onCancel: handleNameCancel });
@@ -377299,7 +377420,7 @@ function DeployUI({ envFlag, preview, config }) {
     return /* @__PURE__ */ React7.createElement(Box7, null, /* @__PURE__ */ React7.createElement(Text7, { color: "blue" }, /* @__PURE__ */ React7.createElement(Spinner4, { type: "dots" })), /* @__PURE__ */ React7.createElement(Text7, null, " Loading environments..."));
   }
   if (phase === "selecting-environment" && state.environments && state.environmentSelectedIndex !== void 0) {
-    return /* @__PURE__ */ React7.createElement(
+    return /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column" }, state.error && /* @__PURE__ */ React7.createElement(Text7, { dimColor: true }, "Note: ", state.error), /* @__PURE__ */ React7.createElement(
       EnvironmentSelector,
       {
         environments: state.environments,
@@ -377317,7 +377438,7 @@ function DeployUI({ envFlag, preview, config }) {
           )
         }))
       }
-    );
+    ));
   }
   const currentSecret = missingSecrets && currentSecretIndex !== void 0 ? missingSecrets[currentSecretIndex] : void 0;
   const currentConfig = missingConfigs && currentConfigIndex !== void 0 ? missingConfigs[currentConfigIndex] : void 0;
@@ -377419,9 +377540,11 @@ async function runDeployPipeline(options2) {
   }
   const client2 = new SpecificClient({ tokenProvider: getValidAccessToken });
   let projectId = options2.projectId;
+  let projectIdFromLinkedFile = false;
   if (!projectId) {
     if (hasProjectId(projectDir)) {
       projectId = readProjectId(projectDir);
+      projectIdFromLinkedFile = true;
     } else {
       console.error(
         "Error: No project linked.\n  Create one first: specific project new <name> [--org <org-id>]\n  Or pass one directly: specific deploy --project <project-id>"
@@ -377448,7 +377571,20 @@ async function runDeployPipeline(options2) {
   }
   const projects = await client2.listProjects();
   const project = projects.find((p) => p.id === projectId);
-  const environments = project?.environments ?? [];
+  if (!project) {
+    if (projectIdFromLinkedFile) {
+      console.error(
+        "Error: The linked project no longer exists or was deleted.\n  Run `specific deploy` interactively to re-link, or remove `.specific/project_id` and try again."
+      );
+    } else {
+      console.error(
+        `Error: Project "${projectId}" not found or not accessible.
+  Check the --project value, or list available projects: specific project list`
+      );
+    }
+    process.exit(1);
+  }
+  const environments = project.environments;
   let environmentId;
   if (options2.environment) {
     const match = findEnvironmentByNameOrId(environments, options2.environment);
@@ -377537,6 +377673,22 @@ async function runDeployPipeline(options2) {
       }
     });
   } catch (err) {
+    if (err instanceof ApiError) {
+      if (err.code === "PROJECT_DELETED" || err.code === "PROJECT_NOT_FOUND") {
+        const what = err.code === "PROJECT_DELETED" ? "The linked project was deleted." : "The linked project no longer exists.";
+        console.error(
+          `Error: ${what}
+  Run \`specific deploy\` interactively to re-link, or remove \`.specific/project_id\` and try again.`
+        );
+        process.exit(1);
+      }
+      if (err.code === "ENVIRONMENT_NOT_FOUND") {
+        console.error(
+          "Error: The linked environment no longer exists.\n  Run `specific deploy` interactively to re-link, or remove `.specific/environment_id` and try again."
+        );
+        process.exit(1);
+      }
+    }
     console.error(`Error: Failed to create deployment: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }
@@ -378572,7 +378724,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.158";
+  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}`);
@@ -379161,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.158").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.158",
+  "version": "0.1.160",
   "description": "CLI for Specific infrastructure-as-code",
   "type": "module",
   "main": "dist/cli.js",