dev-cockpit 0.1.0

package/dist/health/remediations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remediations.d.ts","sourceRoot":"","sources":["../../src/health/remediations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,wBAAsB,cAAc,CAClC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,WAAW,EAAE,EACrB,GAAG,EAAE,aAAa,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,WAAW,EAAE,GACpB,WAAW,GAAG,SAAS,CAEzB;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,aAAa,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/health/remediations.js

@@ -0,0 +1,41 @@
+import { spawnStream } from '../core/subprocess.js';
+export async function runRemediation(key, checks, ctx, workspaceRoot) {
+    const check = checks.find((c) => c.remediation.key === key);
+    if (!check)
+        return;
+    await dispatchRemediation(check.remediation, ctx, workspaceRoot, check.id);
+}
+export function findRemediation(key, checks) {
+    return checks.find((c) => c.remediation.key === key);
+}
+export async function dispatchRemediation(remediation, ctx, workspaceRoot, sourceId) {
+    if ('run' in remediation) {
+        await remediation.run(ctx, workspaceRoot);
+        return;
+    }
+    const cmdline = remediation.command.trim();
+    if (!cmdline)
+        return;
+    const parts = cmdline.split(/\s+/);
+    const program = parts[0];
+    if (!program)
+        return;
+    const args = parts.slice(1);
+    const cwd = remediation.cwd ?? workspaceRoot;
+    const handle = spawnStream(program, args, {
+        cwd,
+        onStdout: (line) => ctx.appendOutput?.({
+            ts: Date.now(),
+            source: `health:${sourceId}`,
+            severity: 'info',
+            text: line,
+        }),
+        onStderr: (line) => ctx.appendOutput?.({
+            ts: Date.now(),
+            source: `health:${sourceId}`,
+            severity: 'warn',
+            text: line,
+        }),
+    });
+    await handle.exitCode;
+}

package/dist/health/runner.d.ts

@@ -0,0 +1,4 @@
+import type { HealthCheck, HealthContext, TriggerKind } from './types.js';
+import type { HealthStatus } from '../core/types.js';
+export declare function runChecks(checks: HealthCheck[], triggerSet: TriggerKind[], ctx: HealthContext): Promise<HealthStatus[]>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/health/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/health/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,wBAAsB,SAAS,CAC7B,MAAM,EAAE,WAAW,EAAE,EACrB,UAAU,EAAE,WAAW,EAAE,EACzB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CA4BzB"}

package/dist/health/runner.js

@@ -0,0 +1,22 @@
+export async function runChecks(checks, triggerSet, ctx) {
+    const triggerSetAsSet = new Set(triggerSet);
+    const relevantChecks = checks.filter((check) => check.triggers.some((t) => triggerSetAsSet.has(t)));
+    if (relevantChecks.length === 0) {
+        return [];
+    }
+    const results = await Promise.all(relevantChecks.map(async (check) => {
+        try {
+            return await check.predicate(ctx);
+        }
+        catch (err) {
+            return {
+                id: check.id,
+                label: check.label,
+                severity: 'warn',
+                detail: `check failed with error: ${String(err)}`,
+                remediationKey: check.remediation.key,
+            };
+        }
+    }));
+    return results;
+}

package/dist/health/scheduler.d.ts

