Synapse

===================

Bugfixes
--------

- The Axon test suite was missing a test for calling ``Axon.get()`` on a file it did not have. This is now included in
the test suite.
(`1783 <https://github.com/vertexproject/synapse/pull/1783>`_)

Improved Documentation
----------------------

- Improve Synapse devops documentation hierarchy. Add note about Cell directories being persistent.
(`1781 <https://github.com/vertexproject/synapse/pull/1781>`_)

===================

Features and Enhancements
-------------------------

- Add a ``postAnit()`` callback to the ``synapse.lib.base.Base()`` object which is called *after* the ``__anit__()``
call chain is completed, but before ``Base.anit()`` returns the object instance to the caller. This is used by the
Cell to defer certain Nexus actions until the Cell has completed initializing all of its instance attributes.
(`1768 <https://github.com/vertexproject/synapse/pull/1768>`_)
- Make ``synapse.lib.msgpack.en()`` raise a ``SynErr.NotMsgpackSafe`` exception instead of passing through the
exception raised by msgpack.
(`1768 <https://github.com/vertexproject/synapse/pull/1768>`_)

Bugfixes
--------

- Add a missing ``toprim()`` call in ``$lib.globals.set()``.
(`1778 <https://github.com/vertexproject/synapse/pull/1778>`_)
- Fix an issue in the quickstart documentation related to permissions. Thank you ``enadjoe`` for your contribution.
(`1779 <https://github.com/vertexproject/synapse/pull/1779>`_)
- Fix an Cell/Cortex startup issue which caused errors when starting up a Cortex when the last Nexus event was
replayed. This has a secondary effect that Cell implementers cannot be making Nexus changes during the ``__anit__``
methods.
(`1768 <https://github.com/vertexproject/synapse/pull/1768>`_)

Improved Documentation
----------------------

- Add a minimal Storm Service example to the developer documentation.
(`1776 <https://github.com/vertexproject/synapse/pull/1776>`_)
- Reorganize the Synapse User Guide into a more hierarchical format.
(`1777 <https://github.com/vertexproject/synapse/pull/1777>`_)
- Fill out additional glossary items.
(`1780 <https://github.com/vertexproject/synapse/pull/1780>`_)

===================

Bugfixes
--------

- Disallow command and bare string contensts from starting with ``//`` and ``/*`` in Storm syntax.
(`1769 <https://github.com/vertexproject/synapse/pull/1769>`_)

===================

Bugfixes
--------

- Fix an issue in the autodoc tool which failed to account for Storm Service commands without cmdargs.
(`1775 <https://github.com/vertexproject/synapse/pull/1775>`_)

===================

Features and Enhancements
-------------------------

- Add information about light edges to graph carving output.
(`1762 <https://github.com/vertexproject/synapse/pull/1762>`_)
- Add a ``geo:json`` type and ``geo:place:geojson`` property to the model.
(`1759 <https://github.com/vertexproject/synapse/pull/1759>`_)
- Add the ability to record documentation for light edges.
(`1760 <https://github.com/vertexproject/synapse/pull/1760>`_)
- Add the ability to delete and set items inside of a MultiQueue.
(`1766 <https://github.com/vertexproject/synapse/pull/1766>`_)

Improved Documentation
----------------------

- Refactor ``v2.0.0`` changelog documentation.
(`1763 <https://github.com/vertexproject/synapse/pull/1763>`_)
- Add Vertex branding to the Synapse documentation.
(`1767 <https://github.com/vertexproject/synapse/pull/1767>`_)
- Update Backups documentation in the Devops guide.
(`1764 <https://github.com/vertexproject/synapse/pull/1764>`_)
- Update the autodoc tool to generate documentation for Cell confdefs and StormService information.
(`1772 <https://github.com/vertexproject/synapse/pull/1772>`_)
- Update to separate the devops guides into distinct sections.
(`1772 <https://github.com/vertexproject/synapse/pull/1772>`_)
- Add documentation for how to do boot-time configuration for a Synapse Cell.
(`1772 <https://github.com/vertexproject/synapse/pull/1772>`_)
- Remove duplicate information about backups.
(`1774 <https://github.com/vertexproject/synapse/pull/1774>`_)

===================

Initial 2.0.0 release.

.. _changelog-depr-20231001:

API Deprecation Notice - 2023-10-01
===================================

It's time to shed some long standing deprecations to reduce technical debt
and prepare for some new features and subsystems! The following deprecated
APIs and commands will be removed on 2023-10-01:

Storm Commands
--------------

- ``sudo``
- ``splice.list``
- ``splice.undo``

Storm Options
-------------

- ``editformat=splices``

Cortex Telepath APIs
--------------------

- ``stat()``
- ``addCronJob()``
- ``delCronJob()``
- ``updateCronJob()``
- ``enableCronJob()``
- ``disableCronJob()``
- ``listCronJobs()``
- ``editCronJob()``
- ``setStormCmd()``
- ``delStormCmd()``
- ``addNodeTag()``
- ``delNodeTag()``
- ``setNodeProp()``
- ``delNodeProp()``
- ``eval()``
- ``watch()``
- ``splices()``
- ``splicesBack()``
- ``spliceHistory()``
- ``addFeedData(syn.splice, ...)``
- ``addFeedData(syn.nodeedits, ...)``

Layer Telepath APIs
-------------------

- ``splices()``
- ``splicesBack()``
- ``truncate()``

Cmdr Commands
-------------

- ``at``
- ``cron``
- ``trigger``