@jskit-ai/create-app 0.1.3 → 0.1.6

package/templates/base-shell/scripts/link-local-jskit-packages.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# Re-link installed @jskit-ai packages in node_modules to a local jskit-ai monorepo checkout.
+# Run this AFTER `npm install` when you want live local development without publishing packages.
+#
+# Usage:
+#   npm run link:local:jskit
+#   JSKIT_REPO_ROOT=/abs/path/to/jskit-ai npm run link:local:jskit
+set -euo pipefail
+
+APP_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SCOPE_DIR="$APP_ROOT/node_modules/@jskit-ai"
+
+is_valid_jskit_repo_root() {
+  local candidate_root="$1"
+  [[ -d "$candidate_root/packages" && -d "$candidate_root/packages/kernel" && -d "$candidate_root/tooling" ]]
+}
+
+resolve_local_repo_root() {
+  if [[ -n "${JSKIT_REPO_ROOT:-}" ]]; then
+    echo "$JSKIT_REPO_ROOT"
+    return 0
+  fi
+
+  local current_dir="$APP_ROOT"
+  while true; do
+    if is_valid_jskit_repo_root "$current_dir"; then
+      echo "$current_dir"
+      return 0
+    fi
+    if [[ "$current_dir" == "/" ]]; then
+      return 1
+    fi
+    current_dir="$(dirname "$current_dir")"
+  done
+}
+
+JSKIT_REPO_ROOT="$(resolve_local_repo_root || true)"
+
+if [[ ! -d "$SCOPE_DIR" ]]; then
+  echo "[link-local] @jskit-ai scope not found at $SCOPE_DIR (run npm install first)." >&2
+  exit 1
+fi
+
+if [[ -z "$JSKIT_REPO_ROOT" ]]; then
+  echo "[link-local] no JSKIT repository found." >&2
+  echo "[link-local] set JSKIT_REPO_ROOT to a local jskit-ai checkout path." >&2
+  exit 1
+fi
+
+if ! is_valid_jskit_repo_root "$JSKIT_REPO_ROOT"; then
+  echo "[link-local] JSKIT_REPO_ROOT is not a valid jskit-ai checkout: $JSKIT_REPO_ROOT" >&2
+  exit 1
+fi
+
+resolve_source_dir() {
+  local package_dir_name="$1"
+  case "$package_dir_name" in
+    config-eslint|create-app|jskit-cli|jskit-catalog)
+      echo "$JSKIT_REPO_ROOT/tooling/$package_dir_name"
+      ;;
+    *)
+      echo "$JSKIT_REPO_ROOT/packages/$package_dir_name"
+      ;;
+  esac
+}
+
+linked_count=0
+skipped_count=0
+
+for installed_path in "$SCOPE_DIR"/*; do
+  if [[ ! -e "$installed_path" && ! -L "$installed_path" ]]; then
+    continue
+  fi
+
+  package_dir_name="$(basename "$installed_path")"
+  source_dir="$(resolve_source_dir "$package_dir_name")"
+
+  if [[ ! -f "$source_dir/package.json" ]]; then
+    echo "[link-local] skip @jskit-ai/$package_dir_name (no local source at $source_dir)"
+    skipped_count=$((skipped_count + 1))
+    continue
+  fi
+
+  rm -rf "$installed_path"
+  ln -s "$source_dir" "$installed_path"
+  echo "[link-local] linked @jskit-ai/$package_dir_name -> $source_dir"
+  linked_count=$((linked_count + 1))
+done
+
+echo "[link-local] done. linked=$linked_count skipped=$skipped_count"

package/templates/base-shell/scripts/update-jskit-packages.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+APP_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PACKAGE_JSON_PATH="$APP_ROOT/package.json"
+JSKIT_REGISTRY="${JSKIT_REGISTRY:-}"
+
+if [[ ! -f "$PACKAGE_JSON_PATH" ]]; then
+  echo "[jskit:update] package.json not found: $PACKAGE_JSON_PATH" >&2
+  exit 1
+fi
+
+readarray -t runtime_packages < <(
+  node -e '
+    const fs = require("node:fs");
+    const packageJson = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
+    const dependencies = packageJson?.dependencies || {};
+    const names = Object.keys(dependencies).filter((name) => name.startsWith("@jskit-ai/")).sort();
+    for (const name of names) {
+      process.stdout.write(`${name}\n`);
+    }
+  ' "$PACKAGE_JSON_PATH"
+)
+
+readarray -t dev_packages < <(
+  node -e '
+    const fs = require("node:fs");
+    const packageJson = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
+    const dependencies = packageJson?.devDependencies || {};
+    const names = Object.keys(dependencies).filter((name) => name.startsWith("@jskit-ai/")).sort();
+    for (const name of names) {
+      process.stdout.write(`${name}\n`);
+    }
+  ' "$PACKAGE_JSON_PATH"
+)
+
+runtime_specs=()
+for package_name in "${runtime_packages[@]}"; do
+  runtime_specs+=("${package_name}@latest")
+done
+
+dev_specs=()
+for package_name in "${dev_packages[@]}"; do
+  dev_specs+=("${package_name}@latest")
+done
+
+registry_args=()
+if [[ -n "$JSKIT_REGISTRY" ]]; then
+  registry_args+=(--registry "$JSKIT_REGISTRY")
+fi
+
+if (( ${#runtime_specs[@]} == 0 && ${#dev_specs[@]} == 0 )); then
+  echo "[jskit:update] no @jskit-ai packages found in dependencies."
+  exit 0
+fi
+
+if (( ${#runtime_specs[@]} > 0 )); then
+  echo "[jskit:update] updating runtime packages: ${runtime_specs[*]}"
+  (
+    cd "$APP_ROOT"
+    npm install --save-exact "${registry_args[@]}" "${runtime_specs[@]}"
+  )
+fi
+
+if (( ${#dev_specs[@]} > 0 )); then
+  echo "[jskit:update] updating dev packages: ${dev_specs[*]}"
+  (
+    cd "$APP_ROOT"
+    npm install --save-dev --save-exact "${registry_args[@]}" "${dev_specs[@]}"
+  )
+fi
+
+echo "[jskit:update] done."

package/templates/base-shell/scripts/verdaccio/config.yaml

@@ -0,0 +1,26 @@
+storage: ./storage
+
+auth:
+  htpasswd:
+    file: ./htpasswd
+
+uplinks:
+  npmjs:
+    url: https://registry.npmjs.org/
+
+packages:
+  "@jskit-ai/*":
+    access: $all
+    publish: $all
+    unpublish: $all
+
+  "**":
+    access: $all
+    publish: $all
+    unpublish: $all
+    proxy: npmjs
+
+log:
+  - type: stdout
+    format: pretty
+    level: http

package/templates/base-shell/scripts/verdaccio-reset-and-publish-packages.sh

@@ -0,0 +1,314 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DEFAULT_VERDACCIO_CONFIG="$ROOT_DIR/scripts/verdaccio/config.yaml"
+if [[ -f "$DEFAULT_VERDACCIO_CONFIG" ]]; then
+  VERDACCIO_CONFIG="${VERDACCIO_CONFIG:-$DEFAULT_VERDACCIO_CONFIG}"
+else
+  VERDACCIO_CONFIG="${VERDACCIO_CONFIG:-$HOME/.config/verdaccio/config.yaml}"
+fi
+VERDACCIO_LISTEN="${VERDACCIO_LISTEN:-127.0.0.1:4873}"
+VERDACCIO_REGISTRY="${VERDACCIO_REGISTRY:-http://$VERDACCIO_LISTEN}"
+VERDACCIO_REGISTRY="${VERDACCIO_REGISTRY%/}"
+VERDACCIO_LOG_FILE="${VERDACCIO_LOG_FILE:-/tmp/verdaccio-jskit.log}"
+VERDACCIO_PID_FILE="${VERDACCIO_PID_FILE:-/tmp/verdaccio-jskit.pid}"
+PUBLISH_CONCURRENCY="${PUBLISH_CONCURRENCY:-10}"
+JSKIT_REPO_ROOT="${JSKIT_REPO_ROOT:-}"
+PACKAGES_DIR="${PACKAGES_DIR:-}"
+TOOLING_DIR="${TOOLING_DIR:-}"
+
+is_valid_jskit_repo_root() {
+  local candidate_root="$1"
+  [[ -d "$candidate_root/packages" && -d "$candidate_root/packages/kernel" && -d "$candidate_root/tooling" ]]
+}
+
+resolve_jskit_repo_root() {
+  if [[ -n "$JSKIT_REPO_ROOT" ]]; then
+    echo "$JSKIT_REPO_ROOT"
+    return 0
+  fi
+
+  local current_dir="$ROOT_DIR"
+  while true; do
+    if is_valid_jskit_repo_root "$current_dir"; then
+      echo "$current_dir"
+      return 0
+    fi
+    if [[ "$current_dir" == "/" ]]; then
+      return 1
+    fi
+    current_dir="$(dirname "$current_dir")"
+  done
+}
+
+configure_source_dirs() {
+  if [[ -z "$PACKAGES_DIR" || -z "$TOOLING_DIR" ]]; then
+    local detected_root
+    detected_root="$(resolve_jskit_repo_root || true)"
+    if [[ -n "$detected_root" ]]; then
+      JSKIT_REPO_ROOT="$detected_root"
+      if [[ -z "$PACKAGES_DIR" ]]; then
+        PACKAGES_DIR="$JSKIT_REPO_ROOT/packages"
+      fi
+      if [[ -z "$TOOLING_DIR" ]]; then
+        TOOLING_DIR="$JSKIT_REPO_ROOT/tooling"
+      fi
+    fi
+  fi
+
+  if [[ -z "$PACKAGES_DIR" ]]; then
+    echo "Packages directory not configured." >&2
+    echo "Set PACKAGES_DIR directly, or set JSKIT_REPO_ROOT to a local jskit-ai checkout." >&2
+    exit 1
+  fi
+
+  if [[ -z "$TOOLING_DIR" ]]; then
+    TOOLING_DIR="/dev/null"
+  fi
+}
+
+resolve_storage_dir() {
+  if [[ -n "${VERDACCIO_STORAGE_DIR:-}" ]]; then
+    echo "$VERDACCIO_STORAGE_DIR"
+    return
+  fi
+
+  if [[ -f "$VERDACCIO_CONFIG" ]]; then
+    local configured_storage=""
+    configured_storage="$(sed -nE 's/^[[:space:]]*storage:[[:space:]]*([^#]+).*$/\1/p' "$VERDACCIO_CONFIG" | head -n 1 | xargs || true)"
+    if [[ -n "$configured_storage" ]]; then
+      if [[ "$configured_storage" = /* ]]; then
+        echo "$configured_storage"
+      else
+        echo "$(cd "$(dirname "$VERDACCIO_CONFIG")" && pwd)/$configured_storage"
+      fi
+      return
+    fi
+  fi
+
+  echo "$HOME/.local/share/verdaccio/storage"
+}
+
+stop_verdaccio() {
+  local listen_port
+  listen_port="${VERDACCIO_LISTEN##*:}"
+
+  if [[ -f "$VERDACCIO_PID_FILE" ]]; then
+    local pid
+    pid="$(cat "$VERDACCIO_PID_FILE" || true)"
+    if [[ -n "${pid:-}" ]] && kill -0 "$pid" 2>/dev/null; then
+      kill "$pid" || true
+    fi
+    rm -f "$VERDACCIO_PID_FILE"
+  fi
+
+  if command -v lsof >/dev/null 2>&1; then
+    local listener_pids
+    listener_pids="$(lsof -tiTCP:"$listen_port" -sTCP:LISTEN 2>/dev/null || true)"
+    if [[ -n "$listener_pids" ]]; then
+      for pid in $listener_pids; do
+        if [[ "$pid" != "$$" ]]; then
+          kill "$pid" >/dev/null 2>&1 || true
+        fi
+      done
+    fi
+
+    local attempts=0
+    while lsof -tiTCP:"$listen_port" -sTCP:LISTEN >/dev/null 2>&1; do
+      attempts=$((attempts + 1))
+      if (( attempts > 20 )); then
+        break
+      fi
+      sleep 0.25
+    done
+
+    listener_pids="$(lsof -tiTCP:"$listen_port" -sTCP:LISTEN 2>/dev/null || true)"
+    if [[ -n "$listener_pids" ]]; then
+      for pid in $listener_pids; do
+        if [[ "$pid" != "$$" ]]; then
+          kill -9 "$pid" >/dev/null 2>&1 || true
+        fi
+      done
+    fi
+  fi
+}
+
+start_verdaccio() {
+  local cmd=(npx --yes verdaccio --listen "$VERDACCIO_LISTEN")
+  local config_dir
+  config_dir="$(pwd)"
+  if [[ -f "$VERDACCIO_CONFIG" ]]; then
+    cmd+=(--config "$VERDACCIO_CONFIG")
+    config_dir="$(cd "$(dirname "$VERDACCIO_CONFIG")" && pwd)"
+  fi
+
+  (
+    cd "$config_dir"
+    nohup "${cmd[@]}" >"$VERDACCIO_LOG_FILE" 2>&1 &
+  )
+
+  local attempts=0
+  until curl -fsS "$VERDACCIO_REGISTRY/-/ping" >/dev/null 2>&1; do
+    attempts=$((attempts + 1))
+    if (( attempts > 60 )); then
+      echo "Verdaccio did not become ready at $VERDACCIO_REGISTRY within 60s." >&2
+      echo "See log: $VERDACCIO_LOG_FILE" >&2
+      exit 1
+    fi
+    sleep 1
+  done
+
+  local listen_port
+  listen_port="${VERDACCIO_LISTEN##*:}"
+  local listener_pid
+  listener_pid="$(lsof -tiTCP:"$listen_port" -sTCP:LISTEN 2>/dev/null | head -n 1 || true)"
+  if [[ -n "$listener_pid" ]]; then
+    echo "$listener_pid" >"$VERDACCIO_PID_FILE"
+  fi
+}
+
+publish_packages() {
+  if [[ ! -d "$PACKAGES_DIR" ]]; then
+    echo "Packages directory not found: $PACKAGES_DIR" >&2
+    echo "Set PACKAGES_DIR to your monorepo packages path, or set JSKIT_REPO_ROOT." >&2
+    exit 1
+  fi
+
+  local dirs=()
+  if [[ -d "$TOOLING_DIR" ]]; then
+    while IFS= read -r dir; do
+      if [[ ! -f "$dir/package.json" ]]; then
+        continue
+      fi
+      local package_name
+      package_name="$(cd "$dir" && node -p "require('./package.json').name || ''" 2>/dev/null || true)"
+      if [[ "$package_name" == @jskit-ai/* ]]; then
+        dirs+=("$dir")
+      fi
+    done < <(find "$TOOLING_DIR" -mindepth 1 -maxdepth 1 -type d | sort)
+  fi
+  while IFS= read -r dir; do
+    dirs+=("$dir")
+  done < <(find "$PACKAGES_DIR" -mindepth 1 -maxdepth 1 -type d | sort)
+
+  if (( ${#dirs[@]} > 1 )); then
+    local deduped=()
+    local seen=":"
+    for dir in "${dirs[@]}"; do
+      if [[ "$seen" != *":$dir:"* ]]; then
+        deduped+=("$dir")
+        seen="${seen}${dir}:"
+      fi
+    done
+    dirs=("${deduped[@]}")
+  fi
+
+  if (( ${#dirs[@]} == 0 )); then
+    echo "No package directories found under $PACKAGES_DIR" >&2
+    exit 1
+  fi
+
+  local npm_userconfig
+  local registry_with_slash
+  local verdaccio_auth_token
+  npm_userconfig="$(mktemp)"
+  registry_with_slash="${VERDACCIO_REGISTRY%/}/"
+  verdaccio_auth_token="${VERDACCIO_AUTH_TOKEN:-dev-local-token}"
+  printf "@jskit-ai:registry=%s\nregistry=%s\n//%s/:_authToken=%s\n" \
+    "$registry_with_slash" \
+    "$registry_with_slash" \
+    "${VERDACCIO_LISTEN}" \
+    "$verdaccio_auth_token" >"$npm_userconfig"
+
+  if [[ ! "$PUBLISH_CONCURRENCY" =~ ^[0-9]+$ ]] || (( PUBLISH_CONCURRENCY < 1 )); then
+    echo "PUBLISH_CONCURRENCY must be a positive integer (got: $PUBLISH_CONCURRENCY)." >&2
+    exit 1
+  fi
+
+  echo "Publishing with concurrency=$PUBLISH_CONCURRENCY"
+
+  publish_one_package() {
+    local dir="$1"
+    local npm_userconfig="$2"
+    if [[ ! -f "$dir/package.json" ]]; then
+      return 0
+    fi
+
+    local package_name
+    local publish_dir
+    package_name="$(cd "$dir" && node -p "require('./package.json').name || ''")"
+    echo "Publishing $package_name from $dir"
+
+    publish_dir="$(mktemp -d)"
+    (
+      cd "$dir"
+      tar --exclude='./node_modules' -cf - .
+    ) | (
+      cd "$publish_dir"
+      tar -xf -
+    )
+    node -e 'const fs=require("node:fs");const p=process.argv[1];const j=JSON.parse(fs.readFileSync(p,"utf8"));delete j.private;fs.writeFileSync(p,`${JSON.stringify(j,null,2)}\n`);' "$publish_dir/package.json"
+    (
+      cd "$publish_dir"
+      npm publish \
+        --registry "$VERDACCIO_REGISTRY" \
+        --access public \
+        --workspaces=false \
+        --userconfig "$npm_userconfig"
+    )
+    rm -rf "$publish_dir"
+  }
+
+  local running_jobs=0
+  local publish_failed=0
+  for dir in "${dirs[@]}"; do
+    publish_one_package "$dir" "$npm_userconfig" &
+    running_jobs=$((running_jobs + 1))
+
+    if (( running_jobs >= PUBLISH_CONCURRENCY )); then
+      if ! wait -n; then
+        publish_failed=1
+      fi
+      running_jobs=$((running_jobs - 1))
+    fi
+  done
+
+  while (( running_jobs > 0 )); do
+    if ! wait -n; then
+      publish_failed=1
+    fi
+    running_jobs=$((running_jobs - 1))
+  done
+
+  if (( publish_failed != 0 )); then
+    echo "One or more package publishes failed." >&2
+    exit 1
+  fi
+
+  rm -f "$npm_userconfig"
+}
+
+main() {
+  configure_source_dirs
+
+  local storage_dir
+  storage_dir="$(resolve_storage_dir)"
+
+  echo "Stopping Verdaccio..."
+  stop_verdaccio
+
+  echo "Clearing Verdaccio storage: $storage_dir"
+  rm -rf "$storage_dir"
+  mkdir -p "$storage_dir"
+
+  echo "Starting Verdaccio at $VERDACCIO_REGISTRY..."
+  start_verdaccio
+
+  echo "Publishing packages from $PACKAGES_DIR and tooling in $TOOLING_DIR..."
+  publish_packages
+
+  echo "Done. Verdaccio is running at $VERDACCIO_REGISTRY"
+}
+
+main "$@"

package/templates/base-shell/server/lib/runtimeEnv.js

@@ -0,0 +1,45 @@
+import { createRequire } from "node:module";
+import { surfaceRuntime } from "./surfaceRuntime.js";
+
+const require = createRequire(import.meta.url);
+
+function toPort(value, fallback = 3000) {
+  const parsed = Number.parseInt(String(value || "").trim(), 10);
+  if (Number.isInteger(parsed) && parsed > 0) {
+    return parsed;
+  }
+  return fallback;
+}
+
+let envLoaded = false;
+
+function ensureRuntimeEnvLoaded() {
+  if (envLoaded) {
+    return;
+  }
+  try {
+    const dotenvModule = require("dotenv");
+    const loadDotEnv = dotenvModule?.config;
+    if (typeof loadDotEnv === "function") {
+      loadDotEnv();
+    }
+  } catch {
+    // dotenv is optional in base-shell; bundles can add it when needed.
+  }
+  envLoaded = true;
+}
+
+function resolveRuntimeEnv() {
+  ensureRuntimeEnvLoaded();
+  const serverSurface = surfaceRuntime.normalizeSurfaceMode(
+    process.env.JSKIT_SERVER_SURFACE || process.env.SERVER_SURFACE
+  );
+  return {
+    ...process.env,
+    SERVER_SURFACE: serverSurface,
+    PORT: toPort(process.env.PORT, 3000),
+    HOST: String(process.env.HOST || "").trim() || "0.0.0.0"
+  };
+}
+
+export { resolveRuntimeEnv };

package/templates/base-shell/server/lib/surfaceRuntime.js

@@ -0,0 +1,10 @@
+import { createSurfaceRuntime } from "@jskit-ai/kernel/shared/surface/runtime";
+import { config } from "../../config/public.js";
+
+const surfaceRuntime = createSurfaceRuntime({
+  allMode: config.surfaceModeAll,
+  surfaces: config.surfaceDefinitions,
+  defaultSurfaceId: config.surfaceDefaultId
+});
+
+export { surfaceRuntime };

package/templates/base-shell/server.js

@@ -0,0 +1,69 @@
+import Fastify from "fastify";
+import { TypeBoxValidatorCompiler } from "@fastify/type-provider-typebox";
+import { registerTypeBoxFormats } from "@jskit-ai/http-runtime/shared/validators/typeboxFormats";
+import { resolveRuntimeEnv } from "./server/lib/runtimeEnv.js";
+import path from "node:path";
+import {
+  registerSurfaceRequestConstraint,
+  resolveRuntimeProfileFromSurface,
+  tryCreateProviderRuntimeFromApp
+} from "@jskit-ai/kernel/server/platform";
+import { surfaceRuntime } from "./server/lib/surfaceRuntime.js";
+
+async function createServer() {
+  const app = Fastify({ logger: true });
+  registerTypeBoxFormats();
+  app.setValidatorCompiler(TypeBoxValidatorCompiler);
+
+  app.get("/api/health", async () => {
+    return {
+      ok: true,
+      app: "__APP_NAME__"
+    };
+  });
+  const runtimeEnv = resolveRuntimeEnv();
+  const appRoot = path.resolve(process.cwd());
+  const runtime = await tryCreateProviderRuntimeFromApp({
+    appRoot,
+    profile: resolveRuntimeProfileFromSurface({
+      surfaceRuntime,
+      serverSurface: runtimeEnv.SERVER_SURFACE,
+      defaultProfile: "app"
+    }),
+    env: runtimeEnv,
+    logger: app.log,
+    fastify: app
+  });
+
+  registerSurfaceRequestConstraint({
+    fastify: app,
+    surfaceRuntime,
+    serverSurface: runtimeEnv.SERVER_SURFACE,
+    globalUiPaths: runtime?.globalUiPaths || []
+  });
+
+  if (runtime) {
+    app.log.info(
+      {
+        routeCount: runtime.routeCount,
+        surface: surfaceRuntime.normalizeSurfaceMode(runtimeEnv.SERVER_SURFACE),
+        providerPackages: runtime.providerPackageOrder,
+        packageOrder: runtime.packageOrder
+      },
+      "Registered JSKIT provider server runtime."
+    );
+  }
+
+  return app;
+}
+
+async function startServer(options = {}) {
+  const runtimeEnv = resolveRuntimeEnv();
+  const port = Number(options?.port) || runtimeEnv.PORT;
+  const host = String(options?.host || "").trim() || runtimeEnv.HOST;
+  const app = await createServer();
+  await app.listen({ port, host });
+  return app;
+}
+
+export { createServer, startServer };

package/templates/base-shell/src/App.vue

@@ -0,0 +1,13 @@
+<template>
+  <v-app>
+    <v-main>
+      <v-container class="py-10 py-md-14">
+        <v-row justify="center">
+          <v-col cols="12" sm="11" md="10" lg="8" xl="7">
+            <RouterView />
+          </v-col>
+        </v-row>
+      </v-container>
+    </v-main>
+  </v-app>
+</template>