heyspex 0.1.0 → 0.2.0

package/plugins/heyspex/hooks/cursor-hooks.json

@@ -0,0 +1,227 @@
+{
+  "_comment": "GENERATED by scripts/install-cursor-hooks.mjs from scripts/cursor-hooks/manifest.mjs — do not edit by hand; run `npm run hooks:install-cursor`. Commands resolve through $CURSOR_PROJECT_DIR because the shim and hook bodies live in the host vault checkout, not the plugin cache. WARNING: enabling this plugin in a repo whose .cursor/hooks.json still registers the same hooks runs every hook twice — validate in a fresh clone, or run `node scripts/install-cursor-hooks.mjs --uninstall` there first.",
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" wip-checkpoint",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" inject-dev-server-awareness",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" inject-coo-seat",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" coo-guard-check",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" check-auto-memory-budget",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" check-claude-md-budget",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" check-mcp-freshness-hook",
+        "timeout": 5
+      }
+    ],
+    "preCompact": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" wip-checkpoint --hs-claude-event=SessionStart",
+        "timeout": 5
+      }
+    ],
+    "beforeSubmitPrompt": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" preflight-reminder",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" intent-classifier-trigger",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" inject-communication-style",
+        "timeout": 5
+      }
+    ],
+    "preToolUse": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" emit-claim-status --event=PreToolUse",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" coo-denylist-gate",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" log-session-activity --event=PreToolUse",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" env-vault-guard",
+        "timeout": 5,
+        "matcher": "Write|Delete"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" settings-write-gate",
+        "timeout": 5,
+        "matcher": "Write"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" enforce-vault-naming",
+        "timeout": 5,
+        "matcher": "Write"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" guard-auto-memory-writes",
+        "timeout": 5,
+        "matcher": "Write"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" preflight-reminder",
+        "timeout": 5,
+        "matcher": "Write"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" claim-before-code-gate",
+        "timeout": 5,
+        "matcher": "Write"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" coo-guard-check --hs-tool=\"heyspex_claim_spec$\"",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" capture-workflow-gate --hs-tool=\"heyspex_file_spec$\"",
+        "timeout": 8,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" settings-write-gate --hs-tool=\"heyspex_settings_set$\"",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" dev-server-task-reminder --hs-tool=\"[Nn]eon__(prepare_database_migration|complete_database_migration|reset_from_parent|delete_branch)$\"",
+        "timeout": 10,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" deep-research-cost-gate --hs-tool=\"^(Workflow|Skill)$\"",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" research-protocol-gate --hs-tool=\"^(WebSearch|WebFetch|web_search|web_fetch)$|heyspex_save_research$\"",
+        "timeout": 5,
+        "matcher": ".*"
+      }
+    ],
+    "beforeShellExecution": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" env-vault-guard",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" settings-write-gate",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" enforce-vault-naming",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" guard-auto-memory-writes",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" preflight-reminder",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" dev-server-task-reminder",
+        "timeout": 10
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" git-stash-gate",
+        "timeout": 10
+      }
+    ],
+    "subagentStart": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" agent-spawn-delegation-gate",
+        "timeout": 5
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" emit-claim-status --event=PostToolUse",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" log-session-activity --event=PostToolUse",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" close-terminal-on-ship",
+        "timeout": 5,
+        "matcher": ".*"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" notify-status-flip",
+        "timeout": 5,
+        "matcher": "Write"
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" scripts/stamp-provenance-on-edit.mjs",
+        "timeout": 5,
+        "matcher": "Write"
+      }
+    ],
+    "afterFileEdit": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" close-terminal-on-ship",
+        "timeout": 5,
+        "matcher": ".*"
+      }
+    ],
+    "stop": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" emit-claim-status --event=Stop",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" naughty-list-gate",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" enforce-session-sequence",
+        "timeout": 5
+      }
+    ],
+    "sessionEnd": [
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" session-end",
+        "timeout": 5
+      },
+      {
+        "command": "node \"$CURSOR_PROJECT_DIR/scripts/cursor-hooks/_run.mjs\" close-terminal-on-ship",
+        "timeout": 5
+      }
+    ]
+  }
+}

package/plugins/heyspex/hooks/hooks.json

