fix(2.8.1): Sechs Befunde, eine Bauart - die Voreinstellung, die einsprang

Drei Agenten haben von aussen gemeldet, und fast jeder Befund hat dieselbe
Form: Irgendwo sprang ein Vorgabewert ein, obwohl die richtige Antwort
bekannt war - meist das Projekt, an das der Aufrufer ohnehin gebunden ist.

#351  manage?action=next antwortete durchgaengig mit HTTP 500. In
      BugRepo::buildFilter() stand :project_scope zweimal in derselben
      Anweisung; mit ATTR_EMULATE_PREPARES=false bindet PDO jeden Namen
      genau einmal - zwei Marker, ein Wert, SQLSTATE[HY093]. Getroffen war
      nur "next", weil nur dort der Rueckkanal-Filter gesetzt wird. Damit
      gab es keine exklusive Uebernahme. Es ist der VIERTE Fall dieser
      Bauart, deshalb prueft scripts/pruefe_platzhalter.py das jetzt
      mechanisch vor jedem Ausliefern.

#382  Meldungen ohne project_slug landeten im Scheinprojekt "default" -
#387  ohne dc_projects-Zeile, also project_id NULL. Die Antwort sah wie ein
#397  Erfolg aus, und danach sperrte dieselbe Token-Bindung den Zugriff
      (403 project_forbidden). Der Rueckfall aufs Heimatprojekt war an
      !isWorkbench gebunden; ein Werkbank-Token ohne Slug bekam gar keinen
      Vorgabewert. Jetzt: genannter Slug, sonst Heimatprojekt, sonst 400.
      Ein unbekanntes Projekt wird abgewiesen statt still angelegt.

#364  Ohne project_slug lieferten list, stats und die Roadmap ALLE
#176  Projekte statt des eigenen, weil die Vorgabe auf "all" stand und ein
      Werkbank-Token beim Lesen absichtlich nicht unter die Schranke faellt.
      Gemessen: 393 Items, davon 28 eigene. Ausgerechnet der erste Aufruf
      jeder Sitzung. Die Roadmap antwortet ausserdem schmal - 55 Felder je
      Eintrag waren 628.392 Zeichen und fuellten das Kontextfenster.

#404  Watchdog-Monitore bekamen nie ein Projekt: upsertHeartbeat() wurde
      keines uebergeben, obwohl authorizeSource() die Token-Bindung liest.
      Befunde erbten dadurch "default" - dc_findings(project_slug=...) war
      fuer eine laufende, meldende Instanz leer.

#131  Wo der Leseweg richtig verengte, sagte er es nicht: HTTP 200 mit dem
      umgeschriebenen Filter sieht aus wie eine Auskunft ueber das
      angefragte Projekt. Ein Agent, der vor dem Melden dc_search fragt,
      legt so das Duplikat an. Jetzt scoped_to und scope_note im Umschlag -
      nur bei tatsaechlicher Verengung.

#354  dc-testkit 1.1.0 wurde zweimal mit verschiedenem Inhalt ausgeliefert
      (1898 und 1930 Zeilen), 1.0.0 davor ebenso. Der Absatz ueber
      DC_TESTKIT_VERSION stand die ganze Zeit im Skript und hat nicht
      getragen. Jetzt 1.1.1 plus ein Riegel in deploy.py, der abbricht,
      wenn sich der Inhalt aendert und die Nummer nicht.

Warum die Testsuite all das nicht sah: Ihr Master-Token ist an kein Projekt
gebunden und nimmt deshalb ueberall den anderen Zweig. Es gab sogar einen
Testfall fuer action=next - er lief gruen, waehrend der Aufruf in der Praxis
ausnahmslos scheiterte. Die neuen Faelle benutzen ausdruecklich
projektgebundene Token; testctl kann dafuer jetzt owner_type und scopes
waehlen.

Ausserdem: Die Agentenvorlage nennt fuer die SDK-Fassung dc_link_project
statt einer abgeschriebenen Zahl - "SDK 2.5.1" stand dort als Beispiel und
wurde als Wert uebernommen.

Nicht enthalten: die 20 Altlasten in "default". Sie sind ueber die API nicht
erreichbar; sql/wartung/2026-08-31_default-projekt-aufraeumen.sql liegt dafuer
bereit (alle 20 haben einen titelgleichen Zwilling im richtigen Projekt).

