arcane-os 0.26.0 → 0.27.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.27.1
+
+- Preserve the previous `apps/<id>/arcane-sw.js` and `arcane-offline.json`
+  endpoints when generating a root-layout PWA. Both use the canonical worker
+  and current root inventory, including navigation aliases and installed npm
+  resource paths; portable output also retains deployment-relative URLs.
+- Serve those previous worker and inventory endpoints directly during SDK
+  development instead of redirecting worker-script requests. Retain ordinary
+  browser update/activation, caches, application identity and saved data.
+- Keep root layout optional and existing multi-app and Node server behavior
+  unchanged. Installed-application execution remains consumer-owned.
+
+## 0.27.0
+
+- Add optional standalone `appsRoot: "."` discovery and `new`/`init --apps-root .`.
+  Preserve declared app IDs, existing multi-app/integrated layouts, nested pages,
+  and the selected native/portable package interface.
+- Serve and package direct installed SDK URLs under `/node_modules/<dependency>/`.
+  Managed bare and relative imports select the same module instances, including
+  npm aliases; dynamic component resources resolve from their own installed URL.
+- Generate root static PWA files and prior `/apps/<id>/` navigation pages through
+  the existing `arcane import-map` operation. Preserve authored installation IDs,
+  source/package defaults, query strings, fragments, and complete app content.
+  Ordinary static hosts need no additional SDK server or copied runtime.
+- Keep existing physical and virtual browser routes, Node mail APIs, listener
+  configuration, and server-consumer entrypoints unchanged.
+
 ## 0.26.0
 
 - Add explicit installed-package browser runtime routes. Source development,

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles preserve the same app URLs, theme, packaging,
 event, cancellation, and browser run contracts.
 
