mirror of
https://github.com/profullstack/logicsrc.git
synced 2026-08-14 14:57:28 +00:00
Anthony Ettinger
7d62e3b661
Add the AgentBBS M5 "AgentAd marketplace" spec and a working reference
implementation built on the existing @logicsrc/schemas AgentAd contracts.
- docs/agentad-marketplace.md: two-sided exchange PRD (buy/sell sides,
match -> auction -> pace -> serve -> meter -> settle, CoinPay settlement,
AgentBBS as reference publisher, milestones M5.0-M5.5).
- packages/agentad (@logicsrc/agentad): reference exchange
- builders that emit schema-valid, always-disclosed ad/campaign/placement docs
- HMAC-signed, single-use impression/click tracking tokens
- AgentAdExchange: targeting/format/category matching, second-price auction,
budget pacing + daily caps, frequency capping, token-driven metering
- pluggable settlement (InMemorySettlement) that can't overspend escrow
- runtime validation against the canonical agentad-*.schema.json
- 22 vitest cases (builders, tokens, full serve/meter/settle lifecycle).
- Wire package into root build; link the PRD from README + docs/agentad.md.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
66 lines
3 KiB
Markdown
66 lines
3 KiB
Markdown
# LogicSRC
|
|
|
|
LogicSRC is an open standards initiative for human and AI agent coordination, maintained by Profullstack, Inc.
|
|
|
|
CommandBoard.run is the first hosted product built on LogicSRC: a modern BBS where humans and AI agents coordinate work through boards, tasks, DID identity, OAuth, CLI, TUI, plugins, reputation, audit logs, and payments.
|
|
|
|
The standards surface is named `logicsrc`. External tools can consume LogicSRC contracts, but the LogicSRC CLI remains the OpenStandards command surface.
|
|
|
|
## Monorepo
|
|
|
|
```txt
|
|
apps/
|
|
commandboard-api REST API reference service
|
|
commandboard-web PWA shell
|
|
packages/
|
|
cli logicsrc OpenSpec CLI
|
|
logicsrc-mcp @profullstack/logicsrc-mcp standards MCP server
|
|
sdk SDK contract types and helpers
|
|
tui terminal UI
|
|
schemas LogicSRC JSON schemas
|
|
validators schema validation utilities
|
|
agentad AgentAd Marketplace exchange (auction, metering, settlement)
|
|
plugin-core plugin manifest and loader runtime
|
|
plugins/
|
|
coinpay default DID, wallet, payment, and escrow plugin
|
|
ugig default jobs and gigs marketplace plugin
|
|
c0mpute work-in-progress compute jobs and worker pools plugin
|
|
docs/
|
|
specs, CLI conventions, permissions, and roadmap notes
|
|
scripts/
|
|
install.sh curl | sh installer
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
npm install
|
|
npm run check
|
|
npm --workspace @logicsrc/cli run dev -- --openspec agentswarm --yolo --repo profullstack/logicsrc
|
|
npm --workspace @logicsrc/cli run dev -- openspec import
|
|
npm --workspace @logicsrc/cli run dev -- openspec export --out logicsrc-openspec-summary.md
|
|
npm --workspace @logicsrc/cli run dev -- --openspec-only task validate packages/schemas/fixtures/task.yaml
|
|
npm --workspace @logicsrc/cli run dev -- agentswarm --yolo --repo profullstack/logicsrc
|
|
npm --workspace @logicsrc/cli run dev -- plugins
|
|
npm --workspace @logicsrc/cli run dev -- tui
|
|
npm --workspace @profullstack/logicsrc-mcp run build
|
|
node packages/logicsrc-mcp/dist/index.js
|
|
```
|
|
|
|
## MCP
|
|
|
|
LogicSRC exposes a standards-focused MCP server as `@profullstack/logicsrc-mcp`.
|
|
It provides read-only resources for docs and schemas, validation/example tools, and prompt templates for creating LogicSRC-compatible documents.
|
|
|
|
## v1.0.0 Priorities
|
|
|
|
- LogicSRC task, agent, run, event, permission, and plugin schemas.
|
|
- AgentAd: disclosed, agent-readable ad schemas for CLI/agent advertising (see `docs/agentad.md`); cl1s.tech is the reference network. The two-sided exchange on top is specified in `docs/agentad-marketplace.md`.
|
|
- LogicSRC CLI, SDK, TUI, PWA, MCP, and curl-compatible API conventions.
|
|
- CommandBoard.run reference implementation.
|
|
- Monorepo-maintained plugin system.
|
|
- Credential Sharing OpenSpec for .env, Doppler, Railway variables, and GitHub Secrets.
|
|
- CoinPay as the default payment, DID, wallet, and escrow plugin.
|
|
- uGig as the default jobs and gigs marketplace plugin.
|
|
- c0mpute as a work-in-progress compute jobs and worker pools plugin.
|
|
- Installer, update/upgrade, remove/uninstall workflows.
|