arcane-os 0.73.0 → 0.74.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.74.0
+
+- Add optional `longPaths` to `createRepositoryWorkspace()` for newly cloned
+  Windows repositories. Explicit true or false selects clone-local
+  `core.longpaths` before the first checkout and persists it in the new target.
+- Preserve inherited and template configuration when the option is omitted,
+  existing repositories, non-Windows commands, and the ordinary single-clone
+  identity, progress, cancellation and hook lifecycle. No global setting,
+  repository migration, filename transformation or dependency change is added.
+
 ## 0.73.0
 
 - Add public `resolvePwaRetirementResponse({workspaceRoot, appId})` for existing

package/README.md

@@ -20,7 +20,7 @@ selected SDK projection or an explicit live SDK source mount. Both profiles
 share the theme, packaging, event, cancellation,
 and browser run contracts while retaining their selected application layout.
 
-This checkout defines the `0.73.0` SDK contract. Development applications declare
+This checkout defines the `0.74.0` SDK contract. Development applications declare
 `arcane-os` as `latest` and retain their lockfile. Exact SDK pins begin when Roshi
 designates a production build. Follow [Consumer updates](docs/consumer-updates.md)
 to refresh and compare the installed SDK and lockfile with the published channel;

package/docs/reference/README.md

@@ -44,6 +44,7 @@ alone does not make bare module names resolve in a browser.
 | Install an app and cache selected resources offline | [Progressive web applications](pwa.md) |
 | Disable source PWA generation or explicitly retire confirmed generated output | [Source PWA retirement](pwa.md#disable-source-pwa-generation-and-retire-generated-output) |
 | Retire the prior worker after explicitly disabling standalone source PWA | [Disabled-worker browser lifecycle](pwa.md#disabled-worker-retirement-on-the-source-server) |
+| Retire a disabled worker through an existing custom source host | [Public PWA retirement response](pwa.md#retirement-through-an-existing-custom-host) |
 | Generate named browser imports or inspect the selected physical runtime | [`arcane import-map`](cli.md#arcane-import-map) and [browser runtime delivery](protocols.md#browser-runtime-delivery) |
 | Connect an application through the shared WebSocket transport | [Shared WebSocket clients](websocket-client.md) |
 | Choose browser, native, cloud, or cross-host behavior | [Availability and normalization](availability-and-normalization.md) |

package/docs/reference/core-repositories.md

@@ -47,7 +47,7 @@ const status = await repository.status({signal});
 await repository.close();
 ```
 
-`createRepositoryWorkspace({name,directory,dataRoot,remote,branch,gitIdentity,onEvent,run}={})`
+`createRepositoryWorkspace({name,directory,dataRoot,remote,branch,longPaths,gitIdentity,onEvent,run}={})`
 returns `{directory,open,status,configuration,pull,push,write,close,drain,dispose}`. The `directory`
 property is the absolute selected working path.
 
@@ -63,6 +63,11 @@ property is the absolute selected working path.
   `branch`, when supplied, is passed unchanged to Git's `clone --branch` option;
   otherwise Git selects the remote's default branch. Existing checkouts keep
   their own branch, remote, tracked files, untracked files and local changes.
+- Optional `longPaths` is a boolean for newly cloned Windows checkouts. Explicit
+  `true` or `false` supplies `clone --config core.longpaths=<value>`, so Git
+  writes that choice to the new repository before its first checkout. Omission
+  leaves Git's configuration unchanged. The option does not rewrite an existing
+  checkout, change a global setting, or alter non-Windows clone commands.
 - `onEvent` and optional `run` use the existing SDK process owner. The default
   adapter is `runProcess`; Git must be available on PATH. Credentials and
   authentication remain with Git and the native host. The SDK adds no download,
@@ -90,6 +95,38 @@ A failed or cancelled clone reports the actual failure; any remaining directory
 is retained for application-owned inspection. There is no automatic deletion or
 destructive retry. Filesystem failures and complete Git diagnostics propagate.
 
+### Windows long paths for a new checkout
+
+Select the option in the application's native repository connection:
+
+```javascript
+const repository = createRepositoryWorkspace({
+    name: 'moon-cheese-dispatches',
+    remote: applicationConnection.remote,
+    longPaths: true
+});
+await repository.open({signal});
+```
+
+This remains one ordinary Git clone, including its branch/tag selection,
+progress, hooks, cancellation and empty-remote behavior. It does not clone
+without checkout and run a second initialization sequence. The boolean is
+captured when the owner is constructed; later edits to the options object
+cannot change an accepted connection.
+
+An explicit value intentionally selects the new repository's local
+`core.longpaths` setting. Git's ordinary configuration precedence still applies,
+including higher-priority command-scope settings supplied by the native host.
+Omit the option to retain inherited or template configuration without an SDK
+override. Existing repositories retain their settings even if this option is
+supplied; there is no configuration migration or repair pass.
+
+[Git documents clone-local configuration before the initial checkout](https://git-scm.com/docs/git-clone#OPTIONS).
+[Git for Windows describes long-path support](https://gitforwindows.org/git-cannot-create-a-file-or-directory-with-a-long-path.html)
+for its native commands; unrelated editors, scripts and host tools may have
+their own path limitations. This option changes no filenames or payloads and
+does not change the SDK's persistent directory selection.
+
 ## Existing checkout configuration and selected targets
 
 `configuration({signal}={})` observes an existing checkout without invoking

package/docs/reference/inventory/package-api.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "sdkVersion": "0.72.0",
+  "sdkVersion": "0.73.0",
   "environment": {
     "runtime": "Node.js for Node entrypoints; browser for browser-only entrypoints",
     "minimumVersion": "22.23.2 for Node entrypoints",
@@ -199,14 +199,14 @@
       "name": "createRepositoryWorkspace",
       "displayName": "createRepositoryWorkspace()",
       "kind": "function",
-      "signature": "createRepositoryWorkspace({name,directory,dataRoot,remote,branch,gitIdentity,onEvent,run=runProcess}={})",
+      "signature": "createRepositoryWorkspace({name,directory,dataRoot,remote,branch,longPaths,gitIdentity,onEvent,run=runProcess}={})",
       "entrypoints": ["arcane-os/core/repositories"],
       "primaryImport": "arcane-os/core/repositories",
       "group": "Native repository workspaces",
       "summary": "Owns one selected native working checkout with ArcaneData/Repos defaults and existing Git/process lifecycle.",
       "availability": "Node with Git on Windows, Linux and macOS; Android requires host process adaptation",
       "protocol": "Git working repository and SDK process adapter",
-      "normalization": "Returns directory, open, status, configuration, pull, push, write and identical close/drain/dispose hooks. Only missing or empty destinations clone; existing roots are preserved. configuration observes the existing root, symbolic HEAD, origin URL/pushURL arrays and branch remote/merge/upstream URL arrays without clone/init/fetch, preserving unset, empty and repeated values. Explicit paths remain selected. Same-directory operations serialize within the process; cancellation and shutdown join accepted process work. pull/push/write accept a captured target {remote,ref} for current-branch fast-forward pull or non-force current-HEAD selected-ref push; omission retains ordinary configured behavior. write snapshots exact text and paths, stages/commits only literal owned paths and preserves unrelated staged files and Git filters. Complete outputs and causal failures retain confirmed local/committed/pushed and uncertain outcomes plus the supplied target. Optional gitIdentity captures name/email/username for child Git operations only; omitted fields remain inherited and no config file is written."
+      "normalization": "Returns directory, open, status, configuration, pull, push, write and identical close/drain/dispose hooks. Only missing or empty destinations clone; existing roots are preserved. Optional longPaths captures a boolean: explicit Windows true/false supplies clone-local core.longpaths before the first checkout, persisting only in the new repository under ordinary Git configuration precedence. Omission preserves configuration; existing repositories and non-Windows clone commands remain unchanged. No global setting or migration. configuration observes the existing root, symbolic HEAD, origin URL/pushURL arrays and branch remote/merge/upstream URL arrays without clone/init/fetch, preserving unset, empty and repeated values. Explicit paths remain selected. Same-directory operations serialize within the process; cancellation and shutdown join accepted process work. pull/push/write accept a captured target {remote,ref} for current-branch fast-forward pull or non-force current-HEAD selected-ref push; omission retains ordinary configured behavior. write snapshots exact text and paths, stages/commits only literal owned paths and preserves unrelated staged files and Git filters. Complete outputs and causal failures retain confirmed local/committed/pushed and uncertain outcomes plus the supplied target. Optional gitIdentity captures name/email/username for child Git operations only; omitted fields remain inherited and identity selection writes no config file."
     },
     {
       "id": "core-repositories:readGitIdentity",

package/docs/reference/sdk-api.md

@@ -319,6 +319,7 @@ The remaining data-only subpaths are eight JSON Schemas and package metadata.
 | `repositoryPush()` | function | `arcane-os` | Workspace, doctor, repository, and server | Node; network-assisted Git |
 | `repositoryStatus()` | function | `arcane-os` | Workspace, doctor, repository, and server | Node |
 | `resolveNativeBuildOutputRoot()` | function | `arcane-os` | Targets, native plans, and providers | Node; selected browser/native target or provider as documented |
+| `resolvePwaRetirementResponse()` | function | `arcane-os` | Workspace, doctor, repository, and server | Node; browser service-worker lifecycle remains browser-owned |
 | `resolveWorkspace()` | function | `arcane-os` | Workspace, doctor, repository, and server | Node |
 | `ROOT_CONFIG_NAME` | constant | `arcane-os/packager` | Packaging and release bundles | Node |
 | `discoverApps()` | function | `arcane-os` | Workspace, doctor, repository, and server | Node |
@@ -8095,7 +8096,7 @@ explicit existing path. The application owns the remote, branch and Core API.
 ### Signature and result
 
 ```text
-createRepositoryWorkspace({name,directory,dataRoot,remote,branch,gitIdentity,onEvent,run=runProcess}={})
+createRepositoryWorkspace({name,directory,dataRoot,remote,branch,longPaths,gitIdentity,onEvent,run=runProcess}={})
 ```
 
 Returns `{directory,open,status,configuration,pull,push,write,close,drain,dispose}`. Construction does
@@ -8106,6 +8107,14 @@ work and preserves the checkout. No CLI cwd, launch state, preference, snapshot
 cache or existing user-data location changes. See the [complete inputs, results,
 errors and lifecycle](core-repositories.md#one-connected-working-checkout).
 
+Optional `longPaths` captures a boolean for new Windows clones. Explicit true
+or false supplies clone-local `core.longpaths` before the first checkout and
+persists it only in the new repository. Omission preserves inherited/template
+configuration. Existing repositories and non-Windows clone commands remain
+unchanged; no global setting or data migration is performed. Git's ordinary
+configuration precedence, hooks and single-clone lifecycle remain in effect.
+See [Windows long paths](core-repositories.md#windows-long-paths-for-a-new-checkout).
+
 Optional `gitIdentity:{name?,email?,username?}` captures explicit non-secret
 settings for child Git operations without writing global/local configuration.
 Selected author fields override inherited child author/committer fields;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.73.0",
+  "version": "0.74.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/src/core/repositories.mjs

@@ -45,7 +45,7 @@ export function resolveArcaneDataPaths({dataRoot} = {}) {
 
 /** One connected checkout, composed into an application's own Core service. */
 export function createRepositoryWorkspace(
-    {name, directory, dataRoot, remote, branch, gitIdentity, onEvent, run = runProcess} = {}
+    {name, directory, dataRoot, remote, branch, longPaths, gitIdentity, onEvent, run = runProcess} = {}
 ) {
     let selected = directory;
     if (selected === undefined) {
@@ -58,6 +58,9 @@ export function createRepositoryWorkspace(
     requireString(selected, 'directory');
     if (remote !== undefined) requireString(remote, 'remote');
     if (branch !== undefined) requireString(branch, 'branch');
+    if (longPaths !== undefined && !is.boolean(longPaths)) {
+        throw new TypeError('longPaths must be a boolean when supplied.');
+    }
     if (!is.function(run)) throw new TypeError('run must implement the SDK process adapter.');
     const execute = createGitIdentityRunner(run, gitIdentity);
     const repositoryDirectory = path.resolve(selected);
@@ -100,6 +103,11 @@ export function createRepositoryWorkspace(
         await mkdir(path.dirname(repositoryDirectory), {recursive: true});
         throwIfAborted(signal);
         const arguments_ = ['clone', '--progress'];
+        // Clone-local configuration persists before the first checkout. Omission
+        // leaves inherited settings alone; existing repositories never reach here.
+        if (process.platform === 'win32' && longPaths !== undefined) {
+            arguments_.push('--config', `core.longpaths=${longPaths}`);
+        }
         if (branch !== undefined) arguments_.push('--branch', branch);
         arguments_.push('--', remote, repositoryDirectory);
         const result = await prepareRun(