@jolli.ai/space-cli 0.99.8 → 0.99.10

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.
Files changed (3) hide show
  1. package/README.md +37 -23
  2. package/dist/Plugin.js +2 -2
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # `@jolli.ai/space-cli`
2
2
 
3
- CLI plugin that adds Jolli Space sync, source, impact-analysis, and agent commands to the open-source [`@jolli.ai/cli`](https://www.npmjs.com/package/@jolli.ai/cli). Loaded automatically when both packages are installed together.
3
+ CLI plugin that adds the `jolli space` namespace for sync, source, impact-analysis, and agent commands to the open-source [`@jolli.ai/cli`](https://www.npmjs.com/package/@jolli.ai/cli). Loaded automatically when both packages are installed together.
4
4
 
5
5
  ## Installation
6
6
 
@@ -8,42 +8,56 @@ CLI plugin that adds Jolli Space sync, source, impact-analysis, and agent comman
8
8
  npm install -g @jolli.ai/cli @jolli.ai/space-cli
9
9
  ```
10
10
 
11
- Once both are installed, the following commands become available:
11
+ Once both are installed, the `jolli space` namespace and its commands become available:
12
12
 
13
- - `jolli init` — Initialize the current directory: log in (if needed) and select a space
14
- - `jolli space` — Inspect Jolli auth state and select a space for sync (`status`, `switch`)
15
- - `jolli source` — Manage source repositories for impact analysis (`add`, `remove`, `list`)
16
- - `jolli sync` — Sync markdown files with the server (`pending`, `changeset`, `up`, `down`, `full`, `strip`)
17
- - `jolli impact` — Documentation impact-analysis tools: server-backed (`extract`, `search`, `agent`) and purely-local (`init`, `settings`, `local`, `attention` — see below)
18
- - `jolli agent` — Interactive LLM agent with local tool execution (`list`, `resume`)
13
+ - `jolli space init` — Initialize the current directory: log in (if needed) and select a space
14
+ - `jolli space status|switch|ls|clones` — Inspect and select spaces, or list local clones
15
+ - `jolli space source` — Manage source repositories for impact analysis (`add`, `remove`, `list`)
16
+ - `jolli space sync` — Sync markdown files with the server (`pending`, `changeset`, `up`, `down`, `full`, `strip`)
17
+ - `jolli space impact` — Documentation impact-analysis tools: server-backed (`extract`, `search`, `agent`) and purely-local (`init`, `settings`, `local`, `attention` — see below)
18
+ - `jolli space agent` — Interactive LLM agent with local tool execution (`list`, `resume`)
19
+ - `jolli space verify-publish-branch` — Verify a local-run publish landed on the server-derived work branch (used by the `jolli-local-run` skill recipe)
19
20
 
20
- Without `@jolli.ai/space-cli` installed, the host CLI displays these commands as stubs that prompt the user to install this package.
21
+ Without `@jolli.ai/space-cli` installed, the host CLI displays the `space` namespace as an installation stub that prompts the user to install this package.
22
+
23
+ ### Deprecated top-level commands
24
+
25
+ Earlier releases exposed these as bare top-level commands (`jolli init`, `jolli source`, `jolli impact`, `jolli sync`, `jolli agent`, `jolli docs`). They still work for backward compatibility but are **deprecated and hidden** from `jolli --help`; each prints a one-line deprecation notice to stderr and will be removed in the next major release. Migrate to the `jolli space …` form:
26
+
27
+ | Deprecated | Use instead |
28
+ | ------------------------------ | ------------------------------------ |
29
+ | `jolli init` | `jolli space init` |
30
+ | `jolli source …` | `jolli space source …` |
31
+ | `jolli impact …` | `jolli space impact …` |
32
+ | `jolli sync …` | `jolli space sync …` |
33
+ | `jolli agent …` | `jolli space agent …` |
34
+ | `jolli docs pull` / `publish` | `jolli space sync down` / `up` |
21
35
 
22
36
  ## Purely-local impact (no Jolli login)
23
37
 
24
- `jolli impact` also has a **fully local mode**: point it at a docs directory and one or more local source repos, bring your own LLM key, and it updates the affected docs in place over your new commits — **no Jolli login, no space, no server round-trip, no GitHub App.**
38
+ `jolli space impact` also has a **fully local mode**: point it at a docs directory and one or more local source repos, bring your own LLM key, and it updates the affected docs in place over your new commits — **no Jolli login, no space, no server round-trip, no GitHub App.**
25
39
 
26
40
  ```bash
27
41
  # Set up .jolli/settings.local.yaml
28
- jolli impact init # auto-detect: current git repo = source, find a docs/ dir (within 2 levels)
29
- jolli impact init --docs ./docs --source ../backend # or specify explicitly (repeat --source for multiple repos)
42
+ jolli space impact init # auto-detect: current git repo = source, find a docs/ dir (within 2 levels)
43
+ jolli space impact init --docs ./docs --source ../backend # or specify explicitly (repeat --source for multiple repos)
30
44
 
31
45
  # Configure an LLM — default is Anthropic + claude-sonnet-4-6, so just set a key
32
46
  export ANTHROPIC_API_KEY=sk-... # or OPENAI_API_KEY / GEMINI_API_KEY / JOLLI_LLM_API_KEY
33
- jolli impact settings --provider openai --model gpt-4o # only to use a NON-default provider/model
34
- jolli impact settings --set-key # or store the key via a hidden prompt (never in shell history)
35
- jolli impact settings --max-tokens-per-turn 16384 # raise the per-turn output budget if edits get truncated (default 8192, range 4096..200000)
47
+ jolli space impact settings --provider openai --model gpt-4o # only to use a NON-default provider/model
48
+ jolli space impact settings --set-key # or store the key via a hidden prompt (never in shell history)
49
+ jolli space impact settings --max-tokens-per-turn 16384 # raise the per-turn output budget if edits get truncated (default 8192, range 4096..200000)
36
50
 
37
51
  # Run impact over your new commits
38
- jolli impact local # edit docs affected by new commits, in place
39
- jolli impact local --uncommitted # preview against the working tree
40
- jolli impact local --dry-run # list impacted docs only (no writes, no LLM, no key needed)
41
- jolli impact local --thinking # stream the model's reasoning above the live panel (default: off)
52
+ jolli space impact local # edit docs affected by new commits, in place
53
+ jolli space impact local --uncommitted # preview against the working tree
54
+ jolli space impact local --dry-run # list impacted docs only (no writes, no LLM, no key needed)
55
+ jolli space impact local --thinking # stream the model's reasoning above the live panel (default: off)
42
56
 
43
57
  # Attention = the document -> source-file mapping that impact matches against
44
- jolli impact attention # generate / update the cache
45
- jolli impact attention --refresh # rebuild from scratch
46
- jolli impact attention --show # view the current mapping
58
+ jolli space impact attention # generate / update the cache
59
+ jolli space impact attention --refresh # rebuild from scratch
60
+ jolli space impact attention --show # view the current mapping
47
61
  ```
48
62
 
49
63
  - A **source must be a git repository** (impact diffs it); the **docs directory does not** — it can be a standalone folder, its own repo, or a subfolder of the source.
@@ -53,7 +67,7 @@ jolli impact attention --show # view the current mapping
53
67
 
54
68
  ## Architecture
55
69
 
56
- This package is a **commander-shaped shell** that the host CLI loads in-process: when both packages are installed, `@jolli.ai/cli`'s plugin loader calls this package's `register(ctx)` and it extends the host's commander `program` with the commands above. It does **not** value-import `commander` or `@jolli.ai/cli/api` — both are provided by the host process at load time and are therefore externalized from the bundle.
70
+ This package is a **commander-shaped shell** that the host CLI loads in-process: when both packages are installed, `@jolli.ai/cli`'s plugin loader calls this package's `register(ctx)` and it extends the host's commander `program` with one `space` namespace containing the commands above. It does **not** value-import `commander` or `@jolli.ai/cli/api` — both are provided by the host process at load time and are therefore externalized from the bundle.
57
71
 
58
72
  It ships as a single **obfuscated, self-contained** bundle (`dist/Plugin.js` + `dist/Plugin.d.ts`). All third-party runtime dependencies (picomatch, zod, eventsource, wyhash, yaml) are bundled inline; no `node_modules` install is pulled in beyond the host CLI itself.
59
73