unaltraweb 0.3.0

data/scripts/unaltraweb-mcp-bootstrap.sh

@@ -0,0 +1,105 @@
+#!/bin/sh
+set -eu
+
+usage() {
+  cat <<'USAGE'
+Usage: unaltraweb-mcp-bootstrap [--project PATH] [--image IMAGE]
+
+Start one Dockerized unaltraweb MCP stdio server for the selected workspace.
+If --project is omitted, MCP_CONSUMER_WORKSPACE is used, then the current directory.
+USAGE
+}
+
+image="${UNALTRAWEB_MCP_IMAGE:-ghcr.io/dosquartsdedocs/unaltraweb-mcp:0.3.0}"
+project="${MCP_CONSUMER_WORKSPACE:-${UNALTRAWEB_PROJECT:-}}"
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --project)
+      [ "$#" -ge 2 ] || { printf '%s\n' 'Missing value for --project' >&2; exit 2; }
+      project="$2"
+      shift 2
+      ;;
+    --image)
+      [ "$#" -ge 2 ] || { printf '%s\n' 'Missing value for --image' >&2; exit 2; }
+      image="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      printf 'Unknown argument: %s\n' "$1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [ -z "$project" ]; then
+  project="$PWD"
+fi
+newline='
+'
+carriage_return=$(printf '\r')
+case "$project" in
+  *"$newline"*|*"$carriage_return"*)
+    printf '%s\n' 'Project paths must not contain carriage returns or newlines.' >&2
+    exit 2
+    ;;
+esac
+if [ ! -d "$project" ]; then
+  printf 'Project directory not found: %s\n' "$project" >&2
+  exit 1
+fi
+
+project="$(CDPATH= cd -- "$project" && pwd -P)"
+owner="${UNALTRAWEB_PROJECT_USER:-$(id -u):$(id -g)}"
+docker_socket="${UNALTRAWEB_DOCKER_SOCKET:-/var/run/docker.sock}"
+script_dir="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd -P)"
+project_id="$(/bin/sh "$script_dir/unaltraweb-mcp-project-id.sh" "$project")"
+workspace_mount="$(/bin/sh "$script_dir/unaltraweb-docker-mount.sh" "$project" /workspace)"
+mirror_mount="$(/bin/sh "$script_dir/unaltraweb-docker-mount.sh" "$project" "$project")"
+
+if ! resolved_image="$(docker image inspect --format '{{.Id}}' "$image" 2>/dev/null)"; then
+  docker pull "$image" >/dev/null
+  resolved_image="$(docker image inspect --format '{{.Id}}' "$image")"
+fi
+image_reference="$image"
+case "$image_reference" in
+  ghcr.io/dosquartsdedocs/unaltraweb-mcp@sha256:*) ;;
+  *)
+    for repository_digest in $(docker image inspect --format '{{range .RepoDigests}}{{println .}}{{end}}' "$image"); do
+      case "$repository_digest" in
+        ghcr.io/dosquartsdedocs/unaltraweb-mcp@sha256:*) image_reference="$repository_digest"; break ;;
+      esac
+    done
+    ;;
+esac
+
+set -- docker run --rm -i \
+  --label io.context.mcp-factory=unaltraweb \
+  --label io.context.mcp-role=stdio \
+  --label "io.context.mcp-project=$project_id" \
+  --user "$owner" \
+  -e HOME=/tmp \
+  -e COMPUTE_CORE=/opt/unaltraweb \
+  -e LOCAL_CORE=/opt/unaltraweb \
+  -e "MCP_CONSUMER_WORKSPACE=$project" \
+  -e "UNALTRAWEB_DOCKER_ROOT=$project" \
+  -e UNALTRAWEB_FACTORY_DIR=/opt/unaltraweb \
+  -e "UNALTRAWEB_MCP_IMAGE=$resolved_image" \
+  -e "UNALTRAWEB_MCP_IMAGE_REFERENCE=$image_reference" \
+  -e "UNALTRAWEB_PROJECT_USER=$owner" \
+  --mount "$workspace_mount" \
+  --mount "$mirror_mount" \
+  -w "$project"
+
+if [ -S "$docker_socket" ]; then
+  socket_group="$(stat -c '%g' "$docker_socket")"
+  socket_mount="$(/bin/sh "$script_dir/unaltraweb-docker-mount.sh" "$docker_socket" /var/run/docker.sock)"
+  set -- "$@" --group-add "$socket_group" --mount "$socket_mount"
+fi
+
+exec "$@" "$resolved_image" --project "$project" mcp serve

