fix(cli): improve error message for custom mode not found

[benzntech]

Summary

This PR improves the CLI error message when a custom mode is not found, addressing issues #4575 and #4600.

Changes

cli/src/config/customModes.ts

• Added SearchedPath interface to track search locations
• Added getSearchedPaths() export for error reporting
• Added debug logging for mode loading/failures
• Refactored loading functions to return path metadata

cli/src/index.ts

• Replaced misleading "Invalid mode" error with informative "Mode not found" message
• Shows exactly where CLI searched for custom modes (global and project paths)

cli/src/config/__tests__/customModes.test.ts

• Added 14 comprehensive unit tests

Before

Error: Invalid mode "my-mode". Valid modes are: code, architect, ask, debug, orchestrator

After

Error: Mode "my-mode" not found.

The CLI searched for custom modes in:
  • Global: ~/Library/.../custom_modes.yaml (not found)
  • Project: /workspace/.kilocodemodes (not found)

Available modes: code, architect, ask, debug, orchestrator

Testing

• All 14 new tests pass

Fixes #4575
Fixes #4600

[changeset-bot]

🦋 Changeset detected

Latest commit: 6583bcc

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@kilocode/cli	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[marius-kilocode]

@benzntech Appears to me that the PR's are stacked on top of each other? Would you be able to split the CLI from the PR? Or are they dependent? Thanks!

[benzntech]

@benzntech Appears to me that the PR's are stacked on top of each other? Would you be able to split the CLI from the PR? Or are they dependent? Thanks!

updated @marius-kilocode

[marius-kilocode]

Looks like a good improvement for usability @benzntech .
Would it make sense to then also align the error message users get when changing the mode within the CLI itself (see screenshot)? Because that one still shows the old error message.

In the best case we reuse the same mechanism for both cases:

• kilo --mode does-not-exist
• /mode does-not-exist

[benzntech]

Looks like a good improvement for usability @benzntech .

Would it make sense to then also align the error message users get when changing the mode within the CLI itself (see screenshot)? Because that one still shows the old error message.

In the best case we reuse the same mechanism for both cases:

• kilo --mode does-not-exist

• /mode does-not-exist

@marius-kilocode updated

[marius-kilocode]

Recreated in: #4982
Thanks for contributing!