@specific.dev/cli 0.1.138 → 0.1.140

package/dist/cli.js

@@ -373282,6 +373282,11 @@ function writePreviewEnvironmentId(environmentId, projectDir = process.cwd()) {
   fs3.writeFileSync(path3.join(specificDir, "preview_environment_id"), environmentId + "\n");
 }
 
+// src/lib/project/environment.ts
+function findEnvironmentByNameOrId(environments, flag) {
+  return environments.find((e) => e.id === flag) ?? environments.find((e) => e.name === flag);
+}
+
 // src/lib/auth/credentials.ts
 import * as fs19 from "fs";
 import * as path17 from "path";
@@ -373563,6 +373568,50 @@ async function performDeviceCodeLogin(deviceCode) {
   }
 }
 
+// src/lib/auth/github-oidc.ts
+var AUDIENCE = "specific.dev";
+var REFRESH_BUFFER_MS = 60 * 1e3;
+var cached = null;
+function isGithubActions() {
+  return process.env.GITHUB_ACTIONS === "true";
+}
+async function fetchGithubActionsIdToken() {
+  const now = Date.now();
+  if (cached && cached.expiresAt - REFRESH_BUFFER_MS > now) {
+    return cached.token;
+  }
+  const url = process.env.ACTIONS_ID_TOKEN_REQUEST_URL;
+  const requestToken = process.env.ACTIONS_ID_TOKEN_REQUEST_TOKEN;
+  if (!url || !requestToken) {
+    throw new Error(
+      "GitHub Actions OIDC token is not available. Add 'permissions: id-token: write' to your workflow job."
+    );
+  }
+  const separator = url.includes("?") ? "&" : "?";
+  const requestUrl = `${url}${separator}audience=${encodeURIComponent(AUDIENCE)}`;
+  const response = await fetch(requestUrl, {
+    method: "GET",
+    headers: {
+      Authorization: `bearer ${requestToken}`,
+      Accept: "application/json; api-version=2.0"
+    }
+  });
+  if (!response.ok) {
+    const body = await response.text().catch(() => "");
+    throw new Error(
+      `Failed to fetch GitHub Actions OIDC token: HTTP ${response.status} ${response.statusText}${body ? ` \u2014 ${body.slice(0, 200)}` : ""}`
+    );
+  }
+  const json = await response.json();
+  if (typeof json.value !== "string" || json.value.length === 0) {
+    throw new Error("GitHub Actions OIDC token response did not include a 'value' field");
+  }
+  const token = json.value;
+  const expiresAt = getTokenExpiresAt(token) ?? Date.now() + 5 * 60 * 1e3;
+  cached = { token, expiresAt };
+  return token;
+}
+
 // src/lib/auth/credentials.ts
 function getUserCredentialsDir() {
   return path17.join(os4.homedir(), ".specific");
@@ -373617,6 +373666,9 @@ async function saveCredentialsFromToken(token) {
   });
 }
 async function getValidAccessToken() {
+  if (isGithubActions()) {
+    return await fetchGithubActionsIdToken();
+  }
   const credentials = readUserCredentials();
   if (!credentials) {
     throw new Error("Not logged in. Run 'specific login' first.");
@@ -373721,7 +373773,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.138",
+      cli_version: "0.1.140",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -375951,12 +376003,12 @@ function DeployUI({ envFlag, preview, config }) {
           return;
         }
         if (envFlag) {
-          const match = environments.find((e) => e.name === envFlag);
+          const match = findEnvironmentByNameOrId(environments, envFlag);
           if (!match) {
             setState((s) => ({
               ...s,
               phase: "error",
-              error: `Environment "${envFlag}" not found. Available: ${environments.map((e) => e.name).join(", ")}`
+              error: `Environment "${envFlag}" not found (matched against name and ID). Available: ${environments.map((e) => e.name).join(", ")}`
             }));
             return;
           }
@@ -376672,8 +376724,9 @@ async function runDeployPipeline(options2) {
   let token;
   try {
     token = await getValidAccessToken();
-  } catch {
-    console.error("Error: Not logged in.\n  Run 'specific login' first.");
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Error: ${message}`);
     process.exit(1);
   }
   const client2 = new SpecificClient({ accessToken: token });
@@ -376703,39 +376756,43 @@ async function runDeployPipeline(options2) {
     const preview = await client2.createPreviewEnvironment(projectId);
     writePreviewEnvironmentId(preview.id, projectDir);
     console.log(`Preview environment "${preview.name}" created (expires: ${new Date(preview.expiresAt).toLocaleString()})`);
-    options2.env = preview.name;
+    options2.environment = preview.name;
   }
+  const projects = await client2.listProjects();
+  const project = projects.find((p) => p.id === projectId);
+  const environments = project?.environments ?? [];
   let environmentName;
-  if (options2.env) {
-    environmentName = options2.env;
+  if (options2.environment) {
+    const match = findEnvironmentByNameOrId(environments, options2.environment);
+    if (!match) {
+      console.error(
+        `Error: Environment "${options2.environment}" not found (matched against name and ID).
+  Available: ${environments.map((e) => e.name).join(", ") || "(none)"}`
+      );
+      process.exit(1);
+    }
+    environmentName = match.name;
+    writeEnvironmentId(match.id);
   } else if (hasEnvironmentId(projectDir)) {
     const savedEnvId = readEnvironmentId(projectDir);
-    const projects = await client2.listProjects();
-    const project = projects.find((p) => p.id === projectId);
-    const env2 = project?.environments.find((e) => e.id === savedEnvId);
+    const env2 = environments.find((e) => e.id === savedEnvId);
     if (env2) {
       environmentName = env2.name;
+    } else if (environments.length === 1) {
+      environmentName = environments[0].name;
+      writeEnvironmentId(environments[0].id);
+    } else if (environments.length === 0) {
+      console.error("Error: No environments found for this project");
+      process.exit(1);
     } else {
-      const environments = project?.environments ?? [];
-      if (environments.length === 1) {
-        environmentName = environments[0].name;
-        writeEnvironmentId(environments[0].id);
-      } else if (environments.length === 0) {
-        console.error("Error: No environments found for this project");
-        process.exit(1);
-      } else {
-        console.error(
-          `Error: Multiple environments available. Specify one with --env.
+      console.error(
+        `Error: Multiple environments available. Specify one with --environment.
   Available: ${environments.map((e) => e.name).join(", ")}
-  Example: specific deploy --env ${environments[0].name}`
-        );
-        process.exit(1);
-      }
+  Example: specific deploy --environment ${environments[0].name}`
+      );
+      process.exit(1);
     }
   } else {
-    const projects = await client2.listProjects();
-    const project = projects.find((p) => p.id === projectId);
-    const environments = project?.environments ?? [];
     if (environments.length === 1) {
       environmentName = environments[0].name;
       writeEnvironmentId(environments[0].id);
@@ -376744,9 +376801,9 @@ async function runDeployPipeline(options2) {
       process.exit(1);
     } else {
       console.error(
-        `Error: Multiple environments available. Specify one with --env.
+        `Error: Multiple environments available. Specify one with --environment.
   Available: ${environments.map((e) => e.name).join(", ")}
-  Example: specific deploy --env ${environments[0].name}`
+  Example: specific deploy --environment ${environments[0].name}`
       );
       process.exit(1);
     }
@@ -376931,7 +376988,7 @@ async function deployCommand(options2) {
     await runDeployPipeline({
       config,
       projectId: options2.project,
-      env: options2.env,
+      environment: options2.environment,
       secrets: options2.secret,
       configs: options2.config,
       preview: options2.preview
@@ -376942,7 +376999,7 @@ async function deployCommand(options2) {
     /* @__PURE__ */ React7.createElement(
       DeployUI,
       {
-        envFlag: options2.env,
+        envFlag: options2.environment,
         preview: options2.preview,
         config
       }
@@ -377827,7 +377884,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.138";
+  const currentVersion = "0.1.140";
   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}`);
@@ -378276,7 +378333,7 @@ async function queryCommand(sqlArg, options2) {
     const projectId = readProjectId();
     const token = await getValidAccessToken();
     const client2 = new SpecificClient({ accessToken: token });
-    const environmentId = await resolveEnvironment(client2, projectId, options2.env);
+    const environmentId = await resolveEnvironment(client2, projectId, options2.environment);
     const result = await client2.runObservabilityQuery(environmentId, sql);
     process.stdout.write(renderTable(result));
   } catch (err) {
@@ -378306,11 +378363,11 @@ async function resolveEnvironment(client2, projectId, envFlag) {
   const status = await client2.getProjectStatus(projectId);
   const environments = status.environments;
   if (envFlag) {
-    const match = environments.find((e) => e.name === envFlag);
+    const match = findEnvironmentByNameOrId(environments, envFlag);
     if (!match) {
       const available = environments.map((e) => e.name).join(", ") || "(none)";
       throw new Error(
-        `Environment "${envFlag}" not found. Available: ${available}`
+        `Environment "${envFlag}" not found (matched against name and ID). Available: ${available}`
       );
     }
     return match.id;
@@ -378329,7 +378386,7 @@ async function resolveEnvironment(client2, projectId, envFlag) {
   }
   const names = environments.map((e) => e.name).join(", ");
   throw new Error(
-    `Project has multiple environments (${names}). Pass --env <name>.`
+    `Project has multiple environments (${names}). Pass --environment <name|id>.`
   );
 }
 function friendlyErrorMessage(raw) {
@@ -378342,7 +378399,7 @@ function friendlyErrorMessage(raw) {
 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.138").enablePositionalOptions();
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.140").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
@@ -378363,10 +378420,11 @@ Examples:
   const key = options2.key ?? getDefaultKey();
   devCommand(key, options2.tunnel ?? false);
 });
-program.command("deploy").description("Deploy to Specific infrastructure").option("--project <id>", "Project ID to deploy to (overrides .projectid file)").option("--env <name>", "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", `
+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:
   $ specific deploy
-  $ specific deploy --env staging
+  $ specific deploy --environment staging
+  $ specific deploy -e env_0abc123
   $ specific deploy --project proj_123
   $ specific deploy --preview
   $ specific deploy --secret db_url=postgres://... --config domain=app.com`).action((options2) => {
@@ -378419,10 +378477,11 @@ Examples:
 program.command("status").description("Show project, environments, and deployment status").addHelpText("after", `
 Examples:
   $ specific status`).action(statusCommand);
-program.command("query [sql]").description("Run a SQL query against your environment's observability data").option("--env <name>", "Target environment (defaults to the current one)").addHelpText("after", `
+program.command("query [sql]").description("Run a SQL query against your environment's observability data").option("-e, --environment <name|id>", "Target environment (defaults to the current one)").addHelpText("after", `
 Examples:
   $ specific query "SELECT count() FROM observability.logs"
-  $ specific query --env staging "SELECT * FROM observability.logs LIMIT 5"
+  $ specific query --environment staging "SELECT * FROM observability.logs LIMIT 5"
+  $ specific query -e env_0abc123 "SELECT * FROM observability.logs LIMIT 5"
   $ cat queries/p99.sql | specific query
   $ specific query - < queries/p99.sql`).action((sql, options2) => {
   queryCommand(sql, options2);

package/package.json

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