@jskit-ai/agent-docs 0.1.258 → 0.1.260

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/package.json +1 -1
  2. package/patterns/minimal-foundation/example/package.json +1 -1
  3. package/patterns/minimal-foundation/example/playwright.config.mjs +3 -2
  4. package/patterns/shell-foundation/example/package.json +1 -1
  5. package/patterns/shell-foundation/example/playwright.config.mjs +3 -2
  6. package/reference/autogen/PATTERN_INDEX.md +8 -8
  7. package/skills/jskit/SKILL.md +6 -6
  8. package/skills/jskit/references/heuristics/ui-testing.md +1 -0
  9. package/skills/jskit/references/pattern-index.md +8 -8
  10. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +1 -1
  11. package/skills/jskit/references/patterns/app/minimal-foundation/example/playwright.config.mjs +3 -2
  12. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +1 -1
  13. package/skills/jskit/references/patterns/app/shell-foundation/example/playwright.config.mjs +3 -2
  14. package/skills/jskit/references/patterns/auth/oidc-sign-in/example/package.json +2 -2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.258",
3
+ "version": "0.1.260",
4
4
  "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
5
5
  "type": "module",
6
6
  "files": [
package/patterns/minimal-foundation/example/package.json CHANGED
@@ -49,7 +49,7 @@
49
49
  },
