@vibesdotdev/logging 0.0.1

package/README.md

@@ -0,0 +1,80 @@
+# @vibesdotdev/logging
+
+Universal logging core for vibes. Defines the runtime kinds, the core logger,
+isomorphic sinks/formatters, and the audit kind. Environment-specific sinks
+(file, browser, OTEL) live in sibling packages.
+
+## Quickstart
+
+```ts
+import { getLogger, getDefaultLogger } from '@vibesdotdev/logging';
+
+const logger = getLogger('myapp');
+logger.info('Started', { version: '1.0.0' });
+logger.error('Failed', { error: err.message });
+
+const child = logger.child('database');
+child.debug('Connected');
+
+const contextual = logger.withRequestContext({
+  requestId: 'req-123',
+  userId: 'user-456',
+});
+contextual.info('Request handled');
+```
+
+### Audit
+
+```ts
+import { auditLog } from '@vibesdotdev/logging/audit';
+
+await auditLog({
+  category: 'authentication',
+  severity: 'medium',
+  action: 'login',
+  actor: { id: 'user-123', type: 'user' },
+  outcome: 'success',
+});
+```
+
+### Filter via env
+
+```bash
+VIBES_LOG='vibes:pm:*,-vibes:pm:verbose' \
+VIBES_LOG_LEVEL=debug \
+bun run app
+```
+
+## CLI
+
+```bash
+vibes logs list
+vibes logs view <output>
+vibes logs tail <output>
+vibes logs search <pattern>
+vibes logs rotate <output>
+```
+
+## Sinks
+
+Core ships isomorphic sinks only:
+- `console` — colorized stderr
+- `buffer` — in-memory startup buffer
+- `memory` — testable in-memory store
+- `stdout` — raw stderr (MCP-safe)
+
+Environment-specific sinks load from sibling packages (apps choose what to load):
+- [`@vibesdotdev/logging-fs`](../logging-fs/) — file sink, file output, stdout-capture, file-backed audit
+- [`@vibesdotdev/logging-browser`](../logging-browser/) — browser sink
+- [`@vibesdotdev/logging-otel`](../logging-otel/) — OpenTelemetry sink
+
+## Test
+
+```bash
+bun test
+```
+
+## Docs
+
+- [SPEC.md](./SPEC.md) — package contract, owned surfaces, hard rules, migration debt
+- [runtime](../runtime/SPEC.md), [runtime-plugin](../runtime-plugin/SPEC.md)

package/SPEC.md

