Sfoglia il codice sorgente

chore: bump to v2.4.12 — ship portless-ops + process-compose-ops + plugin manifest catch-up

Version: 2.4.11 -> 2.4.12

Skills added to .claude-plugin/plugin.json components.skills:
  + skills/portless-ops          (NEW this release)
  + skills/process-compose-ops   (NEW this release)
  + skills/fleet-ops             (committed post-v2.4.11, never registered)
  + skills/summon                (shipped in v2.4.11 README but never registered)

Description count: 71 -> 75 skills.

Aligned all skill-count references:
  - .claude-plugin/plugin.json description: 71 -> 75
  - README intro paragraph: 69 -> 75
  - README count line: 71 -> 75
  - AGENTS.md project overview: 68 -> 75

Recent Updates entry for v2.4.12 covers:
  - portless-ops: wrapping Vercel Labs' portless with our operational
    patterns (static-alias pattern, TLD selection, Windows specifics,
    reset procedure, IOC-scanning installer)
  - process-compose-ops: 6 references + 4 scripts + 5 YAML assets
    derived from production PM2 -> Process Compose migration
  - The plugin manifest catch-up (summon + fleet-ops registration)

Per rules/release-review.md guidance: Recent Updates is for features.
Bug fixes since v2.4.11 (install.sh cross-platform, fleet-ops worktree
fix, fleet-ops 'fleet status' rename) intentionally excluded — they
land in the changelog but not in Recent Updates.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
0xDarkMatter 2 mesi fa
parent
commit
cdd3cc4914
3 ha cambiato i file con 14 aggiunte e 5 eliminazioni
  1. 6 2
      .claude-plugin/plugin.json
  2. 1 1
      AGENTS.md
  3. 7 2
      README.md

+ 6 - 2
.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-mods",
-  "version": "2.4.11",
-  "description": "Custom commands, skills, and agents for Claude Code - session continuity, 23 expert agents, 71 skills, 3 commands, 6 rules, 4 hooks, 13 output styles, modern CLI tools",
+  "version": "2.4.12",
+  "description": "Custom commands, skills, and agents for Claude Code - session continuity, 23 expert agents, 75 skills, 3 commands, 6 rules, 4 hooks, 13 output styles, modern CLI tools",
   "author": "0xDarkMatter",
   "repository": "https://github.com/0xDarkMatter/claude-mods",
   "license": "MIT",
@@ -69,6 +69,7 @@
       "skills/explain",
       "skills/file-search",
       "skills/find-replace",
+      "skills/fleet-ops",
       "skills/git-ops",
       "skills/github-ops",
       "skills/go-ops",
@@ -84,7 +85,9 @@
       "skills/monitoring-ops",
       "skills/nginx-ops",
       "skills/perf-ops",
+      "skills/portless-ops",
       "skills/postgres-ops",
+      "skills/process-compose-ops",
       "skills/project-planner",
       "skills/push-gate",
       "skills/python-async-ops",
@@ -109,6 +112,7 @@
       "skills/sql-ops",
       "skills/sqlite-ops",
       "skills/structural-search",
+      "skills/summon",
       "skills/tailwind-ops",
       "skills/task-runner",
       "skills/techdebt",

+ 1 - 1
AGENTS.md

@@ -5,7 +5,7 @@
 This is **claude-mods** - a collection of custom extensions for Claude Code:
 - **23 expert agents** for specialized domains (React, Python, Go, Rust, AWS, git, etc.)
 - **3 commands** for session management (/sync, /save) and experimental features (/canvas)
-- **68 skills** for CLI tools, patterns, workflows, and development tasks
+- **75 skills** for CLI tools, patterns, workflows, and development tasks
 - **13 output styles** for response personality (Vesper, Spartan, Mentor, Executive, Pair, Atlas, Coach, Harbour, Meridian, Noir, Roast, Sage, Scout)
 - **4 hooks** for pre-commit linting, post-edit formatting, dangerous command warnings, and pmail notifications
 - **Pigeon** inter-session messaging (`pigeon send/read/reply`) - SQLite-backed pmail at `~/.claude/pmail.db`

+ 7 - 2
README.md

@@ -12,16 +12,21 @@
 
 > *A comprehensive extension toolkit that transforms Claude Code into a specialized development powerhouse.*
 
