From f7793a836bf28e39bf44566fc349d4dd5800e502 Mon Sep 17 00:00:00 2001
From: Forge <forge@hoblets.local>
Date: Tue, 22 Sep 2026 14:50:16 +0000
Subject: [PATCH] Record exact route assertions for semantic update
 measurements

---
 docs/validation/semantic-update-assert.cjs | 23 ++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 docs/validation/semantic-update-assert.cjs

diff --git a/docs/validation/semantic-update-assert.cjs b/docs/validation/semantic-update-assert.cjs
new file mode 100644
index 000000000..2fa3d9c58
--- /dev/null
+++ b/docs/validation/semantic-update-assert.cjs
@@ -0,0 +1,23 @@
+// Reproducible graph assertions layered onto semantic-update-sample.cjs.
+// Capture every committed fixture state, including the cold reference rebuild.
+const fs=require('node:fs'),path=require('node:path'),assert=require('node:assert/strict');
+const {DatabaseSync}=require('node:sqlite'),{channel}=require('node:diagnostics_channel');
+const project=path.resolve(process.argv[2]),output=process.argv[3]+'.assertions.json',rows=[];
+channel('codegraph.semantic.update').subscribe(e=>{
+ if(e.phase!=='committed'||path.resolve(e.projectRoot)!==project)return;
+ const db=new DatabaseSync(path.join(project,'.codegraph/codegraph.db'),{readOnly:true});
+ try{
+  const nodes=db.prepare("select id,name,kind,qualified_name from nodes where file_path in ('semantic_update_fixture.php','semantic_update_fixture.routing.yml')").all();
+  const route=nodes.find(n=>n.kind==='route'&&n.name==='/__semantic_update_fixture');
+  const file=path.join(project,'semantic_update_fixture.routing.yml');
+  if(fs.existsSync(file)){
+   const expected=/Handler[AB]/.exec(fs.readFileSync(file,'utf8'))[0];
+   const owner=nodes.find(n=>n.kind==='class'&&n.name===expected);assert.ok(owner,expected+' class');assert.ok(route,'literal fixture route');
+   const children=db.prepare("select target from edges where source=? and kind='contains'").all(owner.id).map(n=>n.target);
+   const handler=nodes.find(n=>n.name==='handle'&&children.includes(n.id));assert.ok(handler,'owned handler');
+   const links=db.prepare("select target from edges where source=? and json_extract(metadata,'$.label')='Drupal route handler'").all(route.id);
+   assert.deepEqual(links.map(n=>n.target),[handler.id]);rows.push({target:expected,route:route.id,handler:handler.id,passed:true});
+  }else{assert.equal(nodes.length,0);rows.push({removed:true,passed:true})}
+  fs.writeFileSync(output,JSON.stringify(rows,null,2));
+ }finally{db.close()}
+});