qiksy 1.0.0

package/tools/work-finder/vendor/.claude/settings.local.json

@@ -0,0 +1,27 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "WebFetch",
+      "mcp__playwright__browser_navigate",
+      "mcp__playwright__browser_navigate_back",
+      "mcp__playwright__browser_click",
+      "mcp__playwright__browser_type",
+      "mcp__playwright__browser_press_key",
+      "mcp__playwright__browser_wait_for",
+      "mcp__playwright__browser_snapshot",
+      "mcp__playwright__browser_take_screenshot",
+      "mcp__playwright__browser_evaluate",
+      "mcp__playwright__browser_run_code",
+      "mcp__playwright__browser_tabs",
+      "mcp__playwright__browser_file_upload",
+      "mcp__playwright__browser_handle_dialog",
+      "mcp__playwright__browser_resize",
+      "Bash(node scripts/*)",
+      "Bash(npm run *)",
+      "Bash(curl:*)",
+      "Bash(lsof:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": true
+}

package/tools/work-finder/vendor/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "playwright": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@playwright/mcp@latest", "--cdp-endpoint", "http://localhost:9222"]
+    }
+  }
+}

package/tools/work-finder/vendor/CLAUDE.md

@@ -0,0 +1,24 @@
+# Work Finder — заметки для Claude
+
+Назначение: поиск работы/подработки для Димы и коллег. UI на :5544 (`npm start`), данные в `data/db.json`, фоновые операции — spawn `claude -p` (см. `lib/agent.mjs`).
+
+## Критичные особенности
+
+- **Разрешения headless-агентов**: глобальный `~/.claude/settings.json` держит WebSearch/WebFetch в `ask` → в `-p` режиме это автоотказ, который НЕ обходится ни `--allowedTools`, ни `--dangerously-skip-permissions`. Решение: `--permission-prompt-tool mcp__approver__approve` + `scripts/approver-mcp.mjs` (белый список: WebSearch, WebFetch, ToolSearch, mcp__playwright__*). Не убирай этот механизм и не «чини» его через правку глобальных настроек.
+- **`--tools` обязателен** при спавне агентов: без него агенты получают Bash/Edit/Write из глобального allow-списка пользователя.
+- **`--strict-mcp-config` обязателен**: иначе проектный `.mcp.json` + `enableAllProjectMcpServers` подсовывают браузер каждому агенту, и поиск уползает в многочасовой браузерный краулинг (был реальный таймаут).
+- **Браузер** — общий CDP Chrome на :9222 (обычно QA-браузер iucn-mono, в нём залогинен LinkedIn). `scripts/launch-browser.mjs` переиспользует живой порт, свой профиль поднимает только если порт пуст.
+- В сопроводительных письмах промпт требует «только факты из резюме» — модель без этого приукрашивает (ловили «daily user of HTTPie»).
+
+## Данные
+
+`data/db.json`: `profiles` (резюме в markdown + location — по ней агент проверяет право работать удалённо), `positions` (title/keywords/engagement/profileId/selected — мульти-чойс лейблы в UI), `vacancies` (статусы: new/prepared/ready/sent/answered/interview/rejected/hidden; гео-поля remote_scope global|region|country|none, eligibility_note, posted_date), `leads` (компании с сигналом найма — сейчас сигнал «свежий инвестраунд»; contact_* фаундера/CTO, pitch — холодное письмо, статусы new/ready/sent/answered/archive), `settings` (model, autoSubmit, searchViaBrowser, resultsPerSearch, freshnessDays, searchExtra).
+
+Поиск вакансий работает в 3 режима сразу: ATS-дорки (site:boards.greenhouse.io и др.), тред HN "Who is hiring" текущего месяца, обычные борды/карьерные страницы. Идеи ещё 7 не реализованных сценариев поиска (реестры ФОП/юрлиц, свежие лицензии, наём рекрутера, смена CTO, Product Hunt, агентства, тендеры) — обсуждались 2026-07-02, спросить Диму прежде чем делать.
+Свежая база стартует ПУСТОЙ (решение владельца 2026-07-19): никаких сид-профилей — после подключения ключа юзер создаёт первого кандидата через zero-profile онбординг фронта. Личные файлы (`dima.md`, LinkedIn-дампы) из репозитория удалены; `data/` в `.gitignore` (runtime-состояние живёт только на машине).
+
+## Тесты руками
+
+- поиск: `POST /api/search {positionId}` → job; смотреть `GET /api/jobs/:id`
+- автозаявка останавливается перед submit при `autoSubmit:false` (по умолчанию)
+- профиль коллеги: добавить в UI → «Импорт из LinkedIn» (нужен его публичный URL и залогиненный браузер)

