# Review of open issues

## Open Issues
### AI Agents markdown files
- [link to issue](https://gitlab.cern.ch/blond/BLonD/-/work_items/327)
- MD files of human readable text used by AI coding agents
- No reliable way to ensure they stay up to date
- A few possible solutions, but none are ideal
- Closer to getting more licenses for several tools, problem should be solvable soon

### Numbering or naming conventions for examples
- [link to issue](https://gitlab.cern.ch/blond/BLonD/-/work_items/324)
- Parallel development causes issues with example numbering
- Current ordering not really suitable
- Possible to use tags/labels/etc?
- Display through webpage with tagging?

### Xsuite wrapper problems
- [link to issue](https://gitlab.cern.ch/blond/BLonD/-/work_items/321)
- Simon L. picking up XSuite <-> BLonD interface
- Weights:
    - Included in XSuite, but yet in BLonD
    - How widely used is it?  Do we need to include it in BLonD?
- Losses:
    - XSuite uses masking and flags to indicate different loss states
    - BLonD purges lost particles from the array
    - Not really used in BLonD2
    - "Real" losses rarely seen in BLonD, only dp/p acceptance, otherwise uncaptured beam
    - Using masking in BLonD would require significant changes
- "Smart" features:
    - Attributes like `ring.eta_0` assume we know what is happening in the ring
    - XSuite line can include devices that modify ring attributes subtly
    - Does it really matter?  Depends on usage.
    - Some level of user responsibility is required
    - An interface feature to correctly convert XSuite lines to mixed BLonD/XSuite would be useful
- Reference update:
    - XSuite typically updates the energy once per turn, optional update function can handle it
    - BLonD updates energy in the cavity or the ReferenceEnergyUpdate object
    - BLonD lacks single explicit reference, some parameters (energy, t_rev, ...) should be singularly contained
    - References currently don't update together, so BLonD could update it without XSuite knowing
    - To be seen how XSuite reference is handled
- Section indexing:
    - XSuite can have cavities within the line, not clear how this relates to sections
    - Can we transfer XSuite cavities to BLonD cavities?


## Roundtable
- Using and manipulating MAD-X and Twiss parameters in BLonD could be useful

### Agile workflows (Simon L.):
- Long feedback loops mean it takes a long time to correct errors/problems
- Use short development cycle to continuously update
- Best to raise issues as early as possible