# file_index

realm: default
repo: default
file_path: ./Cargo.toml
file_hash: 77cdbb13a1548e80
indexed_at: 2026-01-25T00:25:59.225246+00:00
summary:
This file defines the workspace configuration for a Cargo project, including package dependencies and members.

relationships:
This file is part of a larger Cargo project structure. It references other files such as `blue-core`, `blue-mcp`, `blue-ollama`, and `apps/blue-cli`. The file itself does not import any external crates but defines the workspace configuration for these referenced crates.


realm: default
repo: default
file_path: ./apps/blue-cli/src/main.rs
file_hash: 29d893e3a6999e5b
summary: Manages realms and their worktrees in a GitOps context
indexed_at: 2026-01-25T00:26:10.079836+00:00
relationships:
- from: "src/lib.rs"
  to: "src/commands.rs"
  kind: import
- from: "src/commands.rs"
  to: "src/client.rs"
  kind: import


realm: default
repo: default
file_path: ./crates/blue-core/src/daemon/client.rs
file_hash: f3c3557bf636454e
indexed_at: 2026-01-25T00:26:14.290742+00:00
summary:
This file defines a client for interacting with a hypothetical system's API endpoints such as sessions, notifications, and realms.


realm: default
repo: default
file_path: ./crates/blue-core/src/daemon/db.rs
file_hash: c824e09846393e23
indexed_at: 2026-01-25T00:26:21.428289+00:00
summary:
This file contains implementations for CRUD operations on realms, sessions, and notifications in a hypothetical daemon database system.

relationships:
- from: DaemonDb.rs
  to: RealmCRUDTests.rs
  kind: import
- from: DaemonDb.rs
  to: SessionCRUDTests.rs
  kind: import
- from: DaemonDb.rs
  to: NotificationCRUDTests.rs
  kind: import


realm: default
repo: default
file_path: ./crates/blue-core/src/daemon/server.rs
file_hash: ec31d75a833fd2a8
indexed_at: 2026-01-25T00:26:28.250399+00:00
summary:
This file contains the implementation for a web API router using Axum framework. It includes routes for handling HTTP requests related to sessions, notifications, and health checks.


realm: default
repo: default
file_path: ./crates/blue-core/src/documents.rs
file_hash: 78bd1f2ec9a395ab
indexed_at: 2026-01-25T00:26:30.903540+00:00
summary:
This file contains functions for creating and updating markdown content related to RFCs, spikes, issues, and other project artifacts.

relationships:
This file imports functionality from std::fs and regex crate.
It also uses the tempfile crate for temporary directory creation.


realm: default
repo: default
file_path: ./crates/blue-core/src/lib.rs
file_hash: 4d36b0805535ecf7
indexed_at: 2026-01-25T00:26:40.823701+00:00
summary:
This file is the library module for Blue Core, containing core data structures and logic with public exports.


realm: default
repo: default
file_path: ./crates/blue-core/src/realm/contract.rs
file_hash: 84b7559e6436f02c
indexed_at: 2026-01-25T00:26:55.009184+00:00
summary:
Defines the schema and values shared between repositories for cross-repo coordination in a blue-core crate


realm: default
repo: default
file_path: ./crates/blue-core/src/realm/domain.rs
file_hash: 157eabb943d16f02
relationships: This file depends on other files which are not listed here.
indexed_at: 2026-01-25T00:26:58.528103+00:00
summary:
This file contains implementations for Domain, Binding, and Import structs along with tests for their functionalities


realm: default
repo: default
file_path: ./crates/blue-core/src/realm/repo.rs
file_hash: c075dd6caac1ce4a
indexed_at: 2026-01-25T00:27:04.381353+00:00
summary:
This file defines the structure and functionality for managing repository configurations within realms.


realm: default
repo: default
file_path: ./crates/blue-core/src/realm/service.rs
file_hash: 700a554e397ea7fd
summary: Manages worktrees and lists them for a given realm
indexed_at: 2026-01-25T00:27:07.504152+00:00
relationships:
- name: "worktrees.rs"
  kind: "includes"
  description: "Contains the implementation of Worktree management functions"


realm: default
repo: default
file_path: ./crates/blue-core/src/workflow.rs
file_hash: b1f2742c4890c1bc
indexed_at: 2026-01-25T00:27:25.165022+00:00
summary:
This file defines enums for different stages in a software development workflow such as RFCs, PRDs, and SPIKES.

relationships:
This file imports the following:
- system: "file_path_to_system_file"
  description: "Description of how this file relates to other files."
It depends on the following files:
- system: "file_path_to_dependency_file"
  description: "Explanation of dependency relationship."


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/adr.rs
file_hash: b295dac53077b869
indexed_at: 2026-01-25T00:27:32.921080+00:00
summary:
This file contains functions and structs for parsing ADR citations, calculating relevance scores, and extracting keywords from ADR summaries.

relationships:
This file imports regex for parsing ADR citations.
It depends on the `adr_summary` struct for handling ADR data.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/audit_doc.rs
file_hash: 8bbd4aeb2d758a8f
indexed_at: 2026-01-25T00:27:39.176847+00:00
summary:
This file contains handlers for creating, listing, getting, and completing audit documents in the blue-mcp project.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/env.rs
file_hash: c9d5b1a554ad9b68
relationships: - from: blue_env_generator.rs kind: import to: std::env
indexed_at: 2026-01-25T00:28:15.556447+00:00
summary:
This file contains functions to detect dependencies and generate environment isolation files for a project.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/mod.rs
file_hash: 4822b27048d35905
indexed_at: 2026-01-25T00:28:38.807267+00:00
summary:
This file exports modules for handling different types of documents and workflows in the Blue MCP tool.

