@tekyzinc/gsd-t 2.51.10 → 2.53.11

package/bin/scan-renderer.js

@@ -1,92 +1,92 @@
-'use strict';
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { execFileSync } = require('child_process');
-const https = require('https');
-
-const PLACEHOLDER_HTML = '<div class="diagram-placeholder">\n  <p>Diagram unavailable — rendering tools not found</p>\n  <p>Install: <code>npm install -g @mermaid-js/mermaid-cli</code></p>\n</div>';
-
-function stripSvgDimensions(svgStr) {
-  return svgStr
-    .replace(/<svg([^>]*)\s+width="[^"]*"/, '<svg$1')
-    .replace(/<svg([^>]*)\s+height="[^"]*"/, '<svg$1');
-}
-
-function makePlaceholder() {
-  return PLACEHOLDER_HTML;
-}
-
-function tryMmdc(mmdContent) {
-  const ts = Date.now();
-  const tmpIn = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.mmd');
-  const tmpOut = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.svg');
-  try {
-    fs.writeFileSync(tmpIn, mmdContent, 'utf8');
-    execFileSync('mmdc', ['-i', tmpIn, '-o', tmpOut, '-t', 'dark', '--quiet'], { timeout: 30000, stdio: 'pipe' });
-    const svg = fs.readFileSync(tmpOut, 'utf8');
-    return { svgContent: stripSvgDimensions(svg), rendered: true, rendererUsed: 'mermaid-cli' };
-  } catch { return null; }
-  finally {
-    try { fs.unlinkSync(tmpIn); } catch {}
-    try { fs.unlinkSync(tmpOut); } catch {}
-  }
-}
-
-function tryD2(mmdContent, type) {
-  if (type !== 'system-architecture' && type !== 'data-flow') return null;
-  const ts = Date.now();
-  const tmpIn = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.d2');
-  const tmpOut = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.svg');
-  try {
-    fs.writeFileSync(tmpIn, 'app -> db: query', 'utf8');
-    execFileSync('d2', [tmpIn, tmpOut, '--layout=dagre'], { timeout: 30000, stdio: 'pipe' });
-    const svg = fs.readFileSync(tmpOut, 'utf8');
-    return { svgContent: stripSvgDimensions(svg), rendered: true, rendererUsed: 'd2' };
-  } catch { return null; }
-  finally {
-    try { fs.unlinkSync(tmpIn); } catch {}
-    try { fs.unlinkSync(tmpOut); } catch {}
-  }
-}
-
-function tryKroki(mmdContent) {
-  return new Promise((resolve) => {
-    const body = JSON.stringify({ diagram_source: mmdContent });
-    const host = process.env.KROKI_HOST || 'kroki.io';
-    const options = {
-      hostname: host, port: 443,
-      path: '/mermaid/svg', method: 'POST',
-      headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) },
-      timeout: 15000
-    };
-    const req = https.request(options, (res) => {
-      let data = '';
-      res.on('data', c => { data += c; });
-      res.on('end', () => {
-        if (data.trimStart().startsWith('<svg')) {
-          resolve({ svgContent: stripSvgDimensions(data), rendered: true, rendererUsed: 'kroki' });
-        } else { resolve(null); }
-      });
-    });
-    req.on('error', () => resolve(null));
-    req.on('timeout', () => { req.destroy(); resolve(null); });
-    req.write(body);
-    req.end();
-  });
-}
-
-function renderDiagram(mmdContent, type, options) {
-  try {
-    const mmdc = tryMmdc(mmdContent);
-    if (mmdc) return mmdc;
-    const d2 = tryD2(mmdContent, type);
-    if (d2) return d2;
-    // tryKroki is async; skip in sync rendering path — Kroki available via async wrapper if needed
-    return { svgContent: makePlaceholder(), rendered: false, rendererUsed: 'placeholder' };
-  } catch {
-    return { svgContent: makePlaceholder(), rendered: false, rendererUsed: 'placeholder' };
-  }
-}
-
-module.exports = { renderDiagram };
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execFileSync } = require('child_process');
+const https = require('https');
+
+const PLACEHOLDER_HTML = '<div class="diagram-placeholder">\n  <p>Diagram unavailable — rendering tools not found</p>\n  <p>Install: <code>npm install -g @mermaid-js/mermaid-cli</code></p>\n</div>';
+
+function stripSvgDimensions(svgStr) {
+  return svgStr
+    .replace(/<svg([^>]*)\s+width="[^"]*"/, '<svg$1')
+    .replace(/<svg([^>]*)\s+height="[^"]*"/, '<svg$1');
+}
+
+function makePlaceholder() {
+  return PLACEHOLDER_HTML;
+}
+
+function tryMmdc(mmdContent) {
+  const ts = Date.now();
+  const tmpIn = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.mmd');
+  const tmpOut = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.svg');
+  try {
+    fs.writeFileSync(tmpIn, mmdContent, 'utf8');
+    execFileSync('mmdc', ['-i', tmpIn, '-o', tmpOut, '-t', 'dark', '--quiet'], { timeout: 30000, stdio: 'pipe' });
+    const svg = fs.readFileSync(tmpOut, 'utf8');
+    return { svgContent: stripSvgDimensions(svg), rendered: true, rendererUsed: 'mermaid-cli' };
+  } catch { return null; }
+  finally {
+    try { fs.unlinkSync(tmpIn); } catch {}
+    try { fs.unlinkSync(tmpOut); } catch {}
+  }
+}
+
+function tryD2(mmdContent, type) {
+  if (type !== 'system-architecture' && type !== 'data-flow') return null;
+  const ts = Date.now();
+  const tmpIn = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.d2');
+  const tmpOut = path.join(os.tmpdir(), 'gsd-scan-' + ts + '.svg');
+  try {
+    fs.writeFileSync(tmpIn, 'app -> db: query', 'utf8');
+    execFileSync('d2', [tmpIn, tmpOut, '--layout=dagre'], { timeout: 30000, stdio: 'pipe' });
+    const svg = fs.readFileSync(tmpOut, 'utf8');
+    return { svgContent: stripSvgDimensions(svg), rendered: true, rendererUsed: 'd2' };
+  } catch { return null; }
+  finally {
+    try { fs.unlinkSync(tmpIn); } catch {}
+    try { fs.unlinkSync(tmpOut); } catch {}
+  }
+}
+
+function tryKroki(mmdContent) {
+  return new Promise((resolve) => {
+    const body = JSON.stringify({ diagram_source: mmdContent });
+    const host = process.env.KROKI_HOST || 'kroki.io';
+    const options = {
+      hostname: host, port: 443,
+      path: '/mermaid/svg', method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) },
+      timeout: 15000
+    };
+    const req = https.request(options, (res) => {
+      let data = '';
+      res.on('data', c => { data += c; });
+      res.on('end', () => {
+        if (data.trimStart().startsWith('<svg')) {
+          resolve({ svgContent: stripSvgDimensions(data), rendered: true, rendererUsed: 'kroki' });
+        } else { resolve(null); }
+      });
+    });
+    req.on('error', () => resolve(null));
+    req.on('timeout', () => { req.destroy(); resolve(null); });
+    req.write(body);
+    req.end();
+  });
+}
+
+function renderDiagram(mmdContent, type, options) {
+  try {
+    const mmdc = tryMmdc(mmdContent);
+    if (mmdc) return mmdc;
+    const d2 = tryD2(mmdContent, type);
+    if (d2) return d2;
+    // tryKroki is async; skip in sync rendering path — Kroki available via async wrapper if needed
+    return { svgContent: makePlaceholder(), rendered: false, rendererUsed: 'placeholder' };
+  } catch {
+    return { svgContent: makePlaceholder(), rendered: false, rendererUsed: 'placeholder' };
+  }
+}
+
+module.exports = { renderDiagram };

