feat: establish standalone Rstack context runtime

.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions: {}
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Setup Node.js
+        uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: 24.15.0
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Check
+        run: pnpm check
+
+      - name: Build
+        run: pnpm build
+
+      - name: Test
+        run: pnpm test
+
+      - name: Pack
+        run: |
+          mkdir -p .artifacts
+          pnpm pack --pack-destination .artifacts

.github/workflows/pkg-pr-new.yml

@@ -0,0 +1,50 @@
+name: Publish Package Previews
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions: {}
+
+jobs:
+  publish:
+    if: github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Setup Node.js
+        uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: 24.15.0
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
+      - name: Publish package preview
+        shell: bash
+        run: |
+          set +e
+          output=$(pnpm exec pkg-pr-new publish --pnpm --previewVersion --no-template '.' 2>&1)
+          status=$?
+          set -e
+          printf '%s\n' "$output"
+
+          if [ "$status" -eq 0 ]; then
+            exit 0
+          fi
+
+          if [[ "$output" == *'There is no workflow defined'* ]]; then
+            echo '::warning title=pkg.pr.new is not enabled::Grant the pkg.pr.new GitHub App access to rstackjs/context to publish preview packages.'
+            exit 0
+          fi
+
+          exit "$status"

.gitignore

@@ -0,0 +1,5 @@
+.artifacts
+coverage
+dist
+dist-tests
+node_modules

.prettierignore

@@ -0,0 +1,4 @@
+coverage
+dist
+dist-tests
+pnpm-lock.yaml

.prettierrc.json

@@ -0,0 +1,4 @@
+{
+  "printWidth": 100,
+  "singleQuote": true
+}

AGENTS.md

@@ -0,0 +1,35 @@
+# AGENTS.md
+
+## Stack
+
+- Use the Node.js and pnpm versions declared in `package.json`.
+- TypeScript package built with Rslib.
+- Rsbuild APIs power build-context observation.
+- Rstest runs tests and coverage.
+- Rslint performs lint and type-aware checks.
+
+## Commands
+
+```bash
+corepack enable
+pnpm install
+pnpm check
+pnpm build
+pnpm test
+pnpm test:coverage
+```
+
+## Architecture
+
+- Keep the context runtime independent of the `rstack` CLI package.
+- Keep Rstack-specific command and configuration adapters in `rstackjs/rstack-cli`.
+- Keep Codex and Claude plugin packaging and skills in `rstackjs/agent-skills`.
+- Preserve freshness, completeness, provenance, and evidence axes independently.
+- Missing Rstack producers must degrade to unavailable evidence rather than prevent other tools from
+  working.
+
+## Changes
+
+- Add tests for public API, store-schema, MCP-schema, or evidence-semantic changes.
+- Keep the package API and MCP tool schemas backward compatible unless a breaking change is explicit.
+- Use pkg.pr.new previews for cross-repository Rstack CLI validation.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rstack contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,2 +1,34 @@
-# context
-Rstack project context, evidence storage, and MCP runtime.
+# Rstack context
+
+`@rstackjs/context` is the runtime behind the Rstack project-context MCP. It records and queries
+checkout-local build, lint, test, coverage, and Rsdoctor evidence while keeping freshness,
+completeness, and provenance explicit.
+
+Most users install and invoke it through the `rstack` package:
+
+```bash
+rs mcp
+```
+
+The `rstack/context` export re-exports this package for programmatic consumers. Codex and Claude
+Code workflow guidance is distributed separately by
+[`rstackjs/agent-skills`](https://github.com/rstackjs/agent-skills).
+
+## Development
+
+```bash
+corepack enable
+pnpm install
+pnpm check
+pnpm build
+pnpm test
+```
+
+The package uses Rslib for builds, Rstest for tests, and Rslint for lint and type-aware checks.
+Rsbuild remains a public integration surface for build-context observers. See the
+[context engine RFC](./docs/rfc.md) for the runtime architecture and evidence semantics.
+
+Execution coverage evidence is optional and resolved against the package under test, not against
+`@rstackjs/context` itself: install `@rstest/coverage-istanbul` (or another supported Rstest
+coverage provider) as a dependency of the checkout being analyzed for coverage evidence to be
+captured. `@rstackjs/context` does not declare that provider as a peer dependency.