yandex-cli 0.1.0__py3-none-any.whl

yandex_cli-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,115 @@
+ycli/__init__.py,sha256=9AKPqZVknGZpy0-62HszaqsaCNCervq6OSoW35Kr5do,510
+ycli/cli.py,sha256=tdslQlHGXXJexMjIHCE83MiPADUHjukCsKJrLTbNDGA,1588
+ycli/log.py,sha256=C15uskRhYI6hJeV1sBKWPVuwcCzznOLxBhj_ZhFVWwY,823
+ycli/mcp.py,sha256=STQpwzqpWj7dNyKKv3Bpm2YqOCgIo0xAfnL4_ZXslTo,942
+ycli/yandex/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ycli/yandex/base.py,sha256=-n3QptRL3qXiiV9RMug91c82Vov1dFB6NTFrOSPdSBs,2672
+ycli/yandex/transport.py,sha256=LQVznvfAfVpTK6uGf_xXnOBMCLWtebqEUJIpIp2m-UY,4233
+ycli/yandex/forms/__init__.py,sha256=3H1-e98MG9NcDuVfLlaU0STglMk_XpGRv6hqWR_Tgb4,97
+ycli/yandex/forms/_base.py,sha256=tWs278TeEMarqFLqw52jEvaYEmwQuu7UHj4TakqxiOQ,652
+ycli/yandex/forms/_clideps.py,sha256=b-l0S_rxmFGqgwQvc7RfKIPvaJ74LGs8RV8pX70uveY,593
+ycli/yandex/forms/_deps.py,sha256=cu2SSzp94-QqY0VBRNmuW4EU1YbVegtgvF3eQa5clKQ,380
+ycli/yandex/forms/_models.py,sha256=VaMPJBTx6v6C3rUjdzuybtb-60E1lmyCoI8-l-Q-UFM,550
+ycli/yandex/forms/cli.py,sha256=iD-_dDcLp05LGwkdJsJHKy-MFnrHF9eghEoFOQA_rz4,567
+ycli/yandex/forms/client.py,sha256=Q50OgsYPh6ZxxC6yYu1YNNgNid2icL9Wc5OIq1ILlD8,1053
+ycli/yandex/forms/mcp.py,sha256=EZsZ_pyxUBAHTfaOIwyyu8X9TcEr0W9V6K1AwiO3Bs0,465
+ycli/yandex/forms/answers/__init__.py,sha256=dNqjHD3dY1I1J5RxxtRYF2PpBjWHsQSdXwBdNmWb0G8,52
+ycli/yandex/forms/answers/cli.py,sha256=XHXVa-kY2ffx3GnWihHSFh8MTPfW5P0DIw4aCc8_sGQ,757
+ycli/yandex/forms/answers/client.py,sha256=KTIN2TFy8TuSctoL0eM1yrJFkwonqwjpEdtiP18x0g0,2426
+ycli/yandex/forms/answers/mcp.py,sha256=nuk7NtE98N2IpGw_8tlCEBxlsktMGjS73_UqsBWjEBs,592
+ycli/yandex/forms/answers/models.py,sha256=JPnoJk57NgJs2pKZvbnVTpmJ_m-xvAFk5iOFIo385Ys,1522
+ycli/yandex/forms/me/__init__.py,sha256=_TMNel8tYOoQat4LN3wf5M6LY106HuWOREM1SCL9iWY,40
+ycli/yandex/forms/me/cli.py,sha256=Onhp_QeKJlULn9UkEhobC8hWxxwOM0dqR4hovJtmJXY,534
+ycli/yandex/forms/me/client.py,sha256=hqOn7L3RLYGc95tWaY5HME6j1JBdUU8wmCLTO-YWFTI,767
+ycli/yandex/forms/me/mcp.py,sha256=bO2hC6XNBeqO1luALzFJyC3XnI7cgW70KJdWqcSmOD4,847
+ycli/yandex/forms/me/models.py,sha256=hH7N1RPuNTyycFXDtmbqOuddSk74p0VM4jx0oaIKOX4,479
+ycli/yandex/forms/questions/__init__.py,sha256=6aCxCxcJ_tQU6htwLjiiPySePzLi0Rhb86j7nOmNUls,54
+ycli/yandex/forms/questions/cli.py,sha256=b2pIMepNYH3IRU3c_L0PpN9heSCriLnODs8os60kkVo,737
+ycli/yandex/forms/questions/client.py,sha256=xlxFll9DWUsRVn66KIipExR0QQ7uoBv8BHVefo9FMk4,903
+ycli/yandex/forms/questions/mcp.py,sha256=aswfFs0k9nr5bg_Jz4D4j57LsBRK1QYbxYCfl03rF_0,598
+ycli/yandex/forms/questions/models.py,sha256=20VF_sbo3jKJC_DZ66YXWBHJLpWCKCUFpOdBU8noBtA,1261
+ycli/yandex/forms/surveys/__init__.py,sha256=sCdpP8bV3NmceWZu9E6lV9CBJY83wIifywUVNN5Nz58,39
+ycli/yandex/forms/surveys/cli.py,sha256=Oc0nHrcV44HBpZbiK8mH2P_QNZfQx5hNe9Cmlxa2O4I,771
+ycli/yandex/forms/surveys/client.py,sha256=0m-NKj7s0sBT_ad86lG566FuGaKGGsWHXpm3AwSV8PU,1267
+ycli/yandex/forms/surveys/mcp.py,sha256=wTlUGu3KjI8bc-mjKYSm0XOSUBmq-LRtR2mi3dWfsyo,1105
+ycli/yandex/forms/surveys/models.py,sha256=W4f11gTy90mMQ1DUBBCb3yuFrOnzLrbIXbfmQJ8uFgE,1245
+ycli/yandex/tracker/__init__.py,sha256=KoKKmC2z4XdviENgX-8tuswWrj1mwTYptPbB5q-Dcnc,87
+ycli/yandex/tracker/_base.py,sha256=JCm6wLjlbxr8KmbLbYFg1wLM4uF2axTyuT-9_pLyTrY,520
+ycli/yandex/tracker/_clideps.py,sha256=6JQgnOxBbIsWJrTpEvfEunYJGTZ_NqQJp9tV4h3ORGU,1502
+ycli/yandex/tracker/_deps.py,sha256=jPJoguPcyUWiHbUWdFSkNKgXDmQqKdb0aTm9INePLAE,400
+ycli/yandex/tracker/_models.py,sha256=nFv1mnHkiwQD8Otp4qd33hETdQUdaiBqVuZmaMyGb74,1249
+ycli/yandex/tracker/cli.py,sha256=c4C-hiecZK1gV-oaWAuygWOSf1B-cCGV3bKjBTqxKR4,1082
+ycli/yandex/tracker/client.py,sha256=EndiXpxwxQM8BCHrwZuSgcSLtr0nFaYnJtVNgmFWNwQ,1731
+ycli/yandex/tracker/mcp.py,sha256=52C8SRrRd_v9YVLKmgkwdDfnjOJpuu_mSM-4w-AlR7U,952
+ycli/yandex/tracker/changelog/__init__.py,sha256=y7D6KKt27ipqIQBG04bMLsvFLb0MyX5Scz_3Kk7CqQY,56
+ycli/yandex/tracker/changelog/cli.py,sha256=K1b7m6AdDTtCUi-NFdFWLblNfxXOXX6pMtZ1aWI9qgk,725
+ycli/yandex/tracker/changelog/client.py,sha256=BofpYqh8_42mRu4T-8az8o08u4jOUimOuGndH8rywcg,1014
+ycli/yandex/tracker/changelog/mcp.py,sha256=LZIhSsp5TZ8VKYa6rWf00mN-iBiYw0vbxDxKPdRELW8,584
+ycli/yandex/tracker/changelog/models.py,sha256=gtFnDJIIRqzwc7qZyY1tHqz8HnpkfShzVaKT9QWG9sA,1763
+ycli/yandex/tracker/comments/__init__.py,sha256=aG_cyIWMy3k34S0q8CBnX9LSoFe8D9NMhazhxU1wZRE,55
+ycli/yandex/tracker/comments/cli.py,sha256=RtxoMpK5to39lSUmxzg3F-Z8Q_gDPpVH0T086jYWJt4,848
+ycli/yandex/tracker/comments/client.py,sha256=jRTKygQEL7TSgptNN8YO6aJs2zIqYiVUsg-p3hLf5fg,1384
+ycli/yandex/tracker/comments/mcp.py,sha256=b7T_dMlflOxCk4MilYjYbA7fosB5ROPeT3pZWc23MiY,563
+ycli/yandex/tracker/comments/models.py,sha256=_EZ8YjyR8KMa9H4SLlGw8HfNC61pCZv0GcCgilEx2GU,1010
+ycli/yandex/tracker/issues/__init__.py,sha256=b6X_MBfw3hgUxvbSbwEJQeo4PGz-6CFQfMWZu9F72G4,40
+ycli/yandex/tracker/issues/cli.py,sha256=a5IPdVcru0Rznz58ok5OAfspT7vrV7hfFMRtIFYJlI0,5176
+ycli/yandex/tracker/issues/client.py,sha256=fJ_DHtTaFvdqkqO28JzTcDSENOQUVXzde4XtreaCcsY,3519
+ycli/yandex/tracker/issues/mcp.py,sha256=N3-9K078yuW8qhI-rmjOekILQqSa09noghBTSjh9WHs,2051
+ycli/yandex/tracker/issues/models.py,sha256=SUuYDPrCjIm-bbgiqRItdbiEc-M085WFobDlvDSxs7k,2190
+ycli/yandex/tracker/issuetypes/__init__.py,sha256=z33PeF-LM5Uj8FLOyUgVx8mTS08IqjMol6E8JeTjVNI,44
+ycli/yandex/tracker/issuetypes/cli.py,sha256=5P-QSBPSIWncKkz-si_k3vu-89yVjKP2sXtT-jpBnHU,480
+ycli/yandex/tracker/issuetypes/client.py,sha256=SSq4TwVNrv_20YiuIPurMlBTnMuOJmojpUt-ZIftoy8,773
+ycli/yandex/tracker/issuetypes/mcp.py,sha256=ekGcf2mX87XDZHze67NG7X8nbmab4inl4I7DRb-5MGs,576
+ycli/yandex/tracker/issuetypes/models.py,sha256=_8jGU_4tPLqBNLLIoeHwXlhfBLY_s6z60Q1ySPu4hD8,649
+ycli/yandex/tracker/links/__init__.py,sha256=0KN1uWLFmXXA7ITTYVZdPQhWMU7wcRsCBe6WS84Zbpk,52
+ycli/yandex/tracker/links/cli.py,sha256=TBz07drv1NG_1HpBWbBTcvOi-rcEQMCJpqhb3st6vbw,1325
+ycli/yandex/tracker/links/client.py,sha256=tnGsLZ2JvbtsPyJsjblSCGsmaob1rWc3F3r2-s2LdcU,1396
+ycli/yandex/tracker/links/mcp.py,sha256=YQgpeVmkO5EEtWGbK5crP6O_Qoqj2NVg1Df8ORiYkUM,572
+ycli/yandex/tracker/links/models.py,sha256=NuXj1mlFbceZDm28cc2N254kG53OOKsRZ3Z7M6HbtJ4,1516
+ycli/yandex/tracker/linktypes/__init__.py,sha256=a2HGuqI-f9_6cKYsFeb_c37ramvnK4OhthnaRLBekNE,43
+ycli/yandex/tracker/linktypes/cli.py,sha256=Wsc3nv1-f9El_r70cFIRXC2CCPyNseVRN5lfxIqHQdI,474
+ycli/yandex/tracker/linktypes/client.py,sha256=TplWV3T1jiY8BUQY9pb8Ldq4kE4ial2kxGqtCrZN8u8,766
+ycli/yandex/tracker/linktypes/mcp.py,sha256=vl7ajmWZE1qPhetAxXBq3sG2pc8G9NjsJRGKfCTft0c,580
+ycli/yandex/tracker/linktypes/models.py,sha256=85e1O2RVrr3qiO-VPvevHiZFT2bA4-SMgFiO0TJ85ss,688
+ycli/yandex/tracker/priorities/__init__.py,sha256=fXwqCURcaJklbW3vsnVQjSVUJSMyBrrbjY5rt2k22X4,44
+ycli/yandex/tracker/priorities/cli.py,sha256=93fw5KVuoIb98q42lIzZtXBx7wNY2ZpJsfWzzOOFNwc,477
+ycli/yandex/tracker/priorities/client.py,sha256=QvA1BQOsNhPWz5HA-HcX7yvPHAL16YQjJlqnbQnQQ2U,771
+ycli/yandex/tracker/priorities/mcp.py,sha256=Lg6s4wSC0YBKqn5c33-TV7R4oIh9vG_VH0M8Epksls8,575
+ycli/yandex/tracker/priorities/models.py,sha256=gJnTHKCDkSI2qPPBMdTSpXujfBcQVtlE-PVRW7eW4gU,648
+ycli/yandex/tracker/transitions/__init__.py,sha256=xkcIidfS5M4Ee_7lGhb8pOp09pVIwPJRZlWo0RbIK-c,58
+ycli/yandex/tracker/transitions/cli.py,sha256=TM9jAqsfD5rWYebqYq804fV7gPdANkEaorpB7ctQ7ms,1164
+ycli/yandex/tracker/transitions/client.py,sha256=4PJZ-In_oqaQVu52-RIgTcm_KhOQfmii-pgaMwZnd8E,2276
+ycli/yandex/tracker/transitions/mcp.py,sha256=mB-sB9sLJdubHknNgTsbWjlM2qVIazsBTmqG2k1SUTA,603
+ycli/yandex/tracker/transitions/models.py,sha256=bOeOgUg1xBaCNmh0goAydqBH-ZgvnC9hDPOB1jblonc,683
+ycli/yandex/tracker/worklog/__init__.py,sha256=xqxT7vujOEX74DU6FY5g8U8pj_6dbkDKl2WSOTFaztA,54
+ycli/yandex/tracker/worklog/cli.py,sha256=NTwZHEgLRdrH5joExsLZEpGVQrtR0ax59IXaug4e0_o,593
+ycli/yandex/tracker/worklog/client.py,sha256=YzKzMx0PS8VyJ3MHLAlMzD8GL91rH9gRJMireRhT020,830
+ycli/yandex/tracker/worklog/mcp.py,sha256=6nx_hr55ocEo3hnecFwo0qFWwlqpE4tgs5c4WFjVo08,573
+ycli/yandex/tracker/worklog/models.py,sha256=a1RAwAo6u9XTIhXHS3TyJ7_e2QdUPeEo0sykMhsn6Ws,1088
+ycli/yandex/wiki/__init__.py,sha256=uKh1kboi42K9VPB2yZbGIwB6Hq9AL3r1-HU-ppoRzJk,94
+ycli/yandex/wiki/_base.py,sha256=L0DeYDZt7xqhcx6nlSzs_1uDcIp2H1LVyDC0ijclj1g,252
+ycli/yandex/wiki/_clideps.py,sha256=B_hSr5ShMoh79nUjwHJNV6jrqcdVX0jowByacF0yRn8,648
+ycli/yandex/wiki/_deps.py,sha256=cC1CGAAgeyUGYPgMH4ToPQYAlcUTaWGxyurZ7UC2Kec,370
+ycli/yandex/wiki/cli.py,sha256=dBzttiXZVFfriK3EgHDCY1uCZhI2BT7S-Xuqmz4SAO4,490
+ycli/yandex/wiki/client.py,sha256=TJMle-VPZ9mppFFoSx5J1OggrhG-fQc76jax_soc3xk,971
+ycli/yandex/wiki/mcp.py,sha256=r3YsbDXJiYiku_M745LM35SX7HhpRctNAGU3e2v_G74,381
+ycli/yandex/wiki/attachments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ycli/yandex/wiki/attachments/cli.py,sha256=szl5jw3hdfiECUk4rhrGYYmZn9cp6h2-0_2JEAppecw,599
+ycli/yandex/wiki/attachments/client.py,sha256=c3P60xhC9CxuvE8Wysl4r-YGQ_xK29LthBdtNYcGinQ,990
+ycli/yandex/wiki/attachments/mcp.py,sha256=epzNdbc9mroMB7NG8O4guH8kKMPEikANZ4C9-JDh2dI,569
+ycli/yandex/wiki/attachments/models.py,sha256=TEd88ADuaNPNX-4o43JTcDak6T4K7ID2h7mIt_vNEyY,872
+ycli/yandex/wiki/comments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ycli/yandex/wiki/comments/cli.py,sha256=JmPPb7aye9JyizsDG9x85XavuXZBE9ShqHZpIAQMRHA,581
+ycli/yandex/wiki/comments/client.py,sha256=drLrjU0dQyZ5ZRCKvtjFmfFFDQJbhZL925VdTif4AfE,982
+ycli/yandex/wiki/comments/mcp.py,sha256=rckwlf2wo4ZltZ2VykGRMvLOcOn6iiELyJq8jB1AFjw,545
+ycli/yandex/wiki/comments/models.py,sha256=iAcBh20KhHV5pUPBsdOtfKVZmLcRuc5zM-wtNdR7pTc,1046
+ycli/yandex/wiki/pages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ycli/yandex/wiki/pages/cli.py,sha256=2q_HdtyEyElcBfcoYtdSLLtqckKxUg05ol9ccU9OucE,2329
+ycli/yandex/wiki/pages/client.py,sha256=VeL3w3NwqGUZuDY7hNZTYyFeILd1NpCBW8GTcnBC_uc,2858
+ycli/yandex/wiki/pages/mcp.py,sha256=K27u4tTDJ9L0-ZnTViiHWKkp5xvY8voS1wANumznnNk,1241
+ycli/yandex/wiki/pages/models.py,sha256=d4oW4M1efuCOUsUkhP0W7cwXYhsQGTWS_FS1I0LisOY,2270
+yandex_cli-0.1.0.dist-info/METADATA,sha256=_fB2wMJyWwOg0JkPIa8ElzaHU17x4nNChjY-sLVqAzg,8056
+yandex_cli-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+yandex_cli-0.1.0.dist-info/entry_points.txt,sha256=dHDIa0h--BaZ4vEOsj6cO0XRrwXK2op7WrFXswOnpTU,66
+yandex_cli-0.1.0.dist-info/licenses/LICENSE,sha256=MO2MsGmmpbkFPOptoyGxPnyKE8ZiBdHTbt35RCxx1Zg,1069
+yandex_cli-0.1.0.dist-info/RECORD,,

