@haystackeditor/cli 0.15.27 → 0.15.28

package/dist/commands/setup.js

@@ -9,16 +9,16 @@
  * 5. Scan for review policies
  * 6. Review discovered items (toggle on/off)
  * 7. Confirm & write .haystack.json to selected repos
- * 8. Install session tracking (Entire CLI + .entire/settings.json + local hooks)
+ * 8. Offer to install local Haystack hooks
  */
 import chalk from 'chalk';
 import { execFileSync, execSync } from 'child_process';
-import { mkdirSync } from 'fs';
-import { basename, join } from 'path';
+import { basename } from 'path';
 import { resolveAuthContext } from '../utils/auth.js';
 import { hooksInstall } from './hooks.js';
+import { installSessionHooks } from './install-session-hooks.js';
 import { findGitRoot } from '../utils/hooks.js';
-import { trackError, trackSetupEvent } from '../utils/telemetry.js';
+import { trackError } from '../utils/telemetry.js';
 import { createPrompter, loadAnswersFile, PromptCancelledError } from '../utils/prompter.js';
 /** The active prompter for this `setup` invocation (TTY or JSON). */
 let ui;
@@ -33,16 +33,11 @@ function buildAnswerMap(options) {
         answers.select_repos = options.repos;
     if (typeof options.autoMerge === 'boolean')
         answers.auto_merge = options.autoMerge;
-    if (options.skipEntire) {
-        answers.install_entire = false;
-        answers.upgrade_entire = false;
-        answers.install_hooks = false;
-    }
     if (options.yes) {
         // Accept the interactive wizard's defaults non-interactively: keep every
         // discovered item (skip the toggle UI), confirm the write, and say yes to
-        // the same things the prompts default to (auto-merge, session tracking,
-        // hooks). Use --skip-entire / --no-auto-merge to opt out. Only fill ids not
+        // the same things the prompts default to (auto-merge and hooks). Use
+        // --no-auto-merge to opt out. Only fill ids not
         // already set by an explicit flag or --answers.
         if (!('want_to_toggle' in answers))
             answers.want_to_toggle = false;
@@ -53,10 +48,6 @@ function buildAnswerMap(options) {
             // Consequential default applied without an interactive prompt — say so.
             console.error('--yes: enabling auto-merge (the wizard default). Pass --no-auto-merge to opt out.');
         }
-        if (!('install_entire' in answers))
-            answers.install_entire = true;
-        if (!('upgrade_entire' in answers))
-            answers.upgrade_entire = true;
         if (!('install_hooks' in answers))
             answers.install_hooks = true;
         // Don't auto-launch a browser in an unattended --yes run; the feed URL is
@@ -135,8 +126,7 @@ const BOOTSTRAP_PR_BODY_INTRO = 'This PR was opened automatically by the Haystac
     'It adds the Haystack onboarding config:\n' +
     '- `.haystack/pr-rules.yml` — rules Haystack enforces on every PR\n' +
     '- `.haystack/review-policy.md` — path-scoped review policies + review instructions\n' +
-    '- `.haystack.json` — your Haystack merge-queue settings\n' +
-    '- `.entire/settings.json` — enables AI-session trace capture (powers intent-drift triage)\n\n';
+    '- `.haystack.json` — your Haystack merge-queue settings\n\n';
 // Auto-merge ON: Haystack bootstrap-merges the PR itself once labeled.
 const BOOTSTRAP_PR_OUTRO_AUTOMERGE = 'Haystack will bootstrap-merge this PR automatically once the labels are applied. ' +
     'You can tweak the files from GitHub or re-run `haystack setup` anytime.';
@@ -256,64 +246,6 @@ async function createCommitWithFiles(owner, repo, baseSha, files, message, token
     }
     return (await commitRes.json()).sha;
 }
-/**
- * Compute the desired `.entire/settings.json` content for a repo: fetch the
- * existing file (if any), strip the legacy `skip_raw_transcript` option, and
- * serialize. Returns `null` when the file already exists and is unchanged
- * (nothing to write). Otherwise returns the content AND the existing blob
- * sha (or null if the file doesn't exist) — so the direct-write path can
- * issue a correct update PUT without a second redundant GET. Pure read +
- * transform — does no writes itself, so it can feed either the bootstrap-PR
- * commit or the direct-write path.
- *
- * Non-404 read failures throw — they must NOT be silently coerced to
- * "file doesn't exist", which would make the subsequent PUT a create and
- * GitHub reject it 422, masking the real transient error.
- */
-async function buildEntireSettingsContent(repoFullName, token) {
-    const [owner, repo] = repoFullName.split('/');
-    const headers = ghHeaders(token);
-    let settings = { enabled: true };
-    let originalContent = '';
-    let exists = false;
-    let existingSha = null;
-    const getResp = await fetch(`${GITHUB_PROXY}/repos/${owner}/${repo}/contents/.entire/settings.json`, { headers });
-    if (getResp.ok) {
-        exists = true;
-        const data = (await getResp.json());
-        existingSha = data.sha;
-        originalContent = Buffer.from(data.content, 'base64').toString('utf-8');
-        try {
-            settings = JSON.parse(originalContent);
-        }
-        catch {
-            console.log(chalk.dim(`  Existing .entire/settings.json in ${repoFullName} is malformed — will repair`));
-        }
-    }
-    else if (getResp.status !== 404) {
-        const errText = await getResp.text().catch(() => '');
-        const error = new Error(`Failed to read .entire/settings.json: ${getResp.status} ${errText}`);
-        trackError('entire_settings_read_failed', {
-            error_message: error.message,
-            repo: repoFullName,
-            status: getResp.status,
-        });
-        throw error;
-    }
-    // Remove legacy skip_raw_transcript if present (v0.5.3-haystack.2+ compacts automatically)
-    if (settings.strategy_options && typeof settings.strategy_options === 'object') {
-        const strategyOptions = settings.strategy_options;
-        delete strategyOptions.skip_raw_transcript;
-        if (Object.keys(strategyOptions).length === 0) {
-            delete settings.strategy_options;
-        }
-    }
-    const updatedContent = JSON.stringify(settings, null, 2) + '\n';
-    // Nothing to do if the file already exists unchanged.
-    if (exists && updatedContent === originalContent)
-        return null;
-    return { content: updatedContent, existingSha };
-}
 async function addBootstrapLabels(owner, repo, prNumber, prUrl, token, autoMerge) {
     // CRITICAL, not best-effort. ONBOARDING_BOOTSTRAP_LABEL is the identity marker
     // that keeps the PR recognized in the user's Analyzing / Good to Merge tabs
@@ -395,7 +327,7 @@ async function assignActorToPr(owner, repo, prNumber, login, token) {
 }
 /**
  * Protected-branch fallback: build ONE commit containing ALL the onboarding
- * files (`configFiles` + `.entire/settings.json`) via the Git Data API, CREATE
+ * config files via the Git Data API, CREATE
  * a branch ref at it, open a PR, and apply the auto-merge + bootstrap labels.
  *
  * Why every file in one commit: a ruleset whose `pull_request` rule targets
@@ -403,8 +335,7 @@ async function assignActorToPr(owner, repo, prNumber, login, token) {
  * commit to the default branch NOR add a second commit to the onboarding
  * branch afterward. The only thing allowed is *creating* a ref. So all the
  * bootstrap-critical files (`.haystack/pr-rules.yml`, `.haystack/review-policy.md`,
- * `.haystack.json` enables the merge queue, `.entire/settings.json` enables the
- * trace capture intent-drift triage runs on) must land in the single commit the
+ * and `.haystack.json`) must land in the single commit the
  * branch is created at. Mirrors the web wizard's PR-fallback path.
  */
 async function openBootstrapConfigPR(owner, repo, configFiles, token, defaultBranch, autoMergeEnabled, assigneeLogin) {
@@ -416,36 +347,6 @@ async function openBootstrapConfigPR(owner, repo, configFiles, token, defaultBra
         path: f.path,
         content: f.content,
     }));
-    // Bundle .entire/settings.json into the same commit — on a ~ALL ruleset
-    // we can't add it later. It's repo-level config (independent of whether
-    // this dev installs the Entire binary locally), so it rides along here.
-    // The Git Data tree API overwrites by path, so existingSha isn't needed here.
-    //
-    // Best-effort: .entire/settings.json is the OPTIONAL file; .haystack.json
-    // is the bootstrap-critical one. A transient non-404 read failure here
-    // must NOT abort the whole PR (buildEntireSettingsContent throws on
-    // non-404). Catch it, warn, and ship the PR with just .haystack.json —
-    // far better than failing setup over the optional file. The customer can
-    // re-run `haystack setup` to pick up .entire/settings.json once GitHub
-    // is healthy.
-    // entireSettings === null means the file already exists unchanged — there's
-    // nothing to bundle, but the repo IS correctly configured, so that still
-    // counts as bundled. Only a read *failure* (caught below) sets this false.
-    let entireSettingsBundled = true;
-    try {
-        const entireSettings = await buildEntireSettingsContent(`${owner}/${repo}`, token);
-        if (entireSettings !== null) {
-            files.push({ path: '.entire/settings.json', content: entireSettings.content });
-        }
-    }
-    catch (err) {
-        // buildEntireSettingsContent already tracked this with the real HTTP
-        // status before throwing — don't re-emit a duplicate event here. Just
-        // warn and ship the PR with .haystack.json only.
-        entireSettingsBundled = false;
-        console.log(chalk.yellow(`  \u26a0 Couldn't read .entire/settings.json for ${owner}/${repo} (${err instanceof Error ? err.message : err}) — ` +
-            `opening the bootstrap PR with .haystack.json only. Re-run \`haystack setup\` to add session tracking.`));
-    }
     const commitSha = await createCommitWithFiles(owner, repo, baseSha, files, CONFIG_COMMIT_MSG, token);
     await createBranch(owner, repo, branchName, commitSha, token);
     const pr = await createBootstrapPR(owner, repo, branchName, defaultBranch, token, autoMergeEnabled);
@@ -459,7 +360,7 @@ async function openBootstrapConfigPR(owner, repo, configFiles, token, defaultBra
     // the repo hasn't opted out. With auto-merge off the PR is still opened, marked,
     // and analyzed — it just waits for the user to merge it.
     await addBootstrapLabels(owner, repo, pr.number, pr.html_url, token, autoMergeEnabled);
-    return { prUrl: pr.html_url, entireSettingsBundled };
+    return { prUrl: pr.html_url };
 }
 /**
  * Write the onboarding config files to a repo by ALWAYS opening a PR
@@ -1084,8 +985,7 @@ async function stepConfirm(byRepo, token, assigneeLogin) {
             ui.clearProgress();
             // Onboarding always opens a PR (never a direct commit). With auto-merge on,
             // Haystack merges it once its labels are processed; with auto-merge off it
-            // waits for the user. Step 7 ensures .entire/settings.json rode along in
-            // the same commit.
+            // waits for the user.
             bootstrapPRs.set(repoFullName, writeResult.bootstrapPR);
             // Don't print the GitHub PR URL: the user reviews and merges from their
             // Haystack feed, not the GitHub PR page. The feed link is the single CTA
@@ -1172,17 +1072,8 @@ async function runSetupFlow(options) {
         ui.result({ status: 'cancelled' });
         return;
     }
-    // Step 7: Install Entire CLI (session tracking). bootstrapPRs tells it which
-    // repos got a Configure Haystack PR (all of them) so it can report that
-    // .entire/settings.json rode along in that PR's commit.
-    // --skip-entire skips the whole step (binary install + hooks) — not just the
-    // install prompt.
-    if (options.skipEntire) {
-        console.log(chalk.dim('  Skipping session tracking (--skip-entire).\n'));
-    }
-    else {
-        await stepInstallEntire(selectedRepos, token, bootstrapPRs);
-    }
+    // Step 7: Offer Haystack's local quality hooks when setup runs in a selected repo.
+    await stepInstallHooks(selectedRepos);
     // Close the loop with ONE prominent CTA: the Haystack feed. The Configure
     // Haystack PR (and every PR after it) is reviewed and merged from the feed,
     // NOT the GitHub PR page, so the feed is the only link we surface. In JSON
@@ -1217,155 +1108,9 @@ async function runSetupFlow(options) {
     });
 }
 // =============================================================================
-// Step 7: Install Entire CLI for session tracking
+// Step 7: Install Haystack git hooks
 // =============================================================================
-const ENTIRE_VERSION = 'v0.5.3-haystack.2';
-const ENTIRE_RELEASE_BASE = `https://github.com/haystackeditor/cli/releases/download/${ENTIRE_VERSION}`;
-function getEntireBinaryName() {
-    const platform = process.platform === 'darwin' ? 'darwin'
-        : process.platform === 'linux' ? 'linux'
-            : null;
-    if (!platform)
-        return null; // unsupported (Windows, FreeBSD, etc.)
-    const arch = process.arch === 'arm64' ? 'arm64'
-        : process.arch === 'x64' ? 'amd64'
-            : null;
-    if (!arch)
-        return null; // unsupported (s390x, ppc64, etc.)
-    return `entire_${platform}_${arch}`;
-}
-function isEntireInstalled() {
-    // Check the canonical install location first, then fall back to PATH
-    const haystackBin = process.env.HOME
-        ? join(process.env.HOME, '.haystack', 'bin', 'entire')
-        : null;
-    const candidates = haystackBin ? [haystackBin, 'entire'] : ['entire'];
-    for (const bin of candidates) {
-        try {
-            const version = execSync(`"${bin}" --version 2>&1`, { encoding: 'utf-8' }).trim();
-            return {
-                installed: true,
-                isHaystackFork: version.includes('haystack'),
-                version,
-            };
-        }
-        catch {
-            // Try next candidate
-        }
-    }
-    return { installed: false, isHaystackFork: false, version: '' };
-}
-async function installEntireBinary() {
-    const binaryName = getEntireBinaryName();
-    if (!binaryName) {
-        console.log(chalk.yellow(`  Entire CLI is not available for ${process.platform}/${process.arch}.`));
-        console.log(chalk.dim('  Supported: macOS (Intel/Apple Silicon), Linux (x86_64/ARM64)'));
-        return false;
-    }
-    const url = `${ENTIRE_RELEASE_BASE}/${binaryName}`;
-    const installDir = process.env.HOME
-        ? join(process.env.HOME, '.haystack', 'bin')
-        : '/usr/local/bin';
-    try {
-        mkdirSync(installDir, { recursive: true });
-        const targetPath = join(installDir, 'entire');
-        console.log(chalk.dim(`  Downloading ${ENTIRE_VERSION}...`));
-        execFileSync('curl', ['-fsSL', url, '-o', targetPath], { stdio: 'pipe' });
-        execFileSync('chmod', ['+x', targetPath], { stdio: 'pipe' });
-        // Verify using absolute path (don't rely on PATH)
-        const version = execFileSync(targetPath, ['--version'], { encoding: 'utf-8' }).trim();
-        if (!version.includes('haystack')) {
-            console.log(chalk.red(`  Unexpected version: ${version}`));
-            return false;
-        }
-        console.log(chalk.green(`  ✓ Installed: ${version.split('\n')[0]}`));
-        // Check if install dir is on PATH
-        const pathDirs = (process.env.PATH || '').split(':');
-        if (!pathDirs.includes(installDir)) {
-            console.log(chalk.yellow(`\n  Note: ${installDir} is not on your PATH.`));
-            console.log(chalk.dim(`  Add to your shell profile: export PATH="${installDir}:$PATH"\n`));
-        }
-        return true;
-    }
-    catch (err) {
-        const errorMsg = err instanceof Error ? err.message : String(err);
-        console.log(chalk.red(`  Failed to install Entire CLI: ${errorMsg}`));
-        console.log(chalk.dim(`  Manual install: curl -fsSL ${url} -o ~/.haystack/bin/entire && chmod +x ~/.haystack/bin/entire`));
-        trackError('entire_install_failed', {
-            error_message: errorMsg,
-            error_stack: err instanceof Error ? err.stack : undefined,
-            entire_version: ENTIRE_VERSION,
-            install_dir: installDir,
-        });
-        return false;
-    }
-}
-async function stepInstallEntire(selectedRepos, token, bootstrapPRs) {
-    console.log(chalk.bold('\n  Step 7: Session tracking (Entire CLI)\n'));
-    const status = isEntireInstalled();
-    let binaryReady = status.installed && status.isHaystackFork;
-    let userConsented = true; // true if user said yes or was already installed
-    if (binaryReady) {
-        console.log(chalk.dim(`  Entire CLI already installed (${status.version.split('\n')[0]})`));
-    }
-    else if (status.installed) {
-        console.log(chalk.dim(`  Stock Entire CLI detected: ${status.version.split('\n')[0]}`));
-        const upgrade = await ui.confirm({
-            id: 'upgrade_entire',
-            message: 'Upgrade to Haystack fork? (adds transcript optimization — saves GB of git storage)',
-            default: true,
-        });
-        if (upgrade) {
-            binaryReady = await installEntireBinary();
-        }
-        else {
-            userConsented = false;
-        }
-    }
-    else {
-        const install = await ui.confirm({
-            id: 'install_entire',
-            message: 'Install Entire CLI? (tracks AI coding sessions for analysis)',
-            default: true,
-        });
-        if (install) {
-            binaryReady = await installEntireBinary();
-        }
-        else {
-            userConsented = false;
-        }
-    }
-    if (!userConsented) {
-        console.log(chalk.dim('  Skipping session tracking.\n'));
-    }
-    // Onboarding always opens a PR, and .entire/settings.json rides along in that
-    // PR's single commit (see openBootstrapConfigPR), so there's nothing to write
-    // separately here — just report what landed.
-    if (userConsented) {
-        let bundled = 0;
-        for (const repoFullName of selectedRepos) {
-            const bootstrapPR = bootstrapPRs.get(repoFullName);
-            if (bootstrapPR?.entireSettingsBundled) {
-                console.log(chalk.green(`  ✓ ${repoFullName}`) + chalk.dim(' (in PR)'));
-                bundled++;
-            }
-            else {
-                // The PR shipped the config files but not .entire/settings.json — its
-                // optional read failed transiently. The warning was already shown when
-                // the PR was opened.
-                console.log(chalk.yellow(`  ⚠ ${repoFullName}`) +
-                    chalk.dim(' — PR has config files only; re-run setup to add session tracking'));
-            }
-        }
-        if (bundled > 0) {
-            console.log(chalk.green(`\n  ✓ Session tracking configured on ${bundled} repo(s) (transcripts auto-compacted)\n`));
-            trackSetupEvent('entire_configured', { configured: bundled, total: selectedRepos.length });
-        }
-        else {
-            console.log(chalk.yellow('\n  ⚠ Could not configure session tracking on any repos.\n'));
-            trackError('entire_config_all_failed', { total: selectedRepos.length });
-        }
-    }
+async function stepInstallHooks(selectedRepos) {
     // Offer to install local git hooks if cwd is inside one of the selected repos
     const gitRoot = findGitRoot();
     if (gitRoot) {
@@ -1378,12 +1123,13 @@ async function stepInstallEntire(selectedRepos, token, bootstrapPRs) {
             try {
                 const installHooks = await ui.confirm({
                     id: 'install_hooks',
-                    message: `Install git hooks locally for ${repoName}? (agent detection, truncation checking, LLM rules)`,
+                    message: `Install local hooks for ${repoName}? (agent checks, session status, verification precompute)`,
                     default: true,
                 });
                 if (installHooks) {
                     console.log('');
-                    await hooksInstall({ skipEntire: true, force: true });
+                    await hooksInstall({ force: true });
+                    await installSessionHooks({ cli: 'claude' });
                 }
             }
             catch (err) {

package/dist/commands/submit.js

@@ -135,7 +135,6 @@ function checkerDisplayName(checker) {
     switch (checker) {
         case 'code-review': return 'Code Review';
         case 'rules-validator': return 'Rules Validator';
-        case 'intent-drift': return 'Instruction Drift';
         default: return checker;
     }
 }
@@ -161,7 +160,7 @@ async function resolveTriageOptions(options) {
     const triageConfig = config?.triage ?? {};
     const maxTurns = { ...(triageConfig.maxTurns ?? {}) };
     if (typeof options.maxTurns === 'number' && options.maxTurns > 0) {
-        for (const name of ['code-review', 'rules-validator', 'intent-drift']) {
+        for (const name of ['code-review', 'rules-validator']) {
             maxTurns[name] = options.maxTurns;
         }
     }

package/dist/commands/verify-hosted.d.ts

@@ -16,6 +16,18 @@ export interface HostedStatusOptions {
     timeout?: string;
     json?: boolean;
 }
+export interface HostedRunnerResult {
+    verdict: string;
+    summary: string;
+    casesTotal: number;
+    casesFailed: number;
+    regressions: Array<{
+        caseId: string;
+        title: string;
+    }>;
+    outputLocation: string;
+    wallSeconds: number;
+}
 export interface HostedRunState {
     runId: string;
     status: string;
@@ -25,6 +37,7 @@ export interface HostedRunState {
     createdAt?: string;
     completedAt?: string;
     output?: Record<string, unknown>;
+    result?: HostedRunnerResult;
     error?: string;
 }
 export interface HostedPollOptions {

package/dist/commands/verify-hosted.js

@@ -73,10 +73,22 @@ export function parseHostedRunState(value, expectedRunId) {
     const output = outputValue === undefined
         ? undefined
         : requireRecord(outputValue, 'Hosted verifier output');
+    const resultValue = response.result;
+    const result = resultValue === undefined
+        ? undefined
+        : parseHostedRunnerResult(resultValue);
     const createdAt = optionalTimestamp(response, 'createdAt');
     const completedAt = optionalTimestamp(response, 'completedAt');
     if (status === 'complete') {
-        if (!repository
+        // Two terminal shapes exist: the Workflow receipt envelope (`output`)
+        // and the runner-queue result envelope (`result`). Exactly one must
+        // validate.
+        if (result) {
+            if (!repository || !baseCommit || !headCommit || !createdAt) {
+                throw new Error('Hosted verifier returned a complete run without a matching terminal receipt.');
+            }
+        }
+        else if (!repository
             || !baseCommit
             || !headCommit
             || !createdAt
@@ -100,9 +112,35 @@ export function parseHostedRunState(value, expectedRunId) {
         createdAt,
         completedAt,
         output,
+        result,
         error: optionalString(response, 'error'),
     };
 }
+function parseHostedRunnerResult(value) {
+    const record = requireRecord(value, 'Hosted verifier runner result');
+    const regressionsValue = record.regressions;
+    if (typeof record.verdict !== 'string'
+        || typeof record.summary !== 'string'
+        || !Number.isInteger(record.casesTotal)
+        || !Number.isInteger(record.casesFailed)
+        || typeof record.outputLocation !== 'string'
+        || typeof record.wallSeconds !== 'number'
+        || !Array.isArray(regressionsValue)
+        || !regressionsValue.every(item => !!item && typeof item === 'object' && !Array.isArray(item)
+            && typeof item.caseId === 'string'
+            && typeof item.title === 'string')) {
+        throw new Error('Hosted verifier runner result is malformed.');
+    }
+    return {
+        verdict: record.verdict,
+        summary: record.summary,
+        casesTotal: record.casesTotal,
+        casesFailed: record.casesFailed,
+        regressions: regressionsValue,
+        outputLocation: record.outputLocation,
+        wallSeconds: record.wallSeconds,
+    };
+}
 export function parseHostedRepository(value) {
     const parts = value.split('/');
     if (parts.length !== 2
@@ -242,6 +280,7 @@ export function buildHostedJson(operation, state, extras = {}) {
         ...(extras.nextCommand ? { next_command: extras.nextCommand } : {}),
         ...(extras.timedOut !== undefined ? { timed_out: extras.timedOut } : {}),
         ...(state.output ? { output: state.output } : {}),
+        ...(state.result ? { result: state.result } : {}),
         ...(state.error ? { error: state.error } : {}),
     });
 }
@@ -273,6 +312,15 @@ function printHostedState(operation, state, options) {
     if (state.baseCommit && state.headCommit) {
         console.log(`  ${chalk.dim('Commits:')} ${state.baseCommit.slice(0, 12)} → ${state.headCommit.slice(0, 12)}`);
     }
+    if (state.result) {
+        const passed = state.result.casesTotal - state.result.casesFailed;
+        console.log(`  ${chalk.dim('Verdict:')} ${state.result.verdict} `
+            + `(${passed}/${state.result.casesTotal} cases clean, ${Math.round(state.result.wallSeconds)}s)`);
+        for (const regression of state.result.regressions) {
+            console.log(`    ${chalk.red('✗')} ${regression.caseId}: ${regression.title}`);
+        }
+        console.log(`  ${chalk.dim('Artifacts:')} ${state.result.outputLocation}`);
+    }
     if (state.error)
         console.log(`  ${chalk.dim('Error:')} ${state.error}`);
     if (options.timedOut) {

package/dist/commands/verify-precompute.d.ts

@@ -0,0 +1,19 @@
+export type PrecomputeOutcome = 'enqueued' | 'cached' | 'existing' | 'skipped_no_auth' | 'error';
+export interface VerifyPrecomputeOptions {
+    hook?: boolean;
+}
+export interface FrontHalfEnqueueRequest {
+    owner: string;
+    repository: string;
+    baseCommit: string;
+    workCommit: string;
+    cacheKey: string;
+    patchGzBase64: string;
+    patchSha256: string;
+}
+export interface PrecomputeDerivation {
+    treeSha: string;
+    request: FrontHalfEnqueueRequest;
+}
+export declare function derivePrecomputeRequest(gitRoot: string, owner: string, repository: string, deadline?: number): Promise<PrecomputeDerivation>;
+export declare function verifyPrecomputeCommand(options: VerifyPrecomputeOptions): Promise<void>;