**Critical: Source Priority System** - Fixed bug where later sources …

…incorrectly overwrote earlier sources, ignoring `source_order` configuration. Now correctly implements first-wins priority (e.g., with `source_order: ["env", "files"]`, ENV values are never overwritten by FILES).

**List Options** - Fixed TypeError when list parameters were present. List options now automatically skip command line parsing and work correctly from ENV and FILES sources only.

- Added `CLAUDE.md` with architecture overview, development workflows, and code style requirements
- Rewrote `README.md` with practical examples, quick start guide, and comprehensive usage documentation

Added 10 new tests covering source priority and list option behavior. Total: 35 tests (up from 25).

If you relied on the buggy behavior where later sources overwrote earlier sources, adjust your `source_order`:

```yaml
source_order: ['cmd', 'files', 'env']

source_order: ['env', 'files', 'cmd']

The first source in source_order now correctly takes precedence.

This version:
- Reduces from ~200 lines to ~30 lines
- Keeps all essential information
- Maintains the breaking change warning with examples
- Removes redundant details while keeping key facts

feat(logging) adding debug for malformed configuration

fix: self._config_file is not None when empty

version 1.0.6

crypting: allowing and ignoring empty passkey without error

Droping use of deepcopy, increasing performances

Better list option support

* Fixing tests syntax
* Adding edge case testing
* Ensuring respect of the no_cmd param
* Fixing list node browsing (no more double entries)
* No more join in debug (fatal to normal exec in certain condition)
* Handling of malformed ENV (for non consecutive index in ENV)

Fixing error in loading json

Encryption: better handling of unencrypted file

TheConf version 1.0

Supporting crypted file and providing command line to encrypt and decrypt config file