@creezio/observability 0.22.0

package/README.md

@@ -0,0 +1,328 @@
+# @creezio/observability
+
+## Rôle
+
+`@creezio/observability` regroupe les briques d'observabilité Creezio :
+
+- store d'événements activité / plugin usage / control-plane ;
+- `ApiMount` `/platform/observability` ;
+- ops journal desktop JSONL, règles de boot et émission d'événements ;
+- agent flotte desktop opt-in, fleet activity et samples ;
+- usage analytics UI/admin ;
+- request logs API/MCP avec redaction ;
+- UI admin analytics, request logs et endpoints ;
+- `fleet-collector` autonome (`creezio-fleet-collector`).
+
+Le package est marque-agnostique : endpoints, consentement, identité d'installation, chemins et labels UI sont injectés par la marque ou par env neutre.
+
+## Périmètre kit vs marque
+
+**Kit**
+
+- Fournit les schémas/stores observability.
+- Enregistre les événements et agrégations génériques.
+- Écrit un journal ops local best-effort, avec redaction.
+- Produit les heartbeats/crash/bundles de flotte via hooks.
+- Capture les logs API/MCP dans un ring buffer mémoire et miroir JSONL.
+- Stocke et agrège les événements usage analytics.
+- Fournit routes Hono ingest/admin et UI React admin.
+- Fournit un collector HTTP autonome pour la flotte.
+
+**Marque**
+
+- Configure les DB adapters (`configureUsageAnalytics`) et request logs (`configureRequestLogs`).
+- Configure les tokens UI analytics (`configureUsageAnalyticsUiBrand`).
+- Appelle `initOpsJournal`, `track*` et `createFleetAgent` depuis l'app desktop.
+- Fournit consentement, install id, version, santé services, samples et commandes distantes.
+- Monte les middlewares `requestLogApiMiddleware` / `requestLogMcpMiddleware`.
+- Monte les routes analytics/admin avec auth owner.
+- Déploie/configure le `fleet-collector` et ses secrets.
+
+## Installation/build
+
+```bash
+npm run build -w @creezio/observability
+npm run typecheck -w @creezio/observability
+npm run test:fleet-collector -w @creezio/observability
+```
+
+Lancement collector :
+
+```bash
+npm run fleet-collector -w @creezio/observability
+# ou
+npx creezio-fleet-collector
+```
+
+Exports :
+
+- `@creezio/observability` : stores, helpers, ops, fleet, usage, request logs.
+- `@creezio/observability/ui` : UI admin et tracker client.
+- `@creezio/observability/fleet-collector/*` : collector autonome.
+
+## Configuration détaillée
+
+### Store observability et `ApiMount`
+
+```ts
+import {
+  createObservabilityApiMount,
+  createSqliteObservabilityStore,
+} from "@creezio/observability";
+
+const store = createSqliteObservabilityStore({ db });
+const mount = createObservabilityApiMount(store);
+```
+
+### Usage analytics
+
+```ts
+import {
+  configureUsageAnalytics,
+  configureUsageAnalyticsUiBrand,
+} from "@creezio/observability";
+
+configureUsageAnalytics({
+  getWriteDb: () => db,
+  getDb: () => db,
+  tableExists: (name) => Boolean(db.prepare("SELECT 1 FROM sqlite_master WHERE name=?").get(name)),
+});
+
+configureUsageAnalyticsUiBrand({
+  aidAttr: "data-brand-aid",
+  titlebarNoDragClass: "brand-titlebar-no-drag",
+  mirrorFleetAction: (payload) => recordFleetAction(payload),
+});
+```
+
+`configureUsageAnalytics({ getWriteDb })` est requis avant les routes et queries usage.
+
+### Request logs
+
+```ts
+import {
+  configureRequestLogs,
+  requestLogApiMiddleware,
+  requestLogMcpMiddleware,
+} from "@creezio/observability";
+
+configureRequestLogs({
+  getFleetStateDir: () => "/var/lib/brand/fleet-state",
+});
+
+api.use("/api/v1/*", requestLogApiMiddleware);
+mcp.use("/mcp/*", requestLogMcpMiddleware);
+```
+
+Si `getFleetStateDir` est absent, le package lit :
+
+- `CREEZIO_FLEET_STATE_DIR`
+- sinon toute variable `${envPrefix}_FLEET_STATE_DIR` dérivée du manifest
+  marque (posée par le host — aucun préfixe marque câblé dans le kit)
+
+### Ops journal
+
+```ts
+import {
+  initOpsJournal,
+  setOpsJournalHooks,
+  track,
+  trackDecision,
+} from "@creezio/observability";
+
+setOpsJournalHooks({
+  log: (scope, line) => logger.info(`[${scope}] ${line}`),
+  onAnomaly: (evt) => reportAnomaly(evt),
+});
+
+initOpsJournal(userDataDir, appVersion);
+
+track({ level: "info", kind: "boot.start", ctx: { appVersion } });
+trackDecision("service.meili", "ok", { durationMs: 120 });
+```
+
+Le journal écrit dans `<userData>/ops`, garde une rétention bornée et ne doit jamais faire crasher l'app.
+
+Préfixes d'événements ops (`src/ops/types.ts`) : le SoT d'émission reste
+`TF2EVENT ` (préfixe historique conservé pour ne pas casser les collecteurs
+déployés) ; la lecture est dual-read via `OPS_EVENT_PREFIXES` (`TF2EVENT `,
+`CertivanEVENT `, …) — un parseur doit accepter tous les préfixes connus.
+
+### Fleet agent
+
+```ts
+import { createFleetAgent } from "@creezio/observability";
+
+const fleet = createFleetAgent({
+  baseUrl: "https://fleet.example.com/i-token",
+  getConfig: () => telemetryConfig,
+  isScopeActive: (cfg, scope) => cfg.enabled && Boolean(cfg.scopes[scope]),
+  getInstallId: () => installId,
+  getAppVersion: () => appVersion,
+  getTunnelInfo: () => ({ slug: "demo", hostname: "demo.example.com" }),
+  log: (scope, line) => logger.info(`[${scope}] ${line}`),
+});
+
+fleet.startFleetAgent({
+  appKind: "server",
+  getHealth: async () => ({ next: "ok", hermes: "ok" }),
+  getRequestLogsSample: async () => listRequestLogs({ limit: 20 }).logs,
+  getHeartbeatExtras: async () => ({ dossierStats: { open: 12 } }),
+});
+```
+
+### Fleet collector env
+
+Le collector lit des env neutres, avec dual-read legacy :
+
+- `CREEZIO_FLEET_PORT` / `FLEET_PORT`
+- `CREEZIO_FLEET_INGEST_TOKEN` / `FLEET_INGEST_TOKEN`
+- `CREEZIO_FLEET_OPS_USER`, `_PASS`, `_TOKEN`
+- `CREEZIO_FLEET_DIR` / `FLEET_DIR`
+- `FLEET_PUBLIC_DOMAIN` / `CREEZIO_FLEET_DOMAIN`
+- `CREEZIO_FLEET_TUNNEL_SUFFIX`
+- `CREEZIO_FLEET_UI_TITLE`, `_MARK`, `_HOME_TITLE`, `_REALM`
+- `CREEZIO_FLEET_UI_EXTRAS_TITLE`
+- `CREEZIO_FLEET_UI_ETAT_LABELS`
+
+Voir [fleet-collector/README.md](./fleet-collector/README.md).
+
+## API publique avec exemples
+
+### Observability store / ApiMount
+
+Endpoints de `createObservabilityApiMount(store)` :
+
+- `GET /events`
+- `POST /events`
+- `GET /usage`
+- `GET /orgs`
+- `GET /summary`
+
+```bash
+curl "$API/platform/observability/events?kind=activity&limit=20"
+curl -X POST "$API/platform/observability/events" \
+  -H "Content-Type: application/json" \
+  -d '{"kind":"activity","action":"page_view","userId":"u1","meta":{"path":"/dashboard"}}'
+```
+
+### Usage analytics routes
+
+```ts
+import {
+  createUsageAnalyticsAdminRoutes,
+  createUsageAnalyticsIngestRoutes,
+} from "@creezio/observability";
+
+api.route(
+  "/usage",
+  createUsageAnalyticsIngestRoutes({
+    getSession: async (c) => c.get("session") ?? null,
+    getUserKind: (userId) => getUser(userId)?.kind ?? "human",
+  }),
+);
+
+admin.route("/", createUsageAnalyticsAdminRoutes());
+```
+
+Endpoints :
+
+- `POST /usage/events`
+- `GET /analytics/overview`
+- `GET /analytics/timeline`
+- `GET /analytics/pages`
+- `GET /analytics/clicks`
+- `GET /analytics/users`
+- `GET /analytics/events`
+- `GET /analytics/productivity`
+- `DELETE /analytics/events`
+
+### Request logs
+
+```ts
+import {
+  createRequestLogsRoutes,
+  listRequestLogs,
+} from "@creezio/observability";
+
+admin.route("/admin", createRequestLogsRoutes());
+
+const recentErrors = listRequestLogs({
+  source: "api",
+  errorsOnly: true,
+  limit: 50,
+});
+```
+
+Routes :
+
+- `GET /request-logs?limit=100&source=api|mcp|all&q=...&errorsOnly=1`
+- `DELETE /request-logs`
+
+### UI
+
+```tsx
+import {
+  AnalyticsClient,
+  RequestLogsClient,
+  UsageAnalyticsProvider,
+} from "@creezio/observability/ui";
+
+export function AdminObservability() {
+  return (
+    <UsageAnalyticsProvider session={{ userId: "u1", username: "Owner" }}>
+      <AnalyticsClient />
+      <RequestLogsClient />
+    </UsageAnalyticsProvider>
+  );
+}
+```
+
+## Flux
+
+### Usage analytics
+
+1. `UsageAnalyticsProvider` installe le tracker client.
+2. Les clics et pages sont annotés via `aidAttr`.
+3. Les événements sont batchés vers `POST /usage/events`.
+4. `insertUsageEvents` écrit en SQLite.
+5. Les routes admin agrègent overview, timeline, pages, clicks, users et productivité.
+6. Optionnellement, `mirrorFleetAction` copie les actions vers le buffer flotte.
+
+### Request logs
+
+1. Les middlewares lisent requête/réponse de manière best-effort.
+2. Les secrets sont redacted par nom de clé et patterns de valeur.
+3. `pushRequestLog` ajoute au ring buffer mémoire.
+4. Si un fleet state dir est configuré, un résumé JSONL est écrit pour l'agent flotte.
+5. L'UI admin lit/purge via `createRequestLogsRoutes`.
+
+### Ops journal et fleet
+
+1. `initOpsJournal` crée un boot id et un fichier JSONL.
+2. `track*` enregistre décisions, anomalies, crashes et événements externes.
+3. `createFleetAgent` construit des heartbeats opt-in selon scopes.
+4. L'agent poste `/heartbeat`, `/crash`, `/bundle` et poll `/commands`.
+5. `fleet-collector` stocke les données et expose une UI ops.
+
+## Intégration marques
+
+- Configurer usage analytics avant les routes et avant l'UI tracker.
+- Brancher request logs tôt dans la stack Hono, avant auth, mais redaction toujours active.
+- Monter les routes admin derrière auth owner.
+- Initialiser ops journal après logger et avant les services à diagnostiquer.
+- Créer un `FleetAgent` uniquement si la télémétrie opt-in est disponible.
+- Garder les extras métier opaques (`dossierStats`, etc.) dans `getHeartbeatExtras`.
+- Déployer `fleet-collector` avec tokens forts et Basic/Bearer ops.
+
+## Dépendances
+
+- Runtime : `@creezio/api-kernel`, `@creezio/platform-core`, `hono`.
+- UI peer : `react`, `next`, `lucide-react`, `recharts`, Radix UI, `clsx`, `tailwind-merge`, `class-variance-authority`.
+- Node runtime pour ops/fleet collector : `fs`, `path`, `os`, HTTP.
+
+## Voir aussi
+
+- [AGENTS.md](./AGENTS.md)
+- [docs/FILES.md](./docs/FILES.md)
+- [fleet-collector/README.md](./fleet-collector/README.md)

package/dist/.creezio-src-hash.json

@@ -0,0 +1,4 @@
+{
+  "srcHash": "f55dae2107e89fb49c6f8b18dac98a2db469d0688ad0e94142ea71edbd143489",
+  "generatedAt": "2026-08-31T18:14:50.878Z"
+}

package/dist/api-endpoints/http-routes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Admin — registre des endpoints runtime (session UI).
+ * Hono « nu » : hors doc OpenAPI publique. Auth owner reste côté marque.
+ */
+import { Hono } from "hono";
+import type { ApiEndpointsRegistry } from "./registry.js";
+export type CreateApiEndpointsRoutesOptions = {
+    getRegistry: () => ApiEndpointsRegistry;
+};
+export declare function createApiEndpointsRoutes(opts: CreateApiEndpointsRoutesOptions): Hono;
+//# sourceMappingURL=http-routes.d.ts.map

package/dist/api-endpoints/http-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-routes.d.ts","sourceRoot":"","sources":["../../src/api-endpoints/http-routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,MAAM,+BAA+B,GAAG;IAC5C,WAAW,EAAE,MAAM,oBAAoB,CAAC;CACzC,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,+BAA+B,GACpC,IAAI,CAMN"}

package/dist/api-endpoints/http-routes.js

@@ -0,0 +1,11 @@
+/**
+ * Admin — registre des endpoints runtime (session UI).
+ * Hono « nu » : hors doc OpenAPI publique. Auth owner reste côté marque.
+ */
+import { Hono } from "hono";
+export function createApiEndpointsRoutes(opts) {
+    const app = new Hono();
+    app.get("/endpoints", (c) => c.json(opts.getRegistry()));
+    return app;
+}
+//# sourceMappingURL=http-routes.js.map

