@lovelybunch/core 1.0.66 → 1.0.67

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './change-proposal.js';
 export * from './storage.js';
 export * from './markdown-storage.js';
+export * from './logging/index.js';
 export type * from '@lovelybunch/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,mBAAmB,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,mBAAmB,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './change-proposal.js';
 export * from './storage.js';
 export * from './markdown-storage.js';
+export * from './logging/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/logging/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Coconut activity logging module
+ * @module logging
+ *
+ * This module provides a unified activity logging system for Coconut that tracks
+ * all operations (proposals, sessions, jobs, git actions, etc.) in a file-first,
+ * append-only JSONL format.
+ *
+ * @example
+ * ```typescript
+ * import { getLogger, EventKinds } from "@lovelybunch/core/logging";
+ *
+ * const logger = getLogger();
+ *
+ * // Log a proposal creation
+ * logger.log({
+ *   kind: EventKinds.CREATE,
+ *   actor: "human:user@example.com",
+ *   subject: "proposal:cp-123",
+ *   tags: ["proposal"],
+ *   payload: { intent: "Add feature X" }
+ * });
+ * ```
+ */
+export { getLogger, resetLogger, hasLogger } from "./logger";
+export type { LogEventBase, LogEvent, Logger, LoggerOptions, LogLevel, } from "./types";
+export { EventKinds, ProposalKinds, AgentKinds, CodeKinds, KnowledgeKinds, JobKinds, ResourceKinds, AuthKinds, isValidEventKind, EventKindRegistry, } from "./kinds";
+export { defaultRedactor, createRedactor, noRedactor, } from "./redact";
+export { JsonlWriter } from "./jsonl-writer";
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG7D,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,aAAa,EACb,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,33 @@
+/**
+ * Coconut activity logging module
+ * @module logging
+ *
+ * This module provides a unified activity logging system for Coconut that tracks
+ * all operations (proposals, sessions, jobs, git actions, etc.) in a file-first,
+ * append-only JSONL format.
+ *
+ * @example
+ * ```typescript
+ * import { getLogger, EventKinds } from "@lovelybunch/core/logging";
+ *
+ * const logger = getLogger();
+ *
+ * // Log a proposal creation
+ * logger.log({
+ *   kind: EventKinds.CREATE,
+ *   actor: "human:user@example.com",
+ *   subject: "proposal:cp-123",
+ *   tags: ["proposal"],
+ *   payload: { intent: "Add feature X" }
+ * });
+ * ```
+ */
+// Main logger interface
+export { getLogger, resetLogger, hasLogger } from "./logger";
+// Event kinds taxonomy
+export { EventKinds, ProposalKinds, AgentKinds, CodeKinds, KnowledgeKinds, JobKinds, ResourceKinds, AuthKinds, isValidEventKind, EventKindRegistry, } from "./kinds";
+// Redaction utilities
+export { defaultRedactor, createRedactor, noRedactor, } from "./redact";
+// Internal writer (exported for testing and advanced use cases)
+export { JsonlWriter } from "./jsonl-writer";
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAW7D,uBAAuB;AACvB,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,sBAAsB;AACtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,UAAU,CAAC;AAElB,gEAAgE;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/logging/jsonl-writer.d.ts

