What's Changed

• chore: remove alpha disclaimer from README (#799)

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.205322.0-sha.009deadb/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.205322.0-sha.009deadb/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.205322.0-sha.009deadb/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.205322.0-sha.009deadb/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• The Machine: Hooks proving to be painful (#797)

"the linter is firing between code blocks, so it winds up arguing with itself (for example, type only imports being written when its between edits, so then it just bounces back and forth)"

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.202156.0-sha.9f61241f/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.202156.0-sha.9f61241f/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.202156.0-sha.9f61241f/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.202156.0-sha.9f61241f/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• chore: Upgrade CloudControl SDK to 3.1014.0 (#798)

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.201208.0-sha.b8d0c34e/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.201208.0-sha.b8d0c34e/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.201208.0-sha.b8d0c34e/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.201208.0-sha.b8d0c34e/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• docs: guide agents to extend models instead of CLI fallback (#796)

Summary

• Strengthened Rule 2 in generated CLAUDE.md (generateInstructionsBody()) to explicitly call out CLI tools (gh, aws, curl) as an anti-pattern alongside shell scripts, and point agents to export const extension and swamp model type describe to check available methods
• Added "model exists but method missing" decision flow to swamp-extension-model skill, routing agents to extend existing models via export const extension instead of falling back to CLI tools
• Added "Existing model missing a method" row to the swamp-model skill's "Choosing the Right Approach" table
• Added "Extend model with new method" row to the swamp-report skill's "When to Use Other Skills" table
• Improved swamp-extension-driver skill verification section (tessl review: 94% → 100%)
• Tightened swamp-extension-model skill verbosity to stay under 500 lines (tessl review: 93% → 100%)

Closes #667

Test plan

• deno check passes
• deno lint passes
• deno run test — all 3475 tests pass
• deno run compile succeeds
• npx tessl skill review .claude/skills/swamp-extension-model — 100%
• npx tessl skill review .claude/skills/swamp-extension-driver — 100%

🤖 Generated with Claude Code

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.192844.0-sha.1bb5fa8f/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.192844.0-sha.1bb5fa8f/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.192844.0-sha.1bb5fa8f/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.192844.0-sha.1bb5fa8f/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• docs: add report guidance to skills and generated CLAUDE.md (#795)

Summary

Closes #662

Agents default to inline shell scripts (python3 -c, deno eval, complex jq pipelines) when they need to transform model output, instead of using the proper extension points. With reports now available, this PR updates skill documentation so agents automatically choose the right approach based on task intent:

• Reusable pipeline (reports, analysis, summaries) → report extension
• Ad-hoc debugging / one-off inspection → inline is fine

Changes

• src/domain/repo/repo_service.ts — Added rule 8 ("Reports for reusable data pipelines") to the generated CLAUDE.md rules, and added swamp-report to the generated skills list (after swamp-data)
• .claude/skills/swamp-model/SKILL.md — Added a "Choosing the Right Approach" decision table before "When to Use Other Skills" that maps task type → approach (extension model, report extension, or inline), and added swamp-report to the skills cross-reference table
• .claude/skills/swamp-extension-model/SKILL.md — Added guidance in the decision flow that if the task is transforming/analyzing existing model output, a report extension is the right choice (not an extension model), and added swamp-report to the skills cross-reference table
• .claude/skills/swamp-report/SKILL.md — Added a "When to Create a Report" positioning section after the intro that defines when reports are the right choice (repeatable analysis, versioned output, multi-model analysis, user asks for report/summary/audit)

Design choices

The key decision was keeping the guidance lightweight and distributed across skills rather than creating a centralized decision document. Each skill now contains just enough context to redirect agents to the right tool — the swamp-model skill has the top-level decision table, swamp-extension-model has a guard clause before its creation flow, and swamp-report has positioning criteria. This means agents get the right guidance regardless of which skill they load first.

We chose not to add any code changes or new CLI behavior — this is purely a documentation/guidance fix that steers agent behavior through better skill content.

Test plan

• deno check passes
• deno lint passes
• deno run test — all 3475 tests pass
• Verify generated CLAUDE.md includes rule 8 and swamp-report skill by running swamp init in a test repo

🤖 Generated with Claude Code

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.190516.0-sha.5f63dd16/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.190516.0-sha.5f63dd16/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.190516.0-sha.5f63dd16/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.190516.0-sha.5f63dd16/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• The Machine: Remove the stop verify script file (#794)

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.184735.0-sha.e821ef40/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.184735.0-sha.e821ef40/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.184735.0-sha.e821ef40/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.184735.0-sha.e821ef40/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• The Machine: Moving the stop hook back to CLAUDE.md (#793)

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.183930.0-sha.b966a910/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.183930.0-sha.b966a910/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.183930.0-sha.b966a910/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.183930.0-sha.b966a910/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• fix: complete reports integration across extension push, pull, and search (#792)

Summary

PR #790 added reports as a top-level extension primitive, but several extension system paths were not updated to handle them consistently with other extension types. This PR fixes bugs and consistency gaps across push, pull, and search.

Bug fixes

• Report bundles compiled without bundleOptions — Reports using bare specifiers or deno.json import maps would fail to compile during extension push because bundleOptions (denoConfigPath/packageJsonDir) was not passed to bundleExtension(). All other extension types correctly received these options.
• Reports excluded from bare specifier detection — When determining whether a package.json is needed for bundling, report entry points were not checked. If a report was the only file using bare specifiers, packageJsonDir would never be set, causing a bundling failure.
• validateSourceCompleteness skipped reports on pull — After pulling an extension, source completeness validation checked models, vaults, drivers, and datastores but not reports. Missing report dependencies would go unwarned.
• --content-type reports rejected by CLI — The extension search command had a hardcoded content type validation list that didn't include "reports", so swamp extension search --content-type reports would error.

Consistency fixes

• Manifest validation error message now includes "report" as a valid extension type
• Collective validation error messages and docstrings now mention reports
• Content metadata debug log now includes report count
• Help text for --content-type flag lists reports

Test plan

• deno run test src/domain/extensions/extension_manifest_test.ts — passes with updated error message
• deno run test src/domain/extensions/extension_collective_validator_test.ts — passes
• deno run test src/domain/extensions/extension_content_extractor_test.ts — passes
• deno check on all modified files — clean

🤖 Generated with Claude Code

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.170756.0-sha.fc2dabfb/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.170756.0-sha.fc2dabfb/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.170756.0-sha.fc2dabfb/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.170756.0-sha.fc2dabfb/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• feat: add reporting as a top level primitive (#790)

Summary

• Add a reports system: user-defined TypeScript extensions in extensions/reports/ that analyze model/workflow execution results and produce markdown + JSON output, automatically persisted as versioned data artifacts
• Three report scopes (method, model, workflow) with a three-level control model: model-type defaults, definition YAML reports.require/reports.skip, and CLI flags (--report, --skip-report, --report-label, --skip-report-label, --skip-reports)
• New CLI commands: report describe, report get, report search (with interactive fuzzy-search TUI)
• Integrate reports into model method runs and workflow runs, extension push/pull, and add a swamp-report skill
• Add markdown-to-terminal renderer for rich report output

Test Plan

• Unit tests for all new domain modules (report registry, execution service, data handles, report selection)
• Unit tests for libswamp generators (describe, get, search) and presentation renderers
• Integration tests updated for architecture boundary and DDD layer rules
• All 3474 tests pass, deno check, deno lint, deno fmt clean
• Binary compiles successfully via deno run compile

🤖 Generated with Claude Code

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.142933.0-sha.08c5e03a/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.142933.0-sha.08c5e03a/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.142933.0-sha.08c5e03a/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.142933.0-sha.08c5e03a/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

What's Changed

• The Machine: Skip Claude hooks in CI reviews (#789)

Installation

macOS (Apple Silicon):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.004740.0-sha.170e5989/swamp-darwin-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

macOS (Intel):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.004740.0-sha.170e5989/swamp-darwin-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (x86_64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.004740.0-sha.170e5989/swamp-linux-x86_64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/

Linux (aarch64):

curl -L https://github.com/systeminit/swamp/releases/download/v20260320.004740.0-sha.170e5989/swamp-linux-aarch64 -o swamp
chmod +x swamp && sudo mv swamp /usr/local/bin/