Generate Threat Model

Previous value: -"Skip the similar-model detection and always create a\nnew model. Default False — the check fires unless the\noperator / agent has explicit reason to bypass it."New value: +"Skip the similar-model detection and always create a\nnew model. Default False: the check fires unless the\noperator or agent has explicit reason to bypass it."

Previous value: -"Only to resume a generation that stopped on owner\nquestions (above): the model it saved. Pass it once\n``get_behavioural_model`` reports ``generation_ready: true``.\nBefore then it is not a resume, and a new model is generated."New value: +"Deprecated: use ``generate_from_behavioural_model``. With\nan empty ``feature_description`` it does the same; with a\ndescription it is refused (``resume_takes_no_description``)."

Previous value: -"Optional ID of an existing model to wire the new\nmodel under as a child on the recursive composition tree.\nThe child then inherits the parent's topology and\nparticipates in composition (delta / inherited control\ncredit). Default None — the model is created flat."New value: +"Optional ID of an existing model to wire the new\nmodel under as a child on the recursive composition tree.\nThe child then inherits the parent's topology and\nparticipates in composition (delta / inherited control\ncredit). Default None: the model is created flat."

Added value: +{
+  "default": "",
+  "description": "Only to resume a generation that stopped on owner\nquestions (above): the model it saved. Pass it once\n``get_behavioural_model`` reports ``generation_ready: true``.\nBefore then it is not a resume, and a new model is generated.",
+  "type": "string"
+}

Previous value: -"Where the description came from, one of\n``code``, ``ticket``, ``document``, ``manual``, ``mixed``.\nEmpty (default) records nothing. For an existing repository\npass ``provenance_kind=\"code\"`` with ``provenance_repo_url``\nand ``provenance_commit_sha`` (the HEAD you gathered from):\nthe code is then authoritative and the model follows it.\nAny other kind means the description is intent and the code\nis measured against it. The same record can be set later\nwith ``set_model_provenance``."New value: +"Where the description came from, one of\n``code``, ``ticket``, ``document``, ``manual``, ``mixed``.\nEmpty (default) records nothing. For an existing repository\npass ``provenance_kind=\"code\"`` with ``provenance_repo_url``\nand ``provenance_commit_sha`` (the HEAD you gathered from):\nthe code is then authoritative and the model follows it.\nAny other kind means the description is intent and the code\nis measured against it. The same record can be set later\nwith ``update_threat_model``."

Added value: +{
+  "default": "",
+  "description": "Commit SHA the description was gathered\nat (``code`` kind).",
+  "type": "string"
+}

Added value: +{
+  "default": "",
+  "description": "Where the description came from, one of\n``code``, ``ticket``, ``document``, ``manual``, ``mixed``.\nEmpty (default) records nothing. For an existing repository\npass ``provenance_kind=\"code\"`` with ``provenance_repo_url``\nand ``provenance_commit_sha`` (the HEAD you gathered from):\nthe code is then authoritative and the model follows it.\nAny other kind means the description is intent and the code\nis measured against it. The same record can be set later\nwith ``set_model_provenance``.",
+  "type": "string"
+}

Added value: +{
+  "default": "",
+  "description": "Branch or tag name at that commit (optional).",
+  "type": "string"
+}

Added value: +{
+  "default": "",
+  "description": "Repository URL the description was\ngathered from (``code`` kind).",
+  "type": "string"
+}

Added value: +{
+  "default": "",
+  "description": "Identifier of the ticket or document the\ndescription came from (``ticket`` / ``document`` kinds).",
+  "type": "string"
+}

Added value: +{
+  "default": "",
+  "description": "URL of that ticket or document.",
+  "type": "string"
+}