@smwb/onreel-git-mcp 0.8.0 → 0.10.0

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

@@ -0,0 +1,4 @@
+import type { RepoAdapter } from './repo.types.ts';
+import type { AdapterContext, TrackerDefinition } from './tracker.types.ts';
+/** Адаптер репозитория трекера (D-008); трекер без раздела repo — TrackerError('unsupported', 'Трекер <title> не ведёт репозиторий.'). */
+export declare function repoAdapterOf(definition: TrackerDefinition, context: AdapterContext): RepoAdapter;

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

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+/** Видимость репозитория единой модели (#23): GitHub, GitLab и SourceCraft называют её одними словами. */
+export declare const repoVisibilitySchema: z.ZodEnum<{
+    internal: "internal";
+    private: "private";
+    public: "public";
+}>;
+/** Фильтры списка веток — имена полей BranchQuery. */
+export declare const branchFilterSchema: z.ZodEnum<{
+    search: "search";
+}>;
+export declare const repoSchema: z.ZodObject<{
+    name: z.ZodString;
+    defaultBranch: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        internal: "internal";
+        private: "private";
+        public: "public";
+    }>>;
+    links: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const branchSchema: z.ZodObject<{
+    name: z.ZodString;
+    sha: z.ZodOptional<z.ZodString>;
+    protected: z.ZodOptional<z.ZodBoolean>;
+    isDefault: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RepoVisibility = z.infer<typeof repoVisibilitySchema>;
+export type BranchFilter = z.infer<typeof branchFilterSchema>;
+export type Repo = z.infer<typeof repoSchema>;
+export type Branch = z.infer<typeof branchSchema>;

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

@@ -0,0 +1,20 @@
+import type { Branch, BranchFilter, Repo } from './repo.schema.ts';
+import type { AdapterContext, ListCapabilities, PageQuery, TrackerPage } from './tracker.types.ts';
+export type BranchQuery = PageQuery & {
+    /** Подстрока имени ветки: GitLab и SourceCraft фильтруют сервером, GitHub — по полученной странице. */
+    search?: string | undefined;
+};
+/** Карточка репозитория и ветки git-хостинга того же подключения. */
+export type RepoAdapter = {
+    get(): Promise<Repo>;
+    branches(query: BranchQuery): Promise<TrackerPage<Branch>>;
+};
+/** Возможности раздела repo: список веток описан как другие списки (D-004); сортировки веток нет. */
+export type RepoCapabilities = {
+    branches: ListCapabilities<BranchFilter, never>;
+};
+/** Раздел repo определения трекера (D-008): на том же подключении, что и задачи. */
+export type RepoDefinition = {
+    capabilities: RepoCapabilities;
+    create(context: AdapterContext): RepoAdapter;
+};

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

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

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

@@ -26,6 +26,8 @@ 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;
+/** Сколько редиректов проходит один запрос к трекеру; следующий — отказ failed. */
+export declare const TRACKER_REDIRECT_MAX = 5;
 /** Таймаут загрузки лога, мс: логи больше ответов API. */
 export declare const CI_LOG_TIMEOUT_MS = 60000;
 /** Сколько страниц лога SourceCraft читается за один вызов log(). */

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

@@ -2,12 +2,19 @@ import type { Issue, IssueComment, IssuePriority, IssueStatusCategory, TrackerDe
 import type { LocalIssueStore } from '../kernel/store.types.ts';
 import type { CiDefinition } from './ci.types.ts';
 import type { PullRequestDefinition } from './pull.types.ts';
+import type { RepoDefinition } from './repo.types.ts';
 import type { CommentFilter, IssueFilter, IssueSortField } from './tracker.const.ts';
+/**
+ * fetch контекста. requestJson и requestText передают redirect: 'manual' и проходят редиректы сами: обёртка
+ * потребителя передаёт redirect в свой fetch, иначе за редиректом пойдёт её fetch, а не библиотека. Такой ответ
+ * (redirected, адрес на другом origin, opaqueredirect) — отказ failed, а не данные.
+ */
 export type TrackerFetch = (input: string, init?: {
     method?: string;
     headers?: Record<string, string>;
     body?: string;
     signal?: AbortSignal;
+    redirect?: 'follow' | 'manual' | 'error';
 }) => Promise<Response>;
 /** Подключение проекта с расшифрованным секретом: живёт только в памяти на время вызова. */
 export type TrackerConnectionData = {
@@ -119,10 +126,24 @@ export type TrackerDefinition = {
     pulls?: PullRequestDefinition | undefined;
     /** CI трекера на том же подключении (D-005); нет — ciAdapterOf отказывает unsupported. */
     ci?: CiDefinition | undefined;
+    /** Репозиторий git-хостинга на том же подключении (D-008); нет — repoAdapterOf отказывает unsupported. */
+    repo?: RepoDefinition | undefined;
+    /**
+     * Origin API, к которому адаптер (и его разделы pulls, ci и repo) обращается с токеном подключения, например
+     * https://api.github.com. Потребитель привязывает к нему токен: правка url на другой origin — повод спросить
+     * токен заново. Неверное подключение — TrackerError, как у create. Нет — трекер не объявил origin (у local
+     * сети и токена нет).
+     */
+    origin?: ((connection: TrackerConnectionData) => string) | undefined;
 };
 export type TrackerFailure = 'failed' | 'unknown_issue' | 'invalid_request' | 'not_found' | 'unsupported' | 'conflict' | 'rate_limited';
 export type JsonRequest = {
     fetch: TrackerFetch;
+    /**
+     * Origin API подключения: адрес вне него — отказ invalid_request до запроса. Редирект на чужой origin проходит
+     * только для GET и без заголовков запроса (Authorization и свои). Нет — origin самого адреса.
+     */
+    origin?: string | undefined;
     method?: 'GET' | 'POST' | 'PUT' | 'PATCH';
     headers?: Record<string, string>;
     body?: unknown;
@@ -143,6 +164,8 @@ export type JsonResponse = {
 /** Запрос текста (лог CI): тело читается потоком, в памяти — только окно keep. */
 export type TextRequest = {
     fetch: TrackerFetch;
+    /** Origin API подключения — как у JsonRequest.origin. */
+    origin?: string | undefined;
     headers?: Record<string, string> | undefined;
     /** Заголовок accept; по умолчанию text/plain. */
     accept?: string | undefined;

package/package.json

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