@smwb/onreel-git-mcp 0.1.0 → 0.2.1

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,5 @@
-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';
+export declare const VERSION: string;

package/dist/index.js

@@ -1,6 +1,207 @@
+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";
+
+// package.json
+var package_default = {
+  name: "@smwb/onreel-git-mcp",
+  version: "0.2.1",
+  description: "\u0411\u0438\u0431\u043B\u0438\u043E\u0442\u0435\u043A\u0430 \u043C\u043E\u0434\u0443\u043B\u0435\u0439, \u0432\u044B\u0434\u0435\u043B\u0435\u043D\u043D\u044B\u0445 \u0438\u0437 onreel: git-\u043E\u043F\u0435\u0440\u0430\u0446\u0438\u0438 \u0438 \u0431\u0435\u0437\u043E\u043F\u0430\u0441\u043D\u044B\u0435 \u043F\u0443\u0442\u0438, \u0441\u043F\u0438\u0441\u043E\u043A \u0444\u0430\u0439\u043B\u043E\u0432 worktree, \u0436\u0438\u0437\u043D\u0435\u043D\u043D\u044B\u0439 \u0446\u0438\u043A\u043B worktree \u043F\u0440\u043E\u0442\u0438\u0432 \u043F\u043E\u0440\u0442\u0430 WorktreeStore, \u0430\u0434\u0430\u043F\u0442\u0435\u0440\u044B \u0442\u0440\u0435\u043A\u0435\u0440\u043E\u0432 GitHub/GitLab/Jira/SourceCraft/\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u0433\u043E \u0438 MCP-\u0441\u0435\u0440\u0432\u0435\u0440 \u043D\u0430 stdio",
+  keywords: [
+    "git",
+    "worktree",
+    "mcp",
+    "issue-tracker",
+    "github",
+    "gitlab",
+    "jira",
+    "sourcecraft",
+    "onreel",
+    "typescript"
+  ],
+  type: "module",
+  engines: {
+    node: ">=24"
+  },
+  files: [
+    "dist"
+  ],
+  sideEffects: false,
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org/"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://git.sourcecraft.dev/elfenmail/onreel-git-mcp.git"
+  },
+  homepage: "https://git.sourcecraft.dev/elfenmail/onreel-git-mcp",
+  license: "MIT",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      default: "./dist/index.js"
+    },
+    "./git": {
+      types: "./dist/git/index.d.ts",
+      import: "./dist/git/index.js",
+      default: "./dist/git/index.js"
+    },
+    "./files": {
+      types: "./dist/files/index.d.ts",
+      import: "./dist/files/index.js",
+      default: "./dist/files/index.js"
+    },
+    "./worktree": {
+      types: "./dist/worktree/index.d.ts",
+      import: "./dist/worktree/index.js",
+      default: "./dist/worktree/index.js"
+    },
+    "./tracker": {
+      types: "./dist/tracker/index.d.ts",
+      import: "./dist/tracker/index.js",
+      default: "./dist/tracker/index.js"
+    },
+    "./mcp": {
+      types: "./dist/mcp/index.d.ts",
+      import: "./dist/mcp/index.js",
+      default: "./dist/mcp/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  scripts: {
+    build: "tsup && tsc -p tsconfig.build.json",
+    typecheck: "tsc -p tsconfig.json && tsc -p tsconfig.examples.json",
+    lint: "oxlint --type-aware",
+    test: 'node --test "test/**/*.test.ts"',
+    changeset: "changeset",
+    version: "changeset version",
+    release: "npm run build && changeset publish"
+  },
+  dependencies: {
+    zod: "^4.6.5"
+  },
+  devDependencies: {
+    "@changesets/cli": "2.29.2",
+    "@types/node": "24.19.1",
+    oxlint: "1.87.0",
+    "oxlint-tsgolint": "7.0.2003",
+    tsup: "8.5.1",
+    typescript: "7.0.2"
+  }
+};
+
 // src/index.ts
