@velvetmonkey/vault-core 1.27.26 → 1.27.28

package/dist/index.d.ts

@@ -4,8 +4,10 @@
  * Shared vault utilities for the Flywheel ecosystem.
  * Used by both Flywheel (read) and Flywheel-Crank (write).
  */
-export type { EntityIndex, EntityCategory, EntityWithAliases, Entity, EntityWithType, ProtectedZone, ProtectedZoneType, ScanOptions, WikilinkOptions, WikilinkResult, } from './types.js';
+export type { EntityIndex, EntityCategory, EntityWithAliases, Entity, EntityWithType, ProtectedZone, ProtectedZoneType, ScanOptions, WikilinkOptions, WikilinkResult, ImplicitEntityConfig, ExtendedWikilinkOptions, ImplicitEntityMatch, } from './types.js';
 export { scanVaultEntities, getAllEntities, getAllEntitiesWithTypes, getEntityName, getEntityAliases, filterPeriodicNotes, loadEntityCache, saveEntityCache, ENTITY_CACHE_VERSION, } from './entities.js';
 export { getProtectedZones, isInProtectedZone, rangeOverlapsProtectedZone, findFrontmatterEnd, } from './protectedZones.js';
-export { applyWikilinks, suggestWikilinks, } from './wikilinks.js';
+export { applyWikilinks, suggestWikilinks, detectImplicitEntities, processWikilinks, } from './wikilinks.js';
+export { OperationLogger, createLoggerFromConfig, generateSessionId, getSessionId, setSessionId, clearSession, createChildSession, getParentSession, isChildSession, DEFAULT_LOGGING_CONFIG, } from './logging/index.js';
+export type { OperationLogEntry, SessionMetrics, AggregatedMetrics, LoggingConfig, ProductId, } from './logging/index.js';
 //# 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;;;;;GAKG;AAGH,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -9,5 +9,7 @@ export { scanVaultEntities, getAllEntities, getAllEntitiesWithTypes, getEntityNa
 // Protected zones
 export { getProtectedZones, isInProtectedZone, rangeOverlapsProtectedZone, findFrontmatterEnd, } from './protectedZones.js';
 // Wikilinks
-export { applyWikilinks, suggestWikilinks, } from './wikilinks.js';
+export { applyWikilinks, suggestWikilinks, detectImplicitEntities, processWikilinks, } from './wikilinks.js';
+// Logging (unified cross-product logging)
+export { OperationLogger, createLoggerFromConfig, generateSessionId, getSessionId, setSessionId, clearSession, createChildSession, getParentSession, isChildSession, DEFAULT_LOGGING_CONFIG, } 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;;;;;GAKG;AAgBH,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY;AACZ,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY;AACZ,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,0CAA0C;AAC1C,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/logging/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logging module exports
+ */
+export { OperationLogger, createLoggerFromConfig } from './operationLogger.js';
+export { generateSessionId, getSessionId, setSessionId, clearSession, createChildSession, getParentSession, isChildSession, } from './sessionManager.js';
+export { DEFAULT_LOGGING_CONFIG, type OperationLogEntry, type SessionMetrics, type AggregatedMetrics, type LoggingConfig, type ProductId, } from './types.js';
+//# 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;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,7 @@
+/**
+ * Logging module exports
+ */
+export { OperationLogger, createLoggerFromConfig } from './operationLogger.js';
+export { generateSessionId, getSessionId, setSessionId, clearSession, createChildSession, getParentSession, isChildSession, } from './sessionManager.js';
+export { DEFAULT_LOGGING_CONFIG, } from './types.js';
+//# 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;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,GAMvB,MAAM,YAAY,CAAC"}

