@smwb/onreel-git-mcp 0.1.0 → 0.2.0

package/dist/git/git.types.d.ts

@@ -0,0 +1,33 @@
+import type { WorktreeChange, WorktreeFileSide } from '../contract/contract.types.ts';
+export type GitRunOptions = {
+    timeoutMs?: number;
+    /** Коды выхода, которые для команды штатны (например, 1 — «нет такого ref»). */
+    okCodes?: readonly number[];
+    /** Дополнительные переменные окружения процесса git. */
+    env?: Record<string, string>;
+};
+export type GitRun = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type CommitOutcome = {
+    committed: boolean;
+    headSha: string;
+};
+export type RebaseOutcome = {
+    kind: 'busy';
+    operation: string;
+} | {
+    kind: 'dirty';
+    paths: string[];
+} | {
+    kind: 'done';
+    conflict: boolean;
+    conflicts: string[];
+    headSha: string;
+};
+/** Изменённый файл отслеживаемого дерева против коммита (ревью, D-320): без неотслеживаемых. */
+export type ChangedFile = Omit<WorktreeChange, 'untracked'>;
+/** Одна сторона файла для ревью: размер, признак бинарного/усечённого, текст (D-320). */
+export type FileSide = WorktreeFileSide;

package/dist/git/index.d.ts

@@ -0,0 +1,7 @@
+export * from './git.const.ts';
+export * from './git.types.ts';
+export * from './git.lib.ts';
+export * from './paths.const.ts';
+export * from './paths.lib.ts';
+export type { SecretSink } from '../kernel/log.types.ts';
+export { defaultSecretSink, redactSecretText } from '../kernel/redact.lib.ts';

package/dist/git/index.js

@@ -0,0 +1,97 @@
+import {
+  GIT_CHECKOUT_TIMEOUT_MS,
+  GIT_TIMEOUT_MS,
+  GitError,
+  addWorktree,
+  branchSha,
+  changedFiles,
+  closeGitPool,
+  commitChanges,
+  currentBranch,
+  deleteBranch,
+  diffAgainst,
+  headOf,
+  isDirty,
+  isGitPoolClosed,
+  isValidBranchName,
+  operationInProgress,
+  pruneWorktrees,
+  readWorktreeFile,
+  rebaseOnto,
+  reopenGitPool,
+  repoToplevel,
+  resolveCommit,
+  runGit,
+  showBlob,
+  statusEntries,
+  untrackedFiles
+} from "../chunk-GPRMI4PG.js";
+import {
+  PROJECT_WORKTREE_SEGMENT,
+  PathEscapeError,
+  assertOutsideDataDir,
+  checkManagedPath,
+  checkRepoPath,
+  defaultBranchFor,
+  defaultProjectBranchFor,
+  isInside,
+  prepareWorktreeParent,
+  projectWorktreePathFor,
+  repoSlug,
+  safeComponent,
+  trashRoot,
+  workspacesRoot,
+  worktreePathFor
+} from "../chunk-C6PHNSDC.js";
+import "../chunk-3YP22YLA.js";
+import "../chunk-4ZGRXIVA.js";
+import {
+  defaultSecretSink,
+  redactSecretText
+} from "../chunk-L7CPE2SO.js";
+export {
+  GIT_CHECKOUT_TIMEOUT_MS,
+  GIT_TIMEOUT_MS,
+  GitError,
+  PROJECT_WORKTREE_SEGMENT,
+  PathEscapeError,
+  addWorktree,
+  assertOutsideDataDir,
+  branchSha,
+  changedFiles,
+  checkManagedPath,
+  checkRepoPath,
+  closeGitPool,
+  commitChanges,
+  currentBranch,
+  defaultBranchFor,
+  defaultProjectBranchFor,
+  defaultSecretSink,
+  deleteBranch,
+  diffAgainst,
+  headOf,
+  isDirty,
+  isGitPoolClosed,
+  isInside,
+  isValidBranchName,
+  operationInProgress,
+  prepareWorktreeParent,
+  projectWorktreePathFor,
+  pruneWorktrees,
+  readWorktreeFile,
+  rebaseOnto,
+  redactSecretText,
+  reopenGitPool,
+  repoSlug,
+  repoToplevel,
+  resolveCommit,
+  runGit,
+  safeComponent,
+  showBlob,
+  statusEntries,
+  trashRoot,
+  untrackedFiles,
+  workspacesRoot,
+  worktreePathFor
+};
+//# sourceMappingURL=index.js.map

