Merge pull request #5 from danixland/restructure-flat-layout

repo: flatten layout — move packages to root, extras to .extras/

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