@reporails/cli 0.2.1 → 0.4.0

package/README.md

@@ -8,7 +8,7 @@ Score your CLAUDE.md files. See what's missing. Improve your AI coding setup.
 npx @reporails/cli install
 ```
 
-This registers the MCP server with Claude Code. Then ask Claude:
+This detects agents in your project and writes the MCP config. Then ask Claude:
 
 ```
 > What ails claude?
@@ -23,14 +23,14 @@ npx @reporails/cli check
 That's it. You'll get a score, capability level, and actionable violations.
 ```
 ╔══════════════════════════════════════════════════════════════╗
-║   SCORE: 8.1 / 10 (partial)  |  CAPABILITY: Maintained (L5)    ║
+║   SCORE: 8.1 / 10 (awaiting semantic)  |  CAPABILITY: Maintained (L5)    ║
 ║   ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░         ║
 ╚══════════════════════════════════════════════════════════════╝
 
 Violations:
   CLAUDE.md (7 issues)
-    ○ MED C4.no-antipatterns :1    No NEVER or AVOID statements found
-    · LOW C12.no-version     :1    No version or date marker found
+    ○ :1    No NEVER or AVOID statements found       RRAILS:C:0003
+    · :1    No version or date marker found           CORE:C:0012
     ...
 ```
 
@@ -70,37 +70,48 @@ Capability levels describe what your AI instruction setup enables — not how "m
 | L5 | Maintained | Structural integrity, governance, navigation |
 | L6 | Adaptive | Dynamic context, extensibility, persistence |
 
-## Commands
+## GitHub Actions
 
-```bash
-ails check                      # Score your setup
-ails check -f json              # JSON output (for CI)
-ails check --strict             # Exit 1 if violations (for CI)
-ails check --no-update-check    # Skip pre-run update prompt
-ails check --exclude-dir vendor # Exclude directory from scanning
-ails explain CORE:S:0001        # Explain a rule
-ails map                        # Show project structure
-ails map --save                 # Generate backbone.yml
-ails update                     # Update rules framework + recommended
-ails update --check             # Check for updates without installing
-ails update --recommended       # Update recommended rules only
-ails update --force             # Force reinstall even if current
-ails update --cli               # Upgrade the CLI package itself
-ails dismiss CORE:C:0001        # Dismiss a semantic finding
-ails version                    # Show version info
+Add `ails check` as a CI gate with inline PR annotations:
+
+```yaml
+# .github/workflows/reporails.yml
+name: Reporails
+on:
+  pull_request:
+    paths: ['CLAUDE.md', '.claude/**']
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: reporails/cli/action@v1
+        with:
+          min-score: '6.0'
 ```
 
+See the [main README](https://github.com/reporails/cli#github-actions) for full action inputs/outputs.
+
+## Commands
+
 | Command | Description |
 |---------|-------------|
-| `install [--scope user\|project]` | Register MCP server with Claude Code |
-| `uninstall [--scope user\|project]` | Remove MCP server from Claude Code |
+| `install [PATH]` | Install MCP server for detected agents |
 | `check [PATH]` | Validate instruction files |
+| `heal [PATH]` | Interactive auto-fix + semantic evaluation |
 | `explain RULE_ID` | Show rule details |
 | `map [PATH]` | Discover project structure |
 | `update` | Update rules framework + recommended |
+| `config set KEY VALUE` | Set a project config value |
+| `config set --global KEY VALUE` | Set a global default |
+| `config get KEY` | Show a config value |
+| `config list` | Show all config (project + global) |
 | `dismiss RULE_ID` | Dismiss a semantic finding |
+| `judge PATH VERDICTS` | Cache semantic verdicts |
 | `version` | Show version info |
 
+See the [main README](https://github.com/reporails/cli#commands) for full flag reference.
+
 ## Updating
 
 ```bash
@@ -118,10 +129,11 @@ Persistent installs: `npm install -g @reporails/cli@latest`
 
 ## Recommended Rules
 
