Files
fiona-assistant/src
nvaldez c0d0e97521 fix: wiki graph - implement invisible central gravity with node mass repulsion
- Custom forceCentralGravity: strong pull toward center for all nodes
- Additional pull for high in-degree nodes (degreeBonus = in_degree * 0.03)
- Custom forceNodeRepulsion: nodes repel based on their in-degree (mass)
- Repulsion strength = 500 / distance^2 * (d.in_degree + 1) * (other.in_degree + 1)
- Center force strength increased to 0.5
- Link distance reduced to 100 / sqrt(weight + 1)
- Slower alpha decay (0.01) for more stable simulation
- Result: high in-degree nodes (like SPEC.md) stay near center, others orbit around

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 12:39:01 +02:00
..
2026-09-23 21:03:09 +02:00
2026-09-27 20:08:55 +02:00
2026-09-20 10:13:47 +02:00

Fiona Assistant

A collection of tools for managing the LLM wiki and related operations.

Overview

The Fiona Assistant project provides command-line tools for:

  • Librarian: Managing LLM wiki content and operations
  • MDoctor: [Description to be added]

Installation

Development Setup

  1. Clone the repository:

    git clone <repository-url>
    cd fiona-assistant
    
  2. Set up the Python environment using the bootstrap script:

    source bootstrap --env fiona_env
    

    Or with a specific Python version:

    source bootstrap --env fiona_env --python 3.11.0
    
  3. Install the package in development mode:

    pip install -e .
    

Install with Development Dependencies

pip install -e ".[dev]"

Usage

Librarian

See librarian/README.md for detailed usage.

librarian --help

MDoctor

See mdoctor/README.md for detailed usage.

mdoctor --help

Project Structure

src/
├── fiona/          # Main package
├── librarian/      # Wiki content management tool
├── mdoctor/        # [Tool description]
├── tests/          # Unit tests
└── README.md       # This file

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=src

Development Tools

The project includes several development utilities:

  • bootstrap: Set up the Python development environment
  • src/utils.sh: Shell utility functions
  • src/install_packages.sh: Install local Python packages
  • src/run_tests.sh: Run the test suite

License

GPL-3.0-only

Contributing

[Contribution guidelines to be added]