@stacknext/core 0.11.0 → 0.11.1

package/README.md

@@ -1,7 +1,8 @@
 # @stacknext/core
 
 Core wire types, Zod schemas, redaction, configuration, framework span metadata,
-bounded in-memory storage and async transport for [StackNext](https://github.com/marrrkkk/stacknext).
+bounded in-memory storage, async transport and snapshot storage for
+[StackNext](https://github.com/marrrkkk/stacknext).
 
 This package is the shared foundation for the StackNext CLI, adapters and app
 instrumentation. Most applications should install `@stacknext/cli` and
@@ -13,7 +14,52 @@ npx stacknext init
 npx stacknext dev
 ```
 
-The package is ESM-only, requires Node.js 20.9 or newer and does not perform
-network I/O unless a loopback collector URL and token are supplied.
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@stacknext/core` | Wire types, Zod schemas, redaction, normalization, bounded store, framework span allowlist, coverage, diagnostic wire types, config, verbose status. |
+| `@stacknext/core/transport` | Process-wide bounded transport, environment resolution and loopback validation. |
+| `@stacknext/core/config-file` | `stacknext.config.json` path, reading and loading with Zod validation. |
+| `@stacknext/core/snapshots` | Snapshot payloads, atomic local storage, listing, import/export and detached read views. |
+| `@stacknext/core/package.json` | Installed version metadata. |
+
+## Package boundary
+
+`core` is the base of the dependency graph. It must not import CLI, Next.js,
+React, Playwright or adapter code. It validates external data at the boundary,
+performs both redaction layers' shared primitives, and never performs network
+I/O unless a loopback collector URL and token are supplied.
+
+## Documentation
+
+- [Package overview](docs/index.md)
+- [Wire schemas](docs/schemas.md)
+- [Transport](docs/transport.md)
+- [Redaction](docs/redaction.md)
+- [Configuration](docs/configuration.md)
+- [Snapshots](docs/snapshots.md)
+
+The `docs/` directory ships in the npm archive and matches the installed
+version. Public concepts live on the
+[documentation site](https://github.com/marrrkkk/stacknext/tree/main/apps/docs).
+
+## AI agents
+
+Agents should read `docs/index.md` and the focused package pages from the
+installed archive before changing wire fields, limits or redaction. The package
+does not call a model and does not expose an MCP surface; the read-only server
+is in `@stacknext/mcp`.
+
+## Development
+
+```bash
+pnpm --filter @stacknext/core build
+pnpm --filter @stacknext/core typecheck
+pnpm test
+```
+
+This package is ESM-only, requires Node.js 20.9 or newer and is published as an
+internal dependency of the StackNext CLI and integrations.
 
 License: MIT.

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import type { StackNextConfig } from './config.js';
 import type { DiagnosticOverview, DiagnosticReference, DiagnosticReport } from './diagnostics.js';
 export declare const STACKNEXT_SCHEMA_VERSION = 1;
-export declare const STACKNEXT_SDK_VERSION = "0.11.0";
+export declare const STACKNEXT_SDK_VERSION = "0.11.1";
 export declare const SPAN_KINDS: readonly ["internal", "server", "client", "producer", "consumer"];
 export type StackNextSpanKind = (typeof SPAN_KINDS)[number];
 export declare const SPAN_STATUSES: readonly ["unset", "ok", "error"];

package/dist/types.js

@@ -1,5 +1,5 @@
 export const STACKNEXT_SCHEMA_VERSION = 1;
-export const STACKNEXT_SDK_VERSION = '0.11.0';
+export const STACKNEXT_SDK_VERSION = '0.11.1';
 export const SPAN_KINDS = ['internal', 'server', 'client', 'producer', 'consumer'];
 export const SPAN_STATUSES = ['unset', 'ok', 'error'];
 export const DATABASE_SOURCES = ['drizzle', 'prisma', 'manual'];

package/docs/redaction.md

@@ -99,6 +99,6 @@ A new captured field is not complete until:
 
 1. the app-side producer redacts it;
 2. the collector validates and redacts it again;
-3. `docs/privacy.md` and the package docs describe it;
+3. `apps/docs/privacy.md` and the package docs describe it;
 4. a test asserts that known secrets do not appear in API, export, regression
    or snapshot output.

package/docs/schemas.md

@@ -150,5 +150,5 @@ read `meta.completeness` or response `limitations` before drawing conclusions.
   correlation.
 - Redaction runs before enqueueing and again before storage.
 
-See [redaction](redaction.md) and the collector's
-the repository `docs/privacy.md` for the data boundary.
+See [redaction](redaction.md) and the repository `apps/docs/privacy.md` for the
+data boundary.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacknext/core",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Core telemetry schema, redaction, configuration and bounded storage for StackNext",
   "license": "MIT",
   "type": "module",