sandstream-kit 1.0.0

package/dist/error-tracker.js

@@ -0,0 +1,206 @@
+// ─── Types ────────────────────────────────────────────────────────────────────
+import { IdGenerators } from "./id-generator.js";
+// ─── ErrorTracker ────────────────────────────────────────────────────────────
+export class ErrorTracker {
+    errors = new Map();
+    errorGroups = new Map();
+    errorIndex = new Map(); // message → errorIds
+    // ─── Error Logging ────────────────────────────────────────────────────────
+    /**
+     * Log an error.
+     */
+    logError(message, stack, severity = "high", context = {}, userId, sessionId) {
+        const id = IdGenerators.error();
+        const error = {
+            id,
+            message,
+            stack,
+            severity,
+            context,
+            timestamp: new Date().toISOString(),
+            userId,
+            sessionId,
+            resolved: false,
+        };
+        this.errors.set(id, error);
+        this.indexError(id, message);
+        this.groupError(error);
+        return error;
+    }
+    /**
+     * Get error by ID.
+     */
+    getError(errorId) {
+        return this.errors.get(errorId) || null;
+    }
+    /**
+     * Resolve an error.
+     */
+    resolveError(errorId) {
+        const error = this.errors.get(errorId);
+        if (!error)
+            return null;
+        error.resolved = true;
+        error.resolvedAt = new Date().toISOString();
+        // Update error group
+        const group = this.findGroupForError(error);
+        if (group) {
+            const unresolved = this.getErrorsByGroup(group.id).filter((e) => !e.resolved);
+            if (unresolved.length === 0) {
+                group.resolved = true;
+            }
+        }
+        return error;
+    }
+    /**
+     * Get all unresolved errors.
+     */
+    getUnresolvedErrors() {
+        return [...this.errors.values()].filter((e) => !e.resolved);
+    }
+    /**
+     * Get errors by severity.
+     */
+    getErrorsBySeverity(severity) {
+        return [...this.errors.values()].filter((e) => e.severity === severity && !e.resolved);
+    }
+    // ─── Error Grouping ───────────────────────────────────────────────────────
+    indexError(errorId, message) {
+        const ids = this.errorIndex.get(message) || new Set();
+        ids.add(errorId);
+        this.errorIndex.set(message, ids);
+    }
+    groupError(error) {
+        // Check if error message already has a group
+        const existingGroup = [...this.errorGroups.values()].find((g) => g.message === error.message);
+        if (existingGroup) {
+            existingGroup.occurrences++;
+            existingGroup.lastSeen = error.timestamp;
+            if (error.severity === "critical" && existingGroup.severity !== "critical") {
+                existingGroup.severity = "critical";
+            }
+        }
+        else {
+            // Create new group
+            const groupId = IdGenerators.errorGroup();
+            const group = {
+                id: groupId,
+                message: error.message,
+                firstSeen: error.timestamp,
+                lastSeen: error.timestamp,
+                occurrences: 1,
+                severity: error.severity,
+                resolved: false,
+            };
+            this.errorGroups.set(groupId, group);
+        }
+    }
+    findGroupForError(error) {
+        return ([...this.errorGroups.values()].find((g) => g.message === error.message) || null);
+    }
+    /**
+     * Get all error groups.
+     */
+    getAllErrorGroups() {
+        return [...this.errorGroups.values()].sort((a, b) => b.occurrences - a.occurrences);
+    }
+    /**
+     * Get errors in a group.
+     */
+    getErrorsByGroup(groupId) {
+        const group = this.errorGroups.get(groupId);
+        if (!group)
+            return [];
+        return [...this.errors.values()].filter((e) => e.message === group.message);
+    }
+    // ─── Metrics & Analytics ──────────────────────────────────────────────────
+    /**
+     * Get error metrics.
+     */
+    getMetrics() {
+        const errorsBySeverity = {
+            critical: 0,
+            high: 0,
+            medium: 0,
+            low: 0,
+        };
+        const errorsByType = {};
+        const errorTrend = new Map();
+        for (const error of this.errors.values()) {
+            errorsBySeverity[error.severity]++;
+            // Count by message type
+            errorsByType[error.message] = (errorsByType[error.message] || 0) + 1;
+            // Count by date
+            const date = error.timestamp.split("T")[0];
+            errorTrend.set(date, (errorTrend.get(date) || 0) + 1);
+        }
+        // Get top errors
+        const topErrors = Object.entries(errorsByType)
+            .map(([message, count]) => ({ message, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 10);
+        return {
+            totalErrors: this.errors.size,
+            errorsBySeverity,
+            errorsByType,
+            errorTrend: [...errorTrend.entries()]
+                .map(([date, count]) => ({ date, count }))
+                .sort((a, b) => a.date.localeCompare(b.date)),
+            topErrors,
+        };
+    }
+    /**
+     * Get error rate (errors per minute).
+     */
+    getErrorRate() {
+        if (this.errors.size === 0)
+            return 0;
+        const now = Date.now();
+        const oneMinuteAgo = now - 60 * 1000;
+        const recentErrors = [...this.errors.values()].filter((e) => new Date(e.timestamp).getTime() > oneMinuteAgo);
+        return recentErrors.length;
+    }
+    /**
+     * Get most recent errors.
+     */
+    getRecentErrors(limit = 10) {
+        return [...this.errors.values()]
+            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime())
+            .slice(0, limit);
+    }
+    // ─── Cleanup ──────────────────────────────────────────────────────────────
+    /**
+     * Clear old errors (older than days).
+     */
+    clearOldErrors(days) {
+        const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+        let count = 0;
+        for (const [id, error] of this.errors.entries()) {
+            if (new Date(error.timestamp).getTime() < cutoff) {
+                this.errors.delete(id);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Clear resolved errors.
+     */
+    clearResolvedErrors() {
+        const before = this.errors.size;
+        for (const [id, error] of this.errors.entries()) {
+            if (error.resolved) {
+                this.errors.delete(id);
+            }
+        }
+        return before - this.errors.size;
+    }
+    // ─── Cache helpers ────────────────────────────────────────────────────────
+    getErrorCache() {
+        return this.errors;
+    }
+    getErrorGroupCache() {
+        return this.errorGroups;
+    }
+}
+//# sourceMappingURL=error-tracker.js.map

package/dist/error-tracker.js.map

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

package/dist/escalate.d.ts

@@ -0,0 +1,11 @@
+import type { ToolStatus } from "./check-tools.js";
+import type { ServiceStatus } from "./check-services.js";
+import type { SecretStatus } from "./check-secrets.js";
+export interface EscalationItem {
+    category: "tool" | "service" | "secret";
+    name: string;
+    issue: string;
+    action: string;
+}
+export declare function collectEscalations(tools: ToolStatus[], services: ServiceStatus[], secrets: SecretStatus[]): EscalationItem[];
+export declare function formatEscalationMessage(items: EscalationItem[], projectDir: string): string;

package/dist/escalate.js

@@ -0,0 +1,73 @@
+export function collectEscalations(tools, services, secrets) {
+    const items = [];
+    for (const t of tools) {
+        if (!t.ok) {
+            items.push({
+                category: "tool",
+                name: t.name,
+                issue: t.installed
+                    ? `Version ${t.installed} does not satisfy ${t.required}`
+                    : "Not installed",
+                action: `Run: mise install ${t.name}@${t.required}`,
+            });
+        }
+    }
+    for (const s of services) {
+        if (!s.authenticated) {
+            items.push({
+                category: "service",
+                name: s.name,
+                issue: "Not authenticated",
+                action: `Run: ${s.checkCommand.replace(/\bstatus\b|whoami|--list/g, "login").trim()}`,
+            });
+        }
+    }
+    for (const s of secrets) {
+        if (!s.available) {
+            items.push({
+                category: "secret",
+                name: s.name,
+                issue: s.detail,
+                action: s.source === "1password"
+                    ? "Retrieve from 1Password"
+                    : s.source === "eas"
+                        ? "Set via eas secret:push"
+                        : s.source === "infisical"
+                            ? "Add to Infisical project (infisical secrets set)"
+                            : s.source === "bitwarden"
+                                ? "Add to Bitwarden vault"
+                                : s.source === "doppler"
+                                    ? "Add to Doppler project"
+                                    : `Set ${s.name} in environment`,
+            });
+        }
+    }
+    return items;
+}
+export function formatEscalationMessage(items, projectDir) {
+    if (items.length === 0) {
+        return "All checks passed — no manual action needed.";
+    }
+    const lines = [
+        `kit: ${items.length} issue${items.length === 1 ? "" : "s"} need manual action`,
+        `Project: ${projectDir}`,
+        "",
+    ];
+    const byCategory = new Map();
+    for (const item of items) {
+        const list = byCategory.get(item.category) ?? [];
+        list.push(item);
+        byCategory.set(item.category, list);
+    }
+    for (const [category, categoryItems] of byCategory) {
+        const label = category === "tool" ? "Tools" : category === "service" ? "Services" : "Secrets";
+        lines.push(`${label}:`);
+        for (const item of categoryItems) {
+            lines.push(`  - ${item.name}: ${item.issue}`);
+            lines.push(`    ${item.action}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=escalate.js.map

package/dist/escalate.js.map

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

package/dist/event-stream.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Real-time event streaming pipeline
+ * Routes APM metrics and system events to subscribers and processors
+ */
+export type EventType = "metric" | "error" | "transaction" | "audit" | "alert";
+export type EventSource = "apm" | "analytics" | "api" | "user" | "system";
+export type EventSeverity = "info" | "warning" | "critical";
+export interface StreamEvent {
+    id: string;
+    type: EventType;
+    timestamp: number;
+    source: EventSource;
+    pluginId?: string;
+    authorId?: string;
+    severity: EventSeverity;
+    data: Record<string, any>;
+}
+/**
+ * In-memory event stream with subscription support
+ * Events drain to database periodically for long-term storage
+ */
+export declare class EventStream {
+    private queue;
+    private subscriptions;
+    private maxQueueSize;
+    private drainIntervalMs;
+    private onDrain?;
+    private drainTimer?;
+    constructor(maxQueueSize?: number, drainIntervalMs?: number);
+    /**
+     * Publish event to stream
+     */
+    publish(event: Omit<StreamEvent, "id" | "timestamp">): StreamEvent;
+    /**
+     * Subscribe to filtered events
+     * Returns subscription handle
+     */
+    subscribe(filter?: (event: StreamEvent) => boolean, maxBufferSize?: number): {
+        id: string;
+        drain: () => StreamEvent[];
+        close: () => void;
+    };
+    /**
+     * Query events within time window
+     */
+    query(windowMs: number, filter?: (event: StreamEvent) => boolean): StreamEvent[];
+    /**
+     * Get current queue size
+     */
+    size(): number;
+    /**
+     * Drain queue to storage (database)
+     */
+    drain(): Promise<StreamEvent[]>;
+    /**
+     * Set drain callback (e.g., save to database)
+     */
+    setDrainCallback(callback: (events: StreamEvent[]) => Promise<void>): void;
+    /**
+     * Start periodic drain timer
+     */
+    private startDrainTimer;
+    /**
+     * Stop the periodic drain timer and release the event-loop handle.
+     */
+    close(): void;
+    /**
+     * Get metrics about stream health
+     */
+    metrics(): {
+        queueSize: number;
+        subscriptionCount: number;
+        memoryEstimateBytes: number;
+    };
+    /**
+     * Clear all events and subscriptions
+     */
+    clear(): void;
+}
+export declare function initializeEventStream(maxQueueSize?: number, drainIntervalMs?: number): EventStream;
+export declare function getEventStream(): EventStream;

package/dist/event-stream.js

@@ -0,0 +1,161 @@
+/**
+ * Real-time event streaming pipeline
+ * Routes APM metrics and system events to subscribers and processors
+ */
+import { IdGenerators } from "./id-generator.js";
+/**
+ * In-memory event stream with subscription support
+ * Events drain to database periodically for long-term storage
+ */
+export class EventStream {
+    queue = [];
+    subscriptions = new Map();
+    maxQueueSize;
+    drainIntervalMs;
+    onDrain;
+    drainTimer;
+    constructor(maxQueueSize = 10000, drainIntervalMs = 300000) {
+        this.maxQueueSize = maxQueueSize;
+        this.drainIntervalMs = drainIntervalMs;
+        this.startDrainTimer();
+    }
+    /**
+     * Publish event to stream
+     */
+    publish(event) {
+        const fullEvent = {
+            ...event,
+            id: IdGenerators.trace(),
+            timestamp: Date.now(),
+        };
+        this.queue.push(fullEvent);
+        // Route to subscribed listeners
+        for (const [, subscription] of this.subscriptions) {
+            if (subscription.filter(fullEvent)) {
+                subscription.queue.push(fullEvent);
+                if (subscription.queue.length > subscription.maxSize) {
+                    subscription.queue.shift();
+                }
+            }
+        }
+        // Trim queue if over capacity
+        if (this.queue.length > this.maxQueueSize) {
+            this.queue = this.queue.slice(-this.maxQueueSize);
+        }
+        return fullEvent;
+    }
+    /**
+     * Subscribe to filtered events
+     * Returns subscription handle
+     */
+    subscribe(filter = () => true, maxBufferSize = 1000) {
+        const subscriptionId = IdGenerators.trace();
+        const subscription = {
+            id: subscriptionId,
+            filter,
+            queue: [],
+            maxSize: maxBufferSize,
+        };
+        this.subscriptions.set(subscriptionId, subscription);
+        return {
+            id: subscriptionId,
+            drain: () => {
+                const events = subscription.queue;
+                subscription.queue = [];
+                return events;
+            },
+            close: () => {
+                this.subscriptions.delete(subscriptionId);
+            },
+        };
+    }
+    /**
+     * Query events within time window
+     */
+    query(windowMs, filter) {
+        const cutoff = Date.now() - windowMs;
+        return this.queue.filter((event) => {
+            if (event.timestamp < cutoff)
+                return false;
+            return filter ? filter(event) : true;
+        });
+    }
+    /**
+     * Get current queue size
+     */
+    size() {
+        return this.queue.length;
+    }
+    /**
+     * Drain queue to storage (database)
+     */
+    async drain() {
+        if (this.queue.length === 0) {
+            return [];
+        }
+        const events = [...this.queue];
+        this.queue = [];
+        if (this.onDrain) {
+            await this.onDrain(events);
+        }
+        return events;
+    }
+    /**
+     * Set drain callback (e.g., save to database)
+     */
+    setDrainCallback(callback) {
+        this.onDrain = callback;
+    }
+    /**
+     * Start periodic drain timer
+     */
+    startDrainTimer() {
+        this.drainTimer = setInterval(() => {
+            this.drain().catch((err) => console.error("EventStream drain failed:", err));
+        }, this.drainIntervalMs);
+        // Best-effort background drain — must not keep the process alive (else
+        // `node --test` never exits and the suite "hangs").
+        this.drainTimer.unref();
+    }
+    /**
+     * Stop the periodic drain timer and release the event-loop handle.
+     */
+    close() {
+        if (this.drainTimer) {
+            clearInterval(this.drainTimer);
+            this.drainTimer = undefined;
+        }
+    }
+    /**
+     * Get metrics about stream health
+     */
+    metrics() {
+        return {
+            queueSize: this.queue.length,
+            subscriptionCount: this.subscriptions.size,
+            memoryEstimateBytes: JSON.stringify(this.queue).length,
+        };
+    }
+    /**
+     * Clear all events and subscriptions
+     */
+    clear() {
+        this.queue = [];
+        this.subscriptions.clear();
+    }
+}
+/**
+ * Global event stream singleton
+ */
+let globalStream = null;
+export function initializeEventStream(maxQueueSize, drainIntervalMs) {
+    globalStream = new EventStream(maxQueueSize, drainIntervalMs);
+    return globalStream;
+}
+export function getEventStream() {
+    if (!globalStream) {
+        globalStream = new EventStream();
+    }
+    return globalStream;
+}
+//# sourceMappingURL=event-stream.js.map

package/dist/event-stream.js.map

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

package/dist/fix.d.ts

@@ -0,0 +1,42 @@
+import type { ToolStatus } from "./check-tools.js";
+import type { ServiceStatus } from "./check-services.js";
+import type { SecretStatus } from "./check-secrets.js";
+import type { ToolConfig, ServiceConfig } from "./config.js";
+export interface FixResult {
+    category: "tool" | "service" | "lock" | "secret";
+    name: string;
+    action: "fixed" | "already_ok" | "needs_manual" | "failed";
+    detail: string;
+}
+interface FixOptions {
+    tools: ToolStatus[];
+    services: ServiceStatus[];
+    secrets: SecretStatus[];
+    toolsConfig?: ToolConfig;
+    servicesConfig?: Record<string, ServiceConfig>;
+    skillsRequired?: Record<string, string>;
+    skillsOptional?: Record<string, string>;
+}
+/**
+ * Attempts to automatically fix issues found by kit check.
+ * Returns results for each fix attempt.
+ */
+export declare function autoFix(options: FixOptions): Promise<FixResult[]>;
+/**
+ * Format fix results for display
+ */
+export declare function formatFixResults(results: FixResult[]): {
+    fixed: FixResult[];
+    needsManual: FixResult[];
+    failed: FixResult[];
+};
+/**
+ * `kit fix` — auto-remediation pipeline. Six steps: install missing
+ * tools, generate lock files, surface unauthenticated services, generate
+ * .env.template, harden .gitignore, install git hooks. Returns false when
+ * any step requires manual intervention.
+ *
+ * Extracted from cli.ts (codebase-review follow-up).
+ */
+export declare function cmdFix(): Promise<boolean>;
+export {};