Skip to content

About

Collabration is a social network for accountable human-agent communities, where AI operates primarily as governance infrastructure rather than autonomous social actors.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Collabration

Collabration is a governed human+AI social network where communities collaborate with accountable AI infrastructure.

Metacollaborate. Metacalibrate. Metacelebrate.

The alpha thesis is simple: users should be able to participate in a familiar social space while understanding who created content, whether AI was involved, what an agent was allowed to do, who approved public actions, what evidence supports a claim, and how the result can be challenged or corrected.

Naming transition — 2026-09-16: Collabration is the canonical product identity. The former name Intellectro is retained only where needed for provenance, historical chronology, old URLs, current provider identifiers, commits, and evidence that has not been renamed at its source. The rename changes product identity only; it does not change any implementation, runtime, authorization, security, evaluation, verification, deployment, or production-readiness state. See docs/brand/collabration-identity.md.

Five-minute evaluator path

If you are evaluating Collabration as a product-engineering or AI-governance portfolio artifact, start here.

1. Understand the product boundary. Collabration is a social application with explicit governance around agent capabilities, human approval, provenance, correction, and persistence. It is not presented as a production-ready autonomous-agent platform.

2. Inspect the implementation surfaces. Start with apps/web/, packages/governance/, packages/provenance/, and supabase/. The canonical capability policy is governance/capability-matrix.yaml.

3. Run the repository checks.

npm ci
npm run check
npm test
npm run dev:web

The governance/domain tests require no production credentials. Without public Supabase configuration, the application is expected to fail closed into explicit Demo mode rather than silently pretending persistence is available.

4. Inspect the trust boundary. The repository contains authenticated application paths, RLS-backed database design, governed action/provenance records, approval flows, and correction/appeal mechanics. Current production persistence configuration and browser/session verification remain separate runtime gates; repository completion is not evidence of production readiness or security certification.

5. Follow the evidence instead of the demo. For exact current boundaries, read Current implementation status, docs/supabase-live-verification.md, and docs/alpha-completion-gates.md. The deployed application is a presentation/runtime surface, not a substitute for those evidence records.

What this demonstrates

Within the stated evidence boundary, this repository demonstrates practical work in:

  • Next.js application engineering with authenticated server-side paths;
  • Supabase/Postgres schema and row-level-security design;
  • deny-by-default capability and human-approval controls;
  • provenance, revision-aware Content Passport, and governed-action records;
  • correction, appeal, blocking, moderation, and relationship lifecycle design;
  • CI-tested governance/domain contracts that keep implementation, runtime verification, and authorization separate.

Current implementation status

The repository contains the executable governance foundation:

  • deny-by-default capability decisions;
  • accountable agent ownership validation;
  • human approval gates;
  • governed rate limiting with denial audit events;
  • immutable governed action events;
  • provenance records that preserve source and transformation history without claiming truth;
  • a revision-aware Content Passport 0.1.0-alpha package contract that binds subject/source revisions, ordered transformations, accountable human/agent actors, immutable snapshots, and fail-closed currentness states without claiming truth or correctness;
  • a bounded Community Agent planning contract;
  • a bounded Claim Agent draft contract;
  • automated tests and CI.

It also contains the first persisted-alpha application boundary:

  • a Next.js governed social shell plus an authenticated /app runtime surface;
  • a strictly chronological feed with no ranking model;
  • source-linked posts and contextual support/challenge/qualify/add-evidence interactions;
  • typed Human-authored, Source-linked, AI-assisted, and Community context cues;
  • reactions plus report, block, mute, unblock, and unmute controls;
  • person-to-person connection requests with explicit pending/accepted/declined/cancelled/disconnected/blocked lifecycle, including accept, decline, cancel, and disconnect UI paths;
  • bilateral block precedence that is designed to hide blocked profiles/relationship rows at the database boundary and terminate pending/accepted connections without deleting another person's content;
  • explicit UX language that a human connection grants no agent permission, Space role, or governance authority;
  • Supabase SSR authentication with request-scoped clients, validated claims, PKCE callback handling, refresh-cookie propagation, and non-cacheable authenticated responses;
  • server actions that derive author/owner/requester identity from validated claims rather than client-supplied IDs;
  • persisted profile, Space creation/join, post, source-linked post, comment, and contextual-response paths;
  • a permission inspector projected from the canonical capability matrix;
  • an RLS-bound governed action log and moderator review queue;
  • a narrow pending governed-action request/decision lifecycle that records human approval or rejection without executing a model or publishing output;
  • an approved-action provenance receipt boundary that preserves provenance without claiming truth;
  • an append-only correction/appeal workflow whose resolution does not rewrite the original post or governed action;
  • versioned Supabase migrations with RLS on every admitted runtime table;
  • membership-gated social writes, atomic Space-owner creation, author-controlled direct source linkage, and Space-scoped moderator decisions;
  • no ordinary client insert path for agent_actions or provenance_records;
  • explicit Demo/fail-closed behavior when Supabase public configuration is absent.

Important evidence boundary: the dedicated Collabration Supabase project, currently carrying the historical provider display name Intellectro, has all ten currently admitted repository migrations represented in the live migration ledger, including connection relationships, Space invitations, and performance hardening. The live database currently exposes 18 public runtime tables with RLS enabled on all 18. The database/RLS boundary is therefore verified to the admitted scope, but overall live persistence remains NOT VERIFIED because production browser auth/session Gate B is still NOT VERIFIED.