package/tools/work-finder/vendor/README.md

@@ -0,0 +1,44 @@
+# Work Finder
+
+Инструмент поиска работы/подработки для себя и коллег. Headless-агенты Claude Code ищут в вебе продуктовые/IT-компании с открытыми вакансиями под заданные позиции, а браузерный агент (Playwright MCP + ваш залогиненный Chrome) заполняет формы откликов.
+
+## Запуск
+
+```bash
+npm start          # сервер → http://localhost:5544
+npm run browser    # поднять/переиспользовать CDP Chrome на :9222 (для автозаявок и импорта LinkedIn)
+```
+
+Требуется: Node 18+, Claude Code CLI (`claude`) с активной подпиской, Google Chrome.
+
+## Как пользоваться
+
+1. **Профили / резюме** — по одному на человека. Кнопка «Импорт из LinkedIn» вытаскивает резюме из открытого в браузере профиля (нужен залогиненный LinkedIn в CDP-браузере) и структурирует его через Claude. Можно править вручную.
+2. **Позиции** — «Senior React Developer», «AI Engineer»… + ключевые слова, чей профиль, формат (штат / контракт / оба). Кнопка «Искать» на позиции или «Искать по всем».
+3. **Вакансии** — найденное складывается сюда с дедупликацией. Статусы: новая → отклик готов → заполнено → отправлено → ответили/интервью/отказ.
+4. **✍️ Подготовить отклик** — Claude читает страницу вакансии и пишет сопроводительное письмо строго по фактам резюме. Письмо можно править.
+5. **🤖 Автозаявка** — браузерный агент открывает вакансию в новой вкладке, находит форму, заполняет её (имя, email, LinkedIn, письмо, доп. вопросы по резюме) и **останавливается перед отправкой** (скриншот + отчёт, что осталось). Включить полную автоотправку можно в настройках (`autoSubmit`).
+
+## Настройки
+
+- **Модель**: haiku (дёшево) / sonnet (баланс, по умолчанию) / opus. Ориентир стоимости: один поиск на sonnet ≈ $1–1.5 (по API-тарифам; на подписке — в счёт лимитов).
+- **Поиск через браузер** — глубже (djinni/DOU под вашим логином), но заметно медленнее; по умолчанию выключен, поиск идёт через WebSearch/WebFetch.
+- **Доп. инструкции** — свободный текст: зарплатная вилка, страны, что исключать.
+
+## Архитектура
+
+```
+server.mjs            Node http (без зависимостей), порт 5544
+lib/store.mjs         data/db.json — профили, позиции, вакансии, настройки
+lib/agent.mjs         запуск `claude -p` (stream-json), парсинг результата
+lib/prompts.mjs       промпты: поиск / письмо / автозаявка / импорт резюме
+lib/jobs.mjs          очередь фоновых задач (макс. 2 агента параллельно)
+scripts/approver-mcp.mjs    MCP-сервер разрешений для headless-агентов (см. ниже)
+scripts/launch-browser.mjs  CDP Chrome на :9222 (переиспользует запущенный)
+scripts/extract-linkedin.mjs выгрузка профиля LinkedIn через CDP
+public/               UI (vanilla JS)
+```
+
+**Важно про разрешения:** в глобальных `~/.claude/settings.json` инструменты WebSearch/WebFetch стоят в списке `ask`, что в headless-режиме означает автоотказ (и перекрывает `--allowedTools`). Поэтому агенты запускаются с `--permission-prompt-tool mcp__approver__approve` — наш мини-MCP-сервер одобряет только белый список (WebSearch, WebFetch, mcp__playwright__*), всё прочее запрещено. Плюс `--tools` жёстко ограничивает встроенный набор (агентам недоступны Bash/Edit/Write).
+
+**Браузер:** агенты подключаются к Chrome с `--remote-debugging-port=9222`. Если запущен QA-браузер iucn-mono — используется он (там залогинен LinkedIn); иначе `npm run browser` поднимет Chrome с локальным профилем `.cdp-browser-profile/`. Не запускайте две автозаявки одновременно с активной работой в этом же браузере.

