@nitra/cursor 3.28.0 → 3.29.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [3.29.0] - 2026-06-07
+
+### Added
+
+- resolveModel(tier) — прозорий каскадний fallback local→cloud для всіх 3 тирів (min/avg/max)
+
 ## [3.28.0] - 2026-06-06
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "3.28.0",
+  "version": "3.29.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -51,8 +51,6 @@
     "rename-yaml-extensions": "bun ./bin/n-cursor.js rename-yaml-extensions"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.0",
-    "@anthropic-ai/sdk": "^0.100.1",
     "oxc-parser": "^0.128.0",
     "picomatch": "^4.0.4",
     "smol-toml": "^1.6.1",

package/scripts/coverage-classify/index.mjs

@@ -1,26 +1,20 @@
 /**
  * Public API класифікатора: classify(survived, cwd, opts) → verdicts[]
  *
- * Orchestration:
- *   1. Перевірка ANTHROPIC_API_KEY + dynamic import SDK (graceful skip).
- *   2. Для кожного мутанта: cache lookup → класифікація → cache write.
- *   3. На неуспішну класифікацію після retries — conservative fallback worth-testing/confidence=0.
- *
- * Prompt caching: system-prompt передається з cache_control: ephemeral —
- * усі мутанти одного прогону reuse кешований префікс на стороні API.
+ * Routing:
+ *   1. Cache lookup → hit → використати збережений verdict.
+ *   2. Cache miss → Tier 1 (LOCAL_MIN через pi) → parseVerdict.
+ *   3. Tier 1 fail (pi error / bad JSON / Zod) → Tier 2 (CLOUD_MIN через pi).
+ *   4. Tier 2 fail → conservative fallback worth-testing/confidence=0.
  */
+import { spawnSync } from 'node:child_process'
 import { join } from 'node:path'
-import { env } from 'node:process'
-import { setTimeout } from 'node:timers/promises'
 
+import { CLOUD_MIN, resolveModel } from '../../lib/models.mjs'
 import { deriveCacheKey, readCache, writeCache } from './cache.mjs'
 import { buildUserPrompt, SYSTEM_PROMPT } from './prompt.mjs'
 import { parseVerdict } from './verdict-schema.mjs'
 
