@jskit-ai/agent-docs 0.1.266 → 0.1.268

package/guide/agent/app-extras/assistant-conversation.md

@@ -3431,7 +3431,24 @@ at shutdown each native owner stops the processes this server runs, since none
 outlives the server that started it, and saved conversations are not reopened to
 be stopped. Claude stops its sessions together, leaves an idle chat untouched
 (nothing to stop, nothing written) and reports a session that cannot stop by ID
-in `failed` while the others still stop. It stops them even when its
+in `failed` while the others still stop. A turn still running when its process
+stops is not ended at shutdown: its saved record keeps the execution and the
+active turn, as after a crash, so the next server's recovery proves that exit,
+interrupts the turn and runs the host's interrupted checkpoint. OpenCode
+likewise interrupts a running turn's native work and proves its shared process
+exits, and marks that turn as stopped by shutdown. A main conversation's saved
+run stays active with the mark (`stoppedByShutdown`), and the next server
+records the turn interrupted, with the host's checkpoint, when the chat is next
+prepared or a goal's recovery reconciles it. A temporary conversation's turn
+ends interrupted, and `afterClose` receives `stoppedByShutdown: true` so the
+host leaves its checkpoint to the next server: when the host's later read
+passes the stopped run as `stoppedByShutdown: { runId, ended }`, that read
+reports the run interrupted, not failed, and calls `ended` so the host makes
+the checkpoint. A native abort without the mark (a timeout, or a crash's
+leftover) still reads as that turn's failure. Either way a slow host
+checkpoint, such as a Git snapshot, never holds up shutdown, and a Stop or
+session close outside shutdown still ends its turn through that checkpoint.
+Claude stops its sessions even when its
 account-query cleanup fails; that failure is still the call's result. Once
 shutdown has invalidated the owner, a later session close only releases retained
 work. Failed cleanup can be retried after runtime closure. This is not a browser

package/guide/agent/app-setup/authentication.md

@@ -236,5 +236,13 @@ A managed host instead supplies authenticated state through
 file as a temporary secret, use relative URLs, and do not call the localhost
 login helper or start a duplicate server.
 
+The login state belongs to the host, which already fits it to the tested site.
+Pass `process.env.PLAYWRIGHT_STORAGE_STATE` unchanged to `use.storageState`:
+the config never reads, parses or edits that file or its `cookies` or
+`origins`. `jskit/playwright-login-unchanged` reports a config that does, and
+the host refuses to run its tests. If tests run signed out with the unchanged
+state, that is a host defect: report it with the evidence; do not work around
+it.
+
 Never commit provider secrets, copy auth repositories into the app, or add an
 installation questionnaire, mutation record, or setup receipt.

package/guide/agent/framework/ui-operations.md

@@ -26,7 +26,7 @@ template or relative string raw to Vue Router `to`.
 ## Back navigation
 
 Check every page for a visible Back button that returns to the previous page.
-Omit it only when returning makes no product sense, such as the app's root
+Omit it only when returning makes no product sense, such as the root
 landing page or a completed flow that must not reopen an expired step. State
 the reason in the implementation or review result; a drawer link is not Back.
 
@@ -70,7 +70,6 @@ hash, pattern receipt, or tool-owned source declaration.
 - Keep screens phone/task-first with drawer-independent primary actions.
 - Use direct surfaces instead of needless nested cards.
 - Render all meaningful loading, empty, error, permission, and retry states.
-- Follow the Material 3 contract for targets, loading and failure feedback.
 - Extend shared CRUD screens through public slots and composables.
 - Keep row actions and filters near the screen unless the framework owns them.
 - Import neutral request and CRUD UI APIs from `@jskit-ai/http-web`. Install
@@ -87,25 +86,25 @@ when another navigation affordance remains.
 The drawer omits the app bar's surface label. Open and rail icons share a
 centreline. It uses a 12px outer item inset; `navigationItemSpacing` controls
 icon/label and label/end gaps. The normal 80px rail centres 48px targets;
-`railWidth` and `drawerWidth` are public density/width controls. Do not override
-the shell's private implementation CSS.
-
-Restyle shell chrome only through the `--shell-*` tokens in the
-`shell/application-shell` pattern.
+`railWidth` and `drawerWidth` are public density/width controls. Restyle shell
+chrome only through the `--shell-*` tokens in the `shell/application-shell`
+pattern, never its private CSS.
 
 ## Browser verification
 
 Exercise user-facing changes with Playwright at compact, medium, and expanded
 widths. Check overflow, clipped text, duplicate navigation, route placement,
 actions, skeleton replacement, error feedback, and target sizes. Use relative
