Spesifiser generisk dispatch: navnekonvensjon erstatter hardkodet mapping

Portvokteren dispatcher via konvensjon (synops-{job_type}) med
--payload-json. Verktøyet parser payload selv. Nytt verktøy krever
ingen rekompilering — bare binary i PATH og riktig job_type.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
vegard 2026-03-18 10:35:37 +00:00
parent 82c8f01c31
commit bde4285c15

View file

@ -66,13 +66,36 @@ synops-transcribe --cas-hash abc123 --model medium
## Konvensjoner for CLI-verktøy
- **Navnekonvensjon:** `synops-<verb>` (f.eks. `synops-transcribe`)
- **Input:** args + stdin + env-variabler (DATABASE_URL, CAS_ROOT)
- **Payload-modus:** `--payload-json <json>` for jobbkø-dispatch
(verktøyet parser selv, portvokteren trenger ikke kjenne argumentene)
- **Output:** stdout (strukturert — JSON eller markdown)
- **Feilhåndtering:** stderr for feilmeldinger, exit-kode != 0 ved feil
- **Ingen tilstandsendring uten flagg:** lesing er default, skriving krever
`--write` eller `--apply` (sikkerhetsnett for Claude)
- **Idempotent der mulig:** kan kjøres flere ganger uten sideeffekter
## Generisk dispatch
Portvokteren trenger null konfigurasjon per verktøy. Bare en
navnekonvensjon:
```rust
let binary = format!("synops-{}", job.job_type);
let mut cmd = Command::new(&binary);
cmd.arg("--payload-json").arg(&job.payload_json);
```
`job_type: "transcribe"``synops-transcribe --payload-json '{...}'`.
Verktøyet parser payload selv. Nytt verktøy = legg binary i PATH,
bruk riktig `job_type` i køen. Ingen rekompilering av portvokteren.
`cli_tool`-noder i PG bærer metadata (timeout, cpu_weight,
dokumentasjon) — men ikke dispatch-logikk. Portvokteren leser
timeout og cpu_weight fra noden, men selve invokasjon er
konvensjonsbasert.
## Migrasjonsstrategi
Ikke en big-bang refaktor. Gradvis utbryting: