@davidorex/pi-workflows 0.2.0 → 0.3.0

package/schemas/decomposition-specs.schema.json

@@ -1,50 +1,50 @@
 {
-  "type": "object",
-  "required": ["specs", "ordering_rationale"],
-  "properties": {
-    "specs": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "description", "files", "acceptance_criteria", "parallel_safe", "estimated_complexity"],
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "Kebab-case identifier for this spec"
-          },
-          "description": {
-            "type": "string",
-            "description": "What this spec implements — the unit of work"
-          },
-          "files": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "File paths this spec will modify"
-          },
-          "depends_on": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Names of other specs that must complete before this one"
-          },
-          "acceptance_criteria": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "How to verify this spec is correctly implemented"
-          },
-          "parallel_safe": {
-            "type": "boolean",
-            "description": "Whether this spec can run in parallel with other parallel_safe specs that have no file overlap"
-          },
-          "estimated_complexity": {
-            "type": "string",
-            "enum": ["low", "medium", "high"]
-          }
-        }
-      }
-    },
-    "ordering_rationale": {
-      "type": "string",
-      "description": "Why this ordering and parallelization structure was chosen"
-    }
-  }
+	"type": "object",
+	"required": ["specs", "ordering_rationale"],
+	"properties": {
+		"specs": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["name", "description", "files", "acceptance_criteria", "parallel_safe", "estimated_complexity"],
+				"properties": {
+					"name": {
+						"type": "string",
+						"description": "Kebab-case identifier for this spec"
+					},
+					"description": {
+						"type": "string",
+						"description": "What this spec implements — the unit of work"
+					},
+					"files": {
+						"type": "array",
+						"items": { "type": "string" },
+						"description": "File paths this spec will modify"
+					},
+					"depends_on": {
+						"type": "array",
+						"items": { "type": "string" },
+						"description": "Names of other specs that must complete before this one"
+					},
+					"acceptance_criteria": {
+						"type": "array",
+						"items": { "type": "string" },
+						"description": "How to verify this spec is correctly implemented"
+					},
+					"parallel_safe": {
+						"type": "boolean",
+						"description": "Whether this spec can run in parallel with other parallel_safe specs that have no file overlap"
+					},
+					"estimated_complexity": {
+						"type": "string",
+						"enum": ["low", "medium", "high"]
+					}
+				}
+			}
+		},
+		"ordering_rationale": {
+			"type": "string",
+			"description": "Why this ordering and parallelization structure was chosen"
+		}
+	}
 }

package/schemas/execution-results.schema.json

@@ -1,50 +1,50 @@
 {
-  "type": "object",
-  "required": ["status", "tasks"],
-  "properties": {
-    "status": {
-      "type": "string",
-      "enum": ["complete", "partial", "failed"]
-    },
-    "tasks": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "status"],
-        "properties": {
-          "name": { "type": "string" },
-          "status": { "type": "string", "enum": ["done", "partial", "skipped", "failed"] },
-          "files_modified": { "type": "array", "items": { "type": "string" } },
-          "commit_hash": { "type": "string" },
-          "notes": { "type": "string" }
-        }
-      }
-    },
-    "decisions": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "decision", "rationale", "status"],
-        "properties": {
-          "id": { "type": "string" },
-          "decision": { "type": "string" },
-          "rationale": { "type": "string" },
-          "status": { "type": "string", "enum": ["decided", "deferred", "reversed"] }
-        }
-      }
-    },
-    "issues": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["severity", "description"],
-        "properties": {
-          "severity": { "type": "string", "enum": ["info", "warning", "error", "critical"] },
-          "description": { "type": "string" }
-        }
-      }
-    },
-    "test_count": { "type": "integer" },
-    "commit_hash": { "type": "string" }
-  }
+	"type": "object",
+	"required": ["status", "tasks"],
+	"properties": {
+		"status": {
+			"type": "string",
+			"enum": ["complete", "partial", "failed"]
+		},
+		"tasks": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["name", "status"],
+				"properties": {
+					"name": { "type": "string" },
+					"status": { "type": "string", "enum": ["done", "partial", "skipped", "failed"] },
+					"files_modified": { "type": "array", "items": { "type": "string" } },
+					"commit_hash": { "type": "string" },
+					"notes": { "type": "string" }
+				}
+			}
+		},
+		"decisions": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["id", "decision", "rationale", "status"],
+				"properties": {
+					"id": { "type": "string" },
+					"decision": { "type": "string" },
+					"rationale": { "type": "string" },
+					"status": { "type": "string", "enum": ["decided", "deferred", "reversed"] }
+				}
+			}
+		},
+		"issues": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["severity", "description"],
+				"properties": {
+					"severity": { "type": "string", "enum": ["info", "warning", "error", "critical"] },
+					"description": { "type": "string" }
+				}
+			}
+		},
+		"test_count": { "type": "integer" },
+		"commit_hash": { "type": "string" }
+	}
 }

