Yonexus/README.md

Yonexus (MVP foundation)

OpenClaw plugin foundation for:

• Organization hierarchy (Org/Dept/Team)
• Agent registration + multi-identity
• Supervisor mapping
• Role-based authorization
• Query DSL (eq | contains | regex) with schema queryable guard
• Scoped shared memory adapter (compatible with memory tools)

Quick start

npm install
npm run build
bash scripts/install.sh

Current status

Implemented in this branch:

• Data models + JSON persistence store
• Permission checker authorize(action, actor, scope)
• Core APIs:
  • createDepartment
  • createTeam
  • registerAgent
  • assignIdentity
  • setSupervisor
  • whoami
  • queryAgents
• Query parser/executor with pagination
• Scope memory adapter (put/search)
• Management APIs:
  • renameDepartment
  • renameTeam
  • migrateTeam
  • deleteDepartment
  • deleteTeam
• Error code model (YonexusError) and audit logs
• Import/export APIs (importData / exportData)

Notes

• Persistence file defaults to data/org.json.
• Meta fields are validated against schema; unknown fields are dropped.
• Supervisor relation does not imply permissions.