secubox/secubox-deb
1
0
Fork 0
mirror of https://github.com/CyberMind-FR/secubox-deb.git synced 2026-07-28 21:17:36 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

feat(publishctl): rename metactl -> publishctl + add post noun (closes #180) (#189)
Some checks failed
License Headers / check (push) Failing after 5s
Details

Browse Source 
Naming consistency with the rest of the SecuBox CTL grammar:
  haproxyctl / giteactl / mitmproxyctl / dropletctl / metablogizerctl /
  streamlitctl / streamforgectl / publishctl

The old metactl name stays as a symlink so existing scripts keep working.
Added `post` noun dispatch that wraps the existing flat verbs:

  publishctl post upload <file.zip>     (= publishctl upload, kept as alias)
  publishctl post publish <name>
  publishctl post list / download / qrcode / health

This closes the publishing-layer grammar gap and aligns with #181
(dropletctl file), #184 (metablogizerctl site/tor), and the rest of
the modular ctl pattern documented in CLAUDE.md.

Co-authored-by: CyberMind-FR <gandalf@Gk2.net>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
CyberMind 2026-05-17 11:38:46 +02:00 committed by GitHub
parent 199e52b5cb
commit 81168ff49a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 68 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
packages/secubox-publish/bin/metactl → packages/secubox-publish/bin/publishctl
View File

@ -1,9 +1,20 @@
#!/usr/bin/env bash
# SecuBox MetaCtl — ISP Home Publish CLI
# CyberMind — https://cybermind.fr
# SPDX-License-Identifier: LicenseRef-CMSD-1.0
# Copyright (c) 2026 CyberMind — Gérald Kerma <devel@cybermind.fr>
#
# publishctl — SecuBox ISP Home Publish CLI (issue #180)
#
# Renamed from `metactl` for naming consistency with the rest of the
# SecuBox grammar (haproxyctl/giteactl/mitmproxyctl/metablogizerctl/
# dropletctl/streamlitctl/streamforgectl). The old `metactl` name remains
# as a symlink for backward compatibility — to drop in a future major.
#
# Flat verbs are now also reachable under the `post` noun dispatch
# for grammar consistency (publishctl post upload <file>, etc). Flat
# top-level verbs preserved for backward compatibility.
set -euo pipefail
VERSION="1.0.0"
VERSION="2.0.0"
API_BASE="${SECUBOX_API_BASE:-http://127.0.0.1/api/v1/publish}"
METABLOGIZER_API="${SECUBOX_METABLOGIZER_API:-http://127.0.0.1/api/v1/metablogizer}"
TOKEN_FILE="${SECUBOX_TOKEN_FILE:-/etc/secubox/secrets/jwt-token}"
@ -408,8 +419,39 @@ cmd_health() {
fi
}
# post noun dispatch (issue #180 — grammar consistency, parallel to
# `giteactl repo`, `mitmproxyctl route`, `dropletctl file`, etc).
# Delegates to the existing flat cmd_* functions; both grammars supported.
cmd_post() {
local act="${1:-}"; shift || true
case "$act" in
upload) cmd_upload "$@" ;;
publish) cmd_publish "$@" ;;
unpublish) cmd_unpublish "$@" ;;
list|ls) cmd_list ;;
download) cmd_download "$@" ;;
qrcode|qr) cmd_qrcode "$@" ;;
health) cmd_health "$@" ;;
*)
cat <<EOF
Post commands (issue #180):
post upload <file.zip> [name] [--domain=D] [--auto-publish]
post publish <name>
post unpublish <name>
post list
post download <name> [output.zip]
post qrcode <name>
post health <domain>
EOF
;;
esac
}
# Main
case "${1:-help}" in
# noun-verb grammar (issue #180)
post) shift; cmd_post "$@" ;;
# flat verbs (backward-compat — same callbacks)
upload) shift; cmd_upload "$@" ;;
publish) shift; cmd_publish "$@" ;;
unpublish) shift; cmd_unpublish "$@" ;;
@ -419,10 +461,10 @@ case "${1:-help}" in
status) cmd_status ;;
health) shift; cmd_health "$@" ;;
-h|--help|help) usage ;;
-v|--version) echo "metactl v${VERSION}" ;;
-v|--version) echo "publishctl v${VERSION}" ;;
*)
echo -e "${RED}Unknown command:${NC} $1"
echo "Run 'metactl --help' for usage"
echo "Run 'publishctl --help' for usage"
exit 1
;;
esac

17
packages/secubox-publish/debian/changelog
View File

@ -1,3 +1,20 @@
secubox-publish (2.0.0-1~bookworm1) bookworm; urgency=medium
* Rename `metactl` -> `publishctl` for naming consistency with the rest
of the SecuBox ctl grammar (issue #180). The `metactl` name remains
as a symlink for backward compatibility — to drop in a future major.
* publishctl: add `post` noun dispatch so verbs are grouped under a
coherent <noun> <verb> schema parallel to giteactl/dropletctl/
metablogizerctl. Flat top-level verbs preserved as alias.
publishctl post upload <file.zip> [name] [--auto-publish]
publishctl post publish/unpublish <name>
publishctl post list/download/qrcode/health ...
* Bumped to 2.0.0 (CLI surface rename).
-- Gerald KERMA <devel@cybermind.fr> Sun, 17 May 2026 11:38:19 +0200
secubox-publish (1.0.0-1~bookworm1) bookworm; urgency=medium
* Initial release

6
packages/secubox-publish/debian/rules
View File

@ -12,9 +12,11 @@ override_dh_auto_install:
# Modular nginx config
install -d debian/secubox-publish/etc/nginx/secubox.d
[ -f nginx/publish.conf ] && cp nginx/publish.conf debian/secubox-publish/etc/nginx/secubox.d/ || true
# CLI tool
# CLI tool — primary `publishctl` + `metactl` symlink for backward compat (#180)
install -d debian/secubox-publish/usr/sbin
[ -f bin/metactl ] && install -m 755 bin/metactl debian/secubox-publish/usr/sbin/metactl || true
[ -f bin/publishctl ] && install -m 755 bin/publishctl debian/secubox-publish/usr/sbin/publishctl || true
[ -f debian/secubox-publish/usr/sbin/publishctl ] && \
ln -sf publishctl debian/secubox-publish/usr/sbin/metactl || true
# Plugins directory
install -d debian/secubox-publish/srv/secubox/modules/publish/plugins
[ -d plugins ] && cp -r plugins/. debian/secubox-publish/srv/secubox/modules/publish/plugins/ || true