Bulletin Packaging Specifications

This document outlines the format required for a *.STLX file that will be downloaded by the Standard System as update instructions from its relay master.

The file should begin with parent object package {…}. At the beginning of this object we specify metadata about this bulletin that serves to verify its authenticity.

version — Bulletin format version. Currently, 1

format — Always STLX

date — As eight digits MMDDYYY

match — JWT.

    
    package {

        version 1
        format STLX
        date 10022025
        match w9hqewpf7hqoerf7hoe8r7hfq8oeh7froqe

        bulletin {

            articles {
                record_id_1 update
                record_id_2 delete
                record_id_3 move locations
            }

            locations {
                record_id_99 update
                record_id_98 update
            }

            standards {
                articles update
                locations update
                vehicles delete
                contacts clean
            }
        }

        software {

            packages {
                standard this
                chromium-browser update
                htop remove
            }

            scripts {

            }
        }
    }
    

The metadata properties are followed by two blocks: bulletin {…} and software {…}.

Bulletin Block

The bulletin block defines the information to be updated. This includes Standard records like articles, locations, or images in the information database for search. The bulletin block may have later predefined blocks.

The succeeding bulletin blocks contain a list of Record IDs separated by new line characters. You may specify an action to take for the record by following the Record ID with one of three actions: update, move, or delete.

If no action is specified, update is used as the default action. If move is specified, follow the action with the name of the Standard table the record should be moved to.

You can maintain a block for each Standard table if you are using a custom relay. The block name will be the name of the Standard.

Standards

The standards block contains a list of Standards separated by new line characters where each entry is the name of the Standard. The receiving device will execute the succeeding action of each Standard identified by its master.

You may follow a Standard name with update or delete and Standard will take the identified action.

Software Block

The software block defines actual software packages that may need updated, removed, or modified to help the Standard device work properly.

Immediately following the software block declaration, append self: bool to define if a software update is available for the actual Standard System. If false, the system will not follow the software update process.

If self: true, the Standard System follows the system update process indicated in the following packages block.

Packages

The packages block contains a list of operating system level packages that should be updated. The packages are separated by new line characters and must be the actual package name for apt-list.

Standard attempts to update these packages after a Standard System update if one is available. If a Standard System update is available, list standard as a package.

A package may also be a link or URI. The resources at the URI will be downloaded into Standard's /temp folder and action will be taken according to the resource's file type.

Scripts

Standard code may be placed inside the scripts block and will be executed after all other bulletin commands and software updates have been run.

A nefarious bulletin could execute any Standard code through this block. It is imperative that bulletin packaging specification files are SHA checked.