feat: public projects, project deletion and sagas

Public projects:
- Project.isPublic (create/update, owners and admins). Anyone can read a
  public project without a token: project, board, tickets, comments,
  history, releases, activity, tracking and statistics, over GraphQL and
  REST. Writes stay for members (401 anonymous, 403 outsiders).
- @OptionalAuth() / @ApiOptionalPireonAuth(): anonymous callers allowed,
  invalid tokens still rejected. ReadAccess lets anonymous viewers read
  public projects only; linked tickets are filtered by visibility.
- publicProjects (GraphQL) and GET /api/explore/projects (REST).
- Web: «Explorar» page, project pages open without a session (read-only
  notice, sign-in hints), public badge, visibility switch in settings,
  no realtime subscriptions without a session.

Project deletion:
- Owner only, confirming the key (deleteProject / DELETE
  /api/projects/{project}?confirm=KEY). The key is freed; the read model
  drops the project and members are notified (web goes home).

Sagas (run by the EventsBridge after projections, durable and ordered):
- ProjectDeletionSaga: project deleted → delete its tickets and releases;
  ticket deleted → purge its comments and drop links from other tickets.
- ReleaseArchivedSaga: unfinished tickets leave an archived release.
- UserDeactivatedSaga: the Pireon webhook records UserDeactivatedEvent in
  the event store (EventRecorder); the tracker unassigns that user's open
  tickets as the system actor.
- Internal idempotent commands; domain refusals are logged and skipped,
  concurrency conflicts retried. Affected streams come from the event store
  (TrackerStreamsRepository).

Tests: domain lifecycle specs, saga specs run like the bridge, facade
tests, e2e for public access, cascade deletion, archived releases and
deactivation webhook. Docs, READMEs, schema.gql/openapi.json and Word/PDF
updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

libs/web/tracker/infrastructure/src/lib/adapters/graphql-projects.gateway.ts

@@ -8,17 +8,21 @@ import {
   ProjectSettings,
   ProjectsGateway,
   ProjectStats,
+  UpdateProjectInput,
 } from '@task-stream/web/tracker/domain';
 import { map, Observable } from 'rxjs';
 import {
   AddProjectMemberDocument,
   ChangeProjectMemberRoleDocument,
   CreateProjectDocument,
+  DeleteProjectDocument,
   MyProjectsDocument,
   ProjectAnalyticsDocument,
   ProjectDocument,
   ProjectStatsDocument,
+  PublicProjectsDocument,
   RemoveProjectMemberDocument,
+  UpdateProjectDocument,
   UpdateProjectSettingsDocument,
 } from '../graphql/generated';
 import { GraphqlOperations } from './graphql-operations';
@@ -39,6 +43,12 @@ export class GraphqlProjectsGateway extends ProjectsGateway {
       .pipe(map((d) => d.myProjects.map(toProject)));
   }
 
