@davidorex/pi-project-workflows 0.11.3 → 0.12.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.12.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.12.0",
33
+ "@davidorex/pi-workflows": "^0.12.0",
34
+ "@davidorex/pi-behavior-monitors": "^0.12.0"
35
35
  }
36
36
  }
@@ -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`