@raven.js/cli 1.0.0-alpha.24 → 1.0.0

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 ADDED
@@ -0,0 +1,31 @@
1
+ # RavenJS CLI
2
+
3
+ The RavenJS CLI is designed for **Agent consumption**. AI skills (raven-setup, raven-add, raven-learn, raven-use) invoke it via `bunx raven`. Humans typically run only `bunx raven init`; all other workflows go through skills.
4
+
5
+ ---
6
+
7
+ ## Commands
8
+
9
+ | Command | Description |
10
+ |---------|-------------|
11
+ | `bunx raven init` | Initialize AI skills and raven root. Run once before using raven-setup. |
12
+ | `bunx raven add <module>` | Add a module. Installs dependencies (`dependsOn`) in topological order, copies files, and rewrites `@ravenjs/*` imports to relative paths. |
13
+ | `bunx raven status` | Installation status for all modules. Output is JSON for Agent consumption. |
14
+ | `bunx raven guide <module>` | Output README and source for a module. Used by raven-learn. |
15
+
16
+ ---
17
+
18
+ ## Options
19
+
20
+ | Option | Description |
21
+ |--------|-------------|
22
+ | `--root <dir>` | RavenJS root directory (default: `raven`). Overridable via `RAVEN_ROOT`. |
23
+ | `--source <path>` | Local module source path instead of GitHub. Overridable via `RAVEN_SOURCE`. |
24
+ | `--registry <path>` | Path to registry JSON (default: bundled with CLI). Overridable via `RAVEN_DEFAULT_REGISTRY_PATH`. |
25
+ | `--verbose, -v` | Verbose output. |
26
+
27
+ ---
28
+
29
+ ## Agent-facing output
30
+
31
+ All commands except `raven init` and `raven guide` output JSON by default. `raven status` includes version info, file hashes, and modified file status for Agent decision-making.
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.0.0-alpha.24",
2
+ "version": "1.0.0",
3
3
  "modules": {
4
4
  "core": {
5
5
  "files": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@raven.js/cli",
3
- "version": "1.0.0-alpha.24",
3
+ "version": "1.0.0",
4
4
  "description": "CLI tool for RavenJS framework",
5
5
  "type": "module",
6
6
  "scripts": {
@@ -10,7 +10,8 @@
10
10
  "raven": "./dist/raven"
11
11
  },
12
12
  "files": [
13
- "dist"
13
+ "dist",
14
+ "README.md"
14
15
  ],
15
16
  "engines": {
16
17
  "bun": ">=1.0"