# hepi-mono

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

## Documentation

- [Getting started](docs/user/getting-started.md)
- [Package catalogue](docs/user/packages.md)
- [Extension development](docs/development/extension-development.md)
- [Documentation index](docs/README.md)
- [TUI design](DESIGN.md)
- [Pi source design](.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.