@monoes/monograph 1.5.6 → 1.5.7

package/src/export/compact.ts

@@ -1,83 +0,0 @@
-import { relative } from 'path';
-import type { MonographDb } from '../storage/db.js';
-
-function relPath(filePath: string, repoRoot?: string): string {
-  if (!repoRoot) return filePath;
-  return relative(repoRoot, filePath);
-}
-
-/**
- * Export a compact one-line-per-issue text format suitable for CLI output
- * and machine consumption by shell pipelines.
- *
- * Line formats:
- *   unreachable-file:{path}
- *   god-node:{path}:{line}:{name}
- *   duplicate:{path}:{name}
- *   boundary-violation:{path}:{line}:{rule}
- */
-export function exportCompact(db: MonographDb, repoRoot?: string): string {
-  const lines: string[] = [];
-
-  // ── Unreachable files ──────────────────────────────────────────────────────
-  const unreachable = db.prepare(`
-    SELECT file_path FROM nodes
-    WHERE label = 'File'
-    AND (
-      json_extract(properties, '$.reachabilityRole') = 'unreachable'
-      OR properties LIKE '%"unreachable"%'
-    )
-    AND file_path IS NOT NULL
-  `).all() as { file_path: string }[];
-
-  for (const row of unreachable) {
-    lines.push(`unreachable-file:${relPath(row.file_path, repoRoot)}`);
-  }
-
-  // ── God nodes (top 10% by fan-in) ─────────────────────────────────────────
-  const totalNodes = (db.prepare(`SELECT COUNT(*) as c FROM nodes WHERE label = 'File'`).get() as { c: number }).c;
-  const top10pct = Math.max(1, Math.floor(totalNodes * 0.1));
-  const godNodes = db.prepare(`
-    SELECT n.name, n.file_path, COALESCE(n.start_line, 1) AS line,
-           COUNT(e.id) AS in_degree
-    FROM nodes n
-    LEFT JOIN edges e ON e.target_id = n.id AND e.relation IN ('IMPORTS', 'RE_EXPORTS')
-    WHERE n.file_path IS NOT NULL AND n.label = 'File'
-    GROUP BY n.id
-    ORDER BY in_degree DESC
-    LIMIT ?
-  `).all(top10pct) as { name: string; file_path: string; line: number; in_degree: number }[];
-
-  for (const row of godNodes) {
-    if (row.in_degree === 0) continue;
-    lines.push(`god-node:${relPath(row.file_path, repoRoot)}:${row.line}:${row.name}`);
-  }
-
-  // ── Structural duplicates ─────────────────────────────────────────────────
-  const dupes = db.prepare(`
-    SELECT n1.name AS src_name, n1.file_path AS src_path
-    FROM edges e
-    JOIN nodes n1 ON n1.id = e.source_id
-    WHERE e.relation = 'STRUCTURALLY_SIMILAR'
-    AND n1.file_path IS NOT NULL
-  `).all() as { src_name: string; src_path: string }[];
-
-  for (const row of dupes) {
-    lines.push(`duplicate:${relPath(row.src_path, repoRoot)}:${row.src_name}`);
-  }
-
-  // ── Boundary violations (stored in node properties) ───────────────────────
-  const violations = db.prepare(`
-    SELECT file_path, COALESCE(start_line, 1) AS line,
-           json_extract(properties, '$.boundaryViolation') AS rule
-    FROM nodes
-    WHERE file_path IS NOT NULL
-    AND json_extract(properties, '$.boundaryViolation') IS NOT NULL
-  `).all() as { file_path: string; line: number; rule: string }[];
-
-  for (const row of violations) {
-    lines.push(`boundary-violation:${relPath(row.file_path, repoRoot)}:${row.line}:${row.rule}`);
-  }
-
-  return lines.join('\n');
-}

package/src/export/csv.ts

