@eldrforge/kodrdriv 0.0.3 → 0.0.6

package/.kodrdriv/config.yaml

@@ -1,12 +1,20 @@
 verbose: false
-model: gpt-4o
+model: gpt-4.1
 contextDirectories:
-  - .kodrdriv/context/people
-  - .kodrdriv/context/projects
+  - .kodrdriv/context
 commit:
+  add: true
   cached: true
   sendit: true
-  messageLimit: 10
 release:
   from: main
-  to: HEAD
+  to: HEAD
+publish:
+  mergeMethod: squash
+  dependencyUpdatePatterns: ["@theunwalked/*", "@riotprompt/*"]
+  requiredEnvVars: ["NODE_AUTH_TOKEN"]
+link:
+  scopeRoots:
+    "@theunwalked": "../../SemicolonAmbulance"
+    "@riotprompt": "../../StJustReckoning"
+  workspaceFile: "pnpm-workspace.yaml"

package/.kodrdriv/context/content.md

@@ -0,0 +1 @@
+KodrDriv is a tool that is designed to help automate the creation of commit messages and release notes.  It is also a tool that has been designed to support an opinionated approach to organizing related projects and conducting structured releases with Git.   This initial version focuses on pnpm and GitHub, but there are plans to expand coverage over time.

package/README.md

@@ -14,7 +14,7 @@ This will make the `kodrdriv` command available globally on your system.
 
 ## Commands
 
-KodrDriv provides two main commands:
+KodrDriv provides four main commands:
 
 ### Commit Command
 
@@ -53,6 +53,115 @@ kodrdriv release
 > 
 > You can use the `--from` and `--to` options to generate release notes comparing two different releases. For example, to see what changed between v1.0.0 and v1.1.0, you could use `kodrdriv release --from v1.0.0 --to v1.1.0`. This is particularly useful for creating detailed changelogs when preparing release documentation.
 
