jared/cc-os

Watch

Fork 0

Cover the uncovered daemon server mutants #1692

New issue

Closed

opened 2026-11-11 16:24:16 +00:00 by jared · 3 comments

jared commented

2026-11-11 16:24:16 +00:00

Owner

Problem

The second mutation pass (2026-11-09) left 94 uncovered mutants in 9 files under lib/os_sdlc/daemon/ and lib/os_sdlc/daemon.rb. No test runs the code at these mutants. An uncovered mutant is code that the suite never executes, so a change there goes unseen. Ruling 100 puts a unit test for lib/os_sdlc/<path>.rb at test/os_sdlc/<path>_test.rb.

Observed

The second mutation pass ran bin/os-sdlc-mutation-pass run . on 2026-11-09. .mutineer/pass.json lists 94 mutants in this ticket under no_coverage. A no_coverage mutant is a changed behavior that no test runs. The survivor tickets #1656 to #1664 took only the survived mutants, so no ticket covers these. Each line below gives the file, its uncovered count, and the mutation kinds.

lib/os_sdlc/daemon/exchange.rb (25): return_nil 9, statement_removal 9, condition_false 3, condition_true 3, comparison 1
lib/os_sdlc/daemon/server.rb (22): statement_removal 13, return_nil 6, boolean_literal 1, condition_false 1, condition_true 1
lib/os_sdlc/daemon/server_message.rb (12): return_nil 6, boolean_connector 1, boolean_literal 1, comparison 1, condition_false 1, condition_true 1, statement_removal 1
lib/os_sdlc/daemon.rb (10): return_nil 8, statement_removal 2
lib/os_sdlc/daemon/operations.rb (10): return_nil 5, statement_removal 2, comparison 1, condition_false 1, condition_true 1
lib/os_sdlc/daemon/procman_spec.rb (7): return_nil 4, boolean_literal 2, statement_removal 1
lib/os_sdlc/daemon/client.rb (4): return_nil 2, boolean_literal 1, statement_removal 1
lib/os_sdlc/daemon/outline_node.rb (3): return_nil 3
lib/os_sdlc/daemon/termination.rb (1): boolean_literal 1

Reproduce

n/a: the uncovered mutants come from a whole pass. Verify with a targeted run: bin/os-sdlc-mutation-pass run <files> --no-matrix.

Approach

For each listed file, write the paired unit test at test/os_sdlc/<lib path>_test.rb (ruling 100). The test must run the uncovered code and kill its mutants. Check the older test locations first (test/cops/, test/daemon/, test/lint/, test/system_model_*). A test there may already cover the file and only need a move or an extension. Where the code calls a process, use an adapter and a recorded fixture (ruling 88). Reuse test/support/process_recording.rb and the recorded_* doubles. No test starts a real process. The daemon code is socket and Procman glue. Use the fakes in test/support/fake_procman.rb.

When a mutant shows dead code (code no caller reaches), delete the code and write no test for it (ruling 107). When a mutant is equivalent (the mutant has the same behavior), rule it equivalent in a comment on this ticket with the reason. Follow plugins/os-sdlc/references/survivor-loop.md. Then verify with a targeted --no-matrix run over the files of this ticket. Do not run a whole pass.

Required work: none beyond the acceptance criteria.

Acceptance criteria

Given a targeted --no-matrix Mutineer run on the files listed in this ticket, when the run ends, then it reports no uncovered mutant and no survivor, except ones that this ticket deletes or rules equivalent with a reason.
Given a file with deleted unreachable code, when the suite runs, then it is green and no caller of the deleted code remains.

Origin

Trigger: #1683 split, 2026-11-11
Improvised this session: none
Chain: uncovered mutants ← survivor tickets #1656-#1664 took only survived mutants ← the second pass split only survivors into tickets ← DESIGN (docs/research/mutation-testing/2026-11-09-second-pass/)
Root candidate: none found; searched uncovered, no_coverage, mutant, daemon, server, socket, Procman
Where: lib/os_sdlc/daemon/ and lib/os_sdlc/daemon.rb
Parent: #1683
Session: 974224e0-190b-4ca9-814e-eb971a24f35a
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os-plugins-os-sdlc/974224e0-190b-4ca9-814e-eb971a24f35a.jsonl

