feat(examples): CLI interface improvements

changes:
  - file: cli.py
    area: cli
    modified: [main]
  - file: config.py
    area: config
    added: [get_project_name]
    modified: [Config]

dependencies:
  flow: "cli→config"
  - cli.py -> config.py

stats:
  lines: "+51/-7 (net +44)"
  files: 3
  complexity: "Large structural change (normalized)"

Author: tom-sapletta-com

.env.example

@@ -43,6 +43,9 @@ CODE2LOGIC_DEFAULT_PROVIDER=ollama
 # Default model (overrides provider-specific model)
 # CODE2LOGIC_DEFAULT_MODEL=
 
+# Default project name (used for output files like project.toon, project.functions.toon)
+CODE2LOGIC_PROJECT_NAME=project
+
 # Verbose logging
 CODE2LOGIC_VERBOSE=false
 

CHANGELOG.md

@@ -1,3 +1,16 @@
+## [1.0.34] - 2026-02-24
+
+### Summary
+
+feat(examples): CLI interface improvements
+
+### Other
+
+- update .env.example
+- update code2logic/cli.py
+- update code2logic/config.py
+
+
 ## [1.0.33] - 2026-02-23
 
 ### Summary

VERSION

@@ -1 +1 @@
-1.0.33
+1.0.34

code2logic/__init__.py

