Initial Release Plan

[Phovos]

This is the initial release of "MSC": 'Morphological Source Code', 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.

source: #1

Requirements:

• Idempotent
• (Self-aware)Semantic versioned
• Best practices
• CICD (limited)

Features:

• No ByteWords, yet
• Server
• Module, function, first class 'object' PyObj
• Functional + Compositional primitives (map, cat)
• 'conjugation'(syntax)-helper for necessary Reverse Polish Notation of cognitive lambda calculus

---

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}')