Sigroom Docs

Sigroom Functionality Inventory

Sigroom is the secure collaboration control plane for workspaces, rooms, HACP harnesses, project execution, review, provenance, release trust, and operational security.

referenceDevelopers, operators, and product reviewersVerified 2026-07-09

Product Surfaces

SurfaceImplemented Capability
apps/webNext.js product UI for public pages, auth, overview, profile, settings, workspaces, rooms, participants, review, artifacts, downloads, projects, project IDE, file scope, project security, release trust, revocation, package security, audit, enrollment, harnesses, devices, and admin security.
apps/apiFastify API that registers identity, OAuth, profile, workspaces, invites, projects, repository import, IDE sessions, file-scope policy, vulnerability scans, package security, loop work, enrollment, release trust, downloads, rooms, events, artifacts, review, revocation, audit, HACP inference, HACP observability, and admin security routes.
apps/gatewayHACP gateway service for health/readiness, metrics, client certificates, session handshakes, room routing, launcher bridge traffic, run control, DPoP fallback, and session registry state.
apps/workerBackground worker for artifact scan pipelines, package security scans and schedules, OAuth cleanup, project test runs, loop scheduling, loop run starts, package security container execution, and HACP patch application.
Harness work queueNew API and launcher contract that exposes project tasks and loop workitems as one queue for GeneSYS/HACP operators, with task selection, updates, completion, test requests, test-all, sandbox open/status/stop, task links, and audit records.
apps/hacp-consoleVite console surface for HACP runtime-oriented review and control workflows.
apps/docsStatic Next.js developer documentation registry and article renderer.
packagesShared contracts, crypto, database, observability, policy, reference harness, release trust, and object storage libraries.

Identity, Workspaces, And Membership

  • WebAuthn registration and login, session lookup, logout, profile summary, OAuth account linking/unlinking, and production auth gates.
  • Workspace create/list/detail flows with role-aware membership and platform-admin checks.
  • Workspace invites with create, list, incoming invite, accept, decline, and revoke flows.
  • Profile aggregation for visible workspaces, devices, and harnesses.
  • Workspace-scoped downloads exposed both globally and under workspace routes.

Rooms And HACP Collaboration

  • Rooms can be listed, created, loaded by ID, updated with policy, archived, and scoped to workspace policy.
  • Room participants can be invited, accepted, bound to harness instances, removed, and issued room-scoped capabilities.
  • HACP events are accepted through signed envelopes, stored in the room event log, and returned with server receipts.
  • Gateway sessions support join/routing behavior, active subject tracking, run frames, and metrics.
  • HACP observability exposes room timelines, while HACP inference and agent-run routes support guidance, autonomy grants, run creation, and run control actions.

Projects, IDE, And Runtime Access

  • Projects support list, create, detail, defaults, default approval, current AGENTS.md/materialized files, progress updates, decisions, and handoff records.
  • Repository features cover credentials, host allowlists, URL validation, repository import, project repository binding, task listing, and task patching.
  • Project IDE routes cover GitHub install URLs, repository lookup, GitHub binding, Codespaces launch, Docker/fake/disabled IDE session creation, current session lookup, session deletion, pull-request listing, PR review, and PR merge.
  • File-scope routes cover scope policies, preview, activation, command profiles, deactivation, authoring view, audit, and project test run detail.
  • Project vulnerability scans can be created, listed, loaded, and populated with results.
  • Harness-task routes merge project tasks and loop workitems into a single runnable queue for HACP/GeneSYS, including project-task conversion into loop workitems.

Artifacts, Review, And Patch Apply

  • Artifacts can be uploaded for room events, listed at workspace scope, loaded by ID, downloaded as content, and rendered through preview routes.
  • Artifact scanning records worker jobs and fail-closed metadata for suspicious or unscanned content.
  • Review routes expose room review queues, review decisions, and patch-apply operations.
  • Patch apply records preserve decision linkage, state transitions, and audit metadata.
  • Download routes provide global and workspace-scoped release/download access by filename.

Trust, Security, And Operations

  • Release trust supports admin manifest upload, denylist management, manifest lookup, workspace manifest listing, manifest downloads, and workspace denylist writes.
  • Release downloads support both the narrow HACP harness package and the full GeneSYS offline installer bundle through API-served object storage.
  • Enrollment supports challenges, proof submission, challenge lookup, approve/deny decisions, harness listing, certificate issuance, runtime evidence, and release-trust checks.
  • Revocation supports workspace and admin revocation creation/listing plus admin session drain.
  • Audit supports workspace and admin audit views, and admin security exposes a consolidated dashboard.
  • Package security exposes public summary/finding/package/version/latest-scan views plus admin scans, incidents, acknowledge/resolve, exception, block, and false-positive decisions.
  • Health, readiness, metrics, CORS, object storage, database clients, Prisma-backed stores, and test-time memory/noop stores are wired at server construction.

Worker Scope

Worker ModuleResponsibility
artifact-scan-pipelineCreate and advance artifact scanning work from uploaded evidence.
package-security-scannerRun dependency/package intelligence scans and normalize findings.
package-security-schedulerSchedule package security scans and incident follow-up work.
project-test-runnerExecute project test runs from file-scope/project workflows.
loop-scheduler and loop-run-starterCoordinate scheduled loop work items and runtime starts.
hacp-patch-applyApply accepted HACP review patches through controlled worker execution.
oauth-cleanupClean expired OAuth/auth state in the background.

Source Material

  • apps/api/src/server.ts
  • apps/api/src/modules
  • apps/api/src/modules/harness-tasks/routes.ts
  • packages/contracts/src/index.ts
  • rust/crates/hacp-launcher/src/lib.rs
  • apps/gateway/src
  • apps/worker/src
  • apps/web/src/app
  • packages