@arjunkhera/atlas 0.4.55 → 0.4.56

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "atlas",
-  "version": "0.4.55",
+  "version": "0.4.56",
   "description": "Atlas: the delivery lifecycle, its crews and the Atlas tools, for any repository.",
   "author": {
     "name": "Arjun Khera"

package/door/lib/install.mjs

@@ -6,7 +6,11 @@
 // The catalog is one folder on the Mac, ~/.atlas/catalog. It holds one entry
 // that pins an exact npm version, so nothing moves Atlas to another version
 // without `atlas upgrade`. The installer writes that one file and asks Claude
-// Code to add the catalog and install the plugin. It writes no settings file.
+// Code to add the catalog and install the plugin. On a Mac it writes no
+// settings file. With --cloud it also sets one key, env.MCP_TIMEOUT, in the
+// user settings file, so the tools server has time for the refresh at
+// session start (item ade7d96a, decision c71facc9; the owner asked on
+// 7 November 2026 to make it the same for every project).
 import { execFileSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
@@ -32,6 +36,35 @@ export function repoOf(packageRoot) {
 export const catalogDir = (env) => join(env.HOME, '.atlas', 'catalog');
 export const catalogFile = (env) => join(catalogDir(env), '.claude-plugin', 'marketplace.json');
 
+// The start time that a cloud setup gives each tools server, in ms. Claude
+// Code reads MCP_TIMEOUT from the env block of its user settings file too
+// (probe of 7 November 2026: a server that starts in 40 s failed with no
+// value and served its tool with this one).
+export const CLOUD_MCP_TIMEOUT = '90000';
+export const userSettingsFile = (env) => join(env.CLAUDE_CONFIG_DIR || join(env.HOME, '.claude'), 'settings.json');
+
+// What a cloud install does to the user settings file. It adds the key only
+// when no value is set, here or in the environment, and it never rewrites a
+// file it cannot read.
+export function cloudTimeout(env) {
+  const file = userSettingsFile(env);
+  if (env.MCP_TIMEOUT) return { file, state: 'environment' };
+  let settings = {};
+  if (existsSync(file)) {
+    try { settings = JSON.parse(readFileSync(file, 'utf8')); } catch { return { file, state: 'unreadable' }; }
+    if (!settings || typeof settings !== 'object' || Array.isArray(settings)) return { file, state: 'unreadable' };
+  }
+  if (settings.env && (typeof settings.env !== 'object' || Array.isArray(settings.env))) return { file, state: 'unreadable' };
+  if (settings.env?.MCP_TIMEOUT !== undefined) return { file, state: 'set' };
+  return { file, state: 'add', text: `${JSON.stringify({ ...settings, env: { ...(settings.env ?? {}), MCP_TIMEOUT: CLOUD_MCP_TIMEOUT } }, null, 2)}\n` };
+}
+const TIMEOUT_NOTE = {
+  add: 'adds env.MCP_TIMEOUT = "90000", the start time for the refresh',
+  set: 'unchanged: it already sets env.MCP_TIMEOUT',
+  environment: 'unchanged: the environment sets MCP_TIMEOUT',
+  unreadable: 'unchanged: the file is not a settings object, so Atlas does not touch it',
+};
+
 // The one file the installer writes. `local` puts a copy of the package inside
 // the catalog instead of naming npm; CI and a development Mac use it.
 export function catalogFor({ name, version, local = false }) {
@@ -105,6 +138,7 @@ export async function install({ packageRoot, options = {}, line = console.log, e
   const file = catalogFile(env);
   const before = existsSync(file) ? readFileSync(file, 'utf8') : null;
   const after = `${JSON.stringify(catalog, null, 2)}\n`;
+  const timeout = options.cloud ? cloudTimeout(env) : null;
 
   line(`Install Atlas ${version} for every folder on this Mac.`);
   line('');
@@ -114,6 +148,7 @@ export async function install({ packageRoot, options = {}, line = console.log, e
     `write ${file}   (${before === null ? 'new file' : before === after ? 'unchanged' : 'changed'}; it pins ${local ? 'a local copy' : `exactly ${version}`})`,
     `claude plugin marketplace add ${catalogDir(env)}`,
     `claude plugin install ${PLUGIN_ID} --scope user`,
+    timeout ? `write ${timeout.file}   (${TIMEOUT_NOTE[timeout.state]})` : null,
     'atlas doctor',
   ].filter(Boolean);
   steps.forEach((step, index) => line(`  ${index + 1}. ${step}`));
@@ -121,7 +156,7 @@ export async function install({ packageRoot, options = {}, line = console.log, e
   line('Claude Code itself then writes two keys into ~/.claude/settings.json, and nothing else:');
   line(`  extraKnownMarketplaces.${CATALOG_NAME}   (the catalog folder)`);
   line(`  enabledPlugins["${PLUGIN_ID}"] = true`);
-  line('This command writes no settings file of its own.');
+  line(timeout ? 'With --cloud, this command writes only the MCP_TIMEOUT key named above into a settings file.' : 'This command writes no settings file of its own.');
   if (before !== null && before !== after) { line(''); line('The catalog file changes from:'); line(before); line('to:'); line(after); }
   if (!options.yes && !(await ask('Go ahead?'))) { line('Nothing was changed.'); return 1; }
 
@@ -140,6 +175,10 @@ export async function install({ packageRoot, options = {}, line = console.log, e
   exec('claude', hasCatalog ? ['plugin', 'marketplace', 'update', CATALOG_NAME] : ['plugin', 'marketplace', 'add', catalogDir(env)]);
   const installArgs = ['plugin', 'install', PLUGIN_ID, '--scope', 'user'];
   exec('claude', installArgs);
+  if (timeout?.state === 'add') {
+    mkdirSync(join(timeout.file, '..'), { recursive: true });
+    writeFileSync(timeout.file, timeout.text);
+  }
   line('');
   // A cloud setup script runs before any session: the key comes from the
   // environment variable, and no tools server has started yet (item 92cfbba3).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arjunkhera/atlas",
-  "version": "0.4.55",
+  "version": "0.4.56",
   "description": "Atlas: the delivery lifecycle, its crews and the Atlas tools, as a Claude Code plugin for any repository.",
   "type": "module",
   "license": "UNLICENSED",