# Changelog

All notable user-visible changes to open-forge are documented here.

Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

## [Unreleased]

## [0.24.0] — 2026-05-03

### Added
- **gstack companion recommendation** — skill now surfaces Grafana + Prometheus + Loki as a recommended observability companion for any deployed app; new monitoring module covers scrape config, dashboards, and alert rules
- `references/modules/monitoring.md` — reusable module for attaching metrics/logs collection to any recipe

## [0.23.1] — 2026-05-03

### Added
- `ARCHITECTURE.md` — 200-line walkthrough of the four actors (maintainer, bot, AI sessions, end users), state stores, contribution pipeline, and anti-patterns; cross-linked from README and AGENTS.md
- Updated recipe count in README, AGENTS.md, and CLAUDE.md to reflect 950+ → 1,100+ catalog entries

## [0.23.0] — 2026-05-02

### Added
- **Backups module** (`references/modules/backups.md`) — reusable backup patterns for any deployed app: volume snapshots, database dumps, Restic/Backrest, object-storage offload
- **Curated deployment bundles** — two recipe-of-recipes bundles for goal-shaped requests:
  - `references/bundles/ai-homelab.md` — Open WebUI + Ollama + image gen + LLMOps in one deployment
  - `references/bundles/privacy-stack.md` — Vaultwarden + Nextcloud + Immich + Bitwarden in one deployment

## [0.22.0] — 2026-04-30

### Added
- **Agent-platform support** — skill now ships as a native agent for OpenClaw and Hermes-Agent in addition to Claude Code / Codex / Cursor / Aider / Continue
- `dist/openclaw/` and `dist/hermes/` distribution bundles generated by `scripts/build-dist.sh`
- `docs/platforms/openclaw.md` and `docs/platforms/hermes.md` — per-platform integration guides

## [0.21.0] — 2026-04-30

### Added
- **Multi-platform distribution** — `scripts/build-dist.sh` generates self-contained bundles for 5 platforms: Codex, Cursor, Aider, Continue, generic
- `dist/` directory with platform-specific SKILL.md + system-prompt + bundle variants
- CI check (`dist-bundles.yml`) ensures dist/ stays in sync with canonical sources

## [0.20.1] — 2026-04-30

### Added
- **Credential-handling module** (`references/modules/credentials.md`) — five patterns for safely collecting secrets: environment variables, secret managers, Docker secrets, `.env` files, and when to refuse chat paste; copied into both dist/codex and dist/generic bundles at build time

## [0.20.0] — 2026-04-30

### Added
- **Post-deploy feedback flow** — skill automatically drafts a GitHub issue after each deployment asking users to report what worked, what broke, and what the docs missed; issue body includes the combo (infra × runtime) for structured signal collection
- **Sanitization module** (`references/modules/feedback.md`) — strips PII from feedback drafts before submission

## [0.19.3] — 2026-04-29

### Added
- **Scope criteria** — explicit "Is this software in scope?" decision tree in CLAUDE.md; Tier 1 (verified, actively maintained, 3+ demand signals) vs Tier 2 (speculative) routing
- Graduation criteria for Tier 2 → Tier 1 promotion

## [0.19.2] — 2026-04-29

### Fixed
- Audit-fix wave for six existing recipes (Ollama, Stable Diffusion WebUI, OpenClaw, Open WebUI, Dify, Hermes): removed unverified install flags, corrected port mappings, aligned with upstream README as of verification date

## [0.19.0] — 2026-04-28

### Added
- **Langfuse** (`references/projects/langfuse.md`) — LLM observability, tracing, prompt management, and evaluation platform; Docker Compose + Kubernetes paths

## [0.18.0] — 2026-04-28

### Added
- **vLLM** (`references/projects/vllm.md`) — production-grade LLM inference server with OpenAI-compatible API; GPU and CPU paths, tensor parallelism, quantization options

## [0.17.1] — 2026-04-28

### Fixed
- Removed two upstream-doc hallucinations introduced in v0.17.0 (non-existent Aider `--docker` flag and a fabricated config-file path); corrected to match upstream README

## [0.17.0] — 2026-04-28

### Added
- **Aider** (`references/projects/aider.md`) — AI pair-programming CLI; covers pip install, Docker, and `aider --model` flag patterns across OpenAI / Anthropic / Ollama backends

## [0.16.0] — 2026-04-28

### Added
- **AnythingLLM** (`references/projects/anythingllm.md`) — RAG-focused workspace + agent platform with multi-user support, document ingestion, and vector store backends

## [0.15.1] — 2026-04-28

### Fixed
- Retroactive doc-verification fixes across the initial recipe set (ghost, openclaw, open-webui, dify, librechat, comfyui, a1111): each recipe re-verified against upstream README; fabricated flags and config paths removed; strict-doc policy applied retroactively

## [0.15.0] — 2026-04-28

### Added
- **LibreChat** (`references/projects/librechat.md`) — multi-provider chat UI for teams; covers Docker Compose with MongoDB, env config for OpenAI / Anthropic / Azure / Ollama backends

## [0.14.0] — 2026-04-28

### Added
- **Dify** (`references/projects/dify.md`) — LLMOps + AI app builder platform; Docker Compose (12-service canonical path), Kubernetes via community Helm, Terraform cloud templates

## [0.13.0] — 2026-04-27

### Added
- **ComfyUI** (`references/projects/comfyui.md`) — node-based AI image and video generation; GPU (CUDA) and CPU paths, model directory layout, custom-nodes install

## [0.12.0] — 2026-04-27