@@ -0,0 +1,41 @@
+import type { HealthCheck, HealthContext } from './types.js';
+import type { HealthStatus } from '../core/types.js';
+export interface SchedulerDeps {
+    onHealthUpdate: (statuses: HealthStatus[]) => void;
+    ctx: HealthContext;
+    checks: HealthCheck[];
+    /** Override the fs-event debounce interval (ms). Default: 500. */
+    fsEventDebounceMs?: number;
+    /** Lockfile filenames to recognise. Default: composer.lock, package-lock.json, yarn.lock. */
+    lockfileNames?: string[];
+    /**
+     * Poll interval (ms) for `docker`-triggered checks. Docker has no native
+     * push event from outside the container, and `docker compose down` mid-
+     * session would otherwise leave container-running / port-open checks
+     * stale. Default: 5000. Set to 0 to disable polling.
+     */
+    dockerPollIntervalMs?: number;
+}
+export declare class HealthScheduler {
+    private readonly deps;
+    private readonly debounceMs;
+    private readonly lockfileNames;
+    private readonly dockerPollMs;
+    private fsDebounceTimer;
+    private dockerPollTimer;
+    private running;
+    constructor(deps: SchedulerDeps);
+    start(): Promise<void>;
+    onFsEvent(filePath: string): void;
+    onDockerEvent(): void;
+    /**
+     * Force every registered check to re-run, regardless of triggers. Used
+     * after a remediation completes so the user gets immediate visual
+     * confirmation without waiting for an external fsevent.
+     */
+    runAll(): Promise<void>;
+    stop(): void;
+    private debounceRun;
+    private runTrigger;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/health/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/health/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAe,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACnD,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,aAAa;IAOzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAcjC,aAAa,IAAI,IAAI;IAKrB;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB7B,IAAI,IAAI,IAAI;IAYZ,OAAO,CAAC,WAAW;YAUL,UAAU;CAOzB"}

package/dist/health/scheduler.js

@@ -0,0 +1,107 @@
+import path from 'node:path';
+import { runChecks } from './runner.js';
+const DEFAULT_FSEVENT_DEBOUNCE_MS = 500;
+const DEFAULT_LOCKFILE_NAMES = ['composer.lock', 'package-lock.json', 'yarn.lock'];
+const DEFAULT_DOCKER_POLL_MS = 5000;
+export class HealthScheduler {
+    deps;
+    debounceMs;
+    lockfileNames;
+    dockerPollMs;
+    fsDebounceTimer = null;
+    dockerPollTimer = null;
+    running = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.debounceMs = deps.fsEventDebounceMs ?? DEFAULT_FSEVENT_DEBOUNCE_MS;
+        this.lockfileNames = new Set(deps.lockfileNames ?? DEFAULT_LOCKFILE_NAMES);
+        this.dockerPollMs = deps.dockerPollIntervalMs ?? DEFAULT_DOCKER_POLL_MS;
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        await this.runTrigger(['startup']);
+        // Start the docker poll only if some check actually subscribes to it.
+        // Otherwise we'd waste a setInterval on a no-op. Disable entirely with
+        // dockerPollIntervalMs: 0.
+        const hasDockerChecks = this.deps.checks.some((c) => c.triggers.includes('docker'));
+        if (hasDockerChecks && this.dockerPollMs > 0) {
+            this.dockerPollTimer = setInterval(() => {
+                if (!this.running)
+                    return;
+                void this.runTrigger(['docker']);
+            }, this.dockerPollMs);
+        }
+    }
+    onFsEvent(filePath) {
+        if (!this.running)
+            return;
+        const fileName = path.basename(filePath);
+        const isLockfile = this.lockfileNames.has(fileName);
+        const triggers = ['fsevent'];
+        if (isLockfile) {
+            triggers.push('lockfile');
+        }
+        this.debounceRun(triggers);
+    }
+    onDockerEvent() {
+        if (!this.running)
+            return;
+        this.debounceRun(['docker']);
+    }
+    /**
+     * Force every registered check to re-run, regardless of triggers. Used
+     * after a remediation completes so the user gets immediate visual
+     * confirmation without waiting for an external fsevent.
+     */
+    async runAll() {
+        if (!this.running)
+            return;
+        const { checks, ctx, onHealthUpdate } = this.deps;
+        const results = await Promise.all(checks.map(async (check) => {
+            try {
+                return await check.predicate(ctx);
+            }
+            catch (err) {
+                return {
+                    id: check.id,
+                    label: check.label,
+                    severity: 'warn',
+                    detail: `check failed with error: ${String(err)}`,
+                    remediationKey: check.remediation.key,
+                };
+            }
+        }));
+        if (results.length > 0) {
+            onHealthUpdate(results);
+        }
+    }
+    stop() {
+        this.running = false;
+        if (this.fsDebounceTimer) {
+            clearTimeout(this.fsDebounceTimer);
+            this.fsDebounceTimer = null;
+        }
+        if (this.dockerPollTimer) {
+            clearInterval(this.dockerPollTimer);
+            this.dockerPollTimer = null;
+        }
+    }
+    debounceRun(triggers) {
+        if (this.fsDebounceTimer) {
+            clearTimeout(this.fsDebounceTimer);
+        }
+        this.fsDebounceTimer = setTimeout(() => {
+            this.fsDebounceTimer = null;
+            void this.runTrigger(triggers);
+        }, this.debounceMs);
+    }
+    async runTrigger(triggers) {
+        const { checks, ctx, onHealthUpdate } = this.deps;
+        const results = await runChecks(checks, triggers, ctx);
+        if (results.length > 0) {
+            onHealthUpdate(results);
+        }
+    }
+}

