@lucern/config 0.3.0-alpha.0

package/README.md

@@ -0,0 +1,69 @@
+# @lucern/config
+
+Shared Lucern configuration presets for TypeScript, Vitest, and Biome.
+
+This package mirrors the current repository toolchain. The repo lint baseline is Biome today, so there is no shared ESLint preset in this release.
+
+## TypeScript
+
+Extend the closest matching preset from your package `tsconfig.json`.
+
+```json
+{
+  "extends": "@lucern/config/typescript/base",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}
+```
+
+Available presets:
+
+- `@lucern/config/typescript/base`
+- `@lucern/config/typescript/node`
+- `@lucern/config/typescript/convex`
+- `@lucern/config/typescript/nextjs`
+
+Add package-local `paths`, `include`, and `exclude` entries in the consumer config. Those settings stay relative to the consuming package, not the shared preset.
+
+## Vitest
+
+Import the preset that matches the suite you are running and merge in package-local overrides.
+
+```ts
+import { defineConfig, mergeConfig } from "vitest/config";
+import baseConfig from "@lucern/config/vitest/base";
+
+export default mergeConfig(
+  baseConfig,
+  defineConfig({
+    test: {
+      include: ["tests/**/*.test.ts"]
+    }
+  })
+);
+```
+
+Available presets:
+
+- `@lucern/config/vitest/base`
+- `@lucern/config/vitest/convex`
+- `@lucern/config/vitest/regression`
+- `@lucern/config/vitest/smoke`
+
+The Lucern Vitest presets resolve monorepo aliases from `process.cwd()`, so invoke Vitest from the repository root or a workspace command that runs with the repo root as the working directory.
+
+## Biome
+
+Point your `biome.jsonc` `extends` array at the published preset.
+
+```jsonc
+{
+  "extends": ["@lucern/config/biome/base"]
+}
+```
+
+The shared Biome preset mirrors the current repository baseline, including the `ultracite` extension. Consumers should keep their own file globs or rule overrides alongside the shared preset when they need package-specific behavior.

package/biome/base.jsonc

@@ -0,0 +1,69 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "extends": ["ultracite"],
+  "files": {
+    "includes": [
+      "**/*",
+      "!**/.next",
+      "!**/.vercel",
+      "!**/coverage",
+      "!**/dist",
+      "!**/node_modules",
+      "!**/.turbo",
+      "!backups",
+      "!convex/_generated",
+      "!components/ui",
+      "!lib/utils.ts",
+      "!hooks/use-mobile.ts"
+    ]
+  },
+  "overrides": [
+    {
+      "includes": [
+        "convex/lucernMcp.ts",
+        "convex/qualification.ts",
+        "lib/agents/contextManager.ts",
+        "lib/agents/qualificationThematic.ts",
+        "modules/decision-state/src/convictionEngine.ts",
+        "modules/graph-intelligence/src/graphIntel/algorithms/cycleDetection.ts",
+        "modules/graph-intelligence/src/graphIntel/algorithms/tarjanSCC.ts",
+        "modules/graph-primitives/src/ontologyDefinitions.ts",
+        "modules/graph-search/src/epistemicQueries.ts",
+        "packages/reasoning-kernel/src/component/ontologyDefinitions.ts",
+        "app/lucern/admin/prompt-analytics/ExperimentControl.tsx",
+        "scripts/syncProdToDevLogical.ts"
+      ],
+      "linter": {
+        "rules": {
+          "style": {
+            "useFilenamingConvention": "off"
+          }
+        }
+      }
+    }
+  ],
+  "linter": {
+    "rules": {
+      "suspicious": {
+        "noExplicitAny": "off",
+        "noUnknownAtRules": "off",
+        "noConsole": "off",
+        "noBitwiseOperators": "off"
+      },
+      "style": {
+        "noMagicNumbers": "off",
+        "noNestedTernary": "off"
+      },
+      "nursery": {
+        "noUnnecessaryConditions": "off"
+      },
+      "complexity": {
+        "noExcessiveCognitiveComplexity": "off",
+        "useSimplifiedLogicExpression": "off"
+      },
+      "a11y": {
+        "noSvgWithoutTitle": "off"
+      }
+    }
+  }
+}

