@kitsy/cnos-docs 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kitsy
+
+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.

package/README.md

@@ -0,0 +1,10 @@
+# @kitsy/cnos-docs
+
+Source-of-truth documentation content for CNOS.
+
+This package is framework-agnostic content intended to be consumed by Astro Starlight or any other static documentation builder that can read Markdown/MDX plus a navigation manifest.
+
+Exports:
+- `@kitsy/cnos-docs/manifest`
+- `@kitsy/cnos-docs/docs/*`
+- `@kitsy/cnos-docs/assets/*`

package/assets/images/README.md

@@ -0,0 +1,3 @@
+# Images
+
+Place architecture diagrams, screenshots, and other rendered assets here.

package/docs/api/browser.mdx

@@ -0,0 +1,14 @@
+---
+title: Browser Runtime
+description: Read promoted public values from browser bundles.
+---
+
+# Browser Runtime
+
+```ts
+import cnos from '@kitsy/cnos/browser';
+
+console.log(cnos('public.app.apiBaseUrl'));
+```
+
+Only promoted browser-safe values are available here.

package/docs/api/create-cnos.mdx

@@ -0,0 +1,15 @@
+---
+title: createCnos()
+description: Explicitly create a CNOS runtime with options and plugins.
+---
+
+# createCnos()
+
+```ts
+import { createCnos } from '@kitsy/cnos/configure';
+
+const runtime = await createCnos({
+  workspace: 'api',
+  profile: 'stage',
+});
+```

package/docs/api/index.mdx

@@ -0,0 +1,12 @@
+---
+title: API Reference
+description: Overview of the CNOS runtime and explicit configuration surfaces.
+---
+
+# API Reference
+
+Use:
+
+- `@kitsy/cnos` for the default singleton runtime
+- `@kitsy/cnos/configure` for `createCnos()`
+- `@kitsy/cnos/browser` for browser-safe promoted values

package/docs/api/runtime.mdx

@@ -0,0 +1,16 @@
+---
+title: Singleton Runtime
+description: Use the default CNOS runtime singleton from the root package.
+---
+
+# Singleton Runtime
+
+```ts
+import cnos from '@kitsy/cnos';
+
+await cnos.ready();
+
+cnos('value.app.name');
+cnos.value('app.name');
+cnos.secret('app.token');
+```

package/docs/api/types.mdx

@@ -0,0 +1,13 @@
+---
+title: Types
+description: Core CNOS TypeScript types and generated wrappers.
+---
+
+# Types
+
+CNOS exposes:
+
+- `CnosRuntime`
+- `CnosCreateOptions`
+- `LogicalKey`
+- generated schema wrappers through `cnos codegen`

package/docs/cli/codegen.mdx

@@ -0,0 +1,12 @@
+---
+title: cnos codegen
+description: Generate typed CNOS wrappers from schema.
+---
+
+# cnos codegen
+
+```bash
+cnos codegen
+cnos codegen --out src/cnos-config.d.ts
+cnos codegen --watch
+```

package/docs/cli/diff.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos diff
+description: Compare resolved config across profiles or workspaces.
+---
+
+# cnos diff
+
+```bash
+cnos diff base stage
+cnos diff --workspace api --profile base --other-profile stage
+```

package/docs/cli/doctor.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos doctor
+description: Run diagnostics across workspaces, exports, and security rules.
+---
+
+# cnos doctor
+
+```bash
+cnos doctor
+cnos doctor --json
+```

package/docs/cli/drift.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos drift
+description: Compare schema expectations against the resolved graph.
+---
+
+# cnos drift
+
+```bash
+cnos drift
+cnos drift --json
+```

package/docs/cli/dump.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos dump
+description: Materialize the selected CNOS state into deterministic files.
+---
+
+# cnos dump
+
+```bash
+cnos dump --to ./.cnos-out
+cnos dump --flatten --to ./.cnos-out
+```

package/docs/cli/export.mdx

