Groundkit Release Notes
1. Groundkit 2026.13.0
Changes in this release:
-
GroundkitFoundationbundle changed from12.1.0to13.0.0:-
FIX
storage.logging.PacketLoggingInitiatorGRPCnow uses a separate sporadic task to subscribe to each message, avoiding gRPC blocking issues. -
BREAKING Deployment types that use
storage.logging.PacketLoggingInitiatorGRPCmust be updated to include the two new sporadic tasks.
-
-
GroundkitExtrasbundle changed from4.1.0to4.2.1:-
NEW
comms.gsns.GroundStationNetworkInitiatorGRPCnow publishescommunication.GroundStationNetworkmessages over gRPC. -
NEW The current status of each configured
infra.paras.ParameterMonitorcheck can now be queried or subscribed to.
-
-
Documentation updated for 2026.13.0
2. Groundkit 2026.12.0
Changes in this release:
-
GroundkitFoundationbundle changed from12.0.0to12.1.0:-
NEW The
component.CDS.utilCommandTypeenumeration now includesPARAMETER_GET_SIZE,PARAMETER_GET_DESCandPARAMETER_GET_COUNT.
-
-
GroundkitExtrasbundle changed from4.0.0to4.1.0:-
NEW
infra.auto.EventResponseconfiguration now accepts a string foreventInfoandargumentValue, with neweventInfoTypeandargumentTypefields to control how each is interpreted. -
NEW Configuration fields for the
infra.paras.ParameterMonitorandinfra.auto.EventResponsecomponent types are now documented in theircomponentType.xml.
-
-
Documentation updated for 2026.12.0
3. Groundkit 2026.11.0
Changes in this release:
-
hgktooling updated from6.3.0to7.0.0:-
BREAKING Deployment assembly jars are now named after the deployment instance and written to a directory named after it, rather than after the deployment type. Scripts and CI pipelines that reference these jars must be updated.
-
-
GroundkitFoundationbundle changed from11.0.0to12.0.0:-
NEW Added the
comms.pus.PUSAMScomponent type. -
BREAKING This version can only be used with workspaces and bundles generated with
hgk7.x.x.
-
-
GroundkitExtrasbundle changed from2.2.0to4.0.0:-
NEW Added
infra.auto.EventResponseInitiatorGRPC, and added the missing publish-subscribe gRPC functionality forcommunication.OrbitalParameterSourceInitiatorGRPCandcommunication.OrbitalParameterSourceTargetGrpc. -
NEW
infra.auto.EventResponsenow supports multiple response configurations for a single event. -
BREAKING The base event ID of
infra.paras.ParameterMonitorchanged from105100to10510so that it fits a 16-bit range. Code that relies on hardcoded event IDs must be updated. -
BREAKING The
selectionIdforEventResponseEntryCRUD operations is now the position of the entry in the list rather than the event ID. -
BREAKING This version can only be used with workspaces and bundles generated with
hgk7.x.x.
-
-
MIS updated from
4.3.0to5.0.0:-
BREAKING Accounts for the new deployment jar name and location introduced by
hgk7.0.0. -
FIX
ReferenceInfofull names are now updated correctly after a rename.
-
-
Documentation updated for 2026.11.0
4. Groundkit 2026.10.0
Changes in this release:
-
hgktooling updated from6.2.0to6.3.0:-
NEW Deployments within a target marked as a placeholder are no longer built, improving build times for missions with many placeholder targets.
-
FIX Removed the
remoteTargetIdsworkaround for send and notify operations from container init data and deploy files.
-
-
GroundkitFoundationbundle changed from10.0.0to11.0.0:-
NEW Added
core.component.eds.EDSSender, which proxies EDS event messages to a remote system over AMS, andcore.component.eds.EDSInitiatorGRPC, which subscribes to event messages over gRPC and republishes them in its own deployment. -
FIX
LocalFileStorenow handles large files correctly, up to a maximum of 2 GB minus 8 bytes. -
FIX
LocalFileStorenow creates its mount point, and any missing parent directories, so you no longer have to create the folder by hand. -
BREAKING Publish-subscribe over gRPC has been reworked to follow the standard initiator/target pattern. The
storage.logging.CommandNotificationSenderGRPC,communication.FileTransferMessageSenderGRPC,storage.logging.EventNotificationSenderGRPCandcdh.bts.BTSSenderGRPCsender components have been removed and must be taken out of your deployment types.
-
-
GroundkitExtrasbundle changed from2.1.0to2.2.0:-
FIX
infra.paras.ParameterMonitornow supports checks on all signed and unsigned integer types, with the exception of unsigned long.
-
-
Documentation updated for 2026.10.0
5. Groundkit 2026.9.0
Changes in this release:
-
GroundkitFoundationbundle changed from9.0.0to10.0.0:-
BREAKING The gRPC service proxy initiator and target components for
io.CommunicationsServicehave been standardised: you must now supply the full service provider ID when invoking thesendoperation, and the map of service provider IDs to channel IDs has been removed from the initiator’s init data. -
FIX Loopback service proxy initiators now use the wildcard deployment ID when looping requests back into the host deployment.
-
-
GroundkitExtrasbundle changed from1.0.0to2.1.0:-
BREAKING
infra.paras.ParameterMonitorandinfra.auto.EventResponsenow reload their configuration through an action rather than a service operation. -
BREAKING The booking manager now uses limited provision where appropriate.
-
FIX
infra.paras.ParameterMonitornow publishes an event on status change rather than on every check cycle, and retrieves values from the parameter archive correctly.
-
-
Documentation updated for 2026.9.0
6. Groundkit 2026.8.0
Changes in this release:
-
hgktooling updated from6.0.0to6.2.0:-
NEW Python code generation now handles more services.
-
NEW Send and notify operation code is no longer generated into component files when implementation access is
None. -
FIX Service messages and service operations containing lists, or custom types with lists, no longer cause compile errors in the generated gRPC code.
-
-
GroundkitFoundationbundle changed from8.0.0to9.0.0:-
NEW Added a component type for sending and receiving KSAT name/value telecommand frames.
-
NEW Added loopback service proxy initiators for the
component.AAS,component.PAS,storage.FSS,communication.FileTransferandcdh.BTSservices. -
NEW Added
storage.logging.PacketPublisher, which sits between two communications components and publishes the packets passing through them, andstorage.logging.InContextPacketLoggingBroker. -
BREAKING Full packets can now be published both locally and over gRPC, which adds a
fullPacketDataservice message to the packet logging service. ThePacketNotificationSenderGRPCcomponent has been removed and must be replaced withstorage.logging.PacketLoggingInitiatorGRPCandstorage.logging.PacketLoggingTargetGRPC.
-
-
GroundkitExtrasbundle changed from0.1.0to1.0.0:-
NEW The booking manager and orbital parameter source components, and the orbital parameter source service, are now provided by
GroundkitExtras. Ops users who already have their own copies of these must remove them. -
FIX
infra.paras.ParameterMonitorandinfra.auto.EventResponseno longer require a valid configuration file to be present when the component initialises.
-
-
MIS updated from
3.1.0to4.3.0:-
NEW Mission merging: several mission databases can be loaded into a single model and merged into one mission, and the
ModelLoadercomponent gains aresetoperation that clears all loaded mission databases.
-
-
Documentation updated for 2026.8.0
7. Groundkit 2026.7.0
Changes in this release:
-
GroundkitFoundationbundle changed from7.2.0to8.0.0:-
NEW A SlipFrame component implementation has been ported based on previous services work.
-
NEW A component implementing the KSAT Generic TC Protocol has been implemented.
-
BREAKING A new field has been added to the io.CommunicationsService serivce. All components that require or provide this service need to be updated accordingly.
-
-
hgktooling updated from5.2.0to6.0.0:-
NEW Model XSD files are now included in the Groundkit archive.
-
NEW Added comments to tooling-controlled files to discourage manual editing.
-
NEW Helix Groundkit repository updated to use the latest tooling core and model version.
-
NEW Added
SelectionIdto Send operation generation. -
NEW Added
SelectionIdto Notify operation generation. -
NEW Developers can now access
firstRow,lastRow, andresizeparameters for multirow parameter gets. -
FIX Fixed incorrect setup of remote service providers when multiple providers exist for the same service.
-
FIX Fixed compile issues in generated gRPC Service Mapper when service message arguments use upper camel case.
-
FIX Removed redundant
groupIdentries in artefact pom.xml files. -
FIX Fixed whitespace issues in Deployment InitData files.
-
FIX Updated exception handling to use
component.PASexceptions with correct status codes. -
FIX Updated except
-
-
Documentation updated for 2026.7.0
8. Groundkit 2026.6.0
Changes in this release:
-
GroundkitFoundation bundle changed from 7.1.0 to 7.2.0:
-
NEW Added storage.fss.FSSTarget ComponentType which allows a local provider of the FSS Service to be accessed remotely using serialised FSS requests.
-
-
hgk updated from 5.1.0 to 5.2.0:
-
NEW Added Python scripting codegen command to hgk.
-
-
Documentation updated for 2026.6.0.
9. Groundkit 2026.5.0
Changes in this release:
-
GroundkitFoundation bundle changed from 7.0.0 to 7.1.0:
-
NEW Added CommunicationsServiceInitiatorGRPC component for forwarding Send operations from a local deployment to a remote deployment over gRPC and relaying Notify operations back to the local consumer.
-
NEW Added CommunicationsServiceTargetGRPC component for receiving Send operations from a remote deployment over gRPC, forwarding them to a local provider, and streaming Notify operations back to the remote initiator.
-
-
hgk updated from 5.0.0 to 5.1.0:
-
NEW Generated protobuf files now include unary RPCs for Send operations.
-
NEW Generated protobuf files now include server-streaming RPCs for Notify operations, with an additional workaround for send/notify behaviour on open bindings.
-
FIX Fixed ordering issues in generated Service Object copy methods by using ordered maps.
-
-
MIS updated from 3.0.0 to 3.1.0.
-
Documentation updated for 2026.5.0.
10. Groundkit 2026.4.0
Changes in this release:
-
GroundkitFoundation bundle changed from 6.0.0 to 7.0.0:
-
BREAKING / FIX The comms.io.net.tcp.SimpleTCPClient component no longer attempts to reconnect automatically. A TCP server must be running before starting a deployment using this component. This change also prevents excessive log output.
-
NEW Added BasicCommsDemo deployment type and BasicCommsMission for testing communications with the equivalent deployment in FlightkitFoundation.
-
-
gen-one-java infrastructure updated from 6.0.0 to 6.0.1:
-
Component initialisation order is now preserved to match the order declared in the deployment type.
-
-
hgk updated from 5.0.0 to 5.0.3:
-
Fixed circular issues in Service Object copy functionality.
-
Fixed Maven invoker stream handling.
-
FIX Components are now initialised in deployment declaration order.
-
FIX External bundle dependencies are now correctly included in deployment JARs.
-
-
Documentation updated for 2026.4.0.
11. Groundkit 2026.3.0
Changes in this release:
-
GroundkitFoundation bundle changed from 5.0.1 to 6.0.0:
-
BREAKING storage.fss.LocalFilestore has been ported from GroundCommon.
-
BREAKING Component type core.component.eds.EDSTarget has been renamed to core.component.eds.EDSReceiver.
-
-
gen-one-java infrastructure updated from 5.0.1 to 6.0.0:
-
BREAKING The ServiceProviderId field has been removed from ServiceProvisionPoint. These changes are handled by updated tooling.
-
-
hgk updated from 4.0.1 to 5.0.0:
-
Updated Groundkit CLI description output.
-
Distributed system enhancements allow a Service Provision declared in an initiator route to be connected to multiple targets.
-
BREAKING Added copy functionality to Service Objects, Service Object Reference Infos, and CustomTypes.
-
-
Documentation updated for 2026.3.0:
-
Added new tutorials “Using a Service” and “Unit Testing”.
-
12. Groundkit 2026.2.0
Changes in this release:
-
GroundkitFoundation bundle changed from 4.0.0 to 5.0.1:
-
gRPC and Protobuf dependencies are now included in the generated workspace Reactor POM. Existing workspace-pom.xml dependencies on these artefacts should be removed.
-
FIX Periodic task periods are now interpreted as seconds instead of milliseconds.
-
-
hgk updated from 3.0.0 to 4.0.1:
-
FIX Fixed serialisation issues for publish-subscribe services with identical arguments.
-
FIX Corrected ordering of generated local provider IDs in deployment types with component or assembly groups.
-
BREAKING Connection lifecycle handling is now driven by explicit connectionPhase configuration in componentType.xml.
-
BREAKING Groundkit bundle structure now includes prebuilt JARs, significantly improving build times.
-
BREAKING The internal representation of Service Objects has changed, impacting tooling only.
-
Generated workspace Reactor POMs now include required gRPC and Protobuf dependencies by default.
-
-
Documentation updated for 2026.2.0:
-
Hid out-of-date documentation.
-
Updated HelloWorld2 and HelloWorld3 tutorials based on user feedback.
-
13. Groundkit 2026.1.1
Changes in this release:
-
GroundkitFoundation bundle changed from 3.2.0 to 4.0.0:
-
FIX Changed BTSTargetGRPC message logging level from info to debug.
-
-
hgk updated from 2.5.0 to 3.0.0:
-
BREAKING Component instance initialisation data is now namespaced by full instance name.
-
BREAKING Removed the client module. All gRPC service proxies must be regenerated and the old client module removed from workspaces.
-
-
Documentation updated for 2026.1.1:
-
Added compatible Maven version information to the Getting Started guide.
-
Added HelloWorld3 tutorial.
-
14. Groundkit 2026.1.0
Changes in this release:
-
GroundkitFoundation bundle changed from 3.0.0 to 3.2.0:
-
NEW Introduced an improved SimpleTCPClient.
-
NEW Added gRPC-based Pub-Sub forwarding components for cdh.BTS, io.Connection, and communication.FileTransfer services.
-
-
hgk updated from 2.4.0 to 2.5.0:
-
Deployment JAR files and protobuf files are now copied to the output directory during mission builds.
-
Removed the deployment-type generate command.
-
Fixed serialisation issues with lists of unsigned integer types.
-
-
gen-one-java infrastructure updated from 3.0.0 to 4.0.0:
-
identifier.proto has been relocated to align with standard protobuf file layouts.
-
-
Documentation is now bundled with Groundkit releases:
-
Getting Started Guide
-
Tutorials (HelloWorld1 and HelloWorld2)
-
Workflow Guide
-