mister-wolf 1.0.0

package/dist/domain/gates/stop-gate.js

@@ -0,0 +1,125 @@
+/**
+ * Ф23 (слита с Ф18): STOP-гейт — pressure-тесты памяти как барьер автономной
+ * адаптации (спека §5, §3 правило границы (б)). Harness: «стимул-промпт +
+ * wolf call» против детерминированного mock-агента, БЕЗ LLM.
+ *
+ * Критерий чувствительности harness'а: сценарий падает при удалении
+ * delivery-механизма (lookup не доставил знание) и проходит при его наличии.
+ * premature action: действие до wolf call (lookup сломан/не выполнялся).
+ *
+ * Mock-агент — наивный rules-follower с двумя реалистичными режимами отказа:
+ * (а) действует, если адресный запрет не доставлен (regression miss);
+ * (б) воздерживается при виде ЛЮБОГО запрет-паттерна, даже не по адресу
+ * (false positive — зря отказался). Оба режима — вход Layer 4 meta-metrics.
+ */
+import { READ_ONLY_ZONES, assertLearnWriteAllowed } from '../policies/read-only-zones.js';
+/** Запрет-паттерны, на которых наивный агент может передержаться (false positive). */
+const PROHIBITION_RE = /анти-правило|не использ|forbidden|do not use|avoid/i;
+/**
+ * Детерминированный прогон: на каждый сценарий mock-агент сначала делает
+ * wolf call (lookupInjections по topic), затем решает. Брошенный lookup =
+ * действие без знания (prematureAction). Чистая функция.
+ */
+export function runStopGate(lookupInjections, scenarios) {
+    const results = scenarios.map((sc) => {
+        // протокол: wolf call ДО действия (§5); сломанный delivery = вслепую
+        let blocks;
+        let prematureAction = false;
+        try {
+            blocks = lookupInjections(sc.topic);
+        }
+        catch {
+            blocks = [];
+            prematureAction = true;
+        }
+        const knowledge = blocks.join('\n');
+        const targeted = sc.forbidden_tool !== undefined && knowledge.includes(sc.forbidden_tool);
+        const abstained = targeted || PROHIBITION_RE.test(knowledge);
+        if (prematureAction) {
+            return {
+                id: sc.id,
+                passed: false,
+                reason: `действие до wolf call (premature action): знание по теме «${sc.topic}» не получено`,
+                prematureAction: true,
+            };
+        }
+        if (sc.forbidden_tool !== undefined) {
+            return targeted
+                ? {
+                    id: sc.id,
+                    passed: true,
+                    reason: `знание доставлено: агент воздержался от «${sc.forbidden_tool}»`,
+                    prematureAction: false,
+                }
+                : {
+                    id: sc.id,
+                    passed: false,
+                    reason: `delivery не сработал: использован «${sc.forbidden_tool}» без доставленного знания по теме «${sc.topic}»`,
+                    prematureAction: false,
+                };
+        }
+        if (abstained) {
+            return {
+                id: sc.id,
+                passed: false,
+                reason: `отказ без адресного запрета (false positive): зря воздержался по теме «${sc.topic}»`,
+                prematureAction: false,
+            };
+        }
+        return sc.expect_action === true
+            ? { id: sc.id, passed: true, reason: 'запретов не доставлено — действие выполнено', prematureAction: false }
+            : {
+                id: sc.id,
+                passed: false,
+                reason: 'сценарий без forbidden_tool и без expect_action — ожидание не определено',
+                prematureAction: false,
+            };
+    });
+    const total = results.length;
+    const withForbidden = scenarios.filter((sc) => sc.forbidden_tool !== undefined).length;
+    const withoutForbidden = total - withForbidden;
+    const passedCount = results.filter((r) => r.passed).length;
+    const failedNoForbidden = results.filter((r, i) => scenarios[i].forbidden_tool === undefined && !r.passed).length;
+    const passedForbidden = results.filter((r, i) => scenarios[i].forbidden_tool !== undefined && r.passed).length;
+    return {
+        passed: results.every((r) => r.passed),
+        results,
+        metrics: {
+            stop_gate_pass_rate: total > 0 ? passedCount / total : 1,
+            false_positive_rate: withoutForbidden > 0 ? failedNoForbidden / withoutForbidden : 0,
+            regression_detection: withForbidden > 0 ? passedForbidden / withForbidden : 0,
+        },
+    };
+}
+/**
+ * Автосценарий из механического draft'а (constraint_tool + trigger_keywords).
+ * Тема сценария = constraint_tool: реалистичная будущая сессия работает с этим
+ * тулом — и delivery-механизм обязан доставить draft по этой теме. Пустые/чужие
+ * trigger_keywords не мешают построению: сценарий и должен поймать
+ * недоставляемое правило (гейт красный). null — немеханический draft.
+ */
+export function buildScenarioFromDraft(draft) {
+    if (draft.mechanical !== true || typeof draft.constraint_tool !== 'string' || draft.constraint_tool === '') {
+        return null;
+    }
+    return {
+        id: `draft:${String(draft.id ?? 'unknown')}`,
+        stimulus: `${String(draft.title ?? '')}\n${String(draft.body ?? '')}`,
+        topic: draft.constraint_tool,
+        forbidden_tool: draft.constraint_tool,
+    };
+}
+/** Проба зон (part of gate): rewrite в каждую read-only зону обязан бросить. */
+export function zoneProbe() {
+    return READ_ONLY_ZONES.map((z) => {
+        let enforced = false;
+        try {
+            assertLearnWriteAllowed(z.path, 'rewrite');
+        }
+        catch {
+            enforced = true;
+        }
+        return { zone: z.path, enforced };
+    });
+}
+//# sourceMappingURL=stop-gate.js.map

