Surface: pulse integrity, minimal surface, vitals as lineage

.dockerignore

@@ -1,7 +1,4 @@
 frontend/node_modules
 workspace/
 .env
-.venv
-*.db
-*.json
-*.xml
+frontend/node_modules

.env.example

@@ -0,0 +1,2 @@
+# Your backend URL
+STATIC_FILE_BASE_URL=http://localhost:8000

.github/CODEOWNERS

@@ -0,0 +1,19 @@
+# Stewardship Routing File
+#
+# This file exists solely because the underlying platform requires it.
+# It does NOT denote ownership, authority, hierarchy, or control.
+#
+# Its purpose is to slow changes to sensitive articulations
+# so that care, context, and collective reasoning can be preserved.
+#
+# Think of this as:
+# - a pause
+# - a breath
+# - a care-routing mechanism
+#
+# Legacy platform language is reinterpreted here as stewardship.
+
+# Situated articulations (held lightly, stewarded intentionally)
+otherpowers_governance/articulation/surface_v1.constellations.md @OtherPowers
+otherpowers_governance/articulation/README.md @OtherPowers
+

.gitignore

@@ -1,7 +1,5 @@
 trace_logs/
-
-docker/.stack.env
-docker/.stack.env.sh
+frontend/node_modules
 
 # Python-generated files
 __pycache__/
@@ -128,7 +126,6 @@ web_modules/
 .env.test.local
 .env.production.local
 .env.local
-.env.tool
 
 # parcel-bundler cache (https://parceljs.org/)
 .cache
@@ -196,7 +193,8 @@ data/events.db
 output/
 
 .vscode/
-.envrc
 
-# local only scripts
-start_tool_server.sh
+zz_misc/
+zz_*/
+
+otherpowers_governance/myth/

.python-version

@@ -0,0 +1 @@
+3.10

.templates/nextjs-shadcn/jest.config.js

@@ -0,0 +1,59 @@
+const nextJest = require('next/jest')
+const createJestConfig = nextJest({
+  // Provide the path to your Next.js app to load next.config.js and .env files
+  dir: './',
+})
+
+// Add any custom config to be passed to Jest
+const customJestConfig = {
+  // Add more setup options before each test is run
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
+
+  // if using TypeScript with a baseUrl set to the root directory then you need the below for alias' to work
+  moduleDirectories: ['node_modules', '<rootDir>/'],
+
+  // Handle module aliases
+  moduleNameMapper: {
+    '^@/(.*)$': '<rootDir>/src/$1',
+  },
+
+  // Test environment
+  testEnvironment: 'jest-environment-jsdom',
+
+  // Test patterns
+  testMatch: [
+    '<rootDir>/__tests__/**/*.{js,jsx,ts,tsx}',
+    '<rootDir>/src/**/__tests__/**/*.{js,jsx,ts,tsx}',
+    '<rootDir>/src/**/*.{test,spec}.{js,jsx,ts,tsx}'
+  ],
+
+  // Coverage configuration
+  collectCoverageFrom: [
+    'src/**/*.{js,jsx,ts,tsx}',
+    '!src/**/*.d.ts',
+    '!src/**/index.{js,jsx,ts,tsx}',
+  ],
+
+  // Transform configuration
+  transform: {
+    '^.+\\.(js|jsx|ts|tsx)$': ['babel-jest', { presets: ['next/babel'] }],
+  },
+
+  // Module file extensions
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
+
+  // Ignore patterns
+  testPathIgnorePatterns: [
+    '<rootDir>/.next/',
+    '<rootDir>/node_modules/',
+  ],
+
+  // Transform ignore patterns
+  transformIgnorePatterns: [
+    '/node_modules/',
+    '^.+\\.module\\.(css|sass|scss)$',
+  ],
+}
+
+// createJestConfig is exported this way to ensure that next/jest can load the Next.js config which is async
+module.exports = createJestConfig(customJestConfig)

.templates/nextjs-shadcn/jest.setup.js