@@ -0,0 +1,65 @@
+# @vibesdotdev/logging
+
+Structured logging for vibes. Universal core: kinds, schemas, core logger, isomorphic sinks/formatters/outputs, audit kind, MCP-safe defaults. Environment-specific sinks live in sibling packages and register themselves.
+
+## Owns
+
+- **Runtime kinds:** `logging/sink`, `logging/formatter`, `logging/output`, `logging/audit`, `logging/logger`
+- **Context providers:** `logging/sinks`, `logging/outputs`, `cli/logger`
+- **Core** (`./core`): `createRuntimeLogger`, `getLogger(namespace)`, `getDefaultLogger`, child loggers, `withRequestContext`, glob-based namespace settings + per-namespace level
+- **Isomorphic sinks** (`./sinks/*`): `console`, `buffer`, `memory`, `stdout`
+- **Formatters** (`./formatters/*`): `jsonl`, `json`, `json5`, `pretty` (pure transforms — universal)
+- **Universal outputs** (`./outputs/*`): `remote` (HTTP via fetch)
+- **Audit** (`./audit`): `logging/audit` kind, descriptor schema, retention-policy schema. File-backed impl extracts to [`logging-fs`](../logging-fs/).
+- **Schemas** (`./schemas`): `LogLevelSchema`, `RuntimeLogEntry`, `SinkDescriptor`, `FormatterDescriptor`, `OutputDescriptor`, `AuditEntry`, `AuditDescriptor`, `LoggerDescriptor`
+- **CLI** (`./cli`): `vibes logs` group + `list/view/tail/search/rotate` descriptors. Commands query the runtime; they do not import environment-specific sinks/outputs.
+- **Paths** (`./paths`): canonical log file path resolution (string-only, no FS)
+- **Plugins:** `./plugin` (root) and `./cli-plugin` (CLI commands) — register kinds + isomorphic sinks/formatters/outputs only
+
+## Does not own
+
+- **Filesystem-backed sinks/outputs/audit impl** → [`logging-fs`](../logging-fs/) — `file` sink, `file` output, `stdout-capture` sink, file-backed audit logger
+- **Browser sink** → [`logging-browser`](../logging-browser/)
+- **OpenTelemetry sink** → [`logging-otel`](../logging-otel/) — owns OTEL peer deps
+- **Daemon-specific logger config** → [`runtime-plugin/logging`](../runtime-plugin/SPEC.md)
+- **App-specific audit policies.** Apps register their own `logging/audit` descriptors with domain rules.
+- **Logging consumers** (apps calling `getLogger`)
+- **Durable archival** (S3, etc.) — that's an output adapter, not core
+
+## Hard rules
+
+- **The core package is universal.** No Node/Bun/FS/process imports in core. Anything that breaks browser or Cloudflare bundles belongs in an environment-specific package.
+- **All logging through `getLogger(ns)` / `getDefaultLogger()`.** No raw `console.log` in features.
+- **Stdout is reserved (MCP-safe).** Universal sinks default to stderr. The `stdout-capture` sink (in `logging-fs`) redirects rogue stdout to a file.
+- **Sink/output/audit selection is runtime-resolved.** Apps register descriptors; the runtime composes them into `logging/sinks` and `logging/outputs` context providers.
+- **Sink package contract:** each environment-specific package exports a plugin that registers `logging/sink`, `logging/output`, or `logging/audit` descriptors + impls. Apps load only the packages their scope can support. Core never imports them.
+- **Namespaces are colon-separated, hierarchical.** Filter via `VIBES_LOG` (globs with `+/-`); level via `VIBES_LOG_LEVEL`.
+- **Audit entries are immutable, append-only, retention by category.** Categories: `authentication`, `authorization`, `security`, `data_access`, `data_modification`, `configuration`, `system`.
+
+## Public entrypoints
+
+`.`, `./plugin`, `./cli-plugin`, `./core`, `./core/logger`, `./core/namespace`, `./kinds`, `./kinds/sink`, `./kinds/formatter`, `./kinds/output`, `./kinds/audit`, `./kinds/logger`, `./kinds/logger.impl`, `./paths`, `./contexts`, `./contexts/logger`, `./contexts/audit`, `./schemas`, `./schemas/entry`, `./schemas/sink`, `./schemas/formatter`, `./schemas/output`, `./schemas/audit`, `./schemas/logger`, `./sinks` (universal-only barrel), `./formatters`, `./outputs` (universal-only barrel), `./audit` (kind/schema only), `./cli/types`, `./cli/logs.descriptor`, `./cli/logs.list.descriptor`, `./cli/logs.list.impl`, `./cli/logs.search.descriptor`, `./cli/logs.search.impl`, `./cli/logs.tail.descriptor`, `./cli/logs.tail.impl`, `./cli/logs.rotate.descriptor`, `./cli/logs.rotate.impl`, `./cli/logs.view.descriptor`, `./cli/logs.view.impl`.
+
+Per-adapter sub-subpaths (`./sinks/console`, `./formatters/json`, `./outputs/remote`, …) are intentionally not exposed: the canonical access pattern is descriptor registration via the plugin + `runtime.query('logging/sink' | 'logging/formatter' | 'logging/output')`. Consumers do not import the impl files directly.
+
+## Environment
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `VIBES_LOG` | — | Namespace selectors (`vibes:pm:*,-vibes:pm:verbose`) |
+| `VIBES_LOG_LEVEL` | `info` | Minimum level |
+| `VIBES_LOG_DIR` | `~/.vibes/logs` | Log directory (consumed by `logging-fs`) |
+| `VIBES_LOG_FILE` | `app.jsonl` | File sink filename (consumed by `logging-fs`) |
+| `OTEL_SERVICE_NAME` | `vibes` | OTEL service name (consumed by `logging-otel`) |
+| `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | `http://localhost:4318/v1/logs` | OTEL endpoint |
+| `MCP_ENABLE_STDERR` | `false` | Mirror captured stdout to stderr |
+
+## Verification
+
+`bun test` from package root. Covers schemas, namespace globs, core logger + context providers, isomorphic sinks/formatters, `remote` output, audit retention policy. Environment-specific tests live in each extract package.
+
+## Links
+
+- [runtime/SPEC.md](../runtime/SPEC.md)
+- [runtime-plugin/SPEC.md](../runtime-plugin/SPEC.md)
+- [logging-fs](../logging-fs/), [logging-browser](../logging-browser/), [logging-otel](../logging-otel/)

