How ruvnet/ruclip works
ruClip is a governance control plane for agent-run companies, not an agent framework. The main workflow is to define company, goal, and issue records; authorize employee actions; apply approval transitions; and persist the resulting state. Separate capabilities cover budget-gated heartbeats, notifications, dashboard snapshots, adaptive interaction profiles, human identity attestation, and runtime governance. The graph reflects documented capabilities and indexed module references; unsampled implementation details are not assumed.
Main entry points: agentdb-adapter.ts AgentDB adapter · human-identity-attestation.ts Human attestation · bridge-client.ts AgentDB bridge client · attest-handler.ts Attestation service
Components 23
Company domain
- Domain schemas
src/control-plane/schema - Schema validation
src/control-plane/schema/validation.ts
Workflow governance
- Approval transitions
src/control-plane/approval/transition-approval-state.ts - Budget mutations
src/control-plane/governance/propose-budget-mutation.ts - Autogenous client
src/control-plane/governance/autogenous-client.ts
Identity and access
- Claims authorization
src/control-plane/authorization/claims-authorization.ts - Human attestation
src/control-plane/authorization/human-identity-attestation.ts - Actor credentials
src/control-plane/authorization/actor-credential.ts - Credential issuer
src/control-plane/authorization/credential-issuer.ts - Attestation service
services/ruclip-attester/src/attest-handler.ts - Google token verifier
services/ruclip-attester/src/google-token.ts - Employee identity map
services/ruclip-attester/src/identity-map.ts
Company operations
- CLI
src/cli/ruclip.ts - Budgeted heartbeats
src/control-plane/heartbeat/fire-heartbeat.ts - AgentBBS notifications
src/control-plane/comms/agentbbs-notification-channel.ts - Dashboard snapshot
src/control-plane/dashboard/build-snapshot.ts - Interaction profiles
src/control-plane/employee-augmentation/interaction-profile.ts
Persistence and integrations
- AgentDB adapter
src/control-plane/store/agentdb-adapter.ts - AgentDB bridge client
src/control-plane/store/bridge-client.ts
Other components
- Human or agent
- AgentDB
- Autogenous service
- AgentBBS
Connections 25
- Human or agent → CLI: invokes
- CLI → Human attestation: requests credentials
src/cli/ruclip.ts - Attestation service → Google token verifier: verifies token
services/ruclip-attester/src/attest-handler.ts - Attestation service → Employee identity map: looks up identity
services/ruclip-attester/src/attest-handler.ts - Attestation service → Human attestation: mints attestation
services/ruclip-attester/src/attest-handler.ts - Human attestation → Actor credentials: verifies identity
src/control-plane/authorization/human-identity-attestation.ts - Human attestation → Credential issuer: mints credential
src/control-plane/authorization/human-identity-attestation.ts - Human attestation → AgentDB adapter: recalls member
src/control-plane/authorization/human-identity-attestation.ts - Human attestation → AgentDB bridge client: stores marker
src/control-plane/authorization/human-identity-attestation.ts - Approval transitions → Domain schemas: uses transition types
src/control-plane/approval/transition-approval-state.ts - AgentDB adapter → Schema validation: validates writes
src/control-plane/schema/validation.ts - AgentDB adapter → Claims authorization: verifies claims
src/control-plane/store/agentdb-adapter.ts - AgentDB adapter → Actor credentials: resolves actor
src/control-plane/store/agentdb-adapter.ts - AgentDB adapter → AgentDB bridge client: calls bridge
src/control-plane/store/agentdb-adapter.ts - AgentDB bridge client → AgentDB: sends JSON-RPC
src/control-plane/store/bridge-client.ts - Budgeted heartbeats → AgentDB adapter: reads schedules
src/control-plane/heartbeat/fire-heartbeat.ts - Budgeted heartbeats → AgentBBS notifications: emits notifications
- AgentBBS notifications → AgentDB bridge client: calls bridge
src/control-plane/comms/agentbbs-notification-channel.ts - AgentBBS notifications → AgentBBS: sends notifications
README.md - Dashboard snapshot → AgentDB adapter: reads company data
src/control-plane/dashboard/build-snapshot.ts - Interaction profiles → AgentDB adapter: reads member and transitions
src/control-plane/employee-augmentation/interaction-profile.ts - Interaction profiles → AgentDB bridge client: persists profile
src/control-plane/employee-augmentation/interaction-profile.ts - Budget mutations → AgentDB adapter: reads governance data
src/control-plane/governance/propose-budget-mutation.ts - Budget mutations → Autogenous client: requests mutation
src/control-plane/governance/propose-budget-mutation.ts - Autogenous client → Autogenous service: calls service
src/control-plane/governance/autogenous-client.ts