@olonjs/cli 3.0.167 → 3.0.168
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,52 @@
|
|
|
1
|
+
# @olonjs/cli
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>The Sovereign CLI Engine for OlonJS.</strong><br />
|
|
5
|
+
Scaffold tenants by projecting DNA templates — deterministic, Node-native, no bash.
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
<p align="center">
|
|
9
|
+
<a href="https://www.npmjs.com/package/@olonjs/cli"><img src="https://img.shields.io/npm/v/@olonjs/cli?color=blue&style=flat-square" alt="npm version"></a>
|
|
10
|
+
<a href="https://github.com/olonjs/npm-jpcore/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="license"></a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
**@olonjs/cli** is the primary entry point for OlonJS developers. It scaffolds new tenants by projecting **DNA templates** — shell archives interpreted **in Node, without bash** — so a fresh tenant is reproducible byte-for-byte.
|
|
14
|
+
|
|
15
|
+
## Install
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
# No global install needed — use npx
|
|
19
|
+
npx @olonjs/cli new tenant my-agentic-site --template next
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Binaries: `olonjs` (primary) and `jsonpages` (deprecated legacy alias).
|
|
23
|
+
|
|
24
|
+
## Commands
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
olonjs new tenant <name> [--template next|vite|alpha] [--script]
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
| Template | Source of truth | Stack |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| `next` | `apps/next` | Next.js App Router (RSC visitors + admin island) |
|
|
33
|
+
| `vite` | Vite scaffold | Vite + React |
|
|
34
|
+
| `alpha` (default) | `apps/tenant-alpha` | Vite reference tenant |
|
|
35
|
+
|
|
36
|
+
- Interactive mode uses an arrow-key template picker.
|
|
37
|
+
- **Non-interactive shells (CI, agents) must pass `--template` explicitly** — the CLI fails with an explicit error otherwise.
|
|
38
|
+
- `--script` switches the generator to script-driven mode.
|
|
39
|
+
|
|
40
|
+
## Determinism Guarantees
|
|
41
|
+
|
|
42
|
+
- DNA templates are **generated, never hand-edited**: `npm run dist:dna:all` delegates to each source app's `dist` script; `npm run check:templates` validates conformance.
|
|
43
|
+
- The generated tenant's `package.json` pins dependency versions from [`@olonjs/stack`](../stack) — the single source of truth for version policy.
|
|
44
|
+
- Governance rules: `docs/CLI.md`, `docs/TEMPLATES.md`, `.cursor/rules/cli-templates.mdc`.
|
|
45
|
+
|
|
46
|
+
## Versioning
|
|
47
|
+
|
|
48
|
+
Patch-only auto-numbering (`3.0.XXX`) by the gated `release:enterprise` pipeline, which regenerates and validates the DNA before publishing.
|
|
49
|
+
|
|
50
|
+
## License
|
|
51
|
+
|
|
52
|
+
MIT — see [LICENSE](../../LICENSE).
|
|
@@ -1817,9 +1817,9 @@ cat << 'END_OF_FILE_CONTENT' > "package.json"
|
|
|
1817
1817
|
"@tiptap/extension-link": "^2.11.5",
|
|
1818
1818
|
"@tiptap/react": "^2.11.5",
|
|
1819
1819
|
"@tiptap/starter-kit": "^2.11.5",
|
|
1820
|
-
"@olonjs/core": "^2.0.
|
|
1821
|
-
"@olonjs/react": "^0.2.
|
|
1822
|
-
"@olonjs/studio": "^0.2.
|
|
1820
|
+
"@olonjs/core": "^2.0.4",
|
|
1821
|
+
"@olonjs/react": "^0.2.4",
|
|
1822
|
+
"@olonjs/studio": "^0.2.4",
|
|
1823
1823
|
"class-variance-authority": "^0.7.1",
|
|
1824
1824
|
"clsx": "^2.1.1",
|
|
1825
1825
|
"lucide-react": "^0.474.0",
|
|
@@ -1817,9 +1817,9 @@ cat << 'END_OF_FILE_CONTENT' > "package.json"
|
|
|
1817
1817
|
"@tiptap/extension-link": "^2.11.5",
|
|
1818
1818
|
"@tiptap/react": "^2.11.5",
|
|
1819
1819
|
"@tiptap/starter-kit": "^2.11.5",
|
|
1820
|
-
"@olonjs/core": "^2.0.
|
|
1821
|
-
"@olonjs/react": "^0.2.
|
|
1822
|
-
"@olonjs/studio": "^0.2.
|
|
1820
|
+
"@olonjs/core": "^2.0.4",
|
|
1821
|
+
"@olonjs/react": "^0.2.4",
|
|
1822
|
+
"@olonjs/studio": "^0.2.4",
|
|
1823
1823
|
"class-variance-authority": "^0.7.1",
|
|
1824
1824
|
"clsx": "^2.1.1",
|
|
1825
1825
|
"lucide-react": "^0.474.0",
|
|
@@ -789,11 +789,11 @@ cat << 'END_OF_FILE_CONTENT' > "package.json"
|
|
|
789
789
|
"dist:dna": "npm run dist"
|
|
790
790
|
},
|
|
791
791
|
"dependencies": {
|
|
792
|
-
"@olonjs/core": "^2.0.
|
|
793
|
-
"@olonjs/next": "^0.0.
|
|
794
|
-
"@olonjs/react": "^0.2.
|
|
792
|
+
"@olonjs/core": "^2.0.4",
|
|
793
|
+
"@olonjs/next": "^0.0.16",
|
|
794
|
+
"@olonjs/react": "^0.2.4",
|
|
795
795
|
"@olonjs/sources": "^0.1.0",
|
|
796
|
-
"@olonjs/studio": "^0.2.
|
|
796
|
+
"@olonjs/studio": "^0.2.4",
|
|
797
797
|
"clsx": "^2.1.1",
|
|
798
798
|
"lucide-react": "^0.474.0",
|
|
799
799
|
"next": "^15.5.0",
|