@mcp-abap-adt/core 4.9.0 → 5.0.0

package/docs/superpowers/plans/2026-04-11-migrate-adt-clients-4.0.0.md

@@ -0,0 +1,1014 @@
+# Migrate to @mcp-abap-adt/adt-clients 4.0.0
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Migrate runtime handlers to adt-clients 4.0.0 (factory pattern API) and add new handlers for feeds, system messages, and gateway error log.
+
+**Architecture:** Update existing 6 runtime handlers to use `getProfiler()`/`getDumps()` factory methods instead of flat `AdtRuntimeClient` methods. Add 3 new granular system handlers using `FeedRepository` (which parses Atom XML internally). Add 3 compact wrapper handlers. Register everything in the appropriate handler groups.
+
+**Tech Stack:** TypeScript, @mcp-abap-adt/adt-clients@4.0.0, @mcp-abap-adt/interfaces@6.0.0
+
+---
+
+## File Map
+
+**Modified files (breaking change fixes):**
+- `package.json` — bump adt-clients dependency
+- `src/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.ts` — `listProfilerTraceFiles()` → `getProfiler().list()`
+- `src/handlers/system/readonly/handleRuntimeGetProfilerTraceData.ts` — flat methods → `getProfiler().getHitList/getStatements/getDbAccesses()`
+- `src/handlers/system/readonly/handleRuntimeAnalyzeProfilerTrace.ts` — same profiler method changes
+- `src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts` — `createProfilerTraceParameters()` → `getProfiler().createParameters()`, `extractProfilerIdFromResponse()` → `getProfiler().extractIdFromResponse()`
+- `src/handlers/system/readonly/handleRuntimeListDumps.ts` — `listRuntimeDumps()` → `getDumps().list()`, `listRuntimeDumpsByUser()` → `getDumps().listByUser()`
+- `src/handlers/system/readonly/handleRuntimeGetDumpById.ts` — `getRuntimeDumpById()` → `getDumps().getById()`, remove unused `buildDumpIdPrefix` import
+- `src/lib/handlers/groups/SystemHandlersGroup.ts` — register 3 new system handlers
+- `src/lib/handlers/groups/CompactHandlersGroup.ts` — register 3 new compact handlers
+- `src/handlers/compact/high/compactSchemas.ts` — add schemas for new compact handlers
+
+**New files:**
+- `src/handlers/system/readonly/handleRuntimeListFeeds.ts` — list feeds + read specific feed
+- `src/handlers/system/readonly/handleRuntimeListSystemMessages.ts` — SM02 system messages
+- `src/handlers/system/readonly/handleRuntimeGetGatewayErrorLog.ts` — gateway error log + detail
+- `src/handlers/compact/high/handleHandlerFeedList.ts` — compact wrapper for feeds
+- `src/handlers/compact/high/handleHandlerSystemMessageList.ts` — compact wrapper for system messages
+- `src/handlers/compact/high/handleHandlerGatewayErrorList.ts` — compact wrapper for gateway errors
+
+---
+
+### Task 1: Bump adt-clients dependency
+
+**Files:**
+- Modify: `package.json:139`
+
+- [ ] **Step 1: Update dependency version**
+
+In `package.json`, change:
+```
+"@mcp-abap-adt/adt-clients": "^3.14.5",
+```
+to:
+```
+"@mcp-abap-adt/adt-clients": "^4.0.0",
+```
+
+- [ ] **Step 2: Install**
+
+Run: `npm install`
+Expected: Successful install, no peer dependency errors.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add package.json package-lock.json
+git commit -m "chore: bump @mcp-abap-adt/adt-clients to ^4.0.0"
+```
+
+---
+
+### Task 2: Fix profiler handlers (breaking changes)
+
+**Files:**
+- Modify: `src/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.ts`
+- Modify: `src/handlers/system/readonly/handleRuntimeGetProfilerTraceData.ts`
+- Modify: `src/handlers/system/readonly/handleRuntimeAnalyzeProfilerTrace.ts`
+- Modify: `src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts`
+
+All four files follow the same pattern: create `AdtRuntimeClient`, then call flat methods. In v4.0.0, these become `getProfiler().*` calls.
+
+- [ ] **Step 1: Fix handleRuntimeListProfilerTraceFiles.ts**
+
+Replace line 25:
+```typescript
+    const response = await runtimeClient.listProfilerTraceFiles();
+```
+with:
+```typescript
+    const response = await runtimeClient.getProfiler().list();
+```
+
+- [ ] **Step 2: Fix handleRuntimeGetProfilerTraceData.ts**
+
+Replace lines 67-85 (the entire ternary chain):
+```typescript
+    const response =
+      args.view === 'hitlist'
+        ? await runtimeClient.getProfilerTraceHitList(args.trace_id_or_uri, {
+            withSystemEvents: args.with_system_events,
+          })
+        : args.view === 'statements'
+          ? await runtimeClient.getProfilerTraceStatements(
+              args.trace_id_or_uri,
+              {
+                id: args.id,
+                withDetails: args.with_details,
+                autoDrillDownThreshold: args.auto_drill_down_threshold,
+                withSystemEvents: args.with_system_events,
+              },
+            )
+          : await runtimeClient.getProfilerTraceDbAccesses(
+              args.trace_id_or_uri,
+              {
+                withSystemEvents: args.with_system_events,
+              },
+            );
+```
+with:
+```typescript
+    const profiler = runtimeClient.getProfiler();
+    const response =
+      args.view === 'hitlist'
+        ? await profiler.getHitList(args.trace_id_or_uri, {
+            withSystemEvents: args.with_system_events,
+          })
+        : args.view === 'statements'
+          ? await profiler.getStatements(
+              args.trace_id_or_uri,
+              {
+                id: args.id,
+                withDetails: args.with_details,
+                autoDrillDownThreshold: args.auto_drill_down_threshold,
+                withSystemEvents: args.with_system_events,
+              },
+            )
+          : await profiler.getDbAccesses(
+              args.trace_id_or_uri,
+              {
+                withSystemEvents: args.with_system_events,
+              },
+            );
+```
+
+- [ ] **Step 3: Fix handleRuntimeAnalyzeProfilerTrace.ts**
+
+Replace lines 132-149 (the ternary chain):
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const response =
+      view === 'hitlist'
+        ? await runtimeClient.getProfilerTraceHitList(args.trace_id_or_uri, {
+            withSystemEvents: args.with_system_events,
+          })
+        : view === 'statements'
+          ? await runtimeClient.getProfilerTraceStatements(
+              args.trace_id_or_uri,
+              {
+                withSystemEvents: args.with_system_events,
+              },
+            )
+          : await runtimeClient.getProfilerTraceDbAccesses(
+              args.trace_id_or_uri,
+              {
+                withSystemEvents: args.with_system_events,
+              },
+            );
+```
+with:
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const profiler = runtimeClient.getProfiler();
+    const response =
+      view === 'hitlist'
+        ? await profiler.getHitList(args.trace_id_or_uri, {
+            withSystemEvents: args.with_system_events,
+          })
+        : view === 'statements'
+          ? await profiler.getStatements(
+              args.trace_id_or_uri,
+              {
+                withSystemEvents: args.with_system_events,
+              },
+            )
+          : await profiler.getDbAccesses(
+              args.trace_id_or_uri,
+              {
+                withSystemEvents: args.with_system_events,
+              },
+            );
+```
+
+- [ ] **Step 4: Fix handleRuntimeCreateProfilerTraceParameters.ts**
+
+Replace lines 60-77:
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const response = await runtimeClient.createProfilerTraceParameters({
+      description: args.description,
+      allMiscAbapStatements: args.all_misc_abap_statements,
+      allProceduralUnits: args.all_procedural_units,
+      allInternalTableEvents: args.all_internal_table_events,
+      allDynproEvents: args.all_dynpro_events,
+      aggregate: args.aggregate,
+      explicitOnOff: args.explicit_on_off,
+      withRfcTracing: args.with_rfc_tracing,
+      allSystemKernelEvents: args.all_system_kernel_events,
+      sqlTrace: args.sql_trace,
+      allDbEvents: args.all_db_events,
+      maxSizeForTraceFile: args.max_size_for_trace_file,
+      amdpTrace: args.amdp_trace,
+      maxTimeForTracing: args.max_time_for_tracing,
+    });
+
+    const profilerId = runtimeClient.extractProfilerIdFromResponse(response);
+```
+with:
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const profiler = runtimeClient.getProfiler();
+    const response = await profiler.createParameters({
+      description: args.description,
+      allMiscAbapStatements: args.all_misc_abap_statements,
+      allProceduralUnits: args.all_procedural_units,
+      allInternalTableEvents: args.all_internal_table_events,
+      allDynproEvents: args.all_dynpro_events,
+      aggregate: args.aggregate,
+      explicitOnOff: args.explicit_on_off,
+      withRfcTracing: args.with_rfc_tracing,
+      allSystemKernelEvents: args.all_system_kernel_events,
+      sqlTrace: args.sql_trace,
+      allDbEvents: args.all_db_events,
+      maxSizeForTraceFile: args.max_size_for_trace_file,
+      amdpTrace: args.amdp_trace,
+      maxTimeForTracing: args.max_time_for_tracing,
+    });
+
+    const profilerId = profiler.extractIdFromResponse(response);
+```
+
+- [ ] **Step 5: Verify TypeScript compilation**
+
+Run: `npx tsc --noEmit 2>&1 | head -30`
+Expected: No errors related to profiler handler files.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add src/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.ts \
+  src/handlers/system/readonly/handleRuntimeGetProfilerTraceData.ts \
+  src/handlers/system/readonly/handleRuntimeAnalyzeProfilerTrace.ts \
+  src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts
+git commit -m "refactor: migrate profiler handlers to adt-clients 4.0.0 factory API"
+```
+
+---
+
+### Task 3: Fix dump handlers (breaking changes)
+
+**Files:**
+- Modify: `src/handlers/system/readonly/handleRuntimeListDumps.ts`
+- Modify: `src/handlers/system/readonly/handleRuntimeGetDumpById.ts`
+
+- [ ] **Step 1: Fix handleRuntimeListDumps.ts**
+
+Replace lines 93-109:
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const { user, from, to, inlinecount, top, skip, orderby } = args || {};
+
+    const response = user
+      ? await runtimeClient.listRuntimeDumpsByUser(user, {
+          from,
+          to,
+          inlinecount,
+          top,
+          skip,
+          orderby,
+        })
+      : await runtimeClient.listRuntimeDumps({
+          from,
+          to,
+          inlinecount,
+          top,
+          skip,
+          orderby,
+        });
+```
+with:
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const dumps = runtimeClient.getDumps();
+    const { user, from, to, inlinecount, top, skip, orderby } = args || {};
+
+    const response = user
+      ? await dumps.listByUser(user, {
+          from,
+          to,
+          inlinecount,
+          top,
+          skip,
+          orderby,
+        })
+      : await dumps.list({
+          from,
+          to,
+          inlinecount,
+          top,
+          skip,
+          orderby,
+        });
+```
+
+- [ ] **Step 2: Fix handleRuntimeGetDumpById.ts**
+
+Change the import on line 1 — remove unused `buildDumpIdPrefix`:
+```typescript
+import { AdtRuntimeClient, buildDumpIdPrefix } from '@mcp-abap-adt/adt-clients';
+```
+to:
+```typescript
+import { AdtRuntimeClient } from '@mcp-abap-adt/adt-clients';
+```
+
+Replace lines 167-168:
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const response = await runtimeClient.getRuntimeDumpById(dumpId, { view });
+```
+with:
+```typescript
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const response = await runtimeClient.getDumps().getById(dumpId, { view });
+```
+
+- [ ] **Step 3: Verify TypeScript compilation**
+
+Run: `npx tsc --noEmit 2>&1 | head -30`
+Expected: No errors related to dump handler files.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/handlers/system/readonly/handleRuntimeListDumps.ts \
+  src/handlers/system/readonly/handleRuntimeGetDumpById.ts
+git commit -m "refactor: migrate dump handlers to adt-clients 4.0.0 factory API"
+```
+
+---
+
+### Task 4: Add RuntimeListFeeds handler
+
+**Files:**
+- Create: `src/handlers/system/readonly/handleRuntimeListFeeds.ts`
+
+The `FeedRepository` from adt-clients 4.0.0 parses Atom XML internally and returns typed domain objects. We use `client.getFeeds()` which returns `IFeedRepository` with methods: `list()`, `variants()`, `dumps()`, `systemMessages()`, `gatewayErrors()`, `gatewayErrorDetail()`.
+
+- [ ] **Step 1: Create handler file**
+
+Create `src/handlers/system/readonly/handleRuntimeListFeeds.ts`:
+
+```typescript
+import { AdtRuntimeClient } from '@mcp-abap-adt/adt-clients';
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+import { return_error, return_response } from '../../../lib/utils';
+
+export const TOOL_DEFINITION = {
+  name: 'RuntimeListFeeds',
+  available_in: ['onprem', 'cloud'] as const,
+  description:
+    '[runtime] List available ADT runtime feeds or read a specific feed type. Feed types: dumps, system_messages, gateway_errors. Without feed_type returns available feed descriptors.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      feed_type: {
+        type: 'string',
+        enum: ['descriptors', 'variants', 'dumps', 'system_messages', 'gateway_errors'],
+        description:
+          'Feed to read. "descriptors" lists available feeds, "variants" lists feed variants, others read that specific feed. Default: descriptors.',
+        default: 'descriptors',
+      },
+      user: {
+        type: 'string',
+        description: 'Filter feed entries by SAP username.',
+      },
+      max_results: {
+        type: 'number',
+        description: 'Maximum number of entries to return.',
+      },
+      from: {
+        type: 'string',
+        description: 'Start of time range in YYYYMMDDHHMMSS format.',
+      },
+      to: {
+        type: 'string',
+        description: 'End of time range in YYYYMMDDHHMMSS format.',
+      },
+    },
+    required: [],
+  },
+} as const;
+
+interface RuntimeListFeedsArgs {
+  feed_type?: 'descriptors' | 'variants' | 'dumps' | 'system_messages' | 'gateway_errors';
+  user?: string;
+  max_results?: number;
+  from?: string;
+  to?: string;
+}
+
+export async function handleRuntimeListFeeds(
+  context: HandlerContext,
+  args: RuntimeListFeedsArgs,
+) {
+  const { connection, logger } = context;
+
+  try {
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const feeds = runtimeClient.getFeeds();
+    const feedType = args?.feed_type ?? 'descriptors';
+
+    const queryOptions = {
+      user: args?.user,
+      maxResults: args?.max_results,
+      from: args?.from,
+      to: args?.to,
+    };
+
+    let data: unknown;
+
+    switch (feedType) {
+      case 'descriptors':
+        data = await feeds.list();
+        break;
+      case 'variants':
+        data = await feeds.variants();
+        break;
+      case 'dumps':
+        data = await feeds.dumps(queryOptions);
+        break;
+      case 'system_messages':
+        data = await feeds.systemMessages(queryOptions);
+        break;
+      case 'gateway_errors':
+        data = await feeds.gatewayErrors(queryOptions);
+        break;
+    }
+
+    return return_response({
+      data: JSON.stringify(
+        {
+          success: true,
+          feed_type: feedType,
+          count: Array.isArray(data) ? data.length : undefined,
+          entries: data,
+        },
+        null,
+        2,
+      ),
+      status: 200,
+      statusText: 'OK',
+      headers: {},
+      config: {},
+    });
+  } catch (error: unknown) {
+    logger?.error('Error reading feeds:', error);
+    return return_error(error);
+  }
+}
+```
+
+- [ ] **Step 2: Verify compilation**
+
+Run: `npx tsc --noEmit 2>&1 | head -30`
+Expected: No errors.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/handlers/system/readonly/handleRuntimeListFeeds.ts
+git commit -m "feat: add RuntimeListFeeds handler for ADT feed reader"
+```
+
+---
+
+### Task 5: Add RuntimeListSystemMessages handler
+
+**Files:**
+- Create: `src/handlers/system/readonly/handleRuntimeListSystemMessages.ts`
+
+Uses `FeedRepository.systemMessages()` which returns parsed `ISystemMessageEntry[]` (id, title, text, severity, validFrom, validTo, createdBy).
+
+- [ ] **Step 1: Create handler file**
+
+Create `src/handlers/system/readonly/handleRuntimeListSystemMessages.ts`:
+
+```typescript
+import { AdtRuntimeClient } from '@mcp-abap-adt/adt-clients';
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+import { return_error, return_response } from '../../../lib/utils';
+
+export const TOOL_DEFINITION = {
+  name: 'RuntimeListSystemMessages',
+  available_in: ['onprem', 'cloud'] as const,
+  description:
+    '[runtime] List SM02 system messages. Returns structured entries with id, title, text, severity, validity period, and author.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      user: {
+        type: 'string',
+        description: 'Filter by author username.',
+      },
+      max_results: {
+        type: 'number',
+        description: 'Maximum number of messages to return.',
+      },
+      from: {
+        type: 'string',
+        description: 'Start of time range in YYYYMMDDHHMMSS format.',
+      },
+      to: {
+        type: 'string',
+        description: 'End of time range in YYYYMMDDHHMMSS format.',
+      },
+    },
+    required: [],
+  },
+} as const;
+
+interface RuntimeListSystemMessagesArgs {
+  user?: string;
+  max_results?: number;
+  from?: string;
+  to?: string;
+}
+
+export async function handleRuntimeListSystemMessages(
+  context: HandlerContext,
+  args: RuntimeListSystemMessagesArgs,
+) {
+  const { connection, logger } = context;
+
+  try {
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const feeds = runtimeClient.getFeeds();
+
+    const messages = await feeds.systemMessages({
+      user: args?.user,
+      maxResults: args?.max_results,
+      from: args?.from,
+      to: args?.to,
+    });
+
+    return return_response({
+      data: JSON.stringify(
+        {
+          success: true,
+          count: messages.length,
+          messages,
+        },
+        null,
+        2,
+      ),
+      status: 200,
+      statusText: 'OK',
+      headers: {},
+      config: {},
+    });
+  } catch (error: unknown) {
+    logger?.error('Error listing system messages:', error);
+    return return_error(error);
+  }
+}
+```
+
+- [ ] **Step 2: Verify compilation**
+
+Run: `npx tsc --noEmit 2>&1 | head -30`
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/handlers/system/readonly/handleRuntimeListSystemMessages.ts
+git commit -m "feat: add RuntimeListSystemMessages handler for SM02 messages"
+```
+
+---
+
+### Task 6: Add RuntimeGetGatewayErrorLog handler
+
+**Files:**
+- Create: `src/handlers/system/readonly/handleRuntimeGetGatewayErrorLog.ts`
+
+Uses `FeedRepository.gatewayErrors()` for listing (returns `IGatewayErrorEntry[]`) and `FeedRepository.gatewayErrorDetail()` for detail (returns `IGatewayErrorDetail` with serviceInfo, errorContext, sourceCode, callStack).
+
+- [ ] **Step 1: Create handler file**
+
+Create `src/handlers/system/readonly/handleRuntimeGetGatewayErrorLog.ts`:
+
+```typescript
+import { AdtRuntimeClient } from '@mcp-abap-adt/adt-clients';
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+import { return_error, return_response } from '../../../lib/utils';
+
+export const TOOL_DEFINITION = {
+  name: 'RuntimeGetGatewayErrorLog',
+  available_in: ['onprem'] as const,
+  description:
+    '[runtime] List SAP Gateway error log (/IWFND/ERROR_LOG) or get error detail. Returns structured entries with type, shortText, transactionId, dateTime, username. With error_url returns full detail including serviceInfo, errorContext, sourceCode, callStack.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      error_url: {
+        type: 'string',
+        description:
+          'Feed URL of a specific error entry (from a previous list response link field). When provided, returns detailed error info instead of listing.',
+      },
+      user: {
+        type: 'string',
+        description: 'Filter errors by SAP username.',
+      },
+      max_results: {
+        type: 'number',
+        description: 'Maximum number of errors to return.',
+      },
+      from: {
+        type: 'string',
+        description: 'Start of time range in YYYYMMDDHHMMSS format.',
+      },
+      to: {
+        type: 'string',
+        description: 'End of time range in YYYYMMDDHHMMSS format.',
+      },
+    },
+    required: [],
+  },
+} as const;
+
+interface RuntimeGetGatewayErrorLogArgs {
+  error_url?: string;
+  user?: string;
+  max_results?: number;
+  from?: string;
+  to?: string;
+}
+
+export async function handleRuntimeGetGatewayErrorLog(
+  context: HandlerContext,
+  args: RuntimeGetGatewayErrorLogArgs,
+) {
+  const { connection, logger } = context;
+
+  try {
+    const runtimeClient = new AdtRuntimeClient(connection, logger);
+    const feeds = runtimeClient.getFeeds();
+
+    if (args?.error_url) {
+      const detail = await feeds.gatewayErrorDetail(args.error_url);
+      return return_response({
+        data: JSON.stringify(
+          {
+            success: true,
+            mode: 'detail',
+            error: detail,
+          },
+          null,
+          2,
+        ),
+        status: 200,
+        statusText: 'OK',
+        headers: {},
+        config: {},
+      });
+    }
+
+    const errors = await feeds.gatewayErrors({
+      user: args?.user,
+      maxResults: args?.max_results,
+      from: args?.from,
+      to: args?.to,
+    });
+
+    return return_response({
+      data: JSON.stringify(
+        {
+          success: true,
+          mode: 'list',
+          count: errors.length,
+          errors,
+        },
+        null,
+        2,
+      ),
+      status: 200,
+      statusText: 'OK',
+      headers: {},
+      config: {},
+    });
+  } catch (error: unknown) {
+    logger?.error('Error reading gateway error log:', error);
+    return return_error(error);
+  }
+}
+```
+
+- [ ] **Step 2: Verify compilation**
+
+Run: `npx tsc --noEmit 2>&1 | head -30`
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/handlers/system/readonly/handleRuntimeGetGatewayErrorLog.ts
+git commit -m "feat: add RuntimeGetGatewayErrorLog handler for /IWFND/ERROR_LOG"
+```
+
+---
+
+### Task 7: Register new handlers in SystemHandlersGroup
+
+**Files:**
+- Modify: `src/lib/handlers/groups/SystemHandlersGroup.ts`
+
+- [ ] **Step 1: Add imports**
+
+Add after line 100 (after the last runtime import):
+
+```typescript
+import {
+  handleRuntimeListFeeds,
+  TOOL_DEFINITION as RuntimeListFeeds_Tool,
+} from '../../../handlers/system/readonly/handleRuntimeListFeeds';
+import {
+  handleRuntimeListSystemMessages,
+  TOOL_DEFINITION as RuntimeListSystemMessages_Tool,
+} from '../../../handlers/system/readonly/handleRuntimeListSystemMessages';
+import {
+  handleRuntimeGetGatewayErrorLog,
+  TOOL_DEFINITION as RuntimeGetGatewayErrorLog_Tool,
+} from '../../../handlers/system/readonly/handleRuntimeGetGatewayErrorLog';
+```
+
+- [ ] **Step 2: Add handler entries**
+
+Add after the `RuntimeAnalyzeProfilerTrace` entry (after line 160) in the `getHandlers()` return array:
+
+```typescript
+      {
+        toolDefinition: RuntimeListFeeds_Tool,
+        handler: (args: any) => handleRuntimeListFeeds(this.context, args),
+      },
+      {
+        toolDefinition: RuntimeListSystemMessages_Tool,
+        handler: (args: any) =>
+          handleRuntimeListSystemMessages(this.context, args),
+      },
+      {
+        toolDefinition: RuntimeGetGatewayErrorLog_Tool,
+        handler: (args: any) =>
+          handleRuntimeGetGatewayErrorLog(this.context, args),
+      },
+```
+
+- [ ] **Step 3: Verify compilation**
+
+Run: `npx tsc --noEmit 2>&1 | head -30`
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/lib/handlers/groups/SystemHandlersGroup.ts
+git commit -m "feat: register new runtime feed handlers in SystemHandlersGroup"
+```
+
+---
+
+### Task 8: Add compact schemas and wrapper handlers
+
+**Files:**
+- Modify: `src/handlers/compact/high/compactSchemas.ts`
+- Create: `src/handlers/compact/high/handleHandlerFeedList.ts`
+- Create: `src/handlers/compact/high/handleHandlerSystemMessageList.ts`
+- Create: `src/handlers/compact/high/handleHandlerGatewayErrorList.ts`
+
+- [ ] **Step 1: Add compact schemas**
+
+Append to `src/handlers/compact/high/compactSchemas.ts` (after the last export, line 698):
+
+```typescript
+
+export const compactFeedListSchema = {
+  type: 'object',
+  properties: {
+    feed_type: {
+      type: 'string',
+      enum: ['descriptors', 'variants', 'dumps', 'system_messages', 'gateway_errors'],
+      default: 'descriptors',
+      description: 'Feed type to read.',
+    },
+    user: { type: 'string', description: 'Filter by username.' },
+    max_results: { type: 'number', description: 'Limit entries returned.' },
+    from: { type: 'string', description: 'Start datetime YYYYMMDDHHMMSS.' },
+    to: { type: 'string', description: 'End datetime YYYYMMDDHHMMSS.' },
+  },
+  required: [],
+} as const;
+
+export const compactSystemMessageListSchema = {
+  type: 'object',
+  properties: {
+    user: { type: 'string', description: 'Filter by author username.' },
+    max_results: { type: 'number', description: 'Limit messages returned.' },
+    from: { type: 'string', description: 'Start datetime YYYYMMDDHHMMSS.' },
+    to: { type: 'string', description: 'End datetime YYYYMMDDHHMMSS.' },
+  },
+  required: [],
+} as const;
+
+export const compactGatewayErrorListSchema = {
+  type: 'object',
+  properties: {
+    error_url: { type: 'string', description: 'Error feed URL for detail view.' },
+    user: { type: 'string', description: 'Filter by username.' },
+    max_results: { type: 'number', description: 'Limit errors returned.' },
+    from: { type: 'string', description: 'Start datetime YYYYMMDDHHMMSS.' },
+    to: { type: 'string', description: 'End datetime YYYYMMDDHHMMSS.' },
+  },
+  required: [],
+} as const;
+```
+
+- [ ] **Step 2: Create handleHandlerFeedList.ts**
+
+Create `src/handlers/compact/high/handleHandlerFeedList.ts`:
+
+```typescript
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+import { handleRuntimeListFeeds } from '../../system/readonly/handleRuntimeListFeeds';
+import { compactFeedListSchema } from './compactSchemas';
+
+export const TOOL_DEFINITION = {
+  name: 'HandlerFeedList',
+  available_in: ['onprem', 'cloud'] as const,
+  description:
+    'Runtime feed list. object_type: not used. Required: none. Optional: feed_type, user, max_results, from, to. Response: JSON.',
+  inputSchema: compactFeedListSchema,
+} as const;
+
+type HandlerFeedListArgs = {
+  feed_type?: 'descriptors' | 'variants' | 'dumps' | 'system_messages' | 'gateway_errors';
+  user?: string;
+  max_results?: number;
+  from?: string;
+  to?: string;
+};
+
+export async function handleHandlerFeedList(
+  context: HandlerContext,
+  args: HandlerFeedListArgs,
+) {
+  return handleRuntimeListFeeds(context, args);
+}
+```
+
+- [ ] **Step 3: Create handleHandlerSystemMessageList.ts**
+
+Create `src/handlers/compact/high/handleHandlerSystemMessageList.ts`:
+
+```typescript
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+import { handleRuntimeListSystemMessages } from '../../system/readonly/handleRuntimeListSystemMessages';
+import { compactSystemMessageListSchema } from './compactSchemas';
+
+export const TOOL_DEFINITION = {
+  name: 'HandlerSystemMessageList',
+  available_in: ['onprem', 'cloud'] as const,
+  description:
+    'SM02 system messages list. object_type: not used. Required: none. Optional: user, max_results, from, to. Response: JSON.',
+  inputSchema: compactSystemMessageListSchema,
+} as const;
+
+type HandlerSystemMessageListArgs = {
+  user?: string;
+  max_results?: number;
+  from?: string;
+  to?: string;
+};
+
+export async function handleHandlerSystemMessageList(
+  context: HandlerContext,
+  args: HandlerSystemMessageListArgs,
+) {
+  return handleRuntimeListSystemMessages(context, args);
+}
+```
+
+- [ ] **Step 4: Create handleHandlerGatewayErrorList.ts**
+
+Create `src/handlers/compact/high/handleHandlerGatewayErrorList.ts`:
+
+```typescript
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+import { handleRuntimeGetGatewayErrorLog } from '../../system/readonly/handleRuntimeGetGatewayErrorLog';
+import { compactGatewayErrorListSchema } from './compactSchemas';
+
+export const TOOL_DEFINITION = {
+  name: 'HandlerGatewayErrorList',
+  available_in: ['onprem'] as const,
+  description:
+    'Gateway error log list/detail. object_type: not used. Required: none. Optional: error_url, user, max_results, from, to. Response: JSON.',
+  inputSchema: compactGatewayErrorListSchema,
+} as const;
+
+type HandlerGatewayErrorListArgs = {
+  error_url?: string;
+  user?: string;
+  max_results?: number;
+  from?: string;
+  to?: string;
+};
+
+export async function handleHandlerGatewayErrorList(
+  context: HandlerContext,
+  args: HandlerGatewayErrorListArgs,
+) {
+  return handleRuntimeGetGatewayErrorLog(context, args);
+}
+```
+
+- [ ] **Step 5: Verify compilation**
+
+Run: `npx tsc --noEmit 2>&1 | head -30`
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add src/handlers/compact/high/compactSchemas.ts \
+  src/handlers/compact/high/handleHandlerFeedList.ts \
+  src/handlers/compact/high/handleHandlerSystemMessageList.ts \
+  src/handlers/compact/high/handleHandlerGatewayErrorList.ts
+git commit -m "feat: add compact wrapper handlers for feeds, system messages, gateway errors"
+```
+
+---
+
+### Task 9: Register compact handlers in CompactHandlersGroup
+
+**Files:**
+- Modify: `src/lib/handlers/groups/CompactHandlersGroup.ts`
+
+- [ ] **Step 1: Add imports**
+
+Add after line 31 (after the HandlerDumpView import):
+
+```typescript
+import {
+  TOOL_DEFINITION as HandlerFeedList_Tool,
+  handleHandlerFeedList,
+} from '../../../handlers/compact/high/handleHandlerFeedList';
+import {
+  TOOL_DEFINITION as HandlerSystemMessageList_Tool,
+  handleHandlerSystemMessageList,
+} from '../../../handlers/compact/high/handleHandlerSystemMessageList';
+import {
+  TOOL_DEFINITION as HandlerGatewayErrorList_Tool,
+  handleHandlerGatewayErrorList,
+} from '../../../handlers/compact/high/handleHandlerGatewayErrorList';
+```
+
+- [ ] **Step 2: Add handler entries**
+
+Add after the `HandlerDumpView` entry (after line 163) in the return array:
+
+```typescript
+      {
+        toolDefinition: HandlerFeedList_Tool,
+        handler: withContext(handleHandlerFeedList),
+      },
+      {
+        toolDefinition: HandlerSystemMessageList_Tool,
+        handler: withContext(handleHandlerSystemMessageList),
+      },
+      {
+        toolDefinition: HandlerGatewayErrorList_Tool,
+        handler: withContext(handleHandlerGatewayErrorList),
+      },
+```
+
+- [ ] **Step 3: Full compilation check**
+
+Run: `npx tsc --noEmit`
+Expected: Clean build with zero errors.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/lib/handlers/groups/CompactHandlersGroup.ts
+git commit -m "feat: register compact feed/sysmsg/gwerror handlers in CompactHandlersGroup"
+```
+
+---
+
+### Task 10: Final verification
+
+- [ ] **Step 1: Full TypeScript build**
+
+Run: `npm run build`
+Expected: Successful build.
+
+- [ ] **Step 2: Run unit tests**
+
+Run: `npm test -- --testPathPattern='unit' 2>&1 | tail -20`
+Expected: All unit tests pass.
+
+- [ ] **Step 3: Lint check**
+
+Run: `npm run lint 2>&1 | tail -20`
+Expected: No lint errors on modified/new files.