chancellery 0.1.0__tar.gz

chancellery-0.1.0/.claude/agents/architect.md

@@ -0,0 +1,42 @@
+---
+name: architect
+description: "Архитектор-консультант проекта (read-only). Зови для разбора технических и архитектурных решений, выбора подхода, ревью архитектуры: даёт контекст → варианты с компромиссами → рекомендацию → развилку и предлагает ADR-Lite запись. Источник истины — файлы методики проекта; сам не коммитит."
+tools: Read, Glob, Grep
+model: inherit
+---
+Ты — старший архитектор ПО в этом проекте. Работаешь с ведущей сессией
+Claude Code и, если он подключён, с Дизайнером; финальные решения принимает
+человек — обращайся к нему на «ты», как равный к равному. Ты не знаешь проект
+заранее: всё проектное выясняешь из его файлов методики, а не додумываешь.
+
+## Как ты рассуждаешь (важнее любых фактов)
+- Начинай с реальной проблемы; отделяй настоящие ограничения от придуманных.
+- Называй компромиссы явно; не продавай один вариант — доводы «за» и «против»,
+  потом рекомендация.
+- Красивую, но дефектную идею протыкай рано, честно и по-доброму — до того,
+  как её начнут строить.
+- Отличай реальное от желаемого; не поддакивай приятным иллюзиям.
+- Предпочитай скучные, собираемые решения; сложность ответа — под сложность
+  задачи.
+- Уважай экспертизу собеседника: возражай с аргументами, не льсти, не
+  самоуничижайся.
+- Где метафора или удобство спорят с доменной логикой — побеждает домен.
+- Держи человека решающим; заканчивай открытой развилкой, если она есть.
+
+## Рабочий протокол
+1. Прежде чем отвечать — сориентируйся в проекте: прочитай CONCEPT.md,
+   DECISIONS.md, релевантные specs/, BOARD.md/BACKLOG.md. Эти файлы — источник
+   истины, приоритетнее твоих домыслов.
+2. Источник истины для тебя — файлы проекта, а не память. Если у тебя есть
+   доступ к какой-то внешней памяти — относись к ней как к подсказке-зеркалу,
+   но при конфликте верь файлам проекта и опирайся в выводах на них.
+3. Дай разбор: контекст → варианты с компромиссами → рекомендация → развилка.
+4. Отметь, какие файлы методики легли в основу ответа.
+5. Когда решение созрело — предложи готовую ADR-Lite запись для DECISIONS.md
+   в формате проекта. Сам не коммить: ты read-only, запись вносит лид/человек.
+
+## Границы
+- Не пишешь прод-код (это лид) и не проектируешь визуал (это Дизайнер).
+- Не выдумывай факты. Нет в файлах проекта — скажи прямо и предложи, что уточнить.
+- Отвечай на языке методики проекта, сжато; длина ответа — под сложность.
+

chancellery-0.1.0/.claude/settings.json

@@ -0,0 +1,18 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "dt context --hook"
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "t=$(git rev-parse --show-toplevel 2>/dev/null) && sh \"$t/.claude/statusline.sh\" \"$t\" || true"
+  }
+}

chancellery-0.1.0/.claude/statusline.sh

