@quark.clip/quark 1.1.1 → 1.3.0

package/README.md

@@ -30,6 +30,7 @@ The operating system clipboard is fundamentally broken and stuck in the past:
 - **Heals** broken PDF text automatically.
 - **Strips** tracking parameters from URLs.
 - **Transforms** raw Excel data, Markdown, and LaTeX into clean, rich HTML.
+- **Omni-Context Engine**: Detects the active target app (Notion, Obsidian, VS Code, Pages) and dynamically shifts clipboard flavors (Markdown, HTML, RTF) to ensure flawless structure on every paste.
 - **Syncs** across your Mac, Windows, and Linux machines instantly via P2P.
 - **Exposes** your clipboard to local AI models via MCP.
 

package/cli/bin/quark.js

@@ -11,6 +11,29 @@ const pidFile = path.join(__dirname, '../quark.pid');
 const logFile = path.join(__dirname, '../quark.log');
 
 switch (command) {
+  case 'run':
+    console.log(`
+      o-------o
+      | \\   / |
+      |   o   |
+      | /   \\ |
+      o-------o
+    `);
+    console.log('🚀 Starting Quark Daemon (Foreground Session)...');
+    console.log('💡 Press Ctrl+C to stop. Logs will appear below:');
+    require(daemonPath);
+    break;
+
+  case 'logs':
+    if (fs.existsSync(logFile)) {
+      console.log('📜 Tailing Quark logs... (Press Ctrl+C to exit)');
+      const tail = spawn('tail', ['-f', logFile], { stdio: 'inherit' });
+      tail.on('exit', () => process.exit(0));
+    } else {
+      console.log('⚠️ No log file found at ' + logFile);
+    }
+    break;
+
   case 'start':
     console.log(`
       o-------o
@@ -64,7 +87,7 @@ switch (command) {
     console.log(`\n🌌 Quark Status`);
     console.log(`----------------`);
     console.log(`Manual Session: ${isRunning ? '🟢 Running' : '🔴 Stopped'}`);
-    
+
     // Check OS Service Status
     const os = require('os');
     const platform = os.platform();
@@ -92,7 +115,7 @@ switch (command) {
     } catch (e) {
       // Ignore errors from execSync if service is not running
     }
-    
+
     console.log(`OS Service:     ${serviceRunning ? '🟢 Installed & Running' : '🔴 Not Installed / Stopped'}`);
     console.log(`\nLog file: ${logFile}`);
     if (!serviceRunning) {
@@ -112,6 +135,8 @@ switch (command) {
 Usage:
   quark start      Start the daemon in the background (current session)
   quark stop       Stop the manually started daemon
+  quark run        Start the daemon in the foreground (live logs)
+  quark logs       Tail the background daemon logs
   quark install    Install Quark as a native OS background service (Auto-start on boot)
   quark uninstall  Remove the native OS background service
   quark status     Check daemon status

package/cli/src/clipboard.js

@@ -9,9 +9,16 @@ function read() {
     if (platform === 'darwin') {
       text = execSync('pbpaste', { encoding: 'utf8' }).toString();
       try {
-        const hex = execSync(`osascript -e 'the clipboard as "HTML"' 2>/dev/null`, { encoding: 'utf8' });
-        const match = hex.match(/«data HTML([0-9A-F]+)»/i);
-        if (match) html = Buffer.from(match[1], 'hex').toString('utf8');
+        const jxa = `
+          ObjC.import("AppKit");
+          var pb = $.NSPasteboard.generalPasteboard;
+          var html = pb.stringForType("public.html");
+          if (html) { html.js; } else { ""; }
+        `;
+        const raw = execSync(`osascript -l JavaScript -e '${jxa.replace(/\n/g, ' ')}' 2>/dev/null`, { encoding: 'utf8' });
+        if (raw && raw.trim() !== '') {
+          html = raw;
+        }
       } catch (e) { }
     } else if (platform === 'linux') {
       text = execSync('xclip -selection clipboard -o', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).toString();
@@ -86,4 +93,15 @@ function writeText(text) {
   } catch (e) { console.error('Error setting clipboard text:', e.message); }
 }
 
-module.exports = { read, writeHtml, writeText };
+function getActiveApp() {
+  try {
+    const platform = os.platform();
+    if (platform === 'darwin') {
+      const jxa = `ObjC.import("AppKit"); $.NSWorkspace.sharedWorkspace.frontmostApplication.localizedName.js;`;
+      return execSync(`osascript -l JavaScript -e '${jxa}' 2>/dev/null`, { encoding: 'utf8' }).trim();
+    }
+  } catch (e) { }
+  return null;
+}
+
+module.exports = { read, writeHtml, writeText, getActiveApp };

package/cli/src/daemon.js

@@ -6,6 +6,8 @@ const http = require('http');
 console.log('🌌 Quark Daemon Started at', new Date().toISOString());
 
 let lastClip = clipboard.read();
+let lastActiveApp = clipboard.getActiveApp();
+let lastProcessedResult = null;
 let isSyncingFromNetwork = false;
 
 // Initialize P2P Network
@@ -101,19 +103,31 @@ const pollInterval = setInterval(async () => {
       hasHtml: !!currentClip.html
     });
 
-    // Process through transformers
-    const result = await transformers.processClipboard(currentClip.text, currentClip.html);
+    const activeApp = clipboard.getActiveApp();
+    if (activeApp !== lastActiveApp) {
+      logEvent('INFO', `Active App changed: ${activeApp}`);
+      // JIT Injection: If we have a cached result, re-optimize for the new app
+      if (lastProcessedResult) {
+        writeGuard = true;
+        injectForTarget(activeApp, lastProcessedResult);
+      }
+      lastActiveApp = activeApp;
+    }
+
+    // Process through transformers with context
+    const result = await transformers.processClipboard(currentClip.text, currentClip.html, activeApp);
 
-    if (result.changed) {
-      logEvent('TRANSFORM', result.skipReason || 'Applying transformations');
-      writeGuard = true;
-      if (result.html) {
-        clipboard.writeHtml(result.html, result.text);
-      } else {
-        clipboard.writeText(result.text);
+    if (result.changed || result.markdown) {
+      lastProcessedResult = result;
+
+      if (result.changed) {
+        logEvent('TRANSFORM', result.skipReason || 'Applying transformations');
+        writeGuard = true;
+        injectForTarget(activeApp, result);
+
+        lastClip = clipboard.read(); // Update to OS state
+        network.broadcast(result.text, result.html);
       }
-      lastClip = clipboard.read(); // Update to OS state
-      network.broadcast(result.text, result.html);
     } else {
       if (result.skipReason) {
         logEvent('INFO', `Skipped: ${result.skipReason}`);
@@ -124,6 +138,24 @@ const pollInterval = setInterval(async () => {
   }
 }, 500);
 
+function injectForTarget(app, result) {
+  const markdownApps = ['Obsidian', 'Visual Studio Code', 'Cursor', 'Linear', 'GitHub', 'Teams'];
+  const isMarkdownTarget = markdownApps.some(m => app && app.includes(m));
+
+  if (isMarkdownTarget && result.markdown) {
+    // For Markdown-friendly apps, we prioritize Markdown in the plain-text flavor
+    // This allows pasting into Obsidian to get MD, while keeping HTML for table support if they want it
+    clipboard.writeHtml(result.html, result.markdown);
+  } else {
+    // Standard injection
+    if (result.html) {
+      clipboard.writeHtml(result.html, result.text);
+    } else {
+      clipboard.writeText(result.text);
+    }
+  }
+}
+
 // Graceful Shutdown
 function shutdown() {
   logEvent('INFO', 'Shutting down Quark Daemon gracefully...');

package/cli/src/transformers.js

@@ -1,31 +1,53 @@
 const { marked } = require('marked');
 
-function isExcelTSV(text) {
-  const lines = text.trim().split('\n').filter(l => l.trim().length > 0);
-  if (lines.length < 2) return false;
-  // Relaxed TSV detection for ragged lines resulting from sparse spreadsheet cells
-  const linesWithTabs = lines.filter(l => l.includes('\t')).length;
-  return linesWithTabs > 0 && linesWithTabs === lines.length;
+function analyzeGridProperties(text, delimiter) {
+  const lines = text.split('\n').map(l => l.trim('\r'));
+  if (lines.length < 2) return { isGrid: false };
+
+  const rows = lines.map(l => l.split(delimiter));
+  const counts = rows.map(r => r.length);
+
+  // A perfect grid has all rows equal length
+  const maxCols = Math.max(...counts);
+  const minCols = Math.min(...counts);
+
+  // Mathematical sparse matrix inference: 
+  // If the delimiter appears consistently across multiple lines, it's a grid.
+  // For TSV, even a single tab in multiple lines strongly implies a spreadsheet payload.
+  let isGrid = false;
+  if (delimiter === '\t') {
+    const linesWithTabs = lines.filter(l => l.includes('\t')).length;
+    // If at least 50% of lines have tabs, or we have distinct multi-column structure
+    isGrid = (linesWithTabs > 0 && linesWithTabs >= (lines.length / 2)) || (maxCols > 1 && counts[0] === counts[1]);
+  } else {
+    isGrid = maxCols > 2 && minCols === maxCols;
+  }
+
+  return { isGrid, rows, cols: maxCols };
 }
 
-function isCSV(text) {
-  const lines = text.trim().split('\n').filter(l => l.trim().length > 0);
-  if (lines.length < 2) return false;
-  const commas = lines[0].split(',').length;
-  return commas > 2 && lines.every(l => l.split(',').length === commas);
+function isExcelTSV(text) {
+  return analyzeGridProperties(text, '\t').isGrid;
 }
 
 function convertToHTML(text, delimiter) {
-  const rows = text.trim().split('\n').filter(l => l.trim().length > 0).map(r => r.split(delimiter));
+  const { rows, cols } = analyzeGridProperties(text, delimiter);
   let html = '<table style="border-collapse: collapse; font-family: sans-serif; font-size: 14px;">\n';
   rows.forEach((row, i) => {
+    // Drop completely empty trailing rows
+    if (i === rows.length - 1 && row.join('').trim() === '') return;
+
     html += '  <tr>\n';
-    row.forEach(cell => {
+
+    // Pad sparse rows with empty cells to maintain grid geometry
+    for (let j = 0; j < cols; j++) {
+      const cell = row[j] || '';
       const tag = i === 0 ? 'th' : 'td';
       const bg = i === 0 ? 'background-color: #f3f2f1;' : '';
       const style = `border: 1px solid #d1d1d1; padding: 6px 12px; ${bg}`;
       html += `    <${tag} style="${style}">${cell.trim()}</${tag}>\n`;
-    });
+    }
+
     html += '  </tr>\n';
   });
   html += '</table>';