@@ -0,0 +1,12 @@
+---
+title: cnos export
+description: Export explicit env mappings and public projections.
+---
+
+# cnos export
+
+```bash
+cnos export env
+cnos export env --to .env.local
+cnos export env --public --framework vite --to .env.local
+```

package/docs/cli/index.mdx

@@ -0,0 +1,15 @@
+---
+title: CLI Reference
+description: Overview of the CNOS CLI surface and command groups.
+---
+
+# CLI Reference
+
+The CLI is organized around:
+
+- setup: `init`, `onboard`, `use`, `profile`
+- data operations: `read`, `value`, `secret`, `promote`
+- workflows: `run`, `export`, `dump`, `diff`, `doctor`
+- advanced tooling: `codegen`, `watch`, `migrate`, `drift`, `vault`
+
+See the individual command pages in this section.

package/docs/cli/init.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos init
+description: Scaffold a CNOS project structure in the current repo.
+---
+
+# cnos init
+
+```bash
+cnos init
+cnos init --workspace api
+```

package/docs/cli/inspect.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos inspect
+description: Inspect resolved values, provenance, and overrides.
+---
+
+# cnos inspect
+
+```bash
+cnos inspect value.app.name
+cnos inspect secret.app.token --reveal
+```

package/docs/cli/migrate.mdx

@@ -0,0 +1,12 @@
+---
+title: cnos migrate
+description: Discover existing env usage and map it into CNOS.
+---
+
+# cnos migrate
+
+```bash
+cnos migrate --scan src --dry-run
+cnos migrate --apply
+cnos migrate --apply --rewrite
+```

package/docs/cli/promote.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos promote
+description: Promote shareable values into public or env export surfaces.
+---
+
+# cnos promote
+
+```bash
+cnos promote value.flag.auth.upi_enabled --to public
+cnos promote value.server.port --to env --as PORT
+```

package/docs/cli/read.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos read
+description: Read a fully-qualified logical key.
+---
+
+# cnos read
+
+```bash
+cnos read value.app.name
+cnos read secret.app.token
+```

package/docs/cli/run.mdx

@@ -0,0 +1,14 @@
+---
+title: cnos run
+description: Start a process with CNOS-injected env and runtime bootstrap data.
+---
+
+# cnos run
+
+`run` is the lowest-friction adoption path for most teams.
+
+```bash
+cnos run -- node server.js
+cnos run --profile stage -- pnpm build
+cnos run --auth -- node server.js
+```

package/docs/cli/secret.mdx

@@ -0,0 +1,13 @@
+---
+title: cnos secret
+description: Set, get, list, and delete secrets through configured vaults.
+---
+
+# cnos secret
+
+```bash
+cnos secret set app.token super-secret --vault default
+cnos secret get app.token --vault default --reveal
+cnos secret list
+cnos secret delete app.token
+```

package/docs/cli/validate.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos validate
+description: Validate the resolved graph against schema and safety rules.
+---
+
+# cnos validate
+
+```bash
+cnos validate
+cnos validate --profile stage
+```

package/docs/cli/value.mdx

@@ -0,0 +1,13 @@
+---
+title: cnos value
+description: Set, get, list, and delete value entries.
+---
+
+# cnos value
+
+```bash
+cnos value set app.name demo
+cnos value get app.name
+cnos value list --prefix app.
+cnos value delete app.name
+```

package/docs/cli/vault.mdx

@@ -0,0 +1,14 @@
+---
+title: cnos vault
+description: Manage vault definitions and auth sessions.
+---
+
+# cnos vault
+
+```bash
+cnos vault create default
+cnos vault auth default
+cnos vault list
+cnos vault logout default
+cnos vault remove default
+```

package/docs/cli/watch.mdx

@@ -0,0 +1,11 @@
+---
+title: cnos watch
+description: Watch config changes and emit signals or restart processes.
+---
+
+# cnos watch
+
+```bash
+cnos watch -- node server.js
+cnos watch --signal
+```

package/docs/concepts/config-spectrum.mdx

