Merge v0.1 into main

.devcontainer/base/Dockerfile

@@ -0,0 +1,20 @@
+FROM ubuntu:noble
+
+SHELL ["/bin/bash", "-c"]
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+      curl \
+      wget \
+      git \
+      openssh-client \
+      sudo \
+      just
+
+COPY .devcontainer/scripts/base-setup.sh /tmp/base-setup.sh
+RUN chmod +x /tmp/base-setup.sh \
+    && USERNAME="ubuntu" /tmp/base-setup.sh
+
+USER ubuntu
+WORKDIR /home/ubuntu/workspace

.devcontainer/base/devcontainer.json

@@ -0,0 +1,45 @@
+{
+  "name": "base",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": "../.."
+  },
+
+  "features": {
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {
+			"version": "latest",
+			"moby": false
+		}
+  },
+
+  "workspaceMount": "source=${localWorkspaceFolder},target=/home/ubuntu/workspace,type=bind",
+  "workspaceFolder": "/home/ubuntu/workspace",
+
+  "mounts": [
+    "type=bind,source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent"
+  ],
+
+  "remoteUser": "ubuntu",
+  "remoteEnv": {
+    "SSH_AUTH_SOCK": "/ssh-agent",
+    "GIT_CONFIG_GLOBAL": "/home/ubuntu/.gitconfig"
+  },
+
+  "overrideCommand": true,
+  "postCreateCommand": "/bin/bash .devcontainer/res/post_create_command.bash",
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "skellock.just",
+        "ms-python.python",
+        "ms-python.pylint",
+        "ms-python.autopep8",
+        "tamasfe.even-better-toml",
+        "VisualStudioExptTeam.vscodeintellicode",
+        "mhutchie.git-graph",
+        "eamodio.gitlens"
+      ]
+    }
+  }
+}

.devcontainer/context-retriever/Dockerfile

@@ -0,0 +1,21 @@
+FROM python:3.12
+
+SHELL ["/bin/bash", "-c"]
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+      curl wget git openssh-client sudo \
+      just gcc g++
+
+RUN groupadd -g 1000 appuser && useradd appuser -u 1000 -g 1000 -m -s /bin/bash
+RUN chown -R appuser:appuser /home/appuser/
+
+COPY .devcontainer/scripts/base-setup.sh /tmp/base-setup.sh
+RUN chmod +x /tmp/base-setup.sh \
+    && USERNAME="appuser" /tmp/base-setup.sh
+
+USER appuser
+WORKDIR /home/appuser/workspace
+
+RUN wget -qO- https://astral.sh/uv/install.sh | sh

.devcontainer/context-retriever/devcontainer.json

@@ -0,0 +1,35 @@
+{
+  "name": "context-retriever",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": "../.."
+  },
+  "workspaceMount": "source=${localWorkspaceFolder},target=/home/appuser/workspace,type=bind",
+  "workspaceFolder": "/home/appuser/workspace/services/context-retriever",
+  "mounts": [
+    "type=bind,source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent"
+  ],
+  "remoteUser": "appuser",
+  "remoteEnv": {
+    "SSH_AUTH_SOCK": "/ssh-agent",
+    "GIT_CONFIG_GLOBAL": "/home/appuser/.gitconfig"
+  },
+  "runArgs": [
+    "--network=host"
+  ],
+  "overrideCommand": true,
+  "postCreateCommand": "cd /home/appuser/workspace && /bin/bash .devcontainer/res/post_create_command.bash",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "skellock.just",
+        "ms-python.python",
+        "ms-python.pylint",
+        "ms-python.autopep8",
+        "tamasfe.even-better-toml",
+        "VisualStudioExptTeam.vscodeintellicode",
+        "matangover.mypy"
+      ]
+    }
+  }
+}

.devcontainer/llm-proxy/Dockerfile

