Profullstack open spec project

LogicSRC

Open schemas, primitives, and conventions for coordination between humans, AI agents, plugins, payment systems, and hosted products.

Get the CLI

curl -fsSL https://logicsrc.com/install.sh | sh

macOS and Linux · needs Node 18+ · read the script first

0.1draft spec 5schemas 3reference plugins

Standards Surface

LogicSRC defines the shared language; products can implement it without owning the standard.

Identity

DIDs, OAuth accounts, profiles, and organization membership.

Coordination

Boards, posts, threads, comments, tasks, bids, and submissions.

Agents

Agent profiles, capabilities, runs, logs, permissions, and audit trails.

Value

Payments, escrow, wallets, reputation events, and settlement hooks.

Events

Event streams, webhooks, schema versions, and integration audit logs.

AgentSwarm

An open spec AI agent platform for routing work across models, tools, providers, and repositories.

slug: agent-swarm

Provider-neutral agent orchestration

LogicSRC is adding model-provider integration primitives so a CLI or agent runtime can switch between major AI models, choose the cheapest capable option, or rotate models automatically for resilience and cost control.

logicsrc agentswarm --yolo \
  --repo profullstack/logicsrc \
  --agents reproduce,patch,review

Model routing

Switch across major AI model providers from one open spec interface.

Cost controls

Prefer the cheapest capable model, or rotate providers by price, latency, and task fit.

Master/slave agent workflows

Fan out a bug report from a master agent into scoped slave agents for reproduction, patching, review, and evidence.

GitHub integration

Target Profullstack repos, create issues and branches, and keep task history auditable.

OpenOntology

An open contract for durable, source-backed domain knowledge shared by humans and AI agents.

Define the things in a domain, connect them with typed claims, preserve where each fact came from, and let agents query or propose changes through governed interfaces. Storage-agnostic, model-provider-neutral, and usable with no account.

Read the specification Explore the example

Five nouns

Type       Person, Project, Codebase
Entity     eth:person:avery-lindqvist
Claim      Avery --worksOn--> ZK Prover
Source     the commit it came from
ChangeSet  a reviewable proposal

Claims are append-only. Agents propose; humans apply.

AgentByte

A coming-soon LogicSRC plugin spec for AI-era screening, assessments, interviews, and auditable agent-assisted answers.

slug: agentbyte

Screening where AI use is declared, measured, and auditable

AgentByte defines open screening sessions for humans, AI-assisted humans, autonomous agents, and human-agent pairs. Instead of pretending AI is absent, the spec records model use, tools, artifacts, scorecards, policy decisions, and evidence.

logicsrc agentbyte plan create \
  --role "AI Engineer" \
  --repo profullstack/logicsrc

logicsrc agentbyte session audit \
  --session ssn_123 \
  --format markdown

CLI

`logicsrc agentbyte` for plans, sessions, scorecards, audits, and artifacts.

TUI

Terminal panes for live transcripts, policy events, model use, evidence, and scorecards.

SDKs

Rust, Bun, Node, Python, and curl surfaces with the same screening session API.

PWA

Plan builder, candidate intake, live screening room, artifact review, and decision packet.

Open Schemas

Versioned JSON Schema files are the contract source for tasks, agents, runs, events, and plugins.

logicsrc-task packages/schemas/schemas/logicsrc-task.schema.json
logicsrc-agent packages/schemas/schemas/logicsrc-agent.schema.json
logicsrc-run packages/schemas/schemas/logicsrc-run.schema.json
logicsrc-event packages/schemas/schemas/logicsrc-event.schema.json
logicsrc-plugin packages/schemas/schemas/logicsrc-plugin.schema.json
logicsrc-openontology-claim packages/schemas/schemas/logicsrc-openontology-claim.schema.json

CLI Validation

npm install
npm run schemas:validate
npm --workspace @logicsrc/cli run dev -- \
  task validate ./task.yaml

