@blockml/graph 0.9.1

package/blocks/org/blockml/bml/graph/BuildIndexResult.bml

@@ -0,0 +1,43 @@
+<!--
+  Graph — BuildIndexResult
+  FQN: org.blockml.bml.graph.BuildIndexResult
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>BuildIndexResult</name>
+  <type>graph:BuildIndexResult</type>
+  <baseType>graph:GraphType</baseType>
+  <is>In-memory graph index plus bootstrap diagnostics</is>
+  <documentation>Returned by buildIndex, rebuildIndex, and openGraph.</documentation>
+  <properties>
+    <index type="graph:GraphType">
+      <documentation>Opaque GraphIndex handle. (required)</documentation>
+    </index>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics (required). TS type: bomcommon:Diagnostic[].</documentation>
+    </diagnostics>
+    <blocks type="type:Integer">
+      <documentation>Resolved Block nodes. (required)</documentation>
+    </blocks>
+    <members type="type:Integer">
+      <documentation>Member nodes. (required)</documentation>
+    </members>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphEdge.bml

@@ -0,0 +1,49 @@
+<!--
+  Graph — GraphEdge
+  FQN: org.blockml.bml.graph.GraphEdge
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphEdge</name>
+  <type>graph:GraphEdge</type>
+  <baseType>graph:GraphType</baseType>
+  <is>Authored relation between graph nodes</is>
+  <documentation>relation is one of BASE_TYPE, CONTRACT, HAS_SUBBLOCK, HAS_MEMBER, MEMBER_TYPE, INPUT_TYPE, OUTPUT_TYPE, THROWS.</documentation>
+  <properties>
+    <relation type="type:Text">
+      <documentation>Authored relation name. (required)</documentation>
+    </relation>
+    <from type="type:Text">
+      <documentation>Source node id. (required)</documentation>
+    </from>
+    <to type="type:Text">
+      <documentation>Target node id. (required)</documentation>
+    </to>
+    <file type="type:Text">
+      <documentation>Provenance file. (optional)</documentation>
+    </file>
+    <line type="type:Integer">
+      <documentation>Provenance line. (optional)</documentation>
+    </line>
+    <cardinality type="type:Text">
+      <documentation>Optional multiplicity on MEMBER_TYPE. (optional)</documentation>
+    </cardinality>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphIndexOptions.bml

@@ -0,0 +1,43 @@
+<!--
+  Graph — GraphIndexOptions
+  FQN: org.blockml.bml.graph.GraphIndexOptions
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphIndexOptions</name>
+  <type>graph:GraphIndexOptions</type>
+  <baseType>graph:GraphType</baseType>
+  <is>Project and cache location for graph index operations</is>
+  <documentation>rootDir defaults to process.cwd(); srcDir defaults to blocks; indexDir defaults to {rootDir}/.blockml/graph.</documentation>
+  <properties>
+    <rootDir type="type:Text">
+      <documentation>rootDir (optional). TS type: type:Text.</documentation>
+    </rootDir>
+    <srcDir type="type:Text">
+      <documentation>srcDir (optional). TS type: type:Text.</documentation>
+    </srcDir>
+    <libraries type="type:Text[]">
+      <documentation>libraries (optional). TS type: type:Text[].</documentation>
+    </libraries>
+    <indexDir type="type:Text">
+      <documentation>indexDir (optional). TS type: type:Text.</documentation>
+    </indexDir>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphMember.bml

@@ -0,0 +1,46 @@
+<!--
+  Graph — GraphMember
+  FQN: org.blockml.bml.graph.GraphMember
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphMember</name>
+  <type>graph:GraphMember</type>
+  <baseType>graph:GraphType</baseType>
+  <is>Authored or inherited member view</is>
+  <documentation>inheritedFrom is set when the member is declared on an ancestor or contract, not stored as a derived HAS_MEMBER edge.</documentation>
+  <properties>
+    <node type="graph:GraphNode">
+      <documentation>Member node. (required)</documentation>
+    </node>
+    <relation type="type:Text">
+      <documentation>HAS_MEMBER. (required)</documentation>
+    </relation>
+    <inheritedFrom type="type:Text">
+      <documentation>Owner FQN when inherited. (optional)</documentation>
+    </inheritedFrom>
+    <file type="type:Text">
+      <documentation>Provenance file. (optional)</documentation>
+    </file>
+    <line type="type:Integer">
+      <documentation>Provenance line. (optional)</documentation>
+    </line>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphNeighbor.bml

