mister-wolf 2.22.1 → 2.23.1

package/dist/app/use-cases/usage-signal.js

@@ -0,0 +1,169 @@
+/**
+ * A1.1: чистый маппинг записи usage-источника (assistant-turn OpenCode 2.2.5) в
+ * событие `run` существующей схемы SignalEvent и агрегация run-итогов.
+ * Пишутся только поля SignalEventSchema (ADR-6): схема памяти не расширяется.
+ * Дизайн: docs/dev/2026-10-31-a1-1-measurements/design.md.
+ */
+import { createHash } from 'crypto';
+export const USAGE_SOURCE_LIMITATIONS = [
+    'model variant is not carried over (no field in the signal schema)',
+    'reasoning and cache.write have undocumented semantics and are not added to output/cache_read or weighted',
+    'cost is not computed (the source has no pricing table)',
+    'task_id comes only from an explicit session-to-task map',
+    'attempt exists only when the source recorded a retry',
+    'duration_ms is turn wall-clock time, not answer length',
+    'unfinished turns (no completed timestamp) are not imported',
+    'an empty event set means unknown coverage, not zero usage',
+];
+/** Детерминированный id события: sha256("opencode-usage:v1|"+messageId), первые 32 hex. */
+export function usageEventId(messageId) {
+    return createHash('sha256').update(`opencode-usage:v1|${messageId}`).digest('hex').slice(0, 32);
+}
+function modelRef(id, providerId) {
+    if (!id)
+        return null;
+    return providerId ? `${providerId}/${id}` : id;
+}
+/**
+ * null — turn не завершён (нет completedMs) или нет session_id; иначе событие run.
+ */
+export function signalFromTurn(turn, ctx) {
+    const { completedMs, createdMs } = turn;
+    if (completedMs == null || !turn.sessionId)
+        return null;
+    const agent = turn.agent || ctx?.sessionAgent || null;
+    const modelId = modelRef(turn.modelId, turn.providerId) ?? modelRef(ctx?.sessionModel?.id, ctx?.sessionModel?.providerID);
+    const event = {
+        ts: new Date(completedMs).toISOString(),
+        event: 'run',
+        schema_version: 2,
+        session_id: turn.sessionId,
+        run_id: turn.sessionId,
+        event_id: usageEventId(turn.messageId),
+        gen_ai: { modelID: modelId, agent },
+        orchestration: { task: null, actor: agent ? `agent:${agent}` : 'opencode:unknown' },
+    };
+    if (ctx?.traceId)
+        event.trace_id = ctx.traceId;
+    if (ctx?.taskId)
+        event.task_id = ctx.taskId;
+    if (turn.attempt != null)
+        event.attempt = turn.attempt;
+    if (turn.tokens) {
+        const { input, output, cacheRead } = turn.tokens;
+        event.tokens = { input, output, cache_read: cacheRead };
+        event.weighted = input + 0.1 * cacheRead + 5 * output;
+    }
+    if (createdMs != null && completedMs - createdMs >= 0) {
+        event.duration_ms = completedMs - createdMs;
+    }
+    if (turn.finish === 'stop' || turn.finish === 'tool-calls')
+        event.outcome = 'ok';
+    else if (turn.finish === 'error')
+        event.outcome = 'error';
+    return event;
+}
+/** Агрегация по run_id; порядок — по возрастанию первого ts. */
+export function summarizeRuns(events, runs) {
+    const runById = new Map();
+    for (const run of runs)
+        runById.set(run.sessionId, run);
+    const groups = new Map();
+    for (const ev of events) {
+        const runId = ev.run_id ?? ev.session_id;
+        if (!runId)
+            continue;
+        const group = groups.get(runId);
+        if (group)
+            group.push(ev);
+        else
+            groups.set(runId, [ev]);
+    }
+    for (const run of runs) {
+        if (!groups.has(run.sessionId))
+            groups.set(run.sessionId, []);
+    }
+    const ordered = [];
+    for (const [runId, group] of groups) {
+        const run = runById.get(runId);
+        ordered.push({
+            ts: group[0]?.ts ?? (run?.createdMs != null ? new Date(run.createdMs).toISOString() : ''),
+            summary: summarizeRun(runId, group, run),
+        });
+    }
+    ordered.sort((a, b) => (a.ts === b.ts ? a.summary.runId.localeCompare(b.summary.runId) : a.ts.localeCompare(b.ts)));
+    return ordered.map((entry) => entry.summary);
+}
+function summarizeRun(runId, group, run) {
+    const unknowns = [];
+    const firstString = (pick) => {
+        for (const ev of group) {
+            const value = pick(ev);
+            if (typeof value === 'string' && value !== '')
+                return value;
+        }
+        return null;
+    };
+    const taskIds = new Set();
+    for (const ev of group) {
+        if (typeof ev.task_id === 'string' && ev.task_id !== '')
+            taskIds.add(ev.task_id);
+    }
+    const taskId = taskIds.size === 1 ? ([...taskIds][0] ?? null) : null;
+    if (!taskId)
+        unknowns.push('task-unknown');
+    const attemptSet = new Set();
+    for (const ev of group) {
+        if (typeof ev.attempt === 'number')
+            attemptSet.add(ev.attempt);
+    }
+    const attempts = [...attemptSet].sort((a, b) => a - b);
+    if (attempts.length === 0)
+        unknowns.push('attempt-unknown');
+    let tokens = null;
+    for (const ev of group) {
+        if (!ev.tokens)
+            continue;
+        tokens = tokens ?? { input: 0, output: 0, cacheRead: 0 };
+        tokens.input += ev.tokens.input;
+        tokens.output += ev.tokens.output;
+        tokens.cacheRead += ev.tokens.cache_read;
+    }
+    if (!tokens)
+        unknowns.push('tokens-unknown');
+    let generationMs = null;
+    for (const ev of group) {
+        if (typeof ev.duration_ms !== 'number')
+            continue;
+        generationMs = (generationMs ?? 0) + ev.duration_ms;
+    }
+    if (generationMs === null)
+        unknowns.push('duration-unknown');
+    const outcomes = { ok: 0, error: 0, unknown: 0 };
+    for (const ev of group) {
+        if (ev.outcome === 'ok')
+            outcomes.ok += 1;
+        else if (ev.outcome === 'error')
+            outcomes.error += 1;
+        else
+            outcomes.unknown += 1;
+    }
+    if (group.length === 0)
+        unknowns.push('no-events');
+    return {
+        runId,
+        sessionId: firstString((ev) => ev.session_id) ?? run?.sessionId ?? runId,
+        traceId: firstString((ev) => ev.trace_id),
+        taskId,
+        attempts: attempts.length > 0 ? attempts : null,
+        model: firstString((ev) => ev.gen_ai.modelID),
+        agent: firstString((ev) => ev.gen_ai.agent),
+        tokens,
+        generationMs,
+        busyMs: run?.busyMs ?? null,
+        events: group.length,
+        outcomes,
+        unknowns,
+    };
+}
+//# sourceMappingURL=usage-signal.js.map

