Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .agents/skills/yandex-360-forms/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,7 @@ The OAuth token needs `forms:read` / `forms:write` scopes (see the auth section
| List questions (schema) | `uv run ycli forms questions list <form_id>` | `forms_questions_list` |
| Get one question | `uv run ycli forms questions get <form_id> <q_id>` | `forms_questions_get` |
| List answers (responses) | `uv run ycli forms answers list <form_id> [--all]` | `forms_answers_list` |
| The columns the cells of an answer stand in | `uv run ycli forms answers columns-list <form_id>` | `forms_answers_columns_list` |
| Fillable form view (option ids!) | `uv run ycli forms filling get <form_id>` | `forms_filling_get` |
| Suggest values for a question | `uv run ycli forms filling suggest <form_id> --question <slug> --text …` | `forms_filling_suggest` |
| Keysets | `uv run ycli forms keysets list\|get …` | `forms_keysets_list` / `forms_keysets_get` |
Expand All @@ -79,7 +80,7 @@ forms.me.get() # auth probe
forms.surveys.list() # list forms
forms.surveys.get("<form_id>") # form settings
forms.questions.list("<form_id>") # schema
forms.answers.list("<form_id>") # responses
forms.answers.list("<form_id>") # responses; forms.answers.columns_list("<form_id>") names their cells
```

---
Expand Down
3 changes: 2 additions & 1 deletion .claude/skills/yandex-360-forms/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ The OAuth token needs `forms:read` / `forms:write` scopes (see the auth section
| List questions (schema) | `uv run ycli forms questions list <form_id>` | `forms_questions_list` |
| Get one question | `uv run ycli forms questions get <form_id> <q_id>` | `forms_questions_get` |
| List answers (responses) | `uv run ycli forms answers list <form_id> [--all]` | `forms_answers_list` |
| The columns the cells of an answer stand in | `uv run ycli forms answers columns-list <form_id>` | `forms_answers_columns_list` |
| Fillable form view (option ids!) | `uv run ycli forms filling get <form_id>` | `forms_filling_get` |
| Suggest values for a question | `uv run ycli forms filling suggest <form_id> --question <slug> --text …` | `forms_filling_suggest` |
| Keysets | `uv run ycli forms keysets list\|get …` | `forms_keysets_list` / `forms_keysets_get` |
Expand All @@ -81,7 +82,7 @@ forms.me.get() # auth probe
forms.surveys.list() # list forms
forms.surveys.get("<form_id>") # form settings
forms.questions.list("<form_id>") # schema
forms.answers.list("<form_id>") # responses
forms.answers.list("<form_id>") # responses; forms.answers.columns_list("<form_id>") names their cells
```

---
Expand Down
3 changes: 2 additions & 1 deletion .opencode/skills/yandex-360-forms/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ The OAuth token needs `forms:read` / `forms:write` scopes (see the auth section
| List questions (schema) | `uv run ycli forms questions list <form_id>` | `forms_questions_list` |
| Get one question | `uv run ycli forms questions get <form_id> <q_id>` | `forms_questions_get` |
| List answers (responses) | `uv run ycli forms answers list <form_id> [--all]` | `forms_answers_list` |
| The columns the cells of an answer stand in | `uv run ycli forms answers columns-list <form_id>` | `forms_answers_columns_list` |
| Fillable form view (option ids!) | `uv run ycli forms filling get <form_id>` | `forms_filling_get` |
| Suggest values for a question | `uv run ycli forms filling suggest <form_id> --question <slug> --text …` | `forms_filling_suggest` |
| Keysets | `uv run ycli forms keysets list\|get …` | `forms_keysets_list` / `forms_keysets_get` |
Expand All @@ -81,7 +82,7 @@ forms.me.get() # auth probe
forms.surveys.list() # list forms
forms.surveys.get("<form_id>") # form settings
forms.questions.list("<form_id>") # schema
forms.answers.list("<form_id>") # responses
forms.answers.list("<form_id>") # responses; forms.answers.columns_list("<form_id>") names their cells
```

---
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,9 +132,9 @@ Timeouts, retries, limits, logging and the exit codes are in the [configuration
<!-- COVERAGE:START (generated by scripts/gen_coverage.py — do not edit by hand) -->
## Coverage

<img src="https://raw.githubusercontent.com/bim-ba/ycli/main/docs/assets/coverage.svg" alt="467 operations across 88 resources: Tracker 190, Wiki 58, Forms 85, DataLens 134" width="760">
<img src="https://raw.githubusercontent.com/bim-ba/ycli/main/docs/assets/coverage.svg" alt="468 operations across 88 resources: Tracker 190, Wiki 58, Forms 86, DataLens 134" width="760">

`ycli` wraps **467 operations across 88 resources** of the Tracker, Wiki, Forms, and DataLens API. Every one is reachable from the **Python SDK** and the **CLI**, and 457 **MCP** tools serve them to agents (455 per service plus `schema_get`, `status_get`).
`ycli` wraps **468 operations across 88 resources** of the Tracker, Wiki, Forms, and DataLens API. Every one is reachable from the **Python SDK** and the **CLI**, and 458 **MCP** tools serve them to agents (456 per service plus `schema_get`, `status_get`).

> **Legend.** ✅ in **CLI** or **MCP** means the resource is reachable on that surface; MCP tools carry honest hints (reads are `readOnlyHint`, writes say whether they are destructive or idempotent), and `ycli mcp start --read-only` serves only the reads. Resource and operation names link to the official **Yandex API reference**. An operation has one of three states against what Yandex publishes. **Covered** (no mark): ycli sends every published parameter and reads every published field. **Partial** (◐): ycli wraps it and differs somewhere; the mark links to the row that says where and why. **Not covered** (○): Yandex publishes it and ycli does not wrap it; these are listed under each service. Wiki, Forms and DataLens are measured against their OpenAPI documents; Tracker publishes none, so its state is measured against the reference pages (operations, and query parameters where a page lists them). DataLens is in progress, wrapped section by section: the operations of a section ycli has not begun are pending, not missing. Generated from the code by [`scripts/gen_coverage.py`](scripts/gen_coverage.py); do not edit by hand.

Expand Down Expand Up @@ -259,7 +259,7 @@ Timeouts, retries, limits, logging and the exit codes are in the [configuration
### Forms

<details>
<summary><b>16 resources · 85 operations · 78 MCP tools</b></summary>
<summary><b>16 resources · 86 operations · 79 MCP tools</b></summary>

**Surveys & questions**

Expand All @@ -275,7 +275,7 @@ Timeouts, retries, limits, logging and the exit codes are in the [configuration

| Resource | Operations | CLI | MCP |
|----------|------------|:---:|:---:|
| [answers](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) | [get](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answer_public_view) · [list](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) · [export](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_export_answers_public_view) · [export_results_get](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_export_answers_results_public_view) · [export_download](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_export_answers_results_public_view) · [integrations_list](https://yandex.ru/support/forms/en/api-ref/events/events_b2b_v1_views_answers_get_integrations_public_view) · [delete](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) · [restore](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) | ✅ | ✅ |
| [answers](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) | [get](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answer_public_view) · [list](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) · [columns_list](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) · [export](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_export_answers_public_view) · [export_results_get](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_export_answers_results_public_view) · [export_download](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_export_answers_results_public_view) · [integrations_list](https://yandex.ru/support/forms/en/api-ref/events/events_b2b_v1_views_answers_get_integrations_public_view) · [delete](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) · [restore](https://yandex.ru/support/forms/en/api-ref/answers/events_b2b_v1_views_answers_get_answers_public_view) | ✅ | ✅ |
| [operations](https://yandex.ru/support/forms/en/api-ref/operations/events_v1_views_operations_get_operation_view) | [get](https://yandex.ru/support/forms/en/api-ref/operations/events_v1_views_operations_get_operation_view) | ✅ | ✅ |

**Integrations**
Expand Down Expand Up @@ -396,7 +396,7 @@ Timeouts, retries, limits, logging and the exit codes are in the [configuration

</details>

Every resource and operation above deep-links to the Yandex API reference: 406 of 467 operations resolve to their own endpoint page and 19 to their resource's page. No public API reference exists yet for `datalens.cloudenvironments`, `datalens.cloudenvironments.create`, `datalens.cloudenvironments.delete`, `datalens.cloudenvironments.get`, `datalens.cloudenvironments.list`, `datalens.cloudenvironments.update`, `datalens.cloudenvironmentstorage`, `datalens.cloudenvironmentstorage.bucket_download_url_create`, `datalens.cloudenvironmentstorage.bucket_object_metadata_get`, `datalens.cloudenvironmentstorage.bucket_objects_list`, `datalens.cloudenvironmentstorage.bucket_upload_url_create`, `datalens.lakehouseoperations`, `datalens.lakehouseoperations.get`, `datalens.restcatalogs`, `datalens.restcatalogs.create`, `datalens.restcatalogs.list`, `datalens.sparkapplications`, `datalens.sparkapplications.cancel`, `datalens.sparkapplications.create`, `datalens.sparkapplications.get`, `datalens.sparkapplications.list`, `datalens.sparkapplications.log_list`, `datalens.sparkclusters`, `datalens.sparkclusters.create`, `datalens.sparkclusters.delete`, `datalens.sparkclusters.get`, `datalens.sparkclusters.list`, `datalens.sparkclusters.resource_presets_get`, `datalens.sparkclusters.resource_presets_list`, `datalens.sparkclusters.start`, `datalens.sparkclusters.stop`, `datalens.sqlqueries`, `datalens.sqlqueries.create`, `datalens.sqlqueries.delete`, `datalens.sqlqueries.get`, `datalens.sqlqueries.run`, `datalens.sqlqueries.update`, `datalens.tenant`, `datalens.tenant.details_get`, `datalens.trinoclusters`, `datalens.trinoclusters.catalog_create`, `datalens.trinoclusters.catalog_delete`, `datalens.trinoclusters.create`, `datalens.trinoclusters.delete`, `datalens.trinoclusters.get`, `datalens.trinoclusters.list`, `datalens.trinoclusters.resource_preset_get`, `datalens.trinoclusters.resource_presets_list`, `datalens.trinoclusters.start`, `datalens.trinoclusters.stop`, `tracker.linktypes`, `tracker.linktypes.list`, shown as plain text. See `CONTRIBUTING.md` for the intentional exclusions (UI-only endpoints with no public REST API) and per-method notes.
Every resource and operation above deep-links to the Yandex API reference: 406 of 468 operations resolve to their own endpoint page and 20 to their resource's page. No public API reference exists yet for `datalens.cloudenvironments`, `datalens.cloudenvironments.create`, `datalens.cloudenvironments.delete`, `datalens.cloudenvironments.get`, `datalens.cloudenvironments.list`, `datalens.cloudenvironments.update`, `datalens.cloudenvironmentstorage`, `datalens.cloudenvironmentstorage.bucket_download_url_create`, `datalens.cloudenvironmentstorage.bucket_object_metadata_get`, `datalens.cloudenvironmentstorage.bucket_objects_list`, `datalens.cloudenvironmentstorage.bucket_upload_url_create`, `datalens.lakehouseoperations`, `datalens.lakehouseoperations.get`, `datalens.restcatalogs`, `datalens.restcatalogs.create`, `datalens.restcatalogs.list`, `datalens.sparkapplications`, `datalens.sparkapplications.cancel`, `datalens.sparkapplications.create`, `datalens.sparkapplications.get`, `datalens.sparkapplications.list`, `datalens.sparkapplications.log_list`, `datalens.sparkclusters`, `datalens.sparkclusters.create`, `datalens.sparkclusters.delete`, `datalens.sparkclusters.get`, `datalens.sparkclusters.list`, `datalens.sparkclusters.resource_presets_get`, `datalens.sparkclusters.resource_presets_list`, `datalens.sparkclusters.start`, `datalens.sparkclusters.stop`, `datalens.sqlqueries`, `datalens.sqlqueries.create`, `datalens.sqlqueries.delete`, `datalens.sqlqueries.get`, `datalens.sqlqueries.run`, `datalens.sqlqueries.update`, `datalens.tenant`, `datalens.tenant.details_get`, `datalens.trinoclusters`, `datalens.trinoclusters.catalog_create`, `datalens.trinoclusters.catalog_delete`, `datalens.trinoclusters.create`, `datalens.trinoclusters.delete`, `datalens.trinoclusters.get`, `datalens.trinoclusters.list`, `datalens.trinoclusters.resource_preset_get`, `datalens.trinoclusters.resource_presets_list`, `datalens.trinoclusters.start`, `datalens.trinoclusters.stop`, `tracker.linktypes`, `tracker.linktypes.list`, shown as plain text. See `CONTRIBUTING.md` for the intentional exclusions (UI-only endpoints with no public REST API) and per-method notes.

### Against the published API

Expand Down
4 changes: 2 additions & 2 deletions README.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,9 +131,9 @@ YANDEX_ID_ORGANIZATION_ID=... # идентификатор вашей орг
<!-- COVERAGE:START (generated by scripts/gen_coverage.py — do not edit by hand) -->
## Покрытие API

<img src="https://raw.githubusercontent.com/bim-ba/ycli/main/docs/assets/coverage.svg" alt="Операций: 467, ресурсов: 88" width="760">
<img src="https://raw.githubusercontent.com/bim-ba/ycli/main/docs/assets/coverage.svg" alt="Операций: 468, ресурсов: 88" width="760">

Операций API Трекера, Вики, Форм и DataLens: **467** (Трекер — 190, Вики — 58, Формы — 85, DataLens — 134), ресурсов: **88**; все операции доступны из **Python SDK** и **CLI**. MCP-инструментов для агентов: **457**. Таблицы по ресурсам и операциям — в [английском README](README.md#coverage).
Операций API Трекера, Вики, Форм и DataLens: **468** (Трекер — 190, Вики — 58, Формы — 86, DataLens — 134), ресурсов: **88**; все операции доступны из **Python SDK** и **CLI**. MCP-инструментов для агентов: **458**. Таблицы по ресурсам и операциям — в [английском README](README.md#coverage).

Из опубликованных Яндексом операций обёрнуто: Трекер — 188 из 190, Вики — 56 из 56, Формы — 84 из 84, DataLens — 134 из 143. Чего ycli пока не умеет (параметры запросов, поля ответов), перечислено в разделе [Against the published API](README.md#against-the-published-api); сверка повторяется каждую неделю.
<!-- COVERAGE:END -->
Expand Down
10 changes: 5 additions & 5 deletions docs/assets/coverage.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading