npm - specweave - Versions diffs - 0.32.9 → 0.33.2 - Mend

specweave 0.32.9 → 0.33.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (179) hide show

package/dist/src/core/living-docs/intelligent-analyzer/graph-visualizer.js ADDED Viewed

@@ -0,0 +1,283 @@
+/**
+ * Interactive Graph Visualizer
+ *
+ * Generates standalone HTML files with D3.js-powered interactive dependency graphs.
+ */
+/**
+ * Generates interactive HTML visualizations using D3.js.
+ */
+export class GraphVisualizer {
+    /**
+     * Generate standalone HTML file with interactive module graph.
+     */
+    generateInteractiveGraph(graph, circularDeps = [], options = {}) {
+        const { title = 'Module Dependency Graph', highlightCircular = true, enableSearch = true, enableFilters = true, } = options;
+        // Prepare data for D3.js
+        const nodes = graph.nodes.map(node => ({
+            id: node.id,
+            name: node.name,
+            type: node.type,
+            repo: node.repo,
+            isCircular: this.isNodeInCircularDep(node.id, circularDeps),
+        }));
+        const links = graph.edges.map(edge => ({
+            source: edge.from,
+            target: edge.to,
+            type: edge.type,
+            count: edge.count,
+        }));
+        // Generate HTML with embedded D3.js
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title}</title>
+  <script src="https://d3js.org/d3.v7.min.js"></script>
+  <style>
+    body {
+      margin: 0;
+      font-family: Arial, sans-serif;
+      overflow: hidden;
+    }
+    #graph {
+      width: 100vw;
+      height: 100vh;
+    }
+    .controls {
+      position: absolute;
+      top: 10px;
+      left: 10px;
+      background: white;
+      padding: 15px;
+      border-radius: 8px;
+      box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+      z-index: 1000;
+    }
+    .controls h3 {
+      margin: 0 0 10px 0;
+      font-size: 16px;
+    }
+    .controls input[type="text"] {
+      width: 200px;
+      padding: 5px;
+      margin-bottom: 10px;
+    }
+    .controls label {
+      display: block;
+      margin: 5px 0;
+      font-size: 14px;
+    }
+    .node {
+      cursor: pointer;
+      stroke: #fff;
+      stroke-width: 2px;
+    }
+    .node.component { fill: #4A90E2; }
+    .node.service { fill: #7ED321; }
+    .node.util { fill: #F5A623; }
+    .node.config { fill: #BD10E0; }
+    .node.circular { fill: #D0021B; }
+    .link {
+      stroke: #999;
+      stroke-opacity: 0.6;
+      stroke-width: 1.5px;
+    }
+    .link-label {
+      font-size: 10px;
+      fill: #666;
+    }
+    .detail-panel {
+      position: absolute;
+      top: 10px;
+      right: 10px;
+      width: 300px;
+      background: white;
+      padding: 15px;
+      border-radius: 8px;
+      box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+      z-index: 1000;
+      display: none;
+    }
+    .detail-panel h3 {
+      margin: 0 0 10px 0;
+      font-size: 16px;
+    }
+    .detail-panel .close {
+      float: right;
+      cursor: pointer;
+      font-size: 18px;
+      font-weight: bold;
+    }
+  </style>
+</head>
+<body>
+  <div class="controls">
+    <h3>Controls</h3>
+    ${enableSearch ? '<input type="text" id="search" placeholder="Search modules...">' : ''}
+    ${enableFilters ? `
+    <div>
+      <label><input type="checkbox" class="filter" value="component" checked> Components</label>
+      <label><input type="checkbox" class="filter" value="service" checked> Services</label>
+      <label><input type="checkbox" class="filter" value="util" checked> Utils</label>
+      <label><input type="checkbox" class="filter" value="config" checked> Config</label>
+    </div>
+    ` : ''}
+    <p style="margin-top: 10px; font-size: 12px; color: #666;">
+      Zoom: Scroll | Pan: Drag | Click: Details
+    </p>
+  </div>
+  <div class="detail-panel" id="detailPanel">
+    <span class="close" onclick="document.getElementById('detailPanel').style.display='none'">&times;</span>
+    <h3 id="detailTitle"></h3>
+    <div id="detailContent"></div>
+  </div>
+  <svg id="graph"></svg>
+  <script>
+    const graphData = {
+      nodes: ${JSON.stringify(nodes)},
+      links: ${JSON.stringify(links)}
+    };
+    const width = window.innerWidth;
+    const height = window.innerHeight;
+    const svg = d3.select('#graph')
+      .attr('width', width)
+      .attr('height', height);
+    const g = svg.append('g');
+    // Zoom behavior
+    const zoom = d3.zoom()
+      .scaleExtent([0.1, 4])
+      .on('zoom', (event) => {
+        g.attr('transform', event.transform);
+      });
+    svg.call(zoom);
+    // Force simulation
+    const simulation = d3.forceSimulation(graphData.nodes)
+      .force('link', d3.forceLink(graphData.links).id(d => d.id).distance(100))
+      .force('charge', d3.forceManyBody().strength(-300))
+      .force('center', d3.forceCenter(width / 2, height / 2))
+      .force('collision', d3.forceCollide().radius(30));
+    // Links
+    const link = g.append('g')
+      .selectAll('line')
+      .data(graphData.links)
+      .join('line')
+      .attr('class', 'link');
+    // Nodes
+    const node = g.append('g')
+      .selectAll('circle')
+      .data(graphData.nodes)
+      .join('circle')
+      .attr('class', d => \`node \${d.isCircular ? 'circular' : d.type}\`)
+      .attr('r', 10)
+      .call(d3.drag()
+        .on('start', dragstarted)
+        .on('drag', dragged)
+        .on('end', dragended))
+      .on('click', showDetails);
+    // Labels
+    const label = g.append('g')
+      .selectAll('text')
+      .data(graphData.nodes)
+      .join('text')
+      .text(d => d.name)
+      .attr('font-size', 12)
+      .attr('dx', 15)
+      .attr('dy', 4);
+    simulation.on('tick', () => {
+      link
+        .attr('x1', d => d.source.x)
+        .attr('y1', d => d.source.y)
+        .attr('x2', d => d.target.x)
+        .attr('y2', d => d.target.y);
+      node
+        .attr('cx', d => d.x)
+        .attr('cy', d => d.y);
+      label
+        .attr('x', d => d.x)
+        .attr('y', d => d.y);
+    });
+    // Drag functions
+    function dragstarted(event, d) {
+      if (!event.active) simulation.alphaTarget(0.3).restart();
+      d.fx = d.x;
+      d.fy = d.y;
+    }
+    function dragged(event, d) {
+      d.fx = event.x;
+      d.fy = event.y;
+    }
+    function dragended(event, d) {
+      if (!event.active) simulation.alphaTarget(0);
+      d.fx = null;
+      d.fy = null;
+    }
+    // Show details panel
+    function showDetails(event, d) {
+      const panel = document.getElementById('detailPanel');
+      const title = document.getElementById('detailTitle');
+      const content = document.getElementById('detailContent');
+      title.textContent = d.name;
+      const dependencies = graphData.links.filter(l => l.source.id === d.id);
+      const dependents = graphData.links.filter(l => l.target.id === d.id);
+      content.innerHTML = \`
+        <p><strong>Type:</strong> \${d.type}</p>
+        <p><strong>Repo:</strong> \${d.repo}</p>
+        <p><strong>Dependencies:</strong> \${dependencies.length}</p>
+        <p><strong>Dependents:</strong> \${dependents.length}</p>
+        \${d.isCircular ? '<p style="color: red;"><strong>⚠️ Part of circular dependency!</strong></p>' : ''}
+      \`;
+      panel.style.display = 'block';
+    }
+    // Search functionality
+    ${enableSearch ? `
+    document.getElementById('search').addEventListener('input', (e) => {
+      const query = e.target.value.toLowerCase();
+      node.style('opacity', d => d.name.toLowerCase().includes(query) ? 1 : 0.2);
+      label.style('opacity', d => d.name.toLowerCase().includes(query) ? 1 : 0.2);
+    });
+    ` : ''}
+    // Filter functionality
+    ${enableFilters ? `
+    document.querySelectorAll('.filter').forEach(checkbox => {
+      checkbox.addEventListener('change', () => {
+        const activeFilters = Array.from(document.querySelectorAll('.filter:checked')).map(c => c.value);
+        node.style('display', d => activeFilters.includes(d.type) ? 'block' : 'none');
+        label.style('display', d => activeFilters.includes(d.type) ? 'block' : 'none');
+      });
+    });
+    ` : ''}
+  </script>
+</body>
+</html>`;
+    }
+    isNodeInCircularDep(nodeId, circularDeps) {
+        return circularDeps.some(dep => dep.cycle.includes(nodeId));
+    }
+}
+//# sourceMappingURL=graph-visualizer.js.map

package/dist/src/core/living-docs/intelligent-analyzer/graph-visualizer.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"graph-visualizer.js","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/graph-visualizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B;;OAEG;IACH,wBAAwB,CACtB,KAAkB,EAClB,eAA8B,EAAE,EAChC,UAAkC,EAAE;QAEpC,MAAM,EACJ,KAAK,GAAG,yBAAyB,EACjC,iBAAiB,GAAG,IAAI,EACxB,YAAY,GAAG,IAAI,EACnB,aAAa,GAAG,IAAI,GACrB,GAAG,OAAO,CAAC;QAEZ,yBAAyB;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,CAAC;SAC5D,CAAC,CAAC,CAAC;QAEJ,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC,CAAC;QAEJ,oCAAoC;QACpC,OAAO;;;;;WAKA,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAkFV,YAAY,CAAC,CAAC,CAAC,iEAAiE,CAAC,CAAC,CAAC,EAAE;MACrF,aAAa,CAAC,CAAC,CAAC;;;;;;;KAOjB,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;eAgBK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;eACrB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmH9B,YAAY,CAAC,CAAC,CAAC;;;;;;KAMhB,CAAC,CAAC,CAAC,EAAE;;;MAGJ,aAAa,CAAC,CAAC,CAAC;;;;;;;;KAQjB,CAAC,CAAC,CAAC,EAAE;;;QAGF,CAAC;IACP,CAAC;IAEO,mBAAmB,CAAC,MAAc,EAAE,YAA2B;QACrE,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/src/core/living-docs/intelligent-analyzer/mermaid-generator.d.ts ADDED Viewed

@@ -0,0 +1,44 @@
+/**
+ * Mermaid Diagram Generator
+ *
+ * Exports module graphs and team structures to Mermaid diagram format.
+ */
+export interface ModuleGraph {
+    nodes: Module[];
+    edges: Dependency[];
+}
+export interface Module {
+    id: string;
+    name: string;
+    path: string;
+    type: 'component' | 'service' | 'util' | 'config';
+    repo: string;
+}
+export interface Dependency {
+    from: string;
+    to: string;
+    type: 'import' | 'require' | 'dynamic';
+    count: number;
+}
+export interface CircularDep {
+    cycle: string[];
+    severity: 'warning' | 'error';
+}
+/**
+ * Generates Mermaid diagrams from module graphs.
+ */
+export declare class MermaidGenerator {
+    /**
+     * Export module graph to Mermaid diagram.
+     */
+    exportModuleGraph(graph: ModuleGraph, circularDeps?: CircularDep[]): string;
+    /**
+     * Export team structure to Mermaid organization chart.
+     */
+    exportTeamStructure(teams: any[]): string;
+    /**
+     * Sanitize ID for Mermaid (remove special characters).
+     */
+    private sanitizeId;
+}
+//# sourceMappingURL=mermaid-generator.d.ts.map

package/dist/src/core/living-docs/intelligent-analyzer/mermaid-generator.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"mermaid-generator.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/mermaid-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM;IA4B3E;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM;IAoBzC;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}

package/dist/src/core/living-docs/intelligent-analyzer/mermaid-generator.js ADDED Viewed

@@ -0,0 +1,61 @@
+/**
+ * Mermaid Diagram Generator
+ *
+ * Exports module graphs and team structures to Mermaid diagram format.
+ */
+/**
+ * Generates Mermaid diagrams from module graphs.
+ */
+export class MermaidGenerator {
+    /**
+     * Export module graph to Mermaid diagram.
+     */
+    exportModuleGraph(graph, circularDeps) {
+        let mmd = 'graph TD\n';
+        // Add nodes
+        for (const node of graph.nodes) {
+            const label = `${node.name}\\n(${node.type})`;
+            mmd += `  ${this.sanitizeId(node.id)}["${label}"]\n`;
+        }
+        mmd += '\n';
+        // Add edges
+        for (const edge of graph.edges) {
+            mmd += `  ${this.sanitizeId(edge.from)} --> ${this.sanitizeId(edge.to)}\n`;
+        }
+        // Highlight circular dependencies
+        if (circularDeps && circularDeps.length > 0) {
+            mmd += '\n  %% Circular dependencies highlighted in red\n';
+            for (const cycle of circularDeps) {
+                const ids = cycle.cycle.map(id => this.sanitizeId(id)).join(',');
+                mmd += `  style ${ids} fill:#ff6b6b\n`;
+            }
+        }
+        return mmd;
+    }
+    /**
+     * Export team structure to Mermaid organization chart.
+     */
+    exportTeamStructure(teams) {
+        let mmd = 'graph TD\n';
+        mmd += '  ROOT[Organization]\n\n';
+        for (const team of teams) {
+            const teamId = this.sanitizeId(team.name);
+            mmd += `  ROOT --> ${teamId}["${team.name}"]\n`;
+            // Add team members/repos
+            if (team.repos) {
+                for (const repo of team.repos) {
+                    const repoId = this.sanitizeId(`${team.name}-${repo}`);
+                    mmd += `  ${teamId} --> ${repoId}["${repo}"]\n`;
+                }
+            }
+        }
+        return mmd;
+    }
+    /**
+     * Sanitize ID for Mermaid (remove special characters).
+     */
+    sanitizeId(id) {
+        return id.replace(/[^a-zA-Z0-9_]/g, '_');
+    }
+}
+//# sourceMappingURL=mermaid-generator.js.map

package/dist/src/core/living-docs/intelligent-analyzer/mermaid-generator.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"mermaid-generator.js","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/mermaid-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,iBAAiB,CAAC,KAAkB,EAAE,YAA4B;QAChE,IAAI,GAAG,GAAG,YAAY,CAAC;QAEvB,YAAY;QACZ,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC;YAC9C,GAAG,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC;QACvD,CAAC;QAED,GAAG,IAAI,IAAI,CAAC;QAEZ,YAAY;QACZ,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,GAAG,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAC7E,CAAC;QAED,kCAAkC;QAClC,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,GAAG,IAAI,mDAAmD,CAAC;YAC3D,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjE,GAAG,IAAI,WAAW,GAAG,iBAAiB,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,KAAY;QAC9B,IAAI,GAAG,GAAG,YAAY,CAAC;QACvB,GAAG,IAAI,0BAA0B,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,GAAG,IAAI,cAAc,MAAM,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC;YAEhD,yBAAyB;YACzB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;oBACvD,GAAG,IAAI,KAAK,MAAM,QAAQ,MAAM,KAAK,IAAI,MAAM,CAAC;gBAClD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,EAAU;QAC3B,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/src/core/living-docs/intelligent-analyzer/orchestrator.d.ts ADDED Viewed

@@ -0,0 +1,126 @@
+/**
+ * Living Docs Orchestrator
+ *
+ * Main coordinator that manages the entire analysis pipeline with caching and change detection.
+ *
+ * Architecture:
+ * Phase 1: Discovery (repo scanning)
+ * Phase 2: Analysis (patterns, modules, tech debt)
+ * Phase 3: Synthesis (ADR generation with LLM)
+ */
+import { Logger } from '../../../utils/logger.js';
+import type { RepoAnalysis, LLMProvider } from './types.js';
+export interface OrchestratorOptions {
+    projectRoot: string;
+    logger?: Logger;
+    llmProvider?: LLMProvider;
+}
+export interface UpdateOptions {
+    incremental?: boolean;
+    full?: boolean;
+    adrOnly?: boolean;
+    techDebtOnly?: boolean;
+    modulesOnly?: boolean;
+    dryRun?: boolean;
+}
+export interface DiscoveryResult {
+    repos: Array<{
+        name: string;
+        path: string;
+    }>;
+    totalFiles: number;
+    duration: number;
+}
+export interface AnalysisResult {
+    repoAnalyses: Map<string, RepoAnalysis>;
+    duration: number;
+    filesCreated?: string[];
+}
+export interface SynthesisResult {
+    adrsGenerated: number;
+    teamsClustered: number;
+    duration: number;
+    filesCreated?: string[];
+}
+export interface PhaseResult {
+    success: boolean;
+    duration: number;
+    message: string;
+}
+export interface UpdateResult {
+    success: boolean;
+    duration: number;
+    phases: {
+        discovery: PhaseResult;
+        analysis: PhaseResult;
+        synthesis: PhaseResult;
+    };
+    filesCreated: string[];
+    filesUpdated: string[];
+    errors: string[];
+}
+export interface ChangedFiles {
+    path: string;
+    status: 'added' | 'modified' | 'deleted';
+}
+/**
+ * Main orchestrator for living docs intelligent analysis.
+ *
+ * Coordinates all analysis phases with caching and Git-based change detection.
+ */
+export declare class LivingDocsOrchestrator {
+    private projectRoot;
+    private logger;
+    private llmProvider?;
+    private cacheDir;
+    constructor(options: OrchestratorOptions);
+    /**
+     * Main entry point - orchestrates full update or incremental update.
+     */
+    update(options?: UpdateOptions): Promise<UpdateResult>;
+    /**
+     * Phase 1: Discovery
+     * Scans all repos (umbrella or single) and creates file inventory.
+     */
+    private executePhase1Discovery;
+    /**
+     * Phase 2: Analysis
+     * Pattern detection, module graph, tech debt detection.
+     */
+    private executePhase2Analysis;
+    /**
+     * Phase 3: Synthesis
+     * LLM-powered ADR synthesis, team clustering, architecture docs.
+     */
+    private executePhase3Synthesis;
+    /**
+     * Detect changes since last update using Git diff.
+     */
+    detectChanges(): Promise<ChangedFiles[]>;
+    /**
+     * Load data from cache.
+     */
+    loadFromCache<T>(key: string): Promise<T | null>;
+    /**
+     * Save data to cache.
+     */
+    saveToCache(key: string, data: any): Promise<void>;
+    /**
+     * Clear all cache and checkpoint data.
+     * Used when --full flag is set to force complete rebuild.
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Discover all repos (umbrella or single).
+     */
+    private discoverRepos;
+    /**
+     * Get current Git commit hash.
+     */
+    private getCurrentCommit;
+    /**
+     * Count files in a directory (excluding node_modules, .git, etc.).
+     */
+    private countFiles;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/src/core/living-docs/intelligent-analyzer/orchestrator.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/orchestrator.ts"],"names":[],"mappings":"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"}