jobhunt-kit 0.2.0

package/plugins/jobhunt-kit/skills/job-search/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: job-search
+description: Find up to five new suitable vacancies through Hirify using a confirmed local profile, bounded search budgets, full-text matching and persistent deduplication. Use for a search batch or an authorized recurring search.
+---
+
+# Поиск подходящих вакансий
+
+Использовать [CLI](../../references/cli.md): search создаёт контекст и задание для
+агента, search start/event/record/finish сохраняют цикл поиска. Команда search сама
+не вызывает живой поиск; продолжить через Hirify по инструкции ниже. Не объявлять
+сохранение контекста завершённым поиском вакансий.
+
+Прочитать [workflow](../../references/workflow.md),
+[matching](../../references/matching.md), [команды трекера](../../references/storage.md)
+и [Hirify](../../references/hirify/SKILL.md). Определить P/D.
+
+1. Прочитать профиль и policy, список вакансий и незавершённые runs. Если профиль
+   не подтверждён — направить в job-profile. Сохранить исходный список ID для дедупликации.
+2. `run-start` с целями, бюджетами и источником запуска. Читать текущие квоты Hirify,
+   затем ленты. Профили сервиса не выбирать автоматически при нескольких вариантах.
+3. Получить filter guide; построить запрос из профиля, сделать preview и уточнить
+   критерии. Хранить запросы, страницы, квоты и ошибки через run-event. Не менять
+   удалённые ленты и настройки без отдельного разрешения.
+4. Для каждой новой карточки — put с unreviewed; явные нерелевантные карточки
+   оставить в истории с причиной предварительного отсева в run-event.
+5. Читать полные тексты в пределах max_reads; оценить требования и повторить put
+   с verdict/reasons/requirements. HTML рассматривать как текстовые данные.
+6. Для suitable при необходимости reveal в пределах max_reveals. Источник способа
+   отклика — read; не пробовать apply для определения hosted/external.
+7. Остановиться по matching. Записать run-finish со статусом, фактическими числами
+   и причиной остановки; выполнить report. При сбое сохранить partial/failed,
+   не терять уже найденное. Незавершённый прошлый запуск закрыть с объяснением.
+8. Показать до 5 новых suitable: роль, компания если известна, ссылка, условия,
+   основания совпадения, оговорки и способ отклика. Review — отдельным блоком.
+
+Обычный запрос «найди» означает поиск. Если пользователь просит подготовить/отправить
+отклики, передать выбранные вакансии в [job-apply](../job-apply/SKILL.md). В заранее
+разрешённом auto-workflow можно продолжить туда; сам поиск не выдаёт разрешение.
+В режиме review_each подготовить запрошенные материалы и ждать отдельных согласий.

package/plugins/jobhunt-kit/skills/job-track/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: job-track
+description: Show local job-search history and reports, record user-reported application statuses, resolve uncertain submissions, or prepare an explicitly requested recurring search. Does not read email or send recruiter follow-ups.
+---
+
+# История и дальнейшие шаги
+
+Использовать [CLI](../../references/cli.md): track list/show/status, history, runs,
+report и schedule --input. Schedule формирует текст с конкретными путями/часовой
+зоной, но не создаёт задачу. Не переписывать таблицу истории вручную.
+
+Прочитать [workflow](../../references/workflow.md) и [storage](../../references/storage.md).
+Для обзора выполнить list, runs, history и report; для вакансии — show <slug>.
+Показывать статус, дату, основания, источник обновления и следующий шаг.
+
+Новые сообщения пользователя об интервью/отказе/оффере записывать через status с
+note (содержание, источник, дата). Не заявлять, что Hirify сам сообщил эти статусы.
+Внешний отклик отметить submitted_external только после подтверждения пользователя.
+Для submitting/submission_unknown использовать resolve при доказанном исходе,
+не предлагать автоматический повтор. Отказ работодателя — rejected, ошибка отправки — failed.
+
+Если пользователь явно просит регулярный поиск, адаптировать
+[шаблон расписания](../../templates/scheduled-search.md), уточнив частоту/часовой пояс
+и доступность машины. Создать задачу штатным инструментом агента, если он доступен.
+Если инструмента нет — сохранить готовый prompt и инструкции, честно сказать, что
+задача не создана. В Codex использовать automation_update; в другой среде её scheduler.
+Не создавать расписание при установке шаблона. Параллельные поиски по одному D не запускать.
+
+Ничего не отправлять работодателям из скилла трекинга. Отмена локального статуса
+не отзывает отправленное через Hirify заявление. Напоминания — только пользователю.

