@lightupai/polaris 0.0.49 → 0.0.51
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/Makefile +7 -4
- package/README.md +25 -0
- package/package.json +1 -1
package/Makefile
CHANGED
|
@@ -17,20 +17,23 @@ dev-down:
|
|
|
17
17
|
docker compose down
|
|
18
18
|
|
|
19
19
|
# Cloud service API (port 4321)
|
|
20
|
+
# nohup so the service survives `make` exiting. A bare `&` leaves it as an
|
|
21
|
+
# orphaned job that receives SIGHUP and dies (banner prints, then it's gone);
|
|
22
|
+
# nohup makes it ignore SIGHUP. Logs go to /tmp/polaris-*.log.
|
|
20
23
|
api:
|
|
21
24
|
@echo "Starting API server on http://localhost:4321"
|
|
22
|
-
@npx bun run src/service/server.ts
|
|
25
|
+
@nohup npx bun run src/service/server.ts >/tmp/polaris-api.log 2>&1 &
|
|
23
26
|
|
|
24
27
|
# Web app (port 3000)
|
|
25
28
|
web:
|
|
26
29
|
@echo "Starting web app on http://localhost:3000"
|
|
27
|
-
@npx bun --hot run src/web/serve.ts &
|
|
30
|
+
@nohup npx bun --hot run src/web/serve.ts >/tmp/polaris-web.log 2>&1 &
|
|
28
31
|
|
|
29
32
|
# Local daemon (port 4322) — uses local profile token if available
|
|
30
33
|
daemon:
|
|
31
34
|
@echo "Starting daemon on http://127.0.0.1:4322"
|
|
32
35
|
@TOKEN=$$(jq -r '.profiles.local.token // empty' ~/.polaris/config.json 2>/dev/null || echo ""); \
|
|
33
|
-
POLARIS_DAEMON_PORT=4322 POLARIS_SERVICE_URL=http://localhost:4321 POLARIS_AUTH_TOKEN="$$TOKEN" npx bun run src/daemon/daemon.ts &
|
|
36
|
+
POLARIS_DAEMON_PORT=4322 POLARIS_SERVICE_URL=http://localhost:4321 POLARIS_AUTH_TOKEN="$$TOKEN" nohup npx bun run src/daemon/daemon.ts >/tmp/polaris-daemon.log 2>&1 &
|
|
34
37
|
|
|
35
38
|
# Slack bridge (auto-detects org from DB, needs SLACK_APP_TOKEN in .env)
|
|
36
39
|
bridge:
|
|
@@ -38,7 +41,7 @@ bridge:
|
|
|
38
41
|
ORG=$$(docker exec collab-polaris-postgres-1 psql -U polaris -d polaris -t -A -c "SELECT id FROM orgs WHERE slack_team_id IS NOT NULL LIMIT 1;" 2>/dev/null); \
|
|
39
42
|
if [ -n "$$ORG" ]; then \
|
|
40
43
|
echo "Starting Slack bridge for org $$ORG"; \
|
|
41
|
-
npx bun run src/slack/bridge.ts $$ORG
|
|
44
|
+
nohup npx bun run src/slack/bridge.ts $$ORG >/tmp/polaris-bridge.log 2>&1 & \
|
|
42
45
|
else echo "Skipping bridge (no Slack-connected org found)"; fi; \
|
|
43
46
|
fi
|
|
44
47
|
|
package/README.md
CHANGED
|
@@ -11,6 +11,31 @@ Multiplayer collaboration for AI coding agents. Connects coding sessions (Claude
|
|
|
11
11
|
- **Slack Bridge** (`src/slack/bridge.ts`) — Bidirectional bridge between project event streams and Slack channels.
|
|
12
12
|
- **Hooks** (`hooks/`) — Shell scripts that capture coding agent interactions (prompts, responses, tool calls).
|
|
13
13
|
|
|
14
|
+
## Prerequisites
|
|
15
|
+
|
|
16
|
+
Install these before running the Quick Start:
|
|
17
|
+
|
|
18
|
+
| Tool | Why | Install |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| [Bun](https://bun.sh) | Runtime for all services, the CLI, and the test suite | `npm install -g bun`, `brew install oven-sh/bun/bun`, or `curl -fsSL https://bun.sh/install \| bash` |
|
|
21
|
+
| [Docker](https://docs.docker.com/get-docker/) | Runs the Postgres container | Docker Desktop (macOS/Windows) or Docker Engine (Linux) — must be **running** |
|
|
22
|
+
|
|
23
|
+
Then verify:
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
bun --version # 1.x
|
|
27
|
+
docker info # should succeed (daemon running)
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
> **Port 5432 must be free.** `docker compose up -d` binds Postgres to `5432`. If another
|
|
31
|
+
> Postgres already uses that port, either stop it, or run the container on `5433` and set
|
|
32
|
+
> `DATABASE_URL=postgres://polaris:polaris@127.0.0.1:5433/polaris` (and pass the same
|
|
33
|
+
> `DATABASE_URL` to `make test`, pointing at the `polaris_test` database).
|
|
34
|
+
|
|
35
|
+
> **Login needs Google OAuth.** `make dev` and `polaris login` authenticate via Google SSO,
|
|
36
|
+
> so `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` must be set in `.env` (see
|
|
37
|
+
> [Configuration](#configuration)). The test suite (`make test`) does **not** require this.
|
|
38
|
+
|
|
14
39
|
## Quick Start
|
|
15
40
|
|
|
16
41
|
```sh
|