@smwb/onreel-git-mcp 0.1.0 → 0.2.0

package/dist/chunk-L7CPE2SO.js

@@ -0,0 +1,166 @@
+// src/kernel/redact.lib.ts
+var REDACTED = "***";
+var SECRET_KEY_PATTERN = /(?:^|[^a-z])(?:token|secrets?|passw(?:or)?d|pass|passphrase|pwd|api_?key|apikey|authorization|auth|cookie|set_cookie|credentials?|private_?key|access_?key|session_?id|signature)(?:$|[^a-z])/;
+var SECRET_KEY_SUFFIX = /(?:token|secret|passw(?:or)?d|passphrase|apikey)$/;
+var ENV_KEY_SUFFIX = /(?:^|_)key$/;
+var secretKeyCache = /* @__PURE__ */ new Map();
+var SECRET_KEY_CACHE_MAX = 1e3;
+var SECRET_KEY_CACHE_KEY_MAX_CHARS = 128;
+function isSecretKey(key) {
+  const cacheable = key.length <= SECRET_KEY_CACHE_KEY_MAX_CHARS;
+  const cached = cacheable ? secretKeyCache.get(key) : void 0;
+  if (cached !== void 0) return cached;
+  const normalized = key.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[-.]/g, "_").toLowerCase();
+  const envStyle = !/[a-z]/.test(key);
+  const secret = SECRET_KEY_PATTERN.test(normalized) || SECRET_KEY_SUFFIX.test(normalized) || envStyle && ENV_KEY_SUFFIX.test(normalized);
+  if (cacheable) {
+    if (secretKeyCache.size >= SECRET_KEY_CACHE_MAX) secretKeyCache.clear();
+    secretKeyCache.set(key, secret);
+  }
+  return secret;
+}
+var MIN_KNOWN_SECRET_CHARS = 8;
+var PEM_PRIVATE_KEY = /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?(?:-----END [A-Z ]*PRIVATE KEY-----|$)/g;
+var ONREEL_TOKEN = /onr_[a-z]+_[A-Za-z0-9_-]{8,}/g;
+var VENDOR_KEY = /\b(?:sk-(?:ant-|proj-)?[A-Za-z0-9_-]{20,}|gh[pousr]_[A-Za-z0-9]{30,}|github_pat_[A-Za-z0-9_]{30,}|xox[abposr]-[A-Za-z0-9-]{10,}|AKIA[0-9A-Z]{16}|AIza[0-9A-Za-z_-]{35}|glpat-[A-Za-z0-9_-]{20,})\b/g;
+var JWT = /(?<![A-Za-z0-9_-])eyJ[A-Za-z0-9_-]{8,}\.eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}/g;
+var URL_USERINFO = (
+  // oxlint-disable-next-line no-control-regex -- ESC перед маркером: строка цветного diff.
+  /(?:(?<![a-z0-9+.-])|(?<=(?:^|[^a-z0-9+.-]|\x1b\[[0-9;]*m)[+-]))([a-z][a-z0-9+.-]{0,31}:\/\/)[^\s/@:]+:[^\s/@]+@/gim
+);
+var AUTH_SCHEME = /\b(Bearer|Basic|Token)\s+[A-Za-z0-9._~+/=-]{8,}/gi;
+var KEY_ASSIGNMENT = /(?<![A-Za-z0-9_.-])([A-Za-z][A-Za-z0-9_.-]{0,63})(["']?\s*[=:]\s*)(["']?)/g;
+var ASSIGNMENT_VALUE = /((?:Bearer|Basic|Token)[ \t]+)?[^\s"'&,;}]+/iy;
+var COOKIE_VALUE = /[^\r\n]+/y;
+var COOKIE_KEY = /^(?:set[_.-]?)?cookie$/i;
+var SECRET_KEYWORD = /token|secret|pass|pwd|key|auth|cookie|credential|session[_.-]?id|signature/i;
+var CLI_USER_HEAD = /(?<![^\s])(?:-u[ \t]*|--user(?:[ \t]+|=))(["']?)([^\s:"']+):/g;
+var CLI_PASSWORD = /[^\s"']+/y;
+var QUOTED_VALUE_MAX_CHARS = 4096;
+function quotedValueEnd(text, start, quote) {
+  const limit = Math.min(text.length, start + QUOTED_VALUE_MAX_CHARS);
+  for (let index = start; index < limit; index += 1) {
+    const char = text[index];
+    if (char === "\\") index += 1;
+    else if (char === quote) return index;
+  }
+  return limit;
+}
+function maskCliPasswords(text) {
+  if (!text.includes("-u")) return text;
+  const headPattern = new RegExp(CLI_USER_HEAD.source, "g");
+  const passwordPattern = new RegExp(CLI_PASSWORD.source, "y");
+  let result = "";
+  let copied = 0;
+  for (let head = headPattern.exec(text); head !== null; head = headPattern.exec(text)) {
+    let quote = head[1] ?? "";
+    let passwordStart = head.index + head[0].length;
+    const next = text[passwordStart];
+    if (quote === "" && (next === '"' || next === "'")) {
+      quote = next;
+      passwordStart += 1;
+    }
+    let passwordEnd;
+    if (quote !== "") {
+      passwordEnd = quotedValueEnd(text, passwordStart, quote);
+    } else {
+      passwordPattern.lastIndex = passwordStart;
+      const password = passwordPattern.exec(text);
+      passwordEnd = password === null ? passwordStart : passwordStart + password[0].length;
+    }
+    if (passwordEnd === passwordStart) continue;
+    result += text.slice(copied, passwordStart) + REDACTED;
+    copied = passwordEnd;
+    headPattern.lastIndex = copied;
+  }
+  return copied === 0 ? text : result + text.slice(copied);
+}
+function maskAssignments(text) {
+  if (!SECRET_KEYWORD.test(text)) return text;
+  const keyPattern = new RegExp(KEY_ASSIGNMENT.source, "g");
+  const valuePattern = new RegExp(ASSIGNMENT_VALUE.source, "iy");
+  const cookiePattern = new RegExp(COOKIE_VALUE.source, "y");
+  let result = "";
+  let copied = 0;
+  for (let match = keyPattern.exec(text); match !== null; match = keyPattern.exec(text)) {
+    const key = match[1] ?? "";
+    if (!isSecretKey(key)) continue;
+    const quote = match[3] ?? "";
+    const valueStart = match.index + match[0].length;
+    let scheme = "";
+    let valueEnd;
+    if (quote !== "") {
+      valueEnd = quotedValueEnd(text, valueStart, quote);
+      if (valueEnd === valueStart) continue;
+    } else {
+      const isCookie = COOKIE_KEY.test(key);
+      const pattern = isCookie ? cookiePattern : valuePattern;
+      pattern.lastIndex = valueStart;
+      const valueMatch = pattern.exec(text);
+      if (valueMatch === null) continue;
+      scheme = isCookie ? "" : valueMatch[1] ?? "";
+      valueEnd = valueStart + valueMatch[0].length;
+    }
+    result += text.slice(copied, valueStart) + scheme + REDACTED;
+    copied = valueEnd;
+    keyPattern.lastIndex = copied;
+  }
+  return copied === 0 ? text : result + text.slice(copied);
+}
+function createRedactor(options = {}) {
+  let known = [];
+  const addKnownSecret = (value) => {
+    if (value.length < MIN_KNOWN_SECRET_CHARS || known.includes(value)) return;
+    known = [...known, value].sort((a, b) => b.length - a.length);
+  };
+  for (const value of options.knownSecrets ?? []) addKnownSecret(value);
+  const redactText = (text) => {
+    let out = text;
+    for (const secret of known) {
+      if (out.includes(secret)) out = out.split(secret).join(secret.startsWith("onr_") ? "onr_***" : REDACTED);
+    }
+    out = out.replace(PEM_PRIVATE_KEY, `-----BEGIN PRIVATE KEY-----${REDACTED}`);
+    out = out.replace(ONREEL_TOKEN, "onr_***");
+    out = out.replace(VENDOR_KEY, REDACTED);
+    out = out.replace(JWT, REDACTED);
+    out = out.replace(URL_USERINFO, `$1${REDACTED}@`);
+    out = out.replace(AUTH_SCHEME, `$1 ${REDACTED}`);
+    return maskAssignments(maskCliPasswords(out));
+  };
+  const MAX_VALUE_DEPTH = 32;
+  const redactValue = (value, ancestors = []) => {
+    if (typeof value === "string") return redactText(value);
+    if (value === null || typeof value !== "object") return value;
+    if (ancestors.includes(value)) return "[Circular]";
+    if (ancestors.length >= MAX_VALUE_DEPTH) return "[Object]";
+    const path = [...ancestors, value];
+    if (Array.isArray(value)) return value.map((item) => redactValue(item, path));
+    const copy = {};
+    for (const key of Object.keys(value)) {
+      const item = value[key];
+      let maskedKey = redactText(key);
+      for (let n = 2; Object.hasOwn(copy, maskedKey); n += 1) maskedKey = `${redactText(key)}#${String(n)}`;
+      setOwn(copy, maskedKey, isSecretKey(key) && item !== null && typeof item !== "boolean" ? REDACTED : redactValue(item, path));
+    }
+    return copy;
+  };
+  return { redactText, redactValue: (value) => redactValue(value), addKnownSecret };
+}
+function setOwn(target, key, value) {
+  Object.defineProperty(target, key, { value, enumerable: true, writable: true, configurable: true });
+}
+var kernelRedactor = createRedactor();
+function redactSecretText(text) {
+  return kernelRedactor.redactText(text);
+}
+var defaultSecretSink = {
+  register(secret) {
+    kernelRedactor.addKnownSecret(secret);
+  }
+};
+
+export {
+  redactSecretText,
+  defaultSecretSink
+};
+//# sourceMappingURL=chunk-L7CPE2SO.js.map

package/dist/chunk-L7CPE2SO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/kernel/redact.lib.ts"],"sourcesContent":["// Маскирование секретов в текстах библиотеки @smwb/onreel-git-mcp (заморожено в части B выделения).\n// Происхождение — onreel @ b73407be076a5df73931d1340f70910ca13c908d:\n//   src/contract/log/log.lib.ts — движок createRedactor (правила R1–R8), дословная копия;\n//   src/contract/log/log.const.ts — REDACTED, SECRET_KEY_PATTERN, дословная копия;\n//   src/contract/log/log.types.ts — тип Redactor, дословная копия;\n//   src/host/redact.lib.ts — redactSecretText; в onreel она работает на redactor'е журнала host\n//     (hostLogger().redactor), которого в библиотеке нет, поэтому здесь — общий redactor уровня\n//     модуля; регистрация известных секретов идёт через defaultSecretSink (шов SecretSink,\n//     kernel/log.types.ts) на том же redactor'е — семантика onreel сохранена 1:1.\n// Побочных эффектов при импорте нет: redactor — чистый объект в памяти (R-001).\nimport type { SecretSink } from './log.types.ts';\n\nexport const REDACTED = '***';\n\n/** Имя ключа секретное, если после приведения к snake_case оно содержит одно из слов целиком. */\nexport const SECRET_KEY_PATTERN =\n  /(?:^|[^a-z])(?:token|secrets?|passw(?:or)?d|pass|passphrase|pwd|api_?key|apikey|authorization|auth|cookie|set_cookie|credentials?|private_?key|access_?key|session_?id|signature)(?:$|[^a-z])/;\n\n/** Redactor журнала: маскирует свободный текст и структурные значения, принимает известные секреты. */\nexport type Redactor = {\n  /** Маскирует свободный текст: известные значения и шаблоны R1–R8. */\n  redactText(text: string): string;\n  /** Глубокая копия: ключи по isSecretKey → '***' (любое значение, кроме null и boolean); строки и сами имена ключей → redactText. */\n  redactValue(value: unknown): unknown;\n  /** Регистрирует известное значение секрета; короче 8 символов — игнорируется. */\n  addKnownSecret(value: string): void;\n};\n\n// ---------------------------------------------------------------------------------------------\n// Маскирование (D-194)\n// ---------------------------------------------------------------------------------------------\n\n/** Однозначные слова как окончание слитного имени: `PGPASSWORD`, `MYSQLPASSWORD`, `APITOKEN`, `dbSecret`. */\nconst SECRET_KEY_SUFFIX = /(?:token|secret|passw(?:or)?d|passphrase|apikey)$/;\n/** Голое `key` как последнее слово — секрет только у имён в стиле env (`OPENAI_KEY`): у `push_key`, `manifest_key` это идентификаторы. */\nconst ENV_KEY_SUFFIX = /(?:^|_)key$/;\n\nconst secretKeyCache = new Map<string, boolean>();\nconst SECRET_KEY_CACHE_MAX = 1_000;\n/** Длинные имена в кеш не попадают: ключ data размером с мегабайт, помноженный на 1000 записей, держал бы гигабайт. */\nconst SECRET_KEY_CACHE_KEY_MAX_CHARS = 128;\n\n/** camelCase → snake, '-' и '.' → '_', нижний регистр, затем SECRET_KEY_PATTERN и окончания слитных имён. */\nexport function isSecretKey(key: string): boolean {\n  const cacheable = key.length <= SECRET_KEY_CACHE_KEY_MAX_CHARS;\n  const cached = cacheable ? secretKeyCache.get(key) : undefined;\n  if (cached !== undefined) return cached;\n  const normalized = key\n    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n    .replace(/[-.]/g, '_')\n    .toLowerCase();\n  const envStyle = !/[a-z]/.test(key);\n  const secret = SECRET_KEY_PATTERN.test(normalized) || SECRET_KEY_SUFFIX.test(normalized) || (envStyle && ENV_KEY_SUFFIX.test(normalized));\n  if (cacheable) {\n    if (secretKeyCache.size >= SECRET_KEY_CACHE_MAX) secretKeyCache.clear();\n    secretKeyCache.set(key, secret);\n  }\n  return secret;\n}\n\nconst MIN_KNOWN_SECRET_CHARS = 8;\n\n// Шаблоны R1–R7 применяются после R8. Все линейные по длине входа: у каждого начало совпадения\n// привязано к границе (\\b или lookbehind), чтобы длинный ряд символов не перебирался с каждой позиции.\nconst PEM_PRIVATE_KEY = /-----BEGIN [A-Z ]*PRIVATE KEY-----[\\s\\S]*?(?:-----END [A-Z ]*PRIVATE KEY-----|$)/g;\nconst ONREEL_TOKEN = /onr_[a-z]+_[A-Za-z0-9_-]{8,}/g;\nconst VENDOR_KEY =\n  /\\b(?:sk-(?:ant-|proj-)?[A-Za-z0-9_-]{20,}|gh[pousr]_[A-Za-z0-9]{30,}|github_pat_[A-Za-z0-9_]{30,}|xox[abposr]-[A-Za-z0-9-]{10,}|AKIA[0-9A-Z]{16}|AIza[0-9A-Za-z_-]{35}|glpat-[A-Za-z0-9_-]{20,})\\b/g;\nconst JWT = /(?<![A-Za-z0-9_-])eyJ[A-Za-z0-9_-]{8,}\\.eyJ[A-Za-z0-9_-]{8,}\\.[A-Za-z0-9_-]{8,}/g;\n// Перед схемой допустим один маркер `+`/`-`, если он начинает токен (начало строки, несхемный символ или\n// SGR-escape): так маскируется URL в строке diff, в том числе цветной (`\\x1b[32m+https://u:p@h`).\nconst URL_USERINFO =\n  // oxlint-disable-next-line no-control-regex -- ESC перед маркером: строка цветного diff.\n  /(?:(?<![a-z0-9+.-])|(?<=(?:^|[^a-z0-9+.-]|\\x1b\\[[0-9;]*m)[+-]))([a-z][a-z0-9+.-]{0,31}:\\/\\/)[^\\s/@:]+:[^\\s/@]+@/gim;\nconst AUTH_SCHEME = /\\b(Bearer|Basic|Token)\\s+[A-Za-z0-9._~+/=-]{8,}/gi;\n// R3 разбит на поиск «ключ + разделитель» и ручное чтение значения: значение несекретного ключа\n// не съедается, и `url=http://h/?access_token=abc` всё равно доходит до access_token.\nconst KEY_ASSIGNMENT = /(?<![A-Za-z0-9_.-])([A-Za-z][A-Za-z0-9_.-]{0,63})([\"']?\\s*[=:]\\s*)([\"']?)/g;\nconst ASSIGNMENT_VALUE = /((?:Bearer|Basic|Token)[ \\t]+)?[^\\s\"'&,;}]+/iy;\n// Значение cookie — вся строка заголовка: `Cookie: theme=dark; sid=…`, а не до первой `;`.\nconst COOKIE_VALUE = /[^\\r\\n]+/y;\nconst COOKIE_KEY = /^(?:set[_.-]?)?cookie$/i;\n// Грубый предфильтр R3: нет ни одного слова из SECRET_KEY_PATTERN — разбирать присваивания незачем.\nconst SECRET_KEYWORD = /token|secret|pass|pwd|key|auth|cookie|credential|session[_.-]?id|signature/i;\n// Пароль в аргументах curl и подобных: `-u user:pass`, `-uuser:pass`, `--user user:pass`, `--user=user:pass`.\n// Имя пользователя остаётся. Здесь только голова до двоеточия: классы разделителя и имени не пересекаются\n// (общий `[ \\t=]+` и `[^\\s:\"']+` оба принимали `=` и давали квадратичный перебор на ` -u ====…`), а сам\n// пароль читает maskCliPasswords, чтобы пароль в кавычках с пробелами маскировался целиком.\nconst CLI_USER_HEAD = /(?<![^\\s])(?:-u[ \\t]*|--user(?:[ \\t]+|=))([\"']?)([^\\s:\"']+):/g;\nconst CLI_PASSWORD = /[^\\s\"']+/y;\n/** Потолок значения в кавычках: поиск закрывающей кавычки остаётся линейным по входу. */\nconst QUOTED_VALUE_MAX_CHARS = 4_096;\n\n/**\n * Конец значения в кавычках: позиция закрывающей кавычки того же вида, `\\`-экранирование учитывается.\n * Закрывающей нет в пределах потолка — значение режется по потолку или концу текста: лучше замаскировать\n * лишнее, чем оставить хвост секрета.\n */\nfunction quotedValueEnd(text: string, start: number, quote: string): number {\n  const limit = Math.min(text.length, start + QUOTED_VALUE_MAX_CHARS);\n  for (let index = start; index < limit; index += 1) {\n    const char = text[index];\n    if (char === '\\\\') index += 1;\n    else if (char === quote) return index;\n  }\n  return limit;\n}\n\n/** Пароль после `-u user:` / `--user user:`: слово без кавычек либо значение в кавычках целиком, с пробелами внутри. */\nfunction maskCliPasswords(text: string): string {\n  if (!text.includes('-u')) return text;\n  const headPattern = new RegExp(CLI_USER_HEAD.source, 'g');\n  const passwordPattern = new RegExp(CLI_PASSWORD.source, 'y');\n  let result = '';\n  let copied = 0;\n  for (let head = headPattern.exec(text); head !== null; head = headPattern.exec(text)) {\n    let quote = head[1] ?? '';\n    let passwordStart = head.index + head[0].length;\n    // Кавычки только вокруг пароля: `-u admin:\"two words\"`.\n    const next = text[passwordStart];\n    if (quote === '' && (next === '\"' || next === \"'\")) {\n      quote = next;\n      passwordStart += 1;\n    }\n    let passwordEnd: number;\n    if (quote !== '') {\n      passwordEnd = quotedValueEnd(text, passwordStart, quote);\n    } else {\n      passwordPattern.lastIndex = passwordStart;\n      const password = passwordPattern.exec(text);\n      passwordEnd = password === null ? passwordStart : passwordStart + password[0].length;\n    }\n    // Пустой пароль маскировать нечем; поиск продолжается сразу за головой.\n    if (passwordEnd === passwordStart) continue;\n    result += text.slice(copied, passwordStart) + REDACTED;\n    copied = passwordEnd;\n    headPattern.lastIndex = copied;\n  }\n  return copied === 0 ? text : result + text.slice(copied);\n}\n\nfunction maskAssignments(text: string): string {\n  if (!SECRET_KEYWORD.test(text)) return text;\n  const keyPattern = new RegExp(KEY_ASSIGNMENT.source, 'g');\n  const valuePattern = new RegExp(ASSIGNMENT_VALUE.source, 'iy');\n  const cookiePattern = new RegExp(COOKIE_VALUE.source, 'y');\n  let result = '';\n  let copied = 0;\n  for (let match = keyPattern.exec(text); match !== null; match = keyPattern.exec(text)) {\n    const key = match[1] ?? '';\n    if (!isSecretKey(key)) continue;\n    const quote = match[3] ?? '';\n    const valueStart = match.index + match[0].length;\n    let scheme = '';\n    let valueEnd: number;\n    if (quote !== '') {\n      // Значение в кавычках целиком, с пробелами внутри; закрывающая кавычка остаётся в тексте.\n      valueEnd = quotedValueEnd(text, valueStart, quote);\n      if (valueEnd === valueStart) continue;\n    } else {\n      const isCookie = COOKIE_KEY.test(key);\n      const pattern = isCookie ? cookiePattern : valuePattern;\n      pattern.lastIndex = valueStart;\n      const valueMatch = pattern.exec(text);\n      if (valueMatch === null) continue;\n      scheme = isCookie ? '' : (valueMatch[1] ?? '');\n      valueEnd = valueStart + valueMatch[0].length;\n    }\n    result += text.slice(copied, valueStart) + scheme + REDACTED;\n    copied = valueEnd;\n    keyPattern.lastIndex = copied;\n  }\n  return copied === 0 ? text : result + text.slice(copied);\n}\n\nexport function createRedactor(options: { knownSecrets?: readonly string[] } = {}): Redactor {\n  // Длинные значения первыми: короткое значение не должно оставить хвост длинного, которое его содержит.\n  let known: string[] = [];\n  const addKnownSecret = (value: string): void => {\n    if (value.length < MIN_KNOWN_SECRET_CHARS || known.includes(value)) return;\n    known = [...known, value].sort((a, b) => b.length - a.length);\n  };\n  for (const value of options.knownSecrets ?? []) addKnownSecret(value);\n\n  const redactText = (text: string): string => {\n    let out = text;\n    for (const secret of known) {\n      // Токен onreel и как известное значение остаётся `onr_***`: так его узнают по журналу (D-047).\n      if (out.includes(secret)) out = out.split(secret).join(secret.startsWith('onr_') ? 'onr_***' : REDACTED);\n    }\n    out = out.replace(PEM_PRIVATE_KEY, `-----BEGIN PRIVATE KEY-----${REDACTED}`);\n    out = out.replace(ONREEL_TOKEN, 'onr_***');\n    out = out.replace(VENDOR_KEY, REDACTED);\n    out = out.replace(JWT, REDACTED);\n    out = out.replace(URL_USERINFO, `$1${REDACTED}@`);\n    out = out.replace(AUTH_SCHEME, `$1 ${REDACTED}`);\n    return maskAssignments(maskCliPasswords(out));\n  };\n\n  const MAX_VALUE_DEPTH = 32;\n  const redactValue = (value: unknown, ancestors: object[] = []): unknown => {\n    if (typeof value === 'string') return redactText(value);\n    if (value === null || typeof value !== 'object') return value;\n    if (ancestors.includes(value)) return '[Circular]';\n    if (ancestors.length >= MAX_VALUE_DEPTH) return '[Object]';\n    const path = [...ancestors, value];\n    if (Array.isArray(value)) return value.map((item) => redactValue(item, path));\n    const copy: Record<string, unknown> = {};\n    for (const key of Object.keys(value)) {\n      const item = (value as Record<string, unknown>)[key];\n      // Сам ключ тоже текст: словарь «токен → состояние» не должен выдать токен именем ключа.\n      let maskedKey = redactText(key);\n      // Два разных секрета дают одно замаскированное имя: суффикс сохраняет обе записи.\n      for (let n = 2; Object.hasOwn(copy, maskedKey); n += 1) maskedKey = `${redactText(key)}#${String(n)}`;\n      setOwn(copy, maskedKey, isSecretKey(key) && item !== null && typeof item !== 'boolean' ? REDACTED : redactValue(item, path));\n    }\n    return copy;\n  };\n\n  return { redactText, redactValue: (value) => redactValue(value), addKnownSecret };\n}\n\n/** Присваивание без сеттера прототипа: ключ `__proto__` из данных остаётся обычным ключом. */\nfunction setOwn(target: Record<string, unknown>, key: string, value: unknown): void {\n  Object.defineProperty(target, key, { value, enumerable: true, writable: true, configurable: true });\n}\n\n// ---------------------------------------------------------------------------------------------\n// Redactor уровня библиотеки: общий для redactSecretText и defaultSecretSink, как redactor\n// журнала host в onreel общий для redactSecretText и registerLogSecret.\n// ---------------------------------------------------------------------------------------------\n\nconst kernelRedactor = createRedactor();\n\n/** Свободный текст через redactor ядра: известные секреты (defaultSecretSink) и шаблоны R1–R8. */\nexport function redactSecretText(text: string): string {\n  return kernelRedactor.redactText(text);\n}\n\n/**\n * Эталонный SecretSink библиотеки: регистрирует известные секреты в redactor ядра, которым\n * маскирует redactSecretText. Потребитель со своим журналом может подменить шов своей реализацией.\n */\nexport const defaultSecretSink: SecretSink = {\n  register(secret: string): void {\n    kernelRedactor.addKnownSecret(secret);\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/contract/contract.const.d.ts

@@ -0,0 +1,190 @@
+import type { ContractVersion } from './contract.types.ts';
+/** Имя файла обнаружения host в каталоге данных (onreel D-046). */
+export declare const HOST_DISCOVERY_FILE = "host.json";
+/** Адрес host для процесса агента: агенты не читают host.json, а получают адрес и свой токен в env. */
+export declare const ENV_HOST_URL = "ONREEL_HOST_URL";
+/** Токен агента в env его процесса. */
+export declare const ENV_TOKEN = "ONREEL_TOKEN";
+/** Идентификаторы Run, Task и попытки в env процесса агента (onreel D-226): воркер отчитывается ими в worker_done. */
+export declare const ENV_RUN_ID = "ONREEL_RUN_ID";
+export declare const ENV_TASK_ID = "ONREEL_TASK_ID";
+export declare const ENV_DISPATCH_ID = "ONREEL_DISPATCH_ID";
+/** Переменная окружения: восьмеричная маска пользователя («0022»), её первым записывает самый ранний процесс цепочки. */
+export declare const ENV_SESSION_UMASK = "ONREEL_SESSION_UMASK";
+/** Маска сессий, если переменная не задана или не разобралась: обычный umask пользователя. */
+export declare const DEFAULT_SESSION_UMASK = 18;
+/**
+ * Версия контракта host onreel на момент выделения (1.14). Заморожена для межпроцессной
+ * совместимости MCP-сервера с host onreel; история изменений — в onreel version.const.ts.
+ */
+export declare const HOST_CONTRACT_VERSION: Readonly<ContractVersion>;
+export declare const errorCatalog: {
+    readonly invalid_request: {
+        readonly status: 400;
+        readonly summary: 'Запрос не прошёл проверку схемы контракта.';
+    };
+    readonly unauthorized: {
+        readonly status: 401;
+        readonly summary: 'Нет токена, или токен недействителен, истёк или отозван.';
+    };
+    readonly permission_denied: {
+        readonly status: 403;
+        readonly summary: 'Запрос шире scope токена.';
+    };
+    readonly not_found: {
+        readonly status: 404;
+        readonly summary: 'Сущность не найдена.';
+    };
+    readonly contract_incompatible: {
+        readonly status: 426;
+        readonly summary: 'Версии контракта сторон несовместимы (разница major больше допустимой).';
+    };
+    readonly capability_unsupported: {
+        readonly status: 400;
+        readonly summary: 'Глагол или значение требует capability, которой нет в согласованном наборе.';
+    };
+    readonly request_id_reused: {
+        readonly status: 409;
+        readonly summary: 'Тот же requestId уже использован для другого запроса.';
+    };
+    readonly rate_limited: {
+        readonly status: 429;
+        readonly summary: 'Слишком много запросов.';
+    };
+    readonly internal: {
+        readonly status: 500;
+        readonly summary: 'Внутренняя ошибка.';
+    };
+    readonly unavailable: {
+        readonly status: 503;
+        readonly summary: 'Сервис временно недоступен: host или ptyd не отвечает.';
+    };
+    readonly lifecycle_conflict: {
+        readonly status: 409;
+        readonly summary: 'Переход из текущего состояния сущности не разрешён.';
+    };
+    readonly unknown_task: {
+        readonly status: 404;
+        readonly summary: 'Task не найден.';
+    };
+    readonly unknown_dispatch: {
+        readonly status: 404;
+        readonly summary: 'Dispatch не найден.';
+    };
+    readonly task_dispatch_mismatch: {
+        readonly status: 409;
+        readonly summary: 'Dispatch не принадлежит этой Task.';
+    };
+    readonly stale_dispatch: {
+        readonly status: 409;
+        readonly summary: 'Попытка уже не авторитетна: у Task другой активный Dispatch.';
+    };
+    readonly inactive_dispatch: {
+        readonly status: 409;
+        readonly summary: 'Dispatch уже settled.';
+    };
+    readonly consumer_fenced: {
+        readonly status: 409;
+        readonly summary: 'Потребитель mailbox заменён: consumer_generation вырос.';
+    };
+    readonly budget_exceeded: {
+        readonly status: 409;
+        readonly summary: 'Лимит бюджета исчерпан.';
+    };
+    readonly unknown_session: {
+        readonly status: 404;
+        readonly summary: 'Сессия ptyd не найдена.';
+    };
+    readonly session_exited: {
+        readonly status: 409;
+        readonly summary: 'Процесс сессии уже завершился.';
+    };
+    readonly spawn_failed: {
+        readonly status: 422;
+        readonly summary: 'Процесс не запустился.';
+    };
+    readonly lease_conflict: {
+        readonly status: 409;
+        readonly summary: 'Lease задачи держит другой исполнитель незавершённой попытки.';
+    };
+    readonly lease_fenced: {
+        readonly status: 409;
+        readonly summary: 'Владелец lease не доказан: fencing-токен устарел или процесс не совпал с сессией ptyd.';
+    };
+    readonly lease_expired: {
+        readonly status: 409;
+        readonly summary: 'Lease задачи закрыт: освобождён или попытка settled.';
+    };
+    readonly claim_conflict: {
+        readonly status: 409;
+        readonly summary: 'Задачу уже взял другой участник.';
+    };
+    readonly ownership_conflict: {
+        readonly status: 409;
+        readonly summary: 'Зона ответственности задачи пересекается с чужим claim.';
+    };
+    readonly host_not_live: {
+        readonly status: 409;
+        readonly summary: 'Home Dispatch участника не live.';
+    };
+    readonly claim_limit: {
+        readonly status: 409;
+        readonly summary: 'У участника уже максимум активных claims.';
+    };
+    readonly not_assignee: {
+        readonly status: 403;
+        readonly summary: 'Задача назначена другому участнику.';
+    };
+    readonly messaging_denied: {
+        readonly status: 403;
+        readonly summary: 'Политика команды запрещает это сообщение.';
+    };
+    readonly plan_required: {
+        readonly status: 409;
+        readonly summary: 'Задача требует одобренного плана.';
+    };
+    readonly member_name_taken: {
+        readonly status: 409;
+        readonly summary: 'Имя участника в Run занято.';
+    };
+    readonly git_failed: {
+        readonly status: 422;
+        readonly summary: 'Git-команда не выполнилась: репозиторий повреждён, ref не существует или команда отклонена.';
+    };
+    readonly unknown_project: {
+        readonly status: 404;
+        readonly summary: 'Проект не найден в реестре.';
+    };
+    readonly project_exists: {
+        readonly status: 409;
+        readonly summary: 'Путь или id уже заняты другим проектом.';
+    };
+    readonly tracker_failed: {
+        readonly status: 502;
+        readonly summary: 'Внешний трекер отказал или не ответил: адрес, токен или права не подходят.';
+    };
+    readonly unknown_issue: {
+        readonly status: 404;
+        readonly summary: 'Задача не найдена в трекере проекта.';
+    };
+    readonly agent_unavailable: {
+        readonly status: 422;
+        readonly summary: 'Агент не установлен, probe не прошёл или fallback невозможен.';
+    };
+    readonly agent_untrusted: {
+        readonly status: 403;
+        readonly summary: 'Манифест агента из репозитория проекта не доверен.';
+    };
+    readonly sandbox_unavailable: {
+        readonly status: 422;
+        readonly summary: 'Запрошенный уровень песочницы на этой машине недоступен: нет механизма ОС.';
+    };
+};
+export type ErrorCode = keyof typeof errorCatalog;
+export declare const CONTRACT_ERROR_MESSAGE_MAX = 4000;
+export declare const CONTRACT_ERROR_NEXT_STEP_MAX = 1000;
+/** Максимум записей каталога в ответе worktree.files; остальное отсекается с `truncated`. */
+export declare const WORKTREE_FILES_MAX = 1000;
+/** Причины отказов worktree.files в `data.reason` (onreel D-367). */
+export declare const WORKTREE_FILES_REASONS: readonly ['outside_worktree', 'excluded', 'not_directory', 'unreadable', 'missing_on_disk', 'unsafe_path'];
+export type WorktreeFilesReason = (typeof WORKTREE_FILES_REASONS)[number];

package/dist/contract/contract.lib.d.ts

@@ -0,0 +1,22 @@
+import { type ErrorCode } from './contract.const.ts';
+import type { ContractError, ContractVersion } from './contract.types.ts';
+/** Обрезает строку до `max` символов с многоточием: в ошибку попадает и чужой ввод неизвестной длины. */
+export declare function clip(text: string, max: number): string;
+/**
+ * Собирает ошибку и проверяет её схемой: длинные `message` и шаги обрезаются, а пустой шаг —
+ * ошибка программиста, и функция бросает исключение, а не отдаёт клиенту ответ, который он не разберёт.
+ */
+export declare function contractError(code: ErrorCode, message: string, nextSteps: [string, ...string[]], data?: Record<string, unknown>): ContractError;
+export declare function formatVersion(version: ContractVersion): string;
+/** Разбирает восьмеричную маску без префикса: 1-4 цифры 0-7, не больше 0o777; иначе undefined. Пробелы не срезаются. */
+export declare function parseUmask(value: string | undefined): number | undefined;
+/** Маска как четыре восьмеричные цифры: 0o22 -> «0022». */
+export declare function formatUmask(mask: number): string;
+/** Маска сессий из env; нет переменной или она неверна — DEFAULT_SESSION_UMASK. */
+export declare function sessionUmask(env: Readonly<Record<string, string | undefined>>): number;
+/**
+ * Записывает current в env, если там нет верной маски, и возвращает маску сессий.
+ * Верное значение, уже стоящее в env, не перезаписывается: его задал более ранний процесс цепочки
+ * (CLI, Electron, systemd), а значение неверное считается незаданным.
+ */
+export declare function inheritSessionUmask(env: Record<string, string | undefined>, current: number): number;