@percepta/create 3.1.2 → 3.1.3

package/templates/webapp/deploy/ryvn/environments/percepta-test/installations/__APP_NAME__.env.percepta-test.serviceinstallation.yaml

@@ -54,8 +54,9 @@ spec:
 
     env:
       # Database — shared `demos` DB on the percepta-internal Postgres instance.
-      # Tables live under a per-app schema created by the infra PR. DATABASE_SCHEMA
-      # pins the connection search_path so Drizzle migrations + queries land there.
+      # Tables live under a per-app schema created by the __APP_NAME__-terraform
+      # Ryvn service. DATABASE_SCHEMA pins the connection search_path so Drizzle
+      # migrations + queries land there.
       - name: DATABASE_HOST
         valueFrom:
           secretKeyRef:
@@ -93,11 +94,11 @@ spec:
       value: https://__APP_NAME__.percepta-test.aitco.dev
     - key: BETTER_AUTH_URL
       value: https://__APP_NAME__.percepta-test.aitco.dev
-    # Import BETTER_AUTH_SECRET and ENCRYPTION_SECRET_KEY from
-    # deploy/ryvn/percepta-test.secrets.env in the Ryvn UI after the installation
-    # exists. Secret values are intentionally not declared in GitOps IaC.
+    # deploy:percepta-test patches BETTER_AUTH_SECRET and ENCRYPTION_SECRET_KEY
+    # from deploy/ryvn/percepta-test.secrets.env after the installation exists.
+    # Secret values are intentionally not declared in GitOps IaC.
 
-    # Inngest (shared percepta-test instance)
+    # Inngest (shared percepta-test platform service)
     - key: INNGEST_BASE_URL
       value: http://inngest.percepta-test.svc.cluster.local:8288
     - key: INNGEST_EVENT_KEY
@@ -109,10 +110,45 @@ spec:
     - key: INNGEST_SERVE_HOST
       value: http://__APP_NAME__-web-server.percepta-test.svc.cluster.local:3000/api/inngest
 
-    # OpenTelemetry
-    - key: OTEL_METRICS_EXPORTER_OTLP_ENDPOINT
+    # Observability (shared percepta-test OTEL collector + LGTM stack)
+    # Application logs are emitted to stdout and collected by the shared OTEL
+    # collector. Traces and metrics are exported over OTLP HTTP.
+    - key: OTEL_SERVICE_NAME
+      value: __APP_NAME__
+    - key: OTEL_RESOURCE_ATTRIBUTES
+      value: service.namespace=__REPO_NAME__,deployment.environment=percepta-test
+    - key: OTEL_TRACES_EXPORTER
+      value: otlp
+    - key: OTEL_METRICS_EXPORTER
+      value: otlp
+    - key: OTEL_LOGS_EXPORTER
+      value: none
+    - key: OTEL_EXPORTER_OTLP_PROTOCOL
+      value: http/protobuf
+    - key: OTEL_EXPORTER_OTLP_ENDPOINT
+      value: http://otel-collector-opentelemetry-collector.percepta-test.svc.cluster.local:4318
+    - key: OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
+      value: http://otel-collector-opentelemetry-collector.percepta-test.svc.cluster.local:4318/v1/traces
+    - key: OTEL_EXPORTER_OTLP_METRICS_ENDPOINT
       value: http://otel-collector-opentelemetry-collector.percepta-test.svc.cluster.local:4318/v1/metrics
-    - key: OTEL_EXPORT_INTERVAL_MS
+    - key: OTEL_METRIC_EXPORT_INTERVAL
       value: "60000"
+    - key: NEXT_PUBLIC_FARO_APP_NAME
+      value: __APP_NAME__
+    - key: NEXT_PUBLIC_FARO_APP_VERSION
+      value: "0.1.0"
+    - key: NEXT_PUBLIC_FARO_APP_ENVIRONMENT
+      value: percepta-test
     - key: LOG_LEVEL
       value: debug
+
+    # Langfuse (shared percepta-test platform service). Project keys come from
+    # the demos-commons Ryvn variable group below.
+    - key: LANGFUSE_BASE_URL
+      value: https://langfuse.percepta-test.aitco.dev
+
+    # LLM provider (shared demo Anthropic key comes from demos-commons).
+    - key: LLM_PROVIDER
+      value: anthropic
+  variableGroups:
+    - name: demos-commons

package/templates/webapp/env.example.template

