yandex-cli 0.1.0__tar.gz

yandex_cli-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+build/
+dist/
+wheels/
+
+# Virtual envs / tooling caches
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# Coverage
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+
+# AI-agent local files
+PROMPT.md
+.mcp.json
+
+# Secrets
+.env

yandex_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project are documented here.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] — 2026-06-27
+
+### Added
+- Initial release: Yandex 360 toolkit for **Tracker**, **Wiki**, and **Forms**.
+- Four surfaces from one codebase: Typer **CLI** (`ycli` / `yandex-cli`), FastMCP **server**
+  (`ycli mcp`, read-only, `[mcp]` extra), importable **Python SDK** (`ycli.yandex.*`), and a
+  **Claude Code plugin** (`plugins/yandex-360/`).
+- Published on PyPI as **`yandex-cli`** (`uv add yandex-cli`, or `yandex-cli[mcp]` for the server).
+- Test suite at 100% coverage with `responses`-stubbed HTTP.

yandex_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sava Znatnov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yandex_cli-0.1.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: yandex-cli
+Version: 0.1.0
+Summary: Interact with Yandex 360 services (Wiki, Tracker, Forms, …) from a CLI, an MCP server, or a Python SDK.
+Project-URL: Homepage, https://github.com/bim-ba/ycli
+Project-URL: Repository, https://github.com/bim-ba/ycli
+Project-URL: Issues, https://github.com/bim-ba/ycli/issues
+Project-URL: Changelog, https://github.com/bim-ba/ycli/blob/main/CHANGELOG.md
+Author-email: Sava Znatnov <careless.sava@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,fastmcp,forms,mcp,sdk,tracker,typer,wiki,yandex,yandex-360
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: requests>=2.34.2
+Requires-Dist: typer>=0.26.8
+Requires-Dist: uplink>=0.10.0
+Provides-Extra: mcp
+Requires-Dist: fastmcp>=3.4.2; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# ycli
+
+**One Yandex 360 toolkit — four ways to use it.**
+Drive **Tracker**, **Wiki**, and **Forms** from a CLI, an MCP server, a Python SDK,
+or a Claude Code plugin. Built for AI agents first — pleasant for humans too.
+
+[![CI](https://img.shields.io/github/actions/workflow/status/bim-ba/ycli/ci.yml?branch=main&style=for-the-badge)](https://github.com/bim-ba/ycli/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen?style=for-the-badge)](https://github.com/bim-ba/ycli)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-7c3aed?style=for-the-badge)](https://modelcontextprotocol.io/)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-d97757?style=for-the-badge)](plugins/yandex-360/)
+
+<img src="https://raw.githubusercontent.com/bim-ba/ycli/main/docs/assets/demo.gif" alt="ycli in action" width="760">
+
+</div>
+
+## Why ycli
+
+- 🧩 **One SDK, four surfaces** — write logic once, use it as a CLI, an MCP server, a Python
+  library, or a Claude Code plugin.
+- 🤖 **Agent-native** — the MCP server exposes read-only `tracker_*`, `wiki_*`, `forms_*`
+  tools so agents explore safely; writes stay in the CLI/SDK.
+- 🛡️ **Trustworthy** — typed pydantic models, the real Yandex API quirks handled for you,
+  and a test suite kept at **100% coverage**.
+- ⚡ **Zero-friction start** — `uv add yandex-cli`, two env vars, go.
+
+## Install
+
+```bash
+uv add yandex-cli            # CLI + Python SDK
+uv add 'yandex-cli[mcp]'     # …plus the MCP server (`ycli mcp`)
+```
+
+Run it without installing, or install it as a standalone tool:
+
+```bash
+uvx yandex-cli --help                 # one-off, no install
+uv tool install yandex-cli            # persistent CLI
+uv tool install 'yandex-cli[mcp]'     # …with the MCP server
+```
+
+`pip install yandex-cli` works too. The CLI ships as both `yandex-cli` and the short `ycli`.
+
+## Quick start
+
+Pick the surface that fits how you work.
+
+<details open>
+<summary><b>CLI</b></summary>
+
+```bash
+uv add yandex-cli
+ycli --help
+ycli tracker issues get TRACKER-1
+ycli wiki pages get onboarding
+```
+</details>
+
+<details>
+<summary><b>MCP server</b> (read-only)</summary>
+
+Run it over stdio (needs the `mcp` extra):
+
+```bash
+ycli mcp
+```
+
+Point an MCP client at it — no prior install needed via `uvx` (tools are namespaced
+`tracker_*`, `wiki_*`, `forms_*`):
+
+```json
+{
+  "mcpServers": {
+    "yandex": {
+      "command": "uvx",
+      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp"],
+      "env": {
+        "YANDEX_ID_OAUTH_TOKEN": "...",
+        "YANDEX_ID_ORGANIZATION_ID": "..."
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><b>Python SDK</b></summary>
+
+```python
+from ycli.yandex.tracker.client import TrackerClient
+
+tracker = TrackerClient.from_env()
+issue = tracker.issues.get("TRACKER-1")
+print(issue.summary)
+```
+</details>
+
+<details>
+<summary><b>Claude Code plugin</b></summary>
+
+```
+/plugin marketplace add bim-ba/ycli
+/plugin install yandex-360@ycli
+```
+
+Teaches an agent to drive Yandex 360 through `ycli` — including the real API quirks.
+See [`plugins/yandex-360/`](plugins/yandex-360/).
+</details>
+
+## Skills (Claude Code plugin)
+
+| Skill | Use for |
+|-------|---------|
+| `yandex-360` | Entry point — install + auth, pick a surface (CLI/MCP/SDK), route to a domain |
+| `yandex-360-tracker` | Issues, epics, comments, transitions, links, worklog, changelog |
+| `yandex-360-wiki` | Wiki pages, page tree, comments, attachments, YFM authoring |
+| `yandex-360-forms` | Forms, questions/schema, responses, pagination |
+
+The skills encode the read/write commands **and** the gnarly Yandex API quirks
+(epic-vs-parent, transition discovery, permanent wiki slugs, `fields=` rules, Forms
+host/header traps, answers pagination).
+
+## What's covered
+
+Reads ship across **SDK + CLI + MCP**; writes across **SDK + CLI** only (the MCP server is
+read-only by design).
+
+### Tracker
+
+| Resource | Operations | SDK | CLI | MCP |
+|----------|-----------|:---:|:---:|:---:|
+| issues | get · full · search · list · count | ✅ | ✅ | ✅ |
+| issues | create · update | ✅ | ✅ | — |
+| comments | list | ✅ | ✅ | ✅ |
+| comments | add | ✅ | ✅ | — |
+| links | list | ✅ | ✅ | ✅ |
+| links | add | ✅ | ✅ | — |
+| transitions | list | ✅ | ✅ | ✅ |
+| transitions | execute | ✅ | ✅ | — |
+| worklog · changelog · priorities · issuetypes · linktypes | list | ✅ | ✅ | ✅ |
+
+### Wiki
+
+| Resource | Operations | SDK | CLI | MCP |
+|----------|-----------|:---:|:---:|:---:|
+| pages | get · descendants | ✅ | ✅ | ✅ |
+| pages | meta (metadata-only) | — | — | ✅ |
+| pages | create · update | ✅ | ✅ | — |
+| comments | list | ✅ | ✅ | ✅ |
+| attachments | list | ✅ | ✅ | ✅ |
+
+### Forms (read-only today)
+
+| Resource | Operations | SDK | CLI | MCP |
+|----------|-----------|:---:|:---:|:---:|
+| me | get (whoami) | ✅ | ✅ | ✅ |
+| surveys | list · get | ✅ | ✅ | ✅ |
+| questions | list | ✅ | ✅ | ✅ |
+| answers | list (drains all pages) | ✅ | ✅ | ✅ |
+
+> **Mail and more — coming.** See [`docs/api-coverage.md`](docs/api-coverage.md) for the full
+> gap analysis and prioritized roadmap.
+
+## Configure
+
+```bash
+cp .env.example .env
+```
+
+```bash
+YANDEX_ID_OAUTH_TOKEN=...        # get one at https://oauth.yandex.ru/
+YANDEX_ID_ORGANIZATION_ID=...    # from the Yandex 360 admin panel
+```
+
+Header casing differs per service (Tracker `X-Org-ID`, Wiki/Forms `X-Org-Id`) — ycli
+handles it for you.
+
+## Project layout
+
+```text
+src/ycli/
+├── cli.py              # root Typer CLI  → `ycli` / `yandex-cli`
+├── mcp.py              # root FastMCP server → `ycli mcp` (read-only, `[mcp]` extra)
+├── log.py              # central loguru config
+└── yandex/
+    ├── tracker/        # per-domain SDK …
+    ├── wiki/           #   each resource group has:
+    └── forms/          #   client.py · cli.py · mcp.py · models.py
+plugins/yandex-360/     # distributable Claude Code plugin (skills + instructions)
+docs/references/        # vendored Yandex API reference docs
+```
+
+## Development
+
+```bash
+uv sync --all-extras   # --all-extras pulls in the `mcp` extra the tests exercise
+uv run pytest          # 100% coverage gate; HTTP stubbed with `responses` (no live network)
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for conventions. Contributions welcome — the
+[coverage roadmap](docs/api-coverage.md) is a good place to find a first issue.
+
+## License
+
+[MIT](LICENSE) © 2026 Sava Znatnov

yandex_cli-0.1.0/README.md

@@ -0,0 +1,209 @@
+<div align="center">
+
+# ycli
+
+**One Yandex 360 toolkit — four ways to use it.**
+Drive **Tracker**, **Wiki**, and **Forms** from a CLI, an MCP server, a Python SDK,
+or a Claude Code plugin. Built for AI agents first — pleasant for humans too.
+
+[![CI](https://img.shields.io/github/actions/workflow/status/bim-ba/ycli/ci.yml?branch=main&style=for-the-badge)](https://github.com/bim-ba/ycli/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen?style=for-the-badge)](https://github.com/bim-ba/ycli)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-7c3aed?style=for-the-badge)](https://modelcontextprotocol.io/)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-d97757?style=for-the-badge)](plugins/yandex-360/)
+
+<img src="https://raw.githubusercontent.com/bim-ba/ycli/main/docs/assets/demo.gif" alt="ycli in action" width="760">
+
+</div>
+
+## Why ycli
+
+- 🧩 **One SDK, four surfaces** — write logic once, use it as a CLI, an MCP server, a Python
+  library, or a Claude Code plugin.
+- 🤖 **Agent-native** — the MCP server exposes read-only `tracker_*`, `wiki_*`, `forms_*`
+  tools so agents explore safely; writes stay in the CLI/SDK.
+- 🛡️ **Trustworthy** — typed pydantic models, the real Yandex API quirks handled for you,
+  and a test suite kept at **100% coverage**.
+- ⚡ **Zero-friction start** — `uv add yandex-cli`, two env vars, go.
+
+## Install
+
+```bash
+uv add yandex-cli            # CLI + Python SDK
+uv add 'yandex-cli[mcp]'     # …plus the MCP server (`ycli mcp`)
+```
+
+Run it without installing, or install it as a standalone tool:
+
+```bash
+uvx yandex-cli --help                 # one-off, no install
+uv tool install yandex-cli            # persistent CLI
+uv tool install 'yandex-cli[mcp]'     # …with the MCP server
+```
+
+`pip install yandex-cli` works too. The CLI ships as both `yandex-cli` and the short `ycli`.
+
+## Quick start
+
+Pick the surface that fits how you work.
+
+<details open>
+<summary><b>CLI</b></summary>
+
+```bash
+uv add yandex-cli
+ycli --help
+ycli tracker issues get TRACKER-1
+ycli wiki pages get onboarding
+```
+</details>
+
+<details>
+<summary><b>MCP server</b> (read-only)</summary>
+
+Run it over stdio (needs the `mcp` extra):
+
+```bash
+ycli mcp
+```
+
+Point an MCP client at it — no prior install needed via `uvx` (tools are namespaced
+`tracker_*`, `wiki_*`, `forms_*`):
+
+```json
+{
+  "mcpServers": {
+    "yandex": {
+      "command": "uvx",
+      "args": ["--from", "yandex-cli[mcp]", "ycli", "mcp"],
+      "env": {
+        "YANDEX_ID_OAUTH_TOKEN": "...",
+        "YANDEX_ID_ORGANIZATION_ID": "..."
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><b>Python SDK</b></summary>
+
+```python
+from ycli.yandex.tracker.client import TrackerClient
+
+tracker = TrackerClient.from_env()
+issue = tracker.issues.get("TRACKER-1")
+print(issue.summary)
+```
+</details>
+
+<details>
+<summary><b>Claude Code plugin</b></summary>
+
+```
+/plugin marketplace add bim-ba/ycli
+/plugin install yandex-360@ycli
+```
+
+Teaches an agent to drive Yandex 360 through `ycli` — including the real API quirks.
+See [`plugins/yandex-360/`](plugins/yandex-360/).
+</details>
+
+## Skills (Claude Code plugin)
+
+| Skill | Use for |
+|-------|---------|
+| `yandex-360` | Entry point — install + auth, pick a surface (CLI/MCP/SDK), route to a domain |
+| `yandex-360-tracker` | Issues, epics, comments, transitions, links, worklog, changelog |
+| `yandex-360-wiki` | Wiki pages, page tree, comments, attachments, YFM authoring |
+| `yandex-360-forms` | Forms, questions/schema, responses, pagination |
+
+The skills encode the read/write commands **and** the gnarly Yandex API quirks
+(epic-vs-parent, transition discovery, permanent wiki slugs, `fields=` rules, Forms
+host/header traps, answers pagination).
+
+## What's covered
+
+Reads ship across **SDK + CLI + MCP**; writes across **SDK + CLI** only (the MCP server is
+read-only by design).
+
+### Tracker
+
+| Resource | Operations | SDK | CLI | MCP |
+|----------|-----------|:---:|:---:|:---:|
+| issues | get · full · search · list · count | ✅ | ✅ | ✅ |
+| issues | create · update | ✅ | ✅ | — |
+| comments | list | ✅ | ✅ | ✅ |
+| comments | add | ✅ | ✅ | — |
+| links | list | ✅ | ✅ | ✅ |
+| links | add | ✅ | ✅ | — |
+| transitions | list | ✅ | ✅ | ✅ |
+| transitions | execute | ✅ | ✅ | — |
+| worklog · changelog · priorities · issuetypes · linktypes | list | ✅ | ✅ | ✅ |
+
+### Wiki
+
+| Resource | Operations | SDK | CLI | MCP |
+|----------|-----------|:---:|:---:|:---:|
+| pages | get · descendants | ✅ | ✅ | ✅ |
+| pages | meta (metadata-only) | — | — | ✅ |
+| pages | create · update | ✅ | ✅ | — |
+| comments | list | ✅ | ✅ | ✅ |
+| attachments | list | ✅ | ✅ | ✅ |
+
+### Forms (read-only today)
+
+| Resource | Operations | SDK | CLI | MCP |
+|----------|-----------|:---:|:---:|:---:|
+| me | get (whoami) | ✅ | ✅ | ✅ |
+| surveys | list · get | ✅ | ✅ | ✅ |
+| questions | list | ✅ | ✅ | ✅ |
+| answers | list (drains all pages) | ✅ | ✅ | ✅ |
+
+> **Mail and more — coming.** See [`docs/api-coverage.md`](docs/api-coverage.md) for the full
+> gap analysis and prioritized roadmap.
+
+## Configure
+
+```bash
+cp .env.example .env
+```
+
+```bash
+YANDEX_ID_OAUTH_TOKEN=...        # get one at https://oauth.yandex.ru/
+YANDEX_ID_ORGANIZATION_ID=...    # from the Yandex 360 admin panel
+```
+
+Header casing differs per service (Tracker `X-Org-ID`, Wiki/Forms `X-Org-Id`) — ycli
+handles it for you.
+
+## Project layout
+
+```text
+src/ycli/
+├── cli.py              # root Typer CLI  → `ycli` / `yandex-cli`
+├── mcp.py              # root FastMCP server → `ycli mcp` (read-only, `[mcp]` extra)
+├── log.py              # central loguru config
+└── yandex/
+    ├── tracker/        # per-domain SDK …
+    ├── wiki/           #   each resource group has:
+    └── forms/          #   client.py · cli.py · mcp.py · models.py
+plugins/yandex-360/     # distributable Claude Code plugin (skills + instructions)
+docs/references/        # vendored Yandex API reference docs
+```
+
+## Development
+
+```bash
+uv sync --all-extras   # --all-extras pulls in the `mcp` extra the tests exercise
+uv run pytest          # 100% coverage gate; HTTP stubbed with `responses` (no live network)
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for conventions. Contributions welcome — the
+[coverage roadmap](docs/api-coverage.md) is a good place to find a first issue.
+
+## License
+
+[MIT](LICENSE) © 2026 Sava Znatnov

yandex_cli-0.1.0/pyproject.toml

@@ -0,0 +1,91 @@
+[project]
+name = "yandex-cli"
+version = "0.1.0"
+description = "Interact with Yandex 360 services (Wiki, Tracker, Forms, …) from a CLI, an MCP server, or a Python SDK."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+authors = [{ name = "Sava Znatnov", email = "careless.sava@gmail.com" }]
+keywords = ["yandex", "yandex-360", "tracker", "wiki", "forms", "cli", "mcp", "sdk", "fastmcp", "typer"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "loguru>=0.7.3",
+    "pydantic>=2.13.4",
+    "requests>=2.34.2",
+    "typer>=0.26.8",
+    "uplink>=0.10.0",
+]
+
+# The MCP server (`ycli mcp`) is optional — install with `yandex-cli[mcp]`.
+[project.optional-dependencies]
+mcp = ["fastmcp>=3.4.2"]
+
+[project.scripts]
+yandex-cli = "ycli.cli:main"
+ycli = "ycli.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/bim-ba/ycli"
+Repository = "https://github.com/bim-ba/ycli"
+Issues = "https://github.com/bim-ba/ycli/issues"
+Changelog = "https://github.com/bim-ba/ycli/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ycli"]
+
+# Keep the sdist lean: ship only the package + changelog (pyproject, README, and
+# LICENSE are always included from metadata) — not the repo's docs, tests, Claude
+# plugin, agent config, or vendored API references.
+[tool.hatch.build.targets.sdist]
+only-include = ["src/ycli", "CHANGELOG.md"]
+
+# TestPyPI as an explicit publish target (used by `uv publish --index testpypi`).
+# `explicit = true` keeps it out of normal dependency resolution.
+[[tool.uv.index]]
+name = "testpypi"
+url = "https://test.pypi.org/simple/"
+publish-url = "https://test.pypi.org/legacy/"
+explicit = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = "--cov=ycli --cov-report=term-missing --cov-fail-under=100"
+markers = [
+    "integration: tests that exercise CLI/MCP wiring end-to-end (no live network)",
+]
+
+[tool.coverage.run]
+source = ["ycli"]
+
+[tool.coverage.report]
+show_missing = true
+exclude_also = [
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+    "\\.\\.\\.",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=7.1.0",
+    "responses>=0.26.1",
+]

yandex_cli-0.1.0/src/ycli/__init__.py

@@ -0,0 +1,13 @@
+"""ycli — interact with Yandex 360 services (Wiki, Tracker, Forms, …).
+
+One codebase, many surfaces: a Typer CLI (``ycli``), a FastMCP server (``ycli mcp``),
+and an importable Python SDK under ``ycli.yandex``. Distributed on PyPI as ``yandex-cli``.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import version
+
+# Single source of truth: the version declared in pyproject.toml (read from installed
+# metadata under the distribution name `yandex-cli`).
+__version__ = version("yandex-cli")

yandex_cli-0.1.0/src/ycli/cli.py

@@ -0,0 +1,58 @@
+"""``ycli`` root CLI — mounts each domain's sub-app. Domain logic lives in <domain>/cli.py.
+
+Run a subcommand directly: ``uv run ycli wiki pages get <slug>`` (or ``python -m ycli.cli``).
+"""
+
+from __future__ import annotations
+
+import typer
+
+from ycli.log import configure
+from ycli.yandex.forms.cli import app as forms_app
+from ycli.yandex.tracker.cli import app as tracker_app
+from ycli.yandex.wiki.cli import app as wiki_app
+
+app = typer.Typer(
+    name="ycli",
+    help="ycli — Yandex 360 API SDK CLI.",
+    no_args_is_help=True,
+    pretty_exceptions_show_locals=False,
+    add_completion=False,
+)
+
+
+@app.callback()
+def _main() -> None:
+    """Configure logging once before any subcommand runs."""
+    configure()
+
+
+app.add_typer(wiki_app)
+app.add_typer(tracker_app)
+app.add_typer(forms_app)
+
+
+@app.command(name="mcp")
+def mcp() -> None:
+    """Run the read-only MCP server over stdio (requires the ``mcp`` extra).
+
+    Tools are namespaced ``wiki_*``, ``tracker_*``, ``forms_*``. Point an MCP client
+    at ``ycli mcp``.
+    """
+    try:
+        from ycli.mcp import main as run_server
+    except ModuleNotFoundError as exc:  # pragma: no cover - only without the 'mcp' extra
+        raise typer.BadParameter(
+            "The MCP server requires the 'mcp' extra. Install it with: "
+            "uv add 'yandex-cli[mcp]'  (or: uv tool install 'yandex-cli[mcp]')."
+        ) from exc
+    run_server()
+
+
+def main() -> None:  # pragma: no cover
+    """Console-script entry point (``ycli`` / ``yandex-cli``)."""
+    app()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()