package/dist/app/use-cases/usage-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-signal.js","sourceRoot":"","sources":["../../../src/app/use-cases/usage-signal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAiEpC,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,mEAAmE;IACnE,0GAA0G;IAC1G,wDAAwD;IACxD,yDAAyD;IACzD,sDAAsD;IACtD,wDAAwD;IACxD,4DAA4D;IAC5D,2DAA2D;CAC5D,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,QAAQ,CAAC,EAA6B,EAAE,UAAqC;IACpF,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACrB,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAe,EACf,GAMC;IAED,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACxC,IAAI,WAAW,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAExD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,YAAY,IAAI,IAAI,CAAC;IACtD,MAAM,OAAO,GACX,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAE5G,MAAM,KAAK,GAAgB;QACzB,EAAE,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE;QACvC,KAAK,EAAE,KAAK;QACZ,cAAc,EAAE,CAAC;QACjB,UAAU,EAAE,IAAI,CAAC,SAAS;QAC1B,MAAM,EAAE,IAAI,CAAC,SAAS;QACtB,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QACtC,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;QACnC,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE;KACpF,CAAC;IAEF,IAAI,GAAG,EAAE,OAAO;QAAE,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/C,IAAI,GAAG,EAAE,MAAM;QAAE,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;IAC5C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;QAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAEvD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACjD,KAAK,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QACxD,KAAK,CAAC,QAAQ,GAAG,KAAK,GAAG,GAAG,GAAG,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC;IACxD,CAAC;IAED,IAAI,SAAS,IAAI,IAAI,IAAI,WAAW,GAAG,SAAS,IAAI,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9C,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY;QAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;SAC5E,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;QAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAE1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,IAAgB;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,UAAU,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;YACrB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,GAA+C,EAAE,CAAC;IAC/D,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,KAAoB,EAAE,GAAyB;IAClF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,WAAW,GAAG,CAAC,IAAoD,EAAiB,EAAE;QAC1F,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;YACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAC,OAAO,KAAK,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE3C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ;YAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE5D,IAAI,MAAM,GAAyB,IAAI,CAAC;IACxC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE,CAAC,MAAM;YAAE,SAAS;QACzB,MAAM,GAAG,MAAM,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAClC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAE7C,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ;YAAE,SAAS;QACjD,YAAY,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC;IACtD,CAAC;IACD,IAAI,YAAY,KAAK,IAAI;QAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACjD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI;YAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;aACrC,IAAI,EAAE,CAAC,OAAO,KAAK,OAAO;YAAE,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;;YAChD,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEnD,OAAO;QACL,KAAK;QACL,SAAS,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,GAAG,EAAE,SAAS,IAAI,KAAK;QACxE,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACzC,MAAM;QACN,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAC/C,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7C,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3C,MAAM;QACN,YAAY;QACZ,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ;QACR,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mister-wolf",
-  "version": "2.22.1",
+  "version": "2.23.1",
   "description": "Local-first project memory for AI coding agents: decisions, lessons, tools and processes that outlive the session",
   "keywords": [
     "ai-agents",

package/templates/base/agents/mr-wolf.md

@@ -29,8 +29,11 @@ git-метаданные, веб), не для исполнения работы
 ## Контекст-бюджет уровня L0
 
 - Только метаданные: брифы, решения, отчёты, вердикты. Кода не касается.
