@fragments-sdk/cli 0.11.1 → 0.13.0

package/src/commands/govern.ts

@@ -0,0 +1,122 @@
+/**
+ * fragments govern — AI UI governance checks
+ *
+ * Subcommands:
+ *   check  — Validate a UISpec against governance policies
+ *   init   — Generate a govern.config.ts template
+ *   report — Summarize audit log
+ */
+
+import pc from 'picocolors';
+import { BRAND } from '../core/index.js';
+
+// ---------------------------------------------------------------------------
+// Options
+// ---------------------------------------------------------------------------
+
+export interface GovernCheckOptions {
+  /** Path to UISpec JSON file, or '-' for stdin */
+  input?: string;
+  /** Path to govern.config.ts */
+  config?: string;
+  /** Output format */
+  format?: 'json' | 'summary' | 'sarif';
+  /** Suppress non-error output */
+  quiet?: boolean;
+}
+
+export interface GovernInitOptions {
+  /** Output path (defaults to ./govern.config.ts) */
+  output?: string;
+}
+
+// ---------------------------------------------------------------------------
+// check
+// ---------------------------------------------------------------------------
+
+export async function governCheck(options: GovernCheckOptions = {}): Promise<{ exitCode: number }> {
+  console.log(pc.cyan(`\n${BRAND.name} Governance Check\n`));
+
+  const { cliCheck, formatVerdict } = await import('@fragments-sdk/govern');
+
+  const result = await cliCheck(options);
+  const output = formatVerdict(result.verdict, options.format ?? 'summary');
+
+  if (!options.quiet) {
+    console.log(output);
+    console.log();
+  }
+
+  if (result.verdict.passed) {
+    console.log(pc.green(`✓ Governance check passed (score: ${result.verdict.score}/100)\n`));
+  } else {
+    console.log(pc.red(`✗ Governance check failed (score: ${result.verdict.score}/100)\n`));
+  }
+
+  return { exitCode: result.exitCode };
+}
+
+// ---------------------------------------------------------------------------
+// init
+// ---------------------------------------------------------------------------
+
+export async function governInit(options: GovernInitOptions = {}): Promise<void> {
+  const { writeFile } = await import('node:fs/promises');
+  const { resolve } = await import('node:path');
+  const { generateConfigTemplate } = await import('@fragments-sdk/govern');
+
+  const outputPath = resolve(options.output ?? 'govern.config.ts');
+  const template = generateConfigTemplate();
+
+  await writeFile(outputPath, template, 'utf-8');
+  console.log(pc.green(`✓ Created ${outputPath}\n`));
+}
+
+// ---------------------------------------------------------------------------
+// report
+// ---------------------------------------------------------------------------
+
+export async function governReport(): Promise<void> {
+  const { readFile } = await import('node:fs/promises');
+
+  console.log(pc.cyan(`\n${BRAND.name} Governance Report\n`));
+
+  let raw: string;
+  try {
+    raw = await readFile('.govern-audit.jsonl', 'utf-8');
+  } catch {
+    console.log(pc.yellow('No audit log found (.govern-audit.jsonl)\n'));
+    console.log(pc.dim('Run `fragments govern check` to generate audit data.\n'));
+    return;
+  }
+
+  const lines = raw.trim().split('\n').filter(Boolean);
+  if (lines.length === 0) {
+    console.log(pc.yellow('Audit log is empty.\n'));
+    return;
+  }
+
+  let totalScore = 0;
+  let passCount = 0;
+  let totalViolations = 0;
+
+  for (const line of lines) {
+    try {
+      const entry = JSON.parse(line);
+      totalScore += entry.score ?? 0;
+      if (entry.passed) passCount++;
+      totalViolations += entry.violationCount ?? 0;
+    } catch {
+      // Skip malformed lines
+    }
+  }
+
+  const avgScore = Math.round(totalScore / lines.length);
+  const passRate = Math.round((passCount / lines.length) * 100);
+
+  console.log(`  Checks:     ${lines.length}`);
+  console.log(`  Pass rate:  ${passRate}%`);
+  console.log(`  Avg score:  ${avgScore}/100`);
+  console.log(`  Violations: ${totalViolations} total`);
+  console.log();
+}