@joynt/foundry 0.0.0-stage → 0.1.51

package/dist/lib/completion.js

@@ -0,0 +1,63 @@
+"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.agentLogPath = agentLogPath;
+exports.buildAgentCompletedEvent = buildAgentCompletedEvent;
+/**
+ * Agent completion — turn an exited agent into an AgentCompletedEvent.
+ *
+ * Shared by the Poller (which discovers exits by polling worker handles) and
+ * `foundry action` (which waits on the subprocess directly). Both must
+ * classify the outcome identically, so the logic lives here once.
+ */
+const path = __importStar(require("node:path"));
+const state = __importStar(require("./state.js"));
+const agentOutput = __importStar(require("./agent-output.js"));
+const agent_report_js_1 = require("./agent-report.js");
+const branches_js_1 = require("./branches.js");
+function agentLogPath(config, issue) {
+    return path.join(state.getLogDir(config.repo, issue), 'agent.log');
+}
+function buildAgentCompletedEvent(config, repoDir, task, exitCode) {
+    const logPath = agentLogPath(config, task.issue);
+    const baseBranch = (0, branches_js_1.resolveBaseBranch)(config, repoDir);
+    const outcome = agentOutput.determineOutcome(logPath, task.worktree, baseBranch, {
+        permissionMode: task.permission_mode,
+        exitCode,
+        reportFile: (0, agent_report_js_1.reportFilePath)(state.getTaskStateDir(config.repo, task.issue)),
+    });
+    return { type: 'agent_completed', task, outcome };
+}
+//# sourceMappingURL=completion.js.map

package/dist/lib/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/lib/completion.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,oCAEC;AAED,4DAcC;AAjCD;;;;;;GAMG;AACH,gDAAkC;AAClC,kDAAoC;AACpC,+DAAiD;AACjD,uDAAmD;AAGnD,+CAAkD;AAElD,SAAgB,YAAY,CAAC,MAAqB,EAAE,KAAa;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,wBAAwB,CACtC,MAAqB,EACrB,OAAe,EACf,IAAe,EACf,QAAwB;IAExB,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAA,+BAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE;QAC/E,cAAc,EAAE,IAAI,CAAC,eAAe;QACpC,QAAQ;QACR,UAAU,EAAE,IAAA,gCAAc,EAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;KAC3E,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/dist/lib/deployments.d.ts

@@ -0,0 +1,21 @@
+export interface CreateDeploymentOpts {
+    repo: string;
+    ref: string;
+    environment: string;
+    description?: string;
+    transientEnvironment?: boolean;
+    productionEnvironment?: boolean;
+}
+export declare function createDeployment(opts: CreateDeploymentOpts): Promise<{
+    id: number;
+} | null>;
+export interface CreateDeploymentStatusOpts {
+    repo: string;
+    deploymentId: number;
+    state: 'pending' | 'success' | 'error' | 'failure' | 'inactive' | 'in_progress';
+    environmentUrl?: string;
+    description?: string;
+    autoInactive?: boolean;
+}
+export declare function createDeploymentStatus(opts: CreateDeploymentStatusOpts): Promise<void>;
+//# sourceMappingURL=deployments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/lib/deployments.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsBjG;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5F"}

package/dist/lib/deployments.js

@@ -0,0 +1,104 @@
+"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.createDeployment = createDeployment;
+exports.createDeploymentStatus = createDeploymentStatus;
+/**
+ * GitHub Deployments API — creates deployments and deployment statuses.
+ *
+ * Uses Octokit directly (the Deployments API has no `gh` CLI equivalent).
+ * All calls are best-effort: failures are logged as warnings, never thrown.
+ */
+const log = __importStar(require("./log.js"));
+function splitRepo(repo) {
+    const [owner, repoName] = repo.split('/');
+    return { owner, repo: repoName };
+}
+async function getOctokit(repo) {
+    try {
+        const { createOctokitInstance } = await import('./octokit-client.js');
+        const org = repo.split('/')[0];
+        return await createOctokitInstance(org);
+    }
+    catch (err) {
+        log.warn(`Failed to create Octokit instance for deployments: ${err.message}`);
+        return null;
+    }
+}
+async function createDeployment(opts) {
+    const ok = await getOctokit(opts.repo);
+    if (!ok)
+        return null;
+    const { owner, repo } = splitRepo(opts.repo);
+    try {
+        const { data } = await ok.rest.repos.createDeployment({
+            owner,
+            repo,
+            ref: opts.ref,
+            environment: opts.environment,
+            description: opts.description ?? 'Foundry preview deployment',
+            transient_environment: opts.transientEnvironment ?? true,
+            production_environment: opts.productionEnvironment ?? false,
+            auto_merge: false,
+            required_contexts: [],
+        });
+        return { id: data.id };
+    }
+    catch (err) {
+        log.warn(`Failed to create deployment for ${opts.repo}@${opts.ref}: ${err.message}`);
+        return null;
+    }
+}
+async function createDeploymentStatus(opts) {
+    const ok = await getOctokit(opts.repo);
+    if (!ok)
+        return;
+    const { owner, repo } = splitRepo(opts.repo);
+    try {
+        await ok.rest.repos.createDeploymentStatus({
+            owner,
+            repo,
+            deployment_id: opts.deploymentId,
+            state: opts.state,
+            environment_url: opts.environmentUrl,
+            description: opts.description,
+            auto_inactive: opts.autoInactive ?? true,
+        });
+    }
+    catch (err) {
+        log.warn(`Failed to create deployment status for deployment ${opts.deploymentId}: ${err.message}`);
+    }
+}
+//# sourceMappingURL=deployments.js.map

