Timmy Agent 425a87bcce feat(scripts): add readme_generator — auto-generate README from codebase ...

Adds scripts/readme_generator.py — a tool that scans Python codebases,
extracts module docstrings, entry points (argparse main), and directory
structure to generate a standard README.md with: description, installation,
usage, scripts list.

Acceptance for #97:
- Reads codebase structure (AST-based Python file scanner)
- Generates README sections (Description, Installation, Usage, Scripts, Directory)
- Updates existing README (replaces on run — idempotent)
- 1 per run (single repo per invocation)

Usage:
    python3 scripts/readme_generator.py              # generate in-place
    python3 scripts/readme_generator.py --dry-run    # preview stats
    python3 scripts/readme_generator.py --dir /path

Closes #97

2026-04-26 00:20:11 -04:00

..

.gitkeep

Initial structure: knowledge store, scripts, metrics, templates

2026-04-14 11:17:01 -04:00

automation_opportunity_finder.py

fix: add directory exclusions for scan performance (#170)

2026-04-15 15:06:09 +00:00

bootstrapper.py

feat: build bootstrapper.py - pre-session context assembler

2026-04-14 14:05:30 -04:00

dead_code_detector.py

feat: dead code detector for Python codebases (#94)

2026-04-15 03:46:43 +00:00

dependency_graph.py

feat: cross-repo dependency graph builder (#93)

2026-04-15 03:44:12 +00:00

diff_analyzer.py

feat: Add diff analyzer (closes #176)

2026-04-15 03:56:27 +00:00

gitea_issue_parser.py

feat: Add Gitea issue body parser (closes #177)

2026-04-15 03:49:00 +00:00

harvester.py

feat: add harvester.py — session knowledge extractor (#8)

2026-04-14 14:03:30 -04:00

improvement_proposals.py

feat: add improvement proposal generator (#168)

2026-04-15 14:47:26 +00:00

knowledge_gap_identifier.py

feat: knowledge gap identifier — Pipeline 10.7 (#172)

2026-04-15 14:42:28 +00:00

knowledge_staleness_check.py

feat: Add knowledge staleness detector (closes #179)

2026-04-15 04:00:12 +00:00

perf_bottleneck_finder.py

feat: add Performance Bottleneck Finder (#171)

2026-04-15 14:47:27 +00:00

priority_rebalancer.py

feat: Priority Rebalancer — re-score issues from pipeline data (#174)

2026-04-15 10:52:51 -04:00

readme_generator.py

feat(scripts): add readme_generator — auto-generate README from codebase

2026-04-26 00:20:11 -04:00

refactoring_opportunity_finder.py

feat: Add refactoring opportunity finder (#169)

2026-04-15 10:54:58 -04:00

sampler.py

feat: add sampler.py — session value scorer (#17)

2026-04-15 03:02:12 +00:00

session_metadata.py

feat: add session_metadata.py — structured session metadata extractor (#6)

2026-04-14 19:06:16 +00:00

session_pair_harvester.py

feat: session transcript → training pair harvester (#91)

2026-04-15 03:39:08 +00:00

session_reader.py

feat: add harvester.py — session knowledge extractor (#8)

2026-04-14 14:03:30 -04:00

test_automation_opportunity_finder.py

test: automation opportunity finder tests (#170)

2026-04-15 14:53:43 +00:00

test_bootstrapper.py

feat: build bootstrapper.py - pre-session context assembler

2026-04-14 14:05:30 -04:00

test_diff_analyzer.py

feat: Add diff analyzer tests (closes #176)

2026-04-15 03:57:21 +00:00

test_gitea_issue_parser.py

feat: Add parser tests (closes #177)

2026-04-15 03:50:04 +00:00

test_harvest_prompt_comprehensive.py

Add comprehensive test script for harvest prompt validation

2026-04-14 19:02:41 +00:00

test_harvest_prompt.py

feat: build bootstrapper.py - pre-session context assembler

2026-04-14 14:05:30 -04:00

test_harvester_pipeline.py

feat: add harvester.py — session knowledge extractor (#8)

2026-04-14 14:03:30 -04:00

test_improvement_proposals.py

test: add improvement proposal generator tests (#168)

2026-04-15 14:47:30 +00:00

test_knowledge_staleness.py

feat: Add staleness detector tests (closes #179)

2026-04-15 04:00:46 +00:00

test_priority_rebalancer.py

feat: Priority Rebalancer — re-score issues from pipeline data (#174)

2026-04-15 10:52:51 -04:00

test_refactoring_opportunity_finder.py

feat: Add refactoring opportunity finder (#169)

2026-04-15 10:54:58 -04:00

test_session_pair_harvester.py

test: add tests for session pair harvester (#91)

2026-04-15 03:39:09 +00:00

validate_knowledge.py

feat(#10): knowledge file format schema + example knowledge files

2026-04-14 14:21:21 -04:00