orquesta-agent 0.2.239 → 0.2.241

package/dist/executor.d.ts

@@ -35,6 +35,16 @@ export interface ExecuteOptions {
      * also prevents the orquesta retry from recursing again.
      */
     _forceCli?: 'orquesta' | 'claude';
+    /**
+     * Set when this prompt is one item of an assisted QA run. Suppresses every
+     * deploy instruction in the settings header; the caller (index.ts) also
+     * commits the branch and reports the diff back afterwards.
+     */
+    assisted?: {
+        runId: string;
+        itemId: string;
+        branch: string;
+    };
 }
 export interface AuthConfig {
     anthropicApiKey?: string;
@@ -72,6 +82,22 @@ export declare function setCliEndpoint(endpoint: string): void;
 export declare function getCliEndpoint(): string;
 export declare function setBrowserEnabled(enabled: boolean): void;
 export declare function getBrowserEnabled(): boolean;
+/**
+ * Is orquesta-cli usable, and which copy of it should we run?
+ *
+ * The agent bundles orquesta-cli as a dependency so a no-Node / standalone
+ * install always has a CLI. That copy used to win unconditionally — it was
+ * probed first and its bin dir was prepended to PATH, and every spawn uses the
+ * bare name `orquesta`. So a user who updated their own global CLI kept getting
+ * the version pinned in orquesta-agent's package.json: the Interactive Session
+ * reported v0.2.138 on a machine running v0.2.140, and re-running the update
+ * flow could never change it, because the update flow bumps the AGENT and the
+ * agent's pin came along with it. QA-77.
+ *
+ * Now every candidate is probed and the NEWEST one wins. The bundled copy stays
+ * the floor (it is still found when nothing else is installed), it just no
+ * longer shadows a newer install.
+ */
 export declare function isOrquestaCliAvailable(): boolean;
 export declare function resolveClaudeBinary(): string | null;
 export declare function isClaudeCliAvailable(): boolean;
@@ -96,7 +122,38 @@ export declare function checkClaudeAuth(): {
 };
 export declare function gitClone(repoUrl: string, targetDir: string, githubToken?: string): Promise<void>;
 export declare function gitPull(targetDir: string): Promise<void>;
-export declare function gitCommitAndPush(targetDir: string, message: string): Promise<void>;
+/**
+ * Commit everything in `targetDir` and push the CURRENT branch.
+ *
+ * Two things here are load-bearing and were wrong while this function had no
+ * callers:
+ *
+ *  - The message goes through `execFileSync` argv, never a shell string. The
+ *    old `git commit -m "${message}"` broke on any message containing a double
+ *    quote and executed on a backtick — and the messages are now built from
+ *    QA-supplied item titles, i.e. untrusted text.
+ *  - The push names its remote and branch explicitly. A bare `git push` obeys
+ *    `push.default`, which on a fresh assisted branch with no upstream fails
+ *    outright; `-u origin <branch>` both creates the branch remotely and sets
+ *    the upstream for later pushes.
+ *
+ * Returns the commit sha it created, or null when there was nothing to commit.
+ * Never throws — the caller reports what happened either way.
+ */
+export declare function gitCommitAndPush(targetDir: string, message: string, opts?: {
+    push?: boolean;
+}): Promise<{
+    sha: string | null;
+    pushed: boolean;
+}>;
+/**
+ * `git diff --numstat` between `baseRef` and the working tree's last commit.
+ *
+ * Raw text, sent verbatim to the server: the agent never decides whether a diff
+ * is too big. Capped so a generated-file explosion cannot become a multi-MB
+ * request body.
+ */
+export declare function gitNumstatSince(targetDir: string, baseRef: string): string;
 export declare function getActivePromptId(): string | null;
 /**
  * Current git branch of `cwd` (the branch a prompt runs on / an interactive

package/dist/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}

package/dist/executor.js

@@ -1,4 +1,4 @@
-import { spawn, execSync } from 'child_process';
+import { spawn, execSync, execFileSync } from 'child_process';
 // PTY binding for interactive sessions. We use @homebridge/node-pty-prebuilt-multiarch
 // (a maintained fork that ships N-API prebuilds for linux-x64/arm64, darwin-x64/arm64,
 // win32-x64) so customers never need a build toolchain on their VM. The try/catch
@@ -357,9 +357,19 @@ export function setProjectSettings(settings) {
     logger.debug(`Settings: autoDeploy=${settings.autoDeploy}, autoMigrate=${settings.autoMigrate}`);
 }
 // Generate settings header for Claude prompt
-function generateSettingsHeader() {
+//
+// `assisted` suppresses every deploy instruction: an assisted run's whole point
+// is that a human reads the diff before it ships, and a deploy fired from
+// inside the run would ship exactly the change the review exists to hold back.
+// The server refuses the deploy call as well (assistedDeployBlock) — this half
+// only stops the agent from trying, because an old agent build on a customer
+// machine will keep emitting the curl for months.
+function generateSettingsHeader(opts = {}) {
     const lines = ['## Active Orquesta Settings\n'];
-    if (projectSettings.autoDeploy && projectSettings.projectId) {
+    if (opts.assisted) {
+        lines.push(`- **Assisted run: deployment is DISABLED for this task.** Do NOT deploy, do NOT call the Orquesta Deploy API, and do NOT push to the main branch. Your changes stay on the QA branch and a reviewer decides whether they ship.`);
+    }
+    else if (projectSettings.autoDeploy && projectSettings.projectId) {
         lines.push(`- **Auto-Deploy: ENABLED**
 
   ⚠️ CRITICAL DEPLOYMENT RULES:
@@ -710,66 +720,118 @@ const CLI_DETECTION_TTL_MS = 5 * 60 * 1000;
 let orquestaCliCache = null;
 let claudeCliCache = null;
 let kimiCliCache = null;
+/**
+ * Version of an orquesta-cli binary, or null when it does not run.
+ * '' means it runs but printed nothing we can parse as a version.
+ */
+function probeOrquestaVersion(bin) {
+    try {
+        const out = execSync(`${bin} --version`, { stdio: 'pipe', timeout: 15000, encoding: 'utf-8' });
+        return (out.match(/\d+\.\d+\.\d+/) || [''])[0];
+    }
+    catch {
+        return null;
+    }
+}
+function compareSemver(a, b) {
+    const pa = a.split('.').map(n => parseInt(n, 10) || 0);
+    const pb = b.split('.').map(n => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) !== (pb[i] || 0))
+            return (pa[i] || 0) - (pb[i] || 0);
+    }
+    return 0;
+}
+// The bin dir this module prepended to PATH on the last detection, so a later
+// re-detection can drop it instead of stacking (and instead of letting a stale
+// winner keep shadowing the one we just chose).
+let injectedCliBinDir = null;
+function prependToPath(binDir) {
+    if (injectedCliBinDir && injectedCliBinDir !== binDir) {
+        const parts = (process.env.PATH || '').split(path.delimiter).filter(p => p !== injectedCliBinDir);
+        process.env.PATH = parts.join(path.delimiter);
+        injectedCliBinDir = null;
+    }
+    const parts = (process.env.PATH || '').split(path.delimiter);
+    if (parts[0] !== binDir) {
+        // path.delimiter, not ':' — a hardcoded colon builds an unusable PATH on
+        // Windows, where the agent has to work too.
+        process.env.PATH = [binDir, ...parts.filter(p => p !== binDir)].join(path.delimiter);
+    }
+    injectedCliBinDir = binDir;
+}
+/**
+ * Is orquesta-cli usable, and which copy of it should we run?
+ *
+ * The agent bundles orquesta-cli as a dependency so a no-Node / standalone
+ * install always has a CLI. That copy used to win unconditionally — it was
+ * probed first and its bin dir was prepended to PATH, and every spawn uses the
+ * bare name `orquesta`. So a user who updated their own global CLI kept getting
+ * the version pinned in orquesta-agent's package.json: the Interactive Session
+ * reported v0.2.138 on a machine running v0.2.140, and re-running the update
+ * flow could never change it, because the update flow bumps the AGENT and the
+ * agent's pin came along with it. QA-77.
+ *
+ * Now every candidate is probed and the NEWEST one wins. The bundled copy stays
+ * the floor (it is still found when nothing else is installed), it just no
+ * longer shadows a newer install.
+ */
 export function isOrquestaCliAvailable() {
     const now = Date.now();
     if (orquestaCliCache && now - orquestaCliCache.at < CLI_DETECTION_TTL_MS) {
         return orquestaCliCache.available;
     }
-    let available = false;
-    // First: check bundled CLI (orquesta-cli installed as dependency)
+    const home = process.env.HOME || process.env.USERPROFILE || '/root';
     const bundledBin = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'node_modules', '.bin', 'orquesta');