@@ -156,9 +178,66 @@ function normalizeShouting(text) {
   return text;
 }
 
+function convertToMarkdown(html) {
+  if (!html) return '';
+
+  // Minimalist HTML to Markdown converter
+  let md = html
+    .replace(/<style([\s\S]*?)<\/style>/gi, '')
+    .replace(/<head([\s\S]*?)<\/head>/gi, '')
+    .replace(/<(h[1-6])(.*?)>(.*?)<\/\1>/gi, (m, h, a, c) => `${'#'.repeat(parseInt(h[1]))} ${c}\n\n`)
+    .replace(/<p(.*?)>(.*?)<\/p>/gi, '$2\n\n')
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<b(.*?)>(.*?)<\/b>/gi, '**$2**')
+    .replace(/<strong(.*?)>(.*?)<\/strong>/gi, '**$2**')
+    .replace(/<i(.*?)>(.*?)<\/i>/gi, '*$2*')
+    .replace(/<em(.*?)>(.*?)<\/em>/gi, '*$2*')
+    .replace(/<a.*?href="(.*?)".*?>(.*?)<\/a>/gi, '[$2]($1)')
+    .replace(/<ul>([\s\S]*?)<\/ul>/gi, (m, c) => c.replace(/<li(.*?)>(.*?)<\/li>/gi, '- $2\n') + '\n')
+    .replace(/<ol>([\s\S]*?)<\/ol>/gi, (m, c) => {
+      let i = 1;
+      return c.replace(/<li(.*?)>(.*?)<\/li>/gi, () => `${i++}. $2\n`) + '\n';
+    });
+
+  // Table handling
+  md = md.replace(/<table([\s\S]*?)<\/table>/gi, (m, c) => {
+    const rows = [];
+    const trMatches = c.match(/<tr([\s\S]*?)<\/tr>/gi);
+    if (!trMatches) return '';
+
+    trMatches.forEach(tr => {
+      const cells = [];
+      const tdMatches = tr.match(/<(td|th)([\s\S]*?)<\/\1>/gi);
+      if (tdMatches) {
+        tdMatches.forEach(td => {
+          cells.push(td.replace(/<(?:.|\n)*?>/gm, '').trim().replace(/\|/g, '\\|'));
+        });
+        rows.push('| ' + cells.join(' | ') + ' |');
+      }
+    });
+
+    if (rows.length === 0) return '';
+
+    // Header separator
+    const colCount = rows[0].split('|').length - 2;
+    const separator = '| ' + Array(colCount).fill('---').join(' | ') + ' |';
+    rows.splice(1, 0, separator);
+
+    return rows.join('\n') + '\n\n';
+  });
+
+  // Strip remaining tags
+  return md.replace(/<(?:.|\n)*?>/gm, '').trim();
+}
+
 // The master pipeline
