@jskit-ai/agent-docs 0.1.118 → 0.1.120

package/skills/jskit/references/ui-operations.md

@@ -19,11 +19,10 @@ Choose the truthful `--navigation-role`. Override with semantic
 diagnosis. Let the generator create the route and placement before adapting
 app-owned output. State why before hand-writing a normal page.
 
-## Managed app-owned files
+## App-owned files
 
-“App-owned” means customizable, not disposable while its package is installed.
-Never delete or rename a path recorded in `.jskit/lock.json`; adapt managed
-infrastructure tests in place. When replacing a starter route, update its smoke
+App-owned generated files are customizable. Adapt infrastructure tests in place.
+When replacing a starter route, update its smoke
 test to the new canonical route instead of deleting baseline browser coverage.
 Doctor must continue to report a missing managed test.
 
@@ -41,17 +40,18 @@ Doctor must continue to report a missing managed test.
 
 ## Adaptive shell drawer
 
-Use Vuetify Material navigation. Compact close dismisses the temporary drawer.
-Wider layouts default to `desktopDrawerClosedMode="rail"`, retaining primary
-navigation as a rail. Use `desktopDrawerClosedMode="hidden"` only when another
-discoverable navigation affordance exists. Do not create a second drawer/menu
-registry or imitate the rail with CSS.
+Use Vuetify Material navigation. Compact close dismisses the temporary drawer;
+wide layouts default to `desktopDrawerClosedMode="rail"`. Use `hidden` only
+with another navigation affordance.
 
-The drawer uses `navigationItemSpacing` (12px) for icon/label and widest-label/
-edge gaps. Its 80px rail centres complete 48px targets and theme-owned
-tooltips. Set `railWidth` (for example, `64`) for another density, or
-`drawerWidth` for a fixed open width. The app wrapper forwards all three; never
-override `.v-navigation-drawer` in an app.
+The drawer omits the app bar's surface label. Open and rail icons share a
+centreline. It uses a 12px outer item inset; `navigationItemSpacing` (12px)
+controls icon/label and label/end gaps. The 80px rail centres 48px targets; set
+`railWidth` (for example, `64`) for a denser rail or `drawerWidth` for a fixed
+drawer. The wrapper forwards these props; never override its CSS.
+
+Existing apps: commit work and run `npm run jskit:update`. Keep and adapt
+the app-owned shell wrapper and smoke test; do not copy or delete them.
 
 ## Browser verification
 
@@ -64,11 +64,8 @@ install a browser when a managed runner supplies one.
 
 For explicitly enabled direct-local auth, use `loginAsExistingUser()` from
 `@jskit-ai/auth-web/test/playwright`; never expose its secret to browser code,
-URLs, or client env. Record a successful supported run with:
+URLs, or client env. Run the focused test directly:
 
 ```bash
-npx --no-install jskit app verify-ui \
-  --command "<exact successful Playwright command>" \
-  --feature "<changed behavior>" \
-  --auth-mode <dev-auth-login-as|session-bootstrap>
+npx playwright test <test-file> -g "<changed behavior>"
 ```