@smwb/onreel-git-mcp 0.4.0 → 0.5.0

package/README.md

@@ -425,6 +425,141 @@ PUT, GitHub — PATCH, SourceCraft не дёргает эндпоинт сост
 `githubPulls()`, `gitlabPulls()` и `sourcecraftPulls()`. Всё это выходит из субпути `…/tracker` — нового субпути
 нет (D-001, D-005). За модель отвечают таблицы сопоставления и запись D-005, отказ до запроса — правило R-002.
 
+### CI
+
+Прогоны CI — необязательный раздел `ci` того же `TrackerDefinition`, на том же подключении, что задачи (D-005):
+возможности `CiCapabilities` плюс фабрика `create(context)` на том же `AdapterContext`. Раздел строят фабрики
+`githubCi()`, `gitlabCi()` и `sourcecraftCi()`; у локального трекера и Jira раздела нет. Адаптер раздела —
+`ciAdapterOf(definition, context)`; у трекера без `ci` это `TrackerError('unsupported', 'Трекер <title> не ведёт CI.')`.
+`CiAdapter` умеет: `listWorkflows`, `listRuns`, `getRun`, `listJobs`, `getJob`, `log`, `trigger`, `rerun`,
+`rerunJob`, `cancel`, `cancelJob`. Каждый возвращённый объект проходит parse своей схемы zod (`ciWorkflowSchema`,
+`ciRunSchema`, `ciJobSchema`, `ciLogSchema`); состояние — категория `CiStatusCategory` (`queued`, `running`,
+`waiting`, `success`, `failed`, `canceled`, `skipped`) плюс сырое имя трекера в `status.name`, событие —
+категория `CiEventCategory` плюс сырое имя. Метод вне возможностей своего трекера — отказ `unsupported`
+**до запроса**.
+
+Сопоставление сырых статусов и событий с единой моделью — открытые таблицы, как у задач, чтобы потребитель
+видел, во что именно преводится значение его трекера. Правила для неизвестного: статус → `running` (прогон
+ещё не закончен, и тот, кто ждёт конца, продолжает опрос), законченный прогон GitHub с незнакомым
+`conclusion` → `failed` (незнакомое заключение не бывает зелёным), событие → `other`.
+
+GitHub Actions (`GITHUB_RUN_STATUSES` — `status`, пока он не `completed`; `GITHUB_RUN_CONCLUSIONS` —
+`conclusion` при `status: completed`; `GITHUB_RUN_EVENTS` — `event` прогона):
+
+- `queued`/`requested`/`pending` → `queued`, `waiting` → `waiting`, `in_progress` → `running`;
+- `success`/`neutral` → `success`, `failure`/`timed_out`/`startup_failure` → `failed`,
+  `cancelled`/`stale` → `canceled`, `skipped` → `skipped`, `action_required` → `waiting`;
+- `push` → `push`, `pull_request`/`pull_request_target`/`merge_group` → `pull_request`,
+  `workflow_dispatch` → `manual`, `schedule` → `schedule`,
+  `repository_dispatch`/`workflow_run`/`workflow_call` → `trigger`.
+
+GitLab (`GITLAB_CI_STATUSES` — `status` пайплайна и задания; `GITLAB_PIPELINE_SOURCES` — `source` пайплайна):
+
+- `created`/`waiting_for_resource`/`preparing`/`pending` → `queued`, `running`/`canceling` → `running`,
+  `waiting_for_callback`/`manual`/`scheduled` → `waiting`, `success`/`failed`/`canceled`/`skipped` →
+  одноимённые категории;
+- `push` → `push`, `merge_request_event`/`external_pull_request_event` → `pull_request`,
+  `web`/`api`/`chat`/`webide` → `manual`, `schedule`/`pipeline_execution_policy_schedule` → `schedule`,
+  `trigger`/`pipeline`/`parent_pipeline` → `trigger`.
+
+SourceCraft (`SOURCECRAFT_CI_STATUSES` — `status` прогона, workflow, задачи и куба; `SOURCECRAFT_RUN_EVENTS`
+— `event_type` прогона):
+
+- `created`/`prepared` → `queued`, `processing` → `running`, `awaiting_approval` → `waiting`,
+  `success`/`failed`/`skipped` → одноимённые, `timeout` → `failed`, `canceled`/`rejected` → `canceled`;
+- `push` → `push`, `pr_update` → `pull_request`, `manual` → `manual`, `restart` → `retry`,
+  `schedule` → `schedule`, `repository_event` → `trigger`.
+
+Что умеет каждый трекер, описывает раздел `ci` определения (R11 — все фильтры `ciRunFilterSchema`: `status`,
+`ref`, `sha`, `event`, `workflow`, `actor`, `pullRequest`, `createdAfter`, `createdBefore`, `updatedAfter`,
+`updatedBefore`):
+
+| Поле | GitHub Actions | GitLab | SourceCraft |
+|---|---|---|---|
+| `workflows` | да (`listWorkflows`) | нет | нет |
+| `runs.filters` | все | все | кроме `ref` и `sha` |
+| `runs.clientSide` | `status`, `event`, `updatedAfter`, `updatedBefore` | `status`, `event` | все фильтры |
+| `runs.sorts` | — | `created`, `updated` | — |
+| `jobs` | фильтры `status`, `allAttempts`; `status` на странице | фильтры `status`, `allAttempts` | фильтр `status`; `status` на странице |
+| `log` | `live: false`, курсор есть | `live: true`, курсор есть | `live: true`, курсор есть |
+| `trigger` | ровно один workflow, `inputs`, теги | без workflow, `inputs`, теги | хотя бы один workflow, `inputs`, теги |
+| `rerun` | всё, включая задание и `debug` | только `failedOnly` и задание | не поддерживается |
+| `cancel` | прогон | прогон и задание | не поддерживается |
+
+Запросы списков — `CiRunQuery` (`PageQuery` плюс фильтры из таблицы и `sort` по `created`/`updated`) и
+`CiJobQuery` (`status`, `allAttempts` — задания прежних попыток); имена допустимых фильтров и полей сортировки
+выведены в типы `CiRunFilter`, `CiRunSortField` и `CiJobFilter` из схем `ciRunFilterSchema`,
+`ciRunSortFieldSchema` и `ciJobFilterSchema` — теми же перечислениями оперирует `CiCapabilities`. У GitLab
+список прогонов с `pullRequest` идёт через пайплайны MR: остальные фильтры тогда проверяются по странице.
+Запуск — `CiTriggerInput` (`ref`,
+`refType`, `workflows`, `inputs`): у GitHub ровно один workflow (иначе `invalid_request`, входов не больше 25),
+у GitLab `workflows` не задаётся (непустой — `unsupported`), у SourceCraft нужен хотя бы один workflow.
+`rerun`/`rerunJob` возвращают свежее состояние прогона, `cancel`/`cancelJob` — свежее состояние (оно может быть
+ещё `running`).
+
+**Лог окном с курсором (D-006).** `log(jobKey, CiLogQuery)` читает лог задания окном: `maxBytes` от 1 до
+`CI_LOG_MAX_BYTES` (1 МиБ), по умолчанию `CI_LOG_DEFAULT_BYTES` (16 КиБ) — конец лога, где обычно причина
+падения; `from: 'head'` — начало. Тело читается потоком до `CI_LOG_READ_MAX_BYTES` (64 МиБ), удерживается
+кольцевым буфером, таймаут загрузки — `CI_LOG_TIMEOUT_MS` (60 с). ANSI-последовательности и перерисовки
+строки вычищаются (`cleanLogText`), если не `raw: true`; маскирование секретов идёт всегда. Ответ `CiLog`:
+`text` (окно), `truncated`, `complete` (задание закончилось), `size` (если тело прочитано целиком) и
+`nextCursor` — его нет, когда дальше не будет ни байта. Курсор — `c:<страница>:<байт>` (`logCursor`); страница
+0 у GitHub и GitLab, у SourceCraft — номер страницы его пагинации (за один вызов читается до
+`CI_LOG_PAGES_MAX` страниц). Окно из запроса разбирает `logWindow(query)`, ответ собирает `logOf(...)`;
+`isFinished(category)` — категория из `CI_FINISHED_STATUSES`.
+
+**Края окна — по целым строкам.** Секрет или ANSI-последовательность, разрезанные краем окна, не узнаются ни в
+одном из окон, а два склеенных ответа отдают их целиком — поэтому окно выравнивается по строкам внутри
+`logOf`: окно с курсором кончается после последнего `\n` (курсор указывает на начало следующей строки), а окно
+с отрезанным началом — флаг `startCut: true`, по умолчанию `truncated && !more` — начинается после первого
+`\n`. Строка длиннее окна режется по слову: конец — перед последним словом вместе с ключом присваивания перед
+ним, начало — после первого пробела; без пробелов окно режется по байту, и тогда откладываются незаконченная
+ANSI-последовательность и `\r`. Отдельно добирается хвост приватного ключа: `logOf` маскирует строки тела PEM,
+на которых окно начинается, и откладёт строку `-----BEGIN … PRIVATE KEY-----`, если парного `END` в этом окне
+нет. Так замаскированный и очищенный текст склеенных окон совпадает с текстом лога, прочитанного целиком, а
+`nextCursor` уходит на начало следующей строки — кроме случая, когда окно упёрлось в потолок `maxBytes`
+посреди единственной строки длиннее окна либо в границу страницы SourceCraft.
+
+Дочитывание лога идущего задания — поллинг по `nextCursor`:
+
+```ts
+let cursor: string | undefined;
+for (;;) {
+  const chunk = await ci.log(job.key, cursor === undefined ? {} : { cursor });
+  process.stdout.write(chunk.text);
+  cursor = chunk.nextCursor;
+  if (cursor === undefined) break;
+  await new Promise((resolve) => setTimeout(resolve, 5000));
+}
+```
+
+Пределы трекеров: у GitHub лог задания доступен **только после завершения** (`log.live: false`): идущему
+заданию отвечают пустым текстом и курсором `c:0:0`, не скачивая ничего. Сам лог GitHub отдаёт 302 на
+подписанный URL (живёт около минуты) — `fetch` в контексте должен следовать редиректам. У SourceCraft нет
+перезапуска и отмены (`rerun`/`cancel` — `unsupported`), а `listJobs` стоит 1 + N запросов (прогон и каждый
+его workflow); список прогонов не фильтрует сервером вообще — все фильтры на странице, листайте `nextCursor`.
+Логи служебных кубов прогона (`#git-clone`, `#create-environment`) через API не читаются: слаг с `#`
+площадка не принимает (400 на шаблон имени), а без `#` куб не находится, поэтому `log()` на таком задании —
+`unsupported` **до запроса**; в `listJobs` эти кубы остаются. Хвост SourceCraft дочитывает не больше
+`CI_LOG_PAGES_MAX` страниц за вызов: у более длинного лога это конец первой прочитанной пачки, а не всего
+лога — остальное добирается по `nextCursor`.
+
+Символы субпути: фабрики `githubCi()`, `gitlabCi()`, `sourcecraftCi()`, `ciAdapterOf`, типы `CiAdapter`,
+`CiCapabilities`, `CiDefinition`, `CiWorkflow`, `CiRun`, `CiJob`, `CiLog`, `CiStatus`, `CiStatusCategory`,
+`CiEventCategory`, `CiRunQuery`, `CiJobQuery`, `CiLogQuery`, `CiLogWindow`, `CiTriggerInput`,
+`CiTriggerResult`, `CiRerunInput`, `CiJobRerunInput`, наборы значений запроса — типы `CiRunFilter`,
+`CiRunSortField`, `CiJobFilter`, схемы `ciStatusCategorySchema`, `ciEventCategorySchema`,
+`ciRunFilterSchema`, `ciRunSortFieldSchema`, `ciJobFilterSchema`, `ciStatusSchema`, `ciWorkflowSchema`,
+`ciRunSchema`, `ciJobSchema`, `ciLogSchema`, помощники `logWindow`, `logCursor`, `logOf` (у его входа —
+необязательное поле `startCut`: начало окна отрезано краем, первая неполная строка отбрасывается),
+`cleanLogText`, `isFinished` и константы `CI_LOG_DEFAULT_BYTES`, `CI_LOG_MAX_BYTES`, `CI_LOG_READ_MAX_BYTES`,
+`CI_LOG_TIMEOUT_MS`, `CI_LOG_PAGES_MAX`, `CI_FINISHED_STATUSES`. Таблицы сопоставления — `GITHUB_RUN_STATUSES`,
+`GITHUB_RUN_CONCLUSIONS`, `GITHUB_RUN_EVENTS`, `GITLAB_CI_STATUSES`, `GITLAB_PIPELINE_SOURCES`,
+`SOURCECRAFT_CI_STATUSES`, `SOURCECRAFT_RUN_EVENTS` (содержание — выше). Загрузку текста наружу держит
+`requestText(url, TextRequest): TextResponse` — тело читается потоком, `skip` пропускает байты от начала
+(дочитывание по курсору), `keep: { bytes, from: 'head' | 'tail' }` удерживает окно кольцевым буфером,
+`readMax` и `timeoutMs` перекрывают потолки по умолчанию. Модель лога — запись D-006.
+
 ## mcp
 
 `serveMcp` — построчный JSON-RPC 2.0 на stdio, только инструменты: `initialize`, `ping`, `tools/list`,

