<!-- ⛔ LEGACY: deck-api.ngcloud.ru ЗАКРЫВАЕТСЯ. Актуальный API: lk-api-gateway.ngcloud.ru/api/v1/svc -->
# 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)