package/schemas/investigation-findings.schema.json

@@ -1,45 +1,45 @@
 {
-  "type": "object",
-  "required": ["affected_files", "constraints", "risks", "needs_research", "complexity", "summary"],
-  "properties": {
-    "affected_files": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["path", "role", "current_behavior"],
-        "properties": {
-          "path": { "type": "string" },
-          "role": { "type": "string", "description": "What this file does in the context of the gap" },
-          "current_behavior": { "type": "string", "description": "What it currently does that's relevant to the gap" }
-        }
-      }
-    },
-    "constraints": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Technical constraints, invariants, or requirements that the solution must respect"
-    },
-    "risks": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "What could go wrong, edge cases, regression risks"
-    },
-    "needs_research": {
-      "type": "boolean",
-      "description": "Whether the gap requires external knowledge beyond what codebase analysis and LLM training data provide"
-    },
-    "research_questions": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Specific questions for the research step to answer. Only meaningful if needs_research is true."
-    },
-    "complexity": {
-      "type": "string",
-      "enum": ["low", "medium", "high"]
-    },
-    "summary": {
-      "type": "string",
-      "description": "Concise summary of the investigation — what's the problem, what's involved, what's the path forward"
-    }
-  }
+	"type": "object",
+	"required": ["affected_files", "constraints", "risks", "needs_research", "complexity", "summary"],
+	"properties": {
+		"affected_files": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["path", "role", "current_behavior"],
+				"properties": {
+					"path": { "type": "string" },
+					"role": { "type": "string", "description": "What this file does in the context of the gap" },
+					"current_behavior": { "type": "string", "description": "What it currently does that's relevant to the gap" }
+				}
+			}
+		},
+		"constraints": {
+			"type": "array",
+			"items": { "type": "string" },
+			"description": "Technical constraints, invariants, or requirements that the solution must respect"
+		},
+		"risks": {
+			"type": "array",
+			"items": { "type": "string" },
+			"description": "What could go wrong, edge cases, regression risks"
+		},
+		"needs_research": {
+			"type": "boolean",
+			"description": "Whether the gap requires external knowledge beyond what codebase analysis and LLM training data provide"
+		},
+		"research_questions": {
+			"type": "array",
+			"items": { "type": "string" },
+			"description": "Specific questions for the research step to answer. Only meaningful if needs_research is true."
+		},
+		"complexity": {
+			"type": "string",
+			"enum": ["low", "medium", "high"]
+		},
+		"summary": {
+			"type": "string",
+			"description": "Concise summary of the investigation — what's the problem, what's involved, what's the path forward"
+		}
+	}
 }

package/schemas/pattern-analysis.schema.json

