@ekanos/cli 0.1.10 → 0.2.0

package/dist/did-you-mean.js

@@ -0,0 +1,192 @@
+import { IntegrationDefinitionSchema } from '@ekanos/integration-schema';
+import { isRootPath, splitDotPath } from './source-locator.js';
+/**
+ * "Did you mean?" for a zod `unrecognized_keys` finding — the typo case
+ * (`entrypiont` instead of `entrypoint`). Two pieces: a hand-rolled
+ * Levenshtein distance (no new dependency — this package deliberately keeps
+ * its runtime dependency set to picocolors + @clack/prompts only) and a
+ * structural walk of the REAL `IntegrationDefinitionSchema` to find the
+ * sibling keys a given path actually accepts.
+ */
+/**
+ * Classic single-rolling-row DP, O(a.length * b.length). Fine at CLI scale —
+ * this compares key names, never paragraphs.
+ */
+export function levenshteinDistance(a, b) {
+    var _a, _b, _c, _d;
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let previousRow = Array.from({ length: b.length + 1 }, (_, j) => j);
+    for (let i = 1; i <= a.length; i += 1) {
+        const currentRow = [i];
+        for (let j = 1; j <= b.length; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            currentRow.push(Math.min(((_a = previousRow[j]) !== null && _a !== void 0 ? _a : Infinity) + 1, // deletion
+            ((_b = currentRow[j - 1]) !== null && _b !== void 0 ? _b : Infinity) + 1, // insertion
+            ((_c = previousRow[j - 1]) !== null && _c !== void 0 ? _c : Infinity) + cost));
+        }
+        previousRow = currentRow;
+    }
+    return (_d = previousRow[b.length]) !== null && _d !== void 0 ? _d : Math.max(a.length, b.length);
+}
+const MAX_SUGGESTION_DISTANCE = 2;
+/**
+ * The single closest candidate within `MAX_SUGGESTION_DISTANCE`, or `null`
+ * when nothing is close enough. Never a wrong-confident guess for a key that
+ * isn't really a typo of anything this schema accepts.
+ */
+export function suggestKey(key, candidates) {
+    let best = null;
+    let bestDistance = MAX_SUGGESTION_DISTANCE + 1;
+    for (const candidate of candidates) {
+        const distance = levenshteinDistance(key, candidate);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = candidate;
+        }
+    }
+    return bestDistance <= MAX_SUGGESTION_DISTANCE ? best : null;
+}
+/**
+ * Parses the literal, comma-separated, single-quoted key list zod's
+ * `unrecognized_keys` issue produces (`Unrecognized key(s) in object: 'a',
+ * 'b'`) — this exact wording is what `collectDefinitionFindings` bakes into
+ * `Finding.message` verbatim (see its doc comment), so this is a text match
+ * against a stable, committed third-party format, not a guess at prose.
+ * `null` for a message tail that isn't this issue.
+ */
+export function extractUnrecognizedKeys(rest) {
+    const match = /^Unrecognized key\(s\) in object: (.+)$/.exec(rest);
+    if (!match)
+        return null;
+    const list = match[1];
+    if (!list)
+        return null;
+    const keys = [...list.matchAll(/'([^']*)'/g)].map((m) => { var _a; return (_a = m[1]) !== null && _a !== void 0 ? _a : ''; });
+    return keys.length > 0 ? keys : null;
+}
+function asZodLike(value) {
+    if (typeof value === 'object' &&
+        value !== null &&
+        '_def' in value &&
+        typeof value._def === 'object' &&
+        value._def !== null) {
+        return value;
+    }
+    return null;
+}
+/** Peels `ZodEffects` (`.superRefine`/`.refine`), `ZodOptional`, `ZodDefault`, and `ZodNullable` down to the schema they wrap. */
+function unwrap(schema) {
+    let current = schema;
+    for (;;) {
+        if (current._def.typeName === 'ZodEffects' && current._def.schema) {
+            current = current._def.schema;
+            continue;
+        }
+        if ((current._def.typeName === 'ZodOptional' ||
+            current._def.typeName === 'ZodDefault' ||
+            current._def.typeName === 'ZodNullable') &&
+            current._def.innerType) {
+            current = current._def.innerType;
+            continue;
+        }
+        return current;
+    }
+}
+/**
+ * Walks `root` through `segments` (`.shape` for an object key, `.element`
+ * for a numeric array index, unwrapping wrappers at every step), returning
+ * the `ZodObject` found at the end — or `null` the moment it hits anything
+ * it can't structurally walk (a union, a record, a segment the shape
+ * doesn't have). The caller falls back to a curated list in that case.
+ */
+function resolveObjectAt(root, segments) {
+    let current = unwrap(root);
+    for (const segment of segments) {
+        if (current._def.typeName === 'ZodObject' && current.shape) {
+            const next = current.shape[segment];
+            if (!next)
+                return null;
+            current = unwrap(next);
+            continue;
+        }
+        if (current._def.typeName === 'ZodArray' &&
+            current.element &&
+            /^\d+$/.test(segment)) {
+            current = unwrap(current.element);
+            continue;
+        }
+        return null;
+    }
+    return current._def.typeName === 'ZodObject' ? current : null;
+}
+/**
+ * Fallback for the two spots a partner is most likely to typo a key — the
+ * top-level declaration and a widget entry — used only when the structural
+ * walk above can't resolve the parent path. Keep in sync with
+ * `IntegrationDefinitionSchema`'s top-level shape and `widgetSchema` in
+ * `@ekanos/integration-schema`'s `integration-definition.ts`; the structural
+ * walk is tried first and should cover both of these in practice; this is
+ * the safety net for whenever it doesn't.
+ */
+const CURATED_TOP_LEVEL_KEYS = [
+    'slug',
+    'name',
+    'description',
+    'version',
+    'capabilities',
+    'permissions',
+    'components',
+    'workspaceTargets',
+    'tools',
+    'storage',
+    'egress',
+    'webhooks',
+    'schedules',
+    'oauth',
+    'onActivate',
+    'proposes',
+];
+const CURATED_WIDGET_KEYS = [
+    'id',
+    'name',
+    'component',
+    'widgetState',
+    'gridSize',
+    'gridPosition',
+    'layouts',
+    'category',
+    'isCollapsible',
+    'isPinnable',
+    'aiFooterEnabled',
+];
+function curatedKeysAt(parentDotPath) {
+    if (isRootPath(parentDotPath))
+        return CURATED_TOP_LEVEL_KEYS;
+    if (/^components\.widgets\.\d+$/.test(parentDotPath)) {
+        return CURATED_WIDGET_KEYS;
+    }
+    return null;
+}
+/**
+ * The keys `IntegrationDefinitionSchema` actually accepts at
+ * `parentDotPath` — the zod issue's own `path` for an `unrecognized_keys`
+ * finding, so this always names the OBJECT the extra key was found on, never
+ * the extra key itself. Structural introspection first, the curated list
+ * second, `[]` (no suggestion offered — never a wrong-confident one) last.
+ */
+export function acceptedKeysAt(parentDotPath) {
+    var _a;
+    const root = asZodLike(IntegrationDefinitionSchema);
+    const resolved = root
+        ? resolveObjectAt(root, splitDotPath(parentDotPath))
+        : null;
+    if (resolved === null || resolved === void 0 ? void 0 : resolved.shape)
+        return Object.keys(resolved.shape);
+    return (_a = curatedKeysAt(parentDotPath)) !== null && _a !== void 0 ? _a : [];
+}
+//# sourceMappingURL=did-you-mean.js.map

