mcpill 1.2.4 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.5.0
+
+- `mcpill init` scaffolds `.mcpill/server/hooks/` with a commented `example-hook.md` stub covering all four Claude Code event types (`PreToolUse`, `PostToolUse`, `PreCompact`, `Stop`)
+- `PILL.md` template now includes commented-out `## Hook:` and `## Prompt:` section stubs with inline field explanations
+- `mcpill compile` merges user-defined hooks from `PILL.md` `## Hook:` blocks and `.mcpill/server/hooks/*.md` files alongside auto-generated `replaces:` hooks into a unified `.claude/settings.json` list; all four event types supported
+- `pill-agent-guide.md` documents `## Hook:` sections, `.mcpill/server/hooks/*.md` files, and the `--no-hooks` flag
+
+## 1.4.0
+
+- `mcpill compile` and `mcpill validate` now auto-run `npm install` in the server directory when `node_modules` is absent and the server has declared dependencies
+
+## 1.3.0
+
+- `PILL.md` tool sections now accept a `replaces` field (comma-separated native tool names, e.g. `replaces: Read, Bash`); `mcpill compile` reads these and generates the `PreToolUse` hook without requiring a separate `AGENT.md`
+- `AGENT.md` `## Tools` table still supported; AGENT.md wins on name conflict when both sources declare the same tool
+- `mcpill init` template updated to include `replaces` in the example tool section
+
 ## 1.2.4
 
 - Fix: bump `mcpill-runtime` to `^0.1.2` — `0.1.0` dist imported `@ruco-ai/mcpster` (old scoped name), causing `ERR_MODULE_NOT_FOUND` on global install

package/README.md

@@ -46,8 +46,10 @@ Scaffolds a new project in the current directory:
 - `.mcpill/pill-agent-guide.md` — agent instructions read by Claude when building from `PILL.md`
 - `.mcpill/server.md` — server config + resources
 - `.mcpill/server/prompts/greeting.md` — example prompt
+- `.mcpill/server/hooks/example-hook.md` — stub hook file (see file for format; all fields commented out by default)
 - `.mcpill/HELLO-MCP.md` — ready-to-run example (copy into `PILL.md` to try it)
-- `package.json` — `{ type: "module", dependencies: { mcpill-runtime } }` — run `npm install`
+- `.claude/commands/create-pill.md` — `/create-pill` slash command; say `/create-pill` in Claude Code to start the guided pill-creation workflow
+- `package.json` — `{ type: "module", dependencies: { mcpill-runtime } }` — deps are installed automatically by `mcpill compile` and `mcpill validate`
 
 ### `mcpill compile`
 
@@ -57,8 +59,24 @@ Compiles `server.md` + `tools/*.md` + `prompts/*.md` into a `.<name>/` pill arti
 mcpill compile              # forward: source → pill
 mcpill compile --to-md      # reverse: pill → source
 mcpill compile --strict     # error on missing tool handlers (default: stub)
+mcpill compile --no-hooks   # skip writing PreToolUse hook to .claude/settings.json
 ```
 
+Compile also writes a `PreToolUse` hook into `.claude/settings.json` that warns Claude to use the pill's MCP tools instead of native file tools (`Read`, `Bash`, etc.). Hook mappings are read from two sources, merged at compile time — rerun `mcpill compile` after any change:
+
+- **`PILL.md`** (recommended) — add a `replaces` field to any `## Tool:` section:
+
+  ```markdown
+  ## Tool: read-chunks
+
+  description: Read a file by token-sized chunks.
+  replaces: Read
+  behavior: |
+    ...
+  ```
+
+- **`AGENT.md`** — a `## Tools` table with a `Replaces` column (existing format). AGENT.md wins on name conflicts.
+
 ### `mcpill validate`
 
 Validates all pill directories (`.<name>/`) in the project root.