jj-plus 0.10.10

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 0.10.10 — 2026-09-10
+
+### JJ Plus
+
+- Add a reproducible Nix development shell for the Node, pnpm, JJ, and release toolchain.
+- Make local and CI publishing resilient to token-based npm registries.
+
+## 0.10.5 — 2026-08-28
+
+### JJ Plus
+
+- Add a dedicated Repo Timeline view for browsing repository-wide JJ history.
+- Add revset filtering, history search, bookmark/branch references, revision patches, and remote revision links.
+
+## 0.10.4 — 2026-08-28
+
+### JJ Plus
+
+- Refresh the Marketplace README around user workflows.
+- Add the JJ Plus panda icon and a supported npm package boundary for the CLI.
+- Improve line-blame hover content and add a focused webview UX review.
+
+## 0.10.3 — 2026-08-28
+
+### JJ Plus
+
+- First release of the extension under the JJ Plus name.
+- Includes the v2 revision timeline, range diff, search, overlay, blame, conflict, and navigation features.

package/README.md

@@ -0,0 +1,102 @@
+# JJ Plus
+
+Explore Jujutsu and Git history without leaving your editor.
+
+JJ Plus is a VS Code extension for comparing revisions, browsing the history of the active file, and jumping from a line directly to the revision that introduced it. It prefers Jujutsu when a workspace is managed by JJ and falls back to Git when it is not.
+
+## What you can do
+
+- Open a multi-file diff between two revisions, bookmarks, or revsets.
+- Browse a file’s revision timeline with a compact history list, scrubber, and focused diff.
+- Open a repository timeline to search and inspect revisions across the whole workspace.
+- Compare a revision with its previous or next revision.
+- Search history by author, description, or path.
+- Inspect line blame and open the timeline at the current line.
+- Review JJ evolution and operation history when working in a JJ repository.
+- Use the same timeline from a terminal with the optional `jj-plus` CLI.
+
+## Requirements
+
+- VS Code 1.134 or newer.
+- [Jujutsu](https://jj-vcs.github.io/jj/latest/install-and-setup/) for JJ history.
+- Git is used automatically for ordinary Git workspaces.
+
+## Install
+
+Install **JJ Plus** from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=astahmer.jj-plus), then reload VS Code if prompted.
+
+Open the Command Palette and try:
+
+- **JJ Plus: Open Revision Timeline** — browse the active file’s history.
+- **JJ Plus: Open Repo Timeline** — search repository history and inspect any revision’s patch.
+- **JJ Plus: Open Range Multi Diff** — compare two revisions across files.
+- **JJ Plus: Toggle Line Blame** — show the revision behind the active line.
+
+The extension reads repository history using the `jj` or `git` executable available on your PATH. It does not bundle either VCS or install a global terminal command.
+
+## CLI (optional)
+
+The Marketplace extension and the terminal CLI are separate installation channels. Installing the VSIX does not add `jj-plus` to your shell PATH.
+
+Once the npm package is available, install the CLI separately:
+
+```sh
+npm install --global jj-plus
+# or: pnpm add --global jj-plus
+```
+
+Then run a range diff or the standalone browser timeline from any repository:
+
+```sh
+jj-plus diff --from <revision> --to <revision>
+jj-plus timeline path/to/file.ts
+```
+
+The CLI needs an installed VS Code-compatible IDE for deep-link diffs. It needs `jj` or `git` for the timeline, depending on the repository. Use `jj-plus --help` for all options, including `--ide`, `--workspace`, `--port`, `--no-open`, and `--verbose`.
+
+## Useful workflows
+
+### Timeline
+
+Open **JJ Plus: Open Revision Timeline** with a file active. Select an entry to inspect its snapshot and use the comparison controls to switch between a single revision diff, a range, or the working tree. The file switcher can show all files in the selected revision or only files changed in the selected range.
+
+Open **JJ Plus: Open Repo Timeline** when you are looking for a change across the repository. Search revision messages, authors, bookmarks, branches, and ids, then select a revision to inspect its changed files and patch. The Repo Timeline has its own view so repository discovery does not disturb the active file timeline.
+
+### Line history
+
+Enable **JJ Plus: Toggle Line Blame** or hover a line. The compact blame popover identifies the author, age, summary, revision, and line number, with one action to open the timeline at that line.
+
+### Range diffs
+
+The Command Palette command accepts the same revision language as JJ or Git. The CLI is useful for scripts and editor integrations:
+
+```sh
+jj-plus diff --from closest_bookmark(@) --to @ --workspace .
+jj-plus diff --ide cursor --from <revision> --to <revision>
+```
+
+## Configuration
+
+All settings are under `jjplus` in VS Code settings. The most useful ones are:
+
+- `jjplus.currentLineBlame` — annotate the active line with a non-editing end-of-line blame label (enabled by default); it is temporarily hidden while editing so inline completion text has the end-of-line slot to itself.
+- `jjplus.inlineBlameGutter` — annotate revision hunk starts throughout the file.
+- `jjplus.hoverTimelineLink` — offer a timeline link when hovering source lines.
+- `jjplus.scmChangedLines` — show changes against the previous working-copy revision.
+- `jjplus.conflictHelper` — highlight JJ conflict markers and enable next-conflict navigation.
+
+## Troubleshooting
+
+Open the **JJ Plus** output channel to see the exact `jj` or `git` commands used by the extension. For CLI diagnostics, add `--verbose`.
+
+If history is unavailable, verify the repository is open as a VS Code workspace and that `jj --version` or `git --version` works in the same environment as VS Code.
+
+Report problems or request features in the [GitHub issue tracker](https://github.com/astahmer/jj-plus/issues).
+
+## Development
+
+Contributor setup, test commands, fixture generation, and the release checklist live in [`docs/development.md`](docs/development.md). The user-facing Marketplace README intentionally stays short and task-oriented.
+
+## License
+
+The project is currently distributed without a declared open-source license. Check the repository for the latest licensing decision before redistributing it.

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,23 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+exports.__toESM = __toESM;

package/dist/bin.cjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_constants = require("./extension/constants.cjs");
+const require_options = require("./cli/options.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_child_process = require("node:child_process");
+//#region src/bin.ts
+main().catch((error) => {
+	const message = error instanceof Error ? error.message : String(error);
+	process.stderr.write(`${message}\n`);
+	process.exitCode = 1;
+});
+async function main() {
+	const argv = process.argv.slice(2);
+	const invocation = require_options.resolveCliInvocation(argv);
+	if (invocation.command === "timeline") {
+		const options = require_options.parseTimelineArgs(invocation.argv);
+		if (options.help) {
+			process.stdout.write(`${require_options.usage()}\n`);
+			return;
+		}
+		await launchStandaloneTimeline(options);
+		return;
+	}
+	const options = require_options.parseRangeDiffArgs(invocation.argv);
+	if (options.help) {
+		process.stdout.write(`${require_options.usage()}\n`);
+		return;
+	}
+	const workspacePath = options.workspacePath || process.cwd();
+	const resolvedWorkspacePath = node_path.default.resolve(workspacePath);
+	const ide = require_options.resolveIde(options.ide);
+	const params = new URLSearchParams();
+	params.set("workspacePath", resolvedWorkspacePath);
+	params.set("source", "cli");
+	if (options.from) params.set("from", options.from);
+	if (options.to) params.set("to", options.to);
+	if (options.title) params.set("title", options.title);
+	if (options.confirm) params.set("confirm", "1");
+	if (options.verbose) params.set("verbose", "1");
+	openWorkspace({
+		workspacePath: resolvedWorkspacePath,
+		ide,
+		verbose: options.verbose
+	});
+	let lastFailure = "";
+	for (const launcher of require_options.getLaunchers(params.toString(), ide)) {
+		require_options.logVerbose(options.verbose, `Launching deep link: ${require_options.formatCommand(launcher.command, launcher.args)}`);
+		const result = (0, node_child_process.spawnSync)(launcher.command, launcher.args, { stdio: "inherit" });
+		const launchError = result.error;
+		if (launchError) {
+			if (launchError.code === "ENOENT") continue;
+			lastFailure = `${launcher.command}: ${launchError.message}`;
+			continue;
+		}
+		if (result.status === 0) return;
+		lastFailure = `${launcher.command} exited with status ${result.status}`;
+	}
+	process.stderr.write(`Failed to open IDE for ${require_constants.EXTENSION_ID}. ${lastFailure || "No supported launcher was found."}\n`);
+	process.exitCode = 1;
+}
+async function launchStandaloneTimeline(options) {
+	if (!options.filePath) throw new Error(`Missing file path for standalone timeline\n\n${require_options.usage()}`);
+	const workspacePath = node_path.default.resolve(options.workspacePath || (node_path.default.isAbsolute(options.filePath) ? node_path.default.dirname(options.filePath) : process.cwd()));
+	const absoluteFilePath = node_path.default.isAbsolute(options.filePath) ? node_path.default.resolve(options.filePath) : node_path.default.resolve(workspacePath, options.filePath);
+	if (!node_fs.default.existsSync(absoluteFilePath)) throw new Error(`File not found: ${absoluteFilePath}`);
+	if (options.json) {
+		const { createCommandRunner } = await Promise.resolve().then(() => require("./extension/command-runner.cjs"));
+		const { createTimelineService } = await Promise.resolve().then(() => require("./extension/timeline-service.cjs"));
+		const { buildTimelineJsonSummary } = await Promise.resolve().then(() => require("./cli/timeline-json.cjs"));
+		const session = await createTimelineService({ runner: createCommandRunner({}) }).buildSession({
+			workspacePath,
+			absolutePath: absoluteFilePath
+		});
+		const summary = buildTimelineJsonSummary({
+			backend: session.backend,
+			relativePath: session.relativePath,
+			workspacePath: session.workspacePath,
+			entries: session.entries
+		});
+		process.stdout.write(`${JSON.stringify(summary, null, 2)}\n`);
+		return;
+	}
+	const { startStandaloneTimelineServer } = await Promise.resolve().then(() => require("./standalone/server.cjs"));
+	const server = await startStandaloneTimelineServer({
+		workspacePath,
+		filePath: absoluteFilePath,
+		openBrowser: options.open,
+		port: options.port,
+		verbose: options.verbose
+	});
+	process.stderr.write(`Standalone timeline available at ${server.url}\n`);
+	const shutdown = () => {
+		server.close().finally(() => {
+			process.exit(0);
+		});
+	};
+	process.once("SIGINT", shutdown);
+	process.once("SIGTERM", shutdown);
+}
+function openWorkspace(args) {
+	const commandArgs = ["-r", args.workspacePath];
+	require_options.logVerbose(args.verbose, `Opening workspace: ${require_options.formatCommand(args.ide.command, commandArgs)}`);
+	const launchError = (0, node_child_process.spawnSync)(args.ide.command, commandArgs, { stdio: "ignore" }).error;
+	if (launchError && launchError.code !== "ENOENT") process.stderr.write(`Warning: failed to focus workspace via ${args.ide.command}: ${launchError.message}\n`);
+}
+//#endregion
+
+//# sourceMappingURL=bin.cjs.map

package/dist/bin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.cjs","names":["resolveCliInvocation","parseTimelineArgs","usage","parseRangeDiffArgs","path","resolveIde","getLaunchers","formatCommand","spawnSync","EXTENSION_ID","fsSync"],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport fsSync from 'node:fs';\nimport path from 'node:path';\nimport { spawnSync } from 'node:child_process';\nimport {\n\tformatCommand,\n\tgetLaunchers,\n\tlogVerbose,\n\tparseRangeDiffArgs,\n\tparseTimelineArgs,\n\tresolveCliInvocation,\n\tresolveIde,\n\tusage,\n} from './cli/options.ts';\nimport { EXTENSION_ID } from './extension/constants.ts';\n\nvoid main().catch((error: unknown) => {\n\tconst message = error instanceof Error ? error.message : String(error);\n\tprocess.stderr.write(`${message}\\n`);\n\tprocess.exitCode = 1;\n});\n\nasync function main(): Promise<void> {\n\tconst argv = process.argv.slice(2);\n\tconst invocation = resolveCliInvocation(argv);\n\tif (invocation.command === 'timeline') {\n\t\tconst options = parseTimelineArgs(invocation.argv);\n\t\tif (options.help) {\n\t\t\tprocess.stdout.write(`${usage()}\\n`);\n\t\t\treturn;\n\t\t}\n\n\t\tawait launchStandaloneTimeline(options);\n\t\treturn;\n\t}\n\n\tconst options = parseRangeDiffArgs(invocation.argv);\n\tif (options.help) {\n\t\tprocess.stdout.write(`${usage()}\\n`);\n\t\treturn;\n\t}\n\n\tconst workspacePath = options.workspacePath || process.cwd();\n\tconst resolvedWorkspacePath = path.resolve(workspacePath);\n\tconst ide = resolveIde(options.ide);\n\tconst params = new URLSearchParams();\n\n\tparams.set('workspacePath', resolvedWorkspacePath);\n\tparams.set('source', 'cli');\n\n\tif (options.from) {\n\t\tparams.set('from', options.from);\n\t}\n\tif (options.to) {\n\t\tparams.set('to', options.to);\n\t}\n\tif (options.title) {\n\t\tparams.set('title', options.title);\n\t}\n\tif (options.confirm) {\n\t\tparams.set('confirm', '1');\n\t}\n\tif (options.verbose) {\n\t\tparams.set('verbose', '1');\n\t}\n\n\topenWorkspace({ workspacePath: resolvedWorkspacePath, ide, verbose: options.verbose });\n\n\tlet lastFailure = '';\n\tfor (const launcher of getLaunchers(params.toString(), ide)) {\n\t\tlogVerbose(options.verbose, `Launching deep link: ${formatCommand(launcher.command, launcher.args)}`);\n\t\tconst result = spawnSync(launcher.command, launcher.args, { stdio: 'inherit' });\n\t\tconst launchError = result.error as NodeJS.ErrnoException | undefined;\n\n\t\tif (launchError) {\n\t\t\tif (launchError.code === 'ENOENT') {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tlastFailure = `${launcher.command}: ${launchError.message}`;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (result.status === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tlastFailure = `${launcher.command} exited with status ${result.status}`;\n\t}\n\n\tprocess.stderr.write(\n\t\t`Failed to open IDE for ${EXTENSION_ID}. ${lastFailure || 'No supported launcher was found.'}\\n`,\n\t);\n\tprocess.exitCode = 1;\n}\n\nasync function launchStandaloneTimeline(options: ReturnType<typeof parseTimelineArgs>): Promise<void> {\n\tif (!options.filePath) {\n\t\tthrow new Error(`Missing file path for standalone timeline\\n\\n${usage()}`);\n\t}\n\n\tconst workspacePath = path.resolve(\n\t\toptions.workspacePath || (path.isAbsolute(options.filePath) ? path.dirname(options.filePath) : process.cwd()),\n\t);\n\tconst absoluteFilePath = path.isAbsolute(options.filePath)\n\t\t? path.resolve(options.filePath)\n\t\t: path.resolve(workspacePath, options.filePath);\n\n\tif (!fsSync.existsSync(absoluteFilePath)) {\n\t\tthrow new Error(`File not found: ${absoluteFilePath}`);\n\t}\n\n\tif (options.json) {\n\t\tconst { createCommandRunner } = await import('./extension/command-runner.ts');\n\t\tconst { createTimelineService } = await import('./extension/timeline-service.ts');\n\t\tconst { buildTimelineJsonSummary } = await import('./cli/timeline-json.ts');\n\t\tconst runner = createCommandRunner({});\n\t\tconst service = createTimelineService({ runner });\n\t\tconst session = await service.buildSession({\n\t\t\tworkspacePath,\n\t\t\tabsolutePath: absoluteFilePath,\n\t\t});\n\t\tconst summary = buildTimelineJsonSummary({\n\t\t\tbackend: session.backend,\n\t\t\trelativePath: session.relativePath,\n\t\t\tworkspacePath: session.workspacePath,\n\t\t\tentries: session.entries,\n\t\t});\n\t\tprocess.stdout.write(`${JSON.stringify(summary, null, 2)}\\n`);\n\t\treturn;\n\t}\n\n\tconst { startStandaloneTimelineServer } = await import('./standalone/server.ts');\n\tconst server = await startStandaloneTimelineServer({\n\t\tworkspacePath,\n\t\tfilePath: absoluteFilePath,\n\t\topenBrowser: options.open,\n\t\tport: options.port,\n\t\tverbose: options.verbose,\n\t});\n\n\tprocess.stderr.write(`Standalone timeline available at ${server.url}\\n`);\n\n\tconst shutdown = () => {\n\t\tvoid server.close().finally(() => {\n\t\t\tprocess.exit(0);\n\t\t});\n\t};\n\n\tprocess.once('SIGINT', shutdown);\n\tprocess.once('SIGTERM', shutdown);\n}\n\nfunction openWorkspace(args: { workspacePath: string; ide: ReturnType<typeof resolveIde>; verbose: boolean }): void {\n\tconst commandArgs = ['-r', args.workspacePath];\n\tlogVerbose(args.verbose, `Opening workspace: ${formatCommand(args.ide.command, commandArgs)}`);\n\tconst result = spawnSync(args.ide.command, commandArgs, { stdio: 'ignore' });\n\tconst launchError = result.error as NodeJS.ErrnoException | undefined;\n\n\tif (launchError && launchError.code !== 'ENOENT') {\n\t\tprocess.stderr.write(`Warning: failed to focus workspace via ${args.ide.command}: ${launchError.message}\\n`);\n\t}\n}\n"],"mappings":"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"}

