hheei-hepi-mono

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# hepi-mono

Bun monorepo for HEPI Pi Coding Agent extensions. Every publishable workspace under `packages/` is maintained under the `@hheei` scope.

## Documentation

- [Getting started](https://github.com/hheei/hepi-mono/blob/HEAD/docs/user/getting-started.md)
- [Package catalogue](https://github.com/hheei/hepi-mono/blob/HEAD/docs/user/packages.md)
- [Extension development](https://github.com/hheei/hepi-mono/blob/HEAD/docs/development/extension-development.md)
- [Documentation index](https://github.com/hheei/hepi-mono/blob/HEAD/docs/README.md)
- [TUI design](https://github.com/hheei/hepi-mono/blob/HEAD/DESIGN.md)
- [Pi source design](https://github.com/hheei/hepi-mono/blob/HEAD/.pi/skills/pi-development/references/DESIGN.md)

Package-specific commands, settings, persistence, requirements, and incompatibilities live in each `packages/*/README.md` so the documentation ships with the package.

## Install

Install all current runtime modules through the unified package:

```bash
pi install npm:@hheei/hepi-mono
```

Or install one-entry groups when you want a smaller selection:

```bash
pi install npm:@hheei/hepi-basics
pi install npm:@hheei/hepi-tools
pi install npm:@hheei/hepi-mctx
pi install npm:@hheei/hepi-skills
```

Each group is self-contained. Do not install a group together with
`hepi-mono`; they contain overlapping implementations.

The unified package includes all current runtime modules. The group packages
are the supported smaller selections.

For a local checkout:

```bash
bun install
pi install ./packages/hepi-mono
```

Use `-l` for project-local installation.

## Development

```bash
bun run typecheck
bun test
bun run check
bun run build:aggregates
```

Run a local aggregate entry directly with Pi:

```bash
bun run build:aggregates
pi --no-extensions --no-skills -e packages/hepi-mono/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-basics/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-tools/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-mctx/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-skills/dist/extension.js
```

The supported packages are the five aggregate bundles and the development-only
`@hheei/hepi-debug` package. Individual `@hheei/pi-*` packages are deprecated.

## Repository Layout

```text
packages/       HEPI-owned publishable workspaces
  hepi-subagents/  Pinned external fork submodule, excluded from workspaces

docs/
  user/         Cross-package usage
  development/  Contributor workflows
  architecture/ Current architecture notes
  research/     Evidence and prior design research
  plans/        Completed implementation context

references/
  README.md     Public source catalogue and pinned revisions
  repos/        Ignored local clones

scripts/        Repository development commands
templates/      Extension generator inputs
```

`graphify-out/`, `outputs/`, `.pi/`, and `.pi-subagents/` are local generated state and are not versioned. External source clones under `references/repos/` are references only: they are not workspace packages, dependencies, or behavior contracts.

hepi-mono

Bun monorepo for HEPI Pi Coding Agent extensions. Every publishable workspace under packages/ is maintained under the @hheei scope.

Documentation

Package-specific commands, settings, persistence, requirements, and incompatibilities live in each packages/*/README.md so the documentation ships with the package.

Install

Install all current runtime modules through the unified package:

pi install npm:@hheei/hepi-mono

Or install one-entry groups when you want a smaller selection:

pi install npm:@hheei/hepi-basics
pi install npm:@hheei/hepi-tools
pi install npm:@hheei/hepi-mctx
pi install npm:@hheei/hepi-skills

Each group is self-contained. Do not install a group together with hepi-mono; they contain overlapping implementations.

The unified package includes all current runtime modules. The group packages are the supported smaller selections.

For a local checkout:

bun install
pi install ./packages/hepi-mono

Use -l for project-local installation.

Development

bun run typecheck
bun test
bun run check
bun run build:aggregates

Run a local aggregate entry directly with Pi:

bun run build:aggregates
pi --no-extensions --no-skills -e packages/hepi-mono/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-basics/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-tools/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-mctx/dist/extension.js
pi --no-extensions --no-skills -e packages/hepi-skills/dist/extension.js

The supported packages are the five aggregate bundles and the development-only @hheei/hepi-debug package. Individual @hheei/pi-* packages are deprecated.

Repository Layout

packages/       HEPI-owned publishable workspaces
  hepi-subagents/  Pinned external fork submodule, excluded from workspaces

docs/
  user/         Cross-package usage
  development/  Contributor workflows
  architecture/ Current architecture notes
  research/     Evidence and prior design research
  plans/        Completed implementation context

references/
  README.md     Public source catalogue and pinned revisions
  repos/        Ignored local clones

scripts/        Repository development commands
templates/      Extension generator inputs

graphify-out/, outputs/, .pi/, and .pi-subagents/ are local generated state and are not versioned. External source clones under references/repos/ are references only: they are not workspace packages, dependencies, or behavior contracts.