@lumenflow/cli 5.7.18 → 5.7.22

package/README.md

@@ -51,38 +51,38 @@ This package provides CLI commands for the LumenFlow workflow framework, includi
 
 ### Work Unit Management
 
-| Command            | Description                                                                         |
-| ------------------ | ----------------------------------------------------------------------------------- |
-| `approval-list`    | List control-plane approvals with optional filters                                  |
-| `approval-request` | Request control-plane approval for a workflow action                                |
-| `approval-review`  | Resolve a control-plane approval decision                                           |
-| `wu-block`         | Block WU with reason                                                                |
-| `wu-brief`         | Generate the canonical full WU handoff prompt and record brief evidence             |
-| `wu-claim`         | Claim WU and create worktree                                                        |
-| `wu-cleanup`       | Cleanup after PR merge                                                              |
-| `wu-create`        | Create new WU spec                                                                  |
-| `wu-delegate`      | Generate the canonical delegation handoff prompt and record explicit lineage intent |
-| `wu-delete`        | Delete WU spec and cleanup                                                          |
-| `wu-deps`          | Show WU dependencies                                                                |
-| `wu-done`          | Complete WU (merge, stamp, cleanup) from main                                       |
-| `wu-edit`          | Edit WU spec fields                                                                 |
-| `wu-escalate`      | Show or resolve WU escalation status                                                |
-| `wu-infer-lane`    | Infer lane from code paths/description using workspace definitions                  |
-| `wu-preflight`     | Pre-flight checks before wu:done                                                    |
-| `wu-prep`          | Run gates in worktree, prep for wu:done                                             |
-| `wu-proto`         | Create WU prototype                                                                 |
-| `wu-prune`         | Clean stale worktrees                                                               |
-| `wu-recover`       | Analyze and fix WU state inconsistencies                                            |
-| `wu-release`       | Release orphaned WU (in_progress to ready)                                          |
-| `wu-rename`        | Rename a WU (canonical WU IDs, --replay-only supported)                             |
-| `wu-repair`        | Repair WU state issues                                                              |
-| `wu-review`        | Review a WU worktree against the configured integration target                      |
-| `wu-sandbox`       | Run command through hardened WU sandbox backend                                     |
-| `wu-status`        | Show WU status, location, valid commands                                            |
-| `wu-unblock`       | Unblock WU                                                                          |
-| `wu-unlock-lane`   | Unlock stuck lane                                                                   |
-| `wu-validate`      | Validate WU spec                                                                    |
-| `wu-verify`        | Verify WU completion (stamp, commit, clean tree)                                    |
+| Command            | Description                                                                                         |
+| ------------------ | --------------------------------------------------------------------------------------------------- |
+| `approval-list`    | List control-plane approvals with optional filters                                                  |
+| `approval-request` | Request control-plane approval for a workflow action                                                |
+| `approval-review`  | Resolve a control-plane approval decision                                                           |
+| `wu-block`         | Block WU with reason                                                                                |
+| `wu-brief`         | Generate the canonical full WU handoff prompt, record evidence, and optionally report prompt tokens |
+| `wu-claim`         | Claim WU and create worktree                                                                        |
+| `wu-cleanup`       | Cleanup after PR merge                                                                              |
+| `wu-create`        | Create new WU spec                                                                                  |
+| `wu-delegate`      | Generate the canonical delegation handoff prompt and record explicit lineage intent                 |
+| `wu-delete`        | Delete WU spec and cleanup                                                                          |
+| `wu-deps`          | Show WU dependencies                                                                                |
+| `wu-done`          | Complete WU (merge, stamp, cleanup) from main                                                       |
+| `wu-edit`          | Edit WU spec fields                                                                                 |
+| `wu-escalate`      | Show or resolve WU escalation status                                                                |
+| `wu-infer-lane`    | Infer lane from code paths/description using workspace definitions                                  |
+| `wu-preflight`     | Pre-flight checks before wu:done                                                                    |
+| `wu-prep`          | Run gates in worktree, prep for wu:done                                                             |
+| `wu-proto`         | Create WU prototype                                                                                 |
+| `wu-prune`         | Clean stale worktrees                                                                               |
+| `wu-recover`       | Analyze and fix WU state inconsistencies                                                            |
+| `wu-release`       | Release orphaned WU (in_progress to ready)                                                          |
+| `wu-rename`        | Rename a WU (canonical WU IDs, --replay-only supported)                                             |
+| `wu-repair`        | Repair WU state issues                                                                              |
+| `wu-review`        | Review a WU worktree against the configured integration target                                      |
+| `wu-sandbox`       | Run command through hardened WU sandbox backend                                                     |
+| `wu-status`        | Show WU status, location, valid commands                                                            |
+| `wu-unblock`       | Unblock WU                                                                                          |
+| `wu-unlock-lane`   | Unlock stuck lane                                                                                   |
+| `wu-validate`      | Validate WU spec                                                                                    |
+| `wu-verify`        | Verify WU completion (stamp, commit, clean tree)                                                    |
 
 ### Memory & Session
 
