@vibesdotdev/logging 0.0.1

package/package.json

@@ -0,0 +1,331 @@
+{
+  "name": "@vibesdotdev/logging",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/logging.plugin.d.ts",
+      "bun": "./src/logging.plugin.ts",
+      "import": "./dist/logging.plugin.js",
+      "default": "./dist/logging.plugin.js"
+    },
+    "./cli.plugin": {
+      "types": "./dist/logging.cli.plugin.d.ts",
+      "bun": "./src/logging.cli.plugin.ts",
+      "import": "./dist/logging.cli.plugin.js",
+      "default": "./dist/logging.cli.plugin.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "bun": "./src/core/index.ts",
+      "import": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    },
+    "./core/logger": {
+      "types": "./dist/core/logger.d.ts",
+      "bun": "./src/core/logger.ts",
+      "import": "./dist/core/logger.js",
+      "default": "./dist/core/logger.js"
+    },
+    "./core/namespace": {
+      "types": "./dist/core/namespace.d.ts",
+      "bun": "./src/core/namespace.ts",
+      "import": "./dist/core/namespace.js",
+      "default": "./dist/core/namespace.js"
+    },
+    "./kinds": {
+      "types": "./dist/kinds/index.d.ts",
+      "bun": "./src/kinds/index.ts",
+      "import": "./dist/kinds/index.js",
+      "default": "./dist/kinds/index.js"
+    },
+    "./kinds/sink": {
+      "types": "./dist/kinds/sink.d.ts",
+      "bun": "./src/kinds/sink.ts",
+      "import": "./dist/kinds/sink.js",
+      "default": "./dist/kinds/sink.js"
+    },
+    "./kinds/formatter": {
+      "types": "./dist/kinds/formatter.d.ts",
+      "bun": "./src/kinds/formatter.ts",
+      "import": "./dist/kinds/formatter.js",
+      "default": "./dist/kinds/formatter.js"
+    },
+    "./kinds/output": {
+      "types": "./dist/kinds/output.d.ts",
+      "bun": "./src/kinds/output.ts",
+      "import": "./dist/kinds/output.js",
+      "default": "./dist/kinds/output.js"
+    },
+    "./kinds/audit": {
+      "types": "./dist/kinds/audit.d.ts",
+      "bun": "./src/kinds/audit.ts",
+      "import": "./dist/kinds/audit.js",
+      "default": "./dist/kinds/audit.js"
+    },
+    "./kinds/logger": {
+      "types": "./dist/kinds/logger.d.ts",
+      "bun": "./src/kinds/logger.ts",
+      "import": "./dist/kinds/logger.js",
+      "default": "./dist/kinds/logger.js"
+    },
+    "./kinds/logger.impl": {
+      "types": "./dist/kinds/logger.impl.d.ts",
+      "bun": "./src/kinds/logger.impl.ts",
+      "import": "./dist/kinds/logger.impl.js",
+      "default": "./dist/kinds/logger.impl.js"
+    },
+    "./paths": {
+      "types": "./dist/paths.d.ts",
+      "bun": "./src/paths.ts",
+      "import": "./dist/paths.js",
+      "default": "./dist/paths.js"
+    },
+    "./contexts": {
+      "types": "./dist/contexts/index.d.ts",
+      "bun": "./src/contexts/index.ts",
+      "import": "./dist/contexts/index.js",
+      "default": "./dist/contexts/index.js"
+    },
+    "./contexts/logger": {
+      "types": "./dist/contexts/logger.d.ts",
+      "bun": "./src/contexts/logger.ts",
+      "import": "./dist/contexts/logger.js",
+      "default": "./dist/contexts/logger.js"
+    },
+    "./contexts/audit": {
+      "types": "./dist/contexts/audit.d.ts",
+      "bun": "./src/contexts/audit.ts",
+      "import": "./dist/contexts/audit.js",
+      "default": "./dist/contexts/audit.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "bun": "./src/schemas/index.ts",
+      "import": "./dist/schemas/index.js",
+      "default": "./dist/schemas/index.js"
+    },
+    "./schemas/entry": {
+      "types": "./dist/schemas/entry.d.ts",
+      "bun": "./src/schemas/entry.ts",
+      "import": "./dist/schemas/entry.js",
+      "default": "./dist/schemas/entry.js"
+    },
+    "./schemas/sink": {
+      "types": "./dist/schemas/sink.d.ts",
+      "bun": "./src/schemas/sink.ts",
+      "import": "./dist/schemas/sink.js",
+      "default": "./dist/schemas/sink.js"
+    },
+    "./schemas/formatter": {
+      "types": "./dist/schemas/formatter.d.ts",
+      "bun": "./src/schemas/formatter.ts",
+      "import": "./dist/schemas/formatter.js",
+      "default": "./dist/schemas/formatter.js"
+    },
+    "./schemas/output": {
+      "types": "./dist/schemas/output.d.ts",
+      "bun": "./src/schemas/output.ts",
+      "import": "./dist/schemas/output.js",
+      "default": "./dist/schemas/output.js"
+    },
+    "./schemas/audit": {
+      "types": "./dist/schemas/audit.d.ts",
+      "bun": "./src/schemas/audit.ts",
+      "import": "./dist/schemas/audit.js",
+      "default": "./dist/schemas/audit.js"
+    },
+    "./schemas/logger": {
+      "types": "./dist/schemas/logger.d.ts",
+      "bun": "./src/schemas/logger.ts",
+      "import": "./dist/schemas/logger.js",
+      "default": "./dist/schemas/logger.js"
+    },
+    "./sinks": {
+      "types": "./dist/sinks/index.d.ts",
+      "bun": "./src/sinks/index.ts",
+      "import": "./dist/sinks/index.js",
+      "default": "./dist/sinks/index.js"
+    },
+    "./formatters": {
+      "types": "./dist/formatters/index.d.ts",
+      "bun": "./src/formatters/index.ts",
+      "import": "./dist/formatters/index.js",
+      "default": "./dist/formatters/index.js"
+    },
+    "./outputs": {
+      "types": "./dist/outputs/index.d.ts",
+      "bun": "./src/outputs/index.ts",
+      "import": "./dist/outputs/index.js",
+      "default": "./dist/outputs/index.js"
+    },
+    "./audit": {
+      "types": "./dist/audit/index.d.ts",
+      "bun": "./src/audit/index.ts",
+      "import": "./dist/audit/index.js",
+      "default": "./dist/audit/index.js"
+    },
+    "./audit/audit.descriptor": {
+      "types": "./dist/audit/audit.descriptor.d.ts",
+      "bun": "./src/audit/audit.descriptor.ts",
+      "import": "./dist/audit/audit.descriptor.js",
+      "default": "./dist/audit/audit.descriptor.js"
+    },
+    "./cli/types": {
+      "types": "./dist/cli/types.d.ts",
+      "bun": "./src/cli/types.ts",
+      "import": "./dist/cli/types.js",
+      "default": "./dist/cli/types.js"
+    },
+    "./cli/logs.descriptor": {
+      "types": "./dist/cli/logs.descriptor.d.ts",
+      "bun": "./src/cli/logs.descriptor.ts",
+      "import": "./dist/cli/logs.descriptor.js",
+      "default": "./dist/cli/logs.descriptor.js"
+    },
+    "./cli/logs.list.descriptor": {
+      "types": "./dist/cli/logs.list.descriptor.d.ts",
+      "bun": "./src/cli/logs.list.descriptor.ts",
+      "import": "./dist/cli/logs.list.descriptor.js",
+      "default": "./dist/cli/logs.list.descriptor.js"
+    },
+    "./cli/logs.list.impl": {
+      "types": "./dist/cli/logs.list.impl.d.ts",
+      "bun": "./src/cli/logs.list.impl.ts",
+      "import": "./dist/cli/logs.list.impl.js",
+      "default": "./dist/cli/logs.list.impl.js"
+    },
+    "./cli/logs.search.descriptor": {
+      "types": "./dist/cli/logs.search.descriptor.d.ts",
+      "bun": "./src/cli/logs.search.descriptor.ts",
+      "import": "./dist/cli/logs.search.descriptor.js",
+      "default": "./dist/cli/logs.search.descriptor.js"
+    },
+    "./cli/logs.search.impl": {
+      "types": "./dist/cli/logs.search.impl.d.ts",
+      "bun": "./src/cli/logs.search.impl.ts",
+      "import": "./dist/cli/logs.search.impl.js",
+      "default": "./dist/cli/logs.search.impl.js"
+    },
+    "./cli/logs.tail.descriptor": {
+      "types": "./dist/cli/logs.tail.descriptor.d.ts",
+      "bun": "./src/cli/logs.tail.descriptor.ts",
+      "import": "./dist/cli/logs.tail.descriptor.js",
+      "default": "./dist/cli/logs.tail.descriptor.js"
+    },
+    "./cli/logs.tail.impl": {
+      "types": "./dist/cli/logs.tail.impl.d.ts",
+      "bun": "./src/cli/logs.tail.impl.ts",
+      "import": "./dist/cli/logs.tail.impl.js",
+      "default": "./dist/cli/logs.tail.impl.js"
+    },
+    "./cli/logs.rotate.descriptor": {
+      "types": "./dist/cli/logs.rotate.descriptor.d.ts",
+      "bun": "./src/cli/logs.rotate.descriptor.ts",
+      "import": "./dist/cli/logs.rotate.descriptor.js",
+      "default": "./dist/cli/logs.rotate.descriptor.js"
+    },
+    "./cli/logs.rotate.impl": {
+      "types": "./dist/cli/logs.rotate.impl.d.ts",
+      "bun": "./src/cli/logs.rotate.impl.ts",
+      "import": "./dist/cli/logs.rotate.impl.js",
+      "default": "./dist/cli/logs.rotate.impl.js"
+    },
+    "./cli/logs.view.descriptor": {
+      "types": "./dist/cli/logs.view.descriptor.d.ts",
+      "bun": "./src/cli/logs.view.descriptor.ts",
+      "import": "./dist/cli/logs.view.descriptor.js",
+      "default": "./dist/cli/logs.view.descriptor.js"
+    },
+    "./cli/logs.view.impl": {
+      "types": "./dist/cli/logs.view.impl.d.ts",
+      "bun": "./src/cli/logs.view.impl.ts",
+      "import": "./dist/cli/logs.view.impl.js",
+      "default": "./dist/cli/logs.view.impl.js"
+    },
+    "./docs": {
+      "types": "./dist/docs/index.d.ts",
+      "bun": "./src/docs/index.ts",
+      "import": "./dist/docs/index.js",
+      "default": "./dist/docs/index.js"
+    },
+    "./docs/levels": {
+      "types": "./dist/docs/levels.docs.descriptor.d.ts",
+      "bun": "./src/docs/levels.docs.descriptor.ts",
+      "import": "./dist/docs/levels.docs.descriptor.js",
+      "default": "./dist/docs/levels.docs.descriptor.js"
+    },
+    "./docs/structured": {
+      "types": "./dist/docs/structured.docs.descriptor.d.ts",
+      "bun": "./src/docs/structured.docs.descriptor.ts",
+      "import": "./dist/docs/structured.docs.descriptor.js",
+      "default": "./dist/docs/structured.docs.descriptor.js"
+    },
+    "./docs/transports": {
+      "types": "./dist/docs/transports.docs.descriptor.d.ts",
+      "bun": "./src/docs/transports.docs.descriptor.ts",
+      "import": "./dist/docs/transports.docs.descriptor.js",
+      "default": "./dist/docs/transports.docs.descriptor.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vibesdotdev/monorepo.git",
+    "directory": "packages/logging"
+  },
+  "peerDependencies": {
+    "@vibesdotdev/runtime": "0.0.1"
+  },
+  "dependencies": {
+    "@vibesdotdev/runtime": "0.0.1",
+    "zod": "^4.3.6",
+    "esm-env": "^1.2.2",
+    "ansis": "^4.3.0",
+    "json5": "^2.2.3"
+  },
+  "scripts": {
+    "test": "bun test",
+    "check": "bun --bun tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json && bun ../../scripts/rewrite-dist-ts-imports.ts dist"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src",
+    "bin",
+    "README.md",
+    "SPEC.md",
+    "LICENSE",
+    "!src/**/__tests__/**",
+    "!src/**/__stubs__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "!dist/**/__tests__/**",
+    "!dist/**/__stubs__/**",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/*.spec.js",
+    "!dist/**/*.spec.js.map",
+    "!dist/**/*.spec.d.ts",
+    "!dist/**/*.spec.d.ts.map"
+  ],
+  "vibes": {
+    "visibility": "public-framework"
+  }
+}

