@davmash/bygone 0.5.2

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## Unreleased
+
+- Added modified-file detection and drill-down for directory comparisons
+- Added prototype three-directory comparison with adjacent multi-panel file drill-down
+
+## 0.2.0
+
+- Added working tree vs `HEAD` as the newest git file history step
+- Added GitHub Actions release checks
+- Added scoped npm packaging and dry-run validation
+- Added desktop app icons for packaged builds
+- Split desktop packaging targets and made macOS DMG packaging the default
+
+## 0.1.0
+
+- Added editable two-way flowing diff rendering
+- Added inline and line-level change highlighting
+- Added git file history navigation with commit-by-commit stepping
+- Added private/pre-release packaging metadata and release documentation
+- Renamed the project from Melden to Bygone and updated the extension id, CLI, and difftool entrypoints
+- Kept the product surface focused on diff and history workflows

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Mashburn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,240 @@
+# Bygone
+
+Bygone is a VS Code extension and standalone desktop app for visual diff and file history.
+
+![Bygone screenshot](./media/bygone-screenshot.png)
+
+## Features
+
+- Editable two-way side-by-side diff view
+- Dynamic adjacent multi-panel diff view
+- Flowing connectors, block contours, and inline change highlighting
+- Git file history viewer with commit-by-commit navigation
+
+## Status
+
+This project is usable as a local or private pre-release VS Code extension. The two-way diff and git history flows are the most complete. The multi-panel view is diff-focused, not a merge tool.
+
+## Migration Note
+
+This project was renamed from `Melden` to `Bygone`.
+
+- VS Code extension id changed from `davidmashburn.melden` to `davidmashburn.bygone`
+- CLI changed from `melden` to `bygone`
+- Git difftool names changed from `melden` / `melden-vscode` to `bygone` / `bygone-vscode`
+- Existing users should reinstall the extension and re-run the difftool setup scripts
+
+## Install For Development
+
+Install dependencies and compile:
+
+```bash
+npm install
+npm run compile
+```
+
+Run the extension in VS Code:
+
+1. Open this folder in VS Code.
+2. Press `F5`.
+3. In the Extension Development Host, run one of the Bygone commands from the Command Palette.
+
+Run the standalone desktop app locally:
+
+```bash
+npm run standalone:start
+```
+
+Run a headless standalone smoke check:
+
+```bash
+npm run standalone:smoke
+```
+
+For development only, you can install the repo-local launcher globally:
+
+```bash
+npm install -g .
+bygone
+bygone path/to/file-or-directory
+bygone --diff path/to/left path/to/right
+bygone --diff path/to/file1 path/to/file2 path/to/file3 [...]
+bygone --dir path/to/left-dir path/to/right-dir
+bygone --diff3 path/to/left path/to/middle path/to/right
+bygone --dir3 path/to/left-dir path/to/middle-dir path/to/right-dir
+bygone --history path/to/file
+bygone --help
+```
+
+CLI defaults:
+
+- `bygone` opens Git directory history for the current directory.
+- `bygone <file>` opens file history.
+- `bygone <directory>` opens Git directory history for that directory.
+- `bygone <left> <right>` auto-selects file diff or directory compare.
+- `bygone --diff <file1> <file2> <file3> ...` opens multi-panel diff.
+
+If the native desktop app is installed, the npm/source launcher prefers it and forwards the shell working directory. Set `BYGONE_FORCE_BUNDLED=1` to force the npm-bundled Electron runtime instead.
+
+The desktop app also includes `Help -> Install Command Line Tools...` for non-npm installs. Homebrew cask installs can provide the `bygone` command automatically.
+
+## Package For External Use
+
+This repo is set up for local/private packaging. A typical release flow is:
+
+```bash
+npm install
+npm test
+npx @vscode/vsce package
+```
+
+That produces a `.vsix` you can install with `Extensions: Install from VSIX...`.
+
+Build the standalone desktop packages:
+
+```bash
+npm install
+npm run package:desktop
+```
+
+That produces a macOS DMG in `dist/`. Cross-target packaging is split out because Windows and Linux builds may need additional Electron downloads or Wine support:
+
+```bash
+npm run package:desktop:mac:zip
+npm run package:desktop:linux
+npm run package:desktop:win
+npm run package:desktop:all
+```
+
+Stage the scoped npm standalone package:
+
+```bash
+npm install
+npm run package:npm
+npm pack --dry-run ./dist/npm-package
+```
+
+The root `package.json` is the VS Code extension manifest and intentionally keeps the unscoped extension name `bygone`. The npm distribution is staged separately as `@davidmashburn/bygone` so the global launcher can avoid the already-taken `bygone` package name while preserving the VS Code extension id `davidmashburn.bygone`.
+
+Homebrew packaging templates live in `packaging/homebrew/`. They are staged for local validation only until release artifact URLs and checksums exist.
+
+Build the full local release artifact matrix:
+
+```bash
+npm run release:build
+```
+
+That runs tests, rebuilds the VSIX, stages and dry-run checks the npm package, builds desktop artifacts, and styles the Homebrew templates. If the local macOS DMG or Windows cross-build toolchain is unavailable, use `node ./scripts/release.mjs --skip-dmg` or `node ./scripts/release.mjs --skip-windows` while validating the rest of the matrix.
+
+Publishing is intentionally explicit:
+
+```bash
+npm run release:publish
+```
+
+`release:publish` publishes the npm package, publishes the VS Code package, creates a GitHub release for desktop artifacts, and updates a Homebrew tap. Set `BYGONE_HOMEBREW_TAP` to a local tap checkout before publishing Homebrew formulas.
+
+Run the release checks:
+
+```bash
+npm run release:check
+npm run standalone:smoke
+```
+
+The standalone smoke check is intentionally run directly because Electron can abort on macOS when launched from a longer nested npm command chain, while the same smoke check passes as a direct release gate.
+
+In the standalone window, you can also drag and drop:
+
+- 1 file to open git history for that file
+- 2 files or directories to open a side-by-side compare
+- 3 or more files to open a multi-panel compare
+- 3 directories to open a three-directory compare
+
+## Git Difftool
+
+Bygone can be launched from `git difftool` through either the standalone app or the VS Code extension.
+
+Configure the standalone launcher:
+
+```bash
+./scripts/configure-git-difftool-standalone.sh
+```
+
+That registers:
+
+```text
+git difftool -t bygone
+```
+
+Configure the VS Code launcher:
+
+```bash
+./scripts/configure-git-difftool.sh
+```
+
+That registers:
+
+```text
+git difftool -t bygone-vscode
+```
+
+The VS Code path launches:
+
+```text
+vscode://davidmashburn.bygone/diff?left=...&right=...
+```
+
+The wrapper scripts are:
+
+```bash
+./scripts/bygone-difftool.sh <left-file> <right-file>
+./scripts/bygone-standalone-difftool.sh <left-file> <right-file>
+```
+
+## Commands
+
+- `Bygone: Compare Files`
+- `Bygone: Compare Directories`
+- `Bygone: Compare Three Directories (Prototype)`
+- `Bygone: Compare Multiple Files`
+- `Bygone: Compare with Selected`
+- `Bygone: Compare Test Files`
+- `Bygone: Compare File History`
+- `Bygone: Compare Active File History`
+
+## Limitations
+
+- Bygone is intentionally diff-focused; merge tooling is not exposed as a product feature.
+- Directory compare supports modified-file detection and file drill-down; deep tree ergonomics are still early.
+- The git history viewer currently steps through single-parent commit history for one file at a time.
+- Marketplace publishing metadata is not finalized yet.
+
+## Release Work
+
+The current release checklist and remaining publication blockers are tracked in [RELEASE_PLAN.md](./RELEASE_PLAN.md).
+
+## Codebase Guide
+
+Architecture and implementation details are documented in [CODEBASE.md](./CODEBASE.md).
+
+## Walkthrough
+
+A screenshot-based walkthrough using Bygone on its own source tree lives in [docs/walkthrough.md](./docs/walkthrough.md).
+
+## Why “Bygone”?
+
+**In short: this project is openly inspired by Meld, and Bygone is meant to carry that visual tradition into a more history-aware tool.**
+
+Meld was a direct inspiration for this project. Its visual diff metaphor is still one of the clearest and most human ways to understand change, and Bygone builds on that lineage while pushing further into revision history.
+
+The name also nods to the bygone era before vibe-coding, when people were at least pretending to read, understand, and take responsibility for the code they were writing. This tool is about looking directly at what changed, where it came from, and how the current state emerged.
+
+And yes, Codex, the irony is noted. Thanks for the assist.
+
+## Tests
+
+Run the current unit checks with:
+
+```bash
+npm test
+```

