initialRelease (discussion)

[Phovos]

"MSC" (Morphological Source Code by Phovos)::Release v0.0.11::

This is the initial release of "MSC", establishing the foundation for a persistent identity framework. This release focuses on setting up essential documentation, licensing, and compliance materials to ensure a robust starting point for future development.

This is the presumed and only release until the next is published. Only 'releases' (like this one) are fit to distribute, for various not necessarily important reasons; this is as opposed to 'branches' or 'builds', etc. [of MSC: Morphological Source Code]. Please feel free to follow-along in the development repository, even clone/fork/etc., but keep in-mind that Phovos (author) explicitly has a 'release'-structured delivery pipeline for continuous integration and iterative semantic-versioned development.

• This project follows Semantic Versioning (SemVer) for releases.
• Only tagged releases (like this one) are considered stable for distribution. Development branches may contain experimental potentially harmful changes.
• Expect periods of development activity between releases as I refine the project.

name: Release Pipeline

on:
  push:
    tags:
      - "v*"

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Validate SemVer
        run: |
          TAG=${{ github.ref_name }}
          if [[ ! $TAG =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.-]+)?(\+[a-zA-Z0-9.-]+)?$ ]]; then
            echo "Error: Tag $TAG does not follow SemVer format"
            exit 1
          fi
      - name: Create Release
        uses: actions/create-release@v1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          tag_name: ${{ github.ref_name }}
          release_name: Release ${{ github.ref_name }}
          body_path: RELEASE_NOTES.md
          draft: false
          prerelease: false
      - name: Build Artifacts
        run: |
          zip -r docs.zip docs/
      - name: Upload Artifacts
        uses: actions/upload-release-asset@v1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          upload_url: ${{ steps.create-release.outputs.upload_url }}
          asset_path: docs.zip
          asset_name: docs.zip
          asset_content_type: application/zip

[Phovos]

github isn't recognizing CCBY4.0, I guess it does need that line of equals-signs.

https://semver.org/
https://creativecommons.org/licenses/by/4.0/legalcode.txt

[Phovos]

name: python-app

on:
  schedule:
    - cron: "0 0 * * *"
  workflow_dispatch:
  push:
    branches: ["main"]
  pull_request:
    branches: ["staging"]

jobs:
  build-and-validate:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Set up Python 3.13
        uses: actions/setup-python@v5
        with:
          python-version: "3.13"

      - name: Create log directories
        run: |
          mkdir -p logs
          touch logs/setup.log logs/python-app.log logs/app.log

      - name: Install system dependencies
        run: |
          sudo apt-get update
          sudo apt-get install -y jq curl chromium-chromedriver >> logs/setup.log 2>&1

      - name: Set up virtual environment
        run: |
          python -m venv venv
          source venv/bin/activate
          pip install --upgrade pip
          pip install selenium litellm setuptools wheel >> logs/setup.log 2>&1

      - name: Validate repository instances
        run: |
          chmod +x scripts/validate_repo.sh
          ./scripts/validate_repo.sh repo.json >> logs/python-app.log 2>&1

      - name: Evolve instances over time
        run: |
          chmod +x scripts/evolve_instances.sh
          ./scripts/evolve_instances.sh repo.json 3 >> logs/python-app.log 2>&1

      - name: Run Git snapshot
        run: |
          chmod +x scripts/git_snapshot.sh
          ./scripts/git_snapshot.sh >> logs/python-app.log 2>&1

      - name: Python bridge with app_bridge.py
        run: |
          chmod +x scripts/python_bridge.sh
          ./scripts/python_bridge.sh repo.json >> logs/python-app.log 2>&1

      - name: Orchestrate full Git flow
        run: |
          chmod +x scripts/git.sh
          ./scripts/git.sh repo.json >> logs/python-app.log 2>&1

      - name: Archive CI logs
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: ci-logs
          path: logs

name: Deploy static site to GitHub Pages

