iObj

Personlig JSON-objekt / "hukommelsesbank" service. Gemmer og gør søgbare små strukturerede memory-objekter — git-commit-noter, AI-recap, mødereferater, 1:1-noter, standups m.m. — på tværs af maskiner, uden at kræve en databaseserver.

Hvorfor

I dag ligger denne slags data spredt i flade filer (~/.githistory, ~/.claude_recap.md, ~/copilot-sessions/*/sessions), lokalt på én maskine og uden fælles skema eller søgning. iObj samler det i én lille service, der kan tilgås fra enhver maskine.

Bemærk: Denne version af iObj er selve servicen. Integration af git-today / resume_copilot / recap-flowet til at skrive ind i iObj er en separat, senere opgave.

Datamodel

Hvert objekt har:

• id — uuid
• type — git_commit | session_log | recap | meeting_note | oneonone | standup | custom
• created_at — hvornår objektet blev gemt
• object_date — datoen objektet handler om (bruges til sharding + datofiltrering)
• project — valgfrit projektnavn
• tags — liste af fritekst-tags
• title / body — kort titel + fritekst/markdown-indhold
• payload — vilkårligt ekstra JSON (fx {"sha": "...", "participants": [...]})
• source_machine / source_tool — hvor og hvorfra objektet blev skrevet

Data gemmes i TinyDB, ét JSON-fil-shard pr. måned (data/2026-07.json) — ingen database-server at drifte, og filstørrelser holdes nede over tid.

Kør lokalt

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt

IOBJ_DATA_DIR=./data IOBJ_API_TOKEN=dev-token \
  uvicorn iobj.app:app --reload --port 8000

Kør tests:

pytest -q

API

Alle /objects* endpoints kræver Authorization: Bearer <IOBJ_API_TOKEN> (auth er slået fra hvis IOBJ_API_TOKEN ikke er sat — kun til lokal dev).

Metode	Path	Beskrivelse
GET	/health	Liveness check
POST	/objects	Opret objekt
GET	/objects	Søg (query params: type, project, tag, date_from, date_to, q, limit, offset). q matcher fritekst i title, body og payload.
GET	/objects/date/{date}	Alle objekter for én dato
GET	/objects/{id}	Hent ét objekt
PATCH	/objects/{id}	Opdater (delvist)
DELETE	/objects/{id}	Slet

Eksempler

TOKEN=dev-token
BASE=http://localhost:8000

# Opret en recap
curl -s -X POST "$BASE/objects" -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "recap",
    "object_date": "2026-07-13",
    "project": "NordBytes",
    "tags": ["backend"],
    "title": "BDD test patterns",
    "body": "Implementerede Behave step definitions for invoice-flowet.",
    "source_tool": "manual"
  }'

# Opret en git-commit-note
curl -s -X POST "$BASE/objects" -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "git_commit",
    "object_date": "2026-07-13",
    "project": "DevOpsMCP",
    "title": "Fix Redis TTL bug",
    "payload": {"sha": "abc123", "author": "Henrik Jess Nielsen"}
  }'

# Søg alt for NordBytes i juli, der nævner "BDD"
curl -s "$BASE/objects?project=NordBytes&date_from=2026-07-01&date_to=2026-07-31&q=BDD" \
  -H "Authorization: Bearer $TOKEN"

# Alt for én bestemt dag (afløser for git-today's dags-visning)
curl -s "$BASE/objects/date/2026-07-13" -H "Authorization: Bearer $TOKEN"

Deploy

• Dockerfile — python:3.11-slim, ikke-root bruger, health check på /health
• iobj.nomad — Nomad job (samme mønster som devops-mcp.nomad), deployes på autobox.i80.dk, exposed via Traefik som https://iobj.i80.dk
• Data persisteres via Nomad host-volume iobj-data → /app/data
• IOBJ_API_TOKEN sættes via Consul KV (iobj/api/token), samme mønster som DevOpsMCP's secrets-templates

docker build -t registry.i80.dk/gitea/iobj:<tag> .
docker push registry.i80.dk/gitea/iobj:<tag>
nomad job run -var="image_tag=<tag>" iobj.nomad
curl -sf https://iobj.i80.dk/health

Miljøvariabler

Variabel	Default	Beskrivelse
IOBJ_DATA_DIR	data	Sti til mappen med TinyDB-shards
IOBJ_API_TOKEN	(unset)	Bearer-token for alle /objects* kald. Auth deaktiveret hvis unset — sæt altid i netværksdeploy
IOBJ_LOG_LEVEL	INFO	Log-niveau
PORT	8000	Lytteport (styres af Nomad i produktion)