@eldrforge/kodrdriv 1.2.124 → 1.2.126

package/README.md

@@ -21,11 +21,17 @@ npm install -g @eldrforge/kodrdriv
 ```bash
 git add .
 kodrdriv commit
+
+# Or use agentic mode for deep analysis
+kodrdriv commit --agentic --self-reflection
 ```
 
 ### Generate Release Notes
 ```bash
 kodrdriv release
+
+# Or use agentic mode for comprehensive analysis
+kodrdriv release --agentic --self-reflection
 ```
 
 ### Automate Your Release Process
@@ -42,7 +48,13 @@ kodrdriv audio-commit  # Record audio to generate commit messages
 ## Key Features
 
 - **AI-Powered Analysis** - Uses OpenAI models to understand your code changes
+- **Agentic Mode (NEW)** - AI-powered tool-calling for deep investigation and analysis
+  - 13 specialized tools for release notes generation
+  - 8 tools for commit message generation
+  - Self-reflection reports with tool effectiveness metrics
+  - Configurable iteration limits for complex releases
 - **GitHub Issues Integration** - Automatically analyzes recently closed issues to provide context for commit messages, prioritizing milestone-relevant issues
+- **Stop-Context Filtering** - Automatically filters sensitive information from AI-generated content to maintain privacy across projects
 - **Adaptive Diff Management** - Automatically handles large diffs with intelligent truncation and retry logic to ensure reliable LLM processing
 - **Comprehensive Release Automation** - Handles dependency updates, version bumping, PR creation, and GitHub releases
 - **Audio-Driven Workflows** - Record audio to provide context for commits and reviews

package/dist/arguments.js