package/dist/git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/git/paths.const.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Сегмент пути и ветки, под которым лежат worktree проектов без задачи (D-345). `safeComponent(id)` ему не
+ * равен: id начинается с буквы или цифры (`idPattern`), а `safeComponent` первый символ не меняет.
+ */
+export declare const PROJECT_WORKTREE_SEGMENT = "_project";

package/dist/git/paths.lib.d.ts

@@ -0,0 +1,39 @@
+/** Путь вне разрешённого корня или через симлинк: отказ `permission_denied`. */
+export declare class PathEscapeError extends Error {
+    constructor(message: string);
+}
+/** candidate строго внутри root (лексически, оба пути уже нормализованы); сам root — не «внутри». */
+export declare function isInside(root: string, candidate: string): boolean;
+export declare function workspacesRoot(dataDir: string): string;
+export declare function trashRoot(dataDir: string): string;
+/** Компонента пути или ref из id: всё, кроме букв, цифр, `_` и `-`, заменяется на `-`. */
+export declare function safeComponent(id: string): string;
+/** Имя каталога репозитория в раскладке: базовое имя плюс хэш realpath — разные репозитории не сходятся. */
+export declare function repoSlug(repoRealPath: string): string;
+/** Каталог worktree: `<dataDir>/workspaces/<repo>/<run>/<task>` (§6.9). */
+export declare function worktreePathFor(dataDir: string, repoRealPath: string, runId: string, taskId: string): string;
+/** Каталог worktree проекта без задачи: `<dataDir>/workspaces/<repo>/_project/<name>` (D-345). */
+export declare function projectWorktreePathFor(dataDir: string, repoRealPath: string, name: string): string;
+/** Ветка worktree проекта по умолчанию: `onreel/_project/<name>` (D-345); n > 1 — `-2`, `-3`… при занятой. */
+export declare function defaultProjectBranchFor(name: string, n?: number): string;
+/** Ветка worktree по умолчанию: `onreel/<run>/<task>` (§6.9); n > 1 — следующий worktree той же Task. */
+export declare function defaultBranchFor(runId: string, taskId: string, n?: number): string;
+/**
+ * Проверяет repoPath клиента (D-077): абсолютный, существует, и ни сам путь, ни его realpath
+ * не лежат в каталоге данных host (там ledger, токены и worktree host): симлинк из каталога
+ * данных наружу тоже отказ. Возвращает realpath.
+ */
+export declare function checkRepoPath(dataDir: string, repoPath: string): string;
+/** Путь не внутри каталога данных host — ни как он записан, ни по realpath каталога. */
+export declare function assertOutsideDataDir(dataDir: string, path: string): void;
+/**
+ * Готовит родителя будущего каталога worktree: корень workspaces и промежуточные каталоги
+ * создаются по одному (0o700), каждый — настоящий каталог, не симлинк; realpath родителя
+ * обязан лежать внутри realpath корня. Сам target существовать не должен.
+ */
+export declare function prepareWorktreeParent(dataDir: string, target: string): void;
+/**
+ * Каталог worktree из ledger перед удалением: лексически и по realpath внутри корня workspaces,
+ * сам — не симлинк. Нет каталога — false (его убрали руками).
+ */
+export declare function checkManagedPath(dataDir: string, path: string): boolean;

package/dist/index.d.ts

@@ -1 +1,6 @@
-export declare const VERSION = "0.0.0";
+export * from './contract/contract.const.ts';
+export * from './contract/contract.schema.ts';
+export * from './contract/contract.types.ts';
+export * from './contract/contract.lib.ts';
+/** Версия пакета; держится равной version в package.json (обновляется релизом changesets). */
+export declare const VERSION = "0.1.0";