@@ -0,0 +1,52 @@
+<!--
+  Graph — GraphNeighbor
+  FQN: org.blockml.bml.graph.GraphNeighbor
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphNeighbor</name>
+  <type>graph:GraphNeighbor</type>
+  <baseType>graph:GraphType</baseType>
+  <is>One semantic 1-hop result</is>
+  <documentation>Block-level uses/usedBy/neighbors result. via is the Member that explains a MEMBER_TYPE hop. source is set when the edge is owned by a block other than the queried FQN (uses/used-by/neighbors depth &gt; 1).</documentation>
+  <properties>
+    <node type="graph:GraphNode">
+      <documentation>Neighbor block. (required)</documentation>
+    </node>
+    <relation type="type:Text">
+      <documentation>Authored relation. (required)</documentation>
+    </relation>
+    <direction type="type:Text">
+      <documentation>outgoing or incoming. (required)</documentation>
+    </direction>
+    <via type="graph:GraphNode">
+      <documentation>Member node when the hop goes through a member. (optional)</documentation>
+    </via>
+    <source type="graph:GraphNode">
+      <documentation>Block that owns this edge when it is not the queried FQN. (optional)</documentation>
+    </source>
+    <file type="type:Text">
+      <documentation>Provenance file. (optional)</documentation>
+    </file>
+    <line type="type:Integer">
+      <documentation>Provenance line. (optional)</documentation>
+    </line>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphNode.bml

@@ -0,0 +1,58 @@
+<!--
+  Graph — GraphNode
+  FQN: org.blockml.bml.graph.GraphNode
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphNode</name>
+  <type>graph:GraphNode</type>
+  <baseType>graph:GraphType</baseType>
+  <is>Block or Member node in the authored graph</is>
+  <documentation>kind is block or member. Member ids are ownerFqn#kind:name. origin is workspace, dependency, or unresolved.</documentation>
+  <properties>
+    <kind type="type:Text">
+      <documentation>block or member. (required)</documentation>
+    </kind>
+    <fqn type="type:Text">
+      <documentation>Block FQN or member id. (required)</documentation>
+    </fqn>
+    <name type="type:Text">
+      <documentation>Short name. (required)</documentation>
+    </name>
+    <file type="type:Text">
+      <documentation>Source file path. (required)</documentation>
+    </file>
+    <origin type="type:Text">
+      <documentation>workspace | dependency | unresolved. (required)</documentation>
+    </origin>
+    <resolved type="type:Boolean">
+      <documentation>false for stub nodes. (required)</documentation>
+    </resolved>
+    <library type="type:Text">
+      <documentation>Package prefix. (optional)</documentation>
+    </library>
+    <memberKind type="type:Text">
+      <documentation>property | aggregation | association | capability. (optional)</documentation>
+    </memberKind>
+    <displayFqn type="type:Text">
+      <documentation>Display FQN such as Wall.size. (optional)</documentation>
+    </displayFqn>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphPath.bml

@@ -0,0 +1,40 @@
+<!--
+  Graph — GraphPath
+  FQN: org.blockml.bml.graph.GraphPath
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphPath</name>
+  <type>graph:GraphPath</type>
+  <baseType>graph:GraphType</baseType>
+  <is>Shortest authored path between two blocks</is>
+  <documentation>hops are GraphNeighbor values with direction outgoing. Member nodes explain MEMBER_TYPE connections. path does not walk incoming edges.</documentation>
+  <properties>
+    <from type="graph:GraphNode">
+      <documentation>Start block. (required)</documentation>
+    </from>
+    <to type="graph:GraphNode">
+      <documentation>End block. (required)</documentation>
+    </to>
+    <hops type="graph:GraphNeighbor[]">
+      <documentation>Ordered hops including members. (required)</documentation>
+    </hops>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphQueryResult.bml

@@ -0,0 +1,37 @@
+<!--
+  Graph — GraphQueryResult
+  FQN: org.blockml.bml.graph.GraphQueryResult
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphQueryResult</name>
+  <type>graph:GraphQueryResult</type>
+  <baseType>graph:GraphType</baseType>
+  <is>Tabular Cypher query result</is>
+  <documentation>columns are engine column names; each row.values aligns with columns. Ladybug types are not exposed.</documentation>
+  <properties>
+    <columns type="type:Text[]">
+      <documentation>Column names. (required)</documentation>
+    </columns>
+    <rows type="type:Text[]">
+      <documentation>JSON-shaped row values. (required)</documentation>
+    </rows>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/GraphType.bml

@@ -0,0 +1,33 @@
+<!--
+  Graph — GraphType
+  FQN: org.blockml.bml.graph.GraphType
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>GraphType</name>
+  <type>graph:GraphType</type>
+  <baseType>core:Entity</baseType>
+  <is>Abstract marker for Graph implementation data-structure blocks</is>
+  <documentation>GraphNode, GraphPath, and related ValueTypes used as capability payloads.</documentation>
+  <abstract>true</abstract>
+  <references>
+    <see type="bom:UrmodellType" relation="SeeAlso" />
+  </references>
+</block>

package/blocks/org/blockml/bml/graph/IndexStatus.bml

