@shahimat/harness 0.1.0 → 0.3.0

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.3.0",
   "description": "Harness для проектов на контрактах ai-prompts: генераторы и проверки",
   "license": "MIT",
   "author": "Gevorg Nakhapetyan",
@@ -33,6 +33,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./expect": {
+      "types": "./dist/expect/index.d.ts",
+      "import": "./dist/expect/index.js"
     }
   },
   "files": [
@@ -46,6 +50,7 @@
     "prepublishOnly": "npm run typecheck && npm test && npm run build"
   },
   "dependencies": {
+    "ajv": "^8.20.0",
     "yaml": "^2.9.1"
   },
   "devDependencies": {
@@ -55,5 +60,13 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "peerDependencies": {
+    "vitest": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
   }
 }