everything-gemini 1.2.0 → 1.9.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Report a bug, broken hook, or invalid schema in everything-gemini
+title: '[BUG] '
+labels: 'bug, triage'
+assignees: ''
+---
+
+### Describe the Bug
+<!-- A clear and concise description of what the bug is. -->
+
+### Environment & Surface
+- **Surface**: [e.g. Desktop 2.0, Antigravity IDE, agy CLI, Python SDK]
+- **everything-gemini version**: [e.g. 1.2.0 or commit hash]
+- **Node.js version**: [e.g. 20.18.0]
+- **OS**: [e.g. macOS 14.5, Ubuntu 22.04, Windows 11]
+
+### Steps to Reproduce
+1. Run command: `...`
+2. Perform action: `...`
+3. See error: `...`
+
+### Expected Behavior
+<!-- What did you expect to happen? -->
+
+### CLI Diagnostics Output
+<!-- Output of: everything-gemini doctor -->
+```text
+```

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature Request
+about: Suggest an idea or enhancement for everything-gemini
+title: '[FEAT] '
+labels: 'enhancement'
+assignees: ''
+---
+
+### Problem Statement / Motivation
+<!-- Is your feature request related to a problem? Please describe clearly. -->
+
+### Proposed Solution
+<!-- A clear and concise description of what you want to happen. -->
+
+### Alternatives Considered
+<!-- A clear and concise description of any alternative solutions or features you've considered. -->
+
+### Target Ecosystem Area
+- [ ] Progressive Disclosure Skills (`skills/`)
+- [ ] Scoped Subagents (`agents/`)
+- [ ] Lifecycle Hooks (`hooks/`)
+- [ ] CLI & Package Distribution (`bin/everything-gemini`)
+- [ ] MCP Blueprint Configurations (`mcp/`)
+- [ ] Documentation / Showcase Site (`docs/`)
+
+### Additional Context
+<!-- Add any other context, mockups, or screenshots about the feature request here. -->

package/.github/ISSUE_TEMPLATE/subagent_proposal.md

@@ -0,0 +1,29 @@
+---
+name: Subagent Proposal
+about: Propose a new scoped subagent specification for everything-gemini
+title: '[AGENT] '
+labels: 'agent, subagent, enhancement'
+assignees: ''
+---
+
+### Subagent Identifier
+<!-- e.g. database-migrator, doc-writer, kubernetes-deployer (must be kebab-case) -->
+
+### Core Role & Mission
+<!-- 1-2 sentences describing what this specialized subagent is designed to do. -->
+
+### Permitted & Forbidden Tools
+- **Permitted Tools**: <!-- e.g. view_file, grep_search, run_command -->
+- **Forbidden / Restricted Tools**: <!-- e.g. write_to_file, replace_file_content, destructive commands -->
+
+### Subagent Operating Principles
+1. Principle 1:
+2. Principle 2:
+3. Principle 3:
+
+### Handoff Contract
+<!-- Describe the structured Markdown report format the subagent returns to its parent orchestrator. -->
+- Executive Summary
+- Modified Files
+- Automated Verification Output
+- Open Blockers / Questions

package/.github/workflows/ci.yml

@@ -9,7 +9,10 @@ on:
 jobs:
   validate:
     name: Validate Skills, Rules & Hooks
-    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
 
     steps:
       - name: Checkout Repository
@@ -33,3 +36,71 @@ jobs:
         run: |
           node bin/everything-gemini doctor
           node bin/everything-gemini list
+
+      - name: Verify Skill Validation & Info CLI
+        run: |
+          node bin/everything-gemini test-skill agent-evals
+          node bin/everything-gemini info agent-evals
+          node bin/everything-gemini info planner
+          node bin/everything-gemini info gemini-shield
+          node bin/everything-gemini info antigravity-sdk-orchestrator
+
+      - name: Verify Benchmark & Shell Completion
+        run: |
+          npm run benchmark
+          npm run completion
+          node bin/everything-gemini --version
+
+      - name: Verify Installer Script (install.sh)
+        run: |
+          bash scripts/install.sh --profile developer --workspace ./tmp-ci-agents
+
+      - name: Self-Test Composite GitHub Action (action.yml)
+        uses: ./
+        with:
+          profile: developer
+          global: false
+          workspace: ./tmp-action-agents
+
+      - name: Verify Component Add & Remove CLI
+        run: |
+          node bin/everything-gemini add skill tdd-workflow
+          node bin/everything-gemini remove skill tdd-workflow
+          node bin/everything-gemini add hook safety-shield
+          node bin/everything-gemini remove hook safety-shield
+
+      - name: Cleanup Temporary Test Directories
+        run: |
+          node -e "['./tmp-ci-agents', './tmp-action-agents'].forEach(d => { try { require('fs').rmSync(d, {recursive: true, force: true}); } catch(e){} })"
+
+  windows-test:
+    name: Validate Windows PowerShell & CLI
+    runs-on: windows-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Test PowerShell Installer (install.ps1)
+        shell: powershell
+        run: |
+          powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Profile developer -Workspace .\tmp-win-agents
+
+      - name: Test CLI on Windows
+        run: |
+          node bin\everything-gemini doctor
+          node bin\everything-gemini --version
+          node bin\everything-gemini test-all --json
+          node bin\everything-gemini status --json
+          node tests\cli.test.js
+
+      - name: Cleanup Windows Test Workspace
+        shell: powershell
+        run: |
+          if (Test-Path .\tmp-win-agents) {
+            Remove-Item -Recurse -Force .\tmp-win-agents
+          }