@@ -0,0 +1,76 @@
+/**
+ * JSONL writer with rotation support for Coconut activity logging
+ * @module logging/jsonl-writer
+ */
+import type { LogEvent, LogEventBase } from "./types";
+/**
+ * Internal writer that manages append-only JSONL files with size-based rotation
+ *
+ * Features:
+ * - Single append-only file: events-current.jsonl
+ * - Size-based rotation (default: 128MB)
+ * - Monotonic sequence counter persisted in .seq file
+ * - Non-blocking queue-based writes
+ * - Automatic directory creation
+ */
+export declare class JsonlWriter {
+    private readonly dir;
+    private readonly coconut;
+    private readonly rotateBytes;
+    private seq;
+    private queue;
+    private writing;
+    private out;
+    private currentPath;
+    private bytes;
+    private closed;
+    /**
+     * Create a new JSONL writer
+     *
+     * @param dir - Directory to store log files
+     * @param coconut - Coconut instance identifier
+     * @param rotateBytes - File size threshold for rotation (default: 128MB)
+     */
+    constructor(dir: string, coconut: string, rotateBytes?: number);
+    /**
+     * Enqueue an event for writing (non-blocking)
+     */
+    enqueue(event: LogEvent): void;
+    /**
+     * Flush pending events to disk
+     */
+    flush(): Promise<void>;
+    /**
+     * Get the last assigned sequence number
+     */
+    getSeq(): number;
+    /**
+     * Close the writer and cleanup resources
+     */
+    close(): Promise<void>;
+    /**
+     * Create the next event with auto-filled fields and enqueue it
+     */
+    nextEvent(event: LogEventBase): number;
+    /**
+     * Drain the queue by writing all pending events
+     */
+    private drain;
+    /**
+     * Read the sequence counter from disk
+     */
+    private readSeq;
+    /**
+     * Persist the current sequence counter to disk
+     */
+    private writeSeq;
+    /**
+     * Open a new current file for writing
+     */
+    private rotateNewFile;
+    /**
+     * Rotate the current file to a timestamped archive
+     */
+    private rotate;
+}
+//# sourceMappingURL=jsonl-writer.d.ts.map

package/dist/logging/jsonl-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.d.ts","sourceRoot":"","sources":["../../src/logging/jsonl-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;;OAMG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,SAAoB;IAezE;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAW9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;IAiBtC;;OAEG;YACW,KAAK;IA+CnB;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0CrB;;OAEG;YACW,MAAM;CAqBrB"}

package/dist/logging/jsonl-writer.js