-[Recommended rules](https://github.com/reporails/recommended) (AILS_ namespace) are included by default and auto-downloaded on first run. To opt out, add to your `.reporails/config.yml`:
+[Recommended rules](https://github.com/reporails/recommended) (AILS_ namespace) are included by default and auto-downloaded on first run. To opt out:
 
-```yaml
-recommended: false
+```bash
+ails config set recommended false            # This project only
+ails config set --global recommended false   # All projects
 ```
 
 To update recommended rules independently:
@@ -134,7 +146,7 @@ ails update --recommended
 
 - **Node.js >= 18**
 - **uv** — auto-installed if missing ([manual install](https://docs.astral.sh/uv/))
-- **Claude Code** — required for `install`/`uninstall` commands ([install](https://docs.anthropic.com/en/docs/claude-code))
+- **No additional dependencies** — `install` writes config files directly
 
 ## How It Works
 
@@ -149,4 +161,4 @@ Want to add or improve rules? Please follow [Contribute](https://github.com/repo
 
 ## License
 
-BUSL 1.1
+BUSL 1.1 — converts to Apache 2.0 on 2029-02-20 or at 1.0, whichever comes first.

package/bin/reporails.mjs

@@ -5,15 +5,13 @@ import { platform } from "node:os";
 import { argv, exit } from "node:process";
 
 const PYPI_PACKAGE = "reporails-cli";
-const MCP_COMMAND = "ails-mcp";
 const CLI_COMMAND = "ails";
 
 const HELP = `
 reporails — Score your CLAUDE.md files
 
 Usage:
-  reporails install [--scope user|project]   Register MCP server with Claude Code
-  reporails uninstall [--scope user|project] Remove MCP server from Claude Code
+  reporails install [PATH]                 Install MCP server for detected agents
   reporails check [PATH] [OPTIONS]           Validate instruction files
   reporails explain RULE_ID                  Show rule details
   reporails map [PATH] [--save]              Discover project structure
@@ -26,7 +24,7 @@ Usage:
   reporails <command> [args...]              Proxy any command to ails CLI
 
 Examples:
-  npx @reporails/cli install          # Add MCP server (user scope)
+  npx @reporails/cli install           # Install MCP server
   npx @reporails/cli check            # Score your setup
   npx @reporails/cli explain CORE:S:0001  # Explain a rule
   npx @reporails/cli update           # Update rules + recommended
@@ -78,62 +76,10 @@ function ensureUv() {
   }
 }
 
-function parseScope(args) {
-  const idx = args.indexOf("--scope");
-  if (idx !== -1 && idx + 1 < args.length) {
-    return args[idx + 1];
-  }
-  return "user";
-}
-
 // ---------------------------------------------------------------------------
 // Subcommands
 // ---------------------------------------------------------------------------
 
-function install(args) {
-  if (!commandExists("claude")) {
-    console.error(
-      "Claude Code CLI not found.\nInstall it from: https://docs.anthropic.com/en/docs/claude-code",
-    );
-    exit(1);
-  }
-
-  ensureUv();
-
-  const scope = parseScope(args);
-  const cmd = `claude mcp add --scope ${scope} reporails -- uvx --refresh --from ${PYPI_PACKAGE} ${MCP_COMMAND}`;
-  console.log(`Registering MCP server (scope: ${scope})...`);
-
-  try {
-    execSync(cmd, { stdio: "inherit" });
-    console.log("\nDone. Restart Claude Code to activate the MCP server.");
-  } catch {
-    console.error("Failed to register MCP server.");
-    exit(1);
-  }
-}
-
-function uninstall(args) {
-  if (!commandExists("claude")) {
-    console.error(
-      "Claude Code CLI not found.\nInstall it from: https://docs.anthropic.com/en/docs/claude-code",
-    );
-    exit(1);
-  }
-
-  const scope = parseScope(args);
-  const cmd = `claude mcp remove --scope ${scope} reporails`;
-  console.log(`Removing MCP server (scope: ${scope})...`);
-
-  try {
-    execSync(cmd, { stdio: "inherit" });
-    console.log("\nDone. MCP server removed.");
-  } catch {
-    console.error("Failed to remove MCP server.");
-    exit(1);
-  }
-}
-
 function proxy(args) {
   ensureUv();
 
@@ -163,14 +109,5 @@ if (!subcommand || subcommand === "--help" || subcommand === "-h") {
   exit(0);
 }
 
-switch (subcommand) {
-  case "install":
-    install(args.slice(1));
-    break;
-  case "uninstall":
-    uninstall(args.slice(1));
-    break;
-  default:
-    proxy(args);
-    break;
-}
+// All subcommands proxy to the Python CLI
+proxy(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reporails/cli",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Score your CLAUDE.md files. See what's missing. Improve your AI coding setup.",
   "type": "module",
   "bin": {