@@ -1,43 +1,43 @@
 {
-  "type": "object",
-  "required": ["patterns", "conventions", "recommendations"],
-  "properties": {
-    "patterns": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "usage", "files"],
-        "properties": {
-          "name": { "type": "string" },
-          "usage": { "type": "string" },
-          "files": { "type": "array", "items": { "type": "string" } },
-          "correct": { "type": "boolean" }
-        }
-      }
-    },
-    "conventions": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["convention", "followed"],
-        "properties": {
-          "convention": { "type": "string" },
-          "followed": { "type": "boolean" },
-          "violations": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "recommendations": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["pattern", "suggestion"],
-        "properties": {
-          "pattern": { "type": "string" },
-          "suggestion": { "type": "string" },
-          "priority": { "type": "string", "enum": ["high", "medium", "low"] }
-        }
-      }
-    }
-  }
+	"type": "object",
+	"required": ["patterns", "conventions", "recommendations"],
+	"properties": {
+		"patterns": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["name", "usage", "files"],
+				"properties": {
+					"name": { "type": "string" },
+					"usage": { "type": "string" },
+					"files": { "type": "array", "items": { "type": "string" } },
+					"correct": { "type": "boolean" }
+				}
+			}
+		},
+		"conventions": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["convention", "followed"],
+				"properties": {
+					"convention": { "type": "string" },
+					"followed": { "type": "boolean" },
+					"violations": { "type": "array", "items": { "type": "string" } }
+				}
+			}
+		},
+		"recommendations": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["pattern", "suggestion"],
+				"properties": {
+					"pattern": { "type": "string" },
+					"suggestion": { "type": "string" },
+					"priority": { "type": "string", "enum": ["high", "medium", "low"] }
+				}
+			}
+		}
+	}
 }

package/schemas/phase.schema.json

@@ -0,0 +1,48 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "Phase",
+	"type": "object",
+	"required": ["number", "name", "intent", "status"],
+	"properties": {
+		"number": { "type": "integer" },
+		"name": { "type": "string" },
+		"intent": { "type": "string" },
+		"status": { "type": "string", "enum": ["planned", "in-progress", "completed"] },
+		"success_criteria": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["criterion", "verify_method"],
+				"properties": {
+					"criterion": { "type": "string" },
+					"verify_method": { "type": "string", "enum": ["command", "inspect", "human"] }
+				}
+			}
+		},
+		"specs": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["number", "name", "intent", "status"],
+				"properties": {
+					"number": { "type": "integer" },
+					"name": { "type": "string" },
+					"intent": { "type": "string" },
+					"status": { "type": "string", "enum": ["planned", "in-progress", "completed"] },
+					"acceptance_criteria": {
+						"type": "array",
+						"items": { "type": "string" }
+					}
+				}
+			}
+		},
+		"dependencies": {
+			"type": "array",
+			"items": { "type": "integer" }
+		},
+		"artifacts_produced": {
+			"type": "array",
+			"items": { "type": "string" }
+		}
+	}
+}

package/schemas/plan-breakdown.schema.json

@@ -1,22 +1,22 @@
 {
-  "type": "object",
-  "required": ["plans"],
-  "properties": {
-    "plans": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "intent", "tasks", "acceptance_criteria"],
-        "properties": {
-          "name": { "type": "string" },
-          "intent": { "type": "string" },
-          "tasks": { "type": "array", "items": { "type": "string" } },
-          "files_to_change": { "type": "array", "items": { "type": "string" } },
-          "acceptance_criteria": { "type": "array", "items": { "type": "string" } },
-          "context_needed": { "type": "array", "items": { "type": "string" } },
-          "parallel_group": { "type": "string" }
-        }
-      }
-    }
-  }
+	"type": "object",
+	"required": ["plans"],
+	"properties": {
+		"plans": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["name", "intent", "tasks", "acceptance_criteria"],
+				"properties": {
+					"name": { "type": "string" },
+					"intent": { "type": "string" },
+					"tasks": { "type": "array", "items": { "type": "string" } },
+					"files_to_change": { "type": "array", "items": { "type": "string" } },
+					"acceptance_criteria": { "type": "array", "items": { "type": "string" } },
+					"context_needed": { "type": "array", "items": { "type": "string" } },
+					"parallel_group": { "type": "string" }
+				}
+			}
+		}
+	}
 }

