@eldrforge/kodrdriv 1.2.132 → 1.2.133

package/dist/constants.js

@@ -1,7 +1,7 @@
 import os__default from 'os';
 import path__default from 'path';
 
-const VERSION = '1.2.132 (HEAD/665eee8 T:v1.2.132 2025-12-27 16:03:32 -0800) linux x64 v22.21.1';
+const VERSION = '1.2.133 (HEAD/1c05f66 T:v1.2.133 2025-12-31 11:42:01 -0800) linux x64 v22.21.1';
 const PROGRAM_NAME = 'kodrdriv';
 const DEFAULT_OVERRIDES = false;
 const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS_MILLISECONDS = 'YYYY-MM-DD-HHmmss.SSS';
@@ -124,6 +124,7 @@ const KODRDRIV_DEFAULTS = {
         messageLimit: DEFAULT_MESSAGE_LIMIT,
         skipFileCheck: false,
         maxDiffBytes: DEFAULT_MAX_DIFF_BYTES,
+        contextFiles: undefined,
         openaiReasoning: DEFAULT_OPENAI_REASONING,
         openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS
     },
@@ -133,6 +134,7 @@ const KODRDRIV_DEFAULTS = {
         messageLimit: DEFAULT_MESSAGE_LIMIT,
         interactive: DEFAULT_INTERACTIVE_MODE,
         maxDiffBytes: DEFAULT_MAX_DIFF_BYTES,
+        contextFiles: undefined,
         noMilestones: false,
         openaiReasoning: DEFAULT_OPENAI_REASONING,
         openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["import { MergeMethod } from './types';\nimport os from 'os';\nimport path from 'path';\n\nexport const VERSION = '__VERSION__ (__GIT_BRANCH__/__GIT_COMMIT__ __GIT_TAGS__ __GIT_COMMIT_DATE__) __SYSTEM_INFO__';\nexport const PROGRAM_NAME = 'kodrdriv';\nexport const DEFAULT_CHARACTER_ENCODING = 'utf-8';\nexport const DEFAULT_BINARY_TO_TEXT_ENCODING = 'base64';\nexport const DEFAULT_DIFF = true;\nexport const DEFAULT_LOG = false;\nexport const DEFAULT_OVERRIDES = false;\nexport const DATE_FORMAT_MONTH_DAY = 'MM-DD';\nexport const DATE_FORMAT_YEAR = 'YYYY';\nexport const DATE_FORMAT_YEAR_MONTH = 'YYYY-MM';\nexport const DATE_FORMAT_YEAR_MONTH_DAY = 'YYYY-MM-DD';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_SLASH = 'YYYY/MM/DD';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES = 'YYYY-MM-DD-HHmm';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS = 'YYYY-MM-DD-HHmmss';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS_MILLISECONDS = 'YYYY-MM-DD-HHmmss.SSS';\nexport const DATE_FORMAT_SHORT_TIMESTAMP = 'YYMMdd-HHmm';\nexport const DATE_FORMAT_MONTH = 'MM';\nexport const DATE_FORMAT_DAY = 'DD';\nexport const DATE_FORMAT_HOURS = 'HHmm';\nexport const DATE_FORMAT_MINUTES = 'mm';\nexport const DATE_FORMAT_SECONDS = 'ss';\nexport const DATE_FORMAT_MILLISECONDS = 'SSS';\nexport const DEFAULT_VERBOSE = false;\nexport const DEFAULT_DRY_RUN = false;\nexport const DEFAULT_DEBUG = false;\nexport const DEFAULT_MODEL = 'gpt-4o-mini';\nexport const DEFAULT_MODEL_STRONG = 'gpt-4o';\nexport const DEFAULT_OPENAI_REASONING = 'low';\nexport const DEFAULT_OPENAI_MAX_OUTPUT_TOKENS = 10000;\nexport const DEFAULT_OUTPUT_DIRECTORY = 'output/kodrdriv';\n\n// Buffer size for git commands that may produce large output (like git log)\nexport const DEFAULT_GIT_COMMAND_MAX_BUFFER = 50 * 1024 * 1024; // 50MB\n\nexport const DEFAULT_CONTEXT_DIRECTORIES: string[] = [];\n\nexport const DEFAULT_CONFIG_DIR = '.kodrdriv';\nexport const DEFAULT_PREFERENCES_DIRECTORY = path.join(os.homedir(), '.kodrdriv');\n\nexport const DEFAULT_FROM_COMMIT_ALIAS = 'main';\nexport const DEFAULT_TO_COMMIT_ALIAS = 'HEAD';\n\nexport const DEFAULT_ADD = false;\nexport const DEFAULT_CACHED = false;\nexport const DEFAULT_SENDIT_MODE = false;\nexport const DEFAULT_INTERACTIVE_MODE = false;\nexport const DEFAULT_AMEND_MODE = false;\n// CRITICAL: Keep this low (3-5) to prevent log context contamination.\n// The LLM tends to pattern-match against recent commits instead of describing\n// the actual diff when it sees too much commit history. Set to 0 to disable.\nexport const DEFAULT_MESSAGE_LIMIT = 3;\nexport const DEFAULT_MAX_DIFF_BYTES = 20480; // 20KB limit per file\n\nexport const DEFAULT_MERGE_METHOD: MergeMethod = 'squash';\n\nexport const DEFAULT_EXCLUDED_PATTERNS = [\n    'node_modules', 'package-lock.json', 'yarn.lock', 'bun.lockb',\n    'composer.lock', 'Cargo.lock', 'Gemfile.lock',\n    'dist', 'build', 'out', '.next', '.nuxt', 'coverage',\n    '.vscode', '.idea', '.DS_Store', '.git', '.gitignore',\n    'logs', 'tmp', '.cache', '*.log', '.env', '.env.*',\n    '*.pem', '*.crt', '*.key', '*.sqlite', '*.db',\n    '*.zip', '*.tar', '*.gz', '*.exe', '*.bin'\n];\n\nexport const COMMAND_COMMIT = 'commit';\nexport const COMMAND_AUDIO_COMMIT = 'audio-commit';\nexport const COMMAND_SELECT_AUDIO = 'select-audio';\nexport const COMMAND_RELEASE = 'release';\nexport const COMMAND_REVIEW = 'review';\nexport const COMMAND_AUDIO_REVIEW = 'audio-review';\nexport const COMMAND_PUBLISH = 'publish';\nexport const COMMAND_TREE = 'tree';\nexport const COMMAND_LINK = 'link';\nexport const COMMAND_UNLINK = 'unlink';\nexport const COMMAND_CLEAN = 'clean';\nexport const COMMAND_PRECOMMIT = 'precommit';\nexport const COMMAND_DEVELOPMENT = 'development';\nexport const COMMAND_VERSIONS = 'versions';\nexport const COMMAND_UPDATES = 'updates';\nexport const COMMAND_CHECK_CONFIG = 'check-config';\nexport const COMMAND_INIT_CONFIG = 'init-config';\n\nexport const ALLOWED_COMMANDS = [\n    COMMAND_COMMIT,\n    COMMAND_AUDIO_COMMIT,\n    COMMAND_SELECT_AUDIO,\n    COMMAND_RELEASE,\n    COMMAND_REVIEW,\n    COMMAND_AUDIO_REVIEW,\n    COMMAND_PUBLISH,\n    COMMAND_TREE,\n    COMMAND_LINK,\n    COMMAND_UNLINK,\n    COMMAND_CLEAN,\n    COMMAND_PRECOMMIT,\n    COMMAND_DEVELOPMENT,\n    COMMAND_VERSIONS,\n    COMMAND_UPDATES\n];\n\nexport const DEFAULT_COMMAND = COMMAND_COMMIT;\n\nexport const DEFAULT_INSTRUCTIONS_DIR = `instructions`;\n\nexport const DEFAULT_PERSONA_DIR = `personas`;\n\nexport const DEFAULT_INSTRUCTIONS_COMMIT_FILE = `${DEFAULT_INSTRUCTIONS_DIR}/commit.md`;\nexport const DEFAULT_INSTRUCTIONS_RELEASE_FILE = `${DEFAULT_INSTRUCTIONS_DIR}/release.md`;\nexport const DEFAULT_INSTRUCTIONS_REVIEW_FILE = `${DEFAULT_INSTRUCTIONS_DIR}/review.md`;\n\nexport const DEFAULT_PERSONA_RELEASER_FILE = `${DEFAULT_PERSONA_DIR}/releaser.md`;\nexport const DEFAULT_PERSONA_YOU_FILE = `${DEFAULT_PERSONA_DIR}/you.md`;\n\n// Default instructions for each persona\nexport const DEFAULT_INSTRUCTIONS_MAP = {\n    [COMMAND_COMMIT]: DEFAULT_INSTRUCTIONS_COMMIT_FILE,\n    [COMMAND_AUDIO_COMMIT]: DEFAULT_INSTRUCTIONS_COMMIT_FILE, // Reuse commit instructions\n    [COMMAND_RELEASE]: DEFAULT_INSTRUCTIONS_RELEASE_FILE,\n    [COMMAND_REVIEW]: DEFAULT_INSTRUCTIONS_REVIEW_FILE, // Reuse audio-review instructions for now\n    [COMMAND_AUDIO_REVIEW]: DEFAULT_INSTRUCTIONS_REVIEW_FILE,\n};\n\n// Default personas for each command\nexport const DEFAULT_PERSONA_MAP = {\n    [COMMAND_COMMIT]: DEFAULT_PERSONA_YOU_FILE,\n    [COMMAND_AUDIO_COMMIT]: DEFAULT_PERSONA_YOU_FILE, // Use You persona\n    [COMMAND_RELEASE]: DEFAULT_PERSONA_RELEASER_FILE,\n    [COMMAND_REVIEW]: DEFAULT_PERSONA_YOU_FILE, // Use You persona\n    [COMMAND_AUDIO_REVIEW]: DEFAULT_PERSONA_YOU_FILE,\n};\n\n// Used by child process to create paths\nexport const DEFAULT_PATH_SEPARATOR = '/';\n\n// Used by util/general for file filtering\nexport const DEFAULT_IGNORE_PATTERNS = [\n    'node_modules/**',\n    '**/*.log',\n    '.git/**',\n    'dist/**',\n    'build/**',\n    'coverage/**',\n    'output/**',\n    '.DS_Store',\n    '*.tmp',\n    '*.cache',\n    '**/.kodrdriv-*.json', // Internal kodrdriv cache and state files\n];\n\n// Used by util/storage for directory names\nexport const DEFAULT_DIRECTORY_PREFIX = '.kodrdriv';\n\n// Used by other commands but not exposed in CLI\nexport const INTERNAL_DEFAULT_OUTPUT_FILE = 'output.txt';\n\nexport const INTERNAL_DATETIME_FORMAT = 'YYYY-MM-DD_HH-mm-ss';\n\n// Define defaults in one place\nexport const KODRDRIV_DEFAULTS = {\n    dryRun: DEFAULT_DRY_RUN,\n    verbose: DEFAULT_VERBOSE,\n    debug: DEFAULT_DEBUG,\n    overrides: DEFAULT_OVERRIDES,\n    model: DEFAULT_MODEL,\n    openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n    openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    contextDirectories: DEFAULT_CONTEXT_DIRECTORIES,\n    commandName: DEFAULT_COMMAND,\n    configDirectory: DEFAULT_CONFIG_DIR,\n    outputDirectory: DEFAULT_OUTPUT_DIRECTORY,\n    preferencesDirectory: DEFAULT_PREFERENCES_DIRECTORY,\n    commit: {\n        add: DEFAULT_ADD,\n        cached: DEFAULT_CACHED,\n        sendit: DEFAULT_SENDIT_MODE,\n        interactive: DEFAULT_INTERACTIVE_MODE,\n        amend: DEFAULT_AMEND_MODE,\n        messageLimit: DEFAULT_MESSAGE_LIMIT,\n        skipFileCheck: false,\n        maxDiffBytes: DEFAULT_MAX_DIFF_BYTES,\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    release: {\n        from: DEFAULT_FROM_COMMIT_ALIAS,\n        to: DEFAULT_TO_COMMIT_ALIAS,\n        messageLimit: DEFAULT_MESSAGE_LIMIT,\n        interactive: DEFAULT_INTERACTIVE_MODE,\n        maxDiffBytes: DEFAULT_MAX_DIFF_BYTES,\n        noMilestones: false,\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    audioCommit: {\n        maxRecordingTime: 300, // 5 minutes default\n        audioDevice: undefined, // Auto-detect by default\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    review: {\n        includeCommitHistory: true,\n        includeRecentDiffs: true,\n        includeReleaseNotes: false,\n        includeGithubIssues: true,\n        commitHistoryLimit: 10,\n        diffHistoryLimit: 5,\n        releaseNotesLimit: 3,\n        githubIssuesLimit: 20,\n        sendit: DEFAULT_SENDIT_MODE,\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    audioReview: {\n        includeCommitHistory: true,\n        includeRecentDiffs: true,\n        includeReleaseNotes: false,\n        includeGithubIssues: true,\n        commitHistoryLimit: 10,\n        diffHistoryLimit: 5,\n        releaseNotesLimit: 3,\n        githubIssuesLimit: 20,\n        sendit: DEFAULT_SENDIT_MODE,\n        maxRecordingTime: 300, // 5 minutes default\n        audioDevice: undefined, // Auto-detect by default\n        directory: undefined, // No default directory\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    publish: {\n        mergeMethod: DEFAULT_MERGE_METHOD,\n        from: DEFAULT_FROM_COMMIT_ALIAS,\n        targetVersion: 'patch',\n        interactive: DEFAULT_INTERACTIVE_MODE,\n        requiredEnvVars: ['GITHUB_TOKEN', 'OPENAI_API_KEY'],\n        linkWorkspacePackages: true,\n        unlinkWorkspacePackages: true,\n        sendit: DEFAULT_SENDIT_MODE,\n        targetBranch: 'main',\n        noMilestones: false,\n        checksTimeout: 3600000, // 1 hour default for PR checks\n        releaseWorkflowsTimeout: 1800000, // 30 minutes default for release workflows\n    },\n    link: {\n        scopeRoots: {},\n        dryRun: false,\n        packageArgument: undefined,\n        externals: [],\n    },\n    unlink: {\n        scopeRoots: {},\n        workspaceFile: undefined,\n        dryRun: false,\n        cleanNodeModules: false,\n        packageArgument: undefined,\n        externals: [],\n    },\n    tree: {\n        directories: undefined,\n        exclude: undefined,\n        startFrom: undefined,\n        stopAt: undefined,\n        cmd: undefined,\n\n        builtInCommand: undefined,\n        continue: false,\n        packageArgument: undefined,\n        cleanNodeModules: false,\n        externals: [],\n    },\n    development: {\n        targetVersion: 'patch',\n        noMilestones: false,\n    },\n    versions: {\n        subcommand: undefined,\n        directories: undefined,\n    },\n    updates: {\n        scope: undefined,\n        directories: undefined,\n    },\n    excludedPatterns: DEFAULT_EXCLUDED_PATTERNS,\n    branches: {\n        working: {\n            targetBranch: 'main',\n            developmentBranch: true,\n            version: {\n                type: 'prerelease' as const,\n                increment: true,\n                incrementLevel: 'patch' as const,\n                tag: 'dev'\n            }\n        },\n        main: {\n            version: {\n                type: 'release' as const\n            }\n        }\n    }\n};\n"],"names":["VERSION","PROGRAM_NAME","DEFAULT_OVERRIDES","DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS_MILLISECONDS","DEFAULT_VERBOSE","DEFAULT_DRY_RUN","DEFAULT_DEBUG","DEFAULT_MODEL","DEFAULT_OPENAI_REASONING","DEFAULT_OPENAI_MAX_OUTPUT_TOKENS","DEFAULT_OUTPUT_DIRECTORY","DEFAULT_GIT_COMMAND_MAX_BUFFER","DEFAULT_CONTEXT_DIRECTORIES","DEFAULT_CONFIG_DIR","DEFAULT_PREFERENCES_DIRECTORY","path","join","os","homedir","DEFAULT_FROM_COMMIT_ALIAS","DEFAULT_TO_COMMIT_ALIAS","DEFAULT_ADD","DEFAULT_CACHED","DEFAULT_SENDIT_MODE","DEFAULT_INTERACTIVE_MODE","DEFAULT_AMEND_MODE","DEFAULT_MESSAGE_LIMIT","DEFAULT_MAX_DIFF_BYTES","DEFAULT_MERGE_METHOD","DEFAULT_EXCLUDED_PATTERNS","COMMAND_COMMIT","COMMAND_AUDIO_COMMIT","COMMAND_SELECT_AUDIO","COMMAND_RELEASE","COMMAND_REVIEW","COMMAND_AUDIO_REVIEW","COMMAND_PUBLISH","COMMAND_TREE","COMMAND_LINK","COMMAND_UNLINK","COMMAND_CLEAN","COMMAND_PRECOMMIT","COMMAND_DEVELOPMENT","COMMAND_VERSIONS","COMMAND_UPDATES","COMMAND_CHECK_CONFIG","COMMAND_INIT_CONFIG","ALLOWED_COMMANDS","DEFAULT_COMMAND","KODRDRIV_DEFAULTS","dryRun","verbose","debug","overrides","model","openaiReasoning","openaiMaxOutputTokens","contextDirectories","commandName","configDirectory","outputDirectory","preferencesDirectory","commit","add","cached","sendit","interactive","amend","messageLimit","skipFileCheck","maxDiffBytes","release","from","to","noMilestones","audioCommit","maxRecordingTime","audioDevice","undefined","review","includeCommitHistory","includeRecentDiffs","includeReleaseNotes","includeGithubIssues","commitHistoryLimit","diffHistoryLimit","releaseNotesLimit","githubIssuesLimit","audioReview","directory","publish","mergeMethod","targetVersion","requiredEnvVars","linkWorkspacePackages","unlinkWorkspacePackages","targetBranch","checksTimeout","releaseWorkflowsTimeout","link","scopeRoots","packageArgument","externals","unlink","workspaceFile","cleanNodeModules","tree","directories","exclude","startFrom","stopAt","cmd","builtInCommand","continue","development","versions","subcommand","updates","scope","excludedPatterns","branches","working","developmentBranch","version","type","increment","incrementLevel","tag","main"],"mappings":"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"}