@@ -0,0 +1,72 @@
+#!/bin/sh
+# Claude Code statusLine reader for dreamteam's operational state layer.
+#
+# Prints "<workdir> · <task status line>" for the task bound to the current
+# git worktree, read verbatim from
+#   $DT_HOME/store/by-worktree/<slug>/context.line
+# The line is written elsewhere (SessionStart hook, `dt task start`,
+# `dt context`, `dt task move`); this script only *reads* it.
+#
+# Contract & guarantees:
+#   * No Python interpreter is launched (statusLine runs on every message
+#     update — a Python start-up would blow the budget). Only git + a sha1
+#     utility are used; the whole pass stays well under 50 ms.
+#   * The script never fails the status line: any glitch (not a git repo, no
+#     store, no binding, empty file, no sha1 tool) yields *empty stdout* and
+#     *exit 0*. A non-zero exit or empty output blanks the status line, which
+#     is exactly the desired "no bound task → nothing shown" behaviour.
+#   * stdin (the statusLine JSON payload) is ignored: Claude Code runs the
+#     command with the working directory set to the session cwd, so the
+#     worktree is found with `git rev-parse` from ".".
+#
+# `<slug>` and `$DT_HOME` are computed bit-for-bit like
+# dreamteam.dt.paths.worktree_slug / dt_home — otherwise the wrong file (or no
+# file) is read. See specs/T054-statusline/spec.md.
+
+# The main worktree top-level. Passed as $1 by the settings.json bootstrap
+# (which already ran `git rev-parse` to locate this script); falls back to a
+# lookup so the script also works when run directly.
+top=${1:-$(git rev-parse --show-toplevel 2>/dev/null)}
+[ -n "$top" ] || exit 0
+
+# The shared common dir keys $DT_HOME (same root from every linked worktree).
+common=$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null) || exit 0
+
+# Resolve $DT_HOME: an explicit override wins; otherwise the sibling
+# "<main-worktree>.dt". A common dir named ".git" means its parent is the main
+# worktree; anything else is a bare repo taken as the root directly.
+if [ -n "${DT_HOME:-}" ]; then
+    home=$DT_HOME
+else
+    case $common in
+        */.git) main=${common%/.git} ;;
+        *) main=$common ;;
+    esac
+    home="${main}.dt"
+fi
+
+# Resolve symlinks so the hashed path matches Python's Path(...).resolve().
+resolved=$(cd "$top" 2>/dev/null && pwd -P) || exit 0
+
+# sha1 over the path *bytes* (no trailing newline, mirroring str.encode()),
+# first eight hex chars. Prefer coreutils sha1sum; fall back to shasum (macOS).
+if command -v sha1sum >/dev/null 2>&1; then
+    slug=$(printf '%s' "$resolved" | sha1sum | cut -c1-8)
+elif command -v shasum >/dev/null 2>&1; then
+    slug=$(printf '%s' "$resolved" | shasum | cut -c1-8)
+else
+    exit 0
+fi
+[ -n "$slug" ] || exit 0
+
+line_file="${home}/store/by-worktree/${slug}/context.line"
+[ -r "$line_file" ] || exit 0
+# Read only the FIRST line: the status line must be a single row, but the file
+# is derived from an unsanitised task title that could carry an embedded
+# newline. This also drops a `cat` subprocess. `read` returns non-zero on a
+# final line without a trailing newline, yet still fills $line — so gate on the
+# content, not on read's exit status.
+IFS= read -r line <"$line_file"
+[ -n "$line" ] || exit 0
+
+printf '%s · %s\n' "$(basename "$resolved")" "$line"

chancellery-0.1.0/.claude/team-roles.md

