@enjoys/context-engine 1.0.0

package/data/commands/terraform.json

@@ -0,0 +1,824 @@
+{
+  "name": "terraform",
+  "description": "Infrastructure as Code tool for building, changing, and versioning cloud infrastructure",
+  "category": "devops-infra",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "fish", "powershell"],
+  "subcommands": [
+    {
+      "name": "init",
+      "description": "Initialize a Terraform working directory by downloading providers, modules, and configuring the backend",
+      "args": [],
+      "options": [
+        { "name": "-backend", "description": "Configure the backend for this configuration (default true)", "type": "boolean" },
+        { "name": "-backend-config", "description": "Backend configuration key=value or path to a backend config file", "type": "string" },
+        { "name": "-from-module", "description": "Copy the contents of the given module into the target directory before init", "type": "string" },
+        { "name": "-get", "description": "Download modules for this configuration (default true)", "type": "boolean" },
+        { "name": "-input", "description": "Ask for input for variables if not directly set (default true)", "type": "boolean" },
+        { "name": "-lock", "description": "Don't hold a state lock during init (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-plugin-dir", "description": "Directory containing plugin binaries; disables automatic plugin download", "type": "path" },
+        { "name": "-reconfigure", "description": "Reconfigure the backend, ignoring any saved configuration" },
+        { "name": "-migrate-state", "description": "Migrate existing state to the new backend configuration" },
+        { "name": "-upgrade", "description": "Upgrade modules and plugins to the latest allowed versions" },
+        { "name": "-lockfile", "description": "Set a dependency lockfile mode (readonly)", "type": "string" },
+        { "name": "-ignore-remote-version", "description": "Ignore checking that the remote and local Terraform versions are compatible" }
+      ],
+      "examples": [
+        "terraform init",
+        "terraform init -upgrade",
+        "terraform init -reconfigure",
+        "terraform init -migrate-state",
+        "terraform init -backend-config=backend.hcl",
+        "terraform init -backend-config=\"bucket=my-tf-state\" -backend-config=\"key=prod/terraform.tfstate\"",
+        "terraform init -backend-config=environments/prod.backend.hcl",
+        "terraform init -plugin-dir=/path/to/plugins",
+        "terraform init -from-module=github.com/hashicorp/example",
+        "terraform init -lockfile=readonly",
+        "terraform init -backend=false"
+      ]
+    },
+    {
+      "name": "plan",
+      "description": "Create an execution plan showing what actions Terraform will take to reach the desired state",
+      "args": [],
+      "options": [
+        { "name": "-destroy", "description": "Generate a plan to destroy all resources" },
+        { "name": "-refresh-only", "description": "Generate a plan to update state to match remote objects" },
+        { "name": "-refresh", "description": "Skip checking for external changes during planning (default true)", "type": "boolean" },
+        { "name": "-replace", "description": "Force replacement of a particular resource instance (addr)", "type": "string" },
+        { "name": "-target", "description": "Limit the planning scope to specific resources", "type": "string" },
+        { "name": "-var", "description": "Set a variable value (key=value)", "type": "string" },
+        { "name": "-var-file", "description": "Set variables from a file", "type": "path" },
+        { "name": "-out", "description": "Write the plan to a file", "type": "path" },
+        { "name": "-input", "description": "Ask for input for variables if not directly set (default true)", "type": "boolean" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-parallelism", "description": "Limit the number of concurrent operations (default 10)", "type": "number" },
+        { "name": "-compact-warnings", "description": "Show warnings in a more compact form" },
+        { "name": "-detailed-exitcode", "description": "Return detailed exit codes: 0=no changes, 1=error, 2=changes present" },
+        { "name": "-generate-config-out", "description": "Generate configuration for import blocks and write to file", "type": "path" }
+      ],
+      "examples": [
+        "terraform plan",
+        "terraform plan -out=tfplan",
+        "terraform plan -var-file=prod.tfvars",
+        "terraform plan -var=\"instance_type=t3.large\"",
+        "terraform plan -target=module.vpc",
+        "terraform plan -target=aws_instance.web",
+        "terraform plan -replace=aws_instance.web",
+        "terraform plan -destroy",
+        "terraform plan -refresh-only",
+        "terraform plan -detailed-exitcode",
+        "terraform plan -no-color -compact-warnings",
+        "terraform plan -parallelism=20",
+        "terraform plan -var-file=common.tfvars -var-file=prod.tfvars",
+        "terraform plan -out=tfplan -lock-timeout=5m",
+        "terraform plan -generate-config-out=generated.tf"
+      ]
+    },
+    {
+      "name": "apply",
+      "description": "Apply the changes required to reach the desired state of the configuration",
+      "args": [
+        { "name": "<plan-file>", "type": "path", "required": false, "description": "Path to a previously saved plan file" }
+      ],
+      "options": [
+        { "name": "-auto-approve", "description": "Skip interactive approval of the plan" },
+        { "name": "-refresh-only", "description": "Apply only state refresh changes" },
+        { "name": "-refresh", "description": "Skip checking for external changes (default true)", "type": "boolean" },
+        { "name": "-replace", "description": "Force replacement of a particular resource instance", "type": "string" },
+        { "name": "-target", "description": "Limit the apply scope to specific resources", "type": "string" },
+        { "name": "-var", "description": "Set a variable value (key=value)", "type": "string" },
+        { "name": "-var-file", "description": "Set variables from a file", "type": "path" },
+        { "name": "-input", "description": "Ask for input for variables if not directly set (default true)", "type": "boolean" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-parallelism", "description": "Limit the number of concurrent operations (default 10)", "type": "number" },
+        { "name": "-compact-warnings", "description": "Show warnings in a more compact form" },
+        { "name": "-destroy", "description": "Alias for terraform destroy" }
+      ],
+      "examples": [
+        "terraform apply",
+        "terraform apply tfplan",
+        "terraform apply -auto-approve",
+        "terraform apply -var-file=prod.tfvars",
+        "terraform apply -var=\"instance_type=t3.large\" -auto-approve",
+        "terraform apply -target=module.vpc",
+        "terraform apply -target=aws_instance.web -auto-approve",
+        "terraform apply -replace=aws_instance.web",
+        "terraform apply -refresh-only -auto-approve",
+        "terraform apply -parallelism=20",
+        "terraform apply -lock-timeout=5m",
+        "terraform apply -compact-warnings -auto-approve"
+      ]
+    },
+    {
+      "name": "destroy",
+      "description": "Destroy all remote objects managed by the current Terraform configuration",
+      "args": [],
+      "options": [
+        { "name": "-auto-approve", "description": "Skip interactive approval before destroying" },
+        { "name": "-target", "description": "Limit the destroy scope to specific resources", "type": "string" },
+        { "name": "-var", "description": "Set a variable value (key=value)", "type": "string" },
+        { "name": "-var-file", "description": "Set variables from a file", "type": "path" },
+        { "name": "-input", "description": "Ask for input for variables if not directly set (default true)", "type": "boolean" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-parallelism", "description": "Limit the number of concurrent operations (default 10)", "type": "number" },
+        { "name": "-compact-warnings", "description": "Show warnings in a more compact form" },
+        { "name": "-refresh", "description": "Skip checking for external changes (default true)", "type": "boolean" }
+      ],
+      "examples": [
+        "terraform destroy",
+        "terraform destroy -auto-approve",
+        "terraform destroy -target=aws_instance.web",
+        "terraform destroy -target=module.vpc -auto-approve",
+        "terraform destroy -var-file=prod.tfvars -auto-approve",
+        "terraform destroy -parallelism=20 -auto-approve",
+        "terraform destroy -lock-timeout=5m"
+      ]
+    },
+    {
+      "name": "validate",
+      "description": "Validate the configuration files in a directory for correctness and internal consistency",
+      "args": [],
+      "options": [
+        { "name": "-json", "description": "Produce output in machine-readable JSON format" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-no-tests", "description": "Skip validation of test files" }
+      ],
+      "examples": [
+        "terraform validate",
+        "terraform validate -json",
+        "terraform validate -no-color",
+        "terraform validate -no-tests"
+      ]
+    },
+    {
+      "name": "fmt",
+      "description": "Rewrite Terraform configuration files to a canonical format and style",
+      "args": [
+        { "name": "<target>", "type": "path", "required": false, "description": "File or directory to format (default: current directory)" }
+      ],
+      "options": [
+        { "name": "-list", "description": "List files whose formatting differs (default true)", "type": "boolean" },
+        { "name": "-write", "description": "Write formatted output back to source files (default true)", "type": "boolean" },
+        { "name": "-diff", "description": "Display diffs of formatting changes" },
+        { "name": "-check", "description": "Check if input is formatted; return exit status 0 if formatted, non-zero otherwise" },
+        { "name": "-recursive", "description": "Also process files in subdirectories" },
+        { "name": "-no-color", "description": "Disable color codes in output" }
+      ],
+      "examples": [
+        "terraform fmt",
+        "terraform fmt -check",
+        "terraform fmt -diff",
+        "terraform fmt -recursive",
+        "terraform fmt -check -recursive",
+        "terraform fmt main.tf",
+        "terraform fmt -write=false -diff",
+        "terraform fmt modules/"
+      ]
+    },
+    {
+      "name": "show",
+      "description": "Show the current state or a saved plan in a human-readable form",
+      "args": [
+        { "name": "<path>", "type": "path", "required": false, "description": "Path to a state file or plan file" }
+      ],
+      "options": [
+        { "name": "-json", "description": "Produce output in machine-readable JSON format" },
+        { "name": "-no-color", "description": "Disable color codes in output" }
+      ],
+      "examples": [
+        "terraform show",
+        "terraform show -json",
+        "terraform show tfplan",
+        "terraform show -json tfplan",
+        "terraform show terraform.tfstate",
+        "terraform show -json | jq '.values.root_module.resources[]'",
+        "terraform show -no-color"
+      ]
+    },
+    {
+      "name": "output",
+      "description": "Read an output variable from the Terraform state file",
+      "args": [
+        { "name": "<name>", "type": "string", "required": false, "description": "Name of the output to read" }
+      ],
+      "options": [
+        { "name": "-json", "description": "Produce output in machine-readable JSON format" },
+        { "name": "-raw", "description": "Print the raw string value of the output without quotes" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-state", "description": "Path to the state file to read (default: terraform.tfstate)", "type": "path" }
+      ],
+      "examples": [
+        "terraform output",
+        "terraform output -json",
+        "terraform output instance_ip",
+        "terraform output -raw instance_ip",
+        "terraform output -json vpc_id",
+        "terraform output -state=prod.tfstate",
+        "terraform output -json | jq -r '.instance_ip.value'"
+      ]
+    },
+    {
+      "name": "refresh",
+      "description": "Update the state file to match real-world infrastructure (deprecated, prefer plan -refresh-only)",
+      "args": [],
+      "options": [
+        { "name": "-target", "description": "Limit refresh to specific resources", "type": "string" },
+        { "name": "-var", "description": "Set a variable value (key=value)", "type": "string" },
+        { "name": "-var-file", "description": "Set variables from a file", "type": "path" },
+        { "name": "-input", "description": "Ask for input for variables if not directly set (default true)", "type": "boolean" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-parallelism", "description": "Limit the number of concurrent operations (default 10)", "type": "number" }
+      ],
+      "examples": [
+        "terraform refresh",
+        "terraform refresh -var-file=prod.tfvars",
+        "terraform refresh -target=aws_instance.web",
+        "terraform refresh -no-color"
+      ]
+    },
+    {
+      "name": "import",
+      "description": "Import existing infrastructure into your Terraform state",
+      "args": [
+        { "name": "<addr>", "type": "string", "required": true, "description": "Terraform resource address (e.g. aws_instance.web)" },
+        { "name": "<id>", "type": "string", "required": true, "description": "Provider-specific resource ID" }
+      ],
+      "options": [
+        { "name": "-config", "description": "Path to Terraform configuration directory (default: current dir)", "type": "path" },
+        { "name": "-input", "description": "Ask for input for variables if not directly set (default true)", "type": "boolean" },
+        { "name": "-lock", "description": "Don't hold a state lock during import (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-var", "description": "Set a variable value (key=value)", "type": "string" },
+        { "name": "-var-file", "description": "Set variables from a file", "type": "path" },
+        { "name": "-ignore-remote-version", "description": "Ignore remote version check for state" },
+        { "name": "-allow-missing-config", "description": "Allow import when no resource configuration block exists" }
+      ],
+      "examples": [
+        "terraform import aws_instance.web i-1234567890abcdef0",
+        "terraform import aws_s3_bucket.bucket my-bucket-name",
+        "terraform import aws_security_group.sg sg-0123456789abcdef0",
+        "terraform import aws_vpc.main vpc-0123456789abcdef0",
+        "terraform import 'aws_instance.web[0]' i-1234567890abcdef0",
+        "terraform import module.vpc.aws_vpc.main vpc-0123456789abcdef0",
+        "terraform import -var-file=prod.tfvars aws_instance.web i-1234567890abcdef0",
+        "terraform import azurerm_resource_group.rg /subscriptions/sub-id/resourceGroups/my-rg",
+        "terraform import google_compute_instance.vm projects/my-project/zones/us-central1-a/instances/my-vm"
+      ]
+    },
+    {
+      "name": "taint",
+      "description": "Mark a resource instance as tainted, forcing it to be destroyed and recreated on the next apply (deprecated, prefer -replace)",
+      "args": [
+        { "name": "<addr>", "type": "string", "required": true, "description": "Address of the resource to taint" }
+      ],
+      "options": [
+        { "name": "-allow-missing", "description": "Succeed even if the resource is missing" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-ignore-remote-version", "description": "Ignore remote version check for state" }
+      ],
+      "examples": [
+        "terraform taint aws_instance.web",
+        "terraform taint 'aws_instance.web[0]'",
+        "terraform taint module.vpc.aws_subnet.public",
+        "terraform taint -allow-missing aws_instance.web"
+      ]
+    },
+    {
+      "name": "untaint",
+      "description": "Remove the taint from a resource instance, allowing it to persist on the next apply",
+      "args": [
+        { "name": "<addr>", "type": "string", "required": true, "description": "Address of the resource to untaint" }
+      ],
+      "options": [
+        { "name": "-allow-missing", "description": "Succeed even if the resource is missing" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-ignore-remote-version", "description": "Ignore remote version check for state" }
+      ],
+      "examples": [
+        "terraform untaint aws_instance.web",
+        "terraform untaint 'aws_instance.web[0]'",
+        "terraform untaint module.vpc.aws_subnet.public",
+        "terraform untaint -allow-missing aws_instance.web"
+      ]
+    },
+    {
+      "name": "state list",
+      "description": "List resources within the Terraform state",
+      "args": [
+        { "name": "<filter>", "type": "string", "required": false, "description": "Address filter pattern" }
+      ],
+      "options": [
+        { "name": "-state", "description": "Path to a state file (default: terraform.tfstate)", "type": "path" },
+        { "name": "-id", "description": "Filter by resource ID", "type": "string" }
+      ],
+      "examples": [
+        "terraform state list",
+        "terraform state list aws_instance",
+        "terraform state list module.vpc",
+        "terraform state list 'module.vpc.aws_subnet.*'",
+        "terraform state list -id=i-1234567890abcdef0"
+      ]
+    },
+    {
+      "name": "state show",
+      "description": "Show the attributes of a single resource in the state",
+      "args": [
+        { "name": "<addr>", "type": "string", "required": true, "description": "Address of the resource to show" }
+      ],
+      "options": [
+        { "name": "-state", "description": "Path to a state file (default: terraform.tfstate)", "type": "path" }
+      ],
+      "examples": [
+        "terraform state show aws_instance.web",
+        "terraform state show 'aws_instance.web[0]'",
+        "terraform state show module.vpc.aws_vpc.main",
+        "terraform state show aws_s3_bucket.assets"
+      ]
+    },
+    {
+      "name": "state mv",
+      "description": "Move a resource to a different address in the state",
+      "args": [
+        { "name": "<source>", "type": "string", "required": true, "description": "Current address of the resource" },
+        { "name": "<destination>", "type": "string", "required": true, "description": "New address for the resource" }
+      ],
+      "options": [
+        { "name": "-dry-run", "description": "Preview the move without actually performing it" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-state", "description": "Path to the source state file", "type": "path" },
+        { "name": "-state-out", "description": "Path to the destination state file", "type": "path" },
+        { "name": "-ignore-remote-version", "description": "Ignore remote version check for state" }
+      ],
+      "examples": [
+        "terraform state mv aws_instance.web aws_instance.app",
+        "terraform state mv aws_instance.web module.compute.aws_instance.web",
+        "terraform state mv module.old_name module.new_name",
+        "terraform state mv 'aws_instance.web[0]' 'aws_instance.web[1]'",
+        "terraform state mv -dry-run aws_instance.web aws_instance.app",
+        "terraform state mv -state-out=other.tfstate aws_instance.web aws_instance.web"
+      ]
+    },
+    {
+      "name": "state rm",
+      "description": "Remove resources from the Terraform state without destroying them",
+      "args": [
+        { "name": "<addr>", "type": "string", "required": true, "description": "Address of the resource(s) to remove" }
+      ],
+      "options": [
+        { "name": "-dry-run", "description": "Preview the removal without actually performing it" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-state", "description": "Path to the state file", "type": "path" },
+        { "name": "-ignore-remote-version", "description": "Ignore remote version check for state" }
+      ],
+      "examples": [
+        "terraform state rm aws_instance.web",
+        "terraform state rm 'aws_instance.web[0]'",
+        "terraform state rm module.vpc",
+        "terraform state rm module.vpc.aws_subnet.public",
+        "terraform state rm -dry-run aws_instance.web"
+      ]
+    },
+    {
+      "name": "state pull",
+      "description": "Pull the current state and output it to stdout",
+      "args": [],
+      "options": [],
+      "examples": [
+        "terraform state pull",
+        "terraform state pull | jq '.resources | length'",
+        "terraform state pull > backup.tfstate",
+        "terraform state pull | jq '.resources[].type' | sort -u"
+      ]
+    },
+    {
+      "name": "state push",
+      "description": "Update remote state from a local state file",
+      "args": [
+        { "name": "<path>", "type": "path", "required": true, "description": "Path to the state file to push" }
+      ],
+      "options": [
+        { "name": "-force", "description": "Write the state even if lineages don't match or serial is lower" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" }
+      ],
+      "examples": [
+        "terraform state push backup.tfstate",
+        "terraform state push -force errored.tfstate"
+      ]
+    },
+    {
+      "name": "state replace-provider",
+      "description": "Replace provider in the state",
+      "args": [
+        { "name": "<from>", "type": "string", "required": true, "description": "Current provider address (e.g. registry.terraform.io/hashicorp/aws)" },
+        { "name": "<to>", "type": "string", "required": true, "description": "New provider address" }
+      ],
+      "options": [
+        { "name": "-auto-approve", "description": "Skip interactive approval" },
+        { "name": "-lock", "description": "Don't hold a state lock during operations (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-ignore-remote-version", "description": "Ignore remote version check for state" }
+      ],
+      "examples": [
+        "terraform state replace-provider hashicorp/aws registry.example.com/acme/aws",
+        "terraform state replace-provider 'registry.terraform.io/hashicorp/aws' 'registry.terraform.io/-/aws'",
+        "terraform state replace-provider -auto-approve hashicorp/aws custom/aws"
+      ]
+    },
+    {
+      "name": "workspace new",
+      "description": "Create a new Terraform workspace",
+      "args": [
+        { "name": "<name>", "type": "string", "required": true, "description": "Name of the new workspace" }
+      ],
+      "options": [
+        { "name": "-lock", "description": "Don't hold a state lock (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" },
+        { "name": "-state", "description": "Copy an existing state file into the new workspace", "type": "path" }
+      ],
+      "examples": [
+        "terraform workspace new dev",
+        "terraform workspace new staging",
+        "terraform workspace new production",
+        "terraform workspace new feature-branch",
+        "terraform workspace new -state=existing.tfstate dev"
+      ]
+    },
+    {
+      "name": "workspace select",
+      "description": "Switch to an existing Terraform workspace",
+      "args": [
+        { "name": "<name>", "type": "string", "required": true, "description": "Name of the workspace to select" }
+      ],
+      "options": [
+        { "name": "-or-create", "description": "Create the workspace if it doesn't exist", "type": "boolean" }
+      ],
+      "examples": [
+        "terraform workspace select dev",
+        "terraform workspace select staging",
+        "terraform workspace select production",
+        "terraform workspace select default",
+        "terraform workspace select -or-create=true dev"
+      ]
+    },
+    {
+      "name": "workspace list",
+      "description": "List all Terraform workspaces",
+      "args": [],
+      "options": [],
+      "examples": [
+        "terraform workspace list"
+      ]
+    },
+    {
+      "name": "workspace show",
+      "description": "Show the name of the current Terraform workspace",
+      "args": [],
+      "options": [],
+      "examples": [
+        "terraform workspace show"
+      ]
+    },
+    {
+      "name": "workspace delete",
+      "description": "Delete an existing Terraform workspace",
+      "args": [
+        { "name": "<name>", "type": "string", "required": true, "description": "Name of the workspace to delete" }
+      ],
+      "options": [
+        { "name": "-force", "description": "Remove a workspace even if it has existing resources" },
+        { "name": "-lock", "description": "Don't hold a state lock (default true)", "type": "boolean" },
+        { "name": "-lock-timeout", "description": "Duration to retry a state lock (default 0s)", "type": "string" }
+      ],
+      "examples": [
+        "terraform workspace delete dev",
+        "terraform workspace delete -force old-workspace",
+        "terraform workspace delete feature-branch"
+      ]
+    },
+    {
+      "name": "providers",
+      "description": "Show the providers required by the current configuration",
+      "args": [],
+      "options": [],
+      "examples": [
+        "terraform providers"
+      ]
+    },
+    {
+      "name": "providers mirror",
+      "description": "Download the providers required by the current configuration into a local directory",
+      "args": [
+        { "name": "<target-dir>", "type": "path", "required": true, "description": "Directory to store the mirrored providers" }
+      ],
+      "options": [
+        { "name": "-platform", "description": "Target platform(s) to mirror (os_arch format)", "type": "string" }
+      ],
+      "examples": [
+        "terraform providers mirror /path/to/mirror",
+        "terraform providers mirror -platform=linux_amd64 /path/to/mirror",
+        "terraform providers mirror -platform=linux_amd64 -platform=darwin_arm64 ./providers-mirror"
+      ]
+    },
+    {
+      "name": "providers lock",
+      "description": "Write the dependency lock file for providers",
+      "args": [],
+      "options": [
+        { "name": "-platform", "description": "Target platform(s) to include in the lock file (os_arch format)", "type": "string" },
+        { "name": "-fs-mirror", "description": "Filesystem mirror directory to use", "type": "path" },
+        { "name": "-net-mirror", "description": "Network mirror URL to use", "type": "string" }
+      ],
+      "examples": [
+        "terraform providers lock",
+        "terraform providers lock -platform=linux_amd64 -platform=darwin_arm64",
+        "terraform providers lock -platform=linux_amd64 -platform=darwin_amd64 -platform=windows_amd64",
+        "terraform providers lock -fs-mirror=/path/to/mirror"
+      ]
+    },
+    {
+      "name": "providers schema",
+      "description": "Print the schemas for the providers used in the configuration",
+      "args": [],
+      "options": [
+        { "name": "-json", "description": "Output the schemas in JSON format" }
+      ],
+      "examples": [
+        "terraform providers schema -json",
+        "terraform providers schema -json | jq '.provider_schemas[\"registry.terraform.io/hashicorp/aws\"]'"
+      ]
+    },
+    {
+      "name": "graph",
+      "description": "Generate a visual representation of the dependency graph in DOT format",
+      "args": [],
+      "options": [
+        { "name": "-type", "description": "Type of graph to output (plan, plan-refresh-only, plan-destroy, apply)", "type": "string" },
+        { "name": "-draw-cycles", "description": "Highlight any cycles in the graph with colored edges" },
+        { "name": "-plan", "description": "Render the graph based on a specific plan file", "type": "path" }
+      ],
+      "examples": [
+        "terraform graph",
+        "terraform graph | dot -Tpng > graph.png",
+        "terraform graph | dot -Tsvg > graph.svg",
+        "terraform graph -type=plan",
+        "terraform graph -type=plan-destroy",
+        "terraform graph -draw-cycles",
+        "terraform graph -plan=tfplan"
+      ]
+    },
+    {
+      "name": "console",
+      "description": "Open an interactive console for evaluating Terraform expressions",
+      "args": [],
+      "options": [
+        { "name": "-state", "description": "Path to a state file to use for evaluation", "type": "path" },
+        { "name": "-var", "description": "Set a variable value (key=value)", "type": "string" },
+        { "name": "-var-file", "description": "Set variables from a file", "type": "path" },
+        { "name": "-plan", "description": "Use a plan file for evaluation context", "type": "path" }
+      ],
+      "examples": [
+        "terraform console",
+        "terraform console -var-file=prod.tfvars",
+        "echo 'tolist([\"a\", \"b\", \"c\"])' | terraform console",
+        "echo 'length(var.subnets)' | terraform console",
+        "echo 'aws_instance.web.id' | terraform console",
+        "echo 'jsonencode({a = 1, b = 2})' | terraform console"
+      ]
+    },
+    {
+      "name": "force-unlock",
+      "description": "Manually unlock the state for the current configuration",
+      "args": [
+        { "name": "<lock-id>", "type": "string", "required": true, "description": "Lock ID from the lock error message" }
+      ],
+      "options": [
+        { "name": "-force", "description": "Don't ask for input for unlock confirmation" }
+      ],
+      "examples": [
+        "terraform force-unlock LOCK_ID",
+        "terraform force-unlock -force LOCK_ID",
+        "terraform force-unlock 2b6a6738-5ef0-7c89-af76-123abc456def"
+      ]
+    },
+    {
+      "name": "login",
+      "description": "Obtain and save credentials for a remote host (Terraform Cloud by default)",
+      "args": [
+        { "name": "<hostname>", "type": "string", "required": false, "description": "Hostname of the Terraform service (default: app.terraform.io)" }
+      ],
+      "options": [],
+      "examples": [
+        "terraform login",
+        "terraform login app.terraform.io",
+        "terraform login tfe.example.com"
+      ]
+    },
+    {
+      "name": "logout",
+      "description": "Remove locally-stored credentials for a remote host",
+      "args": [
+        { "name": "<hostname>", "type": "string", "required": false, "description": "Hostname of the Terraform service (default: app.terraform.io)" }
+      ],
+      "options": [],
+      "examples": [
+        "terraform logout",
+        "terraform logout app.terraform.io",
+        "terraform logout tfe.example.com"
+      ]
+    },
+    {
+      "name": "version",
+      "description": "Print the Terraform version and installed provider versions",
+      "args": [],
+      "options": [
+        { "name": "-json", "description": "Output version information in JSON format" }
+      ],
+      "examples": [
+        "terraform version",
+        "terraform version -json",
+        "terraform version -json | jq '.terraform_version'"
+      ]
+    },
+    {
+      "name": "get",
+      "description": "Download and update modules mentioned in the root module",
+      "args": [],
+      "options": [
+        { "name": "-update", "description": "Check all modules for updates and download updates if needed" },
+        { "name": "-no-color", "description": "Disable color codes in output" }
+      ],
+      "examples": [
+        "terraform get",
+        "terraform get -update",
+        "terraform get -no-color"
+      ]
+    },
+    {
+      "name": "test",
+      "description": "Execute integration tests for Terraform modules",
+      "args": [],
+      "options": [
+        { "name": "-cloud-run", "description": "Run tests on Terraform Cloud in the specified organization", "type": "string" },
+        { "name": "-filter", "description": "Only run test files that match the given filter glob pattern", "type": "string" },
+        { "name": "-json", "description": "Produce output in machine-readable JSON format" },
+        { "name": "-no-color", "description": "Disable color codes in output" },
+        { "name": "-test-directory", "description": "Set the test directory (default: tests)", "type": "path" },
+        { "name": "-var", "description": "Set a variable value (key=value)", "type": "string" },
+        { "name": "-var-file", "description": "Set variables from a file", "type": "path" },
+        { "name": "-verbose", "description": "Print the plan or state for each run block as it executes" }
+      ],
+      "examples": [
+        "terraform test",
+        "terraform test -verbose",
+        "terraform test -filter=tests/vpc_test.tftest.hcl",
+        "terraform test -json",
+        "terraform test -var-file=testing.tfvars",
+        "terraform test -var=\"region=us-west-2\"",
+        "terraform test -test-directory=integration-tests"
+      ]
+    }
+  ],
+  "globalOptions": [
+    { "name": "-chdir", "description": "Switch to a different working directory before executing the command", "type": "path" },
+    { "name": "-help", "description": "Show help for a command" },
+    { "name": "-version", "description": "Show the Terraform version" },
+    { "name": "-no-color", "description": "Disable color codes in output" }
+  ],
+  "examples": [
+    "terraform init",
+    "terraform plan -out=tfplan",
+    "terraform apply tfplan",
+    "terraform apply -auto-approve",
+    "terraform destroy -auto-approve",
+    "terraform fmt -recursive",
+    "terraform validate -json",
+    "terraform state list",
+    "terraform workspace select production",
+    "terraform import aws_instance.web i-1234567890abcdef0",
+    "terraform output -json",
+    "terraform show -json tfplan | jq '.'",
+    "terraform console",
+    "terraform graph | dot -Tpng > graph.png",
+    "terraform plan -var-file=prod.tfvars -out=tfplan",
+    "terraform apply -target=module.networking -auto-approve",
+    "terraform state mv aws_instance.old aws_instance.new",
+    "terraform providers lock -platform=linux_amd64 -platform=darwin_arm64",
+    "terraform test -verbose",
+    "terraform force-unlock LOCK_ID"
+  ],
+  "relatedCommands": ["terragrunt", "pulumi", "ansible", "packer"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "workspace",
+        "description": "Currently active Terraform workspace",
+        "command": "terraform workspace show",
+        "parser": "text",
+        "cacheFor": 10,
+        "requiresCmd": "terraform"
+      },
+      {
+        "name": "workspaces",
+        "description": "All available Terraform workspaces",
+        "command": "terraform workspace list",
+        "parser": "lines",
+        "cacheFor": 30,
+        "requiresCmd": "terraform"
+      },
+      {
+        "name": "state_resources",
+        "description": "All resources tracked in the current Terraform state",
+        "command": "terraform state list 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 15,
+        "requiresCmd": "terraform"
+      },
+      {
+        "name": "outputs",
+        "description": "All outputs from the current Terraform state in JSON format",
+        "command": "terraform output -json 2>/dev/null",
+        "parser": "json",
+        "cacheFor": 15,
+        "requiresCmd": "terraform"
+      },
+      {
+        "name": "providers",
+        "description": "Providers required by the current configuration",
+        "command": "terraform providers 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 60,
+        "requiresCmd": "terraform"
+      },
+      {
+        "name": "tf_version",
+        "description": "Terraform version and installed provider versions",
+        "command": "terraform version -json",
+        "parser": "json",
+        "cacheFor": 300,
+        "requiresCmd": "terraform"
+      },
+      {
+        "name": "plan_summary",
+        "description": "Quick summary of pending infrastructure changes",
+        "command": "terraform plan -no-color -compact-warnings 2>/dev/null | tail -5",
+        "parser": "text",
+        "cacheFor": 30,
+        "requiresCmd": "terraform"
+      },
+      {
+        "name": "tf_files",
+        "description": "Terraform configuration files in the current directory",
+        "command": "find . -maxdepth 1 -name '*.tf' -exec basename {} \\;",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "variables",
+        "description": "Variable names defined in Terraform configuration files",
+        "command": "grep -h 'variable \"' *.tf 2>/dev/null | sed 's/variable \"//;s/\".*//'",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "modules",
+        "description": "Module sources referenced in the configuration",
+        "command": "grep -rh 'source.*=' *.tf 2>/dev/null | head -20",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "backend_config",
+        "description": "Backend configuration block from Terraform files",
+        "command": "grep -A 5 'backend \"' *.tf 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 60
+      },
+      {
+        "name": "terraform_cloud",
+        "description": "Terraform Cloud workspace environment configuration",
+        "command": "cat .terraform/environment 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 30
+      }
+    ]
+  }
+}