yandex_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

yandex_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+yandex-cli = ycli.cli:main
+ycli = ycli.cli:main

yandex_cli-0.1.0.dist-info/licenses/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.

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")

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()

ycli/log.py

@@ -0,0 +1,27 @@
+"""Central loguru configuration — one sink to stderr, idempotent.
+
+``configure()`` always removes existing sinks and installs exactly one stderr sink,
+so calling it more than once never stacks duplicate output and always rebinds to the
+current ``sys.stderr`` (important under pytest's ``capsys``). stdout stays clean for
+machine-readable command output.
+
+Example:
+    >>> from ycli.log import configure
+    >>> configure()  # doctest: +SKIP
+"""
+
+from __future__ import annotations
+
+import sys
+
+from loguru import logger
+
+
+def configure(level: str = "INFO") -> None:
+    """Install a single stderr sink at ``level`` (idempotent — safe to call repeatedly).
+
+    Example:
+        >>> configure("DEBUG")  # doctest: +SKIP
+    """
+    logger.remove()
+    logger.add(sys.stderr, level=level, backtrace=False, diagnose=False)

ycli/mcp.py

@@ -0,0 +1,31 @@
+"""Root Yandex 360 FastMCP server — mounts the per-domain subservers.
+
+Run over stdio for LLM-agent clients: ``ycli mcp`` (or ``python -m ycli.mcp``).
+Tools are namespaced per domain: ``wiki_*``, ``tracker_*``, ``forms_*``. Reads-only.
+"""
+
+from fastmcp import FastMCP
+
+from ycli.log import configure
+from ycli.yandex.forms.mcp import mcp as forms_mcp
+from ycli.yandex.tracker.mcp import mcp as tracker_mcp
+from ycli.yandex.wiki.mcp import mcp as wiki_mcp
+
+mcp = FastMCP("yandex")
+mcp.mount(wiki_mcp, namespace="wiki")
+mcp.mount(tracker_mcp, namespace="tracker")
+mcp.mount(forms_mcp, namespace="forms")
+
+
+def main() -> None:  # pragma: no cover
+    """Run the root server over stdio (the console-script entry point).
+
+    Example:
+        >>> main()  # doctest: +SKIP
+    """
+    configure()  # match the CLI: single stderr sink, stdout stays clean for the protocol
+    mcp.run()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