-This checkout defines the `0.26.0` SDK contract. Applications pin one exact npm
+This checkout defines the `0.27.1` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 
@@ -27,9 +27,14 @@ External browser apps can use the installed npm package directly, without a
 generated workspace `arcane/` directory or `arcane.lock.json`. Select the
 [four installed-package routes](docs/reference/protocols.md#installed-package-browser-routes)
 in `arcane-packager.json`: development, managed import maps, and PWA resources
-read the installed SDK while keeping `/arcane/...` browser URLs. Portable app
-packages still contain their selected runtime. Existing materialized workspaces
-and the scaffold's current layout remain supported. Node services continue to
+read the installed SDK at real `/node_modules/arcane-os/...` browser URLs when
+each destination equals its source. An alias uses its actual installed folder.
+Select `appsRoot: "."` for a standalone root app, or scaffold one with
+`arcane new my-app --apps-root .`. After npm installation, `arcane import-map`
+refreshes managed maps and the root app's static PWA/navigation files for ordinary
+static hosting. Portable app packages still contain their selected runtime.
+Existing `apps/<id>`, virtual `/arcane` routes, and materialized workspaces remain
+supported. Node services continue to
 use the installed CLI or public imports such as `arcane-os/mail`.
 
 The [mail gateway](docs/reference/mail.md) serves HTTPS with HTTP/2 on port 4433

package/browser-runtime/pwa-install.mjs

@@ -273,8 +273,8 @@ export function mountPwaInstallPrompt({appName = ''} = {}) {
         if (!globalThis.document) return null;
         // Both modules may start independently; saved theme loading is not a barrier.
         await Promise.all([
-            import(new URL('../modules/HTMLImport.js', import.meta.url).href),
-            import(new URL('../modules/ThemeBootstrap.js', import.meta.url).href)
+            import('arcane/HTMLImport'),
+            import('arcane/ThemeBootstrap')
         ]);
         if (owner.state.status === 'disposed') return null;
         if (!document.body) {
@@ -295,7 +295,7 @@ export function mountPwaInstallPrompt({appName = ''} = {}) {
         host.hidden = true;
         host.dataset.appName = String(appName);
         host.dataset.arcanePwaInstall = '';
-        host.setAttribute('href', new URL('../components/pwa-install.html', import.meta.url).href);
+        host.setAttribute('href', new URL('../components/pwa-install.html', import.meta.resolve('arcane/HTMLImport')).href);
         return new Promise(function waitForInstallComponent(resolve, reject) {
             const observer = new MutationObserver(function observeRemovedInstallComponent() {
                 if (!host.isConnected) cancelMount();

package/docs/architecture.md

@@ -87,10 +87,11 @@ app-scoped toolchain operation unchanged.
 An external workspace can select `installed-v1` routes directly from its
 `node_modules/arcane-os` installation, without a workspace `arcane/` tree or
 `arcane.lock.json`. The SDK reads the installed package version and maps its
-runtime, browser runtime, runtime dependency, and licenses to the established
-browser destinations. Existing `physical-v1` workspaces and the explicit
-materializer remain supported; scaffolding retains its existing physical
-layout. See [installed-package routes](reference/protocols.md#installed-package-browser-routes)
+runtime, browser runtime, runtime dependency, and licenses to the configured
+browser destinations. Direct destinations are the real npm paths. Existing
+`physical-v1` workspaces, virtual installed routes, and the explicit materializer
+remain supported. Root scaffolding selects direct npm routes; the existing
+multi-app scaffold retains its physical layout. See [installed-package routes](reference/protocols.md#installed-package-browser-routes)
 for the configuration and npm-alias form.
 
 An Arcane OS checkout is an integrated SDK consumer, not the owner
@@ -245,14 +246,24 @@ apps synthesize that descriptor from their schema-1 package plus the current
 native registry during migration.
 
 An external app can use four `installed-v1` shared routes in
-`arcane-packager.json`: the installed SDK's `runtime/arcane` maps to `/arcane`,
-`browser-runtime` to `/arcane/sdk`, `runtime/strong-type` to
-`/arcane/dependencies/strong-type`, and its three license files to
-`/licenses/arcane-os`. Source serving and import-map generation read those
+`arcane-packager.json`. With each destination equal to its source, browser URLs
+point directly into `/node_modules/arcane-os/runtime/arcane`,
+`/node_modules/arcane-os/browser-runtime`, and
+`/node_modules/arcane-os/runtime/strong-type`; the three package license files
+remain in `/node_modules/arcane-os`. An alias uses its actual installed folder.
+Source serving and import-map generation read those
 installed files without creating a workspace runtime copy. Distribution copies
 the selected routes completely inside the portable artifact, preserving the
 same URLs. Existing physical `arcane/` routes retain their behavior.
 
+`appsRoot: "."` places one standalone application at the workspace root while
+retaining its declared ID and app-relative entries. The existing `apps` option
+keeps multi-app and integrated layouts. Root static hosting consumes the same
+npm URLs, managed maps, generated PWA files, and compatibility navigation pages
+as SDK development. TWiN's ordinary static host needs no additional server;
+separate Node API hosts such as Stripe keep their existing server and SDK mail
+imports. Application location does not change their listeners or configuration.
+
 Release schema 1 and builder identity `arcane-app-packager-v1` remain unchanged
 because current Arcane native consumers treat them as public contracts. Native
 builders consume the schema-2 descriptor as a separate build input while v1

package/docs/reference/cli.md

@@ -109,7 +109,7 @@ Creates one repository-shaped external application workspace and the selected
 app. It never creates more than one app or silently installs a global SDK.
 
 ```text
-arcane new <id> [--path <directory>] [--display-name <name>] [--target <target>] [--git]
+arcane new <id> [--path <directory>] [--apps-root apps|.] [--display-name <name>] [--target <target>] [--git]
 ```
 
 ### Options and result
@@ -120,6 +120,12 @@ directory as a repository. Native target scaffolds also retain `browser` and
 include the required icon. The result reports the workspace, app, descriptor,
 target, and created paths.
 
+`--apps-root .` creates a standalone root application using its installed npm
+SDK directly. The default `--apps-root apps` preserves `apps/<id>`. Root setup
+does not install dependencies or copy a runtime: run `npm install`, then
+`npm run import-map`. Until installation, its result reports the import map as
+pending with reason `sdk-install-required`.
+
 ### Example
 
 ```bash
@@ -135,7 +141,7 @@ initialization writes only the selected `apps/<id>/` boundary and does not add
 an SDK dependency to the Arcane OS repository.
 
 ```text
-arcane init [id] [--workspace <directory>] [--app <id>] [--display-name <name>] [--target <target>]
+arcane init [id] [--workspace <directory>] [--app <id>] [--apps-root apps|.] [--display-name <name>] [--target <target>]
 ```
 
 ### Errors and safety
@@ -145,6 +151,10 @@ incompatible workspace fail rather than being overwritten. Initialization is
 idempotent only for files whose existing content satisfies the scaffold
 contract.
 
+`--apps-root .` selects root setup for a standalone workspace. Omission retains
+the configured layout, or `apps` for a new configuration. `init` never moves an
+existing application or converts the integrated Arcane OS layout.
+
 ### Example
 
 ```bash
@@ -318,13 +328,14 @@ workspace/runtime routes. It defaults to HTTPS on localhost; `--public` enables
 from other devices on the network, using HTTPS by default.
 
 For an external workspace, the server exposes the selected SDK routes alongside
-the application. `installed-v1` serves directly from the installed package
-under `/arcane`, `/arcane/sdk`, and `/arcane/dependencies/strong-type`, without
-creating a workspace runtime directory. Existing `physical-v1` workspaces serve
+the application. Direct `installed-v1` routes serve the real
+`/node_modules/<dependency>/...` URLs without creating a workspace runtime
+directory. Earlier virtual `/arcane` installed routes remain supported.
+Existing `physical-v1` workspaces serve
 their projected `arcane/` root. Integrated workspaces retain their configured
 physical routes.
-The explicit live-source SDK mapping remains unchanged and does not replace the
-installed projection.
+An explicit live-source SDK mapping follows the selected browser destinations
+while reading canonical SDK source; it never replaces installed files.
 
 ```text
 arcane dev [--app <id>] [--public] [--http | --https] [--cert <file> --key <file>] [--host <address>] [--port 8000] [--http-port 0]

package/docs/reference/protocols.md

@@ -107,31 +107,31 @@ needed:
 ```json
 {
   "schemaVersion": 1,
-  "appsRoot": "apps",
+  "appsRoot": ".",
   "distRoot": "dist",
   "sharedPayloads": {
     "browser-runtime": [
       {
         "source": "node_modules/arcane-os/runtime/arcane",
-        "destination": "arcane",
+        "destination": "node_modules/arcane-os/runtime/arcane",
         "include": ["components", "css", "entities", "img", "modules"],
         "exclude": []
       },
       {
         "source": "node_modules/arcane-os/browser-runtime",
-        "destination": "arcane/sdk",
+        "destination": "node_modules/arcane-os/browser-runtime",
         "include": ["."],
         "exclude": []
       },
       {
         "source": "node_modules/arcane-os/runtime/strong-type",
-        "destination": "arcane/dependencies/strong-type",
+        "destination": "node_modules/arcane-os/runtime/strong-type",
         "include": ["."],
         "exclude": []
       },
       {
         "source": "node_modules/arcane-os",
-        "destination": "licenses/arcane-os",
+        "destination": "node_modules/arcane-os",
         "include": ["LICENSE", "COMMERCIAL-LICENSE.md", "NOTICE"],
         "exclude": []
       }
@@ -142,22 +142,44 @@ needed:
 
 The first include list also accepts a final `security` entry. An npm alias such
 as `arcane-sdk` substitutes `node_modules/arcane-sdk` for the package prefix in
-all four source paths. Destinations remain unchanged. Package selection and SDK
+all four source and destination paths. Package selection and SDK
 version come from the installed dependency, not a generated runtime lock.
 
 `arcane import-map`, `arcane dev`, packaging, and generated PWA inventories use
-the same logical destinations. Source serving and map generation read installed
+the same actual npm destinations. For example, `arcane/HTMLImport` resolves to
+`./node_modules/arcane-os/runtime/arcane/modules/HTMLImport.js`, and
+`arcane-os/event-manager` resolves to
+`./node_modules/arcane-os/browser-runtime/event-manager.mjs`. A normal static
+server can serve those files directly. Source serving and map generation read installed
 files without materializing them into the workspace. A selected portable
 package copies its complete selected resources inside the artifact, preserving
 the same browser URLs and saved managed import maps.
 
 Existing `physical-v1` configurations whose first source is `arcane` remain
 supported. The explicit materializer below still refreshes those projections,
-and scaffolding retains its existing physical layout. Selecting `installed-v1`
+and the default multi-app scaffold retains its existing physical layout. The
+earlier installed routes with virtual `/arcane` destinations also remain
+supported. Selecting `installed-v1`
 does not delete any preexisting workspace files. The separate host-document
 `generateDocumentImportMaps()` API continues to accept an already materialized
 runtime; its input contract is unchanged.
 
+### Optional standalone root application
+
+`appsRoot: "."` selects one application whose `arcane-app.json`,
+`arcane-package.json`, entry, and app-owned files occupy the workspace root.
+The declared application ID remains unchanged. `appsRoot: "apps"` continues
+to discover `apps/<id>` and supports the existing integrated and multi-app
+layouts. Entries and include/exclude paths remain relative to the application.
+
+Root HTML uses `<base href="./">`; nested navigable documents use their actual
+depth back to the workspace. Managed bare imports remain the public interface;
+their targets follow the selected npm routes. `arcane import-map` also writes
+root-app navigation pages for the previous `/apps/<id>/` links, preserving
+query strings and fragments. It preserves authored files at those destinations.
+For a direct-installed root PWA it generates the static PWA records at the root,
+so normal static hosting needs no SDK request handler or runtime copy.
+
 ## Installed SDK runtime materialization
 
 `materializeInstalledSdkRuntime()` is the Node entrypoint for refreshing one

package/docs/reference/pwa.md

@@ -47,6 +47,30 @@ explicit `id` and `scope` values, resolve against `./apps/<id>/`; an icon such
 as `img/library.png` therefore remains beneath the app directory. Absolute URL
 fields retain their authored destination.
 
+For `appsRoot: "."`, application URLs stay at the deployment root. Direct npm
+routes keep runtime URLs under `/node_modules/<dependency>/...`. The public
+`arcane import-map` operation generates static PWA files beside the root entry
+and adds their links to the selected navigable documents. This works with an
+ordinary static host; it does not copy the installed runtime into `arcane/`.
+The source root defaults its installation ID to `/apps/<id>/` to preserve the
+previous source identity while its start URL and scope move to the root. An
+authored `manifest.id` remains authoritative. Packaged default identity remains
+`./`. Existing `/apps/<id>/` navigation aliases retain query strings and
+fragments and lead to the selected root document. No stored application data is
+rewritten by changing the layout.
+
+Root PWA generation also retains `apps/<id>/arcane-sw.js` and
+`apps/<id>/arcane-offline.json`. These are ordinary generated files served at
+their original URLs, including on a static host. The same canonical worker and
+current inventory use root resource/navigation URLs, rebased for the previous
+scope when deployed beneath a directory. An existing worker's inventory refresh
+can learn the new navigation destinations; the browser can update the worker at
+its retained script URL through normal update and activation. No cache deletion,
+forced activation, user-data migration or application-owned server handler is
+introduced. Offline clients require a later successful connection to receive
+updated files; fixture coverage does not establish a particular installed app's
+actual browser lifecycle.
+
 `offline.include` and `offline.exclude` select literal paths or directory
 prefixes from the selected emitted inventory. An omitted or empty include list
 selects that inventory; exclusions subtract from it. App files use app-relative

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.26.0",
+  "version": "0.27.1",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -84,7 +84,7 @@
     "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/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:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.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: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",
     "check:release": "node tools/check-source.mjs --package-only && npm run test:release",

package/runtime/arcane/components/dashboard-config.html

@@ -16,6 +16,7 @@
     const {arcaneLogging}=await import('arcane-os/logging');
 
     const host=this;
+    const componentHref=new URL(host.getAttribute('href'),document.baseURI);
     const {default:waitForComponent}=await import('../modules/WaitForComponent.js');
     const {
         effectiveDashboardVisibility,
@@ -232,7 +233,7 @@
         const items=document.createElement('section');
 
         styles.rel='stylesheet';
-        styles.href=new URL('./arcane/css/dashboard-config.css?v=2',document.baseURI).href;
+        styles.href=new URL('../css/dashboard-config.css?v=2',componentHref).href;
         heading.dataset.dashboardConfigHeading='';
         message.dataset.dashboardConfigDescription='';
         empty.className='dashboard-config-empty';

package/runtime/arcane/components/data-view.html

@@ -20,6 +20,7 @@
     const {arcaneLogging}=await import('arcane-os/logging');
 
     const host=this;
+    const componentHref=new URL(host.getAttribute('href'),document.baseURI);
     const openButton=host.shadowRoot.querySelector('#openData');
     const dataModal=host.shadowRoot.querySelector('#dataModal');
     const {default:waitForComponent}=await import('../modules/WaitForComponent.js');
@@ -89,7 +90,7 @@
             fileManager.dataset.layout=host.dataset.layout||'files';
             fileManager.setAttribute(
                 'href',
-                './arcane/components/file-manager.html?v=18'
+                new URL('./file-manager.html?v=18',componentHref).href
             );
 
             content.append(heading,fileManager);

package/runtime/arcane/components/file-manager.html

@@ -352,6 +352,7 @@
     //importing Document at the end of the file to avoid blocking;
 
     const host=this;
+    const componentHref=new URL(host.getAttribute('href'),document.baseURI);
     const {default:waitForComponent}=await import('../modules/WaitForComponent.js');
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const events=createArcaneEventSource(host,{source:'arcane.component.file-manager',eventTypes:['file-manager-action','file-manager-select','file-manager-open','file-manager-ready']});
@@ -830,8 +831,8 @@
         icon.className='tree-entry-icon';
         icon.alt='';
         icon.src=entry.kind==='directory'
-            ?new URL('./arcane/img/folder.svg',document.baseURI).href
-            :new URL('./arcane/img/doc.svg',document.baseURI).href;
+            ?new URL('../img/folder.svg',componentHref).href
+            :new URL('../img/doc.svg',componentHref).href;
         name.className='tree-entry-name';
         name.innerText=entry.name;
         count.className='tree-file-count';
@@ -1409,7 +1410,7 @@
         deleteButton.innerText='Delete File';
         deleteIcon.alt='';
         deleteIcon.className='action-icon';
-        deleteIcon.src=new URL('./arcane/img/trash.svg',document.baseURI).href;
+        deleteIcon.src=new URL('../img/trash.svg',componentHref).href;
         deleteButton.prepend(deleteIcon);
         deleteButton.addEventListener(
             'click',
@@ -1615,7 +1616,7 @@
 
         fileIcon.alt='';
         fileIcon.className='icon file-icon';
-        fileIcon.src=new URL('./arcane/img/doc.svg',document.baseURI).href;
+        fileIcon.src=new URL('../img/doc.svg',componentHref).href;
         fileDetails.className='file-details';
         fileLabel.className='file-name';
         fileLabel.innerText=fileName;
@@ -1638,7 +1639,7 @@
 
         deleteIcon.alt='';
         deleteIcon.className='action-icon';
-        deleteIcon.src=new URL('./arcane/img/trash.svg',document.baseURI).href;
+        deleteIcon.src=new URL('../img/trash.svg',componentHref).href;
 
         openButton.addEventListener(
             'click',
@@ -1938,7 +1939,7 @@
             directory.dataset.directory=tableName;
             folder.className='file folder';
             folderIcon.className='icon';
-            folderIcon.src=new URL('./arcane/img/folder.svg',document.baseURI).href;
+            folderIcon.src=new URL('../img/folder.svg',componentHref).href;
             folderName.innerText=tableName;
             fileCount.className='file-count';
             fileCount.innerText=`${files.length} ${files.length===1?'file':'files'}`;

package/src/app-descriptor.mjs

@@ -1,4 +1,5 @@
 import Is from 'strong-type';
+import {resolveAppRoot} from './app-layout.mjs';
 import {isDeepStrictEqual} from 'node:util';
 import {readFile, writeFile} from 'node:fs/promises';
 import path from 'node:path';
@@ -427,7 +428,8 @@ async function readJsonFile(filePath,label,{optional=false}={}){
 
 export async function refreshAppPackageProjection({workspaceRoot, appId, signal, onEvent}) {
     throwIfAborted(signal);
-    const appRoot = path.join(workspaceRoot, 'apps', appId);
+    const rootConfig=await readJsonFile(path.join(workspaceRoot,'arcane-packager.json'),'arcane-packager.json');
+    const appRoot = resolveAppRoot(workspaceRoot,rootConfig,appId);
     const descriptorPath = path.join(appRoot, APP_DESCRIPTOR_NAME);
     const authored = await readJsonFile(
         descriptorPath,

package/src/app-layout.mjs

@@ -0,0 +1,32 @@
+import path from 'node:path';
+
+// The app identity is independent of whether its files occupy a workspace root.
+export function appRelativeRoot(config, appId) {
+    return config.appsRoot === '.' ? '' : `apps/${appId}`;
+}
+
+export function resolveAppRoot(workspaceRoot, config, appId) {
+    return path.resolve(workspaceRoot, appRelativeRoot(config, appId));
+}
+
+export function appBaseHref(workspaceRoot, appRoot, document = 'index.html') {
+    const directory = path.dirname(path.resolve(appRoot, document));
+    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/application-tests.mjs

@@ -124,7 +124,9 @@ async function selectedTestFiles({workspaceRoot,workspaceMode,appRoot,signal}){
     if(workspaceMode==='external'){
         await collectOptionalTests(path.join(workspaceRoot,'test'),workspaceRoot,files,signal);
     }
-    if(appRoot)await collectOptionalTests(path.join(appRoot,'test'),appRoot,files,signal);
+    if(appRoot&&(workspaceMode!=='external'||!samePath(workspaceRoot,appRoot))){
+        await collectOptionalTests(path.join(appRoot,'test'),appRoot,files,signal);
+    }
     return [...files].sort();
 }
 

package/src/cli/main.mjs

@@ -14,6 +14,7 @@ const VALUE_OPTIONS=new Set([
     'display-name',
     'workspace',
     'app',
+    'apps-root',
     'sdk-runtime-source',
     'arcane-root',
     'host',
@@ -60,8 +61,8 @@ const MAX_NODE_TIMER_DELAY_MS=2_147_483_647;
 export const HELP_TEXT=`Arcane OS application SDK ${SDK_VERSION}
 
 Usage:
-  ${CLI_NAME} new <id> [--path <directory>] [--display-name <name>] [--target <target>] [--git]
-  ${CLI_NAME} init [id] [--workspace <directory>] [--display-name <name>] [--target <target>]
+  ${CLI_NAME} new <id> [--path <directory>] [--apps-root apps|.] [--display-name <name>] [--target <target>] [--git]
+  ${CLI_NAME} init [id] [--workspace <directory>] [--apps-root apps|.] [--display-name <name>] [--target <target>]
   ${CLI_NAME} upgrade [--workspace <directory>] [--app <id>]
   ${CLI_NAME} doctor [--workspace <directory>] [--arcane-root <directory>]
   ${CLI_NAME} import-map [--workspace <directory>] [--app <id>]
@@ -421,15 +422,6 @@ function readScope(value){
     return scope;
 }
 
-function inferredAppId(workspaceRoot){
-    const id=path.basename(workspaceRoot)
-        .normalize('NFKD')
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/gu,'-')
-        .replace(/^-+|-+$/gu,'');
-    return id||'arcane-app';
-}
-
 function noExtraPositionals(command,positionals,expected=0){
     if(positionals.length>expected){
         usage(`Unexpected argument for ${command}.`);
@@ -503,6 +495,9 @@ function operationOptions(command,parsed,cwd){
     if(command!=='mail'&&flags.has('report-stdin')){
         usage('--report-stdin is supported only by mail send.');
     }
+    if(values['apps-root']!==undefined&&!['new','init'].includes(command)){
+        usage('--apps-root is supported only by new and init.');
+    }
 
     if(command==='new'){
         const appId=positionals[0];
@@ -511,6 +506,7 @@ function operationOptions(command,parsed,cwd){
         return {
             targetPath:path.resolve(cwd,values.path??appId),
             appId,
+            appsRoot:values['apps-root']??'apps',
             displayName:values['display-name'],
             target:values.target??'browser',
             initializeGit:flags.has('git')
@@ -520,7 +516,8 @@ function operationOptions(command,parsed,cwd){
         noExtraPositionals(command,positionals,1);
         return {
             workspaceRoot,
-            appId:positionals[0]??values.app??inferredAppId(workspaceRoot),
+            appId:positionals[0]??values.app,
+            appsRoot:values['apps-root'],
             displayName:values['display-name'],
             target:values.target??'browser'
         };