Append one structured entry to the consumer project's chat-history log (a JSONL file). Use to record a decision, note, or phase marker that should persist into a later session or be distilled by mine_session. Writes to the filesystem (agents/runtime/.agent-chat-history by default; agents/.agent-chat-history and .agent-chat-history accepted for back-compat) and returns the written entry plus its resolved target path. Path-scoped: a path outside the allowlist, or any traversal escaping the project root, raises an error before writing. Set dry_run: true to preview the entry and target path without touching disk.

Read recent entries back from the consumer project's chat-history JSONL (agents/runtime/.agent-chat-history; agents/.agent-chat-history accepted for back-compat). Use to recover context from an earlier session — decisions, notes, phase markers — at the start of a new task. Read-only. Returns the resolved file path plus a list of matching entries (newest last). Combine session, last, and entry_type to narrow the result.

Regenerate the compiled router (router.compiled.json) from the current rule, skill, and command frontmatter, so trigger-based routing reflects the latest artifacts. Use after adding or editing a rule / skill / command's trigger metadata. Shell-bound — wraps scripts/compile_router.py — and returns the regenerated router summary. Set dry_run: true to compute the result without writing the file.

Lint skill, rule, command, guideline, and persona markdown files for frontmatter and structural errors. Use before committing or opening a PR that adds or edits any of those artifacts, to catch schema violations early. Read-only — never writes files or spawns git. Returns the scripts/skill_linter.py --format json payload: a summary object (pass / pass_with_warnings / fail / total counts) and a per-file results array with severity-tagged findings. Pass paths to lint a subset; omit for a full tree scan.

Enumerate every slash command the server currently exposes as a prompt, each with its name and description. Use to discover available commands before routing a user request to one. Read-only manifest view, takes no arguments. Returns a count plus a commands array.

Enumerate every behavioral rule the server exposes as a resource, each with its URI, name, and description. Use to discover which rules are in effect, then fetch a body with read_resource_body or resources/read. Read-only manifest view, takes no arguments. Returns a count plus a rules array.

Enumerate every skill the server currently exposes as a prompt, each with its name, description, and source. Use to discover which skills are available before suggesting or invoking one. Read-only manifest view, takes no arguments. Returns a count plus a skills array.

Retrieve engineering-memory entries for one or more memory types, optionally narrowed to specific anchor paths. Use before editing a security-sensitive or historically buggy file to surface prior incidents, ownership, and patterns tied to it. Reads agents/memory/<type>/*.yml plus the agents/memory/intake/*.jsonl signal log. Read-only. Returns the v1 retrieval envelope: a status field plus per-type slices carrying the matched entries.

Record an engineering-memory signal — a short, anchored observation such as a recurring bug pattern or an ownership note — to the monthly intake log agents/memory/intake/signals-YYYY-MM.jsonl. Use to capture a learning tied to a specific file so future memory_lookup calls surface it. Appends to the filesystem and is rate-limited per (type, path) within a rolling window. Returns the recorded signal.

Report whether the optional @event4u/agent-memory CLI is installed and reachable, and surface its backend and routing metadata. Use to decide whether memory-backed tools (memory_lookup, memory_signal) will return real data before relying on them. Read-only, takes no arguments. Returns a status (ok / absent), the active backend, and — when absent — the reason and the path probed.

Extract reusable patterns, decisions, and learnings from a single chat-history session, as candidate memory entries. Use to distill a finished session into durable memory before it ages out. Read-only. Returns the mined candidates grouped by kind.

Fetch the rendered body of a single resource URI (rule, guideline, or context document) in one call, without the two-step resources/list + resources/read handshake. Use when you already know the URI and want to inline its content into a tool-call result. Read-only. Returns the resource uri, name, description, and full text body.

Run the consumer project's configured quality gate (PHPStan / Rector / ECS or the stack equivalent) and return a structured per-tool result. Use before committing to confirm static-analysis and style gates pass. Shell-bound. Pass tool to run a single gate; omit to run all.

Run the consumer project's test suite via its auto-detected runner (Pest / PHPUnit, Jest / Vitest, pytest, …). Use to verify a change before claiming it works. Shell-bound. Returns the exit code, the runner name, and a structured tail of the output. Pass filter or path to narrow the run.

Score a user message against the compiled router and return the skills whose triggers match, each with the reason it fired. Use to predict which skills a given message would activate, for debugging trigger coverage. Read-only and deterministic. Returns a ranked list of matching skills with their trigger reasons.

Run the command-suggestion engine: score the available slash commands against a user message and context, and return a ranked, numbered-options block of the best matches. Use to recommend a command for a free-form request without invoking anything. Read-only and deterministic. Returns the formatted suggestion block plus the scored candidates.

Match a free-form task description to the most relevant skills, ranked by their frontmatter triggers. Use to pick a skill for a described task before starting work. Read-only. Returns a ranked list of skills with name, description, and match reason.

Synchronise .agent-settings.yml against the current template and active profile — add new sections and keys while preserving existing user values. Use after a package upgrade to pick up newly introduced settings. Edits the settings file and returns the keys that were (or would be) added. Set dry_run: true to preview.

Synchronise the managed event4u/agent-config block in the consumer project's .gitignore — add missing canonical entries while preserving user-added lines. Use after upgrading the package or when generated paths are being tracked by mistake. Edits .gitignore and returns the added / removed entries. Set dry_run: true to preview the changes.

Synchronise the messages() method of a Laravel FormRequest class: add entries for validation rules that lack a custom message, link them to translation keys, and drop stale ones. Use after changing a FormRequest's rules(). Edits the class file on disk and returns the planned or applied message changes. Set dry_run: true to preview the diff without writing.