@davidorex/pi-project-workflows 0.11.3 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@davidorex/pi-project-workflows",
3
- "version": "0.11.3",
3
+ "version": "0.13.0",
4
4
  "description": "Pi extensions for structured project state, workflow orchestration, and behavior monitoring — single install for all three",
5
5
  "license": "MIT",
6
6
  "author": "David Ryan",
@@ -29,8 +29,8 @@
29
29
  ]
30
30
  },
31
31
  "dependencies": {
32
- "@davidorex/pi-project": "^0.11.3",
33
- "@davidorex/pi-workflows": "^0.11.3",
34
- "@davidorex/pi-behavior-monitors": "^0.11.3"
32
+ "@davidorex/pi-project": "^0.13.0",
33
+ "@davidorex/pi-workflows": "^0.13.0",
34
+ "@davidorex/pi-behavior-monitors": "^0.13.0"
35
35
  }
36
36
  }
@@ -98,6 +98,7 @@ See references/bundled-resources.md for full inventory.
98
98
  | `project_vision` | `{project_vision}` / `{{ project_vision }}` | .project/project.json vision, core_value, name | — |
99
99
  | `project_conventions` | `{project_conventions}` / `{{ project_conventions }}` | .project/conformance-reference.json principle names | — |
100
100
  | `git_status` | `{git_status}` / `{{ git_status }}` | Output of git status --porcelain | 5s timeout |
101
+ | `conversation_history` | `{conversation_history}` / `{{ conversation_history }}` | Prior turn summaries (user request + actions + assistant response) | 1-3 turns adaptive, 2000 char max |
101
102
 
102
103
  Any string is accepted in `classify.context`. Unknown collector names produce empty string.
103
104
 
@@ -117,7 +118,7 @@ Built-in placeholders (always available, not in `classify.context`):
117
118
 
118
119
  **Events:** `message_end`, `turn_end`, `agent_end`, `command`, `tool_call`
119
120
 
120
- **Verdict Types:** `clean`, `flag`, `new`
121
+ **Verdict Types:** `clean`, `flag`, `new`, `error`
121
122
 
122
123
  **Scope Targets:** `main`, `subagent`, `all`, `workflow`
123
124
 
@@ -82,6 +82,141 @@ Subcommands: `init`, `list`, `run`, `resume`, `validate`, `status`, `help`
82
82
  See references/bundled-resources.md for full inventory.
83
83
  </bundled_resources>
84
84
 
