@hellcoder/companion 0.124.0 → 0.125.0

package/dist/assets/{sw-register-Dc72vh_Y.js → sw-register-BBun0drK.js}

@@ -1 +1 @@
-import{_ as u}from"./index-C7nK12tB.js";function w(r={}){const{immediate:i=!1,onNeedReload:d,onNeedRefresh:_,onOfflineReady:s,onRegistered:n,onRegisteredSW:o,onRegisterError:t}=r;let a,c;const l=async(e=!0)=>{await c};async function f(){if("serviceWorker"in navigator){if(a=await u(async()=>{const{Workbox:e}=await import("./workbox-window.prod.es5-BBnX5xw4.js");return{Workbox:e}},[]).then(({Workbox:e})=>new e("/sw.js",{scope:"/",type:"classic"})).catch(e=>{t==null||t(e)}),!a)return;a.addEventListener("activated",e=>{(e.isUpdate||e.isExternal)&&(d?d():window.location.reload())}),a.addEventListener("installed",e=>{e.isUpdate||s==null||s()}),a.register({immediate:i}).then(e=>{o?o("/sw.js",e):n==null||n(e)}).catch(e=>{t==null||t(e)})}}return c=f(),l}w({onRegisteredSW(r,i){i&&setInterval(()=>{i.update()},3600*1e3)},onOfflineReady(){console.log("[SW] Offline-ready: all assets precached")}});
+import{_ as u}from"./index-e4RnFbra.js";function w(r={}){const{immediate:i=!1,onNeedReload:d,onNeedRefresh:_,onOfflineReady:s,onRegistered:n,onRegisteredSW:o,onRegisterError:t}=r;let a,c;const l=async(e=!0)=>{await c};async function f(){if("serviceWorker"in navigator){if(a=await u(async()=>{const{Workbox:e}=await import("./workbox-window.prod.es5-BBnX5xw4.js");return{Workbox:e}},[]).then(({Workbox:e})=>new e("/sw.js",{scope:"/",type:"classic"})).catch(e=>{t==null||t(e)}),!a)return;a.addEventListener("activated",e=>{(e.isUpdate||e.isExternal)&&(d?d():window.location.reload())}),a.addEventListener("installed",e=>{e.isUpdate||s==null||s()}),a.register({immediate:i}).then(e=>{o?o("/sw.js",e):n==null||n(e)}).catch(e=>{t==null||t(e)})}}return c=f(),l}w({onRegisteredSW(r,i){i&&setInterval(()=>{i.update()},3600*1e3)},onOfflineReady(){console.log("[SW] Offline-ready: all assets precached")}});

package/dist/index.html

@@ -11,7 +11,7 @@
     <meta name="apple-mobile-web-app-title" content="Companion ME" />
     <meta name="theme-color" content="#d97757" />
     <title>The Companion — Moritz Edition</title>
-    <script type="module" crossorigin src="/assets/index-C7nK12tB.js"></script>
+    <script type="module" crossorigin src="/assets/index-e4RnFbra.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-OAVDFR0O.css">
   </head>
   <body class="bg-cc-bg text-cc-fg">

package/dist/sw.js

