updated mcp

libs/dagpipe/site/state/index.html

@@ -362,6 +362,15 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#dagpipe.state--design-principles" class="md-nav__link">
+    <span class="md-ellipsis">
+      Design principles
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -990,6 +999,15 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#dagpipe.state--design-principles" class="md-nav__link">
+    <span class="md-ellipsis">
+      Design principles
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1274,29 +1292,25 @@
 
     <div class="doc doc-contents first">
 
-      <p>Defines the core State object used by dagpipe.</p>
-<hr />
-<h4 id="dagpipe.state--summary">Summary</h4>
-<p>The State represents a single point in pipeline execution. It contains
+      <h3 id="dagpipe.state--summary">Summary</h3>
+<p>Defines the core <code>State</code> object used by <code>dagpipe</code>.</p>
+<p>The <code>State</code> represents a single point in pipeline execution. It contains
 arbitrary data and metadata and is designed to be immutable. Instead of
-modifying an existing state, nodes create new child states via fork().</p>
+modifying an existing state, nodes create new child states via <code>fork()</code>.</p>
+<hr />
+<h3 id="dagpipe.state--design-principles">Design principles</h3>
+<ul>
+<li><strong>Immutability:</strong> States must never be modified after creation.
+  All transformations must create a new state via <code>fork()</code>.</li>
+<li><strong>Cheap cloning:</strong> Forking must be efficient since branching may create many states.</li>
+<li><strong>Lineage tracking:</strong> Each state maintains a reference to its parent and
+  execution metadata for debugging and observability.</li>
+<li><strong>Domain agnostic:</strong> State contains generic key-value data and does not
+  assume any schema.</li>
+<li><strong>Engine-friendly:</strong> State contains execution metadata such as depth and history.</li>
+</ul>
 
 
-<details class="notes" open>
-  <summary>Notes</summary>
-  <p><strong>Key design principles:</strong></p>
-<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
-<span class="normal">2</span>
-<span class="normal">3</span>
-<span class="normal">4</span>
-<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><code>- **Immutability:** States must never be modified after creation. All transformations must create a new state via fork().
-- **Cheap cloning:** Forking must be efficient since branching may create many states.
-- **Lineage tracking:** Each state maintains a reference to its parent and execution metadata for debugging and observability.
-- **Domain agnostic:** State contains generic key‑value data and does not assume any schema.
-- **Engine‑friendly:** State contains execution metadata such as depth and history.
-</code></pre></div></td></tr></table></div>
-</details>
-
 
   <div class="doc doc-children">
 
@@ -1358,8 +1372,10 @@ modifying an existing state, nodes create new child states via fork().</p>
   <summary>Notes</summary>
   <p><strong>Responsibilities:</strong></p>
 <div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
-<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><code>- Stores execution data used by State. Supports efficient atomic updates without modifying existing instances.
-- Payload instances are fully thread-safe due to immutability.
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>- Stores execution data used by `State`.
+- Supports efficient atomic updates without modifying existing instances.
+- `Payload` instances are fully thread-safe due to immutability.
 </code></pre></div></td></tr></table></div>
 </details>
 
@@ -1720,7 +1736,7 @@ Iterator over top-level keys.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Create a new Payload with dot-path updates applied.</p>
+      <p>Create a new <code>Payload</code> with dot-path updates applied.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1763,7 +1779,7 @@ Iterator over top-level keys.</p>
       <tbody>
           <tr class="doc-section-item">
 <td><code>Payload</code></td>            <td>
-                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.Payload" href="../dagpipe/state/#dagpipe.state.Payload">Payload</a></code>
+                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.Payload" href="#dagpipe.state.Payload">Payload</a></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -1778,7 +1794,9 @@ Iterator over top-level keys.</p>
 <details class="notes" open>
   <summary>Notes</summary>
   <p><strong>Guarantees:</strong></p>
-<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>- Preserves existing data by copying only modified branches. Returns a new immutable payload.
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
+<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><code>- Preserves existing data by copying only modified branches.
+- Returns a new immutable `Payload`.
 </code></pre></div></td></tr></table></div>
 </details>
     </div>
@@ -1844,7 +1862,9 @@ Iterator over top-level keys.</p>
   <summary>Notes</summary>
   <p><strong>Responsibilities:</strong></p>
 <div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
-<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><code>- Validates State payloads and updates. Reuseable across all State instances.
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>- Validates `State` payloads and updates.
+- Reusable across all `State` instances.
 - Fully thread-safe due to immutability.
 </code></pre></div></td></tr></table></div>
 </details>
@@ -1891,7 +1911,7 @@ Iterator over top-level keys.</p>
           <tr class="doc-section-item">
             <td><code>payload</code></td>
             <td>
