@vibesdotdev/logging 0.0.1 → 1.0.0-rc.4

package/dist/cli/types.d.ts

@@ -1,11 +1,15 @@
 /**
  * CLI Descriptor Types (local definitions)
  *
- * These types are defined locally because the CLI module hasn't been
- * migrated to the monorepo yet. They mirror the shapes from the CLI
- * module's descriptor schemas.
+ * These types are defined locally because logging cannot depend on
+ * @vibesdotdev/cli (cli depends on logging). They mirror the shapes from the
+ * CLI module's descriptor schemas.
  */
-import type { RuntimeDescriptor } from '@vibesdotdev/runtime/schemas/descriptor';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export interface CommandContext {
+    runtime: VibesRuntime;
+}
 export interface CLIGroupAssetDescriptor extends RuntimeDescriptor {
     kind: 'cli/group';
     name: string;
@@ -47,11 +51,15 @@ export interface CLICommandAssetDescriptor extends RuntimeDescriptor {
         description: string;
     }[];
     order?: number;
-    tuiAppId?: string;
+    interactive?: {
+        appId: string;
+        launchWhen: 'noArgsAndTty' | 'always' | 'explicit';
+    };
     logBuffer?: {
         enabled?: boolean;
         sinks?: string[];
         fallbackToStdout?: boolean;
     };
+    nonTtyBehavior?: 'service' | 'interactive';
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IACjE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACF;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IACnE,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACpB,EAAE,CAAC;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IACjE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACF;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IACnE,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACpB,EAAE,CAAC;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;KACnD,CAAC;IACF,SAAS,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;CAC3C"}

package/dist/cli/types.js

@@ -1,9 +1,9 @@
 /**
  * CLI Descriptor Types (local definitions)
  *
- * These types are defined locally because the CLI module hasn't been
- * migrated to the monorepo yet. They mirror the shapes from the CLI
- * module's descriptor schemas.
+ * These types are defined locally because logging cannot depend on
+ * @vibesdotdev/cli (cli depends on logging). They mirror the shapes from the
+ * CLI module's descriptor schemas.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/client/logging-client.d.ts

@@ -0,0 +1,31 @@
+import { BaseRuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+export declare const loggingClientDescriptor: RuntimeClientDescriptor;
+/**
+ * The registered logging `runtime/client`.
+ *
+ * The client is the lifecycle anchor the kernel retains per lifecycle and
+ * disposes after every dependent plugin finalized: resolving it (async paths
+ * use {@link getVibesLoggingClient}) proves the owner is live, and its
+ * disposal ends that lifecycle's ownership. It deliberately owns no state
+ * fields: every per-Root logging state (logger preparation, the emission
+ * window, captured settings, namespace settings, output resources and
+ * registration counts, error windows, stdout captures, observability
+ * disposals, telemetry) must stay readable from virgin registry forks and
+ * reload generations that never resolved a client, and the kernel
+ * materializes an independent client per lifecycle. Root-shared state
+ * therefore stays in the root-keyed stores until the kernel provides a
+ * root-shared client anchor; see
+ * `src/client/__tests__/logging-client-gap.test.ts` for the proof.
+ */
+export declare class LoggingClient extends BaseRuntimeClient {
+    constructor(descriptor?: RuntimeClientDescriptor, context?: KindContext, runtime?: RuntimeRef);
+}
+/** Resolve the logging owner for `runtime`, constructing its lifecycle's client on first use. */
+export declare function getVibesLoggingClient(runtime: RuntimeRef): Promise<LoggingClient>;
+/** Peek the already-resolved logging owner, or `undefined` when this lifecycle never resolved one. */
+export declare function tryGetVibesLoggingClient(runtime: RuntimeRef): LoggingClient | undefined;
+/** Retain (and load) this lifecycle's logging owner; the plugin calls this on activation. */
+export declare function activateLoggingClient(runtime: RuntimeRef): Promise<LoggingClient>;
+//# sourceMappingURL=logging-client.d.ts.map

package/dist/client/logging-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-client.d.ts","sourceRoot":"","sources":["../../src/client/logging-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EAGjB,KAAK,uBAAuB,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,eAAO,MAAM,uBAAuB,EAAE,uBAKrC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,iBAAiB;gBAElD,UAAU,GAAE,uBAAiD,EAC7D,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,UAAU;CAIrB;AAED,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAEjF;AAED,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAEvF;AAED,6FAA6F;AAC7F,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAIvF"}

package/dist/client/logging-client.js

@@ -0,0 +1,44 @@
+import { BaseRuntimeClient, getVibesClient, tryGetVibesClient } from '@vibesdotdev/kernel/client';
+export const loggingClientDescriptor = {
+    id: 'logging',
+    kind: 'runtime/client',
+    name: 'Logging',
+    description: 'Registered logging owner: retained per lifecycle, disposed after dependents'
+};
+/**
+ * The registered logging `runtime/client`.
+ *
+ * The client is the lifecycle anchor the kernel retains per lifecycle and
+ * disposes after every dependent plugin finalized: resolving it (async paths
+ * use {@link getVibesLoggingClient}) proves the owner is live, and its
+ * disposal ends that lifecycle's ownership. It deliberately owns no state
+ * fields: every per-Root logging state (logger preparation, the emission
+ * window, captured settings, namespace settings, output resources and
+ * registration counts, error windows, stdout captures, observability
+ * disposals, telemetry) must stay readable from virgin registry forks and
+ * reload generations that never resolved a client, and the kernel
+ * materializes an independent client per lifecycle. Root-shared state
+ * therefore stays in the root-keyed stores until the kernel provides a
+ * root-shared client anchor; see
+ * `src/client/__tests__/logging-client-gap.test.ts` for the proof.
+ */
+export class LoggingClient extends BaseRuntimeClient {
+    constructor(descriptor = loggingClientDescriptor, context, runtime) {
+        super(descriptor, context, runtime);
+    }
+}
+/** Resolve the logging owner for `runtime`, constructing its lifecycle's client on first use. */
+export function getVibesLoggingClient(runtime) {
+    return getVibesClient('logging', runtime);
+}
+/** Peek the already-resolved logging owner, or `undefined` when this lifecycle never resolved one. */
+export function tryGetVibesLoggingClient(runtime) {
+    return tryGetVibesClient('logging', runtime);
+}
+/** Retain (and load) this lifecycle's logging owner; the plugin calls this on activation. */
+export async function activateLoggingClient(runtime) {
+    const client = await getVibesLoggingClient(runtime);
+    await client.load();
+    return client;
+}
+//# sourceMappingURL=logging-client.js.map

package/dist/client/logging-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-client.js","sourceRoot":"","sources":["../../src/client/logging-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EAEjB,MAAM,4BAA4B,CAAC;AAIpC,MAAM,CAAC,MAAM,uBAAuB,GAA4B;IAC/D,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,6EAA6E;CAC1F,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IACnD,YACC,aAAsC,uBAAuB,EAC7D,OAAqB,EACrB,OAAoB;QAEpB,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACD;AAED,iGAAiG;AACjG,MAAM,UAAU,qBAAqB,CAAC,OAAmB;IACxD,OAAO,cAAc,CAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,wBAAwB,CAAC,OAAmB;IAC3D,OAAO,iBAAiB,CAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAmB;IAC9D,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACpB,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/config/file-rotation.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { OutputDescriptor, OutputRotation } from '../schemas/output.ts';
+/**
+ * A file output's rotation on the handed runtime: its descriptor's `rotation`
+ * with the runtime surface's `retentionBySurface` override, every omitted
+ * field filled from the runtime's `logging` settings (`fileRotationMaxSize`,
+ * `fileRotationMaxAge`, `fileRotationMaxFiles`). The settings must already be
+ * captured on a Config-enabled host, as for every file output.
+ */
+export declare function resolveFileOutputRotation(runtime: RuntimeRef, descriptor: Pick<OutputDescriptor, 'rotation' | 'retentionBySurface'>): OutputRotation;
+//# sourceMappingURL=file-rotation.d.ts.map

package/dist/config/file-rotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-rotation.d.ts","sourceRoot":"","sources":["../../src/config/file-rotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI7E;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,oBAAoB,CAAC,GACnE,cAAc,CAOhB"}

package/dist/config/file-rotation.js

@@ -0,0 +1,18 @@
+import { resolveOutputRotation } from "../schemas/output-defaults.js";
+import { getCapturedLoggingConfig } from "./load-config.js";
+/**
+ * A file output's rotation on the handed runtime: its descriptor's `rotation`
+ * with the runtime surface's `retentionBySurface` override, every omitted
+ * field filled from the runtime's `logging` settings (`fileRotationMaxSize`,
+ * `fileRotationMaxAge`, `fileRotationMaxFiles`). The settings must already be
+ * captured on a Config-enabled host, as for every file output.
+ */
+export function resolveFileOutputRotation(runtime, descriptor) {
+    const settings = getCapturedLoggingConfig(runtime);
+    return resolveOutputRotation(descriptor.rotation, {
+        surface: runtime.scope.surface,
+        retentionBySurface: descriptor.retentionBySurface,
+        defaults: { maxSize: settings.fileRotationMaxSize, maxAge: settings.fileRotationMaxAge, maxFiles: settings.fileRotationMaxFiles }
+    });
+}
+//# sourceMappingURL=file-rotation.js.map

package/dist/config/file-rotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-rotation.js","sourceRoot":"","sources":["../../src/config/file-rotation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACxC,OAAmB,EACnB,UAAqE;IAErE,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,qBAAqB,CAAC,UAAU,CAAC,QAAQ,EAAE;QACjD,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO;QAC9B,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;QACjD,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,EAAE;KACjI,CAAC,CAAC;AACJ,CAAC"}

package/dist/config/load-config.d.ts

@@ -0,0 +1,7 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type LoggingConfig } from './logging.config.descriptor.ts';
+export declare function resolveDeclaredLoggingDefaults(runtime: RuntimeRef): LoggingConfig;
+export declare function loadLoggingConfig(runtime: RuntimeRef): Promise<LoggingConfig>;
+export declare function captureLoggingConfig(runtime: RuntimeRef): Promise<LoggingConfig>;
+export declare function getCapturedLoggingConfig(runtime: RuntimeRef): LoggingConfig;
+//# sourceMappingURL=load-config.d.ts.map