@@ -1,2 +1,2 @@
 try{self["workbox:core:7.4.0"]&&_()}catch{}const x=(a,...e)=>{let t=a;return e.length>0&&(t+=` :: ${JSON.stringify(e)}`),t},N=x;class l extends Error{constructor(e,t){const s=N(e,t);super(s),this.name=e,this.details=t}}const E=new Set,f={googleAnalytics:"googleAnalytics",precache:"precache-v2",prefix:"workbox",runtime:"runtime",suffix:typeof registration<"u"?registration.scope:""},b=a=>[f.prefix,a,f.suffix].filter(e=>e&&e.length>0).join("-"),O=a=>{for(const e of Object.keys(f))a(e)},C={updateDetails:a=>{O(e=>{typeof a[e]=="string"&&(f[e]=a[e])})},getGoogleAnalyticsName:a=>a||b(f.googleAnalytics),getPrecacheName:a=>a||b(f.precache),getPrefix:()=>f.prefix,getRuntimeName:a=>a||b(f.runtime),getSuffix:()=>f.suffix};function P(a,e){const t=new URL(a);for(const s of e)t.searchParams.delete(s);return t.href}async function I(a,e,t,s){const n=P(e.url,t);if(e.url===n)return a.match(e,s);const r=Object.assign(Object.assign({},s),{ignoreSearch:!0}),c=await a.keys(e,r);for(const i of c){const o=P(i.url,t);if(n===o)return a.match(i,s)}}let y;function M(){if(y===void 0){const a=new Response("");if("body"in a)try{new Response(a.body),y=!0}catch{y=!1}y=!1}return y}class D{constructor(){this.promise=new Promise((e,t)=>{this.resolve=e,this.reject=t})}}async function S(){for(const a of E)await a()}const W=a=>new URL(String(a),location.href).href.replace(new RegExp(`^${location.origin}`),"");function A(a){return new Promise(e=>setTimeout(e,a))}function K(a,e){const t=e();return a.waitUntil(t),t}async function q(a,e){let t=null;if(a.url&&(t=new URL(a.url).origin),t!==self.location.origin)throw new l("cross-origin-copy-response",{origin:t});const s=a.clone(),r={headers:new Headers(s.headers),status:s.status,statusText:s.statusText},c=M()?s.body:await s.blob();return new Response(c,r)}function j(){self.addEventListener("activate",()=>self.clients.claim())}try{self["workbox:precaching:7.4.0"]&&_()}catch{}const H="__WB_REVISION__";function F(a){if(!a)throw new l("add-to-cache-list-unexpected-type",{entry:a});if(typeof a=="string"){const r=new URL(a,location.href);return{cacheKey:r.href,url:r.href}}const{revision:e,url:t}=a;if(!t)throw new l("add-to-cache-list-unexpected-type",{entry:a});if(!e){const r=new URL(t,location.href);return{cacheKey:r.href,url:r.href}}const s=new URL(t,location.href),n=new URL(t,location.href);return s.searchParams.set(H,e),{cacheKey:s.href,url:n.href}}class B{constructor(){this.updatedURLs=[],this.notUpdatedURLs=[],this.handlerWillStart=async({request:e,state:t})=>{t&&(t.originalRequest=e)},this.cachedResponseWillBeUsed=async({event:e,state:t,cachedResponse:s})=>{if(e.type==="install"&&t&&t.originalRequest&&t.originalRequest instanceof Request){const n=t.originalRequest.url;s?this.notUpdatedURLs.push(n):this.updatedURLs.push(n)}return s}}}class ${constructor({precacheController:e}){this.cacheKeyWillBeUsed=async({request:t,params:s})=>{const n=(s==null?void 0:s.cacheKey)||this._precacheController.getCacheKeyForURL(t.url);return n?new Request(n,{headers:t.headers}):t},this._precacheController=e}}try{self["workbox:strategies:7.4.0"]&&_()}catch{}function m(a){return typeof a=="string"?new Request(a):a}class G{constructor(e,t){this._cacheKeys={},Object.assign(this,t),this.event=t.event,this._strategy=e,this._handlerDeferred=new D,this._extendLifetimePromises=[],this._plugins=[...e.plugins],this._pluginStateMap=new Map;for(const s of this._plugins)this._pluginStateMap.set(s,{});this.event.waitUntil(this._handlerDeferred.promise)}async fetch(e){const{event:t}=this;let s=m(e);if(s.mode==="navigate"&&t instanceof FetchEvent&&t.preloadResponse){const c=await t.preloadResponse;if(c)return c}const n=this.hasCallback("fetchDidFail")?s.clone():null;try{for(const c of this.iterateCallbacks("requestWillFetch"))s=await c({request:s.clone(),event:t})}catch(c){if(c instanceof Error)throw new l("plugin-error-request-will-fetch",{thrownErrorMessage:c.message})}const r=s.clone();try{let c;c=await fetch(s,s.mode==="navigate"?void 0:this._strategy.fetchOptions);for(const i of this.iterateCallbacks("fetchDidSucceed"))c=await i({event:t,request:r,response:c});return c}catch(c){throw n&&await this.runCallbacks("fetchDidFail",{error:c,event:t,originalRequest:n.clone(),request:r.clone()}),c}}async fetchAndCachePut(e){const t=await this.fetch(e),s=t.clone();return this.waitUntil(this.cachePut(e,s)),t}async cacheMatch(e){const t=m(e);let s;const{cacheName:n,matchOptions:r}=this._strategy,c=await this.getCacheKey(t,"read"),i=Object.assign(Object.assign({},r),{cacheName:n});s=await caches.match(c,i);for(const o of this.iterateCallbacks("cachedResponseWillBeUsed"))s=await o({cacheName:n,matchOptions:r,cachedResponse:s,request:c,event:this.event})||void 0;return s}async cachePut(e,t){const s=m(e);await A(0);const n=await this.getCacheKey(s,"write");if(!t)throw new l("cache-put-with-no-response",{url:W(n.url)});const r=await this._ensureResponseSafeToCache(t);if(!r)return!1;const{cacheName:c,matchOptions:i}=this._strategy,o=await self.caches.open(c),h=this.hasCallback("cacheDidUpdate"),p=h?await I(o,n.clone(),["__WB_REVISION__"],i):null;try{await o.put(n,h?r.clone():r)}catch(u){if(u instanceof Error)throw u.name==="QuotaExceededError"&&await S(),u}for(const u of this.iterateCallbacks("cacheDidUpdate"))await u({cacheName:c,oldResponse:p,newResponse:r.clone(),request:n,event:this.event});return!0}async getCacheKey(e,t){const s=`${e.url} | ${t}`;if(!this._cacheKeys[s]){let n=e;for(const r of this.iterateCallbacks("cacheKeyWillBeUsed"))n=m(await r({mode:t,request:n,event:this.event,params:this.params}));this._cacheKeys[s]=n}return this._cacheKeys[s]}hasCallback(e){for(const t of this._strategy.plugins)if(e in t)return!0;return!1}async runCallbacks(e,t){for(const s of this.iterateCallbacks(e))await s(t)}*iterateCallbacks(e){for(const t of this._strategy.plugins)if(typeof t[e]=="function"){const s=this._pluginStateMap.get(t);yield r=>{const c=Object.assign(Object.assign({},r),{state:s});return t[e](c)}}}waitUntil(e){return this._extendLifetimePromises.push(e),e}async doneWaiting(){for(;this._extendLifetimePromises.length;){const e=this._extendLifetimePromises.splice(0),s=(await Promise.allSettled(e)).find(n=>n.status==="rejected");if(s)throw s.reason}}destroy(){this._handlerDeferred.resolve(null)}async _ensureResponseSafeToCache(e){let t=e,s=!1;for(const n of this.iterateCallbacks("cacheWillUpdate"))if(t=await n({request:this.request,response:t,event:this.event})||void 0,s=!0,!t)break;return s||t&&t.status!==200&&(t=void 0),t}}class V{constructor(e={}){this.cacheName=C.getRuntimeName(e.cacheName),this.plugins=e.plugins||[],this.fetchOptions=e.fetchOptions,this.matchOptions=e.matchOptions}handle(e){const[t]=this.handleAll(e);return t}handleAll(e){e instanceof FetchEvent&&(e={event:e,request:e.request});const t=e.event,s=typeof e.request=="string"?new Request(e.request):e.request,n="params"in e?e.params:void 0,r=new G(this,{event:t,request:s,params:n}),c=this._getResponse(r,s,t),i=this._awaitComplete(c,r,s,t);return[c,i]}async _getResponse(e,t,s){await e.runCallbacks("handlerWillStart",{event:s,request:t});let n;try{if(n=await this._handle(t,e),!n||n.type==="error")throw new l("no-response",{url:t.url})}catch(r){if(r instanceof Error){for(const c of e.iterateCallbacks("handlerDidError"))if(n=await c({error:r,event:s,request:t}),n)break}if(!n)throw r}for(const r of e.iterateCallbacks("handlerWillRespond"))n=await r({event:s,request:t,response:n});return n}async _awaitComplete(e,t,s,n){let r,c;try{r=await e}catch{}try{await t.runCallbacks("handlerDidRespond",{event:n,request:s,response:r}),await t.doneWaiting()}catch(i){i instanceof Error&&(c=i)}if(await t.runCallbacks("handlerDidComplete",{event:n,request:s,response:r,error:c}),t.destroy(),c)throw c}}class d extends V{constructor(e={}){e.cacheName=C.getPrecacheName(e.cacheName),super(e),this._fallbackToNetwork=e.fallbackToNetwork!==!1,this.plugins.push(d.copyRedirectedCacheableResponsesPlugin)}async _handle(e,t){const s=await t.cacheMatch(e);return s||(t.event&&t.event.type==="install"?await this._handleInstall(e,t):await this._handleFetch(e,t))}async _handleFetch(e,t){let s;const n=t.params||{};if(this._fallbackToNetwork){const r=n.integrity,c=e.integrity,i=!c||c===r;s=await t.fetch(new Request(e,{integrity:e.mode!=="no-cors"?c||r:void 0})),r&&i&&e.mode!=="no-cors"&&(this._useDefaultCacheabilityPluginIfNeeded(),await t.cachePut(e,s.clone()))}else throw new l("missing-precache-entry",{cacheName:this.cacheName,url:e.url});return s}async _handleInstall(e,t){this._useDefaultCacheabilityPluginIfNeeded();const s=await t.fetch(e);if(!await t.cachePut(e,s.clone()))throw new l("bad-precaching-response",{url:e.url,status:s.status});return s}_useDefaultCacheabilityPluginIfNeeded(){let e=null,t=0;for(const[s,n]of this.plugins.entries())n!==d.copyRedirectedCacheableResponsesPlugin&&(n===d.defaultPrecacheCacheabilityPlugin&&(e=s),n.cacheWillUpdate&&t++);t===0?this.plugins.push(d.defaultPrecacheCacheabilityPlugin):t>1&&e!==null&&this.plugins.splice(e,1)}}d.defaultPrecacheCacheabilityPlugin={async cacheWillUpdate({response:a}){return!a||a.status>=400?null:a}};d.copyRedirectedCacheableResponsesPlugin={async cacheWillUpdate({response:a}){return a.redirected?await q(a):a}};class Q{constructor({cacheName:e,plugins:t=[],fallbackToNetwork:s=!0}={}){this._urlsToCacheKeys=new Map,this._urlsToCacheModes=new Map,this._cacheKeysToIntegrities=new Map,this._strategy=new d({cacheName:C.getPrecacheName(e),plugins:[...t,new $({precacheController:this})],fallbackToNetwork:s}),this.install=this.install.bind(this),this.activate=this.activate.bind(this)}get strategy(){return this._strategy}precache(e){this.addToCacheList(e),this._installAndActiveListenersAdded||(self.addEventListener("install",this.install),self.addEventListener("activate",this.activate),this._installAndActiveListenersAdded=!0)}addToCacheList(e){const t=[];for(const s of e){typeof s=="string"?t.push(s):s&&s.revision===void 0&&t.push(s.url);const{cacheKey:n,url:r}=F(s),c=typeof s!="string"&&s.revision?"reload":"default";if(this._urlsToCacheKeys.has(r)&&this._urlsToCacheKeys.get(r)!==n)throw new l("add-to-cache-list-conflicting-entries",{firstEntry:this._urlsToCacheKeys.get(r),secondEntry:n});if(typeof s!="string"&&s.integrity){if(this._cacheKeysToIntegrities.has(n)&&this._cacheKeysToIntegrities.get(n)!==s.integrity)throw new l("add-to-cache-list-conflicting-integrities",{url:r});this._cacheKeysToIntegrities.set(n,s.integrity)}if(this._urlsToCacheKeys.set(r,n),this._urlsToCacheModes.set(r,c),t.length>0){const i=`Workbox is precaching URLs without revision info: ${t.join(", ")}
-This is generally NOT safe. Learn more at https://bit.ly/wb-precache`;console.warn(i)}}}install(e){return K(e,async()=>{const t=new B;this.strategy.plugins.push(t);for(const[r,c]of this._urlsToCacheKeys){const i=this._cacheKeysToIntegrities.get(c),o=this._urlsToCacheModes.get(r),h=new Request(r,{integrity:i,cache:o,credentials:"same-origin"});await Promise.all(this.strategy.handleAll({params:{cacheKey:c},request:h,event:e}))}const{updatedURLs:s,notUpdatedURLs:n}=t;return{updatedURLs:s,notUpdatedURLs:n}})}activate(e){return K(e,async()=>{const t=await self.caches.open(this.strategy.cacheName),s=await t.keys(),n=new Set(this._urlsToCacheKeys.values()),r=[];for(const c of s)n.has(c.url)||(await t.delete(c),r.push(c.url));return{deletedURLs:r}})}getURLsToCacheKeys(){return this._urlsToCacheKeys}getCachedURLs(){return[...this._urlsToCacheKeys.keys()]}getCacheKeyForURL(e){const t=new URL(e,location.href);return this._urlsToCacheKeys.get(t.href)}getIntegrityForCacheKey(e){return this._cacheKeysToIntegrities.get(e)}async matchPrecache(e){const t=e instanceof Request?e.url:e,s=this.getCacheKeyForURL(t);if(s)return(await self.caches.open(this.strategy.cacheName)).match(s)}createHandlerBoundToURL(e){const t=this.getCacheKeyForURL(e);if(!t)throw new l("non-precached-url",{url:e});return s=>(s.request=new Request(e),s.params=Object.assign({cacheKey:t},s.params),this.strategy.handle(s))}}let U;const L=()=>(U||(U=new Q),U);try{self["workbox:routing:7.4.0"]&&_()}catch{}const v="GET",R=a=>a&&typeof a=="object"?a:{handle:a};class g{constructor(e,t,s=v){this.handler=R(t),this.match=e,this.method=s}setCatchHandler(e){this.catchHandler=R(e)}}class z extends g{constructor(e,t,s){const n=({url:r})=>{const c=e.exec(r.href);if(c&&!(r.origin!==location.origin&&c.index!==0))return c.slice(1)};super(n,t,s)}}class J{constructor(){this._routes=new Map,this._defaultHandlerMap=new Map}get routes(){return this._routes}addFetchListener(){self.addEventListener("fetch",(e=>{const{request:t}=e,s=this.handleRequest({request:t,event:e});s&&e.respondWith(s)}))}addCacheListener(){self.addEventListener("message",(e=>{if(e.data&&e.data.type==="CACHE_URLS"){const{payload:t}=e.data,s=Promise.all(t.urlsToCache.map(n=>{typeof n=="string"&&(n=[n]);const r=new Request(...n);return this.handleRequest({request:r,event:e})}));e.waitUntil(s),e.ports&&e.ports[0]&&s.then(()=>e.ports[0].postMessage(!0))}}))}handleRequest({request:e,event:t}){const s=new URL(e.url,location.href);if(!s.protocol.startsWith("http"))return;const n=s.origin===location.origin,{params:r,route:c}=this.findMatchingRoute({event:t,request:e,sameOrigin:n,url:s});let i=c&&c.handler;const o=e.method;if(!i&&this._defaultHandlerMap.has(o)&&(i=this._defaultHandlerMap.get(o)),!i)return;let h;try{h=i.handle({url:s,request:e,event:t,params:r})}catch(u){h=Promise.reject(u)}const p=c&&c.catchHandler;return h instanceof Promise&&(this._catchHandler||p)&&(h=h.catch(async u=>{if(p)try{return await p.handle({url:s,request:e,event:t,params:r})}catch(k){k instanceof Error&&(u=k)}if(this._catchHandler)return this._catchHandler.handle({url:s,request:e,event:t});throw u})),h}findMatchingRoute({url:e,sameOrigin:t,request:s,event:n}){const r=this._routes.get(s.method)||[];for(const c of r){let i;const o=c.match({url:e,sameOrigin:t,request:s,event:n});if(o)return i=o,(Array.isArray(i)&&i.length===0||o.constructor===Object&&Object.keys(o).length===0||typeof o=="boolean")&&(i=void 0),{route:c,params:i}}return{}}setDefaultHandler(e,t=v){this._defaultHandlerMap.set(t,R(e))}setCatchHandler(e){this._catchHandler=R(e)}registerRoute(e){this._routes.has(e.method)||this._routes.set(e.method,[]),this._routes.get(e.method).push(e)}unregisterRoute(e){if(!this._routes.has(e.method))throw new l("unregister-route-but-not-found-with-method",{method:e.method});const t=this._routes.get(e.method).indexOf(e);if(t>-1)this._routes.get(e.method).splice(t,1);else throw new l("unregister-route-route-not-registered")}}let w;const X=()=>(w||(w=new J,w.addFetchListener(),w.addCacheListener()),w);function T(a,e,t){let s;if(typeof a=="string"){const r=new URL(a,location.href),c=({url:i})=>i.href===r.href;s=new g(c,e,t)}else if(a instanceof RegExp)s=new z(a,e,t);else if(typeof a=="function")s=new g(a,e,t);else if(a instanceof g)s=a;else throw new l("unsupported-route-type",{moduleName:"workbox-routing",funcName:"registerRoute",paramName:"capture"});return X().registerRoute(s),s}function Y(a,e=[]){for(const t of[...a.searchParams.keys()])e.some(s=>s.test(t))&&a.searchParams.delete(t);return a}function*Z(a,{ignoreURLParametersMatching:e=[/^utm_/,/^fbclid$/],directoryIndex:t="index.html",cleanURLs:s=!0,urlManipulation:n}={}){const r=new URL(a,location.href);r.hash="",yield r.href;const c=Y(r,e);if(yield c.href,t&&c.pathname.endsWith("/")){const i=new URL(c.href);i.pathname+=t,yield i.href}if(s){const i=new URL(c.href);i.pathname+=".html",yield i.href}if(n){const i=n({url:r});for(const o of i)yield o.href}}class ee extends g{constructor(e,t){const s=({request:n})=>{const r=e.getURLsToCacheKeys();for(const c of Z(n.url,t)){const i=r.get(c);if(i){const o=e.getIntegrityForCacheKey(i);return{cacheKey:i,integrity:o}}}};super(s,e.strategy)}}function te(a){const e=L(),t=new ee(e,a);T(t)}const se="-precache-",ae=async(a,e=se)=>{const s=(await self.caches.keys()).filter(n=>n.includes(e)&&n.includes(self.registration.scope)&&n!==a);return await Promise.all(s.map(n=>self.caches.delete(n))),s};function ne(){self.addEventListener("activate",(a=>{const e=C.getPrecacheName();a.waitUntil(ae(e).then(t=>{}))}))}function re(a){return L().createHandlerBoundToURL(a)}function ce(a){L().precache(a)}function ie(a,e){ce(a),te(e)}class oe extends g{constructor(e,{allowlist:t=[/./],denylist:s=[]}={}){super(n=>this._match(n),e),this._allowlist=t,this._denylist=s}_match({url:e,request:t}){if(t&&t.mode!=="navigate")return!1;const s=e.pathname+e.search;for(const n of this._denylist)if(n.test(s))return!1;return!!this._allowlist.some(n=>n.test(s))}}self.skipWaiting();j();ie([{"revision":"fab346dacb0b9b9af12554e9a59f004d","url":"logo.svg"},{"revision":"623840baec64a3438663496bb1050d30","url":"logo-docker.svg"},{"revision":"c5c8611b432190ec28522f1a2dfcbb7f","url":"logo-codex.svg"},{"revision":"54558a709a65caff714f71ea6125911d","url":"index.html"},{"revision":"1421e9c6cad8218ef5689b85034d3a95","url":"icon-512.png"},{"revision":"b96da5a0b6636012517f54b0e69c304d","url":"icon-192.png"},{"revision":"c64ca8ae8596d4ffe13d0f591beb2274","url":"favicon.svg"},{"revision":"6481face04bd08e6f0bfc2a633840b57","url":"apple-touch-icon.png"},{"revision":"83304194a3c8be2b5b61242eeb1c1046","url":"fonts/MesloLGSNerdFontMono-Regular.woff2"},{"revision":"60fafe18cbcb717c51cdabf87f9490f0","url":"fonts/MesloLGSNerdFontMono-Bold.woff2"},{"revision":null,"url":"assets/workbox-window.prod.es5-BBnX5xw4.js"},{"revision":null,"url":"assets/sw-register-Dc72vh_Y.js"},{"revision":null,"url":"assets/index-OAVDFR0O.css"},{"revision":null,"url":"assets/index-C7nK12tB.js"},{"revision":null,"url":"assets/TailscalePage-DFRiFKcb.js"},{"revision":null,"url":"assets/SettingsPage-BZ2fBrHD.js"},{"revision":null,"url":"assets/SandboxManager-C3tFkiWz.js"},{"revision":null,"url":"assets/RunsPage-B7xru-Xy.js"},{"revision":null,"url":"assets/PromptsPage-CzTs1_Se.js"},{"revision":null,"url":"assets/Playground-CvoHRMBd.js"},{"revision":null,"url":"assets/MagicUIView-C0aiMTet.js"},{"revision":null,"url":"assets/MagicUIDashboard-Cl18AKjV.js"},{"revision":null,"url":"assets/LinearSettingsPage-DDHFHt7j.js"},{"revision":null,"url":"assets/LinearOAuthSettingsPage-_eAbciJN.js"},{"revision":null,"url":"assets/IntegrationsPage-C3aW9cDI.js"},{"revision":null,"url":"assets/DashboardPage-V77HIt8S.js"},{"revision":null,"url":"assets/CronManager-Bq2lOMbZ.js"},{"revision":null,"url":"assets/AgentsPage-Byq8wvdn.js"}]);ne();T(new oe(re("index.html"),{denylist:[/^\/api/,/^\/ws/]}));
+This is generally NOT safe. Learn more at https://bit.ly/wb-precache`;console.warn(i)}}}install(e){return K(e,async()=>{const t=new B;this.strategy.plugins.push(t);for(const[r,c]of this._urlsToCacheKeys){const i=this._cacheKeysToIntegrities.get(c),o=this._urlsToCacheModes.get(r),h=new Request(r,{integrity:i,cache:o,credentials:"same-origin"});await Promise.all(this.strategy.handleAll({params:{cacheKey:c},request:h,event:e}))}const{updatedURLs:s,notUpdatedURLs:n}=t;return{updatedURLs:s,notUpdatedURLs:n}})}activate(e){return K(e,async()=>{const t=await self.caches.open(this.strategy.cacheName),s=await t.keys(),n=new Set(this._urlsToCacheKeys.values()),r=[];for(const c of s)n.has(c.url)||(await t.delete(c),r.push(c.url));return{deletedURLs:r}})}getURLsToCacheKeys(){return this._urlsToCacheKeys}getCachedURLs(){return[...this._urlsToCacheKeys.keys()]}getCacheKeyForURL(e){const t=new URL(e,location.href);return this._urlsToCacheKeys.get(t.href)}getIntegrityForCacheKey(e){return this._cacheKeysToIntegrities.get(e)}async matchPrecache(e){const t=e instanceof Request?e.url:e,s=this.getCacheKeyForURL(t);if(s)return(await self.caches.open(this.strategy.cacheName)).match(s)}createHandlerBoundToURL(e){const t=this.getCacheKeyForURL(e);if(!t)throw new l("non-precached-url",{url:e});return s=>(s.request=new Request(e),s.params=Object.assign({cacheKey:t},s.params),this.strategy.handle(s))}}let U;const L=()=>(U||(U=new Q),U);try{self["workbox:routing:7.4.0"]&&_()}catch{}const v="GET",R=a=>a&&typeof a=="object"?a:{handle:a};class g{constructor(e,t,s=v){this.handler=R(t),this.match=e,this.method=s}setCatchHandler(e){this.catchHandler=R(e)}}class z extends g{constructor(e,t,s){const n=({url:r})=>{const c=e.exec(r.href);if(c&&!(r.origin!==location.origin&&c.index!==0))return c.slice(1)};super(n,t,s)}}class J{constructor(){this._routes=new Map,this._defaultHandlerMap=new Map}get routes(){return this._routes}addFetchListener(){self.addEventListener("fetch",(e=>{const{request:t}=e,s=this.handleRequest({request:t,event:e});s&&e.respondWith(s)}))}addCacheListener(){self.addEventListener("message",(e=>{if(e.data&&e.data.type==="CACHE_URLS"){const{payload:t}=e.data,s=Promise.all(t.urlsToCache.map(n=>{typeof n=="string"&&(n=[n]);const r=new Request(...n);return this.handleRequest({request:r,event:e})}));e.waitUntil(s),e.ports&&e.ports[0]&&s.then(()=>e.ports[0].postMessage(!0))}}))}handleRequest({request:e,event:t}){const s=new URL(e.url,location.href);if(!s.protocol.startsWith("http"))return;const n=s.origin===location.origin,{params:r,route:c}=this.findMatchingRoute({event:t,request:e,sameOrigin:n,url:s});let i=c&&c.handler;const o=e.method;if(!i&&this._defaultHandlerMap.has(o)&&(i=this._defaultHandlerMap.get(o)),!i)return;let h;try{h=i.handle({url:s,request:e,event:t,params:r})}catch(u){h=Promise.reject(u)}const p=c&&c.catchHandler;return h instanceof Promise&&(this._catchHandler||p)&&(h=h.catch(async u=>{if(p)try{return await p.handle({url:s,request:e,event:t,params:r})}catch(k){k instanceof Error&&(u=k)}if(this._catchHandler)return this._catchHandler.handle({url:s,request:e,event:t});throw u})),h}findMatchingRoute({url:e,sameOrigin:t,request:s,event:n}){const r=this._routes.get(s.method)||[];for(const c of r){let i;const o=c.match({url:e,sameOrigin:t,request:s,event:n});if(o)return i=o,(Array.isArray(i)&&i.length===0||o.constructor===Object&&Object.keys(o).length===0||typeof o=="boolean")&&(i=void 0),{route:c,params:i}}return{}}setDefaultHandler(e,t=v){this._defaultHandlerMap.set(t,R(e))}setCatchHandler(e){this._catchHandler=R(e)}registerRoute(e){this._routes.has(e.method)||this._routes.set(e.method,[]),this._routes.get(e.method).push(e)}unregisterRoute(e){if(!this._routes.has(e.method))throw new l("unregister-route-but-not-found-with-method",{method:e.method});const t=this._routes.get(e.method).indexOf(e);if(t>-1)this._routes.get(e.method).splice(t,1);else throw new l("unregister-route-route-not-registered")}}let w;const X=()=>(w||(w=new J,w.addFetchListener(),w.addCacheListener()),w);function T(a,e,t){let s;if(typeof a=="string"){const r=new URL(a,location.href),c=({url:i})=>i.href===r.href;s=new g(c,e,t)}else if(a instanceof RegExp)s=new z(a,e,t);else if(typeof a=="function")s=new g(a,e,t);else if(a instanceof g)s=a;else throw new l("unsupported-route-type",{moduleName:"workbox-routing",funcName:"registerRoute",paramName:"capture"});return X().registerRoute(s),s}function Y(a,e=[]){for(const t of[...a.searchParams.keys()])e.some(s=>s.test(t))&&a.searchParams.delete(t);return a}function*Z(a,{ignoreURLParametersMatching:e=[/^utm_/,/^fbclid$/],directoryIndex:t="index.html",cleanURLs:s=!0,urlManipulation:n}={}){const r=new URL(a,location.href);r.hash="",yield r.href;const c=Y(r,e);if(yield c.href,t&&c.pathname.endsWith("/")){const i=new URL(c.href);i.pathname+=t,yield i.href}if(s){const i=new URL(c.href);i.pathname+=".html",yield i.href}if(n){const i=n({url:r});for(const o of i)yield o.href}}class ee extends g{constructor(e,t){const s=({request:n})=>{const r=e.getURLsToCacheKeys();for(const c of Z(n.url,t)){const i=r.get(c);if(i){const o=e.getIntegrityForCacheKey(i);return{cacheKey:i,integrity:o}}}};super(s,e.strategy)}}function te(a){const e=L(),t=new ee(e,a);T(t)}const se="-precache-",ae=async(a,e=se)=>{const s=(await self.caches.keys()).filter(n=>n.includes(e)&&n.includes(self.registration.scope)&&n!==a);return await Promise.all(s.map(n=>self.caches.delete(n))),s};function ne(){self.addEventListener("activate",(a=>{const e=C.getPrecacheName();a.waitUntil(ae(e).then(t=>{}))}))}function re(a){return L().createHandlerBoundToURL(a)}function ce(a){L().precache(a)}function ie(a,e){ce(a),te(e)}class oe extends g{constructor(e,{allowlist:t=[/./],denylist:s=[]}={}){super(n=>this._match(n),e),this._allowlist=t,this._denylist=s}_match({url:e,request:t}){if(t&&t.mode!=="navigate")return!1;const s=e.pathname+e.search;for(const n of this._denylist)if(n.test(s))return!1;return!!this._allowlist.some(n=>n.test(s))}}self.skipWaiting();j();ie([{"revision":"fab346dacb0b9b9af12554e9a59f004d","url":"logo.svg"},{"revision":"623840baec64a3438663496bb1050d30","url":"logo-docker.svg"},{"revision":"c5c8611b432190ec28522f1a2dfcbb7f","url":"logo-codex.svg"},{"revision":"38904c45f039fa501fcc7a9ad2ba6ac0","url":"index.html"},{"revision":"1421e9c6cad8218ef5689b85034d3a95","url":"icon-512.png"},{"revision":"b96da5a0b6636012517f54b0e69c304d","url":"icon-192.png"},{"revision":"c64ca8ae8596d4ffe13d0f591beb2274","url":"favicon.svg"},{"revision":"6481face04bd08e6f0bfc2a633840b57","url":"apple-touch-icon.png"},{"revision":"83304194a3c8be2b5b61242eeb1c1046","url":"fonts/MesloLGSNerdFontMono-Regular.woff2"},{"revision":"60fafe18cbcb717c51cdabf87f9490f0","url":"fonts/MesloLGSNerdFontMono-Bold.woff2"},{"revision":null,"url":"assets/workbox-window.prod.es5-BBnX5xw4.js"},{"revision":null,"url":"assets/sw-register-BBun0drK.js"},{"revision":null,"url":"assets/index-e4RnFbra.js"},{"revision":null,"url":"assets/index-OAVDFR0O.css"},{"revision":null,"url":"assets/TailscalePage-ba0g8QT1.js"},{"revision":null,"url":"assets/SettingsPage-CrV1Tb8F.js"},{"revision":null,"url":"assets/SandboxManager-vWbQKeLT.js"},{"revision":null,"url":"assets/RunsPage-dn5rSkPu.js"},{"revision":null,"url":"assets/PromptsPage-D2YI_-95.js"},{"revision":null,"url":"assets/Playground-DWAal5bL.js"},{"revision":null,"url":"assets/MagicUIView-BVM8CqGg.js"},{"revision":null,"url":"assets/MagicUIDashboard-BOZc4rKn.js"},{"revision":null,"url":"assets/LinearSettingsPage-C1RHlPwX.js"},{"revision":null,"url":"assets/LinearOAuthSettingsPage-Czi_NsX1.js"},{"revision":null,"url":"assets/IntegrationsPage-DrE-8KPE.js"},{"revision":null,"url":"assets/DashboardPage-6cNRrqGQ.js"},{"revision":null,"url":"assets/CronManager-DNN709nr.js"},{"revision":null,"url":"assets/AgentsPage-0Fi6tbQN.js"}]);ne();T(new oe(re("index.html"),{denylist:[/^\/api/,/^\/ws/]}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hellcoder/companion",
-  "version": "0.124.0",
+  "version": "0.125.0",
   "type": "module",
   "description": "Web UI for launching and interacting with Claude Code agents — Moritz Edition (fork of the-companion)",
   "license": "MIT",

