@pipeline-builder/pipeline-manager 0.0.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,145 @@
+# @pipeline-builder/pipeline-manager
+
+📖 **[View documentation](https://mwashburn160.github.io/pipeline-builder/)**
+
+CLI for [Pipeline Builder](https://mwashburn160.github.io/pipeline-builder/): install the platform itself with `provision`, then bootstrap, synth, deploy, and manage CDK pipelines + plugins against it.
+
+## Install
+
+```bash
+npm install -g @pipeline-builder/pipeline-manager
+```
+
+Requires Node.js 24.14.0+.
+
+## Quick start
+
+```bash
+# Authenticate against your Pipeline Builder platform
+pipeline-manager auth login --url https://platform.example.com
+
+# Bootstrap a new project in the current directory
+pipeline-manager infra bootstrap
+
+# Synthesize the CDK app into a CloudFormation template
+pipeline-manager pipeline synth
+
+# Deploy the pipeline to AWS
+pipeline-manager pipeline deploy
+```
+
+## Install the platform (`provision`)
+
+`provision` is the recommended way to stand up the **platform itself** (not a pipeline) — on Docker Compose, Minikube, EC2, or EKS (Auto Mode). It runs prerequisite checks, assembles the exact `bin/setup.sh` command (secrets masked, missing inputs reported — never guessed), shows the plan, and **deploys it end-to-end, gated by confirmation prompts** (`--yes` for CI; `--json` prints the plan and runs nothing).
+
+```bash
+# Deploy local — shows the plan, then confirms (confirm → deploy → /health + /ready → init-platform):
+pipeline-manager infra provision --target docker
+
+# Inspect the plan as JSON, run nothing:
+pipeline-manager infra provision --target docker --json
+
+# Deploy to EKS Auto Mode (add --yes for non-interactive CI):
+pipeline-manager infra provision --target eks \
+  --domain pipeline.example.com --hosted-zone-id Z123 --ghcr-token ghp_xxx --email
+
+# Tear it down (AWS targets prompt you to TYPE the cluster/target id to confirm):
+pipeline-manager infra provision --target eks --teardown
+
+# Bootstrap a fresh machine — sparse-clones ONLY the deploy folders this target
+# + options need (here: deploy/bin + deploy/local/docker), then deploys + registers:
+pipeline-manager infra provision --target docker --repo --yes \
+  --admin-email admin@acme.com --admin-password 's3cret'
+
+# Add post-install loads (each also adds its folder to the sparse clone):
+pipeline-manager infra provision --target docker --repo --with-all --with-smoke-test
+```
+
+- **Deploy (gated) or teardown.** `provision` shows the plan, then deploys — refusing on failed prerequisites or missing inputs, confirming before it runs (`--yes` auto-accepts for CI), then verifying health and running `init-platform`. **`--json`** prints the plan and runs nothing (the only non-executing mode). `--teardown` removes a deployment (`local`/`minikube` stop the stack; **EC2 deletes its CloudFormation stack and EKS runs `bin/shutdown.sh` (cluster + EFS + ACM + Route 53), both irreversibly** and require typing the stack/cluster id to confirm — `--force` skips it for CI).
+- **Prerequisites, handled.** The checks mirror each target's `setup.sh` exactly — local: Docker, Docker Compose, `yq`, `openssl`; minikube: Docker, minikube, kubectl, `openssl` (+ `yq` with `--with-plugins`); ec2: AWS CLI + working credentials; eks: AWS CLI + credentials, `kubectl`, `openssl`, `envsubst` (+ `yq` with `--with-plugins`); `eksctl` is auto-installed by `setup.sh` (latest binary) when not already on PATH. Missing **single-binary** tools (`yq`, `kubectl`, `minikube`) are offered as an on-demand **fetch** into `~/.pipeline-manager/tools` and put on PATH — no `brew`/`apt`, no system change. For local/minikube it also **creates the target's `.env`** from `.env.example`, generating the `CHANGE_ME` secrets. Tools that aren't relocatable binaries (git, Docker/Compose, AWS CLI, openssl) fall back to the normal install instruction, and if you run from outside a checkout it **offers to sparse-clone** the deploy folders for you.
+- **Self-healing.** On a failed deploy it matches known CloudFormation issues (cause + fix) and can auto-fix + retry a few — e.g. an existing SES identity → re-run with `--skip-ses-identity`. Gated and bounded by `--retries` (the scripts are idempotent, so a re-run resumes).
+- **AI-optional.** Set `ANTHROPIC_API_KEY` (or `AI_PROVIDER` + its key) to parse a natural-language `--prompt` and add free-form failure diagnosis; without a key it falls back to the deterministic issue matcher.
+- **Bootstrap a fresh machine (`--repo`).** Without a checkout, `--repo` git-clones the platform repo first, then runs from it. The clone is **sparse + partial** (`--filter=blob:none` + cone `sparse-checkout`, git ≥ 2.27 — else a full-clone fallback): it materializes only the deploy folders the selected target + options need. The common base is just `deploy/bin`; each target adds its own folder (e.g. `deploy/local/docker`; minikube is self-contained), and each post-install load adds its folder. Re-syncs are **additive** — a single `--workdir` can accumulate multiple targets. Override with `--repo <url>`, `--ref <branch|tag>`, `--workdir <dir>`.
+- **Run in Docker, zero host installs.** Don't want `git`/`yq`/AWS CLI on your machine? [`deploy/bin/provision-docker.sh`](../../deploy/bin/provision-docker.sh) runs `provision` inside a throwaway `node:24-slim` container, installing only the tools the chosen target needs: **ec2** → git + AWS CLI (mounts `~/.aws` read-only); **eks** → + openssl + envsubst + eksctl + kubectl (mounts `~/.aws` + `~/.kube`); **local** → git + yq + openssl, with **Docker + Docker Compose used *externally*** from the host via the mounted socket (Docker Desktop already provides them — they're never installed in the image). Host footprint = just Docker. Args pass straight through: `deploy/bin/provision-docker.sh --target eks --repo --domain … --yes`. (On macOS the container can't drive Docker Desktop's CLI, so run **local** on the host instead — the wrapper shines for the AWS targets.)
+- **Post-install steps.** After deploy + health, `provision` registers the admin (non-interactive with `--admin-email`/`--admin-password`) and runs the opt-in loads — passed as flags, or **offered interactively after the clone** when none are given (each picked load is then fetched via an additive sparse re-sync): `--with-plugins` (adds `deploy/plugins` + `deploy/codebuild`), `--with-compliance` (`deploy/compliance`), `--with-samples` (`deploy/samples`), or `--with-all`. Plus `--with-smoke-test` (read-only API check), **`--with-events`** (AWS event ingestion — a two-step bundle: **`store-token`** writes a platform JWT to Secrets Manager at pipeline-builder's own pattern `pipeline-builder/{orgId}/platform`, then **`setup-events`** deploys the EventBridge → SQS → Lambda that reads it), and repeatable `--post-step "<cmd>"`. Default is register-only; `--init skip` skips even that. All steps are idempotent, so re-running with more options just layers them on.
+
+The underlying `bin/setup.sh` / `bin/shutdown.sh` scripts (and `aws cloudformation delete-stack` for ec2) remain the source of truth and can always be run directly. Full guide: [AWS deployment → AI-assisted install](https://mwashburn160.github.io/pipeline-builder/docs/aws-deployment#ai-assisted-install-provision).
+
+## Commands
+
+### Platform installation
+
+| Command | Purpose |
+| --- | --- |
+| `provision` | Install (or tear down) the **platform** on local/Minikube/EC2/EKS: prereq checks + assembles the exact `bin/setup.sh` command, then **deploys it** (gated by confirmation; `--yes` for CI, `--json` to print the plan and run nothing), verifying health + running post-install steps. `--repo` bootstraps a fresh machine via a **sparse** clone of only the needed deploy folders; `--with-plugins`/`--with-compliance`/`--with-samples`/`--with-all`/`--with-smoke-test`/`--with-events`/`--post-step` add post-install steps; `--teardown` removes it. On failure it diagnoses + auto-fixes/retries known issues. See [Install the platform](#install-the-platform-provision). |
+
+### Project lifecycle
+
+| Command | Purpose |
+| --- | --- |
+| `bootstrap` | Scaffold a new pipeline project with `cdk.json` and starter config |
+| `synth` | Run CDK synth to emit the CloudFormation template for the pipeline |
+| `deploy` | Deploy the synthesized pipeline stack to AWS (also registers the pipeline with the platform by its `pipelineId`) |
+| `register` | Re-register a deployed pipeline with the platform and drain pending intents queued by prior failed deploys (recovery path; exits non-zero if any registration still fails) |
+| `status` | Report the current deployment and execution status |
+
+### Resource management
+
+| Command | Purpose |
+| --- | --- |
+| `create-pipeline` | Register a new pipeline definition with the platform |
+| `list-pipelines` / `get-pipeline` | Inspect pipelines registered to your organization |
+| `list-plugins` / `get-plugin` | Browse the plugin catalog and fetch a single plugin spec |
+| `upload-plugin` | Publish a custom plugin spec + Dockerfile to the platform |
+| `validate-templates` | Parse and validate `{{ ... }}` templates in a pipeline or plugin spec (local file, registered pipeline by ID, or registered plugin by `name:version`) |
+| `org-export` | Export an organization's data as JSON for GDPR portability (sysadmins can export any org; org admins their own only) |
+
+### Auth & infrastructure
+
+| Command | Purpose |
+| --- | --- |
+| `login` | Authenticate against the platform and persist the access token (supports `--refresh <token>` and `--org <orgId>` to switch organizations) |
+| `store-token` | Generate a long-lived JWT and store it in AWS Secrets Manager (used by the events Lambda and CodePipeline synth steps). Add `--schedule` to also deploy a daily auto-renewal stack so the token never lapses |
+| `setup-events` | Deploy the EventBridge → SQS → Lambda stack that streams CodePipeline events into the platform's reporting service |
+
+### Operator audits (cron-friendly)
+
+These commands report drift and exit non-zero when findings exist. Designed to run on a schedule.
+
+| Command | Purpose | Exit codes |
+| --- | --- | --- |
+| `audit-stacks` | Diff CloudFormation stacks tagged `pipeline-builder` against the platform's `pipeline_registry`. Surfaces orphaned stacks (no DB row) and missing stacks (DB row but no live stack). See [docs/aws-deployment.md](https://mwashburn160.github.io/pipeline-builder/docs/aws-deployment.html#drift-detection-audit-stacks). | `0` clean / `1` findings / `2` AWS error |
+| `audit-tokens` | Scan platform tokens stored in AWS Secrets Manager and flag any expiring within `--warn-days` (default 7). Run before tokens lapse to avoid silent reporting outages. | `0` clean / `1` at-risk / `2` AWS error |
+
+### Misc
+
+| Command | Purpose |
+| --- | --- |
+| `completions` | Print a shell completion script for `bash`, `zsh`, or `fish`. Source it from your shell profile, e.g. `eval "$(pipeline-manager completions bash)"` in `~/.bashrc` (completions are derived from the live command list, so they never drift) |
+| `version` | Print CLI version info |
+
+Run `pipeline-manager <command> --help` for the full flag reference on any command.
+
+## Environment variables
+
+| Variable | Required | Purpose |
+| --- | --- | --- |
+| `PLATFORM_TOKEN` | Yes (for API ops) | Auth token for the Pipeline Builder platform |
+| `PLATFORM_BASE_URL` | Yes (for API ops) | Base URL of your platform deployment |
+| `AWS_REGION` | Yes (for deploy) | Target AWS region for `synth` / `deploy` / `provision` teardown |
+| `ANTHROPIC_API_KEY` (or other provider key) | No | Enables `provision`'s natural-language `--prompt` parsing + failure diagnosis (else it falls back to the deterministic issue matcher) |
+| `AI_PROVIDER` / `AI_MODEL` | No | Provider + model for `provision` (`anthropic` \| `openai` \| `google` \| `xai` \| `bedrock`) |
+
+Full reference: [Environment Variables](https://mwashburn160.github.io/pipeline-builder/docs/environment-variables).
+
+## Documentation
+
+- [Getting started](https://mwashburn160.github.io/pipeline-builder/)
+- [CDK usage](https://mwashburn160.github.io/pipeline-builder/docs/cdk-usage)
+- [Plugin catalog (119 plugins)](https://mwashburn160.github.io/pipeline-builder/docs/plugins/)
+- [API reference](https://mwashburn160.github.io/pipeline-builder/docs/api-reference)
+- [AWS deployment](https://mwashburn160.github.io/pipeline-builder/docs/aws-deployment)
+
+## License
+
+Apache-2.0. See [LICENSE](./LICENSE).

package/cdk.json

@@ -0,0 +1,91 @@
+{
+  "app": "node boilerplate.js",
+  "watch": {
+    "include": [
+      "**"
+    ],
+    "exclude": [
+      "README.md",
+      "cdk*.json",
+      "jest.config.js",
+      "package*.json",
+      "yarn.lock",
+      "node_modules",
+      "test"
+    ]
+  },
+  "context": {
+    "notices": false,
+    "cli-telemetry": false,
+    "@aws-cdk/aws-lambda:recognizeLayerVersion": true,
+    "@aws-cdk/core:checkSecretUsage": true,
+    "@aws-cdk/core:target-partitions": [
+      "aws",
+      "aws-cn"
+    ],
+    "@aws-cdk-containers/ecs-service-extensions:enableDefaultLogDriver": true,
+    "@aws-cdk/aws-ec2:uniqueImdsv2TemplateName": true,
+    "@aws-cdk/aws-ecs:arnFormatIncludesClusterName": true,
+    "@aws-cdk/aws-iam:minimizePolicies": true,
+    "@aws-cdk/core:validateSnapshotRemovalPolicy": true,
+    "@aws-cdk/aws-codepipeline:crossAccountKeyAliasStackSafeResourceName": true,
+    "@aws-cdk/aws-s3:createDefaultLoggingPolicy": true,
+    "@aws-cdk/aws-sns-subscriptions:restrictSqsDescryption": true,
+    "@aws-cdk/aws-apigateway:disableCloudWatchRole": true,
+    "@aws-cdk/core:enablePartitionLiterals": true,
+    "@aws-cdk/aws-events:eventsTargetQueueSameAccount": true,
+    "@aws-cdk/aws-ecs:disableExplicitDeploymentControllerForCircuitBreaker": true,
+    "@aws-cdk/aws-iam:importedRoleStackSafeDefaultPolicyName": true,
+    "@aws-cdk/aws-s3:serverAccessLogsUseBucketPolicy": true,
+    "@aws-cdk/aws-route53-patters:useCertificate": true,
+    "@aws-cdk/customresources:installLatestAwsSdkDefault": false,
+    "@aws-cdk/aws-rds:databaseProxyUniqueResourceName": true,
+    "@aws-cdk/aws-codedeploy:removeAlarmsFromDeploymentGroup": true,
+    "@aws-cdk/aws-apigateway:authorizerChangeDeploymentLogicalId": true,
+    "@aws-cdk/aws-ec2:launchTemplateDefaultUserData": true,
+    "@aws-cdk/aws-secretsmanager:useAttachedSecretResourcePolicyForSecretTargetAttachments": true,
+    "@aws-cdk/aws-redshift:columnId": true,
+    "@aws-cdk/aws-stepfunctions-tasks:enableEmrServicePolicyV2": true,
+    "@aws-cdk/aws-ec2:restrictDefaultSecurityGroup": true,
+    "@aws-cdk/aws-apigateway:requestValidatorUniqueId": true,
+    "@aws-cdk/aws-kms:aliasNameRef": true,
+    "@aws-cdk/aws-autoscaling:generateLaunchTemplateInsteadOfLaunchConfig": true,
+    "@aws-cdk/core:includePrefixInUniqueNameGeneration": true,
+    "@aws-cdk/aws-efs:denyAnonymousAccess": true,
+    "@aws-cdk/aws-opensearchservice:enableOpensearchMultiAzWithStandby": true,
+    "@aws-cdk/aws-lambda-nodejs:useLatestRuntimeVersion": true,
+    "@aws-cdk/aws-efs:mountTargetOrderInsensitiveLogicalId": true,
+    "@aws-cdk/aws-rds:auroraClusterChangeScopeOfInstanceParameterGroupWithEachParameters": true,
+    "@aws-cdk/aws-appsync:useArnForSourceApiAssociationIdentifier": true,
+    "@aws-cdk/aws-rds:preventRenderingDeprecatedCredentials": true,
+    "@aws-cdk/aws-codepipeline-actions:useNewDefaultBranchForCodeCommitSource": true,
+    "@aws-cdk/aws-cloudwatch-actions:changeLambdaPermissionLogicalIdForLambdaAction": true,
+    "@aws-cdk/aws-codepipeline:crossAccountKeysDefaultValueToFalse": true,
+    "@aws-cdk/aws-codepipeline:defaultPipelineTypeToV2": true,
+    "@aws-cdk/aws-kms:reduceCrossAccountRegionPolicyScope": true,
+    "@aws-cdk/aws-eks:nodegroupNameAttribute": true,
+    "@aws-cdk/aws-ec2:ebsDefaultGp3Volume": true,
+    "@aws-cdk/aws-ecs:removeDefaultDeploymentAlarm": true,
+    "@aws-cdk/custom-resources:logApiResponseDataPropertyTrueDefault": false,
+    "@aws-cdk/aws-s3:keepNotificationInImportedBucket": false,
+    "@aws-cdk/aws-ecs:enableImdsBlockingDeprecatedFeature": false,
+    "@aws-cdk/aws-ecs:disableEcsImdsBlocking": true,
+    "@aws-cdk/aws-ecs:reduceEc2FargateCloudWatchPermissions": true,
+    "@aws-cdk/aws-dynamodb:resourcePolicyPerReplica": true,
+    "@aws-cdk/aws-ec2:ec2SumTImeoutEnabled": true,
+    "@aws-cdk/aws-appsync:appSyncGraphQLAPIScopeLambdaPermission": true,
+    "@aws-cdk/aws-rds:setCorrectValueForDatabaseInstanceReadReplicaInstanceResourceId": true,
+    "@aws-cdk/core:cfnIncludeRejectComplexResourceUpdateCreatePolicyIntrinsics": true,
+    "@aws-cdk/aws-lambda-nodejs:sdkV3ExcludeSmithyPackages": true,
+    "@aws-cdk/aws-stepfunctions-tasks:fixRunEcsTaskPolicy": true,
+    "@aws-cdk/aws-ec2:bastionHostUseAmazonLinux2023ByDefault": true,
+    "@aws-cdk/aws-route53-targets:userPoolDomainNameMethodWithoutCustomResource": true,
+    "@aws-cdk/aws-elasticloadbalancingV2:albDualstackWithoutPublicIpv4SecurityGroupRulesDefault": true,
+    "@aws-cdk/aws-iam:oidcRejectUnauthorizedConnections": true,
+    "@aws-cdk/core:enableAdditionalMetadataCollection": false,
+    "@aws-cdk/aws-lambda:createNewPoliciesWithAddToRolePolicy": false,
+    "@aws-cdk/aws-s3:setUniqueReplicationRoleName": true,
+    "@aws-cdk/aws-events:requireEventBusPolicySid": true,
+    "@aws-cdk/aws-dynamodb:retainTableReplica": true
+  }
+}

package/config.yml

@@ -0,0 +1,94 @@
+# CLI Configuration File
+# Save this as config.yml in your project root or specify with CLI_CONFIG_PATH
+
+# ============================================================================
+# API Configuration
+# ============================================================================
+api:
+  # Base URL for the API
+  # Can be overridden with PLATFORM_URL environment variable
+  baseUrl: https://localhost:8443
+  
+  # Request timeout in milliseconds
+  timeout: 30000
+  
+  # SSL/TLS Certificate Validation
+  # Set to false to disable certificate validation (DEVELOPMENT ONLY)
+  # Default: true (secure)
+  # 
+  # WARNING: Setting this to false disables certificate validation and makes
+  # your application vulnerable to man-in-the-middle attacks. Only use this
+  # in development environments with self-signed certificates.
+  rejectUnauthorized: true
+  
+  # API Endpoints
+  # 
+  # Pipeline Endpoints:
+  #   pipelineUrl     - Single pipeline operations (GET by ID, POST)
+  #                     Used by: get-pipeline, create-pipeline
+  #                     Format: /api/pipeline/{id} or /api/pipeline
+  # 
+  #   pipelineListUrl - List/query multiple pipelines with filters
+  #                     Used by: list-pipelines
+  #                     Format: /api/pipelines?filter1=value1&filter2=value2
+  #                     Supports filters: id, accessModifier, isDefault, isActive, 
+  #                                      project, projectPattern, organizationPattern,
+  #                                      limit, offset, sort
+  # 
+  # Plugin Endpoints:
+  #   pluginUrl       - Single plugin operations (GET by ID)
+  #                     Used by: get-plugin
+  #                     Format: /api/plugin/{id}
+  # 
+  #   pluginListUrl   - List/query multiple plugins with filters
+  #                     Used by: list-plugins
+  #                     Format: /api/plugins?filter1=value1&filter2=value2
+  #                     Supports filters: id, accessModifier, isDefault, isActive, 
+  #                                      name, namePattern, version, versionRange, 
+  #                                      imageTag, limit, offset, sort
+  # 
+  #   pluginUploadUrl - Plugin upload endpoint
+  #                     Used by: upload-plugin
+  #                     Format: /api/plugin/upload
+  # 
+  # Note: Singular vs Plural URLs
+  #   - Singular (/api/plugin, /api/pipeline) - Single resource operations
+  #   - Plural (/api/plugins, /api/pipelines) - List/query operations
+  pipelineUrl: /api/pipeline
+  pipelineListUrl: /api/pipelines
+  pluginUrl: /api/plugin
+  pluginListUrl: /api/plugins
+  pluginUploadUrl: /api/plugin/upload
+
+# ============================================================================
+# AUTHENTICATION
+# ============================================================================
+# Authentication is handled via environment variable ONLY.
+# DO NOT include auth configuration in this file.
+#
+# Set your token with:
+#   export PLATFORM_TOKEN='your-token-here'
+#
+# The token should NEVER be committed to version control.
+# ============================================================================
+
+# ============================================================================
+# ENVIRONMENT VARIABLES
+# ============================================================================
+# The following environment variables are used by the CLI:
+#
+# REQUIRED:
+#   PLATFORM_TOKEN              - Authentication token for API access
+#                                 Example: export PLATFORM_TOKEN='eyJhbG...'
+#
+# OPTIONAL:
+#   PLATFORM_URL                - Override api.baseUrl
+#                                 Example: export PLATFORM_URL='https://api.example.com'
+#
+#   CLI_CONFIG_PATH             - Path to this config file
+#                                 Example: export CLI_CONFIG_PATH='/path/to/config.yml'
+#
+#   TLS_REJECT_UNAUTHORIZED - Set to '0' to disable cert validation
+#                                  Example: export TLS_REJECT_UNAUTHORIZED='0'
+#
+# ============================================================================

package/dist/agent/ai.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+export interface AiOptions {
+    readonly provider?: string;
+    readonly model?: string;
+}
+/**
+ * True when the selected provider can be used: a key-based provider needs its API
+ * key, a keyless provider (Bedrock) needs either static AWS creds or an AWS region
+ * (the IAM-role signal). Kept in lockstep with ai-core's registry gating.
+ */
+export declare function isAiConfigured(opts?: AiOptions): boolean;
+/**
+ * Diagnose a CloudFormation / deploy failure. Returns a short plain-English
+ * cause + suggested next action, or null when AI is unavailable.
+ *
+ * The input is UNTRUSTED tool/log output — it is passed as data, never as
+ * instructions, and the result is advisory only (it never triggers an action).
+ */
+export declare function diagnoseFailure(failureText: string, opts?: AiOptions): Promise<string | null>;
+/**
+ * Recognized keys a goal can fill — mirrors the deterministic InputSpec keys.
+ * All optional: the model fills only what it can determine, and the deterministic
+ * layer validates + reports anything missing (so a sloppy parse can't cause a
+ * wrong deploy — it just yields a partial fill).
+ */
+declare const GoalSchema: z.ZodObject<{
+    target: z.ZodOptional<z.ZodEnum<{
+        docker: "docker";
+        ec2: "ec2";
+        eks: "eks";
+        minikube: "minikube";
+    }>>;
+    region: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    hostedZoneId: z.ZodOptional<z.ZodString>;
+    deployMode: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>>;
+    email: z.ZodOptional<z.ZodBoolean>;
+    emailFrom: z.ZodOptional<z.ZodString>;
+    alertEmail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ParsedGoal = z.infer<typeof GoalSchema>;
+/** Parse a natural-language goal into known params via structured output. */
+export declare function parseGoal(prompt: string, opts?: AiOptions): Promise<ParsedGoal | null>;
+export {};
+//# sourceMappingURL=ai.d.ts.map

package/dist/agent/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/agent/ai.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAmCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,SAAc,GAAG,OAAO,CAM5D;AA0BD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBvG;AAED;;;;;GAKG;AACH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;iBASd,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,6EAA6E;AAC7E,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAkBhG"}