@rt-tools/agent-kit 0.10.0 → 0.12.0

package/lib/thresholds.d.ts

@@ -0,0 +1,49 @@
+/** Пороги, объявленные деревом. Размер окна не объявлен — стража нет, и судить нечего. */
+export interface IThresholds {
+    /** Размер окна захода в токенах: `RT_WINDOW_TOKENS`. */
+    readonly window: number;
+    /** Доля окна, на которой страж напоминает: `RT_WINDOW_WARN_PCT`. */
+    readonly warnPct: number;
+    /** Доля окна, на которой страж отбивает работу: `RT_WINDOW_STOP_PCT`. */
+    readonly stopPct: number;
+    /** Запас между порогом сжатия и порогом остановки: `RT_WINDOW_MARGIN_PCT`. */
+    readonly marginPct: number;
+    /** Размер окна автосжатия: настройка `autoCompactWindow`. Не объявлен — `null`. */
+    readonly compactWindow: number | null;
+    /** Доля, на которой приходит сжатие: `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`. Не объявлена — `null`. */
+    readonly compactPct: number | null;
+}
+/** Расхождение пары: что с чем разъехалось, какими числами и чем это кончится для захода. */
+export interface IThresholdDrift {
+    /** Что разошлось, словами читателя. */
+    readonly what: string;
+    /** Что объявлено стражу. */
+    readonly guard: string;
+    /** Что объявлено сжатию. */
+    readonly compact: string;
+    /** Чем это кончится для захода. Пусто у расхождения, которое говорит само за себя. */
+    readonly why: string;
+}
+/**
+ * Что дерево объявило о порогах.
+ *
+ * Настройку читаем разбором и только им: пороги лежат полями объекта, и вынуть их из текста
+ * поиском значило бы гадать. Не разобралась — молчим целиком, как молчит карта хуков: назвать
+ * расхождением непрочитанное хуже, чем не назвать ничего.
+ */
+export declare function readThresholds(root: string): IThresholds | null;
+/**
+ * Чем пара стража разошлась с парой сжатия.
+ *
+ * Незаданное расхождением не считается: дерево вправе не задавать порога сжатия вовсе — тогда
+ * его назначает инструмент, и сказать об этом надо один раз, а не двумя строками о разнице.
+ *
+ * Долю судит расстояние, а не равенство. Три случая дают расхождение, и у каждого свой исход
+ * для захода: сжатие выше остановки — страж отбивает раньше, чем клиент успевает начать;
+ * сжатие вровень с остановкой — гонка, которую страж выигрывает; сжатие ниже, но ближе
+ * объявленного запаса — клиент начать успевает, а докончить нет.
+ */
+export declare function thresholdDrift(thresholds: IThresholds): readonly IThresholdDrift[];
+/** Раздел разбора состояния: числа порогов и то, что о них известно. */
+export declare function thresholdLines(root: string): string[];
+//# sourceMappingURL=thresholds.d.ts.map

package/lib/thresholds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thresholds.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/thresholds.ts"],"names":[],"mappings":"AA0CA,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IACxB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,kGAAkG;IAClG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sFAAsF;IACtF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAYD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA2B/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,WAAW,GAAG,SAAS,eAAe,EAAE,CA0ClF;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCrD"}

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.10.0",
+  "version": "0.12.0",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",

package/assets/commands/agent-kit-digest.md

