@eldrforge/kodrdriv 1.2.27 → 1.2.28

package/VERSION-AUDIT-FIX.md

@@ -0,0 +1,333 @@
+# Version Consistency Audit Fix
+
+## Summary
+
+Enhanced the `kodrdriv tree publish --audit-branches` command to detect version consistency issues, preventing publish failures caused by packages having release versions on development branches or vice versa.
+
+## Problems Fixed
+
+### 1. ✅ Audit Misses Version Issues
+
+**Before**: `--audit-branches` only checked:
+- Branch consistency
+- Uncommitted changes
+- Sync status
+- Merge conflicts
+
+**Did NOT check**:
+- Version patterns (dev vs release)
+- Whether versions match branch expectations
+- Monorepo version alignment
+
+**After**: Now checks all of the above PLUS:
+- ✅ Version patterns for each package
+- ✅ Validates versions match branch type
+- ✅ Shows clear fix instructions
+- ✅ Blocks publish if issues found
+
+### 2. ✅ Silent Version Inconsistencies
+
+**Before**: Developer could have:
+```
+✅ @fjell/common-config: 1.1.37-dev.0 (correct)
+❌ @fjell/logging: 4.4.64 (missing -dev.0 suffix)
+✅ @fjell/core: 4.4.72-dev.0 (correct)
+```
+
+And `--audit-branches` would say "All OK!" leading to:
+- Skipped packages during publish
+- Unclear failures
+- Wasted debugging time
+
+**After**: Audit now reports:
+```
+⚠️  Version Issues (1 package):
+   @fjell/logging
+   - Branch: working
+   - Version: 4.4.64
+   - Issue: Release version on development branch
+   - Fix: Run kodrdriv development to update to development version
+```
+
+## Implementation Details
+
+### New Utility Functions (`src/util/general.ts`)
+
+```typescript
+// Check if version has prerelease tag
+export const isDevelopmentVersion = (version: string): boolean
+
+// Check if version is release version (X.Y.Z)
+export const isReleaseVersion = (version: string): boolean
+
+// Get expected version pattern for branch
+export const getExpectedVersionPattern = (branchName: string): {
+    pattern: RegExp;
+    description: string;
+    isDevelopment: boolean;
+}
+
+// Validate version against branch expectations
+export const validateVersionForBranch = (version: string, branchName: string): {
+    valid: boolean;
+    issue?: string;
+    fix?: string;
+}
+```
+
+### Enhanced Branch Audit (`src/utils/branchState.ts`)
+
+Added new interfaces:
+```typescript
+interface VersionStatus {
+    version: string;
+    isValid: boolean;
+    issue?: string;
+    fix?: string;
+}
+
+interface PackageBranchAudit {
+    packageName: string;
+    path: string;
+    status: BranchStatus;
+    versionStatus?: VersionStatus;  // NEW
+    issues: string[];
+    fixes: string[];
+}
+
+interface BranchAuditResult {
+    totalPackages: number;
+    goodPackages: number;
+    issuesFound: number;
+    versionIssues: number;  // NEW
+    audits: PackageBranchAudit[];
+}
+```
+
+### Version Pattern Rules
+
+**Development Branches** (`working`, `development`, `dev`, `feature/*`, `wip/*`):
+- **Expected**: `X.Y.Z-<tag>` (e.g., `1.2.3-dev.0`)
+- **Invalid**: `X.Y.Z` (release versions)
+- **Fix**: `kodrdriv development`
+
+**Release Branches** (`main`, `master`, `production`, `release/*`):
+- **Expected**: `X.Y.Z` (e.g., `1.2.3`)
+- **Invalid**: `X.Y.Z-<tag>` (development versions)
+- **Fix**: Do not commit dev versions to release branches
+
+**Other Branches**:
+- **Expected**: Either format acceptable
+- **No strict validation**
+
+### Enhanced Audit Output
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║  Branch State Audit (16 packages)                            ║
+║  All packages on: working                                    ║
+╠══════════════════════════════════════════════════════════════╣
+
+✅ Good State (15 packages):
+   @fjell/common-config (v1.1.37-dev.0)
+   @fjell/core (v4.4.72-dev.0)
+   @fjell/http-api (v4.4.62-dev.0)
+   ...
+
+⚠️  Version Issues (1 package):
+   @fjell/logging
+   - Branch: working
+   - Version: 4.4.64
+   - Issue: Release version on development branch
+   - Fix: Run kodrdriv development to update to development version
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📝 RECOMMENDED WORKFLOW:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+1️⃣  FIX VERSION ISSUES (recommended before publish):
+   • @fjell/logging: cd logging && kodrdriv development
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔄 After fixing issues, re-run audit to verify:
+   kodrdriv tree publish --audit-branches
+
+✅ Once all clear, proceed with publish:
+   kodrdriv tree publish --parallel --model "gpt-5-mini"
+
+╚══════════════════════════════════════════════════════════════╝
+
+⚠️  Found issues in 1 package(s). Review the fixes above.
+   1 package(s) have version consistency issues
+   Run 'kodrdriv development' in each package to fix version issues
+```
+
+### Integration with Tree Commands
+
+Enhanced tree.ts audit handling:
+```typescript
+const auditResult = await auditBranchState(packages, undefined, {
+    targetBranch,
+    checkPR: true,
+    checkConflicts: true,
+    checkVersions: true,  // NEW - enabled by default
+});
+
+if (auditResult.issuesFound > 0 || auditResult.versionIssues > 0) {
+    const totalIssues = auditResult.issuesFound + (auditResult.versionIssues || 0);
+    logger.warn(`Found issues in ${totalIssues} package(s)`);
+
+    if (auditResult.versionIssues > 0) {
+        logger.warn(`${auditResult.versionIssues} package(s) have version consistency issues`);
+    }
+}
+```
+
+## Real-World Usage
+
+### Before This Fix
+
+```bash
+$ kodrdriv tree publish --audit-branches
+✅ All 16 packages are in good state!
+
+$ kodrdriv tree publish --parallel
+# Publishes, but skips @fjell/logging
+# Developer confused: "Why was logging skipped? It had changes!"
+# 30 minutes debugging to find: version was 4.4.64 instead of 4.4.64-dev.0
+```
+
+### After This Fix
+
+```bash
+$ kodrdriv tree publish --audit-branches
+
+⚠️  Version Issues (1 package):
+   @fjell/logging
+   - Branch: working
+   - Version: 4.4.64
+   - Issue: Release version on development branch
+   - Fix: Run kodrdriv development to update to development version
+
+1️⃣  FIX VERSION ISSUES (recommended before publish):
+   • @fjell/logging: cd logging && kodrdriv development
+
+⚠️  Found issues in 1 package(s). Review the fixes above.
+
+$ cd logging && kodrdriv development
+✓ Updated to 4.4.65-dev.0
+
+$ kodrdriv tree publish --audit-branches
+✅ All 16 packages are in good state!
+
+$ kodrdriv tree publish --parallel
+# All packages publish successfully
+```
+
+## Files Modified
+
+```
+src/util/general.ts               - Added version validation utilities
+src/utils/branchState.ts           - Enhanced audit with version checking
+src/commands/tree.ts               - Enabled version checking in audit
+tests/utils/branchState.test.ts   - Updated tests for new fields
+VERSION-AUDIT-FIX.md              - This documentation
+```
+
+## Test Updates
+
+Updated existing tests to include new `versionIssues` field:
+```typescript
+const result: BranchAuditResult = {
+    totalPackages: 2,
+    goodPackages: 2,
+    issuesFound: 0,
+    versionIssues: 0,  // NEW
+    audits: [...]
+};
+```
+
+## Backward Compatibility
+
+✅ **Fully backward compatible**
+- Version checking enabled by default (can be disabled with `checkVersions: false`)
+- Existing audit functionality unchanged
+- New fields added to interfaces (optional in most contexts)
+
+## Impact
+
+### Before
+- ❌ Version issues discovered during publish (too late)
+- ❌ Unclear why packages skipped
+- ❌ 30+ minutes debugging per issue
+- ❌ No pre-flight validation
+
+### After
+- ✅ Version issues caught in audit (before publish)
+- ✅ Clear fix instructions shown
+- ✅ 2 minutes to identify and fix
+- ✅ Confidence before publishing
+
+## Remaining Work (Future Enhancements)
+
+### 1. Tree Development Command (Not Implemented)
+
+User requested but not yet implemented:
+```bash
+kodrdriv tree development
+```
+
+Would update ALL packages in monorepo to development versions in one command.
+
+**Current Workaround**: Run `kodrdriv development` in each package individually, or use the audit to identify which packages need updating.
+
+### 2. Smart Monorepo Detection (Not Implemented)
+
+User requested: When running `kodrdriv development` in one package, detect monorepo and ask:
+```
+📦 Detected monorepo: 16 packages found
+Update only this package, or all packages in monorepo? [single/all]
+```
+
+**Current Behavior**: Only updates current package.
+
+### 3. Automated Version Alignment (Not Implemented)
+
+User requested: Automatically update all packages when one is updated.
+
+**Current Behavior**: Manual per-package updates required.
+
+## Priority Assessment
+
+**COMPLETED (This PR)**:
+- ✅ Version consistency checking in audit
+- ✅ Clear error messages and fix instructions
+- ✅ Integration with existing workflows
+
+**FUTURE (Lower Priority)**:
+- Tree development command (nice-to-have)
+- Automatic monorepo-wide updates (quality-of-life)
+- Smart monorepo detection (convenience)
+
+The core issue (audit missing version problems) is **FIXED**. The remaining items are enhancements that improve convenience but don't block workflows.
+
+## Version
+
+Implemented in: **kodrdriv 1.2.29-dev.0**
+
+---
+
+## Example Test Case
+
+Given monorepo with 3 packages:
+- package-a: 1.0.0-dev.0 on `working` branch ✓
+- package-b: 2.0.0 on `working` branch ✗ (missing -dev.0)
+- package-c: 3.0.0-dev.0 on `working` branch ✓
+
+Running `kodrdriv tree publish --audit-branches`:
+- ✅ Reports version issue in package-b
+- ✅ Provides fix command
+- ✅ Returns non-zero exit code
+- ✅ Prevents publish from proceeding until fixed
+

package/dist/application.js

@@ -27,10 +27,10 @@ import { getLogger, setLogLevel } from './logging.js';
  */ function printDebugCommandInfo(commandName, runConfig) {
     if (runConfig.debug) {
         const logger = getLogger();
-        logger.info('=== KODRDRIV DEBUG INFO ===');
-        logger.info('Command: %s', commandName);
-        logger.info('Version: %s', VERSION);
-        logger.info('===========================');
+        logger.info('DEBUG_INFO_HEADER: KodrDriv debug information');
+        logger.info('DEBUG_INFO_COMMAND: Command being executed | Command: %s', commandName);
+        logger.info('DEBUG_INFO_VERSION: KodrDriv version | Version: %s', VERSION);
+        logger.info('DEBUG_INFO_FOOTER: End of debug information');
     }
 }
 /**
@@ -81,7 +81,7 @@ async function runApplication() {
     setLogger$1(logger);
     setPromptFunction(promptConfirmation);
     // Display version information
-    logger.info('🚀 kodrdriv %s', VERSION);
+    logger.info('APPLICATION_STARTING: KodrDriv application initializing | Version: %s | Status: starting', VERSION);
     // Handle check-config command first
     if (commandConfig.commandName === COMMAND_CHECK_CONFIG) {
         // CardiganTime's checkConfig has already been called in Arguments.configure()
@@ -174,7 +174,7 @@ async function runApplication() {
     } catch (error) {
         // Handle user cancellation gracefully
         if (error instanceof UserCancellationError) {
-            logger.info(error.message);
+            logger.info('APPLICATION_ERROR: Application error occurred | Error: ' + error.message);
             process.exit(0);
         }
         // Re-throw other errors to be handled by main.ts

package/dist/application.js.map

@@ -1 +1 @@
-{"version":3,"file":"application.js","sources":["../src/application.ts"],"sourcesContent":["import * as Cardigantime from '@theunwalked/cardigantime';\nimport 'dotenv/config';\nimport { setLogger as setGitLogger } from '@eldrforge/git-tools';\nimport { setLogger as setGitHubLogger, setPromptFunction } from '@eldrforge/github-tools';\nimport { promptConfirmation } from './util/stdin';\nimport { CommandConfig } from 'types';\nimport * as Arguments from './arguments';\nimport * as AudioCommit from './commands/audio-commit';\nimport * as AudioReview from './commands/audio-review';\nimport * as Clean from './commands/clean';\nimport * as Commit from './commands/commit';\nimport * as Development from './commands/development';\nimport * as Link from './commands/link';\nimport * as Publish from './commands/publish';\nimport * as Release from './commands/release';\nimport * as Review from './commands/review';\nimport * as SelectAudio from './commands/select-audio';\nimport * as Tree from './commands/tree';\nimport * as Unlink from './commands/unlink';\nimport * as Updates from './commands/updates';\nimport * as Versions from './commands/versions';\nimport { COMMAND_AUDIO_COMMIT, COMMAND_AUDIO_REVIEW, COMMAND_CHECK_CONFIG, COMMAND_CLEAN, COMMAND_COMMIT, COMMAND_DEVELOPMENT, COMMAND_INIT_CONFIG, COMMAND_LINK, COMMAND_PUBLISH, COMMAND_RELEASE, COMMAND_REVIEW, COMMAND_SELECT_AUDIO, COMMAND_TREE, COMMAND_UNLINK, COMMAND_UPDATES, COMMAND_VERSIONS, DEFAULT_CONFIG_DIR, VERSION } from './constants';\nimport { UserCancellationError } from './error/CommandErrors';\nimport { getLogger, setLogLevel } from './logging';\nimport { Config, SecureConfig } from './types';\n\n/**\n * Print debug information about the command being executed when debug flag is enabled.\n */\nfunction printDebugCommandInfo(commandName: string, runConfig: Config): void {\n    if (runConfig.debug) {\n        const logger = getLogger();\n        logger.info('=== KODRDRIV DEBUG INFO ===');\n        logger.info('Command: %s', commandName);\n        logger.info('Version: %s', VERSION);\n        logger.info('===========================');\n    }\n}\n\n/**\n * Configure early logging based on command line flags.\n *\n * Hey we need this because we need to be able to debug CardiganTime.\n * This method checks for --verbose and --debug flags early in the process\n * before CardiganTime is configured, allowing us to capture debug output\n * from the CardiganTime initialization itself.\n */\nexport function configureEarlyLogging(): void {\n    const hasVerbose = process.argv.includes('--verbose');\n    const hasDebug = process.argv.includes('--debug');\n\n    // Set log level based on early flag detection\n    if (hasDebug) {\n        setLogLevel('debug');\n    } else if (hasVerbose) {\n        setLogLevel('verbose');\n    }\n}\n\nexport async function runApplication(): Promise<void> {\n    // Configure logging early, before CardiganTime initialization\n    configureEarlyLogging();\n\n    // Use proper typing for CardiganTime create function\n    interface CardigantimeCreateParams {\n        defaults?: any;\n        features?: string[];\n        configShape?: any;\n        logger?: any;\n    }\n\n    interface CardigantimeInstance {\n        read: (args: any) => Promise<any>;\n        checkConfig: () => Promise<void>;\n        generateConfig: (dir: string) => Promise<void>;\n        setLogger: (logger: any) => void;\n    }\n\n    const cardigantimeModule = Cardigantime as any;\n    const createCardigantime = cardigantimeModule.create as (params: CardigantimeCreateParams) => CardigantimeInstance;\n\n    const cardigantime = createCardigantime({\n        defaults: {\n            configDirectory: DEFAULT_CONFIG_DIR,\n        },\n        features: ['config', 'hierarchical'],\n        logger: getLogger(),\n    });\n\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const [runConfig, secureConfig, commandConfig]: [Config, SecureConfig, CommandConfig] = await Arguments.configure(cardigantime); // Pass cardigantime instance\n\n    // Set log level based on verbose flag\n    if (runConfig.verbose) {\n        setLogLevel('verbose');\n    }\n    if (runConfig.debug) {\n        setLogLevel('debug');\n    }\n\n    const logger = getLogger();\n    cardigantime.setLogger(logger);\n\n    // Configure external packages to use our logger and prompt\n    setGitLogger(logger);\n    setGitHubLogger(logger);\n    setPromptFunction(promptConfirmation);\n\n    // Display version information\n    logger.info('🚀 kodrdriv %s', VERSION);\n\n    // Handle check-config command first\n    if (commandConfig.commandName === COMMAND_CHECK_CONFIG) {\n        // CardiganTime's checkConfig has already been called in Arguments.configure()\n        // No additional processing needed here\n        return;\n    }\n\n    // Handle init-config command\n    if (commandConfig.commandName === COMMAND_INIT_CONFIG) {\n        // CardiganTime's initConfig has already been called in Arguments.configure()\n        // No additional processing needed here\n        return;\n    }\n\n    // Get the command from Commander\n    const command = process.argv[2];\n    let commandName = commandConfig.commandName;\n\n    // Handle special case for tree command with built-in command argument\n    if (command === 'tree' && process.argv[3]) {\n        const treeBuiltInCommand = process.argv[3];\n        const supportedBuiltInCommands = ['commit', 'publish', 'link', 'unlink', 'development', 'updates'];\n        if (supportedBuiltInCommands.includes(treeBuiltInCommand)) {\n            // This is a tree command with built-in command, keep commandName as 'tree'\n            commandName = 'tree';\n        } else {\n            // Unknown tree argument, let it fail naturally in tree.ts\n            commandName = 'tree';\n        }\n    }\n    // If we have a specific command argument, use that\n    else if (command === 'commit' || command === 'audio-commit' || command === 'release' || command === 'publish' || command === 'tree' || command === 'link' || command === 'unlink' || command === 'audio-review' || command === 'clean' || command === 'review' || command === 'select-audio' || command === 'development' || command === 'versions' || command === 'updates') {\n        commandName = command;\n    }\n\n    let summary: string = '';\n\n    try {\n        // Print debug info at the start of command execution\n        if (commandName) {\n            printDebugCommandInfo(commandName, runConfig);\n        }\n\n        if (commandName === COMMAND_COMMIT) {\n            summary = await Commit.execute(runConfig);\n        } else if (commandName === COMMAND_AUDIO_COMMIT) {\n            summary = await AudioCommit.execute(runConfig);\n        } else if (commandName === COMMAND_RELEASE) {\n            const releaseSummary = await Release.execute(runConfig);\n            summary = `${releaseSummary.title}\\n\\n${releaseSummary.body}`;\n        } else if (commandName === COMMAND_PUBLISH) {\n            await Publish.execute(runConfig);\n        } else if (commandName === COMMAND_TREE) {\n            // Handle tree directories mapping from command-specific arguments\n            if (runConfig.audioReview?.directory && !runConfig.tree?.directories) {\n                runConfig.tree = runConfig.tree || {};\n                runConfig.tree.directories = [runConfig.audioReview.directory];\n            }\n            // Handle tree exclusion patterns - use global excludedPatterns for tree\n            if (runConfig.excludedPatterns && !runConfig.tree?.exclude) {\n                runConfig.tree = runConfig.tree || {};\n                runConfig.tree.exclude = runConfig.excludedPatterns;\n            }\n            summary = await Tree.execute(runConfig);\n        } else if (commandName === COMMAND_LINK) {\n            summary = await Link.execute(runConfig);\n        } else if (commandName === COMMAND_UNLINK) {\n            summary = await Unlink.execute(runConfig);\n        } else if (commandName === COMMAND_AUDIO_REVIEW) {\n            summary = await AudioReview.execute(runConfig);\n        } else if (commandName === COMMAND_CLEAN) {\n            await Clean.execute(runConfig);\n            summary = 'Output directory cleaned successfully.';\n        } else if (commandName === COMMAND_REVIEW) {\n            summary = await Review.execute(runConfig);\n        } else if (commandName === COMMAND_SELECT_AUDIO) {\n            await SelectAudio.execute(runConfig);\n            summary = 'Audio selection completed successfully.';\n        } else if (commandName === COMMAND_DEVELOPMENT) {\n            summary = await Development.execute(runConfig);\n        } else if (commandName === COMMAND_VERSIONS) {\n            summary = await Versions.execute(runConfig);\n        } else if (commandName === COMMAND_UPDATES) {\n            summary = await Updates.execute(runConfig);\n        }\n\n        // eslint-disable-next-line no-console\n        console.log(`\\n\\n${summary}\\n\\n`);\n    } catch (error: any) {\n        // Handle user cancellation gracefully\n        if (error instanceof UserCancellationError) {\n            logger.info(error.message);\n            process.exit(0);\n        }\n\n        // Re-throw other errors to be handled by main.ts\n        throw error;\n    }\n}\n"],"names":["printDebugCommandInfo","commandName","runConfig","debug","logger","getLogger","info","VERSION","configureEarlyLogging","hasVerbose","process","argv","includes","hasDebug","setLogLevel","runApplication","cardigantimeModule","Cardigantime","createCardigantime","create","cardigantime","defaults","configDirectory","DEFAULT_CONFIG_DIR","features","secureConfig","commandConfig","Arguments","verbose","setLogger","setGitLogger","setGitHubLogger","setPromptFunction","promptConfirmation","COMMAND_CHECK_CONFIG","COMMAND_INIT_CONFIG","command","treeBuiltInCommand","supportedBuiltInCommands","summary","COMMAND_COMMIT","Commit","COMMAND_AUDIO_COMMIT","AudioCommit","COMMAND_RELEASE","releaseSummary","Release","title","body","COMMAND_PUBLISH","Publish","COMMAND_TREE","audioReview","directory","tree","directories","excludedPatterns","exclude","Tree","COMMAND_LINK","Link","COMMAND_UNLINK","Unlink","COMMAND_AUDIO_REVIEW","AudioReview","COMMAND_CLEAN","Clean","COMMAND_REVIEW","Review","COMMAND_SELECT_AUDIO","SelectAudio","COMMAND_DEVELOPMENT","Development","COMMAND_VERSIONS","Versions","COMMAND_UPDATES","Updates","console","log","error","UserCancellationError","message","exit"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0BA;;AAEC,IACD,SAASA,qBAAAA,CAAsBC,WAAmB,EAAEC,SAAiB,EAAA;IACjE,IAAIA,SAAAA,CAAUC,KAAK,EAAE;AACjB,QAAA,MAAMC,MAAAA,GAASC,SAAAA,EAAAA;AACfD,QAAAA,MAAAA,CAAOE,IAAI,CAAC,6BAAA,CAAA;QACZF,MAAAA,CAAOE,IAAI,CAAC,aAAA,EAAeL,WAAAA,CAAAA;QAC3BG,MAAAA,CAAOE,IAAI,CAAC,aAAA,EAAeC,OAAAA,CAAAA;AAC3BH,QAAAA,MAAAA,CAAOE,IAAI,CAAC,6BAAA,CAAA;AAChB,IAAA;AACJ;AAEA;;;;;;;AAOC,IACM,SAASE,qBAAAA,GAAAA;AACZ,IAAA,MAAMC,UAAAA,GAAaC,OAAAA,CAAQC,IAAI,CAACC,QAAQ,CAAC,WAAA,CAAA;AACzC,IAAA,MAAMC,QAAAA,GAAWH,OAAAA,CAAQC,IAAI,CAACC,QAAQ,CAAC,SAAA,CAAA;;AAGvC,IAAA,IAAIC,QAAAA,EAAU;QACVC,WAAAA,CAAY,OAAA,CAAA;AAChB,IAAA,CAAA,MAAO,IAAIL,UAAAA,EAAY;QACnBK,WAAAA,CAAY,SAAA,CAAA;AAChB,IAAA;AACJ;AAEO,eAAeC,cAAAA,GAAAA;;AAElBP,IAAAA,qBAAAA,EAAAA;AAiBA,IAAA,MAAMQ,kBAAAA,GAAqBC,YAAAA;IAC3B,MAAMC,kBAAAA,GAAqBF,mBAAmBG,MAAM;AAEpD,IAAA,MAAMC,eAAeF,kBAAAA,CAAmB;QACpCG,QAAAA,EAAU;YACNC,eAAAA,EAAiBC;AACrB,SAAA;QACAC,QAAAA,EAAU;AAAC,YAAA,QAAA;AAAU,YAAA;AAAe,SAAA;QACpCpB,MAAAA,EAAQC,SAAAA;AACZ,KAAA,CAAA;;IAGA,MAAM,CAACH,SAAAA,EAAWuB,YAAAA,EAAcC,aAAAA,CAAc,GAA0C,MAAMC,SAAmB,CAACP,YAAAA,CAAAA,CAAAA;;IAGlH,IAAIlB,SAAAA,CAAU0B,OAAO,EAAE;QACnBd,WAAAA,CAAY,SAAA,CAAA;AAChB,IAAA;IACA,IAAIZ,SAAAA,CAAUC,KAAK,EAAE;QACjBW,WAAAA,CAAY,OAAA,CAAA;AAChB,IAAA;AAEA,IAAA,MAAMV,MAAAA,GAASC,SAAAA,EAAAA;AACfe,IAAAA,YAAAA,CAAaS,SAAS,CAACzB,MAAAA,CAAAA;;IAGvB0B,SAAAA,CAAa1B,MAAAA,CAAAA;IACb2B,WAAAA,CAAgB3B,MAAAA,CAAAA;IAChB4B,iBAAAA,CAAkBC,kBAAAA,CAAAA;;IAGlB7B,MAAAA,CAAOE,IAAI,CAAC,gBAAA,EAAkBC,OAAAA,CAAAA;;IAG9B,IAAImB,aAAAA,CAAczB,WAAW,KAAKiC,oBAAAA,EAAsB;;;AAGpD,QAAA;AACJ,IAAA;;IAGA,IAAIR,aAAAA,CAAczB,WAAW,KAAKkC,mBAAAA,EAAqB;;;AAGnD,QAAA;AACJ,IAAA;;AAGA,IAAA,MAAMC,OAAAA,GAAU1B,OAAAA,CAAQC,IAAI,CAAC,CAAA,CAAE;IAC/B,IAAIV,WAAAA,GAAcyB,cAAczB,WAAW;;AAG3C,IAAA,IAAImC,YAAY,MAAA,IAAU1B,OAAAA,CAAQC,IAAI,CAAC,EAAE,EAAE;AACvC,QAAA,MAAM0B,kBAAAA,GAAqB3B,OAAAA,CAAQC,IAAI,CAAC,CAAA,CAAE;AAC1C,QAAA,MAAM2B,wBAAAA,GAA2B;AAAC,YAAA,QAAA;AAAU,YAAA,SAAA;AAAW,YAAA,MAAA;AAAQ,YAAA,QAAA;AAAU,YAAA,aAAA;AAAe,YAAA;AAAU,SAAA;QAClG,IAAIA,wBAAAA,CAAyB1B,QAAQ,CAACyB,kBAAAA,CAAAA,EAAqB;;YAEvDpC,WAAAA,GAAc,MAAA;QAClB,CAAA,MAAO;;YAEHA,WAAAA,GAAc,MAAA;AAClB,QAAA;AACJ,IAAA,CAAA,MAEK,IAAImC,OAAAA,KAAY,QAAA,IAAYA,OAAAA,KAAY,cAAA,IAAkBA,OAAAA,KAAY,SAAA,IAAaA,OAAAA,KAAY,SAAA,IAAaA,OAAAA,KAAY,MAAA,IAAUA,OAAAA,KAAY,MAAA,IAAUA,OAAAA,KAAY,QAAA,IAAYA,OAAAA,KAAY,cAAA,IAAkBA,OAAAA,KAAY,OAAA,IAAWA,OAAAA,KAAY,QAAA,IAAYA,OAAAA,KAAY,cAAA,IAAkBA,OAAAA,KAAY,aAAA,IAAiBA,OAAAA,KAAY,UAAA,IAAcA,OAAAA,KAAY,SAAA,EAAW;QAC1WnC,WAAAA,GAAcmC,OAAAA;AAClB,IAAA;AAEA,IAAA,IAAIG,OAAAA,GAAkB,EAAA;IAEtB,IAAI;;AAEA,QAAA,IAAItC,WAAAA,EAAa;AACbD,YAAAA,qBAAAA,CAAsBC,WAAAA,EAAaC,SAAAA,CAAAA;AACvC,QAAA;AAEA,QAAA,IAAID,gBAAgBuC,cAAAA,EAAgB;YAChCD,OAAAA,GAAU,MAAME,OAAc,CAACvC,SAAAA,CAAAA;QACnC,CAAA,MAAO,IAAID,gBAAgByC,oBAAAA,EAAsB;YAC7CH,OAAAA,GAAU,MAAMI,SAAmB,CAACzC,SAAAA,CAAAA;QACxC,CAAA,MAAO,IAAID,gBAAgB2C,eAAAA,EAAiB;AACxC,YAAA,MAAMC,cAAAA,GAAiB,MAAMC,SAAe,CAAC5C,SAAAA,CAAAA;YAC7CqC,OAAAA,GAAU,CAAA,EAAGM,eAAeE,KAAK,CAAC,IAAI,EAAEF,cAAAA,CAAeG,IAAI,CAAA,CAAE;QACjE,CAAA,MAAO,IAAI/C,gBAAgBgD,eAAAA,EAAiB;YACxC,MAAMC,SAAe,CAAChD,SAAAA,CAAAA;QAC1B,CAAA,MAAO,IAAID,gBAAgBkD,YAAAA,EAAc;AAEjCjD,YAAAA,IAAAA,sBAAAA,EAAqCA,eAAAA,EAKNA,gBAAAA;;AALnC,YAAA,IAAIA,EAAAA,sBAAAA,GAAAA,SAAAA,CAAUkD,WAAW,MAAA,IAAA,IAArBlD,6CAAAA,sBAAAA,CAAuBmD,SAAS,KAAI,EAAA,CAACnD,kBAAAA,SAAAA,CAAUoD,IAAI,cAAdpD,eAAAA,KAAAA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,eAAAA,CAAgBqD,WAAW,CAAA,EAAE;AAClErD,gBAAAA,SAAAA,CAAUoD,IAAI,GAAGpD,SAAAA,CAAUoD,IAAI,IAAI,EAAC;gBACpCpD,SAAAA,CAAUoD,IAAI,CAACC,WAAW,GAAG;oBAACrD,SAAAA,CAAUkD,WAAW,CAACC;AAAU,iBAAA;AAClE,YAAA;;YAEA,IAAInD,SAAAA,CAAUsD,gBAAgB,IAAI,EAAA,CAACtD,gBAAAA,GAAAA,SAAAA,CAAUoD,IAAI,MAAA,IAAA,IAAdpD,gBAAAA,KAAAA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,gBAAAA,CAAgBuD,OAAO,CAAA,EAAE;AACxDvD,gBAAAA,SAAAA,CAAUoD,IAAI,GAAGpD,SAAAA,CAAUoD,IAAI,IAAI,EAAC;AACpCpD,gBAAAA,SAAAA,CAAUoD,IAAI,CAACG,OAAO,GAAGvD,UAAUsD,gBAAgB;AACvD,YAAA;YACAjB,OAAAA,GAAU,MAAMmB,SAAY,CAACxD,SAAAA,CAAAA;QACjC,CAAA,MAAO,IAAID,gBAAgB0D,YAAAA,EAAc;YACrCpB,OAAAA,GAAU,MAAMqB,SAAY,CAAC1D,SAAAA,CAAAA;QACjC,CAAA,MAAO,IAAID,gBAAgB4D,cAAAA,EAAgB;YACvCtB,OAAAA,GAAU,MAAMuB,SAAc,CAAC5D,SAAAA,CAAAA;QACnC,CAAA,MAAO,IAAID,gBAAgB8D,oBAAAA,EAAsB;YAC7CxB,OAAAA,GAAU,MAAMyB,SAAmB,CAAC9D,SAAAA,CAAAA;QACxC,CAAA,MAAO,IAAID,gBAAgBgE,aAAAA,EAAe;YACtC,MAAMC,SAAa,CAAChE,SAAAA,CAAAA;YACpBqC,OAAAA,GAAU,wCAAA;QACd,CAAA,MAAO,IAAItC,gBAAgBkE,cAAAA,EAAgB;YACvC5B,OAAAA,GAAU,MAAM6B,SAAc,CAAClE,SAAAA,CAAAA;QACnC,CAAA,MAAO,IAAID,gBAAgBoE,oBAAAA,EAAsB;YAC7C,MAAMC,SAAmB,CAACpE,SAAAA,CAAAA;YAC1BqC,OAAAA,GAAU,yCAAA;QACd,CAAA,MAAO,IAAItC,gBAAgBsE,mBAAAA,EAAqB;YAC5ChC,OAAAA,GAAU,MAAMiC,SAAmB,CAACtE,SAAAA,CAAAA;QACxC,CAAA,MAAO,IAAID,gBAAgBwE,gBAAAA,EAAkB;YACzClC,OAAAA,GAAU,MAAMmC,SAAgB,CAACxE,SAAAA,CAAAA;QACrC,CAAA,MAAO,IAAID,gBAAgB0E,eAAAA,EAAiB;YACxCpC,OAAAA,GAAU,MAAMqC,SAAe,CAAC1E,SAAAA,CAAAA;AACpC,QAAA;;AAGA2E,QAAAA,OAAAA,CAAQC,GAAG,CAAC,CAAC,IAAI,EAAEvC,OAAAA,CAAQ,IAAI,CAAC,CAAA;AACpC,IAAA,CAAA,CAAE,OAAOwC,KAAAA,EAAY;;AAEjB,QAAA,IAAIA,iBAAiBC,qBAAAA,EAAuB;YACxC5E,MAAAA,CAAOE,IAAI,CAACyE,KAAAA,CAAME,OAAO,CAAA;AACzBvE,YAAAA,OAAAA,CAAQwE,IAAI,CAAC,CAAA,CAAA;AACjB,QAAA;;QAGA,MAAMH,KAAAA;AACV,IAAA;AACJ;;;;"}
+{"version":3,"file":"application.js","sources":["../src/application.ts"],"sourcesContent":["import * as Cardigantime from '@theunwalked/cardigantime';\nimport 'dotenv/config';\nimport { setLogger as setGitLogger } from '@eldrforge/git-tools';\nimport { setLogger as setGitHubLogger, setPromptFunction } from '@eldrforge/github-tools';\nimport { promptConfirmation } from './util/stdin';\nimport { CommandConfig } from 'types';\nimport * as Arguments from './arguments';\nimport * as AudioCommit from './commands/audio-commit';\nimport * as AudioReview from './commands/audio-review';\nimport * as Clean from './commands/clean';\nimport * as Commit from './commands/commit';\nimport * as Development from './commands/development';\nimport * as Link from './commands/link';\nimport * as Publish from './commands/publish';\nimport * as Release from './commands/release';\nimport * as Review from './commands/review';\nimport * as SelectAudio from './commands/select-audio';\nimport * as Tree from './commands/tree';\nimport * as Unlink from './commands/unlink';\nimport * as Updates from './commands/updates';\nimport * as Versions from './commands/versions';\nimport { COMMAND_AUDIO_COMMIT, COMMAND_AUDIO_REVIEW, COMMAND_CHECK_CONFIG, COMMAND_CLEAN, COMMAND_COMMIT, COMMAND_DEVELOPMENT, COMMAND_INIT_CONFIG, COMMAND_LINK, COMMAND_PUBLISH, COMMAND_RELEASE, COMMAND_REVIEW, COMMAND_SELECT_AUDIO, COMMAND_TREE, COMMAND_UNLINK, COMMAND_UPDATES, COMMAND_VERSIONS, DEFAULT_CONFIG_DIR, VERSION } from './constants';\nimport { UserCancellationError } from './error/CommandErrors';\nimport { getLogger, setLogLevel } from './logging';\nimport { Config, SecureConfig } from './types';\n\n/**\n * Print debug information about the command being executed when debug flag is enabled.\n */\nfunction printDebugCommandInfo(commandName: string, runConfig: Config): void {\n    if (runConfig.debug) {\n        const logger = getLogger();\n        logger.info('DEBUG_INFO_HEADER: KodrDriv debug information');\n        logger.info('DEBUG_INFO_COMMAND: Command being executed | Command: %s', commandName);\n        logger.info('DEBUG_INFO_VERSION: KodrDriv version | Version: %s', VERSION);\n        logger.info('DEBUG_INFO_FOOTER: End of debug information');\n    }\n}\n\n/**\n * Configure early logging based on command line flags.\n *\n * Hey we need this because we need to be able to debug CardiganTime.\n * This method checks for --verbose and --debug flags early in the process\n * before CardiganTime is configured, allowing us to capture debug output\n * from the CardiganTime initialization itself.\n */\nexport function configureEarlyLogging(): void {\n    const hasVerbose = process.argv.includes('--verbose');\n    const hasDebug = process.argv.includes('--debug');\n\n    // Set log level based on early flag detection\n    if (hasDebug) {\n        setLogLevel('debug');\n    } else if (hasVerbose) {\n        setLogLevel('verbose');\n    }\n}\n\nexport async function runApplication(): Promise<void> {\n    // Configure logging early, before CardiganTime initialization\n    configureEarlyLogging();\n\n    // Use proper typing for CardiganTime create function\n    interface CardigantimeCreateParams {\n        defaults?: any;\n        features?: string[];\n        configShape?: any;\n        logger?: any;\n    }\n\n    interface CardigantimeInstance {\n        read: (args: any) => Promise<any>;\n        checkConfig: () => Promise<void>;\n        generateConfig: (dir: string) => Promise<void>;\n        setLogger: (logger: any) => void;\n    }\n\n    const cardigantimeModule = Cardigantime as any;\n    const createCardigantime = cardigantimeModule.create as (params: CardigantimeCreateParams) => CardigantimeInstance;\n\n    const cardigantime = createCardigantime({\n        defaults: {\n            configDirectory: DEFAULT_CONFIG_DIR,\n        },\n        features: ['config', 'hierarchical'],\n        logger: getLogger(),\n    });\n\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const [runConfig, secureConfig, commandConfig]: [Config, SecureConfig, CommandConfig] = await Arguments.configure(cardigantime); // Pass cardigantime instance\n\n    // Set log level based on verbose flag\n    if (runConfig.verbose) {\n        setLogLevel('verbose');\n    }\n    if (runConfig.debug) {\n        setLogLevel('debug');\n    }\n\n    const logger = getLogger();\n    cardigantime.setLogger(logger);\n\n    // Configure external packages to use our logger and prompt\n    setGitLogger(logger);\n    setGitHubLogger(logger);\n    setPromptFunction(promptConfirmation);\n\n    // Display version information\n    logger.info('APPLICATION_STARTING: KodrDriv application initializing | Version: %s | Status: starting', VERSION);\n\n    // Handle check-config command first\n    if (commandConfig.commandName === COMMAND_CHECK_CONFIG) {\n        // CardiganTime's checkConfig has already been called in Arguments.configure()\n        // No additional processing needed here\n        return;\n    }\n\n    // Handle init-config command\n    if (commandConfig.commandName === COMMAND_INIT_CONFIG) {\n        // CardiganTime's initConfig has already been called in Arguments.configure()\n        // No additional processing needed here\n        return;\n    }\n\n    // Get the command from Commander\n    const command = process.argv[2];\n    let commandName = commandConfig.commandName;\n\n    // Handle special case for tree command with built-in command argument\n    if (command === 'tree' && process.argv[3]) {\n        const treeBuiltInCommand = process.argv[3];\n        const supportedBuiltInCommands = ['commit', 'publish', 'link', 'unlink', 'development', 'updates'];\n        if (supportedBuiltInCommands.includes(treeBuiltInCommand)) {\n            // This is a tree command with built-in command, keep commandName as 'tree'\n            commandName = 'tree';\n        } else {\n            // Unknown tree argument, let it fail naturally in tree.ts\n            commandName = 'tree';\n        }\n    }\n    // If we have a specific command argument, use that\n    else if (command === 'commit' || command === 'audio-commit' || command === 'release' || command === 'publish' || command === 'tree' || command === 'link' || command === 'unlink' || command === 'audio-review' || command === 'clean' || command === 'review' || command === 'select-audio' || command === 'development' || command === 'versions' || command === 'updates') {\n        commandName = command;\n    }\n\n    let summary: string = '';\n\n    try {\n        // Print debug info at the start of command execution\n        if (commandName) {\n            printDebugCommandInfo(commandName, runConfig);\n        }\n\n        if (commandName === COMMAND_COMMIT) {\n            summary = await Commit.execute(runConfig);\n        } else if (commandName === COMMAND_AUDIO_COMMIT) {\n            summary = await AudioCommit.execute(runConfig);\n        } else if (commandName === COMMAND_RELEASE) {\n            const releaseSummary = await Release.execute(runConfig);\n            summary = `${releaseSummary.title}\\n\\n${releaseSummary.body}`;\n        } else if (commandName === COMMAND_PUBLISH) {\n            await Publish.execute(runConfig);\n        } else if (commandName === COMMAND_TREE) {\n            // Handle tree directories mapping from command-specific arguments\n            if (runConfig.audioReview?.directory && !runConfig.tree?.directories) {\n                runConfig.tree = runConfig.tree || {};\n                runConfig.tree.directories = [runConfig.audioReview.directory];\n            }\n            // Handle tree exclusion patterns - use global excludedPatterns for tree\n            if (runConfig.excludedPatterns && !runConfig.tree?.exclude) {\n                runConfig.tree = runConfig.tree || {};\n                runConfig.tree.exclude = runConfig.excludedPatterns;\n            }\n            summary = await Tree.execute(runConfig);\n        } else if (commandName === COMMAND_LINK) {\n            summary = await Link.execute(runConfig);\n        } else if (commandName === COMMAND_UNLINK) {\n            summary = await Unlink.execute(runConfig);\n        } else if (commandName === COMMAND_AUDIO_REVIEW) {\n            summary = await AudioReview.execute(runConfig);\n        } else if (commandName === COMMAND_CLEAN) {\n            await Clean.execute(runConfig);\n            summary = 'Output directory cleaned successfully.';\n        } else if (commandName === COMMAND_REVIEW) {\n            summary = await Review.execute(runConfig);\n        } else if (commandName === COMMAND_SELECT_AUDIO) {\n            await SelectAudio.execute(runConfig);\n            summary = 'Audio selection completed successfully.';\n        } else if (commandName === COMMAND_DEVELOPMENT) {\n            summary = await Development.execute(runConfig);\n        } else if (commandName === COMMAND_VERSIONS) {\n            summary = await Versions.execute(runConfig);\n        } else if (commandName === COMMAND_UPDATES) {\n            summary = await Updates.execute(runConfig);\n        }\n\n        // eslint-disable-next-line no-console\n        console.log(`\\n\\n${summary}\\n\\n`);\n    } catch (error: any) {\n        // Handle user cancellation gracefully\n        if (error instanceof UserCancellationError) {\n            logger.info('APPLICATION_ERROR: Application error occurred | Error: ' + error.message);\n            process.exit(0);\n        }\n\n        // Re-throw other errors to be handled by main.ts\n        throw error;\n    }\n}\n"],"names":["printDebugCommandInfo","commandName","runConfig","debug","logger","getLogger","info","VERSION","configureEarlyLogging","hasVerbose","process","argv","includes","hasDebug","setLogLevel","runApplication","cardigantimeModule","Cardigantime","createCardigantime","create","cardigantime","defaults","configDirectory","DEFAULT_CONFIG_DIR","features","secureConfig","commandConfig","Arguments","verbose","setLogger","setGitLogger","setGitHubLogger","setPromptFunction","promptConfirmation","COMMAND_CHECK_CONFIG","COMMAND_INIT_CONFIG","command","treeBuiltInCommand","supportedBuiltInCommands","summary","COMMAND_COMMIT","Commit","COMMAND_AUDIO_COMMIT","AudioCommit","COMMAND_RELEASE","releaseSummary","Release","title","body","COMMAND_PUBLISH","Publish","COMMAND_TREE","audioReview","directory","tree","directories","excludedPatterns","exclude","Tree","COMMAND_LINK","Link","COMMAND_UNLINK","Unlink","COMMAND_AUDIO_REVIEW","AudioReview","COMMAND_CLEAN","Clean","COMMAND_REVIEW","Review","COMMAND_SELECT_AUDIO","SelectAudio","COMMAND_DEVELOPMENT","Development","COMMAND_VERSIONS","Versions","COMMAND_UPDATES","Updates","console","log","error","UserCancellationError","message","exit"],"mappings":"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"}

package/dist/arguments.js

@@ -33,6 +33,8 @@ z.object({
     from: z.string().optional(),
     to: z.string().optional(),
     targetVersion: z.string().optional(),
+    skipAlreadyPublished: z.boolean().optional(),
+    forceRepublish: z.boolean().optional(),
     excludedPatterns: z.array(z.string()).optional(),
     excludedPaths: z.array(z.string()).optional(),
     exclude: z.array(z.string()).optional(),
@@ -78,7 +80,9 @@ z.object({
     scope: z.string().optional(),
     tagWorkingBranch: z.boolean().optional(),
     createRetroactiveTags: z.boolean().optional(),
-    workingTagPrefix: z.string().optional()
+    workingTagPrefix: z.string().optional(),
+    updateDeps: z.string().optional(),
+    interProject: z.boolean().optional()
 });
 // Function to transform flat CLI args into nested Config structure
 const transformCliArgs = (finalCliArgs, commandName)=>{
@@ -136,14 +140,17 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
         }
     }
     // Nested mappings for 'publish' options – map whenever publish-specific options are provided
-    if (finalCliArgs.mergeMethod !== undefined || finalCliArgs.targetVersion !== undefined || finalCliArgs.interactive !== undefined || finalCliArgs.syncTarget !== undefined || commandName === 'publish' && (finalCliArgs.from !== undefined || finalCliArgs.noMilestones !== undefined)) {
+    if (finalCliArgs.mergeMethod !== undefined || finalCliArgs.targetVersion !== undefined || finalCliArgs.interactive !== undefined || finalCliArgs.syncTarget !== undefined || finalCliArgs.skipAlreadyPublished !== undefined || finalCliArgs.forceRepublish !== undefined || commandName === 'publish' && (finalCliArgs.from !== undefined || finalCliArgs.noMilestones !== undefined)) {
         transformedCliArgs.publish = {};
         if (finalCliArgs.mergeMethod !== undefined) transformedCliArgs.publish.mergeMethod = finalCliArgs.mergeMethod;
-        if ((commandName === 'publish' || finalCliArgs.mergeMethod !== undefined || finalCliArgs.targetVersion !== undefined || finalCliArgs.syncTarget !== undefined || finalCliArgs.interactive !== undefined) && finalCliArgs.from !== undefined) transformedCliArgs.publish.from = finalCliArgs.from;
+        if ((commandName === 'publish' || finalCliArgs.mergeMethod !== undefined || finalCliArgs.targetVersion !== undefined || finalCliArgs.syncTarget !== undefined || finalCliArgs.interactive !== undefined || finalCliArgs.skipAlreadyPublished !== undefined || finalCliArgs.forceRepublish !== undefined) && finalCliArgs.from !== undefined) transformedCliArgs.publish.from = finalCliArgs.from;
         if (finalCliArgs.targetVersion !== undefined) transformedCliArgs.publish.targetVersion = finalCliArgs.targetVersion;
         if (finalCliArgs.interactive !== undefined) transformedCliArgs.publish.interactive = finalCliArgs.interactive;
         if (finalCliArgs.syncTarget !== undefined) transformedCliArgs.publish.syncTarget = finalCliArgs.syncTarget;
-        if ((commandName === 'publish' || finalCliArgs.mergeMethod !== undefined || finalCliArgs.targetVersion !== undefined || finalCliArgs.syncTarget !== undefined || finalCliArgs.interactive !== undefined) && finalCliArgs.noMilestones !== undefined) transformedCliArgs.publish.noMilestones = finalCliArgs.noMilestones;
+        if (finalCliArgs.skipAlreadyPublished !== undefined) transformedCliArgs.publish.skipAlreadyPublished = finalCliArgs.skipAlreadyPublished;
+        if (finalCliArgs.forceRepublish !== undefined) transformedCliArgs.publish.forceRepublish = finalCliArgs.forceRepublish;
+        if ((commandName === 'publish' || finalCliArgs.mergeMethod !== undefined || finalCliArgs.targetVersion !== undefined || finalCliArgs.syncTarget !== undefined || finalCliArgs.interactive !== undefined || finalCliArgs.skipAlreadyPublished !== undefined || finalCliArgs.forceRepublish !== undefined) && finalCliArgs.noMilestones !== undefined) transformedCliArgs.publish.noMilestones = finalCliArgs.noMilestones;
+        if (finalCliArgs.updateDeps !== undefined) transformedCliArgs.publish.updateDeps = finalCliArgs.updateDeps;
     }
     // Nested mappings for 'development' options
     if (commandName === 'development' && (finalCliArgs.targetVersion !== undefined || finalCliArgs.noMilestones !== undefined || finalCliArgs.tagWorkingBranch !== undefined || finalCliArgs.createRetroactiveTags !== undefined || finalCliArgs.workingTagPrefix !== undefined)) {
@@ -247,7 +254,8 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
         const builtInCommand = finalCliArgs.builtInCommand;
         const packageArgument = finalCliArgs.packageArgument;
         // Only create tree object if there are actual tree-specific options
-        if (finalCliArgs.directories !== undefined || finalCliArgs.directory !== undefined || finalCliArgs.startFrom !== undefined || finalCliArgs.stopAt !== undefined || finalCliArgs.cmd !== undefined || builtInCommand !== undefined || finalCliArgs.continue !== undefined || packageArgument !== undefined || finalCliArgs.cleanNodeModules !== undefined || finalCliArgs.externals !== undefined) {
+        const cliArgs = finalCliArgs;
+        if (finalCliArgs.directories !== undefined || finalCliArgs.directory !== undefined || finalCliArgs.startFrom !== undefined || finalCliArgs.stopAt !== undefined || finalCliArgs.cmd !== undefined || builtInCommand !== undefined || finalCliArgs.continue !== undefined || packageArgument !== undefined || finalCliArgs.cleanNodeModules !== undefined || finalCliArgs.externals !== undefined || cliArgs.statusParallel !== undefined || cliArgs.auditBranches !== undefined || cliArgs.parallel !== undefined || cliArgs.markCompleted !== undefined || cliArgs.skip !== undefined || cliArgs.retryFailed !== undefined || cliArgs.skipFailed !== undefined || cliArgs.validateState !== undefined) {
             transformedCliArgs.tree = {};
             if (finalCliArgs.directories !== undefined) transformedCliArgs.tree.directories = finalCliArgs.directories;
             else if (finalCliArgs.directory !== undefined) transformedCliArgs.tree.directories = [
@@ -263,8 +271,7 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
             if (packageArgument !== undefined) transformedCliArgs.tree.packageArgument = packageArgument;
             if (finalCliArgs.cleanNodeModules !== undefined) transformedCliArgs.tree.cleanNodeModules = finalCliArgs.cleanNodeModules;
             if (finalCliArgs.externals !== undefined) transformedCliArgs.tree.externals = finalCliArgs.externals;
-            // Parallel execution options (using any cast for new properties)
-            const cliArgs = finalCliArgs;
+            // Parallel execution options
             if (cliArgs.parallel !== undefined) transformedCliArgs.tree.parallel = cliArgs.parallel;
             if (cliArgs.maxConcurrency !== undefined) transformedCliArgs.tree.maxConcurrency = cliArgs.maxConcurrency;
             if (cliArgs.maxRetries !== undefined || cliArgs.retryDelay !== undefined) {
@@ -277,6 +284,7 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
             }
             // Recovery options
             if (cliArgs.statusParallel !== undefined) transformedCliArgs.tree.statusParallel = cliArgs.statusParallel;
+            if (cliArgs.auditBranches !== undefined) transformedCliArgs.tree.auditBranches = cliArgs.auditBranches;
             if (cliArgs.markCompleted !== undefined) {
                 transformedCliArgs.tree.markCompleted = cliArgs.markCompleted.split(',').map((s)=>s.trim());
             }
@@ -304,10 +312,11 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
         if (finalCliArgs.directories !== undefined) transformedCliArgs.versions.directories = finalCliArgs.directories;
     }
     // Nested mappings for 'updates' options
-    if (commandName === 'updates' && (finalCliArgs.scope !== undefined || finalCliArgs.directories !== undefined)) {
+    if (commandName === 'updates' && (finalCliArgs.scope !== undefined || finalCliArgs.directories !== undefined || finalCliArgs.interProject !== undefined)) {
         transformedCliArgs.updates = {};
         if (finalCliArgs.scope !== undefined) transformedCliArgs.updates.scope = finalCliArgs.scope;
         if (finalCliArgs.directories !== undefined) transformedCliArgs.updates.directories = finalCliArgs.directories;
+        if (finalCliArgs.interProject !== undefined) transformedCliArgs.updates.interProject = finalCliArgs.interProject;
     }
     // Handle excluded patterns (Commander.js converts --excluded-paths to excludedPaths)
     // Also handle exclude as alias for excludedPatterns
@@ -619,9 +628,30 @@ async function getCliConfig(program, commands) {
     addSharedOptions(audioCommitCommand);
     const releaseCommand = program.command('release').option('--from <from>', 'branch to generate release notes from').option('--to <to>', 'branch to generate release notes to').option('--context <context>', 'context for the commit message').option('--interactive', 'Present release notes for interactive review and editing').option('--max-diff-bytes <maxDiffBytes>', 'maximum bytes per file in diff (default: 2048)').option('--no-milestones', 'disable GitHub milestone integration').option('--from-main', 'force comparison against main branch instead of previous release tag').description('Generate release notes');
     addSharedOptions(releaseCommand);
-    const publishCommand = program.command('publish').option('--merge-method <method>', 'method to merge PR (merge, squash, rebase)', 'squash').option('--from <from>', 'branch/tag to generate release notes from (default: previous release tag)').option('--target-version <targetVersion>', 'target version for release (explicit version like "4.30.0" or semantic bump: "patch", "minor", "major")').option('--interactive', 'present release notes for interactive review and editing').option('--sendit', 'skip all confirmation prompts and proceed automatically').option('--sync-target', 'attempt to automatically sync target branch with remote before publishing').option('--no-milestones', 'disable GitHub milestone integration').option('--from-main', 'force comparison against main branch instead of previous release tag').description('Publish a release');
+    const publishCommand = program.command('publish').option('--merge-method <method>', 'method to merge PR (merge, squash, rebase)', 'squash').option('--from <from>', 'branch/tag to generate release notes from (default: previous release tag)').option('--target-version <targetVersion>', 'target version for release (explicit version like "4.30.0" or semantic bump: "patch", "minor", "major")').option('--interactive', 'present release notes for interactive review and editing').option('--sendit', 'skip all confirmation prompts and proceed automatically').option('--sync-target', 'attempt to automatically sync target branch with remote before publishing').option('--skip-already-published', 'skip packages that are already published at target version on npm').option('--force-republish', 'delete existing tags and force republish even if tag exists').option('--no-milestones', 'disable GitHub milestone integration').option('--from-main', 'force comparison against main branch instead of previous release tag').option('--update-deps <scope>', 'update inter-project dependencies before publish (e.g., --update-deps @fjell)').description('Publish a release');
     addSharedOptions(publishCommand);
-    const treeCommand = program.command('tree [command] [packageArgument]').option('--directory <directory>', 'target directory containing multiple packages (defaults to current directory)').option('--directories [directories...]', 'target directories containing multiple packages (defaults to current directory)').option('--start-from <startFrom>', 'resume execution from this package directory name (useful for restarting failed builds)').option('--stop-at <stopAt>', 'stop execution at this package directory name (the specified package will not be executed)').option('--cmd <cmd>', 'shell command to execute in each package directory (e.g., "npm install", "git status")').option('--parallel', 'execute packages in parallel when dependencies allow (packages with no interdependencies run simultaneously)').option('--max-concurrency <number>', 'maximum number of packages to execute concurrently (default: number of CPU cores)', parseInt).option('--max-retries <number>', 'maximum retry attempts for failed packages (default: 3)', parseInt).option('--retry-delay <ms>', 'initial retry delay in milliseconds (default: 5000)', parseInt).option('--excluded-patterns [excludedPatterns...]', 'patterns to exclude packages from processing (e.g., "**/node_modules/**", "dist/*")').option('--continue', 'continue from previous tree publish execution').option('--status', 'check status of running tree publish processes').option('--status-parallel', 'show detailed parallel execution status').option('--promote <packageName>', 'mark a package as completed in the execution context (useful for recovery after timeouts)').option('--mark-completed <packages>', 'mark packages as completed using directory names (comma-separated, for recovery)').option('--skip <packages>', 'skip packages and their dependents (comma-separated)').option('--retry-failed', 'retry all previously failed packages').option('--skip-failed', 'skip failed packages and continue with remaining').option('--validate-state', 'validate checkpoint state integrity').option('--clean-node-modules', 'for unlink command: remove node_modules and package-lock.json, then reinstall dependencies').description('Analyze package dependencies in workspace and execute commands in dependency order. Supports built-in commands: commit, publish, link, unlink, development, branches, run, checkout');
+    const treeCommand = program.command('tree [command] [packageArgument]').option('--directory <directory>', 'target directory containing multiple packages (defaults to current directory)').option('--directories [directories...]', 'target directories containing multiple packages (defaults to current directory)').option('--start-from <startFrom>', 'resume execution from this package directory name (useful for restarting failed builds)').option('--stop-at <stopAt>', 'stop execution at this package directory name (the specified package will not be executed)').option('--cmd <cmd>', 'shell command to execute in each package directory (e.g., "npm install", "git status")')// Parallel Execution Options
+    .option('--parallel', 'execute packages in parallel when dependencies allow (packages with no interdependencies run simultaneously)').option('--max-concurrency <number>', 'maximum number of packages to execute concurrently (default: number of CPU cores)', parseInt).option('--max-retries <number>', 'maximum retry attempts for failed packages (default: 3)', parseInt).option('--retry-delay <ms>', 'initial retry delay in milliseconds (default: 5000)', parseInt)// Recovery & Status Options
+    .option('--continue', 'continue from previous tree publish execution using saved checkpoint state').option('--status', 'check status of running tree publish processes').option('--status-parallel', 'show detailed parallel execution status with package states, timing, and errors').option('--audit-branches', 'audit git branch state across all packages (checks branch consistency, merge conflicts with target, existing PRs, sync status, unpushed commits)').option('--promote <packageName>', 'mark a package as completed in the execution context (useful for recovery after timeouts)').option('--mark-completed <packages>', 'mark packages as completed using directory names (comma-separated, for recovery)').option('--skip <packages>', 'skip packages and their dependents (comma-separated)').option('--retry-failed', 'retry all previously failed packages from checkpoint').option('--skip-failed', 'skip failed packages and continue with remaining packages').option('--validate-state', 'validate checkpoint state integrity before continuing')// Package Filtering
+    .option('--excluded-patterns [excludedPatterns...]', 'patterns to exclude packages from processing (e.g., "**/node_modules/**", "dist/*")')// Link/Unlink Options
+    .option('--clean-node-modules', 'for unlink command: remove node_modules and package-lock.json, then reinstall dependencies').description(`Analyze package dependencies in workspace and execute commands in dependency order.
+
+Built-in commands:
+  commit      - Run 'kodrdriv commit' in each package
+  publish     - Run 'kodrdriv publish' in each package (supports --parallel)
+  link        - Create file: dependencies for local development
+  unlink      - Restore npm registry dependencies
+  development - Switch to development branch with version bump
+  branches    - Show branch information for all packages
+  run         - Execute custom shell command (use --cmd)
+  checkout    - Checkout specified branch in all packages
+
+Examples:
+  kodrdriv tree publish --parallel --model "gpt-5-mini"
+  kodrdriv tree --cmd "npm test"
+  kodrdriv tree publish --continue --retry-failed
+  kodrdriv tree publish --audit-branches
+  kodrdriv tree publish --status-parallel`);
     addSharedOptions(treeCommand);
     const linkCommand = program.command('link [packageArgument]').option('--scope-roots <scopeRoots>', 'JSON mapping of scopes to root directories (e.g., \'{"@company": "../"}\')').description('Create npm file: dependencies for local development');
     addSharedOptions(linkCommand);
@@ -774,7 +804,7 @@ async function getCliConfig(program, commands) {
     addSharedOptions(developmentCommand);
     const versionsCommand = program.command('versions <subcommand>').option('--directories [directories...]', 'directories to scan for packages (defaults to current directory)').description('Update dependency versions across packages. Subcommands: minor');
     addSharedOptions(versionsCommand);
-    const updatesCommand = program.command('updates <scope>').option('--directories [directories...]', 'directories to scan for packages (tree mode, defaults to current directory)').description('Update dependencies matching a specific scope using npm-check-updates (e.g., kodrdriv updates @fjell)');
+    const updatesCommand = program.command('updates [scope]').option('--directories [directories...]', 'directories to scan for packages (tree mode, defaults to current directory)').option('--inter-project', 'update inter-project dependencies based on tree state (requires --scope)').description('Update dependencies matching a specific scope using npm-check-updates (e.g., kodrdriv updates @fjell) or update inter-project dependencies (kodrdriv updates --inter-project @fjell)');
     addSharedOptions(updatesCommand);
     const selectAudioCommand = program.command('select-audio').description('Interactively select and save audio device for recording');
     addSharedOptions(selectAudioCommand);
@@ -1139,10 +1169,10 @@ async function validateContextDirectories(contextDirectories) {
             if (await storage.isDirectoryReadable(dir)) {
                 validDirectories.push(dir);
             } else {
-                logger.warn(`Directory not readable: ${dir}`);
+                logger.warn(`DIRECTORY_NOT_READABLE: Directory not readable | Directory: ${dir} | Impact: Cannot scan for packages`);
             }
         } catch (error) {
-            logger.warn(`Error validating directory ${dir}: ${error.message}`);
+            logger.warn(`DIRECTORY_VALIDATION_ERROR: Error validating directory | Directory: ${dir} | Error: ${error.message}`);
         }
     }
     return validDirectories;