67 lines
4.0 KiB
Markdown
67 lines
4.0 KiB
Markdown
# 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](docs/20_discovery/resource-creation-pattern.md#L3-L36)
|
|
|
|
- **Instance operation polling** — completion by `dtFinish`, success by `isSuccessful`.
|
|
- References: [docs/20_discovery/tubulus_and_polling_logic.md](docs/20_discovery/tubulus_and_polling_logic.md#L16-L25)
|
|
|
|
- **Modify parameter mapping** — create vs modify IDs differ (must map from manifest).
|
|
- References: [docs/50_history/06_postgres_update_and_immutable_params.md](docs/50_history/06_postgres_update_and_immutable_params.md#L6-L21)
|
|
|
|
- **Adopt/Resume behavior** — explicit flags `adopt_existing_on_create` and `suspend_on_destroy` with status-based matrix.
|
|
- References: [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#7-каноничная-lifecycle-логика-для-сервисов-с-suspendresume)
|
|
|
|
## API Discovery
|
|
- **Service parameters fetch** — `services/{svcId}` → `serviceOperation/{id}` → `param-value-list`.
|
|
- References: [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L19-L21)
|
|
|
|
- **Proxy endpoint** — `/index.cfm?endpoint=...` used for API access.
|
|
- References: [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L6)
|
|
|
|
## Validation & Normalization
|
|
- **JSON array validation** — `ValidJSONArray` for VM params.
|
|
- References: [docs/50_history/12_vm_resource_hardening.md](docs/50_history/12_vm_resource_hardening.md#L44-L104)
|
|
|
|
- **Empty map/list normalization** — `{}` / `[]` for map/json/list types.
|
|
- References: [docs/20_discovery/tubulus_and_polling_logic.md](docs/20_discovery/tubulus_and_polling_logic.md#L31-L34)
|
|
|
|
- **Validate-CFS usage** — validate before `run`.
|
|
- References: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L27)
|
|
|
|
## Errors & Incidents
|
|
- **VM FW failure stage** — `vm.fw_rules` failure in provisioning.
|
|
- References: [docs/20_discovery/vm_provisioning_failures.md](docs/20_discovery/vm_provisioning_failures.md#L28)
|
|
|
|
- **String[] → GUID crash** — backend type mismatch (`checkParam`).
|
|
- References: [docs/20_discovery/vm_provisioning_failures.md](docs/20_discovery/vm_provisioning_failures.md#L8-L16)
|
|
|
|
- **ImportState for Postgres** — dedicated import implementation.
|
|
- References: [docs/50_history/11_postgres_import_implementation.md](docs/50_history/11_postgres_import_implementation.md#L17-L38)
|
|
|
|
## Registry & Docs
|
|
- **GPG unknown issuer** — signature key mismatch.
|
|
- References: [docs/20_discovery/troubleshooting_gpg_and_registry.md](docs/20_discovery/troubleshooting_gpg_and_registry.md#L7-L14)
|
|
|
|
- **openpgp invalid data** — ASCII armor vs binary `.sig`.
|
|
- References: [docs/20_discovery/troubleshooting_gpg_and_registry.md](docs/20_discovery/troubleshooting_gpg_and_registry.md#L16-L23)
|
|
|
|
- **Proxy download mode** — registry server proxies downloads.
|
|
- References: [docs/50_history/02_registry_protocol_fix.md](docs/50_history/02_registry_protocol_fix.md#L41-L42)
|
|
|
|
- **Docs build & publish** — MkDocs + Docker + publish script.
|
|
- References: [docs/20_discovery/documentation_build_and_deploy.md](docs/20_discovery/documentation_build_and_deploy.md#L9-L39)
|
|
|
|
- **S3 docs pathing** — `docs/{ns}/{name}/{version}/`.
|
|
- References: [docs/20_discovery/s3-storage-and-docs-architecture.md](docs/20_discovery/s3-storage-and-docs-architecture.md#L15)
|
|
|
|
## Strategy
|
|
- **Early Termination** — fail plan early on logical conflicts.
|
|
- References: [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L16)
|
|
|
|
- **Confidence Scores** — mark certainty levels in docs/analysis.
|
|
- References: [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L30)
|