@stream44.studio/encapsulate 0.4.0-rc.23 → 0.4.0-rc.25

package/README.md

@@ -3,6 +3,7 @@
     <td><a href="https://Stream44.Studio"><img src=".o/stream44.studio/assets/Icon-v1.svg" width="42" height="42"></a></td>
     <td><strong><a href="https://Stream44.Studio">Stream44 Studio</a></strong><br/>Open Development Project</td>
     <td>Preview release for community feedback.<br/>Get in touch on <a href="https://discord.gg/9eBcQXEJAN">discord</a>.</td>
+    <td>Hand Designed<br/><b>AI Coded Alpha</a></td>
   </tr>
 </table>
 
@@ -16,6 +17,7 @@ An *experimental* implementation of the [PrivateData.Space](https://privatedata.
 ***NOTE:** Not intended for direct use until it matures in light of the projects below.*
 
 It is being used to underpin:
+- [Framespace Genesis](https://github.com/Stream44/FramespaceGenesis) - Modeling engine with realtime interactive visualization
 - [t44](https://github.com/Stream44/t44) - A web3 + AI ready workspace
 - [Stream44.Studio](https://stream44.studio) - A **full-stack IDE** for building **embodied distributed systems**
 
@@ -25,13 +27,23 @@ It is being used to underpin:
   <br/><br/>
 </p>
 
+### Why
+
+When encoding a software system as a body (complete model), the body is structured through the declarative semantic schema and animated by functional processing in nodes.
+
+We need a minimal abstraction to conveniently author graph processing nodes.
+
+`encapsulate` provides such a primitive building block.
+
+![Source To Graph Isomorphism](./docs/SourceToGraphIsomorphism.svg)
+
+
 The CAPSULE Spine Contract
 ---
 
 The `encapsulate` library wraps TypeScript objects and binds reference trees for constructing executable component graphs.
 
-The binding rules are defined by **Spine Contracts**. The first *experimental* spine contract is the **Capsule Spine Contract**. It builds a model
-around **Capsules** which have certain properties.
+The binding rules are defined by **Spine Contracts**. The first *experimental* spine contract is the **Capsule Spine Contract**. It builds a model around **Capsules** which have certain properties.
 
 The capsule spine contract is implemented here: [src/spine-contracts/CapsuleSpineContract.v0/](src/spine-contracts/CapsuleSpineContract.v0/)
 
@@ -42,9 +54,6 @@ The capsule spine contract is implemented here: [src/spine-contracts/CapsuleSpin
 - [ ] Capsule Projectors
 - [ ] Load capsules from packs
 
-![Capsule Spine Contract Overview](./src/spine-contracts/CapsuleSpineContract.v0/Overview.svg)
-
-
 Provenance
 ===
 

package/docs/SourceToGraphIsomorphism.drawio

@@ -0,0 +1,100 @@
+<mxfile host="65bd71144e">
+    <diagram name="Page-1" id="QeIE7gKKPfThrfCM8ygm">
+        <mxGraphModel dx="1145" dy="1728" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1100" pageHeight="850" math="0" shadow="0">
+            <root>
+                <mxCell id="0"/>
+                <mxCell id="1" parent="0"/>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-29" value="" style="rounded=0;whiteSpace=wrap;html=1;movable=1;resizable=1;rotatable=1;deletable=1;editable=1;locked=0;connectable=1;" parent="1" vertex="1">
+                    <mxGeometry x="10" y="-840" width="1070" height="480" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-33" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;startArrow=classic;startFill=1;strokeWidth=2;" parent="1" source="N3hJ6-WijfH2HfO5JL5S-28" target="N3hJ6-WijfH2HfO5JL5S-25" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-28" value="Source Code Module" style="rounded=0;whiteSpace=wrap;html=1;verticalAlign=top;dashed=1;" parent="1" vertex="1">
+                    <mxGeometry x="30" y="-800" width="570" height="420" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-25" value="Semantic Graph Module" style="rounded=0;whiteSpace=wrap;html=1;dashed=1;verticalAlign=top;" parent="1" vertex="1">
+                    <mxGeometry x="660" y="-800" width="390" height="420" as="geometry"/>
+                </mxCell>
+                <mxCell id="o5PIcx3FIGXJDux8oxUI-1" value="const &lt;font style=&quot;color: rgb(0, 102, 204);&quot;&gt;capsule&lt;/font&gt; = await Capsule({&lt;div&gt;&amp;nbsp; '&lt;font style=&quot;color: rgb(204, 102, 0);&quot;&gt;#@&amp;lt;org&amp;gt;/&amp;lt;project&amp;gt;/structs/StructA&lt;/font&gt;': {&lt;/div&gt;&lt;div&gt;&amp;nbsp; &amp;nbsp; as:&amp;nbsp;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;'&lt;/span&gt;&lt;font style=&quot;color: rgb(153, 51, 255);&quot;&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;$#&lt;/span&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;@&amp;lt;org&amp;gt;/&amp;lt;project&amp;gt;/AspectX&lt;/span&gt;&lt;/font&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;'&lt;/span&gt;&lt;/div&gt;&lt;div&gt;&amp;nbsp; }&lt;/div&gt;&lt;div&gt;&amp;nbsp; '#'{&amp;nbsp;&lt;/div&gt;&lt;div&gt;&amp;nbsp; &amp;nbsp; &lt;font style=&quot;color: rgb(0, 153, 0);&quot;&gt;property1&lt;/font&gt;: 'val1',&lt;/div&gt;&lt;div&gt;&amp;nbsp; &amp;nbsp; &lt;font style=&quot;color: rgb(204, 0, 102);&quot;&gt;mapping1&lt;/font&gt;: '&lt;span style=&quot;background-color: transparent;&quot;&gt;&lt;font style=&quot;color: rgb(204, 0, 102);&quot;&gt;@&amp;lt;org&amp;gt;/&amp;lt;project&amp;gt;/FeatureY&lt;/font&gt;&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;',&lt;/span&gt;&lt;/div&gt;&lt;div&gt;&amp;nbsp; &amp;nbsp; &lt;font style=&quot;color: rgb(0, 153, 0);&quot;&gt;method1&lt;/font&gt;: () =&amp;gt; {&lt;/div&gt;&lt;div&gt;&lt;div&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; this.&lt;span style=&quot;background-color: transparent;&quot;&gt;&lt;font style=&quot;color: light-dark(rgb(204, 0, 102), rgb(255, 255, 255));&quot;&gt;mapping1&lt;/font&gt;&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;.featureMethod()&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; this['&lt;font style=&quot;color: rgb(153, 51, 255);&quot;&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;$#&lt;/span&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;@&amp;lt;org&amp;gt;/&amp;lt;project&amp;gt;/AspectX&lt;/span&gt;&lt;/font&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;'&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;.instanceMethod2()&lt;/span&gt;&lt;/div&gt;&lt;div&gt;&amp;nbsp; &amp;nbsp; }&lt;/div&gt;&lt;div&gt;&amp;nbsp; }&lt;br&gt;}, {&lt;div&gt;&amp;nbsp; capsuleName: '&lt;font style=&quot;color: rgb(0, 102, 204);&quot;&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;@&amp;lt;org&amp;gt;/&amp;lt;project&amp;gt;/&lt;/span&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;MyCapsule&lt;/span&gt;&lt;/font&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;'&lt;/span&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;})&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;br&gt;&lt;/div&gt;&lt;div&gt;&lt;font style=&quot;color: rgb(0, 102, 204);&quot;&gt;capsule&lt;/font&gt;.&lt;span style=&quot;background-color: transparent;&quot;&gt;&lt;font style=&quot;color: light-dark(rgb(0, 153, 0), rgb(255, 255, 255));&quot;&gt;property1&lt;/font&gt;&lt;/span&gt;&lt;/div&gt;&lt;div&gt;&lt;font style=&quot;color: rgb(0, 102, 204);&quot;&gt;capsule&lt;/font&gt;.&lt;span style=&quot;background-color: transparent;&quot;&gt;&lt;font style=&quot;color: light-dark(rgb(0, 153, 0), rgb(255, 255, 255));&quot;&gt;method1&lt;/font&gt;&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;()&lt;/span&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;font style=&quot;color: rgb(0, 102, 204);&quot;&gt;capsule&lt;/font&gt;.&lt;span style=&quot;color: rgb(204, 0, 102); background-color: transparent;&quot;&gt;mapping1&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;.featureMethod&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;()&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;font style=&quot;color: rgb(0, 102, 204);&quot;&gt;capsule&lt;/font&gt;['&lt;font style=&quot;color: rgb(204, 102, 0);&quot;&gt;#@&amp;lt;org&amp;gt;/&amp;lt;project&amp;gt;/structs/StructA&lt;/font&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;'&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;].protoMethod1&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;()&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;font style=&quot;color: rgb(0, 102, 204);&quot;&gt;capsule&lt;/font&gt;['&lt;font style=&quot;color: rgb(153, 51, 255);&quot;&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;$#&lt;/span&gt;&lt;span style=&quot;background-color: transparent;&quot;&gt;@&amp;lt;org&amp;gt;/&amp;lt;project&amp;gt;/AspectX&lt;/span&gt;&lt;/font&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;'&lt;/span&gt;&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;].&lt;/span&gt;instanceMethod2&lt;span style=&quot;background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));&quot;&gt;()&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;" style="rounded=0;whiteSpace=wrap;html=1;align=left;fontFamily=Courier New;fontStyle=1;fontSize=14;spacingLeft=10;fillColor=#FFFCF4;" parent="1" vertex="1">
+                    <mxGeometry x="55" y="-765" width="520" height="370" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-26" value="" style="group;fillColor=default;" parent="1" connectable="0" vertex="1">
+                    <mxGeometry x="685" y="-750" width="340" height="340" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-20" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#FFFCF4;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry width="340" height="340" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-9" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-1" target="N3hJ6-WijfH2HfO5JL5S-5" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-1" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="120" y="50" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-17" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-4" target="N3hJ6-WijfH2HfO5JL5S-16" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-4" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#dae8fc;strokeColor=#6c8ebf;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="50" y="180" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-10" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-5" target="N3hJ6-WijfH2HfO5JL5S-7" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-11" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;entryX=0;entryY=0;entryDx=0;entryDy=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-5" target="N3hJ6-WijfH2HfO5JL5S-6" edge="1">
+                    <mxGeometry relative="1" as="geometry">
+                        <mxPoint x="220" y="250" as="targetPoint"/>
+                    </mxGeometry>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-12" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-5" target="N3hJ6-WijfH2HfO5JL5S-8" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-13" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-5" target="N3hJ6-WijfH2HfO5JL5S-4" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-5" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#dae8fc;strokeColor=#6c8ebf;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="170" y="140" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-6" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="230" y="250" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-7" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="280" y="140" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-8" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#dae8fc;strokeColor=#6c8ebf;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="90" y="260" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-14" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-8" target="N3hJ6-WijfH2HfO5JL5S-6" edge="1">
+                    <mxGeometry relative="1" as="geometry">
+                        <mxPoint x="210" y="250" as="targetPoint"/>
+                    </mxGeometry>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-18" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=none;endFill=0;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-15" target="N3hJ6-WijfH2HfO5JL5S-7" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-15" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#dae8fc;strokeColor=#6c8ebf;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="220" y="80" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-16" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" parent="N3hJ6-WijfH2HfO5JL5S-26" vertex="1">
+                    <mxGeometry x="70" y="110" width="20" height="20" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-21" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.265;entryY=0.059;entryDx=0;entryDy=0;entryPerimeter=0;endArrow=none;endFill=0;dashed=1;strokeColor=#3399FF;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-1" target="N3hJ6-WijfH2HfO5JL5S-20" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-22" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.997;entryY=0.585;entryDx=0;entryDy=0;entryPerimeter=0;endArrow=none;endFill=0;dashed=1;strokeColor=#3399FF;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-6" target="N3hJ6-WijfH2HfO5JL5S-20" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-23" style="rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.015;entryY=0.603;entryDx=0;entryDy=0;entryPerimeter=0;endArrow=none;endFill=0;dashed=1;strokeColor=#3399FF;" parent="N3hJ6-WijfH2HfO5JL5S-26" source="N3hJ6-WijfH2HfO5JL5S-4" target="N3hJ6-WijfH2HfO5JL5S-20" edge="1">
+                    <mxGeometry relative="1" as="geometry">
+                        <Array as="points"/>
+                    </mxGeometry>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-31" value="(c) 2026 &lt;a href=&quot;https://christoph.diy&quot;&gt;Christoph.diy&lt;/a&gt;&amp;nbsp;CC BY" style="text;html=1;whiteSpace=wrap;strokeColor=none;fillColor=none;align=right;verticalAlign=middle;rounded=0;" parent="1" vertex="1">
+                    <mxGeometry x="880" y="-840" width="185" height="30" as="geometry"/>
+                </mxCell>
+                <mxCell id="N3hJ6-WijfH2HfO5JL5S-32" value="Encapsulate: Source Code / Semantic Graph Isomorphism - v0.1" style="text;html=1;whiteSpace=wrap;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;rounded=0;" parent="1" vertex="1">
+                    <mxGeometry x="360" y="-840" width="420" height="30" as="geometry"/>
+                </mxCell>
+            </root>
+        </mxGraphModel>
+    </diagram>
+</mxfile>

package/docs/SourceToGraphIsomorphism.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="1071px" height="481px" viewBox="-0.5 -0.5 1071 481" content="&lt;mxfile&gt;&lt;diagram name=&quot;Page-1&quot; id=&quot;QeIE7gKKPfThrfCM8ygm&quot;&gt;7Vxbc9o6EP41TJKHML5yeQwQ2nSans5kzrR9VGyB1RjLRxYJ9NcfyZKMb8FADNhppp2JtbrvfrtaiZU65nix+kRA6N1jF/odQ3NXHXPSMQxdt3T2h1PWktI3LUGZE+RK2obwgP5ASdQkdYlcGGUKUox9isIs0cFBAB2aoQFC8Eu22Az72V5DMIcFwoMD/CL1B3KppyamaZuMzxDNPdn1wJYZC6AKS0LkARe/pEjmbcccE4yp+FqsxtDn3FN8EfWmr+QmAyMwoLtU+GZ6X3rXP9Dv2Wfj8+wf+8tX++HaGIpmnoG/lDOWo6VrxQKCl4ELeStaxxy9eIjChxA4PPeFSZ3RPLrwWUpnnwv8DB7jmjxFYIT+pNOYAppKM7jAdBq6KJ30sfOUdCwlnMouckAy5RkSClcpkuTIJ4gXkJI1K7LKwkzC83pgScJLSthaXxK9lKCtgSQCibB50vhGCOxDymEPmZhmQQTQZaCUSUyoh+c4AP7thjrKCmlT5ivGoWTXb0jpWmoYWFKcFRzjIVn/lPXjxC+e6NoqOVmlMydrmYooIPSGaxojOD6IIuQo8hT5qvmIEvyUqJCxTXoRXhIHbgPtQBoCQOaQbitoi4KcfVvRQKAPKHrO6nztglXjTinbg5iroY2Z6WR/mAVdMnm+SQU5+hGzYDc+mgeMRjkCRi6IvLiFmjTHzGuOVtQcu1RxjGMpjhJ3mr9wAQLGDUaNV6iaWJxhZjm/a2Bxr7cDj83hsXiM7e93zsqc3n36+WWyXA3w6t+7a73AYmaXI9rhHfZ81v1ohgOaYW3vvyVf45gB9zHpmDdc3+aPl6wCG4Kma4b4MDTrKuabKs++5nE9EEaxxET7bNiiC5HLe+a9aOAFIN7xWBS/7PRHqoqLnjfFe2DB5RM8RkJM2sW+I2cjzY1dKx95xzA7fEGRXcadYDJPCLLQNFsiJPg3d2XypZgJXTo0Yl8P8dfNKxy5ECNNzZ8VyLJgB66UkDiYbop00VoUgqCUeY/AeZrH2nWd4iMlIIiUdoxiBy7J8zmQr11Ani5TQNESVsd/Y0HYtsRO6uOqXBYXKWaIsWa5savwddsUXdn6pstXpF8LZ4rNWhxX22dTd5/1ofgmChn5Z8X4C0r+PkB2kCL2J2+pzoZkXghbUKq3NdmGQ62/0qZXLChDUcjWy7X+GjDiBi/YcqRfxA2ddVLJwrBZ28qntQBhiIJ5xayOZkCONKsarcQUArok8FeFPTiO9TuFmRhXTKHZasl8SQ+72+F7eaVcs6xs93VMDp54nkQ9FHUboFM5SJWq10GwqrIq7Vaa7kzYhPsYexxdByhQfWpVhq6OPdp7M/HhT374kwf7k00ff8eetHwGXRREFASONDvGgXZnfwvzNq8/Vf2RJOU4cZxdgbc3I49evoEFzPmktZ/yNN/SnNZE3q/HhXOvv8iyHeQZ9idX2+sf7hTkVWnfqic+FW2gn1uytTgIOZVHAjUB60NidUmsYrfYbgehFoegNRjc9WhIOwysJTvYNmIiu1Vt+WSOuNNuriYcspNv+M+CbcHbO9jzdpmsKL4vLHttnM6x1b8Fiv1xRPc2C/VxRNfg8XNz9coUckdfbZlRTRbrLfFhQIaC+XCmDM0ULJDPA7nGeEkQJKz1b/BFZqrYTl2lRZSmbgl2O8wn/ho3NdF57zPk+2PBRTY0czqdjqdWMug3xZzZdjbkrN+zi2F9KrosHXJmqli/+sP6etUxyhx2YY4zLpyBpU+38SUbU7yJ1d4jRm+QZ5gKAE/H6FllDLOOxjCtmmGsGRRGcAcox8abJWZoxeG/B/i2S7Oaxefj4LBC/Q+Kr3ZVlHSAAygoMkBa2599lUHS6rJEVYx0s0Kki+GlNSK3foSqXKVx0giUmIAyk3m0QGi93378WjviV+81CsDWCU2vC+BgJi5b8MsVqZyeM4CPs2NC3s4iXh+cG/Jagc+tg7y9I+T7jUK8rp+e869cVupsv6p0LnnVbqFk1e8YxQcYUiWN3CqU6KhqQgxU1spJPRnGG4BQdXXwHangoFkqWLwx+G45bzWK88UbZ+9zudf7ufW+5J7sSdf7Hc4EGrhRyN+aPPtOod9ONg4ahsbixd73aQaGOfj2zu31W+1f+Ha9zH4qL1I/sxc5aL9I9Zbu5P4Wbya/Uzr74UU7vZm8T6ifmY3GUU4i1ElD1+glb6GIp1E0e1hx4hCnvkOC2AQhSYjbrVHmcYmCdpjmcDidnvEHAyW+hhitElWpU+jDYT8rdHtQ9SJOm4Tea6nQj3LgkQhd03Oa3tPMdyT0XX9aqV/ocVXGErBOFQi5Kxkdw5c0iz8nXjr8WjL7x5iV3I4GfIUicBYXUeEkHqWhePBkyv47HkERxaHXddG6GHMyzmWriBKQijLJXK4a8xiW0a8CjNnSS7O4LFvus1iR2Eo7WJKk4lCIWH0LTxUtkOuWPB9WBNzecSSD3Ba9/GU1FTyR+VX/WO6BaRTQcBuIaEFAoQhIyr/HFQtfK3lF6i7CC0xCD0ULlrrmzWrdov9xHHHKsKLTSdMsvERVIk2rzNk7QJosuXkVUZiCzeOS5u3/&lt;/diagram&gt;&lt;/mxfile&gt;"><defs/><g><rect x="0" y="0" width="1070" height="480" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><path d="M 598.24 250 L 641.76 250" fill="none" stroke="rgb(0, 0, 0)" stroke-width="2" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 592.24 250 L 600.24 246 L 598.24 250 L 600.24 254 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 647.76 250 L 639.76 254 L 641.76 250 L 639.76 246 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><rect x="20" y="40" width="570" height="420" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 568px; height: 1px; padding-top: 47px; margin-left: 21px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Source Code Module</div></div></div></foreignObject><text x="305" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Source Code Module</text></switch></g><rect x="650" y="40" width="390" height="420" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 388px; height: 1px; padding-top: 47px; margin-left: 651px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Semantic Graph Module</div></div></div></foreignObject><text x="845" y="59" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Semantic Graph Module</text></switch></g><rect x="45" y="75" width="520" height="370" fill="#fffcf4" stroke="rgb(0, 0, 0)" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe flex-start; width: 508px; height: 1px; padding-top: 260px; margin-left: 57px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 14px; font-family: &quot;Courier New&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; font-weight: bold; white-space: normal; overflow-wrap: normal;">const <font style="color: rgb(0, 102, 204);">capsule</font> = await Capsule({<div>  '<font style="color: rgb(204, 102, 0);">#@&lt;org&gt;/&lt;project&gt;/structs/StructA</font>': {</div><div>    as: <span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">'</span><font style="color: rgb(153, 51, 255);"><span style="background-color: transparent;">$#</span><span style="background-color: transparent;">@&lt;org&gt;/&lt;project&gt;/AspectX</span></font><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">'</span></div><div>  }</div><div>  '#'{ </div><div>    <font style="color: rgb(0, 153, 0);">property1</font>: 'val1',</div><div>    <font style="color: rgb(204, 0, 102);">mapping1</font>: '<span style="background-color: transparent;"><font style="color: rgb(204, 0, 102);">@&lt;org&gt;/&lt;project&gt;/FeatureY</font></span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">',</span></div><div>    <font style="color: rgb(0, 153, 0);">method1</font>: () =&gt; {</div><div><div>      this.<span style="background-color: transparent;"><font style="color: light-dark(rgb(204, 0, 102), rgb(255, 255, 255));">mapping1</font></span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">.featureMethod()</span></div></div><div>      this['<font style="color: rgb(153, 51, 255);"><span style="background-color: transparent;">$#</span><span style="background-color: transparent;">@&lt;org&gt;/&lt;project&gt;/AspectX</span></font><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">'</span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">]</span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">.instanceMethod2()</span></div><div>    }</div><div>  }<br />}, {<div>  capsuleName: '<font style="color: rgb(0, 102, 204);"><span style="background-color: transparent;">@&lt;org&gt;/&lt;project&gt;/</span><span style="background-color: transparent;">MyCapsule</span></font><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">'</span></div><div><div>})</div></div></div><div><br /></div><div><font style="color: rgb(0, 102, 204);">capsule</font>.<span style="background-color: transparent;"><font style="color: light-dark(rgb(0, 153, 0), rgb(255, 255, 255));">property1</font></span></div><div><font style="color: rgb(0, 102, 204);">capsule</font>.<span style="background-color: transparent;"><font style="color: light-dark(rgb(0, 153, 0), rgb(255, 255, 255));">method1</font></span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">()</span></div><div><div><font style="color: rgb(0, 102, 204);">capsule</font>.<span style="color: rgb(204, 0, 102); background-color: transparent;">mapping1</span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">.featureMethod</span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">()</span></div></div><div><div><div><font style="color: rgb(0, 102, 204);">capsule</font>['<font style="color: rgb(204, 102, 0);">#@&lt;org&gt;/&lt;project&gt;/structs/StructA</font><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">'</span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">].protoMethod1</span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">()</span></div></div><div><font style="color: rgb(0, 102, 204);">capsule</font>['<font style="color: rgb(153, 51, 255);"><span style="background-color: transparent;">$#</span><span style="background-color: transparent;">@&lt;org&gt;/&lt;project&gt;/AspectX</span></font><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">'</span><span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">].</span>instanceMethod2<span style="background-color: transparent; color: light-dark(rgb(0, 0, 0), rgb(255, 255, 255));">()</span></div></div></div></div></div></foreignObject><text x="57" y="264" fill="rgb(0, 0, 0)" font-family="Courier New" font-size="14px" font-weight="bold">const capsule = await Capsule({...</text></switch></g><rect x="675" y="90" width="340" height="340" fill="rgb(255, 255, 255)" stroke="none" pointer-events="all"/><ellipse cx="845" cy="260" rx="170" ry="170" fill="#fffcf4" stroke="rgb(0, 0, 0)" pointer-events="all"/><path d="M 809.86 158.74 L 850.14 231.26" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><ellipse cx="805" cy="150" rx="10" ry="10" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><path d="M 737.73 270.38 L 752.25 219.62" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><ellipse cx="735" cy="280" rx="10" ry="10" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><path d="M 865 240 L 955 240" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 859.54 248.91 L 907.93 342.93" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 849.45 248.32 L 780.55 351.68" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 845.5 243.11 L 744.49 276.84" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><ellipse cx="855" cy="240" rx="10" ry="10" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><ellipse cx="915" cy="350" rx="10" ry="10" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><ellipse cx="965" cy="240" rx="10" ry="10" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><ellipse cx="775" cy="360" rx="10" ry="10" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><path d="M 784.98 359.31 L 905.03 350.71" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 912.07 187.07 L 957.93 232.93" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><ellipse cx="905" cy="180" rx="10" ry="10" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><ellipse cx="755" cy="210" rx="10" ry="10" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/><path d="M 797.93 142.93 L 765.1 110.06" fill="none" stroke="#3399ff" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><path d="M 923.49 344.72 L 1013.98 288.9" fill="none" stroke="#3399ff" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><path d="M 725.36 282.68 L 680.1 295.02" fill="none" stroke="#3399ff" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="870" y="0" width="185" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 183px; height: 1px; padding-top: 15px; margin-left: 870px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: right;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">(c) 2026 <a href="https://christoph.diy">Christoph.diy</a> CC BY</div></div></div></foreignObject><text x="1053" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="end">(c) 2026 Christoph.diy CC BY</text></switch></g><rect x="350" y="0" width="420" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe flex-start; width: 418px; height: 1px; padding-top: 15px; margin-left: 352px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Encapsulate: Source Code / Semantic Graph Isomorphism - v0.1</div></div></div></foreignObject><text x="352" y="19" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px">Encapsulate: Source Code / Semantic Graph Isomorphism - v0.1</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.diagrams.net/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@stream44.studio/encapsulate",
-    "version": "0.4.0-rc.23",
+    "version": "0.4.0-rc.25",
     "license": "MIT",
     "repository": {
         "type": "git",

package/src/capsule-projectors/CapsuleModuleProjector.v0.ts

@@ -103,6 +103,7 @@ export function CapsuleModuleProjector({
     projectionStore,
     projectionCacheStore,
     spineFilesystemRoot,
+    capsuleModuleProjectionRoot,
     capsuleModuleProjectionPackage,
     timing
 }: {
@@ -120,6 +121,7 @@ export function CapsuleModuleProjector({
         getStats?: (filepath: string) => Promise<{ mtime: Date } | null>
     },
     spineFilesystemRoot: string,
+    capsuleModuleProjectionRoot?: string,
     capsuleModuleProjectionPackage?: string,
     timing?: { record: (step: string) => void, chalk?: any }
 }) {
@@ -739,6 +741,18 @@ export function CapsuleModuleProjector({
             delete ambientReferences['makeImportStack']
         }
 
+        // Compute the relative path from the projected caps file directory
+        // back to the original source file directory so that relative imports
+        // in the caps file resolve to the original source location.
+        const absSourceDir = dirname(join(spineFilesystemRoot, capsule.cst.source.moduleFilepath))
+        const projectionRoot = capsuleModuleProjectionRoot || spineFilesystemRoot
+        const absCapsDir = dirname(join(projectionRoot, filepath))
+        const capsToSourcePrefix = relative(absCapsDir, absSourceDir)
+        function rewriteRelativeModuleUri(moduleUri: string): string {
+            if (!moduleUri.startsWith('./') && !moduleUri.startsWith('../')) return moduleUri
+            return capsToSourcePrefix + '/' + moduleUri.replace(/^\.\//, '')
+        }
+
         const importStatements = Object.entries(ambientReferences)
             .map(([name, ref]: [string, any]) => {
                 if (ref.type === 'import') {
@@ -748,7 +762,7 @@ export function CapsuleModuleProjector({
                         const cssPath = cssImportMapping[ref.moduleUri] || ref.moduleUri
                         return `import '${cssPath}'`
                     }
-                    return `import ${ref.importSpecifier} from '${ref.moduleUri}'`
+                    return `import ${ref.importSpecifier} from '${rewriteRelativeModuleUri(ref.moduleUri)}'`
                 }
                 if (ref.type === 'assigned') {
                     // If the assignment comes from a spine-factory module, import from encapsulate.ts instead

package/src/encapsulate.ts

@@ -1,7 +1,7 @@
 
 // CACHE_BUST_VERSION: Increment this whenever CST cache must be invalidated due to structural changes
 // This ensures projected capsules are regenerated when the CST format changes
-const CACHE_BUST_VERSION = 18
+const CACHE_BUST_VERSION = 21
 
 type TSpineOptions = {
     spineFilesystemRoot?: string,
@@ -53,7 +53,9 @@ type TCapsuleMakeInstanceOptions = {
         capsuleName: string,
         capsuleSourceLineRef: string,
         moduleFilepath: string
-    }
+    },
+    parentCapsuleSourceUriLineRefInstanceId?: string,
+    sit?: { capsuleInstances: Record<string, { capsuleName: string, capsuleSourceUriLineRef: string, parentCapsuleSourceUriLineRefInstanceId: string }> }
 }
 
 type TCapsule = {
@@ -552,7 +554,7 @@ async function encapsulate(definition: TCapsuleDefinition, options: TCapsuleOpti
         encapsulateOptions,
         cst,
         crt: crts?.[capsuleSourceLineRef],
-        makeInstance: async ({ overrides = {}, options = {}, runtimeSpineContracts, sharedSelf, rootCapsule }: TCapsuleMakeInstanceOptions = {}) => {
+        makeInstance: async ({ overrides = {}, options = {}, runtimeSpineContracts, sharedSelf, rootCapsule, parentCapsuleSourceUriLineRefInstanceId, sit }: TCapsuleMakeInstanceOptions = {}) => {
 
             // Create cache key based on parameters
             // When sharedSelf is provided, we must NOT cache because each extending capsule
@@ -811,8 +813,27 @@ async function encapsulate(definition: TCapsuleDefinition, options: TCapsuleOpti
                             capsuleName: encapsulateOptions.capsuleName!,
                             capsuleSourceLineRef: absoluteCapsuleSourceLineRef,
                             moduleFilepath: absoluteModuleFilepath
-                        }
+                        },
+                        parentCapsuleSourceUriLineRefInstanceId: parentCapsuleSourceUriLineRefInstanceId
+                            ? sha256(parentCapsuleSourceUriLineRefInstanceId + ':' + (cst?.capsuleSourceUriLineRef || encapsulateOptions.capsuleSourceLineRef))
+                            : sha256(cst?.capsuleSourceUriLineRef || encapsulateOptions.capsuleSourceLineRef),
+                        sit
                     })
+
+                    // Propagate this (child) capsule's encapsulatedApi to all parent spine contract
+                    // instances up the extends chain, so parent functions can resolve child Function
+                    // properties via this (e.g. Engine.mergeNode calling this._mergeNode from QueryAPI).
+                    // Each ancestor accumulates child APIs so the proxy can check all levels.
+                    let ancestor = extendedCapsuleInstance
+                    while (ancestor) {
+                        for (const sci of Object.values(ancestor.spineContractCapsuleInstances || {})) {
+                            if (!(sci as any).childEncapsulatedApis) {
+                                (sci as any).childEncapsulatedApis = []
+                            }
+                            ; (sci as any).childEncapsulatedApis.push(encapsulatedApi)
+                        }
+                        ancestor = ancestor.extendedCapsuleInstance
+                    }
                 }
 
                 // Resolve the root capsule for this instance:
@@ -827,6 +848,23 @@ async function encapsulate(definition: TCapsuleDefinition, options: TCapsuleOpti
                 capsuleMetadataStruct.rootCapsule.capsuleSourceLineRef = resolvedRootCapsule.capsuleSourceLineRef
                 capsuleMetadataStruct.rootCapsule.moduleFilepath = resolvedRootCapsule.moduleFilepath
 
+                // Compute deterministic instance ID:
+                //   root:  sha256(capsuleSourceUriLineRef)
+                //   child: sha256(parentCapsuleSourceUriLineRefInstanceId + ":" + capsuleSourceUriLineRef)
+                const capsuleSourceUriLineRef = cst?.capsuleSourceUriLineRef || encapsulateOptions.capsuleSourceLineRef
+                const capsuleSourceUriLineRefInstanceId = parentCapsuleSourceUriLineRefInstanceId
+                    ? sha256(parentCapsuleSourceUriLineRefInstanceId + ':' + capsuleSourceUriLineRef)
+                    : sha256(capsuleSourceUriLineRef)
+
+                // Register this instance in the sit structure if provided
+                if (sit) {
+                    sit.capsuleInstances[capsuleSourceUriLineRefInstanceId] = {
+                        capsuleName: encapsulateOptions.capsuleName || '',
+                        capsuleSourceUriLineRef,
+                        parentCapsuleSourceUriLineRefInstanceId: parentCapsuleSourceUriLineRefInstanceId || ''
+                    }
+                }
+
                 const capsuleInstance: any = {
                     api: encapsulatedApi,
                     spineContractCapsuleInstances,
@@ -836,7 +874,11 @@ async function encapsulate(definition: TCapsuleDefinition, options: TCapsuleOpti
                     initFunctions: [] as Array<() => any>,
                     disposeFunctions: [] as Array<() => any>,
                     mappedCapsuleInstances: [] as Array<any>,
-                    rootCapsule: resolvedRootCapsule
+                    rootCapsule: resolvedRootCapsule,
+                    capsuleSourceUriLineRefInstanceId,
+                    capsuleName: encapsulateOptions.capsuleName,
+                    capsuleSourceUriLineRef,
+                    sit
                 }
 
                 // Set capsule metadata struct on self early so it's available in options() callbacks during mapping
@@ -1062,6 +1104,17 @@ function relative(from: string, to: string): string {
     return result || '.'
 }
 
+function sha256(input: string): string {
+    // Use Bun's native hasher for speed; falls back to Node crypto
+    if (typeof globalThis.Bun !== 'undefined') {
+        const hasher = new globalThis.Bun.CryptoHasher('sha256')
+        hasher.update(input)
+        return hasher.digest('hex') as string
+    }
+    const { createHash } = require('crypto')
+    return createHash('sha256').update(input).digest('hex')
+}
+
 function isObject(item: any): boolean {
     if (!item || typeof item !== 'object' || Array.isArray(item)) return false
     // Only deep-merge plain objects — preserve instances like Map, Set, Date, etc.

package/src/spine-contracts/CapsuleSpineContract.v0/Membrane.v0.ts

@@ -6,6 +6,7 @@ type CallerContext = {
     capsuleSourceNameRef?: string
     spineContractCapsuleInstanceId: string
     capsuleSourceNameRefHash?: string
+    capsuleSourceUriLineRefInstanceId?: string
     prop?: string
     filepath?: string
     line?: number
@@ -53,7 +54,8 @@ function CapsuleMembrane(target: Record<string, any>, hooks?: {
 class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFactory {
     private getEventIndex: () => number
     private incrementEventIndex: () => number
-    private currentCallerContext: CallerContext | undefined
+    private getCurrentCallerContext: () => CallerContext | undefined
+    private setCurrentCallerContext: (ctx: CallerContext | undefined) => void
     private onMembraneEvent?: (event: any) => void
     private enableCallerStackInference: boolean
     private encapsulateOptions: any
@@ -77,7 +79,8 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
         encapsulateOptions,
         getEventIndex,
         incrementEventIndex,
-        currentCallerContext,
+        getCurrentCallerContext,
+        setCurrentCallerContext,
         runtimeSpineContracts,
         instanceRegistry,
         extendedCapsuleInstance,
@@ -97,7 +100,8 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
         encapsulateOptions: any
         getEventIndex: () => number
         incrementEventIndex: () => number
-        currentCallerContext?: CallerContext
+        getCurrentCallerContext: () => CallerContext | undefined
+        setCurrentCallerContext: (ctx: CallerContext | undefined) => void
         runtimeSpineContracts?: Record<string, any>
         instanceRegistry?: CapsuleInstanceRegistry
         extendedCapsuleInstance?: any
@@ -106,7 +110,8 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
         super({ spineContractUri, capsule, self, ownSelf, encapsulatedApi, resolve, importCapsule, spineFilesystemRoot, freezeCapsule, instanceRegistry, extendedCapsuleInstance, capsuleInstance })
         this.getEventIndex = getEventIndex
         this.incrementEventIndex = incrementEventIndex
-        this.currentCallerContext = currentCallerContext
+        this.getCurrentCallerContext = getCurrentCallerContext
+        this.setCurrentCallerContext = setCurrentCallerContext
         this.onMembraneEvent = onMembraneEvent
         this.enableCallerStackInference = enableCallerStackInference
         this.encapsulateOptions = encapsulateOptions
@@ -116,8 +121,16 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
         this.id = `$${encapsulateOptions.capsuleSourceLineRef}`
     }
 
-    setCurrentCallerContext(context: CallerContext | undefined): void {
-        this.currentCallerContext = context
+    private buildCallerContext(prop?: string): CallerContext {
+        const ctx: CallerContext = {
+            capsuleSourceLineRef: this.encapsulateOptions.capsuleSourceLineRef,
+            spineContractCapsuleInstanceId: this.id,
+        }
+        if (prop) ctx.prop = prop
+        if (this.capsuleSourceNameRef) ctx.capsuleSourceNameRef = this.capsuleSourceNameRef
+        if (this.capsuleSourceNameRefHash) ctx.capsuleSourceNameRefHash = this.capsuleSourceNameRefHash
+        if (this.capsuleInstance?.capsuleSourceUriLineRefInstanceId) ctx.capsuleSourceUriLineRefInstanceId = this.capsuleInstance.capsuleSourceUriLineRefInstanceId
+        return ctx
     }
 
     protected async mapMappingProperty({ overrides, options, property }: { overrides: any, options: any, property: any }) {
@@ -155,25 +168,23 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
                                 throw new Error(`Capsule instance not yet resolved: ${capsuleName}`)
                             }
 
-                            this.currentCallerContext = {
-                                capsuleSourceLineRef: this.encapsulateOptions.capsuleSourceLineRef,
-                                capsuleSourceNameRef: this.capsuleSourceNameRef,
-                                spineContractCapsuleInstanceId: this.id,
-                                capsuleSourceNameRefHash: this.capsuleSourceNameRefHash,
-                                prop: apiProp as string
-                            }
-
-                            if (this.enableCallerStackInference) {
-                                const stackStr = new Error('[MAPPED_CAPSULE]').stack
-                                if (stackStr) {
-                                    const stackFrames = parseCallerFromStack(stackStr, this.spineFilesystemRoot)
-                                    if (stackFrames.length > 0) {
-                                        const callerInfo = extractCallerInfo(stackFrames, 3)
-                                        this.currentCallerContext.filepath = callerInfo.filepath
-                                        this.currentCallerContext.line = callerInfo.line
-                                        this.currentCallerContext.stack = stackFrames
+                            // Only update caller context if not already set by a function/getter execution
+                            if (!this.getCurrentCallerContext()) {
+                                const callerCtx = this.buildCallerContext(undefined)
+
+                                if (this.enableCallerStackInference) {
+                                    const stackStr = new Error('[MAPPED_CAPSULE]').stack
+                                    if (stackStr) {
+                                        const stackFrames = parseCallerFromStack(stackStr, this.spineFilesystemRoot)
+                                        if (stackFrames.length > 0) {
+                                            const callerInfo = extractCallerInfo(stackFrames, 3)
+                                            callerCtx.filepath = callerInfo.filepath
+                                            callerCtx.line = callerInfo.line
+                                            callerCtx.stack = stackFrames
+                                        }
                                     }
                                 }
+                                this.setCurrentCallerContext(callerCtx)
                             }
 
                             // Access through .api if it exists (for capsule instances with getters)
@@ -280,25 +291,23 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
             get: (apiTarget: any, apiProp: string | symbol) => {
                 if (typeof apiProp === 'symbol') return apiTarget[apiProp]
 
-                this.currentCallerContext = {
-                    capsuleSourceLineRef: this.encapsulateOptions.capsuleSourceLineRef,
-                    capsuleSourceNameRef: this.capsuleSourceNameRef,
-                    spineContractCapsuleInstanceId: this.id,
-                    capsuleSourceNameRefHash: this.capsuleSourceNameRefHash,
-                    prop: apiProp as string
-                }
-
-                if (this.enableCallerStackInference) {
-                    const stackStr = new Error('[MAPPED_CAPSULE]').stack
-                    if (stackStr) {
-                        const stackFrames = parseCallerFromStack(stackStr, this.spineFilesystemRoot)
-                        if (stackFrames.length > 0) {
-                            const callerInfo = extractCallerInfo(stackFrames, 3)
-                            this.currentCallerContext.filepath = callerInfo.filepath
-                            this.currentCallerContext.line = callerInfo.line
-                            this.currentCallerContext.stack = stackFrames
+                // Only update caller context if not already set by a function/getter execution
+                if (!this.getCurrentCallerContext()) {
+                    const callerCtx = this.buildCallerContext(undefined)
+
+                    if (this.enableCallerStackInference) {
+                        const stackStr = new Error('[MAPPED_CAPSULE]').stack
+                        if (stackStr) {
+                            const stackFrames = parseCallerFromStack(stackStr, this.spineFilesystemRoot)
+                            if (stackFrames.length > 0) {
+                                const callerInfo = extractCallerInfo(stackFrames, 3)
+                                callerCtx.filepath = callerInfo.filepath
+                                callerCtx.line = callerInfo.line
+                                callerCtx.stack = stackFrames
+                            }
                         }
                     }
+                    this.setCurrentCallerContext(callerCtx)
                 }
 
                 // Access through .api if it exists (for capsule instances with getters)
@@ -345,25 +354,23 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
                     // Wrap the property access in a proxy to track membrane events
                     Object.defineProperty(delegateTarget, key, {
                         get: () => {
-                            this.currentCallerContext = {
-                                capsuleSourceLineRef: this.encapsulateOptions.capsuleSourceLineRef,
-                                capsuleSourceNameRef: this.capsuleSourceNameRef,
-                                spineContractCapsuleInstanceId: this.id,
-                                capsuleSourceNameRefHash: this.capsuleSourceNameRefHash,
-                                prop: key
-                            }
-
-                            if (this.enableCallerStackInference) {
-                                const stackStr = new Error('[PROPERTY_CONTRACT_DELEGATE]').stack
-                                if (stackStr) {
-                                    const stackFrames = parseCallerFromStack(stackStr, this.spineFilesystemRoot)
-                                    if (stackFrames.length > 0) {
-                                        const callerInfo = extractCallerInfo(stackFrames, 3)
-                                        this.currentCallerContext.filepath = callerInfo.filepath
-                                        this.currentCallerContext.line = callerInfo.line
-                                        this.currentCallerContext.stack = stackFrames
+                            // Only update caller context if not already set by a function/getter execution
+                            if (!this.getCurrentCallerContext()) {
+                                const callerCtx = this.buildCallerContext(undefined)
+
+                                if (this.enableCallerStackInference) {
+                                    const stackStr = new Error('[PROPERTY_CONTRACT_DELEGATE]').stack
+                                    if (stackStr) {
+                                        const stackFrames = parseCallerFromStack(stackStr, this.spineFilesystemRoot)
+                                        if (stackFrames.length > 0) {
+                                            const callerInfo = extractCallerInfo(stackFrames, 3)
+                                            callerCtx.filepath = callerInfo.filepath
+                                            callerCtx.line = callerInfo.line
+                                            callerCtx.stack = stackFrames
+                                        }
                                     }
                                 }
+                                this.setCurrentCallerContext(callerCtx)
                             }
 
                             // Access the actual value from the instance's api
@@ -513,6 +520,9 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
                         if (this.capsuleSourceNameRefHash) {
                             callEvent.target.capsuleSourceNameRefHash = this.capsuleSourceNameRefHash
                         }
+                        if (this.capsuleInstance?.capsuleSourceUriLineRefInstanceId) {
+                            callEvent.target.capsuleSourceUriLineRefInstanceId = this.capsuleInstance.capsuleSourceUriLineRefInstanceId
+                        }
 
                         this.addCallerContextToEvent(callEvent)
                         this.onMembraneEvent?.(callEvent)
@@ -550,11 +560,18 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
                     if (this.capsuleSourceNameRefHash) {
                         callEvent.target.capsuleSourceNameRefHash = this.capsuleSourceNameRefHash
                     }
+                    if (this.capsuleInstance?.capsuleSourceUriLineRefInstanceId) {
+                        callEvent.target.capsuleSourceUriLineRefInstanceId = this.capsuleInstance.capsuleSourceUriLineRefInstanceId
+                    }
 
                     this.addCallerContextToEvent(callEvent)
                     this.onMembraneEvent?.(callEvent)
 
+                    // Set this capsule as caller for any inner membrane events triggered by the function body
+                    const previousCallerContext = this.getCurrentCallerContext()
+                    this.setCurrentCallerContext(this.buildCallerContext(property.name))
                     const result = boundFunction(...args)
+                    this.setCurrentCallerContext(previousCallerContext)
 
                     // Store in memoize cache if memoize is enabled
                     if (shouldMemoize) {
@@ -635,8 +652,11 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
                     return cachedResult
                 }
 
-                // Call the getter function lazily when accessed with proper this context
+                // Set this capsule as caller for any inner membrane events triggered by the getter body
+                const previousCallerContext = this.getCurrentCallerContext()
+                this.setCurrentCallerContext(this.buildCallerContext(property.name))
                 const result = getterFn.call(selfProxy)
+                this.setCurrentCallerContext(previousCallerContext)
 
                 // Store in memoize cache if memoize is enabled
                 if (shouldMemoize) {
@@ -693,28 +713,32 @@ class MembraneContractCapsuleInstanceFactory extends ContractCapsuleInstanceFact
     }
 
     private addCallerContextToEvent(event: any): void {
-        if (this.currentCallerContext) {
+        const callerCtx = this.getCurrentCallerContext()
+        if (callerCtx) {
             event.caller = {
-                capsuleSourceLineRef: this.currentCallerContext.capsuleSourceLineRef,
-                spineContractCapsuleInstanceId: this.currentCallerContext.spineContractCapsuleInstanceId,
+                capsuleSourceLineRef: callerCtx.capsuleSourceLineRef,
+                spineContractCapsuleInstanceId: callerCtx.spineContractCapsuleInstanceId,
+            }
+            if (callerCtx.capsuleSourceNameRef) {
+                event.caller.capsuleSourceNameRef = callerCtx.capsuleSourceNameRef
             }
-            if (this.currentCallerContext.capsuleSourceNameRef) {
-                event.caller.capsuleSourceNameRef = this.currentCallerContext.capsuleSourceNameRef
+            if (callerCtx.capsuleSourceNameRefHash) {
+                event.caller.capsuleSourceNameRefHash = callerCtx.capsuleSourceNameRefHash
             }
-            if (this.currentCallerContext.capsuleSourceNameRefHash) {
-                event.caller.capsuleSourceNameRefHash = this.currentCallerContext.capsuleSourceNameRefHash
+            if (callerCtx.capsuleSourceUriLineRefInstanceId) {
+                event.caller.capsuleSourceUriLineRefInstanceId = callerCtx.capsuleSourceUriLineRefInstanceId
             }
-            if (this.currentCallerContext.prop) {
-                event.caller.prop = this.currentCallerContext.prop
+            if (callerCtx.prop) {
+                event.caller.prop = callerCtx.prop
             }
-            if (this.currentCallerContext.filepath) {
-                event.caller.filepath = this.currentCallerContext.filepath
+            if (callerCtx.filepath) {
+                event.caller.filepath = callerCtx.filepath
             }
-            if (this.currentCallerContext.line) {
-                event.caller.line = this.currentCallerContext.line
+            if (callerCtx.line) {
+                event.caller.line = callerCtx.line
             }
-            if (this.currentCallerContext.stack) {
-                event.caller.stack = this.currentCallerContext.stack
+            if (callerCtx.stack) {
+                event.caller.stack = callerCtx.stack
             }
         } else if (this.enableCallerStackInference) {
             const stackStr = new Error('[MEMBRANE_EVENT]').stack
@@ -771,7 +795,8 @@ export function CapsuleSpineContract({
                 encapsulateOptions,
                 getEventIndex: () => eventIndex,
                 incrementEventIndex: () => eventIndex++,
-                currentCallerContext,
+                getCurrentCallerContext: () => currentCallerContext,
+                setCurrentCallerContext: (ctx: CallerContext | undefined) => { currentCallerContext = ctx },
                 runtimeSpineContracts,
                 instanceRegistry,
                 extendedCapsuleInstance,

package/src/spine-contracts/CapsuleSpineContract.v0/Static.v0.ts

@@ -16,6 +16,7 @@ export class ContractCapsuleInstanceFactory {
     protected instanceRegistry?: CapsuleInstanceRegistry
     protected extendedCapsuleInstance?: any
     protected ownSelf?: any
+    public childEncapsulatedApis?: Record<string, any>[]
     protected runtimeSpineContracts?: Record<string, any>
     protected capsuleInstance?: any
     public structInitFunctions: Array<() => any> = []
@@ -61,7 +62,9 @@ export class ContractCapsuleInstanceFactory {
             overrides: overrides || {},
             options: options,
             runtimeSpineContracts: this.runtimeSpineContracts,
-            rootCapsule: this.capsuleInstance?.rootCapsule
+            rootCapsule: this.capsuleInstance?.rootCapsule,
+            parentCapsuleSourceUriLineRefInstanceId: this.capsuleInstance?.capsuleSourceUriLineRefInstanceId,
+            sit: this.capsuleInstance?.sit
         })
 
         // Run init functions on the imported capsule instance
@@ -310,7 +313,9 @@ export class ContractCapsuleInstanceFactory {
             overrides: mappedOverrides,
             options: ownMappingOptions,
             runtimeSpineContracts: this.runtimeSpineContracts,
-            rootCapsule: this.capsuleInstance?.rootCapsule
+            rootCapsule: this.capsuleInstance?.rootCapsule,
+            parentCapsuleSourceUriLineRefInstanceId: this.capsuleInstance?.capsuleSourceUriLineRefInstanceId,
+            sit: this.capsuleInstance?.sit
         })
 
         // Register the instance (replaces null pre-registration marker)
@@ -369,6 +374,7 @@ export class ContractCapsuleInstanceFactory {
     protected createSelfProxy() {
         const extendedApi = this.extendedCapsuleInstance?.api
         const ownSelf = this.ownSelf
+        const factory = this
         return new Proxy(this.self, {
             get: (target: any, prop: string | symbol) => {
                 if (typeof prop === 'symbol') return target[prop]
@@ -384,8 +390,15 @@ export class ContractCapsuleInstanceFactory {
                 }
 
                 // Fall back to encapsulatedApi
-                if (prop in this.encapsulatedApi) {
-                    return this.encapsulatedApi[prop]
+                if (prop in factory.encapsulatedApi) {
+                    return factory.encapsulatedApi[prop]
+                }
+
+                // Fall back to child capsule APIs (for parent→child function delegation)
+                if (factory.childEncapsulatedApis) {
+                    for (const childApi of factory.childEncapsulatedApis) {
+                        if (prop in childApi) return childApi[prop]
+                    }
                 }
 
                 // Fall back to extended capsule's API
@@ -393,6 +406,35 @@ export class ContractCapsuleInstanceFactory {
                     return extendedApi[prop]
                 }
 
+                return undefined
+            },
+            ownKeys: (target: any) => {
+                const keys = new Set<string>(Object.keys(target))
+                for (const k of Object.keys(factory.encapsulatedApi)) keys.add(k)
+                if (factory.childEncapsulatedApis) {
+                    for (const childApi of factory.childEncapsulatedApis) {
+                        for (const k of Object.keys(childApi)) keys.add(k)
+                    }
+                }
+                if (extendedApi) {
+                    for (const k of Object.keys(extendedApi)) keys.add(k)
+                }
+                return [...keys]
+            },
+            set: (target: any, prop: string | symbol, value: any) => {
+                target[prop] = value
+                return true
+            },
+            getOwnPropertyDescriptor: (target: any, prop: string | symbol) => {
+                if (typeof prop === 'symbol') return Object.getOwnPropertyDescriptor(target, prop)
+                if (prop in target) return Object.getOwnPropertyDescriptor(target, prop)
+                if (prop in factory.encapsulatedApi) return { configurable: true, enumerable: true, writable: true, value: factory.encapsulatedApi[prop as string] }
+                if (factory.childEncapsulatedApis) {
+                    for (const childApi of factory.childEncapsulatedApis) {
+                        if (prop in childApi) return { configurable: true, enumerable: true, writable: true, value: childApi[prop as string] }
+                    }
+                }
+                if (extendedApi && prop in extendedApi) return { configurable: true, enumerable: true, writable: true, value: extendedApi[prop as string] }
                 return undefined
             }
         })

package/src/spine-factories/CapsuleSpineFactory.v0.ts

@@ -473,6 +473,7 @@ export async function CapsuleSpineFactory({
             },
         },
         spineFilesystemRoot,
+        capsuleModuleProjectionRoot,
         capsuleModuleProjectionPackage,
         timing
     }) : undefined
@@ -570,13 +571,138 @@ export async function CapsuleSpineFactory({
         return capsule
     }
 
+    // Wrap freeze to also write spine instance (.sit.json) files
+    const wrappedFreeze = async function () {
+        const snapshot = await freeze()
+
+        // Write spine instance files if capsuleModuleProjectionRoot is available
+        if (capsuleModuleProjectionRoot) {
+            try {
+                // Deduplicate capsules: the capsules dict has entries keyed by both
+                // capsuleSourceLineRef and capsuleName — only process capsuleSourceLineRef keys
+                const uniqueCapsules: Record<string, any> = {}
+                for (const [key, capsule] of Object.entries(capsules)) {
+                    if (key.includes(':') && /:\d+$/.test(key)) {
+                        uniqueCapsules[key] = capsule
+                    }
+                }
+
+                // Find root capsules — capsules that are NOT referenced as mapped dependencies
+                const mappedCapsuleNames = new Set<string>()
+                for (const [, capsule] of Object.entries(uniqueCapsules)) {
+                    const cst = capsule.cst
+                    if (cst?.spineContracts) {
+                        for (const [, spineContract] of Object.entries(cst.spineContracts) as any) {
+                            if (spineContract.propertyContracts) {
+                                for (const [, propContract] of Object.entries(spineContract.propertyContracts) as any) {
+                                    if (propContract.properties) {
+                                        for (const [, propDef] of Object.entries(propContract.properties) as any) {
+                                            if (propDef.type === 'CapsulePropertyTypes.Mapping' && propDef.mappedModuleUri) {
+                                                mappedCapsuleNames.add(propDef.mappedModuleUri)
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    if (cst?.source?.extendsCapsuleUri) {
+                        mappedCapsuleNames.add(cst.source.extendsCapsuleUri)
+                    }
+                }
+
+                for (const [, capsule] of Object.entries(uniqueCapsules)) {
+                    const cst = capsule.cst
+                    const rootCapsuleName = cst?.source?.capsuleName
+                    if (!rootCapsuleName) continue
+
+                    const moduleUri = cst?.source?.moduleUri
+                    if (mappedCapsuleNames.has(rootCapsuleName) || (moduleUri && mappedCapsuleNames.has(moduleUri))) {
+                        continue
+                    }
+
+                    // This is a root capsule — write its .sit.json
+                    const dirName = rootCapsuleName.replace(/\//g, '~')
+                    const sitDir = join(capsuleModuleProjectionRoot, '.~o/encapsulate.dev/spine-instances', dirName)
+                    const sitFilePath = join(sitDir, `root-capsule.sit.json`)
+
+                    // Build the capsules map
+                    const capsuleEntries: Record<string, { capsuleSourceUriLineRef: string }> = {}
+                    for (const [, cap] of Object.entries(uniqueCapsules)) {
+                        const capCst = cap.cst
+                        if (capCst?.source?.capsuleName) {
+                            capsuleEntries[capCst.source.capsuleName] = {
+                                capsuleSourceUriLineRef: capCst.capsuleSourceUriLineRef
+                            }
+                        }
+                    }
+
+                    // Collect capsuleInstances from the cached root instance using an
+                    // iterative stack — each instance stores its ID and parent ID from init
+                    const rootInstance = await capsule.makeInstance()
+                    const capsuleInstances: Record<string, { capsuleName: string, capsuleSourceUriLineRef: string, parentCapsuleSourceUriLineRefInstanceId: string }> = {}
+
+                    // If the root instance has a sit with pre-populated capsuleInstances, use it directly
+                    if (rootInstance.sit?.capsuleInstances && Object.keys(rootInstance.sit.capsuleInstances).length > 0) {
+                        Object.assign(capsuleInstances, rootInstance.sit.capsuleInstances)
+                    } else {
+                        // Iterative stack-based collection from instance tree
+                        const stack: Array<{ instance: any, parentId: string }> = [{ instance: rootInstance, parentId: '' }]
+                        const visited = new Set<string>()
+                        while (stack.length > 0) {
+                            const { instance, parentId } = stack.pop()!
+                            if (!instance?.capsuleSourceUriLineRefInstanceId) continue
+                            const id = instance.capsuleSourceUriLineRefInstanceId
+                            if (visited.has(id)) continue
+                            visited.add(id)
+
+                            capsuleInstances[id] = {
+                                capsuleName: instance.capsuleName || '',
+                                capsuleSourceUriLineRef: instance.capsuleSourceUriLineRef || '',
+                                parentCapsuleSourceUriLineRefInstanceId: parentId
+                            }
+
+                            if (instance.extendedCapsuleInstance) {
+                                stack.push({ instance: instance.extendedCapsuleInstance, parentId: id })
+                            }
+                            if (instance.mappedCapsuleInstances) {
+                                for (const mapped of instance.mappedCapsuleInstances) {
+                                    stack.push({ instance: mapped, parentId: id })
+                                }
+                            }
+                        }
+                    }
+
+                    const rootInstanceId = rootInstance.capsuleSourceUriLineRefInstanceId || ''
+
+                    const sitData = {
+                        rootCapsule: {
+                            capsuleSourceUriLineRef: cst.capsuleSourceUriLineRef,
+                            capsuleSourceUriLineRefInstanceId: rootInstanceId
+                        },
+                        capsules: capsuleEntries,
+                        capsuleInstances
+                    }
+
+                    await mkdir(sitDir, { recursive: true })
+                    await writeFile(sitFilePath, JSON.stringify(sitData, null, 2), 'utf-8')
+                }
+            } catch (error) {
+                // Spine instance file writing is best-effort
+                console.warn('Warning: Failed to write spine instance files:', error)
+            }
+        }
+
+        return snapshot
+    }
+
     return {
         commonSpineContractOpts,
         CapsulePropertyTypes,
         makeImportStack,
         encapsulate,
         run,
-        freeze,
+        freeze: wrappedFreeze,
         loadCapsule,
         spineContractInstances, // Expose for testing
         hoistSnapshot: async ({ snapshot }: { snapshot: any }) => {

package/src/static-analyzer.v0.ts

@@ -202,6 +202,11 @@ const MODULE_GLOBAL_BUILTINS = new Set([
     'Intl',
     'WebAssembly',
 
+    // Global scope references
+    'globalThis',
+    'window',
+    'global',
+
     // Global functions
     'isNaN',
     'isFinite',
@@ -366,7 +371,7 @@ export function StaticAnalyzer({
 
                     const capsuleSourceLineRef = `${encapsulateOptions.moduleFilepath}:${encapsulateOptions.importStackLine}`
                     const capsuleSourceNameRef = encapsulateOptions.capsuleName && `${encapsulateOptions.moduleFilepath}:${encapsulateOptions.capsuleName}`
-                    const capsuleSourceNameRefHash = capsuleSourceNameRef && createHash('md5').update(capsuleSourceNameRef).digest('hex')
+                    const capsuleSourceNameRefHash = capsuleSourceNameRef && createHash('sha256').update(capsuleSourceNameRef).digest('hex')
 
                     // Construct npm URI for the module - try for all modules
                     let moduleUri: string | null = await constructNpmUri(moduleFilepath, spineOptions.spineFilesystemRoot)
@@ -528,20 +533,39 @@ export function StaticAnalyzer({
                                             if (propName.startsWith('#')) {
                                                 const propertyContractUri = propName.substring(1) // Remove the '#' prefix
 
+                                                // Resolve relative property contract URIs to full npm URIs
+                                                let resolvedPropertyContractUri = propertyContractUri
+                                                let resolvedPropName = propName
+                                                if (propertyContractUri.startsWith('./') || propertyContractUri.startsWith('../')) {
+                                                    const resolvedPath = resolve(dirname(moduleFilepath), propertyContractUri)
+                                                    const npmUri = await constructNpmUri(resolvedPath + '.ts', spineOptions.spineFilesystemRoot)
+                                                    if (npmUri) {
+                                                        resolvedPropertyContractUri = npmUri.replace(/\.(ts|tsx|js|jsx)$/, '')
+                                                        resolvedPropName = '#' + resolvedPropertyContractUri
+                                                    }
+                                                }
+
                                                 if (ts.isObjectLiteralExpression(propValue)) {
                                                     // Create property contract entry
-                                                    if (!spineContractDef.propertyContracts[propName]) {
-                                                        spineContractDef.propertyContracts[propName] = {
-                                                            propertyContractUri,
+                                                    if (!spineContractDef.propertyContracts[resolvedPropName]) {
+                                                        spineContractDef.propertyContracts[resolvedPropName] = {
+                                                            propertyContractUri: resolvedPropertyContractUri,
                                                             properties: {}
                                                         }
                                                     }
 
-                                                    // Check for 'as' property at the property contract level
+                                                    // Check for 'as' and 'options' properties at the property contract level
                                                     for (const contractProp of propValue.properties) {
-                                                        if (ts.isPropertyAssignment(contractProp) && ts.isIdentifier(contractProp.name) && contractProp.name.text === 'as') {
-                                                            if (ts.isStringLiteral(contractProp.initializer)) {
-                                                                spineContractDef.propertyContracts[propName].as = contractProp.initializer.text
+                                                        if (ts.isPropertyAssignment(contractProp) && ts.isIdentifier(contractProp.name)) {
+                                                            if (contractProp.name.text === 'as') {
+                                                                if (ts.isStringLiteral(contractProp.initializer)) {
+                                                                    spineContractDef.propertyContracts[resolvedPropName].as = contractProp.initializer.text
+                                                                }
+                                                            } else if (contractProp.name.text === 'options') {
+                                                                // Store literal options object on the property contract for graph queries
+                                                                if (ts.isObjectLiteralExpression(contractProp.initializer)) {
+                                                                    spineContractDef.propertyContracts[resolvedPropName].options = await extractLiteralObject(contractProp.initializer, sourceFile, moduleFilepath, spineOptions.spineFilesystemRoot)
+                                                                }
                                                             }
                                                         }
                                                     }
@@ -632,6 +656,9 @@ export function StaticAnalyzer({
                                                                                 if (selfRefs.size > 0) {
                                                                                     propDef.depends = Array.from(selfRefs)
                                                                                 }
+                                                                            } else if (ts.isObjectLiteralExpression(fieldValue)) {
+                                                                                // Store literal options object in the CST for graph queries
+                                                                                propDef.options = await extractLiteralObject(fieldValue, sourceFile, moduleFilepath, spineOptions.spineFilesystemRoot)
                                                                             }
                                                                         } else if (fieldName === 'kind') {
                                                                             propDef.kind = fieldValue.getText(sourceFile)
@@ -643,7 +670,7 @@ export function StaticAnalyzer({
                                                                     }
                                                                 }
 
-                                                                spineContractDef.propertyContracts[propName].properties[contractPropName] = propDef
+                                                                spineContractDef.propertyContracts[resolvedPropName].properties[contractPropName] = propDef
                                                             }
                                                         }
                                                     }
@@ -2188,6 +2215,75 @@ function extractAndValidateAmbientReferences(
     return ambientRefs
 }
 
+// Extract a literal object from a TypeScript AST ObjectLiteralExpression.
+// Recursively walks the object tree and extracts string, number, boolean,
+// null values, arrays, and nested objects. String values that look like
+// relative paths (starting with ./ or ../) are resolved to npm URIs.
+async function extractLiteralObject(
+    node: ts.ObjectLiteralExpression,
+    sourceFile: ts.SourceFile,
+    moduleFilepath: string,
+    spineFilesystemRoot: string
+): Promise<Record<string, any>> {
+    const result: Record<string, any> = {}
+
+    for (const prop of node.properties) {
+        if (!ts.isPropertyAssignment(prop)) continue
+        let key: string | null = null
+        if (ts.isIdentifier(prop.name)) key = prop.name.text
+        else if (ts.isStringLiteral(prop.name)) key = prop.name.text
+        if (!key) continue
+
+        result[key] = await extractLiteralValue(prop.initializer, sourceFile, moduleFilepath, spineFilesystemRoot)
+    }
+
+    return result
+}
+
+// Extract a single literal value from a TS AST node.
+// Handles strings (with relative path resolution), numbers, booleans,
+// null, undefined, arrays, and nested objects.
+async function extractLiteralValue(
+    node: ts.Expression,
+    sourceFile: ts.SourceFile,
+    moduleFilepath: string,
+    spineFilesystemRoot: string
+): Promise<any> {
+    // String literals — resolve relative paths to npm URIs
+    if (ts.isStringLiteral(node)) {
+        const text = node.text
+        if (text.startsWith('./') || text.startsWith('../')) {
+            const resolvedPath = resolve(dirname(moduleFilepath), text)
+            const npmUri = await constructNpmUri(resolvedPath + '.ts', spineFilesystemRoot)
+            if (npmUri) return npmUri.replace(/\.(ts|tsx|js|jsx)$/, '')
+        }
+        return text
+    }
+    // Numeric literals
+    if (ts.isNumericLiteral(node)) return Number(node.text)
+    // Boolean literals
+    if (node.kind === ts.SyntaxKind.TrueKeyword) return true
+    if (node.kind === ts.SyntaxKind.FalseKeyword) return false
+    // Null
+    if (node.kind === ts.SyntaxKind.NullKeyword) return null
+    // Undefined
+    if (node.kind === ts.SyntaxKind.UndefinedKeyword) return undefined
+    // Nested objects
+    if (ts.isObjectLiteralExpression(node)) {
+        return await extractLiteralObject(node, sourceFile, moduleFilepath, spineFilesystemRoot)
+    }
+    // Arrays
+    if (ts.isArrayLiteralExpression(node)) {
+        const arr: any[] = []
+        for (const elem of node.elements) {
+            arr.push(await extractLiteralValue(elem, sourceFile, moduleFilepath, spineFilesystemRoot))
+        }
+        return arr
+    }
+    // Fallback: store the raw expression text
+    return node.getText(sourceFile)
+}
+
 // Check if a value is a literal type
 function isLiteralType(value: any): boolean {
     const type = typeof value