@smwb/onreel-git-mcp 0.2.1 → 0.3.0

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,6 @@
 import type { Issue, IssueComment, IssuePriority, IssueStatusCategory, TrackerDescriptor } from '../contract/contract.types.ts';
 import type { LocalIssueStore } from '../kernel/store.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 +27,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 +104,17 @@ 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;
 };
-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 +122,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/package.json

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