@@ -0,0 +1,58 @@
+// Optional: configure or set up a testing framework before each test.
+// If you delete this file, remove `setupFilesAfterEnv` from `jest.config.js`
+// Used for **tests**/testing-library.js
+// Learn more: https://github.com/testing-library/jest-dom
+// import '@testing-library/jest-dom'
+
+// Add global polyfills for Node.js environment
+global.TextEncoder = require('util').TextEncoder;
+global.TextDecoder = require('util').TextDecoder;
+
+// Add MessagePort and MessageChannel polyfills (required for undici)
+if (typeof global.MessagePort === 'undefined') {
+  const { MessagePort, MessageChannel } = require('worker_threads');
+  global.MessagePort = MessagePort;
+  global.MessageChannel = MessageChannel;
+}
+
+// Add ReadableStream polyfill (required for undici)
+if (typeof global.ReadableStream === 'undefined') {
+  const { ReadableStream } = require('stream/web');
+  global.ReadableStream = ReadableStream;
+}
+
+// Add WritableStream polyfill (often needed alongside ReadableStream)
+if (typeof global.WritableStream === 'undefined') {
+  const { WritableStream } = require('stream/web');
+  global.WritableStream = WritableStream;
+}
+
+// Add TransformStream polyfill
+if (typeof global.TransformStream === 'undefined') {
+  const { TransformStream } = require('stream/web');
+  global.TransformStream = TransformStream;
+}
+
+// Add polyfill for Request API
+if (typeof global.Request === 'undefined') {
+  const { Request } = require('undici');
+  global.Request = Request;
+}
+
+// Add polyfill for Response API (often needed alongside Request)
+if (typeof global.Response === 'undefined') {
+  const { Response } = require('undici');
+  global.Response = Response;
+}
+
+// Add polyfill for fetch API (if not already available)
+if (typeof global.fetch === 'undefined') {
+  const { fetch } = require('undici');
+  global.fetch = fetch;
+}
+
+// Add Headers polyfill (often needed with fetch)
+if (typeof global.Headers === 'undefined') {
+  const { Headers } = require('undici');
+  global.Headers = Headers;
+}

.templates/nextjs-shadcn/next.config.js

@@ -1,8 +1,6 @@
 /** @type {import('next').NextConfig} */
 const nextConfig = {
-  // Use different output dir ONLY for local production builds
-  distDir: process.env.BUILD_DIR || '.next',
-
+  serverExternalPackages: ['pdf-parse'],
   images: {
     unoptimized: true,
     domains: [
@@ -39,7 +37,10 @@ const nextConfig = {
   },
   eslint: {
     ignoreDuringBuilds: true,
+    },
+    watchOptions: {
+      ignored: ['**/node_modules/**', '**/.git/**'],
   },
 };
 
-module.exports = nextConfig;
+module.exports = nextConfig;

.templates/nextjs-shadcn/package.json

@@ -4,33 +4,47 @@
   "private": true,
   "scripts": {
     "dev": "next dev -H 0.0.0.0 --turbopack",
-    "build": "next build",
+    "build": "bun run db:generate && next build",
     "start": "next start -H 0.0.0.0",
-    "build:local": "BUILD_DIR=.next-build next build",
+    "db:generate": "bunx prisma generate || echo 'Prisma not configured, skipping...'",
+    "db:push": "bunx prisma db push || echo 'Prisma not configured'",
+    "db:migrate": "bunx prisma migrate dev || echo 'Prisma not configured'",
     "lint": "bunx biome lint --write && bunx tsc --noEmit",
-    "format": "bunx biome format --write"
+    "format": "bunx biome format --write",
+    "test": "jest",
+    "postinstall": "bun run db:generate"
   },
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.3",
+    "@types/supertest": "^6.0.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "dayjs": "^1.11.13",
+    "jest": "^30.0.2",
+    "lodash": "^4.17.21",
     "lucide-react": "^0.475.0",
     "next": "^15.3.2",
+    "pdf-parse": "^1.1.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "supertest": "^7.1.1",
     "tailwind-merge": "^3.3.0",
-    "tailwindcss-animate": "^1.0.7"
+    "tailwindcss-animate": "^1.0.7",
+    "vercel": "^44.2.5"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@eslint/eslintrc": "^3.3.1",
+    "@types/bcryptjs": "^3.0.0",
     "@types/node": "^20.17.50",
     "@types/react": "^18.3.22",
     "@types/react-dom": "^18.3.7",
     "eslint": "^9.27.0",
     "eslint-config-next": "15.1.7",
+    "jest-environment-jsdom": "^30.0.2",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "undici": "^7.10.0"
   }
 }