arcane-os 0.5.12 → 0.5.14

package/runtime/arcane/modules/CommunicationAppController.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import ArcaneCommunicationBridge from './ArcaneCommunicationBridge.js';
 import CommunicationHub from './CommunicationHub.js?v=2';
 import CommunicationPreferences from './CommunicationPreferences.js';
@@ -360,7 +361,7 @@ export default class CommunicationAppController{
                 hub.dispose();
             }
         }catch(error){
-            console.error('The communication hub could not be disposed cleanly.',error);
+            arcaneLogging.error('The communication hub could not be disposed cleanly.',error);
         }
     }
 

package/runtime/arcane/modules/ComponentContracts.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {
     createArcaneEventSource,
     projectArcaneDOMEvent
@@ -713,7 +714,7 @@ function createSTTActivationController({
                 try{
                     onChange();
                 }catch(error){
-                    console.error('Unable to render STT activation state:',error);
+                    arcaneLogging.error('Unable to render STT activation state:',error);
                 }
             }
         }
@@ -724,7 +725,7 @@ function createSTTActivationController({
         if(nextAction){
             void request(nextAction).catch(
                 function reportSTTActivationRequestFailure(error){
-                    console.error('The STT activation request could not settle.',error);
+                    arcaneLogging.error('The STT activation request could not settle.',error);
                 }
             );
         }

package/runtime/arcane/modules/ConversationTimebox.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 
 const CONVERSATION_TIMEBOX_TOOL_NAME='conversation_timebox';
@@ -168,7 +169,7 @@ function conversationTimeboxSubmissionKey(context={}){
 }
 
 function reportConversationTimeboxListenerError(error){
-    console.error('A conversation timebox listener failed.',error);
+    arcaneLogging.error('A conversation timebox listener failed.',error);
 }
 
 function conversationTimeboxError(message,code,reason,ErrorType=Error){

package/runtime/arcane/modules/DBOPFS.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import Is from "../../node_modules/strong-type/index.js";
 import {openApplicationDataDirectory} from './AppDataScope.js';
 import {
@@ -458,7 +459,7 @@ class DBOPFS {
                         );
                     }
                 }catch(error){
-                    console.error(`Error writing file '${fileName}' to table '${tableName}':`,error)
+                    arcaneLogging.error(`Error writing file '${fileName}' to table '${tableName}':`,error)
                     throw error
                 }
 
@@ -603,7 +604,7 @@ class DBOPFS {
                 const fileName=entries[index][0]
 
                 if(result.status!=='fulfilled'){
-                    console.error(`Failed to set file '${fileName}':`,result.reason)
+                    arcaneLogging.error(`Failed to set file '${fileName}':`,result.reason)
                 }
             }
         );
@@ -742,7 +743,7 @@ class DBOPFS {
             await table.removeEntry(fileName)
         }catch(error){
             if(error.name!=='NotFoundError'){
-                console.error(error)
+                arcaneLogging.error(error)
                 throw error
             }
         }
@@ -784,7 +785,7 @@ class DBOPFS {
             delete this.#tables[tableName]
             delete this.#tableHandles[tableName]
         }catch(error){
-            console.error(error)
+            arcaneLogging.error(error)
         }
 
         return true

package/runtime/arcane/modules/Errors.js

@@ -1,4 +1,5 @@
 import waitForComponent from './WaitForComponent.js';
+import { arcaneLogging,readArcaneDeveloperMode } from 'arcane-os/logging';
 import {
     arcaneEvents,
     createArcaneEventSource
@@ -154,18 +155,6 @@ async function sendWithWindowMail(target,...args){
     return target.mail.send(...args);
 }
 
-function defaultDeveloperModeStatus(target){
-    try{
-        if(target?.user?.ready!==true){
-            return null;
-        }
-
-        return target.user.developer===true;
-    }catch{
-        return false;
-    }
-}
-
 function appendDeveloperDetail(document,list,label,value){
     if(value===null||value===undefined||value===''){
         return;
@@ -340,7 +329,7 @@ class Errors {
         this.now=options.now||Date.now;
         this.schedule=options.schedule||globalThis.setTimeout.bind(globalThis);
         this.cancel=options.cancel||globalThis.clearTimeout.bind(globalThis);
-        this.logger=options.logger||globalThis.console;
+        this.logger=options.logger||arcaneLogging;
         this.storage=options.storage===undefined
             ? defaultStorage(target)
             : options.storage;
@@ -352,7 +341,7 @@ class Errors {
             || sendWithWindowMail.bind(null,target);
         this.isDeveloperMode=typeof options.isDeveloperMode==='function'
             ? options.isDeveloperMode
-            : defaultDeveloperModeStatus.bind(null,target);
+            : readArcaneDeveloperMode.bind(null,target);
         this.presentDeveloperIncident=typeof options.presentDeveloperIncident==='function'
             ? options.presentDeveloperIncident
             : presentDeveloperIncidentModal.bind(null,target);

package/runtime/arcane/modules/HTMLImport.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {
   createArcaneEventSource,
   projectArcaneDOMEvent
@@ -12,6 +13,44 @@ globalThis[htmlImportHostRegistryKey]=htmlImportHostRegistry;
 
 let htmlImportScriptId=0;
 
+const htmlImportModuleURL=new URL(import.meta.url);
+const htmlImportAssetVersion=htmlImportModuleURL.searchParams.get('arcaneVersion');
+
+function versionComponentResource(value,baseHref){
+  if(!htmlImportAssetVersion||typeof value!=='string'||!value||value.startsWith('#')){
+    return value;
+  }
+  let resolvedURL;
+  try{
+    resolvedURL=new URL(value,baseHref);
+  }catch{
+    return value;
+  }
+  if(resolvedURL.protocol!==htmlImportModuleURL.protocol
+    ||resolvedURL.origin!==htmlImportModuleURL.origin){
+    return value;
+  }
+
+  const fragmentIndex=value.indexOf('#');
+  const fragment=fragmentIndex<0?'':value.slice(fragmentIndex);
+  const resource=fragmentIndex<0?value:value.slice(0,fragmentIndex);
+  const queryIndex=resource.indexOf('?');
+  const pathname=queryIndex<0?resource:resource.slice(0,queryIndex);
+  const query=queryIndex<0?'':resource.slice(queryIndex+1);
+  const versionField=`arcaneVersion=${encodeURIComponent(htmlImportAssetVersion)}`;
+  let replaced=false;
+  const fields=query?query.split('&').map(function versionQueryField(field){
+    if(!new URLSearchParams(field).has('arcaneVersion'))return field;
+    if(replaced)return null;
+    replaced=true;
+    return versionField;
+  }).filter(function retainQueryField(field){
+    return field!==null;
+  }):[];
+  if(!replaced)fields.push(versionField);
+  return `${pathname}?${fields.join('&')}${fragment}`;
+}
+
 function componentRuntimeRoot(resolvedHref){
   const componentURL=new URL(resolvedHref);
   const componentMarker='/arcane/components/';
@@ -32,28 +71,157 @@ function resolveComponentResource(value,runtimeRoot){
 }
 
 function resolveComponentStyleResources(styleText,runtimeRoot){
-  if(!runtimeRoot)return styleText;
-  return styleText.replace(
-    /url\(\s*(['"]?)\.\/arcane\/([^)'"\s]+)\1\s*\)/gu,
-    function resolveStyleURL(_match,quote,resourcePath){
-      const resolved=new URL(resourcePath,runtimeRoot).href;
-      return `url(${quote}${resolved}${quote})`;
+  if(!runtimeRoot&&!htmlImportAssetVersion)return styleText;
+  const parts=[];
+  let copiedThrough=0;
+  let index=0;
+
+  function afterComment(start){
+    const end=styleText.indexOf('*/',start+2);
+    return end<0?styleText.length:end+2;
+  }
+
+  function afterEscape(start){
+    let end=start+1;
+    if(/[\da-f]/iu.test(styleText[end]||'')){
+      const limit=end+6;
+      while(end<limit&&/[\da-f]/iu.test(styleText[end]||''))end+=1;
+      if(/[\t\n\f\r ]/u.test(styleText[end]||'')){
+        end+=styleText[end]==='\r'&&styleText[end+1]==='\n'?2:1;
+      }
+      return end;
     }
-  );
+    return end+(styleText[end]==='\r'&&styleText[end+1]==='\n'?2:1);
+  }
+
+  function afterString(start){
+    const quote=styleText[start];
+    let end=start+1;
+    while(end<styleText.length){
+      if(styleText[end]==='\\'){
+        end=afterEscape(end);
+      }else if(styleText[end]===quote){
+        return end+1;
+      }else if(/[\n\r\f]/u.test(styleText[end])){
+        return end;
+      }else{
+        end+=1;
+      }
+    }
+    return styleText.length;
+  }
+
+  function afterWhitespaceAndComments(start){
+    let end=start;
+    while(end<styleText.length){
+      if(/[\t\n\f\r ]/u.test(styleText[end])){
+        end+=1;
+      }else if(styleText.startsWith('/*',end)){
+        end=afterComment(end);
+      }else{
+        break;
+      }
+    }
+    return end;
+  }
+
+  function appendResource(start,end){
+    const resourcePath=styleText.slice(start,end);
+    // CSS escapes retain their original spelling until their URL syntax is decoded.
+    if(resourcePath.includes('\\'))return;
+    const resolved=versionComponentResource(
+      resolveComponentResource(resourcePath,runtimeRoot),
+      document.baseURI
+    );
+    if(resolved===resourcePath)return;
+    parts.push(styleText.slice(copiedThrough,start),resolved);
+    copiedThrough=end;
+  }
+
+  while(index<styleText.length){
+    if(styleText.startsWith('/*',index)){
+      index=afterComment(index);
+      continue;
+    }
+    if(styleText[index]==='"'||styleText[index]==="'"){
+      index=afterString(index);
+      continue;
+    }
+
+    const atRule=styleText[index]==='@';
+    const hashToken=styleText[index]==='#';
+    const nameStart=atRule||hashToken?index+1:index;
+    let nameEnd=nameStart;
+    while(nameEnd<styleText.length&&/[-\w\u0080-\uFFFF\\]/u.test(styleText[nameEnd])){
+      nameEnd=styleText[nameEnd]==='\\'?afterEscape(nameEnd):nameEnd+1;
+    }
+    if(nameEnd===nameStart){
+      index+=1;
+      continue;
+    }
+    const name=styleText.slice(nameStart,nameEnd).toLowerCase();
+    index=nameEnd;
+    if(hashToken)continue;
+    if(atRule&&name==='import'){
+      const start=afterWhitespaceAndComments(nameEnd);
+      if(styleText[start]==='"'||styleText[start]==="'"){
+        const end=afterString(start);
+        if(styleText[end-1]===styleText[start])appendResource(start+1,end-1);
+        index=end;
+      }
+      continue;
+    }
+    if(atRule||name!=='url'||styleText[nameEnd]!=='(')continue;
+
+    let start=nameEnd+1;
+    while(start<styleText.length&&/[\t\n\f\r ]/u.test(styleText[start]))start+=1;
+    if(styleText[start]==='"'||styleText[start]==="'"){
+      const end=afterString(start);
+      const close=afterWhitespaceAndComments(end);
+      if(styleText[end-1]===styleText[start]&&styleText[close]===')'){
+        appendResource(start+1,end-1);
+        index=close+1;
+      }else{
+        index=end;
+      }
+      continue;
+    }
+
+    let end=start;
+    while(end<styleText.length&&!/[\t\n\f\r )'"(]/u.test(styleText[end])){
+      end=styleText[end]==='\\'?afterEscape(end):end+1;
+    }
+    let close=end;
+    while(close<styleText.length&&/[\t\n\f\r ]/u.test(styleText[close]))close+=1;
+    if(styleText[close]===')'){
+      appendResource(start,end);
+      index=close+1;
+    }else{
+      index=end;
+    }
+  }
+  if(parts.length===0)return styleText;
+  parts.push(styleText.slice(copiedThrough));
+  return parts.join('');
 }
 
 function createComponentFragment(html,resolvedHref){
   const template=document.createElement('template');
   template.innerHTML=html;
   const runtimeRoot=componentRuntimeRoot(resolvedHref);
-  if(!runtimeRoot)return template.content;
 
   for(const element of template.content.querySelectorAll('[href],[src]')){
     for(const attribute of ['href','src']){
       if(!element.hasAttribute(attribute))continue;
       const value=element.getAttribute(attribute);
       const resolved=resolveComponentResource(value,runtimeRoot);
-      if(resolved!==value)element.setAttribute(attribute,resolved);
+      const navigation=attribute==='href'
+        &&['a','area','base'].includes(element.localName);
+      const versioned=navigation?resolved:versionComponentResource(
+        resolved,
+        element.localName==='script'?resolvedHref:document.baseURI
+      );
+      if(versioned!==value)element.setAttribute(attribute,versioned);
     }
   }
   for(const style of template.content.querySelectorAll('style')){
@@ -69,7 +237,8 @@ function resolveRelativeDynamicImports(source,baseHref){
   return source.replace(
     /\bimport\s*\(\s*(['"])(\.{1,2}\/[^'"]+)\1\s*\)/gu,
     function resolveDynamicImport(_match,_quote,specifier){
-      return `import(${JSON.stringify(new URL(specifier,baseHref).href)})`;
+      const resolved=versionComponentResource(new URL(specifier,baseHref).href,baseHref);
+      return `import(${JSON.stringify(resolved)})`;
     }
   );
 }
@@ -131,15 +300,15 @@ class HTMLImport extends HTMLElement {
     let resolvedHref='';
     const operationId=`html-import-load-${this.#events.instanceId}-${generation}`;
     if(!href){
-      console.log('no href provided for html-import tag',this);
+      arcaneLogging.log('no href provided for html-import tag',this);
       this.#loadController=null;
       return;
     }
 
     try{
       const resolvedURL=new URL(href,document.baseURI);
-      resolvedHref=resolvedURL.href;
-      const response=await fetch(resolvedURL.href,{
+      resolvedHref=versionComponentResource(resolvedURL.href,document.baseURI);
+      const response=await fetch(resolvedHref,{
         cache:'default',
         method:'GET',
         signal:controller.signal
@@ -151,7 +320,7 @@ class HTMLImport extends HTMLElement {
         await this.#destroyImportedHost();
         return;
       }
-      console.error('Error loading HTML component:',err);
+      arcaneLogging.error('Error loading HTML component:',err);
       const detail={
           code:'HTML_IMPORT_FAILED',
           href,
@@ -201,7 +370,7 @@ class HTMLImport extends HTMLElement {
   }
 
   #reportImportedDestroyError(error,{events,href,operationId}){
-    console.error('Error destroying imported HTML component:',error);
+    arcaneLogging.error('Error destroying imported HTML component:',error);
     if(!events||events.disposed)return;
     const detail={
       code:'HTML_IMPORT_IMPORTED_COMPONENT_DESTROY_REJECTED',
@@ -308,7 +477,10 @@ class HTMLImport extends HTMLElement {
         let sourceBaseHref=contentBaseHref;
         const scriptSource=script.getAttribute('src');
         if(scriptSource!==null){
-          const requestedScriptHref=new URL(scriptSource,contentBaseHref).href;
+          const requestedScriptHref=versionComponentResource(
+            new URL(scriptSource,contentBaseHref).href,
+            contentBaseHref
+          );
           const response=await fetch(requestedScriptHref,{
             cache:'default',
             method:'GET',

package/runtime/arcane/modules/LocalAIReadinessController.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {
     checkLocalAIReadiness,
     deriveLocalAIRequirements
@@ -287,7 +288,7 @@ export function createLocalAIReadinessController({
     function retry(){
         void check().catch(function ignoreDestroyedLocalAIRetry(error){
             if(error?.name!=='AbortError'){
-                console.error('Local AI readiness retry failed.',error);
+                arcaneLogging.error('Local AI readiness retry failed.',error);
             }
         });
     }

package/runtime/arcane/modules/MD.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import { marked } from './Marked.min.js';
 import Is from '../../node_modules/strong-type/index.js';
 
@@ -45,7 +46,7 @@ class MD {
 
     set raw(value=''){
         if(!is.string(value)){
-            console.trace('MD.raw must be a string.');
+            arcaneLogging.trace('MD.raw must be a string.');
             return this.#raw;
         }
         this.#raw = value;
@@ -55,7 +56,7 @@ class MD {
 
     append(value=''){
         if(!is.string(value)){
-            console.trace('MD.append must be a string.');
+            arcaneLogging.trace('MD.append must be a string.');
             return this.#raw;
         }
         this.#raw += value;

package/runtime/arcane/modules/MailOutbox.mjs

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 export const MAIL_OUTBOX_PROTOCOL='arcane-mail-outbox/1';
 export const MAIL_OUTBOX_TABLE='mail_outbox';
 export const MAIL_OUTBOX_IDEMPOTENCY_WINDOW_MS=24*60*60*1000;
@@ -34,7 +35,7 @@ function reportMailOutboxObserverError(error){
             return;
         }
     }catch{}
-    try{globalThis.console?.error?.(error);}catch{}
+    try{arcaneLogging.error?.(error);}catch{}
 }
 
 function fail(message,code='MAIL_OUTBOX_INVALID',ErrorType=Error,cause){

package/runtime/arcane/modules/PersistentAIChatSession.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import ChatEntity from '../entities/Chat.js';
 import ConfiguredAIChatSession,{
     normalizeStructuralToolCall
@@ -475,7 +476,7 @@ class PersistentAIChatSession{
                 error instanceof Error?error:new Error('The saved chat history is invalid.'),
                 'AI_CHAT_INCOHERENT_PERSISTENCE',
             );
-            console.error('Arcane saved chat history is readable but not actionable.',error);
+            arcaneLogging.error('Arcane saved chat history is readable but not actionable.',error);
         }
         const storedSystem=storedMessages.find(message=>message.role==='system');
         const initialMessages=storedMessages

package/runtime/arcane/modules/ScreenCapture.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 import GifEncoder from './GifEncoder.js';
 
@@ -252,7 +253,7 @@ function supportedRecorderType(Recorder){
 
 function reportDetachedError(error){
     if(typeof globalThis.reportError==='function')globalThis.reportError(error);
-    else globalThis.console?.error?.(error);
+    else arcaneLogging.error?.(error);
 }
 
 function monotonicNow(){

package/runtime/arcane/modules/ThemeBootstrap.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {loadAndApplyTheme} from './ThemeManager.js';
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 
@@ -43,7 +44,7 @@ function installAppearanceListener(ready){
             Promise.resolve(ready).then(function reloadTheme(result){
                 return result?.manager?.load?.();
             }).catch(function reportThemeReloadFailure(error){
-                console.warn(
+                arcaneLogging.warn(
                     '[Arcane theme] Unable to apply the changed host appearance.',
                     error
                 );
@@ -80,7 +81,7 @@ export function bootstrapArcaneTheme(options={}){
     }
 
     const ready=loadAndApplyTheme(options).catch(error=>{
-        console.warn('[Arcane theme] Unable to load the saved appearance; using the system theme.',error);
+        arcaneLogging.warn('[Arcane theme] Unable to load the saved appearance; using the system theme.',error);
         return {manager:null,state:null,error};
     });
 

package/runtime/arcane/modules/ToolCallRouter.js

@@ -1,10 +1,11 @@
+import { arcaneLogging } from 'arcane-os/logging';
 function parseArguments(value,name=''){
     let parsed=value;
     if(typeof parsed==='string'){
         try{
             parsed=JSON.parse(parsed);
         }catch(error){
-            console.warn(error);
+            arcaneLogging.warn(error);
             throw new Error(`Tool ${name} returned invalid JSON arguments.`);
         }
     }

package/src/dev-server.mjs

@@ -1,14 +1,19 @@
 import {constants as FS_CONSTANTS} from 'node:fs';
-import {lstat,open,realpath} from 'node:fs/promises';
+import {lstat,open,readFile,realpath} from 'node:fs/promises';
 import http from 'node:http';
 import path from 'node:path';
 import {resolveWorkspace} from './workspace.mjs';
 import {createEventQueue} from './event-queue.mjs';
+import {
+    inspectImportMapHtml,MANAGED_IMPORT_MAP_ATTRIBUTE,
+    readWorkspaceAssetVersion,rewriteAssetReferences
+} from './import-map.mjs';
 
 const MIME_TYPES=new Map([
     ['.css','text/css; charset=utf-8'],
     ['.gif','image/gif'],
     ['.html','text/html; charset=utf-8'],
+    ['.htm','text/html; charset=utf-8'],
     ['.ico','image/x-icon'],
     ['.jpeg','image/jpeg'],
     ['.jpg','image/jpeg'],
@@ -308,11 +313,21 @@ async function openSafeFile(root,segments){
     }
 }
 
-async function sendFile(response,opened,{head=false}={}){
+async function sendFile(response,opened,{head=false,assetVersion,revalidate=false,onReference}={}){
     const extension=path.extname(opened.candidate).toLowerCase();
+    const content=assetVersion&&/\.(?:m?js|html?|css)$/iu.test(extension)
+        ?Buffer.from(rewriteAssetReferences(opened.content.toString('utf8'),{
+            filePath:opened.candidate,
+            version:assetVersion,
+            onReference
+        }),'utf8')
+        :opened.content;
+    // Entry documents must discover the current generated graph on navigation.
+    // no-cache permits storage and revalidation; ordinary asset caching is unchanged.
     response.writeHead(200,{
         'content-type':MIME_TYPES.get(extension)||'application/octet-stream',
-        'content-length':opened.content.byteLength
+        'content-length':content.byteLength,
+        ...(revalidate?{'cache-control':'no-cache'}:{})
     });
     await new Promise((resolve,reject)=>{
         let settled=false;
@@ -336,7 +351,7 @@ async function sendFile(response,opened,{head=false}={}){
         response.once('error',failed);
         response.once('finish',completed);
         response.once('close',completed);
-        response.end(head?undefined:opened.content);
+        response.end(head?undefined:content);
     });
 }
 
@@ -509,11 +524,23 @@ async function startOwnedDevServer({
         })
         :await packagedRoutes(releaseRoot);
     const mappings=deterministicMappings(routeSet.mappings);
+    async function selectedAssetVersion(){
+        if(mode!=='source')return undefined;
+        return sdkRuntimeSourceRoot===undefined
+            ?readWorkspaceAssetVersion(routeSet.workspaceRoot)
+            :JSON.parse(await readFile(
+                path.join(routeSet.runtime.sourceRoot,'package.json'),'utf8'
+            )).version;
+    }
+    let assetVersion=await selectedAssetVersion();
     for(const mapping of mappings){
         const info=await lstat(mapping.root);
         if(info.isSymbolicLink()||!info.isDirectory())fail(`Server route root must be a real directory: ${mapping.root}.`);
         mapping.root=await realpath(mapping.root);
     }
+    // Remember actual resource edges as their owners are served, not every
+    // HTML/JS/CSS file in an application's document or attachment corpus.
+    const resourcePaths=new Set([routeSet.startPath]);
     const requestTasks=new Set();
     const runFileWork=createFileWorkLimiter();
     const server=http.createServer((request,response)=>{
@@ -541,7 +568,47 @@ async function startOwnedDevServer({
             await runFileWork(async()=>{
                 const opened=await openSafeFile(mapping.root,relative);
                 if(!opened){deny(response,404,'Not found.');return;}
-                await sendFile(response,opened,{head:request.method==='HEAD'});
+                const extension=path.extname(opened.candidate).toLowerCase();
+                const html=extension==='.html'||extension==='.htm';
+                let managedDocument=false;
+                if(html&&opened.content.includes(MANAGED_IMPORT_MAP_ATTRIBUTE)){
+                    try{
+                        managedDocument=inspectImportMapHtml(
+                            opened.content.toString('utf8')
+                        ).managedMaps.length>0;
+                    }catch{
+                        // An unrelated document is not a source validation surface.
+                    }
+                }
+                const entryDocument=target.path===routeSet.startPath||managedDocument;
+                const managedMap=path.basename(opened.candidate)==='arcane.importmap.json';
+                // A live server can span an SDK upgrade. Refresh the small
+                // version record on navigation, not on each resource request.
+                if(entryDocument||managedMap)assetVersion=await selectedAssetVersion();
+                const runtimeResource=segments[0]==='arcane';
+                const browserResource=['script','style','worker','sharedworker','serviceworker']
+                    .includes(request.headers['sec-fetch-dest']);
+                const rewrite=runtimeResource||entryDocument||browserResource
+                    ||resourcePaths.has(target.path);
+                const onReference=({url,kind,baseHref,baseKind})=>{
+                    if(baseKind==='document'||kind==='fetch'||(kind==='asset'&&!/\.css(?:[?#]|$)/iu.test(url))
+                        ||(kind==='import'&&!/^(?:\.{1,2}\/|\/)/u.test(url)))return;
+                    try{
+                        const documentUrl=new URL(target.path,'http://arcane.invalid');
+                        const base=baseHref?new URL(baseHref,documentUrl):documentUrl;
+                        const resource=new URL(url,base);
+                        if(resource.origin===documentUrl.origin
+                            &&/\.(?:m?js|html?|css)$/iu.test(resource.pathname)){
+                            resourcePaths.add(decodeURIComponent(resource.pathname));
+                        }
+                    }catch{ /* Non-URL values remain under their existing owner. */ }
+                };
+                await sendFile(response,opened,{
+                    head:request.method==='HEAD',
+                    assetVersion:rewrite?assetVersion:undefined,
+                    revalidate:entryDocument||managedMap,
+                    onReference
+                });
             });
         })().catch(async error=>{
             await events.enqueue({type:'server.request.failed',message:error.message});