feat: claude-brain — управляющий слой, выделен из Лидерры по ADR-020

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-15 08:06:08 +03:00
commit 397777089e
1107 changed files with 336010 additions and 0 deletions
@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/**
+ * plan-steps-parse (C2, §5) — план markdown → [{op,object,ref}]. fail-CLOSE на любой брак.
+ * Reject op:'Task' (VA-4). Канон object: файлы → repo-relative POSIX (SE-5). ref обязателен (SE-1).
+ */
+const BLOCK_RE = /```steps-json\s*\n([\s\S]*?)\n```/;
+const FILE_OPS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+
+/** Достать содержимое блока ```steps-json``` или null. */
+export function extractStepsBlock(md) {
+  const m = String(md == null ? '' : md).match(BLOCK_RE);
+  return m ? m[1] : null;
+}
+
+/**
+ * Канон формы object для файловых op — repo-relative POSIX (SE-5): только backslash→slash,
+ * БЕЗ абсолютизации. Стабильная, cwd-независимая форма для хранения в печати; реальная
+ * нормализация для матча — pathNormalize в actionMatchesStep (plan-lock.mjs) на ОБЕ стороны
+ * (шаг И событие) во время матча. Класть сюда pathNormalize нельзя: он cwd-зависим/абсолютен,
+ * печать ставится в cwd хука-судьи, а матч — в cwd стены (рассинхрон).
+ */
+function canonObject(op, object) {
+  const s = String(object ?? '');
+  return FILE_OPS.has(op) ? s.replace(/\\/g, '/') : s;
+}
+
+/** Распарсить + провалидировать шаги. Бросает на брак (fail-CLOSE). */
+export function parsePlanSteps(md) {
+  const raw = extractStepsBlock(md);
+  if (raw == null) throw new Error('plan-steps-parse: нет блока ```steps-json``` (fail-CLOSE)');
+  let arr;
+  try { arr = JSON.parse(raw); } catch { throw new Error('plan-steps-parse: блок не валидный JSON (fail-CLOSE)'); }
+  if (!Array.isArray(arr) || arr.length === 0) throw new Error('plan-steps-parse: ожидался непустой массив');
+  return arr.map((s, i) => {
+    if (!s || typeof s !== 'object') throw new Error(`plan-steps-parse: шаг ${i} не объект`);
+    const op = String(s.op || '');
+    const object = String(s.object ?? '');
+    const ref = String(s.ref ?? '');
+    if (!op) throw new Error(`plan-steps-parse: шаг ${i} без op`);
+    if (op === 'Task') throw new Error('plan-steps-parse: op:Task запрещён (субагенты, VA-4)');
+    if (!object.trim()) throw new Error(`plan-steps-parse: шаг ${i} без object`);
+    if (!ref.trim()) throw new Error(`plan-steps-parse: шаг ${i} без ref (closed-door, SE-1)`);
+    return { op, object: canonObject(op, object), ref };
+  });
+}