@rt-tools/agent-kit 0.5.0 → 0.5.2

package/lib/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAU,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAS,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAmB,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAwBrG,MAAM,KAAK,GAAW,eAAe,CAAC;AAEtC,8FAA8F;AAC9F,SAAS,YAAY,CAAC,IAAY;IAC9B,IAAI,CAAC;QACD,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAEjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,QAAgB;IAClD,MAAM,KAAK,GAA4B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,OAAO,CAAC,GAAW,EAAE,SAAiB,EAAE;IAC7C,IAAI,OAA0B,CAAC;IAC/B,IAAI,CAAC;QACD,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5G,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC7E,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IACzC,MAAM,IAAI,GAAqB,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAW,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACjD,MAAM,IAAI,GAAW,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,OAAO,GAAoB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvD,MAAM,IAAI,GAAW,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC5E,MAAM,UAAU,GAAY,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/G,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AASD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAsB,EAAE,SAAqB;IAClE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,UAAU,GAAY,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAW,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAE1G,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC;AAgBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmC,EAAE,SAAqB;IAClF,MAAM,MAAM,GAAmC,IAAI,GAAG,EAAE,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACzB,SAAS;QACb,CAAC;QACD,MAAM,GAAG,GAAW,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAW,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACvG,SAAS;QACb,CAAC;QACD,uFAAuF;QACvF,uCAAuC;QACvC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACxF,SAAS;QACb,CAAC;QACD,sFAAsF;QACtF,2BAA2B;QAC3B,MAAM,UAAU,GAAY,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAW,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC/G,IAAI,UAAU,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAsB,EAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACtG,SAAS;QACb,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACN,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;YACrB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;YACrB,IAAI;YACJ,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;YACtC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;YACtF,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;SACjE,CAAC,CAAC;IACP,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,IAAW,EAAE,OAAmC;IACjF,MAAM,MAAM,GAAW,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,OAAO,GAAuC,CAAC,KAAsB,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC;IAClI,MAAM,KAAK,GAAgC,OAAO,CAAC,IAAI,CACnD,CAAC,KAAsB,EAAW,EAAE,CAChC,KAAK,CAAC,IAAI,KAAK,IAAI;QACnB,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CACrH,CAAC;IAEF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAQD,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,IAAW,EAAE,OAAmC;IACxG,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,EAAE,GAAkB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC","sourcesContent":["/**\n * Что пакет везёт — прочитанное с диска, до всякого выбора проекта.\n *\n * Каталог нужен отдельно от раскладки, потому что выбирать приходится раньше, чем раскладывать:\n * `init` спрашивает, какие законы взять, а `list` показывает и то, от чего проект отказался.\n * И там и там нужен полный набор, а `collectAssets` по устройству отдаёт уже отобранный.\n */\nimport { accessSync, constants, Dirent, readdirSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { KINDS, TKind } from './config.js';\nimport { IAxis, IVariant, matchesVariant, readAxes, variantOf, withoutVariant } from './variants.js';\n\nexport interface IEntryOfCatalog {\n    /** Идентификатор: `laws/application/money.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    /**\n     * Имя без рода, вида и расширения: `delivery`, `application/money`. Им ресурс называют в\n     * строке запуска, и им же он ложится в дерево проекта.\n     */\n    readonly name: string;\n    /** Заголовок первой строки файла; у файла без заголовка — его имя. */\n    readonly title: string;\n    /** Вид ресурса, если он лежит в пакете в нескольких: `git-workflow.github.md`. */\n    readonly variant: IVariant | null;\n    readonly text: string;\n    /**\n     * Запускается ли файл сам по себе. Гард зовут по пути, а не через оболочку, и файл без\n     * права на запуск отвечает отказом доступа — то есть ненулевым кодом, который читается как\n     * «правка отбита». Признак берётся с файла в пакете и переносится на разложенный.\n     */\n    readonly executable: boolean;\n}\n\nconst TITLE: RegExp = /^#\\s+(\\S.*)$/m;\n\n/** Запускается ли файл сам по себе. Спрашиваем систему, а не разбираем биты режима руками. */\nfunction isExecutable(path: string): boolean {\n    try {\n        accessSync(path, constants.X_OK);\n\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/** Заголовок нужен человеку, который выбирает: имена законов ему ни о чём не говорят. */\nexport function titleOf(text: string, fallback: string): string {\n    const found: RegExpMatchArray | null = text.match(TITLE);\n\n    return found ? found[1].trim() : fallback;\n}\n\n/**\n * Файлы рода — вместе с теми, что лежат в подкаталогах.\n *\n * Обход рекурсивный потому, что у законов два слоя: общий закон верен любому приложению этого\n * класса, а закон приложения — только такому, где есть деньги, локали или владеющая сущность.\n * Слой отражён каталогом, и путь внутри рода едет в идентификатор целиком, чтобы разложенное\n * повторяло раскладку пакета.\n */\nfunction filesOf(dir: string, prefix: string = ''): readonly string[] {\n    let entries: readonly Dirent[];\n    try {\n        entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n        return [];\n    }\n\n    const files: string[] = [];\n    for (const entry of [...entries].sort((one: Dirent, two: Dirent): number => one.name.localeCompare(two.name))) {\n        if (entry.isFile()) {\n            files.push(`${prefix}${entry.name}`);\n        } else if (entry.isDirectory()) {\n            files.push(...filesOf(join(dir, entry.name), `${prefix}${entry.name}/`));\n        }\n    }\n\n    return files;\n}\n\n/**\n * Всё, что лежит в ресурсах пакета. Список не выписан руками, а читается из каталога:\n * выписанный разошёлся бы с ним на первом же добавленном законе, и заметить это было бы\n * нечем — ресурс просто не приезжал бы к проекту.\n */\nexport function readCatalog(assetsDir: string): readonly IEntryOfCatalog[] {\n    const axes: readonly IAxis[] = readAxes(assetsDir);\n    const entries: IEntryOfCatalog[] = [];\n\n    for (const kind of KINDS) {\n        for (const file of filesOf(join(assetsDir, kind))) {\n            const path: string = join(assetsDir, kind, file);\n            const text: string = readFileSync(path, 'utf8');\n            const variant: IVariant | null = variantOf(file, axes);\n            const name: string = withoutVariant(file, variant).replace(/\\.[^./]+$/, '');\n            const executable: boolean = isExecutable(path);\n            entries.push({ id: `${kind}/${file}`, kind, name, title: titleOf(text, name), variant, text, executable });\n        }\n    }\n\n    return entries;\n}\n\n/** Чем проект ограничил раскладку: выбором, отказом и видами, которые он назвал. */\nexport interface ISelection {\n    readonly only: readonly string[];\n    readonly skip: readonly string[];\n    readonly variants: Readonly<Record<string, string>>;\n}\n\n/**\n * Взят ли ресурс при этом выборе.\n *\n * `only` ограничивает **только те роды, которые сам называет**. Проект, выбравший девять\n * законов из пятнадцати, шаблоны при этом не терял бы: перечисляя законы, он говорит о\n * законах, а не обо всём, что пакет везёт. Обратное правило читалось бы как «выбрал законы —\n * остался без шаблонов», и заметил бы это только тот, кто пошёл за шаблоном.\n *\n * `skip` вычитает из выбранного. Отказ от одного закона не должен требовать переписать\n * список из пятнадцати, а точечное исключение остаётся точечным.\n *\n * Вид отбирается раньше обоих: ресурс чужого хостинга не «не выбран» — его в этом дереве не\n * существует вовсе, и называть его в `skip` проекту незачем.\n */\nexport function isChosen(entry: IEntryOfCatalog, selection: ISelection): boolean {\n    if (!matchesVariant(entry.variant, selection.variants)) {\n        return false;\n    }\n    if (selection.skip.includes(entry.id)) {\n        return false;\n    }\n    const restricted: boolean = selection.only.some((id: string): boolean => id.startsWith(`${entry.kind}/`));\n\n    return !restricted || selection.only.includes(entry.id);\n}\n\n/** Ресурс, у которого виды есть, но ни один не отвечает тому, что выбрало дерево. */\nexport interface IGapOfVariant {\n    readonly kind: TKind;\n    /** Имя без вида — под ним ресурс лёг бы в дерево. */\n    readonly name: string;\n    readonly axis: string;\n    /** Что выбрало дерево по этой оси. */\n    readonly chosen: string;\n    /** Виды, которые у ресурса есть на самом деле. */\n    readonly available: readonly string[];\n    /** Идентификаторы этих видов: ими же пробел и снимается через `skip`. */\n    readonly ids: readonly string[];\n}\n\n/**\n * Ресурсы, оставшиеся без вида под выбор дерева.\n *\n * Молчаливый пропуск такого ресурса — худший из исходов. Правило поставки едет тремя видами, а\n * команды заведения задачи и сверки очереди — одним: дерево, выбравшее чужой хостинг, получает\n * правило, которое зовёт три команды, и ни одного скрипта под ними. Отказа при этом не бывает —\n * ресурс просто не приезжает, и узнают об этом, когда команда из правила не находится.\n *\n * Отсюда правило: **ресурс с видами, ни один из которых не совпал, — отказ, а не пропуск.**\n * Снимается он двумя способами, и оба явные: завести недостающий вид в пакете либо назвать\n * существующие в `skip` — дерево тем самым говорит, что обходится без этого ресурса.\n */\nexport function variantGaps(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly IGapOfVariant[] {\n    const groups: Map<string, IEntryOfCatalog[]> = new Map();\n    for (const entry of catalog) {\n        if (entry.variant === null) {\n            continue;\n        }\n        const key: string = `${entry.kind}/${entry.name}`;\n        groups.set(key, [...(groups.get(key) ?? []), entry]);\n    }\n\n    const gaps: IGapOfVariant[] = [];\n    for (const entries of groups.values()) {\n        const axis: string = entries[0].variant?.axis ?? '';\n        if (entries.some((entry: IEntryOfCatalog): boolean => matchesVariant(entry.variant, selection.variants))) {\n            continue;\n        }\n        // Отказ от ресурса — законный ответ, и повторять его отказом раскладки незачем: дерево\n        // уже сказало, что обходится без него.\n        if (entries.every((entry: IEntryOfCatalog): boolean => selection.skip.includes(entry.id))) {\n            continue;\n        }\n        // Род, суженный через `only`, отбирает ресурсы поимённо: не названный в нём ресурс не\n        // пропал — его не просили.\n        const restricted: boolean = selection.only.some((id: string): boolean => id.startsWith(`${entries[0].kind}/`));\n        if (restricted && !entries.some((entry: IEntryOfCatalog): boolean => selection.only.includes(entry.id))) {\n            continue;\n        }\n        gaps.push({\n            kind: entries[0].kind,\n            name: entries[0].name,\n            axis,\n            chosen: selection.variants[axis] ?? '',\n            available: entries.map((entry: IEntryOfCatalog): string => entry.variant?.value ?? ''),\n            ids: entries.map((entry: IEntryOfCatalog): string => entry.id),\n        });\n    }\n\n    return gaps;\n}\n\n/**\n * Идентификатор по тому, как ресурс назвали в строке запуска. Принимаются все формы, которыми\n * его называют вслух: `money`, `application/money`, `money.md` и `laws/application/money.md`.\n */\nexport function idOf(spoken: string, kind: TKind, catalog: readonly IEntryOfCatalog[]): string | null {\n    const wanted: string = spoken.trim();\n    const shortOf: (entry: IEntryOfCatalog) => string = (entry: IEntryOfCatalog): string => entry.name.split('/').pop() ?? entry.name;\n    const found: IEntryOfCatalog | undefined = catalog.find(\n        (entry: IEntryOfCatalog): boolean =>\n            entry.kind === kind &&\n            (entry.id === wanted || entry.name === wanted || shortOf(entry) === wanted || entry.id.endsWith(`/${wanted}`))\n    );\n\n    return found ? found.id : null;\n}\n\nexport interface IResolvedSelection {\n    readonly ids: readonly string[];\n    /** Имена, которым в каталоге ничего не отвечает: промах в строке запуска, а не выбор. */\n    readonly unknown: readonly string[];\n}\n\n/** Разбор `--laws access,delivery`: имя без ответа — промах, и молчать о нём нельзя. */\nexport function resolveSelection(spoken: readonly string[], kind: TKind, catalog: readonly IEntryOfCatalog[]): IResolvedSelection {\n    const ids: string[] = [];\n    const unknown: string[] = [];\n\n    for (const name of spoken) {\n        const id: string | null = idOf(name, kind, catalog);\n        if (id === null) {\n            unknown.push(name.trim());\n        } else if (!ids.includes(id)) {\n            ids.push(id);\n        }\n    }\n\n    return { ids, unknown };\n}\n"]}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Что пакет везёт — прочитанное с диска, до всякого выбора проекта.\n *\n * Каталог нужен отдельно от раскладки, потому что выбирать приходится раньше, чем раскладывать:\n * `init` спрашивает, какие законы взять, а `list` показывает и то, от чего проект отказался.\n * И там и там нужен полный набор, а `collectAssets` по устройству отдаёт уже отобранный.\n */\nimport { accessSync, constants, Dirent, readdirSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { KINDS, TKind } from './config.js';\nimport { IAxis, IVariant, matchesVariant, readAxes, variantOf, withoutVariant } from './variants.js';\n\nexport interface IEntryOfCatalog {\n    /** Идентификатор: `laws/application/money.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    /**\n     * Имя без рода, вида и расширения: `delivery`, `application/money`. Им ресурс называют в\n     * строке запуска, и им же он ложится в дерево проекта.\n     */\n    readonly name: string;\n    /** Заголовок первой строки файла; у файла без заголовка — его имя. */\n    readonly title: string;\n    /** Вид ресурса, если он лежит в пакете в нескольких: `git-workflow.github.md`. */\n    readonly variant: IVariant | null;\n    readonly text: string;\n    /**\n     * Запускается ли файл сам по себе. Гард зовут по пути, а не через оболочку, и файл без\n     * права на запуск отвечает отказом доступа — то есть ненулевым кодом, который читается как\n     * «правка отбита». Признак берётся с файла в пакете и переносится на разложенный.\n     */\n    readonly executable: boolean;\n    /**\n     * Ресурсы, без которых этот неисполним, — их идентификаторы.\n     *\n     * Читается из шапки самого ресурса, а не из отдельного списка при пакете: список разошёлся\n     * бы с ресурсами молча, ровно тем же молчанием, ради которого требование и заведено. Паттерн\n     * возвращения к работе начинается словами «хук запуска сессии отдал замысел и ход работы» —\n     * без хука он неисполним, и до этой строки узнать об этом было нечем.\n     */\n    readonly requires: readonly string[];\n}\n\nconst TITLE: RegExp = /^#\\s+(\\S.*)$/m;\n\n/**\n * Строка требования в шапке ресурса. Двух видов, потому что ресурсы двух родов: у разметки\n * `**Требует:**`, у исполняемого файла — комментарий `# Требует:`.\n */\nconst REQUIRES: RegExp = /^(?:#\\s*Требует:|\\*\\*Требует:\\*\\*)\\s*(.+)$/m;\n\n/**\n * Что ресурс о себе объявил. Имена читаются идентификаторами — `hooks/observe.sh`: короткая\n * форма совпала бы у закона и правила с одним именем, а требование, указавшее не туда, хуже\n * ненайденного.\n */\nexport function requiresOf(text: string): readonly string[] {\n    const found: RegExpMatchArray | null = text.match(REQUIRES);\n    if (!found) {\n        return [];\n    }\n\n    return found[1]\n        .split(',')\n        .map((name: string): string => name.trim().replace(/^`|`$/g, '').trim())\n        .filter((name: string): boolean => name.length > 0);\n}\n\n/** Запускается ли файл сам по себе. Спрашиваем систему, а не разбираем биты режима руками. */\nfunction isExecutable(path: string): boolean {\n    try {\n        accessSync(path, constants.X_OK);\n\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/** Заголовок нужен человеку, который выбирает: имена законов ему ни о чём не говорят. */\nexport function titleOf(text: string, fallback: string): string {\n    const found: RegExpMatchArray | null = text.match(TITLE);\n\n    return found ? found[1].trim() : fallback;\n}\n\n/**\n * Файлы рода — вместе с теми, что лежат в подкаталогах.\n *\n * Обход рекурсивный потому, что у законов два слоя: общий закон верен любому приложению этого\n * класса, а закон приложения — только такому, где есть деньги, локали или владеющая сущность.\n * Слой отражён каталогом, и путь внутри рода едет в идентификатор целиком, чтобы разложенное\n * повторяло раскладку пакета.\n */\nfunction filesOf(dir: string, prefix: string = ''): readonly string[] {\n    let entries: readonly Dirent[];\n    try {\n        entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n        return [];\n    }\n\n    const files: string[] = [];\n    for (const entry of [...entries].sort((one: Dirent, two: Dirent): number => one.name.localeCompare(two.name))) {\n        if (entry.isFile()) {\n            files.push(`${prefix}${entry.name}`);\n        } else if (entry.isDirectory()) {\n            files.push(...filesOf(join(dir, entry.name), `${prefix}${entry.name}/`));\n        }\n    }\n\n    return files;\n}\n\n/**\n * Всё, что лежит в ресурсах пакета. Список не выписан руками, а читается из каталога:\n * выписанный разошёлся бы с ним на первом же добавленном законе, и заметить это было бы\n * нечем — ресурс просто не приезжал бы к проекту.\n */\nexport function readCatalog(assetsDir: string): readonly IEntryOfCatalog[] {\n    const axes: readonly IAxis[] = readAxes(assetsDir);\n    const entries: IEntryOfCatalog[] = [];\n\n    for (const kind of KINDS) {\n        for (const file of filesOf(join(assetsDir, kind))) {\n            const path: string = join(assetsDir, kind, file);\n            const text: string = readFileSync(path, 'utf8');\n            const variant: IVariant | null = variantOf(file, axes);\n            const name: string = withoutVariant(file, variant).replace(/\\.[^./]+$/, '');\n            const executable: boolean = isExecutable(path);\n            entries.push({\n                id: `${kind}/${file}`,\n                kind,\n                name,\n                title: titleOf(text, name),\n                variant,\n                text,\n                executable,\n                requires: requiresOf(text),\n            });\n        }\n    }\n\n    return entries;\n}\n\n/** Чем проект ограничил раскладку: выбором, отказом и видами, которые он назвал. */\nexport interface ISelection {\n    readonly only: readonly string[];\n    readonly skip: readonly string[];\n    readonly variants: Readonly<Record<string, string>>;\n}\n\n/**\n * Взят ли ресурс при этом выборе.\n *\n * `only` ограничивает **только те роды, которые сам называет**. Проект, выбравший девять\n * законов из пятнадцати, шаблоны при этом не терял бы: перечисляя законы, он говорит о\n * законах, а не обо всём, что пакет везёт. Обратное правило читалось бы как «выбрал законы —\n * остался без шаблонов», и заметил бы это только тот, кто пошёл за шаблоном.\n *\n * `skip` вычитает из выбранного. Отказ от одного закона не должен требовать переписать\n * список из пятнадцати, а точечное исключение остаётся точечным.\n *\n * Вид отбирается раньше обоих: ресурс чужого хостинга не «не выбран» — его в этом дереве не\n * существует вовсе, и называть его в `skip` проекту незачем.\n */\nexport function isChosen(entry: IEntryOfCatalog, selection: ISelection): boolean {\n    if (!matchesVariant(entry.variant, selection.variants)) {\n        return false;\n    }\n    if (selection.skip.includes(entry.id)) {\n        return false;\n    }\n    const restricted: boolean = selection.only.some((id: string): boolean => id.startsWith(`${entry.kind}/`));\n\n    return !restricted || selection.only.includes(entry.id);\n}\n\n/** Ресурс, у которого виды есть, но ни один не отвечает тому, что выбрало дерево. */\nexport interface IGapOfVariant {\n    readonly kind: TKind;\n    /** Имя без вида — под ним ресурс лёг бы в дерево. */\n    readonly name: string;\n    readonly axis: string;\n    /** Что выбрало дерево по этой оси. */\n    readonly chosen: string;\n    /** Виды, которые у ресурса есть на самом деле. */\n    readonly available: readonly string[];\n    /** Идентификаторы этих видов: ими же пробел и снимается через `skip`. */\n    readonly ids: readonly string[];\n}\n\n/**\n * Ресурсы, оставшиеся без вида под выбор дерева.\n *\n * Молчаливый пропуск такого ресурса — худший из исходов. Правило поставки едет тремя видами, а\n * команды заведения задачи и сверки очереди — одним: дерево, выбравшее чужой хостинг, получает\n * правило, которое зовёт три команды, и ни одного скрипта под ними. Отказа при этом не бывает —\n * ресурс просто не приезжает, и узнают об этом, когда команда из правила не находится.\n *\n * Отсюда правило: **ресурс с видами, ни один из которых не совпал, — отказ, а не пропуск.**\n * Снимается он двумя способами, и оба явные: завести недостающий вид в пакете либо назвать\n * существующие в `skip` — дерево тем самым говорит, что обходится без этого ресурса.\n */\nexport function variantGaps(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly IGapOfVariant[] {\n    const groups: Map<string, IEntryOfCatalog[]> = new Map();\n    for (const entry of catalog) {\n        if (entry.variant === null) {\n            continue;\n        }\n        const key: string = `${entry.kind}/${entry.name}`;\n        groups.set(key, [...(groups.get(key) ?? []), entry]);\n    }\n\n    const gaps: IGapOfVariant[] = [];\n    for (const entries of groups.values()) {\n        const axis: string = entries[0].variant?.axis ?? '';\n        if (entries.some((entry: IEntryOfCatalog): boolean => matchesVariant(entry.variant, selection.variants))) {\n            continue;\n        }\n        // Отказ от ресурса — законный ответ, и повторять его отказом раскладки незачем: дерево\n        // уже сказало, что обходится без него.\n        if (entries.every((entry: IEntryOfCatalog): boolean => selection.skip.includes(entry.id))) {\n            continue;\n        }\n        // Род, суженный через `only`, отбирает ресурсы поимённо: не названный в нём ресурс не\n        // пропал — его не просили.\n        const restricted: boolean = selection.only.some((id: string): boolean => id.startsWith(`${entries[0].kind}/`));\n        if (restricted && !entries.some((entry: IEntryOfCatalog): boolean => selection.only.includes(entry.id))) {\n            continue;\n        }\n        gaps.push({\n            kind: entries[0].kind,\n            name: entries[0].name,\n            axis,\n            chosen: selection.variants[axis] ?? '',\n            available: entries.map((entry: IEntryOfCatalog): string => entry.variant?.value ?? ''),\n            ids: entries.map((entry: IEntryOfCatalog): string => entry.id),\n        });\n    }\n\n    return gaps;\n}\n\n/** Выбранный ресурс, чьё требование в дерево не поехало. */\nexport interface IBrokenLink {\n    /** Кто требует — идентификатор выбранного ресурса. */\n    readonly id: string;\n    /** Чего не хватает — идентификатор требования. */\n    readonly requires: string;\n    /** Требования нет в пакете вовсе: промах в шапке ресурса, а не выбор дерева. */\n    readonly unknown: boolean;\n}\n\n/**\n * Связи, разорванные выбором дерева.\n *\n * Не отказ, а предупреждение — и это главное свойство. Дерево вправе закрыть требование своим\n * средством: паттерн исполним и с чужим хуком, если тот делает то же самое. Отказ здесь отбивал\n * бы законную раскладку, а молчание оставляет дерево исправным на вид — сверка зелена на любом\n * подмножестве, сколько бы связок ни было разорвано.\n */\nexport function brokenLinks(catalog: readonly IEntryOfCatalog[], selection: ISelection): readonly IBrokenLink[] {\n    const known: ReadonlySet<string> = new Set(catalog.map((entry: IEntryOfCatalog): string => entry.id));\n    const chosen: ReadonlySet<string> = new Set(\n        catalog.filter((entry: IEntryOfCatalog): boolean => isChosen(entry, selection)).map((entry: IEntryOfCatalog): string => entry.id)\n    );\n\n    const broken: IBrokenLink[] = [];\n    for (const entry of catalog) {\n        if (!chosen.has(entry.id)) {\n            continue;\n        }\n        for (const required of entry.requires) {\n            if (chosen.has(required)) {\n                continue;\n            }\n            broken.push({ id: entry.id, requires: required, unknown: !known.has(required) });\n        }\n    }\n\n    return broken;\n}\n\n/**\n * Идентификатор по тому, как ресурс назвали в строке запуска. Принимаются все формы, которыми\n * его называют вслух: `money`, `application/money`, `money.md` и `laws/application/money.md`.\n */\nexport function idOf(spoken: string, kind: TKind, catalog: readonly IEntryOfCatalog[]): string | null {\n    const wanted: string = spoken.trim();\n    const shortOf: (entry: IEntryOfCatalog) => string = (entry: IEntryOfCatalog): string => entry.name.split('/').pop() ?? entry.name;\n    const found: IEntryOfCatalog | undefined = catalog.find(\n        (entry: IEntryOfCatalog): boolean =>\n            entry.kind === kind &&\n            (entry.id === wanted || entry.name === wanted || shortOf(entry) === wanted || entry.id.endsWith(`/${wanted}`))\n    );\n\n    return found ? found.id : null;\n}\n\nexport interface IResolvedSelection {\n    readonly ids: readonly string[];\n    /** Имена, которым в каталоге ничего не отвечает: промах в строке запуска, а не выбор. */\n    readonly unknown: readonly string[];\n}\n\n/** Разбор `--laws access,delivery`: имя без ответа — промах, и молчать о нём нельзя. */\nexport function resolveSelection(spoken: readonly string[], kind: TKind, catalog: readonly IEntryOfCatalog[]): IResolvedSelection {\n    const ids: string[] = [];\n    const unknown: string[] = [];\n\n    for (const name of spoken) {\n        const id: string | null = idOf(name, kind, catalog);\n        if (id === null) {\n            unknown.push(name.trim());\n        } else if (!ids.includes(id)) {\n            ids.push(id);\n        }\n    }\n\n    return { ids, unknown };\n}\n"]}

package/lib/commands.d.ts

@@ -1,4 +1,5 @@
 import { IStaleBuild } from './freshness.js';
+import { TSubmit } from './submit.js';
 export interface IOutcomeOfCommand {
     readonly code: number;
     readonly lines: readonly string[];
@@ -14,6 +15,11 @@ export interface IEnvironment {
      * тем каталогом ресурсов, который им дали, и о существовании исходников не знают.
      */
     readonly stale?: IStaleBuild | null;
+    /**
+     * `владелец/репозиторий` пакета — куда уезжают предложения. Читается из его манифеста на
+     * краю: зашитый в код адрес назвал бы чужое дерево в текстах пакета.
+     */
+    readonly repository?: string;
 }
 /** Куда уезжает прежнее содержимое файла, отданного пакету. */
 export declare const KEPT_SUFFIX: string;
@@ -36,6 +42,41 @@ export declare function sync(env: IEnvironment, check: boolean): IOutcomeOfComma
  * пакет кладёт своё, а прежнее остаётся на диске под именем с пометкой и ждёт разбора.
  */
 export declare function adopt(env: IEnvironment, names: readonly string[]): IOutcomeOfCommand;
+/** Чем сводка отвечает: отрезок в днях, сегодняшний день и вид вывода. */
+export interface IStatsOptions {
+    readonly days: number;
+    /** Сегодняшний день, `ГГГГ-ММ-ДД`. Приходит с края: команду со своими часами не проверить. */
+    readonly today: string;
+    readonly json: boolean;
+}
+/**
+ * Сводка наблюдений за отрезок дней.
+ *
+ * Отдельная строка про незагруженное — то, ради чего сводка вообще нужна: чем пользуются, видно
+ * и по работе, а вот правило, которое не открыли ни разу, ничем себя не выдаёт. Сокращать текст
+ * правил так же ценно, как дополнять.
+ */
+export declare function stats(env: IEnvironment, options: IStatsOptions): IOutcomeOfCommand;
+/** Чем отправка живёт: чем заводить запись, куда и чем себя выдаёт это дерево. */
+export interface IProposeOptions {
+    /** Печатать, что уехало бы, и ничего не отправлять. */
+    readonly dryRun: boolean;
+    readonly submit: TSubmit;
+    /** `владелец/репозиторий` пакета — из его манифеста, а не из кода. */
+    readonly repository: string;
+    /** Адрес удалённого репозитория этого дерева: он тоже называет дерево. */
+    readonly remote: string;
+    /** Сводка наблюдений, которая едет вместе с предложением: без цифр это мнение. */
+    readonly summary: readonly string[];
+}
+/**
+ * Отправка предложений, адресованных пакету.
+ *
+ * Наружу уезжает только адрес «пакет»: «компаньон» и «дерево» — про имена и надстройки этого
+ * дерева, и в репозитории пакета им делать нечего. Перед отправкой текст сверяется на адрес
+ * дерева: файл уезжает в чужой репозиторий целиком, и проверка здесь дешевле, чем разбор потом.
+ */
+export declare function propose(env: IEnvironment, options: IProposeOptions): IOutcomeOfCommand;
 export declare function doctor(env: IEnvironment): IOutcomeOfCommand;
 /**
  * Что пакет везёт и что из этого взято здесь.

package/lib/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACvC;AAoDD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AAyFpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AAgBD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA2EzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2C3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAkDzD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK7C,OAAO,EAAkB,OAAO,EAAE,MAAM,aAAa,CAAC;AAKtD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC;AAqDD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AAsLpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AAgBD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA8EzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAQD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAeD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA2FlF;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAuBD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,iBAAiB,CAkGtF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAsD3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAkDzD"}

package/lib/commands.js

@@ -3,14 +3,17 @@
  * а `process.exit` зовёт только точка входа — иначе ни одну из них нельзя было бы проверить
  * спекой, не перехватывая поток вывода.
  */
-import { existsSync, mkdirSync, renameSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { collectAssets } from './assets.js';
 import { isChosen, readCatalog } from './catalog.js';
 import { isUnfilled } from './companion.js';
-import { CONFIG_PATH, DEFAULT_LAYOUT, KINDS, OVERRIDES_DIR, readConfig } from './config.js';
+import { CONFIG_PATH, DEFAULT_LAYOUT, KINDS, OVERRIDES_DIR, PROFILE_FILE, readConfig, RT_KIT_DIR, SKILL_KINDS, } from './config.js';
 import { hooksSection, SETTINGS_PATH } from './hooks-map.js';
+import { DEFAULT_DAYS, KEEP_DAYS, OBSERVATIONS_DIR, readObservations, summarize } from './observations.js';
 import { isRefusal } from './plan.js';
+import { leaksIn, markSent, marksOf, PROPOSALS_DIR, readProposals, TO_PACKAGE } from './proposals.js';
+import { FEEDBACK_LABEL } from './submit.js';
 import { pendingOf, planSync, runSync } from './sync.js';
 import { placeholdersOf } from './vars.js';
 import { readAxes, unansweredAxes } from './variants.js';
@@ -50,6 +53,7 @@ const KIND_TITLE = {
     commands: 'КОМАНДЫ',
     workflows: 'ВОРКФЛОУ',
     templates: 'ШАБЛОНЫ',
+    docs: 'ДОКУМЕНТЫ',
 };
 /** Состояние компаньона словами. У заполненного слова нет: о нём говорить нечего. */
 const COMPANION_WORD = {
@@ -60,6 +64,73 @@ const COMPANION_WORD = {
 const NO_CONFIG = `нет \`${CONFIG_PATH}\` — начни с \`agent-kit init\``;
 /** Куда уезжает прежнее содержимое файла, отданного пакету. */
 export const KEPT_SUFFIX = '.before-rt-kit';
+/**
+ * Имя функции профиля, которую хук ждёт. Обе формы: голая проверка наличия и спрос через
+ * помощника, который о нехватке говорит вслух. Считать одну значило бы недосчитаться ровно тех
+ * хуков, которые перешли на второе.
+ */
+const PROFILE_CALL = /(?:command -v|rt_needs)[ \t]+(rt_[a-z_]+)/g;
+/** Сам помощник функцией профиля не является: его везёт пакет, а не дерево. */
+const PROFILE_HELPER = 'rt_needs';
+/**
+ * Объявление функции: `rt_is_app_code() {`. Не с начала строки — хук объявляет запасной вариант
+ * прямо в условии, и не считать его объявлением значило бы звать недостающим то, что у хука
+ * есть.
+ */
+const PROFILE_DEFINE = /(rt_[a-z_]+)\s*\(\)\s*\{/g;
+/**
+ * Функции профиля, которых ждут взятые хуки, и те из них, что дерево не определило.
+ *
+ * Отдельной строкой в разборе состояния потому, что на месте вызова нехватка не видна вовсе:
+ * хук выходит с нулём, стоит в настройке, виден в списке — и читается как работающий. Тишина
+ * при этом означает разом «нечего проверять», «проверять нечем» и «всё в порядке».
+ */
+function profileLines(root, assetsDir, config) {
+    const wanted = new Set();
+    const defined = new Set();
+    for (const asset of collectAssets(config, assetsDir)) {
+        if (asset.kind !== 'hooks') {
+            continue;
+        }
+        for (const found of asset.text.matchAll(PROFILE_CALL)) {
+            if (found[1] !== PROFILE_HELPER) {
+                wanted.add(found[1]);
+            }
+        }
+        // Часть общих функций живёт не в профиле, а в соседнем хуке: запись наблюдения объявлена
+        // в хуке наблюдений, и гарды зовут её через ту же проверку наличия. Не считать их
+        // определёнными значило бы требовать от дерева переписать в профиль чужой код.
+        for (const found of asset.text.matchAll(PROFILE_DEFINE)) {
+            defined.add(found[1]);
+        }
+    }
+    if (!wanted.size) {
+        return [];
+    }
+    // Профиль собирается из тех же файлов, что читает сам хук: сперва разложенное умолчание
+    // пакета, поверх — надстройка дерева. Судить по одной надстройке значило бы объявить мёртвым
+    // каждый гард дерева, которое умолчаний не переписывало.
+    const defaults = config.layout.defaults ?? DEFAULT_LAYOUT.defaults;
+    const sources = [join(root, defaults, PROFILE_FILE), join(root, RT_KIT_DIR, PROFILE_FILE)];
+    for (const path of sources) {
+        if (!existsSync(path)) {
+            continue;
+        }
+        for (const found of readFileSync(path, 'utf8').matchAll(PROFILE_DEFINE)) {
+            defined.add(found[1]);
+        }
+    }
+    const absent = [...wanted].filter((name) => !defined.has(name)).sort();
+    return [
+        `функции профиля, которых ждут взятые хуки: ${wanted.size}`,
+        ...(absent.length
+            ? [
+                ...absent.map((name) => `  нет функции ${name} — её определяют в ${join(RT_KIT_DIR, PROFILE_FILE)}`),
+                '  хук без своей функции проверку не делает и действие пропускает',
+            ]
+            : ['  все определены']),
+    ];
+}
 const holes = (result) => [...result.missing].map(([asset, names]) => `  ${asset}: нет значений для ${names.map((name) => `{{${name}}}`).join(', ')}`);
 const unfilled = (result) => result.companions.filter(isUnfilled);
 /** Ось без ответа: чем её спрашивают и из чего выбирают. */
@@ -104,10 +175,25 @@ const unboundLines = (result) => result.unbound.length
             .map((line) => `  ${line}`),
     ]
     : [];
+/**
+ * Разорванные связи между ресурсами.
+ *
+ * Печатается предупреждением и кода возврата не меняет: дерево вправе закрыть требование своим
+ * средством. Но и молчать нельзя — дерево, выбравшее паттерн без хука, которым тот живёт,
+ * выглядит исправным, а расходится с пакетом на целую волну работ.
+ */
+const brokenLines = (result) => result.broken.length
+    ? [
+        `требования ресурсов, оставшиеся без ответа: ${result.broken.length}`,
+        ...result.broken.map((link) => `  ${link.id} — требует ${link.requires}: ${link.unknown ? 'нет в пакете' : NOT_CHOSEN}`),
+        '  это предупреждение, а не отказ: требование закрывается своим средством дерева либо выбором ресурса',
+    ]
+    : [];
 const describe = (result) => [
     ...holes(result),
     ...gapLines(result),
     ...unboundLines(result),
+    ...brokenLines(result),
     ...pendingOf(result).map((entry) => `  ${entry.path} — ${STATE_WORD[entry.outcome]}`),
     ...unfilled(result).map((entry) => `  ${entry.path} — ${COMPANION_WORD[entry.state]}`),
     ...abandonedLines(result),
@@ -199,9 +285,12 @@ export function sync(env, check) {
         const empty = unfilled(result);
         // Гард, которого не зовёт настройка агента, — такое же расхождение, как отставший файл:
         // он разложен, он коммитится, и по дереву его не отличить от работающего.
+        // Разорванная связь в счёт расхождений не идёт: дерево вправе закрыть требование своим
+        // средством, и отказ отбивал бы законную раскладку. Но и сходство её не отменяет —
+        // предупреждение печатается и там, где расходиться больше нечему.
         const count = result.missing.size + result.gaps.length + pending.length + empty.length + result.unbound.length;
         if (!count) {
-            return { code: 0, lines: [`sync --check: разложенное сходится с пакетом v${version}`] };
+            return { code: 0, lines: [`sync --check: разложенное сходится с пакетом v${version}`, ...brokenLines(result)] };
         }
         return { code: 1, lines: [`sync --check: расхождений ${count}`, ...describe(result)] };
     }
@@ -297,6 +386,222 @@ export function adopt(env, names) {
         ],
     };
 }
+/**
+ * Сколько незагруженных правил называется поимённо. На коротком отрезке их бывает больше
+ * тридцати, и список во весь экран прячет всё остальное, ради чего сводку и открыли.
+ */
+const UNUSED_SHOWN = 12;
+/** Столбиком: имя и счёт. Ширина по самому длинному имени — иначе счёт читается по одному. */
+const countLines = (counted) => {
+    const width = counted.reduce((found, entry) => Math.max(found, entry.name.length), 0);
+    return counted.map((entry) => `  ${entry.name.padEnd(width)}  ${entry.count}`);
+};
+/** Имена скилов, разложенных в это дерево: правила, паттерны и скилы без закона. */
+const skillsOf = (config, assetsDir) => collectAssets(config, assetsDir)
+    .filter((asset) => SKILL_KINDS.includes(asset.kind))
+    .map((asset) => asset.name);
+/**
+ * Сводка наблюдений за отрезок дней.
+ *
+ * Отдельная строка про незагруженное — то, ради чего сводка вообще нужна: чем пользуются, видно
+ * и по работе, а вот правило, которое не открыли ни разу, ничем себя не выдаёт. Сокращать текст
+ * правил так же ценно, как дополнять.
+ */
+export function stats(env, options) {
+    const { root, version, assetsDir } = env;
+    const config = readConfig(root);
+    if (!config) {
+        return { code: 1, lines: [NO_CONFIG] };
+    }
+    // Выключенная запись — не пустая сводка: нули на месте наблюдений читаются как «ничего не
+    // делали», тогда как на самом деле никто и не смотрел.
+    if (!config.observe) {
+        return {
+            code: 0,
+            lines: [
+                'запись наблюдений выключена ключом `observe` в конфиге',
+                `включить — убрать ключ или поставить \`"observe": true\`; пишутся они в ${OBSERVATIONS_DIR}/`,
+            ],
+        };
+    }
+    const days = options.days > 0 ? options.days : DEFAULT_DAYS;
+    const result = readObservations(root, options.today, days);
+    const summary = summarize(result.observations, skillsOf(config, assetsDir), days);
+    if (options.json) {
+        return { code: 0, lines: [JSON.stringify({ ...summary, swept: result.swept })] };
+    }
+    if (result.silent) {
+        return {
+            code: 0,
+            lines: [
+                'наблюдений нет: записи не велось ни разу',
+                `их пишут гарды в ${OBSERVATIONS_DIR}/ — проверь, что гарды разложены и подключены в ${SETTINGS_PATH}`,
+            ],
+        };
+    }
+    if (!summary.total) {
+        return {
+            code: 0,
+            lines: [
+                `наблюдений за ${days} дн. нет ни одного, а записи велись раньше`,
+                ...(result.swept.length ? [`снято по сроку хранения (${KEEP_DAYS} дн.): ${result.swept.length}`] : []),
+                'возьми отрезок длиннее: `--days 14`',
+            ],
+        };
+    }
+    return {
+        code: 0,
+        lines: [
+            `наблюдения за ${days} дн., заходов ${summary.sessions}, событий ${summary.total}`,
+            ...(summary.versions.length ? [`версии пакета в записях: ${summary.versions.join(', ')}`] : []),
+            '',
+            `правил загружено: ${summary.loads.reduce((found, entry) => found + entry.count, 0)}`,
+            ...countLines(summary.loads),
+            ...(summary.unused.length
+                ? [
+                    '',
+                    `разложено и не загружено ни разу: ${summary.unused.length} из ${skillsOf(config, assetsDir).length}`,
+                    ...summary.unused.slice(0, UNUSED_SHOWN).map((name) => `  ${name}`),
+                    // Список говорится не весь, и об этом говорится вслух: молчаливый обрыв
+                    // читается как «вот они все», и правило, не попавшее в первую дюжину,
+                    // считалось бы работающим.
+                    ...(summary.unused.length > UNUSED_SHOWN
+                        ? [`  … и ещё ${summary.unused.length - UNUSED_SHOWN} — целиком в \`--json\``]
+                        : []),
+                ]
+                : []),
+            ...(summary.denials.length
+                ? [
+                    '',
+                    `гейт отбивал: ${summary.denials.reduce((found, entry) => found + entry.count, 0)}`,
+                    ...countLines(summary.denials),
+                    ...(summary.kinds.length
+                        ? ['  чаще всего на:', ...countLines(summary.kinds).map((line) => `  ${line}`)]
+                        : []),
+                ]
+                : []),
+            ...(summary.guards.length
+                ? [
+                    '',
+                    `гарды отказывали: ${summary.guards.reduce((found, entry) => found + entry.count, 0)}`,
+                    ...countLines(summary.guards),
+                ]
+                : []),
+            ...(result.swept.length ? ['', `снято по сроку хранения (${KEEP_DAYS} дн.): ${result.swept.length}`] : []),
+            '',
+            `пакет v${version}`,
+        ],
+    };
+}
+/** Тело записи: место, повод, готовый текст — и сводка под ними. */
+const issueBody = (proposal, summary, version) => [
+    `Ресурс: \`${proposal.resource}\``,
+    `Пакет: v${version}`,
+    '',
+    proposal.body,
+    '',
+    '## Наблюдения дерева, из которого пришло предложение',
+    '',
+    '```',
+    ...summary,
+    '```',
+    '',
+    'Заведено `agent-kit propose`. Дерево, из которого оно пришло, здесь не называется намеренно.',
+].join('\n');
+/**
+ * Отправка предложений, адресованных пакету.
+ *
+ * Наружу уезжает только адрес «пакет»: «компаньон» и «дерево» — про имена и надстройки этого
+ * дерева, и в репозитории пакета им делать нечего. Перед отправкой текст сверяется на адрес
+ * дерева: файл уезжает в чужой репозиторий целиком, и проверка здесь дешевле, чем разбор потом.
+ */
+export function propose(env, options) {
+    const { root, version } = env;
+    const config = readConfig(root);
+    if (!config) {
+        return { code: 1, lines: [NO_CONFIG] };
+    }
+    if (!options.repository) {
+        return { code: 1, lines: ['куда отправлять — неизвестно: в манифесте пакета нет адреса репозитория'] };
+    }
+    const all = readProposals(root);
+    const mine = all.filter((entry) => entry.address === TO_PACKAGE && !entry.sent);
+    if (!mine.length) {
+        const others = all.filter((entry) => entry.address !== TO_PACKAGE).length;
+        const sent = all.filter((entry) => Boolean(entry.sent)).length;
+        return {
+            code: 0,
+            lines: [
+                'отправлять нечего: предложений с адресом «пакет» и без пометки об отправке нет',
+                ...(others ? [`с другими адресами: ${others} — они правятся здесь же, надстройкой и компаньоном`] : []),
+                ...(sent ? [`уже отправлено: ${sent}`] : []),
+                ...(all.length ? [] : [`предложения кладутся в ${PROPOSALS_DIR}/ — форма в шаблоне \`proposal.md\``]),
+            ],
+        };
+    }
+    // Утечка отбивает отправку целиком, а не свой блок: файл разбирает человек, и «уехало два из
+    // трёх» он прочтёт как «всё в порядке».
+    const marks = marksOf(root, options.remote);
+    const leaked = mine.flatMap((proposal) => leaksIn(proposal.body, marks).map((leak) => ({ proposal, leak })));
+    if (leaked.length) {
+        return {
+            code: 1,
+            lines: [
+                `отправка не начата: в тексте предложений назван адрес этого дерева — ${leaked.length}`,
+                ...leaked.map(({ proposal, leak }) => `  ${proposal.file}:${proposal.line + leak.line} — ${leak.why}\n      ${leak.text}`),
+                'предложение уезжает в чужой репозиторий целиком: правь текст, а не обходи проверку',
+            ],
+        };
+    }
+    if (options.dryRun) {
+        return {
+            code: 0,
+            lines: [
+                `уехало бы записей: ${mine.length} → ${options.repository}, метка ${FEEDBACK_LABEL}`,
+                ...mine.map((entry) => `  ${entry.resource} (${entry.file}:${entry.line})`),
+                'сводка наблюдений едет вместе с ними',
+            ],
+        };
+    }
+    const done = [];
+    for (const proposal of mine) {
+        let url = '';
+        try {
+            url = options.submit({
+                repository: options.repository,
+                title: `предложение: ${proposal.resource}`,
+                body: issueBody(proposal, options.summary, version),
+                label: FEEDBACK_LABEL,
+            });
+        }
+        catch (error) {
+            return {
+                code: 1,
+                lines: [
+                    ...(done.length ? [`отправлено до отказа: ${done.length}`, ...done] : []),
+                    `отправка оборвалась на ${proposal.resource}: ${error.message.split('\n')[0]}`,
+                    // Три причины покрывают почти все отказы, и ни одну из них не видно из
+                    // сообщения помощника: он говорит про метку, доступ и сам себя одинаково глухо.
+                    `проверь: помощник хостинга стоит и вошёл в учётную запись; в ${options.repository} заведена метка ${FEEDBACK_LABEL}; у учётной записи есть право заводить записи`,
+                    'файл предложений остался на месте — отправленное помечено, остальное уедет повторным запуском',
+                ],
+            };
+        }
+        // Пометка ложится сразу, а не после всех: оборвавшаяся отправка иначе увозит половину
+        // предложений и не оставляет следа, по которому видно, какую именно.
+        const path = join(root, proposal.file);
+        writeFileSync(path, markSent(readFileSync(path, 'utf8'), proposal, url), 'utf8');
+        done.push(`  ${proposal.resource} → ${url}`);
+    }
+    return {
+        code: 0,
+        lines: [
+            `заведено записей: ${done.length} в ${options.repository}`,
+            ...done,
+            'разбирается сведением: `/agent-kit-digest` в репозитории пакета — оно и заводит задачу',
+        ],
+    };
+}
 export function doctor(env) {
     const { root, version, assetsDir } = env;
     const config = readConfig(root);
@@ -319,9 +624,16 @@ export function doctor(env) {
     // Ресурс, названный и в отказе, и чужим видом, считается один раз — иначе «не выбрано»
     // уходит в минус, а минус в отчёте читается как поломка счёта, а не как двойной счёт.
     const skipped = config.skip.filter((id) => foreignVariant.every((entry) => entry.id !== id)).length;
+    // Невыбранное называется поимённо: число «не выбрано: 73» не отвечает ни на один вопрос,
+    // ради которого его читают, — ни какого ресурса не хватает, ни требуется ли он соседу.
+    const unchosen = catalog.filter((entry) => !isChosen(entry, config) &&
+        !config.skip.includes(entry.id) &&
+        foreignVariant.every((one) => one.id !== entry.id));
     const lines = [
         `пакет v${version}, везёт ресурсов ${catalog.length}, взято ${taken}`,
         `не выбрано: ${catalog.length - taken - skipped - other}, пропущено: ${skipped}, другой вид: ${other}`,
+        ...unchosen.map((entry) => `  не выбран: ${entry.id}`),
+        ...profileLines(root, assetsDir, config),
         `значений в конфиге: ${Object.keys(config.vars).length}`,
         ...chosen,
         ...[...counted].map(([outcome, count]) => `${STATE_WORD[outcome]}: ${count}`),