package/src/audit/audit.descriptor.ts

@@ -0,0 +1,45 @@
+/**
+ * Default Audit Descriptor
+ *
+ * Generic audit logging configuration.
+ */
+
+import type { AuditDescriptor } from '../schemas/audit.ts';
+
+export const defaultAuditDescriptor: AuditDescriptor = {
+	kind: 'logging/audit',
+	id: 'default',
+	name: 'Default Audit Logger',
+	description: 'Default audit logging for all categories',
+	tags: ['compliance', 'security'],
+	category: 'system',
+	severity: 'low',
+	retention: '90d',
+	immutable: true
+};
+
+export const authenticationAuditDescriptor: AuditDescriptor = {
+	kind: 'logging/audit',
+	id: 'authentication',
+	name: 'Authentication Audit Logger',
+	description: 'Audit logging for authentication events',
+	tags: ['auth', 'security'],
+	category: 'authentication',
+	severity: 'medium',
+	retention: '1y',
+	immutable: true
+};
+
+export const securityAuditDescriptor: AuditDescriptor = {
+	kind: 'logging/audit',
+	id: 'security',
+	name: 'Security Audit Logger',
+	description: 'Audit logging for security events',
+	tags: ['security', 'compliance'],
+	category: 'security',
+	severity: 'high',
+	retention: '2y',
+	immutable: true
+};
+
+export default defaultAuditDescriptor;

