feat: add autonomous fiscal control panel

agent/src/gti_fiscal_agent/client.py

@@ -20,6 +20,15 @@ class HubClient:
         payload = {"status": status, "schema_fingerprint": schema_fingerprint, "agent_version": agent_version, "last_job_id": last_job_id}
         response = httpx.post(f"{self.url}/v1/agents/heartbeat", json=payload, headers=self._headers(), timeout=15)
         response.raise_for_status(); return response.json()
+    def register(self, payload):
+        response = httpx.post(f"{self.url}/v1/agents/register", json=payload, headers=self._headers(), timeout=15)
+        response.raise_for_status(); return response.json()
+    def heartbeat_metadata(self, payload):
+        response = httpx.post(f"{self.url}/v1/agents/heartbeat", json=payload, headers=self._headers(), timeout=15)
+        response.raise_for_status(); return response.json()
+    def event(self, payload):
+        response = httpx.post(f"{self.url}/v1/agents/events", json=payload, headers=self._headers(), timeout=15)
+        response.raise_for_status(); return response.json()
     def next_job(self):
         response = httpx.get(f"{self.url}/v1/jobs/next", headers=self._headers(), timeout=15)
         response.raise_for_status(); return response.json()

agent/src/gti_fiscal_agent/state.py

@@ -1,11 +1,21 @@
 """Local SQLite outbox; it has no Firebird dependency or write path."""
 import sqlite3
 from pathlib import Path
+import uuid
 
 class AgentState:
     def __init__(self, path):
         self.connection = sqlite3.connect(Path(path)); self.connection.row_factory = sqlite3.Row
         self.connection.executescript("CREATE TABLE IF NOT EXISTS product_state(product_id TEXT PRIMARY KEY, source_fingerprint TEXT NOT NULL, dataset_version TEXT NOT NULL, engine_version TEXT NOT NULL, status TEXT NOT NULL, last_processed_at TEXT, last_result_hash TEXT, reason_code TEXT); CREATE TABLE IF NOT EXISTS outbox(product_id TEXT PRIMARY KEY, source_fingerprint TEXT NOT NULL, status TEXT NOT NULL, retries INTEGER NOT NULL DEFAULT 0); CREATE TABLE IF NOT EXISTS ipi_write_log(product_id TEXT NOT NULL, source_fingerprint TEXT NOT NULL, decision_status TEXT, ipi_status TEXT, write_status TEXT NOT NULL, before_value TEXT, proposed_value TEXT, result TEXT, reason_code TEXT, timestamp TEXT NOT NULL);")
+        self.connection.execute("CREATE TABLE IF NOT EXISTS installation_identity (id INTEGER PRIMARY KEY CHECK(id=1), installation_id TEXT NOT NULL)")
+        self.connection.commit()
+    def installation_id(self):
+        row = self.connection.execute("SELECT installation_id FROM installation_identity WHERE id=1").fetchone()
+        if row:
+            return row["installation_id"]
+        value = str(uuid.uuid4())
+        self.connection.execute("INSERT INTO installation_identity(id, installation_id) VALUES(1, ?)", (value,)); self.connection.commit()
+        return value
     def enqueue(self, product_id, source_fingerprint, dataset_version, engine_version):
         row = self.connection.execute("SELECT * FROM product_state WHERE product_id=?", (product_id,)).fetchone()
         if row and tuple(row[key] for key in ("source_fingerprint", "engine_version", "status")) == (source_fingerprint, engine_version, "RESULT_RECEIVED"): return False