@@ -1,33 +0,0 @@
-import type { MonographNode, MonographEdge } from '../types.js';
-
-export interface CsvExport {
-  nodes: string;
-  edges: string;
-}
-
-function escape(v: string | number | boolean | undefined | null): string {
-  const s = String(v ?? '');
-  // Prefix formula-injection characters to prevent spreadsheet execution
-  const safe = /^[=+\-@]/.test(s) ? `'${s}` : s;
-  return safe.includes(',') || safe.includes('"') || safe.includes('\n')
-    ? `"${safe.replace(/"/g, '""')}"` : safe;
-}
-
-export function toCsv(nodes: MonographNode[], edges: MonographEdge[]): CsvExport {
-  const nodeHeader = 'id,label,name,filePath,isExported,startLine,endLine';
-  const nodeRows = nodes.map(n =>
-    [n.id, n.label, n.name, n.filePath ?? '', n.isExported, n.startLine ?? '', n.endLine ?? '']
-      .map(escape).join(',')
-  );
-
-  const edgeHeader = 'id,sourceId,targetId,relation,confidence,confidenceScore';
-  const edgeRows = edges.map(e =>
-    [e.id, e.sourceId, e.targetId, e.relation, e.confidence, e.confidenceScore]
-      .map(escape).join(',')
-  );
-
-  return {
-    nodes: [nodeHeader, ...nodeRows].join('\n'),
-    edges: [edgeHeader, ...edgeRows].join('\n'),
-  };
-}

package/src/export/cypher.ts

@@ -1,33 +0,0 @@
-import type { MonographNode, MonographEdge } from '../types.js';
-
-export function toCypher(nodes: MonographNode[], edges: MonographEdge[]): string {
-  const lines: string[] = [
-    '// Generated by Monograph — read-only import script',
-    '// Only CREATE statements; no DROP/DELETE operations',
-    '',
-  ];
-
-  for (const n of nodes) {
-    const props = `{id: ${q(n.id)}, name: ${q(n.name)}, file: ${q(n.filePath ?? '')}, exported: ${n.isExported}}`;
-    lines.push(`CREATE (n_${safe(n.id)}:${n.label} ${props})`);
-  }
-
-  lines.push('');
-
-  for (const e of edges) {
-    lines.push(
-      `MATCH (a {id: ${q(e.sourceId)}}), (b {id: ${q(e.targetId)}}) ` +
-        `CREATE (a)-[:${e.relation} {confidence: ${q(e.confidence)}}]->(b)`
-    );
-  }
-
-  return lines.join('\n');
-}
-
-function q(s: string): string {
-  return `"${s.replace(/"/g, '\\"')}"`;
-}
-
-function safe(s: string): string {
-  return s.replace(/[^a-zA-Z0-9_]/g, '_');
-}

package/src/export/dot.ts

@@ -1,52 +0,0 @@
-import type { MonographNode, MonographEdge } from '../types.js';
-
-export interface DotOptions {
-  graphName?: string;
-}
-
-function escapeDotString(s: string): string {
-  return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
-}
-
-function safeDotId(s: string): string {
-  return /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(s) ? s : `"${escapeDotString(s)}"`;
-}
-
-/**
- * Export nodes and edges to Graphviz DOT format.
- *
- * @param nodes - Array of MonographNode objects
- * @param edges - Array of MonographEdge objects
- * @param options - Optional configuration (graphName)
- * @returns A DOT format string suitable for Graphviz
- */
-export function toDot(
-  nodes: MonographNode[],
-  edges: MonographEdge[],
-  options: DotOptions = {},
-): string {
-  const graphName = safeDotId(options.graphName ?? 'monograph');
-
-  const nodeLines = nodes.map(n => {
-    const label = escapeDotString(`${n.name}\n[${n.label}]`);
-    return `  "${escapeDotString(n.id)}" [label="${label}"];`;
-  });
-
-  const edgeLines = edges.map(e => {
-    const src = escapeDotString(e.sourceId);
-    const tgt = escapeDotString(e.targetId);
-    const rel = escapeDotString(e.relation);
-    return `  "${src}" -> "${tgt}" [label="${rel}"];`;
-  });
-
-  const lines = [
-    `digraph ${graphName} {`,  // graphName is already quoted/validated by safeDotId
-    '  rankdir=LR;',
-    '  node [shape=box, fontsize=10];',
-    ...nodeLines,
-    ...edgeLines,
-    '}',
-  ];
-
-  return lines.join('\n');
-}

