dev-cockpit 0.1.0

package/dist/core/config.d.ts

@@ -0,0 +1,391 @@
+import { z } from 'zod';
+/** Schema version constant. Bumps reserved for breaking changes (see ADR 0004). */
+export declare const CONFIG_VERSION = 1;
+export declare const BaseCockpitConfigSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    appName: z.ZodString;
+    watchers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        color: z.ZodOptional<z.ZodString>;
+        restartOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        notify: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodObject<{
+            onTransitionTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            onTransitionTo?: string[] | undefined;
+        }, {
+            onTransitionTo?: string[] | undefined;
+        }>]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        command: string;
+        label?: string | undefined;
+        cwd?: string | undefined;
+        env?: Record<string, string> | undefined;
+        color?: string | undefined;
+        restartOn?: string[] | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        command: string;
+        label?: string | undefined;
+        cwd?: string | undefined;
+        env?: Record<string, string> | undefined;
+        color?: string | undefined;
+        restartOn?: string[] | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+    }>, "many">>>;
+    repos: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        id: string;
+        label?: string | undefined;
+    }, {
+        path: string;
+        id: string;
+        label?: string | undefined;
+    }>, "many">>>;
+    docker: z.ZodOptional<z.ZodObject<{
+        composeFile: z.ZodOptional<z.ZodString>;
+        services: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            tail: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            tail: boolean;
+        }, {
+            name: string;
+            tail?: boolean | undefined;
+        }>, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        services: {
+            name: string;
+            tail: boolean;
+        }[];
+        composeFile?: string | undefined;
+    }, {
+        composeFile?: string | undefined;
+        services?: {
+            name: string;
+            tail?: boolean | undefined;
+        }[] | undefined;
+    }>>;
+    highlights: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pattern: z.ZodString;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["info", "warn", "error"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        pattern: string;
+        severity: "info" | "warn" | "error";
+    }, {
+        pattern: string;
+        severity?: "info" | "warn" | "error" | undefined;
+    }>, "many">>>;
+    health: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodString;
+        severity: z.ZodOptional<z.ZodEnum<["ok", "warn", "error"]>>;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodEnum<["startup", "fsevent", "lockfile", "docker"]>, "many">>;
+        url: z.ZodOptional<z.ZodString>;
+        expectStatus: z.ZodOptional<z.ZodNumber>;
+        container: z.ZodOptional<z.ZodString>;
+        port: z.ZodOptional<z.ZodNumber>;
+        host: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        cwd: z.ZodOptional<z.ZodString>;
+        notify: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodObject<{
+            onTransitionTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            onTransitionTo?: string[] | undefined;
+        }, {
+            onTransitionTo?: string[] | undefined;
+        }>]>>;
+        remediation: z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            command: z.ZodString;
+            cwd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            command: string;
+            key: string;
+            cwd?: string | undefined;
+        }, {
+            label: string;
+            command: string;
+            key: string;
+            cwd?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+        label: string;
+        remediation: {
+            label: string;
+            command: string;
+            key: string;
+            cwd?: string | undefined;
+        };
+        path?: string | undefined;
+        command?: string | undefined;
+        cwd?: string | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+        severity?: "warn" | "error" | "ok" | undefined;
+        triggers?: ("startup" | "fsevent" | "lockfile" | "docker")[] | undefined;
+        url?: string | undefined;
+        expectStatus?: number | undefined;
+        container?: string | undefined;
+        port?: number | undefined;
+        host?: string | undefined;
+        args?: string[] | undefined;
+    }, {
+        type: string;
+        id: string;
+        label: string;
+        remediation: {
+            label: string;
+            command: string;
+            key: string;
+            cwd?: string | undefined;
+        };
+        path?: string | undefined;
+        command?: string | undefined;
+        cwd?: string | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+        severity?: "warn" | "error" | "ok" | undefined;
+        triggers?: ("startup" | "fsevent" | "lockfile" | "docker")[] | undefined;
+        url?: string | undefined;
+        expectStatus?: number | undefined;
+        container?: string | undefined;
+        port?: number | undefined;
+        host?: string | undefined;
+        args?: string[] | undefined;
+    }>, "many">>>;
+    help: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        sources: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        defaultPage: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        sources: string[];
+        defaultPage?: string | undefined;
+    }, {
+        sources?: string[] | undefined;
+        defaultPage?: string | undefined;
+    }>>>;
+    notifications: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        onTransitionTo: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        exclude: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        onTransitionTo: string[];
+        enabled: boolean;
+        exclude: string[];
+    }, {
+        onTransitionTo?: string[] | undefined;
+        enabled?: boolean | undefined;
+        exclude?: string[] | undefined;
+    }>>>;
+    mounts: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        hostPath: z.ZodString;
+        containerPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        hostPath: string;
+        containerPath: string;
+    }, {
+        hostPath: string;
+        containerPath: string;
+    }>, "many">>>;
+    /**
+     * Profile-specific config namespace. Each profile owns one key under here
+     * (e.g. `profile.myapp = { ... }`) and validates it with its own zod schema
+     * passed to the loader as `configSchemaExt`.
+     */
+    profile: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    appName: string;
+    watchers: {
+        id: string;
+        command: string;
+        label?: string | undefined;
+        cwd?: string | undefined;
+        env?: Record<string, string> | undefined;
+        color?: string | undefined;
+        restartOn?: string[] | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+    }[];
+    repos: {
+        path: string;
+        id: string;
+        label?: string | undefined;
+    }[];
+    highlights: {
+        pattern: string;
+        severity: "info" | "warn" | "error";
+    }[];
+    health: {
+        type: string;
+        id: string;
+        label: string;
+        remediation: {
+            label: string;
+            command: string;
+            key: string;
+            cwd?: string | undefined;
+        };
+        path?: string | undefined;
+        command?: string | undefined;
+        cwd?: string | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+        severity?: "warn" | "error" | "ok" | undefined;
+        triggers?: ("startup" | "fsevent" | "lockfile" | "docker")[] | undefined;
+        url?: string | undefined;
+        expectStatus?: number | undefined;
+        container?: string | undefined;
+        port?: number | undefined;
+        host?: string | undefined;
+        args?: string[] | undefined;
+    }[];
+    help: {
+        sources: string[];
+        defaultPage?: string | undefined;
+    };
+    notifications: {
+        onTransitionTo: string[];
+        enabled: boolean;
+        exclude: string[];
+    };
+    mounts: {
+        hostPath: string;
+        containerPath: string;
+    }[];
+    profile: Record<string, unknown>;
+    docker?: {
+        services: {
+            name: string;
+            tail: boolean;
+        }[];
+        composeFile?: string | undefined;
+    } | undefined;
+}, {
+    version: number;
+    appName: string;
+    docker?: {
+        composeFile?: string | undefined;
+        services?: {
+            name: string;
+            tail?: boolean | undefined;
+        }[] | undefined;
+    } | undefined;
+    watchers?: {
+        id: string;
+        command: string;
+        label?: string | undefined;
+        cwd?: string | undefined;
+        env?: Record<string, string> | undefined;
+        color?: string | undefined;
+        restartOn?: string[] | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+    }[] | undefined;
+    repos?: {
+        path: string;
+        id: string;
+        label?: string | undefined;
+    }[] | undefined;
+    highlights?: {
+        pattern: string;
+        severity?: "info" | "warn" | "error" | undefined;
+    }[] | undefined;
+    health?: {
+        type: string;
+        id: string;
+        label: string;
+        remediation: {
+            label: string;
+            command: string;
+            key: string;
+            cwd?: string | undefined;
+        };
+        path?: string | undefined;
+        command?: string | undefined;
+        cwd?: string | undefined;
+        notify?: false | {
+            onTransitionTo?: string[] | undefined;
+        } | undefined;
+        severity?: "warn" | "error" | "ok" | undefined;
+        triggers?: ("startup" | "fsevent" | "lockfile" | "docker")[] | undefined;
+        url?: string | undefined;
+        expectStatus?: number | undefined;
+        container?: string | undefined;
+        port?: number | undefined;
+        host?: string | undefined;
+        args?: string[] | undefined;
+    }[] | undefined;
+    help?: {
+        sources?: string[] | undefined;
+        defaultPage?: string | undefined;
+    } | undefined;
+    notifications?: {
+        onTransitionTo?: string[] | undefined;
+        enabled?: boolean | undefined;
+        exclude?: string[] | undefined;
+    } | undefined;
+    mounts?: {
+        hostPath: string;
+        containerPath: string;
+    }[] | undefined;
+    profile?: Record<string, unknown> | undefined;
+}>;
+export type BaseCockpitConfig = z.infer<typeof BaseCockpitConfigSchema>;
+export declare class ConfigVersionError extends Error {
+    readonly filePath: string;
+    readonly found: unknown;
+    readonly supported: number;
+    constructor(filePath: string, found: unknown, supported: number);
+}
+export declare class ConfigValidationError extends Error {
+    readonly filePath: string;
+    readonly cause: unknown;
+    constructor(filePath: string, cause: unknown);
+}
+export interface LoadConfigOptions {
+    /**
+     * Optional zod schema for the profile namespace. If supplied, the loader
+     * validates `profile.<profileKey>` against it and merges the typed result
+     * back into the returned config.
+     */
+    configSchemaExt?: z.ZodObject<z.ZodRawShape>;
+    /**
+     * Profile namespace key under `profile`. Required when `configSchemaExt`
+     * is supplied. Example: `profileKey: 'myapp'` validates `profile.myapp`.
+     */
+    profileKey?: string;
+}
+/**
+ * Loads, parses, and validates a `cockpit.yaml` (or any path the caller chooses).
+ * Throws `ConfigVersionError` if the file's `version` does not match `CONFIG_VERSION`.
+ * Throws `ConfigValidationError` if the schema fails.
+ */
+export declare function loadConfig(filePath: string, opts?: LoadConfigOptions): BaseCockpitConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mFAAmF;AACnF,eAAO,MAAM,cAAc,IAAI,CAAC;AAyFhC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAelC;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,QAAQ,EAAE,MAAM;aAChB,KAAK,EAAE,OAAO;aACd,SAAS,EAAE,MAAM;gBAFjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM;CAOpC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,QAAQ,EAAE,MAAM;aAChB,KAAK,EAAE,OAAO;gBADd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO;CAKjC;AAID,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC7C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,iBAAiB,CA6BnB"}

