修复覆盖率问题

[BetterAndBetterII]

Run make all
make setup
make[1]: Entering directory '/home/runner/work/symphony/symphony/elixir'
mix setup

• creating /home/runner/.local/share/mise/installs/elixir/1.19.5-otp-28/.mix/archives/hex-2.3.2-otp-28
  Resolving Hex dependencies...
  Resolution completed in 0.141s
  Unchanged:
  bandit 1.10.3
  bunt 1.0.0
  cc_precompiler 0.1.11
  credo 1.7.16
  date_time_parser 1.3.0
  decimal 2.3.0
  dialyxir 1.4.7
  elixir_make 0.9.0
  erlex 0.2.8
  file_system 1.1.1
  finch 0.21.0
  fine 0.1.4
  floki 0.38.0
  hpax 1.0.3
  jason 1.4.4
  kday 1.1.0
  lazy_html 0.1.10
  mime 2.0.7
  mint 1.7.1
  nimble_options 1.1.1
  nimble_pool 1.1.0
  phoenix 1.8.4
  phoenix_html 4.3.0
  phoenix_live_view 1.1.25
  phoenix_pubsub 2.2.0
  phoenix_template 1.0.4
  plug 1.19.1
  plug_crypto 2.1.1
  req 0.5.17
  solid 1.2.2
  telemetry 1.3.0
  thousand_island 1.4.3
  websock 0.5.3
  websock_adapter 0.5.9
  yamerl 0.10.0
  yaml_elixir 2.12.0
• creating /home/runner/.local/share/mise/installs/elixir/1.19.5-otp-28/.mix/elixir/1-19-otp-28/rebar3
  All dependencies have been fetched
  make[1]: Leaving directory '/home/runner/work/symphony/symphony/elixir'
  make build
  make[1]: Entering directory '/home/runner/work/symphony/symphony/elixir'
  mix build
  Compiling 25 files (.ex)
  Generated symphony_elixir app
  Generated escript bin/symphony with MIX_ENV=dev
  make[1]: Leaving directory '/home/runner/work/symphony/symphony/elixir'
  make fmt-check
  make[1]: Entering directory '/home/runner/work/symphony/symphony/elixir'
  mix format --check-formatted
  make[1]: Leaving directory '/home/runner/work/symphony/symphony/elixir'
  make lint
  make[1]: Entering directory '/home/runner/work/symphony/symphony/elixir'
  mix lint
  specs.check: all public functions have @SPEC or exemption
  Checking 63 source files (this might take a while) ...

Please report incorrect results: https://github.com/rrrene/credo/issues

Analysis took 2.3 seconds (0.08s to load, 2.2s running 69 checks on 63 files)
1294 mods/funs, found no issues.

Use mix credo explain to explain issues, mix credo --help for options.
make[1]: Leaving directory '/home/runner/work/symphony/symphony/elixir'
make coverage
make[1]: Entering directory '/home/runner/work/symphony/symphony/elixir'
mix test --cover
Compiling 41 files (.ex)
Generated symphony_elixir app
Cover compiling modules ...
Running ExUnit with seed: 431015, max_cases: 8

.......................................................................................................................................................................................................................................
Finished in 10.4 seconds (1.4s async, 9.0s sync)
231 tests, 0 failures

Generating cover results ...

Percentage	Module
50.00%	SymphonyElixir.Version
100.00%	Mix.Tasks.PrBody.Check
100.00%	Mix.Tasks.Specs.Check
100.00%	Mix.Tasks.Workspace.BeforeRemove
100.00%	SymphonyElixir
100.00%	SymphonyElixir.Application
100.00%	SymphonyElixir.Config.GitHubAuth
100.00%	SymphonyElixir.DefaultWorkflow.Bootstrap.GuidedWorkflow
100.00%	SymphonyElixir.DefaultWorkflow.Bootstrap.Owner
100.00%	SymphonyElixir.DefaultWorkflow.Bootstrap.Project
100.00%	SymphonyElixir.Linear.Adapter
100.00%	SymphonyElixir.PromptBuilder
100.00%	SymphonyElixir.Tracker
100.00%	SymphonyElixir.Tracker.Issue
100.00%	SymphonyElixir.Tracker.Memory
100.00%	SymphonyElixir.Tracker.StateCount
100.00%	SymphonyElixir.Workflow
100.00%	SymphonyElixir.WorkflowStore
100.00%	SymphonyElixir.WorkflowStore.State
100.00%	SymphonyElixirWeb.ObservabilityPubSub
------------	---------------------------------------------------------
99.49%	Total

Coverage test failed, threshold not met:

