VATFIX: freeze semantics + CI validation

Author: midiakiasat

.github/workflows/core-ci.yml

@@ -0,0 +1,24 @@
+name: VATFIX Core CI
+
+on:
+  push:
+    branches: [ "main" ]
+  workflow_dispatch:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: bash scripts/validate_core.sh
+      - name: Verify README identity (SYS-004)
+        run: |
+          set -euo pipefail
+          HEADER=$(sed -n '/^```$/,/^```$/p' README.md | head -10)
+          echo "$HEADER" | grep -q '^SYS-004$' || { echo "FAIL: SYS-004 not found"; exit 1; }
+          echo "$HEADER" | grep -q '^STATUS: REGISTERED$' || { echo "FAIL: STATUS missing"; exit 1; }
+          echo "$HEADER" | grep -q '^REGISTRY: https://vatfix.eu$' || { echo "FAIL: REGISTRY missing"; exit 1; }
+          echo "PASS: SYS-004 identity verified"

schema/claim.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["country_code", "vat_number", "timestamp"],
+  "properties": {
+    "country_code": {
+      "type": "string",
+      "pattern": "^[A-Z]{2}$",
+      "description": "ISO 3166-1 alpha-2 country code"
+    },
+    "vat_number": {
+      "type": "string",
+      "minLength": 1,
+      "description": "VAT number without country prefix"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 UTC timestamp"
+    },
+    "requester": {
+      "type": "string",
+      "description": "Optional requester identifier"
+    }
+  }
+}

schema/result.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["outcome", "timestamp", "evidence"],
+  "properties": {
+    "outcome": {
+      "type": "string",
+      "enum": ["VALID", "INVALID", "UNAVAILABLE", "INDETERMINATE"]
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "evidence": {
+      "type": "object",
+      "required": ["authority", "response"],
+      "properties": {
+        "authority": {"type": "string"},
+        "response": {"type": ["string", "object", "null"]},
+        "cache_age": {"type": "integer", "minimum": 0}
+      }
+    },
+    "failure_code": {
+      "type": "string",
+      "description": "Present if outcome is INVALID or INDETERMINATE"
+    }
+  }
+}

scripts/validate_core.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+test -f FAILURE_CODES.json
+test -f schema/claim.schema.json
+test -f schema/result.schema.json
+echo "files: ok"
+python3 - <<'PY'
+import json,glob
+fc=json.load(open("FAILURE_CODES.json"))
+assert fc.get("namespace")=="VATFIX"
+codes=[c["code"] for c in fc["codes"]]
+assert len(codes)==len(set(codes))
+print("failure_codes: ok")
+PY