50
50
  "devDependencies": {
51
51
  "@jskit-ai/config-eslint": "0.1.242",
52
- "@jskit-ai/jskit-catalog": "0.2.10",
52
+ "@jskit-ai/jskit-catalog": "0.2.12",
53
53
  "@playwright/test": "1.61.1",
54
54
  "@vitejs/plugin-vue": "^6.0.7",
55
55
  "eslint": "^10.8.0",
package/patterns/minimal-foundation/example/playwright.config.mjs CHANGED
@@ -3,7 +3,8 @@ import { defineConfig } from "@playwright/test";
3
3
  const managedBaseUrl = String(process.env.PLAYWRIGHT_BASE_URL || "")
4
4
  .trim()
5
5
  .replace(/\/+$/u, "");
6
- const baseURL = managedBaseUrl || "http://127.0.0.1:4173";
6
+ const port = String(process.env.PLAYWRIGHT_PORT || "").trim() || "4173";
7
+ const baseURL = managedBaseUrl || `http://127.0.0.1:${port}`;
7
8
  const storageState = String(process.env.PLAYWRIGHT_STORAGE_STATE || "").trim();
8
9
 
9
10
  export default defineConfig({
@@ -21,7 +22,7 @@ export default defineConfig({
21
22
  webServer: {
22
23
  command: "npm run develop",
23
24
  env: {
24
- PORT: "4173"
25
+ PORT: port
25
26
  },
26
27
  url: `${baseURL}/api/health`,
27
28
  reuseExistingServer: true,
package/patterns/shell-foundation/example/package.json CHANGED
@@ -51,7 +51,7 @@
51
51
  },
52
52
  "devDependencies": {
53
53
  "@jskit-ai/config-eslint": "0.1.242",
54
- "@jskit-ai/jskit-catalog": "0.2.10",
54
+ "@jskit-ai/jskit-catalog": "0.2.12",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",
package/patterns/shell-foundation/example/playwright.config.mjs CHANGED
@@ -3,7 +3,8 @@ import { defineConfig } from "@playwright/test";
3
3
  const managedBaseUrl = String(process.env.PLAYWRIGHT_BASE_URL || "")
4
4
  .trim()
5
5
  .replace(/\/+$/u, "");
6
- const baseURL = managedBaseUrl || "http://127.0.0.1:4173";
6
+ const port = String(process.env.PLAYWRIGHT_PORT || "").trim() || "4173";
7
+ const baseURL = managedBaseUrl || `http://127.0.0.1:${port}`;
7
8
  const storageState = String(process.env.PLAYWRIGHT_STORAGE_STATE || "").trim();
8
9
 
9
10
  export default defineConfig({
@@ -21,7 +22,7 @@ export default defineConfig({
21
22
  webServer: {
22
23
  command: "npm run develop",
23
24
  env: {
24
- PORT: "4173"
25
+ PORT: port
25
26
  },
26
27
  url: `${baseURL}/api/health`,
27
28
  reuseExistingServer: true,
package/reference/autogen/PATTERN_INDEX.md CHANGED
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.258`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.260`
19
19
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.258`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.260`
30
30
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
59
59
 
60
60
  - Id: `auth/auth-surface`
61
61
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
62
- - Owner: `@jskit-ai/auth-web@0.2.5`
62
+ - Owner: `@jskit-ai/auth-web@0.2.6`
63
63
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
64
64
  - Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
65
65
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -70,7 +70,7 @@ Let people sign in with the accounts they already have in an accounts hub or ano
70
70
 
71
71
  - Id: `auth/oidc-sign-in`
72
72
  - Keywords: `accounts hub`, `auth`, `authentication`, `back-channel logout`, `dynamic client registration`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
73
- - Owner: `@jskit-ai/auth-provider-oidc-core@0.2.7`
73
+ - Owner: `@jskit-ai/auth-provider-oidc-core@0.2.8`
74
74
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/oidc-sign-in/PATTERN.md)
75
75
  - Examples: [example/](../../skills/jskit/references/patterns/auth/oidc-sign-in/example/)
76
76
  - Requires: `@jskit-ai/auth-provider-oidc-core`, `@jskit-ai/auth-web`
@@ -246,7 +246,7 @@ Add a protected administration surface, settings shell, and semantic navigation
246
246
 
247
247
  - Id: `console/console-surface`
248
248
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
249
- - Owner: `@jskit-ai/console-web@0.1.226`
249
+ - Owner: `@jskit-ai/console-web@0.1.227`
250
250
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
251
251
  - Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
252
252
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Define a server feature through explicit capabilities and first-class actions, a
345
345
 
346
346
  - Id: `server/feature-package`
347
347
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
348
- - Owner: `@jskit-ai/agent-docs@0.1.258`
348
+ - Owner: `@jskit-ai/agent-docs@0.1.260`
349
349
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
350
350
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
351
351
  - Requires: `@jskit-ai/kernel`
@@ -378,7 +378,7 @@ Compose an account settings route and profile, preference, notification, and sig
378
378
 
379
379
  - Id: `users/account-settings`
380
380
  - Keywords: `account`, `link provider`, `notifications`, `oauth`, `preferences`, `profile`, `settings`, `sign-in methods`, `user`, `vue`
381
- - Owner: `@jskit-ai/users-web@0.2.8`
381
+ - Owner: `@jskit-ai/users-web@0.2.9`
382
382
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
383
383
  - Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
384
384
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -411,7 +411,7 @@ Compose workspace selection, invitation, member administration, settings, and re
411
411
 
412
412
  - Id: `workspaces/workspace-surfaces`
413
413
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
414
- - Owner: `@jskit-ai/workspaces-web@0.2.8`
414
+ - Owner: `@jskit-ai/workspaces-web@0.2.9`
415
415
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
416
416
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
417
417
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
package/skills/jskit/SKILL.md CHANGED
@@ -91,8 +91,8 @@ schema work—never valuable data. For UI, respect surface/placements, compact
91
91
  layout, all operational states, permissions/ownership, and browser
92
92
  verification.
93
93
  Check every page for meaningful Back navigation: previous page by default,
94
- with justified omissions or explicitly named fixed destinations. Follow UI
95
- operations for the existing navigation seams, placement, and direct-entry fallback.
94
+ with justified omissions or explicitly named fixed destinations. UI operations
95
+ has navigation seams, placement and direct-entry fallback.
96
96
 
97
97
  ## Caller-owned verification
98
98
 
@@ -105,10 +105,10 @@ unless requested in the current task.
105
105
 
106
106
  For review-only work, report without editing. Check dead or duplicated code,
107
107
  accidental abstraction, incomplete states, missed high-level JSKIT seams,
108
- invalid ownership or migration choices, UI quality, and verification. Run the
109
- Material 3 audit for affected UI, including Back's presence, positioning, label,
110
- and actual destination. Do not treat a hardcoded parent link as previous-page
111
- navigation. Put findings first by severity and file.
108
+ invalid ownership or migration choices, UI quality, and verification. Server
109
+ code follows typed features, client code client features; `npm run lint` is
110
+ clean. Run the Material 3 audit for affected UI, Back included; a hardcoded
111
+ parent link is not previous-page navigation. Findings first by severity and file.
112
112
 
113
113
  ## Verify
114
114
 
package/skills/jskit/references/heuristics/ui-testing.md CHANGED
@@ -26,6 +26,7 @@ Rules:
26
26
  reach the form before reload, then assert the original list URL; direct entry
27
27
  checks the configured fallback separately. Do not replace this wait with sleeps.
28
28
  - A managed runner supplies `PLAYWRIGHT_BASE_URL`. When it is set, JSKIT does not start another app server.
29
+ - Otherwise the config starts the app on `PLAYWRIGHT_PORT`, 4173 by default. A runner that shares a machine between runs sets a free port for each run; with one fixed port, a second run would wait for it or reuse another run's server.
29
30
  - A managed runner may supply an authenticated context through `PLAYWRIGHT_STORAGE_STATE`. Treat that file as a temporary secret: do not commit it, print it, or retain it after the run.
30
31
  - Do not install a browser when the environment provides a managed browser runner.
31
32
  - Shared CRUD lists retain both card and table markup and hide the inactive
package/skills/jskit/references/pattern-index.md CHANGED
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.258`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.260`
19
19
  - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.258`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.260`
30
30
  - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
59
59
 
60
60
  - Id: `auth/auth-surface`
61
61
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
62
- - Owner: `@jskit-ai/auth-web@0.2.5`
62
+ - Owner: `@jskit-ai/auth-web@0.2.6`
63
63
  - Read: [PATTERN.md](patterns/auth/auth-surface/PATTERN.md)
64
64
  - Examples: [example/](patterns/auth/auth-surface/example/)
65
65
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -70,7 +70,7 @@ Let people sign in with the accounts they already have in an accounts hub or ano
70
70
 
71
71
  - Id: `auth/oidc-sign-in`
72
72
  - Keywords: `accounts hub`, `auth`, `authentication`, `back-channel logout`, `dynamic client registration`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
73
- - Owner: `@jskit-ai/auth-provider-oidc-core@0.2.7`
73
+ - Owner: `@jskit-ai/auth-provider-oidc-core@0.2.8`
74
74
  - Read: [PATTERN.md](patterns/auth/oidc-sign-in/PATTERN.md)
75
75
  - Examples: [example/](patterns/auth/oidc-sign-in/example/)
76
76
  - Requires: `@jskit-ai/auth-provider-oidc-core`, `@jskit-ai/auth-web`
@@ -246,7 +246,7 @@ Add a protected administration surface, settings shell, and semantic navigation
246
246
 
247
247
  - Id: `console/console-surface`
248
248
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
249
- - Owner: `@jskit-ai/console-web@0.1.226`
249
+ - Owner: `@jskit-ai/console-web@0.1.227`
250
250
  - Read: [PATTERN.md](patterns/console/console-surface/PATTERN.md)
251
251
  - Examples: [example/](patterns/console/console-surface/example/)
252
252
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Define a server feature through explicit capabilities and first-class actions, a
345
345
 
346
346
  - Id: `server/feature-package`
347
347
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
348
- - Owner: `@jskit-ai/agent-docs@0.1.258`
348
+ - Owner: `@jskit-ai/agent-docs@0.1.260`
349
349
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
350
350
  - Examples: [example/](patterns/server/feature-package/example/)
351
351
  - Requires: `@jskit-ai/kernel`
@@ -378,7 +378,7 @@ Compose an account settings route and profile, preference, notification, and sig
378
378
 
379
379
  - Id: `users/account-settings`
380
380
  - Keywords: `account`, `link provider`, `notifications`, `oauth`, `preferences`, `profile`, `settings`, `sign-in methods`, `user`, `vue`
381
- - Owner: `@jskit-ai/users-web@0.2.8`
381
+ - Owner: `@jskit-ai/users-web@0.2.9`
382
382
  - Read: [PATTERN.md](patterns/users/account-settings/PATTERN.md)
383
383
  - Examples: [example/](patterns/users/account-settings/example/)
384
384
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -411,7 +411,7 @@ Compose workspace selection, invitation, member administration, settings, and re
411
411
 
412
412
  - Id: `workspaces/workspace-surfaces`
413
413
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
414
- - Owner: `@jskit-ai/workspaces-web@0.2.8`
414
+ - Owner: `@jskit-ai/workspaces-web@0.2.9`
415
415
  - Read: [PATTERN.md](patterns/workspaces/workspace-surfaces/PATTERN.md)
416
416
  - Examples: [example/](patterns/workspaces/workspace-surfaces/example/)
417
417
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json CHANGED
@@ -49,7 +49,7 @@
49
49
  },
50
50
  "devDependencies": {
51
51
  "@jskit-ai/config-eslint": "0.1.242",
52
- "@jskit-ai/jskit-catalog": "0.2.10",
52
+ "@jskit-ai/jskit-catalog": "0.2.12",
53
53
  "@playwright/test": "1.61.1",
54
54
  "@vitejs/plugin-vue": "^6.0.7",
55
55
  "eslint": "^10.8.0",
package/skills/jskit/references/patterns/app/minimal-foundation/example/playwright.config.mjs CHANGED
@@ -3,7 +3,8 @@ import { defineConfig } from "@playwright/test";
3
3
  const managedBaseUrl = String(process.env.PLAYWRIGHT_BASE_URL || "")
4
4
  .trim()
5
5
  .replace(/\/+$/u, "");
6
- const baseURL = managedBaseUrl || "http://127.0.0.1:4173";
6
+ const port = String(process.env.PLAYWRIGHT_PORT || "").trim() || "4173";
7
+ const baseURL = managedBaseUrl || `http://127.0.0.1:${port}`;
7
8
  const storageState = String(process.env.PLAYWRIGHT_STORAGE_STATE || "").trim();
8
9
 
9
10
  export default defineConfig({
@@ -21,7 +22,7 @@ export default defineConfig({
21
22
  webServer: {
22
23
  command: "npm run develop",
23
24
  env: {
24
- PORT: "4173"
25
+ PORT: port
25
26
  },
26
27
  url: `${baseURL}/api/health`,
27
28
  reuseExistingServer: true,
package/skills/jskit/references/patterns/app/shell-foundation/example/package.json CHANGED
@@ -51,7 +51,7 @@
51
51
  },
52
52
  "devDependencies": {
53
53
  "@jskit-ai/config-eslint": "0.1.242",
54
- "@jskit-ai/jskit-catalog": "0.2.10",
54
+ "@jskit-ai/jskit-catalog": "0.2.12",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",
package/skills/jskit/references/patterns/app/shell-foundation/example/playwright.config.mjs CHANGED
@@ -3,7 +3,8 @@ import { defineConfig } from "@playwright/test";
3
3
  const managedBaseUrl = String(process.env.PLAYWRIGHT_BASE_URL || "")
4
4
  .trim()
5
5
  .replace(/\/+$/u, "");
6
- const baseURL = managedBaseUrl || "http://127.0.0.1:4173";
6
+ const port = String(process.env.PLAYWRIGHT_PORT || "").trim() || "4173";
7
+ const baseURL = managedBaseUrl || `http://127.0.0.1:${port}`;
7
8
  const storageState = String(process.env.PLAYWRIGHT_STORAGE_STATE || "").trim();
8
9
 
9
10
  export default defineConfig({
@@ -21,7 +22,7 @@ export default defineConfig({
21
22
  webServer: {
22
23
  command: "npm run develop",
23
24
  env: {
24
- PORT: "4173"
25
+ PORT: port
25
26
  },
26
27
  url: `${baseURL}/api/health`,
27
28
  reuseExistingServer: true,
package/skills/jskit/references/patterns/auth/oidc-sign-in/example/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "private": true,
3
3
  "type": "module",
4
4
  "dependencies": {
5
- "@jskit-ai/auth-provider-oidc-core": "0.2.7",
6
- "@jskit-ai/auth-web": "0.2.5"
5
+ "@jskit-ai/auth-provider-oidc-core": "0.2.8",
6
+ "@jskit-ai/auth-web": "0.2.6"
7
7
  }
8
8
  }