overlord-cli 0.2605160931.0 → 0.2605161310.0

package/bin/_cli/cli-update.mjs

@@ -2,6 +2,9 @@
 
 import { spawnSync } from 'node:child_process';
 import { createRequire } from 'node:module';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
 
 const require = createRequire(import.meta.url);
 const cliPackage = require('../../package.json');
@@ -50,6 +53,41 @@ export async function fetchLatestCliVersion({
   }
 }
 
+function pruneOldCliVersions() {
+  const cliInstallRoot = path.join(os.homedir(), '.ovld', 'cli');
+  if (!fs.existsSync(cliInstallRoot)) return;
+
+  let entries;
+  try {
+    entries = fs.readdirSync(cliInstallRoot);
+  } catch {
+    return;
+  }
+
+  const versionDirs = entries
+    .filter(name => name.startsWith('overlord-cli-'))
+    .flatMap(name => {
+      const dirPath = path.join(cliInstallRoot, name);
+      try {
+        const stat = fs.statSync(dirPath);
+        if (!stat.isDirectory()) return [];
+        return [{ dirPath, mtime: stat.mtimeMs }];
+      } catch {
+        return [];
+      }
+    });
+
+  // Sort newest-first, keep current + 1 previous, delete the rest
+  versionDirs.sort((a, b) => b.mtime - a.mtime);
+  for (const { dirPath } of versionDirs.slice(2)) {
+    try {
+      fs.rmSync(dirPath, { recursive: true, force: true });
+    } catch {
+      // Best-effort cleanup
+    }
+  }
+}
+
 export async function checkForCliUpdate(options = {}) {
   const currentVersion = options.currentVersion ?? CURRENT_CLI_VERSION;
   const latestVersion = await fetchLatestCliVersion(options);
@@ -115,5 +153,7 @@ export async function runCliUpdateCommand({
     logger.log('Overlord CLI update complete. Run `ovld version` to confirm the installed version.');
   }
 
+  pruneOldCliVersions();
+
   return { alreadyLatest: false, currentVersion, latestVersion, result };
 }

package/bin/_cli/protocol.mjs

@@ -1035,6 +1035,42 @@ async function protocolAsk(args) {
   console.log(JSON.stringify(data, null, 2));
 }
 
+// ---------------------------------------------------------------------------
+// request-approval-gate
+// ---------------------------------------------------------------------------
+
+async function protocolRequestApprovalGate(args) {
+  const flags = parseFlags(args);
+  const { sessionKey, ticketId } = resolveSessionFlags(flags);
+  if (!sessionKey) throw new Error('--session-key is required (or set SESSION_KEY)');
+  if (!ticketId) throw new Error('--ticket-id is required (or set TICKET_ID)');
+  const reason = flags['reason-file']
+    ? await readTextFileOrStdin(String(flags['reason-file']), '--reason-file')
+    : requireFlag(flags, 'reason', undefined);
+
+  const { platformUrl, bearerToken, localSecret, organizationId } =
+    await resolveProtocolAuthForFlags(flags, ticketId);
+  const timeoutMs = resolveTimeout(flags);
+
+  const body = {
+    sessionKey,
+    ticketId,
+    reason,
+    ...(flags['objective-id'] ? { objectiveId: String(flags['objective-id']) } : {})
+  };
+
+  const data = await apiPost(
+    platformUrl,
+    bearerToken,
+    localSecret,
+    organizationId,
+    '/api/protocol/request-approval-gate',
+    body,
+    timeoutMs
+  );
+  console.log(JSON.stringify(data, null, 2));
+}
+
 // ---------------------------------------------------------------------------
 // permission-request
 // ---------------------------------------------------------------------------
@@ -2238,6 +2274,7 @@ Subcommands:
   update                    Post progress, activity events, and optional change rationales
   record-change-rationales  Persist structured change rationales without a progress update
   ask                       Post a blocking question and move the ticket to review
+  request-approval-gate     Flip auto_advance=false on the next queued future objective
   permission-request        Notify Overlord that the agent is requesting tool permission
   hook-event                Record a lifecycle hook event without a session key
   read-context              Read shared persistent context for this ticket
@@ -2779,6 +2816,10 @@ EOF
     await protocolAsk(args);
     return;
   }
+  if (subcommand === 'request-approval-gate') {
+    await protocolRequestApprovalGate(args);
+    return;
+  }
   if (subcommand === 'permission-request') {
     await protocolPermissionRequest(args);
     return;

package/package.json

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

package/plugins/overlord/scripts/overlord-mcp.mjs

@@ -292,6 +292,31 @@ const tools = [
     }),
     subcommand: 'ask'
   },
+  {
+    name: 'request_approval_gate',
+    description:
+      'Flip auto_advance=false on the next queued future objective so a human must approve before it runs.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        session_key: { type: 'string' },
+        ticket_id: {
+          type: 'string',
+          description: 'Ticket identifier (e.g. 1:899). Also accepts UUID.'
+        },
+        reason: { type: 'string' },
+        objective_id: { type: 'string' }
+      },
+      required: ['session_key', 'ticket_id', 'reason']
+    },
+    toCliFlags: args => ({
+      'session-key': args.session_key,
+      'ticket-id': args.ticket_id,
+      reason: args.reason,
+      'objective-id': args.objective_id
+    }),
+    subcommand: 'request-approval-gate'
+  },
   {
     name: 'read_context',
     description: 'Read persistent shared context entries for a ticket.',