package/dist/did-you-mean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-you-mean.js","sourceRoot":"","sources":["../src/did-you-mean.ts"],"names":[],"mappings":"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","sourcesContent":["import { IntegrationDefinitionSchema } from '@ekanos/integration-schema';\n\nimport { isRootPath, splitDotPath } from './source-locator';\n\n/**\n * \"Did you mean?\" for a zod `unrecognized_keys` finding — the typo case\n * (`entrypiont` instead of `entrypoint`). Two pieces: a hand-rolled\n * Levenshtein distance (no new dependency — this package deliberately keeps\n * its runtime dependency set to picocolors + @clack/prompts only) and a\n * structural walk of the REAL `IntegrationDefinitionSchema` to find the\n * sibling keys a given path actually accepts.\n */\n\n/**\n * Classic single-rolling-row DP, O(a.length * b.length). Fine at CLI scale —\n * this compares key names, never paragraphs.\n */\nexport function levenshteinDistance(a: string, b: string): number {\n  if (a === b) return 0;\n  if (a.length === 0) return b.length;\n  if (b.length === 0) return a.length;\n\n  let previousRow = Array.from({ length: b.length + 1 }, (_, j) => j);\n\n  for (let i = 1; i <= a.length; i += 1) {\n    const currentRow = [i];\n    for (let j = 1; j <= b.length; j += 1) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1;\n      currentRow.push(\n        Math.min(\n          (previousRow[j] ?? Infinity) + 1, // deletion\n          (currentRow[j - 1] ?? Infinity) + 1, // insertion\n          (previousRow[j - 1] ?? Infinity) + cost, // substitution\n        ),\n      );\n    }\n    previousRow = currentRow;\n  }\n\n  return previousRow[b.length] ?? Math.max(a.length, b.length);\n}\n\nconst MAX_SUGGESTION_DISTANCE = 2;\n\n/**\n * The single closest candidate within `MAX_SUGGESTION_DISTANCE`, or `null`\n * when nothing is close enough. Never a wrong-confident guess for a key that\n * isn't really a typo of anything this schema accepts.\n */\nexport function suggestKey(\n  key: string,\n  candidates: readonly string[],\n): string | null {\n  let best: string | null = null;\n  let bestDistance = MAX_SUGGESTION_DISTANCE + 1;\n\n  for (const candidate of candidates) {\n    const distance = levenshteinDistance(key, candidate);\n    if (distance < bestDistance) {\n      bestDistance = distance;\n      best = candidate;\n    }\n  }\n\n  return bestDistance <= MAX_SUGGESTION_DISTANCE ? best : null;\n}\n\n/**\n * Parses the literal, comma-separated, single-quoted key list zod's\n * `unrecognized_keys` issue produces (`Unrecognized key(s) in object: 'a',\n * 'b'`) — this exact wording is what `collectDefinitionFindings` bakes into\n * `Finding.message` verbatim (see its doc comment), so this is a text match\n * against a stable, committed third-party format, not a guess at prose.\n * `null` for a message tail that isn't this issue.\n */\nexport function extractUnrecognizedKeys(rest: string): string[] | null {\n  const match = /^Unrecognized key\\(s\\) in object: (.+)$/.exec(rest);\n  if (!match) return null;\n\n  const list = match[1];\n  if (!list) return null;\n\n  const keys = [...list.matchAll(/'([^']*)'/g)].map((m) => m[1] ?? '');\n  return keys.length > 0 ? keys : null;\n}\n\n/**\n * A structural, minimal view of a zod schema instance's internals — `_def`,\n * `.shape` (a `ZodObject`), `.element` (a `ZodArray`) — used ONLY to walk\n * `IntegrationDefinitionSchema` for candidate keys. Deliberately NOT `import\n * { ... } from 'zod'`: this package has no direct `zod` dependency (only\n * `@ekanos/integration-schema` does), the constraint on this feature is no\n * new runtime dependency, and these three properties are the only ones this\n * module reads — stable across zod's v3 line.\n */\ninterface ZodLike {\n  _def: {\n    typeName: string;\n    schema?: ZodLike;\n    innerType?: ZodLike;\n  };\n  shape?: Record<string, ZodLike>;\n  element?: ZodLike;\n}\n\nfunction asZodLike(value: unknown): ZodLike | null {\n  if (\n    typeof value === 'object' &&\n    value !== null &&\n    '_def' in value &&\n    typeof (value as { _def: unknown })._def === 'object' &&\n    (value as { _def: unknown })._def !== null\n  ) {\n    return value as ZodLike;\n  }\n  return null;\n}\n\n/** Peels `ZodEffects` (`.superRefine`/`.refine`), `ZodOptional`, `ZodDefault`, and `ZodNullable` down to the schema they wrap. */\nfunction unwrap(schema: ZodLike): ZodLike {\n  let current = schema;\n\n  for (;;) {\n    if (current._def.typeName === 'ZodEffects' && current._def.schema) {\n      current = current._def.schema;\n      continue;\n    }\n    if (\n      (current._def.typeName === 'ZodOptional' ||\n        current._def.typeName === 'ZodDefault' ||\n        current._def.typeName === 'ZodNullable') &&\n      current._def.innerType\n    ) {\n      current = current._def.innerType;\n      continue;\n    }\n    return current;\n  }\n}\n\n/**\n * Walks `root` through `segments` (`.shape` for an object key, `.element`\n * for a numeric array index, unwrapping wrappers at every step), returning\n * the `ZodObject` found at the end — or `null` the moment it hits anything\n * it can't structurally walk (a union, a record, a segment the shape\n * doesn't have). The caller falls back to a curated list in that case.\n */\nfunction resolveObjectAt(\n  root: ZodLike,\n  segments: readonly string[],\n): ZodLike | null {\n  let current = unwrap(root);\n\n  for (const segment of segments) {\n    if (current._def.typeName === 'ZodObject' && current.shape) {\n      const next = current.shape[segment];\n      if (!next) return null;\n      current = unwrap(next);\n      continue;\n    }\n    if (\n      current._def.typeName === 'ZodArray' &&\n      current.element &&\n      /^\\d+$/.test(segment)\n    ) {\n      current = unwrap(current.element);\n      continue;\n    }\n    return null;\n  }\n\n  return current._def.typeName === 'ZodObject' ? current : null;\n}\n\n/**\n * Fallback for the two spots a partner is most likely to typo a key — the\n * top-level declaration and a widget entry — used only when the structural\n * walk above can't resolve the parent path. Keep in sync with\n * `IntegrationDefinitionSchema`'s top-level shape and `widgetSchema` in\n * `@ekanos/integration-schema`'s `integration-definition.ts`; the structural\n * walk is tried first and should cover both of these in practice; this is\n * the safety net for whenever it doesn't.\n */\nconst CURATED_TOP_LEVEL_KEYS = [\n  'slug',\n  'name',\n  'description',\n  'version',\n  'capabilities',\n  'permissions',\n  'components',\n  'workspaceTargets',\n  'tools',\n  'storage',\n  'egress',\n  'webhooks',\n  'schedules',\n  'oauth',\n  'onActivate',\n  'proposes',\n];\n\nconst CURATED_WIDGET_KEYS = [\n  'id',\n  'name',\n  'component',\n  'widgetState',\n  'gridSize',\n  'gridPosition',\n  'layouts',\n  'category',\n  'isCollapsible',\n  'isPinnable',\n  'aiFooterEnabled',\n];\n\nfunction curatedKeysAt(parentDotPath: string): readonly string[] | null {\n  if (isRootPath(parentDotPath)) return CURATED_TOP_LEVEL_KEYS;\n  if (/^components\\.widgets\\.\\d+$/.test(parentDotPath)) {\n    return CURATED_WIDGET_KEYS;\n  }\n  return null;\n}\n\n/**\n * The keys `IntegrationDefinitionSchema` actually accepts at\n * `parentDotPath` — the zod issue's own `path` for an `unrecognized_keys`\n * finding, so this always names the OBJECT the extra key was found on, never\n * the extra key itself. Structural introspection first, the curated list\n * second, `[]` (no suggestion offered — never a wrong-confident one) last.\n */\nexport function acceptedKeysAt(parentDotPath: string): readonly string[] {\n  const root = asZodLike(IntegrationDefinitionSchema);\n  const resolved = root\n    ? resolveObjectAt(root, splitDotPath(parentDotPath))\n    : null;\n\n  if (resolved?.shape) return Object.keys(resolved.shape);\n\n  return curatedKeysAt(parentDotPath) ?? [];\n}\n"]}

package/dist/findings-renderer.d.ts

@@ -0,0 +1,59 @@
+import type { CliContext } from './context.js';
+import type { Ui } from './ui.js';
+/**
+ * The shared findings block: one rendering used by `validate` (a failed run),
+ * `publish` (a gate refusal), and `status --findings`, so a partner sees the
+ * exact same shape wherever a finding shows up. This is the ONLY findings
+ * renderer in the package — nothing else may hand-format a `Finding`/
+ * `GateFinding` array for a human.
+ *
+ * Deliberately structural rather than importing `Finding` or `GateFinding`
+ * directly as the parameter type: both already satisfy this shape (their
+ * extra/missing fields are all optional), and a structural type keeps this
+ * module from caring which of the two ships that array.
+ */
+export interface RenderableFinding {
+    check: string;
+    severity: 'error' | 'warn' | 'info';
+    file?: string;
+    line?: number;
+    message: string;
+    hint: string;
+    /** `'gate' | 'ci' | 'host' | 'revocation'` on the wire — see `GateFinding`. */
+    origin?: string;
+    createdAt?: string;
+    resolvedAt?: string | null;
+    /**
+     * Optional multi-line supplement rendered directly under the finding's
+     * message — currently only `ekanos test`'s curated failures appendix sets
+     * this (an assertion diff). Additive: neither `Finding` nor `GateFinding`
+     * carries it, so every pre-existing caller renders byte-identically to
+     * before. Lines are shown as-is except a leading `-`/`+` (unified-diff
+     * style), which is colored red/green respectively.
+     */
+    detail?: string;
+}
+export interface RenderFindingsOptions {
+    /** Findings shown per group before an overflow line takes over. Default 10. */
+    maxPerGroup?: number;
+    /** Base for resolving a finding's `file` before reading it for a codeframe. Default `process.cwd()`. */
+    cwd?: string;
+    /** Injectable for `relativeTime` snapshot tests. Default `new Date()`. */
+    now?: Date;
+}
+/**
+ * `relativeTime('2026-09-01T10:00:00Z')` → `"2h ago"`. Deliberately coarse
+ * (rounds to the nearest unit, one unit at a time) — this is a findings-list
+ * badge, not an audit-log timestamp, and a partner scanning for "is this
+ * recent" doesn't need sub-minute precision.
+ */
+export declare function relativeTime(iso: string, now?: Date): string;
+/**
+ * Pure formatter — no I/O beyond an optional codeframe file read, no
+ * printing. Kept separate from `renderFindings` so tests can assert exact
+ * strings against a `Ui` built with a known color/glyph decision, without
+ * constructing a full `CliContext`.
+ */
+export declare function formatFindings(ui: Ui, findings: readonly RenderableFinding[], options?: RenderFindingsOptions): string;
+/** Render the shared findings block to `ctx`'s human-mode output (stderr). A no-op for an empty findings array. */
+export declare function renderFindings(ctx: CliContext, findings: readonly RenderableFinding[], options?: RenderFindingsOptions): void;

package/dist/findings-renderer.js

@@ -0,0 +1,271 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ENCLOSING_NOTE } from './source-locator.js';
+// Compile-time proof the two real shapes this renders are both assignable.
+const _typeCheck = (f) => f;
+void _typeCheck;
+const DEFAULT_MAX_PER_GROUP = 10;
+const SEVERITY_RANK = {
+    error: 0,
+    warn: 1,
+    info: 2,
+};
+/**
+ * `relativeTime('2026-09-01T10:00:00Z')` → `"2h ago"`. Deliberately coarse
+ * (rounds to the nearest unit, one unit at a time) — this is a findings-list
+ * badge, not an audit-log timestamp, and a partner scanning for "is this
+ * recent" doesn't need sub-minute precision.
+ */
+export function relativeTime(iso, now = new Date()) {
+    const then = new Date(iso).getTime();
+    if (Number.isNaN(then))
+        return iso;
+    const diffSec = Math.max(0, Math.round((now.getTime() - then) / 1000));
+    if (diffSec < 5)
+        return 'just now';
+    if (diffSec < 60)
+        return `${diffSec}s ago`;
+    const diffMin = Math.round(diffSec / 60);
+    if (diffMin < 60)
+        return `${diffMin}m ago`;
+    const diffHour = Math.round(diffMin / 60);
+    if (diffHour < 24)
+        return `${diffHour}h ago`;
+    const diffDay = Math.round(diffHour / 24);
+    if (diffDay < 30)
+        return `${diffDay}d ago`;
+    const diffMonth = Math.round(diffDay / 30);
+    if (diffMonth < 12)
+        return `${diffMonth}mo ago`;
+    const diffYear = Math.round(diffMonth / 12);
+    return `${diffYear}y ago`;
+}
+/**
+ * A message beginning with a zod-style dot-path (`components.widgets[2].id: …`,
+ * the shape `collectDefinitionFindings` produces — see the `Finding` doc
+ * comment in `@ekanos/integration-schema`). Captures the path and the rest
+ * separately so the renderer can dim the path instead of shouting the whole
+ * sentence in one uniform color.
+ */
+const DOT_PATH_MESSAGE = /^([A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+|\[\d+\])*): ([^]+)$/;
+/**
+ * Render one finding's message: a leading dot-path identical to the
+ * finding's own `file` is pure duplication (the path would just repeat what
+ * `file:line` already told the reader) and is dropped; any other dot-path
+ * prefix is kept but dimmed, so the sentence itself reads at full contrast.
+ * A message with no dot-path prefix passes through untouched.
+ *
+ * A trailing `source-locator.ts` `ENCLOSING_NOTE` (plain text in the data —
+ * see that module's doc comment on why it never carries color itself) is
+ * peeled off before the dot-path handling above and dimmed on its own, then
+ * reattached — so it stays visually secondary to the message itself in
+ * exactly the case where the frame it accompanies points at the enclosing
+ * object rather than the missing key.
+ */
+function renderMessage(ui, finding) {
+    const enclosingSuffix = ` ${ENCLOSING_NOTE}`;
+    const hasEnclosingNote = finding.message.endsWith(enclosingSuffix);
+    const message = hasEnclosingNote
+        ? finding.message.slice(0, -enclosingSuffix.length)
+        : finding.message;
+    const match = DOT_PATH_MESSAGE.exec(message);
+    const rendered = (() => {
+        if (!match)
+            return message;
+        const [, dotPath, rest] = match;
+        if (dotPath === finding.file)
+            return rest !== null && rest !== void 0 ? rest : message;
+        return `${ui.dim(dotPath !== null && dotPath !== void 0 ? dotPath : '')}: ${rest !== null && rest !== void 0 ? rest : ''}`;
+    })();
+    return hasEnclosingNote ? `${rendered} ${ui.dim(ENCLOSING_NOTE)}` : rendered;
+}
+function severityColor(ui, severity) {
+    if (severity === 'error')
+        return ui.err;
+    if (severity === 'warn')
+        return ui.warn;
+    return ui.dim;
+}
+function severityGlyph(ui, severity) {
+    if (severity === 'warn')
+        return ui.glyphs.warn;
+    if (severity === 'info')
+        return ui.glyphs.info;
+    return ui.glyphs.err;
+}
+function ellipsis(ui) {
+    return ui.glyphs.ok === '✓' ? '…' : '...';
+}
+/** Attempts a codeframe for `finding`; `null` when it isn't renderable (no line, or the file can't be read locally). */
+function tryCodeframe(ui, finding, cwd) {
+    if (finding.file === undefined || finding.line === undefined)
+        return null;
+    const resolved = path.resolve(cwd, finding.file);
+    if (!fs.existsSync(resolved))
+        return null;
+    try {
+        const source = fs.readFileSync(resolved, 'utf8');
+        return ui.codeframe({ file: finding.file, line: finding.line, source });
+    }
+    catch (_a) {
+        // Best-effort decoration — an unreadable file (permissions, a race with
+        // a concurrent edit) just means no codeframe, never a renderer failure.
+        return null;
+    }
+}
+function originBadgeKind(_origin) {
+    return 'dim';
+}
+/**
+ * Renders a finding's `detail` block, one line per source line: a
+ * unified-diff `-` prefix is red, a `+` prefix is green, everything else
+ * (context lines, "Expected"/"Received" headers, an overflow note) is dim.
+ * `---`/`+++` file-header lines never appear here — `test-report.ts` never
+ * emits them — but are guarded against anyway since this is the one place
+ * that would mis-color them.
+ */
+function renderDetailLines(ui, detail) {
+    return detail.split('\n').map((line) => {
+        if (line.startsWith('-') && !line.startsWith('---'))
+            return ui.err(line);
+        if (line.startsWith('+') && !line.startsWith('+++'))
+            return ui.ok(line);
+        return ui.dim(line);
+    });
+}
+function buildGroupHeader(ui, group, opts) {
+    var _a, _b;
+    const errorCount = group.findings.filter((f) => f.severity === 'error').length;
+    const warnCount = group.findings.filter((f) => f.severity === 'warn').length;
+    const infoCount = group.findings.filter((f) => f.severity === 'info').length;
+    const worst = (_b = (_a = group.findings[0]) === null || _a === void 0 ? void 0 : _a.severity) !== null && _b !== void 0 ? _b : 'info';
+    const color = severityColor(ui, worst);
+    const glyph = severityGlyph(ui, worst);
+    const parts = [];
+    if (errorCount > 0)
+        parts.push(`${errorCount} error${errorCount === 1 ? '' : 's'}`);
+    if (warnCount > 0)
+        parts.push(`${warnCount} warning${warnCount === 1 ? '' : 's'}`);
+    if (infoCount > 0)
+        parts.push(`${infoCount} info`);
+    // The representative for the group's origin badge is the first (i.e.
+    // worst-severity, then earliest) finding that carries one — a check
+    // almost always shares one origin, and this avoids a badge per line.
+    const withOrigin = group.findings.find((f) => f.origin !== undefined);
+    const badge = (withOrigin === null || withOrigin === void 0 ? void 0 : withOrigin.origin) === undefined
+        ? ''
+        : ` ${ui.badge(withOrigin.createdAt
+            ? `${withOrigin.origin} · ${relativeTime(withOrigin.createdAt, opts.now)}`
+            : withOrigin.origin, originBadgeKind(withOrigin.origin))}`;
+    return `${color(`${glyph} ${group.check}`)} · ${parts.join(', ')}${badge}`;
+}
+function buildGroupBody(ui, group, opts) {
+    const uniqueHints = [...new Set(group.findings.map((f) => f.hint))];
+    const [firstHint] = uniqueHints;
+    const dedupedHint = uniqueHints.length === 1 && firstHint !== undefined ? firstHint : null;
+    const visible = group.findings.slice(0, opts.maxPerGroup);
+    const overflow = group.findings.length - visible.length;
+    const lines = [];
+    let codeframeRendered = false;
+    for (const finding of visible) {
+        const location = finding.file !== undefined
+            ? ui.accent(finding.line !== undefined
+                ? `${finding.file}:${finding.line}`
+                : finding.file)
+            : null;
+        const message = renderMessage(ui, finding);
+        lines.push(`  ${ui.dim('│')}${location ? ` ${location}` : ''} ${message}`);
+        if (finding.detail !== undefined) {
+            lines.push(...renderDetailLines(ui, finding.detail).map((line) => `      ${line}`));
+        }
+        if (dedupedHint === null) {
+            lines.push(`      ${ui.hint(finding.hint)}`);
+        }
+        if (!codeframeRendered) {
+            const frame = tryCodeframe(ui, finding, opts.cwd);
+            if (frame !== null) {
+                codeframeRendered = true;
+                lines.push(frame
+                    .split('\n')
+                    .map((line) => `      ${line}`)
+                    .join('\n'));
+            }
+        }
+    }
+    if (overflow > 0) {
+        lines.push(`  ${ui.dim(`${ellipsis(ui)} and ${overflow} more in this group`)}`);
+    }
+    if (dedupedHint !== null) {
+        lines.push(`  ${ui.hint(dedupedHint)}`);
+    }
+    return lines;
+}
+/**
+ * Pure formatter — no I/O beyond an optional codeframe file read, no
+ * printing. Kept separate from `renderFindings` so tests can assert exact
+ * strings against a `Ui` built with a known color/glyph decision, without
+ * constructing a full `CliContext`.
+ */
+export function formatFindings(ui, findings, options = {}) {
+    var _a, _b, _c;
+    if (findings.length === 0)
+        return '';
+    const maxPerGroup = (_a = options.maxPerGroup) !== null && _a !== void 0 ? _a : DEFAULT_MAX_PER_GROUP;
+    const cwd = (_b = options.cwd) !== null && _b !== void 0 ? _b : process.cwd();
+    const now = (_c = options.now) !== null && _c !== void 0 ? _c : new Date();
+    const groupsByCheck = new Map();
+    findings.forEach((finding, index) => {
+        const existing = groupsByCheck.get(finding.check);
+        if (existing) {
+            existing.findings.push(finding);
+            return;
+        }
+        groupsByCheck.set(finding.check, {
+            check: finding.check,
+            findings: [finding],
+            order: index,
+        });
+    });
+    const groups = [...groupsByCheck.values()];
+    for (const group of groups) {
+        group.findings.sort((a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity]);
+    }
+    groups.sort((a, b) => {
+        var _a, _b, _c, _d;
+        const worstA = SEVERITY_RANK[(_b = (_a = a.findings[0]) === null || _a === void 0 ? void 0 : _a.severity) !== null && _b !== void 0 ? _b : 'info'];
+        const worstB = SEVERITY_RANK[(_d = (_c = b.findings[0]) === null || _c === void 0 ? void 0 : _c.severity) !== null && _d !== void 0 ? _d : 'info'];
+        return worstA - worstB || a.order - b.order;
+    });
+    const blocks = groups.map((group) => {
+        const header = buildGroupHeader(ui, group, { now });
+        const body = buildGroupBody(ui, group, { maxPerGroup, cwd });
+        return [header, ...body].join('\n');
+    });
+    const totalErrors = findings.filter((f) => f.severity === 'error').length;
+    const totalWarnings = findings.filter((f) => f.severity === 'warn').length;
+    const totalInfo = findings.filter((f) => f.severity === 'info').length;
+    const summaryParts = [];
+    if (totalErrors > 0)
+        summaryParts.push(`${totalErrors} error${totalErrors === 1 ? '' : 's'}`);
+    if (totalWarnings > 0)
+        summaryParts.push(`${totalWarnings} warning${totalWarnings === 1 ? '' : 's'}`);
+    if (totalInfo > 0 && totalErrors === 0 && totalWarnings === 0) {
+        summaryParts.push(`${totalInfo} info`);
+    }
+    const summaryColor = totalErrors > 0 ? ui.err : totalWarnings > 0 ? ui.warn : ui.dim;
+    const summaryGlyph = totalErrors > 0
+        ? ui.glyphs.err
+        : totalWarnings > 0
+            ? ui.glyphs.warn
+            : ui.glyphs.info;
+    const checksCount = groups.length;
+    const summary = summaryColor(`${summaryGlyph} ${summaryParts.join(', ')} across ${checksCount} check${checksCount === 1 ? '' : 's'}`);
+    return [...blocks, summary].join('\n\n');
+}
+/** Render the shared findings block to `ctx`'s human-mode output (stderr). A no-op for an empty findings array. */
+export function renderFindings(ctx, findings, options = {}) {
+    const block = formatFindings(ctx.ui, findings, options);
+    if (block !== '')
+        ctx.log(block);
+}
+//# sourceMappingURL=findings-renderer.js.map

package/dist/findings-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-renderer.js","sourceRoot":"","sources":["../src/findings-renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Finding } from '@ekanos/integration-schema';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport type { CliContext } from './context';\nimport type { GateFinding } from './publish-api';\nimport { ENCLOSING_NOTE } from './source-locator';\nimport type { BadgeKind, Ui } from './ui';\n\n/**\n * The shared findings block: one rendering used by `validate` (a failed run),\n * `publish` (a gate refusal), and `status --findings`, so a partner sees the\n * exact same shape wherever a finding shows up. This is the ONLY findings\n * renderer in the package — nothing else may hand-format a `Finding`/\n * `GateFinding` array for a human.\n *\n * Deliberately structural rather than importing `Finding` or `GateFinding`\n * directly as the parameter type: both already satisfy this shape (their\n * extra/missing fields are all optional), and a structural type keeps this\n * module from caring which of the two ships that array.\n */\nexport interface RenderableFinding {\n  check: string;\n  severity: 'error' | 'warn' | 'info';\n  file?: string;\n  line?: number;\n  message: string;\n  hint: string;\n  /** `'gate' | 'ci' | 'host' | 'revocation'` on the wire — see `GateFinding`. */\n  origin?: string;\n  createdAt?: string;\n  resolvedAt?: string | null;\n  /**\n   * Optional multi-line supplement rendered directly under the finding's\n   * message — currently only `ekanos test`'s curated failures appendix sets\n   * this (an assertion diff). Additive: neither `Finding` nor `GateFinding`\n   * carries it, so every pre-existing caller renders byte-identically to\n   * before. Lines are shown as-is except a leading `-`/`+` (unified-diff\n   * style), which is colored red/green respectively.\n   */\n  detail?: string;\n}\n\n// Compile-time proof the two real shapes this renders are both assignable.\nconst _typeCheck: (f: Finding | GateFinding) => RenderableFinding = (f) => f;\nvoid _typeCheck;\n\nexport interface RenderFindingsOptions {\n  /** Findings shown per group before an overflow line takes over. Default 10. */\n  maxPerGroup?: number;\n  /** Base for resolving a finding's `file` before reading it for a codeframe. Default `process.cwd()`. */\n  cwd?: string;\n  /** Injectable for `relativeTime` snapshot tests. Default `new Date()`. */\n  now?: Date;\n}\n\nconst DEFAULT_MAX_PER_GROUP = 10;\n\nconst SEVERITY_RANK: Record<RenderableFinding['severity'], number> = {\n  error: 0,\n  warn: 1,\n  info: 2,\n};\n\ninterface Group {\n  check: string;\n  findings: RenderableFinding[];\n  /** Insertion order, for a stable tie-break when sorting groups. */\n  order: number;\n}\n\n/**\n * `relativeTime('2026-09-01T10:00:00Z')` → `\"2h ago\"`. Deliberately coarse\n * (rounds to the nearest unit, one unit at a time) — this is a findings-list\n * badge, not an audit-log timestamp, and a partner scanning for \"is this\n * recent\" doesn't need sub-minute precision.\n */\nexport function relativeTime(iso: string, now: Date = new Date()): string {\n  const then = new Date(iso).getTime();\n  if (Number.isNaN(then)) return iso;\n\n  const diffSec = Math.max(0, Math.round((now.getTime() - then) / 1000));\n\n  if (diffSec < 5) return 'just now';\n  if (diffSec < 60) return `${diffSec}s ago`;\n\n  const diffMin = Math.round(diffSec / 60);\n  if (diffMin < 60) return `${diffMin}m ago`;\n\n  const diffHour = Math.round(diffMin / 60);\n  if (diffHour < 24) return `${diffHour}h ago`;\n\n  const diffDay = Math.round(diffHour / 24);\n  if (diffDay < 30) return `${diffDay}d ago`;\n\n  const diffMonth = Math.round(diffDay / 30);\n  if (diffMonth < 12) return `${diffMonth}mo ago`;\n\n  const diffYear = Math.round(diffMonth / 12);\n  return `${diffYear}y ago`;\n}\n\n/**\n * A message beginning with a zod-style dot-path (`components.widgets[2].id: …`,\n * the shape `collectDefinitionFindings` produces — see the `Finding` doc\n * comment in `@ekanos/integration-schema`). Captures the path and the rest\n * separately so the renderer can dim the path instead of shouting the whole\n * sentence in one uniform color.\n */\nconst DOT_PATH_MESSAGE =\n  /^([A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+|\\[\\d+\\])*): ([^]+)$/;\n\n/**\n * Render one finding's message: a leading dot-path identical to the\n * finding's own `file` is pure duplication (the path would just repeat what\n * `file:line` already told the reader) and is dropped; any other dot-path\n * prefix is kept but dimmed, so the sentence itself reads at full contrast.\n * A message with no dot-path prefix passes through untouched.\n *\n * A trailing `source-locator.ts` `ENCLOSING_NOTE` (plain text in the data —\n * see that module's doc comment on why it never carries color itself) is\n * peeled off before the dot-path handling above and dimmed on its own, then\n * reattached — so it stays visually secondary to the message itself in\n * exactly the case where the frame it accompanies points at the enclosing\n * object rather than the missing key.\n */\nfunction renderMessage(ui: Ui, finding: RenderableFinding): string {\n  const enclosingSuffix = ` ${ENCLOSING_NOTE}`;\n  const hasEnclosingNote = finding.message.endsWith(enclosingSuffix);\n  const message = hasEnclosingNote\n    ? finding.message.slice(0, -enclosingSuffix.length)\n    : finding.message;\n\n  const match = DOT_PATH_MESSAGE.exec(message);\n  const rendered = (() => {\n    if (!match) return message;\n\n    const [, dotPath, rest] = match;\n    if (dotPath === finding.file) return rest ?? message;\n\n    return `${ui.dim(dotPath ?? '')}: ${rest ?? ''}`;\n  })();\n\n  return hasEnclosingNote ? `${rendered} ${ui.dim(ENCLOSING_NOTE)}` : rendered;\n}\n\nfunction severityColor(\n  ui: Ui,\n  severity: RenderableFinding['severity'],\n): (text: string) => string {\n  if (severity === 'error') return ui.err;\n  if (severity === 'warn') return ui.warn;\n  return ui.dim;\n}\n\nfunction severityGlyph(\n  ui: Ui,\n  severity: RenderableFinding['severity'],\n): string {\n  if (severity === 'warn') return ui.glyphs.warn;\n  if (severity === 'info') return ui.glyphs.info;\n  return ui.glyphs.err;\n}\n\nfunction ellipsis(ui: Ui): string {\n  return ui.glyphs.ok === '✓' ? '…' : '...';\n}\n\n/** Attempts a codeframe for `finding`; `null` when it isn't renderable (no line, or the file can't be read locally). */\nfunction tryCodeframe(\n  ui: Ui,\n  finding: RenderableFinding,\n  cwd: string,\n): string | null {\n  if (finding.file === undefined || finding.line === undefined) return null;\n\n  const resolved = path.resolve(cwd, finding.file);\n  if (!fs.existsSync(resolved)) return null;\n\n  try {\n    const source = fs.readFileSync(resolved, 'utf8');\n    return ui.codeframe({ file: finding.file, line: finding.line, source });\n  } catch {\n    // Best-effort decoration — an unreadable file (permissions, a race with\n    // a concurrent edit) just means no codeframe, never a renderer failure.\n    return null;\n  }\n}\n\nfunction originBadgeKind(_origin: string): BadgeKind {\n  return 'dim';\n}\n\n/**\n * Renders a finding's `detail` block, one line per source line: a\n * unified-diff `-` prefix is red, a `+` prefix is green, everything else\n * (context lines, \"Expected\"/\"Received\" headers, an overflow note) is dim.\n * `---`/`+++` file-header lines never appear here — `test-report.ts` never\n * emits them — but are guarded against anyway since this is the one place\n * that would mis-color them.\n */\nfunction renderDetailLines(ui: Ui, detail: string): string[] {\n  return detail.split('\\n').map((line) => {\n    if (line.startsWith('-') && !line.startsWith('---')) return ui.err(line);\n    if (line.startsWith('+') && !line.startsWith('+++')) return ui.ok(line);\n    return ui.dim(line);\n  });\n}\n\nfunction buildGroupHeader(\n  ui: Ui,\n  group: Group,\n  opts: Required<Pick<RenderFindingsOptions, 'now'>>,\n): string {\n  const errorCount = group.findings.filter(\n    (f) => f.severity === 'error',\n  ).length;\n  const warnCount = group.findings.filter((f) => f.severity === 'warn').length;\n  const infoCount = group.findings.filter((f) => f.severity === 'info').length;\n\n  const worst = group.findings[0]?.severity ?? 'info';\n  const color = severityColor(ui, worst);\n  const glyph = severityGlyph(ui, worst);\n\n  const parts: string[] = [];\n  if (errorCount > 0)\n    parts.push(`${errorCount} error${errorCount === 1 ? '' : 's'}`);\n  if (warnCount > 0)\n    parts.push(`${warnCount} warning${warnCount === 1 ? '' : 's'}`);\n  if (infoCount > 0) parts.push(`${infoCount} info`);\n\n  // The representative for the group's origin badge is the first (i.e.\n  // worst-severity, then earliest) finding that carries one — a check\n  // almost always shares one origin, and this avoids a badge per line.\n  const withOrigin = group.findings.find((f) => f.origin !== undefined);\n  const badge =\n    withOrigin?.origin === undefined\n      ? ''\n      : ` ${ui.badge(\n          withOrigin.createdAt\n            ? `${withOrigin.origin} · ${relativeTime(withOrigin.createdAt, opts.now)}`\n            : withOrigin.origin,\n          originBadgeKind(withOrigin.origin),\n        )}`;\n\n  return `${color(`${glyph} ${group.check}`)} · ${parts.join(', ')}${badge}`;\n}\n\nfunction buildGroupBody(\n  ui: Ui,\n  group: Group,\n  opts: Required<Pick<RenderFindingsOptions, 'maxPerGroup' | 'cwd'>>,\n): string[] {\n  const uniqueHints = [...new Set(group.findings.map((f) => f.hint))];\n  const [firstHint] = uniqueHints;\n  const dedupedHint =\n    uniqueHints.length === 1 && firstHint !== undefined ? firstHint : null;\n\n  const visible = group.findings.slice(0, opts.maxPerGroup);\n  const overflow = group.findings.length - visible.length;\n\n  const lines: string[] = [];\n  let codeframeRendered = false;\n\n  for (const finding of visible) {\n    const location =\n      finding.file !== undefined\n        ? ui.accent(\n            finding.line !== undefined\n              ? `${finding.file}:${finding.line}`\n              : finding.file,\n          )\n        : null;\n    const message = renderMessage(ui, finding);\n\n    lines.push(`  ${ui.dim('│')}${location ? ` ${location}` : ''} ${message}`);\n\n    if (finding.detail !== undefined) {\n      lines.push(\n        ...renderDetailLines(ui, finding.detail).map((line) => `      ${line}`),\n      );\n    }\n\n    if (dedupedHint === null) {\n      lines.push(`      ${ui.hint(finding.hint)}`);\n    }\n\n    if (!codeframeRendered) {\n      const frame = tryCodeframe(ui, finding, opts.cwd);\n      if (frame !== null) {\n        codeframeRendered = true;\n        lines.push(\n          frame\n            .split('\\n')\n            .map((line) => `      ${line}`)\n            .join('\\n'),\n        );\n      }\n    }\n  }\n\n  if (overflow > 0) {\n    lines.push(\n      `  ${ui.dim(`${ellipsis(ui)} and ${overflow} more in this group`)}`,\n    );\n  }\n\n  if (dedupedHint !== null) {\n    lines.push(`  ${ui.hint(dedupedHint)}`);\n  }\n\n  return lines;\n}\n\n/**\n * Pure formatter — no I/O beyond an optional codeframe file read, no\n * printing. Kept separate from `renderFindings` so tests can assert exact\n * strings against a `Ui` built with a known color/glyph decision, without\n * constructing a full `CliContext`.\n */\nexport function formatFindings(\n  ui: Ui,\n  findings: readonly RenderableFinding[],\n  options: RenderFindingsOptions = {},\n): string {\n  if (findings.length === 0) return '';\n\n  const maxPerGroup = options.maxPerGroup ?? DEFAULT_MAX_PER_GROUP;\n  const cwd = options.cwd ?? process.cwd();\n  const now = options.now ?? new Date();\n\n  const groupsByCheck = new Map<string, Group>();\n  findings.forEach((finding, index) => {\n    const existing = groupsByCheck.get(finding.check);\n    if (existing) {\n      existing.findings.push(finding);\n      return;\n    }\n    groupsByCheck.set(finding.check, {\n      check: finding.check,\n      findings: [finding],\n      order: index,\n    });\n  });\n\n  const groups = [...groupsByCheck.values()];\n  for (const group of groups) {\n    group.findings.sort(\n      (a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity],\n    );\n  }\n  groups.sort((a, b) => {\n    const worstA = SEVERITY_RANK[a.findings[0]?.severity ?? 'info'];\n    const worstB = SEVERITY_RANK[b.findings[0]?.severity ?? 'info'];\n    return worstA - worstB || a.order - b.order;\n  });\n\n  const blocks = groups.map((group) => {\n    const header = buildGroupHeader(ui, group, { now });\n    const body = buildGroupBody(ui, group, { maxPerGroup, cwd });\n    return [header, ...body].join('\\n');\n  });\n\n  const totalErrors = findings.filter((f) => f.severity === 'error').length;\n  const totalWarnings = findings.filter((f) => f.severity === 'warn').length;\n  const totalInfo = findings.filter((f) => f.severity === 'info').length;\n\n  const summaryParts: string[] = [];\n  if (totalErrors > 0)\n    summaryParts.push(`${totalErrors} error${totalErrors === 1 ? '' : 's'}`);\n  if (totalWarnings > 0)\n    summaryParts.push(\n      `${totalWarnings} warning${totalWarnings === 1 ? '' : 's'}`,\n    );\n  if (totalInfo > 0 && totalErrors === 0 && totalWarnings === 0) {\n    summaryParts.push(`${totalInfo} info`);\n  }\n\n  const summaryColor =\n    totalErrors > 0 ? ui.err : totalWarnings > 0 ? ui.warn : ui.dim;\n  const summaryGlyph =\n    totalErrors > 0\n      ? ui.glyphs.err\n      : totalWarnings > 0\n        ? ui.glyphs.warn\n        : ui.glyphs.info;\n  const checksCount = groups.length;\n\n  const summary = summaryColor(\n    `${summaryGlyph} ${summaryParts.join(', ')} across ${checksCount} check${\n      checksCount === 1 ? '' : 's'\n    }`,\n  );\n\n  return [...blocks, summary].join('\\n\\n');\n}\n\n/** Render the shared findings block to `ctx`'s human-mode output (stderr). A no-op for an empty findings array. */\nexport function renderFindings(\n  ctx: CliContext,\n  findings: readonly RenderableFinding[],\n  options: RenderFindingsOptions = {},\n): void {\n  const block = formatFindings(ctx.ui, findings, options);\n  if (block !== '') ctx.log(block);\n}\n"]}

package/dist/index.d.ts

@@ -8,10 +8,11 @@ export interface RunOptions {
     env?: Record<string, string | undefined>;
     cwd?: string;
     /**
-     * Test-only overrides for `publish`'s interactive-confirm gate — see
-     * `PublishArgs` in `commands/publish.ts`. Never set these from real CLI
-     * wiring; they exist so a test can exercise the human y/N confirm branch
-     * without a real terminal.
+     * Test-only override for `publish`'s interactive-confirm gate and `init`
+     * / `login`'s clack wizard gate (`canWizard` in `wizard.ts`) — see
+     * `PublishArgs` in `commands/publish.ts`. Never set this from real CLI
+     * wiring; it exists so a test can exercise the human y/N confirm branch or
+     * the wizard flow without a real terminal.
      */
     stdinIsTTY?: boolean;
     confirm?: (question: string) => Promise<boolean>;
@@ -21,6 +22,12 @@ export interface RunOptions {
      * so a test can exercise the poll loop without waiting 30s per iteration.
      */
     sleep?: (ms: number) => Promise<void>;
+    /**
+     * Test-only override for `status`'s AGE column ("now") — see `StatusArgs`
+     * in `commands/status.ts`. Never set this from real CLI wiring; it exists
+     * so a test can assert an exact `relativeTime` string deterministically.
+     */
+    now?: Date;
 }
 /**
  * The single entry point. Resolves the agent-native envelope once, dispatches