package/dist/logging/operationLogger.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shared OperationLogger for Flywheel ecosystem
+ *
+ * Provides unified logging for both Flywheel (read) and Flywheel-Crank (write)
+ * with session correlation, metrics aggregation, and privacy controls.
+ */
+import type { OperationLogEntry, SessionMetrics, AggregatedMetrics, LoggingConfig, ProductId } from './types.js';
+/**
+ * Shared operation logger
+ */
+export declare class OperationLogger {
+    private config;
+    private vaultPath;
+    private product;
+    private writeQueue;
+    private flushTimeout;
+    constructor(vaultPath: string, product: ProductId, config?: Partial<LoggingConfig>);
+    /**
+     * Check if logging is enabled
+     */
+    get enabled(): boolean;
+    /**
+     * Log an operation
+     */
+    log(entry: Omit<OperationLogEntry, 'ts' | 'product' | 'session'>): Promise<void>;
+    /**
+     * Wrap an async operation with automatic logging
+     */
+    wrap<T>(tool: string, operation: () => Promise<T>, getDetails?: (result: T) => Partial<OperationLogEntry>): Promise<T>;
+    /**
+     * Get metrics for current session
+     */
+    getSessionMetrics(): Promise<SessionMetrics | null>;
+    /**
+     * Get aggregated metrics for time period
+     */
+    getMetrics(since?: Date, until?: Date): Promise<AggregatedMetrics>;
+    /**
+     * Flush write queue to disk
+     */
+    flush(): Promise<void>;
+    /**
+     * Read all log entries
+     */
+    private readEntries;
+    /**
+     * Anonymize vault path for privacy
+     */
+    private anonymizePath;
+    /**
+     * Schedule a flush with debounce
+     */
+    private scheduleFlush;
+}
+/**
+ * Create logger from vault's .flywheel.json config
+ */
+export declare function createLoggerFromConfig(vaultPath: string, product: ProductId): Promise<OperationLogger>;
+//# sourceMappingURL=operationLogger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operationLogger.d.ts","sourceRoot":"","sources":["../../src/logging/operationLogger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,SAAS,EACV,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,YAAY,CAA8C;gBAEtD,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAMlF;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BtF;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC;IA8Bb;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsCzD;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyFxE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B;;OAEG;YACW,WAAW;IAuBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,aAAa;CAUtB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,eAAe,CAAC,CAW1B"}

package/dist/logging/operationLogger.js