package/dist/lib/deployments.js.map

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

package/dist/lib/event-handler.d.ts

@@ -0,0 +1,74 @@
+import type { FoundryConfig, TaskState, AgentOutcome } from '../types.js';
+import type { FoundryEvent } from './events.js';
+/** What every non-success ending tells the human. */
+export declare const FAILED_FOOTER = "`@foundry go` to continue from the branch \u00B7 `@foundry restart` to start over";
+export type ResumeKind = 'answer' | 'plan' | 'review' | 'go';
+/**
+ * What a relaunched agent is told about why it is being launched again. Goes
+ * in FOUNDRY_RESUME_CONTEXT; the Claude preset's prompt includes it.
+ */
+export declare function buildResumeContext(task: TaskState, humanText: string, kind: ResumeKind): string;
+/** The PR description: what the agent says it did and what it assumed, for the reviewer. */
+export declare function buildPRBody(task: TaskState, outcome?: AgentOutcome): string;
+export declare class EventHandler {
+    private config;
+    private repoDir;
+    constructor(config: FoundryConfig, repoDir: string);
+    /**
+     * Environment for an agent launch: the backend's own env plus the issue
+     * file (body and the human thread), the report contract (schema + report
+     * file, with any previous launch's report cleared), and the turn cap.
+     */
+    private launchEnv;
+    private briefFor;
+    handleEvent(event: FoundryEvent): Promise<void>;
+    private handlePRApproved;
+    private handlePRPreview;
+    /**
+     * Run `verify_preview` for a non-task PR from a throwaway checkout of its
+     * head branch. The result goes on the PR as a comment and, when the token
+     * allows, as a check run on the head SHA.
+     */
+    private verifyPullRequestPreview;
+    private handleCommand;
+    /**
+     * `@foundry go`: start the issue if it has never been started; otherwise
+     * proceed from the branch. The agent reads the whole thread from the issue
+     * file, so the same command answers a question, approves a plan, revises a
+     * PR, or picks up a failed task. On a task whose label still says running,
+     * the job that ran it is gone (a live job would have made this one wait),
+     * so it is resumed like any other.
+     */
+    private handleCommandGo;
+    /** `@foundry restart`: discard everything and start the issue again, in this job. */
+    private handleCommandRestart;
+    /** `@foundry stop`: stop the agent, keep the branch, mark the task failed. */
+    private handleCommandStop;
+    private startTask;
+    private handlePRMerged;
+    private handlePRReview;
+    private handleAgentCompleted;
+    /** The agent ended without finishing. The branch is kept so `go` can continue it. */
+    private handleFailedRun;
+    /**
+     * The last mile after a PR exists: deploy the preview, verify against it
+     * when `verify_preview` is configured, and only then mark the task ready
+     * for human review. A failed preview verification fails the task with the
+     * output on the issue, exactly like a failed build.
+     */
+    private finishReadyForReview;
+    private handleCompleted;
+    private handleNeedsInput;
+    private handlePlanCompleted;
+    /**
+     * Launch the agent again on the task's branch. Sessions do not survive
+     * jobs, so this is a fresh process: the worktree is recreated from the
+     * pushed branch, the thread goes in the issue file, and why it is being
+     * launched goes in FOUNDRY_RESUME_CONTEXT. Always in auto mode: a plan has
+     * been approved or a human has asked for work.
+     */
+    private relaunch;
+    /** A review requested changes: relaunch with the review, within the input-round cap. */
+    private resumeAgentForPR;
+}
+//# sourceMappingURL=event-handler.d.ts.map

package/dist/lib/event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.d.ts","sourceRoot":"","sources":["../../src/lib/event-handler.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAqB,YAAY,EAAe,MAAM,aAAa,CAAC;AAC1G,OAAO,KAAK,EACV,YAAY,EAOb,MAAM,aAAa,CAAC;AAMrB,qDAAqD;AACrD,eAAO,MAAM,aAAa,sFAAiF,CAAC;AAM5G,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAyB/F;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAW3E;AAsDD,qBAAa,YAAY;IAErB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;gBADP,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM;IAGzB;;;;OAIG;YACW,SAAS;IA4BvB,OAAO,CAAC,QAAQ;IAIV,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAmBvC,gBAAgB;YA8ChB,eAAe;IA2C7B;;;;OAIG;YACW,wBAAwB;YA0DxB,aAAa;IAW3B;;;;;;;OAOG;YACW,eAAe;IA4B7B,qFAAqF;YACvE,oBAAoB;IAwBlC,8EAA8E;YAChE,iBAAiB;YA+BjB,SAAS;YA0HT,cAAc;YAwBd,cAAc;YAad,oBAAoB;IA8BlC,qFAAqF;YACvE,eAAe;IA2B7B;;;;;OAKG;YACW,oBAAoB;YA0DpB,eAAe;YAuIf,gBAAgB;YA+ChB,mBAAmB;IAuCjC;;;;;;OAMG;YACW,QAAQ;IA2CtB,wFAAwF;YAC1E,gBAAgB;CAiC/B"}