esa
diff --git a/‎.github/workflows/generate-docs.yml‎
Lines changed: 62 additions & 0 deletions b/‎.github/workflows/generate-docs.yml‎
Lines changed: 62 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 4 additions & 4 deletions b/‎README.md‎
Lines changed: 4 additions & 4 deletions
diff --git a/‎RELEASE_NOTES.md‎
Lines changed: 13 additions & 0 deletions b/‎RELEASE_NOTES.md‎
Lines changed: 13 additions & 0 deletions
diff --git a/‎api-generator/api-generator-maven-plugin/pom.xml‎
Lines changed: 2 additions & 2 deletions b/‎api-generator/api-generator-maven-plugin/pom.xml‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎api-generator/api-generator-maven-plugin/src/main/java/esa/mo/tools/stubgen/StubGenerator.java‎
Lines changed: 12 additions & 30 deletions b/‎api-generator/api-generator-maven-plugin/src/main/java/esa/mo/tools/stubgen/StubGenerator.java‎
Lines changed: 12 additions & 30 deletions
diff --git a/‎api-generator/generator-docs/pom.xml‎
Lines changed: 2 additions & 2 deletions b/‎api-generator/generator-docs/pom.xml‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎api-generator/generator-docs/src/main/java/esa/mo/tools/stubgen/GeneratorDocument.java‎
Lines changed: 2 additions & 2 deletions b/‎api-generator/generator-docs/src/main/java/esa/mo/tools/stubgen/GeneratorDocument.java‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎api-generator/generator-docs/src/main/java/esa/mo/tools/stubgen/GeneratorDocx.java‎
Lines changed: 14 additions & 14 deletions b/‎api-generator/generator-docs/src/main/java/esa/mo/tools/stubgen/GeneratorDocx.java‎
Lines changed: 14 additions & 14 deletions
@@ -0,0 +1,62 @@
+name: Generate MO XML Docs
+
+on: [push]
+
+permissions:
+  contents: read
+
+jobs:
+  generate-docx:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Get Date
+        id: get-date
+        run: echo "date=$(/bin/date -u "+%Y-%m-%dT%H-%M-%S")" >> $GITHUB_OUTPUT
+
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '11'
+          distribution: 'temurin'
+
+      - name: Cache Maven local repository
+        uses: actions/cache@v4
+        with:
+          path: ~/.m2/repository
+          key: ${{ runner.os }}-maven-docgen-${{ steps.get-date.outputs.date }}
+          restore-keys: |
+            ${{ runner.os }}-maven-docgen-
+
+      - name: Build mo-navigator (and dependencies only)
+        run: mvn --batch-mode install -DskipTests -pl tooling/mo-navigator --also-make
+
+      - name: Generate DOCX files for XML prototypes
+        run: |
+          mkdir -p docx-output/prototypes
+          java -cp tooling/mo-navigator/target/mo-navigator-jar-with-dependencies.jar \
+            esa.mo.navigator.AppGenerateDocx \
+            xml-service-specifications/xml-ccsds-mo-prototypes/src/main/resources/xml \
+            docx-output/prototypes
+
+      - name: Generate DOCX files for XML standards
+        run: |
+          mkdir -p docx-output/standards
+          java -cp tooling/mo-navigator/target/mo-navigator-jar-with-dependencies.jar \
+            esa.mo.navigator.AppGenerateDocx \
+            xml-service-specifications/xml-ccsds-mo-standards/src/main/resources/xml \
+            docx-output/standards
+
+      - name: Upload DOCX artifacts for XML prototypes
+        uses: actions/upload-artifact@v4
+        with:
+          name: mo-prototypes-docx-${{ steps.get-date.outputs.date }}
+          path: docx-output/prototypes/
+          if-no-files-found: error
+
+      - name: Upload DOCX artifacts for XML standards
+        uses: actions/upload-artifact@v4
+        with:
+          name: mo-standards-docx-${{ steps.get-date.outputs.date }}
+          path: docx-output/standards/
+          if-no-files-found: error
@@ -1,13 +1,13 @@
 <p align="left">
