cbrain

从 Discovery/Health 信号生成内部行动候选。不发送通知、不创建 issue、不执行修复。

读取待处理的内部行动候选。不会执行任何动作。

更新行动候选状态。支持 resolved/dismissed/seen，不会执行候选动作。

更新发现的处理状态。支持标记已读(seen)、已解决(resolved)、已忽略(dismissed)。

标记发现为已读。建议使用 update_discovery_status 替代。

Query the knowledge graph. Traverse from a seed entity or get backlinks. Accepts a slug or entity name (auto-resolved). Links include source_type (wikilink=human, manual=human explicit input, agent=agent inference, ner=LLM-extracted, dialogue=conversation, writeback=auto) and confidence (0-1, higher…

Unified link operations. Use action=list/add/remove. Compatibility aliases get_links/add_link/remove_link remain available.

Get links for a page. Returns outgoing, incoming, or both directions. Links include source_type (wikilink=human, manual=human explicit input, agent=agent inference, ner=LLM-extracted, dialogue=conversation, writeback=auto) and confidence (0-1, higher=more reliable).

Create a link between two pages. Links created via this tool are marked as source_type=agent (agent_inference) with confidence=0.9. To mark a link as user-confirmed, use confirm_evidence after creation.

Remove a link between two pages.

Get the full hierarchy context for an entity: direct manager, subordinates, and peers.

Ingest content into the brain. Supports markdown (with frontmatter) and plain text. IMPORTANT: always provide title and pageType.

Ingest a dialogue/conversation into the brain. Use mode='auto' for automatic background capture (stricter filtering, only high-confidence facts). Use mode='manual' for explicit user-triggered ingestion.

Get full insight details by ID, including content and linked source entities.

Archive an insight. Archived insights are soft-deleted from active results.

Dismiss an insight as not useful. Dismissed insights won't appear in active results.

Unified job queue operations. Use action=submit/list/status/cancel/retry. Compatibility aliases remain available.

Submit a new job to the queue

List jobs, optionally filtered by status

Get detailed status of a specific job

Cancel a pending or running job

Retry a failed job

Maintenance-only bounded repair for Markdown Known Relations projection drift. Defaults to dry-run; execute requires an explicit limit.

实体合并专用安全入口。支持 dry_run（返回合并规划，零写入）和 execute（安全执行合并 + 自动验证残留）。仅限 derived 层（entity/concept/insight），拒绝 record 层。返回合并规划（影响分析、冲突检测、wikilink 重写预估）和执行后的验证摘要。

只读。返回当前最该处理的 top 1-3 项（跨健康/发现信号）。不修复、不删除、不合并、不提升候选。健康信号来自 run_action_candidates 已分类的候选，不重跑健康检查。

Run a 14-dimension health check (errors, dedup, slug collisions, consistency, structural consistency, completeness, islands, suggestions, attention, data readiness, source quality, etc.). Returns issues and writes a report file.

Run entity enrichment. Upgrades entity tiers based on mention counts.

Write insights back to the knowledge base. Actions: 'append' (add content to existing page), 'create_concept' (create new concept page), 'create_link' (add relation between two pages). All operations are logged.

Generate Obsidian-readable index files: All-Entities, All-Concepts, All-Sources, Dashboard.

Get brain status: page counts, sync info, watcher state, quarantine, etc.

Get recent ingest log entries.

异步执行完整夜间维护流程（sync → enrich → seal → cleanup → health → insight archive）。立即返回 job_id，后台执行。使用 dream_status 查询进度。有循环锁防止重叠执行。

查询最近一次 dream 任务的状态和阶段进度。

Clear the dream cycle lock. Use when a previous dream didn't finish and you need to force a new one.

Manage watcher quarantine and bulk-change backpressure. 'list' shows quarantined files. 'release'/'release_all' manages quarantine. 'bulk_status' shows bulk-pending state. 'bulk_resume' resumes paused bulk processing.

Audit and fix non-standard relation types. Modes: 'report' shows distribution, 'fix' migrates non-standard relations to canonical types. Use dry_run=true to preview changes before applying.

Get a page by slug. Returns frontmatter + body.

List pages in the brain. Optional type filter.

Append content to an existing page's body. Does NOT overwrite existing content. Triggers re-index and NER/wikilink extraction.

Delete a page by slug. Removes both the vault file and database entry.

Resolve page titles or partial names to slugs. Returns best match for each query.

Merge a source page into a target page. All links, timeline entries, tags and raw data are moved from source to target. Source body is appended to target body. Source page is deleted after merge. Use dryRun=true to preview without executing.

Unified alias operations. Use action=add/remove. Compatibility aliases add_alias/remove_alias remain available.

Add an alias to a page. NER will resolve the alias to this page instead of creating a new entity.

Remove an alias from a page.

读取 compact 项目状态 artifact，用于 Agent session continuity。只读，不写 vault/SQLite/LanceDB，不做 prompt 注入。

获取知识条目的溯源信息：来源、信任状态、纠正历史

设置知识条目的信任状态（仅降级/纠正，不可升级为 trusted）。要将条目升级为 trusted，请使用 confirm_evidence。

用户明确确认一条知识为可信事实。必须提供 confirmation_record_slug（vault 中已存在的页面）和 excerpt（该页面正文中必须包含的确认原文），系统会验证页面存在且 excerpt 出现在页面正文中。仅当用户在对话中明确表示认可时使用。

Get indexed text chunks for a page.

Sync vault files to SQLite + LanceDB indexes.

Remove database entries that have no corresponding vault file. Run this after manually deleting files from the vault.

Unified tag operations. Use action=list/add/remove. Compatibility aliases get_tags/add_tag/remove_tag remain available.

Get all tags for a page.

Add a tag to a page. Updates both the database and the vault file frontmatter.

Remove a tag from a page. Updates both the database and the vault file frontmatter.

Unified timeline operations. Use action=get/add. Compatibility aliases get_timeline/add_timeline_entry remain available.

Get timeline entries for a page.

Add a timeline entry to a page.

Get version history for a page.

Revert a page to a specific version. Creates a version snapshot before reverting.

生成认知变化摘要（Wake-up Diff）。对比上次快照，产出新增记忆项、内容更新、tier 变化、关系变化、置信度衰减等差异。首次运行建立基线。可由 dream 自动触发或手动运行。