@cyanautomation/kaseki-agent 1.62.1 → 1.64.1

package/dist/config/ConfigManager.d.ts

@@ -180,14 +180,14 @@ declare const ConfigSchema: z.ZodObject<{
         port?: number | undefined;
         base_url?: string | undefined;
         key?: string | undefined;
-        log_level?: "error" | "debug" | "info" | "warn" | undefined;
+        log_level?: "error" | "info" | "debug" | "warn" | undefined;
         max_concurrent_runs?: number | undefined;
     }, {
         keys?: string[] | undefined;
         port?: number | undefined;
         base_url?: string | undefined;
         key?: string | undefined;
-        log_level?: "error" | "debug" | "info" | "warn" | undefined;
+        log_level?: "error" | "info" | "debug" | "warn" | undefined;
         max_concurrent_runs?: number | undefined;
     }>>;
     directories: z.ZodOptional<z.ZodObject<{
@@ -294,7 +294,7 @@ declare const ConfigSchema: z.ZodObject<{
         port?: number | undefined;
         base_url?: string | undefined;
         key?: string | undefined;
-        log_level?: "error" | "debug" | "info" | "warn" | undefined;
+        log_level?: "error" | "info" | "debug" | "warn" | undefined;
         max_concurrent_runs?: number | undefined;
     } | undefined;
     directories?: {
@@ -371,7 +371,7 @@ declare const ConfigSchema: z.ZodObject<{
         port?: number | undefined;
         base_url?: string | undefined;
         key?: string | undefined;
-        log_level?: "error" | "debug" | "info" | "warn" | undefined;
+        log_level?: "error" | "info" | "debug" | "warn" | undefined;
         max_concurrent_runs?: number | undefined;
     } | undefined;
     directories?: {

package/dist/kaseki-api/npm-version.d.ts

@@ -0,0 +1,19 @@
+/**
+ * NPM Version Detection
+ *
+ * Detects the npm version installed in the container.
+ * Falls back gracefully to 'unknown' if detection fails.
+ *
+ * @returns npm version string (e.g., "10.2.4") or "unknown" on failure
+ */
+/**
+ * Get the installed npm version
+ *
+ * Uses process.versions.npm first (fast, no subprocess),
+ * falls back to `npm --version` command if that's unavailable,
+ * and gracefully returns 'unknown' if both fail.
+ *
+ * @returns Promise<string> - npm version or 'unknown'
+ */
+export declare function getNpmVersion(): Promise<string>;
+//# sourceMappingURL=npm-version.d.ts.map

package/dist/kaseki-api/npm-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-version.d.ts","sourceRoot":"","sources":["../../src/kaseki-api/npm-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;GAQG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAyBrD"}

package/dist/kaseki-api/npm-version.js

@@ -0,0 +1,43 @@
+/**
+ * NPM Version Detection
+ *
+ * Detects the npm version installed in the container.
+ * Falls back gracefully to 'unknown' if detection fails.
+ *
+ * @returns npm version string (e.g., "10.2.4") or "unknown" on failure
+ */
+import { execSync } from 'child_process';
+/**
+ * Get the installed npm version
+ *
+ * Uses process.versions.npm first (fast, no subprocess),
+ * falls back to `npm --version` command if that's unavailable,
+ * and gracefully returns 'unknown' if both fail.
+ *
+ * @returns Promise<string> - npm version or 'unknown'
+ */
+export async function getNpmVersion() {
+    // Try process.versions.npm first (should be available in Node.js with npm)
+    // This is fast and requires no subprocess
+    if (process.versions.npm) {
+        return process.versions.npm;
+    }
+    // Fallback: try `npm --version` command
+    try {
+        const version = execSync('npm --version', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 5000,
+        }).trim();
+        // Validate it looks like a version (basic sanity check)
+        if (version && /^\d+\.\d+\.\d+/.test(version)) {
+            return version;
+        }
+    }
+    catch {
+        // npm command failed or timed out; silently fall through
+    }
+    // Graceful fallback: don't break startup, just indicate version is unknown
+    return 'unknown';
+}
+//# sourceMappingURL=npm-version.js.map

package/dist/kaseki-api/npm-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-version.js","sourceRoot":"","sources":["../../src/kaseki-api/npm-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,2EAA2E;IAC3E,0CAA0C;IAC1C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IAC9B,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,EAAE;YACxC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,wDAAwD;QACxD,IAAI,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IAED,2EAA2E;IAC3E,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/kaseki-api/service-bootstrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-bootstrapper.d.ts","sourceRoot":"","sources":["../../src/kaseki-api/service-bootstrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,WAAW,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,SAAS,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC1C,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAgF/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDxE"}
+{"version":3,"file":"service-bootstrapper.d.ts","sourceRoot":"","sources":["../../src/kaseki-api/service-bootstrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,WAAW,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,SAAS,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC1C,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACjD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAoH/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDxE"}

package/dist/kaseki-api/service-bootstrapper.js

@@ -20,47 +20,77 @@ const logger = createEventLogger('service-bootstrapper');
  * @throws Error with context if any service initialization fails
  */
 export async function bootstrapServices(config) {
+    const bootstrapStartTime = performance.now();
     logger.info('Starting service bootstrap');
     const cleanupTasks = [];
+    const componentTimings = [];
     try {
         // 1. Create artifact cache (no dependencies)
+        const cacheStartTime = performance.now();
         logger.info('Initializing ResultCache');
         const artifactCache = new ResultCache({
             maxEntries: config.artifactCacheMaxEntries,
             ttlMs: config.artifactCacheTtlMs,
             maxFileBytes: config.artifactCacheMaxFileBytes,
         });
-        logger.info('ResultCache initialized');
+        const cacheDuration = performance.now() - cacheStartTime;
+        componentTimings.push({ name: 'ResultCache', durationMs: cacheDuration });
+        logger.info(`ResultCache initialized (${cacheDuration.toFixed(1)}ms)`);
         cleanupTasks.push({
             name: 'ResultCache',
             run: () => artifactCache.clearAll(),
         });
         // 2. Create webhook manager (depends on: resultsDir)
+        const webhookStartTime = performance.now();
         logger.info('Initializing WebhookManager');
         const webhookManager = new WebhookManager(config.resultsDir);
-        logger.info('WebhookManager initialized');
+        const webhookDuration = performance.now() - webhookStartTime;
+        componentTimings.push({ name: 'WebhookManager', durationMs: webhookDuration });
+        logger.info(`WebhookManager initialized (${webhookDuration.toFixed(1)}ms)`);
         cleanupTasks.push({
             name: 'WebhookManager',
             run: () => webhookManager.shutdown(),
         });
         // 3. Create idempotency store (depends on: resultsDir)
+        const idempotencyStartTime = performance.now();
         logger.info('Initializing IdempotencyStore');
         const idempotencyStore = new IdempotencyStore(config.resultsDir, 24);
-        logger.info('IdempotencyStore initialized');
+        const idempotencyDuration = performance.now() - idempotencyStartTime;
+        componentTimings.push({ name: 'IdempotencyStore', durationMs: idempotencyDuration });
+        logger.info(`IdempotencyStore initialized (${idempotencyDuration.toFixed(1)}ms)`);
         cleanupTasks.push({
             name: 'IdempotencyStore',
             run: () => idempotencyStore.shutdown(),
         });
         // 4. Create pre-flight validator (no dependencies)
+        const validatorStartTime = performance.now();
         logger.info('Initializing PreFlightValidator');
         const preFlightValidator = new PreFlightValidator();
-        logger.info('PreFlightValidator initialized');
+        const validatorDuration = performance.now() - validatorStartTime;
+        componentTimings.push({ name: 'PreFlightValidator', durationMs: validatorDuration });
+        logger.info(`PreFlightValidator initialized (${validatorDuration.toFixed(1)}ms)`);
         // 5. Create scheduler (depends on: config, webhookManager, artifactCache)
+        const schedulerStartTime = performance.now();
         logger.info('Initializing JobScheduler');
         const scheduler = new JobScheduler(config, webhookManager, artifactCache);
         await scheduler.ready();
-        logger.info('JobScheduler initialized');
-        logger.info('Service bootstrap complete');
+        const schedulerDuration = performance.now() - schedulerStartTime;
+        componentTimings.push({ name: 'JobScheduler', durationMs: schedulerDuration });
+        logger.info(`JobScheduler initialized (${schedulerDuration.toFixed(1)}ms)`);
+        // Detect slow components and warn
+        const slowComponentThreshold = 1000; // 1 second
+        const slowComponents = componentTimings.filter(c => c.durationMs > slowComponentThreshold);
+        if (slowComponents.length > 0) {
+            logger.warn('Slow component initialization detected during bootstrap:', {
+                slowComponents: slowComponents.map(c => `${c.name} (${c.durationMs.toFixed(1)}ms)`),
+            });
+        }
+        const totalBootstrapDuration = performance.now() - bootstrapStartTime;
+        logger.info('Service bootstrap complete', {
+            totalDurationMs: totalBootstrapDuration.toFixed(1),
+            componentCount: componentTimings.length,
+            components: componentTimings,
+        });
         return {
             artifactCache,
             webhookManager,
@@ -85,7 +115,11 @@ export async function bootstrapServices(config) {
             }
         }
         const errorMessage = err instanceof Error ? err.message : String(err);
-        logger.error('Failed to bootstrap services', { error: errorMessage });
+        const totalBootstrapDuration = performance.now() - bootstrapStartTime;
+        logger.error('Failed to bootstrap services', {
+            error: errorMessage,
+            durationMs: totalBootstrapDuration.toFixed(1),
+        });
         throw new Error(`Service bootstrap failed: ${errorMessage}`, {
             cause: err,
         });

package/dist/kaseki-api/service-bootstrapper.js.map

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

package/dist/kaseki-api/startup-health-reporter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Startup Health Reporter
+ *
+ * Consolidates bootstrap timing, preflight checks, and environment data
+ * into a unified health report for external monitoring and user visibility
+ */
+import type { PreflightCheck, StartupHealthReport, StartupIssue } from '../kaseki-api-types';
+/**
+ * Categorizes preflight check failures into startup issues
+ * Groups by severity and includes remediation information
+ *
+ * @param checks - Array of preflight check results
+ * @returns Array of StartupIssue objects categorized by severity
+ */
+export declare function categorizeStartupIssues(checks: PreflightCheck[]): StartupIssue[];
+/**
+ * Generates a unified startup health report
+ *
+ * @param bootstrapDurationMs - Time to bootstrap all services
+ * @param preflightDurationMs - Time to run preflight checks
+ * @param preflight Checks - Array of preflight check results
+ * @param componentTimings - Map of component name to duration in ms
+ * @returns StartupHealthReport with consolidated health data
+ */
+export declare function generateStartupHealthReport(bootstrapDurationMs: number, preflightDurationMs: number, preflightChecks: PreflightCheck[], componentTimings?: Record<string, number>): StartupHealthReport;
+/**
+ * Converts health report to human-readable markdown
+ */
+export declare function healthReportToMarkdown(report: StartupHealthReport): string;
+//# sourceMappingURL=startup-health-reporter.d.ts.map

package/dist/kaseki-api/startup-health-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-health-reporter.d.ts","sourceRoot":"","sources":["../../src/kaseki-api/startup-health-reporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE7F;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAgBhF;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,MAAM,EAC3B,eAAe,EAAE,cAAc,EAAE,EACjC,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC5C,mBAAmB,CAsDrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAuD1E"}

package/dist/kaseki-api/startup-health-reporter.js

@@ -0,0 +1,174 @@
+/**
+ * Startup Health Reporter
+ *
+ * Consolidates bootstrap timing, preflight checks, and environment data
+ * into a unified health report for external monitoring and user visibility
+ */
+/**
+ * Categorizes preflight check failures into startup issues
+ * Groups by severity and includes remediation information
+ *
+ * @param checks - Array of preflight check results
+ * @returns Array of StartupIssue objects categorized by severity
+ */
+export function categorizeStartupIssues(checks) {
+    const failedChecks = checks.filter(check => !check.ok);
+    return failedChecks.map(check => {
+        const severity = determineSeverity(check.name);
+        const autoFixable = isAutoFixable(check.name);
+        return {
+            severity,
+            component: check.name,
+            detail: check.detail || 'Check failed',
+            remediation: check.remediation,
+            autoFixable,
+            timestamp: new Date().toISOString(),
+        };
+    });
+}
+/**
+ * Determines severity level based on check type
+ */
+function determineSeverity(checkName) {
+    const blockingChecks = [
+        'setup-completeness',
+        'secrets-readable',
+        'checkout-exists',
+    ];
+    if (blockingChecks.includes(checkName)) {
+        return 'blocking';
+    }
+    // Most preflight checks are warnings (non-blocking)
+    return 'warning';
+}
+/**
+ * Determines if an issue can be auto-fixed
+ */
+function isAutoFixable(checkName) {
+    const autoFixableChecks = ['git-safe-directory'];
+    return autoFixableChecks.includes(checkName);
+}
+/**
+ * Generates a unified startup health report
+ *
+ * @param bootstrapDurationMs - Time to bootstrap all services
+ * @param preflightDurationMs - Time to run preflight checks
+ * @param preflight Checks - Array of preflight check results
+ * @param componentTimings - Map of component name to duration in ms
+ * @returns StartupHealthReport with consolidated health data
+ */
+export function generateStartupHealthReport(bootstrapDurationMs, preflightDurationMs, preflightChecks, componentTimings = {}) {
+    const issues = categorizeStartupIssues(preflightChecks);
+    // Build component timing info
+    const components = {};
+    const slowComponentThreshold = 1000; // 1 second
+    for (const [name, durationMs] of Object.entries(componentTimings)) {
+        const status = durationMs > slowComponentThreshold ? 'warning' : 'ok';
+        const reason = durationMs > slowComponentThreshold ? 'slow_init' : undefined;
+        components[name] = {
+            name,
+            durationMs,
+            status,
+            ...(reason && { reason }),
+        };
+    }
+    // Build preflight check summary
+    const preflight = {};
+    const passedChecks = preflightChecks.filter(c => c.ok);
+    for (const check of preflightChecks) {
+        preflight[check.name] = {
+            ok: check.ok,
+            ...(check.elapsedMs && { elapsedMs: check.elapsedMs }),
+            ...(check.detail && { detail: check.detail }),
+        };
+    }
+    const totalMs = bootstrapDurationMs + preflightDurationMs;
+    // Determine overall status
+    const blockingIssues = issues.filter(i => i.severity === 'blocking');
+    const status = blockingIssues.length > 0 ? 'error' : issues.length > 0 ? 'degraded' : 'ok';
+    return {
+        timestamp: new Date().toISOString(),
+        status,
+        summary: {
+            passed: passedChecks.length,
+            warnings: issues.filter(i => i.severity === 'warning').length,
+            blocking: blockingIssues.length,
+        },
+        timing: {
+            bootstrapMs: Math.round(bootstrapDurationMs),
+            preflightMs: Math.round(preflightDurationMs),
+            totalMs: Math.round(totalMs),
+        },
+        components: components,
+        preflight,
+        issues,
+    };
+}
+/**
+ * Converts health report to human-readable markdown
+ */
+export function healthReportToMarkdown(report) {
+    const lines = [];
+    lines.push('# Startup Health Report\n');
+    lines.push(`**Status:** ${getStatusEmoji(report.status)} ${report.status.toUpperCase()}\n`);
+    lines.push('## Summary');
+    lines.push(`- Passed: ${report.summary.passed}`);
+    lines.push(`- Warnings: ${report.summary.warnings}`);
+    lines.push(`- Blocking Issues: ${report.summary.blocking}\n`);
+    lines.push('## Timing');
+    lines.push(`- Bootstrap: ${report.timing.bootstrapMs}ms`);
+    lines.push(`- Preflight: ${report.timing.preflightMs}ms`);
+    lines.push(`- **Total: ${report.timing.totalMs}ms**\n`);
+    if (Object.keys(report.components).length > 0) {
+        lines.push('## Components');
+        for (const [name, timing] of Object.entries(report.components)) {
+            const icon = timing.status === 'warning' ? '⚠️' : '✓';
+            lines.push(`${icon} ${name} (${timing.durationMs.toFixed(1)}ms)`);
+            if (timing.reason) {
+                lines.push(`  └─ ${timing.reason}`);
+            }
+        }
+        lines.push('');
+    }
+    if (report.issues.length > 0) {
+        lines.push('## Issues\n');
+        for (const issue of report.issues) {
+            const severityIcon = issue.severity === 'blocking'
+                ? '🔴'
+                : issue.severity === 'warning'
+                    ? '🟡'
+                    : '🔵';
+            lines.push(`${severityIcon} **${issue.component}** (${issue.severity})`);
+            lines.push(`   ${issue.detail}`);
+            if (issue.remediation) {
+                lines.push(`   → Fix: \`${issue.remediation}\``);
+            }
+            if (issue.autoFixable) {
+                lines.push('   → Auto-fixable: Yes');
+            }
+            lines.push('');
+        }
+    }
+    else {
+        lines.push('## Issues\n');
+        lines.push('✓ No issues found\n');
+    }
+    lines.push(`_Generated: ${report.timestamp}_`);
+    return lines.join('\n');
+}
+/**
+ * Get emoji for status
+ */
+function getStatusEmoji(status) {
+    switch (status) {
+        case 'ok':
+            return '✅';
+        case 'degraded':
+            return '⚠️';
+        case 'error':
+            return '❌';
+        default:
+            return '❓';
+    }
+}
+//# sourceMappingURL=startup-health-reporter.js.map

package/dist/kaseki-api/startup-health-reporter.js.map

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

package/dist/kaseki-api/startup-summary-artifact.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Startup Summary Artifact Writer
+ *
+ * Writes startup health reports to JSON and markdown artifacts
+ * Caches in memory for API endpoint access
+ */
+import type { StartupHealthReport } from '../kaseki-api-types';
+/**
+ * Write startup health report to artifacts directory
+ *
+ * Writes two files:
+ * - startup-health-report.json (structured for parsing)
+ * - startup-summary.md (human-readable)
+ *
+ * @param resultsDir - Directory to write artifacts to
+ * @param report - Health report to write
+ * @throws Error if write fails
+ */
+export declare function writeStartupHealthArtifacts(resultsDir: string, report: StartupHealthReport): void;
+/**
+ * Get cached startup health report (populated after startup)
+ * Returns null if not yet generated
+ */
+export declare function getCachedStartupHealthReport(): StartupHealthReport | null;
+/**
+ * Clear cached report (for testing)
+ */
+export declare function clearCachedStartupHealthReport(): void;
+//# sourceMappingURL=startup-summary-artifact.d.ts.map

package/dist/kaseki-api/startup-summary-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-summary-artifact.d.ts","sourceRoot":"","sources":["../../src/kaseki-api/startup-summary-artifact.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAO/D;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,GAC1B,IAAI,CA2BN;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,mBAAmB,GAAG,IAAI,CAEzE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/kaseki-api/startup-summary-artifact.js

@@ -0,0 +1,63 @@
+/**
+ * Startup Summary Artifact Writer
+ *
+ * Writes startup health reports to JSON and markdown artifacts
+ * Caches in memory for API endpoint access
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { createEventLogger } from '../logger.js';
+import { healthReportToMarkdown } from './startup-health-reporter.js';
+const logger = createEventLogger('startup-artifacts');
+let cachedHealthReport = null;
+/**
+ * Write startup health report to artifacts directory
+ *
+ * Writes two files:
+ * - startup-health-report.json (structured for parsing)
+ * - startup-summary.md (human-readable)
+ *
+ * @param resultsDir - Directory to write artifacts to
+ * @param report - Health report to write
+ * @throws Error if write fails
+ */
+export function writeStartupHealthArtifacts(resultsDir, report) {
+    try {
+        // Ensure directory exists
+        fs.mkdirSync(resultsDir, { recursive: true });
+        // Write JSON
+        const jsonPath = path.join(resultsDir, 'startup-health-report.json');
+        fs.writeFileSync(jsonPath, JSON.stringify(report, null, 2), 'utf-8');
+        logger.debug('Wrote startup health report (JSON)', { filePath: jsonPath });
+        // Write Markdown
+        const markdown = healthReportToMarkdown(report);
+        const mdPath = path.join(resultsDir, 'startup-summary.md');
+        fs.writeFileSync(mdPath, markdown, 'utf-8');
+        logger.debug('Wrote startup health report (Markdown)', { filePath: mdPath });
+        // Cache for API access
+        cachedHealthReport = report;
+        logger.debug('Cached startup health report in memory');
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        logger.error('Failed to write startup health artifacts', {
+            error: errorMsg,
+            resultsDir,
+        });
+        throw new Error(`Failed to write startup artifacts: ${errorMsg}`);
+    }
+}
+/**
+ * Get cached startup health report (populated after startup)
+ * Returns null if not yet generated
+ */
+export function getCachedStartupHealthReport() {
+    return cachedHealthReport;
+}
+/**
+ * Clear cached report (for testing)
+ */
+export function clearCachedStartupHealthReport() {
+    cachedHealthReport = null;
+}
+//# sourceMappingURL=startup-summary-artifact.js.map

package/dist/kaseki-api/startup-summary-artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-summary-artifact.js","sourceRoot":"","sources":["../../src/kaseki-api/startup-summary-artifact.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,MAAM,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAEtD,IAAI,kBAAkB,GAA+B,IAAI,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAkB,EAClB,MAA2B;IAE3B,IAAI,CAAC;QACH,0BAA0B;QAC1B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9C,aAAa;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;QACrE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3E,iBAAiB;QACjB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAC3D,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7E,uBAAuB;QACvB,kBAAkB,GAAG,MAAM,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE;YACvD,KAAK,EAAE,QAAQ;YACf,UAAU;SACX,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B;IAC5C,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC"}

package/dist/kaseki-api-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kaseki-api-routes.d.ts","sourceRoot":"","sources":["../src/kaseki-api-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAWlE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAY5D,OAAO,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AAWtE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK7C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAwoB5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA+gBjE;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,eAAe,EACvB,gBAAgB,EAAE,gBAAgB,EAClC,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,cAIX,GACD,MAAM,CAwhBR"}
+{"version":3,"file":"kaseki-api-routes.d.ts","sourceRoot":"","sources":["../src/kaseki-api-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAWlE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAY5D,OAAO,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AAWtE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAwoB5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA+gBjE;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,eAAe,EACvB,gBAAgB,EAAE,gBAAgB,EAClC,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,cAIX,GACD,MAAM,CA2kBR"}

package/dist/kaseki-api-routes.js

@@ -22,6 +22,8 @@ import { createGitHubIssuesRoutes } from './routes/github-issues-routes.js';
 import { ResultCache } from './result-cache.js';
 import { validateGitHubAppPrivateKey } from './github-app-private-key.js';
 import { metricsRegistry } from './metrics.js';
+import { getCachedStartupHealthReport } from './kaseki-api/startup-summary-artifact.js';
+import { healthReportToMarkdown } from './kaseki-api/startup-health-reporter.js';
 // Re-export UTF-8 helpers for backward compatibility
 export { decodeUtf8TailSafely, tailLogByLines } from './utils/utf8-helpers.js';
 const TEMPLATE_REMEDIATION = 'Run scripts/kaseki-activate.sh --controller bootstrap.';
@@ -980,6 +982,53 @@ export function createApiRouter(scheduler, config, idempotencyStore, preFlightVa
         }
         res.status(response.status === 'error' ? 503 : 200).json(response);
     });
+    /**
+     * GET /api/startup-health — Unified startup health report (Phase 4)
+     * Returns consolidated health status with bootstrap timing, preflight checks, and component status
+     */
+    router.get('/startup-health', (_req, res) => {
+        try {
+            const report = getCachedStartupHealthReport();
+            if (!report) {
+                res.status(404).json({
+                    error: 'startup-health-not-available',
+                    detail: 'Startup health report not yet generated. Check back after service initialization.',
+                });
+                return;
+            }
+            res.status(200).json(report);
+        }
+        catch (err) {
+            logger.error('Failed to retrieve startup health report', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            res.status(500).json({
+                error: 'health-report-error',
+                detail: 'Failed to retrieve startup health report',
+            });
+        }
+    });
+    /**
+     * GET /api/startup-health/markdown — Startup health report in markdown format
+     * Human-readable summary for logs and documentation
+     */
+    router.get('/startup-health/markdown', (_req, res) => {
+        try {
+            const report = getCachedStartupHealthReport();
+            if (!report) {
+                res.status(404).type('text/markdown').send('# Startup Health Report\n\nReport not yet available.\n');
+                return;
+            }
+            const markdown = healthReportToMarkdown(report);
+            res.type('text/markdown').status(200).send(markdown);
+        }
+        catch (err) {
+            logger.error('Failed to generate startup health markdown', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            res.status(500).type('text/markdown').send('# Error\n\nFailed to generate health report.\n');
+        }
+    });
     /**
      * Extract: Validate publish mode has proper authentication.
      */