@cccarv82/freya 1.0.23 → 1.0.25

package/cli/web-ui.js

@@ -107,7 +107,14 @@
   function setOut(text) {
     state.lastText = text || '';
     const el = $('reportPreview');
-    if (el) el.innerHTML = renderMarkdown(state.lastText);
+    if (!el) return;
+    try {
+      el.innerHTML = renderMarkdown(state.lastText);
+    } catch (e) {
+      // Fallback: never hide the error/output if markdown rendering breaks
+      try { console.error('renderMarkdown failed:', e); } catch {}
+      el.textContent = state.lastText;
+    }
   }
 
   function clearOut() {
@@ -218,10 +225,21 @@
       headers: body ? { 'Content-Type': 'application/json' } : {},
       body: body ? JSON.stringify(body) : undefined
     });
-    const json = await res.json();
+
+    // Read as text first so we can surface errors even if backend returns HTML/plaintext
+    const raw = await res.text();
+    let json = null;
+    try {
+      json = raw ? JSON.parse(raw) : {};
+    } catch (e) {
+      const snippet = (raw || '').slice(0, 1200);
+      throw new Error(`Non-JSON response (${res.status} ${res.statusText}) from ${p}:\n\n${snippet}`);
+    }
+
     if (!res.ok) {
       const detail = json.details ? ('\n' + json.details) : '';
-      throw new Error((json.error || 'Request failed') + detail);
+      const err = (json.error || `Request failed (${res.status})`) + detail;
+      throw new Error(err);
     }
     return json;
   }
@@ -341,7 +359,8 @@
       setPill('ok', 'init ok');
     } catch (e) {
       setPill('err', 'init failed');
-      setOut(String(e && e.message ? e.message : e));
+      const msg = e && (e.stack || e.message) ? (e.stack || e.message) : String(e);
+      setOut(msg);
     }
   }
 

package/cli/web.js

@@ -266,6 +266,65 @@ function redactSecrets(text) {
   return out;
 }
 
+function debugLogPath(workspaceDir) {
+  const dir = path.join(workspaceDir, '.debuglogs');
+  try { fs.mkdirSync(dir, { recursive: true }); } catch {}
+  return path.join(dir, 'debug.jsonl');
+}
+
+function safeString(v, max = 2000) {
+  const t = String(v == null ? '' : v);
+  return t.length > max ? (t.slice(0, max) + '…') : t;
+}
+
+function summarizePayload(payload) {
+  if (!payload || typeof payload !== 'object') return null;
+  const keys = Object.keys(payload);
+  const summary = { keys };
+
+  if (typeof payload.text === 'string') {
+    const red = redactSecrets(payload.text);
+    summary.textLen = payload.text.length;
+    summary.textSha1 = sha1(red);
+  }
+
+  if (typeof payload.plan === 'string') {
+    summary.planLen = payload.plan.length;
+    summary.planSha1 = sha1(payload.plan);
+  }
+
+  if (typeof payload.webhookUrl === 'string') {
+    summary.webhookHost = (() => { try { return new URL(payload.webhookUrl).host; } catch { return null; } })();
+  }
+
+  if (typeof payload.relPath === 'string') summary.relPath = payload.relPath;
+  if (typeof payload.script === 'string') summary.script = payload.script;
+
+  return summary;
+}
+
+function rotateDebugLog(filePath, maxBytes = 5 * 1024 * 1024) {
+  try {
+    if (!fs.existsSync(filePath)) return;
+    const st = fs.statSync(filePath);
+    if (st.size <= maxBytes) return;
+    const dir = path.dirname(filePath);
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const rotated = path.join(dir, 'debug-' + stamp + '.jsonl');
+    fs.renameSync(filePath, rotated);
+  } catch {}
+}
+
+function writeDebugEvent(workspaceDir, event) {
+  try {
+    if (!workspaceDir) return;
+    const filePath = debugLogPath(workspaceDir);
+    rotateDebugLog(filePath);
+    const line = JSON.stringify({ ts: new Date().toISOString(), ...event });
+    fs.appendFileSync(filePath, line + '\n', 'utf8');
+  } catch {}
+}
+
 async function publishRobust(webhookUrl, text, opts = {}) {
   const u = new URL(webhookUrl);
   const isDiscord = u.hostname.includes('discord.com') || u.hostname.includes('discordapp.com');
@@ -282,6 +341,25 @@ async function publishRobust(webhookUrl, text, opts = {}) {
 
 function safeJson(res, code, obj) {
   const body = JSON.stringify(obj);
+
+  try {
+    const dbg = res && res.__freyaDebug;
+    if (dbg && dbg.workspaceDir) {
+      const error = obj && (obj.error || obj.details)
+        ? safeString(redactSecrets(JSON.stringify({ error: obj.error, details: obj.details })), 1600)
+        : null;
+      writeDebugEvent(dbg.workspaceDir, {
+        type: 'http_response',
+        reqId: dbg.reqId,
+        method: dbg.method,
+        url: dbg.url,
+        status: code,
+        bytes: Buffer.byteLength(body),
+        error
+      });
+    }
+  } catch {}
+
   res.writeHead(code, {
     'Content-Type': 'application/json; charset=utf-8',
     'Cache-Control': 'no-store',
@@ -766,10 +844,13 @@ async function cmdWeb({ port, dir, open, dev }) {
   const host = '127.0.0.1';
 
   const server = http.createServer(async (req, res) => {
+    const reqId = Math.random().toString(16).slice(2) + Date.now().toString(16);
+    res.__freyaDebug = { reqId, method: req.method, url: req.url || '' };
     try {
       if (!req.url) return safeJson(res, 404, { error: 'Not found' });
 
       if (req.method === 'GET' && req.url === '/') {
+        try { res.__freyaDebug.workspaceDir = normalizeWorkspaceDir(dir || './freya'); } catch {}
         const body = html(dir || './freya');
         res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store' });
         res.end(body);
@@ -797,6 +878,18 @@ async function cmdWeb({ port, dir, open, dev }) {
         const requestedDir = payload.dir || dir || './freya';
         const workspaceDir = normalizeWorkspaceDir(requestedDir);
 
+        // debug logging (always on)
+        try {
+          res.__freyaDebug.workspaceDir = workspaceDir;
+          writeDebugEvent(workspaceDir, {
+            type: 'http_request',
+            reqId,
+            method: req.method,
+            url: req.url,
+            payload: summarizePayload(payload)
+          });
+        } catch {}
+
         if (req.url === '/api/pick-dir') {
           const picked = await pickDirectoryNative();
           return safeJson(res, 200, { dir: picked });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cccarv82/freya",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "Personal AI Assistant with local-first persistence",
   "scripts": {
     "health": "node scripts/validate-data.js",