@rt-tools/agent-kit 0.22.0 → 0.24.0

package/lib/shipment.js.map

@@ -1 +1 @@
-{"version":3,"file":"shipment.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/shipment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Сборка груза и команда отправки.\n *\n * Груз уезжает при каждом прогоне, а предложения и разборы — когда они есть: прогон без\n * замечаний тоже говорит, чем пользовались, чем не пользовались ни разу и что дерево\n * переопределило. Отправка, построенная вокруг предложения, эти данные теряла.\n *\n * Собирается груз здесь, а уезжает в `ship.ts`: сборка проверяется вызовом, а сеть в спеке\n * подменяется двойником.\n */\nimport { createHash } from 'node:crypto';\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport {\n    CARGO_SCHEMA_VERSION,\n    ICargoCount,\n    ICargoOverride,\n    IPostmortemItem,\n    IPostmortemsCargo,\n    IProposalItem,\n    IProposalsCargo,\n    ISummaryCargo,\n} from './cargo.js';\nimport { IEnvironment, IOutcomeOfCommand } from './commands.js';\nimport { CONFIG_PATH, IConfig, readConfig } from './config.js';\nimport { IReadResult, ISummary, readObservations, summarize } from './observations.js';\nimport { ILeak, IProposal, leaksIn, markSent, marksOf, nearestMissing, readProposals, TO_PACKAGE } from './proposals.js';\nimport { IShipment, IShipped, readToken, TShip } from './ship.js';\nimport { laidOutSkills, packagedNames, treeSnapshot, unpickedOf } from './snapshot.js';\nimport { byText } from './order.js';\n\n/** Длина признака дерева. Двенадцати знаков хватает, чтобы деревья не сталкивались числом. */\nconst SLUG_LENGTH: number = 12;\n\n/** Отказ команды: именованных кодов у пакета нет — есть код возврата и текст. */\nconst REFUSED: number = 1;\n\n/** Ответ приёма о токене: по нему отказ добавляет строку про отзыв, а не гадает вслух. */\nconst TOKEN_REFUSED: number = 401;\n\n/** Чем отправка живёт: чем отправлять, чем себя выдаёт дерево и за какой отрезок сводка. */\nexport interface IShipOptions {\n    /** Печатать, что уехало бы, и не отправлять ничего. */\n    readonly dryRun: boolean;\n    readonly ship: TShip;\n    /** Адрес удалённого репозитория этого дерева: из него считается признак. */\n    readonly remote: string;\n    /** Имена удалённых репозиториев. Нужны отказу: выбор между несколькими делает человек. */\n    readonly remotes?: readonly string[];\n    /** Сегодняшний день: своих часов у команды нет — иначе сводку за отрезок не проверить спекой. */\n    readonly today: string;\n    readonly days: number;\n}\n\n/**\n * Адрес удалённого репозитория, приведённый к одному виду.\n *\n * Форм у него несколько — `git@host:владелец/имя.git`, `https://host/владелец/имя`, — и все они\n * ведут к одному дереву. Две рабочие копии одного репозитория обязаны дать один признак, а\n * непривёденные формы дали бы два.\n */\nexport function remoteMarkOf(remote: string): string {\n    const named: string = remote\n        .trim()\n        .replace(/\\.git$/, '')\n        .replace(/^[a-z+]+:\\/\\//i, '')\n        .replace(/^[^@/]+@/, '')\n        .replace(/:/g, '/');\n    let end: number = named.length;\n\n    while (end > 0 && named[end - 1] === '/') {\n        end -= 1;\n    }\n\n    return named.slice(0, end).toLowerCase();\n}\n\n/**\n * Признак дерева: короткое значение, различающее деревья и не выдающее их адреса.\n *\n * Считается хешем от адреса репозитория: по нему адрес не восстанавливается, а у двух рабочих\n * копий одного репозитория он один. Репозитория нет — берётся то, что назвала настройка: иначе\n * все такие деревья слились бы в одно, и число деревьев в сводке стало бы неправдой молча.\n */\nexport function treeSlugOf(remote: string, spoken: string): string {\n    const mark: string = remoteMarkOf(remote);\n\n    return mark ? createHash('sha256').update(mark, 'utf8').digest('hex').slice(0, SLUG_LENGTH) : spoken;\n}\n\n/**\n * Счётчики по ресурсам пакета. Имя, которого пакет не знает, — имя правила самого дерева, и\n * наружу оно не едет: дерево называет свои правила по своим доменам и по себе самому.\n *\n * Число событий при этом остаётся полным: считается их столько, сколько было, — отброшены имена,\n * а не наблюдения.\n */\nfunction knownCounts(counts: readonly ICargoCount[], known: ReadonlySet<string>): readonly ICargoCount[] {\n    return counts.filter((count: ICargoCount): boolean => known.has(count.name));\n}\n\n/** Сводка наблюдений вместе со снимком надстроек — то, что уезжает первым запросом. */\nexport function summaryCargo(\n    summary: ISummary,\n    tree: string,\n    overrides: readonly ICargoOverride[],\n    unpicked: readonly string[],\n    known: ReadonlySet<string>\n): ISummaryCargo {\n    return {\n        tree,\n        unpicked,\n        overrides,\n        schema: CARGO_SCHEMA_VERSION,\n        days: summary.days,\n        sessions: summary.sessions,\n        loads: knownCounts(summary.loads, known),\n        denials: knownCounts(summary.denials, known),\n        // Род правки, на котором гейт отбивал, ресурсом не является: это `extension`, `command`\n        // или `browser` — слова пакета, одинаковые у всех деревьев.\n        kinds: summary.kinds,\n        guards: knownCounts(summary.guards, known),\n        unused: summary.unused,\n        versions: summary.versions,\n        total: summary.total,\n    };\n}\n\n/**\n * Разборы происшествий, как они лежат на дереве.\n *\n * Текст едет целиком: разбор объясняет механизм промаха, и шапка без механизма не отвечает ни на\n * один вопрос, ради которого его читают.\n */\nexport function readPostmortems(root: string, dir: string): IPostmortemItem[] {\n    const path: string = join(root, dir);\n\n    if (!existsSync(path)) {\n        return [];\n    }\n\n    return (\n        readdirSync(path)\n            // Описание каталога разбором не является: оно объясняет, что здесь лежит, а не механизм\n            // промаха, — и в приёме встало бы записью, которой нечего сказать.\n            .filter((file: string): boolean => file.endsWith('.md') && file !== 'README.md')\n            .sort(byText)\n            .map((file: string): IPostmortemItem => ({ file, text: readFileSync(join(path, file), 'utf8') }))\n    );\n}\n\n/** Что уезжает и в каком порядке: сводка первой — ею заводится запись месяца. */\nexport function shipmentsOf(summary: ISummaryCargo, proposals: IProposalsCargo, postmortems: IPostmortemsCargo): readonly IShipment[] {\n    return [\n        { kind: 'сводка', operation: 'summary', body: summary },\n        ...(proposals.items.length ? [{ kind: 'предложения', operation: 'proposals', body: proposals }] : []),\n        ...(postmortems.items.length ? [{ kind: 'разборы', operation: 'postmortems', body: postmortems }] : []),\n    ];\n}\n\n/**\n * Что в грузе называет дерево, из которого он уезжает.\n *\n * Проверка накрывает сводку и предложения, но не разбор происшествия: разбор по устройству\n * называет файлы дерева, где промах случился, и накрытая проверка отбивала бы каждую его\n * отправку.\n */\nexport function leaksOfCargo(summary: ISummaryCargo, proposals: readonly IProposal[], marks: readonly string[]): string[] {\n    const inSummary: string[] = leaksIn(JSON.stringify(summary, null, 1), marks).map(\n        (leak: ILeak): string => `  сводка: ${leak.why}\\n      ${leak.text}`\n    );\n    const inProposals: string[] = proposals.flatMap((entry: IProposal): string[] =>\n        leaksIn(entry.body, marks).map(\n            (leak: ILeak): string => `  ${entry.file}:${entry.line + leak.line} — ${leak.why}\\n      ${leak.text}`\n        )\n    );\n\n    return [...inSummary, ...inProposals];\n}\n\n/** Отказ строками. */\nfunction refusal(...lines: readonly string[]): IOutcomeOfCommand {\n    return { code: REFUSED, lines: [...lines] };\n}\n\n/** Что в отправляемом запросе, одной строкой: её читает человек перед тем, как отправить. */\nfunction describe(shipment: IShipment, summary: ISummaryCargo, proposals: IProposalsCargo, postmortems: IPostmortemsCargo): string {\n    if (shipment.operation === 'proposals') {\n        return `предложений ${proposals.items.length}`;\n    }\n    if (shipment.operation === 'postmortems') {\n        return `разборов ${postmortems.items.length}`;\n    }\n\n    return `наблюдений ${summary.total} за ${summary.days} дн., надстроек ${summary.overrides.length}, невыбранного ${summary.unpicked.length}`;\n}\n\n/** Блок, который не уехал, и причина этого. */\ninterface IRefusedProposal {\n    readonly proposal: IProposal;\n    readonly why: string;\n}\n\n/**\n * Отметка об отбое: отбитый блок остаётся на диске и несёт причину.\n *\n * Удалённый блок пишется следующим заходом заново — следа разбора нет, и повтор возвращается.\n * Отметка держит и то и другое: видно, что разбор был, и видно, почему он не стал правкой.\n */\nfunction markRefused(root: string, refused: readonly IRefusedProposal[]): void {\n    for (const one of refused) {\n        const path: string = join(root, one.proposal.file);\n        writeFileSync(path, markSent(readFileSync(path, 'utf8'), one.proposal, one.why, 'отбито'), 'utf8');\n    }\n}\n\n/**\n * Перечень груза: что именно уедет и куда — строками, которые читаются до самой отправки.\n *\n * Печатается он обоими прогонами, и разделены они не окончанием глагола, а первой строкой:\n * «уехало» и «уехало бы» отличаются двумя буквами в хвосте, а строки под ними одинаковы до\n * знака. Прочитанный не тем прогоном, вывод сухого читается сделанной работой — и наоборот,\n * настоящая отправка читается пробой, после которой ничего не делают.\n */\nfunction manifest(\n    going: readonly IShipment[],\n    summary: ISummaryCargo,\n    proposals: IProposalsCargo,\n    postmortems: IPostmortemsCargo\n): readonly string[] {\n    return going.map((shipment: IShipment): string => `  ${shipment.operation} — ${describe(shipment, summary, proposals, postmortems)}`);\n}\n\n/** Пометка об отправке: по ней предложение второй раз не уезжает. */\nfunction markProposals(root: string, proposals: readonly IProposal[], shipped: IShipped): void {\n    const mark: string = `приём:${shipped.accepted?.month ?? 'принято'}`;\n\n    for (const proposal of proposals) {\n        const path: string = join(root, proposal.file);\n        writeFileSync(path, markSent(readFileSync(path, 'utf8'), proposal, mark), 'utf8');\n    }\n}\n\n/**\n * Что приём сказал о принятом: месяц записи, судьба самой записи и — у предложений — счёт\n * легшего и уже лежавшего.\n *\n * Без счёта строка одинакова и у прогона, привёзшего новое, и у прогона, у которого всё уже\n * лежало: человек читает второе как первое. Приём, счёта не приславший, оставляет строку\n * прежней — так же читаются сводка и разборы, у которых счёта нет вовсе.\n */\nfunction accepted(shipped: IShipped): string {\n    if (!shipped.accepted) {\n        return 'принято';\n    }\n\n    const record: string = `${shipped.accepted.month}${shipped.accepted.created ? ', запись заведена' : ', запись дописана'}`;\n    const added: number | undefined = shipped.accepted.added;\n\n    return added === undefined ? record : `${record}, принято ${added}, уже лежало ${shipped.accepted.known ?? 0}`;\n}\n\n/**\n * Отказ, когда признак дерева считать не из чего. Случая два, и говорят они разное: репозитория\n * нет вовсе — считать не из чего; репозиториев несколько и `origin` среди них нет — адрес есть, а\n * выбрать его может только человек. Угаданное неверно сливает в сводке приёма два дерева в одно,\n * и увидеть это нечем.\n */\nfunction noTreeMark(names: readonly string[]): IOutcomeOfCommand {\n    if (names.length > 1) {\n        return refusal(\n            `признак дерева не считается: удалённых репозиториев несколько, а \\`origin\\` среди них нет — ${names.join(', ')}`,\n            `переименуй тот, что называет это дерево, в \\`origin\\` — либо назови признак ключом \\`tree\\` в ${CONFIG_PATH}`\n        );\n    }\n\n    return refusal(\n        'признак дерева не считается: удалённого репозитория нет',\n        `назови его ключом \\`tree\\` в ${CONFIG_PATH} — иначе деревья без репозитория сольются в одно`\n    );\n}\n\n/**\n * Сами запросы. Отправленное помечается сразу, а не после всех: оборвавшаяся отправка иначе\n * увозит половину и не оставляет следа, по которому видно, какую именно.\n */\nasync function send(\n    root: string,\n    intake: string,\n    tree: string,\n    token: string,\n    ship: TShip,\n    going: readonly IShipment[],\n    proposals: readonly IProposal[],\n    listed: readonly string[]\n): Promise<IOutcomeOfCommand> {\n    // Что уедет, названо до того, как уехало: отказ на втором запросе иначе оставляет человека с\n    // одной строкой о нём и без перечня, из которого видно, чего этот отказ стоил.\n    const head: readonly string[] = [`ОТПРАВКА — груз уходит в ${intake}, дерево ${tree}:`, ...listed];\n    const done: string[] = [];\n\n    for (const shipment of going) {\n        const shipped: IShipped = await ship(intake, token, shipment);\n\n        if (!shipped.ok) {\n            return {\n                code: REFUSED,\n                lines: [\n                    ...head,\n                    ...(done.length ? [`уехало до отказа: ${done.length}`, ...done] : ['не уехало ничего']),\n                    `${shipment.kind}: ${intake} ответил ${shipped.status || 'молчанием'} — ${shipped.said}`,\n                    ...(shipped.status === TOKEN_REFUSED\n                        ? ['токен не принят: он отозван или заведён не тот — выдай новый командой приёма']\n                        : []),\n                ],\n            };\n        }\n\n        done.push(`  ${shipment.kind} → ${accepted(shipped)}`);\n\n        if (shipment.operation === 'proposals') {\n            markProposals(root, proposals, shipped);\n        }\n    }\n\n    return { code: 0, lines: [...head, 'уехало:', ...done] };\n}\n\n/**\n * Отправка груза в приём.\n *\n * Порядок отказов не случаен: выключенная запись отвечает нулём и молчит про адрес — она гасит\n * отправку целиком, вместе со снимком надстроек, и спрашивать про адрес у выключенного дерева\n * незачем.\n */\nexport async function propose(env: IEnvironment, options: IShipOptions): Promise<IOutcomeOfCommand> {\n    const { root, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n\n    if (!config) {\n        return refusal(`конфига нет: ${CONFIG_PATH} — заводится \\`agent-kit init\\``);\n    }\n    if (!config.observe) {\n        return {\n            code: 0,\n            lines: [\n                'запись наблюдений выключена ключом `observe` в конфиге — наружу не ушло ничего',\n                'выключатель гасит и отправку целиком, вместе со снимком надстроек',\n            ],\n        };\n    }\n    if (!config.intake) {\n        return refusal('отправлять некуда: адреса приёма нет', `он объявляется ключом \\`intake\\` в ${CONFIG_PATH}`);\n    }\n\n    const tree: string = treeSlugOf(options.remote, config.tree);\n    if (!tree) {\n        return noTreeMark(options.remotes ?? []);\n    }\n\n    const token: string = readToken(root, config.token);\n    if (!token) {\n        return refusal(\n            'токена дерева нет: груз остался неотправленным',\n            `файл с ним называется ключом \\`token\\` в ${CONFIG_PATH} и лежит вне дерева`,\n            'выдаётся токен командой приёма — `tree:add` или `tree:token`'\n        );\n    }\n\n    const read: IReadResult = readObservations(root, options.today, options.days);\n    const summary: ISummary = summarize(read.observations, laidOutSkills(config, assetsDir), options.days);\n    const cargo: ISummaryCargo = summaryCargo(\n        summary,\n        tree,\n        treeSnapshot(config, assetsDir, root),\n        unpickedOf(config, assetsDir),\n        packagedNames(config, assetsDir)\n    );\n\n    const ready: readonly IProposal[] = readProposals(root).filter(\n        (entry: IProposal): boolean => entry.address === TO_PACKAGE && !entry.sent\n    );\n    // Блок, не назвавший ближайшего утверждения ресурса, не уезжает: разбор, кончившийся ещё\n    // одной статьёй о том, о чём статья уже стоит, снаружи неотличим от разбора, кончившегося\n    // исправлением. Отбивается он поимённо, а остальные едут: один непрочитанный ресурс не\n    // повод задержать чужую работу.\n    const refused: readonly IRefusedProposal[] = ready\n        .map((entry: IProposal): IRefusedProposal => ({ proposal: entry, why: nearestMissing(entry, assetsDir) }))\n        .filter((entry: IRefusedProposal): boolean => Boolean(entry.why));\n    const mine: readonly IProposal[] = ready.filter(\n        (entry: IProposal): boolean => !refused.some((one: IRefusedProposal): boolean => one.proposal === entry)\n    );\n    const proposals: IProposalsCargo = {\n        tree,\n        schema: CARGO_SCHEMA_VERSION,\n        items: mine.map((entry: IProposal): IProposalItem => ({ text: entry.body, address: entry.address, resource: entry.resource })),\n    };\n    const postmortems: IPostmortemsCargo = { tree, schema: CARGO_SCHEMA_VERSION, items: readPostmortems(root, config.postmortems) };\n\n    // Проверка на адрес дерева судит все готовые блоки, а не одни уезжающие: отбитый по цитате\n    // лежит на диске и уедет, как только его починят, — а найденная в нём утечка отбивает\n    // отправку целиком и должна называться сразу.\n    const leaked: readonly string[] = leaksOfCargo(cargo, ready, marksOf(root, options.remote));\n    if (leaked.length) {\n        return refusal(\n            `отправка не начата: в грузе назван адрес этого дерева — ${leaked.length}`,\n            ...leaked,\n            'найденное отбивает отправку целиком: «уехало два из трёх» читается как «всё в порядке»'\n        );\n    }\n\n    const going: readonly IShipment[] = shipmentsOf(cargo, proposals, postmortems);\n\n    const listed: readonly string[] = manifest(going, cargo, proposals, postmortems);\n    // Отбитое называется обоими прогонами: сухой показывает, что уехало бы, — и отбитое к этому\n    // относится наравне с уезжающим.\n    const refusedLines: readonly string[] = refused.map(\n        (one: IRefusedProposal): string => `  отбито ${one.proposal.file}:${one.proposal.line} — ${one.why}`\n    );\n\n    if (options.dryRun) {\n        return {\n            code: 0,\n            lines: [\n                'СУХОЙ ПРОГОН — наружу не ушло ничего, отметок об отправке не поставлено',\n                `уехало бы в ${config.intake}, дерево ${tree}:`,\n                ...listed,\n                ...refusedLines,\n                ...(read.silent ? ['наблюдений не велось ни разу — сводка уезжает снимком надстроек'] : []),\n                'отправляет это тот же вызов без `--dry-run`',\n            ],\n        };\n    }\n\n    // Отметка ставится до отправки: отбитое наружу не едет вовсе, и ждать ответа приёма ей\n    // незачем.\n    markRefused(root, refused);\n\n    const outcome: IOutcomeOfCommand = await send(root, config.intake, tree, token, options.ship, going, mine, [\n        ...listed,\n        ...refusedLines,\n    ]);\n\n    return outcome;\n}\n"]}
+{"version":3,"file":"shipment.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/shipment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Сборка груза и команда отправки.\n *\n * Груз уезжает при каждом прогоне, а предложения и разборы — когда они есть: прогон без\n * замечаний тоже говорит, чем пользовались, чем не пользовались ни разу и что дерево\n * переопределило. Отправка, построенная вокруг предложения, эти данные теряла.\n *\n * Собирается груз здесь, а уезжает в `ship.ts`: сборка проверяется вызовом, а сеть в спеке\n * подменяется двойником.\n */\nimport { createHash } from 'node:crypto';\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport {\n    CARGO_SCHEMA_VERSION,\n    ICargoCount,\n    ICargoOverride,\n    IPostmortemItem,\n    IPostmortemsCargo,\n    IProposalItem,\n    IProposalsCargo,\n    ISummaryCargo,\n} from './cargo.js';\nimport { IEnvironment, IOutcomeOfCommand } from './commands.js';\nimport { CONFIG_PATH, IConfig, readConfig } from './config.js';\nimport { IReadResult, ISummary, readObservations, summarize } from './observations.js';\nimport { ILeak, IProposal, leaksIn, markSent, marksOf, nearestMissing, readProposals, TO_PACKAGE } from './proposals.js';\nimport { IShipment, IShipped, readToken, TShip } from './ship.js';\nimport { laidOutSkills, packagedNames, treeSnapshot, unpickedOf } from './snapshot.js';\nimport { byText } from './order.js';\n\n/** Длина признака дерева. Двенадцати знаков хватает, чтобы деревья не сталкивались числом. */\nconst SLUG_LENGTH: number = 12;\n\n/** Отказ команды: именованных кодов у пакета нет — есть код возврата и текст. */\nconst REFUSED: number = 1;\n\n/** Ответ приёма о токене: по нему отказ добавляет строку про отзыв, а не гадает вслух. */\nconst TOKEN_REFUSED: number = 401;\n\n/** Чем отправка живёт: чем отправлять, чем себя выдаёт дерево и за какой отрезок сводка. */\nexport interface IShipOptions {\n    /** Печатать, что уехало бы, и не отправлять ничего. */\n    readonly dryRun: boolean;\n    readonly ship: TShip;\n    /** Адрес удалённого репозитория этого дерева: из него считается признак. */\n    readonly remote: string;\n    /** Имена удалённых репозиториев. Нужны отказу: выбор между несколькими делает человек. */\n    readonly remotes?: readonly string[];\n    /** Сегодняшний день: своих часов у команды нет — иначе сводку за отрезок не проверить спекой. */\n    readonly today: string;\n    readonly days: number;\n}\n\n/**\n * Адрес удалённого репозитория, приведённый к одному виду.\n *\n * Форм у него несколько — `git@host:владелец/имя.git`, `https://host/владелец/имя`, — и все они\n * ведут к одному дереву. Две рабочие копии одного репозитория обязаны дать один признак, а\n * непривёденные формы дали бы два.\n */\nexport function remoteMarkOf(remote: string): string {\n    const named: string = remote\n        .trim()\n        .replace(/\\.git$/, '')\n        .replace(/^[a-z+]+:\\/\\//i, '')\n        .replace(/^[^@/]+@/, '')\n        .replace(/:/g, '/');\n    let end: number = named.length;\n\n    while (end > 0 && named[end - 1] === '/') {\n        end -= 1;\n    }\n\n    return named.slice(0, end).toLowerCase();\n}\n\n/**\n * Признак дерева: короткое значение, различающее деревья и не выдающее их адреса.\n *\n * Считается хешем от адреса репозитория: по нему адрес не восстанавливается, а у двух рабочих\n * копий одного репозитория он один. Репозитория нет — берётся то, что назвала настройка: иначе\n * все такие деревья слились бы в одно, и число деревьев в сводке стало бы неправдой молча.\n */\nexport function treeSlugOf(remote: string, spoken: string): string {\n    const mark: string = remoteMarkOf(remote);\n\n    return mark ? createHash('sha256').update(mark, 'utf8').digest('hex').slice(0, SLUG_LENGTH) : spoken;\n}\n\n/**\n * Счётчики по ресурсам пакета. Имя, которого пакет не знает, — имя правила самого дерева, и\n * наружу оно не едет: дерево называет свои правила по своим доменам и по себе самому.\n *\n * Число событий при этом остаётся полным: считается их столько, сколько было, — отброшены имена,\n * а не наблюдения.\n */\nfunction knownCounts(counts: readonly ICargoCount[], known: ReadonlySet<string>): readonly ICargoCount[] {\n    return counts.filter((count: ICargoCount): boolean => known.has(count.name));\n}\n\n/** Сводка наблюдений вместе со снимком надстроек — то, что уезжает первым запросом. */\nexport function summaryCargo(\n    summary: ISummary,\n    tree: string,\n    overrides: readonly ICargoOverride[],\n    unpicked: readonly string[],\n    known: ReadonlySet<string>\n): ISummaryCargo {\n    return {\n        tree,\n        unpicked,\n        overrides,\n        schema: CARGO_SCHEMA_VERSION,\n        days: summary.days,\n        sessions: summary.sessions,\n        loads: knownCounts(summary.loads, known),\n        denials: knownCounts(summary.denials, known),\n        // Род правки, на котором гейт отбивал, ресурсом не является: это `extension`, `command`\n        // или `browser` — слова пакета, одинаковые у всех деревьев.\n        kinds: summary.kinds,\n        guards: knownCounts(summary.guards, known),\n        unused: summary.unused,\n        versions: summary.versions,\n        total: summary.total,\n    };\n}\n\n/**\n * Разборы происшествий, как они лежат на дереве.\n *\n * Текст едет целиком: разбор объясняет механизм промаха, и шапка без механизма не отвечает ни на\n * один вопрос, ради которого его читают.\n */\nexport function readPostmortems(root: string, dir: string): IPostmortemItem[] {\n    const path: string = join(root, dir);\n\n    if (!existsSync(path)) {\n        return [];\n    }\n\n    return (\n        readdirSync(path)\n            // Описание каталога разбором не является: оно объясняет, что здесь лежит, а не механизм\n            // промаха, — и в приёме встало бы записью, которой нечего сказать.\n            .filter((file: string): boolean => file.endsWith('.md') && file !== 'README.md')\n            .sort(byText)\n            .map((file: string): IPostmortemItem => ({ file, text: readFileSync(join(path, file), 'utf8') }))\n    );\n}\n\n/** Что уезжает и в каком порядке: сводка первой — ею заводится запись месяца. */\nexport function shipmentsOf(summary: ISummaryCargo, proposals: IProposalsCargo, postmortems: IPostmortemsCargo): readonly IShipment[] {\n    return [\n        { kind: 'сводка', operation: 'summary', body: summary },\n        ...(proposals.items.length ? [{ kind: 'предложения', operation: 'proposals', body: proposals }] : []),\n        ...(postmortems.items.length ? [{ kind: 'разборы', operation: 'postmortems', body: postmortems }] : []),\n    ];\n}\n\n/**\n * Что в грузе называет дерево, из которого он уезжает.\n *\n * Проверка накрывает сводку и предложения, но не разбор происшествия: разбор по устройству\n * называет файлы дерева, где промах случился, и накрытая проверка отбивала бы каждую его\n * отправку.\n */\nexport function leaksOfCargo(summary: ISummaryCargo, proposals: readonly IProposal[], marks: readonly string[]): string[] {\n    const inSummary: string[] = leaksIn(JSON.stringify(summary, null, 1), marks).map(\n        (leak: ILeak): string => `  сводка: ${leak.why}\\n      ${leak.text}`\n    );\n    const inProposals: string[] = proposals.flatMap((entry: IProposal): string[] =>\n        leaksIn(entry.body, marks).map(\n            (leak: ILeak): string => `  ${entry.file}:${entry.line + leak.line} — ${leak.why}\\n      ${leak.text}`\n        )\n    );\n\n    return [...inSummary, ...inProposals];\n}\n\n/** Отказ строками. */\nfunction refusal(...lines: readonly string[]): IOutcomeOfCommand {\n    return { code: REFUSED, lines: [...lines] };\n}\n\n/** Что в отправляемом запросе, одной строкой: её читает человек перед тем, как отправить. */\nfunction describe(shipment: IShipment, summary: ISummaryCargo, proposals: IProposalsCargo, postmortems: IPostmortemsCargo): string {\n    if (shipment.operation === 'proposals') {\n        return `предложений ${proposals.items.length}`;\n    }\n    if (shipment.operation === 'postmortems') {\n        return `разборов ${postmortems.items.length}`;\n    }\n\n    return `наблюдений ${summary.total} за ${summary.days} дн., надстроек ${summary.overrides.length}, невыбранного ${summary.unpicked.length}`;\n}\n\n/** Блок, который не уехал, и причина этого. */\ninterface IRefusedProposal {\n    readonly proposal: IProposal;\n    readonly why: string;\n}\n\n/**\n * Отметка об отбое: отбитый блок остаётся на диске и несёт причину.\n *\n * Удалённый блок пишется следующим заходом заново — следа разбора нет, и повтор возвращается.\n * Отметка держит и то и другое: видно, что разбор был, и видно, почему он не стал правкой.\n */\nfunction markRefused(root: string, refused: readonly IRefusedProposal[]): void {\n    for (const one of refused) {\n        const path: string = join(root, one.proposal.file);\n        writeFileSync(path, markSent(readFileSync(path, 'utf8'), one.proposal, one.why, 'отбито'), 'utf8');\n    }\n}\n\n/**\n * Перечень груза: что именно уедет и куда — строками, которые читаются до самой отправки.\n *\n * Печатается он обоими прогонами, и разделены они не окончанием глагола, а первой строкой:\n * «уехало» и «уехало бы» отличаются двумя буквами в хвосте, а строки под ними одинаковы до\n * знака. Прочитанный не тем прогоном, вывод сухого читается сделанной работой — и наоборот,\n * настоящая отправка читается пробой, после которой ничего не делают.\n */\nfunction manifest(\n    going: readonly IShipment[],\n    summary: ISummaryCargo,\n    proposals: IProposalsCargo,\n    postmortems: IPostmortemsCargo\n): readonly string[] {\n    return going.map((shipment: IShipment): string => `  ${shipment.operation} — ${describe(shipment, summary, proposals, postmortems)}`);\n}\n\n/** Пометка об отправке: по ней предложение второй раз не уезжает. */\nfunction markProposals(root: string, proposals: readonly IProposal[], shipped: IShipped): void {\n    const mark: string = `приём:${shipped.accepted?.month ?? 'принято'}`;\n\n    for (const proposal of proposals) {\n        const path: string = join(root, proposal.file);\n        writeFileSync(path, markSent(readFileSync(path, 'utf8'), proposal, mark), 'utf8');\n    }\n}\n\n/**\n * Что приём сказал о принятом: месяц записи, судьба самой записи и — у предложений — счёт\n * легшего и уже лежавшего.\n *\n * Без счёта строка одинакова и у прогона, привёзшего новое, и у прогона, у которого всё уже\n * лежало: человек читает второе как первое. Приём, счёта не приславший, оставляет строку\n * прежней — так же читаются сводка и разборы, у которых счёта нет вовсе.\n */\nfunction accepted(shipped: IShipped): string {\n    if (!shipped.accepted) {\n        return 'принято';\n    }\n\n    const record: string = `${shipped.accepted.month}${shipped.accepted.created ? ', запись заведена' : ', запись дописана'}`;\n    const added: number | undefined = shipped.accepted.added;\n\n    return added === undefined ? record : `${record}, принято ${added}, уже лежало ${shipped.accepted.known ?? 0}`;\n}\n\n/**\n * Отказ, когда признак дерева считать не из чего. Случая два, и говорят они разное: репозитория\n * нет вовсе — считать не из чего; репозиториев несколько и `origin` среди них нет — адрес есть, а\n * выбрать его может только человек. Угаданное неверно сливает в сводке приёма два дерева в одно,\n * и увидеть это нечем.\n */\nfunction noTreeMark(names: readonly string[]): IOutcomeOfCommand {\n    if (names.length > 1) {\n        return refusal(\n            `признак дерева не считается: удалённых репозиториев несколько, а \\`origin\\` среди них нет — ${names.join(', ')}`,\n            `переименуй тот, что называет это дерево, в \\`origin\\` — либо назови признак ключом \\`tree\\` в ${CONFIG_PATH}`\n        );\n    }\n\n    return refusal(\n        'признак дерева не считается: удалённого репозитория нет',\n        `назови его ключом \\`tree\\` в ${CONFIG_PATH} — иначе деревья без репозитория сольются в одно`\n    );\n}\n\n/**\n * Сами запросы. Отправленное помечается сразу, а не после всех: оборвавшаяся отправка иначе\n * увозит половину и не оставляет следа, по которому видно, какую именно.\n */\nasync function send(\n    root: string,\n    intake: string,\n    tree: string,\n    token: string,\n    ship: TShip,\n    going: readonly IShipment[],\n    proposals: readonly IProposal[],\n    listed: readonly string[]\n): Promise<IOutcomeOfCommand> {\n    // Что уедет, названо до того, как уехало: отказ на втором запросе иначе оставляет человека с\n    // одной строкой о нём и без перечня, из которого видно, чего этот отказ стоил.\n    const head: readonly string[] = [`ОТПРАВКА — груз уходит в ${intake}, дерево ${tree}:`, ...listed];\n    const done: string[] = [];\n\n    for (const shipment of going) {\n        const shipped: IShipped = await ship(intake, token, shipment);\n\n        if (!shipped.ok) {\n            return {\n                code: REFUSED,\n                lines: [\n                    ...head,\n                    ...(done.length ? [`уехало до отказа: ${done.length}`, ...done] : ['не уехало ничего']),\n                    `${shipment.kind}: ${intake} ответил ${shipped.status || 'молчанием'} — ${shipped.said}`,\n                    ...(shipped.status === TOKEN_REFUSED\n                        ? ['токен не принят: он отозван или заведён не тот — выдай новый командой приёма']\n                        : []),\n                ],\n            };\n        }\n\n        done.push(`  ${shipment.kind} → ${accepted(shipped)}`);\n\n        if (shipment.operation === 'proposals') {\n            markProposals(root, proposals, shipped);\n        }\n    }\n\n    return { code: 0, lines: [...head, 'уехало:', ...done] };\n}\n\n/**\n * Отправка груза в приём.\n *\n * Порядок отказов не случаен: выключенная запись отвечает нулём и молчит про адрес — она гасит\n * отправку целиком, вместе со снимком надстроек, и спрашивать про адрес у выключенного дерева\n * незачем.\n */\nexport async function propose(env: IEnvironment, options: IShipOptions): Promise<IOutcomeOfCommand> {\n    const { root, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n\n    if (!config) {\n        return refusal(`конфига нет: ${CONFIG_PATH} — заводится \\`agent-kit init\\``);\n    }\n    if (!config.observe) {\n        return {\n            code: 0,\n            lines: [\n                'запись наблюдений выключена ключом `observe` в конфиге — наружу не ушло ничего',\n                'выключатель гасит и отправку целиком, вместе со снимком надстроек',\n            ],\n        };\n    }\n    if (!config.intake) {\n        return refusal(\n            'отправлять некуда: адреса приёма нет',\n            `он объявляется ключом \\`intake\\` в ${CONFIG_PATH}, а само значение берётся у владельца приёма — вместе с кодом приглашения`\n        );\n    }\n\n    const tree: string = treeSlugOf(options.remote, config.tree);\n    if (!tree) {\n        return noTreeMark(options.remotes ?? []);\n    }\n\n    const token: string = readToken(root, config.token);\n    if (!token) {\n        return refusal(\n            'токена дерева нет: груз остался неотправленным',\n            `файл с ним называется ключом \\`token\\` в ${CONFIG_PATH} и лежит вне дерева`,\n            'выдаётся токен командой приёма — `tree:add` или `tree:token`'\n        );\n    }\n\n    const read: IReadResult = readObservations(root, options.today, options.days);\n    const summary: ISummary = summarize(read.observations, laidOutSkills(config, assetsDir), options.days);\n    const cargo: ISummaryCargo = summaryCargo(\n        summary,\n        tree,\n        treeSnapshot(config, assetsDir, root),\n        unpickedOf(config, assetsDir),\n        packagedNames(config, assetsDir)\n    );\n\n    const ready: readonly IProposal[] = readProposals(root).filter(\n        (entry: IProposal): boolean => entry.address === TO_PACKAGE && !entry.sent\n    );\n    // Блок, не назвавший ближайшего утверждения ресурса, не уезжает: разбор, кончившийся ещё\n    // одной статьёй о том, о чём статья уже стоит, снаружи неотличим от разбора, кончившегося\n    // исправлением. Отбивается он поимённо, а остальные едут: один непрочитанный ресурс не\n    // повод задержать чужую работу.\n    const refused: readonly IRefusedProposal[] = ready\n        .map((entry: IProposal): IRefusedProposal => ({ proposal: entry, why: nearestMissing(entry, assetsDir) }))\n        .filter((entry: IRefusedProposal): boolean => Boolean(entry.why));\n    const mine: readonly IProposal[] = ready.filter(\n        (entry: IProposal): boolean => !refused.some((one: IRefusedProposal): boolean => one.proposal === entry)\n    );\n    const proposals: IProposalsCargo = {\n        tree,\n        schema: CARGO_SCHEMA_VERSION,\n        items: mine.map((entry: IProposal): IProposalItem => ({ text: entry.body, address: entry.address, resource: entry.resource })),\n    };\n    const postmortems: IPostmortemsCargo = { tree, schema: CARGO_SCHEMA_VERSION, items: readPostmortems(root, config.postmortems) };\n\n    // Проверка на адрес дерева судит все готовые блоки, а не одни уезжающие: отбитый по цитате\n    // лежит на диске и уедет, как только его починят, — а найденная в нём утечка отбивает\n    // отправку целиком и должна называться сразу.\n    const leaked: readonly string[] = leaksOfCargo(cargo, ready, marksOf(root, options.remote));\n    if (leaked.length) {\n        return refusal(\n            `отправка не начата: в грузе назван адрес этого дерева — ${leaked.length}`,\n            ...leaked,\n            'найденное отбивает отправку целиком: «уехало два из трёх» читается как «всё в порядке»'\n        );\n    }\n\n    const going: readonly IShipment[] = shipmentsOf(cargo, proposals, postmortems);\n\n    const listed: readonly string[] = manifest(going, cargo, proposals, postmortems);\n    // Отбитое называется обоими прогонами: сухой показывает, что уехало бы, — и отбитое к этому\n    // относится наравне с уезжающим.\n    const refusedLines: readonly string[] = refused.map(\n        (one: IRefusedProposal): string => `  отбито ${one.proposal.file}:${one.proposal.line} — ${one.why}`\n    );\n\n    if (options.dryRun) {\n        return {\n            code: 0,\n            lines: [\n                'СУХОЙ ПРОГОН — наружу не ушло ничего, отметок об отправке не поставлено',\n                `уехало бы в ${config.intake}, дерево ${tree}:`,\n                ...listed,\n                ...refusedLines,\n                ...(read.silent ? ['наблюдений не велось ни разу — сводка уезжает снимком надстроек'] : []),\n                'отправляет это тот же вызов без `--dry-run`',\n            ],\n        };\n    }\n\n    // Отметка ставится до отправки: отбитое наружу не едет вовсе, и ждать ответа приёма ей\n    // незачем.\n    markRefused(root, refused);\n\n    const outcome: IOutcomeOfCommand = await send(root, config.intake, tree, token, options.ship, going, mine, [\n        ...listed,\n        ...refusedLines,\n    ]);\n\n    return outcome;\n}\n"]}

