jobhunt-kit 0.4.0 → 0.5.0

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
       "name": "jobhunt-kit",
       "source": "./plugins/jobhunt-kit",
       "description": "Candidate intake, resume review, Hirify search and local tracking",
-      "version": "0.4.0"
+      "version": "0.5.0"
     }
   ]
 }

package/README.md

@@ -55,6 +55,11 @@ npx jobhunt-kit profile check
 npx jobhunt-kit search
 npx jobhunt-kit track
 npx jobhunt-kit report
+npx jobhunt-kit recover inspect
+npx jobhunt-kit recover packet <attempt_id>
+npx jobhunt-kit backup ../jobhunt-backup
+npx jobhunt-kit backup-verify ../jobhunt-backup
+npx jobhunt-kit privacy map
 ```
 
 `resume` извлекает текст PDF, DOCX, TXT или Markdown и готовит материалы для проверки
@@ -77,7 +82,17 @@ npx jobhunt-kit report
 | `reports/latest.md` | Сводный отчёт |
 
 Папка `local/` исключена из Git. Храните личные файлы в ней; для резервной копии
-сохраняйте всю папку при остановленных процессах. Данные на диске не зашифрованы.
+используйте `backup` и затем `backup-verify`. Restore принимает только проверяемую
+копию, требует точное подтверждение и предварительно делает сырой quarantine-снимок,
+который сохраняется даже тогда, когда текущие JSON или SQLite уже повреждены.
+Restore и очистка history всегда отзывают auto-разрешение и подтверждение профиля.
+Данные на диске не зашифрованы.
+
+`doctor` проверяет JSON Schema профиля/policy, SQLite integrity и foreign keys,
+незавершённые поиски/отправки и журнал атомарных файловых операций. `privacy map`
+показывает размещение PII; `privacy export`, `redact` и `purge` дают контролируемый
+экспорт и удаление. Redact/purge требуют точных подтверждений, а purge не запускается
+без отдельной резервной копии.
 
 ## Выбор агентов
 
@@ -142,12 +157,14 @@ OpenCode учитывает `OPENCODE_CONFIG_DIR` и `XDG_CONFIG_HOME`; Hermes
 npm ci --ignore-scripts
 npm test
 npm run check
+npm run pack:smoke
 ```
 
 Тесты работают с вымышленными данными и не отправляют реальные отклики.
 
 Руководства: [формат данных](plugins/jobhunt-kit/references/storage.md),
 [проверка резюме](plugins/jobhunt-kit/references/resume-guidance.md),
-[сопроводительные письма](plugins/jobhunt-kit/references/cover-guidance.md).
+[сопроводительные письма](plugins/jobhunt-kit/references/cover-guidance.md),
+[карта приватных данных](plugins/jobhunt-kit/references/privacy.md).
 
 Автор этого шаблона никак не аффилирован с Hirify.

package/bin/jobhunt-kit.mjs

@@ -1,6 +1,6 @@
 #!/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 { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { spawnSync } from 'node:child_process';
 import { homedir } from 'node:os';
