@muverse/core 0.2.10 → 0.2.11

package/dist/git/index.d.ts

@@ -3,6 +3,7 @@
  * Provides interfaces for commit analysis, tagging, and conventional commit parsing.
  * Supports monorepo and multi-module projects with module-specific tag management.
  */
+import { Module } from "../index.js";
 /**
  * Represents a parsed git tag with extracted module and version metadata.
  * Supports module tags (moduleName@version) and general tags (v{version}).
@@ -79,14 +80,12 @@ export type CommitInfo = {
 /**
  * Retrieves all commits for a module since its last release tag.
  * Handles monorepo and single-repo scenarios with path filtering.
- * @param modulePath - Relative path to module from repository root (use '.' for root)
- * @param moduleName - Module name used for tag searching
- * @param moduleType - 'root' for general tags, 'module' for module-specific tags
+ * @param projectInfo - Module information including path and type
  * @param options - Git operation options
  * @param excludePaths - Paths to exclude using git pathspec syntax
  * @returns Promise resolving to array of parsed commits (oldest to newest)
  */
-export declare function getCommitsSinceLastTag(modulePath: string, moduleName: string, moduleType: "root" | "module", options?: GitOptions, excludePaths?: string[]): Promise<CommitInfo[]>;
+export declare function getCommitsSinceLastTag(projectInfo: Module, options?: GitOptions, excludePaths?: string[]): Promise<CommitInfo[]>;
 /**
  * Retrieves commits within a specific git revision range with path filtering.
  * Uses git's native pathspec syntax for efficient filtering in monorepos.
@@ -100,12 +99,11 @@ export declare function getCommitsInRange(range: string, pathFilter?: string, op
 /**
  * Finds the most recent git tag for a specific module with fallback to general tags.
  * Searches module-specific tags first (moduleName@*), then falls back to general tags.
- * @param moduleName - Module name for tag pattern construction
- * @param moduleType - 'root' skips module tags, 'module' tries module tags first
+ * @param projectInfo - Module information for tag pattern construction
  * @param options - Git operation options
  * @returns Most recent tag name or null if no tags exist
  */
-export declare function getLastTagForModule(moduleName: string, moduleType: "root" | "module", options?: GitOptions): Promise<string | null>;
+export declare function getLastTagForModule(projectInfo: Module, options?: GitOptions): Promise<string | null>;
 /**
  * Retrieves all git tags in the repository with parsed metadata.
  * Returns array with tag name, commit hash, and parsed module/version information.

package/dist/git/index.d.ts.map

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

package/dist/git/index.js

@@ -16,31 +16,31 @@ const commitParser = new CommitParser({
 /**
  * Retrieves all commits for a module since its last release tag.
  * Handles monorepo and single-repo scenarios with path filtering.
- * @param modulePath - Relative path to module from repository root (use '.' for root)
- * @param moduleName - Module name used for tag searching
- * @param moduleType - 'root' for general tags, 'module' for module-specific tags
+ * @param projectInfo - Module information including path and type
  * @param options - Git operation options
  * @param excludePaths - Paths to exclude using git pathspec syntax
  * @returns Promise resolving to array of parsed commits (oldest to newest)
  */
