mister-wolf 2.22.0 → 2.23.0

package/dist/app/use-cases/usage-signal.d.ts

@@ -0,0 +1,91 @@
+import type { SignalEvent } from '../../adapters/fs/session-metrics-log.js';
+/** Один завершённый/незавершённый assistant-turn из источника. */
+export interface UsageTurn {
+    /** session_message.id */
+    messageId: string;
+    /** session_message.session_id */
+    sessionId: string;
+    seq: number | null;
+    /** data.time.created */
+    createdMs: number | null;
+    /** data.time.completed (streamed не считается завершением) */
+    completedMs: number | null;
+    /** data.agent */
+    agent: string | null;
+    /** data.model.id */
+    modelId: string | null;
+    /** data.model.providerID */
+    providerId: string | null;
+    tokens: {
+        input: number;
+        output: number;
+        cacheRead: number;
+    } | null;
+    /** data.tokens.reasoning — не входит в output. */
+    reasoning: number | null;
+    /** data.tokens.cache.write — не входит в cache_read. */
+    cacheWrite: number | null;
+    /** data.finish */
+    finish: 'stop' | 'tool-calls' | 'error' | null;
+    /** data.retry.attempt */
+    attempt: number | null;
+}
+/** Метаданные run (сессии источника). */
+export interface UsageRun {
+    sessionId: string;
+    /** session_v2.parent_id */
+    parentSessionId: string | null;
+    agent: string | null;
+    modelId: string | null;
+    providerId: string | null;
+    createdMs: number | null;
+    /** session_v2.time_busy */
+    busyMs: number | null;
+}
+export interface RunSummary {
+    runId: string;
+    sessionId: string;
+    traceId: string | null;
+    taskId: string | null;
+    /** null = неизвестно */
+    attempts: number[] | null;
+    /** `${providerId}/${modelId}` или modelId */
+    model: string | null;
+    agent: string | null;
+    /** null = неизвестно */
+    tokens: {
+        input: number;
+        output: number;
+        cacheRead: number;
+    } | null;
+    /** сумма duration_ms импортированных turn'ов */
+    generationMs: number | null;
+    busyMs: number | null;
+    events: number;
+    outcomes: {
+        ok: number;
+        error: number;
+        unknown: number;
+    };
+    /** имена недоступных полей */
+    unknowns: string[];
+}
+export declare const USAGE_SOURCE_LIMITATIONS: readonly string[];
+/** Детерминированный id события: sha256("opencode-usage:v1|"+messageId), первые 32 hex. */
+export declare function usageEventId(messageId: string): string;
+/**
+ * null — turn не завершён (нет completedMs) или нет session_id; иначе событие run.
+ */
+export declare function signalFromTurn(turn: UsageTurn, ctx?: {
+    taskId?: string | null;
+    traceId?: string | null;
+    sessionModel?: {
+        id: string;
+        providerID: string;
+    } | null;
+    /** session_v2.agent — fallback, когда у turn агент не записан (design §Маппинг). */
+    sessionAgent?: string | null;
+}): SignalEvent | null;
+/** Агрегация по run_id; порядок — по возрастанию первого ts. */
+export declare function summarizeRuns(events: SignalEvent[], runs: UsageRun[]): RunSummary[];
+//# sourceMappingURL=usage-signal.d.ts.map