@@ -18,7 +18,7 @@
     >>> print(output)
 """
 
-__version__ = "1.0.33"
+__version__ = "1.0.34"
 __author__ = "Softreck"
 __email__ = "info@softreck.dev"
 __license__ = "MIT"

code2logic/cli.py

@@ -608,6 +608,11 @@ def _maybe_print_pretty_help() -> bool:
         '-o', '--output',
         help='Output file path (default: stdout)'
     )
+    parser.add_argument(
+        '--name',
+        dest='project_name',
+        help='Project name for output files (default: from CODE2LOGIC_PROJECT_NAME env or "project"). Used for auto-generating output, schema, and function-logic file names.'
+    )
     parser.add_argument(
         '--function-logic',
         nargs='?',
@@ -725,6 +730,7 @@ def _maybe_print_pretty_help() -> bool:
 
     # Import after potential installation
     from .analyzer import ProjectAnalyzer, get_library_status
+    from .config import Config
     from .function_logic import FunctionLogicGenerator
     from .generators import (
         CSVGenerator,
@@ -736,6 +742,9 @@ def _maybe_print_pretty_help() -> bool:
     from .logicml import LogicMLGenerator
     from .toon_format import TOONGenerator
 
+    # Load config to get project name
+    config = Config()
+
     # Status check
     if args.status:
         status = get_library_status()
@@ -844,6 +853,27 @@ def _maybe_print_pretty_help() -> bool:
 
         log.separator()
 
+    # Get default project name from config
+    project_name = config.get_project_name()
+
+    # Determine default output path when using --function-logic or --with-schema without -o
+    default_output = None
+    if (args.function_logic or args.with_schema) and not args.output:
+        # Use project name from config with appropriate extension
+        ext_map = {
+            'markdown': 'md',
+            'compact': 'txt',
+            'json': 'json',
+            'yaml': 'yaml',
+            'hybrid': 'yaml',
+            'csv': 'csv',
+            'gherkin': 'feature',
+            'toon': 'toon',
+            'logicml': 'logicml',
+        }
+        ext = ext_map.get(args.format, args.format)
+        default_output = f"{project_name}.{ext}"
+
     # Generate output
     if args.verbose:
         log.step(f"Generating {args.format} output (detail: {args.detail})")
@@ -883,7 +913,8 @@ def _maybe_print_pretty_help() -> bool:
                 schema = generator.generate_schema('hybrid')
             else:
                 schema = generator.generate_schema('compact' if compact else 'full')
-            base_name = os.path.splitext(args.output)[0] if args.output else 'output'
+            effective_output = args.output or default_output
+            base_name = os.path.splitext(effective_output)[0] if effective_output else project_name
             schema_path = f"{base_name}.yaml-schema.json"
             parent_dir = os.path.dirname(schema_path)
             if parent_dir:
@@ -916,7 +947,8 @@ def _maybe_print_pretty_help() -> bool:
         if args.with_schema:
             schema_type = 'ultra_compact' if use_ultra_compact else 'standard'
             schema = generator.generate_schema(schema_type)
-            base_name = os.path.splitext(args.output)[0] if args.output else 'output'
+            effective_output = args.output or default_output
+            base_name = os.path.splitext(effective_output)[0] if effective_output else project_name
             schema_path = f"{base_name}.toon-schema.json"
             parent_dir = os.path.dirname(schema_path)
             if parent_dir:
@@ -940,18 +972,19 @@ def _maybe_print_pretty_help() -> bool:
 
         # Auto-generate path if 'auto' was specified (--function-logic without argument)
         if args.function_logic == 'auto':
-            if args.output:
+            effective_output = args.output or default_output
+            if effective_output:
                 # Derive from output file: project.c2l.yaml -> project.functions.yaml
-                base = args.output.rsplit('.', 1)[0]
+                base = effective_output.rsplit('.', 1)[0]
                 if base.endswith('.c2l'):
                     base = base[:-4]
-                ext = args.output.rsplit('.', 1)[-1] if '.' in args.output else 'logicml'
+                ext = effective_output.rsplit('.', 1)[-1] if '.' in effective_output else 'logicml'
                 logic_path = f"{base}.functions.{ext}"
             else:
-                # Default path based on format
+                # Default path based on format using project name from config
                 ext_map = {'json': 'json', 'yaml': 'yaml', 'toon': 'toon'}
                 ext = ext_map.get(args.format, 'logicml')
-                logic_path = f"project.functions.{ext}"
+                logic_path = f"{project_name}.functions.{ext}"
         else:
             logic_path = str(args.function_logic)
 

code2logic/config.py

@@ -153,6 +153,14 @@ def is_verbose(self) -> bool:
         """Check if verbose mode is enabled."""
         return os.environ.get('CODE2LOGIC_VERBOSE', '').lower() in ('true', '1', 'yes')
 
+    def get_project_name(self) -> str:
+        """Get default project name for output files.
+
+        Returns:
+            Project name (default: 'project')
+        """
+        return os.environ.get('CODE2LOGIC_PROJECT_NAME', 'project')
+
     def get_cache_dir(self) -> Path:
         """Get cache directory path."""
         cache_dir = os.environ.get('CODE2LOGIC_CACHE_DIR', '~/.code2logic/cache')

logic2code/__init__.py

@@ -14,5 +14,5 @@
 from .generator import CodeGenerator, GeneratorConfig, GenerationResult
 from .renderers import PythonRenderer
 
-__version__ = '1.0.33'
+__version__ = '1.0.34'
 __all__ = ['CodeGenerator', 'GeneratorConfig', 'GenerationResult', 'PythonRenderer']

logic2test/__init__.py

@@ -15,5 +15,5 @@
 from .parsers import LogicParser
 from .templates import TestTemplate
 
-__version__ = '1.0.33'
+__version__ = '1.0.34'
 __all__ = ['TestGenerator', 'GeneratorConfig', 'GenerationResult', 'LogicParser', 'TestTemplate']

lolm/__init__.py

@@ -76,7 +76,7 @@
 )
 from .clients import LLMRateLimitError
 
-__version__ = '1.0.33'
+__version__ = '1.0.34'
 __all__ = [
     # Config
     'LLMConfig',

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "code2logic"
-version = "1.0.33"
+version = "1.0.34"
 description = "Code2Logic - Source code to logical representation converter for LLM analysis, featuring Tree-sitter parsing, dependency graph analysis, and multi-language support."
 readme = "README.md"
 license = "Apache-2.0"