package/schemas/quality-analysis.schema.json

@@ -1,35 +1,35 @@
 {
-  "type": "object",
-  "required": ["concerns", "testCoverage", "maintainability"],
-  "properties": {
-    "concerns": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["description", "severity"],
-        "properties": {
-          "description": { "type": "string" },
-          "severity": { "type": "string", "enum": ["info", "warning", "critical"] },
-          "file": { "type": "string" },
-          "suggestion": { "type": "string" }
-        }
-      }
-    },
-    "testCoverage": {
-      "type": "object",
-      "required": ["tested", "untested"],
-      "properties": {
-        "tested": { "type": "array", "items": { "type": "string" } },
-        "untested": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "maintainability": {
-      "type": "object",
-      "required": ["score", "factors"],
-      "properties": {
-        "score": { "type": "string", "enum": ["high", "medium", "low"] },
-        "factors": { "type": "array", "items": { "type": "string" } }
-      }
-    }
-  }
+	"type": "object",
+	"required": ["concerns", "testCoverage", "maintainability"],
+	"properties": {
+		"concerns": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["description", "severity"],
+				"properties": {
+					"description": { "type": "string" },
+					"severity": { "type": "string", "enum": ["info", "warning", "critical"] },
+					"file": { "type": "string" },
+					"suggestion": { "type": "string" }
+				}
+			}
+		},
+		"testCoverage": {
+			"type": "object",
+			"required": ["tested", "untested"],
+			"properties": {
+				"tested": { "type": "array", "items": { "type": "string" } },
+				"untested": { "type": "array", "items": { "type": "string" } }
+			}
+		},
+		"maintainability": {
+			"type": "object",
+			"required": ["score", "factors"],
+			"properties": {
+				"score": { "type": "string", "enum": ["high", "medium", "low"] },
+				"factors": { "type": "array", "items": { "type": "string" } }
+			}
+		}
+	}
 }

package/schemas/research-findings.schema.json

@@ -1,44 +1,44 @@
 {
-  "type": "object",
-  "required": ["questions", "patterns", "recommendations"],
-  "properties": {
-    "questions": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["question", "answer", "confidence"],
-        "properties": {
-          "question": { "type": "string" },
-          "answer": { "type": "string" },
-          "sources": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Where the answer came from — docs, other projects, known patterns"
-          },
-          "confidence": {
-            "type": "string",
-            "enum": ["high", "medium", "low"],
-            "description": "How confident the answer is — high = well-known pattern, low = best guess"
-          }
-        }
-      }
-    },
-    "patterns": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name", "description", "applicability"],
-        "properties": {
-          "name": { "type": "string" },
-          "description": { "type": "string" },
-          "applicability": { "type": "string", "description": "How this pattern applies to the specific gap" }
-        }
-      }
-    },
-    "recommendations": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Concrete recommendations based on research findings"
-    }
-  }
+	"type": "object",
+	"required": ["questions", "patterns", "recommendations"],
+	"properties": {
+		"questions": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["question", "answer", "confidence"],
+				"properties": {
+					"question": { "type": "string" },
+					"answer": { "type": "string" },
+					"sources": {
+						"type": "array",
+						"items": { "type": "string" },
+						"description": "Where the answer came from — docs, other projects, known patterns"
+					},
+					"confidence": {
+						"type": "string",
+						"enum": ["high", "medium", "low"],
+						"description": "How confident the answer is — high = well-known pattern, low = best guess"
+					}
+				}
+			}
+		},
+		"patterns": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["name", "description", "applicability"],
+				"properties": {
+					"name": { "type": "string" },
+					"description": { "type": "string" },
+					"applicability": { "type": "string", "description": "How this pattern applies to the specific gap" }
+				}
+			}
+		},
+		"recommendations": {
+			"type": "array",
+			"items": { "type": "string" },
+			"description": "Concrete recommendations based on research findings"
+		}
+	}
 }