mister-wolf 1.0.0

package/dist/app/use-cases/template-evolve.js

@@ -0,0 +1,164 @@
+/**
+ * Ф24 GEPA — продукт-минимум: эволюция шаблонов брифов с детерминированной метрикой.
+ * Спека: docs/superpowers/specs/2026-08-26-self-learning-design.md §3 («Жёсткое
+ * ограничение применимости GEPA», «Числовые границы GEPA»), §17 B.4; roadmap-v2 Phase 24.
+ *
+ * Ключевые границы (M24-01..04, S24-05):
+ * - рефлектор — только фронтирная модель за интерфейсом TemplateReflector;
+ * - пул примеров 20–100 (M24-02);
+ * - лимит длины шаблона 1500 символов (M24-03);
+ * - Парето-сравнение ревизий — по инстансам, не по осям Q/C/T (S24-05);
+ * - constraint-блок рефлектору против утечки примеров (M24-04);
+ * - применение кандидата — только человек (N24-07 CLI activate — v1.1+):
+ *   evolveTemplate пишет кандидат-файл, НЕ активирует.
+ */
+import { posix } from 'path';
+import { readSignals } from '../../adapters/fs/session-metrics-log.js';
+import { UserFacingError } from '../../domain/errors.js';
+/** Лимит длины шаблона (M24-03 [ЦИТ] Decagon: 4× компрессия при −0.8% качества). */
+export const TEMPLATE_CHAR_LIMIT = 1500;
+/** Пул примеров рефлексии (M24-02 [ЦИТ]: 20–100; 500 → −2% качества, 10× стоимости). */
+export const POOL_MIN = 20;
+export const POOL_MAX = 100;
+/** Пул примеров из tool_error-сигналов; вне границ 20–100 — отказ (M24-02). */
+export function buildExamplePool(signals) {
+    const all = signals
+        .filter((s) => s.event === 'tool_error')
+        .map((s) => ({
+        ts: s.ts,
+        tool_name: s.tool_name ?? 'unknown',
+        error_class_id: s.error_class_id ?? 'uncategorized',
+        message: String(s.detail?.message ?? ''),
+    }));
+    if (all.length < POOL_MIN) {
+        throw new UserFacingError(`пул примеров ${all.length} < ${POOL_MIN} — GEPA-эволюция не запускается (M24-02: ${POOL_MIN}–${POOL_MAX})`);
+    }
+    // больше POOL_MAX — последние POOL_MAX по порядку файла (свежие важнее старых)
+    return all.length > POOL_MAX ? all.slice(all.length - POOL_MAX) : all;
+}
+/** Constraint-блок рефлектору (M24-04): против утечки примеров в шаблон. */
+export function reflectorConstraints() {
+    return [
+        'не копируй примеры ошибок дословно в шаблон — обобщай до воспроизводимых указаний',
+        `не превышай лимит ${TEMPLATE_CHAR_LIMIT} символов (M24-03)`,
+        "указания — только воспроизводимые, вида 'avoid: <tool_name>'",
+    ];
+}
+/**
+ * Механический рефлектор (детерминированный, без LLM — прецедент Ф22
+ * mechanicalDraftGenerator): добавляет 'avoid: <tool>' по топ-3 тулам пула,
+ * не превышая лимит. Фронтирный LLM-рефлектор (M24-01) подключается по
+ * протоколу docs/guide/steward-learn.md — интерфейс тот же.
+ */
+export function mechanicalReflector() {
+    return {
+        async reflect(input) {
+            const freq = new Map();
+            for (const e of input.examples)
+                freq.set(e.tool_name, (freq.get(e.tool_name) ?? 0) + 1);
+            const top = [...freq.entries()]
+                .sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : 1))
+                .slice(0, 3)
+                .map(([tool]) => `avoid: ${tool}`)
+                .filter((line) => !input.current.toLowerCase().includes(line.split(': ')[1].toLowerCase()));
+            let candidate = input.current.trimEnd();
+            for (const line of top) {
+                const next = `${candidate}\n${line}`;
+                if (next.length > TEMPLATE_CHAR_LIMIT)
+                    break;
+                candidate = next;
+            }
+            return { candidate, notes: 'механический рефлектор: avoid-указания по топ-тулам пула' };
+        },
+    };
+}
+function prevents(template, example) {
+    return template.toLowerCase().includes(example.tool_name.toLowerCase());
+}
+/**
+ * ДЕТЕРМИНИРОВАННАЯ метрика (спека §3/§17 B.4: GEPA — только числовые
+ * воспроизводимые метрики, никакого LLM-джаджа). Прокси-скор: «доля ошибок пула,
+ * которых шаблон касался указанием» — пример считается предотвращённым, если шаблон
+ * упоминает tool_name примера (подстрока, case-insensitive). Качество здесь =
+ * процент предотвращённых ошибок — детерминированная воспроизводимая метрика.
+ */
+export function scoreTemplate(template, examples) {
+    const total = examples.length;
+    const prevented = examples.filter((e) => prevents(template, e)).length;
+    const score = total === 0 ? 0 : Number((prevented / total).toFixed(4));
+    return { prevented, total, score };
+}
+/**
+ * Парето ПО ИНСТАНСАМ (S24-05; GEPA Algorithm 2): попарно по каждому примеру —
+ * предотвращён/нет у каждой ревизии. candidate_better: строго больше побед И ни один
+ * инстанс не проигран; current_better — зеркально; иначе no_gain.
+ */
+export function compareTemplates(current, candidate, examples) {
+    let winsCandidate = 0;
+    let winsCurrent = 0;
+    let ties = 0;
+    for (const e of examples) {
+        const cur = prevents(current, e);
+        const cand = prevents(candidate, e);
+        if (cand && !cur)
+            winsCandidate++;
+        else if (cur && !cand)
+            winsCurrent++;
+        else
+            ties++;
+    }
+    const verdict = winsCandidate > winsCurrent && winsCurrent === 0
+        ? 'candidate_better'
+        : winsCurrent > winsCandidate && winsCandidate === 0
+            ? 'current_better'
+            : 'no_gain';
+    return {
+        currentScore: scoreTemplate(current, examples),
+        candidateScore: scoreTemplate(candidate, examples),
+        winsCandidate,
+        winsCurrent,
+        ties,
+        verdict,
+    };
+}
+/** Длина шаблона > 1500 символов → отказ (M24-03). */
+export function validateTemplateLength(template, label) {
+    if (template.length > TEMPLATE_CHAR_LIMIT) {
+        throw new UserFacingError(`шаблон ${label}: ${template.length} символов > лимита ${TEMPLATE_CHAR_LIMIT} (M24-03)`);
+    }
+}
+function templateFile(baseDir, templateId, suffix = '') {
+    return posix.join(baseDir, '.wolf', 'templates', `${templateId}${suffix}.md`);
+}
+/**
+ * Один цикл GEPA-эволюции шаблона: пул из сигнального лога → рефлексия (LLM за
+ * интерфейсом) → детерминированный скоринг → Парето по инстансам. dryRun=true —
+ * ничего не пишет. dryRun=false — пишет ТОЛЬКО кандидат-файл <id>.candidate.md;
+ * применение шаблона — гейт человека (N24-07 `templates activate` — v1.1+).
+ */
+export async function evolveTemplate(deps, baseDir, input) {
+    const templatePath = templateFile(baseDir, input.templateId);
+    let current;
+    try {
+        current = await deps.readFile(templatePath);
+    }
+    catch {
+        throw new UserFacingError(`шаблон ${input.templateId} не найден (${templatePath}) — создайте файл шаблона, прежде чем эволюционировать`);
+    }
+    validateTemplateLength(current, 'current');
+    const examples = buildExamplePool(readSignals(baseDir));
+    const { candidate } = await input.reflector.reflect({
+        templateId: input.templateId,
+        current,
+        examples,
+        constraints: reflectorConstraints(),
+    });
+    validateTemplateLength(candidate, 'candidate');
+    const comparison = compareTemplates(current, candidate, examples);
+    if (input.dryRun) {
+        return { templatePath, candidate, current, comparison, poolSize: examples.length, wrote: false };
+    }
+    await deps.writeFile(templateFile(baseDir, input.templateId, '.candidate'), candidate);
+    return { templatePath, candidate, current, comparison, poolSize: examples.length, wrote: true };
+}
+//# sourceMappingURL=template-evolve.js.map

