AF-10: Autocomplete

[mikecarenzo]

Implements ATT&CK autocomplete features.

Overview:

In order to support this feature, this PR introduces the suggestions configuration key to StringProperty. Now, any StringProperty can be configured to suggest zero or more predefined strings to the user. Suggestions are presented to the user when they select an empty text field and are progressively filtered out as text is typed.

This PR also introduces an Intelligence File (builder.config.intel.ts). This new configuration file drives the application's autocomplete features. This file is generated automatically by a set of scripts which download and organize relevant ATT&CK information into a format the application can leverage.

The Intelligence File is imported into the builder's configuration file (builder.config.ts) and is used to configure the autocomplete functionality of the tactic_id and technique_id properties (via the new suggestions configuration key).

Updating the Intelligence File

Simply invoke npm run update-intel to update the Intelligence File.

The configured list of sources can be modified at any time from download_sources.js

Cross-field Autofill

In order to support Autofill (in which one autocompleted field automatically fills out other related fields), this PR introduces the Processor construct. A Processor extends from DiagramProcessor. Much like a DiagramPublisher or DiagramValidator, the developer must implement their own DiagramProcessor and configure it via the main configuration file (builder.config.ts). Only one DiagramProcessor can be registered with the application at a time.

A processor's job is to intercept and "process" commands issued, by the interface, to the Page. This construct allows any PageCommand to be captured, modified, and forwarded according to the needs of the application.

For the purposes of the builder, AttackFlowProcessor (builder.config.processor.ts) has been implemented and configured. This processor:

1. Intercepts SetStringProperty commands that modify an action's tactic_id or technique_id properties.
2. Inspects their associated property group and resolves related properties (tactic_ref, technique_ref, etc.)
3. Mints new SetStringProperty for each related property that can be autofilled (using intel from the Intelligence File).
4. Bundles all the SetStringProperty commands into a single GroupCommand.
5. Forwards the GroupCommand along (to be executed by the application).

All other command types are forwarded along without modification.

[mehaase]

Code looks good. A couple changes requested:

1. Please add the explanation for updating the intel file to the developers.rst doc.
2. Some of the other dropdowns are broken:

• 
• 

3. The Tactic ID and Technique ID should only be the TA### and T### numbers, not including the technique name.

One other thing I noticed is that unfocusing the autocomplete list can be tricky. In the interest of shipping this feature, it shouldn't block this PR, but please add an issue to our backlog so we can keep track of this:

1. My first attempt to unfocus was to click on the main canvas, but that of course also deselects the currently selected item. Would it be possible to only unfocus the text box?
2. I also tried typing escape to dismiss the autocomplete, but

[mehaase]

Approved pending the item we discussed over the phone...

[sonarcloud]

SonarCloud Quality Gate failed.   

1 Bug
0 Vulnerabilities
1 Security Hotspot
8 Code Smells

No Coverage information
52.5% Duplication

Catch issues before they fail your Quality Gate with our IDE extension SonarLint