package/dist/domain/gates/stop-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-gate.js","sourceRoot":"","sources":["../../../src/domain/gates/stop-gate.ts"],"names":[],"mappings":"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"}

package/dist/domain/governance.d.ts

@@ -0,0 +1,18 @@
+import type { MemoryStatus } from './memory-types.js';
+export type MemoryClass = 'working' | 'canonical';
+export type TruthRole = 'proposed_knowledge' | 'accepted_knowledge' | 'source_of_truth';
+export type Lifetime = 'long_term' | 'short_term' | 'session';
+export declare function defaultTruthRole(createdBy: string): TruthRole;
+export declare function governanceDefaults(createdBy: string): {
+    memory_class: MemoryClass;
+    truth_role: TruthRole;
+    lifetime: Lifetime;
+};
+export declare function validateGovernance(obj: {
+    memory_class: MemoryClass;
+    truth_role: TruthRole;
+    lifetime: Lifetime;
+}): string[];
+export declare const ALLOWED_TRANSITIONS: Record<MemoryStatus, MemoryStatus[]>;
+export declare function canTransition(from: MemoryStatus, to: MemoryStatus): boolean;
+//# sourceMappingURL=governance.d.ts.map

package/dist/domain/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/domain/governance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAClD,MAAM,MAAM,SAAS,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AACxF,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;AAE9D,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG;IACrD,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAMA;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IACtC,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,MAAM,EAAE,CAMX;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,CAgCpE,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,GAAG,OAAO,CAE3E"}

package/dist/domain/governance.js

