Synapse

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

Features and Enhancements
-------------------------
- Add a ``risk:attacktype`` taxonomy to the risk model. Add ``:desc`` and
``:type`` properties to the ``risk:attack`` form.
(`2386 <https://github.com/vertexproject/synapse/pull/2386>`_)
- Add ``:path`` property to the ``it:prod:softfile`` form.
(`2388 <https://github.com/vertexproject/synapse/pull/2388>`_)

Bugfixes
--------
- Fix the repr for the``auth:user`` Stormtype when printing a user
object in Storm.
(`2383 <https://github.com/vertexproject/synapse/pull/2383>`_)

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

Bugfixes
--------
- Fix an issue in the Nexus log V1 to V2 migration code which resulted in
LMDB file copies being made instead of having directories renamed. This can
result in a sparse file copy of the Nexus log, resulting in a condition
where the volume containing the Cell directory may run out of space.
(`2374 <https://github.com/vertexproject/synapse/pull/2374>`_)

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

Features and Enhancements
-------------------------
- Add APIs to support trimming, rotating and culling Nexus logs from Cells
with Nexus logging enabled. These operations are distributed to downstream
consumers, of the Nexus log (e.g. mirrors). For the Cortex, this can be
invoked in Storm with the ``$lib.cell.trimNexsLog()`` Stormtypes API. The
Cortex devops documentation contains more information about Nexus log
rotation.
(`2339 <https://github.com/vertexproject/synapse/pull/2339>`_)
(`2371 <https://github.com/vertexproject/synapse/pull/2371>`_)
- Add ``.size()`` API to the Stormtypes ``storm:query`` object. This will run
the query and return the number of nodes it would have yielded.
(`2363 <https://github.com/vertexproject/synapse/pull/2363>`_)

Improved Documentation
----------------------
- Document the tag glob meanings on the Stormtypes ``$node.tags()`` API.
(`2368 <https://github.com/vertexproject/synapse/pull/2368>`_)

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

Features and Enhancements
-------------------------
- Add a ``!export`` command to the Storm CLI to save query results to a
``.nodes`` file.
(`2356 <https://github.com/vertexproject/synapse/pull/2356>`_)
- Add ``$lib.cell.hotFixesCheck()`` and ``$lib.cell.hotFixesApply()``
Stormtypes functions. These can be used to apply optional hotfixes to a
Cortex on demand by an admin.
(`2348 <https://github.com/vertexproject/synapse/pull/2348>`_)
- Add ``$lib.infosec.cvss.calculateFromProps()`` to allow calculating a CVSS
score from a dictionary of CVSS properties.
(`2353 <https://github.com/vertexproject/synapse/pull/2353>`_)
- Add ``$node.data.has()`` API to Stormtypes to allow easy checking if a node
has nodedata for a given name.
(`2350 <https://github.com/vertexproject/synapse/pull/2350>`_)

Bugfixes
--------
- Fix for large return values with ``synapse.lib.coro.spawn()``.
(`2355 <https://github.com/vertexproject/synapse/pull/2355>`_)
- Fix ``synapse.lib.scrape.scrape()`` capturing various common characters used
to enclose URLs.
(`2352 <https://github.com/vertexproject/synapse/pull/2352>`_)
- Ensure that generators being yielded from are always being closed.
(`2358 <https://github.com/vertexproject/synapse/pull/2358>`_)
- Fix docstring for ``str.upper()`` in Stormtypes.
(`2354 <https://github.com/vertexproject/synapse/pull/2354>`_)

Improved Documentation
----------------------
- Add link to the Power-Ups blog post from the Cortex dev-ops documentation.
(`2357 <https://github.com/vertexproject/synapse/pull/2357>`_)

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

Features and Enhancements
-------------------------
- Add new ``risk:compromise`` and ``risk:compromisetype`` forms. Add
``attacker``, ``compromise``, and ``target`` secondary properties to the
``risk:attack`` form.
(`2348 <https://github.com/vertexproject/synapse/pull/2348>`_)

Bugfixes
--------
- Add a missing ``wait()`` call when calling the ``CoreApi.getAxonUpload()``
and ``CoreApi.getAxonBytes()`` Telepath APIs.
(`2349 <https://github.com/vertexproject/synapse/pull/2349>`_)

Deprecations
------------
- Deprecate the ``actor:org``, ``actor:person``, ``target:org`` and
``target:person`` properties on ``risk:attack`` in favor of new ``attacker``
and ``target`` secondary properties. Deprecate the ``type`` property on
``ou:campaign`` in favor of the ``camptype`` property.
(`2348 <https://github.com/vertexproject/synapse/pull/2348>`_)

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

Features and Enhancements
-------------------------
- Add a new Storm command, ``pkg.docs``, to enumerate any documentation that
has been bundled with a Storm package.
(`2341 <https://github.com/vertexproject/synapse/pull/2341>`_)
- Add support for manipulating ``'proj:comment`` nodes via Stormtypes.
(`2345 <https://github.com/vertexproject/synapse/pull/2345>`_)
- Add ``Axon.wput()`` and ``$lib.axon.wput()`` to allow POSTing a file from
an Axon to a given URL.
(`2347 <https://github.com/vertexproject/synapse/pull/2347>`_)
- Add ``$lib.export.toaxon()`` to allow exporting a ``.nodes`` file directly
to an Axon based on a given storm query and opts.
(`2347 <https://github.com/vertexproject/synapse/pull/2347>`_)
- The ``synapse.tools.feed`` tool now accepts a ``--view`` argument to feed
data to a specific View.
(`2342 <https://github.com/vertexproject/synapse/pull/2342>`_)
- The ``synapse.tools.feed`` tool now treats ``.nodes`` files as msgpack files
for feeding data to a Cortex.
(`2343 <https://github.com/vertexproject/synapse/pull/2343>`_)
- When the Storm ``help`` command has an argument without any matching
commands, it now prints a helpful message.
(`2338 <https://github.com/vertexproject/synapse/pull/2338>`_)

Bugfixes
--------
- Fix a caching issue between ``$lib.lift.byNodeData()`` and altering the
existing node data on a given node.
(`2344 <https://github.com/vertexproject/synapse/pull/2344>`_)
- Fix an issue with backups were known lmdbslabs could be omitted from being
treated as lmdb databases, resulting in inefficient file copies being made.
(`2346 <https://github.com/vertexproject/synapse/pull/2346>`_)