mycorrhizal 0.1.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

mycorrhizal-0.2.0.dist-info/METADATA

@@ -0,0 +1,335 @@
+Metadata-Version: 2.4
+Name: mycorrhizal
+Version: 0.2.0
+Summary: Utilities and DSLs for modelling and implementing safe, performant, structured systems
+Author-email: Jeff Ciesielski <jeffciesielski@gmail.com>
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: typeguard==4.4.4
+Provides-Extra: docs
+Requires-Dist: mkdocs-literate-nav>=0.6.0; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
+Requires-Dist: mkdocs-section-index>=0.3.0; extra == 'docs'
+Requires-Dist: mkdocs-table-reader-plugin>=2.0.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.25.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# Mycorrhizal
+
+[![Tests](https://github.com/Jeff-Ciesielski/mycorrhizal/actions/workflows/test.yml/badge.svg)](https://github.com/Jeff-Ciesielski/mycorrhizal/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/Jeff-Ciesielski/mycorrhizal/branch/main/graph/badge.svg)](https://codecov.io/gh/Jeff-Ciesielski/mycorrhizal)
+[![Documentation Status](https://readthedocs.org/projects/mycorrhizal/badge/?version=latest)](https://mycorrhizal.readthedocs.io/en/latest/?badge=latest)
+[![Python Version](https://img.shields.io/pypi/pyversions/mycorrhizal)](https://pypi.org/project/mycorrhizal/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A Python library for building safe, structured, concurrent, event-driven systems.
+
+## Overview
+
+Mycorrhizal provides four domain-specific languages (DSLs) for modeling and implementing different aspects of complex systems:
+
+* **Hypha** - Colored Petri nets for workflow modeling and orchestration
+* **Rhizomorph** - Behavior trees for decision-making and control logic
+* **Septum** - Finite state machines for stateful components
+* **Spores** - Event and object logging for observability and process mining
+
+Each DSL can be used independently or combined to build sophisticated systems. All modules share common infrastructure for state management (blackboards) and time abstraction, enabling seamless composition.
+
+## Installation
+
+```bash
+pip install mycorrhizal
+```
+
+Requires Python 3.10 or later.
+
+## Quick Start
+
+### Behavior Tree (Rhizomorph)
+
+Define behavior trees using a decorator-based DSL:
+
+```python
+from mycorrhizal.rhizomorph.core import bt, Runner, Status
+
+@bt.tree
+def ThreatResponse():
+    @bt.action
+    async def assess_threat(bb) -> Status:
+        # Analyze threat level
+        return Status.SUCCESS if bb.threat_level > 5 else Status.FAILURE
+
+    @bt.action
+    async def engage_countermeasures(bb) -> Status:
+        # Respond to threat
+        return Status.SUCCESS
+
+    @bt.root
+    @bt.sequence
+    def root():
+        yield assess_threat
+        yield engage_countermeasures
+
+# Run the behavior tree
+runner = Runner(ThreatResponse, bb=blackboard)
+await runner.tick_until_complete()
+```
+
+### Petri Net (Hypha)
+
+Model workflows with colored Petri nets:
+
+```python
+from mycorrhizal.hypha.core import pn, Runner, PlaceType
+
+@pn.net
+def ProcessingNet(builder):
+    # Define places
+    pending = builder.place("pending", type=PlaceType.QUEUE)
+    processed = builder.place("processed", type=PlaceType.QUEUE)
+
+    # Define transitions
+    @builder.transition()
+    async def process(consumed, bb, timebase):
+        for token in consumed:
+            result = await handle(token)
+            yield {processed: result}
+
+    # Wire the net
+    builder.arc(pending, process).arc(processed)
+
+# Run the Petri net
+runner = Runner(ProcessingNet, bb=blackboard)
+await runner.start(timebase)
+```
+
+### Finite State Machine (Septum)
+
+Build stateful components with FSMs:
+
+```python
+from mycorrhizal.septum.core import septum, StateMachine, LabeledTransition
+
+@septum.state()
+def IdleState():
+    @septum.on_state
+    async def on_state(ctx):
+        if ctx.msg == "start":
+            return Events.START
+        return None
+
+    @septum.transitions
+    def transitions():
+        return [
+            LabeledTransition(Events.START, ProcessingState),
+        ]
+
+# Create and run the FSM
+fsm = StateMachine(initial_state=IdleState, common_data={})
+await fsm.initialize()
+fsm.send_message("start")
+await fsm.tick()
+```
+
+## Key Features
+
+### Shared Infrastructure
+
+All DSLs use common building blocks:
+
+* **Blackboards** - Typed shared state using Pydantic models
+* **Interfaces** - Decorator-based access control for blackboard fields
+* **Timebase** - Abstract time for simulation and testing
+
+### Composition
+
+Combine DSLs to model complex systems:
+
+* Embed behavior trees in Petri net transitions
+* Run state machines within behavior tree actions
+* Use Petri nets to orchestrate FSM-based components
+
+### Observability
+
+The Spores module provides OCEL-compliant logging:
+
+* Automatic event extraction from DSL execution
+* Object lifecycle tracking
+* Transport layer for custom backends
+
+## Examples
+
+The repository contains comprehensive examples:
+
+* `examples/hypha/` - Petri net patterns
+* `examples/rhizomorph/` - Behavior tree patterns
+* `examples/septum/` - State machine patterns
+* `examples/spores/` - Event logging integration
+* `examples/interfaces/` - Type-safe blackboard access
+
+Run examples with:
+
+```bash
+uv run python examples/hypha/minimal_hypha_demo.py
+```
+
+See [examples/README.md](https://github.com/Jeff-Ciesielski/mycorrhizal/tree/main/examples/) for a complete guide.
+
+## Visualization
+
+All three DSLs support Mermaid diagram export for documentation and debugging. You can generate diagrams programmatically:
+
+```python
+# Behavior Tree
+diagram = MyTree.to_mermaid()
+
+# Petri Net
+diagram = MyNet.to_mermaid()
+
+# Finite State Machine
+from mycorrhizal.septum.util import to_mermaid
+diagram = to_mermaid(fsm)
+```
+
+### Example Diagrams
+
+**Behavior Tree (Rhizomorph)** - A threat response system with decorators:
+
+```mermaid
+flowchart TD
+  N1["Selector<br/>root"]
+  N1 --> N2
+  N2["Subtree<br/>Engage"]
+  N2 --> N3
+  N3["Sequence<br/>engage_threat"]
+  N3 --> N4
+  N4((CONDITION<br/>threat_detected))
+  N3 --> N5
+  N5["Decor<br/>Failer(Gate(cond=battery_ok)(Timeout(0.12s)(engage)))"]
+  N5 --> N6
+  N6["Decor<br/>Gate(cond=battery_ok)(Timeout(0.12s)(engage))"]
+  N6 --> N7
+  N7["Decor<br/>Timeout(0.12s)(engage)"]
+  N7 --> N8
+  N8((ACTION<br/>engage))
+  N1 --> N9
+  N9["Sequence<br/>patrol"]
+  N9 --> N10
+  N10((CONDITION<br/>has_waypoints))
+  N9 --> N11
+  N11((ACTION<br/>go_to_next))
+  N9 --> N12
+  N12["Decor<br/>Succeeder(Retry(3)(Timeout(1.0s)(scan_area)))"]
+  N12 --> N13
+  N13["Decor<br/>Retry(3)(Timeout(1.0s)(scan_area))"]
+  N13 --> N14
+  N14["Decor<br/>Timeout(1.0s)(scan_area)"]
+  N14 --> N15
+  N15((ACTION<br/>scan_area))
+  N1 --> N16
+  N16["Decor<br/>Failer(RateLimit(0.200000s)(telemetry_push))"]
+  N16 --> N17
+  N17["Decor<br/>RateLimit(0.200000s)(telemetry_push)"]
+  N17 --> N18
+  N18((ACTION<br/>telemetry_push))
+```
+
+**Petri Net (Hypha)** - A task processing system with error handling:
+
+```mermaid
+graph TD
+    subgraph TaskProcessingSystem.TaskGen
+        TaskProcessingSystem.TaskGen.source(("[INPUT]</br>TaskProcessingSystem.TaskGen.source"))
+    end
+    subgraph TaskProcessingSystem.TaskProc
+        TaskProcessingSystem.TaskProc.input(("TaskProcessingSystem.TaskProc.input"))
+        TaskProcessingSystem.TaskProc.processing(("TaskProcessingSystem.TaskProc.processing"))
+        TaskProcessingSystem.TaskProc.completed(("TaskProcessingSystem.TaskProc.completed"))
+        TaskProcessingSystem.TaskProc.failed(("TaskProcessingSystem.TaskProc.failed"))
+        TaskProcessingSystem.TaskProc.take_to_processing[TaskProcessingSystem.TaskProc.take_to_processing]
+        TaskProcessingSystem.TaskProc.do_processing[TaskProcessingSystem.TaskProc.do_processing]
+        TaskProcessingSystem.TaskProc.input --> TaskProcessingSystem.TaskProc.take_to_processing
+        TaskProcessingSystem.TaskProc.take_to_processing --> TaskProcessingSystem.TaskProc.processing
+        TaskProcessingSystem.TaskProc.processing --> TaskProcessingSystem.TaskProc.do_processing
+        TaskProcessingSystem.TaskProc.do_processing --> TaskProcessingSystem.TaskProc.completed
+        TaskProcessingSystem.TaskProc.do_processing --> TaskProcessingSystem.TaskProc.failed
+    end
+    subgraph TaskProcessingSystem.Notify
+        TaskProcessingSystem.Notify.input(("TaskProcessingSystem.Notify.input"))
+        TaskProcessingSystem.Notify.email_sink(("[OUTPUT]</br>TaskProcessingSystem.Notify.email_sink"))
+        TaskProcessingSystem.Notify.sms_sink(("[OUTPUT]</br>TaskProcessingSystem.Notify.sms_sink"))
+        TaskProcessingSystem.Notify.log_sink(("[OUTPUT]</br>TaskProcessingSystem.Notify.log_sink"))
+        TaskProcessingSystem.Notify.NotificationFork[TaskProcessingSystem.Notify.NotificationFork]
+        TaskProcessingSystem.Notify.input --> TaskProcessingSystem.Notify.NotificationFork
+        TaskProcessingSystem.Notify.NotificationFork --> TaskProcessingSystem.Notify.email_sink
+        TaskProcessingSystem.Notify.NotificationFork --> TaskProcessingSystem.Notify.sms_sink
+        TaskProcessingSystem.Notify.NotificationFork --> TaskProcessingSystem.Notify.log_sink
+    end
+    subgraph TaskProcessingSystem.ErrorHandle
+        TaskProcessingSystem.ErrorHandle.input(("TaskProcessingSystem.ErrorHandle.input"))
+        TaskProcessingSystem.ErrorHandle.error_log(("[OUTPUT]</br>TaskProcessingSystem.ErrorHandle.error_log"))
+        TaskProcessingSystem.ErrorHandle.ErrorForward[TaskProcessingSystem.ErrorHandle.ErrorForward]
+        TaskProcessingSystem.ErrorHandle.input --> TaskProcessingSystem.ErrorHandle.ErrorForward
+        TaskProcessingSystem.ErrorHandle.ErrorForward --> TaskProcessingSystem.ErrorHandle.error_log
+    end
+    TaskProcessingSystem.completion_tracker(("[OUTPUT]</br>TaskProcessingSystem.completion_tracker"))
+    TaskProcessingSystem.forward_source_to_input[TaskProcessingSystem.forward_source_to_input]
+    TaskProcessingSystem.CompletionFork[TaskProcessingSystem.CompletionFork]
+    TaskProcessingSystem.FailureFork[TaskProcessingSystem.FailureFork]
+    TaskProcessingSystem.TaskGen.source --> TaskProcessingSystem.forward_source_to_input
+    TaskProcessingSystem.forward_source_to_input --> TaskProcessingSystem.TaskProc.input
+    TaskProcessingSystem.TaskProc.completed --> TaskProcessingSystem.CompletionFork
+    TaskProcessingSystem.CompletionFork --> TaskProcessingSystem.Notify.input
+    TaskProcessingSystem.CompletionFork --> TaskProcessingSystem.completion_tracker
+    TaskProcessingSystem.TaskProc.failed --> TaskProcessingSystem.FailureFork
+    TaskProcessingSystem.FailureFork --> TaskProcessingSystem.ErrorHandle.input
+    TaskProcessingSystem.FailureFork --> TaskProcessingSystem.completion_tracker
+```
+
+**Finite State Machine (Septum)** - A simple idle/processing/done workflow:
+
+```mermaid
+flowchart TD
+    start((start)) --> S1
+    S1[IdleState]
+    S1 -->|"START"| S2
+    S1 -->|"QUIT"| S3
+    S2[ProcessingState]
+    S2 -->|"DONE"| S1
+    S3[DoneState (**terminal**)]
+```
+
+## Documentation
+
+Full documentation is available at [https://mycorrhizal.readthedocs.io](https://mycorrhizal.readthedocs.io)
+
+## Development
+
+```bash
+# Install dependencies
+uv pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run with coverage
+pytest --cov=src/mycorrhizal --cov-report=html
+```
+
+## Project Status
+
+This is a 0.1.0 release. The core APIs are stable and well-tested, but some features are still in development:
+
+* Current: Four DSLs with decorator-based syntax
+* Current: Comprehensive examples and tests
+* Planned: Cross-DSL interoperability layer
+* Planned: Enhanced composition patterns
+
+## License
+
+MIT
+
+## Author
+
+Jeff Ciesielski

mycorrhizal-0.2.0.dist-info/RECORD

@@ -0,0 +1,54 @@
+mycorrhizal/__init__.py,sha256=ajz1GSNU9xYVrFEDSz6Xwg7amWQ_yvW75tQa1ZvRIWc,3
+mycorrhizal/_version.py,sha256=XQVhijSHeIVMVzY2S4fY9BKxV2XHSTr9VVHsYltGPvQ,18
+mycorrhizal/common/__init__.py,sha256=OwPFyCFW6H6E6EkQIjQfl-h67qfo36geu0ndfXqYEn4,1705
+mycorrhizal/common/cache.py,sha256=D-L9aVG3eXemXKVmhiRONFB0KWobzRHACknMkHgZ3ug,3477
+mycorrhizal/common/compilation.py,sha256=f98aE0Dq6ztgm6SjxYbWKGjhOZ2i9SWLT7bc2Yvvwos,8922
+mycorrhizal/common/interface_builder.py,sha256=rBJzduqZ6EjD9MNGO669BcjkM9mYvsnMG0F1kd1wWaQ,6895
+mycorrhizal/common/interface_detection.py,sha256=VKUGdL0wkWaSpyMoUqkic16vFsPQFpIL9OCFM68CAHI,4622
+mycorrhizal/common/interfaces.py,sha256=nXS_j1QYmPxel_avjT1Mlb0C1ZpNUOicMN1yQ0e_r6Y,10714
+mycorrhizal/common/mermaid.py,sha256=qEv-0_ChQLZcGYYHLYnkgFYzl3w2G0YDT9JnvOHDFR4,3483
+mycorrhizal/common/timebase.py,sha256=h8OymApwr_EvpRsfRJb6E5YosHg3jfqToOGAfMlL-Qw,2229
+mycorrhizal/common/wrappers.py,sha256=z5ezZuRycH8k8ODOR_B57SrvckTA_TfFLRvyGI63tkQ,17809
+mycorrhizal/hypha/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mycorrhizal/hypha/util.py,sha256=tpvjWXTdGhtVUycQElcQg4usOy-tSEqwE9KEni8R30s,906
+mycorrhizal/hypha/core/__init__.py,sha256=o6BE3fhRKjVfyIWwtNTO64kPt0udlZGyXr-ZuN_ZzF8,2518
+mycorrhizal/hypha/core/builder.py,sha256=aZ6xvktGVteDBVFf2Uva7-7vsBbpAP3maBfiL6xiJl0,17205
+mycorrhizal/hypha/core/runtime.py,sha256=BTguGT2ku2U70r-5IYVPP3ubrG1QC5_opQ0hbF5162k,40830
+mycorrhizal/hypha/core/specs.py,sha256=uWvW9x7-bSoSENIUJkYMIkJ3KxsgE9mB9PyRLPrOEjk,8429
+mycorrhizal/mycelium/__init__.py,sha256=MFgh6eZVjE1zSwgDqD2GXneZv-7MWtRoky5Qtmydqdw,4231
+mycorrhizal/mycelium/core.py,sha256=ly3GtHKHHwqoODk3tFWMKoUT3VYPsQHBYyDNSKCmGMY,19583
+mycorrhizal/mycelium/exceptions.py,sha256=6QVwHEDQWZAYNMgrNhIZ3vhD-wBAaSIt4vKfEJQ2rMI,750
+mycorrhizal/mycelium/hypha_bridge.py,sha256=c1CCAMAo-nBX6iEYZDPPc__SSaaOVnPl77fdoHiX-9A,48325
+mycorrhizal/mycelium/instance.py,sha256=qrjoeDyi71FtVMrDj4bjkb-WwfxNihzO6hAPd4g9sag,16526
+mycorrhizal/mycelium/pn_context.py,sha256=z_wRZAN3DeaZWZP9DdlfbZbreU-Sf0xqKV0qakewMXk,8680
+mycorrhizal/mycelium/runner.py,sha256=afEzk1rjQuPG7FPRP5lf0Uxvr-wUmQTd8A8z8-dV4DY,4402
+mycorrhizal/mycelium/spores_integration.py,sha256=SbFQLF5bBJCr0OOgSbH7rOa7zsDtoKsuU_VJV4ywtR4,20032
+mycorrhizal/mycelium/tree_builder.py,sha256=WOxCZgAPmGmFb_t0FghCNgAVdVLEqdbtWN5KmiBkgx8,3400
+mycorrhizal/mycelium/tree_spec.py,sha256=0RyZBOJROxWrYdqtNeawWv1vB5ZgwzGR-lWFN8b2-Ro,6919
+mycorrhizal/rhizomorph/README.md,sha256=UrCYyaMUtqa9U2ejMyg9om-1QhFm3S6sFS9Cjp_4jUs,9367
+mycorrhizal/rhizomorph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mycorrhizal/rhizomorph/core.py,sha256=S9UWecUWzLqAAdAg1WhjROZYegwoc61btzXArPKCeWg,67411
+mycorrhizal/rhizomorph/util.py,sha256=dUgKAWX5RNtzFK01mGkz10tJyeTMCqyyfnZ8Mi97LkY,1280
+mycorrhizal/septum/TRANSITION_REFERENCE.md,sha256=4mxDeTbeuqIDJCebXlwxT537Tgk2XLpinssam6I6lNw,10987
+mycorrhizal/septum/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mycorrhizal/septum/core.py,sha256=vGGvhP0TDidu5MGJgxiioQXsE3t-G9uvQKJeEud_18o,64043
+mycorrhizal/septum/testing_utils.py,sha256=ONk9hOm7oc8qSgbOcsWaZvlfP_iOUS7uoo3aS7Pfuis,17314
+mycorrhizal/septum/util.py,sha256=J4D0uBzNkVWDBwrOMhG9x5Y4lkjP8pEDkuc2d4UX7eI,9344
+mycorrhizal/spores/__init__.py,sha256=iePLLnGdKVHKrzoy9gQFARcQG0jmDIUavkJwLv9Mx6w,4766
+mycorrhizal/spores/cache.py,sha256=0FuWHKudgyC7vlrlcJ_kmRKr7OAJuC2gxRURReMlqF4,6119
+mycorrhizal/spores/core.py,sha256=fBklI4pQUd78o8qJ6_MXFmDZN612CDqr3dfS0yAmc_U,45109
+mycorrhizal/spores/extraction.py,sha256=pCc_bm-MUx7SYGM9xI_m4cOL3X5VjGIr3FQ66fkUW5k,15063
+mycorrhizal/spores/models.py,sha256=nwjSSbSvBMuuE0__nDt2loDRJhJWQBu0Y3jRg4p3wfU,9724
+mycorrhizal/spores/dsl/__init__.py,sha256=DDrLqJ4CjtRsepmzsxkdxu_ugYYpAwaxawau-0t4Bm0,1163
+mycorrhizal/spores/dsl/hypha.py,sha256=L565_yW93xIo7KcqjgZnYldBObiOS7ix1Wq1W6W-ULc,11695
+mycorrhizal/spores/dsl/rhizomorph.py,sha256=JXaZmRyiKVOz2I1uf-96u7Zl9h4YlJCaAtaXYUWnKxc,9737
+mycorrhizal/spores/dsl/septum.py,sha256=bG6HPTAWAAoSbps-2hs0oGsyTOEq1pPCIsgDvmfUI6Q,14206
+mycorrhizal/spores/encoder/__init__.py,sha256=hpp1W4xwQUG1N1zdrea0coBPtMf-WYSE77Q780TinP8,204
+mycorrhizal/spores/encoder/base.py,sha256=xFKk-f5_W_HNrOgNXyquUwhcrcz28LmeT5Y5enDVrwU,870
+mycorrhizal/spores/encoder/json.py,sha256=OPezVz-5-to-NmZ_QuVGMPSLn_24GbdG6Y3F4_RXx40,5064
+mycorrhizal/spores/transport/__init__.py,sha256=Tw6glCXsPK2pzsLPbb9vKOCvvT9vh-ql-xUaulKBAw0,407
+mycorrhizal/spores/transport/base.py,sha256=OsyWx1J8Ig7Y7idUoI9oS-LkONwQAxAP47jL_5OVRjA,1668
+mycorrhizal/spores/transport/file.py,sha256=xcMPxAGiv5q-GfcNKsF_3a-2-yxlDkhHusZli1Fsqa0,3833
+mycorrhizal-0.2.0.dist-info/METADATA,sha256=KCGylTow8Ue3YeSB--pjQ1QtCdFzcD6hwKzosN-JWqk,11607
+mycorrhizal-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mycorrhizal-0.2.0.dist-info/RECORD,,

mycorrhizal-0.1.2.dist-info/METADATA

@@ -1,198 +0,0 @@
-Metadata-Version: 2.4
-Name: mycorrhizal
-Version: 0.1.2
-Summary: Utilities and DSLs for modelling and implementing safe, performant, structured systems
-Author-email: Jeff Ciesielski <jeffciesielski@gmail.com>
-Requires-Python: >=3.10
-Requires-Dist: pydantic>=2.11.7
-Requires-Dist: typeguard==4.4.4
-Description-Content-Type: text/markdown
-
-# Mycorrhizal
-
-A Python library for building safe, structured, concurrent, event-driven systems.
-
-## Overview
-
-Mycorrhizal provides four domain-specific languages (DSLs) for modeling and implementing different aspects of complex systems:
-
-* **Hypha** - Colored Petri nets for workflow modeling and orchestration
-* **Rhizomorph** - Behavior trees for decision-making and control logic
-* **Enoki** - Finite state machines for stateful components
-* **Spores** - Event and object logging for observability and process mining
-
-Each DSL can be used independently or combined to build sophisticated systems. All modules share common infrastructure for state management (blackboards) and time abstraction, enabling seamless composition.
-
-## Installation
-
-```bash
-pip install mycorrhizal
-```
-
-Requires Python 3.10 or later.
-
-## Quick Start
-
-### Behavior Tree (Rhizomorph)
-
-Define behavior trees using a decorator-based DSL:
-
-```python
-from mycorrhizal.rhizomorph.core import bt, Runner, Status
-
-@bt.tree
-def ThreatResponse():
-    @bt.action
-    async def assess_threat(bb) -> Status:
-        # Analyze threat level
-        return Status.SUCCESS if bb.threat_level > 5 else Status.FAILURE
-
-    @bt.action
-    async def engage_countermeasures(bb) -> Status:
-        # Respond to threat
-        return Status.SUCCESS
-
-    @bt.root
-    @bt.sequence
-    def root():
-        yield assess_threat
-        yield engage_countermeasures
-
-# Run the behavior tree
-runner = Runner(ThreatResponse, bb=blackboard)
-await runner.tick_until_complete()
-```
-
-### Petri Net (Hypha)
-
-Model workflows with colored Petri nets:
-
-```python
-from mycorrhizal.hypha.core import pn, Runner, PlaceType
-
-@pn.net
-def ProcessingNet(builder):
-    # Define places
-    pending = builder.place("pending", type=PlaceType.QUEUE)
-    processed = builder.place("processed", type=PlaceType.QUEUE)
-
-    # Define transitions
-    @builder.transition()
-    async def process(consumed, bb, timebase):
-        for token in consumed:
-            result = await handle(token)
-            yield {processed: result}
-
-    # Wire the net
-    builder.arc(pending, process).arc(processed)
-
-# Run the Petri net
-runner = Runner(ProcessingNet, bb=blackboard)
-await runner.start(timebase)
-```
-
-### Finite State Machine (Enoki)
-
-Build stateful components with FSMs:
-
-```python
-from mycorrhizal.enoki.core import enoki, StateMachine, LabeledTransition
-
-@enoki.state()
-def IdleState():
-    @enoki.on_state
-    async def on_state(ctx):
-        if ctx.msg == "start":
-            return Events.START
-        return None
-
-    @enoki.transitions
-    def transitions():
-        return [
-            LabeledTransition(Events.START, ProcessingState),
-        ]
-
-# Create and run the FSM
-fsm = StateMachine(initial_state=IdleState, common_data={})
-await fsm.initialize()
-fsm.send_message("start")
-await fsm.tick()
-```
-
-## Key Features
-
-### Shared Infrastructure
-
-All DSLs use common building blocks:
-
-* **Blackboards** - Typed shared state using Pydantic models
-* **Interfaces** - Decorator-based access control for blackboard fields
-* **Timebase** - Abstract time for simulation and testing
-
-### Composition
-
-Combine DSLs to model complex systems:
-
-* Embed behavior trees in Petri net transitions
-* Run state machines within behavior tree actions
-* Use Petri nets to orchestrate FSM-based components
-
-### Observability
-
-The Spores module provides OCEL-compliant logging:
-
-* Automatic event extraction from DSL execution
-* Object lifecycle tracking
-* Transport layer for custom backends
-
-## Examples
-
-The repository contains comprehensive examples:
-
-* `examples/hypha/` - Petri net patterns
-* `examples/rhizomorph/` - Behavior tree patterns
-* `examples/enoki/` - State machine patterns
-* `examples/spores/` - Event logging integration
-* `examples/interfaces/` - Type-safe blackboard access
-
-Run examples with:
-
-```bash
-uv run python examples/hypha/minimal_hypha_demo.py
-```
-
-See [examples/README.md](examples/README.md) for a complete guide.
-
-## Documentation
-
-Full API documentation is available at [docs link here].
-
-## Development
-
-```bash
-# Install dependencies
-uv pip install -e ".[dev]"
-
-# Run tests
-pytest
-
-# Run with coverage
-pytest --cov=src/mycorrhizal --cov-report=html
-```
-
-## Project Status
-
-This is a 0.1.0 release. The core APIs are stable and well-tested, but some features are still in development:
-
-* Current: Four DSLs with decorator-based syntax
-* Current: Comprehensive examples and tests
-* Planned: Cross-DSL interoperability layer
-* Planned: Enhanced composition patterns
-
-## License
-
-MIT
-
-## Author
-
-Jeff Ciesielski

mycorrhizal-0.1.2.dist-info/RECORD

@@ -1,39 +0,0 @@
-mycorrhizal/__init__.py,sha256=ajz1GSNU9xYVrFEDSz6Xwg7amWQ_yvW75tQa1ZvRIWc,3
-mycorrhizal/_version.py,sha256=08TK2sYzQF2Wqm6gpxZEgWYYF9ZjbInObIzS2R2yxiE,18
-mycorrhizal/common/__init__.py,sha256=vAL2NZFFVcoGoPlIREKRG0mrgx1prVTGTlWBopJ76Sw,1450
-mycorrhizal/common/interface_builder.py,sha256=rBJzduqZ6EjD9MNGO669BcjkM9mYvsnMG0F1kd1wWaQ,6895
-mycorrhizal/common/interfaces.py,sha256=fWw6bm2ejFmKUnl2pSTiSEwTP0Id8Kowg827_Mqir-s,12261
-mycorrhizal/common/timebase.py,sha256=h8OymApwr_EvpRsfRJb6E5YosHg3jfqToOGAfMlL-Qw,2229
-mycorrhizal/common/wrappers.py,sha256=hdj_1OgWe9RNqGlEkcklQ2j0FFn-AE9h5A55udYTr4o,17794
-mycorrhizal/enoki/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mycorrhizal/enoki/core.py,sha256=17oV8AGTI5aY299nAm3Jtc5iarImT2WPbMIwYE5LRsA,53697
-mycorrhizal/enoki/testing_utils.py,sha256=S19p0nZ0UTfQm-hPHFAWqN9LAdfjL9uQKMFx_gaices,17307
-mycorrhizal/enoki/util.py,sha256=oJ9vmHrbUdX99Rkh7bBeUHFzM5sS3yrtXOTQDA1524I,8434
-mycorrhizal/hypha/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mycorrhizal/hypha/util.py,sha256=tpvjWXTdGhtVUycQElcQg4usOy-tSEqwE9KEni8R30s,906
-mycorrhizal/hypha/core/__init__.py,sha256=o6BE3fhRKjVfyIWwtNTO64kPt0udlZGyXr-ZuN_ZzF8,2518
-mycorrhizal/hypha/core/builder.py,sha256=GyjDWG3ZTO_0OIhJNrty4-SaJ9RGsNIzHyOQBCNKDfc,16912
-mycorrhizal/hypha/core/runtime.py,sha256=K7EDxPTYu9lyHoolBGrrOTws7f1xmbnU2SBVVLnoD3g,34848
-mycorrhizal/hypha/core/specs.py,sha256=uWvW9x7-bSoSENIUJkYMIkJ3KxsgE9mB9PyRLPrOEjk,8429
-mycorrhizal/rhizomorph/README.md,sha256=g-G8d00VgMOPriggsNveH7HqLhnJ9HlvoIzrwmUEy_M,8134
-mycorrhizal/rhizomorph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mycorrhizal/rhizomorph/core.py,sha256=FrV7S6coulaeqhYfHmNE9x6tmlGFBYcqO04zOdpwNNs,60816
-mycorrhizal/rhizomorph/util.py,sha256=dUgKAWX5RNtzFK01mGkz10tJyeTMCqyyfnZ8Mi97LkY,1280
-mycorrhizal/spores/__init__.py,sha256=VI0y_723Fo1la-nJGJweBWc8PKvpd_VmmT9EBtVrEog,4763
-mycorrhizal/spores/cache.py,sha256=0FuWHKudgyC7vlrlcJ_kmRKr7OAJuC2gxRURReMlqF4,6119
-mycorrhizal/spores/core.py,sha256=KGv3X6w6pz5RiUD__7MMrYUXvDwGUfWFU_eCvDcQSUg,38624
-mycorrhizal/spores/extraction.py,sha256=YnUGABcVgZVSDCXyOQewWG62NAkdievJrXPIA_eJkxg,14918
-mycorrhizal/spores/models.py,sha256=Gm_7jwPNgWhYCK5XDIUiN0DfDp4kJEkSbqxpwPdlsJE,8712
-mycorrhizal/spores/dsl/__init__.py,sha256=bkxHTkaPrDWUlU1pjYlGJOM-772M5_k7R4aZ8HaxMNM,1153
-mycorrhizal/spores/dsl/enoki.py,sha256=eVYNBp3ESZ7lK91vE8H5JWkXX14pOtf6cdAWSLiqAsE,15506
-mycorrhizal/spores/dsl/hypha.py,sha256=vcJimWbZT2MmGhj8Lbn3izF1PO9HVJe1YQi5P3EiZ6o,11959
-mycorrhizal/spores/dsl/rhizomorph.py,sha256=ChG2fRQD9DR90dLKLYSQR72asC-7eLccvBwZtz8C8kw,9898
-mycorrhizal/spores/encoder/__init__.py,sha256=hpp1W4xwQUG1N1zdrea0coBPtMf-WYSE77Q780TinP8,204
-mycorrhizal/spores/encoder/base.py,sha256=xFKk-f5_W_HNrOgNXyquUwhcrcz28LmeT5Y5enDVrwU,870
-mycorrhizal/spores/encoder/json.py,sha256=dyQSTXfG0VQPSNt9ed8VEgMwxFUPnLtV6u_bSRuEnNY,4747
-mycorrhizal/spores/transport/__init__.py,sha256=Tw6glCXsPK2pzsLPbb9vKOCvvT9vh-ql-xUaulKBAw0,407
-mycorrhizal/spores/transport/base.py,sha256=OsyWx1J8Ig7Y7idUoI9oS-LkONwQAxAP47jL_5OVRjA,1668
-mycorrhizal/spores/transport/file.py,sha256=xcMPxAGiv5q-GfcNKsF_3a-2-yxlDkhHusZli1Fsqa0,3833
-mycorrhizal-0.1.2.dist-info/METADATA,sha256=c_xR3AeCwrC8jhbnimBcfu_7jmFItM8UdgAR2Wi8RYQ,4895
-mycorrhizal-0.1.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-mycorrhizal-0.1.2.dist-info/RECORD,,