@openagt/dashboard 0.8.0 → 0.9.0

package/dist/dashboard/gh.js.map

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

package/dist/dashboard/github.d.ts

@@ -1,11 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-/**
- * Normalize a git remote URL to an `https://github.com/<owner>/<repo>` URL, or undefined when
- * it is not a GitHub remote. Handles the scp-style (`git@github.com:o/r.git`), ssh
- * (`ssh://git@github.com/o/r.git`), and https (`https://github.com/o/r.git`) forms, dropping
- * a `.git` suffix, an embedded credential, and a trailing slash.
- */
-export declare function githubUrlFromRemote(remote: string): string | undefined;
-/** The repo's GitHub URL from its `origin` remote, or undefined (no remote / not GitHub). */
-export declare function githubUrlFor(cwd: string, git?: GitRunner): Promise<string | undefined>;
-//# sourceMappingURL=github.d.ts.map

package/dist/dashboard/github.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/dashboard/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAKpE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtE;AAED,6FAA6F;AAC7F,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,SAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7G"}

package/dist/dashboard/github.js

@@ -1,33 +0,0 @@
-import { nodeGitRunner } from '@gemstack/agent-data';
-// The project panel's "Open on GitHub" (#489, part of #488). Derives the repo's github.com
-// URL from its `origin` remote so the panel can link straight to it. A read of git state,
-// safe anywhere — the relay has no local checkout, so it resolves to nothing there.
-/**
- * Normalize a git remote URL to an `https://github.com/<owner>/<repo>` URL, or undefined when
- * it is not a GitHub remote. Handles the scp-style (`git@github.com:o/r.git`), ssh
- * (`ssh://git@github.com/o/r.git`), and https (`https://github.com/o/r.git`) forms, dropping
- * a `.git` suffix, an embedded credential, and a trailing slash.
- */
-export function githubUrlFromRemote(remote) {
-    const url = remote.trim();
-    const match = url.match(/^git@github\.com:(.+?)$/) ||
-        url.match(/^ssh:\/\/git@github\.com\/(.+?)$/) ||
-        url.match(/^https?:\/\/(?:[^@/]+@)?github\.com\/(.+?)$/);
-    if (!match || !match[1])
-        return undefined;
-    const slug = match[1].replace(/\.git$/, '').replace(/\/$/, '');
-    // Guard against a junk capture: a GitHub slug is `owner/repo`, both non-empty.
-    if (!/^[^/]+\/[^/]+$/.test(slug))
-        return undefined;
-    return `https://github.com/${slug}`;
-}
-/** The repo's GitHub URL from its `origin` remote, or undefined (no remote / not GitHub). */
-export async function githubUrlFor(cwd, git = nodeGitRunner()) {
-    try {
-        return githubUrlFromRemote(await git(['remote', 'get-url', 'origin'], cwd));
-    }
-    catch {
-        return undefined;
-    }
-}
-//# sourceMappingURL=github.js.map

package/dist/dashboard/github.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/dashboard/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,sBAAsB,CAAA;AACpE,2FAA2F;AAC3F,0FAA0F;AAC1F,oFAAoF;AAEpF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IACzB,MAAM,KAAK,GACT,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC;QACpC,GAAG,CAAC,KAAK,CAAC,kCAAkC,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAC1D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC9D,+EAA+E;IAC/E,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAClD,OAAO,sBAAsB,IAAI,EAAE,CAAA;AACrC,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,GAAG,GAAc,aAAa,EAAE;IAC9E,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/dashboard/run-handoff.d.ts

