@eldrforge/kodrdriv 1.2.132 → 1.2.133

package/README.md

@@ -2,6 +2,12 @@
 
 KodrDriv is an AI-powered Git workflow automation tool that generates intelligent commit messages and release notes from your code changes. It analyzes your repository to create meaningful documentation while automating the entire release process.
 
+## 🤖 For AI Assistants
+
+**Complete AI Guide**: [`AI-GUIDE.md`](AI-GUIDE.md) - Comprehensive documentation for AI assistants helping with kodrdriv
+
+**Quick Start**: [`guide/index.md`](guide/index.md) - Navigation hub for all guides
+
 ## Why KodrDriv?
 
 Writing good commit messages and release notes is time-consuming and often done when you're least in the mood for reflection. **KodrDriv was created specifically to solve the "context switch" problem** that happens when you've been deep in code and Git asks you to summarize what you've done.
@@ -22,16 +28,19 @@ npm install -g @eldrforge/kodrdriv
 git add .
 kodrdriv commit
 
-# Or use agentic mode for deep analysis
-kodrdriv commit --agentic --self-reflection
+# With detailed analysis report
+kodrdriv commit --self-reflection
+
+# With context files
+kodrdriv commit --context-files IMPLEMENTATION.md --sendit
 ```
 
 ### Generate Release Notes
 ```bash
 kodrdriv release
 
