+- `sqlite` pe jumper

+- `perl-DBD-SQLite` pe jumper

+

+## 2026-06-09 - SQLite Runtime Source of Truth

+

+Observație: editările de hosts făcute în aplicația live puteau rămâne în working tree-ul de pe jumper sau puteau fi suprascrise/confuzionate la push-ul de cod. Modelul vechi descria simultan `config/hosts.yaml` ca registry editabil în git și ca dată operațională runtime, ceea ce nu era o sursă de adevăr clară.

+

+Decizie:

+

+- `var/host-manager.sqlite` devine sursa de adevăr runtime pentru registry și Work Orders

+- `config/hosts.yaml` și `config/work-orders.yaml` rămân seed/snapshot/export compatibility files

+- la prima pornire, aplicația seed-uiește documentele lipsă din YAML în SQLite

+- download-urile `/download/hosts.yaml`, `/download/local-hosts.tsv` și `/download/monitoring.json` sunt randate din SQLite

+- `config/local-hosts.tsv` rămâne manifest generat explicit pentru sync-ul DNS local

+- push-urile de cod către jumper nu trebuie să înlocuiască baza runtime din `var/`

+

+Scop:

+

+- editările făcute în UI să nu se piardă la deploy/push de cod

+- să existe o singură autoritate runtime

+- YAML/TSV să rămână utile pentru export, review și bootstrap fără să fie storage-ul live

+MVP-ul curent nu are dependențe CPAN instalate direct pe host. Pentru store-ul runtime folosește `DBI`/`DBD::SQLite` disponibile din distribuție sau repo-ul local auditat, plus SQLite.

+`var/host-manager.sqlite` este sursa de adevăr runtime pentru registry și Work Orders. La prima pornire, aplicația seed-uiește baza din `config/hosts.yaml` și `config/work-orders.yaml` dacă documentele lipsesc din SQLite. Aplicația este complet în spatele autentificării OTP pentru orice date de registru, exporturi sau modificări.

+Git rămâne mecanismul pentru cod, seed-uri, exporturi și istoric manual. Aplicația nu mai scrie registry-ul live direct în working tree, ca editările făcute în UI să nu se piardă la push/deploy de cod.

+Schimbările cu impact operațional care elimină nume sau schimbă semantica serviciilor locale se fac prin Work Order (WO), nu prin ștergere directă din UI. WO-ul rămâne în store-ul runtime, exprimă intenția operațională și trebuie dus până la capăt înainte să modifice registrul.

+1. Hosturile se editează în aplicație; store-ul runtime este `var/host-manager.sqlite`.

+3. Pentru DNS local, butonul `Write local-hosts.tsv` regenerează `config/local-hosts.tsv` din SQLite.

+Work Orders sunt păstrate în SQLite. `config/work-orders.yaml` rămâne seed/snapshot compatibil pentru instalări noi și export manual.

+- elimină numele declarate din registry-ul SQLite

+După confirmare, operatorul verifică exportul și rulează explicit:

+`madagascar.xdev.ro` este domeniul implicit al rețelei interne. În registry se declară doar numele canonice/FQDN-urile necesare.

+Varianta obligatorie pentru servicii automate este să consume exporturi generate și verificate, nu să depindă de HTTP neautentificat. Serviciile care sincronizează DNS, monitorizare sau inventare primesc chei dedicate, cu acces minim.

+  var/host-manager.sqlite  sursă runtime pentru registry și Work Orders

+  host-manager             editează SQLite cu OTP

+  export verificat         citesc hosts.yaml/local-hosts.tsv/monitoring.json

+Pentru etapa MVP, aplicația nu face commit/push automat. După o modificare, schimbarea rămâne în SQLite și poate fi exportată explicit pentru review/arhivare. Automatizarea commit/push pentru exporturi poate fi adăugată ulterior, dar numai cu cheie separată și reguli clare de semnare/audit.

+- Conflict engine-ul verifică doar consistența locală din registry-ul SQLite.

