@shahimat/ai-core 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 Свежее сверху. Одна версия — список новых команд и проверок.
 
+## 0.1.1
+
+- Дельта, попавшая в коммит после сбоя сессии, закрывается: пункт
+  засчитывается, если цель изменена в коммитах с появления дельты;
+  `delta check` предупреждает о закоммиченной дельте.
+- `delta check --name` и `delta close --name`: нарушения в чужих дельтах
+  — предупреждение со списком файлов, а не провал.
+- Дельта не прошла схему — ошибка схемы идёт первой, производные
+  нарушения «без revise» по её целям свёрнуты в одну строку.
+- peer `vitest` — `>=3`: проекты на vitest 3 ставятся без ERESOLVE.
+
 ## 0.1.0
 
 - `delta close --name <дельта>` закрывает только эту дельту: чужая

package/README.md

@@ -89,9 +89,13 @@ Mutation — `context index`, `adapters sync`, `delta close`,
 - `ai delta check | close` — дельта проектной документации в
   `context/.delta/*.yml` (пункты `add` / `refine` / `revise`). `check`
   сверяет слои документации с `HEAD`: удалённое или изменённое знание
-  без пункта `revise` — нарушение. `close` после приёмки (check чист,
-  пункты выполнены) удаляет дельту и печатает строки `revise` для тела
-  коммита.
+  без пункта `revise` — нарушение; дельта не прошла схему — её ошибка
+  первой, производные нарушения по её целям свёрнуты. `close` после
+  приёмки (check чист, пункты выполнены) удаляет дельту и печатает
+  строки `revise` для тела коммита. `--name <дельта>` сужает обе
+  команды до одной дельты: нарушения чужих — предупреждение. Дельта,
+  попавшая в коммит, — предупреждение; её пункт засчитывается, если цель
+  изменена в коммитах с появления дельты.
 - `ai role run <name> --file <задание> [--out <ответ>]` — роль из
   `.agents/agents/<name>.md` (в источнике — `agents/<name>.md`)
   headless: текст задания — на stdin, итог — сообщением протокола в

package/dist/commands/delta/delta.d.ts

@@ -91,6 +91,7 @@ export interface DeltaResult {
     revisions: Revision[];
     changed: Set<string>;
     diagnostics: Diagnostic[];
+    warnings: Diagnostic[];
     accepted: Accepted[];
 }
 export declare const ACCEPTED_FILE = "context/.delta/.accepted.json";

package/dist/commands/delta/delta.js

@@ -137,7 +137,13 @@ function isDeltaBody(v) {
         Array.isArray(v['items']) &&
         v['items'].every(isDeltaItem));
 }
