Skip to content

UI port - #2

Merged
DMontgomery40 merged 4 commits into
mainfrom
ui-port
Jan 31, 2026
Merged

UI port#2
DMontgomery40 merged 4 commits into
mainfrom
ui-port

Conversation

@DMontgomery40

Copy link
Copy Markdown
Owner

This pull request introduces several improvements and refactors to the TriBridRAG codebase and documentation, focusing on clarifying the "corpus-first" architecture, updating API endpoints, improving Docker and environment configuration, and enhancing type generation and documentation tooling. The changes aim to make the system more modular, user-friendly, and maintainable as it evolves.

Key changes include:

Corpus-first architecture and API updates

  • Updated documentation (README.md, CLAUDE.md) to clarify that TriBridRAG is "corpus-first" rather than "repo-first", explaining that a corpus can be any folder (not just a git repo), and that repo_id should be treated as a corpus identifier for backward compatibility. [1] [2]
  • Updated API endpoint documentation and examples to use /api/ prefixes and corpus terminology, including new endpoints for corpus management and indexing. [1] [2]
  • Added a new section in the README for creating and indexing corpora via the UI or API, with updated curl examples and port numbers. [1] [2] [3]

Docker and environment configuration improvements

  • Changed Docker Compose and .env.example to support storing Postgres and Neo4j data outside the repo by default, using a configurable TRIBRID_DB_DIR variable for easier local development and persistence. [1] [2]
  • Updated Neo4j configuration to allow easy switching between Community and Enterprise editions via environment variables, and improved documentation/comments. [1] [2]
  • Removed unused Docker volumes for Postgres and Neo4j data/logs, since these are now handled via bind mounts.

Type generation and serialization

  • Enhanced the TypeScript type generation script (scripts/generate_types.py) to include new domain models for corpora, chunk summaries, keywords, and eval-related types, and to generate schemas in serialization mode (using aliases such as corpus_id instead of repo_id). This supports the corpus-first migration and improves API/TypeScript alignment. [1] [2] [3] [4] [5]

Documentation and tooling improvements

  • Updated the documentation structure and cross-linking rules in the AI documentation bootstrap script, ensuring that only valid pages are linked and that the doc generator uses the new OpenAI Responses API for generation. [1] [2] [3]
  • Refreshed the MkDocs navigation and landing page to match the new documentation structure and terminology.
  • Added mypy configuration overrides for third-party modules to suppress missing import errors.

Codebase refactoring

  • Refactored FastAPI router imports to include new modules for chunk summaries and keywords, improving modularity and clarity in the API layer. [1] [2]
  • Updated the default fusion retrieval service in the chat API to use the new TriBridFusion implementation, supporting per-corpus configuration. [1] [2]

These changes collectively modernize the codebase, clarify the architecture, and lay groundwork for future features and scaling.

- Added a new section in CLAUDE.md and README.md to clarify the concept of "corpus" as the primary unit for indexing and searching, replacing the previous "repo" terminology.
- Updated API endpoints to reflect the new corpus-centric approach, including changes to endpoint paths and request parameters.
- Enhanced the configuration management to support corpus-specific settings, ensuring backward compatibility with the existing `repo_id` field.
- Improved the indexing process with better error handling and support for corpus management.
- Updated the documentation to provide clear instructions for creating and indexing corpora via the API.

This commit significantly improves the clarity and functionality of the API, aligning it with the new corpus-first architecture.
…base management

- Updated `.env.example` and `docker-compose.yml` to support external database storage, allowing users to specify a directory for PostgreSQL and Neo4j data.
- Added new environment variables for Neo4j image selection and license agreement handling.
- Enhanced `tribrid_config.json` with new parameters for Neo4j database management, including shared and auto-creation options.
- Improved documentation in `mkdocs` to reflect changes in configuration and provide clearer guidance on setup and usage.
- Introduced a new script for enhanced documentation generation using OpenAI, streamlining the documentation process.

These changes improve the flexibility and usability of the Docker setup, aligning it with the corpus-first architecture and enhancing overall user experience.
…file inclusion/exclusion

- Added methods to read and normalize .gitignore patterns, allowing for nested gitignore semantics.
- Enhanced the file loading process to respect gitignore rules, ensuring that ignored files and directories are not included in the results.
- Introduced a new test suite to validate the behavior of FileLoader with various gitignore configurations, confirming that only the intended files are loaded.

These changes significantly enhance the FileLoader's functionality, aligning it with common version control practices and improving overall usability.
@DMontgomery40
DMontgomery40 merged commit 83ce0cc into main Jan 31, 2026
0 of 2 checks passed
DMontgomery40 added a commit that referenced this pull request Feb 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant