arcane-os 0.29.1 → 0.31.0

package/docs/reviews/mail-server-purpose-review.md

@@ -489,7 +489,7 @@ files. Their explicit precedence and credential compatibility rules are in the
 | CLI's early default host, port, and send/serve profile values | Y/Y/Y | Remove premature default assignment. The same defaults remain after file configuration resolves, while explicit CLI values retain priority. Assigning defaults before reading JSON would conceal the deployment's chosen settings. |
 | `origins` string array and list replacement | Y/Y/N | Keep one exact list for multiple caller domains. Explicit options replace the file list, including empty arrays. Existing `origin`, `allowTo`, `errorTo`, and `requestTimeout` aliases remain compatible and win over their canonical programmatic names when both are supplied. No normalization or list-merging helper is needed. |
 | Root provider-key, named-profile, and TLS compatibility | Y/Y/N | Preserve supported inputs using `RESEND_API_KEY`, `MAIL_PROFILES`, `MAIL_TLS_CERT_PATH`, and `MAIL_TLS_KEY_PATH`. Nested selected key presence takes priority even when null or empty. Named profiles never select a different account's default key. Named-profile deployment use is unverified; the retained behavior is a compatibility contract. |
-| Key set/status/delete operations | Y/Y/N | Preserve credential management and secret-free status. New keys use the nested member; existing legacy keys are updated in place unless a nested key exists. Delete removes both selected representations to prevent an old credential reappearing, preserving other keys, settings, and profile containers. Key commands still default to `mail` independently of the serving profile. |
+| Key set/status/delete operations | Y/Y/N | Preserve credential management and secret-free status. New keys use the nested member; existing root or profile keys are updated in place unless a nested key exists. Delete removes both selected representations to prevent an old credential reappearing, preserving other keys, settings, and profile containers. Key commands still default to `mail` independently of the serving profile. |
 | Send configuration | Y/Y/N | Use the same profile, sender, provider-timeout, and retry-guidance settings for direct sending. A send needs provider authority and its report, so listener certificates remain a serve-only prerequisite. Reports and idempotency keys remain per-operation inputs. |
 | Explicit runtime dependencies and callbacks | Y/Y/N | Preserve `readCredential`, provider injection, observation, cancellation, and subscription callbacks as programmatic inputs. A function or signal is not JSON configuration. The portable browser mail import retains its existing dependency boundary. |
 | Shared sender omission | Y/Y/N | Preserve per-report `from` and provider-template sender selection when no shared override is configured. One listener can therefore serve independent application sender identities. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.29.1",
+  "version": "0.31.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -38,6 +38,7 @@
     "./speech-text": "./browser-runtime/speech-text.mjs",
     "./ai/browser-wasm": "./browser-runtime/ai/browser-wasm.mjs",
     "./ai/tool-text-stream": "./browser-runtime/ai/tool-text-stream.mjs",
+    "./ai/twin-cloud": "./browser-runtime/ai/twin-cloud.mjs",
     "./ai/browser-speech": "./browser-runtime/ai/browser-speech.mjs",
     "./mail": "./src/mail-api.mjs",
     "./testing": "./src/testing.mjs",
@@ -85,7 +86,7 @@
     "test": "npm run test:unit && npm run test:functional && npm run test:integration && npm run test:regression",
     "test:release": "node ./bin/arcane-test.mjs test/npm-release.test.mjs",
     "test:unit": "node ./bin/arcane-test.mjs test/app-descriptor.test.mjs test/app-schema.test.mjs test/app-selection.test.mjs test/contracts.test.mjs test/doctor.test.mjs test/mail-credentials.test.mjs test/mail-outbox.test.mjs test/mail-public-api.test.mjs test/mail-send.test.mjs test/mail-transport.test.mjs test/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/cli.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/update-check.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/cli.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/twin-cloud.test.mjs test/update-check.test.mjs",
     "test:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.test.mjs test/root-app-layout.test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-plan.test.mjs test/native-provider-loader.test.mjs test/npm-release.test.mjs test/release-bundle.test.mjs test/release-capability-smoke.test.mjs test/shared-payload-batch.test.mjs test/tarball.test.mjs test/browser-wasm-cpu.test.mjs test/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/html-import-registration.test.mjs test/logging-regression.test.mjs test/markdown-speech.test.mjs test/prepared-speech.test.mjs test/native-provider-generation.test.mjs test/speech-queue-regression.test.mjs test/testing.test.mjs test/test-sets.test.mjs",
     "check": "node tools/check-source.mjs && npm test",

