@jskit-ai/agent-docs 0.1.149 → 0.1.150

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.150`
+- 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.150`
+- 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.149`
+- 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.178`
+- 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.175`
+- 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.146`
+- 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.23`
+- 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.189`
+- 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.120`
+- 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.176`
+- 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.175`
+- 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.113`
+- 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.175`
+- 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.150`
+- 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.182`
+- 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.182`
+- 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.196`
+- 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.191`
+- 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.156`
+- 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.157`
+- 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,105 @@
+---
+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.
+- 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,17 @@
+# 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.
+
+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,2 @@
+release: npm run db:migrate
+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

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

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <title>Reading Room</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.js"></script>
+  </body>
+</html>

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

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}