@shahimat/ai-core 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Журнал @shahimat/ai-core
+
+Свежее сверху. Одна версия — список новых команд и проверок.
+
+## 0.1.1
+
+- Дельта, попавшая в коммит после сбоя сессии, закрывается: пункт
+  засчитывается, если цель изменена в коммитах с появления дельты;
+  `delta check` предупреждает о закоммиченной дельте.
+- `delta check --name` и `delta close --name`: нарушения в чужих дельтах
+  — предупреждение со списком файлов, а не провал.
+- Дельта не прошла схему — ошибка схемы идёт первой, производные
+  нарушения «без revise» по её целям свёрнуты в одну строку.
+- peer `vitest` — `>=3`: проекты на vitest 3 ставятся без ERESOLVE.
+
+## 0.1.0
+
+- `delta close --name <дельта>` закрывает только эту дельту: чужая
+  невыполненная больше не валит close. Принятые `revise` до коммита
+  помнит `context/.delta/.accepted.json` — следующая сессия не падает
+  «знание без revise». `target` с якорем `файл#поле` сверяется по файлу,
+  пункт о файле внутри `context/.delta/` считается выполненным.
+
+- Прогон роли прозрачен: журнал stream-json пишется в файл по мере
+  работы, `onProgress` получает строки «роль X: шаг N — инструмент»,
+  таймаут роли (по умолчанию 30 мин, `HARNESS_ROLE_TIMEOUT_MIN`)
+  останавливает `claude -p` с понятной причиной вместо тихого ожидания.
+
+- Роли: `askRole(root, name, task, { transcript, addDirs })` — полный
+  stream-json прогона в файл журнала и доступ роли к каталогам вне
+  проекта (`--add-dir`, копия репозитория job).
+- Hook `ops-brief`: `adapters sync` при `hooks: [ops-brief]` ставит
+  `ai ops brief` в `SessionStart` (`startup`, `resume`, `compact`).
+- `CommandArgs`: `all`, `every`, `until`, `job`, `timeout` — опции
+  рантайма `ops`.
+
+- Пакет выделен из `@shahimat/harness`: команды (`index`, `adapters`,
+  `changelog`, `context`, `delta`, `expect`, `secrets`, `outdated`,
+  `role`), скрипты (`check`, `refresh`), механизм ожиданий
+  (`@shahimat/ai-core/expect`) и роли (протокол, MCP-канал, запуск
+  `claude -p`). CLI — `ai-core`; автоматы остались в
+  `@shahimat/harness`.
+- Конфиг проекта — `context/ai-core.yml` (было `context/harness.yml`);
+  ключа `version` нет — версии пакетов в `package.json` проекта,
+  `outdated` сверяет оттуда `@shahimat/ai-core` и `@shahimat/harness`.
+- `docs guard` — hook `PreToolUse`: правка документации и генерируемых
+  файлов в основной сессии — отказ с кодом 2; `adapters sync` ставит
+  его в `.claude/settings.json` при `hooks: [docs-guard]`.
+- Метка генерируемых файлов и заголовки индексов — «generated by
+  ai-core …».

package/README.md