The CLI belongs here as standards tooling: validate schemas, inspect objects, drive SDK/TUI/PWA/MCP contracts, and exercise compatible implementations.

Credential Sharing

An available LogicSRC OpenSpec for replacing closed credential-sharing workflows with auditable, provider-neutral secret sync — including end-to-end-encrypted team vaults you can share by email. Shipped in @logicsrc/plugin-credential-sharing.

slug: credential-sharing

Open replacement architecture for secrets

LogicSRC defines the credential source, target, diff, approval, sync, rollback, and audit objects. External tools can consume the contract, but LogicSRC remains the open standards CLI and does not call out to proprietary product commands.

logicsrc credentials providers
logicsrc credentials diff --from env --from-path .env --to railway \
  --to-project <projectId> --to-config <environmentId>
logicsrc credentials plan --from env --from-path .env --to doppler \
  --to-project <project> --to-config <config>
logicsrc credentials sync --plan <planId>            # dry-run, no writes
logicsrc credentials sync --plan <planId> --approve  # writes to the target
logicsrc credentials audit --run <runId> --format markdown
logicsrc credentials rollback --run <runId>

Team sharing, end to end encrypted

Teams ship today. The server is a zero-knowledge relay for secret values: it stores member X25519 public keys, the vault data-encryption key sealed once per member, and ciphertext. Plaintext values and the raw DEK never leave a member’s machine, and granting access re-seals the key to the new member rather than revealing it. When someone leaves, rotation re-keys the vault and drops their access.

logicsrc login                                   # registers this device's identity key
logicsrc teams create acme --name "Acme Inc"
logicsrc teams push acme web prod --env .env     # encrypt + upload
logicsrc teams invite acme teammate@example.com  # emails an accept link
logicsrc teams grant acme web prod teammate@example.com
logicsrc teams pull acme web prod --env .env     # download + decrypt
logicsrc credentials rotate acme web prod --approve

Team vaults

Share secrets with teammates by email instead of pasting .env files into chat — a hosted, end-to-end-encrypted vault addressed as team:<team>/<vault>.

.env

Parse, diff, redact, and write local env files without leaking values into logs.

Doppler

Sync project/config scoped secrets through provider adapters and auditable key fingerprints.

Railway

Read and write service variables as a deployment target with explicit approval gates.

GitHub Secrets

Manage repo, organization, and environment secrets through provider-neutral operations.

sh1pt

Sync the distribution credential vault — App Store Connect, Play, npm, Docker, and Cloudflare tokens — through the sh1pt CLI.

CLI

`logicsrc credentials` ships provider listing, dry-run plans, diffs, approvals, sync, rollback, and audit exports today.

SDK

`createCredentialEngine()` in `@logicsrc/plugin-credential-sharing` exposes the same source, target, policy, and audit objects for Node/TS.

TUI

A Credential Sharing panel reviews key diffs, providers, approval prompts, fingerprints, and failure states without showing raw secrets.

PWA

Planned: provider connection health, dry-run previews, approval history, and redacted sync evidence.

LogicSRC vs OpenSpec.dev

OpenSpec.dev is adjacent: it focuses on lightweight repo-local planning artifacts. LogicSRC is the broader coordination standard and can support OpenSpec-compatible workflows.

Area LogicSRC.com OpenSpec.dev
Primary scope

Open coordination standards for humans, agents, plugins, payments, hosted products, and reference implementations.

Lightweight spec-driven planning for code changes and agent work.

Artifacts

Schemas, plugin manifests, task/agent/run docs, event contracts, `@logicsrc/sdk`, MCP resources, CLI/TUI/PWA/API surfaces.

Repo-local specs, proposals, design docs, implementation tasks, and spec deltas.

Agents

Agent profiles, runs, audit logs, model routing, AgentSwarm orchestration, and provider-neutral execution records.

Persistent requirements and planning context for coding agents.

CLI

`logicsrc` as the canonical OpenStandards CLI.

