From ebb26eac2948e02def3c7ac1ac23c4ecd345a5a7 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Fri, 3 Apr 2026 18:17:29 +0200 Subject: repo: flatten layout — move packages to root, extras to .extras/ MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .../plans/2026-03-31-opencode-bin-slackbuild.md | 258 --------------------- .../plans/2026-03-31-readme-packages-table.md | 59 ----- .../plans/2026-03-31-sbo-archive-hook.md | 208 ----------------- 3 files changed, 525 deletions(-) delete mode 100644 docs/superpowers/plans/2026-03-31-opencode-bin-slackbuild.md delete mode 100644 docs/superpowers/plans/2026-03-31-readme-packages-table.md delete mode 100644 docs/superpowers/plans/2026-03-31-sbo-archive-hook.md (limited to 'docs/superpowers/plans') diff --git a/docs/superpowers/plans/2026-03-31-opencode-bin-slackbuild.md b/docs/superpowers/plans/2026-03-31-opencode-bin-slackbuild.md deleted file mode 100644 index e5009b4..0000000 --- a/docs/superpowers/plans/2026-03-31-opencode-bin-slackbuild.md +++ /dev/null @@ -1,258 +0,0 @@ -# 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 -# 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/docs/superpowers/plans/2026-03-31-readme-packages-table.md b/docs/superpowers/plans/2026-03-31-readme-packages-table.md deleted file mode 100644 index 06bbbcc..0000000 --- a/docs/superpowers/plans/2026-03-31-readme-packages-table.md +++ /dev/null @@ -1,59 +0,0 @@ -# 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/docs/superpowers/plans/2026-03-31-sbo-archive-hook.md b/docs/superpowers/plans/2026-03-31-sbo-archive-hook.md deleted file mode 100644 index 5b0a9fa..0000000 --- a/docs/superpowers/plans/2026-03-31-sbo-archive-hook.md +++ /dev/null @@ -1,208 +0,0 @@ -# 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: \t -# 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 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 -``` -- cgit v1.2.3