@@ -0,0 +1,21 @@
+FROM python:3.12
+
+SHELL ["/bin/bash", "-c"]
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+      curl wget git openssh-client sudo \
+      just gcc g++
+
+RUN groupadd -g 1000 appuser && useradd appuser -u 1000 -g 1000 -m -s /bin/bash
+RUN chown -R appuser:appuser /home/appuser/
+
+COPY .devcontainer/scripts/base-setup.sh /tmp/base-setup.sh
+RUN chmod +x /tmp/base-setup.sh \
+    && USERNAME="appuser" /tmp/base-setup.sh
+
+USER appuser
+WORKDIR /home/appuser/workspace
+
+RUN wget -qO- https://astral.sh/uv/install.sh | sh

.devcontainer/llm-proxy/devcontainer.json

@@ -0,0 +1,35 @@
+{
+  "name": "llm-proxy",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": "../.."
+  },
+  "workspaceMount": "source=${localWorkspaceFolder},target=/home/appuser/workspace,type=bind",
+  "workspaceFolder": "/home/appuser/workspace/services/llm-proxy",
+  "mounts": [
+    "type=bind,source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent"
+  ],
+  "remoteUser": "appuser",
+  "remoteEnv": {
+    "SSH_AUTH_SOCK": "/ssh-agent",
+    "GIT_CONFIG_GLOBAL": "/home/appuser/.gitconfig"
+  },
+  "runArgs": [
+    "--network=host"
+  ],
+  "overrideCommand": true,
+  "postCreateCommand": "cd /home/appuser/workspace && /bin/bash .devcontainer/res/post_create_command.bash",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "skellock.just",
+        "ms-python.python",
+        "ms-python.pylint",
+        "ms-python.autopep8",
+        "tamasfe.even-better-toml",
+        "VisualStudioExptTeam.vscodeintellicode",
+        "matangover.mypy"
+      ]
+    }
+  }
+}

.devcontainer/res/.bash_aliases

@@ -0,0 +1 @@
+alias gitgrlog='git log --pretty=format:"%C(yellow)%h%C(reset) %C(magenta)%cd%C(reset) %C(auto)%d%C(reset) %s" --graph --date=format:"%Y.%m.%d" --decorate=auto'

.devcontainer/res/.bashrc

@@ -0,0 +1,29 @@
+
+# --------------------------------------------------------------------------------------
+# Borrowed from the .bashrc configuration of mcr.microsoft.com/devcontainers/base:jammy
+# --------------------------------------------------------------------------------------
+
+__bash_prompt() {
+    local userpart='`export XIT=$? \
+        && [ ! -z "${GITHUB_USER}" ] && echo -n "\[\033[0;32m\]@${GITHUB_USER} " || echo -n "\[\033[0;32m\]\u " \
+        && [ "$XIT" -ne "0" ] && echo -n "\[\033[1;31m\]➜" || echo -n "\[\033[0m\]➜"`'
+    local gitbranch='`\
+        if [ "$(git config --get devcontainers-theme.hide-status 2>/dev/null)" != 1 ] && [ "$(git config --get codespaces-theme.hide-status 2>/dev/null)" != 1 ]; then \
+            export BRANCH=$(git --no-optional-locks symbolic-ref --short HEAD 2>/dev/null || git --no-optional-locks rev-parse --short HEAD 2>/dev/null); \
+            if [ "${BRANCH}" != "" ]; then \
+                echo -n "\[\033[0;36m\](\[\033[1;31m\]${BRANCH}" \
+                && if [ "$(git config --get devcontainers-theme.show-dirty 2>/dev/null)" = 1 ] && \
+                    git --no-optional-locks ls-files --error-unmatch -m --directory --no-empty-directory -o --exclude-standard ":/*" > /dev/null 2>&1; then \
+                        echo -n " \[\033[1;33m\]✗"; \
+                fi \
+                && echo -n "\[\033[0;36m\]) "; \
+            fi; \
+        fi`'
+    local lightblue='\[\033[1;34m\]'
+    local removecolor='\[\033[0m\]'
+    PS1="${userpart} ${lightblue}\w ${gitbranch}${removecolor}\$ "
+    unset -f __bash_prompt
+}
+__bash_prompt
+
+export PATH=/home/$USER/.local/bin:$PATH

