@hienlh/ppm 0.23.11 → 0.23.12

package/dist/web/sw.js

@@ -1 +1 @@
-try{self[`workbox:core:7.3.0`]&&_()}catch{}var e=(e,...t)=>{let n=e;return t.length>0&&(n+=` :: ${JSON.stringify(t)}`),n},t=class extends Error{constructor(t,n){let r=e(t,n);super(r),this.name=t,this.details=n}},n={googleAnalytics:`googleAnalytics`,precache:`precache-v2`,prefix:`workbox`,runtime:`runtime`,suffix:typeof registration<`u`?registration.scope:``},r=e=>[n.prefix,e,n.suffix].filter(e=>e&&e.length>0).join(`-`),i=e=>{for(let t of Object.keys(n))e(t)},a={updateDetails:e=>{i(t=>{typeof e[t]==`string`&&(n[t]=e[t])})},getGoogleAnalyticsName:e=>e||r(n.googleAnalytics),getPrecacheName:e=>e||r(n.precache),getPrefix:()=>n.prefix,getRuntimeName:e=>e||r(n.runtime),getSuffix:()=>n.suffix};function o(e,t){let n=t();return e.waitUntil(n),n}try{self[`workbox:precaching:7.3.0`]&&_()}catch{}var s=`__WB_REVISION__`;function c(e){if(!e)throw new t(`add-to-cache-list-unexpected-type`,{entry:e});if(typeof e==`string`){let t=new URL(e,location.href);return{cacheKey:t.href,url:t.href}}let{revision:n,url:r}=e;if(!r)throw new t(`add-to-cache-list-unexpected-type`,{entry:e});if(!n){let e=new URL(r,location.href);return{cacheKey:e.href,url:e.href}}let i=new URL(r,location.href),a=new URL(r,location.href);return i.searchParams.set(s,n),{cacheKey:i.href,url:a.href}}var l=class{constructor(){this.updatedURLs=[],this.notUpdatedURLs=[],this.handlerWillStart=async({request:e,state:t})=>{t&&(t.originalRequest=e)},this.cachedResponseWillBeUsed=async({event:e,state:t,cachedResponse:n})=>{if(e.type===`install`&&t&&t.originalRequest&&t.originalRequest instanceof Request){let e=t.originalRequest.url;n?this.notUpdatedURLs.push(e):this.updatedURLs.push(e)}return n}}},u=class{constructor({precacheController:e}){this.cacheKeyWillBeUsed=async({request:e,params:t})=>{let n=t?.cacheKey||this._precacheController.getCacheKeyForURL(e.url);return n?new Request(n,{headers:e.headers}):e},this._precacheController=e}},d;function f(){if(d===void 0){let e=new Response(``);if(`body`in e)try{new Response(e.body),d=!0}catch{d=!1}d=!1}return d}async function p(e,n){let r=null;if(e.url&&(r=new URL(e.url).origin),r!==self.location.origin)throw new t(`cross-origin-copy-response`,{origin:r});let i=e.clone(),a={headers:new Headers(i.headers),status:i.status,statusText:i.statusText},o=n?n(a):a,s=f()?i.body:await i.blob();return new Response(s,o)}var m=e=>new URL(String(e),location.href).href.replace(RegExp(`^${location.origin}`),``);function h(e,t){let n=new URL(e);for(let e of t)n.searchParams.delete(e);return n.href}async function g(e,t,n,r){let i=h(t.url,n);if(t.url===i)return e.match(t,r);let a=Object.assign(Object.assign({},r),{ignoreSearch:!0}),o=await e.keys(t,a);for(let t of o)if(i===h(t.url,n))return e.match(t,r)}var v=class{constructor(){this.promise=new Promise((e,t)=>{this.resolve=e,this.reject=t})}},y=new Set;async function b(){for(let e of y)await e()}function x(e){return new Promise(t=>setTimeout(t,e))}try{self[`workbox:strategies:7.3.0`]&&_()}catch{}function S(e){return typeof e==`string`?new Request(e):e}var C=class{constructor(e,t){this._cacheKeys={},Object.assign(this,t),this.event=t.event,this._strategy=e,this._handlerDeferred=new v,this._extendLifetimePromises=[],this._plugins=[...e.plugins],this._pluginStateMap=new Map;for(let e of this._plugins)this._pluginStateMap.set(e,{});this.event.waitUntil(this._handlerDeferred.promise)}async fetch(e){let{event:n}=this,r=S(e);if(r.mode===`navigate`&&n instanceof FetchEvent&&n.preloadResponse){let e=await n.preloadResponse;if(e)return e}let i=this.hasCallback(`fetchDidFail`)?r.clone():null;try{for(let e of this.iterateCallbacks(`requestWillFetch`))r=await e({request:r.clone(),event:n})}catch(e){if(e instanceof Error)throw new t(`plugin-error-request-will-fetch`,{thrownErrorMessage:e.message})}let a=r.clone();try{let e;e=await fetch(r,r.mode===`navigate`?void 0:this._strategy.fetchOptions);for(let t of this.iterateCallbacks(`fetchDidSucceed`))e=await t({event:n,request:a,response:e});return e}catch(e){throw i&&await this.runCallbacks(`fetchDidFail`,{error:e,event:n,originalRequest:i.clone(),request:a.clone()}),e}}async fetchAndCachePut(e){let t=await this.fetch(e),n=t.clone();return this.waitUntil(this.cachePut(e,n)),t}async cacheMatch(e){let t=S(e),n,{cacheName:r,matchOptions:i}=this._strategy,a=await this.getCacheKey(t,`read`),o=Object.assign(Object.assign({},i),{cacheName:r});n=await caches.match(a,o);for(let e of this.iterateCallbacks(`cachedResponseWillBeUsed`))n=await e({cacheName:r,matchOptions:i,cachedResponse:n,request:a,event:this.event})||void 0;return n}async cachePut(e,n){let r=S(e);await x(0);let i=await this.getCacheKey(r,`write`);if(!n)throw new t(`cache-put-with-no-response`,{url:m(i.url)});let a=await this._ensureResponseSafeToCache(n);if(!a)return!1;let{cacheName:o,matchOptions:s}=this._strategy,c=await self.caches.open(o),l=this.hasCallback(`cacheDidUpdate`),u=l?await g(c,i.clone(),[`__WB_REVISION__`],s):null;try{await c.put(i,l?a.clone():a)}catch(e){if(e instanceof Error)throw e.name===`QuotaExceededError`&&await b(),e}for(let e of this.iterateCallbacks(`cacheDidUpdate`))await e({cacheName:o,oldResponse:u,newResponse:a.clone(),request:i,event:this.event});return!0}async getCacheKey(e,t){let n=`${e.url} | ${t}`;if(!this._cacheKeys[n]){let r=e;for(let e of this.iterateCallbacks(`cacheKeyWillBeUsed`))r=S(await e({mode:t,request:r,event:this.event,params:this.params}));this._cacheKeys[n]=r}return this._cacheKeys[n]}hasCallback(e){for(let t of this._strategy.plugins)if(e in t)return!0;return!1}async runCallbacks(e,t){for(let n of this.iterateCallbacks(e))await n(t)}*iterateCallbacks(e){for(let t of this._strategy.plugins)if(typeof t[e]==`function`){let n=this._pluginStateMap.get(t);yield r=>{let i=Object.assign(Object.assign({},r),{state:n});return t[e](i)}}}waitUntil(e){return this._extendLifetimePromises.push(e),e}async doneWaiting(){for(;this._extendLifetimePromises.length;){let e=this._extendLifetimePromises.splice(0),t=(await Promise.allSettled(e)).find(e=>e.status===`rejected`);if(t)throw t.reason}}destroy(){this._handlerDeferred.resolve(null)}async _ensureResponseSafeToCache(e){let t=e,n=!1;for(let e of this.iterateCallbacks(`cacheWillUpdate`))if(t=await e({request:this.request,response:t,event:this.event})||void 0,n=!0,!t)break;return n||t&&t.status!==200&&(t=void 0),t}},w=class{constructor(e={}){this.cacheName=a.getRuntimeName(e.cacheName),this.plugins=e.plugins||[],this.fetchOptions=e.fetchOptions,this.matchOptions=e.matchOptions}handle(e){let[t]=this.handleAll(e);return t}handleAll(e){e instanceof FetchEvent&&(e={event:e,request:e.request});let t=e.event,n=typeof e.request==`string`?new Request(e.request):e.request,r=`params`in e?e.params:void 0,i=new C(this,{event:t,request:n,params:r}),a=this._getResponse(i,n,t);return[a,this._awaitComplete(a,i,n,t)]}async _getResponse(e,n,r){await e.runCallbacks(`handlerWillStart`,{event:r,request:n});let i;try{if(i=await this._handle(n,e),!i||i.type===`error`)throw new t(`no-response`,{url:n.url})}catch(t){if(t instanceof Error){for(let a of e.iterateCallbacks(`handlerDidError`))if(i=await a({error:t,event:r,request:n}),i)break}if(!i)throw t}for(let t of e.iterateCallbacks(`handlerWillRespond`))i=await t({event:r,request:n,response:i});return i}async _awaitComplete(e,t,n,r){let i,a;try{i=await e}catch{}try{await t.runCallbacks(`handlerDidRespond`,{event:r,request:n,response:i}),await t.doneWaiting()}catch(e){e instanceof Error&&(a=e)}if(await t.runCallbacks(`handlerDidComplete`,{event:r,request:n,response:i,error:a}),t.destroy(),a)throw a}},T=class e extends w{constructor(t={}){t.cacheName=a.getPrecacheName(t.cacheName),super(t),this._fallbackToNetwork=t.fallbackToNetwork!==!1,this.plugins.push(e.copyRedirectedCacheableResponsesPlugin)}async _handle(e,t){return await t.cacheMatch(e)||(t.event&&t.event.type===`install`?await this._handleInstall(e,t):await this._handleFetch(e,t))}async _handleFetch(e,n){let r,i=n.params||{};if(this._fallbackToNetwork){let t=i.integrity,a=e.integrity,o=!a||a===t;r=await n.fetch(new Request(e,{integrity:e.mode===`no-cors`?void 0:a||t})),t&&o&&e.mode!==`no-cors`&&(this._useDefaultCacheabilityPluginIfNeeded(),await n.cachePut(e,r.clone()))}else throw new t(`missing-precache-entry`,{cacheName:this.cacheName,url:e.url});return r}async _handleInstall(e,n){this._useDefaultCacheabilityPluginIfNeeded();let r=await n.fetch(e);if(!await n.cachePut(e,r.clone()))throw new t(`bad-precaching-response`,{url:e.url,status:r.status});return r}_useDefaultCacheabilityPluginIfNeeded(){let t=null,n=0;for(let[r,i]of this.plugins.entries())i!==e.copyRedirectedCacheableResponsesPlugin&&(i===e.defaultPrecacheCacheabilityPlugin&&(t=r),i.cacheWillUpdate&&n++);n===0?this.plugins.push(e.defaultPrecacheCacheabilityPlugin):n>1&&t!==null&&this.plugins.splice(t,1)}};T.defaultPrecacheCacheabilityPlugin={async cacheWillUpdate({response:e}){return!e||e.status>=400?null:e}},T.copyRedirectedCacheableResponsesPlugin={async cacheWillUpdate({response:e}){return e.redirected?await p(e):e}};var E=class{constructor({cacheName:e,plugins:t=[],fallbackToNetwork:n=!0}={}){this._urlsToCacheKeys=new Map,this._urlsToCacheModes=new Map,this._cacheKeysToIntegrities=new Map,this._strategy=new T({cacheName:a.getPrecacheName(e),plugins:[...t,new u({precacheController:this})],fallbackToNetwork:n}),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),!0)}addToCacheList(e){let n=[];for(let r of e){typeof r==`string`?n.push(r):r&&r.revision===void 0&&n.push(r.url);let{cacheKey:e,url:i}=c(r),a=typeof r!=`string`&&r.revision?`reload`:`default`;if(this._urlsToCacheKeys.has(i)&&this._urlsToCacheKeys.get(i)!==e)throw new t(`add-to-cache-list-conflicting-entries`,{firstEntry:this._urlsToCacheKeys.get(i),secondEntry:e});if(typeof r!=`string`&&r.integrity){if(this._cacheKeysToIntegrities.has(e)&&this._cacheKeysToIntegrities.get(e)!==r.integrity)throw new t(`add-to-cache-list-conflicting-integrities`,{url:i});this._cacheKeysToIntegrities.set(e,r.integrity)}if(this._urlsToCacheKeys.set(i,e),this._urlsToCacheModes.set(i,a),n.length>0){let e=`Workbox is precaching URLs without revision info: ${n.join(`, `)}\nThis is generally NOT safe. Learn more at https://bit.ly/wb-precache`;console.warn(e)}}}install(e){return o(e,async()=>{let t=new l;this.strategy.plugins.push(t);for(let[t,n]of this._urlsToCacheKeys){let r=this._cacheKeysToIntegrities.get(n),i=this._urlsToCacheModes.get(t),a=new Request(t,{integrity:r,cache:i,credentials:`same-origin`});await Promise.all(this.strategy.handleAll({params:{cacheKey:n},request:a,event:e}))}let{updatedURLs:n,notUpdatedURLs:r}=t;return{updatedURLs:n,notUpdatedURLs:r}})}activate(e){return o(e,async()=>{let e=await self.caches.open(this.strategy.cacheName),t=await e.keys(),n=new Set(this._urlsToCacheKeys.values()),r=[];for(let i of t)n.has(i.url)||(await e.delete(i),r.push(i.url));return{deletedURLs:r}})}getURLsToCacheKeys(){return this._urlsToCacheKeys}getCachedURLs(){return[...this._urlsToCacheKeys.keys()]}getCacheKeyForURL(e){let t=new URL(e,location.href);return this._urlsToCacheKeys.get(t.href)}getIntegrityForCacheKey(e){return this._cacheKeysToIntegrities.get(e)}async matchPrecache(e){let t=e instanceof Request?e.url:e,n=this.getCacheKeyForURL(t);if(n)return(await self.caches.open(this.strategy.cacheName)).match(n)}createHandlerBoundToURL(e){let n=this.getCacheKeyForURL(e);if(!n)throw new t(`non-precached-url`,{url:e});return t=>(t.request=new Request(e),t.params=Object.assign({cacheKey:n},t.params),this.strategy.handle(t))}},D,O=()=>(D||=new E,D);try{self[`workbox:routing:7.3.0`]&&_()}catch{}var k=e=>e&&typeof e==`object`?e:{handle:e},A=class{constructor(e,t,n=`GET`){this.handler=k(t),this.match=e,this.method=n}setCatchHandler(e){this.catchHandler=k(e)}},j=class extends A{constructor(e,t,n){super(({url:t})=>{let n=e.exec(t.href);if(n&&!(t.origin!==location.origin&&n.index!==0))return n.slice(1)},t,n)}},M=class{constructor(){this._routes=new Map,this._defaultHandlerMap=new Map}get routes(){return this._routes}addFetchListener(){self.addEventListener(`fetch`,(e=>{let{request:t}=e,n=this.handleRequest({request:t,event:e});n&&e.respondWith(n)}))}addCacheListener(){self.addEventListener(`message`,(e=>{if(e.data&&e.data.type===`CACHE_URLS`){let{payload:t}=e.data,n=Promise.all(t.urlsToCache.map(t=>{typeof t==`string`&&(t=[t]);let n=new Request(...t);return this.handleRequest({request:n,event:e})}));e.waitUntil(n),e.ports&&e.ports[0]&&n.then(()=>e.ports[0].postMessage(!0))}}))}handleRequest({request:e,event:t}){let n=new URL(e.url,location.href);if(!n.protocol.startsWith(`http`))return;let r=n.origin===location.origin,{params:i,route:a}=this.findMatchingRoute({event:t,request:e,sameOrigin:r,url:n}),o=a&&a.handler,s=e.method;if(!o&&this._defaultHandlerMap.has(s)&&(o=this._defaultHandlerMap.get(s)),!o)return;let c;try{c=o.handle({url:n,request:e,event:t,params:i})}catch(e){c=Promise.reject(e)}let l=a&&a.catchHandler;return c instanceof Promise&&(this._catchHandler||l)&&(c=c.catch(async r=>{if(l)try{return await l.handle({url:n,request:e,event:t,params:i})}catch(e){e instanceof Error&&(r=e)}if(this._catchHandler)return this._catchHandler.handle({url:n,request:e,event:t});throw r})),c}findMatchingRoute({url:e,sameOrigin:t,request:n,event:r}){let i=this._routes.get(n.method)||[];for(let a of i){let i,o=a.match({url:e,sameOrigin:t,request:n,event:r});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:a,params:i}}return{}}setDefaultHandler(e,t=`GET`){this._defaultHandlerMap.set(t,k(e))}setCatchHandler(e){this._catchHandler=k(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 t(`unregister-route-but-not-found-with-method`,{method:e.method});let n=this._routes.get(e.method).indexOf(e);if(n>-1)this._routes.get(e.method).splice(n,1);else throw new t(`unregister-route-route-not-registered`)}},N,P=()=>(N||(N=new M,N.addFetchListener(),N.addCacheListener()),N);function F(e,n,r){let i;if(typeof e==`string`){let t=new URL(e,location.href);i=new A(({url:e})=>e.href===t.href,n,r)}else if(e instanceof RegExp)i=new j(e,n,r);else if(typeof e==`function`)i=new A(e,n,r);else if(e instanceof A)i=e;else throw new t(`unsupported-route-type`,{moduleName:`workbox-routing`,funcName:`registerRoute`,paramName:`capture`});return P().registerRoute(i),i}function I(e,t=[]){for(let n of[...e.searchParams.keys()])t.some(e=>e.test(n))&&e.searchParams.delete(n);return e}function*L(e,{ignoreURLParametersMatching:t=[/^utm_/,/^fbclid$/],directoryIndex:n=`index.html`,cleanURLs:r=!0,urlManipulation:i}={}){let a=new URL(e,location.href);a.hash=``,yield a.href;let o=I(a,t);if(yield o.href,n&&o.pathname.endsWith(`/`)){let e=new URL(o.href);e.pathname+=n,yield e.href}if(r){let e=new URL(o.href);e.pathname+=`.html`,yield e.href}if(i){let e=i({url:a});for(let t of e)yield t.href}}var R=class extends A{constructor(e,t){super(({request:n})=>{let r=e.getURLsToCacheKeys();for(let i of L(n.url,t)){let t=r.get(i);if(t)return{cacheKey:t,integrity:e.getIntegrityForCacheKey(t)}}},e.strategy)}};function z(e){F(new R(O(),e))}var B=`-precache-`,V=async(e,t=B)=>{let n=(await self.caches.keys()).filter(n=>n.includes(t)&&n.includes(self.registration.scope)&&n!==e);return await Promise.all(n.map(e=>self.caches.delete(e))),n};function H(){self.addEventListener(`activate`,(e=>{let t=a.getPrecacheName();e.waitUntil(V(t).then(e=>{}))}))}function U(e){O().precache(e)}function W(e,t){U(e),z(t)}var G=class extends w{async _handle(e,n){let r=await n.cacheMatch(e),i;if(!r)try{r=await n.fetchAndCachePut(e)}catch(e){e instanceof Error&&(i=e)}if(!r)throw new t(`no-response`,{url:e.url,error:i});return r}};W([{"revision":"207d5c365d8592b728c5fbbfaebe9a60","url":"index.html"},{"revision":"26dccd02a2ef7522892015154f5e3680","url":"manifest.webmanifest"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-512.svg"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-192.svg"},{"revision":null,"url":"assets/index-oIvYSKTT.css"},{"revision":null,"url":"assets/index-DhWjx5iR.js"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-192.svg"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-512.svg"},{"revision":"26dccd02a2ef7522892015154f5e3680","url":"manifest.webmanifest"}]),H();var K=e=>(e.headers.get(`content-type`)??``).startsWith(`text/html`);F(({url:e})=>e.pathname.startsWith(`/assets/`),new G({cacheName:`ppm-assets`,plugins:[{cacheWillUpdate:async({response:e})=>K(e)?null:e,cachedResponseWillBeUsed:async({cachedResponse:e})=>e&&K(e)?null:e}]})),self.skipWaiting(),self.addEventListener(`activate`,()=>{self.clients.claim()});
+try{self[`workbox:core:7.3.0`]&&_()}catch{}var e=(e,...t)=>{let n=e;return t.length>0&&(n+=` :: ${JSON.stringify(t)}`),n},t=class extends Error{constructor(t,n){let r=e(t,n);super(r),this.name=t,this.details=n}},n={googleAnalytics:`googleAnalytics`,precache:`precache-v2`,prefix:`workbox`,runtime:`runtime`,suffix:typeof registration<`u`?registration.scope:``},r=e=>[n.prefix,e,n.suffix].filter(e=>e&&e.length>0).join(`-`),i=e=>{for(let t of Object.keys(n))e(t)},a={updateDetails:e=>{i(t=>{typeof e[t]==`string`&&(n[t]=e[t])})},getGoogleAnalyticsName:e=>e||r(n.googleAnalytics),getPrecacheName:e=>e||r(n.precache),getPrefix:()=>n.prefix,getRuntimeName:e=>e||r(n.runtime),getSuffix:()=>n.suffix};function o(e,t){let n=t();return e.waitUntil(n),n}try{self[`workbox:precaching:7.3.0`]&&_()}catch{}var s=`__WB_REVISION__`;function c(e){if(!e)throw new t(`add-to-cache-list-unexpected-type`,{entry:e});if(typeof e==`string`){let t=new URL(e,location.href);return{cacheKey:t.href,url:t.href}}let{revision:n,url:r}=e;if(!r)throw new t(`add-to-cache-list-unexpected-type`,{entry:e});if(!n){let e=new URL(r,location.href);return{cacheKey:e.href,url:e.href}}let i=new URL(r,location.href),a=new URL(r,location.href);return i.searchParams.set(s,n),{cacheKey:i.href,url:a.href}}var l=class{constructor(){this.updatedURLs=[],this.notUpdatedURLs=[],this.handlerWillStart=async({request:e,state:t})=>{t&&(t.originalRequest=e)},this.cachedResponseWillBeUsed=async({event:e,state:t,cachedResponse:n})=>{if(e.type===`install`&&t&&t.originalRequest&&t.originalRequest instanceof Request){let e=t.originalRequest.url;n?this.notUpdatedURLs.push(e):this.updatedURLs.push(e)}return n}}},u=class{constructor({precacheController:e}){this.cacheKeyWillBeUsed=async({request:e,params:t})=>{let n=t?.cacheKey||this._precacheController.getCacheKeyForURL(e.url);return n?new Request(n,{headers:e.headers}):e},this._precacheController=e}},d;function f(){if(d===void 0){let e=new Response(``);if(`body`in e)try{new Response(e.body),d=!0}catch{d=!1}d=!1}return d}async function p(e,n){let r=null;if(e.url&&(r=new URL(e.url).origin),r!==self.location.origin)throw new t(`cross-origin-copy-response`,{origin:r});let i=e.clone(),a={headers:new Headers(i.headers),status:i.status,statusText:i.statusText},o=n?n(a):a,s=f()?i.body:await i.blob();return new Response(s,o)}var m=e=>new URL(String(e),location.href).href.replace(RegExp(`^${location.origin}`),``);function h(e,t){let n=new URL(e);for(let e of t)n.searchParams.delete(e);return n.href}async function g(e,t,n,r){let i=h(t.url,n);if(t.url===i)return e.match(t,r);let a=Object.assign(Object.assign({},r),{ignoreSearch:!0}),o=await e.keys(t,a);for(let t of o)if(i===h(t.url,n))return e.match(t,r)}var v=class{constructor(){this.promise=new Promise((e,t)=>{this.resolve=e,this.reject=t})}},y=new Set;async function b(){for(let e of y)await e()}function x(e){return new Promise(t=>setTimeout(t,e))}try{self[`workbox:strategies:7.3.0`]&&_()}catch{}function S(e){return typeof e==`string`?new Request(e):e}var C=class{constructor(e,t){this._cacheKeys={},Object.assign(this,t),this.event=t.event,this._strategy=e,this._handlerDeferred=new v,this._extendLifetimePromises=[],this._plugins=[...e.plugins],this._pluginStateMap=new Map;for(let e of this._plugins)this._pluginStateMap.set(e,{});this.event.waitUntil(this._handlerDeferred.promise)}async fetch(e){let{event:n}=this,r=S(e);if(r.mode===`navigate`&&n instanceof FetchEvent&&n.preloadResponse){let e=await n.preloadResponse;if(e)return e}let i=this.hasCallback(`fetchDidFail`)?r.clone():null;try{for(let e of this.iterateCallbacks(`requestWillFetch`))r=await e({request:r.clone(),event:n})}catch(e){if(e instanceof Error)throw new t(`plugin-error-request-will-fetch`,{thrownErrorMessage:e.message})}let a=r.clone();try{let e;e=await fetch(r,r.mode===`navigate`?void 0:this._strategy.fetchOptions);for(let t of this.iterateCallbacks(`fetchDidSucceed`))e=await t({event:n,request:a,response:e});return e}catch(e){throw i&&await this.runCallbacks(`fetchDidFail`,{error:e,event:n,originalRequest:i.clone(),request:a.clone()}),e}}async fetchAndCachePut(e){let t=await this.fetch(e),n=t.clone();return this.waitUntil(this.cachePut(e,n)),t}async cacheMatch(e){let t=S(e),n,{cacheName:r,matchOptions:i}=this._strategy,a=await this.getCacheKey(t,`read`),o=Object.assign(Object.assign({},i),{cacheName:r});n=await caches.match(a,o);for(let e of this.iterateCallbacks(`cachedResponseWillBeUsed`))n=await e({cacheName:r,matchOptions:i,cachedResponse:n,request:a,event:this.event})||void 0;return n}async cachePut(e,n){let r=S(e);await x(0);let i=await this.getCacheKey(r,`write`);if(!n)throw new t(`cache-put-with-no-response`,{url:m(i.url)});let a=await this._ensureResponseSafeToCache(n);if(!a)return!1;let{cacheName:o,matchOptions:s}=this._strategy,c=await self.caches.open(o),l=this.hasCallback(`cacheDidUpdate`),u=l?await g(c,i.clone(),[`__WB_REVISION__`],s):null;try{await c.put(i,l?a.clone():a)}catch(e){if(e instanceof Error)throw e.name===`QuotaExceededError`&&await b(),e}for(let e of this.iterateCallbacks(`cacheDidUpdate`))await e({cacheName:o,oldResponse:u,newResponse:a.clone(),request:i,event:this.event});return!0}async getCacheKey(e,t){let n=`${e.url} | ${t}`;if(!this._cacheKeys[n]){let r=e;for(let e of this.iterateCallbacks(`cacheKeyWillBeUsed`))r=S(await e({mode:t,request:r,event:this.event,params:this.params}));this._cacheKeys[n]=r}return this._cacheKeys[n]}hasCallback(e){for(let t of this._strategy.plugins)if(e in t)return!0;return!1}async runCallbacks(e,t){for(let n of this.iterateCallbacks(e))await n(t)}*iterateCallbacks(e){for(let t of this._strategy.plugins)if(typeof t[e]==`function`){let n=this._pluginStateMap.get(t);yield r=>{let i=Object.assign(Object.assign({},r),{state:n});return t[e](i)}}}waitUntil(e){return this._extendLifetimePromises.push(e),e}async doneWaiting(){for(;this._extendLifetimePromises.length;){let e=this._extendLifetimePromises.splice(0),t=(await Promise.allSettled(e)).find(e=>e.status===`rejected`);if(t)throw t.reason}}destroy(){this._handlerDeferred.resolve(null)}async _ensureResponseSafeToCache(e){let t=e,n=!1;for(let e of this.iterateCallbacks(`cacheWillUpdate`))if(t=await e({request:this.request,response:t,event:this.event})||void 0,n=!0,!t)break;return n||t&&t.status!==200&&(t=void 0),t}},w=class{constructor(e={}){this.cacheName=a.getRuntimeName(e.cacheName),this.plugins=e.plugins||[],this.fetchOptions=e.fetchOptions,this.matchOptions=e.matchOptions}handle(e){let[t]=this.handleAll(e);return t}handleAll(e){e instanceof FetchEvent&&(e={event:e,request:e.request});let t=e.event,n=typeof e.request==`string`?new Request(e.request):e.request,r=`params`in e?e.params:void 0,i=new C(this,{event:t,request:n,params:r}),a=this._getResponse(i,n,t);return[a,this._awaitComplete(a,i,n,t)]}async _getResponse(e,n,r){await e.runCallbacks(`handlerWillStart`,{event:r,request:n});let i;try{if(i=await this._handle(n,e),!i||i.type===`error`)throw new t(`no-response`,{url:n.url})}catch(t){if(t instanceof Error){for(let a of e.iterateCallbacks(`handlerDidError`))if(i=await a({error:t,event:r,request:n}),i)break}if(!i)throw t}for(let t of e.iterateCallbacks(`handlerWillRespond`))i=await t({event:r,request:n,response:i});return i}async _awaitComplete(e,t,n,r){let i,a;try{i=await e}catch{}try{await t.runCallbacks(`handlerDidRespond`,{event:r,request:n,response:i}),await t.doneWaiting()}catch(e){e instanceof Error&&(a=e)}if(await t.runCallbacks(`handlerDidComplete`,{event:r,request:n,response:i,error:a}),t.destroy(),a)throw a}},T=class e extends w{constructor(t={}){t.cacheName=a.getPrecacheName(t.cacheName),super(t),this._fallbackToNetwork=t.fallbackToNetwork!==!1,this.plugins.push(e.copyRedirectedCacheableResponsesPlugin)}async _handle(e,t){return await t.cacheMatch(e)||(t.event&&t.event.type===`install`?await this._handleInstall(e,t):await this._handleFetch(e,t))}async _handleFetch(e,n){let r,i=n.params||{};if(this._fallbackToNetwork){let t=i.integrity,a=e.integrity,o=!a||a===t;r=await n.fetch(new Request(e,{integrity:e.mode===`no-cors`?void 0:a||t})),t&&o&&e.mode!==`no-cors`&&(this._useDefaultCacheabilityPluginIfNeeded(),await n.cachePut(e,r.clone()))}else throw new t(`missing-precache-entry`,{cacheName:this.cacheName,url:e.url});return r}async _handleInstall(e,n){this._useDefaultCacheabilityPluginIfNeeded();let r=await n.fetch(e);if(!await n.cachePut(e,r.clone()))throw new t(`bad-precaching-response`,{url:e.url,status:r.status});return r}_useDefaultCacheabilityPluginIfNeeded(){let t=null,n=0;for(let[r,i]of this.plugins.entries())i!==e.copyRedirectedCacheableResponsesPlugin&&(i===e.defaultPrecacheCacheabilityPlugin&&(t=r),i.cacheWillUpdate&&n++);n===0?this.plugins.push(e.defaultPrecacheCacheabilityPlugin):n>1&&t!==null&&this.plugins.splice(t,1)}};T.defaultPrecacheCacheabilityPlugin={async cacheWillUpdate({response:e}){return!e||e.status>=400?null:e}},T.copyRedirectedCacheableResponsesPlugin={async cacheWillUpdate({response:e}){return e.redirected?await p(e):e}};var E=class{constructor({cacheName:e,plugins:t=[],fallbackToNetwork:n=!0}={}){this._urlsToCacheKeys=new Map,this._urlsToCacheModes=new Map,this._cacheKeysToIntegrities=new Map,this._strategy=new T({cacheName:a.getPrecacheName(e),plugins:[...t,new u({precacheController:this})],fallbackToNetwork:n}),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),!0)}addToCacheList(e){let n=[];for(let r of e){typeof r==`string`?n.push(r):r&&r.revision===void 0&&n.push(r.url);let{cacheKey:e,url:i}=c(r),a=typeof r!=`string`&&r.revision?`reload`:`default`;if(this._urlsToCacheKeys.has(i)&&this._urlsToCacheKeys.get(i)!==e)throw new t(`add-to-cache-list-conflicting-entries`,{firstEntry:this._urlsToCacheKeys.get(i),secondEntry:e});if(typeof r!=`string`&&r.integrity){if(this._cacheKeysToIntegrities.has(e)&&this._cacheKeysToIntegrities.get(e)!==r.integrity)throw new t(`add-to-cache-list-conflicting-integrities`,{url:i});this._cacheKeysToIntegrities.set(e,r.integrity)}if(this._urlsToCacheKeys.set(i,e),this._urlsToCacheModes.set(i,a),n.length>0){let e=`Workbox is precaching URLs without revision info: ${n.join(`, `)}\nThis is generally NOT safe. Learn more at https://bit.ly/wb-precache`;console.warn(e)}}}install(e){return o(e,async()=>{let t=new l;this.strategy.plugins.push(t);for(let[t,n]of this._urlsToCacheKeys){let r=this._cacheKeysToIntegrities.get(n),i=this._urlsToCacheModes.get(t),a=new Request(t,{integrity:r,cache:i,credentials:`same-origin`});await Promise.all(this.strategy.handleAll({params:{cacheKey:n},request:a,event:e}))}let{updatedURLs:n,notUpdatedURLs:r}=t;return{updatedURLs:n,notUpdatedURLs:r}})}activate(e){return o(e,async()=>{let e=await self.caches.open(this.strategy.cacheName),t=await e.keys(),n=new Set(this._urlsToCacheKeys.values()),r=[];for(let i of t)n.has(i.url)||(await e.delete(i),r.push(i.url));return{deletedURLs:r}})}getURLsToCacheKeys(){return this._urlsToCacheKeys}getCachedURLs(){return[...this._urlsToCacheKeys.keys()]}getCacheKeyForURL(e){let t=new URL(e,location.href);return this._urlsToCacheKeys.get(t.href)}getIntegrityForCacheKey(e){return this._cacheKeysToIntegrities.get(e)}async matchPrecache(e){let t=e instanceof Request?e.url:e,n=this.getCacheKeyForURL(t);if(n)return(await self.caches.open(this.strategy.cacheName)).match(n)}createHandlerBoundToURL(e){let n=this.getCacheKeyForURL(e);if(!n)throw new t(`non-precached-url`,{url:e});return t=>(t.request=new Request(e),t.params=Object.assign({cacheKey:n},t.params),this.strategy.handle(t))}},D,O=()=>(D||=new E,D);try{self[`workbox:routing:7.3.0`]&&_()}catch{}var k=e=>e&&typeof e==`object`?e:{handle:e},A=class{constructor(e,t,n=`GET`){this.handler=k(t),this.match=e,this.method=n}setCatchHandler(e){this.catchHandler=k(e)}},j=class extends A{constructor(e,t,n){super(({url:t})=>{let n=e.exec(t.href);if(n&&!(t.origin!==location.origin&&n.index!==0))return n.slice(1)},t,n)}},M=class{constructor(){this._routes=new Map,this._defaultHandlerMap=new Map}get routes(){return this._routes}addFetchListener(){self.addEventListener(`fetch`,(e=>{let{request:t}=e,n=this.handleRequest({request:t,event:e});n&&e.respondWith(n)}))}addCacheListener(){self.addEventListener(`message`,(e=>{if(e.data&&e.data.type===`CACHE_URLS`){let{payload:t}=e.data,n=Promise.all(t.urlsToCache.map(t=>{typeof t==`string`&&(t=[t]);let n=new Request(...t);return this.handleRequest({request:n,event:e})}));e.waitUntil(n),e.ports&&e.ports[0]&&n.then(()=>e.ports[0].postMessage(!0))}}))}handleRequest({request:e,event:t}){let n=new URL(e.url,location.href);if(!n.protocol.startsWith(`http`))return;let r=n.origin===location.origin,{params:i,route:a}=this.findMatchingRoute({event:t,request:e,sameOrigin:r,url:n}),o=a&&a.handler,s=e.method;if(!o&&this._defaultHandlerMap.has(s)&&(o=this._defaultHandlerMap.get(s)),!o)return;let c;try{c=o.handle({url:n,request:e,event:t,params:i})}catch(e){c=Promise.reject(e)}let l=a&&a.catchHandler;return c instanceof Promise&&(this._catchHandler||l)&&(c=c.catch(async r=>{if(l)try{return await l.handle({url:n,request:e,event:t,params:i})}catch(e){e instanceof Error&&(r=e)}if(this._catchHandler)return this._catchHandler.handle({url:n,request:e,event:t});throw r})),c}findMatchingRoute({url:e,sameOrigin:t,request:n,event:r}){let i=this._routes.get(n.method)||[];for(let a of i){let i,o=a.match({url:e,sameOrigin:t,request:n,event:r});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:a,params:i}}return{}}setDefaultHandler(e,t=`GET`){this._defaultHandlerMap.set(t,k(e))}setCatchHandler(e){this._catchHandler=k(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 t(`unregister-route-but-not-found-with-method`,{method:e.method});let n=this._routes.get(e.method).indexOf(e);if(n>-1)this._routes.get(e.method).splice(n,1);else throw new t(`unregister-route-route-not-registered`)}},N,P=()=>(N||(N=new M,N.addFetchListener(),N.addCacheListener()),N);function F(e,n,r){let i;if(typeof e==`string`){let t=new URL(e,location.href);i=new A(({url:e})=>e.href===t.href,n,r)}else if(e instanceof RegExp)i=new j(e,n,r);else if(typeof e==`function`)i=new A(e,n,r);else if(e instanceof A)i=e;else throw new t(`unsupported-route-type`,{moduleName:`workbox-routing`,funcName:`registerRoute`,paramName:`capture`});return P().registerRoute(i),i}function I(e,t=[]){for(let n of[...e.searchParams.keys()])t.some(e=>e.test(n))&&e.searchParams.delete(n);return e}function*L(e,{ignoreURLParametersMatching:t=[/^utm_/,/^fbclid$/],directoryIndex:n=`index.html`,cleanURLs:r=!0,urlManipulation:i}={}){let a=new URL(e,location.href);a.hash=``,yield a.href;let o=I(a,t);if(yield o.href,n&&o.pathname.endsWith(`/`)){let e=new URL(o.href);e.pathname+=n,yield e.href}if(r){let e=new URL(o.href);e.pathname+=`.html`,yield e.href}if(i){let e=i({url:a});for(let t of e)yield t.href}}var R=class extends A{constructor(e,t){super(({request:n})=>{let r=e.getURLsToCacheKeys();for(let i of L(n.url,t)){let t=r.get(i);if(t)return{cacheKey:t,integrity:e.getIntegrityForCacheKey(t)}}},e.strategy)}};function z(e){F(new R(O(),e))}var B=`-precache-`,V=async(e,t=B)=>{let n=(await self.caches.keys()).filter(n=>n.includes(t)&&n.includes(self.registration.scope)&&n!==e);return await Promise.all(n.map(e=>self.caches.delete(e))),n};function H(){self.addEventListener(`activate`,(e=>{let t=a.getPrecacheName();e.waitUntil(V(t).then(e=>{}))}))}function U(e){O().precache(e)}function W(e,t){U(e),z(t)}var G=class extends w{async _handle(e,n){let r=await n.cacheMatch(e),i;if(!r)try{r=await n.fetchAndCachePut(e)}catch(e){e instanceof Error&&(i=e)}if(!r)throw new t(`no-response`,{url:e.url,error:i});return r}};W([{"revision":"a526faed8aec2751ec33b6b98d4b6964","url":"index.html"},{"revision":"26dccd02a2ef7522892015154f5e3680","url":"manifest.webmanifest"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-512.svg"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-192.svg"},{"revision":null,"url":"assets/index-Dh5apC3I.css"},{"revision":null,"url":"assets/index-CyDLBddf.js"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-192.svg"},{"revision":"a0fb34fc84eb148d51812cd62669f20d","url":"icon-512.svg"},{"revision":"26dccd02a2ef7522892015154f5e3680","url":"manifest.webmanifest"}]),H();var K=e=>(e.headers.get(`content-type`)??``).startsWith(`text/html`);F(({url:e})=>e.pathname.startsWith(`/assets/`),new G({cacheName:`ppm-assets`,plugins:[{cacheWillUpdate:async({response:e})=>K(e)?null:e,cachedResponseWillBeUsed:async({cachedResponse:e})=>e&&K(e)?null:e}]})),self.skipWaiting(),self.addEventListener(`activate`,()=>{self.clients.claim()});

package/docs/architecture/android-emulator-phase0-report-260921.md

@@ -0,0 +1,310 @@
+# Phase 0 report — Android Emulator trong PPM
+
+Ngày: 2026-09-21. Đối chiếu plan: `docs/architecture/android-emulator-plan-260920.md`.
+Spike: `spikes/android/` (không nằm trong build, không ship).
+
+## 1. Kết luận cổng (gate)
+
+Plan §9 đặt gate Phase 0 là: *"boot/stream/control/cleanup thật và ngân sách sơ bộ đạt"*.
+
+**Phần đã đo: đạt.** Boot, stream, control và cleanup đều chạy thật trên host Linux này, và mọi
+chỉ số đo được đều nằm trong ngân sách §10 — phần lớn là cách ngân sách một quãng rộng.
+
+**Phần chưa đo: click-to-visible, LAN/tunnel, reconnect, soak.** Bốn mục này đều cần một viewer
+trong trình duyệt mà Phase 0 không dựng. Chúng **chưa được chứng minh**, không phải đã đạt.
+
+Quan trọng hơn cả các con số: hai giả định trong plan sai, và ba thứ plan không biết đã xuất
+hiện — trong đó có một thứ làm bàn phím chết im lặng.
+
+## 2. Môi trường đo
+
+| Thành phần | Phiên bản |
+|---|---|
+| Host | Linux 7.2.6 CachyOS, i9-12900K (24 luồng), Intel UHD 770, 62 GiB RAM |
+| Bun | 1.3.11 |
+| Android emulator | 36.5.10.0, build 15081367 |
+| adb | 1.0.41 (37.0.0-android-tools) |
+| ffmpeg | n9.0.1 |
+| `@grpc/grpc-js` | 1.14.0 |
+| `@grpc/proto-loader` | 0.7.15 |
+| AVD test | `ppm_spike_test`, API 35 `google_apis_playstore_tablet` x86_64, pixel_6, 1080x2400 @420dpi |
+| GPU emulator | `swiftshader_indirect` (phần mềm) |
+
+AVD test do task tạo trong `ANDROID_AVD_HOME=/home/thawngho/.android-spike-avd`. `Pixel_9` và
+`Pixel_Tablet` của người dùng **không bị đụng**; đã verify cả hai chiều: emulator chỉ thấy AVD
+spike khi biến môi trường được set, và chỉ thấy AVD người dùng khi không.
+
+## 3. ADR-A — gRPC dưới Bun: **đạt**
+
+| Phép đo | Kết quả |
+|---|---|
+| `getStatus` lần đầu (gồm bắt tay HTTP/2) | 1617.9 ms |
+| `getStatus` steady-state, 50 lần | p50 **0.68 ms**, p95 1.32 ms, max 1.95 ms |
+| `getScreenshot` RGB888 full-res | 7.776.000 byte (đúng `1080×2400×3`) trong 21.3 ms |
+| `getDisplayConfigurations` | OK, 1 display, `maxDisplays: 11` |
+| Deadline unary | Fire đúng, `DEADLINE_EXCEEDED` |
+| Cancel stream | `CANCELLED`, **0 frame giao sau `cancel()`** |
+| 25 vòng create/cancel | Emulator vẫn trả lời, client đóng sạch |
+
+p50 0.68 ms nghĩa là đường **input** qua grpc-js gần như không tốn gì. Không cần lo phần này.
+
+### Compiled binary: hỏng theo cách đã đoán trước, và đã sửa
+
+Chạy binary `bun build --compile` từ thư mục ngoài checkout:
+
+```
+ENOENT  at loadProtosWithOptionsSync (/$bunfs/root/spike-naive:23060:37)
+```
+
+`@grpc/proto-loader.loadSync()` đọc file `.proto` từ đĩa lúc chạy; trong binary đường dẫn trỏ vào
+`/$bunfs/root/` nên không có file. Đây đúng bài học "compiled PPM không với tới node_modules của
+chính nó" trong CLAUDE.md, và nó xác nhận quyết định *"build-time generate"* của ADR-A bằng một
+thất bại đo được chứ không phải suy luận.
+
+Cách sửa đã chứng minh: `bun gen-proto-json.ts` sinh descriptor JSON (48 KiB) → `import` vào module
+→ `protoLoader.fromJSON()`. Sau đó binary chạy từ `/tmp/.../elsewhere` với `getStatus` 17.5 ms, và
+toàn bộ bài cancellation/deadline/cleanup pass **giống hệt bản chạy từ source**.
+
+→ **`loadSync` không được phép xuất hiện trong code PPM.** Chỉ `fromJSON` với descriptor nhúng.
+
+## 4. ADR-B — media: đo xong, và nghi ngờ lớn nhất về nó là **sai**
+
+Plan tính 720p30 RGB = 83 MB/s và lo grpc-js không kham nổi. Đo thật, với chuyển động liên tục
+(stopwatch đang chạy — xác minh 8/8 frame khác nhau trước khi đo):
+
+| Cấu hình | fps | Băng thông | gap p50/p95/max | Rớt frame |
+|---|---|---|---|---|
+| RGB888 720×1600 | 39.9 | 131.9 MiB/s | 26.7 / 37.8 / 45.8 ms | **0** |
+| RGB888 1080×2400 | 40.0 | **297.4 MiB/s** | 23.2 / 39.1 / 45.9 ms | **0** |
+| MMAP 720×1600 | 39.8 | **0 byte qua gRPC** | 23.7 / 37.9 / 48.3 ms | 0 |
+
+grpc-js dưới Bun tải được **297 MiB/s** ở full-res mà không rớt frame nào (seq liên tục 1..398).
+Ngưỡng 83 MB/s mà plan lo không phải là ngưỡng.
+
+**Màn hình tĩnh thì gần như miễn phí**: 2.1 fps, gap đều 500 ms, không rớt frame. Emulator chỉ gửi
+khi khung hình đổi, cộng một nhịp giữ 500 ms. Rất hợp với ngân sách "Idle/ẩn" §10.
+
+> Cảnh báo cho người đo sau: đo trên màn hình tĩnh cho ra **2 fps** và trông y như một giới hạn
+> cứng của `streamScreenshot`. Không phải. Swipe rời rạc cũng không đủ — nó chỉ tạo hai trạng thái
+> (đo được: 2/8 frame khác nhau). Phải có nguồn động thật; stopwatch của app Clock là nguồn rẻ nhất.
+
+### Pipeline đầy đủ gRPC RGB → ffmpeg → H.264
+
+720×1600@30, cap 4 Mbit/s, 12 giây: 359 frame vào ffmpeg, **`ffprobe` đọc ra đúng 360 frame**,
+h264/yuv420p, bitrate **3.90 Mbit/s** — nằm trong mục tiêu 2–6 Mbps của §10.
+
+| Encoder | CPU ffmpeg | RSS | Bitrate | Frame decode |
+|---|---|---|---|---|
+| `libx264` veryfast/zerolatency | 64–80% một core (tăng dần) | ~103 MB | 4.10 Mbit/s | 390 |
+| **`h264_vaapi`** | **33.1–33.6%** (phẳng) | ~97 MB | 4.03 Mbit/s | 390 |
+
+VAAPI dùng **nửa CPU**, phẳng, cùng bitrate, cùng số frame. Cả `h264_vaapi` và `h264_qsv` chạy được
+trên Intel UHD 770 này. Lưu ý `ffmpeg -encoders` cũng liệt kê `h264_amf` và `h264_nvenc` trên máy
+Intel — đúng lý do `workingEncoders()` phải test-encode thật thay vì đọc danh sách.
+
+### Quyết định ADR-B
+
+**Giữ option 1 (gRPC RGB → ffmpeg → H.264) làm đường chính.** Không cần chuyển sang scrcpy.
+Lý do là số đo, không phải sở thích: throughput dư 3–4 lần, không rớt frame, input latency p50
+dưới 1 ms, và pipeline đã cho ra stream H.264 decode được đúng số frame.
+
+**MMAP để dành, chưa dùng ở v1.** Nó chạy và đưa pixel ra khỏi gRPC hoàn toàn, nhưng fps không
+đổi vì gRPC vốn đã không phải nút thắt. Nó là đòn bẩy để giảm CPU/bộ nhớ khi có nhiều máy cùng
+chạy, và proto tự cảnh báo *"the mmap can result in tearing"*. Đưa vào khi có lý do đo được.
+
+## 5. Ba thứ plan không biết
+
+### 5.1 `ImageTransport.MMAP` — ADR-B thiếu hẳn một phương án
+
+`emulator_controller.proto` field 6 cho **client sở hữu** một handle shm/mmap để emulator ghi frame
+vào; gRPC khi đó chỉ mang metadata (`seq`, `timestampUs`). Đo được: 318/318 frame có pixel thật
+trong buffer chung, **0 byte** pixel đi qua gRPC. Bảng phương án của ADR-B nên có thêm dòng này.
+
+### 5.2 Emulator tự scale phía server — nhưng là **hộp bao**, không phải kích thước yêu cầu
+
+`ImageFormat.width/height` làm emulator scale **trước khi gửi**: xin 720×1600 trả về đúng
+720×1600 (3.456.000 byte, khớp chính xác). Không cần gửi full-res rồi scale ở host. Plan không nói.
+
+**Đính chính ở Phase 2:** trả đúng 720×1600 là vì con số đó khớp tỉ lệ của thiết bị. Proto nói rõ
+hơn thế: *"The returned image will never exceed the given width, but can be less"*, scale *"while
+maintaining the aspect ratio of the device"* — tức đây là **hộp bao**, không phải kích thước ra
+lệnh. Hai hệ quả: (1) phải xin hộp **vuông** `H×H` để trần áp lên cạnh dài, nếu không một guest
+xoay ngang lọt vào hộp dọc sẽ teo lại còn một dải mỏng; (2) kích thước thật phải đọc từ
+`format.width/height` của **chính frame** (là trường output), không được giả định — và đó cũng là
+thứ làm việc xoay màn hình chạy đúng mà không phải đoán.
+
+### 5.3 ~~Thứ tự pixel là **bottom-up**~~ — **SAI, đã đo lại ở Phase 2**
+
+Mục này từng ghi: *proto nói "from left to right and bottom up", nên chuỗi filter ffmpeg phải có
+`vflip`*. Đó là **chép lại comment trong proto, chưa từng đo**. Phase 2 đo trực tiếp bằng cách so
+từng hàng buffer gRPC với `adb exec-out screencap` (ảnh này chắc chắn top-down):
+
+| căn hàng | chênh lệch trung bình / pixel |
+|---|---|
+| `grpc[y]` ↔ `screencap[y]` | **1.21** |
+| `grpc[y]` ↔ `screencap[h-1-y]` | **37.15** |
+
+Trên emulator 36.5.10 buffer là **top-down**. Thêm `vflip` sẽ làm **mọi màn hình lộn ngược**, và
+không có lỗi nào báo. Đã bỏ khỏi `encoderArgs`; `tests/e2e/android-e2e.ts` giữ lại phép so này làm
+chốt chặn hồi quy, phòng khi một bản emulator sau này đúng là bottom-up thật.
+
+Bài học chung: một câu trong tài liệu vendor không phải là phép đo.
+
+### 5.4 Toạ độ `sendTouch` là **panel gốc chưa xoay** (đo ở Phase 2)
+
+Proto chỉ nói *"the physical location on the screen"*. Đo bằng `getevent` trên chính guest: màn
+hình cảm ứng báo dải tuyệt đối 0..32767, và toạ độ gửi vào được chuẩn hoá theo kích thước
+**panel** (`hw.lcd.width` × `hw.lcd.height`) — gửi x=2000 trên panel rộng 1080 cho ra 60679, tức
+2000/1080 toàn thang, vượt dải và bị kẹp. Điều này **không đổi khi xoay**, nên frame đã xoay phải
+được xoay ngược lại trước khi gửi. Chiều xoay đo riêng cho từng hướng bằng cách chạm vào một điểm
+panel đã biết với `show_touches`, rồi tìm dấu chạm trong frame; mỗi hướng thắng phương án nhì cách
+biệt một bậc (90°: 0.040 so với 0.449; 180°: 0.003 so với 0.433; 270°: 0.080 so với 0.420).
+
+### 5.5 Stream ảnh **không mở lại được sau khi cancel** (đo ở Phase 2)
+
+Sau khi `streamScreenshot` bị cancel, mọi stream mở sau đó trả **đúng 1 frame** rồi im — kể cả
+trên channel gRPC mới. Hệ quả thiết kế: đổi mức chất lượng **không được** đóng/mở lại stream. PPM
+mở đúng một stream ở trần rung cao nhất cho cả phiên và đổi rung bằng `scale` trong ffmpeg.
+
+## 6. Hai chỗ plan nói sai
+
+### 6.1 §7 — plan đúng, bản nháp report này từng ghi sai
+
+Bản đầu của report kết luận "không có kiểm tra Origin nào cả". **Sai, do grep thiếu thư mục.**
+Lần quét đầu chỉ có `src/server/ws/`, `src/server/middleware/` và `src/server/index.ts`, bỏ sót
+`src/server/routes/`. Kiểm tra đó nằm ở `src/server/routes/remote-desktop.ts:28-46`
+(`assertSessionAllowed`), và đúng là **hostname-only** như plan mô tả — có chủ ý, có comment: dev
+proxy của Vite ghi đè `Host` mà không thêm `X-Forwarded-Host`, nên so cả `host:port` sẽ chặn mọi
+phiên chạy ở chế độ dev. `named-tunnel.ts` và `accounts.ts` cũng có bản sao của khuôn này.
+
+Nên §7 của plan giữ nguyên, và lời cảnh báo của nó vẫn đáng giá: dùng lại khuôn đó thì được, nhưng
+nó **không** phải bảo đảm same-origin đầy đủ — một trang khác **port** trên cùng hostname vẫn qua.
+
+### 6.2 §12 — Unicode qua gRPC: câu trả lời là **không**
+
+Đo với bàn phím hoạt động, ô nhập đã focus, re-verify focus trước từng lần gõ:
+
+| Gửi | Nhận | |
+|---|---|---|
+| `text: "hello"` | `hello` | INTACT |
+| `key` h,e,l,l,o | `hello` | INTACT |
+| `text: "café"` | **`caf`** | ký tự có dấu bị nuốt im lặng |
+| `text: "Tiếng Việt"` | `""` | mất sạch |
+| `text: "😀"` | `""` | mất sạch |
+| `text: "日本語"` | `""` | mất sạch |
+
+Proto tự ghi giới hạn này (*"only printable ASCII [32-127)"*), và đo khớp. Kiểu hỏng là tệ nhất:
+**không lỗi, chỉ cắt cụt âm thầm**.
+
+`setClipboard` thì giữ nguyên `"Tiếng Việt 😀"` — xác minh cả bằng round-trip API lẫn bằng mắt
+(chip gợi ý clipboard của Android hiện đúng chuỗi kèm emoji trong guest).
+
+→ **E2E case 3 của plan không thể đạt bằng `sendKey`/`text`.** Toàn bộ chuyện gõ tiếng Việt và
+IME mobile ở §6 phải xây trên đường clipboard, không phải trên `text`.
+
+## 7. Bẫy vận hành phát hiện khi đo
+
+**`hw.keyboard=no` là mặc định của `avdmanager`, và nó giết bàn phím trong im lặng.**
+Đây là thứ tốn nhiều thời gian nhất của Phase 0. Triệu chứng: gRPC touch chạy hoàn hảo, gRPC
+`sendKey` trả `OK` và **không có tác dụng gì**; `adb shell input text` thì vào bình thường.
+Không phải allowlist (allowlist sẽ trả `PERMISSION_DENIED`), không phải `-no-window` (đã boot lại
+với `-qt-hide-window`, y hệt). Nguyên nhân là một dòng trong `config.ini`:
+
+| AVD | `hw.keyboard` |
+|---|---|
+| tạo bằng `avdmanager` | **`no`** |
+| tạo bằng Android Studio | `yes` |
+
+Lật thành `yes` rồi boot lại: cả ba đường (`key`, keydown/keyup, evdev `keyCode`) chạy ngay.
+→ Phase 4 (tạo AVD) **bắt buộc** ghi `hw.keyboard=yes`; plan §9 Phase 4 hiện không nhắc.
+
+**`-grpc <port>` tắt JWT.** `emulator -help` ghi `-grpc-use-jwt ... (default, disable with -grpc
+flag)`. Ghim port cố định = tự hạ kênh điều khiển xuống không xác thực, trái §7. Luôn discovery.
+Thực tế trên máy này gRPC bật sẵn không cần cờ nào: `Started GRPC server at 127.0.0.1:8554,
+security: Local, auth: +token`, và emulator tự cảnh báo *"Basic token auth should only be used by
+android-studio"* → PPM không phải Studio, đường đúng là JWT.
+
+**`ANDROID_AVD_HOME` thay thế chứ không cộng dồn.** Set nó thì AVD của người dùng biến mất khỏi
+`-list-avds`. Plan §5 nói "tôn trọng AVD home overrides" nhưng không nói chiều này: PPM **không**
+được set biến này toàn cục.
+
+**`Touch.pressure` phải về 0 khi nhả.** Proto: identifier không nhận pressure 0 thì không được giải
+phóng. Emulator có lưới an toàn riêng — `EventExpiration` mặc định **120 giây** — nhưng 120 s quá
+dài cho UX, nên timeout phía PPM ở §6 vẫn cần và phải ngắn hơn nhiều.
+
+**Dừng máy bằng `setVmState SHUTDOWN`** qua gRPC: pid biến mất sau 1–3 giây. Không cần kill theo
+tên process. Nhân tiện xác nhận cảnh báo của plan là thật: `pgrep qemu-system` trên máy này bắt
+trúng **Docker Desktop**.
+
+## 8. Hai bẫy pipeline, cả hai đã tái hiện được
+
+**Pacing phải tính theo deadline tích luỹ.** Đẩy mọi frame rồi để `-vf fps=30` lọc là lãng phí
+(đo: 318 frame đẩy vào để ra 240). Nhưng cách pace hiển nhiên — "đã qua một chu kỳ kể từ frame
+nhận cuối chưa" — biến nguồn 40 fps thành **20 fps** ở mục tiêu 30 fps: frame sau đến ở 25 ms bị
+loại, frame kế tiếp lấy ở 50 ms. Đo được 242 frame trong 12 giây thay vì 360. Phải dùng
+`nextDue = max(now, nextDue + interval)`; sửa xong ra đúng 360.
+
+**Bun `FileSink.write()` chỉ buffer.** Nó trả về số byte ngay lập tức, nên một vòng lặp ghi tự nó
+không chứng minh được gì đã tới ffmpeg; `flush()` mới đẩy. Ghi nhận trung thực: sau khi đã ghi
+đúng bội số nguyên của frame (`remainder 0`, kiểm bằng bộ đếm byte) ffmpeg **vẫn** báo
+`Invalid buffer size ... packet size N < expected frame_size M` ở cuối stream. Thêm 1500 ms drain
+không hết, phần dư còn to hơn — nên giả thuyết "Bun vứt buffer khi `end()`" là **sai**. Đây là
+artifact lúc đóng: nguồn 40 fps nhanh hơn ffmpeg 30 fps nên pipe còn tồn đọng khi close.
+`ffprobe` xác nhận stream ra đủ 360/360 frame, không frame nào hỏng. Pacing làm nó nhỏ đi nhiều.
+**Chưa truy đến tận cùng**; nếu về sau ghi log ffmpeg cho người dùng thì phải xử lý dòng này,
+đừng để nó trông như lỗi.
+
+## 9. Chưa đo — không được coi là đã đạt
+
+| §10 | Trạng thái |
+|---|---|
+| fps khi chuyển động | ✅ 39.9–40.0 |
+| bitrate 2–6 Mbps | ✅ 3.90–4.13 Mbit/s |
+| first frame ≤3 s | ✅ 29–59 ms |
+| CPU ≤1 core / RSS ≤250 MiB | ✅ VAAPI 0.33 core, 97 MB |
+| idle dừng feed | ✅ 2 fps màn hình tĩnh |
+| **LAN input-to-visible p95 ≤150 ms** | ❌ chưa đo |
+| **Tunnel p95 ≤300 ms** | ❌ chưa đo |
+| **Reconnect ≤5 s** | ❌ chưa đo |
+| **Soak 60 phút** | ❌ chưa đo |
+| **Ảnh hưởng chat/terminal** | ❌ chưa đo |
+| Windows / macOS | ❌ chưa đo, máy này chỉ chứng minh Linux |
+| Trình duyệt thật (Safari/Chrome mobile) | ❌ chưa đo |
+
+Bốn mục đầu đều cần viewer trong trình duyệt. Chúng nên là điều kiện vào Phase 2, không phải thứ
+bỏ qua.
+
+## 10. Việc phải sửa trong plan trước khi sang Phase 1
+
+1. **§7**: không cần sửa — plan đúng. (Bản nháp report này từng ghi ngược lại vì grep thiếu
+   `src/server/routes/`; đã đính chính ở §6.1.)
+2. **§12 + §6 + E2E case 3**: ghi Unicode qua `sendKey.text` là **không khả dụng**; đường tiếng Việt
+   và IME mobile phải là clipboard.
+3. **ADR-B**: thêm `ImageTransport.MMAP` vào bảng phương án; ghi quyết định giữ option 1 kèm số đo;
+   thêm ghi chú scale server-side và pixel bottom-up.
+4. **§9 Phase 4**: bắt buộc `hw.keyboard=yes` khi tạo AVD.
+5. **§5**: ghi `-grpc <port>` tắt JWT nên luôn discovery; ghi `ANDROID_AVD_HOME` thay thế chứ không
+   cộng dồn.
+6. **ADR-A**: ghi rõ cấm `protoLoader.loadSync`, chỉ `fromJSON` + descriptor sinh lúc build.
+
+## 11. Tái lập
+
+```bash
+cd spikes/android
+bun install
+ANDROID_AVD_HOME=... DISPLAY=:0 WINDOW_MODE=qt-hide-window ./boot-test-avd.sh &
+bun discovery.ts          # endpoint + auth từ file discovery
+bun smoke-getstatus.ts    # ADR-A: gRPC dưới Bun
+bun verify-rpcs.ts        # latency, screenshot PNG/RGB888, scale server-side
+bun focus-search.ts       # toạ độ chạm, đọc bounds thật từ uiautomator
+bun text-injection.ts     # giới hạn Unicode
+W=720 H=1600 bun bench-stream.ts     # cần chuyển động thật trên màn hình
+W=720 H=1600 bun bench-mmap.ts
+ENC=h264_vaapi W=720 H=1600 FPS=30 OUT=/tmp/o.h264 bun bench-encode.ts
+bun verify-cancel.ts      # deadline / cancel / cleanup
+bun gen-proto-json.ts && bun build --compile --outfile /tmp/s smoke-getstatus.ts
+bun stop-emulator.ts      # graceful, không kill theo tên
+```
+
+Dọn dẹp: `bun stop-emulator.ts`, rồi xoá `/home/thawngho/.android-spike-avd` và
+`/tmp/ppm-android-spike`. Spike có khởi động adb daemon (trước đó chưa chạy).

package/docs/architecture/android-emulator-phase2-report-260921.md

@@ -0,0 +1,163 @@
+# Phase 2 report — Viewer tab với điều khiển đầy đủ
+
+Ngày: 2026-09-21. Cổng Phase 1 đã qua (xem `android-emulator-phase0-report-260921.md` cho Phase 0).
+Bản này ghi **những gì đo được**, đặc biệt là ba chỗ Phase 0 và plan nói sai, và các quyết định
+thiết kế bị chính phép đo ép phải đổi.
+
+## 1. Kết quả
+
+| | |
+|---|---|
+| E2E mức dịch vụ (`tests/e2e/android-e2e.ts`) | **20/20**, lặp lại 3 lần đều pass |
+| E2E qua server thật (`tests/e2e/android-ws-e2e.ts`) | **18/18** |
+| Unit | 56 test Android (7 file), toàn bộ `tests/unit/web` + `tests/unit/android` 1542 pass |
+| `tsc --noEmit` | 0 lỗi |
+| `bun run build:web` | chunk riêng `android-tab-*.js`, 18.65 kB (gzip 6.23) |
+
+Thông lượng đo trên emulator 36.5.10, guest 1080×2400, host Intel UHD 770 + `h264_vaapi`:
+
+| | |
+|---|---|
+| Stream nguồn gRPC | **~55 fps, 864×1920, ~260 MiB/s**, giữ nguyên suốt 45 s không tụt |
+| Sau pacing 24 fps (rung `low`) | fed 192 frame / 8 s — đúng bằng mục tiêu |
+| Access unit ra | 199 / 8 s |
+| Keyframe | 14 / 8 s ở GOP nửa giây |
+| Codec | `avc1.64081f`, suy từ SPS thật |
+
+## 2. Ba chỗ tài liệu nói sai, và cái giá nếu tin theo
+
+### 2.1 `vflip` — plan và Phase 0 đều sai
+
+Cả hai ghi *"thứ tự pixel là bottom-up nên chuỗi filter phải có `vflip`"*. Cả hai **chép từ comment
+trong proto**, không đo. So từng hàng buffer gRPC với `adb exec-out screencap` (top-down chắc chắn):
+
+| căn hàng | chênh lệch trung bình / pixel |
+|---|---|
+| `grpc[y]` ↔ `screencap[y]` | **1.21** |
+| `grpc[y]` ↔ `screencap[h-1-y]` | **37.15** |
+
+Buffer **top-down**. `vflip` sẽ làm mọi màn hình lộn ngược, không lỗi, không log. Đã bỏ. Phép so
+này giữ lại trong `android-e2e.ts` làm chốt hồi quy — hai ảnh phải chụp lúc màn hình **đứng yên**,
+nếu đang cuộn thì biên độ tụt xuống mức nhiễu (đo được: 217 so với 232, so với 1.5 so với 247 khi
+đứng yên).
+
+### 2.2 `ImageFormat.width/height` là hộp bao, không phải kích thước ra lệnh
+
+Phase 0 kết luận "xin 720×1600 trả đúng 720×1600". Đúng, nhưng vì con số đó **khớp tỉ lệ thiết bị**.
+Proto nói rõ: *"will never exceed the given width, but can be less"*, giữ nguyên tỉ lệ. Hai hệ quả:
+
+- Hộp phải **vuông** (`H×H`), để trần áp lên **cạnh dài**. Hộp dọc 720×1600 với một guest xoay
+  ngang cho ra 720×324 — mất gần hết độ phân giải đúng lúc người dùng xoay máy.
+- Kích thước thật đọc từ `format.width/height` của **chính frame** (trường output), không giả định.
+  Đây cũng là thứ khiến xoay màn hình chạy đúng mà không phải đoán gì: `format.rotation` đi kèm.
+
+### 2.3 Stream ảnh không mở lại được sau khi cancel
+
+Thiết kế đầu của pipeline đổi rung bằng cách cancel stream rồi mở lại với hộp mới. Đo:
+
+| | frame nhận được |
+|---|---|
+| stream đầu tiên | bình thường (7 frame / 4 s màn hình ít đổi) |
+| mở lại ngay trên cùng channel | **1** |
+| mở lại sau 500 ms | **1** |
+| mở lại trên **channel gRPC mới** | **1** |
+
+Một stream đã cancel không thay thế được trên emulator 36.5.10. Thiết kế đổi thành: mở **đúng một**
+stream ở trần rung cao nhất (`STREAM_BOX = 1920`) cho cả phiên, đổi rung là `scale=W:H` trong ffmpeg
+cộng một encoder mới. Kết quả tốt hơn thiết kế cũ ở hai điểm khác nữa — không còn cửa sổ mất hình
+lúc chuyển, và không còn một lớp trạng thái emulator để hỏng.
+
+Chi phí: rung thấp vẫn nhận 864×1920 qua gRPC rồi mới scale xuống. Đo được là thừa sức — nguồn giữ
+260 MiB/s trong khi `h264_vaapi` chỉ tốn 0.33 core.
+
+## 3. Toạ độ chạm — đo bằng `getevent`, không suy luận
+
+`Touch.x/y` trong proto chỉ ghi *"the physical location on the screen"*. Đọc thẳng từ input device
+của guest:
+
+- Màn hình cảm ứng báo dải tuyệt đối **0..32767**, nên con số ở `getevent` là toạ độ đã chuẩn hoá.
+- Gửi (200, 2000) trên panel 1080×2400 → `X=6067 Y=27305`, khớp `200/1080` và `2000/2400` toàn thang.
+- Gửi x=2000 trên panel rộng 1080 → **60679**, tức `2000/1080` toàn thang: vượt dải, bị kẹp. Vậy
+  đơn vị là **pixel panel gốc**, và **không đổi khi xoay**.
+
+Chiều xoay đo riêng từng hướng: bật `show_touches`, chạm vào một điểm panel đã biết, tìm dấu chạm
+trong frame bằng **trung vị** các pixel đổi màu. Mỗi hướng thắng phương án nhì cách biệt một bậc:
+
+| hướng | phép biến đổi frame → panel | sai số | phương án nhì |
+|---|---|---|---|
+| 0° | `pu=fu, pv=fv` | ~0.006 | — |
+| 90° | `pu=1−fv, pv=fu` | 0.040 | 0.449 |
+| 180° | `pu=1−fu, pv=1−fv` | 0.003 | 0.433 |
+| 270° | `pu=fv, pv=1−fu` | 0.080 | 0.420 |
+
+Kiểm lại qua đường thật: frame(320,432) của 1280×576@90 → `frameToDevice` cho panel(270,600) →
+`getevent` báo 8191/8191, mong đợi 8192/8192.
+
+Hai bẫy trong chính phép đo này, đáng ghi vì đều làm ra kết quả *trông như đúng*:
+
+- Điểm dò đầu tiên là (900, 2000) trên panel 1080×2400. `900/1080 == 2000/2400 == 5/6`, nên hai
+  trục cho **cùng một con số** và một vụ đảo trục sẽ vô hình. Điểm dò phải lệch tỉ lệ ở hai trục.
+- Trung bình cộng bị kéo đi bởi bất cứ thứ gì nhấp nháy ở góc màn hình (đồng hồ). Lần đo đầu cho
+  0.5 ở mọi hướng — tức là đo cái đồng hồ. **Trung vị** mới ra kết quả.
+
+## 4. `streamScreenshot` là stream **theo thay đổi**
+
+> **Đính chính 2026-09-21.** Câu "không phải lỗi" bên dưới là sai, và chính cách đóng khung đó đã
+> để lọt một lỗi thật: sự kiện này được coi là chuyện của *phép đo* chứ không phải của *sản phẩm*.
+> Pipeline chỉ nạp ffmpeg khi có khung mới, nên trên màn hình đứng yên luồng H.264 im hẳn và người
+> mở viewer lúc đó kẹt ở "Waiting for the first frame…" cho tới khi guest có gì đó động đậy. Đã
+> sửa: nạp lại khung cuối theo nhịp fps của rung (`feedNow` + pacer trong `android-video.ts`), GOP
+> nửa giây nên người vào xem máy đứng im có keyframe trong vòng 500 ms. Đo trên máy thật, không
+> một thao tác nào: **143 khung, 10 keyframe trong 6 giây**. E2E cũ không thấy vì mọi kiểm tra đều
+> chạy kèm vòng swipe liên tục — nay `android-ws-e2e.ts` tắt vòng đó rồi mới nối viewer C.
+
+Không phải lỗi, nhưng làm hỏng mọi phép đo nếu không biết: màn hình đứng yên gần như không sinh
+frame, màn hình **đã tắt** thì không sinh frame nào. Một lần chạy e2e báo 0 access unit trong 8 s
+với pipeline hoàn toàn khoẻ — nguyên nhân là một cú chạm dò toạ độ đã **mở Play Store**, mà không
+có mạng thì đó là một bức ảnh tĩnh. `android-e2e.ts` vì thế phải: đánh thức guest, ghim `stayon`,
+đưa về launcher trước mỗi phép đo, và cuộn màn hình trong lúc đo. Khi số frame nguồn không nhúc
+nhích, nó in luôn cửa sổ đang focus — dòng đó là thứ đã giải được vụ này.
+
+## 5. Quyết định thiết kế
+
+| Quyết định | Lý do |
+|---|---|
+| Một pipeline **cho mỗi thiết bị**, nhiều viewer dùng chung | Người xem thứ hai không được tốn thêm một stream gRPC và một ffmpeg cho cùng số pixel |
+| Lease điều khiển theo **socket**, heartbeat 5 s / hết hạn 15 s | Hai người cùng chạm vào một guest không phải là tính năng. Máy gập nắp mất lease nhưng **vẫn xem được** |
+| `sessionGeneration` và `geometryGeneration` tách nhau | Một cái trả lời "client này còn được điều khiển không", cái kia "toạ độ này còn mô tả màn hình đang có không" |
+| Chuỗi codec `avc1.PPCCLL` suy từ **SPS thật**, gửi bằng message riêng | `encoderArgs` không đặt profile/level nên giá trị là mặc định của encoder, chỉ biết khi có bitstream. Đoán sai thì `configure()` ném lỗi |
+| Backpressure: **một** ngưỡng, không có thang | `ws.getBufferedAmount()` là hàng đợi userspace của Bun, đã đo là gần như bất động kể cả ở 0.4 Mbit/s qua relay thật (CLAUDE.md). Xây thang trên tín hiệu đó là xây trên cát |
+| Bàn phím đi qua **hidden textarea**, không qua `keydown` | IME gõ tiếng Việt gộp nhiều phím thành một ký tự; đọc `keydown` sẽ ra "Tieesng". Bàn phím ảo điện thoại không báo key code nào cả |
+| Chữ không phải ASCII đi qua **clipboard** | Phase 0 đo: `sendKey.text` im lặng nuốt mọi ký tự ngoài [32,127) |
+| Tab, không phải cửa sổ nổi như Remote Desktop | Chỉ có một desktop host để điều khiển, nhưng có thể có nhiều AVD, và người ta xem máy ảo **cạnh** code đang sửa |
+| Tính năng **tắt mặc định** | Nó dựng một máy ảo. Một máy có sẵn Android SDK không có nghĩa là người dùng đã đồng ý cho PPM chạy emulator trên đó |
+
+## 6. Chưa đo — không được coi là đã đạt
+
+Giống mục 9 của Phase 0, phần này để tránh tự tin quá mức:
+
+- **Độ trễ chạm-đến-thấy** p50/p95, trên LAN và qua tunnel. Chưa đo lần nào.
+- **Reconnect ≤ 5 s** theo §10 của plan: đã có backoff và có `ready` sau khi nối lại, nhưng chưa
+  bấm giờ trên mạng thật bị rớt.
+- **Soak 60 phút**: dài nhất đã chạy là 45 s cho stream nguồn.
+- **Ảnh hưởng tới chat/terminal** khi chạy song song.
+- **Windows / macOS**: chưa chạy dòng nào. `h264_qsv`/`h264_vaapi` là đường Linux; `h264_amf` chưa
+  từng được chọn ở đây.
+- **Trình duyệt di động thật**: `VideoDecoder` trên Chromium di động đã từng chết sau ~1 GOP ở
+  Remote Desktop; hook decoder tự hồi phục, nhưng chưa thử với luồng này.
+- **Nhiều AVD cùng lúc**: `max_concurrent` mặc định là 1 và chưa nâng lên để thử.
+
+## 7. Tái lập
+
+```bash
+# 1. AVD thử nghiệm riêng, không đụng Pixel_9 / Pixel_Tablet của người dùng
+bash spikes/android/boot-test-avd.sh &
+
+# 2. E2E mức dịch vụ
+ANDROID_EMULATOR_ENABLED=1 PPM_HOME=$(mktemp -d) bun tests/e2e/android-e2e.ts
+
+# 3. E2E qua server thật
+ANDROID_EMULATOR_ENABLED=1 bun src/server/index.ts __serve__ 8099 127.0.0.1 dev &
+PPM_BASE=http://127.0.0.1:8099 PPM_TOKEN=<token của ppm.dev.db> \
+  PPM_HOME=$(mktemp -d) bun tests/e2e/android-ws-e2e.ts
+```