@robinmordasiewicz/f5xc-terraform-mcp 3.3.0 → 3.5.0

package/dist/index.d.ts

@@ -10,10 +10,11 @@
  * - Consolidated API specification tool (search/get/endpoints/definitions)
  * - Consolidated subscription tier tool
  * - Consolidated addon service tool
+ * - Resource metadata tool for deterministic AI configuration generation
  * - Provider summary tool
  *
  * Token Optimization:
- * - 14 tools consolidated to 6 tools (~77% token reduction)
+ * - 14 tools consolidated to 7 tools (~75% token reduction)
  * - Optimized descriptions using shared parameter descriptions
  * - Discovery meta-tool enables lazy schema loading
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}

package/dist/index.js

@@ -10,10 +10,11 @@
  * - Consolidated API specification tool (search/get/endpoints/definitions)
  * - Consolidated subscription tier tool
  * - Consolidated addon service tool
+ * - Resource metadata tool for deterministic AI configuration generation
  * - Provider summary tool
  *
  * Token Optimization:
- * - 14 tools consolidated to 6 tools (~77% token reduction)
+ * - 14 tools consolidated to 7 tools (~75% token reduction)
  * - Optimized descriptions using shared parameter descriptions
  * - Discovery meta-tool enables lazy schema loading
  *
@@ -40,8 +41,9 @@ import { handleDocs, DOCS_TOOL_DEFINITION } from './tools/docs.js';
 import { handleApi, API_TOOL_DEFINITION } from './tools/api.js';
 import { handleSubscription, SUBSCRIPTION_TOOL_DEFINITION } from './tools/subscription.js';
 import { handleAddon, ADDON_TOOL_DEFINITION } from './tools/addon.js';
+import { handleMetadata, METADATA_TOOL_DEFINITION } from './tools/metadata.js';
 // Consolidated schemas
-import { DiscoverSchema, DocsSchema, ApiSchema, SubscriptionSchema, AddonSchema, } from './schemas/common.js';
+import { DiscoverSchema, DocsSchema, ApiSchema, SubscriptionSchema, AddonSchema, MetadataSchema, } from './schemas/common.js';
 // Legacy schemas for get_summary tool
 import { GetSummarySchema } from './schemas/index.js';
 // Constants
@@ -164,7 +166,26 @@ server.registerTool(ADDON_TOOL_DEFINITION.name, {
     };
 });
 // =============================================================================