package/dist/api-endpoints/http-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-routes.js","sourceRoot":"","sources":["../../src/api-endpoints/http-routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAO5B,MAAM,UAAU,wBAAwB,CACtC,IAAqC;IAErC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAEzD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/api-endpoints/index.d.ts

@@ -0,0 +1,4 @@
+export type { ApiEndpointRecord, ApiEndpointRouteInput, ApiEndpointsRegistry, } from "./registry.js";
+export { buildApiEndpointsRegistry, buildOpenApiDocumentFromRegistry, collectHonoRoutes, } from "./registry.js";
+export { createApiEndpointsRoutes, type CreateApiEndpointsRoutesOptions, } from "./http-routes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api-endpoints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api-endpoints/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,GACrC,MAAM,kBAAkB,CAAC"}

package/dist/api-endpoints/index.js

@@ -0,0 +1,3 @@
+export { buildApiEndpointsRegistry, buildOpenApiDocumentFromRegistry, collectHonoRoutes, } from "./registry.js";
+export { createApiEndpointsRoutes, } from "./http-routes.js";
+//# sourceMappingURL=index.js.map

package/dist/api-endpoints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api-endpoints/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC"}

package/dist/api-endpoints/registry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Registre Admin des endpoints runtime (port TempoFlow O5 — gold).
+ * Enrichit les routes réellement montées avec les métadonnées OpenAPI
+ * quand un document est fourni.
+ */
+export type ApiEndpointRecord = {
+    method: string;
+    path: string;
+    documented: boolean;
+    summary: string | null;
+    description: string | null;
+    tags: string[];
+};
+export type ApiEndpointsRegistry = {
+    generatedAt: string;
+    source: string;
+    openapiUrl: string;
+    endpoints: ApiEndpointRecord[];
+};
+export type ApiEndpointRouteInput = {
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+};
+type OpenApiOperation = {
+    summary?: string;
+    description?: string;
+    tags?: string[];
+};
+type OpenApiDocument = {
+    paths?: Record<string, Record<string, OpenApiOperation | undefined>>;
+};
+export declare function buildApiEndpointsRegistry(opts: {
+    routes: ApiEndpointRouteInput[];
+    openApiDocument?: OpenApiDocument | null;
+    openapiUrl?: string;
+    source?: string;
+}): ApiEndpointsRegistry;
+/** Document OpenAPI 3 minimal dérivé du registre runtime (lien Admin API). */
+export declare function buildOpenApiDocumentFromRegistry(registry: ApiEndpointsRegistry, opts?: {
+    title?: string;
+    version?: string;
+}): {
+    openapi: "3.0.3";
+    info: {
+        title: string;
+        version: string;
+        description: string;
+    };
+    paths: Record<string, Record<string, OpenApiOperation & {
+        responses: Record<string, {
+            description: string;
+        }>;
+    }>>;
+};
+/** Collecte les routes d'une app Hono (y compris sous-apps montées). */
+export declare function collectHonoRoutes(app: {
+    routes: Array<{
+        method: string;
+        path: string;
+    }>;
+}, pathPrefix?: string): ApiEndpointRouteInput[];
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/api-endpoints/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/api-endpoints/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC;CACtE,CAAC;AAYF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,oBAAoB,CA6DvB;AAED,8EAA8E;AAC9E,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;CAClH,CA8BA;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EACxD,UAAU,SAAK,GACd,qBAAqB,EAAE,CAYzB"}

