@omnitron-dev/omnitron 0.1.3 → 0.3.0

package/dist/commands/kb.js

@@ -1,4 +1,58 @@
+import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
+import { getEnv } from '../shared/env-config.js';
+/**
+ * Where the knowledge base lives: `~/.omnitron/kb.db`, a SurrealKV directory.
+ *
+ * One definition for the four commands below, which each spelled it out.
+ */
+function kbDbPath() {
+    return resolve(process.env['HOME'] ?? '.', '.omnitron', 'kb.db');
+}
+/**
+ * The knowledge base, opened for reading — or `null`, after saying why there
+ * is nothing to read and setting exit code 1.
+ *
+ * `kb status` and `kb query` used to open the store unconditionally, and for
+ * a store that is not there opening is creating: `SurrealKbStore.initialize()`
+ * connects, which makes the SurrealKV directory, and applies `KB_SCHEMA`.
+ * Measured 2026-09-23 with a scratch HOME: `kb status` printed eight lines of
+ * zeros, exited 0 and left a 32 KB `.omnitron/kb.db` behind; `kb query`
+ * answered «Found 0 results (0 tokens)» and exited 0. Both read as «indexed,
+ * and nothing matched» — the one thing that was not true — and on a real HOME
+ * both would have written into `~/.omnitron` the same way. So the path is
+ * checked before anything is opened.
+ *
+ * A store that exists and holds no module is the same answer, and is refused
+ * the same way: every source `kb index` takes writes its module first
+ * (`Indexer.indexSource`), so zero modules means nothing was ever indexed into
+ * it. That is exactly what the old `kb status` and `kb query` left behind, and
+ * what `kb mcp` still creates on a machine that never ran `kb index`.
+ */
+async function openIndexedKb() {
+    const { log } = await import('@xec-sh/kit');
+    const dbPath = kbDbPath();
+    if (!existsSync(dbPath)) {
+        log.error('The knowledge base is not indexed — run `omnitron kb index`.');
+        log.info(`Nothing at ${dbPath}; nothing was created there.`);
+        process.exitCode = 1;
+        return null;
+    }
+    const { KnowledgeBase } = await import('@omnitron-dev/kb');
+    const { SurrealKbStore } = await import('@omnitron-dev/kb/surreal');
+    const root = getEnv().OMNITRON_ROOT ?? process.cwd();
+    const kb = new KnowledgeBase({ store: new SurrealKbStore({ url: `surrealkv://${dbPath}` }), root });
+    await kb.initialize();
+    const stats = await kb.status();
+    if (stats.modules === 0) {
+        await kb.close();
+        log.error('The knowledge base is not indexed: no module has been indexed into it — run `omnitron kb index`.');
+        log.info(`${dbPath} exists and is empty. \`kb index\` reads the workspace at OMNITRON_ROOT, or the current directory.`);
+        process.exitCode = 1;
+        return null;
+    }
+    return { kb, stats };
+}
 /**
  * `omnitron kb mcp` — Start MCP server for AI assistants.
  * Connects to daemon for management tools, initializes KB for knowledge tools.
@@ -10,14 +64,18 @@ export async function kbMcpCommand() {
     const { createInfraTools } = await import('../mcp/tool-groups/infra.tools.js');
     const { createMonitoringTools } = await import('../mcp/tool-groups/monitoring.tools.js');
     const { createManagementTools } = await import('../mcp/tool-groups/management.tools.js');
+    const { createUnavailableTools, DAEMON_TOOL_NAMES, KB_TOOL_NAMES } = await import('../mcp/unavailable-tools.js');
+    const DAEMON_DOWN = 'The omnitron daemon is not running. Run `omnitron up` to start it.';
     const bridge = new McpBridge();
     // Initialize KB (standalone, no daemon required)
     let kbService = null;
     try {
         const { KnowledgeBase } = await import('@omnitron-dev/kb');
         const { SurrealKbStore } = await import('@omnitron-dev/kb/surreal');
-        const dbPath = resolve(process.env['HOME'] ?? '.', '.omnitron', 'kb.db');
-        const root = process.env['OMNITRON_ROOT'] ?? process.cwd();
+        const dbPath = kbDbPath();
+        const root = getEnv().OMNITRON_ROOT ?? process.cwd();
+        // Opens — and on a machine that never ran `kb index`, creates — the
+        // store, deliberately: this server's `kb.index` tool indexes into it.
         const store = new SurrealKbStore({ url: `surrealkv://${dbPath}` });
         const kb = new KnowledgeBase({ store, root });
         await kb.initialize();
@@ -25,9 +83,14 @@ export async function kbMcpCommand() {
         bridge.registerTools(createKbTools(kbService));
     }
     catch (err) {
-        // KB not available — register stub tools that return helpful errors
+        // Register stubs rather than nothing. An agent that cannot see a tool
+        // concludes the capability does not exist; one that sees it and is told
+        // why relays something the user can act on. stderr is not read by MCP
+        // clients, so the message below reaches a human tailing the process and
+        // no one else.
         process.stderr.write(`[mcp] KB initialization failed: ${err}\n`);
-        process.stderr.write('[mcp] KB tools will not be available. Run `omnitron kb index` first.\n');
+        process.stderr.write('[mcp] KB tools will report: run `omnitron kb index` first.\n');
+        bridge.registerTools(createUnavailableTools(KB_TOOL_NAMES, 'The knowledge base is not indexed. Run `omnitron kb index` first.'));
     }
     // Try connecting to daemon for management tools
     let daemonClient = null;
@@ -41,12 +104,13 @@ export async function kbMcpCommand() {
             bridge.registerTools(createManagementTools(daemonClient));
         }
         else {
-            process.stderr.write('[mcp] Daemon not running — management tools not available.\n');
-            process.stderr.write('[mcp] Run `omnitron up` to start the daemon.\n');
+            process.stderr.write('[mcp] Daemon not running — management tools will report why.\n');
+            bridge.registerTools(createUnavailableTools(DAEMON_TOOL_NAMES, DAEMON_DOWN));
         }
     }
-    catch {
-        process.stderr.write('[mcp] Daemon connection failed — management tools not available.\n');
+    catch (err) {
+        process.stderr.write(`[mcp] Daemon connection failed: ${err}\n`);
+        bridge.registerTools(createUnavailableTools(DAEMON_TOOL_NAMES, DAEMON_DOWN));
     }
     // Start stdio MCP server
     await bridge.start();
@@ -60,11 +124,12 @@ export async function kbMcpCommand() {
  * `omnitron kb index` — Reindex the knowledge base.
  */
 export async function kbIndexCommand(options) {
-    const { log, spinner } = await import('@xec-sh/kit');
+    const { log } = await import('@xec-sh/kit');
+    const { spinner } = await import('./spinner.js');
     const { KnowledgeBase } = await import('@omnitron-dev/kb');
     const { SurrealKbStore } = await import('@omnitron-dev/kb/surreal');
-    const dbPath = resolve(process.env['HOME'] ?? '.', '.omnitron', 'kb.db');
-    const root = process.env['OMNITRON_ROOT'] ?? process.cwd();
+    const dbPath = kbDbPath();
+    const root = getEnv().OMNITRON_ROOT ?? process.cwd();
     const s = spinner();
     s.start('Initializing knowledge base...');
     const store = new SurrealKbStore({ url: `surrealkv://${dbPath}` });
@@ -91,14 +156,10 @@ export async function kbIndexCommand(options) {
  */
 export async function kbStatusCommand() {
     const { log } = await import('@xec-sh/kit');
-    const { KnowledgeBase } = await import('@omnitron-dev/kb');
-    const { SurrealKbStore } = await import('@omnitron-dev/kb/surreal');
-    const dbPath = resolve(process.env['HOME'] ?? '.', '.omnitron', 'kb.db');
-    const root = process.env['OMNITRON_ROOT'] ?? process.cwd();
-    const store = new SurrealKbStore({ url: `surrealkv://${dbPath}` });
-    const kb = new KnowledgeBase({ store, root });
-    await kb.initialize();
-    const stats = await kb.status();
+    const opened = await openIndexedKb();
+    if (!opened)
+        return;
+    const { kb, stats } = opened;
     log.info('Knowledge Base Status:');
     log.info(`  Modules:       ${stats.modules}`);
     log.info(`  Symbols:       ${stats.symbols}`);
@@ -107,10 +168,11 @@ export async function kbStatusCommand() {
     log.info(`  Gotchas:       ${stats.gotchas}`);
     log.info(`  Patterns:      ${stats.patterns}`);
     log.info(`  Dependencies:  ${stats.dependencies}`);
+    // Counted by the store now; it was the constant 0 there (surreal/client.ts).
     log.info(`  Embeddings:    ${stats.embeddingsIndexed}`);
-    if (stats.lastIndexedAt) {
-        log.info(`  Last indexed:  ${stats.lastIndexedAt}`);
-    }
+    // No «Last indexed» line: nothing records when an index ran, so the store
+    // can only answer `null`, and a line that could never print was a promise
+    // of a measurement that does not exist.
     await kb.close();
 }
 /**
@@ -118,13 +180,10 @@ export async function kbStatusCommand() {
  */
 export async function kbQueryCommand(question) {
     const { log } = await import('@xec-sh/kit');
-    const { KnowledgeBase } = await import('@omnitron-dev/kb');
-    const { SurrealKbStore } = await import('@omnitron-dev/kb/surreal');
-    const dbPath = resolve(process.env['HOME'] ?? '.', '.omnitron', 'kb.db');
-    const root = process.env['OMNITRON_ROOT'] ?? process.cwd();
-    const store = new SurrealKbStore({ url: `surrealkv://${dbPath}` });
-    const kb = new KnowledgeBase({ store, root });
-    await kb.initialize();
+    const opened = await openIndexedKb();
+    if (!opened)
+        return;
+    const { kb } = opened;
     const result = await kb.query(question, { maxResults: 5 });
     log.info(`Found ${result.entries.length} results (${result.totalTokens} tokens):`);
     for (const entry of result.entries) {

package/dist/commands/kb.js.map

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

package/dist/commands/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA2EjD"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgGjD"}

package/dist/commands/list.js

@@ -6,15 +6,20 @@
 import { table, log, prism } from '@xec-sh/kit';
 import { createDaemonClient } from '../daemon/daemon-client.js';
 import { formatStatus, formatMemoryColored, formatUptime, formatCpu, formatRestarts, formatPort, } from '../shared/format.js';
+import { emitJson } from './output.js';
+import { requireDaemon } from './daemon-required.js';
 export async function listCommand() {
     const client = createDaemonClient();
-    if (!(await client.isReachable())) {
-        log.warn('Daemon is not running');
+    if (!(await requireDaemon(client))) {
         await client.disconnect();
         return;
     }
     try {
         const apps = await client.list();
+        if (emitJson({ apps })) {
+            await client.disconnect();
+            return;
+        }
         if (apps.length === 0) {
             log.info('No apps registered');
             await client.disconnect();
@@ -38,8 +43,19 @@ export async function listCommand() {
             // Sub-processes indented
             if (app.processes && app.processes.length > 0) {
                 for (const proc of app.processes) {
+                    // A pool row prints ONE pid for several processes. Without the
+                    // count the row reads as a single worker, and the `-` under RST
+                    // (nothing counts a pool's restarts) has nothing to explain it.
+                    // Drift from the declaration is coloured rather than hidden —
+                    // `doctor` reports it as a finding, but the table is where an
+                    // operator looks first.
+                    const scale = proc.declaredInstances > 1
+                        ? proc.instances === proc.declaredInstances
+                            ? prism.dim(` \u00d7${proc.instances}`)
+                            : prism.yellow(` \u00d7${proc.instances}/${proc.declaredInstances}`)
+                        : '';
                     data.push({
-                        name: `    ${prism.dim('└')} ${proc.name} ${prism.dim(`(${proc.type})`)}`,
+                        name: `    ${prism.dim('└')} ${proc.name} ${prism.dim(`(${proc.type})`)}${scale}`,
                         status: formatStatus(proc.status),
                         pid: proc.pid ? String(proc.pid) : '-',
                         port: '',
@@ -55,6 +71,12 @@ export async function listCommand() {
         }
         table({
             data,
+            // 'auto' sizes to content. The default is 'full', which fits the table
+            // to the terminal by dividing what is left after the widest column —
+            // with nine columns and an 80-column terminal that leaves about five
+            // characters each, so every value AND every header rendered as an
+            // ellipsis. The primary command of the tool was unreadable.
+            width: 'auto',
             columns: [
                 { key: 'name', header: 'NAME', width: 'content' },
                 { key: 'status', header: 'STATUS', width: 'content' },

package/dist/commands/list.js.map

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

package/dist/commands/log-health.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Reading the log table as a symptom.
+ *
+ * A message repeated far more often than anything else is not noise — it is
+ * a loop that cannot make progress, and it is invisible from every surface
+ * an operator normally looks at. The logs page shows the most recent lines,
+ * which are all the same line; the alerts page shows rules nobody wrote for
+ * a failure nobody predicted; and the daemon reports itself healthy the
+ * whole time, because it is.
+ *
+ * This host carried 2.5 million copies of "Failed to process outbox event"
+ * across three days in May — one event with a `retryCount` of 799 289 — and
+ * nothing anywhere said so. The table was also 13 GB, and most of that was
+ * this.
+ *
+ * The rules here are deliberately about SHAPE rather than volume. "More than
+ * N errors an hour" is a threshold someone has to tune per deployment and
+ * will eventually raise rather than investigate. "One message is most of the
+ * errors" is scale-free: it means the same thing on a quiet host and a busy
+ * one, and it is exactly the signature of a retry loop.
+ */
+export interface MessageCount {
+    app: string;
+    message: string;
+    count: number;
+}
+export interface LogHealthFinding {
+    kind: 'dominant-error' | 'repetition-load' | 'retry-loop' | 'duplicate-ingest';
+    app: string;
+    message: string;
+    count: number;
+    /** Share of the window's errors, 0..1. Only for `dominant-error`. */
+    share?: number;
+    /** Highest retry count seen on the offending events. Only for `retry-loop`. */
+    retryCount?: number;
+}
+/**
+ * A single message has to be this much of the error volume, and occur this
+ * many times, before it is worth an operator's attention.
+ *
+ * Both are needed. The share alone fires on a host with four errors all
+ * morning, three of them the same; the count alone is the tunable threshold
+ * this is trying not to be.
+ */
+export declare const DOMINANCE_SHARE = 0.5;
+export declare const DOMINANCE_MIN_COUNT = 100;
+/** A retry count past this is a loop, not a retry policy. */
+export declare const RETRY_LOOP_THRESHOLD = 1000;
+export declare function findDominantErrors(counts: MessageCount[]): LogHealthFinding[];
+/**
+ * Loops that no single-message threshold can see.
+ *
+ * `findDominantErrors` asks whether ONE message is most of the day's errors.
+ * Its denominator is every error, the other loops included — so each further
+ * broken thing enlarges the denominator and shrinks every share. The check
+ * grows quieter as the installation gets worse, and no choice of threshold
+ * repairs that: with eight loops running, none of them can reach half the
+ * errors even when every error on the host is a loop.
+ *
+ * Measured here on 2026-09-07 by running the check's own query: 15 094
+ * error rows in twenty-four hours, eight repeating messages, 76.5% of the
+ * volume between them, largest share 27.8%. Nothing was reported. The first
+ * of those loops, alone, would have been 100% and reported at once.
+ *
+ * So sum the numerators. A message repeating at least DOMINANCE_MIN_COUNT
+ * times is a loop by the standard the other check already uses; when two or
+ * more of them clear DOMINANCE_SHARE together, repetition is what the error
+ * log is made of. No new threshold: the same two constants answer a different
+ * question about the same data.
+ *
+ * Complementary by construction — when one message already clears the share
+ * `findDominantErrors` reports it and this returns nothing, so no loop is
+ * named twice.
+ */
+export declare function findRepetitionLoad(counts: MessageCount[]): LogHealthFinding[];
+/**
+ * The share of a window that must be duplicated before this is a finding.
+ *
+ * A pair of identical (timestamp, message) rows under two app names is not
+ * automatically a defect: several apps going through a coordinated shutdown
+ * log "Application stopping" in the same millisecond, and that is two apps
+ * doing the same thing rather than one line stored twice.
+ *
+ * Measured on this host: the systematic duplication was around half the
+ * table; the coincidences that remain after fixing it are 1.4% — eighteen
+ * rows in twelve hundred, every one of them a lifecycle phase shared
+ * between apps. Ten percent sits an order of magnitude above the noise and
+ * well below the defect.
+ *
+ * The first version of this check had no threshold at all and fired on
+ * those eighteen rows, which is how a guard becomes something people
+ * switch off.
+ */
+export declare const DUPLICATION_SHARE = 0.1;
+/**
+ * Messages recorded under more than one app name at the same instant.
+ *
+ * Not a nicety when it is systematic: it doubles the log table, and this
+ * host's was 13 GB. It also makes every per-app count wrong by a factor that
+ * depends on which component happened to emit the line, which is the kind of
+ * error that survives because each number looks plausible on its own.
+ */
+export declare function findDuplicatedLogs(pairs: Array<{
+    app: string;
+    otherApp: string;
+    count: number;
+}>, totalRows: number): LogHealthFinding[];
+/**
+ * Turn a retry count into a finding.
+ *
+ * A retry policy has a ceiling; a number in the hundreds of thousands means
+ * the ceiling is missing, and the work is not being done either way. The
+ * event will never succeed and the loop will never stop.
+ */
+export declare function findRetryLoops(counts: Array<MessageCount & {
+    retryCount: number;
+}>): LogHealthFinding[];
+/** One line an operator can act on. */
+export declare function describeFinding(finding: LogHealthFinding): string;
+//# sourceMappingURL=log-health.d.ts.map

package/dist/commands/log-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-health.d.ts","sourceRoot":"","sources":["../../src/commands/log-health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,YAAY,GAAG,kBAAkB,CAAC;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AA0B1C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE,CA4B7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,EAAE,CA0B7E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9D,SAAS,EAAE,MAAM,GAChB,gBAAgB,EAAE,CAcpB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,gBAAgB,EAAE,CAWvG;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAUjE"}

package/dist/commands/log-health.js

@@ -0,0 +1,212 @@
+/**
+ * Reading the log table as a symptom.
+ *
+ * A message repeated far more often than anything else is not noise — it is
+ * a loop that cannot make progress, and it is invisible from every surface
+ * an operator normally looks at. The logs page shows the most recent lines,
+ * which are all the same line; the alerts page shows rules nobody wrote for
+ * a failure nobody predicted; and the daemon reports itself healthy the
+ * whole time, because it is.
+ *
+ * This host carried 2.5 million copies of "Failed to process outbox event"
+ * across three days in May — one event with a `retryCount` of 799 289 — and
+ * nothing anywhere said so. The table was also 13 GB, and most of that was
+ * this.
+ *
+ * The rules here are deliberately about SHAPE rather than volume. "More than
+ * N errors an hour" is a threshold someone has to tune per deployment and
+ * will eventually raise rather than investigate. "One message is most of the
+ * errors" is scale-free: it means the same thing on a quiet host and a busy
+ * one, and it is exactly the signature of a retry loop.
+ */
+/**
+ * A single message has to be this much of the error volume, and occur this
+ * many times, before it is worth an operator's attention.
+ *
+ * Both are needed. The share alone fires on a host with four errors all
+ * morning, three of them the same; the count alone is the tunable threshold
+ * this is trying not to be.
+ */
+export const DOMINANCE_SHARE = 0.5;
+export const DOMINANCE_MIN_COUNT = 100;
+/** A retry count past this is a loop, not a retry policy. */
+export const RETRY_LOOP_THRESHOLD = 1_000;
+/**
+ * Find messages that dominate the error volume of a window.
+ *
+ * @param counts per-message error counts for the window, any order
+ */
+/**
+ * One row per message, with the apps that reported it.
+ *
+ * Shared by both dominance checks deliberately. They ask different questions
+ * of the same grouping, and a second copy of it is a second registry of one
+ * fact — the exact shape that lets two correct-looking pieces of code drift
+ * apart.
+ */
+function groupByMessage(counts) {
+    const byMessage = new Map();
+    for (const c of counts) {
+        const entry = byMessage.get(c.message) ?? { apps: new Set(), count: 0 };
+        entry.apps.add(c.app);
+        entry.count += c.count;
+        byMessage.set(c.message, entry);
+    }
+    return byMessage;
+}
+export function findDominantErrors(counts) {
+    const total = counts.reduce((sum, c) => sum + c.count, 0);
+    if (total === 0)
+        return [];
+    // Grouped by message, not by (app, message).
+    //
+    // Every child log line is currently stored twice — once under the app's
+    // own name and once under `omnitron`, because titan-pm re-logs child output
+    // through the parent logger while the orchestrator is already capturing it.
+    // Per-app grouping splits one message into two rows of half the size each,
+    // so a message that is 100% of the errors measures as 50% and slips under
+    // any threshold at or above that. Found by running this check against the
+    // window where the loop actually happened.
+    //
+    // Grouping by message is right either way: the same failure reported by
+    // two components is still one failure.
+    const byMessage = groupByMessage(counts);
+    return [...byMessage.entries()]
+        .filter(([, e]) => e.count >= DOMINANCE_MIN_COUNT && e.count / total >= DOMINANCE_SHARE)
+        .map(([message, e]) => ({
+        kind: 'dominant-error',
+        app: [...e.apps].sort().join(', '),
+        message,
+        count: e.count,
+        share: e.count / total,
+    }))
+        .sort((a, b) => b.count - a.count);
+}
+/**
+ * Loops that no single-message threshold can see.
+ *
+ * `findDominantErrors` asks whether ONE message is most of the day's errors.
+ * Its denominator is every error, the other loops included — so each further
+ * broken thing enlarges the denominator and shrinks every share. The check
+ * grows quieter as the installation gets worse, and no choice of threshold
+ * repairs that: with eight loops running, none of them can reach half the
+ * errors even when every error on the host is a loop.
+ *
+ * Measured here on 2026-09-07 by running the check's own query: 15 094
+ * error rows in twenty-four hours, eight repeating messages, 76.5% of the
+ * volume between them, largest share 27.8%. Nothing was reported. The first
+ * of those loops, alone, would have been 100% and reported at once.
+ *
+ * So sum the numerators. A message repeating at least DOMINANCE_MIN_COUNT
+ * times is a loop by the standard the other check already uses; when two or
+ * more of them clear DOMINANCE_SHARE together, repetition is what the error
+ * log is made of. No new threshold: the same two constants answer a different
+ * question about the same data.
+ *
+ * Complementary by construction — when one message already clears the share
+ * `findDominantErrors` reports it and this returns nothing, so no loop is
+ * named twice.
+ */
+export function findRepetitionLoad(counts) {
+    if (findDominantErrors(counts).length > 0)
+        return [];
+    const total = counts.reduce((sum, c) => sum + c.count, 0);
+    if (total === 0)
+        return [];
+    const loops = [...groupByMessage(counts).entries()]
+        .filter(([, e]) => e.count >= DOMINANCE_MIN_COUNT)
+        .sort((a, b) => b[1].count - a[1].count);
+    // One repeating message below the share is not this finding; it is a busy
+    // day with one bad actor, and `findDominantErrors` has already declined it.
+    if (loops.length < 2)
+        return [];
+    const count = loops.reduce((sum, [, e]) => sum + e.count, 0);
+    const share = count / total;
+    if (share < DOMINANCE_SHARE)
+        return [];
+    return [
+        {
+            kind: 'repetition-load',
+            app: [...new Set(loops.flatMap(([, e]) => [...e.apps]))].sort().join(', '),
+            message: loops.map(([message, e]) => `${message} (${e.count.toLocaleString('en-US')})`).join('; '),
+            count,
+            share,
+        },
+    ];
+}
+/**
+ * The share of a window that must be duplicated before this is a finding.
+ *
+ * A pair of identical (timestamp, message) rows under two app names is not
+ * automatically a defect: several apps going through a coordinated shutdown
+ * log "Application stopping" in the same millisecond, and that is two apps
+ * doing the same thing rather than one line stored twice.
+ *
+ * Measured on this host: the systematic duplication was around half the
+ * table; the coincidences that remain after fixing it are 1.4% — eighteen
+ * rows in twelve hundred, every one of them a lifecycle phase shared
+ * between apps. Ten percent sits an order of magnitude above the noise and
+ * well below the defect.
+ *
+ * The first version of this check had no threshold at all and fired on
+ * those eighteen rows, which is how a guard becomes something people
+ * switch off.
+ */
+export const DUPLICATION_SHARE = 0.1;
+/**
+ * Messages recorded under more than one app name at the same instant.
+ *
+ * Not a nicety when it is systematic: it doubles the log table, and this
+ * host's was 13 GB. It also makes every per-app count wrong by a factor that
+ * depends on which component happened to emit the line, which is the kind of
+ * error that survives because each number looks plausible on its own.
+ */
+export function findDuplicatedLogs(pairs, totalRows) {
+    const duplicated = pairs.reduce((sum, p) => sum + p.count, 0);
+    if (duplicated === 0 || totalRows === 0)
+        return [];
+    if (duplicated / totalRows < DUPLICATION_SHARE)
+        return [];
+    return [
+        {
+            kind: 'duplicate-ingest',
+            app: [...new Set(pairs.flatMap((p) => [p.app, p.otherApp]))].sort().join(', '),
+            message: `${duplicated.toLocaleString('en-US')} of ${totalRows.toLocaleString('en-US')} recent rows are stored twice`,
+            count: duplicated,
+            share: duplicated / totalRows,
+        },
+    ];
+}
+/**
+ * Turn a retry count into a finding.
+ *
+ * A retry policy has a ceiling; a number in the hundreds of thousands means
+ * the ceiling is missing, and the work is not being done either way. The
+ * event will never succeed and the loop will never stop.
+ */
+export function findRetryLoops(counts) {
+    return counts
+        .filter((c) => c.retryCount >= RETRY_LOOP_THRESHOLD)
+        .map((c) => ({
+        kind: 'retry-loop',
+        app: c.app,
+        message: c.message,
+        count: c.count,
+        retryCount: c.retryCount,
+    }))
+        .sort((a, b) => b.retryCount - a.retryCount);
+}
+/** One line an operator can act on. */
+export function describeFinding(finding) {
+    if (finding.kind === 'duplicate-ingest')
+        return `${finding.message} (${finding.app})`;
+    if (finding.kind === 'retry-loop') {
+        return `${finding.app}: "${finding.message}" — an event has been retried ${finding.retryCount.toLocaleString('en-US')} times`;
+    }
+    const percent = Math.round((finding.share ?? 0) * 100);
+    if (finding.kind === 'repetition-load') {
+        return `${finding.count.toLocaleString('en-US')} of the day's errors (${percent}%) are repeats of: ${finding.message}`;
+    }
+    return `${finding.app}: "${finding.message}" — ${finding.count.toLocaleString('en-US')} occurrences, ${percent}% of all errors`;
+}
+//# sourceMappingURL=log-health.js.map

package/dist/commands/log-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-health.js","sourceRoot":"","sources":["../../src/commands/log-health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAmBH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;;GAIG;AACH;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,MAAsB;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgD,CAAC;IAC1E,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtB,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC;QACvB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3B,6CAA6C;IAC7C,EAAE;IACF,wEAAwE;IACxE,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,0EAA0E;IAC1E,2CAA2C;IAC3C,EAAE;IACF,wEAAwE;IACxE,uCAAuC;IACvC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,mBAAmB,IAAI,CAAC,CAAC,KAAK,GAAG,KAAK,IAAI,eAAe,CAAC;SACvF,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,IAAI,EAAE,gBAAyB;QAC/B,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,OAAO;QACP,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,KAAK;KACvB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAErD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,KAAK,GAAG,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,mBAAmB,CAAC;SACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,4EAA4E;IAC5E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC5B,IAAI,KAAK,GAAG,eAAe;QAAE,OAAO,EAAE,CAAC;IAEvC,OAAO;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1E,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAClG,KAAK;YACL,KAAK;SACN;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA8D,EAC9D,SAAiB;IAEjB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9D,IAAI,UAAU,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnD,IAAI,UAAU,GAAG,SAAS,GAAG,iBAAiB;QAAE,OAAO,EAAE,CAAC;IAE1D,OAAO;QACL;YACE,IAAI,EAAE,kBAA2B;YACjC,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9E,OAAO,EAAE,GAAG,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,+BAA+B;YACrH,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,UAAU,GAAG,SAAS;SAC9B;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoD;IACjF,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,oBAAoB,CAAC;SACnD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,YAAqB;QAC3B,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB;QAAE,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,GAAG,CAAC;IACtF,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,GAAG,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,iCAAiC,OAAO,CAAC,UAAW,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjI,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACvC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,yBAAyB,OAAO,sBAAsB,OAAO,CAAC,OAAO,EAAE,CAAC;IACzH,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,OAAO,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,iBAAiB,OAAO,iBAAiB,CAAC;AAClI,CAAC"}