gestalt-mobile 0.17.1 → 0.17.2

package/README.md

@@ -50,7 +50,10 @@ skill paths without starting the server. Without `--skills`, a workspace
 `gestalt-skills.yml` is used when present; otherwise Codex-native selection is
 preserved. Explicit profiles take precedence over project defaults, which take
 precedence over native configuration. Gestalt Mobile never rewrites Codex
-configuration or skill files.
+configuration or skill files. Exact skill paths remain authoritative, while
+paths inside Codex's versioned plugin cache are rebound to the currently
+discovered plugin version when their marketplace, plugin, and skill-relative
+path still match.
 
 ## Themes
 

package/dist/server/server/features/skills/model/skill-profile.js

@@ -81,6 +81,36 @@ function canonicalSkillPath(value) {
     }
     return value;
 }
+/**
+ * Return the durable identity of a skill inside Codex's versioned plugin cache.
+ * The concrete version directory is installation state, while marketplace,
+ * plugin, and skill-relative path remain stable across plugin upgrades.
+ */
+function versionNeutralPluginSkillPath(value) {
+    const match = value.match(/^(.*[\\/]plugins[\\/]cache[\\/][^\\/]+[\\/][^\\/]+)[\\/][^\\/]+([\\/]skills[\\/].+[\\/]SKILL\.md)$/);
+    return match ? `${match[1]}${match[2]}` : undefined;
+}
+function rebindVersionedPluginSkills(discovered, selection) {
+    const discoveredPaths = new Set(discovered.map((skill) => canonicalSkillPath(skill.path)));
+    const discoveredByDurablePath = new Map();
+    for (const skill of discovered) {
+        const durablePath = versionNeutralPluginSkillPath(canonicalSkillPath(skill.path));
+        if (durablePath === undefined)
+            continue;
+        const matches = discoveredByDurablePath.get(durablePath) ?? [];
+        matches.push(skill);
+        discoveredByDurablePath.set(durablePath, matches);
+    }
+    return createSkillSelection(selection.map((entry) => {
+        if (discoveredPaths.has(entry.path))
+            return entry;
+        const durablePath = versionNeutralPluginSkillPath(entry.path);
+        if (durablePath === undefined)
+            return entry;
+        const matches = discoveredByDurablePath.get(durablePath) ?? [];
+        return matches.length === 1 ? { ...entry, path: matches[0].path } : entry;
+    }));
+}
 /**
  * Validate a complete selection and return its canonical deterministic order.
  * This is lexical only: resolving symlinks is I/O and belongs to a platform
@@ -137,11 +167,12 @@ export function compileSkillOverride(input) {
     const effective = selectEffectiveSkillSelection(input);
     if (effective.selection === undefined)
         return { source: 'native', skillsConfig: undefined, warnings: [] };
+    const reboundSelection = rebindVersionedPluginSkills(input.discovered, effective.selection);
     const discoveredPaths = new Set(input.discovered.map((skill) => canonicalSkillPath(skill.path)));
-    const warnings = effective.selection
+    const warnings = reboundSelection
         .filter((entry) => !discoveredPaths.has(entry.path))
         .map((entry) => `Saved skill path is no longer discovered: ${entry.path}`);
-    const configured = applySkillSelectionSnapshot(input.discovered, effective.selection);
+    const configured = applySkillSelectionSnapshot(input.discovered, reboundSelection);
     return {
         source: effective.source,
         skillsConfig: configured

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gestalt-mobile",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "Mobile-first web relay for durable Codex development sessions",
   "keywords": [
     "codex",