Deploymentcenter/public/api/bugtracker/v1/projects.php

<?php

/**
 * GET /api/bugtracker/v1/projects
 *
 * Projekt-Discovery fuer Agenten: welche Projekte gibt es, wie heissen ihre
 * Slugs, wo liegt das Repository und wie viele Items sind offen.
 *
 * SICHERHEITSAENDERUNG: verlangt jetzt ein Token mit "bugtracker:read"
 * (oder hoeher). Zuvor war die Projektliste oeffentlich abrufbar.
 */

declare(strict_types=1);

require_once __DIR__ . '/../../../../src/bootstrap.php';

use Deploymentcenter\Core\ApiAuth;
use Deploymentcenter\Core\Db;
use Deploymentcenter\Core\Http;
use Deploymentcenter\Core\ProjectLinks;
use Deploymentcenter\Modules\Bugtracker\BugRepo;

Http::beginJson(['GET', 'POST', 'OPTIONS'], true);

if (!in_array(Http::method(), ['GET', 'POST'], true)) {
    Http::fail(405, 'method_not_allowed', 'Dieser Endpunkt erwartet GET oder POST.');
}

$db = Db::init();
$context = ApiAuth::requireScope($db, Http::method() === 'POST' ? 'bugtracker:report' : 'bugtracker:read');

// ---------------------------------------------------------------------------
// POST: Beziehung des eigenen Projekts zu einem anderen festhalten.
// ---------------------------------------------------------------------------
// Ersetzt die von Hand gepflegte Zeile "Deploymentcenter-Anbindung: SDK 2.5.1"
// in jeder Projekt-CLAUDE.md. Eine Angabe, die an N Stellen nachgezogen werden
// muss, ist nach dem ersten Vergessen falsch - und zwar schweigend.
//
// from_slug kommt wie reported_from aus der Token-Bindung, nicht aus dem Body:
// ein Projekt traegt seine eigene Anbindung ein, nicht die eines anderen.
if (Http::method() === 'POST') {
    $home = ApiAuth::homeProject($context);

    if ($home === null) {
        Http::fail(
            400,
            'no_home_project',
            'Dieses Token ist an kein Projekt gebunden. Eine Beziehung braucht aber ein Projekt, '
            . 'von dem aus sie gilt.'
        );
    }

    $target = is_string(Http::input('to_slug')) ? trim((string)Http::input('to_slug')) : null;

    if ($target === null || $target === '' || $target === $home) {
        Http::fail(
            400,
            'invalid_target',
            'Das Feld "to_slug" muss ein anderes Projekt als das eigene bezeichnen.'
        );
    }

    $kind = is_string(Http::input('kind')) ? (string)Http::input('kind') : 'uses_sdk';

    if (!in_array($kind, ProjectLinks::KINDS, true)) {
        Http::fail(400, 'invalid_kind', 'Unbekannte Art der Beziehung.', null, [
            'allowed' => ProjectLinks::KINDS,
        ]);
    }

    $version = is_string(Http::input('integrated_version'))
        ? trim((string)Http::input('integrated_version'))
        : null;

    $links = new ProjectLinks($db);

    if (!$links->record($home, $target, $kind, $version !== '' ? $version : null)) {
        Http::fail(500, 'link_failed', 'Die Beziehung konnte nicht gespeichert werden.');
    }

    Http::ok([
        'from_slug'          => $home,
        'to_slug'            => $target,
        'kind'               => $kind,
        'integrated_version' => $version,
        'message'            => $version !== null
            ? sprintf('"%s" nutzt "%s" in Fassung %s.', $home, $target, $version)
            : sprintf('Beziehung "%s" -> "%s" festgehalten.', $home, $target),
    ]);
}

$repo = new BugRepo($db);
$projects = $repo->getProjects();

// Ein Laufzeit-Token sieht nur sein eigenes Projekt. Ein Werkbank-Token sieht
// alle: es soll ja gerade entscheiden koennen, wohin ein Fehler gehoert - und
// dafuer muss es die Nachbarn kennen.
$bound = ApiAuth::projectFilter($context, true);
if ($bound !== null) {
    $projects = array_values(array_filter(
        $projects,
        static fn(array $p): bool => (string)$p['slug'] === $bound
    ));
}

// Das Heimatprojekt bleibt auch beim Werkbank-Token bekannt. Es ist der
// Bezugspunkt, gegen den die Beziehungen ausgewiesen werden.
$home  = ApiAuth::homeProject($context);
$links = new ProjectLinks($db);

Http::ok([
    'count'        => count($projects),
    'home_project' => $home,
    'projects'     => array_map(static function (array $p) use ($links, $home): array {
        $slug = (string)$p['slug'];

        return [
            'id'             => (int)$p['id'],
            'slug'           => $slug,
            'name'           => (string)$p['name'],
            'notes'          => $p['notes'] ?? null,
            'repo_url'       => $p['repo_url'] ?? null,
            'default_agent'  => $p['default_agent'] ?? null,
            'open_items'     => (int)($p['open_items'] ?? 0),
            'critical_items' => (int)($p['critical_items'] ?? 0),

            // Wie haengt dieses Projekt mit dem eigenen zusammen? null heisst
            // schlicht "gar nicht" und ist der Normalfall.
            'relation'       => $home !== null ? $links->between($home, $slug) : null,
        ];
    }, $projects),
]);