@build-astron-co/nimbus 0.2.0

package/src/demo/scenarios/helm-release.ts

@@ -0,0 +1,341 @@
+/**
+ * Helm Release Demo Scenario
+ *
+ * Demonstrates creating and deploying a Helm chart
+ */
+
+import type { DemoScenario } from '../types';
+
+export const helmReleaseScenario: DemoScenario = {
+  id: 'helm-release',
+  name: 'Create and Deploy Helm Chart',
+  description: 'Learn how to create and deploy Helm charts with Nimbus',
+  category: 'helm',
+  duration: 15,
+  prerequisites: [
+    'Helm 3.x installed',
+    'kubectl configured with cluster access',
+    'Nimbus CLI installed',
+  ],
+  tags: ['helm', 'charts', 'deployment', 'kubernetes'],
+  steps: [
+    {
+      id: 'check-helm',
+      title: 'Verify Helm Installation',
+      description: 'Check that Helm is installed and configured',
+      command: 'nimbus helm version',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Helm Version: v3.14.0
+Kubernetes Version: v1.28.0
+      `.trim(),
+    },
+    {
+      id: 'generate-chart',
+      title: 'Generate Helm Chart',
+      description: 'Create a new Helm chart for a web application',
+      command: 'nimbus generate helm --name my-webapp --type web --output ./charts',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Generating Helm chart...
+
+Created chart: my-webapp
+
+charts/my-webapp/
+├── Chart.yaml           # Chart metadata
+├── values.yaml          # Default values
+├── templates/
+│   ├── _helpers.tpl     # Template helpers
+│   ├── deployment.yaml  # Deployment template
+│   ├── service.yaml     # Service template
+│   ├── ingress.yaml     # Ingress template
+│   ├── configmap.yaml   # ConfigMap template
+│   ├── hpa.yaml         # HPA template
+│   └── NOTES.txt        # Post-install notes
+└── .helmignore          # Files to ignore
+
+Chart type: Web Application
+Features:
+  ✓ Deployment with health checks
+  ✓ Service (ClusterIP/LoadBalancer)
+  ✓ Ingress with TLS support
+  ✓ ConfigMap for environment
+  ✓ Horizontal Pod Autoscaler
+
+Generated successfully!
+      `.trim(),
+    },
+    {
+      id: 'review-chart',
+      title: 'Review Chart Configuration',
+      description: 'Examine the generated Chart.yaml and values.yaml',
+      command: 'nimbus explain helm charts/my-webapp',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Chart: my-webapp
+
+Chart.yaml:
+  name: my-webapp
+  version: 0.1.0
+  appVersion: "1.0.0"
+  description: A Helm chart for a web application
+  type: application
+
+values.yaml (key configurations):
+
+  replicaCount: 2
+
+  image:
+    repository: nginx
+    tag: "latest"
+    pullPolicy: IfNotPresent
+
+  service:
+    type: ClusterIP
+    port: 80
+
+  ingress:
+    enabled: false
+    className: "nginx"
+    hosts:
+      - host: my-webapp.local
+        paths:
+          - path: /
+            pathType: Prefix
+
+  resources:
+    limits:
+      cpu: 500m
+      memory: 512Mi
+    requests:
+      cpu: 100m
+      memory: 128Mi
+
+  autoscaling:
+    enabled: true
+    minReplicas: 2
+    maxReplicas: 10
+    targetCPUUtilization: 70
+
+This chart follows Helm best practices with
+configurable replicas, resources, and scaling.
+      `.trim(),
+    },
+    {
+      id: 'lint-chart',
+      title: 'Lint the Chart',
+      description: 'Validate the chart structure and templates',
+      command: 'nimbus helm lint charts/my-webapp',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+==> Linting charts/my-webapp
+
+[INFO] Chart.yaml: icon is recommended
+
+1 chart(s) linted, 0 chart(s) failed
+
+Lint Summary:
+  ✓ Chart.yaml valid
+  ✓ values.yaml valid
+  ✓ Templates compile correctly
+  ✓ Required files present
+
+Chart is ready for deployment!
+      `.trim(),
+    },
+    {
+      id: 'template-preview',
+      title: 'Preview Rendered Templates',
+      description: 'See what the chart will generate when installed',
+      command:
+        'nimbus helm template my-webapp charts/my-webapp --values charts/my-webapp/values.yaml | head -50',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+---
+# Source: my-webapp/templates/configmap.yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: my-webapp-config
+  labels:
+    app.kubernetes.io/name: my-webapp
+    app.kubernetes.io/instance: my-webapp
+data:
+  APP_ENV: "production"
+---
+# Source: my-webapp/templates/service.yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: my-webapp
+  labels:
+    app.kubernetes.io/name: my-webapp
+spec:
+  type: ClusterIP
+  ports:
+    - port: 80
+      targetPort: http
+      protocol: TCP
+      name: http
+  selector:
+    app.kubernetes.io/name: my-webapp
+---
+# Source: my-webapp/templates/deployment.yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: my-webapp
+  labels:
+    app.kubernetes.io/name: my-webapp
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: my-webapp
+  template:
+    ...
+      `.trim(),
+    },
+    {
+      id: 'install-release',
+      title: 'Install Helm Release (Dry Run)',
+      description: 'Deploy the chart to Kubernetes (dry run mode)',
+      command:
+        'nimbus apply helm --release my-webapp --chart charts/my-webapp --namespace demo --dry-run',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Dry Run - Helm Install
+
+Release: my-webapp
+Namespace: demo
+Chart: charts/my-webapp (0.1.0)
+
+Resources to be created:
+  ✓ ConfigMap/my-webapp-config
+  ✓ Service/my-webapp
+  ✓ Deployment/my-webapp
+  ✓ HorizontalPodAutoscaler/my-webapp
+
+Computed Values:
+  replicaCount: 2
+  image.repository: nginx
+  image.tag: latest
+  service.type: ClusterIP
+
+No resources were created (dry run mode)
+
+To install for real, remove --dry-run flag
+      `.trim(),
+    },
+    {
+      id: 'install-actual',
+      title: 'Install Helm Release',
+      description: 'Actually deploy the chart to the cluster',
+      command:
+        'nimbus apply helm --release my-webapp --chart charts/my-webapp --namespace demo --create-namespace',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Installing Helm release...
+
+NAME: my-webapp
+NAMESPACE: demo
+STATUS: deployed
+REVISION: 1
+
+Resources:
+  ✓ ConfigMap/my-webapp-config created
+  ✓ Service/my-webapp created
+  ✓ Deployment/my-webapp created
+  ✓ HorizontalPodAutoscaler/my-webapp created
+
+Waiting for deployment...
+  Pods: 2/2 ready
+
+NOTES:
+  Thank you for installing my-webapp!
+
+  To access the application:
+    kubectl port-forward svc/my-webapp 8080:80 -n demo
+    Then visit: http://localhost:8080
+
+Installation complete!
+      `.trim(),
+    },
+    {
+      id: 'list-releases',
+      title: 'List Helm Releases',
+      description: 'View all deployed Helm releases',
+      command: 'nimbus helm list --namespace demo',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+NAME       NAMESPACE  REVISION  STATUS    CHART            APP VERSION
+my-webapp  demo       1         deployed  my-webapp-0.1.0  1.0.0
+      `.trim(),
+    },
+    {
+      id: 'upgrade-release',
+      title: 'Upgrade Release',
+      description: 'Upgrade the release with new values',
+      command:
+        'nimbus helm upgrade my-webapp charts/my-webapp --namespace demo --set replicaCount=3',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Upgrading Helm release...
+
+Release "my-webapp" has been upgraded.
+REVISION: 2
+
+Changes:
+  - replicaCount: 2 -> 3
+
+Waiting for rollout...
+  Deployment updated: 3/3 replicas ready
+
+Upgrade complete!
+      `.trim(),
+    },
+    {
+      id: 'history',
+      title: 'View Release History',
+      description: 'See the revision history of the release',
+      command: 'nimbus helm history my-webapp --namespace demo',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+REVISION  STATUS      DESCRIPTION
+1         superseded  Install complete
+2         deployed    Upgrade complete
+      `.trim(),
+    },
+    {
+      id: 'cleanup',
+      title: 'Uninstall Release',
+      description: 'Remove the Helm release (optional)',
+      command: 'nimbus helm uninstall my-webapp --namespace demo',
+      showOutput: true,
+      waitForInput: false,
+      mockResponse: `
+Uninstalling release...
+
+release "my-webapp" uninstalled
+
+All resources removed:
+  - ConfigMap/my-webapp-config
+  - Service/my-webapp
+  - Deployment/my-webapp
+  - HorizontalPodAutoscaler/my-webapp
+
+Cleanup complete!
+      `.trim(),
+    },
+  ],
+};