+  Содержательное изучение материалов задачи, включая документацию и репозиторий,
+  — тоже исполнение через L1. Read-only, Markdown, информационный вопрос и малый
+  объём не дают L0 исключения из роли.
 - Не выполняй реализацию и не выдавай непроверенные детали кода за факт.
-  Объяснять пользователю поведение системы, причины решений и последствия
+  Объяснять пользователю ход работы, причины решений и последствия
   изменений по проверенным материалам исполнителей — твоя обязанность.
 - Раскукоженный Mr.Wolf (сам собирает, тестирует, правит) = утечка
   исполнения наверх: запустил сам — потерял право вердикть по отчёту.
@@ -86,8 +89,12 @@ Wolf. Не считай их уроками, жалобами или утвер
 загрузи через механизм скиллов; не считай краткое описание методикой.
 Проверяй применимость перед ответом/действием при новом запросе, смене цели
 или этапа. Не загружай ту же актуальную инструкцию на каждом сообщении.
-Новая разработка или существенное изменение поведения требуют
-wolf-brainstorm ДО вопросов о требованиях, проектирования и реализации;
+Новая идея, разработка, существенное изменение или новое содержательное
+поручение (изучить, сравнить, написать документ) требуют wolf-brainstorm
+ДО исследования предмета, диспетча, требований и реализации. Сначала сделай
+понимание цели видимым пользователю и дай его поправить по гейту скилла;
+прямое поручение сокращает разговор, не отменяет сверку. Продолжение уже
+подтверждённой цели и готовый ответ из контекста не требуют нового опроса;
 баг — wolf-debug, заявление о готовности — verification-before-completion.
 
 Для новой самостоятельной цели разработки сначала сверь существующие
@@ -103,9 +110,12 @@ wolf-brainstorm ДО вопросов о требованиях, проекти
 
 ## Процедура
 
-1. **Прояснение по wolf-brainstorm** при новой потребности: цель,
-   проверяемые критерии, ограничения, scope; спрашивай только существенное
-   недостающее, не запускай опрос для уже известного.
+1. **Общее понимание по wolf-brainstorm**: помоги сформулировать намерение,
+   объясни существенные подходы и последствия по wolf-explain. При готовом
+   поручении достаточно короткой сверки результата; не подменяй его разработкой
+   новой системы. Готовность определяет понимание, а не число вопросов.
+   После согласованного перехода организуй требования либо прямо порученный
+   результат; не начинай повторное прояснение неизменившегося.
 2. **Бриф и диспетч**: контекст (2–5 предложений), критерии приёмки
    (каждый проверяем по отчёту, без чтения кода), команда валидации,
    scope. Диспетчеризуй `executor-lead`.
@@ -171,7 +181,10 @@ wolf-brainstorm ДО вопросов о требованиях, проекти
 ## Общение с пользователем
 
 Ты отвечаешь за понимание пользователем цели, результата и следующего шага.
-Точные машинные статусы предназначены агентам; человеку объясняй их значение.
+Говори понятным человеческим языком: кто что делает, почему это нужно
+для цели и что меняется для пользователя. Точные машинные статусы предназначены
+агентам; человеку объясняй их значение. Реплика продолжает разговор без
+повторного пересказа всего контекста; итоговый ответ должен быть самостоятельным.
 Сначала отвечай на вопрос, затем раскрывай необходимые причины, последствия
 и ограничения. Технически опытный пользователь не обязан знать внутренний
 сленг Wolf. Сохраняй точность, но поясняй нужные термины.

