synops/tools/README.md
vegard cfec20f024 Implementer synops-search CLI-verktøy (oppgave 21.11)
Fulltekstsøk i noder via PostgreSQL tsvector/tsquery med norsk
tekstkonfigurasjon. Bruker eksisterende GIN-indeks fra migrasjon 011.
Støtter --kind-filter og --limit. Output: markdown med relevans-score
og utdrag (ts_headline med «»-markering).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 10:08:51 +00:00

1.8 KiB

Synops CLI-verktøy

CLI-verktøy for Claude sin interaksjon med systemet. Bruker PG direkte eller maskinrommet-API. Ligger i PATH via symlink eller direkte kall.

Verktøy

Verktøy Beskrivelse Status
synops-transcribe Whisper-transkribering av lydfil fra CAS Ferdig
synops-audio FFmpeg lydprosessering med EDL (cut, normalize, EQ, m.m.) Ferdig
synops-render Tera HTML-rendering til CAS (artikler, forsider) Ferdig
synops-rss RSS/Atom-feed generering for samlinger Ferdig
synops-tts Tekst-til-tale via ElevenLabs, lagrer lyd i CAS Ferdig
synops-summarize AI-oppsummering av kommunikasjonsnode via LiteLLM Ferdig
synops-suggest-edges AI-foreslåtte edges (topics/mentions) for en node via LiteLLM Ferdig
synops-respond Claude chat-svar i kommunikasjonsnoder Ferdig
synops-prune Opprydding av gamle CAS-filer (TTL + disk-nødventil) Ferdig
synops-context Hent kontekst for en samtale (deltakere, historikk, spec, relaterte noder) Ferdig
synops-search Fulltekstsøk i noder (title + content, norsk tsvector) Ferdig

Konvensjoner

  • Navnekonvensjon: synops-<verb> (f.eks. synops-context)
  • Shell-scripts eller Rust binaries
  • Ett verktøy per oppgave — hold det enkelt
  • Output: stdout, strukturert tekst (markdown eller JSON)
  • DB-tilkobling: $DATABASE_URL eller fra /tmp/maskinrommet.env

Planlagte verktøy

Ref: docs/infra/agent_api.md

  • synops-context — implementert (se tabell over)
  • synops-search — implementert (se tabell over)
  • synops-tasks [--phase N] [--status S] — oppgavestatus fra tasks.md
  • synops-feature-status <key> — implementeringsstatus for en feature
  • synops-respond — implementert (se tabell over)
  • synops-update-spec <node_id> — oppdater spec-node (stdin)