todo2code

Ticket 084: Honor deterministic NL mode in workspace comparison CLI

• ID: ticket-084
• Owner: unresolved:human
• Status: DONE
• Workflow state: DONE
• Created: 2026-08-21

Goal and scope

Make t2c compare-workspace --nl-mode deterministic authoritative for both workspace pipelines and their deadline calculation. The command must run a task-file comparison without an LLM credential when every selected semantic mode is deterministic, and its help must expose the option.

Acceptance criteria

• AC-01: The human owner explicitly requested implementation and continued autonomous testing on 2026-08-21.
• AC-02: CLI --nl-mode deterministic overrides an ambient require-llm default for compare-workspace.
• AC-03: CLI help documents the accepted NL modes.
• AC-04: Focused, full Node, governance and Docker checks pass.

Participants

• Human participant: unresolved; no user-* file was created by this script.
• Agent participant: ai-codex.md

Approval gate

The user’s implementation request authorizes this bounded CLI correction. Protected exact-head Validator evidence remains the separate merge boundary.

Non-goals

• No change to pipeline, extractor, graph or comparison contracts.
• No weakening of require-llm; deterministic mode remains explicit opt-in.
• No automatic execution or merge authority.

Verification evidence

• The focused CLI suite passes 2/2 with ambient require-llm, an empty API key and explicit deterministic NL mode.
• npm run verify passes 423 tests with one existing JDK-only skip; type, module, environment, workflow, generated-analysis, structured-response and schema gates pass.
• make docker-smoke, governance and diff checks pass locally. Protected exact-head review remains pending.
• Koru correctly rejected the first published head because changing src/cli.ts exposed the file’s pre-existing handleExtract CC=22. The handler is now a small dispatcher over behavior-preserving command functions; Lizard reports no threshold violations and the focused CLI suite still passes.

Closure evidence

Protected PR #97 merged the deterministic NL-mode repair as 72a6bd1e194ef3ac6c586b329688fb2faa86be92, which is an ancestor of current protected main.

This site is open source. Improve this page.