@hyperdrive.bot/cli 1.0.12 → 1.0.16

package/dist/services/hyperdrive-sigv4.js

@@ -17,8 +17,15 @@ const CLI_VERSION = packageJson.version;
 /**
  * Hyperdrive API Service with AWS SigV4 authentication
  */
+// API-137: parameter HTTP endpoints split out of the main hyperdrive APIGW
+// into a dedicated `api-hyperdrive-parameter-live` APIGW (API-135 follow-up).
+// Hardcoded fallback used until the auth bootstrap returns this entry in
+// `additionalApiUrls['hyperdrive-parameter']`.
+const HYPERDRIVE_PARAMETER_API_URL_LIVE = 'https://rtxiim14g6.execute-api.sa-east-1.amazonaws.com/live';
 export class HyperdriveSigV4Service extends SigV4ApiClient {
+    projectsApiUrl;
     userGroupsApiUrl;
+    parameterApiUrl;
     constructor(domain) {
         super({
             authConfig: HYPERDRIVE_AUTH_CONFIG,
@@ -28,8 +35,17 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
             apiUrlOverride: process.env.HYPERDRIVE_API_URL,
             regionOverride: process.env.HYPERDRIVE_AWS_REGION,
         });
-        // Get user groups API URL from credentials (key matches bootstrap REST config name)
+        // Reunified: all endpoints served by the main hyperdrive API
+        this.projectsApiUrl = this.getAdditionalApiUrl('hyperdrive');
         this.userGroupsApiUrl = this.getAdditionalApiUrl('user-groups');
+        // Parameter sub-module APIGW (API-135). Prefer dynamic discovery; fall
+        // back to env override or hardcoded live URL until backend wires the
+        // discovery entry. Once `additionalApiUrls['hyperdrive-parameter']` is
+        // populated, the fallback becomes inert without touching this code.
+        this.parameterApiUrl =
+            this.getAdditionalApiUrl('hyperdrive-parameter') ??
+                process.env.HYPERDRIVE_PARAMETER_API_URL ??
+                HYPERDRIVE_PARAMETER_API_URL_LIVE;
     }
     // ============================================================================
     // AWS Account Methods
@@ -184,6 +200,15 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
     async deploymentList(params) {
         return this.makeSignedRequest('GET', `/deployments?projectSlug=${params.projectSlug}&stage=${params.stage}`);
     }
+    async deploymentCreateStatic(params) {
+        return this.makeSignedRequest('POST', '/deployments/static', params);
+    }
+    async deploymentFinalizeStatic(deploymentId, options) {
+        return this.makeSignedRequest('POST', `/deployments/${deploymentId}/finalize`, {
+            deploymentId,
+            ...(options?.spa !== undefined && { spa: options.spa }),
+        });
+    }
     // ============================================================================
     // Git Integration Methods
     // ============================================================================
@@ -213,16 +238,16 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
     // Hook Methods
     // ============================================================================
     async hookCreate(projectId, body) {
-        return this.makeSignedRequest('POST', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks`, body);
+        return this.makeSignedRequest('POST', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks`, body, this.projectsApiUrl);
     }
     async hookCreateV2(projectId, body) {
-        return this.makeSignedRequest('POST', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks`, body);
+        return this.makeSignedRequest('POST', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks`, body, this.projectsApiUrl);
     }
     async hookDelete(projectId, hookId) {
-        return this.makeSignedRequest('DELETE', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks/${encodeURIComponent(hookId)}`);
+        return this.makeSignedRequest('DELETE', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks/${encodeURIComponent(hookId)}`, undefined, this.projectsApiUrl);
     }
     async hookList(projectId) {
-        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks`);
+        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks`, undefined, this.projectsApiUrl);
     }
     async hookLogList(projectId, options) {
         const params = new URLSearchParams();
@@ -231,10 +256,37 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
         if (options?.status)
             params.set('status', options.status);
         const qs = params.toString() ? `?${params.toString()}` : '';
-        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hook-logs${qs}`);
+        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hook-logs${qs}`, undefined, this.projectsApiUrl);
     }
     async hookUpdate(projectId, hookId, body) {
-        return this.makeSignedRequest('PATCH', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks/${encodeURIComponent(hookId)}`, body);
+        return this.makeSignedRequest('PATCH', `/hyperdrive/projects/${encodeURIComponent(projectId)}/hooks/${encodeURIComponent(hookId)}`, body, this.projectsApiUrl);
+    }
+    // ============================================================================
+    // Tenant Lifecycle Hook Methods
+    // ============================================================================
+    async tenantHookCreate(body) {
+        return this.makeSignedRequest('POST', '/hyperdrive/hooks', body, this.projectsApiUrl);
+    }
+    async tenantHookDelete(hookId) {
+        return this.makeSignedRequest('DELETE', `/hyperdrive/hooks/${encodeURIComponent(hookId)}`, undefined, this.projectsApiUrl);
+    }
+    async tenantHookGet(hookId) {
+        return this.makeSignedRequest('GET', `/hyperdrive/hooks/${encodeURIComponent(hookId)}`, undefined, this.projectsApiUrl);
+    }
+    async tenantHookList() {
+        return this.makeSignedRequest('GET', '/hyperdrive/hooks', undefined, this.projectsApiUrl);
+    }
+    async tenantHookLogList(options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        if (options?.status)
+            params.set('status', options.status);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        return this.makeSignedRequest('GET', `/hyperdrive/hooks/logs${qs}`, undefined, this.projectsApiUrl);
+    }
+    async tenantHookUpdate(hookId, body) {
+        return this.makeSignedRequest('PATCH', `/hyperdrive/hooks/${encodeURIComponent(hookId)}`, body, this.projectsApiUrl);
     }
     async projectGetJiraStatuses(projectId) {
         return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/jira/statuses`);
@@ -242,35 +294,94 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
     // ============================================================================
     // Jira Integration Methods
     // ============================================================================
+    async jiraListProjects() {
+        return this.makeSignedRequest('GET', '/hyperdrive/jira/projects', undefined, this.projectsApiUrl);
+    }
     async jiraGetProjectStatuses(jiraProjectKey) {
-        return this.makeSignedRequest('GET', `/hyperdrive/jira/projects/${encodeURIComponent(jiraProjectKey)}/statuses`);
+        return this.makeSignedRequest('GET', `/hyperdrive/jira/projects/${encodeURIComponent(jiraProjectKey)}/statuses`, undefined, this.projectsApiUrl);
     }
     async jiraPreRegister(params) {
-        return this.makeSignedRequest('POST', '/hyperdrive/jira/pre-register', params);
+        return this.makeSignedRequest('POST', '/hyperdrive/jira/pre-register', params, this.projectsApiUrl);
+    }
+    async jiraStatus() {
+        return this.makeSignedRequest('GET', '/hyperdrive/jira/status', undefined, this.projectsApiUrl);
+    }
+    // ============================================================================
+    // Tracker Project Methods
+    // ============================================================================
+    async trackerProjectCreate(data) {
+        return this.makeSignedRequest('POST', '/hyperdrive/tracker-projects', data, this.projectsApiUrl);
+    }
+    async trackerProjectDelete(trackerProjectId) {
+        return this.makeSignedRequest('DELETE', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}`, undefined, this.projectsApiUrl);
+    }
+    async trackerProjectHookCreate(trackerProjectId, body) {
+        return this.makeSignedRequest('POST', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/hooks`, body, this.projectsApiUrl);
+    }
+    async trackerProjectHookCreateV2(trackerProjectId, body) {
+        return this.makeSignedRequest('POST', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/hooks`, body, this.projectsApiUrl);
+    }
+    async trackerProjectHookDelete(trackerProjectId, hookId) {
+        return this.makeSignedRequest('DELETE', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/hooks/${encodeURIComponent(hookId)}`, undefined, this.projectsApiUrl);
+    }
+    async trackerProjectHookList(trackerProjectId) {
+        return this.makeSignedRequest('GET', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/hooks`, undefined, this.projectsApiUrl);
+    }
+    async trackerProjectHookLogList(trackerProjectId, options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        if (options?.status)
+            params.set('status', options.status);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        return this.makeSignedRequest('GET', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/hook-logs${qs}`, undefined, this.projectsApiUrl);
+    }
+    async trackerProjectHookUpdate(trackerProjectId, hookId, body) {
+        return this.makeSignedRequest('PATCH', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/hooks/${encodeURIComponent(hookId)}`, body, this.projectsApiUrl);
+    }
+    async trackerProjectLinkModule(trackerProjectId, data) {
+        return this.makeSignedRequest('POST', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/modules`, data, this.projectsApiUrl);
+    }
+    async trackerProjectList() {
+        const response = await this.makeSignedRequest('GET', '/hyperdrive/tracker-projects', undefined, this.projectsApiUrl);
+        return Array.isArray(response) ? response : response.items;
+    }
+    async trackerProjectListModules(trackerProjectId) {
+        const response = await this.makeSignedRequest('GET', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/modules`, undefined, this.projectsApiUrl);
+        return response.items ?? [];
+    }
+    async trackerProjectUnlinkModule(trackerProjectId, moduleId) {
+        await this.makeSignedRequest('DELETE', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/modules/${encodeURIComponent(moduleId)}`, undefined, this.projectsApiUrl);
+    }
+    async trackerProjectGet(trackerProjectId) {
+        return this.makeSignedRequest('GET', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}`, undefined, this.projectsApiUrl);
+    }
+    async trackerProjectGetContext(trackerProjectId) {
+        return this.makeSignedRequest('GET', `/hyperdrive/tracker-projects/${encodeURIComponent(trackerProjectId)}/context`, undefined, this.projectsApiUrl);
     }
     // ============================================================================
     // Hyperdrive Project Methods
     // ============================================================================
     async projectAddRepo(projectId, repo) {
-        return this.makeSignedRequest('POST', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos`, repo);
+        return this.makeSignedRequest('POST', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos`, repo, this.projectsApiUrl);
     }
     async projectFindByJiraKey(jiraProjectKey) {
-        return this.makeSignedRequest('GET', `/hyperdrive/projects/by-jira-key/${encodeURIComponent(jiraProjectKey)}`);
+        return this.makeSignedRequest('GET', `/hyperdrive/projects/by-jira-key/${encodeURIComponent(jiraProjectKey)}`, undefined, this.projectsApiUrl);
     }
     async projectGetJiraConfig(projectId) {
-        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/jira-config`);
+        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/jira-config`, undefined, this.projectsApiUrl);
     }
     async projectListRepos(projectId) {
-        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos`);
+        return this.makeSignedRequest('GET', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos`, undefined, this.projectsApiUrl);
     }
     async projectSetJiraConfig(projectId, config) {
-        return this.makeSignedRequest('PUT', `/hyperdrive/projects/${encodeURIComponent(projectId)}/jira-config`, config);
+        return this.makeSignedRequest('PUT', `/hyperdrive/projects/${encodeURIComponent(projectId)}/jira-config`, config, this.projectsApiUrl);
     }
     async projectUpdateRepo(projectId, repoId, updateData) {
-        return this.makeSignedRequest('PATCH', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos/${encodeURIComponent(repoId)}`, updateData);
+        return this.makeSignedRequest('PATCH', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos/${encodeURIComponent(repoId)}`, updateData, this.projectsApiUrl);
     }
     async projectUpdateEntities(projectId, repoId, entities) {
-        return this.makeSignedRequest('PUT', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos/${encodeURIComponent(repoId)}/entities`, entities);
+        return this.makeSignedRequest('PUT', `/hyperdrive/projects/${encodeURIComponent(projectId)}/repos/${encodeURIComponent(repoId)}/entities`, entities, this.projectsApiUrl);
     }
     // ============================================================================
     // Module Methods
