LEM/docs/plans/completed/cli-migration.md

CLI Migration: Manual Switch to Core Framework

Completed: 22 Feb 2026 Commit: 094e457 (refactor: migrate CLI imports from core/go to core/cli)

What Was Done

Replaced LEM's main.go — a 296-line manual switch os.Args[1] with per-command flag.FlagSet — with the Core Go framework's cli.Main() + cli.WithCommands() pattern.

Changes

• main.go reduced from 296 lines to 11 lines
• New cmd/lemcmd/ package created with 7 files:
  • lem.go — root registration (AddLEMCommands)
  • score.go — score, probe, compare, tier, agent (5 commands)
  • gen.go — distill, expand, conv (3 commands)
  • data.go — import-all, consolidate, normalize, approve (4 commands)
  • export.go — jsonl, parquet, publish, convert (4 commands)
  • mon.go — status, expand-status, inventory, coverage, metrics (5 commands)
  • infra.go — ingest, seed-influx, query, worker (4 commands)
• runScore and runProbe moved from main.go to pkg/lem/score_cmd.go (exported)
• Import paths updated from forge.lthn.ai/core/go/pkg/cli to forge.lthn.ai/core/cli/pkg/cli
• core/cli added as direct dependency; core/go becomes indirect

Command Restructuring

All 25 flat commands reorganised into 6 groups:

Group	Commands
lem score	run, probe, compare, tier, agent
lem gen	distill, expand, conv
lem data	import-all, consolidate, normalize, approve
lem export	jsonl, parquet, publish, convert
lem mon	status, expand-status, inventory, coverage, metrics
lem infra	ingest, seed-influx, query, worker

What Was Not Changed

• All pkg/lem/Run* functions — untouched
• All business logic in pkg/lem/ — untouched
• Config loading, probe loading, scoring — unchanged

Key Outcomes

• LEM now matches the Core fleet pattern (go-ml, go-devops, cli/)
• Signal handling, shell completion, grouped --help, and TUI primitives available
• Pass-through architecture: each cobra command rebuilds []string args and calls existing lem.Run*() — zero business logic changes
• Phase 2 (native cobra flags per command) remains optional, can be done incrementally