package/biome/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@lucern/config-biome",
+  "private": true
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@lucern/config",
+  "version": "0.3.0-alpha.0",
+  "description": "Shared Lucern TypeScript, Vitest, and Biome configuration presets",
+  "type": "module",
+  "files": [
+    "README.md",
+    "biome",
+    "typescript",
+    "vitest"
+  ],
+  "exports": {
+    "./typescript/base": "./typescript/base.json",
+    "./typescript/node": "./typescript/node.json",
+    "./typescript/convex": "./typescript/convex.json",
+    "./typescript/nextjs": "./typescript/nextjs.json",
+    "./vitest/base": "./vitest/base.ts",
+    "./vitest/convex": "./vitest/convex.ts",
+    "./vitest/regression": "./vitest/regression.ts",
+    "./vitest/smoke": "./vitest/smoke.ts",
+    "./biome/base": "./biome/base.jsonc"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}

package/typescript/base.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "exclude": ["node_modules", "dist", ".turbo"]
+}

package/typescript/convex.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./node.json",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowJs": false
+  }
+}

package/typescript/nextjs.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "target": "ESNext",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "preserve",
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  }
+}

package/typescript/node.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["node"]
+  }
+}

package/typescript/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@lucern/config-typescript",
+  "private": true
+}

package/vitest/base.ts