@@ -304,12 +415,18 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
     async moduleLink(params) {
         return this.makeSignedRequest('POST', '/modules/link', params);
     }
+    async moduleUnlink(params) {
+        return this.makeSignedRequest('POST', '/modules/unlink', params);
+    }
     async moduleList() {
         return this.makeSignedRequest('GET', '/modules');
     }
     async moduleReanalyze(slug, userPrompt) {
         return this.makeSignedRequest('POST', `/modules/${slug}/reanalyze`, { userPrompt });
     }
+    async moduleUpdateContext(moduleSlug, data) {
+        return this.makeSignedRequest('PUT', `/modules/${encodeURIComponent(moduleSlug)}/context`, data);
+    }
     async moduleUpdate(params) {
         const { slug, ...updateData } = params;
         return this.makeSignedRequest('PUT', `/modules/${slug}`, updateData);
@@ -318,25 +435,25 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
     // Parameter Methods
     // ============================================================================
     async parameterAdd(params) {
-        return this.makeSignedRequest('POST', '/parameters', params);
+        return this.makeSignedRequest('POST', '/parameters', params, this.parameterApiUrl);
     }
     async parameterBackfill(params) {
-        return this.makeSignedRequest('POST', '/parameters/backfill', params);
+        return this.makeSignedRequest('POST', '/parameters/backfill', params, this.parameterApiUrl);
     }
     async parameterClear(params) {
-        return this.makeSignedRequest('POST', '/parameters/clear', params);
+        return this.makeSignedRequest('POST', '/parameters/clear', params, this.parameterApiUrl);
     }
     async parameterList(params) {
-        return this.makeSignedRequest('GET', `/parameters?accountId=${params.accountId}&projectSlug=${params.projectSlug}&specific=${params.specific}&stage=${params.stage}`);
+        return this.makeSignedRequest('GET', `/parameters?accountId=${params.accountId}&projectSlug=${params.projectSlug}&specific=${params.specific}&stage=${params.stage}`, undefined, this.parameterApiUrl);
     }
     async parameterRemove(params) {
-        return this.makeSignedRequest('DELETE', `/parameters/${params.key}?accountId=${params.accountId}&projectSlug=${params.projectSlug}&specific=${params.specific}&stage=${params.stage}`);
+        return this.makeSignedRequest('DELETE', `/parameters/${params.key}?accountId=${params.accountId}&projectSlug=${params.projectSlug}&specific=${params.specific}&stage=${params.stage}`, undefined, this.parameterApiUrl);
     }
     async parameterSync(params) {
-        return this.makeSignedRequest('POST', '/parameters/sync', params);
+        return this.makeSignedRequest('POST', '/parameters/sync', params, this.parameterApiUrl);
     }
     async parameterSyncStatus(params) {
-        return this.makeSignedRequest('GET', `/parameters/sync/${params.taskId}`);
+        return this.makeSignedRequest('GET', `/parameters/sync/${params.taskId}`, undefined, this.parameterApiUrl);
     }
     async parameterUpdate(params) {
         return this.makeSignedRequest('PUT', `/parameters/${params.key}`, {
@@ -345,7 +462,7 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
             projectSlug: params.projectSlug,
             specific: params.specific,
             stage: params.stage
-        });
+        }, this.parameterApiUrl);
     }
     // ============================================================================
     // Stage Methods