@@ -0,0 +1,282 @@
+/**
+ * Shared OperationLogger for Flywheel ecosystem
+ *
+ * Provides unified logging for both Flywheel (read) and Flywheel-Crank (write)
+ * with session correlation, metrics aggregation, and privacy controls.
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { DEFAULT_LOGGING_CONFIG } from './types.js';
+import { getSessionId } from './sessionManager.js';
+/**
+ * Shared operation logger
+ */
+export class OperationLogger {
+    config;
+    vaultPath;
+    product;
+    writeQueue = [];
+    flushTimeout = null;
+    constructor(vaultPath, product, config) {
+        this.vaultPath = vaultPath;
+        this.product = product;
+        this.config = { ...DEFAULT_LOGGING_CONFIG, ...config };
+    }
+    /**
+     * Check if logging is enabled
+     */
+    get enabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Log an operation
+     */
+    async log(entry) {
+        if (!this.config.enabled) {
+            return;
+        }
+        const fullEntry = {
+            ...entry,
+            ts: new Date().toISOString(),
+            product: this.product,
+            session: this.config.includeSessionIds ? getSessionId() : undefined,
+        };
+        // Apply privacy filters
+        if (!this.config.includeToolNames) {
+            fullEntry.tool = 'operation';
+        }
+        if (!this.config.includeDurations) {
+            fullEntry.duration_ms = 0;
+        }
+        if (!this.config.includeResults) {
+            delete fullEntry.results;
+        }
+        this.writeQueue.push(fullEntry);
+        this.scheduleFlush();
+    }
+    /**
+     * Wrap an async operation with automatic logging
+     */
+    async wrap(tool, operation, getDetails) {
+        const startTime = Date.now();
+        let success = true;
+        let error;
+        let result;
+        try {
+            result = await operation();
+            return result;
+        }
+        catch (e) {
+            success = false;
+            error = e instanceof Error ? e.message : String(e);
+            throw e;
+        }
+        finally {
+            const duration_ms = Date.now() - startTime;
+            const details = success && result !== undefined && getDetails
+                ? getDetails(result)
+                : {};
+            await this.log({
+                tool,
+                vault: this.anonymizePath(this.vaultPath),
+                duration_ms,
+                success,
+                error,
+                ...details,
+            });
+        }
+    }
+    /**
+     * Get metrics for current session
+     */
+    async getSessionMetrics() {
+        const sessionId = getSessionId();
+        const entries = await this.readEntries();
+        const sessionEntries = entries.filter(e => e.session === sessionId);
+        if (sessionEntries.length === 0) {
+            return null;
+        }
+        const operations = {
+            flywheel: {},
+            crank: {},
+        };
+        let successCount = 0;
+        let minTs = sessionEntries[0].ts;
+        let maxTs = sessionEntries[0].ts;
+        for (const entry of sessionEntries) {
+            const prod = entry.product;
+            operations[prod][entry.tool] = (operations[prod][entry.tool] || 0) + 1;
+            if (entry.success)
+                successCount++;
+            if (entry.ts < minTs)
+                minTs = entry.ts;
+            if (entry.ts > maxTs)
+                maxTs = entry.ts;
+        }
+        return {
+            session: sessionId,
+            duration_ms: new Date(maxTs).getTime() - new Date(minTs).getTime(),
+            operations,
+            total_operations: sessionEntries.length,
+            success_rate: (successCount / sessionEntries.length) * 100,
+            started: minTs,
+            ended: maxTs,
+        };
+    }
+    /**
+     * Get aggregated metrics for time period
+     */
+    async getMetrics(since, until) {
+        const entries = await this.readEntries();
+        const filtered = entries.filter(e => {
+            const ts = new Date(e.ts);
+            if (since && ts < since)
+                return false;
+            if (until && ts > until)
+                return false;
+            return true;
+        });
+        const durations = filtered.map(e => e.duration_ms);
+        const sorted = [...durations].sort((a, b) => a - b);
+        const byTool = {};
+        const byProduct = {
+            flywheel: { count: 0, success_rate: 0, mean_ms: 0 },
+            crank: { count: 0, success_rate: 0, mean_ms: 0 },
+        };
+        const productDurations = {
+            flywheel: [],
+            crank: [],
+        };
+        const productSuccess = {
+            flywheel: 0,
+            crank: 0,
+        };
+        for (const entry of filtered) {
+            // By tool
+            if (!byTool[entry.tool]) {
+                byTool[entry.tool] = {
+                    count: 0,
+                    success_rate: 0,
+                    mean_ms: 0,
+                    p95_ms: 0,
+                };
+            }
+            byTool[entry.tool].count++;
+            // By product
+            byProduct[entry.product].count++;
+            productDurations[entry.product].push(entry.duration_ms);
+            if (entry.success) {
+                productSuccess[entry.product]++;
+            }
+        }
+        // Calculate product metrics
+        for (const prod of ['flywheel', 'crank']) {
+            const ds = productDurations[prod];
+            if (ds.length > 0) {
+                byProduct[prod].mean_ms = ds.reduce((a, b) => a + b, 0) / ds.length;
+                byProduct[prod].success_rate = (productSuccess[prod] / ds.length) * 100;
+            }
+        }
+        // Calculate tool metrics
+        for (const tool of Object.keys(byTool)) {
+            const toolEntries = filtered.filter(e => e.tool === tool);
+            const toolDurations = toolEntries.map(e => e.duration_ms).sort((a, b) => a - b);
+            const successCount = toolEntries.filter(e => e.success).length;
+            byTool[tool].mean_ms = toolDurations.reduce((a, b) => a + b, 0) / toolDurations.length;
+            byTool[tool].success_rate = (successCount / toolEntries.length) * 100;
+            byTool[tool].p95_ms = toolDurations[Math.floor(toolDurations.length * 0.95)] || 0;
+        }
+        const successCount = filtered.filter(e => e.success).length;
+        return {
+            periodStart: since?.toISOString() || filtered[0]?.ts || new Date().toISOString(),
+            periodEnd: until?.toISOString() || filtered[filtered.length - 1]?.ts || new Date().toISOString(),
+            totalOperations: filtered.length,
+            successfulOperations: successCount,
+            failedOperations: filtered.length - successCount,
+            timing: {
+                mean_ms: durations.length > 0 ? durations.reduce((a, b) => a + b, 0) / durations.length : 0,
+                p50_ms: sorted[Math.floor(sorted.length * 0.5)] || 0,
+                p95_ms: sorted[Math.floor(sorted.length * 0.95)] || 0,
+                p99_ms: sorted[Math.floor(sorted.length * 0.99)] || 0,
+                min_ms: sorted[0] || 0,
+                max_ms: sorted[sorted.length - 1] || 0,
+            },
+            byTool,
+            byProduct,
+        };
+    }
+    /**
+     * Flush write queue to disk
+     */
+    async flush() {
+        if (this.writeQueue.length === 0) {
+            return;
+        }
+        const entries = this.writeQueue.splice(0, this.writeQueue.length);
+        const logPath = path.join(this.vaultPath, this.config.logPath);
+        // Ensure directory exists
+        await fs.mkdir(path.dirname(logPath), { recursive: true });
+        // Append entries as JSONL
+        const lines = entries.map(e => JSON.stringify(e)).join('\n') + '\n';
+        await fs.appendFile(logPath, lines);
+    }
+    /**
+     * Read all log entries
+     */
+    async readEntries() {
+        const logPath = path.join(this.vaultPath, this.config.logPath);
+        try {
+            const content = await fs.readFile(logPath, 'utf-8');
+            const entries = [];
+            for (const line of content.split('\n')) {
+                if (line.trim()) {
+                    try {
+                        entries.push(JSON.parse(line));
+                    }
+                    catch {
+                        // Skip malformed lines
+                    }
+                }
+            }
+            return entries;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Anonymize vault path for privacy
+     */
+    anonymizePath(vaultPath) {
+        // Use last directory name only
+        return path.basename(vaultPath);
+    }
+    /**
+     * Schedule a flush with debounce
+     */
+    scheduleFlush() {
+        if (this.flushTimeout) {
+            return;
+        }
+        this.flushTimeout = setTimeout(async () => {
+            this.flushTimeout = null;
+            await this.flush();
+        }, 1000); // 1 second debounce
+    }
+}
+/**
+ * Create logger from vault's .flywheel.json config
+ */
+export async function createLoggerFromConfig(vaultPath, product) {
+    const configPath = path.join(vaultPath, '.flywheel.json');
+    try {
+        const content = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        return new OperationLogger(vaultPath, product, config.logging);
+    }
+    catch {
+        // No config or invalid - use defaults
+        return new OperationLogger(vaultPath, product);
+    }
+}
+//# sourceMappingURL=operationLogger.js.map

package/dist/logging/operationLogger.js.map

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

package/dist/logging/sessionManager.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Session ID management for workflow correlation
+ *
+ * Allows tracking operations across a single agent workflow,
+ * correlating reads (Flywheel) and writes (Crank).
+ */
+/**
+ * Generate a unique session ID
+ */
+export declare function generateSessionId(): string;
+/**
+ * Get session ID from environment or generate new one
+ */
+export declare function getSessionId(): string;
+/**
+ * Set the session ID explicitly (for agent orchestration)
+ */
+export declare function setSessionId(sessionId: string): void;
+/**
+ * Clear the session (start fresh)
+ */
+export declare function clearSession(): void;
+/**
+ * Create a child session for sub-workflows
+ */
+export declare function createChildSession(parentSession: string): string;
+/**
+ * Extract parent session from child session ID
+ */
+export declare function getParentSession(sessionId: string): string | null;
+/**
+ * Check if session ID is a child of another
+ */
+export declare function isChildSession(sessionId: string, parentId: string): boolean;
+//# sourceMappingURL=sessionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManager.d.ts","sourceRoot":"","sources":["../../src/logging/sessionManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC;AAKD;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3E"}

package/dist/logging/sessionManager.js

@@ -0,0 +1,68 @@
+/**
+ * Session ID management for workflow correlation
+ *
+ * Allows tracking operations across a single agent workflow,
+ * correlating reads (Flywheel) and writes (Crank).
+ */
+import { randomBytes } from 'crypto';
+/**
+ * Generate a unique session ID
+ */
+export function generateSessionId() {
+    return randomBytes(8).toString('hex');
+}
+/**
+ * Get session ID from environment or generate new one
+ */
+export function getSessionId() {
+    // Check environment variable first (for agent-provided session)
+    const envSession = process.env.FLYWHEEL_SESSION_ID;
+    if (envSession) {
+        return envSession;
+    }
+    // Check for cached session in process
+    if (!globalSessionId) {
+        globalSessionId = generateSessionId();
+    }
+    return globalSessionId;
+}
+// Module-level session cache
+let globalSessionId = null;
+/**
+ * Set the session ID explicitly (for agent orchestration)
+ */
+export function setSessionId(sessionId) {
+    globalSessionId = sessionId;
+    process.env.FLYWHEEL_SESSION_ID = sessionId;
+}
+/**
+ * Clear the session (start fresh)
+ */
+export function clearSession() {
+    globalSessionId = null;
+    delete process.env.FLYWHEEL_SESSION_ID;
+}
+/**
+ * Create a child session for sub-workflows
+ */
+export function createChildSession(parentSession) {
+    const childId = randomBytes(4).toString('hex');
+    return `${parentSession}.${childId}`;
+}
+/**
+ * Extract parent session from child session ID
+ */
+export function getParentSession(sessionId) {
+    const parts = sessionId.split('.');
+    if (parts.length < 2) {
+        return null;
+    }
+    return parts.slice(0, -1).join('.');
+}
+/**
+ * Check if session ID is a child of another
+ */
+export function isChildSession(sessionId, parentId) {
+    return sessionId.startsWith(parentId + '.');
+}
+//# sourceMappingURL=sessionManager.js.map

package/dist/logging/sessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManager.js","sourceRoot":"","sources":["../../src/logging/sessionManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,gEAAgE;IAChE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACnD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,iBAAiB,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,6BAA6B;AAC7B,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,eAAe,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,SAAS,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,eAAe,GAAG,IAAI,CAAC;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,GAAG,aAAa,IAAI,OAAO,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAgB;IAChE,OAAO,SAAS,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/dist/logging/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Shared logging types for Flywheel ecosystem
+ *
+ * Used by both Flywheel (read) and Flywheel-Crank (write) for
+ * unified operation logging and metrics.
+ */
+/**
+ * Product identifier for log entries
+ */
+export type ProductId = 'flywheel' | 'crank';
+/**
+ * Single operation log entry
+ */
+export interface OperationLogEntry {
+    /** ISO timestamp */
+    ts: string;
+    /** Product that performed the operation */
+    product: ProductId;
+    /** Tool/function name */
+    tool: string;
+    /** Vault path (may be anonymized) */
+    vault: string;
+    /** Duration in milliseconds */
+    duration_ms: number;
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Session ID for workflow correlation */
+    session?: string;
+    /** Number of results returned (for queries) */
+    results?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session metrics for workflow tracking
+ */
+export interface SessionMetrics {
+    /** Session ID */
+    session: string;
+    /** Total duration in ms */
+    duration_ms: number;
+    /** Operations by product */
+    operations: {
+        flywheel: Record<string, number>;
+        crank: Record<string, number>;
+    };
+    /** Total operation count */
+    total_operations: number;
+    /** Success rate (0-100) */
+    success_rate: number;
+    /** First operation timestamp */
+    started: string;
+    /** Last operation timestamp */
+    ended: string;
+}
+/**
+ * Aggregated metrics over time period
+ */
+export interface AggregatedMetrics {
+    /** Period start (ISO) */
+    periodStart: string;
+    /** Period end (ISO) */
+    periodEnd: string;
+    /** Total operations */
+    totalOperations: number;
+    /** Successful operations */
+    successfulOperations: number;
+    /** Failed operations */
+    failedOperations: number;
+    /** Timing stats */
+    timing: {
+        mean_ms: number;
+        p50_ms: number;
+        p95_ms: number;
+        p99_ms: number;
+        min_ms: number;
+        max_ms: number;
+    };
+    /** Metrics by tool */
+    byTool: Record<string, {
+        count: number;
+        success_rate: number;
+        mean_ms: number;
+        p95_ms: number;
+    }>;
+    /** Metrics by product */
+    byProduct: Record<ProductId, {
+        count: number;
+        success_rate: number;
+        mean_ms: number;
+    }>;
+}
+/**
+ * Logging configuration
+ */
+export interface LoggingConfig {
+    /** Master switch (default: false) */
+    enabled: boolean;
+    /** Path to log file (relative to vault root) */
+    logPath: string;
+    /** Include tool names in logs */
+    includeToolNames: boolean;
+    /** Include timing data */
+    includeDurations: boolean;
+    /** Include session IDs for workflow correlation */
+    includeSessionIds: boolean;
+    /** Include result counts (may reveal vault size) */
+    includeResults: boolean;
+    /** Log rotation settings */
+    rotation?: {
+        maxSize: string;
+        maxFiles: number;
+    };
+    /** Retention in days */
+    retentionDays?: number;
+}
+/**
+ * Default logging configuration (disabled by default)
+ */
+export declare const DEFAULT_LOGGING_CONFIG: LoggingConfig;
+//# sourceMappingURL=types.d.ts.map