Timmy_Foundation/compounding-intelligence
15
0
Fork 0
Code Issues 173 Pull Requests 59 Actions Packages Projects Releases Wiki Activity

feat: add knowledge gap identifier for code/docs/tests cross-reference (#172) #182

Closed
Rockachopa wants to merge 1 commits from burn/172-1776218600 into main
pull from: burn/172-1776218600
merge into: Timmy_Foundation:main
Conversation 2 Commits 1 Files Changed 2 +416
Rockachopa commented 2026-04-15 03:47:39 +00:00
Owner
Copy Link

Closes #172.

Pipeline 10.7 — Knowledge Gap Identifier: cross-references code, docs, and tests to find gaps.

What it finds:

  • Undocumented: functions/classes in source not mentioned in any .md doc
  • Untested: source modules without a corresponding test file
  • Missing Implementation: symbols referenced in docs but not found in source
  • Orphan Tests: test files without a matching source module

API:

from knowledge_gap_identifier import KnowledgeGapIdentifier
report = KnowledgeGapIdentifier().analyze("/path/to/repo")
print(report.summary())      # Human-readable
print(report.to_dict())      # JSON-serializable

Gap types with severity:

  • UNDOCUMENTED (warning): public symbol not in any doc
  • UNTESTED (error): source module with no test file
  • MISSING_IMPLEMENTATION (info): doc references non-existent code
  • ORPHAN_TEST (warning): test file without matching source

Design:

  • AST-based symbol extraction (Python)
  • Markdown backtick/heading parsing for doc references
  • Private symbols (_name) skipped
  • Config files (setup.py, conftest.py) excluded
  • Test files not flagged as undocumented source

Tests: 10 tests covering all gap types, positive/negative cases, edge cases (empty repo, invalid path, private symbols).

Verification:

  • python3 tests/test_knowledge_gap_identifier.py (10/10 pass)
  • python3 -m pytest tests/test_knowledge_gap_identifier.py -v (10/10 pass)
Closes #172. Pipeline 10.7 — Knowledge Gap Identifier: cross-references code, docs, and tests to find gaps. **What it finds:** - **Undocumented**: functions/classes in source not mentioned in any .md doc - **Untested**: source modules without a corresponding test file - **Missing Implementation**: symbols referenced in docs but not found in source - **Orphan Tests**: test files without a matching source module **API:** ```python from knowledge_gap_identifier import KnowledgeGapIdentifier report = KnowledgeGapIdentifier().analyze("/path/to/repo") print(report.summary()) # Human-readable print(report.to_dict()) # JSON-serializable ``` **Gap types with severity:** - `UNDOCUMENTED` (warning): public symbol not in any doc - `UNTESTED` (error): source module with no test file - `MISSING_IMPLEMENTATION` (info): doc references non-existent code - `ORPHAN_TEST` (warning): test file without matching source **Design:** - AST-based symbol extraction (Python) - Markdown backtick/heading parsing for doc references - Private symbols (`_name`) skipped - Config files (setup.py, conftest.py) excluded - Test files not flagged as undocumented source **Tests:** 10 tests covering all gap types, positive/negative cases, edge cases (empty repo, invalid path, private symbols). **Verification:** - `python3 tests/test_knowledge_gap_identifier.py` (10/10 pass) - `python3 -m pytest tests/test_knowledge_gap_identifier.py -v` (10/10 pass)
Rockachopa added 1 commit 2026-04-15 03:47:40 +00:00
feat: add knowledge gap identifier for code/docs/tests cross-reference (closes #172) 566ba3eace
Timmy approved these changes 2026-04-15 04:13:16 +00:00
Timmy left a comment
Owner
Copy Link

Feature implementation reviewed - looks solid.

Scope: 2 file(s) changed (416+ / 0-)

Suggestions

  • Found 1 TODO/FIXME/HACK comment(s) - consider creating issues for tracking.
Feature implementation reviewed - looks solid. **Scope**: 2 file(s) changed (416+ / 0-) ### Suggestions - Found 1 TODO/FIXME/HACK comment(s) - consider creating issues for tracking.
Rockachopa commented 2026-04-15 14:43:17 +00:00
Author
Owner
Copy Link

Superseded by burn/172-1776263893.

Superseded by burn/172-1776263893.
Rockachopa closed this pull request 2026-04-15 14:43:18 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
Reviewers
No Reviewers
Timmy
Labels
Clear labels
acceptance-criteria
batch-pipeline
Token masterplan batch pipeline
 bootstrapper
Pre-session context injection
 epic
Epic-level issue
 harvester
Session knowledge extraction
 measurer
Compounding metrics
 milestone:1
Milestone 1: Foundation
 milestone:2
Milestone 2: Integration
 milestone:3
Milestone 3: Measurement
 milestone:4
Milestone 4: Retroactive
 pipeline
Pipeline/integration work
 pipeline
priority:high
priority:medium
retroactive
Processing existing sessions
 throughput-10x
throughput-10x label
 token-masterplan
token-masterplan label
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Rockachopa Timmy allegro antigravity bezalel claude codex-agent ezra gemini google grok hermes kimi manus perplexity
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/compounding-intelligence#182
Delete Branch "burn/172-1776218600"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?