@reporails/cli 0.1.4 → 0.2.1

package/README.md

@@ -23,7 +23,7 @@ npx @reporails/cli check
 That's it. You'll get a score, capability level, and actionable violations.
 ```
 ╔══════════════════════════════════════════════════════════════╗
-║   SCORE: 8.1 / 10 (partial)  |  CAPABILITY: Governed (L5)    ║
+║   SCORE: 8.1 / 10 (partial)  |  CAPABILITY: Maintained (L5)    ║
 ║   ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░         ║
 ╚══════════════════════════════════════════════════════════════╝
 
@@ -58,14 +58,17 @@ Once installed, all commands use `ails` directly.
 
 ## Capability Levels
 
-| Level | Name | What it means |
-|-------|------|---------------|
-| L1 | Absent | No instruction file |
-| L2 | Basic | Has CLAUDE.md |
-| L3 | Structured | Sections, imports |
-| L4 | Abstracted | .claude/rules/ directory |
-| L5 | Governed | Shared files, 3+ components |
-| L6 | Adaptive | Backbone + full governance |
+Capability levels describe what your AI instruction setup enables — not how "mature" it is. Different projects need different capabilities.
+
+| Level | Name | What It Enables |
+|-------|------|-----------------|
+| L0 | Absent | No instruction file — nothing to evaluate |
+| L1 | Basic | Reviewed, tracked instruction file |
+| L2 | Scoped | Project-specific constraints, size control |
+| L3 | Structured | External references, multiple files |
+| L4 | Abstracted | Path-scoped rules, context-aware loading |
+| L5 | Maintained | Structural integrity, governance, navigation |
+| L6 | Adaptive | Dynamic context, extensibility, persistence |
 
 ## Commands
 
@@ -73,13 +76,17 @@ Once installed, all commands use `ails` directly.
 ails check                      # Score your setup
 ails check -f json              # JSON output (for CI)
 ails check --strict             # Exit 1 if violations (for CI)
-ails check --with-recommended   # Include recommended rules
-ails explain S1                 # Explain a rule
+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
-ails update --check             # Check for rule updates
-ails dismiss C6                 # Dismiss a semantic finding
+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
 ```
 
@@ -90,29 +97,37 @@ ails version                    # Show version info
 | `check [PATH]` | Validate instruction files |
 | `explain RULE_ID` | Show rule details |
 | `map [PATH]` | Discover project structure |
-| `update` | Update rules framework |
+| `update` | Update rules framework + recommended |
 | `dismiss RULE_ID` | Dismiss a semantic finding |
 | `version` | Show version info |
 
 ## Updating
 
-The **rules framework** updates separately from the CLI:
-
 ```bash
-ails update              # Update rules to latest
-ails update --check      # Check without installing
+ails update              # Update rules framework + recommended to latest
+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
 ```
 
+Before each scan, the CLI prompts when updates are available. Use `--no-update-check` to skip.
+
 The **CLI itself** updates automatically — `npx @reporails/cli` always fetches the latest version.
 Persistent installs: `npm install -g @reporails/cli@latest`
 
 ## Recommended Rules
 
-The `--with-recommended` flag adds community [recommended rules](https://github.com/reporails/recommended) on top of the core set. These are methodology-backed checks (AILS_ namespace) that are auto-downloaded on first use:
+[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`:
+
+```yaml
+recommended: false
+```
+
+To update recommended rules independently:
 
 ```bash
-ails check --with-recommended       # Include recommended rules
-ails update --recommended              # Re-fetch latest recommended rules
+ails update --recommended
 ```
 
 ## Prerequisites
@@ -134,4 +149,4 @@ Want to add or improve rules? Please follow [Contribute](https://github.com/repo
 
 ## License
 
-Apache-2.0
+BUSL 1.1

package/bin/reporails.mjs

@@ -16,7 +16,11 @@ Usage:
   reporails uninstall [--scope user|project] Remove MCP server from Claude Code
   reporails check [PATH] [OPTIONS]           Validate instruction files
   reporails explain RULE_ID                  Show rule details
-  reporails update                           Update rules framework
+  reporails map [PATH] [--save]              Discover project structure
+  reporails update                           Update rules framework + recommended
+  reporails update --check                   Check for updates without installing
+  reporails update --recommended             Update recommended rules only
+  reporails update --cli                     Upgrade CLI package itself
   reporails dismiss RULE_ID                  Dismiss a semantic finding
   reporails version                          Show version info
   reporails <command> [args...]              Proxy any command to ails CLI
@@ -24,8 +28,8 @@ Usage:
 Examples:
   npx @reporails/cli install          # Add MCP server (user scope)
   npx @reporails/cli check            # Score your setup
-  npx @reporails/cli explain S1       # Explain a rule
-  npx @reporails/cli update           # Update rules
+  npx @reporails/cli explain CORE:S:0001  # Explain a rule
+  npx @reporails/cli update           # Update rules + recommended
 
 Prerequisites:
   Node.js >= 18 (uv is auto-installed if missing)
@@ -97,7 +101,7 @@ function install(args) {
   ensureUv();
 
   const scope = parseScope(args);
-  const cmd = `claude mcp add --scope ${scope} reporails -- uvx --from ${PYPI_PACKAGE} ${MCP_COMMAND}`;
+  const cmd = `claude mcp add --scope ${scope} reporails -- uvx --refresh --from ${PYPI_PACKAGE} ${MCP_COMMAND}`;
   console.log(`Registering MCP server (scope: ${scope})...`);
 
   try {
@@ -133,7 +137,7 @@ function uninstall(args) {
 function proxy(args) {
   ensureUv();
 
-  const child = spawn("uvx", ["--from", PYPI_PACKAGE, CLI_COMMAND, ...args], {
+  const child = spawn("uvx", ["--refresh", "--from", PYPI_PACKAGE, CLI_COMMAND, ...args], {
     stdio: "inherit",
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reporails/cli",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "description": "Score your CLAUDE.md files. See what's missing. Improve your AI coding setup.",
   "type": "module",
   "bin": {
@@ -25,6 +25,6 @@
     "type": "git",
     "url": "https://github.com/reporails/cli"
   },
-  "license": "Apache-2.0",
+  "license": "BUSL-1.1",
   "author": "Reporails"
 }