@reporails/cli 0.5.2 → 0.5.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +52 -43
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,77 +1,83 @@
|
|
|
1
1
|
# @reporails/cli
|
|
2
2
|
|
|
3
|
-
AI Instruction Diagnostics for coding agents. Validates the entire agentic instruction system against
|
|
3
|
+
AI Instruction Diagnostics for coding agents. Validates the entire agentic instruction system against 97 rules.
|
|
4
4
|
|
|
5
|
-
### Beta —
|
|
5
|
+
### Beta phase — Moving fast, feedback welcome.
|
|
6
6
|
|
|
7
7
|
## Quick Start
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npx @reporails/cli check
|
|
11
|
+
# or
|
|
12
|
+
uvx --from reporails-cli ails check
|
|
11
13
|
```
|
|
12
14
|
|
|
13
15
|
No install, no account. Actionable findings in seconds:
|
|
14
16
|
|
|
15
17
|
```
|
|
16
|
-
Reporails — Diagnostics
|
|
18
|
+
Reporails — Diagnostics — Pro (beta)
|
|
17
19
|
|
|
18
20
|
┌─ Main (1)
|
|
19
|
-
│ CLAUDE.md
|
|
20
|
-
│ ⚠ Missing
|
|
21
|
-
│ ⚠
|
|
22
|
-
│
|
|
21
|
+
│ CLAUDE.md
|
|
22
|
+
│ ⚠ Missing directory layout — show the project … CORE:C:0035
|
|
23
|
+
│ ⚠ L9 7 of 7 instruction(s) lack effective reinfor… CORE:C:0053
|
|
24
|
+
│ ... and 16 more
|
|
25
|
+
│ 1 misordered · 1 orphan · 1 ambiguous
|
|
23
26
|
│
|
|
24
|
-
└─
|
|
27
|
+
└─ 21 findings
|
|
25
28
|
|
|
26
|
-
Score: 7.
|
|
27
|
-
|
|
29
|
+
Score: 7.9 / 10 ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░ (1.3s)
|
|
30
|
+
21 findings · 4 warnings · 1 info
|
|
28
31
|
Compliance: HIGH
|
|
29
32
|
```
|
|
30
33
|
|
|
31
34
|
## Install
|
|
32
35
|
|
|
33
36
|
```bash
|
|
34
|
-
#
|
|
37
|
+
# One-shot (no install needed)
|
|
35
38
|
npx @reporails/cli check
|
|
36
39
|
|
|
37
|
-
#
|
|
38
|
-
|
|
40
|
+
# Permanent install (puts ails on PATH + configures MCP)
|
|
41
|
+
npx @reporails/cli install
|
|
42
|
+
# or
|
|
43
|
+
uvx --from reporails-cli ails install
|
|
39
44
|
```
|
|
40
45
|
|
|
41
|
-
Once installed
|
|
46
|
+
Once installed, use `ails` directly:
|
|
42
47
|
|
|
43
48
|
```bash
|
|
44
|
-
ails check
|
|
45
|
-
ails
|
|
46
|
-
ails
|
|
49
|
+
ails check # Validate instruction files
|
|
50
|
+
ails update # Upgrade to latest version
|
|
51
|
+
ails auth login # Unlock full diagnostics (GitHub sign-in)
|
|
47
52
|
```
|
|
48
53
|
|
|
49
54
|
## Supported Agents
|
|
50
55
|
|
|
51
|
-
| Agent
|
|
52
|
-
|
|
53
|
-
| Claude
|
|
54
|
-
| Codex
|
|
55
|
-
| Copilot | `.github/copilot-instructions.md`
|
|
56
|
-
|
|
|
57
|
-
|
|
|
56
|
+
| Agent | Base config | Rules | Skills | Agents | Other |
|
|
57
|
+
|-------|-------------|-------|--------|--------|-------|
|
|
58
|
+
| Claude | `CLAUDE.md`, `.local.md` | `.claude/rules/**/*.md` | `.claude/skills/**/SKILL.md` | `.claude/agents/**/*.md` | commands, output-styles, memory, MCP, settings |
|
|
59
|
+
| Codex | `AGENTS.md`, `.override.md` | `.codex/rules/*.rules` | `.agents/skills/**/SKILL.md` | `.codex/agents/*.toml` | hooks, config |
|
|
60
|
+
| Copilot | `.github/copilot-instructions.md` | `.github/instructions/**/*.md` | `.github/skills/**/SKILL.md` | `.github/agents/*.agent.md` | hooks, prompts, MCP |
|
|
61
|
+
| Cursor | `.cursorrules`, `AGENTS.md` | `.cursor/rules/**/*.mdc` | `.cursor/skills/**/SKILL.md` | `.cursor/agents/*.md` | hooks, notepads, MCP, policy |
|
|
62
|
+
| Gemini | `GEMINI.md`, `AGENTS.md` | — | `.gemini/skills/**/SKILL.md` | `.gemini/agents/*.md` | commands, extensions, settings |
|
|
63
|
+
|
|
64
|
+
Auto-detects which agents are present. Scans project-level, user-level (`~/`), and managed (`/etc/`) paths.
|
|
58
65
|
|
|
59
66
|
## Commands
|
|
60
67
|
|
|
61
|
-
| Command
|
|
62
|
-
|
|
63
|
-
| `check [PATH]`
|
|
64
|
-
| `explain RULE_ID`
|
|
65
|
-
| `heal`
|
|
66
|
-
| `
|
|
67
|
-
| `
|
|
68
|
-
| `auth
|
|
69
|
-
| `
|
|
70
|
-
| `version` | Show version info |
|
|
68
|
+
| Command | Description |
|
|
69
|
+
|---------|-------------|
|
|
70
|
+
| `check [PATH]` | Validate instruction files (97 rules) |
|
|
71
|
+
| `explain RULE_ID` | Show rule details and fix guidance |
|
|
72
|
+
| `heal` | Auto-fix common violations |
|
|
73
|
+
| `install [PATH]` | Install CLI to PATH + MCP server |
|
|
74
|
+
| `update` | Upgrade to latest version |
|
|
75
|
+
| `auth login` | Sign in with GitHub |
|
|
76
|
+
| `version` | Show version info |
|
|
71
77
|
|
|
72
78
|
## What It Checks
|
|
73
79
|
|
|
74
|
-
|
|
80
|
+
97 rules across five categories:
|
|
75
81
|
|
|
76
82
|
- **Structure** — File organization, size limits, modularity
|
|
77
83
|
- **Content** — Specificity, reinforcement, tech stack, domain terminology
|
|
@@ -79,14 +85,17 @@ ails check # Now with cross-file analysis + compliance scoring
|
|
|
79
85
|
- **Maintenance** — Versioning, review processes
|
|
80
86
|
- **Governance** — Security policies, credential protection
|
|
81
87
|
|
|
82
|
-
##
|
|
83
|
-
|
|
84
|
-
| Feature
|
|
85
|
-
|
|
86
|
-
| Mechanical
|
|
87
|
-
| Content checks
|
|
88
|
-
|
|
|
89
|
-
|
|
|
88
|
+
## Free vs Pro
|
|
89
|
+
|
|
90
|
+
| Feature | Free | Pro |
|
|
91
|
+
|---------|------|-----|
|
|
92
|
+
| Mechanical + structural rules | 97 rules, full detail | 97 rules, full detail |
|
|
93
|
+
| Content-quality checks (embedding-based) | Full detail | Full detail |
|
|
94
|
+
| Client checks (ordering, orphan, format, bold, scope) | Full detail | Full detail |
|
|
95
|
+
| Per-atom diagnostics (specificity, modality, brevity) | Full detail | Full detail |
|
|
96
|
+
| Interaction diagnostics (conflicts, competition, coupling) | Count per file | Full detail (line, fix, effect) |
|
|
97
|
+
| Cross-file analysis (conflicts, repetition) | Coordinates only | Full |
|
|
98
|
+
| Compliance band + system score | — | Full |
|
|
90
99
|
|
|
91
100
|
## GitHub Actions
|
|
92
101
|
|