@joynt/foundry 0.0.0-stage → 0.1.50

package/dist/lib/worktree.js

@@ -0,0 +1,113 @@
+"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.preserveWork = preserveWork;
+exports.ensureWorktree = ensureWorktree;
+/**
+ * Worktree lifecycle across jobs.
+ *
+ * A task's worktree lives only as long as the job that created it. When a job
+ * ends with the agent waiting on a human, the branch is pushed so nothing is
+ * lost; when a later job resumes the task, the worktree is recreated from the
+ * pushed branch. Both functions are idempotent and safe to call when there is
+ * nothing to do.
+ */
+const fs = __importStar(require("node:fs"));
+const git = __importStar(require("./git.js"));
+const log = __importStar(require("./log.js"));
+const branches_js_1 = require("./branches.js");
+/**
+ * Make the agent's work survive the end of this job: commit anything
+ * uncommitted, then push the branch if it has commits beyond its base.
+ * Never throws; a failure is logged and reported in the result so the
+ * status comment can say so.
+ */
+function preserveWork(config, task, repoDir, reason) {
+    const result = { committed: false, pushed: false };
+    const wt = task.worktree;
+    if (!fs.existsSync(wt))
+        return result;
+    try {
+        if (git.isDirty(wt)) {
+            git.commitAll(`chore(foundry): work in progress (${reason})`, wt);
+            result.committed = true;
+            log.info(`#${task.issue}: committed work in progress before pausing.`);
+        }
+    }
+    catch (err) {
+        log.warn(`#${task.issue}: could not commit work in progress: ${err.message}`);
+    }
+    try {
+        const base = (0, branches_js_1.resolveBaseBranch)(config, repoDir);
+        if (git.countCommits(`${base}..HEAD`, wt) > 0) {
+            git.push(task.branch, wt, true);
+            result.pushed = true;
+            log.info(`#${task.issue}: pushed ${task.branch}.`);
+        }
+    }
+    catch (err) {
+        log.warn(`#${task.issue}: could not push ${task.branch}: ${err.message}`);
+    }
+    return result;
+}
+/**
+ * Make sure the task's worktree exists before an agent is launched into it.
+ * In a fresh job it is recreated from the pushed branch; if the branch was
+ * never pushed, from the base branch.
+ */
+function ensureWorktree(config, task, repoDir) {
+    if (git.worktreeExists(task.worktree, repoDir) && fs.existsSync(task.worktree))
+        return;
+    try {
+        git.fetchAll(repoDir);
+    }
+    catch (err) {
+        log.warn(`Fetch failed before recreating worktree: ${err.message}`);
+    }
+    // A stale registration with no directory (job ended, path gone) must be pruned first.
+    git.pruneWorktrees(repoDir);
+    if (git.remoteBranchExists(task.branch, repoDir)) {
+        git.addWorktreeTracking(task.worktree, task.branch, repoDir);
+        log.info(`#${task.issue}: recreated worktree from origin/${task.branch}.`);
+    }
+    else {
+        const base = (0, branches_js_1.resolveBaseBranch)(config, repoDir);
+        if (git.branchExists(task.branch, repoDir))
+            git.deleteBranch(task.branch, repoDir);
+        git.addWorktree(task.worktree, task.branch, base, repoDir);
+        log.info(`#${task.issue}: created worktree for ${task.branch} from ${base} (branch was never pushed).`);
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/lib/worktree.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Joynt Foundry — Core type definitions
+ */
+export interface AgentBackendDef {
+    type: 'command';
+    /** Use a command Foundry maintains instead of copying one into config, where it would drift. */
+    preset?: 'claude-code';
+    /** Required unless `preset` is set. Overrides the preset's command when both are given. */
+    command?: string;
+    env?: Record<string, string>;
+}
+export interface FoundryConfig {
+    repo: string;
+    /**
+     * State labels. Foundry owns them: exactly one is on a tracked issue at a
+     * time and only Foundry adds or removes them. Humans never set a state
+     * label to make something happen; they comment a command.
+     */
+    labels: {
+        in_progress: string;
+        done: string;
+        ready_for_review: string;
+        waiting_for_input: string;
+        failed: string;
+        plan_review: string;
+    };
+    mode_labels?: {
+        plan: string;
+        auto: string;
+        default: string;
+    };
+    /**
+     * The repo's long-lived branches, by name. Feature branches are cut from
+     * and merged into `integration`; `production` is what it is promoted to.
+     * Never assumed: onboarding must not require renaming a branch that
+     * deploy tooling already keys on.
+     */
+    branches: {
+        integration: string;
+        production: string;
+    };
+    branch_template: string;
+    worktree_base: string;
+    max_input_rounds: number;
+    /** Passed to the agent as FOUNDRY_MAX_TURNS; the preset uses --max-turns. Default 150. */
+    agent_max_turns?: number;
+    /** An in-progress issue with no status update for this long is marked failed by `foundry reconcile`. Default 120. */
+    reconcile_stale_minutes?: number;
+    verify: string[];
+    /** Run against the live preview (FOUNDRY_PREVIEW_URL) before ready-for-review. Default []. */
+    verify_preview?: string[];
+    integration_rebuild: string;
+    /**
+     * The three commands, the only comments that start or stop work. Every
+     * other comment is context: it reaches the agent through the issue file
+     * on the next launch, and never starts a job.
+     */
+    comment_triggers: {
+        go: string;
+        restart: string;
+        stop: string;
+    };
+    version_sources: string[];
+    tag_prefix: string;
+    default_agent_backend: string;
+    agent_backends: Record<string, AgentBackendDef>;
+    agent_label_map?: Record<string, string>;
+    github_backend: 'gh-cli' | 'octokit';
+    preview?: {
+        mode: 'template' | 'provider';
+        url_template?: string;
+        up_command?: string;
+        down_command?: string;
+        comment?: boolean;
+        /**
+         * Also preview any pull request whose base branch is listed here, task or
+         * not: up on open/reopen, redeploy on push, down on close. For the
+         * promotion PR from `integration` into `main`.
+         */
+        pull_request_bases?: string[];
+        /** How long to wait for the preview URL to answer before verify_preview runs. Default 300. */
+        ready_timeout_seconds?: number;
+        /**
+         * Text the preview's body must contain before it counts as up, with
+         * {sha}, {branch}, {pr_number} expanded. Without it a redeploy is
+         * verified against the previous version still being served.
+         */
+        ready_match?: string;
+    };
+    review?: {
+        /** On an approving review: rebase onto the base, wait for checks, merge (rebase method). Default true. */
+        merge_on_approval?: boolean;
+        /** How long to wait for the PR's checks before giving up. Default 900. */
+        checks_timeout_seconds?: number;
+    };
+    github_deployments?: {
+        enabled: boolean;
+        environment?: string;
+        production?: boolean;
+        auto_inactive?: boolean;
+    };
+}
+export type TaskStatus = 'claimed' | 'agent-running' | 'verifying' | 'pr-open' | 'reviewing' | 'waiting-for-input' | 'resuming' | 'pr-changes-requested' | 'plan-review' | 'done' | 'failed' | 'stopped';
+export interface TaskState {
+    issue: number;
+    title: string;
+    repo: string;
+    branch: string;
+    worktree: string;
+    tmux_session: string;
+    pr_url?: string;
+    pr_number?: number;
+    agent_backend: string;
+    agent_command?: string;
+    status: TaskStatus;
+    claimed_at: string;
+    updated_at: string;
+    runner_id: string;
+    session_id?: string;
+    permission_mode?: string;
+    input_request_count?: number;
+    last_agent_message?: string;
+    /** Usage of the most recent agent run, from the transcript's result event. */
+    last_run?: {
+        cost_usd?: number;
+        turns?: number;
+        duration_ms?: number;
+    };
+    /** The issue body at claim time; written to FOUNDRY_ISSUE_FILE on every launch. */
+    issue_body?: string;
+    preview_url?: string;
+    deployment_id?: number;
+}
+export interface RunnerState {
+    runner_id: string;
+    repo: string;
+    tasks: Record<number, TaskState>;
+}
+export interface AgentLaunchParams {
+    worktree: string;
+    issue_url: string;
+    issue_number: number;
+    repo: string;
+    title: string;
+    body: string;
+    labels: string[];
+    log_dir: string;
+    state_dir: string;
+    permission_mode: string;
+}
+export interface AgentBackend {
+    name: string;
+    resolveCommand(params: AgentLaunchParams): string;
+    resolveEnv(params: AgentLaunchParams): Record<string, string>;
+}
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    body: string | null;
+    labels: Array<{
+        name: string;
+    }>;
+    html_url: string;
+    state: string;
+}
+export interface GitHubComment {
+    id: number;
+    body: string;
+    user: {
+        login: string;
+    } | null;
+    created_at: string;
+}
+export type AgentOutcomeType = 'completed' | 'needs-input' | 'plan-completed' | 'blocked' | 'errored';
+export interface AskUserQuestionOption {
+    label: string;
+    description: string;
+}
+export interface AskUserQuestionData {
+    question: string;
+    options: AskUserQuestionOption[];
+    multiSelect: boolean;
+}
+export interface AgentOutcome {
+    type: AgentOutcomeType;
+    session_id: string | null;
+    /** Text to show a human: the report summary, the plan, or a failure explanation. Never branched on. */
+    final_message: string | null;
+    ask_user_questions: AskUserQuestionData[] | null;
+    /** The agent's typed report, when it submitted a valid one. */
+    report?: import('./lib/agent-report.js').AgentReport | null;
+    /** Why the task failed or is blocked, for `errored` and `blocked`. */
+    reason?: string;
+    /** From the result event when present. */
+    usage?: {
+        cost_usd?: number;
+        turns?: number;
+        duration_ms?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Joynt Foundry — Core type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@joynt/foundry",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.50",
+  "description": "Developer automation: GitHub Issues → agent sessions → validated PRs",
+  "license": "MIT",
+  "bin": {
+    "foundry": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joyntshops/foundry.git",
+    "directory": "packages/foundry"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@octokit/auth-app": "^8.2.0",
+    "@octokit/rest": "^22.0.1",
+    "chalk": "^5.4.1",
+    "commander": "^12.1.0",
+    "yaml": "^2.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  }
+}

package/templates/foundry.yml

@@ -0,0 +1,121 @@
+# Foundry: GitHub Issues → coding agent → verified pull request.
+#
+# Every run is one GitHub event. Foundry reads the event, rebuilds task state
+# from the issue (labels + claim comment), performs the transition, and exits.
+# State lives on GitHub, not on any machine. Humans drive it with three issue
+# comments: `@foundry go`, `@foundry restart`, `@foundry stop`.
+#
+# GitHub starts issue_comment, schedule, and workflow_dispatch runs from the
+# DEFAULT branch, so this file and .joynt-foundry.yml govern those runs only
+# once they are on it. `gh workflow run foundry.yml --ref <branch> ...` runs
+# the copy on another branch.
+#
+# Secrets (repository or organization level):
+#   CLAUDE_CODE_OAUTH_TOKEN                   required. From `claude setup-token`; bills that Claude plan.
+#   FOUNDRY_APP_ID, FOUNDRY_APP_PRIVATE_KEY   a GitHub App installed on this repo (`foundry setup-bot`).
+#                                             With it, Foundry's comments and PRs carry the App's name and
+#                                             its PRs trigger the repo's other workflows. Without it the
+#                                             job's built-in token is used and agent PRs get no CI.
+name: Foundry
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request:
+    types: [opened, synchronize, reopened, closed]
+  pull_request_review:
+    types: [submitted]
+  # Foundry dispatches itself to hand a command to another issue's job (e.g.
+  # sending an agent to rebase after integration moved). Also how to run the
+  # workflow from a non-default branch: --ref <branch>.
+  workflow_dispatch:
+    inputs:
+      issue:
+        description: Issue number
+        required: true
+        type: string
+      command:
+        description: "Foundry command: go | restart | stop"
+        required: true
+        type: string
+      message:
+        description: Message for the agent
+        required: false
+        type: string
+        default: ""
+  # Reconcile: an in-progress issue whose run died without cleanup is marked
+  # failed. Each run costs about 30 seconds of runner time.
+  schedule:
+    - cron: '0 */6 * * *'
+
+permissions:
+  contents: write        # push branches
+  issues: write          # labels, claim/status comments
+  pull-requests: write   # open PRs, PR comments
+  checks: write          # verification results as a check run on the PR
+  actions: write         # workflow_dispatch to itself; preview up/down
+  deployments: write     # GitHub Deployment records for previews
+
+jobs:
+  foundry:
+    # Comments: only `@foundry` commands, only on issues (not PRs), only from
+    # people associated with the repo; the job then requires write permission
+    # before acting. Plain comments and labels never start a run; the agent
+    # reads them at its next launch. PR events: merges, and PRs into the
+    # production branch (previewed when preview.pull_request_bases lists it).
+    if: >-
+      (github.event_name == 'issue_comment' &&
+        !endsWith(github.event.comment.user.login, '[bot]') &&
+        !github.event.issue.pull_request &&
+        startsWith(github.event.comment.body, '@foundry') &&
+        contains(fromJSON('["OWNER", "MEMBER", "COLLABORATOR"]'), github.event.comment.author_association)) ||
+      (github.event_name == 'pull_request' &&
+        (github.event.pull_request.merged == true ||
+         github.event.pull_request.base.ref == '__PRODUCTION_BRANCH__')) ||
+      (github.event_name == 'pull_request_review' &&
+        (github.event.review.state == 'changes_requested' || github.event.review.state == 'approved')) ||
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'schedule'
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+
+    # One job at a time per issue, declared on the job so runs filtered out by
+    # the `if:` above never enter the group. `@foundry stop` cancels the issue's
+    # running job; everything else queues.
+    concurrency:
+      group: foundry-${{ github.event.inputs.issue || github.event.issue.number || github.event.pull_request.number || github.event_name }}
+      cancel-in-progress: ${{ github.event_name == 'issue_comment' && contains(github.event.comment.body, '@foundry stop') }}
+
+    env:
+      FOUNDRY_APP_ID: ${{ secrets.FOUNDRY_APP_ID }}   # secrets aren't readable in step `if:`
+
+    steps:
+      - name: Mint GitHub App token
+        id: app
+        if: env.FOUNDRY_APP_ID != ''
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.FOUNDRY_APP_ID }}
+          private-key: ${{ secrets.FOUNDRY_APP_PRIVATE_KEY }}
+
+      # Full history so the integration branch exists for worktrees and diffs.
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app.outputs.token || github.token }}
+          fetch-depth: 0
+
+      - name: Foundry
+        id: foundry
+        uses: joyntshops/foundry@main
+        with:
+          github-token: ${{ steps.app.outputs.token || github.token }}
+          claude-code-oauth-token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+      - name: Keep the agent transcript
+        if: always() && steps.foundry.outputs.log-dir != ''
+        uses: actions/upload-artifact@v4
+        with:
+          name: foundry-issue-${{ steps.foundry.outputs.issue }}-run-${{ github.run_id }}
+          path: ${{ steps.foundry.outputs.log-dir }}
+          if-no-files-found: ignore
+          retention-days: 30