As of the 2026-09-15 reconciliation, the Vercel project is correctly linked to the historical repository/provider identifier ndrorchestration/Intellectro, but the production health endpoint reports runtimeMode=misconfigured, persistence=disabled, and configurationReason=production_persistence_missing. The correct fail-closed conclusion is that production persistence is not currently configured, not that a Supabase binding has been proven. No secret value is required to establish that negative finding.

The Supabase security advisor currently retains 16 authenticated_security_definer_function_executable warnings across intentionally exposed authenticated RPCs. These warnings are not automatically vulnerabilities. Existing live tests cover many authority and lifecycle cases, but a complete per-function negative matrix for wrong caller, wrong object, cross-Space access, and invalid/stale lifecycle transitions remains open.

Repository-controlled moderator review, governed action/provenance boundaries, correction/appeal, Content Passport semantics, human relationships, Space invitations, and performance hardening are implemented and live-admitted at the database/RLS boundary. Still open are production persistence configuration, real browser Gate B, completion of the 16-function negative authorization matrix, realistic multi-account abuse/rate-limit testing, mainline required-check protection, package-manager/runtime pinning evidence, a real model-backed governed product loop, and the human Contextual Trust Comprehension evaluation. Any future model-provider integration must remain server-only and fail closed when unconfigured; repository completion does not authorize paid provider use or autonomous public posting.

Run locally

Requirements: Node.js 22 or newer.

npm ci
npm run check
npm test
npm run dev:web

The governance/domain tests require no production credentials. The web application builds without Supabase secrets and falls back to explicit Demo mode when the public Supabase URL and publishable key are absent.

Product promise

Collabration aims to be:

  • Socially familiar — profiles, human connections, Spaces, posts, comments, reactions, and a chronological feed.
  • Epistemically inspectable — sources, claims, uncertainty, disputes, corrections, and revision/currentness context can be examined when relevant.
  • Agentically accountable — agent identity, ownership, permissions, approvals, rate limits, and action history are visible and enforceable.
  • Community-governed — AI supports human communities under explicit policies rather than silently becoming the authority.

Alpha scope

  • One attractive social Space
  • One chronological feed
  • Human profiles and explicit connection relationships
  • Human posts and comments
  • Source-linked posts
  • Support / challenge / qualify interactions
  • One Community Agent
  • One Claim Agent
  • Deny-by-default capability permissions
  • Human approval for public agent output
  • Rate-limited automation
  • Visible trust/context cues
  • Provenance records and Content Passport contract semantics
  • Inspectable action log

Governance principles

  1. Every agent has an accountable owner.
  2. Every agent action uses a typed capability.
  3. Every public agent action is attributable.
  4. High-impact actions are reversible or human-approved.
  5. Automated actions are rate-limited.
  6. AI-derived artifacts preserve inputs and transformation history.
  7. Moderator decisions record the policy version used.
  8. Agents cannot expand their own permissions.
  9. Provenance establishes origin and transformation history; it does not by itself establish truth.
  10. Governance should appear when trust matters, not burden ordinary human expression.
  11. Human social relationships do not silently grant agent permissions, Space roles, or governance authority.

Governance evolution direction

Collabration will continue strengthening these controls through pattern transfer without authority transfer. Governance lessons from DGAF and other NDR projects may inform Collabration, but they do not transfer authorization, evidence, scientific results, or verification state.

For consequential AI activity, the target path is:

request → typed capability → policy decision → approval/verifier when required → execution → durable receipt → challenge/correction

Before broader autonomous authority is released, Collabration should independently establish versioned policy, adversarial tests, provenance/decision receipt behavior, rollback or revocation behavior, runtime evidence, and an explicit release decision. Higher-impact actions should prefer separation between the component proposing an action and the authority validating it when practical.

See ADR 0004 — Pattern transfer without authority transfer.

Core loop

connect → Space → discuss → inspect → coordinate → produce outcome

MVP proving path:

Human connects with collaborator → joins shared Space → posts a source-linked claim → Claim Agent analyzes it → another human challenges or qualifies the claim → Community Agent summarizes the disagreement → moderator approves the summary → provenance and action records are preserved

The brand-level learning loop is complementary rather than an authorization state machine:

connect → collaborate → calibrate → learn → improve → celebrate → repeat

Repository layout

apps/
  web/                  Next.js demo + authenticated persisted-alpha surface
agents/
  claim-agent/          bounded evidence-assistant contract
  community-agent/      bounded community-governance contract
packages/
  governance/           capability, approval, rate-limit, and audit primitives
  provenance/           provenance + revision-aware Content Passport contracts
  social-core/          social objects, relationship lifecycle, chronological feed, trust context
supabase/               versioned schema and RLS migrations
governance/             machine-readable policy/schema artifacts
docs/                   product, architecture, evaluation, threat models, verification plans, and ADRs
.github/workflows/       automated verification

Documentation map

Architecture principle

Governance kernel first. Social Space immediately. Autonomous agency later, if earned by evidence.

GitHub is the source of truth for code, schemas, policies, migrations, tests, agent contracts, evaluation assets, and architecture decisions. Vercel owns deployment/runtime facts and the dedicated Collabration Supabase project owns live database/Auth facts. The external GitHub/Vercel/Supabase identifiers that still use Intellectro remain operational aliases until those providers are actually renamed. Live social content and private user data belong in the runtime datastore, not in this repository.

About

Collabration is a social network for accountable human-agent communities, where AI operates primarily as governance infrastructure rather than autonomous social actors.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages