viepilot 1.14.0 → 2.4.0

package/docs/user/features/adapters.md

@@ -0,0 +1,74 @@
+# Supported Adapters
+
+ViePilot supports multiple AI coding platforms via its adapter system (FEAT-013). Each adapter defines where skills and workflows are installed on your machine.
+
+## Supported Platforms
+
+| Adapter ID | Platform | Skills dir | ViePilot dir | Hooks | Skill syntax |
+|------------|----------|------------|--------------|-------|--------------|
+| `claude-code` | Claude Code *(default)* | `~/.claude/skills/` | `~/.claude/viepilot/` | ✅ Stop, PreToolUse, … | `/vp-status` |
+| `cursor-agent` / `cursor-ide` | Cursor | `~/.cursor/skills/` | `~/.cursor/viepilot/` | — | `/vp-status` |
+| `antigravity` | Google Antigravity | `~/.antigravity/skills/` | `~/.antigravity/viepilot/` | — | `/vp-status` |
+| `codex` | OpenAI Codex CLI | `~/.codex/skills/` | `~/.codex/viepilot/` | — | `$vp-status` |
+
+> **Note — Codex invocation syntax:** OpenAI Codex CLI uses `$skill-name` to invoke skills (e.g. `$vp-status`, `$vp-brainstorm`). The `/command` prefix is reserved for Codex built-in controls (`/plan`, `/clear`, `/diff`, etc.). SKILL.md file format is fully compatible — no changes needed to skill content.
+
+## Install for a specific platform
+
+```bash
+# Claude Code (default)
+viepilot install
+
+# Cursor Agent
+viepilot install --target cursor-agent
+
+# Google Antigravity
+viepilot install --target antigravity
+
+# OpenAI Codex CLI
+viepilot install --target codex
+
+# Multiple targets at once
+viepilot install --target claude-code,antigravity
+```
+
+## How path resolution works (ENH-035)
+
+Skill source files use the neutral placeholder `{envToolDir}` in `execution_context` blocks:
+
+```
+@$HOME/{envToolDir}/workflows/autonomous.md
+```
+
+At install time, `{envToolDir}` is replaced with each adapter's `executionContextBase`:
+- `claude-code` → `.claude/viepilot`
+- `cursor` → `.cursor/viepilot`
+- `antigravity` → `.antigravity/viepilot`
+- `codex` → `.codex/viepilot`
+
+## Adding a new adapter
+
+Create `lib/adapters/{name}.cjs`:
+
+```js
+module.exports = {
+  id: 'myplatform',
+  name: 'My Platform',
+  skillsDir:   (home) => path.join(home, '.myplatform', 'skills'),
+  viepilotDir: (home) => path.join(home, '.myplatform', 'viepilot'),
+  executionContextBase: '.myplatform/viepilot',  // {envToolDir} resolves to this
+  postInstallHint: 'Open project and run /vp-status',  // or $vp-status if platform uses $ prefix
+  hooks: { configFile: null, schema: 'myplatform', supportedEvents: [] },
+  installSubdirs: ['workflows', 'templates/project', 'templates/phase',
+                   'templates/architect', 'bin', 'lib', 'ui-components'],
+  isAvailable: (home) => fs.existsSync(path.join(home, '.myplatform'))
+};
+```
+
+Register in `lib/adapters/index.cjs`:
+
+```js
+'myplatform': require('./myplatform.cjs'),
+```
+
+No `pathRewrite` field needed — `{envToolDir}` substitution is handled automatically.

package/docs/user/features/hooks.md