VERDICT: CREATE (ticket-skeptic, 2026-11-11): child of the #1683 required split; no open ticket covers these files.

## Problem The second mutation pass (2026-11-09) left 94 uncovered mutants in 9 files under lib/os_sdlc/daemon/ and lib/os_sdlc/daemon.rb. No test runs the code at these mutants. An uncovered mutant is code that the suite never executes, so a change there goes unseen. Ruling 100 puts a unit test for `lib/os_sdlc/<path>.rb` at `test/os_sdlc/<path>_test.rb`. ## Observed The second mutation pass ran `bin/os-sdlc-mutation-pass run .` on 2026-11-09. `.mutineer/pass.json` lists 94 mutants in this ticket under `no_coverage`. A no_coverage mutant is a changed behavior that no test runs. The survivor tickets #1656 to #1664 took only the survived mutants, so no ticket covers these. Each line below gives the file, its uncovered count, and the mutation kinds. - `lib/os_sdlc/daemon/exchange.rb` (25): return_nil 9, statement_removal 9, condition_false 3, condition_true 3, comparison 1 - `lib/os_sdlc/daemon/server.rb` (22): statement_removal 13, return_nil 6, boolean_literal 1, condition_false 1, condition_true 1 - `lib/os_sdlc/daemon/server_message.rb` (12): return_nil 6, boolean_connector 1, boolean_literal 1, comparison 1, condition_false 1, condition_true 1, statement_removal 1 - `lib/os_sdlc/daemon.rb` (10): return_nil 8, statement_removal 2 - `lib/os_sdlc/daemon/operations.rb` (10): return_nil 5, statement_removal 2, comparison 1, condition_false 1, condition_true 1 - `lib/os_sdlc/daemon/procman_spec.rb` (7): return_nil 4, boolean_literal 2, statement_removal 1 - `lib/os_sdlc/daemon/client.rb` (4): return_nil 2, boolean_literal 1, statement_removal 1 - `lib/os_sdlc/daemon/outline_node.rb` (3): return_nil 3 - `lib/os_sdlc/daemon/termination.rb` (1): boolean_literal 1 ## Reproduce n/a: the uncovered mutants come from a whole pass. Verify with a targeted run: `bin/os-sdlc-mutation-pass run <files> --no-matrix`. ## Approach For each listed file, write the paired unit test at `test/os_sdlc/<lib path>_test.rb` (ruling 100). The test must run the uncovered code and kill its mutants. Check the older test locations first (`test/cops/`, `test/daemon/`, `test/lint/`, `test/system_model_*`). A test there may already cover the file and only need a move or an extension. Where the code calls a process, use an adapter and a recorded fixture (ruling 88). Reuse `test/support/process_recording.rb` and the `recorded_*` doubles. No test starts a real process. The daemon code is socket and Procman glue. Use the fakes in `test/support/fake_procman.rb`. When a mutant shows dead code (code no caller reaches), delete the code and write no test for it (ruling 107). When a mutant is equivalent (the mutant has the same behavior), rule it equivalent in a comment on this ticket with the reason. Follow `plugins/os-sdlc/references/survivor-loop.md`. Then verify with a targeted `--no-matrix` run over the files of this ticket. Do not run a whole pass. Required work: none beyond the acceptance criteria. ## Acceptance criteria 1. Given a targeted `--no-matrix` Mutineer run on the files listed in this ticket, when the run ends, then it reports no uncovered mutant and no survivor, except ones that this ticket deletes or rules equivalent with a reason. 2. Given a file with deleted unreachable code, when the suite runs, then it is green and no caller of the deleted code remains. ## Origin - Trigger: #1683 split, 2026-11-11 - Improvised this session: none - Chain: uncovered mutants ← survivor tickets #1656-#1664 took only survived mutants ← the second pass split only `survivors` into tickets ← DESIGN (`docs/research/mutation-testing/2026-11-09-second-pass/`) - Root candidate: none found; searched uncovered, no_coverage, mutant, daemon, server, socket, Procman - Where: lib/os_sdlc/daemon/ and lib/os_sdlc/daemon.rb - Parent: #1683 - Session: 974224e0-190b-4ca9-814e-eb971a24f35a - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os-plugins-os-sdlc/974224e0-190b-4ca9-814e-eb971a24f35a.jsonl VERDICT: CREATE (ticket-skeptic, 2026-11-11): child of the #1683 required split; no open ticket covers these files.

