wip: Add implementation for explaining dagscanNode attribute(s) + Fix

the test post rebasing of doc restructure changes.

query/graphql/planner/dagscan.go

@@ -151,11 +151,6 @@ type dagScanNode struct {
 
 	headset *headsetScanNode
 	parsed  *mapper.CommitSelect
-
-	// previousScanNode planNode
-	// linksScanNode    planNode
-
-	// block blocks.Block
 }
 
 func (p *Planner) DAGScan(parsed *mapper.CommitSelect) *dagScanNode {
@@ -178,6 +173,7 @@ func (n *dagScanNode) Init() error {
 	}
 	return nil
 }
+
 func (n *dagScanNode) Start() error {
 	if n.headset != nil {
 		return n.headset.Start()
@@ -230,7 +226,23 @@ func (n *dagScanNode) Source() planNode { return n.headset }
 // Explain method returns a map containing all attributes of this node that
 // are to be explained, subscribes / opts-in this node to be an explainablePlanNode.
 func (n *dagScanNode) Explain() (map[string]interface{}, error) {
-	return map[string]interface{}{}, nil
+	// explain the spans attribute.
+	spansExplainer := []map[string]interface{}{}
+	if n.headset.spans.HasValue {
+		for _, span := range n.headset.spans.Value {
+			spansExplainer = append(
+				spansExplainer,
+				map[string]interface{}{
+					"start": span.Start().ToString(),
+					"end":   span.End().ToString(),
+				},
+			)
+		}
+	}
+
+	return map[string]interface{}{
+		spansLabel: spansExplainer,
+	}, nil
 }
 
 func (n *dagScanNode) Next() (bool, error) {

tests/integration/query/explain/dagscan_test.go

@@ -35,16 +35,14 @@ func TestExplainAllCommitsDagScan(t *testing.T) {
 			{
 				"explain": dataMap{
 					"selectTopNode": dataMap{
-						"renderNode": dataMap{
-							"selectNode": dataMap{
-								"filter": nil,
-								"commitSelectNode": dataMap{
-									"dagScanNode": dataMap{
-										"spans": []dataMap{
-											{
-												"start": "/test-key/1",
-												"end":   "/test-key/2",
-											},
+						"selectNode": dataMap{
+							"filter": nil,
+							"commitSelectNode": dataMap{
+								"dagScanNode": dataMap{
+									"spans": []dataMap{
+										{
+											"start": "/test-key/1",
+											"end":   "/test-key/2",
 										},
 									},
 								},