85
+ <agent_vocabulary>
86
+
87
+ | Agent | Role | Tools | Input (required) | Output | Context Blocks |
88
+ |-------|------|-------|------------------|--------|----------------|
89
+ | `architecture-designer` | reasoning | read | — | json | — |
90
+ | `architecture-inferrer` | sensor | read, bash, grep, find | analysis, path | json | — |
91
+ | `audit-finding-verifier` | quality | read, bash, grep, find | — | json | — |
92
+ | `audit-fixer` | action | read, write, edit, bash, grep, find | — | json | — |
93
+ | `audit-results-router` | reasoning | read | — | json | — |
94
+ | `code-explorer` | sensor | read, bash, ls | — | json | — |
95
+ | `decomposer` | decomposer | — | — | json | — |
96
+ | `gap-identifier` | sensor | read, bash, grep, find | analysis, architecture, path | json | — |
97
+ | `gap-resolution-assessor` | quality | read, bash, grep, find | — | json | — |
98
+ | `handoff-writer` | reasoning | read | project_state, path | json | — |
99
+ | `investigator` | investigator | read, bash, grep, find | — | json | — |
100
+ | `pattern-analyzer` | sensor | read, bash, ls | exploration, path | json | — |
101
+ | `phase-author` | reasoning | read, bash, grep, find | — | json | — |
102
+ | `plan-creator` | reasoning | read, bash, grep, find | — | json | — |
103
+ | `plan-decomposer` | reasoning | read, bash, grep, find | — | json | — |
104
+ | `project-definer` | reasoning | read | — | json | — |
105
+ | `project-inferrer` | sensor | read, bash, grep, find | analysis, path | json | — |
106
+ | `quality-analyzer` | sensor | read, bash, ls | exploration, path | json | — |
107
+ | `requirements-gatherer` | reasoning | read | — | json | — |
108
+ | `researcher` | researcher | — | — | json | — |
109
+ | `spec-implementer` | action | read, write, edit, bash, grep, find | — | json | — |
110
+ | `structure-analyzer` | sensor | read, bash, ls | exploration, path | json | — |
111
+ | `synthesizer` | reasoning | read | structure, quality, patterns | json | — |
112
+ | `task-verifier` | quality | read, bash, glob, grep | task_id, acceptance_criteria, changes | json | — |
113
+ | `task-worker` | action | read, write, edit, bash, grep, glob, ls | task | json | — |
114
+ | `verifier` | quality | read, bash, grep, find | — | json | — |
115
+
116
+ **Agent Input Schemas:**
117
+
118
+ <agent_input name="architecture-inferrer">
119
+ - `analysis` [required] — Prior codebase analysis output (structure, patterns, dependencies)
120
+ - `path` string [required] — Root path of the project being analyzed
121
+ </agent_input>
122
+
123
+ <agent_input name="gap-identifier">
124
+ - `analysis` [required] — Prior codebase analysis output (structure, patterns, dependencies)
125
+ - `architecture` [required] — Architecture block (modules, patterns, boundaries)
126
+ - `path` string [required] — Root path of the project being analyzed
127
+ </agent_input>
128
+
129
+ <agent_input name="handoff-writer">
130
+ - `project_state` [required] — Current project state (from projectState() or /project status — includes phases, blocks, gaps, decisions, recent commits)
131
+ - `path` string [required] — Root path of the project
132
+ </agent_input>
133
+
134
+ <agent_input name="pattern-analyzer">
135
+ - `exploration` [required] — Prior exploration output (typed JSON)
136
+ - `path` string [required]
137
+ </agent_input>
138
+
139
+ <agent_input name="project-inferrer">
140
+ - `analysis` [required] — Prior codebase analysis output (structure, patterns, dependencies)
141
+ - `path` string [required] — Root path of the project being analyzed
142
+ </agent_input>
143
+
144
+ <agent_input name="quality-analyzer">
145
+ - `exploration` [required] — Prior exploration output (typed JSON)
146
+ - `path` string [required]
147
+ </agent_input>
148
+
149
+ <agent_input name="structure-analyzer">
150
+ - `exploration` [required] — Prior exploration output (typed JSON)
151
+ - `path` string [required]
152
+ </agent_input>
153
+
154
+ <agent_input name="synthesizer">
155
+ - `structure` [required] — Structure analysis (typed JSON)
156
+ - `quality` [required] — Quality analysis (typed JSON)
157
+ - `patterns` [required] — Pattern analysis (typed JSON)
158
+ </agent_input>
159
+
160
+ <agent_input name="task-verifier">
161
+ - `task_id` string [required] — ID of the task being verified
162
+ - `acceptance_criteria` array [required] — Acceptance criteria from the task block
163
+ - `changes` [required] — Implementation summary or diff from the worker agent
164
+ </agent_input>
165
+
166
+ <agent_input name="task-worker">
167
+ - `task` object [required] — Task block entry with description, acceptance_criteria, files
168
+ - `context` string [optional] — Narrative context from prior steps
169
+ </agent_input>
170
+
171
+ **Template References:**
172
+
173
+ - `architecture-designer`: task: `architecture-designer/task.md`
174
+ - `architecture-inferrer`: task: `architecture-inferrer/task.md`
175
+ - `audit-finding-verifier`: task: `audit-finding-verifier/task.md`
176
+ - `audit-fixer`: task: `audit-fixer/task.md`
177
+ - `audit-results-router`: task: `audit-results-router/task.md`
178
+ - `code-explorer`: system: `explorer/system.md`, task: `explorer/task.md`
179
+ - `decomposer`: task: `decomposer/task.md`
180
+ - `gap-identifier`: task: `gap-identifier/task.md`
181
+ - `gap-resolution-assessor`: task: `gap-resolution-assessor/task.md`
182
+ - `handoff-writer`: task: `handoff-writer/task.md`
183
+ - `investigator`: task: `investigator/task.md`
184
+ - `pattern-analyzer`: system: `analyzers/patterns.md`, task: `analyzers/patterns-task.md`
185
+ - `phase-author`: task: `templates/phase-author/task.md`
186
+ - `plan-creator`: task: `plan-creator/task.md`
187
+ - `plan-decomposer`: task: `plan-decomposer/task.md`
188
+ - `project-definer`: task: `project-definer/task.md`
189
+ - `project-inferrer`: task: `project-inferrer/task.md`
190
+ - `quality-analyzer`: system: `analyzers/quality.md`, task: `analyzers/quality-task.md`
191
+ - `requirements-gatherer`: task: `requirements-gatherer/task.md`
192
+ - `researcher`: task: `researcher/task.md`
193
+ - `spec-implementer`: task: `spec-implementer/task.md`
194
+ - `structure-analyzer`: system: `analyzers/structure.md`, task: `analyzers/structure-task.md`
195
+ - `synthesizer`: system: `synthesizer/system.md`, task: `synthesizer/task.md`
196
+ - `task-verifier`: task: `task-verifier/task.md`
197
+ - `task-worker`: task: `task-worker/task.md`
198
+ - `verifier`: task: `verifier/task.md`
199
+
200
+ </agent_vocabulary>
201
+
202
+ <validation_vocabulary>
203
+
204
+ | Check | Severity | Description |
205
+ |-------|----------|-------------|
206
+ | `agent-resolution` | error | Referenced agents exist in search paths |
207
+ | `monitor-resolution` | warning | Referenced monitors exist in search paths |
208
+ | `schema-existence` | error | Referenced schema files exist on disk |
209
+ | `step-references` | error | Expression step references point to declared steps |
210
+ | `step-ordering` | error | Steps do not forward-reference later steps |
211
+ | `context-references` | error | context[] entries point to declared steps |
212
+ | `filter-names` | warning | Expression filters are recognized |
213
+ | `steptype-metadata` | error | retry/input/output declarations match step type capabilities |
214
+ | `inputschema-required` | error | Agent required input keys are provided by step |
215
+ | `contextblocks-existence` | warning | Declared context blocks exist in .project/ |
216
+ | `template-alignment` | error | Template variables match step inputs and source schemas |
217
+
218
+ </validation_vocabulary>
219
+
85
220
  <objective>
86
221
  pi-workflows orchestrates multi-step agent workflows defined in YAML. Workflows are DAGs of typed steps with data flow via `${{ }}` expressions.
87
222
  </objective>
@@ -68,7 +68,6 @@
68
68
  ## templates/ (33 files)
69
69
 
70
70
  - `templates/analyzers/base-analyzer.md`
71
- - `templates/analyzers/macros.md`
72
71
  - `templates/analyzers/patterns-task.md`
73
72
  - `templates/analyzers/patterns.md`
74
73
  - `templates/analyzers/quality-task.md`
@@ -94,6 +93,7 @@
94
93
  - `templates/project-inferrer/task.md`
95
94
  - `templates/requirements-gatherer/task.md`
96
95
  - `templates/researcher/task.md`
96
+ - `templates/shared/macros.md`
97
97
  - `templates/spec-implementer/task.md`
98
98
  - `templates/synthesizer/system.md`
99
99
  - `templates/synthesizer/task.md`