package/dist/index.js

@@ -1,6 +1,117 @@
+import {
+  clip,
+  contractError,
+  formatUmask,
+  formatVersion,
+  inheritSessionUmask,
+  parseUmask,
+  sessionUmask
+} from "./chunk-3YP22YLA.js";
+import {
+  CONTRACT_ERROR_MESSAGE_MAX,
+  CONTRACT_ERROR_NEXT_STEP_MAX,
+  DEFAULT_SESSION_UMASK,
+  ENV_DISPATCH_ID,
+  ENV_HOST_URL,
+  ENV_RUN_ID,
+  ENV_SESSION_UMASK,
+  ENV_TASK_ID,
+  ENV_TOKEN,
+  HOST_CONTRACT_VERSION,
+  HOST_DISCOVERY_FILE,
+  WORKTREE_FILES_MAX,
+  WORKTREE_FILES_REASONS,
+  contractErrorSchema,
+  contractVersionSchema,
+  entityIdSchema,
+  errorCatalog,
+  errorCodeSchema,
+  gitShaSchema,
+  issueCommentSchema,
+  issueKeySchema,
+  issueLinkSchema,
+  issuePrioritySchema,
+  issueSchema,
+  issueStatusCategorySchema,
+  projectIdSchema,
+  requestIdSchema,
+  reviewPathSchema,
+  taskIdSchema,
+  timestampSchema,
+  trackerDescriptorSchema,
+  trackerFeaturesSchema,
+  trackerFieldNameSchema,
+  trackerKindSchema,
+  wireErrorCodeSchema,
+  worktreeChangeSchema,
+  worktreeChangeStatusSchema,
+  worktreeDirPathSchema,
+  worktreeEntryKindSchema,
+  worktreeEntrySchema,
+  worktreeFileSideSchema,
+  worktreeIdSchema,
+  worktreeNameSchema,
+  worktreeSchema,
+  worktreeStatusEntrySchema,
+  worktreeStatusSchema
+} from "./chunk-4ZGRXIVA.js";
+
 // src/index.ts
