feat(cli): add support for dynamic configuration overrides in init command #444

[HarK-github]

Add Support for Dynamic Configuration Overrides in fablo init

This PR introduces the ability to override any property in the default fablo-config.json directly from the CLI during fablo init using the --set flag.

1. New --set Flag

• Users can now override configuration values using --set key=value syntax
• Supports multiple --set flags in a single command
• Example: fablo init --set global.fabricVersion=2.5.0 --set global.tls=false

2. Smart Type Casting

The parser automatically detects and converts values to appropriate types:

• Booleans: true/false → boolean type
• Numbers: 5, 3.14 → number type
• JSON: {"key":"value"}, [1,2,3] → object/array type
• Strings: All other values → string type

3. Nested Path Support

• Supports dot notation for nested objects: global.monitoring.loglevel=debug
• Supports array indexing: orgs[0].peer.db=CouchDb
• Auto-creates non-existent nested paths

4. Backward Compatibility

• Preserves existing node, dev, ccaas, gateway, rest positional arguments
• Existing workflows continue to work without changes
• Command signature unchanged

5. E2E Test Coverage

Added comprehensive test coverage for:

• Numeric string coercion (ensures numbers, not strings)
• Non-existent nested path creation
• Multiple simultaneous overrides with mixed types
• Boolean, string, and array overrides

Usage Examples:

# Single override
fablo init --set global.fabricVersion=2.5.0

# Multiple overrides
fablo init --set global.tls=false --set orgs[0].peer.db=CouchDb

# With positional arguments
fablo init node --set global.fabricVersion=3.0.0 --set orgs[1].peer.instances=5

# Complex nested paths
fablo init --set global.monitoring.loglevel=debug --set channels[0].name=my-channel2

[OsamaRab3]

I ran it locally, but it doesn’t work as expected. When running:
./bin/run.mjs init --orgs[0].peer.instances=5
I get the following error:
zsh: no matches found: --orgs[0].peer.instances=5 the same error with ./bin/run.mjs init --channels[0].name=my-channel2 it only work with ./bin/run.mjs init --global.tls=true  Also, I’m not a big fan of the current implementation approach it feels a bit hard to follow and might benefit from simplification or clearer structure.

[HarK-github]

@OsamaRab3 I have made some changes. Try using set flag . ex :/fablo.sh init --set global.fabricVersion=2.5.0 --set global.tls=false

[HarK-github]

@OsamaRab3 did it work?

[HarK-github]

@OsamaRab3 can you have a look please

[OsamaRab3]

&& trimmed !== "" redundant regex already rejects empty string

[OsamaRab3]

Usage Examples:

# Single override
fablo init --set global.fabricVersion=2.5.0

# Multiple overrides
fablo init --set global.tls=false --set orgs[0].peer.db=CouchDb

# With positional arguments
fablo init node --set global.fabricVersion=3.0.0 --set orgs[1].peer.instances=5

# Complex nested paths
fablo init --set global.monitoring.loglevel=debug --set channels[0].name=my-channel2

Could you update the documentation with a few examples showing how to use --set?

[mergify]

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

• Queue this pull request

[OsamaRab3]

LGTM