@mblua/agentscommander 0.39.0 → 0.40.0

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 +21 -9
  2. package/install.js +68 -56
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -5,11 +5,23 @@
5
5
  When installing through npm, use `-g` so the `agentscommander` command is available from any directory:
6
6
 
7
7
  ```bash
8
- npm install -g @mblua/agentscommander@latest
8
+ npm install -g @mblua/agentscommander
9
9
  ```
10
10
 
11
11
  This installs the current `latest` release. Before installing, follow [Resolve versions and preserve configuration](#resolve-versions-and-preserve-configuration), then [Install and validate](#install-and-validate). Check the supported platforms and requirements below before installing.
12
12
 
13
+ ## Test pre-release builds
14
+
15
+ New builds are published first under the `next` tag. To try one before it becomes the default release:
16
+
17
+ ```bash
18
+ npm install -g @mblua/agentscommander@next
19
+ ```
20
+
21
+ `next` builds are not fully tested and can break. Share feedback in the [#testers Discord channel](https://discord.gg/T4R8RvEFX4).
22
+
23
+ ## npm website install command
24
+
13
25
  The npm website's **Install** sidebar shows the generic local-install command. For the recommended global npm installation, include `-g` as shown above.
14
26
 
15
27
  ## Choosing the npm route
@@ -46,22 +58,22 @@ Before an install, update, or uninstall, resolve and report the exact existing p
46
58
  ```bash
47
59
  npm list -g @mblua/agentscommander --depth=0
48
60
  npm root -g
49
- npm view @mblua/agentscommander@latest version
61
+ npm view @mblua/agentscommander version
50
62
  ```
51
63
 
52
64
  `npm list` reports the installed package version and can exit nonzero when the package is absent. `npm root -g` exits 0 and prints the global `node_modules` directory. Use that root to inspect the installed `@mblua/agentscommander/package.json`, `install.js`, `run.js`, and native file under `bin/`. Correlate the package-manager record and `package.json` version with the install script's version and release URL, the launcher's exact native path, and the corresponding GitHub tag, asset, and checksum. `npm view` reports the selected registry version without installing it. If the local records, independent release evidence, native file, or selected version disagree or cannot be identified exactly, stop before mutation. `agentscommander --version` prints the native CLI version from `v0.31.0` onward; `v0.30.5` and older builds reject that flag, so probe a binary for a self-reported version only after its exact tag proves support.
53
65
 
54
66
  The existing binary's exact resolver determines what must be preserved. The selected package's exact release tag determines post-install behavior. Verify both against the corresponding `v<version>` source tag; do not use `main` as evidence for a published npm package.
55
67
 
56
- ### npm `0.39.0`
68
+ ### npm `0.40.0`
57
69
 
58
- `0.39.0` is the release described by this package. Its installer downloads the `v0.39.0` native release asset and verifies it against `SHASUMS256.txt`. On Windows and Linux it renames the asset to the unsuffixed executable in the package's `bin/` directory. On macOS it downloads the `agentscommander-mac-<arch>.app.tar.gz` bundle, extracts the single `.app` directory into `bin/`, and validates the executable named by the bundle's `CFBundleExecutable`. The launcher spawns that executable and injects no configuration override. A global install also creates the desktop entry points described in [Windows Start Menu shortcut](#windows-start-menu-shortcut), [macOS Launchpad and Spotlight](#macos-launchpad-and-spotlight), and [Linux application menu](#linux-application-menu).
70
+ `0.40.0` is the release described by this package. Its installer downloads the `v0.40.0` native release asset and verifies it against `SHASUMS256.txt`. On Windows and Linux it renames the asset to the unsuffixed executable in the package's `bin/` directory. On macOS it downloads the `agentscommander-mac-<arch>.app.tar.gz` bundle, extracts the single `.app` directory into `bin/`, and validates the executable named by the bundle's `CFBundleExecutable`. The launcher spawns that executable and injects no configuration override. A global install also creates the desktop entry points described in [Windows Start Menu shortcut](#windows-start-menu-shortcut), [macOS Launchpad and Spotlight](#macos-launchpad-and-spotlight), and [Linux application menu](#linux-application-menu).
59
71
 
60
- The `v0.39.0` native resolver selects a non-blank `AGENTSCOMMANDER_CONFIG_DIR` value verbatim when present. Otherwise, the normal unsuffixed npm executable selects the user's home directory plus `.agentscommander`, independently of its install location and build profile. It does not probe an adjacent configuration directory on this route. Suffixed executables use their adjacent `.agentscommander_<suffix>` directory and refuse to start when it is not writable.
72
+ The `v0.40.0` native resolver selects a non-blank `AGENTSCOMMANDER_CONFIG_DIR` value verbatim when present. Otherwise, the normal unsuffixed npm executable selects the user's home directory plus `.agentscommander`, independently of its install location and build profile. It does not probe an adjacent configuration directory on this route. Suffixed executables use their adjacent `.agentscommander_<suffix>` directory and refuse to start when it is not writable.
61
73
 
62
- **Version `0.39.0` keeps the `0.32.0` default location.** Versions `0.31.0` and `0.30.5` normally selected `.agentscommander` beside the native executable under `@mblua/agentscommander/bin/` when that location was writable, with their documented home fallback and refusal rules. None of `0.32.0` through `0.39.0` discovers, copies, moves or migrates any old configuration automatically. Before updating from `0.31.0` or older, identify and back up the old version's active configuration. If you intend to keep using that directory, set `AGENTSCOMMANDER_CONFIG_DIR` to its verified path; otherwise arrange the intended configuration at the new home location separately. Version `0.33.0` dropped the legacy pre-v2 `codingAgentProfiles` settings migration, and later versions keep it removed.
74
+ **Version `0.40.0` keeps the `0.32.0` default location.** Versions `0.31.0` and `0.30.5` normally selected `.agentscommander` beside the native executable under `@mblua/agentscommander/bin/` when that location was writable, with their documented home fallback and refusal rules. None of `0.32.0` through `0.40.0` discovers, copies, moves or migrates any old configuration automatically. Before updating from `0.31.0` or older, identify and back up the old version's active configuration. If you intend to keep using that directory, set `AGENTSCOMMANDER_CONFIG_DIR` to its verified path; otherwise arrange the intended configuration at the new home location separately. Version `0.33.0` dropped the legacy pre-v2 `codingAgentProfiles` settings migration, and later versions keep it removed.
63
75
 
64
- **Version `0.39.0` keeps bounded backups of `settings.json`.** Every successful save archives the bytes it replaced into `settings.backup.1.json` through `settings.backup.5.json` in the same configuration directory, newest in slot 1. These files live beside `settings.json`, so preserve them with it when you move or back up a configuration directory.
76
+ **Version `0.40.0` keeps bounded backups of `settings.json`.** Every successful save archives the bytes it replaced into `settings.backup.1.json` through `settings.backup.5.json` in the same configuration directory, newest in slot 1. These files live beside `settings.json`, so preserve them with it when you move or back up a configuration directory.
65
77
 
66
78
  The older npm `0.30.3` resolver immediately selected an executable-adjacent directory when the parent and stem were available and did not support the configuration override or portable-marker/write-probe rules. npm never published `0.30.4`; that number exists only as a GitHub release. For other versions, inspect `src-tauri/src/config/mod.rs`, `src-tauri/src/config/profile.rs`, `npm/run.js`, and `npm/install.js` at the exact `v<version>` tag.
67
79
 
@@ -72,7 +84,7 @@ Copy the complete persistent configuration directory to a user-controlled backup
72
84
  ## Install and validate
73
85
 
74
86
  ```bash
75
- npm install -g @mblua/agentscommander@latest
87
+ npm install -g @mblua/agentscommander
76
88
  ```
77
89
 
78
90
  The command installs the current `latest` release and exits 0 on success. The package's install script downloads that package version's raw asset and `SHASUMS256.txt` from `mblua/AgentsCommander`, computes SHA-256, and fails the install on a missing record or mismatch. This does not protect against compromise of the publisher or repository account because the asset and checksum share that trust boundary.
@@ -84,7 +96,7 @@ npm list -g @mblua/agentscommander --depth=0
84
96
  agentscommander --help
85
97
  ```
86
98
 
87
- Both commands must exit 0. Confirm that `npm list` and the installed `package.json` report the `latest` version that `npm view @mblua/agentscommander@latest version` returned; re-check the installed scripts, native path, and checksum correlation described above. `--help` must print the AgentsCommander command help, and on `0.31.0` or newer `agentscommander --version` must print the same version `npm list` reports. The npm package is `@mblua/agentscommander`; the installed command is `agentscommander`.
99
+ Both commands must exit 0. Confirm that `npm list` and the installed `package.json` report the `latest` version that `npm view @mblua/agentscommander version` returned; re-check the installed scripts, native path, and checksum correlation described above. `--help` must print the AgentsCommander command help, and on `0.31.0` or newer `agentscommander --version` must print the same version `npm list` reports. The npm package is `@mblua/agentscommander`; the installed command is `agentscommander`.
88
100
 
89
101
  ### Windows Start Menu shortcut
90
102
 
package/install.js CHANGED
@@ -9,7 +9,7 @@ const { createStartMenuShortcut } = require('./windows-shortcut');
9
9
  const { createLaunchpadAlias } = require('./macos-alias');
10
10
  const { createDesktopEntry } = require('./linux-desktop-entry');
11
11
 
12
- const VERSION = "0.39.0"; // Must match package.json
12
+ const VERSION = "0.40.0"; // Must match package.json
13
13
  const OWNER = 'mblua';
14
14
  const REPO = 'AgentsCommander';
15
15
 
@@ -104,11 +104,74 @@ async function verifyChecksum(filePath, fileName, expectedShasums) {
104
104
  });
105
105
  }
106
106
 
107
+ function installMacBundle() {
108
+ console.log('Extracting macOS bundle...');
109
+ const extractTmpDir = path.join(binDir, 'tmp-extract');
110
+ if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
111
+ fs.mkdirSync(extractTmpDir, { recursive: true });
112
+ try {
113
+ execSync(`tar -xzf "${tmpPath}" -C "${extractTmpDir}"`);
114
+ const extractedFiles = fs.readdirSync(extractTmpDir);
115
+ for (const file of extractedFiles) {
116
+ const dest = path.join(binDir, file);
117
+ if (fs.existsSync(dest)) fs.rmSync(dest, { recursive: true, force: true });
118
+ fs.renameSync(path.join(extractTmpDir, file), dest);
119
+ }
120
+ } finally {
121
+ if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
122
+ }
123
+ fs.unlinkSync(tmpPath);
124
+ const macBinPath = assertExecutable('darwin', binDir);
125
+ // <bundle>.app/Contents/MacOS/<exe> -> <bundle>.app
126
+ const bundlePath = path.dirname(path.dirname(path.dirname(macBinPath)));
127
+ try {
128
+ const alias = createLaunchpadAlias(bundlePath, { platform });
129
+ if (alias.created) {
130
+ console.log(`Launchpad alias created: ${alias.path}`);
131
+ console.log('The app bundle is not signed, so macOS may block the first launch. Do not bypass Gatekeeper: report the block at https://github.com/mblua/AgentsCommander/issues');
132
+ }
133
+ } catch (err) {
134
+ console.warn(`Warning: Launchpad alias not created: ${err.message}`);
135
+ }
136
+ }
137
+
138
+ function createPlatformShortcut(finalBinPath) {
139
+ if (platform === 'win32') {
140
+ try {
141
+ const shortcut = createStartMenuShortcut(finalBinPath);
142
+ if (shortcut.created) console.log(`Start Menu shortcut created: ${shortcut.path}`);
143
+ } catch (err) {
144
+ console.warn(`Warning: Start Menu shortcut not created: ${err.message}`);
145
+ }
146
+ }
147
+ if (platform === 'linux') {
148
+ try {
149
+ const entry = createDesktopEntry(finalBinPath, { platform });
150
+ if (entry.created) console.log(`Application menu entry created: ${entry.path}`);
151
+ } catch (err) {
152
+ console.warn(`Warning: application menu entry not created: ${err.message}`);
153
+ }
154
+ }
155
+ }
156
+
157
+ function installBinary() {
158
+ const finalBinPath = path.join(binDir, platform === 'win32' ? 'agentscommander.exe' : 'agentscommander');
159
+ if (platform !== 'win32') {
160
+ fs.chmodSync(tmpPath, 0o755);
161
+ }
162
+ fs.renameSync(tmpPath, finalBinPath);
163
+ createPlatformShortcut(finalBinPath);
164
+ }
165
+
166
+ function cleanupFailedInstall(shasumTmpPath) {
167
+ if (fs.existsSync(tmpPath)) fs.unlinkSync(tmpPath);
168
+ if (typeof shasumTmpPath !== 'undefined' && fs.existsSync(shasumTmpPath)) fs.unlinkSync(shasumTmpPath);
169
+ }
170
+
107
171
  async function main() {
108
172
  const shasumTmpPath = path.join(binDir, 'SHASUMS256.txt.tmp');
109
173
  try {
110
174
  console.log(`Downloading SHASUMS256.txt from ${shasumUrl}`);
111
- // moved to top
112
175
  await downloadFile(shasumUrl, shasumTmpPath);
113
176
  const expectedShasums = fs.readFileSync(shasumTmpPath, 'utf8');
114
177
 
@@ -119,65 +182,14 @@ async function main() {
119
182
  await verifyChecksum(tmpPath, assetName, expectedShasums);
120
183
  console.log('Checksum verified.');
121
184
 
122
- if (platform === 'darwin') {
123
- console.log('Extracting macOS bundle...');
124
- const extractTmpDir = path.join(binDir, 'tmp-extract');
125
- if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
126
- fs.mkdirSync(extractTmpDir, { recursive: true });
127
- try {
128
- execSync(`tar -xzf "${tmpPath}" -C "${extractTmpDir}"`);
129
- const extractedFiles = fs.readdirSync(extractTmpDir);
130
- for (const file of extractedFiles) {
131
- const dest = path.join(binDir, file);
132
- if (fs.existsSync(dest)) fs.rmSync(dest, { recursive: true, force: true });
133
- fs.renameSync(path.join(extractTmpDir, file), dest);
134
- }
135
- } finally {
136
- if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
137
- }
138
- fs.unlinkSync(tmpPath);
139
- const macBinPath = assertExecutable('darwin', binDir);
140
- // <bundle>.app/Contents/MacOS/<exe> -> <bundle>.app
141
- const bundlePath = path.dirname(path.dirname(path.dirname(macBinPath)));
142
- try {
143
- const alias = createLaunchpadAlias(bundlePath, { platform });
144
- if (alias.created) {
145
- console.log(`Launchpad alias created: ${alias.path}`);
146
- console.log('The app bundle is not signed, so macOS may block the first launch. Do not bypass Gatekeeper: report the block at https://github.com/mblua/AgentsCommander/issues');
147
- }
148
- } catch (err) {
149
- console.warn(`Warning: Launchpad alias not created: ${err.message}`);
150
- }
151
- } else {
152
- const finalBinPath = path.join(binDir, platform === 'win32' ? 'agentscommander.exe' : 'agentscommander');
153
- if (platform !== 'win32') {
154
- fs.chmodSync(tmpPath, 0o755);
155
- }
156
- fs.renameSync(tmpPath, finalBinPath);
157
- if (platform === 'win32') {
158
- try {
159
- const shortcut = createStartMenuShortcut(finalBinPath);
160
- if (shortcut.created) console.log(`Start Menu shortcut created: ${shortcut.path}`);
161
- } catch (err) {
162
- console.warn(`Warning: Start Menu shortcut not created: ${err.message}`);
163
- }
164
- }
165
- if (platform === 'linux') {
166
- try {
167
- const entry = createDesktopEntry(finalBinPath, { platform });
168
- if (entry.created) console.log(`Application menu entry created: ${entry.path}`);
169
- } catch (err) {
170
- console.warn(`Warning: application menu entry not created: ${err.message}`);
171
- }
172
- }
173
- }
185
+ if (platform === 'darwin') installMacBundle();
186
+ else installBinary();
174
187
 
175
188
  fs.unlinkSync(shasumTmpPath);
176
189
  console.log('Installation completed successfully.');
177
190
  } catch (err) {
178
191
  console.error('Installation failed:', err.message);
179
- if (fs.existsSync(tmpPath)) fs.unlinkSync(tmpPath);
180
- if (typeof shasumTmpPath !== 'undefined' && fs.existsSync(shasumTmpPath)) fs.unlinkSync(shasumTmpPath);
192
+ cleanupFailedInstall(shasumTmpPath);
181
193
  process.exit(1);
182
194
  }
183
195
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mblua/agentscommander",
3
- "version": "0.39.0",
3
+ "version": "0.40.0",
4
4
  "description": "Install and run AgentsCommander, the local terminal session manager for AI coding agent teams with Claude Code, Codex, Hermes, Cursor CLI, OpenCode, and more to come.",
5
5
  "license": "MIT",
6
6
  "bin": {