Gentoo Packages

# Copyright 2026 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2

# ebuild automatically verified at 2026-08-22
EAPI=8

inherit desktop xdg

DESCRIPTION="Kiro Crew - persistent, self-learning AI agent workspace (prebuilt AppImage)"
HOMEPAGE="https://kiro.dev/docs/crew/ https://github.com/kirodotdev/KiroCrew"

# Repackage of the official Linux AppImage from the (Apache-2.0,
# open-sourced 2026-08-04) kirodotdev/KiroCrew GitHub releases. The
# AppImage bundles the Electron desktop app plus the Python Gateway
# backend (resources/backend-dist, PyInstaller-style), so no host
# Python is needed. amd64 only upstream.
SRC_URI="https://github.com/kirodotdev/KiroCrew/releases/download/v${PV}/KiroCrew-${PV}.AppImage -> ${P}.AppImage"
S="${WORKDIR}/squashfs-root"

LICENSE="Apache-2.0"
SLOT="0"
KEYWORDS="~amd64"
# strip: prebuilt Electron + PyInstaller binaries; mirror: fetch from
# the upstream release endpoint only (no local distfile mirroring).
RESTRICT="strip mirror"
QA_PREBUILT="opt/kirocrew/*"

# Standard Electron/Chromium runtime set (cf. dev-util/kiro-bin and
# dev-util/claude-desktop-bin). The bundled Python backend is fully
# self-contained. Talking to the LLM additionally wants
# dev-util/kiro-cli-bin at runtime (Agent Client Protocol provider),
# but the dashboard can install/guide that itself, so it is expressed
# as an elog hint rather than a hard dep.
RDEPEND="
	>=sys-libs/glibc-2.34
	dev-libs/glib:2
	dev-libs/nss
	dev-libs/nspr
	app-crypt/libsecret
	x11-libs/gtk+:3
	x11-libs/libnotify
	x11-libs/libxkbcommon
	x11-libs/libdrm
	x11-libs/libX11
	x11-libs/libxcb
	x11-libs/libXcomposite
	x11-libs/libXdamage
	x11-libs/libXext
	x11-libs/libXfixes
	x11-libs/libXrandr
	x11-libs/libXtst
	x11-libs/cairo
	x11-libs/pango
	app-accessibility/at-spi2-core
	media-libs/alsa-lib
	media-libs/mesa
	sys-apps/dbus
	sys-apps/util-linux
	virtual/libcrypt:=
"
# virtual/libcrypt: the bundled PyInstaller Python 3.12 links
# libcrypt.so.1 (lib-dynload/_crypt); on glibc>=2.39 that is a
# separate provider package, so declare it (QA notice otherwise).

src_unpack() {
	# An AppImage is an ELF runtime with an appended squashfs. Extract
	# it via the runtime's own --appimage-extract (no FUSE needed at
	# build time, and no fragile squashfs-offset computation). The
	# artifact's SHA256 was verified against the GitHub release digest
	# when the Manifest was generated, and portage re-verifies the
	# Manifest hashes before we ever execute it here.
	cp "${DISTDIR}/${P}.AppImage" "${WORKDIR}/" || die "cp failed"
	chmod +x "${WORKDIR}/${P}.AppImage" || die "chmod failed"
	cd "${WORKDIR}" || die
	"./${P}.AppImage" --appimage-extract >/dev/null || die "AppImage extract failed"
}

src_install() {
	# Install the extracted AppDir under /opt/kirocrew/ preserving
	# executable bits (doins strips +x; same convention as kiro-bin).
	local dest="${ED}/opt/kirocrew"
	mkdir -p "${dest}" || die "mkdir failed"
	cp -a . "${dest}/" || die "cp failed"

	# The AppImage-internal desktop file (Exec=AppRun --no-sandbox) and
	# .DirIcon are AppImage plumbing; replace with proper XDG entries.
	rm -f "${dest}"/*.desktop "${dest}/.DirIcon"

	# Prune bundled binaries that can never load on this host
	# (~amd64 = linux/x64/glibc), same policy as dev-util/kiro-bin:
	#  - the vendored llama.cpp libs for every non-host platform
	#    (linux_aarch64, macos_*, win_amd64; Portage's soname scanner
	#    flags the aarch64 ones' unresolved ld-linux-aarch64 deps),
	#  - AppImage legacy-desktop compat shims (libappindicator/
	#    libgconf) that dangle against libs Gentoo no longer ships;
	#    Electron only dlopens them opportunistically on ancient
	#    desktops and runs fine without.
	# Guarded find so a future upstream layout change can never die.
	local _vend
	while IFS= read -r -d '' _vend; do
		rm -rf "${_vend}"
	done < <(find "${dest}"/resources/backend-dist -type d \
		-path '*/_vendor/llama_cpp_libs/*' ! -name 'linux_x86_64' \
		-print0 2>/dev/null)
	rm -f "${dest}"/usr/lib/libappindicator.so.1 "${dest}"/usr/lib/libgconf-2.so.4
	rmdir --ignore-fail-on-non-empty "${dest}/usr/lib" "${dest}/usr" 2>/dev/null || true

	# Known-benign remaining QA notice: the bundled PyInstaller
	# lib/libpython3.so carries an $ORIGIN-relative DT_NEEDED on
	# libpython3.12.so.1.0 which Portage's scanner does not resolve;
	# the target ships right next to it in the same lib/ dir.

	# Electron sandbox helper must be setuid-root so the app runs with
	# the Chromium sandbox instead of upstream's --no-sandbox fallback.
	if [[ -f "${dest}/chrome-sandbox" ]]; then
		fperms 4755 /opt/kirocrew/chrome-sandbox
	fi

	# Launcher: AppRun sets up the AppDir environment and execs the
	# bundled Electron binary. /usr/bin/kirocrew-desktop, NOT
	# /usr/bin/kirocrew - the latter is the CLI entry point of the pip
	# distribution and must stay free for a future source package.
	dosym ../../opt/kirocrew/AppRun /usr/bin/kirocrew-desktop

	# XDG desktop entry + icon from the upstream AppDir. The AppDir-root
	# kirocrew-electron-mac.png is a SYMLINK into the AppDir's own
	# usr/share/icons tree; newicon on the symlink would install a
	# dangling link, so install the real file (1024x1024 upstream).
	make_desktop_entry /opt/kirocrew/AppRun "Kiro Crew" kirocrew \
		"Development;" "StartupWMClass=KiroCrew"
	local icon_real
	icon_real="$(readlink -f "${S}/kirocrew-electron-mac.png" 2>/dev/null || true)"
	if [[ -f "${icon_real}" ]]; then
		newicon -s 1024 "${icon_real}" kirocrew.png
	else
		ewarn "Upstream icon not found; desktop entry falls back to a generic icon."
	fi
}

pkg_postinst() {
	xdg_pkg_postinst
	elog "Kiro Crew is available as 'kirocrew-desktop' (and an XDG menu entry)."
	elog "The app drives its LLM through kiro-cli (Agent Client Protocol);"
	elog "install dev-util/kiro-cli-bin or let the first launch set it up."
	elog "Persistent state lives under ~/.kiro/crew/ (KIROCREW_HOME to move it)."
}

pkg_postrm() {
	xdg_pkg_postrm
}