-// TOOL 6: SUMMARY TOOL (KEEP AS-IS)
+// TOOL 6: METADATA TOOL (NEW)
+// =============================================================================
+server.registerTool(METADATA_TOOL_DEFINITION.name, {
+    title: 'F5XC Resource Metadata',
+    description: METADATA_TOOL_DEFINITION.description,
+    inputSchema: MetadataSchema,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async (params) => {
+    const result = await handleMetadata(params);
+    return {
+        content: [{ type: 'text', text: result }],
+    };
+});
+// =============================================================================
+// TOOL 7: SUMMARY TOOL (KEEP AS-IS)
 // =============================================================================
 server.registerTool('f5xc_terraform_get_summary', {
     title: 'F5XC Provider Summary',
@@ -180,6 +201,12 @@ server.registerTool('f5xc_terraform_get_summary', {
     const docsSummary = getDocumentationSummary();
     const apiSummary = getApiSpecsSummary();
     const output = {
+        provider: {
+            name: 'robinmordasiewicz/f5xc',
+            registry_url: 'https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest',
+            github_url: 'https://github.com/robinmordasiewicz/terraform-provider-f5xc',
+            npm_package: '@robinmordasiewicz/f5xc-terraform-mcp',
+        },
         documentation: {
             total: Object.values(docsSummary).reduce((a, b) => a + b, 0),
             by_type: docsSummary,
@@ -194,6 +221,47 @@ server.registerTool('f5xc_terraform_get_summary', {
         const lines = [
             '# F5 Distributed Cloud Terraform Provider',
             '',
+            '## Provider Information',
+            '',
+            '| Property | Value |',
+            '|----------|-------|',
+            '| **Provider Name** | `robinmordasiewicz/f5xc` |',
+            '| **Registry URL** | https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest |',
+            '| **GitHub** | https://github.com/robinmordasiewicz/terraform-provider-f5xc |',
+            '| **npm Package** | `@robinmordasiewicz/f5xc-terraform-mcp` |',
+            '',
+            '## Quick Start',
+            '',
+            '### Terraform Configuration',
+            '',
+            '```hcl',
+            'terraform {',
+            '  required_providers {',
+            '    f5xc = {',
+            '      source = "robinmordasiewicz/f5xc"',
+            '    }',
+            '  }',
+            '}',
+            '',
+            'provider "f5xc" {',
+            '  # API Token authentication (recommended)',
+            '  api_url   = "https://your-tenant.console.ves.volterra.io"',
+            '  api_token = var.f5xc_api_token',
+            '}',
+            '```',
+            '',
+            '### Environment Variables',
+            '',
+            '| Variable | Description |',
+            '|----------|-------------|',
+            '| `F5XC_API_URL` | F5 Distributed Cloud API URL |',
+            '| `F5XC_API_TOKEN` | API Token for authentication |',
+            '| `F5XC_P12_FILE` | Path to P12 certificate file |',
+            '| `F5XC_P12_PASSWORD` | Password for P12 certificate |',
+            '| `F5XC_CERT` | Path to PEM certificate file |',
+            '| `F5XC_KEY` | Path to PEM private key file |',
+            '| `F5XC_CACERT` | Path to CA certificate file |',
+            '',
             '## Documentation',
             '',
             `Total: ${output.documentation.total} items`,
@@ -214,9 +282,12 @@ server.registerTool('f5xc_terraform_get_summary', {
         lines.push('- `f5xc_terraform_api` - Query API specs (operations: search, get, find_endpoints, get_definition, list_definitions)');
         lines.push('- `f5xc_terraform_subscription` - Check subscription tiers (operations: resource, property)');
         lines.push('- `f5xc_terraform_addon` - Addon services (operations: list, check, workflow)');
+        lines.push('- `f5xc_terraform_metadata` - Resource metadata for deterministic AI config generation (operations: oneof, validation, defaults, enums, attribute, requires_replace, summary)');
         lines.push('- `f5xc_terraform_get_summary` - This summary');
         lines.push('');
-        lines.push('> **Token Optimization**: 14 tools consolidated to 6 tools (~77% reduction)');
+        lines.push('> **Token Optimization**: 14 tools consolidated to 7 tools (~75% reduction)');
+        lines.push('');
+        lines.push('> **Note**: Use `f5xc_terraform_docs` with `operation: "get", name: "provider"` for complete provider documentation.');
         textContent = lines.join('\n');
     }
     else {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/metadata/error-patterns.json

@@ -0,0 +1,192 @@
+{
+  "version": "1.0.0",
+  "description": "Common F5XC Terraform provider error patterns and remediation guidance",
+  "error_codes": {
+    "NOT_FOUND": {
+      "status": 404,
+      "causes": [
+        "Resource deleted outside Terraform",
+        "Typo in resource name or namespace",
+        "Wrong namespace specified",
+        "Resource never existed"
+      ],
+      "remediation": [
+        "Run 'terraform refresh' to sync state",
+        "Check resource exists in F5XC console",
+        "Verify namespace is correct",
+        "Remove resource from state: terraform state rm <resource>"
+      ],
+      "operations": ["Read", "Update", "Delete"]
+    },
+    "CONFLICT": {
+      "status": 409,
+      "causes": [
+        "Resource already exists with same name",
+        "Concurrent modification detected",
+        "State drift from external changes"
+      ],
+      "remediation": [
+        "Import existing resource: terraform import <resource> <id>",
+        "Use a different name",
+        "Refresh state and retry: terraform refresh"
+      ],
+      "operations": ["Create"]
+    },
+    "UNAUTHORIZED": {
+      "status": 401,
+      "causes": [
+        "API token expired",
+        "Invalid credentials",
+        "Certificate expired",
+        "Token revoked"
+      ],
+      "remediation": [
+        "Rotate API token in F5XC console",
+        "Check F5XC_API_TOKEN environment variable",
+        "Verify P12 certificate is valid and not expired",
+        "Regenerate credentials and update provider config"
+      ],
+      "operations": ["Create", "Read", "Update", "Delete"]
+    },
+    "FORBIDDEN": {
+      "status": 403,
+      "causes": [
+        "Insufficient permissions for operation",
+        "Namespace access denied",
+        "Feature requires higher subscription tier",
+        "Resource in protected namespace"
+      ],
+      "remediation": [
+        "Check user/service account permissions in F5XC",
+        "Verify namespace access rights",
+        "Check subscription tier: f5xc_terraform_subscription(operation: 'resource')",
+        "Request elevated permissions from admin"
+      ],
+      "operations": ["Create", "Read", "Update", "Delete"]
+    },
+    "RATE_LIMIT": {
+      "status": 429,
+      "causes": [
+        "Too many API requests",
+        "Batch operation too large",
+        "Concurrent apply operations"
+      ],
+      "remediation": [
+        "Wait 60 seconds and retry (automatic exponential backoff)",
+        "Reduce parallelism: terraform apply -parallelism=5",
+        "Split large operations into batches",
+        "Implement request throttling"
+      ],
+      "operations": ["Create", "Read", "Update", "Delete"]
+    },
+    "VALIDATION_ERROR": {
+      "status": 400,
+      "causes": [
+        "Invalid field value",
+        "Missing required field",
+        "Field value exceeds limits",
+        "Invalid field combination"
+      ],
+      "remediation": [
+        "Check validation patterns: f5xc_terraform_metadata(operation: 'validation')",
+        "Check required fields: f5xc_terraform_metadata(operation: 'requires_replace')",
+        "Check enum values: f5xc_terraform_metadata(operation: 'enums')",
+        "Check OneOf constraints: f5xc_terraform_metadata(operation: 'oneof')"
+      ],
+      "operations": ["Create", "Update"]
+    },
+    "INTERNAL_ERROR": {
+      "status": 500,
+      "causes": [
+        "F5XC API internal error",
+        "Temporary service unavailability",
+        "Backend processing failure"
+      ],
+      "remediation": [
+        "Retry the operation after a delay",
+        "Check F5XC status page for incidents",
+        "Contact F5 support if persistent"
+      ],
+      "operations": ["Create", "Read", "Update", "Delete"]
+    },
+    "SERVICE_UNAVAILABLE": {
+      "status": 503,
+      "causes": [
+        "F5XC API temporarily unavailable",
+        "Maintenance in progress",
+        "Capacity limits reached"
+      ],
+      "remediation": [
+        "Wait and retry with exponential backoff",
+        "Check F5XC status page",
+        "Try again during off-peak hours"
+      ],
+      "operations": ["Create", "Read", "Update", "Delete"]
+    },
+    "TIMEOUT": {
+      "status": 0,
+      "causes": [
+        "Network connectivity issues",
+        "API response too slow",
+        "Large resource operation",
+        "Firewall blocking requests"
+      ],
+      "remediation": [
+        "Check network connectivity to F5XC API",
+        "Increase timeout: provider { timeout = \"5m\" }",
+        "Verify firewall allows HTTPS to *.volterra.io",
+        "Check for VPN or proxy issues"
+      ],
+      "operations": ["Create", "Read", "Update", "Delete"]
+    }
+  },
+  "common_patterns": {
+    "drift_detected": {
+      "pattern": "Resource Drift Detected",
+      "cause": "Resource modified outside Terraform",
+      "remediation": "Run 'terraform refresh' then 'terraform plan' to review changes"
+    },
+    "validation_failed": {
+      "pattern": "Invalid value for",
+      "cause": "Field value doesn't match validation rules",
+      "remediation": "Check f5xc_terraform_metadata(operation: 'validation') for patterns"
+    },
+    "oneof_conflict": {
+      "pattern": "Conflicting attributes",
+      "cause": "Multiple mutually exclusive fields set",
+      "remediation": "Check f5xc_terraform_metadata(operation: 'oneof') for constraints"
+    },
+    "missing_dependency": {
+      "pattern": "depends on resource that doesn't exist",
+      "cause": "Dependency not created or in different namespace",
+      "remediation": "Check f5xc_terraform_metadata(operation: 'dependencies') for required resources"
+    },
+    "subscription_required": {
+      "pattern": "feature requires.*subscription",
+      "cause": "Current subscription tier doesn't include this feature",
+      "remediation": "Check f5xc_terraform_subscription(operation: 'resource') for tier requirements"
+    },
+    "import_format": {
+      "pattern": "cannot import",
+      "cause": "Wrong import ID format used",
+      "remediation": "Use f5xc_terraform_metadata(operation: 'attribute') to check import_format"
+    },
+    "namespace_not_found": {
+      "pattern": "namespace.*not found|namespace does not exist",
+      "cause": "Target namespace doesn't exist or inaccessible",
+      "remediation": "Create namespace first or check namespace name spelling"
+    },
+    "secret_encryption": {
+      "pattern": "blindfold|secret.*invalid|encryption.*failed",
+      "cause": "Secret encryption/decryption issue",
+      "remediation": "Check SecretPolicy exists and blindfold function parameters"
+    }
+  },
+  "diagnostic_tips": {
+    "enable_debug": "Set TF_LOG=DEBUG for detailed API request/response logs",
+    "check_state": "Run 'terraform state list' to see managed resources",
+    "validate_config": "Run 'terraform validate' before apply",
+    "plan_first": "Always run 'terraform plan' before 'terraform apply'",
+    "check_provider_version": "Ensure provider version is current: terraform providers"
+  }
+}