@@ -19,9 +19,9 @@ BETTER_AUTH_URL=http://localhost:3000
 ENCRYPTION_SECRET_KEY=generate-with-node-e-console-log-require-crypto-randomBytes-16-toString-hex
 
 # Inngest (Background Jobs)
-# INNGEST_BASE_URL=
+INNGEST_BASE_URL=http://localhost:8288
 # INNGEST_SIGNING_KEY=
-# INNGEST_EVENT_KEY=
+INNGEST_EVENT_KEY=local
 
 # Grafana Faro (client-side observability)
 # Leave NEXT_PUBLIC_FARO_COLLECTOR_URL empty to disable in local development.
@@ -36,6 +36,24 @@ NEXT_PUBLIC_FARO_APP_ENVIRONMENT=development
 # LANGFUSE_PUBLIC_KEY=
 # LANGFUSE_SECRET_KEY=
 
+# LLM providers
+# Deployed percepta-test apps inherit ANTHROPIC_API_KEY from the demos-commons
+# Ryvn variable group. For local LLM testing, set ANTHROPIC_API_KEY once in your
+# shell profile or ~/.config/percepta/create.env.
+# ANTHROPIC_API_KEY=
+# OPENAI_API_KEY=
+# LLM_PROVIDER=anthropic
+# LLM_MODEL=claude-sonnet-4-5-20250929
+
+# OpenTelemetry (server-side traces and metrics)
+# OTEL_SERVICE_NAME=__APP_NAME__
+# OTEL_TRACES_EXPORTER=otlp
+# OTEL_METRICS_EXPORTER=otlp
+# OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
+# OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
+# OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:4318/v1/traces
+# OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://localhost:4318/v1/metrics
+
 # AWS (uses default credential chain in development)
 # AWS_REGION=us-east-1
 # AWS_ACCESS_KEY_ID=

package/templates/webapp/eslint.config.mjs

@@ -57,4 +57,10 @@ export default [
       "n/no-process-env": "off",
     },
   },
+  {
+    files: ["scripts/with-local-env.ts"],
+    rules: {
+      "n/no-process-env": "off",
+    },
+  },
 ];

package/templates/webapp/next.config.ts

@@ -1,8 +1,17 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import type { NextConfig } from "next";
 
+const appDir = path.dirname(fileURLToPath(import.meta.url));
+const monorepoRoot = path.resolve(appDir, "../..");
+
 const nextConfig: NextConfig = {
   // Enable standalone output for Docker:
   output: "standalone",
+  outputFileTracingRoot: monorepoRoot,
+  turbopack: {
+    root: monorepoRoot,
+  },
 };
 
 export default nextConfig;

package/templates/webapp/package.json.template

@@ -6,13 +6,14 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "dev": "next dev --turbopack",
+    "dev": "tsx ./scripts/with-local-env.ts next dev --turbopack",
     "build": "next build",
     "start": "next start",
     "lint": "eslint .",
     "setup": "pnpm docker:up && pnpm db:setup-and-migrate && pnpm db:seed",
     "docker:up": "docker compose up -d",
     "docker:down": "docker compose down",
+    "inngest:dev": "pnpm dlx inngest-cli@latest dev -u http://localhost:3000/api/inngest",
     "db:generate": "drizzle-kit generate",
     "db:migrate": "tsx ./scripts/migrate.ts",
     "db:setup": "tsx ./scripts/setup-database.ts",
@@ -21,11 +22,13 @@
     "db:studio": "drizzle-kit studio",
     "db:create-user": "tsx ./scripts/create-user.ts",
     "db:seed": "tsx ./scripts/seed.ts",
-    "deploy:percepta-test": "tsx ./scripts/open-ryvn-deploy-pr.ts",
+    "deploy:percepta-test": "tsx ./scripts/deploy-percepta-test.ts",
+    "deploy:percepta-test:pr": "tsx ./scripts/open-ryvn-deploy-pr.ts",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
+    "@ai-sdk/anthropic": "^2.0.23",
     "@ai-sdk/openai": "^2.0.23",
     "@aws-sdk/client-s3": "^3.888.0",
     "@aws-sdk/client-secrets-manager": "^3.914.0",
@@ -47,6 +50,7 @@
     "@next/env": "^15.3.5",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/auto-instrumentations-node": "^0.62.1",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.203.0",
     "@opentelemetry/sdk-node": "^0.203.0",
     "@percepta/design": "0.3.2",
     "@percepta/logger": "0.0.6",