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

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

1 files changed, 222 insertions, 0 deletions

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