package/tools/work-finder/vendor/bin/qiksy-work-finder.mjs

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * Qiksy Work Finder — the local engine launcher.
+ *
+ * This is what a customer runs (as `npx qiksy-work-finder`, or wrapped inside the
+ * desktop app). It is a thin, friendly front over the existing zero-dependency Node
+ * backend (../server.mjs): it prints a branded banner, checks whether Claude Code is
+ * installed, boots the engine on localhost:5544, waits until it answers, and opens the
+ * browser on the tool. The engine keeps the process alive; Ctrl-C stops it.
+ *
+ * Deliberately no new heavy dependencies — the whole point of the engine is that it is
+ * small and runs on the user's OWN Claude (their subscription, their machine, their data).
+ */
+
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { platform } from 'node:process';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+
+// Runtime state (db, LinkedIn dumps, CDP profile) lives in a stable user folder, NOT in
+// the package under node_modules / the npx cache — otherwise the user's candidates vanish
+// between runs. server.mjs/store.mjs read this before their first write.
+if (!process.env.WF_DATA_DIR) {
+  const dir = join(homedir(), '.qiksy-work-finder');
+  try {
+    mkdirSync(dir, { recursive: true });
+    process.env.WF_DATA_DIR = dir;
+  } catch {
+    /* fall back to the package's own data/ if home isn't writable */
+  }
+}
+
+const PORT = Number(process.env.WF_PORT) || 5544;
+const URL = `http://localhost:${PORT}`;
+const isWin = platform === 'win32';
+
+const c = {
+  b: (s) => `\x1b[1m${s}\x1b[0m`,
+  dim: (s) => `\x1b[2m${s}\x1b[0m`,
+  blue: (s) => `\x1b[38;5;69m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  amber: (s) => `\x1b[33m${s}\x1b[0m`,
+};
+
+function banner() {
+  process.stdout.write(
+    '\n' +
+      c.blue(c.b('  ◆ Qiksy Work Finder')) +
+      c.dim('  — your local hiring engine\n') +
+      c.dim('  Runs on your own Claude · nothing leaves your machine\n\n'),
+  );
+}
+
+/** Is the `claude` CLI on PATH? On Windows it is a .cmd shim, so ask through a shell there. */
+function hasClaude() {
+  try {
+    const r = spawnSync('claude', ['--version'], { stdio: 'ignore', shell: isWin, timeout: 8000 });
+    return r.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+function openBrowser(url) {
+  try {
+    if (platform === 'darwin') spawnSync('open', [url], { stdio: 'ignore' });
+    else if (isWin) spawnSync('cmd', ['/c', 'start', '""', url], { stdio: 'ignore' });
+    else spawnSync('xdg-open', [url], { stdio: 'ignore' });
+  } catch {
+    /* the URL is printed below regardless */
+  }
+}
+
+async function waitForPort(port, tries = 60) {
+  for (let i = 0; i < tries; i++) {
+    try {
+      const res = await fetch(`http://localhost:${port}/api/state`, { signal: AbortSignal.timeout(800) });
+      if (res.ok || res.status === 401 || res.status === 402) return true;
+    } catch {
+      /* not up yet */
+    }
+    await new Promise((r) => setTimeout(r, 500));
+  }
+  return false;
+}
+
+async function main() {
+  banner();
+
+  if (!hasClaude()) {
+    process.stdout.write(
+      c.amber('  ⚠ Claude Code was not found on this machine.\n') +
+        c.dim('    Work Finder runs on your own Claude — install it once, then sign in from the app:\n') +
+        c.dim('    → https://claude.com/claude-code\n') +
+        c.dim("    (You can still start the engine now and sign in from the window that opens.)\n\n"),
+    );
+  } else {
+    process.stdout.write(c.green('  ✓ Claude Code detected\n\n'));
+  }
+
+  process.stdout.write(c.dim(`  Starting the engine on ${URL} …\n`));
+
+  // Boot the backend — it calls server.listen() at import time and keeps the process alive.
+  const require = createRequire(import.meta.url);
+  const serverPath = require.resolve('../server.mjs');
+  await import(serverPath);
+
+  const up = await waitForPort(PORT);
+  if (!up) {
+    process.stdout.write(c.amber(`\n  Engine did not answer on ${URL} yet — open it manually in your browser.\n`));
+  } else {
+    process.stdout.write(c.green(`\n  ✓ Work Finder is running.\n`));
+    openBrowser(URL);
+  }
+  process.stdout.write(
+    '\n' +
+      c.b(`  Open:  ${URL}\n`) +
+      c.dim('  Leave this window open while you use Work Finder. Press Ctrl-C to stop.\n\n'),
+  );
+}
+
+main().catch((err) => {
+  process.stderr.write(c.amber(`\n  Could not start Work Finder: ${err?.message || err}\n`));
+  process.exit(1);
+});