package/templates/base/skills/finishing-a-development-branch/SKILL.md

@@ -12,6 +12,8 @@ L1 проверяет выполненный scope, ACCEPTANCE и текущие
 Загрузи полный текст назначенной методики до её выполнения. Обязательные пункты отслеживай в доступном трекере или рабочем брифе; не добавляй новые статусы памяти. Недоступное действие передай ответственному уровню.
 
 
+Уборка и завершение — гейт G9 по `wolf-git` и §15 регламента.
+
 ## Предусловия
 
 Ответственный — L1 с действующими правами. Проверь ACCEPTANCE/ограничения, валидные проверки, project base branch, worktree list и состояние рабочей копии. Сохрани task branch, абсолютный worktree path, base/head и uncommitted/untracked до переключений. Не повторяй full check, если evidence всё ещё применимо; объединённый результат требует проверки.

package/templates/base/skills/using-git-worktrees/SKILL.md

@@ -12,6 +12,8 @@ L0 поручает подготовку L1; L2 получает готовую
 Загрузи полный текст назначенной методики до её выполнения. Обязательные пункты отслеживай в доступном трекере или рабочем брифе; не добавляй новые статусы памяти. Недоступное действие передай ответственному уровню.
 
 
+Git-этапы задачи ведутся по `wolf-git`; baseline и ownership ниже не меняются.
+
 ## Владелец
 
 Создание, настройка и git-операции — L1 либо разрешённая исполнительская роль. L2 получает готовые cwd, branch и allowlist. Следуй профилю проекта; local .worktrees/<task> — рекомендуемый fallback, не универсальный запрет других путей.

package/templates/base/skills/using-skills/SKILL.md

@@ -7,7 +7,7 @@ description: "Применять L0/L1 в начале общения и пер
 
 ## Сначала методика, затем действие
 
-Перед ответом или действием проверь, какие скиллы требуются текущим запросом и стадией работы. Сначала загрузи применимые процессные скиллы, затем задавай вопросы, исследуй, планируй и назначай исполнение. Уточняющие вопросы о новой разработке уже являются работой по wolf-brainstorm.
+Перед ответом или действием проверь, какие скиллы требуются текущим запросом и стадией работы. Сначала загрузи применимые процессные скиллы, затем задавай вопросы, исследуй, планируй и назначай исполнение. Новая содержательная цель сначала проходит сверку понимания по wolf-brainstorm; его вход не требует автоматически писать требования. Продолжение уже согласованной цели не запускает этот этап заново.
 
 Описание скилла, его название и память о прошлой версии не заменяют полный текст. Если есть обоснованное сомнение в применимости — загрузи и проверь; неподходящую методику выполнять не обязан. Не перебирай весь каталог. Для следующего сообщения той же стадии применяй уже загруженный актуальный текст. Заново оцени процесс при новой цели, изменении условий, баге или переходе этапа; повторная загрузка нужна при новой методике, смене версии или утрате инструкции из контекста.
 
@@ -17,7 +17,7 @@ description: "Применять L0/L1 в начале общения и пер
 
 ## Полномочия и действующие ограничения
 
-L0 держит цель, общается с пользователем, назначает процесс, принимает по отчётам и для поставки вызывает только executor-агентов; служебный steward допускается лишь в явно разрешённом рамкой контуре. L1 фиксирует режим, декомпозирует, управляет L2, интегрирует и выполняет разрешённые git-операции. L2 выполняет одну назначенную подзадачу, читает необходимые источники, пишет только allowlist, не спавнит и не коммитит. Недоступность инструмента не расширяет роль.
+L0 держит цель, общается с пользователем, назначает процесс, принимает по отчётам и для поставки вызывает только executor-агентов; служебный steward допускается лишь в явно разрешённом рамкой контуре. L1 фиксирует режим, декомпозирует, управляет L2, интегрирует и выполняет разрешённые git-операции. L2 выполняет одну назначенную подзадачу, читает необходимые источники, пишет только allowlist, не спавнит и не коммитит. Недоступность инструмента не расширяет роль. Содержательное изучение материалов и проверка фактов задачи — исполнение через L1, даже если это read-only, Markdown или небольшой информационный вопрос; L0 использует доставленные метаданные и не придумывает исключение по формату файла.
 
 L2 не запускает заново продуктовый discovery и не выбирает организацию процесса. Он читает назначенные скиллы до исполнения; недостающую методику или противоречие передаёт L1. Назначенную дисциплину выполняет в конечном мандате; неожиданная сложность,
 новая гипотеза/способ или решение вне TASK → результат и вопрос L1 сразу,
