Pi change-impact demo package

This tutorial-specific Pi Package exposes two installed resources:

• The final Stage 4 extension, which registers /impact, analyze_change_impact, the selective impact Hook, and /impact-ui.
• The change-impact-analysis Skill, which supplies reporting rules when explicitly invoked or when the model chooses to load it.

Prerequisites

Use Node.js 22.19.0 or newer, Pi 0.84.3, and TypeBox 1.3.19. The package manifest pins Pi and TypeBox as exact peer dependencies for tutorial reproducibility. Install the required Pi version with:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.84.3

Model-driven use requires a configured provider; run /login in Pi if needed. The deterministic /impact Command itself does not require model authentication.

The extension expects the Pi working directory to contain demo-project/. It is a tutorial package, not a general-purpose repository analyzer. The Tool and Commands accept paths relative to that directory, such as src/auth/session.ts.

Install

Review the package's extension code, Skill, and dependencies before installation. Pin the npm version:

pi install npm:pi-change-impact-demo-package@0.1.0

Then start Pi from a project containing demo-project/:

cd /path/to/consumer-project
pi

Use

At the Pi input, invoke the deterministic Command:

/impact src/auth/session.ts

Open the file selector and session widget:

/impact-ui

Force Pi to load the Skill body and run its workflow:

/skill:change-impact-analysis 如果我修改 demo-project/src/auth/session.ts，影响哪些模块？建议运行哪些测试？

Pi initially exposes only the Skill's name and description to the model. The model may load its body automatically when a request matches, but that is nondeterministic; /skill:change-impact-analysis forces it for this request. The Hook is separate extension behavior: it injects hidden Tool-first guidance when the prompt matches its impact-language rules.

Limits and security

Analysis covers supported static relative TypeScript imports and exports under <Pi cwd>/demo-project. It does not follow dynamic imports, require, path aliases, package imports, dependency injection, configuration wiring, or dependencies outside that directory. Risk is a count-based heuristic.

Pi extensions run with your user account's permissions, and Skills can influence model tool use. Review source and dependencies before installing, and use containment for untrusted code.