Hmbown/CodeWhale · error

unsafe bundle path

Error message

unsafe bundle path: {relative}

What it means

After stripping the `path:` prefix, each plugin bundle path is validated segment-by-segment: every path segment must be non-empty, not `.`/`..`, and consist only of ASCII alphanumerics, `-`, `_`, `.`. This blocks path traversal and unsafe characters in the generated codeload URL fragment. Violations exit with `unsafe bundle path: {relative}`.

Solutions

1. Move/rename the plugin directory so its path segments are plain ASCII (letters, digits, `-_.`).
2. Remove any `..`, `.` segments or leading/trailing slashes from the source path.
3. Fix whitespace or special characters in directory names.
4. Re-run scripts/sync-marketplace.py after correcting marketplace.json.

Example fix

// before
"source": "path:../shared-plugins/x y"
// after
"source": "path:plugins/x-y"

import re
for c in json.load(open('marketplace.json'))['plugins']:
    rel = c['source'][5:]
    assert all(re.fullmatch(r'[\w.-]+', p) and p not in ('.','..') for p in rel.split('/')), rel

def safe_rel(p): return bool(p) and all(seg not in ('','.', '..') and all(ch.isascii() and (ch.isalnum() or ch in '-_.') for ch in seg) for seg in p.split('/'))

try:
    subprocess.run(['python3','scripts/sync-marketplace.py'], check=True)
except SystemExit as e:
    print('unsafe path:', e)

When it happens

Trigger: A plugin source like `path:../secrets`, `path:` (empty), `path:a/../../etc`, or a path containing spaces, `~`, or other special characters.

Common situations: Typos in plugin paths; attempting to reference a plugin outside the marketplace directory; a path with a space or unicode character copied from a file manager.

Understand the failure class

Background: Path traversal blocked: "path escapes the workspace" and "outside site root" errors when a path will not stay inside its allowed directory — this error's family across 26 libraries.

Related errors

• must be a single path component
• must be a single path component
• xAI OAuth private basename must be one UTF-8 path component
• append_allow_rules only accepts action = "allow"
• bad_args

AI-assisted analysis of Hmbown/CodeWhale@433685b202 (2026-09-15). Data as JSON: /api/errors/b59011cfa7431a8e. Report an issue: GitHub.

Appendix: source

Thrown at scripts/sync-marketplace.py:28

import subprocess

ROOT = Path(__file__).resolve().parents[1]
REPOSITORY = "https://github.com/Hmbown/codewhale-plugin-marketplace"
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--marketplace", type=Path, default=ROOT.parent / "codewhale-plugin-marketplace")
parser.add_argument("--check", action="store_true")
args = parser.parse_args()
source = args.marketplace.resolve()
raw = subprocess.check_output(["git", "show", "HEAD:marketplace.json"], cwd=source)
revision = subprocess.check_output(["git", "rev-parse", "HEAD"], cwd=source, text=True).strip()
catalog = json.loads(raw)
for candidate in catalog["plugins"]:
    spec = candidate["source"]
    if not spec.startswith("path:"):
        raise SystemExit(f"unexpected first-party source: {spec}")
    relative = spec[5:]
    if any(part in ("", ".", "..") or not all(c.isascii() and (c.isalnum() or c in "-_.") for c in part) for part in relative.split("/")):
        raise SystemExit(f"unsafe bundle path: {relative}")
    # Pin every install source to the reviewed marketplace revision so the
    # bytes a user installs are the bytes this snapshot describes. Freshness
    # comes from bumping the pin (the marketplace-sync workflow reports drift
    # against `main` weekly); `/plugin update` re-downloads the same archive
    # and reports no change until the pin moves.
    candidate["source"] = f"https://codeload.github.com/Hmbown/codewhale-plugin-marketplace/tar.gz/{revision}#path={relative}"
snapshot = {"repository": REPOSITORY, "revision": revision, "catalog": catalog}
rendered = json.dumps(snapshot, indent=2, ensure_ascii=False) + "\n"
output = ROOT / "crates/tui/assets/first-party-marketplace.json"
if args.check:
    if not output.exists() or output.read_text() != rendered:
        raise SystemExit("First-party catalog drift: run python3 scripts/sync-marketplace.py, review, and rebuild.")
    print(f"First-party catalog matches marketplace {revision}")
else:
    output.write_text(rendered)
    print(f"Updated {output} from marketplace {revision}")

View on GitHub (pinned to 433685b202)