@jskit-ai/agent-docs 0.1.149 → 0.1.151

package/skills/jskit/references/existing-application-migration.md

@@ -1,9 +1,4 @@
-<!-- Generated by `npm run agent-docs:build` from `packages/agent-docs/site/guide/app-setup/existing-application-migration.md`. Do not edit manually. -->
-
----
-title: Migrate an existing application
-description: Port a working application to AI-first JSKIT without regenerating it or flattening its product behavior.
----
+<!-- Generated from `packages/agent-docs/site/guide/app-setup/existing-application-migration.md` by `npm run agent-docs:build`. -->
 
 # Migrate an existing application
 
@@ -50,12 +45,14 @@ generic CRUD merely to make the structure look uniform.
 
 ## 2. Plan one coordinated dependency and capability graph
 
-Use the installed JSKIT pattern index and package metadata to select the
-smallest complete package set. Plan the top-level dependencies and their
-ordinary npm closure before changing the lockfile, then install that planned
-closure once. Review `package.json` and the lockfile as source changes. Adopt
-the supported package-graph scripts and run `npm run jskit:update` before
-changing application source; see the **Upgrade JSKIT** guide in the agent docs.
+Use the [bundled source pattern index](pattern-index.md) and installed package
+metadata to select the smallest complete package set. Do not install an
+unrelated runtime package only to read its pattern. Plan the top-level
+dependencies and their ordinary npm closure before changing the lockfile, then
+install that planned closure once. Review `package.json` and the lockfile as
+source changes. Adopt the supported package-graph scripts and run `npm run
+jskit:update` before changing application source; see the **Upgrade JSKIT**
+guide in the agent docs.
 The updater aligns root and workspace declarations to one published release
 cohort, installs once at the project root, and verifies the resulting lockfile.
 It does not regenerate or synchronize application source.

package/skills/jskit/references/material-3.md

@@ -1,3 +1,5 @@
+<!-- Generated from `packages/agent-docs/site/guide/framework/material-3.md` by `npm run agent-docs:build`. -->
+
 # Material 3
 
 Read completely before any JSKIT Vue/Vuetify UI task.
@@ -42,8 +44,9 @@ Do not replace a shared screen to restyle it. Use its public seams.
 - Use Vuetify spacing utilities and established JSKIT dimensions before raw
   values. Preserve JSKIT shell widths, target sizes, and spacing props.
 - Use elevation `0` through `5`, shape props, and component variants instead of
-  arbitrary shadows and radii. Prefer a page header and direct `v-sheet` work
-  region; add cards or dialogs only for genuinely grouped or elevated objects.
+  arbitrary shadows and radii. Never add page headers or standalone headings
+  unless explicitly requested. Use a direct `v-sheet` work region when needed;
+  reserve cards and dialogs for genuinely grouped or elevated objects.
 
 ## Components, state, and feedback
 

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

@@ -7,7 +7,7 @@ Patterns are ordinary package-owned Markdown and example files. Read the matchin
 
 Do not create or consult receipts recording that a pattern was used. Current source and verification are the evidence.
 
-Resolve an installed pattern from the project root as `node_modules/<package-id>/<document-path>`. Example files are beside it under the listed example path.
+This documentation artifact contains a version-matched copy of every listed pattern and example. Runtime packages remain separate dependencies and should be installed only when the application selects them.
 
 ## Minimal JSKIT application foundation
 
