get_goal
Beschreibung
Section titled “Beschreibung”Liefert alle Details zu genau einem Ziel anhand seiner ID — innerhalb der verbundenen Organisation, inklusive Abhängigkeiten, Wirkungen und Aufwand in einem Aufruf. Jeder Abschnitt meldet seinen eigenen hydration-Status, damit ein leerer Abschnitt nicht mit einem nicht lesbaren verwechselt wird. completedAt ist null, solange für das Ziel kein Abschlussdatum erfasst ist — das ist KEIN Beleg dafür, dass es nicht abgeschlossen ist, denn auch ein Ziel in reflect oder done kann ohne erfasstes Datum vorliegen. Wie verlässlich ein vorhandener Wert ist, sagt completedAtSource: stage_change ist ein von der App beobachteter Übergang und exakt, change_event stammt aus einem protokollierten Phasenwechsel und kann zu FRÜH liegen, wenn das Ziel wieder geöffnet und erneut abgeschlossen wurde, und updated_at ist lediglich der Zeitpunkt der letzten Änderung — eine Näherung, KEIN echtes Abschlussdatum.
Beschreibung für das Modell
Section titled “Beschreibung für das Modell”Diesen Text sieht das KI-Modell — unverändert und auf Englisch, so wie ihn der Server ausliefert:
Full detail for one goal by id, within the connected organization, hydrated from the graph: its dependencies (both directions), impact assessments, and effort estimates. Returns not_found if the id is not in this organization. The optional impactPhase argument selects which IMPACTS to return — “planning” (default, the plan) or “retrospective” (what actually happened); it does NOT affect effort, which always returns both its planned and actual aggregates. Those effort aggregates are multi-estimator, each {mean, sigma, count}; mean is a 0–1 numeric on the Fibonacci effort scale (S < M < L < XL < XXL; mapping via get_guidance), not a fraction of a maximum. effort.actual.mean is the goal’s real completed effort — the Ist-Aufwand for estimating a new goal from history — while effort.planned.mean and the search_goals effort field are the estimate. Dependency and impact lists are capped independently, each with its own note; impacts are ranked by absolute weighted average, so a truncated impact list keeps the highest-impact rows. Every response carries a hydration field ({dependencies,impacts,effort} each ok | partial | unavailable) — an empty list with status ok means none are recorded, but with status unavailable it means the graph could not be read, which is NOT evidence that none exist. completedAt is null unless a completion date is recorded for this goal — which is not evidence the goal is uncompleted, since a goal in reflect or done can legitimately carry no stamp. completedAtSource says how much to trust a value that is present: “stage_change” is a transition this app observed and is exact; “change_event” is derived from a recorded stage change and may be EARLY if the goal was reopened and completed again; “updated_at” is only the record’s last-modified time, an approximation and NOT a true completion date. goal.updatedAt is the concurrency token: pass it to update_goal as expectedUpdatedAt when writing back what you read. When coaching skills are available the response also carries coaching: { skills: [{ name, mode }], hint } — the Evident Flow skills for developing a goal; use them when the user wants to work on the goal (mode “local”: get_skill, mode “server”: run_skill). Read-only.
Parameter
Section titled “Parameter”| Name | Typ | Pflicht | Einschränkungen | Beschreibung |
|---|---|---|---|---|
goalId | Text | Ja | The goal id | |
impactPhase | Text | Nein | planning | retrospective | Which impact phase to return: ‘planning’ (default, the plan) or ‘retrospective’ (what actually happened). Affects IMPACTS ONLY — effort always returns both its planned and actual aggregates. |