@loompad/cli 0.1.0 → 1.1.2

package/dist/daemon/deploys.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Deploys and release notes (Loom Teams, Phase 5; D72) — read-only.
+ *
+ * GitHub Environments stay the deploy gate; Loom never deploys. It watches a
+ * shared repo's deployments and posts their outcome to the team feed, alerts a
+ * member whose merged goal is in a deploy that failed, and writes release notes
+ * from the goals merged since a tag.
+ */
+import type { FeedIn } from "../core/team-hub.js";
+import type { Exec } from "./landing.js";
+import type { ProjectRuntime } from "./runtime.js";
+export interface Deployment {
+    id: number;
+    environment: string;
+    sha: string;
+    ref: string;
+    creator: string | null;
+    state: string;
+    url: string | null;
+    at: number;
+}
+/** The feed event a deployment's latest status is, if any (D72). */
+export declare function deployEvent(d: Deployment): FeedIn["type"] | null;
+export interface ReleaseEntry {
+    pr: number;
+    title: string;
+    author: string;
+    url: string;
+    mergedAt: string | null;
+    /** The goal's summary (the first paragraph of a Loom goal PR's body). */
+    summary?: string;
+    loom: boolean;
+}
+/** Release notes, grouped by member, Loom goals marked (D72). */
+export declare function renderReleaseNotes(since: string, until: string, entries: ReleaseEntry[]): string;
+/** PR numbers from first-parent commit subjects: merge commits and squash "(#123)" suffixes. */
+export declare function prNumbersFromLog(log: string): number[];
+export interface DeployDeps {
+    share(rt: ProjectRuntime): Promise<{
+        teamId: string;
+        repo: string;
+    } | null>;
+    post(rt: ProjectRuntime, e: FeedIn): Promise<void>;
+    exec?: Exec;
+}
+export declare const DEPLOY_POLL_MS: number;
+export declare class Deploys {
+    private rt;
+    private deps;
+    private alerted;
+    constructor(rt: ProjectRuntime, deps: DeployDeps);
+    private exec;
+    private ghJson;
+    /** The repo's recent deployments with their latest status. */
+    list(): Promise<Deployment[]>;
+    /** Post each deployment's latest status to the feed (idempotent), and alert on failed deploys of our goals. */
+    poll(): Promise<number>;
+    /** D25/D72: a failed deploy that contains one of our merged goals buzzes our phone. */
+    private alertIfOurs;
+    /** Release notes from the PRs merged into the default branch since `since` (a tag or commit). */
+    releaseNotes(since: string): Promise<string>;
+}

package/dist/daemon/deploys.js