-var VERSION = "0.0.0";
+var VERSION = package_default.version;
 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":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@smwb/onreel-git-mcp\",\n  \"version\": \"0.2.1\",\n  \"description\": \"Библиотека модулей, выделенных из onreel: git-операции и безопасные пути, список файлов worktree, жизненный цикл worktree против порта WorktreeStore, адаптеры трекеров GitHub/GitLab/Jira/SourceCraft/локального и MCP-сервер на stdio\",\n  \"keywords\": [\n    \"git\",\n    \"worktree\",\n    \"mcp\",\n    \"issue-tracker\",\n    \"github\",\n    \"gitlab\",\n    \"jira\",\n    \"sourcecraft\",\n    \"onreel\",\n    \"typescript\"\n  ],\n  \"type\": \"module\",\n  \"engines\": {\n    \"node\": \">=24\"\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"sideEffects\": false,\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"registry\": \"https://registry.npmjs.org/\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://git.sourcecraft.dev/elfenmail/onreel-git-mcp.git\"\n  },\n  \"homepage\": \"https://git.sourcecraft.dev/elfenmail/onreel-git-mcp\",\n  \"license\": \"MIT\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./git\": {\n      \"types\": \"./dist/git/index.d.ts\",\n      \"import\": \"./dist/git/index.js\",\n      \"default\": \"./dist/git/index.js\"\n    },\n    \"./files\": {\n      \"types\": \"./dist/files/index.d.ts\",\n      \"import\": \"./dist/files/index.js\",\n      \"default\": \"./dist/files/index.js\"\n    },\n    \"./worktree\": {\n      \"types\": \"./dist/worktree/index.d.ts\",\n      \"import\": \"./dist/worktree/index.js\",\n      \"default\": \"./dist/worktree/index.js\"\n    },\n    \"./tracker\": {\n      \"types\": \"./dist/tracker/index.d.ts\",\n      \"import\": \"./dist/tracker/index.js\",\n      \"default\": \"./dist/tracker/index.js\"\n    },\n    \"./mcp\": {\n      \"types\": \"./dist/mcp/index.d.ts\",\n      \"import\": \"./dist/mcp/index.js\",\n      \"default\": \"./dist/mcp/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup && tsc -p tsconfig.build.json\",\n    \"typecheck\": \"tsc -p tsconfig.json && tsc -p tsconfig.examples.json\",\n    \"lint\": \"oxlint --type-aware\",\n    \"test\": \"node --test \\\"test/**/*.test.ts\\\"\",\n    \"changeset\": \"changeset\",\n    \"version\": \"changeset version\",\n    \"release\": \"npm run build && changeset publish\"\n  },\n  \"dependencies\": {\n    \"zod\": \"^4.6.5\"\n  },\n  \"devDependencies\": {\n    \"@changesets/cli\": \"2.29.2\",\n    \"@types/node\": \"24.19.1\",\n    \"oxlint\": \"1.87.0\",\n    \"oxlint-tsgolint\": \"7.0.2003\",\n    \"tsup\": \"8.5.1\",\n    \"typescript\": \"7.0.2\"\n  }\n}\n","// Корневой подпуть пакета @smwb/onreel-git-mcp: срез контракта (константы, схемы, типы, чистые\n// функции) и версия пакета. Всё без побочных эффектов при импорте (R-001). Швы ядра\n// (SecretSink, WorktreeStore, LocalIssueStore) и модули git/files/worktree/tracker/mcp\n// экспортируют свои подпути — см. exports в package.json и README.\nimport pkg from '../package.json' with { type: 'json' };\n\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: статический импорт JSON, его значение tsup подставляет\n// в бандл на сборке, поэтому VERSION не расходится с релизом changesets (тот правит только version).\nexport const VERSION: string = pkg.version;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,aAAe;AAAA,EACf,UAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,MAAQ;AAAA,EACR,SAAW;AAAA,IACT,MAAQ;AAAA,EACV;AAAA,EACA,OAAS;AAAA,IACP;AAAA,EACF;AAAA,EACA,aAAe;AAAA,EACf,eAAiB;AAAA,IACf,QAAU;AAAA,IACV,UAAY;AAAA,EACd;AAAA,EACA,YAAc;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,EACT;AAAA,EACA,UAAY;AAAA,EACZ,SAAW;AAAA,EACX,SAAW;AAAA,IACT,KAAK;AAAA,MACH,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,SAAS;AAAA,MACP,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,WAAW;AAAA,MACT,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,cAAc;AAAA,MACZ,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,aAAa;AAAA,MACX,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,SAAS;AAAA,MACP,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,kBAAkB;AAAA,EACpB;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,WAAa;AAAA,IACb,MAAQ;AAAA,IACR,MAAQ;AAAA,IACR,WAAa;AAAA,IACb,SAAW;AAAA,IACX,SAAW;AAAA,EACb;AAAA,EACA,cAAgB;AAAA,IACd,KAAO;AAAA,EACT;AAAA,EACA,iBAAmB;AAAA,IACjB,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,QAAU;AAAA,IACV,mBAAmB;AAAA,IACnB,MAAQ;AAAA,IACR,YAAc;AAAA,EAChB;AACF;;;AC1EO,IAAM,UAAkB,gBAAI;","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';