@@ -0,0 +1,93 @@
+# ViePilot Hooks
+
+ViePilot integrates with Claude Code's hook system to automate actions after each AI response. Hooks are shell commands that fire at specific Claude Code events — no manual typing required.
+
+## Brainstorm Staleness Hook
+
+**Event**: `Stop` (fires after each Claude response)  
+**Script**: `~/.viepilot/hooks/brainstorm-staleness.cjs`  
+**Config**: `~/.claude/settings.json`
+
+### What it does
+
+After each exchange in a `vp-brainstorm` session, the hook automatically:
+
+1. Finds the most recently modified brainstorm session file (`notes.md` or `session-*.md`)
+2. Scans session content for keywords that match architect HTML pages
+3. Marks relevant architect items with `data-arch-stale="true"` — rendered as an amber "⚠ gap" badge in the browser
+4. Exits cleanly — if it fails or finds nothing, your session continues normally
+
+This is **flag-only** (Option A) — the hook does not rewrite architect HTML content, only marks items for review. Use `/sync-arch` to perform a full content sync.
+
+### Install
+
+Run once per machine:
+
+```bash
+node bin/vp-tools.cjs hooks install
+# or if installed globally:
+vp-tools hooks install
+```
+
+This writes the hook entry into `~/.claude/settings.json`. Running it again is safe (idempotent).
+
+To verify the install:
+
+```bash
+cat ~/.claude/settings.json | grep brainstorm-staleness
+```
+
+### Preview (scaffold)
+
+To see what will be written without installing:
+
+```bash
+node bin/vp-tools.cjs hooks scaffold
+```
+
+### Cursor users
+
+Cursor does not support `settings.json` hook events. Use `/sync-arch` manually within the brainstorm session to trigger architect delta sync (ENH-034).
+
+---
+
+## Adapter support
+
+Hook behavior is adapter-dependent:
+
+| Adapter | Config file | Programmatic events |
+|---------|-------------|---------------------|
+| `claude-code` | `~/.claude/settings.json` | Stop, PreToolUse, PostToolUse, UserPromptSubmit, … |
+| `cursor` | `.cursorrules` / MDC | None (no programmatic hook events) |
+
+Check your adapter's supported events:
+
+```bash
+node bin/vp-tools.cjs hooks scaffold --adapter claude-code
+```
+
+---
+
+## Adding custom hooks
+
+1. Create your hook script in `~/.viepilot/hooks/` (or anywhere accessible)
+2. Get the config format: `vp-tools hooks scaffold`
+3. Add your command to the relevant event array in `~/.claude/settings.json`
+
+Claude Code passes a JSON payload on stdin with `session_id`, `cwd`, `transcript_path`, and event-specific data. Your hook script should read from stdin and always exit 0.
+
+---
+
+## Troubleshooting
+
+**Hook not firing**  
+- Confirm `~/.claude/settings.json` has a `Stop` entry: `vp-tools hooks install` (idempotent)
+- Restart your Claude Code session after modifying `settings.json`
+
+**No stale badges appearing**  
+- The hook only marks stale if session content matches architect keyword triggers
+- Check that the brainstorm session notes file exists in `.viepilot/ui-direction/` or `docs/brainstorm/`
+- The architect HTML files must exist at `templates/architect/` (repo) or `~/.claude/viepilot/templates/architect/` (installed)
+
+**Hook error messages**  
+Hook errors appear on stderr (not in Claude's response). Check terminal output or Claude Code logs.

package/lib/adapters/antigravity.cjs

@@ -0,0 +1,33 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  id: 'antigravity',
+  name: 'Antigravity',
+  skillsDir:   (home) => path.join(home, '.antigravity', 'skills'),
+  viepilotDir: (home) => path.join(home, '.antigravity', 'viepilot'),
+  // {envToolDir} in SKILL.md files resolves to this value at install time (ENH-035)
+  executionContextBase: '.antigravity/viepilot',
+  // Post-install hint shown in "Next actions" after viepilot install
+  postInstallHint: 'Open project and run /vp-status',
+  hooks: {
+    configFile: null,       // Antigravity has no programmatic hooks system
+    schema: 'antigravity',
+    supportedEvents: []
+  },
+  installSubdirs: [
+    'workflows',
+    path.join('templates', 'project'),
+    path.join('templates', 'phase'),
+    path.join('templates', 'architect'),
+    'bin',
+    'lib',
+    'ui-components'
+  ],
+  isAvailable: (home) => {
+    const h = home || os.homedir();
+    return fs.existsSync(path.join(h, '.antigravity'));
+  }
+};

package/lib/adapters/claude-code.cjs