+### Publish Command
+
+Automate the entire release process, from dependency updates to GitHub release creation:
+
+```bash
+kodrdriv publish
+```
+
+The `publish` command orchestrates a comprehensive release workflow, designed to ensure a safe and consistent release process. Here's what it does:
+
+1.  **Dependency Management**: If a `pnpm-workspace.yaml` file is present, it's temporarily renamed to switch from workspace dependencies to registry versions. It then runs `pnpm update --latest` to ensure dependencies are up to date. You can configure specific dependency patterns to update instead of updating all dependencies using the `dependencyUpdatePatterns` configuration option.
+
+2.  **Pre-flight Checks**: Before committing any changes, it runs the `prepublishOnly` script from your `package.json`. This script should contain your project's pre-flight checks (e.g., `clean`, `lint`, `build`, `test`) to ensure the project is in a good state. **Note**: A `prepublishOnly` script is required in your `package.json` - the publish command will fail if this script is not present.
+
+3.  **Release Commit**: If there are changes to `package.json` or `pnpm-lock.yaml`, it creates an intelligent commit message for the dependency updates.
+
+4.  **Version Bump**: It automatically bumps the patch version of your project.
+
+5.  **Release Notes**: It generates release notes based on the recent changes and saves them to `RELEASE_NOTES.md`.
+
+6.  **Pull Request Automation**:
+    *   It pushes the changes and tags to the origin.
+    *   It creates a new pull request for the release.
+    *   It waits for all status checks on the pull request to pass.
+    *   Once checks are complete, it automatically merges the pull request using the configured merge method (default: squash).
+
+7.  **GitHub Release**: After the PR is merged, it checks out the `main` branch, pulls the latest changes, and creates a new GitHub release with the tag and release notes.
+
+8.  **New Release Branch**: Finally, it creates and pushes a new release branch for the next version (e.g., `release/0.0.5`).
+
+This command is designed for repositories that follow a pull-request-based release workflow with required status checks. It streamlines the process, reducing manual steps and potential for error.
+
+> [!TIP]
+> ### Choosing the Right Merge Method
+> 
+> The merge method you choose affects your Git history and can impact your team's workflow:
+> 
+> - **Squash** (default): Best for keeping a clean, linear history. All commits from the feature branch are combined into a single commit, making it easier to understand what was changed in each release.
+> 
+> - **Merge**: Preserves the complete commit history from the feature branch. Use this when you want to maintain detailed development history and individual commit information.
+> 
+> - **Rebase**: Creates a linear history without merge commits. The commits from the feature branch are replayed on top of the target branch. This keeps history clean while preserving individual commits.
+> 
+> Consider your team's preferences and any branch protection rules when choosing a merge method.
+
+### Link Command
+
+Manage pnpm workspace links for local development with sibling projects:
+
+```bash
+kodrdriv link
+```
+
+The `link` command automates the creation and management of pnpm workspace configurations for local development. It scans your project's dependencies and automatically discovers matching sibling packages in configured scope directories, then updates your `pnpm-workspace.yaml` file to link them for local development.
+
+This is particularly useful when working with monorepos or related packages where you want to use local versions of dependencies instead of published registry versions during development.
+
+**How it works:**
+
+1. **Dependency Analysis**: Reads your `package.json` and examines all dependencies (including devDependencies and peerDependencies)
+
+2. **Scope-based Scanning**: For each configured scope (e.g., `@company`, `@myorg`), it scans the specified root directory to find all available packages by reading their `package.json` files
+
+3. **Smart Matching**: Instead of relying on directory naming conventions, it matches dependencies by their actual package names from `package.json`, handling cases where directory names don't match package names
+
+4. **Workspace Management**: Updates or creates a `pnpm-workspace.yaml` file with the discovered local packages, preserving any existing workspace configuration
+
+**Example Scenario:**
+
+Suppose you're working on `@company/api` and it depends on `@company/logging`. Your directory structure might look like:
+
+```
+workspace/
+├── company-api/          # Contains @company/api
+├── company-logging-lib/  # Contains @company/logging (note: different directory name)
+└── other-project/
+```
+
+The link command would:
+- Scan `../` for packages with scope `@company`
+- Find `@company/logging` in `../company-logging-lib/` 
+- Update `pnpm-workspace.yaml` to include `../company-logging-lib`
+
+**Configuration Requirements:**
+
+The link command requires scope root mappings to be configured. You can provide these via:
+
+1. **Command line**: `--scope-roots '{"@company": "../", "@myorg": "../../"}'`
+2. **Configuration file**: Set `link.scopeRoots` in your `.kodrdriv/config.json`
+
+**Dry Run Support:**
+
+Use `--dry-run` to preview what packages would be linked without making changes:
+
+```bash
+kodrdriv link --scope-roots '{"@company": "../"}' --dry-run
+```
+
+> [!TIP]
+> ### Best Practices for Link Command
+> 
+> - **Use relative paths**: Configure scope roots with relative paths (like `../` or `../../`) to ensure the workspace file works across different environments
+> 
+> - **Scope organization**: Group related packages under the same scope (e.g., `@company/api`, `@company/logging`) for easier management
+> 
+> - **Version with caution**: Consider whether to commit the generated `pnpm-workspace.yaml` file. You might want to add it to `.gitignore` if it's only for local development
+> 
+> - **Multiple scopes**: You can configure multiple scope roots to handle packages from different organizations or teams in the same workspace
+
 ## Command Line Options
 
 KodrDriv provides several command line options to customize its behavior:
@@ -71,6 +180,180 @@ KodrDriv provides several command line options to customize its behavior:
 - `--context <context>`: Provide additional context (as a string or file path) to guide the commit message generation. This context is included in the prompt sent to the AI and can be used to specify the purpose, theme, or any special considerations for the commit.
 - `--message-limit <messageLimit>`: Limit the number of recent commit messages (from git log) to include in the prompt for context (default: 10). This can help focus the AI on the most relevant recent changes.
 
