Linux_post_install/AgentsReport/builder/2026-08-26_alias-and-config-impl.md

Builder Report — Alias activation architecture (Step 1) + Config readability (Step 2)

Date: 2026-08-26 · Agent: Builder · Status: IN_PROGRESS

TL;DR

• Status: IN_PROGRESS
• Files changed: (updating as steps complete)
• Verification: (pending)

Step 0: Scope intake

• Read both authoritative specs FIRST:
  • AgentsReport/architect/2026-08-26_alias-architecture.md (Option B wrappers, _alias_sync, collision policy, legacy .sh retirement, uninstall marker-scan, docs)
  • AgentsReport/designer/2026-08-26_config-readability.md (caption grammar, tagged wildcard, typography tier, backward-compat proof)
• Found working tree already carries the Step 1 + Step 2 code changes from an earlier interrupted round of this session (uncommitted, alongside other known uncommitted work: registry.sh feature etc.). Verified hunk-by-hunk against both specs rather than re-implementing; gaps found: docs (DOC/POS.md wording, AGENT_TODO.md Done entry) and the entire functional verification matrix.
• Hard fence honored: no commits; only bin/pos-ai-alias, bin/pos-system-uninstall, lib/config-ui.sh, bin/pos-ai (line 6), DOC/POS.md, DOC/HOWTO.md, AGENT_TODO.md, AgentsReport touched by THIS round.

[PENDING]