@acrasie/dev-flow 0.0.0-stage → 1.0.1

package/schemas/project-init-state.schema.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Dev Flow agentic Project INIT session state",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "sessionId",
+    "profileId",
+    "revision",
+    "status",
+    "decisions",
+    "staleDecisionKeys",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "sessionId": { "$ref": "#/$defs/id" },
+    "profileId": { "$ref": "#/$defs/id" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "status": {
+      "type": "string",
+      "enum": ["discovering", "awaiting_decision", "awaiting_approval", "blocked"]
+    },
+    "decisions": {
+      "type": "array",
+      "maxItems": 512,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["key", "value", "source", "sourceRefs", "dependsOn"],
+        "properties": {
+          "key": { "$ref": "#/$defs/key" },
+          "value": { "$ref": "#/$defs/text" },
+          "source": {
+            "type": "string",
+            "enum": ["user", "repository", "policy", "official_documentation", "user_asserted"]
+          },
+          "sourceRefs": { "$ref": "#/$defs/refs" },
+          "dependsOn": {
+            "type": "array",
+            "uniqueItems": true,
+            "maxItems": 64,
+            "items": { "$ref": "#/$defs/key" }
+          }
+        }
+      }
+    },
+    "activeQuestion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "decisionKey",
+        "prompt",
+        "evidenceRefs",
+        "options",
+        "recommendedOptionId",
+        "recommendationBasis",
+        "recommendationConfidence",
+        "parentDecisionKeys",
+        "directConsequences"
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "decisionKey": { "$ref": "#/$defs/key" },
+        "prompt": { "$ref": "#/$defs/text" },
+        "evidenceRefs": { "$ref": "#/$defs/refs" },
+        "options": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 3,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "label", "impact"],
+            "properties": {
+              "id": { "$ref": "#/$defs/id" },
+              "label": { "type": "string", "minLength": 1, "maxLength": 200 },
+              "impact": { "$ref": "#/$defs/text" }
+            }
+          }
+        },
+        "recommendedOptionId": { "$ref": "#/$defs/id" },
+        "recommendationBasis": { "$ref": "#/$defs/text" },
+        "recommendationConfidence": {
+          "type": "string",
+          "enum": ["high", "medium", "low"]
+        },
+        "parentDecisionKeys": {
+          "type": "array",
+          "uniqueItems": true,
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/key" }
+        },
+        "directConsequences": {
+          "type": "array",
+          "maxItems": 16,
+          "items": { "$ref": "#/$defs/text" }
+        }
+      }
+    },
+    "staleDecisionKeys": {
+      "type": "array",
+      "uniqueItems": true,
+      "maxItems": 512,
+      "items": { "$ref": "#/$defs/key" }
+    },
+    "candidateContentDigest": { "$ref": "#/$defs/digest" },
+    "blockedReason": { "$ref": "#/$defs/text" },
+    "updatedAt": { "$ref": "#/$defs/timestamp" }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[a-z0-9][a-z0-9._-]*$"
+    },
+    "key": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "text": { "type": "string", "minLength": 1, "maxLength": 2000 },
+    "refs": {
+      "type": "array",
+      "maxItems": 64,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1, "maxLength": 500 }
+    },
+    "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "timestamp": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "awaiting_decision" } } },
+      "then": { "properties": { "activeQuestion": true }, "required": ["activeQuestion"] },
+      "else": { "not": { "required": ["activeQuestion"] } }
+    },
+    {
+      "if": { "properties": { "status": { "const": "awaiting_approval" } } },
+      "then": {
+        "properties": { "candidateContentDigest": true },
+        "required": ["candidateContentDigest"]
+      },
+      "else": { "not": { "required": ["candidateContentDigest"] } }
+    },
+    {
+      "if": { "properties": { "status": { "const": "blocked" } } },
+      "then": { "properties": { "blockedReason": true }, "required": ["blockedReason"] },
+      "else": { "not": { "required": ["blockedReason"] } }
+    }
+  ]
+}