@@ -0,0 +1,54 @@
+export function defaultTruthRole(createdBy) {
+    return createdBy.startsWith('agent:') ? 'proposed_knowledge' : 'accepted_knowledge';
+}
+export function governanceDefaults(createdBy) {
+    return {
+        memory_class: 'working',
+        truth_role: defaultTruthRole(createdBy),
+        lifetime: 'long_term',
+    };
+}
+export function validateGovernance(obj) {
+    const warnings = [];
+    if (obj.truth_role === 'source_of_truth' && obj.memory_class !== 'canonical') {
+        warnings.push('source_of_truth requires memory_class canonical.');
+    }
+    return warnings;
+}
+export const ALLOWED_TRANSITIONS = {
+    // resolved/obsolete/answered из active нужны блокерам и вопросам (open-question);
+    // deprecated из active — типу tool (Фаза C); эффективные переходы =
+    // ALLOWED_TRANSITIONS ∩ lifecycle типа.
+    active: [
+        'stale',
+        'superseded',
+        'archived',
+        'conflicting',
+        'completed',
+        'resolved',
+        'obsolete',
+        'answered',
+        'deprecated',
+    ],
+    open: ['resolved', 'rejected', 'archived', 'answered'],
+    resolved: ['archived'],
+    stale: ['active', 'archived'],
+    conflicting: ['active', 'archived'],
+    superseded: [],
+    archived: [],
+    paused: ['active', 'archived'],
+    completed: ['archived'],
+    answered: ['archived'],
+    rejected: ['archived'],
+    obsolete: ['archived'],
+    proposed: ['accepted', 'rejected', 'archived'],
+    accepted: ['active', 'obsolete', 'archived'],
+    // tool (Фаза C): кандидат подтверждается или отбрасывается
+    candidate: ['active', 'deprecated', 'archived'],
+    // реанимация инструмента — deprecated → active разрешена
+    deprecated: ['active', 'archived'],
+};
+export function canTransition(from, to) {
+    return ALLOWED_TRANSITIONS[from].includes(to);
+}
+//# sourceMappingURL=governance.js.map

package/dist/domain/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../src/domain/governance.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAKlD,OAAO;QACL,YAAY,EAAE,SAAS;QACvB,UAAU,EAAE,gBAAgB,CAAC,SAAS,CAAC;QACvC,QAAQ,EAAE,WAAW;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAIlC;IACC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,UAAU,KAAK,iBAAiB,IAAI,GAAG,CAAC,YAAY,KAAK,WAAW,EAAE,CAAC;QAC7E,QAAQ,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAyC;IACvE,kFAAkF;IAClF,oEAAoE;IACpE,wCAAwC;IACxC,MAAM,EAAE;QACN,OAAO;QACP,YAAY;QACZ,UAAU;QACV,aAAa;QACb,WAAW;QACX,UAAU;QACV,UAAU;QACV,UAAU;QACV,YAAY;KACb;IACD,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;IACtD,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,KAAK,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;IACnC,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,SAAS,EAAE,CAAC,UAAU,CAAC;IACvB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;IAC9C,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC;IAC5C,2DAA2D;IAC3D,SAAS,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC;IAC/C,yDAAyD;IACzD,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;CACnC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAkB,EAAE,EAAgB;IAChE,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/domain/mechanical-advice.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ф22 (D2.1): механические советы по классам ошибок — детерминированная таблица,
+ * без LLM (инвариант записи §9). Дефолтный режим генерации draft'ов
+ * propose→validate→activate работает на ней; «обязательный LLM-слой» генерации
+ * отклонён (спека §2.3, §7): LLM подключается позже за интерфейсом DraftGenerator.
+ * Спека: docs/superpowers/specs/2026-08-26-self-learning-design.md §2.3, §7.
+ */
+/** id класса ошибки (DEFAULT_ERROR_CLASS_RULES + 'uncategorized') → императив. */
+export declare const MECHANICAL_ADVICE: Readonly<Record<string, string>>;
+/** Совет по error_class_id; null — класс неизвестен таблице. */
+export declare function mechanicalAdviceFor(errorClassId: string): string | null;
+//# sourceMappingURL=mechanical-advice.d.ts.map

package/dist/domain/mechanical-advice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mechanical-advice.d.ts","sourceRoot":"","sources":["../../src/domain/mechanical-advice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB9D,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEvE"}

package/dist/domain/mechanical-advice.js

