@monoes/monograph 1.1.0 → 1.2.0

package/dist/src/graph/wcc.js

@@ -0,0 +1,73 @@
+/**
+ * Find all weakly connected components (WCCs) of the graph.
+ *
+ * Treats the directed graph as undirected: an edge A→B connects A and B
+ * regardless of direction. Uses union-find (disjoint-set) for O(α·n) performance.
+ *
+ * @param db - The MonographDb instance
+ * @returns Array of components; each component is an array of node ids.
+ *          Sorted so the largest component comes first.
+ */
+export function weaklyConnectedComponents(db) {
+    const nodeRows = db.prepare('SELECT id FROM nodes').all();
+    const edgeRows = db.prepare('SELECT source_id, target_id FROM edges').all();
+    if (nodeRows.length === 0)
+        return [];
+    const nodes = nodeRows.map(r => r.id);
+    // Union-Find
+    const parent = new Map();
+    const rank = new Map();
+    for (const n of nodes) {
+        parent.set(n, n);
+        rank.set(n, 0);
+    }
+    function find(x) {
+        let root = x;
+        while (parent.get(root) !== root)
+            root = parent.get(root);
+        // Path compression
+        let cur = x;
+        while (cur !== root) {
+            const next = parent.get(cur);
+            parent.set(cur, root);
+            cur = next;
+        }
+        return root;
+    }
+    function union(a, b) {
+        const ra = find(a);
+        const rb = find(b);
+        if (ra === rb)
+            return;
+        const rankA = rank.get(ra) ?? 0;
+        const rankB = rank.get(rb) ?? 0;
+        if (rankA < rankB) {
+            parent.set(ra, rb);
+        }
+        else if (rankA > rankB) {
+            parent.set(rb, ra);
+        }
+        else {
+            parent.set(rb, ra);
+            rank.set(ra, rankA + 1);
+        }
+    }
+    for (const { source_id: src, target_id: tgt } of edgeRows) {
+        if (src === tgt)
+            continue;
+        if (!parent.has(src) || !parent.has(tgt))
+            continue;
+        union(src, tgt);
+    }
+    // Group nodes by root
+    const components = new Map();
+    for (const n of nodes) {
+        const root = find(n);
+        if (!components.has(root))
+            components.set(root, []);
+        components.get(root).push(n);
+    }
+    // Return sorted by size descending
+    return [...components.values()].sort((a, b) => b.length - a.length);
+}
+//# sourceMappingURL=wcc.js.map

package/dist/src/graph/wcc.js.map

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

package/dist/src/groups/contract-bridge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Contract Bridge Detection
+ *
+ * Finds shared type definitions (Interface, Type, Class) that appear across
+ * multiple repos in a group — these are potential contract bridges.
+ */
+import type { GroupConfig } from './group-config.js';
+export interface ContractBridge {
+    /** Shared type name */
+    name: string;
+    /** Repo names that define this type */
+    repos: string[];
+    /** Node labels (Interface, Type, Class, etc.) */
+    labels: string[];
+}
+/**
+ * Detect contract bridges: type names shared across >= 2 repos.
+ * Results sorted by number of repos descending.
+ *
+ * @param groupConfig - Parsed group configuration
+ * @returns List of ContractBridge entries
+ */
+export declare function detectContractBridges(groupConfig: GroupConfig): Promise<ContractBridge[]>;
+//# sourceMappingURL=contract-bridge.d.ts.map

package/dist/src/groups/contract-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-bridge.d.ts","sourceRoot":"","sources":["../../../src/groups/contract-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iDAAiD;IACjD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAmCD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CAuC3B"}

package/dist/src/groups/contract-bridge.js

