@nolto/cli 0.7.1 → 0.8.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 +16 -3
- package/dist/index.js +771 -426
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -21,6 +21,8 @@ nolto init
|
|
|
21
21
|
`nolto init` configures authentication, selects or creates a project, writes the
|
|
22
22
|
repo-local `nolto.json` binding, installs the bundled `roadmap-progress` skill,
|
|
23
23
|
and creates `.nolto/roadmaps/<slug>.json` when needed.
|
|
24
|
+
Re-running it inside a repository keeps the saved token and only sets up that
|
|
25
|
+
repository; use `--force` to reconfigure the global settings.
|
|
24
26
|
|
|
25
27
|
For browser-based authentication without the rest of the repository setup:
|
|
26
28
|
|
|
@@ -42,12 +44,20 @@ nolto whoami # Show resolved auth/config state and project count
|
|
|
42
44
|
|
|
43
45
|
```bash
|
|
44
46
|
nolto link <projectId> # Write or update nolto.json at the repository root
|
|
45
|
-
nolto link --show # Show the current binding and
|
|
47
|
+
nolto link --show # Show the current binding, source, and repository identity
|
|
48
|
+
nolto link --rebind # Rebind the project to this repository (owner only)
|
|
46
49
|
nolto link --unlink # Remove projectId from nolto.json
|
|
47
50
|
```
|
|
48
51
|
|
|
49
52
|
Commit `nolto.json` so everyone working in the repository targets the same Nolto
|
|
50
|
-
project.
|
|
53
|
+
project. A Nolto project is bound to the first repository identity it syncs from.
|
|
54
|
+
The identity is the normalized `origin` remote, or a machine ID plus path when no
|
|
55
|
+
remote is available. Syncing from a different repository fails with
|
|
56
|
+
`409 repo_mismatch`. An owner can run `nolto link --rebind` in the correct
|
|
57
|
+
repository to change the binding, at most once every seven days.
|
|
58
|
+
|
|
59
|
+
CLI versions older than 0.8.0 do not send a repository identity and receive
|
|
60
|
+
`426`; run `nolto update` before syncing.
|
|
51
61
|
|
|
52
62
|
### Roadmap Sync
|
|
53
63
|
|
|
@@ -60,10 +70,13 @@ nolto watch --install-service # Install the Linux systemd user service
|
|
|
60
70
|
`sync` reads every `.nolto/roadmaps/*.json` file in filename order, uses each
|
|
61
71
|
filename stem as its slug, validates schema v2, follows any linked plan Markdown
|
|
62
72
|
paths, and sends an idempotent full upsert to the bound project. A legacy
|
|
63
|
-
`.roadmap/roadmap.json` is migrated
|
|
73
|
+
`.roadmap/roadmap.json` is migrated by `nolto sync` when no canonical roadmap
|
|
74
|
+
exists; `nolto watch` only warns and never migrates.
|
|
64
75
|
|
|
65
76
|
`watch` uses the repository registry maintained by `nolto init`. Missing registered
|
|
66
77
|
repositories are skipped with a warning.
|
|
78
|
+
The CLI warns when an installed `roadmap-progress` skill version differs from the
|
|
79
|
+
CLI version; run `nolto init` in that repository to refresh it.
|
|
67
80
|
|
|
68
81
|
## Configuration
|
|
69
82
|
|