@muverse/core 0.1.14 → 0.2.1

package/README.md

@@ -104,12 +104,14 @@ interface RunnerResult {
 Built-in support for Gradle projects (Groovy & Kotlin DSL).
 
 **Features:**
+
 - Multi-module project detection
 - Version management through root `gradle.properties`
 - Dependency detection
 - Both Groovy and Kotlin DSL support
 
 **Version Format:**
+
 ```properties
 # Root module
 version=1.0.0

package/dist/adapters/gradle/gradle-project-information.d.ts

@@ -3,10 +3,11 @@ import { ProjectInformation, RawProjectInformation } from '../project-informatio
  * Executes Gradle to collect raw project structure information.
  * Runs gradlew with init script to output JSON containing module hierarchy, versions, and dependencies.
  * @param projectRoot - Absolute path to the Gradle project root directory
+ * @param outputFile - Path to output JSON file to be generated
  * @returns Promise resolving to raw project information as JSON
  * @throws {Error} If initialization script not found or Gradle execution fails
  */
-export declare function getRawProjectInformation(projectRoot: string): Promise<RawProjectInformation>;
+export declare function getRawProjectInformation(projectRoot: string, outputFile: string): Promise<RawProjectInformation>;
 /**
  * Transforms raw project information into structured, queryable format.
  * Normalizes modules, identifies root, parses versions, and maps dependencies.

package/dist/adapters/gradle/gradle-project-information.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gradle-project-information.d.ts","sourceRoot":"","sources":["../../../src/adapters/gradle/gradle-project-information.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAiB9F;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoDlG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,kBAAkB,EAAE,qBAAqB,GAAG,kBAAkB,CA6CnG"}
+{"version":3,"file":"gradle-project-information.d.ts","sourceRoot":"","sources":["../../../src/adapters/gradle/gradle-project-information.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAwH1G;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0DtH;AA2CD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,kBAAkB,EAAE,qBAAqB,GAAG,kBAAkB,CA6CnG"}

package/dist/adapters/gradle/gradle-project-information.js

@@ -4,6 +4,9 @@ import { exists } from '../../utils/file.js';
 import { fileURLToPath } from 'url';
 import { execa } from 'execa';
 import fs from 'fs/promises';
+import crypto from 'crypto';
+import fg from 'fast-glob';
+import { parseProperties } from '../../utils/properties.js';
 /**
  * Name of the Gradle wrapper script file.
  * Ensures consistent builds without requiring pre-installed Gradle.
@@ -15,13 +18,50 @@ const GRADLE_WRAPPER = 'gradlew';
  */
 const GRADLE_INIT_SCRIPT = './init-project-information.gradle.kts';
 /**
- * Executes Gradle to collect raw project structure information.
- * Runs gradlew with init script to output JSON containing module hierarchy, versions, and dependencies.
+ * Finds all Gradle build files recursively under the project root.
+ * Searches for settings.gradle, settings.gradle.kts, build.gradle, and build.gradle.kts files.
  * @param projectRoot - Absolute path to the Gradle project root directory
- * @returns Promise resolving to raw project information as JSON
+ * @returns Promise resolving to array of absolute paths to Gradle build files
+ */
+async function findGradleFiles(projectRoot) {
+    const patterns = [
+        '**/settings.gradle',
+        '**/settings.gradle.kts',
+        '**/build.gradle',
+        '**/build.gradle.kts'
+    ];
+    const files = await fg(patterns, {
+        cwd: projectRoot,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/build/**', '**/.gradle/**']
+    });
+    // Sort for consistent ordering
+    return files.sort();
+}
+/**
+ * Computes SHA-256 hash of all Gradle build files.
+ * Used to detect changes in project configuration that would invalidate cached information.
+ * @param projectRoot - Absolute path to the Gradle project root directory
+ * @returns Promise resolving to hexadecimal hash string
+ */
+async function computeGradleFilesHash(projectRoot) {
+    const files = await findGradleFiles(projectRoot);
+    const hash = crypto.createHash('sha256');
+    for (const file of files) {
+        const content = await fs.readFile(file, 'utf-8');
+        hash.update(file); // Include file path for uniqueness
+        hash.update(content);
+    }
+    return hash.digest('hex');
+}
+/**
+ * Executes the Gradle wrapper script to generate project information.
+ * Runs gradlew with initialization script to create the project-information.json file.
+ * @param projectRoot - Absolute path to the Gradle project root directory
+ * @param outputFile - Path to output JSON file to be generated
  * @throws {Error} If initialization script not found or Gradle execution fails
  */
-export async function getRawProjectInformation(projectRoot) {
+async function executeGradleScript(projectRoot, outputFile) {
     const gradlew = join(projectRoot, GRADLE_WRAPPER);
     const dirname = path.dirname(fileURLToPath(import.meta.url));
     const initScriptPath = join(dirname, GRADLE_INIT_SCRIPT);
@@ -37,7 +77,8 @@ export async function getRawProjectInformation(projectRoot) {
         '--console=plain', // Disable ANSI formatting
         '--init-script', // Inject initialization script
         initScriptPath,
-        'structure' // Custom task that outputs project structure
+        'structure', // Custom task that outputs project structure
+        `-PprojectInfoOutput=${outputFile}`
     ];
     // Execute Gradle wrapper with the prepared arguments
     const result = await execa(gradlew, args, {
@@ -48,17 +89,85 @@ export async function getRawProjectInformation(projectRoot) {
     if (result.exitCode !== 0) {
         throw new Error(`Gradle command failed with exit code ${result.exitCode}: ${result.stderr}`);
     }
-    const file = join(projectRoot, 'build', 'project-information.json');
+}
+/**
+ * Executes Gradle to collect raw project structure information.
+ * Runs gradlew with init script to output JSON containing module hierarchy, versions, and dependencies.
+ * @param projectRoot - Absolute path to the Gradle project root directory
+ * @param outputFile - Path to output JSON file to be generated
+ * @returns Promise resolving to raw project information as JSON
+ * @throws {Error} If initialization script not found or Gradle execution fails
+ */
+export async function getRawProjectInformation(projectRoot, outputFile) {
+    // Step 1: Check if project-information.json exists
+    const fileExists = await exists(outputFile);
+    if (fileExists) {
+        // Step 2: File exists, check cache validity
+        try {
+            const fileContent = await fs.readFile(outputFile, 'utf-8');
+            const cachedData = JSON.parse(fileContent);
+            // Step 2.1 & 2.2: Compute hash of all Gradle build files
+            const currentHash = await computeGradleFilesHash(projectRoot);
+            // Step 2.3 & 2.4: Compare hashes
+            if (cachedData.hash === currentHash) {
+                // Cache hit - return cached data
+                return cachedData.data;
+            }
+            // Cache miss - hash mismatch, need to regenerate
+        }
+        catch (error) {
+            // If there's any error reading/parsing cached file, regenerate
+            console.warn(`Failed to read cached project information: ${error}`);
+        }
+    }
+    // Step 3: File doesn't exist or cache is invalid - execute Gradle script
+    await executeGradleScript(projectRoot, outputFile);
     // Verify that the output file was created
-    const fileExists = await exists(file);
-    if (!fileExists) {
-        throw new Error(`Expected output file not found at ${file}. ` +
+    const fileExistsAfterExec = await exists(outputFile);
+    if (!fileExistsAfterExec) {
+        throw new Error(`Expected output file not found at ${outputFile}. ` +
             `Ensure that the Gradle init script is correctly generating the project information.`);
     }
     // Read the output file content
-    const projectInformation = await fs.readFile(file, 'utf-8');
+    const projectInformationContent = await fs.readFile(outputFile, 'utf-8');
     // Parse JSON output from Gradle
-    return JSON.parse(projectInformation.trim() || '{}');
+    const gradleProjectInformation = JSON.parse(projectInformationContent.trim() || '{}');
+    // Read gradle.properites and add version
+    const projectInformation = await getInformationWithVersions(projectRoot, gradleProjectInformation);
+    // Compute hash and save with cache information
+    const currentHash = await computeGradleFilesHash(projectRoot);
+    const cachedData = {
+        hash: currentHash,
+        data: projectInformation
+    };
+    // Write back to file with hash for future cache validation
+    await fs.writeFile(outputFile, JSON.stringify(cachedData, null, 2), 'utf-8');
+    return projectInformation;
+}
+/**
+ * Reads gradle.properties to extract module versions and augment raw project information.
+ * @param projectRoot - Absolute path to the Gradle project root directory
+ * @param projectInformation - Gradle project information without versions
+ * @returns Promise resolving to augmented RawProjectInformation with versions
+ */
+async function getInformationWithVersions(projectRoot, projectInformation) {
+    const gradlePropertiesFile = join(projectRoot, 'gradle.properties');
+    const gradlePropertiesExists = await exists(gradlePropertiesFile);
+    const result = {};
+    let moduleVersions = new Map();
+    if (gradlePropertiesExists) {
+        moduleVersions = await parseProperties(gradlePropertiesFile);
+        for (const [moduleId, module] of Object.entries(projectInformation)) {
+            const version = moduleVersions.get(module.versionProperty);
+            const resultVersion = version ? version : undefined;
+            result[moduleId] = {
+                ...module,
+                version: resultVersion,
+                declaredVersion: resultVersion !== undefined
+            };
+        }
+    }
+    return result;
 }
 /**
  * Transforms raw project information into structured, queryable format.

package/dist/adapters/gradle/init-project-information.gradle.kts

@@ -127,10 +127,8 @@ gradle.rootProject {
                 mapOf(
                     "path" to projectInfo["path"],
                     "affectedModules" to affectedModules.toSortedSet(),
-                    "version" to projectInfo["version"],
                     "type" to projectInfo["type"],
                     "name" to projectInfo["name"],
-                    "declaredVersion" to projectInfo["declaredVersion"],
                     "versionProperty" to projectInfo["versionProperty"]
                 )
             }

package/dist/adapters/gradle/services/gradle-module-detector.d.ts

@@ -6,8 +6,9 @@ import { ModuleRegistry } from '../../../services/module-registry.js';
  */
 export declare class GradleModuleDetector implements ModuleDetector {
     readonly repoRoot: string;
+    readonly outputFile: string;
     /** Absolute path to the repository root directory. */
-    constructor(repoRoot: string);
+    constructor(repoRoot: string, outputFile: string);
     /**
      * Detects and catalogs all modules in the Gradle project.
      * @returns ModuleRegistry containing all discovered modules and their relationships

package/dist/adapters/gradle/services/gradle-module-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gradle-module-detector.d.ts","sourceRoot":"","sources":["../../../../src/adapters/gradle/services/gradle-module-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAMtE;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IAE7C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IADrC,sDAAsD;gBACjC,QAAQ,EAAE,MAAM;IAErC;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;CAUxC"}
+{"version":3,"file":"gradle-module-detector.d.ts","sourceRoot":"","sources":["../../../../src/adapters/gradle/services/gradle-module-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAMtE;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IAE7C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM;IADlE,sDAAsD;gBACjC,QAAQ,EAAE,MAAM,EAAW,UAAU,EAAE,MAAM;IAElE;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;CAUxC"}

package/dist/adapters/gradle/services/gradle-module-detector.js

@@ -6,9 +6,11 @@ import { getRawProjectInformation, getProjectInformation } from '../gradle-proje
  */
 export class GradleModuleDetector {
     repoRoot;
+    outputFile;
     /** Absolute path to the repository root directory. */
-    constructor(repoRoot) {
+    constructor(repoRoot, outputFile) {
         this.repoRoot = repoRoot;
+        this.outputFile = outputFile;
     }
     /**
      * Detects and catalogs all modules in the Gradle project.
@@ -17,7 +19,7 @@ export class GradleModuleDetector {
      */
     async detect() {
         // Step 1: Execute Gradle and collect raw project structure data
-        const rawProjectInformation = await getRawProjectInformation(this.repoRoot);
+        const rawProjectInformation = await getRawProjectInformation(this.repoRoot, this.outputFile);
         // Step 2: Parse and transform raw data into structured module information
         const projectInformation = getProjectInformation(rawProjectInformation);
         // Step 3: Create a registry for efficient module access and querying

package/dist/adapters/gradle/services/gradle-module-system-factory.d.ts

@@ -12,11 +12,13 @@ export declare class GradleModuleSystemFactory implements ModuleSystemFactory {
     constructor(repoRoot: string);
     /**
      * Creates a Gradle-specific module detector.
+     * @param outputFile - Path to the output file for project information
      * @returns GradleModuleDetector instance configured with the repository root
      */
-    createDetector(): ModuleDetector;
+    createDetector(outputFile: string): ModuleDetector;
     /**
      * Creates a Gradle-specific version update strategy.
+     * @param moduleRegistry - ModuleRegistry containing all detected modules
      * @returns GradleVersionUpdateStrategy instance configured with the repository root
      */
     createVersionUpdateStrategy(moduleRegistry: ModuleRegistry): VersionUpdateStrategy;

package/dist/adapters/gradle/services/gradle-module-system-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gradle-module-system-factory.d.ts","sourceRoot":"","sources":["../../../../src/adapters/gradle/services/gradle-module-system-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAGrF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;IAEvD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IADrC,sDAAsD;gBACzB,QAAQ,EAAE,MAAM;IAE7C;;;OAGG;IACH,cAAc,IAAI,cAAc;IAIhC;;;OAGG;IACH,2BAA2B,CAAC,cAAc,EAAE,cAAc,GAAG,qBAAqB;CAGnF"}
+{"version":3,"file":"gradle-module-system-factory.d.ts","sourceRoot":"","sources":["../../../../src/adapters/gradle/services/gradle-module-system-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAGrF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;IAEvD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IADrC,sDAAsD;gBACzB,QAAQ,EAAE,MAAM;IAE7C;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc;IAIlD;;;;OAIG;IACH,2BAA2B,CAAC,cAAc,EAAE,cAAc,GAAG,qBAAqB;CAGnF"}

package/dist/adapters/gradle/services/gradle-module-system-factory.js

@@ -12,13 +12,15 @@ export class GradleModuleSystemFactory {
     }
     /**
      * Creates a Gradle-specific module detector.
+     * @param outputFile - Path to the output file for project information
      * @returns GradleModuleDetector instance configured with the repository root
      */
-    createDetector() {
-        return new GradleModuleDetector(this.repoRoot);
+    createDetector(outputFile) {
+        return new GradleModuleDetector(this.repoRoot, outputFile);
     }
     /**
      * Creates a Gradle-specific version update strategy.
+     * @param moduleRegistry - ModuleRegistry containing all detected modules
      * @returns GradleVersionUpdateStrategy instance configured with the repository root
      */
     createVersionUpdateStrategy(moduleRegistry) {

package/dist/adapters/gradle/services/gradle-version-update-strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gradle-version-update-strategy.d.ts","sourceRoot":"","sources":["../../../../src/adapters/gradle/services/gradle-version-update-strategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAGrF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,qBAAqB;IAQzC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAP7D,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC;;;OAGG;gBACS,QAAQ,EAAE,MAAM,EAAmB,cAAc,EAAE,cAAc;IAI7E;;;;OAIG;IACG,mBAAmB,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB9E"}
+{"version":3,"file":"gradle-version-update-strategy.d.ts","sourceRoot":"","sources":["../../../../src/adapters/gradle/services/gradle-version-update-strategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAGrF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,qBAAqB;IAQzC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAP7D,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC;;;OAGG;gBACS,QAAQ,EAAE,MAAM,EAAmB,cAAc,EAAE,cAAc;IAI7E;;;;OAIG;IACG,mBAAmB,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAe9E"}

package/dist/adapters/project-information.d.ts

@@ -31,10 +31,9 @@ export type ProjectInformation = {
     readonly rootModule: string;
 };
 /**
- * Raw module data as extracted from the build system before processing.
- * Similar to Module but with arrays instead of Sets and optional string version.
+ * Base module data structure without the module ID and with version as a string.
  */
-export type RawModule = {
+export type BaseModule = {
     /** Human-readable name of the module. */
     readonly name: string;
     /** Relative path from repository root to the module directory. */
@@ -47,7 +46,12 @@ export type RawModule = {
     readonly type: "module" | "root";
     /** Whether the version is explicitly declared in build configuration. */
     readonly declaredVersion: boolean;
-} & Record<string, unknown>;
+};
+/**
+ * Raw module data as extracted from the build system before processing.
+ * Similar to Module but with arrays instead of Sets and optional string version.
+ */
+export type RawModule = BaseModule & Record<string, unknown>;
 /**
  * Raw project structure information as extracted from the build system.
  * Maps module IDs to their raw module data.

package/dist/adapters/project-information.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-information.d.ts","sourceRoot":"","sources":["../../src/adapters/project-information.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEjC,oEAAoE;IACpE,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,wFAAwF;IACxF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAE7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9C,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IAEnC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEjC,yEAAyE;IACzE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC"}
+{"version":3,"file":"project-information.d.ts","sourceRoot":"","sources":["../../src/adapters/project-information.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEjC,oEAAoE;IACpE,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,wFAAwF;IACxF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAE7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9C,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IAEnC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEjC,yEAAyE;IACzE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC"}

package/dist/services/module-system-factory.d.ts

@@ -12,12 +12,14 @@ export interface ModuleSystemFactory {
     /**
      * Creates a module detector for discovering modules.
      *
+     * @param outputFile - Path to the output file for project information
      * @returns {@link ModuleDetector} configured for this build system
      */
-    createDetector(): ModuleDetector;
+    createDetector(outputFile: string): ModuleDetector;
     /**
      * Creates a version update strategy for writing versions to build files.
      *
+     * @param moduleRegistry - ModuleRegistry containing all detected modules
      * @returns {@link VersionUpdateStrategy} configured for this build system
      */
     createVersionUpdateStrategy(moduleRegistry: ModuleRegistry): VersionUpdateStrategy;

package/dist/services/module-system-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-system-factory.d.ts","sourceRoot":"","sources":["../../src/services/module-system-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,cAAc,IAAI,cAAc,CAAC;IAEjC;;;;OAIG;IACH,2BAA2B,CACzB,cAAc,EAAE,cAAc,GAC7B,qBAAqB,CAAC;CAC1B"}
+{"version":3,"file":"module-system-factory.d.ts","sourceRoot":"","sources":["../../src/services/module-system-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;IAEnD;;;;;OAKG;IACH,2BAA2B,CACzB,cAAc,EAAE,cAAc,GAC7B,qBAAqB,CAAC;CAC1B"}

package/dist/services/verse-runner.d.ts

@@ -13,6 +13,7 @@ export type RunnerOptions = {
     readonly appendSnapshot: boolean;
     readonly pushChanges: boolean;
     readonly generateChangelog: boolean;
+    readonly outputFile: string;
 };
 export type RunnerResult = {
     readonly bumped: boolean;

package/dist/services/verse-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verse-runner.d.ts","sourceRoot":"","sources":["../../src/services/verse-runner.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAK5D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;CACnC,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAgB;IAG/B,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,yBAAyB,CAA4B;IAC7D,OAAO,CAAC,uBAAuB,CAA0B;gBAE7C,OAAO,EAAE,aAAa;IAyBlC,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,eAAe;IAgCjB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;YAYpB,KAAK;CAgIpB"}
+{"version":3,"file":"verse-runner.d.ts","sourceRoot":"","sources":["../../src/services/verse-runner.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAK5D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;CACnC,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAgB;IAG/B,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,yBAAyB,CAA4B;IAC7D,OAAO,CAAC,uBAAuB,CAA0B;gBAE7C,OAAO,EAAE,aAAa;IA0BlC,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,eAAe;IAgCjB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;YAYpB,KAAK;CAkIpB"}

package/dist/services/verse-runner.js

@@ -34,6 +34,7 @@ export class VerseRunner {
         this.options = {
             ...options,
             repoRoot: path.resolve(options.repoRoot),
+            outputFile: path.resolve(options.outputFile),
         };
         // Initialize services
         this.configurationLoader = new ConfigurationLoader(new ConfigurationValidator());
@@ -116,7 +117,7 @@ export class VerseRunner {
         }
         // Discover modules and get hierarchy manager
         logger.info("🔍 Discovering modules...");
-        const detector = this.moduleSystemFactory.createDetector();
+        const detector = this.moduleSystemFactory.createDetector(this.options.outputFile);
         this.moduleRegistry = await detector.detect();
         // Log discovered modules through hierarchy manager
         const moduleIds = this.moduleRegistry.getModuleIds();

package/dist/utils/properties.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Parse a generic properties file into key-value pairs
+ * Supports both '=' and ':' as delimiters
+ * Skips comments (lines starting with # or !) and empty lines
+ * @param propertiesPath - Path to the properties file
+ * @returns Map of property keys to values
+ */
+export declare function parseProperties(propertiesPath: string): Promise<Map<string, string>>;
 /**
  * Updates or inserts a single property in a Java-style properties file.
  * @param propertiesPath - Path to the properties file

package/dist/utils/properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/utils/properties.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgDf"}
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/utils/properties.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiC9B;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/utils/properties.js

@@ -1,5 +1,37 @@
 import { promises as fs } from "fs";
 import { exists } from "./file.js";
+/**
+ * Parse a generic properties file into key-value pairs
+ * Supports both '=' and ':' as delimiters
+ * Skips comments (lines starting with # or !) and empty lines
+ * @param propertiesPath - Path to the properties file
+ * @returns Map of property keys to values
+ */
+export async function parseProperties(propertiesPath) {
+    const content = await fs.readFile(propertiesPath, "utf8");
+    const properties = new Map();
+    // Parse all properties line by line
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        // Skip comments and empty lines
+        if (trimmedLine.startsWith("#") ||
+            trimmedLine.startsWith("!") ||
+            !trimmedLine) {
+            continue;
+        }
+        // Parse property: key=value or key:value
+        const match = trimmedLine.match(/^([^=:]+)[=:]\s*(.+)$/);
+        if (!match) {
+            continue;
+        }
+        const [, key, value] = match;
+        const trimmedKey = key.trim();
+        const trimmedValue = value.trim();
+        properties.set(trimmedKey, trimmedValue);
+    }
+    return properties;
+}
 /**
  * Updates or inserts a single property in a Java-style properties file.
  * @param propertiesPath - Path to the properties file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muverse/core",
-  "version": "0.1.14",
+  "version": "0.2.1",
   "description": "Version Engine for Repo Semantic Evolution (Core Library)",
   "type": "module",
   "main": "dist/index.js",
@@ -46,8 +46,10 @@
   "dependencies": {
     "conventional-commits-parser": "^6.2.1",
     "cosmiconfig": "^9.0.0",
+    "crypto": "^1.0.1",
     "deepmerge": "^4.3.1",
     "execa": "^9.6.1",
+    "fast-glob": "^3.3.3",
     "semver": "^7.5.4",
     "yaml": "^2.3.4",
     "zod": "^4.1.12"