lv24-opencode-consilium 0.0.0-stage → 1.4.0

package/dist/variants.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview Варианты моделей OpenCode (`provider/model#variant`).
+ * @module lv24-opencode-consilium
+ *
+ * Ссылка на модель: `provider/model` с необязательным `#variant`.
+ * Провайдер заканчивается на первом `/`; в имени модели `/` допустим;
+ * вариант следует за первым `#`; в `provider/model` символа `#` нет.
+ */
+import { splitModelRef } from './compat.js';
+/** Допустимый вариант модели: латиница/цифры, далее латиница/цифры/`._-` */
+export const VARIANT_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/** Проверяет вариант (с триммингом); пустой/некорректный — `false` */
+export function isValidVariant(variant) {
+    const trimmed = variant.trim();
+    if (trimmed.length === 0)
+        return false;
+    return VARIANT_PATTERN.test(trimmed);
+}
+/** Возвращает часть после первого `#` (пустая — `undefined`); без `#` — `undefined` */
+export function variantOf(ref) {
+    return splitModelRef(ref).variant;
+}
+/** Убирает `#...` с конца; остальной текст сохраняет как есть (без трима) */
+export function stripVariant(ref) {
+    return splitModelRef(ref).model;
+}
+/** Проверяет базу `provider/model`: непустая и содержит `/` */
+function assertValidBase(base, ref) {
+    if (base.length === 0 || !base.includes('/')) {
+        throw new Error(`Некорректная модель: ${ref}`);
+    }
+}
+/**
+ * Ставит вариант на ссылку: `undefined`/`''` — снять вариант,
+ * иначе заменить/добавить `#variant`. База обязана содержать `/`.
+ */
+export function withVariant(ref, variant) {
+    if (variant === undefined || variant === '') {
+        const base = stripVariant(ref);
+        assertValidBase(base, ref);
+        return base;
+    }
+    const trimmed = variant.trim();
+    if (!isValidVariant(trimmed)) {
+        throw new Error(`Некорректный вариант модели: ${variant}`);
+    }
+    const base = stripVariant(ref);
+    assertValidBase(base, ref);
+    return `${base}#${trimmed}`;
+}
+/**
+ * Применяет вариант ко всем моделям: у кого вариант уже есть — оставить,
+ * корректным `provider/model` без варианта — добавить `#variant`,
+ * некорректные id — оставить без изменений. Новый объект, вход не мутирует.
+ */
+export function applyVariant(models, variant) {
+    const trimmed = variant.trim();
+    if (!isValidVariant(trimmed)) {
+        throw new Error(`Некорректный вариант модели: ${variant}`);
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(models)) {
+        if (typeof value !== 'string') {
+            out[key] = value;
+            continue;
+        }
+        if (value.trim().length === 0) {
+            out[key] = value;
+            continue;
+        }
+        if (variantOf(value) !== undefined) {
+            out[key] = value;
+            continue;
+        }
+        const base = stripVariant(value);
+        if (base.length === 0 || !base.includes('/')) {
+            out[key] = value;
+            continue;
+        }
+        out[key] = `${base}#${trimmed}`;
+    }
+    return out;
+}
+/** То же для массива; дедупликация с сохранением порядка */
+export function applyVariantList(models, variant) {
+    const trimmed = variant.trim();
+    if (!isValidVariant(trimmed)) {
+        throw new Error(`Некорректный вариант модели: ${variant}`);
+    }
+    const seen = new Set();
+    const out = [];
+    for (const ref of models) {
+        let next;
+        if (typeof ref !== 'string' || ref.trim().length === 0) {
+            next = ref;
+        }
+        else if (variantOf(ref) !== undefined) {
+            next = ref;
+        }
+        else {
+            const base = stripVariant(ref);
+            next = base.length === 0 || !base.includes('/') ? ref : `${base}#${trimmed}`;
+        }
+        if (!seen.has(next)) {
+            seen.add(next);
+            out.push(next);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=variants.js.map

package/dist/variants.js.map

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

package/dist/verify.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Проверка доступности бесплатных моделей реальным вызовом
+ * @module lv24-opencode-consilium
+ */
+import type { FreeModel } from './models.js';
+/** Результат проверки одной модели */
+export interface ModelVerification {
+    model: FreeModel;
+    ok: boolean;
+    ms: number;
+    error?: string;
+}
+export interface VerifyModelsOptions {
+    concurrency?: number;
+    timeoutMs?: number;
+    cwd?: string;
+    opencodePath?: string;
+    prompt?: string;
+}
+/**
+ * Проверяет модели коротким реальным запросом через OpenCode.
+ * Возвращает результаты в исходном порядке.
+ */
+export declare function verifyModels(models: FreeModel[], options?: VerifyModelsOptions): Promise<ModelVerification[]>;
+/**
+ * Проверяет кандидатов и возвращает только рабочие модели (в порядке рейтинга).
+ */
+export declare function filterWorkingModels(models: FreeModel[], options?: VerifyModelsOptions): Promise<{
+    working: FreeModel[];
+    failed: ModelVerification[];
+    checked: ModelVerification[];
+}>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsD9B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAS9F"}

package/dist/verify.js

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Проверка доступности бесплатных моделей реальным вызовом
+ * @module lv24-opencode-consilium
+ */
+import { callAgent } from './agents.js';
+import { mergeWithDefaults } from './config.js';
+function clampConcurrency(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return 4;
+    return Math.max(1, Math.min(8, Math.floor(value)));
+}
+/**
+ * Проверяет модели коротким реальным запросом через OpenCode.
+ * Возвращает результаты в исходном порядке.
+ */
+export async function verifyModels(models, options = {}) {
+    if (models.length === 0)
+        return [];
+    const concurrency = clampConcurrency(options.concurrency);
+    const timeoutMs = options.timeoutMs !== undefined && Number.isFinite(options.timeoutMs) && options.timeoutMs > 0
+        ? options.timeoutMs
+        : 60000;
+    const prompt = options.prompt ?? 'Ответь ровно одним словом: ок. Не вызывай инструменты.';
+    const config = mergeWithDefaults({
+        cwd: options.cwd,
+        opencodePath: options.opencodePath,
+        standalone: true,
+        timeouts: { expert: timeoutMs, chair: timeoutMs, shutdown: 1000 },
+        retry: {
+            expertRetries: 0,
+            chairRetries: 0,
+            delay: 0,
+            exponentialBackoff: false,
+            maxConcurrency: concurrency
+        }
+    });
+    const results = new Array(models.length);
+    let nextIndex = 0;
+    const worker = async () => {
+        for (;;) {
+            const index = nextIndex;
+            nextIndex += 1;
+            if (index >= models.length)
+                return;
+            const model = models[index];
+            const result = await callAgent('', prompt, config, {
+                timeout: timeoutMs,
+                retries: 0,
+                model: model.id
+            });
+            results[index] = {
+                model,
+                ok: result.success,
+                ms: result.duration ?? 0,
+                error: result.success
+                    ? undefined
+                    : result.errorMessage ?? result.errorCode ?? 'нет ответа'
+            };
+        }
+    };
+    const workerCount = Math.min(concurrency, models.length);
+    await Promise.all(Array.from({ length: workerCount }, () => worker()));
+    return results;
+}
+/**
+ * Проверяет кандидатов и возвращает только рабочие модели (в порядке рейтинга).
+ */
+export async function filterWorkingModels(models, options = {}) {
+    const checks = await verifyModels(models, options);
+    const working = [];
+    const failed = [];
+    for (const check of checks) {
+        if (check.ok)
+            working.push(check.model);
+        else
+            failed.push(check);
+    }
+    return { working, failed, checked: checks };
+}
+//# sourceMappingURL=verify.js.map

package/dist/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBhD,SAAS,gBAAgB,CAAC,KAAyB;IACjD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAmB,EACnB,UAA+B,EAAE;IAEjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC;QAC5F,CAAC,CAAC,OAAO,CAAC,SAAS;QACnB,CAAC,CAAC,KAAK,CAAC;IACZ,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,wDAAwD,CAAC;IAE1F,MAAM,MAAM,GAAoB,iBAAiB,CAAC;QAChD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;QACjE,KAAK,EAAE;YACL,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,KAAK,EAAE,CAAC;YACR,kBAAkB,EAAE,KAAK;YACzB,cAAc,EAAE,WAAW;SAC5B;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAwB,IAAI,KAAK,CAAoB,MAAM,CAAC,MAAM,CAAC,CAAC;IACjF,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,SAAS,CAAC;YACxB,SAAS,IAAI,CAAC,CAAC;YACf,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM;gBAAE,OAAO;YAEnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;gBACjD,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,KAAK,CAAC,EAAE;aAChB,CAAC,CAAC;YAEH,OAAO,CAAC,KAAK,CAAC,GAAG;gBACf,KAAK;gBACL,EAAE,EAAE,MAAM,CAAC,OAAO;gBAClB,EAAE,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;gBACxB,KAAK,EAAE,MAAM,CAAC,OAAO;oBACnB,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,SAAS,IAAI,YAAY;aAC5D,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAmB,EACnB,UAA+B,EAAE;IAEjC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;;YACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC"}

package/dist/watch.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Watch mode (debounced fs.watch) and git pre-commit hook helpers.
+ * @module lv24-opencode-consilium
+ */
+/** Опции createProjectWatcher */
+export interface WatchOptions {
+    cwd?: string;
+    debounceMs?: number;
+    ignore?: string[];
+    onTrigger: (paths: string[]) => void | Promise<void>;
+}
+/** Игнорируемые пути/глобы по умолчанию (всегда применяются вместе с пользовательскими) */
+export declare const DEFAULT_IGNORE_PATTERNS: readonly string[];
+/**
+ * Проверяет, попадает ли путь под ignore-паттерны.
+ * Плоские имена (`.git`, `dist`) матчатся как полный сегмент пути —
+ * поэтому работают и для абсолютных путей внутри игнорируемых директорий.
+ * Паттерны со `*` (`*.tmp`) матчатся против всего пути и basename.
+ * Паттерны со `/` матчатся как префикс/подпуть.
+ */
+export declare function shouldIgnore(relativePath: string, ignore?: string[]): boolean;
+/**
+ * Создаёт дебаунсер: собирает пути в Set, сбрасывает таймер на каждый push,
+ * вызывает fn один раз с отсортированным массивом. flush срабатывает сразу,
+ * cancel всё сбрасывает; повторный вызов без новых данных ничего не делает.
+ */
+export declare function createDebouncer(ms: number, fn: (paths: string[]) => void): {
+    push(path: string): void;
+    cancel(): void;
+    flush(): void;
+};
+/**
+ * Создаёт вотчер проекта: `fs.watch(cwd, { recursive: true })`,
+ * при исключении — обычный (нерекурсивный) watch cwd.
+ * Игнорируемые пути отфильтровываются, срабатывания дебаунсятся
+ * (400 мс по умолчанию). Ошибки onTrigger логируются в console.error
+ * и никогда не роняют процесс. Возвращает `{ close }`.
+ */
+export declare function createProjectWatcher(options: WatchOptions): {
+    close(): void;
+};
+/** Возвращает полный текст standalone pre-commit hook для команды */
+export declare function buildPreCommitHook(command: string): string;
+/**
+ * Возвращает каталог hooks с учётом `.git`-файла (worktree/submodule) и
+ * настройки `core.hooksPath`. Бросает понятную ошибку, если репозитория нет.
+ */
+export declare function resolveHooksDir(cwd: string): string;
+/**
+ * Вставляет/обновляет блок consilium в существующем hook-файле.
+ * Все существующие блоки заменяются одним (дублей нет).
+ * Блок вставляется перед первым `exit`/`exec`, чтобы не оказаться мёртвым.
+ */
+export declare function upsertHookBlock(existing: string, command: string): string;
+/** Удаляет блок(и) consilium, остальное содержимое оставляет нетронутым */
+export declare function removeHookBlock(existing: string): string;
+/**
+ * Устанавливает pre-commit hook в `<cwd>/.git/hooks/pre-commit`.
+ * Существующий hook сохраняется (блок добавляется/обновляется через upsert).
+ * Бросает понятную ошибку, если `.git` отсутствует.
+ * Возвращает `created=false`, если файл уже существовал.
+ */
+export declare function installPreCommitHook(cwd: string, command: string): {
+    path: string;
+    created: boolean;
+};
+/**
+ * Удаляет блок consilium из pre-commit hook.
+ * Если файл стал фактически пустым (только shebang/whitespace/set) —
+ * удаляет его. Возвращает true, если блок был удалён, иначе false.
+ */
+export declare function uninstallPreCommitHook(cwd: string): boolean;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAKD,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EASpD,CAAC;AAyBF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CA2C7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GAC5B;IACD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACf,CAqCA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAwD7E;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiCnD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA6BzE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMxD;AASD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA6BpC;AAYD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA6B3D"}

package/dist/watch.js

@@ -0,0 +1,350 @@
+/**
+ * @fileoverview Watch mode (debounced fs.watch) and git pre-commit hook helpers.
+ * @module lv24-opencode-consilium
+ */
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, statSync, unlinkSync, watch, writeFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+/** Debounce вотчера по умолчанию, мс */
+const DEFAULT_DEBOUNCE_MS = 400;
+/** Игнорируемые пути/глобы по умолчанию (всегда применяются вместе с пользовательскими) */
+export const DEFAULT_IGNORE_PATTERNS = [
+    '.git',
+    'node_modules',
+    'dist',
+    '.consilium',
+    'coverage',
+    '*.tmp',
+    '*.log',
+    '.DS_Store'
+];
+/** Маркер начала блока consilium в hook-файле */
+const HOOK_BLOCK_START = '# >>> consilium >>>';
+/** Маркер конца блока consilium в hook-файле */
+const HOOK_BLOCK_END = '# <<< consilium <<<';
+/** Все блоки consilium (upsert заменяет их одним, remove удаляет все) */
+const HOOK_BLOCK_RE_ALL = /# >>> consilium >>>[\s\S]*?# <<< consilium <<</g;
+/** Нормализует путь: `\` -> `/` */
+function normalizeSlashes(p) {
+    return p.replace(/\\/g, '/');
+}
+/** Преобразует простой `*`-глоб в RegExp, экранируя остальное */
+function globToRegExp(glob) {
+    const body = glob
+        .split('*')
+        .map(part => part.replace(/[.+?^${}()|[\]\\]/g, '\\$&'))
+        .join('.*');
+    return new RegExp(`^${body}$`);
+}
+/**
+ * Проверяет, попадает ли путь под ignore-паттерны.
+ * Плоские имена (`.git`, `dist`) матчатся как полный сегмент пути —
+ * поэтому работают и для абсолютных путей внутри игнорируемых директорий.
+ * Паттерны со `*` (`*.tmp`) матчатся против всего пути и basename.
+ * Паттерны со `/` матчатся как префикс/подпуть.
+ */
+export function shouldIgnore(relativePath, ignore) {
+    const patterns = [...DEFAULT_IGNORE_PATTERNS, ...(ignore ?? [])];
+    const normalized = normalizeSlashes(relativePath)
+        .replace(/^\.\//, '')
+        .replace(/\/+$/, '');
+    if (normalized.length === 0 || normalized === '.') {
+        return false;
+    }
+    const segments = normalized.split('/').filter(s => s.length > 0 && s !== '.');
+    if (segments.length === 0) {
+        return false;
+    }
+    const basename = segments[segments.length - 1];
+    for (const raw of patterns) {
+        const pattern = normalizeSlashes(raw).replace(/\/+$/, '');
+        if (pattern.length === 0 || pattern === '.') {
+            continue;
+        }
+        if (pattern.includes('*')) {
+            const re = globToRegExp(pattern);
+            if (re.test(normalized) || re.test(basename)) {
+                return true;
+            }
+            continue;
+        }
+        if (pattern.includes('/')) {
+            const clean = pattern.replace(/^\.\//, '');
+            if (normalized === clean ||
+                normalized.startsWith(`${clean}/`) ||
+                normalized.endsWith(`/${clean}`) ||
+                normalized.includes(`/${clean}/`)) {
+                return true;
+            }
+            continue;
+        }
+        if (segments.includes(pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Создаёт дебаунсер: собирает пути в Set, сбрасывает таймер на каждый push,
+ * вызывает fn один раз с отсортированным массивом. flush срабатывает сразу,
+ * cancel всё сбрасывает; повторный вызов без новых данных ничего не делает.
+ */
+export function createDebouncer(ms, fn) {
+    const pending = new Set();
+    let timer;
+    const fire = () => {
+        timer = undefined;
+        if (pending.size === 0) {
+            return;
+        }
+        const paths = [...pending].sort();
+        pending.clear();
+        fn(paths);
+    };
+    return {
+        push(filePath) {
+            pending.add(filePath);
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            timer = setTimeout(fire, ms);
+        },
+        cancel() {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            pending.clear();
+        },
+        flush() {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            fire();
+        }
+    };
+}
+/**
+ * Создаёт вотчер проекта: `fs.watch(cwd, { recursive: true })`,
+ * при исключении — обычный (нерекурсивный) watch cwd.
+ * Игнорируемые пути отфильтровываются, срабатывания дебаунсятся
+ * (400 мс по умолчанию). Ошибки onTrigger логируются в console.error
+ * и никогда не роняют процесс. Возвращает `{ close }`.
+ */
+export function createProjectWatcher(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    const ignore = [...DEFAULT_IGNORE_PATTERNS, ...(options.ignore ?? [])];
+    let stopped = false;
+    const debouncer = createDebouncer(debounceMs, (paths) => {
+        if (stopped) {
+            return;
+        }
+        try {
+            const result = options.onTrigger(paths);
+            if (result instanceof Promise) {
+                result.catch((error) => {
+                    console.error(error);
+                });
+            }
+        }
+        catch (error) {
+            console.error(error);
+        }
+    });
+    const onFilename = (filename) => {
+        if (stopped || filename === null) {
+            return;
+        }
+        const name = typeof filename === 'string' ? filename : filename.toString('utf8');
+        if (name.length === 0) {
+            return;
+        }
+        const normalized = normalizeSlashes(name);
+        if (shouldIgnore(normalized, ignore)) {
+            return;
+        }
+        debouncer.push(normalized);
+    };
+    let watcher;
+    try {
+        watcher = watch(cwd, { recursive: true }, (_event, filename) => onFilename(filename));
+    }
+    catch {
+        watcher = watch(cwd, (_event, filename) => onFilename(filename));
+    }
+    watcher.on('error', (error) => {
+        if (!stopped) {
+            console.error(error);
+        }
+    });
+    return {
+        close() {
+            stopped = true;
+            debouncer.cancel();
+            watcher.close();
+        }
+    };
+}
+/** Возвращает полный текст standalone pre-commit hook для команды */
+export function buildPreCommitHook(command) {
+    return `#!/bin/sh\nset -e\n${command}\n`;
+}
+/** Допустимые интерпретаторы для существующего pre-commit hook */
+const SHELL_INTERPRETERS = new Set(['sh', 'bash', 'dash', 'zsh', 'ksh']);
+/**
+ * Возвращает каталог hooks с учётом `.git`-файла (worktree/submodule) и
+ * настройки `core.hooksPath`. Бросает понятную ошибку, если репозитория нет.
+ */
+export function resolveHooksDir(cwd) {
+    // git сам знает про worktrees, submodules, core.hooksPath и подкаталоги.
+    try {
+        const resolved = execFileSync('git', ['rev-parse', '--git-path', 'hooks'], {
+            cwd,
+            encoding: 'utf8',
+            windowsHide: true
+        }).trim();
+        if (resolved.length > 0) {
+            return path.isAbsolute(resolved) ? resolved : path.resolve(cwd, resolved);
+        }
+    }
+    catch {
+        // git недоступен или каталог не является репозиторием — пробуем вручную
+    }
+    const gitPath = path.join(cwd, '.git');
+    if (!existsSync(gitPath)) {
+        throw new Error(`Cannot install pre-commit hook: no .git directory in "${cwd}" (run "git init" first).`);
+    }
+    let gitDir = gitPath;
+    if (statSync(gitPath).isFile()) {
+        const content = readFileSync(gitPath, 'utf8').trim();
+        const match = /^gitdir:\s*(.+)$/m.exec(content);
+        if (!match || match[1] === undefined) {
+            throw new Error(`Не удалось разобрать .git-файл в "${cwd}"`);
+        }
+        gitDir = path.resolve(cwd, match[1].trim());
+    }
+    return path.join(gitDir, 'hooks');
+}
+/**
+ * Вставляет/обновляет блок consilium в существующем hook-файле.
+ * Все существующие блоки заменяются одним (дублей нет).
+ * Блок вставляется перед первым `exit`/`exec`, чтобы не оказаться мёртвым.
+ */
+export function upsertHookBlock(existing, command) {
+    const eol = existing.includes('\r\n') ? '\r\n' : '\n';
+    const block = `${HOOK_BLOCK_START}${eol}${command}${eol}${HOOK_BLOCK_END}`;
+    const firstStart = existing.indexOf(HOOK_BLOCK_START);
+    const lastEnd = existing.lastIndexOf(HOOK_BLOCK_END);
+    if (firstStart !== -1 && lastEnd > firstStart) {
+        // Схлопываем все блоки (включая мусор между ними) в один.
+        return (existing.slice(0, firstStart) +
+            block +
+            existing.slice(lastEnd + HOOK_BLOCK_END.length));
+    }
+    if (existing.trim().length === 0) {
+        return `#!/bin/sh${eol}set -e${eol}${block}${eol}`;
+    }
+    const exitMatch = /^[ \t]*(?:exit|exec)\b.*$/m.exec(existing);
+    if (exitMatch && exitMatch.index !== undefined) {
+        const before = existing.slice(0, exitMatch.index);
+        const after = existing.slice(exitMatch.index);
+        const separator = before.endsWith('\n') ? '' : eol;
+        return `${before}${separator}${block}${eol}${after}`;
+    }
+    const prefix = existing.endsWith('\n') ? existing : `${existing}${eol}`;
+    return `${prefix}${block}${eol}`;
+}
+/** Удаляет блок(и) consilium, остальное содержимое оставляет нетронутым */
+export function removeHookBlock(existing) {
+    const without = existing.replace(HOOK_BLOCK_RE_ALL, () => '');
+    if (without === existing) {
+        return existing;
+    }
+    return without;
+}
+/** Атомарная запись (tmp-файл + rename в той же директории) */
+function writeFileAtomic(filePath, content) {
+    const tmpPath = `${filePath}.consilium-${process.pid}.tmp`;
+    writeFileSync(tmpPath, content, 'utf8');
+    renameSync(tmpPath, filePath);
+}
+/**
+ * Устанавливает pre-commit hook в `<cwd>/.git/hooks/pre-commit`.
+ * Существующий hook сохраняется (блок добавляется/обновляется через upsert).
+ * Бросает понятную ошибку, если `.git` отсутствует.
+ * Возвращает `created=false`, если файл уже существовал.
+ */
+export function installPreCommitHook(cwd, command) {
+    const hooksDir = resolveHooksDir(cwd);
+    mkdirSync(hooksDir, { recursive: true });
+    const hookPath = path.join(hooksDir, 'pre-commit');
+    const existed = existsSync(hookPath);
+    const existing = existed ? readFileSync(hookPath, 'utf8') : '';
+    if (existing.trim().length > 0) {
+        const firstLine = existing.split(/\r?\n/).find(line => line.trim().length > 0) ?? '';
+        if (firstLine.startsWith('#!')) {
+            const interpreter = firstLine.slice(2).trim().split(/\s+/)[0] ?? '';
+            const base = path.basename(interpreter);
+            if (!SHELL_INTERPRETERS.has(base)) {
+                throw new Error(`Cannot install pre-commit hook: existing hook uses "${interpreter}". ` +
+                    'Add the consilium block manually or convert the hook to a shell script.');
+            }
+        }
+    }
+    writeFileAtomic(hookPath, upsertHookBlock(existing, command));
+    try {
+        chmodSync(hookPath, 0o755);
+    }
+    catch {
+        // Windows: chmod без эффекта, игнорируем.
+    }
+    return { path: hookPath, created: !existed };
+}
+/** Проверяет, не осталось ли в hook-файле только служебного содержимого */
+function isEffectivelyEmptyHook(content) {
+    return content
+        .split('\n')
+        .every(line => {
+        const trimmed = line.trim();
+        return trimmed === '' || trimmed.startsWith('#!') || trimmed.startsWith('set ');
+    });
+}
+/**
+ * Удаляет блок consilium из pre-commit hook.
+ * Если файл стал фактически пустым (только shebang/whitespace/set) —
+ * удаляет его. Возвращает true, если блок был удалён, иначе false.
+ */
+export function uninstallPreCommitHook(cwd) {
+    let hookPath;
+    try {
+        hookPath = path.join(resolveHooksDir(cwd), 'pre-commit');
+    }
+    catch {
+        return false;
+    }
+    if (!existsSync(hookPath)) {
+        return false;
+    }
+    const existing = readFileSync(hookPath, 'utf8');
+    const next = removeHookBlock(existing);
+    if (next === existing) {
+        return false;
+    }
+    if (isEffectivelyEmptyHook(next)) {
+        unlinkSync(hookPath);
+        return true;
+    }
+    const mode = statSync(hookPath).mode & 0o777;
+    writeFileAtomic(hookPath, next);
+    try {
+        // Сохраняем исполняемость: иначе git молча перестанет запускать hook.
+        chmodSync(hookPath, mode | 0o100);
+    }
+    catch {
+        // Windows: chmod без эффекта, игнорируем.
+    }
+    return true;
+}
+//# sourceMappingURL=watch.js.map