package/templates/vercel-preview-url.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# Foundry preview `up_command` for a repo that Vercel's GitHub integration
+# already deploys: print the URL of the Vercel deployment that built
+# $FOUNDRY_SHA, waiting for it to succeed. No Vercel credential is needed.
+#
+# Vercel records each deployment in GitHub's Deployments API as
+# "Preview – <project>" or "Production – <project>", with the deployment URL in
+# `environment_url`. Reading that needs only the job's GitHub token. Each
+# commit gets its own URL, so a relaunched task is never verified against a
+# stale page, and no `down_command` is needed: Vercel expires previews itself.
+#
+# When the integration branch is the project's production branch, its commits
+# get a Production deployment, whose generated hostname may not serve a
+# host-keyed app correctly. For those, the project's production alias is
+# printed instead (VERCEL_PRODUCTION_URL); it serves exactly this commit once
+# the deployment has succeeded. This is the case for a promotion PR.
+#
+# Env: FOUNDRY_SHA and GH_TOKEN (set by Foundry's job), GITHUB_REPOSITORY (set by Actions),
+#      VERCEL_PREVIEW_PROJECT (required: the Vercel project name),
+#      VERCEL_PRODUCTION_URL (required only if the integration branch is the project's production branch),
+#      VERCEL_PREVIEW_TIMEOUT (seconds, default 900).
+set -u
+
+REPO="${GITHUB_REPOSITORY:?GITHUB_REPOSITORY is not set}"
+PROJECT="${VERCEL_PREVIEW_PROJECT:?VERCEL_PREVIEW_PROJECT is not set}"
+PRODUCTION_URL="${VERCEL_PRODUCTION_URL:-}"
+SHA="${FOUNDRY_SHA:?FOUNDRY_SHA is not set}"
+DEADLINE=$((SECONDS + ${VERCEL_PREVIEW_TIMEOUT:-900}))
+
+while [ "$SECONDS" -lt "$DEADLINE" ]; do
+  # Deployments for this commit, newest first; keep the one for our project.
+  found=$(gh api "repos/$REPO/deployments?sha=$SHA&per_page=20" \
+    --jq "[.[] | select(.environment | endswith(\"– $PROJECT\"))] | sort_by(.created_at) | last | select(. != null) | \"\(.id) \(.environment)\"" 2>/dev/null || true)
+  if [ -z "$found" ]; then
+    echo "Waiting for Vercel: no deployment of ${SHA:0:7} on $PROJECT recorded yet" >&2
+    sleep 20; continue
+  fi
+  dep="${found%% *}"; environment="${found#* }"
+  # Latest status wins: success carries the URL; failure/error/inactive end it.
+  status=$(gh api "repos/$REPO/deployments/$dep/statuses?per_page=1" \
+    --jq '.[0] | "\(.state) \(.environment_url // .target_url // "")"' 2>/dev/null || echo "unknown ")
+  state="${status%% *}"; url="${status#* }"
+  case "$state" in
+    success)
+      case "$environment" in
+        Production*)
+          if [ -n "$PRODUCTION_URL" ]; then
+            echo "Deployment $dep of ${SHA:0:7} is the production deployment of $PROJECT; using its alias $PRODUCTION_URL" >&2
+            echo "$PRODUCTION_URL"; exit 0
+          fi ;;
+      esac
+      [ -n "$url" ] && { echo "$url"; exit 0; }
+      echo "Deployment $dep succeeded but has no URL" >&2; exit 1 ;;
+    failure|error|inactive)
+      echo "Vercel deployment of ${SHA:0:7} on $PROJECT ended in '$state' (deployment $dep)" >&2; exit 1 ;;
+    *)
+      echo "Waiting for Vercel: deployment $dep of ${SHA:0:7} on $PROJECT is '${state:-pending}'" >&2; sleep 20 ;;
+  esac
+done
+echo "Timed out waiting for the Vercel deployment of ${SHA:0:7} on $PROJECT" >&2
+exit 1

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.