@davidorex/pi-project-workflows 0.14.4 → 0.26.0

package/README.md

@@ -1,6 +1,6 @@
 # @davidorex/pi-project-workflows
 
-Convenience meta-package that re-exports all three [Pi](https://github.com/badlogic/pi-mono) extensions — structured project state, workflow orchestration, and behavior monitoring — in a single install.
+Convenience meta-package that re-exports three [Pi](https://github.com/badlogic/pi-mono) extensions plus a shared agent-runtime library — structured project state, workflow orchestration, behavior monitoring, and agent spec compilation — in a single install.
 
 ## Install
 
@@ -8,17 +8,18 @@ Convenience meta-package that re-exports all three [Pi](https://github.com/badlo
 pi install npm:@davidorex/pi-project-workflows
 ```
 
-This installs all three extensions:
-- **[@davidorex/pi-project](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-project)** — schema-driven project state (typed blocks, validation, derived state)
+This installs the four constituent packages:
+- **[@davidorex/pi-context](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-context)** — schema-driven project state (typed blocks, validation, derived state)
+- **[@davidorex/pi-jit-agents](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-jit-agents)** — agent spec compilation and in-process dispatch runtime (library, not a Pi extension)
 - **[@davidorex/pi-workflows](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-workflows)** — workflow orchestration (YAML specs, DAG execution, checkpoint/resume)
 - **[@davidorex/pi-behavior-monitors](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-behavior-monitors)** — behavior monitors (autonomous watchdogs, pattern classification, steering corrections)
 
 ## Getting Started
 
 ```
-/project init     # scaffolds .project/ with schemas and starter blocks
+/context init     # scaffolds .project/ with schemas and starter blocks
 /workflow init    # scaffolds .workflows/ for run state
-/project status   # see derived project state
+/context status   # see derived project state
 /workflow list    # discover and run workflows
 /monitors         # list all monitors, scope, and state
 ```
@@ -26,6 +27,7 @@ This installs all three extensions:
 ## Documentation
 
 See the package READMEs for full API docs, source maps, and LLM guidance:
-- [pi-project README](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-project)
+- [pi-context README](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-context)
+- [pi-jit-agents README](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-jit-agents)
 - [pi-workflows README](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-workflows)
 - [pi-behavior-monitors README](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-behavior-monitors)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@davidorex/pi-project-workflows",
-	"version": "0.14.4",
+	"version": "0.26.0",
 	"description": "Pi extensions for structured project state, workflow orchestration, and behavior monitoring — single install for all three",
 	"license": "MIT",
 	"author": "David Ryan",
@@ -29,8 +29,8 @@
 		]
 	},
 	"dependencies": {
-		"@davidorex/pi-project": "^0.14.4",
-		"@davidorex/pi-workflows": "^0.14.4",
-		"@davidorex/pi-behavior-monitors": "^0.14.4"
+		"@davidorex/pi-context": "^0.26.0",
+		"@davidorex/pi-workflows": "^0.26.0",
+		"@davidorex/pi-behavior-monitors": "^0.26.0"
 	}
 }

package/project-extension.ts

@@ -1 +1 @@
-export { default } from "@davidorex/pi-project";
+export { default } from "@davidorex/pi-context";

package/skills/pi-behavior-monitors/SKILL.md

@@ -76,11 +76,11 @@ Subcommands: `on`, `off`, `help`, `commit-hygiene`, `fragility`, `hedge`, `unaut
 </commands_reference>
 
 <events>
-`session_start`, `agent_end`, `turn_start`, `message_end`, `turn_end`, `tool_call`
+`session_start`, `agent_end`, `turn_start`, `tool_call`
 </events>
 
 <bundled_resources>
-5 agents, 3 schemas, 21 examples bundled.
+5 agents, 5 schemas, 21 examples bundled.
 See references/bundled-resources.md for full inventory.
 </bundled_resources>
 
@@ -131,32 +131,31 @@ write structured findings to JSON files for downstream consumption.
 </objective>
 
 <monitor_locations>
-Monitors are discovered from two locations, checked in order:
+Monitors are discovered from three tiers, checked in precedence order; the first match
+by `monitor.name` wins:
 
-1. **Project**: `.pi/monitors/*.monitor.json` (walks up from cwd to find `.pi/`)
+1. **Project**: `.pi/monitors/*.monitor.json` (walks up from cwd to find `.pi/`, stops at the `.git` boundary)
 2. **Global**: `~/.pi/agent/monitors/*.monitor.json` (via `getAgentDir()`)
+3. **Bundled**: `<package>/examples/*.monitor.json` (the five built-in defaults that ship with the extension)
 
-Project monitors take precedence — if a project monitor has the same `name` as a global
-one, the global monitor is ignored. The extension silently exits if zero monitors are
-discovered after checking both locations.
+When a higher-precedence tier shadows a same-name monitor in a lower tier, the override
+is logged once at session_start so drift is visible. The extension silently exits if
+zero monitors are discovered across all three tiers.
 </monitor_locations>
 
-<seeding>
-On first run in a project, the extension seeds bundled example monitors into
-`.pi/monitors/` if ALL of the following are true:
+<overrides>
+To customize a bundled monitor, create `.pi/monitors/<name>.monitor.json` (and its
+`.patterns.json` and `.instructions.json` sidecars) in your project. The override fully
+replaces the bundled version by name. Per-monitor template subdirectories (e.g.,
+`fragility/classify.md`) follow the same multi-tier search via
+`createMonitorAgentTemplateEnv`, so an override directory tree mirrors the bundled
+layout.
 
-- `discoverMonitors()` finds zero monitors (neither project nor global)
-- The `examples/` directory exists in the extension package
-- The target `.pi/monitors/` directory contains no `.monitor.json` files
-
-Seeding copies all `.json` files from `examples/` (monitor definitions, patterns, and
-instructions files) into `.pi/monitors/`. It skips files that already exist at the
-destination. The user is notified: "Edit or delete them to customize."
-
-To customize seeded monitors, edit the copies in `.pi/monitors/` directly. To remove a
-bundled monitor, delete its three files (`.monitor.json`, `.patterns.json`,
-`.instructions.json`). Seeding never re-runs once any monitors exist.
-</seeding>
+Delete the override to revert to bundled behavior — bundled updates are picked up
+automatically on the next session because tier 3 reads the package examples directly,
+not a copied snapshot. This replaces the prior copy-on-first-run pattern that left
+seeded `.pi/monitors/` files frozen at the package version they were seeded from.
+</overrides>
 
 <file_structure>
 Each monitor is a set of files sharing a name prefix:
@@ -468,7 +467,8 @@ for other extensions or workflows to invoke classification directly.
 </commands>
 
 <bundled_monitors>
-Five example monitors ship in `examples/` and are seeded on first run. Each has a
+Five example monitors ship in `examples/` and load directly from the package as the
+third discovery tier. Each has a
 Nunjucks classify template in `examples/<name>/classify.md` with iteration-aware
 acknowledgment support:
 

package/skills/pi-behavior-monitors/references/bundled-resources.md

@@ -8,8 +8,10 @@
 - `agents/unauthorized-action-classifier.agent.yaml`
 - `agents/work-quality-classifier.agent.yaml`
 
-## schemas/ (3 files)
+## schemas/ (5 files)
 
+- `schemas/monitor-instruction-list.schema.json`
+- `schemas/monitor-pattern-list.schema.json`
 - `schemas/monitor-pattern.schema.json`
 - `schemas/monitor.schema.json`
 - `schemas/verdict.schema.json`