atlas-pm 0.2.3__tar.gz

atlas_pm-0.2.3/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+# Публикация atlas-cli на PyPI по семвер-тегу vX.Y.Z через Trusted Publishing (OIDC).
+# Ничего не хранится: GitHub выдаёт короткоживущий OIDC-токен, PyPI доверяет связке
+# owner/repo/workflow (настраивается на pypi.org → Trusted Publisher).
+#
+# Этот файл живёт в приватном GitLab-источнике и КУРИРУЕМО уезжает в публичный
+# github (publish_public_github.sh не исключает .github/); на github-теге и срабатывает.
+name: publish-pypi
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+
+permissions:
+  id-token: write   # обязательно для OIDC Trusted Publishing
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - name: Build
+        run: uv build
+      - name: Publish to PyPI (Trusted Publishing)
+        run: uv publish --trusted-publishing always

atlas_pm-0.2.3/.gitignore

@@ -0,0 +1,94 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# uv
+.uv-cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Secrets / local
+.env
+.env.local
+AGENTS.local.md
+CLAUDE.local.md
+*.local
+
+# Worktrees
+.worktrees/
+
+# PM database (local)
+atlas.db
+atlas.db-journal
+atlas.db-wal
+atlas.db-shm
+
+# Logs
+*.log
+logs/
+
+# === atlas universal extras (per project convention) ===
+*.csv
+*.flac
+*.har
+*.json
+*.jsonl
+*.mov
+*.mp3
+*.mp4
+*.pdf
+*.tsv
+*.txt
+*.wav
+*.webm
+*.xls
+*.xlsm
+*.xlsx
+*.zip
+
+!.claude.json
+!.claude/**/*.json
+!.eslintrc*.json
+!.mcp.json
+!.prettierrc*.json
+!CHANGELOG.txt
+!LICENSE.txt
+!README.txt
+!atlas.json
+!biome.json
+!claude.json
+!components.json
+!constraints*.txt
+!manifest.json
+!package-lock.json
+!package.json
+!playwright.config.json
+!requirements*.txt
+!tsconfig*.json
+
+# autogen демоном (машинно-специфичные пути) — не в git
+scripts/sync_watch_headless*.vbs

atlas_pm-0.2.3/LICENSE

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