package/dist/core/config.js

@@ -0,0 +1,152 @@
+import fs from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+import { z } from 'zod';
+/** Schema version constant. Bumps reserved for breaking changes (see ADR 0004). */
+export const CONFIG_VERSION = 1;
+// ─── Sub-schemas ────────────────────────────────────────────────────────────
+const NotifyOverrideSchema = z.union([
+    z.literal(false),
+    z.object({
+        onTransitionTo: z.array(z.string()).optional(),
+    }),
+]);
+const WatcherSchema = z.object({
+    id: z.string(),
+    label: z.string().optional(),
+    command: z.string(),
+    cwd: z.string().optional(),
+    env: z.record(z.string()).optional(),
+    color: z.string().optional(),
+    restartOn: z.array(z.string()).optional(),
+    notify: NotifyOverrideSchema.optional(),
+});
+const RepoSchema = z.object({
+    id: z.string(),
+    path: z.string(),
+    label: z.string().optional(),
+});
+const ServiceSchema = z.object({
+    name: z.string(),
+    tail: z.boolean().optional().default(true),
+});
+const DockerSchema = z.object({
+    composeFile: z.string().optional(),
+    services: z.array(ServiceSchema).optional().default([]),
+});
+const HighlightSchema = z.object({
+    pattern: z.string(),
+    severity: z.enum(['info', 'warn', 'error']).optional().default('info'),
+});
+const RemediationSchema = z.object({
+    key: z.string(),
+    label: z.string(),
+    command: z.string(),
+    cwd: z.string().optional(),
+});
+const TriggerKindSchema = z.enum(['startup', 'fsevent', 'lockfile', 'docker']);
+const HealthCheckSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    type: z.string(),
+    severity: z.enum(['ok', 'warn', 'error']).optional(),
+    triggers: z.array(TriggerKindSchema).optional(),
+    url: z.string().optional(),
+    expectStatus: z.number().int().optional(),
+    container: z.string().optional(),
+    port: z.number().int().optional(),
+    host: z.string().optional(),
+    path: z.string().optional(),
+    command: z.string().optional(),
+    args: z.array(z.string()).optional(),
+    cwd: z.string().optional(),
+    notify: NotifyOverrideSchema.optional(),
+    remediation: RemediationSchema,
+});
+const HelpSchema = z.object({
+    sources: z.array(z.string()).optional().default([]),
+    defaultPage: z.string().optional(),
+});
+const NotificationsSchema = z.object({
+    enabled: z.boolean().optional().default(true),
+    onTransitionTo: z.array(z.string()).optional().default([]),
+    exclude: z.array(z.string()).optional().default([]),
+});
+const MountSchema = z.object({
+    hostPath: z.string(),
+    containerPath: z.string(),
+});
+// ─── Base schema ────────────────────────────────────────────────────────────
+export const BaseCockpitConfigSchema = z.object({
+    version: z.number().int(),
+    appName: z.string(),
+    watchers: z.array(WatcherSchema).optional().default([]),
+    repos: z.array(RepoSchema).optional().default([]),
+    docker: DockerSchema.optional(),
+    highlights: z.array(HighlightSchema).optional().default([]),
+    health: z.array(HealthCheckSchema).optional().default([]),
+    help: HelpSchema.optional().default({ sources: [] }),
+    notifications: NotificationsSchema.optional().default({
+        enabled: true,
+        onTransitionTo: [],
+        exclude: [],
+    }),
+    mounts: z.array(MountSchema).optional().default([]),
+    /**
+     * Profile-specific config namespace. Each profile owns one key under here
+     * (e.g. `profile.myapp = { ... }`) and validates it with its own zod schema
+     * passed to the loader as `configSchemaExt`.
+     */
+    profile: z.record(z.unknown()).optional().default({}),
+});
+// ─── Errors ─────────────────────────────────────────────────────────────────
+export class ConfigVersionError extends Error {
+    filePath;
+    found;
+    supported;
+    constructor(filePath, found, supported) {
+        super(`cockpit config at "${filePath}" declares version ${String(found)}, but this build supports version ${supported}`);
+        this.filePath = filePath;
+        this.found = found;
+        this.supported = supported;
+        this.name = 'ConfigVersionError';
+    }
+}
+export class ConfigValidationError extends Error {
+    filePath;
+    cause;
+    constructor(filePath, cause) {
+        super(`invalid cockpit config at "${filePath}": ${String(cause)}`);
+        this.filePath = filePath;
+        this.cause = cause;
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Loads, parses, and validates a `cockpit.yaml` (or any path the caller chooses).
+ * Throws `ConfigVersionError` if the file's `version` does not match `CONFIG_VERSION`.
+ * Throws `ConfigValidationError` if the schema fails.
+ */
+export function loadConfig(filePath, opts = {}) {
+    if (!fs.existsSync(filePath)) {
+        throw new ConfigValidationError(filePath, 'file does not exist');
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const raw = (parseYaml(content) ?? {});
+    if (typeof raw['version'] !== 'number' || raw['version'] !== CONFIG_VERSION) {
+        throw new ConfigVersionError(filePath, raw['version'], CONFIG_VERSION);
+    }
+    const baseResult = BaseCockpitConfigSchema.safeParse(raw);
+    if (!baseResult.success) {
+        throw new ConfigValidationError(filePath, baseResult.error);
+    }
+    const config = baseResult.data;
+    if (opts.configSchemaExt && opts.profileKey) {
+        const profileBlock = config.profile?.[opts.profileKey] ?? {};
+        const profileResult = opts.configSchemaExt.safeParse(profileBlock);
+        if (!profileResult.success) {
+            throw new ConfigValidationError(filePath, profileResult.error);
+        }
+        config.profile[opts.profileKey] = profileResult.data;
+    }
+    return config;
+}

package/dist/core/logger.d.ts

@@ -0,0 +1,6 @@
+import pino from 'pino';
+export type Logger = pino.Logger;
+export declare function createLogger(logFile: string): Logger;
+export declare function initLogger(logFile: string): Logger;
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AAexB,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;AAEjC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBpD;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC"}

package/dist/core/logger.js

@@ -0,0 +1,38 @@
+import fs from 'node:fs';
+import pino from 'pino';
+const LOG_SIZE_CAP = 10 * 1024 * 1024;
+function rotateIfNeeded(logFile) {
+    try {
+        const stat = fs.statSync(logFile);
+        if (stat.size > LOG_SIZE_CAP) {
+            fs.renameSync(logFile, `${logFile}.1`);
+        }
+    }
+    catch {
+        // File doesn't exist yet — no rotation needed.
+    }
+}
+export function createLogger(logFile) {
+    rotateIfNeeded(logFile);
+    const level = process.env['LOG_LEVEL'] ?? 'info';
+    return pino({ level }, pino.transport({
+        targets: [
+            {
+                target: 'pino/file',
+                level,
+                options: { destination: logFile, mkdir: true },
+            },
+        ],
+    }));
+}
+let _logger = null;
+export function initLogger(logFile) {
+    _logger = createLogger(logFile);
+    return _logger;
+}
+export function getLogger() {
+    if (!_logger) {
+        throw new Error('logger not initialized — call initLogger(logFile) first');
+    }
+    return _logger;
+}

package/dist/core/notifier.d.ts

@@ -0,0 +1,23 @@
+import type { HealthStatus, NotifiableEvent, Transition } from './types.js';
+/** Notifications policy. Generic shape consumed by the notifier. */
+export interface NotificationsConfig {
+    /** Global enable flag. */
+    enabled: boolean;
+    /** Event kinds to suppress (substring matches against `Transition.event`). */
+    exclude: NotifiableEvent[];
+}
+export interface NotifyOptions {
+    config: NotificationsConfig;
+    /** Session toggle (e.g. 'n' keystroke). When false, all notifications are silenced. */
+    sessionEnabled: boolean;
+    /** Prefix for notification titles. Default: 'cockpit'. */
+    appName?: string;
+    /** Injectable OS notifier. Defaults to a detached osascript / notify-send
+     *  spawn. Tests pass a no-op. */
+    sender?: (title: string, message: string) => void;
+}
+export declare function detectTransitions(prev: HealthStatus[], next: HealthStatus[]): Transition[];
+export declare function notify(transition: Transition, opts: NotifyOptions): void;
+export declare function notifyTransitions(prev: HealthStatus[], next: HealthStatus[], opts: NotifyOptions): void;
+export declare function emitEvent(event: NotifiableEvent, label: string, detail: string, opts: NotifyOptions): void;
+//# sourceMappingURL=notifier.d.ts.map

package/dist/core/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/core/notifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5E,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uFAAuF;IACvF,cAAc,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;qCACiC;IACjC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CA4C1F;AAED,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAgBxE;AAwCD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAAE,EACpB,IAAI,EAAE,YAAY,EAAE,EACpB,IAAI,EAAE,aAAa,GAClB,IAAI,CAKN;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,GAClB,IAAI,CAEN"}