142 lines
11 KiB
Markdown
142 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: 3004
|
|
- Source and script files: 186
|
|
- Test files: 28
|
|
- Documentation files: 701
|
|
|
|
## Architecture
|
|
|
|
```mermaid
|
|
graph TD
|
|
repo_root["repo"]
|
|
angband["angband"]
|
|
briefings["briefings"]
|
|
config["config"]
|
|
conftest["conftest"]
|
|
evennia["evennia"]
|
|
evennia_tools["evennia_tools"]
|
|
evolution["evolution"]
|
|
gemini_fallback_setup["gemini-fallback-setup"]
|
|
heartbeat["heartbeat"]
|
|
infrastructure["infrastructure"]
|
|
repo_root --> angband
|
|
repo_root --> briefings
|
|
repo_root --> config
|
|
repo_root --> conftest
|
|
repo_root --> evennia
|
|
repo_root --> evennia_tools
|
|
```
|
|
|
|
## Entry Points
|
|
|
|
- `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/auto_restart_agent.sh` — operational script (`bash scripts/auto_restart_agent.sh`)
|
|
- `scripts/backup_pipeline.sh` — operational script (`bash scripts/backup_pipeline.sh`)
|
|
- `scripts/big_brain_manager.py` — operational script (`python3 scripts/big_brain_manager.py`)
|
|
- `scripts/big_brain_repo_audit.py` — operational script (`python3 scripts/big_brain_repo_audit.py`)
|
|
- `scripts/codebase_genome_nightly.py` — operational script (`python3 scripts/codebase_genome_nightly.py`)
|
|
- `scripts/detect_secrets.py` — operational script (`python3 scripts/detect_secrets.py`)
|
|
- `scripts/dynamic_dispatch_optimizer.py` — operational script (`python3 scripts/dynamic_dispatch_optimizer.py`)
|
|
- `scripts/emacs-fleet-bridge.py` — operational script (`python3 scripts/emacs-fleet-bridge.py`)
|
|
- `scripts/emacs-fleet-poll.sh` — operational script (`bash scripts/emacs-fleet-poll.sh`)
|
|
|
|
## Data Flow
|
|
|
|
1. Operators enter through `gemini-fallback-setup.sh`, `morrowind/hud.sh`, `pipelines/codebase_genome.py`.
|
|
2. Core logic fans into top-level components: `angband`, `briefings`, `config`, `conftest`, `evennia`, `evennia_tools`.
|
|
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
|
|
|
|
- `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
|
|
- `timmy-local/cache/agent_cache.py` — classes `CacheStats`:28, `LRUCache`:52, `ResponseCache`:94, `ToolCache`:205; functions none detected
|
|
|
|
## API Surface
|
|
|
|
- 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: `bash scripts/auto_restart_agent.sh` — operational script (`scripts/auto_restart_agent.sh`)
|
|
- CLI: `bash scripts/backup_pipeline.sh` — operational script (`scripts/backup_pipeline.sh`)
|
|
- CLI: `python3 scripts/big_brain_manager.py` — operational script (`scripts/big_brain_manager.py`)
|
|
- CLI: `python3 scripts/big_brain_repo_audit.py` — operational script (`scripts/big_brain_repo_audit.py`)
|
|
- CLI: `python3 scripts/codebase_genome_nightly.py` — operational script (`scripts/codebase_genome_nightly.py`)
|
|
- Python: `get_narrative_phase()` from `evennia/timmy_world/game.py:55`
|
|
- Python: `get_phase_transition_event()` from `evennia/timmy_world/game.py:65`
|
|
- Python: `main()` from `uniwizard/self_grader.py:713`
|
|
|
|
## Test Coverage Report
|
|
|
|
- Source and script files inspected: 186
|
|
- Test files inspected: 28
|
|
- 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
|
|
- `twitter-archive/multimodal_pipeline.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
|
|
- `morrowind/mcp_server.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
|
|
|
|
## 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
|
|
- `twitter-archive/multimodal_pipeline.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
|
|
- `morrowind/mcp_server.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
|
|
|
|
## 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/tower_game.py` — large module (395 lines) likely hides multiple responsibilities
|