# AGENTS.md

## Scope

Applies to entire `pi-context-manager` package.

## What this package does

- Pi extension package for context-pressure management, resume packets, summaries, persistence, and pruning helpers.
- Entry point: `index.ts`.
- Core package logic and tests live in `src/`.

## Working rules

- Treat this directory as an independent package root.
- Keep changes package-local and minimal.
- Pi core packages belong in `peerDependencies` with `"*"` and must not be bundled.
- Prefer focused tests next to changed modules in `src/`.
- Do not edit `node_modules/` or nested `.git/` contents.
- For transitive advisory refreshes, prefer `npm audit fix --package-lock-only` when it avoids unrelated manifest changes.

## Commands

- Install deps: `npm install`
- Run tests: `npm test`
- Audit deps: `npm audit`