plan.issues

Jeden záznam na úkol s odvozeným stavem, vlnou, deklarovanými závislostmi, těmi, které nejsou DONE (plus `milestone:<id>`, když kontrola zadržuje celý výsledek), úkoly, které na něm závisejí, cestami, kterých se dotýká, a součtem důkazů. Filtrování podle `status: READY` dává připravenou množinu a podle `status: BLOCKED` blokovanou množinu; nic z toho není samostatná derivace.

query
behaviorally_verified
modul plan
#plan
#project
#issues

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_plan_issues
HTTP	GET /api/v1/plan/issues operationId plan.issues
příkazová řádka	—

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 · PlanIssueFilter

Kterými úkoly odpovědět.

vlastnost	typ	povinné	popis
milestone	string \| null	ne	Jen úkoly tohoto milníku. Výchozí: každý úkol plánu.
status	string \| null	ne	Jen úkoly v tomto odvozeném statusu — `READY` pro množinu připravených, `BLOCKED` pro množinu blokovaných. Slovník putuje s každou odpovědí, takže volající nikdy nemusí vědět, jaké statusy existují.
vlna	integer \| null	ne	Jen úkoly v této vlně provádění.

JSON Schema

{
  "additionalProperties": false,
  "description": "Which issues to answer with.",
  "properties": {
    "milestone": {
      "description": "Only issues of this milestone. Default: every issue of the plan.",
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "description": "Only issues in this derived status — `READY` for the ready set, `BLOCKED` for the\nblocked set. The vocabulary travels with every answer, so a caller never has to know\nwhich statuses exist.",
      "type": [
        "string",
        "null"
      ]
    },
    "wave": {
      "description": "Only issues in this execution wave.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "title": "PlanIssueFilter",
  "type": "object"
}

output · PlanIssueList

Úkoly odpovídající filtru se slovníkem, který pojmenovává jejich stavy.

vlastnost	typ	povinné	popis
úkoly	array	ano	Odpovídající úkoly v pořadí podle id.
stavy	reference	ano	Deklarované slovníky stavů.
celkem	integer	ano	Kolik se jich shodovalo.

JSON Schema

{
  "$defs": {
    "PlanIssue": {
      "description": "One issue, as its record declares it and as the graph derives it.",
      "properties": {
        "blocked_by": {
          "description": "The dependencies that are not DONE, plus `milestone:<id>` when the milestone gate\nholds the whole outcome back.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "completed_at": {
          "description": "When completion was recorded.",
          "type": "string"
        },
        "dependents": {
          "description": "The issues that depend on this one.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "depends_on": {
          "description": "Every issue it declares a dependency on, as declared — including one that does not\nexist, which is a finding rather than a silent omission.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "evidence_have": {
          "description": "Evidence entries attached.",
          "format": "uint32",
          "minimum": 0,
          "type": "integer"
        },
        "evidence_need": {
          "description": "Evidence tokens the record requires before it may be DONE.",
          "format": "uint32",
          "minimum": 0,
          "type": "integer"
        },
        "id": {
          "description": "The identity, which is also the file name.",
          "type": "string"
        },
        "milestone": {
          "description": "The milestone it belongs to.",
          "type": "string"
        },
        "objective": {
          "description": "One line: what the issue is for.",
          "type": "string"
        },
        "parallel_safe": {
          "description": "Whether it may run beside another issue of its wave.",
          "type": "boolean"
        },
        "priority": {
          "description": "`p0` … `p3`.",
          "type": "string"
        },
        "profile": {
          "description": "The execution profile the issue is worked under.",
          "type": "string"
        },
        "scope": {
          "description": "The paths it touches; two issues of one wave that share a path are serialised.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "serves": {
          "description": "The intent criteria it exists to make true, each `<intent>#<criterion>`, as declared.\nEmpty for maintenance work under a milestone no intent names; whether a named\ncriterion exists is the intent coverage's question, not the plan's.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "slug": {
          "description": "The slug, when the record carries one.",
          "type": "string"
        },
        "started_at": {
          "description": "When execution began, when it did.",
          "type": "string"
        },
        "status": {
          "description": "The derived status. Never stored: an issue records what happened to it and the\nstatus follows from that and from the state of its dependencies.",
          "type": "string"
        },
        "title": {
          "description": "One line naming the outcome.",
          "type": "string"
        },
        "verified_at": {
          "description": "When implementation was declared complete.",
          "type": "string"
        },
        "wave": {
          "description": "The execution wave: one past the longest path to it through the dependency graph.",
          "format": "uint32",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "id",
        "milestone",
        "status",
        "wave",
        "priority",
        "profile",
        "parallel_safe",
        "title",
        "slug",
        "depends_on",
        "blocked_by",
        "dependents",
        "scope",
        "serves",
        "objective",
        "evidence_have",
        "evidence_need",
        "started_at",
        "verified_at",
        "completed_at"
      ],
      "type": "object"
    },
    "PlanVocabulary": {
      "description": "The status vocabularies, so a reader never has to know which statuses exist.",
      "properties": {
        "issue": {
          "description": "The issue statuses, in derivation order.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "milestone": {
          "description": "The milestone statuses, in derivation order.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "issue",
        "milestone"
      ],
      "type": "object"
    }
  },
  "description": "Issues matching a filter, with the vocabulary that names their statuses.",
  "properties": {
    "issues": {
      "description": "The matching issues, in id order.",
      "items": {
        "$ref": "#/$defs/PlanIssue"
      },
      "type": "array"
    },
    "statuses": {
      "$ref": "#/$defs/PlanVocabulary",
      "description": "The declared status vocabularies."
    },
    "total": {
      "description": "How many matched.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "issues",
    "total",
    "statuses"
  ],
  "title": "PlanIssueList",
  "type": "object"
}

Politiky

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

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	3	vše studený+teplý připraveno studený+teplý one-milestone studený+teplý
mcp	pokryto	3	vše studený+teplý připraveno studený+teplý one-milestone studený+teplý
http	pokryto	3	vše studený+teplý připraveno studený+teplý one-milestone studený+teplý