_iASrSSKrSSKrSSKrSSKrSSKJr SSKJr SSKJ r J r J r J r \"S5r \ S- S- r\ S- S - r\S - r\ S - r\ S - S - S- rSr/SQr"SS5r\S:XGaSSKr\R0"SS9r\R5S\SS9 \R5S\SSS9 \R5S\SSS9 \R5S S!S"S#9 \R95r\"5r\R>(a&\ "\RB"\RE5S$S%95 g\RF(aS\RI\RJ\RL\RFS&.5r'\ "\RB"\'S$S%95 \ "S'5 g\ "S(5 \ "S)5 gg)*uB GENESIS EVOLUTION ENGINE ========================= Implements RULE 14: Failure Is Our Greatest Ally. Every failure that enters this engine is processed through the full 4-step Evolution Protocol: Step 1: DIAGNOSE — What happened, exactly? Step 2: ROOT CAUSE — Why? (5-Why analysis) Step 3: PRE-MORTEM — Guardrail to prevent recurrence Step 4: EVOLVE — Write to KG, axioms, CLAUDE.md, GLOBAL_GENESIS_RULES.md Also implements: - TITAN MEMORY updates (CLAUDE.md Titan Memory section) - RLM Worker pattern (watchful, associative, insatiable, fast) - Failure log persistence to KNOWLEDGE_GRAPH/entities/failure_evolution_log.jsonl - Axiom generation to KNOWLEDGE_GRAPH/axioms/ Usage: from core.evolution_engine import EvolutionEngine engine = EvolutionEngine() engine.process_failure({ "project": "receptionistai", "task": "RAI-003", "what": "Telnyx API returned 422 on assistant clone", "root_cause": "" }) # Also callable from CLI: python core/evolution_engine.py --failure "Gemini rate limit exceeded" N)datetime)Path)DictListOptionalAnyzE:/genesis-systemKNOWLEDGE_GRAPHentitiesaxiomszfailure_evolution_log.jsonlz CLAUDE.mdz.clauderuleszGLOBAL_GENESIS_RULES.mdg?) receptionistaiaivasunaivarevenueclienttelnyxstripeghlvoice productionc|\rSrSrSrSrS\\\4S\\\44Sjr S\S\4Sjr S\S\4Sjr S\S\4S jr S\4S jr S\S\4S jrS\S\4S jrS \S\4SjrS \S\S\\4SjrS \S\S\4SjrS \S\4SjrS\S\4SjrS\4SjrS\4SjrS\S\4SjrS\4SjrS\\S\\4SjrS\4SjrSrg)EvolutionEngine=a Processes failures and surprises through the Genesis Evolution Protocol. This is the LEARNING brain of Genesis. Every failure makes Genesis smarter. The engine: 1. Diagnoses failures with structured analysis 2. Performs 5-Why root cause analysis 3. Designs guardrails to prevent recurrence 4. Writes findings to the living knowledge base 5. Updates TITAN MEMORY in CLAUDE.md 6. Generates axioms for the RLM bloodstream RULE 14 compliance is mandatory. This engine is NOT optional. cp[RSSS9 [RSSS9 SUlSUlg)NT)parentsexist_okr)KG_ENTITIES_PATHmkdirKG_AXIOMS_PATHfailures_processedaxioms_generated)selfs *E:\genesis-system\core\evolution_engine.py__init__EvolutionEngine.__init__Ms8td;TD9"# !failurereturncURU5nURU5nURU5nURU5 U=RS- slU$)z Main entry point. Process a failure through all 4 evolution steps. Args: failure: Dict with keys: project, task, what, root_cause (optional) Returns: Enriched failure dict with diagnosis, guardrail, axiom )_step1_diagnose_step2_root_cause_step3_premortem _step4_evolver r"r's r#process_failureEvolutionEngine.process_failureSs^&&w/((1''0 7# 1$r&cURSS[[R"5535 URS[R"5R S55 URS[R"5R 55 URSS5 URSS5 URS S 5 URU5US 'URU5US 'U$) z&Step 1: Clarify exactly what happened.idfailure_date%Y-%m-%d timestampprojectunknowntaskwhatzUnspecified failureseveritysurprise_score) setdefaultinttimernowstrftime isoformat_score_severity_score_surpriser/s r#r+EvolutionEngine._step1_diagnosels48C ,<+=!>?68<<>#:#::#FG; (@(@(BC9i069-6#89#227; $($8$8$A !r&cURSS5R5nURSS5nU(aUS:XaURU5nX1S'URX#5US'U$)z:Step 2: 5-Why root cause analysis (rule-based heuristics).r; root_causezNot yet determined five_whys)getlower_infer_root_cause_build_five_whys)r"r'r;rIs r#r,!EvolutionEngine._step2_root_cause{sj{{62&,,.[[r2 Z+??//5J * #44TF r&cURSS5R5nURSS5R5nURX#5nXAS'SURU5SUR53US'U$)z6Step 3: Design the guardrail that prevents recurrence.r;rHrIguardrail_addedzBefore z , always never_again)rKrL_design_guardrail_extract_action)r"r'r;rI guardrails r#r- EvolutionEngine._step3_premortems{{62&,,.[[r288: **4< %.!"d**4019??;L:M N  r&cURU5 URU5 URU5nURX!5 UR SS5S;aUR U5 gg)z.Step 4: Write failure to all knowledge stores.r<low)highcriticalN)_write_failure_log_write_kg_entity_generate_axiom _write_axiomrK_update_titan_memory)r"r'axioms r#r.EvolutionEngine._step4_evolvesl ( g&$$W- %) ;;z5 )-A A  % %g . Br&c2^^URSS5R5mURSS5R5m[U4Sj[55(a[U4SjS55(agg[U4S jS 55(ag g ) z7Score failure severity: low / medium / high / critical.r;rHr8c3,># UH oT;v M g7fN).0domainr8s r# 2EvolutionEngine._score_severity..sC/BV /Bc3,># UH oT;v M g7frdrerfkwr;s r#rhrisg(f":(frj)z data losszproduction downrrcrashrZrYc3,># UH oT;v M g7frdrerls r#rhrisV$UbTz$Urj)errorfail exceptionrnbrokenmediumrX)rKrLanyHIGH_STAKES_DOMAINS)r"r'r8r;s @@r#rDEvolutionEngine._score_severitysw{{62&,,.++i,224 C/BC C Cg(fggg! V$UV V Vr&c^URSS5R5m[U4SjS55(ag[U4SjS55(agg ) z Score how surprising this failure is (0.0 - 1.0). Higher = more surprising = more learning value. RLM workers activate on score >= SURPRISE_THRESHOLD (0.50). r;rHc3,># UH oT;v M g7frdrerls r#rh2EvolutionEngine._score_surprise..si$hbTz$hrj) unexpectedz should havethoughtassumedz worked before333333?c3,># UH oT;v M g7frdrerls r#rhrzsb$abTz$arj) rate limittimeoutauth permission404422g333333?gffffff?)rKrLru)r"r'r;s @r#rEEvolutionEngine._score_surprisesQ {{62&,,. i$hi i i b$ab b br&r;c ^/SQS4/SQS4/SQS4/SQS4/S QS 4/S QS 4/S QS4/SQS4/SQS4/SQS4/ nUH#up4[U4SjU55(dM!Us $ g)z9Rule-based root cause inference from failure description.)r429quotaz0API rate limits not pre-checked before execution)r401403r unauthorizedz1Authentication state not verified before API call)rzconnection refusednetworkz3Network/connectivity not validated before operation)r not foundmissingz#Resource existence not pre-verified)rinvalid validationz=Input data not validated against API schema before submission)importzmodule not foundz no modulez/Dependency not installed or path not configured)c: drivezc:\z disk fullspaceu6C: drive used instead of E: drive — RULE 6 violation)sqlitez.db filesqlite3u;SQLite used instead of Elestio storage — RULE 7 violation) asked kinanz manual stepz human neededu@Automation not attempted before escalating — RULE 11 violation) assumptionr}guesseduDDecision made without research — RULE 8 (Research-First) violationc3,># UH oT;v M g7frdrerls r#rh4EvolutionEngine._infer_root_cause..s1":rjuCSystemic gap not yet categorized — requires manual 5-Why analysisru)r"r;patternskeywordscauses ` r#rM!EvolutionEngine._infer_root_causes,-_ ` ACv w 9;p q ,.S T -/n o 8:k l 79q r .0m n ;= A 13y z   (OH1111  (Ur&rIc"SUSS3SU3SSS/$)zGenerate the 5-Why chain.uWhy did this fail? — NduWhy did that happen? — uNWhy was that gap present? — No pre-execution check existed for this scenariouSWhy was no check present? — Rule not yet codified or enforcement mechanism absentuQWhy was the rule absent? — This failure pattern had not been encountered beforere)r"r;rIs r#rN EvolutionEngine._build_five_whyss1&d4Cj\ 2' | 4 \ a _   r&c ^^/SQS4/SQS4SS/S4SS /S 4S S /S 4SS/S4S/S4SS/S4SS/S4/ nUH$upE[UU4SjU55(dM"Us $ g)z2Design a specific guardrail to prevent recurrence.)rrrz:Check rate limit capacity before submitting batch requests)rrrzEVerify authentication token is valid and non-expired before API callsrrzPre-verify resource existence with GET before PUT/PATCH/DELETErrz5Validate payload against API schema before submissionrdiskzAAssert working directory starts with E: before any file operationru?Grep for 'import sqlite3' before commit — fail build if foundrmanualz7Run browser automation check before escalating to Kinanrr}z6Locate and read research files before writing any codec3D># UHoT;=(d UT;v M g7frdre)rfrmrIr;s r#rh4EvolutionEngine._design_guardrail..s EHb:1z!11Hs zMAdd pre-execution verification step and automated test to detect this patternr)r"r;rI guardrail_maprrUs `` r#rS!EvolutionEngine._design_guardrails,-i j #%l m #%c d5 !#c d\ "$[ \& !#f gZZ [X &(a bI &(` a  $1 HEHEEE  $1_r&c0/SQnUH nX1;dM Us $ g)zJExtract the verb/action from failure description for the never_again rule.)calling submittingwritingreading executingrunning deployingrre)r"r; action_wordswords r#rTEvolutionEngine._extract_actions k  D| !r&c URSS5nURSS5nSUR5SUSURSS 5S S S URS 5S3 $)z/Generate a single crisp axiom from the failure.rQverify before actingr8general[z ] Lesson: z. Root: rIr9NPz. Date: r5.)rKupper)r"r'rUr8s r#r]EvolutionEngine._generate_axiomsvKK 13IJ ++i3  9+6[[y9#2>?@[[() , r&c[[S5nUR[R"U5S-5 SSS5 g!,(df  g=f)z3Append failure to the master failure evolution log.a N)openFAILURE_LOG_PATHwritejsondumps)r"r'fs r#r["EvolutionEngine._write_failure_log s5 "C (A GGDJJw'$. /) ( (s )A AcV[R"5RS5n[SUS3- nSUSUR S5UR S5UR S5UR S 5UR S 5UR S 5UR S 5UR S 5UR S5UR S/5SS. n[ US5nUR [R"U5S-5 SSS5 g!,(df  g=f)zWrite failure as a KG entity.%Y_%m_%dfailure_evolution_.jsonl failure_eventr3r7r8r:r<r=r;rIrQrRrJevolution_engine_v1) entity_type entity_idr7r8r:r<r=r;rIrUrRrJ processed_byrrN) rrArBrrKrrrr)r"r'today entity_pathentityrs r#r\ EvolutionEngine._write_kg_entitys '' 3&+=eWF)KK *  [1{{9-KK' J/%kk*:;KK'!++l3 %67";;}5 ["51 +s #q GGDJJv&- .$ # #s ()D D( axiom_textc[R"5RS5n[SUS3- nUSUR S5UR S5S[R"5R 5S.n[ US 5nUR[R"U5S -5 S S S 5 U=RS - sl g !,(df  N$=f) z$Write axiom to the axioms directory.rfailure_axioms_revolution_enginer3r8r~)r`source failure_idr8 confidence created_atrrNr*) rrArBrrKrCrrrrr!)r"rr'r axiom_path axiom_entryrs r#r^EvolutionEngine._write_axiom$s '' 3#wf&EE (!++d+{{9-",,.224  *c "a GGDJJ{+d2 3# "# "s )C  Cc[R5(dgURSS5nURSS5nURS[R"5R S55nSUS US US 3n[ [S S S9nUR5nSSS5 SnUW;apURU5[U5-S-n XySRS5n USU S-U-S-XyS-n [ [SS S9nURU 5 SSS5 gg!,(df  N=f!,(df  g=f)zt Update the TITAN MEMORY section in CLAUDE.md with high-severity learnings. Only called for high/critical failures. Nr8systemrQrr5r6z- **z**: z ()rzutf-8)encodingz### Recent Learningsr*rw) CLAUDE_MD_PATHexistsrKrrArBrreadindexlensplitr) r"r' learning_tag learning_textdate_str new_learningrcontenttarget insert_poslinesupdateds r#r_$EvolutionEngine._update_titan_memory4sF $$&& {{9h7  $57MN ;;vx||~'>'>z'JKl^4 b !L .# 8AffhG9( W  v.V= SURPRISE_THRESHOLD. r=)rESURPRISE_THRESHOLDappend)r"r surpriseseventscores r#scan_for_surprises"EvolutionEngine.scan_for_surprisesUsP  E((/E**  !CE!C+;U!CDr&cSn[R5(a+[[S5n[SU55nSSS5 URUR U[ [S.$!,(df  N2=f)zReturn engine statistics.rrc3R# UHoR5(dMSv M g7f)r*N)strip)rflines r#rh,EvolutionEngine.get_stats..fs#D!$zz|AA!s' 'N)failures_processed_this_sessionaxioms_generated_this_sessiontotal_failures_in_logsurprise_thresholdhigh_stakes_domains)rrrsumr r!rrv)r" failure_countrs r# get_statsEvolutionEngine.get_statsash  " " $ $&, ##D!#D D -04/F/F-1-B-B%2"4#6   -,s A++ A9)r!r N)__name__ __module__ __qualname____firstlineno____doc__r$rstrrr0r+r,r-r.rDfloatrErMrrNrSrTr]r[r\r^r_rr __static_attributes__rer&r#rr=sq " tCH~$sCx.2 t    $    /T/ t  t&UcUcU* S c d3i _c_s_s_(CC t  0$0 //,#s#T# !D!B d T   4  r&r__main__zGenesis Evolution Engine) descriptionz --failurezFailure description to process)typehelpz --projectrz Project ID)rdefaultrz--taskrzTask IDz--stats store_truezShow engine stats)actionr)indent)r8r:r;z Axiom written. Genesis evolves.zTUsage: python evolution_engine.py --failure 'description' [--project id] [--task id]z) python evolution_engine.py --stats)(rrr@sysrerpathlibrtypingrrrr GENESIS_ROOTrrrrGLOBAL_RULES_PATHrrvrr argparseArgumentParserparser add_argumentr parse_argsargsenginestatsprintrr r'r0r8r:resultrer&r#r.sB ,,'( "33j@ 11H<#&CC + 9,w69RR q q h  z  $ $1K LF  #4TU  #y|T sH9M  ,=PQ    D  F zz djj))+A67 ''||IILL)   djj*+ 13 de 9:1r&