@shahimat/harness 0.1.0 → 0.2.0

package/README.md

@@ -34,7 +34,7 @@ npx -y @shahimat/harness@<version> <команда> --root .
 ## `context/harness.yml`
 
 ```yaml
-version: 0.1.0
+version: 0.2.0
 adapters: [claude-code, codex]
 checks:
   changelog:

package/dist/checks/context-index.js

@@ -229,36 +229,55 @@ class Collector {
                     this.report(manifest, `index_layers: dir «${String(dir)}» — нужен путь внутри проекта`);
                     continue;
                 }
+                const format = (isRecord(item) ? item['format'] : undefined) ?? 'md';
+                if (format !== 'md' && format !== 'yml') {
+                    this.report(manifest, `index_layers: format «${String(format)}» — md или yml`);
+                    continue;
+                }
                 const taken = layers.find((l) => l.section === section);
                 if (taken !== undefined) {
                     this.report(manifest, `index_layers: section «${section}» уже объявлена в ${taken.manifest}`);
                     continue;
                 }
-                layers.push({ section, dir: dir.replace(/\/+$/, ''), manifest });
+                layers.push({ section, dir: dir.replace(/\/+$/, ''), format, manifest });
             }
         }
         return layers;
     }
     /**
-     * Файл слоя модуля — markdown с frontmatter `id`, `namespace`; строка
-     * индекса — первый `# …`. `id` = путь внутри слоя без `.md`, `/` → `-`.
+     * Файл слоя модуля: `md` — frontmatter `id`, `namespace`, строка индекса —
+     * первый `# …`; `yml` — поля `id`, `namespace`, `summary`. `id` = путь
+     * внутри слоя без расширения, `/` → `-`.
      */
     async collectLayer(layer) {
-        for (const file of await listFiles(this.root, layer.dir, '.md')) {
+        const ext = layer.format === 'md' ? '.md' : '.yml';
+        for (const file of await listFiles(this.root, layer.dir, ext)) {
             let data;
-            const text = await readFile(path.join(this.root, file), 'utf8');
-            try {
-                data = parseFrontmatter(text);
-            }
-            catch (error) {
-                this.report(file, `невалидный frontmatter: ${error.message.split('\n')[0]}`);
-                continue;
+            let title;
+            if (layer.format === 'yml') {
+                data = await this.readYaml(file);
+                if (data === null)
+                    continue;
+                title = this.oneLine(file, data, 'summary');
             }
-            if (data === null) {
-                this.report(file, 'нет frontmatter (id, namespace)');
-                continue;
+            else {
+                const text = await readFile(path.join(this.root, file), 'utf8');
+                try {
+                    data = parseFrontmatter(text);
+                }
+                catch (error) {
+                    this.report(file, `невалидный frontmatter: ${error.message.split('\n')[0]}`);
+                    continue;
+                }
+                if (data === null) {
+                    this.report(file, 'нет frontmatter (id, namespace)');
+                    continue;
+                }
+                title = firstHeading(text);
+                if (title === null)
+                    this.report(file, 'нет заголовка «# …» (одна строка для индекса)');
             }
-            const expected = file.slice(layer.dir.length + 1, -'.md'.length).split('/').join('-');
+            const expected = file.slice(layer.dir.length + 1, -ext.length).split('/').join('-');
             const id = data['id'];
             if (typeof id !== 'string' || id === '') {
                 this.report(file, 'нет поля id');
@@ -267,9 +286,6 @@ class Collector {
             if (id !== expected)
                 this.report(file, `id «${id}» не совпадает с путём «${expected}»`);
             const ns = this.checkNamespace(file, data);
-            const title = firstHeading(text);
-            if (title === null)
-                this.report(file, 'нет заголовка «# …» (одна строка для индекса)');
             if (ns === null)
                 continue;
             const sections = this.namespace(ns).layers;

package/dist/prompt-index.d.ts

@@ -8,6 +8,8 @@ export interface IndexEntry {
     applicableTo: string[];
     patterns: string[];
     title?: string;
+    /** Чем заменён устаревший промпт: ключ или путь замены. */
+    deprecated?: string;
     /** Блок `feature` модуля-возможности — то, что нужно для чеклиста. */
     feature?: FeatureInfo;
     /** Файлы skill: `path` от корня репозитория и SHA-256 каждого. */

package/dist/prompt-index.js

@@ -1,19 +1,21 @@
 import { createHash } from 'node:crypto';
 import { readdir, readFile } from 'node:fs/promises';
 import path from 'node:path';
-import { stringify } from 'yaml';
+import { parse, stringify } from 'yaml';
 import { normalizeEol, parseFrontmatter } from './frontmatter.js';
 export const INDEX_PATH = 'prompts/index.yml';
 const SOURCE_DIRS = ['prompts', 'patterns'];
 const HEADER = '# generated by harness index build — do not edit manually';
 const SKILLS_DIR = 'skills';
 const AGENTS_DIR = 'agents';
+const PRESETS_DIR = 'presets';
 const GROUPS = [
     { kind: 'contract', label: 'contracts' },
     { kind: 'pattern', label: 'patterns' },
     { kind: 'module', label: 'modules' },
     { kind: 'skill', label: 'skills' },
     { kind: 'agent', label: 'agents' },
+    { kind: 'preset', label: 'presets' },
     { kind: 'prompt', label: 'prompts' },
 ];
 /** Поля `feature` во frontmatter; `asks` читается из самого модуля, в индекс не идёт. */
@@ -128,6 +130,9 @@ export async function collectEntries(root) {
         const title = oneLine(fm?.['title'], 'title', file);
         if (title !== undefined)
             entry.title = title;
+        const deprecated = oneLine(fm?.['deprecated'], 'deprecated', file);
+        if (deprecated !== undefined)
+            entry.deprecated = deprecated;
         const feature = parseFeature(fm?.['feature'], kind, file);
         if (feature !== undefined)
             entry.feature = feature;
@@ -135,6 +140,7 @@ export async function collectEntries(root) {
     }
     entries.push(...(await collectSkills(root)), ...(await collectAgents(root)));
     checkFeatureRefs(entries);
+    entries.push(...(await collectPresets(root, entries)));
     return { entries, skipped };
 }
 async function listNames(abs) {
@@ -191,6 +197,53 @@ async function collectSkills(root) {
     }
     return entries;
 }
+/**
+ * Пресет — `presets/<key>.yml`: готовый набор возможностей для типа
+ * проекта. Модули пресета должны быть в индексе и применимы к его контракту.
+ */
+async function collectPresets(root, known) {
+    const entries = [];
+    for (const entry of await listNames(path.join(root, PRESETS_DIR))) {
+        if (!entry.endsWith('.yml'))
+            continue;
+        const file = `${PRESETS_DIR}/${entry}`;
+        const key = entry.slice(0, -4);
+        const content = await readFile(path.join(root, file), 'utf8');
+        let data;
+        try {
+            data = parse(content);
+        }
+        catch (error) {
+            throw new Error(`${file}: невалидный YAML: ${error.message.split('\n')[0]}`, { cause: error });
+        }
+        if (typeof data !== 'object' || data === null || Array.isArray(data))
+            throw new Error(`${file}: корень должен быть объектом`);
+        const preset = data;
+        if (preset['key'] !== key)
+            throw new Error(`${file}: key должно совпадать с именем файла «${key}»`);
+        const title = oneLine(preset['title'], 'title', file);
+        if (title === undefined)
+            throw new Error(`${file}: нет title`);
+        const contract = preset['contract'];
+        if (!known.some((e) => e.kind === 'contract' && e.key === contract)) {
+            throw new Error(`${file}: контракта «${String(contract)}» нет в индексе`);
+        }
+        const modules = preset['modules'];
+        if (!Array.isArray(modules) || modules.length === 0)
+            throw new Error(`${file}: modules — непустой список`);
+        for (const item of modules) {
+            const moduleKey = typeof item === 'object' && item !== null ? item['key'] : undefined;
+            const module = known.find((e) => e.kind === 'module' && e.key === moduleKey);
+            if (module === undefined)
+                throw new Error(`${file}: модуля «${String(moduleKey)}» нет в индексе`);
+            if (!module.applicableTo.includes(String(contract))) {
+                throw new Error(`${file}: модуль «${module.key}» не применим к «${String(contract)}»`);
+            }
+        }
+        entries.push({ kind: 'preset', key, path: file, sha256: sha256(content), applicableTo: [String(contract)], patterns: [], title });
+    }
+    return entries;
+}
 /** Субагент — `agents/<name>.md`: frontmatter name, description, skills, tools + инструкция. */
 async function collectAgents(root) {
     const entries = [];
@@ -222,6 +275,8 @@ export function renderIndex(entries, options) {
             lines.push(`  - key: ${e.key}`, ...(e.title === undefined ? [] : [`    title: ${scalar(e.title)}`]), `    path: ${e.path}`, 
             // У skill raw нет: это каталог, raw — у каждого файла.
             ...(e.files === undefined ? [`    raw: ${options.rawBase}/${e.path}`] : []), `    sha256: ${e.sha256}`);
+            if (e.deprecated !== undefined)
+                lines.push(`    deprecated: ${scalar(e.deprecated)}`);
             if (e.files !== undefined) {
                 lines.push('    files:');
                 for (const f of e.files) {
@@ -230,7 +285,7 @@ export function renderIndex(entries, options) {
             }
             if (e.patterns.length > 0)
                 lines.push(`    patterns: ${flowList(e.patterns)}`);
-            if (e.kind === 'module' && e.applicableTo.length > 0) {
+            if ((e.kind === 'module' || e.kind === 'preset') && e.applicableTo.length > 0) {
                 lines.push(`    applicable_to: ${flowList(e.applicableTo)}`);
             }
             if (e.feature !== undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shahimat/harness",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Harness для проектов на контрактах ai-prompts: генераторы и проверки",
   "license": "MIT",
   "author": "Gevorg Nakhapetyan",