Stable release (v1.0)

Version 1.0 marks the stable release of C5-DEC. See CHANGELOG for details.

Author: CryptographySandbox

.devcontainer/devcontainer.json

@@ -1,7 +1,10 @@
 // For format details, see https://aka.ms/devcontainer.json. For config options, see the
 // README at: https://github.com/devcontainers/templates/tree/main/src/docker-existing-dockerfile
 {
-	"name": "Existing Dockerfile",
+	"name": "C5-DEC CAD dev container",
+	// Use 'dockerFile' if you want to build an image from a Dockerfile.
+	// Use 'image' if you want to use an existing image from Docker Hub or a local image, e.g., the commented line for OpenSSL with oqs provider for PQC.
+	// Use 'dockerComposeFile' and 'service' if you want to use a service from a docker-compose.yml file.
 	"build": {
 		// Sets the run context to one level up instead of the .devcontainer folder.
 		"context": "..",
@@ -22,8 +25,13 @@
 	"customizations": {
 		"vscode": {
             "extensions": [
-                "ms-python.python"
-            ],
+				"ms-python.python",
+				"streetsidesoftware.code-spell-checker",
+				"quarto.quarto",
+				"ms-toolsai.jupyter",
+				"ms-toolsai.datawrangler",
+				"ms-azuretools.vscode-docker"
+			],
             "settings": {
                 "python.testing.pytestArgs": [
                     "."

.devcontainer/pqc-openssl/devcontainer.json

@@ -0,0 +1,43 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/docker-existing-dockerfile
+{
+	"name": "C5-DEC cryptography dev container",
+	"image": "openquantumsafe/oqs-ossl3:latest",
+	// Use 'dockerFile' if you want to build an image from a Dockerfile.
+	// Use 'image' if you want to use an existing image from Docker Hub or a local image, e.g., the commented line for OpenSSL with oqs provider for PQC.
+	// Use 'dockerComposeFile' and 'service' if you want to use a service from a docker-compose.yml file.
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Uncomment the next line to run commands after the container is created.
+	// "postCreateCommand": "cat /etc/os-release",
+
+	// Configure tool-specific properties.
+	"customizations": {
+		"vscode": {
+            "extensions": [
+				"ms-python.python",
+				"streetsidesoftware.code-spell-checker",
+				"quarto.quarto"
+			],
+            "settings": {
+                "python.testing.pytestArgs": [
+                    "."
+                ],
+                "python.testing.unittestEnabled": false,
+                "python.testing.pytestEnabled": true,
+                "python.formatting.provider": "black"
+            }
+        }
+	},
+
+	"workspaceMount": "source=${localWorkspaceFolder},target=/home/alab/c5dec,type=bind",
+	"workspaceFolder": "/home/alab/c5dec"
+
+	// Uncomment to connect as an existing user other than the container default. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "devcontainer"
+}

CHANGELOG.md

@@ -1,3 +1,46 @@
+# 1.0 (2025-05-07)
+
+Version 1.0 marks the stable release of C5-DEC.
+
+## Added
+
+- C5-DEC new project creation feature and command added to the CLI: `c5dec.sh new`
+- C5-DEC DocEngine enhancement: new templates, automation scripts, LaTeX enhancements
+- ETR evaluation spreadsheet formulas for automatic work unit verdict computation from atomic work item
+- LaTeX commands for dynamic and color-coded ETR verdict encoding: pass, fail, inconclusive
+- ETR evaluation overview templates, spreadsheets and compilation into Markdown for DocEngine
+- Doorstop source processing code for C5-DEC keyword handling in test reports
+- CPSSA, Cryptography, and Transformer commands to the CLI
+- Cryptographic software to the containerized `C5-DEC cryptography dev container`: Kryptor, Cryptomator CLI
+- Fully containerized DocEngine and dependencies within the `C5-DEC CAD dev container`
+- OQS-OpenSSL provider container to `.devcontainer` and allow selection between C5-DEC containers
+- Abstract to DocEngine report template cover pages
+- Interactive session mode with the C5-DEC container accessed via `c5dec.sh session`
+- Interactive session mode with the OQS-OpenSSL container for PQC accessed via `c5dec.sh pqc`
+- Publish function isolation in `docs/specs`
+- C5-DEC project template with placeholders used as input by the CLI `new` command
+- Validation test cases (`TSS`) and test report (`TRS`) for the stable release
+
+## Fixed
+
+- Header and footer logo placement offset bugs in DocEngine report compilation
+
+## Modified
+
+- DocEngine default report and ETR layouts for the cover page
+- DocEngine for ETR part generation to improve work unit and atomic work item compilation
+- `_quarto.yml` files for both DocEngine report and ETR templates
+- CLI command descriptions and help instructions
+- User manual pages for Cryptography, CPSSA, SSDLC and Transformer
+- Runner `c5dec.sh` implementation to provide new modes: `help`, `session`, `pqc`, `c5dec <command>`
+- Build script `build-c5dec.sh` to also build the dev container for access via `c5dec.sh session`
+- VS Code dev container configuration to include new extensions: Code Spell Checker, Quarto, Jupyter and Data Wrangler
+
+## Removed
+
+- All CLI commands for SSDLC (all have been integrated into the `new` CLI command)
+- TUI menus of features migrated to the CLI: SSDLC, CPSSA, Cryptography, Transformer
+
 # 0.3.1 (2024-09-16)
 
 ## Added

Dockerfile

@@ -11,10 +11,10 @@ ENV MY_ENV=${MY_ENV} \
   PIP_DEFAULT_TIMEOUT=100 \
   POETRY_VERSION=1.5.0
 
-ENV user=root
+ENV user=alab
 ENV c5folder=c5dec
 
-# Update and install depencencies
+# Update and install dependencies
 RUN apt update --fix-missing
 RUN apt-get install -y git python3-pip graphviz