-async function processClipboard(text, originalHtml) {
-  let result = { changed: false, text: text, html: originalHtml };
+async function processClipboard(text, originalHtml, targetApp = null) {
+  let result = { changed: false, text: text, html: originalHtml, markdown: null };
+
+  // Calculate markdown if HTML exists
+  if (originalHtml) {
+    result.markdown = convertToMarkdown(originalHtml);
+  }
 
   // PRESERVATION HEURISTIC: Yield if high-quality HTML already exists
   if (originalHtml) {
@@ -174,7 +253,7 @@ async function processClipboard(text, originalHtml) {
 
     const hasStructure = forensicMarkers.some(marker => originalHtml.toLowerCase().includes(marker));
     if (hasStructure) {
-      return { changed: false, text: text, html: originalHtml, skipReason: 'Forensic structure detected' };
+      return { changed: false, text: text, html: originalHtml, markdown: result.markdown, skipReason: 'Forensic structure detected' };
     }
   }
 
@@ -201,37 +280,54 @@ async function processClipboard(text, originalHtml) {
   // 1. URL Tracking Stripper
   if (text.startsWith('http') && text.includes('utm_')) {
     const clean = stripTrackingParams(text);
-    if (clean !== text) return { changed: true, text: clean, html: null };
+    if (clean !== text) return { changed: true, text: clean, html: null, markdown: clean };
   }
 
   // 2. JSON Prettier
   if ((text.startsWith('{') && text.endsWith('}')) || (text.startsWith('[') && text.endsWith(']'))) {
     const pretty = prettifyJSON(text);
-    if (pretty !== text && pretty.includes('\n')) return { changed: true, text: pretty, html: null };
+    if (pretty !== text && pretty.includes('\n')) return { changed: true, text: pretty, html: null, markdown: `\`\`\`json\n${pretty}\n\`\`\`` };
   }
 
   // 3. Excel TSV to HTML
   if (isExcelTSV(text)) {
-    return { changed: true, text: text, html: convertToHTML(text, '\t') };
+    const tableHtml = convertToHTML(text, '\t');
+    return {
+      changed: true,
+      text: text,
+      html: tableHtml,
+      markdown: convertToMarkdown(tableHtml)
+    };
   }
 
   // 4. CSV to HTML
-  if (isCSV(text) && !originalHtml) {
-    return { changed: true, text: text, html: convertToHTML(text, ',') };
+  if (!originalHtml && analyzeGridProperties(text, ',').isGrid) {
+    const tableHtml = convertToHTML(text, ',');
+    return {
+      changed: true,
+      text: text,
+      html: tableHtml,
+      markdown: convertToMarkdown(tableHtml)
+    };
   }
 
   // 5. Full Markdown & Math to HTML
   const mathResult = renderMathFormulas(text);
   if ((isMarkdown(text) || mathResult.hasMath) && !originalHtml) {
     const html = await convertMarkdownToHTML(text);
-    return { changed: true, text: text, html: html };
+    return {
+      changed: true,
+      text: text,
+      html: html,
+      markdown: text // If input was MD, use it
+    };
   }
 
   // 6. PDF Line Breaks (Only apply if it looks like a broken paragraph, heuristic)
   if (text.length > 100 && text.split('\n').length > 3 && !text.includes('\t') && !originalHtml) {
     const fixed = fixPDFLineBreaks(text);
     if (fixed !== text && fixed.length < text.length) {
-      return { changed: true, text: fixed, html: null };
+      return { changed: true, text: fixed, html: null, markdown: fixed };
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quark.clip/quark",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "private": false,
   "type": "module",
   "files": [
@@ -54,4 +54,4 @@
     "typescript": "~5.8.2",
     "vite": "^6.2.0"
   }
-}
+}