@@ -58,19 +58,21 @@ wolf-debug: один осмысленный обход в scope, затем FRIC
 
 | Ситуация | Обязательная методика и результат |
 | --- | --- |
-| «Хочу разработать / добавить / изменить поведение» | wolf-brainstorm до вопросов о требованиях и до проектирования; требования либо разрешённый короткий бриф |
+| Новая идея, разработка или существенное изменение | wolf-brainstorm: сначала общее понимание, затем выбранный результат; требования/бриф — при переходе к разработке |
+| Новое поручение изучить, сравнить или подготовить документ | Короткая сверка намерения по wolf-brainstorm до исследования и диспетча; после подтверждения — ограниченное исполнение без обязательного пакета требований |
 | «Спланируй новую возможность» без утверждённых требований | Сначала wolf-brainstorm; планирование не заменяет прояснение цели |
 | Утверждённые требования; FULL или новые контракты | wolf-design; затем после нужного утверждения wolf-plan и wolf-testplan |
 | Утверждённый план, входы сверены | L1: wolf-sdd; разрешённая исполнительская роль без диспетчеризации: wolf-execute |
 | Баг, падение проверки, неожиданное поведение | wolf-debug до исправления; реализация нового поведения/фикса — test-driven-development |
 | Требуется изоляция записи | using-git-worktrees перед изменениями |
+| Git-граница задачи: вход/возобновление, ветка, checkpoint, передача, завершение | wolf-git |
 | Ревью документов / ревью кода | wolf-review / requesting-code-review; обработка замечаний — receiving-code-review |
 | «Готово», «исправлено», «проверено» | verification-before-completion до утверждения; затем согласованный finishing-a-development-branch |
 | Смена сессии, исполнителя или восстановление | wolf-handoff |
 | Создание/изменение методики / внешний пакет | writing-skills / wolf-skill-intake |
 | Ответ Вольфа человеку | wolf-explain; не заменяет процесс и проверки |
 
-Процессные скиллы идут раньше исполнительских. Условия FULL/LITE/FIX определяют объём, а не разрешают не загружать нужную методику. Уже утверждённую неизменившуюся задачу не возвращай в брейншторм. Информационный вопрос о существующем состоянии не превращай автоматически в новую разработку.
+Процессные скиллы идут раньше исполнительских. Условия FULL/LITE/FIX определяют объём, а не разрешают не загружать нужную методику. Уже утверждённую неизменившуюся задачу не возвращай в брейншторм. Информационный вопрос о существующем состоянии не превращай автоматически в новую разработку. Известный ответ дай по доставленному контексту; если нужен поиск, соблюдай сверку цели и рамку роли.
 
 ## Контекст по ответственности
 
@@ -154,6 +156,9 @@ plan.md и test-plan.md. Это документация для следующи
 L2 по умолчанию возвращает RESULT/findings/review сообщением. Право создать файл
 должно содержать точный путь и назначение; разрешения на каталог недостаточно.
 Явное задание обновить основной документ допустимо в назначенном разделе.
+Опциональный итог разговора по wolf-brainstorm — pre-requirements.md в папке той же
+цели: он не входит в эти четыре документа, не запускает scaffold и не означает
+утверждённые требования.
 
 Дополнения — единичные самостоятельные документы с пользой после этапа, например
 необходимый migration-guide или итоговое исследование. L1 до создания указывает
@@ -175,7 +180,7 @@ L2 по умолчанию возвращает RESULT/findings/review сооб
 
 При запросе на реальную разработку или изменение продукта L0 сверяет существующие треды и цель. Продолжение той же цели сохраняет тред. Для новой самостоятельной цели без подходящего треда создай его поддержанным механизмом памяти, например wolf thread add с title и goal; запомни фактический ID. Не создавай тред на каждое уточнение, приветствие или вопрос о текущем состоянии.
 
-Передай L1 ID треда, цель, известные ограничения и назначенную методику. L1 фиксирует FULL/LITE/FIX до выбора документного профиля. Скилл не требует создать все документы до первого разговора: документы появляются, когда определён профиль и начинается запись требований.
+Передай L1 ID треда, цель, известные ограничения и назначенную методику. L1 фиксирует FULL/LITE/FIX до выбора документного профиля. До согласованного перехода к формализации не создавай requirements.md и downstream-шаблоны. По выбору пользователя допустим отдельный итог pre-requirements.md в папке той же цели по wolf-brainstorm; он не запускает scaffold и не означает утверждение требований.
 
 В FULL исполнитель использует wolf scaffold artifact <slug>; сохраняет четыре шаблонных файла в docs/dev/<date>-<slug>/. FIX — профиль --fix, когда он подходит задаче; LITE — достаточный бриф. Ссылки на документы и принятые решения связывай с тредом существующим поддержанным способом, не придумывай поля схемы. Если инструменты памяти недоступны, обозначь ограничение и передай запись исполнителю; разговор можно продолжить, нельзя утверждать, что тред создан.
 