+### Publish Command Options
+
+- `--merge-method <method>`: Method to merge pull requests during the publish process (default: 'squash')
+  - Available methods: 'merge', 'squash', 'rebase'
+  - `merge`: Creates a merge commit that combines the feature branch into the target branch
+  - `squash`: Combines all commits from the feature branch into a single commit on the target branch
+  - `rebase`: Replays commits from the feature branch onto the target branch without creating a merge commit
+
+#### Dependency Update Configuration
+
+The publish command supports selective dependency updates through the `dependencyUpdatePatterns` configuration option. This allows you to specify which dependencies should be updated during the release process instead of updating all dependencies.
+
+**Configuration:**
+```json
+{
+  "publish": {
+    "dependencyUpdatePatterns": ["@company/*", "@myorg/*", "specific-package"]
+  }
+}
+```
+
+**Behavior:**
+- When patterns are specified, only dependencies matching those patterns will be updated
+- Patterns can include npm scopes (e.g., `@company/*`) or specific package names
+- If no patterns are configured, all dependencies are updated (default behavior)
+- This is particularly useful when developing a set of related packages where you want to ensure you're using the latest versions of your organization's packages while keeping other dependencies stable
+
+#### Environment Variable Configuration
+
+The publish command includes comprehensive environment variable validation to ensure all required credentials and tokens are available before starting the release process. This prevents failures partway through the publication workflow.
+
+**Core Required Environment Variables:**
+
+The following environment variables are required by default for all publish operations:
+
+- `GITHUB_TOKEN`: Required for GitHub API operations (creating pull requests, releases, etc.)
+- `OPENAI_API_KEY`: Required for AI-powered commit message and release note generation
+
+**Configurable Additional Environment Variables:**
+
+You can specify additional required environment variables specific to your project or organization:
+
+**Configuration (config.yaml):**
+```yaml
+publish:
+  requiredEnvVars:
+    - NODE_AUTH_TOKEN        # Often needed for publishing to npm
+    - DEPLOY_KEY            # Custom deployment credentials
+    - CUSTOM_API_TOKEN      # Organization-specific tokens
+    - CODECOV_TOKEN         # Code coverage reporting
+```
+
+**Configuration (config.json):**
+```json
+{
+  "publish": {
+    "requiredEnvVars": [
+      "NODE_AUTH_TOKEN",
+      "DEPLOY_KEY", 
+      "CUSTOM_API_TOKEN",
+      "CODECOV_TOKEN"
+    ]
+  }
+}
+```
+
+**Automatic .npmrc Scanning:**
+
+The publish command automatically scans your `.npmrc` file for environment variable references and includes them in the validation. It detects common patterns like:
+
+- `${NODE_AUTH_TOKEN}` - Curly brace syntax
+- `$NODE_AUTH_TOKEN` - Direct variable reference
+
+Example `.npmrc` file:
+```
+@myorg:registry=https://npm.pkg.github.com/
+//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+```
+
+In this case, `NODE_AUTH_TOKEN` would be automatically detected and validated.
+
+**Validation Behavior:**
+- All environment variable checks happen during the initial prechecks phase
+- If any required environment variables are missing, the publish command fails immediately with a clear error message
+- The error message lists all missing variables at once, making it easy to set them all before retrying
+- Variables from configuration, .npmrc scanning, and core requirements are combined and deduplicated
+
+**Example Error:**
+```
+Missing required environment variables: NODE_AUTH_TOKEN, DEPLOY_KEY. 
+Please set these environment variables before running publish.
+```
+
+**Security Best Practices:**
+- Store sensitive environment variables in your CI/CD system's secure variable storage
+- Use tools like 1Password CLI, HashiCorp Vault, or similar for local development
+- Never commit environment variables or tokens to your repository
+- Consider using `.env` files (with proper .gitignore configuration) for local development
+
+#### prepublishOnly Script Requirement
+
+The publish command requires a `prepublishOnly` script to be defined in your `package.json`. This script should contain all the checks and builds necessary to verify your project is ready for release.
+
+**Example package.json:**
+```json
+{
+  "scripts": {
+    "prepublishOnly": "pnpm run clean && pnpm run lint && pnpm run build && pnpm run test",
+    "clean": "rimraf dist",
+    "lint": "eslint src/",
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}
+```
+
+**Why prepublishOnly?**
+- The `prepublishOnly` script is an npm/pnpm standard that runs automatically before publishing packages
+- It ensures consistent pre-flight checks regardless of how the package is published
+- It allows projects to define their own specific validation pipeline
+- The publish command validates this script exists during the initial prechecks phase
+
+**Common prepublishOnly Patterns:**
+- `"prepublishOnly": "npm run test"` - Run tests only
+- `"prepublishOnly": "npm run build && npm run test"` - Build and test
+- `"prepublishOnly": "npm run lint && npm run build && npm run test"` - Full validation pipeline
+- `"prepublishOnly": "npm run ci"` - Delegate to a CI script that includes all checks
+
+If this script is missing, the publish command will fail immediately with a helpful error message explaining the requirement.
+
+### Link Command Options
+
+- `--scope-roots <scopeRoots>`: JSON mapping of scopes to root directories for package discovery
+  - **Format**: `'{"@scope": "path", "@another": "path"}'`
+  - **Example**: `'{"@company": "../", "@myorg": "../../packages/"}'`
+  - **Required**: At least one scope mapping must be provided
+- `--workspace-file <workspaceFile>`: Path to the workspace file to create/update (default: 'pnpm-workspace.yaml')
+  - Can specify custom workspace file names or paths
+  - Useful if your project uses non-standard workspace file naming
+
+#### Scope Root Configuration
+
+The `--scope-roots` option accepts a JSON object mapping package scopes to their corresponding root directories. Each entry tells the link command where to look for packages with that scope.
+
+**Configuration Examples:**
+
+```bash
+# Single scope
+kodrdriv link --scope-roots '{"@company": "../"}'
+
+# Multiple scopes with different paths
+kodrdriv link --scope-roots '{"@company": "../", "@tools": "../../tools/", "@shared": "../shared-packages/"}'
+
+# Absolute paths (not recommended for portability)
+kodrdriv link --scope-roots '{"@company": "/Users/dev/projects/company-packages/"}'
+```
+
+**Path Resolution:**
+- Relative paths are resolved from the current working directory
+- Use `../` to scan the parent directory
+- Use `../../` to scan two levels up
+- Multiple levels and subdirectories are supported: `../../company/packages/`
+
+**Package Discovery Process:**
+1. For each scope root, the command lists all subdirectories
+2. It reads each subdirectory's `package.json` to get the actual package name
+3. It matches discovered package names against your project's dependencies
+4. Matching packages are added to the workspace configuration
+
+This approach handles complex scenarios where:
+- Directory names don't match package names (e.g., `logging-lib` directory contains `@company/logging`)
+- Packages are organized in different directory structures
+- Multiple related packages exist in the same scope root
+
 ### OpenAI Configuration
 
 - `--openai-api-key <key>`: OpenAI API key (can also be set via OPENAI_API_KEY environment variable)
