sideby 0.16.0 → 0.16.1

package/dist/build.json

@@ -1 +1 @@
-{"id":"20261017T131419-98017e"}
+{"id":"20261017T135126-a0a3cf"}

package/dist/src/cli/commands.js

@@ -1419,9 +1419,12 @@ export async function cmdLocal(a, io) {
             switched: r.ok,
             message: r.message,
             restartedPanel: r.restartedPanel,
+            ...(r.skillSynced === undefined ? {} : { skillSynced: r.skillSynced }),
         });
     else if (r.ok) {
         io.out(`${c.green('✓')} ${r.message}.`);
+        if (r.skillSynced === false)
+            io.err(c.yellow('The sideby skill was not brought along; run `sideby update` to see why.'));
         if (r.restartedPanel)
             io.out(c.dim('The background panel restarted with it; open panels reload by themselves.'));
     }

package/dist/src/cli/json-schemas.js

@@ -351,6 +351,9 @@ export const OUTPUT_SCHEMAS = {
         blocked: Type.Optional(Type.String({ description: 'Why the switch cannot run, with what to do.' })),
         message: Type.Optional(Str),
         restartedPanel: Type.Optional(Type.Boolean()),
+        skillSynced: Type.Optional(Type.Boolean({
+            description: 'Back on npm, `sideby update --yes` brought the sideby skill to that version (true) or failed (false).',
+        })),
     }, { title: 'sideby local --json' }),
     list: Type.Object({
         schemaVersion: Version,

package/dist/src/core/local-build.d.ts

@@ -49,6 +49,13 @@ export interface SwitchResult {
     /** True when it already ran `to`, and nothing changed. */
     unchanged?: boolean;
     restartedPanel: boolean;
+    /**
+     * Back on npm, `sideby update --yes` of the npm code brought the skill agents read to its version (true), or that
+     * failed (false); absent for a switch to the Local Build, which has no skill of its own to bring.
+     */
+    skillSynced?: boolean;
+    /** With `skillSync: 'background'`: that `sideby update --yes` started on its own and is not waited for. */
+    skillSyncStarted?: boolean;
     /** Another install held the lock; nothing ran. */
     busy?: boolean;
 }
@@ -60,4 +67,9 @@ export interface SwitchResult {
 export declare function switchLocal(paths: Paths, d: LocalDirs, to: LocalTarget, env: Env, opts?: {
     panelPort?: () => Promise<number | null>;
     onOutput?: (text: string) => void;
+    /**
+     * Back on npm, wait for the skill (a terminal shows its progress) or start it on its own: it fetches from the
+     * network and can take minutes, longer than a Portal waits for an answer (`background`, the Panel).
+     */
+    skillSync?: 'wait' | 'background';
 }): Promise<SwitchResult>;

package/dist/src/core/local-build.js

@@ -5,7 +5,7 @@
 import { lstat, mkdir, readFile, readlink, rename, rm, symlink } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { dirname, join, relative } from 'node:path';
-import { compareVersions, fetchLatest, restartPanelByName, runProgram, takeInstallLock } from './update.js';
+import { compareVersions, fetchLatest, restartPanelByName, runProgram, startDetached, takeInstallLock, } from './update.js';
 import { parseLocalBuild } from './version.js';
 const BIN = 'dist/src/cli/main.js';
 export const pkgDir = (d) => join(d.dev, 'pkg');
@@ -185,5 +185,21 @@ export async function switchLocal(paths, d, to, env, opts = {}) {
     }
     const port = opts.panelPort ? await opts.panelPort().catch(() => null) : null;
     const restartedPanel = port !== null && (await restartPanelByName(env, port));
-    return { ok: true, message, running: to, restartedPanel };
+    if (to === 'local')
+        return { ok: true, message, running: to, restartedPanel };
+    // The skill is part of the version (spec §3.23): the npm code updates it as `sideby update --yes` does for anyone,
+    // by name so the new code runs, after the lock above is free. A failure keeps the switch.
+    if (opts.skillSync === 'background')
+        return {
+            ok: true,
+            message,
+            running: to,
+            restartedPanel,
+            skillSyncStarted: await startDetached('sideby', ['update', '--yes'], env),
+        };
+    const u = await runProgram('sideby', ['update', '--yes'], {
+        env,
+        ...(opts.onOutput ? { onOutput: opts.onOutput } : {}),
+    }).catch(() => ({ code: 1, output: '' }));
+    return { ok: true, message, running: to, restartedPanel, skillSynced: u.code === 0 };
 }

package/dist/src/core/update.d.ts

@@ -66,6 +66,8 @@ export interface InstallMethod {
     /** npm only: the prefix whose `lib/node_modules` holds sideby. */
     prefix?: string;
 }
+/** Whether a Linux `/proc/<pid>/stat` line is of a zombie: the state after the parenthesised command name is `Z`. */
+export declare function isZombieStat(stat: string): boolean;
 /** Swapped in tests through `bindUpdateDeps`; the real machine otherwise. */
 export interface UpdateDeps {
     fetch: typeof fetch;
@@ -84,6 +86,8 @@ export interface UpdateDeps {
     }>;
     /** Starts `sideby ui --background --no-open --port <port>` from the newly installed code, detached; false when it could not start. */
     restartPanel: (env: Env, port: number) => Promise<boolean>;
+    /** Starts a program detached, nothing kept of its output; false when it could not start. */
+    startDetached: (file: string, args: readonly string[], env: Env) => Promise<boolean>;
     /** Whether `sideby app install` put a desktop app in this home (its files carry the app marker). */
     appInstalled: (home: string, env: Env) => Promise<boolean>;
     /** Runs `sideby app install --json` from the newly installed code and waits; false when it failed. */
@@ -95,6 +99,8 @@ export declare function bindUpdateDeps(deps: Partial<UpdateDeps>): () => void;
 export declare const runProgram: UpdateDeps['exec'];
 /** Starts the background Panel again from the code `sideby` now names; see `UpdateDeps.restartPanel`. */
 export declare const restartPanelByName: (env: Env, port: number) => Promise<boolean>;
+/** Starts a program detached through the swappable machine; see `UpdateDeps.startDetached`. */
+export declare const startDetached: (file: string, args: readonly string[], env: Env) => Promise<boolean>;
 /** The lock every install shares (`update-install.lock`), so a Local Build switch never races an Update. */
 export declare const takeInstallLock: (paths: Paths) => Promise<(() => Promise<void>) | null>;
 /** -1, 0 or 1 like a sort comparator; a prerelease sorts before its release. Null when either is not a version. */

package/dist/src/core/update.js

@@ -2,6 +2,7 @@
 // only network request sideby makes on its own: one GET for the `latest` dist-tag, carrying nothing about the user.
 // Everything it learns goes to one state file shared by the CLI and every Panel.
 import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
 import { access, constants, mkdir, open, readdir, readFile, realpath, rm, stat } from 'node:fs/promises';
 import { dirname, join, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -17,6 +18,10 @@ export const RETRY_INTERVAL_MS = 60 * 60 * 1000;
 export const AUTO_RETRY_MS = 24 * 60 * 60 * 1000;
 const FETCH_TIMEOUT_MS = 5000;
 export const RELEASE_NOTES = (v) => `https://github.com/Adonis0123/sideby/releases/tag/v${v}`;
+/** Whether a Linux `/proc/<pid>/stat` line is of a zombie: the state after the parenthesised command name is `Z`. */
+export function isZombieStat(stat) {
+    return /\)\s+Z\s/.test(stat.slice(stat.lastIndexOf(')')));
+}
 /** The folder of the sideby package this module belongs to: two levels above src/, three above dist/src/. */
 async function ownPackageDir() {
     const here = dirname(fileURLToPath(import.meta.url));
@@ -41,11 +46,18 @@ const realDeps = {
     alive(pid) {
         try {
             process.kill(pid, 0);
-            return true;
         }
         catch (err) {
             return err.code === 'EPERM';
         }
+        // An exited process nobody waited for (its parent went first) still answers signal 0 on Linux: a zombie holds
+        // no lock and runs no session.
+        try {
+            return !isZombieStat(readFileSync(`/proc/${pid}/stat`, 'utf8'));
+        }
+        catch {
+            return true; // no /proc (macOS): signal 0 is the answer
+        }
     },
     exec: (file, args, opts) => new Promise((resolve) => {
         let output = '';
@@ -77,6 +89,14 @@ const realDeps = {
         });
         child.once('error', () => resolve(false));
     }),
+    startDetached: (file, args, env) => new Promise((resolve) => {
+        const child = spawn(file, args, { env: env, detached: true, stdio: 'ignore' });
+        child.once('spawn', () => {
+            child.unref();
+            resolve(true);
+        });
+        child.once('error', () => resolve(false));
+    }),
     appInstalled: async (home, env) => {
         const { appInstalled } = await import('../desktop/app.js');
         return appInstalled({ home, env, platform: process.platform });
@@ -108,6 +128,10 @@ export const runProgram = (file, args, opts) => deps().exec(file, args, opts);
 export const restartPanelByName = (env, port) => deps()
     .restartPanel(env, port)
     .catch(() => false);
+/** Starts a program detached through the swappable machine; see `UpdateDeps.startDetached`. */
+export const startDetached = (file, args, env) => deps()
+    .startDetached(file, args, env)
+    .catch(() => false);
 /** The lock every install shares (`update-install.lock`), so a Local Build switch never races an Update. */
 export const takeInstallLock = (paths) => takeLock(paths, 'update-install.lock').catch(() => null);
 // Build metadata is limited to what semver allows, so a version never carries a terminal escape into the notice.

package/dist/src/panel/handler.js

@@ -745,8 +745,10 @@ export function createPanelHandler(opts) {
                 if (!optBool(body, 'confirm'))
                     return { ...(await lb.localStatus(d)), to, switched: false };
                 const { backgroundPanelPort } = await import('./background.js');
+                // The skill fetch can outlast what a Portal waits for: it runs on its own, and the answer comes at once.
                 const r = await lb.switchLocal(rt.paths, d, to, rt.env, {
                     panelPort: () => backgroundPanelPort(rt.paths),
+                    skillSync: 'background',
                 });
                 if (!r.ok)
                     throw new UserError(r.message);
@@ -756,6 +758,7 @@ export function createPanelHandler(opts) {
                     switched: !r.unchanged,
                     message: r.message,
                     restartedPanel: r.restartedPanel,
+                    ...(r.skillSyncStarted === undefined ? {} : { skillSyncStarted: r.skillSyncStarted }),
                 };
             },
         },

package/dist/src/panel/i18n.d.ts

@@ -31,6 +31,9 @@ declare const en: {
     'upd.local': string;
     'upd.localDirty': string;
     'loc.toNpm': string;
+    'loc.toNpmV': string;
+    'upd.localSwitch': string;
+    'upd.localManual': string;
     'loc.toNpmHint': string;
     'loc.toLocal': string;
     'loc.toLocalHint': string;

package/dist/src/panel/i18n.js

@@ -33,6 +33,9 @@ const en = {
     'upd.local': 'Local build from this checkout, built {at}.',
     'upd.localDirty': 'Local build from this checkout, with changes not committed yet, built {at}.',
     'loc.toNpm': 'Switch to the release',
+    'loc.toNpmV': 'Switch to the release {v}',
+    'upd.localSwitch': 'You are running a local build, and sideby {v} is out. Switching to the release puts it in place, and the skill comes along.',
+    'upd.localManual': 'Or run this in the sideby checkout:',
     'loc.toNpmHint': 'Go back to the version published on npm; switch here again to come back.',
     'loc.toLocal': 'Switch to the local build',
     'loc.toLocalHint': 'A local build is kept: {b}, built {at}. It is not rebuilt; pnpm local in the checkout builds a new one.',
@@ -782,6 +785,9 @@ const zh = {
     'upd.local': '本地构建，来自仓库代码，构建于 {at}。',
     'upd.localDirty': '本地构建，含还没提交的改动，构建于 {at}。',
     'loc.toNpm': '切换到正式版',
+    'loc.toNpmV': '切换到正式版 {v}',
+    'upd.localSwitch': '你在用本地构建，sideby {v} 已发布。切换到正式版就会用上它，skill 也会一起同步。',
+    'upd.localManual': '也可以在 sideby 仓库里运行：',
     'loc.toNpmHint': '回到 npm 上发布的版本，之后可以在这里再切回来。',
     'loc.toLocal': '切换到本地构建',
     'loc.toLocalHint': '本机留着一份本地构建：{b}，构建于 {at}。切换不会重新构建；要新的就在仓库里运行 pnpm local。',

package/dist/src/panel/page-logic.d.ts

@@ -177,6 +177,24 @@ export declare function panelHint(hint: string, fixable: boolean, action: string
  * Whether the Panel fixes Finding `f` with a button of its own: a sideby skill behind this version while the
  * Update plan says sideby may update it (`skillUpdatable`). Such Findings stay out of the prompt for an AI agent.
  */
+/**
+ * A Local Build the Panel can leave for npm itself (ADR-0024): the global `sideby` still runs it and the Panel may
+ * write. Then switching to the release is the update, offered as a button instead of the `pnpm local --off` command.
+ */
+export declare function canLeaveLocal(u: {
+    localSwitch?: {
+        running: string | null;
+    };
+} | null, readOnly: boolean): boolean;
+/**
+ * What a failed Local Build switch request means (ADR-0024): a lost connection (a background Panel restarting) or a
+ * Portal's 5xx (it moved to the new code mid-request) may follow a switch that happened, so the state decides;
+ * anything else is the server saying it did not switch.
+ */
+export declare function switchFailure(e: {
+    network?: boolean;
+    status?: number;
+}): 'wait' | 'check' | 'fail';
 export declare function panelFixes(f: {
     code?: string;
 }, skillUpdatable: boolean): boolean;

package/dist/src/panel/page-logic.js

@@ -361,6 +361,23 @@ export function panelHint(hint, fixable, action) {
  * Whether the Panel fixes Finding `f` with a button of its own: a sideby skill behind this version while the
  * Update plan says sideby may update it (`skillUpdatable`). Such Findings stay out of the prompt for an AI agent.
  */
+/**
+ * A Local Build the Panel can leave for npm itself (ADR-0024): the global `sideby` still runs it and the Panel may
+ * write. Then switching to the release is the update, offered as a button instead of the `pnpm local --off` command.
+ */
+export function canLeaveLocal(u, readOnly) {
+    return !readOnly && !!u?.localSwitch && u.localSwitch.running === 'local';
+}
+/**
+ * What a failed Local Build switch request means (ADR-0024): a lost connection (a background Panel restarting) or a
+ * Portal's 5xx (it moved to the new code mid-request) may follow a switch that happened, so the state decides;
+ * anything else is the server saying it did not switch.
+ */
+export function switchFailure(e) {
+    if (e.network)
+        return 'wait';
+    return (e.status ?? 0) >= 500 ? 'check' : 'fail';
+}
 export function panelFixes(f, skillUpdatable) {
     return skillUpdatable && f.code === 'skill.outdated';
 }

package/dist/src/panel/page-script.js

@@ -1,6 +1,6 @@
 // The Panel page's inline script. Plain browser JavaScript in a string (no template literals inside, so String.raw
 // keeps it verbatim); the pure helpers from page-logic.ts are prepended so the tested code is the code that runs.
-import { aliasArgsOf, aliasIssue, attentionReasons, attentionWhy, cacheHitRate, fixPrompt, formatDuration, handoffChangeOf, handoffHintAccount, inDisplayOrder, loginClusters, loginKey, maskEmail, matchesQuery, mergeDaily, newAccountDir, nextReset, panelFixes, panelHint, panelLang, passedWindow, pinnedIn, quotaPressure, remoteControlSummary, remoteControlTodo, reorder, sortAccounts, suggestAlias, suggestName, updatedAge, windowState, withPinned, } from './page-logic.js';
+import { aliasArgsOf, aliasIssue, attentionReasons, attentionWhy, cacheHitRate, canLeaveLocal, fixPrompt, formatDuration, handoffChangeOf, handoffHintAccount, inDisplayOrder, loginClusters, loginKey, maskEmail, matchesQuery, mergeDaily, newAccountDir, nextReset, panelFixes, panelHint, panelLang, passedWindow, pinnedIn, quotaPressure, remoteControlSummary, remoteControlTodo, reorder, sortAccounts, suggestAlias, suggestName, switchFailure, updatedAge, windowState, withPinned, } from './page-logic.js';
 const LOGIC = [
     aliasArgsOf,
     aliasIssue,
@@ -19,6 +19,8 @@ const LOGIC = [
     mergeDaily,
     newAccountDir,
     nextReset,
+    canLeaveLocal,
+    switchFailure,
     panelFixes,
     panelHint,
     panelLang,
@@ -3571,6 +3573,8 @@ const MAIN = String.raw `
   function updState() { return BOOT.updates && S.state ? S.state.update || null : null }
   // The skill agents read is part of the version (spec §3.23): behind a current CLI it is the one thing to update.
   const isLocal = (u) => u.method.kind === 'local'
+  // A Local Build the Panel can leave for npm itself (ADR-0024): then that switch is the update, not a command.
+  const leavesLocal = (u) => canLeaveLocal(u, BOOT.readOnly)
   const skillOld = (u) => !!(u && !u.available && !isLocal(u) && u.skillUpdate && u.skillUpdate.outdated)
   const skillDue = (u) => skillOld(u) && u.skillUpdate.canRun
   function skillFor(u) {
@@ -3690,7 +3694,8 @@ const MAIN = String.raw `
     if (u && u.available) {
       kids.push(h('p', { class: 'small' }, t('upd.available', { v: u.latest }), ' ',
         h('a', { href: u.releaseNotes, target: '_blank', rel: 'noopener noreferrer' }, t('upd.notes'))))
-      kids.push(h('div', { class: 'popover-actions' }, h('button', { class: 'btn btn-sm btn-primary', type: 'button', onclick: toDialog }, t('upd.open'))))
+      if (!(isLocal(u) && leavesLocal(u)))
+        kids.push(h('div', { class: 'popover-actions' }, h('button', { class: 'btn btn-sm btn-primary', type: 'button', onclick: toDialog }, t('upd.open'))))
     } else if (skillOld(u)) {
       kids.push(h('p', { class: 'small' }, t('upd.skillBehind', { s: skillFor(u) })))
       kids.push(h('div', { class: 'popover-actions' }, h('button', { class: 'btn btn-sm' + (skillDue(u) ? ' btn-primary' : ''), type: 'button', onclick: toDialog }, t('upd.open'))))
@@ -3722,30 +3727,42 @@ const MAIN = String.raw `
       kids.push(h('p', { class: 'small' }, t('loc.stuck')))
       kids.push(h('div', { class: 'popover-actions' }, h('button', { class: 'btn btn-sm btn-primary', type: 'button', onclick: () => location.reload() }, icon('refresh'), t('loc.reload'))))
     } else {
-      kids.push(h('div', { class: 'popover-actions' }, h('button', { class: 'btn btn-sm', type: 'button', disabled: vs.busy, 'aria-busy': vs.busy ? 'true' : null, onclick: () => localSwitchTo(toNpm ? 'npm' : 'local') },
-        vs.busy ? spinner() : icon('swap'), vs.busy ? t('loc.switching') : t(toNpm ? 'loc.toNpm' : 'loc.toLocal'))))
+      const newer = toNpm && u.available && u.latest
+      kids.push(h('div', { class: 'popover-actions' }, h('button', { class: 'btn btn-sm' + (newer ? ' btn-primary' : ''), type: 'button', disabled: vs.busy, 'aria-busy': vs.busy ? 'true' : null, onclick: () => localSwitchTo(toNpm ? 'npm' : 'local') },
+        vs.busy ? spinner() : icon('swap'), vs.busy ? t('loc.switching') : newer ? t('loc.toNpmV', { v: u.latest }) : t(toNpm ? 'loc.toNpm' : 'loc.toLocal'))))
     }
     if (vs.error) kids.push(errorNote(vs.error, null))
     return h('div', { class: 'popover-foot' }, kids)
   }
+  function renderSwitch() {
+    renderVerPop()
+    if (dlg.kind === 'update' && up) renderUpdate()
+  }
   async function localSwitchTo(to) {
     vs.busy = true
     vs.to = to
     vs.error = null
     vs.stuck = false
-    renderVerPop()
+    renderSwitch()
     try {
       await api('/api/local', { to, confirm: true })
     } catch (e) {
-      // A background Panel restarting from the new code may drop this answer: wait for the build all the same.
-      if (!e.network) { vs.busy = false; vs.error = e; renderVerPop(); return }
+      // A background Panel restarting from the new code may drop this answer, and a Portal moving to it may answer
+      // 5xx (spec §3.23): the state then says whether the switch happened. Only a switch that did not is an error.
+      const kind = switchFailure(e)
+      if (kind === 'fail') { vs.busy = false; vs.error = e; renderSwitch(); return }
+      if (kind === 'check') {
+        await load({ silent: true })
+        const ls = updState() && updState().localSwitch
+        if (!ls || ls.running !== to) { vs.busy = false; vs.error = e; renderSwitch(); return }
+      }
     }
     vs.waitUntil = Date.now() + 20000
     localWait()
   }
   function localWait() {
     if (S.newBuild) { location.reload(); return }
-    if (Date.now() > vs.waitUntil) { vs.busy = false; vs.stuck = true; renderVerPop(); return }
+    if (Date.now() > vs.waitUntil) { vs.busy = false; vs.stuck = true; renderSwitch(); return }
     setTimeout(() => { void load({ silent: true }).then(localWait, localWait) }, 1500)
   }
   async function verPopCheck() {
@@ -3834,6 +3851,14 @@ const MAIN = String.raw `
       else body.push(...updSkill(u))
     } else if (up.skillDone && !skillOld(u)) {
       body.push(h('p', { class: 'note' }, t('upd.skillDoneOnly')))
+    } else if (u.available && isLocal(u) && (leavesLocal(u) || vs.busy || vs.stuck)) {
+      // A Local Build the Panel can leave (ADR-0024): switching to the release is the update, and brings the skill.
+      body.push(h('p', null, t('upd.localSwitch', { v: u.latest }), ' ',
+        h('a', { href: u.releaseNotes, target: '_blank', rel: 'noopener noreferrer' }, t('upd.notes'))))
+      if (vs.busy) body.push(h('p', { class: 'muted small' }, spinner(), ' ', t('upd.reloading')))
+      if (vs.stuck) body.push(h('p', { class: 'note' }, t('loc.stuck')))
+      if (vs.error) body.push(errorNote(vs.error, null))
+      body.push(updManual([h('p', { class: 'small' }, t('upd.localManual')), codeCopy(u.command)]))
     } else if (u.available && isLocal(u)) {
       // A Local Build (ADR-0024): one way back to npm, which brings the skill along.
       body.push(h('p', null, t('upd.localAvail', { v: u.latest }), ' ',
@@ -3888,7 +3913,11 @@ const MAIN = String.raw `
     if (up.error) body.push(errorNote(up.error, null))
     const foot = [h('button', { class: 'btn', type: 'button', disabled: up.busy, onclick: () => dlg.el.close() }, t('btn.close'))]
     const primary = (label, run) => h('button', { class: 'btn btn-primary', type: 'button', disabled: up.busy, 'aria-busy': up.busy ? 'true' : null, onclick: run }, up.busy ? spinner() : null, up.busy ? t('upd.updating') : label)
-    if (u.available && u.canRun && !BOOT.readOnly && !up.done) foot.push(primary(t('upd.now', { v: u.latest }), updRun))
+    if (u.available && isLocal(u) && vs.stuck) foot.push(h('button', { class: 'btn btn-primary', type: 'button', onclick: () => location.reload() }, icon('refresh'), t('loc.reload')))
+    else if (u.available && isLocal(u) && (leavesLocal(u) || vs.busy))
+      foot.push(h('button', { class: 'btn btn-primary', type: 'button', disabled: vs.busy, 'aria-busy': vs.busy ? 'true' : null, onclick: () => localSwitchTo('npm') },
+        vs.busy ? spinner() : icon('swap'), vs.busy ? t('loc.switching') : t('loc.toNpmV', { v: u.latest })))
+    else if (u.available && u.canRun && !BOOT.readOnly && !up.done) foot.push(primary(t('upd.now', { v: u.latest }), updRun))
     else if (skillDue(u) && !BOOT.readOnly && !up.done) foot.push(primary(t('upd.skillNow'), updSkillRun))
     setKids(dlg.el, dialogFrame(t('upd.title'), null, body, foot))
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sideby",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "Run work, personal and API-key accounts at the same time, without their configs drifting apart.",
   "license": "MIT",
   "author": "Adonis0123 (https://github.com/Adonis0123)",

package/schemas/local.json

@@ -98,6 +98,10 @@
     "restartedPanel": {
       "type": "boolean"
     },
+    "skillSynced": {
+      "type": "boolean",
+      "description": "Back on npm, `sideby update --yes` brought the sideby skill to that version (true) or failed (false)."
+    },
     "_notice": {
       "type": "object",
       "properties": {

package/skills/sideby/SKILL.md

@@ -2,7 +2,7 @@
 name: sideby
 description: Use when the user runs, or wants to run, several AI coding accounts (Claude Code, Codex, Grok Build, pi) side by side. Covers installing sideby and setting up a new account ("install sideby", "set up another Claude account", "add cc008", "配置一个 cc00x", "再加一个 Codex 账号"), explaining what accounts share and what stays separate ("what do my accounts share?", "这些账号共享了什么"), showing which account a session is ("show [cc001] in the status line", "加上账号标识"), seeing accounts, quota and usage, moving on when one hits its 5-hour or weekly limit, moving the current task to another account ("用 cc008 继续", "交回 cc008"), adding a short command (alias), and repairing drifted account directories (skills, hooks, rules or settings not shared, wrong symlinks, credential file permissions). Drives the `sideby` CLI with `--json`; the agent does every step except browser sign-in, filling in secrets and starting interactive sessions, which it hands to the user as one command (inside an Auto Handoff session, `sideby handoff ready --to` moves the task itself).
 metadata:
-  version: "0.16.0"
+  version: "0.16.1"
   requires:
     bins: [sideby, node]
   cliHelp: sideby --help

package/skills/sideby/references/update.md

@@ -25,5 +25,5 @@ For people who work on sideby itself. A Local Build (`pnpm local` in a sideby ch
 
 1. Run `sideby local --json`. `running` is what runs now (`local` or `npm`), `local` the kept Local Build (`version`, `commit`, `dirty`, `builtAt`), `kept` the npm version set aside.
 2. Run `sideby local off --json` (back to npm) or `sideby local on --json` (the kept Local Build). It exits `10` with the change; after their yes, add `--yes`. `on` does not rebuild: `pnpm local` in the checkout makes a new build. `blocked` (exit 1) says why it cannot and what to do.
-3. A background panel restarts by itself and open panels reload; a `sideby ui` in a terminal needs a restart.
+3. `off` brings the sideby skill to the npm version too (`skillSynced`; false means run `sideby update`). A background panel restarts by itself and open panels reload; a `sideby ui` in a terminal needs a restart.