package/runtime/arcane/modules/AI.js

@@ -16,6 +16,14 @@ import {
 } from './AIProviderRuntime.js';
 import {normalizeOllamaModelIdentifier} from './OllamaModelIdentifier.js';
 import {arcaneLogging} from 'arcane-os/logging';
+import {
+    fetchHTTPResponse,
+    fetchJSONResponse,
+    isAIRequestAbort,
+    normalizeAIRequestAbort,
+    structuredOutputFormat as normalizeStructuredOutput,
+    openAIResponseFormat
+} from 'arcane-os/ai/twin-cloud';
 import {MarkdownSpeech,stripSpeechFormatting} from 'arcane-os/speech-text';
 import {prepareSpeech} from './PreparedSpeech.js';
 import {createToolTextObserver} from 'arcane-os/ai/tool-text-stream';
@@ -121,24 +129,6 @@ function aiInitializationError(code,reason,message){
     return error;
 }
 
-function isAIRequestAbort(error,signal){
-    return signal?.aborted
-        ||error?.name==='AbortError'
-        ||error?.code==='ARCANE_REQUEST_ABORTED'
-        ||error?.code==='ARCANE_AI_REQUEST_ABORTED'
-        ||error?.code==='AI_REQUEST_ABORTED';
-}
-
-function normalizeAIRequestAbort(error){
-    if(error?.code==='ARCANE_AI_REQUEST_ABORTED'){
-        return error;
-    }
-    const normalized=new Error('The AI request was cancelled.',{cause:error});
-    normalized.name='AbortError';
-    normalized.code='ARCANE_AI_REQUEST_ABORTED';
-    return normalized;
-}
-
 function normalizeAIReasoningEffort(value){
     if(value===undefined||value===null||value===''){
         return '';
@@ -3776,69 +3766,6 @@ class AI {
         return true;
     }
 
-    async #fetchHTTPResponse(url,options){
-        const {signal}=options;
-        const retryDelayMs=3000;
-        try{
-            while(true){
-                if(signal?.aborted){
-                    throw normalizeAIRequestAbort(signal.reason);
-                }
-                const response=await fetch(url,options);
-                if(signal?.aborted){
-                    throw normalizeAIRequestAbort(signal.reason);
-                }
-                if(response.ok){
-                    return response;
-                }
-
-                const contentType=response.headers.get('content-type')||'';
-                const error=contentType.includes('application/json')
-                    ?await response.json()
-                    :await response.text();
-                if(signal?.aborted){
-                    throw normalizeAIRequestAbort(signal.reason);
-                }
-                const message=is.string(error)
-                    ?error
-                    :error?.error?.message??error?.message;
-                if(
-                    response.status!==429
-                    ||!is.string(message)
-                    ||!message.toLowerCase().includes('overload')
-                ){
-                    throw error;
-                }
-
-                arcaneLogging.warn(
-                    `${message}\nRetrying in ${retryDelayMs / 1000} seconds`,
-                    error
-                );
-                await new Promise(function waitForOverloadRetry(resolve,reject){
-                    function finishRetryDelay(){
-                        signal?.removeEventListener('abort',cancelRetryDelay);
-                        resolve();
-                    }
-                    function cancelRetryDelay(){
-                        clearTimeout(timer);
-                        signal.removeEventListener('abort',cancelRetryDelay);
-                        reject(normalizeAIRequestAbort(signal.reason));
-                    }
-                    const timer=setTimeout(finishRetryDelay,retryDelayMs);
-                    signal?.addEventListener('abort',cancelRetryDelay,{once:true});
-                    if(signal?.aborted){
-                        cancelRetryDelay();
-                    }
-                });
-            }
-        }catch(error){
-            if(isAIRequestAbort(error,signal)){
-                throw normalizeAIRequestAbort(error);
-            }
-            throw error;
-        }
-    }
-
     #nativeOllama(){
         const client=globalThis.Arcane?.ollama;
 
@@ -4171,48 +4098,6 @@ class AI {
         ];
     }
 