package/bin/scan-report-sections.js

@@ -1,121 +1,121 @@
-'use strict';
-
-function esc(s) {
-  return String(s || '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-}
-
-function buildMetricCards(d) {
-  d = d || {};
-  const loc = d.totalLoc > 999 ? (d.totalLoc / 1000).toFixed(1) + 'k' : (d.totalLoc || 0);
-  const cov = d.testCoverage || 'N/A';
-  const metrics = [
-    { label: 'Files Scanned',   value: d.filesScanned || 0, sub: 'across all components', bar: 'g' },
-    { label: 'Lines of Code',   value: loc,                  sub: 'source code',           bar: '' },
-    { label: 'Critical Issues', value: d.debtCritical || 0, sub: 'requires immediate fix', bar: 'r' },
-    { label: 'High Issues',     value: d.debtHigh || 0,     sub: 'fix before next release', bar: 'o' },
-    { label: 'Medium Issues',   value: d.debtMedium || 0,   sub: 'plan to address',        bar: 'y' },
-    { label: 'Test Coverage',   value: cov,                  sub: 'passing tests',          bar: 'g' }
-  ];
-  const cards = metrics.map(m =>
-    '<div class="mc"><div class="mc-bar' + (m.bar ? ' ' + m.bar : '') + '"></div>' +
-    '<div class="mc-lbl">' + m.label + '</div>' +
-    '<div class="mc-val">' + m.value + '</div>' +
-    '<div class="mc-sub">' + m.sub + '</div></div>'
-  ).join('');
-  return '<section id="summary"><div class="sl">Summary</div><div class="mxg">' + cards + '</div></section>';
-}
-
-function buildDomainHealth(d) {
-  d = d || {};
-  const domains = d.domains || [];
-  if (!domains.length) {
-    return '<section id="domains"><div class="sl">Component Inventory</div>' +
-      '<p style="color:var(--muted2);font-size:12px">No component data available.</p></section>';
-  }
-  const rows = domains.map(item => {
-    const bigFile = parseInt(item.size) > 500;
-    const sizeColor = bigFile ? 'color:var(--amber)' : 'color:var(--blue)';
-    return '<tr>' +
-      '<td><strong>' + esc(item.name) + '</strong></td>' +
-      '<td style="font-family:\'Consolas\',monospace;font-size:10px;color:var(--muted2)">' + esc(item.filePath || '') + '</td>' +
-      '<td class="loc-cell" style="' + sizeColor + '">' + esc(item.size || '') + '</td>' +
-      '<td style="color:var(--muted2);font-size:11px">' + esc(item.purpose || '') + '</td>' +
-      '</tr>';
-  }).join('');
-  return '<section id="domains"><div class="sl">Component Inventory</div>' +
-    '<div class="tw"><table><thead><tr><th>Component</th><th>File(s)</th><th>Lines</th><th>Purpose</th></tr></thead>' +
-    '<tbody>' + rows + '</tbody></table></div></section>';
-}
-
-function buildDiagramSection(d) {
-  const secId = 'diagram-' + d.type;
-  const cardTitle = esc(d.title + (d.typeBadge ? ' \u2014 ' + d.typeBadge : ''));
-  let diagramContent;
-  if (d.svgContent && !d.svgContent.includes('diagram-placeholder')) {
-    diagramContent = '<div style="width:100%;overflow:auto">' + d.svgContent + '</div>';
-  } else {
-    diagramContent = d.svgContent ||
-      '<div class="diagram-placeholder"><p>Diagram unavailable</p></div>';
-  }
-  return '<section id="' + secId + '" class="diagram-section">' +
-    '<div class="sl">' + esc(d.title) + '</div>' +
-    '<div class="dc" data-title="' + cardTitle + '">' +
-    '<div class="dc-h"><div class="dc-hl">' +
-    '<span class="dc-t">' + esc(d.title) + '</span>' +
-    '<span class="dc-tag">' + esc(d.typeBadge) + '</span>' +
-    '</div><button class="btn-exp" onclick="expandDiagram(this)">&#x26F6;<span class="lbl">Expand</span></button>' +
-    '</div>' +
-    '<div class="dc-b">' + diagramContent + '</div>' +
-    '<div class="dc-n">' + esc(d.note) + '</div>' +
-    '</div></section>';
-}
-
-function buildTechDebt(d) {
-  d = d || {};
-  const items = d.techDebt || [];
-  if (!items.length) {
-    return '<section id="tech-debt"><div class="sl">Tech Debt Register</div>' +
-      '<p style="color:var(--muted2);font-size:12px">No open tech debt items.</p></section>';
-  }
-  const sevClass = { critical: 'c', high: 'h', medium: 'm', low: 'l', info: 'i' };
-  const rows = items.map(i => {
-    const sc = sevClass[(i.severity || '').toLowerCase()] || 'm';
-    return '<tr>' +
-      '<td><span class="bx ' + sc + '">' + esc(i.severity || '') + '</span></td>' +
-      '<td style="font-family:\'Consolas\',monospace;font-size:11px;color:var(--blue)">' + esc(i.domain || '') + '</td>' +
-      '<td>' + esc(i.issue || '') + '</td>' +
-      '<td><code>' + esc(i.location || '') + '</code></td>' +
-      '<td style="color:var(--muted2);font-size:11px">' + esc(i.effort || '') + '</td>' +
-      '</tr>';
-  }).join('');
-  return '<section id="tech-debt"><div class="sl">Tech Debt Register</div>' +
-    '<div class="tw"><table><thead><tr><th>Severity</th><th>Domain</th><th>Issue</th><th>Location</th><th>Effort</th></tr></thead>' +
-    '<tbody>' + rows + '</tbody></table></div></section>';
-}
-
-const ICONS = {
-  security: '&#128721;', architecture: '&#9889;', reliability: '&#128202;',
-  quality: '&#128196;', performance: '&#9888;', strength: '&#9989;', default: '&#128203;'
-};
-
-function buildFindings(d) {
-  d = d || {};
-  const findings = d.findings || [];
-  if (!findings.length) {
-    return '<section id="findings"><div class="sl">Key Findings</div>' +
-      '<p style="color:var(--muted2);font-size:12px">No findings recorded.</p></section>';
-  }
-  const cards = findings.map(f => {
-    const cat = (f.category || '').toLowerCase();
-    const ico = ICONS[cat] || ICONS.default;
-    const rec = f.recommendation
-      ? ' <strong style="color:var(--text)">Fix:</strong> ' + esc(f.recommendation) : '';
-    return '<div class="fi"><div class="ico">' + ico + '</div>' +
-      '<div><h4>' + esc(f.title || '') + '</h4>' +
-      '<p>' + esc(f.description || '') + rec + '</p>' +
-      '</div></div>';
-  }).join('');
-  return '<section id="findings"><div class="sl">Key Findings</div><div class="fl">' + cards + '</div></section>';
-}
-
-module.exports = { buildMetricCards, buildDomainHealth, buildDiagramSection, buildTechDebt, buildFindings };
+'use strict';
+
+function esc(s) {
+  return String(s || '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+
+function buildMetricCards(d) {
+  d = d || {};
+  const loc = d.totalLoc > 999 ? (d.totalLoc / 1000).toFixed(1) + 'k' : (d.totalLoc || 0);
+  const cov = d.testCoverage || 'N/A';
+  const metrics = [
+    { label: 'Files Scanned',   value: d.filesScanned || 0, sub: 'across all components', bar: 'g' },
+    { label: 'Lines of Code',   value: loc,                  sub: 'source code',           bar: '' },
+    { label: 'Critical Issues', value: d.debtCritical || 0, sub: 'requires immediate fix', bar: 'r' },
+    { label: 'High Issues',     value: d.debtHigh || 0,     sub: 'fix before next release', bar: 'o' },
+    { label: 'Medium Issues',   value: d.debtMedium || 0,   sub: 'plan to address',        bar: 'y' },
+    { label: 'Test Coverage',   value: cov,                  sub: 'passing tests',          bar: 'g' }
+  ];
+  const cards = metrics.map(m =>
+    '<div class="mc"><div class="mc-bar' + (m.bar ? ' ' + m.bar : '') + '"></div>' +
+    '<div class="mc-lbl">' + m.label + '</div>' +
+    '<div class="mc-val">' + m.value + '</div>' +
+    '<div class="mc-sub">' + m.sub + '</div></div>'
+  ).join('');
+  return '<section id="summary"><div class="sl">Summary</div><div class="mxg">' + cards + '</div></section>';
+}
+
+function buildDomainHealth(d) {
+  d = d || {};
+  const domains = d.domains || [];
+  if (!domains.length) {
+    return '<section id="domains"><div class="sl">Component Inventory</div>' +
+      '<p style="color:var(--muted2);font-size:12px">No component data available.</p></section>';
+  }
+  const rows = domains.map(item => {
+    const bigFile = parseInt(item.size) > 500;
+    const sizeColor = bigFile ? 'color:var(--amber)' : 'color:var(--blue)';
+    return '<tr>' +
+      '<td><strong>' + esc(item.name) + '</strong></td>' +
+      '<td style="font-family:\'Consolas\',monospace;font-size:10px;color:var(--muted2)">' + esc(item.filePath || '') + '</td>' +
+      '<td class="loc-cell" style="' + sizeColor + '">' + esc(item.size || '') + '</td>' +
+      '<td style="color:var(--muted2);font-size:11px">' + esc(item.purpose || '') + '</td>' +
+      '</tr>';
+  }).join('');
+  return '<section id="domains"><div class="sl">Component Inventory</div>' +
+    '<div class="tw"><table><thead><tr><th>Component</th><th>File(s)</th><th>Lines</th><th>Purpose</th></tr></thead>' +
+    '<tbody>' + rows + '</tbody></table></div></section>';
+}
+
+function buildDiagramSection(d) {
+  const secId = 'diagram-' + d.type;
+  const cardTitle = esc(d.title + (d.typeBadge ? ' \u2014 ' + d.typeBadge : ''));
+  let diagramContent;
+  if (d.svgContent && !d.svgContent.includes('diagram-placeholder')) {
+    diagramContent = '<div style="width:100%;overflow:auto">' + d.svgContent + '</div>';
+  } else {
+    diagramContent = d.svgContent ||
+      '<div class="diagram-placeholder"><p>Diagram unavailable</p></div>';
+  }
+  return '<section id="' + secId + '" class="diagram-section">' +
+    '<div class="sl">' + esc(d.title) + '</div>' +
+    '<div class="dc" data-title="' + cardTitle + '">' +
+    '<div class="dc-h"><div class="dc-hl">' +
+    '<span class="dc-t">' + esc(d.title) + '</span>' +
+    '<span class="dc-tag">' + esc(d.typeBadge) + '</span>' +
+    '</div><button class="btn-exp" onclick="expandDiagram(this)">&#x26F6;<span class="lbl">Expand</span></button>' +
+    '</div>' +
+    '<div class="dc-b">' + diagramContent + '</div>' +
+    '<div class="dc-n">' + esc(d.note) + '</div>' +
+    '</div></section>';
+}
+
+function buildTechDebt(d) {
+  d = d || {};
+  const items = d.techDebt || [];
+  if (!items.length) {
+    return '<section id="tech-debt"><div class="sl">Tech Debt Register</div>' +
+      '<p style="color:var(--muted2);font-size:12px">No open tech debt items.</p></section>';
+  }
+  const sevClass = { critical: 'c', high: 'h', medium: 'm', low: 'l', info: 'i' };
+  const rows = items.map(i => {
+    const sc = sevClass[(i.severity || '').toLowerCase()] || 'm';
+    return '<tr>' +
+      '<td><span class="bx ' + sc + '">' + esc(i.severity || '') + '</span></td>' +
+      '<td style="font-family:\'Consolas\',monospace;font-size:11px;color:var(--blue)">' + esc(i.domain || '') + '</td>' +
+      '<td>' + esc(i.issue || '') + '</td>' +
+      '<td><code>' + esc(i.location || '') + '</code></td>' +
+      '<td style="color:var(--muted2);font-size:11px">' + esc(i.effort || '') + '</td>' +
+      '</tr>';
+  }).join('');
+  return '<section id="tech-debt"><div class="sl">Tech Debt Register</div>' +
+    '<div class="tw"><table><thead><tr><th>Severity</th><th>Domain</th><th>Issue</th><th>Location</th><th>Effort</th></tr></thead>' +
+    '<tbody>' + rows + '</tbody></table></div></section>';
+}
+
+const ICONS = {
+  security: '&#128721;', architecture: '&#9889;', reliability: '&#128202;',
+  quality: '&#128196;', performance: '&#9888;', strength: '&#9989;', default: '&#128203;'
+};
+
+function buildFindings(d) {
+  d = d || {};
+  const findings = d.findings || [];
+  if (!findings.length) {
+    return '<section id="findings"><div class="sl">Key Findings</div>' +
+      '<p style="color:var(--muted2);font-size:12px">No findings recorded.</p></section>';
+  }
+  const cards = findings.map(f => {
+    const cat = (f.category || '').toLowerCase();
+    const ico = ICONS[cat] || ICONS.default;
+    const rec = f.recommendation
+      ? ' <strong style="color:var(--text)">Fix:</strong> ' + esc(f.recommendation) : '';
+    return '<div class="fi"><div class="ico">' + ico + '</div>' +
+      '<div><h4>' + esc(f.title || '') + '</h4>' +
+      '<p>' + esc(f.description || '') + rec + '</p>' +
+      '</div></div>';
+  }).join('');
+  return '<section id="findings"><div class="sl">Key Findings</div><div class="fl">' + cards + '</div></section>';
+}
+
+module.exports = { buildMetricCards, buildDomainHealth, buildDiagramSection, buildTechDebt, buildFindings };