@altotyler/alto-rootstock-cli 1.0.0 → 1.0.1
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 +30 -62
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -27,38 +27,6 @@ Once a project is open, `Ctrl+Shift+P` → **"Tasks: Run Task"** exposes:
|
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
30
|
-
## Deploying and packaging
|
|
31
|
-
|
|
32
|
-
### 1. Create the GitHub repo
|
|
33
|
-
|
|
34
|
-
Create a **private** repo: `github.com/alto-tyler/alto-rootstock-cli`
|
|
35
|
-
|
|
36
|
-
This repo is separate from `rootstock-agent-distribution` — it's the CLI source code only.
|
|
37
|
-
|
|
38
|
-
### 2. Push the code
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
cd alto-rootstock-cli
|
|
42
|
-
git init
|
|
43
|
-
git add .
|
|
44
|
-
git commit -m "Initial release"
|
|
45
|
-
git remote add origin git@github.com:alto-tyler/alto-rootstock-cli.git
|
|
46
|
-
git push -u origin main
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### 3. Publish a version
|
|
50
|
-
|
|
51
|
-
Tag a release — GitHub Actions publishes it automatically to GitHub Packages:
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
git tag v1.0.0
|
|
55
|
-
git push origin v1.0.0
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
The workflow in `.github/workflows/publish.yml` runs `npm publish` to npmjs.com using the `NPM_TOKEN` secret (add this in the repo Settings → Secrets → Actions).
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
30
|
## How users install it
|
|
63
31
|
|
|
64
32
|
No auth required — the package is public on npmjs.com:
|
|
@@ -69,11 +37,11 @@ npm install -g @altotyler/alto-rootstock-cli
|
|
|
69
37
|
|
|
70
38
|
After install, run `altors install` once to save your GitHub token for fetching skill files from the private distribution repo.
|
|
71
39
|
|
|
72
|
-
|
|
40
|
+
Updates are one command:
|
|
73
41
|
|
|
74
42
|
```bash
|
|
75
43
|
npm update -g @altotyler/alto-rootstock-cli
|
|
76
|
-
altors install #
|
|
44
|
+
altors install # re-fetches latest global VS Code agent files
|
|
77
45
|
```
|
|
78
46
|
|
|
79
47
|
---
|
|
@@ -85,11 +53,11 @@ Every time `altors` runs any command, it fetches `version.json` from the distrib
|
|
|
85
53
|
```
|
|
86
54
|
┌──────────────────────────────────────────────────────┐
|
|
87
55
|
│ Update available: 1.0.0 → 1.2.0 │
|
|
88
|
-
│ Run: npm update -g @altotyler/alto-rootstock-cli
|
|
56
|
+
│ Run: npm update -g @altotyler/alto-rootstock-cli │
|
|
89
57
|
└──────────────────────────────────────────────────────┘
|
|
90
58
|
```
|
|
91
59
|
|
|
92
|
-
To
|
|
60
|
+
To trigger update notices, bump `cliVersion` in `rootstock-agent-distribution/version.json`:
|
|
93
61
|
|
|
94
62
|
```json
|
|
95
63
|
{
|
|
@@ -100,41 +68,41 @@ To support this, keep `version.json` in `rootstock-agent-distribution` updated w
|
|
|
100
68
|
|
|
101
69
|
---
|
|
102
70
|
|
|
71
|
+
## Releasing a new CLI version
|
|
72
|
+
|
|
73
|
+
1. Update `version` in `package.json`
|
|
74
|
+
2. Commit and tag: `git tag v1.x.x && git push origin v1.x.x`
|
|
75
|
+
3. GitHub Actions publishes to npmjs.com automatically (requires `NPM_TOKEN` secret in repo Settings → Secrets → Actions)
|
|
76
|
+
4. Update `cliVersion` in `rootstock-agent-distribution/version.json`
|
|
77
|
+
5. Users see the update prompt on their next `altors` command
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
103
81
|
## Repository layout
|
|
104
82
|
|
|
105
83
|
```
|
|
106
|
-
alto-rootstock-cli/
|
|
107
|
-
├── bin/altors.js
|
|
84
|
+
alto-rootstock-cli/ ← this repo (CLI source, published to npmjs.com)
|
|
85
|
+
├── bin/altors.js ← entry point + update notification
|
|
108
86
|
├── src/
|
|
109
|
-
│ ├── commands/new.js
|
|
110
|
-
│ ├── commands/update.js
|
|
111
|
-
│ ├── commands/install.js
|
|
87
|
+
│ ├── commands/new.js ← prompts, runs sf project generate, injects skills
|
|
88
|
+
│ ├── commands/update.js ← updates skill files in current project
|
|
89
|
+
│ ├── commands/install.js ← installs global VS Code agent + saves GitHub token
|
|
112
90
|
│ └── lib/
|
|
113
|
-
│ ├── config.js
|
|
114
|
-
│ ├── fetcher.js
|
|
115
|
-
│ ├── scaffold.js
|
|
116
|
-
│ └── updater.js
|
|
117
|
-
├── project-template/
|
|
118
|
-
│ └── vscode/tasks.json
|
|
119
|
-
└── .github/workflows/publish.yml
|
|
120
|
-
|
|
121
|
-
rootstock-agent-distribution/
|
|
122
|
-
├── version.json
|
|
91
|
+
│ ├── config.js ← ~/.alto-rootstock/config.json token storage
|
|
92
|
+
│ ├── fetcher.js ← GitHub raw file fetcher (auth-aware)
|
|
93
|
+
│ ├── scaffold.js ← file manifest + writer
|
|
94
|
+
│ └── updater.js ← background version check
|
|
95
|
+
├── project-template/
|
|
96
|
+
│ └── vscode/tasks.json ← injected into new projects for command palette tasks
|
|
97
|
+
└── .github/workflows/publish.yml ← auto-publishes to npmjs.com on git tag push
|
|
98
|
+
|
|
99
|
+
rootstock-agent-distribution/ ← separate private repo (skill files + version manifest)
|
|
100
|
+
├── version.json ← bump cliVersion here to trigger update notices
|
|
123
101
|
└── project-template/
|
|
124
102
|
├── claude/CLAUDE.md
|
|
125
|
-
├── claude/skills
|
|
103
|
+
├── claude/skills/ ← 10 Rootstock skill files
|
|
126
104
|
├── cursor/rules/rootstock.mdc
|
|
127
105
|
├── github/agents/Rootstock Agent.agent.md
|
|
128
106
|
├── github/copilot-instructions.md
|
|
129
107
|
└── vscode/mcp.json + tasks.json
|
|
130
108
|
```
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
134
|
-
## Releasing a new version
|
|
135
|
-
|
|
136
|
-
1. Update `version` in `package.json`
|
|
137
|
-
2. Commit and tag: `git tag v1.x.x && git push origin v1.x.x`
|
|
138
|
-
3. GitHub Actions publishes to GitHub Packages
|
|
139
|
-
4. Update `cliVersion` in `rootstock-agent-distribution/version.json`
|
|
140
|
-
5. Users see the update prompt on their next `altors` command
|