@@ -15,9 +15,9 @@ 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.149`
-- Read: `node_modules/@jskit-ai/agent-docs/patterns/minimal-foundation/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/agent-docs/patterns/minimal-foundation/example/`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
+- Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
+- Examples: [example/](patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
 
 ## Adaptive-shell JSKIT application foundation
@@ -26,9 +26,9 @@ 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.149`
-- Read: `node_modules/@jskit-ai/agent-docs/patterns/shell-foundation/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/agent-docs/patterns/shell-foundation/example/`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
+- 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`
 
 ## Assistant surface and settings
@@ -37,9 +37,9 @@ 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.1.148`
-- Read: `node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/example/`
+- Owner: `@jskit-ai/assistant-runtime@0.1.150`
+- Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
+- Examples: [example/](patterns/assistant/assistant-surface/example/)
 - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/shell-web`
 
 ## Authentication surface
@@ -48,9 +48,9 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
 
 - Id: `auth/auth-surface`
 - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
-- Owner: `@jskit-ai/auth-web@0.1.177`
-- Read: `node_modules/@jskit-ai/auth-web/patterns/auth-surface/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/auth-web/patterns/auth-surface/example/`
+- Owner: `@jskit-ai/auth-web@0.1.179`
+- Read: [PATTERN.md](patterns/auth/auth-surface/PATTERN.md)
+- Examples: [example/](patterns/auth/auth-surface/example/)
 - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
 
 ## Supabase authentication
@@ -59,9 +59,9 @@ Add Supabase authentication through normal npm composition, explicit environment
 
 - Id: `auth/supabase-auth`
 - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
-- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.174`
-- Read: `node_modules/@jskit-ai/auth-provider-supabase-core/patterns/supabase-auth/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/auth-provider-supabase-core/patterns/supabase-auth/example/`
+- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.176`
+- Read: [PATTERN.md](patterns/auth/supabase-auth/PATTERN.md)
+- Examples: [example/](patterns/auth/supabase-auth/example/)
 - Requires: `@jskit-ai/auth-provider-supabase-core`
 
 ## Owner console surface
@@ -70,9 +70,9 @@ Add a protected administration surface, settings shell, and semantic navigation
 
 - Id: `console/console-surface`
 - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/console-web@0.1.145`
-- Read: `node_modules/@jskit-ai/console-web/patterns/console-surface/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/console-web/patterns/console-surface/example/`
+- Owner: `@jskit-ai/console-web@0.1.147`
+- Read: [PATTERN.md](patterns/console/console-surface/PATTERN.md)
+- Examples: [example/](patterns/console/console-surface/example/)
 - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
 
 ## CRUD list, view, create, and edit screens
@@ -81,9 +81,9 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
 
 - Id: `crud/crud-screen-set`
 - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
-- Owner: `@jskit-ai/http-web@0.1.22`
-- Read: `node_modules/@jskit-ai/http-web/patterns/crud-screen-set/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/http-web/patterns/crud-screen-set/example/`
+- Owner: `@jskit-ai/http-web@0.1.24`
+- Read: [PATTERN.md](patterns/crud/crud-screen-set/PATTERN.md)
+- Examples: [example/](patterns/crud/crud-screen-set/example/)
 - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
 
 ## JSON API CRUD resource package
@@ -92,9 +92,9 @@ Build a complete application-owned CRUD server package from a migration, resourc
 
 - Id: `crud/json-api-resource-package`
 - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
