Skip to content

Enhance validator tool access and implement knowledge graph layer#160

Open
nmaguiar wants to merge 2 commits into
mainfrom
wiki-graph
Open

Enhance validator tool access and implement knowledge graph layer#160
nmaguiar wants to merge 2 commits into
mainfrom
wiki-graph

Conversation

@nmaguiar
Copy link
Copy Markdown
Contributor

This pull request introduces a comprehensive knowledge graph layer for the Mini-A wiki system, enabling structural and semantic graph operations, FalkorDB integration, and graph-based search enhancements. It also adds a new validation feature (valtools) to allow the validator read-only access to files and URLs referenced in validation goals. The documentation is updated accordingly to reflect these new features and configuration options.

Wiki Knowledge Graph Layer

  • Added support for a knowledge graph layer in the wiki, including new configuration options (usewikigraph, wikigraphsemantic, wikigraphcommunity, wikigraphsearchhints, wikigraphhintcap, and FalkorDB connection options) in both code and documentation. [1] [2] [3] [4]
  • Implemented new graph operations (build, retrieve, answer, query, neighbors, path, communities, surprise, stats, export, falkor) accessible via both API and console commands. [1] [2] [3] [4] [5]
  • Ensured the graph index is rebuilt alongside the search index during key wiki operations (init, edit, write, delete, move, reindex). [1] [2] [3] [4] [5] [6] [7]
  • Added FalkorDB sync/query support for advanced graph operations. [1] [2] [3] [4] [5]

Validation Enhancements

  • Introduced the valtools option to give the validator read-only tool access (read_file, fetch_url) for validation goals that require inspecting input files or URLs. Documentation now clarifies when and why to use this option. [1] [2] [3]

Documentation Improvements

  • Updated all relevant documentation (CHEATSHEET.md, README.md, USAGE.md) to describe new graph and validation features, configuration flags, and usage patterns. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11]

Debugging and Validation Channel Behavior

  • Clarified the behavior of the debugvalch debug channel: it now logs validation calls directly when no dedicated validation model is configured. [1] [2]

Default Configuration

  • Enabled the knowledge graph by default in the wiki manager configuration for new wikis.

These changes collectively add a powerful new graph-based capability to the wiki system, improve validation flexibility, and ensure the documentation and configuration options are clear and up to date.

nmaguiar added 2 commits May 31, 2026 02:34
- Introduce valtools option to give the validator read-only tool access
- Improve debugvalch logging for both dedicated and main LLM validation
- Normalize validation scores from 0-10 to 0-1 scale
- Explicitly highlight failed cycle issues in _buildCycleKnowledge to ensure they are addressed
- Deduplicate accumulated learnings to prevent context inflation
- Add wiki graph build, query, and analysis capabilities
- Introduce mini-a-graph.js for graph logic and processing
- Add new configuration options for graph behavior and FalkorDB integration
- Update wiki action and console commands to support graph operations
- Add new MCP tools for graph queries, neighbors, communities, and stats
- Include tests for graph functionality
@nmaguiar nmaguiar self-assigned this May 31, 2026
@nmaguiar nmaguiar added the enhancement New feature or request label May 31, 2026
@nmaguiar nmaguiar marked this pull request as ready for review May 31, 2026 05:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

1 participant