@@ -1,3 +1,249 @@
-# Temporary Holding Version
+# @shahimat/ai-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Ядро для проектов на контракте
+[`agent-operational-contract-v3`](https://github.com/Shahimat/ai-prompts/blob/main/prompts/productivity/agent-operational-contract-v3.md):
+механические проверки и генерация, механизм ожиданий и роли, чтобы агент
+не держал их в памяти. Библиотека без бинаря: команды запускает CLI `ai`
+([`@shahimat/cli`](https://www.npmjs.com/package/@shahimat/cli)), автоматы
+поверх них — [`@shahimat/harness`](https://www.npmjs.com/package/@shahimat/harness).
+
+Node ≥ 24. macOS, Linux, Windows.
+
+## Запуск
+
+Пакет ставится в `devDependencies` проекта рядом с `@shahimat/cli`,
+точные версии; команды — через `npx ai <команда>`.
+
+## Устройство
+
+Пакет делится на слои, зависимости идут только вниз:
+
+- **команды** — атомарные операции: прочитали файлы, проверили или
+  сгенерировали, вернули код. Друг друга не вызывают.
+
+Скрипты (последовательности команд) — в `@shahimat/cli`.
+
+Под ними — общий `shared` (guards, конфиг, проверка JSON Schema) и
+библиотека `lib` (`@shahimat/ai-core/expect`, индекс промптов, роли).
+Автоматы (`@shahimat/harness`) — слой выше: импортируют публичный API
+`ai-core`, обратной зависимости нет.
+
+У каждой команды и операции автомата объявлен эффект: **query** не
+меняет файлов (кроме кэша по содержимому вне git), **mutation** пишет.
+Эффект скрипта выводится из его шагов. CI и модель внутри состояния
+автомата получают только query.
+
+## Команды
+
+Mutation — `context index`, `adapters sync`, `delta close`,
+`expect init`, `expect judge`, `expect report --html`, `index build`,
+`role run`, `role channel`; остальные — query.
+
+- `ai secrets scan [--file <path>]` — секреты (ключи API, токены,
+  пароли, приватные ключи) в отслеживаемых git файлах проекта или в
+  одном файле по пути; в выводе — путь, строка и тип, без значения. В
+  `ai check` включена по умолчанию.
+- `ai changelog lint` — `CHANGELOG.md`: строка
+  `- YYYY-MM-DD · [tag] суть · почему` до 120 символов, тег из списка,
+  порядок дат.
+- `ai context index` — генерация `context/index.yml` из слоёв
+  документации (entities, behavior, manuals, conventions, слои модулей).
+- `ai context check` — сверка `context/index.yml` со слоями
+  документации без записи.
+- `ai adapters sync` — файлы под Claude Code и Codex из
+  `AGENTS.md` и `.agents/`: `CLAUDE.md`, копии skills, субагенты,
+  выключенная memory агента; при `hooks: [docs-guard]` — hook
+  `ai docs guard` в `.claude/settings.json` (свои hooks файла
+  сохраняются).
+- `ai adapters check` — сверка файлов адаптеров с `AGENTS.md` и
+  `.agents/` без записи.
+- `ai expect init` — каркас ожиданий в проекте: точка входа
+  `expectations/index.expect.ts`, пример файла с бюджетом, npm-скрипты,
+  `.gitignore`.
+- `ai expect report | lint | judge [--apply | --run] <file>` — ожидания в
+  форме vitest: дерево со статусами, проверка заголовков, пакетная
+  смысловая проверка судьёй-агентом с кэшем вердиктов. `judge` пишет
+  задания в `.judge/` для субагента-судьи, `--apply` применяет ответы;
+  `--run` отвечает на задания ролью `judge` (см. «Роли») и сразу
+  применяет. `<file>` — одна
+  точка входа `*.expect.ts`; остальные файлы ожиданий попадают в прогон
+  только через `import` в ней. Конфиг vitest — из пакета, проекту свой
+  не нужен. Отчёт, бюджет и проверка заголовков — по модулю, где
+  объявлено ожидание; вердикты и задания судьи — рядом с точкой входа
+  (`<каталог>/.verdicts.json`, `<каталог>/.judge/`). Помощники для
+  проверок — `@shahimat/harness/expect` (нужен vitest в проекте):
+  `crit` / `warn` / `note` / `budget`, `describe`, `expectAtMost` (info
+  при > 90% порога), зонды по репозиторию, `judged`, проверка JSON
+  Schema (`expectSchema`, `dataFiles`, `frontmatters`). Общий блок
+  ожиданий вне `*.expect.ts` объявляет разделы через `describe` из
+  `@shahimat/harness/expect`: так ожидания приписываются файлу, который
+  блок применил. `pattern(key, apply)` — паттерн ожиданий: функция с
+  параметрами, которая регистрирует ожидания для переданных целей (цели
+  — в заголовке, якоря доказательств — параметром); ожидания
+  приписываются применившему файлу, в HTML у них виден ключ паттерна.
+  Паттерны для любых проектов — `@shahimat/expectations`, для одного
+  репозитория — его `expectations/shared/`.
+  `report <file> --html <out>` — тот же отчёт HTML-файлом,
+  `serve <file> [--port <n>]` — с локального сервера (см. «План в форме
+  ожиданий»).
+- `ai delta check | close` — дельта проектной документации в
+  `context/.delta/*.yml` (пункты `add` / `refine` / `revise`). `check`
+  сверяет слои документации с `HEAD`: удалённое или изменённое знание
+  без пункта `revise` — нарушение; дельта не прошла схему — её ошибка
+  первой, производные нарушения по её целям свёрнуты. `close` после
+  приёмки (check чист, пункты выполнены) удаляет дельту и печатает
+  строки `revise` для тела коммита. `--name <дельта>` сужает обе
+  команды до одной дельты: нарушения чужих — предупреждение. Дельта,
+  попавшая в коммит, — предупреждение; её пункт засчитывается, если цель
+  изменена в коммитах с появления дельты.
+- `ai role run <name> --file <задание> [--out <ответ>]` — роль из
+  `.agents/agents/<name>.md` (в источнике — `agents/<name>.md`)
+  headless: текст задания — на stdin, итог — сообщением протокола в
+  `--out` или stdout (см. «Роли»).
+- `ai role channel <message> --out <файл>` — MCP-сервер (stdio)
+  канала роли с одним инструментом `submit_result`: проверяет ответ по
+  схеме сообщения, невалидный возвращает модели ошибкой с путём к полю,
+  валидный пишет в `--out`. Запускает его `role run`, не человек.
+- `ai outdated` — версии `@shahimat/ai-core` и `@shahimat/harness` из
+  `package.json` проекта против последних в npm и записи их журналов
+  между ними (код 1 — есть новее).
+- `ai docs guard` — hook `PreToolUse` для Claude Code: JSON hook на
+  stdin; `Edit` / `Write` в документацию (`CHANGELOG.md`,
+  `context/project.yml`, `context/conventions/`, `docs/`, слои модулей
+  из `provides.layers`, `context/.delta/`) и в генерируемые файлы
+  (`context/index.yml`, `CLAUDE.md`, `.claude/skills/`, `.claude/agents/`,
+  `.codex/agents/`) — отказ, код 2 и подсказка про `ai docs-delta`;
+  остальное — 0. Ставит его `adapters sync` при `hooks: [docs-guard]`.
+- `ai index build | check --raw-base <url>` — индекс
+  `prompts/index.yml` репозитория промптов.
+
+## План в форме ожиданий
+
+План — тот же файл ожиданий, а не отдельный документ. Файл описывает
+конечное состояние; чтобы его изменить, в файл добавляются блоки — `fsm`,
+`steps` и другие. План переходит в трекинг (заглушки сменяются
+проверками), трекинг — в новое конечное состояние. Вид страницы задают
+блоки: нет блока — нет его диаграммы.
+
+```ts
+plan({ name: 'plan-review: стол и оркестратор' });
+
+const planReview = fsm('plan-review', {
+  initial: 'draft',
+  limits: { fix: 3 },
+  states: {
+    draft: { actor: 'model', on: { questions: 'clarify', plan: 'review' } },
+    clarify: { actor: 'user', on: { answered: 'draft' } },
+    review: { actor: 'model', on: { pass: 'approved', fail: [{ to: 'draft', count: 'fix' }, 'approved'] } },
+    approved: { final: true },
+  },
+});
+
+steps(() => {
+  step('T1', { title: 'Headless draft', why: 'нет TTY' }, () => {
+    planReview.state('draft', () => {
+      crit.wip('ответ планера — план или вопросы по схеме', () => Check.draftAnswer());
+    });
+  });
+  step('T2', { title: 'Вопросы', after: ['T1'] }, () => {
+    planReview.transition('draft', 'questions', () => {
+      crit.todo('вопросы нумерованы, у каждого дефолт с обоснованием');
+    });
+  });
+});
+
+planReview.whole(() => {
+  crit('из любого состояния достижимо approved', () => Graph.canReach(planReview, ['approved']));
+});
+```
+
+- `plan({ name })` — имя плана: сессия plan-review и вкладка браузера.
+  Шапка страницы — только `info.title`; без неё `expect report`
+  просит её добавить.
+- Заглушки задают статус ожидания: `crit.todo(title)` / `warn.todo` — не
+  взято; `crit.wip(title, fn?)` / `warn.wip` — в работе: проверка
+  исполняется, если она есть, провал виден (`◐`), но не блокирует;
+  без заглушки проверка блокирует.
+- `steps(() => { step(id, { title, after, why }, body) })` — шаги плана;
+  ожидания шага — его DoD, `step` вне `steps` — ошибка. Статус шага
+  выводится из ожиданий: все `todo` — не начат, все без заглушек и
+  зелёные — готов, иначе — в работе. Нарушение плана (crit): готовый
+  шаг раньше шагов из `after`, неизвестный шаг в `after`, цикл, повтор
+  id. На странице — UML-диаграмма активностей: старт, шаги, развилки и
+  слияния по `after`, финал.
+- `fsm(name, { initial, limits, states })` — автомат данными. Имена
+  состояний и событий выводятся из литерала: опечатка в `state`,
+  `transition`, переходе или `initial` — ошибка typecheck. `state`,
+  `transition` и `whole` привязывают ожидания к узлу, переходу и
+  автомату целиком; на странице — схема Graphviz.
+- Блоки и ожидания из импортированных файлов попадают на страницу в
+  разделе своего модуля; у ожидания из общего блока видно, где оно
+  определено.
+- Зонды: `Graph.sameAs(m, def)` — граф совпадает с `harness.yaml`
+  (`def` — результат `parseMachine`); `Graph.canReach(m, targets)` — из
+  каждого состояния достижима цель; `Graph.onlyVia(m, target, via)` — в
+  `target` из `initial` не попасть в обход `via`.
+- `ai expect report <file> --html <out>` — HTML без сети
+  и без JS: диаграммы блоков — SVG Graphviz (wasm, при генерации); узел и переход ведут к карточке, цвет — статус ожиданий;
+  новые, изменённые и удалённые относительно HEAD ожидания отмечены.
+  Файл — производный вид, источник — файл ожиданий.
+- `ai expect serve <file> [--port <n>]` — та же страница
+  с `http://127.0.0.1:<port>/` (по умолчанию 4173): собирается при
+  каждом запросе, правка файла ожиданий видна после перезагрузки, на
+  диск ничего не пишется. Так артефакт плана — только файл ожиданий.
+
+## Роли
+
+Роль — субагент из `agents/<name>.md` источника (в проекте —
+`.agents/agents/`): промпт, `tools`, `model` (`opus` по умолчанию,
+`sonnet`, `haiku`) и `output` — сообщение протокола, которым роль
+возвращает итог. Одна и та же роль работает субагентом в сессии агента
+(адаптеры генерируют `.claude/agents/`, `.codex/agents/`) и
+headless-исполнителем в harness.
+
+- Протокол — JSON Schema сообщений: `result` (итог работы: статус,
+  изменённое, не прошедшее, вопросы, отчёт), `verdict` (ответ судьи:
+  вердикты пакета или проверка заголовков), `question` (блокирующий
+  вопрос человеку; канала для него пока нет). Схемы — `PROTOCOL` из
+  пакета.
+- Запуск — `claude -p` из Claude Code пользователя (его вход):
+  `--setting-sources ""`, `--strict-mcp-config`, единственный MCP —
+  канал `role channel` с `submit_result`, права — `tools` роли и
+  `submit_result`, режим `dontAsk`, задание — на stdin. Ответ текстом
+  harness не читает: нет вызова `submit_result` с валидным ответом —
+  ошибка роли.
+- Вход роли docs-keeper — схема `INTENTS_SCHEMA`: намерения `kind`
+  (`decision`, `fact`, `rule`, `behavior-change`, `task`, `manual`),
+  `summary`, `evidence`. Ответ судьи о документации — `verdict` с полем
+  `conflicts` (`file_a`, `quote_a`, `file_b`, `quote_b`, `reason`).
+- Роли пакета используют: `expect judge --run` (роль `judge`),
+  `docs-delta` (роль `docs-keeper` в `apply` с `--file`, роль `judge` в
+  `review`).
+
+Коды выхода: `0` — ok, `1` — нарушения, `2` — ошибка вызова или
+конфигурации.
+
+## `context/ai-core.yml`
+
+```yaml
+adapters: [claude-code, codex]
+hooks: [docs-guard]
+checks:
+  changelog:
+    max_line: 120
+    tags: [arch, stack, dep, milestone]
+  context-index: {}
+  adapters: {}
+  secrets:
+    allow:
+      - path: docs/aws.md
+        line: 12
+        reason: пример ключа из документации AWS
+```
+
+`secrets` включена, даже если ключа нет; `secrets: false` — выключить.
+Исключение без `reason` — ошибка конфига.
+
+## Лицензия
+
+MIT

package/dist/commands/adapters/index.d.ts

@@ -0,0 +1,3 @@
+import type { CommandArgs } from '#shared/args';
+export declare function runAdapters(command: string | undefined, args: CommandArgs): Promise<number>;
+export { applyActions, checkAdapters, computeSync, type Action, type SyncResult } from './sync.ts';

package/dist/commands/adapters/index.js

@@ -0,0 +1,21 @@
+import { applyActions, checkAdapters, computeSync } from './sync.js';
+import { CONFIG_PATH, loadConfig } from '#shared/config';
+import { UsageError } from '#shared/diagnostics';
+import { report } from '#shared/report';
+export async function runAdapters(command, args) {
+    if (command !== 'sync' && command !== 'check')
+        throw new UsageError(`неизвестная команда: adapters ${command ?? ''}`.trimEnd());
+    const config = await loadConfig(args.root);
+    if (config === null)
+        throw new UsageError(`нет ${CONFIG_PATH}: список adapters берётся оттуда`);
+    if (command === 'check')
+        return report('adapters check', await checkAdapters(args.root, config.adapters, config.hooks));
+    const { actions, diagnostics } = await computeSync(args.root, config.adapters, config.hooks);
+    await applyActions(args.root, actions);
+    for (const action of actions)
+        console.error(`${action.op === 'write' ? 'wrote' : 'deleted'} ${action.path}`);
+    if (actions.length === 0)
+        console.error('adapters: без изменений');
+    return report('adapters', diagnostics);
+}
+export { applyActions, checkAdapters, computeSync } from './sync.js';

package/dist/commands/adapters/memory.d.ts

@@ -0,0 +1,16 @@
+import type { Diagnostic } from '#shared/diagnostics';
+import type { HookKey } from '#shared/config';
+import type { Action } from './sync.ts';
+export declare const CLAUDE_SETTINGS = ".claude/settings.json";
+export declare const CODEX_CONFIG = ".codex/config.toml";
+export declare function codexConfig(): string;
+export declare const DOCS_GUARD_COMMAND = "node node_modules/@shahimat/cli/dist/bin.js docs guard";
+export declare const OPS_BRIEF_COMMAND = "node node_modules/@shahimat/cli/dist/bin.js ops brief";
+export declare function claudeMemory(root: string, hookKeys?: readonly HookKey[]): Promise<{
+    actions: Action[];
+    diagnostics: Diagnostic[];
+}>;
+export declare function codexMemory(root: string): Promise<{
+    actions: Action[];
+    diagnostics: Diagnostic[];
+}>;

package/dist/commands/adapters/memory.js

@@ -0,0 +1,135 @@
+// expect:memory-off
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { errorCode, errorMessage, isRecord } from '#shared/guards';
+import { GENERATED_MARK } from './render.js';
+export const CLAUDE_SETTINGS = '.claude/settings.json';
+export const CODEX_CONFIG = '.codex/config.toml';
+const CODEX_MEMORY_KEYS = [
+    'features.memories',
+    'memories.use_memories',
+    'memories.generate_memories',
+];
+export function codexConfig() {
+    return [
+        `# ${GENERATED_MARK} — do not edit; memory агента запрещена контрактом`,
+        '[features]',
+        'memories = false',
+        '',
+        '[memories]',
+        'use_memories = false',
+        'generate_memories = false',
+        '',
+    ].join('\n');
+}
+async function readOrNull(abs) {
+    try {
+        return await readFile(abs, 'utf8');
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+export const DOCS_GUARD_COMMAND = 'node node_modules/@shahimat/cli/dist/bin.js docs guard';
+const DOCS_GUARD_MATCHER = 'Edit|Write|MultiEdit|NotebookEdit';
+export const OPS_BRIEF_COMMAND = 'node node_modules/@shahimat/cli/dist/bin.js ops brief';
+const OPS_BRIEF_MATCHER = 'startup|resume|compact';
+const HOOK_SPECS = {
+    'docs-guard': { event: 'PreToolUse', matcher: DOCS_GUARD_MATCHER, command: DOCS_GUARD_COMMAND },
+    'ops-brief': { event: 'SessionStart', matcher: OPS_BRIEF_MATCHER, command: OPS_BRIEF_COMMAND },
+};
+function withHook(data, spec) {
+    const hooks = isRecord(data['hooks']) ? data['hooks'] : {};
+    const current = hooks[spec.event];
+    const list = Array.isArray(current) ? current : [];
+    const present = list.some((entry) => isRecord(entry) &&
+        Array.isArray(entry['hooks']) &&
+        entry['hooks'].some((h) => isRecord(h) && h['command'] === spec.command));
+    if (present)
+        return data;
+    const hook = { matcher: spec.matcher, hooks: [{ type: 'command', command: spec.command }] };
+    return { ...data, hooks: { ...hooks, [spec.event]: [...list, hook] } };
+}
+export async function claudeMemory(root, hookKeys = []) {
+    const desired = (data) => {
+        let next = { ...data, autoMemoryEnabled: false };
+        for (const key of hookKeys)
+            next = withHook(next, HOOK_SPECS[key]);
+        return next;
+    };
+    const current = await readOrNull(path.join(root, CLAUDE_SETTINGS));
+    const write = (data) => ({
+        op: 'write',
+        path: CLAUDE_SETTINGS,
+        content: Buffer.from(`${JSON.stringify(data, null, 2)}\n`, 'utf8'),
+    });
+    if (current === null)
+        return { actions: [write(desired({}))], diagnostics: [] };
+    let data;
+    try {
+        data = JSON.parse(current);
+    }
+    catch (error) {
+        return {
+            actions: [],
+            diagnostics: [{ file: CLAUDE_SETTINGS, message: `невалидный JSON: ${errorMessage(error)}` }],
+        };
+    }
+    if (!isRecord(data)) {
+        return {
+            actions: [],
+            diagnostics: [{ file: CLAUDE_SETTINGS, message: 'корень должен быть объектом' }],
+        };
+    }
+    const next = desired(data);
+    if (JSON.stringify(next) === JSON.stringify(data))
+        return { actions: [], diagnostics: [] };
+    return { actions: [write(next)], diagnostics: [] };
+}
+function scanToml(text) {
+    const values = new Map();
+    let table = '';
+    for (const raw of text.replace(/\r\n?/g, '\n').split('\n')) {
+        const line = raw.replace(/\s+#.*$/, '').trim();
+        if (line === '' || line.startsWith('#'))
+            continue;
+        const header = /^\[([^[\]]+)\]$/.exec(line);
+        if (header !== null) {
+            table = (header[1] ?? '').trim();
+            continue;
+        }
+        const pair = /^([A-Za-z0-9_.-]+)\s*=\s*(.+)$/.exec(line);
+        if (pair === null)
+            continue;
+        const key = table === '' ? (pair[1] ?? '') : `${table}.${pair[1] ?? ''}`;
+        values.set(key, (pair[2] ?? '').trim());
+    }
+    return values;
+}
+export async function codexMemory(root) {
+    const current = await readOrNull(path.join(root, CODEX_CONFIG));
+    const expected = codexConfig();
+    if (current === null || current.includes(GENERATED_MARK)) {
+        if (current === expected)
+            return { actions: [], diagnostics: [] };
+        return {
+            actions: [{ op: 'write', path: CODEX_CONFIG, content: Buffer.from(expected, 'utf8') }],
+            diagnostics: [],
+        };
+    }
+    const values = scanToml(current);
+    const missing = CODEX_MEMORY_KEYS.filter((key) => values.get(key) !== 'false');
+    if (missing.length === 0)
+        return { actions: [], diagnostics: [] };
+    return {
+        actions: [],
+        diagnostics: [
+            {
+                file: CODEX_CONFIG,
+                message: `написан вручную, memory не выключена: добавь ${missing.map((k) => `${k} = false`).join(', ')}`,
+            },
+        ],
+    };
+}

package/dist/commands/adapters/render.d.ts

@@ -0,0 +1,7 @@
+import type { AgentDef } from './source.ts';
+export declare const GENERATED_MARK = "generated by ai adapters sync";
+export declare const SKILL_MARKER_FILE = ".harness-generated";
+export declare function claudeMd(): string;
+export declare function skillMarker(name: string): string;
+export declare function claudeAgent(agent: AgentDef): string;
+export declare function codexAgent(agent: AgentDef): string;

package/dist/commands/adapters/render.js

@@ -0,0 +1,43 @@
+// expect:claude-md-import
+import { stringify } from 'yaml';
+export const GENERATED_MARK = 'generated by ai adapters sync';
+export const SKILL_MARKER_FILE = '.harness-generated';
+export function claudeMd() {
+    return `<!-- ${GENERATED_MARK} — do not edit, правь AGENTS.md -->\n@AGENTS.md\n`;
+}
+export function skillMarker(name) {
+    return `${GENERATED_MARK} from .agents/skills/${name} — do not edit\n`;
+}
+export function claudeAgent(agent) {
+    const fields = { name: agent.name, description: agent.description };
+    if (agent.tools.length > 0)
+        fields['tools'] = agent.tools.join(', ');
+    if (agent.skills.length > 0)
+        fields['skills'] = agent.skills;
+    if (agent.model !== undefined)
+        fields['model'] = agent.model;
+    const yaml = stringify(fields, { lineWidth: 0 });
+    return `---\n# ${GENERATED_MARK} from ${agent.source} — do not edit\n${yaml}---\n\n${agent.instructions}\n`;
+}
+const tomlString = (value) => JSON.stringify(value);
+function tomlMultiline(value) {
+    const escaped = value
+        .replace(/\\/g, '\\\\')
+        .replace(/"""/g, '""\\"')
+        .replace(/[^]/g, (c) => {
+        const code = c.charCodeAt(0);
+        const control = (code < 0x20 && code !== 0x09 && code !== 0x0a) || code === 0x7f;
+        return control ? `\\u${code.toString(16).padStart(4, '0')}` : c;
+    });
+    return `"""\n${escaped}\n"""`;
+}
+export function codexAgent(agent) {
+    const preface = agent.skills.length > 0 ? `Перед работой загрузи skills: ${agent.skills.join(', ')}.\n\n` : '';
+    return [
+        `# ${GENERATED_MARK} from ${agent.source} — do not edit`,
+        `name = ${tomlString(agent.name)}`,
+        `description = ${tomlString(agent.description)}`,
+        `developer_instructions = ${tomlMultiline(preface + agent.instructions)}`,
+        '',
+    ].join('\n');
+}

package/dist/commands/adapters/source.d.ts

@@ -0,0 +1,21 @@
+import type { Diagnostic } from '#shared/diagnostics';
+import { type AgentDef } from '#lib/agent';
+export type { AgentDef } from '#lib/agent';
+export declare const AGENTS_MD = "AGENTS.md";
+export declare const SKILLS_DIR = ".agents/skills";
+export declare const AGENTS_DIR = ".agents/agents";
+export interface SkillFile {
+    rel: string;
+    content: Buffer;
+}
+export interface Skill {
+    name: string;
+    files: SkillFile[];
+}
+export interface Sources {
+    hasAgentsMd: boolean;
+    skills: Skill[];
+    agents: AgentDef[];
+    diagnostics: Diagnostic[];
+}
+export declare function readSources(root: string): Promise<Sources>;

package/dist/commands/adapters/source.js

@@ -0,0 +1,73 @@
+import { access, readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parseAgent } from '#lib/agent';
+import { errorCode } from '#shared/guards';
+export const AGENTS_MD = 'AGENTS.md';
+export const SKILLS_DIR = '.agents/skills';
+export const AGENTS_DIR = '.agents/agents';
+async function listDir(dir) {
+    try {
+        return (await readdir(dir)).sort();
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+async function readSkill(root, name) {
+    const dir = path.join(root, SKILLS_DIR, name);
+    const entries = await readdir(dir, { recursive: true, withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const abs = path.join(entry.parentPath, entry.name);
+        files.push({
+            rel: path.relative(dir, abs).split(path.sep).join('/'),
+            content: await readFile(abs),
+        });
+    }
+    files.sort((a, b) => (a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0));
+    return { name, files };
+}
+export async function readSources(root) {
+    const diagnostics = [];
+    const hasAgentsMd = await access(path.join(root, AGENTS_MD)).then(() => true, () => false);
+    const skills = [];
+    for (const name of await listDir(path.join(root, SKILLS_DIR))) {
+        const skill = await readSkill(root, name).catch((error) => {
+            if (errorCode(error) === 'ENOTDIR')
+                return null;
+            throw error;
+        });
+        if (skill === null)
+            continue;
+        if (!skill.files.some((f) => f.rel === 'SKILL.md')) {
+            diagnostics.push({
+                file: `${SKILLS_DIR}/${name}`,
+                message: 'нет SKILL.md — не skill, пропущен',
+            });
+            continue;
+        }
+        skills.push(skill);
+    }
+    const agents = [];
+    for (const entry of await listDir(path.join(root, AGENTS_DIR))) {
+        if (!entry.endsWith('.md'))
+            continue;
+        const file = `${AGENTS_DIR}/${entry}`;
+        const report = (message) => {
+            diagnostics.push({ file, message });
+        };
+        const agent = parseAgent(file, await readFile(path.join(root, file), 'utf8'), report);
+        if (agent === null)
+            continue;
+        for (const skill of agent.skills) {
+            if (!skills.some((s) => s.name === skill))
+                report(`skill «${skill}» не найден в ${SKILLS_DIR}`);
+        }
+        agents.push(agent);
+    }
+    return { hasAgentsMd, skills, agents, diagnostics };
+}

package/dist/commands/adapters/sync.d.ts

@@ -0,0 +1,14 @@
+import type { AdapterName, HookKey } from '#shared/config';
+import type { Diagnostic } from '#shared/diagnostics';
+export interface Action {
+    op: 'write' | 'delete';
+    path: string;
+    content?: Buffer;
+}
+export interface SyncResult {
+    actions: Action[];
+    diagnostics: Diagnostic[];
+}
+export declare function computeSync(root: string, adapters: readonly AdapterName[], hooks?: readonly HookKey[]): Promise<SyncResult>;
+export declare function applyActions(root: string, actions: Action[]): Promise<void>;
+export declare function checkAdapters(root: string, adapters: readonly AdapterName[], hooks?: readonly HookKey[]): Promise<Diagnostic[]>;