ontology-atlas

Overview Schema Source Related Servers Discussions Admin

merge_concepts

Destructive

Fold one concept node into another: redirect every backlink, record identity history, and delete the source. Preview with a dry-run, then confirm to write.

Instructions

⚠ DESTRUCTIVE MULTI-FILE WRITE — fold one node into another. Every backlink to fromSlug is redirected to intoSlug (frontmatter array entries + body links), then fromSlug is deleted. The survivor keeps its UID while the source UID/history is recorded in canonical merged_uids. The intoSlug prose and non-identity frontmatter are preserved as-is — they are not merged automatically (use patch_concept after if you want to combine descriptions). Tail-only references are also redirected. Two-stage safety:

Without confirm: true the call is a dry-run — returns the redirect plan + list of deletions without writing.
With confirm: true the rewrites and the delete happen in one pass. Throws if either slug is missing. Confirmed writes return compact postWriteMaintenance (maintenance_plan) with count-safe byPhase / bySeverity / byKind queue buckets, action score, executable proposedAction, and current-page nextExecutableAction / nextReviewAction pointers for the final graph.

Input Schema

TableJSON Schema

Name	Required	Description
`confirm`	No	Actually perform the merge when true. Omit or false for a dry-run.
`fromSlug`	Yes	Slug to dissolve. Its file is deleted after backlinks redirect.
`intoSlug`	Yes	Slug to keep. Receives every redirected backlink.
`expected_mtime`	No	Optional conflict guard for fromSlug. Throws if the source has been modified externally.
`expected_into_mtime`	No	Optional conflict guard for intoSlug. Pass the survivor mtime from get_concept so a concurrent edit or identity-history change is never overwritten.

Output Schema

TableJSON Schema

Name	Required	Description
`ok`	Yes
`dryRun`	Yes
`changed`	No
`deleted`	Yes
`fromUid`	Yes
`intoUid`	Yes
`message`	No
`fromPath`	Yes
`fromSlug`	Yes
`intoSlug`	Yes
`warnings`	No
`canConfirm`	Yes	True only when repeating the call with confirm:true can perform the previewed change without another explicit safety opt-in.
`wouldChange`	Yes	True only when the dry-run predicts a disk or Git change.
`absorbedUids`	Yes
`capturedFrom`	Yes
`previewReady`	Yes	True only when this response is a complete dry-run preview that an agent can review.
`blockedReasons`	Yes	Machine-readable human explanations for every condition currently blocking confirmation.
`backlinkUpdates`	Yes
`postWriteMaintenance`	No	Compact maintenance_plan summary for post-write follow-up. Bucket maps describe the remaining queue after the write.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv1.4.0Oct 1, 2026
- addedOutput schema / properties / warnings
```
Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
```

Changed4 schema fields changedv1.3.0Sep 23, 2026

changedOutput schema / properties / postWriteMaintenance / properties / actions / items / properties / kind / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

changedOutput schema / properties / postWriteMaintenance / properties / filters / properties / kinds / items / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextExecutableAction / properties / kind / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextReviewAction / properties / kind / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

Changed8 schema fields changedv1.2.5Sep 15, 2026