package/tools/work-finder/vendor/lib/agent.mjs

@@ -0,0 +1,159 @@
+/**
+ * Headless Claude Code runner: spawns `claude -p` with stream-json output,
+ * feeds tool-use events to onEvent (job log), returns the final result text.
+ */
+import { spawnClaude } from './spawn-claude.mjs';
+import { resolve } from 'node:path';
+import { ROOT } from './store.mjs';
+
+// Все живые дочерние агенты: убиваем при остановке сервера, чтобы
+// осиротевшие claude-процессы не дожигали токены в пустоту.
+const activeChildren = new Set();
+function killAllChildren() {
+  for (const child of activeChildren) {
+    try { child.kill('SIGKILL'); } catch { /* already dead */ }
+  }
+  activeChildren.clear();
+}
+for (const sig of ['SIGINT', 'SIGTERM']) {
+  process.on(sig, () => { killAllChildren(); process.exit(0); });
+}
+process.on('exit', killAllChildren);
+
+const APPROVER_SERVER = {
+  type: 'stdio',
+  command: process.execPath,
+  args: [resolve(ROOT, 'scripts/approver-mcp.mjs')],
+};
+const PLAYWRIGHT_SERVER = {
+  type: 'stdio',
+  command: 'npx',
+  args: ['@playwright/mcp@latest', '--cdp-endpoint', 'http://localhost:9222'],
+};
+
+export function runClaude({
+  prompt,
+  allowedTools = [], // built-in tools the agent may use; [] = no built-ins
+  withBrowser = false,
+  model = 'sonnet',
+  timeoutMs = 10 * 60_000,
+  onEvent = () => {},
+  onPartial = null, // (obj) => void — строки `VACANCY: {...}` из текста агента, по мере готовности
+  signal = null, // AbortSignal — отмена задачи пользователем
+}) {
+  return new Promise(resolvePromise => {
+    // The user's global settings put WebSearch/WebFetch in the "ask" list,
+    // which auto-denies in -p mode and overrides --allowedTools and even
+    // --dangerously-skip-permissions. So permissions go through our own
+    // approver MCP server (--permission-prompt-tool) with a whitelist,
+    // and --tools hard-limits the built-in toolset (no Bash/Edit/Write).
+    const mcpServers = { approver: APPROVER_SERVER };
+    if (withBrowser) mcpServers.playwright = PLAYWRIGHT_SERVER;
+    const args = [
+      '-p', prompt,
+      '--output-format', 'stream-json', '--verbose',
+      '--model', model,
+      '--tools', allowedTools.length ? [...allowedTools, 'ToolSearch'].join(',') : '',
+      '--mcp-config', JSON.stringify({ mcpServers }),
+      '--strict-mcp-config',
+      '--permission-prompt-tool', 'mcp__approver__approve',
+    ];
+    if (allowedTools.length) args.push('--allowedTools', [...allowedTools, ...(withBrowser ? ['mcp__playwright'] : [])].join(','));
+
+    // A nested interactive session is refused, but `-p` is fine; strip the
+    // markers anyway so the child never thinks it is inside another session.
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    delete env.CLAUDE_CODE_ENTRYPOINT;
+
+    const child = spawnClaude(args, { cwd: ROOT, env, stdio: ['ignore', 'pipe', 'pipe'] });
+    activeChildren.add(child);
+    child.on('close', () => activeChildren.delete(child));
+
+    let resultText = '';
+    let errText = '';
+    let costUsd = null;
+    let settled = false;
+    let partialBuf = '';
+    let partialsEmitted = 0;
+    const t0 = Date.now();
+
+    const finish = out => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolvePromise({ durationMs: Date.now() - t0, costUsd, ...out });
+    };
+
+    const timer = setTimeout(() => {
+      try { child.kill('SIGKILL'); } catch { /* already dead */ }
+      finish({ ok: false, error: `timeout after ${Math.round(timeoutMs / 1000)}s` });
+    }, timeoutMs);
+
+    if (signal) {
+      const onAbort = () => {
+        try { child.kill('SIGKILL'); } catch { /* already dead */ }
+        finish({ ok: false, error: 'отменено' });
+      };
+      if (signal.aborted) onAbort();
+      else signal.addEventListener('abort', onAbort, { once: true });
+    }
+
+    let buf = '';
+    child.stdout.on('data', chunk => {
+      buf += chunk;
+      let nl;
+      while ((nl = buf.indexOf('\n')) >= 0) {
+        const line = buf.slice(0, nl).trim();
+        buf = buf.slice(nl + 1);
+        if (!line) continue;
+        let ev;
+        try { ev = JSON.parse(line); } catch { continue; }
+        if (ev.type === 'assistant') {
+          for (const block of ev.message?.content || []) {
+            if (block.type === 'tool_use') {
+              const input = JSON.stringify(block.input || {});
+              onEvent(`⚙ ${block.name} ${input.length > 160 ? input.slice(0, 160) + '…' : input}`);
+            } else if (block.type === 'text' && block.text && onPartial) {
+              partialBuf += block.text + '\n';
+              const matches = [...partialBuf.matchAll(/^VACANCY:\s*(\{.*\})\s*$/gm)];
+              for (let i = partialsEmitted; i < matches.length; i++) {
+                try { onPartial(JSON.parse(matches[i][1])); } catch { /* побитый партиал — придёт в финальном массиве */ }
+              }
+              partialsEmitted = Math.max(partialsEmitted, matches.length);
+            }
+          }
+        } else if (ev.type === 'result') {
+          resultText = ev.result || '';
+          costUsd = ev.total_cost_usd ?? null;
+          if (ev.is_error) errText = resultText || ev.subtype || 'agent error';
+        }
+      }
+    });
+    child.stderr.on('data', chunk => { errText += chunk; });
+
+    child.on('error', err => finish({ ok: false, error: `spawn failed: ${err.message}` }));
+    child.on('close', code => {
+      if (code === 0 && resultText) finish({ ok: true, result: resultText });
+      else finish({ ok: false, error: (errText || `claude exited with code ${code}`).slice(0, 2000) });
+    });
+  });
+}
+
+/** Pull a JSON value out of agent prose: direct parse → fenced block → bracket slice. */
+export function extractJson(text) {
+  if (!text) return null;
+  const attempts = [text.trim()];
+  const fence = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+  if (fence) attempts.push(fence[1].trim());
+  const firstArr = text.indexOf('[');
+  const lastArr = text.lastIndexOf(']');
+  if (firstArr >= 0 && lastArr > firstArr) attempts.push(text.slice(firstArr, lastArr + 1));
+  const firstObj = text.indexOf('{');
+  const lastObj = text.lastIndexOf('}');
+  if (firstObj >= 0 && lastObj > firstObj) attempts.push(text.slice(firstObj, lastObj + 1));
+  for (const candidate of attempts) {
+    try { return JSON.parse(candidate); } catch { /* next */ }
+  }
+  return null;
+}