+| `var/host-manager.sqlite` | sursa de adevăr runtime pentru registry și Work Orders |

+| `config/hosts.yaml` | seed/snapshot export pentru hosturi și FQDN-uri canonice |

+`madagascar.xdev.ro` este domeniul implicit. Pentru orice nume `*.madagascar.xdev.ro`, aliasul scurt este derivat automat. De exemplu, `autonas01.madagascar.xdev.ro` publică și `autonas01`, iar `pmx.baobab.madagascar.xdev.ro` publică și `pmx.baobab`. Aliasurile derivate nu se declară separat în registry.

+3. `var/host-manager.sqlite` — registry-ul operațional aprobat, editat prin Madagascar Local Authority.

+4. `config/local-hosts.tsv` — manifestul DNS local publicat pe jumper și as01. Acesta trebuie să fie derivat sau validat din DHCP plus topologia clusterului, nu folosit ca sursă primară de alocare IP.

+5. `hosts-local.yaml` — inventar SSH: aliasuri, utilizatori, entrypoint-uri și căi de acces. IP-urile de aici sunt utile pentru audit, dar pot fi stale dacă DHCP spune altceva.

+6. mDNS (`*.local`) — sursă observată de descoperire și validare. Confirmă prezența unui host sau propune aliasuri, dar nu creează automat intrări `madagascar.xdev.ro`.

+7. DNS public — folosit doar pentru acces extern. Local, numele interne trebuie shadow-uite exact sau lăsate nerezolvate; wildcard-ul public nu este autoritate pentru LAN.

+Regulă importantă: listenerul mDNS nu modifică registry-ul SQLite, `config/hosts.yaml` sau `config/local-hosts.tsv`. Seed-ul mDNS rămâne observație separată până la review.

+# 1. Adaugă hostul în Madagascar Local Authority.

+# Aplicația păstrează registry-ul în var/host-manager.sqlite.

+- `var/host-manager.sqlite` - runtime source of truth for host registry and Work Orders

+- `config/hosts.yaml` - seed/snapshot export for host registry compatibility

+- `config/work-orders.yaml` - seed/snapshot export for confirmable operational changes

+The web UI is OTP-protected for all registry data, downloads, exports, and writes. Automation should consume generated exports with dedicated read-only access, not unauthenticated HTTP.

+`config/` is not deployed by default. The live source of truth is `var/host-manager.sqlite`; `hosts.yaml`, `local-hosts.tsv`, and `work-orders.yaml` are seed/snapshot/export files that should not replace runtime data during normal code pushes. Deploy config only when intentionally replacing seed/export files:

+Name removals with operational impact go through a Work Order. A WO records intent first; the operational checklist must be completed before confirmation can update the SQLite registry, mark the WO as confirmed, and regenerate `local-hosts.tsv`. Resolver sync remains an explicit operator step.

+- Runtime registry and Work Orders live in `var/host-manager.sqlite` on jumper.

+- Do not deploy `config/` unless the user explicitly asks to replace seed/snapshot/export files.

+- Treat `config/hosts.yaml`, `config/local-hosts.tsv`, and `config/work-orders.yaml` as compatibility exports/seeds, not the live source of truth.

+  storage_authority: "sqlite"

+  runtime_database: "var/host-manager.sqlite"

+- `perl-DBI` / `perl-DBD-SQLite` dacă nu sunt deja disponibile

+- `sqlite`

+  var/host-manager.sqlite

+## Runtime store

+

+`var/host-manager.sqlite` este sursa de adevăr pentru registry și Work Orders. La prima pornire, aplicația seed-uiește documentele lipsă din `config/hosts.yaml` și `config/work-orders.yaml`; ulterior push-urile de cod nu trebuie să înlocuiască baza runtime.

+

+`host-manager-mdns` este un listener separat care observă mDNS și seeduiește `var/mdns-observations.yaml`. Listenerul nu modifică registry-ul SQLite, `config/hosts.yaml` sau `config/local-hosts.tsv`.

+HOST_MANAGER_DB=/usr/local/xdev-host-manager/var/host-manager.sqlite

