LogicSRC is an open standards initiative for human and AI agent coordination, maintained by Profullstack, Inc. https://logicsrc.com
Find a file
Anthony Ettinger 4fed2681ec
Some checks are pending
CI / build (push) Waiting to run
test / test (push) Waiting to run
Add the LogicSRC OpenSwarm specification family (#142)
BitTorrent distributes bytes better than any CDN and has never been a
product: nobody is paid to seed, and nothing in it is private. Every
Profullstack media property answers that with a central HTTP proxy and a
pass system bolted on, and pays for every byte it serves.

OpenSwarm is an add-on to BitTorrent, carried as BEP 10 extension
messages, that fixes both. The swarm carries AES-256-CTR ciphertext whose
integrity is pinned by two SHA-256 merkle roots in a signed manifest, so
a tracker or DHT node learns an infohash and a size. A leecher buys a
pass over x402 in USDC (the same exchange x402-gateway runs for crawl
passes, settled by CoinPay), a seeder serves inside a bounded credit
window, and the leecher signs a cumulative voucher for every verified
batch. Whoever seeds gets paid. Vanilla clients remain valid members and
browsers remain first-class peers.

Adding a file mints a key pair for it, derived from one publisher seed by
default so there is one thing to back up: the public half is the file's
identity and its BEP 46 key, the private half signs the manifest and
authorises grants and payout changes, and a separate content key
encrypts the bytes and is sealed to paying peers.

The family: a core (records, keys, hashing, transports, discovery,
events), ipfile, ippay, ipdb (a signed hash-chained catalogue with heads
on the DHT), ipaudio, ipvideo, iplive (paid relays with backpressure)
and ipname (Moshpit pins and DNS TXT). Plus the c0mpute.com integration
with seven workload types and thirteen use cases, a proposed ip CLI,
conformance profiles, a security model and an FAQ.

Registered on the site the way OpenCreds is: nav entry, docs registry,
sitemap, a /openswarm landing page, PRD 0005, and the MCP prd_next_id
expectation moved to 0006.

Specs only. No code, no schemas, no reference implementation.


Claude-Session: https://claude.ai/code/session_01YafYxayh7Gqe5MWNNQMev2

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-05 15:05:57 -07:00
.github ci: remove the vu1nz security scan (#127) 2026-08-03 07:16:41 -07:00
apps Add the LogicSRC OpenSwarm specification family (#142) 2026-09-05 15:05:57 -07:00
docs Add the LogicSRC OpenSwarm specification family (#142) 2026-09-05 15:05:57 -07:00
examples Add the LogicSRC OpenContext specification (#132) 2026-08-09 11:46:11 -07:00
packages Add the LogicSRC OpenSwarm specification family (#142) 2026-09-05 15:05:57 -07:00
plugins Add SSH keys and config to credential sharing (#139) 2026-08-13 17:03:00 -07:00
prd Add the LogicSRC OpenSwarm specification family (#142) 2026-09-05 15:05:57 -07:00
scripts Scaffold LogicSRC and CommandBoard plugins 2026-06-06 11:24:02 +00:00
supabase feat(credential-sharing): end-to-end-encrypted team credential sharing 2026-07-13 13:11:32 +00:00
.env.example Charge AI training crawlers for access (x402 gateway) (#141) 2026-09-05 14:49:39 -07:00
.gitignore feat(credential-sharing): implement the Credential Sharing OpenSpec (M1-M3) 2026-06-27 15:24:30 +00:00
LICENSE Initial commit 2026-06-06 03:30:15 -07:00
package-lock.json Charge AI training crawlers for access (x402 gateway) (#141) 2026-09-05 14:49:39 -07:00
package.json Add the LogicSRC OpenCreds specification (#140) 2026-08-29 04:11:38 -07:00
README.md Add SSH keys and config to credential sharing (#139) 2026-08-13 17:03:00 -07:00
tsconfig.base.json Scaffold LogicSRC and CommandBoard plugins 2026-06-06 11:24:02 +00:00

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

apps/
  commandboard-api   REST API reference service
  commandboard-web   PWA shell
packages/
  cli                logicsrc OpenSpec CLI
  opencontext        OpenContext reference implementation (resolver, scopes, bundles, adapters)
  openontology       OpenOntology reference engine (entities, claims, queries, change sets)
  openprd            OpenPRD reference implementation (numbered PRDs, lifecycle, task bridge)
  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
examples/
  openontology/ethereum-ecosystem   fictional ecosystem map demonstrating OpenOntology
  opencontext/*                     five OpenContext repositories, from minimal to multi-agent
prd/
  numbered OpenPRD proposals
scripts/
  install.sh         curl | sh installer

Quick Start

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

OpenPRD

OpenPRD is a lightweight standard for product requirements documents: a repo keeps a numbered, committed collection under prd/, one Markdown file each, with front-matter, a fixed set of eight sections, and a lifecycle. @logicsrc/openprd implements it.

npm --workspace @logicsrc/cli run dev -- prd new "Expand the parked-domain service"
npm --workspace @logicsrc/cli run dev -- prd validate ./prd --strict
npm --workspace @logicsrc/cli run dev -- prd status 0001 Review
npm --workspace @logicsrc/cli run dev -- prd tasks 0001 --priority P0

Conformance failures (filename, front-matter, id match, the eight sections in order) are errors; lint findings are warnings that --strict promotes. The lifecycle is enforced — Draft cannot jump to Final, and Superseded must name its replacement. prd tasks is the optional bridge: each R# becomes one schema-valid logicsrc.task.

OpenOntology

LogicSRC OpenOntology is an open contract for durable, source-backed domain knowledge shared by humans and AI agents: typed entities, claims that carry provenance and time, a portable query AST, and governed change sets. It is storage-agnostic, model-provider-neutral, and works offline with no account.

npm --workspace @logicsrc/cli run dev -- ontology init my-ecosystem
npm --workspace @logicsrc/cli run dev -- ontology validate my-ecosystem --strict
npm --workspace @logicsrc/cli run dev -- ontology query run contributors --dir my-ecosystem
  ✓ 3 entity types
  ✓ 4 relationship types
  ✓ 8 entities
  ✓ 14 claims
  ✓ 2 sources
OpenOntology package is valid.

Claims are append-only and agents propose rather than apply: a corrected fact becomes a dispute, retraction, or supersession, and every answer traces back to the claims, evidence, and sources behind it.

Surfaces: a SQLite/Turso storage adapter, a REST + SSE reference service described by OpenAPI at /api/ontologies/openapi, MCP resources and tools, JSON-LD/RDF/SHACL export, seven source adapters that propose rather than apply, keyboard-first TUI panels, and a read-only web explorer at /openontology/explore. See also governance and interoperability.

OpenContext

LogicSRC OpenContext is an open specification for durable, portable, permissioned, provenance-aware context shared between humans and AI agents. It defines how organizational knowledge is described, authorized, versioned, resolved, audited, and handed between replaceable workers without losing institutional state.

An agent should be replaceable without losing organizational knowledge.

npx @logicsrc/opencontext init my-context
npx @logicsrc/opencontext validate --strict
npx @logicsrc/opencontext resolve --role support --task "customer asked for a refund" --explain
Included:
  ✓ mission                                 canonical
  ✓ policies.refunds                        canonical
  ✓ procedures.refund                       approved

Excluded:
  - decisions.2026-08-09-adopt-opencontext  not-in-scope   (no include pattern matches)

Digest: sha256:81b41a915ee68f744e91ef0d7760440de51b603088de1a6f21ea6f337bb374a8

Authorization runs before relevance, so an agent never ranks context it may not read; authority is declared rather than inferred from retrieval rank; unresolved canonical conflicts are reported rather than quietly settled; and resolution is deterministic, so a decision can cite the exact bundle digest it was made from. Untrusted content — tickets, chats, scraped pages — keeps its trust level through resolution and is fenced and labelled in rendered bundles.

It is not a memory database. Memory is one possible context source; OpenContext is the control plane above systems that remain the sources of truth. It runs from a folder and a Git repository with no account, no server, and no telemetry.

Also available as logicsrc context <command>, sharing one implementation with the standalone binary. See the specification, CLI, SDK, security model, and conformance guide.

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 end-to-end-encrypted team vaults, .env, Doppler, Railway variables, GitHub Secrets, sh1pt, and ~/.ssh keys.
  • 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.