@ekanos/cli 0.1.10 → 0.2.1

package/dist/test-report.js

@@ -0,0 +1,255 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+/**
+ * Parses vitest's `--reporter=json` output into the curated-failures
+ * appendix `ekanos test` renders locally, giving a partner the same
+ * per-test intelligence the server-side gate already has.
+ *
+ * This is a DELIBERATE, small duplication of the parsing the host's own
+ * gate uses to grade a submission's test run — not an import. `@ekanos/
+ * checks` is never published and never a dependency of a partner's project
+ * or of this CLI; keep the two in sync by eye if vitest's JSON reporter
+ * shape ever changes.
+ *
+ * Every entry point here is defensive end to end: a missing report file,
+ * malformed JSON, or an unrecognized shape all resolve to `null` rather than
+ * throwing. A partner's toolchain misbehaving must never crash `ekanos
+ * test` — it can only mean the curated appendix is unavailable, with the
+ * command falling back to exactly today's raw-passthrough behavior.
+ */
+/** Cap on assertion-diff lines shown per finding — see `extractDiff`. */
+const MAX_DIFF_LINES = 10;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Whether the project's OWN `test` script names vitest — the one signal
+ * used to decide whether to inject the JSON reporter at all. Deliberately
+ * conservative: a jest project, a custom node runner, or a shell wrapper is
+ * left completely alone, with no reporter flags appended and no report
+ * parsed — `ekanos test` behaves exactly as it did before this feature.
+ */
+export function projectTestScriptUsesVitest(projectDir) {
+    const manifestPath = path.join(projectDir, 'package.json');
+    try {
+        const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+        if (!isRecord(manifest) || !isRecord(manifest.scripts))
+            return false;
+        const script = manifest.scripts.test;
+        return typeof script === 'string' && script.includes('vitest');
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/** A fresh, unique path for the JSON report — one per invocation. The caller owns cleanup. */
+export function newReportPath() {
+    return path.join(os.tmpdir(), `ekanos-test-vitest-${crypto.randomUUID()}.json`);
+}
+/** The extra argv that makes vitest ALSO emit a JSON report alongside its normal terminal output. */
+export function reporterArgs(outputFilePath) {
+    return [
+        '--reporter=default',
+        '--reporter=json',
+        `--outputFile=${outputFilePath}`,
+    ];
+}
+/** The first non-empty line of a vitest failure message/stack — the
+ * assertion or thrown error itself, not the frames beneath it. */
+function firstMeaningfulLine(text) {
+    const line = text
+        .split('\n')
+        .map((entry) => entry.trim())
+        .find((entry) => entry.length > 0);
+    return line !== null && line !== void 0 ? line : 'Test failed with no error message.';
+}
+/**
+ * Vitest's failure stacks always include the absolute test file path at
+ * least once — at the failure site itself — with the frames beneath it
+ * being the runner's own internals. The FIRST occurrence is the line that
+ * matters.
+ */
+function lineForFile(stack, absoluteFile) {
+    const escaped = absoluteFile.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const match = new RegExp(`${escaped}:(\\d+):\\d+`).exec(stack);
+    return match ? Number(match[1]) : undefined;
+}
+/**
+ * Up to `MAX_DIFF_LINES` lines of an expected/received diff block from one
+ * vitest failure message, or `null` when the message doesn't carry one.
+ *
+ * NOTE (found via manual end-to-end verification, not a hypothetical):
+ * vitest's OWN `toBe`/`toEqual`-family matchers never put this in the JSON
+ * reporter's `failureMessages` — the pretty "- Expected / + Received" block
+ * is a terminal-only rendering vitest's default reporter computes live from
+ * the error's `expected`/`actual`, and is never serialized into the report
+ * (checked vitest 3.2.7 and 4.1.10; `message`/`stack` is all that ships).
+ * This function still earns its place: a thrown `AssertionError` whose
+ * `.message` already embeds diff-formatted text — a custom matcher, a
+ * different assertion library layered on top of vitest, a hand-built
+ * `expect.extend` — DOES carry it verbatim in `failureMessages`, and this is
+ * what picks it up. It is intentionally a no-op for the common case rather
+ * than reconstructing a diff ourselves (a real diff needs the actual/expected
+ * values, which the JSON reporter doesn't expose, and computing one would
+ * mean a new dependency, and this package deliberately keeps its runtime
+ * dependency set to picocolors + @clack/prompts only).
+ *
+ * The diff sits between the failure's own title line and the stack frames
+ * (`at ...`) beneath it; within that span, only unified-diff-style `-`/`+`
+ * lines are kept — the jest-diff format such a message would use.
+ */
+function extractDiff(failureMessage) {
+    const lines = failureMessage
+        .split('\n')
+        .map((line) => line.replace(/\r$/, ''));
+    const stackStart = lines.findIndex((line) => /^\s*at\s/.test(line));
+    const body = stackStart === -1 ? lines.slice(1) : lines.slice(1, stackStart);
+    const diffLines = body.filter((line) => /^\s*[-+]/.test(line) &&
+        !line.startsWith('---') &&
+        !line.startsWith('+++'));
+    if (diffLines.length === 0)
+        return null;
+    const capped = diffLines.slice(0, MAX_DIFF_LINES);
+    const overflow = diffLines.length - capped.length;
+    if (overflow > 0) {
+        capped.push(`… and ${overflow} more diff line${overflow === 1 ? '' : 's'}`);
+    }
+    return capped.join('\n');
+}
+/** `path.relative` against the project root, falling back to the raw
+ * absolute path if the two disagree on realpath-vs-given-path (a symlinked
+ * temp dir resolving differently between this process and the child)
+ * rather than emitting a `../../../`-laden mess. */
+function archiveRelative(projectDir, absoluteFile) {
+    const direct = path.relative(projectDir, absoluteFile);
+    if (!direct.startsWith('..'))
+        return direct;
+    try {
+        const realProjectDir = fs.realpathSync(projectDir);
+        const viaRealpath = path.relative(realProjectDir, absoluteFile);
+        if (!viaRealpath.startsWith('..'))
+            return viaRealpath;
+    }
+    catch (_a) {
+        // realpathSync failing (e.g. the directory was already torn down) just
+        // means we fall through to the direct (if imperfect) relative path.
+    }
+    return direct;
+}
+/**
+ * Turns a parsed `--reporter=json` report into one `ParsedFailure` per
+ * failed test, across every test file in the run. Returns `null` — not
+ * `[]` — for anything that isn't recognizably a vitest JSON report at all,
+ * so the caller can tell "a real report with zero structured failures"
+ * apart from "not a report" (the latter falls back to the raw runner
+ * output; the former is a genuinely clean, if unexpected, run).
+ */
+function extractFailures(report) {
+    var _a;
+    if (!isRecord(report) || !Array.isArray(report.testResults))
+        return null;
+    const failures = [];
+    for (const fileResult of report.testResults) {
+        if (!isRecord(fileResult))
+            continue;
+        const file = fileResult.name;
+        const assertionResults = fileResult.assertionResults;
+        if (typeof file !== 'string' || !Array.isArray(assertionResults))
+            continue;
+        for (const assertion of assertionResults) {
+            if (!isRecord(assertion) || assertion.status !== 'failed')
+                continue;
+            const ancestorTitles = Array.isArray(assertion.ancestorTitles)
+                ? assertion.ancestorTitles.filter((entry) => typeof entry === 'string')
+                : [];
+            const title = typeof assertion.title === 'string'
+                ? assertion.title
+                : '(unnamed test)';
+            const failureMessages = Array.isArray(assertion.failureMessages)
+                ? assertion.failureMessages.filter((entry) => typeof entry === 'string')
+                : [];
+            const firstError = (_a = failureMessages[0]) !== null && _a !== void 0 ? _a : '';
+            const failure = {
+                file,
+                suite: ancestorTitles.join(' > '),
+                title,
+                message: firstMeaningfulLine(firstError),
+            };
+            const line = lineForFile(firstError, file);
+            if (line !== undefined)
+                failure.line = line;
+            const detail = extractDiff(firstError);
+            if (detail !== null)
+                failure.detail = detail;
+            failures.push(failure);
+        }
+    }
+    return failures;
+}
+/** `null` unless the report carries vitest's own aggregate pass/fail counts. */
+function extractSummary(report) {
+    if (!isRecord(report) || !Array.isArray(report.testResults))
+        return null;
+    const passed = report.numPassedTests;
+    const failed = report.numFailedTests;
+    if (typeof passed !== 'number' || typeof failed !== 'number')
+        return null;
+    return { passed, failed, files: report.testResults.length };
+}
+/**
+ * Reads and parses `reportPath` end to end. `null` on ANY failure (missing
+ * file — vitest crashed before writing it; malformed JSON; a shape this
+ * function doesn't recognize) so the caller falls back to the raw runner
+ * output instead of the curated appendix, and never to a crash.
+ */
+export function parseTestReport(reportPath, projectDir) {
+    let raw;
+    try {
+        raw = fs.readFileSync(reportPath, 'utf8');
+    }
+    catch (_a) {
+        return null;
+    }
+    let report;
+    try {
+        report = JSON.parse(raw);
+    }
+    catch (_b) {
+        return null;
+    }
+    const failures = extractFailures(report);
+    if (failures === null)
+        return null;
+    const findings = [];
+    const failingFiles = [];
+    const seenFiles = new Set();
+    for (const failure of failures) {
+        const relFile = archiveRelative(projectDir, failure.file);
+        if (!seenFiles.has(relFile)) {
+            seenFiles.add(relFile);
+            failingFiles.push(relFile);
+        }
+        const label = failure.suite
+            ? `${failure.suite} > ${failure.title}`
+            : failure.title;
+        const finding = {
+            // Grouping by test FILE (not by suite/title) is deliberate — the
+            // shared renderer groups by `check`, so this makes the group header
+            // show the file once with every failing test beneath it.
+            check: `tests/${relFile}`,
+            severity: 'error',
+            file: relFile,
+            message: `${label}: ${failure.message}`,
+            hint: 'Fix the failing assertion, then re-run "ekanos test".',
+        };
+        if (failure.line !== undefined)
+            finding.line = failure.line;
+        if (failure.detail !== undefined)
+            finding.detail = failure.detail;
+        findings.push(finding);
+    }
+    return { findings, failingFiles, summary: extractSummary(report) };
+}
+//# sourceMappingURL=test-report.js.map

package/dist/test-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-report.js","sourceRoot":"","sources":["../src/test-report.ts"],"names":[],"mappings":"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","sourcesContent":["import * as crypto from 'node:crypto';\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\n\nimport type { RenderableFinding } from './findings-renderer';\n\n/**\n * Parses vitest's `--reporter=json` output into the curated-failures\n * appendix `ekanos test` renders locally, giving a partner the same\n * per-test intelligence the server-side gate already has.\n *\n * This is a DELIBERATE, small duplication of the parsing the host's own\n * gate uses to grade a submission's test run — not an import. `@ekanos/\n * checks` is never published and never a dependency of a partner's project\n * or of this CLI; keep the two in sync by eye if vitest's JSON reporter\n * shape ever changes.\n *\n * Every entry point here is defensive end to end: a missing report file,\n * malformed JSON, or an unrecognized shape all resolve to `null` rather than\n * throwing. A partner's toolchain misbehaving must never crash `ekanos\n * test` — it can only mean the curated appendix is unavailable, with the\n * command falling back to exactly today's raw-passthrough behavior.\n */\n\n/** Cap on assertion-diff lines shown per finding — see `extractDiff`. */\nconst MAX_DIFF_LINES = 10;\n\nexport interface TestSummary {\n  passed: number;\n  failed: number;\n  files: number;\n}\n\nexport interface ParsedTestReport {\n  /** One finding per failing test, grouped (via `check`) per test FILE. */\n  findings: RenderableFinding[];\n  /** Relative paths of files with at least one failure, first-seen order. */\n  failingFiles: string[];\n  summary: TestSummary | null;\n}\n\ninterface ParsedFailure {\n  /** Absolute path, exactly as vitest reported it. */\n  file: string;\n  suite: string;\n  title: string;\n  message: string;\n  line?: number;\n  detail?: string;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\n/**\n * Whether the project's OWN `test` script names vitest — the one signal\n * used to decide whether to inject the JSON reporter at all. Deliberately\n * conservative: a jest project, a custom node runner, or a shell wrapper is\n * left completely alone, with no reporter flags appended and no report\n * parsed — `ekanos test` behaves exactly as it did before this feature.\n */\nexport function projectTestScriptUsesVitest(projectDir: string): boolean {\n  const manifestPath = path.join(projectDir, 'package.json');\n\n  try {\n    const manifest: unknown = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));\n    if (!isRecord(manifest) || !isRecord(manifest.scripts)) return false;\n\n    const script = manifest.scripts.test;\n    return typeof script === 'string' && script.includes('vitest');\n  } catch {\n    return false;\n  }\n}\n\n/** A fresh, unique path for the JSON report — one per invocation. The caller owns cleanup. */\nexport function newReportPath(): string {\n  return path.join(\n    os.tmpdir(),\n    `ekanos-test-vitest-${crypto.randomUUID()}.json`,\n  );\n}\n\n/** The extra argv that makes vitest ALSO emit a JSON report alongside its normal terminal output. */\nexport function reporterArgs(outputFilePath: string): string[] {\n  return [\n    '--reporter=default',\n    '--reporter=json',\n    `--outputFile=${outputFilePath}`,\n  ];\n}\n\n/** The first non-empty line of a vitest failure message/stack — the\n * assertion or thrown error itself, not the frames beneath it. */\nfunction firstMeaningfulLine(text: string): string {\n  const line = text\n    .split('\\n')\n    .map((entry) => entry.trim())\n    .find((entry) => entry.length > 0);\n  return line ?? 'Test failed with no error message.';\n}\n\n/**\n * Vitest's failure stacks always include the absolute test file path at\n * least once — at the failure site itself — with the frames beneath it\n * being the runner's own internals. The FIRST occurrence is the line that\n * matters.\n */\nfunction lineForFile(stack: string, absoluteFile: string): number | undefined {\n  const escaped = absoluteFile.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  const match = new RegExp(`${escaped}:(\\\\d+):\\\\d+`).exec(stack);\n  return match ? Number(match[1]) : undefined;\n}\n\n/**\n * Up to `MAX_DIFF_LINES` lines of an expected/received diff block from one\n * vitest failure message, or `null` when the message doesn't carry one.\n *\n * NOTE (found via manual end-to-end verification, not a hypothetical):\n * vitest's OWN `toBe`/`toEqual`-family matchers never put this in the JSON\n * reporter's `failureMessages` — the pretty \"- Expected / + Received\" block\n * is a terminal-only rendering vitest's default reporter computes live from\n * the error's `expected`/`actual`, and is never serialized into the report\n * (checked vitest 3.2.7 and 4.1.10; `message`/`stack` is all that ships).\n * This function still earns its place: a thrown `AssertionError` whose\n * `.message` already embeds diff-formatted text — a custom matcher, a\n * different assertion library layered on top of vitest, a hand-built\n * `expect.extend` — DOES carry it verbatim in `failureMessages`, and this is\n * what picks it up. It is intentionally a no-op for the common case rather\n * than reconstructing a diff ourselves (a real diff needs the actual/expected\n * values, which the JSON reporter doesn't expose, and computing one would\n * mean a new dependency, and this package deliberately keeps its runtime\n * dependency set to picocolors + @clack/prompts only).\n *\n * The diff sits between the failure's own title line and the stack frames\n * (`at ...`) beneath it; within that span, only unified-diff-style `-`/`+`\n * lines are kept — the jest-diff format such a message would use.\n */\nfunction extractDiff(failureMessage: string): string | null {\n  const lines = failureMessage\n    .split('\\n')\n    .map((line) => line.replace(/\\r$/, ''));\n  const stackStart = lines.findIndex((line) => /^\\s*at\\s/.test(line));\n  const body = stackStart === -1 ? lines.slice(1) : lines.slice(1, stackStart);\n\n  const diffLines = body.filter(\n    (line) =>\n      /^\\s*[-+]/.test(line) &&\n      !line.startsWith('---') &&\n      !line.startsWith('+++'),\n  );\n  if (diffLines.length === 0) return null;\n\n  const capped = diffLines.slice(0, MAX_DIFF_LINES);\n  const overflow = diffLines.length - capped.length;\n  if (overflow > 0) {\n    capped.push(`… and ${overflow} more diff line${overflow === 1 ? '' : 's'}`);\n  }\n  return capped.join('\\n');\n}\n\n/** `path.relative` against the project root, falling back to the raw\n * absolute path if the two disagree on realpath-vs-given-path (a symlinked\n * temp dir resolving differently between this process and the child)\n * rather than emitting a `../../../`-laden mess. */\nfunction archiveRelative(projectDir: string, absoluteFile: string): string {\n  const direct = path.relative(projectDir, absoluteFile);\n  if (!direct.startsWith('..')) return direct;\n  try {\n    const realProjectDir = fs.realpathSync(projectDir);\n    const viaRealpath = path.relative(realProjectDir, absoluteFile);\n    if (!viaRealpath.startsWith('..')) return viaRealpath;\n  } catch {\n    // realpathSync failing (e.g. the directory was already torn down) just\n    // means we fall through to the direct (if imperfect) relative path.\n  }\n  return direct;\n}\n\n/**\n * Turns a parsed `--reporter=json` report into one `ParsedFailure` per\n * failed test, across every test file in the run. Returns `null` — not\n * `[]` — for anything that isn't recognizably a vitest JSON report at all,\n * so the caller can tell \"a real report with zero structured failures\"\n * apart from \"not a report\" (the latter falls back to the raw runner\n * output; the former is a genuinely clean, if unexpected, run).\n */\nfunction extractFailures(report: unknown): ParsedFailure[] | null {\n  if (!isRecord(report) || !Array.isArray(report.testResults)) return null;\n\n  const failures: ParsedFailure[] = [];\n  for (const fileResult of report.testResults as unknown[]) {\n    if (!isRecord(fileResult)) continue;\n    const file = fileResult.name;\n    const assertionResults = fileResult.assertionResults;\n    if (typeof file !== 'string' || !Array.isArray(assertionResults)) continue;\n\n    for (const assertion of assertionResults as unknown[]) {\n      if (!isRecord(assertion) || assertion.status !== 'failed') continue;\n\n      const ancestorTitles = Array.isArray(assertion.ancestorTitles)\n        ? assertion.ancestorTitles.filter(\n            (entry): entry is string => typeof entry === 'string',\n          )\n        : [];\n      const title =\n        typeof assertion.title === 'string'\n          ? assertion.title\n          : '(unnamed test)';\n      const failureMessages = Array.isArray(assertion.failureMessages)\n        ? assertion.failureMessages.filter(\n            (entry): entry is string => typeof entry === 'string',\n          )\n        : [];\n      const firstError = failureMessages[0] ?? '';\n\n      const failure: ParsedFailure = {\n        file,\n        suite: ancestorTitles.join(' > '),\n        title,\n        message: firstMeaningfulLine(firstError),\n      };\n      const line = lineForFile(firstError, file);\n      if (line !== undefined) failure.line = line;\n      const detail = extractDiff(firstError);\n      if (detail !== null) failure.detail = detail;\n\n      failures.push(failure);\n    }\n  }\n  return failures;\n}\n\n/** `null` unless the report carries vitest's own aggregate pass/fail counts. */\nfunction extractSummary(report: unknown): TestSummary | null {\n  if (!isRecord(report) || !Array.isArray(report.testResults)) return null;\n\n  const passed = report.numPassedTests;\n  const failed = report.numFailedTests;\n  if (typeof passed !== 'number' || typeof failed !== 'number') return null;\n\n  return { passed, failed, files: report.testResults.length };\n}\n\n/**\n * Reads and parses `reportPath` end to end. `null` on ANY failure (missing\n * file — vitest crashed before writing it; malformed JSON; a shape this\n * function doesn't recognize) so the caller falls back to the raw runner\n * output instead of the curated appendix, and never to a crash.\n */\nexport function parseTestReport(\n  reportPath: string,\n  projectDir: string,\n): ParsedTestReport | null {\n  let raw: string;\n  try {\n    raw = fs.readFileSync(reportPath, 'utf8');\n  } catch {\n    return null;\n  }\n\n  let report: unknown;\n  try {\n    report = JSON.parse(raw);\n  } catch {\n    return null;\n  }\n\n  const failures = extractFailures(report);\n  if (failures === null) return null;\n\n  const findings: RenderableFinding[] = [];\n  const failingFiles: string[] = [];\n  const seenFiles = new Set<string>();\n\n  for (const failure of failures) {\n    const relFile = archiveRelative(projectDir, failure.file);\n    if (!seenFiles.has(relFile)) {\n      seenFiles.add(relFile);\n      failingFiles.push(relFile);\n    }\n\n    const label = failure.suite\n      ? `${failure.suite} > ${failure.title}`\n      : failure.title;\n    const finding: RenderableFinding = {\n      // Grouping by test FILE (not by suite/title) is deliberate — the\n      // shared renderer groups by `check`, so this makes the group header\n      // show the file once with every failing test beneath it.\n      check: `tests/${relFile}`,\n      severity: 'error',\n      file: relFile,\n      message: `${label}: ${failure.message}`,\n      hint: 'Fix the failing assertion, then re-run \"ekanos test\".',\n    };\n    if (failure.line !== undefined) finding.line = failure.line;\n    if (failure.detail !== undefined) finding.detail = failure.detail;\n    findings.push(finding);\n  }\n\n  return { findings, failingFiles, summary: extractSummary(report) };\n}\n"]}

package/dist/ui.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The CLI's sole style layer. Every color, glyph, and human-output component
+ * lives here — nothing else in this package may `import 'picocolors'` or
+ * write a raw ANSI escape (the gradient banner in `banner.ts` is the one
+ * documented exception: it paints a true-color gradient picocolors cannot
+ * express, but even it asks THIS module's `colorsEnabled` for the on/off
+ * decision, so there is exactly one gate).
+ *
+ * Everything here renders plain strings. Printing is still `CliContext`'s
+ * job (`ctx.log`) — this module never touches a stream directly, so the
+ * stdout-purity invariant in `context.ts` cannot be bypassed by a stray
+ * color call.
+ */
+/** What `colorsEnabled` needs to know to decide — never the real stream. */
+export interface ColorProbe {
+    /** Whether the destination (stderr, always — see `context.ts`) is a TTY. */
+    isTTY: boolean;
+    env: Readonly<Record<string, string | undefined>>;
+}
+/**
+ * The one color-on/off decision for the whole CLI. True only when the
+ * stream is a real terminal AND `NO_COLOR` is unset AND `TERM` is not
+ * `"dumb"` — EXCEPT `FORCE_COLOR`, which overrides everything else on when
+ * set to anything other than `"0"` (matching the de facto convention: Node,
+ * chalk, and picocolors itself all treat a defined-and-nonzero `FORCE_COLOR`
+ * as "yes, even if you don't think you can").
+ */
+export declare function colorsEnabled(probe: ColorProbe): boolean;
+export interface Glyphs {
+    ok: string;
+    err: string;
+    warn: string;
+    info: string;
+}
+/** One row of `ui.keyValue`. */
+export type KeyValueRow = readonly [key: string, value: string];
+export interface CodeframeOptions {
+    /** Not rendered directly — callers already print `file:line` above/around this. Kept for future use and self-documentation at call sites. */
+    file?: string;
+    /** 1-indexed line to highlight. */
+    line: number;
+    /** The full source text of `file`. */
+    source: string;
+    /** Lines of context above/below the target line. Defaults to 2. */
+    contextLines?: number;
+}
+export type BadgeKind = 'dim' | 'accent' | 'warn' | 'err';
+export interface Ui {
+    readonly colors: boolean;
+    readonly glyphs: Glyphs;
+    err(text: string): string;
+    warn(text: string): string;
+    ok(text: string): string;
+    accent(text: string): string;
+    dim(text: string): string;
+    bold(text: string): string;
+    /** A dim, uppercased section header. */
+    section(title: string): string;
+    /** Aligned `key  value` rows, 2-space gutter, keys dimmed. */
+    keyValue(rows: readonly KeyValueRow[]): string;
+    /** A header-having, left/right-aligned table with no box-drawing. */
+    table(headers: readonly string[], rows: readonly (readonly (string | number)[])[]): string;
+    /** A `→ ` prefixed, accent-colored hint line. */
+    hint(text: string): string;
+    /**
+     * THE closing line of any failure path: a blank line, then a dim
+     * `→ <why>: ` (or bare `→ `) followed by the bold remediation command.
+     */
+    nextAction(cmd: string, why?: string): string;
+    /** A Prisma/Vite-style source snippet around one line. */
+    codeframe(opts: CodeframeOptions): string;
+    /** A bracketed, dim-by-default tag: `[gate · 2h ago]`. */
+    badge(text: string, kind?: BadgeKind): string;
+}
+export declare function createUi(probe: ColorProbe): Ui;

package/dist/ui.js

@@ -0,0 +1,132 @@
+import pc from 'picocolors';
+/**
+ * The one color-on/off decision for the whole CLI. True only when the
+ * stream is a real terminal AND `NO_COLOR` is unset AND `TERM` is not
+ * `"dumb"` — EXCEPT `FORCE_COLOR`, which overrides everything else on when
+ * set to anything other than `"0"` (matching the de facto convention: Node,
+ * chalk, and picocolors itself all treat a defined-and-nonzero `FORCE_COLOR`
+ * as "yes, even if you don't think you can").
+ */
+export function colorsEnabled(probe) {
+    const { env } = probe;
+    if (env.FORCE_COLOR !== undefined && env.FORCE_COLOR !== '0')
+        return true;
+    if (env.NO_COLOR !== undefined)
+        return false;
+    if (env.TERM === 'dumb')
+        return false;
+    return probe.isTTY;
+}
+/**
+ * Whether the destination can render the box-drawing/Unicode glyphs this
+ * module prefers. Deliberately simple: a "dumb" terminal never can, and a
+ * locale that names a non-UTF-8 charset can't be trusted to either. Anything
+ * else — including an unset locale, which is the common case for CI/agent
+ * environments — is assumed capable rather than guessed at further.
+ */
+function unicodeSupported(env) {
+    var _a, _b, _c;
+    if (env.TERM === 'dumb')
+        return false;
+    const locale = (_c = (_b = (_a = env.LANG) !== null && _a !== void 0 ? _a : env.LC_ALL) !== null && _b !== void 0 ? _b : env.LC_CTYPE) !== null && _c !== void 0 ? _c : '';
+    if (locale && !/utf-?8/i.test(locale))
+        return false;
+    return true;
+}
+const UNICODE_GLYPHS = { ok: '✓', err: '✖', warn: '▲', info: '●' };
+const ASCII_GLYPHS = { ok: 'ok', err: 'x', warn: '!', info: '*' };
+/** Right-pad (left-align) a cell to `width`, ignoring color codes in length math is the CALLER's job — pad before coloring, never after. */
+function padCell(text, width, align) {
+    return align === 'right' ? text.padStart(width) : text.padEnd(width);
+}
+export function createUi(probe) {
+    const colors = colorsEnabled(probe);
+    const c = pc.createColors(colors);
+    const glyphs = unicodeSupported(probe.env) ? UNICODE_GLYPHS : ASCII_GLYPHS;
+    const err = (text) => c.red(text);
+    const warn = (text) => c.yellow(text);
+    const ok = (text) => c.green(text);
+    const accent = (text) => c.cyan(text);
+    const dim = (text) => c.dim(text);
+    const bold = (text) => c.bold(text);
+    return {
+        colors,
+        glyphs,
+        err,
+        warn,
+        ok,
+        accent,
+        dim,
+        bold,
+        section(title) {
+            return dim(title.toUpperCase());
+        },
+        keyValue(rows) {
+            const keyWidth = Math.max(0, ...rows.map(([key]) => key.length));
+            return rows
+                .map(([key, value]) => `${dim(key.padEnd(keyWidth))}  ${value}`)
+                .join('\n');
+        },
+        table(headers, rows) {
+            const columnCount = headers.length;
+            const isNumeric = (value) => typeof value === 'number' ||
+                (value.trim() !== '' && !Number.isNaN(Number(value)));
+            const aligns = Array.from({ length: columnCount }, (_, col) => rows.length > 0 && rows.every((row) => { var _a; return isNumeric((_a = row[col]) !== null && _a !== void 0 ? _a : ''); })
+                ? 'right'
+                : 'left');
+            const widths = Array.from({ length: columnCount }, (_, col) => {
+                var _a, _b;
+                return Math.max((_b = (_a = headers[col]) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0, ...rows.map((row) => { var _a; return String((_a = row[col]) !== null && _a !== void 0 ? _a : '').length; }));
+            });
+            const headerLine = headers
+                .map((header, col) => {
+                var _a, _b;
+                return dim(padCell(header.toUpperCase(), (_a = widths[col]) !== null && _a !== void 0 ? _a : 0, (_b = aligns[col]) !== null && _b !== void 0 ? _b : 'left'));
+            })
+                .join('  ');
+            const bodyLines = rows.map((row) => row
+                .map((cell, col) => { var _a, _b; return padCell(String(cell), (_a = widths[col]) !== null && _a !== void 0 ? _a : 0, (_b = aligns[col]) !== null && _b !== void 0 ? _b : 'left'); })
+                .join('  '));
+            return [headerLine, ...bodyLines].join('\n');
+        },
+        hint(text) {
+            return accent(`→ ${text}`);
+        },
+        nextAction(cmd, why) {
+            const prefix = why ? `→ ${why}: ` : '→ ';
+            return `\n${dim(prefix)}${bold(cmd)}`;
+        },
+        codeframe(opts) {
+            var _a, _b;
+            const contextLines = (_a = opts.contextLines) !== null && _a !== void 0 ? _a : 2;
+            const lines = opts.source.split('\n');
+            const start = Math.max(1, opts.line - contextLines);
+            const end = Math.min(lines.length, opts.line + contextLines);
+            const gutterWidth = String(end).length;
+            const rows = [];
+            for (let n = start; n <= end; n += 1) {
+                const isTarget = n === opts.line;
+                const text = (_b = lines[n - 1]) !== null && _b !== void 0 ? _b : '';
+                const marker = isTarget ? '>' : ' ';
+                const lineNo = String(n).padStart(gutterWidth);
+                const rendered = isTarget ? bold(text) : text;
+                rows.push(`${isTarget ? accent(marker) : marker} ${dim(lineNo)} ${dim('│')} ${rendered}`);
+            }
+            return rows.join('\n');
+        },
+        badge(text, kind = 'dim') {
+            const wrapped = `[${text}]`;
+            switch (kind) {
+                case 'err':
+                    return err(wrapped);
+                case 'warn':
+                    return warn(wrapped);
+                case 'accent':
+                    return accent(wrapped);
+                default:
+                    return dim(wrapped);
+            }
+        },
+    };
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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","sourcesContent":["import pc from 'picocolors';\n\n/**\n * The CLI's sole style layer. Every color, glyph, and human-output component\n * lives here — nothing else in this package may `import 'picocolors'` or\n * write a raw ANSI escape (the gradient banner in `banner.ts` is the one\n * documented exception: it paints a true-color gradient picocolors cannot\n * express, but even it asks THIS module's `colorsEnabled` for the on/off\n * decision, so there is exactly one gate).\n *\n * Everything here renders plain strings. Printing is still `CliContext`'s\n * job (`ctx.log`) — this module never touches a stream directly, so the\n * stdout-purity invariant in `context.ts` cannot be bypassed by a stray\n * color call.\n */\n\n/** What `colorsEnabled` needs to know to decide — never the real stream. */\nexport interface ColorProbe {\n  /** Whether the destination (stderr, always — see `context.ts`) is a TTY. */\n  isTTY: boolean;\n  env: Readonly<Record<string, string | undefined>>;\n}\n\n/**\n * The one color-on/off decision for the whole CLI. True only when the\n * stream is a real terminal AND `NO_COLOR` is unset AND `TERM` is not\n * `\"dumb\"` — EXCEPT `FORCE_COLOR`, which overrides everything else on when\n * set to anything other than `\"0\"` (matching the de facto convention: Node,\n * chalk, and picocolors itself all treat a defined-and-nonzero `FORCE_COLOR`\n * as \"yes, even if you don't think you can\").\n */\nexport function colorsEnabled(probe: ColorProbe): boolean {\n  const { env } = probe;\n\n  if (env.FORCE_COLOR !== undefined && env.FORCE_COLOR !== '0') return true;\n  if (env.NO_COLOR !== undefined) return false;\n  if (env.TERM === 'dumb') return false;\n\n  return probe.isTTY;\n}\n\n/**\n * Whether the destination can render the box-drawing/Unicode glyphs this\n * module prefers. Deliberately simple: a \"dumb\" terminal never can, and a\n * locale that names a non-UTF-8 charset can't be trusted to either. Anything\n * else — including an unset locale, which is the common case for CI/agent\n * environments — is assumed capable rather than guessed at further.\n */\nfunction unicodeSupported(\n  env: Readonly<Record<string, string | undefined>>,\n): boolean {\n  if (env.TERM === 'dumb') return false;\n\n  const locale = env.LANG ?? env.LC_ALL ?? env.LC_CTYPE ?? '';\n  if (locale && !/utf-?8/i.test(locale)) return false;\n\n  return true;\n}\n\nexport interface Glyphs {\n  ok: string;\n  err: string;\n  warn: string;\n  info: string;\n}\n\nconst UNICODE_GLYPHS: Glyphs = { ok: '✓', err: '✖', warn: '▲', info: '●' };\nconst ASCII_GLYPHS: Glyphs = { ok: 'ok', err: 'x', warn: '!', info: '*' };\n\n/** One row of `ui.keyValue`. */\nexport type KeyValueRow = readonly [key: string, value: string];\n\nexport interface CodeframeOptions {\n  /** Not rendered directly — callers already print `file:line` above/around this. Kept for future use and self-documentation at call sites. */\n  file?: string;\n  /** 1-indexed line to highlight. */\n  line: number;\n  /** The full source text of `file`. */\n  source: string;\n  /** Lines of context above/below the target line. Defaults to 2. */\n  contextLines?: number;\n}\n\nexport type BadgeKind = 'dim' | 'accent' | 'warn' | 'err';\n\nexport interface Ui {\n  readonly colors: boolean;\n  readonly glyphs: Glyphs;\n\n  err(text: string): string;\n  warn(text: string): string;\n  ok(text: string): string;\n  accent(text: string): string;\n  dim(text: string): string;\n  bold(text: string): string;\n\n  /** A dim, uppercased section header. */\n  section(title: string): string;\n  /** Aligned `key  value` rows, 2-space gutter, keys dimmed. */\n  keyValue(rows: readonly KeyValueRow[]): string;\n  /** A header-having, left/right-aligned table with no box-drawing. */\n  table(\n    headers: readonly string[],\n    rows: readonly (readonly (string | number)[])[],\n  ): string;\n  /** A `→ ` prefixed, accent-colored hint line. */\n  hint(text: string): string;\n  /**\n   * THE closing line of any failure path: a blank line, then a dim\n   * `→ <why>: ` (or bare `→ `) followed by the bold remediation command.\n   */\n  nextAction(cmd: string, why?: string): string;\n  /** A Prisma/Vite-style source snippet around one line. */\n  codeframe(opts: CodeframeOptions): string;\n  /** A bracketed, dim-by-default tag: `[gate · 2h ago]`. */\n  badge(text: string, kind?: BadgeKind): string;\n}\n\n/** Right-pad (left-align) a cell to `width`, ignoring color codes in length math is the CALLER's job — pad before coloring, never after. */\nfunction padCell(text: string, width: number, align: 'left' | 'right'): string {\n  return align === 'right' ? text.padStart(width) : text.padEnd(width);\n}\n\nexport function createUi(probe: ColorProbe): Ui {\n  const colors = colorsEnabled(probe);\n  const c = pc.createColors(colors);\n  const glyphs = unicodeSupported(probe.env) ? UNICODE_GLYPHS : ASCII_GLYPHS;\n\n  const err = (text: string) => c.red(text);\n  const warn = (text: string) => c.yellow(text);\n  const ok = (text: string) => c.green(text);\n  const accent = (text: string) => c.cyan(text);\n  const dim = (text: string) => c.dim(text);\n  const bold = (text: string) => c.bold(text);\n\n  return {\n    colors,\n    glyphs,\n    err,\n    warn,\n    ok,\n    accent,\n    dim,\n    bold,\n\n    section(title: string): string {\n      return dim(title.toUpperCase());\n    },\n\n    keyValue(rows: readonly KeyValueRow[]): string {\n      const keyWidth = Math.max(0, ...rows.map(([key]) => key.length));\n\n      return rows\n        .map(([key, value]) => `${dim(key.padEnd(keyWidth))}  ${value}`)\n        .join('\\n');\n    },\n\n    table(\n      headers: readonly string[],\n      rows: readonly (readonly (string | number)[])[],\n    ): string {\n      const columnCount = headers.length;\n      const isNumeric = (value: string | number) =>\n        typeof value === 'number' ||\n        (value.trim() !== '' && !Number.isNaN(Number(value)));\n\n      const aligns: Array<'left' | 'right'> = Array.from(\n        { length: columnCount },\n        (_, col) =>\n          rows.length > 0 && rows.every((row) => isNumeric(row[col] ?? ''))\n            ? 'right'\n            : 'left',\n      );\n\n      const widths = Array.from({ length: columnCount }, (_, col) =>\n        Math.max(\n          headers[col]?.length ?? 0,\n          ...rows.map((row) => String(row[col] ?? '').length),\n        ),\n      );\n\n      const headerLine = headers\n        .map((header, col) =>\n          dim(\n            padCell(\n              header.toUpperCase(),\n              widths[col] ?? 0,\n              aligns[col] ?? 'left',\n            ),\n          ),\n        )\n        .join('  ');\n\n      const bodyLines = rows.map((row) =>\n        row\n          .map((cell, col) =>\n            padCell(String(cell), widths[col] ?? 0, aligns[col] ?? 'left'),\n          )\n          .join('  '),\n      );\n\n      return [headerLine, ...bodyLines].join('\\n');\n    },\n\n    hint(text: string): string {\n      return accent(`→ ${text}`);\n    },\n\n    nextAction(cmd: string, why?: string): string {\n      const prefix = why ? `→ ${why}: ` : '→ ';\n      return `\\n${dim(prefix)}${bold(cmd)}`;\n    },\n\n    codeframe(opts: CodeframeOptions): string {\n      const contextLines = opts.contextLines ?? 2;\n      const lines = opts.source.split('\\n');\n      const start = Math.max(1, opts.line - contextLines);\n      const end = Math.min(lines.length, opts.line + contextLines);\n      const gutterWidth = String(end).length;\n\n      const rows: string[] = [];\n      for (let n = start; n <= end; n += 1) {\n        const isTarget = n === opts.line;\n        const text = lines[n - 1] ?? '';\n        const marker = isTarget ? '>' : ' ';\n        const lineNo = String(n).padStart(gutterWidth);\n        const rendered = isTarget ? bold(text) : text;\n\n        rows.push(\n          `${isTarget ? accent(marker) : marker} ${dim(lineNo)} ${dim('│')} ${rendered}`,\n        );\n      }\n\n      return rows.join('\\n');\n    },\n\n    badge(text: string, kind: BadgeKind = 'dim'): string {\n      const wrapped = `[${text}]`;\n\n      switch (kind) {\n        case 'err':\n          return err(wrapped);\n        case 'warn':\n          return warn(wrapped);\n        case 'accent':\n          return accent(wrapped);\n        default:\n          return dim(wrapped);\n      }\n    },\n  };\n}\n"]}

package/dist/validate-findings.d.ts

@@ -20,3 +20,25 @@ import type { LoadedProject } from './project.js';
  * it, not tests that fake their own reachability.
  */
 export declare function collectAllFindings(loaded: LoadedProject): Promise<Finding[]>;
+/**
+ * `package.json`'s `version` field and the `version` `defineIntegration()`
+ * declares are two more independent sources of truth for the same fact —
+ * this project shipped weather@0.1.1 with a package.json bump, but the
+ * declaration itself still said 0.1.0. Generated seeds embed the
+ * DECLARATION's version in their header, so a stale declaration produces a
+ * seed that looks stale even though the package itself moved on.
+ *
+ * WARN, not error, unlike slug agreement: a mismatched version is a quality
+ * signal a partner should fix, not a broken cross-reference that breaks
+ * something else at runtime, so it must not block `publish`. And a project
+ * with no package.json, or a package.json with no `version` field, has
+ * nothing to compare the declaration against — skip rather than warn on
+ * absence.
+ */
+export declare function collectVersionAgreementFindings(integration: {
+    slug: string;
+    entry: string;
+    entryPath: string;
+}, definition: {
+    version?: unknown;
+}, projectDir: string): Finding[];

package/dist/validate-findings.js

@@ -1,8 +1,10 @@
 import { collectCollisionFindings, collectDefinitionFindings, } from '@ekanos/integration-schema';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
 import { preconditionError } from './errors.js';
 import { collectIconFindings } from './icon-findings.js';
 import { loadDefinition } from './load-definition.js';
-import { collectDocsFindings, collectProjectFindings } from './project-checks.js';
+import { collectDocsFindings, collectHostCompilerRulesFindings, collectProjectFindings, } from './project-checks.js';
 /**
  * The full findings pass shared by `validate` (which reports them) and
  * `publish` (which refuses to submit on any error-severity finding). One
@@ -32,6 +34,7 @@ export async function collectAllFindings(loaded) {
                 file: integration.entryPath,
             }));
             findings.push(...collectSlugAgreementFindings(integration, result.definition));
+            findings.push(...collectVersionAgreementFindings(integration, result.definition, loaded.projectDir));
             definitions.push(result.definition);
             continue;
         }
@@ -58,6 +61,7 @@ export async function collectAllFindings(loaded) {
     findings.push(...collectProjectFindings(loaded.projectDir));
     findings.push(...collectDocsFindings(loaded.project, loaded.projectDir));
     findings.push(...collectIconFindings(loaded.projectDir));
+    findings.push(...collectHostCompilerRulesFindings(loaded.projectDir));
     return findings;
 }
 /**
@@ -90,4 +94,56 @@ function collectSlugAgreementFindings(integration, definition) {
         },
     ];
 }
+/**
+ * `package.json`'s `version` field and the `version` `defineIntegration()`
+ * declares are two more independent sources of truth for the same fact —
+ * this project shipped weather@0.1.1 with a package.json bump, but the
+ * declaration itself still said 0.1.0. Generated seeds embed the
+ * DECLARATION's version in their header, so a stale declaration produces a
+ * seed that looks stale even though the package itself moved on.
+ *
+ * WARN, not error, unlike slug agreement: a mismatched version is a quality
+ * signal a partner should fix, not a broken cross-reference that breaks
+ * something else at runtime, so it must not block `publish`. And a project
+ * with no package.json, or a package.json with no `version` field, has
+ * nothing to compare the declaration against — skip rather than warn on
+ * absence.
+ */
+export function collectVersionAgreementFindings(integration, definition, projectDir) {
+    const declared = definition.version;
+    if (typeof declared !== 'string')
+        return [];
+    const manifestPath = path.join(projectDir, 'package.json');
+    if (!fs.existsSync(manifestPath))
+        return [];
+    let manifest;
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    }
+    catch (_a) {
+        // Malformed package.json is npm's problem to report, not a validate
+        // finding — nothing here can compare against an unparseable manifest.
+        return [];
+    }
+    const packageVersion = typeof manifest === 'object' && manifest !== null
+        ? manifest.version
+        : undefined;
+    if (typeof packageVersion !== 'string' || packageVersion === declared) {
+        return [];
+    }
+    return [
+        {
+            check: 'project.version-agreement',
+            severity: 'warn',
+            file: integration.entryPath,
+            message: `package.json declares version "${packageVersion}", but the ` +
+                `defineIntegration() declaration for "${integration.slug}" still ` +
+                `says "${declared}". Generated seed headers embed the ` +
+                "declaration's version, so a stale declaration ships stale-looking " +
+                'metadata even though the package itself moved on.',
+            hint: `Update the "version" passed to defineIntegration() in ` +
+                `${integration.entryPath} to match package.json's "${packageVersion}".`,
+        },
+    ];
+}
 //# sourceMappingURL=validate-findings.js.map