@@ -0,0 +1,81 @@
+/**
+ * Contract Bridge Detection
+ *
+ * Finds shared type definitions (Interface, Type, Class) that appear across
+ * multiple repos in a group — these are potential contract bridges.
+ */
+import { join } from 'path';
+import { existsSync } from 'fs';
+import Database from 'better-sqlite3';
+function getRepoDbPath(repoPath) {
+    return join(repoPath, '.monomind', 'monograph.db');
+}
+/**
+ * Fetch all Interface, Type, and Class nodes from a repo DB.
+ */
+function fetchTypeNodes(dbPath, repoName) {
+    if (!existsSync(dbPath)) {
+        console.warn(`[contract-bridge] Skipping repo "${repoName}": DB not found at ${dbPath}`);
+        return [];
+    }
+    let db = null;
+    try {
+        db = new Database(dbPath, { readonly: true });
+        const rows = db
+            .prepare(`SELECT name, label FROM nodes WHERE label IN ('Interface', 'Type', 'Class')`)
+            .all();
+        return rows;
+    }
+    catch (err) {
+        console.warn(`[contract-bridge] Error reading repo "${repoName}": ${err}`);
+        return [];
+    }
+    finally {
+        db?.close();
+    }
+}
+/**
+ * Detect contract bridges: type names shared across >= 2 repos.
+ * Results sorted by number of repos descending.
+ *
+ * @param groupConfig - Parsed group configuration
+ * @returns List of ContractBridge entries
+ */
+export async function detectContractBridges(groupConfig) {
+    // Map from type name -> { repos: Set<string>, labels: Set<string> }
+    const typeMap = new Map();
+    for (const repo of groupConfig.repos) {
+        const dbPath = getRepoDbPath(repo.path);
+        const rows = fetchTypeNodes(dbPath, repo.name);
+        for (const row of rows) {
+            if (!row.name)
+                continue;
+            const key = row.name;
+            const existing = typeMap.get(key);
+            if (existing) {
+                existing.repos.add(repo.name);
+                existing.labels.add(row.label);
+            }
+            else {
+                typeMap.set(key, {
+                    repos: new Set([repo.name]),
+                    labels: new Set([row.label]),
+                });
+            }
+        }
+    }
+    const bridges = [];
+    for (const [name, { repos, labels }] of typeMap) {
+        if (repos.size >= 2) {
+            bridges.push({
+                name,
+                repos: [...repos],
+                labels: [...labels],
+            });
+        }
+    }
+    // Sort by number of repos descending, then alphabetically
+    bridges.sort((a, b) => b.repos.length - a.repos.length || a.name.localeCompare(b.name));
+    return bridges;
+}
+//# sourceMappingURL=contract-bridge.js.map

package/dist/src/groups/contract-bridge.js.map

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

package/dist/src/groups/contract-registry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Contract Registry
+ *
+ * Extracts HTTP contracts (Route nodes) from per-repo monograph databases,
+ * identifies cross-repo links (same method + path in 2+ repos), and
+ * persists/loads the registry in a SQLite database.
+ */
+import Database from 'better-sqlite3';
+export interface HttpContract {
+    method: string;
+    path: string;
+    handlerName: string | null;
+    handlerFile: string | null;
+    repo: string;
+}
+export interface ContractLink {
+    path: string;
+    method: string;
+    producerRepo: string;
+    consumerRepos: string[];
+}
+/**
+ * Extract all HTTP contracts (Route nodes) from a monograph database.
+ *
+ * Route nodes store method and path together in the `name` field as
+ * `"METHOD /path"` (e.g., "GET /api/users"). The handler info is obtained by
+ * following HANDLES_ROUTE edges where the Route node is the SOURCE.
+ *
+ * @param db       - Open better-sqlite3 database handle (read-only acceptable)
+ * @param repoName - Logical name for this repo (used to tag returned contracts)
+ * @returns Array of HttpContract objects
+ */
+export declare function extractHttpContracts(db: Database.Database, repoName: string): HttpContract[];
+/**
+ * Group contracts by (method + path) and identify cross-repo links.
+ *
+ * A ContractLink is produced for every (method, path) pair that appears in
+ * 2 or more repos. The first repo encountered for a given pair is treated as
+ * the "producer"; all others become consumers. Repos are deduplicated via Set
+ * so a repo appearing multiple times (e.g., two handlers for the same route)
+ * is counted only once.
+ *
+ * @param contracts - Flat list of contracts from all repos
+ * @returns Cross-repo contract links
+ */
+export declare function buildContractLinks(contracts: HttpContract[]): ContractLink[];
+/**
+ * Persist the contract registry to a SQLite file, overwriting any existing data.
+ *
+ * Tables created:
+ *   - contracts (method, path, handler_name, handler_file, repo)
+ *   - links     (path, method, producer_repo, consumer_repos TEXT — JSON array)
+ *
+ * @param registryPath - Absolute path to the target .contracts.db file
+ * @param links        - Cross-repo contract links to store
+ * @param contracts    - All individual contracts to store
+ */
+export declare function saveContractRegistry(registryPath: string, links: ContractLink[], contracts: HttpContract[]): void;
+/**
+ * Load a previously saved contract registry from disk.
+ *
+ * @param registryPath - Absolute path to the .contracts.db file
+ * @returns Parsed contracts and links, or null if the file does not exist
+ */
+export declare function loadContractRegistry(registryPath: string): {
+    contracts: HttpContract[];
+    links: ContractLink[];
+} | null;
+//# sourceMappingURL=contract-registry.d.ts.map