.devcontainer/res/post_create_command.bash

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+# This script should be run after the devcontainer is created.
+# It's role is to establish the necessary environment for the
+# user to start developing.
+
+cat .devcontainer/res/.bash_aliases >> ~/.bash_aliases
+cat .devcontainer/res/.bashrc >> ~/.bashrc

.devcontainer/scripts/base-setup.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+set -euo pipefail
+
+if ! id "${USERNAME}" &>/dev/null; then
+  echo "User '${USERNAME}' does not exist. Create it in the Dockerfile before running this script." >&2
+  exit 1
+fi
+
+usermod -aG sudo "${USERNAME}"
+echo "${USERNAME} ALL=(ALL) NOPASSWD:ALL" > "/etc/sudoers.d/${USERNAME}"
+chmod 440 "/etc/sudoers.d/${USERNAME}"
+
+git config --system core.sshCommand /usr/bin/ssh

.devcontainer/web-app/Dockerfile

@@ -0,0 +1,26 @@
+FROM python:3.12-slim
+
+SHELL ["/bin/bash", "-c"]
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+      curl \
+      wget \
+      git \
+      openssh-client \
+      sudo \
+      just \
+      libmagic1
+
+RUN groupadd -g 1000 appuser && useradd appuser -u 1000 -g 1000 -m -s /bin/bash
+RUN chown -R appuser:appuser /home/appuser/
+
+COPY .devcontainer/scripts/base-setup.sh /tmp/base-setup.sh
+RUN chmod +x /tmp/base-setup.sh \
+    && USERNAME="appuser" /tmp/base-setup.sh
+
+USER appuser
+WORKDIR /home/appuser/workspace
+
+RUN wget -qO- https://astral.sh/uv/install.sh | sh

.devcontainer/web-app/devcontainer.json

@@ -0,0 +1,35 @@
+{
+  "name": "web-app",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": "../.."
+  },
+  "workspaceMount": "source=${localWorkspaceFolder},target=/home/appuser/workspace,type=bind",
+  "workspaceFolder": "/home/appuser/workspace/services/web-app",
+  "mounts": [
+    "type=bind,source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent"
+  ],
+  "remoteUser": "appuser",
+  "remoteEnv": {
+    "SSH_AUTH_SOCK": "/ssh-agent",
+    "GIT_CONFIG_GLOBAL": "/home/appuser/.gitconfig"
+  },
+  "runArgs": [
+    "--network=host"
+  ],
+  "overrideCommand": true,
+  "postCreateCommand": "cd /home/appuser/workspace && /bin/bash .devcontainer/res/post_create_command.bash",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "skellock.just",
+        "ms-python.python",
+        "ms-python.pylint",
+        "ms-python.autopep8",
+        "tamasfe.even-better-toml",
+        "VisualStudioExptTeam.vscodeintellicode",
+        "matangover.mypy"
+      ]
+    }
+  }
+}

.github/actions/run-precommit-for-service/action.yml

@@ -0,0 +1,36 @@
+---
+name: Run Pre-commit for Service
+description: Set up a Dev-Container for a specific service and run pre-commit checks within that environment.
+
+inputs:
+  devcontainer-cfg-path:
+    description: Directory containing .devcontainer configuration for the service.
+    required: true
+
+  service-workdir:
+    description: Working directory inside the Dev-Container where the service code resides.
+    required: true
+
+runs:
+  using: composite
+
+  steps:
+    - name: Verify Docker engine
+      run: docker version
+      shell: bash
+
+    - name: Ensure SSH agent mount path exists
+      run: |
+        if [ ! -e "${SSH_AUTH_SOCK}" ]; then
+          touch "${SSH_AUTH_SOCK}"
+        fi
+      shell: bash
+
+    - name: Run pre-commit in devcontainer
+      uses: devcontainers/ci@v0.3
+      with:
+        configFile: ${{ inputs.devcontainer-cfg-path }}/devcontainer.json
+        runCmd: | 
+          cd ${{ inputs.service-workdir }} && \
+            just setup-environment && \
+            just run-precommit