package/src/audit/audit.storage.schema.ts

@@ -0,0 +1,57 @@
+import * as z from 'zod/v4';
+import { AuditCategorySchema, AuditEntrySchema } from '../schemas/audit.ts';
+
+export const AuditEntryStorageSchema = AuditEntrySchema.extend({
+	pk: z.number().int().optional(),
+	createdAt: z.date().optional(),
+	actorId: z.string(),
+	actorType: z.enum(['user', 'service', 'system']),
+	targetId: z.string().optional(),
+	targetType: z.string().optional()
+});
+export type AuditEntryStorage = z.infer<typeof AuditEntryStorageSchema>;
+
+export interface AuditRetentionPolicy {
+	category: z.infer<typeof AuditCategorySchema>;
+	retentionDays: number;
+	archive: boolean;
+	archivePath?: string;
+}
+
+export const DEFAULT_RETENTION_POLICIES: AuditRetentionPolicy[] = [
+	{ category: 'authentication', retentionDays: 365, archive: true },
+	{ category: 'authorization', retentionDays: 365, archive: true },
+	{ category: 'security', retentionDays: 730, archive: true },
+	{ category: 'data_access', retentionDays: 90, archive: false },
+	{ category: 'data_modification', retentionDays: 365, archive: true },
+	{ category: 'configuration', retentionDays: 365, archive: true },
+	{ category: 'system', retentionDays: 90, archive: false }
+];
+
+export interface AuditStorageConfig {
+	adapter: 'drizzle' | 'localdb';
+	tableName: string;
+	indexes: {
+		category: boolean;
+		severity: boolean;
+		actorId: boolean;
+		targetId: boolean;
+		timestamp: boolean;
+		action: boolean;
+	};
+	retention: AuditRetentionPolicy[];
+}
+
+export const defaultAuditStorageConfig: AuditStorageConfig = {
+	adapter: 'drizzle',
+	tableName: 'audit_entries',
+	indexes: {
+		category: true,
+		severity: true,
+		actorId: true,
+		targetId: true,
+		timestamp: true,
+		action: true
+	},
+	retention: DEFAULT_RETENTION_POLICIES
+};

