@rt-tools/agent-kit 0.5.0 → 0.5.2

package/lib/observations.d.ts

@@ -0,0 +1,72 @@
+/** Куда `observe.sh` пишет наблюдения. Путь от корня дерева. */
+export declare const OBSERVATIONS_DIR: string;
+/** Сколько дней наблюдения лежат. Каталог, который только растёт, через год перестают открывать. */
+export declare const KEEP_DAYS: number;
+/** За сколько дней сводка отвечает, когда отрезок не назван. */
+export declare const DEFAULT_DAYS: number;
+/** Роды событий, которые пишут гарды. */
+export type TEvent = 'skill-load' | 'gate-deny' | 'guard-deny';
+export interface IObservation {
+    readonly event: string;
+    /** Имя правила или гарда — имя ресурса пакета, и только оно. */
+    readonly resource: string;
+    /** Род правки: расширение, `command` или `browser`. Пути в наблюдении нет. */
+    readonly kind: string;
+    /** Признак сессии: считает заходы, имени сессии не выдаёт. */
+    readonly session: string;
+    readonly version: string;
+}
+/** Сколько раз что-то встретилось. Порядок — по убыванию, при равенстве по имени. */
+export interface ICount {
+    readonly name: string;
+    readonly count: number;
+}
+export interface ISummary {
+    readonly days: number;
+    /** Сколько заходов оставило хоть одно наблюдение. */
+    readonly sessions: number;
+    readonly loads: readonly ICount[];
+    /** Отбития гейта по правилам. */
+    readonly denials: readonly ICount[];
+    /** Род правки, на котором гейт отбивал. */
+    readonly kinds: readonly ICount[];
+    readonly guards: readonly ICount[];
+    /**
+     * Правила, разложенные в дерево и не загруженные за отрезок ни разу. Мёртвый ресурс иначе
+     * неотличим от работающего — и это единственная строка сводки, которую нельзя получить из
+     * самих наблюдений.
+     */
+    readonly unused: readonly string[];
+    readonly versions: readonly string[];
+    readonly total: number;
+}
+/** День, отстоящий от названного на столько-то суток назад. Считается в UTC — как и пишется. */
+export declare function dayBefore(today: string, days: number): string;
+/**
+ * Одна строка наблюдения. Битая пропускается молча: наблюдение — побочная запись гарда, и
+ * оборванная на полуслове строка не имеет права уронить сводку.
+ */
+export declare function parseObservation(line: string): IObservation | null;
+export interface IReadResult {
+    readonly observations: readonly IObservation[];
+    /** Файлы, снятые по сроку хранения: их называют вслух, а не убирают молча. */
+    readonly swept: readonly string[];
+    /** Каталога нет вовсе — записи не велось ни разу. */
+    readonly silent: boolean;
+}
+/**
+ * Наблюдения за отрезок и уборка того, что старше срока хранения.
+ *
+ * Уборка идёт здесь, а не отдельной командой: каталог растёт от работы, а не от запусков, и
+ * команда, о которой надо помнить, до второго месяца не доживает.
+ */
+export declare function readObservations(root: string, today: string, days: number): IReadResult;
+/**
+ * Сводка за отрезок.
+ *
+ * `known` — имена правил, разложенных в это дерево. Без них сводка отвечает только на вопрос
+ * «чем пользовались», а самое ценное — чем не пользовались ни разу — сказать нечем: в самих
+ * наблюдениях незагруженного правила нет по определению.
+ */
+export declare function summarize(observations: readonly IObservation[], known: readonly string[], days: number): ISummary;
+//# sourceMappingURL=observations.d.ts.map

package/lib/observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/observations.ts"],"names":[],"mappings":"AAeA,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,EAAE,MAAsC,CAAC;AAEtE,oGAAoG;AACpG,eAAO,MAAM,SAAS,EAAE,MAAW,CAAC;AAEpC,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,MAAU,CAAC;AAEtC,yCAAyC;AACzC,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,qFAAqF;AACrF,MAAM,WAAW,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAOD,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoBlE;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/C,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAiCvF;AAoBD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAgBjH"}

package/lib/observations.js