package/bin/bygone.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const packageJson = require('../package.json');
+
+const args = process.argv.slice(2);
+const cliCwd = process.cwd();
+
+if (args.includes('--help') || args.includes('-h')) {
+    process.stdout.write(`Bygone ${packageJson.version}
+
+Usage:
+  bygone
+  bygone <file-or-directory>
+  bygone <left> <right>
+  bygone --diff <left> <right>
+  bygone --diff <file1> <file2> <file3> [...]
+  bygone --diff3 <left> <middle> <right>
+  bygone --dir <left-dir> <right-dir>
+  bygone --dir3 <left-dir> <middle-dir> <right-dir>
+  bygone --history <file>
+  bygone --dir-history <directory>
+  bygone --test
+
+Notes:
+  - No args opens Git directory history for the current directory.
+  - One positional path opens file history or Git directory history.
+  - Two positional paths auto-select file diff or directory compare.
+  - \`--diff\` accepts 2 or more files; 3+ opens multi-panel diff.
+  - In the standalone app, drop 1 file for history, 2 files/directories for compare, 3+ files for multi-panel diff, or 3 directories for directory compare.
+`);
+    process.exit(0);
+}
+
+if (args.includes('--version') || args.includes('-v')) {
+    process.stdout.write(`${packageJson.version}\n`);
+    process.exit(0);
+}
+
+const packageRoot = path.join(__dirname, '..');
+const electronBinary = process.platform === 'win32'
+    ? '.\\node_modules\\.bin\\electron.cmd'
+    : './node_modules/.bin/electron';
+const appEntry = './out/standalone-main.js';
+const forwardedArgs = ['--cwd', cliCwd, ...args];
+const installedApp = findInstalledApp();
+const preferBundledApp = fs.existsSync(path.join(packageRoot, '.git'));
+
+const child = installedApp && process.env.BYGONE_FORCE_BUNDLED !== '1'
+    && !preferBundledApp
+    ? spawnInstalledApp(installedApp, forwardedArgs)
+    : spawn(electronBinary, [appEntry, ...forwardedArgs], {
+    cwd: packageRoot,
+    stdio: 'inherit'
+});
+
+child.on('exit', (code, signal) => {
+    if (signal) {
+        process.kill(process.pid, signal);
+        return;
+    }
+
+    process.exit(code ?? 0);
+});
+
+function findInstalledApp() {
+    if (process.platform === 'darwin') {
+        const candidates = [
+            '/Applications/Bygone.app',
+            path.join(process.env.HOME || '', 'Applications', 'Bygone.app')
+        ];
+
+        return candidates.find((candidate) => fs.existsSync(candidate));
+    }
+
+    if (process.platform === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA;
+        if (!localAppData) {
+            return undefined;
+        }
+
+        const candidates = [
+            path.join(localAppData, 'Programs', 'Bygone', 'Bygone.exe'),
+            path.join(localAppData, 'Bygone', 'Bygone.exe')
+        ];
+
+        return candidates.find((candidate) => fs.existsSync(candidate));
+    }
+
+    const candidates = [
+        '/opt/Bygone/bygone',
+        '/opt/Bygone/Bygone',
+        '/usr/local/bin/bygone-desktop',
+        path.join(process.env.HOME || '', '.local', 'bin', 'bygone-desktop')
+    ];
+
+    return candidates.find((candidate) => fs.existsSync(candidate));
+}
+
+function spawnInstalledApp(installedApp, launchArgs) {
+    if (process.platform === 'darwin') {
+        return spawn('open', ['-W', installedApp, '--args', ...launchArgs], {
+            stdio: 'inherit'
+        });
+    }
+
+    return spawn(installedApp, launchArgs, {
+        stdio: 'inherit'
+    });
+}