-var VERSION = "0.0.0";
+var VERSION = "0.1.0";
 export {
-  VERSION
+  CONTRACT_ERROR_MESSAGE_MAX,
+  CONTRACT_ERROR_NEXT_STEP_MAX,
+  DEFAULT_SESSION_UMASK,
+  ENV_DISPATCH_ID,
+  ENV_HOST_URL,
+  ENV_RUN_ID,
+  ENV_SESSION_UMASK,
+  ENV_TASK_ID,
+  ENV_TOKEN,
+  HOST_CONTRACT_VERSION,
+  HOST_DISCOVERY_FILE,
+  VERSION,
+  WORKTREE_FILES_MAX,
+  WORKTREE_FILES_REASONS,
+  clip,
+  contractError,
+  contractErrorSchema,
+  contractVersionSchema,
+  entityIdSchema,
+  errorCatalog,
+  errorCodeSchema,
+  formatUmask,
+  formatVersion,
+  gitShaSchema,
+  inheritSessionUmask,
+  issueCommentSchema,
+  issueKeySchema,
+  issueLinkSchema,
+  issuePrioritySchema,
+  issueSchema,
+  issueStatusCategorySchema,
+  parseUmask,
+  projectIdSchema,
+  requestIdSchema,
+  reviewPathSchema,
+  sessionUmask,
+  taskIdSchema,
+  timestampSchema,
+  trackerDescriptorSchema,
+  trackerFeaturesSchema,
+  trackerFieldNameSchema,
+  trackerKindSchema,
+  wireErrorCodeSchema,
+  worktreeChangeSchema,
+  worktreeChangeStatusSchema,
+  worktreeDirPathSchema,
+  worktreeEntryKindSchema,
+  worktreeEntrySchema,
+  worktreeFileSideSchema,
+  worktreeIdSchema,
+  worktreeNameSchema,
+  worktreeSchema,
+  worktreeStatusEntrySchema,
+  worktreeStatusSchema
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Версия пакета — единственный публичный символ корневого подпути на этапе каркаса.\n// Полный публичный API (contract/kernel) появится в следующих частях выделения.\nexport const VERSION = \"0.0.0\";\n"],"mappings":";AAEO,IAAM,UAAU;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Корневой подпуть пакета @smwb/onreel-git-mcp: срез контракта (константы, схемы, типы, чистые\n// функции) и версия пакета. Всё без побочных эффектов при импорте (R-001). Швы ядра\n// (SecretSink, WorktreeStore, LocalIssueStore) и модули git/files/worktree/tracker/mcp\n// экспортируют свои подпути — см. exports в package.json и README.\nexport * from './contract/contract.const.ts';\nexport * from './contract/contract.schema.ts';\nexport * from './contract/contract.types.ts';\nexport * from './contract/contract.lib.ts';\n\n/** Версия пакета; держится равной version в package.json (обновляется релизом changesets). */\nexport const VERSION = '0.1.0';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUO,IAAM,UAAU;","names":[]}

package/dist/kernel/log.types.d.ts

@@ -0,0 +1,5 @@
+/** Приёмник известных секретов: значение маскируется в текстах ошибок и журналов. */
+export type SecretSink = {
+    /** Регистрирует значение секрета; значение короче 8 символов реализация игнорирует. */
+    register(secret: string): void;
+};

package/dist/kernel/redact.lib.d.ts

@@ -0,0 +1,25 @@
+import type { SecretSink } from './log.types.ts';
+export declare const REDACTED = "***";
+/** Имя ключа секретное, если после приведения к snake_case оно содержит одно из слов целиком. */
+export declare const SECRET_KEY_PATTERN: RegExp;
+/** Redactor журнала: маскирует свободный текст и структурные значения, принимает известные секреты. */
+export type Redactor = {
+    /** Маскирует свободный текст: известные значения и шаблоны R1–R8. */
+    redactText(text: string): string;
+    /** Глубокая копия: ключи по isSecretKey → '***' (любое значение, кроме null и boolean); строки и сами имена ключей → redactText. */
+    redactValue(value: unknown): unknown;
+    /** Регистрирует известное значение секрета; короче 8 символов — игнорируется. */
+    addKnownSecret(value: string): void;
+};
+/** camelCase → snake, '-' и '.' → '_', нижний регистр, затем SECRET_KEY_PATTERN и окончания слитных имён. */
+export declare function isSecretKey(key: string): boolean;
+export declare function createRedactor(options?: {
+    knownSecrets?: readonly string[];
+}): Redactor;
+/** Свободный текст через redactor ядра: известные секреты (defaultSecretSink) и шаблоны R1–R8. */
+export declare function redactSecretText(text: string): string;
+/**
+ * Эталонный SecretSink библиотеки: регистрирует известные секреты в redactor ядра, которым
+ * маскирует redactSecretText. Потребитель со своим журналом может подменить шов своей реализацией.
+ */
+export declare const defaultSecretSink: SecretSink;

package/dist/kernel/store.types.d.ts

@@ -0,0 +1,109 @@
+import type { IssuePriority, IssueStatusCategory, Worktree, WorktreeStatus } from '../contract/contract.types.ts';
+/** Контекст записи: кто и когда; без них реализация берёт текущее время и не пишет actor. */
+export type WorktreeWriteContext = {
+    actor?: string | undefined;
+    ts?: number | undefined;
+};
+export type WorktreeCleanupFlags = {
+    /** Очистка выбрасывает незакоммиченные изменения: так решил вызывающий (worktree.remove force). */
+    discardChanges: boolean;
+    /** Ветку создал host: пустую (tip = база) очистка удаляет; чужую — никогда (onreel D-088). */
+    ownsBranch: boolean;
+};
+export type WorktreeCleanupInput = WorktreeWriteContext & {
+    /** Выбросить незакоммиченные изменения: решение вызывающего, запоминается до конца очистки. */
+    discardChanges?: boolean | undefined;
+    /** Ветка не host'а (существовала до создания): очистка её не удаляет. */
+    foreignBranch?: boolean | undefined;
+    /** Доказательство перехода: вывод git или пояснение host. */
+    evidence?: string | undefined;
+};
+/**
+ * Записи Worktree внутри открытой транзакции: последовательность вызовов применяется целиком
+ * или откатывается (единственный способ писать — через WorktreeStore.inTransaction).
+ */
+export type WorktreeTx = {
+    /** Вторая фаза создания: git создал worktree — preparing → ready с HEAD. */
+    markWorktreeReady(id: string, headSha: string, context?: WorktreeWriteContext): void;
+    /** Переводит Worktree в failed с причиной: из preparing или cleaning (onreel D-050). */
+    markWorktreeFailed(id: string, reason: string, context?: WorktreeWriteContext): void;
+    /** Первая фаза очистки: ready или failed → cleaning; запоминает discardChanges/foreignBranch. */
+    requestWorktreeCleanup(id: string, input?: WorktreeCleanupInput): void;
+    /** Финал очистки: cleaning → cleaned с моментом очистки. */
+    completeWorktreeCleanup(id: string, context?: WorktreeWriteContext): void;
+};
+/** Порт состояния Worktree: чтения — на самом порте, записи — только внутри inTransaction. */
+export type WorktreeStore = {
+    /**
+     * Единица работы (onreel inImmediateTransaction): fn выполняется в одной транзакции хранилища;
+     * исключение из fn откатывает все её записи. Вложенность и асинхронные fn не поддерживаются.
+     */
+    inTransaction<T>(fn: (tx: WorktreeTx) => T): T;
+    /** Запись Worktree по id; нет — undefined. */
+    getWorktree(id: string): Worktree | undefined;
+    /** Флаги очистки worktree; нет записи — оба флага false. */
+    worktreeCleanupFlags(id: string): WorktreeCleanupFlags;
+    /** Все Worktree в этих состояниях, порядок создания — для reconciler. */
+    worktreesInStatus(statuses: readonly WorktreeStatus[]): Worktree[];
+    /** Ready worktree терминальных задач без живых сессий — их чистит reconciler. */
+    readyWorktreesOfSettledTasks(): Worktree[];
+};
+/** Пагинация списков: всё скоупится и листается страницами, без неограниченных выборок. */
+export type PageInput = {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+};
+export type Page<T> = {
+    items: T[];
+    nextCursor?: string | undefined;
+};
+export type NewLocalIssue = {
+    title: string;
+    description?: string | undefined;
+    priority?: IssuePriority | undefined;
+    labels?: readonly string[] | undefined;
+    assignee?: string | undefined;
+};
+export type LocalIssuePatch = {
+    title?: string | undefined;
+    description?: string | undefined;
+    status?: IssueStatusCategory | undefined;
+    priority?: IssuePriority | undefined;
+    labels?: readonly string[] | undefined;
+    /** null снимает исполнителя. */
+    assignee?: string | null | undefined;
+};
+export type LocalIssueRow = {
+    number: number;
+    title: string;
+    description?: string | undefined;
+    status: IssueStatusCategory;
+    priority?: IssuePriority | undefined;
+    labels: string[];
+    assignee?: string | undefined;
+    createdAt: number;
+    updatedAt: number;
+};
+export type LocalCommentRow = {
+    id: number;
+    author?: string | undefined;
+    body: string;
+    createdAt: number;
+};
+export type ListLocalIssuesInput = PageInput & {
+    status?: readonly IssueStatusCategory[] | undefined;
+};
+/**
+ * Порт локального трекера: задачи проекта в хранилище потребителя, без внешних сервисов.
+ * Номер задачи выдаёт хранилище (монотонный в проекте); ts — для детерминированных тестов,
+ * по умолчанию текущее время.
+ */
+export type LocalIssueStore = {
+    createLocalIssue(projectId: string, input: NewLocalIssue, ts?: number): LocalIssueRow;
+    getLocalIssue(projectId: string, number: number): LocalIssueRow | undefined;
+    listLocalIssues(projectId: string, input?: ListLocalIssuesInput): Page<LocalIssueRow>;
+    /** Нет задачи — undefined. */
+    updateLocalIssue(projectId: string, number: number, patch: LocalIssuePatch, ts?: number): LocalIssueRow | undefined;
+    addLocalComment(projectId: string, number: number, body: string, author?: string, ts?: number): LocalCommentRow;
+    listLocalComments(projectId: string, number: number, input?: PageInput): Page<LocalCommentRow>;
+};

package/dist/kernel/umask.lib.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Выполняет action под umask mask и возвращает прежний umask, даже если action бросил.
+ * Только для синхронных действий: асинхронная функция вернула бы управление до своего завершения,
+ * и umask восстановился бы раньше, чем отработал её код. В worker-потоках process.umask(mask)
+ * бросает ERR_WORKER_UNSUPPORTED_OPERATION: ptyd и host запускают процессы из главного потока.
+ */
+export declare function withUmask<T>(mask: number, action: () => T): T;

package/dist/mcp/args.lib.d.ts

@@ -0,0 +1,17 @@
+import type { CommandSpec } from './mcp.types.ts';
+/** Длительность `<n>ms|s|m|h`, голое число — миллисекунды; неверная запись — undefined. */
+export declare function parseDuration(text: string): number | undefined;
+/**
+ * Флаги, без которых вызов не пройдёт проверку обязательных: required, и поле флага не заполнит ни env, ни default
+ * (его или другого флага того же поля), ни другой флаг того же поля, заданный явно. Это обязательные свойства
+ * входной схемы инструмента MCP.
+ */
+export declare function requiredFlagNames(spec: CommandSpec, env: NodeJS.ProcessEnv): string[];
+/**
+ * Аргументы вызова инструмента MCP (объект JSON) → значения флагов команды: тот же разбор, шаблоны, env,
+ * default, конфликт полей и проверка обязательных, что у argv. Ошибка — invalid_request (origin local).
+ */
+export declare function resolveJsonArguments(spec: CommandSpec, input: unknown, env: NodeJS.ProcessEnv, cwd: string): {
+    values: Readonly<Record<string, unknown>>;
+    requestId?: string;
+};

package/dist/mcp/envelope.lib.d.ts

@@ -0,0 +1,20 @@
+import type { ContractError } from '../contract/contract.types.ts';
+import type { CliOutput } from './mcp.schema.ts';
+import type { CommandFailure, CommandOutcome } from './mcp.types.ts';
+/** Ошибка вызова команды: контрактная ошибка, происхождение и requestId уже отправленного запроса. */
+export declare class CommandError extends Error implements CommandFailure {
+    readonly error: ContractError;
+    readonly origin: 'local' | 'host';
+    readonly requestId: string | null;
+    constructor(error: ContractError, origin: 'local' | 'host', requestId?: string | null, options?: ErrorOptions);
+}
+/** Ошибка вызова: команда, флаг или значение; запрос не отправлен. */
+export declare function usageError(message: string, nextSteps: [string, ...string[]], data?: Record<string, unknown>): CommandError;
+/** Неожиданный сбой сервера; известная ошибка исполнителя проходит без изменений. */
+export declare function internalError(cause: unknown): CommandError;
+/** Прерывание SIGINT или отмена вызова во время ожидания; requestId — уже отправленного запроса, если он был. */
+export declare function interruptedError(cause: unknown, requestId?: string | null): CommandError;
+/** Конверт успеха `--json`: {ok: true, requestId, duplicate, result}. */
+export declare function successEnvelope(outcome: CommandOutcome): CliOutput;
+/** Конверт отказа `--json`: {ok: false, requestId, error}. */
+export declare function failureEnvelope(error: CommandFailure): CliOutput;

package/dist/mcp/index.d.ts

@@ -0,0 +1,8 @@
+export * from './mcp.const.ts';
+export * from './mcp.schema.ts';
+export * from './mcp.types.ts';
+export * from './args.lib.ts';
+export * from './envelope.lib.ts';
+export * from './principal.lib.ts';
+export * from './server.lib.ts';
+export * from './tools.lib.ts';