timmy-home/GENOME.md

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

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