mlorentedev/hive

What you were doing (inline mode).

Keyword to look up in existing lesson headings (lookup mode).

Maximum lessons to extract / surface. Default 5.

Minimum confidence for batch extraction. Default 0.7.

What went wrong or what decision was needed (inline mode).

Project slug (directory under 10_projects/).

Lookup ranking — 'reinforcements' (default), 'confidence', or 'hybrid'. Ignored unless find is set.

What fixed it or what was decided (inline mode).

Optional tags (e.g. ["python", "testing"]).

Raw text to extract lessons from (batch mode).

Short descriptive title (inline mode).

Optional system context for the model.

Target summary length for summarization.

Maximum tokens in the response.

Concrete model id. Empty uses the configured worker model. The 4.0.0 removal retired 'auto', 'ollama', 'openrouter-free' and 'openrouter'; passing one is rejected rather than ignored.

Relative path to a .md file. Overrides section.

Project slug for vault summarization mode.

The task description or code to process.

Shortcut name for summarization. Ignored if path is set.

Return a JSON record instead of prose. Prose is the default so every existing caller's contract is unchanged; the dispatcher asks for JSON because it needs the status as a VALUE. Exception types do not survive the JSON-RPC boundary between the daemon and its clients, so "the pool refused" and "the worker answered badly" cannot be told apart by type on the far side — and a dispatcher that cannot tell them apart turns a rate limit into a silent retry against a different model.

Per-dispatch deadline in seconds. 0 uses the ambient tool timeout. A value ABOVE the ambient one raises the ceiling rather than being clamped by it — a deadline a 60s default can silently cap is not a deadline (HIVE-384 AC3).

Project slug (directory under 10_projects/). Empty = list available projects so the caller can pick one. This is the only parameter — there is no days argument (the briefing window is fixed).

The natural-language question to answer. Use question, not query or prompt.

Commit message. Empty defaults to "vault: batch update". This is the only parameter — there is no project argument; the commit spans the whole vault working tree.

Must be True (the default). Unlike vault_write, this tool has no deferred mode: it neither uses the commit queue (a delete and a recreate inside one tick would collapse to a single state) nor leaves the removal uncommitted, which is the indefinite deferral ADR-018 §4 removed. commit=False is rejected with an explanation rather than silently upgraded — see the ADR's 2026-08-09 amendment.

Optional at-most-once token. If set, a retry with the same key is a no-op after the first delete (ADR-013), which also makes deleting an already-removed file succeed. Empty (default) disables idempotency.

Relative path to the file within the project.

Project slug or '_meta' for cross-project content.

Validation checks to run. Empty = health summary only. Options: frontmatter, stale, links.

Append runtime metadata block. Default False.

Append vault tool usage analytics. Default False.

Maximum validation issues to report. Default 50.

Project slug to validate. Empty = all projects.

Usage look-back window in days. Default 30.

Subdirectory within the project. Empty = project root. (Use path, not subpath — subpath is accepted as an alias.)

Glob pattern to filter files (e.g. 'adr-', '.md').

Project slug. Empty = list all projects.

Alias of path (#151). Prefer path. Note: there is no scope parameter here — scope lives on vault_search.

If True, commit synchronously before returning. Defaults to False, which queues the path for the reconciler. See vault_write docstring for the durability contract.

Exact text to find (single mode). Empty = not set. (Use find/replace, NOT old_string/new_string — those are accepted as aliases.)

Optional at-most-once token. If set, a retry with the same key is a no-op after the first apply (ADR-013). Empty (default) disables idempotency.

Alias of replace (#151). Prefer replace.

Alias of find (#151). Prefer find.

List of {"find", "replace"} dicts (multi mode).

Relative path to the file within the project.

Project slug or '_meta' for cross-project content.

Replacement text (single mode). Empty = not set.

Alias of path (#151). Prefer path; for a section shortcut use section instead.

Prepend a structured metadata line from YAML frontmatter.

Maximum lines to return. 0 = unlimited.

Relative path to a specific .md file within the project. Overrides section. (Use path for a file, not identifier — identifier is accepted as an alias.)

Project slug (directory under 10_projects/), or '_meta' for 00_meta/.

Shortcut name (context, tasks, roadmap, lessons). Ignored if path is set.

Alias of max_results (#202). Prefer max_results. When both are given the tighter (smaller) cap wins; 0 = unset.

Maximum output lines. Default 500.

Max result files. Default 10. Caps the file count in all modes (flat, ranked, recent); in flat/recent the cap is by path order (alphabetical) — use ranked=True for relevance order.

Filter to this project (recent mode only).

Text to search for (case-insensitive).

Lesson ranking ('bm25' default keeps current behaviour; 'reinforcements', 'confidence', 'hybrid' filter to 90-lessons.md only and rank by usage signal).

Score results by relevance. Default False.

Alias of use_regex (#151). Prefer use_regex. To narrow by location use scope / project, not path_filter / path_prefix.

Restrict search to a scope (e.g. 'work', 'projects'). Empty = all.

Show recent changes (0 = disabled). Default 0.

Only files whose frontmatter status matches.

Only files that have this frontmatter tag.

Only files whose frontmatter type matches.

Treat query as regex. Default False. (Use use_regex, not regex — regex is accepted as an alias.)

If True, commit synchronously before returning — the escape hatch for a caller that needs the commit to exist by the time the call ends. Defaults to False, which queues the path for the reconciler to commit on its next tick (a few seconds). Durability contract: the file is persisted to disk regardless; only the commit is deferred, so a crash before the next flush loses the commit, not the content.

Markdown content to write (body only for create mode).

Document type for frontmatter (create mode). Optional; defaults to "note".

Optional at-most-once token. If set, a retry with the same key is a no-op (safe for transparent retries after a daemon restart cuts an in-flight write — ADR-013). Empty (default) disables idempotency.

'append', 'replace', or 'create'. Default 'append'. 'create' is inferred when path is set and section is empty.

Relative path for the file. Setting this with no section creates the file (create mode).

Project slug or '_meta' for cross-project content.

Section shortcut (context, tasks, roadmap, lessons). For append/replace.

Probe the provider for its model list. Default True. Set False to report configuration without a network call.