package/dist/config/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/G,OAAO,EAIN,KAAK,aAAa,EAClB,MAAM,gCAAgC,CAAC;AAQxC,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAWjF;AAOD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBnF;AAMD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAYtF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAO3E"}

package/dist/config/load-config.js

@@ -0,0 +1,68 @@
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { LOGGING_CONFIG_MANIFEST_ID, loggingConfigDescriptor, LoggingConfigSchema } from "./logging.config.descriptor.js";
+import { loggingRootOf } from "../core/root-identity.js";
+export function resolveDeclaredLoggingDefaults(runtime) {
+    const defaults = Object.fromEntries(Object.entries(loggingConfigDescriptor.fields).flatMap(([key, field]) => 'defaults' in field ? [[key, field.defaults.resolver({ runtime })]] : []));
+    const parsed = LoggingConfigSchema.safeParse(defaults);
+    if (!parsed.success)
+        throw new CapabilityError('Declared Logging defaults are invalid.', 'INVALID_INPUT', {
+            reason: 'logging-config-invalid',
+            recoveryHint: 'Correct the malformed Logging setting (VIBES_LOG_LEVEL or LOG_LEVEL: debug, info, warn or error; VIBES_LOG_INFO_SAMPLING_RATE: a number from 0 to 1; VIBES_LOG_MAX_SIZE: a size such as 25MB; VIBES_LOG_MAX_AGE: a duration such as 14d; VIBES_LOG_MAX_FILES: a whole number above 0) or unset it.',
+            details: { manifestId: LOGGING_CONFIG_MANIFEST_ID, fields: parsed.error.issues.map(issue => issue.path.join('.')) }
+        });
+    return parsed.data;
+}
+// C077a: a host composing Config and Logging but no store Logging allows declares that the
+// `logging` manifest has no stored layer there; the manifest keeps it for hosts that have a store.
+const NO_ALLOWED_STORE_RECOVERY = "This host composes no store Logging allows: declare `config['config.storage'] = { manifests: { logging: 'none' } }` in its composition, or compose an allowed store.";
+const CONFIG_OWNER_RECOVERY = 'Compose a Config client (a `config` provider) with the `config/manifest` kind, or remove the Config kind from this host so Logging uses its declared defaults.';
+export async function loadLoggingConfig(runtime) {
+    // C069d: an explicit declared chain. A present but broken Config owner
+    // remains a refusal; only an uncomposed Config kind uses these field defaults.
+    if (!runtime.hasKind('config/manifest'))
+        return resolveDeclaredLoggingDefaults(runtime);
+    try {
+        const config = await getVibesClient('config', runtime);
+        return await config.read({ id: LOGGING_CONFIG_MANIFEST_ID, schema: LoggingConfigSchema });
+    }
+    catch (cause) {
+        // The recovery follows the cause: no store this manifest allows needs the host's declaration.
+        const failure = CaughtFailureSchema.parse(cause);
+        const noAllowedStore = isCapabilityError(failure) && failure.reason === 'storage-adapter-absent';
+        // The Config failure alone never names Logging; the refusal does, and keeps the cause.
+        throw new CapabilityError('Logging could not read its settings from the Config owner of this host.', 'UNAVAILABLE', {
+            reason: 'logging-config-unavailable', retryable: false, cause,
+            details: { manifestId: LOGGING_CONFIG_MANIFEST_ID },
+            recoveryHint: noAllowedStore ? NO_ALLOWED_STORE_RECOVERY : CONFIG_OWNER_RECOVERY
+        });
+    }
+}
+/** Settings captured once per Root (`loggingRootOf(runtime)`); its views and reload generations read the same capture. */
+const capturedSettings = new WeakMap();
+const capturingSettings = new WeakMap();
+export async function captureLoggingConfig(runtime) {
+    const captured = capturedSettings.get(loggingRootOf(runtime));
+    if (captured)
+        return captured;
+    let pending = capturingSettings.get(loggingRootOf(runtime));
+    if (!pending) {
+        pending = loadLoggingConfig(runtime).then(settings => {
+            capturedSettings.set(loggingRootOf(runtime), settings);
+            return settings;
+        }).finally(() => capturingSettings.delete(loggingRootOf(runtime)));
+        capturingSettings.set(loggingRootOf(runtime), pending);
+    }
+    return pending;
+}
+export function getCapturedLoggingConfig(runtime) {
+    const captured = capturedSettings.get(loggingRootOf(runtime));
+    if (captured)
+        return captured;
+    if (!runtime.hasKind('config/manifest'))
+        return resolveDeclaredLoggingDefaults(runtime);
+    throw new CapabilityError('Logging settings must be captured before using this Config-enabled host.', 'UNAVAILABLE', {
+        reason: 'logging-config-not-initialized', retryable: false
+    });
+}
+//# sourceMappingURL=load-config.js.map

