tf_provider/docs/help/ai_glossary.md

AI-Agent Glossary (Search-Oriented Index)

Purpose: compact, English, link-rich glossary to help AI agents find facts fast in this repo.

Architecture & Flow

• 7-step create flow — canonical instance creation lifecycle.

  • References: docs/20_discovery/resource-creation-pattern.md

• Instance operation polling — completion by dtFinish, success by isSuccessful.

  • References: docs/20_discovery/tubulus_and_polling_logic.md

• Modify parameter mapping — create vs modify IDs differ (must map from manifest).

  • References: docs/50_history/06_postgres_update_and_immutable_params.md

• Adopt/Resume behavior — explicit flags adopt_existing_on_create and suspend_on_destroy with status-based matrix.

  • References: docs/60_strategy/provider_philosophy.md

API Discovery

• Service parameters fetch — services/{svcId} → serviceOperation/{id} → param-value-list.

  • References: docs/40_analysis/har/discovery/service_parameters_fetch.md

• Proxy endpoint — /index.cfm?endpoint=... used for API access.

  • References: docs/40_analysis/har/discovery/service_parameters_fetch.md

Validation & Normalization

• JSON array validation — ValidJSONArray for VM params.

  • References: docs/50_history/12_vm_resource_hardening.md

• Empty map/list normalization — {} / [] for map/json/list types.

  • References: docs/20_discovery/tubulus_and_polling_logic.md

• Validate-CFS usage — validate before run.

  • References: docs/20_discovery/resource-creation-pattern.md

Errors & Incidents

• VM FW failure stage — vm.fw_rules failure in provisioning.

  • References: docs/20_discovery/vm_provisioning_failures.md

• String[] → GUID crash — backend type mismatch (checkParam).

  • References: docs/20_discovery/vm_provisioning_failures.md

• ImportState for Postgres — dedicated import implementation.

  • References: docs/50_history/11_postgres_import_implementation.md

Registry & Docs

• GPG unknown issuer — signature key mismatch.

  • References: docs/20_discovery/troubleshooting_gpg_and_registry.md

• openpgp invalid data — ASCII armor vs binary .sig.

  • References: docs/20_discovery/troubleshooting_gpg_and_registry.md

• Proxy download mode — registry server proxies downloads.

  • References: docs/50_history/02_registry_protocol_fix.md

• Docs build & publish — MkDocs + Docker + publish script.

  • References: docs/20_discovery/documentation_build_and_deploy.md

• S3 docs pathing — docs/{ns}/{name}/{version}/.

  • References: docs/20_discovery/s3-storage-and-docs-architecture.md

Strategy

• Early Termination — fail plan early on logical conflicts.

  • References: docs/60_strategy/provider_philosophy.md

• Confidence Scores — mark certainty levels in docs/analysis.

  • References: docs/60_strategy/provider_philosophy.md