156 e2e-Faelle gruen, davon 9 neue.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
2026-08-31 20:43:23 +02:00
co-authored by Claude Opus 5
parent 8274a6c0ac
commit 0e93345ab8
20 changed files with 1394 additions and 56 deletions
+49 -8
View File
@@ -105,6 +105,11 @@ $author = $context['actor'];
// muss die Landschaft sehen.
$boundProject = ApiAuth::projectFilter($context);
$readProject = ApiAuth::projectFilter($context, true);
$homeProject = ApiAuth::homeProject($context);
// Was der Aufrufer ANGEFRAGT hat - unabhaengig davon, was er bekommt.
// Gebraucht fuer den Hinweis auf eine Verengung, siehe verengungsHinweis().
$angefragtesProjekt = Http::str('project_slug') ?? Http::str('project');
$itemId = resolveItemId();
@@ -120,8 +125,16 @@ switch ($action) {
// "Http::str('project_slug') ?? $boundProject" - damit konnte ein an
// Projekt X gebundenes Token die Zahlen jedes anderen Projekts abrufen,
// indem es den Slug einfach mitschickte.
$slug = $readProject ?? Http::str('project_slug');
Http::ok(['stats' => $repo->getStats($slug)]);
//
// Die Vorgabe ohne Angabe ist das Heimatprojekt, nicht "alle": Ein
// Werkbank-Token faellt beim Lesen nicht unter $readProject, bekam
// also die Zahlen aller Projekte in einem Topf - dieselbe stille
// Verwechslung wie bei list und roadmap.
$slug = $readProject ?? Http::str('project_slug') ?? $homeProject;
Http::ok(array_merge(
['stats' => $repo->getStats($slug)],
ApiAuth::scopeNotice($angefragtesProjekt, (string)$slug)
));
case 'get':
requireItemId($itemId);
@@ -133,9 +146,9 @@ switch ($action) {
Http::ok(['item' => $item]);
case 'list':
$filters = collectFilters($readProject);
$filters = collectFilters($readProject, $homeProject);
$result = $repo->getItems($filters);
Http::ok([
Http::ok(array_merge([
'count' => count($result['items']),
'total' => $result['total'],
'limit' => $result['limit'],
@@ -143,7 +156,7 @@ switch ($action) {
'has_more' => $result['has_more'],
'filters' => $filters,
'items' => $result['items'],
]);
], ApiAuth::scopeNotice($angefragtesProjekt, (string)$filters['project_slug'])));
// -------------------------------------------------------------- schreiben
case 'claim':
@@ -160,7 +173,7 @@ switch ($action) {
Http::ok(['item' => $claimed, 'message' => sprintf('Item #%d uebernommen.', $itemId)]);
case 'next':
$filters = collectFilters($boundProject);
$filters = collectFilters($boundProject, ApiAuth::homeProject($context));
// Der Rueckkanal: zusaetzlich zu den eigenen Items auch fremde, die auf
// Nachpruefung warten und bei denen dieses Projekt als betroffen
@@ -440,12 +453,34 @@ function assertProject(
/**
* Sammelt Filter aus Query und Body.
*
* @param ?string $boundProject Zwang: aus dieser Bindung kommt das Token nicht heraus.
* @param ?string $homeProject Vorgabe: wo der Aufrufer zuhause ist.
* @return array<string,mixed>
*/
function collectFilters(?string $boundProject): array
function collectFilters(?string $boundProject, ?string $homeProject = null): array
{
// WELCHES PROJEKT, WENN KEINES GENANNT IST?
//
// Hier stand schlicht 'all'. Das klingt harmlos und war es nicht: Ein
// Werkbank-Token IST an ein Projekt gebunden, faellt beim Lesen aber
// absichtlich nicht unter die Schranke - es soll die Landschaft sehen
// duerfen (siehe $readProject weiter oben). Damit war $boundProject null,
// die Vorgabe griff, und der Agent bekam die Items aller Projekte.
//
// Ausgerechnet am Sitzungsanfang: CLAUDE.md macht dc_roadmap zum ersten
// Aufruf. Der Agent sah einen fremden Backlog - den er nach derselben
// Regel nicht bearbeiten darf. Die Werkzeugbeschreibung sagte dazu das
// Gegenteil ("Ohne project_slug das eigene Projekt"), was den Widerspruch
// lange verdeckt hat.
//
// Jetzt gilt: ein ausdruecklich genannter Slug, sonst das Heimatprojekt,
// und erst ohne beides "alle". Wer die Landschaft sehen will, schickt
// weiterhin project_slug=all - nur ist das jetzt eine Entscheidung statt
// eines Nebeneffekts.
$angefragt = Http::str('project_slug') ?? Http::str('project');
$filters = [
'project_slug' => Http::str('project_slug') ?? Http::str('project') ?? 'all',
'project_slug' => $angefragt ?? $homeProject ?? 'all',
'environment' => Http::str('environment') ?? Http::str('env') ?? 'all',
'type' => Http::str('type') ?? 'all',
'status' => Http::str('status') ?? 'all',
@@ -458,6 +493,12 @@ function collectFilters(?string $boundProject): array
'order' => Http::str('order') ?? 'newest',
'limit' => Http::int('limit', 100),
'offset' => Http::int('offset', 0),
// Hier bleibt der volle Datensatz die Vorgabe: Wer sucht, will die
// Fundstelle sehen, nicht nur ihren Titel. fields=compact schneidet
// auf die Uebersichtsfelder zurueck - dieselbe Auswahl, die die
// Roadmap standardmaessig liefert (BugRepo::COMPACT_FIELDS).
'fields' => Http::str('fields') === 'compact' ? 'compact' : 'full',
];
if (Http::input('unclaimed_only') !== null) {