package/dist/src/groups/contract-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-registry.d.ts","sourceRoot":"","sources":["../../../src/groups/contract-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AA6CD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CA0B5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CA+B5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,YAAY,EAAE,EACrB,SAAS,EAAE,YAAY,EAAE,GACxB,IAAI,CA+CN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,GACnB;IAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,IAAI,CAkC7D"}

package/dist/src/groups/contract-registry.js

@@ -0,0 +1,193 @@
+/**
+ * Contract Registry
+ *
+ * Extracts HTTP contracts (Route nodes) from per-repo monograph databases,
+ * identifies cross-repo links (same method + path in 2+ repos), and
+ * persists/loads the registry in a SQLite database.
+ */
+import { mkdirSync, existsSync } from 'fs';
+import { dirname } from 'path';
+import Database from 'better-sqlite3';
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/**
+ * Parse a Route node name (format: "METHOD /path") into method and path.
+ * Falls back gracefully if the format is unexpected.
+ */
+function parseRouteName(name) {
+    const spaceIdx = name.indexOf(' ');
+    if (spaceIdx === -1) {
+        return { method: 'ANY', path: name };
+    }
+    return {
+        method: name.slice(0, spaceIdx),
+        path: name.slice(spaceIdx + 1),
+    };
+}
+// ── Core functions ────────────────────────────────────────────────────────────
+/**
+ * Extract all HTTP contracts (Route nodes) from a monograph database.
+ *
+ * Route nodes store method and path together in the `name` field as
+ * `"METHOD /path"` (e.g., "GET /api/users"). The handler info is obtained by
+ * following HANDLES_ROUTE edges where the Route node is the SOURCE.
+ *
+ * @param db       - Open better-sqlite3 database handle (read-only acceptable)
+ * @param repoName - Logical name for this repo (used to tag returned contracts)
+ * @returns Array of HttpContract objects
+ */
+export function extractHttpContracts(db, repoName) {
+    // Route is the source of HANDLES_ROUTE edges; handler is the target.
+    const rows = db
+        .prepare(`SELECT
+         r.name        AS name,
+         r.file_path   AS file_path,
+         n.name        AS handler_name,
+         n.file_path   AS handler_file
+       FROM nodes r
+       LEFT JOIN edges e ON e.source_id = r.id AND e.relation = 'HANDLES_ROUTE'
+       LEFT JOIN nodes n ON n.id = e.target_id
+       WHERE r.label = 'Route'`)
+        .all();
+    return rows.map((row) => {
+        const { method, path } = parseRouteName(row.name);
+        return {
+            method,
+            path,
+            handlerName: row.handler_name ?? null,
+            handlerFile: row.handler_file ?? null,
+            repo: repoName,
+        };
+    });
+}
+/**
+ * Group contracts by (method + path) and identify cross-repo links.
+ *
+ * A ContractLink is produced for every (method, path) pair that appears in
+ * 2 or more repos. The first repo encountered for a given pair is treated as
+ * the "producer"; all others become consumers. Repos are deduplicated via Set
+ * so a repo appearing multiple times (e.g., two handlers for the same route)
+ * is counted only once.
+ *
+ * @param contracts - Flat list of contracts from all repos
+ * @returns Cross-repo contract links
+ */
+export function buildContractLinks(contracts) {
+    // key → ordered unique repos (first seen = producer)
+    const grouped = new Map();
+    for (const c of contracts) {
+        const key = `${c.method} ${c.path}`;
+        const existing = grouped.get(key);
+        if (existing) {
+            if (!existing.repoSet.has(c.repo)) {
+                existing.repoSet.add(c.repo);
+                existing.repoOrder.push(c.repo);
+            }
+        }
+        else {
+            grouped.set(key, { repoOrder: [c.repo], repoSet: new Set([c.repo]) });
+        }
+    }
+    const links = [];
+    for (const [key, { repoOrder }] of grouped) {
+        if (repoOrder.length >= 2) {
+            const spaceIdx = key.indexOf(' ');
+            links.push({
+                method: key.slice(0, spaceIdx),
+                path: key.slice(spaceIdx + 1),
+                producerRepo: repoOrder[0],
+                consumerRepos: repoOrder.slice(1),
+            });
+        }
+    }
+    return links;
+}
+/**
+ * Persist the contract registry to a SQLite file, overwriting any existing data.
+ *
+ * Tables created:
+ *   - contracts (method, path, handler_name, handler_file, repo)
+ *   - links     (path, method, producer_repo, consumer_repos TEXT — JSON array)
+ *
+ * @param registryPath - Absolute path to the target .contracts.db file
+ * @param links        - Cross-repo contract links to store
+ * @param contracts    - All individual contracts to store
+ */
+export function saveContractRegistry(registryPath, links, contracts) {
+    mkdirSync(dirname(registryPath), { recursive: true });
+    const db = new Database(registryPath);
+    try {
+        db.pragma('journal_mode = WAL');
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS contracts (
+        method       TEXT NOT NULL,
+        path         TEXT NOT NULL,
+        handler_name TEXT,
+        handler_file TEXT,
+        repo         TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS links (
+        path           TEXT NOT NULL,
+        method         TEXT NOT NULL,
+        producer_repo  TEXT NOT NULL,
+        consumer_repos TEXT NOT NULL
+      );
+    `);
+        const insertContract = db.prepare(`INSERT INTO contracts (method, path, handler_name, handler_file, repo)
+       VALUES (?, ?, ?, ?, ?)`);
+        const insertLink = db.prepare(`INSERT INTO links (path, method, producer_repo, consumer_repos)
+       VALUES (?, ?, ?, ?)`);
+        // Truncate and repopulate atomically — DELETEs inside the transaction so a
+        // crash between clear and insert cannot leave the registry partially empty.
+        const storeAll = db.transaction(() => {
+            db.exec(`DELETE FROM contracts; DELETE FROM links;`);
+            for (const c of contracts) {
+                insertContract.run(c.method, c.path, c.handlerName, c.handlerFile, c.repo);
+            }
+            for (const l of links) {
+                insertLink.run(l.path, l.method, l.producerRepo, JSON.stringify(l.consumerRepos));
+            }
+        });
+        storeAll();
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Load a previously saved contract registry from disk.
+ *
+ * @param registryPath - Absolute path to the .contracts.db file
+ * @returns Parsed contracts and links, or null if the file does not exist
+ */
+export function loadContractRegistry(registryPath) {
+    if (!existsSync(registryPath)) {
+        return null;
+    }
+    const db = new Database(registryPath, { readonly: true });
+    try {
+        const contractRows = db
+            .prepare(`SELECT method, path, handler_name, handler_file, repo FROM contracts`)
+            .all();
+        const linkRows = db
+            .prepare(`SELECT path, method, producer_repo, consumer_repos FROM links`)
+            .all();
+        const contracts = contractRows.map((r) => ({
+            method: r.method,
+            path: r.path,
+            handlerName: r.handler_name,
+            handlerFile: r.handler_file,
+            repo: r.repo,
+        }));
+        const links = linkRows.map((r) => ({
+            path: r.path,
+            method: r.method,
+            producerRepo: r.producer_repo,
+            consumerRepos: JSON.parse(r.consumer_repos),
+        }));
+        return { contracts, links };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=contract-registry.js.map

package/dist/src/groups/contract-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-registry.js","sourceRoot":"","sources":["../../../src/groups/contract-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA2CtC,iFAAiF;AAEjF;;;GAGG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;QAC/B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAqB,EAAE,QAAgB;IAC1E,qEAAqE;IACrE,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;;;;;;+BAQyB,CAC1B;SACA,GAAG,EAAgB,CAAC;IAEvB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO;YACL,MAAM;YACN,IAAI;YACJ,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACrC,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACrC,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAyB;IAC1D,qDAAqD;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyD,CAAC;IAEjF,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7B,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QAC3C,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;gBAC9B,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAC7B,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC1B,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,KAAqB,EACrB,SAAyB;IAEzB,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;KAcP,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAC/B;8BACwB,CACzB,CAAC;QACF,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B;2BACqB,CACtB,CAAC;QAEF,2EAA2E;QAC3E,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACnC,EAAE,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7E,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;YACpF,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,QAAQ,EAAE,CAAC;IACb,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAoB;IAEpB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,EAAE;aACpB,OAAO,CAAC,sEAAsE,CAAC;aAC/E,GAAG,EAAmB,CAAC;QAE1B,MAAM,QAAQ,GAAG,EAAE;aAChB,OAAO,CAAC,+DAA+D,CAAC;aACxE,GAAG,EAAe,CAAC;QAEtB,MAAM,SAAS,GAAmB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,YAAY;YAC3B,WAAW,EAAE,CAAC,CAAC,YAAY;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC;QAEJ,MAAM,KAAK,GAAmB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,YAAY,EAAE,CAAC,CAAC,aAAa;YAC7B,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAa;SACxD,CAAC,CAAC,CAAC;QAEJ,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Group Config
+ *
+ * Parses a group.yaml file that describes a multi-repo group for cross-repo analysis.
+ *
+ * Format:
+ *   name: my-org
+ *   repos:
+ *     backend: /path/to/backend
+ *     frontend: /path/to/frontend
+ */
+export interface GroupRepo {
+    name: string;
+    path: string;
+}
+export interface GroupConfig {
+    name: string;
+    repos: GroupRepo[];
+}
+/**
+ * Parse a group.yaml config file.
+ * Missing or invalid repo paths are warned and skipped.
+ *
+ * @param configPath - Absolute path to group.yaml
+ * @returns Parsed GroupConfig
+ */
+export declare function parseGroupConfig(configPath: string): GroupConfig;
+//# sourceMappingURL=group-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-config.d.ts","sourceRoot":"","sources":["../../../src/groups/group-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAkDD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CA4BhE"}

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

@@ -0,0 +1,90 @@
+/**
+ * Group Config
+ *
+ * Parses a group.yaml file that describes a multi-repo group for cross-repo analysis.
+ *
+ * Format:
+ *   name: my-org
+ *   repos:
+ *     backend: /path/to/backend
+ *     frontend: /path/to/frontend
+ */
+import { readFileSync, existsSync } from 'fs';
+/**
+ * Simple YAML key-value parser for the group.yaml format.
+ * Handles top-level scalar keys and one level of indented key: value pairs.
+ * Does not require any external yaml library.
+ */
+function parseSimpleYaml(content) {
+    const lines = content.split('\n');
+    const result = {};
+    let currentKey = null;
+    let currentMap = null;
+    for (const raw of lines) {
+        // Skip comments and blank lines
+        const line = raw.trimEnd();
+        if (!line || line.trimStart().startsWith('#'))
+            continue;
+        const indent = line.length - line.trimStart().length;
+        if (indent === 0) {
+            // Top-level key
+            const match = line.match(/^(\w[\w-]*):\s*(.*)?$/);
+            if (!match)
+                continue;
+            const key = match[1];
+            const val = (match[2] ?? '').trim();
+            if (val === '' || val === null) {
+                // This key will have children
+                currentMap = {};
+                currentKey = key;
+                result[key] = currentMap;
+            }
+            else {
+                result[key] = val;
+                currentMap = null;
+                currentKey = null;
+            }
+        }
+        else if (indent > 0 && currentMap !== null && currentKey !== null) {
+            // Indented child key-value
+            const trimmed = line.trimStart();
+            const match = trimmed.match(/^(\w[\w-]*):\s*(.*)?$/);
+            if (!match)
+                continue;
+            currentMap[match[1]] = (match[2] ?? '').trim();
+        }
+    }
+    return result;
+}
+/**
+ * Parse a group.yaml config file.
+ * Missing or invalid repo paths are warned and skipped.
+ *
+ * @param configPath - Absolute path to group.yaml
+ * @returns Parsed GroupConfig
+ */
+export function parseGroupConfig(configPath) {
+    if (!existsSync(configPath)) {
+        throw new Error(`Group config not found: ${configPath}`);
+    }
+    const content = readFileSync(configPath, 'utf8');
+    const raw = parseSimpleYaml(content);
+    const name = raw['name'] ?? 'unnamed-group';
+    const reposRaw = raw['repos'];
+    const repos = [];
+    if (reposRaw && typeof reposRaw === 'object' && !Array.isArray(reposRaw)) {
+        for (const [repoName, repoPath] of Object.entries(reposRaw)) {
+            if (typeof repoPath !== 'string' || !repoPath) {
+                console.warn(`[group-config] Skipping repo "${repoName}": missing path`);
+                continue;
+            }
+            if (!existsSync(repoPath)) {
+                console.warn(`[group-config] Skipping repo "${repoName}": path does not exist: ${repoPath}`);
+                continue;
+            }
+            repos.push({ name: repoName, path: repoPath });
+        }
+    }
+    return { name, repos };
+}
+//# sourceMappingURL=group-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-config.js","sourceRoot":"","sources":["../../../src/groups/group-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAY9C;;;;GAIG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,UAAU,GAAkC,IAAI,CAAC;IAErD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,gCAAgC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAExD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;QAErD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,gBAAgB;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAEpC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAC/B,8BAA8B;gBAC9B,UAAU,GAAG,EAAE,CAAC;gBAChB,UAAU,GAAG,GAAG,CAAC;gBACjB,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;gBAClB,UAAU,GAAG,IAAI,CAAC;gBAClB,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,GAAG,CAAC,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACpE,2BAA2B;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAErC,MAAM,IAAI,GAAI,GAAG,CAAC,MAAM,CAAwB,IAAI,eAAe,CAAC;IACpE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAkC,CAAC,EAAE,CAAC;YACtF,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,iCAAiC,QAAQ,iBAAiB,CAAC,CAAC;gBACzE,SAAS;YACX,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,iCAAiC,QAAQ,2BAA2B,QAAQ,EAAE,CAAC,CAAC;gBAC7F,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Group Search
+ *
+ * Merged BM25 search across multiple repos using Reciprocal Rank Fusion (RRF).
+ */
+import type { GroupConfig } from './group-config.js';
+export interface GroupResult {
+    id: string;
+    name: string;
+    label: string;
+    filePath: string | null;
+    repo: string;
+    score: number;
+}
+/**
+ * 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 declare function groupQuery(groupConfig: GroupConfig, query: string, options?: {
+    limit?: number;
+}): Promise<GroupResult[]>;
+//# sourceMappingURL=group-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-search.d.ts","sourceRoot":"","sources":["../../../src/groups/group-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAyED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,WAAW,EAAE,CAAC,CAoDxB"}