claude-code-popup 0.1.0

package/electron/notify.js

@@ -0,0 +1,176 @@
+'use strict';
+
+const cardsEl = document.getElementById('cn-cards');
+const countEl = document.getElementById('cn-count');
+const settingsBtn = document.getElementById('cn-settings');
+const clearBtn = document.getElementById('cn-clear');
+const body = document.body;
+
+let t = {};
+let i18nReady = false;
+let pendingState = null;
+const MAX_VISIBLE_CARDS = 3;
+const PROGRESS_DURATION = 30; // seconds — fixed timer bar, independent of config.duration
+const dismissHandles = new Map();
+
+(async function bootstrapI18n() {
+  const i18n = await window.cn.i18n();
+  t = i18n.strings;
+  document.documentElement.lang = i18n.locale;
+  settingsBtn.title = t.notify_settings;
+  settingsBtn.setAttribute('aria-label', t.notify_settings);
+  clearBtn.title = t.notify_clear_all;
+  clearBtn.setAttribute('aria-label', t.notify_clear_all);
+  i18nReady = true;
+  if (pendingState) {
+    const queued = pendingState;
+    pendingState = null;
+    renderState(queued);
+  }
+})();
+
+settingsBtn.addEventListener('click', (e) => {
+  e.stopPropagation();
+  window.cn.openSetup();
+});
+clearBtn.addEventListener('click', (e) => {
+  e.stopPropagation();
+  window.cn.clearAll();
+});
+
+function shortenDir(p) {
+  if (!p) return '';
+  const parts = p.replace(/\\/g, '/').split('/').filter(Boolean);
+  if (parts.length <= 2) return p;
+  return `…/${parts.slice(-2).join('/')}`;
+}
+
+function cssEscape(value) {
+  return String(value).replace(/(["\\\]])/g, '\\$1');
+}
+
+function applyDesign(config) {
+  body.dataset.design = String(config.design || 1);
+}
+
+function buildCard(card, config) {
+  const li = document.createElement('li');
+  li.className = 'cn-card';
+  li.dataset.id = card.id;
+  li.dataset.dir = card.dir;
+  li.title = t.notify_card_tooltip || '';
+  li.addEventListener('click', (e) => {
+    if (e.target.closest('.cn-card__close')) return;
+    window.cn.focusOrigin(card.dir);
+  });
+
+  const dir = document.createElement('div');
+  dir.className = 'cn-card__dir';
+  dir.textContent = `📁 ${shortenDir(card.dir)}`;
+  dir.title = card.dir;
+  li.appendChild(dir);
+
+  const title = document.createElement('div');
+  title.className = 'cn-card__title';
+  title.textContent = (config.message?.title?.trim()) || t.notify_default_title || 'Claude needs your input';
+  li.appendChild(title);
+
+  const close = document.createElement('button');
+  close.className = 'cn-card__close';
+  close.type = 'button';
+  close.textContent = '×';
+  close.title = t.notify_dismiss || '';
+  close.addEventListener('click', (e) => {
+    e.stopPropagation();
+    dismiss(card.id);
+  });
+  li.appendChild(close);
+
+  // Fixed 30-second "newness" timer bar. Independent of config.duration.
+  // Newer cards visibly retain more bar; after 30s the bar is removed entirely.
+  const progress = document.createElement('div');
+  progress.className = 'cn-card__progress';
+  const bar = document.createElement('span');
+  bar.className = 'cn-card__progress-bar';
+  bar.style.animationDuration = `${PROGRESS_DURATION}s`;
+  progress.appendChild(bar);
+  li.appendChild(progress);
+  setTimeout(() => progress.remove(), PROGRESS_DURATION * 1000);
+
+  return li;
+}
+
+async function dismiss(id) {
+  const li = cardsEl.querySelector(`[data-id="${cssEscape(id)}"]`);
+  if (li) li.classList.add('cn-card--leaving');
+  await window.cn.dismiss(id);
+}
+
+function scheduleAutoDismiss(card, durationSec) {
+  if (!durationSec || durationSec <= 0) return;
+  const handle = setTimeout(() => dismiss(card.id), durationSec * 1000);
+  dismissHandles.set(card.id, handle);
+}
+
+function reportHeight() {
+  const shell = document.querySelector('.cn-shell');
+  const header = document.querySelector('.cn-header');
+  if (!shell || !header) return;
+
+  const allCards = Array.from(cardsEl.children).filter(
+    (el) => !el.classList.contains('cn-card--leaving'),
+  );
+
+  if (allCards.length <= MAX_VISIBLE_CARDS) {
+    cardsEl.style.maxHeight = '';
+    const h = Math.ceil(shell.getBoundingClientRect().height) + 4;
+    window.cn.resize(h);
+    return;
+  }
+
+  const cardsRect = cardsEl.getBoundingClientRect();
+  const lastVisible = allCards[MAX_VISIBLE_CARDS - 1].getBoundingClientRect();
+  const cardsStyles = getComputedStyle(cardsEl);
+  const padBottom = parseFloat(cardsStyles.paddingBottom) || 0;
+  const cappedListHeight = Math.ceil(lastVisible.bottom - cardsRect.top + padBottom);
+  cardsEl.style.maxHeight = `${cappedListHeight}px`;
+
+  const headerH = header.getBoundingClientRect().height;
+  window.cn.resize(Math.ceil(headerH + cappedListHeight) + 4);
+}
+
+function renderState(state) {
+  applyDesign(state.config);
+  countEl.textContent = String(state.cards.length);
+
+  const seen = new Set(state.cards.map((c) => c.id));
+  for (const child of Array.from(cardsEl.children)) {
+    if (!seen.has(child.dataset.id)) {
+      const id = child.dataset.id;
+      child.classList.add('cn-card--leaving');
+      setTimeout(() => child.remove(), 180);
+      const handle = dismissHandles.get(id);
+      if (handle) {
+        clearTimeout(handle);
+        dismissHandles.delete(id);
+      }
+    }
+  }
+
+  for (const card of state.cards) {
+    if (cardsEl.querySelector(`[data-id="${cssEscape(card.id)}"]`)) continue;
+    const node = buildCard(card, state.config);
+    cardsEl.appendChild(node);
+    scheduleAutoDismiss(card, state.config.duration);
+  }
+
+  requestAnimationFrame(reportHeight);
+}
+
+window.cn.onState((state) => {
+  if (!i18nReady) {
+    pendingState = state;
+    return;
+  }
+  renderState(state);
+});

package/electron/preload.js

@@ -0,0 +1,24 @@
+'use strict';
+
+const { contextBridge, ipcRenderer } = require('electron');
+
+contextBridge.exposeInMainWorld('cn', {
+  getConfig: () => ipcRenderer.invoke('cn:getConfig'),
+  saveConfig: (next) => ipcRenderer.invoke('cn:saveConfig', next),
+  installHooks: () => ipcRenderer.invoke('cn:installHooks'),
+  uninstallHooks: () => ipcRenderer.invoke('cn:uninstallHooks'),
+  platform: () => ipcRenderer.invoke('cn:platform'),
+  openExternal: (url) => ipcRenderer.invoke('cn:openExternal', url),
+  dismiss: (id) => ipcRenderer.invoke('cn:dismiss', id),
+  clearAll: () => ipcRenderer.invoke('cn:clearAll'),
+  openSetup: () => ipcRenderer.invoke('cn:openSetup'),
+  focusOrigin: (dir) => ipcRenderer.invoke('cn:focusOrigin', dir),
+  resize: (height) => ipcRenderer.invoke('cn:resize', height),
+  openTerminal: (dir) => ipcRenderer.invoke('cn:openTerminal', dir),
+  i18n: () => ipcRenderer.invoke('cn:i18n'),
+  onState: (cb) => {
+    const handler = (_e, state) => cb(state);
+    ipcRenderer.on('state', handler);
+    return () => ipcRenderer.removeListener('state', handler);
+  },
+});

package/electron/setup.css

@@ -0,0 +1,185 @@
+:root {
+  --setup-bg: #fafbfc;
+  --setup-fg: #1a1d21;
+  --setup-muted: #606770;
+  --setup-line: #e5e7eb;
+  --setup-card: #ffffff;
+  --setup-input-bg: #ffffff;
+  --setup-accent: #d97757;
+  --setup-accent-fg: #ffffff;
+  --setup-preview-bg: #f5f6f8;
+  --setup-shadow: 0 6px 18px rgba(15,17,21,0.08);
+}
+
+* { box-sizing: border-box; }
+html, body {
+  margin: 0;
+  background: var(--setup-bg);
+  color: var(--setup-fg);
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Hiragino Kaku Gothic ProN",
+    "Noto Sans JP", Roboto, Helvetica, Arial, sans-serif;
+  font-size: 13px;
+  -webkit-user-select: none;
+}
+
+.setup {
+  max-width: 660px;
+  margin: 0 auto;
+  padding: 28px 28px 96px;
+}
+.setup__head h1 { margin: 0 0 6px; font-size: 22px; }
+.setup__head p  { margin: 0 0 24px; color: var(--setup-muted); }
+
+.setup__section {
+  background: var(--setup-card);
+  border: 1px solid var(--setup-line);
+  border-radius: 10px;
+  padding: 16px 18px;
+  margin-bottom: 14px;
+}
+.setup__section h2 { margin: 0 0 10px; font-size: 13px; font-weight: 600; }
+
+.setup__row { display: flex; flex-wrap: wrap; gap: 14px; align-items: center; }
+.setup__row label { display: inline-flex; align-items: center; gap: 6px; cursor: pointer; }
+.setup__field { display: grid; grid-template-columns: 100px 1fr; align-items: center; gap: 10px; margin-top: 8px; }
+.setup__field span { color: var(--setup-muted); }
+.setup__field input,
+.setup__field select {
+  border: 1px solid var(--setup-line);
+  border-radius: 6px;
+  padding: 6px 8px;
+  font: inherit;
+  color: var(--setup-fg);
+  background: var(--setup-input-bg);
+}
+.setup__save { color: #2f8f3a; font-size: 12px; }
+
+.btn {
+  border: 1px solid var(--setup-line);
+  background: var(--setup-input-bg);
+  color: var(--setup-fg);
+  border-radius: 8px;
+  padding: 8px 14px;
+  font: inherit;
+  cursor: pointer;
+}
+.btn:hover { filter: brightness(0.96); }
+.btn--primary { background: var(--setup-accent); color: var(--setup-accent-fg); border-color: transparent; }
+
+.setup__footer {
+  position: fixed;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  padding: 12px 28px;
+  background: var(--setup-bg);
+  border-top: 1px solid var(--setup-line);
+  display: flex;
+  justify-content: flex-end;
+  align-items: center;
+  gap: 12px;
+}
+
+/* --- design grid (always visible) --- */
+.design__grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
+  gap: 8px;
+  margin-bottom: 14px;
+}
+.design__option {
+  text-align: left;
+  padding: 10px;
+  border: 1px solid var(--setup-line);
+  border-radius: 8px;
+  background: var(--setup-input-bg);
+  cursor: pointer;
+  font: inherit;
+  color: var(--setup-fg);
+}
+.design__option:hover { filter: brightness(0.96); }
+.design__option--active {
+  border-color: var(--setup-accent);
+  box-shadow: 0 0 0 2px rgba(217, 119, 87, 0.18);
+}
+.design__optionTitle { font-weight: 600; margin-bottom: 2px; }
+.design__optionDesc  { color: var(--setup-muted); font-size: 11px; }
+
+/* --- design preview --- */
+.design__preview {
+  padding: 14px;
+  background: var(--setup-preview-bg);
+  border-radius: 8px;
+}
+.design__previewCard {
+  width: 320px;
+  margin: 0 auto;
+  border-radius: 10px;
+  background: #fff;
+  color: #1a1d21;
+  overflow: hidden;
+  box-shadow: var(--setup-shadow);
+}
+.design__previewHead {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 8px 12px;
+  background: #f5f6f8;
+  font-size: 12px;
+  font-weight: 600;
+  border-bottom: 1px solid rgba(0,0,0,0.06);
+}
+.design__previewHead span {
+  background: rgba(0,0,0,0.06);
+  padding: 1px 8px;
+  border-radius: 999px;
+  font-size: 11px;
+  color: #606770;
+}
+.design__previewBody { padding: 12px 14px; }
+.design__previewDir { font-size: 11px; color: #606770; }
+.design__previewTitle { font-size: 13px; font-weight: 600; margin-top: 4px; }
+.design__previewBar {
+  height: 3px;
+  border-radius: 2px;
+  background: rgba(0, 0, 0, 0.08);
+  margin-top: 10px;
+  overflow: hidden;
+}
+.design__previewBar span {
+  display: block;
+  height: 100%;
+  width: 60%;
+  background: #d97757;
+}
+
+/* preview design variants */
+.design__preview[data-design="2"] .design__previewCard { background: #23272d; color: #e6e8eb; border-left: 3px solid #5fa8ff; }
+.design__preview[data-design="2"] .design__previewHead { background: #15171b; color: #f4f5f7; border-bottom-color: rgba(255,255,255,0.06); }
+.design__preview[data-design="2"] .design__previewHead span { background: rgba(255,255,255,0.08); color: #c2c6cc; }
+.design__preview[data-design="2"] .design__previewDir { color: #9aa0a8; }
+.design__preview[data-design="2"] .design__previewTitle { color: #f4f5f7; }
+.design__preview[data-design="2"] .design__previewBar { background: rgba(255,255,255,0.10); }
+
+.design__preview[data-design="3"] .design__previewCard { background: #fffaf5; }
+.design__preview[data-design="3"] .design__previewHead { background: linear-gradient(90deg, #d97757, #c95f3f); color: #fff; }
+.design__preview[data-design="3"] .design__previewHead span { background: rgba(255,255,255,0.22); color: #fff; }
+
+.design__preview[data-design="4"] .design__previewCard { background: #fff; border-left: 3px solid #d97757; }
+.design__preview[data-design="4"] .design__previewHead { background: #fff8f3; }
+
+.design__preview[data-design="5"] .design__previewCard { background: #23272d; color: #e6e8eb; }
+.design__preview[data-design="5"] .design__previewHead { background: #15171b; color: #f4f5f7; }
+.design__preview[data-design="5"] .design__previewHead span { background: rgba(255,255,255,0.08); color: #c2c6cc; }
+.design__preview[data-design="5"] .design__previewDir { color: #9aa0a8; }
+.design__preview[data-design="5"] .design__previewTitle { color: #f4f5f7; }
+.design__preview[data-design="5"] .design__previewBar { background: rgba(255,255,255,0.10); }
+
+/* duration */
+.duration { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
+.duration input[type="range"] { flex: 1; min-width: 200px; }
+.duration small { width: 100%; color: var(--setup-muted); font-size: 11px; }
+
+/* switch */
+.switch { display: inline-flex; align-items: center; gap: 8px; cursor: pointer; }

package/electron/setup.html

@@ -0,0 +1,76 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="Content-Security-Policy" content="default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'self';" />
+    <title>claude-code-popup Settings</title>
+    <link rel="stylesheet" href="setup.css" />
+  </head>
+  <body>
+    <main class="setup">
+      <header class="setup__head">
+        <h1>claude-code-popup</h1>
+        <p id="subtitle"></p>
+      </header>
+
+      <section class="setup__section">
+        <h2 id="h-design"></h2>
+        <div id="designGrid" class="design__grid"></div>
+        <div id="designPreview" class="design__preview" data-design="1">
+          <div class="design__previewCard">
+            <div class="design__previewHead">🤖 Claude Code <span>1</span></div>
+            <div class="design__previewBody">
+              <div class="design__previewDir">📁 …/projects/web-app</div>
+              <div class="design__previewTitle" id="previewTitle"></div>
+              <div class="design__previewBar"><span></span></div>
+            </div>
+          </div>
+        </div>
+      </section>
+
+      <section class="setup__section">
+        <h2 id="h-message"></h2>
+        <label class="setup__field">
+          <span id="l-title"></span>
+          <input id="msgTitle" type="text" maxlength="80" />
+        </label>
+      </section>
+
+      <section class="setup__section">
+        <h2 id="h-position"></h2>
+        <label class="setup__field">
+          <span id="l-position"></span>
+          <select id="position">
+            <option value="bottom-right" data-i18n="position_br"></option>
+            <option value="bottom-left"  data-i18n="position_bl"></option>
+            <option value="top-right"    data-i18n="position_tr"></option>
+            <option value="top-left"     data-i18n="position_tl"></option>
+          </select>
+        </label>
+      </section>
+
+      <section class="setup__section">
+        <h2 id="h-duration"></h2>
+        <div class="duration">
+          <input id="duration" type="range" min="0" max="60" step="1" />
+          <output id="durationOut"></output>
+          <small id="duration-hint"></small>
+        </div>
+      </section>
+
+      <section class="setup__section">
+        <h2 id="h-sound"></h2>
+        <label class="switch">
+          <input id="sound" type="checkbox" />
+          <span id="l-sound"></span>
+        </label>
+      </section>
+
+      <footer class="setup__footer">
+        <span id="saveMsg" class="setup__save"></span>
+        <button id="save" type="button" class="btn btn--primary"></button>
+      </footer>
+    </main>
+    <script src="setup.js"></script>
+  </body>
+</html>

package/electron/setup.js

@@ -0,0 +1,137 @@
+'use strict';
+
+let t = null;       // i18n strings dict
+let state = null;   // current config in-memory
+
+const els = {
+  subtitle: document.getElementById('subtitle'),
+  hDesign: document.getElementById('h-design'),
+  hMessage: document.getElementById('h-message'),
+  hPosition: document.getElementById('h-position'),
+  hDuration: document.getElementById('h-duration'),
+  hSound: document.getElementById('h-sound'),
+  lTitle: document.getElementById('l-title'),
+  lPosition: document.getElementById('l-position'),
+  lSound: document.getElementById('l-sound'),
+  durationHint: document.getElementById('duration-hint'),
+  designGrid: document.getElementById('designGrid'),
+  designPreview: document.getElementById('designPreview'),
+  previewTitle: document.getElementById('previewTitle'),
+  msgTitle: document.getElementById('msgTitle'),
+  position: document.getElementById('position'),
+  duration: document.getElementById('duration'),
+  durationOut: document.getElementById('durationOut'),
+  sound: document.getElementById('sound'),
+  save: document.getElementById('save'),
+  saveMsg: document.getElementById('saveMsg'),
+};
+
+function fmt(template, vars) {
+  return String(template).replace(/\{(\w+)\}/g, (_, k) => vars[k]);
+}
+
+function applyStaticTexts() {
+  els.subtitle.textContent     = t.subtitle;
+  els.hDesign.textContent      = t.section_design;
+  els.hMessage.textContent     = t.section_message;
+  els.hPosition.textContent    = t.section_position;
+  els.hDuration.textContent    = t.section_duration;
+  els.hSound.textContent       = t.section_sound;
+  els.lTitle.textContent       = t.field_title;
+  els.lPosition.textContent    = t.field_position;
+  els.lSound.textContent       = t.sound_enable;
+  els.durationHint.textContent = t.duration_hint;
+  els.save.textContent         = t.save;
+  els.msgTitle.placeholder     = t.notify_default_title;
+
+  for (const opt of els.position.querySelectorAll('option[data-i18n]')) {
+    opt.textContent = t[opt.dataset.i18n] || opt.textContent;
+  }
+}
+
+function designCatalog() {
+  return [
+    { id: 1, title: t.design_1_title, desc: t.design_1_desc },
+    { id: 2, title: t.design_2_title, desc: t.design_2_desc },
+    { id: 3, title: t.design_3_title, desc: t.design_3_desc },
+    { id: 4, title: t.design_4_title, desc: t.design_4_desc },
+    { id: 5, title: t.design_5_title, desc: t.design_5_desc },
+  ];
+}
+
+function buildDesignGrid() {
+  els.designGrid.innerHTML = '';
+  for (const d of designCatalog()) {
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.className = 'design__option';
+    if (state.design === d.id) btn.classList.add('design__option--active');
+    btn.dataset.id = String(d.id);
+    btn.innerHTML = `
+      <div class="design__optionTitle">${d.id}. ${d.title}</div>
+      <div class="design__optionDesc">${d.desc}</div>
+    `;
+    btn.addEventListener('click', () => {
+      state.design = d.id;
+      buildDesignGrid();
+      applyDesignDisplay();
+    });
+    els.designGrid.appendChild(btn);
+  }
+}
+
+function applyDesignDisplay() {
+  els.designPreview.dataset.design = String(state.design || 1);
+  els.previewTitle.textContent = state.message?.title?.trim() || t.notify_default_title;
+}
+
+function applyDurationLabel() {
+  els.durationOut.textContent = state.duration === 0
+    ? t.duration_never
+    : fmt(t.duration_seconds, { n: state.duration });
+}
+
+function applyForm() {
+  els.msgTitle.value = state.message?.title || '';
+  els.position.value = state.position;
+  els.duration.value = String(state.duration);
+  els.sound.checked = !!state.sound;
+  applyDurationLabel();
+  applyDesignDisplay();
+  buildDesignGrid();
+}
+
+function bindEvents() {
+  els.msgTitle.addEventListener('input', () => {
+    state.message = state.message || {};
+    state.message.title = els.msgTitle.value;
+    applyDesignDisplay();
+  });
+  els.position.addEventListener('change', () => {
+    state.position = els.position.value;
+  });
+  els.duration.addEventListener('input', () => {
+    state.duration = Number(els.duration.value);
+    applyDurationLabel();
+  });
+  els.sound.addEventListener('change', () => {
+    state.sound = els.sound.checked;
+  });
+  els.save.addEventListener('click', async () => {
+    await window.cn.saveConfig(state);
+    els.saveMsg.textContent = t.saved;
+    setTimeout(() => (els.saveMsg.textContent = ''), 2000);
+  });
+}
+
+(async function init() {
+  const i18n = await window.cn.i18n();
+  t = i18n.strings;
+  document.documentElement.lang = i18n.locale;
+  applyStaticTexts();
+
+  state = await window.cn.getConfig();
+  state.message = state.message || { title: '' };
+  applyForm();
+  bindEvents();
+})();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "claude-code-popup",
+  "version": "0.1.0",
+  "description": "Desktop popup notifications for Claude Code (CLI) Notification hooks. Stackable cards, 5 designs, cross-platform via Electron.",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "notification",
+    "popup",
+    "electron",
+    "cli",
+    "desktop"
+  ],
+  "license": "MIT",
+  "author": "Tom-Canon-Rock",
+  "bin": {
+    "claude-code-popup": "bin/cli.js"
+  },
+  "main": "electron/main.js",
+  "files": [
+    "bin",
+    "src",
+    "electron",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "electron .",
+    "setup": "node bin/cli.js setup",
+    "postinstall": "node bin/postinstall.js",
+    "preuninstall": "node bin/preuninstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "electron": "^31.0.0"
+  }
+}

package/src/config.js

@@ -0,0 +1,58 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.claude-code-popup');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
+const RUNTIME_PATH = path.join(CONFIG_DIR, 'runtime.json');
+
+const DEFAULT_CONFIG = {
+  design: 1,
+  message: {
+    // Empty by default; the renderer falls back to the localised
+    // i18n.notify_default_title at display time.
+    title: '',
+  },
+  position: 'bottom-right',
+  duration: 5,
+  sound: false,
+};
+
+function ensureDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+function readConfig() {
+  ensureDir();
+  if (!fs.existsSync(CONFIG_PATH)) {
+    return { ...DEFAULT_CONFIG };
+  }
+  try {
+    const raw = fs.readFileSync(CONFIG_PATH, 'utf8');
+    const parsed = JSON.parse(raw);
+    return { ...DEFAULT_CONFIG, ...parsed, message: { ...DEFAULT_CONFIG.message, ...(parsed.message || {}) } };
+  } catch {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+
+function writeConfig(next) {
+  ensureDir();
+  const merged = { ...readConfig(), ...next };
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(merged, null, 2), 'utf8');
+  return merged;
+}
+
+module.exports = {
+  CONFIG_DIR,
+  CONFIG_PATH,
+  RUNTIME_PATH,
+  DEFAULT_CONFIG,
+  readConfig,
+  writeConfig,
+  ensureDir,
+};