@sequenceholdings/studio-cli 0.1.24 → 0.1.26

package/dist/pipeline/lifecycle.js

@@ -9,6 +9,7 @@ const LOG = '[seq-studio]';
 const TERMINAL = new Set(['active', 'failed', 'retired']);
 const POLL_INTERVAL_MS = 2000;
 const HEARTBEAT_INTERVAL_MS = 20_000;
+const PLAN_TIMEOUT_MS = 30 * 60 * 1000;
 const FIRST_PARTY_TARGETS = [
     { id: 'dev', label: 'Development', requiresApproval: false },
     { id: 'staging', label: 'Staging', requiresApproval: false },
@@ -56,6 +57,9 @@ function flagString(flags, key) {
         throw new Error(`--${key} requires a value`);
     return value;
 }
+function flagOn(flags, key) {
+    return flags[key] === true || flags[key] === 'true';
+}
 export function deployEnvironmentForEnv(env) {
     return env.name === 'local' ? 'dev' : env.name;
 }
@@ -101,19 +105,17 @@ export async function pipelinePlanCommand(args) {
     }
     let response;
     try {
-        response = await postJson({
+        response = await enqueueAndWaitForPlan({
             baseUrl: env.url,
             token,
-            path: '/api/data-pipelines/pipelines/plan',
-            body: { repo, ref, environment: target.id },
+            repo,
+            ref,
+            environment: target.id,
         });
     }
     catch (error) {
-        if (error instanceof AtlasApiError) {
-            console.error(`${LOG} plan failed: ${error.message}`);
-            return 1;
-        }
-        throw error;
+        console.error(`${LOG} plan failed: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
     }
     if (json) {
         console.log(JSON.stringify(response, null, 2));
@@ -129,6 +131,7 @@ export async function pipelineDeployCommand(args) {
     const ref = flagString(args.flags, 'ref');
     const deploymentId = flagString(args.flags, 'deployment-id');
     const approvedBy = flagString(args.flags, 'approved-by');
+    const runNow = flagOn(args.flags, 'run-now');
     const { env, token } = await envAndToken(args);
     let target;
     try {
@@ -144,27 +147,33 @@ export async function pipelineDeployCommand(args) {
             // Direct execute of a persisted plan.
             const stageId = flagString(args.flags, 'stage-id');
             if (!stageId) {
-                console.error('usage: seq-studio pipeline deploy --deployment-id <id> --stage-id <id> -e <env> [--target <id>] [--approved-by <sub>] [--no-wait]');
+                console.error('usage: seq-studio pipeline deploy --deployment-id <id> --stage-id <id> -e <env> [--target <id>] [--approved-by <sub>] [--run-now] [--no-wait]');
                 return 1;
             }
             enqueue = await postJson({
                 baseUrl: env.url,
                 token,
                 path: `/api/data-pipelines/stages/${stageId}/deploy`,
-                body: { deploymentId, environment: target.id, ...(approvedBy ? { approvedBy } : {}) },
+                body: {
+                    deploymentId,
+                    environment: target.id,
+                    ...(approvedBy ? { approvedBy } : {}),
+                    runNow,
+                },
             });
         }
         else {
             if (!repo || !ref) {
-                console.error('usage: seq-studio pipeline deploy --repo pipelines/<slug> --ref <sha|branch> -e <env> [--target <id>] [--approved-by <sub>] [--no-wait]');
+                console.error('usage: seq-studio pipeline deploy --repo pipelines/<slug> --ref <sha|branch> -e <env> [--target <id>] [--approved-by <sub>] [--run-now] [--no-wait]');
                 return 1;
             }
             // Plan then deploy the first planning deployment.
-            const plan = await postJson({
+            const plan = await enqueueAndWaitForPlan({
                 baseUrl: env.url,
                 token,
-                path: '/api/data-pipelines/pipelines/plan',
-                body: { repo, ref, environment: target.id },
+                repo,
+                ref,
+                environment: target.id,
             });
             if (plan.plan.hasDestructive) {
                 console.error(`${LOG} plan has destructive findings — refusing to deploy`);
@@ -190,6 +199,7 @@ export async function pipelineDeployCommand(args) {
                     deploymentId: firstId,
                     environment: target.id,
                     ...(approvedBy ? { approvedBy } : {}),
+                    runNow,
                 },
             });
         }
@@ -250,10 +260,20 @@ export async function pipelinePromoteCommand(args) {
         }
         throw error;
     }
-    console.log(`${LOG} enqueued promote ${enqueue.deploymentId}`);
+    console.log(`${LOG} enqueued promote plan ${enqueue.planRequestId} (trigger=${enqueue.triggerRunId ?? 'n/a'})`);
     if (args.flags['no-wait'] === true || args.flags['no-wait'] === 'true')
         return 0;
-    return pollDeployment({ baseUrl: env.url, token, deploymentId: enqueue.deploymentId });
+    const plan = await waitForPlanRequest({
+        baseUrl: env.url,
+        token,
+        planRequestId: enqueue.planRequestId,
+    });
+    const deploymentId = plan.deploymentIds[plan.stageIds.indexOf(stageId)] ?? plan.deploymentIds[0];
+    if (!deploymentId) {
+        console.error(`${LOG} promote plan completed without a deployment id`);
+        return 1;
+    }
+    return pollDeployment({ baseUrl: env.url, token, deploymentId });
 }
 export async function pipelineRunNowCommand(args) {
     const stage = flagString(args.flags, 'stage');
@@ -404,6 +424,63 @@ async function pollDeployment({ baseUrl, token, deploymentId, }) {
     console.error(`${LOG} timed out waiting for deployment ${deploymentId} (${formatElapsed(Date.now() - started)})`);
     return 1;
 }
+async function enqueueAndWaitForPlan({ baseUrl, token, repo, ref, environment, }) {
+    const enqueue = await postJson({
+        baseUrl,
+        token,
+        path: '/api/data-pipelines/pipelines/plan',
+        body: { repo, ref, environment },
+    });
+    console.log(`${LOG} enqueued plan ${enqueue.planRequestId} (trigger=${enqueue.triggerRunId ?? 'n/a'})`);
+    const detail = await waitForPlanRequest({
+        baseUrl,
+        token,
+        planRequestId: enqueue.planRequestId,
+    });
+    if (!detail.plan || !detail.text) {
+        throw new Error(`plan request ${detail.planRequestId} succeeded without a plan result`);
+    }
+    return {
+        plan: detail.plan,
+        deploymentIds: detail.deploymentIds,
+        stageIds: detail.stageIds,
+        text: detail.text,
+    };
+}
+async function waitForPlanRequest({ baseUrl, token, planRequestId, }) {
+    const started = Date.now();
+    let lastStatus = null;
+    let lastLoggedAt = started;
+    while (Date.now() - started < PLAN_TIMEOUT_MS) {
+        const detail = await getJson({
+            baseUrl,
+            token,
+            path: `/api/data-pipelines/plan-requests/${planRequestId}`,
+        });
+        const elapsed = Date.now() - started;
+        const statusLabel = detail.statusDetail
+            ? `${detail.status} — ${detail.statusDetail}`
+            : detail.status;
+        if (detail.status === 'failed') {
+            throw new Error(`plan request ${detail.planRequestId} failed after ${formatElapsed(elapsed)}: ` +
+                `${detail.statusDetail ?? 'unknown error'}`);
+        }
+        if (detail.status === 'succeeded')
+            return detail;
+        if (statusLabel !== lastStatus) {
+            console.log(`${LOG} plan ${detail.planRequestId}: ${statusLabel} (${formatElapsed(elapsed)})`);
+            lastStatus = statusLabel;
+            lastLoggedAt = Date.now();
+        }
+        else if (Date.now() - lastLoggedAt >= HEARTBEAT_INTERVAL_MS) {
+            console.log(`${LOG} plan ${detail.planRequestId}: still ${statusLabel} (${formatElapsed(elapsed)})`);
+            lastLoggedAt = Date.now();
+        }
+        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    }
+    throw new Error(`timed out waiting for plan request ${planRequestId} ` +
+        `(${formatElapsed(Date.now() - started)})`);
+}
 export async function pipelineAdoptCommand(args) {
     const stage = flagString(args.flags, 'stage');
     const ref = flagString(args.flags, 'ref');

package/dist/preview.d.ts

@@ -6,10 +6,11 @@
  * hand-editing `~/.config/lattice/config.toml`. See
  * `docs/preview-environments.md` for the full lifecycle.
  *
- * SLUG ALGORITHM — must stay byte-for-byte in sync with the three other
+ * SLUG ALGORITHM — must stay byte-for-byte in sync with the other
  * places that compute the same slug from a branch name:
- *   - `.github/workflows/preview-deploy.yml`  (`sed 's/[^a-zA-Z0-9-]/-/g' | tr '[:upper:]' '[:lower:]'`)
- *   - `atlas/src/server/db.ts:sanitize`        (`replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase()`)
+ *   - `.github/workflows/preview-deploy.yml`  (replace non-alnum, lowercase, trim hyphens)
+ *   - `.github/workflows/trigger-preview.yml` (same bash pipeline)
+ *   - `atlas/src/server/db.ts:sanitize`        (`.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase().replace(/^-+|-+$/g, '')`)
  *   - `databricks/lakebase/atlas-db/pr-lifecycle.ts:sanitize`
  * Changing it here without changing those produces a host that does NOT
  * match what `preview-deploy.yml` actually deployed.

package/dist/preview.js

@@ -8,10 +8,11 @@ import { promisify } from 'node:util';
  * hand-editing `~/.config/lattice/config.toml`. See
  * `docs/preview-environments.md` for the full lifecycle.
  *
- * SLUG ALGORITHM — must stay byte-for-byte in sync with the three other
+ * SLUG ALGORITHM — must stay byte-for-byte in sync with the other
  * places that compute the same slug from a branch name:
- *   - `.github/workflows/preview-deploy.yml`  (`sed 's/[^a-zA-Z0-9-]/-/g' | tr '[:upper:]' '[:lower:]'`)
- *   - `atlas/src/server/db.ts:sanitize`        (`replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase()`)
+ *   - `.github/workflows/preview-deploy.yml`  (replace non-alnum, lowercase, trim hyphens)
+ *   - `.github/workflows/trigger-preview.yml` (same bash pipeline)
+ *   - `atlas/src/server/db.ts:sanitize`        (`.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase().replace(/^-+|-+$/g, '')`)
  *   - `databricks/lakebase/atlas-db/pr-lifecycle.ts:sanitize`
  * Changing it here without changing those produces a host that does NOT
  * match what `preview-deploy.yml` actually deployed.
@@ -45,7 +46,7 @@ export const PREVIEW_PROTECTED_SLUGS = [
 export const MAX_LABEL_LENGTH = 63;
 /** Apply the canonical branch → slug transform. */
 export function previewSlug(branchOrSlug) {
-    return branchOrSlug.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
+    return branchOrSlug.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase().replace(/^-+|-+$/g, '');
 }
 /** The `studio-atlas-git-<slug>` DNS label Vercel assigns the preview. */
 export function previewLabel(slug) {

package/dist/repos/commands.d.ts

@@ -96,6 +96,6 @@ export declare function reposCiRequireCommand(args: ParsedArgs): Promise<number>
 export declare function reposCiImportCommand(args: ParsedArgs): Promise<number>;
 export declare function reposCiCommand(args: ParsedArgs): Promise<number>;
 export declare function reposDeleteCommand(args: ParsedArgs): Promise<number>;
-export declare const REPOS_USAGE = "usage:\n  seq-studio repos list -e <env> [--namespace <slug>] [--mine]      repos visible on the environment\n  seq-studio repos namespaces [create <slug>] -e <env>              list or create namespaces\n  seq-studio repos show <ns>/<name> -e <env>                        repo detail (branches, clone URL)\n  seq-studio repos create <ns>/<name> -e <env> [--default-branch b] create an empty repo\n  seq-studio repos clone <ns>/<name> -e <env> [--ref r] [--out dir] [--force]\n  seq-studio repos clone --url <https://\u2026/repos/<id>/git> -e <env> [--ref r] [--out dir]\n  seq-studio repos clone --id <uuid> -e <env> [--ref r] [--out dir]\n                                                                    smart-HTTP when ATLAS_GIT_PAT is set;\n                                                                    otherwise JSON materialize (<ns>/<name>)\n  seq-studio repos pull <ns>/<name> -e <env> [--ref r] [--out dir] [--force]\n                                                                    materialize the tree at a ref (JSON API)\n  seq-studio repos delete <ns>/<name> -e <env> [--yes]              delete a repo (confirm prompt)\n  seq-studio repos ci show <ns>/<name> -e <env> [--ref r]           preview discovered CI checks\n  seq-studio repos ci require <ns>/<name> --check <name> -e <env>   reserved (refuses write until sandboxed runner)\n  seq-studio repos ci import <ns>/<name> -e <env> [--ref r]         reserved (refuses write until sandboxed runner)\n\n  Flags: -e/--env <env> (required; see: seq-studio envs list)\n\n  clone prefers real git clone (PAT via askpass \u2014 never written into the remote\n  URL). Without ATLAS_GIT_PAT, <ns>/<name> falls back to the JSON API and prints\n  how to get a PAT (seq-studio or Atlas UI /settings/tokens).\n  PAT without Auth0 login: use --url from Repositories \u2192 Clone (or --id <uuid>).\n  --ref accepts a branch, tag, or commit SHA (SHA \u2192 clone then checkout).\n\n  Authenticate JSON API calls with: seq-studio login\n  Authenticate git clone/push with: ATLAS_GIT_PAT (from Atlas Settings \u2192 Tokens)\n";
+export declare const REPOS_USAGE = "usage:\n  seq-studio repos list -e <env> [--namespace <slug>] [--mine]      repos visible on the environment\n  seq-studio repos namespaces [create <slug>] -e <env>              list or create namespaces\n  seq-studio repos show <ns>/<name> -e <env>                        repo detail (branches, clone URL)\n  seq-studio repos create <ns>/<name> -e <env> [--default-branch b] create a repo seeded with a Sequence app README\n  seq-studio repos clone <ns>/<name> -e <env> [--ref r] [--out dir] [--force]\n  seq-studio repos clone --url <https://\u2026/repos/<id>/git> -e <env> [--ref r] [--out dir]\n  seq-studio repos clone --id <uuid> -e <env> [--ref r] [--out dir]\n                                                                    smart-HTTP when ATLAS_GIT_PAT is set;\n                                                                    otherwise JSON materialize (<ns>/<name>)\n  seq-studio repos pull <ns>/<name> -e <env> [--ref r] [--out dir] [--force]\n                                                                    materialize the tree at a ref (JSON API)\n  seq-studio repos delete <ns>/<name> -e <env> [--yes]              delete a repo (confirm prompt)\n  seq-studio repos ci show <ns>/<name> -e <env> [--ref r]           preview discovered CI checks\n  seq-studio repos ci require <ns>/<name> --check <name> -e <env>   reserved (refuses write until sandboxed runner)\n  seq-studio repos ci import <ns>/<name> -e <env> [--ref r]         reserved (refuses write until sandboxed runner)\n\n  Flags: -e/--env <env> (required; see: seq-studio envs list)\n\n  clone prefers real git clone (PAT via askpass \u2014 never written into the remote\n  URL). Without ATLAS_GIT_PAT, <ns>/<name> falls back to the JSON API and prints\n  how to get a PAT (seq-studio or Atlas UI /settings/tokens).\n  PAT without Auth0 login: use --url from Repositories \u2192 Clone (or --id <uuid>).\n  --ref accepts a branch, tag, or commit SHA (SHA \u2192 clone then checkout).\n\n  Authenticate JSON API calls with: seq-studio login\n  Authenticate git clone/push with: ATLAS_GIT_PAT (from Atlas Settings \u2192 Tokens)\n";
 export declare function runReposCommand(sub: string | undefined, args: ParsedArgs): Promise<number>;
 export {};

package/dist/repos/commands.js

@@ -748,7 +748,7 @@ export const REPOS_USAGE = `usage:
   seq-studio repos list -e <env> [--namespace <slug>] [--mine]      repos visible on the environment
   seq-studio repos namespaces [create <slug>] -e <env>              list or create namespaces
   seq-studio repos show <ns>/<name> -e <env>                        repo detail (branches, clone URL)
-  seq-studio repos create <ns>/<name> -e <env> [--default-branch b] create an empty repo
+  seq-studio repos create <ns>/<name> -e <env> [--default-branch b] create a repo seeded with a Sequence app README
   seq-studio repos clone <ns>/<name> -e <env> [--ref r] [--out dir] [--force]
   seq-studio repos clone --url <https://…/repos/<id>/git> -e <env> [--ref r] [--out dir]
   seq-studio repos clone --id <uuid> -e <env> [--ref r] [--out dir]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sequenceholdings/studio-cli",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Unified Sequence Studio CLI — `seq-studio init` / `add` / `deploy` (app monorepos), `seq-studio agents`, `seq-studio process` (Lattice), `seq-studio artifact`, `seq-studio functions` / `secrets`, `seq-studio repos`, and `seq-studio auth pat`. Includes Auth0 browser login shared with seqapi.",
   "license": "UNLICENSED",
   "repository": {
@@ -36,13 +36,13 @@
     "README.md"
   ],
   "dependencies": {
-    "js-yaml": "^4.1.1",
+    "js-yaml": "^4.3.1",
     "smol-toml": "^1.4.2",
     "tsx": "^4.20.3",
     "zod": "^4.1.13",
-    "@sequenceholdings/artifact-studio": "0.2.1",
-    "@sequenceholdings/lattice": "0.1.2",
-    "@sequenceholdings/agent-spec": "0.1.1"
+    "@sequenceholdings/agent-spec": "0.1.2",
+    "@sequenceholdings/artifact-studio": "0.2.2",
+    "@sequenceholdings/lattice": "0.1.2"
   },
   "peerDependencies": {
     "@sequenceholdings/orm": "0.1.3",
@@ -61,8 +61,8 @@
     "@types/node": "^22.0.0",
     "typescript": "^5.6.0",
     "vitest": "^4.1.5",
-    "@sequenceholdings/pipeline-spec": "0.1.0",
-    "@sequenceholdings/orm": "0.1.3"
+    "@sequenceholdings/orm": "0.1.3",
+    "@sequenceholdings/pipeline-spec": "0.1.0"
   },
   "engines": {
     "node": ">=20"