-export async function getCommitsSinceLastTag(modulePath, moduleName, moduleType, options = {}, excludePaths = []) {
+export async function getCommitsSinceLastTag(projectInfo, options = {}, excludePaths = []) {
     // Resolve the working directory, defaulting to current process directory
     const cwd = options.cwd || process.cwd();
+    logger.debug(`🔍 Getting commits for module '${projectInfo.name}' at path '${projectInfo.path}' since last tag...`);
     try {
         // Find the most recent tag for this module
         // For root modules, this finds general tags (v1.0.0)
         // For submodules, this finds module-specific tags (module@1.0.0)
-        const lastTag = await getLastTagForModule(moduleName, moduleType, { cwd });
+        const lastTag = await getLastTagForModule(projectInfo, { cwd });
+        logger.debug(`🔍 Last tag for module '${projectInfo.name}' of type '${projectInfo.type}': ${lastTag}`);
         // Build the git revision range
         // If tag exists: 'tag..HEAD' means commits after tag up to HEAD
         // If no tag: empty string means all commits in history
         const range = lastTag ? `${lastTag}..HEAD` : "";
-        return getCommitsInRange(range, modulePath, { cwd }, excludePaths);
+        return getCommitsInRange(range, projectInfo.path, { cwd }, excludePaths);
     }
     catch (error) {
         // If tag lookup fails for any reason, fall back to all commits
         // This ensures we always have commit history for version determination
-        return getCommitsInRange("", modulePath, { cwd }, excludePaths);
+        return getCommitsInRange("", projectInfo.path, { cwd }, excludePaths);
     }
 }
 /**
@@ -55,6 +55,7 @@ export async function getCommitsSinceLastTag(modulePath, moduleName, moduleType,
 export async function getCommitsInRange(range, pathFilter, options = {}, excludePaths = []) {
     // Resolve working directory, defaulting to current directory
     const cwd = options.cwd || process.cwd();
+    logger.debug(`🔍 Getting commits in range '${range}' with path filter '${pathFilter}' and excluding paths: ${excludePaths.join(", ")}`);
     try {
         // Build git log command with custom format for easy parsing
         // Format: hash, subject, body, delimiter
@@ -82,6 +83,7 @@ export async function getCommitsInRange(range, pathFilter, options = {}, exclude
                 args.push(`:(exclude)${excludePath}`);
             }
         }
+        logger.debug(`🐙 Executing git command: git ${args.join(" ")}`);
         // Execute git log command
         // Silent mode prevents output pollution in GitHub Actions
         const { stdout } = await execa("git", args, { cwd });
@@ -162,22 +164,23 @@ function parseGitLog(output) {
 /**
  * Finds the most recent git tag for a specific module with fallback to general tags.
  * Searches module-specific tags first (moduleName@*), then falls back to general tags.
- * @param moduleName - Module name for tag pattern construction
- * @param moduleType - 'root' skips module tags, 'module' tries module tags first
+ * @param projectInfo - Module information for tag pattern construction
  * @param options - Git operation options
  * @returns Most recent tag name or null if no tags exist
  */
-export async function getLastTagForModule(moduleName, moduleType, options = {}) {
+export async function getLastTagForModule(projectInfo, options = {}) {
     // Resolve working directory, defaulting to current directory
     const cwd = options.cwd || process.cwd();
+    logger.debug(`🔍 Finding last tag for module '${projectInfo.name}' of type '${projectInfo.type}'...`);
     try {
         // Generate glob pattern for module-specific tags (e.g., 'api@*')
-        const moduleTagPattern = getModuleTagPattern(moduleName);
-        // Only search for module-specific tags if it's not root
+        const moduleTagPattern = getModuleTagPattern(projectInfo.name);
+        // Only search for module-specific tags if it's not root and version is declared
         // Root projects use general tags (v1.0.0) rather than module tags (root@1.0.0)
-        if (moduleType !== "root") {
+        if (projectInfo.type !== "root" && projectInfo.declaredVersion) {
             // Search for module-specific tags with version sorting
             // --sort=-version:refname: Sort by version in descending order (newest first)
+            logger.debug(`🐙 Executing git command: git tag -l ${moduleTagPattern} --sort=-version:refname`);
             const { stdout } = await execa("git", ["tag", "-l", moduleTagPattern, "--sort=-version:refname"], {
                 cwd,
             });
@@ -193,6 +196,7 @@ export async function getLastTagForModule(moduleName, moduleType, options = {})
             // git describe finds the most recent tag reachable from HEAD
             // --tags: Consider all tags (not just annotated)
             // --abbrev=0: Don't show commit hash suffix
+            logger.debug(`🐙 Executing git command: git describe --tags --abbrev=0 HEAD`);
             const { stdout: fallbackOutput } = await execa("git", ["describe", "--tags", "--abbrev=0", "HEAD"], {
                 cwd,
             });
@@ -223,6 +227,7 @@ export async function getAllTags(options = {}) {
         // List all tags with custom format to get name and commit hash
         // %(refname:short): Tag name without refs/tags/ prefix
         // %(objectname): Full commit SHA that the tag points to
+        logger.debug(`🐙 Executing git command: git tag -l --format=%(refname:short) %(objectname)`);
         const { stdout } = await execa("git", ["tag", "-l", "--format=%(refname:short) %(objectname)"], {
             cwd,
         });

package/dist/services/commit-analyzer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-analyzer.d.ts","sourceRoot":"","sources":["../../src/services/commit-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,cAAc;IAQvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B;;;;;OAKG;gBAEgB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,MAAM;IAGnC;;;;;OAKG;IACG,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IA8C1E;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;CAUpB"}
+{"version":3,"file":"commit-analyzer.d.ts","sourceRoot":"","sources":["../../src/services/commit-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,cAAc;IAQvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B;;;;;OAKG;gBAEgB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,MAAM;IAGnC;;;;;OAKG;IACG,8BAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IA4C1E;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;CAUpB"}

package/dist/services/commit-analyzer.js

@@ -35,7 +35,7 @@ export class CommitAnalyzer {
             // This prevents double-counting commits in the module hierarchy
             const childModulePaths = this.findChildModulePaths(projectInfo.path, projectId);
             // Retrieve commits for this module, excluding child modules
-            const commits = await getCommitsSinceLastTag(projectInfo.path, projectInfo.name, projectInfo.type, { cwd: this.repoRoot }, childModulePaths);
+            const commits = await getCommitsSinceLastTag(projectInfo, { cwd: this.repoRoot }, childModulePaths);
             // Store commits for this module
             moduleCommits.set(projectId, commits);
             // Log exclusions for debugging
@@ -57,6 +57,7 @@ export class CommitAnalyzer {
      */
     findChildModulePaths(modulePath, moduleId) {
         const childPaths = [];
+        logger.debug(`🔎 Finding child modules for ${moduleId} at path '${modulePath}'`);
         // Iterate through all modules to find children
         for (const [otherId, otherInfo] of this.moduleRegistry.getModules()) {
             // Skip the module itself
@@ -65,6 +66,8 @@ export class CommitAnalyzer {
                 childPaths.push(otherInfo.path);
             }
         }
+        logger.debug(`✅ Found ${childPaths.length} child module(s) for ${moduleId}`);
+        logger.debug(`Child module paths: ${childPaths.join(", ")}`);
         return childPaths;
     }
     /**

package/dist/utils/version.d.ts

@@ -1,3 +1,3 @@
-export declare const VERSION = "0.2.10";
+export declare const VERSION = "0.2.11";
 export declare const PACKAGE_NAME = "@muverse/core";
 //# sourceMappingURL=version.d.ts.map

package/dist/utils/version.js

@@ -1,4 +1,4 @@
 // This file is auto-generated. Do not edit manually.
 // Run 'npm run generate-version' to update this file.
-export const VERSION = "0.2.10";
+export const VERSION = "0.2.11";
 export const PACKAGE_NAME = "@muverse/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muverse/core",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "Version Engine for Repo Semantic Evolution (Core Library)",
   "type": "module",
   "main": "dist/index.js",