Files
iios/.claude/memory/project_iios_overview.md
maaz519 5abee1b5b7 docs: add repo-local project memory under .claude/memory/
Versioned, per-topic project memory (index + entries): IIOS overview, the generic-safety
rule, run/test + the replay.spec flake workaround, recent features (Supabase auth,
reactions/pins/saves, mentions, media, notifications), the chat-web consumer, and workflow
conventions. CLAUDE.md points to it as the accumulating-notes companion to the canonical rules.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 19:55:38 +05:30

1.3 KiB

name, description, metadata
name description metadata
project_iios_overview What IIOS is — a generic multi-tenant interaction OS; kernel + specializations + swappable platform ports
type
project

IIOS (Insignia Interaction OS) = one NestJS service (@insignia/iios-service) + SDKs, in a pnpm monorepo (packages/*). Every interaction (chat message, ticket, routed post, AI suggestion, meeting) is the same kernel object inside a tenant scope (IiosScope: org/app/tenant/…), behind the same fail-closed gates, emitting the same audit trail.

Products (messaging, inbox, support, routing, AI, calendar, media, notifications) are thin specializations on top of a tiny kernel — never the reverse (pnpm boundary enforces it).

Platform seams are ports (IiosPlatformPorts, DI token PLATFORM_PORTS; dev = permissive LocalDevPorts): session, opa, cmp (consent), mdm, sas, capability, plus StoragePort (media) and NotificationPort (push). Dev stubs swap to real adapters with zero consumer changes. Every op passes decideOrThrow(ports, {action,…}) fail-closed. Events go through a transactional outbox → OutboxBus → idempotent projectors (inbox, notifications).

See the repo CLAUDE.md and docs/IIOS_API_AND_SDK_GUIDE.md (as-built reference) for detail. Related: feedback_generic_safety.