@gtc6244/immediacy-daemon 0.1.0

package/dist/src/github.js

@@ -0,0 +1,178 @@
+/**
+ * GitHub integration via the `gh` CLI.
+ *
+ * Why gh, not a stored token: the daemon runs on the user's Mac where `gh` is
+ * already authenticated. Reusing it means the GitHub token never touches the
+ * phone, the wire, or this source — it stays in gh's keychain (§ no secrets in
+ * source / single-user). The daemon just shells out.
+ *
+ * Flow: list the user's repos → user picks one → `cloneInto` clones it into the
+ * project's managed directory → the normal worktree path forks off that clone.
+ */
+import { execFile } from "node:child_process";
+import { mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+/**
+ * Legacy clone cache. New GitHub projects clone into the managed projects root
+ * (see projects.ts); this constant survives only so pre-existing project
+ * records whose repo path points here are still recognised as cached clones.
+ */
+export const REPO_CACHE = process.env.REPO_CACHE ?? join(homedir(), ".immediacy", "repos");
+/** Is `gh` installed AND logged in? Drives whether the app shows the picker. */
+export async function status() {
+    try {
+        await exec("gh", ["--version"]);
+    }
+    catch {
+        return { available: false, authenticated: false };
+    }
+    try {
+        // `gh auth status` exits non-zero when not logged in.
+        await exec("gh", ["auth", "status"]);
+        const { stdout } = await exec("gh", ["api", "user", "--jq", ".login"]);
+        return { available: true, authenticated: true, user: stdout.trim() };
+    }
+    catch {
+        return { available: true, authenticated: false };
+    }
+}
+/**
+ * List every repo the authenticated user can access, most-recently-pushed
+ * first.
+ *
+ * Why `gh api /user/repos` and not `gh repo list`: `gh repo list` only returns
+ * repos the user *owns*, so repos where they're a collaborator or org member
+ * never reach the picker. `/user/repos?affiliation=owner,collaborator,
+ * organization_member` returns the full set the account has access to. We reshape
+ * the REST fields into our `GhRepoJson` shape (jq runs per page; `--paginate`
+ * follows Link headers, so output is newline-delimited JSON objects).
+ */
+export async function listRepos(limit = 100) {
+    const { stdout } = await exec("gh", [
+        "api",
+        "--paginate",
+        "--jq",
+        ".[] | { nameWithOwner: .full_name, name: .name, owner: { login: .owner.login }, description: .description, isPrivate: .private, defaultBranch: .default_branch, url: .html_url }",
+        "/user/repos?affiliation=owner,collaborator,organization_member&sort=pushed&per_page=100",
+    ], { maxBuffer: 32 * 1024 * 1024 });
+    const cap = Math.min(Math.max(limit, 1), 1000);
+    const raw = stdout
+        .split("\n")
+        .filter((line) => line.trim() !== "")
+        .map((line) => JSON.parse(line));
+    return raw.slice(0, cap).map((r) => ({
+        fullName: r.nameWithOwner,
+        name: r.name,
+        owner: r.owner?.login ?? r.nameWithOwner.split("/")[0] ?? "",
+        description: r.description ?? "",
+        isPrivate: r.isPrivate,
+        defaultBranch: r.defaultBranch ?? "HEAD",
+        url: r.url,
+    }));
+}
+/**
+ * Clone a GitHub repo into `dest` via `gh` (uses gh's auth, so private repos
+ * work). The caller owns `dest` — it lives in the managed projects root, so the
+ * client never chooses where the clone lands.
+ */
+export async function cloneInto(fullName, dest) {
+    await mkdir(dirname(dest), { recursive: true });
+    await exec("gh", ["repo", "clone", fullName, dest], {
+        maxBuffer: 64 * 1024 * 1024,
+    });
+}
+/**
+ * List a project's open pull requests, newest first. Runs `gh` with the repo
+ * clone as its cwd so it targets that repo's `origin` without us threading the
+ * `fullName` through — the same keychain-auth stance as the rest of this file.
+ * Returns [] rather than throwing when `gh` is absent/unauthenticated or the
+ * project has no GitHub remote, so the picker just shows "no open PRs".
+ */
+export async function listPullRequests(repoPath) {
+    try {
+        const { stdout } = await exec("gh", [
+            "pr",
+            "list",
+            "--state",
+            "open",
+            "--limit",
+            "100",
+            "--json",
+            "number,title,headRefName,author,url,isDraft",
+        ], { cwd: repoPath, maxBuffer: 16 * 1024 * 1024 });
+        const raw = JSON.parse(stdout || "[]");
+        return raw.map((p) => ({
+            number: p.number,
+            title: p.title,
+            headRefName: p.headRefName,
+            author: p.author?.login ?? "",
+            url: p.url,
+            isDraft: p.isDraft,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Resolve an open PR's head branch name. Used by the "create worktree from PR"
+ * flow to know which ref to check out. Throws (unlike the list calls) because
+ * the caller can't proceed without it.
+ */
+export async function prHeadRef(repoPath, prNumber) {
+    const { stdout } = await exec("gh", ["pr", "view", String(prNumber), "--json", "headRefName", "--jq", ".headRefName"], { cwd: repoPath });
+    const ref = stdout.trim();
+    if (!ref)
+        throw new Error(`could not resolve head branch for PR #${prNumber}`);
+    return ref;
+}
+/**
+ * List a project's open issues (with bodies), newest first. Bodies ride along
+ * so the "create worktree from an issue" flow can seed and let the user confirm
+ * the new worktree's task without a second round-trip. Best-effort like
+ * {@link listPullRequests} — returns [] on any `gh` failure.
+ */
+export async function listIssues(repoPath) {
+    try {
+        const { stdout } = await exec("gh", ["issue", "list", "--state", "open", "--limit", "100", "--json", "number,title,body,author,url"], { cwd: repoPath, maxBuffer: 16 * 1024 * 1024 });
+        const raw = JSON.parse(stdout || "[]");
+        return raw.map((i) => ({
+            number: i.number,
+            title: i.title,
+            body: i.body ?? "",
+            author: i.author?.login ?? "",
+            url: i.url,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Open a GitHub issue in the workspace's repo via `gh issue create` and return
+ * its URL — the mirror of `prCreate`. The agent's produced plan/document is the
+ * `body`. Runs with the worktree as cwd so `gh` targets the right repo.
+ */
+export async function createIssue(repoPath, title, body) {
+    const { stdout } = await exec("gh", ["issue", "create", "--title", title, "--body", body], { cwd: repoPath });
+    // `gh issue create` prints the new issue's URL as its last line.
+    return stdout.trim().split("\n").pop() ?? "";
+}
+/**
+ * Best-effort refresh of an existing clone's base branch. Never throws, so a
+ * daemon that's offline keeps using the clone it already has.
+ */
+export async function refreshRepo(repoPath) {
+    try {
+        await exec("git", ["-C", repoPath, "fetch", "--all", "--prune"], {
+            maxBuffer: 16 * 1024 * 1024,
+        });
+    }
+    catch {
+        /* offline / transient — keep using the existing clone */
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/src/github.js.map

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

package/dist/src/gitops.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Git review-and-merge operations for a workspace: status, commit, push, PR.
+ *
+ * These power the Conductor-style "review the diff → commit → push → open a
+ * PR" path from a pure-front-end client. Everything runs inside the worktree;
+ * the PR goes through the `gh` CLI so its keychain auth is reused (same stance
+ * as github.ts — no tokens on the wire or in source).
+ */
+import type { GitStatusResultPayload, GitResultPayload } from "./protocol.js";
+import type { WorkspaceRecord } from "./types.js";
+export declare function originUrl(repoPath: string): Promise<string | undefined>;
+/** Drop a cached origin URL (e.g. after a remote is added/changed). */
+export declare function forgetOriginUrl(repoPath: string): void;
+/** Ahead/behind + dirty-file summary against the workspace's merge-to ref. */
+export declare function gitStatus(record: WorkspaceRecord): Promise<GitStatusResultPayload>;
+/** Stage everything and commit. Fails soft ("nothing to commit") into ok:false. */
+export declare function gitCommit(record: WorkspaceRecord, message: string): Promise<GitResultPayload>;
+/**
+ * Push the workspace branch. When `autoSetupRemote` is true (the default and the
+ * git.worktreePushAutoSetupRemote config default), sets the upstream on first
+ * push with `-u`; when false, pushes without configuring the upstream.
+ */
+export declare function gitPush(record: WorkspaceRecord, autoSetupRemote?: boolean): Promise<GitResultPayload>;
+/** The remote's view of a branch's most recent PR ("NONE" = none / `gh` failed). */
+export type PrState = "OPEN" | "MERGED" | "CLOSED" | "NONE";
+/**
+ * A branch's most recent PR as seen through `gh`. `number`/`url`/`headRef` are
+ * null exactly when no PR exists (`state === "NONE"`); when a PR exists they
+ * carry its number, web URL, and head branch name so callers can surface a link
+ * and reconcile the workspace label to the PR's branch.
+ */
+export interface PrInfo {
+    state: PrState;
+    number: number | null;
+    url: string | null;
+    /** The PR's head branch (`headRefName`). */
+    headRef: string | null;
+    /** The PR's title as shown on GitHub. */
+    title: string | null;
+}
+/** Default freshness window for a branch's cached PR state. */
+export declare const DEFAULT_PR_STATE_TTL_MS = 60000;
+/**
+ * The workspace branch's PR (state + number/url/head) via `gh pr view <branch>`
+ * (reuses keychain auth, same stance as prCreate), cached per branch to bound
+ * `gh` invocations on the status-poll path: at most one lookup per `ttlMs`, and
+ * concurrent callers for the same branch (a merged-check, a hasPr probe, and the
+ * label-reconcile in the same poll) ride a single in-flight request. Best effort
+ * throughout — a failed lookup resolves to {@link NO_PR} and the throttle still
+ * advances, so an unreachable remote isn't retried every poll.
+ */
+export declare function prInfo(record: WorkspaceRecord, ttlMs?: number): Promise<PrInfo>;
+/** Just the {@link prInfo} state enum — the common case for merge/archive gates. */
+export declare function prState(record: WorkspaceRecord, ttlMs?: number): Promise<PrState>;
+/**
+ * Forget a branch's cached PR state so the next {@link prState} re-queries `gh`.
+ * Called after opening or merging a PR so the buttons re-key to the new state on
+ * the very next status poll instead of lingering until the TTL lapses.
+ */
+export declare function invalidatePrState(record: WorkspaceRecord): void;
+/** Testing/reset hook: forget all cached PR state. */
+export declare function resetPrStateCache(): void;
+/**
+ * Whether the workspace branch's PR has been merged on the remote. Best effort:
+ * any failure (no PR, `gh` unauthenticated/absent, network) reads as not-merged
+ * so the caller simply doesn't auto-archive.
+ */
+export declare function detectMerged(record: WorkspaceRecord): Promise<boolean>;
+/**
+ * Open a PR for the workspace branch via `gh pr create`. If one already exists
+ * for this branch, surface its URL instead of failing.
+ */
+export declare function prCreate(record: WorkspaceRecord, title: string, body?: string): Promise<GitResultPayload>;
+/**
+ * Merge the workspace branch's open PR on the remote via `gh pr merge --merge`.
+ * Backs the "Merge" button, which surfaces only for an open PR that is clean
+ * (no conflicts with the base). On success we drop the cached PR state so the
+ * next status poll sees the PR as merged and swaps Merge for the Archive
+ * affordance. Best effort on the error path, same keychain-auth stance as
+ * prCreate.
+ */
+export declare function prMerge(record: WorkspaceRecord): Promise<GitResultPayload>;
+/**
+ * Reconcile the worktree with its merge-to branch. Used by the "Resolve"
+ * action, which surfaces only when the base has advanced past this branch
+ * (`behind > 0`) and the tree is clean.
+ *
+ * We fetch `origin/<base>` first so we reconcile against what's actually on the
+ * remote, then merge that ref (falling back to the local base when there is no
+ * remote-tracking ref, e.g. offline or base never pushed). A clean merge lands
+ * a merge commit. A conflicting merge is *left in progress on purpose*: the
+ * client drops into its in-app conflict flow (see `gitMerge`) to pick a side
+ * per file and commit, or abort. We refuse up front if the tree is dirty, since
+ * `git merge` would bail anyway with a less friendly message.
+ */
+export declare function gitResolve(record: WorkspaceRecord): Promise<GitResultPayload>;
+/**
+ * Drive an in-progress merge from the client's conflict UI:
+ *  - `ours`   — keep the workspace branch's version of the conflicting files
+ *  - `theirs` — keep the merged-in base branch's version
+ *  - `commit` — finalize the merge commit (refuses while conflicts remain)
+ *  - `abort`  — roll the merge back, restoring the pre-merge worktree
+ *
+ * `ours`/`theirs` default to every conflicting file; pass `paths` to resolve a
+ * subset (per-file resolution). After picking a side we `git add` the files so
+ * git marks them resolved.
+ */
+export declare function gitMerge(record: WorkspaceRecord, action: "ours" | "theirs" | "commit" | "abort", paths?: string[]): Promise<GitResultPayload>;
+/**
+ * Reveal the worktree on this Mac: Finder, Terminal, or the user's editor.
+ * Editor prefers the VS Code CLI when installed, then falls back to `open -a`.
+ */
+export declare function openWorktree(record: WorkspaceRecord, target: "finder" | "terminal" | "editor"): Promise<void>;