Synapse

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

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

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

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

- Add ``$node.props.set()`` Stormtypes API to allow programmatically setting
node properties.
(`2324 <https://github.com/vertexproject/synapse/pull/2324>`_)
- Deny non-runtsafe invocations of the following Storm commands:
(`2326 <https://github.com/vertexproject/synapse/pull/2326>`_)

- ``graph``
- ``iden``
- ``movetag``
- ``parallel``
- ``tee``
- ``tree``

- Add a ``Axon.hashset()`` API to get the md5, sha1, sha256 and sha512 hashes
of file in the Axon. This is exposed in Stormtypes via the
``$lib.bytes.hashset()`` API.
(`2327 <https://github.com/vertexproject/synapse/pull/2327>`_)
- Add the ``synapse.servers.stemcell`` server and a new Docker image,
``vertexproject/synaspe-stemcell``. The Stemcell server is similar to the
``synapse.servers.cell`` server, except it resolves the Cell ctor from the
``cell:ctor`` key from the ``cell.yaml`` file, or from the
``SYN_STEM_CELL_CTOR`` environment variable.
(`2328 <https://github.com/vertexproject/synapse/pull/2328>`_)

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

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

- Add ``storm-envvar`` directive to RST preprocessor to include environment
variables in ``storm-pre`` directive execution context.
(`2321 <https://github.com/vertexproject/synapse/pull/2321>`_)
- Add new ``diff`` storm command to allow users to easily lift the set of nodes
with changes in the top layer of a forked view. Also adds the ``--no-tags``
option to the ``merge`` command to allow users to omit ``tag:add`` node edits
and newly constructed ``syn:tag`` nodes when merging selected nodes.
(`2320 <https://github.com/vertexproject/synapse/pull/2320>`_)
- Adds the following properties to the data model:
(`2319 <https://github.com/vertexproject/synapse/pull/2319>`_)

- ``biz:deal:buyer:org``
- ``biz:deal:buyer:orgname``
- ``biz:deal:buyer:orgfqdn``
- ``biz:deal:seller:org``
- ``biz:deal:seller:orgname``
- ``biz:deal:seller:orgfqdn``
- ``biz:prod:madeby:org``
- ``biz:prod:madeby:orgname``
- ``biz:prod:madeby:orgfqdn``
- ``ou:opening:posted``
- ``ou:opening:removed``
- ``ou:org:vitals``

- Updates ``storm-mock-http`` to support multiple HTTP requests/responses
in RST preprocessor.
(`2317 <https://github.com/vertexproject/synapse/pull/2317>`_)

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

This release contains an automatic data migration that may cause additional
startup time on the first boot. This is done to unique array properties which
previously were not uniqued. Deployments with startup or liveliness probes
should have those disabled while this upgrade is performed to prevent
accidental termination of the Cortex process. Please ensure you have a tested
backup available before applying this update.

Features and Enhancements
-------------------------
- Add an ``embeds`` option to Storm to allow extracting additional data
when performing queries.
(`2314 <https://github.com/vertexproject/synapse/pull/2314>`_)
- Enforce node data permissions at the Layer boundary. Remove the
``node.data.get`` and ``node.data.list`` permissions.
(`2311 <https://github.com/vertexproject/synapse/pull/2311>`_)
- Add ``auth.self.set.email``, ``auth.self.set.name``,
``auth.self.set.passwd`` permissions on users when changing those values.
These permissions default to being allowed, allowing a rule to be created
that can deny users from changing these values.
(`2311 <https://github.com/vertexproject/synapse/pull/2311>`_)
- Add ``$lib.inet.smtp`` to allow sending email messages from Storm.
(`2315 <https://github.com/vertexproject/synapse/pull/2315>`_)
- Warn if a LMDB commit operation takes too long.
(`2316 <https://github.com/vertexproject/synapse/pull/2316>`_)
- Add new data types, ``taxon`` and ``taxonomy``, to describe hierarchical
taxonomies.
(`2312 <https://github.com/vertexproject/synapse/pull/2312>`_)
- Add a new Business Development model. This allows tracking items related to
contract, sales, and purchasing lifecycles. This adds the following new forms
to the data model: ``biz:dealtype``, ``biz:prodtype``, ``biz:dealstatus``,
``biz:rfp``, ``biz:deal``, ``biz:bundle``, ``biz:product``, and
``biz:stake``. The Org model is also updated to add new forms for supporting
parts of the business lifecycle, adding ``ou:jobtype``,
``ou:jobtitle``, ``ou:employment``, ``ou:opening``, ``ou:vitals``,
``ou:camptype``, and ``ou:orgtype``, ``ou:conttype`` forms. The Person model
got a new form, ``ps:workhist``.
(`2312 <https://github.com/vertexproject/synapse/pull/2312>`_)
- Add a ``:deleted`` property to ``inet:web:post``.
(`2312 <https://github.com/vertexproject/synapse/pull/2312>`_)
- Update the following array properties to be unique sets, and add a data
model migration to update the data at rest:
(`2312 <https://github.com/vertexproject/synapse/pull/2312>`_)

- ``edu:course:prereqs``
- ``edu:class:assistants``
- ``ou:org:subs``
- ``ou:org:names``
- ``ou:org:dns:mx``
- ``ou:org:locations``
- ``ou:org:industries``
- ``ou:industry:sic``
- ``ou:industry:subs``
- ``ou:industry:isic``
- ``ou:industry:naics``
- ``ou:preso:sponsors``
- ``ou:preso:presenters``
- ``ou:conference:sponsors``
- ``ou:conference:event:sponsors``
- ``ou:conference:attendee:roles``
- ``ou:conference:event:attendee:roles``
- ``ou:contract:types``
- ``ou:contract:parties``
- ``ou:contract:requirements``
- ``ou:position:reports``
- ``ps:person:names``
- ``ps:person:nicks``
- ``ps:persona:names``
- ``ps:persona:nicks``
- ``ps:education:classes``
- ``ps:contactlist:contacts``

Bugfixes
--------
- Prevent renaming the ``all`` role.
(`2313 <https://github.com/vertexproject/synapse/pull/2313>`_)

Improved Documentation
----------------------
- Add documentation about Linux kernel parameteres which can be tuned to
affect Cortex performance.
(`2316 <https://github.com/vertexproject/synapse/pull/2316>`_)