isomorphic-jj 1.7.0 → 1.9.0

package/README.md

@@ -1,11 +1,18 @@
-# isomorphic-jj
-
-[![npm version](https://img.shields.io/npm/v/isomorphic-jj.svg)](https://www.npmjs.com/package/isomorphic-jj)
-[![test coverage](https://img.shields.io/badge/tests-1701%20passing-brightgreen.svg)](https://github.com/johnhenry/isomorphic-jj)
-[![license](https://img.shields.io/npm/l/isomorphic-jj.svg)](LICENSE)
+# @johnhenry/isomorphic-jj
 
 > **Jujutsu version control for JavaScript**—stable change IDs, fearless undo, and no staging area. Works in Node.js and browsers.
 
+Full documentation: [opensource.johnhenry.me/isomorphic-jj](https://opensource.johnhenry.me/isomorphic-jj/)
+
+> Previously published as `isomorphic-jj` (final release 1.8.0, deprecated in
+> favor of this package). Renamed to `@johnhenry/isomorphic-jj` and restarted
+> at 0.0.0 on import into the @johnhenry family — a new address and era, not
+> a maturity signal.
+
+[![npm version](https://img.shields.io/npm/v/%40johnhenry%2Fisomorphic-jj.svg)](https://www.npmjs.com/package/@johnhenry/isomorphic-jj)
+[![CI](https://github.com/johnhenry/isomorphic-jj/actions/workflows/test.yml/badge.svg)](https://github.com/johnhenry/isomorphic-jj/actions/workflows/test.yml)
+[![license](https://img.shields.io/npm/l/%40johnhenry%2Fisomorphic-jj.svg)](LICENSE)
+
 **What makes it different:**
 - 🎯 **Stable change IDs** that survive rebases/squashes
 - ↩️  **Complete undo** for any operation (not just commits)
@@ -14,7 +21,7 @@
 - 🌐 **True isomorphic**—same API in Node, browsers, and Web Workers
 
 ```javascript
-import { createJJ } from 'isomorphic-jj';
+import { createJJ } from '@johnhenry/isomorphic-jj';
 import git from 'isomorphic-git';
 import fs from 'fs';
 
@@ -30,6 +37,83 @@ await jj.undo();
 
 ---
 
+## Contents
+
+- [Try it in 60 seconds](#try-it-in-60-seconds)
+- [Quick Start](#quick-start)
+- [Examples](#examples)
+- [What's New in v1.0](#whats-new-in-v10)
+- [How is this Different?](#how-is-this-different)
+- [Features](#features)
+- [Use Cases](#use-cases)
+- [API Reference](#api-reference)
+- [Why isomorphic-jj?](#why-isomorphic-jj)
+- [Architecture](#architecture)
+- [Project Status](#project-status)
+- [Installation & Environment](#installation--environment)
+- [Security model](#security-model)
+- [Contributing](#contributing)
+- [FAQ](#faq)
+- [Family](#family)
+- [License](#license)
+- [Acknowledgments](#acknowledgments)
+
+---
+
+## Try it in 60 seconds
+
+### CLI
+
+Every method is reachable from the `isojj` CLI (`bin/isojj.js`). Run it with
+`npx`, or install it globally (`npm i -g @johnhenry/isomorphic-jj`) and call
+`isojj` directly:
+
+```bash
+npx @johnhenry/isomorphic-jj init
+echo "# hello" > README.md
+npx @johnhenry/isomorphic-jj describe -m "Initial commit"
+npx @johnhenry/isomorphic-jj new -m "Add a feature"
+npx @johnhenry/isomorphic-jj log
+```
+
+```
+Change History:
+
+  cb7b4e93fd23  Add a feature
+             You  9/2/2026, 7:20:30 AM
+
+  a2f6f5af8107  Initial commit
+             You  9/2/2026, 7:20:30 AM
+```
+
+Run `npx @johnhenry/isomorphic-jj --help` for the full command list.
+
+### Node.js
+
+```javascript
+import { createJJ } from '@johnhenry/isomorphic-jj';
+import fs from 'fs';
+
+const jj = await createJJ({ fs, dir: './my-repo' });
+await jj.init({ userName: 'You', userEmail: 'you@example.com' });
+await jj.write({ path: 'README.md', data: '# hello\n' });
+await jj.describe({ message: 'Initial commit' });
+console.log(await jj.log({ limit: 5 }));
+```
+
+### Browser
+
+```javascript
+import { createJJ } from '@johnhenry/isomorphic-jj';
+import { createBrowserFS } from '@johnhenry/isomorphic-jj/browser';
+
+const fs = await createBrowserFS({ name: 'my-repo' });
+const jj = await createJJ({ fs, dir: '/repo' });
+// Same API as Node from here on — see examples/12-browser.mjs.
+```
+
+---
+
 ## Quick Start
 
 **Coming from isomorphic-git?** Read the [Migration Guide](./MIGRATION_FROM_ISOMORPHIC_GIT.md) to see how isomorphic-jj simplifies your JavaScript version control workflow.
@@ -42,6 +126,43 @@ This showcases all 17 feature categories (including v1.0 enhancements) in ~3 sec
 
 ---
 
+## Examples
+
+The [`examples/`](./examples) directory has 12 numbered, runnable, self-asserting
+scripts — each creates a repo in a temp dir, demonstrates one area, and cleans
+up after itself. Run one with `npm run example:01` (etc.), or the whole set
+(the same loop CI runs) with:
+
+```bash
+npm run examples
+```
+
+| # | What it shows |
+|---|----------------|
+| [01](./examples/01-init-commit-log.mjs) | The core loop: init → write → `describe()` → `new()` → `log()` |
+| [02](./examples/02-stacked-changes.mjs) | Stable change IDs across a 3-layer stack; `edit()`+`amend()` a bottom layer |
+| [03](./examples/03-history-editing.mjs) | `split()`, `squash({ into })`, `abandon()`/`unabandon()`, `duplicate()` |
+| [04](./examples/04-branching-and-merging.mjs) | Diverging without branches; content merge vs. true merge changes |
+| [05](./examples/05-conflicts.mjs) | First-class conflicts: dry-run preview, `conflicts.list()`/`resolve()` |
+| [06](./examples/06-revsets.mjs) | The revset query language, end to end |
+| [07](./examples/07-bookmarks-and-tags.mjs) | Bookmarks, tags, and remote tracking |
+| [08](./examples/08-git-interop.mjs) | Real `git.clone()`/`push()`/`fetch()` against a local fixture, zero network |
+| [09](./examples/09-config.mjs) | Config layers: persisted, programmatic, deep-merge, reset |
+| [10](./examples/10-undo-and-oplog.mjs) | `undo()`/`redo()`, `operations.at()` time travel, `obslog()` |
+| [11](./examples/11-file-operations.mjs) | The `file.*` namespace: historical `show()`, `annotate()`, `search()` |
+| [12](./examples/12-browser.mjs) | Browser usage (IndexedDB fs, persistence, CORS proxy) as a reference |
+
+See [`examples/README.md`](./examples/README.md) for details and conventions.
+
+Three fuller example applications live under [`example/`](./example) — each
+exercises the library from a different angle and documents the bugs it found:
+
+- [`jj-review-tool`](./example/jj-review-tool) — a code-review CLI built on stacked changes and bookmarks.
+- [`jj-storage-server`](./example/jj-storage-server) — a REST API using isomorphic-jj as a versioned document store.
+- [`jj-wiki`](./example/jj-wiki) — a collaborative wiki exercising workspaces and conflict resolution.
+
+---
+
 ## What's New in v1.0
 
 isomorphic-jj v1.0 achieves **complete JJ CLI semantic compatibility** while maintaining 100% backward compatibility:
@@ -76,6 +197,7 @@ isomorphic-jj v1.0 now implements virtually all commonly-used JJ CLI commands:
 - **`git.remote.*`** - Complete remote management (list, add, remove, rename, setUrl)
 - **`bookmark.rename()`** - Rename bookmarks
 - **`bookmark.track/untrack/forget()`** - Remote bookmark management
+- **`tag.track/untrack()`** - Remote tag management (jj v0.44)
 - **`config.*`** - Configuration management (get, set, list)
 - **`diff()`** - Show file differences between revisions
 - **`next()` / `prev()`** - Navigate between parent/child revisions
@@ -85,10 +207,10 @@ isomorphic-jj v1.0 now implements virtually all commonly-used JJ CLI commands:
 - **`operations.show/diff/restore()`** - Advanced operation log features
 - **`remote.*`** - Convenience aliases for git operations (push, fetch, add)
 
-See [JJ_CLI_PARITY.md](./JJ_CLI_PARITY.md) for complete feature comparison.
+See [ROADMAP.md](./ROADMAP.md) for the release-by-release feature comparison and what's still planned.
 
 ### Testing & Quality
-- **1701 tests** passing — ~97% statement / 91% branch coverage (v1.0–v1.7)
+- **1823 tests** passing — ~97% statement / 91% branch coverage
 - **100% backward compatible** - All existing code continues to work
 - **Zero breaking changes** - Deprecated features show warnings but still function
 
@@ -97,7 +219,7 @@ See [JJ_CLI_PARITY.md](./JJ_CLI_PARITY.md) for complete feature comparison.
 ### Installation
 
 ```bash
-npm install isomorphic-jj isomorphic-git
+npm install @johnhenry/isomorphic-jj isomorphic-git
 ```
 
 For browsers, also install:
@@ -108,7 +230,7 @@ npm install @isomorphic-git/lightning-fs
 ### Basic Workflow
 
 ```javascript
-import { createJJ } from 'isomorphic-jj';
+import { createJJ } from '@johnhenry/isomorphic-jj';
 import git from 'isomorphic-git';
 import fs from 'fs';
 import http from 'isomorphic-git/http/node';
@@ -147,13 +269,13 @@ console.log(log);
 ### Browser Usage
 
 ```javascript
-import { createJJ } from 'isomorphic-jj';
-import { createBrowserFS } from 'isomorphic-jj/browser';
+import { createJJ } from '@johnhenry/isomorphic-jj';
+import { createBrowserFS } from '@johnhenry/isomorphic-jj/browser';
 import git from 'isomorphic-git';
 import http from 'isomorphic-git/http/web';
 
 // Create browser filesystem (uses IndexedDB)
-const fs = createBrowserFS({ name: 'my-repo' });
+const fs = await createBrowserFS({ name: 'my-repo' });
 
 const jj = await createJJ({ fs, dir: '/repo', git, http });
 await jj.git.init({ userName: 'User', userEmail: 'user@example.com' });
@@ -494,7 +616,7 @@ await jj.undo();
 Merge drivers enable smart merging of structured files like JSON, package.json, and YAML:
 
 ```javascript
-import { jsonDriver, packageJsonDriver, yamlDriver, markdownDriver } from 'isomorphic-jj';
+import { jsonDriver, packageJsonDriver, yamlDriver, markdownDriver } from '@johnhenry/isomorphic-jj';
 
 // Register merge drivers for different file types
 jj.mergeDrivers.register({
@@ -625,23 +747,23 @@ const bookmarks = await jj.bookmark.list();
 ### Browser Support
 
 ```javascript
-import { createBrowserFS, requestPersistentStorage } from 'isomorphic-jj/browser';
+import { createBrowserFS, requestPersistentStorage } from '@johnhenry/isomorphic-jj/browser';
 
 // Request persistent storage (prevents eviction)
 const persistent = await requestPersistentStorage();
 
 // Create filesystem with IndexedDB backend
-const fs = createBrowserFS({ backend: 'idb', name: 'my-repo' });
+const fs = await createBrowserFS({ backend: 'idb', name: 'my-repo' });
 
 // Check browser capabilities
-import { detectCapabilities } from 'isomorphic-jj/browser';
+import { detectCapabilities } from '@johnhenry/isomorphic-jj/browser';
 const caps = detectCapabilities();
 if (caps.indexedDB && caps.serviceWorker) {
   // Enable offline support
 }
 
 // Get storage quota
-import { getStorageQuota } from 'isomorphic-jj/browser';
+import { getStorageQuota } from '@johnhenry/isomorphic-jj/browser';
 const quota = await getStorageQuota();
 console.log(`Using ${quota.percentage}% of available storage`);
 ```
@@ -794,7 +916,7 @@ Full API documentation available in [TypeScript definitions](./src/types.d.ts).
 ### Main Interface
 
 ```typescript
-import { createJJ, type JJ, type CreateJJOptions } from 'isomorphic-jj';
+import { createJJ, type JJ, type CreateJJOptions } from '@johnhenry/isomorphic-jj';
 
 const jj: JJ = await createJJ(options: CreateJJOptions);
 ```
@@ -804,8 +926,8 @@ const jj: JJ = await createJJ(options: CreateJJOptions);
 - **Repository**: `init()`, `status()`, `stats()`
 - **Files**: `write()`, `read()`, `cat()`, `move()` (deprecated for history), `remove()`, `listFiles()` | **Namespace**: `file.write()`, `file.show()`, `file.list()`, `file.move()`, `file.remove()`
 - **Changes**: `describe()`, `new()`, `amend()`, `commit()`, `edit()`, `show()`
-- **History**: `log()`, `obslog()`, `squash()`, `split()`, `rebase()`, `abandon()`, `unabandon()`
-- **Operations**: `undo()`, `operations.list()`, `operations.at()`
+- **History**: `log()`, `obslog()`, `squash()`, `split()`, `rebase()`, `abandon()`, `unabandon()`, `converge()`
+- **Operations**: `undo()`, `redo()`, `operations.list()`, `operations.at()`, `operations.restore()`
 - **Bookmarks**: `bookmark.list()`, `bookmark.set()`, `bookmark.move()`, `bookmark.delete()`
 - **Git**: `git.init()`, `git.fetch()`, `git.push()`, `git.import()`, `git.export()`
 - **Remotes**: `remote.add()`, `remote.fetch()`, `remote.push()`
@@ -898,10 +1020,10 @@ repo/
 
 ## Project Status
 
-**Current Version**: v1.7.0
-**Test Coverage**: 1701 tests, ~97% statements / 91% branches
-**JJ CLI parity**: tracks Jujutsu through v0.43
-**Status**: Ready for experimentation and prototyping
+**Current Version**: 0.3.0 (`@johnhenry/isomorphic-jj`; same library/API lineage as the old `isomorphic-jj`, which reached v1.7.0 before the rename — see the provenance note at the top of this file)
+**Test Coverage**: 1823 tests passing, ~97% statements / 91% branches
+**JJ CLI parity**: tracks Jujutsu through v0.45.1
+**Status**: Actively developed; broad JJ CLI semantic parity, used in the examples/apps in this repo and in [JJHub](#family). Not yet 1.0 — API surface can still shift; pin a version and read the CHANGELOG before upgrading.
 
 **Completed:**
 - ✅ v0.1: Core JJ experience (stable IDs, undo, bookmarks, revsets)
@@ -911,6 +1033,9 @@ repo/
 - ✅ v0.5: Custom merge drivers, enhanced revsets (time-based, graph analytics), conflict resolution enhancements
 - ✅ v1.0: Full JJ CLI semantic parity, complete `file.*`/`operations.*`/`git.*` namespaces
 - ✅ v1.5: Parity refresh tracking jj through **v0.43** — new revsets (`change_id`, `commit_id`, `subject`, `author_name`/`email`, `committer*`, `signed`, `divergent`, `merges`, `forks`, `first_parent`, `first_ancestors`, `fork_point`, `merge_point`, `exactly`, `present`, `coalesce`, `remote_tags`, `ancestors(x, depth)`), working `tags()`/`remote_tags()` revsets, and new commands: `revert()`, `redo()`, `sign()`/`unsign()`, `file.search()`, `bookmark.advance()`, `tag.set()`. See [CHANGELOG.md](./CHANGELOG.md).
+- ✅ 0.1.0 (post-rename): Parity refresh tracking jj through **v0.44** — `tag.track()`/`tag.untrack()`, the `builtin_log()` revset alias, and `file.search({ nameOnly: true })`; `git_refs()`/`git_head()` documented as deprecated (jj removed both in v0.43). See [CHANGELOG.md](./CHANGELOG.md) for what was deliberately left for a maintainer call (`jj run`, fetch-time remote tag/bookmark import).
+- ✅ 0.2.0: Storage-layer audit fixes — same-process storage locking, `undo()` reverting in-place graph/tag mutations, ambiguous change-id detection, categorized `push()` error codes, a conflict-marker newline fix, atomic protobuf writes, and open-ended revset ranges (`..b`, `a..`, `::`). See [CHANGELOG.md](./CHANGELOG.md).
+- ✅ 0.3.0: Parity refresh tracking jj through **v0.45.1** — a working `/browser` entry (async `createBrowserFS()`, bundle-safe protobuf schema loading, no stray Node-only imports), `undo()`/`operations.restore()` reverting graph rewrites with real progressive undo/redo, `squash()`/`abandon()`/`edit()`/`new()` fully syncing content instead of only metadata, `rebase()` performing a real three-way merge and recording conflicts, and the new `converge()` command (jj v0.45.0) to auto-resolve divergent commits. See [CHANGELOG.md](./CHANGELOG.md).
 
 See [ROADMAP.md](./ROADMAP.md) for detailed plans, and [CHANGELOG.md](./CHANGELOG.md) for the release history.
 
@@ -920,7 +1045,7 @@ See [ROADMAP.md](./ROADMAP.md) for detailed plans, and [CHANGELOG.md](./CHANGELO
 
 ### Requirements
 
-- **Node.js**: 20.0.0 or higher (uses the Web Crypto global, stabilized in Node 20; Node 18 is EOL)
+- **Node.js**: 26.0.0 or higher, matching `engines.node` and CI (uses the Web Crypto global, stabilized in Node 20 — the family floor is higher than the functional minimum)
 - **Browsers**: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
 - **Optional**: Git CLI (for JJ CLI interop testing)
 
@@ -941,6 +1066,58 @@ See [ROADMAP.md](./ROADMAP.md) for detailed plans, and [CHANGELOG.md](./CHANGELO
 
 ---
 
+## Security model
+
+isomorphic-jj is a headless reimplementation of JJ's model, not a wrapper
+around the `jj` or `git` binaries — that architectural choice is also its
+main security property. It does not run a sandbox and does not vet the
+repositories you point it at.
+
+**What isomorphic-jj guarantees:**
+
+- **No shell-out, ever.** The library never spawns a child process to run
+  `git`, `jj`, or any other binary — repository paths, branch/bookmark
+  names, and commit messages are handled as plain JS values through
+  `isomorphic-git`'s and `protobufjs`'s pure-JS encoders, never interpolated
+  into a shell command string. This removes the whole class of
+  shell-injection risk that a CLI-wrapping library (like `simple-git`) has
+  to defend against by construction, not by escaping.
+- **Storage writes are atomic.** `jj-operation-store.js`, `jj-view-store.js`,
+  and `jj-tree-state.js` route every write through a shared
+  `atomicWriteFile()` temp+rename helper, and same-process concurrent writes
+  to the same path are serialized through a path-keyed async mutex — a
+  crash or a racing autosnapshot mid-write cannot leave a truncated or
+  undecodable store file. Fixed in [PR #19](https://github.com/johnhenry/isomorphic-jj/pull/19) (0.2.0); scoped to
+  same-process concurrency — cross-process locking is not yet implemented
+  (see "still yours" below).
+
+**What is still yours:**
+
+- **Remote authentication and transport trust.** `git.push()`/`git.fetch()`
+  delegate to `isomorphic-git`'s HTTP client (and, in the browser, whatever
+  CORS proxy you configure) — isomorphic-jj neither stores nor validates
+  credentials, and does not verify a remote server's identity beyond what
+  that HTTP layer does. A misconfigured or malicious CORS proxy sees
+  everything a normal Git remote would.
+- **Custom merge drivers run arbitrary code with full process access.**
+  `mergeDrivers.register()` lets you register a function per file
+  pattern (`'*.json'`, `'package.json'`, …); a registered driver — yours or
+  a dependency's — executes with the same privileges as the rest of your
+  process during every merge that touches a matching path. isomorphic-jj
+  does not sandbox driver execution; treat a third-party merge driver the
+  same as any other third-party code you'd `require()`.
+- **Cross-process locking is not implemented.** The same-process mutex
+  above does not protect a repository opened by two separate OS processes
+  at once (e.g. two CLI invocations, or a CLI run concurrently with a
+  long-running server process) — don't rely on isomorphic-jj to serialize
+  those for you.
+- **No allowlisting of untrusted repository content.** Cloning or importing
+  a Git history runs its objects through the same parsing code regardless
+  of whether you trust the source, matching `isomorphic-git`'s own model —
+  this library adds no additional vetting layer.
+
+---
+
 ## Contributing
 
 We welcome contributions! Here's how to help:
@@ -982,7 +1159,7 @@ A: Yes! Colocated repos expose normal Git commits. Git users never see JJ metada
 A: Comparable to isomorphic-git for Git operations. JJ metadata (JSON) is fast in Node, acceptable in browsers. Large histories need pagination.
 
 **Q: Does this support all JJ features?**
-A: Not yet. We're at v0.4. See [ROADMAP.md](./ROADMAP.md) for planned features.
+A: Broad semantic parity (tracks Jujutsu through v0.45.1), not every CLI/UX detail — it's a library, not a terminal UI. See [ROADMAP.md](./ROADMAP.md) for what's planned and what's deliberately out of scope.
 
 **Q: Can I migrate my Git repo?**
 A: Yes! `jj.git.init()` works on existing Git repositories.
@@ -992,12 +1169,35 @@ A: JJ's model genuinely improves common workflows—stable change IDs, fearless
 
 ---
 
-## Related Projects
-
-- [isomorphic-git](https://isomorphic-git.org/) - Pure JS Git implementation (our foundation)
-- [Jujutsu](https://jj-vcs.github.io/jj/) - The original JJ version control system
-- [simple-git](https://github.com/steveukx/git-js) - Git wrapper for Node.js
-- [Git plumbing vs porcelain](https://git-scm.com/book/en/v2/Git-Internals-Plumbing-and-Porcelain) - Architecture pattern we follow
+## Family
+
+isomorphic-jj has no other package in the `@johnhenry` npm scope yet — it
+consumes and is consumed by projects outside that scope. Those relationships
+are still concrete enough to document precisely, so they're recorded here
+rather than under a vaguer "see also".
+
+- **[JJHub](https://jjhub.erisera.com)** — a Jujutsu-native overlay on GitHub,
+  and the closest thing this library has to a downstream consumer: it calls
+  `createJJ()` directly (not a wrapped or forked copy) to get stable change
+  IDs and stacked PRs on top of existing GitHub repos, platform-wide undo,
+  and an MCP server exposing the same fearless-undo, no-staging-area
+  workflow to coding agents. JJHub is a private Erisera product, not a
+  `@johnhenry/*` package — install its CLI with `npm i -g jjhub`.
+- **[`isomorphic-git`](https://github.com/isomorphic-git/isomorphic-git)** —
+  a real, non-optional dependency: this library's Git backend support
+  (`jj.git.init/clone/push/fetch`) is built directly on isomorphic-git's
+  pure-JS Git object model, not a fork or reimplementation of it. Peer
+  dependency, not bundled — see [Installation & Environment](#installation--environment).
+
+### Prior art
+
+- [Jujutsu](https://jj-vcs.github.io/jj/) — the original JJ version control
+  system this library reimplements the semantics of (headlessly, in JS; not
+  a wrapper around the `jj` binary).
+- [simple-git](https://github.com/steveukx/git-js) — a Git CLI wrapper for
+  Node.js; unlike isomorphic-jj, it shells out to the `git` binary rather
+  than reimplementing the object model in JS.
+- [Git plumbing vs porcelain](https://git-scm.com/book/en/v2/Git-Internals-Plumbing-and-Porcelain) — the architecture pattern this library's own layering follows.
 
 ---
 
@@ -1013,5 +1213,3 @@ Built on the shoulders of:
 - [isomorphic-git](https://github.com/isomorphic-git/isomorphic-git) by William Hilton
 - [Jujutsu](https://github.com/martinvonz/jj) by Martin von Zweigbergk
 - The Git and JavaScript communities
-
-**Status**: v1.0.0 | **Tests**: 371 passing | **Ready for**: Production use

package/bin/isojj.js

@@ -24,6 +24,7 @@ const BOOLEAN_FLAGS = new Set([
   'noTags',
   'allowNew',
   'preserveSnapshot',
+  'nameOnly',
 ]);
 
 /** Coerce a raw flag-value string to a real boolean when it looks like one. */
@@ -179,7 +180,7 @@ History editing:
 Files:
   file.list [--revision <id>]   List tracked files
   file.show <path>              Show file contents
-  file.search --pattern <re>    Search file contents        (jj file search)
+  file.search --pattern <re> [--nameOnly]   Search file contents (jj file search)
   file.annotate --path <p>      Blame-style annotation
 
 Bookmarks & tags:
@@ -188,6 +189,8 @@ Bookmarks & tags:
   bookmark.list
   tag.set --name <n> --changeId <id>       Create or move a tag
   tag.list
+  tag.track --name <n> [--remote <r>]      Track a remote tag (jj v0.44)
+  tag.untrack --name <n>                   Stop tracking a remote tag
 
 Signing:
   sign [--revision <id>] [--backend ssh --key <k>]