package/.github/workflows/release.yml

@@ -3,7 +3,13 @@ name: Release & Publish
 on:
   push:
     tags:
-      - 'v*'
+      - 'v[0-9]+.[0-9]+.[0-9]+*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Release tag to publish (leave empty for current HEAD)'
+        required: false
+        default: ''
 
 jobs:
   build-and-publish:
@@ -12,16 +18,22 @@ jobs:
     permissions:
       contents: write
       id-token: write
+    env:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+      NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'
+          scope: '@salmandev'
 
       - name: Make Scripts Executable
         run: |
@@ -33,6 +45,7 @@ jobs:
         run: npm test
 
       - name: Create GitHub Release
+        if: startsWith(github.ref, 'refs/tags/v')
         uses: softprops/action-gh-release@v2
         with:
           generate_release_notes: true
@@ -41,9 +54,11 @@ jobs:
             README.md
             CHANGELOG.md
 
+      - name: Verify Package Contents
+        run: npm pack --dry-run
+
       - name: Publish to NPM
         if: env.NPM_TOKEN != ''
         run: npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -4,6 +4,146 @@ All notable changes to **Everything Gemini (`everything-gemini`)** will be docum
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.0] - 2026-10-19
+
+### Added
+- **56 Progressive Disclosure Skills & 75-Component Ecosystem Milestone**:
+  - **`milvus-vector-clustering`**: Enterprise Milvus vector clustering, HNSW vs. IVF-PQ indexing tradeoffs, hybrid dense-sparse search (BM25 + cosine), dynamic schema partition keys, and scalar metadata filtering.
+  - **`cloudflare-r2-object-storage`**: Zero-egress fee object storage, S3-compatible APIs, pre-signed upload URL delegation, multipart parallel streaming uploads, and Workers edge CDN caching.
+  - **`vault-secrets-management`**: HashiCorp Vault enterprise secrets orchestration, AppRole machine-to-machine authentication, dynamic ephemeral database credentials with auto-revocation, and PKI mTLS certificate rotation.
+  - **`distributed-rate-limiting`**: High-throughput distributed rate limiting architectures, Redis Lua script atomic sliding window logs, token bucket replenishment, tiered tenant quotas, and RFC 6585 compliance.
+- **12th Scoped Subagent Fleet Expansion**:
+  - **`platform-engineer`** ([`agents/platform-engineer.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/platform-engineer.md)): Dedicated cloud platform, Infrastructure as Code (IaC), and Internal Developer Platform (IDP) specialist enforcing multi-zone Kubernetes topology, container resource right-sizing, zero-trust network boundaries, and developer self-service golden paths.
+- **CLI Workspace Synchronization & Unified Component Scaffolding**:
+  - **`everything-gemini sync`**: Synchronize installed workspace skills, subagents, and hooks against the latest catalog, verifying checksum integrity and auto-updating stale components with `--dry-run` and `--json` support.
+  - **`everything-gemini scaffold <skill|agent|hook> <name>`** (aliases `new`, `create`): Scaffold 100% compliant progressive disclosure skills, scoped subagent specifications, and lifecycle hooks with YAML frontmatter, reference schemas, and executable helper scripts.
+  - Expanded shell completion scripts (`bin/everything-gemini completion`) for Bash and Zsh to autocomplete `sync`, `scaffold`, all 56 skills, and 12 subagents.
+- **Curated MCP Puppeteer Blueprint**:
+  - Added `@modelcontextprotocol/server-puppeteer` to [`mcp/mcp_config.example.json`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/mcp_config.example.json), [`templates/full-power/mcp_config.json`](file:///Users/salmanshaikh/development/github/everything-gemini/templates/full-power/mcp_config.json), and [`mcp/README.md`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/README.md) for headless browser automation and visual testing.
+- **Cloud Platform Provisioning Pipeline (`examples/python-sdk/platform_provisioning_pipeline.py`)**:
+  - 4-stage multi-agent infrastructure delivery loop orchestrating Architect -> Platform Engineer -> Security Auditor -> Release Engineer using the Python SDK.
+- **29-Assertion Automated E2E Test Suite & Benchmark**:
+  - Expanded `tests/cli.test.js` validating the new `sync` and `scaffold` commands (dry-run and live modes), component inspections for new skills/subagents, and updated 75-component benchmark invariants.
+- **Showcase Web App 75-Component Expansion**:
+  - Catalog and live metrics on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/) updated to 56 progressive skills, 12 subagents, 7 hooks, and `v1.9.0` release badge.
+
+## [1.8.0] - 2026-10-19
+
+### Added
+- **52 Progressive Disclosure Skills & 70-Component Ecosystem Milestone**:
+  - **`vllm-inference`**: High-throughput LLM serving, PagedAttention KV cache memory management, continuous iteration-level batching, multi-GPU tensor parallelism, and OpenAI-compatible API architecture.
+  - **`debezium-cdc`**: Change Data Capture (CDC) streaming architectures using Debezium, PostgreSQL logical decoding (`pgoutput`), Kafka Connect, strict partition ordering, and transactional outbox patterns.
+  - **`cilium-ebpf-networking`**: Cloud-native eBPF networking, Kubernetes CNI replacement, transparent mTLS/WireGuard encryption, L7 CiliumNetworkPolicies, and Hubble network observability.
+  - **`litellm-proxy-gateway`**: Enterprise LLM proxy gateway, multi-provider routing (Gemini, Claude, OpenAI, vLLM), virtual keys, budget tracking, fallback cascading, and rate-limiting.
+- **11th Scoped Subagent Fleet Expansion**:
+  - **`incident-responder`** ([`agents/incident-responder.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/incident-responder.md)): Dedicated Site Reliability Engineering (SRE) and production triage specialist enforcing rapid incident triage (SEV-1/SEV-2), OpenTelemetry trace correlation, blast radius containment, canary rollback mitigation, and blameless postmortems.
+- **CLI Offline Distribution Bundle Command (`everything-gemini bundle [profile]`)**:
+  - Package self-contained, air-gapped distribution archives or directories with auto-generated `bundle-manifest.json` (SHA-256 integrity digests of all assets) and executable `offline-install.sh`. Supports `--dry-run` and `--json` for automated CI/CD gating.
+  - Expanded shell completion scripts (`bin/everything-gemini completion`) for Bash and Zsh to autocomplete `bundle`, `pack`, all 52 skills, and 11 subagents.
+- **Curated MCP Slack Blueprint**:
+  - Added `@modelcontextprotocol/server-slack` to [`mcp/mcp_config.example.json`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/mcp_config.example.json), [`templates/full-power/mcp_config.json`](file:///Users/salmanshaikh/development/github/everything-gemini/templates/full-power/mcp_config.json), and [`mcp/README.md`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/README.md) for automated incident room management and alert broadcasting.
+- **Automated Incident Triage Pipeline (`examples/python-sdk/incident_triage_pipeline.py`)**:
+  - 4-stage multi-agent SRE triage loop orchestrating Incident Responder -> Performance Tuner -> Release Engineer -> Postmortem Generator using the Python SDK.
+- **26-Assertion Automated E2E Test Suite & Benchmark**:
+  - Expanded `tests/cli.test.js` validating the new `bundle` command (dry-run and live modes), component inspections for new skills/subagents, and updated 70-component benchmark invariants.
+- **Showcase Web App 70-Component Expansion**:
+  - Catalog and live metrics on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/) updated to 52 progressive skills, 11 subagents, 7 hooks, offline bundle preset, and `v1.8.0` release badge.
+
+## [1.7.0] - 2026-10-18
+
+### Added
+- **48 Progressive Disclosure Skills & 65-Component Ecosystem Milestone**:
+  - **`langgraph-orchestrator`**: Production multi-agent StateGraphs, cyclic branching, persistent checkpointers (`MemorySaver` / `AsyncPostgresSaver`), and human-in-the-loop validation (`interrupt_before`).
+  - **`playwright-visual-regression`**: Automated pixelmatch screenshot diffing, cross-browser viewport matrices, dynamic element masking, and containerized Docker stability.
+  - **`open-telemetry-tracing`**: End-to-end distributed tracing, OTLP HTTP/gRPC exporters, W3C `traceparent` propagation, custom span attributes, and metric correlations.
+  - **`argo-workflows`**: Kubernetes-native DAG workflows, artifact passing (S3/GCS/MinIO), container steps, exponential retry strategies, and CronWorkflows.
+- **10th Scoped Subagent Fleet Expansion**:
+  - **`release-engineer`** ([`agents/release-engineer.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/release-engineer.md)): Dedicated release gatekeeper enforcing Semantic Versioning (`semver`), automated changelog compilation, build artifact checksumming, git release tagging, and canary rollouts.
+- **CLI Ecosystem Audit Command (`everything-gemini audit [path]`)**:
+  - Comprehensive static quality inspection across skills (YAML frontmatter schema and token budgets), subagents (role, permissions, handoff contracts), lifecycle hooks (`chmod +x` executability), and secret hygiene. Supports both human-readable terminal output and `--json` format for automated CI integration.
+  - Expanded shell completion scripts (`bin/everything-gemini completion`) for Bash and Zsh to autocomplete `audit`, all 48 skills, and 10 subagents.
+- **Curated MCP Sentry Blueprint**:
+  - Added `@modelcontextprotocol/server-sentry` to [`mcp/mcp_config.example.json`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/mcp_config.example.json), [`templates/full-power/mcp_config.json`](file:///Users/salmanshaikh/development/github/everything-gemini/templates/full-power/mcp_config.json), and [`mcp/README.md`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/README.md) for real-time error tracking and issue triage.
+- **Automated Release Readiness Pipeline (`examples/python-sdk/release_readiness_audit.py`)**:
+  - 4-stage multi-agent qualification loop orchestrating Planner -> Code Reviewer -> Security Auditor -> Release Engineer before release candidate tagging.
+- **24-Assertion Automated E2E Test Suite & Benchmark**:
+  - Expanded `tests/cli.test.js` validating the new `audit` command (terminal reports and `--json`), component inspections for new skills/subagents, and updated 65-component benchmark invariants.
+- **Showcase Web App 65-Component Expansion**:
+  - Catalog and live metrics on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/) updated to 48 progressive skills, 10 subagents, 7 hooks, and `v1.7.0` release badge.
+
+## [1.6.0] - 2026-10-18
+
+### Added
+- **44 Progressive Disclosure Skills & 60-Component Ecosystem Milestone**:
+  - **`turborepo-monorepo`**: High-performance monorepo build orchestration, declarative task graphs (`turbo.json`), hash-based remote caching, micro-frontend package boundaries, and Docker deployment pruning (`turbo prune`).
+  - **`dbt-transformation`**: Production data engineering with dbt Core, modular DAG modeling (`stg_`, `int_`, `fct_`), Jinja macros, incremental idempotency, and automated schema testing (`dbt test`).
+  - **`apache-kafka-streams`**: Resilient event-driven streaming with KafkaJS, transactional exactly-once processing (EOS), cooperative sticky partition rebalancing, and stateful tumbling time-window aggregations.
+  - **`grpc-connect-rpc`**: Modern, browser-native RPC services using Connect-ES and Connect-Go, type-safe streaming without Envoy proxy bottlenecks, Buf schema registry workflows, and compact binary Protobuf serialization.
+- **9th Scoped Subagent Fleet Expansion**:
+  - **`documentation-writer`** ([`agents/documentation-writer.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/documentation-writer.md)): Dedicated technical documentation and architectural runbook specialist enforcing Antigravity progressive disclosure principles, strict frontmatter conventions, and clickable `file://` hyperlink integrity.
+- **Curated MCP Sequential Thinking Blueprint**:
+  - Added `@modelcontextprotocol/server-sequential-thinking` to [`mcp/mcp_config.example.json`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/mcp_config.example.json), [`templates/full-power/mcp_config.json`](file:///Users/salmanshaikh/development/github/everything-gemini/templates/full-power/mcp_config.json), and [`mcp/README.md`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/README.md) for dynamic step-by-step problem decomposition and hypothesis revision.
+- **CLI Search & Discovery Command (`everything-gemini search <query>`)**:
+  - Integrated full ecosystem search across skills, subagents, lifecycle hooks, and MCP blueprints with colored terminal cards and `--json` format output for scripting and IDE integration.
+  - Expanded shell completion scripts (`bin/everything-gemini completion`) for Bash and Zsh to autocomplete `search`, `find`, all 44 skills, and 9 subagents.
+- **Automated Documentation Audit Pipeline (`examples/python-sdk/documentation_audit_pipeline.py`)**:
+  - Python SDK automation pipeline verifying documentation integrity, frontmatter schema adherence, broken link detection, and token budget enforcement.
+- **22-Assertion Automated E2E Test Suite & Benchmark**:
+  - Expanded `tests/cli.test.js` validating the new `search` command (terminal cards and `--json`), component inspection for new skills/subagents, and updated 60-component benchmark invariants.
+- **Showcase Web App 60-Component Expansion**:
+  - Catalog and live metrics on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/) updated to 44 progressive skills, 9 subagents, 7 hooks, and `v1.6.0` release badge.
+
+## [1.5.0] - 2026-10-17
+
+### Added
+- **40 Progressive Disclosure Skills & 55-Component Milestone**:
+  - **`duckdb-local-olap`**: Embedded in-process analytical SQL (OLAP), direct zero-copy Apache Arrow querying, S3 Parquet integration, and MotherDuck hybrid cloud synchronization.
+  - **`nats-jetstream`**: Production event-driven messaging, at-least-once & exactly-once semantics, consumer deduplication windows, KV distributed buckets, and ephemeral push/pull consumers.
+  - **`axum-web-service`**: Ergonomic, high-performance Rust web service architecture with Tokio async runtime, Tower middleware chains, compile-time SQLx queries, and RFC 7807 error envelopes.
+- **Agent Profile Import Command (`everything-gemini import`)**:
+  - Full CLI roundtrip management: import exported agent profiles (`everything-gemini-profile.json`) into workspace (`.agents/`) or global (`~/.gemini/config/`) targets with `--dry-run` simulation safety.
+- **Autonomous Multi-Agent Pipeline Harness (`examples/python-sdk/multi_agent_pipeline.py`)**:
+  - End-to-end 4-stage pipeline orchestrating Planner -> Database Migrator -> Performance Tuner -> Code Reviewer using the official `google-antigravity` Python SDK with automated syntax verification.
+- **19-Assertion Automated E2E Test Suite**:
+  - Expanded `tests/cli.test.js` validating the new `import` command across dry-run simulations, file-path sources, and target locations, alongside updated 55-component benchmark checks.
+- **Showcase Web App 55-Component Expansion**:
+  - Catalog and metrics on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/) updated to 40 progressive skills and `v1.5.0` badge.
+
+## [1.4.0] - 2026-10-17
+
+### Added
+- **37 Progressive Disclosure Skills & 52-Component Milestone**:
+  - **`clickhouse-analytics`**: High-throughput OLAP schemas, MergeTree engines, Kafka streaming ingestion, and vector similarity search.
+  - **`temporal-workflows`**: Fault-tolerant distributed workflow orchestration, retry policies, async activities, and saga compensations.
+  - **`trpc-react-query`**: End-to-end type safety with tRPC v11 routers, TanStack React Query v5 cache management, and optimistic UI mutations.
+  - **`wasm-rust-optimizer`**: High-performance WebAssembly compilation from Rust using `wasm-pack`, zero-copy memory buffers (`Uint8Array`), and SIMD.
+- **8 Scoped Subagents Fleet**:
+  - **`database-migrator`**: Dedicated database schema evolution specialist designing zero-downtime expand/contract SQL migrations and rollback safety.
+  - **`performance-tuner`**: Systems performance specialist diagnosing flamegraphs, memory leaks, slow database query plans, and N+1 waterfalls.
+- **7th Lifecycle Safety Gate (`secret-scrubber`)**:
+  - PreToolUse security gate intercepting file write operations (`write_to_file`, `replace_file_content`, `multi_replace_file_content`) to block accidental raw credential leaks (AWS, OpenAI, Gemini, GitHub PAT, Stripe, and private keys).
+- **New CLI Commands (`diff` and `export`)**:
+  - `everything-gemini diff`: Compares installed workspace components against master catalog to inspect local modifications vs upstream updates.
+  - `everything-gemini export`: Exports installed skills, subagents, and hook configurations into portable JSON bundles (`everything-gemini-profile.json`).
+- **Expanded Curated MCP Blueprints**:
+  - Added `@modelcontextprotocol/server-docker` (container inspection) and `@modelcontextprotocol/server-clickhouse` (real-time OLAP).
+- **18-Assertion Automated E2E Test Suite**:
+  - Expanded `tests/cli.test.js` validating `diff`, `export`, and new subagent/skill inspections across all platforms.
+
+## [1.3.0] - 2026-10-16
+
+### Added
+- **33 Progressive Disclosure Skills Milestone**:
+  - **`fastapi-production`**: Production async FastAPI architecture, Pydantic v2 schemas, lifespan context management, JWT auth, dependency injection, and Kubernetes health probes.
+  - **`redis-cache-patterns`**: Enterprise Redis caching (cache-aside with jitter), safe distributed locks with atomic Lua token release (Redlock), sliding-window rate limiting, and streams.
+  - **`svelte-kit-architect`**: Modern SvelteKit web applications using Svelte 5 runes (`$state`, `$derived`, `$effect`, `$props`), SSR/prerendering, and progressive form actions.
+- **Viral Launch & Distribution Kit (`docs/launch-kit.md`)**:
+  - Comprehensive copy-paste submissions for Hacker News (Show HN), X/Twitter 6-tweet launch thread, Reddit (r/LocalLLaMA & r/programming), and Product Hunt.
+- **Showcase Web App 45-Component Expansion**:
+  - Live index now hosts 33 progressive skills, 6 scoped subagents, and 6 lifecycle hooks with instant search and 1-click CLI copy buttons.
+- **CLI Shell Completion Updates**:
+  - Added new skills to Bash and Zsh autocomplete dictionary in `everything-gemini completion`.
+
 ## [1.2.0] - 2026-10-15
 
 ### Added