jared added the

plugin/os-sdlc

filed-by/agent

category/code-change

labels

2026-11-11 16:24:16 +00:00

jared referenced this issue

2026-11-11 16:24:32 +00:00

Cover the 388 mutants that no test runs #1683

jared commented

2026-11-11 17:40:00 +00:00

Author

Owner

Work started on branch ticket-1692 (survivor loop, paired tests).

jared commented

2026-11-11 17:46:14 +00:00

Author

Owner

Resolution

Done: Survivor loop over the 9 daemon server files in one packet; 43 tests in 8 paired files under test/os_sdlc/daemon/ and test/os_sdlc/daemon_test.rb. Fakes stand in for UNIXServer.new, Signal.trap, the connections, Procman and Client; no test opens a real socket or starts a process. No code deleted. 2 equivalent rulings: 03a7e1ad20ed (Ruby ignores the return of Server#initialize), b5c29e9ab840 (serve discards the return of Server#answer, so the rescue value is never read).

Evidence: main be60492d5 (merged). Orchestrator re-ran the packet: before 0 survivors of 55, 78 uncovered (fewer than the 94 in the 2026-11-09 pass; the remainder were covered by earlier tickets); after 0 survivors of 133, 0 uncovered (5 timeouts count as detected). Suite run twice: 5024 runs, 0 failures each; rubocop clean.

Follow-ups: none

## Resolution **Done:** Survivor loop over the 9 daemon server files in one packet; 43 tests in 8 paired files under test/os_sdlc/daemon/ and test/os_sdlc/daemon_test.rb. Fakes stand in for UNIXServer.new, Signal.trap, the connections, Procman and Client; no test opens a real socket or starts a process. No code deleted. 2 equivalent rulings: 03a7e1ad20ed (Ruby ignores the return of Server#initialize), b5c29e9ab840 (serve discards the return of Server#answer, so the rescue value is never read). **Evidence:** main be60492d5 (merged). Orchestrator re-ran the packet: before 0 survivors of 55, 78 uncovered (fewer than the 94 in the 2026-11-09 pass; the remainder were covered by earlier tickets); after 0 survivors of 133, 0 uncovered (5 timeouts count as detected). Suite run twice: 5024 runs, 0 failures each; rubocop clean. **Follow-ups:** none

jared closed this issue

2026-11-11 17:46:14 +00:00

jared referenced this issue from a commit

2026-11-11 17:46:17 +00:00

test(os-sdlc): paired tests cover the uncovered daemon server mutants (#1692)

jared referenced this issue from a commit

2026-11-11 17:46:17 +00:00

docs(status): os-sdlc history row for #1692

jared commented

2026-11-11 17:46:25 +00:00

Author

Owner

Correction to the evidence: the 2026-11-09 pass listed 94 uncovered mutants in these 9 files. The packet's first run listed 78. The cause is not known; earlier tickets did not touch these files. The packet names every test under test/daemon/, so it can run more tests than the pass credited. The final packet covers all 133 mutants in the 9 files, with 0 uncovered.

jared referenced this issue

2026-11-11 18:03:19 +00:00

Cover the 388 mutants that no test runs #1683