+use DBI;

+    db => $ENV{HOST_MANAGER_DB} || "$project_dir/var/host-manager.sqlite",

+    } elsif ($arg eq '--db') {

+        $opt{db} = shift @ARGV;

+print "database: $opt{db}\n";

+print "seed/export hosts file: $opt{data}\n";

+  HOST_MANAGER_DB               Defaults to var/host-manager.sqlite.

+SQLite is the runtime source of truth. YAML files seed a new database and remain

+download/export compatibility artifacts. The nginx vhost keeps registry, CA,

+work order and download endpoints behind OTP.

+        my $registry = load_registry();

+        return send_download($client, 200, render_hosts_yaml($registry), 'application/x-yaml; charset=utf-8', 'hosts.yaml');

+    my $registry = parse_hosts_yaml(load_operational_doc('hosts_yaml', $opt{data}, default_hosts_yaml()));

+    normalize_registry_policy($registry);

+    return $registry;

+    normalize_registry_policy($registry);

+    save_operational_doc('hosts_yaml', render_hosts_yaml($registry));

+    return parse_work_orders_yaml(load_operational_doc('work_orders_yaml', $opt{work_orders}, default_work_orders_yaml()));

+    save_operational_doc('work_orders_yaml', render_work_orders_yaml($orders));

+    $out .= "# Generated by scripts/host_manager.pl from the runtime SQLite registry.\n";

+        source => $opt{db},

+my $db_handle;

+

+sub dbh {

+    return $db_handle if $db_handle;

+    ensure_parent_dir($opt{db});

+    $db_handle = DBI->connect(

+        "dbi:SQLite:dbname=$opt{db}",

+        '',

+        '',

+        {

+            RaiseError => 1,

+            PrintError => 0,

+            AutoCommit => 1,

+            sqlite_unicode => 1,

+        },

+    ) or die "Cannot open SQLite database $opt{db}\n";

+    $db_handle->do('PRAGMA journal_mode = WAL');

+    $db_handle->do('PRAGMA foreign_keys = ON');

+    $db_handle->do(<<'SQL');

+CREATE TABLE IF NOT EXISTS documents (

+    name TEXT PRIMARY KEY,

+    content TEXT NOT NULL,

+    updated_at TEXT NOT NULL

+)

+SQL

+    return $db_handle;

+}

+

+sub load_operational_doc {

+    my ($name, $seed_path, $default_text) = @_;

+    my $dbh = dbh();

+    my $row = $dbh->selectrow_hashref('SELECT content FROM documents WHERE name = ?', undef, $name);

+    return $row->{content} if $row;

+

+    my $content = -f $seed_path ? read_file($seed_path) : $default_text;

+    save_operational_doc($name, $content);

+    return $content;

+}

+

+sub save_operational_doc {

+    my ($name, $content) = @_;

+    my $dbh = dbh();

+    $dbh->do(

+        'INSERT INTO documents (name, content, updated_at) VALUES (?, ?, ?) '

+        . 'ON CONFLICT(name) DO UPDATE SET content = excluded.content, updated_at = excluded.updated_at',

+        undef,

+        $name,

+        $content,

+        iso_now(),

+    );

+}

+

+sub normalize_registry_policy {

+    my ($registry) = @_;

+    $registry->{policy} ||= {};

+    $registry->{policy}{storage_authority} = 'sqlite';

+    $registry->{policy}{runtime_database} = $opt{db};

+}

+

+sub default_hosts_yaml {

+    return <<'YAML';

+version: 1

+updated_at: ""

+policy:

+  storage_authority: "sqlite"

+hosts:

+YAML

+}

+

+sub default_work_orders_yaml {

+    return <<'YAML';

+version: 1

+work_orders:

+YAML

+}

+

+sub ensure_parent_dir {

+    my ($path) = @_;

+    my $dir = dirname($path);

+    make_path($dir) unless -d $dir;

+}

+

+      if (!confirm('Write config/local-hosts.tsv from the runtime registry?')) return;