@smwb/onreel-git-mcp 0.2.1 → 0.4.0

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

@@ -1,8 +1,11 @@
 import type { IssuePriority, IssueStatusCategory } from '../contract/contract.types.ts';
+import type { PullRequestStatusCategory } from './pull.schema.ts';
 /** SourceCraft: системные статусы. На паузе — ещё не закончено, но и не в работе: `open`. */
 export declare const SOURCECRAFT_STATUSES: Readonly<Record<string, IssueStatusCategory>>;
 /** Категория → слаг статуса SourceCraft при переводе задачи. */
 export declare const SOURCECRAFT_STATUS_SLUGS: Readonly<Record<IssueStatusCategory, string>>;
+/** Категория → слаги статусов QL фильтра списка (`status in (…)`); QL принимает только слаги, не имена. */
+export declare const SOURCECRAFT_STATUS_FILTER: Readonly<Record<IssueStatusCategory, readonly string[]>>;
 /** Приоритеты SourceCraft совпадают с единой моделью по именам. */
 export declare const SOURCECRAFT_PRIORITIES: Readonly<Record<string, IssuePriority>>;
 /** Jira: `statusCategory.key` статуса. */
@@ -24,3 +27,11 @@ 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>>;

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-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 { IssueCapabilities } from './tracker.types.ts';
 /** Потолок ожидания ответа внешнего трекера, мс. */
 export declare const TRACKER_TIMEOUT_MS = 15000;
 /** Размер страницы списка задач по умолчанию; потолок — 500 по контракту. */
@@ -8,3 +9,14 @@ export declare const TRACKER_ERROR_BODY_MAX = 300;
 export declare const TRACKER_SECRETS_FILE = "tracker-secrets.json";
 /** Автор комментариев, которые пользователь пишет в локальном трекере. */
 export declare const TRACKER_LOCAL_AUTHOR = "owner";
+/** Фильтры списка задач — имена полей IssueQuery; порядок — для текстов отказов. */
+export declare const ISSUE_FILTERS: readonly ['status', 'labels', 'assignee', 'author', 'search', 'createdAfter', 'createdBefore', 'updatedAfter', 'updatedBefore'];
+export type IssueFilter = (typeof ISSUE_FILTERS)[number];
+/** Поля сортировки задач единой модели. */
+export declare const ISSUE_SORT_FIELDS: readonly ['created', 'updated', 'priority', 'title', 'comments'];
+export type IssueSortField = (typeof ISSUE_SORT_FIELDS)[number];
+/** Фильтры списка комментариев — имена полей CommentQuery. */
+export declare const COMMENT_FILTERS: readonly ['updatedAfter'];
+export type CommentFilter = (typeof COMMENT_FILTERS)[number];
+/** Возможности трекера без раздела issues (свои трекеры потребителя): статус и страницы, комментарии по порядку. */
+export declare const LEGACY_ISSUE_CAPABILITIES: IssueCapabilities;

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

@@ -1,5 +1,5 @@
 import type { IssuePriority, IssueStatusCategory } from '../contract/contract.types.ts';
