chore: align repo structure and practices with Audify blueprint

arpannookala-12 · arpannookala-12 · commit a88fc01593dd · 2026-03-05T13:54:50.000-06:00
- Add .github/workflows/code-scans.yaml (Trivy + Bandit SDLE scans)
- Add CONTRIBUTING, DISCLAIMER, LICENSE, TERMS_AND_CONDITIONS docs
- Add docs/assets company header image
- Extend .gitignore with testing artifacts, Audify local dir, and pytest/coverage entries
diff --git a/.github/workflows/code-scans.yaml b/.github/workflows/code-scans.yaml
@@ -0,0 +1,104 @@
+name: SDLE Scans
+
+on:
+  workflow_dispatch:
+    inputs:
+      PR_number:
+        description: 'Pull request number'
+        required: true
+  push:
+    branches: [ main ]
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+concurrency:
+  group: sdle-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+
+# -----------------------------
+# 1) Trivy Scan
+# -----------------------------
+  trivy_scan:
+    name: Trivy Vulnerability Scan
+    runs-on: ubuntu-latest
+    env:
+      TRIVY_REPORT_FORMAT: table
+      TRIVY_SCAN_TYPE: fs
+      TRIVY_SCAN_PATH: .
+      TRIVY_EXIT_CODE: '1'
+      TRIVY_VULN_TYPE: os,library
+      TRIVY_SEVERITY: CRITICAL,HIGH
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create report directory
+        run: mkdir -p trivy-reports
+
+      - name: Run Trivy FS Scan
+        uses: aquasecurity/trivy-action@0.24.0
+        with:
+          scan-type: 'fs'
+          scan-ref: '.'
+          scanners: 'vuln,misconfig,secret,license'
+          ignore-unfixed: true
+          format: 'table'
+          exit-code: '1'
+          output: 'trivy-reports/trivy_scan_report.txt'
+          vuln-type: 'os,library'
+          severity: 'CRITICAL,HIGH'
+
+      - name: Upload Trivy Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: trivy-report
+          path: trivy-reports/trivy_scan_report.txt
+
+      - name: Show Trivy Report in Logs
+        if: failure()
+        run: |
+          echo "========= TRIVY FINDINGS ========="
+          cat trivy-reports/trivy_scan_report.txt
+          echo "================================="
+
+# -----------------------------
+# 2) Bandit Scan
+# -----------------------------
+  bandit_scan:
+    name: Bandit security scan
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: 'recursive'
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Install Bandit
+        run: pip install bandit
+
+      - name: Create Bandit configuration
+        shell: bash
+        run: |
+          cat > .bandit << 'EOF'
+          [bandit]
+          exclude_dirs = tests,test,venv,.venv,node_modules
+          skips = B101
+          EOF
+
+      - name: Run Bandit scan
+        run: |
+          bandit -r . -ll -iii -f screen
+          bandit -r . -ll -iii -f html -o bandit-report.html
+
+      - name: Upload Bandit Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: bandit-report
+          path: bandit-report.html
+          retention-days: 30
diff --git a/.gitignore b/.gitignore
@@ -63,10 +63,20 @@ temp/
 # Python type checker cache
 .mypy_cache/
 
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.cache/
+
 # Security scan outputs
 bandit-*.html
 bandit-*.txt
 
+# Local project references (not part of this repo)
+Audify/
+
 # Langfuse observability stack (local testing only, never commit)
 langfuse/
 api/services/observability.py
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,27 @@
+# Contributing to CodeTrans
+
+Thank you for your interest in contributing to **CodeTrans — AI-Powered Code Translation** by Cloud2 Labs.
+
+## Scope of Contributions
+
+Appropriate contributions include:
+
+- Documentation improvements
+- Bug fixes
+- Reference architecture enhancements
+- Additional LLM provider configurations
+- Educational clarity and examples
+
+Major feature additions or architectural changes (e.g., new inference backends,
+new supported languages, UI framework changes) require prior discussion with the
+Cloud2 Labs maintainers.
+
+## Contribution Guidelines
+
+- Follow existing coding and documentation standards
+- Avoid production-specific assumptions
+- Do not introduce sensitive, proprietary, or regulated data into examples or tests
+- Ensure any new environment variables are documented in `.env.example` and the README
+
+By submitting a contribution, you agree that your work may be used, modified,
+and redistributed by Cloud2 Labs under the terms of the project license.
diff --git a/DISCLAIMER.md b/DISCLAIMER.md
@@ -0,0 +1,21 @@
+# Disclaimer
+
+This blueprint is provided by Cloud2 Labs "as is" and "as available" for
+educational and demonstration purposes only.
+
+The **CodeTrans — AI-Powered Code Translation** blueprint is a reference
+implementation and does not constitute a production-ready system or
+regulatory-compliant solution.
+
+This software is not designed to provide professional software engineering,
+legal, or compliance advice. All code translations generated by this blueprint
+require independent human review and validation before use in any production
+system.
+
+Cloud2 Labs does not assume responsibility or liability for any data loss,
+security incident, service disruption, regulatory non-compliance, or adverse
+outcome resulting from the use or modification of this blueprint.
+
+Do not submit confidential, proprietary, or sensitive source code to third-party
+inference API providers (OpenAI, Groq, OpenRouter, etc.) without first reviewing
+their data handling, privacy, and retention policies.
diff --git a/LICENSE.md b/LICENSE.md
@@ -0,0 +1,21 @@
+MIT License
+
+© 2026 cld2labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/TERMS_AND_CONDITIONS.md b/TERMS_AND_CONDITIONS.md
@@ -0,0 +1,17 @@
+# Terms and Conditions
+
+This repository contains the **CodeTrans — AI-Powered Code Translation** blueprint
+maintained by Cloud2 Labs.
+
+By accessing or using this blueprint, you acknowledge and agree that:
+
+- This blueprint is provided solely for educational and demonstration purposes
+- You are solely responsible for deployment, configuration, and usage
+- You are responsible for all data handling, security controls, and compliance
+- You are responsible for reviewing the data handling and privacy policies of any
+  third-party inference API provider (OpenAI, Groq, OpenRouter, etc.) before
+  submitting code to their endpoints
+- Cloud2 Labs provides no warranties or guarantees of any kind
+
+Cloud2 Labs does not support or recommend production deployment of this blueprint
+without a thorough security review and appropriate hardening.
diff --git a/docs/assets/InnovationHub-HeaderImage.png b/docs/assets/InnovationHub-HeaderImage.png
