145 lines
11 KiB
Markdown
145 lines
11 KiB
Markdown
# GENOME.md — Timmy_Foundation/timmy-home
|
|
|
|
Generated by `pipelines/codebase_genome.py`.
|
|
|
|
## Project Overview
|
|
|
|
Timmy Foundation's home repository for development operations and configurations.
|
|
|
|
- Text files indexed: 3133
|
|
- Source and script files: 219
|
|
- Test files: 73
|
|
- Documentation files: 743
|
|
|
|
## Architecture
|
|
|
|
```mermaid
|
|
graph TD
|
|
repo_root["repo"]
|
|
angband["angband"]
|
|
ansible["ansible"]
|
|
briefings["briefings"]
|
|
codebase_genome["codebase_genome"]
|
|
config["config"]
|
|
configs["configs"]
|
|
conftest["conftest"]
|
|
dns_records["dns-records"]
|
|
evennia["evennia"]
|
|
evennia_tools["evennia_tools"]
|
|
repo_root --> angband
|
|
repo_root --> ansible
|
|
repo_root --> briefings
|
|
repo_root --> codebase_genome
|
|
repo_root --> config
|
|
repo_root --> configs
|
|
```
|
|
|
|
## Entry Points
|
|
|
|
- `codebase_genome.py` — python main guard (`python3 codebase_genome.py`)
|
|
- `gemini-fallback-setup.sh` — operational script (`bash gemini-fallback-setup.sh`)
|
|
- `morrowind/hud.sh` — operational script (`bash morrowind/hud.sh`)
|
|
- `pipelines/codebase_genome.py` — python main guard (`python3 pipelines/codebase_genome.py`)
|
|
- `scripts/agent_pr_gate.py` — operational script (`python3 scripts/agent_pr_gate.py`)
|
|
- `scripts/auto_restart_agent.sh` — operational script (`bash scripts/auto_restart_agent.sh`)
|
|
- `scripts/autonomous_issue_creator.py` — operational script (`python3 scripts/autonomous_issue_creator.py`)
|
|
- `scripts/backlog_cleanup.py` — operational script (`python3 scripts/backlog_cleanup.py`)
|
|
- `scripts/backlog_triage.py` — operational script (`python3 scripts/backlog_triage.py`)
|
|
- `scripts/backlog_triage_cron.sh` — operational script (`bash scripts/backlog_triage_cron.sh`)
|
|
- `scripts/backup_pipeline.sh` — operational script (`bash scripts/backup_pipeline.sh`)
|
|
- `scripts/bezalel_gemma4_vps.py` — operational script (`python3 scripts/bezalel_gemma4_vps.py`)
|
|
|
|
## Data Flow
|
|
|
|
1. Operators enter through `codebase_genome.py`, `gemini-fallback-setup.sh`, `morrowind/hud.sh`.
|
|
2. Core logic fans into top-level components: `angband`, `ansible`, `briefings`, `codebase_genome`, `config`, `configs`.
|
|
3. Validation is incomplete around `wizards/allegro/home/skills/red-teaming/godmode/scripts/auto_jailbreak.py`, `timmy-local/cache/agent_cache.py`, `wizards/allegro/home/skills/red-teaming/godmode/scripts/parseltongue.py`, so changes there carry regression risk.
|
|
4. Final artifacts land as repository files, docs, or runtime side effects depending on the selected entry point.
|
|
|
|
## Key Abstractions
|
|
|
|
- `codebase_genome.py` — classes `FunctionInfo`:19; functions `extract_functions()`:58, `generate_test()`:116, `scan_repo()`:191, `find_existing_tests()`:209, `main()`:231
|
|
- `evennia/timmy_world/game.py` — classes `World`:91, `ActionSystem`:421, `TimmyAI`:539, `NPCAI`:550; functions `get_narrative_phase()`:55, `get_phase_transition_event()`:65
|
|
- `evennia/timmy_world/world/game.py` — classes `World`:19, `ActionSystem`:326, `TimmyAI`:444, `NPCAI`:455; functions none detected
|
|
- `timmy-world/game.py` — classes `World`:19, `ActionSystem`:349, `TimmyAI`:467, `NPCAI`:478; functions none detected
|
|
- `wizards/allegro/home/skills/red-teaming/godmode/scripts/auto_jailbreak.py` — classes none detected; functions none detected
|
|
- `uniwizard/self_grader.py` — classes `SessionGrade`:23, `WeeklyReport`:55, `SelfGrader`:74; functions `main()`:713
|
|
- `uni-wizard/v3/intelligence_engine.py` — classes `ExecutionPattern`:27, `ModelPerformance`:44, `AdaptationEvent`:58, `PatternDatabase`:69; functions none detected
|
|
- `scripts/know_thy_father/crossref_audit.py` — classes `ThemeCategory`:30, `Principle`:160, `MeaningKernel`:169, `CrossRefFinding`:178; functions `extract_themes_from_text()`:192, `parse_soul_md()`:206, `parse_kernels()`:264, `cross_reference()`:296, `generate_report()`:440, `main()`:561
|
|
|
|
## API Surface
|
|
|
|
- CLI: `python3 codebase_genome.py` — python main guard (`codebase_genome.py`)
|
|
- CLI: `bash gemini-fallback-setup.sh` — operational script (`gemini-fallback-setup.sh`)
|
|
- CLI: `bash morrowind/hud.sh` — operational script (`morrowind/hud.sh`)
|
|
- CLI: `python3 pipelines/codebase_genome.py` — python main guard (`pipelines/codebase_genome.py`)
|
|
- CLI: `python3 scripts/agent_pr_gate.py` — operational script (`scripts/agent_pr_gate.py`)
|
|
- CLI: `bash scripts/auto_restart_agent.sh` — operational script (`scripts/auto_restart_agent.sh`)
|
|
- CLI: `python3 scripts/autonomous_issue_creator.py` — operational script (`scripts/autonomous_issue_creator.py`)
|
|
- CLI: `python3 scripts/backlog_cleanup.py` — operational script (`scripts/backlog_cleanup.py`)
|
|
- Python: `extract_functions()` from `codebase_genome.py:58`
|
|
- Python: `generate_test()` from `codebase_genome.py:116`
|
|
- Python: `scan_repo()` from `codebase_genome.py:191`
|
|
- Python: `find_existing_tests()` from `codebase_genome.py:209`
|
|
- Python: `main()` from `codebase_genome.py:231`
|
|
- Python: `get_narrative_phase()` from `evennia/timmy_world/game.py:55`
|
|
|
|
## Test Coverage Report
|
|
|
|
- Source and script files inspected: 219
|
|
- Test files inspected: 73
|
|
- Coverage gaps:
|
|
- `wizards/allegro/home/skills/red-teaming/godmode/scripts/auto_jailbreak.py` — no matching test reference detected
|
|
- `timmy-local/cache/agent_cache.py` — no matching test reference detected
|
|
- `wizards/allegro/home/skills/red-teaming/godmode/scripts/parseltongue.py` — no matching test reference detected
|
|
- `wizards/allegro/home/skills/red-teaming/godmode/scripts/godmode_race.py` — no matching test reference detected
|
|
- `skills/productivity/google-workspace/scripts/google_api.py` — no matching test reference detected
|
|
- `wizards/allegro/home/skills/productivity/google-workspace/scripts/google_api.py` — no matching test reference detected
|
|
- `morrowind/pilot.py` — no matching test reference detected
|
|
- `skills/research/domain-intel/scripts/domain_intel.py` — no matching test reference detected
|
|
- `wizards/allegro/home/skills/research/domain-intel/scripts/domain_intel.py` — no matching test reference detected
|
|
- `timmy-local/scripts/ingest.py` — no matching test reference detected
|
|
- `uni-wizard/scripts/generate_scorecard.py` — no matching test reference detected
|
|
- `morrowind/local_brain.py` — no matching test reference detected
|
|
|
|
## Security Audit Findings
|
|
|
|
- [medium] `briefings/briefing_20260325.json:37` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `"gitea_error": "Gitea 404: {\"errors\":null,\"message\":\"not found\",\"url\":\"http://143.198.27.163:3000/api/swagger\"}\n [http://143.198.27.163:3000/api/v1/repos/Timmy_Foundation/sovereign-orchestration/issues?state=open&type=issues&sort=created&direction=desc&limit=1&page=1]",`
|
|
- [medium] `briefings/briefing_20260328.json:11` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `"provider_base_url": "http://localhost:8081/v1",`
|
|
- [medium] `briefings/briefing_20260329.json:11` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `"provider_base_url": "http://localhost:8081/v1",`
|
|
- [medium] `config.yaml:37` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `summary_base_url: http://localhost:11434/v1`
|
|
- [medium] `config.yaml:47` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: 'http://localhost:11434/v1'`
|
|
- [medium] `config.yaml:52` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: 'http://localhost:11434/v1'`
|
|
- [medium] `config.yaml:57` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: 'http://localhost:11434/v1'`
|
|
- [medium] `config.yaml:62` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: 'http://localhost:11434/v1'`
|
|
- [medium] `config.yaml:67` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: 'http://localhost:11434/v1'`
|
|
- [medium] `config.yaml:77` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: 'http://localhost:11434/v1'`
|
|
- [medium] `config.yaml:82` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: 'http://localhost:11434/v1'`
|
|
- [medium] `config.yaml:174` — hardcoded http endpoint: plaintext or fixed HTTP endpoints can drift or leak across environments. Evidence: `base_url: http://localhost:11434/v1`
|
|
|
|
## Dead Code Candidates
|
|
|
|
- `wizards/allegro/home/skills/red-teaming/godmode/scripts/auto_jailbreak.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `timmy-local/cache/agent_cache.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `wizards/allegro/home/skills/red-teaming/godmode/scripts/parseltongue.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `wizards/allegro/home/skills/red-teaming/godmode/scripts/godmode_race.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `skills/productivity/google-workspace/scripts/google_api.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `wizards/allegro/home/skills/productivity/google-workspace/scripts/google_api.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `morrowind/pilot.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `skills/research/domain-intel/scripts/domain_intel.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `wizards/allegro/home/skills/research/domain-intel/scripts/domain_intel.py` — not imported by indexed Python modules and not referenced by tests
|
|
- `timmy-local/scripts/ingest.py` — not imported by indexed Python modules and not referenced by tests
|
|
|
|
## Performance Bottleneck Analysis
|
|
|
|
- `angband/mcp_server.py` — large module (353 lines) likely hides multiple responsibilities
|
|
- `evennia/timmy_world/game.py` — large module (1541 lines) likely hides multiple responsibilities
|
|
- `evennia/timmy_world/world/game.py` — large module (1345 lines) likely hides multiple responsibilities
|
|
- `morrowind/mcp_server.py` — large module (451 lines) likely hides multiple responsibilities
|
|
- `morrowind/pilot.py` — large module (459 lines) likely hides multiple responsibilities
|
|
- `pipelines/codebase_genome.py` — large module (557 lines) likely hides multiple responsibilities
|
|
- `scripts/know_thy_father/crossref_audit.py` — large module (657 lines) likely hides multiple responsibilities
|
|
- `scripts/know_thy_father/index_media.py` — large module (405 lines) likely hides multiple responsibilities
|
|
- `scripts/know_thy_father/synthesize_kernels.py` — large module (416 lines) likely hides multiple responsibilities
|
|
- `scripts/predictive_resource_allocator.py` — large module (410 lines) likely hides multiple responsibilities
|