package/src/audit/index.ts

@@ -0,0 +1,8 @@
+export {
+	AuditEntryStorageSchema,
+	type AuditEntryStorage,
+	type AuditRetentionPolicy,
+	DEFAULT_RETENTION_POLICIES,
+	type AuditStorageConfig,
+	defaultAuditStorageConfig
+} from './audit.storage.schema';

package/src/cli/logs.descriptor.ts

@@ -0,0 +1,19 @@
+/**
+ * Logs CLI Group Descriptor
+ *
+ * Root group for log management commands.
+ */
+
+import type { CLIGroupAssetDescriptor } from './types.ts';
+
+const descriptor: CLIGroupAssetDescriptor = {
+	kind: 'cli/group',
+	id: 'logs',
+	name: 'logs',
+	description: 'View and manage application logs',
+	surfaces: ['cli'],
+	hardware: ['consumer', 'cloud'],
+	enabled: true
+};
+
+export default descriptor;

package/src/cli/logs.list.descriptor.ts

@@ -0,0 +1,28 @@
+/**
+ * Logs List CLI Command Descriptor
+ *
+ * Lists all registered log outputs.
+ */
+
+import type { CLICommandAssetDescriptor } from './types.ts';
+
+const descriptor: CLICommandAssetDescriptor = {
+	kind: 'cli/command',
+	id: 'logs.list',
+	name: 'list',
+	description: 'List registered log outputs and their status',
+	group: 'logs',
+
+	options: [
+		{
+			flags: '--json',
+			description: 'Output as JSON'
+		}
+	],
+
+	surfaces: ['cli'],
+	hardware: ['consumer', 'cloud'],
+	enabled: true
+};
+
+export default descriptor;