data/scripts/unaltraweb-mcp-cleanup.sh

@@ -0,0 +1,73 @@
+#!/bin/sh
+set -eu
+
+script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd -P)
+project_id="${MCP_PROJECT_ID:-}"
+workspace="${MCP_CONSUMER_WORKSPACE:-}"
+project=""
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --project)
+      [ "$#" -ge 2 ] || { printf '%s\n' '--project requires a path' >&2; exit 2; }
+      project=$2
+      shift 2
+      ;;
+    --project-id)
+      [ "$#" -ge 2 ] || { printf '%s\n' '--project-id requires an ID' >&2; exit 2; }
+      project_id=$2
+      shift 2
+      ;;
+    *)
+      printf 'Unknown cleanup argument: %s\n' "$1" >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [ -z "$project" ]; then
+  project=$workspace
+fi
+
+if [ -n "$project" ]; then
+  if [ -d "$project" ]; then
+    computed_id=$(/bin/sh "$script_dir/unaltraweb-mcp-project-id.sh" "$project")
+    if [ -n "$project_id" ] && [ "$project_id" != "$computed_id" ]; then
+      printf 'Project ID %s does not match canonical live workspace %s\n' "$project_id" "$project" >&2
+      exit 2
+    fi
+    project_id=$computed_id
+  elif [ -e "$project" ]; then
+    printf 'Workspace path is not a directory: %s\n' "$project" >&2
+    exit 2
+  elif [ -z "$project_id" ]; then
+    printf 'Workspace is absent: %s. Set MCP_PROJECT_ID to the retained 16-hex project ID explicitly.\n' "$project" >&2
+    exit 2
+  fi
+fi
+
+case "$project_id" in
+  [0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f]) ;;
+  '')
+    printf '%s\n' 'Set MCP_CONSUMER_WORKSPACE or pass --project-id with the retained project ID.' >&2
+    exit 2
+    ;;
+  *)
+    printf 'Invalid unaltraweb project ID: %s\n' "$project_id" >&2
+    exit 2
+    ;;
+esac
+
+containers=$(docker ps -aq \
+  --filter "label=io.context.mcp-factory=unaltraweb" \
+  --filter "label=io.context.mcp-project=$project_id")
+if [ -n "$containers" ]; then
+  docker rm -f $containers >/dev/null
+fi
+
+networks=$(docker network ls -q \
+  --filter "label=io.context.mcp-factory=unaltraweb" \
+  --filter "label=io.context.mcp-project=$project_id")
+if [ -n "$networks" ]; then
+  docker network rm $networks >/dev/null
+fi

data/scripts/unaltraweb-mcp-project-id.sh

@@ -0,0 +1,34 @@
+#!/bin/sh
+set -eu
+
+project="${1:-${MCP_CONSUMER_WORKSPACE:-${UNALTRAWEB_PROJECT:-$PWD}}}"
+
+if [ "$#" -gt 1 ]; then
+  printf '%s\n' 'Usage: unaltraweb-mcp-project-id [PROJECT]' >&2
+  exit 2
+fi
+newline='
+'
+carriage_return=$(printf '\r')
+case "$project" in
+  *"$newline"*|*"$carriage_return"*)
+    printf '%s\n' 'Project paths must not contain carriage returns or newlines.' >&2
+    exit 2
+    ;;
+esac
+if [ ! -d "$project" ]; then
+  printf 'Project directory not found: %s\n' "$project" >&2
+  exit 1
+fi
+
+project="$(CDPATH= cd -- "$project" && pwd -P)"
+if command -v sha256sum >/dev/null 2>&1; then
+  checksum="$(printf '%s' "$project" | sha256sum)"
+elif command -v shasum >/dev/null 2>&1; then
+  checksum="$(printf '%s' "$project" | shasum -a 256)"
+else
+  printf '%s\n' 'sha256sum or shasum is required to identify the project.' >&2
+  exit 1
+fi
+checksum="${checksum%% *}"
+printf '%.16s\n' "$checksum"