-async function readDeltas(root, diagnostics) {
+function targetsOf(data) {
+    const items = isRecord(data) ? data['items'] : undefined;
+    if (!Array.isArray(items))
+        return [];
+    return items.flatMap((i) => isRecord(i) && typeof i['target'] === 'string' ? [i['target']] : []);
+}
+async function readDeltas(root, diagnostics, broken) {
     let names = [];
     try {
         names = (await readdir(path.join(root, DELTA_DIR))).filter((f) => /\.ya?ml$/.test(f)).sort();
@@ -165,6 +171,7 @@ async function readDeltas(root, diagnostics) {
         if (issues.length > 0) {
             for (const i of issues)
                 diagnostics.push({ file, message: `${i.path || '/'} ${i.message}`.trim() });
+            broken.push({ file, targets: targetsOf(data) });
             continue;
         }
         if (!isDeltaBody(data))
@@ -214,7 +221,8 @@ export async function checkDelta(root) {
     if (!git(root, ['rev-parse', '--verify', 'HEAD']).ok)
         throw new UsageError('delta: нужен git-репозиторий с коммитом HEAD');
     const diagnostics = [];
-    const deltas = await readDeltas(root, diagnostics);
+    const broken = [];
+    const deltas = await readDeltas(root, diagnostics, broken);
     const roots = await docRoots(root);
     const status = git(root, ['diff', '--name-status', '--no-renames', 'HEAD', '--', ...roots]).out;
     const untracked = git(root, ['ls-files', '--others', '--exclude-standard', '--', ...roots]).out;
@@ -241,9 +249,15 @@ export async function checkDelta(root) {
         ...deltas.flatMap((d) => d.items.filter((i) => i.op === 'revise')).map((i) => i.target),
         ...accepted.map((a) => a.target),
     ];
+    const hidden = new Map();
     for (const r of revisions) {
         if (revise.some((t) => matchesTarget(t, r.file)))
             continue;
+        const cause = broken.find((b) => b.targets.some((t) => matchesTarget(t, r.file)));
+        if (cause !== undefined) {
+            hidden.set(cause.file, (hidden.get(cause.file) ?? 0) + 1);
+            continue;
+        }
         diagnostics.push({
             file: r.file,
             message: r.deleted
@@ -251,12 +265,39 @@ export async function checkDelta(root) {
                 : `изменено существующее знание без пункта revise в дельте: ${r.lost.join('; ')}`,
         });
     }
-    return { deltas, revisions, changed, diagnostics, accepted };
+    for (const [file, n] of hidden)
+        diagnostics.push({
+            file,
+            message: `дельта не прошла схему — нарушения «без revise» по её целям (${n}) скрыты как следствие; исправь схему`,
+        });
+    const warnings = committedDeltas(root).map((file) => ({
+        file,
+        message: `дельта попала в коммит — закрой её: ai delta close --name ${deltaName(file)}; пункты, выполненные в коммитах после её появления, засчитываются`,
+    }));
+    return { deltas, revisions, changed, diagnostics, warnings, accepted };
+}
+const deltaName = (file) => path.posix.basename(file).replace(/\.ya?ml$/, '');
+function committedDeltas(root) {
+    return git(root, ['ls-files', '--', DELTA_DIR])
+        .out.split('\n')
+        .filter((f) => /\.ya?ml$/.test(f));
+}
+function committedSince(root, file) {
+    const added = git(root, ['log', '--diff-filter=A', '--format=%H', '-1', '--', file]).out.trim();
+    if (added === '')
+        return [];
+    const range = git(root, ['rev-parse', '--verify', '-q', `${added}^`]).ok
+        ? `${added}^..HEAD`
+        : 'HEAD';
+    return git(root, ['log', '--format=', '--name-only', '--no-renames', range])
+        .out.split('\n')
+        .filter((f) => f !== '' && isDoc(f));
 }
 export function unfinishedItems(root, result, deltas = result.deltas) {
     const out = [];
-    const touched = [...result.changed, ...result.revisions.map((r) => r.file)];
     for (const d of deltas) {
+        const committed = committedSince(root, d.file);
+        const touched = [...result.changed, ...result.revisions.map((r) => r.file), ...committed];
         d.items.forEach((item, i) => {
             const done = isDeltaTarget(item.target) ||
                 (item.op === 'add'

package/dist/commands/delta/index.js

@@ -1,25 +1,32 @@
+import { existsSync } from 'node:fs';
 import { mkdir, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { ACCEPTED_FILE, acceptedOf, checkDelta, matchesTarget, revisionLines, unfinishedItems, } from './delta.js';
 import { DELTA_DIR } from '#shared/layout';
 import { UsageError } from '#shared/diagnostics';
-import { report } from '#shared/report';
+import { report, warn } from '#shared/report';
 export async function runDelta(command, args) {
     if (command !== 'check' && command !== 'close')
         throw new UsageError(`неизвестная команда: delta ${command ?? ''}`.trimEnd());
     const result = await checkDelta(args.root);
-    for (const line of revisionLines(result.deltas))
+    const ownFile = args.name === undefined ? undefined : `${DELTA_DIR}/${args.name}.yml`;
+    const isForeign = (d) => ownFile !== undefined && d.file.startsWith(`${DELTA_DIR}/`) && d.file !== ownFile;
+    const foreign = result.diagnostics.filter(isForeign);
+    const errors = result.diagnostics.filter((d) => !isForeign(d));
+    warn(result.warnings);
+    if (foreign.length > 0) {
+        warn(foreign);
+        const files = new Set(foreign.map((d) => d.file)).size;
+        console.error(`дельты прошлых сессий с нарушениями (${files}): исправь их или удали, если их сессии не продолжатся — сессию ${args.name ?? ''} они не валят`);
+    }
+    const own = ownFile === undefined ? result.deltas : result.deltas.filter((d) => d.file === ownFile);
+    for (const line of revisionLines(own))
         console.log(line);
     if (command === 'check')
-        return report('delta check', result.diagnostics);
-    const own = args.name === undefined
-        ? result.deltas
-        : result.deltas.filter((d) => d.file === `${DELTA_DIR}/${args.name ?? ''}.yml`);
-    if (args.name !== undefined && own.length === 0)
-        return report('delta close', [
-            { file: `${DELTA_DIR}/${args.name}.yml`, message: 'дельты нет — закрывать нечего' },
-        ]);
-    const diagnostics = [...result.diagnostics, ...unfinishedItems(args.root, result, own)];
+        return report('delta check', errors);
+    if (ownFile !== undefined && own.length === 0 && !existsSync(path.join(args.root, ownFile)))
+        return report('delta close', [{ file: ownFile, message: 'дельты нет — закрывать нечего' }]);
+    const diagnostics = [...errors, ...unfinishedItems(args.root, result, own)];
     if (diagnostics.length > 0)
         return report('delta close', diagnostics);
     const still = result.revisions.map((r) => r.file);

package/dist/registry.js

@@ -43,6 +43,7 @@ export const COMMAND_NODES = [
         path: ['delta', 'check'],
         kind: 'command',
         effect: 'query',
+        options: '[--name <дельта>]',
         run: (args) => runDelta('check', args),
     },
     {

package/dist/shared/report.d.ts

@@ -1,2 +1,3 @@
 import { type Diagnostic } from './diagnostics.ts';
 export declare function report(label: string, diags: Diagnostic[]): number;
+export declare function warn(diags: Diagnostic[]): void;

package/dist/shared/report.js

@@ -9,3 +9,7 @@ export function report(label, diags) {
     console.error(`${label}: нарушений ${diags.length}`);
     return 1;
 }
+export function warn(diags) {
+    for (const d of diags)
+        console.error(`предупреждение: ${formatDiagnostic(d)}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shahimat/ai-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Команды для проектов на контрактах ai-prompts: генераторы, проверки, механизм ожиданий и роли",
   "license": "MIT",
   "author": "Gevorg Nakhapetyan",
@@ -65,14 +65,14 @@
     "@types/node": "^24.19.2",
     "typescript": "^7.0.2",
     "vitest": "^5.0.4",
-    "@shahimat/cli": "0.1.0"
+    "@shahimat/cli": "0.1.1"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
-    "vitest": ">=4"
+    "vitest": ">=3"
   },
   "peerDependenciesMeta": {
     "vitest": {