atlas_pm-0.2.3/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: atlas-pm
+Version: 0.2.3
+Summary: Atlas — local-first PM-система для портфеля проектов и задач
+Project-URL: Homepage, https://github.com/zZZTeJleTTy3uKZZz/atlas
+Project-URL: Repository, https://github.com/zZZTeJleTTy3uKZZz/atlas
+Author: Atlas CLI contributors
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: alembic>=1.13
+Requires-Dist: httpx>=0.27
+Requires-Dist: python-dateutil>=2.9
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: python-frontmatter>=1.1
+Requires-Dist: python-slugify>=8.0.4
+Requires-Dist: pytz>=2024.1
+Requires-Dist: rich>=13.7
+Requires-Dist: s-adapterkit>=0.1.2
+Requires-Dist: s-agentskit>=0.1.0
+Requires-Dist: s-clikit>=0.1.6
+Requires-Dist: s-issuekit>=0.2.0
+Requires-Dist: s-librarykit>=0.1.3
+Requires-Dist: sqlalchemy>=2.0.30
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.32; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Atlas
+
+**Local-first PM-система для портфеля проектов и задач.** Всё живёт в локальном
+SQLite (`~/.atlas/atlas.db`) и работает без сети — самодостаточно, без внешних
+сервисов.
+
+```
+Atlas (SQLite, local-first) — проекты · задачи · идеи · гипотезы
+```
+
+CLI `atlas` единообразен (единственное число команд), `--json` по умолчанию
+(удобно для скриптов/AI-агентов), `--text`/`--plain` — человекочитаемый вывод.
+
+## Возможности
+
+- **Портфель проектов**: типы, статусы, теги, владельцы, архив, git-раскладка.
+- **Задачи** с ЦКП (ценный конечный продукт), чек-листами, участниками, эпиками,
+  lease/claim для мультиагентной координации.
+- **Идеи и inbox** — инкубатор и свалка сырья на разбор.
+- **Гипотезы** — фальсифицируемый ledger по продукту/маркетингу.
+- **Бэкап**, аудит (append-only action-log), статистика портфеля.
+
+## Установка
+
+Требуется Python ≥ 3.11.
+
+**Рекомендуемый путь — через [skillery](https://skillery.ru)** (тогда заодно
+ставится навык для Claude-агента — см. ниже):
+
+```bash
+skillery install atlas      # ставит CLI + навык
+```
+
+Без skillery — напрямую из git ([uv](https://docs.astral.sh/uv/) или pipx):
+
+```bash
+pipx install "git+https://github.com/zZZTeJleTTy3uKZZz/atlas.git"
+# или для разработки:  uv sync --extra dev
+```
+
+Проверка: `atlas --version` и `atlas --help`.
+
+## Обновление
+
+```bash
+atlas upgrade            # pipx из git: pipx upgrade atlas
+atlas upgrade --reinstall  # принудительная переустановка из git (force)
+atlas upgrade --check    # только показать версию + метод установки
+```
+
+- **skillery** — обновляй через skillery (re-install подтянет новые deps).
+- **pipx из git** — `atlas upgrade` (= `pipx upgrade atlas`, тянет свежий коммит).
+- **editable (dev)** — код живой, обнови `git pull` в репозитории.
+
+## Онбординг (первый запуск)
+
+1. **Задайте владельца стора** (ваш member-slug) — он станет дефолтным
+   участником-актором и владельцем новых проектов:
+
+   ```bash
+   atlas config set owner alice        # ваш slug (kebab-case) → config.toml
+   atlas config show                   # посмотреть весь конфиг
+   ```
+
+   Опционально там же — `org_namespace` / `personal_namespace` / `personal_owner`
+   (git-раскладка), `base_url` (адрес backend для синка). Конфиг читается слоями
+   `config.toml < .atlas.toml в проекте < env ATLAS_*` (на сессию можно env
+   `ATLAS_OWNER=alice`). Секрет `api_key` — только через env / secret-store.
+
+2. **Инициализируйте БД** (миграции + базовые справочники):
+
+   ```bash
+   atlas project init
+   ```
+
+   Создаёт `~/.atlas/atlas.db`, применяет миграции и заселяет типы/статусы/теги +
+   участников (claude-code + ваш `owner`). Идемпотентно — повторный вызов безопасен.
+
+3. **Готово** — создавайте проекты и задачи (см. ниже). Если `owner` не задан,
+   Atlas всё равно работает, но участника-владельца придётся указывать явно
+   (`--owner` / `--assignee`).
+
+## Быстрый старт
+
+```bash
+# проект (личный по умолчанию; --team — командный)
+atlas project add --name "Мой лендинг" --slug my-landing --type personal-project
+
+# задача с ЦКП
+atlas task add --project my-landing --title "Собрать структуру" \
+  --cpp "Готов wireframe из 6 секций" --priority P1
+
+# взять задачу в работу (lease-лок, атомарно)
+atlas task claim <number|slug> --ttl 2h
+
+# список (человекочитаемо)
+atlas --text task list --project my-landing
+```
+
+## Конфигурация
+
+Atlas читает слоистый конфиг (global `config.toml` < project `.atlas.toml` <
+local < env `ATLAS_*`). Глобальный файл — в OS-config-каталоге (создаётся
+командой `atlas config set …`). Ключевые поля (все опциональны, дефолты — generic):
+
+| Поле / env | Назначение |
+|---|---|
+| `owner` / `ATLAS_OWNER` | member-slug владельца стора (дефолтный actor аудита, владелец новых проектов) |
+| `org_namespace` / `ATLAS_ORG_NAMESPACE` | организационный git-namespace для раскладки проектов |
+| `personal_namespace` / `ATLAS_PERSONAL_NAMESPACE` | личный git-namespace (для проектов с owner-тегом) |
+| `personal_owner` / `ATLAS_PERSONAL_OWNER` | значение owner-тега, переключающее на личный namespace |
+| `team_owner` / `ATLAS_TEAM_OWNER` | counterparty-владелец по умолчанию для `--team`-проектов |
+| `timezone` / `ATLAS_TIMEZONE` | часовой пояс PM-БД (фиксированный offset, напр. `+03:00`) |
+
+Без конфига Atlas полностью работает локально; владельца/namespaces задаёте под
+себя.
+
+## Навык для Claude / skillery
+
+Репозиторий несёт навык в `skills/atlas/` (`SKILL.md` + `agents/` + `references/`) — Atlas можно
+поставить как **tooling-навык** через [skillery](https://skillery.ru): install
+материализует навык и ставит сам CLI (`_skill_meta.toml`). Тогда AI-агент знает,
+как и когда пользоваться `atlas`.
+
+## Разработка
+
+```bash
+uv sync --extra dev
+uv run pytest -q          # тесты
+uv run ruff check .       # линт
+```
+
+Миграции БД — через Alembic (`uv run alembic upgrade head`). Дисциплина:
+TDD, миграции в git до деплоя, осмысленные коммиты.
+
+## Лицензия
+
+[MIT](LICENSE).

atlas_pm-0.2.3/README.md

@@ -0,0 +1,138 @@
+# Atlas
+
+**Local-first PM-система для портфеля проектов и задач.** Всё живёт в локальном
+SQLite (`~/.atlas/atlas.db`) и работает без сети — самодостаточно, без внешних
+сервисов.
+
+```
+Atlas (SQLite, local-first) — проекты · задачи · идеи · гипотезы
+```
+
+CLI `atlas` единообразен (единственное число команд), `--json` по умолчанию
+(удобно для скриптов/AI-агентов), `--text`/`--plain` — человекочитаемый вывод.
+
+## Возможности
+
+- **Портфель проектов**: типы, статусы, теги, владельцы, архив, git-раскладка.
+- **Задачи** с ЦКП (ценный конечный продукт), чек-листами, участниками, эпиками,
+  lease/claim для мультиагентной координации.
+- **Идеи и inbox** — инкубатор и свалка сырья на разбор.
+- **Гипотезы** — фальсифицируемый ledger по продукту/маркетингу.
+- **Бэкап**, аудит (append-only action-log), статистика портфеля.
+
+## Установка
+
+Требуется Python ≥ 3.11.
+
+**Рекомендуемый путь — через [skillery](https://skillery.ru)** (тогда заодно
+ставится навык для Claude-агента — см. ниже):
+
+```bash
+skillery install atlas      # ставит CLI + навык
+```
+
+Без skillery — напрямую из git ([uv](https://docs.astral.sh/uv/) или pipx):
+
+```bash
+pipx install "git+https://github.com/zZZTeJleTTy3uKZZz/atlas.git"
+# или для разработки:  uv sync --extra dev
+```
+
+Проверка: `atlas --version` и `atlas --help`.
+
+## Обновление
+
+```bash
+atlas upgrade            # pipx из git: pipx upgrade atlas
+atlas upgrade --reinstall  # принудительная переустановка из git (force)
+atlas upgrade --check    # только показать версию + метод установки
+```
+
+- **skillery** — обновляй через skillery (re-install подтянет новые deps).
+- **pipx из git** — `atlas upgrade` (= `pipx upgrade atlas`, тянет свежий коммит).
+- **editable (dev)** — код живой, обнови `git pull` в репозитории.
+
+## Онбординг (первый запуск)
+
+1. **Задайте владельца стора** (ваш member-slug) — он станет дефолтным
+   участником-актором и владельцем новых проектов:
+
+   ```bash
+   atlas config set owner alice        # ваш slug (kebab-case) → config.toml
+   atlas config show                   # посмотреть весь конфиг
+   ```
+
+   Опционально там же — `org_namespace` / `personal_namespace` / `personal_owner`
+   (git-раскладка), `base_url` (адрес backend для синка). Конфиг читается слоями
+   `config.toml < .atlas.toml в проекте < env ATLAS_*` (на сессию можно env
+   `ATLAS_OWNER=alice`). Секрет `api_key` — только через env / secret-store.
+
+2. **Инициализируйте БД** (миграции + базовые справочники):
+
+   ```bash
+   atlas project init
+   ```
+
+   Создаёт `~/.atlas/atlas.db`, применяет миграции и заселяет типы/статусы/теги +
+   участников (claude-code + ваш `owner`). Идемпотентно — повторный вызов безопасен.
+
+3. **Готово** — создавайте проекты и задачи (см. ниже). Если `owner` не задан,
+   Atlas всё равно работает, но участника-владельца придётся указывать явно
+   (`--owner` / `--assignee`).
+
+## Быстрый старт
+
+```bash
+# проект (личный по умолчанию; --team — командный)
+atlas project add --name "Мой лендинг" --slug my-landing --type personal-project
+
+# задача с ЦКП
+atlas task add --project my-landing --title "Собрать структуру" \
+  --cpp "Готов wireframe из 6 секций" --priority P1
+
+# взять задачу в работу (lease-лок, атомарно)
+atlas task claim <number|slug> --ttl 2h
+
+# список (человекочитаемо)
+atlas --text task list --project my-landing
+```
+
+## Конфигурация
+
+Atlas читает слоистый конфиг (global `config.toml` < project `.atlas.toml` <
+local < env `ATLAS_*`). Глобальный файл — в OS-config-каталоге (создаётся
+командой `atlas config set …`). Ключевые поля (все опциональны, дефолты — generic):
+
+| Поле / env | Назначение |
+|---|---|
+| `owner` / `ATLAS_OWNER` | member-slug владельца стора (дефолтный actor аудита, владелец новых проектов) |
+| `org_namespace` / `ATLAS_ORG_NAMESPACE` | организационный git-namespace для раскладки проектов |
+| `personal_namespace` / `ATLAS_PERSONAL_NAMESPACE` | личный git-namespace (для проектов с owner-тегом) |
+| `personal_owner` / `ATLAS_PERSONAL_OWNER` | значение owner-тега, переключающее на личный namespace |
+| `team_owner` / `ATLAS_TEAM_OWNER` | counterparty-владелец по умолчанию для `--team`-проектов |
+| `timezone` / `ATLAS_TIMEZONE` | часовой пояс PM-БД (фиксированный offset, напр. `+03:00`) |
+
+Без конфига Atlas полностью работает локально; владельца/namespaces задаёте под
+себя.
+
+## Навык для Claude / skillery
+
+Репозиторий несёт навык в `skills/atlas/` (`SKILL.md` + `agents/` + `references/`) — Atlas можно
+поставить как **tooling-навык** через [skillery](https://skillery.ru): install
+материализует навык и ставит сам CLI (`_skill_meta.toml`). Тогда AI-агент знает,
+как и когда пользоваться `atlas`.
+
+## Разработка
+
+```bash
+uv sync --extra dev
+uv run pytest -q          # тесты
+uv run ruff check .       # линт
+```
+
+Миграции БД — через Alembic (`uv run alembic upgrade head`). Дисциплина:
+TDD, миграции в git до деплоя, осмысленные коммиты.
+
+## Лицензия
+
+[MIT](LICENSE).

atlas_pm-0.2.3/alembic.ini

@@ -0,0 +1,149 @@
+# A generic, single database configuration.
+
+[alembic]
+# path to migration scripts.
+# this is typically a path given in POSIX (e.g. forward slashes)
+# format, relative to the token %(here)s which refers to the location of this
+# ini file
+script_location = %(here)s/migrations
+
+# template used to generate migration file names; The default value is %%(rev)s_%%(slug)s
+# Uncomment the line below if you want the files to be prepended with date and time
+# see https://alembic.sqlalchemy.org/en/latest/tutorial.html#editing-the-ini-file
+# for all available tokens
+# file_template = %%(year)d_%%(month).2d_%%(day).2d_%%(hour).2d%%(minute).2d-%%(rev)s_%%(slug)s
+# Or organize into date-based subdirectories (requires recursive_version_locations = true)
+# file_template = %%(year)d/%%(month).2d/%%(day).2d_%%(hour).2d%%(minute).2d_%%(second).2d_%%(rev)s_%%(slug)s
+
+# sys.path path, will be prepended to sys.path if present.
+# defaults to the current working directory.  for multiple paths, the path separator
+# is defined by "path_separator" below.
+prepend_sys_path = .
+
+
+# timezone to use when rendering the date within the migration file
+# as well as the filename.
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
+# string value is passed to ZoneInfo()
+# leave blank for localtime
+# timezone =
+
+# max length of characters to apply to the "slug" field
+# truncate_slug_length = 40
+
+# set to 'true' to run the environment during
+# the 'revision' command, regardless of autogenerate
+# revision_environment = false
+
+# set to 'true' to allow .pyc and .pyo files without
+# a source .py file to be detected as revisions in the
+# versions/ directory
+# sourceless = false
+
+# version location specification; This defaults
+# to <script_location>/versions.  When using multiple version
+# directories, initial revisions must be specified with --version-path.
+# The path separator used here should be the separator specified by "path_separator"
+# below.
+# version_locations = %(here)s/bar:%(here)s/bat:%(here)s/alembic/versions
+
+# path_separator; This indicates what character is used to split lists of file
+# paths, including version_locations and prepend_sys_path within configparser
+# files such as alembic.ini.
+# The default rendered in new alembic.ini files is "os", which uses os.pathsep
+# to provide os-dependent path splitting.
+#
+# Note that in order to support legacy alembic.ini files, this default does NOT
+# take place if path_separator is not present in alembic.ini.  If this
+# option is omitted entirely, fallback logic is as follows:
+#
+# 1. Parsing of the version_locations option falls back to using the legacy
+#    "version_path_separator" key, which if absent then falls back to the legacy
+#    behavior of splitting on spaces and/or commas.
+# 2. Parsing of the prepend_sys_path option falls back to the legacy
+#    behavior of splitting on spaces, commas, or colons.
+#
+# Valid values for path_separator are:
+#
+# path_separator = :
+# path_separator = ;
+# path_separator = space
+# path_separator = newline
+#
+# Use os.pathsep. Default configuration used for new projects.
+path_separator = os
+
+# set to 'true' to search source files recursively
+# in each "version_locations" directory
+# new in Alembic version 1.10
+# recursive_version_locations = false
+
+# the output encoding used when revision files
+# are written from script.py.mako
+# output_encoding = utf-8
+
+# database URL.  This is consumed by the user-maintained env.py script only.
+# other means of configuring database URLs may be customized within the env.py
+# file.
+sqlalchemy.url = driver://user:pass@localhost/dbname
+
+
+[post_write_hooks]
+# post_write_hooks defines scripts or Python functions that are run
+# on newly generated revision scripts.  See the documentation for further
+# detail and examples
+
+# format using "black" - use the console_scripts runner, against the "black" entrypoint
+# hooks = black
+# black.type = console_scripts
+# black.entrypoint = black
+# black.options = -l 79 REVISION_SCRIPT_FILENAME
+
+# lint with attempts to fix using "ruff" - use the module runner, against the "ruff" module
+# hooks = ruff
+# ruff.type = module
+# ruff.module = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Alternatively, use the exec runner to execute a binary found on your PATH
+# hooks = ruff
+# ruff.type = exec
+# ruff.executable = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Logging configuration.  This is also consumed by the user-maintained
+# env.py script only.
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARNING
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARNING
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

atlas_pm-0.2.3/migrations/README

@@ -0,0 +1 @@
+Generic single-database configuration.