@@ -0,0 +1,15 @@
+---
+title: The Config Spectrum
+description: Position CNOS between flat .env files and platform-specific config systems.
+---
+
+# The Config Spectrum
+
+CNOS is meant to cover:
+
+- simple single-project `.env` use
+- structured app/server config
+- multi-workspace monorepos
+- CI/CD env bridges
+- browser-safe public projection
+- secure secret refs and vault-backed resolution

package/docs/concepts/how-it-works.mdx

@@ -0,0 +1,13 @@
+---
+title: How CNOS Works
+description: Mental model for how sources become a resolved graph and then user-facing surfaces.
+---
+
+# How CNOS Works
+
+Conceptually:
+
+1. CNOS discovers the repo and workspace context.
+2. Loaders contribute entries from files, env, args, and vault-backed refs.
+3. CNOS resolves one winning graph.
+4. The graph is exposed through runtime APIs, CLI inspection, env export, and browser projection.

package/docs/getting-started/index.mdx

@@ -0,0 +1,25 @@
+---
+title: Getting Started
+description: Learn the main CNOS concepts and the recommended first steps.
+---
+
+# Getting Started
+
+CNOS has three primary surfaces:
+
+- `@kitsy/cnos` for the default runtime singleton
+- `@kitsy/cnos/configure` for explicit runtime creation
+- `@kitsy/cnos-cli` for project setup, inspection, export, and workflow commands
+
+Recommended path:
+
+1. Install the CLI and runtime.
+2. Run `cnos init`.
+3. Define a few values.
+4. Use `cnos run` or import `cnos` in app code.
+
+Continue with:
+
+- [Installation](./installation.mdx)
+- [Quick Start](./quick-start.mdx)
+- [Your First Project](./your-first-project.mdx)

package/docs/getting-started/installation.mdx

@@ -0,0 +1,31 @@
+---
+title: Installation
+description: Install CNOS packages for local development, app code, and framework integrations.
+---
+
+# Installation
+
+Global CLI:
+
+```bash
+npm install -g @kitsy/cnos-cli
+cnos --version
+```
+
+Runtime in an app:
+
+```bash
+npm install @kitsy/cnos
+```
+
+Vite:
+
+```bash
+npm install @kitsy/cnos @kitsy/cnos-vite
+```
+
+Next.js:
+
+```bash
+npm install @kitsy/cnos @kitsy/cnos-next
+```

package/docs/getting-started/quick-start.mdx

@@ -0,0 +1,32 @@
+---
+title: Quick Start
+description: Go from zero to a running CNOS-backed project in a few minutes.
+---
+
+# Quick Start
+
+```bash
+cnos init
+cnos value set app.name demo
+cnos value set server.port 3000
+cnos read value.app.name
+cnos run -- node server.js
+```
+
+In app code:
+
+```ts
+import cnos from '@kitsy/cnos';
+
+await cnos.ready();
+console.log(cnos('value.app.name'));
+```
+
+For explicit creation:
+
+```ts
+import { createCnos } from '@kitsy/cnos/configure';
+
+const runtime = await createCnos();
+console.log(runtime.value('app.name'));
+```

package/docs/getting-started/your-first-project.mdx

@@ -0,0 +1,35 @@
+---
+title: Your First Project
+description: Set up a simple CNOS project with values, a profile, and a local vault.
+---
+
+# Your First Project
+
+Create the project structure:
+
+```bash
+cnos init
+cnos doctor
+```
+
+Add values:
+
+```bash
+cnos value set app.name my-service
+cnos value set server.port 3000
+```
+
+Create a profile:
+
+```bash
+cnos profile create stage --inherit base
+cnos use --profile stage
+```
+
+Create a local vault and authenticate it:
+
+```bash
+cnos vault create default
+cnos vault auth default
+cnos secret set app.token super-secret --vault default
+```

package/docs/guides/backend.mdx