@@ -0,0 +1,159 @@
+/**
+ * Deploys and release notes (Loom Teams, Phase 5; D72) — read-only.
+ *
+ * GitHub Environments stay the deploy gate; Loom never deploys. It watches a
+ * shared repo's deployments and posts their outcome to the team feed, alerts a
+ * member whose merged goal is in a deploy that failed, and writes release notes
+ * from the goals merged since a tag.
+ */
+import { execFile } from "../core/process.js";
+import { logbook } from "../core/logbook.js";
+import { notify } from "../core/notify.js";
+import { deployEventType, ghKey } from "../core/github-events.js";
+/** The feed event a deployment's latest status is, if any (D72). */
+export function deployEvent(d) {
+    return deployEventType(d.state);
+}
+/** Release notes, grouped by member, Loom goals marked (D72). */
+export function renderReleaseNotes(since, until, entries) {
+    if (!entries.length)
+        return `## Changes since ${since}\n\nNothing merged since ${since}.\n`;
+    const byAuthor = new Map();
+    for (const e of entries)
+        byAuthor.set(e.author, [...(byAuthor.get(e.author) ?? []), e]);
+    const lines = [`## Changes since ${since}`, "", `${entries.length} pull request${entries.length === 1 ? "" : "s"} merged into ${until}.`];
+    for (const [author, es] of [...byAuthor.entries()].sort((a, b) => b[1].length - a[1].length || a[0].localeCompare(b[0]))) {
+        lines.push("", `### @${author}`);
+        for (const e of es) {
+            lines.push(`- ${e.title} ([#${e.pr}](${e.url}))${e.loom ? " · _Loom goal_" : ""}`);
+            if (e.summary)
+                lines.push(`  ${e.summary.replace(/\s+/g, " ").slice(0, 300)}`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+/** PR numbers from first-parent commit subjects: merge commits and squash "(#123)" suffixes. */
+export function prNumbersFromLog(log) {
+    const out = [];
+    for (const line of log.split("\n")) {
+        const m = /Merge pull request #(\d+)/.exec(line) ?? /\(#(\d+)\)\s*$/.exec(line);
+        if (m)
+            out.push(Number(m[1]));
+    }
+    return [...new Set(out)];
+}
+const realExec = (cmd, args, cwd, opts = {}) => new Promise((resolve) => {
+    execFile(cmd, args, { cwd, timeout: opts.timeoutMs ?? 60_000, maxBuffer: 16 * 1024 * 1024 }, (err, out, errOut) => resolve({ code: err ? 1 : 0, out: String(out), err: String(errOut) }));
+});
+export const DEPLOY_POLL_MS = 2 * 60_000;
+export class Deploys {
+    rt;
+    deps;
+    alerted = new Set();
+    constructor(rt, deps) {
+        this.rt = rt;
+        this.deps = deps;
+    }
+    exec(cmd, args) {
+        return (this.deps.exec ?? realExec)(cmd, args, this.rt.info.dir);
+    }
+    async ghJson(args) {
+        const r = await this.exec("gh", args);
+        if (r.code !== 0)
+            return null;
+        try {
+            return JSON.parse(r.out);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** The repo's recent deployments with their latest status. */
+    async list() {
+        const share = await this.deps.share(this.rt);
+        if (!share)
+            return [];
+        const deps = (await this.ghJson(["api", `repos/${share.repo}/deployments?per_page=20`])) ?? [];
+        const out = [];
+        for (const d of deps) {
+            const id = Number(d.id);
+            const statuses = (await this.ghJson(["api", `repos/${share.repo}/deployments/${id}/statuses?per_page=1`])) ?? [];
+            const st = statuses[0];
+            out.push({
+                id,
+                environment: String(d.environment ?? ""),
+                sha: String(d.sha ?? ""),
+                ref: String(d.ref ?? ""),
+                creator: (d.creator?.login ?? null),
+                state: String(st?.state ?? "pending"),
+                url: st?.log_url || st?.environment_url || null,
+                at: Date.parse(String(st?.created_at ?? d.created_at ?? "")) || Date.now(),
+            });
+        }
+        return out;
+    }
+    /** Post each deployment's latest status to the feed (idempotent), and alert on failed deploys of our goals. */
+    async poll() {
+        let posted = 0;
+        const share = await this.deps.share(this.rt);
+        if (!share)
+            return 0;
+        for (const d of await this.list()) {
+            const type = deployEvent(d);
+            if (!type)
+                continue;
+            await this.deps.post(this.rt, {
+                repo: share.repo,
+                type,
+                meta: { id: d.id, environment: d.environment, sha: d.sha, ref: d.ref, state: d.state, url: d.url, creator: d.creator },
+                // the same key a deployment_status webhook produces (D84)
+                dedupeKey: ghKey.deploy(share.repo, d.id, type),
+            });
+            posted++;
+            if (type === "deploy_failed")
+                await this.alertIfOurs(d).catch(() => { });
+        }
+        return posted;
+    }
+    /** D25/D72: a failed deploy that contains one of our merged goals buzzes our phone. */
+    async alertIfOurs(d) {
+        const key = `${d.id}`;
+        if (this.alerted.has(key))
+            return;
+        await this.exec("git", ["fetch", "-q", "origin", d.sha]).catch(() => { });
+        for (const run of this.rt.orchestra.list()) {
+            const sha = run.landing?.mergeSha;
+            if (run.landing?.state !== "merged" || !sha)
+                continue;
+            const inIt = await this.exec("git", ["merge-base", "--is-ancestor", sha, d.sha]);
+            if (inIt.code !== 0)
+                continue;
+            this.alerted.add(key);
+            const text = `Deploy to ${d.environment} failed, and it includes your goal "${run.goal.split("\n")[0].slice(0, 80)}" (PR #${run.landing.pr})`;
+            this.rt.log.append({ kind: "orchestra", chat: run.chat, payload: { phase: "alert", runId: run.id, text } });
+            notify({ title: `Loom · ${this.rt.info.name}`, body: text });
+            return;
+        }
+    }
+    /** Release notes from the PRs merged into the default branch since `since` (a tag or commit). */
+    async releaseNotes(since) {
+        const head = (await this.exec("git", ["symbolic-ref", "--short", "refs/remotes/origin/HEAD"])).out.trim() || "origin/main";
+        await this.exec("git", ["fetch", "-q", "--tags", "origin"]);
+        const log = await this.exec("git", ["log", "--first-parent", "--format=%s", `${since}..${head}`]);
+        if (log.code !== 0)
+            throw new Error(`can't read history since ${since}: ${log.err.trim().slice(0, 200)}`);
+        const entries = [];
+        for (const n of prNumbersFromLog(log.out)) {
+            const pr = await this.ghJson(["pr", "view", String(n), "--json", "title,author,url,mergedAt,body,headRefName"]);
+            if (!pr) {
+                logbook.warn("team", `release notes: couldn't read PR #${n}`);
+                continue;
+            }
+            const loom = pr.headRefName.startsWith("loom/orchestra/");
+            const summary = loom ? pr.body.split(/\n\s*\n/)[0]?.trim() : undefined;
+            entries.push({ pr: n, title: pr.title, author: pr.author.login, url: pr.url, mergedAt: pr.mergedAt, loom, ...(summary ? { summary } : {}) });
+        }
+        return renderReleaseNotes(since, head.replace(/^origin\//, ""), entries);
+    }
+}
+//# sourceMappingURL=deploys.js.map

package/dist/daemon/deploys.js.map

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

package/dist/daemon/landing.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Landing — one project's goal PRs on their way to main (Loom Teams, Phase 4,
+ * "land safely"; docs/teams-architecture.md D52–D64).
+ *
+ * The owner's daemon watches its own goal PRs (D52) and, per PR:
+ *   - reruns a failing required check once; a pass on rerun is a flake (D53)
+ *   - hands a real failure's log tail to the goal's orchestrator, which reopens
+ *     the goal and routes a fix; at most `autoFixAttempts` (D54, D55)
+ *   - runs a cross-vendor review on open and after each fix, at most 3 times,
+ *     posting a COMMENT review and the `loom/review` status (D60, D61)
+ *   - when the owner clicks Land: fresh main in, fast tests, push, auto-merge
+ *     (D56–D58); stacks land bottom-up (D59)
+ *   - says when a goal needs someone, adopts a teammate's goal on request, and
+ *     hands it back when green (D63)
+ *   - Phase 6, on a repo with no merge queue: the landing train (D20, D79–D82).
+ *     Land queues the goal in its lanes (path scopes from `landing.lanes`); the
+ *     slot is a hub lease on `.loom/landing/<lane>`, a hard zone, so one goal per
+ *     lane holds it. The holder brings fresh base in, runs the fast tests,
+ *     pushes, waits for green on that head, and merges; a red check gives the
+ *     slot back and the goal requeues itself once it's green again.
+ *   - Phase 6: a feed event about one of its PRs (a webhook's check result, a
+ *     merge) polls that goal now, not at the next 30s tick (D84)
+ *
+ * Everything outside git and the hub goes through `gh`, injectable for tests.
+ */
+import { type LandingState, type OrchestraRun } from "../core/orchestra.js";
+import { type TeamKey } from "../core/team-crypto.js";
+import type { FeedEvent, HubClient, Presence } from "../core/team-hub.js";
+import { type DoctorFinding } from "../core/team-landing.js";
+import type { TeamPolicy } from "../core/team-policy.js";
+import type { ProjectRuntime } from "./runtime.js";
+export interface Exec {
+    (cmd: string, args: string[], cwd: string, opts?: {
+        timeoutMs?: number;
+        input?: string;
+    }): Promise<{
+        code: number;
+        out: string;
+        err: string;
+    }>;
+}
+export interface LandingDeps {
+    hub(): HubClient | null;
+    deviceId(): string | null;
+    github(): string | null;
+    share(rt: ProjectRuntime): Promise<{
+        teamId: string;
+        repo: string;
+    } | null>;
+    keys(teamId: string): TeamKey[];
+    feed(teamId: string): FeedEvent[];
+    presence(teamId: string): Presence[];
+    policy(): Promise<TeamPolicy | null>;
+    exec?: Exec;
+    /** Tests shorten the rerun settle window. */
+    rerunSettleMs?: number;
+    /** How long a freshly pushed turn with no checks reported yet waits before "no CI" (tests: 0). */
+    trainSettleMs?: number;
+}
+export declare const POLL_MS = 30000;
+/** D63: a teammate offline this long with a goal that needs someone can be adopted. */
+export declare const ADOPT_AFTER_MS: number;
+/** How long after asking for a rerun a still-failing check is taken as the old result. */
+export declare const RERUN_SETTLE_MS = 90000;
+/** A turn's fresh push with no checks reported after this long has no CI to wait for. */
+export declare const TRAIN_SETTLE_MS: number;
+/** How long a repo's branch rules (merge queue or not) are trusted (D80). */
+export declare const RULES_TTL_MS: number;
+export declare const defaultExec: Exec;
+export declare class Landing {
+    private rt;
+    private deps;
+    private busy;
+    private timer;
+    private alerted;
+    private rerunAt;
+    private rules;
+    private inflight;
+    constructor(rt: ProjectRuntime, deps: LandingDeps);
+    start(): void;
+    stop(): void;
+    private exec;
+    private gh;
+    private git;
+    /** Goals with a PR this daemon is responsible for right now. */
+    goals(): OrchestraRun[];
+    private set;
+    tick(): Promise<void>;
+    /**
+     * Poll one goal now, at most one poll per goal at a time: a poll asked for
+     * while one runs makes that one go round again (a webhook's check result
+     * mid-poll isn't lost), and both callers get its answer.
+     */
+    pollNow(run: OrchestraRun, policy?: TeamPolicy | null): Promise<LandingState>;
+    /** One look at one goal PR, and whatever it calls for. */
+    poll(run: OrchestraRun, policy?: TeamPolicy | null): Promise<LandingState>;
+    /** Required checks (D54), or every check when the repo requires none. */
+    private checks;
+    private fix;
+    private flaky;
+    private needsHuman;
+    /** D25: the owner's phone (and desktop) hears about what needs them. */
+    private alert;
+    private merged;
+    /** Actions minutes the goal's branch used (§10: CI cost per goal, no App needed). */
+    ciMinutes(run: OrchestraRun): Promise<number | null>;
+    review(run: OrchestraRun, sha: string, maxFix?: number): Promise<void>;
+    /** The owner overrides a blocking review, with a reason on record (D61). */
+    overrideReview(runId: string, reason: string): Promise<LandingState>;
+    private postStatus;
+    /**
+     * The owner clicked Land. Bring fresh main in (one agent attempt at a
+     * conflict), run the fast tests, push, and ask GitHub to merge when the
+     * rules pass. It keeps going on later polls until the PR merges.
+     */
+    land(runId: string): Promise<LandingState>;
+    /**
+     * Pushrebase-lite (D56–D58): fresh base merged into the goal (one agent
+     * attempt at a conflict), the fast tests, push. False when it went to a fix
+     * or a human instead of pushing.
+     */
+    private pushrebase;
+    /** Merge queue, train or auto-merge, for this goal (D80). Branch rules are cached per repo for 10 minutes. */
+    route(run: OrchestraRun): Promise<"queue" | "train" | "auto">;
+    /** The lanes this goal's PR needs: path scopes matched against its diff (D81). */
+    private lanesOf;
+    /**
+     * One step of a goal in the train: claim its lanes (or queue behind their
+     * holder), bring fresh base in and push on a new turn, wait for green on
+     * that head, merge.
+     */
+    private trainTurn;
+    /**
+     * Take every lane the goal needs, in order, or none: a lane held by someone
+     * else queues the goal behind them. The hub decides atomically — a lane's
+     * slot is a hard zone (D31), so a second claimer is refused.
+     */
+    private claimSlot;
+    /** Give the goal's lanes back (and only them: its task leases stay until it lands, D36). */
+    private releaseSlot;
+    /** Still the holder of every lane? A slot that went stale (a long sleep) may be someone else's now. */
+    private stillHolding;
+    /** Its turn, green: merge now (not --auto — the train is the queue), then hand the lanes on. */
+    private mergeNow;
+    private autoMerge;
+    private conflict;
+    private pollStack;
+    /**
+     * Close the stack's unmerged lower PRs and point the top one at the base
+     * branch: one PR again, carrying everything, that the fix loop can fix.
+     */
+    collapseStack(run: OrchestraRun, stack: NonNullable<LandingState["stack"]>, why: string): Promise<LandingState>;
+    private landStack;
+    /**
+     * Teammates' goal PRs that need someone: the owner said so (out of fix
+     * attempts), or its checks fail and the owner has been offline 15+ minutes.
+     */
+    adoptable(): Promise<Array<{
+        pr: number;
+        url: string;
+        branch: string;
+        owner: string;
+        ownerRunId?: string;
+        reason: string;
+    }>>;
+    /** Take a teammate's goal: a small run on this machine that makes its PR green. */
+    adopt(pr: number, opts?: {
+        orchestrator?: string;
+        workers?: string[];
+    }): Promise<OrchestraRun>;
+    /** The adopted PR is green (or merged): give the goal back (D63). */
+    private handBack;
+    /** The owner's side: a teammate took (or returned) one of our goals. */
+    onTeamEvent(e: FeedEvent): void;
+    private wakePr;
+    doctor(): Promise<{
+        repo: string | null;
+        branch: string;
+        findings: DoctorFinding[];
+        fixable: string[];
+    }>;
+    private workflows;
+    /** Open the PR adding `merge_group:` to every pull-request workflow missing it. Never touches settings. */
+    doctorFix(): Promise<{
+        prUrl: string | null;
+        files: string[];
+    }>;
+    private mustGoal;
+    private repo;
+    private post;
+    status(): Array<Record<string, unknown>>;
+}