@@ -0,0 +1,177 @@
+import path from "node:path";
+import { defineConfig } from "vitest/config";
+
+const repoRoot = process.cwd();
+
+const testConfig = {
+  environment: "jsdom",
+  globals: true,
+  setupFiles: ["./tests/unit/setup.ts"],
+  include: [
+    "tests/unit/**/*.test.ts",
+    "tests/integration/**/*.test.ts",
+    "apps/mcp-server/tests/**/*.test.ts",
+  ],
+  exclude: [
+    "tests/unit/convex/*.test.ts",
+    "tests/unit/integration/*.test.ts",
+  ],
+  environmentMatchGlobs: [["tests/integration/**/*.test.ts", "node"]],
+  coverage: {
+    provider: "v8",
+    reporter: ["text", "json", "html"],
+    include: [
+      "lib/ai/tools/**/*.ts",
+      "convex/epistemic*.ts",
+      "convex/lib/**/*.ts",
+      "convex/worktrees.ts",
+      "convex/contradictions.ts",
+      "convex/topics.ts",
+      "packages/sdk/src/**/*.ts",
+      "packages/mcp/src/**/*.ts",
+      "apps/mcp-server/src/handlers/**/*.ts",
+    ],
+    exclude: ["**/*.test.ts", "**/*.d.ts", "**/node_modules/**"],
+  },
+  testTimeout: 30_000,
+};
+
+export default defineConfig({
+  esbuild: {
+    jsxInject: `import React from "react"`,
+  },
+  test: testConfig as any,
+  resolve: {
+    alias: [
+      {
+        find: /^@lucern\/contracts\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./packages/contracts/src/$1"),
+      },
+      {
+        find: "@lucern/contracts",
+        replacement: path.resolve(repoRoot, "./packages/contracts/src/index.ts"),
+      },
+      {
+        find: /^@\/lucern\/contracts\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./packages/contracts/src/$1"),
+      },
+      {
+        find: "@lucern/reasoning-kernel/convex.config",
+        replacement: path.resolve(
+          repoRoot,
+          "./packages/reasoning-kernel/convex.config.ts"
+        ),
+      },
+      {
+        find: "@lucern/reasoning-kernel/runtime.config",
+        replacement: path.resolve(
+          repoRoot,
+          "./packages/reasoning-kernel/convex.config.ts"
+        ),
+      },
+      {
+        find: /^@lucern\/reasoning-kernel\/_generated\/(api|component|dataModel|server)(?:\.js)?$/,
+        replacement: path.resolve(
+          repoRoot,
+          "./packages/reasoning-kernel/src/adapters/_generated/$1.ts"
+        ),
+      },
+      {
+        find: "@lucern/reasoning-kernel",
+        replacement: path.resolve(
+          repoRoot,
+          "./packages/reasoning-kernel/src/index.ts"
+        ),
+      },
+      {
+        find: /^@lucern\/reasoning-kernel\/([A-Za-z0-9_-]+)$/,
+        replacement: path.resolve(
+          repoRoot,
+          "./packages/reasoning-kernel/src/public/$1.ts"
+        ),
+      },
+      {
+        find: /^@lucern\/server-core\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./packages/server-core/src/$1"),
+      },
+      {
+        find: "@lucern/server-core",
+        replacement: path.resolve(repoRoot, "./packages/server-core/src/index.ts"),
+      },
+      {
+        find: /^@lucern\/testing\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./packages/testing/src/$1"),
+      },
+      {
+        find: "@lucern/testing",
+        replacement: path.resolve(repoRoot, "./packages/testing/src/index.ts"),
+      },
+      {
+        find: /^@lucern\/events\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./packages/events/src/$1"),
+      },
+      {
+        find: "@lucern/events",
+        replacement: path.resolve(repoRoot, "./packages/events/src/index.ts"),
+      },
+      {
+        find: "@lucern/identity/convex.config",
+        replacement: path.resolve(
+          repoRoot,
+          "./packages/identity/src/component/convex.config.ts"
+        ),
+      },
+      {
+        find: /^@lucern\/identity\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./packages/identity/src/$1"),
+      },
+      {
+        find: "@lucern/identity",
+        replacement: path.resolve(repoRoot, "./packages/identity/src/index.ts"),
+      },
+      {
+        find: "@lucern/react/surfacePrimitives",
+        replacement: path.resolve(
+          repoRoot,
+          "./packages/sdk-react/src/components/surfacePrimitives.tsx"
+        ),
+      },
+      {
+        find: "@lucern/react",
+        replacement: path.resolve(repoRoot, "./packages/sdk-react/src/index.ts"),
+      },
+      {
+        find: /^@lucern\/sdk\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./packages/sdk/src/$1"),
+      },
+      {
+        find: "@lucern/sdk/realtime/refs",
+        replacement: path.resolve(repoRoot, "./packages/sdk/src/realtime/refs.ts"),
+      },
+      {
+        find: "@lucern/sdk/realtime",
+        replacement: path.resolve(repoRoot, "./packages/sdk/src/realtime/index.ts"),
+      },
+      {
+        find: "@lucern/mcp/runtime",
+        replacement: path.resolve(repoRoot, "./packages/mcp/src/runtime.ts"),
+      },
+      {
+        find: "@lucern/mcp/gateway",
+        replacement: path.resolve(repoRoot, "./packages/mcp/src/gateway.ts"),
+      },
+      {
+        find: "@lucern/mcp",
+        replacement: path.resolve(repoRoot, "./packages/mcp/src/index.ts"),
+      },
+      {
+        find: "@lucern/sdk",
+        replacement: path.resolve(repoRoot, "./packages/sdk/src/index.ts"),
+      },
+      {
+        find: /^@\/(.*)$/,
+        replacement: path.resolve(repoRoot, "./$1"),
+      },
+    ],
+  },
+});

package/vitest/convex.ts

@@ -0,0 +1,49 @@
+import path from "node:path";
+import { defineConfig } from "vitest/config";
+import { lucernKernelAliasPlugin } from "./kernelAliasPlugin";
+
+const repoRoot = process.cwd();
+
+export default defineConfig({
+  plugins: [lucernKernelAliasPlugin(repoRoot)],
+  test: {
+    environment: "node",
+    globals: true,
+    include: [
+      "tests/unit/convex/**/*.test.ts",
+      "tests/unit/integration/**/*.test.ts",
+    ],
+    testTimeout: 30_000,
+    alias: {
+      "convex/server": path.resolve(repoRoot, "./tests/mocks/convex-server.ts"),
+      "convex/values": path.resolve(repoRoot, "./tests/mocks/convex-values.ts"),
+      "@lucern/identity": path.resolve(repoRoot, "./packages/identity/src/index.ts"),
+      "@lucern/identity/component/schema": path.resolve(
+        repoRoot,
+        "./packages/identity/src/component/schema.ts"
+      ),
+      "@lucern/identity/convex.config": path.resolve(
+        repoRoot,
+        "./packages/identity/src/component/convex.config.ts"
+      ),
+      "@lucern/react": path.resolve(repoRoot, "./packages/sdk-react/src/index.ts"),
+      "@lucern/react/surfacePrimitives": path.resolve(
+        repoRoot,
+        "./packages/sdk-react/src/components/surfacePrimitives.tsx"
+      ),
+    },
+    coverage: {
+      provider: "v8",
+      include: [
+        "convex/**/*.ts",
+        "packages/reasoning-kernel/src/adapters/**/*.ts",
+      ],
+      exclude: ["**/*.test.ts", "**/*.d.ts", "convex/_generated/**", "**/node_modules/**"],
+    },
+  },
+  resolve: {
+    alias: {
+      "@": path.resolve(repoRoot, "./"),
+    },
+  },
+});