@@ -0,0 +1,42 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  id: 'claude-code',
+  name: 'Claude Code',
+  // Paths (home-relative; resolved at install time)
+  skillsDir:   (home) => path.join(home, '.claude', 'skills'),
+  viepilotDir: (home) => path.join(home, '.claude', 'viepilot'),
+  // execution_context base for skill .md files
+  executionContextBase: '.claude/viepilot',
+  // Post-install hint shown in "Next actions" after viepilot install
+  postInstallHint: 'Restart session so ~/.claude/skills/vp-* is picked up; then /vp-status',
+  // Hooks configuration (Claude Code settings.json)
+  hooks: {
+    configFile: (home) => path.join(home, '.claude', 'settings.json'),
+    schema: 'claude-code',
+    supportedEvents: [
+      'SessionStart', 'SessionEnd', 'Stop', 'StopFailure',
+      'UserPromptSubmit', 'PreToolUse', 'PostToolUse', 'PostToolUseFailure',
+      'FileChanged', 'SubagentStart', 'SubagentStop',
+      'TaskCreated', 'TaskCompleted', 'PreCompact', 'PostCompact'
+    ]
+  },
+  // Files/dirs to install into viepilotDir
+  installSubdirs: [
+    'workflows',
+    path.join('templates', 'project'),
+    path.join('templates', 'phase'),
+    path.join('templates', 'architect'),
+    'bin',
+    'lib',
+    'ui-components'
+  ],
+  // Detection: is this platform available on the current machine?
+  isAvailable: (home) => {
+    const h = home || os.homedir();
+    return fs.existsSync(path.join(h, '.claude'));
+  }
+};

package/lib/adapters/codex.cjs

@@ -0,0 +1,34 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  id: 'codex',
+  name: 'Codex',
+  skillsDir:   (home) => path.join(home, '.codex', 'skills'),
+  viepilotDir: (home) => path.join(home, '.codex', 'viepilot'),
+  // {envToolDir} in SKILL.md files resolves to this value at install time (ENH-035)
+  executionContextBase: '.codex/viepilot',
+  // NOTE: Codex uses $skill-name syntax (not /skill-name like other adapters)
+  // Codex reserves /command for built-in system controls (/plan, /clear, /diff, etc.)
+  postInstallHint: 'Open project and type $vp-status to get started',
+  hooks: {
+    configFile: null,       // Codex uses AGENTS.md convention, not programmatic hooks
+    schema: 'codex',
+    supportedEvents: []
+  },
+  installSubdirs: [
+    'workflows',
+    path.join('templates', 'project'),
+    path.join('templates', 'phase'),
+    path.join('templates', 'architect'),
+    'bin',
+    'lib',
+    'ui-components'
+  ],
+  isAvailable: (home) => {
+    const h = home || os.homedir();
+    return fs.existsSync(path.join(h, '.codex'));
+  }
+};

package/lib/adapters/cursor.cjs

@@ -0,0 +1,32 @@
+'use strict';
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  id: 'cursor',          // maps to cursor-agent and cursor-ide (same paths)
+  name: 'Cursor',
+  skillsDir:   (home) => path.join(home, '.cursor', 'skills'),
+  viepilotDir: (home) => path.join(home, '.cursor', 'viepilot'),
+  executionContextBase: '.cursor/viepilot',
+  // Post-install hint shown in "Next actions" after viepilot install
+  postInstallHint: 'Open project and run /vp-status',
+  hooks: {
+    configFile: null,    // Cursor uses .cursorrules/MDC, not settings.json hooks
+    schema: 'cursor',
+    supportedEvents: []  // no programmatic hook events
+  },
+  installSubdirs: [
+    'workflows',
+    path.join('templates', 'project'),
+    path.join('templates', 'phase'),
+    path.join('templates', 'architect'),
+    'bin',
+    'lib',
+    'ui-components'
+  ],
+  isAvailable: (home) => {
+    const h = home || os.homedir();
+    return fs.existsSync(path.join(h, '.cursor'));
+  }
+};

package/lib/adapters/index.cjs