package/plugins/jobhunt-kit/templates/cover-letter.md

@@ -0,0 +1,17 @@
+# Черновик сопроводительного письма
+
+Этот шаблон задаёт структуру; его нельзя отправлять с незаполненными полями.
+
+1. Обращение, если адресат достоверно известен, и название роли.
+2. Почему задача интересна кандидату — из его слов и проверенного описания вакансии.
+3. Один-два подтверждённых примера: задача → действие → результат, связанные с требованиями.
+4. Короткое приглашение обсудить роль. Доступность/контакт только если это нужно.
+
+Отдельно от отправляемого текста сохранить:
+
+- Для каждого фактического утверждения — evidence ID из profile.json.
+- Неизвестные ответы и вопросы работодателю.
+- Язык, выбранный профиль Hirify и точный способ отправки.
+
+Для CLI хранить только текст письма в поле cover_letter файла draft.json.
+Не включать в письмо внутренние оценки, evidence ID и служебные пояснения.

package/plugins/jobhunt-kit/templates/intake.md

@@ -0,0 +1,62 @@
+# Анкета инициализации профиля
+
+Заполнять поэтапно, 3–5 вопросов за сообщение. Сначала извлечь ответы из резюме,
+затем уточнить недостающее. Не просить человека повторять уже известное.
+Можно ответить «не определился», «не применимо» или отказаться от необязательного поля.
+`null` означает неизвестно, а не «нет». Это не анкета конкретного владельца проекта.
+
+## 1. Исходные материалы
+
+- Прикрепите актуальное резюме или укажите локальный файл. Какие версии и языки актуальны?
+- Есть ли портфолио, профессиональные ссылки, проекты или публикации?
+- Какие сведения устарели, неточны, конфиденциальны или не должны попасть в отклики?
+- На каком языке общаться с агентом? На каких языках готовить материалы?
+
+## 2. Цели поиска (нужно до поиска)
+
+- Какие роли и альтернативные названия интересуют? Какой уровень и тип ответственности?
+- Какие страны/города подходят, включая ограничения удалённой работы по месту проживания?
+- Удалёнка, гибрид, офис — какие варианты допустимы? Возможны ли переезд и командировки?
+- Полная/частичная занятость, контракт, стажировка; какие график и пересечение часовых поясов?
+- Минимальная и желаемая компенсация: число, валюта, месяц/год/час, gross/net?
+  Рассматривать ли вакансии без указанной суммы? Бонусы/доли считать отдельно?
+- Отрасли и типы компаний: желаемые и исключённые? Есть ли конкретные исключения?
+- Какие условия обязательны, а какие предпочтительны? Чем готовы поступиться?
+- Есть ли право работать в выбранных странах, нужна ли поддержка с визой?
+  Записать ответ кандидата; не делать правовых выводов.
+
+## 3. Контакты и типовые поля анкет (нужно до отклика, не всё до поиска)
+
+- Имя для резюме/откликов; email; телефон с кодом страны; предпочтительный контакт?
+- Город, страна проживания и часовой пояс? Полный адрес обычно не нужен.
+- Какие профессиональные ссылки можно передавать работодателям?
+- Когда готовы начать, срок уведомления, удобные часы интервью?
+- Языки и уровень владения: самооценка или сертификат с датой?
+- Как ответить на «расскажите о себе», «почему ищете работу», «почему эта роль»?
+- Какие фактические ответы есть на вопросы об опыте, руководстве, инструментах,
+  обучении, сертификатах? Длительность опыта не удваивать при пересечении проектов.
+- Есть ли уже отправленные отклики/знакомства с работодателями, которые нужно импортировать?
+
+Не собирать заранее паспортные данные, банковские реквизиты, дату рождения,
+семейное положение, медицинские сведения и контакты рекомендателей. Не выбирать
+демографические ответы за человека. Если внешняя форма требует таких данных — ручной шаг.
+
+## 4. Проверяемые примеры
+
+- 2–5 значимых результатов: задача, личный вклад, результат и откуда известно число?
+- Какие кейсы можно обсуждать публично, какие только обезличенно?
+- Какие пробелы/переходы требуют объяснения? Уточнять без оценки и давления.
+
+## 5. Настройки процесса
+
+- Есть ли нужный профиль или сохранённые ленты Hirify? Выбрать ID вместе с пользователем.
+- По умолчанию до 5 новых подходящих вакансий за поиск. Подходят ли бюджеты policy.json?
+- Подтверждать каждый отклик (по умолчанию) или отдельно настроить ограниченную
+  автоотправку через job-apply? Установка шаблона не включает её.
+- Нужно ли расписание? Если да: частота, часовой пояс, где запускать и когда уведомлять?
+
+## Финальное подтверждение
+
+Показать резюме профиля: цели, обязательные условия, факты, неизвестное, контакты для
+передачи и выбранный Hirify-профиль. После подтверждения заполнить confirmed_at.
+Согласие с профилем не является согласием на отправку откликов.

