zeroclaw-labs/zeroclaw · error

cli-alias-delete-refused-hint

cli-alias-delete-refused-hint

Error message

delete refused — resolve the hard references first

What it means

Error "delete refused — resolve the hard references first" thrown in zeroclaw-labs/zeroclaw.

Source

Thrown at src/alias_cli/mod.rs:261

                    "deleted {$section}.{$alias} (scrubbed {$count} reference(s))"
                )
            );
            Ok(())
        }
        Err(CascadeError::Refused(report)) => {
            let count = report.blockers.len().to_string();
            println!(
                "{}",
                mta(
                    "cli-alias-delete-refused-header",
                    &[("count", count.as_str())],
                    "refused: {$count} hard reference(s) block the delete:"
                )
            );
            for b in &report.blockers {
                println!("  ✗ {}", b.path);
            }
            bail!(
                "{}",
                mt(
                    "cli-alias-delete-refused-hint",
                    "delete refused — resolve the hard references first"
                )
            );
        }
        Err(CascadeError::NotFound(p)) => bail!(
            "{}",
            mta(
                "cli-alias-not-configured",
                &[("path", p.as_str())],
                "{$path} is not configured"
            )
        ),
        Err(e) => {
            let es = e.to_string();
            bail!(

View on GitHub (pinned to 88bb9c8533)

Solutions

1. List and remove or re-point the hard references to this entry, then retry the delete.
2. Use the reported reference list to update dependent config entries before deleting.

When it happens

Trigger: Thrown at src/alias_cli/mod.rs:261 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/7affcfb0a28850bc. Report an issue: GitHub.