package/src/cli/logs.list.impl.ts

@@ -0,0 +1,93 @@
+/**
+ * Logs List CLI Command Implementation
+ *
+ * Lists all registered log outputs with their status.
+ */
+
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+import type { OutputDescriptor } from '../schemas/output.ts';
+import type { OutputImplementation } from '../kinds/output.ts';
+
+interface ListOptions {
+	json?: boolean;
+}
+
+export default {
+	async execute(_args: Record<string, unknown>, opts: ListOptions): Promise<void> {
+		const runtime = getVibesRuntime();
+
+		// Get all output descriptors
+		const descriptors = runtime
+			.query<OutputDescriptor, OutputImplementation>('logging/output')
+			.enabled()
+			.descriptors();
+
+		if (descriptors.length === 0) {
+			console.log('No log outputs registered.');
+			return;
+		}
+
+		if (opts.json) {
+			const items = await Promise.all(
+				descriptors.map(async (d) => {
+					try {
+						const output = await runtime
+							.query<OutputDescriptor, OutputImplementation>('logging/output')
+							.withId(d.id)
+							.resolve();
+						const stats = await output.stats();
+						return {
+							id: d.id,
+							name: d.name,
+							storage: d.storage,
+							path: d.path,
+							format: d.format,
+							hardware: d.hardware,
+							stats
+						};
+					} catch {
+						return {
+							id: d.id,
+							name: d.name,
+							storage: d.storage,
+							path: d.path,
+							format: d.format,
+							hardware: d.hardware,
+							stats: null
+						};
+					}
+				})
+			);
+			console.log(JSON.stringify(items, null, 2));
+			return;
+		}
+
+		console.log('\n Log Outputs\n');
+
+		for (const d of descriptors) {
+			let statsLine = '';
+			try {
+				const output = await runtime
+					.query<OutputDescriptor, OutputImplementation>('logging/output')
+					.withId(d.id)
+					.resolve();
+				const stats = await output.stats();
+				if (stats.exists) {
+					const sizeKb = (stats.size / 1024).toFixed(1);
+					const modified = stats.modifiedAt?.toLocaleString() ?? 'unknown';
+					statsLine = `  Size: ${sizeKb}KB, Modified: ${modified}`;
+				} else {
+					statsLine = '  (no file yet)';
+				}
+			} catch {
+				statsLine = '  (unable to get stats)';
+			}
+
+			console.log(`  ${d.id}`);
+			console.log(`    Storage: ${d.storage ?? 'file'} | Format: ${d.format ?? 'jsonl'}`);
+			console.log(`    Path: ${d.path ?? 'default'}`);
+			console.log(statsLine);
+			console.log('');
+		}
+	}
+};