@@ -11,6 +11,10 @@ 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'];
+export function pathInside(parent, child, pathApi = { relative, isAbsolute, sep }) {
+  const delta = pathApi.relative(parent, child);
+  return delta === '' || (!pathApi.isAbsolute(delta) && delta !== '..' && !delta.startsWith(`..${pathApi.sep}`));
+}
 function collect(path) {
   const stat = lstatSync(path);
   if (stat.isSymbolicLink()) throw new Error(`Symlink in template: ${path}`);
@@ -33,7 +37,7 @@ export function install(destination, { source = SOURCE, installDependencies = tr
   if (scope === 'global' && !agents.length) throw new Error('Global installation requires at least one agent');
   const target = resolve(scope === 'global' ? home : destination);
   source = resolve(source);
-  if (target === source || !relative(source, target).startsWith('..')) throw new Error('Choose a destination outside the installer package');
+  if (pathInside(source, target)) throw new Error('Choose a destination outside the installer package');
   const files = new Map();
   if (scope === 'project') {
     for (const root of roots) for (const path of collect(join(source, root))) files.set(relative(source, path), path);
@@ -94,7 +98,7 @@ export async function main(args) {
     return;
   }
   if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-    console.log('Usage: jobhunt-kit <command> [arguments] [--workspace dir | --data dir]\n\ninstall [directory]              Choose agents and install (default: ./my-jobhunt)\n  --agents codex,cursor,...      Select agents (or all); --providers is an alias\n  agents                        List supported agents\n  --scope project|global        Workspace skills or user-wide skills\n  --yes, -y                     Use detected agents and project scope\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.');
+    console.log('Usage: jobhunt-kit <command> [arguments] [--workspace dir | --data dir]\n\ninstall [directory]              Choose agents and install (default: ./my-jobhunt)\n  --agents codex,cursor,...      Select agents (or all); --providers is an alias\n  agents                        List supported agents\n  --scope project|global        Workspace skills or user-wide skills\n  --yes, -y                     Use detected agents and project scope\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\nbackup/backup-verify <directory> Create or verify a local backup\nrestore --input file            Restore after exact typed confirmation\nrecover inspect|apply|packet    Inspect, resolve, or recreate an attempt packet\nprivacy map|export|redact|purge Inspect, export or remove local PII\ndoctor                          Check schemas, database and recovery state 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])) {

package/installer-assets/gitignore.txt

@@ -20,3 +20,4 @@ local/
 __pycache__/
 .tmp/
 *.tgz
+plan/

package/installer-assets/runtime-lock.json

@@ -1,13 +1,14 @@
 {
   "name": "jobhunt-kit-plugin",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "jobhunt-kit-plugin",
-      "version": "0.4.0",
+      "version": "0.5.0",
       "dependencies": {
+        "ajv": "8.20.0",
         "hirify-cli": "0.4.5",
         "mammoth": "1.12.2",
         "pdf-parse": "2.4.5"
@@ -224,6 +225,22 @@
         "node": ">=10.0.0"
       }
     },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
     "node_modules/argparse": {
       "version": "1.0.10",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
@@ -280,6 +297,28 @@
         "underscore": "^1.13.1"
       }
     },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.7",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.7.tgz",
+      "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/hirify-cli": {
       "version": "0.4.5",
       "resolved": "https://registry.npmjs.org/hirify-cli/-/hirify-cli-0.4.5.tgz",
@@ -310,6 +349,12 @@
       "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
       "license": "MIT"
     },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
     "node_modules/jszip": {
       "version": "3.10.1",
       "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz",
@@ -440,6 +485,15 @@
         "util-deprecate": "~1.0.1"
       }
     },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/safe-buffer": {
       "version": "5.1.2",
       "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",

package/installer-assets/workspace-lock.json

@@ -1,13 +1,14 @@
 {
   "name": "jobhunt-kit",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "jobhunt-kit",
-      "version": "0.4.0",
+      "version": "0.5.0",
       "dependencies": {
+        "ajv": "8.20.0",
         "hirify-cli": "0.4.5",
         "mammoth": "1.12.2",
         "pdf-parse": "2.4.5"
@@ -227,6 +228,22 @@
         "node": ">=10.0.0"
       }
     },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
     "node_modules/argparse": {
       "version": "1.0.10",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
@@ -283,6 +300,28 @@
         "underscore": "^1.13.1"
       }
     },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.7",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.7.tgz",
+      "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/hirify-cli": {
       "version": "0.4.5",
       "resolved": "https://registry.npmjs.org/hirify-cli/-/hirify-cli-0.4.5.tgz",
@@ -313,6 +352,12 @@
       "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
       "license": "MIT"
     },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
     "node_modules/jszip": {
       "version": "3.10.1",
       "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz",
@@ -443,6 +488,15 @@
         "util-deprecate": "~1.0.1"
       }
     },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/safe-buffer": {
       "version": "5.1.2",
       "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jobhunt-kit",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "bin": {
     "jobhunt-kit": "bin/jobhunt-kit.mjs"
   },
@@ -19,12 +19,14 @@
     "hirify": "hirify",
     "test": "node --test tests/*.test.mjs",
     "check": "node scripts/check-package.mjs",
+    "pack:smoke": "node scripts/pack-smoke.mjs",
     "prepublishOnly": "npm test && npm run check"
   },
   "engines": {
     "node": ">=24.0.0"
   },
   "dependencies": {
+    "ajv": "8.20.0",
     "hirify-cli": "0.4.5",
     "mammoth": "1.12.2",
     "pdf-parse": "2.4.5"

package/plugins/jobhunt-kit/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jobhunt-kit",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Reusable candidate intake, resume review, Hirify search and local application tracking",
   "author": {
     "name": "Jobhunt Kit contributors"

package/plugins/jobhunt-kit/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jobhunt-kit",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Reusable candidate intake, resume review, Hirify search and local application tracking",
   "author": {
     "name": "Jobhunt Kit contributors"

package/plugins/jobhunt-kit/package-lock.json

@@ -1,13 +1,14 @@
 {
   "name": "jobhunt-kit-plugin",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "jobhunt-kit-plugin",
-      "version": "0.4.0",
+      "version": "0.5.0",
       "dependencies": {
+        "ajv": "8.20.0",
         "hirify-cli": "0.4.5",
         "mammoth": "1.12.2",
         "pdf-parse": "2.4.5"
@@ -224,6 +225,22 @@
         "node": ">=10.0.0"
       }
     },
+    "node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
     "node_modules/argparse": {
       "version": "1.0.10",
       "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
@@ -280,6 +297,28 @@
         "underscore": "^1.13.1"
       }
     },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.7",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.7.tgz",
+      "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/hirify-cli": {
       "version": "0.4.5",
       "resolved": "https://registry.npmjs.org/hirify-cli/-/hirify-cli-0.4.5.tgz",
@@ -310,6 +349,12 @@
       "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
       "license": "MIT"
     },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
     "node_modules/jszip": {
       "version": "3.10.1",
       "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz",
@@ -440,6 +485,15 @@
         "util-deprecate": "~1.0.1"
       }
     },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/safe-buffer": {
       "version": "5.1.2",
       "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",

package/plugins/jobhunt-kit/package.json

@@ -1,12 +1,13 @@
 {
   "name": "jobhunt-kit-plugin",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "private": true,
   "type": "module",
   "engines": {
     "node": ">=24.0.0"
   },
   "dependencies": {
+    "ajv": "8.20.0",
     "hirify-cli": "0.4.5",
     "mammoth": "1.12.2",
     "pdf-parse": "2.4.5"

package/plugins/jobhunt-kit/references/cli.md

@@ -25,7 +25,7 @@
 | job-resume | Копия по SHA-256, извлечение PDF/DOCX/TXT/MD, простые проверки текста, сохранение отчёта, запись завершённой проверки | Визуальная оценка, истинность фактов, соответствие роли и содержательные правки |
 | job-search | Сбор профиля, бюджетов и известных вакансий; журнал запусков/результатов, запрет второго активного запуска через CLI | Актуальные фильтры Hirify, preview, живой поиск, оценка требований и ранжирование |
 | job-apply | Снимок черновика, экспорт текста/ответов, согласование, резервирование и однократный вызов CLI, запись исхода | Написание письма из фактов, проверка живого профиля/квоты, получение разрешения, разбор ответа сервиса |
-| job-track | Списки/история/статусы/Markdown; заполнение prompt для расписания | Интерпретация сообщения кандидата, создание задачи в планировщике после запроса |
+| job-track | Списки/история/статусы/Markdown, integrity/recovery, backup/restore, privacy-команды; заполнение prompt для расписания | Интерпретация сообщения кандидата, создание задачи в планировщике после запроса |
 
 Технические функции: `profile.mjs`, `resume.mjs`, `extract-resume.mjs`, `commands.mjs`;
 история и защита отправки переиспользуют `tracker.mjs` и `send-packet.mjs`.
@@ -129,3 +129,29 @@ schedule.json: `{"frequency":"По будням в 09:00","timezone":"Europe/Ber
 materials/scheduled-search.md, а не включённая задача; auto-разрешение не выдаётся.
 Нужен --workspace с установленным шаблоном, чтобы prompt не ссылался на временный
 кеш npx. Планировщик выбирает агент по явному запросу пользователя.
+
+## Целостность, резервирование и приватность
+
+```text
+npx jobhunt-kit doctor
+npx jobhunt-kit recover inspect
+npx jobhunt-kit recover apply --input recovery.json
+npx jobhunt-kit recover packet <attempt_id>
+npx jobhunt-kit backup ../jobhunt-backup
+npx jobhunt-kit backup-verify ../jobhunt-backup
+npx jobhunt-kit restore --input restore.json
+npx jobhunt-kit privacy map
+npx jobhunt-kit privacy export ../jobhunt-private-export
+npx jobhunt-kit privacy redact --input redact.json
+npx jobhunt-kit privacy purge --input purge.json
+```
+
+`doctor` проверяет JSON Schema, SQLite integrity/foreign keys, активный run,
+неразрешённые attempts и незавершённые файловые операции. Recovery ничего не угадывает:
+для run нужны id/status/reason, для attempt — slug/outcome/evidence.
+
+Restore требует `{"source":"...","confirmation":"RESTORE VERIFIED JOBHUNT BACKUP"}`
+и перед заменой создаёт автоматический сырой pre-restore quarantine-снимок. Redact требует
+`REDACT LOCAL JOBHUNT PII` и массив dotted profile fields. Purge требует фразу
+`PURGE LOCAL JOBHUNT DATA`, scopes и отдельный backup_directory; удаление без
+проверяемой резервной копии не выполняется.

package/plugins/jobhunt-kit/references/privacy.md

@@ -0,0 +1,24 @@
+# Локальные данные и приватность
+
+Jobhunt Kit не шифрует данные. Рабочая папка `D` должна быть доступна только
+пользователю и не должна синхронизироваться или публиковаться без его решения.
+
+| Путь | Возможные персональные данные | Назначение |
+|---|---|---|
+| `profile.json` | Имя, контакты, опыт, ответы, разрешения на работу | Авторитетный профиль кандидата |
+| `policy.json` | Текст auto-разрешения, срок и лимит | Авторитетная политика отправки |
+| `history.sqlite` | Вакансии, письма, ответы, approvals, application snapshots; legacy v1 мог хранить полные снимки профиля | Авторитетная история |
+| `resumes/` | Неизменяемые копии резюме | Проверка и отправочный контекст |
+| `materials/` | Извлечённый текст, письма, ответы, attempt packets | Рабочие материалы агента |
+| `reports/` | Названия вакансий, ссылки и статусы | Производное представление истории |
+
+`privacy map` возвращает абсолютные пути этой карты. `privacy export` создаёт ту же
+проверяемую копию, что backup. `privacy redact` меняет перечисленные dotted-поля
+профиля, сбрасывает подтверждение и удаляет полные profile snapshots/user authorization
+из legacy events; для полного удаления истории использовать purge scope `history`.
+
+`privacy purge` требует точную фразу подтверждения и отдельный `backup_directory`.
+До удаления создаётся и проверяется полная резервная копия. Scopes: `profile`,
+`history`, `resumes`, `materials`, `reports`. Очистка `history` всегда очищает и
+производные `reports`, отзывает auto-разрешение и подтверждение профиля. Purge не удаляет внешний файл, из которого ранее
+импортировали резюме, и не отзывает уже отправленные заявления на стороне Hirify.

package/plugins/jobhunt-kit/references/storage.md

@@ -30,7 +30,8 @@ P/D — абсолютные пути из workflow.md. JSON-ответы ком
 Дата confirmed_at — ISO 8601. Profile-команда отдаёт hash текущего JSON для разрешения
 auto. Хеш зависит от сериализации объекта: изменение/перестановка ключей может
 потребовать нового согласования (консервативное поведение).
-resume.path — путь относительно D или абсолютный локальный; sha256 — байтов файла.
+resume.path — только относительный путь внутри D, штатно `resumes/<sha>.<ext>`;
+внешний файл сначала импортируется командой resume. sha256 — хеш байтов файла.
 Пример вычисления в PowerShell: `(Get-FileHash <file> -Algorithm SHA256).Hash.ToLower()`.
 readiness и confirmed — утверждения агента по фактической проверке, не автоматическая
 проверка истинности биографии. Не отмечать их только ради прохождения команды.
@@ -109,12 +110,17 @@ External или недостающие ответы → needs_user. После
 можно dismissed. После отправки: interview / rejected / withdrawn / offer;
 из offer: accepted / declined / withdrawn. Status — локальная запись, не действие сервиса.
 
-Схема SQLite v1: runs, jobs, aliases, observations, attempts, dispatches, events.
+Схема SQLite v2: runs, jobs, aliases, observations, attempts, dispatches, events,
+file_revisions и pending_file_writes. Миграция v1→v2 сохраняет данные, закрывает
+старые дублирующиеся running runs, записывается в schema_migrations и добавляет
+immutable application snapshots.
 В attempts UNIQUE(job_id), в dispatches PRIMARY KEY(attempt_id): повтор не проходит
 после перезапуска процесса. Сбой после намерения требует ручного разбора.
 Нет универсальной транзакции между SQLite и Hirify: невозможно обещать exactly-once
 доставку через сеть. Здесь предотвращаются автоматические повторные отправки.
 
-Историю читать через команды. Для резервирования закрыть работающие процессы и
-сохранить весь D. Обновление схемы пока не требуется: это первая версия; будущий
-апгрейд обязан иметь явную миграцию и резервную копию.
+Историю читать через команды. Для резервирования использовать backup и backup-verify.
+Restore сначала создаёт сырой автоматический pre-restore quarantine-снимок, не требующий
+валидности текущих данных. Перед активацией восстановленной истории restore отзывает
+auto-разрешение и подтверждение профиля. Doctor проверяет JSON Schema,
+SQLite, foreign keys, незавершённые runs/attempts и журнал атомарных файловых операций.

package/plugins/jobhunt-kit/schemas/draft.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "jobhunt-kit/draft",
+  "type": "object",
+  "required": ["slug", "cover_letter", "hirify_profile_id", "claims", "answers", "unresolved"],
+  "properties": {
+    "slug": { "type": "string", "minLength": 1 }, "cover_letter": { "type": "string", "minLength": 1 },
+    "hirify_profile_id": { "type": ["integer", "null"], "minimum": 1 },
+    "claims": { "type": "array", "items": { "type": "object", "required": ["text", "evidence_id"], "properties": { "text": { "type": "string", "minLength": 1 }, "evidence_id": { "type": "string", "minLength": 1 } }, "additionalProperties": false } },
+    "answers": { "type": "array" }, "unresolved": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+  },
+  "additionalProperties": true
+}

package/plugins/jobhunt-kit/schemas/finish.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "jobhunt-kit/finish",
+  "type": "object",
+  "required": ["attempt_id", "outcome", "evidence"],
+  "properties": {
+    "attempt_id": { "type": "string", "minLength": 1 }, "outcome": { "enum": ["submitted", "failed", "unknown"] },
+    "evidence": { "type": "string", "minLength": 1 }, "application_id": { "type": "string", "minLength": 1 }
+  },
+  "additionalProperties": true
+}

package/plugins/jobhunt-kit/schemas/policy.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "jobhunt-kit/policy",
+  "type": "object",
+  "required": ["schema_version", "mode", "search", "auto"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "mode": { "enum": ["review_each", "auto"] },
+    "search": {
+      "type": "object",
+      "required": ["target", "max_cards", "max_reads", "max_reveals", "max_minutes"],
+      "properties": {
+        "target": { "type": "integer", "minimum": 1 }, "max_cards": { "type": "integer", "minimum": 1 },
+        "max_reads": { "type": "integer", "minimum": 1 }, "max_reveals": { "type": "integer", "minimum": 0 },
+        "max_minutes": { "type": "integer", "minimum": 1 }
+      },
+      "additionalProperties": false
+    },
+    "auto": {
+      "anyOf": [
+        { "type": "null" },
+        {
+          "type": "object", "required": ["user_authorization", "profile_hash", "expires_at", "max_attempts_per_utc_day"],
+          "properties": {
+            "user_authorization": { "type": "string", "minLength": 1 },
+            "profile_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "expires_at": { "type": "string", "format": "date-time" },
+            "max_attempts_per_utc_day": { "type": "integer", "minimum": 1 }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}