diff options
Diffstat (limited to 'docs/superpowers/specs')
3 files changed, 0 insertions, 341 deletions
diff --git a/docs/superpowers/specs/2026-03-31-opencode-bin-slackbuild-design.md b/docs/superpowers/specs/2026-03-31-opencode-bin-slackbuild-design.md deleted file mode 100644 index e3120a5..0000000 --- a/docs/superpowers/specs/2026-03-31-opencode-bin-slackbuild-design.md +++ /dev/null @@ -1,222 +0,0 @@ -# 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/docs/superpowers/specs/2026-03-31-readme-packages-table-design.md b/docs/superpowers/specs/2026-03-31-readme-packages-table-design.md deleted file mode 100644 index ea81579..0000000 --- a/docs/superpowers/specs/2026-03-31-readme-packages-table-design.md +++ /dev/null @@ -1,54 +0,0 @@ -# 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/docs/superpowers/specs/2026-03-31-sbo-archive-hook-design.md b/docs/superpowers/specs/2026-03-31-sbo-archive-hook-design.md deleted file mode 100644 index 838d85b..0000000 --- a/docs/superpowers/specs/2026-03-31-sbo-archive-hook-design.md +++ /dev/null @@ -1,65 +0,0 @@ -# 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 |