wiki-plugin-lucille 0.0.1

package/server/server.js

@@ -0,0 +1,1294 @@
+(function() {
+const http = require('http');
+const httpProxy = require('http-proxy');
+const fs = require('fs');
+const path = require('path');
+const fetch = require('node-fetch');
+const sessionless = require('sessionless-node');
+const { spawn, exec } = require('child_process');
+
+// ── Constants ─────────────────────────────────────────────────────────────────
+
+const LUCILLE_PORT    = parseInt(process.env.LUCILLE_PORT) || 5444;
+const LUCILLE_PATH    = process.env.LUCILLE_PATH || path.dirname(require.resolve('lucille/package.json'));
+const LUCILLE_PID_FILE = path.join(__dirname, `lucille-${LUCILLE_PORT}.pid`);
+const CONFIG_FILE     = path.join(process.env.HOME || '/root', '.lucille', 'config.json');
+
+let lucilleProcess = null;
+
+// ── Default config ────────────────────────────────────────────────────────────
+
+const DEFAULT_CONFIG = {
+  spacesKey: '',
+  spacesSecret: '',
+  spacesRegion: 'nyc3',
+  spacesBucket: '',
+  spacesCdnEndpoint: '',
+  trackerPort: 8000,
+  sanoraUrl: '',
+  tiers: [
+    { id: 'free',    name: 'Free',    price: 0,    storageLimit: 524288000,   videoLimit: 5,  durationLimit: 600  },
+    { id: 'creator', name: 'Creator', price: 500,  storageLimit: 10737418240, videoLimit: 50, durationLimit: 3600 },
+    { id: 'pro',     name: 'Pro',     price: 2000, storageLimit: 0,           videoLimit: 0,  durationLimit: 0    }
+  ],
+  federationPeers: []
+};
+
+// ── Config helpers ────────────────────────────────────────────────────────────
+
+function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_FILE)) {
+      return { ...DEFAULT_CONFIG, ...JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')) };
+    }
+  } catch (err) {
+    console.warn('[wiki-plugin-lucille] Could not read config:', err.message);
+  }
+  return { ...DEFAULT_CONFIG };
+}
+
+function saveConfig(config) {
+  try {
+    const dir = path.dirname(CONFIG_FILE);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
+  } catch (err) {
+    console.error('[wiki-plugin-lucille] Could not save config:', err.message);
+  }
+}
+
+function isConfigured(config) {
+  return !!(config.spacesKey && config.spacesSecret && config.spacesBucket);
+}
+
+// ── Addie helpers ─────────────────────────────────────────────────────────────
+
+function getAddieUrl() {
+  const cfg = loadConfig();
+  if (cfg.allyabaseUrl) return cfg.allyabaseUrl.replace(/\/$/, '') + '/plugin/allyabase/addie';
+  if (cfg.sanoraUrl) {
+    try { return new URL(cfg.sanoraUrl).origin + '/plugin/allyabase/addie'; } catch (e) {}
+  }
+  return 'https://dev.allyabase.com/plugin/allyabase/addie';
+}
+
+async function generateAddieKeys() {
+  return new Promise((resolve, reject) => {
+    sessionless.generateKeys(
+      (k) => { resolve(k); return k; },
+      () => null
+    );
+    setTimeout(() => reject(new Error('generateKeys timed out')), 5000);
+  });
+}
+
+async function addieCreateUser(addieUrl, addieKeys) {
+  sessionless.getKeys = () => addieKeys;
+  const timestamp = Date.now().toString();
+  const message = timestamp + addieKeys.pubKey;
+  const signature = await sessionless.sign(message);
+  const resp = await fetch(`${addieUrl}/user/create`, {
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ timestamp, pubKey: addieKeys.pubKey, signature })
+  });
+  if (!resp.ok) throw new Error(`Addie create failed: ${resp.status}`);
+  return resp.json();
+}
+
+async function addieGetStripeConnectUrl(addieUrl, addieKeys, addieUuid, returnUrl) {
+  sessionless.getKeys = () => addieKeys;
+  const timestamp = Date.now().toString();
+  const message = timestamp + addieUuid;
+  const signature = await sessionless.sign(message);
+  const resp = await fetch(
+    `${addieUrl}/user/${addieUuid}/processor/stripe/connect?timestamp=${timestamp}&signature=${signature}&returnUrl=${encodeURIComponent(returnUrl)}`,
+    { headers: { 'Content-Type': 'application/json' } }
+  );
+  if (!resp.ok) throw new Error(`Addie Stripe connect failed: ${resp.status}`);
+  const data = await resp.json();
+  return data.url || data.connectUrl || data.onboardingUrl;
+}
+
+async function addieCreatePaymentIntent(addieUrl, buyerKeys, buyerUuid, amount, payees) {
+  sessionless.getKeys = () => buyerKeys;
+  const timestamp = Date.now().toString();
+  const message = timestamp + buyerUuid + amount + 'USD';
+  const signature = await sessionless.sign(message);
+  const resp = await fetch(`${addieUrl}/user/${buyerUuid}/processor/stripe/intent`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ timestamp, amount, currency: 'USD', payees, signature })
+  });
+  if (!resp.ok) throw new Error(`Addie intent failed: ${resp.status}`);
+  return resp.json();
+}
+
+async function ensureServerAddieUser() {
+  const config = loadConfig();
+  if (config.serverAddie && config.serverAddie.uuid) return config.serverAddie;
+  const addieUrl = getAddieUrl();
+  const addieKeys = await generateAddieKeys();
+  const addieUser = await addieCreateUser(addieUrl, addieKeys);
+  if (addieUser.error) throw new Error(`Addie: ${addieUser.error}`);
+  const serverAddie = { uuid: addieUser.uuid, pubKey: addieKeys.pubKey, privateKey: addieKeys.privateKey };
+  config.serverAddie = serverAddie;
+  saveConfig(config);
+  return serverAddie;
+}
+
+// ── Process lifecycle ─────────────────────────────────────────────────────────
+
+function killProcessByPid(pid) {
+  try {
+    process.kill(pid, 'SIGTERM');
+    setTimeout(() => {
+      try { process.kill(pid, 0); process.kill(pid, 'SIGKILL'); } catch {}
+    }, 2000);
+    return true;
+  } catch (err) {
+    if (err.code !== 'ESRCH') console.error(`[wiki-plugin-lucille] Error killing ${pid}:`, err.message);
+    return false;
+  }
+}
+
+function killProcessByPort(port) {
+  return new Promise(resolve => {
+    exec(`lsof -ti tcp:${port}`, (err, stdout) => {
+      if (err || !stdout.trim()) return resolve(false);
+      const pid = parseInt(stdout.trim(), 10);
+      resolve(killProcessByPid(pid));
+    });
+  });
+}
+
+async function cleanupOrphanedProcess() {
+  if (fs.existsSync(LUCILLE_PID_FILE)) {
+    try {
+      const pid = parseInt(fs.readFileSync(LUCILLE_PID_FILE, 'utf8').trim(), 10);
+      killProcessByPid(pid);
+      await new Promise(r => setTimeout(r, 2500));
+      fs.unlinkSync(LUCILLE_PID_FILE);
+    } catch {}
+  }
+  const killed = await killProcessByPort(LUCILLE_PORT);
+  if (killed) await new Promise(r => setTimeout(r, 2500));
+}
+
+function writePidFile(pid) {
+  try { fs.writeFileSync(LUCILLE_PID_FILE, pid.toString(), 'utf8'); } catch {}
+}
+
+function cleanupPidFile() {
+  try { if (fs.existsSync(LUCILLE_PID_FILE)) fs.unlinkSync(LUCILLE_PID_FILE); } catch {}
+}
+
+function shutdownLucille() {
+  if (lucilleProcess && !lucilleProcess.killed) {
+    try {
+      lucilleProcess.kill('SIGTERM');
+      setTimeout(() => {
+        if (lucilleProcess && !lucilleProcess.killed) lucilleProcess.kill('SIGKILL');
+      }, 2000);
+    } catch {}
+  }
+  cleanupPidFile();
+}
+
+async function checkLucilleRunning() {
+  try {
+    const res = await fetch(`http://127.0.0.1:${LUCILLE_PORT}/health`, { timeout: 2000 });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
+async function launchLucille(config) {
+  return new Promise((resolve, reject) => {
+    console.log('[wiki-plugin-lucille] Launching lucille service…');
+
+    if (!fs.existsSync(LUCILLE_PATH)) {
+      return reject(new Error(`Lucille not found at ${LUCILLE_PATH}. Set LUCILLE_PATH.`));
+    }
+
+    const serverPath = path.join(LUCILLE_PATH, 'lucille.js');
+    if (!fs.existsSync(serverPath)) {
+      return reject(new Error(`lucille.js not found at ${serverPath}`));
+    }
+
+    const trackerPort = config.trackerPort || 8000;
+    const trackerUrl  = config.trackerUrl  ||
+      `ws://${config.trackerHost || 'localhost'}:${trackerPort}`;
+
+    const env = {
+      ...process.env,
+      PORT:                  LUCILLE_PORT.toString(),
+      LUCILLE_MODE:          'all',
+      DO_SPACES_KEY:         config.spacesKey        || '',
+      DO_SPACES_SECRET:      config.spacesSecret      || '',
+      DO_SPACES_REGION:      config.spacesRegion      || 'nyc3',
+      DO_SPACES_BUCKET:      config.spacesBucket      || '',
+      DO_SPACES_CDN_ENDPOINT: config.spacesCdnEndpoint || '',
+      TRACKER_PORT:          trackerPort.toString(),
+      TRACKER_URL:           trackerUrl,
+      SANORA_URL:            config.sanoraUrl         || ''
+    };
+
+    console.log('[wiki-plugin-lucille] Env:');
+    console.log(`  PORT:          ${env.PORT}`);
+    console.log(`  TRACKER_PORT:  ${env.TRACKER_PORT}`);
+    console.log(`  DO_SPACES_BUCKET: ${env.DO_SPACES_BUCKET || '(not set)'}`);
+
+    lucilleProcess = spawn('node', ['lucille.js'], {
+      cwd: LUCILLE_PATH,
+      env,
+      stdio: ['ignore', 'pipe', 'pipe']
+    });
+
+    writePidFile(lucilleProcess.pid);
+
+    lucilleProcess.stdout.on('data', d =>
+      d.toString().split('\n').filter(l => l.trim())
+        .forEach(l => console.log(`[lucille:${LUCILLE_PORT}] ${l}`))
+    );
+    lucilleProcess.stderr.on('data', d =>
+      console.error(`[lucille:${LUCILLE_PORT}] ERR: ${d.toString().trim()}`)
+    );
+    lucilleProcess.on('exit', (code, signal) => {
+      if (code !== 0 && code !== null) {
+        console.error(`[wiki-plugin-lucille] Process exited (code ${code}, signal ${signal})`);
+      }
+      cleanupPidFile();
+      lucilleProcess = null;
+    });
+    lucilleProcess.on('error', err => reject(err));
+
+    console.log('[wiki-plugin-lucille] Waiting 4s for lucille to start…');
+    setTimeout(async () => {
+      const running = await checkLucilleRunning();
+      if (running) {
+        console.log('[wiki-plugin-lucille] ✅ Lucille started');
+        resolve();
+      } else {
+        console.warn('[wiki-plugin-lucille] ⚠️  Lucille did not respond to health check — continuing anyway');
+        resolve();
+      }
+    }, 4000);
+  });
+}
+
+async function configureLucille(config) {
+  try {
+    const res = await fetch(`http://127.0.0.1:${LUCILLE_PORT}/config`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        tiers: config.tiers,
+        federationPeers: config.federationPeers,
+        sanoraUrl: config.sanoraUrl
+      })
+    });
+    const data = await res.json();
+    if (data.success) {
+      console.log(`[wiki-plugin-lucille] ✅ Lucille configured (${data.tiers?.length || 0} tiers, ${data.federationPeers?.length || 0} peers)`);
+    }
+  } catch (err) {
+    console.warn('[wiki-plugin-lucille] Could not configure lucille:', err.message);
+  }
+}
+
+// ── Freyja federation page ────────────────────────────────────────────────────
+
+function generateFederationPage(currentId) {
+  const PLUGINS = {
+    agora:       { id: 'agora',       color: '#00cc00', icon: '🛍️', name: 'Agora',       tagline: 'Digital marketplace',      desc: 'A federated marketplace for independent creators. Buy and sell books, music, posts, and more — commerce the way it was supposed to work.', path: '/plugin/agora/directory',  ping: '/plugin/agora/directory',       fed: '/plugin/agora/federation' },
+    lucille:     { id: 'lucille',     color: '#ee22ee', icon: '🎬', name: 'Lucille',     tagline: 'P2P video hosting',         desc: 'Upload and stream video peer-to-peer. No corporate infrastructure, no surveillance — your wiki hosts your content directly.',               path: '/plugin/lucille/setup',     ping: '/plugin/lucille/setup/status',  fed: '/plugin/lucille/federation' },
+    linkitylink: { id: 'linkitylink', color: '#9922cc', icon: '🔗', name: 'Linkitylink', tagline: 'Privacy-first link pages',  desc: 'Create beautiful tapestries of links. No tracking, no algorithms — just your links, shared your way, on your terms.',                        path: '/plugin/linkitylink',       ping: '/plugin/linkitylink/config',    fed: '/plugin/linkitylink/federation' },
+    salon:       { id: 'salon',       color: '#ffdd00', icon: '🏛️', name: 'Salon',       tagline: 'Community gathering space', desc: 'A gathering place for your wiki community. Members register, connect, and receive updates from the wider Freyja ecosystem.',                 path: '/plugin/salon',             ping: '/plugin/salon/config',          fed: '/plugin/salon/federation' },
+  };
+
+  const current = PLUGINS[currentId];
+  const others  = Object.values(PLUGINS).filter(p => p.id !== currentId);
+
+  const navDotsHtml = Object.values(PLUGINS).map(p => `
+      <a href="${p.fed}" class="fnav-dot" style="--dot-color:${p.color};" title="${p.name}">
+        <span class="fnav-dot-inner"></span>
+      </a>`).join('');
+
+  const cardsHtml = others.map(p => `
+      <a href="${p.fed}" class="fed-card" style="--card-color:${p.color};">
+        <div class="fed-card-top">
+          <span class="fed-card-icon">${p.icon}</span>
+          <div class="fed-card-meta">
+            <div class="fed-card-name">
+              <span class="fed-status-dot" id="dot-${p.id}"></span>
+              ${p.name}
+            </div>
+            <div class="fed-card-tagline">${p.tagline}</div>
+          </div>
+        </div>
+        <div class="fed-card-desc">${p.desc}</div>
+        <div class="fed-card-cta">Explore ${p.name} →</div>
+      </a>`).join('');
+
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Freyja — ${current.name}</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Orbitron:wght@400;600;700;900&family=Inter:wght@300;400;500;600&display=swap" rel="stylesheet">
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+    :root {
+      --bg: #04040f;
+      --surface: rgba(12, 12, 30, 0.75);
+      --border: rgba(100, 120, 200, 0.18);
+      --text: #ffffff;
+      --text-muted: rgba(220, 225, 255, 0.88);
+      --text-dim: rgba(200, 210, 255, 0.65);
+      --radius-card: 1.25rem;
+      --radius-pill: 9999px;
+      --ease: cubic-bezier(0.16, 1, 0.3, 1);
+      --current-color: ${current.color};
+    }
+
+    html, body { height: 100%; }
+
+    body {
+      font-family: 'Inter', system-ui, sans-serif;
+      font-weight: 300;
+      background: var(--bg);
+      color: var(--text-muted);
+      min-height: 100vh;
+      overflow-x: hidden;
+    }
+
+    #starfield {
+      position: fixed;
+      inset: 0;
+      z-index: 0;
+      pointer-events: none;
+    }
+
+    .fnav {
+      position: fixed;
+      top: 0; left: 0; right: 0;
+      z-index: 100;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding: 0 2rem;
+      height: 56px;
+      background: rgba(4, 4, 15, 0.8);
+      backdrop-filter: blur(16px);
+      border-bottom: 1px solid var(--border);
+    }
+    .fnav-brand {
+      font-family: 'Orbitron', sans-serif;
+      font-weight: 700;
+      font-size: 1rem;
+      color: var(--current-color);
+      text-decoration: none;
+      filter: drop-shadow(0 0 8px var(--current-color));
+      letter-spacing: 0.06em;
+    }
+    .fnav-dots { display: flex; align-items: center; gap: 0.75rem; }
+    .fnav-dot {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      width: 28px;
+      height: 28px;
+      border-radius: 50%;
+      text-decoration: none;
+      transition: transform 0.2s var(--ease);
+    }
+    .fnav-dot:hover { transform: scale(1.25); }
+    .fnav-dot-inner {
+      width: 12px;
+      height: 12px;
+      border-radius: 50%;
+      background: var(--dot-color);
+      filter: drop-shadow(0 0 6px var(--dot-color));
+    }
+
+    .page { position: relative; z-index: 1; }
+
+    .hero {
+      min-height: 100vh;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      text-align: center;
+      padding: 7rem 2rem 4rem;
+      gap: 1.25rem;
+      opacity: 0;
+      transform: translateY(24px);
+      transition: opacity 0.8s var(--ease), transform 0.8s var(--ease);
+    }
+    .hero.visible { opacity: 1; transform: none; }
+
+    .hero-eyebrow {
+      font-family: 'Orbitron', sans-serif;
+      font-size: 0.7rem;
+      font-weight: 600;
+      letter-spacing: 0.2em;
+      text-transform: uppercase;
+      color: var(--current-color);
+    }
+    .hero-icon {
+      font-size: 5rem;
+      line-height: 1;
+      filter: drop-shadow(0 0 24px ${current.color});
+    }
+    .hero-title {
+      font-family: 'Orbitron', sans-serif;
+      font-size: clamp(3rem, 10vw, 6rem);
+      font-weight: 900;
+      color: var(--current-color);
+      filter: drop-shadow(0 0 30px var(--current-color));
+      line-height: 1;
+      letter-spacing: -0.02em;
+    }
+    .hero-tagline {
+      font-family: 'Orbitron', sans-serif;
+      font-size: 0.75rem;
+      font-weight: 400;
+      letter-spacing: 0.18em;
+      text-transform: uppercase;
+      color: var(--text-dim);
+    }
+    .hero-desc {
+      max-width: 520px;
+      font-size: 1rem;
+      font-weight: 300;
+      color: var(--text-muted);
+      line-height: 1.7;
+    }
+    .hero-btn {
+      display: inline-block;
+      margin-top: 0.5rem;
+      padding: 0.75rem 2rem;
+      border-radius: var(--radius-pill);
+      background: var(--current-color);
+      color: #000;
+      font-family: 'Inter', sans-serif;
+      font-weight: 600;
+      font-size: 0.9rem;
+      text-decoration: none;
+      transition: transform 0.2s var(--ease), filter 0.2s;
+    }
+    .hero-btn:hover { transform: scale(1.04); filter: brightness(1.15); }
+
+    .cards-section {
+      max-width: 1000px;
+      margin: 0 auto;
+      padding: 4rem 2rem 6rem;
+      opacity: 0;
+      transform: translateY(32px);
+      transition: opacity 0.8s var(--ease) 0.15s, transform 0.8s var(--ease) 0.15s;
+    }
+    .cards-section.visible { opacity: 1; transform: none; }
+
+    .section-label {
+      font-family: 'Orbitron', sans-serif;
+      font-size: 0.65rem;
+      font-weight: 600;
+      letter-spacing: 0.22em;
+      text-transform: uppercase;
+      color: var(--text-dim);
+      margin-bottom: 1.5rem;
+    }
+
+    .fed-grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+      gap: 1.25rem;
+    }
+
+    .fed-card {
+      --card-color: #ffffff;
+      background: var(--surface);
+      backdrop-filter: blur(10px);
+      border: 1px solid var(--border);
+      border-radius: var(--radius-card);
+      padding: 1.5rem;
+      display: flex;
+      flex-direction: column;
+      gap: 1rem;
+      text-decoration: none;
+      color: var(--text-muted);
+      transition: border-color 0.25s var(--ease), filter 0.25s var(--ease), transform 0.25s var(--ease);
+    }
+    .fed-card:hover {
+      border-color: var(--card-color);
+      filter: drop-shadow(0 0 14px var(--card-color));
+      transform: translateY(-4px);
+    }
+    .fed-card-top { display: flex; align-items: flex-start; gap: 1rem; }
+    .fed-card-icon { font-size: 2rem; line-height: 1; flex-shrink: 0; }
+    .fed-card-meta { flex: 1; }
+    .fed-card-name {
+      font-family: 'Orbitron', sans-serif;
+      font-size: 0.9rem;
+      font-weight: 600;
+      color: var(--text);
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+      margin-bottom: 0.25rem;
+    }
+    .fed-status-dot {
+      width: 8px;
+      height: 8px;
+      border-radius: 50%;
+      background: rgba(200, 210, 255, 0.3);
+      flex-shrink: 0;
+      transition: background 0.4s, filter 0.4s;
+    }
+    .fed-card-tagline { font-size: 0.75rem; color: var(--card-color); font-weight: 500; }
+    .fed-card-desc { font-size: 0.85rem; line-height: 1.6; color: var(--text-dim); flex: 1; }
+    .fed-card-cta { font-size: 0.8rem; font-weight: 600; color: var(--card-color); align-self: flex-start; }
+
+    .fed-footer {
+      text-align: center;
+      padding: 2rem;
+      font-size: 0.78rem;
+      color: var(--text-dim);
+      border-top: 1px solid var(--border);
+      position: relative;
+      z-index: 1;
+    }
+    .fed-footer strong { font-family: 'Orbitron', sans-serif; color: var(--text-muted); }
+  </style>
+</head>
+<body>
+  <canvas id="starfield"></canvas>
+
+  <nav class="fnav">
+    <a href="${current.fed}" class="fnav-brand">✦ FREYJA</a>
+    <div class="fnav-dots">${navDotsHtml}
+    </div>
+  </nav>
+
+  <div class="page">
+    <section class="hero" id="hero">
+      <div class="hero-eyebrow">Freyja Ecosystem</div>
+      <div class="hero-icon">${current.icon}</div>
+      <div class="hero-title">${current.name}</div>
+      <div class="hero-tagline">${current.tagline}</div>
+      <div class="hero-desc">${current.desc}</div>
+      <a href="${current.path}" class="hero-btn">Open ${current.name} →</a>
+    </section>
+
+    <section class="cards-section" id="cards">
+      <div class="section-label">Also on this wiki</div>
+      <div class="fed-grid">${cardsHtml}
+      </div>
+    </section>
+
+    <footer class="fed-footer">
+      <strong>Freyja</strong> — open, federated, and owned by you.
+    </footer>
+  </div>
+
+  <script>
+  (function() {
+    var canvas = document.getElementById('starfield');
+    var ctx = canvas.getContext('2d');
+    var stars = [];
+    function resize() { canvas.width = window.innerWidth; canvas.height = window.innerHeight; }
+    resize();
+    window.addEventListener('resize', resize);
+    for (var i = 0; i < 180; i++) {
+      stars.push({ x: Math.random(), y: Math.random(), r: Math.random() * 1.2 + 0.2, a: Math.random(), da: (Math.random() - 0.5) * 0.008 });
+    }
+    function drawStars() {
+      ctx.clearRect(0, 0, canvas.width, canvas.height);
+      for (var i = 0; i < stars.length; i++) {
+        var s = stars[i];
+        s.a += s.da;
+        if (s.a <= 0 || s.a >= 1) s.da = -s.da;
+        ctx.beginPath();
+        ctx.arc(s.x * canvas.width, s.y * canvas.height, s.r, 0, Math.PI * 2);
+        ctx.fillStyle = 'rgba(200,210,255,' + s.a.toFixed(2) + ')';
+        ctx.fill();
+      }
+      requestAnimationFrame(drawStars);
+    }
+    drawStars();
+
+    var obs = new IntersectionObserver(function(entries) {
+      entries.forEach(function(e) { if (e.isIntersecting) e.target.classList.add('visible'); });
+    }, { threshold: 0.1 });
+    obs.observe(document.getElementById('hero'));
+    obs.observe(document.getElementById('cards'));
+
+    var pluginColors = { agora: '#00cc00', lucille: '#ee22ee', linkitylink: '#9922cc', salon: '#ffdd00' };
+    var pings = [
+      { id: 'agora',       url: '/plugin/agora/directory' },
+      { id: 'lucille',     url: '/plugin/lucille/setup/status' },
+      { id: 'linkitylink', url: '/plugin/linkitylink/config' },
+      { id: 'salon',       url: '/plugin/salon/config' }
+    ];
+    pings.forEach(function(p) {
+      fetch(p.url, { signal: AbortSignal.timeout(3000) })
+        .then(function(r) {
+          var d = document.getElementById('dot-' + p.id);
+          if (d) {
+            d.style.background = r.ok ? pluginColors[p.id] : 'rgba(200,210,255,0.3)';
+            if (r.ok) d.style.filter = 'drop-shadow(0 0 5px ' + pluginColors[p.id] + ')';
+          }
+        })
+        .catch(function() {});
+    });
+  })();
+  </script>
+</body>
+</html>`;
+}
+
+// ── Main startServer ──────────────────────────────────────────────────────────
+
+async function startServer(params) {
+  const app = params.app;
+  const config = loadConfig();
+
+  console.log('[wiki-plugin-lucille] Starting…');
+  console.log(`[wiki-plugin-lucille] Config: ${CONFIG_FILE}`);
+  console.log(`[wiki-plugin-lucille] Configured: ${isConfigured(config)}`);
+
+  await cleanupOrphanedProcess();
+
+  if (isConfigured(config)) {
+    const running = await checkLucilleRunning();
+    if (!running) {
+      try {
+        await launchLucille(config);
+        await configureLucille(config);
+      } catch (err) {
+        console.error('[wiki-plugin-lucille] Failed to launch lucille:', err.message);
+      }
+    } else {
+      console.log('[wiki-plugin-lucille] Lucille already running, reconfiguring…');
+      await configureLucille(config);
+    }
+  } else {
+    console.log('[wiki-plugin-lucille] DO Spaces not configured — lucille in offline mode');
+  }
+
+  // ── Proxy setup ─────────────────────────────────────────────────────────────
+
+  const proxy = httpProxy.createProxyServer({});
+
+  proxy.on('error', (err, req, res) => {
+    console.error('[lucille proxy]', err.message);
+    res.writeHead(503, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: 'Lucille service not available', hint: 'Complete setup at /plugin/lucille/setup' }));
+  });
+
+  proxy.on('proxyReq', (proxyReq, req) => {
+    if (req.body && Object.keys(req.body).length > 0) {
+      const body = JSON.stringify(req.body);
+      proxyReq.setHeader('Content-Type', 'application/json');
+      proxyReq.setHeader('Content-Length', Buffer.byteLength(body));
+      proxyReq.write(body);
+      proxyReq.end();
+    }
+  });
+
+  // ── Setup / onboarding endpoints ────────────────────────────────────────────
+
+  // GET /plugin/lucille/setup — serve setup page
+  app.get('/plugin/lucille/setup', (req, res) => {
+    const cfg = loadConfig();
+    res.send(generateSetupPage(cfg));
+  });
+
+  // POST /plugin/lucille/setup — save config and (re)launch lucille
+  app.post('/plugin/lucille/setup', express_json(), async (req, res) => {
+    const {
+      spacesKey, spacesSecret, spacesRegion, spacesBucket, spacesCdnEndpoint,
+      trackerPort, trackerHost, sanoraUrl, allyabaseUrl, tiers, federationPeers
+    } = req.body;
+
+    const existing = loadConfig();
+    const newConfig = {
+      ...existing,
+      ...(spacesKey        && { spacesKey }),
+      ...(spacesSecret     && { spacesSecret }),
+      ...(spacesRegion     && { spacesRegion }),
+      ...(spacesBucket     && { spacesBucket }),
+      ...(spacesCdnEndpoint && { spacesCdnEndpoint }),
+      ...(trackerPort      && { trackerPort: parseInt(trackerPort) }),
+      ...(trackerHost      && { trackerHost }),
+      ...(sanoraUrl        && { sanoraUrl }),
+      ...(allyabaseUrl     && { allyabaseUrl, sanoraUrl: allyabaseUrl.replace(/\/$/, '') + '/plugin/allyabase/sanora' }),
+      ...(tiers            && { tiers }),
+      ...(federationPeers  && { federationPeers })
+    };
+
+    saveConfig(newConfig);
+
+    // Auto-create server Addie user if allyabaseUrl was just set
+    if (allyabaseUrl && !newConfig.serverAddie) {
+      try {
+        await ensureServerAddieUser();
+      } catch (err) {
+        console.warn('[wiki-plugin-lucille] Could not create server Addie user:', err.message);
+      }
+    }
+
+    // Restart lucille with new config
+    if (lucilleProcess) shutdownLucille();
+    await new Promise(r => setTimeout(r, 3000));
+
+    if (isConfigured(newConfig)) {
+      try {
+        await launchLucille(newConfig);
+        await configureLucille(newConfig);
+        res.json({ success: true, message: 'Lucille configured and started' });
+      } catch (err) {
+        res.json({ success: false, error: err.message });
+      }
+    } else {
+      res.json({ success: true, message: 'Config saved — provide DO Spaces credentials to start lucille' });
+    }
+  });
+
+  // GET /plugin/lucille/setup/status
+  app.get('/plugin/lucille/setup/status', async (req, res) => {
+    const cfg = loadConfig();
+    const running = await checkLucilleRunning();
+    const isOwner = !!(app.securityhandler && app.securityhandler.isAuthorized(req));
+    const allyabaseUrl = cfg.allyabaseUrl ||
+      (cfg.sanoraUrl ? cfg.sanoraUrl.replace(/\/plugin\/allyabase\/sanora$/, '') : '');
+    res.json({
+      configured: isConfigured(cfg),
+      running,
+      tiers: cfg.tiers,
+      federationPeers: cfg.federationPeers,
+      isOwner,
+      allyabaseUrl: isOwner ? allyabaseUrl : undefined,
+      serverAddieReady: isOwner ? !!(cfg.serverAddie && cfg.serverAddie.uuid) : undefined,
+      stripeOnboarded: isOwner ? !!cfg.stripeOnboarded : undefined
+    });
+  });
+
+  // ── Owner Stripe Connect ──────────────────────────────────────────────────────
+
+  app.get('/plugin/lucille/setup/stripe', async (req, res) => {
+    const isOwnerReq = !!(app.securityhandler && app.securityhandler.isAuthorized(req));
+    if (!isOwnerReq) return res.status(403).send('Owner only');
+    const cfg = loadConfig();
+    if (!cfg.serverAddie || !cfg.serverAddie.uuid) {
+      return res.status(503).send('Save your allyabase URL first to set up a server Addie account');
+    }
+    try {
+      const addieUrl = getAddieUrl();
+      const returnUrl = `${req.protocol}://${req.get('host')}/plugin/lucille/setup/stripe/return`;
+      const connectUrl = await addieGetStripeConnectUrl(addieUrl, cfg.serverAddie, cfg.serverAddie.uuid, returnUrl);
+      if (!connectUrl) return res.status(502).send('Addie did not return a Stripe Connect URL');
+      res.redirect(connectUrl);
+    } catch (err) {
+      res.status(502).send('Could not start Stripe onboarding: ' + err.message);
+    }
+  });
+
+  app.get('/plugin/lucille/setup/stripe/return', (req, res) => {
+    const cfg = loadConfig();
+    cfg.stripeOnboarded = true;
+    saveConfig(cfg);
+    res.send(`<!DOCTYPE html><html><head><meta charset="UTF-8">
+<title>Stripe Connect complete</title>
+<style>body{font-family:sans-serif;background:#0d0d1a;color:#e0d0ff;display:flex;align-items:center;justify-content:center;min-height:100vh;margin:0;}
+.card{background:rgba(20,0,40,.7);border:1px solid rgba(167,139,250,.25);border-radius:12px;padding:2rem;max-width:400px;text-align:center;}
+h1{color:#0e0;font-size:1.5rem;margin-bottom:.75rem;}p{color:#a78bfa;font-size:.9rem;}</style>
+</head><body><div class="card">
+<h1>✅ Stripe payouts enabled</h1>
+<p>Your wiki is now connected to Stripe and will receive tier upgrade payments.</p>
+<p style="margin-top:1rem"><a href="/plugin/lucille/setup" style="color:#a78bfa;">Back to setup</a></p>
+</div></body></html>`);
+  });
+
+  // ── Tier upgrade payment ──────────────────────────────────────────────────────
+
+  const express_json_tier = require('express').json({ limit: '64kb' });
+
+  // Tier upgrade page — customer pays here
+  app.get('/plugin/lucille/tier/:tierId', (req, res) => {
+    const { tierId } = req.params;
+    const cfg = loadConfig();
+    const tier = (cfg.tiers || []).find(t => t.id === tierId);
+    if (!tier) return res.status(404).send('Tier not found');
+    if (tier.price === 0) return res.status(400).send('This tier is free — no payment required');
+
+    res.send(`<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Upgrade to ${tier.name} — Lucille</title>
+  <script src="https://js.stripe.com/v3/"></script>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    body { min-height: 100vh; background: linear-gradient(135deg, #0d0d1a 0%, #1a0033 100%);
+      color: #e0d0ff; font-family: system-ui, sans-serif; display: flex;
+      align-items: center; justify-content: center; padding: 2rem; }
+    .card { background: rgba(20,0,40,.7); border: 1px solid rgba(167,139,250,.25);
+      border-radius: 12px; padding: 2rem; max-width: 440px; width: 100%; }
+    h1 { font-size: 1.4rem; color: #a78bfa; margin-bottom: .5rem; }
+    .price { font-size: 2rem; font-weight: 700; color: #e0d0ff; margin-bottom: 1.5rem; }
+    .field { margin-bottom: 1rem; }
+    label { display: block; font-size: .8rem; color: #a78bfa; margin-bottom: 4px; }
+    input { width: 100%; padding: 8px 10px; background: #0d001a;
+      border: 1px solid rgba(167,139,250,.3); border-radius: 6px;
+      color: #e0d0ff; font-size: .875rem; }
+    #payment-element { margin: 1rem 0; }
+    .btn { width: 100%; padding: 12px; background: #7c3aed; border: none;
+      border-radius: 8px; color: white; font-size: 1rem; cursor: pointer;
+      font-weight: 600; margin-top: .5rem; }
+    .btn:disabled { opacity: .5; cursor: not-allowed; }
+    #status { margin-top: 1rem; font-size: .875rem; min-height: 1.2em; }
+    .err { color: #f55; } .ok { color: #0e0; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <h1>Upgrade to ${tier.name}</h1>
+    <div class="price">$${(tier.price / 100).toFixed(2)}</div>
+
+    <div class="field" id="uuid-section">
+      <label>Your Lucille UUID</label>
+      <input id="user-uuid" placeholder="Paste your UUID here">
+      <div style="font-size:.75rem;color:#7060a0;margin-top:4px;">
+        Find it in your Lucille account settings.
+      </div>
+    </div>
+
+    <div id="stripe-section" style="display:none">
+      <div id="payment-element"></div>
+      <button class="btn" id="pay-btn">Pay $${(tier.price / 100).toFixed(2)}</button>
+    </div>
+    <button class="btn" id="intent-btn">Continue to payment →</button>
+    <div id="status"></div>
+  </div>
+
+<script>
+(function() {
+  var TIER_ID = ${JSON.stringify(tierId)};
+  var status = document.getElementById('status');
+  var intentBtn = document.getElementById('intent-btn');
+  var stripeSection = document.getElementById('stripe-section');
+  var uuidSection = document.getElementById('uuid-section');
+  var stripe, elements;
+
+  // Read window.params payees from URL
+  var searchParams = new URLSearchParams(window.location.search);
+  var clientPayees = [];
+  var payeeKey = searchParams.get('payee');
+  var payeeAmt = parseInt(searchParams.get('payeeAmount') || '0');
+  if (payeeKey && payeeAmt > 0) clientPayees.push({ pubKey: payeeKey, amount: payeeAmt });
+
+  intentBtn.addEventListener('click', function() {
+    var uuid = document.getElementById('user-uuid').value.trim();
+    if (!uuid) { status.textContent = 'Enter your UUID first.'; return; }
+    intentBtn.disabled = true; intentBtn.textContent = 'Setting up payment…';
+    fetch('/plugin/lucille/tier/intent', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ tierId: TIER_ID, userUuid: uuid, clientPayees: clientPayees })
+    })
+    .then(function(r) { return r.json(); })
+    .then(function(d) {
+      if (d.error) { status.innerHTML = '<span class="err">' + d.error + '</span>'; intentBtn.disabled = false; intentBtn.textContent = 'Continue to payment →'; return; }
+      stripe = Stripe(d.publishableKey);
+      elements = stripe.elements({ clientSecret: d.clientSecret });
+      var paymentEl = elements.create('payment');
+      paymentEl.mount('#payment-element');
+      uuidSection.style.display = 'none';
+      intentBtn.style.display = 'none';
+      stripeSection.style.display = 'block';
+    })
+    .catch(function(e) { status.innerHTML = '<span class="err">' + e.message + '</span>'; intentBtn.disabled = false; intentBtn.textContent = 'Continue to payment →'; });
+  });
+
+  document.getElementById('pay-btn').addEventListener('click', async function() {
+    var payBtn = document.getElementById('pay-btn');
+    payBtn.disabled = true; payBtn.textContent = 'Processing…';
+    var uuid = document.getElementById('user-uuid').value.trim() ||
+      (window._lucilleUuid || '');
+    var result = await stripe.confirmPayment({
+      elements,
+      confirmParams: { return_url: window.location.href },
+      redirect: 'if_required'
+    });
+    if (result.error) {
+      status.innerHTML = '<span class="err">' + result.error.message + '</span>';
+      payBtn.disabled = false; payBtn.textContent = 'Pay';
+      return;
+    }
+    var piId = result.paymentIntent && result.paymentIntent.id;
+    fetch('/plugin/lucille/tier/complete', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ paymentIntentId: piId, tierId: TIER_ID, userUuid: uuid })
+    })
+    .then(function(r) { return r.json(); })
+    .then(function(d) {
+      if (d.error) { status.innerHTML = '<span class="err">' + d.error + '</span>'; payBtn.disabled = false; return; }
+      status.innerHTML = '<span class="ok">✅ Upgrade complete! Your account has been upgraded to ${tier.name}.</span>';
+      stripeSection.style.display = 'none';
+    })
+    .catch(function(e) { status.innerHTML = '<span class="err">' + e.message + '</span>'; payBtn.disabled = false; });
+  });
+})();
+</script>
+</body>
+</html>`);
+  });
+
+  // Create payment intent for tier upgrade
+  app.post('/plugin/lucille/tier/intent', express_json_tier, async (req, res) => {
+    const { tierId, userUuid, clientPayees = [] } = req.body || {};
+    if (!tierId || !userUuid) return res.status(400).json({ error: 'tierId and userUuid required' });
+
+    const cfg = loadConfig();
+    const tier = (cfg.tiers || []).find(t => t.id === tierId);
+    if (!tier) return res.status(404).json({ error: 'Tier not found' });
+    if (tier.price === 0) return res.status(400).json({ error: 'This tier is free' });
+    if (!cfg.serverAddie || !cfg.serverAddie.uuid) {
+      return res.status(503).json({ error: 'Payment not configured — wiki owner has not set up Stripe' });
+    }
+
+    const addieUrl = getAddieUrl();
+    const amount = tier.price; // in cents
+
+    try {
+      // Create buyer Addie account
+      const buyerKeys = await generateAddieKeys();
+      const buyerUser = await addieCreateUser(addieUrl, buyerKeys);
+      if (buyerUser.error) return res.status(502).json({ error: 'Could not create buyer account' });
+
+      // Build payees — wiki owner receives full amount
+      let payees = [{ pubKey: cfg.serverAddie.pubKey, amount }];
+
+      // Subtract client payees (capped at 5% each) from owner's share
+      const maxPayeeAmount = Math.floor(amount * 0.05);
+      for (const p of clientPayees) {
+        if (!p.pubKey) continue;
+        const pAmount = Math.min(parseInt(p.amount) || 0, maxPayeeAmount);
+        if (pAmount <= 0) continue;
+        const ownerIdx = payees.findIndex(x => x.pubKey === cfg.serverAddie.pubKey);
+        if (ownerIdx >= 0 && payees[ownerIdx].amount - pAmount > 0) {
+          payees[ownerIdx].amount -= pAmount;
+          payees.push({ pubKey: p.pubKey, amount: pAmount });
+        }
+      }
+
+      const intentData = await addieCreatePaymentIntent(addieUrl, buyerKeys, buyerUser.uuid, amount, payees);
+      if (!intentData.clientSecret) return res.status(502).json({ error: 'Could not create payment intent' });
+
+      res.json({ clientSecret: intentData.clientSecret, publishableKey: intentData.publishableKey });
+    } catch (err) {
+      console.error('[lucille] tier/intent error:', err.message);
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // Payment complete — trigger transfers + upgrade user tier via lucille service
+  app.post('/plugin/lucille/tier/complete', express_json_tier, async (req, res) => {
+    const { paymentIntentId, tierId, userUuid } = req.body || {};
+    if (!paymentIntentId || !tierId || !userUuid) {
+      return res.status(400).json({ error: 'paymentIntentId, tierId, and userUuid required' });
+    }
+
+    const cfg = loadConfig();
+    const addieUrl = getAddieUrl();
+
+    // Fire-and-forget transfer trigger
+    fetch(`${addieUrl}/payment/${paymentIntentId}/process-transfers`, { method: 'POST' })
+      .catch(err => console.warn('[lucille] process-transfers error:', err.message));
+
+    // Upgrade user tier via lucille service (internal call)
+    try {
+      await fetch(`http://127.0.0.1:${LUCILLE_PORT}/user/${userUuid}/tier`, {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ tierId, paymentIntentId })
+      });
+    } catch (err) {
+      console.warn('[lucille] tier upgrade call to service failed:', err.message);
+    }
+
+    res.json({ success: true });
+  });
+
+  // ── Version management ──────────────────────────────────────────────────────
+
+  app.get('/plugin/lucille/version-status', async (req, res) => {
+    try {
+      const pkgPath = path.join(LUCILLE_PATH, 'package.json');
+      const installed = fs.existsSync(pkgPath)
+        ? JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version
+        : null;
+
+      let published = null;
+      try {
+        const npmRes = await fetch('https://registry.npmjs.org/lucille/latest');
+        published = (await npmRes.json()).version;
+      } catch {}
+
+      res.json({ installed, published, updateAvailable: installed && published && installed !== published });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  app.post('/plugin/lucille/update', (req, res) => {
+    const installDir = path.join(LUCILLE_PATH, '../..');
+    exec('npm install lucille@latest', { cwd: installDir }, (err, stdout, stderr) => {
+      if (err) return res.json({ success: false, error: stderr || err.message });
+      const pkgPath = path.join(LUCILLE_PATH, 'package.json');
+      const version = fs.existsSync(pkgPath)
+        ? JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version
+        : 'unknown';
+      res.json({ success: true, version });
+    });
+  });
+
+  // ── Freyja federation page ──────────────────────────────────────────────────
+
+  app.get('/plugin/lucille/federation', (req, res) => {
+    res.send(generateFederationPage('lucille'));
+  });
+
+  // ── Proxy all other lucille routes ──────────────────────────────────────────
+
+  app.all(/^\/plugin\/lucille\//, (req, res) => {
+    req.url = req.url.replace('/plugin/lucille', '');
+    proxy.web(req, res, { target: `http://127.0.0.1:${LUCILLE_PORT}`, changeOrigin: true });
+  });
+
+  app.all('/plugin/lucille', (req, res) => {
+    req.url = '/';
+    proxy.web(req, res, { target: `http://127.0.0.1:${LUCILLE_PORT}`, changeOrigin: true });
+  });
+
+  // ── Shutdown hooks ──────────────────────────────────────────────────────────
+
+  let isShuttingDown = false;
+  const handleShutdown = (signal) => {
+    if (isShuttingDown) return;
+    isShuttingDown = true;
+    console.log(`[wiki-plugin-lucille] ${signal} — shutting down lucille…`);
+    shutdownLucille();
+    setTimeout(() => console.log('[wiki-plugin-lucille] Shutdown complete'), 3000);
+  };
+
+  if (!process.lucilleShutdownRegistered) {
+    process.lucilleShutdownRegistered = true;
+    process.on('SIGINT',  () => handleShutdown('SIGINT'));
+    process.on('SIGTERM', () => handleShutdown('SIGTERM'));
+    process.on('exit',    () => { if (!isShuttingDown) shutdownLucille(); });
+  }
+
+  console.log('✅ wiki-plugin-lucille ready');
+  console.log(`   /plugin/lucille/* → http://127.0.0.1:${LUCILLE_PORT}/*`);
+  console.log(`   /plugin/lucille/setup → onboarding UI`);
+}
+
+// ── Minimal JSON body parser (avoids pulling in express) ─────────────────────
+
+function express_json() {
+  return (req, res, next) => {
+    if (req.headers['content-type'] !== 'application/json') return next();
+    let data = '';
+    req.on('data', chunk => { data += chunk; });
+    req.on('end', () => {
+      try { req.body = JSON.parse(data); } catch { req.body = {}; }
+      next();
+    });
+  };
+}
+
+// ── Setup page HTML ───────────────────────────────────────────────────────────
+
+function generateSetupPage(config) {
+  const configured = isConfigured(config);
+  const tiersJson  = JSON.stringify(config.tiers || [], null, 2);
+  const peersJson  = (config.federationPeers || []).join('\n');
+
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Lucille Setup</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body { font-family: system-ui, sans-serif; background: #0f0f0f; color: #e0e0e0; padding: 40px 24px; }
+    .container { max-width: 760px; margin: 0 auto; }
+    h1 { font-size: 1.8rem; color: #a78bfa; margin-bottom: 8px; }
+    .subtitle { color: #888; margin-bottom: 32px; font-size: 0.95rem; }
+    .status-badge { display: inline-block; padding: 4px 12px; border-radius: 20px; font-size: 0.85rem; font-weight: 600; margin-bottom: 32px; }
+    .status-badge.ok  { background: rgba(16,185,129,0.15); color: #10b981; border: 1px solid rgba(16,185,129,0.3); }
+    .status-badge.bad { background: rgba(239,68,68,0.15);  color: #ef4444; border: 1px solid rgba(239,68,68,0.3); }
+    .section { background: rgba(255,255,255,0.04); border: 1px solid rgba(255,255,255,0.08); border-radius: 12px; padding: 24px; margin-bottom: 24px; }
+    .section h2 { font-size: 1rem; font-weight: 600; color: #a78bfa; margin-bottom: 16px; padding-bottom: 8px; border-bottom: 1px solid rgba(255,255,255,0.08); }
+    .form-row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-bottom: 12px; }
+    .form-group { display: flex; flex-direction: column; gap: 4px; }
+    label { font-size: 0.82rem; color: #999; }
+    input, textarea { background: rgba(255,255,255,0.06); border: 1px solid rgba(255,255,255,0.12); border-radius: 6px; color: #e0e0e0; padding: 8px 10px; font-size: 0.9rem; width: 100%; outline: none; transition: border-color 0.2s; }
+    input:focus, textarea:focus { border-color: #a78bfa; }
+    textarea { font-family: monospace; font-size: 0.82rem; resize: vertical; }
+    .hint { font-size: 0.78rem; color: #666; margin-top: 4px; }
+    .save-btn { background: linear-gradient(135deg, #a78bfa, #7c3aed); color: white; border: none; border-radius: 8px; padding: 12px 32px; font-size: 1rem; font-weight: 600; cursor: pointer; transition: opacity 0.2s; }
+    .save-btn:hover { opacity: 0.85; }
+    .result { margin-top: 16px; padding: 12px 16px; border-radius: 8px; font-size: 0.9rem; display: none; }
+    .result.ok  { background: rgba(16,185,129,0.1);  border: 1px solid rgba(16,185,129,0.3); color: #10b981; }
+    .result.err { background: rgba(239,68,68,0.1);   border: 1px solid rgba(239,68,68,0.3);  color: #ef4444; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>🎬 Lucille Setup</h1>
+    <p class="subtitle">P2P video hosting for your federated wiki</p>
+    <div class="status-badge ${configured ? 'ok' : 'bad'}">
+      ${configured ? '● Configured' : '○ Not configured — complete setup below'}
+    </div>
+
+    <form id="setup-form">
+
+      <div class="section">
+        <h2>DigitalOcean Spaces</h2>
+        <div class="form-row">
+          <div class="form-group">
+            <label>Access Key</label>
+            <input name="spacesKey" type="password" value="${configured ? '••••••••' : ''}" placeholder="DO Spaces access key">
+          </div>
+          <div class="form-group">
+            <label>Secret Key</label>
+            <input name="spacesSecret" type="password" value="${configured ? '••••••••' : ''}" placeholder="DO Spaces secret key">
+          </div>
+        </div>
+        <div class="form-row">
+          <div class="form-group">
+            <label>Region</label>
+            <input name="spacesRegion" value="${config.spacesRegion || 'nyc3'}" placeholder="nyc3">
+          </div>
+          <div class="form-group">
+            <label>Bucket Name</label>
+            <input name="spacesBucket" value="${config.spacesBucket || ''}" placeholder="my-wiki-videos">
+          </div>
+        </div>
+        <div class="form-group">
+          <label>CDN Endpoint (optional)</label>
+          <input name="spacesCdnEndpoint" value="${config.spacesCdnEndpoint || ''}" placeholder="https://my-wiki-videos.nyc3.cdn.digitaloceanspaces.com">
+          <div class="hint">Enable CDN in your Spaces settings for faster initial delivery.</div>
+        </div>
+      </div>
+
+      <div class="section">
+        <h2>Tracker</h2>
+        <div class="form-row">
+          <div class="form-group">
+            <label>Tracker Port</label>
+            <input name="trackerPort" type="number" value="${config.trackerPort || 8000}" placeholder="8000">
+            <div class="hint">Must be open in your firewall for federation to work.</div>
+          </div>
+          <div class="form-group">
+            <label>Public Hostname (for federation)</label>
+            <input name="trackerHost" value="${config.trackerHost || ''}" placeholder="mywiki.example.com">
+            <div class="hint">How other wikis reach your tracker. Leave blank for localhost-only.</div>
+          </div>
+        </div>
+      </div>
+
+      <div class="section">
+        <h2>Tiers</h2>
+        <p class="hint" style="margin-bottom:12px">Define storage and video limits per tier. Price is in MAGIC Points (MP). Set storageLimit/videoLimit/durationLimit to 0 for unlimited.</p>
+        <div class="form-group">
+          <label>Tier definitions (JSON)</label>
+          <textarea name="tiers" rows="18">${tiersJson}</textarea>
+        </div>
+      </div>
+
+      <div class="section">
+        <h2>Federation Peers</h2>
+        <p class="hint" style="margin-bottom:12px">Enter the base URL of each peer lucille instance (one per line). Your tracker will be added to their announce lists and vice versa.</p>
+        <div class="form-group">
+          <label>Peer lucille URLs</label>
+          <textarea name="federationPeers" rows="4" placeholder="https://otherwiki.example.com/plugin/lucille&#10;https://anotherwiki.example.com/plugin/lucille">${peersJson}</textarea>
+        </div>
+      </div>
+
+      <div class="section">
+        <h2>Allyabase</h2>
+        <div class="form-group">
+          <label>Allyabase URL (for tier upgrade payments)</label>
+          <input name="allyabaseUrl" value="${config.allyabaseUrl || (config.sanoraUrl ? config.sanoraUrl.replace(/\/plugin\/allyabase\/sanora$/, '') : '')}" placeholder="https://dev.allyabase.com">
+        </div>
+      </div>
+
+      <button type="submit" class="save-btn">Save & Start Lucille</button>
+      <div class="result" id="result"></div>
+
+    </form>
+  </div>
+
+  <script>
+    document.getElementById('setup-form').addEventListener('submit', async (e) => {
+      e.preventDefault();
+      const btn = e.target.querySelector('.save-btn');
+      const resultEl = document.getElementById('result');
+      btn.textContent = 'Saving…';
+      btn.disabled = true;
+
+      const data = Object.fromEntries(new FormData(e.target));
+
+      // Parse tiers JSON
+      try { data.tiers = JSON.parse(data.tiers); } catch {
+        resultEl.className = 'result err';
+        resultEl.style.display = 'block';
+        resultEl.textContent = 'Invalid JSON in Tiers field';
+        btn.textContent = 'Save & Start Lucille';
+        btn.disabled = false;
+        return;
+      }
+
+      // Parse federation peers (one per line)
+      data.federationPeers = (data.federationPeers || '').split('\\n').map(s => s.trim()).filter(Boolean);
+
+      try {
+        const res = await fetch('/plugin/lucille/setup', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(data)
+        });
+        const result = await res.json();
+        resultEl.className = 'result ' + (result.success ? 'ok' : 'err');
+        resultEl.style.display = 'block';
+        resultEl.textContent = result.message || result.error || JSON.stringify(result);
+      } catch (err) {
+        resultEl.className = 'result err';
+        resultEl.style.display = 'block';
+        resultEl.textContent = err.message;
+      }
+
+      btn.textContent = 'Save & Start Lucille';
+      btn.disabled = false;
+    });
+  </script>
+</body>
+</html>`;
+}
+
+module.exports = { startServer };
+}).call(this);