-    #structuredOutputFormat(value=false){
-        if(value===false||value===null||value===undefined){
-            return null;
-        }
-        if(value===true||value==='json'){
-            return 'json';
-        }
-        if(
-            is.object(value)
-            &&!is.array(value)
-            &&(
-                Object.getPrototypeOf(value)===Object.prototype
-                ||Object.getPrototypeOf(value)===null
-            )
-        ){
-            return value;
-        }
-
-        const error=new TypeError(
-            'AI structured output must be enabled with true, json, or a JSON Schema object.'
-        );
-        error.code='AI_STRUCTURED_OUTPUT_INVALID';
-        throw error;
-    }
-
-    #openAIResponseFormat(structuredOutputFormat){
-        if(structuredOutputFormat==='json'){
-            return {type:'json_object'};
-        }
-        if(structuredOutputFormat){
-            return {
-                type:'json_schema',
-                json_schema:{
-                    name:'structured_response',
-                    strict:true,
-                    schema:structuredOutputFormat
-                }
-            };
-        }
-        return null;
-    }
-
     async #reportRequest(requestHandler,request,id,metadata){
         if(!is.function(requestHandler)){
             throw new TypeError('AI onRequest callback must be a function.');
@@ -4762,7 +4647,7 @@ class AI {
             if(signal?.aborted){
                 throw normalizeAIRequestAbort();
             }
-            const structuredOutputFormat=this.#structuredOutputFormat(
+            const structuredOutputFormat=normalizeStructuredOutput(
                 structuredOutput
             );
 
@@ -4776,7 +4661,7 @@ class AI {
         }
 
         if(structuredOutputFormat){
-            request.response_format=this.#openAIResponseFormat(
+            request.response_format=openAIResponseFormat(
                 structuredOutputFormat
             );
         }
@@ -4970,7 +4855,7 @@ class AI {
             destination:this.url
         });
         const body = JSON.stringify(request);
-        const response=await this.#fetchHTTPResponse(
+        const response=await fetchHTTPResponse(
             this.url,
             {
                 method:'POST',
@@ -5622,7 +5507,7 @@ class AI {
         if(signal?.aborted){
             throw normalizeAIRequestAbort();
         }
-        const structuredOutputFormat=this.#structuredOutputFormat(structuredOutput);
+        const structuredOutputFormat=normalizeStructuredOutput(structuredOutput);
 
         const normalizedReasoningEffort=normalizeAIReasoningEffort(
             reasoningEffort===undefined?this.reasoningEffort:reasoningEffort
@@ -5634,7 +5519,7 @@ class AI {
         }
 
         if(structuredOutputFormat){
-            request.response_format=this.#openAIResponseFormat(
+            request.response_format=openAIResponseFormat(
                 structuredOutputFormat
             );
         }
@@ -5718,7 +5603,7 @@ class AI {
             destination:this.url
         });
         const body = JSON.stringify(request);
-        const response=await this.#fetchHTTPResponse(
+        const responseJSON=await fetchJSONResponse(
             this.url,
             {
                 method:'POST',
@@ -5729,36 +5614,11 @@ class AI {
             }
         );
 
-        const contentType=response.headers.get('content-type')||'';
-
-        if(!contentType.includes('application/json')){
-            throw new TypeError(
-                `AI request returned ${contentType||'an unknown content type'} instead of JSON.`
-            );
-        }
-
-        let responseJSON;
-        try{
-            responseJSON=await response.json();
-        }catch(error){
-            if(isAIRequestAbort(error,signal)){
-                throw normalizeAIRequestAbort(error);
-            }
-            throw error;
-        }
         if(signal?.aborted){
             throw normalizeAIRequestAbort();
         }
-
-        if(!response.id){
-            response.id=id;
-        }
-
-        //console.log(responseJSON);
-        //async
         normalizeAICompletionToolCalls(responseJSON);
         await responseHandler(responseJSON,id,false);
-        //sync
         return responseJSON;
     }
 

package/src/app-layout.mjs

@@ -5,12 +5,6 @@ export function appRelativeRoot(config, appId) {
     return config.appsRoot === '.' ? '' : `apps/${appId}`;
 }
 
-// Generated compatibility URLs are separate from installation and storage identity.
-export function rootAppLegacyPath(config, appId) {
-    return config.appsRoot === '.' && config.legacyAppPaths !== false
-        ? `apps/${appId}` : undefined;
-}
-
 export function resolveAppRoot(workspaceRoot, config, appId) {
     return path.resolve(workspaceRoot, appRelativeRoot(config, appId));
 }
@@ -20,19 +14,3 @@ export function appBaseHref(workspaceRoot, appRoot, document = 'index.html') {
     const relative = path.relative(directory, workspaceRoot).split(path.sep).join('/');
     return relative ? `${relative}/` : './';
 }
-
-export function rootAppNavigation(appId, entry, documents = []) {
-    const redirects=new Map();
-    for(const document of documents)redirects.set(`apps/${appId}/${document}`,document);
-    redirects.set(`apps/${appId}/index.html`,entry);
-    return [...redirects].map(([file,target])=>{
-        const relative=path.posix.relative(path.posix.dirname(file),target);
-        const destination=JSON.stringify(relative).replaceAll('<','\\u003c');
-        return {
-            path:file,target:`/${target}`,
-            content:'<!doctype html>\n<!-- Arcane root application navigation -->\n'
-                +'<meta charset="utf-8">\n<title>Opening application</title>\n'
-                +`<script>const target=new URL(${destination},location.href);target.search=location.search;target.hash=location.hash;location.replace(target.href);</script>\n`
-        };
-    });
-}

package/src/cli/main.mjs

@@ -506,7 +506,7 @@ function operationOptions(command,parsed,cwd){
         return {
             targetPath:path.resolve(cwd,values.path??appId),
             appId,
-            appsRoot:values['apps-root']??'apps',
+            appsRoot:values['apps-root']??'.',
             displayName:values['display-name'],
             target:values.target??'browser',
             initializeGit:flags.has('git')

package/src/dev-server.mjs

@@ -6,7 +6,7 @@ import https from 'node:https';
 import os from 'node:os';
 import path from 'node:path';
 import {resolveWorkspace} from './workspace.mjs';
-import {appRelativeRoot,rootAppLegacyPath} from './app-layout.mjs';
+import {appRelativeRoot} from './app-layout.mjs';
 import {readInstalledSdkLayout} from './sdk-runtime-layout.mjs';
 import {APP_DESCRIPTOR_NAME, projectPackageManifest} from './app-descriptor.mjs';
 import {APP_CONFIG_NAME, validateAppConfig} from './packager/core.mjs';
@@ -1047,26 +1047,8 @@ async function startOwnedDevServer({
     const pwaResourceUrls = new Set();
     function developmentPwaArtifacts(selectedRoutes, assets = [], version = assetVersion) {
         const rootApp = selectedRoutes.config.appsRoot === '.';
-        const legacyAppPath = rootAppLegacyPath(selectedRoutes.config, selectedRoutes.appId);
         const appBase = applicationSourcePath(selectedRoutes.config,selectedRoutes.appId);
         const navigationAliases = {'/': selectedRoutes.startPath};
-        if (legacyAppPath) {
-            const legacyBase = `/${legacyAppPath}`;
-            navigationAliases[legacyBase] = selectedRoutes.startPath;
-            navigationAliases[`${legacyBase}/`] = selectedRoutes.startPath;
-            for (const asset of [selectedRoutes.startPath,...assets]) {
-                const pathname = new URL(asset,'http://arcane.invalid').pathname;
-                if (!/\.html?$/iu.test(pathname)) continue;
-                const segments = decodeURIComponent(pathname).split('/').filter(Boolean);
-                const mapping = selectedRoutes.mappings.find(function matchingNavigationRoute(route) {
-                    return route.prefix.every(function matchingNavigationSegment(segment,index) {
-                        return segments[index] === segment;
-                    });
-                });
-                if (mapping?.kind === 'app') navigationAliases[`${legacyBase}${pathname}`] = pathname;
-            }
-            navigationAliases[`${legacyBase}/index.html`] = selectedRoutes.startPath;
-        }
         return createPwaArtifacts(
             {
                 app: {
@@ -1085,7 +1067,6 @@ async function startOwnedDevServer({
                 ...(rootApp ? {
                     installationId:`/apps/${routeSet.appId}/`
                 } : {}),
-                legacyAppPath,
                 runtimeBase: selectedRoutes.browserRuntimeBase
                     ?? selectedRoutes.installed?.browserRuntimeBase ?? '/arcane/sdk/',
                 mode: 'development'
@@ -1177,34 +1158,17 @@ async function startOwnedDevServer({
             const target=parseRequestTarget(request.url);
             if(!target){deny(response,400,'Invalid request path.');return;}
             const {segments}=target;
-            const legacyAppRequest = mode === 'source' && rootAppLegacyPath(routeSet.config, routeSet.appId)
-                && segments[0] === 'apps' && segments[1] === routeSet.appId;
-            const legacyPwaRequest = legacyAppRequest && segments.length === 3
-                && ['arcane-sw.js', 'arcane-offline.json'].includes(segments[2]);
-            const generatedPwaPath = legacyPwaRequest
-                || ['/arcane.webmanifest', '/arcane-offline.json', '/arcane-sw.js', '/arcane-pwa.mjs']
-                    .includes(target.path);
+            const generatedPwaPath = ['/arcane.webmanifest', '/arcane-offline.json', '/arcane-sw.js', '/arcane-pwa.mjs']
+                .includes(target.path);
             const requestedMapping = currentSourceRoutes.mappings.find(function currentRequestMapping(route) {
                 return route.prefix.every(function currentRequestSegment(segment,index) {
                     return segments[index] === segment;
                 });
             });
-            const appRequest = requestedMapping?.kind === 'app' || legacyAppRequest;
+            const appRequest = requestedMapping?.kind === 'app';
             const selectedRoutes = mode === 'source' && (appRequest || segments.length === 0 || generatedPwaPath)
                 ? await refreshSourceRoutes() : currentSourceRoutes;
             const pwaEnabled = mode === 'source' ? selectedRoutes.app?.pwa?.enabled === true : routeSet.pwa;
-            const authoredLegacyResource = legacyAppRequest
-                && sourcePathAllowed(segments, selectedRoutes.app);
-            if (legacyAppRequest
-                && !(pwaEnabled && legacyPwaRequest)
-                && !authoredLegacyResource) {
-                const legacyPath = target.pathname.slice(`/apps/${routeSet.appId}`.length);
-                const location = !legacyPath || legacyPath === '/' || legacyPath === '/index.html'
-                    ? selectedRoutes.startPath : legacyPath;
-                response.writeHead(302,{location:`${location}${target.search}`});
-                response.end();
-                return;
-            }
             if (mode === 'source' && pwaEnabled
                 && generatedPwaPath) {
                 const generated = await sourcePwaArtifact(target.path, selectedRoutes);

package/src/import-map.mjs

@@ -47,6 +47,7 @@ const SDK_BROWSER_SELF_IMPORTS=new Map([
     ['arcane-os/speech-text','sdk/speech-text.mjs'],
     ['arcane-os/ai/browser-wasm',SDK_BROWSER_AI_ENTRY],
     ['arcane-os/ai/tool-text-stream','sdk/ai/tool-text-stream.mjs'],
+    ['arcane-os/ai/twin-cloud','sdk/ai/twin-cloud.mjs'],
     ['arcane-os/ai/browser-speech',SDK_BROWSER_SPEECH_ENTRY]
 ]);
 function fail(message,code='ARCANE_IMPORT_MAP_INVALID'){

package/src/mail-credentials.mjs

@@ -81,9 +81,9 @@ function mailCredentialEntry(settings, location) {
             : `mail.profiles[${JSON.stringify(location.profile)}].apiKey`
     };
     if (nestedSettings && Object.hasOwn(nestedSettings, 'apiKey')) return nestedEntry;
-    const legacySettings = mailProfileSettings(settings, location);
-    if (legacySettings && Object.hasOwn(legacySettings, 'RESEND_API_KEY')) {
-        return {profileSettings: legacySettings, key: 'RESEND_API_KEY', setting: location.setting};
+    const profileSettings = mailProfileSettings(settings, location);
+    if (profileSettings && Object.hasOwn(profileSettings, 'RESEND_API_KEY')) {
+        return {profileSettings, key: 'RESEND_API_KEY', setting: location.setting};
     }
     return nestedEntry;
 }

package/src/packager/core.mjs

@@ -12,7 +12,7 @@ import {
 } from 'node:fs/promises';
 import path from 'node:path';
 import {pathToFileURL} from 'node:url';
-import {appRelativeRoot,resolveAppRoot,rootAppLegacyPath,rootAppNavigation} from '../app-layout.mjs';
+import {appRelativeRoot,resolveAppRoot} from '../app-layout.mjs';
 import {readInstalledSdkLayout} from '../sdk-runtime-layout.mjs';
 import {withWorkspaceOperationLock} from '../workspace-operation-lock.mjs';
 import {
@@ -275,14 +275,11 @@ function validateSharedRoute(route,label){
 }
 
 export function validateRootConfig(value,configPath=ROOT_CONFIG_NAME){
-    assertOnlyKeys(value,new Set(['schemaVersion','appsRoot','distRoot','sharedPayloads','legacyAppPaths']),ROOT_CONFIG_NAME);
+    assertOnlyKeys(value,new Set(['schemaVersion','appsRoot','distRoot','sharedPayloads']),ROOT_CONFIG_NAME);
     if(value.schemaVersion!==1)fail(`${ROOT_CONFIG_NAME}.schemaVersion must be 1.`);
     if(!['apps','.'].includes(value.appsRoot)||value.distRoot!=='dist'){
         fail(`${ROOT_CONFIG_NAME} must bind appsRoot to "apps" or "." and distRoot to "dist".`);
     }
-    if (value.legacyAppPaths !== undefined && !is.boolean(value.legacyAppPaths)) {
-        fail(`${ROOT_CONFIG_NAME}.legacyAppPaths must be a boolean.`);
-    }
     if(!isPlainObject(value.sharedPayloads)){
         fail(`${ROOT_CONFIG_NAME}.sharedPayloads must be an object.`);
     }
@@ -297,8 +294,7 @@ export function validateRootConfig(value,configPath=ROOT_CONFIG_NAME){
         );
     }
     return {
-        schemaVersion:1,appsRoot:value.appsRoot,distRoot:'dist',sharedPayloads,configPath,
-        legacyAppPaths:value.legacyAppPaths ?? true
+        schemaVersion:1,appsRoot:value.appsRoot,distRoot:'dist',sharedPayloads,configPath
     };
 }
 
@@ -581,15 +577,6 @@ async function optionalDescriptor(context){
 async function inspectContext(context,{signal}={}){
     const records=await collectPackageRecords(context,{signal});
     const documents=await browserDocuments(records,context.config.entry);
-    const navigation=rootAppLegacyPath(context.rootConfig,context.appId)?rootAppNavigation(
-        context.appId,context.config.entry,documents.map(document=>document.path)
-    ):[];
-    for(const redirect of navigation){
-        const selected=records.find(record=>pathKey(record.destination)===pathKey(redirect.path));
-        if(selected&&!(await readFile(selected.source,'utf8')).includes('<!-- Arcane root application navigation -->')){
-            fail(`Root application navigation would replace selected content: ${redirect.path}.`);
-        }
-    }
     return {
         appId:context.appId,
         displayName:context.config.displayName,
@@ -607,7 +594,7 @@ async function inspectContext(context,{signal}={}){
         ...(context.config.adapter===undefined?{}:{adapter:context.config.adapter}),
         descriptor:await optionalDescriptor(context),
         browserDocuments:documents,
-        files:[...new Set(['index.html',...records.map(record=>record.destination),...navigation.map(redirect=>redirect.path)])].sort(compareText),
+        files:[...new Set(['index.html',...records.map(record=>record.destination)])].sort(compareText),
         output:path.relative(context.workspaceRoot,context.outputRoot).split(path.sep).join('/')
     };
 }
@@ -763,13 +750,9 @@ async function replaceDirectory(stagingRoot,outputRoot){
 async function packageWithContext(context,options={}){
     const {signal,onEvent,browserPwa=true}=options;
     const pwaEnabled=browserPwa&&context.config.pwa?.enabled===true;
-    const legacyAppPath=rootAppLegacyPath(context.rootConfig,context.appId);
     const appPath=appRelativeRoot(context.rootConfig,context.appId);
     const entryPath=appPackagePath(context,context.config.entry);
     const inspected=await inspectContext(context,{signal});
-    const navigation=legacyAppPath?rootAppNavigation(
-        context.appId,context.config.entry,inspected.browserDocuments.map(document=>document.path)
-    ):[];
     if(options.dryRun){
         return {
             appId:context.appId,
@@ -782,11 +765,7 @@ async function packageWithContext(context,options={}){
                     PWA_MANIFEST_NAME,
                     PWA_OFFLINE_MANIFEST_NAME,
                     PWA_WORKER_NAME,
-                    PWA_BOOTSTRAP_NAME,
-                    ...(legacyAppPath?[
-                        `${legacyAppPath}/${PWA_WORKER_NAME}`,
-                        `${legacyAppPath}/${PWA_OFFLINE_MANIFEST_NAME}`
-                    ]:[])
+                    PWA_BOOTSTRAP_NAME
                 ]:[])
             ].sort(compareText)
         };
@@ -824,18 +803,6 @@ async function packageWithContext(context,options={}){
         }else{
             await copyBase();
         }
-        for(const redirect of navigation){
-            throwIfAborted(signal);
-            const filePath=path.join(stagingRoot,...redirect.path.split('/'));
-            try{
-                const current=await readFile(filePath,'utf8');
-                if(!current.includes('<!-- Arcane root application navigation -->')){
-                    fail(`Root application navigation would replace package content: ${redirect.path}.`);
-                }
-            }catch(error){if(error.code!=='ENOENT')throw error;}
-            await mkdir(path.dirname(filePath),{recursive:true});
-            await writeFile(filePath,redirect.content,'utf8');
-        }
         const files=await listOutputFiles(stagingRoot,{signal});
         // Traverse actual browser resources after the adapter finishes. Files
         // included only as application documents retain their original content.
@@ -957,14 +924,6 @@ async function packageWithContext(context,options={}){
             fail(`Package output is missing its entry file: ${context.config.entry}.`);
         }
         const installed=pwaEnabled?await readInstalledSdkLayout(context.workspaceRoot,context.rootConfig):null;
-        const navigationAliases=navigation.length?{
-            './':packageResourceUrl(entryPath),
-            [`./apps/${context.appId}`]:packageResourceUrl(entryPath),
-            [`./apps/${context.appId}/`]:packageResourceUrl(entryPath),
-            ...Object.fromEntries(navigation.map(redirect=>[
-                packageResourceUrl(redirect.path),packageResourceUrl(redirect.target.slice(1))
-            ]))
-        }:undefined;
         const pwaArtifacts=pwaEnabled?createPwaArtifacts({
             app:{
                 id:context.appId,
@@ -973,9 +932,7 @@ async function packageWithContext(context,options={}){
                 entry:packageResourceUrl(entryPath)
             },
             appPath,
-            ...(legacyAppPath?{legacyAppPath}:{}),
             ...(installed?.direct?{runtimeBase:`.${installed.browserRuntimeBase}`} : {}),
-            ...(navigationAliases?{navigationAliases}:{}),
             sdkVersion:assetVersion,
             pwa:context.config.pwa,
             files,

package/src/pwa.mjs

@@ -1,6 +1,5 @@
 import Is from 'strong-type';
 import {randomUUID} from 'node:crypto';
-import path from 'node:path';
 import {createPwaWorkerScript} from './pwa-worker.mjs';
 import {versionAssetUrl} from './import-map.mjs';
 
@@ -204,7 +203,6 @@ export function createPwaArtifacts(
         runtimeBase = './arcane/sdk/',
         appBase,
         installationId,
-        legacyAppPath,
         appPath = '',
         navigationAliases,
         revision
@@ -316,47 +314,6 @@ controller.ready.catch(
         },
         {path: PWA_BOOTSTRAP_NAME, content: bootstrap}
     ];
-    if (legacyAppPath) {
-        const directory = legacyAppPath.endsWith('/') ? legacyAppPath : `${legacyAppPath}/`;
-        const priorDirectory = new URL(resourceUrl('./', directory), 'https://arcane.invalid/').pathname;
-        // Existing registrations continue updating their own script and inventory URLs.
-        function priorScopeUrl(value) {
-            if (value.startsWith('/') || /^[A-Za-z][A-Za-z0-9+.-]*:/u.test(value)) return value;
-            const resolved = new URL(value, 'https://arcane.invalid/');
-            let relative = path.posix.relative(priorDirectory, resolved.pathname);
-            if (!relative) {
-                relative = resolved.pathname.endsWith('/')
-                    ? './'
-                    : `../${path.posix.basename(resolved.pathname)}`;
-            }
-            else {
-                if (!relative.startsWith('.')) relative = `./${relative}`;
-                if (resolved.pathname.endsWith('/') && !relative.endsWith('/')) relative += '/';
-            }
-            return `${relative}${resolved.search}${resolved.hash}`;
-        }
-        const legacyOfflineManifest = {
-            ...offlineManifest,
-            assets: [...new Set([
-                ...offlineManifest.assets.map(priorScopeUrl),
-                `./${PWA_OFFLINE_MANIFEST_NAME}`
-            ])],
-            navigationAliases: Object.fromEntries(
-                Object.entries(offlineManifest.navigationAliases).map(
-                    function priorScopeNavigation([alias, target]) {
-                        return [priorScopeUrl(alias), priorScopeUrl(target)];
-                    }
-                )
-            )
-        };
-        generatedFiles.push(
-            {
-                path: `${directory}${PWA_WORKER_NAME}`,
-                content: createPwaWorkerScript(legacyOfflineManifest, priorScopeUrl(`${runtimeBase}pwa.mjs`))
-            },
-            {path: `${directory}${PWA_OFFLINE_MANIFEST_NAME}`, content: json(legacyOfflineManifest)}
-        );
-    }
     return {
         manifest,
         offlineManifest,

package/src/scaffold.mjs

@@ -316,7 +316,7 @@ async function runGitInit(workspaceRoot,signal,onEvent){
 export async function createWorkspace({
     targetPath,
     appId,
-    appsRoot='apps',
+    appsRoot='.',
     displayName,
     target='browser',
     initializeGit=false,
@@ -400,7 +400,7 @@ export async function initWorkspace({
     },async workspaceOperationLease=>{
     const profile=await existingWorkspaceProfile(resolvedRoot);
     const workspaceMode=profile?.workspaceMode??'external';
-    const selectedAppsRoot=appsRoot??profile?.config.appsRoot??'apps';
+    const selectedAppsRoot=appsRoot??profile?.config.appsRoot??'.';
     if(!['apps','.'].includes(selectedAppsRoot))fail('appsRoot must be apps or .','ARCANE_USAGE');
     if(profile&&selectedAppsRoot!==profile.config.appsRoot){
         fail('appsRoot must match the existing workspace layout; init does not relocate an application.','ARCANE_USAGE');
@@ -439,6 +439,7 @@ export async function initWorkspace({
     const template=workspaceMode==='integrated'
         ?workspaceTemplate({
             appId,
+            appsRoot:selectedAppsRoot,
             displayName,
             appOnly:true,
             namedImports:true,