@@ -0,0 +1,252 @@
+/**
+ * JSONL writer with rotation support for Coconut activity logging
+ * @module logging/jsonl-writer
+ */
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Internal writer that manages append-only JSONL files with size-based rotation
+ *
+ * Features:
+ * - Single append-only file: events-current.jsonl
+ * - Size-based rotation (default: 128MB)
+ * - Monotonic sequence counter persisted in .seq file
+ * - Non-blocking queue-based writes
+ * - Automatic directory creation
+ */
+export class JsonlWriter {
+    dir;
+    coconut;
+    rotateBytes;
+    seq = 0;
+    queue = [];
+    writing = false;
+    out;
+    currentPath;
+    bytes = 0;
+    closed = false;
+    /**
+     * Create a new JSONL writer
+     *
+     * @param dir - Directory to store log files
+     * @param coconut - Coconut instance identifier
+     * @param rotateBytes - File size threshold for rotation (default: 128MB)
+     */
+    constructor(dir, coconut, rotateBytes = 128 * 1024 * 1024) {
+        this.dir = dir;
+        this.coconut = coconut;
+        this.rotateBytes = rotateBytes;
+        // Ensure the directory exists
+        fs.mkdirSync(this.dir, { recursive: true });
+        // Load the last sequence number
+        this.seq = this.readSeq();
+        // Open the current file
+        this.rotateNewFile();
+    }
+    /**
+     * Enqueue an event for writing (non-blocking)
+     */
+    enqueue(event) {
+        if (this.closed) {
+            throw new Error("JsonlWriter is closed");
+        }
+        this.queue.push(event);
+        if (!this.writing) {
+            // Don't await - this is fire-and-forget
+            void this.drain();
+        }
+    }
+    /**
+     * Flush pending events to disk
+     */
+    async flush() {
+        if (this.closed) {
+            return;
+        }
+        // Wait for any pending writes to complete
+        while (this.writing) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    /**
+     * Get the last assigned sequence number
+     */
+    getSeq() {
+        return this.seq;
+    }
+    /**
+     * Close the writer and cleanup resources
+     */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        // Wait for any pending writes
+        while (this.writing || this.queue.length > 0) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+        // Close the output stream
+        return new Promise((resolve) => {
+            if (this.out) {
+                this.out.end(() => resolve());
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    /**
+     * Create the next event with auto-filled fields and enqueue it
+     */
+    nextEvent(event) {
+        const seq = ++this.seq;
+        const ts = event.ts || new Date().toISOString();
+        const fullEvent = {
+            ...event,
+            v: 1,
+            seq,
+            ts,
+            coconut: this.coconut,
+        };
+        this.enqueue(fullEvent);
+        this.writeSeq();
+        return seq;
+    }
+    /**
+     * Drain the queue by writing all pending events
+     */
+    async drain() {
+        this.writing = true;
+        try {
+            while (this.queue.length > 0) {
+                const event = this.queue.shift();
+                const line = JSON.stringify(event) + "\n";
+                const lineBytes = Buffer.byteLength(line, "utf8");
+                try {
+                    // Write the line
+                    this.out.write(line);
+                    // Force sync to disk for real-time SSE streaming
+                    // Get the file descriptor and sync it
+                    const fd = this.out.fd;
+                    if (fd !== undefined && fd !== null) {
+                        try {
+                            fs.fsyncSync(fd);
+                        }
+                        catch (syncError) {
+                            // fsync might fail on some systems, continue anyway
+                        }
+                    }
+                    this.bytes += lineBytes;
+                    // Rotate if we've exceeded the threshold
+                    if (this.bytes > this.rotateBytes) {
+                        await this.rotate();
+                    }
+                }
+                catch (error) {
+                    // Log to console but don't crash - logging should never break the app
+                    console.error('[JsonlWriter] Failed to write event:', error);
+                    // Try to recreate the file stream if it was closed/deleted
+                    try {
+                        this.rotateNewFile();
+                    }
+                    catch (recreateError) {
+                        console.error('[JsonlWriter] Failed to recreate log file:', recreateError);
+                    }
+                }
+            }
+        }
+        finally {
+            this.writing = false;
+        }
+    }
+    /**
+     * Read the sequence counter from disk
+     */
+    readSeq() {
+        const seqPath = path.join(this.dir, ".seq");
+        if (fs.existsSync(seqPath)) {
+            const content = fs.readFileSync(seqPath, "utf8").trim();
+            const seq = Number(content);
+            return isNaN(seq) ? 0 : seq;
+        }
+        return 0;
+    }
+    /**
+     * Persist the current sequence counter to disk
+     */
+    writeSeq() {
+        try {
+            const seqPath = path.join(this.dir, ".seq");
+            fs.writeFileSync(seqPath, String(this.seq), "utf8");
+        }
+        catch (error) {
+            // Fail silently - sequence counter is not critical
+            console.error('[JsonlWriter] Failed to write sequence counter:', error);
+        }
+    }
+    /**
+     * Open a new current file for writing
+     */
+    rotateNewFile() {
+        try {
+            this.currentPath = path.join(this.dir, "events-current.jsonl");
+            // Ensure directory exists (in case it was deleted)
+            if (!fs.existsSync(this.dir)) {
+                fs.mkdirSync(this.dir, { recursive: true });
+            }
+            // Close existing stream if open
+            if (this.out) {
+                try {
+                    this.out.end();
+                }
+                catch {
+                    // Ignore errors closing old stream
+                }
+            }
+            // Create or append to the file
+            // Use highWaterMark: 0 to disable buffering for real-time SSE streaming
+            this.out = fs.createWriteStream(this.currentPath, {
+                flags: "a",
+                highWaterMark: 0 // Disable buffering for immediate disk writes
+            });
+            // Handle stream errors gracefully
+            this.out.on('error', (error) => {
+                console.error('[JsonlWriter] Stream error:', error);
+            });
+            // Calculate current file size
+            if (fs.existsSync(this.currentPath)) {
+                this.bytes = fs.statSync(this.currentPath).size;
+            }
+            else {
+                this.bytes = 0;
+            }
+        }
+        catch (error) {
+            console.error('[JsonlWriter] Failed to open log file:', error);
+            throw error; // Only throw on initialization, not during recovery
+        }
+    }
+    /**
+     * Rotate the current file to a timestamped archive
+     */
+    async rotate() {
+        // Close the current file
+        await new Promise((resolve) => {
+            this.out.end(() => resolve());
+        });
+        // Generate timestamp for the rotated file
+        const now = new Date();
+        const timestamp = now
+            .toISOString()
+            .replace(/[:.]/g, "")
+            .replace("T", "-")
+            .replace("Z", "");
+        // Rename current file to timestamped archive
+        const rotatedPath = path.join(this.dir, `events-${timestamp}.jsonl`);
+        fs.renameSync(this.currentPath, rotatedPath);
+        // Open a new current file
+        this.rotateNewFile();
+    }
+}
+//# sourceMappingURL=jsonl-writer.js.map

package/dist/logging/jsonl-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.js","sourceRoot":"","sources":["../../src/logging/jsonl-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IACL,GAAG,CAAS;IACZ,OAAO,CAAS;IAChB,WAAW,CAAS;IAC7B,GAAG,GAAG,CAAC,CAAC;IACR,KAAK,GAAe,EAAE,CAAC;IACvB,OAAO,GAAG,KAAK,CAAC;IAChB,GAAG,CAAkB;IACrB,WAAW,CAAU;IACrB,KAAK,GAAG,CAAC,CAAC;IACV,MAAM,GAAG,KAAK,CAAC;IAEvB;;;;;;OAMG;IACH,YAAY,GAAW,EAAE,OAAe,EAAE,WAAW,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI;QACvE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,8BAA8B;QAC9B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,gCAAgC;QAChC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAE1B,wBAAwB;QACxB,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAe;QACrB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,wCAAwC;YACxC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,0CAA0C;QAC1C,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAEnB,8BAA8B;QAC9B,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,0BAA0B;QAC1B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAmB;QAC3B,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;QACvB,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,SAAS,GAAa;YAC1B,GAAG,KAAK;YACR,CAAC,EAAE,CAAC;YACJ,GAAG;YACH,EAAE;YACF,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,KAAK;QACjB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;gBAClC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;gBAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAElD,IAAI,CAAC;oBACH,iBAAiB;oBACjB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAErB,iDAAiD;oBACjD,sCAAsC;oBACtC,MAAM,EAAE,GAAI,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC;oBAChC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;wBACpC,IAAI,CAAC;4BACH,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;wBACnB,CAAC;wBAAC,OAAO,SAAS,EAAE,CAAC;4BACnB,oDAAoD;wBACtD,CAAC;oBACH,CAAC;oBAED,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;oBAExB,yCAAyC;oBACzC,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;wBAClC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;oBACtB,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,sEAAsE;oBACtE,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;oBAE7D,2DAA2D;oBAC3D,IAAI,CAAC;wBACH,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,CAAC;oBAAC,OAAO,aAAa,EAAE,CAAC;wBACvB,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,aAAa,CAAC,CAAC;oBAC7E,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,OAAO;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;OAEG;IACK,QAAQ;QACd,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC5C,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mDAAmD;YACnD,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;YAE/D,mDAAmD;YACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,CAAC;YAED,gCAAgC;YAChC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC;oBACH,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;gBACjB,CAAC;gBAAC,MAAM,CAAC;oBACP,mCAAmC;gBACrC,CAAC;YACH,CAAC;YAED,+BAA+B;YAC/B,wEAAwE;YACxE,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE;gBAChD,KAAK,EAAE,GAAG;gBACV,aAAa,EAAE,CAAC,CAAE,8CAA8C;aACjE,CAAC,CAAC;YAEH,kCAAkC;YAClC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC7B,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;YAEH,8BAA8B;YAC9B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,KAAK,CAAC,CAAC,oDAAoD;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,MAAM;QAClB,yBAAyB;QACzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,0CAA0C;QAC1C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,GAAG;aAClB,WAAW,EAAE;aACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;aACpB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;aACjB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAEpB,6CAA6C;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,SAAS,QAAQ,CAAC,CAAC;QACrE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAE7C,0BAA0B;QAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/logging/kinds.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Event kind taxonomy for Coconut activity logging
+ * @module logging/kinds
+ *
+ * Event kinds follow a hierarchical naming convention:
+ * {entity}.{action}.{qualifier}
+ *
+ * Examples:
+ * - proposal.create
+ * - agent.session.start
+ * - code.commit
+ */
+/**
+ * Proposal-related events
+ */
+export declare const ProposalKinds: {
+    readonly CREATE: "proposal.create";
+    readonly UPDATE: "proposal.update";
+    readonly RUN_START: "proposal.run.start";
+    readonly RUN_END: "proposal.run.end";
+    readonly STATUS_CHANGE: "proposal.status.change";
+};
+/**
+ * Agent and session events
+ */
+export declare const AgentKinds: {
+    readonly SESSION_START: "agent.session.start";
+    readonly SESSION_STDOUT: "agent.session.stdout";
+    readonly SESSION_END: "agent.session.end";
+    readonly SESSION_ERROR: "agent.session.error";
+};
+/**
+ * Code and git-related events
+ */
+export declare const CodeKinds: {
+    readonly EDIT: "code.edit";
+    readonly COMMIT: "code.commit";
+    readonly BRANCH_CREATE: "code.branch.create";
+    readonly WORKTREE_ADD: "code.worktree.add";
+};
+/**
+ * Knowledge base events
+ */
+export declare const KnowledgeKinds: {
+    readonly CREATE: "knowledge.create";
+    readonly UPDATE: "knowledge.update";
+    readonly DELETE: "knowledge.delete";
+};
+/**
+ * Job scheduling and execution events
+ */
+export declare const JobKinds: {
+    readonly SCHEDULE: "job.schedule";
+    readonly RUN_START: "job.run.start";
+    readonly RUN_END: "job.run.end";
+    readonly RUN_ERROR: "job.run.error";
+};
+/**
+ * Resource management events
+ */
+export declare const ResourceKinds: {
+    readonly UPLOAD: "resource.upload";
+    readonly DELETE: "resource.delete";
+};
+/**
+ * Authentication events (when auth is enabled)
+ */
+export declare const AuthKinds: {
+    readonly LOGIN: "auth.login";
+    readonly LOGOUT: "auth.logout";
+    readonly API_KEY_USE: "auth.api.key.use";
+    readonly API_KEY_CREATE: "auth.api.key.create";
+    readonly API_KEY_DELETE: "auth.api.key.delete";
+};
+/**
+ * All event kinds in a single object
+ */
+export declare const EventKinds: {
+    readonly LOGIN: "auth.login";
+    readonly LOGOUT: "auth.logout";
+    readonly API_KEY_USE: "auth.api.key.use";
+    readonly API_KEY_CREATE: "auth.api.key.create";
+    readonly API_KEY_DELETE: "auth.api.key.delete";
+    readonly UPLOAD: "resource.upload";
+    readonly DELETE: "resource.delete";
+    readonly SCHEDULE: "job.schedule";
+    readonly RUN_START: "job.run.start";
+    readonly RUN_END: "job.run.end";
+    readonly RUN_ERROR: "job.run.error";
+    readonly CREATE: "knowledge.create";
+    readonly UPDATE: "knowledge.update";
+    readonly EDIT: "code.edit";
+    readonly COMMIT: "code.commit";
+    readonly BRANCH_CREATE: "code.branch.create";
+    readonly WORKTREE_ADD: "code.worktree.add";
+    readonly SESSION_START: "agent.session.start";
+    readonly SESSION_STDOUT: "agent.session.stdout";
+    readonly SESSION_END: "agent.session.end";
+    readonly SESSION_ERROR: "agent.session.error";
+    readonly STATUS_CHANGE: "proposal.status.change";
+};
+/**
+ * Type representing all valid event kind strings
+ */
+export type EventKind = typeof EventKinds[keyof typeof EventKinds];
+/**
+ * Helper to validate if a string is a known event kind
+ */
+export declare function isValidEventKind(kind: string): kind is EventKind;
+/**
+ * Registry of event kinds with metadata
+ * Useful for documentation and validation
+ */
+export declare const EventKindRegistry: {
+    readonly "proposal.create": {
+        readonly description: "A new change proposal was created";
+        readonly tags: readonly ["proposal"];
+    };
+    readonly "proposal.update": {
+        readonly description: "A change proposal was updated";
+        readonly tags: readonly ["proposal"];
+    };
+    readonly "proposal.run.start": {
+        readonly description: "Implementation of a proposal started";
+        readonly tags: readonly ["proposal", "execution"];
+    };
+    readonly "proposal.run.end": {
+        readonly description: "Implementation of a proposal completed";
+        readonly tags: readonly ["proposal", "execution"];
+    };
+    readonly "proposal.status.change": {
+        readonly description: "Proposal status changed";
+        readonly tags: readonly ["proposal"];
+    };
+    readonly "agent.session.start": {
+        readonly description: "Agent session started";
+        readonly tags: readonly ["agent", "session"];
+    };
+    readonly "agent.session.stdout": {
+        readonly description: "Agent session output";
+        readonly tags: readonly ["agent", "session"];
+    };
+    readonly "agent.session.end": {
+        readonly description: "Agent session ended";
+        readonly tags: readonly ["agent", "session"];
+    };
+    readonly "agent.session.error": {
+        readonly description: "Agent session encountered an error";
+        readonly tags: readonly ["agent", "session", "error"];
+    };
+    readonly "code.edit": {
+        readonly description: "Code was edited";
+        readonly tags: readonly ["code"];
+    };
+    readonly "code.commit": {
+        readonly description: "Git commit was created";
+        readonly tags: readonly ["code", "git"];
+    };
+    readonly "code.branch.create": {
+        readonly description: "Git branch was created";
+        readonly tags: readonly ["code", "git"];
+    };
+    readonly "code.worktree.add": {
+        readonly description: "Git worktree was added";
+        readonly tags: readonly ["code", "git"];
+    };
+    readonly "knowledge.create": {
+        readonly description: "Knowledge base entry created";
+        readonly tags: readonly ["knowledge"];
+    };
+    readonly "knowledge.update": {
+        readonly description: "Knowledge base entry updated";
+        readonly tags: readonly ["knowledge"];
+    };
+    readonly "knowledge.delete": {
+        readonly description: "Knowledge base entry deleted";
+        readonly tags: readonly ["knowledge"];
+    };
+    readonly "job.schedule": {
+        readonly description: "Job was scheduled";
+        readonly tags: readonly ["job"];
+    };
+    readonly "job.run.start": {
+        readonly description: "Job run started";
+        readonly tags: readonly ["job", "execution"];
+    };
+    readonly "job.run.end": {
+        readonly description: "Job run completed";
+        readonly tags: readonly ["job", "execution"];
+    };
+    readonly "job.run.error": {
+        readonly description: "Job run failed with error";
+        readonly tags: readonly ["job", "execution", "error"];
+    };
+    readonly "resource.upload": {
+        readonly description: "Resource was uploaded";
+        readonly tags: readonly ["resource"];
+    };
+    readonly "resource.delete": {
+        readonly description: "Resource was deleted";
+        readonly tags: readonly ["resource"];
+    };
+    readonly "auth.login": {
+        readonly description: "User logged in";
+        readonly tags: readonly ["auth"];
+    };
+    readonly "auth.logout": {
+        readonly description: "User logged out";
+        readonly tags: readonly ["auth"];
+    };
+    readonly "auth.api.key.use": {
+        readonly description: "API key was used for authentication";
+        readonly tags: readonly ["auth", "api"];
+    };
+    readonly "auth.api.key.create": {
+        readonly description: "API key was created";
+        readonly tags: readonly ["auth", "api"];
+    };
+    readonly "auth.api.key.delete": {
+        readonly description: "API key was deleted";
+        readonly tags: readonly ["auth", "api"];
+    };
+};
+//# sourceMappingURL=kinds.d.ts.map

package/dist/logging/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../src/logging/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;CAQb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEnE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAEhE;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6GpB,CAAC"}