changedOutput schema / $defs / Adr / description
Previous value: -"A full ADR document: YAML frontmatter and body.\n\nThis is the structured object the future parser produces from an\non-disk ``.md`` file and the renderer consumes to produce one, and the\nshape ``get_adr``/``create_adr`` (plan §8) are expected to exchange\nwith the LLM instead of raw markdown text.\n\nThe specmgr schema version lives on ``frontmatter.version`` (plan §3),\nnot here -- it must round-trip through the on-disk file's YAML block,\nwhich only ``frontmatter``/``body`` do (plan §7); a top-level field on\nthis wrapper class would never be persisted.\n\nParameters\n----------\nfrontmatter:\n The YAML frontmatter block, including the schema version. See\n :class:`AdrFrontmatter`.\nbody:\n The parsed body sections and options. See :class:`AdrBody`."New value: +"A full ADR document: YAML frontmatter and body.\n\nThis is the structured object the parser produces from an\non-disk ``.md`` file and the renderer consumes to produce one, and the\nshape ``get_adr``/``create_adr`` exchange with the LLM instead of raw\nmarkdown text.\n\nThe specmgr schema version lives on ``frontmatter.version``,\nnot here -- it must round-trip through the on-disk file's YAML block,\nwhich only ``frontmatter``/``body`` do; a top-level field on\nthis wrapper class would never be persisted.\n\nParameters\n----------\nfrontmatter:\n The YAML frontmatter block, including the schema version. See\n :class:`AdrFrontmatter`.\nbody:\n The parsed body sections and options. See :class:`AdrBody`."
changedOutput schema / $defs / AdrBody / description
Previous value: -"The ADR body: whole-section fields (plan §4) plus the dynamic\n``Option`` collection that backs the derived ``## Pros and Cons of the\nOptions`` section (plan §5).\n\nEach whole-section field maps 1:1 to the ``key`` values the future\n``update_section(key, value)`` MCP tool accepts (plan §4's table),\nusing this model's snake_case attribute names rather than the table's\ncamelCase key strings -- the tool layer, not this model, is responsible\nfor translating between the two.\n\nMandatory fields (``title``, ``context_and_problem_statement``,\n``considered_options``, ``decision_outcome``) must be non-blank; this\nmirrors plan §4's rule that ``update_section`` must reject a deletion\nsentinel targeting a mandatory section rather than write it. Optional\nfields (``decision_drivers``, ``consequences``, ``confirmation``,\n``more_information``) normalize a blank/whitespace-only value to\n``None``, i.e. \"absent\", consistent with the render-time rule that an\nabsent optional section omits its heading entirely.\n\nParameters\n----------\ntitle:\n The ``# {title}`` H1. Mandatory.\ncontext_and_problem_statement:\n ``## Context and Problem Statement``. Mandatory.\ndecision_drivers:\n ``## Decision Drivers``. Optional.\nconsidered_options:\n ``## Considered Options``. Mandatory. Kept fully independent from\n ``options`` below -- no consistency check is enforced between them\n (plan §4).\ndecision_outcome:\n ``## Decision Outcome`` text before any H3. Mandatory.\nconsequences:\n ``### Consequences`` under Decision Outcome. Optional.\nconfirmation:\n ``### Confirmation`` under Decision Outcome. Optional.\noptions:\n The dynamic ``### Option N: {title}`` collection. Backs the derived\n ``## Pros and Cons of the Options`` section, which is rendered iff\n this list is non-empty (plan §5). Defaults to an empty list.\nmore_information:\n ``## More Information``, always last. Optional."New value: +"The ADR body: whole-section fields plus the dynamic\n``Option`` collection that backs the derived ``## Pros and Cons of the\nOptions`` section.\n\nEach whole-section field maps 1:1 to the ``key`` values the\n``update_section(key, value)`` MCP tool accepts,\nusing this model's snake_case attribute names rather than\ncamelCase key strings -- the tool layer, not this model, is responsible\nfor translating between the two.\n\nMandatory fields (``title``, ``context_and_problem_statement``,\n``considered_options``, ``decision_outcome``) must be non-blank; this\nmirrors the rule that ``update_section`` must reject a deletion\nsentinel targeting a mandatory section rather than write it. Optional\nfields (``decision_drivers``, ``consequences``, ``confirmation``,\n``more_information``) normalize a blank/whitespace-only value to\n``None``, i.e. \"absent\", consistent with the render-time rule that an\nabsent optional section omits its heading entirely.\n\nParameters\n----------\ntitle:\n The ``# {title}`` H1. Mandatory.\ncontext_and_problem_statement:\n ``## Context and Problem Statement``. Mandatory.\ndecision_drivers:\n ``## Decision Drivers``. Optional.\nconsidered_options:\n ``## Considered Options``. Mandatory. Kept fully independent from\n ``options`` below -- no consistency check is enforced between them.\ndecision_outcome:\n ``## Decision Outcome`` text before any H3. Mandatory.\nconsequences:\n ``### Consequences`` under Decision Outcome. Optional.\nconfirmation:\n ``### Confirmation`` under Decision Outcome. Optional.\noptions:\n The dynamic ``### Option N: {title}`` collection. Backs the derived\n ``## Pros and Cons of the Options`` section, which is rendered iff\n this list is non-empty. Defaults to an empty list.\nmore_information:\n ``## More Information``, always last. Optional."
changedOutput schema / $defs / AdrFrontmatter / description
Previous value: -"The ADR YAML frontmatter block.\n\nUpdate contract: whole object, full replace only (plan §3) -- there is\nno partial-update or deletion-sentinel mechanism for frontmatter; omit a\nkey from the submitted object to drop it.\n\nParameters\n----------\nid:\n The specmgr-assigned document identifier (a server-generated UUID\n string), used to resolve ``id -> file path`` (plan §9a). This is a\n specmgr-only extension key, not part of the MADR 4.0.0 standard --\n assigned once by ``create_adr`` and never reassigned. Optional\n (``str | None = None``, default ``None``), the same non-breaking-\n addition pattern used for ``version`` below, so existing/hand-\n authored files without an ``id`` still parse successfully; they are\n just not addressable via id-based tools until one is assigned.\nversion:\n The specmgr schema major.minor.patch version this document was\n written with (plan §6). This is a specmgr-only extension key, not\n part of the MADR 4.0.0 standard -- it is kept alongside the\n MADR-defined keys below purely so it round-trips through the\n parse/render pipeline (plan §7) and lets a future parser dispatch\n an on-disk file to the ``models/adr/vN`` package that understands\n it, or recognize a document still on an older major version.\n Defaults to :data:`CURRENT_SCHEMA_VERSION`. Must share this\n package's major component -- ``models.adr.v1.AdrFrontmatter`` never\n accepts a ``\"2.x.x\"`` value.\nstatus:\n Either one of ``\"draft\"``, ``\"proposed\"``, ``\"rejected\"``,\n ``\"accepted\"``, ``\"deprecated\"``, ``\"superseded\"``, or a string\n matching ``^superseded by .+$``. Defaults to ``\"draft\"`` -- both\n when the key is absent entirely and when it is present but blank\n (e.g. MADR's bare-bones template ships a placeholder ``status:``\n with nothing after the colon, which YAML parses as ``None``, not\n an absent key).\ndate:\n Free-form date the decision was last updated (MADR uses\n ``YYYY-MM-DD``, not enforced here since the ``.md`` file is the\n source of truth). Optional.\ndecision_makers:\n Free-form list of everyone involved in the decision, as written in\n the frontmatter (YAML key ``decision-makers``). Optional. Accepts\n either the literal hyphenated YAML key or the snake_case field name\n (``validation_alias``, not ``alias``, so static type checkers keep\n seeing ``decision_makers`` as the constructor parameter name -- see\n ``tests/models/adr/v1/test_frontmatter.py`` for both call shapes).\nconsulted:\n Free-form list of subject-matter experts consulted. Optional.\ninformed:\n Free-form list of people kept up to date on progress. Optional."New value: +"The ADR YAML frontmatter block.\n\nUpdate contract: whole object, full replace only -- there is\nno partial-update or deletion-sentinel mechanism for frontmatter; omit a\nkey from the submitted object to drop it.\n\nParameters\n----------\nid:\n The specmgr-assigned document identifier (a server-generated UUID\n string), used to resolve ``id -> file path``. This is a\n specmgr-only extension key, not part of the MADR 4.0.0 standard --\n assigned once by ``create_adr`` and never reassigned. Optional\n (``str | None = None``, default ``None``), the same non-breaking-\n addition pattern used for ``version`` below, so existing/hand-\n authored files without an ``id`` still parse successfully; they are\n just not addressable via id-based tools until one is assigned.\nversion:\n The specmgr schema major.minor.patch version this document was\n written with. This is a specmgr-only extension key, not\n part of the MADR 4.0.0 standard -- it is kept alongside the\n MADR-defined keys below purely so it round-trips through the\n parse/render pipeline and lets a future parser dispatch\n an on-disk file to the ``models/adr/vN`` package that understands\n it, or recognize a document still on an older major version.\n Defaults to :data:`CURRENT_SCHEMA_VERSION`. Must share this\n package's major component -- ``models.adr.v1.AdrFrontmatter`` never\n accepts a ``\"2.x.x\"`` value.\nstatus:\n Either one of ``\"draft\"``, ``\"proposed\"``, ``\"rejected\"``,\n ``\"accepted\"``, ``\"deprecated\"``, ``\"superseded\"``, or a string\n matching ``^superseded by .+$``. Defaults to ``\"draft\"`` -- both\n when the key is absent entirely and when it is present but blank\n (e.g. MADR's bare-bones template ships a placeholder ``status:``\n with nothing after the colon, which YAML parses as ``None``, not\n an absent key).\ndate:\n Free-form date the decision was last updated (MADR uses\n ``YYYY-MM-DD``, not enforced here since the ``.md`` file is the\n source of truth). Optional.\ndecision_makers:\n Free-form list of everyone involved in the decision, as written in\n the frontmatter (YAML key ``decision-makers``). Optional. Accepts\n either the literal hyphenated YAML key or the snake_case field name\n (``validation_alias``, not ``alias``, so static type checkers keep\n seeing ``decision_makers`` as the constructor parameter name -- see\n ``tests/models/adr/v1/test_frontmatter.py`` for both call shapes).\nconsulted:\n Free-form list of subject-matter experts consulted. Optional.\ninformed:\n Free-form list of people kept up to date on progress. Optional."
changedOutput schema / $defs / AdrOption / description
Previous value: -"One entry of the dynamic ``## Pros and Cons of the Options`` collection.\n\nRendered as ``### Option {number}: {partial_title}``. Options are never\nindividually mandatory -- zero options is a valid ADR state -- and the\nwhole-section deletion sentinel from plan §4 does not apply to them;\nremoval only ever happens through the dedicated ``option_delete`` tool\n(plan §5, §8), not by submitting a blank/``\"REMOVE\"`` value here.\n\nParameters\n----------\nnumber:\n Monotonically increasing, unpadded, never-reused counter assigned at\n creation time. Deleting an option leaves a gap; remaining options are\n neither renumbered nor reordered.\npartial_title:\n The ``{title}`` portion after ``\"Option {number}: \"``. Must be\n non-blank and single-line (no embedded line breaks).\ncontent:\n Opaque markdown blob for the option's body (no enforced\n Good/Bad/Neutral structure). May be empty -- unlike the mandatory\n whole-section body fields, an option's content is never required to\n be non-blank."New value: +"One entry of the dynamic ``## Pros and Cons of the Options`` collection.\n\nRendered as ``### Option {number}: {partial_title}``. Options are never\nindividually mandatory -- zero options is a valid ADR state -- and the\nwhole-section deletion sentinel does not apply to them;\nremoval only ever happens through the dedicated ``option_delete`` tool,\nnot by submitting a blank/``\"REMOVE\"`` value here.\n\nParameters\n----------\nnumber:\n Monotonically increasing, unpadded, never-reused counter assigned at\n creation time. Deleting an option leaves a gap; remaining options are\n neither renumbered nor reordered.\npartial_title:\n The ``{title}`` portion after ``\"Option {number}: \"``. Must be\n non-blank and single-line (no embedded line breaks).\ncontent:\n Opaque markdown blob for the option's body (no enforced\n Good/Bad/Neutral structure). May be empty -- unlike the mandatory\n whole-section body fields, an option's content is never required to\n be non-blank."
addedOutput schema / $defs / DecFrontmatter / properties / status / enum
Added value: +[
+ "accepted",
+ "deprecated",
+ "draft",
+ "proposed",
+ "rejected",
+ "superseded"
+]
addedOutput schema / $defs / FeatFrontmatter / properties / status / enum
Added value: +[
+ "done",
+ "planning",
+ "progress",
+ "review"
+]
addedOutput schema / $defs / GolFrontmatter / properties / status / enum
Added value: +[
+ "accepted",
+ "deprecated",
+ "draft",
+ "implemented",
+ "proposed",
+ "rejected",
+ "superseded"
+]
addedOutput schema / $defs / PrbFrontmatter / properties / status / enum
Added value: +[
+ "active",
+ "cancelled",
+ "draft",
+ "resolved"
+]
addedOutput schema / $defs / QaFrontmatter / properties / status / enum
Added value: +[
+ "active",
+ "cancelled",
+ "done",
+ "draft"
+]
addedOutput schema / $defs / ReqFrontmatter / properties / status / enum
Added value: +[
+ "accepted",
+ "deprecated",
+ "draft",
+ "implemented",
+ "proposed",
+ "rejected",
+ "superseded"
+]
addedOutput schema / $defs / RskFrontmatter / properties / status / enum
Added value: +[
+ "accepted",
+ "closed",
+ "dropped",
+ "mitigating",
+ "occurred",
+ "open"
+]
addedOutput schema / $defs / SopFrontmatter / properties / status / enum
Added value: +[
+ "active",
+ "approved",
+ "draft",
+ "retired",
+ "review"
+]
addedOutput schema / $defs / SysrsFrontmatter / properties / status / enum
Added value: +[
+ "active",
+ "approved",
+ "draft",
+ "retired",
+ "review"
+]
addedOutput schema / $defs / TskFrontmatter / properties / status / enum
Added value: +[
+ "active",
+ "cancelled",
+ "done",
+ "draft"
+]
addedOutput schema / $defs / UcFrontmatter / properties / status / enum
Added value: +[
+ "accepted",
+ "deprecated",
+ "draft",
+ "proposed",
+ "superseded"
+]
addedOutput schema / $defs / VcrFrontmatter / properties / status / enum
Added value: +[
+ "approved",
+ "complete",
+ "draft",
+ "progress"
+]
