repowiseshepherd-agents/shepherd

shepherd-agents / shepherd

pythonmain8e703a6378.9K linessynced on Jul 8, 2026

Code health

7.7out of 10Good

Hotspots average 6.4, the place fixes pay off most.

Explore this codebase

Do next · 3

3 things worth doing in the week to Jul 8, the last indexed commit.

Worth planning

  • Start breaking up execute_sdk (CCN 65, 318 lines): first lift lines 1061-1099

    shepherd/packages/providers/src/shepherd_providers/openai/provider.py:1061

    execute_sdk nests deeply; easier to read and change once split, which also removes a duplicate; its file is imported by 9 files, changed 1 time in 90 days.

    gain
    up to under +0.1 health on this file(inferred)
    finding
    Nested complexity
    size
    CCN 65, 318 lines, nests 7 deep
    severity
    high
    worth a check
  • Start breaking up _validate_publication_experimental_trace (CCN 43, 579 lines)

    shepherd/packages/kernel-v3-reference/src/shepherd_kernel_v3_reference/trace/validate.py:2354

    _validate_publication_experimental_trace nests deeply; easier to read and change once split; its file is imported by 25 files, changed 2 times in 90 days.

    gain
    up to +0.6 health on this file(inferred)
    finding
    Nested complexity
    size
    CCN 43, 579 lines, nests 6 deep
    severity
    high
    worth a check
  • Start breaking up _process_message_stream (CCN 40, 212 lines): first lift lines 925-955

    shepherd/packages/providers/src/shepherd_providers/claude/provider.py:925

    _process_message_stream nests deeply; easier to read and change once split, which also removes a duplicate; its file is imported by 6 files, changed 1 time in 90 days.

    gain
    up to +1.0 health on this file(inferred)
    finding
    Nested complexity
    size
    CCN 40, 212 lines, nests 8 deep
    severity
    high
    worth a check

Improve what Repowise can see

  • Add a test coverage report

    Without one, Repowise cannot tell tested code from untested code, so every test-related action says “unknown”.

    line coverage
    Unknown, no report

Everything we found

5 areas