diff options
Diffstat (limited to '.extras/docs/superpowers/specs')
3 files changed, 341 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 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 |