package/dist/audit/audit.descriptor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default Audit Descriptor
+ *
+ * Generic audit logging configuration.
+ */
+import type { AuditDescriptor } from '../schemas/audit.ts';
+export declare const defaultAuditDescriptor: AuditDescriptor;
+export declare const authenticationAuditDescriptor: AuditDescriptor;
+export declare const securityAuditDescriptor: AuditDescriptor;
+export default defaultAuditDescriptor;
+//# sourceMappingURL=audit.descriptor.d.ts.map

package/dist/audit/audit.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.descriptor.d.ts","sourceRoot":"","sources":["../../src/audit/audit.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,eAAO,MAAM,sBAAsB,EAAE,eAUpC,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,eAU3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAUrC,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/audit/audit.descriptor.js

@@ -0,0 +1,40 @@
+/**
+ * Default Audit Descriptor
+ *
+ * Generic audit logging configuration.
+ */
+export const defaultAuditDescriptor = {
+    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 = {
+    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 = {
+    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;
+//# sourceMappingURL=audit.descriptor.js.map

package/dist/audit/audit.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.descriptor.js","sourceRoot":"","sources":["../../src/audit/audit.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAoB;IACtD,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,0CAA0C;IACvD,IAAI,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;IAChC,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,IAAI;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAoB;IAC7D,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,yCAAyC;IACtD,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;IAC1B,QAAQ,EAAE,gBAAgB;IAC1B,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAoB;IACvD,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,mCAAmC;IAChD,IAAI,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;IAChC,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;CACf,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/audit/audit.storage.schema.d.ts

@@ -0,0 +1,79 @@
+import * as z from 'zod/v4';
+import { AuditCategorySchema } from '../schemas/audit.ts';
+export declare const AuditEntryStorageSchema: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    category: z.ZodEnum<{
+        system: "system";
+        authentication: "authentication";
+        authorization: "authorization";
+        data_access: "data_access";
+        data_modification: "data_modification";
+        configuration: "configuration";
+        security: "security";
+    }>;
+    severity: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        critical: "critical";
+    }>;
+    action: z.ZodString;
+    actor: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            service: "service";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        ip: z.ZodOptional<z.ZodString>;
+        userAgent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    target: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    outcome: z.ZodEnum<{
+        error: "error";
+        unknown: "unknown";
+        success: "success";
+        failure: "failure";
+    }>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    error: z.ZodOptional<z.ZodString>;
+    pk: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodOptional<z.ZodDate>;
+    actorId: z.ZodString;
+    actorType: z.ZodEnum<{
+        user: "user";
+        system: "system";
+        service: "service";
+    }>;
+    targetId: z.ZodOptional<z.ZodString>;
+    targetType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AuditEntryStorage = z.infer<typeof AuditEntryStorageSchema>;
+export interface AuditRetentionPolicy {
+    category: z.infer<typeof AuditCategorySchema>;
+    retentionDays: number;
+    archive: boolean;
+    archivePath?: string;
+}
+export declare const DEFAULT_RETENTION_POLICIES: AuditRetentionPolicy[];
+export interface AuditStorageConfig {
+    adapter: 'drizzle' | 'localdb';
+    tableName: string;
+    indexes: {
+        category: boolean;
+        severity: boolean;
+        actorId: boolean;
+        targetId: boolean;
+        timestamp: boolean;
+        action: boolean;
+    };
+    retention: AuditRetentionPolicy[];
+}
+export declare const defaultAuditStorageConfig: AuditStorageConfig;
+//# sourceMappingURL=audit.storage.schema.d.ts.map

package/dist/audit/audit.storage.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.storage.schema.d.ts","sourceRoot":"","sources":["../../src/audit/audit.storage.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAoB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,0BAA0B,EAAE,oBAAoB,EAQ5D,CAAC;AAEF,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACR,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,SAAS,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,yBAAyB,EAAE,kBAYvC,CAAC"}

package/dist/audit/audit.storage.schema.js

@@ -0,0 +1,33 @@
+import * as z from 'zod/v4';
+import { AuditCategorySchema, AuditEntrySchema } from "../schemas/audit.js";
+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 const DEFAULT_RETENTION_POLICIES = [
+    { 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 const defaultAuditStorageConfig = {
+    adapter: 'drizzle',
+    tableName: 'audit_entries',
+    indexes: {
+        category: true,
+        severity: true,
+        actorId: true,
+        targetId: true,
+        timestamp: true,
+        action: true
+    },
+    retention: DEFAULT_RETENTION_POLICIES
+};
+//# sourceMappingURL=audit.storage.schema.js.map

package/dist/audit/audit.storage.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.storage.schema.js","sourceRoot":"","sources":["../../src/audit/audit.storage.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC9D,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAUH,MAAM,CAAC,MAAM,0BAA0B,GAA2B;IACjE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IACjE,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IAChE,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IAC3D,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;IAC9D,EAAE,QAAQ,EAAE,mBAAmB,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IACpE,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IAChE,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;CACzD,CAAC;AAgBF,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IAC5D,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE;QACR,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,IAAI;KACZ;IACD,SAAS,EAAE,0BAA0B;CACrC,CAAC"}

package/dist/audit/index.d.ts

@@ -0,0 +1,2 @@
+export { AuditEntryStorageSchema, type AuditEntryStorage, type AuditRetentionPolicy, DEFAULT_RETENTION_POLICIES, type AuditStorageConfig, defaultAuditStorageConfig } from './audit.storage.schema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,yBAAyB,EACzB,MAAM,wBAAwB,CAAC"}

package/dist/audit/index.js

@@ -0,0 +1,2 @@
+export { AuditEntryStorageSchema, DEFAULT_RETENTION_POLICIES, defaultAuditStorageConfig } from './audit.storage.schema.js';
+//# sourceMappingURL=index.js.map

package/dist/audit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,uBAAuB,EAGvB,0BAA0B,EAE1B,yBAAyB,EACzB,MAAM,wBAAwB,CAAC"}

package/dist/cli/logs.descriptor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Logs CLI Group Descriptor
+ *
+ * Root group for log management commands.
+ */
+import type { CLIGroupAssetDescriptor } from './types.ts';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=logs.descriptor.d.ts.map

package/dist/cli/logs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/logs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.descriptor.js

@@ -0,0 +1,16 @@
+/**
+ * Logs CLI Group Descriptor
+ *
+ * Root group for log management commands.
+ */
+const descriptor = {
+    kind: 'cli/group',
+    id: 'logs',
+    name: 'logs',
+    description: 'View and manage application logs',
+    surfaces: ['cli'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=logs.descriptor.js.map

package/dist/cli/logs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.descriptor.js","sourceRoot":"","sources":["../../src/cli/logs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,kCAAkC;IAC/C,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.list.descriptor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Logs List CLI Command Descriptor
+ *
+ * Lists all registered log outputs.
+ */
+import type { CLICommandAssetDescriptor } from './types.ts';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=logs.list.descriptor.d.ts.map

package/dist/cli/logs.list.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.list.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/logs.list.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,QAAA,MAAM,UAAU,EAAE,yBAiBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.list.descriptor.js

@@ -0,0 +1,23 @@
+/**
+ * Logs List CLI Command Descriptor
+ *
+ * Lists all registered log outputs.
+ */
+const descriptor = {
+    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;
+//# sourceMappingURL=logs.list.descriptor.js.map

package/dist/cli/logs.list.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.list.descriptor.js","sourceRoot":"","sources":["../../src/cli/logs.list.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,8CAA8C;IAC3D,KAAK,EAAE,MAAM;IAEb,OAAO,EAAE;QACR;YACC,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,gBAAgB;SAC7B;KACD;IAED,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.list.impl.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Logs List CLI Command Implementation
+ *
+ * Lists all registered log outputs with their status.
+ */
+interface ListOptions {
+    json?: boolean;
+}
+declare const _default: {
+    execute(_args: Record<string, unknown>, opts: ListOptions): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=logs.list.impl.d.ts.map

package/dist/cli/logs.list.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.list.impl.d.ts","sourceRoot":"","sources":["../../src/cli/logs.list.impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,UAAU,WAAW;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;;mBAGqB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;;AADhF,wBA8EE"}

package/dist/cli/logs.list.impl.js

@@ -0,0 +1,81 @@
+/**
+ * Logs List CLI Command Implementation
+ *
+ * Lists all registered log outputs with their status.
+ */
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+export default {
+    async execute(_args, opts) {
+        const runtime = getVibesRuntime();
+        // Get all output descriptors
+        const descriptors = runtime
+            .query('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('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('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('');
+        }
+    }
+};
+//# sourceMappingURL=logs.list.impl.js.map

package/dist/cli/logs.list.impl.js.map

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

package/dist/cli/logs.rotate.descriptor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Logs Rotate CLI Command Descriptor
+ *
+ * Rotate a log output file.
+ */
+import type { CLICommandAssetDescriptor } from './types.ts';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=logs.rotate.descriptor.d.ts.map

package/dist/cli/logs.rotate.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.rotate.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/logs.rotate.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,QAAA,MAAM,UAAU,EAAE,yBA6BjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.rotate.descriptor.js

@@ -0,0 +1,34 @@
+/**
+ * Logs Rotate CLI Command Descriptor
+ *
+ * Rotate a log output file.
+ */
+const descriptor = {
+    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;
+//# sourceMappingURL=logs.rotate.descriptor.js.map

package/dist/cli/logs.rotate.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.rotate.descriptor.js","sourceRoot":"","sources":["../../src/cli/logs.rotate.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,0BAA0B;IACvC,KAAK,EAAE,MAAM;IAEb,SAAS,EAAE;QACV;YACC,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,IAAI;SACd;KACD;IAED,OAAO,EAAE;QACR;YACC,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,oBAAoB;SACjC;QACD;YACC,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,uCAAuC;SACpD;KACD;IAED,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logs.rotate.impl.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Logs Rotate CLI Command Implementation
+ *
+ * Rotate log output files.
+ */
+interface RotateArgs {
+    output?: string;
+}
+interface RotateOptions {
+    all?: boolean;
+    cleanup?: boolean;
+}
+declare const _default: {
+    execute(args: RotateArgs, opts: RotateOptions): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=logs.rotate.impl.d.ts.map

package/dist/cli/logs.rotate.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.rotate.impl.d.ts","sourceRoot":"","sources":["../../src/cli/logs.rotate.impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,UAAU,UAAU;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;;kBAGoB,UAAU,QAAQ,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;;AADpE,wBAyCE"}