-    try {
-        if (fs.existsSync(bundledBin)) {
-            execSync(`${bundledBin} --version`, { stdio: 'pipe', timeout: 15000 });
-            // Add bundled bin dir to PATH so spawn() finds it
-            const binDir = path.dirname(bundledBin);
-            if (!process.env.PATH?.includes(binDir)) {
-                process.env.PATH = `${binDir}:${process.env.PATH || ''}`;
-            }
-            available = true;
-            orquestaCliCache = { available, at: now };
-            return available;
-        }
+    const candidates = [];
+    if (fs.existsSync(bundledBin))
+        candidates.push(bundledBin);
+    // Whatever `orquesta` resolves to right now — but only after dropping any bin
+    // dir a previous detection injected, or we would just re-measure our own pick.
+    if (injectedCliBinDir) {
+        process.env.PATH = (process.env.PATH || '')
+            .split(path.delimiter).filter(p => p !== injectedCliBinDir).join(path.delimiter);
+        injectedCliBinDir = null;
     }
-    catch { /* bundled not working */ }
-    // Second: check PATH
     try {
-        execSync('orquesta --version', { stdio: 'pipe', timeout: 15000 });
-        available = true;
-    }
-    catch {
-        // Fallback: common npm global paths
-        const home = process.env.HOME || '/root';
-        const candidates = [
-            `${home}/.npm-global/bin/orquesta`,
-            `${home}/.nvm/versions/node/${process.version}/bin/orquesta`,
-            '/usr/local/bin/orquesta',
-            '/usr/bin/orquesta',
-            // getorquesta.com/install drops the standalone cli here when /usr/local/bin
-            // isn't writable and there's no sudo (no-Node install on a non-root box).
-            `${home}/.local/bin/orquesta`,
-        ];
-        try {
-            const prefix = execSync('npm prefix -g', { stdio: 'pipe', timeout: 5000, encoding: 'utf-8' }).trim();
-            if (prefix)
-                candidates.unshift(`${prefix}/bin/orquesta`);
-        }
-        catch { }
-        for (const bin of candidates) {
-            try {
-                execSync(`${bin} --version`, { stdio: 'pipe', timeout: 15000 });
-                const binDir = bin.replace(/\/orquesta$/, '');
-                if (!process.env.PATH?.includes(binDir)) {
-                    process.env.PATH = `${binDir}:${process.env.PATH || ''}`;
-                }
-                available = true;
-                break;
-            }
-            catch { }
+        const prefix = execSync('npm prefix -g', { stdio: 'pipe', timeout: 5000, encoding: 'utf-8' }).trim();
+        if (prefix)
+            candidates.push(path.join(prefix, 'bin', 'orquesta'));
+    }
+    catch { /* npm may not be installed at all (standalone binary machines) */ }
+    candidates.push(`${home}/.npm-global/bin/orquesta`, `${home}/.nvm/versions/node/${process.version}/bin/orquesta`, '/usr/local/bin/orquesta', '/usr/bin/orquesta', 
+    // getorquesta.com/install drops the standalone cli here when /usr/local/bin
+    // isn't writable and there's no sudo (no-Node install on a non-root box).
+    `${home}/.local/bin/orquesta`);
+    let best = null;
+    const seen = new Set();
+    for (const bin of candidates) {
+        if (seen.has(bin))
+            continue;
+        seen.add(bin);
+        if (bin !== bundledBin && !fs.existsSync(bin))
+            continue;
+        const version = probeOrquestaVersion(bin);
+        if (version === null)
+            continue;
+        if (!best || compareSemver(version, best.version) > 0)
+            best = { bin, version };
+    }
+    // Nothing on the candidate list ran — fall back to a bare PATH lookup, which
+    // covers layouts we don't enumerate (Windows shims, custom prefixes).
+    if (!best) {
+        const version = probeOrquestaVersion('orquesta');
+        if (version !== null) {
+            orquestaCliCache = { available: true, at: now };
+            return true;
         }
+        orquestaCliCache = { available: false, at: now };
+        return false;
     }
-    orquestaCliCache = { available, at: now };
-    return available;
+    prependToPath(path.dirname(best.bin));
+    logger.debug(`orquesta-cli: using ${best.bin}${best.version ? ` (v${best.version})` : ''}`);
+    orquestaCliCache = { available: true, at: now };
+    return true;
 }
 // Resolve a claude binary that ACTUALLY runs — not one that merely exists on
 // PATH. The claude-code npm package's `bin/claude` launcher can be broken: a
@@ -1120,27 +1182,92 @@ export async function gitPull(targetDir) {
         logger.warn(`Git pull failed (continuing without it): ${error}`);
     }
 }
