@davidorex/pi-behavior-monitors 0.1.4 → 0.3.1

package/CHANGELOG.md

@@ -1,88 +1,52 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+## [0.3.0] - 2026-03-18
 
-## v0.1.4
+## [0.2.0] - 2026-03-17
 
-[compare changes](https://github.com/davidorex/pi-behavior-monitors/compare/v0.1.3...v0.1.4)
+### Changed
+- Version aligned to 0.2.0 for monorepo lockstep versioning
+- Integrated into pi-project-workflows monorepo
 
-### 🚀 Enhancements
+### Fixed
+- `pendingAgentEndSteers` scoping bug: variable was declared inside export function but referenced in module-level `activate` — added as parameter
+- `extractText` parameter type widened for upstream `ThinkingContent` addition to message content arrays
+- `MessageEndEvent` import removed (no longer exported from pi-coding-agent main entry)
 
-- Add ui.select menus to /monitors command for TUI discoverability ([4391ca3](https://github.com/davidorex/pi-behavior-monitors/commit/4391ca3))
+## [0.1.4] - 2026-03-16
 
-### 📖 Documentation
-
-- Update SKILL.md with buffered steer delivery and TUI autocomplete ([94aee6e](https://github.com/davidorex/pi-behavior-monitors/commit/94aee6e))
-
-### ❤️ Contributors
-
-- David Ryan <davidryan@gmail.com>
-
-## v0.1.3
-
-[compare changes](https://github.com/davidorex/pi-behavior-monitors/compare/v0.1.2...v0.1.3)
-
-### 🩹 Fixes
-
-- Buffer steer delivery at agent_end to work around pi async event queue ([c899fa5](https://github.com/davidorex/pi-behavior-monitors/commit/c899fa5))
-
-### 📖 Documentation
-
-- Add npm publish commands to CLAUDE.md ([91dbe87](https://github.com/davidorex/pi-behavior-monitors/commit/91dbe87))
-
-### 🏡 Chore
-
-- Scope package name to @davidorex/pi-behavior-monitors ([e9a9882](https://github.com/davidorex/pi-behavior-monitors/commit/e9a9882))
-
-### ❤️ Contributors
-
-- David Ryan <davidryan@gmail.com>
-
-## v0.1.2
-
-[compare changes](https://github.com/davidorex/pi-behavior-monitors/compare/v0.1.1...v0.1.2)
-
-### 🚀 Enhancements
-
-- Unify monitor management under /monitors command with subcommand routing ([dbffaa0](https://github.com/davidorex/pi-behavior-monitors/commit/dbffaa0))
-- Add vitest test suite for pure functions in index.ts ([fed0d75](https://github.com/davidorex/pi-behavior-monitors/commit/fed0d75))
-
-### 🩹 Fixes
-
-- Address conformance audit findings — unused param, session_switch, headless escalate ([f2d3baa](https://github.com/davidorex/pi-behavior-monitors/commit/f2d3baa))
-
-### 🏡 Chore
-
-- Add .claude/ to gitignore, version conformance audit in docs/ ([d6a8395](https://github.com/davidorex/pi-behavior-monitors/commit/d6a8395))
-
-### ❤️ Contributors
-
-- David Ryan <davidryan@gmail.com>
+### Added
+- UI select menus for `/monitors` command for TUI discoverability
 
-## v0.1.1
+### Changed
+- Updated SKILL.md with buffered steer delivery and TUI autocomplete
 
-[compare changes](https://github.com/davidorex/pi-behavior-monitors/compare/v0.1.0...v0.1.1)
+## [0.1.3] - 2026-03-15
 
-### 📖 Documentation
+### Fixed
+- Buffer steer delivery at agent_end to work around pi async event queue
 
-- Add CLAUDE.md with project conventions ([5f5b427](https://github.com/davidorex/pi-behavior-monitors/commit/5f5b427))
-- Expand SKILL.md to cover full runtime behavior and bundled monitors ([5c9980d](https://github.com/davidorex/pi-behavior-monitors/commit/5c9980d))
+### Changed
+- Scoped package name to `@davidorex/pi-behavior-monitors`
 
-### 🏡 Chore
+## [0.1.2] - 2026-03-14
 
-- Add npm publish metadata, files whitelist, and normalize repository URL ([4b3f1f4](https://github.com/davidorex/pi-behavior-monitors/commit/4b3f1f4))
-- Add .gitignore, remove runtime .workflow/ from tracking ([c1d4ae5](https://github.com/davidorex/pi-behavior-monitors/commit/c1d4ae5))
+### Added
+- Unified monitor management under `/monitors` command with subcommand routing
+- Vitest test suite for pure functions in index.ts
 
-### ❤️ Contributors
+### Fixed
+- Conformance audit findings: unused param, session_switch, headless escalate
 
-- David Ryan <davidryan@gmail.com>
+## [0.1.1] - 2026-03-13
 
-## v0.1.0
+### Changed
+- Expanded SKILL.md to cover full runtime behavior and bundled monitors
+- Added npm publish metadata, files whitelist, normalized repository URL
 
-Initial release.
+## [0.1.0] - 2026-03-12
 
 ### Added
-
 - Monitor extension with event-driven classification (message_end, turn_end, agent_end, command)
 - JSON-based monitor definitions (.monitor.json), pattern libraries (.patterns.json), instructions (.instructions.json)
 - Side-channel LLM classification with CLEAN/FLAG/NEW verdict protocol

package/README.md

@@ -7,9 +7,11 @@ Monitors are JSON files (`.monitor.json`) with typed blocks: classify (LLM side-
 ## Install
 
 ```bash
-pi install npm:pi-behavior-monitors
+pi install npm:@davidorex/pi-behavior-monitors
 ```
 
+Or install all three extensions at once: `pi install npm:@davidorex/pi-project-workflows`
+
 On first run, if no monitors exist in your project, example monitors are seeded into `.pi/monitors/`. Edit or delete them to customize.
 
 ## Bundled Example Monitors
@@ -57,3 +59,9 @@ Create a `.monitor.json` file in `.pi/monitors/` conforming to `schemas/monitor.
 
 - `schemas/monitor.schema.json` — monitor definition format
 - `schemas/monitor-pattern.schema.json` — pattern library entry format
+
+## Development
+
+Part of the [`pi-project-workflows`](../../README.md) monorepo. All three packages (pi-project, pi-workflows, pi-behavior-monitors) are versioned in lockstep at 0.2.0.
+
+`npm run build` compiles TypeScript to `dist/` via `tsc`. The package ships `dist/`, not `src/`. Tests use `vitest run` (`npm test`).

package/dist/index.d.ts

@@ -0,0 +1,166 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export interface CollectorDescriptor {
+    name: string;
+    description: string;
+    limits?: string;
+}
+export declare const COLLECTOR_DESCRIPTORS: CollectorDescriptor[];
+export interface WhenConditionDescriptor {
+    name: string;
+    description: string;
+    parameterized: boolean;
+}
+export declare const WHEN_CONDITIONS: WhenConditionDescriptor[];
+export declare const VERDICT_TYPES: readonly ["clean", "flag", "new"];
+export declare const SCOPE_TARGETS: readonly ["main", "subagent", "all", "workflow"];
+export interface MonitorScope {
+    target: "main" | "subagent" | "all" | "workflow";
+    filter?: {
+        agent_type?: string[];
+        step_name?: string;
+        workflow?: string;
+    };
+}
+export interface MonitorAction {
+    steer?: string | null;
+    learn_pattern?: boolean;
+    write?: {
+        path: string;
+        schema?: string;
+        merge: "append" | "upsert";
+        array_field: string;
+        template: Record<string, string>;
+    };
+}
+export interface MonitorSpec {
+    name: string;
+    description: string;
+    event: MonitorEvent;
+    when: string;
+    scope: MonitorScope;
+    classify: {
+        model: string;
+        context: string[];
+        excludes: string[];
+        prompt: string;
+        promptTemplate?: string;
+    };
+    patterns: {
+        path: string;
+        learn: boolean;
+    };
+    instructions: {
+        path: string;
+    };
+    actions: {
+        on_flag?: MonitorAction | null;
+        on_new?: MonitorAction | null;
+        on_clean?: MonitorAction | null;
+    };
+    ceiling: number;
+    escalate: "ask" | "dismiss";
+}
+export interface MonitorPattern {
+    id: string;
+    description: string;
+    severity?: string;
+    category?: string;
+    examples?: string[];
+    learned_at?: string;
+    source?: string;
+}
+export interface MonitorInstruction {
+    text: string;
+    added_at?: string;
+}
+export interface Monitor extends MonitorSpec {
+    dir: string;
+    resolvedPatternsPath: string;
+    resolvedInstructionsPath: string;
+    activationCount: number;
+    whileCount: number;
+    lastUserText: string;
+    dismissed: boolean;
+}
+export interface ClassifyResult {
+    verdict: "clean" | "flag" | "new";
+    description?: string;
+    newPattern?: string;
+}
+export interface MonitorMessageDetails {
+    monitorName: string;
+    verdict: "flag" | "new";
+    description: string;
+    steer: string;
+    whileCount: number;
+    ceiling: number;
+}
+type MonitorEvent = "message_end" | "turn_end" | "agent_end" | "command";
+export declare const VALID_EVENTS: Set<string>;
+/** Collector names derived from the runtime registry — used for consistency testing. */
+export declare const COLLECTOR_NAMES: string[];
+export type MonitorsCommand = {
+    type: "list";
+} | {
+    type: "on";
+} | {
+    type: "off";
+} | {
+    type: "inspect";
+    name: string;
+} | {
+    type: "rules-list";
+    name: string;
+} | {
+    type: "rules-add";
+    name: string;
+    text: string;
+} | {
+    type: "rules-remove";
+    name: string;
+    index: number;
+} | {
+    type: "rules-replace";
+    name: string;
+    index: number;
+    text: string;
+} | {
+    type: "patterns-list";
+    name: string;
+} | {
+    type: "dismiss";
+    name: string;
+} | {
+    type: "reset";
+    name: string;
+} | {
+    type: "help";
+} | {
+    type: "error";
+    message: string;
+};
+export declare function parseMonitorsArgs(args: string, knownNames: Set<string>): MonitorsCommand;
+export declare function parseVerdict(raw: string): ClassifyResult;
+export declare function parseModelSpec(spec: string): {
+    provider: string;
+    modelId: string;
+};
+export declare function generateFindingId(monitorName: string, _description: string): string;
+/**
+ * Programmatic monitor invocation — runs classification and write actions for
+ * a named monitor, returning the verdict. Unlike activate(), this skips dedup,
+ * ceiling, steering, and buffering. Designed for synchronous pre-dispatch
+ * gating where callers need the ClassifyResult before proceeding.
+ *
+ * The monitor must be loaded (discovered at extension init). If the monitor
+ * has no patterns, returns CLEAN (nothing to classify against).
+ *
+ * @param name - Monitor name (matches .monitor.json `name` field)
+ * @param context - Optional key-value pairs injected as additional template
+ *   variables alongside the standard collectors. Keys that collide with
+ *   collector names override the collector output for this invocation.
+ */
+export declare function invokeMonitor(name: string, context?: Record<string, string>): Promise<ClassifyResult>;
+export default function (pi: ExtensionAPI): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}