-  <a href="https://github.com/esa/mo-services-java">
-      <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/a/af/ESA_logo.png/800px-ESA_logo.png" alt="esa logo" title="esa" width="400"/>
+  <a href="https://www.esa.int/">
+      <img src="docs/esa_logo.svg" alt="esa logo" title="esa" width="300"/>
   </a>
 </p>
 
 CCSDS MO services - ESA's Java implementation
 ========================
 
-[![Maven Central](https://maven-badges.herokuapp.com/maven-central/int.esa.ccsds.mo/mo-services-java/badge.svg)](https://maven-badges.herokuapp.com/maven-central/int.esa.ccsds.mo/mo-services-java)
+[![Maven Central](https://img.shields.io/maven-central/v/int.esa.ccsds.mo/parent)](https://central.sonatype.com/artifact/int.esa.ccsds.mo/parent)
 
 CCSDS Mission Operations (MO) services are a set of standard end-to-end services based on a service-oriented architecture defined by the Consultative Committee for Space Data Systems (CCSDS) and it is intended to be used for mission operations of future space missions.
 
@@ -99,7 +99,7 @@ Bug Reports are directly in the source code repository can be submitted on: [Iss
 
 The CCSDS MO services are **licensed** under: **[European Space Agency Public License (ESA-PL) Weak Copyleft - v2.0]**
 
-[ESAImage]: https://upload.wikimedia.org/wikipedia/commons/a/af/ESA_logo.png
+[ESAImage]: http://www.esa.int/esalogo/images/logotype/img_colorlogo_darkblue.gif
 [European Space Agency Public License (ESA-PL) Weak Copyleft - v2.0]: LICENCE.md
 [GitHub]: https://github.com/esa/mo-services-java
 [Release Notes]: RELEASE_NOTES.md
 
@@ -4,6 +4,19 @@ ESA CCSDS MO services - Release Notes
 These Release Notes include a short summary of the updates done for each version.
 The different versions and respective updates are the following:
 
+### Version 14.0
+* Removes the setters from the auto-generated classes
+* Removes deprecated methods
+* Adds the partial Monitor & Control service implementations (Action, Alert, and Packet) and respective testbed
+* Adds feature to allow Enumeration types to be used as PUB-SUB subscription keys
+* Adds typed Subscription Key accessors for PUB-SUB on the consumer side
+* Surfaces the MO exceptions directly on the provider Handler interfaces
+* Carries the operation and field comments into the runtime metadata (enables MCP servers to be easily plugged in)
+* Multiple improvements and cleanup to the api-generator
+* Adds a GitHub workflow to generate the .docx files from the XML service specifications
+* Fixes the PUB-SUB broker bug that dropped subscriptions on a partial deregister
+* Updates the MPS spec with the final version from 26/08/2025
+
 ### Version 12.3 (27 August 2025)
 * Updates the MPS spec with the final version from 26/08/2025
 
 
@@ -19,12 +19,12 @@
     <parent>
         <groupId>int.esa.ccsds.mo</groupId>
         <artifactId>parent</artifactId>
-        <version>12.3</version>
+        <version>14.0</version>
         <relativePath>../../parent/pom.xml</relativePath>
     </parent>
 
     <artifactId>api-generator-maven-plugin</artifactId>
-    <version>12.3</version>
+    <version>14.0</version>
     <packaging>maven-plugin</packaging>
 
     <name>ESA MO API Generator - Maven Plugin</name>
 
@@ -41,6 +41,7 @@
 import org.apache.maven.plugin.logging.SystemStreamLog;
 import org.apache.maven.plugins.annotations.LifecyclePhase;
 import org.apache.maven.plugins.annotations.Mojo;
+import org.apache.maven.plugins.annotations.Parameter;
 import org.reflections.Reflections;
 import org.reflections.scanners.SubTypesScanner;
 import org.reflections.util.ClasspathHelper;
@@ -49,79 +50,60 @@
 
 /**
  * Generates stubs and skeletons for CCSDS MO Service specifications.
- *
- * @goal generate
- *
- * @phase generate-sources
  */
-@Mojo(name = "generate-apis", defaultPhase = LifecyclePhase.GENERATE_SOURCES, threadSafe = true)
+@Mojo(name = "generate", defaultPhase = LifecyclePhase.GENERATE_SOURCES, threadSafe = true)
 public class StubGenerator extends AbstractMojo {
 
     /**
      * The directory for XML files
-     *
-     * @parameter default-value="${basedir}/src/main/xml"
-     * @required
      */
+    @Parameter(defaultValue = "${basedir}/src/main/xml", required = true)
     protected File xmlDirectory;
     /**
      * The directory for XML reference files
-     *
-     * @parameter default-value="${basedir}/src/main/xml-ref"
-     * @required
      */
+    @Parameter(defaultValue = "${basedir}/src/main/xml-ref", required = true)
     protected File xmlRefDirectory;
     /**
      * The directory for XSD type reference files
-     *
-     * @parameter default-value="${basedir}/src/main/xsd-ref"
-     * @required
      */
+    @Parameter(defaultValue = "${basedir}/src/main/xsd-ref", required = true)
     protected File xsdRefDirectory;
     /**
      * The working directory to create the generated java source files.
-     *
-     * @parameter
-     * default-value="${project.build.directory}/generated-sources/stub"
-     * @required
      */
+    @Parameter(defaultValue = "${project.build.directory}/generated-sources/stub", required = true)
     protected File outputDirectory;
     /**
      * The target language to create.
-     *
-     * @parameter
      */
+    @Parameter
     protected String[] targetLanguages;
     /**
      * Generate structures code?
-     *
-     * @parameter default-value="true"
      */
+    @Parameter(defaultValue = "true")
     protected boolean generateStructures;
     /**
      * Generate COM code?
-     *
-     * @parameter default-value="true"
      */
+    @Parameter(defaultValue = "true")
     protected boolean generateCOM;
     /**
      * Force generation
-     *
-     * @parameter default-value="false"
      */
+    @Parameter(defaultValue = "false")
     protected boolean forceGeneration;
     /**
      * Extra generator specific properties, held in name/value pairs
-     *
-     * @parameter
      */
+    @Parameter
     protected HashMap<String, String> extraProperties;
     /**
      * Package bindings, held in AREA/package pairs For JAXB bindings, held in
      * URI/package pairs
-     *
-     * @parameter
      */
+    @Parameter
     protected HashMap<String, String> packageBindings;
     private final Map<String, Generator> GENERATOR_MAP = new HashMap<>();
     private boolean generatorsLoaded = false;
 
@@ -19,12 +19,12 @@
     <parent>
         <groupId>int.esa.ccsds.mo</groupId>
         <artifactId>parent</artifactId>
-        <version>12.3</version>
+        <version>14.0</version>
         <relativePath>../../parent/pom.xml</relativePath>
     </parent>
 
     <artifactId>generator-docs</artifactId>
-    <version>12.3</version>
+    <version>14.0</version>
     <packaging>jar</packaging>
 
     <name>ESA MO API Generator - Documentation</name>
 
@@ -65,8 +65,8 @@ protected GeneratorDocument(GeneratorConfiguration config) {
     public CompositeField createCompositeElementsDetails(TargetWriter file,
             boolean checkType, String fieldName, TypeReference elementType,
             boolean isStructure, boolean canBeNull, String comment) {
-        if (isAttributeType(elementType)) {
-            AttributeTypeDetails details = getAttributeDetails(elementType);
+        if (typeInformation.isAttributeType(elementType)) {
+            AttributeTypeDetails details = typeInformation.getAttributeDetails(elementType);
             return new CompositeField(details.getTargetType(), elementType,
                     fieldName, elementType.isList(), canBeNull, false,
                     StdStrings.MAL, "", "", false, "", comment);
 
@@ -55,7 +55,7 @@ public class GeneratorDocx extends GeneratorDocument {
         2250, 2801, 1382, 1185, 1382
     };
     private static final int[] SERVICE_COM_TYPES_TABLE_WIDTHS = new int[]{
-        2250, 1685, 2801, 1185, 1185
+        1010, 2250, 2500, 1150, 2196
     };
     private static final int[] OPERATION_OVERVIEW_TABLE_WIDTHS = new int[]{
         2200, 1700, 800, 4300
@@ -433,19 +433,19 @@ private void drawCOMUsageTables(DocxWriter docxFile, AreaType area, ExtendedServ
                     docxFile.startTable(SERVICE_COM_TYPES_TABLE_WIDTHS, service.getName() + " Service Object Types");
 
                     docxFile.startRow();
-                    docxFile.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Name", HEADER_COLOUR);
-                    docxFile.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Number", HEADER_COLOUR);
+                    docxFile.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Number", HEADER_COLOUR);
+                    docxFile.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Name", HEADER_COLOUR);
                     docxFile.addCell(2, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Body Type", HEADER_COLOUR);
-                    docxFile.addCell(3, SERVICE_COM_TYPES_TABLE_WIDTHS, "Related points to", HEADER_COLOUR);
-                    docxFile.addCell(4, SERVICE_COM_TYPES_TABLE_WIDTHS, "Source points to", HEADER_COLOUR);
+                    docxFile.addCell(3, SERVICE_COM_TYPES_TABLE_WIDTHS, "Related link", HEADER_COLOUR);
+                    docxFile.addCell(4, SERVICE_COM_TYPES_TABLE_WIDTHS, "Source link", HEADER_COLOUR);
                     docxFile.endRow();
 
                     List<String> cmts = new LinkedList<>();
 
                     for (ModelObjectType obj : features.getObjects().getObject()) {
                         docxFile.startRow();
-                        docxFile.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, obj.getName());
-                        docxFile.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, String.valueOf(obj.getNumber()));
+                        docxFile.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, String.valueOf(obj.getNumber()));
+                        docxFile.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, obj.getName());
 
                         if (null != obj.getObjectType() && (null != obj.getObjectType().getAny())) {
                             docxFile.addCell(2, SERVICE_COM_TYPES_TABLE_WIDTHS,
@@ -504,17 +504,17 @@ private void drawCOMUsageTables(DocxWriter docxFile, AreaType area, ExtendedServ
                 evntTable.startTable(SERVICE_COM_TYPES_TABLE_WIDTHS, service.getName() + " Service Events");
 
                 evntTable.startRow();
-                evntTable.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, "Event Name", HEADER_COLOUR);
-                evntTable.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Number", HEADER_COLOUR);
+                evntTable.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Number", HEADER_COLOUR);
+                evntTable.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, "Event Name", HEADER_COLOUR);
                 evntTable.addCell(2, SERVICE_COM_TYPES_TABLE_WIDTHS, "Object Body Type", HEADER_COLOUR);
-                evntTable.addCell(3, SERVICE_COM_TYPES_TABLE_WIDTHS, "Related points to", HEADER_COLOUR);
-                evntTable.addCell(4, SERVICE_COM_TYPES_TABLE_WIDTHS, "Source points to", HEADER_COLOUR);
+                evntTable.addCell(3, SERVICE_COM_TYPES_TABLE_WIDTHS, "Related link", HEADER_COLOUR);
+                evntTable.addCell(4, SERVICE_COM_TYPES_TABLE_WIDTHS, "Source link", HEADER_COLOUR);
                 evntTable.endRow();
 
                 for (ModelObjectType evnt : features.getEvents().getEvent()) {
                     evntTable.startRow();
-                    evntTable.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, evnt.getName(), STD_COLOUR);
-                    evntTable.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, String.valueOf(evnt.getNumber()), STD_COLOUR);
+                    evntTable.addCell(0, SERVICE_COM_TYPES_TABLE_WIDTHS, String.valueOf(evnt.getNumber()), STD_COLOUR);
+                    evntTable.addCell(1, SERVICE_COM_TYPES_TABLE_WIDTHS, evnt.getName(), STD_COLOUR);
 
                     if (null != evnt.getObjectType()) {
                         evntTable.addCell(2, SERVICE_COM_TYPES_TABLE_WIDTHS,
@@ -880,7 +880,7 @@ public int compare(String o1, String o2) {
                 String errorNumber = "UNKNOWN ERROR NUMBER!";
                 String es;
                 if ((err.getType().getArea() == null) || (err.getType().getArea().equals(area.getName()))) {
-                    ErrorDefinitionType edt = getErrorDefinition(err.getType().getName());
+                    ErrorDefinitionType edt = typeInformation.getErrorDefinition(err.getType().getName());
                     if (edt != null) {
                         errorNumber = String.valueOf(edt.getNumber());
                     }