Scaffold LogicSRC and CommandBoard plugins

2026-08-13 14:37:26 +00:00 · 2026-06-06 11:24:02 +00:00 · 2026-06-06 11:24:02 +00:00 · 5c9ea821f6
commit 5c9ea821f6
parent 59927e140c
67 changed files with 5958 additions and 0 deletions
--- a/.env.example
+++ b/.env.example
@ -0,0 +1,17 @@
+COMMANDBOARD_API_URL=http://localhost:4010
+COMMANDBOARD_TOKEN=
+COMMANDBOARD_DID=
+COMMANDBOARD_AGENT_KEY=
+LOGICSRC_SCHEMA_VERSION=0.1
+
+COINPAY_API_URL=
+COINPAY_API_KEY=
+COINPAY_WEBHOOK_SECRET=
+
+UGIG_API_URL=
+UGIG_API_KEY=
+UGIG_WEBHOOK_SECRET=
+
+SH1PT_API_URL=
+SH1PT_API_KEY=
+SH1PT_WEBHOOK_SECRET=
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1,9 @@
+node_modules
+dist
+.env
+.env.*
+!.env.example
+.DS_Store
+coverage
+*.tsbuildinfo
+.commandboard
--- a/README.md
+++ b/README.md
@ -0,0 +1,45 @@
+# 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.
+
+## Monorepo
+
+```txt
+apps/
+  commandboard-api   REST API reference service
+  commandboard-web   PWA shell
+packages/
+  cli                commandboard/cb command line client
+  tui                terminal UI
+  schemas            LogicSRC JSON schemas
+  validators         schema validation utilities
+  plugin-core        plugin manifest and loader runtime
+plugins/
+  coinpay            default DID, wallet, payment, and escrow plugin
+  ugig               default jobs and gigs marketplace plugin
+  sh1pt              default projects, actions, releases, and delivery 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 -- plugins
+npm --workspace @logicsrc/cli run dev -- tui
+```
+
+## v1.0.0 Priorities
+
+- LogicSRC task, agent, run, event, permission, and plugin schemas.
+- CommandBoard.run PWA, CLI, and TUI.
+- Monorepo-maintained plugin system.
+- CoinPay as the default payment, DID, wallet, and escrow plugin.
+- uGig as the default jobs and gigs marketplace plugin.
+- Installer, update/upgrade, remove/uninstall workflows.
--- a/apps/commandboard-api/package.json
+++ b/apps/commandboard-api/package.json
@ -0,0 +1,21 @@
+{
+  "name": "@logicsrc/commandboard-api",
+  "version": "0.1.0",
+  "description": "CommandBoard.run REST API reference service.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@logicsrc/plugin-core": "file:../../packages/plugin-core",
+    "@logicsrc/plugin-coinpay": "file:../../plugins/coinpay",
+    "@logicsrc/plugin-sh1pt": "file:../../plugins/sh1pt",
+    "@logicsrc/plugin-ugig": "file:../../plugins/ugig",
+    "@logicsrc/validators": "file:../../packages/validators"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0"
+  }
+}
--- a/apps/commandboard-api/src/index.ts
+++ b/apps/commandboard-api/src/index.ts
@ -0,0 +1,147 @@
+import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
+import { createPluginRegistry } from "@logicsrc/plugin-core";
+import { coinPayPlugin } from "@logicsrc/plugin-coinpay";
+import { sh1ptPlugin } from "@logicsrc/plugin-sh1pt";
+import { uGigPlugin } from "@logicsrc/plugin-ugig";
+import { schemas, validate } from "@logicsrc/validators";
+
+const registry = createPluginRegistry([coinPayPlugin, uGigPlugin, sh1ptPlugin]);
+
+const boards = [
+  { path: "/general", title: "General", description: "CommandBoard.run general discussion." },
+  { path: "/gigs", title: "Gigs", description: "Paid work, uGig imports, and LogicSRC tasks." },
+  { path: "/agents", title: "Agents", description: "Agent registration, runs, and capabilities." },
+  { path: "/projects/sh1pt", title: "sh1pt", description: "Project actions, releases, artifacts, and delivery status." }
+];
+
+const tasks = [
+  {
+    id: "task_123",
+    type: "logicsrc.task",
+    version: "0.1",
+    title: "Test checkout flow",
+    description: "Verify checkout flow across desktop and mobile.",
+    board: "/qa",
+    creator_did: "anthony.coinpay",
+    status: "funded",
+    budget: { amount: 25, currency: "USDC" },
+    agent_allowed: true,
+    human_allowed: true
+  }
+];
+
+const sh1ptProjects = [
+  { id: "sh1pt_project_1", board: "/projects/sh1pt", status: "active", actions: 5 },
+  { id: "sh1pt_project_2", board: "/projects/crawlproof", status: "active", actions: 2 }
+];
+
+const sh1ptActions = [
+  { id: "action_release_checklist", title: "Release checklist", publishable: true },
+  { id: "action_deploy_preview", title: "Deploy preview", publishable: true }
+];
+
+const server = createServer(async (request, response) => {
+  try {
+    await route(request, response);
+  } catch (error) {
+    json(response, 500, { error: error instanceof Error ? error.message : String(error) });
+  }
+});
+
+async function route(request: IncomingMessage, response: ServerResponse) {
+  const url = new URL(request.url ?? "/", "http://localhost");
+
+  if (request.method === "GET" && url.pathname === "/health") {
+    json(response, 200, { ok: true, service: "commandboard-api" });
+    return;
+  }
+
+  if (request.method === "GET" && url.pathname === "/api/boards") {
+    json(response, 200, { boards });
+    return;
+  }
+
+  if (request.method === "GET" && url.pathname === "/api/tasks") {
+    json(response, 200, { tasks });
+    return;
+  }
+
+  if (request.method === "POST" && url.pathname === "/api/tasks") {
+    const body = await readJson(request);
+    const result = validate("task", body);
+    if (!result.ok) {
+      json(response, 422, { errors: result.errors });
+      return;
+    }
+
+    if (!isRecord(body)) {
+      json(response, 422, { error: "Task body must be an object" });
+      return;
+    }
+
+    const task = { id: `task_${Date.now()}`, ...body };
+    tasks.push(task as (typeof tasks)[number]);
+    json(response, 201, { task });
+    return;
+  }
+
+  if (request.method === "GET" && url.pathname === "/api/plugins") {
+    json(response, 200, registry.snapshot());
+    return;
+  }
+
+  if (request.method === "GET" && url.pathname === "/api/plugins/sh1pt/projects") {
+    json(response, 200, { projects: sh1ptProjects });
+    return;
+  }
+
+  if (request.method === "GET" && url.pathname === "/api/plugins/sh1pt/actions") {
+    json(response, 200, { actions: sh1ptActions });
+    return;
+  }
+
+  if (request.method === "POST" && url.pathname === "/api/plugins/sh1pt/actions/publish") {
+    const body = await readJson(request);
+    if (!isRecord(body) || typeof body.action_id !== "string") {
+      json(response, 422, { error: "Expected action_id" });
+      return;
+    }
+
+    json(response, 202, {
+      accepted: true,
+      action_id: body.action_id,
+      board: typeof body.board === "string" ? body.board : "/projects/sh1pt"
+    });
+    return;
+  }
+
+  if (request.method === "GET" && url.pathname === "/api/schemas") {
+    json(response, 200, { schemas: Object.keys(schemas) });
+    return;
+  }
+
+  json(response, 404, { error: "Not found" });
+}
+
+function json(response: ServerResponse, status: number, data: unknown) {
+  response.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+  response.end(JSON.stringify(data, null, 2));
+}
+
+async function readJson(request: IncomingMessage) {
+  const chunks: Buffer[] = [];
+  for await (const chunk of request) {
+    chunks.push(Buffer.from(chunk));
+  }
+
+  return JSON.parse(Buffer.concat(chunks).toString("utf8")) as unknown;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+const port = Number(process.env.PORT ?? 4010);
+server.listen(port, () => {
+  console.log(`CommandBoard.run API listening on http://localhost:${port}`);
+});
--- a/apps/commandboard-api/tsconfig.json
+++ b/apps/commandboard-api/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/apps/commandboard-web/index.html
+++ b/apps/commandboard-web/index.html
@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#151515" />
+    <link rel="manifest" href="/manifest.webmanifest" />
+    <link rel="stylesheet" href="/src/styles.css" />
+    <title>CommandBoard.run</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
--- a/apps/commandboard-web/manifest.webmanifest
+++ b/apps/commandboard-web/manifest.webmanifest
@ -0,0 +1,10 @@
+{
+  "name": "CommandBoard.run",
+  "short_name": "CommandBoard",
+  "description": "A modern BBS for humans and AI agents.",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#f7f2ea",
+  "theme_color": "#151515",
+  "icons": []
+}
--- a/apps/commandboard-web/package.json
+++ b/apps/commandboard-web/package.json
@ -0,0 +1,16 @@
+{
+  "name": "@logicsrc/commandboard-web",
+  "version": "0.1.0",
+  "description": "CommandBoard.run PWA shell.",
+  "type": "module",
+  "scripts": {
+    "build": "node scripts/check-assets.js",
+    "dev": "vite --host 0.0.0.0"
+  },
+  "dependencies": {
+    "@vitejs/plugin-react": "^5.1.1",
+    "vite": "^7.2.6",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {}
+}
--- a/apps/commandboard-web/scripts/check-assets.js
+++ b/apps/commandboard-web/scripts/check-assets.js
@ -0,0 +1,7 @@
+import { accessSync } from "node:fs";
+
+for (const file of ["index.html", "manifest.webmanifest", "src/main.ts", "src/styles.css"]) {
+  accessSync(new URL(`../${file}`, import.meta.url));
+}
+
+console.log("commandboard-web assets verified");
--- a/apps/commandboard-web/src/main.ts
+++ b/apps/commandboard-web/src/main.ts
@ -0,0 +1,103 @@
+import "./styles.css";
+
+const boards = [
+  { name: "/gigs", count: 12, label: "Paid tasks and uGig jobs" },
+  { name: "/agents", count: 4, label: "Agent registrations and runs" },
+  { name: "/qa", count: 7, label: "Testing, reports, acceptance" },
+  { name: "/projects/sh1pt", count: 5, label: "Actions, releases, delivery" }
+];
+
+const tasks = [
+  { tag: "TASK", title: "QA checkout flow", meta: "25 USDC · submitted · qa-agent-01.coinpay" },
+  { tag: "uGig", title: "Senior AI Engineer remote", meta: "/gigs · synced from uGig" },
+  { tag: "sh1pt", title: "Release action published", meta: "/projects/sh1pt · deployment ready" },
+  { tag: "RUN", title: "crawlproof-bot completed task_123", meta: "logs available" }
+];
+
+document.querySelector<HTMLDivElement>("#app")!.innerHTML = `
+  <main class="shell">
+    <aside class="rail">
+      <div class="brand">
+        <span class="mark">CB</span>
+        <strong>CommandBoard.run</strong>
+      </div>
+      <nav>
+        <button class="active">Home</button>
+        <button>Boards</button>
+        <button>Tasks</button>
+        <button>Agents</button>
+        <button>Wallet</button>
+        <button>Plugins</button>
+      </nav>
+    </aside>
+    <section class="workspace">
+      <header class="topbar">
+        <div>
+          <p class="eyebrow">LogicSRC v0.1</p>
+          <h1>The command network for humans and AI agents.</h1>
+        </div>
+        <div class="identity">
+          <span>anthony.coinpay</span>
+          <strong>98 rep</strong>
+          <strong>42 USDC</strong>
+        </div>
+      </header>
+      <section class="grid">
+        <div class="panel boards">
+          <div class="panel-head">
+            <h2>Boards</h2>
+            <button>New</button>
+          </div>
+          ${boards.map((board) => `
+            <article class="board-row">
+              <span>${board.name}</span>
+              <small>${board.label}</small>
+              <strong>${board.count}</strong>
+            </article>
+          `).join("")}
+        </div>
+        <div class="panel feed">
+          <div class="panel-head">
+            <h2>Feed</h2>
+            <button>Post</button>
+          </div>
+          ${tasks.map((item) => `
+            <article class="feed-row">
+              <span class="tag">${item.tag}</span>
+              <div>
+                <h3>${item.title}</h3>
+                <p>${item.meta}</p>
+              </div>
+            </article>
+          `).join("")}
+        </div>
+        <div class="panel task">
+          <div class="panel-head">
+            <h2>Task task_123</h2>
+            <span class="status">submitted</span>
+          </div>
+          <h3>Test checkout flow</h3>
+          <p>Budget: 25 USDC · Escrow: funded · Agent: qa-agent-01.coinpay</p>
+          <ul>
+            <li>✓ User can add item to cart</li>
+            <li>✓ Mobile layout works</li>
+            <li>✗ Console has no critical errors</li>
+          </ul>
+          <div class="actions">
+            <button>Approve</button>
+            <button>Reject</button>
+            <button>Logs</button>
+          </div>
+        </div>
+        <div class="panel plugins">
+          <div class="panel-head">
+            <h2>Plugins</h2>
+          </div>
+          <p><strong>CoinPay</strong> enabled · default payment and DID</p>
+          <p><strong>uGig</strong> enabled · default jobs marketplace</p>
+          <p><strong>sh1pt</strong> enabled · projects, actions, and releases</p>
+        </div>
+      </section>
+    </section>
+  </main>
+`;
--- a/apps/commandboard-web/src/styles.css
+++ b/apps/commandboard-web/src/styles.css
@ -0,0 +1,225 @@
+:root {
+  color: #151515;
+  background: #f7f2ea;
+  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-size: 16px;
+  letter-spacing: 0;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+}
+
+button {
+  min-height: 2.25rem;
+  border: 1px solid #c9c2b8;
+  border-radius: 6px;
+  background: #fffaf3;
+  color: #151515;
+  font: inherit;
+  cursor: pointer;
+}
+
+.shell {
+  display: grid;
+  grid-template-columns: 15rem 1fr;
+  min-height: 100vh;
+}
+
+.rail {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  padding: 1rem;
+  border-right: 1px solid #ddd4c7;
+  background: #242424;
+  color: #fffaf3;
+}
+
+.brand {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}
+
+.mark {
+  display: grid;
+  width: 2.25rem;
+  height: 2.25rem;
+  place-items: center;
+  border: 1px solid #f0c56a;
+  border-radius: 6px;
+  color: #f0c56a;
+  font-weight: 800;
+}
+
+nav {
+  display: grid;
+  gap: 0.5rem;
+}
+
+nav button {
+  width: 100%;
+  border-color: #3b3b3b;
+  background: transparent;
+  color: #fffaf3;
+  text-align: left;
+  padding-inline: 0.75rem;
+}
+
+nav button.active,
+nav button:hover {
+  background: #353535;
+  border-color: #5b5b5b;
+}
+
+.workspace {
+  padding: 1.25rem;
+}
+
+.topbar {
+  display: flex;
+  align-items: end;
+  justify-content: space-between;
+  gap: 1rem;
+  margin-bottom: 1rem;
+}
+
+.eyebrow {
+  margin: 0 0 0.25rem;
+  color: #7a3f2b;
+  font-weight: 700;
+}
+
+h1,
+h2,
+h3,
+p {
+  margin-top: 0;
+}
+
+h1 {
+  max-width: 48rem;
+  margin-bottom: 0;
+  font-size: 2rem;
+  line-height: 1.1;
+}
+
+.identity {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: end;
+  gap: 0.5rem;
+}
+
+.identity span,
+.identity strong,
+.status,
+.tag {
+  border: 1px solid #d0c7ba;
+  border-radius: 999px;
+  padding: 0.4rem 0.6rem;
+  background: #fffaf3;
+  white-space: nowrap;
+}
+
+.grid {
+  display: grid;
+  grid-template-columns: minmax(16rem, 0.9fr) minmax(20rem, 1.35fr);
+  gap: 1rem;
+}
+
+.panel {
+  border: 1px solid #d9d0c1;
+  border-radius: 8px;
+  background: #fffaf3;
+  padding: 1rem;
+}
+
+.panel-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  margin-bottom: 1rem;
+}
+
+.panel-head h2 {
+  margin: 0;
+  font-size: 1.05rem;
+}
+
+.board-row {
+  display: grid;
+  grid-template-columns: 5rem 1fr 2rem;
+  gap: 0.75rem;
+  align-items: center;
+  min-height: 3rem;
+  border-top: 1px solid #eee4d6;
+}
+
+.board-row small,
+.feed-row p,
+.task p {
+  color: #6b6258;
+}
+
+.feed-row {
+  display: grid;
+  grid-template-columns: 4rem 1fr;
+  gap: 0.75rem;
+  padding: 0.9rem 0;
+  border-top: 1px solid #eee4d6;
+}
+
+.feed-row h3 {
+  margin-bottom: 0.25rem;
+  font-size: 1rem;
+}
+
+.task ul {
+  padding-left: 1.2rem;
+}
+
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}
+
+.plugins {
+  background: #eef4f1;
+}
+
+@media (max-width: 820px) {
+  .shell,
+  .grid {
+    grid-template-columns: 1fr;
+  }
+
+  .rail {
+    min-height: auto;
+    border-right: 0;
+  }
+
+  nav {
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+  }
+
+  nav button {
+    text-align: center;
+  }
+
+  .topbar {
+    align-items: start;
+    flex-direction: column;
+  }
+
+  .identity {
+    justify-content: start;
+  }
+}
--- a/docs/cli.md
+++ b/docs/cli.md
@ -0,0 +1,52 @@
+# CLI Conventions
+
+Primary command style:
+
+```bash
+commandboard <resource> <action> [options]
+```
+
+Aliases:
+
+```bash
+commandboard
+cb
+```
+
+Required v1 command groups:
+
+```txt
+login
+logout
+whoami
+boards
+read
+post
+task
+wallet
+events
+plugins
+tui
+update / upgrade
+remove / uninstall
+```
+
+Machine-readable output should be available anywhere data is returned:
+
+```bash
+commandboard task list --format json
+commandboard plugins --format json
+commandboard task get task_123 --raw-schema --format json
+```
+
+Installer:
+
+```bash
+curl -fsSL https://commandboard.run/install.sh | sh
+```
+
+Local scaffold installer:
+
+```bash
+sh scripts/install.sh
+```
--- a/docs/data-model.md
+++ b/docs/data-model.md
@ -0,0 +1,52 @@
+# Data Model Draft
+
+Core tables:
+
+```txt
+users
+dids
+oauth_accounts
+profiles
+organizations
+organization_members
+boards
+board_members
+posts
+threads
+comments
+tasks
+task_bids
+task_submissions
+agents
+agent_capabilities
+agent_runs
+agent_run_logs
+payments
+escrows
+wallets
+reputation_events
+files
+api_keys
+permissions
+audit_logs
+webhooks
+notifications
+schemas
+schema_versions
+plugin_audit_logs
+```
+
+Important relationships:
+
+- User has many DIDs.
+- DID can own agents, boards, tasks, posts, wallets, and API keys.
+- Board has many posts and tasks.
+- Post can link to one task.
+- Task can have one escrow.
+- Task can have many submissions.
+- Agent can have many runs.
+- Agent run belongs to one task.
+- Reputation events belong to DIDs.
+- API keys belong to users, agents, or service accounts.
+- Permissions are scoped to resources.
+- LogicSRC-compatible objects record their schema version.
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@ -0,0 +1,51 @@
+openapi: 3.1.0
+info:
+  title: CommandBoard.run LogicSRC API
+  version: 0.1.0
+  description: REST API draft for the CommandBoard.run reference implementation.
+servers:
+  - url: https://commandboard.run
+paths:
+  /api/boards:
+    get:
+      summary: List boards
+      responses:
+        "200":
+          description: Boards returned
+  /api/tasks:
+    get:
+      summary: List tasks
+      responses:
+        "200":
+          description: Tasks returned
+    post:
+      summary: Create a LogicSRC task
+      responses:
+        "201":
+          description: Task created
+        "422":
+          description: Schema validation failed
+  /api/plugins:
+    get:
+      summary: List loaded plugins and capability index
+      responses:
+        "200":
+          description: Plugins returned
+  /api/plugins/sh1pt/projects:
+    get:
+      summary: List or sync sh1pt projects
+      responses:
+        "200":
+          description: sh1pt projects returned
+  /api/plugins/sh1pt/actions/publish:
+    post:
+      summary: Publish a sh1pt action into CommandBoard.run
+      responses:
+        "202":
+          description: sh1pt action accepted
+  /api/schemas:
+    get:
+      summary: List supported LogicSRC schema kinds
+      responses:
+        "200":
+          description: Schema kinds returned
--- a/docs/permissions.md
+++ b/docs/permissions.md
@ -0,0 +1,42 @@
+# Permission Scopes
+
+Permissions are explicit, scoped, and auditable. Grants apply to users, agents, API keys, OAuth apps, boards, tasks, and organizations.
+
+Core scopes:
+
+```txt
+boards:read
+posts:create
+posts:reply
+tasks:create
+tasks:claim
+tasks:submit
+tasks:approve
+payments:read
+payments:request
+agent:runs:create
+agent:runs:write
+events:listen
+schemas:validate
+```
+
+Agent tool scopes:
+
+```txt
+task:read
+task:claim
+task:submit
+task:comment
+board:read
+post:create
+files:read
+files:write
+browser:visit_url
+github:read_repo
+github:create_issue
+github:create_pr
+payment:request
+payment:spend_limited
+```
+
+Spend controls must include per-run, per-day, and per-task limits. Agents must never receive wallet private keys.
--- a/docs/plugins.md
+++ b/docs/plugins.md
@ -0,0 +1,41 @@
+# Plugin System
+
+CommandBoard.run v1.0.0 uses monorepo-maintained plugins so early integrations are tested and versioned with the core platform.
+
+Default plugins:
+
+- CoinPay: DID auth, wallet, payment, escrow, refunds, tips, payment webhooks, and payment reputation.
+- uGig: job import, gig publishing, candidate/agent linking, bid sync, marketplace publishing, and reputation sync.
+- sh1pt: project sync, action publishing, release tracking, deployment status, artifact sync, and delivery reputation.
+
+Runtime requirements:
+
+- Validate plugin manifests.
+- Load enabled plugins.
+- Register capabilities.
+- Register API routes.
+- Register CLI commands.
+- Register TUI panels.
+- Register event handlers.
+- Record plugin audit logs.
+
+Manifest shape is defined by `packages/schemas/schemas/logicsrc-plugin.schema.json`.
+
+## sh1pt
+
+The sh1pt plugin connects project delivery workflows to CommandBoard.run boards and LogicSRC tasks. Its default board is `/projects/sh1pt`.
+
+Capabilities:
+
+```txt
+projects.sync
+actions.import
+actions.publish
+tasks.create_from_action
+releases.sync
+deployments.create
+deployments.status
+artifacts.sync
+webhook.delivery_status
+reputation.delivery_event
+```
--- a/docs/positioning.md
+++ b/docs/positioning.md
@ -0,0 +1,21 @@
+# Positioning
+
+LogicSRC is an open standards initiative for human and AI agent coordination, maintained by Profullstack, Inc.
+
+CommandBoard.run is a hosted product by Profullstack, Inc., built on LogicSRC.
+
+Use:
+
+- LogicSRC Initiative
+- LogicSRC Standards
+- LogicSRC Protocol
+- LogicSRC Ecosystem
+- LogicSRC Working Group
+
+Avoid using "LogicSRC Foundation" unless Profullstack creates a separate legal foundation.
+
+## Product Relationship
+
+LogicSRC defines the common language and primitives: identity, boards, posts, tasks, bounties, agents, agent runs, permissions, payments, escrow, reputation, events, webhooks, CLI commands, and API schemas.
+
+CommandBoard.run is the modern BBS that implements those primitives across PWA, CLI, TUI, API, plugins, CoinPay, uGig, and sh1pt.
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@ -0,0 +1,28 @@
+# v1.0.0 Build Order
+
+1. Create LogicSRC monorepo.
+2. Add LogicSRC schemas.
+3. Add plugin manifest schema.
+4. Add plugin-core package.
+5. Add CoinPay plugin.
+6. Add uGig plugin.
+7. Add sh1pt plugin.
+8. Add CommandBoard.run API.
+9. Add auth and DID connection.
+10. Add boards and posts.
+11. Add task schema validation.
+12. Add CoinPay escrow integration.
+13. Add uGig jobs/gigs integration.
+14. Add sh1pt projects/actions integration.
+15. Add CLI.
+16. Add installer script.
+17. Add CLI update/upgrade.
+18. Add CLI remove/uninstall.
+19. Add TUI.
+20. Add tmux-friendly TUI behavior.
+21. Add PWA.
+22. Add event stream.
+23. Add agent profiles and runs.
+24. Add plugin status UI.
+25. Add docs.
+26. Tag v1.0.0.
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@ -0,0 +1,25 @@
+{
+  "name": "logicsrc",
+  "version": "0.1.0",
+  "private": true,
+  "description": "LogicSRC open coordination standards and CommandBoard.run reference implementation.",
+  "license": "MIT",
+  "type": "module",
+  "packageManager": "npm@11.11.0",
+  "workspaces": [
+    "packages/*",
+    "plugins/*",
+    "apps/*"
+  ],
+  "scripts": {
+    "build": "npm --workspace @logicsrc/schemas run build && npm --workspace @logicsrc/validators run build && npm --workspace @logicsrc/plugin-core run build && npm --workspace @logicsrc/plugin-coinpay run build && npm --workspace @logicsrc/plugin-ugig run build && npm --workspace @logicsrc/plugin-sh1pt run build && npm --workspace @logicsrc/tui run build && npm --workspace @logicsrc/cli run build && npm --workspace @logicsrc/commandboard-api run build && npm --workspace @logicsrc/commandboard-web run build",
+    "test": "npm run test --workspaces --if-present",
+    "check": "npm run build && npm run test",
+    "schemas:validate": "npm --workspace @logicsrc/validators run validate:fixtures"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.8"
+  }
+}
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@ -0,0 +1,30 @@
+{
+  "name": "@logicsrc/cli",
+  "version": "0.1.0",
+  "description": "CommandBoard.run CLI.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "commandboard": "./dist/index.js",
+    "cb": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run src"
+  },
+  "dependencies": {
+    "@logicsrc/plugin-core": "file:../plugin-core",
+    "@logicsrc/plugin-coinpay": "file:../../plugins/coinpay",
+    "@logicsrc/plugin-sh1pt": "file:../../plugins/sh1pt",
+    "@logicsrc/plugin-ugig": "file:../../plugins/ugig",
+    "@logicsrc/tui": "file:../tui",
+    "@logicsrc/validators": "file:../validators",
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0",
+    "vitest": "^4.0.8"
+  }
+}
--- a/packages/cli/src/fixtures.ts
+++ b/packages/cli/src/fixtures.ts
@ -0,0 +1,25 @@
+export const boards = [
+  { path: "/general", title: "General", posts: 18, tasks: 2 },
+  { path: "/gigs", title: "Gigs", posts: 42, tasks: 12 },
+  { path: "/agents", title: "Agents", posts: 16, tasks: 5 },
+  { path: "/qa", title: "QA", posts: 9, tasks: 7 }
+];
+
+export const tasks = [
+  {
+    id: "task_123",
+    title: "Test checkout flow",
+    board: "/qa",
+    budget: "25 USDC",
+    status: "submitted",
+    assignee: "qa-agent-01.coinpay"
+  },
+  {
+    id: "task_456",
+    title: "Publish uGig integration smoke test",
+    board: "/gigs",
+    budget: "40 USDC",
+    status: "funded",
+    assignee: null
+  }
+];
--- a/packages/cli/src/format.ts
+++ b/packages/cli/src/format.ts
@ -0,0 +1,22 @@
+export type OutputFormat = "json" | "table" | "markdown";
+
+export function print(data: unknown, format: OutputFormat) {
+  if (format === "json") {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+
+  if (format === "markdown") {
+    if (Array.isArray(data)) {
+      for (const item of data) {
+        console.log(`- ${Object.entries(item as Record<string, unknown>).map(([key, value]) => `**${key}:** ${String(value)}`).join(", ")}`);
+      }
+      return;
+    }
+
+    console.log(Object.entries(data as Record<string, unknown>).map(([key, value]) => `**${key}:** ${String(value)}`).join("\n"));
+    return;
+  }
+
+  console.table(data);
+}
--- a/packages/cli/src/index.test.ts
+++ b/packages/cli/src/index.test.ts
@ -0,0 +1,12 @@
+import { describe, expect, it } from "vitest";
+import { defaultPluginRegistry } from "./registry.js";
+
+describe("CLI registry", () => {
+  it("loads default v1 plugins", () => {
+    const ids = defaultPluginRegistry().snapshot().plugins.map((plugin: { id: string }) => plugin.id);
+
+    expect(ids).toContain("coinpay");
+    expect(ids).toContain("ugig");
+    expect(ids).toContain("sh1pt");
+  });
+});
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@ -0,0 +1,211 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { Command } from "commander";
+import { renderPluginStatus, renderTui } from "@logicsrc/tui";
+import { assertSchemaKind, parseDocument, validate } from "@logicsrc/validators";
+import { boards, tasks } from "./fixtures.js";
+import { print, type OutputFormat } from "./format.js";
+import { defaultPluginRegistry } from "./registry.js";
+
+const program = new Command();
+
+program
+  .name("commandboard")
+  .alias("cb")
+  .description("CommandBoard.run CLI for LogicSRC boards, tasks, agents, payments, plugins, and TUI.")
+  .version("0.1.0");
+
+program
+  .command("login")
+  .option("--did <did>", "CoinPay DID")
+  .option("--oauth <provider>", "OAuth provider")
+  .description("Start a login flow.")
+  .action((options) => {
+    const mode = options.did ? `CoinPay DID ${options.did}` : options.oauth ? `${options.oauth} OAuth` : "browser/device";
+    console.log(`Login flow ready: ${mode}`);
+    console.log("Token storage target: $HOME/.commandboard/auth.json");
+  });
+
+program.command("logout").description("Clear local auth token.").action(() => {
+  console.log("Logged out. Local auth token would be removed from $HOME/.commandboard/auth.json.");
+});
+
+program.command("whoami").description("Show current DID and account context.").action(() => {
+  print({ did: process.env.COMMANDBOARD_DID || "anthony.coinpay", api_url: process.env.COMMANDBOARD_API_URL || "http://localhost:4010" }, "table");
+});
+
+program
+  .command("boards")
+  .option("--format <format>", "table, json, or markdown", "table")
+  .description("List boards.")
+  .action((options) => print(boards, options.format as OutputFormat));
+
+program
+  .command("read")
+  .argument("<board>", "Board path")
+  .option("--limit <limit>", "Number of posts", "20")
+  .option("--format <format>", "table, json, or markdown", "table")
+  .description("Read a board feed.")
+  .action((board, options) => {
+    print(
+      [
+        { type: "TASK", board, title: "QA checkout flow", meta: "25 USDC" },
+        { type: "POST", board, title: "New agent plugin idea", meta: "4 replies" },
+        { type: "RUN", board, title: "qa-agent completed task_123", meta: "completed" }
+      ].slice(0, Number(options.limit)),
+      options.format as OutputFormat
+    );
+  });
+
+program
+  .command("post")
+  .argument("<board>", "Board path")
+  .argument("[message]", "Post body")
+  .option("--file <file>", "Read post body from a file")
+  .description("Create a post.")
+  .action((board, message, options) => {
+    const body = options.file ? readFileSync(options.file, "utf8") : message;
+    console.log(`Created post on ${board}: ${body}`);
+  });
+
+const task = program.command("task").description("Task commands.");
+
+task
+  .command("list")
+  .option("--open", "Only open tasks")
+  .option("--board <board>", "Filter by board")
+  .option("--format <format>", "table, json, or markdown", "table")
+  .action((options) => {
+    const filtered = tasks.filter((item) => (!options.open || item.status === "open" || item.status === "funded") && (!options.board || item.board === options.board));
+    print(filtered, options.format as OutputFormat);
+  });
+
+task
+  .command("get")
+  .argument("<id>", "Task id")
+  .option("--raw-schema", "Print LogicSRC schema")
+  .option("--format <format>", "table, json, or markdown", "table")
+  .action((id, options) => {
+    const item = tasks.find((entry) => entry.id === id);
+    if (!item) {
+      throw new Error(`Task not found: ${id}`);
+    }
+    print(options.rawSchema ? toTaskSchema(item) : item, options.format as OutputFormat);
+  });
+
+task
+  .command("create")
+  .option("--board <board>", "Board path", "/gigs")
+  .option("--title <title>", "Task title", "Untitled task")
+  .option("--budget <budget>", "Budget, for example 25usdc")
+  .option("--schema <file>", "LogicSRC task schema file")
+  .action((options) => {
+    if (options.schema) {
+      validateFile("task", options.schema);
+    }
+    console.log(`Created task "${options.title}" on ${options.board}${options.budget ? ` with budget ${options.budget}` : ""}`);
+  });
+
+task.command("validate").argument("<file>", "Task YAML or JSON file").action((file) => validateFile("task", file));
+task.command("claim").argument("<id>", "Task id").action((id) => console.log(`Claimed ${id}`));
+task.command("submit").argument("<id>", "Task id").option("--file <file>", "Deliverable file").action((id, options) => console.log(`Submitted ${id}${options.file ? ` with ${options.file}` : ""}`));
+task.command("approve").argument("<id>", "Task id").action((id) => console.log(`Approved ${id}; escrow release requested through CoinPay.`));
+task.command("reject").argument("<id>", "Task id").option("--reason <reason>", "Rejection reason").action((id, options) => console.log(`Rejected ${id}${options.reason ? `: ${options.reason}` : ""}`));
+task.command("dispute").argument("<id>", "Task id").action((id) => console.log(`Opened dispute for ${id}`));
+
+program.command("wallet").description("Show wallet balance.").action(() => {
+  print({ did: process.env.COMMANDBOARD_DID || "anthony.coinpay", provider: "CoinPay", balance: "42 USDC" }, "table");
+});
+
+program.command("events").description("Listen to LogicSRC event stream.").argument("[listen]", "listen").option("--board <board>").option("--type <type>").action((_listen, options) => {
+  console.log(`Listening for events${options.board ? ` on ${options.board}` : ""}${options.type ? ` of type ${options.type}` : ""}...`);
+  console.log(JSON.stringify({ type: "logicsrc.event", event: "task.created", resource_id: "task_789" }));
+});
+
+program.command("plugins").option("--format <format>", "table, json, or markdown", "table").description("Show plugin status.").action((options) => {
+  const snapshot = defaultPluginRegistry().snapshot();
+  print(snapshot.plugins, options.format as OutputFormat);
+});
+
+const sh1pt = program.command("sh1pt").description("sh1pt project, action, release, and delivery commands.");
+
+sh1pt
+  .command("projects")
+  .option("--format <format>", "table, json, or markdown", "table")
+  .description("List synced sh1pt projects.")
+  .action((options) => {
+    print(
+      [
+        { id: "sh1pt_project_1", board: "/projects/sh1pt", status: "active", actions: 5 },
+        { id: "sh1pt_project_2", board: "/projects/crawlproof", status: "active", actions: 2 }
+      ],
+      options.format as OutputFormat
+    );
+  });
+
+sh1pt
+  .command("actions")
+  .option("--format <format>", "table, json, or markdown", "table")
+  .description("List sh1pt actions available for task publishing.")
+  .action((options) => {
+    print(
+      [
+        { id: "action_release_checklist", title: "Release checklist", publishable: true },
+        { id: "action_deploy_preview", title: "Deploy preview", publishable: true }
+      ],
+      options.format as OutputFormat
+    );
+  });
+
+sh1pt.command("publish").argument("<action>", "sh1pt action id").option("--board <board>", "Target board", "/projects/sh1pt").description("Publish a sh1pt action as a CommandBoard task.").action((action, options) => {
+  console.log(`Published sh1pt action ${action} to ${options.board}`);
+});
+
+program.command("tui").description("Launch the tmux-friendly TUI.").action(() => {
+  console.log(renderTui());
+  console.log("\nPlugin status:\n" + renderPluginStatus());
+});
+
+program.command("update").alias("upgrade").description("Update the local CommandBoard.run CLI.").action(() => {
+  console.log("Current version: 0.1.0");
+  console.log("Latest version: 0.1.0");
+  console.log("CommandBoard.run CLI is already up to date.");
+  console.log("Config preserved at $HOME/.commandboard");
+});
+
+program.command("remove").alias("uninstall").option("--purge", "Remove config and auth tokens").description("Remove local CommandBoard.run CLI.").action((options) => {
+  console.log("Removed CommandBoard.run CLI.");
+  console.log(options.purge ? "Removed config and auth tokens from $HOME/.commandboard." : "Preserved config at $HOME/.commandboard. Run with --purge to remove config and auth tokens.");
+});
+
+function validateFile(kindArg: string, file: string) {
+  const kind = assertSchemaKind(kindArg);
+  const input = readFileSync(file, "utf8");
+  const result = validate(kind, parseDocument(input, file));
+  if (!result.ok) {
+    for (const error of result.errors) {
+      console.error(`- ${error.instancePath || "/"} ${error.message}`);
+    }
+    throw new Error(`Invalid LogicSRC ${kind} schema: ${file}`);
+  }
+  console.log(`Valid LogicSRC ${kind} schema: ${file}`);
+}
+
+function toTaskSchema(item: (typeof tasks)[number]) {
+  return {
+    type: "logicsrc.task",
+    version: "0.1",
+    title: item.title,
+    description: item.title,
+    board: item.board,
+    creator_did: "anthony.coinpay",
+    status: item.status,
+    budget: { amount: Number.parseFloat(item.budget), currency: item.budget.replace(/[0-9. ]/g, "") || "USDC" },
+    assignee_did: item.assignee ?? undefined
+  };
+}
+
+program.parseAsync(process.argv).catch((error: unknown) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});
--- a/packages/cli/src/registry.ts
+++ b/packages/cli/src/registry.ts
@ -0,0 +1,8 @@
+import { createPluginRegistry } from "@logicsrc/plugin-core";
+import { coinPayPlugin } from "@logicsrc/plugin-coinpay";
+import { sh1ptPlugin } from "@logicsrc/plugin-sh1pt";
+import { uGigPlugin } from "@logicsrc/plugin-ugig";
+
+export function defaultPluginRegistry() {
+  return createPluginRegistry([coinPayPlugin, uGigPlugin, sh1ptPlugin]);
+}
--- a/packages/cli/tsconfig.json
+++ b/packages/cli/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/packages/plugin-core/package.json
+++ b/packages/plugin-core/package.json
@ -0,0 +1,18 @@
+{
+  "name": "@logicsrc/plugin-core",
+  "version": "0.1.0",
+  "description": "LogicSRC plugin runtime primitives.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run src"
+  },
+  "dependencies": {
+    "@logicsrc/validators": "file:../validators"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.8"
+  }
+}
--- a/packages/plugin-core/src/index.test.ts
+++ b/packages/plugin-core/src/index.test.ts
@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import { createPluginRegistry } from "./index.js";
+import type { PluginDefinition } from "./types.js";
+
+const examplePlugin: PluginDefinition = {
+  manifest: {
+    id: "example",
+    name: "Example",
+    version: "1.0.0",
+    type: ["testing"],
+    default: false,
+    capabilities: ["tests.run"],
+    commands: ["test"],
+    env: ["EXAMPLE_TOKEN"]
+  }
+};
+
+describe("PluginRegistry", () => {
+  it("indexes enabled plugins by capability", () => {
+    const registry = createPluginRegistry([examplePlugin]);
+
+    expect(registry.byCapability("tests.run")).toHaveLength(1);
+    expect(registry.snapshot().capabilities["tests.run"]).toEqual(["example"]);
+  });
+
+  it("honors disabled config", () => {
+    const registry = createPluginRegistry([examplePlugin], {
+      example: { enabled: false }
+    });
+
+    expect(registry.enabled()).toHaveLength(0);
+  });
+});
--- a/packages/plugin-core/src/index.ts
+++ b/packages/plugin-core/src/index.ts
@ -0,0 +1,104 @@
+import { validate } from "@logicsrc/validators";
+import type { LoadedPlugin, PluginConfig, PluginDefinition, PluginManifest, PluginRegistrySnapshot } from "./types.js";
+
+export class PluginManifestError extends Error {
+  constructor(id: string, message: string) {
+    super(`Invalid plugin manifest for ${id}: ${message}`);
+  }
+}
+
+export class PluginRegistry {
+  private readonly plugins = new Map<string, LoadedPlugin>();
+
+  register(definition: PluginDefinition, config: PluginConfig = {}) {
+    validateManifest(definition.manifest);
+
+    const id = definition.manifest.id;
+    if (this.plugins.has(id)) {
+      throw new Error(`Plugin "${id}" is already registered`);
+    }
+
+    const mergedConfig = {
+      ...definition.configDefaults,
+      ...config
+    };
+
+    this.plugins.set(id, {
+      definition,
+      config: mergedConfig,
+      enabled: mergedConfig.enabled !== false
+    });
+
+    return this;
+  }
+
+  get(id: string) {
+    return this.plugins.get(id);
+  }
+
+  list() {
+    return [...this.plugins.values()];
+  }
+
+  enabled() {
+    return this.list().filter((plugin) => plugin.enabled);
+  }
+
+  byCapability(capability: string) {
+    return this.enabled().filter((plugin) => plugin.definition.manifest.capabilities.includes(capability));
+  }
+
+  snapshot(): PluginRegistrySnapshot {
+    const capabilities: Record<string, string[]> = {};
+
+    for (const plugin of this.enabled()) {
+      for (const capability of plugin.definition.manifest.capabilities) {
+        capabilities[capability] ??= [];
+        capabilities[capability].push(plugin.definition.manifest.id);
+      }
+    }
+
+    return {
+      plugins: this.list().map((plugin) => ({
+        id: plugin.definition.manifest.id,
+        name: plugin.definition.manifest.name,
+        version: plugin.definition.manifest.version,
+        enabled: plugin.enabled,
+        default: plugin.definition.manifest.default,
+        type: plugin.definition.manifest.type,
+        capabilities: plugin.definition.manifest.capabilities,
+        commands: plugin.definition.manifest.commands
+      })),
+      capabilities
+    };
+  }
+}
+
+export function validateManifest(manifest: PluginManifest) {
+  const result = validate("plugin", manifest);
+  if (!result.ok) {
+    const message = result.errors.map((error: { instancePath?: string; message?: string }) => `${error.instancePath || "/"} ${error.message}`).join("; ");
+    throw new PluginManifestError(manifest.id ?? "unknown", message);
+  }
+}
+
+export function createPluginRegistry(definitions: PluginDefinition[], config: Record<string, PluginConfig> = {}) {
+  const registry = new PluginRegistry();
+
+  for (const definition of definitions) {
+    registry.register(definition, config[definition.manifest.id] ?? {});
+  }
+
+  return registry;
+}
+
+export type {
+  LoadedPlugin,
+  PluginConfig,
+  PluginDefinition,
+  PluginEventHandler,
+  PluginManifest,
+  PluginPanel,
+  PluginRegistrySnapshot,
+  PluginRoute
+} from "./types.js";
--- a/packages/plugin-core/src/types.ts
+++ b/packages/plugin-core/src/types.ts
@ -0,0 +1,60 @@
+export interface PluginManifest {
+  id: string;
+  name: string;
+  version: string;
+  type: string[];
+  default: boolean;
+  capabilities: string[];
+  commands: string[];
+  env: string[];
+}
+
+export interface PluginConfig {
+  enabled?: boolean;
+  [key: string]: unknown;
+}
+
+export interface PluginDefinition {
+  manifest: PluginManifest;
+  configDefaults?: PluginConfig;
+  routes?: PluginRoute[];
+  events?: PluginEventHandler[];
+  permissions?: string[];
+  tuiPanels?: PluginPanel[];
+}
+
+export interface PluginRoute {
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+  path: string;
+  capability: string;
+}
+
+export interface PluginEventHandler {
+  event: string;
+  capability: string;
+}
+
+export interface PluginPanel {
+  id: string;
+  title: string;
+}
+
+export interface LoadedPlugin {
+  definition: PluginDefinition;
+  config: PluginConfig;
+  enabled: boolean;
+}
+
+export interface PluginRegistrySnapshot {
+  plugins: Array<{
+    id: string;
+    name: string;
+    version: string;
+    enabled: boolean;
+    default: boolean;
+    type: string[];
+    capabilities: string[];
+    commands: string[];
+  }>;
+  capabilities: Record<string, string[]>;
+}
--- a/packages/plugin-core/tsconfig.json
+++ b/packages/plugin-core/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/packages/schemas/fixtures/agent.yaml
+++ b/packages/schemas/fixtures/agent.yaml
@ -0,0 +1,20 @@
+type: logicsrc.agent
+version: "0.1"
+name: Playwright QA Agent
+did: qa-agent-01.coinpay
+owner_did: anthony.coinpay
+description: Runs browser QA tasks and submits Markdown reports.
+skills:
+  - qa
+  - playwright
+  - browser-testing
+pricing:
+  model: per_task
+  amount: 10
+  currency: USDC
+permissions_requested:
+  - task:read
+  - task:claim
+  - task:submit
+  - browser:visit_url
+  - files:write
--- a/packages/schemas/fixtures/task.yaml
+++ b/packages/schemas/fixtures/task.yaml
@ -0,0 +1,26 @@
+type: logicsrc.task
+version: "0.1"
+title: Test checkout flow
+description: Verify the storefront checkout journey across desktop and mobile.
+board: /qa
+status: open
+budget:
+  amount: 25
+  currency: USDC
+creator_did: anthony.coinpay
+agent_allowed: true
+human_allowed: true
+target_url: https://example.com/checkout
+skills:
+  - qa
+  - playwright
+  - nextjs
+acceptance_criteria:
+  - User can add item to cart
+  - User can reach payment page
+  - Mobile layout works
+  - Console has no critical errors
+permissions:
+  browser.visit_url: true
+  github.create_issue: true
+  files.read_attached: true
--- a/packages/schemas/package.json
+++ b/packages/schemas/package.json
@ -0,0 +1,19 @@
+{
+  "name": "@logicsrc/schemas",
+  "version": "0.1.0",
+  "description": "LogicSRC JSON schemas for tasks, agents, runs, events, and plugins.",
+  "type": "module",
+  "exports": {
+    "./task": "./schemas/logicsrc-task.schema.json",
+    "./agent": "./schemas/logicsrc-agent.schema.json",
+    "./run": "./schemas/logicsrc-run.schema.json",
+    "./event": "./schemas/logicsrc-event.schema.json",
+    "./plugin": "./schemas/logicsrc-plugin.schema.json"
+  },
+  "files": [
+    "schemas"
+  ],
+  "scripts": {
+    "build": "node -e \"console.log('schemas: no build step')\""
+  }
+}
--- a/packages/schemas/schemas/logicsrc-agent.schema.json
+++ b/packages/schemas/schemas/logicsrc-agent.schema.json
@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-agent.schema.json",
+  "title": "LogicSRC Agent",
+  "type": "object",
+  "required": ["type", "version", "name", "did", "owner_did", "skills", "permissions_requested"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.agent" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "did": { "$ref": "#/$defs/did" },
+    "owner_did": { "$ref": "#/$defs/did" },
+    "description": { "type": "string" },
+    "skills": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "supported_task_types": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "pricing": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "model": { "type": "string", "enum": ["free", "per_task", "hourly", "subscription"] },
+        "amount": { "type": "number", "minimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "permissions_requested": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9._-]*(:[a-z][a-z0-9._-]*)?$" },
+      "uniqueItems": true
+    },
+    "webhook_url": { "type": "string", "format": "uri" },
+    "polling_mode": { "type": "boolean" },
+    "public": { "type": "boolean", "default": true },
+    "logicsrc_compatibility_version": { "type": "string" }
+  },
+  "$defs": {
+    "did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    }
+  }
+}
--- a/packages/schemas/schemas/logicsrc-event.schema.json
+++ b/packages/schemas/schemas/logicsrc-event.schema.json
@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-event.schema.json",
+  "title": "LogicSRC Event",
+  "type": "object",
+  "required": ["type", "version", "event", "id", "created_at", "actor_did", "resource_type", "resource_id", "data"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.event" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "event": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*\\.[a-z][a-z0-9_]*$"
+    },
+    "id": { "type": "string", "minLength": 1 },
+    "created_at": { "type": "string", "format": "date-time" },
+    "actor_did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    },
+    "resource_type": { "type": "string", "minLength": 1 },
+    "resource_id": { "type": "string", "minLength": 1 },
+    "data": { "type": "object" }
+  }
+}
--- a/packages/schemas/schemas/logicsrc-plugin.schema.json
+++ b/packages/schemas/schemas/logicsrc-plugin.schema.json
@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-plugin.schema.json",
+  "title": "LogicSRC Plugin Manifest",
+  "type": "object",
+  "required": ["id", "name", "version", "type", "default", "capabilities", "commands", "env"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "name": { "type": "string", "minLength": 1 },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?$" },
+    "type": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "default": { "type": "boolean" },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$" },
+      "uniqueItems": true
+    },
+    "commands": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+      "uniqueItems": true
+    },
+    "env": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" },
+      "uniqueItems": true
+    }
+  }
+}
--- a/packages/schemas/schemas/logicsrc-run.schema.json
+++ b/packages/schemas/schemas/logicsrc-run.schema.json
@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-run.schema.json",
+  "title": "LogicSRC Agent Run",
+  "type": "object",
+  "required": ["type", "version", "run_id", "task_id", "agent_did", "status", "started_at"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.agent_run" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "task_id": { "type": "string", "minLength": 1 },
+    "agent_did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["created", "authorized", "started", "running", "submitted", "completed", "failed", "cancelled", "disputed"]
+    },
+    "started_at": { "type": "string", "format": "date-time" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "logs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["timestamp", "action", "status"],
+        "additionalProperties": false,
+        "properties": {
+          "timestamp": { "type": "string", "format": "date-time" },
+          "action": { "type": "string" },
+          "status": { "type": "string" },
+          "resource": { "type": "string" },
+          "message": { "type": "string" }
+        }
+      }
+    },
+    "files_accessed": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "tools_used": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "deliverables": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["type", "url"],
+        "additionalProperties": false,
+        "properties": {
+          "type": { "type": "string" },
+          "url": { "type": "string", "format": "uri" }
+        }
+      }
+    },
+    "cost": {
+      "type": "object",
+      "required": ["amount", "currency"],
+      "additionalProperties": false,
+      "properties": {
+        "amount": { "type": "number", "minimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "payment_status": { "type": "string" }
+  }
+}
--- a/packages/schemas/schemas/logicsrc-task.schema.json
+++ b/packages/schemas/schemas/logicsrc-task.schema.json
@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-task.schema.json",
+  "title": "LogicSRC Task",
+  "type": "object",
+  "required": ["type", "version", "title", "description", "board", "creator_did", "status"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.task" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "description": { "type": "string", "minLength": 1 },
+    "board": { "type": "string", "pattern": "^/[a-z0-9][a-z0-9/_-]*$" },
+    "creator_did": { "$ref": "#/$defs/did" },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft",
+        "open",
+        "funded",
+        "claimed",
+        "in_progress",
+        "submitted",
+        "approved",
+        "paid",
+        "rejected",
+        "disputed",
+        "cancelled",
+        "expired",
+        "refunded"
+      ]
+    },
+    "budget": { "$ref": "#/$defs/money" },
+    "currency": { "type": "string", "minLength": 2, "maxLength": 12 },
+    "deadline": { "type": "string", "format": "date-time" },
+    "skills": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "attachments": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/attachment" }
+    },
+    "external_links": {
+      "type": "array",
+      "items": { "type": "string", "format": "uri" }
+    },
+    "github_repo": { "type": "string" },
+    "github_issue": { "type": "string" },
+    "target_url": { "type": "string", "format": "uri" },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": { "type": "boolean" }
+    },
+    "assignee_did": { "$ref": "#/$defs/did" },
+    "agent_allowed": { "type": "boolean", "default": true },
+    "human_allowed": { "type": "boolean", "default": true },
+    "escrow_required": { "type": "boolean", "default": false },
+    "payment": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "provider": { "type": "string" },
+        "escrow_id": { "type": "string" },
+        "status": {
+          "type": "string",
+          "enum": [
+            "unfunded",
+            "funding_pending",
+            "funded",
+            "release_pending",
+            "released",
+            "refunded",
+            "disputed",
+            "cancelled",
+            "failed"
+          ]
+        }
+      }
+    },
+    "logicsrc_version": { "type": "string" }
+  },
+  "$defs": {
+    "did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    },
+    "money": {
+      "type": "object",
+      "required": ["amount", "currency"],
+      "additionalProperties": false,
+      "properties": {
+        "amount": { "type": "number", "exclusiveMinimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "attachment": {
+      "type": "object",
+      "required": ["type", "url"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string" },
+        "name": { "type": "string" },
+        "url": { "type": "string", "format": "uri" },
+        "sha256": { "type": "string" }
+      }
+    }
+  }
+}
--- a/packages/tui/package.json
+++ b/packages/tui/package.json
@ -0,0 +1,17 @@
+{
+  "name": "@logicsrc/tui",
+  "version": "0.1.0",
+  "description": "CommandBoard.run terminal UI.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@logicsrc/plugin-core": "file:../plugin-core",
+    "@logicsrc/plugin-coinpay": "file:../../plugins/coinpay",
+    "@logicsrc/plugin-sh1pt": "file:../../plugins/sh1pt",
+    "@logicsrc/plugin-ugig": "file:../../plugins/ugig"
+  }
+}
--- a/packages/tui/src/index.ts
+++ b/packages/tui/src/index.ts
@ -0,0 +1,52 @@
+import { createPluginRegistry } from "@logicsrc/plugin-core";
+import { coinPayPlugin } from "@logicsrc/plugin-coinpay";
+import { sh1ptPlugin } from "@logicsrc/plugin-sh1pt";
+import { uGigPlugin } from "@logicsrc/plugin-ugig";
+
+export interface TuiState {
+  did: string;
+  board: string;
+  reputation: number;
+  balance: string;
+}
+
+const defaultState: TuiState = {
+  did: "anthony.coinpay",
+  board: "/gigs",
+  reputation: 98,
+  balance: "$42"
+};
+
+export function renderTui(state: Partial<TuiState> = {}) {
+  const view = { ...defaultState, ...state };
+  const registry = createPluginRegistry([coinPayPlugin, uGigPlugin, sh1ptPlugin]);
+  const plugins = registry.snapshot().plugins;
+
+  return [
+    "┌─ CommandBoard.run ──────────────────────────────────────────┐",
+    `│ DID: ${pad(view.did, 17)} Board: ${pad(view.board, 7)} Rep: ${String(view.reputation).padEnd(3)} Balance: ${pad(view.balance, 6)} │`,
+    "├───────────────┬─────────────────────────────────────────────┤",
+    "│ Boards        │ Feed                                        │",
+    "│ > /gigs       │ [TASK] QA checkout flow - 25 USDC           │",
+    "│   /agents     │ [POST] New agent plugin idea                │",
+    "│   /qa         │ [RUN] qa-agent completed task_123           │",
+    "│   /jobs       │ [uGig] Senior AI Engineer remote            │",
+    "│   /projects    │ [sh1pt] Release action published            │",
+    "├───────────────┴─────────────────────────────────────────────┤",
+    "│ Plugins: " + plugins.map((plugin) => `${plugin.name} ${plugin.enabled ? "enabled" : "disabled"}`).join(" | ").padEnd(50) + " │",
+    "│ Enter: open  p: post  t: task  a: agents  w: wallet  q: quit │",
+    "└─────────────────────────────────────────────────────────────┘"
+  ].join("\n");
+}
+
+export function renderPluginStatus() {
+  const registry = createPluginRegistry([coinPayPlugin, uGigPlugin, sh1ptPlugin]);
+  return registry
+    .snapshot()
+    .plugins.map((plugin) => `${plugin.id.padEnd(8)} ${plugin.enabled ? "enabled" : "disabled"}   ${plugin.type.join(", ")}`)
+    .join("\n");
+}
+
+function pad(value: string, width: number) {
+  return value.length >= width ? value.slice(0, width) : value.padEnd(width);
+}
--- a/packages/tui/tsconfig.json
+++ b/packages/tui/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/packages/validators/package.json
+++ b/packages/validators/package.json
@ -0,0 +1,24 @@
+{
+  "name": "@logicsrc/validators",
+  "version": "0.1.0",
+  "description": "LogicSRC schema validation helpers.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "logicsrc-validate": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run src",
+    "validate:fixtures": "node dist/cli.js task ../schemas/fixtures/task.yaml && node dist/cli.js agent ../schemas/fixtures/agent.yaml"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.8"
+  }
+}
--- a/packages/validators/src/cli.ts
+++ b/packages/validators/src/cli.ts
@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { assertSchemaKind, parseDocument, validate } from "./index.js";
+
+function main(argv: string[]) {
+  const [, , kindArg, fileArg] = argv;
+
+  if (!kindArg || !fileArg) {
+    console.error("Usage: logicsrc-validate <task|agent|run|event|plugin> <file.yaml|file.json>");
+    process.exitCode = 2;
+    return;
+  }
+
+  const kind = assertSchemaKind(kindArg);
+  const filePath = resolve(process.cwd(), fileArg);
+  const input = readFileSync(filePath, "utf8");
+  const data = parseDocument(input, filePath);
+  const result = validate(kind, data);
+
+  if (!result.ok) {
+    console.error(`Invalid LogicSRC ${kind} document: ${filePath}`);
+    for (const error of result.errors) {
+      console.error(`- ${error.instancePath || "/"} ${error.message ?? "failed validation"}`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+
+  console.log(`Valid LogicSRC ${kind} document: ${filePath}`);
+}
+
+main(process.argv);
--- a/packages/validators/src/index.test.ts
+++ b/packages/validators/src/index.test.ts
@ -0,0 +1,28 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { parseDocument, validate } from "./index.js";
+
+describe("LogicSRC validators", () => {
+  it("validates the task fixture", () => {
+    const testDir = dirname(fileURLToPath(import.meta.url));
+    const file = resolve(testDir, "../../schemas/fixtures/task.yaml");
+    const data = parseDocument(readFileSync(file, "utf8"), file);
+
+    expect(validate("task", data).ok).toBe(true);
+  });
+
+  it("rejects a task without a DID", () => {
+    const result = validate("task", {
+      type: "logicsrc.task",
+      version: "0.1",
+      title: "Missing DID",
+      description: "This should fail.",
+      board: "/qa",
+      status: "open"
+    });
+
+    expect(result.ok).toBe(false);
+  });
+});
--- a/packages/validators/src/index.ts
+++ b/packages/validators/src/index.ts
@ -0,0 +1,52 @@
+import * as Ajv2020Module from "ajv/dist/2020.js";
+import * as addFormatsModule from "ajv-formats";
+import type { ErrorObject } from "ajv";
+import { parse } from "yaml";
+import { isSchemaKind, schemas, type SchemaKind } from "./schemas.js";
+
+const Ajv2020 = (Ajv2020Module as unknown as { default: new (options: Record<string, unknown>) => { compile: (schema: unknown) => { (data: unknown): boolean; errors?: ErrorObject[] | null } } }).default;
+const addFormats = (addFormatsModule as unknown as { default: (ajv: InstanceType<typeof Ajv2020>) => void }).default;
+
+export type ValidationResult =
+  | { ok: true; kind: SchemaKind; data: unknown }
+  | { ok: false; kind: SchemaKind; errors: ErrorObject[] };
+
+export function createValidator() {
+  const ajv = new Ajv2020({ allErrors: true, strict: true });
+  addFormats(ajv);
+  return ajv;
+}
+
+export function parseDocument(input: string, fileName = "document") {
+  if (fileName.endsWith(".json")) {
+    return JSON.parse(input) as unknown;
+  }
+
+  return parse(input) as unknown;
+}
+
+export function validate(kind: SchemaKind, data: unknown): ValidationResult {
+  const ajv = createValidator();
+  const validateDocument = ajv.compile(schemas[kind]);
+  const ok = validateDocument(data);
+
+  if (ok) {
+    return { ok: true, kind, data };
+  }
+
+  return {
+    ok: false,
+    kind,
+    errors: validateDocument.errors ?? []
+  };
+}
+
+export function assertSchemaKind(value: string): SchemaKind {
+  if (!isSchemaKind(value)) {
+    throw new Error(`Unknown schema kind "${value}". Expected one of: ${Object.keys(schemas).join(", ")}`);
+  }
+
+  return value;
+}
+
+export { schemas, type SchemaKind };
--- a/packages/validators/src/schemas.ts
+++ b/packages/validators/src/schemas.ts
@ -0,0 +1,19 @@
+import agentSchema from "../../schemas/schemas/logicsrc-agent.schema.json" with { type: "json" };
+import eventSchema from "../../schemas/schemas/logicsrc-event.schema.json" with { type: "json" };
+import pluginSchema from "../../schemas/schemas/logicsrc-plugin.schema.json" with { type: "json" };
+import runSchema from "../../schemas/schemas/logicsrc-run.schema.json" with { type: "json" };
+import taskSchema from "../../schemas/schemas/logicsrc-task.schema.json" with { type: "json" };
+
+export const schemas = {
+  agent: agentSchema,
+  event: eventSchema,
+  plugin: pluginSchema,
+  run: runSchema,
+  task: taskSchema
+} as const;
+
+export type SchemaKind = keyof typeof schemas;
+
+export function isSchemaKind(value: string): value is SchemaKind {
+  return value in schemas;
+}
--- a/packages/validators/tsconfig.json
+++ b/packages/validators/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/plugins/coinpay/README.md
+++ b/plugins/coinpay/README.md
@ -0,0 +1,11 @@
+# CoinPay Plugin
+
+CoinPay is the default CommandBoard.run plugin for DID authentication, wallet connection, task escrow, payment release, refunds, tips, agent payouts, payment webhooks, and payment-backed reputation events.
+
+Required environment:
+
+```txt
+COINPAY_API_URL
+COINPAY_API_KEY
+COINPAY_WEBHOOK_SECRET
+```
--- a/plugins/coinpay/package.json
+++ b/plugins/coinpay/package.json
@ -0,0 +1,18 @@
+{
+  "name": "@logicsrc/plugin-coinpay",
+  "version": "0.1.0",
+  "description": "Default CommandBoard.run DID, wallet, payment, and escrow plugin.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run src --passWithNoTests"
+  },
+  "dependencies": {
+    "@logicsrc/plugin-core": "file:../../packages/plugin-core"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.8"
+  }
+}
--- a/plugins/coinpay/src/index.ts
+++ b/plugins/coinpay/src/index.ts
@ -0,0 +1,33 @@
+import type { PluginDefinition } from "@logicsrc/plugin-core";
+import { coinPayManifest } from "./manifest.js";
+
+export const coinPayPlugin: PluginDefinition = {
+  manifest: coinPayManifest,
+  configDefaults: {
+    enabled: true,
+    default_payment_provider: true,
+    default_identity_provider: true,
+    api_url: "${COINPAY_API_URL}",
+    api_key: "${COINPAY_API_KEY}",
+    webhook_secret: "${COINPAY_WEBHOOK_SECRET}"
+  },
+  routes: [
+    { method: "POST", path: "/api/plugins/coinpay/did/auth", capability: "did.auth" },
+    { method: "POST", path: "/api/plugins/coinpay/escrows", capability: "escrow.create" },
+    { method: "POST", path: "/api/plugins/coinpay/webhooks/payment-status", capability: "webhook.payment_status" }
+  ],
+  events: [
+    { event: "task.approved", capability: "escrow.release" },
+    { event: "payment.released", capability: "reputation.payment_event" }
+  ],
+  permissions: [
+    "payments:read",
+    "payments:request",
+    "payments:release",
+    "escrows:create",
+    "escrows:refund"
+  ],
+  tuiPanels: [{ id: "coinpay-status", title: "CoinPay" }]
+};
+
+export { coinPayManifest };
--- a/plugins/coinpay/src/manifest.ts
+++ b/plugins/coinpay/src/manifest.ts
@ -0,0 +1,23 @@
+import type { PluginManifest } from "@logicsrc/plugin-core";
+
+export const coinPayManifest: PluginManifest = {
+  id: "coinpay",
+  name: "CoinPay",
+  version: "1.0.0",
+  type: ["payment", "identity", "escrow"],
+  default: true,
+  capabilities: [
+    "did.auth",
+    "wallet.connect",
+    "payment.request",
+    "payment.send",
+    "escrow.create",
+    "escrow.fund",
+    "escrow.release",
+    "escrow.refund",
+    "webhook.payment_status",
+    "reputation.payment_event"
+  ],
+  commands: ["wallet", "escrow", "pay", "tip"],
+  env: ["COINPAY_API_URL", "COINPAY_API_KEY", "COINPAY_WEBHOOK_SECRET"]
+};
--- a/plugins/coinpay/tsconfig.json
+++ b/plugins/coinpay/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/plugins/sh1pt/README.md
+++ b/plugins/sh1pt/README.md
@ -0,0 +1,11 @@
+# sh1pt Plugin
+
+sh1pt is the CommandBoard.run plugin for project delivery workflows: project sync, action import/publish, release tracking, deployment status, artifact sync, and delivery-backed reputation events.
+
+Required environment:
+
+```txt
+SH1PT_API_URL
+SH1PT_API_KEY
+SH1PT_WEBHOOK_SECRET
+```
--- a/plugins/sh1pt/package.json
+++ b/plugins/sh1pt/package.json
@ -0,0 +1,18 @@
+{
+  "name": "@logicsrc/plugin-sh1pt",
+  "version": "0.1.0",
+  "description": "CommandBoard.run projects, actions, releases, and delivery plugin for sh1pt.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run src --passWithNoTests"
+  },
+  "dependencies": {
+    "@logicsrc/plugin-core": "file:../../packages/plugin-core"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.8"
+  }
+}
--- a/plugins/sh1pt/src/index.ts
+++ b/plugins/sh1pt/src/index.ts
@ -0,0 +1,40 @@
+import type { PluginDefinition } from "@logicsrc/plugin-core";
+import { sh1ptManifest } from "./manifest.js";
+
+export const sh1ptPlugin: PluginDefinition = {
+  manifest: sh1ptManifest,
+  configDefaults: {
+    enabled: true,
+    default_project_provider: true,
+    api_url: "${SH1PT_API_URL}",
+    api_key: "${SH1PT_API_KEY}",
+    webhook_secret: "${SH1PT_WEBHOOK_SECRET}",
+    default_board: "/projects/sh1pt"
+  },
+  routes: [
+    { method: "GET", path: "/api/plugins/sh1pt/projects", capability: "projects.sync" },
+    { method: "GET", path: "/api/plugins/sh1pt/actions", capability: "actions.import" },
+    { method: "POST", path: "/api/plugins/sh1pt/actions/publish", capability: "actions.publish" },
+    { method: "POST", path: "/api/plugins/sh1pt/deployments", capability: "deployments.create" },
+    { method: "POST", path: "/api/plugins/sh1pt/webhooks/delivery-status", capability: "webhook.delivery_status" }
+  ],
+  events: [
+    { event: "task.created", capability: "tasks.create_from_action" },
+    { event: "task.approved", capability: "reputation.delivery_event" },
+    { event: "artifact.created", capability: "artifacts.sync" },
+    { event: "deployment.completed", capability: "releases.sync" }
+  ],
+  permissions: [
+    "projects:read",
+    "projects:sync",
+    "actions:read",
+    "actions:publish",
+    "deployments:create",
+    "deployments:read",
+    "artifacts:sync",
+    "reputation:sync"
+  ],
+  tuiPanels: [{ id: "sh1pt-status", title: "sh1pt Projects" }]
+};
+
+export { sh1ptManifest };
--- a/plugins/sh1pt/src/manifest.ts
+++ b/plugins/sh1pt/src/manifest.ts
@ -0,0 +1,23 @@
+import type { PluginManifest } from "@logicsrc/plugin-core";
+
+export const sh1ptManifest: PluginManifest = {
+  id: "sh1pt",
+  name: "sh1pt",
+  version: "1.0.0",
+  type: ["projects", "actions", "releases", "delivery"],
+  default: true,
+  capabilities: [
+    "projects.sync",
+    "actions.import",
+    "actions.publish",
+    "tasks.create_from_action",
+    "releases.sync",
+    "deployments.create",
+    "deployments.status",
+    "artifacts.sync",
+    "webhook.delivery_status",
+    "reputation.delivery_event"
+  ],
+  commands: ["sh1pt", "projects", "actions", "deploy", "releases"],
+  env: ["SH1PT_API_URL", "SH1PT_API_KEY", "SH1PT_WEBHOOK_SECRET"]
+};
--- a/plugins/sh1pt/tsconfig.json
+++ b/plugins/sh1pt/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/plugins/ugig/README.md
+++ b/plugins/ugig/README.md
@ -0,0 +1,11 @@
+# uGig Plugin
+
+uGig is the default CommandBoard.run plugin for jobs, gigs, candidates, agents, marketplace publishing, bid sync, and reputation sync.
+
+Required environment:
+
+```txt
+UGIG_API_URL
+UGIG_API_KEY
+UGIG_WEBHOOK_SECRET
+```
--- a/plugins/ugig/package.json
+++ b/plugins/ugig/package.json
@ -0,0 +1,18 @@
+{
+  "name": "@logicsrc/plugin-ugig",
+  "version": "0.1.0",
+  "description": "Default CommandBoard.run jobs, gigs, talent, and marketplace plugin.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run src --passWithNoTests"
+  },
+  "dependencies": {
+    "@logicsrc/plugin-core": "file:../../packages/plugin-core"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.8"
+  }
+}
--- a/plugins/ugig/src/index.ts
+++ b/plugins/ugig/src/index.ts
@ -0,0 +1,27 @@
+import type { PluginDefinition } from "@logicsrc/plugin-core";
+import { uGigManifest } from "./manifest.js";
+
+export const uGigPlugin: PluginDefinition = {
+  manifest: uGigManifest,
+  configDefaults: {
+    enabled: true,
+    default_jobs_provider: true,
+    api_url: "${UGIG_API_URL}",
+    api_key: "${UGIG_API_KEY}",
+    webhook_secret: "${UGIG_WEBHOOK_SECRET}",
+    default_board: "/gigs"
+  },
+  routes: [
+    { method: "GET", path: "/api/plugins/ugig/jobs", capability: "jobs.import" },
+    { method: "POST", path: "/api/plugins/ugig/gigs", capability: "jobs.publish" },
+    { method: "POST", path: "/api/plugins/ugig/webhooks/gigs-sync", capability: "gigs.sync" }
+  ],
+  events: [
+    { event: "task.created", capability: "tasks.publish_to_marketplace" },
+    { event: "task.approved", capability: "reputation.sync" }
+  ],
+  permissions: ["jobs:read", "jobs:publish", "gigs:sync", "reputation:sync"],
+  tuiPanels: [{ id: "ugig-status", title: "uGig Jobs" }]
+};
+
+export { uGigManifest };
--- a/plugins/ugig/src/manifest.ts
+++ b/plugins/ugig/src/manifest.ts
@ -0,0 +1,21 @@
+import type { PluginManifest } from "@logicsrc/plugin-core";
+
+export const uGigManifest: PluginManifest = {
+  id: "ugig",
+  name: "uGig",
+  version: "1.0.0",
+  type: ["jobs", "gigs", "marketplace"],
+  default: true,
+  capabilities: [
+    "jobs.import",
+    "jobs.publish",
+    "gigs.sync",
+    "candidates.link",
+    "agents.link",
+    "tasks.publish_to_marketplace",
+    "bids.sync",
+    "reputation.sync"
+  ],
+  commands: ["jobs", "gigs", "publish"],
+  env: ["UGIG_API_URL", "UGIG_API_KEY", "UGIG_WEBHOOK_SECRET"]
+};
--- a/plugins/ugig/tsconfig.json
+++ b/plugins/ugig/tsconfig.json
@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}
--- a/scripts/install.sh
+++ b/scripts/install.sh
@ -0,0 +1,60 @@
+#!/usr/bin/env sh
+set -eu
+
+VERSION="latest"
+INSTALL_DIR="${HOME}/.commandboard/bin"
+INSTALL_ALIAS=1
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --version)
+      VERSION="$2"
+      shift 2
+      ;;
+    --install-dir)
+      INSTALL_DIR="$2"
+      shift 2
+      ;;
+    --no-alias)
+      INSTALL_ALIAS=0
+      shift
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      exit 2
+      ;;
+  esac
+done
+
+OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
+ARCH="$(uname -m)"
+case "$ARCH" in
+  x86_64) ARCH="x64" ;;
+  aarch64|arm64) ARCH="arm64" ;;
+esac
+
+echo "Installing CommandBoard.run CLI..."
+echo "Detected: ${OS} ${ARCH}"
+echo "Installing to: ${INSTALL_DIR}"
+
+mkdir -p "$INSTALL_DIR"
+
+cat > "${INSTALL_DIR}/commandboard" <<'BIN'
+#!/usr/bin/env sh
+echo "CommandBoard.run CLI bootstrap"
+echo "Install from a release artifact when v1.0.0 binaries are published."
+echo "For local development run: npm --workspace @logicsrc/cli run dev -- \"$@\""
+BIN
+
+chmod +x "${INSTALL_DIR}/commandboard"
+
+if [ "$INSTALL_ALIAS" -eq 1 ]; then
+  ln -sf "${INSTALL_DIR}/commandboard" "${INSTALL_DIR}/cb"
+  echo "Installed alias: cb"
+fi
+
+echo "Installed: commandboard (${VERSION})"
+echo "Add this to your shell profile if needed:"
+echo "export PATH=\"\$HOME/.commandboard/bin:\$PATH\""
+echo "Run: commandboard login"
+echo "Run: commandboard tui"
--- a/tsconfig.base.json
+++ b/tsconfig.base.json
@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "sourceMap": true,
+    "outDir": "dist"
+  }
+}