@arcote.tech/arc-cli 0.7.8 → 0.7.9

package/dist/index.js

@@ -25818,6 +25818,7 @@ __export(exports_init_server, {
   wrapDbAdapter: () => wrapDbAdapter,
   initServerTelemetry: () => initServerTelemetry
 });
+import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
@@ -26131,6 +26132,9 @@ function wrapDbAdapter(adapter, telemetry, dbSystem) {
 }
 function initServerTelemetry(config) {
   const telemetry = new ArcTelemetry({ ...config, environment: "server" });
+  if (telemetry.config.debug) {
+    diag.setLogger(new DiagConsoleLogger, DiagLogLevel.ALL);
+  }
   if (!telemetry.config.enabled) {
     return { telemetry, shutdown: async () => {} };
   }
@@ -26179,7 +26183,8 @@ function initServerTelemetry(config) {
       serviceName: config.serviceName,
       endpoint,
       sampleRate: telemetry.config.sampleRate,
-      mode: telemetry.config.mode
+      mode: telemetry.config.mode,
+      active: telemetry.active
     });
   }
   const shutdown = async () => {
@@ -35013,8 +35018,11 @@ var TAILWIND_INPUT_TEMPLATE = (rootRel) => `@import "tailwindcss";
 
 @source "${rootRel}/packages/*/*.{ts,tsx}";
 @source "${rootRel}/packages/*/src/**/*.{ts,tsx}";
-@source "${rootRel}/node_modules/@arcote.tech/platform/src/**/*.{ts,tsx}";
-@source "${rootRel}/node_modules/@arcote.tech/arc-ds/src/**/*.{ts,tsx}";
+/* Skanuj wszystkie framework packages \u2014 fragmenty (arc-chat, arc-ai-voice\u2026)
+   wnosz\u0105 w\u0142asne komponenty React z klasami Tailwind, kt\xF3re musz\u0105 trafi\u0107 do
+   CSS. Bez tego absolute positioning, color/border klasy w nowych fragmentach
+   s\u0105 ignorowane \u2014 komponent renderuje si\u0119 bez styl\xF3w. */
+@source "${rootRel}/node_modules/@arcote.tech/*/src/**/*.{ts,tsx}";
 
 @custom-variant dark (&:is(.dark *));
 
@@ -35281,11 +35289,21 @@ function collectFrameworkDeps(arcDir, rootDir, packages, sharedDeps = []) {
   } catch (e) {
     console.warn(`[arc-otel] could not resolve @arcote.tech/arc-otel \u2014 image will run without telemetry deps: ${e.message}`);
   }
+  let rootArc;
+  const rootPkgPath = join10(rootDir, "package.json");
+  if (existsSync9(rootPkgPath)) {
+    try {
+      const rootPkg = JSON.parse(readFileSync9(rootPkgPath, "utf-8"));
+      if (rootPkg.arc && typeof rootPkg.arc === "object")
+        rootArc = rootPkg.arc;
+    } catch {}
+  }
   const manifest = {
     name: "arc-platform-framework",
     private: true,
     type: "module",
-    dependencies: versions
+    dependencies: versions,
+    ...rootArc ? { arc: rootArc } : {}
   };
   const manifestPath = join10(arcDir, "package.json");
   writeFileSync8(manifestPath, JSON.stringify(manifest, null, 2) + `
@@ -36114,6 +36132,10 @@ function generateCompose({ cfg }) {
     lines.push("      retries: 20");
     lines.push("    networks:");
     lines.push("      - arc-net");
+    if (env2.db.exposeOnLoopback !== undefined) {
+      lines.push("    ports:");
+      lines.push(`      - "127.0.0.1:${env2.db.exposeOnLoopback}:5432"`);
+    }
     lines.push("");
   }
   if (cfg.observability?.enabled) {
@@ -36303,7 +36325,10 @@ processors:
     send_batch_max_size: 1024
 
   # Tail-based sampling \u2014 applied after a full trace has been assembled.
-  # Errors and slow traces are kept 100%, everything else at 10%.
+  # Errors + slow traces zachowywane w 100%, normalne traces r\xF3wnie\u017C 100%
+  # przy obecnej skali (boostrap produkcji). Tail sampling matchuje OR po
+  # policies \u2014 bez "always" policy WSZYSTKIE OK traces by\u0142yby droppowane.
+  # Obni\u017C 'random_100pct' do np. 10% gdy ruch eksploduje.
   tail_sampling:
     decision_wait: 10s
     num_traces: 50000
@@ -36315,9 +36340,9 @@ processors:
       - name: slow
         type: latency
         latency: { threshold_ms: 500 }
-      - name: random_10pct
+      - name: random_100pct
         type: probabilistic
-        probabilistic: { sampling_percentage: 10 }
+        probabilistic: { sampling_percentage: 100 }
 
   # Drop high-cardinality / PII attributes that might slip past app-side
   # sanitization. Belt-and-suspenders before they hit long-term storage.
@@ -37236,7 +37261,8 @@ function validateDeployConfig(input) {
       } else if (dbType === "postgres") {
         db = {
           type: "postgres",
-          image: optionalString(dbRaw, `envs.${name}.db.image`)
+          image: optionalString(dbRaw, `envs.${name}.db.image`),
+          exposeOnLoopback: optionalNumber(dbRaw, `envs.${name}.db.exposeOnLoopback`)
         };
       } else {
         throw new Error(`deploy.arc.json: envs.${name}.db.type must be "sqlite" or "postgres" (got "${dbType}")`);
@@ -40636,7 +40662,7 @@ function staticFilesHandler(ws, devMode, getManifest) {
     return null;
   };
 }
-function apiEndpointsHandler(ws, getManifest, cm, moduleAccessMap) {
+function apiEndpointsHandler(ws, getManifest, cm, moduleAccessMap, telemetry) {
   return (req, url, ctx) => {
     if (url.pathname === "/api/modules") {
       const arcTokensHeader = req.headers.get("X-Arc-Tokens");
@@ -40656,7 +40682,11 @@ function apiEndpointsHandler(ws, getManifest, cm, moduleAccessMap) {
       return Response.json({
         status: "ok",
         groups: Object.keys(getManifest().groups).length,
-        clients: cm?.clientCount ?? 0
+        clients: cm?.clientCount ?? 0,
+        otel: {
+          enabled: telemetry?.config.enabled ?? false,
+          active: telemetry?.active ?? false
+        }
       }, { headers: ctx.corsHeaders });
     }
     return null;
@@ -40707,7 +40737,8 @@ async function startPlatformServer(opts) {
         environment: "server",
         endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
         mode: devMode ? "development" : "production",
-        sampleRate: devMode ? 1 : 1
+        sampleRate: devMode ? 1 : 1,
+        debug: process.env.ARC_OTEL_DEBUG === "true"
       });
       telemetry = init2.telemetry;
       telemetryShutdown = init2.shutdown;
@@ -40757,7 +40788,7 @@ async function startPlatformServer(opts) {
           corsHeaders: cors
         };
         const handlers = [
-          apiEndpointsHandler(ws, getManifest, null, moduleAccessMap),
+          apiEndpointsHandler(ws, getManifest, null, moduleAccessMap, telemetry),
           devReloadHandler(sseClients),
           staticFilesHandler(ws, !!devMode, getManifest),
           spaFallbackHandler(getShellHtml)
@@ -40795,7 +40826,7 @@ async function startPlatformServer(opts) {
     dbAdapterFactory,
     port,
     httpHandlers: [
-      apiEndpointsHandler(ws, getManifest, null, moduleAccessMap),
+      apiEndpointsHandler(ws, getManifest, null, moduleAccessMap, telemetry),
       devReloadHandler(sseClients),
       staticFilesHandler(ws, !!devMode, getManifest),
       spaFallbackHandler(getShellHtml)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcote.tech/arc-cli",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "description": "CLI tool for Arc framework",
   "module": "index.ts",
   "main": "dist/index.js",
@@ -12,13 +12,13 @@
     "build": "bun build --target=bun ./src/index.ts --outdir=dist --external @arcote.tech/arc --external @arcote.tech/arc-ds --external @arcote.tech/arc-react --external @arcote.tech/platform --external '@opentelemetry/*' && chmod +x dist/index.js"
   },
   "dependencies": {
-    "@arcote.tech/arc": "^0.7.8",
-    "@arcote.tech/arc-ds": "^0.7.8",
-    "@arcote.tech/arc-react": "^0.7.8",
-    "@arcote.tech/arc-host": "^0.7.8",
-    "@arcote.tech/arc-adapter-db-sqlite": "^0.7.8",
-    "@arcote.tech/arc-adapter-db-postgres": "^0.7.8",
-    "@arcote.tech/arc-otel": "^0.7.8",
+    "@arcote.tech/arc": "^0.7.9",
+    "@arcote.tech/arc-ds": "^0.7.9",
+    "@arcote.tech/arc-react": "^0.7.9",
+    "@arcote.tech/arc-host": "^0.7.9",
+    "@arcote.tech/arc-adapter-db-sqlite": "^0.7.9",
+    "@arcote.tech/arc-adapter-db-postgres": "^0.7.9",
+    "@arcote.tech/arc-otel": "^0.7.9",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/api-logs": "^0.57.0",
     "@opentelemetry/core": "^1.30.0",
@@ -31,7 +31,7 @@
     "@opentelemetry/sdk-trace-base": "^1.30.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
     "@opentelemetry/semantic-conventions": "^1.27.0",
-    "@arcote.tech/platform": "^0.7.8",
+    "@arcote.tech/platform": "^0.7.9",
     "@clack/prompts": "^0.9.0",
     "commander": "^11.1.0",
     "chokidar": "^3.5.3",

package/src/builder/dependency-collector.ts

@@ -79,11 +79,27 @@ export function collectFrameworkDeps(
       `[arc-otel] could not resolve @arcote.tech/arc-otel — image will run without telemetry deps: ${(e as Error).message}`,
     );
   }
+  // Pole `arc` z root package.json (translations, theme, manifest...) musi
+  // trafić do obrazu runtime — `readTranslationsConfig` w server.ts czyta je
+  // z `ws.rootDir/package.json` (czyli /app/package.json w obrazie). Bez
+  // przepisania `/api/translations` zwraca pustą listę locale, `useI18nConfig`
+  // w PlatformApp nie ustawia stanu, `I18nProvider` nie zostaje mountowany
+  // i każde `useI18n()` wyrzuca błąd na produkcji.
+  let rootArc: unknown;
+  const rootPkgPath = join(rootDir, "package.json");
+  if (existsSync(rootPkgPath)) {
+    try {
+      const rootPkg = JSON.parse(readFileSync(rootPkgPath, "utf-8")) as Record<string, unknown>;
+      if (rootPkg.arc && typeof rootPkg.arc === "object") rootArc = rootPkg.arc;
+    } catch {}
+  }
+
   const manifest = {
     name: "arc-platform-framework",
     private: true,
     type: "module" as const,
     dependencies: versions,
+    ...(rootArc ? { arc: rootArc } : {}),
   };
   const manifestPath = join(arcDir, "package.json");
   writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");

package/src/builder/module-builder.ts

@@ -722,8 +722,11 @@ const TAILWIND_INPUT_TEMPLATE = (rootRel: string) => `@import "tailwindcss";
 
 @source "${rootRel}/packages/*/*.{ts,tsx}";
 @source "${rootRel}/packages/*/src/**/*.{ts,tsx}";
-@source "${rootRel}/node_modules/@arcote.tech/platform/src/**/*.{ts,tsx}";
-@source "${rootRel}/node_modules/@arcote.tech/arc-ds/src/**/*.{ts,tsx}";
+/* Skanuj wszystkie framework packages — fragmenty (arc-chat, arc-ai-voice…)
+   wnoszą własne komponenty React z klasami Tailwind, które muszą trafić do
+   CSS. Bez tego absolute positioning, color/border klasy w nowych fragmentach
+   są ignorowane — komponent renderuje się bez stylów. */
+@source "${rootRel}/node_modules/@arcote.tech/*/src/**/*.{ts,tsx}";
 
 @custom-variant dark (&:is(.dark *));
 

package/src/deploy/compose.ts

@@ -164,8 +164,15 @@ export function generateCompose({ cfg }: ComposeOptions): string {
     lines.push("      retries: 20");
     lines.push("    networks:");
     lines.push("      - arc-net");
-    // No `ports:` — the database is only reachable from other containers
-    // on `arc-net`. Exposing 5432 to the host would defeat the isolation.
+    // `ports:` is omitted by default — the database is only reachable from
+    // other containers on `arc-net`. When `exposeOnLoopback` is set in
+    // deploy.arc.json, bind to `127.0.0.1:<n>:5432` on the host so SSH
+    // tunneling (DBeaver/psql via `ssh -L`) works without exposing the
+    // port to the public internet (ufw only opens 22/80/443).
+    if (env.db.exposeOnLoopback !== undefined) {
+      lines.push("    ports:");
+      lines.push(`      - "127.0.0.1:${env.db.exposeOnLoopback}:5432"`);
+    }
     lines.push("");
   }
 

package/src/deploy/config.ts

@@ -31,7 +31,21 @@ export interface DeployTarget {
  */
 export type DeployEnvDb =
   | { type: "sqlite" }
-  | { type: "postgres"; image?: string };
+  | {
+      type: "postgres";
+      image?: string;
+      /**
+       * Bind the postgres port to `127.0.0.1:<n>` on the host. Container
+       * pozostaje niewystawiony do internetu (ufw przepuszcza tylko
+       * 22/80/443), ale staje się dostępny przez SSH tunnel
+       * (`ssh -L <n>:localhost:<n> deploy@host`) np. dla DBeavera.
+       *
+       * Per-env różne porty unikają kolizji gdy kilka środowisk dzieli
+       * jeden VPS. Pomiń pole żeby zachować pełną izolację (tylko docker
+       * network).
+       */
+      exposeOnLoopback?: number;
+    };
 
 export interface DeployEnv {
   /** Subdomain or full domain routed by Caddy. */
@@ -301,6 +315,10 @@ export function validateDeployConfig(input: unknown): DeployConfig {
         db = {
           type: "postgres",
           image: optionalString(dbRaw, `envs.${name}.db.image`),
+          exposeOnLoopback: optionalNumber(
+            dbRaw,
+            `envs.${name}.db.exposeOnLoopback`,
+          ),
         };
       } else {
         throw new Error(

package/src/deploy/observability-configs.ts

@@ -13,9 +13,11 @@ import type { DeployConfig, DeployObservability } from "./config";
 //   - logs:    7d  retention (Loki chunks on local disk)
 //   - metrics: 30d retention (Prometheus TSDB on local disk)
 //
-// Tail sampling: every error + every span >500ms + 10% random. Decided in
-// the collector so per-service SDKs can be left at always-on without
-// flooding the backend.
+// Tail sampling: every error + every span >500ms + 100% random przy obecnej
+// skali. Tail_sampling matchuje OR po policies — bez "always" policy WSZYSTKIE
+// OK traces byłyby droppowane (errors + slow nie obejmują happy path).
+// Obniż `random_100pct` w `tail_sampling.policies` gdy backend zacznie się
+// zatkać; do tego momentu lepiej widzieć wszystko.
 // ---------------------------------------------------------------------------
 
 const DEFAULT_RETENTION = {
@@ -60,7 +62,10 @@ processors:
     send_batch_max_size: 1024
 
   # Tail-based sampling — applied after a full trace has been assembled.
-  # Errors and slow traces are kept 100%, everything else at 10%.
+  # Errors + slow traces zachowywane w 100%, normalne traces również 100%
+  # przy obecnej skali (boostrap produkcji). Tail sampling matchuje OR po
+  # policies — bez "always" policy WSZYSTKIE OK traces byłyby droppowane.
+  # Obniż 'random_100pct' do np. 10% gdy ruch eksploduje.
   tail_sampling:
     decision_wait: 10s
     num_traces: 50000
@@ -72,9 +77,9 @@ processors:
       - name: slow
         type: latency
         latency: { threshold_ms: 500 }
-      - name: random_10pct
+      - name: random_100pct
         type: probabilistic
-        probabilistic: { sampling_percentage: 10 }
+        probabilistic: { sampling_percentage: 100 }
 
   # Drop high-cardinality / PII attributes that might slip past app-side
   # sanitization. Belt-and-suspenders before they hit long-term storage.

package/src/platform/server.ts

@@ -415,6 +415,7 @@ function apiEndpointsHandler(
   getManifest: () => BuildManifest,
   cm: ConnectionManager | null,
   moduleAccessMap: Map<string, ModuleAccess>,
+  telemetry?: import("@arcote.tech/arc-otel").ArcTelemetry,
 ): ArcHttpHandler {
   return (req, url, ctx) => {
     if (url.pathname === "/api/modules") {
@@ -442,6 +443,16 @@ function apiEndpointsHandler(
           status: "ok",
           groups: Object.keys(getManifest().groups).length,
           clients: cm?.clientCount ?? 0,
+          otel: {
+            // `enabled` — `ARC_OTEL_ENABLED` w env i init przeszedł
+            // (telemetry obiekt istnieje, config.enabled === true).
+            // `active` — to samo + `attach()` wywołane (tracer ustawiony).
+            // Rozjazd między tymi flagami zwykle oznacza że
+            // `initServerTelemetry` przeszło na wczesny return z
+            // `config.enabled === false`.
+            enabled: telemetry?.config.enabled ?? false,
+            active: telemetry?.active ?? false,
+          },
         },
         { headers: ctx.corsHeaders },
       );
@@ -510,6 +521,7 @@ export async function startPlatformServer(
         endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
         mode: devMode ? "development" : "production",
         sampleRate: devMode ? 1.0 : 1.0, // head-based 100%, collector tail-samples
+        debug: process.env.ARC_OTEL_DEBUG === "true",
       });
       telemetry = init.telemetry;
       telemetryShutdown = init.shutdown;
@@ -572,7 +584,7 @@ export async function startPlatformServer(
 
         // Platform handlers only
         const handlers: ArcHttpHandler[] = [
-          apiEndpointsHandler(ws, getManifest, null, moduleAccessMap),
+          apiEndpointsHandler(ws, getManifest, null, moduleAccessMap, telemetry),
           devReloadHandler(sseClients),
           staticFilesHandler(ws, !!devMode, getManifest),
           spaFallbackHandler(getShellHtml),
@@ -626,7 +638,7 @@ export async function startPlatformServer(
     port,
     httpHandlers: [
       // Platform-specific handlers (checked AFTER arc handlers)
-      apiEndpointsHandler(ws, getManifest, null, moduleAccessMap),
+      apiEndpointsHandler(ws, getManifest, null, moduleAccessMap, telemetry),
       devReloadHandler(sseClients),
       staticFilesHandler(ws, !!devMode, getManifest),
       spaFallbackHandler(getShellHtml),