package/src/demo/scenarios/k8s-deployment.ts

@@ -0,0 +1,194 @@
+/**
+ * Kubernetes Deployment Demo Scenario
+ *
+ * Demonstrates deploying an application to Kubernetes
+ */
+
+import type { DemoScenario } from '../types';
+
+export const k8sDeploymentScenario: DemoScenario = {
+  id: 'k8s-deployment',
+  name: 'Deploy to Kubernetes',
+  description: 'Learn how to generate and deploy Kubernetes manifests',
+  category: 'kubernetes',
+  duration: 10,
+  prerequisites: ['kubectl configured with cluster access', 'Nimbus CLI installed'],
+  tags: ['kubernetes', 'k8s', 'deployment', 'manifests'],
+  steps: [
+    {
+      id: 'check-cluster',
+      title: 'Verify Cluster Connection',
+      description: 'Check that kubectl can connect to your cluster',
+      command: 'nimbus k8s get nodes',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+NAME                 STATUS   ROLES           AGE   VERSION
+node-1               Ready    control-plane   30d   v1.28.0
+node-2               Ready    <none>          30d   v1.28.0
+node-3               Ready    <none>          30d   v1.28.0
+      `.trim(),
+    },
+    {
+      id: 'generate-manifests',
+      title: 'Generate Kubernetes Manifests',
+      description: 'Use Nimbus to generate deployment manifests for an nginx application',
+      command:
+        'nimbus generate k8s --type deployment --image nginx:latest --replicas 3 --port 80 --output ./k8s-demo',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Generating Kubernetes manifests...
+
+Created files:
+  k8s-demo/
+  ├── deployment.yaml    # Deployment with 3 replicas
+  ├── service.yaml       # ClusterIP service on port 80
+  └── kustomization.yaml # Kustomize configuration
+
+Configuration:
+  Image:    nginx:latest
+  Replicas: 3
+  Port:     80
+  Service:  ClusterIP
+
+Generated successfully!
+      `.trim(),
+    },
+    {
+      id: 'review-deployment',
+      title: 'Review Deployment Manifest',
+      description: 'Examine the generated deployment configuration',
+      command: 'nimbus explain k8s k8s-demo/deployment.yaml',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+File: k8s-demo/deployment.yaml
+
+This Kubernetes Deployment defines:
+
+1. Metadata
+   - Name: nginx
+   - Labels: app=nginx
+
+2. Pod Spec
+   - Replicas: 3
+   - Container: nginx:latest
+   - Port: 80 (HTTP)
+
+3. Resource Limits
+   - CPU: 100m request, 500m limit
+   - Memory: 128Mi request, 256Mi limit
+
+4. Health Checks
+   - Liveness probe: HTTP GET /
+   - Readiness probe: HTTP GET /
+
+5. Update Strategy
+   - RollingUpdate
+   - maxUnavailable: 1
+   - maxSurge: 1
+
+This is a production-ready deployment with proper
+resource management and health monitoring.
+      `.trim(),
+    },
+    {
+      id: 'preview-apply',
+      title: 'Preview Apply (Dry Run)',
+      description: 'See what would be created without actually applying',
+      command: 'nimbus apply k8s --path ./k8s-demo --dry-run',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Dry Run - Kubernetes Apply
+
+Resources to create:
+  ✓ deployment/nginx (3 replicas)
+  ✓ service/nginx (ClusterIP:80)
+
+Resource Summary:
+  Deployments: 1
+  Services:    1
+  ConfigMaps:  0
+  Secrets:     0
+
+No changes will be applied (dry run mode)
+      `.trim(),
+    },
+    {
+      id: 'apply-manifests',
+      title: 'Apply to Cluster',
+      description: 'Deploy the application to your Kubernetes cluster',
+      command: 'nimbus apply k8s --path ./k8s-demo --namespace demo',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Applying Kubernetes manifests...
+
+namespace/demo created
+deployment.apps/nginx created
+service/nginx created
+
+Waiting for deployment to be ready...
+  Replicas: 3/3 ready
+  Conditions: Available, Progressing
+
+Deployment successful!
+
+To access the application:
+  kubectl port-forward svc/nginx 8080:80 -n demo
+  Then visit: http://localhost:8080
+      `.trim(),
+    },
+    {
+      id: 'check-status',
+      title: 'Check Deployment Status',
+      description: 'Verify the deployment is running correctly',
+      command: 'nimbus k8s get pods --namespace demo',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+NAME                     READY   STATUS    RESTARTS   AGE
+nginx-5d4f8b7c9d-abc12   1/1     Running   0          30s
+nginx-5d4f8b7c9d-def34   1/1     Running   0          30s
+nginx-5d4f8b7c9d-ghi56   1/1     Running   0          30s
+      `.trim(),
+    },
+    {
+      id: 'scale-deployment',
+      title: 'Scale the Deployment',
+      description: 'Increase replicas to handle more traffic',
+      command: 'nimbus k8s scale deployment/nginx --replicas=5 --namespace demo',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+deployment.apps/nginx scaled
+
+Scaling deployment from 3 to 5 replicas...
+
+Current status:
+  Ready: 5/5 replicas
+
+Scaling complete!
+      `.trim(),
+    },
+    {
+      id: 'cleanup',
+      title: 'Clean Up Resources',
+      description: 'Remove the demo deployment (optional)',
+      command: 'nimbus k8s delete --path ./k8s-demo --namespace demo',
+      showOutput: true,
+      waitForInput: false,
+      mockResponse: `
+Deleting Kubernetes resources...
+
+deployment.apps/nginx deleted
+service/nginx deleted
+namespace/demo deleted
+
+Cleanup complete!
+      `.trim(),
+    },
+  ],
+};

package/src/demo/scenarios/terraform-vpc.ts

@@ -0,0 +1,170 @@
+/**
+ * Terraform VPC Demo Scenario
+ *
+ * Demonstrates creating a VPC with Terraform
+ */
+
+import type { DemoScenario } from '../types';
+
+export const terraformVpcScenario: DemoScenario = {
+  id: 'terraform-vpc',
+  name: 'Create AWS VPC with Terraform',
+  description: 'Deploy a complete VPC infrastructure using Nimbus and Terraform',
+  category: 'terraform',
+  duration: 10,
+  prerequisites: [
+    'AWS CLI configured with credentials',
+    'Terraform installed (v1.0+)',
+    'Nimbus CLI installed',
+  ],
+  tags: ['terraform', 'aws', 'vpc', 'networking'],
+  steps: [
+    {
+      id: 'init-project',
+      title: 'Initialize Nimbus Project',
+      description: 'Scan the current directory and set up Nimbus configuration',
+      command: 'nimbus init',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Nimbus Initialization
+
+Scanning project...
+
+Project Summary:
+  Type: infrastructure
+  Languages: HCL
+  IaC Tools: Terraform
+  Cloud: AWS
+
+Created .nimbus/project.yaml
+Created .nimbus/config.yaml
+
+Project initialized successfully!
+      `.trim(),
+    },
+    {
+      id: 'start-questionnaire',
+      title: 'Start Terraform Questionnaire',
+      description: 'Use the interactive wizard to configure VPC settings',
+      command: 'nimbus questionnaire terraform',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Terraform Configuration Wizard
+
+Starting local questionnaire...
+
+Step 1/3: Provider Configuration
+  Provider: aws
+  Region: us-east-1
+
+Step 2/3: Component Selection
+  Components: vpc
+
+Step 3/3: VPC Configuration
+  CIDR Block: 10.0.0.0/16
+  Availability Zones: 3
+
+Questionnaire completed!
+Generating code...
+
+Generated files:
+  ● main.tf
+  ● variables.tf
+  ● outputs.tf
+
+Output directory: ./terraform
+      `.trim(),
+    },
+    {
+      id: 'preview-plan',
+      title: 'Preview Terraform Plan',
+      description: 'See what changes will be made before applying',
+      command: 'nimbus preview terraform ./terraform',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Preview Terraform Changes
+
+Directory: ./terraform
+
+Creating execution plan...
+Plan created
+
+Plan Summary:
+
+  + 6 to add
+  ~ 0 to change
+  - 0 to destroy
+
+  Safety Check Summary:
+
+    🟡 [MEDIUM]  This operation will modify infrastructure
+
+All safety checks passed
+      `.trim(),
+    },
+    {
+      id: 'apply-terraform',
+      title: 'Apply Terraform Configuration',
+      description: 'Deploy the VPC infrastructure with safety approval',
+      command: 'nimbus apply terraform ./terraform',
+      showOutput: true,
+      waitForInput: true,
+      mockResponse: `
+Terraform Apply
+
+Directory: ./terraform
+
+Creating execution plan...
+Plan created
+
+Plan Summary:
+  + 6 to add
+
+╔══════════════════════════════════════════════════════════╗
+║               APPROVAL REQUIRED                          ║
+╠══════════════════════════════════════════════════════════╣
+║  Operation: terraform apply                              ║
+╚══════════════════════════════════════════════════════════╝
+
+  Identified Risks:
+
+    🟡 [MEDIUM]  This operation will modify infrastructure
+
+Do you want to proceed with this operation? Yes
+
+Operation approved
+
+Applying changes...
+Apply complete!
+
+Apply complete! Resources: 6 added, 0 changed, 0 destroyed.
+
+Outputs:
+  vpc_id = "vpc-0abc123def456789"
+  private_subnets = ["subnet-001", "subnet-002", "subnet-003"]
+  public_subnets = ["subnet-101", "subnet-102", "subnet-103"]
+      `.trim(),
+    },
+    {
+      id: 'verify-vpc',
+      title: 'Verify VPC Creation',
+      description: 'List VPCs to confirm our new VPC was created',
+      command: 'nimbus aws vpc list',
+      showOutput: true,
+      waitForInput: false,
+      mockResponse: `
+VPCs
+
+Found 2 VPC(s)
+
+VPC ID                Name           CIDR           State      Default
+─────────────────────────────────────────────────────────────────────
+vpc-default           default        172.31.0.0/16  available  Yes
+vpc-0abc123def456789  my-project     10.0.0.0/16    available  No
+      `.trim(),
+    },
+  ],
+};