+{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["import { MergeMethod } from './types';\nimport os from 'os';\nimport path from 'path';\n\nexport const VERSION = '__VERSION__ (__GIT_BRANCH__/__GIT_COMMIT__ __GIT_TAGS__ __GIT_COMMIT_DATE__) __SYSTEM_INFO__';\nexport const PROGRAM_NAME = 'kodrdriv';\nexport const DEFAULT_CHARACTER_ENCODING = 'utf-8';\nexport const DEFAULT_BINARY_TO_TEXT_ENCODING = 'base64';\nexport const DEFAULT_DIFF = true;\nexport const DEFAULT_LOG = false;\nexport const DEFAULT_OVERRIDES = false;\nexport const DATE_FORMAT_MONTH_DAY = 'MM-DD';\nexport const DATE_FORMAT_YEAR = 'YYYY';\nexport const DATE_FORMAT_YEAR_MONTH = 'YYYY-MM';\nexport const DATE_FORMAT_YEAR_MONTH_DAY = 'YYYY-MM-DD';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_SLASH = 'YYYY/MM/DD';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES = 'YYYY-MM-DD-HHmm';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS = 'YYYY-MM-DD-HHmmss';\nexport const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS_MILLISECONDS = 'YYYY-MM-DD-HHmmss.SSS';\nexport const DATE_FORMAT_SHORT_TIMESTAMP = 'YYMMdd-HHmm';\nexport const DATE_FORMAT_MONTH = 'MM';\nexport const DATE_FORMAT_DAY = 'DD';\nexport const DATE_FORMAT_HOURS = 'HHmm';\nexport const DATE_FORMAT_MINUTES = 'mm';\nexport const DATE_FORMAT_SECONDS = 'ss';\nexport const DATE_FORMAT_MILLISECONDS = 'SSS';\nexport const DEFAULT_VERBOSE = false;\nexport const DEFAULT_DRY_RUN = false;\nexport const DEFAULT_DEBUG = false;\nexport const DEFAULT_MODEL = 'gpt-4o-mini';\nexport const DEFAULT_MODEL_STRONG = 'gpt-4o';\nexport const DEFAULT_OPENAI_REASONING = 'low';\nexport const DEFAULT_OPENAI_MAX_OUTPUT_TOKENS = 10000;\nexport const DEFAULT_OUTPUT_DIRECTORY = 'output/kodrdriv';\n\n// Buffer size for git commands that may produce large output (like git log)\nexport const DEFAULT_GIT_COMMAND_MAX_BUFFER = 50 * 1024 * 1024; // 50MB\n\nexport const DEFAULT_CONTEXT_DIRECTORIES: string[] = [];\n\nexport const DEFAULT_CONFIG_DIR = '.kodrdriv';\nexport const DEFAULT_PREFERENCES_DIRECTORY = path.join(os.homedir(), '.kodrdriv');\n\nexport const DEFAULT_FROM_COMMIT_ALIAS = 'main';\nexport const DEFAULT_TO_COMMIT_ALIAS = 'HEAD';\n\nexport const DEFAULT_ADD = false;\nexport const DEFAULT_CACHED = false;\nexport const DEFAULT_SENDIT_MODE = false;\nexport const DEFAULT_INTERACTIVE_MODE = false;\nexport const DEFAULT_AMEND_MODE = false;\n// CRITICAL: Keep this low (3-5) to prevent log context contamination.\n// The LLM tends to pattern-match against recent commits instead of describing\n// the actual diff when it sees too much commit history. Set to 0 to disable.\nexport const DEFAULT_MESSAGE_LIMIT = 3;\nexport const DEFAULT_MAX_DIFF_BYTES = 20480; // 20KB limit per file\n\nexport const DEFAULT_MERGE_METHOD: MergeMethod = 'squash';\n\nexport const DEFAULT_EXCLUDED_PATTERNS = [\n    'node_modules', 'package-lock.json', 'yarn.lock', 'bun.lockb',\n    'composer.lock', 'Cargo.lock', 'Gemfile.lock',\n    'dist', 'build', 'out', '.next', '.nuxt', 'coverage',\n    '.vscode', '.idea', '.DS_Store', '.git', '.gitignore',\n    'logs', 'tmp', '.cache', '*.log', '.env', '.env.*',\n    '*.pem', '*.crt', '*.key', '*.sqlite', '*.db',\n    '*.zip', '*.tar', '*.gz', '*.exe', '*.bin'\n];\n\nexport const COMMAND_COMMIT = 'commit';\nexport const COMMAND_AUDIO_COMMIT = 'audio-commit';\nexport const COMMAND_SELECT_AUDIO = 'select-audio';\nexport const COMMAND_RELEASE = 'release';\nexport const COMMAND_REVIEW = 'review';\nexport const COMMAND_AUDIO_REVIEW = 'audio-review';\nexport const COMMAND_PUBLISH = 'publish';\nexport const COMMAND_TREE = 'tree';\nexport const COMMAND_LINK = 'link';\nexport const COMMAND_UNLINK = 'unlink';\nexport const COMMAND_CLEAN = 'clean';\nexport const COMMAND_PRECOMMIT = 'precommit';\nexport const COMMAND_DEVELOPMENT = 'development';\nexport const COMMAND_VERSIONS = 'versions';\nexport const COMMAND_UPDATES = 'updates';\nexport const COMMAND_CHECK_CONFIG = 'check-config';\nexport const COMMAND_INIT_CONFIG = 'init-config';\n\nexport const ALLOWED_COMMANDS = [\n    COMMAND_COMMIT,\n    COMMAND_AUDIO_COMMIT,\n    COMMAND_SELECT_AUDIO,\n    COMMAND_RELEASE,\n    COMMAND_REVIEW,\n    COMMAND_AUDIO_REVIEW,\n    COMMAND_PUBLISH,\n    COMMAND_TREE,\n    COMMAND_LINK,\n    COMMAND_UNLINK,\n    COMMAND_CLEAN,\n    COMMAND_PRECOMMIT,\n    COMMAND_DEVELOPMENT,\n    COMMAND_VERSIONS,\n    COMMAND_UPDATES\n];\n\nexport const DEFAULT_COMMAND = COMMAND_COMMIT;\n\nexport const DEFAULT_INSTRUCTIONS_DIR = `instructions`;\n\nexport const DEFAULT_PERSONA_DIR = `personas`;\n\nexport const DEFAULT_INSTRUCTIONS_COMMIT_FILE = `${DEFAULT_INSTRUCTIONS_DIR}/commit.md`;\nexport const DEFAULT_INSTRUCTIONS_RELEASE_FILE = `${DEFAULT_INSTRUCTIONS_DIR}/release.md`;\nexport const DEFAULT_INSTRUCTIONS_REVIEW_FILE = `${DEFAULT_INSTRUCTIONS_DIR}/review.md`;\n\nexport const DEFAULT_PERSONA_RELEASER_FILE = `${DEFAULT_PERSONA_DIR}/releaser.md`;\nexport const DEFAULT_PERSONA_YOU_FILE = `${DEFAULT_PERSONA_DIR}/you.md`;\n\n// Default instructions for each persona\nexport const DEFAULT_INSTRUCTIONS_MAP = {\n    [COMMAND_COMMIT]: DEFAULT_INSTRUCTIONS_COMMIT_FILE,\n    [COMMAND_AUDIO_COMMIT]: DEFAULT_INSTRUCTIONS_COMMIT_FILE, // Reuse commit instructions\n    [COMMAND_RELEASE]: DEFAULT_INSTRUCTIONS_RELEASE_FILE,\n    [COMMAND_REVIEW]: DEFAULT_INSTRUCTIONS_REVIEW_FILE, // Reuse audio-review instructions for now\n    [COMMAND_AUDIO_REVIEW]: DEFAULT_INSTRUCTIONS_REVIEW_FILE,\n};\n\n// Default personas for each command\nexport const DEFAULT_PERSONA_MAP = {\n    [COMMAND_COMMIT]: DEFAULT_PERSONA_YOU_FILE,\n    [COMMAND_AUDIO_COMMIT]: DEFAULT_PERSONA_YOU_FILE, // Use You persona\n    [COMMAND_RELEASE]: DEFAULT_PERSONA_RELEASER_FILE,\n    [COMMAND_REVIEW]: DEFAULT_PERSONA_YOU_FILE, // Use You persona\n    [COMMAND_AUDIO_REVIEW]: DEFAULT_PERSONA_YOU_FILE,\n};\n\n// Used by child process to create paths\nexport const DEFAULT_PATH_SEPARATOR = '/';\n\n// Used by util/general for file filtering\nexport const DEFAULT_IGNORE_PATTERNS = [\n    'node_modules/**',\n    '**/*.log',\n    '.git/**',\n    'dist/**',\n    'build/**',\n    'coverage/**',\n    'output/**',\n    '.DS_Store',\n    '*.tmp',\n    '*.cache',\n    '**/.kodrdriv-*.json', // Internal kodrdriv cache and state files\n];\n\n// Used by util/storage for directory names\nexport const DEFAULT_DIRECTORY_PREFIX = '.kodrdriv';\n\n// Used by other commands but not exposed in CLI\nexport const INTERNAL_DEFAULT_OUTPUT_FILE = 'output.txt';\n\nexport const INTERNAL_DATETIME_FORMAT = 'YYYY-MM-DD_HH-mm-ss';\n\n// Define defaults in one place\nexport const KODRDRIV_DEFAULTS = {\n    dryRun: DEFAULT_DRY_RUN,\n    verbose: DEFAULT_VERBOSE,\n    debug: DEFAULT_DEBUG,\n    overrides: DEFAULT_OVERRIDES,\n    model: DEFAULT_MODEL,\n    openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n    openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    contextDirectories: DEFAULT_CONTEXT_DIRECTORIES,\n    commandName: DEFAULT_COMMAND,\n    configDirectory: DEFAULT_CONFIG_DIR,\n    outputDirectory: DEFAULT_OUTPUT_DIRECTORY,\n    preferencesDirectory: DEFAULT_PREFERENCES_DIRECTORY,\n    commit: {\n        add: DEFAULT_ADD,\n        cached: DEFAULT_CACHED,\n        sendit: DEFAULT_SENDIT_MODE,\n        interactive: DEFAULT_INTERACTIVE_MODE,\n        amend: DEFAULT_AMEND_MODE,\n        messageLimit: DEFAULT_MESSAGE_LIMIT,\n        skipFileCheck: false,\n        maxDiffBytes: DEFAULT_MAX_DIFF_BYTES,\n        contextFiles: undefined,\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    release: {\n        from: DEFAULT_FROM_COMMIT_ALIAS,\n        to: DEFAULT_TO_COMMIT_ALIAS,\n        messageLimit: DEFAULT_MESSAGE_LIMIT,\n        interactive: DEFAULT_INTERACTIVE_MODE,\n        maxDiffBytes: DEFAULT_MAX_DIFF_BYTES,\n        contextFiles: undefined,\n        noMilestones: false,\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    audioCommit: {\n        maxRecordingTime: 300, // 5 minutes default\n        audioDevice: undefined, // Auto-detect by default\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    review: {\n        includeCommitHistory: true,\n        includeRecentDiffs: true,\n        includeReleaseNotes: false,\n        includeGithubIssues: true,\n        commitHistoryLimit: 10,\n        diffHistoryLimit: 5,\n        releaseNotesLimit: 3,\n        githubIssuesLimit: 20,\n        sendit: DEFAULT_SENDIT_MODE,\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    audioReview: {\n        includeCommitHistory: true,\n        includeRecentDiffs: true,\n        includeReleaseNotes: false,\n        includeGithubIssues: true,\n        commitHistoryLimit: 10,\n        diffHistoryLimit: 5,\n        releaseNotesLimit: 3,\n        githubIssuesLimit: 20,\n        sendit: DEFAULT_SENDIT_MODE,\n        maxRecordingTime: 300, // 5 minutes default\n        audioDevice: undefined, // Auto-detect by default\n        directory: undefined, // No default directory\n        openaiReasoning: DEFAULT_OPENAI_REASONING as 'low' | 'medium' | 'high',\n        openaiMaxOutputTokens: DEFAULT_OPENAI_MAX_OUTPUT_TOKENS,\n    },\n    publish: {\n        mergeMethod: DEFAULT_MERGE_METHOD,\n        from: DEFAULT_FROM_COMMIT_ALIAS,\n        targetVersion: 'patch',\n        interactive: DEFAULT_INTERACTIVE_MODE,\n        requiredEnvVars: ['GITHUB_TOKEN', 'OPENAI_API_KEY'],\n        linkWorkspacePackages: true,\n        unlinkWorkspacePackages: true,\n        sendit: DEFAULT_SENDIT_MODE,\n        targetBranch: 'main',\n        noMilestones: false,\n        checksTimeout: 3600000, // 1 hour default for PR checks\n        releaseWorkflowsTimeout: 1800000, // 30 minutes default for release workflows\n    },\n    link: {\n        scopeRoots: {},\n        dryRun: false,\n        packageArgument: undefined,\n        externals: [],\n    },\n    unlink: {\n        scopeRoots: {},\n        workspaceFile: undefined,\n        dryRun: false,\n        cleanNodeModules: false,\n        packageArgument: undefined,\n        externals: [],\n    },\n    tree: {\n        directories: undefined,\n        exclude: undefined,\n        startFrom: undefined,\n        stopAt: undefined,\n        cmd: undefined,\n\n        builtInCommand: undefined,\n        continue: false,\n        packageArgument: undefined,\n        cleanNodeModules: false,\n        externals: [],\n    },\n    development: {\n        targetVersion: 'patch',\n        noMilestones: false,\n    },\n    versions: {\n        subcommand: undefined,\n        directories: undefined,\n    },\n    updates: {\n        scope: undefined,\n        directories: undefined,\n    },\n    excludedPatterns: DEFAULT_EXCLUDED_PATTERNS,\n    branches: {\n        working: {\n            targetBranch: 'main',\n            developmentBranch: true,\n            version: {\n                type: 'prerelease' as const,\n                increment: true,\n                incrementLevel: 'patch' as const,\n                tag: 'dev'\n            }\n        },\n        main: {\n            version: {\n                type: 'release' as const\n            }\n        }\n    }\n};\n"],"names":["VERSION","PROGRAM_NAME","DEFAULT_OVERRIDES","DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS_MILLISECONDS","DEFAULT_VERBOSE","DEFAULT_DRY_RUN","DEFAULT_DEBUG","DEFAULT_MODEL","DEFAULT_OPENAI_REASONING","DEFAULT_OPENAI_MAX_OUTPUT_TOKENS","DEFAULT_OUTPUT_DIRECTORY","DEFAULT_GIT_COMMAND_MAX_BUFFER","DEFAULT_CONTEXT_DIRECTORIES","DEFAULT_CONFIG_DIR","DEFAULT_PREFERENCES_DIRECTORY","path","join","os","homedir","DEFAULT_FROM_COMMIT_ALIAS","DEFAULT_TO_COMMIT_ALIAS","DEFAULT_ADD","DEFAULT_CACHED","DEFAULT_SENDIT_MODE","DEFAULT_INTERACTIVE_MODE","DEFAULT_AMEND_MODE","DEFAULT_MESSAGE_LIMIT","DEFAULT_MAX_DIFF_BYTES","DEFAULT_MERGE_METHOD","DEFAULT_EXCLUDED_PATTERNS","COMMAND_COMMIT","COMMAND_AUDIO_COMMIT","COMMAND_SELECT_AUDIO","COMMAND_RELEASE","COMMAND_REVIEW","COMMAND_AUDIO_REVIEW","COMMAND_PUBLISH","COMMAND_TREE","COMMAND_LINK","COMMAND_UNLINK","COMMAND_CLEAN","COMMAND_PRECOMMIT","COMMAND_DEVELOPMENT","COMMAND_VERSIONS","COMMAND_UPDATES","COMMAND_CHECK_CONFIG","COMMAND_INIT_CONFIG","ALLOWED_COMMANDS","DEFAULT_COMMAND","KODRDRIV_DEFAULTS","dryRun","verbose","debug","overrides","model","openaiReasoning","openaiMaxOutputTokens","contextDirectories","commandName","configDirectory","outputDirectory","preferencesDirectory","commit","add","cached","sendit","interactive","amend","messageLimit","skipFileCheck","maxDiffBytes","contextFiles","undefined","release","from","to","noMilestones","audioCommit","maxRecordingTime","audioDevice","review","includeCommitHistory","includeRecentDiffs","includeReleaseNotes","includeGithubIssues","commitHistoryLimit","diffHistoryLimit","releaseNotesLimit","githubIssuesLimit","audioReview","directory","publish","mergeMethod","targetVersion","requiredEnvVars","linkWorkspacePackages","unlinkWorkspacePackages","targetBranch","checksTimeout","releaseWorkflowsTimeout","link","scopeRoots","packageArgument","externals","unlink","workspaceFile","cleanNodeModules","tree","directories","exclude","startFrom","stopAt","cmd","builtInCommand","continue","development","versions","subcommand","updates","scope","excludedPatterns","branches","working","developmentBranch","version","type","increment","incrementLevel","tag","main"],"mappings":"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"}

