Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@ generally: the next thing that wants to be an exception needs its own argument,
| Path | What it is |
|------|------------|
| `src/` | The Worker: routes, middleware, storage, queue consumers, evaluation engine, UI, and the remote MCP server (`src/mcp/`, served at `/mcp`) |
| `cli/` | `@stratum/cli` — standalone publishable package |
| `agent/` | `@stratum/agent` — reference agent, standalone publishable package |
| `cli/` | `@stratum-eng/cli` — standalone publishable package |
| `agent/` | `@stratum-eng/agent` — reference agent, standalone publishable package |
| `tests/` | Vitest suites: unit (`tests/*.test.ts`), `tests/integration/`, `tests/smoke/` |
| `migrations/` | D1 SQL migrations |
| `docs/` | User, API, developer docs, ADRs (`docs/adr/`), and runbooks (`docs/runbooks/`) |
Expand Down
4 changes: 2 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Breaking
- **Stratum is no longer MIT-licensed.** The server, the web UI, `docs/`, and the
`website/` sources are now **AGPL-3.0-or-later**; the `@stratum/cli` and `@stratum/agent` packages are
`website/` sources are now **AGPL-3.0-or-later**; the `@stratum-eng/cli` and `@stratum-eng/agent` packages are
**Apache-2.0**, chosen over MIT for its express patent grant. Everything
released through v0.2.0 stays MIT and always will — anyone holding that code
keeps their MIT rights in it, forks included. The new terms apply from this
Expand Down Expand Up @@ -296,7 +296,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
grant cannot reach `/api/admin/*` (even for the instance administrator, whom
`resolveAdminAuth` would otherwise authorize on an `ADMIN_EMAIL` match), and
cannot rotate the never-expiring legacy API key.
- **CLI and MCP server guides.** Dedicated documentation for `@stratum/cli`
- **CLI and MCP server guides.** Dedicated documentation for `@stratum-eng/cli`
(`docs/user-guide/cli.md`) and the MCP server (`docs/user-guide/mcp.md`),
published at `/guides/cli/` and `/guides/mcp/` — configuration, the full
command/tool surface (including `project delete` and `account delete`, which
Expand Down
4 changes: 2 additions & 2 deletions LICENSING.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ authoritative account of which is which and why.
| Path | License | SPDX |
|---|---|---|
| Everything not listed below — `src/`, `migrations/`, `scripts/`, `tests/`, `docs/`, `website/`, `wrangler.toml` | GNU Affero General Public License v3.0 or later | [`AGPL-3.0-or-later`](LICENSE) |
| [`cli/`](cli) — the `@stratum/cli` package | Apache License 2.0 | [`Apache-2.0`](cli/LICENSE) |
| [`agent/`](agent) — the `@stratum/agent` reference agent | Apache License 2.0 | [`Apache-2.0`](agent/LICENSE) |
| [`cli/`](cli) — the `@stratum-eng/cli` package | Apache License 2.0 | [`Apache-2.0`](cli/LICENSE) |
| [`agent/`](agent) — the `@stratum-eng/agent` reference agent | Apache License 2.0 | [`Apache-2.0`](agent/LICENSE) |
| `website/public/.well-known/agent-skills/` — the published agent skill files | MIT License | `MIT` |

The split follows the boundary that matters to a user: what you *run as a
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -344,8 +344,8 @@ queue consumer and a stale-event sweep · workspace TTL sweep.
**Interfaces**
Server-rendered web UI · REST API (93 paths) · remote MCP server at `/mcp` with an
OAuth 2.1 authorization server (dynamic client registration, PKCE, rotating refresh
tokens) · `@stratum/cli` covering the change flow, issues, and activity ·
`@stratum/agent` reference agent.
tokens) · `@stratum-eng/cli` covering the change flow, issues, and activity ·
`@stratum-eng/agent` reference agent.

## Known limitations

Expand Down Expand Up @@ -510,8 +510,8 @@ copyleft, what you run inside your own pipeline is not.

| Path | License |
|---|---|
| [`cli/`](cli) — `@stratum/cli` | [Apache-2.0](cli/LICENSE) |
| [`agent/`](agent) — `@stratum/agent` | [Apache-2.0](agent/LICENSE) |
| [`cli/`](cli) — `@stratum-eng/cli` | [Apache-2.0](cli/LICENSE) |
| [`agent/`](agent) — `@stratum-eng/agent` | [Apache-2.0](agent/LICENSE) |
| `website/public/.well-known/agent-skills/` — the published agent skills | MIT |
| everything else — the server, the web UI, `docs/`, `website/` | [AGPL-3.0-or-later](LICENSE) |

