engineering-process 0.1.0__py3-none-any.whl

engineering_process-0.1.0.data/data/share/engineering-process/bundles.json

@@ -0,0 +1,47 @@
+{
+  "schemaVersion": 1,
+  "bundles": {
+    "core": [
+      "define-change-contract",
+      "evolve-process",
+      "finish-change",
+      "implement-change",
+      "plan-change",
+      "review-change",
+      "run-change",
+      "verify-change"
+    ],
+    "delivery": [
+      "assess-design",
+      "run-project-command"
+    ],
+    "product": [
+      "implement-use-case",
+      "specify-use-case"
+    ],
+    "architecture": [
+      "design-module",
+      "implement-module"
+    ],
+    "api": [
+      "change-api"
+    ],
+    "frontend": [
+      "build-frontend",
+      "build-frontend-foundation",
+      "govern-ui"
+    ],
+    "mcp": [
+      "integrate-mcp"
+    ],
+    "docs": [
+      "maintain-docs"
+    ],
+    "publication": [
+      "publish-change"
+    ],
+    "cross-repo": [
+      "cross-repo-change"
+    ]
+  }
+}

engineering_process-0.1.0.data/data/share/engineering-process/examples/change.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 2,
+  "id": "issue-123",
+  "summary": "Add a bounded product capability",
+  "source": "issue-123",
+  "comparisonBase": "main",
+  "specification": {
+    "kind": "project",
+    "reference": "docs/specs/issue-123.md",
+    "rationale": "The project specification owns observable product behavior."
+  },
+  "risk": "medium",
+  "affectedProjects": ["sample-project"],
+  "acceptanceCriteria": [
+    {
+      "id": "ac-1",
+      "outcome": "The authorized user can complete the requested behavior"
+    }
+  ],
+  "requiredProfiles": ["development", "review"],
+  "signOff": {
+    "required": false,
+    "status": "not-required",
+    "evidence": null
+  }
+}

engineering_process-0.1.0.data/data/share/engineering-process/examples/plan.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "changeId": "issue-123",
+  "contractDigest": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+  "approach": "Implement the accepted behavior through its existing owner and preserve the current public contract.",
+  "workItems": [
+    {
+      "id": "work-1",
+      "outcome": "Implement and prove the accepted behavior",
+      "affectedPaths": ["src/", "tests/"],
+      "verificationProfiles": ["development", "review"]
+    }
+  ],
+  "acceptancePlan": [
+    {
+      "criterionId": "ac-1",
+      "workItems": ["work-1"],
+      "verificationProfiles": ["development", "review"]
+    }
+  ],
+  "risks": [
+    {
+      "risk": "Authorization could be bypassed by a new path.",
+      "mitigation": "Reuse the policy owner and prove unauthorized access is rejected."
+    }
+  ],
+  "openDecisions": []
+}

engineering_process-0.1.0.data/data/share/engineering-process/examples/project.json

@@ -0,0 +1,54 @@
+{
+  "schemaVersion": 3,
+  "project": "sample-project",
+  "lifecycle": {
+    "requiredProfiles": ["development", "review"]
+  },
+  "profiles": {
+    "development": [
+      {
+        "id": "unit",
+        "run": ["python", "-m", "unittest"],
+        "timeoutSeconds": 600
+      }
+    ],
+    "review": [
+      {
+        "id": "full",
+        "run": ["python", "-m", "unittest", "discover"],
+        "timeoutSeconds": 1800
+      }
+    ]
+  },
+  "environment": {
+    "defaultProfile": "development",
+    "foregroundOnly": true,
+    "managedTools": [],
+    "profiles": {
+      "development": [
+        "python-runtime"
+      ],
+      "review": [
+        "python-runtime"
+      ]
+    },
+    "requirements": [
+      {
+        "id": "python-runtime",
+        "description": "Supported CPython runtime",
+        "probe": {
+          "run": [
+            "python",
+            "--version"
+          ],
+          "timeoutSeconds": 15,
+          "readOnly": true,
+          "outputStream": "combined",
+          "outputRegex": "^Python 3\\.(?:11|12|13|14)\\."
+        },
+        "remediation": "Install a supported Python runtime before running processctl."
+      }
+    ],
+    "setupActions": []
+  }
+}

