@rt-tools/agent-kit 0.9.1 → 0.11.0

package/lib/thresholds.js

@@ -0,0 +1,151 @@
+/**
+ * Пороги окна захода: где заход останавливается и где инструмент сжимает контекст сам.
+ *
+ * Чисел два, и живут они в разных местах чужой настройки. Размер окна и доля, на которой страж
+ * останавливает заход, приходят переменными окружения — их читает профиль дерева. Порог, на
+ * котором инструмент сжимает контекст, задаётся своей парой: размером окна автосжатия и долей в
+ * процентах. Пакет ни тем ни другим не владеет — окно принадлежит дереву.
+ *
+ * Разъехавшись, пары дают заход, который либо сжимается раньше, чем передача написана, либо
+ * доживает до предела окна и роняет работу. Заметить это нечем: обе стороны по отдельности
+ * выглядят настроенными, а расхождение видно только тому, кто положит их рядом. Здесь их и
+ * кладут рядом — разбор состояния раскладки печатает числа и называет разошедшееся.
+ *
+ * Сведёнными считаются РАЗВЕДЁННЫЕ доли, а не совпавшие. Порог сжатия обязан стоять ниже порога
+ * остановки: первым обязано срабатывать то, что заход продолжает, а не то, что его
+ * останавливает. Совпавшая пара — гонка, и выигрывает её страж: он стоит на вызове инструмента,
+ * а сжатие приходит между ходами. Ровно так заход и вставал на пороге вместо того, чтобы
+ * продолжиться сжатым, — при том что прежняя сверка обе стороны считала настроенными и молчала.
+ *
+ * Насколько ниже — своё число дерева, `RT_WINDOW_MARGIN_PCT`. Запас объявляется, а не выводится
+ * разницей: сжатие идёт не мгновенно, и разница в один процент требование «ниже» удовлетворяет,
+ * а работу не спасает.
+ *
+ * Размер окна при этом сверяется по-прежнему на равенство: это одно и то же окно, названное в
+ * двух местах, и разные числа там означают, что одна из сторон считает долю не от того.
+ *
+ * Дерево, не объявившее размера окна, стража не получает вовсе, и судить у него нечего: раздел
+ * молчит целиком, а не краснеет отсутствием.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { SETTINGS_PATH } from './hooks-map.js';
+/** Доля окна, на которой страж напоминает выбрать точку остановки. Умолчание профиля. */
+const WARN_PCT_DEFAULT = 40;
+/** Доля окна, на которой страж отбивает всё, кроме закрытия захода. Умолчание профиля. */
+const STOP_PCT_DEFAULT = 50;
+/** На сколько долей окна порог сжатия обязан стоять ниже порога остановки. Умолчание профиля. */
+const MARGIN_PCT_DEFAULT = 5;
+/**
+ * Число из строки настройки. Пусто, не число, ноль и меньше — ничего: значение, которого нельзя
+ * посчитать, объявленным не считается, иначе расхождением станет опечатка, а не расхождение.
+ */
+function numberOf(value) {
+    const parsed = typeof value === 'number' ? value : Number.parseInt(String(value ?? ''), 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+}
+/**
+ * Что дерево объявило о порогах.
+ *
+ * Настройку читаем разбором и только им: пороги лежат полями объекта, и вынуть их из текста
+ * поиском значило бы гадать. Не разобралась — молчим целиком, как молчит карта хуков: назвать
+ * расхождением непрочитанное хуже, чем не назвать ничего.
+ */
+export function readThresholds(root) {
+    const path = join(root, SETTINGS_PATH);
+    if (!existsSync(path)) {
+        return null;
+    }
+    let settings;
+    try {
+        settings = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    const env = settings['env'] ?? {};
+    const windowTokens = numberOf(env['RT_WINDOW_TOKENS']);
+    if (windowTokens === null) {
+        return null;
+    }
+    return {
+        window: windowTokens,
+        warnPct: numberOf(env['RT_WINDOW_WARN_PCT']) ?? WARN_PCT_DEFAULT,
+        stopPct: numberOf(env['RT_WINDOW_STOP_PCT']) ?? STOP_PCT_DEFAULT,
+        marginPct: numberOf(env['RT_WINDOW_MARGIN_PCT']) ?? MARGIN_PCT_DEFAULT,
+        compactWindow: numberOf(settings['autoCompactWindow']),
+        compactPct: numberOf(env['CLAUDE_AUTOCOMPACT_PCT_OVERRIDE']),
+    };
+}
+/**
+ * Чем пара стража разошлась с парой сжатия.
+ *
+ * Незаданное расхождением не считается: дерево вправе не задавать порога сжатия вовсе — тогда
+ * его назначает инструмент, и сказать об этом надо один раз, а не двумя строками о разнице.
+ *
+ * Долю судит расстояние, а не равенство. Три случая дают расхождение, и у каждого свой исход
+ * для захода: сжатие выше остановки — страж отбивает раньше, чем клиент успевает начать;
+ * сжатие вровень с остановкой — гонка, которую страж выигрывает; сжатие ниже, но ближе
+ * объявленного запаса — клиент начать успевает, а докончить нет.
+ */
+export function thresholdDrift(thresholds) {
+    const drift = [];
+    if (thresholds.compactWindow !== null && thresholds.compactWindow !== thresholds.window) {
+        drift.push({
+            what: 'размер окна',
+            guard: String(thresholds.window),
+            compact: String(thresholds.compactWindow),
+            why: 'доля считается не от того же окна',
+        });
+    }
+    const compactPct = thresholds.compactPct;
+    if (compactPct === null) {
+        return drift;
+    }
+    const gap = thresholds.stopPct - compactPct;
+    const tooHigh = 'сжатие стоит выше остановки: страж отбивает заход раньше, чем приходит сжатие';
+    const tied = 'пороги совпали: кто сработает первым, не назначено, и выигрывает страж';
+    if (gap <= 0) {
+        drift.push({
+            what: 'доля окна',
+            guard: `${thresholds.stopPct}%`,
+            compact: `${compactPct}%`,
+            why: gap < 0 ? tooHigh : tied,
+        });
+        return drift;
+    }
+    if (gap < thresholds.marginPct) {
+        drift.push({
+            what: 'запас между порогами',
+            guard: `${thresholds.marginPct}% объявлено`,
+            compact: `${gap}% на деле`,
+            why: 'сжатие идёт не мгновенно и может не успеть до порога остановки',
+        });
+    }
+    return drift;
+}
+/** Раздел разбора состояния: числа порогов и то, что о них известно. */
+export function thresholdLines(root) {
+    const thresholds = readThresholds(root);
+    if (!thresholds) {
+        return [];
+    }
+    const lines = [
+        `окно захода: ${thresholds.window} токенов, напоминание ${thresholds.warnPct}%, остановка ${thresholds.stopPct}%`,
+    ];
+    if (thresholds.compactWindow === null && thresholds.compactPct === null) {
+        lines.push('  порог сжатия деревом не задан — его назначает инструмент, и передача пишется когда придётся', `  объяви в \`${SETTINGS_PATH}\`: \`autoCompactWindow\` числом ${thresholds.window}, а \`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE\` — числом ${thresholds.stopPct - thresholds.marginPct}`);
+        return lines;
+    }
+    const drift = thresholdDrift(thresholds);
+    if (!drift.length) {
+        lines.push(`  порог сжатия ниже порога остановки на ${thresholds.marginPct}% и более: сжатие приходит первым, страж остаётся страховкой`);
+        return lines;
+    }
+    lines.push('  порог сжатия разошёлся с порогом остановки:');
+    for (const one of drift) {
+        lines.push(`    ${one.what}: у стража ${one.guard}, у сжатия ${one.compact}`, `      ${one.why}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=thresholds.js.map

package/lib/thresholds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thresholds.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/thresholds.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Пороги окна захода: где заход останавливается и где инструмент сжимает контекст сам.\n *\n * Чисел два, и живут они в разных местах чужой настройки. Размер окна и доля, на которой страж\n * останавливает заход, приходят переменными окружения — их читает профиль дерева. Порог, на\n * котором инструмент сжимает контекст, задаётся своей парой: размером окна автосжатия и долей в\n * процентах. Пакет ни тем ни другим не владеет — окно принадлежит дереву.\n *\n * Разъехавшись, пары дают заход, который либо сжимается раньше, чем передача написана, либо\n * доживает до предела окна и роняет работу. Заметить это нечем: обе стороны по отдельности\n * выглядят настроенными, а расхождение видно только тому, кто положит их рядом. Здесь их и\n * кладут рядом — разбор состояния раскладки печатает числа и называет разошедшееся.\n *\n * Сведёнными считаются РАЗВЕДЁННЫЕ доли, а не совпавшие. Порог сжатия обязан стоять ниже порога\n * остановки: первым обязано срабатывать то, что заход продолжает, а не то, что его\n * останавливает. Совпавшая пара — гонка, и выигрывает её страж: он стоит на вызове инструмента,\n * а сжатие приходит между ходами. Ровно так заход и вставал на пороге вместо того, чтобы\n * продолжиться сжатым, — при том что прежняя сверка обе стороны считала настроенными и молчала.\n *\n * Насколько ниже — своё число дерева, `RT_WINDOW_MARGIN_PCT`. Запас объявляется, а не выводится\n * разницей: сжатие идёт не мгновенно, и разница в один процент требование «ниже» удовлетворяет,\n * а работу не спасает.\n *\n * Размер окна при этом сверяется по-прежнему на равенство: это одно и то же окно, названное в\n * двух местах, и разные числа там означают, что одна из сторон считает долю не от того.\n *\n * Дерево, не объявившее размера окна, стража не получает вовсе, и судить у него нечего: раздел\n * молчит целиком, а не краснеет отсутствием.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { SETTINGS_PATH } from './hooks-map.js';\n\n/** Доля окна, на которой страж напоминает выбрать точку остановки. Умолчание профиля. */\nconst WARN_PCT_DEFAULT: number = 40;\n\n/** Доля окна, на которой страж отбивает всё, кроме закрытия захода. Умолчание профиля. */\nconst STOP_PCT_DEFAULT: number = 50;\n\n/** На сколько долей окна порог сжатия обязан стоять ниже порога остановки. Умолчание профиля. */\nconst MARGIN_PCT_DEFAULT: number = 5;\n\n/** Пороги, объявленные деревом. Размер окна не объявлен — стража нет, и судить нечего. */\nexport interface IThresholds {\n    /** Размер окна захода в токенах: `RT_WINDOW_TOKENS`. */\n    readonly window: number;\n    /** Доля окна, на которой страж напоминает: `RT_WINDOW_WARN_PCT`. */\n    readonly warnPct: number;\n    /** Доля окна, на которой страж отбивает работу: `RT_WINDOW_STOP_PCT`. */\n    readonly stopPct: number;\n    /** Запас между порогом сжатия и порогом остановки: `RT_WINDOW_MARGIN_PCT`. */\n    readonly marginPct: number;\n    /** Размер окна автосжатия: настройка `autoCompactWindow`. Не объявлен — `null`. */\n    readonly compactWindow: number | null;\n    /** Доля, на которой приходит сжатие: `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`. Не объявлена — `null`. */\n    readonly compactPct: number | null;\n}\n\n/** Расхождение пары: что с чем разъехалось, какими числами и чем это кончится для захода. */\nexport interface IThresholdDrift {\n    /** Что разошлось, словами читателя. */\n    readonly what: string;\n    /** Что объявлено стражу. */\n    readonly guard: string;\n    /** Что объявлено сжатию. */\n    readonly compact: string;\n    /** Чем это кончится для захода. Пусто у расхождения, которое говорит само за себя. */\n    readonly why: string;\n}\n\n/**\n * Число из строки настройки. Пусто, не число, ноль и меньше — ничего: значение, которого нельзя\n * посчитать, объявленным не считается, иначе расхождением станет опечатка, а не расхождение.\n */\nfunction numberOf(value: unknown): number | null {\n    const parsed: number = typeof value === 'number' ? value : Number.parseInt(String(value ?? ''), 10);\n\n    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;\n}\n\n/**\n * Что дерево объявило о порогах.\n *\n * Настройку читаем разбором и только им: пороги лежат полями объекта, и вынуть их из текста\n * поиском значило бы гадать. Не разобралась — молчим целиком, как молчит карта хуков: назвать\n * расхождением непрочитанное хуже, чем не назвать ничего.\n */\nexport function readThresholds(root: string): IThresholds | null {\n    const path: string = join(root, SETTINGS_PATH);\n    if (!existsSync(path)) {\n        return null;\n    }\n\n    let settings: Record<string, unknown>;\n    try {\n        settings = JSON.parse(readFileSync(path, 'utf8')) as Record<string, unknown>;\n    } catch {\n        return null;\n    }\n\n    const env: Record<string, unknown> = (settings['env'] as Record<string, unknown>) ?? {};\n    const windowTokens: number | null = numberOf(env['RT_WINDOW_TOKENS']);\n    if (windowTokens === null) {\n        return null;\n    }\n\n    return {\n        window: windowTokens,\n        warnPct: numberOf(env['RT_WINDOW_WARN_PCT']) ?? WARN_PCT_DEFAULT,\n        stopPct: numberOf(env['RT_WINDOW_STOP_PCT']) ?? STOP_PCT_DEFAULT,\n        marginPct: numberOf(env['RT_WINDOW_MARGIN_PCT']) ?? MARGIN_PCT_DEFAULT,\n        compactWindow: numberOf(settings['autoCompactWindow']),\n        compactPct: numberOf(env['CLAUDE_AUTOCOMPACT_PCT_OVERRIDE']),\n    };\n}\n\n/**\n * Чем пара стража разошлась с парой сжатия.\n *\n * Незаданное расхождением не считается: дерево вправе не задавать порога сжатия вовсе — тогда\n * его назначает инструмент, и сказать об этом надо один раз, а не двумя строками о разнице.\n *\n * Долю судит расстояние, а не равенство. Три случая дают расхождение, и у каждого свой исход\n * для захода: сжатие выше остановки — страж отбивает раньше, чем клиент успевает начать;\n * сжатие вровень с остановкой — гонка, которую страж выигрывает; сжатие ниже, но ближе\n * объявленного запаса — клиент начать успевает, а докончить нет.\n */\nexport function thresholdDrift(thresholds: IThresholds): readonly IThresholdDrift[] {\n    const drift: IThresholdDrift[] = [];\n\n    if (thresholds.compactWindow !== null && thresholds.compactWindow !== thresholds.window) {\n        drift.push({\n            what: 'размер окна',\n            guard: String(thresholds.window),\n            compact: String(thresholds.compactWindow),\n            why: 'доля считается не от того же окна',\n        });\n    }\n\n    const compactPct: number | null = thresholds.compactPct;\n    if (compactPct === null) {\n        return drift;\n    }\n\n    const gap: number = thresholds.stopPct - compactPct;\n    const tooHigh: string = 'сжатие стоит выше остановки: страж отбивает заход раньше, чем приходит сжатие';\n    const tied: string = 'пороги совпали: кто сработает первым, не назначено, и выигрывает страж';\n\n    if (gap <= 0) {\n        drift.push({\n            what: 'доля окна',\n            guard: `${thresholds.stopPct}%`,\n            compact: `${compactPct}%`,\n            why: gap < 0 ? tooHigh : tied,\n        });\n\n        return drift;\n    }\n\n    if (gap < thresholds.marginPct) {\n        drift.push({\n            what: 'запас между порогами',\n            guard: `${thresholds.marginPct}% объявлено`,\n            compact: `${gap}% на деле`,\n            why: 'сжатие идёт не мгновенно и может не успеть до порога остановки',\n        });\n    }\n\n    return drift;\n}\n\n/** Раздел разбора состояния: числа порогов и то, что о них известно. */\nexport function thresholdLines(root: string): string[] {\n    const thresholds: IThresholds | null = readThresholds(root);\n    if (!thresholds) {\n        return [];\n    }\n\n    const lines: string[] = [\n        `окно захода: ${thresholds.window} токенов, напоминание ${thresholds.warnPct}%, остановка ${thresholds.stopPct}%`,\n    ];\n\n    if (thresholds.compactWindow === null && thresholds.compactPct === null) {\n        lines.push(\n            '  порог сжатия деревом не задан — его назначает инструмент, и передача пишется когда придётся',\n            `  объяви в \\`${SETTINGS_PATH}\\`: \\`autoCompactWindow\\` числом ${thresholds.window}, а \\`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE\\` — числом ${thresholds.stopPct - thresholds.marginPct}`\n        );\n\n        return lines;\n    }\n\n    const drift: readonly IThresholdDrift[] = thresholdDrift(thresholds);\n    if (!drift.length) {\n        lines.push(\n            `  порог сжатия ниже порога остановки на ${thresholds.marginPct}% и более: сжатие приходит первым, страж остаётся страховкой`\n        );\n\n        return lines;\n    }\n\n    lines.push('  порог сжатия разошёлся с порогом остановки:');\n    for (const one of drift) {\n        lines.push(`    ${one.what}: у стража ${one.guard}, у сжатия ${one.compact}`, `      ${one.why}`);\n    }\n\n    return lines;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",