@hyperdrive.bot/cli 1.0.13 → 1.0.17

package/dist/services/hyperdrive-sigv4.d.ts

@@ -41,16 +41,66 @@ interface ModuleResponse {
     buildRuntimeVersion?: string;
     ciService?: string;
     createdAt?: string;
+    defaultBranch?: string;
+    dependsOn?: Array<{
+        artifactKey: string;
+        downloadTo: string;
+    }>;
+    deployCommand?: string;
+    deploymentStrategy?: string;
+    dockerBuild?: Record<string, unknown>;
     framework?: string;
-    moduleType?: 'backend' | 'frontend';
+    gitFullRepoPath?: string;
+    gitOrganization?: string;
+    gitProvider?: string;
+    gitRepoName?: string;
+    hasCI?: boolean;
+    installCommand?: string;
+    moduleType?: 'backend' | 'frontend' | 'cdk';
     name?: string;
+    postDeployCommand?: string;
+    postDeployFailureMode?: 'fail' | 'warn';
     projectId?: string;
     runCommand?: string;
     runtime?: string;
+    runtimeConfig?: {
+        memory?: number;
+        timeout?: number;
+    };
     runtimeVersion?: string;
     slug?: string;
     sourceLocation?: string;
     subdomain?: string;
+    targets?: Record<string, Record<string, unknown>>;
+    tenantId?: string;
+    updatedAt?: string;
+}
+/**
+ * Lambda env update report returned by the backend after a parameter sync.
+ *
+ * The CLI never updates Lambda directly — it asks the backend (API-111 AC5)
+ * to perform GetFunctionConfiguration → merge env → UpdateFunctionConfiguration
+ * on each function bound to the module/stage. The backend returns the per-
+ * function diff so the CLI can surface what changed.
+ *
+ * AC6 contract: `updatedKeys` is the testable list of env vars actually
+ * written for that function. Empty array = idempotent no-op.
+ */
+export interface LambdaEnvUpdateReport {
+    /** Was an actual UpdateFunctionConfiguration call made? false on dry-run / no-op */
+    applied?: boolean;
+    /** Free-form error if the update failed for this function only */
+    error?: string;
+    /** Lambda function name (e.g. `api-alunos-feat-e2e-handler`) */
+    functionName: string;
+    /** Env keys removed by this sync (when sync deletes a previously-set var) */
+    removedKeys?: string[];
+    /** Reason this Lambda was skipped, if applicable (e.g. function not found) */
+    skipped?: string;
+    /** Env keys preserved unchanged (already match desired values) */
+    unchangedKeys?: string[];
+    /** Env keys whose values differed and were written (or would be on dry-run) */
+    updatedKeys: string[];
 }
 interface ParameterSyncResponse {
     errors?: Array<{
@@ -70,6 +120,12 @@ interface ParameterSyncStatusResponse {
         error: string;
         key: string;
     }>;
+    /**
+     * Lambda env update results, present when the request was made with
+     * `applyToLambda: true`. One entry per Lambda the backend tried to update.
+     * Order is not guaranteed.
+     */
+    lambdaUpdates?: LambdaEnvUpdateReport[];
     progress?: {
         percentage: number;
         processed: number;
@@ -93,6 +149,52 @@ interface StageResponse {
     provider?: string;
     regions?: string[];
     slug?: string;
+    /**
+     * Project slugs linked to this stage (as originally requested at
+     * creation). Mirrors `StageData.projectSlugs` on the backend.
+     */
+    projectSlugs?: string[];
+    /**
+     * Runtime project deployment tracking — map of slug → last-deployment info.
+     * Populated after each deploy. Mirrors `Stage.projects` on the backend.
+     */
+    projects?: Record<string, {
+        lastDeployment?: {
+            url?: string;
+            deploymentId?: string;
+            deployedAt?: string;
+        };
+    }>;
+}
+interface DeployManifestModuleResponse {
+    moduleSlug: string;
+    status: 'pending' | 'deployed' | 'failed' | 'timeout' | 'skipped';
+    deploymentId?: string;
+    errorType?: string;
+    startedAt?: string;
+    updatedAt?: string;
+}
+interface DeployManifestWaveResponse {
+    waveIndex: number;
+    modules: DeployManifestModuleResponse[];
+}
+export interface DeployManifestResponse {
+    tenantId: string;
+    stageId: string;
+    missionId: string;
+    status: 'running' | 'partial-failure' | 'success' | 'failed';
+    waves: DeployManifestWaveResponse[];
+    startedAt: string;
+    updatedAt: string;
+}
+export interface DeployManifestApiResponse {
+    manifest: DeployManifestResponse | null;
+    reason?: string;
+}
+export interface StageDeployResponse {
+    missionId: string;
+    logging: LoggingConfig;
+    manifest: DeployManifestResponse;
 }
 interface AWSAccountResponse {
     accountId: string;
@@ -139,7 +241,7 @@ interface GitAuthInitiateResponse {
     state: string;
 }
 export type HookTriggerEvent = 'comment_added' | 'field_changed' | 'issue_assigned' | 'issue_created' | 'label_changed' | 'status_transition';
-export type HookActionType = 'adhb-enrich' | 'ci-trigger' | 'git-create-branch' | 'git-create-mr' | 'git-delete-branch' | 'slack-notify' | 'webhook';
+export type HookActionType = 'adhb-enrich' | 'ci-trigger' | 'deploy' | 'git-create-branch' | 'git-create-mr' | 'git-delete-branch' | 'slack-notify' | 'stage-create' | 'stage-delete' | 'webhook';
 export type HookActionCategory = 'flex' | 'smart';
 export interface SlackNotifyConfig {
     channel: string;
@@ -168,9 +270,30 @@ export interface HookResponse {
     triggerStatus: string;
     updatedAt: string;
 }
+export interface TrackerHookResponseV2 {
+    action: {
+        category: string;
+        config: Record<string, unknown>;
+        type: string;
+    };
+    createdAt: string;
+    enabled: boolean;
+    hookId: string;
+    order?: number;
+    trackerProjectId: string;
+    trigger: {
+        conditions?: Record<string, string>;
+        event: string;
+        source: string;
+    };
+    updatedAt: string;
+}
 export interface HookListResponse {
     hooks: HookResponse[];
 }
+export interface TrackerHookListResponseV2 {
+    hooks: TrackerHookResponseV2[];
+}
 export interface HookLogEntry {
     actionType: string;
     durationMs: number;
@@ -204,6 +327,102 @@ export interface HookCreateRequestV2 {
         source: string;
     };
 }
+export type HyperdriveLifecycleEvent = 'stage.created' | 'stage.provisioned' | 'stage.domain.ready' | 'stage.domain.failed' | 'stage.destroying' | 'stage.destroyed' | 'deploy.created' | 'deploy.ready' | 'deploy.launched' | 'deploy.completed' | 'deploy.failed' | 'launch.created' | 'launch.deployed' | 'launch.failed' | 'launch.terminated' | 'mission.started' | 'mission.wave.completed' | 'mission.completed' | 'mission.failed';
+export interface TenantHookResponse {
+    action: {
+        category: 'flex' | 'smart';
+        config: Record<string, unknown>;
+        type: string;
+    };
+    createdAt: string;
+    enabled: boolean;
+    hookId: string;
+    order?: number;
+    schedulerResource?: {
+        arn: string;
+        groupName: string;
+        scheduleName: string;
+        state: 'DISABLED' | 'ENABLED';
+    };
+    trigger: {
+        conditions?: Record<string, string>;
+        event: string;
+        expression?: string;
+        flexibleWindowMinutes?: number;
+        source: 'hyperdrive';
+        timezone?: string;
+        type?: 'cron';
+    };
+    updatedAt?: string;
+}
+export type TenantHookTrigger = {
+    conditions?: Record<string, string>;
+    event: HyperdriveLifecycleEvent;
+    source: 'hyperdrive';
+} | {
+    expression: string;
+    flexibleWindowMinutes?: number;
+    timezone: string;
+    type: 'cron';
+};
+export interface TenantHookCreateRequest {
+    action: {
+        category: HookActionCategory;
+        config: Record<string, unknown>;
+        type: HookActionType;
+    };
+    order?: number;
+    trigger: TenantHookTrigger;
+}
+export type NormalizedWorkflowState = 'blocked' | 'deploying' | 'done' | 'enriching' | 'implementing' | 'in_review' | 'pending' | 'ready_to_merge' | 'testing' | 'validating';
+export interface TrackerProject {
+    createdAt: string;
+    externalProjectKey: string;
+    externalProjectName: string;
+    provider: string;
+    statusMapping: Record<string, NormalizedWorkflowState>;
+    trackerId: string;
+    trackerProjectId: string;
+    updatedAt: string;
+}
+export interface TrackerProjectCreateRequest {
+    externalProjectKey: string;
+    externalProjectName: string;
+    provider: string;
+    statusMapping: Record<string, NormalizedWorkflowState>;
+    trackerId: string;
+}
+export interface TrackerProjectModuleLink {
+    linkedAt: string;
+    moduleId: string;
+    role?: 'primary' | 'supporting';
+    trackerProjectId: string;
+}
+export interface TrackerProjectModuleLinkRequest {
+    moduleId: string;
+    role?: 'primary' | 'supporting';
+}
+export interface ModuleContextInProject {
+    architectureSummary: Record<string, unknown> | null;
+    entityRegistry: Array<{
+        name: string;
+        path: string;
+        type: string;
+    }>;
+    lastSyncedAt: string | null;
+    metadata: {
+        name: string;
+        slug: string;
+    };
+    moduleId: string;
+    moduleList: string[];
+    summaryStatus: 'fresh' | 'not_generated' | 'stale';
+}
+export interface TrackerProjectContextResponse {
+    hooksSummary: Record<string, string[]>;
+    linkedModules: ModuleContextInProject[];
+    trackerProject: TrackerProject;
+}
 export type BackupStatus = 'completed' | 'failed' | 'in-progress' | 'pending';
 export type BackupType = 'clone' | 'restore' | 'snapshot';
 export type SeedRunStatus = 'completed' | 'failed' | 'in-progress' | 'pending';
@@ -243,12 +462,10 @@ export interface SeedRunListResponse {
     lastEvaluatedKey?: Record<string, unknown>;
     seedRuns: SeedRunResponse[];
 }
-/**
- * Hyperdrive API Service with AWS SigV4 authentication
- */
 export declare class HyperdriveSigV4Service extends SigV4ApiClient {
     private readonly projectsApiUrl?;
     private readonly userGroupsApiUrl?;
+    private readonly parameterApiUrl;
     constructor(domain?: string);
     accountAdd(params: {
         accountId: string;
@@ -577,6 +794,31 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
         projectSlug: string;
         stage: string;
     }): Promise<DeploymentResponse[]>;
+    deploymentCreateStatic(params: {
+        commit: string;
+        deploymentName: string;
+        files: Array<{
+            contentType: string;
+            path: string;
+            size: number;
+        }>;
+        projectSlug: string;
+        stage: string;
+    }): Promise<{
+        bucketName: string;
+        deploymentId: string;
+        uploadUrls: Array<{
+            path: string;
+            url: string;
+        }>;
+    }>;
+    deploymentFinalizeStatic(deploymentId: string, options?: {
+        spa?: boolean;
+    }): Promise<{
+        deploymentId: string;
+        launchId: string;
+        url: string;
+    }>;
     gitAuthInitiate(provider: 'github' | 'gitlab'): Promise<GitAuthInitiateResponse>;
     gitCheckRepoAccess(params: {
         provider: 'github' | 'gitlab';
@@ -611,6 +853,23 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
     hookUpdate(projectId: string, hookId: string, body: Partial<HookCreateRequest> & {
         enabled?: boolean;
     }): Promise<HookResponse>;
+    tenantHookCreate(body: TenantHookCreateRequest): Promise<TenantHookResponse>;
+    tenantHookDelete(hookId: string): Promise<{
+        message: string;
+    }>;
+    tenantHookGet(hookId: string): Promise<TenantHookResponse>;
+    tenantHookList(): Promise<TenantHookResponse[]>;
+    tenantHookLogList(options?: {
+        limit?: number;
+        status?: string;
+    }): Promise<HookLogListResponse>;
+    tenantHookUpdate(hookId: string, body: {
+        action?: {
+            config: Record<string, unknown>;
+        };
+        enabled?: boolean;
+        order?: number;
+    }): Promise<TenantHookResponse>;
     projectGetJiraStatuses(projectId: string): Promise<{
         statuses: Array<{
             id: string;
@@ -618,6 +877,14 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
             category?: string;
         }>;
     }>;
+    jiraListProjects(): Promise<{
+        projects: Array<{
+            id?: string;
+            key?: string;
+            name?: string;
+            projectTypeKey?: string;
+        }>;
+    }>;
     jiraGetProjectStatuses(jiraProjectKey: string): Promise<{
         statuses: Array<{
             id: string;
@@ -640,6 +907,30 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
         };
         success: boolean;
     }>;
+    jiraStatus(): Promise<Record<string, unknown>>;
+    trackerProjectCreate(data: TrackerProjectCreateRequest): Promise<TrackerProject>;
+    trackerProjectDelete(trackerProjectId: string): Promise<{
+        message: string;
+    }>;
+    trackerProjectHookCreate(trackerProjectId: string, body: HookCreateRequest): Promise<HookResponse>;
+    trackerProjectHookCreateV2(trackerProjectId: string, body: HookCreateRequestV2): Promise<TrackerHookResponseV2>;
+    trackerProjectHookDelete(trackerProjectId: string, hookId: string): Promise<{
+        message: string;
+    }>;
+    trackerProjectHookList(trackerProjectId: string): Promise<TrackerHookListResponseV2>;
+    trackerProjectHookLogList(trackerProjectId: string, options?: {
+        limit?: number;
+        status?: string;
+    }): Promise<HookLogListResponse>;
+    trackerProjectHookUpdate(trackerProjectId: string, hookId: string, body: Partial<HookCreateRequest> & {
+        enabled?: boolean;
+    }): Promise<TrackerHookResponseV2>;
+    trackerProjectLinkModule(trackerProjectId: string, data: TrackerProjectModuleLinkRequest): Promise<TrackerProjectModuleLink>;
+    trackerProjectList(): Promise<TrackerProject[]>;
+    trackerProjectListModules(trackerProjectId: string): Promise<TrackerProjectModuleLink[]>;
+    trackerProjectUnlinkModule(trackerProjectId: string, moduleId: string): Promise<void>;
+    trackerProjectGet(trackerProjectId: string): Promise<TrackerProject>;
+    trackerProjectGetContext(trackerProjectId: string): Promise<TrackerProjectContextResponse>;
     projectAddRepo(projectId: string, repo: {
         defaultBranch: string;
         gitProvider: string;
@@ -763,6 +1054,10 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
         parameters: Record<string, boolean>;
         targetSlug: string;
     }): Promise<ModuleResponse>;
+    moduleUnlink(params: {
+        originSlug: string;
+        targetSlug: string;
+    }): Promise<ModuleResponse>;
     moduleList(): Promise<ModuleResponse[]>;
     moduleReanalyze(slug: string, userPrompt: string): Promise<{
         jobId: string;
@@ -771,18 +1066,43 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
         projectId: string;
         status: string;
     }>;
+    moduleUpdateContext(moduleSlug: string, data: {
+        architectureSummary: string;
+        entityRegistry: Array<{
+            description?: string;
+            name: string;
+            path: string;
+            repository?: string;
+            type: string;
+        }>;
+        lastSyncedAt: string;
+    }): Promise<Record<string, unknown>>;
     moduleUpdate(params: {
         buildCommand?: string;
         buildFolder?: string;
         buildRuntime?: string;
         buildRuntimeVersion?: string;
         ciService?: string;
+        dependsOn?: Array<{
+            artifactKey: string;
+            downloadTo: string;
+        }>;
+        deployCommand?: string;
+        deploymentStrategy?: string;
+        dockerBuild?: Record<string, unknown>;
         framework?: string;
         installCommand?: string;
         moduleType?: 'backend' | 'frontend' | 'cdk';
         name?: string;
+        postDeployCommand?: string;
+        postDeployFailureMode?: 'fail' | 'warn';
         runCommand?: string;
         runtime?: string;
+        runtimeConfig?: {
+            memory?: number;
+            timeout?: number;
+        };
+        runtimeMode?: string;
         runtimeVersion?: string;
         slug: string;
         sourceLocation?: string;
@@ -841,6 +1161,19 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
     }>;
     parameterSync(params: {
         accountId: string;
+        /**
+         * When true, after writing to DDB the backend also updates each Lambda
+         * function bound to the module/stage with the new env vars. Existing env
+         * vars not present in the sync are preserved (read current → merge →
+         * UpdateFunctionConfiguration). See API-111 AC5.
+         */
+        applyToLambda?: boolean;
+        /**
+         * When true, the backend computes the DDB and Lambda diff but does not
+         * write either. Status response surfaces `lambdaUpdates` with
+         * `applied: false` so the CLI can preview the change set.
+         */
+        dryRun?: boolean;
         encodedContent: string;
         projectSlug?: string;
         specific: boolean;
@@ -873,6 +1206,27 @@ export declare class HyperdriveSigV4Service extends SigV4ApiClient {
         name: string;
     }): Promise<StageResponse>;
     stageList(): Promise<StageResponse[]>;
+    stageGetDeployManifest(stageName: string): Promise<DeployManifestApiResponse>;
+    stageDeploy(params: {
+        stageName: string;
+        mode: 'retry' | 'module';
+        moduleSlug?: string;
+    }): Promise<StageDeployResponse>;
+    stageDelete(stageName: string, force?: boolean): Promise<{
+        stage: StageResponse;
+        cleanup: 'queued';
+    } | {
+        stage: StageResponse;
+        stacks: {
+            stacksDeleted: string[];
+            errors: string[];
+        };
+        logGroups?: {
+            deleted: number;
+            errors: string[];
+        };
+        domainTeardown?: string;
+    }>;
     stageAccessGet(stageName: string): Promise<{
         access: Array<{
             role: string;