-import type { TrackerFailure } from './tracker.types.ts';
+import type { CommentCapabilities, CommentQuery, IssueCapabilities, ListCapabilities, ListSort, TrackerDefinition, TrackerFailure } from './tracker.types.ts';
 /** Отказ адаптера: потребитель превращает его в ошибку своего контракта (D-353). */
 export declare class TrackerError extends Error {
     readonly failure: TrackerFailure;
@@ -19,3 +19,28 @@ export declare function requireTarget(target: string | undefined, hint: string):
 /** Обратная таблица: категория → первое имя статуса трекера. */
 export declare function nameOf(table: Readonly<Record<string, IssueStatusCategory>>, category: IssueStatusCategory): string | undefined;
 export declare function priorityName(table: Readonly<Record<string, IssuePriority>>, priority: IssuePriority): string | undefined;
+/** Фильтры запроса со значением (не undefined и не пустой массив), в порядке names. */
+export declare function usedFilters<F extends string>(query: Readonly<Partial<Record<F, unknown>>>, names: readonly F[]): F[];
+/**
+ * Проверка запроса списка по возможностям (D-004, R-002): фильтр со значением вне filters или sort.field вне sorts —
+ * TrackerError('unsupported', `${subject}: фильтр ${name} не поддерживается.`); значение не той формы — invalid_request:
+ * время не числом или не целое ≥ 0, пустая строка фильтра, список со строкой-пустышкой. subject — что за список:
+ * 'Задачи GitHub', 'PR GitLab', 'Прогоны CI SourceCraft'.
+ */
+export declare function assertListQuery<F extends string, S extends string>(subject: string, capabilities: ListCapabilities<F, S>, query: Readonly<Partial<Record<F, unknown>>> & {
+    readonly sort?: ListSort<S> | undefined;
+}, names: readonly F[]): void;
+/** Проверка запроса комментариев: updatedAfter вне filters или order вне capabilities.order — unsupported. */
+export declare function assertCommentQuery(subject: string, capabilities: CommentCapabilities, query: CommentQuery): void;
+/** Возможности задач трекера: раздел issues или LEGACY_ISSUE_CAPABILITIES. */
+export declare function issueCapabilitiesOf(definition: TrackerDefinition): IssueCapabilities;
+/** Мс единой модели → ISO 8601 UTC для параметров трекера. */
+export declare function isoTime(ms: number): string;
+/** Время записи в границах [after, before] включительно; граница задана, а время неизвестно — не проходит. */
+export declare function inTimeRange(value: number | undefined, after: number | undefined, before: number | undefined): boolean;
+/** Есть ли needle (без учёта регистра) подстрокой в одном из текстов. */
+export declare function containsText(texts: readonly (string | undefined)[], needle: string): boolean;
+/** Значение в двойных кавычках для JQL, QL SourceCraft и q поиска GitHub: экранирует \ и ". */
+export declare function quoted(value: string): string;
+/** Ключи таблицы сопоставления, чьё значение — одна из категорий (обратный поиск для фильтров трекера). */
+export declare function keysFor<T>(table: Readonly<Record<string, T>>, values: readonly T[]): string[];

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 { PullRequestDefinition } from './pull.types.ts';
+import type { CommentFilter, IssueFilter, IssueSortField } from './tracker.const.ts';
 export type TrackerFetch = (input: string, init?: {
     method?: string;
     headers?: Record<string, string>;
@@ -26,8 +28,57 @@ export type PageQuery = {
     limit: number;
     cursor?: string | undefined;
 };
+export type SortDirection = 'asc' | 'desc';
+/**
+ * Сортировка списка; нет — прежний порядок трекера: GitHub, GitLab, Jira и локальный отдают новые первыми,
+ * у SourceCraft свой порядок по умолчанию (старые первыми). direction по умолчанию — desc.
+ */
+export type ListSort<F extends string> = {
+    field: F;
+    direction?: SortDirection | undefined;
+};
+/**
+ * Возможности списка (D-004): filters — фильтры, которые адаптер применяет, фильтр вне них — отказ unsupported до запроса;
+ * clientSide — часть filters, которую адаптер проверяет по полученной странице: страница бывает короче limit и пустой
+ * при nextCursor; sorts — поля сортировки, пусто — только порядок трекера.
+ */
+export type ListCapabilities<F extends string, S extends string> = {
+    filters: readonly F[];
+    clientSide: readonly F[];
+    sorts: readonly S[];
+};
+/** Возможности списка комментариев: фильтры и допустимые порядки, первый — порядок по умолчанию. */
+export type CommentCapabilities = {
+    filters: readonly CommentFilter[];
+    clientSide: readonly CommentFilter[];
+    order: readonly SortDirection[];
+};
+export type IssueCapabilities = {
+    list: ListCapabilities<IssueFilter, IssueSortField>;
+    comments: CommentCapabilities;
+};
 export type IssueQuery = PageQuery & {
     status?: readonly IssueStatusCategory[] | undefined;
+    /** Все перечисленные метки (И). */
+    labels?: readonly string[] | undefined;
+    /** Исполнитель — как в Issue.assignee; null — задачи без исполнителя. */
+    assignee?: string | null | undefined;
+    /** Автор задачи — логин или slug трекера. */
+    author?: string | undefined;
+    /** Поиск по тексту так, как ищет трекер (у SourceCraft — префикс заголовка, у локального — подстрока). */
+    search?: string | undefined;
+    /** Границы по времени включительно, мс Unix epoch. */
+    createdAfter?: number | undefined;
+    createdBefore?: number | undefined;
+    updatedAfter?: number | undefined;
+    updatedBefore?: number | undefined;
+    sort?: ListSort<IssueSortField> | undefined;
+};
+export type CommentQuery = PageQuery & {
+    /** Только комментарии, изменённые не раньше момента, мс. */
+    updatedAfter?: number | undefined;
+    /** Порядок по времени создания; по умолчанию asc — как было. */
+    order?: SortDirection | undefined;
 };
 export type TrackerPage<T> = {
     items: T[];
@@ -54,15 +105,19 @@ export type TrackerAdapter = {
     get(key: string): Promise<Issue>;
     create(input: NewIssueInput): Promise<Issue>;
     update(key: string, patch: IssuePatchInput): Promise<Issue>;
-    comments(key: string, query: PageQuery): Promise<TrackerPage<IssueComment>>;
+    comments(key: string, query: CommentQuery): Promise<TrackerPage<IssueComment>>;
     comment(key: string, body: string): Promise<IssueComment>;
 };
 /** Подключаемый трекер: описание для интерфейса и фабрика адаптера (D-350). */
 export type TrackerDefinition = {
     descriptor: TrackerDescriptor;
     create(context: AdapterContext): TrackerAdapter;
+    /** Фильтры и сортировка задач и комментариев; нет — LEGACY_ISSUE_CAPABILITIES. */
+    issues?: IssueCapabilities | undefined;
+    /** Pull request-ы на том же подключении (D-005); нет — трекер их не ведёт. */
+    pulls?: PullRequestDefinition | undefined;
 };
-export type TrackerFailure = 'failed' | 'unknown_issue' | 'invalid_request';
+export type TrackerFailure = 'failed' | 'unknown_issue' | 'invalid_request' | 'not_found' | 'unsupported' | 'conflict' | 'rate_limited';
 export type JsonRequest = {
     fetch: TrackerFetch;
     method?: 'GET' | 'POST' | 'PUT' | 'PATCH';
@@ -70,6 +125,13 @@ export type JsonRequest = {
     body?: unknown;
     /** 404 — «нет такой задачи», а не «неверный адрес». */
     missingIsIssue?: boolean;
+    /** 404 — нет этой сущности (PR, прогон, задание): код и текст отказа. Важнее missingIsIssue. */
+    missing?: {
+        failure: TrackerFailure;
+        message: string;
+    } | undefined;
+    /** Статусы ответа «переход сейчас невозможен» (409 отмены, 405/409/422 слияния): отказ conflict. */
+    conflictOn?: readonly number[] | undefined;
 };
 export type JsonResponse = {
     body: unknown;

package/dist/worktree/index.js

@@ -13,8 +13,8 @@ import {
   trashRoot
 } from "../chunk-C6PHNSDC.js";
 import "../chunk-3YP22YLA.js";
-import "../chunk-4ZGRXIVA.js";
 import "../chunk-L7CPE2SO.js";
+import "../chunk-4ZGRXIVA.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.2.1",
+  "version": "0.4.0",
   "description": "Библиотека модулей, выделенных из onreel: git-операции и безопасные пути, список файлов worktree, жизненный цикл worktree против порта WorktreeStore, адаптеры трекеров GitHub/GitLab/Jira/SourceCraft/локального и MCP-сервер на stdio",
   "keywords": [
     "git",