overlord-cli 0.2606021930.0 → 0.2606041130.1

package/bin/_cli/launcher.mjs

@@ -17,6 +17,21 @@ import { runAttachCommand } from './attach.mjs';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PACKAGE_CLAUDE_PLUGIN_DIR = path.resolve(__dirname, '..', '..', 'plugins', 'claude');
 const REPO_CLAUDE_PLUGIN_DIR = path.resolve(__dirname, '..', '..', '..', '..', 'plugins', 'claude');
+const CLAUDE_PLUGIN_CACHE_DIR = path.join(
+  os.homedir(),
+  '.claude',
+  'plugins',
+  'cache',
+  'overlord-local',
+  'overlord'
+);
+const CLAUDE_INSTALLED_PLUGINS_FILE = path.join(
+  os.homedir(),
+  '.claude',
+  'plugins',
+  'installed_plugins.json'
+);
+const CLAUDE_INSTALLED_PLUGIN_KEY = 'overlord@overlord-local';
 
 function resolveLaunchScratchDir(workingDirectory, { explicit = false } = {}) {
   const trimmed = typeof workingDirectory === 'string' ? workingDirectory.trim() : '';
@@ -41,12 +56,84 @@ function withLaunchTempEnv(baseEnv, scratchDir) {
   };
 }
 
+function contextFileTag(ticketId) {
+  const safeTicket = String(ticketId ?? 'ticket').replace(/[^a-zA-Z0-9._-]+/g, '-');
+  return `overlord-${safeTicket}-${Date.now()}-${crypto.randomUUID().slice(0, 8)}`;
+}
+
+function writeLaunchContextFile(scratchDir, ticketId, context) {
+  const contextFile = path.join(scratchDir, `${contextFileTag(ticketId)}-context.md`);
+  fs.mkdirSync(path.dirname(contextFile), { recursive: true });
+  fs.writeFileSync(contextFile, context, 'utf-8');
+  setTimeout(() => {
+    try {
+      fs.unlinkSync(contextFile);
+    } catch {
+      // Best-effort cleanup only.
+    }
+  }, 30 * 60_000).unref();
+  return contextFile;
+}
+
+function buildContextFilePrompt(contextFile, startPrompt) {
+  return `${startPrompt}\n\nRead the Overlord launch context from ${contextFile} before taking action. Follow the ticket workflow and objective described in that file.`;
+}
+
 function claudeSourcePluginDir() {
   if (fs.existsSync(PACKAGE_CLAUDE_PLUGIN_DIR)) return PACKAGE_CLAUDE_PLUGIN_DIR;
   if (fs.existsSync(REPO_CLAUDE_PLUGIN_DIR)) return REPO_CLAUDE_PLUGIN_DIR;
   return null;
 }
 