@@ -0,0 +1,43 @@
+<!--
+  Graph — IndexStatus
+  FQN: org.blockml.bml.graph.IndexStatus
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>IndexStatus</name>
+  <type>graph:IndexStatus</type>
+  <baseType>graph:GraphType</baseType>
+  <is>Presence and freshness of the persisted graph index</is>
+  <documentation>state is missing, ready, or stale.</documentation>
+  <properties>
+    <state type="type:Text">
+      <documentation>state (required). TS type: type:Text.</documentation>
+    </state>
+    <blocks type="type:Integer">
+      <documentation>blocks (optional). TS type: type:Integer.</documentation>
+    </blocks>
+    <members type="type:Integer">
+      <documentation>members (optional). TS type: type:Integer.</documentation>
+    </members>
+    <indexDir type="type:Text">
+      <documentation>indexDir (required). TS type: type:Text.</documentation>
+    </indexDir>
+  </properties>
+</block>

package/blocks/org/blockml/bml/graph/Library.bml

@@ -0,0 +1,95 @@
+<!--
+  BlockML Graph Library Descriptor
+  FQN: org.blockml.bml.graph.Library
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>Library</name>
+  <type>graph:Library</type>
+  <baseType>core:BlockLibrary</baseType>
+  <is>The BlockML Graph package library catalog</is>
+
+  <documentation>
+    Canonical graph specification for BlockML — local authored structural graph
+    over the validate --all BML corpus. TypeScript in packages/graph/src/ implements this library.
+    Membership is defined exclusively by this blocks list.
+  </documentation>
+
+  <version>0.9.1</version>
+
+  <language>
+    <English />
+  </language>
+
+  <properties>
+    <description override="true">
+      <value>BlockML Graph library</value>
+    </description>
+  </properties>
+
+  <aggregations>
+    <readMe>
+      <composition>
+        <graph:README />
+      </composition>
+    </readMe>
+    <dependencies>
+      <composition>
+        <blockml:Library />
+        <bom:Library />
+        <framework:Library />
+      </composition>
+    </dependencies>
+    <blocks>
+      <composition>
+        <graph:GraphType />
+        <graph:GraphIndexOptions />
+        <graph:GraphNode />
+        <graph:GraphEdge />
+        <graph:GraphNeighbor />
+        <graph:GraphMember />
+        <graph:GraphPath />
+        <graph:GraphQueryResult />
+        <graph:IndexStatus />
+        <graph:BuildIndexResult />
+        <graphcap:BuildIndex />
+        <graphcap:OpenIndex />
+        <graphcap:RebuildIndex />
+        <graphcap:Uses />
+        <graphcap:UsedBy />
+        <graphcap:Neighbors />
+        <graphcap:Ancestors />
+        <graphcap:Descendants />
+        <graphcap:Path />
+        <graphcap:Members />
+        <graphcap:Query />
+        <graphcap:Schema />
+        <graphdocumentation:Introduction />
+        <graphdocumentation:LayerSeparation />
+        <graphdocumentation:ArchitectureOverview />
+        <graphdocumentation:V1Scope />
+        <graphdocumentation:PublicApi />
+        <graphdocumentation:PackageOwnership />
+        <graphdocumentation:ScopeExclusions />
+      </composition>
+    </blocks>
+  </aggregations>
+
+</block>

package/blocks/org/blockml/bml/graph/README.bml

@@ -0,0 +1,36 @@
+<!--
+  BlockML Graph — README
+  FQN: org.blockml.bml.graph.README
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>README</name>
+  <type>graph:README</type>
+  <baseType>core:ReadMe</baseType>
+  <is>Reading entry for the Graph library</is>
+  <documentation>The @blockml/graph package indexes the effective BML corpus of a project
+    (same as blockml validate --all) as an authored structural graph.
+
+    Start at org.blockml.bml.graph.documentation.Introduction.</documentation>
+  <references>
+    <see type="graphdocumentation:Introduction" relation="ReadFirst" />
+    <see type="graphdocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+</block>

package/blocks/org/blockml/bml/graph/capability/Ancestors.bml

@@ -0,0 +1,40 @@
+<!--
+  Graph Capability — Ancestors
+  FQN: org.blockml.bml.graph.capability.Ancestors
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>Ancestors</name>
+  <type>graphcap:Ancestors</type>
+  <baseType>core:Capability</baseType>
+  <is>BASE_TYPE walk toward roots</is>
+  <documentation>Only BASE_TYPE. Default depth 16.</documentation>
+  <properties>
+    <fqn type="type:Text">
+      <documentation>Block FQN. (required)</documentation>
+    </fqn>
+    <depth type="type:Integer">
+      <documentation>Max hops (optional).</documentation>
+    </depth>
+    <nodes type="graph:GraphNode[]">
+      <documentation>Ancestor blocks. (required)</documentation>
+    </nodes>
+  </properties>
+</block>