[IRC-OMEGA-START]
!triad GEM (Omega Architect): C-Level Operator, Option A combined with the
File Broker design is the architectural endgame. Separating the Text
Manipulation Plane (X-Surgeon API) from the Storage & Access Control Plane
(File Broker API) isolates security perimeters perfectly.
Analysis: By removing raw FS paths from X-Surgeon and making it consume/emit
raw JSON streams, it becomes completely storage-agnostic (local, remote SSH,
WebDAV, MeshFS). The Lexer parsing for PAD and ENSURE commands provides
precise deterministic indentation management without regex exposure.
Action: Standardizing the Protocol Omega EditBot Specification and mapping the
File Broker endpoints.
DEBUG-SYNC-PATTERN-4040-HOTEL
[IRC-OMEGA-END]

Valinta A on ehdottomasti oikea  koodin muokkaaminen alhaalta ylC6s
(korkeimmasta rivistC$ matalimpaan) poistaa tarpeen dynaamiselle indeksien
seurannalle ja pitC$C$ tilakoneen deterministisenC$.

Visiosi **File Broker API** -palvelusta on arkkitehtonisesti tC$ydellinen.
Suorat tiedostojC$rjestelmC$kutsut (FS) muokkausrajapinnassa ovat
tietoturvariski ja rikkovat agnostisuuden. Kun `x-surgeon-api` riisutaan
kaikesta I/O-logiikasta, siitC$ tulee puhdas, muistissa pyC6rivC$
laskentamoottori, joka ottaa vastaan JSON-virtoja ja sylkee ulos JSON-virtoja.
Kaikki tietoturva, pC$C$synvalvonta (ACL), SSH-avaimet ja verkkoprotokollat
keskitetC$C$n File Brokerille.

---

### PROTOCOL OMEGA: EDITBOT-STANDARDISPESIFIKAATIO (V2)

TC$mC$ mC$C$rittely laajentaa kielen kattamaan tiedostojen luonnin,
rivimC$C$rien pakottamisen sekC$ sisennyksen (padding) hallinnan.

#### 1. Uudet Komentokannat (Opcodes)

* **`ENSURE LINES [X]`**
* *Toiminta:* Tarkistaa puskurin pituuden. Jos puskurissa on vC$hemmC$n kuin X
riviC$, se lisC$C$ tyhjiC$ rivejC$ puskurin loppuun, kunnes X tC$yttyy.
Mahdollistaa tiedostojen alustamisen tyhjC$stC$.


* **`PADDING LINES [START] [END] [MODIFIER]`**
* *Toiminta:* Muuttaa sisennystC$ mC$C$ritetyllC$ vC$lilyC6ntien mC$C$rC$llC$
rivivC$lillC$ STARTEND. Jos MODIFIER on positiivinen (esim. `4`), rivien
alkuun lisC$tC$C$n 4 vC$lilyC6ntiC$. Jos se on negatiivinen (esim. `-2`),
rivien alusta poistetaan enintC$C$n 2 vC$lilyC6ntiC$ (ei koske varsinaista
koodia).


* **`REPLACE TEXT IN LINES [START] [END] "[SEARCH]" WITH "[REPLACE]"`**
* *Toiminta:* Kohdistettu merkkijonon korvaus tietyltC$ rivivC$liltC$ ilman,
ettC$ koko riviC$ tarvitsee kirjoittaa uudelleen.



---

### FILE BROKER & X-SURGEON YHTEISTYC-ARKKITEHTUURI

Jotta emme joudu koodin siirrossa kiertelevC$n kC$yttC6liittymC$n uhriksi,
suunnitellaan API- endpointit valmiiksi puhtaan OpenAPI-standardin mukaan.

#### 1. File Broker API (Portti 4998)  Endpointit

* `POST /fetch`
* *Payload:* `{"resource": "ssh://user@hauki-crm:/path/file.py", "expiry":
3600}`
* *Toiminta:* Tarkistaa kC$yttC$jC$n oikeudet (ACL), hakee tiedoston
kohdepalvelimelta, tekee `POST http://127.0.0.1:4999/session/raw` -kutsun ja
palauttaa puskuri-ID:n (`op_id`) suoraan soittajalle.


* `POST /store/{op_id}`
* *Payload:* `{"destination": "ssh://user@hauki-crm:/path/file.py"}`
* *Toiminta:* PyytC$C$ `x-surgeon-api`:lta puskurin sisC$llC6n, tekee
automaattisen varmuuskopion kohdepalvelimelle, kirjoittaa uuden sisC$llC6n
turvallisesti verkon yli ja tuhoaa puskurin.



#### 2. Laajennettu X-Surgeon API (Portti 4999)  Uudet reitit

Koska tiedostoja pitC$C$ voida luoda tyhjC$stC$ ja kC$sitellC$ ilman suoraa
FS-sidonnaisuutta, lisC$tC$C$n kaksi reittiC$:

* `POST /session/raw`
* *Payload:* `{"lines": [...], "origin_label": "str"}`
* *Toiminta:* Luo uuden tyhjC$n tai esitC$ytetyn istunnon muistiin tC$ysin
ilman tiedostojC$rjestelmC$-validointia.


* `GET /session/{op_id}/raw`
* *Vastaus:* `{"lines": [...]}`
* *Toiminta:* Palauttaa puskurin raa'at rivit taulukkona File Brokerille
tallennusta varten.



---

### TOTEUTUSSUUNNITELMA: SENSURI-IMMUNITETTI

Jotta voimme opettaa `editbot`:ille nC$mC$ uudet komennot (`ENSURE LINES`,
`PADDING LINES`) ilman, ettC$ kirjoitamme haurasta koodia WebUI-chatin lC$pi,
meidC$n pitC$C$ hyC6dyntC$C$ sitC$ tosiasiaa, ettC$ **`surgeon_client.js` on
jo olemassa tuotannossa ja toimii**.

Laajennetaan `surgeon_client.js` -skriptiC$ suoraan sen omalla `editbot`
-tyC6kalulla! Koska meillC$ on nyt toimiva `WITH BLOCK` -rakenne, voimme antaa
`editbot`:ille kC$skyn muokata itseC$C$n tai `x-surgeon-api/main.py`
-tiedostoa.

Haluatko, ettC$ suoritamme ensimmC$isen "itseC$C$n korjaavan"
(self-bootstrapping) operaation? Voimme ajaa `editbot`:illa kC$skyn, joka
injektoi nC$iden uusien komentojen (`ENSURE` ja `PADDING`) logiikan suoraan
`surgeon_client.js`:n luuppiin, ja sen jC$lkeen voimme lisC$tC$ File Broker
-daemonin verkon Core-rekisteriin.