Skip to content

Commit 44393e7

Browse files
committed
clean up
1 parent f080b87 commit 44393e7

73 files changed

Lines changed: 3397 additions & 2943 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.agent/skills/bos/SKILL.md

Lines changed: 17 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: bos
3-
description: CLI alias for everything-dev Module Federation projects. Use when creating new BOS projects, publishing bos.config.json to the FastKV registry, syncing with remote configs (every.near/everything.dev), running development servers (`everything-dev dev` or `bos dev`), or building/deploying federated apps. Deploy → publish → sync workflow for shared configuration.
3+
description: CLI alias for everything-dev Module Federation projects. Use when creating new BOS projects, publishing bos.config.json to the temporary dev.everything.near FastKV registry, syncing with remote configs (every.near/everything.dev), running development servers (`everything-dev dev` or `bos dev`), or building/deploying federated apps. Build/deploy → publish → sync workflow for shared configuration.
44
---
55

66
# everything-dev CLI (`bos` alias)
@@ -57,10 +57,10 @@ bos start --no-interactive # All remotes, production URLs
5757
The core workflow for sharing configuration:
5858

5959
```bash
60-
# 1. Deploy apps to Zephyr (updates bos.config.json with production URLs)
61-
bos deploy
60+
# 1. Build/deploy all workspaces when needed (updates bos.config.json with production URLs)
61+
bos publish --deploy
6262

63-
# 2. Publish config to the FastKV registry
63+
# 2. Publish config to the temporary FastKV registry
6464
bos publish
6565

6666
# 3. Others sync from your published config
@@ -78,8 +78,7 @@ bos sync --account your.near --gateway your-gateway.com
7878
| `bos dev` | Development (auto-detects missing packages) |
7979
| `bos start --no-interactive` | Production mode |
8080
| `bos build` | Build existing packages (skips missing) |
81-
| `bos deploy` | Deploy existing packages to Zephyr |
82-
| `bos publish` | Publish config to the FastKV registry |
81+
| `bos publish` | Publish config to the temporary FastKV registry |
8382
| `bos info` | Show current configuration |
8483
| `bos status` | Check remote health |
8584

@@ -116,7 +115,7 @@ Commands automatically detect which packages exist locally:
116115
|---------|-------------------------|
117116
| `bos dev` | Uses remote mode |
118117
| `bos build` | Skips package |
119-
| `bos deploy` | Skips package |
118+
| `bos publish --deploy` | Skips package |
120119

121120
### Process Management
122121

@@ -130,21 +129,14 @@ Process tracking uses `.bos/pids.json` to track spawned processes for cleanup.
130129

131130
### Docker Commands
132131

133-
| Command | Description |
134-
|---------|-------------|
135-
| `bos docker build` | Build production Docker image |
136-
| `bos docker build --target development` | Build development/agent-ready image |
137-
| `bos docker build --no-cache` | Build without cache |
138-
| `bos docker run` | Run container in production mode |
139-
| `bos docker run --detach` | Run container in background |
140-
| `bos docker run --target development --mode serve` | Run agent-ready container (RPC exposed) |
141-
| `bos docker stop <containerId>` | Stop specific container |
142-
| `bos docker stop --all` | Stop all BOS containers |
143-
144-
**Docker modes:**
145-
- `start` (default): Production mode, fetches config from the FastKV registry
146-
- `serve`: Exposes CLI as RPC API (agent-ready)
147-
- `dev`: Full development mode
132+
Use the repo `Dockerfile` directly for production containers.
133+
134+
```bash
135+
docker build -t everything-dev .
136+
docker run -p 3000:3000 everything-dev
137+
```
138+
139+
The container uses `bun run start` and fetches config from the FastKV registry.
148140

149141
For full command reference, see [commands.md](docs/commands.md).
150142

@@ -172,6 +164,6 @@ For detailed workflow guides, see [workflows.md](docs/workflows.md):
172164
Key files for understanding the system:
173165

174166
- `bos.config.json` - Runtime configuration
175-
- `demo/cli/src/types.ts` - BosConfig schema
176-
- `demo/cli/src/cli.ts` - CLI implementation
177-
- `demo/cli/src/plugin.ts` - Command handlers
167+
- `packages/everything-dev/src/types.ts` - BosConfig schema
168+
- `packages/everything-dev/src/cli.ts` - CLI implementation
169+
- `packages/everything-dev/src/bos-plugin.ts` - Command handlers

.agent/skills/bos/docs/commands.md

Lines changed: 9 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -56,24 +56,18 @@ bos build --force # Force rebuild (ignore cache)
5656

5757
### `bos deploy`
5858

59-
Build and deploy to Zephyr Cloud. Updates `bos.config.json` with production Zephyr URLs after successful deployment.
60-
61-
```bash
62-
bos deploy # Deploy all
63-
bos deploy ui # Deploy UI only
64-
bos deploy --force # Force rebuild
65-
```
66-
67-
Requires `ZE_SERVER_TOKEN` and `ZE_USER_EMAIL` in `.env.bos` for CI/CD.
59+
`bos deploy` is not a standalone command in the current CLI. Use `bos publish --deploy` to build/deploy all workspaces and then publish the updated config.
6860

6961
### `bos publish`
7062

71-
Publish `bos.config.json` to the FastKV registry.
63+
Publish `bos.config.json` to the temporary `dev.everything.near` FastKV registry.
7264

7365
```bash
74-
bos publish # Mainnet
66+
bos publish # Publish only
67+
bos publish --deploy # Build/deploy all workspaces, then publish
7568
bos publish --network testnet
7669
bos publish --dry-run # Preview without sending
70+
bos publish --packages ui,api
7771
```
7872

7973
### `bos clean`
@@ -251,34 +245,14 @@ Process tracking uses `.bos/pids.json` to track spawned processes.
251245

252246
## Docker
253247

254-
### `bos docker build`
255-
256-
Build Docker image for production or development.
257-
258-
```bash
259-
bos docker build # Production image (Dockerfile)
260-
bos docker build --target development # Dev image (Dockerfile.dev)
261-
bos docker build --tag my-tag # Custom tag
262-
bos docker build --no-cache # Build without cache
263-
```
264-
265-
### `bos docker run`
266-
267-
Run container with configurable modes.
248+
Use the repo `Dockerfile` directly, or build the image in CI and push to GHCR.
268249

269250
```bash
270-
bos docker run # Production mode
271-
bos docker run --detach # Run in background
272-
bos docker run --port 8080 # Custom port
273-
bos docker run --target development --mode serve # Agent-ready (RPC exposed)
274-
bos docker run --target development --mode dev # Full dev mode
275-
bos docker run --env KEY=value # Pass env vars
251+
docker build -t everything-dev .
252+
docker run -p 3000:3000 everything-dev
276253
```
277254

278-
**Modes:**
279-
- `start` (default): Production mode, fetches config from the FastKV registry
280-
- `serve`: Exposes CLI as RPC API at `/api/rpc` (agent-ready)
281-
- `dev`: Full development mode with hot reload
255+
The container uses `bun run start` and fetches config from the FastKV registry.
282256

283257
### `bos docker stop`
284258

.agent/skills/bos/docs/types.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
The `bos.config.json` file is the single source of truth for all runtime configuration.
44

5-
## Schema (from `demo/cli/src/types.ts`)
5+
## Schema (from `packages/everything-dev/src/types.ts`)
66

77
```typescript
88
interface BosConfig {

.agent/skills/bos/docs/workflows.md

Lines changed: 13 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -100,26 +100,28 @@ The core sharing workflow:
100100

101101
### 1. Publish (Full Release)
102102

103-
`bos publish` builds, deploys to Zephyr Cloud, and publishes config to the FastKV registry in one step:
103+
`bos publish` publishes `bos.config.json` to the temporary `dev.everything.near` FastKV registry. Add `--deploy` to build/deploy all workspaces first:
104104

105105
```bash
106106
# Preview first
107107
bos publish --dry-run
108108

109-
# Full release: build + deploy + publish to mainnet
109+
# Publish only
110110
bos publish
111111

112+
# Build/deploy all workspaces, then publish
113+
bos publish --deploy
114+
112115
# Publish to testnet
113116
bos publish --network testnet
114117

115118
# Publish specific packages only
116-
bos publish ui,api
119+
bos publish --packages ui,api
117120
```
118121

119122
The publish command:
120-
1. Builds packages locally (`bun run build`)
121-
2. Deploys to Zephyr Cloud (updates `production` URLs in config)
122-
3. Publishes config to the FastKV registry
123+
1. Optionally builds/deploys all workspaces when `--deploy` is set
124+
2. Publishes config to the FastKV registry
123125

124126
Your config is now at: `{account}/bos/gateways/{gateway}/bos.config.json`
125127

@@ -297,39 +299,24 @@ bos secrets sync --env .env.my-tenant
297299

298300
Each tenant can have their own:
299301
- `bos.config.json` with their account
300-
- Published config in the FastKV registry
302+
- Published config in the temporary FastKV registry
301303
- NOVA secrets group
302304

303305
## Docker Deployment
304306

305307
### Production Container
306308

307-
Build and run a production container that fetches config from the FastKV registry:
309+
Build and run the repo Docker image that fetches config from the FastKV registry:
308310

309311
```bash
310-
# Build production image
311-
bos docker build
312-
313-
# Run in background
314-
bos docker run --detach
312+
docker build -t everything-dev .
315313

316-
# Stop all containers
317-
bos docker stop --all
314+
docker run -p 3000:3000 everything-dev
318315
```
319316

320317
### Agent-Ready Container
321318

322-
For AI agents that need to interact via RPC:
323-
324-
```bash
325-
# Build development image
326-
bos docker build --target development
327-
328-
# Run with RPC exposed
329-
bos docker run --target development --mode serve --detach
330-
331-
# RPC available at http://localhost:4000/api/rpc
332-
```
319+
The repo Dockerfile is production-oriented. Use the CLI directly for agent workflows.
333320

334321
### Container Management
335322

@@ -342,9 +329,6 @@ bos kill
342329

343330
# Force kill
344331
bos kill --force
345-
346-
# Stop specific container
347-
bos docker stop <containerId>
348332
```
349333

350334
## Debugging

.changeset/auth-fix.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"host": patch
3+
---
4+
5+
Fix authentication flow in host program with proper session handling and proxy test coverage
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
"api": patch
3+
"ui": patch
4+
"everything-dev": patch
5+
---
6+
7+
Fix published app discovery and FastKV publish flow so registry reads use the stored manifest data, publish can succeed after FastKV indexing, and the app explorer links directly to the FastKV config record.

.changeset/plugins-support.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
"api": patch
3+
"host": patch
4+
"everything-dev": patch
5+
"every-plugin": patch
6+
---
7+
8+
Add plugin support with improved module federation service, shared dependencies handling, and auth client integration

.changeset/security-hardening.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"host": patch
3+
---
4+
5+
Add security hardening with Dependabot configuration, SECURITY.md policy, and axios vulnerability mitigation
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
"everything-dev": patch
3+
"ui": patch
4+
---
5+
6+
Refresh the splash-based social metadata and brand assets so the UI ships a stable preview image and matching black-dot favicon set.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
"ui": patch
3+
"everything-dev": patch
4+
---
5+
6+
Add under construction page with NEAR CLI integration for session management and development tooling

0 commit comments

Comments
 (0)