Point install docs at @logicsrc/opencontext; record the npm name collision

The unscoped `opencontext` name is already published on npm by an unrelated
third party (federicodeponte/opencontext, 2.0.0), so `npx opencontext` would
install a stranger's package. Docs now use `npx @logicsrc/opencontext`; the bin
stays named `opencontext` so the command reads as the PRD specifies once
installed.

Recorded in PRD 0003 as a blocker to resolve before any publication, along with
the fact that no @logicsrc spec package has ever been published, so there is no
existing release path to slot into.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Anthony Ettinger 2026-08-09 18:30:28 +00:00
parent ec3ed64f20
commit dc56e4c741
7 changed files with 31 additions and 17 deletions

View file

@ -116,9 +116,9 @@ replaceable workers without losing institutional state.
> An agent should be replaceable without losing organizational knowledge.
```bash
npx opencontext init my-context
npx opencontext validate --strict
npx opencontext resolve --role support --task "customer asked for a refund" --explain
npx @logicsrc/opencontext init my-context
npx @logicsrc/opencontext validate --strict
npx @logicsrc/opencontext resolve --role support --task "customer asked for a refund" --explain
```
```txt

View file

@ -37,7 +37,7 @@ Everything in OpenContext is one of five things.
Five minutes, no account, no network, no model key.
```bash
npx opencontext init my-context
npx @logicsrc/opencontext init my-context
cd my-context
opencontext validate --strict
@ -343,8 +343,8 @@ jobs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npx opencontext validate --strict
- run: npx opencontext doctor --strict
- run: npx @logicsrc/opencontext validate --strict
- run: npx @logicsrc/opencontext doctor --strict
```
Exit codes are stable: `0` ok, `1` invalid, `2` usage, `3` not found.

View file

@ -1,7 +1,7 @@
# CLI reference
```bash
npx opencontext <command> # standalone
npx @logicsrc/opencontext <command> # standalone
logicsrc context <command> # inside the LogicSRC CLI
```
@ -245,9 +245,9 @@ opencontext version # the supported specification version
## CI
```yaml
- run: npx opencontext validate --strict
- run: npx opencontext doctor --strict
- run: npx opencontext bundle --role support --output bundle.json
- run: npx @logicsrc/opencontext validate --strict
- run: npx @logicsrc/opencontext doctor --strict
- run: npx @logicsrc/opencontext bundle --role support --output bundle.json
```
Common gates:

View file

@ -129,7 +129,7 @@ No. OpenContext is independently usable, and the specification does not depend o
### Where do I start?
```bash
npx opencontext init my-context
npx @logicsrc/opencontext init my-context
```
Then read [`examples/opencontext/minimal`](../../examples/opencontext/minimal), and when you have two roles that need different things, read [`multi-agent-company`](../../examples/opencontext/multi-agent-company).

View file

@ -108,9 +108,9 @@ jobs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npx opencontext validate --strict
- run: npx opencontext doctor --strict
- run: npx opencontext bundle --role support --output bundle.json
- run: npx @logicsrc/opencontext validate --strict
- run: npx @logicsrc/opencontext doctor --strict
- run: npx @logicsrc/opencontext bundle --role support --output bundle.json
- uses: actions/upload-artifact@v4
with:
name: context-bundle

View file

@ -15,9 +15,9 @@ Five working [OpenContext](../../docs/opencontext.md) repositories. Every one is
```bash
cd minimal
npx opencontext validate --strict
npx opencontext doctor
npx opencontext resolve --role everyone --format markdown
npx @logicsrc/opencontext validate --strict
npx @logicsrc/opencontext doctor
npx @logicsrc/opencontext resolve --role everyone --format markdown
```
Or from anywhere, since discovery searches upward:

View file

@ -183,6 +183,20 @@ that quietly diverged would become a second contract.
- **Digest churn.** A resolver bug fix that changes what is selected changes
bundle digests, which a consumer might read as tampering. Mitigated by calling
such fixes out explicitly in the changelog.
- **Blocker: the `opencontext` npm name is taken.** This PRD proposes
`opencontext` as the package name and `npx opencontext` as the install path.
That name is already published by an unrelated third party
(`federicodeponte/opencontext`, currently 2.0.0, "AI-powered company context
analysis from your terminal") — and being adjacent in subject matter makes the
confusion worse, not better. Documentation therefore ships pointing at
`npx @logicsrc/opencontext`, and the `bin` is still named `opencontext` so the
command reads as specified once installed. Resolving this needs a decision
before any publication: request a transfer, pick a different unscoped name, or
commit to the scoped package permanently.
- **No publication pipeline exists yet.** Neither `@logicsrc/openprd` nor
`@logicsrc/openontology` has ever been published to npm, so OpenContext is not
slotting into an established release path — one has to be built. Until then
the only distribution is this repository.
- **Open question.** Should interior wildcards (`customers.*.churn-risk`) remain
single-segment only, or should a future minor version add a bounded multi-
segment form? Single-segment is shipped in v1 because the alternative silently