@jskit-ai/agent-docs 0.1.241 → 0.1.243
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.
- package/guide/agent/app-extras/assistant-conversation.md +4 -2
- package/guide/agent/app-extras/assistant.md +3 -1
- package/guide/agent/app-extras/realtime.md +12 -3
- package/guide/agent/app-setup/database-layer.md +1 -1
- package/guide/agent/app-setup/existing-application-migration.md +0 -7
- package/guide/agent/framework/application-operations.md +1 -1
- package/guide/agent/framework/crud-operations.md +9 -9
- package/guide/agent/framework/ui-operations.md +6 -30
- package/guide/agent/index.md +2 -0
- package/package.json +2 -3
- package/patterns/feature-package/example/booking-engine/package.json +1 -1
- package/patterns/feature-package/example/booking-engine/src/server/actions.js +0 -2
- package/patterns/feature-package/example/variations/AvailabilityEngineProvider.js +1 -1
- package/patterns/feature-package/example/variations/InvoiceRollupProvider.js +1 -1
- package/patterns/minimal-foundation/example/AGENTS.md +19 -0
- package/patterns/minimal-foundation/example/package.json +3 -3
- package/patterns/minimal-foundation/example/server/lib/runtimeEnv.js +3 -11
- package/patterns/minimal-foundation/example/src/main.js +0 -2
- package/patterns/shell-foundation/PATTERN.md +11 -20
- package/patterns/shell-foundation/example/AGENTS.md +19 -0
- package/patterns/shell-foundation/example/package.json +4 -4
- package/patterns/shell-foundation/example/packages/main/package.json +1 -1
- package/patterns/shell-foundation/example/server/lib/runtimeEnv.js +3 -11
- package/patterns/shell-foundation/example/src/components/ShellLayout.vue +1 -0
- package/patterns/shell-foundation/example/src/main.js +0 -2
- package/patterns/shell-foundation/example/src/pages/home/settings.vue +2 -2
- package/reference/autogen/KERNEL_MAP.md +16 -147
- package/reference/autogen/PATTERN_INDEX.md +37 -37
- package/reference/autogen/packages/agent-docs.md +1 -9
- package/reference/autogen/packages/assistant-core.md +102 -68
- package/reference/autogen/packages/assistant-runtime.md +29 -15
- package/reference/autogen/packages/assistant-voice-sherpa.md +2 -1
- package/reference/autogen/packages/assistant-voice.md +8 -11
- package/reference/autogen/packages/auth-core.md +1 -1
- package/reference/autogen/packages/auth-provider-local-core.md +1 -1
- package/reference/autogen/packages/auth-provider-local-db-core.md +1 -1
- package/reference/autogen/packages/auth-provider-oidc-core.md +1 -1
- package/reference/autogen/packages/auth-provider-supabase-core.md +1 -1
- package/reference/autogen/packages/auth-web.md +1 -2
- package/reference/autogen/packages/connector-google-calendar.md +6 -2
- package/reference/autogen/packages/connectors-catalog.md +26 -7
- package/reference/autogen/packages/connectors-core.md +14 -3
- package/reference/autogen/packages/connectors-web.md +6 -1
- package/reference/autogen/packages/console-core.md +1 -1
- package/reference/autogen/packages/console-web.md +1 -1
- package/reference/autogen/packages/crud-core.md +1 -1
- package/reference/autogen/packages/database-runtime-mysql.md +1 -1
- package/reference/autogen/packages/database-runtime-postgres.md +1 -1
- package/reference/autogen/packages/database-runtime.md +2 -86
- package/reference/autogen/packages/http-runtime.md +6 -92
- package/reference/autogen/packages/http-web.md +29 -49
- package/reference/autogen/packages/json-rest-api-core.md +1 -1
- package/reference/autogen/packages/kernel.md +108 -405
- package/reference/autogen/packages/mobile-capacitor.md +11 -1
- package/reference/autogen/packages/oidc-issuer-core.md +1 -1
- package/reference/autogen/packages/payments-core.md +12 -4
- package/reference/autogen/packages/payments-web.md +1 -1
- package/reference/autogen/packages/realtime.md +7 -5
- package/reference/autogen/packages/resource-core.md +1 -4
- package/reference/autogen/packages/resource-crud-core.md +4 -3
- package/reference/autogen/packages/rewarded-core.md +1 -1
- package/reference/autogen/packages/rewarded-web.md +1 -1
- package/reference/autogen/packages/shell-web.md +114 -49
- package/reference/autogen/packages/storage-runtime.md +1 -1
- package/reference/autogen/packages/uploads-image-web.md +1 -1
- package/reference/autogen/packages/uploads-runtime.md +1 -1
- package/reference/autogen/packages/users-core.md +1 -1
- package/reference/autogen/packages/users-web.md +1 -2
- package/reference/autogen/packages/workspaces-core.md +3 -1
- package/reference/autogen/packages/workspaces-web.md +1 -1
- package/reference/autogen/tooling/config-eslint.md +1 -1
- package/reference/autogen/tooling/jskit-catalog.md +8 -9
- package/reference/autogen/tooling/jskit-release.md +3 -4
- package/reference/autogen/tooling/testUtils.md +1 -28
- package/skills/jskit/SKILL.md +8 -6
- package/skills/jskit/references/app-operations.md +1 -1
- package/skills/jskit/references/crud-form-actions.md +62 -0
- package/skills/jskit/references/crud-operations.md +9 -9
- package/skills/jskit/references/existing-application-migration.md +0 -7
- package/{patterns → skills/jskit/references/heuristics}/INDEX.md +24 -38
- package/{patterns → skills/jskit/references/heuristics}/child-cruds.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/client-requests.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/crud-authoring.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/crud-links.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/crud-repository-mapping.md +3 -1
- package/{patterns → skills/jskit/references/heuristics}/filters.md +3 -1
- package/{patterns → skills/jskit/references/heuristics}/live-actions.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/page-redirects.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/page-scaffolding.md +5 -3
- package/{patterns → skills/jskit/references/heuristics}/placements.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/row-policies.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/server-search.md +2 -0
- package/{patterns → skills/jskit/references/heuristics}/surfaces.md +5 -3
- package/{patterns → skills/jskit/references/heuristics}/ui-contract.md +3 -1
- package/{patterns → skills/jskit/references/heuristics}/ui-testing.md +2 -0
- package/skills/jskit/references/pattern-index.md +37 -37
- package/skills/jskit/references/patterns/app/minimal-foundation/example/AGENTS.md +19 -0
- package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +3 -3
- package/skills/jskit/references/patterns/app/minimal-foundation/example/server/lib/runtimeEnv.js +3 -11
- package/skills/jskit/references/patterns/app/minimal-foundation/example/src/main.js +0 -2
- package/skills/jskit/references/patterns/app/shell-foundation/PATTERN.md +11 -20
- package/skills/jskit/references/patterns/app/shell-foundation/example/AGENTS.md +19 -0
- package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +4 -4
- package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
- package/skills/jskit/references/patterns/app/shell-foundation/example/server/lib/runtimeEnv.js +3 -11
- package/skills/jskit/references/patterns/app/shell-foundation/example/src/components/ShellLayout.vue +1 -0
- package/skills/jskit/references/patterns/app/shell-foundation/example/src/main.js +0 -2
- package/skills/jskit/references/patterns/app/shell-foundation/example/src/pages/home/settings.vue +2 -2
- package/skills/jskit/references/patterns/auth/accounts-hub/example/package.json +2 -2
- package/skills/jskit/references/patterns/auth/oidc-sign-in/example/package.json +2 -2
- package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
- package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
- package/skills/jskit/references/patterns/connectors/oauth-connection/PATTERN.md +27 -610
- package/skills/jskit/references/patterns/connectors/paddle-catalogue/example/create-products.js +2 -1
- package/skills/jskit/references/patterns/connectors/redshift-queries/PATTERN.md +1 -1
- package/skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md +11 -1
- package/skills/jskit/references/patterns/crud/json-api-resource-package/example/packages/books/package.json +2 -2
- package/skills/jskit/references/patterns/database/mysql-application/example/package.json +1 -1
- package/skills/jskit/references/patterns/database/postgres-application/example/package.json +1 -1
- package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
- package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
- package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/src/server/actions.js +0 -2
- package/skills/jskit/references/patterns/server/feature-package/example/variations/AvailabilityEngineProvider.js +1 -1
- package/skills/jskit/references/patterns/server/feature-package/example/variations/InvoiceRollupProvider.js +1 -1
- package/skills/jskit/references/patterns/shell/application-shell/PATTERN.md +18 -4
- package/skills/jskit/references/patterns/shell/application-shell/example/src/pages/home/index.vue +15 -5
- package/skills/jskit/references/patterns/shell/application-shell/example/tests/e2e/adaptive-shell.spec.ts +1 -1
- package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +2 -2
- package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +3 -3
- package/skills/jskit/references/ui-operations.md +6 -30
- package/templates/app/AGENTS.md +0 -38
|
@@ -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.
|
|
18
|
+
- Owner: `@jskit-ai/agent-docs@0.1.243`
|
|
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.
|
|
29
|
+
- Owner: `@jskit-ai/agent-docs@0.1.243`
|
|
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`
|
|
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
|
|
|
37
37
|
|
|
38
38
|
- Id: `assistant/assistant-surface`
|
|
39
39
|
- Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
|
|
40
|
-
- Owner: `@jskit-ai/assistant-runtime@0.1.
|
|
40
|
+
- Owner: `@jskit-ai/assistant-runtime@0.1.235`
|
|
41
41
|
- Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
|
|
42
42
|
- Examples: [example/](patterns/assistant/assistant-surface/example/)
|
|
43
43
|
- Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
|
|
@@ -48,7 +48,7 @@ Run one OpenID Connect sign-in for all of an owner's apps as its own JSKIT proje
|
|
|
48
48
|
|
|
49
49
|
- Id: `auth/accounts-hub`
|
|
50
50
|
- Keywords: `accounts hub`, `auth`, `authentication`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
|
|
51
|
-
- Owner: `@jskit-ai/oidc-issuer-core@0.1.
|
|
51
|
+
- Owner: `@jskit-ai/oidc-issuer-core@0.1.2`
|
|
52
52
|
- Read: [PATTERN.md](patterns/auth/accounts-hub/PATTERN.md)
|
|
53
53
|
- Examples: [example/](patterns/auth/accounts-hub/example/)
|
|
54
54
|
- Requires: `@jskit-ai/oidc-issuer-core`
|
|
@@ -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.1.
|
|
62
|
+
- Owner: `@jskit-ai/auth-web@0.1.248`
|
|
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.1.
|
|
73
|
+
- Owner: `@jskit-ai/auth-provider-oidc-core@0.1.2`
|
|
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`
|
|
@@ -81,7 +81,7 @@ Add Supabase authentication through normal npm composition, explicit environment
|
|
|
81
81
|
|
|
82
82
|
- Id: `auth/supabase-auth`
|
|
83
83
|
- Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
|
|
84
|
-
- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.
|
|
84
|
+
- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.243`
|
|
85
85
|
- Read: [PATTERN.md](patterns/auth/supabase-auth/PATTERN.md)
|
|
86
86
|
- Examples: [example/](patterns/auth/supabase-auth/example/)
|
|
87
87
|
- Requires: `@jskit-ai/auth-provider-supabase-core`
|
|
@@ -92,7 +92,7 @@ Resolve an administrator environment key or an individual user's grant, then use
|
|
|
92
92
|
|
|
93
93
|
- Id: `connectors/ai-connections`
|
|
94
94
|
- Keywords: `ai`, `api-key`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
|
|
95
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
95
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
96
96
|
- Read: [PATTERN.md](patterns/connectors/ai-connections/PATTERN.md)
|
|
97
97
|
- Examples: [example/](patterns/connectors/ai-connections/example/)
|
|
98
98
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -103,7 +103,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
|
|
|
103
103
|
|
|
104
104
|
- Id: `connectors/api-key-connection`
|
|
105
105
|
- Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
|
|
106
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
106
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
107
107
|
- Read: [PATTERN.md](patterns/connectors/api-key-connection/PATTERN.md)
|
|
108
108
|
- Examples: [example/](patterns/connectors/api-key-connection/example/)
|
|
109
109
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -114,7 +114,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
|
|
|
114
114
|
|
|
115
115
|
- Id: `connectors/assistant-mcp`
|
|
116
116
|
- Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
|
|
117
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
117
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
118
118
|
- Read: [PATTERN.md](patterns/connectors/assistant-mcp/PATTERN.md)
|
|
119
119
|
- Examples: [example/](patterns/connectors/assistant-mcp/example/)
|
|
120
120
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -125,7 +125,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
|
|
|
125
125
|
|
|
126
126
|
- Id: `connectors/assistant-mcp-oauth`
|
|
127
127
|
- Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
|
|
128
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
128
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
129
129
|
- Read: [PATTERN.md](patterns/connectors/assistant-mcp-oauth/PATTERN.md)
|
|
130
130
|
- Examples: [example/](patterns/connectors/assistant-mcp-oauth/example/)
|
|
131
131
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -136,7 +136,7 @@ Compose signed AWS operations, file configuration and application authorization
|
|
|
136
136
|
|
|
137
137
|
- Id: `connectors/aws-storage-queries`
|
|
138
138
|
- Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
|
|
139
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
139
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
140
140
|
- Read: [PATTERN.md](patterns/connectors/aws-storage-queries/PATTERN.md)
|
|
141
141
|
- Examples: [example/](patterns/connectors/aws-storage-queries/example/)
|
|
142
142
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -147,7 +147,7 @@ Compose reusable connection libraries with portable configuration, application o
|
|
|
147
147
|
|
|
148
148
|
- Id: `connectors/calendar-cli`
|
|
149
149
|
- Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
|
|
150
|
-
- Owner: `@jskit-ai/connector-google-calendar@0.1.
|
|
150
|
+
- Owner: `@jskit-ai/connector-google-calendar@0.1.63`
|
|
151
151
|
- Read: [PATTERN.md](patterns/connectors/calendar-cli/PATTERN.md)
|
|
152
152
|
- Examples: [example/](patterns/connectors/calendar-cli/example/)
|
|
153
153
|
- Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
|
|
@@ -158,7 +158,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
|
|
|
158
158
|
|
|
159
159
|
- Id: `connectors/event-delivery`
|
|
160
160
|
- Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
|
|
161
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
161
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
162
162
|
- Read: [PATTERN.md](patterns/connectors/event-delivery/PATTERN.md)
|
|
163
163
|
- Examples: [example/](patterns/connectors/event-delivery/example/)
|
|
164
164
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -169,7 +169,7 @@ Wire service-account grants, file storage, explicit message actions and public b
|
|
|
169
169
|
|
|
170
170
|
- Id: `connectors/firebase-messaging`
|
|
171
171
|
- Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
|
|
172
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
172
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
173
173
|
- Read: [PATTERN.md](patterns/connectors/firebase-messaging/PATTERN.md)
|
|
174
174
|
- Examples: [example/](patterns/connectors/firebase-messaging/example/)
|
|
175
175
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -180,7 +180,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
|
|
|
180
180
|
|
|
181
181
|
- Id: `connectors/google-ads-search`
|
|
182
182
|
- Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
|
|
183
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
183
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
184
184
|
- Read: [PATTERN.md](patterns/connectors/google-ads-search/PATTERN.md)
|
|
185
185
|
- Examples: [example/](patterns/connectors/google-ads-search/example/)
|
|
186
186
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -191,7 +191,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
|
|
|
191
191
|
|
|
192
192
|
- Id: `connectors/oauth-connection`
|
|
193
193
|
- Keywords: `accounting`, `assistant permissions`, `books`, `cli`, `client credentials`, `connectors`, `consent`, `crm`, `databricks`, `developer token`, `fabric`, `files`, `gaql`, `google ads`, `graphql`, `integrations`, `linkedin`, `microsoft`, `oauth`, `powerpoint`, `salesforce`, `service principal`, `shopify`, `soql`, `staffing`, `tiktok`, `twitch`, `wave`, `word`, `wordpress`, `workday`, `xero`, `zoho`
|
|
194
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
194
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
195
195
|
- Read: [PATTERN.md](patterns/connectors/oauth-connection/PATTERN.md)
|
|
196
196
|
- Examples: [example/](patterns/connectors/oauth-connection/example/)
|
|
197
197
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -202,7 +202,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
|
|
|
202
202
|
|
|
203
203
|
- Id: `connectors/paddle-catalogue`
|
|
204
204
|
- Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
|
|
205
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
205
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
206
206
|
- Read: [PATTERN.md](patterns/connectors/paddle-catalogue/PATTERN.md)
|
|
207
207
|
- Examples: [example/](patterns/connectors/paddle-catalogue/example/)
|
|
208
208
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -213,7 +213,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
|
|
|
213
213
|
|
|
214
214
|
- Id: `connectors/public-image`
|
|
215
215
|
- Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
|
|
216
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
216
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
217
217
|
- Read: [PATTERN.md](patterns/connectors/public-image/PATTERN.md)
|
|
218
218
|
- Examples: [example/](patterns/connectors/public-image/example/)
|
|
219
219
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -224,7 +224,7 @@ Compose file configuration, Redshift Data API operations and application query o
|
|
|
224
224
|
|
|
225
225
|
- Id: `connectors/redshift-queries`
|
|
226
226
|
- Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
|
|
227
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
227
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
228
228
|
- Read: [PATTERN.md](patterns/connectors/redshift-queries/PATTERN.md)
|
|
229
229
|
- Examples: [example/](patterns/connectors/redshift-queries/example/)
|
|
230
230
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -235,7 +235,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
|
|
|
235
235
|
|
|
236
236
|
- Id: `connectors/source-scanning`
|
|
237
237
|
- Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
|
|
238
|
-
- Owner: `@jskit-ai/connectors-catalog@0.1.
|
|
238
|
+
- Owner: `@jskit-ai/connectors-catalog@0.1.65`
|
|
239
239
|
- Read: [PATTERN.md](patterns/connectors/source-scanning/PATTERN.md)
|
|
240
240
|
- Examples: [example/](patterns/connectors/source-scanning/example/)
|
|
241
241
|
- Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
|
|
@@ -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.
|
|
249
|
+
- Owner: `@jskit-ai/console-web@0.1.216`
|
|
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`
|
|
@@ -257,7 +257,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
|
|
|
257
257
|
|
|
258
258
|
- Id: `crud/crud-screen-set`
|
|
259
259
|
- Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
|
|
260
|
-
- Owner: `@jskit-ai/http-web@0.1.
|
|
260
|
+
- Owner: `@jskit-ai/http-web@0.1.93`
|
|
261
261
|
- Read: [PATTERN.md](patterns/crud/crud-screen-set/PATTERN.md)
|
|
262
262
|
- Examples: [example/](patterns/crud/crud-screen-set/example/)
|
|
263
263
|
- Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
|
|
@@ -268,7 +268,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
|
|
|
268
268
|
|
|
269
269
|
- Id: `crud/json-api-resource-package`
|
|
270
270
|
- Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
|
|
271
|
-
- Owner: `@jskit-ai/crud-core@0.1.
|
|
271
|
+
- Owner: `@jskit-ai/crud-core@0.1.257`
|
|
272
272
|
- Read: [PATTERN.md](patterns/crud/json-api-resource-package/PATTERN.md)
|
|
273
273
|
- Examples: [example/](patterns/crud/json-api-resource-package/example/)
|
|
274
274
|
- Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
|
|
@@ -279,7 +279,7 @@ Define an authenticated application resource whose records belong to the current
|
|
|
279
279
|
|
|
280
280
|
- Id: `crud/resource-contract`
|
|
281
281
|
- Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
|
|
282
|
-
- Owner: `@jskit-ai/resource-crud-core@0.1.
|
|
282
|
+
- Owner: `@jskit-ai/resource-crud-core@0.1.188`
|
|
283
283
|
- Read: [PATTERN.md](patterns/crud/resource-contract/PATTERN.md)
|
|
284
284
|
- Examples: [example/](patterns/crud/resource-contract/example/)
|
|
285
285
|
- Requires: `@jskit-ai/resource-crud-core`
|
|
@@ -290,7 +290,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
|
|
|
290
290
|
|
|
291
291
|
- Id: `database/mysql-application`
|
|
292
292
|
- Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
|
|
293
|
-
- Owner: `@jskit-ai/database-runtime-mysql@0.1.
|
|
293
|
+
- Owner: `@jskit-ai/database-runtime-mysql@0.1.244`
|
|
294
294
|
- Read: [PATTERN.md](patterns/database/mysql-application/PATTERN.md)
|
|
295
295
|
- Examples: [example/](patterns/database/mysql-application/example/)
|
|
296
296
|
- Requires: `@jskit-ai/database-runtime-mysql`
|
|
@@ -301,7 +301,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
|
|
|
301
301
|
|
|
302
302
|
- Id: `database/postgres-application`
|
|
303
303
|
- Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
|
|
304
|
-
- Owner: `@jskit-ai/database-runtime-postgres@0.1.
|
|
304
|
+
- Owner: `@jskit-ai/database-runtime-postgres@0.1.243`
|
|
305
305
|
- Read: [PATTERN.md](patterns/database/postgres-application/PATTERN.md)
|
|
306
306
|
- Examples: [example/](patterns/database/postgres-application/example/)
|
|
307
307
|
- Requires: `@jskit-ai/database-runtime-postgres`
|
|
@@ -312,7 +312,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
|
|
|
312
312
|
|
|
313
313
|
- Id: `mobile/android-application`
|
|
314
314
|
- Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
|
|
315
|
-
- Owner: `@jskit-ai/mobile-capacitor@0.1.
|
|
315
|
+
- Owner: `@jskit-ai/mobile-capacitor@0.1.183`
|
|
316
316
|
- Read: [PATTERN.md](patterns/mobile/android-application/PATTERN.md)
|
|
317
317
|
- Examples: [example/](patterns/mobile/android-application/example/)
|
|
318
318
|
- Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
|
|
@@ -323,7 +323,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
|
|
|
323
323
|
|
|
324
324
|
- Id: `realtime/realtime-application`
|
|
325
325
|
- Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
|
|
326
|
-
- Owner: `@jskit-ai/realtime@0.1.
|
|
326
|
+
- Owner: `@jskit-ai/realtime@0.1.245`
|
|
327
327
|
- Read: [PATTERN.md](patterns/realtime/realtime-application/PATTERN.md)
|
|
328
328
|
- Examples: [example/](patterns/realtime/realtime-application/example/)
|
|
329
329
|
- Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
|
|
@@ -334,7 +334,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
|
|
|
334
334
|
|
|
335
335
|
- Id: `rewards/google-rewarded`
|
|
336
336
|
- Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
|
|
337
|
-
- Owner: `@jskit-ai/rewarded-web@0.1.
|
|
337
|
+
- Owner: `@jskit-ai/rewarded-web@0.1.184`
|
|
338
338
|
- Read: [PATTERN.md](patterns/rewards/google-rewarded/PATTERN.md)
|
|
339
339
|
- Examples: [example/](patterns/rewards/google-rewarded/example/)
|
|
340
340
|
- Requires: `@jskit-ai/rewarded-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.
|
|
348
|
+
- Owner: `@jskit-ai/agent-docs@0.1.243`
|
|
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`
|
|
@@ -356,7 +356,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
|
|
|
356
356
|
|
|
357
357
|
- Id: `shell/application-shell`
|
|
358
358
|
- Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
|
|
359
|
-
- Owner: `@jskit-ai/shell-web@0.1.
|
|
359
|
+
- Owner: `@jskit-ai/shell-web@0.1.252`
|
|
360
360
|
- Read: [PATTERN.md](patterns/shell/application-shell/PATTERN.md)
|
|
361
361
|
- Examples: [example/](patterns/shell/application-shell/example/)
|
|
362
362
|
- Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
|
|
@@ -367,7 +367,7 @@ Add product routes and shell extensions through file routing, semantic placement
|
|
|
367
367
|
|
|
368
368
|
- Id: `ui/page-and-placement`
|
|
369
369
|
- Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
|
|
370
|
-
- Owner: `@jskit-ai/shell-web@0.1.
|
|
370
|
+
- Owner: `@jskit-ai/shell-web@0.1.252`
|
|
371
371
|
- Read: [PATTERN.md](patterns/ui/page-and-placement/PATTERN.md)
|
|
372
372
|
- Examples: [example/](patterns/ui/page-and-placement/example/)
|
|
373
373
|
- Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
|
|
@@ -378,7 +378,7 @@ Compose an account settings route and profile, preference, and notification sect
|
|
|
378
378
|
|
|
379
379
|
- Id: `users/account-settings`
|
|
380
380
|
- Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
|
|
381
|
-
- Owner: `@jskit-ai/users-web@0.1.
|
|
381
|
+
- Owner: `@jskit-ai/users-web@0.1.266`
|
|
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`
|
|
@@ -389,7 +389,7 @@ Expose user administration and workspace-scoped member operations through app-ow
|
|
|
389
389
|
|
|
390
390
|
- Id: `users/user-administration-server`
|
|
391
391
|
- Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
|
|
392
|
-
- Owner: `@jskit-ai/users-core@0.1.
|
|
392
|
+
- Owner: `@jskit-ai/users-core@0.1.259`
|
|
393
393
|
- Read: [PATTERN.md](patterns/users/user-administration-server/PATTERN.md)
|
|
394
394
|
- Examples: [example/](patterns/users/user-administration-server/example/)
|
|
395
395
|
- Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
|
|
@@ -400,7 +400,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
|
|
|
400
400
|
|
|
401
401
|
- Id: `workspaces/workspace-server`
|
|
402
402
|
- Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
|
|
403
|
-
- Owner: `@jskit-ai/workspaces-core@0.1.
|
|
403
|
+
- Owner: `@jskit-ai/workspaces-core@0.1.224`
|
|
404
404
|
- Read: [PATTERN.md](patterns/workspaces/workspace-server/PATTERN.md)
|
|
405
405
|
- Examples: [example/](patterns/workspaces/workspace-server/example/)
|
|
406
406
|
- Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
|
|
@@ -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.1.
|
|
414
|
+
- Owner: `@jskit-ai/workspaces-web@0.1.227`
|
|
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`
|
|
@@ -12,6 +12,25 @@ Before implementation, read the narrow relevant source pattern completely. If
|
|
|
12
12
|
its owner package is installed, prefer that version-matched package-owned copy.
|
|
13
13
|
Do not install an unrelated runtime package only to read documentation.
|
|
14
14
|
|
|
15
|
+
Before adding or changing browser-test setup, read the browser verification
|
|
16
|
+
guide at
|
|
17
|
+
`https://mobily-enterprises.github.io/jskit-ai/guide/framework/ui-operations#browser-verification`.
|
|
18
|
+
Routine tests reuse the isolated schema and prepare fixtures once per suite
|
|
19
|
+
invocation. Keep `BROWSER_TEST_DB_NAME` distinct from disposable `TEST_DB_NAME`
|
|
20
|
+
and prove that disposable cleanup preserves browser migrations. Require
|
|
21
|
+
repeat-start regression proof; do not rebuild the database or production
|
|
22
|
+
frontend for each focused browser check.
|
|
23
|
+
|
|
24
|
+
Keep verification output small. Run the relevant cases together, save complete
|
|
25
|
+
stdout/stderr to local artifacts, and preserve the exit status. Report counts,
|
|
26
|
+
duration, failed case names and artifact paths; read only actionable failure
|
|
27
|
+
excerpts. Do not dump full JSON/TAP reports, passing assertions, request logs or
|
|
28
|
+
traces into agent context. Wait on the existing run instead of restarting it or
|
|
29
|
+
repeatedly printing unchanged output. Keep startup and cleanup errors visible.
|
|
30
|
+
For browser evidence, use existing automated cases, targeted locators and
|
|
31
|
+
meaningful visual checkpoints. Avoid a full DOM snapshot or screenshot after
|
|
32
|
+
every action; retain the required viewport, identity and security checks.
|
|
33
|
+
|
|
15
34
|
Pages never start with a page header, title block, welcome heading, or other
|
|
16
35
|
standalone heading copy. Start with the useful content and actions. If the user
|
|
17
36
|
wants a heading, they will ask for or add one.
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"dependencies": {
|
|
35
35
|
"@local/main": "0.1.0",
|
|
36
36
|
"@fastify/static": "^10.1.3",
|
|
37
|
-
"@jskit-ai/kernel": "0.1.
|
|
37
|
+
"@jskit-ai/kernel": "0.1.246",
|
|
38
38
|
"@tanstack/vue-query": "^5.101.0",
|
|
39
39
|
"fastify": "^5.8.5",
|
|
40
40
|
"json-rest-schema": "^1.0.17",
|
|
@@ -42,13 +42,13 @@
|
|
|
42
42
|
"vue": "^3.5.44",
|
|
43
43
|
"vue-router": "^5.3.1",
|
|
44
44
|
"vuetify": "^4.1.2",
|
|
45
|
-
"@jskit-ai/http-runtime": "0.1.
|
|
45
|
+
"@jskit-ai/http-runtime": "0.1.244",
|
|
46
46
|
"@fastify/fast-json-stringify-compiler": "^5.1.0",
|
|
47
47
|
"@vue/devtools-api": "^8.2.1"
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|
|
50
50
|
"@jskit-ai/config-eslint": "0.1.241",
|
|
51
|
-
"@jskit-ai/jskit-catalog": "0.1.
|
|
51
|
+
"@jskit-ai/jskit-catalog": "0.1.296",
|
|
52
52
|
"@playwright/test": "1.61.1",
|
|
53
53
|
"@vitejs/plugin-vue": "^6.0.7",
|
|
54
54
|
"eslint": "^10.8.0",
|
package/skills/jskit/references/patterns/app/minimal-foundation/example/server/lib/runtimeEnv.js
CHANGED
|
@@ -1,8 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
2
|
import { surfaceRuntime } from "./surfaceRuntime.js";
|
|
3
3
|
|
|
4
|
-
const require = createRequire(import.meta.url);
|
|
5
|
-
|
|
6
4
|
function toPort(value, fallback = 3000) {
|
|
7
5
|
const parsed = Number.parseInt(String(value || "").trim(), 10);
|
|
8
6
|
if (Number.isInteger(parsed) && parsed > 0) {
|
|
@@ -17,14 +15,8 @@ function ensureRuntimeEnvLoaded() {
|
|
|
17
15
|
if (envLoaded) {
|
|
18
16
|
return;
|
|
19
17
|
}
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
const loadDotEnv = dotenvModule?.config;
|
|
23
|
-
if (typeof loadDotEnv === "function") {
|
|
24
|
-
loadDotEnv();
|
|
25
|
-
}
|
|
26
|
-
} catch {
|
|
27
|
-
// dotenv is optional in base-shell; bundles can add it when needed.
|
|
18
|
+
if (existsSync(".env")) {
|
|
19
|
+
process.loadEnvFile(".env");
|
|
28
20
|
}
|
|
29
21
|
envLoaded = true;
|
|
30
22
|
}
|
|
@@ -35,8 +35,6 @@ const { router, fallbackRoute } = createShellRouter({
|
|
|
35
35
|
surfaceMode,
|
|
36
36
|
notFoundComponent: NotFoundView,
|
|
37
37
|
guard: {
|
|
38
|
-
surfaceDefinitions: config.surfaceDefinitions,
|
|
39
|
-
defaultSurfaceId: config.surfaceDefaultId,
|
|
40
38
|
webRootAllowed: config.webRootAllowed
|
|
41
39
|
}
|
|
42
40
|
});
|
|
@@ -74,6 +74,10 @@ source files.
|
|
|
74
74
|
`.gitignore` when copying it to an app. Managed preview identity belongs to the
|
|
75
75
|
authentication surface pattern, not the shell foundation.
|
|
76
76
|
|
|
77
|
+
The shell files are the `shell/application-shell` pattern's example from
|
|
78
|
+
`@jskit-ai/shell-web`, and the remaining files are the minimal foundation's,
|
|
79
|
+
byte for byte. Change those owners first and keep the copies identical.
|
|
80
|
+
|
|
77
81
|
Read these together before adapting the shell:
|
|
78
82
|
|
|
79
83
|
- `example/src/App.vue`
|
|
@@ -94,29 +98,16 @@ Do not preinstall capabilities solely because they appear in another app.
|
|
|
94
98
|
|
|
95
99
|
## Development warmup
|
|
96
100
|
|
|
97
|
-
Keep development-server warmup
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
Keep dependency optimization separate: reducing warmup does not require disabling
|
|
102
|
-
the dependency scanner or JSKIT's installed-package optimization settings.
|
|
103
|
-
The bootstrap plugin scans local client entries and their shared imports before
|
|
104
|
-
page loading. Do not exclude local package roots from optimization: Vite already
|
|
105
|
-
keeps their real paths as source, and exclusions hide their dependency imports.
|
|
106
|
-
Keep the example's Vuetify component/directive includes because auto-imports are
|
|
107
|
-
introduced after the initial scan.
|
|
101
|
+
Keep the development-server warmup, dependency optimization, and Vuetify
|
|
102
|
+
includes exactly as the
|
|
103
|
+
[minimal foundation](../minimal-foundation/PATTERN.md) describes in its
|
|
104
|
+
Development warmup section.
|
|
108
105
|
|
|
109
106
|
## Verification
|
|
110
107
|
|
|
111
|
-
Keep the initial loading shell in `index.html
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
Vue replaces it on mount; the bootstrap failure handler retains an actionable
|
|
115
|
-
error. A failed module download still leaves the static Reload link available.
|
|
116
|
-
Preserve `tests/e2e/startup.spec.ts`: it holds JavaScript requests while proving
|
|
117
|
-
visible loading feedback at three widths, then releases them and proves mounting.
|
|
118
|
-
Run this check against the production build as part of the application's release
|
|
119
|
-
verification, not only against Vite development mode.
|
|
108
|
+
Keep the initial loading shell in `index.html` and preserve
|
|
109
|
+
`tests/e2e/startup.spec.ts` as the minimal foundation's Verification section
|
|
110
|
+
describes, including its production-build check.
|
|
120
111
|
|
|
121
112
|
Install the declared packages once, run `npm run develop` for the live
|
|
122
113
|
application, then run lint, server tests, client tests, the production build,
|
|
@@ -12,6 +12,25 @@ Before implementation, read the narrow relevant source pattern completely. If
|
|
|
12
12
|
its owner package is installed, prefer that version-matched package-owned copy.
|
|
13
13
|
Do not install an unrelated runtime package only to read documentation.
|
|
14
14
|
|
|
15
|
+
Before adding or changing browser-test setup, read the browser verification
|
|
16
|
+
guide at
|
|
17
|
+
`https://mobily-enterprises.github.io/jskit-ai/guide/framework/ui-operations#browser-verification`.
|
|
18
|
+
Routine tests reuse the isolated schema and prepare fixtures once per suite
|
|
19
|
+
invocation. Keep `BROWSER_TEST_DB_NAME` distinct from disposable `TEST_DB_NAME`
|
|
20
|
+
and prove that disposable cleanup preserves browser migrations. Require
|
|
21
|
+
repeat-start regression proof; do not rebuild the database or production
|
|
22
|
+
frontend for each focused browser check.
|
|
23
|
+
|
|
24
|
+
Keep verification output small. Run the relevant cases together, save complete
|
|
25
|
+
stdout/stderr to local artifacts, and preserve the exit status. Report counts,
|
|
26
|
+
duration, failed case names and artifact paths; read only actionable failure
|
|
27
|
+
excerpts. Do not dump full JSON/TAP reports, passing assertions, request logs or
|
|
28
|
+
traces into agent context. Wait on the existing run instead of restarting it or
|
|
29
|
+
repeatedly printing unchanged output. Keep startup and cleanup errors visible.
|
|
30
|
+
For browser evidence, use existing automated cases, targeted locators and
|
|
31
|
+
meaningful visual checkpoints. Avoid a full DOM snapshot or screenshot after
|
|
32
|
+
every action; retain the required viewport, identity and security checks.
|
|
33
|
+
|
|
15
34
|
Pages never start with a page header, title block, welcome heading, or other
|
|
16
35
|
standalone heading copy. Start with the useful content and actions. If the user
|
|
17
36
|
wants a heading, they will ask for or add one.
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"dependencies": {
|
|
35
35
|
"@local/main": "0.1.0",
|
|
36
36
|
"@fastify/static": "^10.1.3",
|
|
37
|
-
"@jskit-ai/kernel": "0.1.
|
|
37
|
+
"@jskit-ai/kernel": "0.1.246",
|
|
38
38
|
"@tanstack/vue-query": "^5.101.0",
|
|
39
39
|
"fastify": "^5.8.5",
|
|
40
40
|
"json-rest-schema": "^1.0.17",
|
|
@@ -42,15 +42,15 @@
|
|
|
42
42
|
"vue": "^3.5.44",
|
|
43
43
|
"vue-router": "^5.3.1",
|
|
44
44
|
"vuetify": "^4.1.2",
|
|
45
|
-
"@jskit-ai/http-runtime": "0.1.
|
|
45
|
+
"@jskit-ai/http-runtime": "0.1.244",
|
|
46
46
|
"@mdi/js": "^7.4.47",
|
|
47
|
-
"@jskit-ai/shell-web": "0.1.
|
|
47
|
+
"@jskit-ai/shell-web": "0.1.252",
|
|
48
48
|
"@fastify/fast-json-stringify-compiler": "^5.1.0",
|
|
49
49
|
"@vue/devtools-api": "^8.2.1"
|
|
50
50
|
},
|
|
51
51
|
"devDependencies": {
|
|
52
52
|
"@jskit-ai/config-eslint": "0.1.241",
|
|
53
|
-
"@jskit-ai/jskit-catalog": "0.1.
|
|
53
|
+
"@jskit-ai/jskit-catalog": "0.1.296",
|
|
54
54
|
"@playwright/test": "1.61.1",
|
|
55
55
|
"@vitejs/plugin-vue": "^6.0.7",
|
|
56
56
|
"eslint": "^10.8.0",
|
package/skills/jskit/references/patterns/app/shell-foundation/example/server/lib/runtimeEnv.js
CHANGED
|
@@ -1,8 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
2
|
import { surfaceRuntime } from "./surfaceRuntime.js";
|
|
3
3
|
|
|
4
|
-
const require = createRequire(import.meta.url);
|
|
5
|
-
|
|
6
4
|
function toPort(value, fallback = 3000) {
|
|
7
5
|
const parsed = Number.parseInt(String(value || "").trim(), 10);
|
|
8
6
|
if (Number.isInteger(parsed) && parsed > 0) {
|
|
@@ -17,14 +15,8 @@ function ensureRuntimeEnvLoaded() {
|
|
|
17
15
|
if (envLoaded) {
|
|
18
16
|
return;
|
|
19
17
|
}
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
const loadDotEnv = dotenvModule?.config;
|
|
23
|
-
if (typeof loadDotEnv === "function") {
|
|
24
|
-
loadDotEnv();
|
|
25
|
-
}
|
|
26
|
-
} catch {
|
|
27
|
-
// dotenv is optional in base-shell; bundles can add it when needed.
|
|
18
|
+
if (existsSync(".env")) {
|
|
19
|
+
process.loadEnvFile(".env");
|
|
28
20
|
}
|
|
29
21
|
envLoaded = true;
|
|
30
22
|
}
|
|
@@ -35,8 +35,6 @@ const { router, fallbackRoute } = createShellRouter({
|
|
|
35
35
|
surfaceMode,
|
|
36
36
|
notFoundComponent: NotFoundView,
|
|
37
37
|
guard: {
|
|
38
|
-
surfaceDefinitions: config.surfaceDefinitions,
|
|
39
|
-
defaultSurfaceId: config.surfaceDefaultId,
|
|
40
38
|
webRootAllowed: config.webRootAllowed
|
|
41
39
|
}
|
|
42
40
|
});
|
package/skills/jskit/references/patterns/app/shell-foundation/example/src/pages/home/settings.vue
CHANGED
|
@@ -23,7 +23,7 @@ import { RouterView } from "vue-router";
|
|
|
23
23
|
|
|
24
24
|
<style scoped>
|
|
25
25
|
.settings-shell {
|
|
26
|
-
--settings-panel-padding: 1rem;
|
|
26
|
+
--settings-shell-panel-padding: 1rem;
|
|
27
27
|
}
|
|
28
28
|
|
|
29
29
|
.settings-shell__panel {
|
|
@@ -34,7 +34,7 @@ import { RouterView } from "vue-router";
|
|
|
34
34
|
display: grid;
|
|
35
35
|
gap: 1rem;
|
|
36
36
|
grid-template-columns: minmax(12rem, 16rem) minmax(0, 1fr);
|
|
37
|
-
padding: var(--settings-panel-padding);
|
|
37
|
+
padding: var(--settings-shell-panel-padding);
|
|
38
38
|
}
|
|
39
39
|
|
|
40
40
|
.settings-shell__content {
|
|
@@ -7,10 +7,10 @@
|
|
|
7
7
|
"db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
|
|
8
8
|
},
|
|
9
9
|
"dependencies": {
|
|
10
|
-
"@jskit-ai/connectors-core": "0.1.
|
|
11
|
-
"@jskit-ai/connector-google-calendar": "0.1.
|
|
12
|
-
"@jskit-ai/database-runtime": "0.1.
|
|
13
|
-
"@jskit-ai/database-runtime-mysql": "0.1.
|
|
10
|
+
"@jskit-ai/connectors-core": "0.1.63",
|
|
11
|
+
"@jskit-ai/connector-google-calendar": "0.1.63",
|
|
12
|
+
"@jskit-ai/database-runtime": "0.1.246",
|
|
13
|
+
"@jskit-ai/database-runtime-mysql": "0.1.244",
|
|
14
14
|
"knex": "^3.1.0"
|
|
15
15
|
}
|
|
16
16
|
}
|