powercontext-ts

TypeScript implementation of PowerContext. This repository is a sibling of the Python reference, not a subdirectory of it.

Python remains the reference implementation and semantic oracle. TypeScript aligns through the pinned OpenAPI snapshot and the repository-root conformance kit.

Status

The client profile has Protocol types, 52 operation contracts, runtime validators, C1 wire fixtures, and the official typed HTTP Client. @powercontext/core owns the deterministic JCS / NFC / hash / ref / UTF-8 primitives and immutable in-memory fake-store histories. Its Python-oracle canonical suite is sqlite-fts / C2 evidence for that deterministic scope; it is not a claim that persistence or the complete profile ships. Persistence, Server, MCP, and CLI are not shipped.

See Current status and the compatibility policy.

Workspace commands

pnpm install
pnpm format
pnpm lint
pnpm typecheck
pnpm build
pnpm test
pnpm generate
pnpm generate:check
pnpm pack:smoke
pnpm license:check
python tools/contract-sync/verify.py
python tools/contract-sync/sync.py
python conformance/runners/python/run.py --export
python conformance/runners/python/run.py --export-check
pnpm conformance

@powercontext/protocol and @powercontext/client install without native addons.

Repository layout

packages/       publishable and private workspace packages
contract/       pinned OpenAPI snapshot and baseline lock
conformance/    language-independent fixtures; not an npm package
tools/          protocol generator, contract-sync, license and pack smoke
docs/           policies, ADRs, and contributor notes

Documents

• Documentation index
• Roadmap
• Contributing
• Changelog
• Security
• ADRs
• Compatibility policy
• Baseline lock