mirror of
https://github.com/profullstack/logicsrc.git
synced 2026-10-02 04:43:58 +00:00
Anthony Ettinger
4ceaaaaa1f
Ship what docs/openfleet.md describes. The new workspace package holds the record (write once, never overwrite, 0600), the ledger (append-only JSON Lines, merged across ledger*.jsonl by at), the ceiling rules (whole fleet ceiling, narrowed swarm keys, a merge that never widens, refusals by key), claiming and deriving exactly as the spec's "Claiming and deriving" and rule 13, and fold(), which turns any $OPENFLEET_HOME plus the engine rosters into the tree the landing page shows. logicsrc fleet open|cap|tree|stop|log are the sysop's verbs, every one with --json. open and cap exit 4 when OPENFLEET_MEMBER is set; stop exits 4 outside the caller's subtree, ends nested swarms first, goes through each member's own engine (claude stop, moshcode herd kill, tmux kill-pane, a signal for claude-p) and writes one swarm.end per swarm. tree reads claude agents --json --all and ~/.moshcode/herd/sessions.json when it can, draws recordless sessions as roster roots of the implicit fleet, and writes member.end lost for a recorded member its engine no longer lists. Claude Code takes part through hooks: logicsrc fleet hooks install merges SessionStart, UserPromptSubmit, PreToolUse, Stop and SessionEnd into ~/.claude/settings.json without clobbering it, and logicsrc fleet hook <Event> runs each one. SessionStart claims, derives or writes a root record and hands the member its variables through CLAUDE_ENV_FILE; UserPromptSubmit checks the ceiling with the permission mode the engine reports and writes member.start, or refuses the first prompt with exit 2 and ceiling.refuse; PreToolUse denies an edit outside piece.owns; Stop and SessionEnd write member.end. A hand-started root takes the engine's reported approvals before member.start, since the command line only guesses them. Hooks never fail the engine: everything is caught and logged to hooks.log. The spec and the landing page now say what ships, keep Status 0.1, and record the two verified Claude Code limits: a background job dispatched from claude agents gets no launcher environment, and OPENFLEET_* exported at SessionStart reach the member's tools but not later hooks, so hooks key on session_id through $OPENFLEET_HOME/sessions/<session_id>.json. PRD 0008 covers the work. CLI 0.2.1 -> 0.3.0; build and build:cli chains build the package before the CLI; README and docs/cli.md list the group. Tests: 95 in the package (record, ledger merge, every narrower case, the worked example's claim and derive, the folded tree, hook install idempotence, each hook handler including the exit-2 refusal and the PreToolUse deny, every verb with fake deps) and 4 in the CLI. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RZV4zJ2pDZLNN3kE5jFCmV
120 lines
2.8 KiB
Markdown
120 lines
2.8 KiB
Markdown
# CLI Conventions
|
|
|
|
Primary command style:
|
|
|
|
```bash
|
|
logicsrc <resource> <action> [options]
|
|
```
|
|
|
|
Aliases:
|
|
|
|
```bash
|
|
logicsrc
|
|
```
|
|
|
|
`logicsrc` is the canonical standards CLI.
|
|
|
|
`--openspec` enables OpenSpec.dev-compatible repo-local planning conventions where supported, such as specs, proposals, implementation tasks, and requirement deltas.
|
|
|
|
`--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
|
|
login
|
|
logout
|
|
whoami
|
|
boards
|
|
read
|
|
post
|
|
task
|
|
wallet
|
|
events
|
|
agentswarm
|
|
accounts
|
|
social
|
|
email
|
|
credentials
|
|
fleet
|
|
openspec
|
|
plugins
|
|
tui
|
|
update / upgrade
|
|
remove / uninstall
|
|
```
|
|
|
|
AgentSwarm master-agent command:
|
|
|
|
```bash
|
|
logicsrc agentswarm --yolo --repo profullstack/logicsrc --agents reproduce,patch,review
|
|
logicsrc --openspec 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.
|
|
|
|
OpenSpec-compatible artifact commands:
|
|
|
|
```bash
|
|
logicsrc openspec import
|
|
logicsrc openspec export --out logicsrc-openspec-summary.md
|
|
logicsrc openspec change --id add-agent-policy --capability agents
|
|
```
|
|
|
|
Credential sharing commands:
|
|
|
|
```bash
|
|
logicsrc credentials providers
|
|
logicsrc credentials plan --from env --to railway
|
|
logicsrc credentials plan --from doppler --to github-secrets
|
|
```
|
|
|
|
Credential sharing is provider-neutral. External tools can consume LogicSRC credential contracts, but LogicSRC commands do not call proprietary product CLIs.
|
|
|
|
Communication account commands:
|
|
|
|
```bash
|
|
logicsrc accounts providers
|
|
logicsrc accounts list
|
|
logicsrc social providers
|
|
logicsrc email providers
|
|
logicsrc social post <account-id> --text "Launching today" --dry-run
|
|
logicsrc email send <draft-id> --dry-run
|
|
```
|
|
|
|
Communication account commands must redact credentials, support dry-run for write-capable actions, and require approval policies for outbound email and social publishing.
|
|
|
|
When `--openspec` is enabled, AgentSwarm writes OpenSpec.dev-style files under `openspec/changes/<change-id>/`.
|
|
|
|
Machine-readable output should be available anywhere data is returned:
|
|
|
|
```bash
|
|
logicsrc task list --format json
|
|
logicsrc plugins --format json
|
|
logicsrc task get task_123 --raw-schema --format json
|
|
```
|
|
|
|
Installer:
|
|
|
|
```bash
|
|
curl -fsSL https://logicsrc.com/install.sh | sh
|
|
```
|
|
|
|
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.
|