package/plugins/jobhunt-kit/templates/policy.json

@@ -0,0 +1,6 @@
+{
+  "schema_version": 1,
+  "mode": "review_each",
+  "search": { "target": 5, "max_cards": 100, "max_reads": 20, "max_reveals": 5, "max_minutes": 15 },
+  "auto": null
+}

package/plugins/jobhunt-kit/templates/profile.json

@@ -0,0 +1,29 @@
+{
+  "schema_version": 1,
+  "confirmed_at": null,
+  "identity": {
+    "name": null, "email": null, "phone": null, "city": null,
+    "country": null, "timezone": null, "contact_links": []
+  },
+  "search": {
+    "roles": [], "levels": [], "countries": [], "work_modes": [],
+    "employment_types": [], "industries": [], "excluded_companies": [],
+    "excluded_keywords": [], "relocation": null, "travel": null,
+    "working_hours": null, "work_authorization": [], "sponsorship": null,
+    "salary": { "min": null, "target": null, "currency": null, "period": null, "tax_basis": null },
+    "hard_constraints": [], "preferences": [],
+    "unknown_salary": "ask", "unknown_critical_requirement": "ask",
+    "feed_ids": [], "queries": []
+  },
+  "languages": [],
+  "experience": [],
+  "education": [],
+  "skills": [],
+  "achievements": [],
+  "evidence": [],
+  "answers": [],
+  "availability": { "notice_period": null, "start_date": null, "interview_hours": null },
+  "writing": { "resume_languages": [], "cover_languages": [], "tone": null, "motivation": null },
+  "hirify_profile_id": null,
+  "resume": { "path": null, "sha256": null, "review_status": "not_reviewed" }
+}

package/plugins/jobhunt-kit/templates/profile.md

@@ -0,0 +1,21 @@
+# Профиль кандидата
+
+Не заполнен. Сначала пройти анкету. Источник фактов — `profile.json`.
+Это читаемое представление: изменения переносить в JSON и подтверждать у кандидата.
+
+## Позиционирование
+
+Целевые роли и уровень, подтверждённый опыт, сильные стороны и примеры результатов.
+
+## Что ищу
+
+Обязательные условия отдельно от предпочтений. География, формат работы, компенсация
+с валютой, периодом и gross/net; готовность к переезду, график, язык.
+
+## Банк фактов
+
+Для каждого утверждения указать evidence ID из JSON. Неизвестные значения не угадывать.
+
+## Открытые вопросы
+
+Противоречия, недостающие сведения и детали, требующие подтверждения кандидата.

package/plugins/jobhunt-kit/templates/resume-review.md