`@fission-ai/openspec` plus native coding-tool slash command integrations.

MCP

Standards MCP server with schemas, validation tools, and prompts.

OpenSpec.dev currently positions itself as no-MCP.

Compatibility

`--openspec` should read/write OpenSpec.dev-style repo-local planning artifacts where useful.

Can remain the lightweight planning layer inside repos.

Compatibility Mode

logicsrc --openspec agentswarm --yolo \
  --repo profullstack/logicsrc

--openspec enables OpenSpec.dev-compatible repo-local specs, proposals, tasks, and deltas where supported. openspec import and openspec export summarize those artifacts for LogicSRC workflows. --openspec-only restricts work to LogicSRC-published contracts.

Reference Implementations

These prove the standard, but they are not the LogicSRC identity.

LogicSRC CLI

`logicsrc` is the canonical OpenStandards CLI for schemas, specs, plugins, and audits.

TUI and PWA

Terminal and browser reference surfaces mirror the same open contracts.

SDKs

`@logicsrc/sdk` defines contract types now; Rust, Bun, Node, Python, and curl surfaces mirror the same resources.

Reference API

Sample REST API available under `/api/*` for contract testing.

Plugins

Open plugin contracts let external products consume LogicSRC without LogicSRC calling proprietary tools.

Hire Us

$400/hour for accepted LogicSRC work using open infrastructure and open specs for AI agent systems.

Profullstack standards work

Open-spec AI agent implementation help

Hire us to turn agent ideas into portable LogicSRC specs, CLIs, SDKs, MCP resources, PWAs, APIs, and provider-neutral plugin workflows. We prioritize auditable contracts, repo-local artifacts, and integrations that can move between model providers and infrastructure.

$400 per hour

Billed against actual hours worked, invoiced after you approve them. Ten-hour minimum engagement; cancel any time with one week’s notice and pay only for hours already approved. See Terms.

Read specs

AI agent workflow specs

Open schemas, repo-local plans, AgentSwarm flows, AgentByte screening contracts, and MCP resources.

Reference implementations

CLI, TUI, SDK, PWA, API, curl, and provider-neutral plugin surfaces that prove the spec can be used.

Integration hardening

GitHub, CoinPay, model providers, webhooks, audit logs, permissions, and deployment-ready contracts.

Open infrastructure

Portable code and specs first: no closed workflow lock-in, no one-off agent scripts that cannot be audited.

CoinPay hourly invoice

After we accept the project, we invoice approved hours at $400/hour through CoinPay without exposing merchant credentials to the browser.

COINPAY_ORG=profullstack
COINPAY_PRODUCT=logicsrc-hire-us
COINPAY_RATE_USD_PER_HOUR=400
COINPAY_BILLING=metered_hours
COINPAY_MINIMUM_HOURS=10
COINPAY_STATUS=pending_acceptance

Top-Level Pages

LogicSRC.com should expose stable project pages for docs, publishing, company context, and legal basics.

/docs · Docs

Specification guides, CLI conventions, schemas, plugin contracts, SDK conventions, and MCP resources.

/blog · Blog

Project notes for LogicSRC, AgentSwarm, AgentByte, OpenSpec workflows, and reference implementations.

/openspec · OpenSpec

Comparison and compatibility notes for OpenSpec.dev-style repo-local specs, proposals, tasks, and deltas.

/hire-us · Hire Us

$400/hour LogicSRC work on open infrastructure, specs, AI agent workflows, and reference implementations paid through CoinPay after project acceptance.

/about · About

LogicSRC is the Profullstack open specification project for human and AI agent coordination.

/terms · Terms

Terms of engagement: the $400/hour rate, what is billable, how approved hours are invoiced, the 10-hour minimum, cancellation, acceptable use, and reference implementation boundaries.

/privacy · Privacy

What this site collects and what it does not: analytics, the Hire Us form, the CoinPay sign-in cookie, and where credential data does and does not go.