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

Relationships

#699 Tutorial "Validate with a dry run" section shows stale extension push --dry-run output

Opened by sntxrrgithub · 6/19/2026· Shipped 6/19/2026

Description

The "Validate with a dry run" section of the "Publish an Extension" tutorial (https://swamp-club.com/manual/tutorials/publish-an-extension#validate-with-a-dry-run) shows this command:

swamp extension push extensions/models/manifest.yaml --dry-run

and documents the expected output as:

info    extension·push       Extension: "@stack72/text-entropy"@"2026.05.31.1"
info    extension·push       Description: "Measure the Shannon entropy of a piece of text"
info    extension·push       Repository: "https://github.com/stack72/text-entropy"
info    extension·push       Models (1):
info    extension·push         "@stack72/text-entropy" ("extensions/models/text_entropy.ts")
info    extension·push       Additional files (2):
info    extension·push         "extensions/models/README.md"
info    extension·push         "extensions/models/LICENSE.md"
info    extension·push       Labels: "text, analysis"
info    extension·push       Dry run complete for "@stack72/text-entropy"@"2026.05.31.1"
info    extension·push       Archive size: "3.5KB"
info    extension·push       No API calls were made.

Running the exact same command against the same extension today produces materially different output:

$ swamp extension push extensions/models/manifest.yaml --dry-run
18:14:34.716   info    extension·push       Extension: "@stack72/text-entropy"@"2026.05.31.1"
18:14:34.718   info    extension·push       Description: "Measure the Shannon entropy of a piece of text"
18:14:34.719   info    extension·push       Repository: "https://github.com/stack72/text-entropy"
18:14:34.719   info    extension·push       Models (1):
18:14:34.719   info    extension·push         "@stack72/text-entropy" ("extensions/models/text_entropy.ts")
18:14:34.719   info    extension·push           Global Arguments:
18:14:34.719   info    extension·push             "text": "string"""
18:14:34.719   info    extension·push       Additional files (2):
18:14:34.719   info    extension·push         "extensions/models/README.md"
18:14:34.719   info    extension·push         "extensions/models/LICENSE.md"
18:14:34.720   info    extension·push       Labels: "text, analysis"
18:14:34.720   warning extension·push       Extension review warnings:
18:14:34.720   warning extension·push         ["medium"] "Testing Completeness" — "/path/to/repo/extensions/models/text_entropy.ts": "No sibling `_test.ts` found — cover both success and failure paths with unit tests before publishing."
18:14:34.720   warning extension·push         ["medium"] "Adversarial review" — "/var/folders/v0/1ts35ts11pz846mz6k3q1fh80000zz/T/swamp-extension-review/_stack72_text-entropy-e73e91d39d46e09e625fc0d658a7230d2c2e1bbdb5e9a2dab6caee029531d98a.json": "No adversarial review recorded for the current code — perform the review and write the report here (run with --dry-run --json for the fill-in skeleton, or see the swamp skill)."
18:14:34.734   info    extension·push       Dry run complete for "@stack72/text-entropy"@"2026.05.31.1"
18:14:34.734   info    extension·push       Archive size: "2.6KB"
18:14:34.734   info    extension·push       No API calls were made.

Differences from the documented output:

  • Every log line is now prefixed with a timestamp (HH:MM:SS.mmm) — the tutorial's sample output has no timestamps at all.
  • A new Global Arguments: block is rendered per model under "Models (N):" — not present in the documented output.
  • A new Extension review warnings: block appears (Testing Completeness + Adversarial review findings) — not present in the documented output, and directly relevant since the tutorial doesn't otherwise mention the adversarial review gate at this step.
  • The reported Archive size differs (3.5KB documented vs 2.6KB actual) — likely just an artifact of the example being captured at a different point in time/content, but worth refreshing alongside the rest.

I confirmed this isn't a stale doc that's already been fixed in a newer CLI — the renderer source for extension push (extension_push.ts) still emits the Global Arguments: and Extension review warnings: sections in the latest fetched build, so the documented sample output is just out of date relative to current behavior, not a regression that's since been reverted.

Steps to Reproduce

  1. Open the tutorial at /manual/tutorials/publish-an-extension#validate-with-a-dry-run.
  2. Follow the steps to author the @stack72/text-entropy-style extension and manifest.
  3. Run swamp extension push extensions/models/manifest.yaml --dry-run.
  4. Compare actual output to the tutorial's documented sample.

Expected Behavior

Refresh the documented sample output to match current extension push --dry-run rendering: include timestamps, the Global Arguments: block, and the Extension review warnings: block (or at least call out that warnings/timestamps may appear and aren't a sign of failure). This also seems like a good place for the tutorial to briefly explain what the "Adversarial review" and "Testing Completeness" warnings mean and link to the adversarial review gate guidance, since a reader following the tutorial verbatim will hit those warnings on a fresh extension and have no context for them.

Affected Component

Documentation — swamp.club manual, "Publish an Extension" tutorial, "Validate with a dry run" section.

Environment

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 6 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORECONTRIBUTOR_NOTIFIED

Shipped

6/19/2026, 7:39:55 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack726/19/2026, 7:07:44 PM
Editable. Press Enter to edit.

stack72 commented 6/19/2026, 7:40:13 PM

Thanks @sntxrrgithub for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.