@@ -131,6 +414,36 @@ kodrdriv commit --context "Refactoring for performance" --message-limit 5
 kodrdriv release --context "Quarterly release, focus on stability" --message-limit 20
 ```
 
+Publish with different merge methods:
+```bash
+# Use default squash merge
+kodrdriv publish
+
+# Use merge commit (preserves individual commits)
+kodrdriv publish --merge-method merge
+
+# Use rebase (clean linear history)
+kodrdriv publish --merge-method rebase
+```
+
+Link local packages for development:
+```bash
+# Basic linking with single scope
+kodrdriv link --scope-roots '{"@company": "../"}'
+
+# Multiple scopes with different root directories
+kodrdriv link --scope-roots '{"@company": "../", "@tools": "../../tools/"}'
+
+# Dry run to preview changes
+kodrdriv link --scope-roots '{"@company": "../"}' --dry-run --verbose
+
+# Custom workspace file
+kodrdriv link --scope-roots '{"@company": "../"}' --workspace-file "workspace.yaml"
+
+# Real-world example: linking @company packages from company directory
+kodrdriv link --scope-roots '{"@company": "../../company/"}'
+```
+
 ### Configuration Directory
 
 KodrDriv uses a configuration directory to store custom settings, instructions, and other configuration files. You can specify a custom location using the `--config-dir` option:
@@ -152,9 +465,56 @@ The configuration directory structure is as follows:
 │   ├── release.md        # Override for release instructions
 │   ├── release-pre.md    # Content prepended to default release instructions
 │   └── release-post.md   # Content appended to default release instructions
+├── config.json           # Main configuration file
 └── ...                   # Other configuration files
 ```
 