package/templates/base/skills/wolf-brainstorm/SKILL.md

@@ -1,32 +1,145 @@
 ---
 name: wolf-brainstorm
-description: "Применять при запросе на новую разработку, новую возможность, существенное изменение поведения или планирование новой цели без утверждённых требований; до вопросов о требованиях, проектирования и постановки реализации."
+description: "Применять L0 при новой идее, разработке, существенном изменении или новом содержательном поручении, включая анализ и подготовку документа, когда понимание цели ещё не сверено; до исследования предмета, требований, проектирования и постановки исполнения. L1/L2 применяют назначенную часть по согласованному брифу без повторного опроса пользователя."
 ---
 
-# Новая потребность → проверяемые требования
+# Намерение пользователя → общее понимание → нужный результат
 
-## Обязательный вход
+Применяй к задачам любой предметной области: разработке, анализу, организации
+работы, подготовке материалов и другим поручениям. Выясняй намерение из текущего
+контекста; не переноси цель, источники или способ работы из прежнего примера.
+Результатом могут быть решение, объяснение, документ или выполненное действие.
+Технические требования и проектная папка нужны только при соответствующей задаче.
 
-Загрузи эту методику до проясняющих вопросов и постановки задач на реализацию. L0 ведёт разговор и согласует продуктовые решения; L1/L2 исследуют и оформляют документы по назначению. Информационный вопрос о существующем состоянии не является новой разработкой. Продолжение утверждённой неизменившейся задачи не требует нового discovery: восстанови её тред и основания.
+## Обязательный вход и роли
 
-L0 сверяет цель с существующими тредами; для новой самостоятельной разработки без подходящего треда создаёт его доступным поддержанным механизмом. Сохраняй один тред для одной продолжающейся цели. Если запись недоступна, честно обозначь отсутствие треда и передай запись ответственному исполнителю, не имитируй создание.
+Загрузи полный текст до прояснения новой цели. L0 ведёт разговор; L1 организует
+исследование, документы и исполнителей. Поясняй по wolf-explain в этом же
+разговоре, без отдельного агента и повторной загрузки актуальной методики.
 
-Вход: запрос, действующие решения и ограничения, контекст продукта, существующие документы, task/thread ID при наличии. Выход FULL — requirements.md в папке docs/dev/<date>-<slug>/; LITE — достаточный утверждённый бриф. Режим фиксирует L1, продуктовую цель и требования утверждает пользователь через L0.
+Вход: запрос, относящийся контекст, действующие решения/ограничения, доставленные
+брифы/отчёты, task/thread ID при наличии. Не подменяй цель старой подзадачей.
+Продолжение согласованной неизменившейся работы не требует нового discovery.
 
-## Разговор и исследование
+L0 использует метаданные. Содержательное изучение материалов и поиск
+фактов задачи поручай через L1. Markdown, read-only, «информационный вопрос»
+и «быстро посмотрю» не создают исключений из роли.
 
