@smwb/onreel-git-mcp 0.3.0 → 0.5.0

package/dist/tracker/mapping.const.d.ts

@@ -1,4 +1,6 @@
 import type { IssuePriority, IssueStatusCategory } from '../contract/contract.types.ts';
+import type { CiEventCategory, CiStatusCategory } from './ci.schema.ts';
+import type { PullRequestStatusCategory } from './pull.schema.ts';
 /** SourceCraft: системные статусы. На паузе — ещё не закончено, но и не в работе: `open`. */
 export declare const SOURCECRAFT_STATUSES: Readonly<Record<string, IssueStatusCategory>>;
 /** Категория → слаг статуса SourceCraft при переводе задачи. */
@@ -26,3 +28,25 @@ export declare const GITHUB_IN_PROGRESS_LABEL = "in progress";
 /** Метки GitHub для приоритета: `priority: <имя>`. */
 export declare const GITHUB_PRIORITY_LABELS: Readonly<Record<string, IssuePriority>>;
 export declare const ALL_STATUSES: readonly IssueStatusCategory[];
+/** GitLab: state MR → категория; черновик — поле draft открытого MR. locked — слияние идёт, MR ещё открыт. */
+export declare const GITLAB_MERGE_REQUEST_STATES: Readonly<Record<string, PullRequestStatusCategory>>;
+/** GitLab: префикс заголовка, которым адаптер делает MR черновиком. */
+export declare const GITLAB_DRAFT_PREFIX = "Draft: ";
+/** GitLab: все формы префикса черновика, которые снимаются при переводе в open. */
+export declare const GITLAB_DRAFT_PATTERN: RegExp;
+/** SourceCraft: состояния PR. merging — слияние идёт, PR ещё открыт; discarded — закрыт без слияния. */
+export declare const SOURCECRAFT_PULL_STATUSES: Readonly<Record<string, PullRequestStatusCategory>>;
+/** GitHub: status прогона, задания и шага, пока не completed. */
+export declare const GITHUB_RUN_STATUSES: Readonly<Record<string, CiStatusCategory>>;
+/** GitHub: conclusion при status completed; не найдено — failed. */
+export declare const GITHUB_RUN_CONCLUSIONS: Readonly<Record<string, CiStatusCategory>>;
+/** GitHub: event прогона; не найдено — other. */
+export declare const GITHUB_RUN_EVENTS: Readonly<Record<string, CiEventCategory>>;
+/** GitLab: status пайплайна и задания; canceling — ещё не закончено. */
+export declare const GITLAB_CI_STATUSES: Readonly<Record<string, CiStatusCategory>>;
+/** GitLab: source пайплайна; не найдено — other. */
+export declare const GITLAB_PIPELINE_SOURCES: Readonly<Record<string, CiEventCategory>>;
+/** SourceCraft: status прогона, workflow, задачи и куба. */
+export declare const SOURCECRAFT_CI_STATUSES: Readonly<Record<string, CiStatusCategory>>;
+/** SourceCraft: event_type прогона. */
+export declare const SOURCECRAFT_RUN_EVENTS: Readonly<Record<string, CiEventCategory>>;

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