@@ -1,311 +0,0 @@
-import { type GitRunner } from '../project.js';
-import { type GhRunner, type LinkedPr, type BranchPrLookup } from './gh.js';
-import type { Cached } from './cache.js';
-import type { AutoHandoffSkip, AutoMergeOutcome, MergeWithheldReason } from '../events.js';
-import { type RunMeta } from '../store/index.js';
-/** One commit a session put on its branch. */
-export interface HandoffCommit {
-    sha: string;
-    /** Short sha, for display. */
-    short: string;
-    subject: string;
-}
-/** One file the session changed, against the branch point. */
-export interface HandoffFile {
-    path: string;
-    insertions: number;
-    deletions: number;
-    /** True for a binary file, where line counts are meaningless. */
-    binary: boolean;
-}
-/** What a finished session produced and what can still be done with it. */
-export interface RunHandoff {
-    /** The branch the work is on. */
-    branch: string;
-    /** The branch still exists in the repo (a deleted or never-created one does not). */
-    exists: boolean;
-    /** What the branch is measured against (the repo's default branch), when one was found. */
-    base?: string;
-    commits: HandoffCommit[];
-    files: HandoffFile[];
-    insertions: number;
-    deletions: number;
-    /**
-     * The session produced nothing to hand off: the branch exists but carries no commit the base
-     * does not already have — or nothing beyond the framework's own bookkeeping (#1291), which is
-     * committed for provenance, never as publishable work. Said out loud, rather than shown as an
-     * empty branch.
-     */
-    empty: boolean;
-    /** The repo has a remote to push to at all. */
-    hasRemote: boolean;
-    /** The branch is on the remote and the remote is at the same commit. */
-    pushed: boolean;
-    /** The branch is already merged into the base. */
-    merged: boolean;
-    /** The PR opened for this branch, when there is one. */
-    pr?: LinkedPr;
-    /** The PR is not known yet, rather than absent (#1028): the lookup is still running. */
-    prPending?: boolean;
-    /**
-     * The files the session changed and never committed, read from its own checkout (#1173).
-     *
-     * The agent is instructed to commit what it *found*, never what it *wrote*, so a settled session
-     * can hold its whole output in an uncommitted tree. That work is not on the branch yet, so it is
-     * not in {@link commits} and it does not make {@link empty} false. Paths rather than a count,
-     * because a no-diff branch must *name* what is waiting instead of offering an Open PR that
-     * GitHub can only refuse. Absent when the caller did not say which checkout the session worked
-     * in — "nobody asked" and "asked, tree clean" are different answers.
-     */
-    pendingFiles?: string[];
-}
-/** Injectable seams so the reader is unit-testable off disk, plus the checkout the session worked in. */
-export interface RunHandoffDeps {
-    git?: GitRunner;
-    pr?: BranchPrLookup;
-    /**
-     * The session's own checkout (#453), when it has one. The branch lives in the project repo and is
-     * read from there; uncommitted work does not, it sits in the tree the agent actually edited.
-     */
-    checkout?: string;
-    /**
-     * When the run started (ISO), so the PR lookup can tell the run's own PR from an earlier run's
-     * on the same branch name (#1251). Without it, only an open PR is trusted.
-     */
-    since?: string;
-}
-/**
- * The branch a run's work is on.
- *
- * Prefers what was recorded while the worktree existed (#799), because the #326 prompt lets the
- * agent name its own branch, which makes both derivations below a guess. They stay as a fallback
- * for runs archived before the branch was recorded.
- */
-export declare function runBranchFor(run: {
-    id: string;
-    branch?: string;
-    sessionName?: string;
-}): string;
-/** What {@link resolveRunPr} needs to know about a run: structurally satisfied by {@link RunMeta}. */
-export interface RunPrRun {
-    id: string;
-    startedAt?: string;
-    branch?: string;
-    sessionName?: string;
-}
-/** The injectable lookup seam for {@link resolveRunPr}: a branch's cached PR history. */
-export type BranchPrsLookup = (cwd: string, branch: string) => Promise<Cached<LinkedPr[]>>;
-/**
- * The PR that belongs to a run, tried across every branch name the run may have worked under
- * (#1251/#1255): the recorded branch, the session-name branch, then the run-id branch.
- *
- * The ladder is what makes a hands-off web run resolvable: its local worktree is torn down (or
- * never existed), its meta may carry only a session name whose branch is a reused pin, but the
- * cloud session pushed the run-id branch, which no other run can ever have. Each candidate is
- * filtered through {@link pickRunPr} with the run's start time, so a predecessor's PR on a shared
- * branch name is never the answer. `pending` only when nothing was found and a lookup is still
- * running, so the caller can ask again rather than render "no PR".
- */
-export declare function resolveRunPr(cwd: string, run: RunPrRun, prs?: BranchPrsLookup): Promise<Cached<LinkedPr | undefined>>;
-/**
- * Merge a finished session's open PR (#1391): the Merge action, pressed by a human.
- *
- * The direct answer to the withheld-merge ending (#1363): a session whose agent never signalled
- * ready-for-merge leaves a draft PR behind, and this is the human saying "it's good, land it".
- * `ghMergePr` marks a draft ready on the way, for exactly that case. Refuses when the run has no
- * PR or it is no longer open — "already merged" is an answer, not an action.
- */
-export declare function mergeSessionPr(cwd: string, run: RunPrRun, deps?: {
-    gh?: GhRunner;
-    prs?: BranchPrsLookup;
-}): Promise<HandoffResult>;
-/**
- * Whether a branch is one a session made, rather than one the user did.
- *
- * Only a naming convention, so it is a guess for the case #326 allows — the agent picking its own
- * branch name. Every caller uses it to decide how loudly to surface something, never to act.
- */
-export declare function isSessionBranch(branch: string | undefined): boolean;
-/**
- * Read what a finished session left behind, from the project repo, for `branch`.
- *
- * Returns undefined only when `cwd` is not a git repo at all. A branch that no longer exists
- * still returns a handoff (with `exists: false`), because "that branch is gone" is itself the
- * answer the dashboard needs to show.
- */
-export declare function readRunHandoff(cwd: string, branch: string, deps?: RunHandoffDeps): Promise<RunHandoff | undefined>;
-/**
- * Commit what a session left uncommitted, so what it did is what gets handed off (#1173).
- *
- * The automatic handoff commits the session's leftovers on the run's way out, but that happens
- * when the run process exits, and the finishing step is offered as soon as the agent settles
- * (#1178), which for a session left open for another turn is much earlier. Pressing the button is
- * the same instruction given by hand, so it sweeps the same leftovers into what it publishes. The
- * button only shows for a branch that already carries commits (#1173): a no-diff branch names its
- * uncommitted work instead of offering a step, so this never turns "nothing committed" into a PR
- * by itself.
- *
- * Two guards, because both failure modes end with the user's own work committed for them: the
- * checkout has to be the session's own (#453) rather than the project root that `resolveRunCheckout`
- * falls back to once a worktree is gone, and it has to be sitting on the session's branch.
- *
- * Returns whether the handoff may go ahead: true when there was nothing to do, when the guards say
- * this is not ours to commit, or when the commit succeeded.
- */
-export declare function commitSessionWork(checkout: string, projectCwd: string, branch: string, git?: GitRunner): Promise<boolean>;
-/** The outcome of a handoff action, in the `{ ok }` shape the dashboard's `useAction` understands. */
-export type HandoffResult = {
-    ok: true;
-    url?: string;
-} | {
-    ok: false;
-    error: string;
-};
-/**
- * Push a finished session's branch to `origin`.
- *
- * Publishing the agent's work under the user's name is the user's call, but since #1102 that call
- * is made once, up front, by a checkbox that is armed by default, rather than re-taken by hand at
- * the end of every session. The click is still here for a session that opted out, and it is what
- * a failed auto-push falls back to.
- */
-export declare function pushRunBranch(cwd: string, branch: string, git?: GitRunner): Promise<HandoffResult>;
-/**
- * {@link RunHandoff.base} as a base a PR can actually be opened against.
- *
- * The field holds a git ref, because that is what every other use of it needs: `detectBase` reads
- * `refs/remotes/origin/HEAD`, so it is `origin/main`, and the log range and merged check are both
- * asking git a question about a remote-tracking ref. `gh pr create --base` is asking GitHub for a
- * *branch on the remote*, and rejects `origin/main` with "Base ref must be a branch".
- *
- * So the conversion belongs at the `gh` boundary rather than in the field. Stripping `origin/`
- * matches what the rest of this module already assumes: the remote is `origin` (`pushRunBranch`
- * pushes there, `detectBase` reads its HEAD).
- */
-export declare function prBaseName(base: string): string;
-/**
- * The line of a failed git invocation worth showing.
- *
- * `execFile` rejects with "Command failed: git push ..." and buries git's own `fatal:` line
- * further down, which in a one-line panel means the user reads the command back instead of the
- * reason it failed.
- */
-export declare function gitReason(err: unknown): string;
-/** What to put on the PR. */
-export interface PullRequestDraft {
-    title: string;
-    body: string;
-    base?: string;
-    /**
-     * Open it as a GitHub draft (#1102). What auto-handoff uses: opening a PR by itself at the end
-     * of every session should not put a review request in anyone's inbox.
-     *
-     * Safe to do only because the interventions queue was taught to keep listing a draft on a
-     * session branch. Left off, a draft would be invisible in both places at once.
-     */
-    draft?: boolean;
-}
-/**
- * Open a PR for a finished session's branch, pushing it first when the remote does not have it.
- *
- * The button opens it ready for review, because a PR a human asked for by name is asking for
- * review. {@link PullRequestDraft.draft} is the auto-handoff case, which is not.
- */
-export declare function openRunPullRequest(cwd: string, branch: string, draft: PullRequestDraft, deps?: {
-    git?: GitRunner;
-    gh?: GhRunner;
-}): Promise<HandoffResult>;
-/**
- * Open a PR for a finished session, deciding from what the run recorded which cases should not
- * open one. Reads the branch's handoff first: a branch that no longer exists, or a session that
- * changed nothing, is a clear error rather than an empty PR, and a branch that already has a PR
- * returns that one. Title is the session name (else the intent's first line, else the id); body
- * is the intent plus which session did it. This is the handoff decision the dashboard's
- * open-PR button offers; the RPC layer only resolves which run it is about.
- */
-export declare function openSessionPullRequest(cwd: string, run: RunMeta, options?: {
-    draft?: boolean;
-}): Promise<HandoffResult>;
-/**
- * What a session was left armed to do when it ends (#1102).
- *
- * Both start true. The point of the feature is that the common case costs nothing: a session that
- * is simply left alone puts its branch on the remote and opens a PR for it.
- */
-export interface HandoffIntent {
-    push: boolean;
-    pr: boolean;
-    /**
-     * Merge the PR once it is opened (#1216). Absent = off, unlike the pair above: landing work on
-     * the default branch is not something to arm by default. No action-bar checkbox mutates it —
-     * it comes settled off the run's config.
-     */
-    merge?: boolean;
-}
-/**
- * Whether an armed merge may actually run (#1363), and if not, why.
- *
- * The rule settled on #1390: config *arms* the merge, the agent *authorizes* it. Landing on the
- * default branch unattended takes (a) the agent having declared the session done via
- * setReadyForMerge() — the same signal the on-before-mergeable step requires — and (b) the
- * framework not already knowing of work pending in this session (its own TODO file; never the
- * global queue, which is decoupled from sessions). A withheld merge is not a failed handoff:
- * push and PR go ahead, the PR just opens as a draft for a human.
- *
- * (b) is a temporary safety belt: the agent's word should ultimately be enough. Deleting it means
- * deleting `sessionTodoOpen` here and `sessionTodoPending` in todo-loop.ts.
- */
-export declare function withheldMerge(deps: {
-    readyForMerge: boolean;
-    sessionTodoOpen: boolean;
-}): MergeWithheldReason | undefined;
-/**
- * What auto-handoff did, so the run can say it as an event (#835).
- *
- * A dashboard-started run is spawned with `stdio: 'ignore'`, so anything printed here reaches
- * nobody: the outcome has to travel as an event or it does not travel at all. Skips are reported
- * for the same reason a skipped on-before-mergeable is — silence reads as "it ran and did nothing".
- */
-export type AutoHandoffOutcome = {
-    outcome: 'skipped';
-    reason: AutoHandoffSkip;
-    merge?: AutoMergeOutcome;
-} | {
-    outcome: 'done';
-    pushed: boolean;
-    url?: string;
-    merge?: AutoMergeOutcome;
-} | {
-    outcome: 'failed';
-    step: 'push' | 'pr';
-    error: string;
-};
-/**
- * Do the end-of-session handoff a session was left armed for (#1102): push the branch, open a
- * draft PR for it, or both.
- *
- * Reads the branch first and refuses on everything that is not a clean hand-off — a branch that is
- * gone, a session that committed nothing, a repo with no remote, a branch that already has a PR.
- * Those are the cases where doing it anyway would produce a confusing artefact rather than help.
- *
- * The PR is a draft on purpose. Opening one by itself at the end of every session must not put a
- * review request in anyone's inbox, and the interventions queue keeps listing a session's draft
- * so the work still comes back to the human.
- */
-export declare function runAutoHandoff(cwd: string, run: HandoffRun, intent: HandoffIntent, deps?: RunHandoffDeps & {
-    gh?: GhRunner;
-}): Promise<AutoHandoffOutcome>;
-/**
- * The little a handoff needs to know about the run it is for: which branch, and what to say on
- * the PR. Narrower than {@link RunMeta} so the run process can call this before its meta is
- * final, and so a caller cannot quietly start depending on the rest of the run's state.
- */
-export type HandoffRun = Pick<RunMeta, 'id' | 'branch' | 'sessionName' | 'intent'> & Partial<Pick<RunMeta, 'startedAt'>> & {
-    /**
-     * The GitHub issue the run's ticket tracks (`#42`), when it implements one (#1334). Carried
-     * into the PR title as `(fix #42)` so the squash-merge commit — which inherits the title —
-     * closes the issue; without it an auto-merged quick-win leaves its ticket open.
-     */
-    fixes?: string;
-};
-//# sourceMappingURL=run-handoff.d.ts.map

package/dist/dashboard/run-handoff.d.ts.map

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