@theholocron/cli 4.16.5 → 4.17.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 +17 -1
- package/dist/cli.mjs +611 -388
- package/dist/cli.mjs.map +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -14,6 +14,22 @@ holocron --help
|
|
|
14
14
|
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
+
## Execution contexts
|
|
18
|
+
|
|
19
|
+
Every command is tagged with how much of a repo it needs:
|
|
20
|
+
|
|
21
|
+
| Context | Needs | Examples |
|
|
22
|
+
| ------------ | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
|
|
23
|
+
| `global` | just the CLI binary | `version`, `clone`, `new`, `upgrade node`, `auth set` / `check`, `plugin create`, `skills …` |
|
|
24
|
+
| `repo-aware` | `./holocron.config` in cwd, no plugins | `run`, `ci`, `config show`, `sync-readme` |
|
|
25
|
+
| `workspace` | the `@theholocron/holocron-plugin-*` packages resolvable | `doctor`, `setup`, `sync`, `secrets sync`, `deploy` |
|
|
26
|
+
|
|
27
|
+
A `workspace` command run from a bare global install (no plugins next to the
|
|
28
|
+
CLI) fails with one actionable line — install the plugins as devDependencies or
|
|
29
|
+
use `pnpm exec holocron <cmd>`. `auth check` degrades to "token present,
|
|
30
|
+
verification skipped" instead. `holocron --help` prints the grouping; see
|
|
31
|
+
[Execution Contexts](https://theholocron.github.io/holocron/execution-contexts).
|
|
32
|
+
|
|
17
33
|
## Config file
|
|
18
34
|
|
|
19
35
|
Holocron reads `holocron.config.{json,js,ts}` from the project root
|
|
@@ -408,7 +424,7 @@ holds the orchestration + the Holocron-specific credential resolution
|
|
|
408
424
|
`astromech.reusableTemplates()` to `theholocron/.github` (a pure sync target —
|
|
409
425
|
never hand-edit its `.github/workflows/*`).
|
|
410
426
|
- `src/commands/` — `setup`, `sync`, `doctor`, `deploy`, `secret set`,
|
|
411
|
-
`secrets sync`, `
|
|
427
|
+
`secrets sync`, `publish`, `bump-versions`, `sync-github`, `upgrade node`,
|
|
412
428
|
`upgrade deps`, `plugin create`, `auth`
|
|
413
429
|
|
|
414
430
|
## Status
|