@build-astron-co/nimbus 0.2.0 → 0.4.0

package/dist/src/demo/scenarios/getting-started.js

@@ -0,0 +1,124 @@
+/**
+ * Getting Started Tutorial
+ *
+ * Interactive tutorial for new Nimbus users
+ */
+export const gettingStartedScenario = {
+    id: 'getting-started',
+    name: 'Getting Started with Nimbus',
+    description: 'Learn the basics of Nimbus CLI in this interactive tutorial',
+    category: 'tutorial',
+    duration: 5,
+    prerequisites: ['Nimbus CLI installed'],
+    tags: ['tutorial', 'beginner', 'basics'],
+    steps: [
+        {
+            id: 'check-version',
+            title: 'Check Nimbus Version',
+            description: "First, let's make sure Nimbus is installed correctly",
+            command: 'nimbus --version',
+            showOutput: true,
+            waitForInput: true,
+            mockResponse: 'nimbus version 1.0.0',
+        },
+        {
+            id: 'help',
+            title: 'View Available Commands',
+            description: "Nimbus has many commands - let's see what's available",
+            command: 'nimbus --help',
+            showOutput: true,
+            waitForInput: true,
+            mockResponse: `
+Nimbus CLI - AI-powered infrastructure assistant
+
+USAGE:
+  nimbus <command> [options]
+
+COMMANDS:
+  init          Initialize Nimbus in the current project
+  chat          Start an interactive chat session
+  generate      Generate infrastructure code
+  apply         Apply infrastructure changes
+  preview       Preview changes without applying
+  aws           AWS CLI commands
+  tf            Terraform commands
+  k8s           Kubernetes commands
+  helm          Helm commands
+
+FLAGS:
+  --version     Show version
+  --help        Show help
+      `.trim(),
+        },
+        {
+            id: 'doctor',
+            title: 'Run System Check',
+            description: 'Check that all required tools are installed',
+            command: 'nimbus doctor',
+            showOutput: true,
+            waitForInput: true,
+            mockResponse: `
+Nimbus Doctor
+
+Checking system requirements...
+
+  ✓ Node.js 18.0.0
+  ✓ Bun 1.0.0
+  ✓ Git 2.40.0
+  ✓ Terraform 1.5.0
+  ✓ kubectl 1.28.0
+  ✓ Helm 3.12.0
+  ✓ AWS CLI 2.13.0
+
+All checks passed!
+      `.trim(),
+        },
+        {
+            id: 'init-demo',
+            title: 'Initialize a Project',
+            description: 'Set up Nimbus in any directory to get started',
+            command: 'nimbus init --scan-depth quick',
+            showOutput: true,
+            waitForInput: true,
+            mockResponse: `
+Nimbus Initialization
+
+Scanning project (quick mode)...
+
+Project Summary:
+  Type: unknown
+  Languages: none detected
+
+Created .nimbus/project.yaml
+Created .nimbus/config.yaml
+
+Project initialized!
+
+Next steps:
+  1. Run 'nimbus chat' to get AI assistance
+  2. Run 'nimbus generate terraform' to create infrastructure
+  3. Run 'nimbus aws discover' to scan your AWS account
+      `.trim(),
+        },
+        {
+            id: 'config-list',
+            title: 'View Configuration',
+            description: 'See your current Nimbus configuration',
+            command: 'nimbus config list',
+            showOutput: true,
+            waitForInput: false,
+            mockResponse: `
+Nimbus Configuration
+
+  Key                    Value
+  ─────────────────────────────────────────
+  llm.provider           anthropic
+  llm.model              claude-3-sonnet
+  safety.enabled         true
+  safety.costThreshold   500
+  output.format          table
+  output.colors          true
+      `.trim(),
+        },
+    ],
+};

package/dist/src/demo/scenarios/helm-release.js

@@ -0,0 +1,334 @@
+/**
+ * Helm Release Demo Scenario
+ *
+ * Demonstrates creating and deploying a Helm chart
+ */
+export const helmReleaseScenario = {
+    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/dist/src/demo/scenarios/k8s-deployment.js

@@ -0,0 +1,190 @@
+/**
+ * Kubernetes Deployment Demo Scenario
+ *
+ * Demonstrates deploying an application to Kubernetes
+ */
+export const k8sDeploymentScenario = {
+    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(),
+        },
+    ],
+};