-URLs. When `PLAYWRIGHT_BASE_URL` is provided, start no duplicate server.
-For Back, enter the same page from two different origins and verify each
-returns to its own origin with context intact. Also check direct entry, reload,
-browser back/forward, fixed-destination exceptions, and any unsaved-change guard.
+URLs. With `PLAYWRIGHT_BASE_URL` set, start no duplicate server. For Back,
+enter the same page from two origins and verify each returns to its own origin
+with context intact. Also check direct entry, reload, browser back/forward,
+fixed-destination exceptions, and any unsaved-change guard.
 
 A managed host owns its browser and may provide
 `PLAYWRIGHT_STORAGE_STATE`; never print or commit that value, bypass it,
-or install another browser. For explicitly enabled direct-local auth, use
+or install another browser. If tests run signed out despite that state, report
+the host defect with evidence and stop; never rewrite its cookies or add a login.
+For explicitly enabled direct-local auth, use
 `loginAsExistingUser()` from `@jskit-ai/auth-web/test/playwright`; never expose
 the exchange secret to browser code, URLs, or client environment.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.266",
+  "version": "0.1.268",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

package/patterns/minimal-foundation/example/package.json

@@ -48,8 +48,8 @@
     "@vue/devtools-api": "^8.2.1"
   },
   "devDependencies": {
-    "@jskit-ai/config-eslint": "0.1.244",
-    "@jskit-ai/jskit-catalog": "0.2.18",
+    "@jskit-ai/config-eslint": "0.1.245",
+    "@jskit-ai/jskit-catalog": "0.2.20",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/patterns/shell-foundation/example/package.json

@@ -50,8 +50,8 @@
     "@vue/devtools-api": "^8.2.1"
   },
   "devDependencies": {
-    "@jskit-ai/config-eslint": "0.1.244",
-    "@jskit-ai/jskit-catalog": "0.2.18",
+    "@jskit-ai/config-eslint": "0.1.245",
+    "@jskit-ai/jskit-catalog": "0.2.20",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/reference/autogen/PATTERN_INDEX.md

@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
 
 - Id: `app/minimal-foundation`
 - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.266`
+- Owner: `@jskit-ai/agent-docs@0.1.268`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
 
 - Id: `app/shell-foundation`
 - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.266`
+- Owner: `@jskit-ai/agent-docs@0.1.268`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
 
 - Id: `assistant/assistant-surface`
 - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/assistant-runtime@0.2.16`
+- Owner: `@jskit-ai/assistant-runtime@0.2.18`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
 - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Define a server feature through explicit capabilities and first-class actions, a
 
 - Id: `server/feature-package`
 - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
-- Owner: `@jskit-ai/agent-docs@0.1.266`
+- Owner: `@jskit-ai/agent-docs@0.1.268`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`

package/reference/autogen/tooling/config-eslint.md

@@ -280,6 +280,14 @@ Local functions
 - `checkedPlace(object)`
 - `splitObjectLines(sourceCode, object)`
 
+### `plugin/rules/playwrightLoginUnchanged.js`
+Exports
+- `playwrightLoginUnchanged`
+Local functions
+- `memberName(node)`
+- `isCallOf(node, name)`
+- `shortText(sourceCode, node)`
+
 ### `plugin/rules/releasedListeners.js`
 Exports
 - `releasedListeners`

package/reference/autogen/tooling/jskit-release.md

@@ -54,12 +54,12 @@ Local functions
 
 ### `src/release.mjs`
 Exports
-- `assertMainReleaseCheckout(repoRoot, { allowAhead = false } = {})`
+- `assertReleaseCheckout(repoRoot, { allowAhead = false, branch = "main" } = {})`
 - `bumpPatch`
 - `collectPublishDependencies`
 - `collectPatternPackageJsonPaths`
 - `collectVersionMismatches`
-- `commitAndPush(repoRoot, message)`
+- `commitAndPush(repoRoot, message, branch = "main")`
 - `discoverManifests`
 - `discoverReleasePackages`
 - `main(argv = process.argv.slice(2))`
@@ -79,12 +79,13 @@ Local functions
 - `prepareRelease({ cwd: repoRoot, dryRun, registry, report = false })`
 - `createNpmUserConfig(registry, directory, records = [])`
 - `git(repoRoot, args)`
+- `commitAll(repoRoot, message)`
 - `releaseCommitMessage(entries)`
 - `publishRelease(records, { cwd: repoRoot, registry })`
 - `publishCommand(options)`
 - `forgetPinnedLockEntries(repoRoot, names)`
 - `installReleasedPins(repoRoot, { attempts = 20, delayMs = Number(process.env.JSKIT_RELEASE_RETRY_DELAY_MS || 30_000) } = {})`
-- `pinCommand({ cwd: repoRoot, from, dryRun, noCommit })`
+- `pinCommand({ cwd: repoRoot, from, dryRun, noCommit, noPush, branch })`
 
 ### bin
 

package/skills/jskit/references/pattern-index.md

@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
 
 - Id: `app/minimal-foundation`
 - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.266`
+- Owner: `@jskit-ai/agent-docs@0.1.268`
 - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
 - Examples: [example/](patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
 
 - Id: `app/shell-foundation`
 - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.266`
+- Owner: `@jskit-ai/agent-docs@0.1.268`
 - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
 - Examples: [example/](patterns/app/shell-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
 
 - Id: `assistant/assistant-surface`
 - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/assistant-runtime@0.2.16`
+- Owner: `@jskit-ai/assistant-runtime@0.2.18`
 - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
 - Examples: [example/](patterns/assistant/assistant-surface/example/)
 - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Define a server feature through explicit capabilities and first-class actions, a
 
 - Id: `server/feature-package`
 - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
-- Owner: `@jskit-ai/agent-docs@0.1.266`
+- Owner: `@jskit-ai/agent-docs@0.1.268`
 - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
 - Examples: [example/](patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`

package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json

@@ -48,8 +48,8 @@
     "@vue/devtools-api": "^8.2.1"
   },
   "devDependencies": {
-    "@jskit-ai/config-eslint": "0.1.244",
-    "@jskit-ai/jskit-catalog": "0.2.18",
+    "@jskit-ai/config-eslint": "0.1.245",
+    "@jskit-ai/jskit-catalog": "0.2.20",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/skills/jskit/references/patterns/app/shell-foundation/example/package.json

@@ -50,8 +50,8 @@
     "@vue/devtools-api": "^8.2.1"
   },
   "devDependencies": {
-    "@jskit-ai/config-eslint": "0.1.244",
-    "@jskit-ai/jskit-catalog": "0.2.18",
+    "@jskit-ai/config-eslint": "0.1.245",
+    "@jskit-ai/jskit-catalog": "0.2.20",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

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

@@ -21,7 +21,7 @@ template or relative string raw to Vue Router `to`.
 ## Back navigation
 
 Check every page for a visible Back button that returns to the previous page.
-Omit it only when returning makes no product sense, such as the app's root
+Omit it only when returning makes no product sense, such as the root
 landing page or a completed flow that must not reopen an expired step. State
 the reason in the implementation or review result; a drawer link is not Back.
 
@@ -65,7 +65,6 @@ hash, pattern receipt, or tool-owned source declaration.
 - Keep screens phone/task-first with drawer-independent primary actions.
 - Use direct surfaces instead of needless nested cards.
 - Render all meaningful loading, empty, error, permission, and retry states.
-- Follow the Material 3 contract for targets, loading and failure feedback.
 - Extend shared CRUD screens through public slots and composables.
 - Keep row actions and filters near the screen unless the framework owns them.
 - Import neutral request and CRUD UI APIs from `@jskit-ai/http-web`. Install
@@ -82,25 +81,25 @@ when another navigation affordance remains.
 The drawer omits the app bar's surface label. Open and rail icons share a
 centreline. It uses a 12px outer item inset; `navigationItemSpacing` controls
 icon/label and label/end gaps. The normal 80px rail centres 48px targets;
-`railWidth` and `drawerWidth` are public density/width controls. Do not override
-the shell's private implementation CSS.
-
-Restyle shell chrome only through the `--shell-*` tokens in the
-`shell/application-shell` pattern.
+`railWidth` and `drawerWidth` are public density/width controls. Restyle shell
+chrome only through the `--shell-*` tokens in the `shell/application-shell`
+pattern, never its private CSS.
 
 ## Browser verification
 
 Exercise user-facing changes with Playwright at compact, medium, and expanded
 widths. Check overflow, clipped text, duplicate navigation, route placement,
 actions, skeleton replacement, error feedback, and target sizes. Use relative
-URLs. When `PLAYWRIGHT_BASE_URL` is provided, start no duplicate server.
-For Back, enter the same page from two different origins and verify each
-returns to its own origin with context intact. Also check direct entry, reload,
-browser back/forward, fixed-destination exceptions, and any unsaved-change guard.
+URLs. With `PLAYWRIGHT_BASE_URL` set, start no duplicate server. For Back,
+enter the same page from two origins and verify each returns to its own origin
+with context intact. Also check direct entry, reload, browser back/forward,
+fixed-destination exceptions, and any unsaved-change guard.
 
 A managed host owns its browser and may provide
 `PLAYWRIGHT_STORAGE_STATE`; never print or commit that value, bypass it,
-or install another browser. For explicitly enabled direct-local auth, use
+or install another browser. If tests run signed out despite that state, report
+the host defect with evidence and stop; never rewrite its cookies or add a login.
+For explicitly enabled direct-local auth, use
 `loginAsExistingUser()` from `@jskit-ai/auth-web/test/playwright`; never expose
 the exchange secret to browser code, URLs, or client environment.