prompt_manager 0.5.8 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92890a2ce51edad60859a5e4c77936807a81fae1a00eca18bf7c6b6b9b066d37
-  data.tar.gz: b22ac1517476e01b5f4b26007e8dcfd752ffbc84e0824fe0090f3b2f33643c72
+  metadata.gz: 8f6339dd195179a1d9d9f996d1dfc4d0c689a3ed4bb9415fe2d5d68eaaa761ba
+  data.tar.gz: 2b443af6d4ea259fd124c6ff9d225129d0e233fbffc0d9e86a42ce2189595f29
 SHA512:
-  metadata.gz: 7b45b620e66f239bbcd3174f5100ce23defb7549e7035c685d9c92a9fd14f3f73c206aa293edec2f1e31258d7a376c3e2126ec8e9c4beca6d3b8218420fc8119
-  data.tar.gz: '09939dc0cbcc53e36208d79096df3f57d7e6755fff0410b5ce8bb99482d2dce79e7fb3a210c4f2fca615890a19bbfe51b0a5449f23a3de61283711f821055e51'
+  metadata.gz: 26ec66ace02ff31ced22d3bd331884c0c74d5ee7356e138897759ed70be2be7d52dca239d3f1ac30c6599c8133446d199db7833de18fda7053e6fc977a1bde3b
+  data.tar.gz: a60049ad709699ec112b43c6f281dd50ae6b80d3774c5c9a58e56d6daebcb5ccfc647544461f62f3f6e4a23367421d1401b34988ae22657764b72bf387c03ff8

data/CHANGELOG.md

@@ -1,6 +1,51 @@
-## Unreleased
+### [1.0.1] - 2026-02-04
+
+#### Added
+- **`PM::Directive` base class** — class-based DSL for defining directive categories. Use `desc` before method definitions to mark them as directives, and `alias_method` for aliases. Subclass tracking, `register_all`, `category_name`, and `build_dispatch_block` are all built-in.
+- **Built-in `insert` directive** (alias: `read`) — insert any file's raw content into a prompt. Unlike `include`, the inserted content is not parsed, shell-expanded, or ERB-rendered.
+- New test file `directive_base_test.rb` with tests for the `PM::Directive` DSL, subclass tracking, category naming, and dispatch block building.
+- New test fixtures for `insert`/`read` directive coverage.
+
+#### Changed
+- **`PM::CoreDirectives`** — built-in `include`, `insert`/`read` directives refactored as a `PM::Directive` subclass using the `desc` DSL.
+- `PM.register` directive aliases now support registration via `alias_method` in `PM::Directive` subclasses, with automatic detection via `UnboundMethod#original_name`.
+- Directive registry simplified; `PM.reset_directives!` now delegates to `PM::Directive.register_all`.
+- Updated README and documentation guides for custom directives and includes.
 
 ## Released
+### [1.0.0] = 2026-02-03
+
+**Complete rewrite** — repositioned from a prompt management system with storage adapters to a focused prompt parsing and rendering engine.
+
+#### Breaking Changes
+- **New `PM` module replaces `PromptManager`** — the entire codebase has been restructured under the `PM` namespace. A backward-compatibility alias (`PromptManager = PM`) is provided via `require 'prompt_manager'`.
+- **Storage adapters removed** — `FileSystemAdapter`, `ActiveRecordAdapter`, and all database-backed persistence have been removed. The library now operates on strings, files, and Pathnames directly.
+- **`Prompt` class removed** — replaced by the lightweight `PM::Parsed` struct.
+- **`DirectiveProcessor` class removed** — replaced by a simple `PM.register` directive registration API.
+- **Parameter history removed** — the library no longer tracks historical parameter values per keyword.
+- **Configuration simplified** — only three settings remain: `prompts_dir`, `shell`, and `erb`. Options like `parameter_regex` and `search_proc` have been removed.
+
+#### New Features
+- **Symbol and single-word parsing** — `PM.parse(:code_review)` and `PM.parse('code_review')` automatically resolve to `code_review.md` in the configured `prompts_dir`.
+- **Directive aliases** — `PM.register(:webpage, :website, :web) { |ctx, url| ... }` registers multiple names for a single directive with rollback on duplicate detection.
+- **`PM::Metadata`** — OpenStruct-based metadata with automatic predicate methods for boolean fields (e.g., `metadata.shell?`).
+- **`PM::Parsed`** — Struct-based result with `RenderContext` support and required-parameter validation in `to_s`.
+- **Built-in `include` directive** — compose prompts from multiple files with loop protection.
+- **Streamlined parsing pipeline** — strip HTML comments, extract YAML front matter, optional shell expansion (`$VAR`, `${VAR}`, `$(command)`), optional ERB rendering.
+
+#### Removed
+- `PromptManager::Prompt` class
+- `PromptManager::DirectiveProcessor` class
+- `PromptManager::Storage::FileSystemAdapter`
+- `PromptManager::Storage::ActiveRecordAdapter`
+- Custom error classes (`PromptManager::Error` hierarchy)
+- Development dependencies on `activerecord`, `sqlite3`, and `tocer`
+
+#### Added
+- Runtime dependency on `ostruct`
+- Comprehensive test suite (8 test files, 19 fixtures)
+- Full documentation site under `docs/` with guides for parsing, shell expansion, ERB rendering, custom directives, and prompt composition
+
 ### [0.5.8] = 2025-09-01
 - fixed issue where removed keywords from prompt text were still being included in parameters if they existed in the JSON file (addresses AIA issue #105)
 - parameters now only include keywords currently present in the prompt text, while preserving historical values for existing keywords