@rt-tools/agent-kit 0.3.0 → 0.4.0

package/lib/sync.js

@@ -5,14 +5,18 @@
  * только потом писать. `sync --check` отличается от `sync` ровно последним шагом — иначе гейт
  * пуша проверял бы не то, что кладёт раскладка.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { collectAssets } from './assets.js';
+import { collectAssets, targetOf } from './assets.js';
+import { readCatalog, variantGaps } from './catalog.js';
 import { pathOf, planCompanion } from './companion.js';
 import { OVERRIDES_DIR } from './config.js';
+import { bindingOf, unboundHooks } from './hooks-map.js';
 import { isPending, isRefusal, planFile } from './plan.js';
 import { mergeDocuments, parseDocument, renderDocument } from './sections.js';
+import { readStamped } from './stamp.js';
 import { renderVars } from './vars.js';
+import { matchesVariant } from './variants.js';
 /** Шаблон черновика компаньона — тот же, что пакет кладёт проекту в шаблоны. */
 const COMPANION_TEMPLATE = 'templates/implementation.md';
 const read = (path) => (existsSync(path) ? readFileSync(path, 'utf8') : null);
@@ -27,6 +31,40 @@ function renderAsset(asset, config, root) {
     const merged = override ? renderDocument(mergeDocuments(parseDocument(asset.text), parseDocument(override))) : asset.text;
     return renderVars(merged, config.vars);
 }
+/**
+ * Что лежит в дереве от ресурсов, которые проект больше не берёт.
+ *
+ * Ищется по тем же правилам раскладки, что и всё остальное: путь ресурса вычисляется так, будто
+ * его кладут, и проверяется, лежит ли там файл с шапкой пакета. Чужой файл на том же пути
+ * брошенным не считается — его пакет не клал.
+ */
+function abandonedOf(config, root, assetsDir) {
+    const taken = new Set(collectAssets(config, assetsDir).map((asset) => asset.id));
+    return readCatalog(assetsDir)
+        .filter((entry) => !taken.has(entry.id) && matchesVariant(entry.variant, config.variants))
+        .map((entry) => targetOf(entry, config.layout))
+        .filter((path) => {
+        const existing = read(join(root, path));
+        return existing !== null && readStamped(existing) !== null;
+    });
+}
+/**
+ * Что о себе говорят гарды, которые дерево берёт. Читается у ресурсов, а не у разложенных
+ * файлов: карта нужна и до первой раскладки — чтобы было что вставить в настройку.
+ */
+function bindingsOf(config, assetsDir) {
+    const bindings = [];
+    for (const asset of collectAssets(config, assetsDir)) {
+        if (asset.kind !== 'hooks') {
+            continue;
+        }
+        const binding = bindingOf(asset.text, asset.target);
+        if (binding) {
+            bindings.push(binding);
+        }
+    }
+    return bindings;
+}
 export function planSync(config, root, version, assetsDir) {
     const planned = [];
     const missing = new Map();
@@ -43,14 +81,28 @@ export function planSync(config, root, version, assetsDir) {
             companions.push(planCompanion(asset, read(join(root, pathOf(asset))), template));
         }
     }
