@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/dispatch/domains/diagnostics.js

@@ -0,0 +1,82 @@
+/**
+ * Diagnostics Domain Handler (Dispatch Layer)
+ *
+ * Handles operations for `cleo diagnostics`:
+ *   query:  status, analyze, export
+ *   mutate: enable, disable
+ *
+ * All business logic lives in `@cleocode/core/diagnostics/engine-ops`
+ * (ENG-MIG-13 / T1580). Each handler body is ≤5 LOC per acceptance criteria.
+ *
+ * @task T624
+ * @task T1580 — ENG-MIG-13
+ * @epic T1566
+ */
+import { diagnosticsAnalyze, diagnosticsDisable, diagnosticsEnable, diagnosticsExport, diagnosticsStatus, } from '@cleocode/core/internal';
+import { handleErrorResult, unsupportedOp, wrapResult } from './_base.js';
+// ---------------------------------------------------------------------------
+// DiagnosticsHandler
+// ---------------------------------------------------------------------------
+export class DiagnosticsHandler {
+    // -----------------------------------------------------------------------
+    // Query
+    // -----------------------------------------------------------------------
+    async query(operation, params) {
+        const startTime = Date.now();
+        try {
+            switch (operation) {
+                case 'status': {
+                    const result = await diagnosticsStatus();
+                    return wrapResult(result, 'query', 'diagnostics', operation, startTime);
+                }
+                case 'analyze': {
+                    const days = typeof params?.days === 'number' ? params.days : 30;
+                    const pushToBrain = params?.noBrain !== true;
+                    const result = await diagnosticsAnalyze(days, pushToBrain);
+                    return wrapResult(result, 'query', 'diagnostics', operation, startTime);
+                }
+                case 'export': {
+                    const days = typeof params?.days === 'number' ? params.days : undefined;
+                    const result = await diagnosticsExport(days);
+                    return wrapResult(result, 'query', 'diagnostics', operation, startTime);
+                }
+                default:
+                    return unsupportedOp('query', 'diagnostics', operation, startTime);
+            }
+        }
+        catch (err) {
+            return handleErrorResult('query', 'diagnostics', operation, err, startTime);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Mutate
+    // -----------------------------------------------------------------------
+    async mutate(operation, _params) {
+        const startTime = Date.now();
+        try {
+            switch (operation) {
+                case 'enable': {
+                    const result = await diagnosticsEnable();
+                    return wrapResult(result, 'mutate', 'diagnostics', operation, startTime);
+                }
+                case 'disable': {
+                    const result = await diagnosticsDisable();
+                    return wrapResult(result, 'mutate', 'diagnostics', operation, startTime);
+                }
+                default:
+                    return unsupportedOp('mutate', 'diagnostics', operation, startTime);
+            }
+        }
+        catch (err) {
+            return handleErrorResult('mutate', 'diagnostics', operation, err, startTime);
+        }
+    }
+    /** Declared operations for introspection and validation. */
+    getSupportedOperations() {
+        return {
+            query: ['status', 'analyze', 'export'],
+            mutate: ['enable', 'disable'],
+        };
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/dispatch/domains/diagnostics.js.map

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

package/dist/dispatch/domains/docs.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Docs Domain Handler (Dispatch Layer)
+ *
+ * Handles attachment management operations exposed via `cleo docs`:
+ *   - add    — attach a local file or URL to a CLEO owner entity
+ *   - list   — list attachments for an owner entity
+ *   - fetch  — retrieve attachment bytes and metadata by ID or SHA-256
+ *   - remove — remove an attachment ref; purges blob when refCount hits zero
+ *
+ * All storage delegates to `AttachmentStore` from `@cleocode/core/internal`.
+ * Owner type is auto-detected from the owner ID prefix:
+ *   T###        → 'task'
+ *   ses_*       → 'session'
+ *   O-*         → 'observation'
+ *   (default)   → 'task'
+ *
+ * Type-safe dispatch via `TypedDomainHandler<DocsTypedOps>` per ADR-058.
+ * Param extraction uses manually-wired `DocsTypedOps` (not OpsFromCore —
+ * docs operations delegate directly to store methods, not Core functions).
+ * Zero `as string` / `as any` param casts at call sites.
+ *
+ * `attachmentBackend` is included in typed result payloads and lifted into
+ * `meta` by the envelope-to-response converter for backward compatibility
+ * with T947 Wave B observability consumers.
+ *
+ * @epic T760
+ * @task T797
+ * @see ADR-058 — Dispatch type inference
+ */
+import type { DispatchResponse, DomainHandler } from '../types.js';
+/**
+ * Domain handler for `cleo docs` attachment operations.
+ *
+ * Delegates all per-op logic to the typed inner handler `_docsTypedHandler`
+ * (a `TypedDomainHandler<DocsTypedOps>`). This satisfies the registry's
+ * `DomainHandler` interface while keeping every param access fully type-safe
+ * per ADR-058.
+ *
+ * @see ADR-058 — Dispatch type inference
+ * @task T1529 — typed-dispatch migration (P0)
+ */
+export declare class DocsHandler implements DomainHandler {
+    /**
+     * Execute a read-only docs query operation.
+     *
+     * @param operation - The docs query op name (e.g. 'list', 'fetch', 'generate').
+     * @param params - Raw params from the dispatcher (narrowed internally).
+     */
+    query(operation: string, params?: Record<string, unknown>): Promise<DispatchResponse>;
+    /**
+     * Execute a state-modifying docs mutation operation.
+     *
+     * @param operation - The docs mutate op name (e.g. 'add', 'remove').
+     * @param params - Raw params from the dispatcher (narrowed internally).
+     */
+    mutate(operation: string, params?: Record<string, unknown>): Promise<DispatchResponse>;
+    /** Declared operations for introspection and validation. */
+    getSupportedOperations(): {
+        query: string[];
+        mutate: string[];
+    };
+}
+//# sourceMappingURL=docs.d.ts.map

package/dist/dispatch/domains/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/dispatch/domains/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAiCH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2jBnE;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,YAAW,aAAa;IAK/C;;;;;OAKG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuB3F;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuB5F,4DAA4D;IAC5D,sBAAsB,IAAI;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAMhE"}