mrs-core 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

mrs/phases.py

@@ -1,3 +1,7 @@
+# phases.py — MRS-Core
+# Defines legal phase transitions and validation logic.
+
+# Phase transition map for strict reasoning flow
 PHASE_FLOW = {
     "start": "transform",
     "transform": "reflect",
@@ -8,8 +12,39 @@ PHASE_FLOW = {
     "done": "done",
 }
 
-def validate_phase(operator_name, current_phase):
-    return None  # permissive for now
 
 def next_phase(operator_name, current_phase):
+    """
+    Given the current phase, return the next allowed phase.
+    Engine.py requires this — do NOT remove.
+    """
     return PHASE_FLOW.get(current_phase, "done")
+
+
+# Legal phase definitions for each operator
+LEGAL_PHASES = {
+    "transform": ["start"],
+    "reflect": ["transform"],
+    "evaluate": ["reflect"],
+    "rewrite": ["evaluate"],
+    "summarize": ["rewrite"],
+    # Inspect & filter are utility ops usable later in the chain
+    "inspect": ["evaluate", "rewrite", "summarize"],
+    "filter": ["evaluate", "rewrite", "summarize"],
+}
+
+
+def validate_phase(operator_name, current_phase):
+    """
+    Return an error string if operator is used in an illegal phase.
+    Return None if legal.
+
+    Engine.py expects:
+        - None = OK
+        - String = violation
+    """
+    allowed = LEGAL_PHASES.get(operator_name, [])
+    if current_phase not in allowed:
+        return f"Operator '{operator_name}' not allowed in phase '{current_phase}'"
+    return None
+

{mrs_core-0.1.2.dist-info → mrs_core-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mrs-core
-Version: 0.1.2
+Version: 0.1.4
 Summary: MRS-Core: A deterministic modular reasoning engine.
 Author: Ryan Sabouhi
 License: Apache-2.0
@@ -81,7 +81,7 @@ MRS records:
 - Each operator is a small Python class registered via the Operator Registry.
 
 ### Drop-In Presets  
-`simple`, `reasoning`, `full_chain`  ready for production use.
+`simple`, `reasoning`, `full_chain` presets included for immediate use and extension.
 
 ---
 
@@ -112,12 +112,19 @@ print(result["phase"])
 
 # Example Output
 ```bash 
-[REFLECT] [TRANSFORM]
-MRS-CORE IS A MODULAR DETERMINISTIC REASONING PIPELINE.
-
-[EVAL CHARS=95 WORDS=14]
-
-PHASE: rewrite
+FINAL TEXT:
+[REFLECT] [TRANSFORM] THIS IS A TEST OF MRS-CORE.
+[EVAL CHARS=49 WORDS=8]
+
+LOG:
+- Transform applied
+- [PHASE] start → transform
+- Reflect applied
+- [PHASE] transform → reflect
+- Evaluate applied
+- [PHASE] reflect → evaluate
+- Rewrite applied
+- [PHASE] evaluate → rewrite
 ```
 ---
 
@@ -160,6 +167,11 @@ for name in ["simple", "reasoning", "full_chain"]:
     print(f"=== {name.upper()} ===")
     print(result["text"])
 ```
+
+Note: Presets are *example chains*, not semantic models.
+Operators are deterministic components; their meaning depends on the chain design. 
+`full_chain` is intentionally simple and does not represent a cognitive process.
+
 ---
 
 # Operator Anatomy
@@ -168,7 +180,7 @@ for name in ["simple", "reasoning", "full_chain"]:
 - receives the current ReasoningState
 - modifies state.text
 - appends to state.log
-- updates state.phase
+- engine updates state.phase automatically based on the operator's phase transition rules
 - records an entry in state.history
 
 ### Example:
@@ -177,7 +189,7 @@ for name in ["simple", "reasoning", "full_chain"]:
 class ReflectOperator(Operator):
     phase = ("transform", "reflect")
 
-    def run(self, state):
+    def run(self, state, **kwags):
         state.text = f"[REFLECT] {state.text}"
         state.log.append("Reflect applied")
         return state

{mrs_core-0.1.2.dist-info → mrs_core-0.1.4.dist-info}/RECORD

@@ -2,7 +2,7 @@ mrs/__init__.py,sha256=WoQ9QtnmAbFUsLWuXUTxwpBYm0LS9XBQOcZGPpbV4cs,844
 mrs/diagnostics.py,sha256=zbAp0iM6Gko5R4Z2Yb8HKaesUuy-b21cwgxsUIjKM8I,606
 mrs/engine.py,sha256=dYaGZkeuz1YHc-q-PG48TJ6est0OAX5SpmdD-J_zIIU,1365
 mrs/exceptions.py,sha256=zTplNq6HbVzaZmIhJPOGUvuqQmE9rqprDzZRiJYxDQs,242
-mrs/phases.py,sha256=1RVVCJSfxGSYXBg8CRyhOKlvRFflDJWdZ_3Yco_aefc,398
+mrs/phases.py,sha256=caqEwMLQrDE0e9VUrpPbDFXZboEgWsa4v6RtF_v5tNU,1403
 mrs/pipeline.py,sha256=8pIWEGOt9O42pxdwsYC3UsWSQFqT46rRLsHM-n8xR5A,288
 mrs/presets.py,sha256=tBKDBwX-PTRoIfjV4xGX1Wng12zsH42mHQ4DFunY5cc,698
 mrs/registry.py,sha256=cOO5E0W5i2qRdwK4W-lKGHyi_LlEoaPSEL8cBOWyWTw,465
@@ -16,9 +16,9 @@ mrs/operators/reflect.py,sha256=stlm4eeWRo50IQ1CAFB1Pk0KAkRRsGNTRFPJL9-huxo,299
 mrs/operators/rewrite.py,sha256=UyyhkYeq1c1916Izh47YltjLJ-LRaYIP8Rw_ZfwXsyo,347
 mrs/operators/summarize.py,sha256=Q-cMvU7Iu48kKi1RbggqItHSFqS6LFqf-qKJ5rlyenU,354
 mrs/operators/transform.py,sha256=g5Aq2LeziG1Xeqncz053Xmv1SCS_d9Fq_Zsriiebd8A,368
-mrs_core-0.1.2.dist-info/licenses/LICENSE,sha256=YhxJr-lCiJMIQLkwOsqof2ZhAr6cOMOnzKX_qOGWIwE,11489
-mrs_core-0.1.2.dist-info/licenses/NOTICE,sha256=Gh8CDLuJ2Jgixu3sQ9PgTQv4nTLyNozncfw0wW3hl9U,132
-mrs_core-0.1.2.dist-info/METADATA,sha256=KFcQNAcjdyxxBS0PTtALZodahejlcXbs0lvWWhU6Egg,5566
-mrs_core-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mrs_core-0.1.2.dist-info/top_level.txt,sha256=u-QA32S-jnY2FEXu4JwnPAZGDQdlPyQg2aCXHDAIjwY,4
-mrs_core-0.1.2.dist-info/RECORD,,
+mrs_core-0.1.4.dist-info/licenses/LICENSE,sha256=YhxJr-lCiJMIQLkwOsqof2ZhAr6cOMOnzKX_qOGWIwE,11489
+mrs_core-0.1.4.dist-info/licenses/NOTICE,sha256=Gh8CDLuJ2Jgixu3sQ9PgTQv4nTLyNozncfw0wW3hl9U,132
+mrs_core-0.1.4.dist-info/METADATA,sha256=xDB7TmPl0GjDNt_DD7IG1l81cxWtSXkw1Dp4We4mw7Q,6073
+mrs_core-0.1.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mrs_core-0.1.4.dist-info/top_level.txt,sha256=u-QA32S-jnY2FEXu4JwnPAZGDQdlPyQg2aCXHDAIjwY,4
+mrs_core-0.1.4.dist-info/RECORD,,