Your Name
e969234ca5
gates / consistency-and-conventions (push) Successful in 1m28s
- lib/registry.sh: shared query API over POS_* headers (reg_scan, reg_list, reg_lookup, reg_tools_in, reg_each, reg_config_scopes/keys). Replaces per-consumer sed/grep header parsing. - bin/pos-tree + bin/pos _pos_category_help(): migrated to registry API. Category help now shows [deps: ...] annotations. Tree output preserved. - New optional headers # POS_DEPS: and # POS_EXAMPLES: in tool metadata. Added to pos-network-download (aria2c jq curl), pos-media-sync (lsblk jq), pos-system-backup (tar), pos-docker-ps (docker) as initial adopters. - scripts/gen-docs.sh: extended tools array with deps/examples fields; conditional column rendering in gen_dispatch; deps annotation in gen_tree. Fixed URL-unsafe // joiner (→ middle dot ·) and \x1f caption delimiter collision in config-ui. - bin/pos-ai-alias: rewrote activation from bash aliases (source-time-frozen) to executable wrapper scripts at ~/.local/bin. Staleness eliminated: edits apply on next invocation with no shell reload. _alias_sync() reconciliation on every subcommand, marker-guarded lifecycle, collision refusal, legacy .sh retirement. Fixed dup-table bug (option 4 no-op). - lib/config-ui.sh: @caption/@[KEY=alt] conditional captions, *providers=<tag> tagged wildcards, uniform typography tier (bold/cyan/dim), honest prompt. Active provider keys bold, inactive dimmed with reason. Backward-compatible. - bin/pos-system-uninstall: marker-scan for wrapper script cleanup. - Docs synced: AGENTS.md (new headers + registry), DOC/SCRIPTS.md (registry section + lib list), DOC/POS.md (alias wrapper activation), MAINTENANCE.md (M-024). Lint fixed: pos-ai-alias registered in INTERACTIVE_CMDS. Gates: make gen && make check && make lint = 0 FAIL, 0 WARN
60 lines
2.7 KiB
Bash
Executable File
60 lines
2.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
# ────────────────────────────────────────────────────────────────
|
|
# TEMPLATE — new `pos` CLI tool
|
|
#
|
|
# 1. Copy: cp templates/pos-tool.sh bin/pos-<category>-<command>
|
|
# 2. Header: add a `# POS:` line right after the shebang/strict-mode
|
|
# lines (single source of truth for generated docs):
|
|
# # POS: <category> <command> — one-line description
|
|
# # POS_FLAGS: --flag1 --flag2 (flag-style tools only)
|
|
# # POS_SUBCMDS: sub1 sub2 (multi-command tools only)
|
|
# # POS_DEPS: binary1 binary2 (runtime deps, optional)
|
|
# # POS_EXAMPLES: pos <tool> <args> | Description (optional)
|
|
# 3. Exec bit: chmod +x bin/pos-<category>-<command>
|
|
# 4. If it reads stdin (password/selection prompts), add it to
|
|
# INTERACTIVE_CMDS in bin/pos or its prompt breaks under the log tee.
|
|
# 5. Docs: DOC/POS.md section table + detail block (hand-written).
|
|
# The AGENT_Context tables + completion flags come from
|
|
# `make gen` — never hand-edit between GEN markers.
|
|
# 6. Deps: add apt packages to PACKAGES in preinstall.sh; non-apt
|
|
# installers → `command -v <bin> || err "install from <URL>"`.
|
|
# 7. Done: `make gen && make check`
|
|
#
|
|
# Invoked as: pos <category> <command> [args]
|
|
# ────────────────────────────────────────────────────────────────
|
|
|
|
# Robust common.sh load — works from the repo checkout AND from
|
|
# /usr/local/bin after install.sh (which copies lib/common.sh there).
|
|
source "$(dirname "$0")/../lib/common.sh" 2>/dev/null || source "$(dirname "$0")/common.sh"
|
|
|
|
# Optional runtime config (see DEV.md "Config files"):
|
|
# CONFIG_FILE="$HOME/.config/linux_post_install/<tool>.env"
|
|
|
|
usage() {
|
|
cat <<EOF
|
|
Usage: pos <category> <command> [args]
|
|
|
|
<describe what this command does>
|
|
|
|
Examples:
|
|
pos <category> <command> arg1
|
|
EOF
|
|
exit 0
|
|
}
|
|
|
|
case "${1:-}" in
|
|
-h|--help) usage ;;
|
|
esac
|
|
|
|
# ── script logic ────────────────────────────────────────────────
|
|
# Use helpers from common.sh: log / warn / err / ok / section /
|
|
# step / run (respects --dry-run) / spawn / confirm.
|
|
#
|
|
# command -v <dep> &>/dev/null || err "<dep> not found"
|
|
# run sudo <command> # dry-run aware
|
|
# log "done" # green [+] message
|
|
#
|
|
# Exit 0 on success, err() exits 1 on failure.
|