on:
  push:
    branches: ["main"]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Pages
        uses: actions/configure-pages@v5

      - name: Upload static site
        uses: actions/upload-pages-artifact@v3
        with:
          path: './public'

      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

[Phovos]

0.0.12 semantic versioning complete. Tomorrow I get workflow working to take that baton after provisioning.sh invokes the appBridge.py to obtain the semver; CICD+etc can then proceed.

(this is convoluted because I want pyproject.toml to be the source of truth for semver and it is, obstinately, a .toml.

a03bb31

[Phovos]

The story so-far:

#!/bin/bash
FILE=$1

echo "Initializing Python bridge..."

if [ -f "./scripts/appBridge.py" ] && [ -f "pyproject.toml" ]; then
  VERSION=$(python3 ./scripts/appBridge.py)
  echo "Detected version: $VERSION"
else
  echo "[WARN] pyproject.toml or appBridge.py not found. Skipping version extraction."
fi

echo "[PYTHON] Sending version $version to Python"

# Assuming the version is sent as a JSON object
echo "{\"version\": \"$version\"}" | python3 -u main.py

import tomllib
import sys
import os

# there is one source of truth; the pyproject.toml, so we use a python script @ build.
msc = {}


def extract_version(file_path):
    try:
        with open(file_path, "rb") as f:
            pyproject = tomllib.load(f)
        version = pyproject["project"]["version"]
        msc = pyproject.get("tool", {}).get("msc", {})
        print(f"Additional MSC configs: {msc}")
        print(version)
    except FileNotFoundError:
        print(
            f"[WARN] {file_path} not found. Skipping version extraction.",
            file=sys.stderr,
        )
        sys.exit(0)
    except KeyError as e:
        print(f"[WARN] Missing key in {file_path}: {e}", file=sys.stderr)
        sys.exit(0)


if __name__ == "__main__":
    if len(sys.argv) == 2:
        file_path = sys.argv[1]
    else:
        file_path = os.path.join(os.path.dirname(__file__), "..", "pyproject.toml")
    extract_version(file_path)

// ...
  "onCreateCommand": "if [ \"$CODESPACES\" = \"true\" ]; then echo 'In Codespaces: Running minimal setup'; else bash .devcontainer/provisioning.sh; fi || true",
  "postCreateCommand": "uv venv .venv && uv pip install -U jupyterlab nox",
  "postStartCommand": "bash .devcontainer/provisioning.sh",
  "forwardPorts": [8000, 8888, 8341],
  "runArgs": ["--network=host"],
  "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces/${localWorkspaceFolderBasename},type=bind",
  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
  "remoteUser": "vscode"
}

# Initialize uv
export UV_ROOT="$HOME/.uv"
[ -f "$UV_ROOT/uv.sh" ] && source "$UV_ROOT/uv.sh"

# Auto-activate or create uv venv
if [ -f ".venv/bin/activate" ]; then
  uv use .venv >/dev/null 2>&1
elif [ -d "$HOME/workspaces/${PWD##*/}/.venv" ]; then
  uv venv .venv >/dev/null 2>&1
  uv use .venv >/dev/null 2>&1
fi

if __name__ == "__main__":
    import argparse
    import os
    import re
    def is_valid_semver(version: str) -> bool:
        # Accepts optional leading 'v', e.g. "v1.2.3" or "1.2.3"
        return re.match(r"^v?\d+\.\d+\.\d+$", version) is not None
    parser = argparse.ArgumentParser(description="Run MSC with specified version.")
    parser.add_argument(
        "--version",
        help="The semantic version to use (e.g. 0.0.12 or v0.0.12)",
        required=True,
    )
    args = parser.parse_args()
    version = args.version

    if version.startswith("v"):
        version = version[1:]

    if not is_valid_semver(version):
        print(f"Invalid semantic version format: {version}", file=sys.stderr)
        sys.exit(1)

    print(f"[INFO] Using version: {version}")

    log = LogAdapter(correlation_id=version)
    log.logger.debug("Debug level test; 'Hello world!'")
    log.logger.warning("Warning with CID and colors")
    log.logger.error("Error occurred in something")
    log.logger.critical("Critical issue reported")
    print(f'Find logs @ {log.broadcast_filename}')

