arcane-os 0.97.0 → 0.97.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.97.1
+
+- Extract repeated selected TAR members in order, retaining the last complete
+  occurrence instead of rejecting valid upstream model companion archives.
+- Preserve earlier extracted files through interrupted replacements and replay
+  unfinished archive selections on retry. Completed archive selections remain
+  reusable while independent model files resume their own transfers.
+
 ## 0.97.0
 
 - Share native model storage across applications for the same operating-system

package/README.md

@@ -25,7 +25,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.97.0` SDK contract. Development applications declare
+This checkout defines the `0.97.1` 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/inventory/package-api.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "sdkVersion": "0.96.0",
+  "sdkVersion": "0.97.0",
   "environment": {
     "runtime": "Node.js for Node entrypoints; browser for browser-only entrypoints",
     "minimumVersion": "22.23.2 for Node entrypoints",

package/docs/reference/model-assets.md

@@ -183,6 +183,13 @@ path records select members; a leading `./` is archive path framing. Missing
 selected members reject preparation and identify the missing names. Gzip and
 other archive formats are outside this reader's contract.
 
+Repeated selected TAR names follow sequential extraction: the last complete
+occurrence replaces the earlier file only after closing its temporary output.
+An interrupted archive pass retains those files and replays its selected
+segments on retry, so an earlier occurrence is never mistaken for the final
+one. Fully completed archive selections are reused while other model files
+continue their own resumable downloads.
+
 When the upstream catalog supplies aligned TAR segments, an archive may include
 `ranges:[{start,end,stopBefore?}]`. The reader requests each inclusive HTTP range
 once and parses its TAR framing; `stopBefore` ends that segment before the

package/package.json

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

package/src/core/services/model-assets.mjs

@@ -503,9 +503,8 @@ async function extractTarRange(response, range, selected, found, entry, progress
             if (range?.stopBefore && (memberName === range.stopBefore || path.posix.basename(memberName) === range.stopBefore)) break;
             const memberIndexes = selected.get(memberName);
             if (memberIndexes && (type === '0' || type === '\0')) {
-                if (memberIndexes.some(function alreadyRead(index) { return found.has(index); })) {
-                    throw failure('MODEL_ASSET_ARCHIVE_FORMAT', `The selected TAR member occurs more than once: ${memberName}`);
-                }
+                // TAR extraction is ordered: a later complete occurrence replaces
+                // the earlier file only after its own stream and file close.
                 const handles = [];
                 const errors = [];
                 try {
@@ -744,6 +743,7 @@ async function acquireNativeMembers(entry) {
         state.transports ??= {};
         state.completedMembers = current?.completedMembers ?? [];
         const finished = new Set(state.completedMembers);
+        const completedArchiveMembers = new Set(state.completedArchiveMembers ?? []);
         completed = finished.size;
         await mkdir(path.join(selected.root, 'parts'), {recursive: true});
         progress('open');
@@ -786,17 +786,22 @@ async function acquireNativeMembers(entry) {
         let archiveIndex = members.findIndex(function archiveMember(member) { return member.archiveMember !== undefined; });
         for (const archive of entry.archives) {
             const selected = new Map();
+            const archiveMembers = [];
             for (const member of archive.members) {
                 const memberIndex = archiveIndex++;
-                if (finished.has(memberIndex)) continue;
+                archiveMembers.push(memberIndex);
                 const name = tarName(member.member);
                 if (!selected.has(name)) selected.set(name, []);
                 selected.get(name).push(memberIndex);
             }
             if (!selected.size) continue;
+            if (archiveMembers.every(function confirmed(index) { return finished.has(index) && completedArchiveMembers.has(index); })) continue;
+            for (const memberIndex of archiveMembers) completedArchiveMembers.delete(memberIndex);
             jobs.push(async function downloadArchiveMembers() {
                 const found = new Set();
                 try {
+                    state.completedArchiveMembers = [...completedArchiveMembers];
+                    await save();
                     for (const range of archive.ranges ?? [undefined]) {
                         signal.throwIfAborted();
                         const response = await fetchModelResponse(archive.url, signal, range);
@@ -811,6 +816,11 @@ async function acquireNativeMembers(entry) {
                         error.members = missing;
                         throw error;
                     }
+                    // A file written before a later TAR occurrence is retained
+                    // on interruption, but only a complete pass confirms reuse.
+                    for (const memberIndex of archiveMembers) completedArchiveMembers.add(memberIndex);
+                    state.completedArchiveMembers = [...completedArchiveMembers];
+                    await save();
                 } catch (error) {
                     noteFailure(error, error.code?.startsWith('MODEL_ASSET_ARCHIVE_') ? 'failed' : 'interrupted');
                     throw error;