Rename description attribute to definition

[ahouseholder]

• resolves Avoid/replace JSON key description #903

Renames the description attribute in ssvc._mixins._Base to definition. All other changes are incidental to that one change.

Important

This PR touches a lot of files, so pay attention to merge order if you're merging more than one PR in rapid succession.
Anticipate that outstanding branches may have merge conflicts.

[sei-vsarvepalli]

Okay we are jumping on this one! running some tests first..

[sei-vsarvepalli]

Some tests for generating schema are failing, when trying to recreate the schema and test it. These may have been failing before. Should we fix it? The namespace is missing it says, but when namespace is provided it still fails.

python -m ssvc.decision_tables.base
    validated_self = self.__pydantic_validator__.validate_python(data, self_instance=self)
pydantic_core._pydantic_core.ValidationError: 1 validation error for DecisionTable
key
  Field required [type=missing, input_value={'name': 'Test Table', 'd...schemaVersion': '2.0.0'}, input_type=dict]
    For further information visit https://errors.pydantic.dev/2.11/v/missing

[sei-vsarvepalli]

Also the SSVC object ID validator is somewhere not right too.

  File "./src/ssvc/registry/__init__.py", line 67, in _handle_registration
    raise TypeError(f"Object {obj.id} is not a valid SSVC type.")
TypeError: Object ssvc:E:1.0.0 is not a valid SSVC type.

[ahouseholder]

@sei-vsarvepalli running ssvc.decision_table.base has been broken for a while as DecisionTable has evolved. Generating schema should be done via doctools.py.

I'm getting 175 passing tests with pushd docker && docker-compose up --build test so I'm not sure what you're running that's throwing the second error mentioned.