LogicSRC is an open standards initiative for human and AI agent coordination, maintained by Profullstack, Inc. https://logicsrc.com
Find a file
Anthony Ettinger be99e683bd
Some checks are pending
CI / build (push) Waiting to run
test / test (push) Waiting to run
Add pay2seed, paid2seed, pay2stream and paid2stream to the OpenSwarm family (#143)
* Add pay2seed to the OpenSwarm family: consent at upload and a paid seed market

OpenSwarm pays a seeder per verified piece served, and nothing pays anyone
to stay. An archive, a backup, a dataset waiting for its buyer or a
podcast's back catalogue earns nothing the month nobody downloads it, so
it dies the way every swarm always has. And nothing in BitTorrent says who
put a swarm there or whether they were allowed to, which is why a seeder
is presumed to be doing something wrong.

pay2seed is the member document for both halves. An attestation, signed
at upload with a fixed basis (own, licensed, open-license, public-domain,
personal) and a notice endpoint, is what a hub requires before it will
list anything; public claims get a claim window and a standing, and a
notice voids them. An offer escrows a budget at an ippay hub for a swarm,
public or private, to be held by M seeders for N days at a price per
GiB-month, bought over x402 exactly as a pass is. Seeders take leases,
prove each period by storage challenge or by a probe over the ordinary
wire, and are paid through the payee they already have. Public feeds ride
on ipdb; ipfile.pin on c0mpute is the same offer on the auction.

Also: the family table, stack diagram and registry rows; the ip seed
command group; PRD 0006; the protocol row on /openswarm.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SKAohrRkqLKVQL2cGCAkR5

* Split pay2seed into client and server halves, and add pay2stream and paid2stream

The rule is now in the names. pay2* is the client protocol: the side that
pays, over HTTPS, and plays. paid2* is the server protocol: the BitTorrent
side that earns. One hub implements both halves of a pair; a requester or
viewer implements only pay2*; a seeder, relay or gateway only paid2*.

pay2seed keeps consent, offers, the requester's market and notices.
paid2seed takes leases, storage challenges and probes over the wire,
GiB-month accrual and receipts, the seeder client, and the ipfile.pin
mapping.

pay2stream and paid2stream do the same for a live channel over iplive.
A broadcaster attests the channel (with the two rules that separate a
licensed rebroadcast from a stolen feed), buys relays by the hour, and
publishes listings; viewers buy tickets. Relays take leases and are
proven present by a verifier that pulls segments as a peer; a gateway is
a relay that also serves standard HLS, clear or sealed, with the M3U and
XMLTV pair every IPTV app asks for, so VLC, TiviMate, Kodi and a
television play a paid swarm with nothing installed. Ace Stream showed
BitTorrent can carry live TV to millions; this is that with consent,
payment and an open spec.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SKAohrRkqLKVQL2cGCAkR5

* pay2seed: encrypted by default, access as the product, a README in every swarm

The client encrypts by default and the hub never does: what the hub
manages is who may decrypt. A team is a named set of member keys with a
scope over the owner's swarms; the hub, as keeper, issues grants to
members when the owner is offline, with invitations that expire, roles,
an audit trail, and re-encryption on removal so the next version is
closed to whoever left. A few seats are free; above that the hub charges
per seat and per organisation, settled through the same pay plugins as
everything else. Seeding is priced at disk; access is where a hub earns,
and both sides earn: seeders rent disk, requesters sell access.

Public is not a fallback. Encryption off is an explicit act, and a
public swarm is attested, listed, kept and rendered exactly as a private
one is; the only difference is who can read it.

Every swarm on the market carries a README.md at its root, no
exceptions, and the attestation carries its Markdown and the hash of
the copy inside the swarm, so the hub renders it as the swarm's page
without a key. Relative links resolve into the swarm and are gated the
way the files are.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SKAohrRkqLKVQL2cGCAkR5

* pay2seed: 1 percent, ads on the free tier, and agents as sellers

Three things the specs did not say. The reference hub takes 1 percent of
any payment that crosses it, charged to whoever is paying and never
deducted from a seeder or a relay, so a quoted price is what the
publisher gets and a promised floor is what the seeder is paid.

Public swarms are free to fetch and free to list, and an advertisement on
the swarm README page is what pays for that. The ad is on the hub page
and nowhere else: never inside a swarm, never injected into a file, a
segment or a playlist, and never in the catalogue or the market API. A
requester who wants no ad buys a seat instead. A free-to-watch channel
works the same way.

And a requester is a key, not a person. An agent can attest what it made,
price access, sell tickets, take payment through its own payee and spend
what it earns keeping its own work online. The consent rules do not
soften because a machine signed them, and the reference hub asks an
agent public attestation to name a responsible operator key so somebody
is reachable when a notice arrives.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SKAohrRkqLKVQL2cGCAkR5

* Fix CI: number the PRD requirements and advance the next-id assertion

Two checks the new PRD tripped, both by existing rather than by being
wrong.

The collection validator wants requirements as numbered R# entries and
0006 used a plain ordered list, so it reported OP-L-NO-REQUIREMENTS.
Rewritten as R1 to R7 with priorities, one capability per entry, and the
implementation tracking moved to a paragraph under them where it is not
pretending to be a requirement.

The MCP standards test asserts what the next free PRD id is, and its own
comment says that advances with every PRD added. Adding 0006 makes it
0007.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SKAohrRkqLKVQL2cGCAkR5

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-05 19:12:45 -07:00
.github ci: remove the vu1nz security scan (#127) 2026-08-03 07:16:41 -07:00
apps Add pay2seed, paid2seed, pay2stream and paid2stream to the OpenSwarm family (#143) 2026-09-05 19:12:45 -07:00
docs Add pay2seed, paid2seed, pay2stream and paid2stream to the OpenSwarm family (#143) 2026-09-05 19:12:45 -07:00
examples Add the LogicSRC OpenContext specification (#132) 2026-08-09 11:46:11 -07:00
packages Add pay2seed, paid2seed, pay2stream and paid2stream to the OpenSwarm family (#143) 2026-09-05 19:12:45 -07:00
plugins Add SSH keys and config to credential sharing (#139) 2026-08-13 17:03:00 -07:00
prd Add pay2seed, paid2seed, pay2stream and paid2stream to the OpenSwarm family (#143) 2026-09-05 19:12:45 -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.