ycli/yandex/base.py

@@ -0,0 +1,67 @@
+"""Shared base for every Yandex resource client (uplink.Consumer).
+
+Holds the two things every resource repeats: a required-``session`` constructor (DI —
+the client takes a configured ``requests.Session``, never reaches into the env) and a
+``from_env()`` classmethod. The per-API base URL is a ``base_url`` ClassVar set by a
+per-domain base (e.g. ``WikiResource``); resource clients inherit it.
+
+uplink's ``ConsumerMeta`` collects decorated request methods from the leaf subclass, so
+an intermediate base with no decorated methods is fine.
+
+NOTE: no ``from __future__ import annotations`` — uplink reads method annotations eagerly.
+
+Example:
+    >>> from ycli.yandex.wiki.pages.client import PagesClient
+    >>> PagesClient.from_env()  # doctest: +SKIP
+"""
+
+import os
+from typing import ClassVar, Self
+
+import requests
+import uplink
+
+from ycli.yandex.transport import Transport
+
+
+def session_from_env() -> requests.Session:
+    """Build an authed session from ``$YANDEX_ID_OAUTH_TOKEN`` / ``$YANDEX_ID_ORGANIZATION_ID``.
+
+    Raises ``ValueError`` (naming the missing variable) when either is absent/empty.
+    Credential resolution lives here, NOT in ``Transport`` (which stays env-free).
+
+    Example:
+        >>> session_from_env()  # doctest: +SKIP
+    """
+    token = os.environ.get("YANDEX_ID_OAUTH_TOKEN", "")
+    org_id = os.environ.get("YANDEX_ID_ORGANIZATION_ID", "")
+    if not token:
+        raise ValueError("YANDEX_ID_OAUTH_TOKEN is empty — set it in the environment")
+    if not org_id:
+        raise ValueError("YANDEX_ID_ORGANIZATION_ID is empty — set it in the environment")
+    return Transport.session(token=token, org_id=org_id)
+
+
+class BaseYandex(uplink.Consumer):
+    """Required-``session`` DI + ``from_env`` env resolution + ``base_url`` classvar."""
+
+    base_url: ClassVar[str]
+
+    def __init__(self, *, session: requests.Session) -> None:
+        # uplink joins paths with urljoin; a base without a trailing slash drops the
+        # last segment (".../v1" + "pages" -> ".../pages"). Normalize so a base_url
+        # with no trailing slash is safe.
+        base = self.base_url.rstrip("/") + "/"
+        # Retain the raw requests.Session before super().__init__ wraps it — uplink's
+        # own ``self.session`` is a wrapper that does not expose the injected headers.
+        self._session: requests.Session = session
+        super().__init__(base_url=base, client=session)
+
+    @classmethod
+    def from_env(cls) -> Self:
+        """Build a client from ``$YANDEX_ID_*`` (raises on a missing var).
+
+        Example:
+            >>> BaseYandex.from_env()  # doctest: +SKIP
+        """
+        return cls(session=session_from_env())