@@ -0,0 +1,28 @@
+'use strict';
+const adapters = {
+  'claude-code':  require('./claude-code.cjs'),
+  'cursor':       require('./cursor.cjs'),
+  'cursor-agent': require('./cursor.cjs'),      // alias
+  'cursor-ide':   require('./cursor.cjs'),      // alias
+  'antigravity':  require('./antigravity.cjs'),
+  'codex':        require('./codex.cjs'),
+};
+
+/**
+ * Get adapter by id. Throws if unknown.
+ * @param {string} id
+ */
+function getAdapter(id) {
+  const a = adapters[id];
+  if (!a) throw new Error(`Unknown adapter: "${id}". Known: ${Object.keys(adapters).join(', ')}`);
+  return a;
+}
+
+/**
+ * List unique adapters (deduplicated — aliases share the same object).
+ */
+function listAdapters() {
+  return [...new Set(Object.values(adapters))];
+}
+
+module.exports = { getAdapter, listAdapters, adapters };

package/lib/hooks/brainstorm-staleness.cjs

@@ -0,0 +1,231 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * ViePilot brainstorm staleness hook (FEAT-012)
+ * Claude Code Stop event handler.
+ *
+ * Reads stdin JSON: { session_id, transcript_path, cwd, ... }
+ * Detects architect HTML items that have become stale relative to the active
+ * brainstorm session notes, and marks them data-arch-stale="true" (flag-only).
+ *
+ * Non-blocking: exit 0 always. Errors are logged to stderr, never thrown.
+ *
+ * Install via: node bin/vp-tools.cjs hooks install
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Architect page trigger keywords (reuses ENH-034 keyword lists)
+// ──────────────────────────────────────────────────────────────────────────────
+const ARCHITECT_TRIGGERS = {
+  'architecture.html':    ['c4', 'context diagram', 'system diagram', 'component', 'architecture'],
+  'data-flow.html':       ['data flow', 'request flow', 'event flow', 'pipeline', 'data-flow'],
+  'erd.html':             ['entity', 'relation', 'table', 'schema', 'database', 'erd'],
+  'user-use-cases.html':  ['use case', 'actor', 'user story', 'persona', 'use-case'],
+  'sequence-diagram.html':['sequence', 'interaction', 'message flow', 'sequence diagram'],
+  'deployment.html':      ['deploy', 'infrastructure', 'container', 'cloud', 'k8s', 'kubernetes'],
+  'apis.html':            ['api', 'endpoint', 'rest', 'graphql', 'grpc', 'swagger', 'openapi'],
+  'ui-design.html':       ['ui design', 'ux design', 'mockup', 'wireframe', 'layout design'],
+};
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Session discovery
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Find the most recently modified active brainstorm session file in cwd.
+ * Searches .viepilot/ui-direction/{id}/notes.md and docs/brainstorm/session-*.md.
+ * @param {string} cwd
+ * @returns {{ notesPath: string, sessionContent: string } | null}
+ */
+function findActiveSession(cwd) {
+  const candidates = [];
+
+  // .viepilot/ui-direction/*/notes.md
+  const uiDir = path.join(cwd, '.viepilot', 'ui-direction');
+  if (fs.existsSync(uiDir)) {
+    try {
+      for (const entry of fs.readdirSync(uiDir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+          const notesPath = path.join(uiDir, entry.name, 'notes.md');
+          if (fs.existsSync(notesPath)) {
+            candidates.push(notesPath);
+          }
+        }
+      }
+    } catch (_e) { /* ignore */ }
+  }
+
+  // docs/brainstorm/session-*.md
+  const brainstormDir = path.join(cwd, 'docs', 'brainstorm');
+  if (fs.existsSync(brainstormDir)) {
+    try {
+      for (const entry of fs.readdirSync(brainstormDir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.startsWith('session-') && entry.name.endsWith('.md')) {
+          candidates.push(path.join(brainstormDir, entry.name));
+        }
+      }
+    } catch (_e) { /* ignore */ }
+  }
+
+  if (candidates.length === 0) return null;
+
+  // Pick most recently modified
+  let latest = null;
+  let latestMtime = 0;
+  for (const p of candidates) {
+    try {
+      const stat = fs.statSync(p);
+      if (stat.mtimeMs > latestMtime) {
+        latestMtime = stat.mtimeMs;
+        latest = p;
+      }
+    } catch (_e) { /* ignore */ }
+  }
+
+  if (!latest) return null;
+
+  try {
+    const sessionContent = fs.readFileSync(latest, 'utf8');
+    return { notesPath: latest, sessionContent };
+  } catch (_e) {
+    return null;
+  }
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Staleness detection
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Detect which architect HTML pages have become stale based on session content.
+ * @param {string} sessionContent
+ * @param {string} architectDir - directory containing architect HTML files
+ * @returns {{ page: string, reason: string }[]}
+ */
+function detectStaleItems(sessionContent, architectDir) {
+  const lower = sessionContent.toLowerCase();
+  const stale = [];
+
+  for (const [page, keywords] of Object.entries(ARCHITECT_TRIGGERS)) {
+    const filePath = path.join(architectDir, page);
+    // Only flag pages that actually exist
+    if (!fs.existsSync(filePath)) continue;
+
+    const matchedKeywords = keywords.filter((kw) => lower.includes(kw));
+    if (matchedKeywords.length > 0) {
+      stale.push({
+        page,
+        reason: `brainstorm session mentions: ${matchedKeywords.slice(0, 3).join(', ')}`,
+      });
+    }
+  }
+
+  return stale;
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// HTML patching
+// ──────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Mark all [data-arch-id] elements in an HTML file as stale (flag-only, no content rewrite).
+ * Idempotent: elements already marked are skipped.
+ * @param {string} filePath
+ * @param {string} reason
+ * @returns {boolean} true if file was modified
+ */
+function markStaleInFile(filePath, reason) {
+  let html;
+  try {
+    html = fs.readFileSync(filePath, 'utf8');
+  } catch (_e) {
+    return false;
+  }
+
+  // Match opening tags that have data-arch-id but NOT already data-arch-stale
+  // Pattern: any tag with data-arch-id="..." that lacks data-arch-stale
+  const tagRegex = /(<(?:tr|div|td|section)[^>]*data-arch-id="[^"]*"[^>]*?)(?!\s*data-arch-stale)(>)/gi;
+
+  let changed = false;
+  const safeReason = reason.replace(/"/g, '&quot;').replace(/</g, '&lt;');
+
+  const patched = html.replace(tagRegex, (match, tagOpen, closeBracket) => {
+    // Double-check not already stale
+    if (tagOpen.includes('data-arch-stale')) return match;
+    changed = true;
+    return `${tagOpen} data-arch-stale="true" data-arch-stale-note="${safeReason}"${closeBracket}`;
+  });
+
+  if (!changed) return false;
+
+  try {
+    fs.writeFileSync(filePath, patched, 'utf8');
+    return true;
+  } catch (_e) {
+    return false;
+  }
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Main
+// ──────────────────────────────────────────────────────────────────────────────
+
+async function run(hookData) {
+  const cwd = hookData.cwd || process.cwd();
+
+  const session = findActiveSession(cwd);
+  if (!session) return; // no active brainstorm session — nothing to do
+
+  // Resolve architect directory: prefer repo-local, fall back to installed location
+  const repoArchDir = path.join(cwd, 'templates', 'architect');
+  const installArchDir = path.join(os.homedir(), '.claude', 'viepilot', 'templates', 'architect');
+  const architectDir = fs.existsSync(repoArchDir) ? repoArchDir
+    : fs.existsSync(installArchDir) ? installArchDir
+    : null;
+
+  if (!architectDir) return;
+
+  const stalePages = detectStaleItems(session.sessionContent, architectDir);
+  if (stalePages.length === 0) return;
+
+  let patchCount = 0;
+  for (const { page, reason } of stalePages) {
+    const filePath = path.join(architectDir, page);
+    const changed = markStaleInFile(filePath, reason);
+    if (changed) patchCount++;
+  }
+
+  if (patchCount > 0) {
+    process.stderr.write(
+      `[viepilot-hook] ⚠ Marked ${patchCount} architect page(s) stale` +
+      ` (session: ${path.basename(path.dirname(session.notesPath))})\n`
+    );
+  }
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Entry point — only activates when run directly (not when require()'d in tests)
+// ──────────────────────────────────────────────────────────────────────────────
+
+if (require.main === module) {
+  process.stdin.setEncoding('utf8');
+  let raw = '';
+  process.stdin.on('data', (chunk) => { raw += chunk; });
+  process.stdin.on('end', () => {
+    let hookData = {};
+    try { hookData = JSON.parse(raw); } catch (_e) { /* no stdin or not JSON = dev/test run */ }
+    run(hookData)
+      .catch((e) => {
+        process.stderr.write(`[viepilot-hook] error: ${e.message}\n`);
+      })
+      .finally(() => process.exit(0));
+  });
+  process.stdin.on('error', () => process.exit(0));
+}
+
+// Export internals for testing
+module.exports = { findActiveSession, detectStaleItems, markStaleInFile };

package/lib/viepilot-config.cjs

@@ -0,0 +1,103 @@
+/**
+ * ViePilot language configuration — schema, read/write, defaults (ENH-032 / Phase 49).
+ *
+ * Config file: ~/.viepilot/config.json
+ * Schema:
+ *   language.communication  — language for AI↔user banners/prompts  (default: "en")
+ *   language.document       — language for generated project files   (default: "en")
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+/** @type {{ language: { communication: string, document: string } }} */
+const DEFAULTS = {
+  language: {
+    communication: 'en',
+    document: 'en',
+  },
+};
+
+/**
+ * @param {string | undefined} overrideHomedir
+ * @returns {string}
+ */
+function getConfigPath(overrideHomedir) {
+  const home = overrideHomedir != null ? path.resolve(overrideHomedir) : os.homedir();
+  return path.join(home, '.viepilot', 'config.json');
+}
+
+/**
+ * Deep-merge src into dst (one level under each top-level key).
+ * @param {object} dst
+ * @param {object} src
+ * @returns {object}
+ */
+function deepMerge(dst, src) {
+  const result = Object.assign({}, dst);
+  for (const key of Object.keys(src)) {
+    if (
+      src[key] !== null &&
+      typeof src[key] === 'object' &&
+      !Array.isArray(src[key]) &&
+      dst[key] !== null &&
+      typeof dst[key] === 'object'
+    ) {
+      result[key] = Object.assign({}, dst[key], src[key]);
+    } else {
+      result[key] = src[key];
+    }
+  }
+  return result;
+}
+
+/**
+ * Read config, deep-merged with DEFAULTS. Returns DEFAULTS when file is absent.
+ * @param {string | undefined} overrideHomedir
+ * @returns {{ language: { communication: string, document: string } }}
+ */
+function readConfig(overrideHomedir) {
+  const configPath = getConfigPath(overrideHomedir);
+  try {
+    const raw = fs.readFileSync(configPath, 'utf8');
+    const parsed = JSON.parse(raw);
+    return deepMerge(DEFAULTS, parsed);
+  } catch (_e) {
+    return deepMerge({}, DEFAULTS);
+  }
+}
+
+/**
+ * Deep-patch existing config with `patch` and write back to disk.
+ * Creates ~/.viepilot/ directory if missing.
+ * @param {Partial<{ language: Partial<{ communication: string, document: string }> }>} patch
+ * @param {string | undefined} overrideHomedir
+ */
+function writeConfig(patch, overrideHomedir) {
+  const configPath = getConfigPath(overrideHomedir);
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  const current = readConfig(overrideHomedir);
+  const updated = deepMerge(current, patch);
+  fs.writeFileSync(configPath, JSON.stringify(updated, null, 2) + '\n', 'utf8');
+}
+
+/**
+ * Reset config to DEFAULTS.
+ * @param {string | undefined} overrideHomedir
+ */
+function resetConfig(overrideHomedir) {
+  const configPath = getConfigPath(overrideHomedir);
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, JSON.stringify(DEFAULTS, null, 2) + '\n', 'utf8');
+}
+
+module.exports = {
+  DEFAULTS,
+  getConfigPath,
+  readConfig,
+  writeConfig,
+  resetConfig,
+};