package/dist/health/types.d.ts

@@ -0,0 +1,73 @@
+import type { Severity, HealthStatus, NotifiableEvent } from '../core/types.js';
+export type TriggerKind = 'startup' | 'fsevent' | 'lockfile' | 'docker';
+export interface FsHelpers {
+    existsSync: (p: string) => boolean;
+    statSync: (p: string) => {
+        mtimeMs: number;
+    };
+    readdirSync: (p: string, opts?: {
+        withFileTypes?: boolean;
+    }) => Array<{
+        name: string;
+        isDirectory(): boolean;
+    } | string>;
+}
+export type ExecHelper = (cmd: string, args: string[], cwd?: string) => Promise<{
+    stdout: string;
+    exitCode: number;
+}>;
+export interface HealthOutputLine {
+    ts: number;
+    source: string;
+    severity: 'info' | 'warn' | 'error';
+    text: string;
+}
+export interface HealthContext {
+    workspaceRoot: string;
+    fs: FsHelpers;
+    exec: ExecHelper;
+    appendOutput?: (line: HealthOutputLine) => void;
+}
+export type NotifyPolicy = false | {
+    onTransitionTo?: NotifiableEvent[];
+};
+export type Remediation = {
+    key: string;
+    label: string;
+    command: string;
+    cwd?: string;
+} | {
+    key: string;
+    label: string;
+    run: (ctx: HealthContext, workspaceRoot: string) => Promise<void>;
+};
+export interface HealthCheck {
+    id: string;
+    label: string;
+    severity: Severity;
+    triggers: TriggerKind[];
+    predicate: (ctx: HealthContext) => Promise<HealthStatus>;
+    remediation: Remediation;
+    notify?: NotifyPolicy;
+}
+export interface HealthCheckConfig {
+    id: string;
+    label: string;
+    type: string;
+    severity?: Severity;
+    triggers?: TriggerKind[];
+    remediation: Remediation;
+    notify?: NotifyPolicy;
+    container?: string;
+    port?: number;
+    host?: string;
+    url?: string;
+    expectStatus?: number;
+    path?: string;
+    command?: string;
+    args?: string[];
+    cwd?: string;
+}
+export type BuiltinCheckType = 'container-running' | 'port-open' | 'http-ok' | 'file-exists' | 'exec-zero';
+export type CheckPredicateFactory = (entry: HealthCheckConfig) => HealthCheck['predicate'];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/health/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,EAAE,CACX,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KAC/B,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,IAAI,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,CAAC,EAAE,MAAM,KACT,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG;IAAE,cAAc,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,WAAW,GACnB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,WAAW,GACX,SAAS,GACT,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,WAAW,CAAC,WAAW,CAAC,CAAC"}

package/dist/health/types.js

@@ -0,0 +1 @@
+export {};

package/dist/health/useHealth.d.ts