ycli/yandex/forms/__init__.py

@@ -0,0 +1 @@
+"""Yandex Forms domain — per-resource clients (me/surveys/questions/answers), CLI, and MCP."""

ycli/yandex/forms/_base.py

@@ -0,0 +1,17 @@
+"""Per-domain base — carries the Forms API base_url; resource clients inherit it.
+
+Forms lives on its OWN host (``api.forms.yandex.net``), distinct from Tracker/Wiki —
+this base is the single place that fact is encoded.
+
+NOTE: no ``from __future__ import annotations`` — resource clients subclass this and
+uplink reads their method annotations eagerly. Keep this module annotation-eager too.
+"""
+from typing import ClassVar
+
+from ycli.yandex.base import BaseYandex
+
+
+class FormsResource(BaseYandex):
+    """Base for every Forms resource client (inherits session DI + from_env)."""
+
+    base_url: ClassVar[str] = "https://api.forms.yandex.net/v1"

ycli/yandex/forms/_clideps.py

@@ -0,0 +1,20 @@
+"""Lazy Typer DI for the forms CLI."""
+from __future__ import annotations
+
+import typer
+
+from ycli.yandex.forms.client import FormsClient
+
+
+def forms_client(ctx: typer.Context) -> FormsClient:
+    """Return the request-scoped FormsClient, building it from env on first access.
+
+    Lazy so ``--help`` (which never runs a command body) needs no creds; cached on
+    ``ctx.obj`` so multiple accesses within one invocation share the session.
+
+    Example:
+        >>> forms_client(ctx)  # doctest: +SKIP
+    """
+    if ctx.obj is None:
+        ctx.obj = FormsClient.from_env()
+    return ctx.obj

ycli/yandex/forms/_deps.py

@@ -0,0 +1,10 @@
+"""FastMCP dependency provider for the forms subserver — builds a FormsClient per call."""
+from ycli.yandex.forms.client import FormsClient
+
+RO: dict[str, bool] = {"readOnlyHint": True}
+TAGS: set[str] = {"forms"}
+
+
+def forms_client() -> FormsClient:
+    """Provide an env-built FormsClient to forms MCP tools (FastMCP caches within a call)."""
+    return FormsClient.from_env()

ycli/yandex/forms/_models.py

@@ -0,0 +1,18 @@
+"""Shared pydantic base for Forms resources — lenient model config.
+
+``_Lenient`` ignores extra fields (the API returns more than we project) and accepts
+population by name OR alias.
+
+Example:
+    >>> _Lenient.model_validate({"unknown": 1}).model_config["extra"]
+    'ignore'
+"""
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict
+
+
+class _Lenient(BaseModel):
+    """Base model: extra fields silently ignored, population by name OR alias allowed."""
+
+    model_config = ConfigDict(extra="ignore", populate_by_name=True)