feat: per-file TOC marker priority, --sectionized flag, project-wide logging

Per-file TOC (SPEC 4.8.2):
- toc-start markers record their params (sectionized, headings range);
  on regeneration the marker params have priority, then CLI arguments,
  then fiona-settings.json defaults; legacy bare markers are upgraded
- --sectionized forces section numbering on for the run
- folder TOC validates its target: a file or missing path exits 1 with
  a hint toward 'librarian toc file'; empty folders are reported
- MD032-compliant TOC block layout (blank lines around the entry list)
- wiki root discovery skips build artifacts (build/, dist/, __pycache__/,
  *.egg-info/) that shadowed the real settings with stale copies

Logging (SPEC 5.1):
- shared fiona.logging_config used by every CLI entry point; level from
  LOG_LEVEL env > fiona.log_level > WARNING; physical-file logging via
  fiona.file_log_level / fiona.file_log_location
- operational TOC logs promoted to INFO so file logs record activity

Docs:
- SPEC section references renumbered after sectionize (1.x/2.x/3.x ->
  3.x/4.x/5.x) across code, tests, AGENTS.md, todo.md and the template
This commit is contained in:
nvaldez
2026-09-26 18:47:06 +02:00
parent 13467cfa2a
commit 9a88619e3d
20 changed files with 1310 additions and 221 deletions
+5 -1
View File
@@ -136,7 +136,11 @@ def main():
)
args = parser.parse_args()
from fiona.logging_config import setup_logging
setup_logging()
pruff = PythonRuff()
if args.subcommand is None: