@smwb/onreel-git-mcp 0.9.0 → 0.10.1

package/README.md

@@ -10,7 +10,8 @@
 - **жизненный цикл worktree** — замки, двухфазное создание и очистка, сверка при старте, свип и корзина —
   против портов хранения, которые реализует потребитель;
 - **адаптеры трекеров** — единая модель задач и пять адаптеров: GitHub, GitLab, Jira, SourceCraft и локальный
-  трекер поверх хранилища потребителя; у GitHub, GitLab и SourceCraft есть раздел pull request-ов (D-005);
+  трекер поверх хранилища потребителя; у GitHub, GitLab и SourceCraft есть разделы pull request-ов и CI (D-005)
+  и раздел репозитория — карточка и ветки (D-008);
 - **MCP stdio-сервер** — JSON-RPC 2.0 поверх stdin/stdout, инструменты строятся из таблицы команд вызывающего.
 
 Пакет ESM, рантайм-зависимость одна — `zod`. Публичная поверхность держится документированной здесь:
@@ -203,7 +204,13 @@ await withWorktreeLock('wt-9', async () => {
 все переходы (`markWorktreeReady`, `markWorktreeFailed`, `requestWorktreeCleanup`, `completeWorktreeCleanup`);
 вложенность и асинхронные обратные вызовы не поддерживаются. **Эталон реализации — `test/helpers/memory-store.lib.ts`
 в тестовом дереве пакета** (D-003): он же образец семантики для потребителей, включая копию-на-коммит в
-`inTransaction` и отказ броска как откат.
+`inTransaction` и отказ броска как откат. Свои переходы библиотека пишет с `actor: 'host'` — процесс, который её
+держит (D-012); реализация порта отображает это значение в лексику потребителя.
+
+Замки worktree — одна таблица на процесс. Субпуть, которому нужны замки, импортирует модуль жизненного цикла
+напрямую: модуль двух и более точек входа tsup выносит в общий chunk, поэтому определение таблицы в собранном
+пакете остаётся одно (D-013). Инвариант держит `test/worktree/locks-bundle.test.ts` — он собирает пакет
+конфигурацией проекта во временный каталог и требует ровно одного определения.
 
 ## tracker
 
@@ -254,7 +261,13 @@ try {
 `GITHUB_PRIORITY_LABELS`, `GITLAB_PRIORITY_LABELS`, …), чтобы потребитель видел, во что именно преводится его
 статус. Свои трекеры добавляют в реестр явным `registerTracker(definition)`; повторный `kind` — исключение, а не
 молчаливая замена. Типы порта `LocalIssueStore` (и его строк) реэкспортированы из `…/tracker` — реализацию, как и
-для `WorktreeStore`, пишет потребитель; эталон в памяти — `test/helpers/tracker-fixtures.lib.ts`.
+для `WorktreeStore`, пишет потребитель; эталон в памяти — `test/helpers/tracker-fixtures.lib.ts`. Порт требует:
+комментарий — только к существующей задаче, иначе отказ с кодом `unknown_issue` (сиротских комментариев хранилище
+не держит, D-011); `limit` страницы — целое от 1 до 500, по умолчанию 100, значение вне диапазона прижимается
+к границам; снятый исполнитель (`assignee: null`) убирает ключ из строки задачи, а не оставляет его со значением
+`undefined`. Нецелый `limit` до хранилища не доходит: адаптер отказывает `invalid_request` ещё в проверке запроса,
+а чем на него отвечает сама реализация порта, не предписано — эталон в памяти отвечает `invalid_request`, ledger
+падает ошибкой SQLite.
 
 Таймаут запроса к трекеру — `TRACKER_TIMEOUT_MS` (15 с), тело ответа ошибки обрезают до
 `TRACKER_ERROR_BODY_MAX` (300 символов) и маскируют; 404 с `missingIsIssue` — `unknown_issue`, а не «неверный
@@ -566,6 +579,65 @@ for (;;) {
 (дочитывание по курсору), `keep: { bytes, from: 'head' | 'tail' }` удерживает окно кольцевым буфером,
 `readMax` и `timeoutMs` перекрывают потолки по умолчанию. Модель лога — запись D-006.
 
+### Репозиторий: карточка и ветки
+
+Карточка репозитория и список веток — раздел `repo` того же `TrackerDefinition`, на том же подключении, что и
+задачи (D-005, D-008): возможности `RepoCapabilities` плюс фабрика `create(context)` на том же `AdapterContext`.
+Раздел строят фабрики `githubRepo()`, `gitlabRepo()` и `sourcecraftRepo()`; у локального трекера и Jira его нет,
+и `repoAdapterOf(definition, context)` для них бросает `TrackerError('unsupported', 'Трекер <title> не ведёт
+репозиторий.')`, не сделав ни одного запроса.
+
+```ts
+import { findTracker, repoAdapterOf } from '@smwb/onreel-git-mcp/tracker';
+
+const definition = findTracker('github');
+if (definition === undefined) throw new Error('Встроенные адаптеры не зарегистрированы');
+const repo = repoAdapterOf(definition, context);
+
+const card = await repo.get(); // Repo: имя, ветка по умолчанию, описание, видимость, ссылки
+console.log(card.name, card.defaultBranch ?? '—', card.visibility ?? '—');
+
+// Ветки для диалога «Новый PR»: страница с курсором трекера и единственный фильтр search.
+const page = await repo.branches({ limit: 50, search: 'onreel/' });
+for (const branch of page.items) console.log(branch.name, branch.sha ?? '?', branch.protected === true);
+```
+
+`RepoAdapter` — два метода. `get()` отдаёт карточку `Repo` (`repoSchema`): `name` — имя репозитория, как его
+называет трекер (GitHub `name`, GitLab `name` проекта, SourceCraft `slug`), необязательные `defaultBranch`
+(у пустого репозитория её нет), `description` и `visibility` (`repoVisibilitySchema` — `public`, `internal`,
+`private`; значение трекера вне перечисления поле не заполняет), `links` — страница репозитория в трекере первой.
+`branches(BranchQuery)` отдаёт страницу `Branch` (`branchSchema`): `name` — имя ветки без `refs/heads/`,
+необязательные `sha` её головы, `protected` и `isDefault`.
+
+Единственный фильтр списка — `search` (подстрока имени ветки), сортировки нет. Возможности описывает
+`RepoCapabilities.branches` как у других списков (D-004): фильтр вне них — отказ `unsupported` до запроса
+(R-002), `limit` вне целых от 1 и пустой `search` — `invalid_request` тоже до запроса. У GitHub параметра поиска
+в `/branches` нет, поэтому `search` попадает в `clientSide` и проверяется по полученной странице: страница бывает
+короче `limit` и пустой при живом `nextCursor`. GitLab и SourceCraft фильтруют сервером (параметр `search` и
+`filter` соответственно), их `clientSide` пуст.
+
+GitLab читает `^` в начале и `$` в конце `search` как якоря, а `*` — как шаблон, тогда как единая модель обещает
+подстроку. Адаптер снимает эти якоря, и `search: '^rel'` уходит как `rel` — так же, как у GitHub и SourceCraft.
+Экранировать якоря нельзя: `\^` GitLab ищет буквально и не находит ничего. `*` остаётся шаблоном GitLab — в имени
+ветки git её не бывает.
+
+| Трекер | Карточка | Ветки | `search` | Курсор страницы | `protected` | `isDefault` |
+|---|---|---|---|---|---|---|
+| GitHub | `GET /repos/{owner}/{repo}` | `GET /repos/{owner}/{repo}/branches` | на странице | номер страницы по `Link` | да | — |
+| GitLab | `GET /api/v4/projects/{id}` | `GET /api/v4/projects/{id}/repository/branches` | параметр сервера, якоря снимаются | `x-next-page` | да | да (`default`) |
+| SourceCraft | `GET /repos/{org}/{repo}` | `GET /repos/{org}/{repo}/branches` | параметр `filter` | `next_page_token` | — | — |
+
+Список веток GitHub не отдаёт признак ветки по умолчанию, а список веток SourceCraft — ни его, ни признак
+защиты: ветку по умолчанию потребитель читает из карточки (`Repo.defaultBranch`), а не из элементов списка.
+Как и у других списков, `limit` выше потолка вернёт страницу размером потолка; потолок есть и у SourceCraft —
+100, но её `page_size` сверх него площадка отклоняет с 400, поэтому адаптер урезает его до потолка сам.
+
+Публичные символы раздела — схемы `repoSchema`, `branchSchema`, `repoVisibilitySchema` и `branchFilterSchema`
+с выведенными типами `Repo`, `Branch`, `RepoVisibility` и `BranchFilter`; типы `BranchQuery`, `RepoAdapter`,
+`RepoCapabilities` и `RepoDefinition`; помощник `repoAdapterOf` и фабрики разделов `githubRepo()`,
+`gitlabRepo()` и `sourcecraftRepo()`. Всё это выходит из субпути `…/tracker` — нового субпути нет (D-001, D-005).
+За модель отвечает запись D-008, отказ до запроса — правило R-002.
+
 ## mcp
 
 `serveMcp` — построчный JSON-RPC 2.0 на stdio, только инструменты: `initialize`, `ping`, `tools/list`,
@@ -712,7 +784,7 @@ console.log(manifest.name, manifest.version);
   и пустая строка убирают значение. Наружу из хранилища выходит только признак «токен есть» (`hasTrackerToken`),
   а при чтении и записи значение регистрируется в приёмнике секретов.
 - **Токен — только своему origin.** `origin(connection)` в `TrackerDefinition` — origin API, куда адаптер (и его
-  разделы `pulls` и `ci`) ходит с токеном: `https://api.github.com`, `https://gitlab.com`,
+  разделы `pulls`, `ci` и `repo`) ходит с токеном: `https://api.github.com`, `https://gitlab.com`,
   `https://api.sourcecraft.tech` по умолчанию, иначе origin `url` подключения; у Jira `url` обязателен. Потребитель
   привязывает к нему введённый токен: после правки `url` на другой origin токен спрашивают заново. Неверное
   подключение — `TrackerError('invalid_request')`, как у `create`. Встроенные адаптеры передают этот origin в
@@ -751,8 +823,10 @@ console.log(manifest.name, manifest.version);
   их не нужно править в потребителе.
 - `sideEffects: false`, один рантайм-зависимый пакет — `zod`.
 - Реестр трекеров, пул git, замки worktree и redactor — модульная глобальна на процесс: несколько независимых
-  «хостов» в одном процессе делят их. Запросы к внешним API идут `fetch` из контекста; узлы без TLS-цепей
-  внешнего трекера — задача вызывающего.
+  «хостов» в одном процессе делят их. Субпути пакета делят такое состояние, потому что модуль двух и более точек
+  входа tsup выносит в общий chunk; свою копию дал бы только бандл без splitting — инвариант одного определения
+  в собранном пакете держит проверка (D-013). Две независимо установленные копии пакета состояние не делят.
+  Запросы к внешним API идут `fetch` из контекста; узлы без TLS-цепей внешнего трекера — задача вызывающего.
 - Имена `ONREEL_*` и `HOST_CONTRACT_VERSION` (`1.14`) заморожены: они держат interop с onreel.
 
 ## Как внести изменение

package/dist/index.js

@@ -59,7 +59,7 @@ import {
 // package.json
 var package_default = {
   name: "@smwb/onreel-git-mcp",
-  version: "0.9.0",
+  version: "0.10.1",
   description: "\u0411\u0438\u0431\u043B\u0438\u043E\u0442\u0435\u043A\u0430 \u043C\u043E\u0434\u0443\u043B\u0435\u0439, \u0432\u044B\u0434\u0435\u043B\u0435\u043D\u043D\u044B\u0445 \u0438\u0437 onreel: git-\u043E\u043F\u0435\u0440\u0430\u0446\u0438\u0438 \u0438 \u0431\u0435\u0437\u043E\u043F\u0430\u0441\u043D\u044B\u0435 \u043F\u0443\u0442\u0438, \u0441\u043F\u0438\u0441\u043E\u043A \u0444\u0430\u0439\u043B\u043E\u0432 worktree, \u0436\u0438\u0437\u043D\u0435\u043D\u043D\u044B\u0439 \u0446\u0438\u043A\u043B worktree \u043F\u0440\u043E\u0442\u0438\u0432 \u043F\u043E\u0440\u0442\u0430 WorktreeStore, \u0430\u0434\u0430\u043F\u0442\u0435\u0440\u044B \u0442\u0440\u0435\u043A\u0435\u0440\u043E\u0432 GitHub/GitLab/Jira/SourceCraft/\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u0433\u043E \u0438 MCP-\u0441\u0435\u0440\u0432\u0435\u0440 \u043D\u0430 stdio",
   keywords: [
     "git",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@smwb/onreel-git-mcp\",\n  \"version\": \"0.9.0\",\n  \"description\": \"Библиотека модулей, выделенных из onreel: git-операции и безопасные пути, список файлов worktree, жизненный цикл worktree против порта WorktreeStore, адаптеры трекеров GitHub/GitLab/Jira/SourceCraft/локального и MCP-сервер на stdio\",\n  \"keywords\": [\n    \"git\",\n    \"worktree\",\n    \"mcp\",\n    \"issue-tracker\",\n    \"github\",\n    \"gitlab\",\n    \"jira\",\n    \"sourcecraft\",\n    \"onreel\",\n    \"typescript\"\n  ],\n  \"type\": \"module\",\n  \"engines\": {\n    \"node\": \">=24\"\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"sideEffects\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"registry\": \"https://registry.npmjs.org/\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://git.sourcecraft.dev/elfenmail/onreel-git-mcp.git\"\n  },\n  \"homepage\": \"https://git.sourcecraft.dev/elfenmail/onreel-git-mcp\",\n  \"license\": \"MIT\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./git\": {\n      \"types\": \"./dist/git/index.d.ts\",\n      \"import\": \"./dist/git/index.js\",\n      \"default\": \"./dist/git/index.js\"\n    },\n    \"./files\": {\n      \"types\": \"./dist/files/index.d.ts\",\n      \"import\": \"./dist/files/index.js\",\n      \"default\": \"./dist/files/index.js\"\n    },\n    \"./worktree\": {\n      \"types\": \"./dist/worktree/index.d.ts\",\n      \"import\": \"./dist/worktree/index.js\",\n      \"default\": \"./dist/worktree/index.js\"\n    },\n    \"./tracker\": {\n      \"types\": \"./dist/tracker/index.d.ts\",\n      \"import\": \"./dist/tracker/index.js\",\n      \"default\": \"./dist/tracker/index.js\"\n    },\n    \"./mcp\": {\n      \"types\": \"./dist/mcp/index.d.ts\",\n      \"import\": \"./dist/mcp/index.js\",\n      \"default\": \"./dist/mcp/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup && tsc -p tsconfig.build.json\",\n    \"typecheck\": \"tsc -p tsconfig.json && tsc -p tsconfig.examples.json\",\n    \"lint\": \"oxlint --type-aware\",\n    \"test\": \"node --test \\\"test/**/*.test.ts\\\"\",\n    \"changeset\": \"changeset\",\n    \"version\": \"changeset version\",\n    \"release\": \"npm run build && changeset publish\"\n  },\n  \"dependencies\": {\n    \"zod\": \"^4.6.5\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"2.29.2\",\n    \"@types/node\": \"24.19.1\",\n    \"oxlint\": \"1.87.0\",\n    \"oxlint-tsgolint\": \"7.0.2003\",\n    \"tsup\": \"8.5.1\",\n    \"typescript\": \"7.0.2\"\n  }\n}\n","// Корневой подпуть пакета @smwb/onreel-git-mcp: срез контракта (константы, схемы, типы, чистые\n// функции) и версия пакета. Всё без побочных эффектов при импорте (R-001). Швы ядра\n// (SecretSink, WorktreeStore, LocalIssueStore) и модули git/files/worktree/tracker/mcp\n// экспортируют свои подпути — см. exports в package.json и README.\nimport pkg from '../package.json' with { type: 'json' };\n\nexport * from './contract/contract.const.ts';\nexport * from './contract/contract.schema.ts';\nexport * from './contract/contract.types.ts';\nexport * from './contract/contract.lib.ts';\n\n// Версия пакета — из version в package.json: статический импорт JSON, его значение tsup подставляет\n// в бандл на сборке, поэтому VERSION не расходится с релизом changesets (тот правит только version).\nexport const VERSION: string = pkg.version;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,aAAe;AAAA,EACf,UAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,MAAQ;AAAA,EACR,SAAW;AAAA,IACT,MAAQ;AAAA,EACV;AAAA,EACA,OAAS;AAAA,IACP;AAAA,EACF;AAAA,EACA,aAAe;AAAA,EACf,eAAiB;AAAA,IACf,QAAU;AAAA,IACV,UAAY;AAAA,EACd;AAAA,EACA,YAAc;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,EACT;AAAA,EACA,UAAY;AAAA,EACZ,SAAW;AAAA,EACX,SAAW;AAAA,IACT,KAAK;AAAA,MACH,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,SAAS;AAAA,MACP,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,WAAW;AAAA,MACT,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,cAAc;AAAA,MACZ,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,aAAa;AAAA,MACX,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,SAAS;AAAA,MACP,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,kBAAkB;AAAA,EACpB;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,WAAa;AAAA,IACb,MAAQ;AAAA,IACR,MAAQ;AAAA,IACR,WAAa;AAAA,IACb,SAAW;AAAA,IACX,SAAW;AAAA,EACb;AAAA,EACA,cAAgB;AAAA,IACd,KAAO;AAAA,EACT;AAAA,EACA,iBAAmB;AAAA,IACjB,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,QAAU;AAAA,IACV,mBAAmB;AAAA,IACnB,MAAQ;AAAA,IACR,YAAc;AAAA,EAChB;AACF;;;AC1EO,IAAM,UAAkB,gBAAI;","names":[]}
+{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@smwb/onreel-git-mcp\",\n  \"version\": \"0.10.1\",\n  \"description\": \"Библиотека модулей, выделенных из onreel: git-операции и безопасные пути, список файлов worktree, жизненный цикл worktree против порта WorktreeStore, адаптеры трекеров GitHub/GitLab/Jira/SourceCraft/локального и MCP-сервер на stdio\",\n  \"keywords\": [\n    \"git\",\n    \"worktree\",\n    \"mcp\",\n    \"issue-tracker\",\n    \"github\",\n    \"gitlab\",\n    \"jira\",\n    \"sourcecraft\",\n    \"onreel\",\n    \"typescript\"\n  ],\n  \"type\": \"module\",\n  \"engines\": {\n    \"node\": \">=24\"\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"sideEffects\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"registry\": \"https://registry.npmjs.org/\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://git.sourcecraft.dev/elfenmail/onreel-git-mcp.git\"\n  },\n  \"homepage\": \"https://git.sourcecraft.dev/elfenmail/onreel-git-mcp\",\n  \"license\": \"MIT\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./git\": {\n      \"types\": \"./dist/git/index.d.ts\",\n      \"import\": \"./dist/git/index.js\",\n      \"default\": \"./dist/git/index.js\"\n    },\n    \"./files\": {\n      \"types\": \"./dist/files/index.d.ts\",\n      \"import\": \"./dist/files/index.js\",\n      \"default\": \"./dist/files/index.js\"\n    },\n    \"./worktree\": {\n      \"types\": \"./dist/worktree/index.d.ts\",\n      \"import\": \"./dist/worktree/index.js\",\n      \"default\": \"./dist/worktree/index.js\"\n    },\n    \"./tracker\": {\n      \"types\": \"./dist/tracker/index.d.ts\",\n      \"import\": \"./dist/tracker/index.js\",\n      \"default\": \"./dist/tracker/index.js\"\n    },\n    \"./mcp\": {\n      \"types\": \"./dist/mcp/index.d.ts\",\n      \"import\": \"./dist/mcp/index.js\",\n      \"default\": \"./dist/mcp/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup && tsc -p tsconfig.build.json\",\n    \"typecheck\": \"tsc -p tsconfig.json && tsc -p tsconfig.examples.json\",\n    \"lint\": \"oxlint --type-aware\",\n    \"test\": \"node --test \\\"test/**/*.test.ts\\\"\",\n    \"changeset\": \"changeset\",\n    \"version\": \"changeset version\",\n    \"release\": \"npm run build && changeset publish\"\n  },\n  \"dependencies\": {\n    \"zod\": \"^4.6.5\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"2.29.2\",\n    \"@types/node\": \"24.19.1\",\n    \"oxlint\": \"1.87.0\",\n    \"oxlint-tsgolint\": \"7.0.2003\",\n    \"tsup\": \"8.5.1\",\n    \"typescript\": \"7.0.2\"\n  }\n}\n","// Корневой подпуть пакета @smwb/onreel-git-mcp: срез контракта (константы, схемы, типы, чистые\n// функции) и версия пакета. Всё без побочных эффектов при импорте (R-001). Швы ядра\n// (SecretSink, WorktreeStore, LocalIssueStore) и модули git/files/worktree/tracker/mcp\n// экспортируют свои подпути — см. exports в package.json и README.\nimport pkg from '../package.json' with { type: 'json' };\n\nexport * from './contract/contract.const.ts';\nexport * from './contract/contract.schema.ts';\nexport * from './contract/contract.types.ts';\nexport * from './contract/contract.lib.ts';\n\n// Версия пакета — из version в package.json: статический импорт JSON, его значение tsup подставляет\n// в бандл на сборке, поэтому VERSION не расходится с релизом changesets (тот правит только version).\nexport const VERSION: string = pkg.version;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,aAAe;AAAA,EACf,UAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,MAAQ;AAAA,EACR,SAAW;AAAA,IACT,MAAQ;AAAA,EACV;AAAA,EACA,OAAS;AAAA,IACP;AAAA,EACF;AAAA,EACA,aAAe;AAAA,EACf,eAAiB;AAAA,IACf,QAAU;AAAA,IACV,UAAY;AAAA,EACd;AAAA,EACA,YAAc;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,EACT;AAAA,EACA,UAAY;AAAA,EACZ,SAAW;AAAA,EACX,SAAW;AAAA,IACT,KAAK;AAAA,MACH,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,SAAS;AAAA,MACP,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,WAAW;AAAA,MACT,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,cAAc;AAAA,MACZ,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,aAAa;AAAA,MACX,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,SAAS;AAAA,MACP,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,kBAAkB;AAAA,EACpB;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,WAAa;AAAA,IACb,MAAQ;AAAA,IACR,MAAQ;AAAA,IACR,WAAa;AAAA,IACb,SAAW;AAAA,IACX,SAAW;AAAA,EACb;AAAA,EACA,cAAgB;AAAA,IACd,KAAO;AAAA,EACT;AAAA,EACA,iBAAmB;AAAA,IACjB,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,QAAU;AAAA,IACV,mBAAmB;AAAA,IACnB,MAAQ;AAAA,IACR,YAAc;AAAA,EAChB;AACF;;;AC1EO,IAAM,UAAkB,gBAAI;","names":[]}

package/dist/kernel/store.types.d.ts

@@ -1,6 +1,10 @@
 import type { IssuePriority, IssueStatusCategory, Worktree, WorktreeStatus } from '../contract/contract.types.ts';
 /** Контекст записи: кто и когда; без них реализация берёт текущее время и не пишет actor. */
 export type WorktreeWriteContext = {
+    /**
+     * Кто сделал переход. Собственные переходы библиотека пишет с actor `'host'` — процесс, который
+     * её держит (D-012); реализация потребителя отображает это значение в свою лексику.
+     */
     actor?: string | undefined;
     ts?: number | undefined;
 };
@@ -48,7 +52,13 @@ export type WorktreeStore = {
     /** Ready worktree терминальных задач без живых сессий — их чистит reconciler. */
     readyWorktreesOfSettledTasks(): Worktree[];
 };
-/** Пагинация списков: всё скоупится и листается страницами, без неограниченных выборок. */
+/**
+ * Пагинация списков: всё скоупится и листается страницами, без неограниченных выборок.
+ * `limit` — целое от 1 до 500 (по умолчанию 100): значение вне диапазона реализация прижимает
+ * к границам. Нецелое значение до хранилища не доходит — адаптер отказывает `invalid_request`
+ * ещё в проверке запроса, поэтому код отказа реализации порта не предписан: эталон в памяти
+ * отвечает `invalid_request`, ledger падает ошибкой SQLite.
+ */
 export type PageInput = {
     limit?: number | undefined;
     cursor?: string | undefined;
@@ -102,8 +112,12 @@ export type LocalIssueStore = {
     createLocalIssue(projectId: string, input: NewLocalIssue, ts?: number): LocalIssueRow;
     getLocalIssue(projectId: string, number: number): LocalIssueRow | undefined;
     listLocalIssues(projectId: string, input?: ListLocalIssuesInput): Page<LocalIssueRow>;
-    /** Нет задачи — undefined. */
+    /** Нет задачи — undefined. `assignee: null` снимает исполнителя и убирает ключ из строки. */
     updateLocalIssue(projectId: string, number: number, patch: LocalIssuePatch, ts?: number): LocalIssueRow | undefined;
+    /**
+     * Комментарий к существующей задаче: задачи нет — отказ с кодом `unknown_issue`, сиротных
+     * комментариев порт не хранит (D-011).
+     */
     addLocalComment(projectId: string, number: number, body: string, author?: string, ts?: number): LocalCommentRow;
     listLocalComments(projectId: string, number: number, input?: PageInput): Page<LocalCommentRow>;
 };

package/dist/tracker/github-repo.lib.d.ts

@@ -0,0 +1,2 @@
+import type { RepoDefinition } from './repo.types.ts';
+export declare function githubRepo(): RepoDefinition;

package/dist/tracker/gitlab-repo.lib.d.ts

@@ -0,0 +1,2 @@
+import type { RepoDefinition } from './repo.types.ts';
+export declare function gitlabRepo(): RepoDefinition;

package/dist/tracker/index.d.ts

@@ -23,5 +23,11 @@ export * from './pull.lib.ts';
 export * from './github-pull.lib.ts';
 export * from './gitlab-pull.lib.ts';
 export * from './sourcecraft-pull.lib.ts';
+export * from './repo.schema.ts';
+export * from './repo.types.ts';
+export * from './repo.lib.ts';
+export * from './github-repo.lib.ts';
+export * from './gitlab-repo.lib.ts';
+export * from './sourcecraft-repo.lib.ts';
 export type { ListLocalIssuesInput, LocalCommentRow, LocalIssuePatch, LocalIssueRow, LocalIssueStore, NewLocalIssue, Page, PageInput, WorktreeCleanupFlags, WorktreeCleanupInput, WorktreeStore, WorktreeTx, WorktreeWriteContext, } from '../kernel/store.types.ts';
 export type { SecretSink } from '../kernel/log.types.ts';