@@ -0,0 +1,4 @@
+import type { PullRequestAdapter } from './pull.types.ts';
+import type { AdapterContext, TrackerDefinition } from './tracker.types.ts';
+/** Адаптер PR трекера (D-005); трекер без раздела pulls — TrackerError('unsupported', 'Трекер <title> не ведёт pull request-ы.'). */
+export declare function pullRequestAdapterOf(definition: TrackerDefinition, context: AdapterContext): PullRequestAdapter;

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

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+/** Категория состояния PR единой модели (D-005); своё имя трекер отдаёт в status.name. */
+export declare const pullRequestStatusCategorySchema: z.ZodEnum<{
+    closed: "closed";
+    draft: "draft";
+    merged: "merged";
+    open: "open";
+}>;
+export declare const pullRequestFilterSchema: z.ZodEnum<{
+    author: "author";
+    createdAfter: "createdAfter";
+    createdBefore: "createdBefore";
+    labels: "labels";
+    search: "search";
+    source: "source";
+    status: "status";
+    target: "target";
+    updatedAfter: "updatedAfter";
+    updatedBefore: "updatedBefore";
+}>;
+export declare const pullRequestSortFieldSchema: z.ZodEnum<{
+    created: "created";
+    title: "title";
+    updated: "updated";
+}>;
+export declare const mergeMethodSchema: z.ZodEnum<{
+    merge: "merge";
+    rebase: "rebase";
+    squash: "squash";
+}>;
+export declare const pullRequestSchema: z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    status: z.ZodObject<{
+        category: z.ZodEnum<{
+            closed: "closed";
+            draft: "draft";
+            merged: "merged";
+            open: "open";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    author: z.ZodOptional<z.ZodString>;
+    source: z.ZodString;
+    target: z.ZodString;
+    headSha: z.ZodOptional<z.ZodString>;
+    labels: z.ZodArray<z.ZodString>;
+    reviewers: 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>;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    mergedAt: z.ZodOptional<z.ZodNumber>;
+    closedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PullRequestStatusCategory = z.infer<typeof pullRequestStatusCategorySchema>;
+export type PullRequestFilter = z.infer<typeof pullRequestFilterSchema>;
+export type PullRequestSortField = z.infer<typeof pullRequestSortFieldSchema>;
+export type MergeMethod = z.infer<typeof mergeMethodSchema>;
+export type PullRequest = z.infer<typeof pullRequestSchema>;

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

@@ -0,0 +1,74 @@
+import type { IssueComment } from '../contract/contract.types.ts';
+import type { MergeMethod, PullRequest, PullRequestFilter, PullRequestSortField, PullRequestStatusCategory } from './pull.schema.ts';
+import type { AdapterContext, CommentCapabilities, CommentQuery, ListCapabilities, ListSort, PageQuery, TrackerPage } from './tracker.types.ts';
+export type PullRequestQuery = PageQuery & {
+    status?: readonly PullRequestStatusCategory[] | undefined;
+    author?: string | undefined;
+    /** Ветка-источник и целевая ветка — имя без refs/heads/. */
+    source?: string | undefined;
+    target?: string | undefined;
+    labels?: readonly string[] | undefined;
+    search?: string | undefined;
+    createdAfter?: number | undefined;
+    createdBefore?: number | undefined;
+    updatedAfter?: number | undefined;
+    updatedBefore?: number | undefined;
+    sort?: ListSort<PullRequestSortField> | undefined;
+};
+export type NewPullRequestInput = {
+    title: string;
+    source: string;
+    target: string;
+    description?: string | undefined;
+    /** Черновиком; по умолчанию — открытый PR. */
+    draft?: boolean | undefined;
+};
+export type PullRequestPatchInput = {
+    title?: string | undefined;
+    description?: string | undefined;
+    target?: string | undefined;
+    /** open — переоткрыть или снять черновик, draft — в черновик, closed — закрыть без слияния; merged — только merge(). */
+    status?: Exclude<PullRequestStatusCategory, 'merged'> | undefined;
+};
+export type MergeInput = {
+    /** Нет — способ по настройке репозитория; GitHub без неё шлёт merge, GitLab при 'merge' применяет squash-настройку MR/проекта. */
+    method?: MergeMethod | undefined;
+    /** Голова источника, которую видел вызывающий: другая — отказ conflict. GitHub и GitLab сверяют её сервером
+     * (атомарно, нужен полный sha); у SourceCraft сверка на клиенте — лучшее старание, push между чтением и
+     * слиянием ей не отсекается; штатный sha — полный, в нижнем регистре. */
+    headSha?: string | undefined;
+    /** Сообщение коммита слияния; первая строка — заголовок. */
+    message?: string | undefined;
+    /** Удалить ветку-источник после слияния. */
+    deleteSource?: boolean | undefined;
+};
+export type PullRequestAdapter = {
+    list(query: PullRequestQuery): Promise<TrackerPage<PullRequest>>;
+    get(key: string): Promise<PullRequest>;
+    create(input: NewPullRequestInput): Promise<PullRequest>;
+    update(key: string, patch: PullRequestPatchInput): Promise<PullRequest>;
+    /** Слияние; у SourceCraft асинхронное — вернётся PR с категорией open (status.name 'open' или 'merging') до
+     * завершения операции, либо уже merged; операция, отклонённая трекером (failed/cancel), — отказ conflict. */
+    merge(key: string, input: MergeInput): Promise<PullRequest>;
+    comments(key: string, query: CommentQuery): Promise<TrackerPage<IssueComment>>;
+    comment(key: string, body: string): Promise<IssueComment>;
+};
+export type PullRequestCapabilities = {
+    list: ListCapabilities<PullRequestFilter, PullRequestSortField>;
+    comments: CommentCapabilities;
+    create: boolean;
+    createDraft: boolean;
+    /** Поля, которые меняет update. */
+    update: readonly ('title' | 'description' | 'target')[];
+    /** Категории, в которые переводит update({ status }). */
+    statuses: readonly Exclude<PullRequestStatusCategory, 'merged'>[];
+    comment: boolean;
+    /** Способы слияния; пусто — merge не поддерживается. */
+    merge: readonly MergeMethod[];
+    deleteSourceOnMerge: boolean;
+};
+/** Раздел pulls определения трекера (D-005): на том же подключении, что и задачи. */
+export type PullRequestDefinition = {
+    capabilities: PullRequestCapabilities;
+    create(context: AdapterContext): PullRequestAdapter;
+};

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

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

package/dist/tracker/sourcecraft-pull.lib.d.ts

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

package/dist/tracker/tracker.const.d.ts

@@ -1,3 +1,4 @@
+import type { CiStatusCategory } from './ci.schema.ts';
 import type { IssueCapabilities } from './tracker.types.ts';
 /** Потолок ожидания ответа внешнего трекера, мс. */
 export declare const TRACKER_TIMEOUT_MS = 15000;
@@ -20,3 +21,14 @@ export declare const COMMENT_FILTERS: readonly ['updatedAfter'];
 export type CommentFilter = (typeof COMMENT_FILTERS)[number];
 /** Возможности трекера без раздела issues (свои трекеры потребителя): статус и страницы, комментарии по порядку. */
 export declare const LEGACY_ISSUE_CAPABILITIES: IssueCapabilities;
+/** Окно лога CI по умолчанию и потолок окна одного вызова, байт (D-006). */
+export declare const CI_LOG_DEFAULT_BYTES: number;
+export declare const CI_LOG_MAX_BYTES: number;
+/** Потолок чтения тела лога: дальше поток обрывается, лог — truncated. */
+export declare const CI_LOG_READ_MAX_BYTES: number;
+/** Таймаут загрузки лога, мс: логи больше ответов API. */
+export declare const CI_LOG_TIMEOUT_MS = 60000;
+/** Сколько страниц лога SourceCraft читается за один вызов log(). */
+export declare const CI_LOG_PAGES_MAX = 50;
+/** Законченные категории CI. */
+export declare const CI_FINISHED_STATUSES: readonly CiStatusCategory[];

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

@@ -1,5 +1,7 @@
 import type { Issue, IssueComment, IssuePriority, IssueStatusCategory, TrackerDescriptor } from '../contract/contract.types.ts';
 import type { LocalIssueStore } from '../kernel/store.types.ts';
+import type { CiDefinition } from './ci.types.ts';
+import type { PullRequestDefinition } from './pull.types.ts';
 import type { CommentFilter, IssueFilter, IssueSortField } from './tracker.const.ts';
 export type TrackerFetch = (input: string, init?: {
     method?: string;
@@ -113,6 +115,10 @@ export type TrackerDefinition = {
     create(context: AdapterContext): TrackerAdapter;
     /** Фильтры и сортировка задач и комментариев; нет — LEGACY_ISSUE_CAPABILITIES. */
     issues?: IssueCapabilities | undefined;
+    /** Pull request-ы на том же подключении (D-005); нет — трекер их не ведёт. */
+    pulls?: PullRequestDefinition | undefined;
+    /** CI трекера на том же подключении (D-005); нет — ciAdapterOf отказывает unsupported. */
+    ci?: CiDefinition | undefined;
 };
 export type TrackerFailure = 'failed' | 'unknown_issue' | 'invalid_request' | 'not_found' | 'unsupported' | 'conflict' | 'rate_limited';
 export type JsonRequest = {
@@ -134,3 +140,34 @@ export type JsonResponse = {
     body: unknown;
     headers: Headers;
 };
+/** Запрос текста (лог CI): тело читается потоком, в памяти — только окно keep. */
+export type TextRequest = {
+    fetch: TrackerFetch;
+    headers?: Record<string, string> | undefined;
+    /** Заголовок accept; по умолчанию text/plain. */
+    accept?: string | undefined;
+    /** Пропустить столько байт тела от начала (дочитывание по курсору). */
+    skip?: number | undefined;
+    /** Сколько байт держать и с какой стороны тела после skip: head — первые, tail — последние (кольцевой буфер). */
+    keep: {
+        bytes: number;
+        from: 'head' | 'tail';
+    };
+    /** Потолок чтения тела; по умолчанию CI_LOG_READ_MAX_BYTES. */
+    readMax?: number | undefined;
+    missing?: JsonRequest['missing'];
+    /** По умолчанию CI_LOG_TIMEOUT_MS. */
+    timeoutMs?: number | undefined;
+};
+export type TextResponse = {
+    /** Окно в UTF-8, границы сдвинуты к целым символам. */
+    text: string;
+    /** Смещение первого и за последним байтом окна от начала тела. */
+    start: number;
+    end: number;
+    /** Сколько байт тела прочитано. */
+    read: number;
+    /** Тело прочитано до конца (не оборвали по head и не упёрлись в readMax). */
+    whole: boolean;
+    headers: Headers;
+};

package/dist/worktree/index.js

@@ -6,15 +6,15 @@ import {
   isDirty,
   isGitPoolClosed,
   pruneWorktrees
-} from "../chunk-GPRMI4PG.js";
+} from "../chunk-ZTME4HFD.js";
 import {
   checkManagedPath,
   prepareWorktreeParent,
   trashRoot
 } from "../chunk-C6PHNSDC.js";
 import "../chunk-3YP22YLA.js";
+import "../chunk-AGGJK2XZ.js";
 import "../chunk-4ZGRXIVA.js";
-import "../chunk-L7CPE2SO.js";
 
 // src/worktree/lifecycle.const.ts
 var WORKTREE_RECONCILE_INTERVAL_MS = 3e4;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smwb/onreel-git-mcp",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Библиотека модулей, выделенных из onreel: git-операции и безопасные пути, список файлов worktree, жизненный цикл worktree против порта WorktreeStore, адаптеры трекеров GitHub/GitLab/Jira/SourceCraft/локального и MCP-сервер на stdio",
   "keywords": [
     "git",