-export async function gitCommitAndPush(targetDir, message) {
+/**
+ * Commit everything in `targetDir` and push the CURRENT branch.
+ *
+ * Two things here are load-bearing and were wrong while this function had no
+ * callers:
+ *
+ *  - The message goes through `execFileSync` argv, never a shell string. The
+ *    old `git commit -m "${message}"` broke on any message containing a double
+ *    quote and executed on a backtick — and the messages are now built from
+ *    QA-supplied item titles, i.e. untrusted text.
+ *  - The push names its remote and branch explicitly. A bare `git push` obeys
+ *    `push.default`, which on a fresh assisted branch with no upstream fails
+ *    outright; `-u origin <branch>` both creates the branch remotely and sets
+ *    the upstream for later pushes.
+ *
+ * Returns the commit sha it created, or null when there was nothing to commit.
+ * Never throws — the caller reports what happened either way.
+ */
+export async function gitCommitAndPush(targetDir, message, opts = {}) {
     try {
         // Check if there are changes
         const status = execSync('git status --porcelain', { cwd: targetDir, timeout: 30_000 }).toString();
         if (!status.trim()) {
             logger.info('No changes to commit');
-            return;
+            return { sha: null, pushed: false };
         }
         logger.info('Committing changes...');
-        execSync('git add .', { cwd: targetDir, stdio: 'inherit', timeout: 30_000 });
-        execSync(`git commit -m "${message}"`, { cwd: targetDir, stdio: 'inherit', timeout: 30_000 });
-        execSync('git push', {
+        execFileSync('git', ['add', '-A'], { cwd: targetDir, stdio: 'pipe', timeout: 30_000 });
+        execFileSync('git', ['commit', '-m', message], { cwd: targetDir, stdio: 'pipe', timeout: 30_000 });
+        const sha = execSync('git rev-parse HEAD', {
             cwd: targetDir,
-            stdio: 'inherit',
-            timeout: GIT_NET_TIMEOUT_MS,
-            env: GIT_NONINTERACTIVE_ENV,
-        });
-        logger.success('Changes pushed to repository');
+            encoding: 'utf-8',
+            timeout: 10_000,
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        let pushed = false;
+        if (opts.push !== false) {
+            const branch = getCurrentGitBranch(targetDir);
+            if (!branch) {
+                logger.warn('Detached HEAD — committed but not pushed');
+            }
+            else {
+                try {
+                    execFileSync('git', ['push', '-u', 'origin', branch], {
+                        cwd: targetDir,
+                        stdio: 'pipe',
+                        timeout: GIT_NET_TIMEOUT_MS,
+                        env: GIT_NONINTERACTIVE_ENV,
+                    });
+                    pushed = true;
+                    logger.success(`Changes pushed to origin/${branch}`);
+                }
+                catch (pushError) {
+                    // A commit that exists locally is still a reviewable result — the
+                    // reviewer just reads the diff stat instead of the remote branch.
+                    logger.warn(`Git push failed (commit kept locally): ${pushError}`);
+                }
+            }
+        }
+        return { sha, pushed };
     }
     catch (error) {
         logger.warn(`Git commit/push failed: ${error}`);
+        return { sha: null, pushed: false };
+    }
+}
+/**
+ * `git diff --numstat` between `baseRef` and the working tree's last commit.
+ *
+ * Raw text, sent verbatim to the server: the agent never decides whether a diff
+ * is too big. Capped so a generated-file explosion cannot become a multi-MB
+ * request body.
+ */
+export function gitNumstatSince(targetDir, baseRef) {
+    try {
+        const out = execFileSync('git', ['diff', '--numstat', `${baseRef}...HEAD`], {
+            cwd: targetDir,
+            encoding: 'utf-8',
+            timeout: 30_000,
+            stdio: ['pipe', 'pipe', 'ignore'],
+            maxBuffer: 8 * 1024 * 1024,
+        });
+        return out.slice(0, 180_000);
+    }
+    catch {
+        return '';
     }
 }
 // ============================================
@@ -1997,7 +2124,7 @@ export async function execute(options) {
         }
         // Build full prompt with settings, agent instructions, and attachments
         let fullContent = content + attachmentContext;
-        const settingsHeader = generateSettingsHeader();
+        const settingsHeader = generateSettingsHeader({ assisted: !!options.assisted });
         const browserBlock = globalBrowserEnabled ? BROWSER_TOOLS_PROMPT_BLOCK : '';
         const coordinationBlock = await fetchCoordinationContextBlock();
         const capabilitiesBlock = `${ORQUESTA_CAPABILITIES_PROMPT_BLOCK}${coordinationBlock}`;