package/dist/config/load-config.js.map

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

package/dist/config/logging.config.descriptor.d.ts

@@ -0,0 +1,350 @@
+/**
+ * Logging settings — the config manifest the logging owner reads (L1).
+ *
+ * `rotation` declares named rotation policies for files the logging owner
+ * rotates on another owner's behalf. A policy uses the file output's size and
+ * count semantics (`schemas/output-defaults.ts`): `maxSize` is a size string
+ * (`10MB`), `maxFiles` the number of archives kept, and the optional `maxAge`
+ * (`14d`) how long an archived file is kept before its owner removes it. PM's
+ * child-process capture is the first declared entry, replacing PM's own
+ * 10 MB / 3 constants.
+ *
+ * Declared as data with `createRuntimeAsset` so logging takes no package edge
+ * on `@vibesdotdev/config` (config depends on logging). The runtime holds the
+ * descriptor until the `config/manifest` kind registers.
+ */
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+/** The conventional credential key for the OTLP exporter headers (`key=value` pairs, comma separated); a host declares it in `otelHeadersCredential`. */
+export declare const OTEL_HEADERS_CREDENTIAL_KEY = "OTEL_EXPORTER_OTLP_HEADERS";
+export declare const RotationPolicyConfigSchema: z.ZodObject<{
+    maxSize: z.ZodString;
+    maxFiles: z.ZodNumber;
+    maxAge: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RotationPolicyConfig = z.infer<typeof RotationPolicyConfigSchema>;
+/** The declared policy names and their defaults. */
+export declare const DECLARED_ROTATION_POLICIES: {
+    /** PM-managed child stdout/stderr and the PM daemon's own stdout/stderr logs. */
+    readonly 'pm.process-capture': {
+        readonly maxSize: "10MB";
+        readonly maxFiles: 3;
+        readonly maxAge: "14d";
+    };
+    /** Launched harness stdout/stderr; copy-truncate preserves inherited append handles. */
+    readonly 'launch.capture': {
+        readonly maxSize: "10MB";
+        readonly maxFiles: 3;
+    };
+};
+export declare const LoggingConfigSchema: z.ZodObject<{
+    logSelectors: z.ZodDefault<z.ZodString>;
+    logLevel: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+    }>>;
+    infoSamplingRate: z.ZodDefault<z.ZodNumber>;
+    fileName: z.ZodDefault<z.ZodString>;
+    retentionCleanupIntervalMs: z.ZodDefault<z.ZodNumber>;
+    fileRotationMaxSize: z.ZodDefault<z.ZodString>;
+    fileRotationMaxAge: z.ZodDefault<z.ZodString>;
+    fileRotationMaxFiles: z.ZodDefault<z.ZodNumber>;
+    rotation: z.ZodPipe<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        maxSize: z.ZodString;
+        maxFiles: z.ZodNumber;
+        maxAge: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>, z.ZodTransform<Record<string, {
+        maxSize: string;
+        maxFiles: number;
+        maxAge?: string | undefined;
+    }>, Record<string, {
+        maxSize: string;
+        maxFiles: number;
+        maxAge?: string | undefined;
+    }>>>;
+    remoteEndpoint: z.ZodOptional<z.ZodURL>;
+    otelServiceName: z.ZodDefault<z.ZodString>;
+    otelServiceVersion: z.ZodDefault<z.ZodString>;
+    otelEndpoint: z.ZodDefault<z.ZodString>;
+    otelLogsEndpoint: z.ZodDefault<z.ZodString>;
+    otelEnabled: z.ZodOptional<z.ZodBoolean>;
+    otelEnvironment: z.ZodDefault<z.ZodString>;
+    otelHostName: z.ZodDefault<z.ZodString>;
+    otelHeadersCredential: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        source: z.ZodLiteral<"secret">;
+        key: z.ZodString;
+        store: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodCustom<object, object>>;
+    }, z.core.$strict>], "source">>;
+    otelSamplingRate: z.ZodDefault<z.ZodNumber>;
+    otelExportInterval: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type LoggingConfig = z.infer<typeof LoggingConfigSchema>;
+export declare const LOGGING_CONFIG_MANIFEST_ID = "logging";
+export declare const loggingConfigDescriptor: {
+    kind: "config/manifest";
+    id: string;
+    name: string;
+    namespace: string;
+    description: string;
+    tier: string;
+    category: string;
+    schema: z.ZodObject<{
+        logSelectors: z.ZodDefault<z.ZodString>;
+        logLevel: z.ZodDefault<z.ZodEnum<{
+            error: "error";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+        }>>;
+        infoSamplingRate: z.ZodDefault<z.ZodNumber>;
+        fileName: z.ZodDefault<z.ZodString>;
+        retentionCleanupIntervalMs: z.ZodDefault<z.ZodNumber>;
+        fileRotationMaxSize: z.ZodDefault<z.ZodString>;
+        fileRotationMaxAge: z.ZodDefault<z.ZodString>;
+        fileRotationMaxFiles: z.ZodDefault<z.ZodNumber>;
+        rotation: z.ZodPipe<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            maxSize: z.ZodString;
+            maxFiles: z.ZodNumber;
+            maxAge: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>, z.ZodTransform<Record<string, {
+            maxSize: string;
+            maxFiles: number;
+            maxAge?: string | undefined;
+        }>, Record<string, {
+            maxSize: string;
+            maxFiles: number;
+            maxAge?: string | undefined;
+        }>>>;
+        remoteEndpoint: z.ZodOptional<z.ZodURL>;
+        otelServiceName: z.ZodDefault<z.ZodString>;
+        otelServiceVersion: z.ZodDefault<z.ZodString>;
+        otelEndpoint: z.ZodDefault<z.ZodString>;
+        otelLogsEndpoint: z.ZodDefault<z.ZodString>;
+        otelEnabled: z.ZodOptional<z.ZodBoolean>;
+        otelEnvironment: z.ZodDefault<z.ZodString>;
+        otelHostName: z.ZodDefault<z.ZodString>;
+        otelHeadersCredential: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            source: z.ZodLiteral<"secret">;
+            key: z.ZodString;
+            store: z.ZodOptional<z.ZodString>;
+            operation: z.ZodOptional<z.ZodCustom<object, object>>;
+        }, z.core.$strict>], "source">>;
+        otelSamplingRate: z.ZodDefault<z.ZodNumber>;
+        otelExportInterval: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    fields: {
+        logSelectors: {
+            defaults: {
+                base: string;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => string;
+            };
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        logLevel: {
+            defaults: {
+                base: string;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => string;
+            };
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        infoSamplingRate: {
+            defaults: {
+                base: number;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => number;
+            };
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        fileName: {
+            defaults: {
+                base: string;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => string;
+            };
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        retentionCleanupIntervalMs: {
+            defaults: {
+                base: number;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => number;
+            };
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        fileRotationMaxSize: {
+            defaults: {
+                base: string;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => string;
+            };
+            ui: {
+                label: string;
+                description: string;
+                component: string;
+                group: string;
+            };
+        };
+        fileRotationMaxAge: {
+            defaults: {
+                base: string;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => string;
+            };
+            ui: {
+                label: string;
+                description: string;
+                component: string;
+                group: string;
+            };
+        };
+        fileRotationMaxFiles: {
+            defaults: {
+                base: number;
+                resolver: ({ runtime }: {
+                    runtime: RuntimeRef;
+                }) => number;
+            };
+            ui: {
+                label: string;
+                description: string;
+                component: string;
+                group: string;
+            };
+        };
+        rotation: {
+            ui: {
+                label: string;
+                description: string;
+                component: string;
+                group: string;
+            };
+        };
+        remoteEndpoint: {
+            ui: {
+                label: string;
+                description: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelServiceName: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelServiceVersion: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelEndpoint: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelLogsEndpoint: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelEnabled: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelEnvironment: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelHostName: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelHeadersCredential: {
+            ui: {
+                label: string;
+                description: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelSamplingRate: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+        otelExportInterval: {
+            ui: {
+                label: string;
+                component: string;
+                group: string;
+            };
+        };
+    };
+    groups: {
+        id: string;
+        label: string;
+    }[];
+    allowedAdapters: string[];
+    defaultAdapter: string;
+    scope: string;
+    customTables: boolean;
+    version: number;
+    internal: boolean;
+    context: {
+        surfaces: string[];
+    };
+    enabled: true;
+};
+export default loggingConfigDescriptor;
+//# sourceMappingURL=logging.config.descriptor.d.ts.map

package/dist/config/logging.config.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.config.descriptor.d.ts","sourceRoot":"","sources":["../../src/config/logging.config.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI1E,yJAAyJ;AACzJ,eAAO,MAAM,2BAA2B,+BAA+B,CAAC;AAaxE,eAAO,MAAM,0BAA0B;;;;iBAKrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,oDAAoD;AACpD,eAAO,MAAM,0BAA0B;IACtC,iFAAiF;;;;;;IAEjF,wFAAwF;;;;;CAEhC,CAAC;AAK1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyC9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAEpD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAWa;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;wCAInB;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;wCAQ5B;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;wCAQf;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;wCAIlB;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;wCAID;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;;wCAIxB;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;;wCAIrB;oBAAE,OAAO,EAAE,UAAU,CAAA;iBAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEzG,CAAC;AAEH,eAAe,uBAAuB,CAAC"}