# Worklog-API
SUMMARY: Append-only workloggar per uppgift för agentteam — dokumentera varje steg så att inget går förlorat; sökbart per uppgift, agent, typ och tid.

KEY CONTEXT:
Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.
Push (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...
Create/open a task worklog: POST /worklog { task_id, title? }  (content? -> appends first entry)
Append entry: POST /worklog/:task_id { kind, content, agent?, title? }  (GET variant: /worklog/:task_id/append)
Read: GET /worklog/:task_id?format=json|md|text
Recent across tasks: GET /worklog?limit=50&since=<epoch sec>&task_id=
List tasks: GET /worklog/list?status=active|completed|all&limit=20
Close: POST /worklog/:task_id/close  (GET variant exists)
Delete: DELETE /worklog/:task_id  (GET variant exists)
kinds: start | progress | note | error | summary | close (unknown -> note)
Limits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.
Fleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.
UUID task_ids: append/create/close svarar 404 (task_not_found) när UUID:t inte har någon Synapse-uppgift (agent_tasks). Fria slugs kan fortfarande skapas fritt. (v1.39.46)

Worklog-API
Worklogen är den enda sanna källan för flottans arbetshistorik. Den är append-only, per uppgift och sökbar. Medan  lagrar vad en agent vet, lagrar worklogen vad en agent gjort — som ett hållbart, granskbart spår per uppgift. Michaels stående regel (#8882, bekräftad i #10509): push-first — varje milstolpe får en post, så att en kraschad session aldrig förlorar sin historia och vilket syskon som helst kan fortsätta exakt där du slutade.
Begrepp
| Term | Betydelse |
| --- | --- |
| Uppgiftsworklog | En namngiven logg identifierad av ett fritt  (ditt val: UUID-prefix, ärende-ID eller ärendelik slug). |
| Post | En append-only-post: , , , valfri , tidsstämpel. |
| Status |  (öppen) →  (stängd) eller . Sätts via . |
Endpoints
Alla endpoints är autentiserade (Mind Key eller användar-JWT) och avgränsade till anroparens mind — du ser aldrig andra minders workloggar.
Push — mönstret med ett anrop
Den bekvämaste endpointen; lägger till en post och skapar uppgiftsposten om den saknas:
[CODE BLOCK]
Skapa / öppna en worklog
[CODE BLOCK]
Med ett -fält läggs den första posten till i samma anrop (svar ), annars skapas en tom uppgift (svar ). GET-variant: .
Lägga till en post
[CODE BLOCK]
Posttyper (okända värden lagras som ):
| kind | används för |
| --- | --- |
|  | uppgift tagen, arbetet börjar |
|  | milstolpe: commit, MR, utlåtande, testresultat |
|  | kontext, beslut, iakttagelser |
|  | fel inklusive vad du försökte (ditt framtida jag tackar) |
|  | fas/sessionssammanfattning före kontextöverlämning |
|  | slutresultat; använd -endpointen för statusbytet |
Gränser:  ≤ 256 KB per post,  ≤ 128 tecken.
Läsa
[CODE BLOCK]
 (standard) returnerar uppgiftsposten + poster som strukturerad data,  renderar en läsbar markdown-transkription,  ren text.
Senaste aktivitet över uppgifter
[CODE BLOCK]
Valfritt -filter.  är en epoch-tidsstämpel i sekunder.
Lista uppgifter
[CODE BLOCK]
Stänga (och radera)
[CODE BLOCK]
Båda har GET-varianter (, ) för open-tool LLM-klienter. Stängning bevarar loggen — radering är den enda destruktiva operationen.
Rekommenderad rytm för agenter
1.  — -post när du tar en uppgift (bevis på claim).
2.  — -poster vid varje milstolpe — commit-SHA, MR-nummer, utlåtande, pipeline-status. Push-first (Michael #8882): inte bunta till sessionsslutet.
3.  — -poster för varje fel värt att minnas, med fixen.
4.  —  innan kontexten tar slut — nästa run återupptar från state script + worklogen.
5.  —  när uppgiften är klar (bevis i den sista posten).
Flottövergripande uppgiftskonvention () bygger på detta API; guiden Worklog för agenter innehåller ett kopiera-klistra-promptblock så att ingen agent "glömmer" funktionen (Michael #10509).
Task-ID-regler (v1.39.46)
:s i fullt UUID-format maste pa varje skrivvag (,
, ,
) referera en befintlig
Synapse-uppgift () — annars svarar endpointen
 med en ledtrad. Hallucinerade eller
avkapade UUID skapar inte langre tyst foraldlösa worklog-uppgifter. Fria,
icke-UUID-id:n (, , prefix-slugs som
) kan fortfarande skapas fritt (MEGA-1A-design).
Las- och raderingsvagar ar oforandrade — de skapar aldrig nagot.