jobhunt-kit 0.2.0

package/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "personal",
+  "interface": {
+    "displayName": "Personal"
+  },
+  "plugins": [
+    {
+      "name": "jobhunt-kit",
+      "source": {
+        "source": "local",
+        "path": "./plugins/jobhunt-kit"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "name": "jobhunt-kit-marketplace",
+  "owner": {
+    "name": "Jobhunt Kit contributors"
+  },
+  "plugins": [
+    {
+      "name": "jobhunt-kit",
+      "source": "./plugins/jobhunt-kit",
+      "description": "Candidate intake, resume review, Hirify search and local tracking",
+      "version": "0.2.0"
+    }
+  ]
+}

package/AGENTS.md

@@ -0,0 +1,23 @@
+# Jobhunt Kit template
+
+This repository is a reusable template, not the owner's job search. Do not populate a
+real profile, call Hirify account/search APIs, apply, or schedule tasks while developing
+the template. Use temporary directories and clearly fictional fixtures for validation.
+
+When the user requests a job search, initialize their local data through job-profile.
+Keep personal files under local/ (gitignored), never in plugins/ or examples/.
+
+The portable plugin is plugins/jobhunt-kit. For job-search use, read the relevant entry:
+
+- skills/job-profile/SKILL.md — initialize/update candidate and reusable answers.
+- skills/job-resume/SKILL.md — evidence-based resume review.
+- skills/job-search/SKILL.md — bounded Hirify search and matching.
+- skills/job-apply/SKILL.md — cover letter, approval, sending, manual handoff.
+- skills/job-track/SKILL.md — local statuses, reports and optional schedule setup.
+
+All paths above are relative to plugins/jobhunt-kit. Shared rules are in
+references/workflow.md. SQLite is authoritative for vacancy/application history;
+profile.json is authoritative for candidate facts. Markdown summaries are derived.
+
+Use `npm test` for offline checks. Never test sending on real vacancies. Do not push
+candidate files. Installing a plugin does not authorize applications or account changes.

package/CLAUDE.md

@@ -0,0 +1,5 @@
+# Jobhunt Kit
+
+Read AGENTS.md for project scope and skill routing. The portable plugin is
+plugins/jobhunt-kit; its skills and references work without a particular agent vendor.
+This checkout is a universal template. Do not infer a candidate from the repository owner.

package/README.md

@@ -0,0 +1,122 @@
+# Jobhunt Kit
+
+```sh
+npx jobhunt-kit install
+```
+
+Поиск работы вместе с AI-агентом: профиль кандидата, проверка резюме, подбор вакансий
+через Hirify, сопроводительные письма и история откликов.
+
+Нужны **Node.js 24+, Git и Codex или Claude Code**. Установщик создаст папку
+`my-jobhunt` и установит зависимости. Чтобы выбрать другую папку, добавьте путь
+в конце команды: `install ./my-folder`.
+
+## Начало работы
+
+1. Откройте `my-jobhunt` в агенте.
+2. Напишите: **«Инициализируй мой профиль поиска работы»**. Агент запросит резюме,
+   уточнит опыт, предпочтения и условия поиска.
+3. В терминале этой папки выполните `npm run hirify -- login` для входа в Hirify.
+4. После подтверждения профиля попросите: **«Найди до пяти новых подходящих вакансий»**.
+5. Выберите вакансию и попросите подготовить отклик. Перед отправкой агент запросит
+   согласование.
+
+Страны, роли и формат занятости задаются в профиле. Для независимых профилей
+используйте отдельные рабочие папки.
+
+## Возможности
+
+| Навык | Что делает |
+|---|---|
+| [job-profile](plugins/jobhunt-kit/skills/job-profile/SKILL.md) | Собирает профиль, предпочтения и ответы на вопросы анкет |
+| [job-resume](plugins/jobhunt-kit/skills/job-resume/SKILL.md) | Проверяет содержание, читаемость и соответствие резюме выбранным ролям |
+| [job-search](plugins/jobhunt-kit/skills/job-search/SKILL.md) | Подбирает до пяти новых подходящих вакансий за запуск и объясняет выбор |
+| [job-apply](plugins/jobhunt-kit/skills/job-apply/SKILL.md) | Готовит письмо и отправляет согласованный отклик через Hirify |
+| [job-track](plugins/jobhunt-kit/skills/job-track/SKILL.md) | Ведёт историю, обновляет статусы и помогает настроить поиск по расписанию |
+
+По умолчанию каждый отклик согласуется отдельно. Автоматическую отправку можно
+включить с ограничением срока и количества откликов. Для внешних форм агент готовит
+ссылку, письмо и ответы, а отправку выполняете вы.
+
+При отправке через Hirify используется выбранный профиль сервиса. Локальный файл
+резюме автоматически туда не загружается. О приглашениях и ответах рекрутеров
+сообщайте агенту, чтобы он обновил статусы.
+
+## Команды
+
+Запускайте из установленной папки:
+
+```sh
+npx jobhunt-kit doctor
+npx jobhunt-kit profile init
+npx jobhunt-kit resume ./resume.pdf
+npx jobhunt-kit profile check
+npx jobhunt-kit search
+npx jobhunt-kit track
+npx jobhunt-kit report
+```
+
+`resume` извлекает текст PDF, DOCX, TXT или Markdown и готовит материалы для проверки
+агентом. `search` собирает контекст для агента, который выполняет поиск и оценивает
+вакансии. Команды также позволяют управлять профилем, черновиками и статусами.
+
+[Справочник команд](plugins/jobhunt-kit/references/cli.md).
+
+## Локальные данные
+
+Профиль, резюме и история хранятся в `local/jobhunt-kit/`:
+
+| Путь | Содержимое |
+|---|---|
+| `profile.json` | Факты, предпочтения и ответы кандидата |
+| `policy.json` | Условия поиска и согласования откликов |
+| `history.sqlite` | История поисков, вакансий и откликов |
+| `resumes/` | Версии резюме |
+| `materials/` | Письма, ответы и материалы проверки |
+| `reports/latest.md` | Сводный отчёт |
+
+Папка `local/` исключена из Git. Храните личные файлы в ней; для резервной копии
+сохраняйте всю папку при остановленных процессах. Данные на диске не зашифрованы.
+
+## Подключение как плагина
+
+В установленной рабочей папке навыки доступны через инструкции для агента.
+При необходимости их можно подключить отдельно как плагин.
+
+**Codex** — из корня установленной папки:
+
+```sh
+codex plugin marketplace add .
+codex plugin add jobhunt-kit@personal
+```
+
+После установки начните новую сессию. `personal` — имя каталога плагинов,
+включённого в шаблон.
+
+**Claude Code** — для текущей сессии:
+
+```sh
+claude --plugin-dir ./plugins/jobhunt-kit
+```
+
+Вызов навыка: `/jobhunt-kit:job-profile`. Для постоянной установки используйте
+`/plugin marketplace add .`, затем `/plugin install jobhunt-kit@jobhunt-kit-marketplace`.
+
+При отдельной установке плагина агент подготовит локальные зависимости во время
+инициализации профиля. Вход в Hirify выполняется отдельно.
+
+## Разработка
+
+```sh
+npm ci --ignore-scripts
+npm test
+npm run check
+```
+
+Тесты работают с вымышленными данными и не отправляют реальные отклики.
+
+Руководства: [формат данных](plugins/jobhunt-kit/references/storage.md),
+[проверка резюме](plugins/jobhunt-kit/references/resume-guidance.md),
+[сопроводительные письма](plugins/jobhunt-kit/references/cover-guidance.md).
+
+Автор этого шаблона никак не аффилирован с Hirify.

package/bin/jobhunt-kit.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync, realpathSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const SOURCE = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const roots = ['bin', 'installer-assets', 'plugins/jobhunt-kit', 'scripts', 'tests',
+  'AGENTS.md', 'CLAUDE.md', 'README.md', 'package.json',
+  '.agents/plugins/marketplace.json', '.claude-plugin/marketplace.json'];
+function collect(path) {
+  const stat = lstatSync(path);
+  if (stat.isSymbolicLink()) throw new Error(`Symlink in template: ${path}`);
+  if (!stat.isDirectory()) return [path];
+  return readdirSync(path).filter(n => !['node_modules', '__pycache__', '.git'].includes(n))
+    .flatMap(n => collect(join(path, n)));
+}
+function noSymlinks(path) {
+  let current = resolve(path);
+  while (true) {
+    if (existsSync(current) && lstatSync(current).isSymbolicLink()) throw new Error(`Destination contains a symlink: ${current}`);
+    const parent = dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+}
+export function install(destination, { source = SOURCE, installDependencies = true } = {}) {
+  if (Number(process.versions.node.split('.')[0]) < 24) throw new Error('Node.js 24 or newer is required');
+  const target = resolve(destination);
+  source = resolve(source);
+  if (target === source || !relative(source, target).startsWith('..')) throw new Error('Choose a destination outside the installer package');
+  const files = new Map();
+  for (const root of roots) for (const path of collect(join(source, root))) files.set(relative(source, path), path);
+  // npm omits package-lock.json and may omit .gitignore; ship them under explicit asset names.
+  files.set('.gitignore', join(source, 'installer-assets/gitignore.txt'));
+  files.set('package-lock.json', join(source, 'installer-assets/workspace-lock.json'));
+  files.set('plugins/jobhunt-kit/package-lock.json', join(source, 'installer-assets/runtime-lock.json'));
+  const pending = [];
+  for (const [name, input] of files) {
+    const output = join(target, name);
+    noSymlinks(output);
+    let parent = dirname(output);
+    while (parent !== dirname(parent)) {
+      if (existsSync(parent) && !lstatSync(parent).isDirectory()) throw new Error(`Destination directory is a file: ${parent}`);
+      parent = dirname(parent);
+    }
+    if (existsSync(output)) {
+      if (!lstatSync(output).isFile() || !readFileSync(output).equals(readFileSync(input))) {
+        throw new Error(`Existing file differs; nothing copied: ${output}. Choose an empty folder or keep your existing installation.`);
+      }
+    } else pending.push([input, output]);
+  }
+  for (const [input, output] of pending) {
+    mkdirSync(dirname(output), { recursive: true });
+    copyFileSync(input, output);
+  }
+  if (installDependencies) {
+    const options = { cwd: target, stdio: 'inherit', windowsHide: true };
+    const result = process.platform === 'win32'
+      ? spawnSync('cmd.exe', ['/d', '/s', '/c', 'npm ci --ignore-scripts --no-audit --no-fund'], options)
+      : spawnSync('npm', ['ci', '--ignore-scripts', '--no-audit', '--no-fund'], options);
+    if (result.error || result.status !== 0) throw new Error(`Template copied to ${target}, but dependencies were not installed. Retry the same init command. ${result.error?.message || ''}`);
+  }
+  const binDir = join(target, 'node_modules', '.bin');
+  noSymlinks(binDir);
+  noSymlinks(join(binDir, 'jobhunt-kit.cmd'));
+  noSymlinks(join(binDir, 'jobhunt-kit'));
+  mkdirSync(binDir, { recursive: true });
+  writeFileSync(join(binDir, 'jobhunt-kit.cmd'), '@echo off\r\nnode "%~dp0..\\..\\bin\\jobhunt-kit.mjs" %*\r\n');
+  writeFileSync(join(binDir, 'jobhunt-kit'), '#!/bin/sh\nexec node "$(dirname "$0")/../../bin/jobhunt-kit.mjs" "$@"\n', { mode: 0o755 });
+  return { directory: target, copied: pending.length, dependencies_installed: installDependencies };
+}
+export async function main(args) {
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    console.log('Usage: jobhunt-kit <command> [arguments] [--workspace dir | --data dir]\n\ninstall [directory]              Install template (default: ./my-jobhunt)\ninit <directory>                 Alias with an explicit destination\nprofile init|show|check          Initialize/view/validate local profile\nprofile save --input file        Save profile and clear confirmation\nprofile confirm --note text      Record explicit candidate confirmation\nresume [file]                   Import file, fingerprint and mechanical checks\nresume check|reviewed            Inspect file / record agent review (--input file)\nsearch [plan]                   Prepare context for agent; no live search\nsearch start|event|record|finish  Persist search operations (--input file)\napply preview|export|begin slug  Review/export/reserve application\napply prepare|approve|send|finish|resolve --input file\ntrack list|show slug|status slug --input file\nhistory | runs | report          Inspect history or generate Markdown report\npolicy show|set --input file     Inspect/set application policy\nschedule --input file            Generate scheduler prompt; does not schedule\ndoctor                          Check local setup without network\n\nNode.js 24+ required. Default data: ./local/jobhunt-kit. Only apply send performs a live application call.');
+    return;
+  }
+  if (!['init', 'install'].includes(args[0])) {
+    const { runCommand } = await import('../plugins/jobhunt-kit/scripts/commands.mjs');
+    const result = runCommand(args);
+    console.log(JSON.stringify(result, null, 2));
+    if (result && Object.hasOwn(result, 'valid') && result.valid === false) process.exitCode = 1;
+    if (result?.attempt_id && Object.hasOwn(result, 'exit_code')) process.exitCode = result.exit_code ?? 1;
+    return;
+  }
+  if (args.length > 2 || (args[0] === 'init' && !args[1]) || args[1]?.startsWith('-')) {
+    throw new Error('Usage: jobhunt-kit install [directory] (default: ./my-jobhunt), or jobhunt-kit init <directory>');
+  }
+  const result = install(args[1] || './my-jobhunt');
+  console.log(`\nJobhunt Kit ready: ${result.directory}\nCopied files: ${result.copied}\nOpen this folder in Codex or Claude Code and ask: use job-profile to initialize my profile.\nWhen needed, sign in yourself from that folder: npm run hirify -- login\nNo profile, schedule, search or application was created.`);
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
+  try { await main(process.argv.slice(2)); }
+  catch (e) { console.error(`jobhunt-kit: ${e.message}`); process.exitCode = 1; }
+}

package/installer-assets/gitignore.txt

@@ -0,0 +1,22 @@
+node_modules/
+*.log
+.env
+.DS_Store
+
+# All candidate information and generated materials stay local.
+local/
+.env.*
+!.env.example
+**/node_modules/
+*.sqlite*
+*.db
+*.db-*
+*.pdf
+*.docx
+*.doc
+*.rtf
+*.zip
+.claude/settings.local.json
+__pycache__/
+.tmp/
+*.tgz