relationships:
This file is imported by other files within the `blue-mcp` crate.
For example, it is referenced by `./crates/blue-mcp/src/main.rs`.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/playwright.rs
file_hash: e04e5a36ff7f0da6
indexed_at: 2026-01-25T00:28:43.235261+00:00
summary:
This file defines functions to classify URL safety levels and generate Playwright MCP tool sequences for verification steps.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/postmortem.rs
file_hash: 8249b40eee5a5311
relationships: This file imports the `super` module which contains all significant functionality.
indexed_at: 2026-01-25T00:28:47.085657+00:00
summary:
This file contains functions for handling incident management including severity conversion, kebab-case to title case conversion, and test cases.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/pr.rs
file_hash: ab4d89a153909dd9
indexed_at: 2026-01-25T00:28:51.946507+00:00
summary:
This file contains functions for updating checkboxes in a test body and categorizing tasks based on patterns.

relationships:
This file imports `TaskCategory` from another module.
It is used by the main application logic which handles testing.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/prd.rs
file_hash: a23f74a6f273e64f
relationships: - from: product_requirements_manager.rs to: generate_prd_markdown.rs kind: import
indexed_at: 2026-01-25T00:28:58.878145+00:00
summary:
This file contains functions for managing Product Requirements Documents (PRDs), including generating markdown and parsing acceptance criteria.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/realm.rs
file_hash: b105e529a736b0bb
summary: Manages schema changes and notifications for a GitOps context
indexed_at: 2026-01-25T00:29:02.987329+00:00
relationships:
This file interacts with DaemonPaths to get database paths,
DaemonDb to interact with the daemon database, and detect_context to determine the current repository.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/release.rs
file_hash: 6259348174093ddd
indexed_at: 2026-01-25T00:29:06.987266+00:00
summary:
This file contains handlers for creating releases with semantic versioning analysis in a blue-mcp project.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/rfc.rs
file_hash: c1a976c7ac5782b
indexed_at: 2026-01-25T00:29:19.523752+00:00
summary:
This file contains the implementation for RFC tool handlers, specifically handling the completion of RFCs based on their progress and status.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/session.rs
file_hash: 65ed81f8298c0128
indexed_at: 2026-01-25T00:29:28.808590+00:00
summary:
This file contains handlers for session management in the blue-mcp crate, including handling pings, starting, ending, and listing sessions.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/handlers/staging.rs
file_hash: efde7f95337b00ab
indexed_at: 2026-01-25T00:29:36.575274+00:00
summary:
This file contains functions for managing project state and handling various operations related to a project's lifecycle.

relationships:
This file imports `super::system` which is assumed to be part of the same crate.
It also depends on `super::system::ProjectState` for its functionality.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/lib.rs
file_hash: 54028040db23cde6
indexed_at: 2026-01-25T00:29:41.957204+00:00
summary:
This file contains the implementation for a Blue MCP server that runs over stdio and handles JSON-RPC 2.0 requests.


realm: default
repo: default
file_path: ./crates/blue-mcp/src/server.rs
file_hash: 5ae9c11c2e5ced1b
relationships: This file imports functionality from other files which are not specified in the snippet.
indexed_at: 2026-01-25T00:29:48.310562+00:00
summary:
This file contains various functions for managing different aspects of a project such as audits, health checks, deployments, and more.


realm: default
repo: default
file_path: ./crates/blue-ollama/build.rs
file_hash: 1129d6f94f67904e
indexed_at: 2026-01-25T00:29:53.381783+00:00
summary:
This build script downloads Ollama binary for the target platform at build time and writes its path to a file.


realm: default
repo: default
file_path: ./install.sh
file_hash: 8c9cd8af683b2727
indexed_at: 2026-01-25T00:30:01.103098+00:00
summary:
This script installs the Blue CLI binary to a specified directory and updates MCP config if necessary.


# symbol_index

name: DaemonPaths
kind: struct
description:
Struct representing the paths used by the Blue daemon, including base directory, database file, realms directory, runtime directory, and PID file.


name: Governance
kind: enum
description:
How new repos can join, who can approve new repos (email addresses), and policy for breaking changes to contracts.


name: BreakingChangePolicy
kind: struct
description:
Specifies whether breaking changes require approval and the grace period in days before they take effect.


name: RepoConfig
kind: struct
description:
Defines a configuration for a repository within a realm, including details such as name, organization, path, URL, and maintainers.


name: handle_create
kind: function
description:
Handles the creation of a release with semantic versioning analysis and returns a Result containing the JSON response.


name: handle_ping
kind: function
description:
Handles the 'ping' action for session management, including validation and execution of actions like starting or ending sessions.


name: handle_start
kind: function
description:
Handles the 'start' action for session management, including validation and execution of actions like starting a new session.


name: handle_end
kind: function
description:
Handles the 'end' action for session management, including validation and execution of actions like ending an active session.


name: blue_health_check
kind: function
description:
Checks project health and finds issues such as stalled work, missing ADRs, overdue reminders, and recommendations.