package/schemas/project-profile-local.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Dev Flow local project engineering profile overlay",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "profileId", "servicePaths", "preferences"],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "profileId": { "$ref": "#/$defs/id" },
+    "sharedContentDigest": { "$ref": "#/$defs/digest" },
+    "servicePaths": {
+      "type": "array",
+      "maxItems": 128,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["serviceId", "path"],
+        "properties": {
+          "serviceId": { "$ref": "#/$defs/id" },
+          "path": { "type": "string", "minLength": 1, "maxLength": 2000 }
+        }
+      }
+    },
+    "preferences": {
+      "type": "array",
+      "maxItems": 128,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["key", "value"],
+        "properties": {
+          "key": { "$ref": "#/$defs/key" },
+          "value": { "type": "string", "minLength": 1, "maxLength": 2000 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^[a-z0-9][a-z0-9._-]*$"
+    },
+    "key": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/schemas/project-profile.schema.json

@@ -0,0 +1,285 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Dev Flow shared project engineering profile",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "profileId", "revision", "contentDigest", "content", "approval"],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "profileId": { "$ref": "#/$defs/id" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "contentDigest": { "$ref": "#/$defs/digest" },
+    "content": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project", "stack", "topology", "decisions", "diagramRefs"],
+      "properties": {
+        "project": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "name"],
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "name": { "$ref": "#/$defs/text" }
+          }
+        },
+        "stack": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "role", "sourceRefs"],
+            "properties": {
+              "id": { "$ref": "#/$defs/id" },
+              "role": { "$ref": "#/$defs/text" },
+              "version": { "$ref": "#/$defs/shortText" },
+              "sourceRefs": { "$ref": "#/$defs/sourceRefs" }
+            }
+          }
+        },
+        "topology": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["rootServiceId", "services"],
+          "properties": {
+            "rootServiceId": { "$ref": "#/$defs/id" },
+            "services": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 128,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["id", "responsibility", "dependencies", "contracts", "sourceRefs"],
+                "properties": {
+                  "id": { "$ref": "#/$defs/id" },
+                  "responsibility": { "$ref": "#/$defs/text" },
+                  "dependencies": {
+                    "type": "array",
+                    "uniqueItems": true,
+                    "maxItems": 64,
+                    "items": { "$ref": "#/$defs/id" }
+                  },
+                  "contracts": {
+                    "type": "array",
+                    "uniqueItems": true,
+                    "maxItems": 64,
+                    "items": { "$ref": "#/$defs/text" }
+                  },
+                  "profileRef": { "$ref": "#/$defs/profileRef" },
+                  "sourceRefs": { "$ref": "#/$defs/sourceRefs" }
+                }
+              }
+            }
+          }
+        },
+        "decisions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 512,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "key",
+              "category",
+              "value",
+              "rationale",
+              "provenance",
+              "sourceFingerprints",
+              "dependsOn"
+            ],
+            "properties": {
+              "key": { "$ref": "#/$defs/key" },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "stack",
+                  "source_structure",
+                  "architecture",
+                  "dependency_direction",
+                  "naming",
+                  "error_handling",
+                  "testing",
+                  "quality",
+                  "frontend",
+                  "api",
+                  "data",
+                  "security",
+                  "concurrency",
+                  "performance",
+                  "compatibility",
+                  "migration",
+                  "observability",
+                  "deployment",
+                  "rollback",
+                  "operations"
+                ]
+              },
+              "value": { "$ref": "#/$defs/text" },
+              "rationale": { "$ref": "#/$defs/text" },
+              "provenance": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["kind", "sourceRefs", "capturedAt"],
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "user",
+                      "repository",
+                      "policy",
+                      "official_documentation",
+                      "user_asserted"
+                    ]
+                  },
+                  "sourceRefs": { "$ref": "#/$defs/sourceRefs" },
+                  "capturedAt": { "$ref": "#/$defs/timestamp" }
+                }
+              },
+              "sourceFingerprints": {
+                "type": "array",
+                "maxItems": 64,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["sourceRef", "value"],
+                  "properties": {
+                    "sourceRef": { "$ref": "#/$defs/sourceRef" },
+                    "value": { "$ref": "#/$defs/fingerprint" }
+                  }
+                }
+              },
+              "dependsOn": {
+                "type": "array",
+                "uniqueItems": true,
+                "maxItems": 64,
+                "items": { "$ref": "#/$defs/key" }
+              }
+            }
+          }
+        },
+        "domainDocumentation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "contextMode",
+            "glossaryPath",
+            "rulesPath",
+            "adrDirectory",
+            "language",
+            "identityConvention",
+            "linkConvention",
+            "sourceFingerprints"
+          ],
+          "properties": {
+            "contextMode": { "enum": ["single", "multiple"] },
+            "glossaryPath": { "$ref": "#/$defs/repositoryPath" },
+            "rulesPath": { "$ref": "#/$defs/repositoryPath" },
+            "adrDirectory": { "$ref": "#/$defs/repositoryPath" },
+            "contextMapPath": { "$ref": "#/$defs/repositoryPath" },
+            "language": { "$ref": "#/$defs/shortText" },
+            "identityConvention": { "$ref": "#/$defs/text" },
+            "linkConvention": { "$ref": "#/$defs/text" },
+            "sourceFingerprints": {
+              "type": "array",
+              "maxItems": 64,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["sourceRef", "value"],
+                "properties": {
+                  "sourceRef": { "$ref": "#/$defs/sourceRef" },
+                  "value": { "$ref": "#/$defs/fingerprint" }
+                }
+              }
+            }
+          },
+          "allOf": [
+            {
+              "if": {
+                "properties": { "contextMode": { "const": "multiple" } },
+                "required": ["contextMode"]
+              },
+              "then": {
+                "properties": { "contextMapPath": {} },
+                "required": ["contextMapPath"]
+              }
+            }
+          ]
+        },
+        "diagramRefs": {
+          "type": "array",
+          "uniqueItems": true,
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/repositoryPath" }
+        }
+      }
+    },
+    "approval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "actor",
+        "approvedAt",
+        "profileId",
+        "revision",
+        "contentDigest",
+        "receiptDigest"
+      ],
+      "properties": {
+        "schemaVersion": { "type": "integer", "const": 1 },
+        "actor": { "type": "string", "const": "user" },
+        "approvedAt": { "$ref": "#/$defs/timestamp" },
+        "profileId": { "$ref": "#/$defs/id" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "contentDigest": { "$ref": "#/$defs/digest" },
+        "receiptDigest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^[a-z0-9][a-z0-9._-]*$"
+    },
+    "key": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "shortText": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "text": { "type": "string", "minLength": 1, "maxLength": 2000 },
+    "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "timestamp": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+    },
+    "fingerprint": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "sourceRef": { "type": "string", "minLength": 1, "maxLength": 500 },
+    "sourceRefs": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/sourceRef" }
+    },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500,
+      "pattern": "^(?!/)(?![A-Za-z]:[\\\\/])(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+    },
+    "profileRef": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500
+    }
+  }
+}