engineering_process-0.1.0.data/data/share/engineering-process/examples/review.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": 2,
+  "changeId": "issue-123",
+  "cycle": 1,
+  "checkpoint": "0123456789abcdef",
+  "workspaceFingerprint": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+  "comparisonBase": "main",
+  "reviewer": {
+    "actorId": "reviewer-1",
+    "contextId": "review-session-1",
+    "kind": "agent"
+  },
+  "independence": {
+    "method": "isolated-context",
+    "attestedBy": "agent-host",
+    "evidence": "The host created a read-only context that did not participate in implementation."
+  },
+  "verdict": "changes-requested",
+  "findings": [
+    {
+      "id": "finding-1",
+      "severity": "high",
+      "path": "src/authorization.py",
+      "line": 42,
+      "summary": "Authorization is missing",
+      "evidence": "The unsafe operation has no policy check",
+      "status": "open",
+      "resolutionEvidence": null
+    }
+  ]
+}

engineering_process-0.1.0.data/data/share/engineering-process/schemas/change.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineering-process.invalid/schemas/change.schema.json",
+  "title": "Engineering change specification",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "summary",
+    "source",
+    "comparisonBase",
+    "specification",
+    "risk",
+    "affectedProjects",
+    "acceptanceCriteria",
+    "requiredProfiles",
+    "signOff"
+  ],
+  "properties": {
+    "$schema": {"type": "string"},
+    "schemaVersion": {"const": 2},
+    "id": {
+      "type": "string",
+      "maxLength": 64,
+      "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+    },
+    "summary": {"type": "string", "minLength": 1, "maxLength": 500},
+    "source": {"type": "string", "minLength": 1, "maxLength": 1000},
+    "comparisonBase": {"type": "string", "minLength": 1, "maxLength": 256},
+    "specification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "reference", "rationale"],
+      "properties": {
+        "kind": {"enum": ["project", "change-contract"]},
+        "reference": {"type": "string", "minLength": 1, "maxLength": 1000},
+        "rationale": {"type": "string", "minLength": 1, "maxLength": 2000}
+      }
+    },
+    "risk": {"enum": ["low", "medium", "high"]},
+    "affectedProjects": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$"
+      }
+    },
+    "acceptanceCriteria": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "outcome"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "maxLength": 64,
+            "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+          },
+          "outcome": {"type": "string", "minLength": 1, "maxLength": 1000}
+        }
+      }
+    },
+    "requiredProfiles": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+      }
+    },
+    "signOff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["required", "status", "evidence"],
+      "properties": {
+        "required": {"type": "boolean"},
+        "status": {"enum": ["not-required", "pending", "approved"]},
+        "evidence": {"type": ["string", "null"], "maxLength": 1000}
+      }
+    }
+  }
+}