-                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.Payload" href="../dagpipe/state/#dagpipe.state.Payload">Payload</a></code>
+                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.Payload" href="#dagpipe.state.Payload">Payload</a></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -1917,7 +1937,7 @@ Iterator over top-level keys.</p>
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.SchemaError" href="../dagpipe/state/#dagpipe.state.SchemaError">SchemaError</a></code>
+                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.SchemaError" href="#dagpipe.state.SchemaError">SchemaError</a></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -1988,7 +2008,7 @@ Iterator over top-level keys.</p>
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.SchemaError" href="../dagpipe/state/#dagpipe.state.SchemaError">SchemaError</a></code>
+                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.SchemaError" href="#dagpipe.state.SchemaError">SchemaError</a></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -2070,7 +2090,7 @@ Iterator over top-level keys.</p>
           <tr class="doc-section-item">
             <td><code><span title="dagpipe.state.State.payload">payload</span></code></td>
             <td>
-                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.Payload" href="../dagpipe/state/#dagpipe.state.Payload">Payload</a></code>
+                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.Payload" href="#dagpipe.state.Payload">Payload</a></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -2081,7 +2101,7 @@ Iterator over top-level keys.</p>
           <tr class="doc-section-item">
             <td><code><span title="dagpipe.state.State.schema">schema</span></code></td>
             <td>
-                  <code><span title="typing.ClassVar">ClassVar</span>[<a class="autorefs autorefs-internal" title="dagpipe.state.Schema" href="../dagpipe/state/#dagpipe.state.Schema">Schema</a>]</code>
+                  <code><span title="typing.ClassVar">ClassVar</span>[<a class="autorefs autorefs-internal" title="dagpipe.state.Schema" href="#dagpipe.state.Schema">Schema</a>]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -2103,7 +2123,7 @@ Iterator over top-level keys.</p>
           <tr class="doc-section-item">
             <td><code><span title="dagpipe.state.State.parent">parent</span></code></td>
             <td>
-                  <code><span title="typing.Optional">Optional</span>[<a class="autorefs autorefs-internal" title="dagpipe.state.State" href="../dagpipe/state/#dagpipe.state.State">State</a>]</code>
+                  <code><span title="typing.Optional">Optional</span>[<a class="autorefs autorefs-internal" title="dagpipe.state.State" href="#dagpipe.state.State">State</a>]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -2152,7 +2172,11 @@ Iterator over top-level keys.</p>
   <summary>Notes</summary>
   <p><strong>Responsibilities:</strong></p>
 <div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
-<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><code>- Represents a complete execution snapshot at a specific point in pipeline traversal. Fundamental unit of execution in dagpipe.
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code>- Represents a complete execution snapshot at a specific point in
+  pipeline traversal.
+- Fundamental unit of execution in `dagpipe`.
 - Fully thread-safe due to immutability.
 </code></pre></div></td></tr></table></div>
 </details>
@@ -2202,7 +2226,7 @@ Iterator over top-level keys.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Create a new child State derived from this State.</p>
+      <p>Create a new child <code>State</code> derived from this state.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2287,11 +2311,11 @@ Iterator over top-level keys.</p>
       <tbody>
           <tr class="doc-section-item">
 <td><code>State</code></td>            <td>
-                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.State" href="../dagpipe/state/#dagpipe.state.State">State</a></code>
+                  <code><a class="autorefs autorefs-internal" title="dagpipe.state.State" href="#dagpipe.state.State">State</a></code>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A new immutable State instance.</p>
+                <p>A new immutable <code>State</code> instance.</p>
               </div>
             </td>
           </tr>
@@ -2303,8 +2327,10 @@ Iterator over top-level keys.</p>
   <summary>Notes</summary>
   <p><strong>Guarantees:</strong></p>
 <div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
-<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><code>- This is the only supported mechanism for modifying execution data.
-- Validates payload updates, preserves lineage, increments depth, and appends to history.
+<span class="normal">2</span>
+<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>- This is the only supported mechanism for modifying execution data.
+- Validates payload updates, preserves lineage, increments depth,
+  and appends to history.
 </code></pre></div></td></tr></table></div>
 </details>
     </div>
@@ -2494,7 +2520,7 @@ Iterator over top-level keys.</p>
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><span title="typing.Tuple">Tuple</span>[<a class="autorefs autorefs-internal" title="dagpipe.state.State" href="../dagpipe/state/#dagpipe.state.State">State</a>, ...]</code>
+                  <code><span title="typing.Tuple">Tuple</span>[<a class="autorefs autorefs-internal" title="dagpipe.state.State" href="#dagpipe.state.State">State</a>, ...]</code>
             </td>
             <td>
               <div class="doc-md-description">