euri-iso/AGENTS.md

Papal Decree for All Agents Working Upon These Hallowed Files

Git Confession (Required Before Every Act)

Lest thy soul be marked with the sigil of a false prophet, thou shalt kneel and recite:

git config user.name "Celestia Ludenberg"
git config user.email "ash8820@proton.me"

This commandment shalt be obeyed in every session before committing or pushing. Suffer not the default identity to live. The OpenHands heresy shall not be permitted again.

GPG Signing (Salvation Through Seal)

All commits MUST be signed with the Antergos NeXT maintainer key:

git config user.signingkey F1D8F02C5E929F3FE0424EE897F813D238CF0DBB
git config commit.gpgsign true

Then commit with git commit -S -m "message". If GPG prompts for a passphrase, pray to the build gods and provide it. An unsigned commit is a mortal sin.

The Crusade

• Artix Linux ISO (OpenRC init), forked from EndeavourOS-ISO, then migrated to artools after 15 days in a vent shaft
• KDE Plasma live environment with Calamares installer (offline + online modes)
• Build command: export WORKSPACE_DIR="$PWD" && sudo -E ./buildiso -p antergos — use ./buildiso, NOT buildiso; the system Artix /usr/bin/buildiso lacks --overwrite='*' and will fail with file conflicts; sudo -E is required to preserve WORKSPACE_DIR environment variable
• ISO appears in /var/lib/artools/buildiso/iso/antergos/ (assuming the build gods are pleased)

Antergos NeXT Repos

• antergos-iso: https://github.com/Antergos-NeXT/antergos-iso
• antergos-packages: https://github.com/Antergos-NeXT/antergos-packages
• calamares: https://codeberg.org/calamares/calamares (upstream installer framework)

Critical Gotchas (Read Before Editing)

CMAKE_DISTRIBUTION_NAME is a no-op

Calamares completely ignores -DCMAKE_DISTRIBUTION_NAME. The "for " text in the about dialog comes from versionedName in the active branding component at runtime. Do NOT add this flag to the calamares PKGBUILD.

brandind.desc componentName must match directory

Calamares Branding.cpp has this check:

if (m_componentName != componentDir.dirName()) { bail(...); }

So componentName: antergos-next can only live in directory antergos-next/. If copying to default/, you MUST sed the componentName to default.

Package order matters in profile.yaml

Build uses basestrap --overwrite='*'. The last package to claim a file wins. Package order in profile.yaml should list calamares BEFORE calamares-branding-antergos-next, so branding files overwrite Calamares defaults, not the other way around.

Repo order in iso-x86_64.conf

[antergos-pkgs] must be listed FIRST in iso-x86_64.conf so our custom packages (calamares, branding) take priority over Artix's.

Pacman.conf must be user-overridden

buildiso uses /usr/share/artools/pacman.conf.d/iso-x86_64.conf (from artools package) unless there's one at ~/.config/artools/pacman.conf.d/iso-x86_64.conf. But we need [antergos-pkgs] in it. Before building locally:

mkdir -p ~/.config/artools/pacman.conf.d
cp pacman.conf.d/iso-x86_64.conf ~/.config/artools/pacman.conf.d/iso-x86_64.conf

CI does this automatically. Forget this step and buildiso will try to fetch our custom packages from Artix repos and fail.

WORKSPACE_DIR

buildiso looks for profiles at $WORKSPACE_DIR/iso-profiles/<profile>/ if WORKSPACE_DIR is set. Always set it to the repo root when building locally.

dinit-rc / openrc init-rc conflict during basestrap

dinit-rc and openrc both provide AND conflict with virtual init-rc. They cannot coexist. When base depends on init-logind (virtual), pacman with --noconfirm picks the first alphabetically — elogind-dinit (before elogind-openrc). elogind-dinit → dbus-dinit → dinit → dinit-rc, which conflicts with openrc (pulled by elogind-openrc via dbus-openrc).

Fix in basestrap/main.py (Calamares module): Add --ignore=elogind-dinit (and alphabetically-before providers for other inits) to all pacman calls. This prevents pacman --noconfirm from resolving init-logind to the wrong provider. Installing the provider separately doesn't work because provider deps (e.g. dbus's post-install creating the dbus user) need shadow from base.

Fix in buildiso (ISO build): Same --ignore approach — add --ignore=elogind-dinit to the basestrap call for INITSYS=openrc, etc., depending on which init is selected.

Repo Structure

antergos-iso/
├── buildiso                    # Modified buildiso with Antergos branding
├── iso-profiles/
│   ├── antergos/
│   │   ├── profile.yaml        # Packages, services (rootfs + livefs)
│   │   ├── root-overlay/       # Merged into squashfs rootfs
│   │   └── live-overlay/       # Merged into live environment
│   └── common/
│       └── common.yaml         # Shared base packages
├── pacman.conf.d/
│   └── iso-x86_64.conf         # Pacman config for ISO build
├── .github/workflows/build.yml # CI: builds ISO, uploads to Internet Archive
└── AGENTS.md                   # You are here

ISO Upload

Pushed to Internet Archive with collection: open_source_software (Community Software, NOT Community Texts). CI uses IA_ACCESS_KEY and IA_SECRET_KEY secrets.

DEUS VULT