package/package.json

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

package/assets/laws/application/access.md

@@ -1,34 +0,0 @@
-# Закон о доступе
-
-Кто что может делать: вход владельца, права на действия, поведение публичных путей.
-Правила держат все процедуры контракта и все разделы админки.
-
-## Терминология
-
-| Термин         | Определение                                                                                 |
-| -------------- | ------------------------------------------------------------------------------------------- |
-| Право          | Пара «ресурс и действие», например `bookings:manage`. Не роль: роль набирается из прав      |
-| Пресет         | Именованный набор прав, который выдаётся пользователю целиком                               |
-| Оверрайд       | Точечная правка права поверх пресета для одного пользователя                                |
-| Публичный путь | Процедура, доступная гостю без входа. Публичность объявляется, а не получается по умолчанию |
-
-## Статьи
-
-- **Каждая процедура объявляет свой доступ, и объявление ровно одно.** Процедура без
-  объявления или с двумя объявлениями не даёт приложению подняться.
-- **Доступов четыре: по праву, любому вошедшему, публично и публично с чтением входа.**
-  Последний отдаёт вошедшему больше, чем гостю, — так админ видит скрытые объекты в общем
-  списке.
-- **Права пользователя — это права пресета, поверх которых применены его оверрайды.**
-- **Запрос без входа туда, где вход нужен, отбивается как неаутентифицированный, а вход
-  без нужного права — как отказ в доступе.** Это разные ответы: первый лечится входом,
-  второй — нет.
-- **Право проверяется до тела процедуры.** Обработчик не решает, пускать ли вызывающего.
-- **Публичность объявляется с причиной.** Причина живёт в коде рядом с объявлением и
-  наружу не уходит.
-- **Админка не показывает разделы, на которые у владельца нет права.**
-- **Адрес раздела закрыт тем же правом, что и пункт меню.** Иначе скрытый пункт закрывает
-  раздел лишь на вид: адрес открывается по прямой ссылке.
-- **Пока права не получены, админка ничего не прячет.** Пустая шапка после сетевого сбоя
-  выглядит как сломанная админка и не оставляет выхода; запрос без права всё равно
-  отобьётся на сервере.