-**claude-mods** is a production-ready plugin that extends Claude Code with 23 expert agents, 69 specialized skills, 13 output styles, 4 hooks, and modern CLI tools designed for real-world development workflows. Whether you're debugging React hooks, optimizing PostgreSQL queries, or building production CLI applications, this toolkit equips Claude with the domain expertise and procedural knowledge to work at expert level across multiple technology stacks.
+**claude-mods** is a production-ready plugin that extends Claude Code with 23 expert agents, 75 specialized skills, 13 output styles, 4 hooks, and modern CLI tools designed for real-world development workflows. Whether you're debugging React hooks, optimizing PostgreSQL queries, or building production CLI applications, this toolkit equips Claude with the domain expertise and procedural knowledge to work at expert level across multiple technology stacks.
 
 Built on the [Agent Skills specification](https://agentskills.io/specification) (an open standard backed by Anthropic, Vercel, Google, Microsoft, and 40+ agent platforms), claude-mods fills critical gaps in Claude Code's capabilities: persistent session state that survives across machines, on-demand expert knowledge for specialized domains, token-efficient modern CLI tools (10-100x faster than traditional alternatives), and proven workflow patterns for TDD, code review, and feature development. The toolkit implements Anthropic's [recommended patterns for long-running agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents), ensuring your development context never vanishes when sessions end.
 
 From Python async patterns to Rust ownership models, from AWS Fargate deployments to Craft CMS development - claude-mods provides the specialized knowledge and tools that transform Claude from a general-purpose assistant into a domain expert who understands your stack, remembers your workflow, and ships production code.
 
-**23 agents. 71 skills. 13 styles. 4 hooks. 6 rules. One install.**
+**23 agents. 75 skills. 13 styles. 4 hooks. 6 rules. One install.**
 
 ## Recent Updates
 
+**v2.4.12** (May 2026)
+- 🌐 **`portless-ops` skill** - Local-dev HTTPS proxy operations for Vercel Labs' [portless](https://github.com/vercel-labs/portless). Wraps the canonical upstream `SKILL.md` and `oauth/SKILL.md` (vendored verbatim into `references/` since the npm package only ships `dist/`) and overlays operational patterns we've validated: the static-alias pattern for pairing portless with external supervisors (Process Compose, PM2, Docker), TLD selection decision tree (`.test`/`.dev`/`.localhost`/custom-owned), Windows-specific gotchas (`openssl` PATH from Git for Windows, `certutil` quirks, curl-vs-browser cert handling, PS 5.1 vs 7+ flag differences), the clean-reset procedure when changing TLDs (because `portless alias --remove` appends the active TLD), and three runnable scripts: `install-portless.ps1` (audits the npm tarball for known supply-chain IOCs *before* installing), `reset-state.ps1` (full state wipe + re-register), `sync-aliases-from-yaml.ps1` (derives portless aliases from a supervisor's YAML). Four `portless.json` asset templates cover single-app, monorepo, custom-TLD-documented, and `package.json`-inline patterns.
+- 🎛️ **`process-compose-ops` skill** - Comprehensive operations for [Process Compose](https://github.com/F1bonacc1/process-compose), the Go-binary supervisor replacing PM2/supervisord/Foreman for non-containerised local services. Six reference files: `schema-reference.md` (full YAML schema with field semantics, defaults, and command-quoting gotchas including Windows-PATH backslash handling), `probe-patterns.md` (readiness probe recipes per stack — Python/Go/Node/TCP-only/daemons), `dependency-patterns.md` (`depends_on` patterns: companion daemons, DB-before-app, tunnel-after-service, one-shot init), `tui-shortcuts.md` (TUI keybindings cheatsheet, status legend, search/sort), `boot-persistence-windows.md` (Task Scheduler with `S4U` logon and PATH-aware wrapper script), `supply-chain-verification.md` (SHA-256 verification procedure for the binary). Four runnable scripts: `install-process-compose.ps1` (verified download + extract + writes `VERIFICATION.md`), `verify-binary.ps1` (re-verifies committed binary hash), plus boot wrapper and Task Scheduler installer templates. Five YAML assets: Python service, Django+companions, Go binary, Cloudflare tunnel pattern, cron job. Material derived from a 3-hour production migration from PM2+Caddy+Dagu to Process Compose+portless, anonymised for general use.
+- 📦 **Plugin manifest catch-up** - `summon` (v2.4.11) and `fleet-ops` (post-v2.4.11) were committed and listed in README but never added to `.claude-plugin/plugin.json`'s `components.skills` array, so they weren't being indexed by the plugin system. Both registered correctly now alongside the new pair.
+
 **v2.4.11** (May 2026)
 - ✨ **`summon` skill** - Push Claude Desktop Code-tab sessions across accounts so they appear in the next account you switch to. Best run *before* switching — while still on your current near-limit account, push mid-flight sessions to the destination, then Logout/Login as the natural switch. Default is copy (sessions visible from both accounts); `--move` for lean cleanup. Hierarchical Account → Project → Session picker with global numbering, `--peek <id>` for transcript preview, `--list-accounts` inventory, recency aliases (`--1d/--3d/--7d/--all`), 8-hint rotating tip system. Output follows `docs/DESIGN.md` (Terminal Panel Design System).