@@ -0,0 +1,40 @@
+import type { RemediationDispatch } from '../cockpit/hooks/useGlobalKeys.js';
+import { type NotificationsConfig } from '../core/notifier.js';
+import type { HealthStatus } from '../core/types.js';
+import type { HealthCheck, HealthCheckConfig, HealthContext } from './types.js';
+/** Subset of WatcherManager surface that useHealth depends on. */
+export interface FsEventSource {
+    /** Setter the cockpit can call when a watcher reports a file event. */
+    registerFsEventListener?: (listener: (path: string) => void) => () => void;
+}
+export interface UseHealthOptions {
+    /** Working directory injected into the HealthContext. */
+    workspaceRoot: string;
+    /** Pre-built checks contributed by the active profile. */
+    profileChecks?: HealthCheck[];
+    /** Config-driven entries (from cockpit.yaml `health[]`). */
+    configEntries?: HealthCheckConfig[];
+    /** Caller-built HealthContext. If omitted, a default is constructed lazily. */
+    ctx?: HealthContext;
+    /** Notification policy (global). */
+    notifications: NotificationsConfig;
+    /** Used in notification titles. Defaults to 'cockpit'. */
+    appName?: string;
+    /** Inject an alternate OS notifier (tests pass a no-op). */
+    notificationSender?: (title: string, message: string) => void;
+    /**
+     * fs-event source. Pass a function that subscribes a listener and returns an
+     * unsubscribe callback. Typically wired to WatcherManager.
+     */
+    subscribeFsEvents?: (listener: (filePath: string) => void) => () => void;
+    /**
+     * Optional callback fired after every check run, before the store is updated.
+     * Useful for tests + advanced consumers who want to peek.
+     */
+    onResults?: (statuses: HealthStatus[]) => void;
+}
+export interface UseHealthHandle {
+    runRemediation: (key: string) => RemediationDispatch | null;
+}
+export declare function useHealth(opts: UseHealthOptions | undefined): UseHealthHandle | null;
+//# sourceMappingURL=useHealth.d.ts.map

package/dist/health/useHealth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHealth.d.ts","sourceRoot":"","sources":["../../src/health/useHealth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhF,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,uBAAuB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACpC,+EAA+E;IAC/E,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,oCAAoC;IACpC,aAAa,EAAE,mBAAmB,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACzE;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,mBAAmB,GAAG,IAAI,CAAC;CAC7D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,GAAG,eAAe,GAAG,IAAI,CA4FpF"}

package/dist/health/useHealth.js