@@ -359,6 +476,19 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
     async stageList() {
         return this.makeSignedRequest('GET', '/stages');
     }
+    async stageGetDeployManifest(stageName) {
+        return this.makeSignedRequest('GET', `/stages/${stageName}/deploy-manifest`);
+    }
+    async stageDeploy(params) {
+        return this.makeSignedRequest('POST', `/stages/${params.stageName}/deploy`, {
+            mode: params.mode,
+            moduleSlug: params.moduleSlug
+        });
+    }
+    async stageDelete(stageName, force = false) {
+        const qs = force ? '?force=true' : '';
+        return this.makeSignedRequest('DELETE', `/stages/${stageName}${qs}`);
+    }
     // ============================================================================
     // Stage Access Methods
     // ============================================================================
@@ -391,7 +521,45 @@ export class HyperdriveSigV4Service extends SigV4ApiClient {
         const { data } = errorData;
         const inquirer = (await import('inquirer')).default;
         const open = (await import('open')).default;
+        const accounts = data.outdatedAccounts;
+        // Multi-account flow: show all outdated accounts with individual URLs
+        if (accounts && accounts.length > 1) {
+            console.error(`\n❌ ${accounts.length} AWS accounts have outdated cross-account roles\n`);
+            console.error(`Required version: ${data.requiredVersion}\n`);
+            for (const account of accounts) {
+                const label = account.name ? `${account.name} (${account.accountId})` : account.accountId;
+                console.error(`  • ${label} — current: ${account.currentVersion || 'unknown'}`);
+            }
+            console.error('\nYou must update the CloudFormation stack in each AWS account listed above.');
+            console.error('Log into each account and run the stack update.\n');
+            const { openBrowser } = await inquirer.prompt([{
+                    default: true,
+                    message: `Open CloudFormation console for all ${accounts.length} accounts?`,
+                    name: 'openBrowser',
+                    type: 'confirm'
+                }]);
+            if (openBrowser) {
+                for (const account of accounts) {
+                    const label = account.name ? `${account.name} (${account.accountId})` : account.accountId;
+                    console.log(`\n  Opening update page for ${label}...`);
+                    await open(account.quickCreateUrl);
+                }
+                console.log('\n✓ Browser tabs opened. Update each stack, then retry your command.\n');
+            }
+            else {
+                console.error('\nUpdate URLs (copy and paste, log into each account):');
+                for (const account of accounts) {
+                    const label = account.name ? `${account.name} (${account.accountId})` : account.accountId;
+                    console.error(`\n  ${label}:`);
+                    console.error(`    ${account.quickCreateUrl}`);
+                }
+                console.error('');
+            }
+            process.exit(1);
+        }
+        // Single-account flow (backward compatible)
         console.error('\n❌ Your cross-account IAM role needs an update\n');
+        console.error(`Account: ${data.accountId}`);
         console.error(`Current version: ${data.currentVersion || 'unknown'}`);
         console.error(`Required version: ${data.requiredVersion}\n`);
         console.error('Update steps:');

package/dist/utils/hook-flow.d.ts

@@ -1,4 +1,14 @@
-import type { HookActionType, HookResponse } from '../services/hyperdrive-sigv4.js';
+import inquirer from 'inquirer';
+import type { HookActionCategory, HookActionType, HookResponse, HookTriggerEvent, HyperdriveLifecycleEvent, TenantHookResponse, TrackerHookResponseV2 } from '../services/hyperdrive-sigv4.js';
+export declare const VALID_TRIGGER_EVENTS: HookTriggerEvent[];
+export declare const ALL_ACTION_TYPES: HookActionType[];
+export declare const VALID_LIFECYCLE_EVENTS: HyperdriveLifecycleEvent[];
+export declare const LIFECYCLE_EVENT_GROUPS: (inquirer.Separator | {
+    name: string;
+    value: string;
+})[];
+export declare const LIFECYCLE_CONDITION_FIELDS: Record<string, string[]>;
+export declare function getActionCategory(type: HookActionType): HookActionCategory;
 /**
  * Prompt user to select a trigger status from available Jira statuses
  */
@@ -11,11 +21,58 @@ export declare function promptActionType(): Promise<HookActionType>;
  * Prompt for action-specific configuration based on action type
  */
 export declare function promptActionConfig(actionType: HookActionType): Promise<Record<string, unknown>>;
+/**
+ * Prompt user to select a trigger event type
+ */
+export declare function promptTriggerEvent(): Promise<HookTriggerEvent>;
+/**
+ * Prompt for event-specific trigger conditions
+ */
+export declare function promptTriggerConditions(event: HookTriggerEvent): Promise<Record<string, string>>;
+/**
+ * Prompt user to select an action type with category grouping
+ */
+export declare function promptActionTypeV2(): Promise<{
+    category: HookActionCategory;
+    type: HookActionType;
+}>;
+/**
+ * Prompt for execution order
+ */
+export declare function promptOrder(): Promise<number | undefined>;
 /**
  * Prompt user to select a hook from a list
  */
-export declare function promptSelectHook(hooks: HookResponse[]): Promise<HookResponse>;
+export declare function promptSelectHook(hooks: Array<HookResponse | TenantHookResponse | TrackerHookResponseV2>): Promise<HookResponse | TenantHookResponse | TrackerHookResponseV2>;
 /**
  * Prompt user to confirm hook deletion
  */
-export declare function promptConfirmDelete(hook: HookResponse): Promise<boolean>;
+export declare function promptConfirmDelete(hook: HookResponse | TenantHookResponse | TrackerHookResponseV2): Promise<boolean>;
+/**
+ * Prompt user to choose between lifecycle event trigger and cron trigger
+ */
+export declare function promptTriggerType(): Promise<'cron' | 'lifecycle'>;
+/**
+ * Prompt user for a cron expression or rate expression
+ */
+export declare function promptCronExpression(): Promise<string>;
+/**
+ * Prompt user for an IANA timezone
+ */
+export declare function promptCronTimezone(): Promise<string>;
+/**
+ * Prompt user for the flexible time window (optional)
+ */
+export declare function promptFlexibleWindow(): Promise<number | undefined>;
+/**
+ * Prompt user to select a lifecycle event for tenant hooks
+ */
+export declare function promptLifecycleEvent(): Promise<HyperdriveLifecycleEvent>;
+/**
+ * Prompt for lifecycle event-specific conditions
+ *
+ * Extracts group prefix from the event (e.g., deploy.completed → deploy)
+ * and prompts for each field in LIFECYCLE_CONDITION_FIELDS[group].
+ * Returns only non-empty values.
+ */
+export declare function promptLifecycleConditions(event: string): Promise<Record<string, string>>;