# OpenXiangda 2.0 toolchain

This directory is the isolated OpenXiangda 2.0 package workspace. It does not
import or dispatch the 1.x CLI implementation in `lib/cli.js`.

Current packages:

- `@openxiangda/contracts`: versioned wire contracts and JSON Schemas.
- `@openxiangda/compiler`: deterministic configuration, generated contracts and AppPackage sealing.
- `@openxiangda/devkit-core`: framework-neutral workspace, package and control-plane use cases.
- `@openxiangda/nest`: trusted Principal/RoleSession Guard, Data API client,
  signed CloudEvents receiver and standard backend health endpoints.
- `@openxiangda/admin`: React + Ant Design application shell, capability-aware
  data pages and protocol-driven Workflow v2/1.x compatibility pages.
- `@openxiangda/testing`: permission fixtures, allow/deny matrix assertions and
  local event record/replay/simulation.
- `create-openxiangda`: distributable standard application workspace creator.
- `@openxiangda/cli`: thin Oclif application-level CLI.
- `@openxiangda/mcp`: structured AI resources and tools over the same services.
- `@openxiangda/skill-kit`: validation, packaging and installation for the 2.0 domain skills.

`templates/application` is the build-verified React 19 + NestJS 11 golden
workspace. None of these packages imports or dispatches the 1.x CLI, so this
toolchain can evolve without increasing the stable 1.x launcher surface.

```bash
pnpm install
pnpm check
pnpm test
pnpm template:build
pnpm skills:check
pnpm docs:build
```

The fixed Changesets group publishes the packages as one compatible version train. See `docs/getting-started.md` for application usage and `docs/migration.md` for the strict 1.x coexistence boundary.