package/dist/{chunk-L7CPE2SO.js → chunk-AGGJK2XZ.js}

@@ -160,7 +160,8 @@ var defaultSecretSink = {
 };
 
 export {
+  REDACTED,
   redactSecretText,
   defaultSecretSink
 };
-//# sourceMappingURL=chunk-L7CPE2SO.js.map
+//# sourceMappingURL=chunk-AGGJK2XZ.js.map

package/dist/{chunk-GPRMI4PG.js → chunk-ZTME4HFD.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-3YP22YLA.js";
 import {
   redactSecretText
-} from "./chunk-L7CPE2SO.js";
+} from "./chunk-AGGJK2XZ.js";
 
 // src/git/git.const.ts
 var GIT_TIMEOUT_MS = 12e4;
@@ -418,4 +418,4 @@ export {
   showBlob,
   readWorktreeFile
 };
-//# sourceMappingURL=chunk-GPRMI4PG.js.map
+//# sourceMappingURL=chunk-ZTME4HFD.js.map

package/dist/git/index.js

@@ -25,7 +25,7 @@ import {
   showBlob,
   statusEntries,
   untrackedFiles
-} from "../chunk-GPRMI4PG.js";
+} from "../chunk-ZTME4HFD.js";
 import {
   PROJECT_WORKTREE_SEGMENT,
   PathEscapeError,
@@ -47,7 +47,7 @@ import "../chunk-3YP22YLA.js";
 import {
   defaultSecretSink,
   redactSecretText
-} from "../chunk-L7CPE2SO.js";
+} from "../chunk-AGGJK2XZ.js";
 import "../chunk-4ZGRXIVA.js";
 export {
   GIT_CHECKOUT_TIMEOUT_MS,

package/dist/index.js

@@ -59,7 +59,7 @@ import {
 // package.json
 var package_default = {
   name: "@smwb/onreel-git-mcp",
-  version: "0.4.0",
+  version: "0.5.0",
   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.4.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.5.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":[]}

package/dist/mcp/index.js

@@ -4,7 +4,7 @@ import {
 } from "../chunk-3YP22YLA.js";
 import {
   redactSecretText
-} from "../chunk-L7CPE2SO.js";
+} from "../chunk-AGGJK2XZ.js";
 import {
   ENV_DISPATCH_ID,
   ENV_HOST_URL,

package/dist/tracker/ci.lib.d.ts

@@ -0,0 +1,36 @@
+import type { CiLog, CiStatusCategory } from './ci.schema.ts';
+import type { CiAdapter, CiLogQuery, CiLogWindow } from './ci.types.ts';
+import type { AdapterContext, TrackerDefinition } from './tracker.types.ts';
+/** Адаптер CI трекера (D-005); трекер без раздела ci — TrackerError('unsupported', 'Трекер <title> не ведёт CI.'). */
+export declare function ciAdapterOf(definition: TrackerDefinition, context: AdapterContext): CiAdapter;
+/**
+ * Окно лога из запроса (D-006): maxBytes 1..CI_LOG_MAX_BYTES (по умолчанию CI_LOG_DEFAULT_BYTES), from по умолчанию tail,
+ * курсор `c:<страница>:<байт>` — в resume; иначе TrackerError('invalid_request').
+ */
+export declare function logWindow(query: CiLogQuery): CiLogWindow;
+/** Курсор дочитывания с места (страница, байт в ней): `c:<page>:<offset>`. */
+export declare function logCursor(page: number, offset: number): string;
+/**
+ * Лог единой модели из прочитанного окна: окно выравнивается по целым строкам (lineWindow), затем cleanLogText
+ * (если не raw), хвост приватного ключа из прошлого окна и redactSecretText — всегда. nextCursor = logCursor(page, end)
+ * со сдвигом end назад на отложенный конец окна, если задание не закончилось или окно head оборвалось раньше конца
+ * тела; иначе курсора нет. Окно, которое не сдвинулось (пусто при more: потолок чтения, символ шире окна), у законченного
+ * задания курсора не даёт — тот же курсор зациклил бы дочитывание. startCut — начало окна отрезано (хвост лога): первая
+ * неполная строка отбрасывается; по умолчанию truncated && !more — окно усечено, а дальше читать нечего.
+ * end — байт за окном на странице page; на эту страницу приходятся не больше end последних байт окна.
+ */
+export declare function logOf(input: {
+    text: string;
+    truncated: boolean;
+    complete: boolean;
+    page: number;
+    end: number;
+    more: boolean;
+    size?: number | undefined;
+    raw: boolean;
+    startCut?: boolean | undefined;
+}): CiLog;
+/** Текст лога без ANSI-последовательностей (CSI, OSC), перерисовок строки через \r и маркеров section_start/section_end GitLab. */
+export declare function cleanLogText(text: string): string;
+/** Категория законченного состояния: success, failed, canceled, skipped. */
+export declare function isFinished(category: CiStatusCategory): boolean;

package/dist/tracker/ci.schema.d.ts

@@ -0,0 +1,162 @@
+import { z } from 'zod';
+/** Категория состояния прогона, задания и шага CI единой модели (D-006); своё имя трекер отдаёт в status.name. */
+export declare const ciStatusCategorySchema: z.ZodEnum<{
+    canceled: "canceled";
+    failed: "failed";
+    queued: "queued";
+    running: "running";
+    skipped: "skipped";
+    success: "success";
+    waiting: "waiting";
+}>;
+/** Что запустило прогон; своё имя события трекер отдаёт в event.name. */
+export declare const ciEventCategorySchema: z.ZodEnum<{
+    manual: "manual";
+    other: "other";
+    pull_request: "pull_request";
+    push: "push";
+    retry: "retry";
+    schedule: "schedule";
+    trigger: "trigger";
+}>;
+export declare const ciRunFilterSchema: z.ZodEnum<{
+    actor: "actor";
+    createdAfter: "createdAfter";
+    createdBefore: "createdBefore";
+    event: "event";
+    pullRequest: "pullRequest";
+    ref: "ref";
+    sha: "sha";
+    status: "status";
+    updatedAfter: "updatedAfter";
+    updatedBefore: "updatedBefore";
+    workflow: "workflow";
+}>;
+export declare const ciRunSortFieldSchema: z.ZodEnum<{
+    created: "created";
+    updated: "updated";
+}>;
+export declare const ciJobFilterSchema: z.ZodEnum<{
+    allAttempts: "allAttempts";
+    status: "status";
+}>;
+export declare const ciStatusSchema: z.ZodObject<{
+    category: z.ZodEnum<{
+        canceled: "canceled";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        skipped: "skipped";
+        success: "success";
+        waiting: "waiting";
+    }>;
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const ciWorkflowSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const ciRunSchema: z.ZodObject<{
+    key: z.ZodString;
+    number: z.ZodOptional<z.ZodNumber>;
+    workflows: z.ZodArray<z.ZodString>;
+    status: z.ZodObject<{
+        category: z.ZodEnum<{
+            canceled: "canceled";
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            skipped: "skipped";
+            success: "success";
+            waiting: "waiting";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    event: z.ZodOptional<z.ZodObject<{
+        category: z.ZodEnum<{
+            manual: "manual";
+            other: "other";
+            pull_request: "pull_request";
+            push: "push";
+            retry: "retry";
+            schedule: "schedule";
+            trigger: "trigger";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    ref: z.ZodOptional<z.ZodString>;
+    sha: z.ZodOptional<z.ZodString>;
+    actor: z.ZodOptional<z.ZodString>;
+    pullRequest: z.ZodOptional<z.ZodString>;
+    attempt: z.ZodOptional<z.ZodNumber>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    links: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    finishedAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ciJobSchema: z.ZodObject<{
+    key: z.ZodString;
+    runKey: z.ZodString;
+    name: z.ZodString;
+    stage: z.ZodOptional<z.ZodString>;
+    status: z.ZodObject<{
+        category: z.ZodEnum<{
+            canceled: "canceled";
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            skipped: "skipped";
+            success: "success";
+            waiting: "waiting";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        number: z.ZodNumber;
+        name: z.ZodString;
+        status: z.ZodObject<{
+            category: z.ZodEnum<{
+                canceled: "canceled";
+                failed: "failed";
+                queued: "queued";
+                running: "running";
+                skipped: "skipped";
+                success: "success";
+                waiting: "waiting";
+            }>;
+            name: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    attempt: z.ZodOptional<z.ZodNumber>;
+    links: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    finishedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ciLogSchema: z.ZodObject<{
+    text: z.ZodString;
+    truncated: z.ZodBoolean;
+    complete: z.ZodBoolean;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CiStatusCategory = z.infer<typeof ciStatusCategorySchema>;
+export type CiEventCategory = z.infer<typeof ciEventCategorySchema>;
+export type CiRunFilter = z.infer<typeof ciRunFilterSchema>;
+export type CiRunSortField = z.infer<typeof ciRunSortFieldSchema>;
+export type CiJobFilter = z.infer<typeof ciJobFilterSchema>;
+export type CiStatus = z.infer<typeof ciStatusSchema>;
+export type CiWorkflow = z.infer<typeof ciWorkflowSchema>;
+export type CiRun = z.infer<typeof ciRunSchema>;
+export type CiJob = z.infer<typeof ciJobSchema>;
+export type CiLog = z.infer<typeof ciLogSchema>;

package/dist/tracker/ci.types.d.ts

@@ -0,0 +1,117 @@
+import type { CiEventCategory, CiJob, CiJobFilter, CiLog, CiRun, CiRunFilter, CiRunSortField, CiStatusCategory, CiWorkflow } from './ci.schema.ts';
+import type { AdapterContext, ListCapabilities, ListSort, PageQuery, TrackerPage } from './tracker.types.ts';
+export type CiRunQuery = PageQuery & {
+    status?: readonly CiStatusCategory[] | undefined;
+    /** Ветка или тег — имя без refs/heads/. */
+    ref?: string | undefined;
+    sha?: string | undefined;
+    event?: readonly CiEventCategory[] | undefined;
+    /** GitHub — id или имя файла workflow (`ci.yml`), GitLab — имя пайплайна, SourceCraft — имя workflow из конфига. */
+    workflow?: string | undefined;
+    /** Кто запустил — логин или slug трекера. */
+    actor?: string | undefined;
+    /** Ключ PR: прогоны для его головы. */
+    pullRequest?: string | undefined;
+    createdAfter?: number | undefined;
+    createdBefore?: number | undefined;
+    updatedAfter?: number | undefined;
+    updatedBefore?: number | undefined;
+    sort?: ListSort<CiRunSortField> | undefined;
+};
+export type CiJobQuery = PageQuery & {
+    status?: readonly CiStatusCategory[] | undefined;
+    /** И задания прежних попыток (GitHub filter=all, GitLab include_retried); по умолчанию — только последние. */
+    allAttempts?: boolean | undefined;
+};
+export type CiLogQuery = {
+    /**
+     * Сколько байт текста вернуть: 1..CI_LOG_MAX_BYTES, по умолчанию CI_LOG_DEFAULT_BYTES. Края окна выравниваются
+     * по целым строкам (секрет на краю не делится между окнами), поэтому текст бывает короче.
+     */
+    maxBytes?: number | undefined;
+    /** Без курсора: tail (по умолчанию) — конец лога, где обычно причина падения; head — начало. */
+    from?: 'head' | 'tail' | undefined;
+    /** nextCursor прошлого ответа: текст с этого места вперёд (дочитывание идущего задания); from тогда не читается. */
+    cursor?: string | undefined;
+    /** Не вычищать ANSI-последовательности и маркеры секций; секреты маскируются всегда. */
+    raw?: boolean | undefined;
+};
+/** Окно чтения лога после проверки запроса: resume — место курсора (страница и байт в ней; у GitHub и GitLab страница 0). */
+export type CiLogWindow = {
+    bytes: number;
+    from: 'head' | 'tail';
+    resume?: {
+        page: number;
+        offset: number;
+    } | undefined;
+};
+export type CiTriggerInput = {
+    /** Ветка или тег, на котором запустить. */
+    ref: string;
+    /** Что такое ref; по умолчанию branch (GitHub и GitLab определяют сами, SourceCraft — нет). */
+    refType?: 'branch' | 'tag' | undefined;
+    /** GitHub — ровно один (id или имя файла), SourceCraft — хотя бы один (имена из конфига), GitLab — не задаётся. */
+    workflows?: readonly string[] | undefined;
+    /** Параметры: GitHub inputs (не больше 25), SourceCraft values каждого workflow, GitLab — переменные пайплайна. */
+    inputs?: Readonly<Record<string, string>> | undefined;
+};
+/** run нет — трекер принял запуск, но не сказал, какой прогон создан. */
+export type CiTriggerResult = {
+    run?: CiRun | undefined;
+};
+export type CiRerunInput = {
+    /** Только упавшие задания и зависящие от них; GitLab умеет только так. */
+    failedOnly?: boolean | undefined;
+    /** Отладочное логирование (GitHub enable_debug_logging). */
+    debug?: boolean | undefined;
+};
+export type CiJobRerunInput = {
+    debug?: boolean | undefined;
+};
+export type CiAdapter = {
+    listWorkflows(query: PageQuery): Promise<TrackerPage<CiWorkflow>>;
+    listRuns(query: CiRunQuery): Promise<TrackerPage<CiRun>>;
+    getRun(key: string): Promise<CiRun>;
+    listJobs(runKey: string, query: CiJobQuery): Promise<TrackerPage<CiJob>>;
+    getJob(key: string): Promise<CiJob>;
+    log(jobKey: string, query: CiLogQuery): Promise<CiLog>;
+    trigger(input: CiTriggerInput): Promise<CiTriggerResult>;
+    /** Перезапуск прогона; вернётся его свежее состояние. */
+    rerun(runKey: string, input: CiRerunInput): Promise<CiRun>;
+    /** Перезапуск задания; вернётся свежее состояние прогона, в который оно попало. */
+    rerunJob(jobKey: string, input: CiJobRerunInput): Promise<CiRun>;
+    /** Отмена; вернётся свежее состояние (может быть ещё running). */
+    cancel(runKey: string): Promise<CiRun>;
+    cancelJob(jobKey: string): Promise<CiJob>;
+};
+export type CiCapabilities = {
+    workflows: boolean;
+    runs: ListCapabilities<CiRunFilter, CiRunSortField>;
+    jobs: ListCapabilities<CiJobFilter, never>;
+    /** live — лог идущего задания читается; cursor — дочитывание по nextCursor. */
+    log: {
+        live: boolean;
+        cursor: boolean;
+    };
+    trigger: {
+        supported: boolean;
+        workflows: 'one' | 'many' | 'none';
+        inputs: boolean;
+        tags: boolean;
+    };
+    rerun: {
+        all: boolean;
+        failedOnly: boolean;
+        job: boolean;
+        debug: boolean;
+    };
+    cancel: {
+        run: boolean;
+        job: boolean;
+    };
+};
+/** Раздел ci определения трекера (D-005): на том же подключении, что и задачи. */
+export type CiDefinition = {
+    capabilities: CiCapabilities;
+    create(context: AdapterContext): CiAdapter;
+};

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

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

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

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

package/dist/tracker/http.lib.d.ts

@@ -1,4 +1,12 @@
-import type { JsonRequest, JsonResponse } from './tracker.types.ts';
+import type { JsonRequest, JsonResponse, TextRequest, TextResponse } from './tracker.types.ts';
 export declare function requestJson(url: string, request: JsonRequest): Promise<JsonResponse>;
+/**
+ * Запрос текста (лог CI): тело читается потоком, в памяти — только окно keep после skip. head — первые keep.bytes,
+ * поток отменяется, как только окно набрано; tail — последние keep.bytes в кольцевом буфере. Чтение обрывается
+ * на readMax байт тела. Границы окна сдвигаются к целым символам UTF-8: начало — вперёд, конец — назад (и у тела,
+ * оборванного посреди символа). Отказ — как у requestJson: missing, rate_limited, failed с телом без секретов.
+ * fetch следует редиректам (302 GitHub на подписанный адрес); по спецификации fetch Authorization на чужой origin не уходит.
+ */
+export declare function requestText(url: string, request: TextRequest): Promise<TextResponse>;
 /** Базовый адрес без хвостовых слэшей; не http и не https — отказ подключения. */
 export declare function baseUrl(value: string | undefined, fallback: string): string;

package/dist/tracker/index.d.ts

@@ -3,6 +3,12 @@ export * from './tracker.types.ts';
 export * from './tracker.lib.ts';
 export * from './mapping.const.ts';
 export * from './http.lib.ts';
+export * from './ci.schema.ts';
+export * from './ci.types.ts';
+export * from './ci.lib.ts';
+export * from './github-ci.lib.ts';
+export * from './gitlab-ci.lib.ts';
+export * from './sourcecraft-ci.lib.ts';
 export * from './registry.lib.ts';
 export * from './builtin.lib.ts';
 export * from './secrets.lib.ts';