pbakaus/impeccable · error

build-phase: unknown command {other}

Error message

build-phase: unknown command {other}

What it means

The build-phase command dispatcher falls through to a catch-all arm when the subcommand verb does not match any known build-phase command. It prints the unrecognized verb to stderr and exits 1. This is a CLI usage error, not an internal failure.

Source

Thrown at crates/comp-verbs/src/build_phase.rs:2036

                    open_before.join(", "),
                    if open_before.len() == 1 { "is" } else { "are" }
                ));
                return 2;
            }
            let phase = state.get("phase").and_then(Value::as_str).unwrap_or("").to_string();
            state.as_object_mut().unwrap().insert("finish".into(), json!({ "disposition": disposition, "at": now(), "phaseAtFinish": phase }));
            if phase == "review" {
                if let Some(rev) = state.pointer_mut("/phases/review").and_then(|v| v.as_object_mut()) {
                    rev.insert("status".into(), json!("closed"));
                    rev.insert("closedAt".into(), json!(now()));
                }
            }
            save_state(io, &state);
            io.out(&format!("{}\n", render_status(io, &state)));
            0
        }
        other => {
            io.err(&format!("build-phase: unknown command {other}\n"));
            1
        }
    }
}

View on GitHub (pinned to 2bc2879276)

Solutions

1. Check the accepted build-phase subcommands in the help/usage output.
2. Fix the typo in the subcommand name.
3. Run `impeccable --help` or the top-level usage to find the right verb group.

Example fix

// before
$ impeccable build-phase stat
build-phase: unknown command stat
// after
$ impeccable build-phase status

When it happens

Trigger: Invoking `impeccable build-phase <verb>` where <verb> is not one of the recognized subcommands (e.g. a typo like `finsh`, `stat`, or a command from another verb group like `comp-diff`).

Common situations: Typo'd subcommand names; copying commands from outdated docs; assuming a verb exists in build-phase that actually belongs to a different impeccable verb group.

Related errors

• Unknown command: "{other}" To see a list of supported comma
• Unknown skills command: {other}
• "init" is not a CLI command. Type /impeccable init in your A
• usage: build-phase.mjs start --comp <png> [--breakpoint WxH]
• build-phase: start needs --comp <approved comp png> (comp al

AI-assisted analysis of pbakaus/impeccable@2bc2879276 (2026-09-08). Data as JSON: /api/errors/6e518f5ca3d15da2. Report an issue: GitHub.