@@ -11,6 +151,44 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
   - **`agent-evals`**: Automated evaluation pipelines, LLM-as-a-judge rubrics, golden test datasets, and regression testing.
   - **`docker-compose-orchestrator`**: Multi-container local environments (Postgres + pgvector, Redis), healthcheck dependency wiring, and persistent volumes.
   - **`graphql-architect`**: Schema-first GraphQL APIs, DataLoader N+1 query batching, and Relay cursor-based pagination.
+- **Universal Terminal Playbook Inspector (`info` / `show`)**:
+  - `everything-gemini info <name>` seamlessly inspects and previews runbooks for skills, subagent specifications, and lifecycle hook configurations directly in the terminal.
+- **Granular Lifecycle Hook Management**:
+  - Added `everything-gemini add hook <name>` and `everything-gemini remove hook <name>` with automatic execution permission enforcement (`chmod +x`) on hook scripts.
+- **Interactive Web Showcase 42-Component Expansion**:
+  - Complete index of all 30 progressive skills, 6 scoped subagents, and 6 lifecycle hooks on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/).
+  - Direct GitHub spec links (`View Spec ↗`) and 1-click CLI copy buttons (`Copy Add CLI`) on every catalog card.
+  - Dedicated `Lifecycle Hooks` filter pill and amber badge styling (`.tag-hook`).
+- **Multi-OS CI Matrix**:
+  - Automated GitHub Actions testing across `ubuntu-latest` and `macos-latest` verifying validations, CLI diagnostics, and skill test runners.
+- **Composite GitHub Action (`action.yml`)**:
+  - Official GitHub composite action allowing any CI/CD workflow to run `- uses: salmandev/everything-gemini@v1` with configurable profile and scope inputs.
+- **Ecosystem Benchmark Suite (`everything-gemini test-all`)**:
+  - High-speed terminal diagnostic benchmark verifying all 42 ecosystem components, computing token metrics (~15,500 total tokens) and demonstrating >85% token reduction per turn.
+- **Shell Autocompletion Generator (`everything-gemini completion`)**:
+  - Native Bash and Zsh autocomplete generation for commands, profiles, and component types.
+- **Ecosystem Status Dashboard (`everything-gemini status` / `check`)**:
+  - Live terminal dashboard reporting installed progressive skills, scoped subagents, lifecycle hooks, and active rules across local (`.agents/`) or global (`~/.gemini/config/`) targets.
+- **Ecosystem Update Pipeline (`everything-gemini update`)**:
+  - In-place synchronization updating installed skills, subagent definitions, and hook configurations from the master catalog without destructive overwrites.
+- **Persistent Semantic Memory & Web Fetch MCP Blueprints**:
+  - Curated `@modelcontextprotocol/server-memory` (knowledge graph semantic memory across agent sessions) and `@modelcontextprotocol/server-fetch` in `mcp/mcp_config.example.json` and `templates/full-power/mcp_config.json`.
+- **Python SDK Test Suite & Compilation Validation**:
+  - Added native Python syntax compilation verification (`python3 -m py_compile`) to `scripts/validate.sh` to ensure all Python SDK examples compile without syntax or import errors.
+- **Dry Run Simulation (`--dry-run`)**:
+  - Zero-risk previews for `everything-gemini install` and `everything-gemini update` that detail which files, rules, skills, and hooks would be created without disk mutations.
+- **Machine-Readable JSON Output (`--json`)**:
+  - Full structured JSON payloads for `everything-gemini status --json` and `everything-gemini benchmark --json`, ideal for CI/CD scripting and automated health checks.
+- **Automated CLI E2E Test Suite (`tests/cli.test.js`)**:
+  - 15-assertion integration test suite validating doctor, list, dry-run installations, workspace isolation, component addition/removal, completion installation, and JSON exports across all operating systems.
+- **Automated Shell Completion Installer (`everything-gemini completion --install`)**:
+  - Automatically and idempotently installs tab completions into user shell configuration files (`~/.zshrc`, `~/.bashrc`, or custom `--rc`) with `--dry-run` inspection.
+- **Curated Redis Cache MCP Server Blueprint**:
+  - Added `@modelcontextprotocol/server-redis` to `mcp/mcp_config.example.json`, `templates/full-power/mcp_config.json`, and documented in `mcp/README.md`.
+- **Automated Relative Documentation Link Validator**:
+  - Integrated recursive markdown relative link verification into Phase 3 of `scripts/validate.sh` to prevent broken links across all documentation and skill files.
+- **Community Contributor Onboarding & Wishlist**:
+  - Added GitHub issue templates for Subagent Proposals and Feature Requests, plus a curated wishlist of high-demand skills in `CONTRIBUTING.md`.
 - **Enterprise Security Policy**: Added [`SECURITY.md`](SECURITY.md) establishing formal vulnerability disclosure workflows.
 - **IDE Extensions**: Added [`.vscode/extensions.json`](.vscode/extensions.json) for developer workspace onboarding.
 