package/dist/app/use-cases/template-evolve.js.map

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

package/dist/app/use-cases/thinking.d.ts

@@ -0,0 +1,61 @@
+import { Clock } from '../../ports/clock.port.js';
+import { IdGenerator } from '../../ports/id-generator.port.js';
+import { MemoryStore } from '../../ports/memory-store.port.js';
+import { EventLog } from '../../ports/event-log.port.js';
+import { SearchIndex } from '../../ports/search-index.port.js';
+import { RelationLog } from '../../ports/relation-log.port.js';
+import { MemoryLock } from '../../ports/memory-lock.port.js';
+import { CreateDecisionResult } from './create-decision.js';
+export declare const THOUGHT_TYPES: readonly ["hypothesis", "reasoning", "evidence", "concern"];
+export type ThoughtType = (typeof THOUGHT_TYPES)[number];
+export interface SequenceMeta {
+    kind: 'sequence';
+    id: string;
+    goal: string;
+    thread: string | null;
+    created_at: string;
+}
+export interface Thought {
+    kind: 'thought';
+    tid: string;
+    n: number;
+    type: ThoughtType;
+    text: string;
+    created_at: string;
+}
+interface ThinkingDeps {
+    baseDir: string;
+    clock: Clock;
+    idGen: IdGenerator;
+}
+export declare function startThinking(deps: ThinkingDeps, input: {
+    goal: string;
+    thread?: string;
+}): Promise<SequenceMeta>;
+export declare function addThought(deps: ThinkingDeps, input: {
+    sequenceId: string;
+    type: ThoughtType;
+    text: string;
+}): Promise<Thought>;
+export declare function concludeThinking(deps: {
+    baseDir: string;
+    store: MemoryStore;
+    log: EventLog;
+    clock: Clock;
+    idGen: IdGenerator;
+    index?: SearchIndex;
+    relations?: RelationLog;
+    lock?: MemoryLock;
+}, input: {
+    sequenceId: string;
+    title: string;
+    body: string;
+    createdBy: string;
+}): Promise<CreateDecisionResult>;
+export declare function abandonThinking(deps: {
+    baseDir: string;
+}, input: {
+    sequenceId: string;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=thinking.d.ts.map

package/dist/app/use-cases/thinking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking.d.ts","sourceRoot":"","sources":["../../../src/app/use-cases/thinking.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAkB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5E,eAAO,MAAM,aAAa,6DAA8D,CAAC;AAEzF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;CACpB;AAaD,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,YAAY,CAAC,CAWvB;AA4CD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,EACD,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5E,OAAO,CAAC,oBAAoB,CAAC,CA6B/B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7G"}

package/dist/app/use-cases/thinking.js

@@ -0,0 +1,123 @@
+import { appendFile, mkdir, readFile, unlink } from 'fs/promises';
+import { join } from 'path';
+import { thinkingDir } from '../../adapters/fs/project-paths.js';
+import { createDecision } from './create-decision.js';
+export const THOUGHT_TYPES = ['hypothesis', 'reasoning', 'evidence', 'concern'];
+// ponytail: без лока — одна последовательность = один файл, сценарий single-agent;
+// многописательность потребует файловый лок на scratch (D8)
+function scratchPath(baseDir, sequenceId) {
+    return join(thinkingDir(baseDir), `${sequenceId}.jsonl`);
+}
+async function appendRecord(baseDir, sequenceId, record) {
+    await mkdir(thinkingDir(baseDir), { recursive: true });
+    await appendFile(scratchPath(baseDir, sequenceId), `${JSON.stringify(record)}\n`, 'utf-8');
+}
+export async function startThinking(deps, input) {
+    const now = deps.clock.now();
+    const meta = {
+        kind: 'sequence',
+        id: deps.idGen.generateMemoryId(now, input.goal),
+        goal: input.goal,
+        thread: input.thread ?? null,
+        created_at: now.toISOString(),
+    };
+    await appendRecord(deps.baseDir, meta.id, meta);
+    return meta;
+}
+function parseLine(line, sequenceId, lineNumber) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        throw new Error(`Corrupted thinking sequence "${sequenceId}": line ${lineNumber} is not valid JSON`);
+    }
+}
+async function readScratch(baseDir, sequenceId) {
+    let raw;
+    try {
+        raw = await readFile(scratchPath(baseDir, sequenceId), 'utf-8');
+    }
+    catch {
+        throw new Error(`Thinking sequence not found: ${sequenceId}`);
+    }
+    const lines = raw.split('\n').filter((line) => line.trim() !== '');
+    if (lines.length === 0) {
+        throw new Error(`Corrupted thinking sequence "${sequenceId}": file is empty`);
+    }
+    const meta = parseLine(lines[0], sequenceId, 1);
+    if (meta.kind !== 'sequence') {
+        throw new Error(`Corrupted thinking sequence "${sequenceId}": line 1 must be kind:"sequence"`);
+    }
+    if (meta.id !== sequenceId) {
+        throw new Error(`Corrupted thinking sequence "${sequenceId}": meta id mismatch ("${meta.id}")`);
+    }
+    const thoughts = [];
+    for (let i = 1; i < lines.length; i++) {
+        const thought = parseLine(lines[i], sequenceId, i + 1);
+        if (thought.kind !== 'thought') {
+            throw new Error(`Corrupted thinking sequence "${sequenceId}": line ${i + 1} must be kind:"thought"`);
+        }
+        if (!THOUGHT_TYPES.includes(thought.type)) {
+            throw new Error(`Unknown thought type "${String(thought.type)}" in sequence "${sequenceId}". Allowed: ${THOUGHT_TYPES.join(', ')}`);
+        }
+        thoughts.push(thought);
+    }
+    return { meta, thoughts };
+}
+export async function addThought(deps, input) {
+    if (!THOUGHT_TYPES.includes(input.type)) {
+        throw new Error(`Invalid thought type "${String(input.type)}". Allowed: ${THOUGHT_TYPES.join(', ')}`);
+    }
+    const { thoughts } = await readScratch(deps.baseDir, input.sequenceId);
+    const now = deps.clock.now();
+    const thought = {
+        kind: 'thought',
+        tid: deps.idGen.generateMemoryId(now, `${input.type}: ${input.text}`),
+        n: (thoughts[thoughts.length - 1]?.n ?? 0) + 1,
+        type: input.type,
+        text: input.text,
+        created_at: now.toISOString(),
+    };
+    await appendRecord(deps.baseDir, input.sequenceId, thought);
+    return thought;
+}
+export async function concludeThinking(deps, input) {
+    const { meta, thoughts } = await readScratch(deps.baseDir, input.sequenceId);
+    if (thoughts.length === 0) {
+        throw new Error(`Sequence has no thoughts: ${input.sequenceId}`);
+    }
+    const trace = thoughts.map((t) => `${t.n}. [${t.type}] ${t.text}`).join('\n');
+    const body = `${input.body}\n\n## Thinking trace (${meta.id})\n\n${trace}`;
+    const result = await createDecision({
+        store: deps.store,
+        log: deps.log,
+        clock: deps.clock,
+        idGen: deps.idGen,
+        index: deps.index,
+        relations: deps.relations,
+        lock: deps.lock,
+    }, {
+        title: input.title,
+        body,
+        thread: meta.thread ?? undefined,
+        basedOn: thoughts.map((t) => t.tid),
+        createdBy: input.createdBy,
+    });
+    await unlink(scratchPath(deps.baseDir, input.sequenceId)).catch((err) => {
+        if (err.code !== 'ENOENT')
+            throw err;
+    });
+    return result;
+}
+export async function abandonThinking(deps, input) {
+    try {
+        await unlink(scratchPath(deps.baseDir, input.sequenceId));
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`Thinking sequence not found: ${input.sequenceId}`);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=thinking.js.map

package/dist/app/use-cases/thinking.js.map

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

package/dist/app/use-cases/tool-librarian.d.ts

@@ -0,0 +1,83 @@
+import { MemoryStore } from '../../ports/memory-store.port.js';
+import { EventLog } from '../../ports/event-log.port.js';
+import { Clock } from '../../ports/clock.port.js';
+import { IdGenerator } from '../../ports/id-generator.port.js';
+import { SearchIndex } from '../../ports/search-index.port.js';
+import { MemoryLock } from '../../ports/memory-lock.port.js';
+import { FileSystem } from '../../ports/file-system.port.js';
+import { MemoryTypeDeclaration } from '../../domain/memory-types.js';
+import { MemoryObject } from '../../domain/schemas/memory-object-schema.js';
+/** Поля типа tool (extra поверх MemoryObject; см. декларацию в memory-types.ts). */
+export interface ToolFields {
+    name: string;
+    script_path: string;
+    language: string;
+    contract_input?: string;
+    contract_output?: string;
+    contract_environment?: string;
+    usage_count?: number;
+    last_used_at?: string;
+    deprecation_reason?: string;
+}
+export type ToolObject = MemoryObject & ToolFields;
+export interface ToolLibrarianDeps {
+    store: MemoryStore;
+    log: EventLog;
+    clock: Clock;
+    idGen: IdGenerator;
+    index?: SearchIndex;
+    lock?: MemoryLock;
+    declarations?: readonly MemoryTypeDeclaration[];
+    fs: FileSystem;
+    baseDir: string;
+}
+export interface RegisterToolInput {
+    scriptPath: string;
+    name: string;
+    language: string;
+    contractIn?: string;
+    contractOut?: string;
+    contractEnvironment?: string;
+    notes?: string;
+    force?: boolean;
+    createdBy: string;
+}
+export interface RegisterToolResult {
+    toolId: string;
+    /** Относительный путь скрипта внутри проекта (.wolf/tools/<name><ext>). */
+    scriptPath: string;
+    similar: {
+        id: string;
+        name: string;
+        status: string;
+    }[];
+}
+export declare function registerTool(deps: ToolLibrarianDeps, input: RegisterToolInput): Promise<RegisterToolResult>;
+export declare function listTools(deps: Pick<ToolLibrarianDeps, 'store'>, filters?: {
+    status?: string;
+}): Promise<ToolObject[]>;
+type StoreDeps = Omit<ToolLibrarianDeps, 'fs' | 'baseDir'>;
+export declare function useTool(deps: StoreDeps, input: {
+    nameOrId: string;
+    actor: string;
+}): Promise<ToolObject>;
+/** Детерминированный контент SKILL.md из объекта tool — повторная генерация даёт тот же текст. */
+export declare function toolSkillContent(tool: ToolObject): string;
+export declare function exposeTool(deps: ToolLibrarianDeps, input: {
+    nameOrId: string;
+    actor?: string;
+}): Promise<{
+    path: string;
+    content: string;
+}>;
+export declare function deprecateTool(deps: StoreDeps, input: {
+    nameOrId: string;
+    reason: string;
+    actor: string;
+}): Promise<ToolObject>;
+export declare function reviveTool(deps: StoreDeps, input: {
+    nameOrId: string;
+    actor: string;
+}): Promise<ToolObject>;
+export {};
+//# sourceMappingURL=tool-librarian.d.ts.map

package/dist/app/use-cases/tool-librarian.d.ts.map

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

package/dist/app/use-cases/tool-librarian.js

@@ -0,0 +1,189 @@
+import { join, extname, isAbsolute } from 'path';
+import { UserFacingError } from '../../domain/errors.js';
+import { addMemoryObject } from './add-memory-object.js';
+import { transitionMemoryObject } from './transition-memory-object.js';
+const LIVE_STATUSES = ['candidate', 'active'];
+function asTool(obj) {
+    return obj;
+}
+/** Токены для дедупа: lowercase, длина > 3 символов. */
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[^a-z0-9а-яё_]+/)
+        .filter((t) => t.length > 3));
+}
+async function findSimilar(store, input) {
+    const newText = `${input.name} ${input.contractIn ?? ''} ${input.contractOut ?? ''}`;
+    const newTokens = tokenize(newText);
+    const tools = await store.list({ type: 'tool' });
+    const similar = [];
+    for (const obj of tools) {
+        if (!LIVE_STATUSES.includes(obj.status))
+            continue;
+        const t = asTool(obj);
+        const existingTokens = tokenize(`${t.name} ${t.contract_input ?? ''} ${t.contract_output ?? ''}`);
+        const nameMatch = t.name === input.name;
+        const tokenMatch = [...newTokens].some((tok) => existingTokens.has(tok));
+        if (nameMatch || tokenMatch)
+            similar.push({ id: t.id, name: t.name, status: t.status });
+    }
+    return similar;
+}
+/** Валидный идентификатор инструмента (он же имя файла и ключ lookup). */
+const NAME_RE = /^[a-z0-9][a-z0-9_-]*$/;
+/** Резолв ссылки на tool: mem_-id напрямую, иначе уникальное совпадение по полю name. */
+async function resolveToolRef(deps, nameOrId) {
+    if (nameOrId.startsWith('mem_')) {
+        const obj = await deps.store.get(nameOrId);
+        if (!obj || obj.type !== 'tool')
+            throw new UserFacingError(`Tool не найден: ${nameOrId}`);
+        return asTool(obj);
+    }
+    const matches = (await deps.store.list({ type: 'tool' })).filter((o) => asTool(o).name === nameOrId);
+    if (matches.length === 0)
+        throw new UserFacingError(`Tool не найден: ${nameOrId}`);
+    if (matches.length > 1) {
+        throw new UserFacingError(`Неоднозначное имя инструмента "${nameOrId}" (${matches.length} объектов): ${matches.map((m) => m.id).join(', ')}`);
+    }
+    return asTool(matches[0]);
+}
+export async function registerTool(deps, input) {
+    const run = async () => {
+        // имя = имя файла в .wolf/tools/ и ключ `tool use <name>`: без слэшей/точек/путей.
+        if (!NAME_RE.test(input.name)) {
+            throw new UserFacingError(`Недопустимое имя инструмента "${input.name}": только [a-z0-9-_], начинается с цифры/буквы`);
+        }
+        const absSrc = isAbsolute(input.scriptPath) ? input.scriptPath : join(deps.baseDir, input.scriptPath);
+        if (!(await deps.fs.exists(absSrc))) {
+            throw new UserFacingError(`Скрипт не найден: ${absSrc}`);
+        }
+        // Коллизия имени — всегда отказ (даже с --force): name — ключ lookup'а,
+        // второй объект затёр бы канонический скрипт первого.
+        const taken = (await deps.store.list({ type: 'tool' })).filter((o) => LIVE_STATUSES.includes(o.status) && asTool(o).name === input.name);
+        if (taken.length > 0) {
+            const list = taken.map((o) => `${o.id} [${o.status}]`).join('; ');
+            throw new UserFacingError(`Имя "${input.name}" уже занято: ${list}. Выбери другое имя`);
+        }
+        // Dedup-подсказка (search-before-write): похожие по контракту — только предупреждение.
+        const similar = await findSimilar(deps.store, input);
+        if (similar.length > 0 && !input.force) {
+            const list = similar.map((s) => `${s.name} (${s.id}) [${s.status}]`).join('; ');
+            throw new UserFacingError(`Найдены похожие инструменты: ${list}. Подтверди намерение флагом --force`);
+        }
+        const relDest = join('.wolf', 'tools', `${input.name}${extname(absSrc)}`);
+        const content = await deps.fs.readSmallTextFile(absSrc);
+        if (content === null)
+            throw new UserFacingError(`Скрипт не найден: ${absSrc}`);
+        await deps.fs.writeFile(join(deps.baseDir, relDest), content);
+        const extra = {
+            name: input.name,
+            script_path: relDest,
+            language: input.language,
+            // store.save не применяет zod-дефолты — usage_count задаём явно.
+            usage_count: 0,
+        };
+        if (input.contractIn !== undefined)
+            extra.contract_input = input.contractIn;
+        if (input.contractOut !== undefined)
+            extra.contract_output = input.contractOut;
+        if (input.contractEnvironment !== undefined)
+            extra.contract_environment = input.contractEnvironment;
+        const { object } = await addMemoryObject({
+            store: deps.store,
+            log: deps.log,
+            clock: deps.clock,
+            idGen: deps.idGen,
+            index: deps.index,
+            // lock не передаём: мы уже внутри deps.lock.withLock (FsMemoryLock не реентерабелен)
+            declarations: deps.declarations,
+        }, {
+            type: 'tool',
+            title: `Tool: ${input.name}`,
+            body: input.notes ?? '',
+            createdBy: input.createdBy,
+            extra,
+        });
+        return { toolId: object.id, scriptPath: relDest, similar };
+    };
+    return deps.lock ? deps.lock.withLock(run) : run();
+}
+export async function listTools(deps, filters = {}) {
+    const tools = await deps.store.list({ type: 'tool', status: filters.status });
+    return tools.map(asTool).sort((a, b) => a.name.localeCompare(b.name));
+}
+export async function useTool(deps, input) {
+    const run = async () => {
+        const tool = await resolveToolRef(deps, input.nameOrId);
+        const now = deps.clock.now();
+        const usageCount = (tool.usage_count ?? 0) + 1;
+        const patch = { usage_count: usageCount, last_used_at: now.toISOString() };
+        const updated = await deps.store.update(tool.id, patch);
+        await deps.log.append({
+            id: deps.idGen.generateEventId(now),
+            // 'tool.used' не входит в enum MemoryEventSchema (файл вне зоны C2) —
+            // маркируем через payload.kind, тип оставляем валидным memory.updated.
+            type: 'memory.updated',
+            timestamp: now.toISOString(),
+            actor: input.actor,
+            payload: { memory_id: tool.id, usage_count: usageCount, kind: 'tool.used' },
+        });
+        if (deps.index) {
+            await deps.index.indexObject(updated);
+        }
+        return asTool(updated);
+    };
+    return deps.lock ? deps.lock.withLock(run) : run();
+}
+/** Детерминированный контент SKILL.md из объекта tool — повторная генерация даёт тот же текст. */
+export function toolSkillContent(tool) {
+    const description = tool.contract_output ?? 'скрипт из памяти Wolf';
+    return [
+        `<!-- generated from tool:${tool.id} -->`,
+        '---',
+        `name: ${tool.name}`,
+        `description: Tool ${tool.name} — ${description}.`,
+        '---',
+        '',
+        `# Tool ${tool.name}`,
+        '',
+        `- Input: ${tool.contract_input ?? '—'}`,
+        `- Output: ${tool.contract_output ?? '—'}`,
+        `- Environment: ${tool.contract_environment ?? '—'}`,
+        `- Script: \`${tool.script_path}\` (каноничный файл; Wolf его не исполняет)`,
+        '',
+        '## Инструкция',
+        '',
+        `Вызови скрипт и учти вывод. После использования отметь факт: \`wolf tool use ${tool.name}\`.`,
+        '',
+    ].join('\n');
+}
+export async function exposeTool(deps, input) {
+    const tool = await resolveToolRef(deps, input.nameOrId);
+    const relPath = join('.opencode', 'skills', tool.name, 'SKILL.md');
+    const content = toolSkillContent(tool);
+    await deps.fs.writeFile(join(deps.baseDir, relPath), content);
+    return { path: relPath, content };
+}
+export async function deprecateTool(deps, input) {
+    if (!input.reason || input.reason.trim() === '') {
+        throw new UserFacingError('Причина депрекации обязательна (--reason)');
+    }
+    const tool = await resolveToolRef(deps, input.nameOrId);
+    await transitionMemoryObject(deps, tool.id, 'deprecated', input.actor);
+    const patch = { deprecation_reason: input.reason };
+    await deps.store.update(tool.id, patch);
+    const final = await deps.store.get(tool.id);
+    if (!final)
+        throw new Error(`Tool object disappeared: ${tool.id}`);
+    return asTool(final);
+}
+export async function reviveTool(deps, input) {
+    const tool = await resolveToolRef(deps, input.nameOrId);
+    await transitionMemoryObject(deps, tool.id, 'active', input.actor);
+    const final = await deps.store.get(tool.id);
+    if (!final)
+        throw new Error(`Tool object disappeared: ${tool.id}`);
+    return asTool(final);
+}
+//# sourceMappingURL=tool-librarian.js.map