addedOutput schema / properties / postWriteMaintenance / properties / actions / items / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "executable": {
+          "const": true
+        }
+      },
+      "required": [
+        "executable"
+      ]
+    },
+    "then": {
+      "properties": {
+        "proposedAction": {
+          "additionalProperties": false,
+          "properties": {
+            "args": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "project",
+                        "domain",
+                        "capability",
+                        "element",
+                        "document",
+                        "vault-readme"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "title": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "kind",
+                    "title"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "to": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "depends_on",
+                        "relates",
+                        "contains",
+                        "describes",
+                        "domains",
+                        "capabilities",
+                        "elements",
+                        "domain"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "why": {
+                      "description": "One-line rationale for this relation (\"A leans on B because ...\"). Stored in the SAME frontmatter write as the ref (relation_notes map) — write it whenever you know the reason; a graph edge without a why is a mind-map line, not an ontology claim.",
+                      "maxLength": 300,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "to",
+                    "type"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "expected_mtime": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "frontmatter": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "broader": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "capabilities": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "contains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "dependencies": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "depends_on": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "describes": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "domains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "elements": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "relates": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "frontmatter",
+                    "expected_mtime"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "tool": {
+              "enum": [
+                "add_concept",
+                "add_relation",
+                "patch_concept"
+              ],
+              "minLength": 1,
+              "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "tool",
+            "args"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "proposedAction"
+      ]
+    }
+  }
+]

changedOutput schema / properties / postWriteMaintenance / properties / actions / items / required

Previous value: -[
-  "id",
-  "phase",
-  "kind",
-  "severity",
-  "score",
-  "executable",
-  "reason",
-  "proposedAction"
-]New value: +[
+  "id",
+  "phase",
+  "kind",
+  "severity",
+  "score",
+  "executable",
+  "reason"
+]

addedOutput schema / properties / postWriteMaintenance / properties / nextExecutableAction / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "executable": {
+          "const": true
+        }
+      },
+      "required": [
+        "executable"
+      ]
+    },
+    "then": {
+      "properties": {
+        "proposedAction": {
+          "additionalProperties": false,
+          "properties": {
+            "args": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "project",
+                        "domain",
+                        "capability",
+                        "element",
+                        "document",
+                        "vault-readme"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "title": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "kind",
+                    "title"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "to": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "depends_on",
+                        "relates",
+                        "contains",
+                        "describes",
+                        "domains",
+                        "capabilities",
+                        "elements",
+                        "domain"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "why": {
+                      "description": "One-line rationale for this relation (\"A leans on B because ...\"). Stored in the SAME frontmatter write as the ref (relation_notes map) — write it whenever you know the reason; a graph edge without a why is a mind-map line, not an ontology claim.",
+                      "maxLength": 300,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "to",
+                    "type"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "expected_mtime": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "frontmatter": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "broader": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "capabilities": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "contains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "dependencies": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "depends_on": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "describes": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "domains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "elements": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "relates": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "frontmatter",
+                    "expected_mtime"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "tool": {
+              "enum": [
+                "add_concept",
+                "add_relation",
+                "patch_concept"
+              ],
+              "minLength": 1,
+              "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "tool",
+            "args"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "proposedAction"
+      ]
+    }
+  }
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextExecutableAction / required

Previous value: -[
-  "id",
-  "phase",
-  "kind",
-  "severity",
-  "score",
-  "executable",
-  "reason",
-  "proposedAction"
-]New value: +[
+  "id",
+  "phase",
+  "kind",
+  "severity",
+  "score",
+  "executable",
+  "reason"
+]

addedOutput schema / properties / postWriteMaintenance / properties / nextReviewAction / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "executable": {
+          "const": true
+        }
+      },
+      "required": [
+        "executable"
+      ]
+    },
+    "then": {
+      "properties": {
+        "proposedAction": {
+          "additionalProperties": false,
+          "properties": {
+            "args": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "project",
+                        "domain",
+                        "capability",
+                        "element",
+                        "document",
+                        "vault-readme"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "title": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "kind",
+                    "title"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "to": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "depends_on",
+                        "relates",
+                        "contains",
+                        "describes",
+                        "domains",
+                        "capabilities",
+                        "elements",
+                        "domain"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "why": {
+                      "description": "One-line rationale for this relation (\"A leans on B because ...\"). Stored in the SAME frontmatter write as the ref (relation_notes map) — write it whenever you know the reason; a graph edge without a why is a mind-map line, not an ontology claim.",
+                      "maxLength": 300,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "to",
+                    "type"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "expected_mtime": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "frontmatter": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "broader": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "capabilities": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "contains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "dependencies": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "depends_on": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "describes": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "domains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "elements": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "relates": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "frontmatter",
+                    "expected_mtime"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "tool": {
+              "enum": [
+                "add_concept",
+                "add_relation",
+                "patch_concept"
+              ],
+              "minLength": 1,
+              "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "tool",
+            "args"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "proposedAction"
+      ]
+    }
+  }
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextReviewAction / required

Previous value: -[
-  "id",
-  "phase",
-  "kind",
-  "severity",
-  "score",
-  "executable",
-  "reason",
-  "proposedAction"
-]New value: +[
+  "id",
+  "phase",
+  "kind",
+  "severity",
+  "score",
+  "executable",
+  "reason"
+]

addedOutput schema / properties / postWriteMaintenance / properties / summary / properties / capabilitiesWithoutEvidence
```
Added value: +{
+  "minimum": 0,
+  "type": "integer"
+}
```

changedOutput schema / properties / postWriteMaintenance / properties / summary / required

Previous value: -[
-  "totalActions",
-  "filteredActions",
-  "remainingActions",
-  "executableActions",
-  "reviewActions",
-  "compileIssues",
-  "dependencyCycles",
-  "canonicalizationActions",
-  "danglingReferences",
-  "relationRecommendations",
-  "externalElementRefs",
-  "externalElementRefsIgnored",
-  "unassignedNodes",
-  "emptyDomains"
-]New value: +[
+  "totalActions",
+  "filteredActions",
+  "remainingActions",
+  "executableActions",
+  "reviewActions",
+  "compileIssues",
+  "dependencyCycles",
+  "canonicalizationActions",
+  "danglingReferences",
+  "relationRecommendations",
+  "externalElementRefs",
+  "externalElementRefsIgnored",
+  "unassignedNodes",
+  "emptyDomains",
+  "capabilitiesWithoutEvidence"
+]

First observedv0.13.0Sep 11, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and idempotentHint=false, but the description goes well beyond them: it names exactly what is destroyed (fromSlug file), what is preserved (survivor UID, source UID/history in merged_uids), what is NOT merged automatically (prose and non-identity frontmatter), the dry-run safety stage, and the throw condition on missing slugs.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The destructive warning and the core mechanic are front-loaded, and the numbered safety stages are scannable. It runs long, with the postWriteMaintenance detail bordering on redundant against the output schema, but nearly every sentence carries operational meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive multi-file mutation with conflict-guard params, the description covers the write path, the dry-run path, identity preservation, failure modes, and follow-up routing. An output schema exists, so its added return-value prose is surplus rather than a gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real semantic weight: it clarifies that confirm governs the dry-run-versus-write boundary and that omitting it preserves the redirect plan, which contextualizes how the required slugs are actually consumed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'fold one node into another,' with the exact mechanical consequence spelled out (backlinks redirected, fromSlug deleted, survivor keeps its UID). It clearly differentiates from siblings like delete_concept and rename_concept, which perform single-file operations without the multi-file merge semantics.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly routes the agent to patch_concept for combining descriptions after the merge, and it explains the two-stage confirm flow (dry-run without confirm, single-pass write with it). It does not, however, contrast when to merge versus rename or delete, leaving one inference to the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.