package/CONTRIBUTING.md

@@ -78,9 +78,42 @@ plugins/<plugin-name>/
 
 ---
 
+### 5. Scoped Subagents Standards (`agents/<agent-name>.md`)
+Subagents are specialized workers with strict cognitive boundaries:
+* Store specifications in `agents/<agent-name>.md`.
+* Each specification must define:
+  1. **Core Role & Objectives**: Precise task responsibility (e.g. Code Reviewer, Browser QA).
+  2. **Execution Guardrails**: Boundaries prohibiting actions outside the subagent's scope.
+  3. **Delegation Protocol**: How the primary agent passes context to this subagent and how the subagent reports back.
+
+---
+
+## 🛠️ CLI Developer Tools & Scaffolding
+
+Everything Gemini provides built-in developer tools to streamline adding new components:
+
+```bash
+# Scaffold a new progressive disclosure skill with frontmatter, references & scripts
+./bin/everything-gemini new-skill my-awesome-skill
+
+# Scaffold a new scoped subagent specification
+./bin/everything-gemini new-agent my-custom-agent
+
+# Validate frontmatter and scripts for your new skill
+./bin/everything-gemini test-skill my-awesome-skill
+
+# Inspect runbook preview in the terminal
+./bin/everything-gemini info my-awesome-skill
+
+# Benchmark token savings and run self-tests across all 70 ecosystem components
+./bin/everything-gemini test-all
+```
+
+---
+
 ## 🧪 Validating Your Changes
 