-1. Прочитай доступный контекст. Раздели факт, допущение, собственную рекомендацию и вопрос. Не спрашивай уже известное и не выдавай своё решение за выбор пользователя.
-2. Сформулируй проблему, адресата, пользу и наблюдаемый успех. Определи границы и не-цели. Проверяй, что понял намерение, а не только желаемую кнопку или команду.
-3. Задай наиболее важный вопрос, меняющий scope, риск или критерии. Обычно один вопрос за сообщение; связанные вопросы объединяй, если это действительно облегчает ответ. Пиши на языке пользователя, без процессного сленга. При достаточных данных не устраивай искусственный опрос.
-4. Исследование кода, файлов или внешних источников поручай исполнителям в пределах мандата. Новое разрешение нужно только там, где его требуют действующие ограничения; не проси его для уже порученного исследования.
-5. Сравни реальные подходы, когда есть значимый выбор. Объясни последствия и рекомендацию. Не придумывай альтернативы ради обязательного числа. Существенные собственные допущения скажи явно; местные обратимые детали можно решить в пределах мандата.
-6. Отслеживай известное и открытое в рабочем брифе. Не переходи к реализации продукта, пока не определены требования и нужное основание их утверждения. Явное исключение пользователя учитывай в его scope, сохраняя рамку роли и ограничения платформы.
+## Выбери глубину разговора, сохрани цель
+
+| Ситуация | Действие |
+| --- | --- |
+| Пользователь ищет идею/направление | Помоги осмыслить проблему, подходы и последствия; документ или разработка не обязательны. |
+| Конкретное поручение: изучить, сравнить, написать, исправить | Кратко сверь цель/результат; затем организуй порученную работу, без автоматического requirements.md. |
+| Существенно разные прочтения | Покажи различие сценарием или предположением и выясни намерение. |
+| Простой вопрос с ответом в доставленном контексте | Ответь; не запускай тред и исследование ради формальности. |
+
+До исследования предмета, диспетча исполнения, scaffold и требований изложи
+своё понимание новой содержательной задачи так, чтобы пользователь мог его
+поправить; по умолчанию дождись ответа. Прямое поручение сокращает разговор,
+не отменяет сверку. Не выдумывай неизвестное ради вопроса. Подтверждение именно
+этой цели/границ сохраняет силу; повторный одинаковый гейт не нужен. Явное
+«продолжай без вопросов» учитывай в его пределах, назвав существенные допущения;
+молчание не подтверждение.
+
+Различай желаемый результат и предложенный способ его получить. Не превращай
+сравнение в обязательную унификацию, совет — в проект внедрения, а подготовку
+документа — в разработку новой системы. Широта исходных материалов сама по себе
+не разрешает расширять задачу или применять процесс разработки FULL.
+
+## Содержательный диалог вместо анкеты
+
+Помоги выразить, чего пользователь хочет добиться и почему. Количество вопросов,
+заполненные поля и уверенный тон не доказывают понимания. Не задавай обязательные
+два, три или пять вопросов и не проходи универсальную анкету.
+
+Опирайся на контекст и последний ответ. Выбери полезный ход: проверь предположение,
+покажи сценарий/последствие, предложи подход, выяви противоречие, возрази с
+основанием или спроси. Вопрос нужен, когда ответ меняет понимание, выбор или
+ближайшее действие. Не спрашивай известное и не требуй готовых требований.
+
+Одна основная мысль за реплику; обычно один содержательный вопрос, если нужен.
+Не пересказывай весь разговор и не показывай внутренний перебор сомнений.
+Объясняй варианты через конкретные действия и последствия. Рекомендуй с причиной
+и существенным компромиссом. Обсуждай технические предложения пользователя
+на равных; не соглашайся автоматически. Свои предложения не выдавай за его
+решения; число альтернатив определяется реальным выбором.
+
+## Исследование и консилиум
+
+Разговор не разрешает фоновое исследование, документы и спавн сам по себе.
+Покажи, какой вопрос и зачем нужно проверить; поручай через L1 отдельную задачу
+с источниками/границами, ожидаемым результатом, бюджетом и условием остановки.
+В уже порученном исследовании не запрашивай разрешение на каждое чтение;
+изменение цели или объёма сначала верни на согласование.
+
+Выбирай источники по вопросу и требуемой надёжности ответа; используй уже
+доставленный контекст. Углубляй поиск, когда конкретный пробел мешает результату,
+а не ради полного обзора всех материалов. Неизвестное отмечай; оно не всегда
+требует нового исследования. Репозиторий, код и документация — возможные
+источники для подходящих задач, не обязательный маршрут любого поручения.
+
+Консилиум поручай L1 по явному запросу или для сложного выбора, когда независимые
+мнения способны изменить решение и оправдывают стоимость. Соблюдай независимость
+первых мнений и контракт ниже. Верни значимое согласие, расхождение и основания,
+не стенограмму. Согласие участников не доказывает верность. Новые агенты и права
+для этого не требуются.
+
+## Готовность к следующему действию
+
+Перед требованиями или исполнением проверь по разговору:
+
+- Можешь объяснить проблему, результат и пользу своими словами.
+- Учёл границы и поправки; пользователь мог проверить понимание, основание
+  продолжения относится к этой задаче.
+- Различимы факты, подтверждённые решения, предложения и неизвестное.
+- Нет расхождения, меняющего цель, результат или ближайший дорогой шаг.
+
+Если пробел существенен, продолжи разговор либо поставь адресное исследование
+в согласованном мандате. Знать весь дизайн заранее не нужно. Не экзаменуй
+пользователя и не согласовывай повторно неизменившееся. После поправки цели
+обнови понимание и затронутые решения до продолжения.
+
+## Выход разговора и сохранение контекста
+
+Допустимы продолжение и завершение без документа/разработки. Когда есть что
+фиксировать, а следующий шаг не выбран, предложи: «Зафиксируем выводы документом
+или перейдём к требованиям?» Не повторяй в каждой реплике и не навязывай два
+выхода. Явный выбор действия пользователем не требует ещё такого же вопроса.
+
+Для разговора о будущей разработке по выбору сохранить итог поручай L1 `pre-requirements.md` в
+`docs/dev/<date>-<slug>/` рядом с будущими документами той же цели: намерение/польза,
+границы, принятые решения с основаниями, варианты, предложения и открытые вопросы.
+Это необязательный итог, не временный отчёт и не новый тип памяти. Сверь папку,
+владельца и права записи/claim; для одного итога не вызывай scaffold четырёх файлов.
+Отдельный CLI-профиль/авторегистрация этим скиллом не поставляются. После
+утверждения требований актуальное поведение задаёт requirements.md; здесь
+остаётся замысел. Рабочие следы — адресные note/context/history по using-skills,
+без новых статусов и lessons/complaints для черновиков.
+
+Для иных задач выбирай результат и место сохранения по их назначению и правилам
+проекта; не создавай docs/dev и pre-requirements.md автоматически.
+
+Передавай цель, решения/ограничения, существенные отклонённые варианты с причинами
+и неизвестное, не стенограмму и повторный опрос. Для порученного анализа или
+руководства передай исполнителю именно этот результат и критерии, без нового
+пакета требований. Для самостоятельной разработки L0 сверяет/создаёт один
+реальный тред; при недоступной записи обозначает ограничение и поручает её L1.
+Свяжи сохранённый итог с тредом поддержанным способом.
+
+При переходе к формализации разработки FULL даёт requirements.md, LITE —
+утверждённый бриф; режим определяет L1. Сверка намерения не утверждает ещё
+не написанные требования, дизайн или реализацию. Далее действуют правила ниже.
 
 ## Документы по штатному шаблону
 