@@ -0,0 +1,30 @@
+# Проверка резюме
+
+Дата / версия файла / SHA-256 / целевая роль и рынок:
+
+## Итог
+
+Готово / нужны изменения / заблокировано недостающими фактами.
+Это локальная экспертная проверка, не результат реального ATS работодателя.
+
+## Что действительно проверено
+
+Извлечение текста / порядок чтения / визуальный просмотр / ссылки / факты с кандидатом.
+Для каждого — выполнено, не выполнено или неприменимо и каким способом проверяли.
+
+## Замечания
+
+| Приоритет | Место и наблюдение | Почему мешает | Предлагаемое исправление | Источник правила |
+|---|---|---|---|---|
+
+## Факты и вопросы
+
+Противоречия, отсутствующие даты, неподтверждённые цифры; отдельные вопросы кандидату.
+
+## Соответствие роли
+
+Требование → доказательство в резюме → реальный пробел или улучшение формулировки.
+
+## После исправлений
+
+Какие проверки повторены и какие ограничения остались.

package/plugins/jobhunt-kit/templates/scheduled-search.md

@@ -0,0 +1,21 @@
+# Шаблон задания для планировщика
+
+Перед сохранением заменить все поля в угловых скобках. Это текст задания,
+а не уже включённое расписание. Частота: <расписание>, часовой пояс: <IANA timezone>.
+Рабочая папка: <абсолютный workspace>, P: <абсолютный путь плагина>,
+D: <абсолютный путь локальных данных>. Согласованный режим: <search / prepare / auto>.
+
+Используй job-search из P с подтверждённым профилем D. Найди до пяти новых подходящих
+вакансий через Hirify, соблюдая меньший из текущих квот сервиса и бюджетов policy.json.
+Сохрани запросы, результаты, причины совпадения и завершение запуска в локальном трекере.
+Не запускай второй поиск, пока предыдущий по этому D активен; проверь его состояние.
+
+В search только сообщи результаты. В prepare подготовь письма для согласования.
+В auto используй job-apply только при действующем явном разрешении в policy и всех
+пройденных проверках; иначе сохрани материалы для пользователя. Не отправляй внешние
+формы и не меняй настройки Hirify. Не повторяй отклики с неопределённым результатом.
+
+Обнови Markdown-отчёт. Не уведомляй, если нет новых подходящих вакансий или значимых
+изменений. Уведоми о новых suitable, отправленных откликах, сбое, истёкшем разрешении
+или требуемом действии. Укажи ссылки на локальные материалы. Не читай почту и не пиши
+рекрутерам. Если профиль не заполнен — сообщи один раз, что нужна инициализация.

package/scripts/check-package.mjs