package/dist/cli/options.cjs

@@ -0,0 +1,376 @@
+const require_constants = require("../extension/constants.cjs");
+//#region src/cli/options.ts
+const URI_PATH = "/open-range-multi-diff";
+const DEFAULT_IDE = "code";
+const idePresets = {
+	code: {
+		command: process.env.VSCODE_BIN || "code",
+		schemes: ["vscode", "vscode-insiders"]
+	},
+	vscode: {
+		command: process.env.VSCODE_BIN || "code",
+		schemes: ["vscode", "vscode-insiders"]
+	},
+	"code-insiders": {
+		command: "code-insiders",
+		schemes: ["vscode-insiders"]
+	},
+	"vscode-insiders": {
+		command: "code-insiders",
+		schemes: ["vscode-insiders"]
+	},
+	cursor: {
+		command: "cursor",
+		schemes: ["cursor"]
+	},
+	"cursor-insiders": {
+		command: "cursor-insiders",
+		schemes: ["cursor-insiders", "cursor"]
+	},
+	zed: {
+		command: "zed",
+		schemes: ["zed"]
+	},
+	windsurf: {
+		command: "windsurf",
+		schemes: ["windsurf"]
+	},
+	codium: {
+		command: "codium",
+		schemes: ["vscodium", "vscode"]
+	}
+};
+function resolveCliInvocation(argv) {
+	const [command, ...rest] = argv;
+	if (command === "timeline" || command === "webview") return {
+		command: "timeline",
+		argv: rest
+	};
+	if (command === "diff") return {
+		command: "range-diff",
+		argv: rest
+	};
+	return {
+		command: "range-diff",
+		argv
+	};
+}
+function parseRangeDiffArgs(argv) {
+	const options = {
+		help: false,
+		confirm: false,
+		from: void 0,
+		ide: process.env.JJ_PLUS_IDE || void 0,
+		to: void 0,
+		title: void 0,
+		verbose: false,
+		workspacePath: void 0
+	};
+	for (let index = 0; index < argv.length; index += 1) {
+		const arg = argv[index];
+		if (arg === "-h" || arg === "--help") {
+			options.help = true;
+			continue;
+		}
+		if (arg === "--confirm") {
+			options.confirm = true;
+			continue;
+		}
+		if (arg === "-v" || arg === "--verbose") {
+			options.verbose = true;
+			continue;
+		}
+		if (arg === "-f" || arg === "--from" || arg === "-b" || arg === "--base") {
+			options.from = requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--from=")) {
+			options.from = requireValue({
+				flag: "--from",
+				value: arg.slice(7)
+			});
+			continue;
+		}
+		if (arg.startsWith("--base=")) {
+			options.from = requireValue({
+				flag: "--base",
+				value: arg.slice(7)
+			});
+			continue;
+		}
+		if (arg === "-t" || arg === "--to" || arg === "--target") {
+			options.to = requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--to=")) {
+			options.to = requireValue({
+				flag: "--to",
+				value: arg.slice(5)
+			});
+			continue;
+		}
+		if (arg.startsWith("--target=")) {
+			options.to = requireValue({
+				flag: "--target",
+				value: arg.slice(9)
+			});
+			continue;
+		}
+		if (arg === "--title") {
+			options.title = requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--title=")) {
+			options.title = requireValue({
+				flag: "--title",
+				value: arg.slice(8)
+			});
+			continue;
+		}
+		if (arg === "--ide") {
+			options.ide = requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--ide=")) {
+			options.ide = requireValue({
+				flag: "--ide",
+				value: arg.slice(6)
+			});
+			continue;
+		}
+		if (arg === "-w" || arg === "--workspace" || arg === "--workspace-path") {
+			options.workspacePath = requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--workspace=")) {
+			options.workspacePath = requireValue({
+				flag: "--workspace",
+				value: arg.slice(12)
+			});
+			continue;
+		}
+		if (arg.startsWith("--workspace-path=")) {
+			options.workspacePath = requireValue({
+				flag: "--workspace-path",
+				value: arg.slice(17)
+			});
+			continue;
+		}
+		throw new Error(`Unknown argument: ${arg}\n\n${usage()}`);
+	}
+	return options;
+}
+function parseTimelineArgs(argv) {
+	const options = {
+		help: false,
+		filePath: void 0,
+		open: true,
+		json: false,
+		port: 0,
+		verbose: false,
+		workspacePath: void 0
+	};
+	for (let index = 0; index < argv.length; index += 1) {
+		const arg = argv[index];
+		if (arg === "-h" || arg === "--help") {
+			options.help = true;
+			continue;
+		}
+		if (arg === "--json") {
+			options.json = true;
+			options.open = false;
+			continue;
+		}
+		if (arg === "--no-open") {
+			options.open = false;
+			continue;
+		}
+		if (arg === "-v" || arg === "--verbose") {
+			options.verbose = true;
+			continue;
+		}
+		if (arg === "-f" || arg === "--file") {
+			options.filePath = requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--file=")) {
+			options.filePath = requireValue({
+				flag: "--file",
+				value: arg.slice(7)
+			});
+			continue;
+		}
+		if (arg === "--port") {
+			options.port = parsePort(requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			}));
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--port=")) {
+			options.port = parsePort(requireValue({
+				flag: "--port",
+				value: arg.slice(7)
+			}));
+			continue;
+		}
+		if (arg === "-w" || arg === "--workspace" || arg === "--workspace-path") {
+			options.workspacePath = requireValue({
+				flag: arg,
+				value: argv[index + 1]
+			});
+			index += 1;
+			continue;
+		}
+		if (arg.startsWith("--workspace=")) {
+			options.workspacePath = requireValue({
+				flag: "--workspace",
+				value: arg.slice(12)
+			});
+			continue;
+		}
+		if (arg.startsWith("--workspace-path=")) {
+			options.workspacePath = requireValue({
+				flag: "--workspace-path",
+				value: arg.slice(17)
+			});
+			continue;
+		}
+		if (arg.startsWith("-")) throw new Error(`Unknown argument: ${arg}\n\n${usage()}`);
+		if (!options.filePath) {
+			options.filePath = arg;
+			continue;
+		}
+		throw new Error(`Unexpected positional argument: ${arg}\n\n${usage()}`);
+	}
+	return options;
+}
+function resolveIde(rawIde) {
+	const trimmed = rawIde?.trim() || DEFAULT_IDE;
+	const preset = idePresets[trimmed.toLowerCase()];
+	if (preset) return preset;
+	return {
+		command: trimmed,
+		schemes: [trimmed]
+	};
+}
+function getLaunchers(query, ide) {
+	const uris = ide.schemes.map((scheme) => buildUri({
+		scheme,
+		query
+	}));
+	if (process.platform === "darwin") return uris.map((uri) => ({
+		command: "open",
+		args: [uri]
+	}));
+	if (process.platform === "win32") return uris.map((uri) => ({
+		command: "cmd",
+		args: [
+			"/c",
+			"start",
+			"",
+			uri
+		]
+	}));
+	return uris.map((uri) => ({
+		command: "xdg-open",
+		args: [uri]
+	}));
+}
+function logVerbose(enabled, message) {
+	if (!enabled) return;
+	process.stderr.write(`${message}\n`);
+}
+function formatCommand(command, args) {
+	return [command, ...args].map(quoteShellArg).join(" ");
+}
+function usage() {
+	return [
+		"Usage:",
+		"  jj-plus [options]",
+		"  jj-plus diff [options]",
+		"  jj-plus timeline [options] <file>",
+		"",
+		"Commands:",
+		"  diff                          Explicit alias for the default range diff deep-link flow",
+		"  timeline <file>               Open the timeline webview in the default browser",
+		"  webview <file>                Alias for timeline",
+		"",
+		"Range Diff Options:",
+		"      --confirm                    Prompt before opening when launched from the CLI",
+		"  -f, --from <revset>              From change id or revset",
+		"      --ide <name>                 IDE preset or command (default: code)",
+		"  -t, --to <revset>                To change id or revset",
+		"      --base <revset>              Alias for --from",
+		"      --target <revset>            Alias for --to",
+		"      --title <title>              Override the tab title",
+		"  -v, --verbose                    Log launches and show extra diagnostics",
+		"  -w, --workspace <path>           Workspace path to resolve in VS Code",
+		"      --workspace-path <path>      Alias for --workspace",
+		"",
+		"Standalone Timeline Options:",
+		"  -f, --file <path>                File path inside the workspace (or absolute path)",
+		"      --json                       Print timeline metadata JSON to stdout (implies --no-open)",
+		"      --no-open                    Start the local server without opening the browser",
+		"      --port <port>                Preferred local port (default: random free port)",
+		"  -w, --workspace <path>           Workspace path containing the file (default: cwd)",
+		"      --workspace-path <path>      Alias for --workspace",
+		"  -h, --help                       Show this help message",
+		"",
+		"Environment:",
+		"      JJ_PLUS_IDE  Default IDE preset or command for the VS Code deep-link flow"
+	].join("\n");
+}
+function parsePort(value) {
+	const port = Number.parseInt(value, 10);
+	if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error(`Invalid port: ${value}\n\n${usage()}`);
+	return port;
+}
+function requireValue({ flag, value }) {
+	const trimmed = value?.trim();
+	if (trimmed) return trimmed;
+	throw new Error(`Missing value for ${flag}\n\n${usage()}`);
+}
+function buildUri({ scheme, query }) {
+	return `${scheme}://${require_constants.EXTENSION_ID}${URI_PATH}?${query}`;
+}
+function quoteShellArg(value) {
+	if (/^[a-zA-Z0-9_@./:=+-]+$/u.test(value)) return value;
+	return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+//#endregion
+exports.formatCommand = formatCommand;
+exports.getLaunchers = getLaunchers;
+exports.logVerbose = logVerbose;
+exports.parseRangeDiffArgs = parseRangeDiffArgs;
+exports.parseTimelineArgs = parseTimelineArgs;
+exports.resolveCliInvocation = resolveCliInvocation;
+exports.resolveIde = resolveIde;
+exports.usage = usage;
+
+//# sourceMappingURL=options.cjs.map