package/src/cli/logs.rotate.descriptor.ts

@@ -0,0 +1,40 @@
+/**
+ * Logs Rotate CLI Command Descriptor
+ *
+ * Rotate a log output file.
+ */
+
+import type { CLICommandAssetDescriptor } from './types.ts';
+
+const descriptor: CLICommandAssetDescriptor = {
+	kind: 'cli/command',
+	id: 'logs.rotate',
+	name: 'rotate',
+	description: 'Rotate a log output file',
+	group: 'logs',
+
+	arguments: [
+		{
+			name: 'output',
+			description: 'Output ID to rotate',
+			required: true
+		}
+	],
+
+	options: [
+		{
+			flags: '--all',
+			description: 'Rotate all outputs'
+		},
+		{
+			flags: '--cleanup',
+			description: 'Also run cleanup of old rotated files'
+		}
+	],
+
+	surfaces: ['cli'],
+	hardware: ['consumer'],
+	enabled: true
+};
+
+export default descriptor;

package/src/cli/logs.rotate.impl.ts

@@ -0,0 +1,61 @@
+/**
+ * Logs Rotate CLI Command Implementation
+ *
+ * Rotate log output files.
+ */
+
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+import type { OutputDescriptor } from '../schemas/output.ts';
+import type { OutputImplementation } from '../kinds/output.ts';
+
+interface RotateArgs {
+	output?: string;
+}
+
+interface RotateOptions {
+	all?: boolean;
+	cleanup?: boolean;
+}
+
+export default {
+	async execute(args: RotateArgs, opts: RotateOptions): Promise<void> {
+		const runtime = getVibesRuntime();
+
+		// Get outputs to rotate
+		let outputIds: string[];
+		if (opts.all) {
+			const descriptors = runtime
+				.query<OutputDescriptor, OutputImplementation>('logging/output')
+				.enabled()
+				.descriptors();
+			outputIds = descriptors.map((d) => d.id);
+		} else if (args.output) {
+			outputIds = [args.output];
+		} else {
+			console.error('Please specify an output ID or use --all to rotate all outputs.');
+			process.exit(1);
+		}
+
+		console.log('\n🔄 Rotating logs...\n');
+
+		for (const outputId of outputIds) {
+			try {
+				const output = await runtime
+					.query<OutputDescriptor, OutputImplementation>('logging/output')
+					.withId(outputId)
+					.resolve();
+
+				if (output.rotate) {
+					const { archived } = await output.rotate();
+					console.log(`  ✓ ${outputId} → ${archived}`);
+				} else {
+					console.log(`  - ${outputId} (rotation not supported)`);
+				}
+			} catch (err) {
+				console.log(`  ✗ ${outputId}: ${err instanceof Error ? err.message : String(err)}`);
+			}
+		}
+
+		console.log('\nDone.\n');
+	}
+};