How oceanbase/powercontext works
PowerContext is a durable context service for AI work: agents and people store evidence and revisioned artifacts in Scopes, then prepare bounded context or hand work to another session or person. The principal path runs through a client or host integration to the HTTP server and builtin runtime, which operates on scoped artifacts and persistence; results return as prepared context or inspectable history. Other documented capabilities include candidate review, skill export/publication, dashboard access, and desktop management. Some internal links below are documented or indexed but not visible in the sampled implementation excerpts.
Main entry points: application.py Builtin runtime · distribution.py Skill distribution · models.py Skill lifecycle · app.py HTTP server
Components 23
User interfaces
- Python client
src/powercontext/client/ingestion.py - HTTP server
src/powercontext/server/app.py - Dashboard
src/powercontext/server/dashboard/routes.py - Desktop manager
desktop/ui/src/app/App.tsx
Service runtime
- Builtin runtime
src/powercontext/builtin/runtime/application.py - Scoped services
src/powercontext/builtin/scope/application.py - Code context
src/powercontext/builtin/code/service.py
Artifact lifecycle
- Memory lifecycle
src/powercontext/builtin/artifacts/atomic_memory/models.py - Artifact search
src/powercontext/artifacts/search.py - Handoff records
src/powercontext/builtin/artifacts/handoff - Experience review
src/powercontext/builtin/artifacts/experience - Skill lifecycle
src/powercontext/builtin/artifacts/skill/models.py - Skill packages
src/powercontext/builtin/artifacts/skill/package.py - Skill projection
src/powercontext/builtin/artifacts/skill/projection.py - Skill publication
src/powercontext/builtin/artifacts/skill/publication.py - Skill distribution
src/powercontext/builtin/artifacts/skill/distribution.py
Persistence
- Artifact repository
src/powercontext/builtin/persistence/artifacts.py - Database
src/powercontext/builtin/persistence/database.py - Skill governance
src/powercontext/builtin/persistence/artifact_governance.py - Skill targets
src/powercontext/builtin/persistence/agent_skill_targets.py - Publication records
src/powercontext/builtin/persistence/skill_publications.py
Integrations
- Hermes integration
integrations/hermes/plugins/powercontext/client.py
Other components
- Agent or person
Connections 23
- Agent or person → Python client: uses
README.md - Python client → HTTP server: requests
README.md - HTTP server → Builtin runtime: dispatches
src/powercontext/server/app.py - Builtin runtime → Scoped services: selects scope
src/powercontext/builtin/runtime/application.py - Builtin runtime → Code context: queries
src/powercontext/builtin/runtime/application.py - Builtin runtime → Memory lifecycle: prepares recall
src/powercontext/builtin/runtime/application.py - Builtin runtime → Artifact search: searches
src/powercontext/builtin/runtime/application.py - Builtin runtime → Handoff records: records work
README.md - Builtin runtime → Experience review: generates candidates
README.md - Builtin runtime → Skill lifecycle: manages
src/powercontext/builtin/runtime/application.py - Skill lifecycle → Skill packages: packages
src/powercontext/builtin/artifacts/skill/__init__.py - Skill lifecycle → Skill projection: projects
- Skill lifecycle → Skill publication: publishes
src/powercontext/builtin/artifacts/skill/publication.py - Skill publication → Skill distribution: distributes
src/powercontext/builtin/artifacts/skill/distribution.py - Skill distribution → Skill targets: reads targets
src/powercontext/builtin/artifacts/skill/distribution.py - Skill distribution → Skill governance: checks lifecycle
src/powercontext/builtin/artifacts/skill/distribution.py - Skill distribution → Publication records: records publication
src/powercontext/builtin/artifacts/skill/distribution.py - Skill distribution → Artifact repository: loads artifacts
src/powercontext/builtin/artifacts/skill/distribution.py - Builtin runtime → Artifact repository: persists artifacts
- Artifact repository → Database: stores in
- Agent or person → Dashboard: inspects history
README.md - Agent or person → Desktop manager: manages service
- Hermes integration → HTTP server: calls HTTP
integrations/hermes/plugins/powercontext/client.py