@@ -0,0 +1,361 @@
+{
+  "_comment": "GENERATED from scripts/lib/customer-kit.mjs (customer-scoped rows only) — do not edit by hand; run `node scripts/lib/customer-kit.mjs --write-plugin-hooks`. Every command goes through bin/run-hook.mjs, which finds the hook runtime (HEYSPEX_PLATFORM_ROOT / HEYSPEX_MCP_ENTRY when set in the machine's own env, then the plugin's own location, node_modules/heyspex, $CLAUDE_PROJECT_DIR) — never $CLAUDE_PROJECT_DIR/scripts, which only exists in heyspex-app. WARNING: a repo whose .claude/settings.json already carries the hs install kit hooks runs every hook twice if this plugin is also enabled — use one or the other.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" wip-checkpoint",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" inject-doctrine",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" check-auto-memory-budget",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" check-claude-md-budget",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" git-reflog-audit",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" wip-checkpoint",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" preflight-reminder",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" intent-classifier-trigger",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" inject-communication-style",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" inject-vault-context",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash|PowerShell",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" git-identity-guard",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|NotebookEdit|Bash|PowerShell|mcp__heyspex__heyspex_settings_set|mcp__plugin_heyspex_heyspex__heyspex_settings_set",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" settings-write-gate",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" emit-claim-status --event=PreToolUse",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|NotebookEdit|Bash|PowerShell",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" enforce-vault-naming",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|NotebookEdit|Bash|PowerShell",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" guard-auto-memory-writes",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|MultiEdit|Write|Bash|PowerShell",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" preflight-reminder",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "ExitPlanMode",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" plan-review-gate",
+            "timeout": 8
+          }
+        ]
+      },
+      {
+        "matcher": "ExitPlanMode",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" plan-exit-ingest-gate",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|MultiEdit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" claim-before-code-gate",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__heyspex__heyspex_file_spec|mcp__plugin_heyspex_heyspex__heyspex_file_spec",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" capture-workflow-gate",
+            "timeout": 8
+          }
+        ]
+      },
+      {
+        "matcher": "Bash|PowerShell",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" git-stash-gate",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "Skill|Workflow",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" research-method-guard",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Workflow|Skill",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" deep-research-cost-gate",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "WebSearch|WebFetch|mcp__heyspex__heyspex_save_research|mcp__plugin_heyspex_heyspex__heyspex_save_research",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" research-protocol-gate",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" emit-claim-status --event=Stop",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" naughty-list-gate",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" id-display-format-gate",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" epic-milestone-phrasing-gate",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" git-reflog-audit",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" enforce-session-sequence",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" emit-claim-status --event=PostToolUse",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" notify-status-flip",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" close-terminal-on-ship",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" scripts/stamp-provenance-on-edit.mjs",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" session-end",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/bin/run-hook.mjs\" close-terminal-on-ship",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/heyspex/mcp.json

@@ -0,0 +1,13 @@
+{
+  "_comment": "Cursor plugin MCP declaration (HS-2HII). Boots through the plugin's own bin/launch-mcp.mjs, the same launcher .mcp.json uses for Claude Code. Cursor expands ${CURSOR_PLUGIN_ROOT} to the plugin's install path in command/args/env/cwd (cursor.com/docs/reference/plugins), so this works from a plain `npm install heyspex`: the launcher resolves node_modules/heyspex first, then CURSOR_PROJECT_DIR and the other source-checkout fallbacks. Never point this at vendor/heyspex-mcp/cli.mjs directly: that path exists only inside the platform checkout.",
+  "mcpServers": {
+    "heyspex": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${CURSOR_PLUGIN_ROOT}/bin/launch-mcp.mjs"],
+      "env": {
+        "HEYSPEX_VAULT_ROOT": "${workspaceFolder}"
+      }
+    }
+  }
+}

package/scripts/check-mcp-freshness.mjs

@@ -181,15 +181,13 @@ export function writeBuildRecord({ vaultRoot, vendorDir, buildFile, buildsDir, p
     pid: recordPid,
     vendorDir: path.relative(root, vDir).split(path.sep).join('/'),
   };
-  // Legacy machine-wide record — kept for back-compat readers.
-  const dir = path.dirname(target);
-  fs.mkdirSync(dir, { recursive: true });
-  const tmp = `${target}.${process.pid}.tmp`;
-  fs.writeFileSync(tmp, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
-  fs.renameSync(tmp, target);
 
-  // Per-process record + opportunistic dead-pid pruning. Best-effort: a
-  // failure here must never take server startup down with it.
+  // Per-process record + opportunistic dead-pid pruning, computed BEFORE the
+  // legacy write below so the on-disk legacy file and the returned `record`
+  // never disagree on shape (round-trip identity relied on by
+  // vendor/heyspex-mcp/mcp-build-fingerprint.test.mjs and any future disk
+  // reader). Best-effort: a failure here must never take server startup down
+  // with it, and must never skip the legacy write that follows.
   try {
     fs.mkdirSync(perDir, { recursive: true });
     pruneDeadRecords(perDir, recordPid);
@@ -207,8 +205,18 @@ export function writeBuildRecord({ vaultRoot, vendorDir, buildFile, buildsDir, p
     fs.renameSync(perTmp, perTarget);
     record.perProcessRecord = perRecord;
   } catch {
-    // legacy record already landed — per-process bookkeeping is best-effort
+    // per-process bookkeeping is best-effort — the legacy record below still lands
   }
+
+  // Legacy machine-wide record — kept for back-compat readers. Written last
+  // (after `record` has its final shape, `perProcessRecord` included when
+  // available) so this file and the return value are always the same object.
+  const dir = path.dirname(target);
+  fs.mkdirSync(dir, { recursive: true });
+  const tmp = `${target}.${process.pid}.tmp`;
+  fs.writeFileSync(tmp, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
+  fs.renameSync(tmp, target);
+
   return record;
 }