@@ -109,38 +109,39 @@ This package provides CLI commands for the LumenFlow workflow framework, includi
 
 ### Initiative Orchestration
 
-| Command                      | Description                                                                                                                                                                  |
-| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `agent-issues-query`         | Query GitHub issues for agent work                                                                                                                                           |
-| `agent-log-issue`            | Log issue during agent session                                                                                                                                               |
-| `agent-session`              | Start agent session                                                                                                                                                          |
-| `agent-session-end`          | End agent session                                                                                                                                                            |
-| `delegation-list`            | List delegation and launch records with planned-versus-launched state                                                                                                        |
-| `initiative-add-wu`          | Add WU to initiative                                                                                                                                                         |
-| `initiative-bulk-assign-wus` | Bulk assign WUs to initiative                                                                                                                                                |
-| `initiative-create`          | Create new initiative                                                                                                                                                        |
-| `initiative-delete`          | Delete an initiative with explicit linked-WU safeguards                                                                                                                      |
-| `initiative-edit`            | Edit initiative fields and phase metadata                                                                                                                                    |
-| `initiative-list`            | List all initiatives                                                                                                                                                         |
-| `initiative-plan`            | Link plan to initiative                                                                                                                                                      |
-| `initiative-remove-wu`       | Remove WU from initiative                                                                                                                                                    |
-| `initiative-rename`          | Rename an initiative and rewrite linked references                                                                                                                           |
-| `initiative-status`          | Show initiative status                                                                                                                                                       |
-| `orchestrate-init-status`    | Compact initiative status with evidence-based orchestration state                                                                                                            |
-| `orchestrate-initiative`     | Plan, launch, and reconcile initiative execution with structured orchestration artifacts; launch modes print lean summaries by default and can replay stored handoffs inline |
-| `orchestrate-monitor`        | Monitor orchestration progress, stalls, returned workers, and recovery signals                                                                                               |
-| `task-claim`                 | Claim a task directly through KernelRuntime                                                                                                                                  |
+| Command                       | Description                                                                                                                                                                  |
+| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `agent-issues-query`          | Query GitHub issues for agent work                                                                                                                                           |
+| `agent-log-issue`             | Log issue during agent session                                                                                                                                               |
+| `agent-session`               | Start agent session                                                                                                                                                          |
+| `agent-session-end`           | End agent session                                                                                                                                                            |
+| `delegation-list`             | List delegation and launch records with planned-versus-launched state                                                                                                        |
+| `initiative-add-wu`           | Add WU to initiative                                                                                                                                                         |
+| `initiative-bulk-assign-wus`  | Bulk assign WUs to initiative                                                                                                                                                |
+| `initiative-create`           | Create new initiative                                                                                                                                                        |
+| `initiative-delete`           | Delete an initiative with explicit linked-WU safeguards                                                                                                                      |
+| `initiative-edit`             | Edit initiative fields and phase metadata                                                                                                                                    |
+| `initiative-list`             | List all initiatives                                                                                                                                                         |
+| `initiative-plan`             | Link plan to initiative                                                                                                                                                      |
+| `initiative-remove-wu`        | Remove WU from initiative                                                                                                                                                    |
+| `initiative-rename`           | Rename an initiative and rewrite linked references                                                                                                                           |
+| `initiative-status`           | Show initiative status                                                                                                                                                       |
+| `orchestrate-init-status`     | Compact initiative status with evidence-based orchestration state                                                                                                            |
+| `orchestrate-initiative`      | Plan, launch, and reconcile initiative execution with structured orchestration artifacts; launch modes print lean summaries by default and can replay stored handoffs inline |
+| `orchestrate-monitor`         | Monitor orchestration progress, stalls, returned workers, and recovery signals                                                                                               |
+| `orchestrate-pre-phase-audit` | Print a read-only pre-phase audit checklist before creating phase WUs                                                                                                        |
+| `task-claim`                  | Claim a task directly through KernelRuntime                                                                                                                                  |
 
 ### Metrics & Analytics
 