engineering_process-0.1.0.data/data/share/engineering-process/schemas/lifecycle.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineering-process.invalid/schemas/lifecycle.schema.json",
+  "title": "Engineering change lifecycle state",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "changeId",
+    "project",
+    "phase",
+    "cycle",
+    "revision",
+    "comparisonBase",
+    "contract",
+    "plan",
+    "implementationActors",
+    "verification",
+    "pendingFindings",
+    "reviewAssignment",
+    "review",
+    "completion",
+    "history"
+  ],
+  "properties": {
+    "schemaVersion": {"const": 2},
+    "changeId": {"type": "string"},
+    "project": {"type": "string"},
+    "phase": {
+      "enum": [
+        "specified",
+        "planned",
+        "implementing",
+        "verified",
+        "review-pending",
+        "changes-requested",
+        "approved",
+        "completed"
+      ]
+    },
+    "cycle": {"type": "integer", "minimum": 1},
+    "revision": {"type": "integer", "minimum": 1},
+    "comparisonBase": {"type": "string"},
+    "contract": {"$ref": "#/$defs/artifact"},
+    "plan": {"anyOf": [{"$ref": "#/$defs/artifact"}, {"type": "null"}]},
+    "implementationActors": {"type": "array", "items": {"$ref": "#/$defs/actor"}},
+    "verification": {"type": "array", "items": {"$ref": "#/$defs/evidence"}},
+    "pendingFindings": {"type": "array", "items": {"$ref": "#/$defs/finding"}},
+    "reviewAssignment": {"type": ["object", "null"]},
+    "review": {"anyOf": [{"$ref": "#/$defs/artifact"}, {"type": "null"}]},
+    "completion": {"anyOf": [{"$ref": "#/$defs/artifact"}, {"type": "null"}]},
+    "history": {"type": "array", "minItems": 1, "items": {"type": "object"}}
+  },
+  "$defs": {
+    "actor": {
+      "type": "object",
+      "required": ["actorId", "contextId", "kind"],
+      "properties": {
+        "actorId": {"type": "string"},
+        "contextId": {"type": "string"},
+        "kind": {"enum": ["agent", "human"]}
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "required": ["path", "digest"],
+      "properties": {
+        "path": {"type": "string"},
+        "digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"}
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "required": ["profile", "path", "digest", "checkpoint", "workspaceFingerprint"],
+      "properties": {
+        "profile": {"type": "string"},
+        "path": {"type": "string"},
+        "digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
+        "checkpoint": {"type": "string"},
+        "workspaceFingerprint": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"}
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "severity",
+        "path",
+        "line",
+        "summary",
+        "evidence",
+        "status",
+        "resolutionEvidence"
+      ],
+      "properties": {
+        "id": {"type": "string"},
+        "severity": {"enum": ["critical", "high", "medium", "low"]},
+        "path": {"type": "string"},
+        "line": {"type": ["integer", "null"], "minimum": 1},
+        "summary": {"type": "string"},
+        "evidence": {"type": "string"},
+        "status": {"enum": ["open", "deferred"]},
+        "resolutionEvidence": {"type": ["string", "null"], "maxLength": 4000}
+      },
+      "allOf": [
+        {
+          "if": {"properties": {"status": {"const": "open"}}},
+          "then": {"properties": {"resolutionEvidence": {"type": "null"}}}
+        },
+        {
+          "if": {"properties": {"status": {"const": "deferred"}}},
+          "then": {
+            "properties": {
+              "resolutionEvidence": {"type": "string", "minLength": 1}
+            }
+          }
+        }
+      ]
+    }
+  }
+}

engineering_process-0.1.0.data/data/share/engineering-process/schemas/plan.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineering-process.invalid/schemas/plan.schema.json",
+  "title": "Engineering implementation plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "changeId",
+    "contractDigest",
+    "approach",
+    "workItems",
+    "acceptancePlan",
+    "risks",
+    "openDecisions"
+  ],
+  "properties": {
+    "$schema": {"type": "string"},
+    "schemaVersion": {"const": 1},
+    "changeId": {
+      "type": "string",
+      "maxLength": 64,
+      "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+    },
+    "contractDigest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
+    "approach": {"type": "string", "minLength": 1, "maxLength": 4000},
+    "workItems": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "outcome", "affectedPaths", "verificationProfiles"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "maxLength": 64,
+            "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+          },
+          "outcome": {"type": "string", "minLength": 1, "maxLength": 1000},
+          "affectedPaths": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {"type": "string", "minLength": 1, "maxLength": 1000}
+          },
+          "verificationProfiles": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+            }
+          }
+        }
+      }
+    },
+    "acceptancePlan": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["criterionId", "workItems", "verificationProfiles"],
+        "properties": {
+          "criterionId": {
+            "type": "string",
+            "maxLength": 64,
+            "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+          },
+          "workItems": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {"type": "string"}
+          },
+          "verificationProfiles": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {"type": "string"}
+          }
+        }
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["risk", "mitigation"],
+        "properties": {
+          "risk": {"type": "string", "minLength": 1, "maxLength": 1000},
+          "mitigation": {"type": "string", "minLength": 1, "maxLength": 1000}
+        }
+      }
+    },
+    "openDecisions": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {"type": "string", "minLength": 1, "maxLength": 1000}
+    }
+  }
+}

engineering_process-0.1.0.data/data/share/engineering-process/schemas/process-lock.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineering-process.invalid/schemas/process-lock.schema.json",
+  "title": "Engineering process lock",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "process", "skills"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "process": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "digest"],
+      "properties": {
+        "version": {
+          "type": "string"
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        }
+      }
+    },
+    "skills": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+      }
+    }
+  }
+}