package/server/index.ts

@@ -45,7 +45,7 @@ import { getSettings, updateSettings } from "./settings-manager.js";
 import { setCliIngressServer } from "./routes/system-routes.js";
 import { imagePullManager } from "./image-pull-manager.js";
 import { restoreIfNeeded as restoreTailscaleFunnel, cleanup as cleanupTailscaleFunnel } from "./tailscale-manager.js";
-import { isRunningAsService } from "./service.js";
+import { getDetectedServiceKind, isRunningAsService } from "./service.js";
 import { getToken, verifyToken } from "./auth-manager.js";
 import { getCookie } from "hono/cookie";
 import type { SocketData } from "./ws-bridge.js";
@@ -421,7 +421,7 @@ if (getSettings().claudeBridgeMode === "patched") {
 }
 if (isRunningAsService()) {
   setServiceMode(true);
-  console.log("[server] Running as background service (auto-update available)");
+  console.log(`[server] Running as background service (${getDetectedServiceKind()}, auto-update available)`);
 }
 
 // ── Runtime diagnostics ──────────────────────────────────────────────────────

package/server/routes/system-routes.test.ts

@@ -28,6 +28,15 @@ vi.mock("../update-checker.js", () => ({
 // ─── Mock service ──────────────────────────────────────────────────────────
 vi.mock("../service.js", () => ({
   refreshServiceDefinition: vi.fn(),
+  getDetectedServiceKind: vi.fn(() => "systemd-user"),
+  getUpdateRestartPlan: vi.fn((kind: string | null) =>
+    kind === "systemd-system" || kind === "external"
+      ? { exitCode: 75 }
+      : {
+          command: ["systemctl", "--user", "restart", "the-companion.service"],
+          env: { XDG_RUNTIME_DIR: "/run/user/1000" },
+          exitCode: 0,
+        }),
 }));
 
 // ─── Mock claude-compat checker ────────────────────────────────────────────
@@ -88,6 +97,7 @@ import {
   setUpdateInProgress,
 } from "../update-checker.js";
 import { registerSystemRoutes } from "./system-routes.js";
+import { getDetectedServiceKind } from "../service.js";
 import { checkCompat, getCompatState } from "../claude-compat-checker.js";
 import { pinToVersion, patchBinary, unpatch } from "../claude-patcher.js";
 import { getSettings, updateSettings } from "../settings-manager.js";
@@ -496,6 +506,53 @@ describe("POST /api/update", () => {
     // Advance past the 500ms exit timeout
     await vi.advanceTimersByTimeAsync(600);
 
+    // The user unit is restarted through systemctl --user, then we exit 0.
+    expect(mockSpawn).toHaveBeenCalledWith(
+      ["systemctl", "--user", "restart", "the-companion.service"],
+      expect.objectContaining({ env: expect.objectContaining({ XDG_RUNTIME_DIR: "/run/user/1000" }) }),
+    );
+    expect(exitSpy).toHaveBeenCalledWith(0);
+
+    vi.useRealTimers();
+    exitSpy.mockRestore();
+    // @ts-expect-error -- cleanup Bun global mock
+    delete globalThis.Bun;
+  });
+
+  // Under a system-wide unit (issue #139) the server can't restart itself via
+  // systemctl; it must exit non-zero so Restart=on-failure respawns it.
+  it("exits with the restart code and spawns nothing under a system unit", async () => {
+    vi.useFakeTimers();
+    vi.mocked(getDetectedServiceKind).mockReturnValueOnce("systemd-system");
+    vi.mocked(getUpdateState).mockReturnValue({
+      currentVersion: "1.0.0",
+      latestVersion: "2.0.0",
+      lastChecked: Date.now(),
+      isServiceMode: true,
+      checking: false,
+      updateInProgress: false,
+      channel: "stable",
+    });
+    vi.mocked(isUpdateAvailable).mockReturnValue(true);
+
+    const mockSpawn = vi.fn().mockReturnValueOnce({
+      exited: Promise.resolve(0),
+      stdout: new ReadableStream(),
+      stderr: new ReadableStream(),
+    });
+    // @ts-expect-error -- Bun global mock
+    globalThis.Bun = { spawn: mockSpawn };
+    const exitSpy = vi.spyOn(process, "exit").mockImplementation(() => undefined as never);
+
+    const res = await app.request("/api/update", { method: "POST" });
+    expect(res.status).toBe(200);
+    await vi.advanceTimersByTimeAsync(150);
+    await vi.advanceTimersByTimeAsync(600);
+
+    // Only the install was spawned — no systemctl --user restart.
+    expect(mockSpawn).toHaveBeenCalledTimes(1);
+    expect(exitSpy).toHaveBeenCalledWith(75);
+
     vi.useRealTimers();
     exitSpy.mockRestore();
     // @ts-expect-error -- cleanup Bun global mock

package/server/routes/system-routes.ts

@@ -11,7 +11,11 @@ import {
   isUpdateAvailable,
   setUpdateInProgress,
 } from "../update-checker.js";
-import { refreshServiceDefinition } from "../service.js";
+import {
+  getDetectedServiceKind,
+  getUpdateRestartPlan,
+  refreshServiceDefinition,
+} from "../service.js";
 import { getSettings, updateSettings } from "../settings-manager.js";
 import { imagePullManager } from "../image-pull-manager.js";
 import { isSandboxEnabled } from "../feature-flags.js";
@@ -187,29 +191,21 @@ export function registerSystemRoutes(
 
         console.log("[update] Update successful, restarting service...");
 
-        const isLinux = process.platform === "linux";
-        const uid = typeof process.getuid === "function" ? process.getuid() : undefined;
-        const restartCmd = isLinux
-          ? ["systemctl", "--user", "restart", "the-companion.service"]
-          : uid !== undefined
-            ? ["launchctl", "kickstart", "-k", `gui/${uid}/sh.thecompanion.app`]
-            : ["launchctl", "kickstart", "-k", "sh.thecompanion.app"];
-
-        Bun.spawn(restartCmd, {
-          stdout: "ignore",
-          stderr: "ignore",
-          stdin: "ignore",
-          env: isLinux
-            ? {
-                ...process.env,
-                XDG_RUNTIME_DIR:
-                  process.env.XDG_RUNTIME_DIR ||
-                  `/run/user/${uid ?? 1000}`,
-              }
-            : undefined,
-        });
-
-        setTimeout(() => process.exit(0), 500);
+        const plan = getUpdateRestartPlan(getDetectedServiceKind());
+        if (plan.command) {
+          Bun.spawn(plan.command, {
+            stdout: "ignore",
+            stderr: "ignore",
+            stdin: "ignore",
+            env: plan.env ? { ...process.env, ...plan.env } : undefined,
+          });
+        } else {
+          console.log(
+            `[update] Exiting with code ${plan.exitCode} so the supervisor restarts the server.`,
+          );
+        }
+
+        setTimeout(() => process.exit(plan.exitCode), 500);
       } catch (err) {
         console.error("[update] Update failed:", err);
         setUpdateInProgress(false);

package/server/service.test.ts

@@ -50,6 +50,38 @@ vi.mock("node:child_process", async (importOriginal) => {
   };
 });
 
+// Mock node:net so isPortInUse() never binds a real port (the dev box may
+// well be running a Companion on the default port).
+const mockPortInUse = vi.hoisted(() => {
+  let inUse = false;
+  return { get: () => inUse, set: (v: boolean) => { inUse = v; } };
+});
+
+vi.mock("node:net", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("node:net")>();
+  const { EventEmitter } = await import("node:events");
+  return {
+    ...actual,
+    createServer: () => {
+      const server = new EventEmitter() as InstanceType<typeof EventEmitter> & {
+        listen: (port: number) => void;
+        close: (cb?: () => void) => void;
+      };
+      server.listen = () => {
+        queueMicrotask(() => {
+          if (mockPortInUse.get()) {
+            server.emit("error", Object.assign(new Error("in use"), { code: "EADDRINUSE" }));
+          } else {
+            server.emit("listening");
+          }
+        });
+      };
+      server.close = (cb) => cb?.();
+      return server;
+    },
+  };
+});
+
 // Mock path-resolver to return a deterministic enriched PATH
 const MOCK_SERVICE_PATH = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/mock/.bun/bin:/mock/.local/bin";
 vi.mock("./path-resolver.js", () => ({
@@ -74,6 +106,9 @@ beforeEach(async () => {
   mockHomedir.set(tempDir);
   mockPlatform.set("darwin");
   mockExecSync.mockReset();
+  mockPortInUse.set(false);
+  delete process.env.COMPANION_SERVICE_MODE;
+  delete process.env.INVOCATION_ID;
 
   // Set process.platform AFTER resetting mockPlatform to "darwin"
   Object.defineProperty(process, "platform", {
@@ -1417,3 +1452,200 @@ describe("platform check", () => {
     expect(existsSync(unitPath())).toBe(true);
   });
 });
+
+// ===========================================================================
+// System-wide systemd unit support (issue #139)
+// ===========================================================================
+
+const SYSTEM_UNIT_SHOW = [
+  "LoadState=loaded",
+  "ActiveState=active",
+  "MainPID=4321",
+  "InvocationID=0123456789abcdef0123456789abcdef",
+  "FragmentPath=/etc/systemd/system/the-companion.service",
+  "Environment=NODE_ENV=production PORT=3999 HOST=0.0.0.0",
+].join("\n");
+
+/** True for system-scope `systemctl show the-companion.service` queries. */
+function isSystemShow(cmd: string): boolean {
+  return cmd.startsWith("systemctl show the-companion.service");
+}
+
+describe("system-wide systemd unit (linux)", () => {
+  beforeEach(async () => {
+    mockPlatform.set("linux");
+    Object.defineProperty(process, "platform", { value: "linux" });
+    vi.resetModules();
+    service = await import("./service.js");
+  });
+
+  describe("getSystemUnitInfo", () => {
+    it("parses state, pid, invocation id, path and port", () => {
+      mockExecSync.mockImplementation((cmd: string) => (isSystemShow(cmd) ? SYSTEM_UNIT_SHOW : ""));
+      expect(service.getSystemUnitInfo()).toEqual({
+        activeState: "active",
+        mainPid: 4321,
+        invocationId: "0123456789abcdef0123456789abcdef",
+        fragmentPath: "/etc/systemd/system/the-companion.service",
+        port: 3999,
+      });
+    });
+
+    it("returns undefined for LoadState=not-found", () => {
+      mockExecSync.mockImplementation(() => "LoadState=not-found\nActiveState=inactive\n");
+      expect(service.getSystemUnitInfo()).toBeUndefined();
+    });
+
+    it("returns undefined when systemctl fails", () => {
+      mockExecSync.mockImplementation(() => { throw new Error("no systemd"); });
+      expect(service.getSystemUnitInfo()).toBeUndefined();
+    });
+  });
+
+  describe("detectServiceKind / isRunningAsService", () => {
+    it("detects the system unit when INVOCATION_ID matches", () => {
+      process.env.INVOCATION_ID = "0123456789abcdef0123456789abcdef";
+      mockExecSync.mockImplementation((cmd: string) => (isSystemShow(cmd) ? SYSTEM_UNIT_SHOW : ""));
+      expect(service.isRunningAsService()).toBe(true);
+      expect(service.getDetectedServiceKind()).toBe("systemd-system");
+    });
+
+    it("ignores the system unit when this process is not its invocation", () => {
+      process.env.INVOCATION_ID = "ffffffffffffffffffffffffffffffff";
+      mockExecSync.mockImplementation((cmd: string) => (isSystemShow(cmd) ? SYSTEM_UNIT_SHOW : ""));
+      expect(service.detectServiceKind()).toBeNull();
+    });
+
+    it("ignores the system unit when not started by systemd (no INVOCATION_ID)", () => {
+      mockExecSync.mockImplementation((cmd: string) => (isSystemShow(cmd) ? SYSTEM_UNIT_SHOW : ""));
+      expect(service.detectServiceKind()).toBeNull();
+    });
+
+    it("ignores an inactive system unit", () => {
+      process.env.INVOCATION_ID = "0123456789abcdef0123456789abcdef";
+      mockExecSync.mockImplementation((cmd: string) =>
+        isSystemShow(cmd) ? SYSTEM_UNIT_SHOW.replace("ActiveState=active", "ActiveState=failed") : "");
+      expect(service.detectServiceKind()).toBeNull();
+    });
+
+    it("COMPANION_SERVICE_MODE=1 opts in without any unit", () => {
+      process.env.COMPANION_SERVICE_MODE = "1";
+      expect(service.isRunningAsService()).toBe(true);
+      expect(service.getDetectedServiceKind()).toBe("external");
+    });
+
+    it("COMPANION_SERVICE_MODE=0 forces service mode off", () => {
+      process.env.COMPANION_SERVICE_MODE = "0";
+      process.env.INVOCATION_ID = "0123456789abcdef0123456789abcdef";
+      mockExecSync.mockImplementation((cmd: string) => (isSystemShow(cmd) ? SYSTEM_UNIT_SHOW : ""));
+      expect(service.isRunningAsService()).toBe(false);
+      expect(service.getDetectedServiceKind()).toBeNull();
+    });
+
+    it("still reports systemd-user for an active per-user unit", async () => {
+      mockExecSync.mockImplementation((cmd: string) =>
+        cmd.startsWith("which") ? "/usr/local/bin/the-companion\n" : "");
+      await service.install();
+      mockExecSync.mockReset();
+      mockExecSync.mockImplementation((cmd: string) => (cmd.includes("is-active") ? "active\n" : ""));
+      expect(service.detectServiceKind()).toBe("systemd-user");
+    });
+  });
+
+  describe("install", () => {
+    it("refuses when a system-wide unit exists", async () => {
+      mockExecSync.mockImplementation((cmd: string) => {
+        if (cmd.startsWith("which")) return "/usr/local/bin/the-companion\n";
+        if (isSystemShow(cmd)) return SYSTEM_UNIT_SHOW;
+        return "";
+      });
+      await expect(service.install()).rejects.toThrow("process.exit(1)");
+      expect(existsSync(unitPath())).toBe(false);
+      expect(mockExecSync).not.toHaveBeenCalledWith(
+        expect.stringContaining("enable --now"), expect.anything());
+    });
+
+    it("refuses when the port is already in use", async () => {
+      mockPortInUse.set(true);
+      mockExecSync.mockImplementation((cmd: string) =>
+        cmd.startsWith("which") ? "/usr/local/bin/the-companion\n" : "");
+      await expect(service.install()).rejects.toThrow("process.exit(1)");
+      expect(existsSync(unitPath())).toBe(false);
+    });
+  });
+
+  describe("start/stop/restart/status/uninstall with only a system unit", () => {
+    beforeEach(() => {
+      mockExecSync.mockImplementation((cmd: string) => (isSystemShow(cmd) ? SYSTEM_UNIT_SHOW : ""));
+    });
+
+    it("start does not install a user unit and prints the sudo hint when unprivileged", async () => {
+      vi.spyOn(process, "getuid").mockReturnValue(1000);
+      const log = vi.spyOn(console, "log").mockImplementation(() => {});
+      await expect(service.start()).rejects.toThrow("process.exit(1)");
+      expect(existsSync(unitPath())).toBe(false);
+      expect(log.mock.calls.flat().join("\n")).toContain("sudo systemctl start the-companion.service");
+    });
+
+    it("restart drives the system unit directly as root", async () => {
+      vi.spyOn(process, "getuid").mockReturnValue(0);
+      vi.spyOn(console, "log").mockImplementation(() => {});
+      await service.restart();
+      expect(mockExecSync).toHaveBeenCalledWith(
+        "systemctl restart the-companion.service", expect.anything());
+      expect(mockExecSync).not.toHaveBeenCalledWith(
+        expect.stringContaining("--user restart"), expect.anything());
+    });
+
+    it("stop prints the sudo hint when unprivileged", async () => {
+      vi.spyOn(process, "getuid").mockReturnValue(1000);
+      const log = vi.spyOn(console, "log").mockImplementation(() => {});
+      await expect(service.stop()).rejects.toThrow("process.exit(1)");
+      expect(log.mock.calls.flat().join("\n")).toContain("sudo systemctl stop the-companion.service");
+    });
+
+    it("status reports the system unit", async () => {
+      expect(await service.status()).toEqual({
+        installed: true, running: true, pid: 4321, port: 3999, scope: "system",
+      });
+    });
+
+    it("uninstall leaves the system unit alone", async () => {
+      const log = vi.spyOn(console, "log").mockImplementation(() => {});
+      await service.uninstall();
+      expect(mockExecSync).not.toHaveBeenCalledWith(
+        expect.stringContaining("disable"), expect.anything());
+      expect(log.mock.calls.flat().join("\n")).toContain("sudo systemctl disable --now");
+    });
+  });
+});
+
+describe("getUpdateRestartPlan", () => {
+  it("exits non-zero without spawning for a system unit", () => {
+    expect(service.getUpdateRestartPlan("systemd-system")).toEqual({
+      exitCode: service.UPDATE_RESTART_EXIT_CODE,
+    });
+    expect(service.UPDATE_RESTART_EXIT_CODE).not.toBe(0);
+    // 42 is SuccessExitStatus in our own template; a "please restart" code must differ.
+    expect(service.UPDATE_RESTART_EXIT_CODE).not.toBe(42);
+  });
+
+  it("exits non-zero without spawning for COMPANION_SERVICE_MODE=1", () => {
+    expect(service.getUpdateRestartPlan("external").command).toBeUndefined();
+    expect(service.getUpdateRestartPlan("external").exitCode).toBe(service.UPDATE_RESTART_EXIT_CODE);
+  });
+
+  it("uses systemctl --user restart for the user unit", () => {
+    const plan = service.getUpdateRestartPlan("systemd-user");
+    expect(plan.command).toEqual(["systemctl", "--user", "restart", "the-companion.service"]);
+    expect(plan.env?.XDG_RUNTIME_DIR).toBeTruthy();
+    expect(plan.exitCode).toBe(0);
+  });
+
+  it("uses launchctl kickstart for launchd", () => {
+    const plan = service.getUpdateRestartPlan("launchd");
+    expect(plan.command?.slice(0, 3)).toEqual(["launchctl", "kickstart", "-k"]);
+    expect(plan.command?.[3]).toMatch(/sh\.thecompanion\.app$/);
+    expect(plan.exitCode).toBe(0);
+  });
+});