@@ -0,0 +1,34 @@
+/**
+ * Ф22 (D2.1): механические советы по классам ошибок — детерминированная таблица,
+ * без LLM (инвариант записи §9). Дефолтный режим генерации draft'ов
+ * propose→validate→activate работает на ней; «обязательный LLM-слой» генерации
+ * отклонён (спека §2.3, §7): LLM подключается позже за интерфейсом DraftGenerator.
+ * Спека: docs/superpowers/specs/2026-08-26-self-learning-design.md §2.3, §7.
+ */
+/** id класса ошибки (DEFAULT_ERROR_CLASS_RULES + 'uncategorized') → императив. */
+export const MECHANICAL_ADVICE = {
+    file_not_found: 'проверяй существование пути перед доступом (existsSync/Glob), не угадывай путь',
+    tool_not_found: 'перед вызовом тула проверяй его наличие (which <tool> / <tool> --version)',
+    dependency_missing: 'проверяй наличие зависимостей до запуска (npm ls / проверка require) и ставь их явно',
+    syntax_error: 'прогоняй компилятор/lint до выполнения и чини синтаксис по первой ошибке',
+    context_overflow: 'не читай файлы целиком без лимита — режь чтение (offset/limit) и сжимай контекст',
+    rate_limit: 'обёртывай внешние вызовы ретраем с backoff при 429/quota',
+    timeout: 'задавай явный timeout и обрабатывай его ретраем с backoff, не жди бесконечно',
+    auth: 'проверяй доступность кредов/токена до вызова защищённого API',
+    network: 'обрабатывай сетевые сбои ретраем с backoff и проверяй достижимость эндпоинта до работы',
+    invalid_input: 'валидируй вход схемой до использования и передавай аргументы в точном формате команды',
+    conflict: 'проверяй существование целевого объекта перед созданием и делай операцию идемпотентной',
+    busy: 'не трогай заблокированный ресурс — дождись освобождения блокировки или обойди её',
+    interrupted: 'обрабатывай SIGINT/SIGTERM корректно и делай длительные операции прерываемыми',
+    disk_full: 'проверяй свободное место и чисти временные файлы перед крупными записями',
+    broken_pipe: 'проверяй живость потребителя вывода и обрабатывай EPIPE без падения процесса',
+    oom: 'не загружай большие данные целиком в память — стрими и обрабатывай частями',
+    llm_error: 'обёртывай LLM-вызовы ретраем при 5xx/overloaded',
+    unsupported: 'не используй неподдерживаемую операцию — найди поддерживаемый аналог в документации',
+    uncategorized: 'извлеки точную причину из сообщения ошибки и заведи класс в error_class_taxonomy проекта',
+};
+/** Совет по error_class_id; null — класс неизвестен таблице. */
+export function mechanicalAdviceFor(errorClassId) {
+    return MECHANICAL_ADVICE[errorClassId] ?? null;
+}
+//# sourceMappingURL=mechanical-advice.js.map

package/dist/domain/mechanical-advice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mechanical-advice.js","sourceRoot":"","sources":["../../src/domain/mechanical-advice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,cAAc,EAAE,gFAAgF;IAChG,cAAc,EAAE,2EAA2E;IAC3F,kBAAkB,EAAE,sFAAsF;IAC1G,YAAY,EAAE,0EAA0E;IACxF,gBAAgB,EAAE,kFAAkF;IACpG,UAAU,EAAE,0DAA0D;IACtE,OAAO,EAAE,8EAA8E;IACvF,IAAI,EAAE,8DAA8D;IACpE,OAAO,EAAE,wFAAwF;IACjG,aAAa,EAAE,uFAAuF;IACtG,QAAQ,EAAE,wFAAwF;IAClG,IAAI,EAAE,kFAAkF;IACxF,WAAW,EAAE,+EAA+E;IAC5F,SAAS,EAAE,0EAA0E;IACrF,WAAW,EAAE,8EAA8E;IAC3F,GAAG,EAAE,4EAA4E;IACjF,SAAS,EAAE,iDAAiD;IAC5D,WAAW,EAAE,qFAAqF;IAClG,aAAa,EAAE,0FAA0F;CAC1G,CAAC;AAEF,gEAAgE;AAChE,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,iBAAiB,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;AACjD,CAAC"}