direct-cli 0.3.3__tar.gz → 0.3.5__tar.gz

direct_cli-0.3.5/.github/workflows/quality.yml

@@ -0,0 +1,33 @@
+name: Quality
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  quality:
+    name: quality
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install package with dev dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check .
+
+      - name: Type check
+        run: mypy .
+
+      - name: Run offline tests
+        run: pytest -m "not integration"

{direct_cli-0.3.3 → direct_cli-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: direct-cli
-Version: 0.3.3
+Version: 0.3.5
 Summary: Command-line interface for Yandex Direct API
 Author: axisrow
 License: MIT
@@ -33,9 +33,13 @@ Requires-Dist: pytest-recording>=0.13; extra == "dev"
 Requires-Dist: vcrpy>=6.0; extra == "dev"
 Requires-Dist: black>=22.0; extra == "dev"
 Requires-Dist: flake8>=4.0; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
 Requires-Dist: requests>=2.0; extra == "dev"
 Requires-Dist: beautifulsoup4>=4.12; extra == "dev"
 Requires-Dist: lxml>=4.9; extra == "dev"
+Requires-Dist: types-setuptools; extra == "dev"
+Requires-Dist: types-tabulate; extra == "dev"
 
 # Direct CLI
 
@@ -82,7 +86,9 @@ OAuth and profile commands:
 ```bash
 direct auth login
 direct auth login --profile agency1
+direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
+printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -95,6 +101,10 @@ Notes:
 - `--login` remains Direct client login.
 - Authorization is performed via `direct auth login`.
 - OAuth profiles store refresh tokens and refresh access tokens automatically.
+- In a non-interactive shell, run `direct auth login --profile NAME` first, then finish with `direct auth login --code-stdin --profile NAME` and pass the browser code on stdin.
+- `direct auth login --code CODE --profile NAME` remains supported for compatibility, but `--code-stdin` avoids exposing the code in process arguments.
+- If the first non-interactive step includes `--client-secret`, the secret is remembered for the matching completion step.
+- If a profile already stores a confidential OAuth client, `direct auth login --code CODE --profile NAME` reuses the saved `client_id` and `client_secret`.
 - `direct auth login --oauth-token TOKEN` is a manual access-token import and does not auto-refresh.
 - Alias `auth_login` is not supported.
 
@@ -155,6 +165,19 @@ direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:
 direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00 --currency RUB --limit 100 --offset 0 --format table
 ```
 
+### V4 Live Wordstat Reports
+
+Wordstat reports are asynchronous. Direct CLI makes exactly one API call per
+command and does not poll automatically; repeat `list-reports` or `get-report`
+yourself until the report is ready.
+
+```bash
+direct v4wordstat create-report --phrases "buy laptop,buy desktop" --geo-ids 213
+direct v4wordstat list-reports --format table
+direct v4wordstat get-report --report-id 123 --format table
+direct v4wordstat delete-report --report-id 123
+```
+
 ### V4 Live Finance
 
 Finance methods require an extra financial token for money operations. In the
@@ -165,13 +188,16 @@ per-request token from `--master-token`, `--operation-num`, and
 `--finance-login`; alternatively pass a precomputed token with `--finance-token`.
 Environment variables are
 `YANDEX_DIRECT_MASTER_TOKEN`, `YANDEX_DIRECT_FINANCE_LOGIN`,
-`YANDEX_DIRECT_FINANCE_TOKEN`, and `YANDEX_DIRECT_OPERATION_NUM`. Money mutation
-commands are dry-run-only in this release and always require `--dry-run`; dry-run
-output masks the financial token.
+`YANDEX_DIRECT_FINANCE_TOKEN`, and `YANDEX_DIRECT_OPERATION_NUM`.
+`transfer-money` and `pay-campaigns` are dry-run-only in this release and
+always require `--dry-run`; `create-invoice` can be sent live when `--dry-run`
+is omitted. Dry-run output masks the financial token.
 
 ```bash
+direct v4finance get-clients-units --logins client-login,other-client --format table
 direct v4finance get-credit-limits --logins client-login --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login
 direct v4finance get-credit-limits --logins client-login,other-client --format table
+direct v4finance create-invoice --payment 123=100.50 --payment 456=25 --currency RUB --master-token MASTER_TOKEN --operation-num 124 --finance-login agency-login --dry-run
 direct v4finance check-payment --custom-transaction-id A123456789012345678901234567890B
 direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --currency RUB --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
 direct v4finance pay-campaigns --campaign-ids 123,456 --amount 100.50 --currency RUB --contract-id CONTRACT_ID --pay-method Bank --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
@@ -179,12 +205,15 @@ direct v4finance pay-campaigns --campaign-ids 123,456 --amount 100.50 --currency
 
 ### V4 Live Shared Account
 
-Shared-account mutations are dry-run-only in this release and always require
-`--dry-run`.
+Shared-account mutations require `--dry-run` in production and can be sent live
+only with top-level `--sandbox`. These commands follow the official v4 Live
+shared-account method shapes: `EnableSharedAccount` accepts one client `Login`,
+and `AccountManagement` updates shared-account settings through `Accounts`.
 
 ```bash
 direct v4account enable-shared-account --client-login client-login --dry-run
 direct v4account account-management --action Update --account-id 1327944 --day-budget 100.50 --spend-mode Default --money-in-sms Yes --money-out-sms No --email ops@example.com --money-warning-value 25 --dry-run
+direct --sandbox v4account enable-shared-account --client-login client-login
 ```
 
 ### CLI Convention
@@ -254,13 +283,8 @@ Allowed:
 direct dictionaries get-geo-regions --region-ids 225,187 --fields GeoRegionId,GeoRegionName
 ```
 
-Not allowed:
-
-```bash
-direct dictionaries get-geo-regions \
-  --region-ids 225,187 \
-  --fields GeoRegionId,GeoRegionName
-```
+Not allowed: splitting a canonical `direct ...` command over multiple shell
+lines with `\`.
 
 #### Flag Design Rules
 
@@ -286,12 +310,8 @@ Use:
 direct changes check-campaigns --timestamp 2026-04-14T00:00:00
 ```
 
-Do not use:
-
-```bash
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Do not use: a timestamp with a `Z` suffix, or a quoted timestamp that contains
+a space between the date and time.
 
 #### Documentation Contract
 
@@ -313,17 +333,9 @@ direct dynamicads set-bids --id 789 --bid 12500000 --context-bid 9000000 --prior
 direct dictionaries get-geo-regions --name Moscow --region-ids 225,187 --exact-names Москва,Санкт-Петербург --fields GeoRegionId,GeoRegionName
 ```
 
-Invalid examples:
-
-```bash
-direct dictionaries get-geo-regions --json '{"GeoRegionIds":[225]}' --fields GeoRegionId,GeoRegionName
-direct dynamicads set-bids --id 789 --bid 12500000 --json '{"StrategyPriority":"HIGH"}'
-direct dictionaries get-geo-regions \
-  --region-ids 225 \
-  --fields GeoRegionId,GeoRegionName
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Invalid examples include command lines that pass raw JSON flags, use shell
+line continuations, add timezone suffixes to CLI datetimes, or quote
+space-separated datetime values.
 
 #### Campaigns
 
@@ -435,8 +447,8 @@ direct dynamicads set-bids --id 789 --bid 12500000 --context-bid 9000000 --prior
 
 # Shared bidding strategies
 direct strategies get --limit 5
-direct strategies add --name "Shared Clicks" --type WbMaximumClicks --params '{"SpendLimit":1000000000,"AverageCpc":30000000}' --dry-run
-direct strategies update --id 42 --params '{"AverageCpc":35000000}' --dry-run
+direct strategies add --name "Shared Clicks" --type WbMaximumClicks --spend-limit 1000000000 --average-cpc 30000000 --dry-run
+direct strategies update --id 42 --type WbMaximumClicks --average-cpc 35000000 --dry-run
 direct strategies archive --id 42 --dry-run
 
 # Dynamic feed ad targets
@@ -611,6 +623,11 @@ The report contains one row per `WRITE_SANDBOX` command:
 The same OAuth token works for both production and the sandbox; no separate
 sandbox token is needed.
 
+For `v4account` sandbox smoke, `enable-shared-account` uses
+`YANDEX_DIRECT_V4ACCOUNT_CLIENT_LOGIN` or falls back to `YANDEX_DIRECT_LOGIN`.
+`account-management` requires `YANDEX_DIRECT_V4ACCOUNT_ACCOUNT_ID`; without it
+the runner reports `NOT_COVERED` for that command.
+
 #### Re-recording write cassettes
 
 The `integration_write` pytest tier still replays stored write-test traffic
@@ -731,7 +748,9 @@ OAuth и profile-команды:
 ```bash
 direct auth login
 direct auth login --profile agency1
+direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
+printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -740,6 +759,10 @@ direct --profile agency1 campaigns get
 
 Примечания:
 - OAuth profiles сохраняют refresh token и автоматически обновляют access token.
+- В non-interactive shell сначала выполните `direct auth login --profile NAME`, затем завершите через `direct auth login --code-stdin --profile NAME` и передайте browser code через stdin.
+- `direct auth login --code CODE --profile NAME` сохраняется для совместимости, но `--code-stdin` не раскрывает код в process arguments.
+- Если первый non-interactive шаг включает `--client-secret`, secret запоминается для последующего completion step.
+- Если profile уже хранит confidential OAuth client, `direct auth login --code CODE --profile NAME` использует сохраненные `client_id` и `client_secret`.
 - `direct auth login --oauth-token TOKEN` импортирует access token вручную и не включает auto-refresh.
 
 Порядок выбора credentials:
@@ -881,13 +904,8 @@ Allowed:
 direct dictionaries get-geo-regions --region-ids 225,187 --fields GeoRegionId,GeoRegionName
 ```
 
-Not allowed:
-
-```bash
-direct dictionaries get-geo-regions \
-  --region-ids 225,187 \
-  --fields GeoRegionId,GeoRegionName
-```
+Not allowed: splitting a canonical `direct ...` command over multiple shell
+lines with `\`.
 
 #### Flag Design Rules
 
@@ -913,12 +931,8 @@ Use:
 direct changes check-campaigns --timestamp 2026-04-14T00:00:00
 ```
 
-Do not use:
-
-```bash
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Do not use: a timestamp with a `Z` suffix, or a quoted timestamp that contains
+a space between the date and time.
 
 #### Documentation Contract
 
@@ -939,17 +953,9 @@ direct dynamicads set-bids --id 789 --bid 12500000
 direct dictionaries get-geo-regions --region-ids 225 --fields GeoRegionId,GeoRegionName
 ```
 
-Invalid examples:
-
-```bash
-direct dictionaries get-geo-regions --json '{"GeoRegionIds":[225]}' --fields GeoRegionId,GeoRegionName
-direct dynamicads set-bids --id 789 --bid 12500000 --json '{"StrategyPriority":"HIGH"}'
-direct dictionaries get-geo-regions \
-  --region-ids 225 \
-  --fields GeoRegionId,GeoRegionName
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Invalid examples include command lines that pass raw JSON flags, use shell
+line continuations, add timezone suffixes to CLI datetimes, or quote
+space-separated datetime values.
 
 #### Кампании
 
@@ -1061,8 +1067,8 @@ direct dynamicads set-bids --id 789 --bid 12500000 --context-bid 9000000 --prior
 
 # Общие стратегии ставок
 direct strategies get --limit 5
-direct strategies add --name "Общая стратегия" --type WbMaximumClicks --params '{"SpendLimit":1000000000,"AverageCpc":30000000}' --dry-run
-direct strategies update --id 42 --params '{"AverageCpc":35000000}' --dry-run
+direct strategies add --name "Общая стратегия" --type WbMaximumClicks --spend-limit 1000000000 --average-cpc 30000000 --dry-run
+direct strategies update --id 42 --type WbMaximumClicks --average-cpc 35000000 --dry-run
 direct strategies archive --id 42 --dry-run
 
 # Динамические таргеты по фиду
@@ -1206,6 +1212,11 @@ best-effort. Отчёт содержит одну строку на каждую
 Один и тот же OAuth-токен работает и для продакшена, и для sandbox; отдельный
 sandbox-токен не нужен.
 
+Для `v4account` sandbox smoke команда `enable-shared-account` использует
+`YANDEX_DIRECT_V4ACCOUNT_CLIENT_LOGIN` или fallback на `YANDEX_DIRECT_LOGIN`.
+Для `account-management` нужна переменная
+`YANDEX_DIRECT_V4ACCOUNT_ACCOUNT_ID`; без неё runner покажет `NOT_COVERED`.
+
 #### Перезапись write-кассет
 
 Уровень `integration_write` в pytest всё ещё воспроизводит сохранённый

{direct_cli-0.3.3 → direct_cli-0.3.5}/README.md

@@ -43,7 +43,9 @@ OAuth and profile commands:
 ```bash
 direct auth login
 direct auth login --profile agency1
+direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
+printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -56,6 +58,10 @@ Notes:
 - `--login` remains Direct client login.
 - Authorization is performed via `direct auth login`.
 - OAuth profiles store refresh tokens and refresh access tokens automatically.
+- In a non-interactive shell, run `direct auth login --profile NAME` first, then finish with `direct auth login --code-stdin --profile NAME` and pass the browser code on stdin.
+- `direct auth login --code CODE --profile NAME` remains supported for compatibility, but `--code-stdin` avoids exposing the code in process arguments.
+- If the first non-interactive step includes `--client-secret`, the secret is remembered for the matching completion step.
+- If a profile already stores a confidential OAuth client, `direct auth login --code CODE --profile NAME` reuses the saved `client_id` and `client_secret`.
 - `direct auth login --oauth-token TOKEN` is a manual access-token import and does not auto-refresh.
 - Alias `auth_login` is not supported.
 
@@ -116,6 +122,19 @@ direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:
 direct v4events get-events-log --from 2026-04-14T00:00:00 --to 2026-04-15T00:00:00 --currency RUB --limit 100 --offset 0 --format table
 ```
 
+### V4 Live Wordstat Reports
+
+Wordstat reports are asynchronous. Direct CLI makes exactly one API call per
+command and does not poll automatically; repeat `list-reports` or `get-report`
+yourself until the report is ready.
+
+```bash
+direct v4wordstat create-report --phrases "buy laptop,buy desktop" --geo-ids 213
+direct v4wordstat list-reports --format table
+direct v4wordstat get-report --report-id 123 --format table
+direct v4wordstat delete-report --report-id 123
+```
+
 ### V4 Live Finance
 
 Finance methods require an extra financial token for money operations. In the
@@ -126,13 +145,16 @@ per-request token from `--master-token`, `--operation-num`, and
 `--finance-login`; alternatively pass a precomputed token with `--finance-token`.
 Environment variables are
 `YANDEX_DIRECT_MASTER_TOKEN`, `YANDEX_DIRECT_FINANCE_LOGIN`,
-`YANDEX_DIRECT_FINANCE_TOKEN`, and `YANDEX_DIRECT_OPERATION_NUM`. Money mutation
-commands are dry-run-only in this release and always require `--dry-run`; dry-run
-output masks the financial token.
+`YANDEX_DIRECT_FINANCE_TOKEN`, and `YANDEX_DIRECT_OPERATION_NUM`.
+`transfer-money` and `pay-campaigns` are dry-run-only in this release and
+always require `--dry-run`; `create-invoice` can be sent live when `--dry-run`
+is omitted. Dry-run output masks the financial token.
 
 ```bash
+direct v4finance get-clients-units --logins client-login,other-client --format table
 direct v4finance get-credit-limits --logins client-login --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login
 direct v4finance get-credit-limits --logins client-login,other-client --format table
+direct v4finance create-invoice --payment 123=100.50 --payment 456=25 --currency RUB --master-token MASTER_TOKEN --operation-num 124 --finance-login agency-login --dry-run
 direct v4finance check-payment --custom-transaction-id A123456789012345678901234567890B
 direct v4finance transfer-money --from-campaign-id 123 --to-campaign-id 456 --amount 100.50 --currency RUB --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
 direct v4finance pay-campaigns --campaign-ids 123,456 --amount 100.50 --currency RUB --contract-id CONTRACT_ID --pay-method Bank --master-token MASTER_TOKEN --operation-num 123 --finance-login agency-login --dry-run
@@ -140,12 +162,15 @@ direct v4finance pay-campaigns --campaign-ids 123,456 --amount 100.50 --currency
 
 ### V4 Live Shared Account
 
-Shared-account mutations are dry-run-only in this release and always require
-`--dry-run`.
+Shared-account mutations require `--dry-run` in production and can be sent live
+only with top-level `--sandbox`. These commands follow the official v4 Live
+shared-account method shapes: `EnableSharedAccount` accepts one client `Login`,
+and `AccountManagement` updates shared-account settings through `Accounts`.
 
 ```bash
 direct v4account enable-shared-account --client-login client-login --dry-run
 direct v4account account-management --action Update --account-id 1327944 --day-budget 100.50 --spend-mode Default --money-in-sms Yes --money-out-sms No --email ops@example.com --money-warning-value 25 --dry-run
+direct --sandbox v4account enable-shared-account --client-login client-login
 ```
 
 ### CLI Convention
@@ -215,13 +240,8 @@ Allowed:
 direct dictionaries get-geo-regions --region-ids 225,187 --fields GeoRegionId,GeoRegionName
 ```
 
-Not allowed:
-
-```bash
-direct dictionaries get-geo-regions \
-  --region-ids 225,187 \
-  --fields GeoRegionId,GeoRegionName
-```
+Not allowed: splitting a canonical `direct ...` command over multiple shell
+lines with `\`.
 
 #### Flag Design Rules
 
@@ -247,12 +267,8 @@ Use:
 direct changes check-campaigns --timestamp 2026-04-14T00:00:00
 ```
 
-Do not use:
-
-```bash
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Do not use: a timestamp with a `Z` suffix, or a quoted timestamp that contains
+a space between the date and time.
 
 #### Documentation Contract
 
@@ -274,17 +290,9 @@ direct dynamicads set-bids --id 789 --bid 12500000 --context-bid 9000000 --prior
 direct dictionaries get-geo-regions --name Moscow --region-ids 225,187 --exact-names Москва,Санкт-Петербург --fields GeoRegionId,GeoRegionName
 ```
 
-Invalid examples:
-
-```bash
-direct dictionaries get-geo-regions --json '{"GeoRegionIds":[225]}' --fields GeoRegionId,GeoRegionName
-direct dynamicads set-bids --id 789 --bid 12500000 --json '{"StrategyPriority":"HIGH"}'
-direct dictionaries get-geo-regions \
-  --region-ids 225 \
-  --fields GeoRegionId,GeoRegionName
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Invalid examples include command lines that pass raw JSON flags, use shell
+line continuations, add timezone suffixes to CLI datetimes, or quote
+space-separated datetime values.
 
 #### Campaigns
 
@@ -396,8 +404,8 @@ direct dynamicads set-bids --id 789 --bid 12500000 --context-bid 9000000 --prior
 
 # Shared bidding strategies
 direct strategies get --limit 5
-direct strategies add --name "Shared Clicks" --type WbMaximumClicks --params '{"SpendLimit":1000000000,"AverageCpc":30000000}' --dry-run
-direct strategies update --id 42 --params '{"AverageCpc":35000000}' --dry-run
+direct strategies add --name "Shared Clicks" --type WbMaximumClicks --spend-limit 1000000000 --average-cpc 30000000 --dry-run
+direct strategies update --id 42 --type WbMaximumClicks --average-cpc 35000000 --dry-run
 direct strategies archive --id 42 --dry-run
 
 # Dynamic feed ad targets
@@ -572,6 +580,11 @@ The report contains one row per `WRITE_SANDBOX` command:
 The same OAuth token works for both production and the sandbox; no separate
 sandbox token is needed.
 
+For `v4account` sandbox smoke, `enable-shared-account` uses
+`YANDEX_DIRECT_V4ACCOUNT_CLIENT_LOGIN` or falls back to `YANDEX_DIRECT_LOGIN`.
+`account-management` requires `YANDEX_DIRECT_V4ACCOUNT_ACCOUNT_ID`; without it
+the runner reports `NOT_COVERED` for that command.
+
 #### Re-recording write cassettes
 
 The `integration_write` pytest tier still replays stored write-test traffic
@@ -692,7 +705,9 @@ OAuth и profile-команды:
 ```bash
 direct auth login
 direct auth login --profile agency1
+direct auth login --profile agency1 --format json
 direct auth login --code abc123 --profile agency1
+printf '%s\n' abc123 | direct auth login --code-stdin --profile agency1
 direct auth list
 direct auth use --profile agency1
 direct auth status --profile agency1
@@ -701,6 +716,10 @@ direct --profile agency1 campaigns get
 
 Примечания:
 - OAuth profiles сохраняют refresh token и автоматически обновляют access token.
+- В non-interactive shell сначала выполните `direct auth login --profile NAME`, затем завершите через `direct auth login --code-stdin --profile NAME` и передайте browser code через stdin.
+- `direct auth login --code CODE --profile NAME` сохраняется для совместимости, но `--code-stdin` не раскрывает код в process arguments.
+- Если первый non-interactive шаг включает `--client-secret`, secret запоминается для последующего completion step.
+- Если profile уже хранит confidential OAuth client, `direct auth login --code CODE --profile NAME` использует сохраненные `client_id` и `client_secret`.
 - `direct auth login --oauth-token TOKEN` импортирует access token вручную и не включает auto-refresh.
 
 Порядок выбора credentials:
@@ -842,13 +861,8 @@ Allowed:
 direct dictionaries get-geo-regions --region-ids 225,187 --fields GeoRegionId,GeoRegionName
 ```
 
-Not allowed:
-
-```bash
-direct dictionaries get-geo-regions \
-  --region-ids 225,187 \
-  --fields GeoRegionId,GeoRegionName
-```
+Not allowed: splitting a canonical `direct ...` command over multiple shell
+lines with `\`.
 
 #### Flag Design Rules
 
@@ -874,12 +888,8 @@ Use:
 direct changes check-campaigns --timestamp 2026-04-14T00:00:00
 ```
 
-Do not use:
-
-```bash
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Do not use: a timestamp with a `Z` suffix, or a quoted timestamp that contains
+a space between the date and time.
 
 #### Documentation Contract
 
@@ -900,17 +910,9 @@ direct dynamicads set-bids --id 789 --bid 12500000
 direct dictionaries get-geo-regions --region-ids 225 --fields GeoRegionId,GeoRegionName
 ```
 
-Invalid examples:
-
-```bash
-direct dictionaries get-geo-regions --json '{"GeoRegionIds":[225]}' --fields GeoRegionId,GeoRegionName
-direct dynamicads set-bids --id 789 --bid 12500000 --json '{"StrategyPriority":"HIGH"}'
-direct dictionaries get-geo-regions \
-  --region-ids 225 \
-  --fields GeoRegionId,GeoRegionName
-direct changes check-campaigns --timestamp 2026-04-14T00:00:00Z
-direct changes check-campaigns --timestamp "2026-04-14 00:00:00"
-```
+Invalid examples include command lines that pass raw JSON flags, use shell
+line continuations, add timezone suffixes to CLI datetimes, or quote
+space-separated datetime values.
 
 #### Кампании
 
@@ -1022,8 +1024,8 @@ direct dynamicads set-bids --id 789 --bid 12500000 --context-bid 9000000 --prior
 
 # Общие стратегии ставок
 direct strategies get --limit 5
-direct strategies add --name "Общая стратегия" --type WbMaximumClicks --params '{"SpendLimit":1000000000,"AverageCpc":30000000}' --dry-run
-direct strategies update --id 42 --params '{"AverageCpc":35000000}' --dry-run
+direct strategies add --name "Общая стратегия" --type WbMaximumClicks --spend-limit 1000000000 --average-cpc 30000000 --dry-run
+direct strategies update --id 42 --type WbMaximumClicks --average-cpc 35000000 --dry-run
 direct strategies archive --id 42 --dry-run
 
 # Динамические таргеты по фиду
@@ -1167,6 +1169,11 @@ best-effort. Отчёт содержит одну строку на каждую
 Один и тот же OAuth-токен работает и для продакшена, и для sandbox; отдельный
 sandbox-токен не нужен.
 
+Для `v4account` sandbox smoke команда `enable-shared-account` использует
+`YANDEX_DIRECT_V4ACCOUNT_CLIENT_LOGIN` или fallback на `YANDEX_DIRECT_LOGIN`.
+Для `account-management` нужна переменная
+`YANDEX_DIRECT_V4ACCOUNT_ACCOUNT_ID`; без неё runner покажет `NOT_COVERED`.
+
 #### Перезапись write-кассет
 
 Уровень `integration_write` в pytest всё ещё воспроизводит сохранённый