-    return { planned, missing, companions, written: [] };
+    return {
+        planned,
+        missing,
+        companions,
+        abandoned: abandonedOf(config, root, assetsDir),
+        gaps: variantGaps(readCatalog(assetsDir), config),
+        unbound: unboundHooks(bindingsOf(config, assetsDir), root),
+        written: [],
+    };
 }
 /** Раскладка. Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого. */
 export function runSync(config, root, version, assetsDir) {
     const result = planSync(config, root, version, assetsDir);
-    if (result.missing.size || result.planned.some((entry) => isRefusal(entry.outcome))) {
+    if (result.missing.size || result.gaps.length || result.planned.some((entry) => isRefusal(entry.outcome))) {
         return result;
     }
+    // Право на запуск переносится с файла в пакете. Без него гард отвечает отказом доступа, то
+    // есть ненулевым кодом, а ненулевой код у гарда значит «правка отбита»: разложенный набор
+    // отбивал бы подряд всё, включая сборку и тесты, и причина при этом нигде не называлась.
+    const executable = new Set(collectAssets(config, assetsDir)
+        .filter((asset) => asset.executable)
+        .map((asset) => asset.id));
     const written = [];
     for (const entry of result.planned) {
         if (entry.content === null) {
@@ -59,6 +111,9 @@ export function runSync(config, root, version, assetsDir) {
         const path = join(root, entry.path);
         mkdirSync(dirname(path), { recursive: true });
         writeFileSync(path, entry.content, 'utf8');
+        if (executable.has(entry.asset)) {
+            chmodSync(path, 0o755);
+        }
         written.push(entry.path);
     }
     // Черновик компаньона кладётся только там, где файла нет вовсе. Он без шапки и без суммы:

package/lib/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sync.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Раскладка ресурсов пакета в дерево проекта.\n *\n * Порядок один и тот же и для записи, и для проверки: собрать тело, решить судьбу файла, и\n * только потом писать. `sync --check` отличается от `sync` ровно последним шагом — иначе гейт\n * пуша проверял бы не то, что кладёт раскладка.\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nimport { collectAssets, IAsset } from './assets.js';\nimport { ICompanion, pathOf, planCompanion } from './companion.js';\nimport { IConfig, OVERRIDES_DIR } from './config.js';\nimport { IPlanned, isPending, isRefusal, planFile } from './plan.js';\nimport { mergeDocuments, parseDocument, renderDocument } from './sections.js';\nimport { IRenderResult, renderVars } from './vars.js';\n\nexport interface ISyncResult {\n    readonly planned: readonly IPlanned[];\n    /** Дырки без значения, по ресурсам. Непустой список — отказ: подставлять нечего. */\n    readonly missing: ReadonlyMap<string, readonly string[]>;\n    /** Компаньоны разложенных правил: имена этого дерева, которые пишет проект. */\n    readonly companions: readonly ICompanion[];\n    readonly written: readonly string[];\n}\n\n/** Шаблон черновика компаньона — тот же, что пакет кладёт проекту в шаблоны. */\nconst COMPANION_TEMPLATE: string = 'templates/implementation.md';\n\nconst read: (path: string) => string | null = (path: string): string | null => (existsSync(path) ? readFileSync(path, 'utf8') : null);\n\n/**\n * Тело ресурса: текст пакета, поверх него надстройка проекта, и уже потом подстановка значений.\n *\n * Порядок именно такой. Надстройка тоже пишется с дырками — иначе проект, дописавший раздел про\n * свою главную ветку, зашил бы её имя в двух местах: в конфиге и в тексте.\n */\nfunction renderAsset(asset: IAsset, config: IConfig, root: string): IRenderResult {\n    const override: string | null = read(join(root, OVERRIDES_DIR, asset.id));\n    const merged: string = override ? renderDocument(mergeDocuments(parseDocument(asset.text), parseDocument(override))) : asset.text;\n\n    return renderVars(merged, config.vars);\n}\n\nexport function planSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult {\n    const planned: IPlanned[] = [];\n    const missing: Map<string, readonly string[]> = new Map();\n    const companions: ICompanion[] = [];\n    const template: string | null = read(join(assetsDir, COMPANION_TEMPLATE));\n\n    for (const asset of collectAssets(config, assetsDir)) {\n        const rendered: IRenderResult = renderAsset(asset, config, root);\n        if (rendered.missing.length) {\n            missing.set(asset.id, rendered.missing);\n            continue;\n        }\n        planned.push(\n            planFile({ path: asset.target, asset: asset.id, version, rendered: rendered.text, existing: read(join(root, asset.target)) })\n        );\n        if (asset.kind === 'rules' && template !== null) {\n            companions.push(planCompanion(asset, read(join(root, pathOf(asset))), template));\n        }\n    }\n\n    return { planned, missing, companions, written: [] };\n}\n\n/** Раскладка. Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого. */\nexport function runSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult {\n    const result: ISyncResult = planSync(config, root, version, assetsDir);\n    if (result.missing.size || result.planned.some((entry: IPlanned): boolean => isRefusal(entry.outcome))) {\n        return result;\n    }\n\n    const written: string[] = [];\n    for (const entry of result.planned) {\n        if (entry.content === null) {\n            continue;\n        }\n        const path: string = join(root, entry.path);\n        mkdirSync(dirname(path), { recursive: true });\n        writeFileSync(path, entry.content, 'utf8');\n        written.push(entry.path);\n    }\n\n    // Черновик компаньона кладётся только там, где файла нет вовсе. Он без шапки и без суммы:\n    // сверять в нём нечего — с первой правки проекта это его текст, а не текст пакета.\n    for (const companion of result.companions) {\n        if (companion.content === null) {\n            continue;\n        }\n        const path: string = join(root, companion.path);\n        mkdirSync(dirname(path), { recursive: true });\n        writeFileSync(path, companion.content, 'utf8');\n        written.push(companion.path);\n    }\n\n    return { ...result, written };\n}\n\nexport const pendingOf: (result: ISyncResult) => readonly IPlanned[] = (result: ISyncResult): readonly IPlanned[] =>\n    result.planned.filter((entry: IPlanned): boolean => isPending(entry.outcome));\n"]}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sync.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Раскладка ресурсов пакета в дерево проекта.\n *\n * Порядок один и тот же и для записи, и для проверки: собрать тело, решить судьбу файла, и\n * только потом писать. `sync --check` отличается от `sync` ровно последним шагом — иначе гейт\n * пуша проверял бы не то, что кладёт раскладка.\n */\nimport { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nimport { collectAssets, IAsset, targetOf } from './assets.js';\nimport { IEntryOfCatalog, IGapOfVariant, readCatalog, variantGaps } from './catalog.js';\nimport { ICompanion, pathOf, planCompanion } from './companion.js';\nimport { IConfig, OVERRIDES_DIR } from './config.js';\nimport { bindingOf, IHookBinding, unboundHooks } from './hooks-map.js';\nimport { IPlanned, isPending, isRefusal, planFile } from './plan.js';\nimport { mergeDocuments, parseDocument, renderDocument } from './sections.js';\nimport { readStamped } from './stamp.js';\nimport { IRenderResult, renderVars } from './vars.js';\nimport { matchesVariant } from './variants.js';\n\nexport interface ISyncResult {\n    readonly planned: readonly IPlanned[];\n    /** Дырки без значения, по ресурсам. Непустой список — отказ: подставлять нечего. */\n    readonly missing: ReadonlyMap<string, readonly string[]>;\n    /** Компаньоны разложенных правил: имена этого дерева, которые пишет проект. */\n    readonly companions: readonly ICompanion[];\n    /**\n     * Файлы, лежащие в дереве от ресурсов, от которых проект отказался.\n     *\n     * Отказ значит «больше не клади», а не «убери»: разложенное коммитится, рядом с правилом\n     * лежит написанный проектом компаньон, и стирать это молча пакет не вправе. Но и молчать\n     * нельзя — брошенный файл читается как действующее правило, и агент по нему работает.\n     */\n    readonly abandoned: readonly string[];\n    /**\n     * Ресурсы, у которых виды есть, а вида под выбор дерева нет.\n     *\n     * Пропустить такой ресурс молча значит разложить правило и не разложить инструмент, который\n     * оно зовёт: дерево получает указание без исполнителя и узнаёт об этом, когда команда из\n     * правила не находится. Поэтому непустой список — отказ раскладки наравне с дыркой без\n     * значения и с файлом, который правили руками.\n     */\n    readonly gaps: readonly IGapOfVariant[];\n    /**\n     * Разложенные гарды, которых нет в настройке агента: файл лежит, а позвать его некому.\n     *\n     * Раскладку это не отбивает — настройка принадлежит дереву, и пакет в неё не пишет, — но и\n     * молчать нельзя: гард, который не зовут, неотличим от гарда, который всё пропускает.\n     */\n    readonly unbound: readonly IHookBinding[];\n    readonly written: readonly string[];\n}\n\n/** Шаблон черновика компаньона — тот же, что пакет кладёт проекту в шаблоны. */\nconst COMPANION_TEMPLATE: string = 'templates/implementation.md';\n\nconst read: (path: string) => string | null = (path: string): string | null => (existsSync(path) ? readFileSync(path, 'utf8') : null);\n\n/**\n * Тело ресурса: текст пакета, поверх него надстройка проекта, и уже потом подстановка значений.\n *\n * Порядок именно такой. Надстройка тоже пишется с дырками — иначе проект, дописавший раздел про\n * свою главную ветку, зашил бы её имя в двух местах: в конфиге и в тексте.\n */\nfunction renderAsset(asset: IAsset, config: IConfig, root: string): IRenderResult {\n    const override: string | null = read(join(root, OVERRIDES_DIR, asset.id));\n    const merged: string = override ? renderDocument(mergeDocuments(parseDocument(asset.text), parseDocument(override))) : asset.text;\n\n    return renderVars(merged, config.vars);\n}\n\n/**\n * Что лежит в дереве от ресурсов, которые проект больше не берёт.\n *\n * Ищется по тем же правилам раскладки, что и всё остальное: путь ресурса вычисляется так, будто\n * его кладут, и проверяется, лежит ли там файл с шапкой пакета. Чужой файл на том же пути\n * брошенным не считается — его пакет не клал.\n */\nfunction abandonedOf(config: IConfig, root: string, assetsDir: string): readonly string[] {\n    const taken: ReadonlySet<string> = new Set(collectAssets(config, assetsDir).map((asset: IAsset): string => asset.id));\n\n    return readCatalog(assetsDir)\n        .filter((entry: IEntryOfCatalog): boolean => !taken.has(entry.id) && matchesVariant(entry.variant, config.variants))\n        .map((entry: IEntryOfCatalog): string => targetOf(entry, config.layout))\n        .filter((path: string): boolean => {\n            const existing: string | null = read(join(root, path));\n\n            return existing !== null && readStamped(existing) !== null;\n        });\n}\n\n/**\n * Что о себе говорят гарды, которые дерево берёт. Читается у ресурсов, а не у разложенных\n * файлов: карта нужна и до первой раскладки — чтобы было что вставить в настройку.\n */\nfunction bindingsOf(config: IConfig, assetsDir: string): readonly IHookBinding[] {\n    const bindings: IHookBinding[] = [];\n    for (const asset of collectAssets(config, assetsDir)) {\n        if (asset.kind !== 'hooks') {\n            continue;\n        }\n        const binding: IHookBinding | null = bindingOf(asset.text, asset.target);\n        if (binding) {\n            bindings.push(binding);\n        }\n    }\n\n    return bindings;\n}\n\nexport function planSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult {\n    const planned: IPlanned[] = [];\n    const missing: Map<string, readonly string[]> = new Map();\n    const companions: ICompanion[] = [];\n    const template: string | null = read(join(assetsDir, COMPANION_TEMPLATE));\n\n    for (const asset of collectAssets(config, assetsDir)) {\n        const rendered: IRenderResult = renderAsset(asset, config, root);\n        if (rendered.missing.length) {\n            missing.set(asset.id, rendered.missing);\n            continue;\n        }\n        planned.push(\n            planFile({ path: asset.target, asset: asset.id, version, rendered: rendered.text, existing: read(join(root, asset.target)) })\n        );\n        if (asset.kind === 'rules' && template !== null) {\n            companions.push(planCompanion(asset, read(join(root, pathOf(asset))), template));\n        }\n    }\n\n    return {\n        planned,\n        missing,\n        companions,\n        abandoned: abandonedOf(config, root, assetsDir),\n        gaps: variantGaps(readCatalog(assetsDir), config),\n        unbound: unboundHooks(bindingsOf(config, assetsDir), root),\n        written: [],\n    };\n}\n\n/** Раскладка. Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого. */\nexport function runSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult {\n    const result: ISyncResult = planSync(config, root, version, assetsDir);\n    if (result.missing.size || result.gaps.length || result.planned.some((entry: IPlanned): boolean => isRefusal(entry.outcome))) {\n        return result;\n    }\n\n    // Право на запуск переносится с файла в пакете. Без него гард отвечает отказом доступа, то\n    // есть ненулевым кодом, а ненулевой код у гарда значит «правка отбита»: разложенный набор\n    // отбивал бы подряд всё, включая сборку и тесты, и причина при этом нигде не называлась.\n    const executable: ReadonlySet<string> = new Set(\n        collectAssets(config, assetsDir)\n            .filter((asset: IAsset): boolean => asset.executable)\n            .map((asset: IAsset): string => asset.id)\n    );\n\n    const written: string[] = [];\n    for (const entry of result.planned) {\n        if (entry.content === null) {\n            continue;\n        }\n        const path: string = join(root, entry.path);\n        mkdirSync(dirname(path), { recursive: true });\n        writeFileSync(path, entry.content, 'utf8');\n        if (executable.has(entry.asset)) {\n            chmodSync(path, 0o755);\n        }\n        written.push(entry.path);\n    }\n\n    // Черновик компаньона кладётся только там, где файла нет вовсе. Он без шапки и без суммы:\n    // сверять в нём нечего — с первой правки проекта это его текст, а не текст пакета.\n    for (const companion of result.companions) {\n        if (companion.content === null) {\n            continue;\n        }\n        const path: string = join(root, companion.path);\n        mkdirSync(dirname(path), { recursive: true });\n        writeFileSync(path, companion.content, 'utf8');\n        written.push(companion.path);\n    }\n\n    return { ...result, written };\n}\n\nexport const pendingOf: (result: ISyncResult) => readonly IPlanned[] = (result: ISyncResult): readonly IPlanned[] =>\n    result.planned.filter((entry: IPlanned): boolean => isPending(entry.outcome));\n"]}

package/lib/variants.d.ts

@@ -0,0 +1,44 @@
+export interface IOptionOfAxis {
+    /** Значение, которое проект пишет в конфиг и которое стоит в имени файла: `github`. */
+    readonly value: string;
+    /** Чем этот вид отличается от соседнего — им человек и выбирает. */
+    readonly title: string;
+}
+export interface IAxis {
+    /** Имя оси, оно же ключ в `variants` конфига: `host`. */
+    readonly name: string;
+    /** Вопрос, которым ось спрашивают при заведении конфига. */
+    readonly question: string;
+    /** Чем ось названа в перечнях и отказах. */
+    readonly title: string;
+    readonly options: readonly IOptionOfAxis[];
+}
+/** Ось и вид, которым помечен ресурс. У ресурса без пометки его нет. */
+export interface IVariant {
+    readonly axis: string;
+    readonly value: string;
+}
+export declare const VARIANTS_FILE: string;
+/** Оси, объявленные пакетом. Нет файла — осей нет, и все ресурсы считаются общими. */
+export declare function readAxes(assetsDir: string): readonly IAxis[];
+/**
+ * Чем помечено имя файла: `git-workflow.github.md` — видом `github` оси `host`.
+ *
+ * Вид ищется среди объявленных значений, а не по одному лишь виду имени. Иначе `app.config.md`
+ * прочитался бы как ресурс `app` вида `config`, и раскладка потеряла бы файл молча — по
+ * причине, которую в имени не разглядеть.
+ */
+export declare function variantOf(file: string, axes: readonly IAxis[]): IVariant | null;
+/** Имя файла без пометки вида: под ним ресурс и ложится в дерево проекта. */
+export declare function withoutVariant(file: string, variant: IVariant | null): string;
+/**
+ * Взят ли ресурс при этом выборе видов.
+ *
+ * Ресурс без пометки берётся всегда. Помеченный — только когда проект назвал ровно этот вид:
+ * невыбранная ось значит, что дерево о ней ничего не сказало, и класть ему наугад один из трёх
+ * git-flow хуже, чем не класть ни одного.
+ */
+export declare function matchesVariant(variant: IVariant | null, chosen: Readonly<Record<string, string>>): boolean;
+/** Оси, о которых проект молчит, хотя пакет их объявил, — по ним раскладка не полна. */
+export declare function unansweredAxes(axes: readonly IAxis[], chosen: Readonly<Record<string, string>>): readonly IAxis[];
+//# sourceMappingURL=variants.d.ts.map

package/lib/variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/variants.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,aAAa;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,KAAK;IAClB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C;AAED,wEAAwE;AACxE,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,aAAa,EAAE,MAAwB,CAAC;AAErD,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,EAAE,CAiB5D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,EAAE,GAAG,QAAQ,GAAG,IAAI,CAc/E;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM,CAQ7E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAE1G;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,KAAK,EAAE,CAIjH"}

package/lib/variants.js

@@ -0,0 +1,82 @@
+/**
+ * Оси различия между деревьями и выбор проекта по ним.
+ *
+ * Есть приёмы, которые везде одни, и есть такие, у которых один и тот же закон исполняется
+ * разными командами: заявка на слияние открывается `gh`, `glab` или `az repos` — в зависимости
+ * от того, где лежит репозиторий. Обезличить их до общего текста нельзя: правило, из которого
+ * убрали команду, перестаёт быть указанием и становится пожеланием.
+ *
+ * Поэтому такой ресурс лежит в пакете в нескольких видах — `git-workflow.github.md`,
+ * `git-workflow.gitlab.md`, `git-workflow.azure.md`, — а проект выбирает вид один раз, при
+ * заведении конфига. Разложен будет ровно один, под общим именем: агент читает `git-workflow`,
+ * а какой это хостинг, ему знать незачем.
+ *
+ * Ось объявлена пакетом, а не выдумана на месте: значение из конфига, которому ни одна ось не
+ * отвечает, — это опечатка, и молчать о ней нельзя.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const VARIANTS_FILE = 'variants.json';
+/** Оси, объявленные пакетом. Нет файла — осей нет, и все ресурсы считаются общими. */
+export function readAxes(assetsDir) {
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(join(assetsDir, VARIANTS_FILE), 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    if (typeof raw !== 'object' || raw === null) {
+        return [];
+    }
+    return Object.entries(raw).map(([name, axis]) => ({
+        name,
+        question: axis.question,
+        title: axis.title,
+        options: axis.options ?? [],
+    }));
+}
+/**
+ * Чем помечено имя файла: `git-workflow.github.md` — видом `github` оси `host`.
+ *
+ * Вид ищется среди объявленных значений, а не по одному лишь виду имени. Иначе `app.config.md`
+ * прочитался бы как ресурс `app` вида `config`, и раскладка потеряла бы файл молча — по
+ * причине, которую в имени не разглядеть.
+ */
+export function variantOf(file, axes) {
+    const parts = file.split('.');
+    if (parts.length < 3) {
+        return null;
+    }
+    const spoken = parts[parts.length - 2];
+    for (const axis of axes) {
+        if (axis.options.some((option) => option.value === spoken)) {
+            return { axis: axis.name, value: spoken };
+        }
+    }
+    return null;
+}
+/** Имя файла без пометки вида: под ним ресурс и ложится в дерево проекта. */
+export function withoutVariant(file, variant) {
+    if (!variant) {
+        return file;
+    }
+    const parts = file.split('.');
+    parts.splice(parts.length - 2, 1);
+    return parts.join('.');
+}
+/**
+ * Взят ли ресурс при этом выборе видов.
+ *
+ * Ресурс без пометки берётся всегда. Помеченный — только когда проект назвал ровно этот вид:
+ * невыбранная ось значит, что дерево о ней ничего не сказало, и класть ему наугад один из трёх
+ * git-flow хуже, чем не класть ни одного.
+ */
+export function matchesVariant(variant, chosen) {
+    return variant === null || chosen[variant.axis] === variant.value;
+}
+/** Оси, о которых проект молчит, хотя пакет их объявил, — по ним раскладка не полна. */
+export function unansweredAxes(axes, chosen) {
+    return axes.filter((axis) => !axis.options.some((option) => option.value === chosen[axis.name]));
+}
+//# sourceMappingURL=variants.js.map

package/lib/variants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/variants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAyBjC,MAAM,CAAC,MAAM,aAAa,GAAW,eAAe,CAAC;AAErD,sFAAsF;AACtF,MAAM,UAAU,QAAQ,CAAC,SAAiB;IACtC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,GAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAkB,EAAS,EAAE,CAAC,CAAC;QAC/F,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;KAC9B,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAsB;IAC1D,MAAM,KAAK,GAAsB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAW,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAqB,EAAW,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;YACjF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC9C,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAwB;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAa,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB,EAAE,MAAwC;IAC7F,OAAO,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC;AACtE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,IAAsB,EAAE,MAAwC;IAC3F,OAAO,IAAI,CAAC,MAAM,CACd,CAAC,IAAW,EAAW,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAqB,EAAW,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CACvH,CAAC;AACN,CAAC","sourcesContent":["/**\n * Оси различия между деревьями и выбор проекта по ним.\n *\n * Есть приёмы, которые везде одни, и есть такие, у которых один и тот же закон исполняется\n * разными командами: заявка на слияние открывается `gh`, `glab` или `az repos` — в зависимости\n * от того, где лежит репозиторий. Обезличить их до общего текста нельзя: правило, из которого\n * убрали команду, перестаёт быть указанием и становится пожеланием.\n *\n * Поэтому такой ресурс лежит в пакете в нескольких видах — `git-workflow.github.md`,\n * `git-workflow.gitlab.md`, `git-workflow.azure.md`, — а проект выбирает вид один раз, при\n * заведении конфига. Разложен будет ровно один, под общим именем: агент читает `git-workflow`,\n * а какой это хостинг, ему знать незачем.\n *\n * Ось объявлена пакетом, а не выдумана на месте: значение из конфига, которому ни одна ось не\n * отвечает, — это опечатка, и молчать о ней нельзя.\n */\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport interface IOptionOfAxis {\n    /** Значение, которое проект пишет в конфиг и которое стоит в имени файла: `github`. */\n    readonly value: string;\n    /** Чем этот вид отличается от соседнего — им человек и выбирает. */\n    readonly title: string;\n}\n\nexport interface IAxis {\n    /** Имя оси, оно же ключ в `variants` конфига: `host`. */\n    readonly name: string;\n    /** Вопрос, которым ось спрашивают при заведении конфига. */\n    readonly question: string;\n    /** Чем ось названа в перечнях и отказах. */\n    readonly title: string;\n    readonly options: readonly IOptionOfAxis[];\n}\n\n/** Ось и вид, которым помечен ресурс. У ресурса без пометки его нет. */\nexport interface IVariant {\n    readonly axis: string;\n    readonly value: string;\n}\n\nexport const VARIANTS_FILE: string = 'variants.json';\n\n/** Оси, объявленные пакетом. Нет файла — осей нет, и все ресурсы считаются общими. */\nexport function readAxes(assetsDir: string): readonly IAxis[] {\n    let raw: unknown;\n    try {\n        raw = JSON.parse(readFileSync(join(assetsDir, VARIANTS_FILE), 'utf8'));\n    } catch {\n        return [];\n    }\n    if (typeof raw !== 'object' || raw === null) {\n        return [];\n    }\n\n    return Object.entries(raw as Record<string, IAxis>).map(([name, axis]: [string, IAxis]): IAxis => ({\n        name,\n        question: axis.question,\n        title: axis.title,\n        options: axis.options ?? [],\n    }));\n}\n\n/**\n * Чем помечено имя файла: `git-workflow.github.md` — видом `github` оси `host`.\n *\n * Вид ищется среди объявленных значений, а не по одному лишь виду имени. Иначе `app.config.md`\n * прочитался бы как ресурс `app` вида `config`, и раскладка потеряла бы файл молча — по\n * причине, которую в имени не разглядеть.\n */\nexport function variantOf(file: string, axes: readonly IAxis[]): IVariant | null {\n    const parts: readonly string[] = file.split('.');\n    if (parts.length < 3) {\n        return null;\n    }\n    const spoken: string = parts[parts.length - 2];\n\n    for (const axis of axes) {\n        if (axis.options.some((option: IOptionOfAxis): boolean => option.value === spoken)) {\n            return { axis: axis.name, value: spoken };\n        }\n    }\n\n    return null;\n}\n\n/** Имя файла без пометки вида: под ним ресурс и ложится в дерево проекта. */\nexport function withoutVariant(file: string, variant: IVariant | null): string {\n    if (!variant) {\n        return file;\n    }\n    const parts: string[] = file.split('.');\n    parts.splice(parts.length - 2, 1);\n\n    return parts.join('.');\n}\n\n/**\n * Взят ли ресурс при этом выборе видов.\n *\n * Ресурс без пометки берётся всегда. Помеченный — только когда проект назвал ровно этот вид:\n * невыбранная ось значит, что дерево о ней ничего не сказало, и класть ему наугад один из трёх\n * git-flow хуже, чем не класть ни одного.\n */\nexport function matchesVariant(variant: IVariant | null, chosen: Readonly<Record<string, string>>): boolean {\n    return variant === null || chosen[variant.axis] === variant.value;\n}\n\n/** Оси, о которых проект молчит, хотя пакет их объявил, — по ним раскладка не полна. */\nexport function unansweredAxes(axes: readonly IAxis[], chosen: Readonly<Record<string, string>>): readonly IAxis[] {\n    return axes.filter(\n        (axis: IAxis): boolean => !axis.options.some((option: IOptionOfAxis): boolean => option.value === chosen[axis.name])\n    );\n}\n"]}

package/package.json

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

package/assets/laws/admin-lists.md

@@ -1,35 +0,0 @@
-# Список записей в админке
-
-Как владелец видит набор записей и что с ними делает, не открывая ни одну: заявки, объекты,
-адреса страниц, промокоды, подписки на календарь. Правила общие для всех разделов — список,
-устроенный иначе остальных, владелец читает заново.
-
-Открытая запись, попадание в раздел и объём данных на строку — предмет других законов.
-
-## Статьи
-
-- **Записи показаны таблицей: строка — запись, столбец — её свойство.**
-- **Клик по строке открывает запись.** Меню строки — для действий над ней, а не для входа.
-- **Пока список читается, на месте строк — скелетоны.** Пустая область неотличима от списка,
-  в котором ничего нет.
-- **Пустой список объясняет, почему он пуст.**
-- **На узком экране строка становится карточкой.**
-- **Состав и порядок столбцов задаёт владелец, и выбор сохраняется между заходами.**
-- **Слева в тулбаре — то, что меняет выборку, справа — действия над списком.**
-- **Действие, недоступное записи, в её меню не показано.**
-- **У записи, которой нельзя сделать ничего, кнопки меню нет.**
-- **Действие, которое нельзя отменить, спрашивает подтверждение и называет последствие.**
-- **Отказ загрузки подаётся тостом, а повторить владелец может кнопкой обновления.**
-- **Список показывает тот порядок и тот отбор, которые применены к записям.** Порядок по
-  умолчанию виден стрелкой сразу, а условие, которого сервер не принял, не остаётся в тулбаре
-  как действующее.
-- **Заголовки столбцов, тексты состояний и подписи действий приходят из словарей.**
-- **Вид списка живёт в адресе: отбор, порядок и номер страницы.** Иначе ссылку на отобранный
-  список не передать, перезагрузка возвращает список к умолчанию, а возврат из открытой записи
-  сбрасывает набранное. Размер страницы и состав столбцов в адресе не участвуют: они про
-  владельца, а не про то, что он показывает другому.
-- **Форма запроса списка одна на все разделы, и ответ несёт общее число записей.** Переписанная
-  в каждом разделе, она расходится по одному полю за раз; без общего числа не показать, сколько
-  страниц.
-- **Выпадающий список берётся той же страницей, что и таблица, и догружается прокруткой.**
-  Страниц в нём не видно, значит и переключать их нечем.

package/assets/laws/admin-navigation.md

@@ -1,38 +0,0 @@
-# Навигация админки
-
-Как владелец находит раздел и попадает в него. Правила держат все разделы админки сразу —
-заявки, объекты, календарь, переписку, аналитику, цены, организацию, — и разойтись им нельзя:
-раздел, который ведёт себя иначе остальных, выглядит сломанным.
-
-## Статьи
-
-- **Пункт меню ведёт на свой экран.** Не на вкладку внутри чужого экрана и не на панель: адрес
-  открывается по прямой ссылке, переживает перезагрузку и передаётся другому человеку.
-- **Раздел, ни один пункт которого владельцу не виден, в меню не показан.**
-- **Адрес раздела открывается только тому, кому виден его пункт меню.**
-- **Одного права из перечисленных достаточно, чтобы раздел был виден.** Части страницы гейтятся
-  отдельно: дашборд полезен и тому, кто видит только деньги, и тому, кто видит только трафик.
-- **Пункт, у которого экрана ещё нет, виден любому владельцу.** Права на него не выдаются:
-  право открывает экран, а экрана нет.
-- **Недоступный пункт остаётся видимым.** Исчезнувший пункт неотличим от того, которого никогда
-  не было.
-- **Подсказка есть только у недоступного пункта и объясняет, почему он не нажимается.** У
-  доступного она дословно повторяет подпись рядом и ничего не добавляет.
-- **Недоступный пункт принимает наведение и фокус с клавиатуры.**
-- **Адрес экрана начинается с адреса раздела, в котором стоит его пункт меню.**
-- **Активный раздел подсвечен, даже когда открыт его вложенный экран.**
-- **Подписи разделов приходят из словарей и меняются вместе с языком без перезагрузки.**
-- **Панель второго уровня открывается наведением, нажатие — запасной путь для касания.**
-- **Панель второго уровня разложена колонками, а внутри колонки — группами с подписью.**
-- **Колонка без заголовка у первой группы начинает пунктами от верха панели.** Пустое место
-  на высоту заголовка в ней не оставляется.
-- **Ширина панели зависит от числа колонок, а не от длины подписей.**
-- **Панель целиком помещается в экран.** Панель на три колонки шире расстояния от своего
-  раздела до правого края, и без этого её последняя колонка остаётся за экраном.
-- **Раздел с панелью несёт указатель раскрытия, раздел без панели — не несёт.** Иначе не видно,
-  откроется ли что-то при наведении, и владелец наводит наугад.
-- **На узком экране меню сворачивается в кнопку и раскрывается списком с теми же разделами.**
-- **Меню на узком экране прокручивается, когда пункты не помещаются по высоте.**
-- **На вложенном экране видно, из какого он раздела и как вернуться на уровень выше.**
-  Подсветка раздела в меню говорит, где владелец сейчас, но не даёт пути назад: без него
-  наверх возвращаются кнопкой браузера, а из открытого по ссылке экрана — некуда.

package/assets/patterns/git-workflow-commit.md

@@ -1,175 +0,0 @@
----
-name: git-workflow-commit
-kind: pattern
-rule: git-workflow
-description: Паттерн правила git-workflow. Брать на заведение задачи, ветки, коммит, пуш и создание PR — план до первой задачи, заведение задачи всеми шагами сразу, перевод по колонкам, слияние двух задач в одну, работа от учётной записи машинной работы, формат заголовка, строка связи с задачей, состав PR, чеклист проверок до публикации. Не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
----
-
-# Ветка, коммит и PR
-
-Паттерн правила `git-workflow`. Что при этом должно быть верно — закон `{{lawsDir}}/delivery.md`.
-
-## Когда брать
-
-- Заводится задача, с которой начинается правка.
-- Заводится ветка под задачу.
-- Готовится коммит или пуш.
-- Открывается PR.
-- Работа перешла на следующий шаг, и задача переставляется в другую колонку.
-
-## Сначала план, потом задачи
-
-Работа, из которой выходит больше одной задачи, начинается с плана, и план показывается
-владельцу до того, как заведена первая задача. Разбивка — решение о том, что делается и в каком
-порядке, и принимает его владелец, а не тот, кто заводит.
-
-Заведённые до согласования задачи стоят в очереди как решённое дело: они показывают работу,
-которую никто не заказывал, и убирать их потом дороже, чем не заводить.
-
-Признак тот же, что у деления на ветки, — раздельный откат. Один дефект планом не описывается:
-для него сразу заводится задача.
-
-Плана нет, а работа делится — сначала пишется план, показывается, и только после ответа
-владельца заводится первая задача. Ответ «делай» — тоже ответ; молчание им не является.
-
-## Сначала задача, потом ветка
-
-Заведение состоит из нескольких шагов: сама задача, номер в её заголовке, добавление в очередь,
-начальное состояние. Очередь к репозиторию обычно не привязана, поэтому добавление само не
-случается, и задача без него не видна ни в очереди, ни владельцу. Все шаги делает одна команда
-— не рука.
-
-Название задачи говорит, что не так, а не что сделать: PR потом переводит его в сделанное.
-Номер в заголовок руками не пишется — он известен только после создания.
-
-## Две задачи, которые чинятся одной правкой
-
-Если по ходу выяснилось, что правка закрывает и соседнюю задачу, — это одна задача, а не две.
-Слить их можно, пока правка не въехала в главную ветку: недостающее из поглощённой дописывается
-в тело первой, и только потом поглощённая закрывается и снимается с очереди. Порядок важен —
-удаление уносит с собой ссылки на неё из чужих тел.
-
-После слияния ветки поглощения нет: она въехала, и откатывается целиком.
-
-## Ветка заводится отдельным вызовом
-
-Гард главной ветки разбирает текст команды и смотрит ветку на момент запуска, поэтому составная
-команда отклоняется целиком — ветки в ней ещё нет:
-
-```bash
-✗ git checkout -b <ветка> && git commit -m '…'
-✓ git checkout -b <ветка>
-✓ git commit -F -
-```
-
-Имя ветки несёт номер задачи. Гард поставки разбирает его на месте и отбивает промах в форме до
-первого коммита, а по номеру спрашивает очередь: задача должна существовать, быть открытой,
-стоять в очереди и иметь исполнителя.
-
-Имя без номера законно, пока ветка живёт локально — под пробу и разбор. PR с неё не откроется:
-правка, доезжающая до главной ветки, начинается с задачи.
-
-## Колонка задачи двигается вместе с работой
-
-Ветка заведена — задача уже не в начальной колонке, а в работе. PR открыт — она ждёт разбора.
-Оба перевода делает одна команда, вторым вызовом сразу за тем, который его вызвал.
-
-Перевод не откладывается на потом: очередь читают между шагами, а не после них. Задача с
-открытым PR, простоявшая в начальной колонке, всё это время выглядела нетронутой — и разбора за
-неё никто не ждал.
-
-## Коммит подписывается учётной записью машинной работы
-
-Токен читается в переменную и не печатается; автор и коммиттер задаются переменными той же
-команды. Правка общей настройки здесь не годится — она переписала бы подпись владельцу:
-
-```bash
-TOKEN=$(tr -d '\n' < <файл с токеном>)
-
-GIT_AUTHOR_NAME="<бот>" GIT_AUTHOR_EMAIL="<адрес бота>" \
-GIT_COMMITTER_NAME="<бот>" GIT_COMMITTER_EMAIL="<адрес бота>" \
-    git commit -F -
-```
-
-Заголовок — `тип(область): описание`, без точки в конце. Набор типов и областей задан
-настройкой проверки заголовка.
-
-## Документ едет тем же коммитом
-
-Гард документов требует пару и называет её сам. Обход — строка в теле коммита, причина
-обязательна:
-
-```
-Docs-skip: правка только в сценариях хука, зеркала у него нет
-```
-
-## Номер задачи стоит в её заголовке и в заголовке PR
-
-Форма одна на оба. Номер стоит в самом заголовке, а не только в теле: в списке PR тела не
-видно. Тот же номер несёт и имя ветки — поэтому задача, ветка и PR читаются как одно.
-
-Задача говорит, что не так; PR тем же номером отчитывается, что сделано. Инфинитив из задачи в
-заголовок PR не переносится: «исправить» становится «исправлено».
-
-Тип и область коммита в заголовок PR не идут: род правки и область уже видны метками.
-
-## PR прикрепляется к задаче
-
-Тело начинается со строки связи с задачей — по ней в очереди заполняется поле связанных PR.
-Ревьювер, исполнитель и метки задаются той же командой, и PR без них не открывается.
-
-Ревьювер — всегда владелец: без запроса разбора PR не показывается ему в очереди. Метки берутся
-у задачи целиком — и род правки, и все её области; читаются они у задачи, а не выбираются по
-памяти.
-
-Строка связи обязательна: без неё PR не прикрепляется к задаче. Она же означает, что задача
-закрывается целиком — половину задачи одним PR не выкатывают: у задачи одна ветка, и работа,
-которая в неё не влезает, делится на задачи до того, как ветка заводится.
-
-Тело перечитывается всякий раз, когда в ветку что-то влилось после публикации: отчёт утверждает
-про дерево, а дерево с тех пор изменилось.
-
-## Что проверяется до публикации PR
-
-Проверок на самом PR нет: выкатка запускается пушем в главную ветку, и до слияния никто не
-гоняет ничего. Линтеры и юниты снимает гейт пуша — ниже то, чего он не знает.
-
-1. **В ветке только та правка, за которой её заводили** — сводка расхождения с главной веткой.
-   Чужой домен в списке файлов означает, что правка расползлась.
-2. **Ни мока, ни подменённого ответа, ни отладочной строки** — расхождение читается целиком, а
-   не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-3. **Документ едет тем же коммитом.** Пару называет гард, но спек домена и правку его поведения
-   он не знает — это остаётся за автором.
-4. **Проверки текстов и раскладки зелёные.**
-5. **Все приложения собираются.** Гейт пуша сборку обычно не гоняет.
-6. **Видимый текст заведён во всех локалях.**
-7. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
-   `browser-verification-measure`.
-8. **Правка публичной разметки проверена на прод-сборке по всем локалям** — паттерн
-   `seo-verify`.
-9. **Тело PR начинается строкой связи с задачей**, а метки, ревьювер и исполнитель стоят.
-10. **Заголовок PR несёт номер задачи и называет её сделанной** — тем же номером, что у задачи
-    и в имени ветки.
-11. **Очередь работ сходится.** Задача в очереди, с исполнителем и номером в заголовке; PR один
-    на задачу, и закрывает он её целиком.
-
-Сразу после публикации задача переставляется в разбор, и сверка очереди прогоняется ещё раз: до
-открытия PR колонку она не судит, а после открытия расхождение видит.
-
-Сделанное рассуждением и сделанное замером в теле PR разводятся прямо: непроверенное, названное
-проверенным, ревьювер принимает за проверенное.
-
-## Частые промахи
-
-- **Добавление в индекс нескольких путей не добавляет ничего, если хоть один путь не
-  существует.** Команда обрывается на первом промахе целиком, а следующая правка последнего
-  коммита уносит в него всё, что осталось в индексе. Состав коммита читается сразу после него,
-  а не на разборе PR.
-- **Задача, заведённая мимо команды, в очередь не попадает и гардом не отбивается** — он
-  смотрит команду, а не задачу. Ловится это только сверкой очереди.
-- **Исполнитель у задачи сам не проставляется** ни при заведении через веб, ни при добавлении в
-  очередь.
-- **Колонка сама не двигается** ни от заведения ветки, ни от открытия PR: очередь ветки не
-  видит вовсе, а связь с PR заполняет только поле связанных PR.
-- **Постраничный обход очереди через общий флаг уходит в повтор первой страницы** — курсор
-  берётся из ответа руками, а полнота сверяется с общим числом элементов.