@@ -1,88 +0,0 @@
----
-description: Свести накопленные предложения и наблюдения в правки ресурсов пакета правил
-argument-hint: '[пусто | --days N]'
----
-
-Собери предложения, пришедшие из деревьев, и скажи, что из них становится правкой пакета.
-Отрезок от пользователя: `$ARGUMENTS` (без довода — три дня).
-
-Зовётся **в репозитории самого пакета**, а не в дереве, где он стоит: здесь лежат ресурсы,
-которые предстоит править, и видно всех потребителей сразу. В чужом дереве команда бессмысленна
-— там есть только своя половина картины.
-
-## 1. Собери, что пришло
-
-Груз уезжает в приём, а не в очередь работ: сводка говорит о рабочих привычках команды, и в
-открытой очереди это выложено всему свету. Записи приёма читает его админка; пока её нет,
-собранное читается запросом к его хранилищу — как именно, сказано в компаньоне этой команды.
-
-Записи, заведённые прежним порядком, лежат в очереди работ и никуда не делись:
-
-```bash
-gh issue list --label agent-kit-feedback --state all --limit 100 \
-    --json number,title,body,createdAt
-```
-
-Помощник хостинга и учётная запись машинной работы у каждого дерева свои — как их звать здесь,
-сказано в компаньоне правила `git-workflow`.
-
-В каждой записи — ресурс, место, повод и готовый текст. Признак дерева, приехавший с грузом,
-адреса дерева не выдаёт: он считается хешем и по нему различают деревья, а не находят их.
-
-Своё дерево тоже потребитель — его наблюдения читаются прямо:
-
-```bash
-npx agent-kit stats --days <отрезок> --json
-```
-
-## 2. Раздели повторившееся и разовое
-
-Это и есть работа сведения; всё остальное — оформление.
-
-- **Пришло об одном ресурсе из двух и более записей** — правка пакета. Разные деревья
-  споткнулись об одно и то же место, и чинить его надо там, откуда оно к ним приехало.
-- **Пришло однажды и называет то, чего у других нет** — надстройка того дерева, а не пакет.
-  Скажи это прямо и назови, куда именно: `overrides/<ресурс>` для текстов, карта гейта и
-  профиль — для родов файлов и команд.
-- **Пришло однажды, но верно любому дереву** — правка пакета. Числа записей мало: правило,
-  которое молчит о важном, молчит у всех, а споткнулся о него пока один.
-
-Ресурс, о котором пришли **противоречащие** предложения, в правку не идёт вовсе: неси оба
-владельцу. Слой правил, который говорит два разных, хуже слоя, который молчит.
-
-## 3. Посмотри, что говорят наблюдения
-
-Сводка отвечает на то, чего в предложениях нет:
-
-- **правило, разложенное и не загруженное ни разу** — кандидат на сокращение или на запись в
-  карте гейта: правило, которого гейт не требует, никто и не откроет;
-- **правило, которое гейт отбивает чаще прочих** — его либо забывают, либо оно требуется не
-  там; посмотри род правки в той же сводке;
-- **гард, отказывающий чаще прочих** — либо место поставки раз за разом делают не так, либо
-  отказ не называет, чем он снимается.
-
-## 4. Принеси правки
-
-По каждой — ресурс, место, готовый текст и число записей, из которых она вышла. Не правь ничего
-сам: решение принимает владелец, а работа идёт обычным ходом — задача, ветка, папка задачи.
-
-Заведи задачу на то, что владелец принял:
-
-```bash
-npm run task:new -- --title '<что не так>' --slug <короткое-имя> --label enhancement < тело.md
-```
-
-Записи, вошедшие в задачу, закрой ссылкой на неё:
-
-```bash
-gh issue close <номер> --comment 'Вошло в #<номер задачи>.'
-```
-
-## 5. Черновик записи в журнал изменений
-
-Собери его сразу, пока видно, из чего правка выросла: заголовок коммита по формату дерева и
-одна фраза о том, что менялось и почему. Журнал изменений при выпуске собирается из заголовков,
-и переписывать их задним числом — работа заново.
-
-**Выпуск отсюда не запускается.** Это отдельное решение владельца: слияние PR пакета не
-публикует. Скажи, что накопилось на выпуск, и остановись.

package/assets/commands/rules-review.md