@@ -0,0 +1,29 @@
+---
+title: Backend Projects
+description: Use CNOS in pure backend services, workers, and APIs.
+---
+
+# Backend Projects
+
+Backend projects usually use one of two patterns:
+
+- `cnos run -- <command>` for zero-code-change adoption
+- `import cnos from '@kitsy/cnos'` for direct runtime reads
+
+Example:
+
+```ts
+import cnos from '@kitsy/cnos';
+
+await cnos.ready();
+
+const port = cnos.value('server.port');
+const token = cnos.secret('app.token');
+```
+
+Env export bridge:
+
+```bash
+cnos export env --to .env.local
+cnos export env --profile stage --to .env.stage
+```

package/docs/guides/ci-cd.mdx

@@ -0,0 +1,21 @@
+---
+title: CI/CD Pipelines
+description: Use CNOS in build and deploy pipelines without committing generated env files.
+---
+
+# CI/CD Pipelines
+
+Common patterns:
+
+```bash
+cnos export env --profile stage --to .env.stage
+cnos export env --public --framework vite --profile stage --to .env.stage
+cnos run --profile stage -- pnpm build
+```
+
+For CI-backed vaults:
+
+```bash
+cnos vault create github-ci --provider github-secrets --no-passphrase
+cnos secret set app.token APP_TOKEN --vault github-ci
+```

package/docs/guides/frontend-next.mdx

@@ -0,0 +1,14 @@
+---
+title: Frontend with Next.js
+description: Use CNOS public projection with Next.js builds and browser-safe runtime reads.
+---
+
+# Frontend with Next.js
+
+```ts
+import { withCnosNext } from '@kitsy/cnos-next';
+
+export default withCnosNext({});
+```
+
+Browser-safe values remain under `public.promote` and are exposed as `NEXT_PUBLIC_*` plus browser-runtime data for `@kitsy/cnos/browser`.

package/docs/guides/frontend-vite.mdx

@@ -0,0 +1,34 @@
+---
+title: Frontend with Vite
+description: Project browser-safe CNOS values into Vite and use the browser runtime.
+---
+
+# Frontend with Vite
+
+Promote browser-safe values:
+
+```yaml
+public:
+  promote:
+    - value.app.apiBaseUrl
+```
+
+Use the Vite plugin:
+
+```ts
+import { defineConfig } from 'vite';
+import { createCnosVitePlugin } from '@kitsy/cnos-vite';
+
+export default defineConfig({
+  plugins: [createCnosVitePlugin()],
+});
+```
+
+Read in client code:
+
+```ts
+import cnos from '@kitsy/cnos/browser';
+
+console.log(cnos('public.app.apiBaseUrl'));
+console.log(import.meta.env.VITE_APP_API_BASE_URL);
+```

package/docs/guides/migration.mdx

@@ -0,0 +1,21 @@
+---
+title: Migrating from .env
+description: Move existing env-based projects onto CNOS without losing current workflows.
+---
+
+# Migrating from .env
+
+Use the migration assistant:
+
+```bash
+cnos migrate --scan src --dry-run
+cnos migrate --apply
+cnos migrate --apply --rewrite
+```
+
+Bridge to existing tooling:
+
+```bash
+cnos export env --to .env.local
+cnos export env --profile stage --to .env.stage
+```

package/docs/guides/profiles.mdx

@@ -0,0 +1,15 @@
+---
+title: Profiles and Environments
+description: Create explicit overlays for stage, prod, and other environments.
+---
+
+# Profiles and Environments
+
+Profiles are explicit overlays, not implicit defaults.
+
+```bash
+cnos profile create stage --inherit base
+cnos use --profile stage
+cnos value set app.apiBaseUrl https://api.stage
+cnos diff base stage
+```

package/docs/guides/secrets.mdx