+  publicProjects(): Observable<Project[]> {
+    return this.gql
+      .query(PublicProjectsDocument)
+      .pipe(map((d) => d.publicProjects.map(toProject)));
+  }
+
   project(idOrKey: string): Observable<Project> {
     return this.gql
       .query(ProjectDocument, { idOrKey })
@@ -75,6 +85,18 @@ export class GraphqlProjectsGateway extends ProjectsGateway {
       .pipe(map((d) => toCommandResult(d.createProject)));
   }
 
+  update(input: UpdateProjectInput): Observable<CommandResult> {
+    return this.gql
+      .mutate(UpdateProjectDocument, { input })
+      .pipe(map((d) => toCommandResult(d.updateProject)));
+  }
+
+  delete(projectId: string, confirmKey: string): Observable<CommandResult> {
+    return this.gql
+      .mutate(DeleteProjectDocument, { projectId, confirmKey })
+      .pipe(map((d) => toCommandResult(d.deleteProject)));
+  }
+
   addMember(input: MemberInput): Observable<CommandResult> {
     return this.gql
       .mutate(AddProjectMemberDocument, { input: input as never })

libs/web/tracker/infrastructure/src/lib/adapters/graphql-realtime.gateway.ts

@@ -1,13 +1,14 @@
 import { inject, Injectable } from '@angular/core';
+import { AccessTokenSource } from '@task-stream/web/shared/infrastructure';
 import {
   Activity,
   CommentChanged,
   IssueChanged,
-  Project,
+  ProjectChanged,
   Release,
   TrackerRealtimeGateway,
 } from '@task-stream/web/tracker/domain';
-import { map, Observable } from 'rxjs';
+import { defer, EMPTY, map, Observable, switchMap } from 'rxjs';
 import {
   ActivityAddedDocument,
   CommentChangedDocument,
@@ -25,53 +26,84 @@ import {
   toRelease,
 } from './mappers';
 
-/** GraphQL subscriptions (graphql-ws). Each stream lives while it is subscribed. */
+/**
+ * GraphQL subscriptions (graphql-ws). Each stream lives while it is
+ * subscribed. The API only accepts signed-in sockets, so anonymous visitors
+ * of public projects get no live updates (instead of a socket retrying forever).
+ */
 @Injectable()
 export class GraphqlRealtimeGateway extends TrackerRealtimeGateway {
   private readonly gql = inject(GraphqlOperations);
+  private readonly tokens = inject(AccessTokenSource);
+
+  private signedIn<T>(stream: () => Observable<T>): Observable<T> {
+    return defer(() => this.tokens.accessToken()).pipe(
+      switchMap((token) => (token ? stream() : EMPTY)),
+    );
+  }
 
   issueChanges(projectId: string): Observable<IssueChanged> {
-    return this.gql.subscribe(IssueChangedDocument, { projectId }).pipe(
-      map(({ issueChanged }) => ({
-        ...issueChanged,
-        issue: toIssueSummary(issueChanged.issue),
-      })),
+    return this.signedIn(() =>
+      this.gql.subscribe(IssueChangedDocument, { projectId }).pipe(
+        map(({ issueChanged }) => ({
+          ...issueChanged,
+          issue: toIssueSummary(issueChanged.issue),
+        })),
+      ),
     );
   }
 
   commentChanges(issueId: string): Observable<CommentChanged> {
-    return this.gql.subscribe(CommentChangedDocument, { issueId }).pipe(
-      map(({ commentChanged }) => ({
-        action: commentChanged.action,
-        commentId: commentChanged.commentId,
-        comment: commentChanged.comment
-          ? toComment(commentChanged.comment)
-          : null,
-      })),
+    return this.signedIn(() =>
+      this.gql.subscribe(CommentChangedDocument, { issueId }).pipe(
+        map(({ commentChanged }) => ({
+          action: commentChanged.action,
+          commentId: commentChanged.commentId,
+          comment: commentChanged.comment
+            ? toComment(commentChanged.comment)
+            : null,
+        })),
+      ),
     );
   }
 
   activity(projectId: string): Observable<Activity> {
-    return this.gql
-      .subscribe(ActivityAddedDocument, { projectId })
-      .pipe(map((d) => toActivity(d.activityAdded)));
+    return this.signedIn(() =>
+      this.gql
+        .subscribe(ActivityAddedDocument, { projectId })
+        .pipe(map((d) => toActivity(d.activityAdded))),
+    );
   }
 
   releaseChanges(projectId: string): Observable<Release> {
-    return this.gql
-      .subscribe(ReleaseChangedDocument, { projectId })
-      .pipe(map((d) => toRelease(d.releaseChanged.release)));
+    return this.signedIn(() =>
+      this.gql
+        .subscribe(ReleaseChangedDocument, { projectId })
+        .pipe(map((d) => toRelease(d.releaseChanged.release))),
+    );
   }
 
-  projectChanges(projectId: string): Observable<Project> {
-    return this.gql
-      .subscribe(ProjectChangedDocument, { projectId })
-      .pipe(map((d) => toProject(d.projectChanged.project)));
+  projectChanges(projectId: string): Observable<ProjectChanged> {
+    return this.signedIn(() =>
+      this.gql
+        .subscribe(ProjectChangedDocument, { projectId })
+        .pipe(map((d) => toProjectChanged(d.projectChanged))),
+    );
   }
 
-  myProjectsChanges(): Observable<Project> {
-    return this.gql
-      .subscribe(MyProjectsChangedDocument)
-      .pipe(map((d) => toProject(d.myProjectsChanged.project)));
+  myProjectsChanges(): Observable<ProjectChanged> {
+    return this.signedIn(() =>
+      this.gql
+        .subscribe(MyProjectsChangedDocument)
+        .pipe(map((d) => toProjectChanged(d.myProjectsChanged))),
+    );
   }
 }
+
+const toProjectChanged = (change: {
+  action: string;
+  project: Parameters<typeof toProject>[0];
+}): ProjectChanged => ({
+  project: toProject(change.project),
+  deleted: change.action === 'ProjectDeletedEvent',
+});