docs: add changelog entries for v0.1.8 and v0.1.9 so users can track breaking changes

The changelog stopped at "0.1.7 — Unreleased" while the project was at
v0.1.9. Two releases worth of breaking changes (explicit primitive
dependencies, named-only placeholders, removed ralph status, AI-guided
ralph new) were undocumented. Also fixed the API reference to show
global_checks/global_contexts fields and remove the stale prompt_text
parameter.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 2 people

docs/api.md

@@ -44,14 +44,15 @@ config = RunConfig(
     command="claude",
     args=["-p", "--dangerously-skip-permissions"],
     ralph_file="RALPH.md",
-    prompt_text=None,       # Ad-hoc prompt (overrides ralph_file)
-    ralph_name=None,        # Named ralph from .ralphify/ralphs/
+    ralph_name=None,           # Named ralph from .ralphify/ralphs/
     max_iterations=10,
     delay=2.0,
     timeout=300,
     stop_on_error=True,
     log_dir="ralph_logs",
     project_root=Path("."),
+    global_checks=None,        # List of global check names to include (e.g. ["lint", "tests"])
+    global_contexts=None,      # List of global context names to include (e.g. ["git-log"])
 )
 ```
 

docs/changelog.md

@@ -6,7 +6,38 @@ description: Ralphify release history — new features, bug fixes, and breaking
 
 All notable changes to ralphify are documented here.
 
-## 0.1.7 — Unreleased
+## 0.1.9 — 2026-03-16
+
+Tightened the primitive system: global primitives are now opt-in, context placeholders must be named, and primitives are re-discovered every iteration.
+
+### Breaking changes
+
+- **Explicit primitive dependencies required** — global checks and contexts are no longer auto-applied to all ralphs. Each ralph must declare which global primitives it uses in its frontmatter (`checks: [lint, tests]`, `contexts: [git-log]`). Unknown names produce a clear error. Ralph-local primitives still auto-apply.
+- **Named placeholders only** — the bulk `{{ contexts }}` placeholder and implicit append behavior have been removed. Each context must be referenced by name (`{{ contexts.git-log }}`). Contexts not referenced by a placeholder are excluded from the prompt.
+- **Removed `ralph status` command** — setup validation has been moved into `ralph run` startup, so a separate status command is no longer needed.
+
+### Added
+
+- **Live re-discovery** — primitives are re-discovered every iteration, so adding or editing a check, context, or ralph on disk takes effect on the next cycle without restarting the loop.
+
+### Fixed
+
+- Unknown ralph names now error immediately instead of being silently treated as inline prompts.
+
+---
+
+## 0.1.8 — 2026-03-16
+
+Redesigned `ralph new` with AI-guided setup, and added environment variables for scripts.
+
+### Added
+
+- **AI-guided `ralph new`** — `ralph new` now installs a skill into your agent (Claude Code or Codex) and launches an interactive session where the agent guides you through creating a complete ralph — prompt, checks, and contexts — via conversation. Replaces the old `ralph new check`/`ralph new context`/`ralph new ralph` scaffolding subcommands.
+- **`RALPH_NAME` environment variable** — context and check scripts now receive the name of the current ralph in `RALPH_NAME`, so scripts can adapt their behavior based on which ralph is running.
+
+---
+
+## 0.1.7 — 2026-03-12
 
 Simplified the CLI, added a spinner during iterations, and removed the experimental web dashboard to focus on the CLI experience.