@@ -1,98 +0,0 @@
----
-description: Смысловое ревью семьи текстов слоя правил — закон, его правила и паттерны при них
-argument-hint: '<имя закона>'
----
-
-Прогони смысловое ревью одной семьи текстов пакета правил. Семья: `$ARGUMENTS`
-
-Зовётся **в репозитории самого пакета**, а не в дереве, где он стоит: судятся исходные тексты
-ресурсов, и лежат они только здесь. В чужом дереве лежит разложенная копия выбранных ресурсов, а
-не семья целиком, и путей, по которым команда ходит, в нём нет вовсе: обход по ним вернёт
-пустоту, неотличимую от «такого закона не бывает». Каталог ресурсов ниже назван так, как он
-зовётся в репозитории пакета.
-
-Считаемое ловит проверка полноты текстов — недостающий раздел, правило без паттерна, имя соседа,
-которому в наборе ничего не отвечает. Здесь ищется то, чего она не считает: два текста,
-говорящих об одном разное, и случай, которого не назвал ни один. Ответ роли не повторяется от
-запуска к запуску, поэтому в гейт он не идёт и ветку не отбивает.
-
-## 1. Пойми, какая семья
-
-Семья зовётся именем закона — без пути и без расширения: `work-conduct`, `delivery`,
-`project-documentation`.
-
-```bash
-ls projects/agent-kit/assets/laws/*.md projects/agent-kit/assets/laws/*/*.md
-```
-
-**Имени нет** — назови человеку перечень имён и остановись. Догадываться по похожести нельзя:
-ревью уйдёт на чужую семью, и его находки человек примет за находки о своей.
-
-**Названо несколько** — гони по одной, по очереди, и ответы не смешивай: находка семьи читается
-вместе с её законом, а сваленные в кучу они теряют адрес.
-
-**Довода нет вовсе** — потребуй имя и напечатай перечень. Умолчания здесь нет: «первый
-попавшийся закон» даёт прогон, неотличимый от осмысленного.
-
-**Закон лежит в слое приложения** — это законный случай, а не промах: у денег, локалей и доступа
-семья такая же. Читается он оттуда же, где лежит.
-
-## 2. Собери семью
-
-Правило принадлежит закону полем `law:`, паттерн правилу — полем `rule:`. Приставка имени
-ненадёжна: её несут не все паттерны.
-
-```bash
-LAW=<имя закона>
-grep -l "^law: $LAW\$" projects/agent-kit/assets/rules/*.md
-```
-
-Дальше по каждому найденному правилу — его паттерны. Имя правила для поиска берётся голым: без
-вида и без требования — оба стоят суффиксами в имени файла, а поле `rule:` у паттерна несёт
-только само имя.
-
-```bash
-RULE=<имя правила: первое слово имени файла, до первой точки>
-grep -l "^rule: $RULE\$" projects/agent-kit/assets/patterns/*.md
-```
-
-**Виды берутся все.** `git-workflow.github`, `git-workflow.gitlab`, `git-workflow.azure` — три
-редакции одного правила: дерево раскладывает одну, а расходятся они молча.
-
-**Суффикс требования — не вид.** `entity-conventions.needs-admin`, `observability.needs-app` —
-это правила, которые дерево берёт, только когда объявило нужную черту. Имя с этим суффиксом в
-поле `rule:` не стоит ни у одного паттерна: поиск по нему возвращает пустоту, и семья уезжает в
-ревью без паттернов вовсе — молча, потому что пустой ответ выглядит как «паттернов нет».
-
-**У закона нет ни одного правила** — скажи это человеку и остановись. Читать один закон нечем:
-расхождение живёт между двумя текстами, а пробел уровня статьи без правил под ней — не находка
-ревью, а отсутствие целого слоя. Сам по себе такой закон стоит разговора: его находит и проверка
-полноты текстов, и она же скажет, сколько их.
-
-## 3. Запусти роль
-
-Инструментом `Agent`, `subagent_type: 'rules-reviewer'`. В промпт — имя закона и полный список
-путей: закон, все его правила со всеми видами, все паттерны при них. Список собираешь ты: роль
-git-команд не зовёт и историю не читает.
-
-Одна роль на семью. Веер из нескольких ролей со сведением ответов здесь не заводится: взгляд на
-предмет один — два текста об одном говорят разное, — а сведение превращает дословные цитаты в
-пересказ.
-
-## 4. Покажи находки человеку
-
-**Как есть.** Роль возвращает цитаты дословно, и пересказ их портит: по пересказу человек не
-отличит настоящее расхождение от прочтения роли.
-
-Порядок сохрани: сперва расхождения — у каждого два места и две цитаты, — потом пробелы, у
-которых второго места нет.
-
-По каждой находке скажи своё: согласен или нет и почему. Правку не вноси — тексты правил
-действуют на все будущие сессии всех деревьев, и решает по ним человек.
-
-Находка, с которой человек согласился, идёт дальше двумя путями, и выбирает он:
-
-- **правится тут же** — если это правка текста пакета и она укладывается в текущую работу;
-- **уходит задачей** в очередь работ — если тянет за собой код, раскладку или другой закон.
-
-Пустой ответ роли — тоже результат: скажи, что находок нет, и не выдумывай их из вежливости.