# ldesign-leap-cli

**Repository Path**: ldesign/ldesign-leap-cli

## Basic Information

- **Project Name**: ldesign-leap-cli
- **Description**: LDesign LEAP development CLI and project tooling
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-29
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @ldesign/leap-cli

`@ldesign/leap-cli` 是 LDesign 的 LEAP 开发命令与项目工具包。它拥有 LEAP 命令定义、领域实现、项目模板和领域测试；用户入口仍然是 `@ldesign/cli` 提供的 `ldesign leap:*`。

## 兼容边界

- 保留 39 个主命令、30 个 `leap:*` 别名以及原有参数和默认值。
- 第一版不提供独立 `bin`，避免与 `ldesign` 入口形成两套命令体验。
- 不依赖 `@ldesign/cli`，LDesign 专属能力通过 integration context 注入。
- 命令元数据从 `@ldesign/leap-cli/commands` 轻量加载，领域实现仅在命令执行时加载。

迁移基线和仓库边界见 [MIGRATION.md](./MIGRATION.md)。

## 公共入口

```ts
import { leapInit, leapServe } from '@ldesign/leap-cli'
import { createLeapCommandDefinitions } from '@ldesign/leap-cli/commands'
import { DEFAULT_LEAP_RESOURCE_DIR } from '@ldesign/leap-cli/constants'
import { withLeapCliIntegrations } from '@ldesign/leap-cli/integration'
```

- 根入口：LEAP 项目、构建、服务、数据库、诊断和文档 API。
- `./commands`：命令定义与注册契约，不加载领域实现。
- `./integration`：宿主注入上下文和 portable error guard。
- `./constants`：共享配置所需的轻量常量。

## 开发

```bash
pnpm install
pnpm test
pnpm typecheck
pnpm build
```

模板随 npm 包发布在 `templates/leap`。发布顺序固定为先发布 `@ldesign/leap-cli`，验证目标 registry 可安装后，再发布依赖它的 `@ldesign/cli`。

## 仓库

- Gitee: https://gitee.com/ldesign/ldesign-leap-cli
- 默认分支: `dev`