@warpgogol/forge 5.3.2 → 5.3.3

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": "@warpgogol/forge",
3
- "version": "5.3.2",
3
+ "version": "5.3.3",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -34,7 +34,7 @@ See `_shared/fo-pipeline-conventions.md` §Language policy.
34
34
 
35
35
  A multi-persona design review for complex RFCs. The summit simulates five professional perspectives — Architect, Security Engineer, QA Engineer, Product Manager, and Developer Advocate — to surface issues that a single-perspective review misses. Each persona reviews the RFC from its professional lens and raises concerns. The operator sees all perspectives and makes the final decision.
36
36
 
37
- The summit is **optional** — invoked manually by the operator or suggested by `fo-idea-plan` for RFCs that meet complexity criteria. It is not part of the default pipeline.
37
+ The summit is **optional** — invoked manually by the operator or auto-invoked by `fo-idea-plan` (step 5b) when the planning agent judges multi-perspective review genuinely useful. It is not part of the default pipeline.
38
38
 
39
39
  The summit is `concern: document-only` — it writes a summit report to `docs/summits/` and does not modify the RFC or any source code.
40
40
 
@@ -229,7 +229,7 @@ Do not modify the RFC or any other file. Do not run `/fo-idea-enhance` or `/fo-i
229
229
 
230
230
  ## Invocation criteria
231
231
 
232
- `fo-design-summit` is invoked explicitly by the operator or suggested by `fo-idea-plan` when the RFC meets **any** of these criteria:
232
+ `fo-design-summit` is invoked explicitly by the operator or auto-invoked by `fo-idea-plan` (step 5b). The criteria below are eligibility gates, not triggers — `fo-idea-plan` runs the summit only when it also judges multi-perspective review genuinely useful, without asking the operator:
233
233
 
234
234
  - `kind: architecture` AND `scope: workspace`
235
235
  - `satisfies[]` includes 2+ DNA invariants
@@ -241,7 +241,7 @@ Do not modify the RFC or any other file. Do not run `/fo-idea-enhance` or `/fo-i
241
241
 
242
242
  - **RFC not found:** The skill errors if the target RFC does not exist.
243
243
  - **Audit not run yet:** The skill proceeds without the audit report — persona findings may overlap with future audit findings. The skill notes this in the report.
244
- - **RFC is too small for a summit:** If the RFC body is less than 500 words, the skill warns that a summit may be overkill and proceeds only if the operator confirms.
244
+ - **RFC is too small for a summit:** If the RFC body is less than 500 words, the skill warns that a summit may be overkill. When invoked explicitly by the operator, it proceeds only on operator confirmation. When auto-invoked by `fo-idea-plan`, it stops without running — the caller proceeds to its next step.
245
245
  - **Persona findings overlap:** Multiple personas may raise the same concern. The synthesis step deduplicates and marks consensus findings.
246
246
 
247
247
  ## Constraints
@@ -182,15 +182,26 @@ The grilling checks:
182
182
 
183
183
  Address every concern the grilling raises by revising the draft. Do not persist until the grilling is satisfied.
184
184
 
185
- ### 5b. Summit suggestion
185
+ ### 5b. Summit decision (autonomous)
186
186
 
187
- If the RFC meets summit criteria (any of: `kind: architecture` AND `scope: workspace`, `satisfies[]` includes 2+ DNA invariants, introduces a new package/command/lifecycle, supersedes an implemented RFC), suggest using `fo-design-summit` before acceptance. Use `ask_user_question`:
187
+ Decide yourself whether to run `fo-design-summit` before persisting the plan. **Do not ask the operator** — the planning agent holds the full context and is best placed to judge. The operator can always request a summit explicitly.
188
188
 
189
- > "This RFC is complex (architecture, workspace scope, 2+ DNA invariants). Should I run a multi-persona design summit before acceptance?"
189
+ Eligibility — the RFC meets **any** of:
190
190
 
191
- Recommended option: "Run summit" — because complex RFCs benefit from multi-perspective review.
191
+ - `kind: architecture` AND `scope: workspace`
192
+ - `satisfies[]` includes 2+ DNA invariants
193
+ - Introduces a new package, command family, or lifecycle
194
+ - Supersedes an implemented RFC
192
195
 
193
- If the operator declines, proceed to step 6. If the operator accepts, invoke `fo-design-summit` via the `skill` tool, wait for it to complete, then proceed to step 6.
196
+ Eligibility alone is not sufficient — most RFCs meet at least one criterion mechanically. Run the summit only when multi-perspective review is likely to surface findings that the audit, enhance, and grilling steps did not:
197
+
198
+ - The design holds genuinely contested trade-offs or more than one viable architecture.
199
+ - There is cross-cutting risk a single-perspective pass misses (security or privacy surface, migration of already-implemented behavior, multi-workspace blast radius).
200
+ - Step 3 or the grilling left material questions unresolved.
201
+
202
+ Skip the summit when the change is additive, follows an established pattern, or the plan converged cleanly — meeting a criterion only technically (e.g. listing 2 DNA invariants on a routine change) is a skip. When in doubt, skip: a missed summit is recoverable, operator attention is not.
203
+
204
+ If you run it, announce in one line (`Running design summit — <reason>`), invoke `fo-design-summit` via the `skill` tool, wait for it to complete, then proceed to step 6. If you skip, emit one line (`Design summit skipped — <reason>`) and proceed directly to step 6.
194
205
 
195
206
  ### 6. Persist the plan
196
207