Add LogicSRC CLI and AgentSwarm surfaces

docs/cli.md

@@ -3,16 +3,28 @@
 Primary command style:
 
 ```bash
-commandboard <resource> <action> [options]
+logicsrc <resource> <action> [options]
 ```
 
 Aliases:
 
 ```bash
+logicsrc
 commandboard
 cb
 ```
 
+`logicsrc` is the canonical standards CLI. `commandboard` and `cb` remain product/client aliases for CommandBoard.run-compatible workflows.
+
+Product CLIs may embed LogicSRC as a sub-command:
+
+```bash
+sh1pt logicsrc <resource> <action> [options]
+sh1pt logicsrc --openspec-only <resource> <action> [options]
+```
+
+`--openspec-only` means the workflow must stay inside LogicSRC-published schemas, CLI/TUI conventions, SDK contracts, MCP resources/tools/prompts, PWA states, and curl-compatible API surfaces.
+
 Required v1 command groups:
 
 ```txt
@@ -25,24 +37,34 @@ post
 task
 wallet
 events
+agentswarm
 plugins
 tui
 update / upgrade
 remove / uninstall
 ```
 
+AgentSwarm master-agent command:
+
+```bash
+logicsrc agentswarm --yolo --repo profullstack/logicsrc --agents reproduce,patch,review
+sh1pt logicsrc --openspec-only agentswarm --yolo --repo profullstack/logicsrc
+```
+
+`agentswarm --yolo` opens the master agent flow. The master agent coordinates slave agents for scoped work such as reproduction, patching, review, documentation, and release evidence.
+
 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
+logicsrc task list --format json
+logicsrc plugins --format json
+logicsrc task get task_123 --raw-schema --format json
 ```
 
 Installer:
 
 ```bash
-curl -fsSL https://commandboard.run/install.sh | sh
+curl -fsSL https://logicsrc.com/install.sh | sh
 ```
 
 Local scaffold installer:
@@ -50,3 +72,17 @@ Local scaffold installer:
 ```bash
 sh scripts/install.sh
 ```
+
+## SDK Surfaces
+
+Every stable CLI workflow should map to SDK calls across:
+
+```txt
+Rust
+Bun
+Node
+Python
+curl
+```
+
+SDKs must preserve the same resource names, state names, schema versions, event names, permission names, and audit objects used by the CLI and MCP server.

docs/positioning.md

@@ -16,6 +16,8 @@ Avoid using "LogicSRC Foundation" unless Profullstack creates a separate legal f
 
 ## 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.
+LogicSRC defines the common language and primitives: identity, boards, posts, tasks, bounties, agents, agent runs, permissions, payments, escrow, reputation, events, webhooks, CLI commands, SDK contracts, MCP servers, PWA states, curl/API surfaces, and schemas.
 
 CommandBoard.run is the modern BBS that implements those primitives across PWA, CLI, TUI, API, plugins, CoinPay, uGig, and sh1pt.
+
+sh1pt is a separate Profullstack product CLI that can host LogicSRC as `sh1pt logicsrc ...`. That path is for users who want sh1pt delivery automation while restricting a workflow to OpenSpec contracts from LogicSRC.

docs/roadmap.md

@@ -14,7 +14,7 @@
 12. Add CoinPay escrow integration.
 13. Add uGig jobs/gigs integration.
 14. Add sh1pt projects/actions integration.
-15. Add CLI.
+15. Add `logicsrc` CLI.
 16. Add installer script.
 17. Add CLI update/upgrade.
 18. Add CLI remove/uninstall.
@@ -24,5 +24,8 @@
 22. Add event stream.
 23. Add agent profiles and runs.
 24. Add plugin status UI.
-25. Add docs.
-26. Tag v1.0.0.
+25. Add SDK contracts for Rust, Bun, Node, Python, and curl.
+26. Add MCP server contracts.
+27. Add `sh1pt logicsrc ...` OpenSpec-only integration.
+28. Add docs.
+29. Tag v1.0.0.