@@ -0,0 +1,122 @@
+import { useEffect, useMemo, useRef } from 'react';
+import { cockpitStore } from '../cockpit/state/store.js';
+import { detectTransitions, notify } from '../core/notifier.js';
+import { HealthScheduler } from './scheduler.js';
+import { runRemediation as dispatchRemediationKey } from './remediations.js';
+import { resolveNotify } from './notify-resolver.js';
+import { buildHealthRegistry } from './registry.js';
+import { buildHealthContext } from './context.js';
+export function useHealth(opts) {
+    const checks = useMemo(() => {
+        if (!opts)
+            return [];
+        return buildHealthRegistry({
+            profileChecks: opts.profileChecks,
+            configEntries: opts.configEntries,
+        });
+    }, [opts]);
+    const checksRef = useRef(checks);
+    const ctxRef = useRef(opts?.ctx);
+    const optsRef = useRef(opts);
+    const schedulerRef = useRef(null);
+    // Keep refs current so the orchestration loop sees latest options without
+    // requiring full teardown on prop churn.
+    useEffect(() => {
+        checksRef.current = checks;
+        ctxRef.current = opts?.ctx;
+        optsRef.current = opts;
+    }, [checks, opts]);
+    useEffect(() => {
+        if (!opts)
+            return;
+        if (checks.length === 0)
+            return;
+        const scheduler = new HealthScheduler({
+            checks,
+            ctx: opts.ctx ?? buildDefaultCtx(opts.workspaceRoot),
+            onHealthUpdate: (statuses) => {
+                // Trigger-scoped runs (fsevent, lockfile, docker) produce only the
+                // statuses for checks subscribed to that trigger. If we replaced the
+                // full array with the partial set, every other check's last-known
+                // state would be wiped on each poll. Merge by id, replacing any
+                // existing entry with the new value while preserving the rest.
+                const prev = cockpitStore.getState().health;
+                const merged = mergeHealthStatuses(prev, statuses);
+                const transitions = detectTransitions(prev, statuses);
+                const sessionEnabled = cockpitStore.getState().notificationsEnabledSession;
+                for (const t of transitions) {
+                    const owner = checksRef.current.find((c) => c.id === t.id);
+                    if (!resolveNotify(t, opts.notifications, owner?.notify))
+                        continue;
+                    notify(t, {
+                        config: opts.notifications,
+                        sessionEnabled,
+                        appName: opts.appName ?? 'cockpit',
+                        sender: opts.notificationSender,
+                    });
+                }
+                cockpitStore.getState().setHealth(merged);
+                opts.onResults?.(merged);
+            },
+        });
+        schedulerRef.current = scheduler;
+        void scheduler.start();
+        const unsub = opts.subscribeFsEvents?.((filePath) => scheduler.onFsEvent(filePath));
+        return () => {
+            unsub?.();
+            scheduler.stop();
+            schedulerRef.current = null;
+        };
+    }, [checks]);
+    if (!opts)
+        return null;
+    return {
+        runRemediation: (key) => {
+            const list = checksRef.current;
+            const ctx = ctxRef.current ?? buildDefaultCtx(optsRef.current?.workspaceRoot ?? '.');
+            const check = list.find((c) => c.remediation.key === key);
+            if (!check)
+                return null;
+            const promise = dispatchRemediationKey(key, list, ctx, optsRef.current?.workspaceRoot ?? '.').finally(() => {
+                // Re-run all checks after the remediation completes so the user sees
+                // the new state immediately, without waiting for an external fsevent.
+                void schedulerRef.current?.runAll();
+            });
+            return {
+                label: check.remediation.label,
+                promise,
+                healthId: check.id,
+                healthLabel: check.label,
+            };
+        },
+    };
+}
+function buildDefaultCtx(workspaceRoot) {
+    return buildHealthContext(workspaceRoot);
+}
+/**
+ * Merge a partial set of fresh statuses into the previous full array,
+ * preserving original order and updating any entry whose id matches.
+ * Statuses present in `next` but not in `prev` are appended at the end —
+ * shouldn't happen during normal operation (the registry is fixed) but
+ * keeps the function total.
+ */
+function mergeHealthStatuses(prev, next) {
+    if (next.length === 0)
+        return prev;
+    const byId = new Map();
+    for (const s of next)
+        byId.set(s.id, s);
+    const merged = [];
+    const seen = new Set();
+    for (const s of prev) {
+        const updated = byId.get(s.id);
+        merged.push(updated ?? s);
+        seen.add(s.id);
+    }
+    for (const s of next) {
+        if (!seen.has(s.id))
+            merged.push(s);
+    }
+    return merged;
+}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+export type { Severity, HealthStatus, Transition, NotifiableEvent, BuiltinNotifiableEvent, Watcher, Service, Repo, Mount, HelpSource, Workspace, Profile, ProfileBootContext, ProfileBootResult, ProfileBootHook, ProfileCockpitHandlers, ProfileAsyncActionDispatch, RepoState, RepoStatus, RepoKind, LintStatus, } from './core/types.js';
+export type { TriggerKind, FsHelpers, ExecHelper, HealthOutputLine, HealthContext, NotifyPolicy, Remediation, HealthCheck, HealthCheckConfig, BuiltinCheckType, CheckPredicateFactory, } from './health/types.js';
+export { hashWorkspacePath, getStatePaths, type StatePaths, type StatePathsOptions, } from './core/paths.js';
+export { createLogger, initLogger, getLogger, type Logger } from './core/logger.js';
+export { spawnStream, killAllSpawned, type ProcessHandle, type SpawnOptions, } from './core/subprocess.js';
+export { detectTransitions, notify, notifyTransitions, emitEvent, type NotificationsConfig, type NotifyOptions, } from './core/notifier.js';
+export { CONFIG_VERSION, loadConfig, BaseCockpitConfigSchema, ConfigValidationError, ConfigVersionError, type BaseCockpitConfig, type LoadConfigOptions, } from './core/config.js';
+export { Command } from 'commander';
+export type { Command as CommanderCommand } from 'commander';
+export { z } from 'zod';
+export { Cockpit, type CockpitProps } from './cockpit/Cockpit.js';
+export { TabBar } from './cockpit/TabBar.js';
+export { Footer, type FooterLegends, type FooterProps } from './cockpit/Footer.js';
+export { Repos } from './cockpit/panes/Repos.js';
+export { Output } from './cockpit/panes/Output.js';
+export { Health } from './cockpit/panes/Health.js';
+export { Help } from './cockpit/panes/Help.js';
+export { FilterModal } from './cockpit/panes/FilterModal.js';
+export { SearchModal } from './cockpit/panes/SearchModal.js';
+export { TAB_ORDER, TAB_LABELS } from './cockpit/tab-state.js';
+export { cockpitStore, type CockpitState, type FocusTarget, type OutputLine, type OutputFilter, type RecentError, type HelpConfig, type OnTransitionCallback, } from './cockpit/state/store.js';
+export { useCockpitStore } from './cockpit/hooks/useCockpitStore.js';
+export { useGlobalKeys, type UseGlobalKeysOptions, type AsyncActionDispatch, type RemediationDispatch, } from './cockpit/hooks/useGlobalKeys.js';
+export { loadHelpPages, resolveDocsRoot, parseIndex, loadPagesFromDir, type HelpSourceInput, type LoadHelpPagesOptions, type LoadHelpPagesResult, } from './cockpit/help/loader.js';
+export type { HelpPage } from './cockpit/help/types.js';
+export { renderMarkdown } from './cockpit/help/renderer.js';
+export { FALLBACK_PAGE } from './cockpit/help/content.js';
+export { compileHighlights, matchHighlights, DEFAULT_HIGHLIGHT_PATTERNS, type HighlightMatch, type HighlightSeverity, type CompiledHighlights, } from './docker/highlights.js';
+export { extractFileLine, type FileLine } from './docker/stack-trace.js';
+export { restartDockerService, type RestartDockerDeps } from './docker/restart.js';
+export { DockerLogTailer, DEBOUNCE_MS as DOCKER_NOTIFY_DEBOUNCE_MS, SILENT_THRESHOLD_MS as DOCKER_SILENT_THRESHOLD_MS, type DockerLogTailerOptions, } from './docker/logs.js';
+export { WatcherManager, type WatcherManagerDeps, type ManagedRepo, } from './watchers/manager.js';
+export { mapPathToRepo, type RepoPrefixEntry } from './watchers/path-mapper.js';
+export type { NormalizedRepoConfig } from './watchers/types.js';
+export { scheduleLint, runAllLints, selectLintCommand, type LintRunnerOptions, } from './lint/reactive.js';
+export { runChecks } from './health/runner.js';
+export { HealthScheduler, type SchedulerDeps } from './health/scheduler.js';
+export { buildHealthContext } from './health/context.js';
+export { runRemediation, findRemediation, dispatchRemediation, type RemediationKey, } from './health/remediations.js';
+export { BUILTIN_CHECK_FACTORIES, BUILTIN_DEFAULT_TRIGGERS, BUILTIN_DEFAULT_SEVERITY, } from './health/builtin.js';
+export { buildHealthRegistry, type BuildHealthRegistryOptions, } from './health/registry.js';
+export { resolveNotify } from './health/notify-resolver.js';
+export { useHealth, type UseHealthOptions, type UseHealthHandle, type FsEventSource, } from './health/useHealth.js';
+export { runCockpit, type RunCockpitOptions, type RunCockpitHandle } from './runCockpit.js';
+export { buildCli, type BuildCliOptions } from './buildCli.js';
+export { devCommand, type DevCommandOptions } from './commands/dev.js';
+export { doctorCommand, formatResults, type DoctorCommandOptions, } from './commands/doctor.js';
+export { initConfigCommand, buildTemplate, type InitConfigOptions, type InitConfigResult, } from './commands/init-config.js';
+export { mountCommand, mountStatusCommand, mountClearCommand, mergeMounts, renderOverlay, type MountCommandOptions, type MountManifest, } from './commands/mount.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,53 @@
+// ─── Core runtime exports ───────────────────────────────────────────────────
+export { hashWorkspacePath, getStatePaths, } from './core/paths.js';
+export { createLogger, initLogger, getLogger } from './core/logger.js';
+export { spawnStream, killAllSpawned, } from './core/subprocess.js';
+export { detectTransitions, notify, notifyTransitions, emitEvent, } from './core/notifier.js';
+export { CONFIG_VERSION, loadConfig, BaseCockpitConfigSchema, ConfigValidationError, ConfigVersionError, } from './core/config.js';
+// ─── Re-exported third-party types/values ──────────────────────────────────
+export { Command } from 'commander';
+export { z } from 'zod';
+// ─── Cockpit shell ──────────────────────────────────────────────────────────
+export { Cockpit } from './cockpit/Cockpit.js';
+export { TabBar } from './cockpit/TabBar.js';
+export { Footer } from './cockpit/Footer.js';
+export { Repos } from './cockpit/panes/Repos.js';
+export { Output } from './cockpit/panes/Output.js';
+export { Health } from './cockpit/panes/Health.js';
+export { Help } from './cockpit/panes/Help.js';
+export { FilterModal } from './cockpit/panes/FilterModal.js';
+export { SearchModal } from './cockpit/panes/SearchModal.js';
+export { TAB_ORDER, TAB_LABELS } from './cockpit/tab-state.js';
+export { cockpitStore, } from './cockpit/state/store.js';
+export { useCockpitStore } from './cockpit/hooks/useCockpitStore.js';
+export { useGlobalKeys, } from './cockpit/hooks/useGlobalKeys.js';
+// ─── Help loader / renderer ─────────────────────────────────────────────────
+export { loadHelpPages, resolveDocsRoot, parseIndex, loadPagesFromDir, } from './cockpit/help/loader.js';
+export { renderMarkdown } from './cockpit/help/renderer.js';
+export { FALLBACK_PAGE } from './cockpit/help/content.js';
+// ─── Docker subsystem ───────────────────────────────────────────────────────
+export { compileHighlights, matchHighlights, DEFAULT_HIGHLIGHT_PATTERNS, } from './docker/highlights.js';
+export { extractFileLine } from './docker/stack-trace.js';
+export { restartDockerService } from './docker/restart.js';
+export { DockerLogTailer, DEBOUNCE_MS as DOCKER_NOTIFY_DEBOUNCE_MS, SILENT_THRESHOLD_MS as DOCKER_SILENT_THRESHOLD_MS, } from './docker/logs.js';
+// ─── Watchers + lint ────────────────────────────────────────────────────────
+export { WatcherManager, } from './watchers/manager.js';
+export { mapPathToRepo } from './watchers/path-mapper.js';
+export { scheduleLint, runAllLints, selectLintCommand, } from './lint/reactive.js';
+// ─── Health framework ──────────────────────────────────────────────────────
+export { runChecks } from './health/runner.js';
+export { HealthScheduler } from './health/scheduler.js';
+export { buildHealthContext } from './health/context.js';
+export { runRemediation, findRemediation, dispatchRemediation, } from './health/remediations.js';
+export { BUILTIN_CHECK_FACTORIES, BUILTIN_DEFAULT_TRIGGERS, BUILTIN_DEFAULT_SEVERITY, } from './health/builtin.js';
+export { buildHealthRegistry, } from './health/registry.js';
+export { resolveNotify } from './health/notify-resolver.js';
+export { useHealth, } from './health/useHealth.js';
+// ─── Boot entry ─────────────────────────────────────────────────────────────
+export { runCockpit } from './runCockpit.js';
+// ─── CLI builder + commands ────────────────────────────────────────────────
+export { buildCli } from './buildCli.js';
+export { devCommand } from './commands/dev.js';
+export { doctorCommand, formatResults, } from './commands/doctor.js';
+export { initConfigCommand, buildTemplate, } from './commands/init-config.js';
+export { mountCommand, mountStatusCommand, mountClearCommand, mergeMounts, renderOverlay, } from './commands/mount.js';

package/dist/ink.d.ts

@@ -0,0 +1,3 @@
+export { Box, Text, render, useApp, useInput, useFocus, useFocusManager, useStdout, useStderr, useStdin, Static, Newline, Spacer, Transform } from 'ink';
+export type { BoxProps, TextProps, RenderOptions, Instance, AppProps } from 'ink';
+//# sourceMappingURL=ink.d.ts.map

package/dist/ink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ink.d.ts","sourceRoot":"","sources":["../src/ink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACzJ,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC"}

package/dist/ink.js

@@ -0,0 +1 @@
+export { Box, Text, render, useApp, useInput, useFocus, useFocusManager, useStdout, useStderr, useStdin, Static, Newline, Spacer, Transform } from 'ink';