Expand Down
2 changes: 1 addition & 1 deletion ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ under [Deployments](#deployments).

### Publish the client packages to npm

- [ ] `@stratum/cli` and `@stratum/agent` both live in this repo at full API parity, but
- [ ] `@stratum-eng/cli` and `@stratum-eng/agent` both live in this repo at full API parity, but
neither is published, so consumers must build from source. Publishing needs a release
workflow, provenance attestation, and a version policy across the two. (The MCP
server no longer needs publishing at all — it is served by the Worker at `/mcp`.)
Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Please include:

## Scope

In scope: the Worker (`src/`), the `@stratum/cli` and `@stratum/agent` packages, authentication and
In scope: the Worker (`src/`), the `@stratum-eng/cli` and `@stratum-eng/agent` packages, authentication and
token handling, the evaluation engine, and the merge/Git pipeline.

Out of scope: vulnerabilities in third-party dependencies (report those upstream), denial-of-service
Expand Down
4 changes: 2 additions & 2 deletions agent/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# @stratum/agent
# @stratum-eng/agent

Reference agent for Stratum: proves the platform end-to-end for agent workflows.

Expand All @@ -7,7 +7,7 @@ export STRATUM_HOST=https://your-stratum-instance
export STRATUM_API_KEY=stratum_user_…
export ANTHROPIC_API_KEY=sk-ant-…

npx @stratum/agent \
npx @stratum-eng/agent \
--repo @user/my-api \
--objective "Fix the N+1 query in the users endpoint" \
--model claude-sonnet-4-6
Expand Down
4 changes: 2 additions & 2 deletions agent/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion agent/package.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "@stratum/agent",
"name": "@stratum-eng/agent",
"version": "0.1.0",
"description": "Reference agent for Stratum — fork, edit with an LLM, commit, open a Change",
"license": "Apache-2.0",
Expand Down
2 changes: 1 addition & 1 deletion agent/src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
/**
* Reference agent: proves the Stratum platform end-to-end for agent workflows.
*
* npx @stratum/agent --repo @user/api --objective "Fix the N+1 query"
* npx @stratum-eng/agent --repo @user/api --objective "Fix the N+1 query"
*
* Flow: create agent identity → fork workspace → read repo → ask Claude for
* edits → commit with the agent token → open a Change (which runs evaluation).
Expand Down
8 changes: 8 additions & 0 deletions changelog.d/npm-scope-stratum-eng.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
### Changed
- **The npm packages moved to the `@stratum-eng` scope.** `@stratum/cli` and
`@stratum/agent` are now `@stratum-eng/cli` and `@stratum-eng/agent` — the
`@stratum` scope on npm belongs to an unrelated owner. Install and `npx`
invocations change accordingly (`npx @stratum-eng/agent ...`); nothing else
about the packages, their binaries (`stratum`, `stratum-agent`), or their APIs
changes. Neither package was ever published under the old names, so there is
nothing to migrate off.
2 changes: 1 addition & 1 deletion cli/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# @stratum/cli
# @stratum-eng/cli

CLI for Stratum — code hosting for the AI engineering era. Wraps the Stratum REST API.

Expand Down
4 changes: 2 additions & 2 deletions cli/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion cli/package.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "@stratum/cli",
"name": "@stratum-eng/cli",
"version": "0.2.0",
"description": "CLI for Stratum \u2014 code hosting for the AI engineering era",
"license": "Apache-2.0",
Expand Down
4 changes: 2 additions & 2 deletions docs/CURRENT_CAPABILITIES.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,15 +137,15 @@ environment (`wrangler.toml:75`), so it works out of the box.

## Tooling

- `cli/` — @stratum/cli covering projects, workspaces, commits, changes incl.
- `cli/` — @stratum-eng/cli covering projects, workspaces, commits, changes incl.
review/merge, issues, activity and account. `stratum login` is a
browser-based OAuth 2.1 + PKCE flow against a loopback redirect (RFC 8252),
with `--read-only` for an `mcp:read` grant and `--key <token>` as the
headless path for CI (`cli/src/index.ts:54-133`); `stratum logout` always
clears the local credential and revokes the grant on a best-effort basis
(`cli/src/index.ts:148-171`). Deployments have no CLI command yet — use the
API or the UI.
- `agent/` — @stratum/agent reference agent: identity → fork → Claude edit plan
- `agent/` — @stratum-eng/agent reference agent: identity → fork → Claude edit plan
→ commit → Change with evaluation.

## Known limitations / future work
Expand Down
2 changes: 1 addition & 1 deletion docs/REMAINING_WORK.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ off the request path, are what this item still covers.
Team write/admin grants are org-wide. Per-project grants allow finer-grained
access control within an org.

### Publish @stratum/cli and @stratum/agent to npm
### Publish @stratum-eng/cli and @stratum-eng/agent to npm

Both packages live in the repo at full API parity but are not yet published,
so consumers must install from source.
Expand Down
2 changes: 1 addition & 1 deletion docs/user-guide/cli.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# The Stratum CLI

`@stratum/cli` puts the change flow in the terminal: projects, workspaces,
`@stratum-eng/cli` puts the change flow in the terminal: projects, workspaces,
commits, evaluation-gated changes, reviews, and issues, each command a thin
wrapper over the [REST API](../api/endpoints/README.md). It is built for humans
and shell scripts; agents are usually better served by the
Expand Down
2 changes: 1 addition & 1 deletion docs/user-guide/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -204,7 +204,7 @@ Artifacts namespaces.
## What license is Stratum under, and what does self-hosting oblige me to?

Licensing is by directory: the server, web UI, `docs/`, and `website/` sources
are **AGPL-3.0-or-later**; the `@stratum/cli` and `@stratum/agent` packages are
are **AGPL-3.0-or-later**; the `@stratum-eng/cli` and `@stratum-eng/agent` packages are
**Apache-2.0**; the published agent skills under
`website/public/.well-known/agent-skills/` stay **MIT**, because they exist to be
pasted into third-party agents. Releases through v0.2.0 were MIT and stay MIT.
Expand Down
2 changes: 1 addition & 1 deletion docs/user-guide/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -366,7 +366,7 @@ If a change was linked to an issue, the issue auto-closes on merge.

## 6. Connect your tools

### CLI — `@stratum/cli`
### CLI — `@stratum-eng/cli`

The CLI wraps the full REST API: projects, workspaces, commits, changes
(including review and merge), issues, and activity. It is not yet published to
Expand Down
4 changes: 2 additions & 2 deletions website/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion website/package.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "@stratum/website",
"name": "@stratum-eng/website",
"version": "0.1.0",
"private": true,
"license": "MIT",
Expand Down
2 changes: 1 addition & 1 deletion website/scripts/mirror-docs.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ const GUIDES = [
["issues", "Open, triage, search, and link issues — and how a merged change closes them."],
["ci-integration", "Bring your own CI: run evaluations on your existing infrastructure and report verdicts back."],
["deployments", "Publish the merged tree to Cloudflare or Vercel after a change lands — the deploys: policy block, encrypted project secrets, the approval gate, limits, and what v1 does not do."],
["cli", "Install and use @stratum/cli — projects, workspaces, commits, and the change flow from the terminal."],
["cli", "Install and use @stratum-eng/cli — projects, workspaces, commits, and the change flow from the terminal."],
["mcp", "Connect any MCP-capable agent or editor to the evaluation-gated change flow over the hosted /mcp endpoint — OAuth 2.1, nothing to install."],
["troubleshooting", "Symptoms and fixes for auth, imports, evaluation, merges, and access."],
["faq", "Common questions about Stratum's merge gate, provenance, CI, limitations, and telemetry."],
Expand Down
4 changes: 2 additions & 2 deletions website/src/content/docs/guides/cli.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: "The Stratum CLI"
description: "Install and use @stratum/cli — projects, workspaces, commits, and the change flow from the terminal."
description: "Install and use @stratum-eng/cli — projects, workspaces, commits, and the change flow from the terminal."
editUrl: "https://github.com/stratum-eng/stratum/edit/main/docs/user-guide/cli.md"
---

`@stratum/cli` puts the change flow in the terminal: projects, workspaces,
`@stratum-eng/cli` puts the change flow in the terminal: projects, workspaces,
commits, evaluation-gated changes, reviews, and issues, each command a thin
wrapper over the [REST API](/reference/endpoints/). It is built for humans
and shell scripts; agents are usually better served by the
Expand Down
2 changes: 1 addition & 1 deletion website/src/content/docs/guides/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -208,7 +208,7 @@ Artifacts namespaces.
## What license is Stratum under, and what does self-hosting oblige me to?

Licensing is by directory: the server, web UI, `docs/`, and `website/` sources
are **AGPL-3.0-or-later**; the `@stratum/cli` and `@stratum/agent` packages are
are **AGPL-3.0-or-later**; the `@stratum-eng/cli` and `@stratum-eng/agent` packages are
**Apache-2.0**; the published agent skills under
`website/public/.well-known/agent-skills/` stay **MIT**, because they exist to be
pasted into third-party agents. Releases through v0.2.0 were MIT and stay MIT.
Expand Down
2 changes: 1 addition & 1 deletion website/src/content/docs/guides/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -370,7 +370,7 @@ If a change was linked to an issue, the issue auto-closes on merge.

## 6. Connect your tools

### CLI — `@stratum/cli`
### CLI — `@stratum-eng/cli`

The CLI wraps the full REST API: projects, workspaces, commits, changes
(including review and merge), issues, and activity. It is not yet published to
Expand Down
Loading