package/dist/api-endpoints/registry.js

@@ -0,0 +1,102 @@
+/**
+ * Registre Admin des endpoints runtime (port TempoFlow O5 — gold).
+ * Enrichit les routes réellement montées avec les métadonnées OpenAPI
+ * quand un document est fourni.
+ */
+const HTTP_METHODS = [
+    "get",
+    "post",
+    "put",
+    "patch",
+    "delete",
+    "options",
+    "head",
+];
+export function buildApiEndpointsRegistry(opts) {
+    const operations = new Map();
+    for (const [pathKey, pathItem] of Object.entries(opts.openApiDocument?.paths || {})) {
+        if (!pathItem)
+            continue;
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const normalizedPath = pathKey.replace(/\{([^}]+)\}/g, ":$1");
+            operations.set(`${method.toUpperCase()} ${normalizedPath}`, {
+                summary: operation.summary,
+                description: operation.description,
+                tags: operation.tags,
+                documented: true,
+            });
+        }
+    }
+    const seen = new Set();
+    const endpoints = opts.routes
+        .filter((route) => route.method && route.method !== "ALL")
+        .flatMap((route) => {
+        const method = route.method.toUpperCase();
+        const key = `${method} ${route.path}`;
+        if (seen.has(key))
+            return [];
+        seen.add(key);
+        const operation = operations.get(key);
+        return [
+            {
+                method,
+                path: route.path,
+                documented: Boolean(operation) || Boolean(route.description || route.summary),
+                summary: operation?.summary || route.summary || null,
+                description: operation?.description || route.description || null,
+                tags: operation?.tags?.length
+                    ? operation.tags
+                    : route.tags || [],
+            },
+        ];
+    })
+        .sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method));
+    return {
+        generatedAt: new Date().toISOString(),
+        source: opts.source || "runtime routes (+ OpenAPI si fourni)",
+        openapiUrl: opts.openapiUrl || "/api/v1/openapi.json",
+        endpoints,
+    };
+}
+/** Document OpenAPI 3 minimal dérivé du registre runtime (lien Admin API). */
+export function buildOpenApiDocumentFromRegistry(registry, opts) {
+    const paths = {};
+    for (const ep of registry.endpoints) {
+        const method = ep.method.toLowerCase();
+        const pathKey = ep.path.replace(/:([A-Za-z0-9_]+)/g, "{$1}");
+        if (!paths[pathKey])
+            paths[pathKey] = {};
+        paths[pathKey][method] = {
+            summary: ep.summary || `${ep.method} ${ep.path}`,
+            ...(ep.description ? { description: ep.description } : {}),
+            tags: ep.tags.length ? ep.tags : ["runtime"],
+            responses: { "200": { description: "OK" } },
+        };
+    }
+    return {
+        openapi: "3.0.3",
+        info: {
+            title: opts?.title || "Creezio API",
+            version: opts?.version || "0.1.0",
+            description: `Generated from ${registry.source} at ${registry.generatedAt}`,
+        },
+        paths,
+    };
+}
+/** Collecte les routes d'une app Hono (y compris sous-apps montées). */
+export function collectHonoRoutes(app, pathPrefix = "") {
+    const prefix = pathPrefix.replace(/\/$/, "");
+    return app.routes
+        .filter((route) => route.method && route.method !== "ALL")
+        .map((route) => {
+        const sub = route.path.startsWith("/") ? route.path : `/${route.path}`;
+        const full = sub === "/"
+            ? prefix || "/"
+            : `${prefix}${sub}`.replace(/\/{2,}/g, "/");
+        return { method: route.method, path: full };
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/api-endpoints/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/api-endpoints/registry.ts"],"names":[],"mappings":"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"}

package/dist/api-mount.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mount API observabilité — /api/v1/platform/observability/...
+ */
+import type { ApiMount } from "@creezio/api-kernel";
+import type { ObservabilityStore } from "./types.js";
+export declare function createObservabilityApiMount(store: ObservabilityStore): ApiMount;
+//# sourceMappingURL=api-mount.d.ts.map

package/dist/api-mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-mount.d.ts","sourceRoot":"","sources":["../src/api-mount.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAA0B,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAU7E,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,GACxB,QAAQ,CA6GV"}