package/vitest/kernelAliasPlugin.ts

@@ -0,0 +1,54 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+
+const KERNEL_PACKAGE = "@lucern/reasoning-kernel";
+const PUBLIC_SUBPATH_ROOT = "packages/reasoning-kernel/src/public";
+const GENERATED_SUBPATH_ROOT = "packages/reasoning-kernel/src/adapters/_generated";
+const CONVEX_CONFIG_PATH = "packages/reasoning-kernel/convex.config.ts";
+
+function resolveKernelSubpath(rootDir: string, subpath: string): string | null {
+  const cleanSubpath = subpath.replace(/\.m?js$/, "");
+
+  if (cleanSubpath === "convex.config" || cleanSubpath === "runtime.config") {
+    return path.resolve(rootDir, CONVEX_CONFIG_PATH);
+  }
+
+  if (cleanSubpath.startsWith("_generated/")) {
+    const generatedPath = path.resolve(
+      rootDir,
+      GENERATED_SUBPATH_ROOT,
+      `${cleanSubpath.slice("_generated/".length)}.ts`
+    );
+    return existsSync(generatedPath) ? generatedPath : null;
+  }
+
+  const filePath = path.resolve(rootDir, PUBLIC_SUBPATH_ROOT, `${cleanSubpath}.ts`);
+  if (existsSync(filePath)) {
+    return filePath;
+  }
+
+  const indexPath = path.resolve(rootDir, PUBLIC_SUBPATH_ROOT, cleanSubpath, "index.ts");
+  if (existsSync(indexPath)) {
+    return indexPath;
+  }
+
+  return null;
+}
+
+export function lucernKernelAliasPlugin(rootDir: string) {
+  return {
+    name: "lucern-kernel-alias",
+    enforce: "pre" as const,
+    resolveId(source: string) {
+      if (source === KERNEL_PACKAGE) {
+        return path.resolve(rootDir, "packages/reasoning-kernel/src/index.ts");
+      }
+
+      if (source.startsWith(`${KERNEL_PACKAGE}/`)) {
+        return resolveKernelSubpath(rootDir, source.slice(KERNEL_PACKAGE.length + 1));
+      }
+
+      return null;
+    },
+  };
+}

package/vitest/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@lucern/config-vitest",
+  "private": true
+}

package/vitest/regression.ts

@@ -0,0 +1,20 @@
+import path from "node:path";
+import { defineConfig } from "vitest/config";
+import { lucernKernelAliasPlugin } from "./kernelAliasPlugin";
+
+const repoRoot = process.cwd();
+
+export default defineConfig({
+  plugins: [lucernKernelAliasPlugin(repoRoot)],
+  test: {
+    environment: "node",
+    globals: true,
+    include: ["tests/regression/**/*.test.ts"],
+    testTimeout: 15_000,
+  },
+  resolve: {
+    alias: {
+      "@": path.resolve(repoRoot, "./"),
+    },
+  },
+});

package/vitest/smoke.ts

@@ -0,0 +1,18 @@
+import path from "node:path";
+import { defineConfig } from "vitest/config";
+
+const repoRoot = process.cwd();
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    include: ["tests/smoke/**/*.test.ts"],
+    testTimeout: 30_000,
+    setupFiles: [],
+  },
+  resolve: {
+    alias: {
+      "@": path.resolve(repoRoot, "."),
+    },
+  },
+});