-const MODEL = 'claude-sonnet-4-6'
-const MAX_RETRIES = 2
-const DEFAULT_RETRY_DELAY_MS = 1000
-
 const FALLBACK_VERDICT = {
   verdict: 'worth-testing',
   confidence: 0,
@@ -28,36 +22,67 @@ const FALLBACK_VERDICT = {
 }
 
 /**
- * Класифікує survived мутантів через Claude API.
- * Без API key / без SDK / при критичних помилках — повертає [] (graceful skip).
- * @param {Array<{file: string, mutants: Array<object>, exampleTest?: object|null, recommendationText?: string|null}>} survived список survived груп (як у COVERAGE.md)
- * @param {string} cwd корінь проєкту
- * @param {{cachePath?: string, client?: object, retryDelayMs?: number}} [opts] ін'єкції для тестів
- * @returns {Promise<Array<{key: string, verdict: object}>>} verdicts
+ * Викликає pi і повертає raw stdout.
+ * @param {string} prompt
+ * @param {string} model  provider/model-id або '' для pi-дефолту
+ * @returns {string}
+ * @throws якщо pi не знайдено або повертає ненульовий exit code
  */
-export async function classify(survived, cwd, opts = {}) {
-  const cachePath = opts.cachePath ?? join(cwd, 'npm/reports/coverage-classify.cache.json')
-  const retryDelayMs = opts.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS
+function callPi(prompt, model) {
+  const modelArgs = model ? ['--model', model] : []
+  const r = spawnSync('pi', ['-p', prompt, ...modelArgs, '--no-session', '--mode', 'text', '--no-tools'], {
+    encoding: 'utf8',
+    timeout: 60_000
+  })
+  if (r.error) throw new Error(`pi error: ${r.error.message}`)
+  if (r.status !== 0) throw new Error(`pi exit ${r.status}: ${r.stderr?.slice(0, 200) ?? ''}`)
+  return r.stdout?.trim() ?? ''
+}
 
-  if (!env.ANTHROPIC_API_KEY) {
-    console.warn('⚠ coverage classify: ANTHROPIC_API_KEY not set, classification skipped')
-    return []
-  }
+/**
+ * Два тири: LOCAL_MIN → Tier 2 CLOUD_MIN → FALLBACK_VERDICT.
+ * @param {{file: string, mutants: object[]}} group
+ * @param {object} mutant
+ * @param {string} cwd
+ * @param {(prompt: string, model: string) => string} callPiFn  ін'єкція для тестів
+ * @returns {object} verdict
+ */
+function classifyOne(group, mutant, cwd, callPiFn) {
+  const prompt = `${SYSTEM_PROMPT}\n\n${buildUserPrompt({ ...mutant, file: group.file }, cwd)}`
+  const loc = `${group.file}:${mutant.line}:${mutant.col}`
 
-  let SDK
+  // Tier 1: resolveModel('min') — каскад local→cloud якщо локалі нема
   try {
-    SDK = await import('@anthropic-ai/sdk')
+    const text = callPiFn(prompt, resolveModel('min'))
+    return parseVerdict(text)
   } catch {
-    console.warn('⚠ coverage classify: @anthropic-ai/sdk not installed, classification skipped')
-    return []
+    // Tier 2: CLOUD_MIN
+    try {
+      const text = callPiFn(prompt, CLOUD_MIN)
+      return parseVerdict(text)
+    } catch (e) {
+      console.warn(`⚠ coverage classify: ${loc} both tiers failed: ${e.message}`)
+      return { ...FALLBACK_VERDICT }
+    }
   }
-  const Anthropic = SDK.default
-  const client = opts.client ?? new Anthropic()
+}
+
+/**
+ * Класифікує survived мутантів через pi (LOCAL_MIN → CLOUD_MIN → fallback).
+ * @param {Array<{file: string, mutants: object[], exampleTest?: object|null, recommendationText?: string|null}>} survived
+ * @param {string} cwd корінь проєкту
+ * @param {{cachePath?: string, callPi?: Function}} [opts] ін'єкції для тестів
+ * @returns {Promise<Array<{key: string, verdict: object}>>} verdicts
+ */
+export async function classify(survived, cwd, opts = {}) {
+  const cachePath = opts.cachePath ?? join(cwd, 'npm/reports/coverage-classify.cache.json')
+  const callPiFn = opts.callPi ?? callPi
+  const cacheModel = `${resolveModel('min') || 'default'}+${CLOUD_MIN || 'cloud'}`
 
   const cache = readCache(cachePath)
-  if (cache.model !== MODEL) {
+  if (cache.model !== cacheModel) {
     cache.entries = {}
-    cache.model = MODEL
+    cache.model = cacheModel
   }
 
   const verdicts = []
@@ -77,7 +102,7 @@ export async function classify(survived, cwd, opts = {}) {
         }
       }
       if (!verdict) {
-        verdict = await classifyOne(client, group, mutant, cwd, retryDelayMs)
+        verdict = classifyOne(group, mutant, cwd, callPiFn)
         if (cacheKey) {
           cache.entries[cacheKey] = { ...verdict, classifiedAt: new Date().toISOString() }
         }
@@ -90,40 +115,3 @@ export async function classify(survived, cwd, opts = {}) {
   writeCache(cachePath, cache)
   return verdicts
 }
-
-/**
- * Один виклик API з retry. На фейл після MAX_RETRIES — повертає FALLBACK_VERDICT.
- * @param {{messages: {create: Function}}} client SDK client
- * @param {{file: string}} group group для контексту
- * @param {object} mutant mutant data
- * @param {string} cwd корінь
- * @param {number} retryDelayMs base delay для exp-backoff (0 у тестах)
- * @returns {Promise<object>} verdict (parsed або fallback)
- */
-async function classifyOne(client, group, mutant, cwd, retryDelayMs) {
-  const userPrompt = buildUserPrompt({ ...mutant, file: group.file }, cwd)
-  let lastError = null
-
-  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-    try {
-      const response = await client.messages.create({
-        model: MODEL,
-        max_tokens: 1024,
-        system: [{ type: 'text', text: SYSTEM_PROMPT, cache_control: { type: 'ephemeral' } }],
-        messages: [{ role: 'user', content: userPrompt }]
-      })
-      const text = response?.content?.[0]?.text ?? ''
-      return parseVerdict(text)
-    } catch (error) {
-      lastError = error
-      if (attempt < MAX_RETRIES && retryDelayMs > 0) {
-        await setTimeout(retryDelayMs * 2 ** attempt)
-      }
-    }
-  }
-
-  console.warn(
-    `⚠ coverage classify: ${group.file}:${mutant.line}:${mutant.col} failed after ${MAX_RETRIES + 1} attempts: ${lastError?.message ?? 'unknown'}`
-  )
-  return { ...FALLBACK_VERDICT }
-}

package/scripts/coverage-fix.mjs

@@ -1,13 +1,18 @@
 /**
- * `n-cursor coverage --fix`: запускає Claude Code агента для написання тестів
+ * `n-cursor coverage --fix`: запускає pi-агента для написання тестів
  * по вцілілих мутантах Stryker. Агент отримує список мутантів з контекстом
  * (file, line, оригінальний код, вцілілий варіант, тип мутації) і самостійно
  * знаходить або створює відповідні test-файли.
  *
- * Залежить від `@anthropic-ai/claude-agent-sdk` (dependencies у npm/package.json).
+ * Модель: CLOUD_MAX (складна агентна задача) або N_CURSOR_COVERAGE_FIX_MODEL.
  */
 import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+import { resolveModel } from '../lib/models.mjs'
+
+const MODEL = process.env.N_CURSOR_COVERAGE_FIX_MODEL ?? resolveModel('max')
 
 /**
  * @typedef {{line:number, col:number, mutantType:string, original:string, replacement:string}} MutantDetail
@@ -15,12 +20,13 @@ import { join } from 'node:path'
  */
 
 /**
- * Запускає Claude Code агента для написання тестів по вцілілих мутантах.
+ * Запускає pi-агента для написання тестів по вцілілих мутантах.
  * @param {SurvivedFileGroup[]} survived вцілілі мутанти, згруповані по файлах
  * @param {string} projectRoot абсолютний шлях до кореня проєкту
+ * @param {{ callPi?: (prompt: string, model: string, opts: { cwd: string }) => void }} [opts] ін'єкції для тестів
  * @returns {Promise<void>}
  */
-export async function fixSurvivedMutants(survived, projectRoot) {
+export async function fixSurvivedMutants(survived, projectRoot, opts = {}) {
   const totalMutants = survived.reduce((s, g) => s + g.mutants.length, 0)
   if (totalMutants === 0) {
     console.log('✓ Всі мутанти вбиті — доповнення тестів не потрібне')
@@ -30,26 +36,23 @@ export async function fixSurvivedMutants(survived, projectRoot) {
   const prompt = await buildFixPrompt(survived, projectRoot)
   console.log(`\n🤖 coverage --fix: запускаю агента для ${totalMutants} вцілілих мутантів...\n`)
 
-  // Dynamic import: @anthropic-ai/claude-agent-sdk завантажується лише при --fix,
-  // щоб не гальмувати звичайний coverage-прогін за відсутності пакету.
-  const { query } = await import('@anthropic-ai/claude-agent-sdk')
+  const callPiFn = opts.callPi ?? callPi
+  callPiFn(prompt, MODEL, { cwd: projectRoot })
+}
 
-  for await (const msg of query({
-    prompt,
-    options: {
-      cwd: projectRoot,
-      maxTurns: 20,
-      allowedTools: ['Read', 'Edit', 'Bash'],
-      // Без permissionMode headless-агент SDK не отримує дозволу на запис/Bash —
-      // він крутиться, палить токени, але НЕ редагує файли (підтверджено пробом).
-      // `bypassPermissions` потрібен, бо агент і пише тести (Edit), і ганяє `bun test` (Bash);
-      // `acceptEdits` авто-підтверджує лише edits, а Bash лишився б заблокованим.
-      permissionMode: 'bypassPermissions'
-    }
-  })) {
-    if (msg.type === 'text') process.stdout.write(msg.text)
-  }
-  process.stdout.write('\n')
+/**
+ * Викликає pi в агентному режимі з live-output до stdout.
+ * @param {string} prompt
+ * @param {string} model  provider/model-id або '' для pi-дефолту
+ * @param {{ cwd?: string }} [piOpts]
+ */
+function callPi(prompt, model, { cwd } = {}) {
+  const modelArgs = model ? ['--model', model] : []
+  spawnSync('pi', ['-p', prompt, ...modelArgs, '--no-session'], {
+    cwd,
+    stdio: 'inherit',
+    timeout: 900_000
+  })
 }
 
 /**

package/scripts/dispatcher/lib/subagent-runner.mjs

@@ -1,122 +1,53 @@
 /**
- * SubagentRunner (spec §15.1) — абстракція спавну сфокусованого субагента для
- * Активного Раннера (Ф3/Ф4). Backend обирається за доступністю:
- *   1. `claude-agent-sdk` (програмний, потребує `ANTHROPIC_API_KEY`);
- *   2. `claude -p` (CLI-auth користувача);
- *   3. `cursor-agent -p` (CLI-auth).
- * Нема жодного → throw (polyfill без runner-а не стартує, §2.2).
+ * SubagentRunner — спавн субагента через pi (провайдер-нейтрально).
+ * Модель обирається через resolveModel('avg') (каскад local→cloud) або через deps.model.
  *
- * pi.dev для inner-спавну НЕ використовується: у автономному режимі pi.dev —
- * зовнішній драйвер, тож спавн ним внутрішніх субагентів = рекурсія (§9.1).
+ * Контракт runner-а: { backend: 'pi', runStep(prompt, { cwd }) → Promise<{ ok, output }> }.
+ * Усі callers (planner, executor, plan-panel, review, budget) використовують саме цей контракт.
  *
- * Усі probe-залежності (`spawn`/`isInPath`/`canImportSdk`/`query`) ін'єктуються,
- * щоб тестувати без реальних процесів і без SDK.
+ * pi НЕ спавниться рекурсивно коли pi — зовнішній драйвер (§9.1).
+ * У цьому проєкті зовнішній драйвер — Claude Code; pi як субагент — безпечно.
  */
 import { spawnSync } from 'node:child_process'
-import { env as processEnv } from 'node:process'
 
-const NO_BACKEND =
-  'SubagentRunner: ні claude-agent-sdk (з ANTHROPIC_API_KEY), ні `claude`/`cursor-agent` у PATH — ' +
-  'субагентів спавнити нічим. Встанови CLI-runner або задай ANTHROPIC_API_KEY.'
+import { resolveModel } from '../../../lib/models.mjs'
 
 /**
- * Чи є бінарник у PATH (через `command -v`).
- * @param {string} name ім'я виконуваного
- * @param {typeof import('node:child_process').spawnSync} [spawn] ін'єкція для тестів
- * @returns {boolean} true, якщо знайдено
+ * Викликає pi і повертає { ok, output }.
+ * @param {string} prompt
+ * @param {string} model  provider/model-id або '' для pi-дефолту
+ * @param {{ cwd?: string }} [opts]
+ * @returns {{ ok: boolean, output: string }}
  */
-export function isBinaryInPath(name, spawn = spawnSync) {
-  const r = spawn('command', ['-v', name], { shell: true, encoding: 'utf8' })
-  return (r.status ?? 1) === 0
+function callPi(prompt, model, { cwd } = {}) {
+  const modelArgs = model ? ['--model', model] : []
+  const r = spawnSync('pi', ['-p', prompt, ...modelArgs, '--no-session'], {
+    cwd,
+    encoding: 'utf8',
+    timeout: 600_000
+  })
+  const ok = !r.error && r.status === 0
+  const output = (r.stdout ?? '') + (r.error ? r.error.message : !ok ? (r.stderr ?? '') : '')
+  return { ok, output }
 }
 
 /**
- * Обирає backend субагентів за пріоритетом sdk > claude > cursor.
- * @param {{ hasApiKey: boolean, canImportSdk: boolean, isInPath: (name: string) => boolean }} probes доступність
- * @returns {'sdk' | 'claude' | 'cursor' | null} backend або null
+ * Створює pi-runner. Повертає { backend: 'pi', runStep }.
+ * @param {{ model?: string, callPi?: Function }} [deps]  ін'єкції для тестів
+ * @returns {Promise<{ backend: string, runStep: (prompt: string, opts?: object) => Promise<{ ok: boolean, output: string }> }>}
  */
-export function selectBackend({ hasApiKey, canImportSdk, isInPath }) {
-  if (hasApiKey && canImportSdk) return 'sdk'
-  if (isInPath('claude')) return 'claude'
-  if (isInPath('cursor-agent')) return 'cursor'
-  return null
-}
-
-/**
- * CLI-runner (`claude -p` / `cursor-agent -p`) — CLI-auth, без API key.
- * @param {'claude' | 'cursor-agent'} bin виконуваний
- * @param {{ spawn?: typeof import('node:child_process').spawnSync }} [deps] ін'єкція
- * @returns {{ backend: string, runStep: (prompt: string, opts?: { cwd?: string }) => { ok: boolean, output: string } }} runner
- */
-export function cliRunner(bin, deps = {}) {
-  const spawn = deps.spawn ?? spawnSync
-  return {
-    backend: bin,
-    runStep(prompt, { cwd } = {}) {
-      const r = spawn(bin, ['-p'], { input: prompt, cwd, encoding: 'utf8' })
-      return { ok: (r.status ?? 1) === 0, output: `${r.stdout ?? ''}${r.stderr ?? ''}` }
-    }
-  }
-}
+export async function createRunner(deps = {}) {
+  const model = deps.model ?? resolveModel('avg')
+  const callPiFn = deps.callPi ?? callPi
 
-/**
- * SDK-runner (`claude-agent-sdk`). `query` ін'єктується; за замовчуванням —
- * динамічний import (optional dependency).
- * @param {{ query?: (input: object) => object }} [deps] ін'єкція (query повертає async-iterable повідомлень)
- * @returns {{ backend: string, runStep: (prompt: string, opts?: { cwd?: string }) => Promise<{ ok: boolean, output: string }> }} runner
- */
-export function sdkRunner(deps = {}) {
   return {
-    backend: 'sdk',
-    async runStep(prompt, { cwd } = {}) {
-      let query = deps.query
-      if (!query) {
-        const mod = await import('@anthropic-ai/claude-agent-sdk')
-        query = mod.query
-      }
-      let output = ''
-      let ok = true
+    backend: 'pi',
+    async runStep(prompt, opts = {}) {
       try {
-        for await (const msg of query({
-          prompt,
-          options: { cwd, maxTurns: 20, allowedTools: ['Read', 'Edit', 'Bash'] }
-        })) {
-          if (typeof msg?.text === 'string') output += msg.text
-          if (msg?.type === 'result') ok = msg.is_error !== true
-        }
-      } catch (error) {
-        return { ok: false, output: String(error?.message ?? error) }
+        return callPiFn(prompt, model, opts)
+      } catch (e) {
+        return { ok: false, output: String(e?.message ?? e) }
       }
-      return { ok, output }
     }
   }
 }
-
-/**
- * Створює runner за доступним backend-ом. `backend`/probe-и можна задати явно
- * (тести); інакше визначаються з env/PATH/SDK.
- * @param {{ backend?: string, env?: Record<string, string | undefined>, isInPath?: (name: string) => boolean, canImportSdk?: boolean, spawn?: (cmd: string, args: string[], opts: object) => object, query?: (input: object) => object }} [deps] ін'єкції
- * @returns {Promise<{ backend: string, runStep: (prompt: string, opts?: object) => object }>} runner
- */
-export async function createRunner(deps = {}) {
-  const env = deps.env ?? processEnv
-  const isInPath = deps.isInPath ?? (name => isBinaryInPath(name, deps.spawn))
-  const canImportSdk = deps.canImportSdk ?? (await probeSdk())
-  const backend = deps.backend ?? selectBackend({ hasApiKey: Boolean(env.ANTHROPIC_API_KEY), canImportSdk, isInPath })
-  if (!backend) throw new Error(NO_BACKEND)
-  if (backend === 'sdk') return sdkRunner(deps)
-  return cliRunner(backend === 'claude' ? 'claude' : 'cursor-agent', deps)
-}
-
-/**
- * Чи імпортується `claude-agent-sdk` (optional dependency).
- * @returns {Promise<boolean>} true, якщо доступний
- */
-async function probeSdk() {
-  try {
-    await import('@anthropic-ai/claude-agent-sdk')
-    return true
-  } catch {
-    return false
-  }
-}

package/skills/docgen/js/docgen-gen.mjs

@@ -2,11 +2,19 @@
 import { readFileSync } from 'node:fs'
 import { basename } from 'node:path'
 import { request } from 'node:http'
+import { spawnSync } from 'node:child_process'
 import { env } from 'node:process'
-import Anthropic from '@anthropic-ai/sdk'
+import { LOCAL_MIN, resolveModel } from '../../../lib/models.mjs'
 import { extractFacts } from './docgen-extract.mjs'
 import { sectionMessages, oneShotMessages, STYLE, oneShotPromptText } from './docgen-prompts.mjs'
 
+/** Strips provider prefix from tier string for direct ollama HTTP (ollama/gemma3:4b → gemma3:4b). */
+function localModelId(tier) {
+  if (!tier) return 'gemma3:4b'
+  const i = tier.indexOf('/')
+  return i === -1 ? tier : tier.slice(i + 1)
+}
+
 const QUALITY_THRESHOLD = 70
 
 /** Один виклик чату до ollama зі streaming (токени стримуються → socket активний, жодного timeout). */
@@ -137,73 +145,20 @@ function scoreDoc(md, facts) {
   return { score: Math.max(0, score), issues }
 }
 
-const SCORE_RUBRIC = `Оціни якість документації для JavaScript-модуля за 4 критеріями (1-3 кожен):
-
-- огляд: 3=описує роль модуля в системі (ЩО і НАВІЩО); 2=частково розмитий; 1=відсутній або перераховує функції
-- поведінка: 3=бізнес-терміни, без деталей реалізації; 2=деякі impl-деталі; 1=переважно реалізація або відсутня
-- гарантії: 3=лише реальні інваріанти підтверджені кодом, без галюцинацій; 2=частково правильні; 1=вигадані або відсутні
-- стиль: 3=без сигнатур/internal-імен, правильна markdown-структура; 2=дрібні порушення; 1=сигнатури/internal-імена/відсутні заголовки
-
-Відповідай ТІЛЬКИ JSON без пояснень:
-{"огляд":N,"поведінка":N,"гарантії":N,"стиль":N,"issues":["коротко про кожен мінус 1-5 слів"]}`
-
-/**
- * Stage 2.5 cloud: Claude Haiku оцінює якість доку проти коду + фактів.
- * Використовує найдешевшу хмарну модель — haiku — для мінімальної вартості судді.
- * @returns {{ score: number, scores: object, issues: string[], tok: number }}
- */
-async function cloudScoreDoc(md, facts, src, model = 'claude-haiku-4-5-20251001') {
-  const client = new Anthropic()
-  const factsTxt = [
-    facts.exports?.length ? `Публічні функції: ${facts.exports.map(e => e.name).join(', ')}` : '',
-    facts.internalSymbols?.length ? `Внутрішні (не публічні): ${facts.internalSymbols.join(', ')}` : '',
-    facts.markers?.caches ? 'Кешування: є' : 'Кешування: немає',
-    facts.markers?.network ? 'Мережа: є' : 'Мережа: немає',
-    facts.markers?.readOnly ? 'Read-only (не змінює файли/стан)' : ''
-  ]
-    .filter(Boolean)
-    .join('\n')
-
-  const msg = await client.messages.create({
-    model,
-    max_tokens: 256,
-    system: SCORE_RUBRIC,
-    messages: [
-      {
-        role: 'user',
-        content: [
-          { type: 'text', text: `ФАКТИ:\n${factsTxt}`, cache_control: { type: 'ephemeral' } },
-          { type: 'text', text: `КОД:\n\`\`\`\n${src.slice(0, 4000)}\n\`\`\``, cache_control: { type: 'ephemeral' } },
-          { type: 'text', text: `ДОКУМЕНТАЦІЯ:\n${md}` }
-        ]
-      }
-    ]
+/** Tier 2: виклик через pi (провайдер-нейтрально). model — рядок `provider/model-id`. */
+function piOneShot(facts, src, model) {
+  const fullPrompt = `${STYLE}\n\n${oneShotPromptText(facts, src)}`
+  const modelArgs = model ? ['--model', model] : []
+  const r = spawnSync('pi', ['-p', fullPrompt, ...modelArgs, '--no-session', '--mode', 'text', '--no-tools'], {
+    encoding: 'utf8',
+    timeout: 120_000
   })
-  const tok = (msg.usage?.input_tokens ?? 0) + (msg.usage?.output_tokens ?? 0)
-  try {
-    const j = JSON.parse(msg.content[0]?.text ?? '{}')
-    const total = (((j.огляд ?? 0) + (j.поведінка ?? 0) + (j.гарантії ?? 0) + (j.стиль ?? 0)) / 12) * 100
-    return { score: Math.round(total), scores: j, issues: j.issues ?? [], tok }
-  } catch {
-    return { score: 50, scores: {}, issues: ['parse-error'], tok }
-  }
-}
-
-/** Tier 2: хмарний fallback через Claude коли local-score < QUALITY_THRESHOLD. */
-async function claudeOneShot(facts, src, model = 'claude-sonnet-4-6') {
-  const client = new Anthropic()
-  const prompt = oneShotPromptText(facts, src)
-  const msg = await client.messages.create({
-    model,
-    max_tokens: 1500,
-    system: STYLE,
-    messages: [{ role: 'user', content: prompt }]
-  })
-  const text = msg.content[0]?.text ?? ''
-  const genTok = msg.usage?.output_tokens ?? 0
+  if (r.error) throw new Error(`pi Tier 2 error: ${r.error.message}`)
+  if (r.status !== 0) throw new Error(`pi Tier 2 exit ${r.status}: ${r.stderr?.slice(0, 300) ?? ''}`)
+  const text = r.stdout?.trim() ?? ''
   let md = stripSignatures(stripSection(text))
   if (!md.startsWith('#')) md = `# ${basename(facts.relPath)}\n\n${md}`
-  return { md: md + '\n', genTok }
+  return { md: md + '\n', genTok: 0 }
 }
 
 /** Stage 3: фіксовані заголовки у фіксованому порядку. */
@@ -246,6 +201,10 @@ async function generateOneShot(facts, src, model) {
 const DEFAULT_SYM_THRESHOLD = 4
 /** Максимальний час локальної генерації на один файл перед ескалацією у Tier 2. */
 const LOCAL_TIMEOUT_MS = 5 * 60 * 1000
+/** Дефолтна Tier 1 модель: N_CURSOR_DOCGEN_MODEL → LOCAL_MIN → ollama gemma3:4b. */
+const DEFAULT_LOCAL_MODEL = localModelId(env.N_CURSOR_DOCGEN_MODEL ?? LOCAL_MIN)
+/** Дефолтна Tier 2 модель (provider/model-id для pi): N_CURSOR_DOCGEN_CLOUD_MODEL → resolveModel('avg'). */
+const DEFAULT_CLOUD_MODEL = env.N_CURSOR_DOCGEN_CLOUD_MODEL ?? resolveModel('avg')
 
 /** Повертає promise, що відхиляється через `ms` мс з повідомленням про timeout. */
 function withTimeout(promise, ms) {
@@ -268,9 +227,9 @@ function withTimeout(promise, ms) {
 export async function generateDoc(
   file,
   {
-    model = 'gemma3:4b',
+    model = DEFAULT_LOCAL_MODEL,
     mode = 'orchestrated',
-    cloudModel = 'claude-sonnet-4-6',
+    cloudModel = DEFAULT_CLOUD_MODEL,
     threshold = QUALITY_THRESHOLD,
     symThreshold = DEFAULT_SYM_THRESHOLD
   } = {}
@@ -281,8 +240,8 @@ export async function generateDoc(
 
   // Pre-routing: складні файли (sym ≥ symThreshold) → одразу Tier 2, не витрачаємо local-час
   const complexity = facts.internalSymbols?.length ?? 0
-  if (complexity >= symThreshold && env.ANTHROPIC_API_KEY) {
-    const r2 = await claudeOneShot(facts, src, cloudModel)
+  if (complexity >= symThreshold && cloudModel) {
+    const r2 = piOneShot(facts, src, cloudModel)
     return {
       ...r2,
       ms: Date.now() - t0,
@@ -302,8 +261,8 @@ export async function generateDoc(
         : generateOrchestrated(facts, src, model)
     r = await withTimeout(localPromise, LOCAL_TIMEOUT_MS)
   } catch (e) {
-    if (env.ANTHROPIC_API_KEY) {
-      const r2 = await claudeOneShot(facts, src, cloudModel)
+    if (cloudModel) {
+      const r2 = piOneShot(facts, src, cloudModel)
       return {
         ...r2,
         ms: Date.now() - t0,
@@ -319,8 +278,8 @@ export async function generateDoc(
   // Stage 2.5: детермінований скоринг (0 токенів) — gate перед Tier 2
   const { score: detScore, issues: detIssues } = scoreDoc(r.md, facts)
 
-  if (detScore < threshold && env.ANTHROPIC_API_KEY) {
-    const r2 = await claudeOneShot(facts, src, cloudModel)
+  if (detScore < threshold && cloudModel) {
+    const r2 = piOneShot(facts, src, cloudModel)
     return { ...r2, ms: Date.now() - t0, score: detScore, issues: detIssues, tier: 2, model: cloudModel }
   }
 
@@ -335,7 +294,7 @@ if (isRunAsCli(import.meta.url)) {
   const mode = args.includes('--oneshot') ? 'oneshot' : 'orchestrated'
   const tierOnly = args.includes('--tier-only')
   const mi = args.indexOf('--model')
-  const model = mi >= 0 ? args[mi + 1] : 'gemma3:4b'
+  const model = mi >= 0 ? args[mi + 1] : DEFAULT_LOCAL_MODEL
   const si = args.indexOf('--sym-threshold')
   const symThreshold = si >= 0 ? Number(args[si + 1]) : DEFAULT_SYM_THRESHOLD
   if (!file) {

package/skills/fix/js/llm-worker.mjs

@@ -4,12 +4,12 @@ import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { env } from 'node:process'
-import { CLOUD_MIN, CLOUD_AVG } from '../../../lib/models.mjs'
+import { resolveModel } from '../../../lib/models.mjs'
 
-// Тир за замовчуванням: CLOUD_MIN → CLOUD_AVG при ескалації.
+// Тир за замовчуванням: min → avg при ескалації (каскад local→cloud).
 // Перевизначення через N_CURSOR_FIX_MODEL / N_CURSOR_FIX_MODEL_HEAVY.
-export const MODEL = env.N_CURSOR_FIX_MODEL ?? CLOUD_MIN
-export const MODEL_HEAVY = env.N_CURSOR_FIX_MODEL_HEAVY ?? CLOUD_AVG
+export const MODEL = env.N_CURSOR_FIX_MODEL ?? resolveModel('min')
+export const MODEL_HEAVY = env.N_CURSOR_FIX_MODEL_HEAVY ?? resolveModel('avg')
 
 /**
  * Витягує відносні шляхи файлів із violation output.