Initial commit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

1 files changed, 57 insertions, 0 deletions

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..2ee689b
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Is
+
+`mkhintfile.sh` — bash utility for managing [slackrepo](https://idlemoor.github.io/slackrepo/) hint files. Hint files override build variables (version, download URL, checksum) for SlackBuilds.
+
+## Configuration
+
+Two paths hardcoded near top of `mkhintfile.sh` (lines 16–17):
+
+```bash
+REPO_DIR="/var/lib/sbopkg/SBo-danix/"      # SBo repository with .info files
+HINT_DIR="/etc/slackrepo/SBo-danix/hintfiles/"  # where .hint files live
+```
+
+Bash completion script has its own hardcoded copies (lines 8–9) — keep in sync when changing defaults.
+
+## Running / Testing
+
+No build step. Direct execution:
+
+```bash
+bash mkhintfile.sh --help
+bash mkhintfile.sh --list
+bash mkhintfile.sh --version 2.0.1 --hintfile mypackage
+bash mkhintfile.sh --version 1.2.3 --new mypackage
+bash mkhintfile.sh --new mypackage   # empty hint, no version
+bash mkhintfile.sh --clean
+```
+
+No test suite exists. Test manually against real `REPO_DIR`/`HINT_DIR` or with mock directories.
+
+## Key Behaviors
+
+- `--hintfile` update: backs up to `.bak`, replaces old version string globally via `sed`, re-downloads both URLs to recalculate MD5 checksums. Skips download if value is `UNSUPPORTED` or `UNTESTED`.
+- `--new` with existing `.info`: copies `.info` as template, strips `PRGNAM`, `HOMEPAGE`, `MAINTAINER`, `EMAIL`, comments out `REQUIRES`, sets `ARCH="x86_64"`.
+- `--new` when hint already exists: backs up old, creates empty skeleton.
+- Downloads go to `/tmp/mkhint/download` (single shared temp file, deleted after md5 calculation).
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | Invalid arguments |
+| 2 | File not found |
+| 3 | File already exists (unused — backup logic replaces this) |
+| 4 | wget not available |
+
+## Installation
+
+```bash
+sudo cp mkhintfile.sh /usr/local/bin/mkhintfile
+sudo cp mkhintfile.bash-completion /etc/bash-completion.d/mkhintfile
+```