@joynt/foundry 0.0.0-stage → 0.1.50

package/dist/lib/preview-verify.js

@@ -0,0 +1,148 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForUrl = waitForUrl;
+exports.expandReadyMatch = expandReadyMatch;
+exports.isConfigured = isConfigured;
+exports.verifyPreview = verifyPreview;
+exports.formatPreviewVerify = formatPreviewVerify;
+/**
+ * Preview verification — commands run against a live preview URL.
+ *
+ * `verify` proves the branch builds and its unit tests pass. `verify_preview`
+ * proves the deployed thing works: it runs after the preview is up, with
+ * FOUNDRY_PREVIEW_URL in the environment, and gates
+ * `state:ready-for-human-review`. This is where end-to-end and integration
+ * tests live once there is no shared test environment to run them in.
+ *
+ * A preview can take a while to become reachable (a static-site build, a
+ * container rollout), so the pipeline first waits for the URL to answer.
+ */
+const verify_js_1 = require("./verify.js");
+const log = __importStar(require("./log.js"));
+const DEFAULT_READY_TIMEOUT_S = 300;
+const READY_POLL_MS = 5_000;
+/** Poll until the URL answers with a non-5xx status, or the timeout passes. */
+async function waitForUrl(url, timeoutMs, pollMs = READY_POLL_MS, fetchImpl = fetch, bodyMatch) {
+    const deadline = Date.now() + timeoutMs;
+    let attempts = 0;
+    let status;
+    let matched;
+    while (true) {
+        attempts++;
+        try {
+            const res = await fetchImpl(url, { method: 'GET', redirect: 'follow' });
+            status = res.status;
+            if (res.status < 500 && res.status !== 404) {
+                if (!bodyMatch)
+                    return { ready: true, status, attempts };
+                // A redeploy serves the previous version until the new one lands; the
+                // marker (usually the commit SHA) tells them apart.
+                matched = (await res.text()).includes(bodyMatch);
+                if (matched)
+                    return { ready: true, status, attempts, matched };
+            }
+        }
+        catch {
+            status = undefined;
+        }
+        if (Date.now() >= deadline)
+            return { ready: false, status, attempts, matched };
+        await new Promise(r => setTimeout(r, Math.min(pollMs, Math.max(0, deadline - Date.now()))));
+    }
+}
+/** `{sha}`, `{branch}`, `{pr_number}` in ready_match. Undefined when unset. */
+function expandReadyMatch(template, input) {
+    if (!template)
+        return undefined;
+    return template
+        .replace(/\{sha\}/g, input.sha ?? '')
+        .replace(/\{branch\}/g, input.branch ?? '')
+        .replace(/\{pr_number\}/g, input.pr_number === undefined ? '' : String(input.pr_number));
+}
+function isConfigured(config) {
+    return (config.verify_preview ?? []).length > 0;
+}
+/**
+ * Wait for the preview, then run every `verify_preview` command fail-fast.
+ * Never throws; a preview that never comes up is reported as a failed step.
+ */
+async function verifyPreview(config, input) {
+    const commands = config.verify_preview ?? [];
+    const results = [];
+    const timeoutS = config.preview?.ready_timeout_seconds ?? DEFAULT_READY_TIMEOUT_S;
+    const start = Date.now();
+    const match = expandReadyMatch(config.preview?.ready_match, input);
+    const ready = await waitForUrl(input.url, timeoutS * 1000, undefined, undefined, match);
+    if (!ready.ready) {
+        const why = ready.matched === false
+            ? `answered (${ready.status}) but never contained "${match}"`
+            : `did not answer (last status ${ready.status ?? 'no response'})`;
+        results.push({
+            command: `wait for ${input.url}`,
+            success: false,
+            output: `Preview ${why} within ${timeoutS}s (${ready.attempts} attempts).`,
+            duration_ms: Date.now() - start,
+        });
+        return { passed: false, url: input.url, results };
+    }
+    log.info(`Preview is up (${ready.status}${match ? `, contains "${match}"` : ''}) after ${ready.attempts} attempt${ready.attempts === 1 ? '' : 's'}.`);
+    const env = {
+        ...(input.env ?? {}),
+        ...(input.sha ? { FOUNDRY_SHA: input.sha } : {}),
+        FOUNDRY_PREVIEW_URL: input.url,
+    };
+    for (const cmd of commands) {
+        const r = (0, verify_js_1.runVerifyStep)(cmd, input.cwd, env);
+        results.push(r);
+        if (!r.success)
+            return { passed: false, url: input.url, results };
+    }
+    return { passed: true, url: input.url, results };
+}
+/** Markdown summary for a status comment or PR comment. */
+function formatPreviewVerify(outcome) {
+    const lines = [
+        `**Preview verification ${outcome.passed ? 'passed' : 'FAILED'}** against ${outcome.url}`,
+        '',
+        ...outcome.results.map(r => `- \`${r.command}\`: ${r.success ? 'passed' : 'FAILED'} (${r.duration_ms}ms)`),
+    ];
+    const failed = outcome.results.filter(r => !r.success);
+    if (failed.length > 0) {
+        lines.push('', ...failed.map(r => `\`\`\`\n${r.output.slice(-1000)}\n\`\`\``));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=preview-verify.js.map

package/dist/lib/preview-verify.js.map

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

package/dist/lib/preview.d.ts

@@ -0,0 +1,33 @@
+import type { FoundryConfig, TaskState } from '../types.js';
+/**
+ * What a preview is for. A task's PR and a plain pull request (such as the
+ * promotion PR from integration into main) both become one of these; only
+ * the task path persists results to local state.
+ */
+export interface PreviewTarget {
+    branch: string;
+    sha: string;
+    pr_number?: number;
+    issue?: number;
+    preview_url?: string;
+    deployment_id?: number;
+}
+/** The preview URL a PR's comment currently advertises, if Foundry posted one. */
+export declare function previewUrlFromComments(bodies: string[]): string | undefined;
+export declare function findPreviewUrlOnPR(repo: string, prNumber: number): Promise<string | undefined>;
+export declare function previewUp(config: FoundryConfig, task: TaskState): Promise<void>;
+/** Deploy a preview for any target. Returns what was created, or null when no URL could be resolved. */
+export declare function previewUpTarget(config: FoundryConfig, target: PreviewTarget): Promise<{
+    url: string;
+    deploymentId?: number;
+} | null>;
+export declare function previewDown(config: FoundryConfig, task: TaskState): Promise<void>;
+/** Tear down a preview for any target. `preview_url` must be set. */
+export declare function previewDownTarget(config: FoundryConfig, target: PreviewTarget): Promise<void>;
+export interface PreviewStatus {
+    url: string | null;
+    deploymentId: number | null;
+    state: 'active' | 'inactive' | 'none';
+}
+export declare function getPreviewStatus(config: FoundryConfig, task: TaskState): PreviewStatus;
+//# sourceMappingURL=preview.d.ts.map

package/dist/lib/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/lib/preview.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoC5D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAO3E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAOpG;AAmGD,wBAAsB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAarF;AAED,wGAAwG;AACxG,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAyDxD;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvF;AAED,qEAAqE;AACrE,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCnG;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,aAAa,CAYtF"}

package/dist/lib/preview.js

@@ -0,0 +1,308 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewUrlFromComments = previewUrlFromComments;
+exports.findPreviewUrlOnPR = findPreviewUrlOnPR;
+exports.previewUp = previewUp;
+exports.previewUpTarget = previewUpTarget;
+exports.previewDown = previewDown;
+exports.previewDownTarget = previewDownTarget;
+exports.getPreviewStatus = getPreviewStatus;
+/**
+ * Preview orchestration — URL resolution, provider command execution,
+ * comment upsert, and GitHub Deployment coordination.
+ */
+const node_child_process_1 = require("node:child_process");
+const github = __importStar(require("./github.js"));
+const state = __importStar(require("./state.js"));
+const deployments = __importStar(require("./deployments.js"));
+const log = __importStar(require("./log.js"));
+const git_js_1 = require("./git.js");
+const COMMENT_MARKER = '<!-- foundry-preview -->';
+function expandTemplate(template, vars) {
+    return template
+        .replace(/\{branch_slug\}/g, (0, git_js_1.slugify)(vars.branch))
+        .replace(/\{branch\}/g, vars.branch)
+        .replace(/\{issue\}/g, String(vars.issue ?? ''))
+        .replace(/\{repo\}/g, vars.repo)
+        .replace(/\{pr_number\}/g, String(vars.pr_number ?? ''))
+        .replace(/\{sha\}/g, vars.sha);
+}
+function makeEnvVars(vars) {
+    return {
+        FOUNDRY_BRANCH: vars.branch,
+        FOUNDRY_BRANCH_SLUG: (0, git_js_1.slugify)(vars.branch),
+        FOUNDRY_ISSUE: String(vars.issue ?? ''),
+        FOUNDRY_REPO: vars.repo,
+        FOUNDRY_PR_NUMBER: String(vars.pr_number ?? ''),
+        FOUNDRY_SHA: vars.sha,
+    };
+}
+function targetLabel(t) {
+    return t.issue !== undefined ? `#${t.issue}` : `PR #${t.pr_number ?? '?'} (${t.branch})`;
+}
+function targetVars(config, t) {
+    return { branch: t.branch, issue: t.issue, repo: config.repo, pr_number: t.pr_number, sha: t.sha };
+}
+/** The preview URL a PR's comment currently advertises, if Foundry posted one. */
+function previewUrlFromComments(bodies) {
+    for (const body of bodies) {
+        if (!body.includes(COMMENT_MARKER))
+            continue;
+        const m = body.match(/Preview URL:\s*(\S+)/);
+        if (m)
+            return m[1];
+    }
+    return undefined;
+}
+async function findPreviewUrlOnPR(repo, prNumber) {
+    try {
+        const comments = await github.getComments(repo, prNumber);
+        return previewUrlFromComments(comments.map(c => c.body));
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveHeadSha(worktree) {
+    try {
+        return (0, node_child_process_1.execSync)('git rev-parse HEAD', { cwd: worktree, encoding: 'utf-8', timeout: 10_000 }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+// ── URL resolution ───────────────────────────────────────────────────────
+function resolveTemplateUrl(config, vars) {
+    if (!config.preview?.url_template)
+        return null;
+    return expandTemplate(config.preview.url_template, vars);
+}
+/**
+ * Run the provider's up command. Returns the URL it printed, or null.
+ *
+ * When `expectUrl` is false the caller has a url_template and only needs the
+ * command to run; its output is ignored and no warning is logged about it.
+ * This matters because commands like `gh workflow run` print an Actions run
+ * URL, which is a URL but not the preview.
+ */
+function runProviderCommand(command, vars, expectUrl) {
+    const expanded = expandTemplate(command, vars);
+    const env = { ...process.env, ...makeEnvVars(vars) };
+    try {
+        const output = (0, node_child_process_1.execSync)(expanded, {
+            encoding: 'utf-8',
+            timeout: 120_000,
+            env,
+        }).trim();
+        if (!expectUrl)
+            return null;
+        // Try to parse as JSON with a `url` field
+        try {
+            const parsed = JSON.parse(output);
+            if (parsed.url)
+                return parsed.url;
+        }
+        catch {
+            // Not JSON — treat entire output as URL
+        }
+        // Validate it looks like a URL
+        if (output.startsWith('http://') || output.startsWith('https://')) {
+            return output.split('\n').pop().trim();
+        }
+        log.warn(`Provider command output does not look like a URL: ${output.slice(0, 200)}`);
+        return null;
+    }
+    catch (err) {
+        log.warn(`Provider up command failed: ${err.message}`);
+        return null;
+    }
+}
+// ── Comment upsert ───────────────────────────────────────────────────────
+function buildPreviewComment(url, state) {
+    const status = state === 'active' ? 'Live' : 'Torn down';
+    const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19) + ' UTC';
+    return [
+        COMMENT_MARKER,
+        `**Preview Environment** — ${status}`,
+        '',
+        state === 'active' ? `Preview URL: ${url}` : `~~${url}~~ (inactive)`,
+        '',
+        `_Updated: ${timestamp}_`,
+    ].join('\n');
+}
+async function upsertPreviewComment(repo, prNumber, url, commentState) {
+    const body = buildPreviewComment(url, commentState);
+    try {
+        const comments = await github.getComments(repo, prNumber);
+        const existing = comments.find(c => c.body.includes(COMMENT_MARKER));
+        if (existing) {
+            await github.updateComment(repo, existing.id, body);
+        }
+        else {
+            await github.commentOnPR(repo, prNumber, body);
+        }
+    }
+    catch (err) {
+        log.warn(`Failed to upsert preview comment on PR #${prNumber}: ${err.message}`);
+    }
+}
+// ── Main exports ─────────────────────────────────────────────────────────
+async function previewUp(config, task) {
+    if (!config.preview)
+        return;
+    const result = await previewUpTarget(config, {
+        branch: task.branch,
+        issue: task.issue,
+        pr_number: task.pr_number,
+        sha: resolveHeadSha(task.worktree),
+    });
+    if (!result)
+        return;
+    state.updateTaskStatus(config.repo, task.issue, task.status, {
+        preview_url: result.url,
+        ...(result.deploymentId !== undefined ? { deployment_id: result.deploymentId } : {}),
+    });
+}
+/** Deploy a preview for any target. Returns what was created, or null when no URL could be resolved. */
+async function previewUpTarget(config, target) {
+    if (!config.preview)
+        return null;
+    const vars = targetVars(config, target);
+    const label = targetLabel(target);
+    // Resolve URL. url_template, when set, is always the preview URL: the
+    // provider command still runs (it does the deploy) but its output is not
+    // consulted. Only without a template do we read the URL from the command.
+    const hasTemplate = Boolean(config.preview.url_template);
+    let url = null;
+    if (config.preview.mode === 'provider' && config.preview.up_command) {
+        url = runProviderCommand(config.preview.up_command, vars, !hasTemplate);
+    }
+    if (hasTemplate) {
+        url = resolveTemplateUrl(config, vars);
+    }
+    if (!url) {
+        log.warn(`Preview up: could not resolve URL for ${label}`);
+        return null;
+    }
+    log.info(`Preview URL for ${label}: ${url}`);
+    // Create GitHub Deployment (if enabled)
+    let deploymentId;
+    if (config.github_deployments?.enabled) {
+        const deployment = await deployments.createDeployment({
+            repo: config.repo,
+            ref: target.branch,
+            environment: config.github_deployments.environment ?? 'preview',
+            description: `Preview for ${label}`,
+            transientEnvironment: !(config.github_deployments.production ?? false),
+            productionEnvironment: config.github_deployments.production ?? false,
+        });
+        if (deployment) {
+            deploymentId = deployment.id;
+            await deployments.createDeploymentStatus({
+                repo: config.repo,
+                deploymentId: deployment.id,
+                state: 'success',
+                environmentUrl: url,
+                description: 'Preview is live',
+                autoInactive: config.github_deployments.auto_inactive ?? true,
+            });
+        }
+    }
+    // Post/update PR comment
+    if (config.preview.comment !== false && target.pr_number) {
+        await upsertPreviewComment(config.repo, target.pr_number, url, 'active');
+    }
+    return { url, deploymentId };
+}
+async function previewDown(config, task) {
+    if (!config.preview)
+        return;
+    if (!task.preview_url)
+        return;
+    await previewDownTarget(config, {
+        branch: task.branch,
+        issue: task.issue,
+        pr_number: task.pr_number,
+        sha: resolveHeadSha(task.worktree),
+        preview_url: task.preview_url,
+        deployment_id: task.deployment_id,
+    });
+}
+/** Tear down a preview for any target. `preview_url` must be set. */
+async function previewDownTarget(config, target) {
+    if (!config.preview || !target.preview_url)
+        return;
+    const vars = targetVars(config, target);
+    const label = targetLabel(target);
+    // Run down command (provider mode only)
+    if (config.preview.mode === 'provider' && config.preview.down_command) {
+        const expanded = expandTemplate(config.preview.down_command, vars);
+        const env = { ...process.env, ...makeEnvVars(vars) };
+        try {
+            (0, node_child_process_1.execSync)(expanded, { encoding: 'utf-8', timeout: 120_000, env });
+        }
+        catch (err) {
+            log.warn(`Preview down command failed for ${label}: ${err.message}`);
+        }
+    }
+    // Set deployment status to inactive
+    if (config.github_deployments?.enabled && target.deployment_id) {
+        await deployments.createDeploymentStatus({
+            repo: config.repo,
+            deploymentId: target.deployment_id,
+            state: 'inactive',
+            description: 'Preview torn down',
+            autoInactive: config.github_deployments.auto_inactive ?? true,
+        });
+    }
+    // Update PR comment
+    if (config.preview.comment !== false && target.pr_number) {
+        await upsertPreviewComment(config.repo, target.pr_number, target.preview_url, 'inactive');
+    }
+    log.info(`Preview torn down for ${label}`);
+}
+function getPreviewStatus(config, task) {
+    if (!config.preview || !task.preview_url) {
+        return { url: null, deploymentId: null, state: 'none' };
+    }
+    const isActive = ['pr-open', 'reviewing', 'pr-changes-requested', 'agent-running', 'verifying'].includes(task.status);
+    return {
+        url: task.preview_url,
+        deploymentId: task.deployment_id ?? null,
+        state: isActive ? 'active' : 'inactive',
+    };
+}
+//# sourceMappingURL=preview.js.map

package/dist/lib/preview.js.map

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

package/dist/lib/reconcile.d.ts

@@ -0,0 +1,14 @@
+import type { FoundryConfig } from '../types.js';
+export declare const DEFAULT_STALE_MINUTES = 120;
+/** Parse the `| Updated | 2026-10-21 06:35:19 UTC |` row of a status comment. */
+export declare function parseStatusUpdatedAt(body: string): Date | null;
+export interface StaleTask {
+    issue: number;
+    lastUpdate: Date | null;
+    ageMinutes: number | null;
+}
+/** In-progress issues whose last status update is older than the threshold. */
+export declare function findStaleTasks(config: FoundryConfig, now?: Date): Promise<StaleTask[]>;
+/** Mark each stale task failed with a note. Returns what was changed. */
+export declare function reconcile(config: FoundryConfig, repoDir: string, now?: Date): Promise<StaleTask[]>;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/lib/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/lib/reconcile.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAK9D;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAiBxG;AAED,yEAAyE;AACzE,wBAAsB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA2BpH"}

package/dist/lib/reconcile.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STALE_MINUTES = void 0;
+exports.parseStatusUpdatedAt = parseStatusUpdatedAt;
+exports.findStaleTasks = findStaleTasks;
+exports.reconcile = reconcile;
+/**
+ * Reconciliation — find tasks that claim to be running but are not.
+ *
+ * A job can die without a trace: the six-hour limit, a runner failure, a
+ * cancel that skipped cleanup. The issue then sits at `state:in-progress`
+ * forever. On a schedule, Foundry looks at every in-progress issue and, when
+ * its status comment has not been touched for longer than any job could
+ * live, marks it failed with a note so a human can re-queue it.
+ *
+ * Waiting states (`waiting-for-input`, `plan-review`, `ready-for-review`)
+ * are never touched: no job is expected to be running for them.
+ */
+const github = __importStar(require("./github.js"));
+const log = __importStar(require("./log.js"));
+const statusComment = __importStar(require("./status-comment.js"));
+const labels_js_1 = require("./labels.js");
+const task_recovery_js_1 = require("./task-recovery.js");
+exports.DEFAULT_STALE_MINUTES = 120;
+/** Parse the `| Updated | 2026-10-21 06:35:19 UTC |` row of a status comment. */
+function parseStatusUpdatedAt(body) {
+    const m = body.match(/\|\s*Updated\s*\|\s*(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2}) UTC\s*\|/);
+    if (!m)
+        return null;
+    const d = new Date(`${m[1]}T${m[2]}Z`);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+/** In-progress issues whose last status update is older than the threshold. */
+async function findStaleTasks(config, now = new Date()) {
+    const staleAfterMs = (config.reconcile_stale_minutes ?? exports.DEFAULT_STALE_MINUTES) * 60_000;
+    const issues = await github.listIssuesByLabel(config.repo, config.labels.in_progress);
+    const stale = [];
+    for (const issue of issues) {
+        const comments = await github.getComments(config.repo, issue.number);
+        const status = [...comments].reverse().find(c => c.body.includes('<!-- foundry-status -->'));
+        const lastUpdate = status ? parseStatusUpdatedAt(status.body) : null;
+        const ageMinutes = lastUpdate ? Math.round((now.getTime() - lastUpdate.getTime()) / 60_000) : null;
+        // No status comment at all means the claim never got as far as starting an
+        // agent; treat it as stale too, since nothing will ever update it.
+        if (lastUpdate === null || now.getTime() - lastUpdate.getTime() > staleAfterMs) {
+            stale.push({ issue: issue.number, lastUpdate, ageMinutes });
+        }
+    }
+    return stale;
+}
+/** Mark each stale task failed with a note. Returns what was changed. */
+async function reconcile(config, repoDir, now = new Date()) {
+    const stale = await findStaleTasks(config, now);
+    if (stale.length === 0) {
+        log.info('Reconcile: every in-progress issue has a recent status update.');
+        return [];
+    }
+    for (const s of stale) {
+        const age = s.ageMinutes === null ? 'no status comment' : `last update ${s.ageMinutes} min ago`;
+        log.warn(`#${s.issue} is in-progress with no live run (${age}). Marking failed.`);
+        try {
+            await (0, labels_js_1.setStateLabel)(config, s.issue, 'failed');
+            const task = await (0, task_recovery_js_1.recoverTask)(config, repoDir, s.issue);
+            if (task) {
+                await statusComment.updateStatusComment(config.repo, s.issue, {
+                    task: { ...task, status: 'failed' },
+                    message: `No Foundry job has reported on this issue for ${s.ageMinutes ?? 'an unknown number of'} minutes; the run that claimed it is gone (cancelled, timed out, or the runner died).\n\n\`@foundry go\` to continue from the branch · \`@foundry restart\` to start over`,
+                    historyEntry: 'Reconciled: no live run',
+                });
+            }
+            else {
+                await github.addComment(config.repo, s.issue, 'Foundry found this issue marked in-progress with no live run and no claim record. Marked failed; comment `@foundry go` to try again.');
+            }
+        }
+        catch (err) {
+            log.warn(`Reconcile: could not update #${s.issue}: ${err.message}`);
+        }
+    }
+    return stale;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/lib/reconcile.js.map

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