Coverage:   99.49%
Threshold: 100.00%

Generated HTML coverage results in "cover" directory
make[1]: *** [Makefile:27: coverage] Error 3
make[1]: Leaving directory '/home/runner/work/symphony/symphony/elixir'
make: *** [Makefile:41: ci] Error 2
Error: Process completed with exit code 2.

[BetterAndBetterII]

Codex Workpad

gary-run-box:/home/gary/code/symphony-workspaces/BetterAndBetterII_symphony_19@8c1413be03

Plan

• 1. 同步工作分支并记录启动现场
  • 1.1 检查当前分支/PR 关联与是否需要新建分支
  • 1.2 按 pull 流程同步 origin/main，并把证据写入 Notes
• 2. 复现覆盖率失败并完成影响面分析
  • 2.1 运行覆盖率相关验证，记录准确的失败信号与 root cause
  • 2.2 识别需要修改的模块、测试边界、兼容性与回滚点
• 3. 产出可评审规范并准备 draft PR
  • 3.1 更新 SPEC.md，写清行为、边界条件、失败模式、实现路线与 Test Plan
  • 3.2 提交 Spec 变更并创建/更新 draft PR
• 4. 落地 SymphonyElixir.Version 覆盖率修复
  • 4.1 将原始 :vsn 元数据解析收敛到单一标准化边界，保持 current/0 返回字符串
  • 4.2 添加 binary / charlist / fallback 的定向测试，并保留 current/0 smoke 覆盖
• 5. 完成 land 流程并收尾 GitHub 元数据
  • 5.1 提交并推送实现变更，清扫 PR draft/checks/反馈状态
  • 5.2 在最新检查全绿后合并 PR，并把项目状态更新到 Done

Acceptance Criteria

• make -C elixir coverage 不再因覆盖率阈值失败，覆盖率达到 100.00%
• make -C elixir all 通过，且不通过降低覆盖率阈值或加入应付测试的生产代码来规避问题
• PR Fix SymphonyElixir.Version coverage gate #20 退出 draft，最新提交的 GitHub checks 全绿，可安全进入 squash merge

Validation

• 定向测试: cd elixir && mix test test/symphony_elixir/version_test.exs
• 覆盖率门禁: make -C elixir coverage
• 全量 Elixir 门禁: make -C elixir all
• GitHub checks: gh pr checks --watch 20

Notes

• 2026-03-06 17:30 CST - GitHub Project item state moved from Todo to Spec; initialized workpad for issue 修复覆盖率问题 #19.
• 2026-03-06 17:32 CST - pull skill evidence: merge source origin/main + git pull --ff-only origin main; result clean; HEAD fa43e68967.
• 2026-03-06 17:32 CST - gh pr view --json state on main returned no linked PR state; created fresh spec branch fix/gar-19-version-coverage from synced main.
• 2026-03-06 17:35 CST - Reproduced the issue with make -C elixir coverage: 231 tests passed, total coverage stayed at 99.49%, and SymphonyElixir.Version was the only non-100% module at 50.00%.
• 2026-03-06 17:41 CST - Confirmed root cause with cd elixir && MIX_ENV=test mix run --no-start -e 'IO.inspect(...)': Application.spec(:symphony_elixir, :vsn) returns ~c"0.3.0" in the current test runtime, so the existing suite covers only the charlist branch while binary and fallback branches remain unexecuted.
• 2026-03-06 17:44 CST - Updated SPEC.md section 21 with the coverage-remediation scope, affected boundaries (Types/Config/Repo unaffected; Runtime + focused tests affected), milestones, validation plan, and compatibility/rollback notes.
• 2026-03-06 17:39-17:45 CST - Created commits 087d9b4dbc, 30560c9, 8c1413be03; pushed branch fix/gar-19-version-coverage, created draft PR #20, added the required symphony label, and resolved the initial Gemini spec-review comment.
• 2026-03-06 18:02 CST - Issue project status is already Merging, but PR Fix SymphonyElixir.Version coverage gate #20 is still draft and its latest remote make-all run is red; treating this as a status/content mismatch and taking the safer land path by implementing the approved fix before merge.
• 2026-03-06 18:08 CST - Implemented SymphonyElixir.Version.normalize/1 as the single raw-metadata parsing boundary, added version_test.exs, and reran the targeted test, make -C elixir coverage, and make -C elixir all locally; all passed with total coverage restored to 100.00%.

Confusions

• Branch naming examples in WORKFLOW.md map GitHub issue identifiers to gar-*; followed the existing repository convention and used fix/gar-19-version-coverage for issue #19.