-Before submitting a Pull Request, run the automated validation suite:
+Before submitting a Pull Request, run the automated 5-phase validation suite:
 
 ```bash
 # Run the validator script
@@ -88,16 +121,69 @@ bash scripts/validate.sh
 
 # Or via npm
 npm test
+
+# Run ecosystem benchmark
+npm run benchmark
 ```
 
 The validator checks:
-- [x] All `SKILL.md` files have proper YAML frontmatter with `name` and `description`.
-- [x] All JSON files (`package.json`, `plugin.json`, `hooks.json`, `mcp_config.json`) are syntactically valid JSON.
-- [x] All hook scripts are executable (`chmod +x`).
+- [x] All `SKILL.md` files have proper YAML frontmatter with `name` and third-person `description`.
+- [x] All Scoped Subagent specifications (`agents/*.md`) exist and are non-empty.
+- [x] All JSON files (`package.json`, `plugin.json`, `hooks.json`, `mcp_config.json`, `.vscode/`) are syntactically valid JSON.
+- [x] All hook and validation scripts are executable (`chmod +x`).
 - [x] No broken relative links within skills and documentation.
 
 ---
 
+## 🎯 Community Wishlist & Good First Issues
+
+Looking for inspiration on what to contribute? The community has requested the following progressive disclosure skills and subagents:
+
+### 🌟 High-Demand Skills Wishlist
+| Skill Identifier | Category | Purpose | Status |
+| :--- | :--- | :--- | :--- |
+| **`clickhouse-analytics`** | Database | High-throughput OLAP schemas, MergeTree engines, and vector search | ✅ *Shipped in v1.4.0* |
+| **`temporal-workflows`** | Orchestration | Resilient distributed workflows, retry policies, and saga patterns | ✅ *Shipped in v1.4.0* |
+| **`trpc-react-query`** | Fullstack | End-to-end type safety, tRPC v11 routers, and TanStack Query v5 | ✅ *Shipped in v1.4.0* |
+| **`wasm-rust-optimizer`** | Performance | WebAssembly compilation with `wasm-pack`, zero-copy Uint8Array | ✅ *Shipped in v1.4.0* |
+| **`fastapi-production`** | Python AI | Pydantic v2, lifespan handlers, JWT auth, and K8s probes | ✅ *Shipped in v1.3.0* |
+| **`redis-cache-patterns`** | Backend | Distributed locks (Redlock), sliding-window rate limits, and streams | ✅ *Shipped in v1.3.0* |
+| **`duckdb-local-olap`** | Database | Embedded in-process OLAP, Parquet querying, and MotherDuck sync | ✅ *Shipped in v1.5.0* |
+| **`nats-jetstream`** | Messaging | Ultra-low latency event streaming, consumer acks, and pub/sub | ✅ *Shipped in v1.5.0* |
+| **`axum-web-service`** | Rust | Tokio async, tower middlewares, type-safe state, and SQLx | ✅ *Shipped in v1.5.0* |
+| **`turborepo-monorepo`** | Tooling | High-performance monorepo build caching, task pipelines, and workspace boundaries | ✅ *Shipped in v1.6.0* |
+| **`dbt-transformation`** | Data Eng | Modular SQL transformations, Jinja macros, and automated data testing | ✅ *Shipped in v1.6.0* |
+| **`apache-kafka-streams`** | Streaming | Exactly-once event streaming, stateful window aggregations, and consumer groups | ✅ *Shipped in v1.6.0* |
+| **`grpc-connect-rpc`** | API | Lightweight, browser-compatible gRPC and Protocol Buffers with Connect-ES / Connect-Go | ✅ *Shipped in v1.6.0* |
+| **`langgraph-orchestrator`** | AI Agents | Multi-agent stategraphs, cyclic branching, and human-in-the-loop validation | ✅ *Shipped in v1.7.0* |
+| **`playwright-visual-regression`** | Testing | Pixelmatch diffs, trace recording, and headless container snapshots | ✅ *Shipped in v1.7.0* |
+| **`open-telemetry-tracing`** | Observability | Distributed tracing with OTLP exporters, span contexts, and metrics | ✅ *Shipped in v1.7.0* |
+| **`argo-workflows`** | Cloud Native | Kubernetes CRD workflows, DAG step execution, and artifact passing | ✅ *Shipped in v1.7.0* |
+| **`vllm-inference`** | AI Serving | PagedAttention KV cache, continuous batching, and tensor parallelism | ✅ *Shipped in v1.8.0* |
+| **`debezium-cdc`** | Data Eng | Change Data Capture (CDC) streaming from PostgreSQL / MySQL to Kafka / PubSub | ✅ *Shipped in v1.8.0* |
+| **`cilium-ebpf-networking`** | Cloud Native | eBPF-based service mesh, L7 security policies, and transparent encryption | ✅ *Shipped in v1.8.0* |
+| **`litellm-proxy-gateway`** | AI Gateway | Unified OpenAI-compatible multi-provider routing, fallback budgets, and load balancing | ✅ *Shipped in v1.8.0* |
+| **`milvus-vector-clustering`** | Vector DB | High-scale vector clustering, HNSW/IVF-PQ indexing, and hybrid dense-sparse search | ✅ *Shipped in v1.9.0* |
+| **`cloudflare-r2-object-storage`** | Storage | S3-compatible zero-egress object storage, pre-signed upload URLs, and Workers CDN | ✅ *Shipped in v1.9.0* |
+| **`vault-secrets-management`** | Security | HashiCorp Vault enterprise secrets orchestration, dynamic DB roles, and PKI mTLS | ✅ *Shipped in v1.9.0* |
+| **`distributed-rate-limiting`** | Traffic | Redis sliding-window logs, token buckets, tiered quotas, and RFC 6585 compliance | ✅ *Shipped in v1.9.0* |
+| **`keda-autoscaling`** | Cloud Native | Event-driven Kubernetes workload autoscaling (Kafka, SQS, RabbitMQ, Redis) | 🚀 *Open for PR* |
+| **`chromadb-vector-store`** | AI Eng | Embedded and client/server vector embeddings, HNSW indexing, and collection filters | 🚀 *Open for PR* |
+| **`opa-gatekeeper`** | Policy | Open Policy Agent (OPA) admission control, Rego constraints, and pod security standards | 🚀 *Open for PR* |
+| **`fal-ai-media`** | Generative AI | Ultra-fast multimodal diffusion, video generation, and real-time inference endpoints | 🚀 *Open for PR* |
+| **`iceberg-lakehouse`** | Data Lake | Apache Iceberg table format, ACID metadata, hidden partitioning, and time-travel | 🚀 *Open for PR* |
+
+### How to Build a Wishlist Item:
+1. Open an issue using the [Skill Proposal template](.github/ISSUE_TEMPLATE/skill_proposal.md).
+2. Scaffold the skill instantly using the CLI:
+   ```bash
+   ./bin/everything-gemini new-skill svelte-kit-architect
+   ```
+3. Author procedural instructions in `SKILL.md` (< 250 lines) and put deep reference docs in `references/spec.md`.
+4. Validate with `npm test` and submit your Pull Request!
+
+---
+
 ## 📝 Pull Request Process
 
 1. Fork the repository and create your branch from `main`: