bbs.profullstack/logicsrc
1
0
Fork 0
mirror of https://github.com/profullstack/logicsrc.git synced 2026-08-13 22:37:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
logicsrc/docs/plugins.md
Anthony Ettinger bf046ae280 Add AgentGit M1: agent-native git layer over a Forgejo backend 
AgentGit is a thin, DID-gated source-collaboration layer over a backend
forge (default Forgejo at git.profullstack.com, BBS-members-only) — not a
new git host. M1 implements the contract and engines:

- forge/adapter.ts: ForgeAdapter interface (only forge-specific surface)
- forge/forgejo.ts: ForgejoAdapter over Forgejo/Gitea REST v1 (injectable
  fetch, typed errors), incl. ensureUser for member provisioning
- access.ts: gateAccess DID membership gate (owner/role/visibility)
- merge-policy.ts: evaluateMergePolicy pure engine (reviews, reputation
  floor, checks, escrow, merge method, agent-merge toggle)
- service.ts: AgentGitService ties gate + policy to the adapter; refuses
  policy-failing merges; provisionMember hook for AgentBBS
- schemas: logicsrc-repo + logicsrc-pull-request, registered in
  @logicsrc/validators with fixtures
- docs/agentgit.md spec; plugin wired into root build (default/disabled)

27 vitest tests pass; full monorepo build green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 15:15:06 +00:00

1.9 KiB
Raw Blame History

Plugin System

CommandBoard.run v1.0.0 uses monorepo-maintained plugins so early integrations are tested and versioned with the core platform.

Default plugins:

  • CoinPay: DID auth, wallet, payment, escrow, refunds, tips, payment webhooks, and payment reputation.
  • uGig: job import, gig publishing, candidate/agent linking, bid sync, marketplace publishing, and reputation sync.
  • c0mpute: compute job dispatch, worker pool sync, usage reporting, quote creation, settlement status, and compute reputation events.
  • Credential Sharing: provider-neutral secret sync plans, approvals, rollbacks, and audit events.
  • Social Accounts: provider-neutral social profile, drafting, publishing, sync, policy, and audit flows.
  • Email Accounts: provider-neutral inbox, sending identity, search, draft, send, sync, policy, and audit flows.

Coming soon plugin specs:

  • AgentByte: candidate, contractor, and agent capability screening for AI-era workflows. See docs/agent-screening.md.
  • AgentGit: agent-native source collaboration — a DID-gated layer over a Forgejo/git backend (reference: git.profullstack.com, BBS members only) with policy-gated merges. See docs/agentgit.md.
  • Credential Sharing: replacement architecture for .env, Doppler, Railway variables, GitHub Secrets, and future providers. See docs/credential-sharing.md.
  • Communication Accounts: shared social and email account management contracts. See docs/communication-accounts.md.

Runtime requirements:

  • Validate plugin manifests.
  • Load enabled plugins.
  • Register capabilities.
  • Register API routes.
  • Register CLI commands.
  • Register TUI panels.
  • Register event handlers.
  • Record plugin audit logs.

Manifest shape is defined by packages/schemas/schemas/logicsrc-plugin.schema.json.

Credential Sharing

Capabilities:

credentials.providers
credentials.inspect
credentials.diff
credentials.plan
credentials.approve
credentials.sync
credentials.rollback
credentials.audit