@@ -0,0 +1,27 @@
+---
+title: Secrets and Vaults
+description: Securely manage secrets with local and CI-backed vaults.
+---
+
+# Secrets and Vaults
+
+Local vault:
+
+```bash
+cnos vault create default
+cnos vault auth default
+cnos secret set app.token super-secret --vault default
+```
+
+CI-backed vault:
+
+```bash
+cnos vault create github-ci --provider github-secrets --no-passphrase
+cnos secret set app.token APP_TOKEN --vault github-ci
+```
+
+By default:
+
+- repo files store only refs
+- local secret material stays outside the repo
+- reads are masked unless `--reveal` is explicitly requested

package/docs/guides/ssr.mdx

@@ -0,0 +1,14 @@
+---
+title: SSR Projects
+description: Combine CNOS server reads with browser-safe projection in SSR applications.
+---
+
+# SSR Projects
+
+Use `@kitsy/cnos` on the server and `@kitsy/cnos/browser` only for promoted public values.
+
+Typical split:
+
+- server: `cnos.value(...)`, `cnos.secret(...)`
+- browser: `cnos('public.some.key')`
+- framework build: `@kitsy/cnos-vite` or `@kitsy/cnos-next`

package/docs/guides/workspaces.mdx

@@ -0,0 +1,22 @@
+---
+title: Workspaces and Monorepos
+description: Use CNOS workspaces to model multiple apps inside one repo.
+---
+
+# Workspaces and Monorepos
+
+In single-project mode, CNOS stays simple.
+
+For monorepos:
+
+```bash
+cnos init --workspace api
+cnos use --workspace api
+cnos list values
+```
+
+Override per command when needed:
+
+```bash
+cnos list values --workspace webapp
+```

package/docs/index.mdx

@@ -0,0 +1,18 @@
+---
+title: CNOS Documentation
+description: Overview of CNOS, its runtime model, and the documentation structure.
+---
+
+# CNOS Documentation
+
+CNOS is a configuration orchestration system for server applications, frontend builds, SSR apps, monorepos, and deployment pipelines.
+
+This package is the source-of-truth documentation set that downstream sites, including Astro Starlight, can consume directly.
+
+Start here:
+
+- [Getting Started](./getting-started/index.mdx)
+- [Backend Guide](./guides/backend.mdx)
+- [Frontend with Vite](./guides/frontend-vite.mdx)
+- [Secrets and Vaults](./guides/secrets.mdx)
+- [CLI Reference](./cli/index.mdx)

package/docs/reference/manifest.mdx

@@ -0,0 +1,19 @@
+---
+title: Manifest
+description: Reference for .cnos/cnos.yml and its main sections.
+---
+
+# Manifest
+
+Key sections:
+
+- `project`
+- `workspaces`
+- `profiles`
+- `envMapping`
+- `public`
+- `vaults`
+- `schema`
+- `writePolicy`
+
+Use the main repo spec for the exhaustive schema until this reference grows into the full field-by-field version.

package/docs/reference/namespaces.mdx

@@ -0,0 +1,17 @@
+---
+title: Namespaces
+description: Understand value, secret, meta, public, and env projection surfaces.
+---
+
+# Namespaces
+
+Primary namespaces:
+
+- `value.*`
+- `secret.*`
+- `meta.*`
+
+Derived surfaces:
+
+- `public.*` for promoted browser-safe values
+- explicit env exports through `envMapping.explicit`

package/docs/reference/resolution.mdx

@@ -0,0 +1,16 @@
+---
+title: Resolution
+description: How CNOS resolves precedence, workspaces, profiles, and derived outputs.
+---
+
+# Resolution
+
+Resolution order is shaped by:
+
+- workspace context
+- workspace inheritance
+- profile selection
+- loader precedence
+- explicit promotions and env mappings
+
+Use `cnos inspect`, `cnos diff`, and `cnos drift` when you need to debug the final result.

package/docs/reference/security.mdx

@@ -0,0 +1,14 @@
+---
+title: Security
+description: Secret storage, masking, vault auth sessions, and safe output rules.
+---
+
+# Security
+
+CNOS secret rules:
+
+- repo files store refs, not plaintext secret material
+- local vault material is encrypted outside the repo
+- reads are masked by default
+- browser and public outputs never expose `secret.*`
+- `vault auth` manages session-based access to local vaults

