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: 3133
• Source and script files: 219
• Test files: 73
• Documentation files: 743

Architecture

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