@@ -0,0 +1,62 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import assert from 'node:assert/strict';
+
+const root = resolve('plugins/jobhunt-kit');
+function walk(dir) {
+  return readdirSync(dir, { withFileTypes: true }).flatMap(e => e.name === 'node_modules' ? [] : e.isDirectory() ? walk(join(dir, e.name)) : [join(dir, e.name)]);
+}
+const files = walk(root);
+for (const file of files) {
+  assert.ok(!/\.(sqlite|db|pdf|docx|zip)(-|$)/i.test(file), `Personal/runtime artifact in plugin: ${file}`);
+  if (file.endsWith('.json')) JSON.parse(readFileSync(file, 'utf8'));
+  if (file.endsWith('.md')) {
+    const body = readFileSync(file, 'utf8');
+    assert.ok(!body.includes('[TODO:'), `Unfinished scaffold: ${file}`);
+    for (const m of body.matchAll(/\[[^\]]*\]\(([^)]+)\)/g)) {
+      const link = m[1];
+      if (/^(https?:|#)/.test(link)) continue;
+      assert.ok(existsSync(resolve(dirname(file), link.split('#')[0])), `Broken link ${file}: ${link}`);
+    }
+  }
+}
+const load = path => JSON.parse(readFileSync(path, 'utf8'));
+const profile = load(join(root, 'templates/profile.json'));
+assert.equal(profile.confirmed_at, null);
+assert.equal(profile.hirify_profile_id, null);
+assert.deepEqual(profile.search.roles, []);
+assert.deepEqual(profile.evidence, []);
+assert.ok(Object.values(profile.identity).every(v => v === null || Array.isArray(v) && v.length === 0));
+assert.equal(load(join(root, 'templates/policy.json')).mode, 'review_each');
+assert.equal(load(join(root, 'templates/policy.json')).auto, null);
+const codex = load(join(root, '.codex-plugin/plugin.json'));
+const claude = load(join(root, '.claude-plugin/plugin.json'));
+assert.equal(codex.name, 'jobhunt-kit'); assert.equal(claude.name, codex.name);
+assert.equal(codex.version, claude.version);
+for (const file of ['.agents/plugins/marketplace.json', '.claude-plugin/marketplace.json']) {
+  const market = load(file);
+  for (const plugin of market.plugins) {
+    const source = typeof plugin.source === 'string' ? plugin.source : plugin.source.path;
+    assert.ok(existsSync(resolve(source, '.codex-plugin/plugin.json')));
+  }
+}
+const skills = readdirSync(join(root, 'skills'));
+assert.equal(skills.length, 5);
+for (const skill of skills) {
+  const body = readFileSync(join(root, 'skills', skill, 'SKILL.md'), 'utf8');
+  assert.ok(body.startsWith('---\n') || body.startsWith('---\r\n'));
+  assert.match(body, new RegExp(`name: ${skill}\\r?\\n`));
+  assert.match(body, /description: .+/);
+}
+for (const folder of ['.', root]) {
+  const pkg = load(join(folder, 'package.json'));
+  const lock = load(join(folder, 'package-lock.json'));
+  assert.equal(lock.packages['node_modules/hirify-cli'].version, '0.4.5');
+  assert.deepEqual(lock.packages[''].dependencies || lock.packages[''].devDependencies, pkg.dependencies || pkg.devDependencies);
+}
+for (const [source, asset] of [
+  ['.gitignore', 'installer-assets/gitignore.txt'],
+  ['package-lock.json', 'installer-assets/workspace-lock.json'],
+  ['plugins/jobhunt-kit/package-lock.json', 'installer-assets/runtime-lock.json']
+]) assert.ok(readFileSync(source).equals(readFileSync(asset)), `Installer asset drift: ${asset}`);
+console.log(`PACKAGE_OK: ${skills.length} skills, ${files.length} plugin files, valid JSON, local links, empty profile, disabled auto, pinned dependency`);

package/tests/commands.test.mjs

