# Neith Release Management

Reference hub for `@neith/release`, the Phase 52 package that models release
pipelines, artifact distribution, platform publishing, accessibility audits, and
performance gates for the Neith sovereign stack.

## Documentation Map

- [Developer Guide](./developer-guide.md)
- [User Guide](./user-guide.md)
- [API Reference](./api/README.md)
- [Operations Runbook](./runbook.md)
- [Training Materials](./training/README.md)
- [Community Resources](./community/README.md)
- [Support Infrastructure](./support/README.md)
- [Documentation Coverage Audit](./documentation-coverage.md)

## Package Responsibilities

`@neith/release` is organized into four operational areas:

| Area         | Responsibility                                                                                   | Representative modules |
| ------------ | ------------------------------------------------------------------------------------------------ | ---------------------- |
| Pipeline     | Branching, versioning, RCs, rollout control, rollback, LTS, upgrade paths                        | `src/pipeline/*`       |
| Distribution | Artifact storage, CDN, mirrors, signatures, installers, updates, licensing                       | `src/distribution/*`   |
| Platform     | Platform-specific publishing and packaging for desktop, mobile, web, cloud, and catalog channels | `src/platform/*`       |
| Performance  | Benchmark scenarios and budgets for critical release control-plane paths                         | `src/performance/*`    |

## Typical Workflows

### Release Engineering

Use the pipeline primitives to create a version plan, build a release workflow,
stage a rollout, and define rollback or security-release procedures.

### Distribution Operations

Use the distribution primitives to register artifacts, publish checksums and
signatures, generate installers and repository metadata, and govern update or
licensing behavior.

### Platform Publishing

Use the platform publishers to materialize packaging and submission metadata for
Linux, Windows, macOS, mobile stores, game stores, Docker, cloud marketplaces,
web distribution, and enterprise catalogs.

### Quality Gating

Use the benchmark suite and web accessibility auditor to keep release surfaces
within performance budgets, under the certified 5% regression envelope, and at
WCAG 2.1 AA minimum requirements.

## Verification Commands

```bash
pnpm nx run @neith/release:typecheck
pnpm nx run @neith/release:lint
pnpm nx run @neith/release:test
pnpm nx run @neith/release:benchmark
```

## Source Entry Points

- Package root: `libs/neith/release/src/index.ts`
- Pipeline barrel: `libs/neith/release/src/pipeline/index.ts`
- Distribution barrel: `libs/neith/release/src/distribution/index.ts`
- Platform barrel: `libs/neith/release/src/platform/index.ts`
- Performance barrel: `libs/neith/release/src/performance/index.ts`
