lore-memory 0.1.1 → 0.3.0

package/src/ui/public/style.css

@@ -0,0 +1,321 @@
+:root {
+  --bg-color: #050505;
+  --panel-bg: #111111;
+  --text-main: #00FF41; /* CRT Green */
+  --text-muted: #008F11;
+  --accent-decision: #00FFFF; /* Cyan */
+  --accent-invariant: #FF003C; /* Red */
+  --accent-gotcha: #FFB000; /* Amber */
+  --accent-graveyard: #555555;
+  --border: 1px solid #008F11;
+  --font-pixel: 'Press Start 2P', cursive;
+  --font-code: 'Fira Code', 'Courier New', monospace;
+  --glitch-offset: 2px;
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  background-color: var(--bg-color);
+  color: var(--text-main);
+  font-family: var(--font-code);
+  font-size: 14px;
+  line-height: 1.6;
+  overflow: hidden; /* App feels like a terminal */
+}
+
+/* CRT Scanline Overlay Effect */
+.crt-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100vw;
+  height: 100vh;
+  background: linear-gradient(rgba(18, 16, 16, 0) 50%, rgba(0, 0, 0, 0.25) 50%), linear-gradient(90deg, rgba(255, 0, 0, 0.06), rgba(0, 255, 0, 0.02), rgba(0, 0, 255, 0.06));
+  background-size: 100% 4px, 3px 100%;
+  pointer-events: none;
+  z-index: 999;
+}
+
+/* Layout */
+.layout {
+  display: flex;
+  height: 100vh;
+}
+
+/* Sidebar */
+.sidebar {
+  width: 350px;
+  background-color: var(--panel-bg);
+  border-right: var(--border);
+  padding: 30px;
+  display: flex;
+  flex-direction: column;
+}
+
+.logo pre {
+  font-family: monospace;
+  color: var(--text-main);
+  font-size: 8px; /* Fit the ASCII art */
+  white-space: pre;
+  margin-bottom: 5px;
+  line-height: 1.2;
+}
+
+.subtitle {
+  font-family: var(--font-code);
+  color: var(--text-muted);
+  font-size: 12px;
+  letter-spacing: 2px;
+  margin-bottom: 40px;
+  text-align: center;
+}
+
+.nav-links {
+  list-style: none;
+}
+
+.nav-links li {
+  margin-bottom: 15px;
+}
+
+.nav-links a {
+  color: var(--text-muted);
+  text-decoration: none;
+  font-family: var(--font-pixel);
+  font-size: 10px;
+  display: block;
+  padding: 10px;
+  border: 1px solid transparent;
+  transition: all 0.2s ease;
+}
+
+.nav-links a:hover, .nav-links a.active {
+  color: var(--bg-color);
+  background-color: var(--text-main);
+  border: 1px solid var(--text-main);
+  box-shadow: 0 0 10px var(--text-main);
+}
+
+/* Main Content Area */
+.content {
+  flex: 1;
+  padding: 40px;
+  overflow-y: auto;
+  position: relative;
+}
+
+.view {
+  display: none;
+  animation: flicker 0.15s ease-in 1;
+}
+
+.view.active {
+  display: block;
+}
+
+h1 {
+  font-family: var(--font-pixel);
+  font-size: 24px;
+  margin-bottom: 30px;
+  color: var(--text-main);
+  text-shadow: 0 0 5px var(--text-main);
+}
+
+/* Dashboard Score Components */
+.score-card {
+  border: var(--border);
+  padding: 40px;
+  text-align: center;
+  margin-bottom: 30px;
+  background: repeating-linear-gradient(
+    45deg,
+    transparent,
+    transparent 10px,
+    rgba(0, 143, 17, 0.05) 10px,
+    rgba(0, 143, 17, 0.05) 20px
+  );
+}
+
+.main-score {
+  font-family: var(--font-pixel);
+  font-size: 64px;
+  text-shadow: 0 0 15px var(--text-main);
+}
+
+.muted {
+  font-size: 24px;
+  color: var(--text-muted);
+}
+
+.metrics-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr 1fr;
+  gap: 20px;
+  margin-bottom: 40px;
+}
+
+.metric h3 {
+  font-family: var(--font-pixel);
+  font-size: 10px;
+  margin-bottom: 15px;
+  color: var(--text-muted);
+}
+
+.progress-bar {
+  height: 20px;
+  border: var(--border);
+  padding: 2px;
+  margin-bottom: 10px;
+}
+
+.progress-bar .fill {
+  height: 100%;
+  background-color: var(--text-main);
+  width: 0%;
+  transition: width 1s ease-out;
+}
+
+.tips-container {
+  border-top: var(--border);
+  padding-top: 20px;
+}
+
+.terminal-list {
+  list-style: none;
+}
+.terminal-list li::before {
+  content: "> ";
+  color: var(--accent-gotcha);
+}
+
+/* Knowledge Base Entries */
+.controls {
+  display: flex;
+  gap: 15px;
+  margin-bottom: 20px;
+}
+
+input, select, button {
+  background: var(--bg-color);
+  color: var(--text-main);
+  border: var(--border);
+  padding: 10px;
+  font-family: var(--font-code);
+  font-size: 14px;
+}
+
+input:focus, select:focus {
+  outline: none;
+  box-shadow: 0 0 8px var(--text-muted);
+}
+
+.entries-grid, .drafts-container {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+}
+
+.entry-card {
+  border: var(--border);
+  padding: 20px;
+  background-color: rgba(17, 17, 17, 0.8);
+}
+
+.entry-header {
+  display: flex;
+  justify-content: space-between;
+  border-bottom: 1px dashed var(--text-muted);
+  padding-bottom: 10px;
+  margin-bottom: 15px;
+}
+
+.type-badge {
+  font-family: var(--font-pixel);
+  font-size: 10px;
+  padding: 4px 8px;
+}
+
+.type-decision { color: var(--bg-color); background-color: var(--accent-decision); }
+.type-invariant { color: var(--bg-color); background-color: var(--accent-invariant); }
+.type-gotcha { color: var(--bg-color); background-color: var(--accent-gotcha); }
+.type-graveyard { color: var(--text-main); background-color: var(--accent-graveyard); }
+
+.entry-title {
+  font-weight: bold;
+  font-size: 16px;
+  margin-bottom: 10px;
+}
+
+.entry-meta {
+  color: var(--text-muted);
+  font-size: 12px;
+  margin-top: 15px;
+}
+
+/* Draft Specifics */
+.draft-actions {
+  display: flex;
+  gap: 10px;
+  margin-top: 15px;
+}
+
+.btn {
+  cursor: pointer;
+  font-family: var(--font-pixel);
+  font-size: 8px;
+  text-transform: uppercase;
+  transition: all 0.2s;
+}
+
+.btn-accept {
+  border-color: var(--text-main);
+  color: var(--text-main);
+}
+.btn-accept:hover { background: var(--text-main); color: var(--bg-color); }
+
+.btn-delete {
+  border-color: var(--accent-invariant);
+  color: var(--accent-invariant);
+}
+.btn-delete:hover { background: var(--accent-invariant); color: var(--bg-color); }
+
+/* Graph Container */
+#network-container {
+  width: 100%;
+  height: 600px;
+  border: var(--border);
+  background-color: var(--panel-bg);
+}
+
+/* Animations */
+@keyframes flicker {
+  0% { opacity: 0; }
+  10% { opacity: 0.5; }
+  20% { opacity: 0; }
+  50% { opacity: 1; }
+  60% { opacity: 0.8; }
+  100% { opacity: 1; }
+}
+
+.toast {
+  position: fixed;
+  bottom: 20px;
+  right: 20px;
+  background-color: var(--text-main);
+  color: var(--bg-color);
+  padding: 15px 30px;
+  font-family: var(--font-code);
+  font-weight: bold;
+  border: 1px solid white;
+  z-index: 1000;
+  transition: opacity 0.3s;
+}
+.toast.hidden {
+  opacity: 0;
+  pointer-events: none;
+}

