bastard-framework 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to BASTARD will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.1.0] - 2026-04-03
+
+### Added
+- `--json` flag on `slop`, `score`, `audit` commands for machine-readable output
+- `--fail-below <grade>` flag on `slop`, `score`, `audit` for CI enforcement (exit 1 if below threshold)
+- `bastard badge [path]` command — generates shields.io badge with Slop + Design scores
+- GitHub Action (`action/action.yml`) — run BASTARD audit in CI, post PR comments, fail checks
+- Example project: `examples/todo-app/` — complete 8-round reference with all pipeline artifacts
+
 ## [1.0.0] - 2026-04-02
 
 ### Added

package/README.md

@@ -40,6 +40,10 @@ bastard status
 bastard run
 ```
 
+## Example Project
+
+See [`examples/todo-app/`](examples/todo-app/) — a minimal todo app that went through all 8 rounds. The code is < 200 LOC. The documents are the star.
+
 ## The Pipeline
 
 ```

package/dist/cli.js

@@ -2791,7 +2791,7 @@ function displayAudit(slop, design) {
 
 // src/cli.ts
 var program = new Command();
-program.name("bastard").description("Build Any SaaS Through Agent Roles & Discipline").version("1.0.0");
+program.name("bastard").description("Build Any SaaS Through Agent Roles & Discipline").version("1.1.0");
 program.command("init [name]").description("Initialize a new BASTARD project").option("--install-parents", "Also install all parent frameworks").option("--with-hooks", "Also install Claude Code guard hooks").action(async (name, opts) => {
   const projectRoot = process.cwd();
   if (stateExists(projectRoot)) {
@@ -3117,26 +3117,81 @@ function resolveAuditTarget(pathArg) {
   const srcDir = resolve3(cwd, "src");
   return existsSync10(srcDir) ? srcDir : cwd;
 }
-program.command("slop [path]").description("Scan for AI slop patterns \u2014 works on ANY project (default: src/ or cwd)").action((pathArg) => {
+var GRADE_ORDER = { "A": 1, "B": 2, "C": 3, "D": 4, "F": 5, "-": 0 };
+function isScoreBelow(score, threshold) {
+  return (GRADE_ORDER[score] ?? 5) > (GRADE_ORDER[threshold] ?? 5);
+}
+program.command("slop [path]").description("Scan for AI slop patterns \u2014 works on ANY project (default: src/ or cwd)").option("--json", "Output as JSON").option("--fail-below <grade>", "Exit 1 if score is below this grade (A-F)").action((pathArg, opts) => {
   const targetDir = resolveAuditTarget(pathArg);
   const report = runSlopScan(targetDir);
-  displaySlopReport(report);
+  if (opts.json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    displaySlopReport(report);
+  }
+  if (opts.failBelow && isScoreBelow(report.score, opts.failBelow)) {
+    process.exit(1);
+  }
 });
-program.command("score [path]").description("Check design token compliance \u2014 works on ANY project").action((pathArg) => {
+program.command("score [path]").description("Check design token compliance \u2014 works on ANY project").option("--json", "Output as JSON").option("--fail-below <grade>", "Exit 1 if score is below this grade (A-F)").action((pathArg, opts) => {
   const targetDir = resolveAuditTarget(pathArg);
   const report = runDesignScore(targetDir, targetDir);
-  displayDesignScore(report);
+  if (opts.json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    displayDesignScore(report);
+  }
+  if (opts.failBelow && isScoreBelow(report.score, opts.failBelow)) {
+    process.exit(1);
+  }
 });
-program.command("audit [path]").description("AI Slop + Design Score audit \u2014 works on ANY project, no init needed").action((pathArg) => {
+program.command("audit [path]").description("AI Slop + Design Score audit \u2014 works on ANY project, no init needed").option("--json", "Output as JSON").option("--fail-below <grade>", "Exit 1 if slop score is below this grade (A-F)").action((pathArg, opts) => {
   const targetDir = resolveAuditTarget(pathArg);
   const slop = runSlopScan(targetDir);
   const design = runDesignScore(targetDir, targetDir);
-  displayAudit(slop, design);
-  if (slop.matches.length > 0) {
-    displaySlopReport(slop);
+  if (opts.json) {
+    console.log(JSON.stringify({ slop, design }, null, 2));
+  } else {
+    displayAudit(slop, design);
+    if (slop.matches.length > 0) {
+      displaySlopReport(slop);
+    }
+    if (design.violations.length > 0) {
+      displayDesignScore(design);
+    }
   }
-  if (design.violations.length > 0) {
-    displayDesignScore(design);
+  if (opts.failBelow && isScoreBelow(slop.score, opts.failBelow)) {
+    process.exit(1);
   }
 });
+program.command("badge [path]").description('Generate a "Shipped with BASTARD" badge for your README').action((pathArg) => {
+  const targetDir = resolveAuditTarget(pathArg);
+  const slop = runSlopScan(targetDir);
+  const design = runDesignScore(targetDir, targetDir);
+  const slopScore = slop.score;
+  const designScore = design.score === "-" ? "N/A" : design.score;
+  const colorMap = {
+    "A": "brightgreen",
+    "B": "green",
+    "C": "yellow",
+    "D": "orange",
+    "F": "red",
+    "-": "lightgrey",
+    "N/A": "lightgrey"
+  };
+  const worstScore = isScoreBelow(slopScore, designScore === "N/A" ? "A" : designScore) ? slopScore : designScore === "N/A" ? slopScore : designScore;
+  const color = colorMap[worstScore] ?? "lightgrey";
+  const label = encodeURIComponent("BASTARD");
+  const message = encodeURIComponent(`Slop: ${slopScore} | Design: ${designScore}`);
+  const url = `https://img.shields.io/badge/${label}-${message}-${color}?style=flat-square`;
+  console.log(chalk2.bold("\n  Shipped with BASTARD\n"));
+  console.log(`  Slop Score:   ${slopScore}`);
+  console.log(`  Design Score: ${designScore}`);
+  console.log(chalk2.bold("\n  Markdown:\n"));
+  console.log(`  [![Shipped with BASTARD](${url})](https://github.com/Denis-hamon/bastard)
+`);
+  console.log(chalk2.bold("  HTML:\n"));
+  console.log(`  <a href="https://github.com/Denis-hamon/bastard"><img src="${url}" alt="Shipped with BASTARD"></a>
+`);
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bastard-framework",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Build Any SaaS Through Agent Roles & Discipline — The guardrails between your favorite Claude Code frameworks.",
   "type": "module",
   "bin": {