diff options
| author | Danilo M. <danix@danix.xyz> | 2026-04-03 18:17:29 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-04-03 18:17:29 +0200 |
| commit | ebb26eac2948e02def3c7ac1ac23c4ecd345a5a7 (patch) | |
| tree | c54b2a6d28a89333b771bdee05e6baa45fe0c94f /.extras/docs/superpowers | |
| parent | 1045963959ddfb697898fa90476f837aae4e2881 (diff) | |
| download | my-slackbuilds-ebb26eac2948e02def3c7ac1ac23c4ecd345a5a7.tar.gz my-slackbuilds-ebb26eac2948e02def3c7ac1ac23c4ecd345a5a7.zip | |
repo: flatten layout — move packages to root, extras to .extras/
- Move all packages from SlackBuilds/ to repo root
- Move hooks/, docs/, nvchecker.toml to .extras/
- Update CLAUDE.md and README.md to reflect new structure
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Diffstat (limited to '.extras/docs/superpowers')
6 files changed, 866 insertions, 0 deletions
diff --git a/.extras/docs/superpowers/plans/2026-03-31-opencode-bin-slackbuild.md b/.extras/docs/superpowers/plans/2026-03-31-opencode-bin-slackbuild.md new file mode 100644 index 0000000..e5009b4 --- /dev/null +++ b/.extras/docs/superpowers/plans/2026-03-31-opencode-bin-slackbuild.md @@ -0,0 +1,258 @@ +# opencode-bin SlackBuild Implementation Plan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Create a complete `opencode-bin` SlackBuild package that repackages the official pre-built opencode binary for Slackware. + +**Architecture:** Binary-repackaging pattern — download upstream tarball, install the static binary to `/usr/bin/opencode`, install docs, run `makepkg`. Follows the same structure as `kitty-bin` and `hugo` in this repo. Supports `x86_64` and `aarch64`. + +**Tech Stack:** Bash, SBo packaging tools (`sbolint`, `sbofixinfo`, `sbodl`) + +--- + +## File Map + +| File | Action | Responsibility | +|------|--------|----------------| +| `opencode-bin/opencode-bin.SlackBuild` | Create | Main build script | +| `opencode-bin/opencode-bin.info` | Create | Package metadata and download URLs | +| `opencode-bin/README` | Create | Package description and usage notes | +| `opencode-bin/slack-desc` | Create | 11-line package description for pkgtool | +| `nvchecker.toml` | Modify | Add upstream version tracking entry | + +--- + +### Task 1: Create the package files + +**Files:** +- Create: `opencode-bin/opencode-bin.SlackBuild` +- Create: `opencode-bin/opencode-bin.info` +- Create: `opencode-bin/README` +- Create: `opencode-bin/slack-desc` + +- [ ] **Step 1: Create the directory** + +```bash +mkdir -p /home/danix/Programming/GIT/GITHUB/my-slackbuilds/opencode-bin +``` + +- [ ] **Step 2: Create opencode-bin.SlackBuild** + +Create `/home/danix/Programming/GIT/GITHUB/my-slackbuilds/opencode-bin/opencode-bin.SlackBuild` with this exact content: + +```bash +#!/bin/bash + +# Slackware build script for opencode-bin + +# Copyright 2026 danix <danix@danix.xyz> +# All rights reserved. +# +# Redistribution and use of this script, with or without modification, is +# permitted provided that the following conditions are met: +# +# 1. Redistributions of this script must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# +# THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED +# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO +# EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF +# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +cd $(dirname $0) ; CWD=$(pwd) + +PRGNAM=opencode-bin +VERSION=${VERSION:-0.0.55} +BUILD=${BUILD:-1} +TAG=${TAG:-_SBo} +PKGTYPE=${PKGTYPE:-tgz} + +if [ -z "$ARCH" ]; then + case "$( uname -m )" in + arm*) ARCH=arm ;; + *) ARCH=$( uname -m ) ;; + esac +fi + +if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then + echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE" + exit 0 +fi + +TMP=${TMP:-/tmp/SBo} +PKG=$TMP/package-$PRGNAM +OUTPUT=${OUTPUT:-/tmp} + +if [ "$ARCH" = "x86_64" ]; then + SRCARCH="x86_64" +elif [ "$ARCH" = "aarch64" ]; then + SRCARCH="arm64" +else + echo "$ARCH is not supported." + exit 1 +fi + +set -e + +rm -rf $PKG +mkdir -p $TMP $PKG $OUTPUT +cd $TMP +rm -rf $PRGNAM-$VERSION +mkdir -p $PRGNAM-$VERSION +tar xvf $CWD/opencode-linux-$SRCARCH.tar.gz -C $PRGNAM-$VERSION +cd $PRGNAM-$VERSION +chown -R root:root . +find -L . \ + \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 \ + -o -perm 511 \) -exec chmod 755 {} \; -o \ + \( -perm 666 -o -perm 664 -o -perm 640 -o -perm 600 -o -perm 444 \ + -o -perm 440 -o -perm 400 \) -exec chmod 644 {} \; + +mkdir -p $PKG/usr/bin +install -m 0755 opencode $PKG/usr/bin/opencode + +mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION +cp -a LICENSE README.md $PKG/usr/doc/$PRGNAM-$VERSION +cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild + +mkdir -p $PKG/install +cat $CWD/slack-desc > $PKG/install/slack-desc + +cd $PKG +/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE +``` + +Make it executable: +```bash +chmod +x /home/danix/Programming/GIT/GITHUB/my-slackbuilds/opencode-bin/opencode-bin.SlackBuild +``` + +- [ ] **Step 3: Create opencode-bin.info** + +Create `/home/danix/Programming/GIT/GITHUB/my-slackbuilds/opencode-bin/opencode-bin.info` with this exact content: + +``` +PRGNAM="opencode-bin" +VERSION="0.0.55" +HOMEPAGE="https://github.com/opencode-ai/opencode" +DOWNLOAD="UNSUPPORTED" +MD5SUM="" +DOWNLOAD_x86_64="https://github.com/opencode-ai/opencode/releases/download/v0.0.55/opencode-linux-x86_64.tar.gz" +MD5SUM_x86_64="" +REQUIRES="" +MAINTAINER="danix" +EMAIL="danix@danix.xyz" +``` + +- [ ] **Step 4: Create README** + +Create `/home/danix/Programming/GIT/GITHUB/my-slackbuilds/opencode-bin/README` with this exact content: + +``` +opencode-bin is a pre-built binary repackage of opencode, a powerful AI +coding agent built for the terminal. It supports multiple LLM providers +including OpenAI, Anthropic, Google Gemini, and others. + +No compilation is required; the official upstream binary is statically +linked and has no runtime library dependencies. + +To use opencode, you need an API key for at least one supported LLM +provider. Set the appropriate environment variable (e.g. OPENAI_API_KEY, +ANTHROPIC_API_KEY) or configure it via opencode's interactive setup. + +Homepage: https://github.com/opencode-ai/opencode + +NOTE FOR aarch64 USERS: The aarch64 tarball is not listed in the .info +file (not a standard SBo field). Download it manually before building: + wget https://github.com/opencode-ai/opencode/releases/download/v0.0.55/opencode-linux-arm64.tar.gz +``` + +- [ ] **Step 5: Create slack-desc** + +Create `/home/danix/Programming/GIT/GITHUB/my-slackbuilds/opencode-bin/slack-desc` with this exact content: + +``` +# HOW TO EDIT THIS FILE: +# The "handy ruler" below makes it easier to edit a package description. +# Line up the first '|' above the ':' following the base package name, and +# the '|' on the right side marks the last column you can put a character in. +# You must make exactly 11 lines for the formatting to be correct. It's also +# customary to leave one blank line after the name. + + |-----handy-ruler------------------------------------------------------| +opencode-bin: opencode-bin (AI coding agent for the terminal) +opencode-bin: +opencode-bin: opencode is a powerful AI coding agent built for the terminal. +opencode-bin: It supports multiple LLM providers including OpenAI, Anthropic, +opencode-bin: Google Gemini, and others via simple configuration. +opencode-bin: +opencode-bin: This package ships the official pre-built binary. No compilation +opencode-bin: is required. API keys for a supported LLM provider are needed +opencode-bin: at runtime. +opencode-bin: +opencode-bin: Homepage: https://github.com/opencode-ai/opencode +``` + +--- + +### Task 2: Fix checksums, download source, and lint + +**Files:** +- Modify: `opencode-bin/opencode-bin.info` (checksums filled in by sbofixinfo) + +- [ ] **Step 1: Run sbofixinfo to normalise the .info file** + +```bash +cd /home/danix/Programming/GIT/GITHUB/my-slackbuilds +sbofixinfo opencode-bin/ +``` + +Expected: no errors; `MD5SUM_x86_64` (or `SHA256SUM_x86_64`) populated. + +- [ ] **Step 2: Download source and verify checksum** + +```bash +sbodl opencode-bin/ +``` + +Expected: downloads `opencode-linux-x86_64.tar.gz` into `opencode-bin/` and reports checksum OK. + +- [ ] **Step 3: Run sbolint** + +```bash +sbolint opencode-bin/ +``` + +Expected: no errors or warnings. If any are reported, fix them before continuing. + +--- + +### Task 3: Add nvchecker entry and commit + +**Files:** +- Modify: `nvchecker.toml` + +- [ ] **Step 1: Add the opencode-bin entry to nvchecker.toml** + +Open `/home/danix/Programming/GIT/GITHUB/my-slackbuilds/nvchecker.toml` and append: + +```toml +[opencode-bin] +source = "github" +github = "opencode-ai/opencode" +use_latest_release = true +``` + +- [ ] **Step 2: Commit everything** + +```bash +cd /home/danix/Programming/GIT/GITHUB/my-slackbuilds +git add opencode-bin/ nvchecker.toml +git commit -m "opencode-bin: add version 0.0.55" +``` diff --git a/.extras/docs/superpowers/plans/2026-03-31-readme-packages-table.md b/.extras/docs/superpowers/plans/2026-03-31-readme-packages-table.md new file mode 100644 index 0000000..06bbbcc --- /dev/null +++ b/.extras/docs/superpowers/plans/2026-03-31-readme-packages-table.md @@ -0,0 +1,59 @@ +# README Packages Table Implementation Plan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Add a "Packages" section to `README.md` with a table listing all 8 packages, their build status, SBo presence, repo version, and latest upstream version. + +**Architecture:** Single static Markdown table inserted into `README.md` between the "Repository Structure" and "Usage" sections. No scripts or automation — maintained manually. + +**Tech Stack:** Markdown + +--- + +## File Map + +| File | Action | Responsibility | +|------|--------|----------------| +| `README.md` | Modify | Insert "Packages" section with table | + +--- + +### Task 1: Add Packages table to README.md + +**Files:** +- Modify: `README.md` + +- [ ] **Step 1: Insert the Packages section** + +Open `README.md`. After the closing `---` of the "Repository Structure" section (after the `nvchecker.toml` line) and before the `## Usage` heading, insert the following block exactly: + +```markdown +## Packages + +| Package | -current | 15.0 | SBo | Version | Latest | +|---------|----------|------|-----|---------|--------| +| discord | not tested | not tested | [discord](https://slackbuilds.org/repository/15.0/network/discord/) | 0.0.130 | 0.0.131 | +| hstr | not tested | not tested | [hstr](https://slackbuilds.org/repository/15.0/system/hstr/) | 3.1 | 3.2 | +| hugo | not tested | not tested | [hugo](https://slackbuilds.org/repository/15.0/development/hugo/) | 0.159.1 | 0.159.1 | +| kitty-bin | not tested | not tested | ❌ | 0.46.2 | 0.46.2 | +| llama.cpp-vulkan | not tested | not tested | ❌ | b8581 | b8590 | +| obsidian | not tested | not tested | [obsidian](https://slackbuilds.org/repository/15.0/development/obsidian/) | 1.12.7 | 1.12.7 | +| qarma | not tested | not tested | ❌ | 1.0.0 | 1.1.0 | +| syncthing | not tested | not tested | [syncthing](https://slackbuilds.org/repository/15.0/network/syncthing/) | 2.0.15 | 2.0.15 | + +--- +``` + +- [ ] **Step 2: Verify the section is in the right place** + +Read `README.md` and confirm the order is: +1. `## Repository Structure` +2. `## Packages` ← new section +3. `## Usage` + +- [ ] **Step 3: Commit** + +```bash +git add README.md +git commit -m "README: add packages table with build status and version info" +``` diff --git a/.extras/docs/superpowers/plans/2026-03-31-sbo-archive-hook.md b/.extras/docs/superpowers/plans/2026-03-31-sbo-archive-hook.md new file mode 100644 index 0000000..5b0a9fa --- /dev/null +++ b/.extras/docs/superpowers/plans/2026-03-31-sbo-archive-hook.md @@ -0,0 +1,208 @@ +# SBo Archive Hook Implementation Plan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Add a `post-commit` git hook that detects added/updated packages and offers to create a SBo-ready submission archive. + +**Architecture:** A single bash script at `.git/hooks/post-commit` inspects the HEAD commit via `git diff-tree`, identifies touched `.SlackBuild` files, lists the package contents, prompts the user interactively, and creates a `tar.gz` archive under `SBo/`. The `SBo/` directory is excluded from version control via `.gitignore`. + +**Tech Stack:** Bash, standard POSIX tools (`tar`, `find`, `git diff-tree`) + +--- + +## File Map + +| File | Action | Responsibility | +|---|---|---| +| `.git/hooks/post-commit` | Create | Hook entry point — detection, prompt, archive creation | +| `.gitignore` | Modify | Exclude `SBo/` from version control | + +--- + +### Task 1: Add SBo/ to .gitignore + +**Files:** +- Modify: `.gitignore` + +- [ ] **Step 1: Append the SBo/ entry** + +Open `.gitignore` (currently contains only `.claude`) and add: + +``` +SBo/ +``` + +Final `.gitignore`: +``` +.claude +SBo/ +``` + +- [ ] **Step 2: Verify it is ignored** + +```bash +mkdir -p SBo +git status +``` + +Expected: `SBo/` does NOT appear in untracked files (git ignores it). + +```bash +rmdir SBo +``` + +- [ ] **Step 3: Commit** + +```bash +git add .gitignore +git commit -m "gitignore: exclude SBo/ output directory" +``` + +--- + +### Task 2: Write the post-commit hook + +**Files:** +- Create: `.git/hooks/post-commit` + +- [ ] **Step 1: Create the hook file** + +Create `.git/hooks/post-commit` with the following content: + +```bash +#!/bin/bash +# post-commit hook: create SBo submission archive for added/updated packages + +REPO_ROOT=$(git rev-parse --show-toplevel) +SBO_DIR="$REPO_ROOT/SBo" + +# Find packages whose .SlackBuild was added (A) or modified (M) in this commit. +# git diff-tree output format: <status>\t<file> +# We only want files exactly one directory deep, e.g. hugo/hugo.SlackBuild. +PACKAGES=() +while IFS=$'\t' read -r status file; do + [[ "$status" != "A" && "$status" != "M" ]] && continue + dir=$(dirname "$file") + base=$(basename "$file") + [[ "$dir" == "." ]] && continue # skip root-level files + [[ "$dir" == *"/"* ]] && continue # skip files deeper than one level + [[ "$base" == *.SlackBuild ]] || continue + PACKAGES+=("$dir") +done < <(git diff-tree --no-commit-id -r --name-status HEAD) + +[[ ${#PACKAGES[@]} -eq 0 ]] && exit 0 + +mkdir -p "$SBO_DIR" + +for pkg in "${PACKAGES[@]}"; do + echo "" + echo "==> Package: $pkg" + echo "" + echo "Files to be archived:" + echo "---------------------" + find "$REPO_ROOT/$pkg" -type f | sort | sed "s|$REPO_ROOT/||" + echo "" + printf "Create SBo archive for '%s'? [y/N] " "$pkg" + read -r answer </dev/tty + case "$answer" in + [yY]|[yY][eE][sS]) + tar -czf "$SBO_DIR/$pkg.tar.gz" -C "$REPO_ROOT" "$pkg" + echo " -> Archive created: SBo/$pkg.tar.gz" + ;; + *) + echo " -> Skipped." + ;; + esac +done + +exit 0 +``` + +- [ ] **Step 2: Make it executable** + +```bash +chmod +x .git/hooks/post-commit +``` + +- [ ] **Step 3: Verify the hook is executable** + +```bash +ls -l .git/hooks/post-commit +``` + +Expected: `-rwxr-xr-x` permissions. + +--- + +### Task 3: Test the hook end-to-end + +- [ ] **Step 1: Simulate a commit that touches a .SlackBuild file** + +Make a trivial change to an existing package's `.SlackBuild` (e.g. add a blank line), stage and commit: + +```bash +echo "" >> kitty-bin/kitty-bin.SlackBuild +git add kitty-bin/kitty-bin.SlackBuild +git commit -m "kitty-bin: test hook trigger" +``` + +Expected output after the commit message appears: + +``` +==> Package: kitty-bin + +Files to be archived: +--------------------- +kitty-bin/doinst.sh +kitty-bin/kitty-bin.SlackBuild +kitty-bin/kitty-bin.info +kitty-bin/README +kitty-bin/slack-desc + +Create SBo archive for 'kitty-bin'? [y/N] +``` + +- [ ] **Step 2: Answer y and verify the archive** + +Type `y` and press Enter. + +Expected: +``` + -> Archive created: SBo/kitty-bin.tar.gz +``` + +Verify the archive contents: + +```bash +tar -tzf SBo/kitty-bin.tar.gz +``` + +Expected: all files listed under a single `kitty-bin/` top-level directory: +``` +kitty-bin/ +kitty-bin/doinst.sh +kitty-bin/kitty-bin.SlackBuild +kitty-bin/kitty-bin.info +kitty-bin/README +kitty-bin/slack-desc +``` + +- [ ] **Step 3: Verify SBo/ is not tracked by git** + +```bash +git status +``` + +Expected: `SBo/` does not appear. + +- [ ] **Step 4: Revert the test change** + +```bash +git revert HEAD --no-edit +``` + +- [ ] **Step 5: Clean up test archive** + +```bash +rm SBo/kitty-bin.tar.gz +``` diff --git a/.extras/docs/superpowers/specs/2026-03-31-opencode-bin-slackbuild-design.md b/.extras/docs/superpowers/specs/2026-03-31-opencode-bin-slackbuild-design.md new file mode 100644 index 0000000..e3120a5 --- /dev/null +++ b/.extras/docs/superpowers/specs/2026-03-31-opencode-bin-slackbuild-design.md @@ -0,0 +1,222 @@ +# opencode-bin SlackBuild — Design Spec + +**Date:** 2026-03-31 + +--- + +## Overview + +Package `opencode` (AI coding agent CLI) as `opencode-bin` by repackaging the +official pre-built binaries from GitHub releases. No compilation required — +the upstream Go binary is fully statically linked (`CGO_ENABLED=0`). + +- **Upstream:** https://github.com/opencode-ai/opencode +- **Version at time of writing:** 0.0.55 +- **License:** MIT + +--- + +## Files + +``` +opencode-bin/ +├── opencode-bin.SlackBuild +├── opencode-bin.info +├── README +└── slack-desc +``` + +Plus an entry in the repo-level `nvchecker.toml`. + +--- + +## opencode-bin.SlackBuild + +Follows the binary-repackaging pattern used by `kitty-bin` and `hugo` in this repo. + +Key decisions: +- `PRGNAM=opencode-bin`; installed binary is named `opencode` (upstream command name) +- Supports `x86_64` (tarball: `opencode-linux-x86_64.tar.gz`) and `aarch64` (tarball: `opencode-linux-arm64.tar.gz`); all other arches exit with error +- Binary installed to `/usr/bin/opencode` +- Docs (`LICENSE`, `README.md`) installed to `/usr/doc/opencode-bin-$VERSION/` +- No `doinst.sh` — no system integration needed +- No stripping (pre-built binary; stripping a Go binary is harmless but unnecessary) + +```bash +#!/bin/bash + +# Slackware build script for opencode-bin + +# Copyright 2026 danix <danix@danix.xyz> +# All rights reserved. +# +# Redistribution and use of this script, with or without modification, is +# permitted provided that the following conditions are met: +# +# 1. Redistributions of this script must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# +# THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED +# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO +# EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF +# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +cd $(dirname $0) ; CWD=$(pwd) + +PRGNAM=opencode-bin +VERSION=${VERSION:-0.0.55} +BUILD=${BUILD:-1} +TAG=${TAG:-_SBo} +PKGTYPE=${PKGTYPE:-tgz} + +if [ -z "$ARCH" ]; then + case "$( uname -m )" in + arm*) ARCH=arm ;; + *) ARCH=$( uname -m ) ;; + esac +fi + +if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then + echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE" + exit 0 +fi + +TMP=${TMP:-/tmp/SBo} +PKG=$TMP/package-$PRGNAM +OUTPUT=${OUTPUT:-/tmp} + +if [ "$ARCH" = "x86_64" ]; then + SRCARCH="x86_64" +elif [ "$ARCH" = "aarch64" ]; then + SRCARCH="arm64" +else + echo "$ARCH is not supported." + exit 1 +fi + +set -e + +rm -rf $PKG +mkdir -p $TMP $PKG $OUTPUT +cd $TMP +rm -rf $PRGNAM-$VERSION +mkdir -p $PRGNAM-$VERSION +tar xvf $CWD/opencode-linux-$SRCARCH.tar.gz -C $PRGNAM-$VERSION +cd $PRGNAM-$VERSION +chown -R root:root . +find -L . \ + \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 \ + -o -perm 511 \) -exec chmod 755 {} \; -o \ + \( -perm 666 -o -perm 664 -o -perm 640 -o -perm 600 -o -perm 444 \ + -o -perm 440 -o -perm 400 \) -exec chmod 644 {} \; + +mkdir -p $PKG/usr/bin +install -m 0755 opencode $PKG/usr/bin/opencode + +mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION +cp -a LICENSE README.md $PKG/usr/doc/$PRGNAM-$VERSION +cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild + +mkdir -p $PKG/install +cat $CWD/slack-desc > $PKG/install/slack-desc + +cd $PKG +/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE +``` + +--- + +## opencode-bin.info + +``` +PRGNAM="opencode-bin" +VERSION="0.0.55" +HOMEPAGE="https://github.com/opencode-ai/opencode" +DOWNLOAD="UNSUPPORTED" +MD5SUM="" +DOWNLOAD_x86_64="https://github.com/opencode-ai/opencode/releases/download/v0.0.55/opencode-linux-x86_64.tar.gz" +MD5SUM_x86_64="" +REQUIRES="" +MAINTAINER="danix" +EMAIL="danix@danix.xyz" +``` + +Note: `MD5SUM_x86_64` will be filled by running `sbofixinfo opencode-bin/` after downloading +the source with `sbodl`. + +--- + +## README + +``` +opencode-bin is a pre-built binary repackage of opencode, a powerful AI +coding agent built for the terminal. It supports multiple LLM providers +including OpenAI, Anthropic, Google Gemini, and others. + +No compilation is required; the official upstream binary is statically +linked and has no runtime library dependencies. + +To use opencode, you need an API key for at least one supported LLM +provider. Set the appropriate environment variable (e.g. OPENAI_API_KEY, +ANTHROPIC_API_KEY) or configure it via opencode's interactive setup. + +Homepage: https://github.com/opencode-ai/opencode + +NOTE FOR aarch64 USERS: The aarch64 tarball is not listed in the .info +file (not a standard SBo field). Download it manually before building: + wget https://github.com/opencode-ai/opencode/releases/download/v0.0.55/opencode-linux-arm64.tar.gz +``` + +--- + +## slack-desc + +``` +# HOW TO EDIT THIS FILE: +# The "handy ruler" below makes it easier to edit a package description. +# Line up the first '|' above the ':' following the base package name, and +# the '|' on the right side marks the last column you can put a character in. +# You must make exactly 11 lines for the formatting to be correct. It's also +# customary to leave one blank line after the name. + + |-----handy-ruler------------------------------------------------------| +opencode-bin: opencode-bin (AI coding agent for the terminal) +opencode-bin: +opencode-bin: opencode is a powerful AI coding agent built for the terminal. +opencode-bin: It supports multiple LLM providers including OpenAI, Anthropic, +opencode-bin: Google Gemini, and others via simple configuration. +opencode-bin: +opencode-bin: This package ships the official pre-built binary. No compilation +opencode-bin: is required. API keys for a supported LLM provider are needed +opencode-bin: at runtime. +opencode-bin: +opencode-bin: Homepage: https://github.com/opencode-ai/opencode +``` + +--- + +## nvchecker.toml entry + +```toml +[opencode-bin] +source = "github" +github = "opencode-ai/opencode" +use_latest_release = true +``` + +--- + +## Maintenance + +When a new version is released: +1. Update `VERSION` in `.SlackBuild` and `.info` +2. Run `sbofixinfo opencode-bin/` to refresh checksums +3. Run `sbodl opencode-bin/` to verify the download +4. Run `sbolint opencode-bin/` to check for issues +5. Update `README` if the aarch64 download URL version number changed diff --git a/.extras/docs/superpowers/specs/2026-03-31-readme-packages-table-design.md b/.extras/docs/superpowers/specs/2026-03-31-readme-packages-table-design.md new file mode 100644 index 0000000..ea81579 --- /dev/null +++ b/.extras/docs/superpowers/specs/2026-03-31-readme-packages-table-design.md @@ -0,0 +1,54 @@ +# README Packages Table — Design Spec + +**Date:** 2026-03-31 + +--- + +## Goal + +Add a static "Packages" section to `README.md` listing all packages with their +build status, SBo presence, repo version, and latest upstream version. + +--- + +## Table Structure + +Placed between "Repository Structure" and "Usage" in `README.md`. + +| Column | Content | +|--------|---------| +| **Package** | Plain package name | +| **-current** | ✅ / ❌ / `not tested` | +| **15.0** | ✅ / ❌ / `not tested` | +| **SBo** | `[name](https://slackbuilds.org/...)` or ❌ | +| **Version** | Version from `.info` file | +| **Latest** | Latest upstream version (fetched 2026-03-31) | + +--- + +## Package Data + +| Package | -current | 15.0 | SBo | Version | Latest | +|---------|----------|------|-----|---------|--------| +| discord | not tested | not tested | [discord](https://slackbuilds.org/repository/15.0/network/discord/) | 0.0.130 | 0.0.131 | +| hstr | not tested | not tested | [hstr](https://slackbuilds.org/repository/15.0/system/hstr/) | 3.1 | 3.2 | +| hugo | not tested | not tested | [hugo](https://slackbuilds.org/repository/15.0/development/hugo/) | 0.159.1 | 0.159.1 | +| kitty-bin | not tested | not tested | ❌ | 0.46.2 | 0.46.2 | +| llama.cpp-vulkan | not tested | not tested | ❌ | b8581 | b8590 | +| obsidian | not tested | not tested | [obsidian](https://slackbuilds.org/repository/15.0/development/obsidian/) | 1.12.7 | 1.12.7 | +| qarma | not tested | not tested | ❌ | 1.0.0 | 1.1.0 | +| syncthing | not tested | not tested | [syncthing](https://slackbuilds.org/repository/15.0/network/syncthing/) | 2.0.15 | 2.0.15 | + +Notes: +- `kitty-bin` SBo page returned 404 — marked ❌, verify manually +- `llama.cpp-vulkan` and `qarma` have no SBo entry +- Latest versions fetched via web search on 2026-03-31; re-run search when updating + +--- + +## Maintenance + +Update the table manually when: +- A build is tested → replace `not tested` with ✅ or ❌ +- A package is bumped → update Version and Latest columns +- A package is submitted to SBo → replace ❌ with a link diff --git a/.extras/docs/superpowers/specs/2026-03-31-sbo-archive-hook-design.md b/.extras/docs/superpowers/specs/2026-03-31-sbo-archive-hook-design.md new file mode 100644 index 0000000..838d85b --- /dev/null +++ b/.extras/docs/superpowers/specs/2026-03-31-sbo-archive-hook-design.md @@ -0,0 +1,65 @@ +# SBo Submission Archive Hook — Design Spec + +**Date:** 2026-03-31 + +--- + +## Goal + +A `post-commit` git hook that automatically offers to create a SBo-ready submission +archive whenever a package's `.SlackBuild` file is added or modified in a commit. + +--- + +## Detection + +Uses `git diff-tree --no-commit-id -r --name-status HEAD` to list files changed in +the current commit. Filters for entries with status `A` (added) or `M` (modified) +whose filename matches `*.SlackBuild` at exactly one directory depth +(e.g. `hugo/hugo.SlackBuild`). Each match yields one package name (the parent directory). + +Multiple packages in a single commit are handled sequentially. + +--- + +## Per-Package Flow + +1. Print header: `==> Package: <name>` +2. List all files inside `<repo-root>/<pkg>/` recursively, shown as relative paths +3. Prompt: `Create SBo archive for '<pkg>'? [y/N]` + - Input is read from `/dev/tty` so the prompt works correctly inside a git hook +4. On `y`/`Y`: create the archive (see below) +5. On anything else: skip silently and continue to the next package + +--- + +## Archive + +- **Location:** `SBo/<pkg>.tar.gz` (inside repo root, not under version control) +- **Structure:** single top-level directory `<pkg>/` containing all package files flat +- **Command:** `tar -czf "$SBO_DIR/$pkg.tar.gz" -C "$REPO_ROOT" "$pkg"` +- `SBo/` is created automatically if it does not exist +- Repeated archives overwrite the previous one (no version suffix — matches SBo naming conventions) + +--- + +## Output Directory + +`SBo/` lives at the repo root and is added to `.gitignore` so it is never committed. + +--- + +## Files Changed + +| File | Change | +|---|---| +| `.git/hooks/post-commit` | New file (created, made executable) | +| `.gitignore` | Append `SBo/` entry | + +--- + +## Out of Scope + +- Verifying checksums or linting (handled by existing pre-commit hook and manual workflow) +- Uploading or submitting to SBo directly +- Tracking which archives have already been submitted |
