Synapse

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

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>`_)

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

Features and Enhancements
-------------------------
- Add ``!pushfile``, ``!pullfile``, and ``!runfile`` commands to the
``synapse.tools.storm`` tool.
(`2334 <https://github.com/vertexproject/synapse/pull/2334>`_)
- Add multiname SNI support to ``ssl://`` listening configurations for
the Daemon.
(`2336 <https://github.com/vertexproject/synapse/pull/2336>`_)
- Add a new Cortex HTTP API Endpoint, ``/api/v1/feed``. This can be used to
add nodes to the Cortex in bulk.
(`2337 <https://github.com/vertexproject/synapse/pull/2337>`_)
- Refactor the ``syn.nodes`` feed API implementation to smooth out the ingest
rate.
(`2337 <https://github.com/vertexproject/synapse/pull/2337>`_)
- Sort the Storm Package commands in documentation created by
``synpse.tools.autodoc`` alphabetically.
(`2335 <https://github.com/vertexproject/synapse/pull/2335>`_)

Deprecations
------------
- Deprecate the ``syn.splices`` and ``syn.nodedata`` feed API formats.
(`2337 <https://github.com/vertexproject/synapse/pull/2337>`_)

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

Features and Enhancements
-------------------------
- Add a basic ``synapse.tools.storm`` CLI tool. This can be used to connect
to a Cortex via Telepath and directly execute Storm commands.
(`2332 <https://github.com/vertexproject/synapse/pull/2332>`_)
- Add an ``inet:http:session`` form to track the concept of a prolonged
session a user may have with a webserver across multiple HTTP requests.
Add an ``:success` property to the ``ou:campaign`` form to track if a
campaign was sucessful or not. Add an ``:goal`` property to the
``risk:attack`` form to track the specific goal of the attack. Add an
``:desc`` property to the ``proj:project`` form to capture a description of
the project.
(`2333 <https://github.com/vertexproject/synapse/pull/2333>`_)

Bugfixes
--------
- Fix an issue with ``synapse.lib.rstorm`` where multiline node properties
could produce RST which did not render properly.
(`2331 <https://github.com/vertexproject/synapse/pull/2331>`_)

Improved Documentation
----------------------
- Clean up the documentation for the Storm ``wget`` command.
(`2325 <https://github.com/vertexproject/synapse/pull/2325>`_)

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

Features and Enhancements
-------------------------
- Refactor some internal Axon APIs for downstream use.
(`2330 <https://github.com/vertexproject/synapse/pull/2330>`_)

Bugfixes
--------
- Resolve an ambiguity in the Storm grammar with yield statement and dollar
expressions inside filter expression. There is a slight backwards
incompatibility with this change, as dollar expressions insider of filter
expressions now require a ``$`` prepended where before it was optional.
(`2322 <https://github.com/vertexproject/synapse/pull/2322>`_)