@@ -81,7 +81,10 @@ z.object({
     createRetroactiveTags: z.boolean().optional(),
     workingTagPrefix: z.string().optional(),
     updateDeps: z.string().optional(),
-    interProject: z.boolean().optional()
+    interProject: z.boolean().optional(),
+    agentic: z.boolean().optional(),
+    selfReflection: z.boolean().optional(),
+    maxAgenticIterations: z.number().optional()
 });
 // Function to transform flat CLI args into nested Config structure
 const transformCliArgs = (finalCliArgs, commandName)=>{
@@ -125,7 +128,7 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
     }
     // Nested mappings for 'release' options (only when it's NOT a publish command)
     if (commandName !== 'publish') {
-        if (finalCliArgs.from !== undefined || finalCliArgs.to !== undefined || finalCliArgs.maxDiffBytes !== undefined || finalCliArgs.interactive !== undefined || finalCliArgs.noMilestones !== undefined || finalCliArgs.openaiReasoning !== undefined || finalCliArgs.openaiMaxOutputTokens !== undefined) {
+        if (finalCliArgs.from !== undefined || finalCliArgs.to !== undefined || finalCliArgs.maxDiffBytes !== undefined || finalCliArgs.interactive !== undefined || finalCliArgs.noMilestones !== undefined || finalCliArgs.openaiReasoning !== undefined || finalCliArgs.openaiMaxOutputTokens !== undefined || finalCliArgs.agentic !== undefined || finalCliArgs.selfReflection !== undefined || finalCliArgs.maxAgenticIterations !== undefined) {
             transformedCliArgs.release = {};
             if (finalCliArgs.from !== undefined) transformedCliArgs.release.from = finalCliArgs.from;
             if (finalCliArgs.to !== undefined) transformedCliArgs.release.to = finalCliArgs.to;
@@ -136,6 +139,9 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
             if (finalCliArgs.noMilestones !== undefined) transformedCliArgs.release.noMilestones = finalCliArgs.noMilestones;
             if (finalCliArgs.openaiReasoning !== undefined) transformedCliArgs.release.openaiReasoning = finalCliArgs.openaiReasoning;
             if (finalCliArgs.openaiMaxOutputTokens !== undefined) transformedCliArgs.release.openaiMaxOutputTokens = finalCliArgs.openaiMaxOutputTokens;
+            if (finalCliArgs.agentic !== undefined) transformedCliArgs.release.agentic = finalCliArgs.agentic;
+            if (finalCliArgs.selfReflection !== undefined) transformedCliArgs.release.selfReflection = finalCliArgs.selfReflection;
+            if (finalCliArgs.maxAgenticIterations !== undefined) transformedCliArgs.release.maxAgenticIterations = finalCliArgs.maxAgenticIterations;
         }
     }
     // Nested mappings for 'publish' options – map whenever publish-specific options are provided
@@ -527,7 +533,7 @@ async function getCliConfig(program, commands) {
     // Add global options to the main program
     // (cardigantime already adds most global options like --verbose, --debug, --config-dir)
     // Add subcommands
-    const commitCommand = program.command('commit').argument('[direction]', 'direction or guidance for the commit message').description('Generate commit notes').option('--context <context>', 'context for the commit message').option('--cached', 'use cached diff').option('--add', 'add all changes before committing').option('--sendit', 'Commit with the message generated. No review.').option('--interactive', 'Present commit message for interactive review and editing').option('--amend', 'Amend the last commit with the generated message').option('--push [remote]', 'push to remote after committing (default: origin)').option('--message-limit <messageLimit>', 'limit the number of messages to generate').option('--skip-file-check', 'skip check for file: dependencies before committing').option('--max-diff-bytes <maxDiffBytes>', 'maximum bytes per file in diff (default: 2048)');
+    const commitCommand = program.command('commit').argument('[direction]', 'direction or guidance for the commit message').description('Generate commit notes').option('--context <context>', 'context for the commit message').option('--cached', 'use cached diff').option('--add', 'add all changes before committing').option('--sendit', 'Commit with the message generated. No review.').option('--interactive', 'Present commit message for interactive review and editing').option('--amend', 'Amend the last commit with the generated message').option('--push [remote]', 'push to remote after committing (default: origin)').option('--message-limit <messageLimit>', 'limit the number of messages to generate').option('--skip-file-check', 'skip check for file: dependencies before committing').option('--max-diff-bytes <maxDiffBytes>', 'maximum bytes per file in diff (default: 2048)').option('--agentic', 'use agentic mode with tool-calling for commit message generation').option('--self-reflection', 'generate self-reflection report with tool effectiveness analysis').option('--max-agentic-iterations <iterations>', 'maximum iterations for agentic mode (default: 10)', parseInt).option('--allow-commit-splitting', 'allow agentic mode to suggest splitting commits').option('--tool-timeout <timeout>', 'timeout for tool execution in milliseconds', parseInt);
     // Add shared options to commit command
     addSharedOptions(commitCommand);
     // Customize help output for commit command
@@ -568,6 +574,36 @@ async function getCliConfig(program, commands) {
                 [
                     '--message-limit <messageLimit>',
                     'limit the number of messages to generate'
+                ],
+                [
+                    '--skip-file-check',
+                    'skip check for file: dependencies before committing'
+                ],
+                [
+                    '--max-diff-bytes <maxDiffBytes>',
+                    'maximum bytes per file in diff (default: 20480)'
+                ]
+            ];
+            const agenticOptions = [
+                [
+                    '--agentic',
+                    'use agentic mode with tool-calling for commit generation'
+                ],
+                [
+                    '--self-reflection',
+                    'generate self-reflection report with tool effectiveness analysis'
+                ],
+                [
+                    '--max-agentic-iterations <iterations>',
+                    'maximum iterations for agentic mode (default: 10)'
+                ],
+                [
+                    '--allow-commit-splitting',
+                    'allow agentic mode to suggest splitting commits'
+                ],
+                [
+                    '--tool-timeout <timeout>',
+                    'timeout for tool execution in milliseconds'
                 ]
             ];
             const globalOptions = [
@@ -620,12 +656,12 @@ async function getCliConfig(program, commands) {
                 const maxWidth = Math.max(...options.map(([flag])=>flag.length));
                 return `${title}:\n` + options.map(([flag, desc])=>`  ${flag.padEnd(maxWidth + 2)} ${desc}`).join('\n') + '\n';
             };
-            return nameAndVersion + '\n' + formatOptionsSection('Commit Message Options', commitOptions) + '\n' + formatOptionsSection('Behavioral Options', behavioralOptions) + '\n' + formatOptionsSection('Global Options', globalOptions) + '\n' + 'Environment Variables:\n' + '  OPENAI_API_KEY          OpenAI API key (required)\n';
+            return nameAndVersion + '\n' + formatOptionsSection('Commit Message Options', commitOptions) + '\n' + formatOptionsSection('Behavioral Options', behavioralOptions) + '\n' + formatOptionsSection('Agentic Mode Options', agenticOptions) + '\n' + formatOptionsSection('Global Options', globalOptions) + '\n' + 'Environment Variables:\n' + '  OPENAI_API_KEY          OpenAI API key (required)\n';
         }
     });
     const audioCommitCommand = program.command('audio-commit').option('--cached', 'use cached diff').option('--add', 'add all changes before committing').option('--sendit', 'Commit with the message generated. No review.').option('--direction <direction>', 'direction or guidance for the commit message').option('--message-limit <messageLimit>', 'limit the number of messages to generate').option('--file <file>', 'audio file path').description('Record audio to provide context, then generate and optionally commit with AI-generated message');
     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');
+    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').option('--agentic', 'use agentic mode with tool-calling for release notes generation').option('--self-reflection', 'generate self-reflection report with tool effectiveness analysis').option('--max-agentic-iterations <maxAgenticIterations>', 'maximum iterations for agentic mode (default: 30)', parseInt).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('--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);