Skip to main content
← Back to list
01Issue
FeatureShippedSwamp Club
Assigneesstack72

#305 Docs: document binaries manifest field in extension-manifest.md

Opened by stack72 · 5/9/2026· Shipped 5/9/2026

What changed

swamp PR #1350 added a binaries manifest field for declaring executable host helpers. swamp-club PR #519 added API and UI support. The documentation in content/manual/reference/extension-manifest.md has not been updated.

What needs updating

extension-manifest.md (critical)

  1. Add binaries field documentation — new section under "Supplementary File Fields" (after additionalFiles): type string[], optional, defaults to []. Declares executable host helpers (shell scripts, extensionless binaries). Resolved relative to the manifest directory. Files land in files/ in the archive. Exempt from the file-extension allowlist but subject to all other safety checks. Executable bits preserved on POSIX. Pull-time warning advises inspection.

  2. Update the "Allowed file types" table — note that files declared in binaries are exempt from the extension allowlist.

  3. Update archive structure example — show binary files landing in files/.

  4. Add to "Complete Examples" — show binaries: [bin/helper] in manifest examples.

create-and-publish-extension.md (nice-to-have)

Consider adding binaries to the manifest example and a note on when to use binaries vs additionalFiles.

Context

  • swamp #1350 — CLI implementation
  • swamp-club #519 — API and UI support
  • Lab #264 — original feature request
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 3 MOREPR_MERGEDCOMPLETE

Shipped

5/9/2026, 10:46:12 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack725/9/2026, 10:30:53 PM

Sign in to post a ripple.