@selesai/code 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to `@selesai/code` will be documented in this file.
 
+## [0.8.2] - 2026-08-11
+
+### Fixed
+- **Guide version-marking no longer locks in the implicit mode.** When the recurring guide marks a new version as seen, Selesai no longer writes the fallback `compact` mode into `settings.json` as if it were a user choice. An explicit `full`, `compact`, or `off` mode is still preserved across version-only writes, so the guide keeps following the current default until you choose otherwise.
+
 ## [0.8.1] - 2026-08-11
 
 ### Fixed

package/dist/extensions/pi-powerline-footer/CHANGELOG.md

@@ -3,6 +3,7 @@
 ## [Unreleased]
 
 ### Fixed
+- **Guide version-marking never persists an implicit mode** — `markGuideVersionSeen` (version-only writes) preserves an explicit user mode but never writes the fallback default as a user choice, so the guide keeps following the current default instead of locking in `compact`.
 - **Guide defaults to compact mode** — When `selesaiGuide.mode` is unset, the recurring guide opens in compact mode instead of the full tour. Explicit `full`, `compact`, or `off` settings are still honored.
 
 ### Changed

package/dist/extensions/pi-powerline-footer/guide.ts

@@ -200,9 +200,17 @@ export function saveGuidePreferences(
   if (!settings) return false;
 
   const current = getGuidePreferences(settings);
-  const next: Record<string, unknown> = {
-    mode: update.mode ?? current.mode,
-  };
+  const raw = isRecord(settings) && isRecord(settings.selesaiGuide)
+    ? settings.selesaiGuide
+    : {};
+  const next: Record<string, unknown> = {};
+  if (update.mode !== undefined) {
+    next.mode = update.mode;
+  } else if (typeof raw.mode === "string") {
+    // Version-only writes (markGuideVersionSeen) must preserve an explicit user
+    // mode but never persist the fallback default as a user choice.
+    next.mode = raw.mode;
+  }
   const lastSeenVersion = update.lastSeenVersion === null
     ? undefined
     : update.lastSeenVersion ?? current.lastSeenVersion;

package/dist/extensions/pi-powerline-footer/tests/guide.test.ts

@@ -10,6 +10,7 @@ import {
   getGuideFeatureLines,
   getGuidePreferences,
   getNewGuideFeatures,
+  markGuideVersionSeen,
   resolveGuideDisplayMode,
   saveGuidePreferences,
   type GuideFeature,
@@ -99,6 +100,28 @@ test("guide dismissal persists only the mode and version marker", () => {
   }
 });
 
+test("version marking never persists an implicit guide mode", () => {
+  const dir = mkdtempSync(join(tmpdir(), "selesai-guide-"));
+  const settingsPath = join(dir, "settings.json");
+
+  try {
+    // markGuideVersionSeen writes only the version marker; the mode stays
+    // unset so the default (compact) applies instead of being locked in.
+    assert.equal(markGuideVersionSeen("0.5.3", settingsPath), true);
+    const settings = JSON.parse(readFileSync(settingsPath, "utf8")) as Record<string, unknown>;
+    assert.deepEqual(settings.selesaiGuide, { lastSeenVersion: "0.5.3" });
+    assert.equal(getGuidePreferences(settings).mode, "compact");
+
+    // An explicitly chosen mode is preserved across version-only writes.
+    assert.equal(saveGuidePreferences({ mode: "off" }, settingsPath), true);
+    assert.equal(saveGuidePreferences({ lastSeenVersion: "0.6.0" }, settingsPath), true);
+    const after = JSON.parse(readFileSync(settingsPath, "utf8")) as Record<string, unknown>;
+    assert.deepEqual(after.selesaiGuide, { mode: "off", lastSeenVersion: "0.6.0" });
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
 test("invalid persisted guide settings fall back to the compact guide", () => {
   assert.deepEqual(getGuidePreferences({ selesaiGuide: { mode: "unexpected", lastSeenVersion: 42 } }), {
     mode: "compact",

package/dist/extensions/pi-subagents/package-lock.json

@@ -20,7 +20,7 @@
         "@earendil-works/pi-agent-core": "0.81.0",
         "@earendil-works/pi-ai": "0.81.0",
         "@earendil-works/pi-tui": "0.81.0",
-        "@selesai/code": "0.8.1",
+        "@selesai/code": "0.8.2",
         "@types/node": "24.13.3",
         "typescript": "5.9.3"
       },
@@ -47,7 +47,7 @@
     },
     "../../..": {
       "name": "@selesai/code",
-      "version": "0.8.1",
+      "version": "0.8.2",
       "dev": true,
       "dependencies": {
         "@earendil-works/pi-agent-core": "0.83.0",

package/dist/extensions/pi-subagents/package.json

@@ -97,7 +97,7 @@
   "devDependencies": {
     "@earendil-works/pi-agent-core": "0.81.0",
     "@earendil-works/pi-ai": "0.81.0",
-    "@selesai/code": "0.8.1",
+    "@selesai/code": "0.8.2",
     "@earendil-works/pi-tui": "0.81.0",
     "@types/node": "24.13.3",
     "typescript": "5.9.3"

package/dist/extensions/pi-subagents/test/unit/package-manifest.test.ts

@@ -26,7 +26,7 @@ const expectedHostPeerRanges = {
 const expectedHostDevVersions = {
 	"@earendil-works/pi-agent-core": "0.81.0",
 	"@earendil-works/pi-ai": "0.81.0",
-	"@selesai/code": "0.8.1",
+	"@selesai/code": "0.8.2",
 	"@earendil-works/pi-tui": "0.81.0",
 } satisfies Record<(typeof hostPeerPackages)[number], string>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@selesai/code",
-	"version": "0.8.1",
+	"version": "0.8.2",
 	"description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
 	"type": "module",
 	"repository": {