why.moment

Jeden provozní moment celý: jak vypadá, proč nastává, kolik stojí, co s tím tento nástroj dělá a každá relace odvozená z jeho metadat — odpovědnosti, k nimž patří jeho tvrzení, momenty, které jej jmenují, a momenty jemu nejbližší podle sdílené oblasti, publika a štítku.

query
behaviorally_verified
module why
#why

Zpřístupnění

Kde je tato jedna definice dosažitelná. Absence je explicitní: povrch, který není uveden, ji nenese.

povrch	jako
MCP	nástroj majordomus_why_moment
HTTP	GET /api/v1/why/moment operationId why.moment
příkazová řádka	majordomus why show

Schémata

Kanonický vstup a výstup z typů Rustu; schéma nástroje MCP a parametry a odpovědi OpenAPI se odvozují z nich.

vstup · MomentInput

Který okamžik číst.

vlastnost	typ	povinné	popis
id	string	ano	Id okamžiku tak, jak ho uvádí `why.list`. Je to také jeho slug a jeho trasa.

JSON Schema

{
  "additionalProperties": false,
  "description": "Which moment to read.",
  "properties": {
    "id": {
      "description": "The moment's id, as `why.list` gives it. This is also its slug and its route.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "MomentInput",
  "type": "object"
}

output · MomentDetail

Jeden okamžik celý, se vším odvozeným, co stránka ukazuje a žádný soubor neuvádí.

vlastnost	typ	povinné	popis
aliasy	array	ne	Další slova, která by čtenář mohl hledat. default []
areas	array	ano	Provozní oblasti, do kterých spadá.
audiences	array	ano	Publikum, které ho poznává.
zpětné odkazy	array	ano	Odvozeno: momenty, které tento pojmenovávají ve svém `related`.
tělo	string	ne	Tělo v Markdownu, bez front matter.
capabilities	array	ne	Id schopností spustitelného souboru, které na to odpovídají. výchozí []
tvrzení	array	ne	Tvrzení, která říkají, co je zde zaručeno. výchozí []
commands	array	ne	Příkazy nástroje, které na to odpovídají. výchozí []
doktríny	array	ne	Pravidla účinné sady, která jej řídí. výchozí []
příklady	array	ano	Konkrétní situace.
zvýrazněné	boolean	ne	Zda to domovská stránka ukazuje. výchozí false
četnost	string	ano	`rare`, `occasional`, `common` nebo `constant`.
hook	string	ano	Řádek v první osobě, který index ukazuje.
id	string	ano	Identita, slug a název souboru.
životní cyklus	array	ne	Fáze práce, ve kterých se objevuje. výchozí []
sousedé	array	ano	Odvozeno: co by měl čtenář vidět příště, v jednom seznamu a ve stanoveném pořadí — co tento okamžik jmenuje, pak co jmenuje jeho, pak co je nejblíž podle sdílených metadat, každé jednou. Tři seznamy výše jsou tytéž vztahy držené odděleně pro čtenáře, který chce vědět, co je které.
související	array	ne	Okamžiky s tímto výslovně související. Opačný směr je odvozen. výchozí []
related_detail	array	ano	Odvozeno: explicitně související okamžiky, shrnuté tak, aby stránka potřebovala jedno volání.
odpovědnosti	array	ano	Odvozeno: odpovědnosti, do nichž patří tvrzení, která jmenuje.
route	string	ne	Odvozeno: `/why/<id>/`. Nikdy se nepíše ručně; schéma odmítne klíč `route`. výchozí ""
závažnost	string	ano	`low`, `medium` nebo `high`.
short_title	string \| null	ne	Dvě nebo tři slova pro úzký sloupec, když je záznam nese.
signály	array	ano	Pozorovatelné příznaky.
podobné	array	ano	Odvozeno: okamžiky sdílející s tímto oblast nebo publikum, které on sám nejmenuje, nejbližší první — nejvíc sdílených metadat, pak pořadí prezentace.
zdroj	string	ne	Odvozeno: soubor relativní k repozitáři, z něhož záznam pochází. výchozí ""
status	string	ano	`stable`, `draft` nebo `deprecated`.
summary	string	ano	Jeden řádek: co je skutečně špatně.
štítky	array	ne	Volné štítky. výchozí []
název	string	ano	Okamžik jako nadpis.
use_cases	array	ne	Případy užití, které ukazují cestu ven. výchozí []
váha	integer	ne	Pořadí prezentace, nejnižší první. výchozí 0

JSON Schema

{
  "$defs": {
    "Example": {
      "description": "One concrete situation, in one audience, with what happens today and what happens\ninstead.",
      "properties": {
        "after": {
          "description": "What happens with it.",
          "type": "string"
        },
        "audience": {
          "description": "The audience this situation belongs to; must name an audience of the catalogue.",
          "type": "string"
        },
        "before": {
          "description": "What happens without the tool.",
          "type": "string"
        },
        "id": {
          "description": "Unique within the moment.",
          "type": "string"
        },
        "title": {
          "description": "One line naming the situation.",
          "type": "string"
        }
      },
      "required": [
        "id",
        "audience",
        "title",
        "before",
        "after"
      ],
      "type": "object"
    },
    "MomentSummary": {
      "description": "One moment as a listing shows it: everything a card needs and nothing a page needs.",
      "properties": {
        "areas": {
          "description": "The operational areas it falls under.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "audiences": {
          "description": "The audiences that recognise it.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "examples": {
          "description": "How many concrete situations it carries.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "featured": {
          "description": "Whether the homepage shows it.",
          "type": "boolean"
        },
        "frequency": {
          "description": "`rare`, `occasional`, `common` or `constant`.",
          "type": "string"
        },
        "hook": {
          "description": "The first-person line an index shows.",
          "type": "string"
        },
        "id": {
          "description": "The identity and the slug.",
          "type": "string"
        },
        "label": {
          "description": "The name a narrow column shows: the short title, or the title.",
          "type": "string"
        },
        "route": {
          "description": "Derived: `/why/<id>/`.",
          "type": "string"
        },
        "severity": {
          "description": "`low`, `medium` or `high`.",
          "type": "string"
        },
        "signals": {
          "description": "How many observable symptoms it declares.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "status": {
          "description": "`stable`, `draft` or `deprecated`.",
          "type": "string"
        },
        "summary": {
          "description": "One line: what is actually wrong.",
          "type": "string"
        },
        "tags": {
          "description": "Free tags.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "title": {
          "description": "The moment as a heading.",
          "type": "string"
        },
        "weight": {
          "description": "Presentation order.",
          "format": "uint32",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "id",
        "title",
        "label",
        "hook",
        "summary",
        "status",
        "severity",
        "frequency",
        "weight",
        "featured",
        "audiences",
        "areas",
        "tags",
        "route",
        "signals",
        "examples"
      ],
      "type": "object"
    },
    "Signal": {
      "description": "One observable symptom of a moment: a question a reader can answer about their own\nweek. The questionnaire on the site and the input of `why diagnose` are these and\nnothing else.",
      "properties": {
        "id": {
          "description": "Unique within the moment; the identity a diagnosis selects by.",
          "type": "string"
        },
        "text": {
          "description": "The symptom, phrased so a reader can say whether it happened to them.",
          "type": "string"
        }
      },
      "required": [
        "id",
        "text"
      ],
      "type": "object"
    }
  },
  "description": "One moment in full, with everything derived that a page shows and no file states.",
  "properties": {
    "aliases": {
      "default": [],
      "description": "Other words a reader might search for.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "areas": {
      "description": "The operational areas it falls under.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "audiences": {
      "description": "The audiences that recognise it.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "backlinks": {
      "description": "Derived: the moments that name this one in their `related`.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "body": {
      "description": "The Markdown body, without its front matter.",
      "type": "string"
    },
    "capabilities": {
      "default": [],
      "description": "Capability ids of the executable that answer it.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "claims": {
      "default": [],
      "description": "Claims that say what is guaranteed here.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "commands": {
      "default": [],
      "description": "Commands of the tool that answer it.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "doctrines": {
      "default": [],
      "description": "Rules of the effective set that govern it.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "examples": {
      "description": "The concrete situations.",
      "items": {
        "$ref": "#/$defs/Example"
      },
      "type": "array"
    },
    "featured": {
      "default": false,
      "description": "Whether the homepage shows it.",
      "type": "boolean"
    },
    "frequency": {
      "description": "`rare`, `occasional`, `common` or `constant`.",
      "type": "string"
    },
    "hook": {
      "description": "The first-person line an index shows.",
      "type": "string"
    },
    "id": {
      "description": "The identity, the slug and the file name.",
      "type": "string"
    },
    "lifecycle": {
      "default": [],
      "description": "The stages of work at which it shows up.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "neighbours": {
      "description": "Derived: what a reader should see next, in one list and in a stated order — what\nthis moment names, then what names it, then what is nearest by shared metadata,\neach appearing once. The three lists above are the same relations kept apart for a\nreader that wants to know which is which.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "related": {
      "default": [],
      "description": "Moments explicitly related to this one. The reverse is derived.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "related_detail": {
      "description": "Derived: the explicitly related moments, summarised so a page needs one call.",
      "items": {
        "$ref": "#/$defs/MomentSummary"
      },
      "type": "array"
    },
    "responsibilities": {
      "description": "Derived: the responsibilities the claims it names belong to.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "route": {
      "default": "",
      "description": "Derived: `/why/<id>/`. Never authored; the schema refuses a `route` key.",
      "type": "string"
    },
    "severity": {
      "description": "`low`, `medium` or `high`.",
      "type": "string"
    },
    "short_title": {
      "description": "Two or three words for a narrow column, when the record carries one.",
      "type": [
        "string",
        "null"
      ]
    },
    "signals": {
      "description": "The observable symptoms.",
      "items": {
        "$ref": "#/$defs/Signal"
      },
      "type": "array"
    },
    "similar": {
      "description": "Derived: moments sharing an area or an audience with this one and not already\nnamed by it, nearest first — most shared metadata, then presentation order.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source": {
      "default": "",
      "description": "Derived: the repository-relative file the record came from.",
      "type": "string"
    },
    "status": {
      "description": "`stable`, `draft` or `deprecated`.",
      "type": "string"
    },
    "summary": {
      "description": "One line: what is actually wrong.",
      "type": "string"
    },
    "tags": {
      "default": [],
      "description": "Free tags.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "title": {
      "description": "The moment as a heading.",
      "type": "string"
    },
    "use_cases": {
      "default": [],
      "description": "Use cases that show the way out.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "weight": {
      "default": 0,
      "description": "Presentation order, lowest first.",
      "format": "uint32",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "id",
    "title",
    "hook",
    "summary",
    "status",
    "severity",
    "frequency",
    "audiences",
    "areas",
    "signals",
    "examples",
    "responsibilities",
    "backlinks",
    "similar",
    "related_detail",
    "neighbours"
  ],
  "title": "MomentDetail",
  "type": "object"
}

Politiky

benchmark: povinné — cíl na každém transportu, který expozice deklaruje; případy jsou ty ze vstupního typu
cache: process: až 64 záznamů v procesu, vymezených otiskem registru

Cíle benchmarku

Odvozeno z registru pro tento repozitář: jeden požadavek na transport a případy, které poskytuje typ vstupu. Celá matice je na stránce měření výkonu.

transport	state	případy	targets
direct	pokryto	1	first-moment studený+teplý
mcp	pokryto	1	first-moment studený+teplý
http	pokryto	1	first-moment studený+teplý