Systems and Snapshots

A System is the primary organizing concept in Istari. Systems contain Configurations (sets of tracked files) and Snapshots (point-in-time captures of those configurations).

Browse Systems

1. Click Systems in the sidebar (or navigate to /systems).
2. You will see a grid of system cards showing each system's name, description, creator, and creation date.
3. Use the Search field in the top-right to filter systems by name, description, or creator.
4. Systems are loaded in pages of 50. If more are available, a Load more button appears at the bottom of the grid (up to 100 systems are fetched from the API).

Each system card displays:

• The system name (clickable — opens the system)
• A configuration badge showing the latest configuration name (click to navigate directly to that configuration)
• If the system has multiple configurations, a popover appears listing all configurations
• The creator's name and avatar
• The creation date
• An optional infosec badge if information security levels are enabled

Create a System

1. Navigate to the Systems page.
2. Click the Create button (with plus icon) in the top-right corner.
3. In the dialog that appears:
   • Enter a Name for the system (defaults to "Untitled system").
   • Optionally add a Description.
4. Click Create.
5. You will be automatically redirected to the new system's detail page.

View System Details

1. From the Systems page, click on a system card to open it.
2. The system detail page has two main panels:
   • Left panel (Explorer): Shows the version menu (configurations and snapshots) and the snapshot file tree.
   • Right panel (Content): Shows the selected file's preview, metadata, and activity.
3. Breadcrumbs at the top show: Systems > System Name. Hover over the system name to see its description.

Edit a System

1. Open the system you want to edit.
2. Click the ⋯ (more options) menu in the top-right corner of the page.
3. Select Edit system details.
4. Update the Name and/or Description in the dialog.
5. Click Save.

Required role: Editor, Administrator, or Owner.

Archive a System

1. Open the system you want to archive.
2. Click the ⋯ menu in the top-right corner.
3. Select Archive system.
4. Confirm the action in the dialog that appears.

You can also archive a system directly from the Systems grid page by clicking the ⋯ menu on the system card and selecting Archive.

Required role: Owner only.

Configurations

A Configuration defines which files are tracked within a system.

Create a Configuration

1. Open a system.
2. In the left panel (Explorer), click the + (Layers Plus) icon at the top of the version menu.
3. In the Create Configuration dialog, select the files to track.
4. Click Create.

Required role: Editor or above.

Archive / Restore a Configuration

1. In the left panel, expand the version menu to see all configurations.
2. Hover over a configuration name and click the ⋯ menu.
3. Select Archive configuration (or Restore if it is already archived).
4. To see archived configurations, check the Show archived checkbox in the version menu.

Mark a Configuration as Baseline

1. In the version menu, hover over a non-baseline configuration.
2. Click the ⋯ menu.
3. Select Mark as baseline.

The configuration must have at least one snapshot.

Snapshots

A Snapshot captures the current state of a configuration's tracked files at a point in time.

Capture a Snapshot

1. Open a system that has file changes pending.
2. In the left panel, a "New Snapshot Available" banner appears.
3. Click Capture Changes to create a new snapshot.

Required role: Editor or above.

Browse Snapshots

1. In the left panel, expand a configuration in the version menu.
2. All snapshots are listed under their parent configuration, showing creation dates and creator avatars.
3. Click a snapshot to load its file tree in the explorer below.

Add Tags to a Snapshot

1. Expand a configuration in the version menu.
2. Next to a snapshot, click the tag area to add or edit tags inline.

Compare Snapshots (Diff)

1. Open a system.
2. Click the ⋯ menu in the top-right corner.
3. Select Compare versions.
4. In the Compare Snapshots modal:
   • Select a left snapshot and a right snapshot using the snapshot selectors.
   • The diff viewer displays changes between the two snapshots (added, removed, and modified files).

Upload Files to a System

Drag and Drop

1. Open the system detail page.
2. Drag files from your computer and drop them anywhere on the page.
3. The Upload Spec dialog appears — fill in metadata (display name, tags, infosec level, etc.).
4. After upload completes, you may be prompted to create a new configuration or add the files to an existing one.

Using the File Tree

1. In the left panel file tree, look for the Upload option.
2. Click it to open a file picker dialog and select files from your computer.

Required role: Editor or above.

Browse the Snapshot File Tree

1. Open a system and select a snapshot from the version menu.
2. The left panel shows a file tree with:
   • Files organized in a hierarchical folder structure.
   • Artifact groups nested under their parent files (grouped by the job that produced them).
   • Job group nodes showing the tool/function name that produced the artifacts (click the job name to view job details).
3. Click any file to view its preview, metadata, and actions in the right panel.

System Documents

Note: System Documents is an experimental feature. Enable it in Application Settings > Experimental — System Documents.

When enabled:

1. A Documents section appears in the snapshot file tree.
2. Click a document to open it in the Document Editor in the right panel.
3. Toggle between View mode and Edit mode using the ?mode=edit URL parameter or the edit toggle in the UI.
4. Documents support export functionality.

Edit permissions are controlled per-document based on individual document access grants.

Download Snapshot Files

1. Open a system and select a snapshot.
2. In the top action bar, click the Download button.
3. A Download selected files panel appears. Select the files you want from the snapshot tree.
4. Click Download to download the selected files.