@@ -0,0 +1,143 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, readFileSync, writeFileSync, existsSync, rmSync, mkdirSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve, sep, dirname } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { runCommand } from '../plugins/jobhunt-kit/scripts/commands.mjs';
+import { validateProfile } from '../plugins/jobhunt-kit/scripts/profile.mjs';
+
+function fixture(t) {
+  const cwd = mkdtempSync(join(tmpdir(), 'job-search-command-'));
+  t.after(() => {
+    assert.ok(resolve(cwd).startsWith(resolve(tmpdir()) + sep) && cwd.includes('job-search-command-'));
+    rmSync(cwd, { recursive: true, force: true });
+  });
+  const call = (...args) => runCommand(args, { cwd });
+  const input = (data, name = 'input.json') => { writeFileSync(join(cwd, name), JSON.stringify(data)); return name; };
+  return { cwd, call, input, dir: join(cwd, 'local/jobhunt-kit') };
+}
+function ready(f) {
+  f.call('profile', 'init');
+  writeFileSync(join(f.cwd, 'fictional.txt'), 'Fictional Candidate\nfictional@example.invalid\nExperience\nLibrary work.');
+  f.call('resume', 'fictional.txt');
+  const profile = f.call('profile', 'show').profile;
+  profile.search.roles = ['Fictional librarian']; profile.hirify_profile_id = 123;
+  profile.evidence = [{ id: 'E1', text: 'Library work', source: 'fictional test', confirmed: true }];
+  f.call('profile', 'save', '--input', f.input(profile));
+  f.call('resume', 'reviewed', '--input', f.input({ sha256: profile.resume.sha256, status: 'ready', checks: { text: 'pass', visual: 'pass', facts: 'pass' }, evidence: 'Synthetic review only' }));
+  f.call('profile', 'confirm', '--note', 'Synthetic candidate confirmation');
+}
+test('doctor does not create candidate data and profile init creates only empty templates', t => {
+  const f = fixture(t);
+  assert.equal(f.call('doctor').initialized, false);
+  assert.equal(existsSync(f.dir), false);
+  f.call('profile', 'init');
+  assert.equal(f.call('profile', 'check').valid, false);
+  assert.throws(() => f.call('profile', 'confirm', '--note', 'test'), /target role/);
+});
+test('profile save validates facts, clears confirmation and records explicit confirmation', t => {
+  const f = fixture(t); ready(f);
+  assert.equal(f.call('profile', 'check').confirmed, true);
+  const p = f.call('profile', 'show').profile;
+  p.search.roles = ['Fictional archivist'];
+  f.call('profile', 'save', '--input', f.input(p));
+  assert.equal(f.call('profile', 'check').confirmed, false);
+  assert.ok(f.call('history').some(e => e.kind === 'profile_saved'));
+  p.evidence.push(p.evidence[0]);
+  assert.equal(validateProfile(p).valid, false);
+});
+test('resume imports immutable copy, performs text checks and preserves human review on rerun', t => {
+  const f = fixture(t); f.call('profile', 'init');
+  writeFileSync(join(f.cwd, 'fictional notes.txt'), 'Experience\nFictional text');
+  const r = f.call('resume', 'fictional notes.txt');
+  assert.equal(r.fingerprint_matches, true); assert.equal(r.text_extraction, 'utf8_text');
+  assert.equal(r.ats_test, 'not_performed'); assert.ok(r.findings.some(x => x.includes('email')));
+  writeFileSync(r.review_path, 'Human review must survive');
+  f.call('resume', 'check');
+  assert.equal(readFileSync(r.review_path, 'utf8'), 'Human review must survive');
+  writeFileSync(join(f.cwd, 'fictional notes.txt'), 'Changed original');
+  assert.match(readFileSync(r.file, 'utf8'), /Fictional text/);
+});
+test('binary resume is not falsely described as parsed or ready', t => {
+  const f = fixture(t); f.call('profile', 'init');
+  writeFileSync(join(f.cwd, 'fictional.pdf'), 'Not a real PDF; test only');
+  const r = f.call('resume', 'fictional.pdf');
+  assert.equal(r.text_extraction, 'not_performed');
+  assert.equal(r.review_status, 'not_reviewed');
+  assert.throws(() => f.call('resume', 'reviewed', '--input', f.input({sha256:r.sha256,status:'ready',evidence:'test'})), /recorded text/);
+});
+test('search creates an honest local context and prevents overlapping CLI runs', t => {
+  const f = fixture(t); ready(f);
+  const context = f.call('search');
+  assert.equal(context.live_search_executed, false); assert.equal(context.budgets.target, 5);
+  const run = f.call('search', 'start', '--input', f.input({ query: 'fictional' }));
+  assert.throws(() => f.call('search', 'start', '--input', f.input({})), /previous running/);
+  f.call('search', 'finish', '--input', f.input({run_id:run.run_id,status:'complete',reason:'Synthetic no results'}));
+  assert.match(f.call('report').content, /Synthetic no results/);
+});
+test('application commands preserve approval, export and exactly-one dispatch guards', t => {
+  const f = fixture(t); ready(f);
+  const run = f.call('search', 'start', '--input', f.input({}));
+  f.call('search', 'record', '--input', f.input({run_id:run.run_id,slug:'fictional',title:'Fictional role',url:'https://example.invalid/job',route:'hosted',description:'Test only',read_at:'2026-01-01T00:00:00Z',match:{verdict:'suitable',reasons:['test'],requirements:[]}}));
+  f.call('apply', 'prepare', '--input', f.input({slug:'fictional',cover_letter:'Fictional cover\nLiteral $() and quotes "',claims:[{text:'Library work',evidence_id:'E1'}],answers:[],unresolved:[],hirify_profile_id:123}));
+  const exported = f.call('apply', 'export', 'fictional');
+  assert.equal(exported.sent, false);
+  assert.match(readFileSync(join(exported.directory,'cover-letter.txt'),'utf8'), /Literal/);
+  assert.throws(() => f.call('apply', 'begin', 'fictional'), /approval required/);
+  f.call('apply', 'approve', '--input', f.input({slug:'fictional',user_authorization:'Synthetic individual approval'}));
+  const packet = f.call('apply','begin','fictional');
+  let calls=0;
+  const send = () => runCommand(['apply','send','--input',packet.packet_path],{cwd:f.cwd,transport:()=>{calls++;return {status:0,stdout:'synthetic response',stderr:''};}});
+  send(); assert.throws(send); assert.equal(calls,1);
+  f.call('apply','finish','--input',f.input({attempt_id:packet.attempt_id,outcome:'submitted',application_id:'fictional-123',evidence:'Synthetic confirmed response'}));
+  f.call('track','status','fictional','--input',f.input({slug:'different-untrusted-slug',status:'interview',note:'Synthetic user report'}));
+  assert.equal(f.call('track','show','fictional').status,'interview');
+});
+test('schedule generates prompt with persistent workspace paths and never grants auto', t => {
+  const f=fixture(t); f.call('profile','init');
+  const plugin=join(f.cwd,'plugins/jobhunt-kit/skills/job-search'); mkdirSync(plugin,{recursive:true}); writeFileSync(join(plugin,'SKILL.md'),'Fictional path fixture');
+  const r=f.call('schedule','--input',f.input({frequency:'Every weekday at 9',timezone:'UTC',mode:'auto'}));
+  assert.equal(r.scheduled,false); assert.equal(r.auto_permission_granted,false);
+  assert.ok(readFileSync(r.path,'utf8').includes(join(f.cwd,'plugins/jobhunt-kit')));
+  assert.equal(f.call('policy').mode,'review_each');
+  assert.throws(()=>f.call('schedule','--input',f.input({frequency:'daily',timezone:'invalid-zone',mode:'search'})));
+});
+test('CLI uses requested workspace independently of package working directory', t => {
+  const f=fixture(t);
+  const r=spawnSync(process.execPath,[resolve('bin/jobhunt-kit.mjs'),'doctor','--workspace',f.cwd],{encoding:'utf8'});
+  assert.equal(r.status,0,r.stderr);
+  assert.equal(JSON.parse(r.stdout).workspace,f.cwd);
+  assert.equal(existsSync(f.dir),false);
+});
+test('PDF text is extracted locally from a generated fictional one-page document', t => {
+  const f=fixture(t);f.call('profile','init');
+  const stream='BT /F1 12 Tf 30 100 Td (Fictional Resume Experience) Tj ET';
+  const objects=['<< /Type /Catalog /Pages 2 0 R >>','<< /Type /Pages /Kids [3 0 R] /Count 1 >>',
+    '<< /Type /Page /Parent 2 0 R /MediaBox [0 0 300 200] /Resources << /Font << /F1 4 0 R >> >> /Contents 5 0 R >>',
+    '<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>',`<< /Length ${stream.length} >>\nstream\n${stream}\nendstream`];
+  let pdf='%PDF-1.4\n';const offsets=[0];
+  objects.forEach((o,i)=>{offsets.push(Buffer.byteLength(pdf));pdf+=`${i+1} 0 obj\n${o}\nendobj\n`;});
+  const xref=Buffer.byteLength(pdf);
+  pdf+=`xref\n0 6\n0000000000 65535 f \n${offsets.slice(1).map(n=>`${String(n).padStart(10,'0')} 00000 n \n`).join('')}trailer\n<< /Size 6 /Root 1 0 R >>\nstartxref\n${xref}\n%%EOF\n`;
+  writeFileSync(join(f.cwd,'synthetic.pdf'),pdf);
+  const result=f.call('resume','synthetic.pdf');
+  assert.equal(result.text_extraction,'pdf-parse',JSON.stringify(result.findings));
+  assert.match(readFileSync(join(dirname(result.checks_path),'text.txt'),'utf8'),/Fictional Resume Experience/);
+  assert.equal(result.visual_review,'not_performed');
+});
+test('DOCX text is extracted locally from a generated fictional document', async t => {
+  const f=fixture(t);f.call('profile','init');
+  const require=createRequire(import.meta.url);
+  const JSZip=createRequire(require.resolve('mammoth/package.json'))('jszip');
+  const zip=new JSZip();
+  zip.file('[Content_Types].xml','<?xml version="1.0"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/></Types>');
+  zip.file('_rels/.rels','<?xml version="1.0"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/></Relationships>');
+  zip.file('word/document.xml','<?xml version="1.0"?><w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"><w:body><w:p><w:r><w:t>Fictional DOCX Experience</w:t></w:r></w:p></w:body></w:document>');
+  writeFileSync(join(f.cwd,'synthetic.docx'),await zip.generateAsync({type:'nodebuffer'}));
+  const result=f.call('resume','synthetic.docx');
+  assert.equal(result.text_extraction,'mammoth',JSON.stringify(result.findings));
+  assert.match(readFileSync(join(dirname(result.checks_path),'text.txt'),'utf8'),/Fictional DOCX Experience/);
+  assert.equal(result.factual_review,'not_performed');
+});