package/assets/laws/application/locales.md

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

package/assets/laws/application/search-visibility.md

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

package/assets/patterns/permissions-procedure.md

@@ -1,71 +0,0 @@
----
-name: permissions-procedure
-kind: pattern
-rule: permissions
-description: Паттерн правила permissions. Брать при заведении процедуры Connect и при закрытии раздела админки — готовые декораторы доступа, отбивка без входа и без права, декларация пункта меню с правом и флагом. Не брать для устройства самого меню — это правило navigation.
----
-
-# Объявление доступа
-
-Паттерн правила `permissions`. Что при этом должно быть верно — закон
-`docs/constitution/application/access.md`.
-
-## Когда брать
-
-- Заводится процедура Connect.
-- Раздел админки закрывается правом.
-- Процедура должна отвечать гостю.
-
-## Декоратор на классе процедуры
-
-Объявление ровно одно; без него приложение не поднимается:
-
-```typescript
-@Injectable()
-@ConnectProcedure()
-@RequiresPermission('chat:manage')
-export class LinkBookingProcedure implements IConnectProcedure<typeof ChatService.method.linkBooking> {
-    public readonly method: typeof ChatService.method.linkBooking = ChatService.method.linkBooking;
-}
-```
-
-| Декоратор                                    | Кому доступно                                     |
-| -------------------------------------------- | ------------------------------------------------- |
-| `@RequiresPermission('<ресурс>:<действие>')` | вошедшему с этим правом                           |
-| `@RequiresAuth('<причина>')`                 | любому вошедшему; так живут профиль и выбор языка |
-| `@PublicProcedure('<причина>')`              | гостю без входа                                   |
-| `@OptionalAuthProcedure('<причина>')`        | гостю, но токен читается, если он есть            |
-
-Аргумент — причина для читателя кода. Ни в ответ, ни в лог она не уходит.
-
-## Отбивка
-
-Перехватчик отвечает до тела процедуры:
-
-- нет входа там, где вход нужен, — `Code.Unauthenticated`;
-- вход есть, права нет — `Code.PermissionDenied`;
-- процедура, о которой перехватчик ничего не знает, — тоже отказ в доступе, а не пропуск.
-
-Обработчик решения о допуске не принимает.
-
-## Раздел админки
-
-Пункт меню и адрес закрываются одной декларацией в
-`libs/admin/common/container/util`: шапка берёт из неё подписи и адреса, гвард — права.
-Второго объявления этой связи не заводится.
-
-Гейтинг двухслойный: право пользователя и флаг раздела. Пункт с флагом объявляется без прав и
-без адреса — право открывает экран, а экрана нет. Появится экран — флаг снимается, права
-добавляются.
-
-## Частые промахи
-
-- Два объявления доступа на одной процедуре: приложение не поднимется, и увидено это будет
-  только при запуске.
-- Проверка права внутри `handle`: право проверяется до тела.
-- Своё объявление прав рядом с маршрутами: оно разойдётся с декларацией меню, и получится
-  «пункта не видно, а страница открывается».
-- Гвард, повешенный на защищённую группу целиком: он отрабатывает один раз за загрузку
-  страницы и переходов между разделами не видит.
-- Ожидание прав, которое роняется на отказе запроса: с неизвестными правами не закрывается
-  ничего, и пустая шапка выхода владельцу не оставляет.