+function readJsonFile(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function claudeInstalledPluginDir() {
+  const installed = readJsonFile(CLAUDE_INSTALLED_PLUGINS_FILE);
+  const pluginEntries = installed?.plugins?.[CLAUDE_INSTALLED_PLUGIN_KEY];
+
+  if (Array.isArray(pluginEntries)) {
+    for (const entry of pluginEntries) {
+      const installPath = typeof entry?.installPath === 'string' ? entry.installPath.trim() : '';
+      if (installPath && fs.existsSync(path.join(installPath, '.claude-plugin', 'plugin.json'))) {
+        return installPath;
+      }
+    }
+  }
+
+  if (!fs.existsSync(CLAUDE_PLUGIN_CACHE_DIR)) return null;
+
+  const versionDirs = fs
+    .readdirSync(CLAUDE_PLUGIN_CACHE_DIR, { withFileTypes: true })
+    .filter(entry => entry.isDirectory())
+    .map(entry => path.join(CLAUDE_PLUGIN_CACHE_DIR, entry.name))
+    .filter(candidate => fs.existsSync(path.join(candidate, '.claude-plugin', 'plugin.json')))
+    .sort()
+    .reverse();
+
+  return versionDirs[0] ?? null;
+}
+
+function envTruthy(value) {
+  return /^(1|true|yes|on)$/i.test(String(value ?? '').trim());
+}
+
+function claudeLaunchPluginDir() {
+  const explicitPluginDir = process.env.OVERLORD_CLAUDE_PLUGIN_DIR?.trim();
+  if (explicitPluginDir) return explicitPluginDir;
+
+  if (envTruthy(process.env.OVERLORD_USE_CLAUDE_SOURCE_PLUGIN)) {
+    return claudeSourcePluginDir();
+  }
+
+  return null;
+}
+
 function antigravityBundleInstalled() {
   return fs.existsSync(
     path.join(os.homedir(), '.gemini', 'antigravity-cli', 'plugins', 'plugin.json')
@@ -55,7 +142,7 @@ function antigravityBundleInstalled() {
 
 function getInstructionMode(agent) {
   if (agent === 'claude') {
-    return claudeSourcePluginDir() ? 'bundle' : 'legacy';
+    return claudeInstalledPluginDir() || claudeLaunchPluginDir() ? 'bundle' : 'legacy';
   }
 
   if (agent === 'codex') {
@@ -397,8 +484,9 @@ async function runAgent(agent, mode = 'run', options = {}) {
     process.chdir(options.workingDirectory);
   }
 
+  const useMountedProjectScratch = Boolean(options.workingDirectory || options.preCommand?.trim());
   const scratchDir = resolveLaunchScratchDir(options.workingDirectory, {
-    explicit: Boolean(options.workingDirectory)
+    explicit: useMountedProjectScratch
   });
 
   const launchOrganizationId = resolveLaunchOrganizationId(
@@ -471,24 +559,38 @@ async function runAgent(agent, mode = 'run', options = {}) {
       : {})
   }, scratchDir);
   const extraArgs = buildExtraArgs(agent, options);
+  const useContextFilePrompt = Boolean(options.preCommand?.trim());
+  const launchContextFile = useContextFilePrompt
+    ? writeLaunchContextFile(scratchDir, ticketId, context)
+    : null;
 
   try {
     if (agent === 'claude') {
-      const pluginDir = claudeSourcePluginDir();
+      const pluginDir = claudeLaunchPluginDir();
       if (mode === 'resume') {
         const claudeSessionId = process.env.CLAUDE_SESSION_ID?.trim();
+        const resumePrompt = launchContextFile
+          ? buildContextFilePrompt(launchContextFile, 'Resume working on this Overlord ticket.')
+          : context;
         const args = claudeSessionId
-          ? ['--resume', claudeSessionId, context]
-          : ['--continue', context];
+          ? ['--resume', claudeSessionId, resumePrompt]
+          : ['--continue', resumePrompt];
+        if (launchContextFile) args.unshift('--append-system-prompt-file', launchContextFile);
         args.unshift(...extraArgs);
         if (pluginDir) args.unshift('--plugin-dir', pluginDir);
         execAgentBinary('claude', args, { stdio: 'inherit', env: childEnv }, options.preCommand);
       } else {
+        const startPrompt = launchContextFile
+          ? buildContextFilePrompt(
+              launchContextFile,
+              'Begin working on this ticket.'
+            )
+          : 'Begin working on this ticket. Start by calling the attach endpoint, then proceed with the objective described in your system prompt.';
         const args = [
-          '--append-system-prompt',
-          context,
+          launchContextFile ? '--append-system-prompt-file' : '--append-system-prompt',
+          launchContextFile ?? context,
           ...extraArgs,
-          'Begin working on this ticket. Start by calling the attach endpoint, then proceed with the objective described in your system prompt.'
+          startPrompt
         ];
         if (pluginDir) args.unshift('--plugin-dir', pluginDir);
         execAgentBinary('claude', args, { stdio: 'inherit', env: childEnv }, options.preCommand);
@@ -496,15 +598,23 @@ async function runAgent(agent, mode = 'run', options = {}) {
     } else if (agent === 'codex') {
       if (mode === 'resume') {
         const codexSessionId = process.env.CODEX_SESSION_ID?.trim();
+        const resumePrompt = launchContextFile
+          ? buildContextFilePrompt(launchContextFile, 'Resume working on this Overlord ticket.')
+          : context;
         const args = codexSessionId
-          ? ['resume', codexSessionId, context]
-          : ['resume', '--last', context];
+          ? ['resume', codexSessionId, resumePrompt]
+          : ['resume', '--last', resumePrompt];
         args.splice(1, 0, ...extraArgs);
         execAgentBinary('codex', args, { stdio: 'inherit', env: childEnv }, options.preCommand);
       } else {
         execAgentBinary(
           'codex',
-          [...extraArgs, context],
+          [
+            ...extraArgs,
+            launchContextFile
+              ? buildContextFilePrompt(launchContextFile, 'Begin working on this Overlord ticket.')
+              : context
+          ],
           { stdio: 'inherit', env: childEnv },
           options.preCommand
         );
@@ -512,22 +622,36 @@ async function runAgent(agent, mode = 'run', options = {}) {
     } else if (agent === 'cursor') {
       execAgentBinary(
         'agent',
-        [...extraArgs, context],
+        [
+          ...extraArgs,
+          launchContextFile
+            ? buildContextFilePrompt(launchContextFile, 'Begin working on this Overlord ticket.')
+            : context
+        ],
         { stdio: 'inherit', env: childEnv },
         options.preCommand
       );
     } else if (agent === 'opencode') {
       if (mode === 'resume') {
         const openCodeSessionId = process.env.OPENCODE_SESSION_ID?.trim();
+        const resumePrompt = launchContextFile
+          ? buildContextFilePrompt(launchContextFile, 'Resume working on this Overlord ticket.')
+          : context;
         const args = openCodeSessionId
-          ? ['--continue', '--session', openCodeSessionId, '--prompt', context]
-          : ['--continue', '--prompt', context];
+          ? ['--continue', '--session', openCodeSessionId, '--prompt', resumePrompt]
+          : ['--continue', '--prompt', resumePrompt];
         args.unshift(...extraArgs);
         execAgentBinary('opencode', args, { stdio: 'inherit', env: childEnv }, options.preCommand);
       } else {
         execAgentBinary(
           'opencode',
-          [...extraArgs, '--prompt', context],
+          [
+            ...extraArgs,
+            '--prompt',
+            launchContextFile
+              ? buildContextFilePrompt(launchContextFile, 'Begin working on this Overlord ticket.')
+              : context
+          ],
           { stdio: 'inherit', env: childEnv },
           options.preCommand
         );
@@ -535,24 +659,34 @@ async function runAgent(agent, mode = 'run', options = {}) {
     } else if (agent === 'pi') {
       if (mode === 'resume') {
         const piSessionId = process.env.PI_SESSION_ID?.trim();
+        const resumePrompt = launchContextFile
+          ? buildContextFilePrompt(launchContextFile, 'Resume working on this Overlord ticket.')
+          : context;
         const args = piSessionId
-          ? ['--session', piSessionId, context]
-          : ['--continue', context];
+          ? ['--session', piSessionId, resumePrompt]
+          : ['--continue', resumePrompt];
         args.unshift(...extraArgs);
         execAgentBinary('pi', args, { stdio: 'inherit', env: childEnv }, options.preCommand);
       } else {
         execAgentBinary(
           'pi',
-          [...extraArgs, context],
+          [
+            ...extraArgs,
+            launchContextFile
+              ? buildContextFilePrompt(launchContextFile, 'Begin working on this Overlord ticket.')
+              : context
+          ],
           { stdio: 'inherit', env: childEnv },
           options.preCommand
         );
       }
     } else if (agent === 'antigravity') {
       const tag = `overlord-${ticketId.slice(-8)}-${Date.now()}`;
-      const contextFile = path.join(scratchDir, `${tag}-ctx.md`);
-      fs.writeFileSync(contextFile, context, 'utf-8');
-      setTimeout(() => { try { fs.unlinkSync(contextFile); } catch { /* already gone */ } }, 30 * 60_000).unref();
+      const contextFile = launchContextFile ?? path.join(scratchDir, `${tag}-ctx.md`);
+      if (!launchContextFile) {
+        fs.writeFileSync(contextFile, context, 'utf-8');
+        setTimeout(() => { try { fs.unlinkSync(contextFile); } catch { /* already gone */ } }, 30 * 60_000).unref();
+      }
 
       const agySessionId =
         process.env.AGY_SESSION_ID?.trim() ?? process.env.GEMINI_SESSION_ID?.trim();

package/bin/_cli/setup.mjs

@@ -1138,7 +1138,9 @@ function installClaude() {
   } else {
     console.log('  ✓ No v3.25 Claude connector files needed migration.');
   }
-  console.log('  ✓ `ovld launch claude` now loads this plugin with `claude --plugin-dir`.');
+  console.log(
+    '  ✓ `ovld launch claude` now uses the installed Claude local marketplace plugin by default.'
+  );
 
   const manifest = readManifest();
   manifest.claude = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord-cli",
-  "version": "0.2606021930.0",
+  "version": "0.2606041130.1",
   "description": "Overlord CLI — launch AI agents on tickets from anywhere",
   "homepage": "https://www.ovld.ai/docs/",
   "type": "module",