@monoes/monograph 1.1.0 → 1.2.0

package/dist/src/groups/group-search.js

@@ -0,0 +1,112 @@
+/**
+ * Group Search
+ *
+ * Merged BM25 search across multiple repos using Reciprocal Rank Fusion (RRF).
+ */
+import { join } from 'path';
+import { existsSync } from 'fs';
+import Database from 'better-sqlite3';
+/**
+ * Determine the monograph DB path for a given repo root.
+ * Mirrors the convention used in monograph-tools.ts: <repoPath>/.monomind/monograph.db
+ */
+function getRepoDbPath(repoPath) {
+    return join(repoPath, '.monomind', 'monograph.db');
+}
+/**
+ * Run BM25 FTS5 search against a single repo DB.
+ * Returns raw rows tagged with the repo name.
+ */
+function searchRepo(dbPath, repoName, query, perRepoLimit) {
+    if (!existsSync(dbPath)) {
+        console.warn(`[group-search] Skipping repo "${repoName}": DB not found at ${dbPath}`);
+        return [];
+    }
+    let db = null;
+    try {
+        db = new Database(dbPath, { readonly: true });
+        // Sanitize and build prefix query
+        const safeQuery = query.replace(/['"*]/g, ' ').trim();
+        if (!safeQuery)
+            return [];
+        const ftsPrefixQuery = safeQuery
+            .split(/\s+/)
+            .map((t) => t + '*')
+            .join(' ');
+        const sql = `
+      SELECT n.id, n.name, n.label, n.file_path
+      FROM nodes_fts
+      JOIN nodes n ON n.rowid = nodes_fts.rowid
+      WHERE nodes_fts MATCH ?
+      ORDER BY nodes_fts.rank
+      LIMIT ?
+    `;
+        const rows = db.prepare(sql).all(ftsPrefixQuery, perRepoLimit);
+        return rows.map((r, idx) => ({
+            id: `${repoName}::${r.id}`,
+            name: r.name,
+            label: r.label,
+            filePath: r.file_path ?? null,
+            repo: repoName,
+            // Use rank position as initial score so RRF can compute correctly
+            score: 1 / (60 + idx + 1),
+        }));
+    }
+    catch (err) {
+        console.warn(`[group-search] Error searching repo "${repoName}": ${err}`);
+        return [];
+    }
+    finally {
+        db?.close();
+    }
+}
+/**
+ * Search across all repos in a group and merge results using RRF.
+ *
+ * @param groupConfig - Parsed group configuration
+ * @param query       - Search query string
+ * @param options     - Optional limit (default 20)
+ * @returns Merged and re-ranked results
+ */
+export async function groupQuery(groupConfig, query, options) {
+    const limit = options?.limit ?? 20;
+    const perRepoLimit = 50;
+    // Collect results from each repo
+    const repoResults = [];
+    for (const repo of groupConfig.repos) {
+        const dbPath = getRepoDbPath(repo.path);
+        const results = searchRepo(dbPath, repo.name, query, perRepoLimit);
+        if (results.length > 0) {
+            repoResults.push(results);
+        }
+    }
+    if (repoResults.length === 0)
+        return [];
+    const scoreMap = new Map();
+    for (const results of repoResults) {
+        for (let idx = 0; idx < results.length; idx++) {
+            const item = results[idx];
+            const contribution = 1 / (60 + idx + 1);
+            const existing = scoreMap.get(item.id);
+            if (existing) {
+                existing.rrf += contribution;
+            }
+            else {
+                scoreMap.set(item.id, { rrf: contribution, payload: item });
+            }
+        }
+    }
+    const merged = [...scoreMap.values()]
+        .sort((a, b) => b.rrf - a.rrf)
+        .map(({ rrf, payload }) => ({ ...payload, score: rrf }));
+    // Build final output, preserving repo metadata from merged payload
+    return merged.slice(0, limit).map((r) => ({
+        id: r.id,
+        name: r.name ?? '',
+        label: r.label ?? '',
+        filePath: r.filePath ?? null,
+        repo: r.repo ?? '',
+        score: r.score,
+    }));
+}
+//# sourceMappingURL=group-search.js.map

package/dist/src/groups/group-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-search.js","sourceRoot":"","sources":["../../../src/groups/group-search.ts"],"names":[],"mappings":"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"}

package/dist/src/groups/group-sync.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Group Sync
+ *
+ * Rebuilds the Contract Registry for a group by scanning each repo's
+ * monograph database for Route nodes and finding cross-repo HTTP contracts.
+ */
+export interface GroupSyncResult {
+    group: string;
+    reposScanned: number;
+    contractsFound: number;
+    crossRepoLinks: number;
+    registryPath: string;
+}
+/**
+ * Rebuild the contract registry for a group defined by a group.yaml file.
+ *
+ * For each repo in the group, opens its monograph database and extracts HTTP
+ * contracts. Cross-repo links are identified and persisted to a SQLite
+ * registry at `<group_config_dir>/.monograph-group/<groupName>.contracts.db`.
+ *
+ * Repos whose database does not exist are warned and skipped.
+ *
+ * @param configPath - Absolute path to the group.yaml file
+ * @returns Summary of what was synced
+ */
+export declare function syncGroup(configPath: string): Promise<GroupSyncResult>;
+//# sourceMappingURL=group-sync.d.ts.map

package/dist/src/groups/group-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sync.d.ts","sourceRoot":"","sources":["../../../src/groups/group-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA2C5E"}

package/dist/src/groups/group-sync.js

@@ -0,0 +1,60 @@
+/**
+ * Group Sync
+ *
+ * Rebuilds the Contract Registry for a group by scanning each repo's
+ * monograph database for Route nodes and finding cross-repo HTTP contracts.
+ */
+import { join, dirname } from 'path';
+import { existsSync } from 'fs';
+import Database from 'better-sqlite3';
+import { parseGroupConfig } from './group-config.js';
+import { extractHttpContracts, buildContractLinks, saveContractRegistry } from './contract-registry.js';
+// ── Implementation ────────────────────────────────────────────────────────────
+/**
+ * Rebuild the contract registry for a group defined by a group.yaml file.
+ *
+ * For each repo in the group, opens its monograph database and extracts HTTP
+ * contracts. Cross-repo links are identified and persisted to a SQLite
+ * registry at `<group_config_dir>/.monograph-group/<groupName>.contracts.db`.
+ *
+ * Repos whose database does not exist are warned and skipped.
+ *
+ * @param configPath - Absolute path to the group.yaml file
+ * @returns Summary of what was synced
+ */
+export async function syncGroup(configPath) {
+    const config = parseGroupConfig(configPath);
+    const allContracts = [];
+    let reposScanned = 0;
+    for (const repo of config.repos) {
+        const dbPath = join(repo.path, '.monomind', 'monograph.db');
+        if (!existsSync(dbPath)) {
+            console.warn(`[group-sync] Skipping repo "${repo.name}": DB not found at ${dbPath}`);
+            continue;
+        }
+        let db = null;
+        try {
+            db = new Database(dbPath, { readonly: true });
+            const contracts = extractHttpContracts(db, repo.name);
+            allContracts.push(...contracts);
+            reposScanned++;
+        }
+        catch (err) {
+            console.warn(`[group-sync] Error reading repo "${repo.name}": ${err}`);
+        }
+        finally {
+            db?.close();
+        }
+    }
+    const links = buildContractLinks(allContracts);
+    const registryPath = join(dirname(configPath), '.monograph-group', `${config.name}.contracts.db`);
+    saveContractRegistry(registryPath, links, allContracts);
+    return {
+        group: config.name,
+        reposScanned,
+        contractsFound: allContracts.length,
+        crossRepoLinks: links.length,
+        registryPath,
+    };
+}
+//# sourceMappingURL=group-sync.js.map

package/dist/src/groups/group-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sync.js","sourceRoot":"","sources":["../../../src/groups/group-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAaxG,iFAAiF;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAkB;IAChD,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE5C,MAAM,YAAY,GAAmB,EAAE,CAAC;IACxC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,IAAI,sBAAsB,MAAM,EAAE,CAAC,CAAC;YACrF,SAAS;QACX,CAAC;QAED,IAAI,EAAE,GAA6B,IAAI,CAAC;QACxC,IAAI,CAAC;YACH,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACtD,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;YAChC,YAAY,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,oCAAoC,IAAI,CAAC,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;QACzE,CAAC;gBAAS,CAAC;YACT,EAAE,EAAE,KAAK,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAE/C,MAAM,YAAY,GAAG,IAAI,CACvB,OAAO,CAAC,UAAU,CAAC,EACnB,kBAAkB,EAClB,GAAG,MAAM,CAAC,IAAI,eAAe,CAC9B,CAAC;IAEF,oBAAoB,CAAC,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAExD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI;QAClB,YAAY;QACZ,cAAc,EAAE,YAAY,CAAC,MAAM;QACnC,cAAc,EAAE,KAAK,CAAC,MAAM;QAC5B,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/src/groups/grpc-extractor.d.ts

@@ -0,0 +1,10 @@
+export type GrpcRole = 'provider' | 'consumer';
+export interface GrpcContract {
+    serviceName: string;
+    role: GrpcRole;
+    methods: string[];
+    filePath: string;
+    packageName?: string;
+}
+export declare function extractGrpcContracts(source: string, filePath: string): GrpcContract[];
+//# sourceMappingURL=grpc-extractor.d.ts.map

package/dist/src/groups/grpc-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-extractor.d.ts","sourceRoot":"","sources":["../../../src/groups/grpc-extractor.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAcD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAyCrF"}

package/dist/src/groups/grpc-extractor.js

@@ -0,0 +1,52 @@
+// Proto: service definition
+// Matches service bodies up to one level of nested braces (covers rpc Foo() returns (Bar) {})
+const PROTO_SERVICE_RE = /\bservice\s+(\w+)\s*\{((?:[^{}]|\{[^}]*\})*)\}/gs;
+const PROTO_RPC_RE = /\brpc\s+(\w+)\s*\(/g;
+const PROTO_PACKAGE_RE = /^package\s+([\w.]+);/m;
+// Consumer patterns
+const GO_CLIENT_RE = /\bNew(\w+)Client\s*\(/g;
+const NODE_CLIENT_RE = /new\s+(\w+)Client\s*\(/g;
+const PYTHON_STUB_RE = /\bpb2_grpc\.(\w+)Stub\s*\(/g;
+const JAVA_CLIENT_RE = /(\w+)Grpc\.new\w+Stub\s*\(/g;
+export function extractGrpcContracts(source, filePath) {
+    const results = [];
+    const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+    if (ext === 'proto') {
+        const packageMatch = PROTO_PACKAGE_RE.exec(source);
+        const packageName = packageMatch?.[1];
+        PROTO_SERVICE_RE.lastIndex = 0;
+        let m;
+        while ((m = PROTO_SERVICE_RE.exec(source)) !== null) {
+            const serviceName = m[1];
+            const body = m[2];
+            const methods = [];
+            PROTO_RPC_RE.lastIndex = 0;
+            let rpc;
+            while ((rpc = PROTO_RPC_RE.exec(body)) !== null) {
+                methods.push(rpc[1]);
+            }
+            results.push({ serviceName, role: 'provider', methods, filePath, packageName });
+        }
+        return results;
+    }
+    // Consumer detection by file type
+    const consumerPatterns = [];
+    if (ext === 'go')
+        consumerPatterns.push([GO_CLIENT_RE, 'Service']);
+    else if (['ts', 'js', 'mjs'].includes(ext))
+        consumerPatterns.push([NODE_CLIENT_RE, 'Service']);
+    else if (ext === 'py')
+        consumerPatterns.push([PYTHON_STUB_RE, '']);
+    else if (['java', 'kt'].includes(ext))
+        consumerPatterns.push([JAVA_CLIENT_RE, '']);
+    for (const [re, suffix] of consumerPatterns) {
+        re.lastIndex = 0;
+        let m;
+        while ((m = re.exec(source)) !== null) {
+            const name = m[1] + suffix;
+            results.push({ serviceName: name, role: 'consumer', methods: [], filePath });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=grpc-extractor.js.map

package/dist/src/groups/grpc-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-extractor.js","sourceRoot":"","sources":["../../../src/groups/grpc-extractor.ts"],"names":[],"mappings":"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"}

package/dist/src/groups/service-boundary.d.ts

@@ -0,0 +1,30 @@
+export interface ServiceBoundary {
+    /** Absolute path to the service root directory */
+    servicePath: string;
+    /** Derived service name (directory name) */
+    serviceName: string;
+    /** List of marker filenames found in this service directory */
+    markers: string[];
+    /** Confidence score 0–1 based on number/weight of markers found */
+    confidence: number;
+}
+/**
+ * Walk a root directory and identify service boundaries by looking for
+ * well-known manifest/configuration files in each immediate subdirectory.
+ *
+ * Only examines one level deep (immediate children of rootDir) to avoid
+ * false positives from nested node_modules or dist directories.
+ *
+ * @param rootDir - Root directory to scan (e.g., monorepo root)
+ * @returns Array of detected service boundaries
+ */
+export declare function detectServiceBoundaries(rootDir: string): ServiceBoundary[];
+/**
+ * Determine which service boundary a given file belongs to.
+ *
+ * @param filePath - Absolute path to the file
+ * @param boundaries - List of detected service boundaries
+ * @returns The matching ServiceBoundary, or undefined if none match
+ */
+export declare function assignService(filePath: string, boundaries: ServiceBoundary[]): ServiceBoundary | undefined;
+//# sourceMappingURL=service-boundary.d.ts.map

package/dist/src/groups/service-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-boundary.d.ts","sourceRoot":"","sources":["../../../src/groups/service-boundary.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACpB;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAkD1E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,EAAE,GAC5B,eAAe,GAAG,SAAS,CAiB7B"}

package/dist/src/groups/service-boundary.js

@@ -0,0 +1,97 @@
+import { readdirSync, statSync, existsSync } from 'fs';
+import { join, relative } from 'path';
+/** Weighted service markers. Higher weight = stronger signal. */
+const SERVICE_MARKERS = {
+    'package.json': 1.0,
+    'go.mod': 1.0,
+    'Cargo.toml': 1.0,
+    'pyproject.toml': 0.9,
+    'setup.py': 0.8,
+    'pom.xml': 1.0,
+    'build.gradle': 0.9,
+    'Dockerfile': 0.8,
+    'docker-compose.yml': 0.7,
+    'docker-compose.yaml': 0.7,
+    '.gitmodules': 0.5,
+};
+/**
+ * Walk a root directory and identify service boundaries by looking for
+ * well-known manifest/configuration files in each immediate subdirectory.
+ *
+ * Only examines one level deep (immediate children of rootDir) to avoid
+ * false positives from nested node_modules or dist directories.
+ *
+ * @param rootDir - Root directory to scan (e.g., monorepo root)
+ * @returns Array of detected service boundaries
+ */
+export function detectServiceBoundaries(rootDir) {
+    if (!existsSync(rootDir))
+        return [];
+    const boundaries = [];
+    let entries;
+    try {
+        entries = readdirSync(rootDir);
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        const entryPath = join(rootDir, entry);
+        let stat;
+        try {
+            stat = statSync(entryPath);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        // Skip hidden dirs and common non-service dirs
+        if (entry.startsWith('.') || entry === 'node_modules' || entry === 'dist' || entry === 'build') {
+            continue;
+        }
+        const foundMarkers = [];
+        let totalWeight = 0;
+        for (const [marker, weight] of Object.entries(SERVICE_MARKERS)) {
+            if (existsSync(join(entryPath, marker))) {
+                foundMarkers.push(marker);
+                totalWeight += weight;
+            }
+        }
+        if (foundMarkers.length === 0)
+            continue;
+        // Confidence: cap at 1.0, based on total marker weight
+        const confidence = Math.min(1.0, totalWeight);
+        boundaries.push({
+            servicePath: entryPath,
+            serviceName: entry,
+            markers: foundMarkers,
+            confidence,
+        });
+    }
+    return boundaries.sort((a, b) => b.confidence - a.confidence);
+}
+/**
+ * Determine which service boundary a given file belongs to.
+ *
+ * @param filePath - Absolute path to the file
+ * @param boundaries - List of detected service boundaries
+ * @returns The matching ServiceBoundary, or undefined if none match
+ */
+export function assignService(filePath, boundaries) {
+    // Find the boundary with the longest matching prefix (most specific)
+    let best;
+    let bestLen = 0;
+    for (const boundary of boundaries) {
+        const rel = relative(boundary.servicePath, filePath);
+        // relative() returns a path that starts with '..' if filePath is outside boundary
+        if (!rel.startsWith('..') && rel !== '' && rel !== '.') {
+            if (boundary.servicePath.length > bestLen) {
+                bestLen = boundary.servicePath.length;
+                best = boundary;
+            }
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=service-boundary.js.map

package/dist/src/groups/service-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-boundary.js","sourceRoot":"","sources":["../../../src/groups/service-boundary.ts"],"names":[],"mappings":"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"}

package/dist/src/groups/topic-extractor.d.ts

@@ -0,0 +1,10 @@
+export type TopicRole = 'producer' | 'consumer';
+export type BrokerType = 'kafka' | 'rabbitmq' | 'sqs' | 'pubsub' | 'unknown';
+export interface TopicContract {
+    topicName: string;
+    role: TopicRole;
+    broker: BrokerType;
+    filePath: string;
+}
+export declare function extractTopicContracts(source: string, filePath: string): TopicContract[];
+//# sourceMappingURL=topic-extractor.d.ts.map

package/dist/src/groups/topic-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-extractor.d.ts","sourceRoot":"","sources":["../../../src/groups/topic-extractor.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAyDvF"}

package/dist/src/groups/topic-extractor.js

@@ -0,0 +1,76 @@
+// Kafka patterns
+const KAFKA_PRODUCE_RE = /(?:producer\.send|sendMessage)\s*\(\s*\{[^}]*?topic\s*:\s*['"`]([^'"`]+)['"`]/g;
+const KAFKA_CONSUME_RE = /consumer\.subscribe\s*\(\s*\{[^}]*?topic\s*:\s*['"`]([^'"`]+)['"`]/g;
+// RabbitMQ patterns — publish/assertExchange = producer, bindQueue/consume = consumer
+const RABBIT_PRODUCE_RE = /channel\.(?:assertExchange|publish)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+const RABBIT_CONSUME_RE = /channel\.(?:bindQueue|consume)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+// AWS SQS
+const SQS_SEND_RE = /(?:sendMessage|SendMessage)\s*\(\s*\{[^}]*?QueueUrl\s*:\s*['"`][^'"`]*\/([^'"`/]+)['"`]/g;
+// Generic topic string patterns (fallback)
+const GENERIC_TOPIC_RE = /(?:topic|TOPIC|queue|QUEUE)\s*[:=]\s*['"`]([a-z][a-z0-9._-]{2,})['"`]/g;
+function detectBroker(source) {
+    if (/kafka/i.test(source) || /kafkajs/i.test(source))
+        return 'kafka';
+    if (/amqplib|rabbitmq|channel\./i.test(source))
+        return 'rabbitmq';
+    if (/SQSClient|aws-sdk.*SQS/i.test(source))
+        return 'sqs';
+    if (/@google-cloud\/pubsub/i.test(source))
+        return 'pubsub';
+    return 'unknown';
+}
+export function extractTopicContracts(source, filePath) {
+    const results = [];
+    const broker = detectBroker(source);
+    if (broker === 'kafka' || broker === 'unknown') {
+        KAFKA_PRODUCE_RE.lastIndex = 0;
+        let m;
+        while ((m = KAFKA_PRODUCE_RE.exec(source)) !== null) {
+            results.push({ topicName: m[1], role: 'producer', broker: 'kafka', filePath });
+        }
+        KAFKA_CONSUME_RE.lastIndex = 0;
+        while ((m = KAFKA_CONSUME_RE.exec(source)) !== null) {
+            results.push({ topicName: m[1], role: 'consumer', broker: 'kafka', filePath });
+        }
+    }
+    if (broker === 'rabbitmq' || broker === 'unknown') {
+        RABBIT_PRODUCE_RE.lastIndex = 0;
+        let m;
+        while ((m = RABBIT_PRODUCE_RE.exec(source)) !== null) {
+            results.push({ topicName: m[1], role: 'producer', broker: 'rabbitmq', filePath });
+        }
+        RABBIT_CONSUME_RE.lastIndex = 0;
+        while ((m = RABBIT_CONSUME_RE.exec(source)) !== null) {
+            results.push({ topicName: m[1], role: 'consumer', broker: 'rabbitmq', filePath });
+        }
+    }
+    if (broker === 'sqs') {
+        SQS_SEND_RE.lastIndex = 0;
+        let m;
+        while ((m = SQS_SEND_RE.exec(source)) !== null) {
+            results.push({ topicName: m[1], role: 'producer', broker: 'sqs', filePath });
+        }
+        // SQS receive — ReceiveMessage with QueueUrl
+        const SQS_RECV_RE = /(?:receiveMessage|ReceiveMessage)\s*\(\s*\{[^}]*?QueueUrl\s*:\s*['"`][^'"`]*\/([^'"`/]+)['"`]/g;
+        while ((m = SQS_RECV_RE.exec(source)) !== null) {
+            results.push({ topicName: m[1], role: 'consumer', broker: 'sqs', filePath });
+        }
+    }
+    if (results.length === 0 && broker === 'unknown') {
+        GENERIC_TOPIC_RE.lastIndex = 0;
+        let m;
+        while ((m = GENERIC_TOPIC_RE.exec(source)) !== null) {
+            results.push({ topicName: m[1], role: 'producer', broker: 'unknown', filePath });
+        }
+    }
+    // Deduplicate by topicName+role
+    const seen = new Set();
+    return results.filter(r => {
+        const key = `${r.role}:${r.topicName}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=topic-extractor.js.map

package/dist/src/groups/topic-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-extractor.js","sourceRoot":"","sources":["../../../src/groups/topic-extractor.ts"],"names":[],"mappings":"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"}

package/dist/src/health/analysis-counts-snapshot.d.ts

@@ -0,0 +1,20 @@
+export interface FileScoreOutput {
+    complexityModerate: number;
+    complexityHigh: number;
+    complexityCritical: number;
+    crapModerate: number;
+    crapHigh: number;
+    crapCritical: number;
+    functionCount: number;
+    fileLoc: number;
+}
+export interface AnalysisCountsSnapshot {
+    counts: Map<string, FileScoreOutput>;
+}
+export declare function buildAnalysisCountsSnapshot(fileScores: Array<{
+    filePath: string;
+} & FileScoreOutput>): AnalysisCountsSnapshot;
+export declare function countsFor(snapshot: AnalysisCountsSnapshot, roots: string[]): AnalysisCountsSnapshot;
+export declare function serializeSnapshot(snapshot: AnalysisCountsSnapshot): Record<string, FileScoreOutput>;
+export declare function deserializeSnapshot(data: Record<string, FileScoreOutput>): AnalysisCountsSnapshot;
+//# sourceMappingURL=analysis-counts-snapshot.d.ts.map

package/dist/src/health/analysis-counts-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-counts-snapshot.d.ts","sourceRoot":"","sources":["../../../src/health/analysis-counts-snapshot.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACtC;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,GACxD,sBAAsB,CAMxB;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,MAAM,EAAE,GACd,sBAAsB,CAQxB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAMjC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GACpC,sBAAsB,CAMxB"}

package/dist/src/health/analysis-counts-snapshot.js

@@ -0,0 +1,31 @@
+export function buildAnalysisCountsSnapshot(fileScores) {
+    const counts = new Map();
+    for (const { filePath, ...rest } of fileScores) {
+        counts.set(filePath, rest);
+    }
+    return { counts };
+}
+export function countsFor(snapshot, roots) {
+    const filtered = new Map();
+    for (const [key, value] of snapshot.counts) {
+        if (roots.some((root) => key.startsWith(root))) {
+            filtered.set(key, value);
+        }
+    }
+    return { counts: filtered };
+}
+export function serializeSnapshot(snapshot) {
+    const result = {};
+    for (const [key, value] of snapshot.counts) {
+        result[key] = value;
+    }
+    return result;
+}
+export function deserializeSnapshot(data) {
+    const counts = new Map();
+    for (const [key, value] of Object.entries(data)) {
+        counts.set(key, value);
+    }
+    return { counts };
+}
+//# sourceMappingURL=analysis-counts-snapshot.js.map

package/dist/src/health/analysis-counts-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-counts-snapshot.js","sourceRoot":"","sources":["../../../src/health/analysis-counts-snapshot.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,2BAA2B,CACzC,UAAyD;IAEzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,QAAgC,EAChC,KAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC/C,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAgC;IAEhC,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAqC;IAErC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/src/health/analysis-counts.d.ts

@@ -0,0 +1,27 @@
+export interface AnalysisCounts {
+    totalExports: number;
+    deadFiles: number;
+    deadExports: number;
+    unusedDeps: number;
+    circularDeps: number;
+    totalDeps: number;
+    duplicateExports: number;
+    boundaryViolations: number;
+}
+export declare const ZERO_ANALYSIS_COUNTS: AnalysisCounts;
+export interface AnalysisResultsInput {
+    unusedExports?: unknown[];
+    deadFiles?: unknown[];
+    unusedDependencies?: unknown[];
+    circularDependencies?: unknown[];
+    allDependencies?: unknown[];
+    duplicateExports?: unknown[];
+    boundaryViolations?: unknown[];
+}
+/** Compute aggregate counts from analysis results (all fields optional). */
+export declare function computeAnalysisCounts(results: AnalysisResultsInput): AnalysisCounts;
+/** Compute percentages from counts for use in vital signs. */
+export declare function deadCodePct(counts: AnalysisCounts): number;
+export declare function unusedDepsPct(counts: AnalysisCounts): number;
+export declare function formatAnalysisCounts(counts: AnalysisCounts): string;
+//# sourceMappingURL=analysis-counts.d.ts.map

package/dist/src/health/analysis-counts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-counts.d.ts","sourceRoot":"","sources":["../../../src/health/analysis-counts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,oBAAoB,EAAE,cASlC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC/B,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC;CAChC;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CAWnF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAG1D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAG5D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CASnE"}