-# Or use agentic mode for comprehensive analysis
-kodrdriv release --agentic --self-reflection
+# With context and analysis
+kodrdriv release --context-files CHANGELOG.md --self-reflection
 ```
 
 ### Automate Your Release Process
@@ -47,12 +56,14 @@ 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
+- **AI-Powered Analysis** - Uses OpenAI models with tool-calling for deep investigation
+  - Always-on agentic mode for intelligent 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
+- **Context Files (NEW)** - Pass documentation files as context for better AI understanding
+- **Human-Readable Output** - Professional tone without AI slop, emojis, or marketing speak
 - **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
@@ -79,6 +90,24 @@ kodrdriv --check-config
 
 📚 **Comprehensive Documentation**
 
+### 🤖 AI-Friendly Guides
+
+**NEW**: Complete guide system designed for AI assistants and developers:
+- **[AI Guide (Master)](AI-GUIDE.md)** - Complete reference for AI assistants
+- **[Guide Directory](guide/)** - 13 focused guides covering everything
+  - [Quick Start](guide/quickstart.md) - 5-minute setup
+  - [Integration](guide/integration.md) - Add to your project
+  - [Usage](guide/usage.md) - Common workflows
+  - [Commands](guide/commands.md) - Quick reference
+  - [Configuration](guide/configuration.md) - All options
+  - [AI System](guide/ai-system.md) - How AI works
+  - [Debugging](guide/debugging.md) - Troubleshooting
+  - [Architecture](guide/architecture.md) - System design
+  - [Development](guide/development.md) - Extend kodrdriv
+  - [Testing](guide/testing.md) - Test suite
+  - [Tree Operations](guide/tree-operations.md) - Multi-package
+  - [Monorepo](guide/monorepo.md) - Monorepo workflows
+
 ### Commands
 - **[All Commands Overview](docs/public/commands.md)** - Complete command reference with examples
 - **[commit](docs/public/commands/commit.md)** - Generate intelligent commit messages

package/dist/arguments.js

@@ -38,6 +38,7 @@ z.object({
     excludedPaths: z.array(z.string()).optional(),
     exclude: z.array(z.string()).optional(),
     context: z.string().optional(),
+    contextFiles: z.array(z.string()).optional(),
     note: z.string().optional(),
     direction: z.string().optional(),
     messageLimit: z.number().optional(),
@@ -82,7 +83,6 @@ z.object({
     workingTagPrefix: z.string().optional(),
     updateDeps: z.string().optional(),
     interProject: z.boolean().optional(),
-    agentic: z.boolean().optional(),
     selfReflection: z.boolean().optional(),
     maxAgenticIterations: z.number().optional()
 });
@@ -128,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 || finalCliArgs.agentic !== undefined || finalCliArgs.selfReflection !== undefined || finalCliArgs.maxAgenticIterations !== undefined) {
+        if (finalCliArgs.from !== undefined || finalCliArgs.to !== undefined || finalCliArgs.maxDiffBytes !== undefined || finalCliArgs.interactive !== undefined || finalCliArgs.noMilestones !== undefined || finalCliArgs.openaiReasoning !== undefined || finalCliArgs.openaiMaxOutputTokens !== 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;
@@ -139,13 +139,12 @@ 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
-    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 || finalCliArgs.agentic !== undefined || finalCliArgs.selfReflection !== undefined || finalCliArgs.maxAgenticIterations !== 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 || finalCliArgs.selfReflection !== undefined || finalCliArgs.maxAgenticIterations !== 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.skipAlreadyPublished !== undefined || finalCliArgs.forceRepublish !== undefined) && finalCliArgs.from !== undefined) transformedCliArgs.publish.from = finalCliArgs.from;
@@ -157,12 +156,9 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
         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;
         // Map release-related flags from publish command into release config (only if any are set)
-        if (commandName === 'publish' && (finalCliArgs.agentic !== undefined || finalCliArgs.selfReflection !== undefined || finalCliArgs.maxAgenticIterations !== undefined)) {
+        if (commandName === 'publish' && (finalCliArgs.selfReflection !== undefined || finalCliArgs.maxAgenticIterations !== undefined)) {
             transformedCliArgs.release = {
                 ...transformedCliArgs.release || {},
-                ...finalCliArgs.agentic !== undefined ? {
-                    agentic: finalCliArgs.agentic
-                } : {},
                 ...finalCliArgs.selfReflection !== undefined ? {
                     selfReflection: finalCliArgs.selfReflection
                 } : {},
@@ -273,6 +269,32 @@ const transformCliArgs = (finalCliArgs, commandName)=>{
     if (commandName === 'tree') {
         const builtInCommand = finalCliArgs.builtInCommand;
         const packageArgument = finalCliArgs.packageArgument;
+        // Map command-specific options to nested configs for tree operations
+        // When tree commit/release/publish is run, these options get forwarded
+        if (builtInCommand === 'commit' && finalCliArgs.contextFiles !== undefined) {
+            if (!transformedCliArgs.commit) transformedCliArgs.commit = {};
+            transformedCliArgs.commit.contextFiles = finalCliArgs.contextFiles;
+        }
+        if (builtInCommand === 'commit' && finalCliArgs.selfReflection !== undefined) {
+            if (!transformedCliArgs.commit) transformedCliArgs.commit = {};
+            transformedCliArgs.commit.selfReflection = finalCliArgs.selfReflection;
+        }
+        if (builtInCommand === 'commit' && finalCliArgs.maxAgenticIterations !== undefined) {
+            if (!transformedCliArgs.commit) transformedCliArgs.commit = {};
+            transformedCliArgs.commit.maxAgenticIterations = finalCliArgs.maxAgenticIterations;
+        }
+        if ((builtInCommand === 'release' || builtInCommand === 'publish') && finalCliArgs.contextFiles !== undefined) {
+            if (!transformedCliArgs.release) transformedCliArgs.release = {};
+            transformedCliArgs.release.contextFiles = finalCliArgs.contextFiles;
+        }
+        if ((builtInCommand === 'release' || builtInCommand === 'publish') && finalCliArgs.selfReflection !== undefined) {
+            if (!transformedCliArgs.release) transformedCliArgs.release = {};
+            transformedCliArgs.release.selfReflection = finalCliArgs.selfReflection;
+        }
+        if ((builtInCommand === 'release' || builtInCommand === 'publish') && finalCliArgs.maxAgenticIterations !== undefined) {
+            if (!transformedCliArgs.release) transformedCliArgs.release = {};
+            transformedCliArgs.release.maxAgenticIterations = finalCliArgs.maxAgenticIterations;
+        }
         // Only create tree object if there are actual tree-specific options
         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) {
@@ -548,7 +570,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)').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);
+    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('--context-files [contextFiles...]', 'files containing additional 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('--self-reflection', 'generate self-reflection report with tool effectiveness analysis').option('--max-agentic-iterations <iterations>', 'maximum iterations for analysis (default: 10)', parseInt).option('--allow-commit-splitting', 'allow AI 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
@@ -559,6 +581,10 @@ async function getCliConfig(program, commands) {
                 [
                     '--context <context>',
                     'context for the commit message'
+                ],
+                [
+                    '--context-files [contextFiles...]',
+                    'files containing additional context'
                 ]
             ];
             const behavioralOptions = [
@@ -599,22 +625,18 @@ async function getCliConfig(program, commands) {
                     'maximum bytes per file in diff (default: 20480)'
                 ]
             ];
-            const agenticOptions = [
-                [
-                    '--agentic',
-                    'use agentic mode with tool-calling for commit generation'
-                ],
+            const aiOptions = [
                 [
                     '--self-reflection',
                     'generate self-reflection report with tool effectiveness analysis'
                 ],
                 [
                     '--max-agentic-iterations <iterations>',
-                    'maximum iterations for agentic mode (default: 10)'
+                    'maximum iterations for AI analysis (default: 10)'
                 ],
                 [
                     '--allow-commit-splitting',
-                    'allow agentic mode to suggest splitting commits'
+                    'allow AI to suggest splitting commits'
                 ],
                 [
                     '--tool-timeout <timeout>',
@@ -671,20 +693,21 @@ 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('Agentic Mode Options', agenticOptions) + '\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('AI Options', aiOptions) + '\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').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');
+    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('--context-files [contextFiles...]', 'files containing additional context for release notes').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('--self-reflection', 'generate self-reflection report with tool effectiveness analysis').option('--max-agentic-iterations <maxAgenticIterations>', 'maximum iterations for analysis (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)').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).option('--agentic-publish', 'use AI agent to automatically diagnose and fix publish issues').option('--agentic-publish-max-iterations <agenticPublishMaxIterations>', 'maximum iterations for agentic publish (default: 10)', parseInt).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('--context-files [contextFiles...]', 'files containing additional context for release notes').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)').option('--self-reflection', 'generate self-reflection report with tool effectiveness analysis').option('--max-agentic-iterations <maxAgenticIterations>', 'maximum iterations for analysis (default: 30)', parseInt).option('--agentic-publish', 'use AI agent to automatically diagnose and fix publish issues').option('--agentic-publish-max-iterations <agenticPublishMaxIterations>', 'maximum iterations for agentic publish (default: 10)', parseInt).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")')// 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.
+    .option('--clean-node-modules', 'for unlink command: remove node_modules and package-lock.json, then reinstall dependencies')// Command-specific options (forwarded to commit/release/publish)
+    .option('--context-files [contextFiles...]', 'files containing additional context (forwarded to commit/release/publish)').option('--self-reflection', 'generate self-reflection report (forwarded to commit/release/publish)').option('--max-agentic-iterations <iterations>', 'maximum iterations for AI analysis (forwarded to commit/release/publish)', parseInt).description(`Analyze package dependencies in workspace and execute commands in dependency order.
 
 Built-in commands:
   commit      - Run 'kodrdriv commit' in each package
@@ -697,8 +720,18 @@ Built-in commands:
   run         - Execute custom shell command (use --cmd)
   checkout    - Checkout specified branch in all packages
 
+Command-specific options:
+  You can pass any commit, release, or publish options and they will be forwarded.
+  Examples: --context-files, --sendit, --interactive, --self-reflection
+
+  For commit options: kodrdriv commit --help
+  For release options: kodrdriv release --help
+  For publish options: kodrdriv publish --help
+
 Examples:
-  kodrdriv tree publish --parallel --model "gpt-5-mini"
+  kodrdriv tree commit --context-files IMPL.md --sendit
+  kodrdriv tree publish --parallel --context-files RELEASE.md
+  kodrdriv tree publish --parallel --model "gpt-4o" --self-reflection
   kodrdriv tree --cmd "npm test"
   kodrdriv tree publish --continue --retry-failed
   kodrdriv tree publish --audit-branches