agent-loadout 1.0.3 → 1.2.0

package/dist/{catalog-PTLCQEDW.js → catalog-7NB7RALT.js}

@@ -6,7 +6,7 @@ import {
   getToolsByIds,
   getToolsByPreset,
   validateToolIds
-} from "./chunk-JYIPAISH.js";
+} from "./chunk-HDF2R3CI.js";
 export {
   PRESETS,
   TOOLS,

package/dist/{chunk-JYIPAISH.js → chunk-HDF2R3CI.js}

@@ -17,7 +17,13 @@ var PRESETS = [
   {
     id: "media",
     name: "Media",
-    description: "Image, audio, and video pipeline tools",
+    description: "Audio, video, and image pipeline tools",
+    defaultOn: false
+  },
+  {
+    id: "design",
+    name: "Design",
+    description: "Visual asset workflows \u2014 SVG, colour, and image preview",
     defaultOn: false
   },
   {
@@ -359,6 +365,54 @@ var TOOLS = [
     tags: ["interactive shell", "tui prompt", "user input", "shell script ui", "confirm dialog"],
     seeAlso: ["fzf", "just"]
   },
+  {
+    id: "oha",
+    name: "oha",
+    description: "HTTP load tester with JSON output",
+    preset: "agent",
+    verify: "oha --version",
+    install: brewScoopCargo("oha", "oha"),
+    tags: ["load test", "http benchmark", "stress test", "api performance", "latency"],
+    seeAlso: ["xh", "hyperfine"]
+  },
+  {
+    id: "gron",
+    name: "gron",
+    description: "Flatten JSON for grepping",
+    preset: "agent",
+    verify: "gron --version",
+    install: {
+      darwin: [{ method: "brew", package: "gron" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "gron" }]
+    },
+    tags: ["json grep", "flatten json", "json search", "json path", "json debug"],
+    seeAlso: ["jq", "fx", "duckdb"]
+  },
+  {
+    id: "lychee",
+    name: "lychee",
+    description: "Fast link checker",
+    preset: "agent",
+    verify: "lychee --version",
+    install: brewScoopCargo("lychee", "lychee"),
+    tags: ["link check", "broken links", "url validation", "documentation", "dead links"],
+    seeAlso: ["xh", "typos", "vale"]
+  },
+  {
+    id: "vale",
+    name: "vale",
+    description: "Prose linter for docs",
+    preset: "agent",
+    verify: "vale --version",
+    install: {
+      darwin: [{ method: "brew", package: "vale" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "vale" }]
+    },
+    tags: ["prose lint", "writing style", "documentation quality", "grammar", "technical writing"],
+    seeAlso: ["typos", "lychee", "pandoc"]
+  },
   // ── Media ─────────────────────────────────────────────
   {
     id: "ffmpeg",
@@ -392,17 +446,104 @@ var TOOLS = [
     verify: "magick -version",
     install: universal("imagemagick"),
     tags: ["image resize", "image convert", "image transform", "thumbnail", "crop image"],
-    seeAlso: ["exiftool", "svgo", "ffmpeg"]
+    seeAlso: ["exiftool", "vips", "ffmpeg"]
+  },
+  {
+    id: "vips",
+    name: "libvips",
+    description: "Fast image processing pipeline",
+    preset: "media",
+    verify: "vips --version",
+    install: {
+      darwin: [{ method: "brew", package: "vips" }],
+      linux: [{ method: "apt", package: "libvips-tools" }],
+      win32: null
+    },
+    tags: ["image processing", "batch images", "resize", "thumbnail", "sharp backend"],
+    seeAlso: ["imagemagick", "resvg"]
   },
+  // ── Design ─────────────────────────────────────────────
   {
     id: "svgo",
     name: "svgo",
     description: "SVG optimiser",
-    preset: "media",
+    preset: "design",
     verify: "svgo --version",
     install: npmAll("svgo"),
     tags: ["svg optimize", "svg compress", "vector graphics", "svg minify", "icon optimize"],
-    seeAlso: ["imagemagick"]
+    seeAlso: ["resvg", "imagemagick"]
+  },
+  {
+    id: "resvg",
+    name: "resvg",
+    description: "High-fidelity SVG renderer",
+    preset: "design",
+    verify: "resvg --version",
+    install: {
+      darwin: [{ method: "brew", package: "resvg" }],
+      linux: [{ method: "cargo", package: "resvg" }],
+      win32: null
+    },
+    tags: ["svg render", "svg to png", "vector graphics", "svg rasterize"],
+    seeAlso: ["svgo", "vips"]
+  },
+  {
+    id: "chafa",
+    name: "chafa",
+    description: "Image-to-ANSI art renderer",
+    preset: "design",
+    verify: "chafa --version",
+    install: {
+      darwin: [{ method: "brew", package: "chafa" }],
+      linux: [{ method: "apt", package: "chafa" }],
+      win32: null
+    },
+    tags: ["image preview", "terminal image", "ansi art", "image in terminal"],
+    seeAlso: ["vips", "imagemagick"]
+  },
+  {
+    id: "pastel",
+    name: "pastel",
+    description: "Color manipulation and palette tool",
+    preset: "design",
+    verify: "pastel --version",
+    install: brewScoopCargo("pastel", "pastel"),
+    tags: ["color", "palette", "design tokens", "color convert", "color inspect"],
+    seeAlso: ["chafa", "bat"]
+  },
+  {
+    id: "d2",
+    name: "d2",
+    description: "Declarative diagramming language",
+    preset: "design",
+    verify: "d2 version",
+    install: {
+      darwin: [{ method: "brew", package: "d2" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "d2" }]
+    },
+    tags: ["diagram", "architecture diagram", "flowchart", "svg generation", "documentation"],
+    seeAlso: ["resvg", "svgo", "pandoc"]
+  },
+  {
+    id: "pngquant",
+    name: "pngquant",
+    description: "Lossy PNG compressor",
+    preset: "design",
+    verify: "pngquant --version",
+    install: universal("pngquant"),
+    tags: ["png compress", "image optimize", "lossy compression", "web assets"],
+    seeAlso: ["oxipng", "svgo", "imagemagick"]
+  },
+  {
+    id: "oxipng",
+    name: "oxipng",
+    description: "Lossless PNG optimizer",
+    preset: "design",
+    verify: "oxipng --version",
+    install: brewScoopCargo("oxipng", "oxipng"),
+    tags: ["png optimize", "lossless compression", "image optimize", "web assets"],
+    seeAlso: ["pngquant", "svgo", "imagemagick"]
   },
   // ── DX ────────────────────────────────────────────────
   {
@@ -587,6 +728,44 @@ var TOOLS = [
     tags: ["toml", "toml lint", "toml format", "config validation", "cargo toml"],
     seeAlso: ["yq", "biome"]
   },
+  {
+    id: "fx",
+    name: "fx",
+    description: "Interactive JSON viewer",
+    preset: "dx",
+    verify: "fx --version",
+    install: {
+      darwin: [{ method: "brew", package: "fx" }],
+      linux: null,
+      win32: [{ method: "scoop", package: "fx" }]
+    },
+    tags: ["json viewer", "interactive json", "json explorer", "json filter"],
+    seeAlso: ["jq", "bat"]
+  },
+  {
+    id: "csview",
+    name: "csview",
+    description: "CSV/TSV viewer with column alignment",
+    preset: "dx",
+    verify: "csview --version",
+    install: brewScoopCargo("csview", "csview"),
+    tags: ["csv", "tsv", "tabular data", "spreadsheet", "data viewer"],
+    seeAlso: ["duckdb", "jq"]
+  },
+  {
+    id: "asciinema",
+    name: "asciinema",
+    description: "Terminal session recorder",
+    preset: "dx",
+    verify: "asciinema --version",
+    install: {
+      darwin: [{ method: "brew", package: "asciinema" }],
+      linux: [{ method: "apt", package: "asciinema" }],
+      win32: null
+    },
+    tags: ["terminal recording", "demo", "screen capture", "documentation"],
+    seeAlso: ["bat", "glow"]
+  },
   // ── Security ──────────────────────────────────────────
   {
     id: "trivy",

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   getToolsByIds,
   getToolsByPreset,
   validateToolIds
-} from "./chunk-JYIPAISH.js";
+} from "./chunk-HDF2R3CI.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -1743,6 +1743,329 @@ Agents verifying domain setups, debugging DNS issues, or checking propagation ge
 - JSON output with \`--json\` is ideal for piping to jq.
 `.trim();
 
+// src/skills/vips.ts
+var vips_default = `
+# libvips \u2014 Fast image processing
+
+## When to use
+Batch-process images with lower memory usage and higher speed than ImageMagick. Powers the Sharp Node.js library.
+
+## Trusted commands
+- Get image info: \`vipsheader image.jpg\`
+- Resize image: \`vips resize input.jpg output.jpg 0.5\`
+- Convert format: \`vips copy input.png output.webp\`
+- Create thumbnail: \`vips thumbnail input.jpg output.jpg 300\`
+- Extract area: \`vips crop input.jpg output.jpg 0 0 100 100\`
+
+## Why it matters for agents
+Agents processing images in bulk get significantly faster throughput with lower memory overhead than ImageMagick.
+
+## Gotchas
+- Commands use \`vips\` or \`vipsthumbnail\` \u2014 check both are available.
+- Output format is inferred from the file extension.
+- Streaming pipeline architecture means memory stays flat even for large images.
+`.trim();
+
+// src/skills/resvg.ts
+var resvg_default = `
+# resvg \u2014 High-fidelity SVG renderer
+
+## When to use
+Render SVG files to PNG with accurate results. Handles complex SVGs that other tools misrender.
+
+## Trusted commands
+- Render SVG to PNG: \`resvg input.svg output.png\`
+- Set output width: \`resvg input.svg output.png -w 1024\`
+- Set output height: \`resvg input.svg output.png -h 768\`
+- Set DPI: \`resvg input.svg output.png --dpi 300\`
+
+## Why it matters for agents
+Agents generating social images, OG cards, or icons from SVG templates get pixel-perfect PNG output.
+
+## Gotchas
+- Rust-based \u2014 very fast but no interactive mode.
+- Pairs well with svgo: optimise SVG first, then render with resvg.
+- Supports most SVG features including filters and gradients.
+`.trim();
+
+// src/skills/chafa.ts
+var chafa_default = `
+# chafa \u2014 Image-to-ANSI art renderer
+
+## When to use
+Preview images directly in the terminal as coloured text art. Useful when agents need to "see" an image without a GUI.
+
+## Trusted commands
+- Preview image: \`chafa image.png\`
+- Set output size: \`chafa -s 80x24 image.png\`
+- Use specific symbols: \`chafa --symbols block image.png\`
+- ASCII-only output: \`chafa --symbols ascii image.png\`
+- Preview with transparency: \`chafa --bg white image.png\`
+
+## Why it matters for agents
+Agents can inspect image outputs without leaving the terminal \u2014 verify screenshots, check generated graphics, review thumbnails.
+
+## Gotchas
+- Quality depends on terminal capabilities. Use \`--format symbols\` for widest compatibility.
+- Works with PNG, JPEG, GIF, WebP, and many other formats.
+- Pipe support: \`curl -s url | chafa -\`
+`.trim();
+
+// src/skills/oha.ts
+var oha_default = `
+# oha \u2014 HTTP load tester
+
+## When to use
+Benchmark HTTP endpoints with concurrent requests and get structured JSON results. Complements xh (single requests) with load testing.
+
+## Trusted commands
+- Basic load test: \`oha -n 100 -c 10 http://localhost:3000\`
+- JSON output: \`oha -n 100 -c 10 --json http://localhost:3000\`
+- Set duration: \`oha -z 10s -c 50 http://localhost:3000\`
+- POST with body: \`oha -n 100 -m POST -d '{"key":"val"}' http://localhost:3000/api\`
+- Custom headers: \`oha -n 100 -H "Authorization: Bearer token" http://localhost:3000\`
+
+## Why it matters for agents
+Agents benchmarking API changes get structured latency percentiles, throughput, and error rates as JSON they can compare programmatically.
+
+## Gotchas
+- \`-n\` = number of requests, \`-c\` = concurrent connections, \`-z\` = duration.
+- JSON output with \`--json\` is ideal for piping to jq.
+- Rust-based \u2014 extremely low overhead compared to other load testers.
+`.trim();
+
+// src/skills/fx.ts
+var fx_default = `
+# fx \u2014 Interactive JSON viewer
+
+## When to use
+Explore and filter JSON data interactively. Complements jq with a visual, navigable interface.
+
+## Trusted commands
+- View JSON file: \`fx data.json\`
+- Pipe JSON: \`cat data.json | fx\`
+- Apply JS expression: \`fx data.json '.items.map(x => x.name)'\`
+- Filter with dot notation: \`fx data.json '.users[0].email'\`
+- Reduce: \`fx data.json '.items.length'\`
+
+## Why it matters for agents
+Agents exploring unfamiliar API responses or config files can quickly navigate nested structures and extract paths for jq queries.
+
+## Gotchas
+- Accepts JavaScript expressions, not jq syntax.
+- Interactive mode requires a TTY \u2014 use expressions for scripting.
+- Reads from stdin or file argument.
+`.trim();
+
+// src/skills/pastel.ts
+var pastel_default = `
+# pastel \u2014 Color manipulation tool
+
+## When to use
+Generate, convert, inspect, and manipulate colours from the terminal. Ideal for design token generation and palette work.
+
+## Trusted commands
+- Show color info: \`pastel color "#ff6b35"\`
+- Convert format: \`pastel format hsl "#ff6b35"\`
+- Generate palette: \`pastel gradient -n 5 "#ff6b35" "#1a1a2e"\`
+- Lighten colour: \`pastel lighten 0.2 "#ff6b35"\`
+- Darken colour: \`pastel darken 0.2 "#ff6b35"\`
+- Complementary: \`pastel complement "#ff6b35"\`
+- Mix colours: \`pastel mix "#ff6b35" "#1a1a2e"\`
+
+## Why it matters for agents
+Agents generating design tokens, theme files, or CSS variables can programmatically derive entire palettes from brand colours.
+
+## Gotchas
+- Supports hex, RGB, HSL, Lab, and named CSS colours.
+- Use \`pastel list\` to see all named colours.
+- Output can be piped \u2014 combine with sd for bulk colour replacement.
+`.trim();
+
+// src/skills/csview.ts
+var csview_default = `
+# csview \u2014 CSV/TSV viewer
+
+## When to use
+View tabular data (CSV, TSV) with aligned columns and optional styling in the terminal.
+
+## Trusted commands
+- View CSV: \`csview data.csv\`
+- View TSV: \`csview -t data.tsv\`
+- Custom delimiter: \`csview -d ';' data.csv\`
+- No header row: \`csview --no-headers data.csv\`
+- Pipe from stdin: \`cat data.csv | csview\`
+
+## Why it matters for agents
+Agents inspecting exported data, build reports, or log tables get clean columnar output instead of comma-separated noise.
+
+## Gotchas
+- Rust-based \u2014 handles large files efficiently.
+- Use \`-t\` flag for TSV files.
+- For SQL-level queries on CSV, use duckdb instead.
+`.trim();
+
+// src/skills/asciinema.ts
+var asciinema_default = `
+# asciinema \u2014 Terminal session recorder
+
+## When to use
+Record terminal sessions as lightweight asciicast files for documentation, demos, or bug reports.
+
+## Trusted commands
+- Record session: \`asciinema rec demo.cast\`
+- Play recording: \`asciinema play demo.cast\`
+- Record with idle limit: \`asciinema rec --idle-time-limit 2 demo.cast\`
+- Record specific command: \`asciinema rec --command "pnpm test" demo.cast\`
+- Upload to asciinema.org: \`asciinema upload demo.cast\`
+
+## Why it matters for agents
+Agents can record their terminal workflows for review, create reproducible demos, or capture test runs for debugging.
+
+## Gotchas
+- Recordings are text-based (not video) \u2014 tiny file sizes and searchable.
+- Set \`--idle-time-limit\` to trim long pauses.
+- \`.cast\` files can be embedded in web pages with the asciinema player.
+`.trim();
+
+// src/skills/d2.ts
+var d2_default = `
+# d2 \u2014 Declarative diagramming language
+
+## When to use
+Generate architecture diagrams, flowcharts, sequence diagrams, and ERDs from text. Output SVG or PNG without a GUI.
+
+## Trusted commands
+- Render to SVG: \`d2 input.d2 output.svg\`
+- Render to PNG: \`d2 input.d2 output.png\`
+- Watch mode: \`d2 --watch input.d2 output.svg\`
+- Set theme: \`d2 --theme 200 input.d2 output.svg\`
+- Set layout engine: \`d2 --layout elk input.d2 output.svg\`
+
+## Why it matters for agents
+Agents generate architecture and flow diagrams from code analysis \u2014 describe structure in text, get publication-ready SVGs.
+
+## Gotchas
+- D2 files use a simple DSL: \`a -> b: label\`.
+- Supports sequence diagrams, classes, ERDs, and grid diagrams.
+- Multiple layout engines: dagre (default), elk, tala.
+`.trim();
+
+// src/skills/pngquant.ts
+var pngquant_default = `
+# pngquant \u2014 Lossy PNG compressor
+
+## When to use
+Reduce PNG file size by 50-80% with minimal visual quality loss. Ideal for web assets, screenshots, and icons.
+
+## Trusted commands
+- Compress with default quality: \`pngquant image.png\`
+- Set quality range: \`pngquant --quality=65-80 image.png\`
+- Overwrite original: \`pngquant --force --ext .png image.png\`
+- Batch compress: \`pngquant --force --ext .png *.png\`
+- Output to stdout: \`pngquant - < input.png > output.png\`
+
+## Why it matters for agents
+Agents optimise generated screenshots, OG images, and icon sets \u2014 often cutting 60-70% off PNG sizes before deployment.
+
+## Gotchas
+- Lossy compression \u2014 visually near-identical but not bit-perfect.
+- Combine with oxipng for lossy + lossless pipeline.
+- Exit code 99 means quality target can't be met \u2014 widen the range.
+`.trim();
+
+// src/skills/oxipng.ts
+var oxipng_default = `
+# oxipng \u2014 Lossless PNG optimizer
+
+## When to use
+Reduce PNG file size without any quality loss. Run after pngquant for maximum compression, or standalone for lossless-only workflows.
+
+## Trusted commands
+- Optimize in place: \`oxipng -o 4 image.png\`
+- Max compression: \`oxipng -o max image.png\`
+- Batch optimize: \`oxipng -o 4 -r ./images/\`
+- Strip metadata: \`oxipng -o 4 --strip safe image.png\`
+- Preserve original: \`oxipng -o 4 --out optimized.png image.png\`
+
+## Why it matters for agents
+Agents run oxipng as a final pass on all PNG assets \u2014 guaranteed size reduction with zero quality loss.
+
+## Gotchas
+- \`-o\` levels: 0 (fast) to max (slow). Level 4 is a good default.
+- \`--strip safe\` removes metadata without breaking rendering.
+- Rust-based \u2014 fast even on large batches.
+`.trim();
+
+// src/skills/gron.ts
+var gron_default = `
+# gron \u2014 Flatten JSON for grepping
+
+## When to use
+Turn nested JSON into greppable assignment statements. Find paths in complex API responses without writing jq expressions.
+
+## Trusted commands
+- Flatten JSON: \`gron data.json\`
+- Flatten from URL: \`gron https://api.example.com/data\`
+- Pipe from stdin: \`cat data.json | gron\`
+- Grep for field: \`gron data.json | grep "name"\`
+- Unflatten back to JSON: \`gron data.json | grep "users" | gron --ungron\`
+
+## Why it matters for agents
+Agents exploring unfamiliar JSON APIs can grep for field names across deeply nested structures, then reconstruct filtered subsets.
+
+## Gotchas
+- Output format: \`json.users[0].name = "Alice";\` \u2014 each line is a full path.
+- \`--ungron\` converts flattened output back to valid JSON.
+- Combine with rg for regex filtering of JSON paths.
+`.trim();
+
+// src/skills/lychee.ts
+var lychee_default = `
+# lychee \u2014 Fast link checker
+
+## When to use
+Scan documentation, markdown files, and websites for broken links. Catches dead URLs, redirects, and timeouts.
+
+## Trusted commands
+- Check markdown files: \`lychee "**/*.md"\`
+- Check a URL: \`lychee https://example.com\`
+- Check with config: \`lychee --config lychee.toml "**/*.md"\`
+- JSON output: \`lychee --format json "**/*.md"\`
+- Exclude patterns: \`lychee --exclude "localhost" "**/*.md"\`
+
+## Why it matters for agents
+Agents validate documentation links after edits \u2014 catch broken references before they ship to production.
+
+## Gotchas
+- Rust-based \u2014 extremely fast, checks links concurrently.
+- Use \`.lycheeignore\` or \`--exclude\` for known-flaky URLs.
+- Supports markdown, HTML, and plain text files.
+`.trim();
+
+// src/skills/vale.ts
+var vale_default = `
+# vale \u2014 Prose linter for documentation
+
+## When to use
+Enforce writing style guides on documentation, README files, and technical content. Catches jargon, passive voice, and style violations.
+
+## Trusted commands
+- Lint a file: \`vale README.md\`
+- Lint a directory: \`vale docs/\`
+- JSON output: \`vale --output JSON README.md\`
+- Initialize config: \`vale sync\`
+- List installed styles: \`vale ls-config\`
+
+## Why it matters for agents
+Agents writing or editing documentation can validate prose quality against style guides \u2014 Google, Microsoft, or custom rules.
+
+## Gotchas
+- Requires a \`.vale.ini\` config file in the project root.
+- Install styles with \`vale sync\` after configuring packages.
+- Common styles: Google, Microsoft, write-good, proselint.
+`.trim();
+
 // src/skills.ts
 var SKILL_CONTENT = {
   rg: rg_default,
@@ -1794,7 +2117,21 @@ var SKILL_CONTENT = {
   taplo: taplo_default,
   semgrep: semgrep_default,
   age: age_default,
-  doggo: doggo_default
+  doggo: doggo_default,
+  vips: vips_default,
+  resvg: resvg_default,
+  chafa: chafa_default,
+  oha: oha_default,
+  fx: fx_default,
+  pastel: pastel_default,
+  csview: csview_default,
+  asciinema: asciinema_default,
+  d2: d2_default,
+  pngquant: pngquant_default,
+  oxipng: oxipng_default,
+  gron: gron_default,
+  lychee: lychee_default,
+  vale: vale_default
 };
 function skillFilename(toolId) {
   return `${toolId}.md`;
@@ -2020,7 +2357,7 @@ program.command("verify").alias("doctor").description("Check which tools are ins
 });
 program.command("list").description("Print the tool catalog").option("--json", "Output as JSON").option("--brewfile", "Output macOS Brewfile (darwin only)").action(async (opts) => {
   if (opts.brewfile) {
-    const { generateBrewfileFromCatalog } = await import("./catalog-PTLCQEDW.js");
+    const { generateBrewfileFromCatalog } = await import("./catalog-7NB7RALT.js");
     console.log(generateBrewfileFromCatalog());
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loadout",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "One command to load out your terminal for agentic coding",
   "type": "module",
   "bin": {
@@ -25,8 +25,16 @@
     "developer-tools",
     "loadout"
   ],
-  "author": "",
+  "author": "cluddy",
   "license": "MIT",
+  "homepage": "https://github.com/conorluddy/agent-loadout#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/conorluddy/agent-loadout.git"
+  },
+  "bugs": {
+    "url": "https://github.com/conorluddy/agent-loadout/issues"
+  },
   "dependencies": {
     "@inquirer/prompts": "^8.3.0",
     "chalk": "^5.4.0",