@@ -0,0 +1,126 @@
+/**
+ * Наблюдения и сводка по ним.
+ *
+ * Наблюдения пишет `hooks/observe.sh` — по строке на событие, по файлу на день. Здесь они
+ * читаются и сводятся: чем пользовались, чем не пользовались ни разу, обо что спотыкались.
+ *
+ * Разбор отделён от чтения диска намеренно: сводка — то, ради чего наблюдения ведутся, и
+ * проверять её на подложенных файлах значило бы проверять файловую систему.
+ *
+ * Дата приходит доводом, а не берётся из часов: сводка за отрезок дней иначе не проверяется
+ * спекой — вчерашний файл фикстуры завтра оказывается позавчерашним.
+ */
+import { existsSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+/** Куда `observe.sh` пишет наблюдения. Путь от корня дерева. */
+export const OBSERVATIONS_DIR = '.claude/rt-kit/observations';
+/** Сколько дней наблюдения лежат. Каталог, который только растёт, через год перестают открывать. */
+export const KEEP_DAYS = 30;
+/** За сколько дней сводка отвечает, когда отрезок не назван. */
+export const DEFAULT_DAYS = 3;
+/** Дата файла наблюдений: `2026-08-12.jsonl`. Чужое имя в каталоге не наблюдение. */
+const DAY_FILE = /^(\d{4}-\d{2}-\d{2})\.jsonl$/;
+const dayOf = (name) => DAY_FILE.exec(name)?.[1] ?? null;
+/** День, отстоящий от названного на столько-то суток назад. Считается в UTC — как и пишется. */
+export function dayBefore(today, days) {
+    const at = Date.parse(`${today}T00:00:00Z`);
+    return Number.isNaN(at) ? today : new Date(at - days * 86_400_000).toISOString().slice(0, 10);
+}
+/**
+ * Одна строка наблюдения. Битая пропускается молча: наблюдение — побочная запись гарда, и
+ * оборванная на полуслове строка не имеет права уронить сводку.
+ */
+export function parseObservation(line) {
+    if (!line.trim()) {
+        return null;
+    }
+    try {
+        const found = JSON.parse(line);
+        const event = found['ev'];
+        return typeof event === 'string' && event
+            ? {
+                event,
+                resource: typeof found['res'] === 'string' ? found['res'] : '',
+                kind: typeof found['kind'] === 'string' ? found['kind'] : '',
+                session: typeof found['sid'] === 'string' ? found['sid'] : '',
+                version: typeof found['v'] === 'string' ? found['v'] : '',
+            }
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Наблюдения за отрезок и уборка того, что старше срока хранения.
+ *
+ * Уборка идёт здесь, а не отдельной командой: каталог растёт от работы, а не от запусков, и
+ * команда, о которой надо помнить, до второго месяца не доживает.
+ */
+export function readObservations(root, today, days) {
+    const dir = join(root, OBSERVATIONS_DIR);
+    if (!existsSync(dir)) {
+        return { observations: [], swept: [], silent: true };
+    }
+    const since = dayBefore(today, days - 1);
+    const keepFrom = dayBefore(today, KEEP_DAYS);
+    const observations = [];
+    const swept = [];
+    for (const name of readdirSync(dir).sort()) {
+        const day = dayOf(name);
+        if (!day) {
+            continue;
+        }
+        if (day < keepFrom) {
+            rmSync(join(dir, name), { force: true });
+            swept.push(name);
+            continue;
+        }
+        if (day < since) {
+            continue;
+        }
+        for (const line of readFileSync(join(dir, name), 'utf8').split('\n')) {
+            const found = parseObservation(line);
+            if (found) {
+                observations.push(found);
+            }
+        }
+    }
+    return { observations, swept, silent: false };
+}
+const countBy = (values) => {
+    const counted = new Map();
+    for (const value of values) {
+        if (value) {
+            counted.set(value, (counted.get(value) ?? 0) + 1);
+        }
+    }
+    return [...counted]
+        .map(([name, count]) => ({ name, count }))
+        .sort((left, right) => right.count - left.count || left.name.localeCompare(right.name));
+};
+const of = (observations, event) => observations.filter((entry) => entry.event === event);
+/**
+ * Сводка за отрезок.
+ *
+ * `known` — имена правил, разложенных в это дерево. Без них сводка отвечает только на вопрос
+ * «чем пользовались», а самое ценное — чем не пользовались ни разу — сказать нечем: в самих
+ * наблюдениях незагруженного правила нет по определению.
+ */
+export function summarize(observations, known, days) {
+    const loads = of(observations, 'skill-load');
+    const denials = of(observations, 'gate-deny');
+    const loaded = new Set(loads.map((entry) => entry.resource));
+    return {
+        days,
+        sessions: new Set(observations.map((entry) => entry.session).filter(Boolean)).size,
+        loads: countBy(loads.map((entry) => entry.resource)),
+        denials: countBy(denials.map((entry) => entry.resource)),
+        kinds: countBy(denials.map((entry) => entry.kind)),
+        guards: countBy(of(observations, 'guard-deny').map((entry) => entry.resource)),
+        unused: known.filter((name) => !loaded.has(name)).sort(),
+        versions: [...new Set(observations.map((entry) => entry.version).filter(Boolean))].sort(),
+        total: observations.length,
+    };
+}
+//# sourceMappingURL=observations.js.map

package/lib/observations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observations.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/observations.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Наблюдения и сводка по ним.\n *\n * Наблюдения пишет `hooks/observe.sh` — по строке на событие, по файлу на день. Здесь они\n * читаются и сводятся: чем пользовались, чем не пользовались ни разу, обо что спотыкались.\n *\n * Разбор отделён от чтения диска намеренно: сводка — то, ради чего наблюдения ведутся, и\n * проверять её на подложенных файлах значило бы проверять файловую систему.\n *\n * Дата приходит доводом, а не берётся из часов: сводка за отрезок дней иначе не проверяется\n * спекой — вчерашний файл фикстуры завтра оказывается позавчерашним.\n */\nimport { existsSync, readFileSync, readdirSync, rmSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/** Куда `observe.sh` пишет наблюдения. Путь от корня дерева. */\nexport const OBSERVATIONS_DIR: string = '.claude/rt-kit/observations';\n\n/** Сколько дней наблюдения лежат. Каталог, который только растёт, через год перестают открывать. */\nexport const KEEP_DAYS: number = 30;\n\n/** За сколько дней сводка отвечает, когда отрезок не назван. */\nexport const DEFAULT_DAYS: number = 3;\n\n/** Роды событий, которые пишут гарды. */\nexport type TEvent = 'skill-load' | 'gate-deny' | 'guard-deny';\n\nexport interface IObservation {\n    readonly event: string;\n    /** Имя правила или гарда — имя ресурса пакета, и только оно. */\n    readonly resource: string;\n    /** Род правки: расширение, `command` или `browser`. Пути в наблюдении нет. */\n    readonly kind: string;\n    /** Признак сессии: считает заходы, имени сессии не выдаёт. */\n    readonly session: string;\n    readonly version: string;\n}\n\n/** Сколько раз что-то встретилось. Порядок — по убыванию, при равенстве по имени. */\nexport interface ICount {\n    readonly name: string;\n    readonly count: number;\n}\n\nexport interface ISummary {\n    readonly days: number;\n    /** Сколько заходов оставило хоть одно наблюдение. */\n    readonly sessions: number;\n    readonly loads: readonly ICount[];\n    /** Отбития гейта по правилам. */\n    readonly denials: readonly ICount[];\n    /** Род правки, на котором гейт отбивал. */\n    readonly kinds: readonly ICount[];\n    readonly guards: readonly ICount[];\n    /**\n     * Правила, разложенные в дерево и не загруженные за отрезок ни разу. Мёртвый ресурс иначе\n     * неотличим от работающего — и это единственная строка сводки, которую нельзя получить из\n     * самих наблюдений.\n     */\n    readonly unused: readonly string[];\n    readonly versions: readonly string[];\n    readonly total: number;\n}\n\n/** Дата файла наблюдений: `2026-08-12.jsonl`. Чужое имя в каталоге не наблюдение. */\nconst DAY_FILE: RegExp = /^(\\d{4}-\\d{2}-\\d{2})\\.jsonl$/;\n\nconst dayOf: (name: string) => string | null = (name: string): string | null => DAY_FILE.exec(name)?.[1] ?? null;\n\n/** День, отстоящий от названного на столько-то суток назад. Считается в UTC — как и пишется. */\nexport function dayBefore(today: string, days: number): string {\n    const at: number = Date.parse(`${today}T00:00:00Z`);\n\n    return Number.isNaN(at) ? today : new Date(at - days * 86_400_000).toISOString().slice(0, 10);\n}\n\n/**\n * Одна строка наблюдения. Битая пропускается молча: наблюдение — побочная запись гарда, и\n * оборванная на полуслове строка не имеет права уронить сводку.\n */\nexport function parseObservation(line: string): IObservation | null {\n    if (!line.trim()) {\n        return null;\n    }\n    try {\n        const found: Record<string, unknown> = JSON.parse(line) as Record<string, unknown>;\n        const event: unknown = found['ev'];\n\n        return typeof event === 'string' && event\n            ? {\n                  event,\n                  resource: typeof found['res'] === 'string' ? found['res'] : '',\n                  kind: typeof found['kind'] === 'string' ? found['kind'] : '',\n                  session: typeof found['sid'] === 'string' ? found['sid'] : '',\n                  version: typeof found['v'] === 'string' ? found['v'] : '',\n              }\n            : null;\n    } catch {\n        return null;\n    }\n}\n\nexport interface IReadResult {\n    readonly observations: readonly IObservation[];\n    /** Файлы, снятые по сроку хранения: их называют вслух, а не убирают молча. */\n    readonly swept: readonly string[];\n    /** Каталога нет вовсе — записи не велось ни разу. */\n    readonly silent: boolean;\n}\n\n/**\n * Наблюдения за отрезок и уборка того, что старше срока хранения.\n *\n * Уборка идёт здесь, а не отдельной командой: каталог растёт от работы, а не от запусков, и\n * команда, о которой надо помнить, до второго месяца не доживает.\n */\nexport function readObservations(root: string, today: string, days: number): IReadResult {\n    const dir: string = join(root, OBSERVATIONS_DIR);\n    if (!existsSync(dir)) {\n        return { observations: [], swept: [], silent: true };\n    }\n\n    const since: string = dayBefore(today, days - 1);\n    const keepFrom: string = dayBefore(today, KEEP_DAYS);\n    const observations: IObservation[] = [];\n    const swept: string[] = [];\n\n    for (const name of readdirSync(dir).sort()) {\n        const day: string | null = dayOf(name);\n        if (!day) {\n            continue;\n        }\n        if (day < keepFrom) {\n            rmSync(join(dir, name), { force: true });\n            swept.push(name);\n            continue;\n        }\n        if (day < since) {\n            continue;\n        }\n        for (const line of readFileSync(join(dir, name), 'utf8').split('\\n')) {\n            const found: IObservation | null = parseObservation(line);\n            if (found) {\n                observations.push(found);\n            }\n        }\n    }\n\n    return { observations, swept, silent: false };\n}\n\nconst countBy: (values: readonly string[]) => readonly ICount[] = (values: readonly string[]): readonly ICount[] => {\n    const counted: Map<string, number> = new Map();\n    for (const value of values) {\n        if (value) {\n            counted.set(value, (counted.get(value) ?? 0) + 1);\n        }\n    }\n\n    return [...counted]\n        .map(([name, count]: [string, number]): ICount => ({ name, count }))\n        .sort((left: ICount, right: ICount): number => right.count - left.count || left.name.localeCompare(right.name));\n};\n\nconst of: (observations: readonly IObservation[], event: TEvent) => readonly IObservation[] = (\n    observations: readonly IObservation[],\n    event: TEvent\n): readonly IObservation[] => observations.filter((entry: IObservation): boolean => entry.event === event);\n\n/**\n * Сводка за отрезок.\n *\n * `known` — имена правил, разложенных в это дерево. Без них сводка отвечает только на вопрос\n * «чем пользовались», а самое ценное — чем не пользовались ни разу — сказать нечем: в самих\n * наблюдениях незагруженного правила нет по определению.\n */\nexport function summarize(observations: readonly IObservation[], known: readonly string[], days: number): ISummary {\n    const loads: readonly IObservation[] = of(observations, 'skill-load');\n    const denials: readonly IObservation[] = of(observations, 'gate-deny');\n    const loaded: Set<string> = new Set(loads.map((entry: IObservation): string => entry.resource));\n\n    return {\n        days,\n        sessions: new Set(observations.map((entry: IObservation): string => entry.session).filter(Boolean)).size,\n        loads: countBy(loads.map((entry: IObservation): string => entry.resource)),\n        denials: countBy(denials.map((entry: IObservation): string => entry.resource)),\n        kinds: countBy(denials.map((entry: IObservation): string => entry.kind)),\n        guards: countBy(of(observations, 'guard-deny').map((entry: IObservation): string => entry.resource)),\n        unused: known.filter((name: string): boolean => !loaded.has(name)).sort(),\n        versions: [...new Set(observations.map((entry: IObservation): string => entry.version).filter(Boolean))].sort(),\n        total: observations.length,\n    };\n}\n"]}

package/lib/proposals.d.ts

@@ -0,0 +1,48 @@
+/** Куда главный агент кладёт предложения. Путь от корня дерева. */
+export declare const PROPOSALS_DIR: string;
+/** Адрес предложения: куда правка идёт. Наружу уезжает только первый. */
+export declare const TO_PACKAGE: string;
+export declare const TO_COMPANION: string;
+export declare const TO_TREE: string;
+export interface IProposal {
+    readonly address: string;
+    readonly resource: string;
+    /** Тело блока без заголовка: место, повод и готовый текст. */
+    readonly body: string;
+    /** Ссылка на заведённую запись; пусто — не отправлялось. */
+    readonly sent: string;
+    /** Файл, в котором блок лежит, путём от корня дерева. */
+    readonly file: string;
+    /** Строка заголовка в файле, считая с единицы. */
+    readonly line: number;
+}
+/**
+ * Блоки файла предложений.
+ *
+ * Незаполненный образец пропускается: в шаблоне ресурс стоит скобками — `rules/<правило>.md`, —
+ * и отправить его значило бы завести запись о правке несуществующего файла.
+ */
+export declare function parseProposals(text: string, file: string): readonly IProposal[];
+/** Все файлы предложений дерева, в порядке имён. */
+export declare function readProposals(root: string): readonly IProposal[];
+export interface ILeak {
+    /** Строка блока, считая с единицы от заголовка. */
+    readonly line: number;
+    readonly text: string;
+    readonly why: string;
+}
+/**
+ * Что в тексте называет дерево, из которого предложение уезжает.
+ *
+ * `marks` — имена, которые знает только это дерево: корень, его последнее звено, адрес его
+ * удалённого репозитория. Пакет их не угадывает — они приходят доводом с края.
+ */
+export declare function leaksIn(text: string, marks: readonly string[]): readonly ILeak[];
+/**
+ * Чем дерево себя выдаёт. Последнее звено пути берётся отдельно от полного: в тексте оно
+ * встречается чаще, чем путь целиком.
+ */
+export declare function marksOf(root: string, remote: string): readonly string[];
+/** Пометка об отправке дописывается в блок, а не в конец файла: блоков в файле несколько. */
+export declare function markSent(text: string, proposal: IProposal, url: string): string;
+//# sourceMappingURL=proposals.d.ts.map

package/lib/proposals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/proposals.ts"],"names":[],"mappings":"AAcA,mEAAmE;AACnE,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,UAAU,EAAE,MAAgB,CAAC;AAC1C,eAAO,MAAM,YAAY,EAAE,MAAoB,CAAC;AAChD,eAAO,MAAM,OAAO,EAAE,MAAiB,CAAC;AAUxC,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAiC/E;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAUhE;AAED,MAAM,WAAW,KAAK;IAClB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAKD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,KAAK,EAAE,CAgBhF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIvE;AAED,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/E"}

package/lib/proposals.js

@@ -0,0 +1,111 @@
+/**
+ * Предложения по слою правил: разбор файла, отбор того, что уезжает наружу, и проверка на адрес
+ * дерева.
+ *
+ * Файл пишет главный агент после разбора закрытой задачи — по блоку на предложение, с адресом в
+ * заголовке. Адрес роль проставляет и так; здесь он впервые становится тем, что читает машина.
+ *
+ * Проверка на утечку живёт в этом же модуле не для удобства: предложение уезжает в чужой
+ * репозиторий целиком, и запрет называть чужое дерево обязан держаться проверкой, а не памятью
+ * того, кто пишет.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+/** Куда главный агент кладёт предложения. Путь от корня дерева. */
+export const PROPOSALS_DIR = '.claude/rt-kit/proposals';
+/** Адрес предложения: куда правка идёт. Наружу уезжает только первый. */
+export const TO_PACKAGE = 'пакет';
+export const TO_COMPANION = 'компаньон';
+export const TO_TREE = 'дерево';
+const ADDRESSES = [TO_PACKAGE, TO_COMPANION, TO_TREE];
+/** Заголовок блока: `## <адрес> · <ресурс>`. Разделитель — тот же, что в шаблоне. */
+const HEADING = /^##\s+(\S+)\s+·\s+(\S.*?)\s*$/;
+/** Пометка об отправке. По ней же предложение узнаётся отправленным. */
+const SENT = /^-\s+\*\*отправлено:\*\*\s*(\S+)/m;
+/**
+ * Блоки файла предложений.
+ *
+ * Незаполненный образец пропускается: в шаблоне ресурс стоит скобками — `rules/<правило>.md`, —
+ * и отправить его значило бы завести запись о правке несуществующего файла.
+ */
+export function parseProposals(text, file) {
+    const lines = text.split('\n');
+    const found = [];
+    let at = -1;
+    const close = (end) => {
+        if (at < 0) {
+            return;
+        }
+        const heading = HEADING.exec(lines[at]);
+        const body = lines
+            .slice(at + 1, end)
+            .join('\n')
+            .trim();
+        const address = heading[1];
+        const resource = heading[2];
+        if (ADDRESSES.includes(address) && !resource.includes('<')) {
+            found.push({ address, resource, body, sent: SENT.exec(body)?.[1] ?? '', file, line: at + 1 });
+        }
+        at = -1;
+    };
+    lines.forEach((line, index) => {
+        if (line.startsWith('## ')) {
+            close(index);
+            if (HEADING.test(line)) {
+                at = index;
+            }
+        }
+    });
+    close(lines.length);
+    return found;
+}
+/** Все файлы предложений дерева, в порядке имён. */
+export function readProposals(root) {
+    const dir = join(root, PROPOSALS_DIR);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir)
+        .filter((name) => name.endsWith('.md'))
+        .sort()
+        .flatMap((name) => parseProposals(readFileSync(join(dir, name), 'utf8'), join(PROPOSALS_DIR, name)));
+}
+/** Абсолютный путь машины: он не бывает общим ни для одного дерева, кроме этого. */
+const ABSOLUTE = /(^|[\s(`'"])(~\/|\/(Users|home|var|opt|srv|mnt)\/)\S+/;
+/**
+ * Что в тексте называет дерево, из которого предложение уезжает.
+ *
+ * `marks` — имена, которые знает только это дерево: корень, его последнее звено, адрес его
+ * удалённого репозитория. Пакет их не угадывает — они приходят доводом с края.
+ */
+export function leaksIn(text, marks) {
+    const found = [];
+    text.split('\n').forEach((line, index) => {
+        if (ABSOLUTE.test(line)) {
+            found.push({ line: index + 1, text: line.trim(), why: 'абсолютный путь этой машины' });
+            return;
+        }
+        const mark = marks.find((value) => Boolean(value) && line.includes(value));
+        if (mark) {
+            found.push({ line: index + 1, text: line.trim(), why: `имя этого дерева: ${mark}` });
+        }
+    });
+    return found;
+}
+/**
+ * Чем дерево себя выдаёт. Последнее звено пути берётся отдельно от полного: в тексте оно
+ * встречается чаще, чем путь целиком.
+ */
+export function marksOf(root, remote) {
+    const name = basename(root);
+    return [root, name, remote].filter(Boolean);
+}
+/** Пометка об отправке дописывается в блок, а не в конец файла: блоков в файле несколько. */
+export function markSent(text, proposal, url) {
+    const lines = text.split('\n');
+    // Пометка встаёт сразу под заголовок: конец блока определяется следующим заголовком, а его
+    // может и не быть — тогда «конец» пришлось бы искать по пустым строкам в хвосте файла.
+    lines.splice(proposal.line, 0, `- **отправлено:** ${url}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=proposals.js.map

package/lib/proposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/proposals.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Предложения по слою правил: разбор файла, отбор того, что уезжает наружу, и проверка на адрес\n * дерева.\n *\n * Файл пишет главный агент после разбора закрытой задачи — по блоку на предложение, с адресом в\n * заголовке. Адрес роль проставляет и так; здесь он впервые становится тем, что читает машина.\n *\n * Проверка на утечку живёт в этом же модуле не для удобства: предложение уезжает в чужой\n * репозиторий целиком, и запрет называть чужое дерево обязан держаться проверкой, а не памятью\n * того, кто пишет.\n */\nimport { existsSync, readdirSync, readFileSync } from 'node:fs';\nimport { basename, join } from 'node:path';\n\n/** Куда главный агент кладёт предложения. Путь от корня дерева. */\nexport const PROPOSALS_DIR: string = '.claude/rt-kit/proposals';\n\n/** Адрес предложения: куда правка идёт. Наружу уезжает только первый. */\nexport const TO_PACKAGE: string = 'пакет';\nexport const TO_COMPANION: string = 'компаньон';\nexport const TO_TREE: string = 'дерево';\n\nconst ADDRESSES: readonly string[] = [TO_PACKAGE, TO_COMPANION, TO_TREE];\n\n/** Заголовок блока: `## <адрес> · <ресурс>`. Разделитель — тот же, что в шаблоне. */\nconst HEADING: RegExp = /^##\\s+(\\S+)\\s+·\\s+(\\S.*?)\\s*$/;\n\n/** Пометка об отправке. По ней же предложение узнаётся отправленным. */\nconst SENT: RegExp = /^-\\s+\\*\\*отправлено:\\*\\*\\s*(\\S+)/m;\n\nexport interface IProposal {\n    readonly address: string;\n    readonly resource: string;\n    /** Тело блока без заголовка: место, повод и готовый текст. */\n    readonly body: string;\n    /** Ссылка на заведённую запись; пусто — не отправлялось. */\n    readonly sent: string;\n    /** Файл, в котором блок лежит, путём от корня дерева. */\n    readonly file: string;\n    /** Строка заголовка в файле, считая с единицы. */\n    readonly line: number;\n}\n\n/**\n * Блоки файла предложений.\n *\n * Незаполненный образец пропускается: в шаблоне ресурс стоит скобками — `rules/<правило>.md`, —\n * и отправить его значило бы завести запись о правке несуществующего файла.\n */\nexport function parseProposals(text: string, file: string): readonly IProposal[] {\n    const lines: readonly string[] = text.split('\\n');\n    const found: IProposal[] = [];\n    let at: number = -1;\n\n    const close: (end: number) => void = (end: number): void => {\n        if (at < 0) {\n            return;\n        }\n        const heading: RegExpExecArray = HEADING.exec(lines[at]) as RegExpExecArray;\n        const body: string = lines\n            .slice(at + 1, end)\n            .join('\\n')\n            .trim();\n        const address: string = heading[1];\n        const resource: string = heading[2];\n        if (ADDRESSES.includes(address) && !resource.includes('<')) {\n            found.push({ address, resource, body, sent: SENT.exec(body)?.[1] ?? '', file, line: at + 1 });\n        }\n        at = -1;\n    };\n\n    lines.forEach((line: string, index: number): void => {\n        if (line.startsWith('## ')) {\n            close(index);\n            if (HEADING.test(line)) {\n                at = index;\n            }\n        }\n    });\n    close(lines.length);\n\n    return found;\n}\n\n/** Все файлы предложений дерева, в порядке имён. */\nexport function readProposals(root: string): readonly IProposal[] {\n    const dir: string = join(root, PROPOSALS_DIR);\n    if (!existsSync(dir)) {\n        return [];\n    }\n\n    return readdirSync(dir)\n        .filter((name: string): boolean => name.endsWith('.md'))\n        .sort()\n        .flatMap((name: string): readonly IProposal[] => parseProposals(readFileSync(join(dir, name), 'utf8'), join(PROPOSALS_DIR, name)));\n}\n\nexport interface ILeak {\n    /** Строка блока, считая с единицы от заголовка. */\n    readonly line: number;\n    readonly text: string;\n    readonly why: string;\n}\n\n/** Абсолютный путь машины: он не бывает общим ни для одного дерева, кроме этого. */\nconst ABSOLUTE: RegExp = /(^|[\\s(`'\"])(~\\/|\\/(Users|home|var|opt|srv|mnt)\\/)\\S+/;\n\n/**\n * Что в тексте называет дерево, из которого предложение уезжает.\n *\n * `marks` — имена, которые знает только это дерево: корень, его последнее звено, адрес его\n * удалённого репозитория. Пакет их не угадывает — они приходят доводом с края.\n */\nexport function leaksIn(text: string, marks: readonly string[]): readonly ILeak[] {\n    const found: ILeak[] = [];\n\n    text.split('\\n').forEach((line: string, index: number): void => {\n        if (ABSOLUTE.test(line)) {\n            found.push({ line: index + 1, text: line.trim(), why: 'абсолютный путь этой машины' });\n\n            return;\n        }\n        const mark: string | undefined = marks.find((value: string): boolean => Boolean(value) && line.includes(value));\n        if (mark) {\n            found.push({ line: index + 1, text: line.trim(), why: `имя этого дерева: ${mark}` });\n        }\n    });\n\n    return found;\n}\n\n/**\n * Чем дерево себя выдаёт. Последнее звено пути берётся отдельно от полного: в тексте оно\n * встречается чаще, чем путь целиком.\n */\nexport function marksOf(root: string, remote: string): readonly string[] {\n    const name: string = basename(root);\n\n    return [root, name, remote].filter(Boolean);\n}\n\n/** Пометка об отправке дописывается в блок, а не в конец файла: блоков в файле несколько. */\nexport function markSent(text: string, proposal: IProposal, url: string): string {\n    const lines: string[] = text.split('\\n');\n    // Пометка встаёт сразу под заголовок: конец блока определяется следующим заголовком, а его\n    // может и не быть — тогда «конец» пришлось бы искать по пустым строкам в хвосте файла.\n    lines.splice(proposal.line, 0, `- **отправлено:** ${url}`);\n\n    return lines.join('\\n');\n}\n"]}

package/lib/submit.d.ts

@@ -0,0 +1,24 @@
+export interface IIssueInput {
+    /** `владелец/репозиторий` — читается из манифеста пакета, а не зашито в код. */
+    readonly repository: string;
+    readonly title: string;
+    readonly body: string;
+    readonly label: string;
+}
+/** Чем заводится запись. Двойник в спеке — того же вида. */
+export type TSubmit = (input: IIssueInput) => string;
+/** Метка, по которой сведение находит предложения среди прочих записей. */
+export declare const FEEDBACK_LABEL: string;
+/**
+ * `владелец/репозиторий` из адреса, записанного в манифесте пакета. Форм адреса несколько —
+ * `git+https://…`, `git@…:…`, — и все они ведут к одной паре имён.
+ */
+export declare function repositoryOf(url: string): string;
+/**
+ * Запись в очереди работ через помощника хостинга.
+ *
+ * Помощник может быть подменён оболочкой пользователя, поэтому зовётся он именем, а не строкой
+ * оболочки: подмена принимает те же доводы, но уходит в чужую учётную запись.
+ */
+export declare const ghIssue: TSubmit;
+//# sourceMappingURL=submit.d.ts.map

package/lib/submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/submit.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,WAAW;IACxB,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,4DAA4D;AAC5D,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,cAAc,EAAE,MAA6B,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,OAKV,CAAC"}

package/lib/submit.js

@@ -0,0 +1,26 @@
+/**
+ * Отправка предложения в очередь работ репозитория пакета.
+ *
+ * Единственное место пакета, которое ходит наружу, и ходит оно только по команде человека:
+ * ни один гард в сеть не ходит вовсе. Вынесено отдельно, чтобы команда `propose` осталась
+ * проверяемой: спека подставляет двойник и не заводит записей в живом репозитории.
+ */
+import { execFileSync } from 'node:child_process';
+/** Метка, по которой сведение находит предложения среди прочих записей. */
+export const FEEDBACK_LABEL = 'agent-kit-feedback';
+/**
+ * `владелец/репозиторий` из адреса, записанного в манифесте пакета. Форм адреса несколько —
+ * `git+https://…`, `git@…:…`, — и все они ведут к одной паре имён.
+ */
+export function repositoryOf(url) {
+    const found = /(?:github\.com[/:])([^/]+)\/([^/.]+)/.exec(url);
+    return found ? `${found[1]}/${found[2]}` : '';
+}
+/**
+ * Запись в очереди работ через помощника хостинга.
+ *
+ * Помощник может быть подменён оболочкой пользователя, поэтому зовётся он именем, а не строкой
+ * оболочки: подмена принимает те же доводы, но уходит в чужую учётную запись.
+ */
+export const ghIssue = (input) => execFileSync('gh', ['issue', 'create', '--repo', input.repository, '--title', input.title, '--label', input.label, '--body-file', '-'], { input: input.body, encoding: 'utf8' }).trim();
+//# sourceMappingURL=submit.js.map

package/lib/submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/submit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAalD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAW,oBAAoB,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACpC,MAAM,KAAK,GAA2B,sCAAsC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvF,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,CAAC,KAAkB,EAAU,EAAE,CAC3D,YAAY,CACR,IAAI,EACJ,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EACnH,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAC1C,CAAC,IAAI,EAAE,CAAC","sourcesContent":["/**\n * Отправка предложения в очередь работ репозитория пакета.\n *\n * Единственное место пакета, которое ходит наружу, и ходит оно только по команде человека:\n * ни один гард в сеть не ходит вовсе. Вынесено отдельно, чтобы команда `propose` осталась\n * проверяемой: спека подставляет двойник и не заводит записей в живом репозитории.\n */\nimport { execFileSync } from 'node:child_process';\n\nexport interface IIssueInput {\n    /** `владелец/репозиторий` — читается из манифеста пакета, а не зашито в код. */\n    readonly repository: string;\n    readonly title: string;\n    readonly body: string;\n    readonly label: string;\n}\n\n/** Чем заводится запись. Двойник в спеке — того же вида. */\nexport type TSubmit = (input: IIssueInput) => string;\n\n/** Метка, по которой сведение находит предложения среди прочих записей. */\nexport const FEEDBACK_LABEL: string = 'agent-kit-feedback';\n\n/**\n * `владелец/репозиторий` из адреса, записанного в манифесте пакета. Форм адреса несколько —\n * `git+https://…`, `git@…:…`, — и все они ведут к одной паре имён.\n */\nexport function repositoryOf(url: string): string {\n    const found: RegExpExecArray | null = /(?:github\\.com[/:])([^/]+)\\/([^/.]+)/.exec(url);\n\n    return found ? `${found[1]}/${found[2]}` : '';\n}\n\n/**\n * Запись в очереди работ через помощника хостинга.\n *\n * Помощник может быть подменён оболочкой пользователя, поэтому зовётся он именем, а не строкой\n * оболочки: подмена принимает те же доводы, но уходит в чужую учётную запись.\n */\nexport const ghIssue: TSubmit = (input: IIssueInput): string =>\n    execFileSync(\n        'gh',\n        ['issue', 'create', '--repo', input.repository, '--title', input.title, '--label', input.label, '--body-file', '-'],\n        { input: input.body, encoding: 'utf8' }\n    ).trim();\n"]}

package/lib/sync.d.ts

@@ -1,4 +1,4 @@
-import { IGapOfVariant } from './catalog.js';
+import { IBrokenLink, IGapOfVariant } from './catalog.js';
 import { ICompanion } from './companion.js';
 import { IConfig } from './config.js';
 import { IHookBinding } from './hooks-map.js';
@@ -33,6 +33,14 @@ export interface ISyncResult {
      * молчать нельзя: гард, который не зовут, неотличим от гарда, который всё пропускает.
      */
     readonly unbound: readonly IHookBinding[];
+    /**
+     * Выбранные ресурсы, чьи требования в дерево не поехали.
+     *
+     * Предупреждение, а не отказ: дерево вправе закрыть требование своим средством, но обязано
+     * знать, что закрывает. Молчание же оставляет его исправным на вид — сверка зелена на любом
+     * подмножестве, сколько бы связок ни было разорвано.
+     */
+    readonly broken: readonly IBrokenLink[];
     readonly written: readonly string[];
 }
 export declare function planSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult;

package/lib/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sync.ts"],"names":[],"mappings":"AAWA,OAAO,EAAmB,aAAa,EAA4B,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,UAAU,EAAyB,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AACrD,OAAO,EAAa,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAkC,MAAM,WAAW,CAAC;AAMrE,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACzD,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AA2DD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CA6BvG;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CA0CtG;AAED,eAAO,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,QAAQ,EACe,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sync.ts"],"names":[],"mappings":"AAWA,OAAO,EAAe,WAAW,EAAmB,aAAa,EAA4B,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,UAAU,EAAyB,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AACrD,OAAO,EAA4B,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAkC,MAAM,WAAW,CAAC;AAMrE,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACzD,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAwDD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CA8BvG;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CA0CtG;AAED,eAAO,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,QAAQ,EACe,CAAC"}

package/lib/sync.js

@@ -8,10 +8,10 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { collectAssets, targetOf } from './assets.js';
-import { readCatalog, variantGaps } from './catalog.js';
+import { brokenLinks, readCatalog, variantGaps } from './catalog.js';
 import { pathOf, planCompanion } from './companion.js';
 import { OVERRIDES_DIR } from './config.js';
-import { bindingOf, unboundHooks } from './hooks-map.js';
+import { bindingsOf as declaredIn, unboundHooks } from './hooks-map.js';
 import { isPending, isRefusal, planFile } from './plan.js';
 import { mergeDocuments, parseDocument, renderDocument } from './sections.js';
 import { readStamped } from './stamp.js';
@@ -58,10 +58,7 @@ function bindingsOf(config, assetsDir) {
         if (asset.kind !== 'hooks') {
             continue;
         }
-        const binding = bindingOf(asset.text, asset.target);
-        if (binding) {
-            bindings.push(binding);
-        }
+        bindings.push(...declaredIn(asset.text, asset.target));
     }
     return bindings;
 }
@@ -88,6 +85,7 @@ export function planSync(config, root, version, assetsDir) {
         abandoned: abandonedOf(config, root, assetsDir),
         gaps: variantGaps(readCatalog(assetsDir), config),
         unbound: unboundHooks(bindingsOf(config, assetsDir), root),
+        broken: brokenLinks(readCatalog(assetsDir), config),
         written: [],
     };
 }