-| Command             | Description                    |
-| ------------------- | ------------------------------ |
-| `cost-summary`      | Summarize local cost telemetry |
-| `flow-bottlenecks`  | Identify flow bottlenecks      |
-| `flow-report`       | Generate flow metrics report   |
-| `lumenflow-metrics` | View workflow metrics (alias)  |
-| `metrics`           | View workflow metrics          |
-| `metrics-snapshot`  | Capture metrics snapshot       |
+| Command             | Description                                                  |
+| ------------------- | ------------------------------------------------------------ |
+| `cost-summary`      | Summarize local cost telemetry or brief metrics with --brief |
+| `flow-bottlenecks`  | Identify flow bottlenecks                                    |
+| `flow-report`       | Generate flow metrics report                                 |
+| `lumenflow-metrics` | View workflow metrics (alias)                                |
+| `metrics`           | View workflow metrics                                        |
+| `metrics-snapshot`  | Capture metrics snapshot                                     |
 
 ### Lane Tooling
 
@@ -161,6 +162,7 @@ This package provides CLI commands for the LumenFlow workflow framework, includi
 
 | Command                      | Description                                                        |
 | ---------------------------- | ------------------------------------------------------------------ |
+| `events-validate`            | Validate event payloads against the published schema catalog       |
 | `gate-co-change`             | Manage co-change gate rules (add, remove, edit, list)              |
 | `gate-conditional`           | Manage conditional_commands gate entries (add, remove, edit, list) |
 | `gates`                      | Run all quality gates                                              |

package/dist/agent-runtime-enrollment-events.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
 import { buildKernelEventV2 } from './kernel-event-sync/emitters.js';
 export const AGENT_RUNTIME_CHANNEL_ID = 'agent-runtime';