package/dist/util/storageAdapter.js

@@ -1,12 +1,19 @@
 import { createStorage } from '@eldrforge/shared';
+import path__default from 'path';
 
 /**
  * Create a StorageAdapter implementation using kodrdriv Storage
- */ function createStorageAdapter() {
+ *
+ * @param outputDirectory - Directory where output files should be written (default: 'output')
+ */ function createStorageAdapter(outputDirectory = 'output') {
     const storage = createStorage();
     return {
         async writeOutput (fileName, content) {
-            await storage.writeFile(fileName, content, 'utf8');
+            // Ensure output directory exists
+            await storage.ensureDirectory(outputDirectory);
+            // Write file to output directory
+            const filePath = path__default.join(outputDirectory, fileName);
+            await storage.writeFile(filePath, content, 'utf8');
         },
         async readTemp (fileName) {
             return await storage.readFile(fileName, 'utf8');

package/dist/util/storageAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"storageAdapter.js","sources":["../../src/util/storageAdapter.ts"],"sourcesContent":["/**\n * Adapter for ai-service StorageAdapter using kodrdriv Storage\n */\n\nimport type { StorageAdapter } from '@eldrforge/ai-service';\nimport { createStorage } from '@eldrforge/shared';\n\n/**\n * Create a StorageAdapter implementation using kodrdriv Storage\n */\nexport function createStorageAdapter(): StorageAdapter {\n    const storage = createStorage();\n\n    return {\n        async writeOutput(fileName: string, content: string): Promise<void> {\n            await storage.writeFile(fileName, content, 'utf8');\n        },\n\n        async readTemp(fileName: string): Promise<string> {\n            return await storage.readFile(fileName, 'utf8');\n        },\n\n        async writeTemp(fileName: string, content: string): Promise<void> {\n            await storage.writeFile(fileName, content, 'utf8');\n        },\n\n        async readFile(fileName: string, encoding: string = 'utf8'): Promise<string> {\n            return await storage.readFile(fileName, encoding);\n        },\n    };\n}\n\n"],"names":["createStorageAdapter","storage","createStorage","writeOutput","fileName","content","writeFile","readTemp","readFile","writeTemp","encoding"],"mappings":";;AAOA;;AAEC,IACM,SAASA,oBAAAA,GAAAA;AACZ,IAAA,MAAMC,OAAAA,GAAUC,aAAAA,EAAAA;IAEhB,OAAO;QACH,MAAMC,WAAAA,CAAAA,CAAYC,QAAgB,EAAEC,OAAe,EAAA;AAC/C,YAAA,MAAMJ,OAAAA,CAAQK,SAAS,CAACF,QAAAA,EAAUC,OAAAA,EAAS,MAAA,CAAA;AAC/C,QAAA,CAAA;AAEA,QAAA,MAAME,UAASH,QAAgB,EAAA;AAC3B,YAAA,OAAO,MAAMH,OAAAA,CAAQO,QAAQ,CAACJ,QAAAA,EAAU,MAAA,CAAA;AAC5C,QAAA,CAAA;QAEA,MAAMK,SAAAA,CAAAA,CAAUL,QAAgB,EAAEC,OAAe,EAAA;AAC7C,YAAA,MAAMJ,OAAAA,CAAQK,SAAS,CAACF,QAAAA,EAAUC,OAAAA,EAAS,MAAA,CAAA;AAC/C,QAAA,CAAA;AAEA,QAAA,MAAMG,QAAAA,CAAAA,CAASJ,QAAgB,EAAEM,QAAAA,GAAmB,MAAM,EAAA;AACtD,YAAA,OAAO,MAAMT,OAAAA,CAAQO,QAAQ,CAACJ,QAAAA,EAAUM,QAAAA,CAAAA;AAC5C,QAAA;AACJ,KAAA;AACJ;;;;"}
+{"version":3,"file":"storageAdapter.js","sources":["../../src/util/storageAdapter.ts"],"sourcesContent":["/**\n * Adapter for ai-service StorageAdapter using kodrdriv Storage\n */\n\nimport type { StorageAdapter } from '@eldrforge/ai-service';\nimport { createStorage } from '@eldrforge/shared';\nimport path from 'path';\n\n/**\n * Create a StorageAdapter implementation using kodrdriv Storage\n *\n * @param outputDirectory - Directory where output files should be written (default: 'output')\n */\nexport function createStorageAdapter(outputDirectory: string = 'output'): StorageAdapter {\n    const storage = createStorage();\n\n    return {\n        async writeOutput(fileName: string, content: string): Promise<void> {\n            // Ensure output directory exists\n            await storage.ensureDirectory(outputDirectory);\n\n            // Write file to output directory\n            const filePath = path.join(outputDirectory, fileName);\n            await storage.writeFile(filePath, content, 'utf8');\n        },\n\n        async readTemp(fileName: string): Promise<string> {\n            return await storage.readFile(fileName, 'utf8');\n        },\n\n        async writeTemp(fileName: string, content: string): Promise<void> {\n            await storage.writeFile(fileName, content, 'utf8');\n        },\n\n        async readFile(fileName: string, encoding: string = 'utf8'): Promise<string> {\n            return await storage.readFile(fileName, encoding);\n        },\n    };\n}\n\n"],"names":["createStorageAdapter","outputDirectory","storage","createStorage","writeOutput","fileName","content","ensureDirectory","filePath","path","join","writeFile","readTemp","readFile","writeTemp","encoding"],"mappings":";;;AAQA;;;;AAIC,IACM,SAASA,oBAAAA,CAAqBC,eAAAA,GAA0B,QAAQ,EAAA;AACnE,IAAA,MAAMC,OAAAA,GAAUC,aAAAA,EAAAA;IAEhB,OAAO;QACH,MAAMC,WAAAA,CAAAA,CAAYC,QAAgB,EAAEC,OAAe,EAAA;;YAE/C,MAAMJ,OAAAA,CAAQK,eAAe,CAACN,eAAAA,CAAAA;;AAG9B,YAAA,MAAMO,QAAAA,GAAWC,aAAAA,CAAKC,IAAI,CAACT,eAAAA,EAAiBI,QAAAA,CAAAA;AAC5C,YAAA,MAAMH,OAAAA,CAAQS,SAAS,CAACH,QAAAA,EAAUF,OAAAA,EAAS,MAAA,CAAA;AAC/C,QAAA,CAAA;AAEA,QAAA,MAAMM,UAASP,QAAgB,EAAA;AAC3B,YAAA,OAAO,MAAMH,OAAAA,CAAQW,QAAQ,CAACR,QAAAA,EAAU,MAAA,CAAA;AAC5C,QAAA,CAAA;QAEA,MAAMS,SAAAA,CAAAA,CAAUT,QAAgB,EAAEC,OAAe,EAAA;AAC7C,YAAA,MAAMJ,OAAAA,CAAQS,SAAS,CAACN,QAAAA,EAAUC,OAAAA,EAAS,MAAA,CAAA;AAC/C,QAAA,CAAA;AAEA,QAAA,MAAMO,QAAAA,CAAAA,CAASR,QAAgB,EAAEU,QAAAA,GAAmB,MAAM,EAAA;AACtD,YAAA,OAAO,MAAMb,OAAAA,CAAQW,QAAQ,CAACR,QAAAA,EAAUU,QAAAA,CAAAA;AAC5C,QAAA;AACJ,KAAA;AACJ;;;;"}

package/guide/ai-system.md

@@ -0,0 +1,519 @@
+# AI System Guide
+
+Understanding how kodrdriv's AI analysis works.
+
+## Overview
+
+Kodrdriv uses an **agentic AI system** - the AI doesn't just generate text, it actively investigates your code changes using specialized tools before writing commit messages or release notes.
+
+**Key Concept**: Instead of blindly describing diffs, the AI asks questions like "what files depend on this?" and "what tests cover this?" to understand your changes deeply.
+
+## Always-On Agentic Mode
+
+As of recent updates, **agentic mode is always enabled**. The AI always uses tools to investigate changes.
+
+### What This Means
+
+**Old way** (single-shot):
+```
+Diff → AI → Commit Message
+```
+
+**New way** (agentic):
+```
+Diff → AI analyzes → Uses tools → Gathers context → AI writes message
+```
+
+The AI can:
+- Read file contents
+- Check file history
+- Find dependencies
+- Search codebase
+- Review tests
+- Check recent commits
+
+## AI Tools
+
+### Commit Message Tools (8 tools)
+
+| Tool | Purpose | Example Use Case |
+|------|---------|------------------|
+| `get_file_history` | View file's commit history | Understand evolution of changed file |
+| `get_file_content` | Read complete file | See context around diff |
+| `get_related_tests` | Find test files | Understand behavior changes |
+| `analyze_diff_section` | Expand context around lines | Clarify cryptic changes |
+| `get_recent_commits` | Check recent commits | Avoid duplicate messages |
+| `search_codebase` | Find patterns/usage | Assess impact of changes |
+| `get_file_dependencies` | Find what depends on file | Understand impact scope |
+| `group_files_by_concern` | Organize files logically | Suggest commit splits |
+
+### Release Notes Tools (13 tools)
+
+**All commit tools** plus:
+
+| Tool | Purpose | Example Use Case |
+|------|---------|------------------|
+| `get_tag_history` | View past tags | Understand release patterns |
+| `get_release_stats` | Quantify changes | Get metrics on scope |
+| `analyze_commit_patterns` | Detect themes | Identify focus areas |
+| `compare_previous_release` | Compare releases | Contextualize changes |
+| `get_breaking_changes` | Identify breaking changes | Alert users to issues |
+
+## How the AI Decides
+
+### Investigation Strategy
+
+The AI decides which tools to use based on:
+
+1. **Change Complexity**
+   - 1-3 files → Use 1-2 tools (simple)
+   - 4-10 files → Use 2-4 tools (moderate)
+   - 10+ files → Use 4-6 tools (complex)
+
+2. **Change Type**
+   - New feature → Check tests, dependencies
+   - Bug fix → Review file history, related changes
+   - Refactor → Check dependencies, search usage
+   - Documentation → Group by concern
+
+3. **Clarity**
+   - Clear diff → Fewer tools needed
+   - Cryptic diff → Read full files, expand context
+   - Multiple concerns → Group files, suggest splits
+
+### Example: AI Investigating a Change
+
+```
+User: Generate commit message for auth.ts changes
+
+AI: Let me investigate...
+ 1. get_file_content(auth.ts) → See full context
+ 2. get_related_tests(auth.ts) → Find auth.test.ts
+ 3. get_file_dependencies(auth.ts) → Used by user.ts, api.ts
+ 4. get_recent_commits(auth.ts) → Last changed 2 days ago
+    "refactor: simplify auth flow"
+
+AI: Based on investigation, this adds JWT support to
+    existing auth system, affecting user and API modules.
+    Tests updated to cover new token validation.
+
+Output: "feat(auth): add JWT token support
+
+         Adds JWT-based authentication alongside existing session auth.
+         Updates user and API modules to handle tokens.
+         Includes tests for token validation and refresh."
+```
+
+## Prompt Engineering
+
+### Commit Message Prompts
+
+**System Prompt** (abbreviated):
+```
+You are a professional software engineer writing commit messages for your team.
+
+Write naturally and directly:
+- Use plain language, not corporate speak
+- Be specific and concrete
+- Avoid buzzwords and jargon
+- No emojis or excessive punctuation
+- No phrases like "this commit"
+```
+
+**User Prompt**:
+```
+I have staged changes that need a commit message.
+
+Changed files (3):
+  - src/auth.ts
+  - src/user.ts
+  - tests/auth.test.ts
+
+Diff: [full diff]
+
+Analyze these changes and write a clear commit message.
+```
+
+### Release Notes Prompts
+
+**System Prompt** (abbreviated):
+```
+You are a professional software engineer writing release notes for your team and users.
+
+Focus on:
+- What problems does this release solve?
+- What new capabilities does it add?
+- What's the impact on users?
+- Are there breaking changes?
+
+Write naturally and directly:
+- Use plain language
+- Be specific about what changed and why
+- No marketing speak
+- No emojis
+- Focus on facts, not enthusiasm
+```
+
+**User Prompt**:
+```
+I need release notes for changes from v1.0.0 to v1.1.0.
+
+Commit Log: [commits]
+Diff Summary: [diffs]
+Milestone Issues: [resolved issues]
+
+Consider:
+- What's the main story?
+- What problems does it solve?
+- Are there breaking changes?
+```
+
+## Quality Standards
+
+### Anti-Slop Guidelines
+
+The AI is explicitly instructed to avoid:
+- ✗ Emojis (🎉, ✨, 🚀)
+- ✗ Marketing language ("excited to announce")
+- ✗ Meta-commentary ("this commit", "this PR")
+- ✗ Buzzwords ("leverage", "synergy")
+- ✗ Excessive punctuation (!!!, ???)
+- ✗ Conversational closings ("Let me know")
+
+### What Good Output Looks Like
+
+**Commit Message**:
+```
+feat(auth): add JWT token support
+
+Adds JWT-based authentication alongside existing session auth. Token
+validation happens in middleware, with automatic refresh handling.
+
+Updates user and API modules to accept both auth methods. Backward
+compatible - existing session auth continues to work.
+
+Includes tests for token validation, refresh, and mixed auth scenarios.
+```
+
+**Release Notes**:
+```
+## Authentication Improvements
+
+Added JWT token support alongside existing session-based authentication.
+Tokens are validated in middleware with automatic refresh handling.
+
+Both authentication methods work simultaneously, allowing gradual migration.
+Session-based auth continues to work without changes.
+
+## Breaking Changes
+
+None. This release is fully backward compatible.
+
+## Testing
+
+Added comprehensive tests for token validation, refresh logic, and
+compatibility with existing session auth.
+```
+
+## Iteration Control
+
+### What Are Iterations?
+
+Each iteration is one loop of AI → Tool Calls → Response.
+
+**Example**:
+```
+Iteration 1: AI requests get_file_content(auth.ts)
+Iteration 2: AI requests get_related_tests(auth.ts)
+Iteration 3: AI writes commit message
+```
+
+### Controlling Iterations
+
+```bash
+# More iterations = more investigation
+kodrdriv commit --max-agentic-iterations 15
+
+# Fewer for speed
+kodrdriv commit --max-agentic-iterations 5
+
+# Default is 10 for commits, 30 for releases
+```
+
+**When to adjust**:
+- Simple changes → Use 5-8 iterations
+- Complex changes → Use 12-20 iterations
+- Large releases → Use 40-50 iterations
+
+### Monitoring Iterations
+
+Enable self-reflection to see iteration details:
+
+```bash
+kodrdriv commit --self-reflection
+cat output/agentic-reflection-commit-*.md
+```
+
+Report shows:
+- Number of iterations used
+- Tools called per iteration
+- Time spent per tool
+- Success/failure rates
+
+## Token Budgets
+
+### Understanding Token Limits
+
+Each AI request has a token budget:
+- **Commit messages**: ~150K tokens max
+- **Release notes**: ~200K tokens max
+
+Includes:
+- Your code diffs
+- Git history
+- Tool outputs
+- AI responses
+
+### When Budgets Are Exceeded
+
+Kodrdriv automatically:
+1. Compresses oldest messages
+2. Removes low-priority context
+3. Truncates large diffs
+4. Retries with smaller input
+
+You can:
+```bash
+# Reduce diff size
+kodrdriv commit --max-diff-bytes 5120
+
+# Limit commit history
+kodrdriv commit --message-limit 5
+
+# Reduce iterations
+kodrdriv commit --max-agentic-iterations 8
+```
+
+## Reasoning Levels
+
+OpenAI reasoning models support different effort levels:
+
+```yaml
+# Fast, less thorough
+openaiReasoning: low
+
+# Balanced (default)
+openaiReasoning: medium
+
+# Thorough, slower
+openaiReasoning: high
+```
+
+**When to use**:
+- `low`: Simple changes, quick commits
+- `medium`: Standard development (default)
+- `high`: Complex releases, critical changes
+
+## Context Sources
+
+### Automatic Context
+
+Always included:
+- Git diff of changes
+- Recent commit history
+- File structure
+- Repository metadata
+
+### Optional Context
+
+Enable with options:
+- `--context "text"` - Free-form context
+- `--context-files FILES` - Documentation files
+- `-d, --context-directories DIRS` - Code directories
+- GitHub issues (automatic for commits)
+- Milestone issues (automatic for releases)
+
+### Example: Rich Context
+
+```bash
+kodrdriv release \
+  --context "This release focuses on performance" \
+  --context-files OPTIMIZATION-NOTES.md BENCHMARKS.md \
+  -d src/performance -d src/cache \
+  --self-reflection
+```
+
+AI receives:
+- Git diff
+- Git history
+- Your context text
+- Contents of OPTIMIZATION-NOTES.md
+- Contents of BENCHMARKS.md
+- Directory trees for src/performance and src/cache
+- Milestone issues
+- Analysis from previous tools
+
+## Observability
+
+### Self-Reflection Reports
+
+Enable with `--self-reflection`:
+
+```markdown
+# Agentic Workflow - Self-Reflection Report
+
+## Execution Summary
+- Iterations: 12
+- Tool Calls: 18
+- Unique Tools: 6
+
+## Tool Effectiveness
+| Tool | Calls | Success | Duration |
+|------|-------|---------|----------|
+| get_file_content | 5 | 100% | 450ms |
+| get_recent_commits | 3 | 100% | 230ms |
+| get_related_tests | 2 | 100% | 180ms |
+
+## Conversation History
+[Full AI interaction log]
+
+## Generated Output
+[Final commit message]
+```
+
+### Debug Files
+
+Enable with `--debug`:
+
+**output/request-*.json**:
+```json
+{
+  "model": "gpt-4o",
+  "messages": [...],
+  "tools": [...]
+}
+```
+
+**output/response-*.json**:
+```json
+{
+  "choices": [...],
+  "usage": {
+    "prompt_tokens": 12450,
+    "completion_tokens": 235
+  }
+}
+```
+
+## Best Practices
+
+### For Commit Messages
+
+1. **Enable self-reflection** to improve quality
+2. **Use context files** for complex features
+3. **Allow commit splitting** for mixed changes
+4. **Review interactive** for important commits
+5. **Check recent commits** to avoid duplicates
+
+### For Release Notes
+
+1. **Always use context files** for comprehensive notes
+2. **Set release focus** to guide framing
+3. **Enable self-reflection** to see analysis depth
+4. **Use interactive mode** to refine
+5. **Check breaking changes** are highlighted
+
+### For Team Use
+
+1. **Document guidelines** in `.kodrdriv/personas/`
+2. **Set consistent models** in config
+3. **Enable verbose** mode for transparency
+4. **Use dry-run** mode for training
+5. **Review self-reflection** reports regularly
+
+## Troubleshooting AI Issues
+
+### AI Output is Too Verbose
+
+```yaml
+commit:
+  maxAgenticIterations: 6  # Reduce investigation depth
+```
+
+### AI Output is Too Shallow
+
+```yaml
+commit:
+  maxAgenticIterations: 15          # More investigation
+  contextFiles: ["docs/IMPL.md"]    # More context
+```
+
+### AI Misunderstands Changes
+
+```bash
+# Pass explicit context
+kodrdriv commit --context "This refactors auth for testability"
+
+# Or context files
+kodrdriv commit --context-files ARCHITECTURE.md
+```
+
+### AI Uses Wrong Tone
+
+Customize persona in `.kodrdriv/personas/committer.md`:
+```markdown
+You write terse, technical commit messages.
+Focus on changed behavior, not implementation details.
+```
+
+### Tool Calls Fail
+
+Check self-reflection report:
+```bash
+kodrdriv commit --self-reflection --verbose
+cat output/agentic-reflection-commit-*.md
+# Look for tool failures
+```
+
+## Advanced: Understanding Tool Selection
+
+The AI chooses tools based on what would help write better output:
+
+**Scenario**: Large refactoring (15 files changed)
+
+```
+AI thinking: "Many files changed. Let me group them first."
+→ group_files_by_concern(all files)
+   Returns: "Auth module (5 files), Database (3 files), Tests (7 files)"
+
+AI: "This might be separate concerns. Let me check dependencies."
+→ get_file_dependencies(auth files)
+   Returns: "Used by api.ts, user.ts"
+
+AI: "Significant changes. Let me check tests."
+→ get_related_tests(auth files)
+   Returns: "auth.test.ts, integration.test.ts"
+
+AI: "I understand. This is a unified refactor with tests."
+→ Writes single commit message covering all changes
+```
+
+## Next Steps
+
+- **[Debugging Guide](./debugging.md)** - Troubleshoot AI issues
+- **[Configuration Guide](./configuration.md)** - Fine-tune AI behavior
+- **[Development Guide](./development.md)** - Extend the AI system
+- **[Commands Reference](./commands.md)** - All available commands
+
+## Quick Reference
+
+| Setting | Purpose | Values |
+|---------|---------|--------|
+| `model` | AI model to use | gpt-4o, gpt-4o-mini |
+| `openaiReasoning` | Reasoning depth | low, medium, high |
+| `maxAgenticIterations` | Analysis depth | 5-50 (default: 10/30) |
+| `selfReflection` | Generate reports | true/false |
+| `contextFiles` | Additional context | File paths |
+
+The AI system is designed to be transparent, controllable, and effective. Use self-reflection reports to understand and improve its decision-making over time.
+