package/src/export/gexf.ts

@@ -1,59 +0,0 @@
-import type { MonographNode, MonographEdge } from '../types.js';
-
-function esc(s: string): string {
-  return s
-    .replace(/&/g, '&')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;');
-}
-
-/**
- * Export nodes and edges to GEXF (Graph Exchange XML Format) string.
- *
- * GEXF is the format used by Gephi and similar graph visualization tools.
- *
- * @param nodes - Array of MonographNode objects
- * @param edges - Array of MonographEdge objects
- * @returns A GEXF XML string
- */
-export function toGexf(nodes: MonographNode[], edges: MonographEdge[]): string {
-  const nodeXml = nodes
-    .map(n =>
-      `    <node id="${esc(n.id)}" label="${esc(n.name)}">` +
-      `<attvalues>` +
-      `<attvalue for="0" value="${esc(n.label)}"/>` +
-      `<attvalue for="1" value="${n.isExported ? 'true' : 'false'}"/>` +
-      (n.filePath ? `<attvalue for="2" value="${esc(n.filePath)}"/>` : '') +
-      `</attvalues>` +
-      `</node>`
-    )
-    .join('\n');
-
-  const edgeXml = edges
-    .map(e =>
-      `    <edge id="${esc(e.id)}" source="${esc(e.sourceId)}" target="${esc(e.targetId)}" label="${esc(e.relation)}" weight="${e.confidenceScore}"/>`
-    )
-    .join('\n');
-
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<gexf xmlns="http://gexf.net/1.3" version="1.3">
-  <meta>
-    <creator>@monomind/monograph</creator>
-    <description>Knowledge graph export</description>
-  </meta>
-  <graph defaultedgetype="directed">
-    <attributes class="node">
-      <attribute id="0" title="label" type="string"/>
-      <attribute id="1" title="isExported" type="boolean"/>
-      <attribute id="2" title="filePath" type="string"/>
-    </attributes>
-    <nodes>
-${nodeXml}
-    </nodes>
-    <edges>
-${edgeXml}
-    </edges>
-  </graph>
-</gexf>`;
-}

package/src/export/graphml.ts

@@ -1,50 +0,0 @@
-import type { MonographNode, MonographEdge } from '../types.js';
-
-export function toGraphml(nodes: MonographNode[], edges: MonographEdge[]): string {
-  const nodeXml = nodes
-    .map(
-      n =>
-        `  <node id="${esc(n.id)}">` +
-        `<data key="label">${esc(n.label)}</data>` +
-        `<data key="name">${esc(n.name)}</data>` +
-        `<data key="file">${esc(n.filePath ?? '')}</data>` +
-        `<data key="exported">${n.isExported ? 'true' : 'false'}</data>` +
-        (n.communityId !== undefined ? `<data key="community">${n.communityId}</data>` : '') +
-        `</node>`
-    )
-    .join('\n');
-
-  const edgeXml = edges
-    .map(
-      e =>
-        `  <edge id="${esc(e.id)}" source="${esc(e.sourceId)}" target="${esc(e.targetId)}">` +
-        `<data key="relation">${esc(e.relation)}</data>` +
-        `<data key="confidence">${esc(e.confidence)}</data>` +
-        `</edge>`
-    )
-    .join('\n');
-
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<graphml xmlns="http://graphml.graphdrawing.org/graphml">
-  <key id="label" for="node" attr.name="label" attr.type="string"/>
-  <key id="name" for="node" attr.name="name" attr.type="string"/>
-  <key id="file" for="node" attr.name="file" attr.type="string"/>
-  <key id="exported" for="node" attr.name="exported" attr.type="boolean"/>
-  <key id="community" for="node" attr.name="community" attr.type="int"/>
-  <key id="relation" for="edge" attr.name="relation" attr.type="string"/>
-  <key id="confidence" for="edge" attr.name="confidence" attr.type="string"/>
-  <graph id="G" edgedefault="directed">
-${nodeXml}
-${edgeXml}
-  </graph>
-</graphml>`;
-}
-
-function esc(s: string): string {
-  return s
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&apos;');
-}