nodal-agents 0.9.0 → 0.9.2

package/migrations/0118_agent_jobs_deliverable_check_due.sql

@@ -0,0 +1,53 @@
+-- UN LIVRABLE DE CE RUN ATTEND LE REGARD DE LA PERSONNE (issue #255).
+--
+-- La décision 2 de #135 énumère quatre choses que la pastille d'attention
+-- compte. Trois avaient une colonne : une approbation en attente et une
+-- question posée (`approval_requests`), le non-lu (`conversation_reads`, 0112,
+-- exclu de la pastille le 19/09/2026 parce qu'il tombe à zéro en OUVRANT, pas
+-- en répondant). La quatrième — « un livrable à vérifier » — n'en avait
+-- aucune, et `apps/web/src/lib/chat-folders.ts` le disait en toutes lettres :
+-- « aucune colonne ne dit qu'un livrable attend un œil ».
+--
+-- Voici la colonne. L'instant où le run a livré ; NULL = rien n'attend.
+--
+-- CE QUI L'ÉCRIT, et à quel moment. La porte terminale de succès du runner
+-- (`finalizeJobSuccess`), dans la MÊME transaction que le statut terminal —
+-- au même endroit que `job_deliveries`, qui commet l'intention de livrer avec
+-- la décision de finir. Un crash entre les deux ne peut donc pas laisser un
+-- run livré dont rien ne dit qu'il attend un regard.
+--
+-- La condition est `addressed AND produced` sur
+-- `job_deliverable_verification_state`. Les deux, jamais l'une :
+--   `addressed` est posé AVANT l'exécution — une écriture ratée laisse
+--   l'intention en place, et compter là-dessus ferait attendre un regard sur
+--   un livrable que personne n'a produit ;
+--   `produced` seul compterait des livrables que l'écran ne montre pas (un
+--   périmètre marqué sale par précaution — vingt lignes dont `shared/_archive`,
+--   constaté le 08/09/2026).
+--
+-- SUR LE JOB DE TÊTE, jamais sur le délégué qui a produit. C'est le run que la
+-- personne ouvre, et sa page remonte déjà les livrables de toute sa
+-- descendance. La chaîne est remontée à l'écriture ; une chaîne cassée ne pose
+-- rien et le dit par un code (invariant #4), plutôt que de poser le fait sur un
+-- run choisi au hasard.
+--
+-- CE QUI L'EFFACE : le web, et lui seul, sur les deux gestes qui sont des
+-- regards — ouvrir le run (la page qui MONTRE les livrables) ou ouvrir le fil
+-- (au même endroit que le marqueur de lecture de 0112). Le runner n'efface
+-- jamais : une livraison partie sur Telegram n'a rien fait regarder à personne.
+--
+-- PAR ESPACE, pas par personne, au contraire de `conversation_reads`. C'est la
+-- règle de la pastille à laquelle ce fait s'ajoute : une approbation résolue
+-- par l'un tombe pour tous. Une colonne par personne ferait dire à la pastille
+-- deux choses à la fois.
+--
+-- NULLABLE ET SANS DÉFAUT : les runs déjà finis en base n'ont livré à personne
+-- et ne reçoivent pas un regard en attente inventé après coup.
+ALTER TABLE "agent_jobs" ADD COLUMN IF NOT EXISTS "deliverable_check_due_at" timestamptz;
+
+-- La pastille relit « ce qui attend dans cet espace » toutes les 15 secondes,
+-- sur toutes les pages du tableau de bord. PARTIEL : la colonne est NULL sur
+-- presque tous les jobs, et elle le redevient dès que la personne a regardé.
+CREATE INDEX IF NOT EXISTS "idx_agent_jobs_deliverable_check_due"
+  ON "agent_jobs" ("entity_id")
+  WHERE "deliverable_check_due_at" IS NOT NULL;

package/migrations/0119_job_checkpoints_snapshot_ms.sql

@@ -0,0 +1,51 @@
+-- COMBIEN DE TEMPS LE FILET A MIS À PHOTOGRAPHIER (issue #261).
+--
+-- Le filet sous les écritures photographie chaque dossier avant le premier
+-- outil mutant d'un tour, et `git add` y est borné à 30 secondes. Le soir du
+-- 19/09/2026, un dossier partagé monté à 3,3 Go a dépassé cette borne : les
+-- agents se sont vu refuser toute écriture, et ils ont cherché une panne du
+-- dossier pendant des heures. L'issue #245 a fait dire au refus sa cause et
+-- ses chiffres. Celle-ci fait voir la montée AVANT le refus.
+--
+-- Pour cela il faut une durée, et la durée n'existait NULLE PART : elle ne
+-- vivait que sur le chemin d'ÉCHEC, en mémoire, le temps de rendre la phrase
+-- du refus (`elapsedMs` de packages/checkpoints/src/failure.ts). Une photo qui
+-- RÉUSSIT en 24 secondes ne laissait aucune trace — c'est-à-dire exactement le
+-- cas qu'il faut voir venir.
+--
+-- Voici la colonne : les millisecondes qu'a pris la photo qui a produit CETTE
+-- ligne. Sur `job_checkpoints` et pas ailleurs, parce que c'est la seule table
+-- qui relie une photo à un dossier, un travail et un tour — l'écran n'a plus
+-- qu'à lire la plus récente d'un dossier.
+--
+-- MESURÉE, jamais estimée : l'horloge est prise autour du seul appel de
+-- `snapshot`, aux deux endroits qui photographient (le seam de
+-- `packages/tools` et le harnais CLI du runner).
+--
+-- NULLABLE ET SANS DÉFAUT : les lignes déjà en base n'ont pas été chronométrées
+-- et ne recevront pas une durée inventée. NULL veut dire « pas mesurée », et
+-- l'écran le DIT plutôt que d'afficher un zéro qui se lirait « instantané »
+-- (invariant #4).
+--
+-- Pas de contrainte de borne supérieure : une photo peut légitimement durer
+-- plus longtemps que le budget de `git add`, puisque la durée couvre aussi ce
+-- que `snapshot` fait autour. Une borne inventée refuserait la ligne au moment
+-- précis où sa valeur est la plus intéressante.
+ALTER TABLE "job_checkpoints" ADD COLUMN IF NOT EXISTS "snapshot_ms" integer;
+
+ALTER TABLE "job_checkpoints" DROP CONSTRAINT IF EXISTS "job_checkpoints_snapshot_ms_check";
+
+ALTER TABLE "job_checkpoints" ADD CONSTRAINT "job_checkpoints_snapshot_ms_check"
+  CHECK ("snapshot_ms" IS NULL OR "snapshot_ms" >= 0);
+
+-- L'ÉCRAN DEMANDE « LA DERNIÈRE PHOTO DE CET ESPACE », et rien d'autre : un
+-- `ORDER BY taken_at DESC LIMIT 1` par espace, joint sur le job.
+--
+-- Sans cet index, le planificateur n'a le choix qu'entre trier toutes les
+-- photos de l'entité et parcourir la table à l'envers en sondant `agent_jobs`.
+-- Le second dégénère précisément pour un espace SILENCIEUX — celui dont la
+-- dernière photo est la plus ancienne, donc la plus loin dans le parcours
+-- (revue C, passe 2). C'est le cas que l'écran doit servir vite, puisque c'est
+-- celui qu'on n'ouvre que pour voir s'il a grossi.
+CREATE INDEX IF NOT EXISTS "idx_job_checkpoints_taken_at"
+  ON "job_checkpoints" ("taken_at" DESC);

package/migrations/0120_excluded_project_paths.sql

@@ -0,0 +1,38 @@
+-- LES DOSSIERS ÉCARTÉS D'UN ESPACE (issue #385).
+--
+-- #371 a donné « Forget » : la ligne `code_projects` d'un projet masqué quitte
+-- la base, l'historique des runs et des conversations reste, le dossier n'est
+-- pas touché. Mais la page Projects ne liste pas que le registre : elle liste
+-- aussi les dossiers DÉDUITS des écritures passées des agents. Un projet oublié
+-- dont le dossier portait de telles écritures revenait donc dans la liste,
+-- marqué « Detected », avec Register et Hide offerts de nouveau. Oublier ne
+-- tenait pas.
+--
+-- On ne peut pas régler cela dans `code_projects` : une ligne qui y resterait
+-- pour dire « ce dossier est écarté » serait exactement la ligne de masquage
+-- que « Forget » vient de supprimer, et le mot « oublier » redeviendrait un
+-- synonyme de « masquer ».
+--
+-- D'où cette table, qui porte UN fait et un seul : quelqu'un a écarté ce
+-- dossier de cet espace, à cette date. La détection le saute, et « Detect
+-- again » supprime la ligne.
+--
+-- L'UNICITÉ EST SUR LA CLÉ, pas sur le chemin : `project_key` est la même
+-- identité canonique que le registre porte depuis 0088. Sous Windows, le même
+-- dossier remonte avec des casses différentes selon la session ; une unicité
+-- sur `project_path` laisserait deux exclusions du même dossier coexister, et
+-- la détection n'en lirait qu'une. `project_path` reste à côté pour l'écran.
+CREATE TABLE IF NOT EXISTS "excluded_project_paths" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "entity_id" uuid NOT NULL REFERENCES "entities"("id") ON DELETE CASCADE,
+  "project_path" text NOT NULL,
+  "project_key" text NOT NULL,
+  "created_at" timestamptz NOT NULL DEFAULT now(),
+  CONSTRAINT "excluded_project_paths_entity_key_unique" UNIQUE ("entity_id", "project_key")
+);
+
+-- L'écran demande TOUS les dossiers écartés d'un espace, à chaque rendu de la
+-- page Projects — jamais un chemin précis. C'est cette lecture-là qui est
+-- indexée.
+CREATE INDEX IF NOT EXISTS "idx_excluded_project_paths_entity"
+  ON "excluded_project_paths" ("entity_id");

package/migrations/0121_entities_proof_repair_attempts.sql

@@ -0,0 +1,32 @@
+-- COMBIEN DE TOURS DE RÉPARATION UN RUN REÇOIT (issue #377).
+--
+-- #375 a donné au runner UN tour de réparation après une preuve rouge : le job
+-- ne finit pas, l'agent reçoit la commande qui a échoué et sa sortie, il
+-- corrige et relivre. La borne était écrite en dur dans `finalize.ts`.
+--
+-- Quentin, 21/09 : « il faut exposer ces réglages quelque part ». La borne
+-- devient donc un réglage de l'espace, à côté du frein d'auto-exécution et des
+-- surfaces sous vérification.
+--
+-- LE DÉFAUT EST 1, c'est-à-dire exactement ce que #375 fait aujourd'hui : une
+-- migration ne change le comportement de personne. `0` rend le comportement
+-- d'avant #375 (le run finit rouge tout de suite), et c'est une valeur
+-- légitime : un espace qui préfère voir l'échec plutôt que de payer un tour de
+-- modèle de plus la choisit.
+--
+-- LE CHECK EST ICI, pas seulement dans le formulaire. Cette colonne borne une
+-- boucle du runner (invariant #8, anti-loop) : une valeur de 9 999 écrite par
+-- un script ou une main sur `psql` ferait tourner un agent toute la nuit sur
+-- une preuve qui ne passera jamais. Trois est le plafond : au-delà, ce n'est
+-- plus une réparation, c'est un agent qui devine.
+ALTER TABLE "entities"
+  ADD COLUMN IF NOT EXISTS "proof_repair_attempts" integer NOT NULL DEFAULT 1;
+
+DO $$
+BEGIN
+  ALTER TABLE "entities"
+    ADD CONSTRAINT "entities_proof_repair_attempts_check"
+    CHECK ("proof_repair_attempts" >= 0 AND "proof_repair_attempts" <= 3);
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;

package/migrations/0122_entities_drop_memory_curation_enabled.sql

@@ -0,0 +1,17 @@
+-- LA COLONNE QUE PERSONNE NE POUVAIT ATTEINDRE (issue #411).
+--
+-- `memory_curation_enabled` est née avec la 0.7.0 (migration 0052) pour
+-- découpler la curation de la mémoire de `reflection_enabled`, qui gardait la
+-- boucle d'apprentissage des skills éteinte. Le runner la lisait à chaque
+-- passage ; aucun écran ne l'a jamais montrée ni changée. Un réglage qu'on ne
+-- peut poser qu'en SQL n'est pas un réglage, c'est une colonne.
+--
+-- Décision de Quentin, 22/09 : la supprimer. Ce qui reste dit « ne touche pas
+-- à ça » est le geste que le produit propose déjà : l'épingle sur le fait
+-- (`agent_memory.importance_locked`), que le curateur respecte, et le
+-- coupe-circuit global `MEMORY_CURATION_ENABLED=false` côté runner.
+--
+-- Cette migration ne touche PAS `agent_memory` : aucun fait, aucune
+-- importance, aucune archive ne bouge. Seule la ligne de l'espace perd un
+-- booléen que rien ne lisait hors du cron.
+ALTER TABLE "entities" DROP COLUMN IF EXISTS "memory_curation_enabled";

package/migrations/meta/_journal.json

@@ -820,6 +820,41 @@
       "when": 1786001100000,
       "tag": "0117_agent_jobs_result_kind",
       "breakpoints": true
+    },
+    {
+      "idx": 118,
+      "version": "7",
+      "when": 1786001160000,
+      "tag": "0118_agent_jobs_deliverable_check_due",
+      "breakpoints": true
+    },
+    {
+      "idx": 119,
+      "version": "7",
+      "when": 1786001220000,
+      "tag": "0119_job_checkpoints_snapshot_ms",
+      "breakpoints": true
+    },
+    {
+      "idx": 120,
+      "version": "7",
+      "when": 1786001280000,
+      "tag": "0120_excluded_project_paths",
+      "breakpoints": true
+    },
+    {
+      "idx": 121,
+      "version": "7",
+      "when": 1786001340000,
+      "tag": "0121_entities_proof_repair_attempts",
+      "breakpoints": true
+    },
+    {
+      "idx": 122,
+      "version": "7",
+      "when": 1786001400000,
+      "tag": "0122_entities_drop_memory_curation_enabled",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodal-agents",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Local-first AI agent platform with a web dashboard — install in one command.",
   "license": "MIT",
   "repository": {
@@ -20,6 +20,7 @@
     "runner.js",
     "web/**",
     "migrations/**",
+    "docs-index.json",
     "README.md"
   ],
   "dependencies": {