ogma-cli: Add new diagram command. Refs #194.

[ivanperez-keera]

Add new command to transform diagrams into Copilot monitors, as prescribed in the solution proposed for #194.

[ivanperez-keera]

Change Manager: For consistency, the CHANGELOG entry in ogma-core and the summary line in the only commit related to ogma-core should match.

[ivanperez-keera]

Implementor: Fix implemented, review requested.

[ivanperez-keera]

Change Manager: Verified that:

• Solution is implemented:
  • The code proposed compiles and passes all tests. Details:
    • Build logs:
      • https://github.com/nasa/ogma/actions/runs/12735876923/job/35495134470?pr=195
      • https://github.com/nasa/ogma/actions/runs/12735876918/job/35495134484?pr=195
    • Build log archives:
      • logs_32963891407.zip
      • logs_32963891397.zip
  • The solution proposed produces the expected result. Details:
    The following Dockerfile uses the new command to transform 6 diagrams with different formats and different property formats into monitors, and checks that the resulting Copilot code compiles correctly, after which it prints the message "Success":

    FROM ubuntu:trusty
    
    RUN apt-get update
    
    RUN apt-get install --yes software-properties-common
    RUN add-apt-repository ppa:hvr/ghc
    RUN apt-get update
    
    RUN apt-get install --yes ghc-8.6.5 cabal-install-2.4
    RUN apt-get install --yes libz-dev
    
    ENV PATH=/opt/ghc/8.6.5/bin:/opt/cabal/2.4/bin:$PWD/.cabal-sandbox/bin:$PATH
    
    RUN cabal update
    RUN cabal v1-sandbox init
    RUN cabal v1-install alex happy --constraint='happy < 2.0'
    RUN apt-get install --yes git
    
    CMD git clone $REPO && \
        cd $NAME && \
        git checkout $COMMIT && \
        cd .. && \
        cabal v1-install copilot-4.2 $NAME/$PAT**/ --enable-tests && \
        ogma diagram --target-dir graphviz-smv-monitor     --file-name $NAME/ogma-cli/examples/diagram-smv.dot     -f dot --prop-format smv \
        ogma diagram --target-dir graphviz-copilot-monitor --file-name $NAME/ogma-cli/examples/diagram-copilot.dot -f dot --prop-format literal \
        ogma diagram --target-dir graphviz-inputs-monitor  --file-name $NAME/ogma-cli/examples/diagram-inputs.dot  -f dot --prop-format inputs \
        ogma diagram --target-dir mermaid-smv-monitor      --file-name $NAME/ogma-cli/examples/mermaid-smv.txt     -f mermaid --prop-format smv \
        ogma diagram --target-dir mermaid-copilot-monitor  --file-name $NAME/ogma-cli/examples/mermaid-copilot.txt -f mermaid --prop-format literal \
        ogma diagram --target-dir mermaid-inputs-monitor   --file-name $NAME/ogma-cli/examples/mermaid-inputs.txt  -f mermaid --prop-format inputs \
        cabal v1-exec -- runhaskell graphviz-smv-monitor/Copilot.hs && \
        cabal v1-exec -- runhaskell graphviz-copilot-monitor/Copilot.hs && \
        cabal v1-exec -- runhaskell graphviz-inputs-monitor/Copilot.hs && \
        cabal v1-exec -- runhaskell mermaid-smv-monitor/Copilot.hs && \
        cabal v1-exec -- runhaskell mermaid-copilot-monitor/Copilot.hs && \
        cabal v1-exec -- runhaskell mermaid-inputs-monitor/Copilot.hs && \
        echo "Success"

    Command (substitute variables based on new path after merge):

    $ docker run -e "REPO=https://github.com/ivanperez-keera/ogma" -e "NAME=ogma" -e "PAT=ogma"  -e "COMMIT=923b173f936be45b9f3fb14ed8a70ce75cda9272" -it ogma-verify-194
    

• Implementation is documented. Details:
  All new modules and top-level definitions include documentation. The README and cabal file for ogma-cli are updated to document the new functionality.
• Change history is clear.
• Commit messages are clear.
• Changelogs are updated.
• Examples are updated. Details:
  New examples are introduced to demonstrate new capabilities.
• Required version bumps are evaluated. Details:
  Bump not required (API is backwards compatible and dependencies are extended).