LogicSRC is an open standards initiative for human and AI agent coordination, maintained by Profullstack, Inc. https://logicsrc.com
Find a file
Anthony Ettinger 1e4e9def70
Some checks failed
CI / build (push) Has been cancelled
test / test (push) Has been cancelled
feat(credentials): encrypt the vault at rest (#121)
The vault holds the target's prior values so a bad rotation can be undone
— the one place raw credentials touch disk. It was written as plain JSON
at mode 0600, and a permission bit is all that was protecting it. That
stops another user on the same box. It does nothing about a backup, a
synced home directory, a lifted disk, or any process running as the
owner, and those are the cases where a credential store is worth reading.

Each run is now sealed to this machine's identity: a fresh DEK per write,
the payload sealed with it, the DEK sealed to the identity public key. So
the file opens with the secret key in identity.json and nothing else. The
key names go inside the ciphertext along with the values — knowing that
an endpoint holds STRIPE_LIVE_KEY is worth something by itself.

A DEK per run rather than one for the store: reusing a key would make a
single compromise open every rollback ever captured, and there is nothing
to gain by it, since the wrapped DEK travels in the file.

Plaintext vaults written before this still open. Refusing them would
strand the rollback data they exist to hold, and a vault reader that
cannot read yesterday's vault takes away the thing the vault is for.

The store's vault methods become async, which the three callers in the
engine already sat inside async functions to accommodate.

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 22:55:38 -07:00
.github/workflows ci: build workspaces before running tests; set PUBLIC_URL=https://logicsrc.com 2026-06-07 03:51:00 +00:00
apps fix(install): build before replacing the working install (#118) 2026-07-30 20:18:46 -07:00
docs fix(credentials): one vault per user, in the config dir (#119) 2026-07-31 22:53:17 -07:00
examples/openontology/ethereum-ecosystem feat(openontology): implement OpenOntology Phase 0 + local engine and CLI (#99) 2026-07-26 02:10:13 -07:00
packages fix(credentials): one vault per user, in the config dir (#119) 2026-07-31 22:53:17 -07:00
plugins feat(credentials): encrypt the vault at rest (#121) 2026-07-31 22:55:38 -07:00
prd feat(web): move Hire Us pricing to $400/hour metered billing (PRD 0002) (#102) 2026-07-28 10:34:49 -07:00
scripts
supabase feat(credential-sharing): end-to-end-encrypted team credential sharing 2026-07-13 13:11:32 +00:00
.env.example feat(pwa): logicsrc credentials app — real auth + Turso, redesigned; retire commandboard-api credshare 2026-07-13 14:29:29 +00:00
.gitignore feat(credential-sharing): implement the Credential Sharing OpenSpec (M1-M3) 2026-06-27 15:24:30 +00:00
LICENSE
package-lock.json feat(openontology): Phase 2 + Phase 3 — storage, REST/SSE, MCP, RDF/SHACL, adapters, TUI, explorer (#101) 2026-07-28 05:10:33 -07:00
package.json feat(openprd): implement the OpenPRD standard — engine, CLI, conformance bundle (#100) 2026-07-28 04:11:07 -07:00
README.md feat(openontology): Phase 2 + Phase 3 — storage, REST/SSE, MCP, RDF/SHACL, adapters, TUI, explorer (#101) 2026-07-28 05:10:33 -07:00
tsconfig.base.json

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
  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
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.

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.