package/dist/app/use-cases/usage-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-signal.d.ts","sourceRoot":"","sources":["../../../src/app/use-cases/usage-signal.ts"],"names":[],"mappings":"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"}

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mister-wolf",
-  "version": "2.22.0",
+  "version": "2.23.0",
   "description": "Local-first project memory for AI coding agents: decisions, lessons, tools and processes that outlive the session",
   "keywords": [
     "ai-agents",
@@ -28,7 +28,7 @@
     "update-map.json"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && tsc",
     "dev": "tsc --watch",
     "test": "vitest",
     "test:run": "vitest run",
@@ -41,7 +41,7 @@
     "bench:tokens": "node --disable-warning=ExperimentalWarning scripts/bench-tokens.mjs",
     "check": "node scripts/check-english-surface.mjs && npm run format:check && npm run lint && npm run build && npm run test:run",
     "docs:dev": "vitepress dev docs/site",
-    "docs:build": "node scripts/generate-cli-reference.mjs && node scripts/sync-changelog.mjs && vitepress build docs/site",
+    "docs:build": "node scripts/generate-cli-reference.mjs && node scripts/generate-cli-site-page.mjs && node scripts/sync-changelog.mjs && vitepress build docs/site",
     "docs:preview": "vitepress preview docs/site"
   },
   "dependencies": {

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

@@ -64,6 +64,7 @@ wolf-debug: один осмысленный обход в scope, затем FRIC
 | Утверждённый план, входы сверены | 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 |

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

@@ -0,0 +1,54 @@
+---
+name: wolf-git
+description: "Применять на Git-этапах задачи: вход/возобновление, ветка или worktree, checkpoint, передача, завершение и уборка; также при отказе git, требующем force, и при неподтверждённой актуальности."
+---
+
+# Git-этапы задачи
+
+Регламент: `reference/git-collaboration-policy-v1.1.md` рядом с этим файлом (в проекте `.opencode/skills/wolf-git/reference/git-collaboration-policy-v1.1.md`). Читать только нужный § регламента по этапу; весь файл в контекст не тянуть.
+
+## Обязательный вход
+
+Полномочия берутся из брифа задачи; скилл прав не выдаёт. Нет полномочия на коммит/публикацию — сохраняет назначенный L1 (§3). Спутники: `using-git-worktrees`, `wolf-handoff`, `finishing-a-development-branch`.
+
+## Вход / возобновление (G0)
+
+§6: `git rev-parse --show-toplevel`, `git remote -v`, `git worktree list --porcelain`, `git status --porcelain`, `git rev-parse HEAD`, `git ls-remote` с временем наблюдения; незавершённые merge/rebase/cherry-pick; владелец, baseline, сравнение с опубликованной ветвью и целью MR. Нет remote/сети — «не удалось проверить», не успех (§6.5). Локальный `main` впереди или разошёлся — не push и не reset (§6.2).
+
+## Создание ветки и worktree (G1)
+
+§7, §4.1: задача, владелец, цель MR, явный baseline SHA (не текущий HEAD). Независимая задача — от проверенного SHA `main`, подзадача — от идентифицированного SHA родителя (для передачи на другой хост он должен быть опубликован). Уникальное имя, безопасный путь; чужой непустой каталог не перезаписывается; сначала ищется существующая ветка/worktree продолжения (§15.3).
+
+## Сохранение (checkpoint)
+
+§8: обязателен на логической границе, перед остановкой или передачей, перед операцией, затрагивающей незакоммиченное, и перед предъявлением. Перед коммитом — просмотр diff и известный набор файлов; `git add -A` из неизвестного состояния запрещён. Секреты не публикуются. Коммит ≠ публикация.
+
+## Передача (G2)
+
+§9: остановить прежнюю запись, сохранить и опубликовать при доступном remote; передать задачу/владельца, repo/branch/target, baseline и опубликованный SHA, рабочую копию, состояние, проверки, следующий шаг. Получатель подтверждает вход; без подтверждения передача не завершена, таймаут не доказывает остановку записи.
+
+## Завершение и уборка (G9)
+
+§15: остановить писателей; подтвердить судьбу результата — ancestry исходного SHA (`git merge-base --is-ancestor`) либо запись MR при разрешённом squash; проверить незавершённые операции, dirty, коммиты после принятого SHA, ценные ignored-файлы, нужность потомкам. Чистый `git status` не доказывает безопасность удаления. Запрещены по умолчанию `--force`, `reset --hard`, `clean` с удалением неизвестного, `branch -D`; при неподтверждённой сохранности каталог остаётся.
+
+## Приёмка, интеграция и выпуск
+
+§10, §16, §22: стандарт — merge `--no-ff`; squash — только явное исключение. В Wolf это не автоматизировано.
+
+## Что не поставлено
+
+Нет MR-статусов и адаптера хостинга, CI-проверок, очереди интеграции (§11), тегов/registry/выпуска, структурного read-only `git inspect` и JSON-вердикта (B0.5/B1), scheduler и постоянного контролёра. Гейты G3–G8 не автоматизированы и не являются поставленным гейтом: при необходимости их выполняют люди вручную. Отсутствующее не называть доступной командой.
+
+## Гейт перехода
+
+Подтверждено лишь то, что проверено командой с временем и результатом. «Не удалось проверить» ≠ пройдено; неизвестное состояние не считается чистым.
+
+## Не пропускай процесс
+
+| Мысль | Действие |
+| --- | --- |
+| «Создам от текущего HEAD» | Выбери baseline SHA явно. |
+| «PR готов — уберу worktree» | Сохранность не доказана (§15.1). |
+| «Git отказал — добавлю --force» | Разбери причину, не усиливай. |
+| «Заметка Wolf доказывает Git-состояние» | Память не факт Git; проверь команды. |
+| «Передача вроде сделана» | Нужно подтверждение получателя (§9). |