kaiten-cli 0.3.4__tar.gz → 0.3.6__tar.gz

{kaiten_cli-0.3.4 → kaiten_cli-0.3.6}/AGENTS.md

@@ -2,11 +2,14 @@
 
 This file only captures agent-specific guidance.
 
-For install, human-oriented usage, and the full docs map, start with [README.md](README.md).  
-For the full command catalog, use [COMMAND_REFERENCE.md](COMMAND_REFERENCE.md).  
+For installation, upgrades, first commands, and the full docs map, start with [README.md](README.md).
+For detailed usage and compatibility, use [docs/USAGE.md](docs/USAGE.md).
+For developer setup and checks, use [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md).
+For the full command catalog, use [COMMAND_REFERENCE.md](COMMAND_REFERENCE.md).
 For the system map, use [ARCHITECTURE.md](ARCHITECTURE.md).
 For the PyPI publishing process, use [docs/PYPI_PUBLISHING.md](docs/PYPI_PUBLISHING.md).
-For a stable install, start with `pip install kaiten-cli`; pipx and uv are alternatives.
+For a stable install, use `pip install kaiten-cli`, pipx, uv, or the published
+Homebrew tap: `brew install ViktorOgnev/tap/kaiten-cli`.
 Use a Git install when the requested source is a branch or tag. Check the installed
 version separately from the checkout: they can differ.
 For optimized LLM workflows, start with:
@@ -14,6 +17,9 @@ For optimized LLM workflows, start with:
 - [skills/kaiten-cli-heavy-data/SKILL.md](skills/kaiten-cli-heavy-data/SKILL.md)
 - [skills/kaiten-cli-metrics/SKILL.md](skills/kaiten-cli-metrics/SKILL.md)
 - [skills/kaiten-cli-mutations/SKILL.md](skills/kaiten-cli-mutations/SKILL.md)
+- [skills/kaiten-cli-access-management/SKILL.md](skills/kaiten-cli-access-management/SKILL.md)
+  for entity operations, users, groups, roles and access API parameters. External
+  specification interpretation and reconciliation belong to the calling harness.
 
 ## Conversation locale
 

{kaiten_cli-0.3.4 → kaiten_cli-0.3.6}/API_BEHAVIOR_MATRIX.md

@@ -21,6 +21,17 @@
 
 ## Default rule
 
+Целевая live-проверка управления доступами от `2026-11-04` относится к
+26 новым командам и именованным правам временной группы; общая историческая
+дата полной campaign выше не меняется. Commit, версия, исправление создания
+карты, проверка наследования и очистка описаны в
+[отчёте](docs/ACCESS_MANAGEMENT_LIVE.md).
+Новые команды имеют `live_passed`, кроме `story-maps.create` с
+`live_passed_with_runtime_fix`: CLI передаёт недостающий `sort_order`.
+`company-users.update` сохраняет `live_not_validated` для прав компании:
+на временном виртуальном получателе сервер вернул HTTP 500; повторной записи
+не было, cleanup выполнен. Права обычного пользователя компании не проверялись.
+
 Все canonical команды из registry, которые не перечислены ниже, считаются `live_passed`: они должны проходить по normal success-path в полном live suite.
 
 Это правило интерпретации закодированной матрицы и ожидаемого success-path,

{kaiten_cli-0.3.4 → kaiten_cli-0.3.6}/ARCHITECTURE.md

@@ -33,6 +33,13 @@ Main layers:
 
 ## Registry vs Runtime
 
+The `access_management` registry module exposes API-token routes for entity
+metadata, assignments, UUID access roles and story maps. Its only aggregated
+operation is bounded flat administrative-tree pagination; it does not implement
+specification parsing, access-policy evaluation, reconciliation or orchestration.
+Undocumented routes carry explicit compatibility notes and unvalidated live
+contracts. Sensitive new reads use request-scoped caching by default.
+
 This repo does not have two different sets of tools.
 
 - `registry` defines the tools.
@@ -185,7 +192,9 @@ Bulk reads are still registry-defined tools. The difference is that some aggrega
 
 Primary docs:
 
-- [README.md](README.md) for install, usage, config, and operator guidance
+- [README.md](README.md) for installation, upgrades, configuration, first commands, and the docs map
+- [docs/USAGE.md](docs/USAGE.md) for detailed workflows, document updates, API compatibility, cache and snapshot behavior
+- [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for developer setup, documentation generation, tests and benchmarks
 - [COMMAND_REFERENCE.md](COMMAND_REFERENCE.md) for the full generated command catalog
 - [AGENTS.md](AGENTS.md) for agent-specific usage and safety shortcuts
 - [docs/PYPI_PUBLISHING.md](docs/PYPI_PUBLISHING.md) for PyPI setup, release and verification

kaiten_cli-0.3.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Viktor Ognev
+
+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.

{kaiten_cli-0.3.4 → kaiten_cli-0.3.6}/LIVE_VALIDATION.md

@@ -18,6 +18,14 @@
 
 ## Ограничения пространства
 
+Целевая проверка новых команд доступа выполнена 4 ноября 2026 года на
+пользовательской тестовой компании: 26 команд прошли, включая выдачу/отзыв
+прав и cleanup; создание карт потребовало исправления CLI. Отдельно проверено
+наследование. HTTP 500 при записи прав виртуального пользователя не считается
+успешным покрытием. Это не полный прогон всех команд CLI.
+[Отчёт и точные метаданные](docs/ACCESS_MANAGEMENT_LIVE.md),
+[сценарии](tests/live/test_access_management_live.py).
+
 Группа `restrictions` — недокументированное расширение по серверному коду, со статусом
 `live_not_validated`. На 2026-10-06 live-сценарий **не запускался**.
 Отдельный opt-in сценарий создаёт два временных пространства, создаёт правило,