package/tools/work-finder/vendor/lib/catalog.mjs

@@ -0,0 +1,41 @@
+/**
+ * Каталог ролей: готовые позиции с выверенными ключевыми словами,
+ * чтобы HR не придумывал формулировки сам (меньше кастома — стабильнее поиск).
+ * `match` — регэксп автодетекта роли по тексту резюме.
+ */
+export const ROLE_CATALOG = [
+  { id: 'react', group: 'Frontend', title: 'React / Frontend Developer', keywords: 'React, TypeScript, Next.js, Tailwind', match: /react(?!\s*native)/i },
+  { id: 'angular', group: 'Frontend', title: 'Angular Developer', keywords: 'Angular, TypeScript, RxJS, NgRx', match: /angular/i },
+  { id: 'vue', group: 'Frontend', title: 'Vue / Nuxt Developer', keywords: 'Vue.js, Nuxt, TypeScript, Pinia', match: /\bvue\b|nuxt/i },
+  { id: 'fullstack-js', group: 'Fullstack', title: 'Full-Stack JavaScript Developer', keywords: 'JavaScript, TypeScript, React, Node.js', match: /full[\s-]?stack.{0,40}(js|javascript|node|react)|(node|react).{0,40}full[\s-]?stack/is },
+  { id: 'node', group: 'Backend', title: 'Node.js Backend Developer', keywords: 'Node.js, NestJS, TypeScript, PostgreSQL', match: /node\.?js|nestjs/i },
+  { id: 'python', group: 'Backend', title: 'Python Backend Developer', keywords: 'Python, Django, FastAPI, PostgreSQL, Celery', match: /python|django|fastapi/i },
+  { id: 'java', group: 'Backend', title: 'Java Developer', keywords: 'Java, Spring Boot, Hibernate', match: /\bjava\b(?!script)|spring boot/i },
+  { id: 'dotnet', group: 'Backend', title: '.NET Developer', keywords: 'C#, .NET, ASP.NET Core', match: /\.net|c#|csharp/i },
+  { id: 'go', group: 'Backend', title: 'Go Developer', keywords: 'Go, Golang, microservices', match: /\bgolang\b|\bgo\b developer/i },
+  { id: 'php', group: 'Backend', title: 'PHP Developer', keywords: 'PHP, Laravel, Symfony', match: /\bphp\b|laravel|symfony/i },
+  { id: 'ai-engineer', group: 'AI', title: 'AI / LLM Engineer', keywords: 'LLM, RAG, agents, LangChain, MCP, prompt engineering', match: /\bllm\b|langchain|\brag\b|prompt engineer|anthropic|openai|\bmcp\b/i },
+  { id: 'ai-integrator', group: 'AI', title: 'AI Systems Integrator', keywords: 'AI integration, Claude, MCP, automation, agents', match: /ai (systems? )?integrat|ai assistant|ai-augmented/i },
+  { id: 'ml', group: 'AI', title: 'ML Engineer', keywords: 'Machine Learning, PyTorch, TensorFlow, MLOps', match: /machine learning|pytorch|tensorflow|keras|mlops/i },
+  { id: 'solutions-architect', group: 'Architecture', title: 'Solutions Architect', keywords: 'solution architecture, system design, integrations', match: /solutions? architect|архитектор/i },
+  { id: 'cloud-architect', group: 'Architecture', title: 'Cloud Architect', keywords: 'AWS, Azure, GCP, cloud architecture, Terraform', match: /cloud architect|aws.{0,30}architect/i },
+  { id: 'devops', group: 'Infra', title: 'DevOps / SRE Engineer', keywords: 'Kubernetes, Docker, Terraform, CI/CD, AWS', match: /devops|\bsre\b|kubernetes|terraform/i },
+  { id: 'qa-auto', group: 'QA', title: 'QA Automation Engineer', keywords: 'Playwright, Cypress, Selenium, test automation', match: /qa automation|playwright|cypress|selenium|автоматизац.{0,20}тест/i },
+  { id: 'qa-manual', group: 'QA', title: 'QA Engineer (manual)', keywords: 'manual testing, test cases, regression', match: /manual (qa|test)|ручное тестирование/i },
+  { id: 'mobile', group: 'Mobile', title: 'Mobile Developer (React Native / Flutter)', keywords: 'React Native, Flutter, iOS, Android', match: /react native|flutter|swift|kotlin/i },
+  { id: 'designer', group: 'Design', title: 'UI/UX Designer', keywords: 'Figma, UI/UX, product design', match: /ui\/?ux|product design|figma/i },
+  { id: 'pm', group: 'Management', title: 'Project / Product Manager', keywords: 'product management, agile, roadmap, stakeholders', match: /product manager|project manager|product owner/i },
+];
+
+export const SENIORITY = ['', 'Junior', 'Middle', 'Senior', 'Lead'];
+
+export const LOCATIONS = [
+  'Ukraine', 'Poland', 'Czech Republic', 'Germany', 'Spain', 'Portugal',
+  'Romania', 'Bulgaria', 'Georgia', 'Armenia', 'Kazakhstan', 'Other',
+];
+
+/** Автоподбор ролей по тексту резюме: топ-3 совпадения в порядке каталога. */
+export function detectRoles(resumeText) {
+  if (!resumeText) return [];
+  return ROLE_CATALOG.filter(r => r.match.test(resumeText)).slice(0, 3).map(r => r.id);
+}

package/tools/work-finder/vendor/lib/channels.mjs

@@ -0,0 +1,73 @@
+// Search CHANNELS the agent can cover. The universe is grouped so the whole
+// coverage roadmap slots in here (a new source joins an existing group's fragment),
+// and — because search is prompt-driven — enabling/disabling a group just shapes the
+// source instructions; no per-source API integration is needed for the toggle to work.
+//
+// Narrowing the set is a PAID feature (owner 2026-07-25): free ALWAYS searches every
+// channel — coverage is identical for everyone — only a paying user may target/exclude.
+// The server enforces this by passing canNarrow=false for free plans.
+//
+// `label` is English (the agent reads it in the prompt). The UI's localized names live
+// in the frontend i18n (settings.ch.*), keyed by the same id.
+
+export const CHANNELS = [
+  {
+    id: 'ats',
+    label: 'Company careers & ATS',
+    frag: 'Company career pages & ATS — dork "<role> remote": site:boards.greenhouse.io, site:jobs.lever.co, site:jobs.ashbyhq.com, site:apply.workable.com, site:careers.smartrecruiters.com, *.myworkdayjobs.com, Recruitee, Teamtailor, BambooHR. Always prefer the company\'s OWN careers/ATS URL.',
+  },
+  {
+    id: 'boards',
+    label: 'Job boards & aggregators',
+    frag: 'Global job boards & aggregators — DIVERSIFY, ≤2-3 per board: RemoteOK, WeWorkRemotely, Remotive, Himalayas.app, Wellfound, Otta, Jobgether, Google for Jobs, Adzuna, EU boards.',
+  },
+  {
+    id: 'community',
+    label: 'Community (HN, Reddit)',
+    frag: 'Community threads: the current month\'s Hacker News "Ask HN: Who is hiring?" (search hn.algolia.com) and relevant Reddit hiring threads — companies that post ONLY there, often worldwide-remote.',
+  },
+  {
+    id: 'cis',
+    label: 'CIS / Ukraine boards',
+    frag: 'CIS / Ukraine boards: djinni.co, jobs.dou.ua, Work.ua, robota.ua, Habr Career — the candidate\'s home market; public listings are searchable.',
+  },
+  {
+    id: 'relocate',
+    label: 'Relocation / EU',
+    frag: 'Relocation / EU boards: justjoin.it, nofluffjobs.com, relocate.me, Landing.jobs — roles that offer relocation or EU-wide remote.',
+  },
+  {
+    id: 'signals',
+    label: 'Early hiring signals',
+    frag: 'Hiring SIGNALS before a role hits any board: freshly funded startups, brand-new YC batch companies, Product Hunt launches, GitHub orgs advertising "we\'re hiring" — reach the company or founder directly. These are found EARLIER than boards.',
+  },
+];
+
+export const CHANNEL_IDS = CHANNELS.map((c) => c.id);
+
+/** Which channels this search runs. Free (canNarrow=false) always gets ALL of them —
+ *  narrowing is a paid privilege. Falls back to the old excludeBoards flag, and never
+ *  returns an empty set. */
+export function enabledChannelIds(settings, canNarrow) {
+  if (!canNarrow) return CHANNEL_IDS;
+  const sel = settings?.channels;
+  if (!Array.isArray(sel)) {
+    return settings?.excludeBoards ? CHANNEL_IDS.filter((id) => id !== 'boards') : CHANNEL_IDS;
+  }
+  const valid = sel.filter((id) => CHANNEL_IDS.includes(id));
+  return valid.length ? valid : CHANNEL_IDS;
+}
+
+/** Build the SEARCH STRATEGY block for the prompt from the enabled channels, plus an
+ *  explicit "do NOT return listings from these" line for the disabled ones. */
+export function searchStrategyBlock(settings, canNarrow) {
+  const enabled = new Set(enabledChannelIds(settings, canNarrow));
+  const on = CHANNELS.filter((c) => enabled.has(c.id));
+  const lines = on.map((c, i) => `${String.fromCharCode(97 + i)}) ${c.frag}`);
+  let block = `SEARCH STRATEGY — combine ALL the channels below, do not lean on one:\n${lines.join('\n')}`;
+  const off = CHANNELS.filter((c) => !enabled.has(c.id));
+  if (off.length) {
+    block += `\n\nCHANNELS DISABLED BY THE USER — do NOT return any vacancy hosted on these (you may glance at them for DISCOVERY only, but the returned vacancy_url must never be hosted there): ${off.map((c) => c.label).join('; ')}.`;
+  }
+  return block;
+}