fix(core,cli): improve lint output - JSON flag, info/warning counts, severity display (#134)

## Summary

- Respect `--json` flag on all lint exit paths so agents always get machine-readable output
- Separate `infoCount` from `warningCount` in linter results (was conflated)
- Display `info` vs `warning` severity distinctly in lint output

packages/cli/src/commands/lint.ts

@@ -1,45 +1,92 @@
 import { defineCommand } from "citty";
 import { c } from "../ui/colors.js";
-import { resolveProject } from "../utils/project.js";
-import { lintProject } from "../utils/lintProject.js";
 import { formatLintFindings } from "../utils/lintFormat.js";
+import { lintProject } from "../utils/lintProject.js";
+import { resolveProject } from "../utils/project.js";
 import { withMeta } from "../utils/updateCheck.js";
 
 export default defineCommand({
-  meta: { name: "lint", description: "Validate a composition for common mistakes" },
+  meta: {
+    name: "lint",
+    description: "Validate a composition for common mistakes",
+  },
   args: {
-    dir: { type: "positional", description: "Project directory", required: false },
-    json: { type: "boolean", description: "Output findings as JSON", default: false },
+    dir: {
+      type: "positional",
+      description: "Project directory",
+      required: false,
+    },
+    json: {
+      type: "boolean",
+      description: "Output findings as JSON",
+      default: false,
+    },
+    verbose: {
+      type: "boolean",
+      description: "Show info-level findings (hidden by default)",
+      default: false,
+    },
   },
   async run({ args }) {
-    const project = resolveProject(args.dir);
-    const lintResult = lintProject(project);
+    try {
+      const project = resolveProject(args.dir);
+      const lintResult = lintProject(project);
 
-    if (args.json) {
-      const combined = {
-        ok: lintResult.totalErrors === 0,
-        errorCount: lintResult.totalErrors,
-        warningCount: lintResult.totalWarnings,
-        findings: lintResult.results.flatMap((r) => r.result.findings),
-      };
-      console.log(JSON.stringify(withMeta(combined), null, 2));
-      process.exit(combined.ok ? 0 : 1);
+      if (args.json) {
+        const allFindings = lintResult.results.flatMap((r) => r.result.findings);
+        const combined = {
+          ok: lintResult.totalErrors === 0,
+          errorCount: lintResult.totalErrors,
+          warningCount: lintResult.totalWarnings,
+          infoCount: lintResult.totalInfos,
+          findings: args.verbose ? allFindings : allFindings.filter((f) => f.severity !== "info"),
+          filesScanned: lintResult.results.length,
+        };
+        console.log(JSON.stringify(withMeta(combined), null, 2));
+        process.exit(combined.ok ? 0 : 1);
+      }
+
+      const fileCount = lintResult.results.length;
+      const fileLabel =
+        fileCount === 1 ? (lintResult.results[0]?.file ?? "index.html") : `${fileCount} files`;
+      console.log(`${c.accent("◆")}  Linting ${c.accent(`${project.name}/${fileLabel}`)}`);
+      console.log();
+
+      if (lintResult.totalErrors === 0 && lintResult.totalWarnings === 0) {
+        console.log(`${c.success("◇")}  ${c.success("0 errors, 0 warnings")}`);
+        return;
+      }
+
+      const lines = formatLintFindings(lintResult, {
+        showElementId: true,
+        showSummary: true,
+        verbose: args.verbose,
+      });
+      for (const line of lines) console.log(line);
+
+      process.exit(lintResult.totalErrors > 0 ? 1 : 0);
+    } catch (err: unknown) {
+      const message = err instanceof Error ? err.message : String(err);
+      if (args.json) {
+        console.log(
+          JSON.stringify(
+            withMeta({
+              ok: false,
+              error: message,
+              findings: [],
+              errorCount: 0,
+              warningCount: 0,
+              infoCount: 0,
+              filesScanned: 0,
+            }),
+            null,
+            2,
+          ),
+        );
+        process.exit(1);
+      }
+      console.error(message);
+      process.exit(1);
     }
-
-    const fileCount = lintResult.results.length;
-    const fileLabel =
-      fileCount === 1 ? (lintResult.results[0]?.file ?? "index.html") : `${fileCount} files`;
-    console.log(`${c.accent("◆")}  Linting ${c.accent(project.name + "/" + fileLabel)}`);
-    console.log();
-
-    if (lintResult.totalErrors === 0 && lintResult.totalWarnings === 0) {
-      console.log(`${c.success("◇")}  ${c.success("0 errors, 0 warnings")}`);
-      return;
-    }
-
-    const lines = formatLintFindings(lintResult, { showElementId: true, showSummary: true });
-    for (const line of lines) console.log(line);
-
-    process.exit(lintResult.totalErrors > 0 ? 1 : 0);
   },
 });