LPM CLI
Skip to Content

lpm env repair

Find damage in the newer data that LPM keeps next to a project's env values, and repair it.

lpm env repair finds damage in the newer data of an env project and repairs it. The values of the project do not change.

lpm env repair [--yes] [--json]

# Show the damage, then confirm the repair
lpm env repair

# Repair without a confirmation, for example in a script
lpm env repair --yes

LPM keeps newer data next to the values of a project, for example local history and the personal overrides that LPM Vault keeps for this computer. If this data is damaged, a command that needs it stops with a message like this:

This env project's newer data is damaged (missing record "overrides"). Repair it: lpm env repair

On macOS, the message also says that you can repair the project in LPM Vault. Run lpm env repair from the project directory, or from any directory below it.

Review and confirm

The command shows each problem first, with the repair for it:

! this env project's newer data is damaged:
    missing record "overrides"
      repair: remove personal overrides and the records only it uses

In an interactive terminal, the command then asks you to confirm. Without a terminal, it repairs nothing unless you add --yes. If nothing is damaged, the command says so and changes nothing.

Repairs

RepairEffect
Remove a featureDeletes one damaged feature, such as local history or personal overrides, and the records that only this feature uses. The other newer data stays.
Delete unlisted recordsDeletes the records that no feature of the project uses.
Discard the newer dataDeletes all newer data of the project. LPM uses this repair when it cannot read which features the project has, or when an interrupted change cannot be finished. It is then the only repair.

Each repair deletes the damaged data, and it cannot restore that data. The values of the project stay as they are. If a repair deletes local history, history starts again at the next change, without the earlier entries.

CLI approval on macOS

Damage to the CLI approval of a project is different. lpm env repair shows the problem, but only LPM Vault can set CLI approval again. To correct it, switch the CLI approval of the project in LPM Vault. The command fails until you do.

JSON output

lpm env repair --json
lpm env repair --json --yes

Without --yes, --json reports the problems, repairs nothing, and exits with status 1:

{
  "success": false,
  "problems": [
    {
      "damage": "missing record \"overrides\"",
      "repair": { "action": "removeFeature", "feature": "overrides" }
    }
  ],
  "repaired": []
}

With --yes, the command runs the repairs and lists them in repaired.

FieldMeaning
successtrue when nothing is damaged, or when the repairs ran.
problems[].damageA description of the damage.
problems[].repair.actionremoveFeature with a feature, removeUnlisted, or discardProject. It is null when only LPM Vault can repair the problem.
repairedThe repairs that ran, in the same form as repair.

Flags

FlagEffect
--yesRepair without a confirmation. Without a terminal, the command needs it.
--jsonPrint the result as JSON.

See also