@@ -0,0 +1,94 @@
+# Роли команды: Архитектор и Дизайнер
+
+Проект укомплектован переиспользуемым контуром сотрудничества поверх
+методики. Оркеструет **лид** (эта сессия Claude Code), финальные
+решения принимает **человек** (Разработчик). Две роли доступны по
+умолчанию — пользоваться ими в конкретной задаче или нет, решает лид
+по ситуации, а не галочка при создании проекта.
+
+Источник истины и «память» ролей — штатные файлы методики проекта
+(`CONCEPT.md`, `DECISIONS.md`, `specs/`, `BOARD.md`/`BACKLOG.md`), а не
+внешнее хранилище. Внешняя память лиду не запрещена, но это лишь
+зеркало канона в файлах: сбросилась — ничего не потеряно, всё
+восстановимо из проекта.
+
+> **Подхват после `dreamteam update`.** Роли (субагент-Архитектор и
+> импорт этой методики) подхватываются при **старте сессии** Claude
+> Code, а не в момент апдейта. Если `update` запущен из активной
+> сессии — перезапусти её, чтобы лид увидел новую роль.
+
+## Лид
+
+Основная сессия Claude Code в проекте (эта). Не отдельный артефакт, а
+поведение по `CLAUDE.md`. Пишет прод-код, ведёт задачи, вызывает
+Архитектора и Дизайнера и сводит их результаты. Живого трёхстороннего
+чата между ролями нет: лид обращается к каждой роли отдельно и сам
+объединяет ответы.
+
+## Архитектор (read-only субагент)
+
+Консультант по логике и архитектурным решениям. Живёт как субагент
+`.claude/agents/architect.md`; Claude Code обнаруживает его
+автоматически — отдельный импорт для него не нужен. Read-only
+(Read/Glob/Grep): читает файлы методики, рассуждает, предлагает — но
+сам не коммитит и не пишет код.
+
+**Когда звать:** выбор подхода, разбор технического решения, ревью
+архитектуры, сомнение «не выйдет ли боком». Не для написания кода (это
+лид) и не для визуала (это Дизайнер).
+
+**Как звать:** делегируй субагенту `architect` вопрос вместе с
+контекстом — он сам дочитает нужные файлы методики. Например: «Спроси
+Архитектора, стоит ли выносить X в отдельный модуль: дай контекст,
+варианты с компромиссами и рекомендацию».
+
+**Что возвращает:** разбор в форме контекст → варианты с компромиссами
+→ рекомендация → открытая развилка, с пометкой, какие файлы методики
+легли в основу. Когда решение созревает — предлагает готовую ADR-Lite
+запись для `DECISIONS.md` в формате проекта.
+
+**Петля «предложил → человек решил → ADR»:**
+
+1. Архитектор предлагает решение и черновик ADR-записи.
+2. Человек решает — Архитектор read-only и за него не решает.
+3. Лид/человек вносит финальную запись в `DECISIONS.md`.
+
+Так значимое решение оседает в файлах проекта, а не в летучей памяти
+агента.
+
+## Дизайнер (Claude Design через MCP)
+
+Внешний агент Claude Design для визуальной работы: интерфейсы,
+прототипы, визуальные спецификации. Лид вызывает его напрямую как MCP,
+в субагент не оборачивает.
+
+**Prerequisite — разовая настройка на уровне аккаунта:**
+
+1. `claude mcp add --scope user --transport http claude-design https://api.anthropic.com/v1/design/mcp`
+2. `/design-login` — OAuth-аутентификация (именно этот шаг подключает,
+   не `add`).
+3. (опц.) `claude mcp list` — проверить, что сервер зарегистрирован.
+
+Доступ к Claude Design — на планах Pro / Max / Team / Enterprise
+(beta). Если MCP не подключён или недоступен — это **не ошибка, а
+развилка**: лид либо подключает Дизайнера, либо работает без него.
+Дизайны используют design-system аккаунта (бренд-цвета, типографику),
+если она настроена; для свежего личного проекта — дефолты Claude Design.
+
+**Когда звать:** нужен визуальный дизайн или прототип интерфейса. Лид
+передаёт Дизайнеру бриф из `specs/design-brief-template.md`, итерирует
+и тянет результат в репозиторий как прототип.
+
+**Важно:** Дизайнер выдаёт **веб** (HTML/CSS/JS), а не целевой стек
+проекта. Его артефакт — визуальная спецификация; перевод в целевой
+UI-стек всегда отдельный шаг лида.
+
+## Честные ограничения
+
+- Нет живого трёхстороннего диалога: Архитектор и Дизайнер —
+  вызываемые роли, а не равные собеседники в общем чате.
+- Субагент — консультация, а не стрим: виден результат, не
+  промежуточные реплики.
+- Архитектор реконструирует роль по промпту и файлам проекта; качество
+  ответа = качество промпта + полнота файлов методики.
+- Дизайнер мыслит вебом; перевод в целевой стек — шаг лида.

chancellery-0.1.0/.copier-answers.yml

@@ -0,0 +1,10 @@
+_commit: 1.7.0
+_src_path: /home/vlakir/programming/dreamteam/src/dreamteam/template/.bundle
+language: ru
+package_manager: uv
+project_name: chancellery
+project_description: 'Библиотека русского склонения и генерации документов по шаблонам:
+  ФИО, должности, звания по падежам + рендер docx'
+author_name: Vladimir Kirievskiy
+author_email: vlakir73@yandex.ru
+architect_model: inherit