-const AGENT_RUNTIME_ENROLLMENT_EVENT_KINDS = {
+export const AGENT_RUNTIME_ENROLLMENT_EVENT_KINDS = {
     AGENT_SESSION_ENROLLED: 'agent-runtime:agent_session_enrolled',
     AGENT_SESSION_ENDED: 'agent-runtime:agent_session_ended',
     AGENT_SESSION_STALLED: 'agent-runtime:agent_session_stalled',

package/dist/agent-runtime-enrollment-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime-enrollment-events.js","sourceRoot":"","sources":["../src/agent-runtime-enrollment-events.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D,OAAO,EAAE,kBAAkB,EAAgC,MAAM,iCAAiC,CAAC;AAEnG,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAwB,CAAC;AAEjE,MAAM,oCAAoC,GAAG;IAC3C,sBAAsB,EAAE,sCAAsC;IAC9D,mBAAmB,EAAE,mCAAmC;IACxD,qBAAqB,EAAE,qCAAqC;CACpD,CAAC;AAoCX,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAErD,MAAM,UAAU,8BAA8B,CAC5C,KAAqF,EACrF,OAAiC;IAEjC,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,oCAAoC,CAAC,sBAAsB;QACjE,GAAG,KAAK;KACT,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAkF,EAClF,OAAiC;IAEjC,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,oCAAoC,CAAC,mBAAmB;QAC9D,GAAG,KAAK;KACT,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAoF,EACpF,OAAiC;IAEjC,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,oCAAoC,CAAC,qBAAqB;QAChE,GAAG,KAAK;KACT,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,OAAU,EACV,OAAiC;IAEjC,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAgB,EAAE,OAAO,CAI7D,CAAC;IAEF,OAAO;QACL,GAAG,SAAS;QACZ,GAAG,OAAO;QACV,UAAU,EAAE,wBAAwB;QACpC,GAAG,EAAE,OAAO,CAAC,wBAAwB,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,SAAiB;IAChC,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;IACzB,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"agent-runtime-enrollment-events.js","sourceRoot":"","sources":["../src/agent-runtime-enrollment-events.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D,OAAO,EAAE,kBAAkB,EAAgC,MAAM,iCAAiC,CAAC;AAEnG,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAwB,CAAC;AAEjE,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,sBAAsB,EAAE,sCAAsC;IAC9D,mBAAmB,EAAE,mCAAmC;IACxD,qBAAqB,EAAE,qCAAqC;CACpD,CAAC;AAoCX,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAErD,MAAM,UAAU,8BAA8B,CAC5C,KAAqF,EACrF,OAAiC;IAEjC,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,oCAAoC,CAAC,sBAAsB;QACjE,GAAG,KAAK;KACT,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAkF,EAClF,OAAiC;IAEjC,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,oCAAoC,CAAC,mBAAmB;QAC9D,GAAG,KAAK;KACT,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAoF,EACpF,OAAiC;IAEjC,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,oCAAoC,CAAC,qBAAqB;QAChE,GAAG,KAAK;KACT,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,OAAU,EACV,OAAiC;IAEjC,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAgB,EAAE,OAAO,CAI7D,CAAC;IAEF,OAAO;QACL,GAAG,SAAS;QACZ,GAAG,OAAO;QACV,UAAU,EAAE,wBAAwB;QACpC,GAAG,EAAE,OAAO,CAAC,wBAAwB,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,SAAiB;IAChC,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;IACzB,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cost-summary.js

@@ -5,9 +5,11 @@ import { existsSync, readFileSync } from 'node:fs';
 import { Command } from 'commander';
 import { runCLI } from './cli-entry-point.js';
 const DEFAULT_COSTS_PATH = '.lumenflow/telemetry/costs.ndjson';
+export const DEFAULT_BRIEF_METRICS_PATH = '.lumenflow/telemetry/brief-metrics.ndjson';
 const DEFAULT_GROUP_KEY = 'unknown';
 const LOG_PREFIX = '[cost:summary]';
 const SOURCE_TYPE_COST = 'cost';
+const BRIEF_METRIC_KIND = 'brief:token_reported';
 function asNonEmptyString(value) {
     if (typeof value !== 'string')
         return undefined;
@@ -72,6 +74,87 @@ export function readCostEvents(costsPath = DEFAULT_COSTS_PATH) {
         .map((line) => parseCostEventLine(line))
         .filter((event) => event !== null);
 }
+function asNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : undefined;
+}
+function parseBriefMetricSections(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const sections = [];
+    for (const item of value) {
+        if (typeof item !== 'object' || item === null) {
+            return undefined;
+        }
+        const record = item;
+        const name = asNonEmptyString(record.name);
+        const tokens = asNonNegativeInteger(record.tokens);
+        if (!name || tokens === undefined) {
+            return undefined;
+        }
+        sections.push({
+            name,
+            tokens,
+            ...(typeof record.stable === 'boolean' ? { stable: record.stable } : {}),
+        });
+    }
+    return sections;
+}
+export function parseBriefMetricLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        return null;
+    }
+    const record = parsed;
+    if (record.schema_version !== 2 || record.kind !== BRIEF_METRIC_KIND) {
+        return null;
+    }
+    const timestamp = asNonEmptyString(record.timestamp);
+    const generatedAt = asNonEmptyString(record.generated_at) ?? timestamp;
+    const wuId = asNonEmptyString(record.wu_id);
+    const clientName = asNonEmptyString(record.client_name) ?? asNonEmptyString(record.client);
+    const promptHash = asNonEmptyString(record.prompt_hash);
+    const totalTokens = asNonNegativeInteger(record.total_tokens);
+    const sections = parseBriefMetricSections(record.sections);
+    if (!timestamp || !generatedAt || !wuId || !clientName || !promptHash) {
+        return null;
+    }
+    if (totalTokens === undefined || sections === undefined) {
+        return null;
+    }
+    return {
+        timestamp,
+        generatedAt,
+        wuId,
+        clientName,
+        promptHash,
+        totalTokens,
+        sections,
+        stablePrefixHash: asNonEmptyString(record.stable_prefix_hash),
+        stablePrefixTokens: asNonNegativeInteger(record.stable_prefix_tokens),
+        volatileTailTokens: asNonNegativeInteger(record.volatile_tail_tokens),
+    };
+}
+export function readBriefMetricEvents(metricsPath = DEFAULT_BRIEF_METRICS_PATH) {
+    if (!existsSync(metricsPath)) {
+        return [];
+    }
+    const content = readFileSync(metricsPath, 'utf-8');
+    return content
+        .split('\n')
+        .map((line) => parseBriefMetricLine(line))
+        .filter((event) => event !== null);
+}
 function sortRowsDescending(rows) {
     return [...rows].sort((a, b) => b.costUsd - a.costUsd || b.eventCount - a.eventCount);
 }
@@ -112,6 +195,38 @@ export function summarizeCostEvents(events) {
     }
     return summary;
 }