package/src/watcher/comments.js

@@ -47,11 +47,11 @@ function extractComments(code, filePath) {
  * Saves passing comments as drafts.
  * @param {string} absFilePath
  * @param {string} projectRoot
- * @returns {object[]} created drafts
+ * @returns {Promise<object[]>} created drafts
  */
-function mineFile(absFilePath, projectRoot) {
+async function mineFile(absFilePath, projectRoot) {
   let code = '';
-  try { code = fs.readFileSync(absFilePath, 'utf8'); } catch (e) { return []; }
+  try { code = await fs.readFile(absFilePath, 'utf8'); } catch (e) { return []; }
 
   const relativePath = path.relative(projectRoot, absFilePath).replace(/\\/g, '/');
   const comments = extractComments(code, absFilePath);
@@ -92,7 +92,7 @@ function mineFile(absFilePath, projectRoot) {
  * @param {string[]} ignore
  * @returns {number} total drafts created
  */
-function mineDirectory(absDirPath, projectRoot, ignore) {
+async function mineDirectory(absDirPath, projectRoot, ignore) {
   const { globSync } = require('glob');
   const ignoreList = ignore || ['node_modules', 'dist', '.git', '.lore', 'coverage'];
   const ignorePats = ignoreList.map(i => `${i}/**`);
@@ -105,7 +105,8 @@ function mineDirectory(absDirPath, projectRoot, ignore) {
 
   let total = 0;
   for (const file of files) {
-    total += mineFile(file, projectRoot).length;
+    const drafts = await mineFile(file, projectRoot);
+    total += drafts.length;
   }
   return total;
 }

package/src/watcher/index.js

@@ -29,9 +29,9 @@ function startWatcher(options = {}) {
 
   const log = options.logFile
     ? (msg) => {
-        const plain = msg.replace(/\x1B\[[0-9;]*m/g, '');
-        fs.appendFileSync(options.logFile, `${new Date().toISOString()} ${plain}\n`);
-      }
+      const plain = msg.replace(/\x1B\[[0-9;]*m/g, '');
+      fs.appendFileSync(options.logFile, `${new Date().toISOString()} ${plain}\n`);
+    }
     : (msg) => console.log(msg);
 
   if (!options.quiet) {
@@ -56,46 +56,46 @@ function startWatcher(options = {}) {
     awaitWriteFinish: { stabilityThreshold: 500, pollInterval: 100 },
   });
 
-  watcher.on('unlink', (relPath) => {
+  watcher.on('unlink', async (relPath) => {
     const abs = path.join(projectRoot, relPath);
-    const draft = signals.onFileDeletion(abs, projectRoot);
+    const draft = await signals.onFileDeletion(abs, projectRoot);
     if (draft) recordDraft(draft, abs);
   });
 
-  watcher.on('unlinkDir', (relPath) => {
+  watcher.on('unlinkDir', async (relPath) => {
     const abs = path.join(projectRoot, relPath);
-    const draft = signals.onDirectoryDeletion(abs, projectRoot);
+    const draft = await signals.onDirectoryDeletion(abs, projectRoot);
     if (draft) recordDraft(draft, abs);
   });
 
-  watcher.on('add', (relPath) => {
+  watcher.on('add', async (relPath) => {
     const abs = path.join(projectRoot, relPath);
-    const draft = signals.onNewFile(abs, projectRoot);
+    const draft = await signals.onNewFile(abs, projectRoot);
     if (draft) recordDraft(draft, abs);
   });
 
-  watcher.on('change', (relPath) => {
+  watcher.on('change', async (relPath) => {
     const abs = path.join(projectRoot, relPath);
 
     // Repeated edit tracking
-    const editDraft = signals.trackFileEdit(abs, projectRoot);
+    const editDraft = await signals.trackFileEdit(abs, projectRoot);
     if (editDraft) recordDraft(editDraft, abs);
 
     // package.json changes
     if (relPath.endsWith('package.json')) {
-      const pkgDrafts = signals.onPackageJsonChange(abs, projectRoot);
+      const pkgDrafts = await signals.onPackageJsonChange(abs, projectRoot);
       for (const d of pkgDrafts) recordDraft(d, abs);
     }
 
     // Comment mining + graph update for source files
     if (/\.(js|ts|jsx|tsx|py|go|rs)$/.test(relPath)) {
-      const commentDrafts = mineFile(abs, projectRoot);
+      const commentDrafts = await mineFile(abs, projectRoot);
       if (commentDrafts.length > 0) {
         draftCount += commentDrafts.length;
         log(`${chalk.dim(`[${timestamp()}]`)} Mined ${commentDrafts.length} comment${commentDrafts.length === 1 ? '' : 's'} from ${chalk.yellow(relPath)} — queued for review`);
       }
 
-      try { updateGraphForFile(abs, projectRoot); } catch (e) {}
+      try { updateGraphForFile(abs, projectRoot); } catch (e) { }
     }
   });
 
@@ -104,15 +104,15 @@ function startWatcher(options = {}) {
   let gitWatcher = null;
   if (fs.existsSync(path.join(projectRoot, '.git'))) {
     gitWatcher = chokidar.watch(commitMsgPath, { persistent: true, ignoreInitial: true });
-    gitWatcher.on('change', () => {
+    gitWatcher.on('change', async () => {
       try {
-        const message = fs.readFileSync(commitMsgPath, 'utf8').trim();
-        const drafts = signals.onCommitMessage(message, projectRoot);
+        const message = await fs.readFile(commitMsgPath, 'utf8');
+        const drafts = await signals.onCommitMessage(message.trim(), projectRoot);
         for (const d of drafts) {
           draftCount++;
           log(`${chalk.dim(`[${timestamp()}]`)} Commit signal: "${message.slice(0, 60)}" — queued for review`);
         }
-      } catch (e) {}
+      } catch (e) { }
     });
   }
 

package/src/watcher/signals.js

@@ -22,7 +22,7 @@ function makeDraft(overrides) {
   };
 }
 
-function onFileDeletion(filepath, projectRoot) {
+async function onFileDeletion(filepath, projectRoot) {
   const relativePath = path.relative(projectRoot, filepath).replace(/\\/g, '/');
 
   // Try to check line count via git
@@ -32,7 +32,7 @@ function onFileDeletion(filepath, projectRoot) {
       encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
     });
     lines = parseInt(out.trim(), 10) || 0;
-  } catch (e) {}
+  } catch (e) { }
 
   if (lines > 0 && lines < 100) return null;
 
@@ -48,7 +48,7 @@ function onFileDeletion(filepath, projectRoot) {
   return draft;
 }
 
-function onDirectoryDeletion(dirpath, projectRoot) {
+async function onDirectoryDeletion(dirpath, projectRoot) {
   const relativePath = path.relative(projectRoot, dirpath).replace(/\\/g, '/');
   const name = path.basename(relativePath);
   const draft = makeDraft({
@@ -62,7 +62,7 @@ function onDirectoryDeletion(dirpath, projectRoot) {
   return draft;
 }
 
-function onNewFile(filepath, projectRoot) {
+async function onNewFile(filepath, projectRoot) {
   const relativePath = path.relative(projectRoot, filepath).replace(/\\/g, '/');
   const name = path.basename(relativePath);
   const lower = name.toLowerCase();
@@ -97,7 +97,7 @@ function onNewFile(filepath, projectRoot) {
   return null;
 }
 
-function onPackageJsonChange(filepath, projectRoot) {
+async function onPackageJsonChange(filepath, projectRoot) {
   const relativePath = path.relative(projectRoot, filepath).replace(/\\/g, '/');
   if (!relativePath.endsWith('package.json')) return [];
 
@@ -108,9 +108,9 @@ function onPackageJsonChange(filepath, projectRoot) {
       encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
     });
     prev = JSON.parse(prevRaw);
-  } catch (e) {}
+  } catch (e) { }
 
-  try { curr = fs.readJsonSync(filepath); } catch (e) { return []; }
+  try { curr = await fs.readJson(filepath); } catch (e) { return []; }
 
   const prevDeps = Object.assign({}, prev.dependencies || {}, prev.devDependencies || {});
   const currDeps = Object.assign({}, curr.dependencies || {}, curr.devDependencies || {});
@@ -143,7 +143,7 @@ function onPackageJsonChange(filepath, projectRoot) {
   return drafts;
 }
 
-function onCommitMessage(message, projectRoot) {
+async function onCommitMessage(message, projectRoot) {
   const lower = message.toLowerCase();
   const signals = [
     { re: /\b(replac|switch(ed|ing)|migrat)\b/, type: 'decision', confidence: 0.8 },
@@ -171,12 +171,12 @@ function onCommitMessage(message, projectRoot) {
 }
 
 // Track repeated edits to detect gotcha-worthy files
-function trackFileEdit(filepath, projectRoot) {
+async function trackFileEdit(filepath, projectRoot) {
   const relativePath = path.relative(projectRoot, filepath).replace(/\\/g, '/');
   const statePath = path.join(LORE_DIR, 'watch-state.json');
 
   let state = { edits: {} };
-  try { state = fs.readJsonSync(statePath); } catch (e) {}
+  try { state = await fs.readJson(statePath); } catch (e) { }
   if (!state.edits) state.edits = {};
 
   const now = Date.now();
@@ -186,7 +186,7 @@ function trackFileEdit(filepath, projectRoot) {
   state.edits[relativePath].push(now);
   state.edits[relativePath] = state.edits[relativePath].filter(t => t > weekAgo);
 
-  try { fs.writeJsonSync(statePath, state, { spaces: 2 }); } catch (e) {}
+  try { await fs.writeJson(statePath, state, { spaces: 2 }); } catch (e) { }
 
   if (state.edits[relativePath].length >= 5) {
     const name = path.basename(relativePath);
@@ -201,7 +201,7 @@ function trackFileEdit(filepath, projectRoot) {
     saveDraft(draft);
     // Reset to avoid spam
     state.edits[relativePath] = [];
-    try { fs.writeJsonSync(statePath, state, { spaces: 2 }); } catch (e) {}
+    try { await fs.writeJson(statePath, state, { spaces: 2 }); } catch (e) { }
     return draft;
   }
   return null;