chancellery-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+# Четыре гейта проекта на каждый push и pull request.
+# Прогон изолированный, поэтому мьютекс-обёртка не нужна: делить нечего.
+name: Гейты
+
+on:
+  push:
+    branches: ['**']
+  pull_request:
+
+jobs:
+  gates:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Поставить uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Поставить зависимости
+        run: uv sync --all-extras --dev
+
+      - name: Линтер
+        run: uv run ruff check .
+
+      - name: Формат
+        run: uv run ruff format --check .
+
+      - name: Типы
+        run: uv run mypy src
+
+      - name: Тесты и покрытие
+        run: uv run pytest --cov=src --cov-report=term-missing --cov-fail-under=80

chancellery-0.1.0/.gitignore

@@ -0,0 +1,46 @@
+# IDE / Editors
+.idea/
+.zencoder/
+~*
+~*.*
+.~*
+*.kate-swp
+
+# Claude Code — служебные runtime-файлы (не для шаринга)
+.claude/*.lock
+.claude/settings.local.json
+
+# Python
+venv/
+env/
+__pycache__/
+*.pyc
+*.pyo
+dist/
+build/
+*.egg-info/
+.coverage
+
+# Logs
+*.log
+*.log.*
+log/
+
+# Secrets / config
+.env
+.secrets*
+secrets.env
+
+# Local utilities
+copy_to_remote.sh
+vanilla_docker.sh
+
+# Caches
+.cache/
+
+# Local SQLite
+*.sqlite
+
+# Temp / docs builds
+temp/
+doc/

chancellery-0.1.0/BACKLOG.md

@@ -0,0 +1,36 @@
+# Backlog
+
+Парковка идей, побочных находок и «надо бы потом починить».
+
+**Правило:** если в процессе работы над текущей задачей Claude или
+Разработчик замечают что-то постороннее — оно идёт сюда, а не в текущий
+коммит. Это защищает от расползания scope.
+
+Это **не формальный таск-трекер** со сроками и метриками — это парковка
+идей. Но **порядок имеет значение**: сверху — то, что планируется
+ближайшим, ниже — менее срочное (FIFO по умолчанию, можно поднимать
+приоритетное наверх). Когда из бэклога что-то берётся в работу — оно
+вырастает в задачу или спеку (`specs/T<NNN>-…`) и удаляется отсюда.
+
+## Формат
+
+`- **T<NNN>** — [<дата находки>] <короткое описание> — <опционально: контекст / откуда всплыло>`
+
+ID присваивается при создании; новый = `max(существующих T-ID в
+BACKLOG.md, BOARD.md и CHANGELOG.md) + 1`. ID не переиспользуется
+и сохраняется при перетекании задачи между BACKLOG и BOARD; после
+релиза задача переходит в `CHANGELOG.md` (с тем же T-ID), что
+гарантирует уникальность между релизами.
+
+## Items
+
+- **T002** — [2026-09-05] `overrides.fio` объявлен в схеме конфигурации и
+  рекламируется в scaffold-конфиге «Дьяка», но к сборке контекста не
+  подключён: заданные вручную падежные формы ФИО молча игнорируются
+  (`overrides.position` и `overrides.rank` работают). Перевезён сломанным
+  сознательно — решение Разработчика при clarify T001: чинить в переезде
+  нельзя, иначе критерий «поведение не изменилось» перестаёт что-либо
+  доказывать. Пришёл из бэклога «Дьяка» (там T028).
+  Acceptance: заданная в `overrides.fio` форма попадает в документ так же,
+  как это уже работает для должности и звания; тест на каждый падеж;
+  поведение при отсутствии секции не меняется.

chancellery-0.1.0/BOARD.md

@@ -0,0 +1,68 @@
+# Board
+
+Лёгкая Kanban-альтернатива на одном markdown-файле: три колонки
+(To Do / Doing / Done) под git, без внешних сервисов и инструментов.
+
+## Соотношение с другими файлами
+
+- `BACKLOG.md` — длинная очередь идей и побочных находок. Сюда падает
+  «потом подумаем», «не сейчас». Парковка scope.
+- `BOARD.md` (этот файл) — активный рабочий поток. Задачи, которые мы
+  уже взяли или собираемся брать в ближайшее время.
+- `specs/T<NNN>-*/spec.md` — куда вырастает крупная задача из BOARD, если
+  она оказывается фичей >1 дня работы.
+
+Жизненный цикл задачи: идея в `BACKLOG.md` → созрела → переезжает в
+`To Do` здесь → берётся в работу (`Doing`) → закрывается (`Done`) →
+после релиза переходит в `CHANGELOG.md` (запись обязательно содержит
+T-ID), отсюда удаляется. **`CHANGELOG.md` — единственное persistent-
+хранилище T-ID завершённых задач**, без него правило «ID не
+переиспользуется» сломается.
+
+## Формат задачи
+
+Каждая задача — `- **T<NNN>** — <короткое описание>`. ID присваивается
+при создании: новый = `max(существующих T-ID в BOARD.md, BACKLOG.md и
+CHANGELOG.md) + 1`. ID никогда не переиспользуется. ID общий для
+`BOARD.md` и `BACKLOG.md` — при перетекании задачи между ними
+сохраняется; после релиза задача попадает в `CHANGELOG.md` с тем же
+T-ID, что гарантирует уникальность номеров между релизами.
+
+Имя ветки: `T<NNN>-<slug>` (без namespace типа `fixes/` / `feature/` —
+ID уже даёт идентификацию). Имя PR: `T<NNN>: <title>`. Спецификация
+крупной фичи: `specs/T<NNN>-<slug>/spec.md`.
+
+По вкусу можно добавлять:
+
+- метку даты взятия,
+- ссылку на спеку,
+- имя ветки.
+
+Пример:
+
+```
+- **T<NNN>** — Превью постов в Telegram
+  (`specs/T<NNN>-telegram-preview/`, ветка `T<NNN>-telegram-preview`).
+```
+
+---
+
+## To Do
+
+<!-- Готово к взятию. Очередь FIFO по умолчанию, можно поднимать
+     приоритетное наверх. -->
+
+<!-- Записи задач в формате `- **T<NNN>** — описание`. См. раздел
+     «Формат задачи» выше. -->
+
+
+## Doing
+
+<!-- В работе прямо сейчас. Держим короткой: максимум 1-2 задачи на
+     разработчика, иначе теряется фокус (классическое WIP-limit
+     правило из Kanban). -->
+
+## Done
+
+<!-- Закрытые задачи, ждущие переноса в CHANGELOG.md при следующем
+     релизе или значимой точке. После переноса — очищаем. -->

chancellery-0.1.0/CHANGELOG.md

@@ -0,0 +1,112 @@
+# Changelog
+
+История заметных изменений. Формат — упрощённый
+[Keep a Changelog](https://keepachangelog.com/).
+
+Записи группируются по версиям или датам релизов. Для проектов без
+формального версионирования допустимо использовать дату как заголовок.
+
+Категории:
+- **Added** — новая функциональность.
+- **Changed** — изменения в существующей функциональности.
+- **Fixed** — исправления багов.
+- **Removed** — удалённая функциональность.
+- **Deprecated** — то, что помечено к удалению, но пока работает.
+- **Security** — изменения, важные с точки зрения безопасности.
+
+Если изменение связано с задачей из `BOARD.md` / `BACKLOG.md`,
+запись **обязательно** содержит T-ID в скобках, например:
+`Added: Превью постов в Telegram (T<NNN>).` Это сохраняет уникальность
+T-ID между релизами — `CHANGELOG.md` единственное persistent-
+хранилище номеров завершённых задач (см. правило нумерации
+в `README.md`).
+
+---
+
+## [0.1.0] — 2026-09-05
+
+### Added
+- Движок русского склонения, перенесённый из «Дьяка» 0.3.3 (T001):
+  ФИО и его части с автоопределением рода, инициалы в шести формах,
+  универсальный фраз-движок для должностей и подразделений, воинские и
+  служебные звания.
+- Рендер `docx` по шаблону с русской разметкой (T001): падежные фильтры
+  `ип`/`рд`/`дт`/`вн`/`тв`/`пр`, согласование по полу фильтром `согл`,
+  строгий режим неизвестных переменных, чистка пустых значений вместе с
+  осиротевшей пунктуацией.
+- Распознавание колонок по заголовку и содержимому, чтение таблицы
+  `xlsx` с учётом пользовательского фильтра и скрытых строк,
+  уникальные имена выходных файлов, `pydantic`-конфигурация ручных
+  переопределений форм (T001).
+- Обратная сборка размеченного шаблона из готового документа и строки
+  данных (T001).
+- Сухой прогон `check_table`: проверка склонения, пола и шаблона без
+  записи файлов (T001).
+- Высокоуровневый сценарий `generate_documents` / `reverse_template` —
+  таблица + шаблон + конфиг → документы одним вызовом (T001).
+- Порт прогресса `ProgressSink`: ход работы отдаётся потребителю через
+  фабрику от числа строк, поэтому обвязка терминала в зависимости
+  библиотеки не попадает (T001).
+- Прогон четырёх гейтов в CI на каждый push и pull request (T001).
+- Выкладка на публичный PyPI скриптом `scripts/publish.sh`: четыре
+  гейта, сборка, проверка артефактов `twine`, загрузка (T003).
+- Лицензия MIT, метаданные пакета (classifiers, ссылки, ключевые слова)
+  и маркер `py.typed` — без него mypy у потребителей не видел бы типы
+  библиотеки (T003).
+
+### Changed
+- Корень иерархии ошибок переименован `DyakError` → `ChancelleryError`
+  (T001).
+
+### Removed
+- `PdfExportError` в библиотеку не переехал: экспорт в PDF — вызов
+  внешнего `soffice` и остаётся заботой приложений (T001).
+
+### Retrospective
+
+- **Что зашло.** Приёмка по эталону донора: сессия «Дьяка» сняла снимок
+  поведения 0.3.3 и отдала скрипт сверки, а библиотека прогнала его у
+  себя через тонкую обвязку — ещё до того, как «Дьяк» начал переезжать.
+  Расхождение искалось бы на своей стороне, а не в чужом репозитории;
+  на такой приёмке перенос перестаёт быть верой в диффы. Второе, что
+  сработало, — переписка двух сессий по фактуре: колбэк-прогресс
+  выглядел разумно и молча сломал бы чужое окно, а поймано это было
+  до единой строки кода.
+- **Что не зашло.** Обещание публикации в спеке было дано без проверки
+  предусловий: Trusted Publishing требует ручного шага владельца
+  учётной записи, и обнаружилось это на последнем шаге, когда всё уже
+  было написано. Дважды по ходу приходилось чинить контракт задним
+  числом (`read_table` и нормализаторы конфига не попали в `__all__`) —
+  список публичных имён набирался по памяти вместо вычитки.
+- **Правки методики.** Проектный `CLAUDE.md` пополнился правилом про
+  русский язык комментариев и докстрингов. Стоит завести привычку: если
+  acceptance спеки упирается во внешний сервис, проверять предусловия
+  на этапе analyze, а не при выпуске.
+
+<!-- При закрытии этой версии (переход к новой `## [N.M.0]`)
+     добавляется секция:
+
+### Retrospective
+
+- **Что зашло:** ...
+- **Что не зашло:** ...
+- **Правки методики:** ...
+
+Это короткий разбор результата milestone. Не обязательная длинная
+форма — несколько строк по делу. -->
+
+
+---
+
+<!-- Пример (удалить при заполнении шаблона):
+
+## [0.1.0] — 2026-05-13
+
+### Added
+- Базовая структура проекта по шаблону dreamteam.
+- Веб-форма публикации с превью.
+
+### Fixed
+- Падение при пустом теле поста.
+
+-->