-- Owner: `@jskit-ai/crud-core@0.1.188`
-- Read: `node_modules/@jskit-ai/crud-core/patterns/json-api-resource-package/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/crud-core/patterns/json-api-resource-package/example/`
+- Owner: `@jskit-ai/crud-core@0.1.190`
+- Read: [PATTERN.md](patterns/crud/json-api-resource-package/PATTERN.md)
+- Examples: [example/](patterns/crud/json-api-resource-package/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
 
 ## Owner-scoped CRUD resource contract
@@ -103,9 +103,9 @@ Define an authenticated application resource whose records belong to the current
 
 - Id: `crud/resource-contract`
 - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
-- Owner: `@jskit-ai/resource-crud-core@0.1.119`
-- Read: `node_modules/@jskit-ai/resource-crud-core/patterns/resource-contract/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/resource-crud-core/patterns/resource-contract/example/`
+- Owner: `@jskit-ai/resource-crud-core@0.1.121`
+- Read: [PATTERN.md](patterns/crud/resource-contract/PATTERN.md)
+- Examples: [example/](patterns/crud/resource-contract/example/)
 - Requires: `@jskit-ai/resource-crud-core`
 
 ## MySQL application database
@@ -114,9 +114,9 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
 
 - Id: `database/mysql-application`
 - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
-- Owner: `@jskit-ai/database-runtime-mysql@0.1.175`
-- Read: `node_modules/@jskit-ai/database-runtime-mysql/patterns/mysql-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/database-runtime-mysql/patterns/mysql-application/example/`
+- Owner: `@jskit-ai/database-runtime-mysql@0.1.177`
+- Read: [PATTERN.md](patterns/database/mysql-application/PATTERN.md)
+- Examples: [example/](patterns/database/mysql-application/example/)
 - Requires: `@jskit-ai/database-runtime-mysql`
 
 ## PostgreSQL application database
@@ -125,9 +125,9 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
 
 - Id: `database/postgres-application`
 - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
-- Owner: `@jskit-ai/database-runtime-postgres@0.1.174`
-- Read: `node_modules/@jskit-ai/database-runtime-postgres/patterns/postgres-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/database-runtime-postgres/patterns/postgres-application/example/`
+- Owner: `@jskit-ai/database-runtime-postgres@0.1.176`
+- Read: [PATTERN.md](patterns/database/postgres-application/PATTERN.md)
+- Examples: [example/](patterns/database/postgres-application/example/)
 - Requires: `@jskit-ai/database-runtime-postgres`
 
 ## Capacitor Android application
@@ -136,9 +136,9 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
 
 - Id: `mobile/android-application`
 - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
-- Owner: `@jskit-ai/mobile-capacitor@0.1.112`
-- Read: `node_modules/@jskit-ai/mobile-capacitor/patterns/android-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/mobile-capacitor/patterns/android-application/example/`
+- Owner: `@jskit-ai/mobile-capacitor@0.1.114`
+- Read: [PATTERN.md](patterns/mobile/android-application/PATTERN.md)
+- Examples: [example/](patterns/mobile/android-application/example/)
 - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
 
 ## Realtime application
@@ -147,9 +147,9 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
 
 - Id: `realtime/realtime-application`
 - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
-- Owner: `@jskit-ai/realtime@0.1.174`
-- Read: `node_modules/@jskit-ai/realtime/patterns/realtime-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/realtime/patterns/realtime-application/example/`
+- Owner: `@jskit-ai/realtime@0.1.176`
+- Read: [PATTERN.md](patterns/realtime/realtime-application/PATTERN.md)
+- Examples: [example/](patterns/realtime/realtime-application/example/)
 - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
 
 ## App-local server feature package
@@ -158,9 +158,9 @@ 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.149`
-- Read: `node_modules/@jskit-ai/agent-docs/patterns/feature-package/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/agent-docs/patterns/feature-package/example/`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
+- Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
+- Examples: [example/](patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`
 
 ## Responsive application shell
@@ -169,9 +169,9 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
 
 - Id: `shell/application-shell`
 - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
-- Owner: `@jskit-ai/shell-web@0.1.181`
-- Read: `node_modules/@jskit-ai/shell-web/patterns/application-shell/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/shell-web/patterns/application-shell/example/`
+- Owner: `@jskit-ai/shell-web@0.1.183`
+- Read: [PATTERN.md](patterns/shell/application-shell/PATTERN.md)
+- Examples: [example/](patterns/shell/application-shell/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
 
 ## Routed page, section navigation, and placed element
@@ -180,9 +180,9 @@ Add product routes and shell extensions through file routing, semantic placement
 
 - Id: `ui/page-and-placement`
 - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
-- Owner: `@jskit-ai/shell-web@0.1.181`
-- Read: `node_modules/@jskit-ai/shell-web/patterns/page-and-placement/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/shell-web/patterns/page-and-placement/example/`
+- Owner: `@jskit-ai/shell-web@0.1.183`
+- Read: [PATTERN.md](patterns/ui/page-and-placement/PATTERN.md)
+- Examples: [example/](patterns/ui/page-and-placement/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
 
 ## Account settings surface
@@ -191,9 +191,9 @@ Compose an account settings route and profile, preference, and notification sect
 
 - Id: `users/account-settings`
 - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
-- Owner: `@jskit-ai/users-web@0.1.195`
-- Read: `node_modules/@jskit-ai/users-web/patterns/account-settings/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/users-web/patterns/account-settings/example/`
+- Owner: `@jskit-ai/users-web@0.1.197`
+- Read: [PATTERN.md](patterns/users/account-settings/PATTERN.md)
+- Examples: [example/](patterns/users/account-settings/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
 
 ## User administration server package
@@ -202,9 +202,9 @@ Expose user administration and workspace-scoped member operations through app-ow
 
 - Id: `users/user-administration-server`
 - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
-- Owner: `@jskit-ai/users-core@0.1.190`
-- Read: `node_modules/@jskit-ai/users-core/patterns/user-administration-server/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/users-core/patterns/user-administration-server/example/`
+- Owner: `@jskit-ai/users-core@0.1.192`
+- Read: [PATTERN.md](patterns/users/user-administration-server/PATTERN.md)
+- Examples: [example/](patterns/users/user-administration-server/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
 
 ## Workspace tenancy server composition
@@ -213,9 +213,9 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
 
 - Id: `workspaces/workspace-server`
 - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
-- Owner: `@jskit-ai/workspaces-core@0.1.155`
-- Read: `node_modules/@jskit-ai/workspaces-core/patterns/workspace-server/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/workspaces-core/patterns/workspace-server/example/`
+- Owner: `@jskit-ai/workspaces-core@0.1.157`
+- Read: [PATTERN.md](patterns/workspaces/workspace-server/PATTERN.md)
+- Examples: [example/](patterns/workspaces/workspace-server/example/)
 - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
 
 ## Workspace application and administration surfaces
@@ -224,7 +224,7 @@ Compose workspace selection, invitation, member administration, settings, and re
 
 - Id: `workspaces/workspace-surfaces`
 - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
-- Owner: `@jskit-ai/workspaces-web@0.1.156`
-- Read: `node_modules/@jskit-ai/workspaces-web/patterns/workspace-surfaces/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/workspaces-web/patterns/workspace-surfaces/example/`
+- Owner: `@jskit-ai/workspaces-web@0.1.158`
+- Read: [PATTERN.md](patterns/workspaces/workspace-surfaces/PATTERN.md)
+- Examples: [example/](patterns/workspaces/workspace-surfaces/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`

package/skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md

@@ -0,0 +1,107 @@
+---
+id: app/minimal-foundation
+title: Minimal JSKIT application foundation
+summary: A concrete Fastify, Vue, and JSKIT application foundation for products that do not yet need the full adaptive shell.
+keywords: app, fastify, foundation, minimal, server, vite, vue
+requires: @jskit-ai/http-runtime, @jskit-ai/kernel
+---
+
+# Minimal JSKIT application foundation
+
+## Use when
+
+Use this pattern when establishing a new JSKIT web application in an existing
+project repository and the product does not yet need the full adaptive shell,
+settings navigation, or placement topology. It provides a working server,
+client bootstrap, app-local provider package, one public surface, linting, unit
+tests, browser tests, and the normal build entrypoints.
+
+The example is a concrete application named `reading-room`. Copy the useful
+files into the project root, rename the application in normal source and
+package metadata, and then edit the product-facing page. The files become
+ordinary application source immediately.
+
+## Do not use when
+
+Do not use this pattern when the application already has an established
+server/client foundation. Do not replace a working app merely to make it
+resemble the example. Prefer the shell foundation when responsive navigation,
+settings, or placement contributions are already clear requirements.
+
+## Product decisions
+
+Decide the application name, first useful route, public versus authenticated
+surface access, and whether the product needs the adaptive shell. These are
+product decisions for the user and agent; this pattern does not ask a
+questionnaire or infer tenancy, authentication, or database requirements.
+
+## Invariants
+
+- Preserve `.git` and all unrelated project and agent context.
+- Pages start with useful content and actions, never a default page header or
+  standalone heading.
+- Refuse or resolve real destination-file collisions before copying.
+- Keep `packages/main` limited to app composition and lightweight glue.
+- Declare `packages/*` as an npm workspace and depend on app-local packages by
+  their exact package versions, never through `file:` paths.
+- Use package public APIs; do not deep-import package internals.
+- Keep one server entry, one client bootstrap, and explicit surface access.
+- Keep one app-owned `npm run develop` entry that runs the API on loopback and
+  Vite on the host-supplied preview port; do not require a host to infer or
+  supervise framework-specific processes.
+- Keep Vite's default `resolve.preserveSymlinks: false` so linked application
+  packages resolve to mutable `/packages/` source during development.
+- If the application adds a production service worker, never cache Vite
+  development paths. Cache JavaScript and CSS only through content-hashed
+  `/assets/` URLs.
+- Treat copied files as app-owned source. Do not add provenance, ownership
+  markers, receipts, ledgers, or operation-history state.
+- Keep browser dependencies aligned with the execution environment that will
+  run the tests. Vibe64 supplies its exact managed Playwright version.
+
+## Framework APIs
+
+The example composes `@jskit-ai/kernel` for provider/runtime composition and
+`@jskit-ai/http-runtime` for the web runtime. `packages/main` demonstrates the
+app-local provider boundary. Vite, Vue Router, Pinia, Vuetify, Fastify, and Vue
+Query remain normal application dependencies.
+
+## Example files
+
+`example/` is a complete concrete application tree. Copy only after inspecting
+collisions. Rename `example/gitignore` to `.gitignore` in the application;
+the neutral filename ensures npm publishes the reference asset. Managed preview
+identity belongs to the authentication surface pattern, not the neutral
+foundation.
+
+Important starting points are:
+
+- `example/package.json`
+- `example/server.js`, `example/bin/server.js`, and `example/bin/develop.js`
+- `example/src/main.js` and `example/src/App.vue`
+- `example/config/public.js`
+- `example/packages/main/`
+- `example/tests/`
+
+## Variation points
+
+Rename the package and title, replace the home page with the first real
+product surface, add capabilities through their owning packages, and change
+surface access deliberately. Add authentication, database, CRUD, shell, or
+mobile patterns only when chosen. Do not pre-emptively include them.
+
+## Verification
+
+After adapting the example, install the declared packages once and run
+`npm run develop` for the live application. Then run the application's lint,
+server tests, client tests, production build, and focused browser smoke.
+Confirm `/api/health` and the first product route.
+
+## Avoid
+
+- Do not run a scaffold questionnaire.
+- Do not create a temporary app and copy its result over the project.
+- Do not force-overwrite an existing repository.
+- Do not keep `reading-room` names that no longer describe the product.
+- Do not add a hidden file recording that this pattern was copied.
+- Do not turn the example into a field interpolation language.

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

@@ -0,0 +1 @@
+26

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

@@ -0,0 +1,21 @@
+# App Agent Instructions
+
+Use current project context, JSKIT public APIs, and the official framework
+documentation as the source of truth for application work.
+
+Framework references:
+
+- `https://mobily-enterprises.github.io/jskit-ai/guide/`
+- `https://mobily-enterprises.github.io/jskit-ai/patterns/`
+
+Before implementation, read the narrow relevant source pattern completely. If
+its owner package is installed, prefer that version-matched package-owned copy.
+Do not install an unrelated runtime package only to read documentation.
+
+Pages never start with a page header, title block, welcome heading, or other
+standalone heading copy. Start with the useful content and actions. If the user
+wants a heading, they will ask for or add one.
+
+Copied pattern source is ordinary application source. Do not add generator
+provenance, receipts, completion ledgers, or tooling-operation history. Keep
+changes scoped to the user request and verify runtime behavior directly.

package/skills/jskit/references/patterns/app/minimal-foundation/example/Procfile

@@ -0,0 +1 @@
+web: npm run start

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

@@ -0,0 +1,14 @@
+{
+  "name": "reading-room",
+  "healthchecks": {
+    "web": [
+      {
+        "type": "startup",
+        "name": "web-ready",
+        "description": "Application responds to /api/health",
+        "path": "/api/health",
+        "attempts": 6
+      }
+    ]
+  }
+}

package/skills/jskit/references/patterns/app/minimal-foundation/example/bin/develop.js

@@ -0,0 +1,71 @@
+import { spawn } from "node:child_process";
+import { startServer } from "../server.js";
+
+const LOOPBACK_HOST = "127.0.0.1";
+
+function requiredPort(value, fallback = 3000) {
+  const normalized = String(value || "").trim();
+  const parsed = Number.parseInt(normalized || String(fallback), 10);
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65_535) {
+    throw new Error(`Invalid development port: ${normalized || "(empty)"}.`);
+  }
+  return parsed;
+}
+
+function waitForChild(child) {
+  return new Promise((resolve, reject) => {
+    child.once("error", reject);
+    child.once("exit", (code, signal) => resolve({ code, signal }));
+  });
+}
+
+const previewHost = String(process.env.HOST || "").trim() || "0.0.0.0";
+const previewPort = requiredPort(process.env.PORT);
+let apiServer = null;
+let viteProcess = null;
+let requestedSignal = "";
+
+function requestShutdown(signal) {
+  requestedSignal = signal;
+  if (viteProcess && !viteProcess.killed) {
+    viteProcess.kill(signal);
+  }
+}
+
+process.once("SIGINT", () => requestShutdown("SIGINT"));
+process.once("SIGTERM", () => requestShutdown("SIGTERM"));
+
+try {
+  apiServer = await startServer({ host: LOOPBACK_HOST, port: 0 });
+  const apiPort = requiredPort(apiServer.server.address()?.port);
+  const npmCommand = process.platform === "win32" ? "npm.cmd" : "npm";
+  viteProcess = spawn(
+    npmCommand,
+    ["run", "dev", "--", "--host", previewHost, "--port", String(previewPort), "--strictPort"],
+    {
+      cwd: process.cwd(),
+      env: {
+        ...process.env,
+        HOST: previewHost,
+        PORT: String(previewPort),
+        VITE_API_PROXY_TARGET: `http://${LOOPBACK_HOST}:${apiPort}`,
+        VITE_DEV_PORT: String(previewPort)
+      },
+      stdio: "inherit"
+    }
+  );
+
+  const result = await waitForChild(viteProcess);
+  if (!requestedSignal && result.code !== 0) {
+    throw new Error(
+      `Vite development server stopped unexpectedly (${result.signal || `exit ${result.code ?? "unknown"}`}).`
+    );
+  }
+} catch (error) {
+  console.error("Failed to start the development application:", error);
+  process.exitCode = 1;
+} finally {
+  if (apiServer) {
+    await apiServer.close().catch(() => {});
+  }
+}

package/skills/jskit/references/patterns/app/minimal-foundation/example/bin/server.js

@@ -0,0 +1,8 @@
+import { startServer } from "../server.js";
+
+try {
+  await startServer();
+} catch (error) {
+  console.error("Failed to start reading-room server:", error);
+  process.exitCode = 1;
+}

package/skills/jskit/references/patterns/app/minimal-foundation/example/config/public.js

@@ -0,0 +1,40 @@
+import { surfaceAccessPolicies } from "./surfaceAccessPolicies.js";
+
+export const config = {};
+
+config.surfaceModeAll = "all";
+config.surfaceDefaultId = "home";
+config.webRootAllowed = "no";
+config.surfaceAccessPolicies = surfaceAccessPolicies;
+config.mobile = {
+  enabled: false,
+  strategy: "",
+  appId: "",
+  appName: "",
+  assetMode: "bundled",
+  devServerUrl: "",
+  apiBaseUrl: "",
+  auth: {
+    callbackPath: "/auth/login",
+    customScheme: "",
+    appLinkDomains: []
+  },
+  android: {
+    packageName: "",
+    minSdk: 26,
+    targetSdk: 35,
+    versionCode: 1,
+    versionName: "1.0.0"
+  }
+};
+config.surfaceDefinitions = {};
+config.surfaceDefinitions.home = {
+  id: "home",
+  label: "Home",
+  pagesRoot: "home",
+  enabled: true,
+  requiresAuth: false,
+  requiresWorkspace: false,
+  accessPolicyId: "public",
+  origin: ""
+};

package/skills/jskit/references/patterns/app/minimal-foundation/example/config/server.js

@@ -0,0 +1 @@
+export const config = {};

package/skills/jskit/references/patterns/app/minimal-foundation/example/config/surfaceAccessPolicies.js

@@ -0,0 +1,3 @@
+export const surfaceAccessPolicies = {};
+
+surfaceAccessPolicies.public = {};

package/skills/jskit/references/patterns/app/minimal-foundation/example/eslint.config.mjs

@@ -0,0 +1,19 @@
+import { baseConfig, nodeConfig, vueConfig, webConfig } from "@jskit-ai/config-eslint/server";
+
+export default [
+  {
+    ignores: ["dist/**", "node_modules/**", "coverage/**", "test-results/**", ".jskit/**"]
+  },
+  {
+    files: ["src/pages/**/*.vue"],
+    languageOptions: {
+      globals: {
+        definePage: "readonly"
+      }
+    }
+  },
+  ...baseConfig,
+  ...vueConfig,
+  ...webConfig,
+  ...nodeConfig
+];

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

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="12" fill="#111827" />
+  <path
+    d="M20 16h24v8H28v20c0 6-4 10-10 10h-2v-8h2c2 0 2-1 2-3V16z"
+    fill="#22d3ee"
+  />
+</svg>

package/skills/jskit/references/patterns/app/minimal-foundation/example/gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+coverage/
+test-results/
+# Generated by vue-router/vite on the first dev or build scan.
+src/typed-router.d.ts
+.env
+.env.*
+!.env.example