@selesai/code 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 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
+- **Powerline guide defaults to compact mode.** When `selesaiGuide.mode` is not set, the recurring `/guide` tour now opens in compact mode instead of the full tour. An explicit `full`, `compact`, or `off` setting is still honored.
+
 ## [0.8.0] - 2026-08-11
 
 ### Added

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

@@ -2,6 +2,10 @@
 
 ## [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
 - **Upstream 0.12.3 merge (Selesai fork)** — Updated from upstream v0.5.4 to v0.12.3. Adopts the Powerline queue/inbox (`/idea`, `/ideas`, `/queue`, `/ideas next`, `/ideas issue`), compaction-aware queue delivery, `/cd` session directory switching, cost currency and subagent cost accounting, `powerline.separator`/`layout`/`placement`/`disabledSegments`/`welcome` options, git host icons, cached session token stats, strict TypeScript gate, and all upstream fixes through 0.12.3. Selesai-specific features are preserved: the fixed editor and chat scrolling, the guide overlay, the TPS tracker, session-usage accounting, and mode-aware autocomplete trigger forwarding.
 

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

@@ -149,7 +149,7 @@ export function getGuidePreferences(settings: unknown): GuidePreferences {
     : {};
 
   return {
-    mode: isGuideMode(raw.mode) ? raw.mode : "full",
+    mode: isGuideMode(raw.mode) ? raw.mode : "compact",
     lastSeenVersion: typeof raw.lastSeenVersion === "string" ? raw.lastSeenVersion : undefined,
   };
 }
@@ -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,
@@ -22,7 +23,7 @@ const features: GuideFeature[] = [
 ];
 
 
-test("guide opens fully for each real session start", () => {
+test("explicit full guide opens for each real session start", () => {
   for (const reason of ["startup", "new", "resume", "fork"]) {
     assert.equal(resolveGuideDisplayMode({ reason, hasUI: true, guideMode: "full" }), "full");
   }
@@ -35,8 +36,10 @@ test("guide dismissal and compact preferences change automatic display", () => {
   assert.equal(resolveGuideDisplayMode({ reason: "startup", hasUI: false, guideMode: "full" }), "none");
 });
 
-test("quiet startup does not suppress the default blocking guide", () => {
-  assert.equal(resolveGuideDisplayMode({ reason: "startup", hasUI: true, guideMode: "full" }), "full");
+test("guide defaults to a compact header so fixed-editor mode stays active", () => {
+  const preferences = getGuidePreferences({});
+  assert.equal(preferences.mode, "compact");
+  assert.equal(resolveGuideDisplayMode({ reason: "startup", hasUI: true, guideMode: preferences.mode }), "compact");
 });
 
 test("full and compact guide content expose README commands and examples", () => {
@@ -97,9 +100,31 @@ test("guide dismissal persists only the mode and version marker", () => {
   }
 });
 
-test("invalid persisted guide settings fall back to the full guide", () => {
+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: "full",
+    mode: "compact",
     lastSeenVersion: undefined,
   });
 });

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.0",
+        "@selesai/code": "0.8.2",
         "@types/node": "24.13.3",
         "typescript": "5.9.3"
       },
@@ -47,7 +47,7 @@
     },
     "../../..": {
       "name": "@selesai/code",
-      "version": "0.8.0",
+      "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.0",
+    "@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.0",
+	"@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.0",
+	"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": {