@specific.dev/cli 0.1.100 → 0.1.102

package/dist/cli.js

@@ -368427,6 +368427,9 @@ function parseServices(serviceData) {
     if (fieldObj.command) {
       service.command = String(fieldObj.command);
     }
+    if (service.build && !service.command) {
+      throw new Error(`Service "${name}" has a "build" but no "command". Services with a build must specify a command to run.`);
+    }
     if (fieldObj.root) {
       service.root = String(fieldObj.root);
     }
@@ -368445,9 +368448,6 @@ function parseServices(serviceData) {
     } else {
       service.endpoints = endpoints;
     }
-    if (fieldObj.serve) {
-      service.serve = String(fieldObj.serve);
-    }
     const env2 = parseEnv(fieldObj.env);
     if (env2) {
       service.env = env2;
@@ -372273,7 +372273,6 @@ Add them to the config block in specific.local`
     const serviceEndpoints = /* @__PURE__ */ new Map();
     const serviceEndpointPorts = /* @__PURE__ */ new Map();
     for (const service of config.services) {
-      if (service.serve) continue;
       if (!service.command && !service.dev?.command) continue;
       const endpointPorts = /* @__PURE__ */ new Map();
       const endpointInfos = [];
@@ -372347,9 +372346,6 @@ Add them to the config block in specific.local`
     };
     for (const service of config.services) {
       if (this.cancelled) break;
-      if (service.serve) {
-        continue;
-      }
       if (!service.command && !service.dev?.command) {
         continue;
       }
@@ -372400,7 +372396,6 @@ Add them to the config block in specific.local`
       await Promise.all(this.services.map((s) => s.stop()));
       const newServices = [];
       for (const service of config.services) {
-        if (service.serve) continue;
         if (!service.command && !service.dev?.command) continue;
         try {
           const endpointPorts = serviceEndpointPorts.get(service.name) || /* @__PURE__ */ new Map();
@@ -372519,13 +372514,13 @@ Add them to the config block in specific.local`
     const getState = () => ({
       status: "running",
       services: config.services.filter(
-        (svc) => runningServicePorts.has(svc.name) || svc.serve
+        (svc) => runningServicePorts.has(svc.name)
       ).map((svc) => {
         const build = svc.build ? buildsByName.get(svc.build.name) : void 0;
         return {
           name: svc.name,
           port: runningServicePorts.get(svc.name),
-          exposed: !!svc.serve || svc.endpoints.some((e) => e.public),
+          exposed: svc.endpoints.some((e) => e.public),
           env: build?.env ? { ...build.env, ...svc.env } : svc.env
         };
       }),
@@ -373038,7 +373033,7 @@ function trackEvent(event, properties) {
     event,
     properties: {
       ...properties,
-      cli_version: "0.1.100",
+      cli_version: "0.1.102",
       platform: process.platform,
       node_version: process.version,
       project_id: getProjectId()
@@ -373883,6 +373878,9 @@ function parseServices2(serviceData) {
     if (fieldObj.command) {
       service.command = String(fieldObj.command);
     }
+    if (service.build && !service.command) {
+      throw new Error(`Service "${name}" has a "build" but no "command". Services with a build must specify a command to run.`);
+    }
     if (fieldObj.root) {
       service.root = String(fieldObj.root);
     }
@@ -373901,9 +373899,6 @@ function parseServices2(serviceData) {
     } else {
       service.endpoints = endpoints;
     }
-    if (fieldObj.serve) {
-      service.serve = String(fieldObj.serve);
-    }
     const env2 = parseEnv2(fieldObj.env);
     if (env2) {
       service.env = env2;
@@ -375671,7 +375666,185 @@ function DeployUI({ environment, config }) {
     }
   ), phase === "error" && /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1, flexDirection: "column" }, deployment?.error ? /* @__PURE__ */ React7.createElement(StructuredError, { error: deployment.error }) : /* @__PURE__ */ React7.createElement(Text7, { color: "red", bold: true }, error), buildOutput && /* @__PURE__ */ React7.createElement(Box7, { flexDirection: "column", marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text7, { bold: true }, "Build output:"), /* @__PURE__ */ React7.createElement(Text7, null, buildOutput))), phase === "success" && /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React7.createElement(Text7, { color: "green" }, "Deployment successful!"), deployment?.publicUrls && Object.keys(deployment.publicUrls).length > 0 && /* @__PURE__ */ React7.createElement(Box7, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React7.createElement(Text7, { bold: true }, "Public URLs:"), Object.entries(deployment.publicUrls).map(([name, url]) => /* @__PURE__ */ React7.createElement(Text7, { key: name }, "  ", name, ": ", /* @__PURE__ */ React7.createElement(Text7, { color: "cyan" }, url))))));
 }
-async function deployCommand(environment) {
+async function runDeployPipeline(options2) {
+  const { config } = options2;
+  const projectDir = process.cwd();
+  let token;
+  try {
+    token = await getValidAccessToken();
+  } catch {
+    console.error("Error: Not logged in.\n  Run 'specific login' first.");
+    process.exit(1);
+  }
+  const client2 = new SpecificClient({ accessToken: token });
+  let projectId = options2.projectId;
+  if (!projectId) {
+    if (hasProjectId(projectDir)) {
+      projectId = readProjectId(projectDir);
+    } 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>"
+      );
+      process.exit(1);
+    }
+  } else if (!hasProjectId(projectDir)) {
+    writeProjectId(projectId);
+  }
+  const parsedSecrets = {};
+  if (options2.secrets) {
+    for (const s of options2.secrets) {
+      const eqIndex = s.indexOf("=");
+      if (eqIndex > 0) {
+        parsedSecrets[s.substring(0, eqIndex)] = s.substring(eqIndex + 1);
+      }
+    }
+  }
+  const parsedConfigs = {};
+  if (options2.configs) {
+    for (const c of options2.configs) {
+      const eqIndex = c.indexOf("=");
+      if (eqIndex > 0) {
+        parsedConfigs[c.substring(0, eqIndex)] = c.substring(eqIndex + 1);
+      }
+    }
+  }
+  console.log("Creating archive...");
+  let tarball;
+  let appPath;
+  try {
+    const result = await createTarball(config, projectDir);
+    tarball = result.tarball;
+    appPath = result.appPath;
+  } catch (err) {
+    console.error(`Error: Failed to create archive: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  console.log("Creating deployment...");
+  let deployment;
+  try {
+    deployment = await client2.createDeployment(projectId, "prod");
+  } catch (err) {
+    console.error(`Error: Failed to create deployment: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  console.log("Uploading...");
+  try {
+    deployment = await client2.uploadTarball(deployment.id, tarball, appPath);
+  } catch (err) {
+    console.error(`Error: Failed to upload: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  console.log("Waiting for build...");
+  while (true) {
+    await new Promise((resolve9) => setTimeout(resolve9, 2e3));
+    const status = await client2.getDeployment(deployment.id);
+    deployment = status;
+    if (status.state === "failed") {
+      console.error(`Error: Deployment failed: ${status.stateMessage || "Unknown error"}`);
+      process.exit(1);
+    }
+    const failedBuild = getFailedBuild(status.pendingActions);
+    if (failedBuild && failedBuild.type === "build_failed") {
+      console.error(`Error: Build "${failedBuild.serviceName}" failed: ${failedBuild.error}`);
+      if (failedBuild.output) {
+        console.error(`
+Build output:
+${failedBuild.output}`);
+      }
+      process.exit(1);
+    }
+    const missingSecrets = getMissingSecrets(status.pendingActions);
+    if (missingSecrets.length > 0) {
+      const secretsToSubmit = {};
+      const stillMissing = [];
+      for (const name of missingSecrets) {
+        if (parsedSecrets[name] !== void 0) {
+          secretsToSubmit[name] = parsedSecrets[name];
+        } else {
+          stillMissing.push(name);
+        }
+      }
+      if (stillMissing.length > 0) {
+        console.error(
+          `Error: Missing required secrets: ${stillMissing.join(", ")}
+  ${stillMissing.map((s) => `specific deploy --secret ${s}=<value>`).join(" ")}`
+        );
+        process.exit(1);
+      }
+      await client2.submitSecrets(deployment.id, secretsToSubmit);
+      continue;
+    }
+    const missingConfigs = getMissingConfigs(status.pendingActions);
+    if (missingConfigs.length > 0) {
+      const configsToSubmit = {};
+      const stillMissing = [];
+      for (const name of missingConfigs) {
+        if (parsedConfigs[name] !== void 0) {
+          configsToSubmit[name] = parsedConfigs[name];
+        } else {
+          stillMissing.push(name);
+        }
+      }
+      if (stillMissing.length > 0) {
+        console.error(
+          `Error: Missing required configs: ${stillMissing.join(", ")}
+  ${stillMissing.map((c) => `specific deploy --config ${c}=<value>`).join(" ")}`
+        );
+        process.exit(1);
+      }
+      await client2.submitConfigs(deployment.id, configsToSubmit);
+      continue;
+    }
+    if (hasBuildsInProgress(status.pendingActions)) {
+      continue;
+    }
+    if (!status.pendingActions || status.pendingActions.length === 0) {
+      break;
+    }
+  }
+  console.log("Starting deployment...");
+  try {
+    await client2.startDeployment(deployment.id);
+  } catch (err) {
+    console.error(`Error: Failed to start deployment: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  console.log("Deploying...");
+  while (true) {
+    await new Promise((resolve9) => setTimeout(resolve9, 2e3));
+    const status = await client2.getDeployment(deployment.id);
+    deployment = status;
+    if (status.state === "failed") {
+      if (status.error) {
+        console.error(`Error: ${formatErrorCode(status.error.code)}: ${status.error.message}`);
+        if (status.error.output) {
+          console.error(`
+Output:
+${status.error.output}`);
+        }
+      } else {
+        console.error(`Error: Deployment failed: ${status.stateMessage || "Unknown error"}`);
+      }
+      process.exit(1);
+    }
+    if (status.state === "active") {
+      deployment = status;
+      break;
+    }
+  }
+  console.log("");
+  console.log(`\u2713 Deployed successfully`);
+  console.log("");
+  console.log(`  deployment: ${deployment.id}`);
+  if (deployment.publicUrls && Object.keys(deployment.publicUrls).length > 0) {
+    console.log("");
+    console.log("  URLs:");
+    for (const [name, url] of Object.entries(deployment.publicUrls)) {
+      console.log(`    ${name}: ${url}`);
+    }
+  }
+}
+async function deployCommand(options2) {
   const configPath = path19.join(process.cwd(), "specific.hcl");
   if (!fs21.existsSync(configPath)) {
     console.error("Error: No specific.hcl found in current directory");
@@ -375685,12 +375858,21 @@ async function deployCommand(environment) {
     console.error(formatConfigError(err, hcl, configPath));
     process.exit(1);
   }
-  const env2 = environment || "prod";
+  const hasNonInteractiveFlags = options2.project || options2.secret?.length || options2.config?.length;
+  if (!isInteractive() || hasNonInteractiveFlags) {
+    await runDeployPipeline({
+      config,
+      projectId: options2.project,
+      secrets: options2.secret,
+      configs: options2.config
+    });
+    return;
+  }
   render5(
     /* @__PURE__ */ React7.createElement(
       DeployUI,
       {
-        environment: env2,
+        environment: "prod",
         config
       }
     )
@@ -376530,7 +376712,7 @@ function compareVersions(a, b) {
   return 0;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.100";
+  const currentVersion = "0.1.102";
   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}`);
@@ -376725,38 +376907,150 @@ function updateCommand() {
   render9(/* @__PURE__ */ React11.createElement(UpdateUI, null));
 }
 
+// src/commands/project.tsx
+async function projectNewCommand(name, options2) {
+  try {
+    const token = await getValidAccessToken();
+    const client2 = new SpecificClient({ accessToken: token });
+    let orgId = options2.org;
+    if (!orgId) {
+      const organizations = await client2.listOrganizations();
+      if (organizations.length === 0) {
+        console.error(
+          "You don't belong to any organizations. Please create one first."
+        );
+        process.exit(1);
+      }
+      if (organizations.length === 1) {
+        orgId = organizations[0].id;
+      } else {
+        console.error(
+          "You belong to multiple organizations. Please specify one with --org.\n"
+        );
+        console.error("Available organizations:");
+        for (const org of organizations) {
+          console.error(`  ${org.name} (${org.id})`);
+        }
+        process.exit(1);
+      }
+    }
+    const project = await client2.createProject(name, orgId);
+    console.log(`Project created: ${project.id}`);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error occurred";
+    console.error(`Failed to create project: ${message}`);
+    process.exit(1);
+  }
+}
+async function projectListCommand() {
+  try {
+    const token = await getValidAccessToken();
+    const client2 = new SpecificClient({ accessToken: token });
+    const [projects, organizations] = await Promise.all([
+      client2.listProjects(),
+      client2.listOrganizations()
+    ]);
+    if (projects.length === 0) {
+      console.log("No projects found.");
+      return;
+    }
+    const orgMap = new Map(organizations.map((org) => [org.id, org.name]));
+    const grouped = /* @__PURE__ */ new Map();
+    for (const project of projects) {
+      const orgName = orgMap.get(project.organizationId) ?? project.organizationId;
+      if (!grouped.has(orgName)) {
+        grouped.set(orgName, []);
+      }
+      grouped.get(orgName).push({ id: project.id, name: project.name });
+    }
+    for (const [orgName, orgProjects] of grouped) {
+      console.log(`${orgName}:`);
+      for (const project of orgProjects) {
+        console.log(`  ${project.name} (${project.id})`);
+      }
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error occurred";
+    console.error(`Failed to list projects: ${message}`);
+    process.exit(1);
+  }
+}
+
 // src/cli-program.tsx
 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.100").enablePositionalOptions();
-program.command("init").description("Initialize project for use with a coding agent").option("--agent <name...>", "Agents to configure (cursor, claude, codex, other)").action((options2) => initCommand(options2));
-program.command("docs [topic]").description("Fetch LLM-optimized documentation").action(docsCommand);
-program.command("check").description("Validate specific.hcl configuration").action(checkCommand);
-program.command("dev").description("Start local development environment").option("-k, --key <key>", "Namespace for isolated dev environment (auto-detected from git worktree if not specified)").option("--tunnel", "Expose public services via localtunnel URLs").action((options2) => {
+program.name("specific").description(`${envLabel}Infrastructure-as-code for coding agents`).version("0.1.102").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
+  $ specific init --agent claude cursor`).action((options2) => initCommand(options2));
+program.command("docs [topic]").description("Fetch LLM-optimized documentation").addHelpText("after", `
+Examples:
+  $ specific docs
+  $ specific docs services
+  $ specific docs postgres/reshape`).action(docsCommand);
+program.command("check").description("Validate specific.hcl configuration").addHelpText("after", `
+Examples:
+  $ specific check`).action(checkCommand);
+program.command("dev").description("Start local development environment").option("-k, --key <key>", "Namespace for isolated dev environment (auto-detected from git worktree if not specified)").option("--tunnel", "Expose public services via localtunnel URLs").addHelpText("after", `
+Examples:
+  $ specific dev
+  $ specific dev --tunnel
+  $ specific dev --key feature-branch`).action((options2) => {
   const key = options2.key ?? getDefaultKey();
   devCommand(key, options2.tunnel ?? false);
 });
-program.command("deploy [environment]").description("Deploy to Specific infrastructure").action((environment) => {
-  deployCommand(environment);
+program.command("deploy").description("Deploy to Specific infrastructure").option("--project <id>", "Project ID to deploy to (overrides .projectid file)").option("--secret <key=value...>", "Secret values (repeatable)").option("--config <key=value...>", "Config values (repeatable)").addHelpText("after", `
+Examples:
+  $ specific deploy
+  $ specific deploy --project proj_123
+  $ specific deploy --secret db_url=postgres://... --config domain=app.com`).action((options2) => {
+  deployCommand(options2);
 });
-program.command("exec <service> [args...]").description("Run a one-off command with service environment").option("-k, --key <key>", "Dev environment namespace (auto-detected from git worktree if not specified)").passThroughOptions().action(async (service, args, options2) => {
+program.command("exec <service> [args...]").description("Run a one-off command with service environment").option("-k, --key <key>", "Dev environment namespace (auto-detected from git worktree if not specified)").passThroughOptions().addHelpText("after", `
+Examples:
+  $ specific exec api -- npm run migrate
+  $ specific exec worker -- python manage.py shell`).action(async (service, args, options2) => {
   const filteredArgs = args[0] === "--" ? args.slice(1) : args;
   const key = options2.key ?? getDefaultKey();
   await execCommand(service, filteredArgs, key);
 });
-program.command("psql [database] [args...]").description("Connect to a Postgres database").option("-k, --key <key>", "Dev environment namespace (auto-detected from git worktree if not specified)").passThroughOptions().action((database, args, options2) => {
+program.command("psql [database] [args...]").description("Connect to a Postgres database").option("-k, --key <key>", "Dev environment namespace (auto-detected from git worktree if not specified)").passThroughOptions().addHelpText("after", `
+Examples:
+  $ specific psql
+  $ specific psql mydb
+  $ specific psql mydb -- -c "SELECT 1"`).action((database, args, options2) => {
   const filteredArgs = args[0] === "--" ? args.slice(1) : args;
   const key = options2.key ?? getDefaultKey();
   psqlCommand(database, key, filteredArgs);
 });
-program.command("reshape <action> [database]").description("Run Reshape migrations (start|complete|status|abort)").option("-k, --key <key>", "Dev environment namespace (auto-detected from git worktree if not specified)").action((action, database, options2) => {
+program.command("reshape <action> [database]").description("Run Reshape migrations (start|complete|status|abort)").option("-k, --key <key>", "Dev environment namespace (auto-detected from git worktree if not specified)").addHelpText("after", `
+Examples:
+  $ specific reshape start
+  $ specific reshape complete
+  $ specific reshape status mydb`).action((action, database, options2) => {
   const key = options2.key ?? getDefaultKey();
   reshapeCommand(action, database, key);
 });
-program.command("clean").description("Remove .specific directory for a clean slate").option("-k, --key <key>", "Clean only the specified dev environment key").action((options2) => {
+program.command("clean").description("Remove .specific directory for a clean slate").option("-k, --key <key>", "Clean only the specified dev environment key").addHelpText("after", `
+Examples:
+  $ specific clean
+  $ specific clean --key feature-branch`).action((options2) => {
   cleanCommand(options2.key);
 });
+var projectCmd = program.command("project").description("Manage projects");
+projectCmd.command("new <name>").description("Create a new project").option("--org <id>", "Organization ID (required if you belong to multiple organizations)").addHelpText("after", `
+Examples:
+  $ specific project new my-app
+  $ specific project new my-app --org org_123`).action((name, options2) => {
+  projectNewCommand(name, options2);
+});
+projectCmd.command("list").description("List all projects").addHelpText("after", `
+Examples:
+  $ specific project list`).action(() => {
+  projectListCommand();
+});
 program.command("beta").description("Manage beta feature flags").action(betaCommand);
 program.command("update").description("Update Specific CLI to the latest version").action(updateCommand);
 program.command("login").description("Log in to Specific").action(loginCommand);

package/package.json

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