Fountain Coach Gitowner-controlled · read only

fountainai-bootstrap-service.git · README.md

fountainai-bootstrap-service.git / README.md

revision 6969a798a5301a69e2820159c610c8cfef2c45a3 · complete file

<p align="right">
  <img src="https://raw.githubusercontent.com/Fountain-Coach/fountainai-bootstrap-service/main/assets/bootstrap-logo.png" alt="Bootstrap Logo" width="160">
</p>

# FountainAI Bootstrap Service

The **FountainAI Bootstrap Service** initializes semantic corpora and seeds them with GPT-ready metadata and role patterns. It performs the earliest stage of orchestration within the [Fountain‑Coach GitHub organization](https://github.com/Fountain-Coach).

---

## Project Status

This service is in **pre-alpha**, fully containerized, and part of the FountainAI microservice stack.

---

## What It Does

The Bootstrap Service coordinates three core tasks:

1. **Corpus Initialization** — creates an empty semantic corpus in the [Baseline Awareness Service](https://github.com/Fountain-Coach/baseline-awareness-service).  
2. **Role Seeding** — injects default GPT analysis roles.  
3. **Reflection Kickoff** — submits an initial “role-health-check” reflection.

After bootstrapping, services like the Planner and Awareness Service can operate immediately.

---

## API Overview

Built on **OpenAPI 3.1.0**, with client generation via the [ClientGen Service](https://github.com/Fountain-Coach/clientgen-service).

| Endpoint                               | Description                                |
|----------------------------------------|--------------------------------------------|
| `POST /bootstrap/corpus/init`          | Corpus + roles + initial reflection        |
| `POST /bootstrap/roles`               | Inject default GPT role prompts            |
| `POST /bootstrap/roles/promote`       | Promote a reflection into a role           |
| `POST /bootstrap/baseline`           | Add a baseline and stream analysis         |
| `POST /bootstrap/corpus/reflect`      | Enqueue another default reflection         |

---

## Logo Usage

<p align="right">
  <img src="https://raw.githubusercontent.com/Fountain-Coach/fountainai-bootstrap-service/main/assets/bootstrap-logo.png" alt="Bootstrap Logo" width="160">
</p>

Include this when visually identifying or referencing the service.

---

## Related Projects & Organization

- [Fountain‑Coach GitHub organization](https://github.com/Fountain-Coach)  
- [fountainai-bootstrap-service](https://github.com/Fountain-Coach/fountainai-bootstrap-service)  
- [baseline-awareness-service](https://github.com/Fountain-Coach/baseline-awareness-service)  
- [clientgen-service](https://github.com/Fountain-Coach/clientgen-service)  
- [swarm-orchestrator](https://github.com/Fountain-Coach/swarm-orchestrator)  
- [fountain-manifesto](https://github.com/Fountain-Coach/fountain-manifesto)

---

## License

© [Fountain Coach](https://fountain.coach). Released under the MIT License.