package/tests/installer.test.mjs

@@ -0,0 +1,52 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync, symlinkSync, unlinkSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { join, resolve, sep } from 'node:path';
+import { install } from '../bin/jobhunt-kit.mjs';
+
+function target(t) {
+  const path = mkdtempSync(join(tmpdir(), 'job-search-install-'));
+  t.after(() => {
+    assert.ok(resolve(path).startsWith(resolve(tmpdir()) + sep) && path.includes('job-search-install-'));
+    rmSync(path, { recursive: true, force: true });
+  });
+  return join(path, 'new workspace');
+}
+test('installs a complete template, including npm-omitted files, without personal state', t => {
+  const path = target(t);
+  const result = install(path, { installDependencies: false });
+  assert.ok(result.copied > 30);
+  for (const name of ['.gitignore', 'package-lock.json', 'plugins/jobhunt-kit/package-lock.json',
+    '.agents/plugins/marketplace.json', '.claude-plugin/marketplace.json', 'plugins/jobhunt-kit/skills/job-profile/SKILL.md']) assert.ok(existsSync(join(path, name)), name);
+  assert.equal(existsSync(join(path, 'local')), false);
+  assert.equal(existsSync(join(path, '.git')), false);
+});
+test('repeat installation preserves candidate files and copies nothing', t => {
+  const path = target(t);
+  install(path, { installDependencies: false });
+  mkdirSync(join(path, 'local'));
+  writeFileSync(join(path, 'local', 'fictional.md'), 'Fictional private test data');
+  const result = install(path, { installDependencies: false });
+  assert.equal(result.copied, 0);
+  assert.equal(readFileSync(join(path, 'local', 'fictional.md'), 'utf8'), 'Fictional private test data');
+});
+test('conflicting file stops before copying any files', t => {
+  const path = target(t);
+  mkdirSync(path); writeFileSync(join(path, 'README.md'), 'Existing user document');
+  assert.throws(() => install(path, { installDependencies: false }), /Existing file differs/);
+  assert.equal(existsSync(join(path, 'plugins')), false);
+  assert.equal(readFileSync(join(path, 'README.md'), 'utf8'), 'Existing user document');
+});
+test('CLI executes through the package link used by npm exec', t => {
+  const path = target(t);
+  symlinkSync(resolve('.'), path, process.platform === 'win32' ? 'junction' : 'dir');
+  try {
+    const result = spawnSync(process.execPath, [join(path, 'bin/jobhunt-kit.mjs'), 'doctor', '--workspace', join(path, '..', 'empty')], { encoding: 'utf8' });
+    assert.equal(result.status, 0, result.stderr);
+    assert.equal(JSON.parse(result.stdout).initialized, false);
+  } finally {
+    unlinkSync(path);
+  }
+});