package/manifest.yml

@@ -0,0 +1,111 @@
+product: cnos
+title: CNOS Documentation
+tagline: Configuration orchestration for apps, monorepos, and deployment pipelines
+version: "1.3"
+
+sidebar:
+  - group: Getting Started
+    items:
+      - path: getting-started/index
+        label: Overview
+      - path: getting-started/installation
+        label: Installation
+      - path: getting-started/quick-start
+        label: Quick Start
+      - path: getting-started/your-first-project
+        label: Your First Project
+
+  - group: Guides
+    items:
+      - path: guides/backend
+        label: Backend Projects
+      - path: guides/frontend-vite
+        label: Frontend with Vite
+      - path: guides/frontend-next
+        label: Frontend with Next.js
+      - path: guides/ssr
+        label: SSR Projects
+      - path: guides/ci-cd
+        label: CI/CD Pipelines
+      - path: guides/workspaces
+        label: Workspaces and Monorepos
+      - path: guides/profiles
+        label: Profiles and Environments
+      - path: guides/secrets
+        label: Secrets and Vaults
+      - path: guides/migration
+        label: Migrating from .env
+
+  - group: CLI Reference
+    collapsed: true
+    items:
+      - path: cli/index
+        label: Overview
+      - path: cli/init
+        label: cnos init
+      - path: cli/value
+        label: cnos value
+      - path: cli/secret
+        label: cnos secret
+      - path: cli/read
+        label: cnos read
+      - path: cli/inspect
+        label: cnos inspect
+      - path: cli/validate
+        label: cnos validate
+      - path: cli/export
+        label: cnos export
+      - path: cli/run
+        label: cnos run
+      - path: cli/diff
+        label: cnos diff
+      - path: cli/dump
+        label: cnos dump
+      - path: cli/doctor
+        label: cnos doctor
+      - path: cli/promote
+        label: cnos promote
+      - path: cli/vault
+        label: cnos vault
+      - path: cli/codegen
+        label: cnos codegen
+      - path: cli/watch
+        label: cnos watch
+      - path: cli/migrate
+        label: cnos migrate
+      - path: cli/drift
+        label: cnos drift
+
+  - group: API Reference
+    collapsed: true
+    items:
+      - path: api/index
+        label: Overview
+      - path: api/create-cnos
+        label: createCnos()
+      - path: api/runtime
+        label: Singleton Runtime
+      - path: api/browser
+        label: Browser Runtime
+      - path: api/types
+        label: Types
+
+  - group: Reference
+    collapsed: true
+    items:
+      - path: reference/manifest
+        label: Manifest
+      - path: reference/namespaces
+        label: Namespaces
+      - path: reference/resolution
+        label: Resolution
+      - path: reference/security
+        label: Security
+
+  - group: Concepts
+    collapsed: true
+    items:
+      - path: concepts/how-it-works
+        label: How CNOS Works
+      - path: concepts/config-spectrum
+        label: The Config Spectrum

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@kitsy/cnos-docs",
+  "version": "1.3.0",
+  "description": "Source-of-truth CNOS documentation content for Astro Starlight and other static docs consumers.",
+  "type": "module",
+  "exports": {
+    "./manifest": "./manifest.yml",
+    "./docs/*": "./docs/*",
+    "./assets/*": "./assets/*"
+  },
+  "files": [
+    "docs",
+    "assets",
+    "manifest.yml",
+    "README.md"
+  ],
+  "keywords": [
+    "cnos",
+    "documentation",
+    "starlight",
+    "astro"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "validate": "node scripts/validate-docs.mjs",
+    "build": "node scripts/validate-docs.mjs",
+    "lint": "node scripts/validate-docs.mjs",
+    "test": "node scripts/validate-docs.mjs",
+    "typecheck": "node scripts/validate-docs.mjs"
+  }
+}