-До записи полного requirements L1 определяет режим и назначает ответственного за папку. В FULL выполни wolf scaffold artifact <slug>. Команда создаёт requirements.md, design.md, plan.md и test-plan.md; пустые downstream-шаблоны не являются утверждёнными документами. Для подтверждённого FIX подходит wolf scaffold artifact <slug> --fix; LITE не требует набора из четырёх файлов.
+Этот раздел и гейты требований ниже применяй при выбранном переходе к требованиям
+разработки. Для обсуждения, анализа и иных поручений они не являются обязательным
+продолжением разговора. Контракт совета применяй, только когда совет проводится.
+
+До записи полного requirements L1 определяет режим и назначает ответственного за папку. Для новой папки в FULL выполни wolf scaffold artifact <slug>. Команда создаёт requirements.md, design.md, plan.md и test-plan.md; пустые downstream-шаблоны не являются утверждёнными документами. Для подтверждённого FIX подходит wolf scaffold artifact <slug> --fix; LITE не требует набора из четырёх файлов.
 
-Проверь доступность команды перед выбором fallback. Если папка уже существует, проверь её связь с той же целью и продолжи её; не перезаписывай и не создавай дубликат. Если генератор недоступен, используй точный шаблон установленной версии из доступного проверенного источника. При недоступном шаблоне сохрани черновик и ограничение; не объявляй произвольный формат штатным. L0 поручает запись документов исполнителю.
+Проверь доступность команды перед выбором fallback. Если папка уже существует, проверь её связь с той же целью и продолжи её; не перезаписывай и не создавай дубликат. В том числе для папки с pre-requirements.md не вызывай scaffold повторно: он отклоняет существующую папку. Подготовь только недостающие документы по точному шаблону установленной версии, сохранив итог дискуссии и прежние файлы. Если генератор недоступен, используй точный шаблон установленной версии из доступного проверенного источника. При недоступном шаблоне сохрани черновик и ограничение; не объявляй произвольный формат штатным. L0 поручает запись документов исполнителю.
 
 Для FULL сохрани frontmatter slug/title/status/created и семь разделов:
 
@@ -90,4 +203,4 @@ L0 сверяет цель с существующими тредами; для
 | «Создам папку как привык» | Используй штатный генератор либо точный проверенный шаблон |
 | «Тред появится сам от scaffold» | Создание документов и треда — разные действия; проверь оба |
 | «Вызвал скилл вручную — дальше обычный разговор» | Пройди обязательные шаги и проверь выход |
-| «Нужно спрашивать даже очевидное» | Достаточные данные позволяют подготовить требования без лишнего опроса |
+| «Нужно спрашивать даже очевидное» | После сверки намерения не устраивай дополнительный опрос ради формы |