+function sortBriefRowsDescending(rows) {
+    return [...rows].sort((a, b) => b.totalTokens - a.totalTokens || b.eventCount - a.eventCount || a.key.localeCompare(b.key));
+}
+function buildBriefGroupedRows(events, keySelector) {
+    const byKey = new Map();
+    for (const event of events) {
+        const key = keySelector(event) ?? DEFAULT_GROUP_KEY;
+        const current = byKey.get(key) ?? {
+            key,
+            totalTokens: 0,
+            eventCount: 0,
+            averageTokens: 0,
+        };
+        current.totalTokens += event.totalTokens;
+        current.eventCount += 1;
+        current.averageTokens = current.totalTokens / current.eventCount;
+        byKey.set(key, current);
+    }
+    return sortBriefRowsDescending(Array.from(byKey.values()));
+}
+export function summarizeBriefMetricEvents(events) {
+    const totalTokens = events.reduce((sum, event) => sum + event.totalTokens, 0);
+    const eventCount = events.length;
+    return {
+        totalTokens,
+        eventCount,
+        averageTokens: eventCount > 0 ? totalTokens / eventCount : 0,
+        byWu: buildBriefGroupedRows(events, (event) => event.wuId),
+        byClient: buildBriefGroupedRows(events, (event) => event.clientName),
+        byDate: buildBriefGroupedRows(events, (event) => event.generatedAt.slice(0, 10)),
+    };
+}
 function formatRows(title, rows) {
     const lines = [];
     lines.push(title);
@@ -139,12 +254,39 @@ export function formatCostSummary(summary) {
     lines.push(...formatRows('By WU:', summary.byWu));
     return lines.join('\n');
 }
+function formatBriefRows(title, rows) {
+    const lines = [];
+    lines.push(title);
+    if (rows.length === 0) {
+        lines.push('  (none)');
+        return lines;
+    }
+    for (const row of rows) {
+        lines.push(`  - ${row.key}: ${row.totalTokens} tokens (${row.eventCount} briefs, avg=${Math.round(row.averageTokens)})`);
+    }
+    return lines;
+}
+export function formatBriefMetricsSummary(summary) {
+    const lines = [];
+    lines.push('Brief Metrics Summary');
+    lines.push(`  Briefs: ${summary.eventCount}`);
+    lines.push(`  Total Tokens: ${summary.totalTokens}`);
+    lines.push(`  Average Tokens: ${Math.round(summary.averageTokens)}`);
+    lines.push('');
+    lines.push(...formatBriefRows('By WU:', summary.byWu));
+    lines.push('');
+    lines.push(...formatBriefRows('By Client:', summary.byClient));
+    lines.push('');
+    lines.push(...formatBriefRows('By Date:', summary.byDate));
+    return lines.join('\n');
+}
 function parseArgs() {
     const program = new Command()
         .name('cost-summary')
-        .description('Summarize local cost telemetry from .lumenflow/telemetry/costs.ndjson')
+        .description('Summarize local cost or brief metrics telemetry')
         .option('--json', 'Output JSON instead of human-readable text', false)
-        .option('--path <path>', `Path to costs NDJSON file (default: ${DEFAULT_COSTS_PATH})`)
+        .option('--brief', `Summarize brief metrics from ${DEFAULT_BRIEF_METRICS_PATH}`, false)
+        .option('--path <path>', 'Path to telemetry NDJSON file')
         .exitOverride();
     try {
         program.parse(process.argv);
@@ -157,13 +299,28 @@ function parseArgs() {
         throw err;
     }
     const options = program.opts();
+    const brief = options.brief ?? false;
     return {
         json: options.json ?? false,
-        path: options.path ?? DEFAULT_COSTS_PATH,
+        path: options.path ?? (brief ? DEFAULT_BRIEF_METRICS_PATH : DEFAULT_COSTS_PATH),
+        brief,
     };
 }
 export async function main() {
     const options = parseArgs();
+    if (options.brief) {
+        const events = readBriefMetricEvents(options.path);
+        const summary = summarizeBriefMetricEvents(events);
+        if (events.length === 0) {
+            console.log(`${LOG_PREFIX} No brief metrics telemetry found at ${options.path}`);
+        }
+        if (options.json) {
+            console.log(JSON.stringify(summary, null, 2));
+            return;
+        }
+        console.log(formatBriefMetricsSummary(summary));
+        return;
+    }
     const events = readCostEvents(options.path);
     const summary = summarizeCostEvents(events);
     if (events.length === 0) {

package/dist/cost-summary.js.map

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

package/dist/events-validate-core.js

@@ -0,0 +1,169 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { createError, ErrorCodes } from '@lumenflow/core/error-handler';
+import { buildEventSchemaIndex, EVENT_SCHEMA_FAMILIES, validateEventWithSchemaIndex, } from '@lumenflow/control-plane-sdk';
+import { AGENT_RUNTIME_CHANNEL_ID, AGENT_RUNTIME_ENROLLMENT_EVENT_KINDS, } from './agent-runtime-enrollment-events.js';
+import { SOFTWARE_DELIVERY_CHANNEL_ID, SOFTWARE_DELIVERY_EVENT_KIND_VALUES, } from './kernel-event-sync/software-delivery-emitters.js';
+const DEFAULT_VALID_FIXTURE_DIR = '.lumenflow/schemas/events/fixtures/valid';
+const NON_EMPTY_STRING = z.string().min(1);
+const NON_NEGATIVE_INT = z.number().int().nonnegative();
+export const DEFAULT_EVENTS_VALIDATE_PATHS = [DEFAULT_VALID_FIXTURE_DIR];
+const softwareDeliveryEventSchema = z
+    .object({
+    schema_version: z.literal(2),
+    kind: z.enum(SOFTWARE_DELIVERY_EVENT_KIND_VALUES),
+    timestamp: NON_EMPTY_STRING,
+    event_id: NON_EMPTY_STRING,
+    channel_id: z.literal(SOFTWARE_DELIVERY_CHANNEL_ID),
+    seq: NON_NEGATIVE_INT,
+})
+    .passthrough();
+const agentRuntimeEventSchema = z
+    .object({
+    schema_version: z.literal(2),
+    kind: z.enum([
+        AGENT_RUNTIME_ENROLLMENT_EVENT_KINDS.AGENT_SESSION_ENROLLED,
+        AGENT_RUNTIME_ENROLLMENT_EVENT_KINDS.AGENT_SESSION_ENDED,
+        AGENT_RUNTIME_ENROLLMENT_EVENT_KINDS.AGENT_SESSION_STALLED,
+    ]),
+    timestamp: NON_EMPTY_STRING,
+    event_id: NON_EMPTY_STRING,
+    channel_id: z.literal(AGENT_RUNTIME_CHANNEL_ID),
+    seq: NON_NEGATIVE_INT,
+    session_id: NON_EMPTY_STRING,
+    wu_id: NON_EMPTY_STRING,
+    lane: NON_EMPTY_STRING,
+})
+    .passthrough();
+export const CLI_EVENT_SCHEMA_FAMILIES = [
+    ...EVENT_SCHEMA_FAMILIES,
+    {
+        id: 'software-delivery-events',
+        title: 'LumenFlow Software Delivery Event Envelope',
+        schema_id: 'https://schemas.lumenflow.dev/events/software-delivery-events.v1.schema.json',
+        file_name: 'software-delivery-events.v1.schema.json',
+        notes: [
+            'Audits the schema_version=2 software-delivery pack event family emitted from the CLI.',
+            'The validator checks the shared envelope, channel, sequence, and known kind set; kind-specific payload tests remain with the emitters.',
+        ],
+        schemas: [
+            ...SOFTWARE_DELIVERY_EVENT_KIND_VALUES.map((kind) => ({
+                kind,
+                schema: softwareDeliveryEventSchema.extend({ kind: z.literal(kind) }),
+            })),
+        ],
+    },
+    {
+        id: 'agent-runtime-events',
+        title: 'LumenFlow Agent Runtime Event Envelope',
+        schema_id: 'https://schemas.lumenflow.dev/events/agent-runtime-events.v1.schema.json',
+        file_name: 'agent-runtime-events.v1.schema.json',
+        notes: [
+            'Audits the schema_version=2 agent-runtime enrollment/stall event family.',
+            'This is the agent-runtime counterpart to the INIT-072 measurement/routing event plane.',
+        ],
+        schemas: [
+            ...Object.values(AGENT_RUNTIME_ENROLLMENT_EVENT_KINDS).map((kind) => ({
+                kind,
+                schema: agentRuntimeEventSchema.extend({ kind: z.literal(kind) }),
+            })),
+        ],
+    },
+];
+const CLI_EVENT_SCHEMA_INDEX = buildEventSchemaIndex(CLI_EVENT_SCHEMA_FAMILIES);
+export function validateEventRecords(records) {
+    const issues = [];
+    for (const [index, record] of records.entries()) {
+        const result = validateEventWithSchemaIndex(record, CLI_EVENT_SCHEMA_INDEX);
+        for (const issue of result.issues) {
+            issues.push({
+                ...issue,
+                path: `$[${index}]${issue.path === '$' ? '' : issue.path.slice(1)}`,
+            });
+        }
+    }
+    return {
+        valid: issues.length === 0,
+        total: records.length,
+        invalid: issues.length === 0 ? 0 : countInvalidRecords(issues),
+        issues,
+    };
+}
+export function validateEventsText(text) {
+    return validateEventRecords(parseEventRecords(text));
+}
+export function loadEventRecordsFromPath(inputPath) {
+    if (!existsSync(inputPath)) {
+        throw createError(ErrorCodes.FILE_NOT_FOUND, `Event validation input does not exist: ${inputPath}`, { inputPath });
+    }
+    const stats = statSync(inputPath);
+    if (stats.isDirectory()) {
+        return listEventFiles(inputPath).flatMap((filePath) => loadEventRecordsFromPath(filePath));
+    }
+    return parseEventRecords(readFileSync(inputPath, 'utf-8'));
+}
+export function formatValidationSummary(summary) {
+    const lines = [
+        `events:validate ${summary.valid ? 'passed' : 'failed'}`,
+        `  Events: ${summary.total}`,
+        `  Invalid: ${summary.invalid}`,
+    ];
+    for (const issue of summary.issues) {
+        lines.push(`  - ${issue.code} ${issue.path}: ${issue.message}`);
+    }
+    return lines.join('\n');
+}
+function parseEventRecords(text) {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        return normalizeParsedEventInput(parsed);
+    }
+    catch {
+        return trimmed.split('\n').map((line, index) => parseNdjsonLine(line, index + 1));
+    }
+}
+function normalizeParsedEventInput(parsed) {
+    if (Array.isArray(parsed)) {
+        return parsed;
+    }
+    if (parsed &&
+        typeof parsed === 'object' &&
+        Array.isArray(parsed.events)) {
+        return parsed.events;
+    }
+    return [parsed];
+}
+function parseNdjsonLine(line, lineNumber) {
+    try {
+        return JSON.parse(line);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw createError(ErrorCodes.PARSE_ERROR, `Failed to parse event NDJSON line ${lineNumber}: ${message}`, { lineNumber, cause: message });
+    }
+}
+function listEventFiles(dir) {
+    const files = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const entryPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...listEventFiles(entryPath));
+            continue;
+        }
+        if (entry.isFile()) {
+            files.push(entryPath);
+        }
+    }
+    return files.sort();
+}
+function countInvalidRecords(issues) {
+    return new Set(issues.map((issue) => issue.path.match(/^\$\[(\d+)\]/)?.[1] ?? issue.path)).size;
+}
+//# sourceMappingURL=events-validate-core.js.map

package/dist/events-validate-core.js.map

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