refactoring

Author: tom-sapletta-com

code2logic/cli.py

@@ -652,10 +652,22 @@ def _maybe_print_pretty_help() -> bool:
         help='Write all output to stdout instead of files (including schema and function-logic). Useful for piping.'
     )
     parser.add_argument(
-        '--no-repeat-name',
+        '--no-repeat-module',
         action='store_true',
+        dest='no_repeat_module',
         help='Reduce repeated directory prefixes in TOON outputs by using ./file for consecutive entries in the same folder (applies to function-logic TOON and TOON module lists).'
     )
+    parser.add_argument(
+        '--no-repeat-name',
+        action='store_true',
+        dest='no_repeat_module',
+        help=argparse.SUPPRESS
+    )
+    parser.add_argument(
+        '--no-repeat-details',
+        action='store_true',
+        help='Reduce repeated directory prefixes in function-logic TOON section function_details by using ./file for consecutive entries in the same folder.'
+    )
     parser.add_argument(
         '--no-install',
         action='store_true',
@@ -969,7 +981,7 @@ def _maybe_print_pretty_help() -> bool:
             output = generator.generate(
                 project,
                 detail=detail_map.get(args.detail, 'standard'),
-                no_repeat_name=args.no_repeat_name,
+                no_repeat_name=args.no_repeat_module,
             )
 
         # Generate schema if requested
@@ -1021,7 +1033,12 @@ def _maybe_print_pretty_help() -> bool:
         elif lower.endswith(('.yaml', '.yml')):
             logic_out = logic_gen.generate_yaml(project, detail=args.detail)
         elif lower.endswith('.toon'):
-            logic_out = logic_gen.generate_toon(project, detail=args.detail, no_repeat_name=args.no_repeat_name)
+            logic_out = logic_gen.generate_toon(
+                project,
+                detail=args.detail,
+                no_repeat_name=args.no_repeat_module,
+                no_repeat_details=args.no_repeat_details,
+            )
         else:
             logic_out = logic_gen.generate(project, detail=args.detail)
 

code2logic/function_logic.py

@@ -59,7 +59,13 @@ def generate_yaml(self, project: ProjectInfo, detail: str = 'full') -> str:
             return self.generate(project, detail)
         return yaml.dump(data, default_flow_style=False, allow_unicode=True, sort_keys=False, width=120)
 
-    def generate_toon(self, project: ProjectInfo, detail: str = 'full', no_repeat_name: bool = False) -> str:
+    def generate_toon(
+        self,
+        project: ProjectInfo,
+        detail: str = 'full',
+        no_repeat_name: bool = False,
+        no_repeat_details: bool = False,
+    ) -> str:
         if detail == 'detailed':
             detail = 'full'
         toon = TOONGenerator()
@@ -92,14 +98,14 @@ def generate_toon(self, project: ProjectInfo, detail: str = 'full', no_repeat_na
             if not items:
                 continue
 
-            if no_repeat_name:
+            if no_repeat_details:
                 compressed_path, prev_dir = toon._compress_module_path(m.path, prev_dir)
                 details_key = compressed_path
             else:
                 details_key = m.path
             lines.append(f"  {toon._quote(details_key)}:")
 
-            header = f"name{dm}kind{dm}sig{dm}loc{dm}async{dm}lines{dm}cc"
+            header = f"line{dm}name{dm}kind{dm}sig{dm}async{dm}cc"
             if detail in ('standard', 'full'):
                 header += f"{dm}does"
             if detail == 'full':
@@ -109,15 +115,14 @@ def generate_toon(self, project: ProjectInfo, detail: str = 'full', no_repeat_na
 
             for kind, qname, func in items:
                 sig = self._build_sig(func, include_async_prefix=False, language=m.language)
-                loc = self._build_loc(func)
                 is_async = 'true' if getattr(func, 'is_async', False) else 'false'
+                start_line = str(getattr(func, 'start_line', 0) or 0)
                 row = [
+                    start_line,
                     toon._quote(qname),
                     toon._quote(kind),
                     toon._quote(sig),
-                    toon._quote(loc),
                     is_async,
-                    str(getattr(func, 'lines', 0) or 0),
                     str(getattr(func, 'complexity', 1) or 1),
                 ]
 

docs/03-cli-reference.md

@@ -44,6 +44,8 @@ If `CODE2LOGIC_DEFAULT_PROVIDER=auto`, Code2Logic tries providers in priority or
 | `--compact` | | Use compact YAML format (14% smaller, meta.legend transparency) |
 | `--hybrid` | | Use hybrid YAML output (or use `-f hybrid`) |
 | `--ultra-compact` | | Use ultra-compact TOON format (71% smaller) |
+| `--no-repeat-module` | | Reduce repeated directory prefixes in TOON `modules[...]` tables by using `./file` for consecutive entries in the same folder |
+| `--no-repeat-details` | | Reduce repeated directory prefixes in function-logic TOON `function_details` section by using `./file` for consecutive entries in the same folder |
 | `--with-schema` | | Generate JSON schema alongside output |
 | `--verbose` | `-v` | Verbose output with timing |
 | `--debug` | | Debug output (very verbose) |
@@ -120,8 +122,14 @@ code2logic /path/to/project -f toon -o analysis.toon
 # Ultra-compact TOON (71% smaller, single-letter keys)
 code2logic /path/to/project -f toon --ultra-compact -o analysis-ultra.toon
 
+# Reduce repeated directory prefixes in modules[] (uses ./file when staying in the same folder)
+code2logic /path/to/project -f toon --no-repeat-module -o analysis.toon
+
 # Generate schema alongside output
 code2logic /path/to/project -f toon --ultra-compact --with-schema
+
+# Generate function-logic as TOON + compress function_details module keys
+code2logic /path/to/project -f toon --function-logic --name project -o ./ --no-repeat-details
 ```
 
 Token-oriented object notation - most efficient format for LLM consumption.

docs/07-toon.md

@@ -120,8 +120,85 @@ code2logic /path/to/project -f toon -o analysis.toon
 
 # With full detail
 code2logic /path/to/project -f toon -d full
+
+# Reduce repeated directory prefixes in the modules table
+# (when consecutive entries are in the same folder, emits ./file)
+code2logic /path/to/project -f toon --no-repeat-module -o analysis.toon
+
+# Generate function-logic as TOON + reduce repeats in function_details
+code2logic /path/to/project -f toon --function-logic --name project -o ./ --no-repeat-details
+
+# Enable both (modules table + function_details)
+code2logic /path/to/project -f toon --function-logic --name project -o ./ --no-repeat-module --no-repeat-details
+```
+
+### Reducing Path Repetition (Filesystem Tree Hint)
+
+For large repositories, repeating directory prefixes in every `modules[...]` row or every `function_details` key can waste a lot of tokens.
+
+Code2Logic supports a compact, LLM-friendly convention:
+
+- The first entry in a directory is emitted as a full relative path, e.g. `scripts/build-docs.js`
+- Subsequent consecutive entries in the same directory are emitted as `./<basename>`, e.g. `./seed_auth_users.py`
+
+This signals "same directory as the previous entry" and is typically understood well by LLMs as a filesystem listing.
+
+**Example (modules table):**
+
+Without `--no-repeat-module`:
+
+```toon
+modules[4]{path,lang,lines,kb}:
+  scripts/build-docs.js,js,9,1.2
+  scripts/seed_auth_users.py,py,4,0.4
+  scripts/stats-collector.py,py,14,0.8
+  shared/dsl-runtime.ts,ts,13,1.1
 ```
 
+With `--no-repeat-module`:
+
+```toon
+modules[4]{path,lang,lines,kb}:
+  scripts/build-docs.js,js,9,1.2
+  ./seed_auth_users.py,py,4,0.4
+  ./stats-collector.py,py,14,0.8
+  shared/dsl-runtime.ts,ts,13,1.1
+```
+
+**Example (function-logic TOON, function_details):**
+
+```bash
+code2logic /path/to/project -f toon --function-logic --name project -o ./ --no-repeat-details
+```
+
+Output fragment:
+
+```toon
+function_details:
+  firmware/main.py:
+    functions[2]{line,name,kind,sig,async,cc,does}:
+      77,index_page,function,(),true,2,Serve the firmware UI
+      85,health_check,function,(),true,1,Health check endpoint
+  ./test_main.py:
+    functions[1]{line,name,kind,sig,async,cc,does}:
+      14,TestFirmwareSimulator.test_health_check,method,(),false,1,Test basic health endpoint
+```
+
+Notes:
+
+- `--no-repeat-module` affects TOON `modules[...]` tables (main TOON output and function-logic TOON modules table).
+- `--no-repeat-details` affects the module keys under `function_details` in function-logic TOON output.
+
+### Language Codes
+
+For lower token usage, TOON uses short language codes in `lang` columns and in `languages[...]` summary, e.g.:
+
+- `py` = Python
+- `js` = JavaScript
+- `ts` = TypeScript
+
+If a language is unknown or not mapped, the full language name is emitted.
+
 ## Format Syntax
 
 ### Basic Key-Value