### Added
- **Stable Diffusion WebUI** (`references/projects/stable-diffusion-webui.md`) — Automatic1111 / A1111; GPU and CPU paths, `--listen` flag, model directory, xformers

## [0.11.0] — 2026-04-27

### Added
- **Open WebUI** (`references/projects/open-webui.md`) — multi-user web interface for any OpenAI-compatible LLM; Ollama integration, multi-user auth, Docker Compose path

## [0.10.0] — 2026-04-27

### Added
- **Ollama** (`references/projects/ollama.md`) — local-LLM inference server; GPU (CUDA/ROCm) and CPU paths, model pull, OpenAI-compat API; foundation layer for the AI homelab stack

## [0.9.0] — 2026-04-27

### Added
- **Hermes-Agent** (`references/projects/hermes.md`) — Nous Research Hermes model deployment; covers API server path and integration with Open WebUI

## [0.8.0] — 2026-04-26

### Added
- All three official OpenClaw deployment methods verified against docs.openclaw.ai/install/*: Docker Compose on VPS, native install, managed cloud

## [0.7.0] — 2026-04-26

### Added
- **Kubernetes / Helm path** for OpenClaw — Helm chart values, Ingress, PVC, and namespace setup; covers the last upstream-blessed install path

## [0.6.0] — 2026-04-26

### Added
- OpenClaw combo gaps closed: EC2 + Hetzner + DigitalOcean + GCP infra adapters; native-binary runtime module

## [0.5.0] — 2026-04-24

### Changed
- Slimmed openclaw recipe; combo-aware preflight; SKILL.md and README refresh

## [0.4.0] — 2026-04-23

### Added
- **OpenClaw Path C** — Docker container on any Linux VPS recipe

## [0.3.0] — 2026-04-23

### Added
- **Preflight module** — per-recipe input prompts collect all required values before any infra action; input schema now part of every recipe

## [0.2.0] — 2026-04-23

### Added
- **OpenClaw on Lightsail** recipe — first non-Ghost deployment target

## [0.1.0] — 2026-04-22

### Added
- Initial release: **Ghost on Lightsail** recipe — the first Tier 1 verified recipe
- Core skill scaffolding: `SKILL.md`, `references/` directory structure, infra adapter pattern

---

[Unreleased]: https://github.com/zhangqi444/open-forge/compare/v0.24.0...HEAD
[0.24.0]: https://github.com/zhangqi444/open-forge/compare/v0.23.1...v0.24.0
[0.23.1]: https://github.com/zhangqi444/open-forge/compare/v0.23.0...v0.23.1
[0.23.0]: https://github.com/zhangqi444/open-forge/compare/v0.22.0...v0.23.0
[0.22.0]: https://github.com/zhangqi444/open-forge/compare/v0.21.0...v0.22.0
[0.21.0]: https://github.com/zhangqi444/open-forge/compare/v0.20.1...v0.21.0
[0.20.1]: https://github.com/zhangqi444/open-forge/compare/v0.20.0...v0.20.1
[0.20.0]: https://github.com/zhangqi444/open-forge/compare/v0.19.3...v0.20.0
[0.19.3]: https://github.com/zhangqi444/open-forge/compare/v0.19.2...v0.19.3
[0.19.2]: https://github.com/zhangqi444/open-forge/compare/v0.19.0...v0.19.2
[0.19.0]: https://github.com/zhangqi444/open-forge/compare/v0.18.0...v0.19.0
[0.18.0]: https://github.com/zhangqi444/open-forge/compare/v0.17.1...v0.18.0
[0.17.1]: https://github.com/zhangqi444/open-forge/compare/v0.17.0...v0.17.1
[0.17.0]: https://github.com/zhangqi444/open-forge/compare/v0.16.0...v0.17.0
[0.16.0]: https://github.com/zhangqi444/open-forge/compare/v0.15.1...v0.16.0
[0.15.1]: https://github.com/zhangqi444/open-forge/compare/v0.15.0...v0.15.1
[0.15.0]: https://github.com/zhangqi444/open-forge/compare/v0.14.0...v0.15.0
[0.14.0]: https://github.com/zhangqi444/open-forge/compare/v0.13.0...v0.14.0
[0.13.0]: https://github.com/zhangqi444/open-forge/compare/v0.12.0...v0.13.0
[0.12.0]: https://github.com/zhangqi444/open-forge/compare/v0.11.0...v0.12.0
[0.11.0]: https://github.com/zhangqi444/open-forge/compare/v0.10.0...v0.11.0
[0.10.0]: https://github.com/zhangqi444/open-forge/compare/v0.9.0...v0.10.0
[0.9.0]: https://github.com/zhangqi444/open-forge/compare/v0.8.0...v0.9.0
[0.8.0]: https://github.com/zhangqi444/open-forge/compare/v0.7.0...v0.8.0
[0.7.0]: https://github.com/zhangqi444/open-forge/compare/v0.6.0...v0.7.0
[0.6.0]: https://github.com/zhangqi444/open-forge/compare/v0.5.0...v0.6.0
[0.5.0]: https://github.com/zhangqi444/open-forge/compare/v0.4.0...v0.5.0
[0.4.0]: https://github.com/zhangqi444/open-forge/compare/v0.3.0...v0.4.0
[0.3.0]: https://github.com/zhangqi444/open-forge/compare/v0.2.0...v0.3.0
[0.2.0]: https://github.com/zhangqi444/open-forge/compare/v0.1.0...v0.2.0
[0.1.0]: https://github.com/zhangqi444/open-forge/releases/tag/v0.1.0
