@smwb/onreel-git-mcp 0.4.0 → 0.6.0

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';