e969234ca5
feat: command registry, alias wrapper scripts, config-ui readability
...
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
2026-08-27 02:30:27 -04:00
23ec322ef1
docs: document the convention lint gate (make lint) in AGENTS/DEV/AGENT_Context
...
- DEV.md: new 'Convention Lint Gate' section enumerating all check classes
(shebang/strict-mode, exec bits, POS headers, -h|--help after deps guards,
INTERACTIVE_CMDS, POS.md coverage, plugins/apps/units/wrappers/secrets/env
seams) + 'refine never weaken' rule; test step and definition of done now
include make lint (0 FAIL / 0 WARN)
- AGENTS.md: make gen -> make check -> make lint is the definition of done;
both gates described, lint not in the pre-commit hook
- AGENT_Context_Project.md: How-to-modify step 7 updated
- MAINTENANCE.md: next-session brief uses make lint; gate commit marked DONE
2026-08-14 15:17:02 -04:00
5ef38dc46f
fix: resolve all 23 MAINTENANCE audit tickets
...
- deps guards before -h|--help in docker-health/ps, network-scan,
usb-server, media-mp3/mp4 (--dry-run pre-scan kept); system-firewall
gains usage()/--help; autostart/usb-automount get flags.sh + template
- install.sh: normalize N-M range syntax in --steps
- bin/pos: INTERACTIVE_CMDS += docker-compose docker-vbox network-hotspot
- common.sh: canonical XDG-aware CONFIG_DIR + DIM color var; notify.sh
stderr fallback; ent_plugin_* registry renames (runtime plugin API kept)
- docker-compose SCALE_DIR/CONFIG_ENV env seams; ffmpeg in PACKAGES;
scrcpy.sh exec bit
- docs: health is console-only (--send/--markdown removed), POS.md file
refs for config/tree/entertainment, DEV.md no-guard exception, docmap/
filetable regenerated (make gen), hand-maintained line rows bumped
- add scripts/lint-conventions.sh gate + Makefile lint target; record
all VERIFIED outcomes in MAINTENANCE.md; AGENT_TODO Done entry
(2026-08-14)
- gates: make gen/check/lint all green (0 FAIL, 0 WARN); bash -n sweep
clean; restricted-PATH dep tests + step-matrix dry-runs verified
2026-08-14 12:57:00 -04:00
Your Name