Skip to content

ArghBox 0.1.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 23:45
· 6 commits to main since this release

The first public version.

Added

  • Widget: a Feedback tab (loader under 4 KB gzipped) and a dialog loaded on first intent, with a public list, voting, search, tag filters, statuses, owner comments, an add form with similar-entry suggestions, and "Your arghs". Shadow DOM, light and dark themes, a full-screen sheet on phones, keyboard and screen-reader support, funny and neutral wording, translatable strings, and a JavaScript API with #arghbox links.
  • Backend: a PHP 8.1+ and SQLite API for shared hosting from one folder. Cloudflare Turnstile, hashed IPs and voter keys, rate limits, honeypot, CORS allow-list and an Atom feed. No visitor cookies.
  • Health check (api.php?action=health): version, database location, Turnstile and proxy-header state, and a warnings list for the owner. It does not warn that the IP header is ignored when the web server has already put the visitor's address in REMOTE_ADDR (LiteSpeed on Hostinger behind Cloudflare).
  • Admin page: statuses, public comments and private notes, private owner tasks, merge, reject, tags, a full action log with undo, and exports as JSON, CSV and Jira CSV.
  • AI triage: a Claude Code skill (arghbox-triage) that rejects spam, merges duplicates, tags and flags, with checked verdicts applied in one transaction, a confidence gate and whole-run undo. No paid AI calls.
  • MCP server (mcp.php): search, triage and update the box from Claude Code, Cursor and VS Code, with a read-only token and no delete tool.
  • npm package arghbox: npx arghbox install copies the server folder and the triage skill into a site (safe to re-run from a prebuild script, never touches config.php or data), npx arghbox secrets makes the tokens, and import { version } from 'arghbox' gives the version for the script tag. Published with npm provenance by the release workflow, which also attaches the zips with build provenance attestations to the GitHub Release.
  • Reports and blocks: visitors can report a published entry (spam, rude or abusive, off topic, other). Three reports from different people (report_hide_at) hide it until it is reviewed. The admin page has a Reported list (open reports on published, pending or flagged entries), "Keep it (dismiss reports)" for public entries and "Put it back (dismiss reports)" for hidden ones, a list of blocked authors, Block author and Unblock author. Blocked authors' new posts are rejected quietly (limits.block_days). Triage decides reported entries (keep or reject) and may set block_author for clear spam or abuse. The MCP server has arghbox_dismiss_reports, arghbox_block_author and arghbox_unblock_author. New config: contact_url (a "Contact" link in the dialog), report_hide_at, limits.reports_per_hour and limits.block_days. Schema version 4.
  • Mobile apps: arghbox/app.html shows the whole board full screen in an app's WebView, with no sign-in, URL parameters, context.app (platform and version, shown on the admin page) and a bridge that posts events (open, close, add, vote and link, for external links) to Swift, Kotlin, React Native and Flutter. An opt-in app_pass helps WebViews that cannot pass Turnstile. See docs/mobile.md, with an App Store guideline 1.2 and Google Play checklist.
  • Tools: a local dev server with a demo site, secret generation, install and release-zip scripts, a seed loader, a size check, a README screenshot capture, and an owner-only translation script.
  • Docs: install guide, configuration, triage, MCP, integrations, translations and API reference, plus a trademark policy (TRADEMARKS.md).

Install with npm install --save-dev arghbox@0.1.0 and npx arghbox install --public <your web root> --skill, or download arghbox-0.1.0.zip below and upload its arghbox folder. Every file has a build provenance attestation: gh attestation verify <file> --repo BinaryBananaLLC/ArghBox.