refactor(goal): code analysis engine

changes:
  - file: __init__.py
    area: cli
    modified: [stage_paths, main]
  - file: authors_cmd.py
    area: cli
    modified: [authors_list, authors_remove, authors_update, authors_add, authors_import]
  - file: commit_cmd.py
    area: cli
    modified: [validate]
  - file: version.py
    area: cli
    modified: [update_project_metadata]
  - file: validation.py
    area: config
    modified: [ConfigValidationError]
  - file: python.py
    area: docs
    modified: [PythonDiagnostics, check_py011_version_consistency]
  - file: formatter.py
    area: core
    modified: [MarkdownFormatter, add_command_output]
  - file: analyzer.py
    area: analyzer
    modified: [per_file_notes, ContentAnalyzer]
  - file: push_remote.py
    area: core
    modified: [_offer_recovery]
  - file: file_validator.py
    area: core
    modified: [manage_dot_folders]

stats:
  lines: "+706/-501 (net +205)"
  files: 26
  complexity: "Stable complexity"

Author: tom-sapletta-com

CHANGELOG.md

@@ -1,5 +1,39 @@
 ## [Unreleased]
 
+## [2.1.116] - 2026-03-27
+
+### Docs
+- Update CHANGELOG.md
+- Update TODO.md
+- Update docs/README.md
+- Update project/context.md
+
+### Other
+- Update planfile.yaml
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/compact_flow.mmd
+- Update project/duplication.toon.yaml
+- Update project/flow.mmd
+- Update project/flow.png
+- Update project/index.html
+- Update project/map.toon.yaml
+- ... and 2 more files
+
+## [0.1.10] - 2026-03-27
+
+### Fixed
+- Fix wildcard-imports issues (ticket-09656430)
+
+## [0.1.10] - 2026-03-27
+
+### Fixed
+- Fix wildcard-imports issues (ticket-0f634339)
+- Fix wildcard-imports issues (ticket-0d8f6000)
+- Fix wildcard-imports issues (ticket-212c0467)
+- Fix wildcard-imports issues (ticket-0fd418e6)
+
 ## [2.1.115] - 2026-03-27
 
 ## [2.1.114] - 2026-03-27

README.md

@@ -4,7 +4,7 @@
 # Goal
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-2.1.115-blue.svg" alt="Version">
+  <img src="https://img.shields.io/badge/version-2.1.116-blue.svg" alt="Version">
   <img src="https://img.shields.io/badge/python-3.8+-blue.svg" alt="Python">
   <img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License">
   <img src="https://img.shields.io/badge/pypi-goal-orange.svg" alt="PyPI">

TODO.md

@@ -1 +1 @@
-2.1.115
+2.1.116

VERSION

@@ -1,3 +1,3 @@
 """Goal - Automated git push with smart commit messages, changelog updates, and version tagging."""
 
-__version__ = "2.1.115"
+__version__ = "2.1.116"

docs/README.md

@@ -75,7 +75,7 @@ def split_paths_by_type(paths: List[str]) -> Dict[str, List[str]]:
     return {k: v for k, v in groups.items() if v}
 
 
-def stage_paths(paths: List[str]):
+def stage_paths(paths: List[str]) -> None:
     if not paths:
         return
     # stage in chunks to avoid arg length issues
@@ -154,7 +154,7 @@ def parse_args(self, ctx, args):
 @click.option('--nfo-format', default='markdown', help='nfo log format')
 @click.option('--nfo-sink', default='', help='Additional nfo sink')
 @click.pass_context
-def main(ctx, bump, version, yes, all_flags, todo, markdown, dry_run, config_path, abstraction, nfo_format, nfo_sink):
+def main(ctx, bump, version, yes, all_flags, todo, markdown, dry_run, config_path, abstraction, nfo_format, nfo_sink) -> None:
     """Goal - Automated git push with smart commit messages."""
     _setup_nfo_logging(nfo_format, nfo_sink)
 

goal/__init__.py

@@ -13,7 +13,7 @@ def authors():
 
 
 @authors.command(name='list')
-def authors_list():
+def authors_list() -> None:
     """List all project authors."""
     manager = AuthorsManager()
     manager.list_authors()
@@ -24,15 +24,15 @@ def authors_list():
 @click.argument('email')
 @click.option('--role', '-r', help='Author role or title')
 @click.option('--alias', '-a', help='Short alias for reference')
-def authors_add(name, email, role, alias):
+def authors_add(name, email, role, alias) -> None:
     """Add an author to the project."""
     manager = AuthorsManager()
     manager.add_author(name, email, role, alias)
 
 
 @authors.command(name='remove')
 @click.argument('email')
-def authors_remove(email):
+def authors_remove(email) -> None:
     """Remove an author from the project."""
     manager = AuthorsManager()
     manager.remove_author(email)
@@ -43,14 +43,14 @@ def authors_remove(email):
 @click.option('--name', '-n', help='New name')
 @click.option('--role', '-r', help='New role')
 @click.option('--alias', '-a', help='New alias')
-def authors_update(email, name, role, alias):
+def authors_update(email, name, role, alias) -> None:
     """Update an author's information."""
     manager = AuthorsManager()
     manager.update_author(email, name, role, alias)
 
 
 @authors.command(name='import')
-def authors_import():
+def authors_import() -> None:
     """Import authors from git history."""
     manager = AuthorsManager()
     manager.import_from_git()

goal/cli/__init__.py

@@ -143,7 +143,6 @@ def fix_summary(ctx, fix, preview, cached):
 @click.pass_context
 def validate(ctx, fix, cached):
     """Validate commit summary against quality gates."""
-    from ..enhanced_summary import QualityValidator
 
     files = get_staged_files()
     stats = get_diff_stats()

goal/cli/authors_cmd.py

@@ -340,7 +340,7 @@ def update_project_metadata(filepath: Path, user_config) -> bool:
                     author_list = [a.strip().rstrip(',') for a in existing_authors.split('\n') if a.strip()]
                     author_list.append(new_author_entry)
 
-                    authors_block = 'authors = [' + ', '.join(author_list) + ']'
+                    authors_block = f"authors = [{', '.join(author_list)}]"
                     content = re.sub(
                         r'^authors\s*=\s*\[.*?\]',
                         authors_block,