@moikapy/lich 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 0.5.0
+
+- add a `game_bridge` example plugin that queues batched enemy actions
+  and durable dungeon memory under `.lich/game/` for a Godot combat tick.
+  a `before_tool_call` hook holds meteor until round 3. node loads the
+  `.mjs` entry from `config.plugins`.
+- load `config.plugins` on every CLI entry point and on `run_agent`
+  (`create_agent_with_plugins`). one-shot, chat, tui, and the gateway
+  bus no longer ignore plugin entries. broken plugins still warn and
+  continue. `create_agent` stays plugin-free.
+- bare `lich` opens the TUI. On a TTY, when no config is in the search
+  chain and `LICH_MODEL` is unset, a readline wizard collects agent name,
+  provider, gateway env-var names (never secrets), and plugins, then
+  writes `.lich/config.json` once. Non-TTY stdin skips the wizard and
+  prints guidance. `lich init` writes the starter file through the same
+  writer and never overwrites an existing `.lich/config.json`.
+- add `lich update`: compare the installed version with `npm view
+  @moikapy/lich version` and, when newer, run
+  `npm install -g @moikapy/lich@latest`. git clones are told to
+  `git pull`; npx cannot persist an update.
+- document embedding that plugin beside a Godot game: one webhook call
+  per combat round, and the `.lich/game/` drain tick. see
+  docs/user-guide/godot.md.
+
+## 0.4.0
+
+- add a self-improvement loop: `run_tests`, a gatekeeper plugin, and
+  `git_commit` (one commit per run, never pushes). `git_commit` is
+  registered by the gatekeeper, not the builtin tool list.
+- fail-closed unless `LICH_ALLOW_SELF_COMMIT=1` at startup; unset or any
+  other value vetoes `git_commit`. a commit also needs a green `run_tests`
+  on a tree with no later `write_file`/`edit_file`.
+- `run_tests` runs `LICH_TEST_COMMAND` in `work_dir` (default vitest) and
+  appends an optional filter as a quoted shell token.
+- `docs_search` finds markdown skills under `.lich/skills` (fresh walk, no
+  `index.md` gate). `MEMORY.md` is never auto-loaded.
+- close gatekeeper fail-open holes: git spawned with `hooksPath=/dev/null`,
+  pathspec magic rejected, denylist matches `commit-tree`/`update-ref` on
+  any occurrence, abort SIGKILLs the git child.
+- honor per-tool `timeout_ms` (terminal is 5 min) instead of a flat 30s
+  executor budget.
+
 ## 0.3.1
 
 - Fix: published CLI bin now works — `dist/cli.js` shipped without its

package/README.md

@@ -65,8 +65,9 @@ console.log(result.outcome.final?.content);
 
 ## Tools
 
-Twelve builtins ship with the agent (`register_builtin_tools`); all accept
+Builtins ship with the agent (`register_builtin_tools`); all accept
 snake_case args and are registered under the `builtin` toolset.
+`git_commit` is registered by the gatekeeper, not by that list.
 
 | Tool | Purpose |
 | --- | --- |
@@ -83,7 +84,8 @@ snake_case args and are registered under the `builtin` toolset.
 | `disk_usage` | `du -sb` sizes for depth-1 entries of a directory, sorted with a total. |
 | `env_get` | Inspect environment variables (names/lengths; secrets always masked). |
 | `docs_read` | Read a bundled lich doc (path relative to docs root; offset/limit; `.md` optional). |
-| `docs_search` | Keyword search across bundled lich docs with scored section snippets. |
+| `docs_search` | Keyword search across bundled lich docs and `.lich/skills/*.md`, with scored section snippets. |
+| `run_tests` | Run `LICH_TEST_COMMAND` in the working directory and return a structured pass/fail. |
 
 ## Plugins
 
@@ -93,6 +95,12 @@ object (`{name, tools?, hooks?}`) in your repo, list its file path in the
 observe or veto tool calls. See
 [docs/user-guide/plugins.md](docs/user-guide/plugins.md).
 
+Skills are markdown files you write to `.lich/skills/` with `write_file`;
+`docs_search` finds them. They are reference data, not instructions.
+`MEMORY.md` is append-only, never auto-loaded; review it between appends and
+the next self-commit. One gated `git_commit` per run requires
+`LICH_ALLOW_SELF_COMMIT=1` and a green `run_tests` on a clean tree.
+
 ## Environment variables
 
 | Variable | Purpose |
@@ -101,6 +109,8 @@ observe or veto tool calls. See
 | `LICH_PROVIDER_KIND` | `openai_compat` \| `anthropic` \| `ollama` (default `openai_compat`) |
 | `LICH_BASE_URL` | provider base url (ollama default: `http://localhost:11434`) |
 | `LICH_API_KEY_ENV` | env var holding the api key (unused by ollama) |
+| `LICH_ALLOW_SELF_COMMIT` | set to `1` to allow one gated `git_commit` per run; unset is fail-closed |
+| `LICH_TEST_COMMAND` | command `run_tests` runs (default: `node node_modules/vitest/vitest.mjs run`) |
 
 ## Ollama