+### Configuration File
+
+You can create a `config.json` file in your `.kodrdriv` directory to set default options for all commands. This allows you to avoid repeating command-line options and ensures consistent behavior across your project.
+
+Example configuration file (`.kodrdriv/config.json`):
+
+```json
+{
+  "model": "gpt-4o-mini",
+  "verbose": true,
+  "contextDirectories": ["src", "docs"],
+  "publish": {
+    "mergeMethod": "merge",
+    "dependencyUpdatePatterns": ["@company/*", "@myorg/*"],
+    "requiredEnvVars": ["NODE_AUTH_TOKEN", "CUSTOM_TOKEN"]
+  },
+  "commit": {
+    "add": true,
+    "messageLimit": 5
+  },
+  "release": {
+    "from": "main",
+    "to": "HEAD",
+    "messageLimit": 10
+  },
+  "link": {
+    "scopeRoots": {
+      "@company": "../",
+      "@myorg": "../../org-packages/",
+      "@tools": "../shared-tools/"
+    },
+    "workspaceFile": "pnpm-workspace.yaml"
+  },
+  "excludedPatterns": [
+    "node_modules",
+    "dist",
+    "*.log"
+  ]
+}
+```
+
+Configuration options set in the file can be overridden by command-line arguments. The precedence order is:
+1. Command-line arguments (highest priority)
+2. Configuration file
+3. Default values (lowest priority)
+
 ## Default Instructions
 
 KodrDriv comes with default instructions that guide the AI in generating release notes or change logs. These instructions are defined in the source code:

package/dist/arguments.js