[Phovos]

I already said:

TorusByteWord not in v0.0.12

But I spent hours today building it anyways because my arbitrary deadline is Friday that gives me 2 days to figure it out and a couple of hours, at the last possible minute, to package and release it.

[Phovos]

# For most projects, this workflow file will not need changing; you simply need
# to commit it to your repository.
#
# You may wish to alter this file to override the set of languages analyzed,
# or to provide custom queries or build logic.
#
# ******** NOTE ********
# We have attempted to detect the languages in your repository. Please check
# the `language` matrix defined below to confirm you have the correct set of
# supported CodeQL languages.
#
name: "CodeQL Advanced"

on:
  push:
    branches: [ "production" ]
  pull_request:
    branches: [ "production" ]
  schedule:
    - cron: '21 22 * * 3'

jobs:
  analyze:
    name: Analyze (${{ matrix.language }})
    # Runner size impacts CodeQL analysis time. To learn more, please see:
    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
    #   - https://gh.io/supported-runners-and-hardware-resources
    #   - https://gh.io/using-larger-runners (GitHub.com only)
    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
    permissions:
      # required for all workflows
      security-events: write

      # required to fetch internal or private CodeQL packs
      packages: read

      # only required for workflows in private repositories
      actions: read
      contents: read

    strategy:
      fail-fast: false
      matrix:
        include:
        - language: python
          build-mode: none
        # CodeQL supports the following values keywords for 'language': 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'swift'
        # Use `c-cpp` to analyze code written in C, C++ or both
        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
    steps:
    - name: Checkout repository
      uses: actions/checkout@v4

    # Initializes the CodeQL tools for scanning.
    - name: Initialize CodeQL
      uses: github/codeql-action/init@v3
      with:
        languages: ${{ matrix.language }}
        build-mode: ${{ matrix.build-mode }}
        # If you wish to specify custom queries, you can do so here or in a config file.
        # By default, queries listed here will override any specified in a config file.
        # Prefix the list here with "+" to use these queries and those in the config file.

        # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
        # queries: security-extended,security-and-quality

    # If the analyze step fails for one of the languages you are analyzing with
    # "We were unable to automatically build your code", modify the matrix above
    # to set the build mode to "manual" for that language. Then modify this step
    # to build your code.
    # ℹ️ Command-line programs to run using the OS shell.
    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
    - if: matrix.build-mode == 'manual'
      shell: bash
      run: |
        echo 'If you are using a "manual" build mode for one or more of the' \
          'languages you are analyzing, replace this with the commands to build' \
          'your code, for example:'
        echo '  make bootstrap'
        echo '  make release'
        exit 1

    - name: Perform CodeQL Analysis
      uses: github/codeql-action/analyze@v3
      with:
        category: "/language:${{matrix.language}}"

[Phovos]

https://github.com/Phovos/MSC/releases/tag/untagged-9c0233895828264f337e

[Phovos]

Per #11 [Issue #11]

Closing:

v0.0.13 'initial release' is dead, there's no-point in crystalizing practices which aren't coherent to the reflexive product. v0.0.20 is now the presumptive and truest 'initial release', all the foibles of semantic versioning and contemporary CICD withstanding.

[Phovos]

https://github.com/Phovos/MSC/releases/tag/0.0.13

Speaking of foibles, having never release 0.0.13 this probably doesn't make sense and should be changed to 0.0.20 .

https://github.com/Phovos/MSC/releases/tag/0.0.20

Mostly happy; just wish it differentiated itself as a non-functional archive.