archgraph-argo 0.1.0

package/argo/schema/ImplementationToIntentTraceProposal.schema.json

@@ -0,0 +1,180 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "./.argo/schema/ImplementationToIntentTraceProposal.schema.json",
+  "title": "Implementation To Intent Trace Proposal Schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "proposalType",
+    "generatedAt",
+    "sourceAgent",
+    "targetAgent",
+    "lifecycle",
+    "sourceIntentGraphPath",
+    "implementationContracts",
+    "anchorProposals"
+  ],
+  "properties": {
+    "proposalType": {
+      "type": "string",
+      "const": "implementation-to-intent-trace"
+    },
+    "generatedAt": {
+      "type": "string"
+    },
+    "sourceAgent": {
+      "type": "string",
+      "const": "ImplementationDesign"
+    },
+    "targetAgent": {
+      "type": "string",
+      "const": "IntentionDesign"
+    },
+    "lifecycle": {
+      "type": "string",
+      "const": "temporary-trace-proposal"
+    },
+    "sourceIntentGraphPath": {
+      "type": "string"
+    },
+    "implementationContracts": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      }
+    },
+    "anchorProposals": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/anchorProposal"
+      }
+    },
+    "openQuestions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/openQuestion"
+      }
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "$defs": {
+    "anchorProposal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "intentElementId",
+        "implementationElementName",
+        "implementationElementKind",
+        "implementsType",
+        "tracePurpose",
+        "contractPaths",
+        "contextEntryPoints",
+        "excludedDetails"
+      ],
+      "properties": {
+        "intentElementId": {
+          "type": "string"
+        },
+        "intentElementName": {
+          "type": "string"
+        },
+        "implementationElementName": {
+          "type": "string"
+        },
+        "implementationElementKind": {
+          "type": "string",
+          "enum": [
+            "stable-directory",
+            "contract-file",
+            "explicit-test-entry",
+            "critical-guardrail",
+            "runtime-component",
+            "schema-contract",
+            "mcp-tool",
+            "command"
+          ]
+        },
+        "implementsType": {
+          "type": "string",
+          "enum": [
+            "direct",
+            "indirect"
+          ]
+        },
+        "tracePurpose": {
+          "type": "string"
+        },
+        "contractPaths": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        },
+        "contextEntryPoints": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        },
+        "excludedDetails": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        },
+        "suggestedIntentAttributes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/intentAttribute"
+          }
+        }
+      }
+    },
+    "intentAttribute": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "description"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+    "openQuestion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "question",
+        "recommendedAnswer",
+        "reason"
+      ],
+      "properties": {
+        "question": {
+          "type": "string"
+        },
+        "recommendedAnswer": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/argo/schema/IntentToImplementationHandoff.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "./.argo/schema/IntentToImplementationHandoff.schema.json",
+  "title": "Intent To Implementation Handoff Schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "stage",
+    "generatedAt",
+    "sourceIntentGraphPath",
+    "intentElementIds"
+  ],
+  "properties": {
+    "stage": {
+      "type": "string",
+      "const": "intent-to-implementation"
+    },
+    "generatedAt": {
+      "type": "string"
+    },
+    "sourceIntentGraphPath": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "intentElementIds": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      }
+    },
+    "relationshipIds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "openQuestions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/openQuestion"
+      }
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "$defs": {
+    "openQuestion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "question",
+        "recommendedAnswer",
+        "reason"
+      ],
+      "properties": {
+        "question": {
+          "type": "string"
+        },
+        "recommendedAnswer": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/argo/schema/SystemArchitecture.schema.json

@@ -0,0 +1,378 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "./.argo/schema/SystemArchitecture.schema.json",
+  "title": "SystemArchitecture Knowledge Graph Schema",
+  "description": "Schema for design/KG/SystemArchitecture.json. The repository keeps its existing knowledge-graph shape, while ArchiMate 3.2 terminology is enforced for element and relationship concepts.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "name",
+    "description",
+    "elements",
+    "relationships",
+    "views"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1
+    },
+    "attributes": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/attribute"
+      }
+    },
+    "elements": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/element"
+      }
+    },
+    "relationships": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/relationship"
+      }
+    },
+    "views": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/view"
+      }
+    }
+  },
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "archimateElementType": {
+      "type": "string",
+      "enum": [
+        "Resource",
+        "Capability",
+        "Value Stream",
+        "Course of Action",
+        "Business Actor",
+        "Business Role",
+        "Business Collaboration",
+        "Business Interface",
+        "Business Process",
+        "Business Function",
+        "Business Interaction",
+        "Business Event",
+        "Business Service",
+        "Business Object",
+        "Contract",
+        "Representation",
+        "Product",
+        "Application Component",
+        "Application Collaboration",
+        "Application Interface",
+        "Application Process",
+        "Application Function",
+        "Application Interaction",
+        "Application Event",
+        "Application Service",
+        "Data Object",
+        "Node",
+        "Device",
+        "System Software",
+        "Technology Collaboration",
+        "Technology Interface",
+        "Path",
+        "Communication Network",
+        "Technology Process",
+        "Technology Function",
+        "Technology Interaction",
+        "Technology Event",
+        "Technology Service",
+        "Artifact",
+        "Equipment",
+        "Facility",
+        "Distribution Network",
+        "Material",
+        "Stakeholder",
+        "Driver",
+        "Assessment",
+        "Goal",
+        "Outcome",
+        "Principle",
+        "Requirement",
+        "Constraint",
+        "Meaning",
+        "Value",
+        "Work Package",
+        "Deliverable",
+        "Implementation Event",
+        "Plateau",
+        "Gap",
+        "Grouping",
+        "Location",
+        "And Junction",
+        "Or Junction",
+        "Skill",
+        "Rule"
+      ]
+    },
+    "archimateRelationshipType": {
+      "type": "string",
+      "enum": [
+        "Association",
+        "Composition",
+        "Aggregation",
+        "Assignment",
+        "Realization",
+        "Serving",
+        "Access",
+        "Influence",
+        "Triggering",
+        "Flow",
+        "Specialization"
+      ]
+    },
+    "attribute": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "description": "Generic EA-style attribute container. Use this for architecture annotations such as verification_focus, external_scope, acceptance_outcomes, and design_risks instead of introducing dedicated top-level fields.",
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "description": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        }
+      }
+    },
+    "subdiagramView": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "view_id",
+        "view_name"
+      ],
+      "properties": {
+        "view_id": {
+          "$ref": "#/$defs/identifier"
+        },
+        "view_name": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "testcase": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "description",
+        "type",
+        "Input",
+        "acceptanceCriteria"
+      ],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/nonEmptyString",
+          "description": "Stable testcase identifier. Use the testcase name itself as the long-lived identity; do not add a separate testcase id field."
+        },
+        "description": {
+          "$ref": "#/$defs/nonEmptyString",
+          "description": "Place the intent being verified here. Each testcase should normally be mounted under exactly one element rather than using extra verifies_elements or verifies_intents fields."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "Acceptance Test"
+          ]
+        },
+        "Input": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "acceptanceCriteria": {
+          "$ref": "#/$defs/nonEmptyString",
+          "description": "By the end of implementation design, this must be the concrete workspace-relative executable testcase entrypoint for the testcase, optionally including a pytest node id selector such as tests/test_x.py::test_y, rather than descriptive prose."
+        },
+        "TestResults": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "element": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "type"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/identifier"
+        },
+        "name": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "parent": {
+          "$ref": "#/$defs/identifier"
+        },
+        "type": {
+          "$ref": "#/$defs/archimateElementType"
+        },
+        "alias": {
+          "type": "string"
+        },
+        "classifier": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "attributes": {
+          "type": "array",
+          "description": "Use attributes to store additional architecture intent metadata, including verification_focus, external_scope, acceptance_outcomes, and design_risks.",
+          "items": {
+            "$ref": "#/$defs/attribute"
+          }
+        },
+        "subdiagram_views": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/subdiagramView"
+          }
+        },
+        "testcases": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/testcase"
+          }
+        }
+      }
+    },
+    "relationshipAttribute": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "description": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "relationship": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "statement",
+        "name",
+        "type",
+        "source_id",
+        "target_id",
+        "source_name",
+        "target_name"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/identifier"
+        },
+        "statement": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "name": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "type": {
+          "$ref": "#/$defs/archimateRelationshipType"
+        },
+        "description": {
+          "type": "string"
+        },
+        "document": {
+          "type": "string"
+        },
+        "attributes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/relationshipAttribute"
+          }
+        },
+        "source_id": {
+          "$ref": "#/$defs/identifier"
+        },
+        "target_id": {
+          "$ref": "#/$defs/identifier"
+        },
+        "source_name": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "target_name": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "view": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "view_id",
+        "view_name"
+      ],
+      "properties": {
+        "view_id": {
+          "$ref": "#/$defs/identifier"
+        },
+        "view_name": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "parent_element_id": {
+          "$ref": "#/$defs/identifier"
+        },
+        "parent_element_name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "included_elements": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/identifier"
+          }
+        },
+        "included_relationships": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/identifier"
+          }
+        }
+      }
+    }
+  }
+}