package/assets/patterns/seo-page.md

@@ -1,104 +0,0 @@
----
-name: seo-page
-kind: pattern
-rule: seo
-description: Паттерн правила seo. Брать, когда правится разметка страницы публичного сайта, заводится маршрут или страница должна попасть в карту сайта: готовый вызов службы мета-тегов, ветки локалей, строка карты. Проверка отданной разметки — паттерн seo-verify.
----
-
-# Разметка страницы публичного сайта
-
-Паттерн правила `seo`. Что при этом должно быть верно — закон
-`docs/constitution/application/search-visibility.md`.
-
-## Когда брать
-
-- Правится шаблон страницы сайта, её заголовок, описание или картинка для соцсетей.
-- Заводится новый маршрут сайта.
-- Появилась страница, которая должна попасть в `sitemap.xml`.
-
-## Разметку ставит сервис, а не шаблон
-
-Страница собирает данные и одним вызовом отдаёт их `PropertySeoService`. Своих `<meta>` в
-шаблоне не заводить: они не помечены `data-<префикс>-seo`, не переписываются при переходе и
-переживут смену страницы.
-
-Образец — `property-page.component.ts:#applySeo`:
-
-```typescript
-readonly #seo: PropertySeoService = inject(PropertySeoService);
-
-constructor() {
-    effect((): void => this.#applySeo());
-}
-
-#applySeo(): void {
-    const property: IProperty.State | null = this.property();
-    if (!property) {
-        return;
-    }
-
-    const name: string = this.propertyName();
-    const cover: IPhotoView | null = this.coverDesktop();
-
-    this.#seo.apply({
-        property,
-        name,
-        pageTitle: name ? `${name} — ${this.#titleSuffix()}` : this.#titleSuffix(),
-        description: property.shortDescription || this.#descriptionFallback(),
-        ogImageUrl: cover ? photoOgUrl(cover.baseUrl) : `${SITE_ORIGIN}/${BRAND_OG_IMAGE}`,
-        ogImageAlt: cover ? cover.alt : name,
-        ogImageWidth: OG_IMAGE_WIDTH,
-        ogImageHeight: OG_IMAGE_HEIGHT,
-        locale: this.#localeId,
-    });
-}
-```
-
-Вызов идёт из `effect`, а не из конструктора напрямую: объект приходит сигналом, и на первом
-кадре его ещё нет. Ранний выход по пустому объекту обязателен — без него разметка встала бы на
-пустых значениях и второй раз уже не переписалась бы.
-
-У картинки есть запасной вариант: объект без обложки отдаёт брендовое изображение того же формата,
-иначе превью в соцсети пустует.
-
-## Новый маршрут заводится веткой на каждую локаль
-
-Ветки собирает `apps/site/src/app/app.routes.ts` из `LOCALE_CODES`. Локаль по умолчанию своей
-ветки не имеет — она отдаётся из корня.
-
-```typescript
-export const appRoutes: Route[] = [
-    ...LOCALE_CODES.filter((code: ELocale): boolean => code !== DEFAULT_LOCALE).map((code: ELocale): Route => ({
-        path: code,
-        children: propertyRoutes,
-    })),
-    ...propertyRoutes,
-];
-```
-
-Новый путь дописывается в `propertyRoutes` — тогда он появляется во всех восьми ветках сразу.
-Ветки перечислены явными кодами, а не `:locale`: иначе `/<адрес страницы>` был бы принят за
-язык, а не за адрес объекта.
-
-## Страница попадает в карту сайта явно
-
-Карта строится из объектов, а не из маршрутов, и новая страница сама туда не попадёт. Записи
-собирает `buildSitemap` (слой `util` домена страницы объекта), отдаёт обработчик
-`/sitemap.xml` в `apps/site/src/server.ts`. Правка идёт вместе со спекой в
-`sitemap.util.spec.ts`.
-
-## Тексты идут из словарей
-
-`pageTitle` и `description` собираются из переведённых значений и заводятся во всех восьми
-локалях. Без перевода они уезжают в выдачу по-английски, и заметно это только в чужой локали.
-
-## Частые промахи
-
-- `<meta>` в шаблоне вместо вызова сервиса — тег не помечен `data-<префикс>-seo` и переживёт переход.
-- Вызов без раннего выхода по пустому объекту — разметка встаёт на пустых значениях.
-- Новый путь дописан мимо `propertyRoutes` — работает только в локали по умолчанию,
-  `/de/<путь>` отдаёт 404.
-- Свой разбор адреса вместо `splitRequestUrl` — теряется всё после второго `?`, и источник
-  заявки считается неверно.
-- Правка разметки без проверки на прод-сборке: в дев-сервере теги ставит не тот путь. Проверка
-  описана паттерном `seo-verify`.

package/assets/patterns/seo-verify.md

@@ -1,83 +0,0 @@
----
-name: seo-verify
-kind: pattern
-rule: seo
-description: Паттерн правила seo. Брать после любой правки, задевающей разметку публичного сайта, meta или маршруты — готовые команды сборки, поднятия SSR и проверки отданного HTML по локалям, карты сайта и кэшируемости перенаправления. Не брать для самой правки разметки — это паттерн seo-page.
----
-
-# Проверка разметки на прод-сборке
-
-Паттерн правила `seo`. Что при этом должно быть верно — закон
-`docs/constitution/application/search-visibility.md`.
-
-## Когда брать
-
-После любой правки, задевающей разметку сайта, `meta`, маршруты, `server.ts`, `robots.txt`
-или `deploy/nginx.conf`.
-
-## Дев-сервер здесь не показатель
-
-Теги ставятся при отдаче страницы сервером. В дев-режиме этот путь другой, поэтому проверка
-идёт на собранном приложении с поднятым SSR.
-
-```bash
-npx nx build site
-PORT={{prodSitePort}} node dist/apps/site/server/server.mjs &
-```
-
-Порт {{prodSitePort}} — тот же, что берёт стенд; дев-серверы владельца на {{sitePort}} и {{adminPort}} при этом не
-трогаются. Angular SSR отвечает `400` на чужой `Host`, поэтому запросы идут с
-`-H "Host: localhost"`.
-
-## Что смотреть в отданном HTML
-
-```bash
-for locale in "" <префиксы локалей>; do
-    printf '%-10s ' "${locale:-en}"
-    curl -s -H "Host: localhost" "http://localhost:{{prodSitePort}}/${locale}<адрес страницы>" \
-        | grep -c -E '<title>|name="description"|property="og:|rel="canonical"|hreflang=|application/ld\+json'
-done
-```
-
-В ответе каждой локали должны быть `<title>`, `description`, набор `og:*`, `canonical`,
-полный набор `hreflang` плюс `x-default` и блок `application/ld+json`.
-
-Отдельно проверяется, что `canonical` ведёт на **свой** язык, а не на локаль по умолчанию:
-
-```bash
-curl -s -H "Host: localhost" http://localhost:{{prodSitePort}}/de/<адрес страницы> \
-    | grep -o 'rel="canonical" href="[^"]*"'
-```
-
-## Карта сайта
-
-```bash
-curl -s -H "Host: localhost" http://localhost:{{prodSitePort}}/sitemap.xml | head -20
-```
-
-Карта строится из живых данных, а не из файла. Пустой ответ означает, что не поднялся запрос
-за объектами, — это отказ, а не «объектов нет».
-
-## Кэшируемость перенаправления
-
-Проверяется только на стенде с настоящим `deploy/nginx.conf`: голый SSR отдаёт заголовки, но
-не показывает, попадёт ли ответ в кэш.
-
-```bash
-curl -sI http://<стенд>/<прежний-slug> | grep -i -E 'HTTP/|location|cache-control|x-cache'
-```
-
-Ответ обязан быть `301`, нести `Cache-Control` со сроком и попадать в кэш. Некэшируемое
-перенаправление не вытесняет старую запись, и гость видит прежнюю страницу до суток.
-
-## Тексты
-
-`title` и `description` берутся из словарей во всех локалях перевода. Непереведённый ключ уезжает
-в выдачу по-английски — полноту словарей держит `npx nx test common-i18n`.
-
-## Частые промахи
-
-- Проверка в дев-сервере: разметку там ставит другой путь, и отсутствие тега не видно.
-- Проверка одной локали: расходится обычно та, которую не смотрели.
-- Проверка кэша без nginx: заголовки видны, попадание в кэш — нет.
-- Вывод по коду ответа: `200` приходит и со страницы без разметки.