Work Journal
Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.
Work Journal Entrywork_entry
A work accomplishment, feedback, or 1:1 note. Find's views also read the user's roles, counts by kind, the week's digest and competency growth.
worklog_findFindthrough vritto_findRead the Work Journal: one entry by id, entries newest first filtered by text, dates, kind, person, competency or role, or a view: 'stats' counts by kind, 'week' the week's digest, 'roles' the jobs, 'growth' competency coverage and gaps. ALWAYS pass from/to when the question concerns a period.
Note: view 'stats' counts, 'week' the weekly digest, 'roles' the jobs, 'growth' competency coverage; always pass from/to for a period.
| Field | Type | Description |
|---|---|---|
| id | string | Return just this entry, in full (details and STAR notes). |
| view | one of entries, stats, week, roles, growth | 'entries' (default with filters) the rows; 'stats' counts by kind for the period, no rows; 'week' the week's counts, notable titles and collaborators; 'roles' the user's jobs; 'growth' competency coverage and gaps for the period. |
| from | string | Start of the period, inclusive. |
| to | string | End of the period, inclusive. |
| query | string | Words from the entry's title, details or tags, e.g. 'flaky payments tests'. |
| kind | one of win, progress, learning, feedback, kudos, one_on_one_note, decision | What sort of entry this is. |
| personId | string | Only entries involving this person. |
| competencyId | string | Only entries tagged with this competency. |
| roleId | string | Only entries from this job/role; with view 'growth', that role's ladder (default the primary current role). |
| unenrichedOnly | boolean | Only entries still missing competencies or impact. |
| weekOf | string | View 'week': any date inside the week. Defaults to this week. |
| detail | one of summary, full | Row shape: "summary" (default, id, date, kind, title, labels and a 120-char preview) or "full" (every field including complete details and STAR notes). |
| limit | integer | Rows to return; defaults to 25 in summary mode. |
| cursor | string | Pagination cursor from a prior result. |
| entryId | string | Older name for id. |
Example input
{
"from": "2026-04-01",
"to": "2026-06-30",
"kind": "win"
}worklog_addCreatethrough vritto_createRecord something the user did at work. Use for any 'I shipped/fixed/presented/led…' statement; only title is required and the date defaults to today.
| Field | Type | Description |
|---|---|---|
| title* | string | One line describing what happened, in the user's words. |
| kind | one of win, progress, learning, feedback, kudos, one_on_one_note, decision | What sort of entry this is. |
| details | string | Extra context the user gave. Never invent detail. |
| entryDate | string | The day the work happened. Defaults to today. |
| personIds | list of string | Collaborators, or the person who gave the feedback. |
| visibility | one of normal, invisible_work | Use "invisible_work" for glue work: refactors, mentorship, code review, docs. |
| impactStatement | string | Why it mattered: only if the user stated it. |
Example input
{
"title": "Shipped the billing migration with zero downtime",
"kind": "win",
"entryDate": "2026-09-25",
"impactStatement": "Moved 12k subscriptions without a failed charge."
}worklog_changeUpdatethrough vritto_updateChange one entry by id: sent fields merge, arrays replace wholesale (read the entry first). Correct the title, date, kind or details, or enrich it with impact, competencies and STAR notes, which marks it enriched. Never invent figures the user did not state.
Note: Arrays replace wholesale; read the entry first. Impact, competencies or STAR notes mark it enriched.
| Field | Type | Description |
|---|---|---|
| id | string | The entry to change. Required. |
| title | string | |
| kind | one of win, progress, learning, feedback, kudos, one_on_one_note, decision | What sort of entry this is. |
| details | string | |
| entryDate | string | Local date YYYY-MM-DD. |
| visibility | one of normal, invisible_work | Use "invisible_work" for glue work: refactors, mentorship, code review, docs. |
| personIds | list of string | Replaces the list. |
| impactStatement | string | Why it mattered, in concrete terms the user gave. Marks the entry enriched. |
| competencyIds | list of string | Competency IDs from the user's ladder. Replaces the list; marks the entry enriched. |
| starNotes | object | Situation/Task/Action/Result framing for interviews. Marks the entry enriched. |
| starNotes.situation | string | |
| starNotes.task | string | |
| starNotes.action | string | |
| starNotes.result | string | |
| expectedRevision | integer | Revision from the last read; the write is refused if the entry changed since. |
| entryId | string | Older name for id. |
Example input
{
"id": "entry_billing",
"impactStatement": "Moved 12k subscriptions without a failed charge."
}worklog_removeDeletethrough vritto_deletePermanently delete one work-journal entry. Only on an explicit request naming the entry; resolve the id with worklog_find first.
| Field | Type | Description |
|---|---|---|
| id | string | The entry to delete. |
| entryId | string | Older name for id. |