added package install validation, strip_markdown, stub glow integration

Author: itlackey

.github/workflows/installation-validation.yaml

@@ -0,0 +1,26 @@
+name: Build and Validate Packages
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'templates/**'
+      - 'build/**'
+
+jobs:
+  build-and-validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build Docker image
+        run: docker build -t giv-build -f build/Dockerfile.packages .
+
+      - name: Build packages inside container
+        run: |
+          docker run --rm -v ${{ github.workspace }}:/workspace giv-build /workspace/build/build.sh
+
+      - name: Validate installs inside container
+        run: |
+          docker run --rm -v ${{ github.workspace }}:/workspace giv-build /workspace/ci/install-validate.sh

.vscode/settings.json

@@ -21,7 +21,12 @@
         "[ ]",
         "[x]",
         "ENHANCEMENT",
-        "CHORE"
+        "CHORE",
+        "FEAT",
+        "FEATURE",
+        "DOC:",
+        "DOCUMENTATION",
+        "TEST:"
     ],
     "shellcheck.customArgs": [
         "-x"

build/Dockerfile build/Dockerfile.packagesbuild/Dockerfile renamed to build/Dockerfile.packages

@@ -13,6 +13,7 @@ RUN apt-get update && \
     snapd \
     python3 \
     python3-pip \
+    python3.12-venv \
     ruby \
     ruby-dev \
     flatpak-builder \
@@ -30,6 +31,8 @@ RUN locale-gen en_US.UTF-8
 ENV LANG=en_US.UTF-8
 ENV LANGUAGE=en_US:en
 ENV LC_ALL=en_US.UTF-8
+
+
 # Install snapd (for snap builds; install snaps at runtime)
 #RUN apt-get update && apt-get install -y --no-install-recommends snapd && rm -rf /var/lib/apt/lists/*
 # NOTE: To use snapcraft, start the container and run:
@@ -41,10 +44,6 @@ RUN gem install --no-document fpm
 # Install bats (for shell testing)
 RUN npm install -g bats
 
-# Install Homebrew (for homebrew builds, on Linux)
-RUN /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" || true
-ENV PATH="/home/linuxbrew/.linuxbrew/bin:/home/linuxbrew/.linuxbrew/sbin:$PATH"
-RUN brew update || true
 
 # Install GitHub CLI (gh)
 RUN type -p gh || (curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | \
@@ -54,6 +53,31 @@ RUN type -p gh || (curl -fsSL https://cli.github.com/packages/githubcli-archive-
     tee /etc/apt/sources.list.d/github-cli.list > /dev/null && \
     apt-get update && apt-get install -y gh)
 
+# Install Homebrew (for homebrew builds, on Linux)
+
+# 2) Ensure UTF-8 locale (prevents brew warnings)
+RUN localedef -i en_US -f UTF-8 en_US.UTF-8
+
+# 3) Create a non-root user for Homebrew
+RUN useradd -m -s /bin/bash linuxbrew && \
+    echo 'linuxbrew ALL=(ALL) NOPASSWD:ALL' >> /etc/sudoers
+
+# 4) Switch to that user and install Homebrew (non-interactively)
+USER linuxbrew
+ENV CI=1 NONINTERACTIVE=1
+RUN /bin/bash -c \
+      "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+ENV PATH="/home/linuxbrew/.linuxbrew/bin:/home/linuxbrew/.linuxbrew/sbin:${PATH}"
+
+# 6) Verify brew works
+RUN brew --version && brew update --quiet
+
+# # 5) Switch back to root, expose brew on PATH
+USER root
+ENV PATH="/home/linuxbrew/.linuxbrew/bin:/home/linuxbrew/.linuxbrew/sbin:${PATH}"
+
+
 # Set workdir
 WORKDIR /workspace
 

build/build.sh build/build-packages.shbuild/build.sh renamed to build/build-packages.sh

@@ -60,6 +60,9 @@ if [ "${FPM_INSTALLED}" = "true" ]; then
 fi
 ./build/snap/build.sh "${VERSION}" "${BUILD_TEMP}"
 ./build/flatpak/build.sh "${VERSION}" "${BUILD_TEMP}"
+./build/docker/build.sh "${VERSION}" "${BUILD_TEMP}"
 
 #rm -rf "${BUILD_TEMP}"
 printf "Build completed. Files are in %s\n" "${DIST_DIR}"
+
+rm -rf "${BUILD_TEMP}"

build/docker-build.sh

@@ -0,0 +1,43 @@
+FROM debian:bookworm-slim
+
+# Install required packages
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        ca-certificates \
+        git \
+        curl \
+        bash \
+    && rm -rf /var/lib/apt/lists/*
+
+# # ---- Install Glow ----
+# ENV GLOW_VERSION="2.1.1"
+# RUN curl -fsSL "https://github.com/charmbracelet/glow/releases/download/v${GLOW_VERSION}/glow_${GLOW_VERSION}_linux_amd64.deb" -o /tmp/glow.deb \
+#     && apt-get update \
+#     && apt-get install -y /tmp/glow.deb \
+#     && rm /tmp/glow.deb
+
+# Copy your built files into place (from the repo root at build time)
+# Assume you have these in the build context!
+COPY src/giv.sh /usr/local/bin/giv
+COPY src/*.sh /usr/local/lib/giv/
+COPY templates/ /usr/local/share/giv/templates/
+COPY docs/ /usr/local/share/giv/docs/
+
+RUN chmod +x /usr/local/bin/giv
+
+# Set up environment
+ENV GIV_LIB_DIR="/usr/local/lib/giv"
+ENV GIV_TEMPLATE_DIR="/usr/local/share/giv/templates"
+ENV GIV_DOCS_DIR="/usr/local/share/giv/docs"
+ENV PATH="/usr/local/bin:$PATH"
+
+# Test it works
+RUN giv --help || true
+
+# Use bash shell by default
+SHELL ["/bin/bash", "-c"]
+
+WORKDIR /workspace
+
+ENTRYPOINT ["giv"]
+CMD ["--help"]

build/docker/Dockerfile

@@ -0,0 +1,9 @@
+#! /bin/bash
+
+VERSION="$1"
+IMAGE="giv-cli/giv"
+
+docker build -f build/docker/Dockerfile \
+    -t "${IMAGE}:$VERSION" \
+    -t "${IMAGE}:latest" \
+    .

build/docker/build.sh

@@ -0,0 +1,13 @@
+#! /bin/bash
+
+VERSION="$1"
+IMAGE="giv-cli/giv"
+
+# 2) Login to Docker Hub
+echo "$DOCKER_HUB_PASSWORD" | docker login \
+  --username "$DOCKER_HUB_USERNAME" \
+  --password-stdin
+
+# 3) Push both tags
+docker push "${IMAGE}:${VERSION}"
+docker push "${IMAGE}:latest"

build/docker/publish.sh

@@ -23,6 +23,10 @@ sed -e "s|{{VERSION}}|${VERSION}|g" \
     -e "s|{{SHA256}}|$SHA256|g" \
     build/homebrew/giv.rb > "$HOMEBREW_DIST_DIR/giv.rb"
 
+sed -e "s|{{VERSION}}|${VERSION}|g" \
+    -e "s|{{SHA256}}|$SHA256|g" \
+    build/homebrew/giv.local.rb > "$HOMEBREW_DIST_DIR/giv.local.rb"
+
 rm -rf "$HOMEBREW_DIST_DIR/package"
 printf "Homebrew build completed. Files are in %s\n" "${HOMEBREW_DIST_DIR}"
 printf "Upload %s to your releases, and update your tap with the new formula.\n" "$TARBALL_NAME"

build/homebrew/build.sh

@@ -0,0 +1,22 @@
+class Giv < Formula
+  desc "Git history AI assistant CLI tool"
+  homepage "https://github.com/giv-cli/giv"
+  version "{{VERSION}}"
+  sha256 "{{SHA256}}"
+  url "file://#{__dir__}/giv-#{version}.tar.gz"
+
+  def install
+    bin.install "src/giv" => "giv"
+    libexec.install Dir["src/*.sh"]
+    (share/"giv/templates").install Dir["templates/*"]
+    (share/"giv/docs").install Dir["docs/*"]
+
+    # Move all .sh libs to /usr/local/lib/giv for compatibility
+    lib.mkpath
+    (lib/"giv").install Dir[libexec/"*.sh"]
+  end
+
+  test do
+    system "#{bin}/giv", "--help"
+  end
+end