@@ -16,12 +16,20 @@ z.object({
     instructions: z.string().optional(),
     configDir: z.string().optional(),
     cached: z.boolean().optional(),
+    add: z.boolean().optional(),
     sendit: z.boolean().optional(),
     from: z.string().optional(),
     to: z.string().optional(),
     excludedPatterns: z.array(z.string()).optional(),
     context: z.string().optional(),
-    messageLimit: z.number().optional()
+    messageLimit: z.number().optional(),
+    mergeMethod: z.enum([
+        'merge',
+        'squash',
+        'rebase'
+    ]).optional(),
+    scopeRoots: z.string().optional(),
+    workspaceFile: z.string().optional()
 });
 // Function to transform flat CLI args into nested Config structure
 const transformCliArgs = (finalCliArgs)=>{
@@ -37,8 +45,9 @@ const transformCliArgs = (finalCliArgs)=>{
     // Map configDir (CLI) to configDirectory (Cardigantime standard)
     if (finalCliArgs.configDir !== undefined) transformedCliArgs.configDirectory = finalCliArgs.configDir;
     // Nested mappings for 'commit' options
-    if (finalCliArgs.cached !== undefined || finalCliArgs.sendit !== undefined) {
+    if (finalCliArgs.cached !== undefined || finalCliArgs.sendit !== undefined || finalCliArgs.add !== undefined) {
         transformedCliArgs.commit = {};
+        if (finalCliArgs.add !== undefined) transformedCliArgs.commit.add = finalCliArgs.add;
         if (finalCliArgs.cached !== undefined) transformedCliArgs.commit.cached = finalCliArgs.cached;
         if (finalCliArgs.sendit !== undefined) transformedCliArgs.commit.sendit = finalCliArgs.sendit;
         if (finalCliArgs.messageLimit !== undefined) transformedCliArgs.commit.messageLimit = finalCliArgs.messageLimit;
@@ -52,6 +61,24 @@ const transformCliArgs = (finalCliArgs)=>{
         if (finalCliArgs.context !== undefined) transformedCliArgs.release.context = finalCliArgs.context;
         if (finalCliArgs.messageLimit !== undefined) transformedCliArgs.release.messageLimit = finalCliArgs.messageLimit;
     }
+    // Nested mappings for 'publish' options
+    if (finalCliArgs.mergeMethod !== undefined) {
+        transformedCliArgs.publish = {};
+        if (finalCliArgs.mergeMethod !== undefined) transformedCliArgs.publish.mergeMethod = finalCliArgs.mergeMethod;
+    }
+    // Nested mappings for 'link' and 'unlink' options (both use the same configuration)
+    if (finalCliArgs.scopeRoots !== undefined || finalCliArgs.workspaceFile !== undefined) {
+        transformedCliArgs.link = {};
+        if (finalCliArgs.scopeRoots !== undefined) {
+            try {
+                transformedCliArgs.link.scopeRoots = JSON.parse(finalCliArgs.scopeRoots);
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            } catch (error) {
+                throw new Error(`Invalid JSON for scope-roots: ${finalCliArgs.scopeRoots}`);
+            }
+        }
+        if (finalCliArgs.workspaceFile !== undefined) transformedCliArgs.link.workspaceFile = finalCliArgs.workspaceFile;
+    }
     if (finalCliArgs.excludedPatterns !== undefined) transformedCliArgs.excludedPatterns = finalCliArgs.excludedPatterns;
     // Note: finalCliArgs.openaiApiKey is intentionally omitted here as it belongs to SecureConfig
     return transformedCliArgs;
@@ -71,14 +98,38 @@ const configure = async (cardigantime)=>{
     const transformedCliArgs = transformCliArgs(finalCliArgs);
     logger.debug('Transformed CLI Args for merging: %s', JSON.stringify(transformedCliArgs, null, 2));
     // Get values from config file
-    const fileValues = await cardigantime.read(finalCliArgs);
-    await cardigantime.validate(fileValues); // Validate file config against the shape
+    // Temporary workaround: Read config file manually due to cardigantime parsing issue
+    let fileValues = {};
+    // Force manual config reading for now
+    const configPath = path.join(process.cwd(), '.kodrdriv', 'config.yaml');
+    const storage = create({
+        log: logger.info
+    });
+    const exists = await storage.exists(configPath);
+    if (exists) {
+        const yaml = await import('js-yaml');
+        const configContent = await storage.readFile(configPath, 'utf-8');
+        fileValues = yaml.load(configContent);
+        // Add the configDirectory since it's not in the config file but is required
+        if (!fileValues.configDirectory) {
+            fileValues.configDirectory = '.kodrdriv';
+        }
+    }
+    // Temporarily skip cardigantime validation due to parsing issues
+    // await cardigantime.validate(fileValues);
     // Merge configurations: Defaults -> File -> CLI
+    // Properly merge the link section to preserve scope roots from config file
+    const mergedLink = {
+        ...KODRDRIV_DEFAULTS.link,
+        ...fileValues.link,
+        ...transformedCliArgs.link
+    };
     const partialConfig = {
         ...KODRDRIV_DEFAULTS,
         ...fileValues,
-        ...transformedCliArgs
-    }; // Cast to Partial<MainConfig> initially
+        ...transformedCliArgs,
+        link: mergedLink
+    }; // Cast to Partial<Config> initially
     // Specific validation and processing after merge
     const config = await validateAndProcessOptions(partialConfig);
     logger.verbose('Final configuration: %s', JSON.stringify(config, null, 2));
@@ -97,24 +148,39 @@ function getCliConfig(program) {
         .option('--excluded-paths [excludedPatterns...]', 'paths to exclude from the diff');
     };
     // Add subcommands
-    const commitCommand = program.command('commit').option('--cached', 'use cached diff').option('--sendit', 'Commit with the message generated. No review.').option('--context <context>', 'context for the commit message').option('--message-limit <messageLimit>', 'limit the number of messages to generate').description('Generate commit notes');
+    const commitCommand = program.command('commit').option('--cached', 'use cached diff').option('--add', 'add all changes before committing').option('--sendit', 'Commit with the message generated. No review.').option('--context <context>', 'context for the commit message').option('--message-limit <messageLimit>', 'limit the number of messages to generate').description('Generate commit notes');
     addSharedOptions(commitCommand);
     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').description('Generate release notes');
     addSharedOptions(releaseCommand);
+    const publishCommand = program.command('publish').option('--merge-method <method>', 'method to merge PR (merge, squash, rebase)', 'squash').description('Publish a release');
+    addSharedOptions(publishCommand);
+    const linkCommand = program.command('link').option('--scope-roots <scopeRoots>', 'JSON mapping of scopes to root directories (e.g., \'{"@company": "../"}\')').option('--workspace-file <workspaceFile>', 'path to workspace file', 'pnpm-workspace.yaml').description('Manage pnpm workspace links for local development');
+    addSharedOptions(linkCommand);
+    const unlinkCommand = program.command('unlink').option('--scope-roots <scopeRoots>', 'JSON mapping of scopes to root directories (e.g., \'{"@company": "../"}\')').option('--workspace-file <workspaceFile>', 'path to workspace file', 'pnpm-workspace.yaml').description('Remove pnpm workspace links and rebuild dependencies');
+    addSharedOptions(unlinkCommand);
     program.parse();
     const cliArgs = program.opts(); // Get all opts initially
     // Determine which command is being run
     let commandName = DEFAULT_COMMAND;
     let commandOptions = {}; // Store specific command options
-    if (program.args.length > 0 && ALLOWED_COMMANDS.includes(program.args[0])) {
+    if (program.args.length > 0) {
         commandName = program.args[0];
+    }
+    validateCommand(commandName);
+    // Only proceed with command-specific options if validation passed
+    if (ALLOWED_COMMANDS.includes(commandName)) {
         if (commandName === 'commit' && commitCommand.opts) {
             commandOptions = commitCommand.opts();
         } else if (commandName === 'release' && releaseCommand.opts) {
             commandOptions = releaseCommand.opts();
+        } else if (commandName === 'publish' && publishCommand.opts) {
+            commandOptions = publishCommand.opts();
+        } else if (commandName === 'link' && linkCommand.opts) {
+            commandOptions = linkCommand.opts();
+        } else if (commandName === 'unlink' && unlinkCommand.opts) {
+            commandOptions = unlinkCommand.opts();
         }
     }
-    validateCommand(commandName);
     // Include command name in CLI args for merging
     const finalCliArgs = {
         ...cliArgs,
@@ -141,13 +207,13 @@ async function validateAndProcessSecureOptions() {
 }
 // Renamed validation function to reflect its broader role
 async function validateAndProcessOptions(options) {
-    var _options_commit, _options_commit1, _options_commit2, _options_commit3, _options_release, _options_release1, _options_release2, _options_release3;
+    var _options_commit, _options_commit1, _options_commit2, _options_commit3, _options_commit4, _options_release, _options_release1, _options_release2, _options_release3, _options_publish, _options_publish1, _options_publish2, _options_link, _options_link1, _options_link2;
     const contextDirectories = await validateContextDirectories(options.contextDirectories || KODRDRIV_DEFAULTS.contextDirectories);
     const instructionsPathOrContent = options.instructions || KODRDRIV_DEFAULTS.instructions;
     const instructions = await validateAndReadInstructions(instructionsPathOrContent);
     const configDir = options.configDirectory || KODRDRIV_DEFAULTS.configDirectory;
     await validateConfigDir(configDir); // Keep validation, but maybe remove return if not used elsewhere
-    var _options_dryRun, _options_verbose, _options_debug, _options_overrides, _options_model, _options_commit_cached, _options_commit_sendit, _options_commit_messageLimit, _options_release_from, _options_release_to, _options_release_messageLimit, _options_excludedPatterns;
+    var _options_dryRun, _options_verbose, _options_debug, _options_overrides, _options_model, _options_commit_add, _options_commit_cached, _options_commit_sendit, _options_commit_messageLimit, _options_release_from, _options_release_to, _options_release_messageLimit, _options_publish_mergeMethod, _options_publish_requiredEnvVars, _options_link_scopeRoots, _options_link_workspaceFile, _options_link_dryRun, _options_excludedPatterns;
     // Ensure all required fields are present and have correct types after merging
     const finalConfig = {
         dryRun: (_options_dryRun = options.dryRun) !== null && _options_dryRun !== void 0 ? _options_dryRun : KODRDRIV_DEFAULTS.dryRun,
@@ -160,10 +226,11 @@ async function validateAndProcessOptions(options) {
         configDirectory: configDir,
         // Command-specific options with defaults
         commit: {
-            cached: (_options_commit_cached = (_options_commit = options.commit) === null || _options_commit === void 0 ? void 0 : _options_commit.cached) !== null && _options_commit_cached !== void 0 ? _options_commit_cached : KODRDRIV_DEFAULTS.commit.cached,
-            sendit: (_options_commit_sendit = (_options_commit1 = options.commit) === null || _options_commit1 === void 0 ? void 0 : _options_commit1.sendit) !== null && _options_commit_sendit !== void 0 ? _options_commit_sendit : KODRDRIV_DEFAULTS.commit.sendit,
-            messageLimit: (_options_commit_messageLimit = (_options_commit2 = options.commit) === null || _options_commit2 === void 0 ? void 0 : _options_commit2.messageLimit) !== null && _options_commit_messageLimit !== void 0 ? _options_commit_messageLimit : KODRDRIV_DEFAULTS.commit.messageLimit,
-            context: (_options_commit3 = options.commit) === null || _options_commit3 === void 0 ? void 0 : _options_commit3.context
+            add: (_options_commit_add = (_options_commit = options.commit) === null || _options_commit === void 0 ? void 0 : _options_commit.add) !== null && _options_commit_add !== void 0 ? _options_commit_add : KODRDRIV_DEFAULTS.commit.add,
+            cached: (_options_commit_cached = (_options_commit1 = options.commit) === null || _options_commit1 === void 0 ? void 0 : _options_commit1.cached) !== null && _options_commit_cached !== void 0 ? _options_commit_cached : KODRDRIV_DEFAULTS.commit.cached,
+            sendit: (_options_commit_sendit = (_options_commit2 = options.commit) === null || _options_commit2 === void 0 ? void 0 : _options_commit2.sendit) !== null && _options_commit_sendit !== void 0 ? _options_commit_sendit : KODRDRIV_DEFAULTS.commit.sendit,
+            messageLimit: (_options_commit_messageLimit = (_options_commit3 = options.commit) === null || _options_commit3 === void 0 ? void 0 : _options_commit3.messageLimit) !== null && _options_commit_messageLimit !== void 0 ? _options_commit_messageLimit : KODRDRIV_DEFAULTS.commit.messageLimit,
+            context: (_options_commit4 = options.commit) === null || _options_commit4 === void 0 ? void 0 : _options_commit4.context
         },
         release: {
             from: (_options_release_from = (_options_release = options.release) === null || _options_release === void 0 ? void 0 : _options_release.from) !== null && _options_release_from !== void 0 ? _options_release_from : KODRDRIV_DEFAULTS.release.from,
@@ -171,6 +238,16 @@ async function validateAndProcessOptions(options) {
             messageLimit: (_options_release_messageLimit = (_options_release2 = options.release) === null || _options_release2 === void 0 ? void 0 : _options_release2.messageLimit) !== null && _options_release_messageLimit !== void 0 ? _options_release_messageLimit : KODRDRIV_DEFAULTS.release.messageLimit,
             context: (_options_release3 = options.release) === null || _options_release3 === void 0 ? void 0 : _options_release3.context
         },
+        publish: {
+            mergeMethod: (_options_publish_mergeMethod = (_options_publish = options.publish) === null || _options_publish === void 0 ? void 0 : _options_publish.mergeMethod) !== null && _options_publish_mergeMethod !== void 0 ? _options_publish_mergeMethod : KODRDRIV_DEFAULTS.publish.mergeMethod,
+            dependencyUpdatePatterns: (_options_publish1 = options.publish) === null || _options_publish1 === void 0 ? void 0 : _options_publish1.dependencyUpdatePatterns,
+            requiredEnvVars: (_options_publish_requiredEnvVars = (_options_publish2 = options.publish) === null || _options_publish2 === void 0 ? void 0 : _options_publish2.requiredEnvVars) !== null && _options_publish_requiredEnvVars !== void 0 ? _options_publish_requiredEnvVars : KODRDRIV_DEFAULTS.publish.requiredEnvVars
+        },
+        link: {
+            scopeRoots: (_options_link_scopeRoots = (_options_link = options.link) === null || _options_link === void 0 ? void 0 : _options_link.scopeRoots) !== null && _options_link_scopeRoots !== void 0 ? _options_link_scopeRoots : KODRDRIV_DEFAULTS.link.scopeRoots,
+            workspaceFile: (_options_link_workspaceFile = (_options_link1 = options.link) === null || _options_link1 === void 0 ? void 0 : _options_link1.workspaceFile) !== null && _options_link_workspaceFile !== void 0 ? _options_link_workspaceFile : KODRDRIV_DEFAULTS.link.workspaceFile,
+            dryRun: (_options_link_dryRun = (_options_link2 = options.link) === null || _options_link2 === void 0 ? void 0 : _options_link2.dryRun) !== null && _options_link_dryRun !== void 0 ? _options_link_dryRun : KODRDRIV_DEFAULTS.link.dryRun
+        },
         excludedPatterns: (_options_excludedPatterns = options.excludedPatterns) !== null && _options_excludedPatterns !== void 0 ? _options_excludedPatterns : KODRDRIV_DEFAULTS.excludedPatterns
     };
     // Final validation against the MainConfig shape (optional, cardigantime might handle it)
@@ -258,5 +335,5 @@ async function validateAndReadInstructions(instructionsPath) {
     }
 }
 
-export { configure, transformCliArgs, validateAndReadInstructions, validateCommand, validateContextDirectories };
+export { configure, getCliConfig, transformCliArgs, validateAndProcessOptions, validateAndProcessSecureOptions, validateAndReadInstructions, validateCommand, validateConfigDir, validateContextDirectories };
 //# sourceMappingURL=arguments.js.map